feat(linter): add parser and model resolution support for hypertokens - #169
Open
zachshallbetter wants to merge 2 commits into
Open
feat(linter): add parser and model resolution support for hypertokens#169zachshallbetter wants to merge 2 commits into
zachshallbetter wants to merge 2 commits into
Conversation
zachshallbetter
force-pushed
the
feat/hypertokens
branch
from
August 13, 2026 06:42
a64775b to
26d2895
Compare
…ertokens" This reverts commit 26d2895.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds support for parsing, resolving, and linting the newly proposed
hypertokenscategory inDESIGN.md(resolves Issue #137).Background & Motivation
This implements the "hypertokens" concept introduced by Jake Albaugh (@jake-figma) at Figma Config 2026: Design context for agentic workflows. Hypertokens act as an intermediate layer between atomic design tokens and components. Instead of forcing consumers (or AI coding agents) to guess which colors, spacing levels, and corner styles belong together on a specific UI element, hypertokens allow design authors to package those decisions into a single named visual preset.
For more details on the design rationale, see the UX Collective writeup:
What are hypertokens? The layer between tokens and components, rebuilt for agents.
We already support composite values for typography (e.g.,
{typography.label-md}). This PR introduces a generichypertokensblock in the frontmatter, maps the resolved properties, and allows components to reference them via a newstyleproperty.Changes
Hypertokensas a canonical section heading and addstyle(typeHypertoken) tocomponent_sub_tokensinspec-config.yaml.ParsedDesignSysteminterface andSCHEMA_KEYSinparser/spec.ts.hypertokensfrom raw parsed YAML inparser/handler.ts.hypertokensmaps toDesignSystemStateand support nested values inmodel/spec.ts.model/handler.ts.model/handler.ts.broken-refrule inlinter/rules/broken-ref.tsto scanstate.hypertokensand verify that all internal references resolve successfully, flagging any broken links.spec.mdxandREADME.mdto document the hypertokens schema, component styling, and Config 2026 citations.docs/spec.mdwith the new schema key details.brutalist-archiveexample showcasing an industrial design spec, generated DTCG design tokens, and a Tailwind v3 configuration.parser/handler.test.ts.model/handler.test.ts.linter/rules/broken-ref.test.ts..DS_Storeto.gitignoreto prevent macOS system metadata from being tracked.