@toon-format/spec 1.3.0

package/tests/fixtures/encode/objects.json

@@ -0,0 +1,220 @@
+{
+  "version": "1.3",
+  "category": "encode",
+  "description": "Object encoding - simple objects, nested objects, key encoding",
+  "tests": [
+    {
+      "name": "preserves key order in objects",
+      "input": {
+        "id": 123,
+        "name": "Ada",
+        "active": true
+      },
+      "expected": "id: 123\nname: Ada\nactive: true",
+      "specSection": "6"
+    },
+    {
+      "name": "encodes null values in objects",
+      "input": {
+        "id": 123,
+        "value": null
+      },
+      "expected": "id: 123\nvalue: null",
+      "specSection": "6"
+    },
+    {
+      "name": "encodes empty objects as empty string",
+      "input": {},
+      "expected": "",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value with colon",
+      "input": {
+        "note": "a:b"
+      },
+      "expected": "note: \"a:b\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value with comma",
+      "input": {
+        "note": "a,b"
+      },
+      "expected": "note: \"a,b\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value with newline",
+      "input": {
+        "text": "line1\nline2"
+      },
+      "expected": "text: \"line1\\nline2\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value with embedded quotes",
+      "input": {
+        "text": "say \"hello\""
+      },
+      "expected": "text: \"say \\\"hello\\\"\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value with leading space",
+      "input": {
+        "text": " padded "
+      },
+      "expected": "text: \" padded \"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value with only spaces",
+      "input": {
+        "text": "  "
+      },
+      "expected": "text: \"  \"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value that looks like true",
+      "input": {
+        "v": "true"
+      },
+      "expected": "v: \"true\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value that looks like number",
+      "input": {
+        "v": "42"
+      },
+      "expected": "v: \"42\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes string value that looks like negative decimal",
+      "input": {
+        "v": "-7.5"
+      },
+      "expected": "v: \"-7.5\"",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with colon",
+      "input": {
+        "order:id": 7
+      },
+      "expected": "\"order:id\": 7",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with brackets",
+      "input": {
+        "[index]": 5
+      },
+      "expected": "\"[index]\": 5",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with braces",
+      "input": {
+        "{key}": 5
+      },
+      "expected": "\"{key}\": 5",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with comma",
+      "input": {
+        "a,b": 1
+      },
+      "expected": "\"a,b\": 1",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with spaces",
+      "input": {
+        "full name": "Ada"
+      },
+      "expected": "\"full name\": Ada",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with leading hyphen",
+      "input": {
+        "-lead": 1
+      },
+      "expected": "\"-lead\": 1",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes key with leading and trailing spaces",
+      "input": {
+        " a ": 1
+      },
+      "expected": "\" a \": 1",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes numeric key",
+      "input": {
+        "123": "x"
+      },
+      "expected": "\"123\": x",
+      "specSection": "6"
+    },
+    {
+      "name": "quotes empty string key",
+      "input": {
+        "": 1
+      },
+      "expected": "\"\": 1",
+      "specSection": "6"
+    },
+    {
+      "name": "escapes newline in key",
+      "input": {
+        "line\nbreak": 1
+      },
+      "expected": "\"line\\nbreak\": 1",
+      "specSection": "6"
+    },
+    {
+      "name": "escapes tab in key",
+      "input": {
+        "tab\there": 2
+      },
+      "expected": "\"tab\\there\": 2",
+      "specSection": "6"
+    },
+    {
+      "name": "escapes quotes in key",
+      "input": {
+        "he said \"hi\"": 1
+      },
+      "expected": "\"he said \\\"hi\\\"\": 1",
+      "specSection": "6"
+    },
+    {
+      "name": "encodes deeply nested objects",
+      "input": {
+        "a": {
+          "b": {
+            "c": "deep"
+          }
+        }
+      },
+      "expected": "a:\n  b:\n    c: deep",
+      "specSection": "6"
+    },
+    {
+      "name": "encodes empty nested object",
+      "input": {
+        "user": {}
+      },
+      "expected": "user:",
+      "specSection": "6"
+    }
+  ]
+}

package/tests/fixtures/encode/options.json

