@vireo-ai/trellis-ui 0.1.60 → 0.1.61

package/packages/theme-engine/generated/knobs/v1/depth.json

@@ -0,0 +1,1705 @@
+{
+  "version": 1,
+  "schemaVersion": 1,
+  "catalogFingerprint": "9242067137732bec",
+  "group": {
+    "id": "depth",
+    "axis": "depth",
+    "title": "Depth",
+    "description": "Layered shadow color and geometry."
+  },
+  "knobs": [
+    {
+      "path": "/depth/layers/{layer}/blur/dark/{level}/unit",
+      "title": "Depth dark unit",
+      "description": "Controls blur geometry for one shadow layer across elevation levels.",
+      "keywords": [
+        "blur",
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "shadow",
+        "softness",
+        "unit"
+      ],
+      "affects": [
+        "depth theme output",
+        "elevation shadow softness",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/blur",
+          "/depth/layers/{layer}/blur/dark",
+          "/depth/layers/{layer}/blur/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/blur/dark/{level}/value",
+      "title": "Depth dark value",
+      "description": "Controls blur geometry for one shadow layer across elevation levels.",
+      "keywords": [
+        "blur",
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "shadow",
+        "softness",
+        "value"
+      ],
+      "affects": [
+        "depth theme output",
+        "elevation shadow softness",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/blur",
+          "/depth/layers/{layer}/blur/dark",
+          "/depth/layers/{layer}/blur/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/blur/light/{level}/unit",
+      "title": "Depth light unit",
+      "description": "Controls blur geometry for one shadow layer across elevation levels.",
+      "keywords": [
+        "blur",
+        "border",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "shadow",
+        "softness",
+        "unit"
+      ],
+      "affects": [
+        "depth theme output",
+        "elevation shadow softness",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/blur",
+          "/depth/layers/{layer}/blur/light",
+          "/depth/layers/{layer}/blur/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/blur/light/{level}/value",
+      "title": "Depth light value",
+      "description": "Controls blur geometry for one shadow layer across elevation levels.",
+      "keywords": [
+        "blur",
+        "border",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "shadow",
+        "softness",
+        "value"
+      ],
+      "affects": [
+        "depth theme output",
+        "elevation shadow softness",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/blur",
+          "/depth/layers/{layer}/blur/light",
+          "/depth/layers/{layer}/blur/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/appearances/dark",
+      "title": "Depth appearances dark",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "appearances",
+        "border",
+        "chroma",
+        "color",
+        "dark",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "shadow",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "appearance",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color",
+          "/depth/layers/{layer}/color/appearances"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/appearances/light",
+      "title": "Depth appearances light",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "appearances",
+        "border",
+        "chroma",
+        "color",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "light",
+        "shadow",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "appearance",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color",
+          "/depth/layers/{layer}/color/appearances"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/chromaInfluence",
+      "title": "Depth color chroma influence",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "border",
+        "chroma",
+        "color",
+        "depth",
+        "elevation",
+        "influence",
+        "layer",
+        "layers",
+        "shadow",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/family",
+      "title": "Depth color family",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "border",
+        "chroma",
+        "color",
+        "depth",
+        "elevation",
+        "family",
+        "layer",
+        "layers",
+        "shadow",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "pattern": "^(?:neutral|accent|status\\.[a-z][a-z0-9-]*|supporting\\.[a-z][a-z0-9-]*|named\\.[a-z][a-z0-9-]*)$"
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/kind",
+      "title": "Depth color kind",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "border",
+        "chroma",
+        "color",
+        "depth",
+        "elevation",
+        "kind",
+        "layer",
+        "layers",
+        "shadow",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "palette",
+          "alpha-palette",
+          "canvas-relative",
+          "color"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/step",
+      "title": "Depth color step",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "border",
+        "chroma",
+        "color",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "shadow",
+        "step",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "enum": [
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8,
+          9,
+          10,
+          11,
+          12
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/color/toneOffset",
+      "title": "Depth color tone offset",
+      "description": "Selects or derives the color used by one shadow layer.",
+      "keywords": [
+        "border",
+        "chroma",
+        "color",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "offset",
+        "shadow",
+        "tone"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow color",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -1,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/color"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/kind",
+      "title": "Depth layers kind",
+      "description": "Controls a low-level shadow-layer or elevation relationship.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "kind",
+        "layer",
+        "layers",
+        "shadow"
+      ],
+      "affects": [
+        "depth theme output",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "outer",
+          "inner"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/name",
+      "title": "Depth layers name",
+      "description": "Controls a low-level shadow-layer or elevation relationship.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "name",
+        "shadow"
+      ],
+      "affects": [
+        "depth theme output",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "pattern": "^[a-z][a-z0-9-]*$"
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetX/dark/{level}/unit",
+      "title": "Depth dark unit",
+      "description": "Controls a low-level shadow-layer or elevation relationship.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "offset",
+        "shadow",
+        "unit",
+        "x"
+      ],
+      "affects": [
+        "depth theme output",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetX",
+          "/depth/layers/{layer}/offsetX/dark",
+          "/depth/layers/{layer}/offsetX/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetX/dark/{level}/value",
+      "title": "Depth dark value",
+      "description": "Controls a low-level shadow-layer or elevation relationship.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "offset",
+        "shadow",
+        "value",
+        "x"
+      ],
+      "affects": [
+        "depth theme output",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -200,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetX",
+          "/depth/layers/{layer}/offsetX/dark",
+          "/depth/layers/{layer}/offsetX/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetX/light/{level}/unit",
+      "title": "Depth light unit",
+      "description": "Controls a low-level shadow-layer or elevation relationship.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "offset",
+        "shadow",
+        "unit",
+        "x"
+      ],
+      "affects": [
+        "depth theme output",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetX",
+          "/depth/layers/{layer}/offsetX/light",
+          "/depth/layers/{layer}/offsetX/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetX/light/{level}/value",
+      "title": "Depth light value",
+      "description": "Controls a low-level shadow-layer or elevation relationship.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "offset",
+        "shadow",
+        "value",
+        "x"
+      ],
+      "affects": [
+        "depth theme output",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -200,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetX",
+          "/depth/layers/{layer}/offsetX/light",
+          "/depth/layers/{layer}/offsetX/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetY/dark/{level}/unit",
+      "title": "Depth dark unit",
+      "description": "Controls vertical displacement for one shadow layer across elevation levels.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "height",
+        "layer",
+        "layers",
+        "level",
+        "offset",
+        "shadow",
+        "unit",
+        "y"
+      ],
+      "affects": [
+        "depth theme output",
+        "perceived elevation",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetY",
+          "/depth/layers/{layer}/offsetY/dark",
+          "/depth/layers/{layer}/offsetY/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetY/dark/{level}/value",
+      "title": "Depth dark value",
+      "description": "Controls vertical displacement for one shadow layer across elevation levels.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "height",
+        "layer",
+        "layers",
+        "level",
+        "offset",
+        "shadow",
+        "value",
+        "y"
+      ],
+      "affects": [
+        "depth theme output",
+        "perceived elevation",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -200,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetY",
+          "/depth/layers/{layer}/offsetY/dark",
+          "/depth/layers/{layer}/offsetY/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetY/light/{level}/unit",
+      "title": "Depth light unit",
+      "description": "Controls vertical displacement for one shadow layer across elevation levels.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "height",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "offset",
+        "shadow",
+        "unit",
+        "y"
+      ],
+      "affects": [
+        "depth theme output",
+        "perceived elevation",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetY",
+          "/depth/layers/{layer}/offsetY/light",
+          "/depth/layers/{layer}/offsetY/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/offsetY/light/{level}/value",
+      "title": "Depth light value",
+      "description": "Controls vertical displacement for one shadow layer across elevation levels.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "height",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "offset",
+        "shadow",
+        "value",
+        "y"
+      ],
+      "affects": [
+        "depth theme output",
+        "perceived elevation",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -200,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/offsetY",
+          "/depth/layers/{layer}/offsetY/light",
+          "/depth/layers/{layer}/offsetY/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/opacity/dark/{level}",
+      "title": "Depth opacity dark",
+      "description": "Controls the visibility of one shadow layer at each elevation level.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "opacity",
+        "shadow",
+        "strength"
+      ],
+      "affects": [
+        "depth theme output",
+        "elevation shadow strength",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/opacity",
+          "/depth/layers/{layer}/opacity/dark"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/opacity/light/{level}",
+      "title": "Depth opacity light",
+      "description": "Controls the visibility of one shadow layer at each elevation level.",
+      "keywords": [
+        "border",
+        "depth",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "opacity",
+        "shadow",
+        "strength"
+      ],
+      "affects": [
+        "depth theme output",
+        "elevation shadow strength",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/opacity",
+          "/depth/layers/{layer}/opacity/light"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/spread/dark/{level}/unit",
+      "title": "Depth dark unit",
+      "description": "Controls spread geometry or semantic edge-width binding for one shadow layer.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "edge",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "shadow",
+        "spread",
+        "unit"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow footprint and perimeter",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/spread",
+          "/depth/layers/{layer}/spread/dark",
+          "/depth/layers/{layer}/spread/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/spread/dark/{level}/value",
+      "title": "Depth dark value",
+      "description": "Controls spread geometry or semantic edge-width binding for one shadow layer.",
+      "keywords": [
+        "border",
+        "dark",
+        "depth",
+        "edge",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "shadow",
+        "spread",
+        "value"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow footprint and perimeter",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -200,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/spread",
+          "/depth/layers/{layer}/spread/dark",
+          "/depth/layers/{layer}/spread/dark/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/spread/kind",
+      "title": "Depth spread kind",
+      "description": "Controls spread geometry or semantic edge-width binding for one shadow layer.",
+      "keywords": [
+        "border",
+        "depth",
+        "edge",
+        "elevation",
+        "kind",
+        "layer",
+        "layers",
+        "shadow",
+        "spread"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow footprint and perimeter",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "edge-width"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/spread"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/spread/light/{level}/unit",
+      "title": "Depth light unit",
+      "description": "Controls spread geometry or semantic edge-width binding for one shadow layer.",
+      "keywords": [
+        "border",
+        "depth",
+        "edge",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "shadow",
+        "spread",
+        "unit"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow footprint and perimeter",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "px",
+          "rem"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/spread",
+          "/depth/layers/{layer}/spread/light",
+          "/depth/layers/{layer}/spread/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/spread/light/{level}/value",
+      "title": "Depth light value",
+      "description": "Controls spread geometry or semantic edge-width binding for one shadow layer.",
+      "keywords": [
+        "border",
+        "depth",
+        "edge",
+        "elevation",
+        "layer",
+        "layers",
+        "level",
+        "light",
+        "shadow",
+        "spread",
+        "value"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow footprint and perimeter",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "step",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -200,
+        "maximum": 200
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        },
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/spread",
+          "/depth/layers/{layer}/spread/light",
+          "/depth/layers/{layer}/spread/light/{level}"
+        ]
+      }
+    },
+    {
+      "path": "/depth/layers/{layer}/spread/role",
+      "title": "Depth spread role",
+      "description": "Controls spread geometry or semantic edge-width binding for one shadow layer.",
+      "keywords": [
+        "border",
+        "depth",
+        "edge",
+        "elevation",
+        "layer",
+        "layers",
+        "role",
+        "shadow",
+        "spread"
+      ],
+      "affects": [
+        "depth theme output",
+        "shadow footprint and perimeter",
+        "surface elevation shadows"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "perimeter",
+          "control",
+          "separator",
+          "divider"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "layer"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/depth",
+          "/depth/layers",
+          "/depth/layers/{layer}",
+          "/depth/layers/{layer}/spread"
+        ]
+      }
+    }
+  ]
+}