Terminology

Sections marked as "Note" or "Example" are non-normative. Everything else is normative.

This glossary defines the normative vocabulary used across the specification.

Terms

Token document

JSON object conforming to this specification.

Document version

Semantic Versioning 2.0.0 string identifying the revision of a token document.

Token

Object whose members include either $value or $ref. Tokens SHOULD declare $type so their semantics remain explicit even when metadata is copied independently of parent collections.

Collection

Object whose members are tokens or other collections.

Extension identifier

Lower-case reverse domain name with at least one dot used as a key in $extensions.

Alias

Token that resolves to another token via $ref. Alias tokens MUST declare $type and MUST NOT include $value.

Producer

Implementation that serialises token documents.

Consumer

Implementation that reads token documents.

Validator

Implementation that reports conformance results.

Namespace

Prefix used in extension identifiers to avoid collisions.

Theme

Ordered layer of token overrides identified by name.

Variant

Collection of tokens applied conditionally to a theme.