Transform Function

Overview

The transform function is the core component of the export format specification. It receives a normalized item object and returns a transformed representation suitable for the target export format.

Function Signature

transform: (item: NormalizedItem) => object | null

Parameters:

• item - Normalized item object with guaranteed structure

Returns:

• object - Transformed data to be exported

• null - Skip this item from export

Implementation Examples

Basic Transformation

transform: (item) => ({
  id: item.id,
  name: item.name,
  type: item.type,
})

Module Data Access

transform: (item) => {
  const magicPower = item.modules?.expansion_magic_power || 0;
  
  return {
    id: item.id,
    name: item.name,
    magic_power: magicPower,
    is_magical: magicPower > 0,
  };
}

Computed Properties

transform: (item) => {
  const power = item.modules?.expansion_magic_power || 0;
  
  return {
    id: item.id,
    name: item.name,
    tier: power > 200 ? 'legendary' : power > 100 ? 'epic' : 'common',
    stats: {
      damage: Math.floor(power / 10),
      mana_cost: Math.max(1, Math.floor(power / 20)),
    },
  };
}

Type-Specific Transformations

transform: (item) => {
  const base = {
    id: item.id,
    name: item.name,
  };
  
  // Type-specific property mapping
  switch (item.type) {
    case 'block':
      return { ...base, hardness: item.modules?.hardness || 1.0 };
    
    case 'item':
      return { ...base, max_stack: item.modules?.max_stack_size || 64 };
    
    case 'entity':
      return { ...base, health: item.modules?.max_health || 20 };
    
    default:
      return base;
  }
}