@toon-format/spec 1.3.3 → 1.5.0

package/tests/fixtures/encode/delimiters.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Delimiter options - tab and pipe delimiters, delimiter-aware quoting",
   "tests": [
@@ -12,7 +12,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes primitive arrays with pipe delimiter",
@@ -23,7 +23,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes primitive arrays with comma delimiter",
@@ -34,7 +34,7 @@
       "options": {
         "delimiter": ","
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes tabular arrays with tab delimiter",
@@ -48,7 +48,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes tabular arrays with pipe delimiter",
@@ -62,7 +62,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes nested arrays with tab delimiter",
@@ -73,7 +73,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes nested arrays with pipe delimiter",
@@ -84,7 +84,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes root arrays with tab delimiter",
@@ -93,7 +93,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes root arrays with pipe delimiter",
@@ -102,7 +102,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes root arrays of objects with tab delimiter",
@@ -111,7 +111,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "encodes root arrays of objects with pipe delimiter",
@@ -120,7 +120,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "quotes strings containing tab delimiter",
@@ -131,7 +131,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "quotes strings containing pipe delimiter",
@@ -142,7 +142,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "does not quote commas with tab delimiter",
@@ -153,7 +153,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "does not quote commas with pipe delimiter",
@@ -164,7 +164,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "quotes tabular values containing comma delimiter",
@@ -178,7 +178,7 @@
       "options": {
         "delimiter": ","
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "does not quote commas in tabular values with tab delimiter",
@@ -192,7 +192,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "does not quote commas in object values with pipe delimiter",
@@ -203,7 +203,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "does not quote commas in object values with tab delimiter",
@@ -214,7 +214,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "quotes nested array values containing pipe delimiter",
@@ -225,7 +225,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "quotes nested array values containing tab delimiter",
@@ -236,7 +236,7 @@
       "options": {
         "delimiter": "\t"
       },
-      "specSection": "8"
+      "specSection": "11"
     },
     {
       "name": "preserves ambiguity quoting regardless of delimiter",
@@ -247,7 +247,7 @@
       "options": {
         "delimiter": "|"
       },
-      "specSection": "8"
+      "specSection": "11"
     }
   ]
 }

package/tests/fixtures/encode/key-folding.json

@@ -0,0 +1,218 @@
+{
+  "version": "1.5",
+  "category": "encode",
+  "description": "Key folding with safe mode, depth control, collision avoidance",
+  "tests": [
+    {
+      "name": "encodes folded chain to primitive (safe mode)",
+      "input": {
+        "a": {
+          "b": {
+            "c": 1
+          }
+        }
+      },
+      "expected": "a.b.c: 1",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "encodes folded chain with inline array",
+      "input": {
+        "data": {
+          "meta": {
+            "items": ["x", "y"]
+          }
+        }
+      },
+      "expected": "data.meta.items[2]: x,y",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "encodes folded chain with tabular array",
+      "input": {
+        "a": {
+          "b": {
+            "items": [
+              { "id": 1, "name": "A" },
+              { "id": 2, "name": "B" }
+            ]
+          }
+        }
+      },
+      "expected": "a.b.items[2]{id,name}:\n  1,A\n  2,B",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "skips folding when segment requires quotes (safe mode)",
+      "input": {
+        "data": {
+          "full-name": {
+            "x": 1
+          }
+        }
+      },
+      "expected": "data:\n  \"full-name\":\n    x: 1",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "skips folding on sibling literal-key collision (safe mode)",
+      "input": {
+        "data": {
+          "meta": {
+            "items": [1, 2]
+          }
+        },
+        "data.meta.items": "literal"
+      },
+      "expected": "data:\n  meta:\n    items[2]: 1,2\ndata.meta.items: literal",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4",
+      "note": "Collision avoidance: folding would create duplicate key"
+    },
+    {
+      "name": "encodes partial folding with flattenDepth=2",
+      "input": {
+        "a": {
+          "b": {
+            "c": {
+              "d": 1
+            }
+          }
+        }
+      },
+      "expected": "a.b:\n  c:\n    d: 1",
+      "options": {
+        "keyFolding": "safe",
+        "flattenDepth": 2
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "encodes full chain with flattenDepth=Infinity (default)",
+      "input": {
+        "a": {
+          "b": {
+            "c": {
+              "d": 1
+            }
+          }
+        }
+      },
+      "expected": "a.b.c.d: 1",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "encodes standard nesting with flattenDepth=0 (no folding)",
+      "input": {
+        "a": {
+          "b": {
+            "c": 1
+          }
+        }
+      },
+      "expected": "a:\n  b:\n    c: 1",
+      "options": {
+        "keyFolding": "safe",
+        "flattenDepth": 0
+      },
+      "specSection": "13.4",
+      "note": "flattenDepth=0 disables all folding"
+    },
+    {
+      "name": "encodes standard nesting with flattenDepth=1 (no practical effect)",
+      "input": {
+        "a": {
+          "b": {
+            "c": 1
+          }
+        }
+      },
+      "expected": "a:\n  b:\n    c: 1",
+      "options": {
+        "keyFolding": "safe",
+        "flattenDepth": 1
+      },
+      "specSection": "13.4",
+      "note": "flattenDepth=1 has no practical folding effect (requires at least 2 segments)"
+    },
+    {
+      "name": "encodes standard nesting with keyFolding=off (baseline)",
+      "input": {
+        "a": {
+          "b": {
+            "c": 1
+          }
+        }
+      },
+      "expected": "a:\n  b:\n    c: 1",
+      "options": {
+        "keyFolding": "off"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "encodes folded chain ending with empty object",
+      "input": {
+        "a": {
+          "b": {
+            "c": {}
+          }
+        }
+      },
+      "expected": "a.b.c:",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "stops folding at array boundary (not single-key object)",
+      "input": {
+        "a": {
+          "b": [1, 2]
+        }
+      },
+      "expected": "a.b[2]: 1,2",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    },
+    {
+      "name": "encodes partial fold preserving sibling field order",
+      "input": {
+        "folded": {
+          "path": {
+            "value": 1
+          }
+        },
+        "normal": 2,
+        "nested": {
+          "x": 3
+        }
+      },
+      "expected": "folded.path.value: 1\nnormal: 2\nnested:\n  x: 3",
+      "options": {
+        "keyFolding": "safe"
+      },
+      "specSection": "13.4"
+    }
+  ]
+}

package/tests/fixtures/encode/objects.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Object encoding - simple objects, nested objects, key encoding",
   "tests": [
@@ -11,7 +11,7 @@
         "active": true
       },
       "expected": "id: 123\nname: Ada\nactive: true",
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "encodes null values in objects",
@@ -20,13 +20,13 @@
         "value": null
       },
       "expected": "id: 123\nvalue: null",
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "encodes empty objects as empty string",
       "input": {},
       "expected": "",
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "quotes string value with colon",
@@ -34,7 +34,7 @@
         "note": "a:b"
       },
       "expected": "note: \"a:b\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value with comma",
