@valancex/style 0.0.0-stage → 0.14.0

package/schema/dtcg-2025.10/format/values/fontFamily.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/fontFamily.json",
+  "title": "Font Family Value",
+  "description": "Value schema for fontFamily type tokens. Represents a font name or an array of font names (ordered from most to least preferred).",
+  "oneOf": [
+    {
+      "type": "string",
+      "description": "A single font name",
+      "not": {
+        "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/curlyBraceReference"
+      }
+    },
+    {
+      "type": "array",
+      "description": "An array of font names, ordered from most to least preferred",
+      "items": {
+        "oneOf": [
+          {
+            "type": "string",
+            "not": {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/curlyBraceReference"
+            }
+          },
+          {
+            "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/jsonPointerReferenceObject"
+          }
+        ]
+      },
+      "minItems": 1
+    }
+  ]
+}

package/schema/dtcg-2025.10/format/values/fontWeight.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/fontWeight.json",
+  "title": "Font Weight Value",
+  "description": "Value schema for fontWeight type tokens. Represents a font weight as per the OpenType wght tag specification. Lower numbers represent lighter weights, higher numbers represent thicker weights.",
+  "oneOf": [
+    {
+      "type": "number",
+      "description": "Numeric font weight value",
+      "minimum": 1,
+      "maximum": 1000
+    },
+    {
+      "type": "string",
+      "description": "Pre-defined font weight string value",
+      "enum": [
+        "thin",
+        "hairline",
+        "extra-light",
+        "ultra-light",
+        "light",
+        "normal",
+        "regular",
+        "book",
+        "medium",
+        "semi-bold",
+        "demi-bold",
+        "bold",
+        "extra-bold",
+        "ultra-bold",
+        "black",
+        "heavy",
+        "extra-black",
+        "ultra-black"
+      ]
+    }
+  ]
+}

