feat(design-system): document BlockUI logic and grammar - #7556
Draft
mahanti wants to merge 2 commits into
Draft
Conversation
Signed-off-by: Arjun Mahanti <arjun@squareup.com>
Signed-off-by: Arjun Mahanti <arjun@squareup.com>
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 System → Logic & grammar at
/design/grammar, a compact reference for selecting BlockUI tokens and composing supported interfaces. Fifteen always-visible tables cover role resolution, all 19 typography roles, color/emphasis, interaction states, geometry, component contracts, intent and modes, applet slots, visualization selection, palettes, the 12 composition defaults, size/data fallbacks, and generated-response constraints.Each topic pairs usage with its boundaries and links to a verified upstream snapshot. The page identifies source-specific exceptions, provisional guidance, and differences from Buzz’s active type, font, and density contracts. It summarizes the reference without importing private fonts, assets, implementations, or a runtime service. Source links require Block access. It does not change token values or implement the upstream planner.
Every topic renders as a heading and a flat table, with no collapsible sections. Topic links support keyboard navigation and refresh. Tables scroll horizontally on narrow screens and remain keyboard-accessible. Theme and Normal/Compact density remain shared.
Stack 7: #7522 → #7523 → #7525 → #7533 → #7535 → #7537 → this PR. Base:
codex/design-system-component-pages. Keep draft.Validation:
just cipassed the earlier checks and desktop tests, then stopped at the unchangedbuzz-terminal::lifecycle_tests::default_prog_child_observes_the_login_argv0: the child did not report$0within 10 seconds. The same failure occurred before this change. Later repository-wide stages were not reached; no terminal or Rust code changed.