Repository navigation
Add a headless model and part-set runtime to the design system - #9578
Draft
shawnmcclelland wants to merge 2 commits into
Draft
shawnmcclelland wants to merge 2 commits into
shawnmcclelland wants to merge 2 commits into
Conversation
shawnmcclelland
force-pushed
the
claude/design-system-model-parts
branch
from
November 20, 2026 21:41
84b431b to
75a5716
Compare
@agent-native/design-system/model describes a surface once as rows with stable dotted ids, validates them, defines the row attributes every part writes, captures rendered rows with names and state read from ARIA, and compares two renders structurally. A source rendering without row ids maps onto the model by selector, so its painted styles compare with a target part set's row by row. The design-system skill documents it in references/model.md.
ModelSurface draws a screen model through the design system's part set, falling back to toolkit's own parts, and throws on an unknown part, an unhandled effect or an unfilled slot. defineDesignSystem takes a parts map. The Agent-Native part set draws settings nav, groups, rows, sections, notices and reports, buttons and glyphs on the Base UI parts. checkPartSetEquivalence checks that a target part set draws a model with the same rows as ours. The eject manifest declares the dependencies the copied parts bring.
shawnmcclelland
force-pushed
the
claude/design-system-model-parts
branch
from
November 20, 2026 21:53
75a5716 to
70bc260
Compare
This branch has not been deployed
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.
Stacked on #9575 (design-system foundation). Draft for feedback and review before anything builds on it.
What this adds
A frontend pipeline that maps a surface from one rendering to another. It adds no app screens and changes none.
@agent-native/design-system/model): a surface is described once as rows with stable dotted ids, labels, state and effects. It holds no layout or styling.validateModellists every issue, androwIdSegmentturns app data such as an email into a valid id.ModelSurface,defineDesignSystem({ parts })): a part set is markup for catalog parts, keyed by part (settings.row).ModelSurfacedraws a model through the app's part set and falls back to toolkit's own parts. It throws on an unknown part, an unhandled effect or an unfilled slot, so nothing degrades silently.checkPartSetEquivalence({ model, target })renders a model through two part sets and compares rows, tree, accessible names and state.applyRowLocators,captureRowStylesandcompareRowStyles(source, target)map a rendering that has no row ids onto the model by selector, then compare painted styles row by row.The design-system skill documents the model, parts and checks in
references/model.md.Feedback wanted
id,part,kind,state,effect,slot,regions,hosts) and the dotted-id rulesTesting
css:check, typechecktest:storybookpnpm guards