Skip to content

[DS 2.0] Split the CSS variable namespaces - #102

Open
librowski wants to merge 2 commits into
ds2-ui-type-rolesfrom
ds2-namespace-split
Open

[DS 2.0] Split the CSS variable namespaces#102
librowski wants to merge 2 commits into
ds2-ui-type-rolesfrom
ds2-namespace-split

Conversation

@librowski

Copy link
Copy Markdown
Collaborator

Splits the CSS custom properties into three sanctioned namespaces:

  • --wb-ds-* — every token generated from the Figma set (colors, semantic ui, component, canvas, shadow, spacing, sizing, radius, font families): 550 variables, renamed at the style-dictionary source.
  • --wb-sdk-* — the hand-authored private SDK variables (edge labels, syntax highlighter, app bar, message controls and friends): 102 variables.
  • --wb-public-* — the supported override contract, unchanged for the per-component ui variables; the SDK's public knobs join it (--wb-public-background-color, --wb-public-transition, --wb-public-scroll-*, alongside the existing --wb-public-font-family).

The remaining internal --ax-* variables become locally scoped, unprefixed component variables; source contains no --ax- occurrence anymore. The built-CSS gate now asserts the namespace contract on every build, and the variable documentation (both READMEs, the design-system guide, theming, generated tables) follows the new split. One major changeset per published package states the rename rules.

Verified: ui/sdk lint + typecheck, build:ui, build:lib (including the new namespace gate), stylelint, all test suites, docs build.

@librowski
librowski force-pushed the ds2-namespace-split branch from 689d58c to fe59a52 Compare August 31, 2026 21:02
@librowski
librowski force-pushed the ds2-namespace-split branch from fe59a52 to fa9b63f Compare August 31, 2026 21:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants