Compact Types

Compact types encode structured data into a single cell using a concise text format. Each compact type defines its own element types, cell-filling syntax, and export encoding.

Type Availability

Category	Regular Table	Property Sheet	Tree-Structured Data
Compact Types	✓	✓

Type List

Type	Description
>>[]T	Compact array	View
>>[N]T	Fixed-size compact array	View
>>map[K]V	Compact map	View
>>object	Compact object	View
>>minmax	Compact minmax	View
>>wtpool	Compact weighted pool	View
>>vector	Compact vector	View
>>tuple	Compact tuple	View

Note

The >> prefix is part of the type name.

Common Rules

• Separate element values with |. Quote any value containing |.
• Two default export value shorthands are supported: / exports null; {} exports an empty container or a zero-valued object.
• There is no way for fields or elements to define their own default export values.

>>[]T

A compact array stores a variable-length array within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-	-
Name	levels	rewards	names
Type	>>[]int	>>[]float=/	>>[]string={}
1	10|20|30	1.5|2.0	sword|shield|bow
2	5|10

Type Definition Syntax

>>[]T

T can be any Basic Type, except for rgba.

>>[]string
>>[]int
>>[]float

Value Syntax

Separate element values with |. Quote any value containing |. An empty slot between | takes the zero value of the element type (e.g., a||c, ||).

10|20|30
foo|bar|`hello|world`

Default Export Value

>>[]int            →  no default export value
>>[]int=/          →  null
>>[]int={}         →  empty array []

See Default Export Value for more information.

Related Types

• >>[N]T
• []T

>>[N]T

A compact array of fixed length — exactly N elements.

Table

Copy Table to Clipboard

Desc	-	-
Name	weights	coord
Type	>>[3]float	>>[2]int=/
1	0.3|0.59|0.11	12|7
2	1.0|0.0|0.0

Type Definition Syntax

>>[N]T

T can be any Basic Type, except for rgba.

>>[3]float
>>[2]int
>>[4]duration

Note

N is not preserved during data export or code generation.

Value Syntax

Same as >>[]T, except a cell must contain exactly N element values.

Separate element values with |. Quote any value containing |. An empty slot between | takes the zero value of the element type (e.g., a||c, ||).

10|20|30
foo|bar|`hello|world`

Default Export Value

>>[3]int           →  no default export value
>>[3]int=/         →  null
>>[3]int={}        →  [0, 0, 0]

See Default Export Value for more information.

Related Types

• >>[]T
• [N]T

>>map[K]V

A compact map stores key-value pairs within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-
Name	troops	drops
Type	>>map[string]int	>>map[int]int=/
1	warrior:10|mage:20|archer:30	101=>2|102=>5
2	warrior:5

Type Definition Syntax

>>map[K]V

K must be string, an integer type, or an enum type; V must be a Basic Type.

>>map[string]int
>>map[int]int

K cannot have any options.

Value Syntax

Separate each key and value with : or =>. Separate pairs with |. Quote any key containing :, =>, or |, and any value containing |.

warrior:10|mage:20|archer:30
101=>2|102=>5

Caution

When K and V are both integers and there is only a single pair, Excel may read : as a time separator (1:2 → 01:02). Use => instead.

Default Export Value

>>map[string]int            →  no default export value
>>map[string]int=/          →  null
>>map[string]int={}         →  empty map {}

See Default Export Value for more information.

Option keyOnly

Allowed only for maps whose value type is bool.

keyOnly         →  equivalent to keyOnly=true
keyOnly=true

When enabled:

• The input syntax collapses to a |-delimited key list.
• Omitted map values are coerced to true.

This semantically “turns” a map into a set — yet still it exports as a map.

keyOnly

Copy Table to Clipboard

Desc	-
Name	skill-set
Type	>>map[string]bool
Options	keyOnly
1	fireball|heal|dash
2	fireball

Exported

{
  "1": {
    "skill-set": {
      "fireball": true,
      "heal": true,
      "dash": true
    }
  },
  "2": {
    "skill-set": {
      "fireball": true
    }
  }
}

Related Types

• map[K]V

>>object

A compact object stores a record with named fields within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-
Name	stats	reward
Type	>>object|Hp int|Mp int|Name string	>>object|Id int|Qty(q) int={}
1	Hp:100|Mp:50|Name:warrior	Id:101|q:3
2	Hp=>120|Name=>mage

Type Definition Syntax

>>object|Name0 T0|Name1 T1|...

All field types (T0, T1, …) must be Basic Types.

>>object|Hp int|Mp int|Name string
>>object|Id int|Qty(q) int

Value Syntax

Separate each name and value with : or =>. Separate fields with |. Fields with zero values can be omitted. Unknown fields cause an error.

Hp:100|Mp:50|Name:battleMage
Hp=>100|Name=>warrior

Field Shorthand

