@toon-format/spec 1.3.3 → 1.4.0

package/tests/fixtures/decode/objects.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "decode",
   "description": "Object decoding - simple objects, nested objects, key parsing, quoted values",
   "tests": [
@@ -11,7 +11,7 @@
         "name": "Ada",
         "active": true
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses null values in objects",
@@ -20,7 +20,7 @@
         "id": 123,
         "value": null
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses empty nested object header",
@@ -28,7 +28,7 @@
       "expected": {
         "user": {}
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted object value with colon",
@@ -36,7 +36,7 @@
       "expected": {
         "note": "a:b"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted object value with comma",
@@ -44,7 +44,7 @@
       "expected": {
         "note": "a,b"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted object value with newline escape",
@@ -52,7 +52,7 @@
       "expected": {
         "text": "line1\nline2"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted object value with escaped quotes",
@@ -60,7 +60,7 @@
       "expected": {
         "text": "say \"hello\""
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted object value with leading/trailing spaces",
@@ -68,7 +68,7 @@
       "expected": {
         "text": " padded "
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted object value with only spaces",
@@ -76,7 +76,7 @@
       "expected": {
         "text": "  "
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted string value that looks like true",
@@ -84,7 +84,7 @@
       "expected": {
         "v": "true"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted string value that looks like integer",
@@ -92,7 +92,7 @@
       "expected": {
         "v": "42"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted string value that looks like negative decimal",
@@ -100,7 +100,7 @@
       "expected": {
         "v": "-7.5"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with colon",
@@ -108,7 +108,7 @@
       "expected": {
         "order:id": 7
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with brackets",
@@ -116,7 +116,7 @@
       "expected": {
         "[index]": 5
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with braces",
@@ -124,7 +124,7 @@
       "expected": {
         "{key}": 5
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with comma",
@@ -132,7 +132,7 @@
       "expected": {
         "a,b": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with spaces",
@@ -140,7 +140,7 @@
       "expected": {
         "full name": "Ada"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with leading hyphen",
@@ -148,7 +148,7 @@
       "expected": {
         "-lead": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted key with leading and trailing spaces",
@@ -156,7 +156,7 @@
       "expected": {
         " a ": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted numeric key",
@@ -164,7 +164,7 @@
       "expected": {
         "123": "x"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses quoted empty string key",
@@ -172,7 +172,7 @@
       "expected": {
         "": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses dotted keys as identifiers",
@@ -180,7 +180,7 @@
       "expected": {
         "user.name": "Ada"
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses underscore-prefixed keys",
@@ -188,7 +188,7 @@
       "expected": {
         "_private": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses underscore-containing keys",
@@ -196,7 +196,7 @@
       "expected": {
         "user_name": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "unescapes newline in key",
@@ -204,7 +204,7 @@
       "expected": {
         "line\nbreak": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "unescapes tab in key",
@@ -212,7 +212,7 @@
       "expected": {
         "tab\there": 2
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "unescapes quotes in key",
@@ -220,7 +220,7 @@
       "expected": {
         "he said \"hi\"": 1
       },
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "parses deeply nested objects with indentation",
@@ -232,7 +232,7 @@
           }
         }
       },
-      "specSection": "6"
+      "specSection": "8"
     }
   ]
 }

package/tests/fixtures/decode/primitives.json

@@ -1,189 +1,158 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "decode",
   "description": "Primitive value decoding - strings, numbers, booleans, null, unescaping",
   "tests": [
     {
-      "name": "decodes safe unquoted string",
+      "name": "parses safe unquoted string",
       "input": "hello",
       "expected": "hello",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes unquoted string with underscore and numbers",
+      "name": "parses unquoted string with underscore and numbers",
       "input": "Ada_99",
       "expected": "Ada_99",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes empty quoted string",
+      "name": "parses empty quoted string",
       "input": "\"\"",
       "expected": "",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes quoted string with newline escape",
+      "name": "parses quoted string with newline escape",
       "input": "\"line1\\nline2\"",
       "expected": "line1\nline2",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
-      "name": "decodes quoted string with tab escape",
+      "name": "parses quoted string with tab escape",
       "input": "\"tab\\there\"",
       "expected": "tab\there",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
-      "name": "decodes quoted string with carriage return escape",
+      "name": "parses quoted string with carriage return escape",
       "input": "\"return\\rcarriage\"",
       "expected": "return\rcarriage",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
-      "name": "decodes quoted string with backslash escape",
+      "name": "parses quoted string with backslash escape",
       "input": "\"C:\\\\Users\\\\path\"",
       "expected": "C:\\Users\\path",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
-      "name": "decodes quoted string with escaped quotes",
+      "name": "parses quoted string with escaped quotes",
       "input": "\"say \\\"hello\\\"\"",
       "expected": "say \"hello\"",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
-      "name": "decodes Unicode string",
+      "name": "parses Unicode string",
       "input": "café",
       "expected": "café",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes Chinese characters",
+      "name": "parses Chinese characters",
       "input": "你好",
       "expected": "你好",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes emoji",
+      "name": "parses emoji",
       "input": "🚀",
       "expected": "🚀",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes string with emoji and spaces",
+      "name": "parses string with emoji and spaces",
       "input": "hello 👋 world",
       "expected": "hello 👋 world",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
-      "name": "decodes positive integer",
+      "name": "parses positive integer",
       "input": "42",
       "expected": 42,
-      "specSection": "5"
+      "specSection": "4"
     },
     {
-      "name": "decodes decimal number",
+      "name": "parses decimal number",
       "input": "3.14",
       "expected": 3.14,
-      "specSection": "5"
+      "specSection": "4"
     },
     {
-      "name": "decodes negative integer",
+      "name": "parses negative integer",
       "input": "-7",
       "expected": -7,
-      "specSection": "5"
+      "specSection": "4"
     },
     {
-      "name": "decodes true",
+      "name": "parses true",
       "input": "true",
       "expected": true,
-      "specSection": "5"
+      "specSection": "4"
     },
     {
-      "name": "decodes false",
+      "name": "parses false",
       "input": "false",
       "expected": false,
-      "specSection": "5"
+      "specSection": "4"
     },
     {
-      "name": "decodes null",
+      "name": "parses null",
       "input": "null",
       "expected": null,
-      "specSection": "5"
-    },
-    {
-      "name": "treats unquoted leading-zero number as string",
-      "input": "05",
-      "expected": "05",
-      "specSection": "5",
-      "note": "Leading zeros make it a string"
-    },
-    {
-      "name": "treats unquoted multi-leading-zero as string",
-      "input": "007",
-      "expected": "007",
-      "specSection": "5"
-    },
-    {
-      "name": "treats unquoted octal-like as string",
-      "input": "0123",
-      "expected": "0123",
-      "specSection": "5"
-    },
-    {
-      "name": "treats leading-zero in object value as string",
-      "input": "a: 05",
-      "expected": { "a": "05" },
-      "specSection": "5"
-    },
-    {
-      "name": "treats leading-zeros in array as strings",
-      "input": "nums[3]: 05,007,0123",
-      "expected": { "nums": ["05", "007", "0123"] },
-      "specSection": "5"
+      "specSection": "4"
     },
     {
       "name": "respects ambiguity quoting for true",
       "input": "\"true\"",
       "expected": "true",
-      "specSection": "5",
+      "specSection": "7.4",
       "note": "Quoted primitive remains string"
     },
     {
       "name": "respects ambiguity quoting for false",
       "input": "\"false\"",
       "expected": "false",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
       "name": "respects ambiguity quoting for null",
       "input": "\"null\"",
       "expected": "null",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
       "name": "respects ambiguity quoting for integer",
       "input": "\"42\"",
       "expected": "42",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
       "name": "respects ambiguity quoting for negative decimal",
       "input": "\"-3.14\"",
       "expected": "-3.14",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
       "name": "respects ambiguity quoting for scientific notation",
       "input": "\"1e-6\"",
       "expected": "1e-6",
-      "specSection": "5"
+      "specSection": "7.4"
     },
     {
       "name": "respects ambiguity quoting for leading-zero",
       "input": "\"05\"",
       "expected": "05",
-      "specSection": "5"
+      "specSection": "7.4"
     }
   ]
 }

package/tests/fixtures/decode/root-form.json

@@ -0,0 +1,17 @@
+{
+  "version": "1.4",
+  "category": "decode",
+  "description": "Root form detection - empty document, single primitive, multiple primitives",
+  "tests": [
+    {
+      "name": "empty document decodes to empty object",
+      "input": "",
+      "expected": {},
+      "options": {
+        "strict": true
+      },
+      "specSection": "5",
+      "note": "Empty input (no non-empty lines) decodes to empty object"
+    }
+  ]
+}

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"
+    }
+  ]
+}