Skip to content

feat: complete non-Layout domains and add verified interaction examples - #36

Open
changeroa wants to merge 11 commits into
mainfrom
codex/complete-non-layout-domains
Open

feat: complete non-Layout domains and add verified interaction examples#36
changeroa wants to merge 11 commits into
mainfrom
codex/complete-non-layout-domains

Conversation

@changeroa

@changeroa changeroa commented Sep 8, 2026

Copy link
Copy Markdown
Owner

The non-Layout domains lacked a complete route from choosing an approach to implementing and verifying it. This adds those workflows, governs Design Terminology as the sixth domain, and supplies an executable interaction example with recorded observations from a physical Mac browser.

  • Add fourteen guides covering Motion briefs and recipes, Design Engineering component contracts, Game UI screen and verification workflows, platform adaptation, and terminology comparisons. Connect the domain hubs, root routes, provenance, and ownership records. Existing Layout patterns and spatial boundaries remain intact.
  • Add source-qualified terminology records and validate dates, source locators, labels, relation direction, temporal scope, inverse consistency, and containment cycles. Correct representation direction and composition-versus-containment examples.
  • Admit the complete 147-document corpus to material v2 and the npm package, improve specific search ranking, and verify six non-Layout queries through both installed CLI and MCP entry points. Keep examples, profiles, source implementations, and evidence outside material admission.
  • Add examples/domain-interactions/ with draft/save races, stale search responses, responsive detail navigation, nested dialogs, inventory request lifetime, reward reveal, reduced motion, and native controls. Fix the modal Tab boundary found during browser execution. Commit source hashes, an action/observation report, and five screenshots.
  • Repair the stale consumer-reference/agent-native/README.md compatibility digest by separately pinning the reviewed documentation revision. Preserve all 21 core/source digests and six v1 CLI byte-output goldens.
  • Integrate current main lifecycle policy: reader tasks and adoption counts neither authorize nor block domain promotion. Refresh current source inventories and workflow/document seals while preserving both CI job bodies, owner decisions, deadlines, external callers as unknown, extension retention, and immutable archive bindings.

Validation completed locally:

  • Domain validation: six domains and 33 declared leaves; 70 domain fixtures. Terminology: 11 terms, eight relations, and 42 fixtures.
  • Markdown links, OKF, information architecture, governance and its 172 fixtures, and repository source inventory checks.
  • Consumer-reference handoff validation and 92 fixtures; historical page-evidence archive validation against the recorded immutable commit/tree and all 23 retained files.
  • npm run test:agent-native, npm run test:material, npm run test:component-state, npm run validate:material, npm run validate:lifecycle-dispositions, and npm run test:lifecycle-dispositions. Rechecked installed-package behavior after the final material refresh.
  • Physical Mac (Mac16,8, arm64, macOS 26.5.1) with Aside-controlled Chrome 151: 84 action/observation checkpoints passed and zero observed JavaScript errors. Includes 320/375/768/1024/1440 CSS-pixel sizes, long Korean content, RTL, keyboard focus, and reduced-motion overrides. See examples/domain-interactions/verification.md for the bound report and screenshots.

The browser example uses mock services. Small browser viewports are size fixtures; Android/iOS hardware, Safari, native Windows/Unity, touch/controllers, assistive technology, and real backend operations were not tested. Domain leaves remain experimental; these observations do not claim independent adoption or lifecycle promotion.

Integration note: #35 independently adds State Management and overlaps the domain manifest, routing, and material-admission cardinality. Its merge should reconcile those inventories with the sixth domain introduced here.

Implementation handoff: consumer_reference: consumer-reference/agent-native/registry.json.

Consumer reference: declared
Consumer reference record: consumer-reference/agent-native/registry.json

Terminology reliance: figma.variable, figma.mode, figma.collection, figma.component, dtcg.token, dtcg.group, dtcg.token.draft2, css.custom-property, carbon.component, carbon.pattern, stylegallery.pattern. Relation types: partial_overlap, implementation_representation, not_comparable, same_label_different_meaning, near_equivalent. Named Figma, DTCG, CSSWG, Carbon, and local Layout sources were rechecked in this session on 2026-09-08; this is author review, not independent semantic approval. The runtime example itself relies on no terminology relation records.

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.

1 participant