@toon-format/spec 1.3.3 → 1.5.0

package/tests/fixtures/encode/primitives.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Primitive value encoding - strings, numbers, booleans, null",
   "tests": [
@@ -7,220 +7,245 @@
       "name": "encodes safe strings without quotes",
       "input": "hello",
       "expected": "hello",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "encodes safe string with underscore and numbers",
       "input": "Ada_99",
       "expected": "Ada_99",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes empty string",
       "input": "",
       "expected": "\"\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string that looks like true",
       "input": "true",
       "expected": "\"true\"",
-      "specSection": "5",
+      "specSection": "7.2",
       "note": "String representation of boolean must be quoted"
     },
     {
       "name": "quotes string that looks like false",
       "input": "false",
       "expected": "\"false\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string that looks like null",
       "input": "null",
       "expected": "\"null\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string that looks like integer",
       "input": "42",
       "expected": "\"42\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string that looks like negative decimal",
       "input": "-3.14",
       "expected": "\"-3.14\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string that looks like scientific notation",
       "input": "1e-6",
       "expected": "\"1e-6\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string with leading zero",
       "input": "05",
       "expected": "\"05\"",
-      "specSection": "5",
+      "specSection": "7.2",
       "note": "Leading zeros make it non-numeric"
     },
     {
       "name": "escapes newline in string",
       "input": "line1\nline2",
       "expected": "\"line1\\nline2\"",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
       "name": "escapes tab in string",
       "input": "tab\there",
       "expected": "\"tab\\there\"",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
       "name": "escapes carriage return in string",
       "input": "return\rcarriage",
       "expected": "\"return\\rcarriage\"",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
       "name": "escapes backslash in string",
       "input": "C:\\Users\\path",
       "expected": "\"C:\\\\Users\\\\path\"",
-      "specSection": "5"
+      "specSection": "7.1"
     },
     {
       "name": "quotes string with array-like syntax",
       "input": "[3]: x,y",
       "expected": "\"[3]: x,y\"",
-      "specSection": "5",
+      "specSection": "7.2",
       "note": "Looks like array header"
     },
     {
       "name": "quotes string starting with hyphen-space",
       "input": "- item",
       "expected": "\"- item\"",
-      "specSection": "5",
+      "specSection": "7.2",
       "note": "Looks like list item marker"
     },
+    {
+      "name": "quotes single hyphen as object value",
+      "input": { "marker": "-" },
+      "expected": "marker: \"-\"",
+      "specSection": "7.2",
+      "note": "Single hyphen must be quoted to avoid list item ambiguity"
+    },
+    {
+      "name": "quotes string starting with hyphen as object value",
+      "input": { "note": "- item" },
+      "expected": "note: \"- item\"",
+      "specSection": "7.2"
+    },
+    {
+      "name": "quotes single hyphen in array",
+      "input": { "items": ["-"] },
+      "expected": "items[1]: \"-\"",
+      "specSection": "7.2"
+    },
+    {
+      "name": "quotes leading-hyphen string in array",
+      "input": { "tags": ["a", "- item", "b"] },
+      "expected": "tags[3]: a,\"- item\",b",
+      "specSection": "7.2"
+    },
     {
       "name": "quotes string with bracket notation",
       "input": "[test]",
       "expected": "\"[test]\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "quotes string with brace notation",
       "input": "{key}",
       "expected": "\"{key}\"",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "encodes Unicode string without quotes",
       "input": "café",
       "expected": "café",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "encodes Chinese characters without quotes",
       "input": "你好",
       "expected": "你好",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "encodes emoji without quotes",
       "input": "🚀",
       "expected": "🚀",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "encodes string with emoji and spaces",
       "input": "hello 👋 world",
       "expected": "hello 👋 world",
-      "specSection": "5"
+      "specSection": "7.2"
     },
     {
       "name": "encodes positive integer",
       "input": 42,
       "expected": "42",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes decimal number",
       "input": 3.14,
       "expected": "3.14",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes negative integer",
       "input": -7,
       "expected": "-7",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes zero",
       "input": 0,
       "expected": "0",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes negative zero as zero",
       "input": -0,
       "expected": "0",
-      "specSection": "5",
+      "specSection": "2",
       "note": "Negative zero normalizes to zero"
     },
     {
       "name": "encodes scientific notation as decimal",
       "input": 1000000,
       "expected": "1000000",
-      "specSection": "5",
+      "specSection": "2",
       "note": "1e6 input, but represented as decimal"
     },
     {
       "name": "encodes small decimal from scientific notation",
       "input": 0.000001,
       "expected": "0.000001",
-      "specSection": "5",
+      "specSection": "2",
       "note": "1e-6 input"
     },
     {
       "name": "encodes large number",
       "input": 100000000000000000000,
       "expected": "100000000000000000000",
-      "specSection": "5",
+      "specSection": "2",
       "note": "1e20"
     },
     {
       "name": "encodes MAX_SAFE_INTEGER",
       "input": 9007199254740991,
       "expected": "9007199254740991",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes repeating decimal with full precision",
       "input": 0.3333333333333333,
       "expected": "0.3333333333333333",
-      "specSection": "5",
+      "specSection": "2",
       "note": "Result of 1/3 in JavaScript"
     },
     {
       "name": "encodes true",
       "input": true,
       "expected": "true",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes false",
       "input": false,
       "expected": "false",
-      "specSection": "5"
+      "specSection": "2"
     },
     {
       "name": "encodes null",
       "input": null,
       "expected": "null",
-      "specSection": "5"
+      "specSection": "2"
     }
   ]
 }

