@toon-format/spec 1.3.3 → 1.5.0

package/tests/fixtures/decode/validation-errors.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "decode",
   "description": "Validation errors - length mismatches, invalid escapes, syntax errors, delimiter mismatches",
   "tests": [
@@ -8,56 +8,76 @@
       "input": "tags[2]: a,b,c",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.1"
     },
     {
       "name": "throws on array length mismatch (list format - too many)",
       "input": "items[1]:\n  - 1\n  - 2",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.1"
     },
     {
       "name": "throws when tabular row value count does not match header field count",
       "input": "items[2]{id,name}:\n  1,Ada\n  2",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.1"
     },
     {
       "name": "throws when tabular row count does not match header length",
       "input": "[1]{id}:\n  1\n  2",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.1"
     },
     {
       "name": "throws on invalid escape sequence",
       "input": "\"a\\x\"",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.2"
     },
     {
       "name": "throws on unterminated string",
       "input": "\"unterminated",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.2"
     },
     {
       "name": "throws on missing colon in key-value context",
       "input": "a:\n  user",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.2"
+    },
+    {
+      "name": "throws on two primitives at root depth in strict mode",
+      "input": "hello\nworld",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "5"
     },
     {
       "name": "throws on delimiter mismatch (header declares tab, row uses comma)",
       "input": "items[2\t]{a\tb}:\n  1,2\n  3,4",
       "expected": null,
       "shouldError": true,
-      "specSection": "9"
+      "specSection": "14.2"
+    },
+    {
+      "name": "throws on mismatched delimiter between bracket and brace fields",
+      "input": "items[2\t]{a,b}:\n  1\t2\n  3\t4",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "6"
     }
   ]
 }

package/tests/fixtures/decode/whitespace.json

@@ -0,0 +1,61 @@
+{
+  "version": "1.4",
+  "category": "decode",
+  "description": "Whitespace tolerance in decoding - surrounding spaces around delimiters and values",
+  "tests": [
+    {
+      "name": "tolerates spaces around commas in inline arrays",
+      "input": "tags[3]: a , b , c",
+      "expected": {
+        "tags": ["a", "b", "c"]
+      },
+      "specSection": "12",
+      "note": "Surrounding whitespace SHOULD be tolerated; tokens are trimmed"
+    },
+    {
+      "name": "tolerates spaces around pipes in inline arrays",
+      "input": "tags[3|]: a | b | c",
+      "expected": {
+        "tags": ["a", "b", "c"]
+      },
+      "specSection": "12"
+    },
+    {
+      "name": "tolerates spaces around tabs in inline arrays",
+      "input": "tags[3\t]: a \t b \t c",
+      "expected": {
+        "tags": ["a", "b", "c"]
+      },
+      "specSection": "12"
+    },
+    {
+      "name": "tolerates leading and trailing spaces in tabular row values",
+      "input": "items[2]{id,name}:\n  1 , Alice \n  2 , Bob ",
+      "expected": {
+        "items": [
+          { "id": 1, "name": "Alice" },
+          { "id": 2, "name": "Bob" }
+        ]
+      },
+      "specSection": "12",
+      "note": "Values in tabular rows are trimmed"
+    },
+    {
+      "name": "tolerates spaces around delimiters with quoted values",
+      "input": "items[3]: \"a\" , \"b\" , \"c\"",
+      "expected": {
+        "items": ["a", "b", "c"]
+      },
+      "specSection": "12"
+    },
+    {
+      "name": "empty tokens decode to empty string",
+      "input": "items[3]: a,,c",
+      "expected": {
+        "items": ["a", "", "c"]
+      },
+      "specSection": "12",
+      "note": "Empty token (nothing between delimiters) decodes to empty string"
+    }
+  ]
+}

package/tests/fixtures/encode/arrays-nested.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Nested and mixed array encoding - arrays of arrays, mixed type arrays, root arrays",
   "tests": [
@@ -9,7 +9,7 @@
         "pairs": [["a", "b"], ["c", "d"]]
       },
       "expected": "pairs[2]:\n  - [2]: a,b\n  - [2]: c,d",
-      "specSection": "7.3"
+      "specSection": "9.2"
     },
     {
       "name": "quotes strings containing delimiters in nested arrays",
@@ -17,53 +17,53 @@
         "pairs": [["a", "b"], ["c,d", "e:f", "true"]]
       },
       "expected": "pairs[2]:\n  - [2]: a,b\n  - [3]: \"c,d\",\"e:f\",\"true\"",