@@ -42,7 +42,7 @@
         "note": "a,b"
       },
       "expected": "note: \"a,b\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value with newline",
@@ -50,7 +50,7 @@
         "text": "line1\nline2"
       },
       "expected": "text: \"line1\\nline2\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value with embedded quotes",
@@ -58,7 +58,7 @@
         "text": "say \"hello\""
       },
       "expected": "text: \"say \\\"hello\\\"\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value with leading space",
@@ -66,7 +66,7 @@
         "text": " padded "
       },
       "expected": "text: \" padded \"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value with only spaces",
@@ -74,7 +74,7 @@
         "text": "  "
       },
       "expected": "text: \"  \"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value that looks like true",
@@ -82,7 +82,7 @@
         "v": "true"
       },
       "expected": "v: \"true\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value that looks like number",
@@ -90,7 +90,7 @@
         "v": "42"
       },
       "expected": "v: \"42\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string value that looks like negative decimal",
@@ -98,7 +98,7 @@
         "v": "-7.5"
       },
       "expected": "v: \"-7.5\"",
-      "specSection": "6"
+      "specSection": "7.2"
     },
     {
       "name": "quotes key with colon",
@@ -106,7 +106,7 @@
         "order:id": 7
       },
       "expected": "\"order:id\": 7",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes key with brackets",
@@ -114,7 +114,7 @@
         "[index]": 5
       },
       "expected": "\"[index]\": 5",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes key with braces",
@@ -122,7 +122,7 @@
         "{key}": 5
       },
       "expected": "\"{key}\": 5",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes key with comma",
@@ -130,7 +130,7 @@
         "a,b": 1
       },
       "expected": "\"a,b\": 1",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes key with spaces",
@@ -138,7 +138,7 @@
         "full name": "Ada"
       },
       "expected": "\"full name\": Ada",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes key with leading hyphen",
@@ -146,7 +146,7 @@
         "-lead": 1
       },
       "expected": "\"-lead\": 1",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes key with leading and trailing spaces",
@@ -154,7 +154,7 @@
         " a ": 1
       },
       "expected": "\" a \": 1",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes numeric key",
@@ -162,7 +162,7 @@
         "123": "x"
       },
       "expected": "\"123\": x",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "quotes empty string key",
@@ -170,7 +170,7 @@
         "": 1
       },
       "expected": "\"\": 1",
-      "specSection": "6"
+      "specSection": "7.3"
     },
     {
       "name": "escapes newline in key",
@@ -178,7 +178,7 @@
         "line\nbreak": 1
       },
       "expected": "\"line\\nbreak\": 1",
-      "specSection": "6"
+      "specSection": "7.1"
     },
     {
       "name": "escapes tab in key",
@@ -186,7 +186,7 @@
         "tab\there": 2
       },
       "expected": "\"tab\\there\": 2",
-      "specSection": "6"
+      "specSection": "7.1"
     },
     {
       "name": "escapes quotes in key",
@@ -194,7 +194,7 @@
         "he said \"hi\"": 1
       },
       "expected": "\"he said \\\"hi\\\"\": 1",
-      "specSection": "6"
+      "specSection": "7.1"
     },
     {
       "name": "encodes deeply nested objects",
@@ -206,7 +206,7 @@
         }
       },
       "expected": "a:\n  b:\n    c: deep",
-      "specSection": "6"
+      "specSection": "8"
     },
     {
       "name": "encodes empty nested object",
@@ -214,7 +214,7 @@
         "user": {}
       },
       "expected": "user:",
-      "specSection": "6"
+      "specSection": "8"
     }
   ]
 }

package/tests/fixtures/encode/options.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Encoding options - lengthMarker option and combinations with delimiters",
   "tests": [