@toon-format/spec 1.3.0

package/tests/fixtures/decode/objects.json

@@ -0,0 +1,238 @@
+{
+  "version": "1.3",
+  "category": "decode",
+  "description": "Object decoding - simple objects, nested objects, key parsing, quoted values",
+  "tests": [
+    {
+      "name": "parses objects with primitive values",
+      "input": "id: 123\nname: Ada\nactive: true",
+      "expected": {
+        "id": 123,
+        "name": "Ada",
+        "active": true
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses null values in objects",
+      "input": "id: 123\nvalue: null",
+      "expected": {
+        "id": 123,
+        "value": null
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses empty nested object header",
+      "input": "user:",
+      "expected": {
+        "user": {}
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted object value with colon",
+      "input": "note: \"a:b\"",
+      "expected": {
+        "note": "a:b"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted object value with comma",
+      "input": "note: \"a,b\"",
+      "expected": {
+        "note": "a,b"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted object value with newline escape",
+      "input": "text: \"line1\\nline2\"",
+      "expected": {
+        "text": "line1\nline2"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted object value with escaped quotes",
+      "input": "text: \"say \\\"hello\\\"\"",
+      "expected": {
+        "text": "say \"hello\""
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted object value with leading/trailing spaces",
+      "input": "text: \" padded \"",
+      "expected": {
+        "text": " padded "
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted object value with only spaces",
+      "input": "text: \"  \"",
+      "expected": {
+        "text": "  "
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted string value that looks like true",
+      "input": "v: \"true\"",
+      "expected": {
+        "v": "true"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted string value that looks like integer",
+      "input": "v: \"42\"",
+      "expected": {
+        "v": "42"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted string value that looks like negative decimal",
+      "input": "v: \"-7.5\"",
+      "expected": {
+        "v": "-7.5"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with colon",
+      "input": "\"order:id\": 7",
+      "expected": {
+        "order:id": 7
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with brackets",
+      "input": "\"[index]\": 5",
+      "expected": {
+        "[index]": 5
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with braces",
+      "input": "\"{key}\": 5",
+      "expected": {
+        "{key}": 5
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with comma",
+      "input": "\"a,b\": 1",
+      "expected": {
+        "a,b": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with spaces",
+      "input": "\"full name\": Ada",
+      "expected": {
+        "full name": "Ada"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with leading hyphen",
+      "input": "\"-lead\": 1",
+      "expected": {
+        "-lead": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted key with leading and trailing spaces",
+      "input": "\" a \": 1",
+      "expected": {
+        " a ": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted numeric key",
+      "input": "\"123\": x",
+      "expected": {
+        "123": "x"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses quoted empty string key",
+      "input": "\"\": 1",
+      "expected": {
+        "": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses dotted keys as identifiers",
+      "input": "user.name: Ada",
+      "expected": {
+        "user.name": "Ada"
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses underscore-prefixed keys",
+      "input": "_private: 1",
+      "expected": {
+        "_private": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses underscore-containing keys",
+      "input": "user_name: 1",
+      "expected": {
+        "user_name": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "unescapes newline in key",
+      "input": "\"line\\nbreak\": 1",
+      "expected": {
+        "line\nbreak": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "unescapes tab in key",
+      "input": "\"tab\\there\": 2",
+      "expected": {
+        "tab\there": 2
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "unescapes quotes in key",
+      "input": "\"he said \\\"hi\\\"\": 1",
+      "expected": {
+        "he said \"hi\"": 1
+      },
+      "specSection": "6"
+    },
+    {
+      "name": "parses deeply nested objects with indentation",
+      "input": "a:\n  b:\n    c: deep",
+      "expected": {
+        "a": {
+          "b": {
+            "c": "deep"
+          }
+        }
+      },
+      "specSection": "6"
+    }
+  ]
+}

package/tests/fixtures/decode/primitives.json

@@ -0,0 +1,189 @@
+{
+  "version": "1.3",
+  "category": "decode",
+  "description": "Primitive value decoding - strings, numbers, booleans, null, unescaping",
+  "tests": [
+    {
+      "name": "decodes safe unquoted string",
+      "input": "hello",
+      "expected": "hello",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes unquoted string with underscore and numbers",
+      "input": "Ada_99",
+      "expected": "Ada_99",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes empty quoted string",
+      "input": "\"\"",
+      "expected": "",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes quoted string with newline escape",
+      "input": "\"line1\\nline2\"",
+      "expected": "line1\nline2",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes quoted string with tab escape",
+      "input": "\"tab\\there\"",
+      "expected": "tab\there",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes quoted string with carriage return escape",
+      "input": "\"return\\rcarriage\"",
+      "expected": "return\rcarriage",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes quoted string with backslash escape",
+      "input": "\"C:\\\\Users\\\\path\"",
+      "expected": "C:\\Users\\path",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes quoted string with escaped quotes",
+      "input": "\"say \\\"hello\\\"\"",
+      "expected": "say \"hello\"",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes Unicode string",
+      "input": "café",
+      "expected": "café",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes Chinese characters",
+      "input": "你好",
+      "expected": "你好",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes emoji",
+      "input": "🚀",
+      "expected": "🚀",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes string with emoji and spaces",
+      "input": "hello 👋 world",
+      "expected": "hello 👋 world",
+      "specSection": "5"
+    },
+    {
+      "name": "decodes positive integer",
+      "input": "42",
+      "expected": 42,
+      "specSection": "5"
+    },
+    {
+      "name": "decodes decimal number",
+      "input": "3.14",
+      "expected": 3.14,
+      "specSection": "5"
+    },
+    {
+      "name": "decodes negative integer",
+      "input": "-7",
+      "expected": -7,
+      "specSection": "5"
+    },
+    {
+      "name": "decodes true",
+      "input": "true",
+      "expected": true,
+      "specSection": "5"
+    },
+    {
+      "name": "decodes false",
+      "input": "false",
+      "expected": false,
+      "specSection": "5"
+    },
+    {
+      "name": "decodes 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"
+    },
+    {
+      "name": "respects ambiguity quoting for true",
+      "input": "\"true\"",
+      "expected": "true",
+      "specSection": "5",
+      "note": "Quoted primitive remains string"
+    },
+    {
+      "name": "respects ambiguity quoting for false",
+      "input": "\"false\"",
+      "expected": "false",
+      "specSection": "5"
+    },
+    {
+      "name": "respects ambiguity quoting for null",
+      "input": "\"null\"",
+      "expected": "null",
+      "specSection": "5"
+    },
+    {
+      "name": "respects ambiguity quoting for integer",
+      "input": "\"42\"",
+      "expected": "42",
+      "specSection": "5"
+    },
+    {
+      "name": "respects ambiguity quoting for negative decimal",
+      "input": "\"-3.14\"",
+      "expected": "-3.14",
+      "specSection": "5"
+    },
+    {
+      "name": "respects ambiguity quoting for scientific notation",
+      "input": "\"1e-6\"",
+      "expected": "1e-6",
+      "specSection": "5"
+    },
+    {
+      "name": "respects ambiguity quoting for leading-zero",
+      "input": "\"05\"",
+      "expected": "05",
+      "specSection": "5"
+    }
+  ]
+}

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

@@ -0,0 +1,63 @@
+{
+  "version": "1.3",
+  "category": "decode",
+  "description": "Validation errors - length mismatches, invalid escapes, syntax errors, delimiter mismatches",
+  "tests": [
+    {
+      "name": "throws on array length mismatch (inline primitives - too many)",
+      "input": "tags[2]: a,b,c",
+      "expected": null,
+      "shouldError": true,
+      "specSection": "9"
+    },
+    {
+      "name": "throws on array length mismatch (list format - too many)",
+      "input": "items[1]:\n  - 1\n  - 2",
+      "expected": null,
+      "shouldError": true,
+      "specSection": "9"
+    },
+    {
+      "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"
+    },
+    {
+      "name": "throws when tabular row count does not match header length",
+      "input": "[1]{id}:\n  1\n  2",
+      "expected": null,
+      "shouldError": true,
+      "specSection": "9"
+    },
+    {
+      "name": "throws on invalid escape sequence",
+      "input": "\"a\\x\"",
+      "expected": null,
+      "shouldError": true,
+      "specSection": "9"
+    },
+    {
+      "name": "throws on unterminated string",
+      "input": "\"unterminated",
+      "expected": null,
+      "shouldError": true,
+      "specSection": "9"
+    },
+    {
+      "name": "throws on missing colon in key-value context",
+      "input": "a:\n  user",
+      "expected": null,
+      "shouldError": true,
+      "specSection": "9"
+    },
+    {
+      "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"
+    }
+  ]
+}

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

@@ -0,0 +1,99 @@
+{
+  "version": "1.3",
+  "category": "encode",
+  "description": "Nested and mixed array encoding - arrays of arrays, mixed type arrays, root arrays",
+  "tests": [
+    {
+      "name": "encodes nested arrays of primitives",
+      "input": {
+        "pairs": [["a", "b"], ["c", "d"]]
+      },
+      "expected": "pairs[2]:\n  - [2]: a,b\n  - [2]: c,d",
+      "specSection": "7.3"
+    },
+    {
+      "name": "quotes strings containing delimiters in nested arrays",
+      "input": {
+        "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"
+    },
+    {
+      "name": "handles empty inner arrays",
+      "input": {
+        "pairs": [[], []]
+      },
+      "expected": "pairs[2]:\n  - [0]:\n  - [0]:",
+      "specSection": "7.3"
+    },
+    {
+      "name": "handles mixed-length inner arrays",
+      "input": {
+        "pairs": [[1], [2, 3]]
+      },
+      "expected": "pairs[2]:\n  - [1]: 1\n  - [2]: 2,3",
+      "specSection": "7.3"
+    },
+    {
+      "name": "encodes root-level primitive array",
+      "input": ["x", "y", "true", true, 10],
+      "expected": "[5]: x,y,\"true\",true,10",
+      "specSection": "7"
+    },
+    {
+      "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"
+    },
+    {
+      "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"
+    },
+    {
+      "name": "encodes empty root-level array",
+      "input": [],
+      "expected": "[0]:",
+      "specSection": "7"
+    },
+    {
+      "name": "encodes root-level arrays of arrays",
+      "input": [[1, 2], []],
+      "expected": "[2]:\n  - [2]: 1,2\n  - [0]:",
+      "specSection": "7.3"
+    },
+    {
+      "name": "encodes complex nested structure",
+      "input": {
+        "user": {
+          "id": 123,
+          "name": "Ada",
+          "tags": ["reading", "gaming"],
+          "active": true,
+          "prefs": []
+        }
+      },
+      "expected": "user:\n  id: 123\n  name: Ada\n  tags[2]: reading,gaming\n  active: true\n  prefs[0]:",
+      "specSection": "6"
+    },
+    {
+      "name": "uses list format for arrays mixing primitives and objects",
+      "input": {
+        "items": [1, { "a": 1 }, "text"]
+      },
+      "expected": "items[3]:\n  - 1\n  - a: 1\n  - text",
+      "specSection": "7.3"
+    },
+    {
+      "name": "uses list format for arrays mixing objects and arrays",
+      "input": {
+        "items": [{ "a": 1 }, [1, 2]]
+      },
+      "expected": "items[2]:\n  - a: 1\n  - [2]: 1,2",
+      "specSection": "7.3"
+    }
+  ]
+}