package/schema/dtcg-2025.10/format/values/gradient.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/gradient.json",
+  "title": "Gradient Value",
+  "description": "Value schema for gradient type tokens. Represents a color gradient.",
+  "type": "array",
+  "items": {
+    "oneOf": [
+      {
+        "$ref": "#/definitions/gradientStop"
+      },
+      {
+        "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+      }
+    ]
+  },
+  "minItems": 1,
+  "definitions": {
+    "gradientStop": {
+      "title": "Gradient Stop",
+      "type": "object",
+      "properties": {
+        "color": {
+          "description": "The color value at the stop's position on the gradient",
+          "oneOf": [
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/color.json"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "position": {
+          "description": "The position of the stop along the gradient's axis (range [0, 1]). Values outside this range are clamped.",
+          "oneOf": [
+            {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        }
+      },
+      "required": ["color", "position"],
+      "additionalProperties": false
+    }
+  }
+}

package/schema/dtcg-2025.10/format/values/number.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/number.json",
+  "title": "Number Value",
+  "description": "Value schema for number type tokens. Numbers can be positive, negative and have fractions. Example uses are gradient stop positions or unitless line heights.",
+  "type": "number"
+}

package/schema/dtcg-2025.10/format/values/shadow.json

@@ -0,0 +1,102 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/shadow.json",
+  "title": "Shadow Value",
+  "description": "Value schema for shadow type tokens. Represents a shadow style.",
+  "oneOf": [
+    {
+      "$ref": "#/definitions/shadowObject"
+    },
+    {
+      "type": "array",
+      "description": "Array of shadow objects and/or references to shadow tokens",
+      "items": {
+        "oneOf": [
+          {
+            "$ref": "#/definitions/shadowObject"
+          },
+          {
+            "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+          }
+        ]
+      },
+      "minItems": 1
+    }
+  ],
+  "definitions": {
+    "shadowObject": {
+      "title": "Shadow Object",
+      "type": "object",
+      "properties": {
+        "color": {
+          "description": "The color of the shadow",
+          "oneOf": [
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/color.json"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "offsetX": {
+          "description": "The horizontal offset that shadow has from the element it is applied to",
+          "oneOf": [
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "offsetY": {
+          "description": "The vertical offset that shadow has from the element it is applied to",
+          "oneOf": [
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "blur": {
+          "description": "The blur radius that is applied to the shadow",
+          "oneOf": [
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "spread": {
+          "description": "The amount by which to expand or contract the shadow",
+          "oneOf": [
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "inset": {
+          "description": "Whether this shadow is inside the containing shape (inner shadow) rather than a drop shadow (default: false)",
+          "oneOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/jsonPointerReferenceObject"
+            }
+          ]
+        }
+      },
+      "required": ["color", "offsetX", "offsetY", "blur", "spread"],
+      "additionalProperties": false
+    }
+  }
+}

package/schema/dtcg-2025.10/format/values/strokeStyle.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/strokeStyle.json",
+  "title": "Stroke Style Value",
+  "description": "Value schema for strokeStyle type tokens. Represents the style applied to lines or borders.",
+  "oneOf": [
+    {
+      "type": "string",
+      "enum": [
+        "solid",
+        "dashed",
+        "dotted",
+        "double",
+        "groove",
+        "ridge",
+        "outset",
+        "inset"
+      ],
+      "description": "Pre-defined stroke style values with the same meaning as CSS line style values"
+    },
+    {
+      "type": "object",
+      "properties": {
+        "dashArray": {
+          "description": "Array of dimension values specifying lengths of alternating dashes and gaps",
+          "oneOf": [
+            {
+              "type": "array",
+              "items": {
+                "oneOf": [
+                  {
+                    "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+                  },
+                  {
+                    "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+                  }
+                ]
+              },
+              "minItems": 1
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/jsonPointerReferenceObject"
+            }
+          ]
+        },
+        "lineCap": {
+          "description": "Line cap style, same meaning as SVG stroke-linecap attribute",
+          "oneOf": [
+            {
+              "type": "string",
+              "enum": ["round", "butt", "square"]
+            },
+            {
+              "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/jsonPointerReferenceObject"
+            }
+          ]
+        }
+      },
+      "required": ["dashArray", "lineCap"],
+      "additionalProperties": false
+    }
+  ]
+}

package/schema/dtcg-2025.10/format/values/transition.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/transition.json",
+  "title": "Transition Value",
+  "description": "Value schema for transition type tokens. Represents an animated transition between two states.",
+  "type": "object",
+  "properties": {
+    "duration": {
+      "description": "The duration of the transition",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/duration.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "delay": {
+      "description": "The time to wait before the transition begins",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/duration.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "timingFunction": {
+      "description": "The timing function of the transition",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/cubicBezier.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    }
+  },
+  "required": ["duration", "delay", "timingFunction"],
+  "additionalProperties": false
+}

package/schema/dtcg-2025.10/format/values/typography.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/typography.json",
+  "title": "Typography Value",
+  "description": "Value schema for typography type tokens. Represents a typographic style.",
+  "type": "object",
+  "properties": {
+    "fontFamily": {
+      "description": "The typography's font",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/fontFamily.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "fontSize": {
+      "description": "The size of the typography",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "fontWeight": {
+      "description": "The weight of the typography",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/fontWeight.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "letterSpacing": {
+      "description": "The horizontal spacing between characters",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/dimension.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "lineHeight": {
+      "description": "The vertical spacing between lines of typography (interpreted as a multiplier of fontSize)",
+      "oneOf": [
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format/values/number.json"
+        },
+        {
+          "$ref": "https://www.designtokens.org/schemas/2025.10/format.json#/definitions/tokenValueReference"
+        }
+      ]
+    }
+  },
+  "required": [
+    "fontFamily",
+    "fontSize",
+    "fontWeight",
+    "letterSpacing",
+    "lineHeight"
+  ],
+  "additionalProperties": false
+}

package/schema/dtcg-2025.10/format.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format.json",
+  "title": "DTCG Format Schema",
+  "description": "JSON Schema for the Design Tokens Community Group (DTCG) Format specification.",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "format": "uri-reference",
+      "description": "URI reference to this JSON schema.",
+      "$comment": "$schema is not part of the official DTCG specification."
+    },
+    "$type": {
+      "$ref": "https://www.designtokens.org/schemas/2025.10/format/tokenType.json",
+      "description": "The type for tokens in this group (inherited by nested tokens unless overridden)"
+    },
+    "$description": {
+      "type": "string",
+      "description": "A plain text description of the group"
+    },
+    "$extensions": {
+      "type": "object",
+      "description": "Vendor-specific extensions"
+    },
+    "$extends": {
+      "oneOf": [
+        {
+          "$ref": "#/definitions/curlyBraceReference"
+        },
+        {
+          "$ref": "#/definitions/jsonPointerReference"
+        }
+      ],
+      "description": "Reference to another group to inherit tokens and properties from"
+    },
+    "$deprecated": {
+      "oneOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string"
+        }
+      ],
+      "description": "Whether this group is deprecated"
+    },
+    "$root": {
+      "description": "Root token for this group. The $root token provides a base value for the group while allowing for variants or extensions.",
+      "$ref": "https://www.designtokens.org/schemas/2025.10/format/token.json"
+    }
+  },
+  "patternProperties": {
+    "^[^${}.][^{}.]*$": {
+      "description": "Nested groups and tokens (see #/definitions/tokenOrGroupName for pattern definition)",
+      "$ref": "https://www.designtokens.org/schemas/2025.10/format/groupOrToken.json"
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "tokenOrGroupName": {
+      "title": "Token or Group Name",
+      "type": "string",
+      "pattern": "^[^${}.][^{}.]*$",
+      "description": "Valid token/group names: must not start with $ and must not contain {, }, or ."
+    },
+    "curlyBraceReference": {
+      "title": "Curly Brace Reference",
+      "type": "string",
+      "pattern": "^\\{[^${}.][^{}.]*(\\.[^${}.][^{}.]*)*\\}$",
+      "description": "Curly brace reference (e.g., '{tokenName}' or '{group.nested.token}')"
+    },
+    "jsonPointerReference": {
+      "title": "JSON Pointer Reference",
+      "type": "string",
+      "pattern": "^#/",
+      "format": "json-pointer-uri-fragment",
+      "description": "JSON Pointer reference (RFC 6901) to a location in the document (e.g., '#/path/to/target')"
+    },
+    "jsonPointerReferenceObject": {
+      "title": "JSON Pointer Reference Object",
+      "type": "object",
+      "properties": {
+        "$ref": {
+          "$ref": "#/definitions/jsonPointerReference"
+        }
+      },
+      "required": ["$ref"],
+      "additionalProperties": false,
+      "description": "Object containing a JSON Pointer reference for property-level references"
+    },
+    "tokenValueReference": {
+      "title": "Token Value Reference",
+      "oneOf": [
+        {
+          "$ref": "#/definitions/curlyBraceReference"
+        },
+        {
+          "$ref": "#/definitions/jsonPointerReferenceObject"
+        }
+      ],
+      "description": "A reference to a token value using either curly brace syntax or JSON Pointer syntax"
+    }
+  }
+}

package/schema/recipe-v1.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://valancex.dev/schema/recipe-v1.json",
+  "title": "A recipe (recipe-v1): the style of one part of one primitive, as data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "target"],
+  "properties": {
+    "version": { "const": 1 },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["primitive", "part"],
+      "properties": { "primitive": { "type": "string", "pattern": "^[a-z][a-z0-9]*$" }, "part": { "type": "string" } }
+    },
+    "base": { "$ref": "#/definitions/declarations" },
+    "variants": { "type": "object", "additionalProperties": { "type": "object", "additionalProperties": { "$ref": "#/definitions/declarations" } } },
+    "states": { "type": "object", "additionalProperties": { "$ref": "#/definitions/declarations" } },
+    "when": { "type": "object", "propertyNames": { "pattern": "^[a-z-]+:[a-z-]+$" }, "additionalProperties": { "$ref": "#/definitions/declarations" } },
+    "escape": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "web": { "type": "object", "additionalProperties": false, "required": ["css"], "properties": { "css": { "type": "string", "minLength": 1 } } }
+      }
+    }
+  },
+  "definitions": {
+    "declarations": { "type": "object", "additionalProperties": { "$ref": "#/definitions/value" } },
+    "value": {
+      "oneOf": [
+        { "type": "string" },
+        { "type": "number" },
+        { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 4 },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": { "width": { "type": "string" }, "color": { "type": "string" }, "style": { "enum": ["solid", "dashed", "dotted"] }, "offset": { "type": "string" } }
+        }
+      ]
+    }
+  }
+}