@design-token-kit/core 0.1.1

package/lib/schemas/2025.10/format/values/fontWeight.json

@@ -0,0 +1,39 @@
+{
+  "$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/lib/schemas/2025.10/format/values/gradient.json

@@ -0,0 +1,53 @@
+{
+  "$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": "../../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": "color.json"
+            },
+            {
+              "$ref": "../../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": "../../format.json#/definitions/tokenValueReference"
+            }
+          ]
+        }
+      },
+      "required": ["color", "position"],
+      "additionalProperties": false
+    }
+  }
+}
+

package/lib/schemas/2025.10/format/values/number.json

@@ -0,0 +1,8 @@
+{
+  "$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/lib/schemas/2025.10/format/values/shadow.json

@@ -0,0 +1,103 @@
+{
+  "$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": "../../format.json#/definitions/tokenValueReference"
+          }
+        ]
+      },
+      "minItems": 1
+    }
+  ],
+  "definitions": {
+    "shadowObject": {
+      "title": "Shadow Object",
+      "type": "object",
+      "properties": {
+        "color": {
+          "description": "The color of the shadow",
+          "oneOf": [
+            {
+              "$ref": "color.json"
+            },
+            {
+              "$ref": "../../format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "offsetX": {
+          "description": "The horizontal offset that shadow has from the element it is applied to",
+          "oneOf": [
+            {
+              "$ref": "dimension.json"
+            },
+            {
+              "$ref": "../../format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "offsetY": {
+          "description": "The vertical offset that shadow has from the element it is applied to",
+          "oneOf": [
+            {
+              "$ref": "dimension.json"
+            },
+            {
+              "$ref": "../../format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "blur": {
+          "description": "The blur radius that is applied to the shadow",
+          "oneOf": [
+            {
+              "$ref": "dimension.json"
+            },
+            {
+              "$ref": "../../format.json#/definitions/tokenValueReference"
+            }
+          ]
+        },
+        "spread": {
+          "description": "The amount by which to expand or contract the shadow",
+          "oneOf": [
+            {
+              "$ref": "dimension.json"
+            },
+            {
+              "$ref": "../../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": "../../format.json#/definitions/jsonPointerReferenceObject"
+            }
+          ]
+        }
+      },
+      "required": ["color", "offsetX", "offsetY", "blur", "spread"],
+      "additionalProperties": false
+    }
+  }
+}
+

package/lib/schemas/2025.10/format/values/strokeStyle.json

@@ -0,0 +1,64 @@
+{
+  "$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": "dimension.json"
+                  },
+                  {
+                    "$ref": "../../format.json#/definitions/tokenValueReference"
+                  }
+                ]
+              },
+              "minItems": 1
+            },
+            {
+              "$ref": "../../format.json#/definitions/jsonPointerReferenceObject"
+            }
+          ]
+        },
+        "lineCap": {
+          "description": "Line cap style, same meaning as SVG stroke-linecap attribute",
+          "oneOf": [
+            {
+              "type": "string",
+              "enum": ["round", "butt", "square"]
+            },
+            {
+              "$ref": "../../format.json#/definitions/jsonPointerReferenceObject"
+            }
+          ]
+        }
+      },
+      "required": ["dashArray", "lineCap"],
+      "additionalProperties": false
+    }
+  ]
+}
+

package/lib/schemas/2025.10/format/values/transition.json

