@vireo-ai/trellis-ui 0.1.59 → 0.1.61

package/packages/theme-engine/generated/knobs/v1/typography-fonts.json

@@ -0,0 +1,711 @@
+{
+  "version": 1,
+  "schemaVersion": 1,
+  "catalogFingerprint": "9242067137732bec",
+  "group": {
+    "id": "typography-fonts",
+    "axis": "typography",
+    "title": "Typography fonts",
+    "description": "Font resources, families, and weights."
+  },
+  "knobs": [
+    {
+      "path": "/typography/families/{family}/fallback/{fallbackIndex}",
+      "title": "Typography families fallback",
+      "description": "Binds a semantic font family to a resource and fallback stack.",
+      "keywords": [
+        "fallback",
+        "families",
+        "family",
+        "font",
+        "index",
+        "text",
+        "type",
+        "typography",
+        "weight"
+      ],
+      "affects": [
+        "font family tokens",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "tuning",
+      "impact": "family",
+      "useWhen": "Use when refining fallback behavior after the primary font family is selected.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1,
+        "maxLength": 128
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "fallbackIndex"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/families/{family}",
+          "/typography/families/{family}/fallback"
+        ]
+      }
+    },
+    {
+      "path": "/typography/families/{family}/family",
+      "title": "Typography families family",
+      "description": "Binds a semantic font family to a resource and fallback stack.",
+      "keywords": [
+        "fallback",
+        "families",
+        "family",
+        "font",
+        "text",
+        "type",
+        "typography",
+        "weight"
+      ],
+      "affects": [
+        "font family tokens",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "primary",
+      "impact": "family",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1,
+        "maxLength": 128
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/families/{family}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/families/{family}/resource",
+      "title": "Typography families resource",
+      "description": "Binds a semantic font family to a resource and fallback stack.",
+      "keywords": [
+        "fallback",
+        "families",
+        "family",
+        "font",
+        "resource",
+        "text",
+        "type",
+        "typography",
+        "weight"
+      ],
+      "affects": [
+        "font family tokens",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "primary",
+      "impact": "family",
+      "useWhen": "Use as a first-line control when establishing the theme.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "RegExp"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "family",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/families/{family}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/faces/{face}/family",
+      "title": "Typography faces family",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "face",
+        "faces",
+        "family",
+        "font",
+        "font face",
+        "resource",
+        "resources",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1,
+        "maxLength": 128
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "face"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}",
+          "/typography/resources/{resource}/faces",
+          "/typography/resources/{resource}/faces/{face}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/faces/{face}/format",
+      "title": "Typography faces format",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "face",
+        "faces",
+        "font",
+        "font face",
+        "format",
+        "resource",
+        "resources",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "woff2",
+          "woff",
+          "opentype",
+          "truetype"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "face"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}",
+          "/typography/resources/{resource}/faces",
+          "/typography/resources/{resource}/faces/{face}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/faces/{face}/src",
+      "title": "Typography faces src",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "face",
+        "faces",
+        "font",
+        "font face",
+        "resource",
+        "resources",
+        "src",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1,
+        "maxLength": 2048
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "face"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}",
+          "/typography/resources/{resource}/faces",
+          "/typography/resources/{resource}/faces/{face}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/faces/{face}/style",
+      "title": "Typography faces style",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "face",
+        "faces",
+        "font",
+        "font face",
+        "resource",
+        "resources",
+        "style",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "normal",
+          "italic",
+          "oblique"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "face"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}",
+          "/typography/resources/{resource}/faces",
+          "/typography/resources/{resource}/faces/{face}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/faces/{face}/weight/maximum",
+      "title": "Typography weight maximum",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "face",
+        "faces",
+        "font",
+        "font face",
+        "maximum",
+        "resource",
+        "resources",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer"
+        ],
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "face"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}",
+          "/typography/resources/{resource}/faces",
+          "/typography/resources/{resource}/faces/{face}",
+          "/typography/resources/{resource}/faces/{face}/weight"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/faces/{face}/weight/minimum",
+      "title": "Typography weight minimum",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "face",
+        "faces",
+        "font",
+        "font face",
+        "minimum",
+        "resource",
+        "resources",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer"
+        ],
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        {
+          "name": "face"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}",
+          "/typography/resources/{resource}/faces",
+          "/typography/resources/{resource}/faces/{face}",
+          "/typography/resources/{resource}/faces/{face}/weight"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/type",
+      "title": "Typography resources type",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "font",
+        "font face",
+        "resource",
+        "resources",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "enum": [
+          "bunny",
+          "local"
+        ]
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/resources/{resource}/url",
+      "title": "Typography resources url",
+      "description": "Declares a font resource available to generated typography.",
+      "keywords": [
+        "font",
+        "font face",
+        "resource",
+        "resources",
+        "text",
+        "type",
+        "typography",
+        "url",
+        "weight"
+      ],
+      "affects": [
+        "font loading",
+        "generated typography",
+        "typography theme output"
+      ],
+      "tier": "expert",
+      "impact": "axis",
+      "useWhen": "Use only when primary and tuning controls cannot express the required behavior.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "string"
+        ],
+        "minLength": 1,
+        "maxLength": 2048
+      },
+      "parameters": [
+        {
+          "name": "resource",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        }
+      ],
+      "patch": {
+        "operation": "add",
+        "missingParents": [
+          "/typography/resources/{resource}"
+        ]
+      }
+    },
+    {
+      "path": "/typography/weights/bold",
+      "title": "Typography weights bold",
+      "description": "Assigns a numeric font weight to a semantic weight name.",
+      "keywords": [
+        "bold",
+        "font",
+        "medium",
+        "text",
+        "type",
+        "typography",
+        "weight",
+        "weights"
+      ],
+      "affects": [
+        "generated typography",
+        "semantic font weights",
+        "typography theme output"
+      ],
+      "tier": "tuning",
+      "impact": "axis",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer"
+        ],
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "default": 700,
+      "defaultSource": "authored"
+    },
+    {
+      "path": "/typography/weights/medium",
+      "title": "Typography weights medium",
+      "description": "Assigns a numeric font weight to a semantic weight name.",
+      "keywords": [
+        "bold",
+        "font",
+        "medium",
+        "text",
+        "type",
+        "typography",
+        "weight",
+        "weights"
+      ],
+      "affects": [
+        "generated typography",
+        "semantic font weights",
+        "typography theme output"
+      ],
+      "tier": "tuning",
+      "impact": "axis",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer"
+        ],
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "default": 500,
+      "defaultSource": "authored"
+    },
+    {
+      "path": "/typography/weights/normal",
+      "title": "Typography weights normal",
+      "description": "Assigns a numeric font weight to a semantic weight name.",
+      "keywords": [
+        "bold",
+        "font",
+        "medium",
+        "normal",
+        "text",
+        "type",
+        "typography",
+        "weight",
+        "weights"
+      ],
+      "affects": [
+        "generated typography",
+        "semantic font weights",
+        "typography theme output"
+      ],
+      "tier": "tuning",
+      "impact": "axis",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer"
+        ],
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "default": 400,
+      "defaultSource": "authored"
+    },
+    {
+      "path": "/typography/weights/semibold",
+      "title": "Typography weights semibold",
+      "description": "Assigns a numeric font weight to a semantic weight name.",
+      "keywords": [
+        "bold",
+        "font",
+        "medium",
+        "semibold",
+        "text",
+        "type",
+        "typography",
+        "weight",
+        "weights"
+      ],
+      "affects": [
+        "generated typography",
+        "semantic font weights",
+        "typography theme output"
+      ],
+      "tier": "tuning",
+      "impact": "axis",
+      "useWhen": "Use to refine a specific relationship after primary controls are established.",
+      "required": false,
+      "constraints": {
+        "types": [
+          "integer"
+        ],
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "parameters": [],
+      "patch": {
+        "operation": "replace",
+        "missingParents": []
+      },
+      "default": 600,
+      "defaultSource": "authored"
+    }
+  ]
+}