Lexicon Garden

org.designtxt.resolver

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.

Repository @bomberstudios.com did:plc:34yvx4hv64znmh2i2fezoyqx namespace authority
Details · record, key any
Kindrecord
Record keyany
Authoritydesigntxt.org
Indexed
Compare Edit in builder → Fork →

Record

record · key any

Properties

defs

object

JSON Schema $defs for bundling inline token references. Maps to the DTCG $defs field. Tools may ignore this key.

description

string

Human-readable description of this resolver's purpose.

  • maxLength: 4096

extensions

object

Vendor-specific extension data. Maps to the DTCG $extensions field. Keys should use reverse-domain notation.

modifiers

object

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'.

name

string

Short human-readable name for this resolver document.

  • maxLength: 256

resolutionOrder

requiredarray

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', ...}).

itemsunknown

schema

string

Optional URL of a JSON Schema for this resolver document. Maps to the DTCG $schema field.

  • maxLength: 2048

sets

object

Named sets of design token sources. Keys are set names; values are set definitions with a 'sources' array and optional 'description' and 'extensions'.

version

requiredstring

Resolver format version. Must be '2025.10' per DTCG Resolver spec.

  • maxLength: 16
  • const: "2025.10"

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • org.designtxt.resolveTokens

    procedure

    XRPC Procedure to resolve a design token resolver document against a set of contextual inputs, producing a fully resolved token collection. Implemented at https://xrpc.designtxt.org/xrpc/org.designtxt.resolveTokens

  • org.designtxt.tokenCollection

    record

    A record containing a collection of design tokens in DTCG 2025.10 format. The record has typed metadata fields (name, description, createdAt) alongside the token tree. Token/group keys sit at the same level as metadata; atproto ignores unexpected fields, so the token tree passes through without schema-level validation.