@toon-format/spec 1.3.0

package/tests/fixtures/decode/blank-lines.json

@@ -0,0 +1,153 @@
+{
+  "version": "1.3",
+  "category": "decode",
+  "description": "Blank line handling - strict mode errors on blank lines inside arrays, accepts blank lines outside arrays",
+  "tests": [
+    {
+      "name": "throws on blank line inside list array",
+      "input": "items[3]:\n  - a\n\n  - b\n  - c",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws on blank line inside tabular array",
+      "input": "items[2]{id}:\n  1\n\n  2",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws on multiple blank lines inside array",
+      "input": "items[2]:\n  - a\n\n\n  - b",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws on blank line with spaces inside array",
+      "input": "items[2]:\n  - a\n  \n  - b",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws on blank line in nested list array",
+      "input": "outer[2]:\n  - inner[2]:\n    - a\n\n    - b\n  - x",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts blank line between root-level fields",
+      "input": "a: 1\n\nb: 2",
+      "expected": {
+        "a": 1,
+        "b": 2
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts trailing newline at end of file",
+      "input": "a: 1\n",
+      "expected": {
+        "a": 1
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts multiple trailing newlines",
+      "input": "a: 1\n\n\n",
+      "expected": {
+        "a": 1
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts blank line after array ends",
+      "input": "items[1]:\n  - a\n\nb: 2",
+      "expected": {
+        "items": ["a"],
+        "b": 2
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts blank line between nested object fields",
+      "input": "a:\n  b: 1\n\n  c: 2",
+      "expected": {
+        "a": {
+          "b": 1,
+          "c": 2
+        }
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "ignores blank lines inside list array when strict=false",
+      "input": "items[3]:\n  - a\n\n  - b\n  - c",
+      "expected": {
+        "items": ["a", "b", "c"]
+      },
+      "options": {
+        "strict": false
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "ignores blank lines inside tabular array when strict=false",
+      "input": "items[2]{id,name}:\n  1,Alice\n\n  2,Bob",
+      "expected": {
+        "items": [
+          { "id": 1, "name": "Alice" },
+          { "id": 2, "name": "Bob" }
+        ]
+      },
+      "options": {
+        "strict": false
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "ignores multiple blank lines in arrays when strict=false",
+      "input": "items[2]:\n  - a\n\n\n  - b",
+      "expected": {
+        "items": ["a", "b"]
+      },
+      "options": {
+        "strict": false
+      },
+      "specSection": "9"
+    }
+  ]
+}

package/tests/fixtures/decode/delimiters.json

@@ -0,0 +1,237 @@
+{
+  "version": "1.3",
+  "category": "decode",
+  "description": "Delimiter decoding - tab and pipe delimiter parsing, delimiter-aware value splitting",
+  "tests": [
+    {
+      "name": "parses primitive arrays with tab delimiter",
+      "input": "tags[3\t]: reading\tgaming\tcoding",
+      "expected": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses primitive arrays with pipe delimiter",
+      "input": "tags[3|]: reading|gaming|coding",
+      "expected": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses primitive arrays with comma delimiter",
+      "input": "tags[3]: reading,gaming,coding",
+      "expected": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses tabular arrays with tab delimiter",
+      "input": "items[2\t]{sku\tqty\tprice}:\n  A1\t2\t9.99\n  B2\t1\t14.5",
+      "expected": {
+        "items": [
+          { "sku": "A1", "qty": 2, "price": 9.99 },
+          { "sku": "B2", "qty": 1, "price": 14.5 }
+        ]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses tabular arrays with pipe delimiter",
+      "input": "items[2|]{sku|qty|price}:\n  A1|2|9.99\n  B2|1|14.5",
+      "expected": {
+        "items": [
+          { "sku": "A1", "qty": 2, "price": 9.99 },
+          { "sku": "B2", "qty": 1, "price": 14.5 }
+        ]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses nested arrays with tab delimiter",
+      "input": "pairs[2\t]:\n  - [2\t]: a\tb\n  - [2\t]: c\td",
+      "expected": {
+        "pairs": [["a", "b"], ["c", "d"]]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses nested arrays with pipe delimiter",
+      "input": "pairs[2|]:\n  - [2|]: a|b\n  - [2|]: c|d",
+      "expected": {
+        "pairs": [["a", "b"], ["c", "d"]]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "nested arrays inside list items default to comma delimiter",
+      "input": "items[1\t]:\n  - tags[3]: a,b,c",
+      "expected": {
+        "items": [{ "tags": ["a", "b", "c"] }]
+      },
+      "specSection": "8",
+      "note": "Parent uses tab, nested defaults to comma"
+    },
+    {
+      "name": "nested arrays inside list items default to comma with pipe parent",
+      "input": "items[1|]:\n  - tags[3]: a,b,c",
+      "expected": {
+        "items": [{ "tags": ["a", "b", "c"] }]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses root arrays with tab delimiter",
+      "input": "[3\t]: x\ty\tz",
+      "expected": ["x", "y", "z"],
+      "specSection": "8"
+    },
+    {
+      "name": "parses root arrays with pipe delimiter",
+      "input": "[3|]: x|y|z",
+      "expected": ["x", "y", "z"],
+      "specSection": "8"
+    },
+    {
+      "name": "parses root arrays of objects with tab delimiter",
+      "input": "[2\t]{id}:\n  1\n  2",
+      "expected": [{ "id": 1 }, { "id": 2 }],
+      "specSection": "8"
+    },
+    {
+      "name": "parses root arrays of objects with pipe delimiter",
+      "input": "[2|]{id}:\n  1\n  2",
+      "expected": [{ "id": 1 }, { "id": 2 }],
+      "specSection": "8"
+    },
+    {
+      "name": "parses values containing tab delimiter when quoted",
+      "input": "items[3\t]: a\t\"b\\tc\"\td",
+      "expected": {
+        "items": ["a", "b\tc", "d"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses values containing pipe delimiter when quoted",
+      "input": "items[3|]: a|\"b|c\"|d",
+      "expected": {
+        "items": ["a", "b|c", "d"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "does not split on commas when using tab delimiter",
+      "input": "items[2\t]: a,b\tc,d",
+      "expected": {
+        "items": ["a,b", "c,d"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "does not split on commas when using pipe delimiter",
+      "input": "items[2|]: a,b|c,d",
+      "expected": {
+        "items": ["a,b", "c,d"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses tabular values containing comma with comma delimiter",
+      "input": "items[2]{id,note}:\n  1,\"a,b\"\n  2,\"c,d\"",
+      "expected": {
+        "items": [
+          { "id": 1, "note": "a,b" },
+          { "id": 2, "note": "c,d" }
+        ]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "does not require quoting commas with tab delimiter",
+      "input": "items[2\t]{id\tnote}:\n  1\ta,b\n  2\tc,d",
+      "expected": {
+        "items": [
+          { "id": 1, "note": "a,b" },
+          { "id": 2, "note": "c,d" }
+        ]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "does not require quoting commas in object values",
+      "input": "note: a,b",
+      "expected": {
+        "note": "a,b"
+      },
+      "specSection": "8",
+      "note": "Object values don't require comma quoting regardless of delimiter"
+    },
+    {
+      "name": "parses nested array values containing pipe delimiter",
+      "input": "pairs[1|]:\n  - [2|]: a|\"b|c\"",
+      "expected": {
+        "pairs": [["a", "b|c"]]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses nested array values containing tab delimiter",
+      "input": "pairs[1\t]:\n  - [2\t]: a\t\"b\\tc\"",
+      "expected": {
+        "pairs": [["a", "b\tc"]]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "preserves quoted ambiguity with pipe delimiter",
+      "input": "items[3|]: \"true\"|\"42\"|\"-3.14\"",
+      "expected": {
+        "items": ["true", "42", "-3.14"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "preserves quoted ambiguity with tab delimiter",
+      "input": "items[3\t]: \"true\"\t\"42\"\t\"-3.14\"",
+      "expected": {
+        "items": ["true", "42", "-3.14"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses structural-looking strings when quoted with pipe delimiter",
+      "input": "items[3|]: \"[5]\"|\"{key}\"|\"- item\"",
+      "expected": {
+        "items": ["[5]", "{key}", "- item"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses structural-looking strings when quoted with tab delimiter",
+      "input": "items[3\t]: \"[5]\"\t\"{key}\"\t\"- item\"",
+      "expected": {
+        "items": ["[5]", "{key}", "- item"]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "parses tabular headers with keys containing the active delimiter",
+      "input": "items[2|]{\"a|b\"}:\n  1\n  2",
+      "expected": {
+        "items": [{ "a|b": 1 }, { "a|b": 2 }]
+      },
+      "specSection": "8"
+    },
+    {
+      "name": "accepts length marker with pipe delimiter",
+      "input": "tags[#3|]: reading|gaming|coding",
+      "expected": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "specSection": "8"
+    }
+  ]
+}

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

@@ -0,0 +1,197 @@
+{
+  "version": "1.3",
+  "category": "decode",
+  "description": "Strict mode indentation validation - non-multiple indentation, tab characters, custom indent sizes",
+  "tests": [
+    {
+      "name": "throws when object field has non-multiple indentation (3 spaces with indent=2)",
+      "input": "a:\n   b: 1",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "indent": 2,
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws when list item has non-multiple indentation (3 spaces with indent=2)",
+      "input": "items[2]:\n   - id: 1\n   - id: 2",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "indent": 2,
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws with custom indent size when non-multiple (3 spaces with indent=4)",
+      "input": "a:\n   b: 1",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "indent": 4,
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts correct indentation with custom indent size (4 spaces with indent=4)",
+      "input": "a:\n    b: 1",
+      "expected": {
+        "a": {
+          "b": 1
+        }
+      },
+      "options": {
+        "indent": 4,
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws when tab character used in indentation",
+      "input": "a:\n\tb: 1",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws when mixed tabs and spaces in indentation",
+      "input": "a:\n \tb: 1",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "throws when tab at start of line",
+      "input": "\ta: 1",
+      "expected": null,
+      "shouldError": true,
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts tabs in quoted string values",
+      "input": "text: \"hello\tworld\"",
+      "expected": {
+        "text": "hello\tworld"
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts tabs in quoted keys",
+      "input": "\"key\ttab\": value",
+      "expected": {
+        "key\ttab": "value"
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts tabs in quoted array elements",
+      "input": "items[2]: \"a\tb\",\"c\td\"",
+      "expected": {
+        "items": ["a\tb", "c\td"]
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts non-multiple indentation when strict=false",
+      "input": "a:\n   b: 1",
+      "expected": {
+        "a": {
+          "b": 1
+        }
+      },
+      "options": {
+        "indent": 2,
+        "strict": false
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "accepts tab indentation when strict=false (tabs ignored, depth=0)",
+      "input": "a:\n\tb: 1",
+      "expected": {
+        "a": {},
+        "b": 1
+      },
+      "options": {
+        "strict": false
+      },
+      "specSection": "9",
+      "note": "Tabs are ignored in indentation counting, so b appears at root level"
+    },
+    {
+      "name": "accepts deeply nested non-multiples when strict=false",
+      "input": "a:\n   b:\n     c: 1",
+      "expected": {
+        "a": {
+          "b": {
+            "c": 1
+          }
+        }
+      },
+      "options": {
+        "indent": 2,
+        "strict": false
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "empty lines do not trigger validation errors",
+      "input": "a: 1\n\nb: 2",
+      "expected": {
+        "a": 1,
+        "b": 2
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "root-level content (0 indentation) is always valid",
+      "input": "a: 1\nb: 2\nc: 3",
+      "expected": {
+        "a": 1,
+        "b": 2,
+        "c": 3
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    },
+    {
+      "name": "lines with only spaces are not validated if empty",
+      "input": "a: 1\n   \nb: 2",
+      "expected": {
+        "a": 1,
+        "b": 2
+      },
+      "options": {
+        "strict": true
+      },
+      "specSection": "9"
+    }
+  ]
+}