@@ -0,0 +1,88 @@
+{
+  "version": "1.3",
+  "category": "encode",
+  "description": "Encoding options - lengthMarker option and combinations with delimiters",
+  "tests": [
+    {
+      "name": "adds length marker to primitive arrays",
+      "input": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "expected": "tags[#3]: reading,gaming,coding",
+      "options": {
+        "lengthMarker": "#"
+      },
+      "specSection": "3"
+    },
+    {
+      "name": "adds length marker to empty arrays",
+      "input": {
+        "items": []
+      },
+      "expected": "items[#0]:",
+      "options": {
+        "lengthMarker": "#"
+      },
+      "specSection": "3"
+    },
+    {
+      "name": "adds length marker to tabular arrays",
+      "input": {
+        "items": [
+          { "sku": "A1", "qty": 2, "price": 9.99 },
+          { "sku": "B2", "qty": 1, "price": 14.5 }
+        ]
+      },
+      "expected": "items[#2]{sku,qty,price}:\n  A1,2,9.99\n  B2,1,14.5",
+      "options": {
+        "lengthMarker": "#"
+      },
+      "specSection": "3"
+    },
+    {
+      "name": "adds length marker to nested arrays",
+      "input": {
+        "pairs": [["a", "b"], ["c", "d"]]
+      },
+      "expected": "pairs[#2]:\n  - [#2]: a,b\n  - [#2]: c,d",
+      "options": {
+        "lengthMarker": "#"
+      },
+      "specSection": "3"
+    },
+    {
+      "name": "combines length marker with pipe delimiter",
+      "input": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "expected": "tags[#3|]: reading|gaming|coding",
+      "options": {
+        "lengthMarker": "#",
+        "delimiter": "|"
+      },
+      "specSection": "3"
+    },
+    {
+      "name": "combines length marker with tab delimiter",
+      "input": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "expected": "tags[#3\t]: reading\tgaming\tcoding",
+      "options": {
+        "lengthMarker": "#",
+        "delimiter": "\t"
+      },
+      "specSection": "3"
+    },
+    {
+      "name": "default lengthMarker is empty (no marker)",
+      "input": {
+        "tags": ["reading", "gaming", "coding"]
+      },
+      "expected": "tags[3]: reading,gaming,coding",
+      "options": {},
+      "specSection": "3",
+      "note": "Default behavior without lengthMarker option"
+    }
+  ]
+}

package/tests/fixtures/encode/primitives.json

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

package/tests/fixtures/encode/whitespace.json

@@ -0,0 +1,29 @@
+{
+  "version": "1.3",
+  "category": "encode",
+  "description": "Whitespace and formatting invariants - no trailing spaces, no trailing newlines",
+  "tests": [
+    {
+      "name": "produces no trailing newline at end of output",
+      "input": {
+        "id": 123
+      },
+      "expected": "id: 123",
+      "specSection": "4",
+      "note": "Output should not end with newline character"
+    },
+    {
+      "name": "maintains proper indentation for nested structures",
+      "input": {
+        "user": {
+          "id": 123,
+          "name": "Ada"
+        },
+        "items": ["a", "b"]
+      },
+      "expected": "user:\n  id: 123\n  name: Ada\nitems[2]: a,b",
+      "specSection": "4",
+      "note": "2-space indentation, no trailing spaces on any line"
+    }
+  ]
+}

package/tests/fixtures.schema.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://toon-format.org/schemas/test-fixture.json",
+  "title": "TOON Test Fixture",
+  "description": "Schema for language-agnostic TOON test fixtures",
+  "type": "object",
+  "required": ["version", "category", "description", "tests"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "TOON specification version these tests target",
+      "pattern": "^\\d+\\.\\d+$",
+      "examples": ["1.0", "1.3"]
+    },
+    "category": {
+      "type": "string",
+      "enum": ["encode", "decode"],
+      "description": "Test category: encode (JSON → TOON) or decode (TOON → JSON)"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of what this fixture file tests",
+      "minLength": 1,
+      "examples": ["Primitives - String Encoding", "Tabular Arrays - Decoding"]
+    },
+    "tests": {
+      "type": "array",
+      "description": "Array of test cases",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["name", "input", "expected"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Descriptive test name explaining what is being validated",
+            "minLength": 1,
+            "examples": [
+              "encodes safe strings without quotes",
+              "throws on array length mismatch"
+            ]
+          },
+          "input": {
+            "description": "Input value - JSON value for encode tests, TOON string for decode tests"
+          },
+          "expected": {
+            "description": "Expected output - TOON string for encode tests, JSON value for decode tests"
+          },
+          "shouldError": {
+            "type": "boolean",
+            "description": "If true, this test expects an error to be thrown",
+            "default": false
+          },
+          "options": {
+            "type": "object",
+            "description": "Encoding or decoding options",
+            "properties": {
+              "delimiter": {
+                "type": "string",
+                "enum": [",", "\t", "|"],
+                "description": "Array delimiter (encode only)",
+                "default": ","
+              },
+              "indent": {
+                "type": "integer",
+                "description": "Number of spaces per indentation level",
+                "minimum": 1,
+                "default": 2
+              },
+              "lengthMarker": {
+                "type": "string",
+                "enum": ["#", ""],
+                "description": "Optional marker to prefix array lengths (encode only)",
+                "default": ""
+              },
+              "strict": {
+                "type": "boolean",
+                "description": "Enable strict validation (decode only)",
+                "default": true
+              }
+            },
+            "additionalProperties": false
+          },
+          "specSection": {
+            "type": "string",
+            "description": "Reference to relevant specification section",
+            "pattern": "^§?\\d+(\\.\\d+)*$",
+            "examples": ["6", "7.2", "§7.2", "9"]
+          },
+          "note": {
+            "type": "string",
+            "description": "Optional note explaining special cases or edge case behavior"
+          },
+          "minSpecVersion": {
+            "type": "string",
+            "description": "Minimum specification version required for this test",
+            "pattern": "^\\d+\\.\\d+$",
+            "examples": ["1.0", "1.3"]
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": false
+}