@vireo-ai/trellis-ui 0.1.59 → 0.1.61

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

@@ -0,0 +1,870 @@
+{
+  "version": 1,
+  "schemaVersion": 1,
+  "catalogFingerprint": "9242067137732bec",
+  "group": {
+    "id": "surfaces",
+    "axis": "surface",
+    "title": "Surfaces",
+    "description": "Surface ladder separation and palette influence."
+  },
+  "knobs": [
+    {
+      "path": "/surface/background/accent/influence/dark/{level}",
+      "title": "Surface influence dark",
+      "description": "Controls how strongly brand accent color tints each surface level.",
+      "keywords": [
+        "accent",
+        "background",
+        "brand",
+        "contrast",
+        "dark",
+        "elevation",
+        "influence",
+        "layer",
+        "level",
+        "separation",
+        "surface",
+        "tint"
+      ],
+      "affects": [
+        "surface accent tint",
+        "surface ladder backgrounds",
+        "surface theme output"
+      ],
+      "tier": "primary",
+      "impact": "step",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/accent",
+          "/surface/background/accent/influence",
+          "/surface/background/accent/influence/dark"
+        ]
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "level": 0
+          },
+          "value": 0,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 1
+          },
+          "value": 0.002,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 2
+          },
+          "value": 0.003,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 3
+          },
+          "value": 0.005,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 4
+          },
+          "value": 0.007,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 5
+          },
+          "value": 0.009,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 6
+          },
+          "value": 0.012,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 7
+          },
+          "value": 0.015,
+          "source": "compiler"
+        }
+      ]
+    },
+    {
+      "path": "/surface/background/accent/influence/light/{level}",
+      "title": "Surface influence light",
+      "description": "Controls how strongly brand accent color tints each surface level.",
+      "keywords": [
+        "accent",
+        "background",
+        "brand",
+        "contrast",
+        "elevation",
+        "influence",
+        "layer",
+        "level",
+        "light",
+        "separation",
+        "surface",
+        "tint"
+      ],
+      "affects": [
+        "surface accent tint",
+        "surface ladder backgrounds",
+        "surface theme output"
+      ],
+      "tier": "primary",
+      "impact": "step",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/accent",
+          "/surface/background/accent/influence",
+          "/surface/background/accent/influence/light"
+        ]
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "level": 0
+          },
+          "value": 0,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 1
+          },
+          "value": 0,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 2
+          },
+          "value": 0.002,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 3
+          },
+          "value": 0.003,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 4
+          },
+          "value": 0.004,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 5
+          },
+          "value": 0.005,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 6
+          },
+          "value": 0.006,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 7
+          },
+          "value": 0.008,
+          "source": "compiler"
+        }
+      ]
+    },
+    {
+      "path": "/surface/background/accent/step",
+      "title": "Surface accent step",
+      "description": "Controls a low-level relationship in the generated surface ladder.",
+      "keywords": [
+        "accent",
+        "background",
+        "contrast",
+        "elevation",
+        "layer",
+        "separation",
+        "step",
+        "surface"
+      ],
+      "affects": [
+        "surface ladder backgrounds",
+        "surface theme output"
+      ],
+      "tier": "tuning",
+      "impact": "axis",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "enum": [
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8,
+          9,
+          10,
+          11,
+          12
+        ]
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/accent"
+        ]
+      },
+      "default": 9,
+      "defaultSource": "compiler"
+    },
+    {
+      "path": "/surface/background/neutral/influence/dark/{level}",
+      "title": "Surface influence dark",
+      "description": "Controls how strongly neutral palette color influences each surface level.",
+      "keywords": [
+        "background",
+        "chroma",
+        "contrast",
+        "dark",
+        "elevation",
+        "influence",
+        "layer",
+        "level",
+        "neutral",
+        "separation",
+        "surface"
+      ],
+      "affects": [
+        "surface ladder backgrounds",
+        "surface neutrality and separation",
+        "surface theme output"
+      ],
+      "tier": "primary",
+      "impact": "step",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/neutral",
+          "/surface/background/neutral/influence",
+          "/surface/background/neutral/influence/dark"
+        ]
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "level": 0
+          },
+          "value": 0.018,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 1
+          },
+          "value": 0.025,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 2
+          },
+          "value": 0.033,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 3
+          },
+          "value": 0.042,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 4
+          },
+          "value": 0.052,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 5
+          },
+          "value": 0.064,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 6
+          },
+          "value": 0.078,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 7
+          },
+          "value": 0.094,
+          "source": "compiler"
+        }
+      ]
+    },
+    {
+      "path": "/surface/background/neutral/influence/light/{level}",
+      "title": "Surface influence light",
+      "description": "Controls how strongly neutral palette color influences each surface level.",
+      "keywords": [
+        "background",
+        "chroma",
+        "contrast",
+        "elevation",
+        "influence",
+        "layer",
+        "level",
+        "light",
+        "neutral",
+        "separation",
+        "surface"
+      ],
+      "affects": [
+        "surface ladder backgrounds",
+        "surface neutrality and separation",
+        "surface theme output"
+      ],
+      "tier": "primary",
+      "impact": "step",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": 0,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/neutral",
+          "/surface/background/neutral/influence",
+          "/surface/background/neutral/influence/light"
+        ]
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "level": 0
+          },
+          "value": 0.012,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 1
+          },
+          "value": 0.018,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 2
+          },
+          "value": 0.024,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 3
+          },
+          "value": 0.032,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 4
+          },
+          "value": 0.04,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 5
+          },
+          "value": 0.05,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 6
+          },
+          "value": 0.06,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 7
+          },
+          "value": 0.072,
+          "source": "compiler"
+        }
+      ]
+    },
+    {
+      "path": "/surface/background/neutral/step",
+      "title": "Surface neutral step",
+      "description": "Controls a low-level relationship in the generated surface ladder.",
+      "keywords": [
+        "background",
+        "contrast",
+        "elevation",
+        "layer",
+        "neutral",
+        "separation",
+        "step",
+        "surface"
+      ],
+      "affects": [
+        "surface ladder backgrounds",
+        "surface theme output"
+      ],
+      "tier": "tuning",
+      "impact": "axis",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "enum": [
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8,
+          9,
+          10,
+          11,
+          12
+        ]
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/neutral"
+        ]
+      },
+      "default": 9,
+      "defaultSource": "compiler"
+    },
+    {
+      "path": "/surface/background/plateau/light",
+      "title": "Surface plateau light",
+      "description": "Optionally holds early light surface levels at the same background before elevation begins.",
+      "keywords": [
+        "background",
+        "contrast",
+        "elevation",
+        "flat",
+        "layer",
+        "light",
+        "low separation",
+        "plateau",
+        "separation",
+        "surface"
+      ],
+      "affects": [
+        "early surface levels",
+        "surface ladder backgrounds",
+        "surface theme output"
+      ],
+      "tier": "tuning",
+      "impact": "appearance",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer",
+          "null"
+        ],
+        "minimum": 1,
+        "maximum": 8
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/plateau"
+        ]
+      },
+      "default": 2,
+      "defaultSource": "compiler"
+    },
+    {
+      "path": "/surface/background/toneOffset/dark/{level}",
+      "title": "Surface tone offset dark",
+      "description": "Controls canvas-relative tonal separation at each surface level.",
+      "keywords": [
+        "background",
+        "contrast",
+        "dark",
+        "elevation",
+        "layer",
+        "level",
+        "offset",
+        "separation",
+        "surface",
+        "tone"
+      ],
+      "affects": [
+        "surface ladder backgrounds",
+        "surface level backgrounds",
+        "surface theme output"
+      ],
+      "tier": "primary",
+      "impact": "step",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -1,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/toneOffset",
+          "/surface/background/toneOffset/dark"
+        ]
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "level": 0
+          },
+          "value": 0.025,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 1
+          },
+          "value": 0.05,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 2
+          },
+          "value": 0.078,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 3
+          },
+          "value": 0.108,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 4
+          },
+          "value": 0.14,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 5
+          },
+          "value": 0.174,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 6
+          },
+          "value": 0.21,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 7
+          },
+          "value": 0.248,
+          "source": "compiler"
+        }
+      ]
+    },
+    {
+      "path": "/surface/background/toneOffset/light/{level}",
+      "title": "Surface tone offset light",
+      "description": "Controls canvas-relative tonal separation at each surface level.",
+      "keywords": [
+        "background",
+        "contrast",
+        "elevation",
+        "layer",
+        "level",
+        "light",
+        "offset",
+        "separation",
+        "surface",
+        "tone"
+      ],
+      "affects": [
+        "surface ladder backgrounds",
+        "surface level backgrounds",
+        "surface theme output"
+      ],
+      "tier": "primary",
+      "impact": "step",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "minimum": -1,
+        "maximum": 1
+      },
+      "parameters": [
+        {
+          "name": "level",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/surface",
+          "/surface/background",
+          "/surface/background/toneOffset",
+          "/surface/background/toneOffset/light"
+        ]
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "level": 0
+          },
+          "value": 0.006,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 1
+          },
+          "value": 0.012,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 2
+          },
+          "value": 0.019,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 3
+          },
+          "value": 0.027,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 4
+          },
+          "value": 0.036,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 5
+          },
+          "value": 0.046,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 6
+          },
+          "value": 0.057,
+          "source": "compiler"
+        },
+        {
+          "bindings": {
+            "level": 7
+          },
+          "value": 0.069,
+          "source": "compiler"
+        }
+      ]
+    }
+  ]
+}