@design-token-kit/core 0.1.1

package/lib/schemas/2025.10/format/group.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/group.json",
+  "title": "Group",
+  "description": "A group in the DTCG specification",
+  "type": "object",
+  "properties": {
+    "$type": {
+      "$ref": "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": "../format.json#/definitions/curlyBraceReference"
+        },
+        {
+          "$ref": "../format.json#/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": "token.json"
+    }
+  },
+  "patternProperties": {
+    "^[^${}.][^{}.]*$": {
+      "description": "Nested groups and tokens (see ../format.json#/definitions/tokenOrGroupName for pattern definition)",
+      "$ref": "groupOrToken.json"
+    }
+  },
+  "additionalProperties": false
+}
+

package/lib/schemas/2025.10/format/groupOrToken.json

@@ -0,0 +1,15 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/groupOrToken.json",
+  "title": "Group or Token",
+  "description": "A group or a token in the DTCG specification. A token is identified by the presence of a $value property, while a group is any object without a $value property.",
+  "oneOf": [
+    {
+      "$ref": "group.json"
+    },
+    {
+      "$ref": "token.json"
+    }
+  ]
+}
+

package/lib/schemas/2025.10/format/token.json

@@ -0,0 +1,425 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/token.json",
+  "title": "Token",
+  "description": "A token in the DTCG specification",
+  "type": "object",
+  "properties": {
+    "$value": {
+      "description": "The token's value - can be a direct value or a reference to another token using curly brace syntax (e.g., '{token.name}'). Mutually exclusive with $ref."
+    },
+    "$type": {
+      "$ref": "tokenType.json"
+    },
+    "$ref": {
+      "$ref": "../format.json#/definitions/jsonPointerReference",
+      "description": "JSON Pointer reference (RFC 6901) for advanced referencing. Use this instead of $value for property-level references. Examples: '#/colors/blue/$value' or '#/colors/blue/$value/components/0'. Mutually exclusive with $value."
+    },
+    "$description": {
+      "type": "string",
+      "description": "A plain text description of the token"
+    },
+    "$extensions": {
+      "type": "object",
+      "description": "Vendor-specific extensions"
+    },
+    "$deprecated": {
+      "oneOf": [
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "string"
+        }
+      ],
+      "description": "Whether this token is deprecated"
+    }
+  },
+  "additionalProperties": false,
+  "allOf": [
+    {
+      "description": "Tokens cannot define both $value and $ref; they must choose exactly one form of reference or direct value.",
+      "if": {
+        "required": ["$value"],
+        "properties": {
+          "$value": true
+        }
+      },
+      "then": {
+        "not": {
+          "required": ["$ref"],
+          "properties": {
+            "$ref": true
+          }
+        }
+      },
+      "else": {
+        "required": ["$ref"],
+        "properties": {
+          "$ref": true
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "color" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/color.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "dimension" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/dimension.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "fontFamily" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/fontFamily.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "fontWeight" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/fontWeight.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "duration" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/duration.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "cubicBezier" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/cubicBezier.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "number" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/number.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "strokeStyle" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/strokeStyle.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "border" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/border.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "transition" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/transition.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "shadow" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/shadow.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "gradient" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/gradient.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": ["$type"],
+        "properties": {
+          "$type": { "const": "typography" }
+        }
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/typography.json"
+              },
+              {
+                "$ref": "../format.json#/definitions/tokenValueReference"
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "allOf": [
+          {
+            "not": {
+              "required": ["$type"]
+            }
+          },
+          {
+            "required": ["$value"]
+          },
+          {
+            "properties": {
+              "$value": {
+                "not": {
+                  "$ref": "../format.json#/definitions/tokenValueReference"
+                }
+              }
+            }
+          }
+        ]
+      },
+      "then": {
+        "properties": {
+          "$value": {
+            "oneOf": [
+              {
+                "$ref": "values/color.json"
+              },
+              {
+                "$ref": "values/dimension.json"
+              },
+              {
+                "$ref": "values/fontFamily.json"
+              },
+              {
+                "$ref": "values/duration.json"
+              },
+              {
+                "$ref": "values/cubicBezier.json"
+              },
+              {
+                "$ref": "values/strokeStyle.json"
+              },
+              {
+                "$ref": "values/border.json"
+              },
+              {
+                "$ref": "values/transition.json"
+              },
+              {
+                "$ref": "values/shadow.json"
+              },
+              {
+                "$ref": "values/gradient.json"
+              },
+              {
+                "$ref": "values/typography.json"
+              },
+              {
+                "anyOf": [
+                  {
+                    "$ref": "values/number.json"
+                  },
+                  {
+                    "$ref": "values/fontWeight.json"
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      }
+    }
+  ]
+}
+

package/lib/schemas/2025.10/format/tokenType.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/tokenType.json",
+  "title": "TokenType",
+  "description": "A token type in the DTCG specification",
+  "type": "string",
+  "enum": [
+    "color",
+    "dimension",
+    "fontFamily",
+    "fontWeight",
+    "duration",
+    "cubicBezier",
+    "number",
+    "strokeStyle",
+    "border",
+    "transition",
+    "shadow",
+    "gradient",
+    "typography"
+  ]
+}
+

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

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://www.designtokens.org/schemas/2025.10/format/values/border.json",
+  "title": "Border Value",
+  "description": "Value schema for border type tokens. Represents a border style.",
+  "type": "object",
+  "properties": {
+    "color": {
+      "description": "The color of the border",
+      "oneOf": [
+        {
+          "$ref": "color.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "width": {
+      "description": "The width or thickness of the border",
+      "oneOf": [
+        {
+          "$ref": "dimension.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    },
+    "style": {
+      "description": "The border's style",
+      "oneOf": [
+        {
+          "$ref": "strokeStyle.json"
+        },
+        {
+          "$ref": "../../format.json#/definitions/tokenValueReference"
+        }
+      ]
+    }
+  },
+  "required": ["color", "width", "style"],
+  "additionalProperties": false
+}
+