@vireo-ai/trellis-ui 0.1.60 → 0.1.62

package/packages/theme-engine/generated/knobs/v1/color-foundations.json

@@ -0,0 +1,1582 @@
+{
+  "version": 1,
+  "schemaVersion": 1,
+  "catalogFingerprint": "db4b2840ff19cd0b",
+  "group": {
+    "id": "color-foundations",
+    "axis": "color",
+    "title": "Color foundations",
+    "description": "Canvases, palette sources, and appearance overrides."
+  },
+  "knobs": [
+    {
+      "path": "/color/appearances/{appearance}/canvas",
+      "title": "Color appearances canvas",
+      "description": "Sets the base canvas color for one appearance.",
+      "keywords": [
+        "appearance",
+        "appearances",
+        "background",
+        "brand",
+        "canvas",
+        "color",
+        "contrast",
+        "dark",
+        "ink",
+        "light",
+        "palette"
+      ],
+      "affects": [
+        "canvas and every canvas-relative color",
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "primary",
+      "impact": "appearance",
+      "useWhen": "Use early when establishing the light or dark foundation of the theme.",
+      "required": true,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "appearance",
+          "values": [
+            "light",
+            "dark"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "appearance": "light"
+          },
+          "value": "#fafafa",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "appearance": "dark"
+          },
+          "value": "#171717",
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/appearances/{appearance}/families/{family}/source/anchor",
+      "title": "Color source anchor",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "anchor",
+        "appearance",
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "palette",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "expert",
+      "impact": "appearance",
+      "useWhen": "Use for a deliberate appearance-specific family override after the shared family is correct.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "enum": [
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8,
+          9,
+          10,
+          11,
+          12
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^(?:neutral|accent|(?:status|supporting|named)\\.[a-z][a-z0-9-]*)$"
+        },
+        {
+          "name": "appearance",
+          "values": [
+            "light",
+            "dark"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/appearances/{appearance}",
+          "/color/appearances/{appearance}/families",
+          "/color/appearances/{appearance}/families/{family}",
+          "/color/appearances/{appearance}/families/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/appearances/{appearance}/families/{family}/source/color",
+      "title": "Color families source",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearance",
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "palette",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "expert",
+      "impact": "appearance",
+      "useWhen": "Use for a deliberate appearance-specific family override after the shared family is correct.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^(?:neutral|accent|(?:status|supporting|named)\\.[a-z][a-z0-9-]*)$"
+        },
+        {
+          "name": "appearance",
+          "values": [
+            "light",
+            "dark"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/appearances/{appearance}",
+          "/color/appearances/{appearance}/families",
+          "/color/appearances/{appearance}/families/{family}",
+          "/color/appearances/{appearance}/families/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/appearances/{appearance}/families/{family}/source/kind",
+      "title": "Color source kind",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearance",
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "kind",
+        "palette",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "appearance",
+      "useWhen": "Change to steps only when supplying a complete exact palette for both appearances.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "seed"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^(?:neutral|accent|(?:status|supporting|named)\\.[a-z][a-z0-9-]*)$"
+        },
+        {
+          "name": "appearance",
+          "values": [
+            "light",
+            "dark"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/appearances/{appearance}",
+          "/color/appearances/{appearance}/families",
+          "/color/appearances/{appearance}/families/{family}",
+          "/color/appearances/{appearance}/families/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/{family}/source/anchor",
+      "title": "Color source anchor",
+      "description": "Selects which generated ramp step must remain closest to the seed color.",
+      "keywords": [
+        "anchor",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "palette",
+        "ramp",
+        "seed",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "family ramp distribution",
+        "generated color families and semantic colors"
+      ],
+      "tier": "tuning",
+      "impact": "family",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": true,
+      "constraints": {
+        "types": [
+          "number"
+        ],
+        "enum": [
+          1,
+          2,
+          3,
+          4,
+          5,
+          6,
+          7,
+          8,
+          9,
+          10,
+          11,
+          12
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "values": [
+            "neutral",
+            "accent"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "family": "neutral"
+          },
+          "value": 9,
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "family": "accent"
+          },
+          "value": 9,
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/families/{family}/source/appearances/dark/{index}",
+      "title": "Color appearances dark",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "dark",
+        "exact",
+        "explicit",
+        "families",
+        "family",
+        "index",
+        "ink",
+        "palette",
+        "source",
+        "steps"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": true,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        },
+        {
+          "name": "family",
+          "values": [
+            "neutral",
+            "accent"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/{family}",
+          "/color/families/{family}/source",
+          "/color/families/{family}/source/appearances",
+          "/color/families/{family}/source/appearances/dark"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/{family}/source/appearances/light/{index}",
+      "title": "Color appearances light",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "exact",
+        "explicit",
+        "families",
+        "family",
+        "index",
+        "ink",
+        "light",
+        "palette",
+        "source",
+        "steps"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": true,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        },
+        {
+          "name": "family",
+          "values": [
+            "neutral",
+            "accent"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/{family}",
+          "/color/families/{family}/source",
+          "/color/families/{family}/source/appearances",
+          "/color/families/{family}/source/appearances/light"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/{family}/source/color",
+      "title": "Color families source",
+      "description": "Sets the seed color from which a functional family is generated.",
+      "keywords": [
+        "accent",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "neutral",
+        "palette",
+        "seed",
+        "source",
+        "status"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors",
+        "the complete 12-step family ramp"
+      ],
+      "tier": "primary",
+      "impact": "family",
+      "useWhen": "Use first when changing a brand, neutral, supporting, or status palette.",
+      "required": true,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "values": [
+            "neutral",
+            "accent"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "family": "neutral"
+          },
+          "value": "#737373",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "family": "accent"
+          },
+          "value": "#0090ff",
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/families/{family}/source/kind",
+      "title": "Color source kind",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "kind",
+        "palette",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "family",
+      "useWhen": "Change to steps only when supplying a complete exact palette for both appearances.",
+      "required": true,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "seed",
+          "steps"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "values": [
+            "neutral",
+            "accent"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "family": "neutral"
+          },
+          "value": "seed",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "family": "accent"
+          },
+          "value": "seed",
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/families/named/{family}/source/anchor",
+      "title": "Color source anchor",
+      "description": "Selects which generated ramp step must remain closest to the seed color.",
+      "keywords": [
+        "anchor",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "named",
+        "palette",
+        "ramp",
+        "seed",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "family ramp distribution",
+        "generated color families and semantic colors"
+      ],
+      "tier": "tuning",
+      "impact": "family",
+      "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": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/named",
+          "/color/families/named/{family}",
+          "/color/families/named/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/named/{family}/source/appearances/dark/{index}",
+      "title": "Color appearances dark",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "dark",
+        "exact",
+        "explicit",
+        "families",
+        "family",
+        "index",
+        "ink",
+        "named",
+        "palette",
+        "source",
+        "steps"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/named",
+          "/color/families/named/{family}",
+          "/color/families/named/{family}/source",
+          "/color/families/named/{family}/source/appearances",
+          "/color/families/named/{family}/source/appearances/dark"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/named/{family}/source/appearances/light/{index}",
+      "title": "Color appearances light",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "exact",
+        "explicit",
+        "families",
+        "family",
+        "index",
+        "ink",
+        "light",
+        "named",
+        "palette",
+        "source",
+        "steps"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/named",
+          "/color/families/named/{family}",
+          "/color/families/named/{family}/source",
+          "/color/families/named/{family}/source/appearances",
+          "/color/families/named/{family}/source/appearances/light"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/named/{family}/source/color",
+      "title": "Color named source",
+      "description": "Sets the seed color from which a functional family is generated.",
+      "keywords": [
+        "accent",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "named",
+        "neutral",
+        "palette",
+        "seed",
+        "source",
+        "status"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors",
+        "the complete 12-step family ramp"
+      ],
+      "tier": "primary",
+      "impact": "family",
+      "useWhen": "Use first when changing a brand, neutral, supporting, or status palette.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/named",
+          "/color/families/named/{family}",
+          "/color/families/named/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/named/{family}/source/kind",
+      "title": "Color source kind",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "kind",
+        "named",
+        "palette",
+        "source"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "family",
+      "useWhen": "Change to steps only when supplying a complete exact palette for both appearances.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "seed",
+          "steps"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/named",
+          "/color/families/named/{family}",
+          "/color/families/named/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/status/{status}/source/anchor",
+      "title": "Color source anchor",
+      "description": "Selects which generated ramp step must remain closest to the seed color.",
+      "keywords": [
+        "anchor",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "ink",
+        "palette",
+        "ramp",
+        "seed",
+        "source",
+        "status"
+      ],
+      "affects": [
+        "color theme output",
+        "family ramp distribution",
+        "generated color families and semantic colors"
+      ],
+      "tier": "tuning",
+      "impact": "family",
+      "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": [
+        {
+          "name": "status",
+          "values": [
+            "success",
+            "warning",
+            "danger",
+            "information"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "status": "success"
+          },
+          "value": 9,
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "warning"
+          },
+          "value": 9,
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "danger"
+          },
+          "value": 9,
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "information"
+          },
+          "value": 9,
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/families/status/{status}/source/appearances/dark/{index}",
+      "title": "Color appearances dark",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "dark",
+        "exact",
+        "explicit",
+        "families",
+        "index",
+        "ink",
+        "palette",
+        "source",
+        "status",
+        "steps"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        },
+        {
+          "name": "status",
+          "values": [
+            "success",
+            "warning",
+            "danger",
+            "information"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/status/{status}",
+          "/color/families/status/{status}/source",
+          "/color/families/status/{status}/source/appearances",
+          "/color/families/status/{status}/source/appearances/dark"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/status/{status}/source/appearances/light/{index}",
+      "title": "Color appearances light",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "exact",
+        "explicit",
+        "families",
+        "index",
+        "ink",
+        "light",
+        "palette",
+        "source",
+        "status",
+        "steps"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        },
+        {
+          "name": "status",
+          "values": [
+            "success",
+            "warning",
+            "danger",
+            "information"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/status/{status}",
+          "/color/families/status/{status}/source",
+          "/color/families/status/{status}/source/appearances",
+          "/color/families/status/{status}/source/appearances/light"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/status/{status}/source/color",
+      "title": "Color status source",
+      "description": "Sets the seed color from which a functional family is generated.",
+      "keywords": [
+        "accent",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "ink",
+        "neutral",
+        "palette",
+        "seed",
+        "source",
+        "status"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors",
+        "the complete 12-step family ramp"
+      ],
+      "tier": "primary",
+      "impact": "family",
+      "useWhen": "Use first when changing a brand, neutral, supporting, or status palette.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "status",
+          "values": [
+            "success",
+            "warning",
+            "danger",
+            "information"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "status": "success"
+          },
+          "value": "#30a46c",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "warning"
+          },
+          "value": "#ffc53d",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "danger"
+          },
+          "value": "#e5484d",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "information"
+          },
+          "value": "#0090ff",
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/families/status/{status}/source/kind",
+      "title": "Color source kind",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "ink",
+        "kind",
+        "palette",
+        "source",
+        "status"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "family",
+      "useWhen": "Change to steps only when supplying a complete exact palette for both appearances.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "seed",
+          "steps"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "status",
+          "values": [
+            "success",
+            "warning",
+            "danger",
+            "information"
+          ]
+        }
+      ],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "defaults": [
+        {
+          "bindings": {
+            "status": "success"
+          },
+          "value": "seed",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "warning"
+          },
+          "value": "seed",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "danger"
+          },
+          "value": "seed",
+          "source": "authored"
+        },
+        {
+          "bindings": {
+            "status": "information"
+          },
+          "value": "seed",
+          "source": "authored"
+        }
+      ]
+    },
+    {
+      "path": "/color/families/supporting/{family}/source/anchor",
+      "title": "Color source anchor",
+      "description": "Selects which generated ramp step must remain closest to the seed color.",
+      "keywords": [
+        "anchor",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "palette",
+        "ramp",
+        "seed",
+        "source",
+        "supporting"
+      ],
+      "affects": [
+        "color theme output",
+        "family ramp distribution",
+        "generated color families and semantic colors"
+      ],
+      "tier": "tuning",
+      "impact": "family",
+      "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": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/supporting",
+          "/color/families/supporting/{family}",
+          "/color/families/supporting/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/supporting/{family}/source/appearances/dark/{index}",
+      "title": "Color appearances dark",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "dark",
+        "exact",
+        "explicit",
+        "families",
+        "family",
+        "index",
+        "ink",
+        "palette",
+        "source",
+        "steps",
+        "supporting"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/supporting",
+          "/color/families/supporting/{family}",
+          "/color/families/supporting/{family}/source",
+          "/color/families/supporting/{family}/source/appearances",
+          "/color/families/supporting/{family}/source/appearances/dark"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/supporting/{family}/source/appearances/light/{index}",
+      "title": "Color appearances light",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "appearances",
+        "brand",
+        "color",
+        "contrast",
+        "exact",
+        "explicit",
+        "families",
+        "family",
+        "index",
+        "ink",
+        "light",
+        "palette",
+        "source",
+        "steps",
+        "supporting"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "step",
+      "useWhen": "Use only when importing or preserving an exact 12-step palette that the generator must not derive.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "index",
+          "values": [
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11
+          ],
+          "displayOffset": 1
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/supporting",
+          "/color/families/supporting/{family}",
+          "/color/families/supporting/{family}/source",
+          "/color/families/supporting/{family}/source/appearances",
+          "/color/families/supporting/{family}/source/appearances/light"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/supporting/{family}/source/color",
+      "title": "Color supporting source",
+      "description": "Sets the seed color from which a functional family is generated.",
+      "keywords": [
+        "accent",
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "neutral",
+        "palette",
+        "seed",
+        "source",
+        "status",
+        "supporting"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors",
+        "the complete 12-step family ramp"
+      ],
+      "tier": "primary",
+      "impact": "family",
+      "useWhen": "Use first when changing a brand, neutral, supporting, or status palette.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/supporting",
+          "/color/families/supporting/{family}",
+          "/color/families/supporting/{family}/source"
+        ]
+      }
+    },
+    {
+      "path": "/color/families/supporting/{family}/source/kind",
+      "title": "Color source kind",
+      "description": "Controls a low-level relationship in generated palettes and appearance-aware colors.",
+      "keywords": [
+        "brand",
+        "color",
+        "contrast",
+        "families",
+        "family",
+        "ink",
+        "kind",
+        "palette",
+        "source",
+        "supporting"
+      ],
+      "affects": [
+        "color theme output",
+        "generated color families and semantic colors"
+      ],
+      "tier": "escape-hatch",
+      "impact": "family",
+      "useWhen": "Change to steps only when supplying a complete exact palette for both appearances.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "seed",
+          "steps"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/color/families/supporting",
+          "/color/families/supporting/{family}",
+          "/color/families/supporting/{family}/source"
+        ]
+      }
+    }
+  ]
+}