-      "specSection": "7.3"
+      "specSection": "9.2"
     },
     {
-      "name": "handles empty inner arrays",
+      "name": "encodes empty inner arrays",
       "input": {
         "pairs": [[], []]
       },
       "expected": "pairs[2]:\n  - [0]:\n  - [0]:",
-      "specSection": "7.3"
+      "specSection": "9.2"
     },
     {
-      "name": "handles mixed-length inner arrays",
+      "name": "encodes mixed-length inner arrays",
       "input": {
         "pairs": [[1], [2, 3]]
       },
       "expected": "pairs[2]:\n  - [1]: 1\n  - [2]: 2,3",
-      "specSection": "7.3"
+      "specSection": "9.2"
     },
     {
       "name": "encodes root-level primitive array",
       "input": ["x", "y", "true", true, 10],
       "expected": "[5]: x,y,\"true\",true,10",
-      "specSection": "7"
+      "specSection": "9.1"
     },
     {
       "name": "encodes root-level array of uniform objects in tabular format",
       "input": [{ "id": 1 }, { "id": 2 }],
       "expected": "[2]{id}:\n  1\n  2",
-      "specSection": "7.2"
+      "specSection": "9.3"
     },
     {
       "name": "encodes root-level array of non-uniform objects in list format",
       "input": [{ "id": 1 }, { "id": 2, "name": "Ada" }],
       "expected": "[2]:\n  - id: 1\n  - id: 2\n    name: Ada",
-      "specSection": "7"
+      "specSection": "9.4"
     },
     {
       "name": "encodes empty root-level array",
       "input": [],
       "expected": "[0]:",
-      "specSection": "7"
+      "specSection": "9.1"
     },
     {
       "name": "encodes root-level arrays of arrays",
       "input": [[1, 2], []],
       "expected": "[2]:\n  - [2]: 1,2\n  - [0]:",
-      "specSection": "7.3"
+      "specSection": "9.2"
     },
     {
       "name": "encodes complex nested structure",
@@ -77,7 +77,7 @@
         }
       },
       "expected": "user:\n  id: 123\n  name: Ada\n  tags[2]: reading,gaming\n  active: true\n  prefs[0]:",
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "uses list format for arrays mixing primitives and objects",
@@ -85,7 +85,7 @@
         "items": [1, { "a": 1 }, "text"]
       },
       "expected": "items[3]:\n  - 1\n  - a: 1\n  - text",
-      "specSection": "7.3"
+      "specSection": "9.4"
     },
     {
       "name": "uses list format for arrays mixing objects and arrays",
@@ -93,7 +93,7 @@
         "items": [{ "a": 1 }, [1, 2]]
       },
       "expected": "items[2]:\n  - a: 1\n  - [2]: 1,2",
-      "specSection": "7.3"
+      "specSection": "9.4"
     }
   ]
 }

package/tests/fixtures/encode/arrays-objects.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Arrays of objects encoding - list format for non-uniform objects and complex structures",
   "tests": [
@@ -12,7 +12,7 @@
         ]
       },
       "expected": "items[2]:\n  - id: 1\n    name: First\n  - id: 2\n    name: Second\n    extra: true",
-      "specSection": "7"
+      "specSection": "9.4"
     },
     {
       "name": "uses list format for objects with nested values",
@@ -22,7 +22,7 @@
         ]
       },
       "expected": "items[1]:\n  - id: 1\n    nested:\n      x: 1",
-      "specSection": "7"
+      "specSection": "9.4"
     },
     {
       "name": "preserves field order in list items - array first",
@@ -30,7 +30,7 @@
         "items": [{ "nums": [1, 2, 3], "name": "test" }]
       },
       "expected": "items[1]:\n  - nums[3]: 1,2,3\n    name: test",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "preserves field order in list items - primitive first",
@@ -38,7 +38,7 @@
         "items": [{ "name": "test", "nums": [1, 2, 3] }]
       },
       "expected": "items[1]:\n  - name: test\n    nums[3]: 1,2,3",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "uses list format for objects containing arrays of arrays",
@@ -48,7 +48,7 @@
         ]
       },
       "expected": "items[1]:\n  - matrix[2]:\n    - [2]: 1,2\n    - [2]: 3,4\n    name: grid",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "uses tabular format for nested uniform object arrays",
@@ -58,7 +58,7 @@
         ]
       },
       "expected": "items[1]:\n  - users[2]{id,name}:\n    1,Ada\n    2,Bob\n    status: active",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "uses list format for nested object arrays with mismatched keys",
@@ -68,7 +68,7 @@
         ]
       },
       "expected": "items[1]:\n  - users[2]:\n    - id: 1\n      name: Ada\n    - id: 2\n    status: active",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "uses list format for objects with multiple array fields",
@@ -76,7 +76,7 @@
         "items": [{ "nums": [1, 2], "tags": ["a", "b"], "name": "test" }]
       },
       "expected": "items[1]:\n  - nums[2]: 1,2\n    tags[2]: a,b\n    name: test",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "uses list format for objects with only array fields",
@@ -84,17 +84,17 @@
         "items": [{ "nums": [1, 2, 3], "tags": ["a", "b"] }]
       },
       "expected": "items[1]:\n  - nums[3]: 1,2,3\n    tags[2]: a,b",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
-      "name": "handles objects with empty arrays in list format",
+      "name": "encodes objects with empty arrays in list format",
       "input": {
         "items": [
           { "name": "test", "data": [] }
         ]
       },
       "expected": "items[1]:\n  - name: test\n    data[0]:",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "places first field of nested tabular arrays on hyphen line",