package/tests/fixtures/encode/whitespace.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3",
+  "version": "1.4",
   "category": "encode",
   "description": "Whitespace and formatting invariants - no trailing spaces, no trailing newlines",
   "tests": [
@@ -9,7 +9,7 @@
         "id": 123
       },
       "expected": "id: 123",
-      "specSection": "4",
+      "specSection": "12",
       "note": "Output should not end with newline character"
     },
     {
@@ -22,8 +22,23 @@
         "items": ["a", "b"]
       },
       "expected": "user:\n  id: 123\n  name: Ada\nitems[2]: a,b",
-      "specSection": "4",
+      "specSection": "12",
       "note": "2-space indentation, no trailing spaces on any line"
+    },
+    {
+      "name": "respects custom indent size option",
+      "input": {
+        "user": {
+          "name": "Ada",
+          "role": "admin"
+        }
+      },
+      "expected": "user:\n    name: Ada\n    role: admin",
+      "specSection": "12",
+      "options": {
+        "indent": 4
+      },
+      "note": "4-space indentation for nested objects when indent option is set to 4"
     }
   ]
 }

package/tests/fixtures.schema.json

@@ -69,14 +69,30 @@
               },
               "lengthMarker": {
                 "type": "string",
-                "enum": ["#", ""],
-                "description": "Optional marker to prefix array lengths (encode only)",
-                "default": ""
+                "const": "#",
+                "description": "Optional marker to prefix array lengths (encode only). Omit to disable the marker."
               },
               "strict": {
                 "type": "boolean",
                 "description": "Enable strict validation (decode only)",
                 "default": true
+              },
+              "keyFolding": {
+                "type": "string",
+                "enum": ["off", "safe"],
+                "description": "Key folding mode for encoders (v1.5+): 'off' (default) or 'safe' (encode only)",
+                "default": "off"
+              },
+              "flattenDepth": {
+                "type": "integer",
+                "description": "Maximum depth to fold key chains when keyFolding is 'safe' (v1.5+). Values less than 2 have no practical folding effect (encode only)",
+                "minimum": 0
+              },
+              "expandPaths": {
+                "type": "string",
+                "enum": ["off", "safe"],
+                "description": "Path expansion mode for decoders (v1.5+): 'off' (default) or 'safe' (decode only)",
+                "default": "off"
               }
             },
             "additionalProperties": false
@@ -95,7 +111,7 @@
             "type": "string",
             "description": "Minimum specification version required for this test",
             "pattern": "^\\d+\\.\\d+$",
-            "examples": ["1.0", "1.3"]
+            "examples": ["1.0", "1.4"]
           }
         },
         "additionalProperties": false

package/tests/fixtures/encode/normalization.json

@@ -1,107 +0,0 @@
-{
-  "version": "1.3",
-  "category": "encode",
-  "description": "Non-JSON type normalization - BigInt, Date, undefined, NaN, Infinity, functions, symbols",
-  "tests": [
-    {
-      "name": "converts BigInt to number",
-      "input": 123,
-      "expected": "123",
-      "specSection": "5",
-      "note": "BigInt(123) in JavaScript becomes 123"
-    },
-    {
-      "name": "converts BigInt in object to number",
-      "input": {
-        "id": 456
-      },
-      "expected": "id: 456",
-      "specSection": "5",
-      "note": "BigInt(456) in JavaScript becomes 456"
-    },
-    {
-      "name": "converts Date to ISO string",
-      "input": "2025-01-01T00:00:00.000Z",
-      "expected": "\"2025-01-01T00:00:00.000Z\"",
-      "specSection": "5",
-      "note": "new Date('2025-01-01T00:00:00.000Z') becomes quoted ISO string"
-    },
-    {
-      "name": "converts Date in object to ISO string",
-      "input": {
-        "created": "2025-01-01T00:00:00.000Z"
-      },
-      "expected": "created: \"2025-01-01T00:00:00.000Z\"",
-      "specSection": "5"
-    },
-    {
-      "name": "converts undefined to null",
-      "input": null,
-      "expected": "null",
-      "specSection": "5",
-      "note": "undefined in JavaScript becomes null"
-    },
-    {
-      "name": "converts undefined in object to null",
-      "input": {
-        "value": null
-      },
-      "expected": "value: null",
-      "specSection": "5",
-      "note": "undefined in JavaScript becomes null"
-    },
-    {
-      "name": "converts Infinity to null",
-      "input": null,
-      "expected": "null",
-      "specSection": "5",
-      "note": "Infinity becomes null"
-    },
-    {
-      "name": "converts negative Infinity to null",
-      "input": null,
-      "expected": "null",
-      "specSection": "5",
-      "note": "-Infinity becomes null"
-    },
-    {
-      "name": "converts NaN to null",
-      "input": null,
-      "expected": "null",
-      "specSection": "5",
-      "note": "Number.NaN becomes null"
-    },
-    {
-      "name": "converts function to null",
-      "input": null,
-      "expected": "null",
-      "specSection": "5",
-      "note": "Functions become null"
-    },
-    {
-      "name": "converts function in object to null",
-      "input": {
-        "fn": null
-      },
-      "expected": "fn: null",
-      "specSection": "5",
-      "note": "Functions become null"
-    },
-    {
-      "name": "converts symbol to null",
-      "input": null,
-      "expected": "null",
-      "specSection": "5",
-      "note": "Symbols become null"
-    },
-    {
-      "name": "converts symbol in object to null",
-      "input": {
-        "sym": null
-      },
-      "expected": "sym: null",
-      "specSection": "5",
-      "note": "Symbols become null"
-    }
-  ]
-}