@@ -0,0 +1,45 @@
+{
+  "$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": "duration.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "delay": {
+      "description": "The time to wait before the transition begins",
+      "oneOf": [
+        {
+          "$ref": "duration.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "timingFunction": {
+      "description": "The timing function of the transition",
+      "oneOf": [
+        {
+          "$ref": "cubicBezier.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    }
+  },
+  "required": ["duration", "delay", "timingFunction"],
+  "additionalProperties": false
+}
+

package/lib/schemas/2025.10/format/values/typography.json

@@ -0,0 +1,73 @@
+{
+  "$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": "fontFamily.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "fontSize": {
+      "description": "The size of the typography",
+      "oneOf": [
+        {
+          "$ref": "dimension.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "fontWeight": {
+      "description": "The weight of the typography",
+      "oneOf": [
+        {
+          "$ref": "fontWeight.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "letterSpacing": {
+      "description": "The horizontal spacing between characters",
+      "oneOf": [
+        {
+          "$ref": "dimension.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "lineHeight": {
+      "description": "The vertical spacing between lines of typography (interpreted as a multiplier of fontSize)",
+      "oneOf": [
+        {
+          "$ref": "number.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    }
+  },
+  "required": [
+    "fontFamily",
+    "fontSize",
+    "fontWeight",
+    "letterSpacing",
+    "lineHeight"
+  ],
+  "additionalProperties": false
+}
+

package/lib/schemas/2025.10/format.json

@@ -0,0 +1,106 @@
+{
+  "$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": "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": "format/token.json"
+    }
+  },
+  "patternProperties": {
+    "^[^${}.][^{}.]*$": {
+      "description": "Nested groups and tokens (see #/definitions/tokenOrGroupName for pattern definition)",
+      "$ref": "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/lib/schemas/2025.10/resolver/modifier.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/resolver/modifier.json",
+  "title": "Modifier",
+  "description": "A modifier is similar to a set, but allows for conditional inclusion via the contexts map. A modifier MUST declare a contexts map of string values to arrays of token sources.",
+  "type": "object",
+  "required": ["contexts"],
+  "additionalProperties": false,
+  "properties": {
+    "description": {
+      "title": "Description",
+      "type": "string",
+      "description": "A human-readable description of the purpose of the modifier."
+    },
+    "contexts": {
+      "title": "Contexts",
+      "type": "object",
+      "description": "A map of context names to arrays of token sources. Each context represents a possible variant (e.g., 'light' vs 'dark' for theme, 'small' vs 'large' for size).",
+      "minProperties": 2,
+      "patternProperties": {
+        "^.+$": {
+          "$ref": "#/definitions/tokenSourcesForModifiers",
+          "description": "An array of token sources for this context. Can contain reference objects pointing to JSON files, inline token definitions, or any combination. If the array declares multiple sources, they will be merged in array order, meaning if a token is declared multiple times, the last occurrence in the array will be the final value."
+        }
+      },
+      "additionalProperties": false
+    },
+    "default": {
+      "title": "Default Context",
+      "type": "string",
+      "description": "An optional default value that MUST match one of the keys in contexts. If provided, tools will use this context when no input is provided for this modifier.",
+      "$comment": "JSON Schema cannot validate that this value matches a key in 'contexts'. This validation must be performed at runtime by the implementation."
+    },
+    "$extensions": {
+      "title": "Extensions",
+      "type": "object",
+      "description": "Vendor-specific extensions. Keys are vendor-specific namespaces."
+    }
+  },
+  "definitions": {
+    "referenceObjectForModifiers": {
+      "title": "Reference Object (For Modifiers)",
+      "type": "object",
+      "required": ["$ref"],
+      "properties": {
+        "$ref": {
+          "title": "JSON Reference",
+          "type": "string",
+          "format": "uri-reference",
+          "description": "A JSON Pointer (RFC 6901) or URI reference. Modifiers MUST NOT reference other modifiers (#/modifiers/...) or resolutionOrder items (#/resolutionOrder/...).",
+          "not": {
+            "anyOf": [
+              {
+                "pattern": "^#/modifiers/",
+                "$comment": "Modifiers cannot reference other modifiers"
+              },
+              {
+                "pattern": "^#/resolutionOrder/",
+                "$comment": "Nothing can reference resolutionOrder items"
+              }
+            ]
+          }
+        }
+      },
+      "description": "A reference object for use within modifier contexts. Cannot point to other modifiers or resolutionOrder items."
+    },
+    "tokenSourcesForModifiers": {
+      "title": "Token Sources (For Modifiers)",
+      "type": "array",
+      "description": "An array of token sources for modifier contexts - can reference sets but not other modifiers or resolutionOrder items.",
+      "items": {
+        "oneOf": [
+          {
+            "$ref": "#/definitions/referenceObjectForModifiers"
+          },
+          {
+            "$ref": "../format.json",
+            "description": "Inline design tokens in DTCG format"
+          }
+        ]
+      }
+    }
+  }
+}
+