MercuryToolbox/fixtures/toon-spec/encode/key-folding.json

{
  "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 folded chains preserving sibling field order",
      "input": {
        "first": {
          "second": {
            "third": 1
          }
        },
        "simple": 2,
        "short": {
          "path": 3
        }
      },
      "expected": "first.second.third: 1\nsimple: 2\nshort.path: 3",
      "options": {
        "keyFolding": "safe"
      },
      "specSection": "13.4"
    }
  ]
}