Field names may define a shorthand to reduce typing effort. Append (shorthand) to the field name (e.g., >>object|Qty(q) int). When configuring data, the shorthand may be used in place of the field name (e.g., q: 10 instead of Qty: 10).

Default Export Value

>>object|Hp int|Mp int            →  no default export value
>>object|Hp int|Mp int=/          →  null
>>object|Hp int|Mp int={}         →  {Hp: 0, Mp: 0}

See Default Export Value for more information.

Export Format

On data export, Archmage emits all declared fields; missing fields take their zero values.

Related Types

• >>tuple

>>minmax

A compact minmax stores a min-max pair within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-
Name	hpRange	dmgRange
Type	>>minmax|int	>>minmax|float=/
1	10|20	1.5|3.0
2	5|5

Type Definition Syntax

>>minmax|T

T must be an integer type, a floating-point type, or duration.

>>minmax|int
>>minmax|float32
>>minmax|int64
>>minmax|duration

Value Syntax

Exactly two values — min and max — are required, separated by |.

10|20
1.5|3.0
1s|2h

Note

• When T is an integer type, max - min must not exceed 1,000,000,000.
• When T is duration, max - min must not exceed 1,000,000,000 milliseconds.

Default Export Value

>>minmax|int            →  no default export value
>>minmax|int=/          →  {min: 0, max: 0}
>>minmax|int={}         →  {min: 0, max: 0}

See Default Export Value for more information.

Export Format

On data export, a minmax becomes an object with min and max fields.

Related Types

• minmax

>>wtpool

A compact weighted pool encodes a sequence of item-weight pairs within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-	-
Name	dropPool	lootPool	pet-pool
Type	>>wtpool|string	>>wtpool|int=/	>>wtpool|ref@pet={}
1	gold:50|gem:10|nothing:40	101=>5|102=>3	slime:10|dog:5|cat:5|snake:1
2	gold:100

Type Definition Syntax

>>wtpool|T

T is the item type. It can be any Basic Type, except for l10n and rgba.

Weights are int32 values; the data type is fixed and never needs to be specified.

>>wtpool|string
>>wtpool|int
>>wtpool|ref@pet

Value Syntax

Separate each item and weight with : or =>. Separate pairs with |. Quote any item containing :, =>, or |. The same item may appear more than once.

gold:50|gem:10|nothing:40
101=>5|102=>3
slime:10|dog:5|cat:5

Note

Each weight must be ≥ 0. The total must be > 0 and ≤ 1,000,000,000.

Caution

When the item is an integer and there is only a single pair, Excel may read : as a time separator (1:2 → 01:02). Use => instead.

Default Export Value

>>wtpool|int            →  no default export value
>>wtpool|int=/          →  null
>>wtpool|int={}         →  empty pool {items: [], weights: []}

See Default Export Value for more information.

Export Format

On data export, a weighted pool becomes an object with two parallel arrays, items and weights. Each weight corresponds to the item at the same index.

Related Types

• wtpool

>>vector

A compact vector stores a geometric vector within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-	-
Name	pos	scale	color
Type	>>vector|2|int	>>vector|3|float32=/	>>vector|4|int32={}
1	10|20	1.0|1.0|1.0	255|0|0|255
2	5|8

Type Definition Syntax

>>vector|Dim|T

Dim must be 2, 3, or 4; T must be an integer or a floating-point type.

>>vector|2|int
>>vector|3|float32
>>vector|4|int32

Value Syntax

Element values are positional, separated by |. Exactly Dim values are required. An empty slot between | takes the zero value of the element type (e.g., 1||3, ||).

1|2
1|2|3
1|2|3|4

Default Export Value

>>vector|3|float            →  no default export value
>>vector|3|float=/          →  {x: 0, y: 0, z: 0}
>>vector|3|float={}         →  {x: 0, y: 0, z: 0}

See Default Export Value for more information.

Export Format

On data export, a vector becomes an object with x and y fields, extended with z and w according to Dim.

Related Types

• vector

>>tuple

A compact tuple stores a positional struct within a single spreadsheet cell.

Table

Copy Table to Clipboard

Desc	-	-
Name	entry	pair
Type	>>tuple|int|string|bool	>>tuple|int|int=/
1	100|warrior|true	3|7
2	100||true

Type Definition Syntax

>>tuple|T0|T1|T2|...

All field types (T0, T1, …) must be Basic Types. At most seven fields are permitted, and rgba may not appear as the first field.

>>tuple|int|string|bool
>>tuple|datetime|duration

Value Syntax

Field values are positional, separated by |. Zero-value fields can be omitted, so long as the | separators remain.

100|warrior|true
100||true

Default Export Value

>>tuple|int|string|bool            →  no default export value
>>tuple|int|string|bool=/          →  null
>>tuple|int|string|bool={}         →  {item0: 0, item1: "", item2: false}

See Default Export Value for more information.

Export Format

On data export, Archmage represents tuples as objects. Keys follow the pattern item0, item1, item2, and so on.

Related Types

• >>object
• tuple