@@ -102,7 +102,7 @@
         "items": [{ "users": [{ "id": 1 }, { "id": 2 }], "note": "x" }]
       },
       "expected": "items[1]:\n  - users[2]{id}:\n    1\n    2\n    note: x",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "places empty arrays on hyphen line when first",
@@ -110,7 +110,7 @@
         "items": [{ "data": [], "name": "x" }]
       },
       "expected": "items[1]:\n  - data[0]:\n    name: x",
-      "specSection": "7"
+      "specSection": "10"
     },
     {
       "name": "uses field order from first object for tabular headers",
@@ -121,7 +121,7 @@
         ]
       },
       "expected": "items[2]{a,b,c}:\n  1,2,3\n  10,20,30",
-      "specSection": "7.2"
+      "specSection": "9.3"
     },
     {
       "name": "uses list format when one object has nested column",
@@ -132,7 +132,7 @@
         ]
       },
       "expected": "items[2]:\n  - id: 1\n    data: string\n  - id: 2\n    data:\n      nested: true",
-      "specSection": "7"
+      "specSection": "9.4"
     }
   ]
 }

package/tests/fixtures/encode/arrays-primitive.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Primitive array encoding - inline arrays of strings, numbers, booleans",
   "tests": [
@@ -9,7 +9,7 @@
         "tags": ["reading", "gaming"]
       },
       "expected": "tags[2]: reading,gaming",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
       "name": "encodes number arrays inline",
@@ -17,7 +17,7 @@
         "nums": [1, 2, 3]
       },
       "expected": "nums[3]: 1,2,3",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
       "name": "encodes mixed primitive arrays inline",
@@ -25,7 +25,7 @@
         "data": ["x", "y", true, 10]
       },
       "expected": "data[4]: x,y,true,10",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
       "name": "encodes empty arrays",
@@ -33,31 +33,31 @@
         "items": []
       },
       "expected": "items[0]:",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
-      "name": "handles empty string in single-item array",
+      "name": "encodes empty string in single-item array",
       "input": {
         "items": [""]
       },
       "expected": "items[1]: \"\"",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
-      "name": "handles empty string in multi-item array",
+      "name": "encodes empty string in multi-item array",
       "input": {
         "items": ["a", "", "b"]
       },
       "expected": "items[3]: a,\"\",b",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
-      "name": "handles whitespace-only strings in arrays",
+      "name": "encodes whitespace-only strings in arrays",
       "input": {
         "items": [" ", "  "]
       },
       "expected": "items[2]: \" \",\"  \"",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
       "name": "quotes array strings with comma",
@@ -65,7 +65,7 @@
         "items": ["a", "b,c", "d:e"]
       },
       "expected": "items[3]: a,\"b,c\",\"d:e\"",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
       "name": "quotes strings that look like booleans in arrays",
@@ -73,7 +73,7 @@
         "items": ["x", "true", "42", "-3.14"]
       },
       "expected": "items[4]: x,\"true\",\"42\",\"-3.14\"",
-      "specSection": "7.1"
+      "specSection": "9.1"
     },
     {
       "name": "quotes strings with structural meanings in arrays",
@@ -81,7 +81,7 @@
         "items": ["[5]", "- item", "{key}"]
       },
       "expected": "items[3]: \"[5]\",\"- item\",\"{key}\"",
-      "specSection": "7.1"
+      "specSection": "9.1"
     }
   ]
 }

package/tests/fixtures/encode/arrays-tabular.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Tabular array encoding - arrays of uniform objects with primitive values",
   "tests": [
@@ -12,10 +12,10 @@
         ]
       },
       "expected": "items[2]{sku,qty,price}:\n  A1,2,9.99\n  B2,1,14.5",
-      "specSection": "7.2"
+      "specSection": "9.3"
     },
     {
-      "name": "handles null values in tabular format",
+      "name": "encodes null values in tabular format",
       "input": {
         "items": [
           { "id": 1, "value": null },
@@ -23,7 +23,7 @@
         ]
       },
       "expected": "items[2]{id,value}:\n  1,null\n  2,test",
-      "specSection": "7.2"
+      "specSection": "9.3"
     },
     {
       "name": "quotes strings containing delimiters in tabular rows",
@@ -34,7 +34,7 @@
         ]
       },
       "expected": "items[2]{sku,desc,qty}:\n  \"A,1\",cool,2\n  B2,\"wip: test\",1",
-      "specSection": "7.2"
+      "specSection": "9.3"
     },
     {
       "name": "quotes ambiguous strings in tabular rows",
@@ -45,10 +45,10 @@
         ]
       },
       "expected": "items[2]{id,status}:\n  1,\"true\"\n  2,\"false\"",
-      "specSection": "7.2"
+      "specSection": "9.3"
     },
     {
-      "name": "handles tabular arrays with keys needing quotes",
+      "name": "encodes tabular arrays with keys needing quotes",
       "input": {
         "items": [
           { "order:id": 1, "full name": "Ada" },
@@ -56,7 +56,7 @@
         ]
       },
       "expected": "items[2]{\"order:id\",\"full name\"}:\n  1,Ada\n  2,Bob",
-      "specSection": "7.2"
+      "specSection": "9.3"
     }
   ]
 }