org.designtxt.resolver

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A resolver document that declares token sets and contextual modifiers, with a resolution order that determines how they compose. Given an input (e.g. {theme: 'dark', size: 'compact'}), a resolver produces a flat, contextually-appropriate token set.",
      "key": "any",
      "record": {
        "description": "Root of a resolver document.",
        "properties": {
          "defs": {
            "description": "JSON Schema $defs for bundling inline token references. Maps to the DTCG $defs field. Tools may ignore this key.",
            "type": "object"
          },
          "description": {
            "description": "Human-readable description of this resolver's purpose.",
            "maxLength": 4096,
            "type": "string"
          },
          "extensions": {
            "description": "Vendor-specific extension data. Maps to the DTCG $extensions field. Keys should use reverse-domain notation.",
            "type": "object"
          },
          "modifiers": {
            "description": "Named modifiers for contextual token overrides. Keys are modifier names; values have a 'contexts' map (string to token sources array), optional 'description', optional 'default', and optional 'extensions'.",
            "properties": {},
            "type": "object"
          },
          "name": {
            "description": "Short human-readable name for this resolver document.",
            "maxLength": 256,
            "type": "string"
          },
          "resolutionOrder": {
            "description": "Ordered list of sets and modifiers that determines the resolution cascade. Later items override earlier ones on conflict. Each entry is a reference object ({$ref: string}) or an inline definition ({name, type: 'set'|'modifier', ...}).",
            "items": {
              "type": "unknown"
            },
            "type": "array"
          },
          "schema": {
            "description": "Optional URL of a JSON Schema for this resolver document. Maps to the DTCG $schema field.",
            "maxLength": 2048,
            "type": "string"
          },
          "sets": {
            "description": "Named sets of design token sources. Keys are set names; values are set definitions with a 'sources' array and optional 'description' and 'extensions'.",
            "properties": {},
            "type": "object"
          },
          "version": {
            "const": "2025.10",
            "description": "Resolver format version. Must be '2025.10' per DTCG Resolver spec.",
            "maxLength": 16,
            "type": "string"
          }
        },
        "required": [
          "version",
          "resolutionOrder"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A resolver document for multi-context design tokens (theming, breakpoints, accessibility modes). Follows the DTCG Resolver 2025.10 specification. Describes how token sets and contextual modifiers combine to produce resolved token values for a given input.",
  "id": "org.designtxt.resolver",
  "lexicon": 1
}