stylegallery 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +156 -0
- package/CATALOG.md +69 -0
- package/DOMAINS.md +65 -0
- package/GOVERNANCE.md +222 -0
- package/GUIDE.md +59 -0
- package/README.md +313 -0
- package/consumer-reference/adapters/style-dictionary.config.mjs +36 -0
- package/consumer-reference/agent-native/README.md +157 -0
- package/consumer-reference/agent-native/registry.json +640 -0
- package/consumer-reference/agent-native/schema/agent-native.schema.json +848 -0
- package/consumer-reference/agent-native/schema/epistemic.schema.json +14 -0
- package/consumer-reference/agent-native/schema/execution.schema.json +12 -0
- package/consumer-reference/agent-native/schema/identity.schema.json +10 -0
- package/consumer-reference/agent-native/schema/learning.schema.json +12 -0
- package/consumer-reference/agent-native/schema/manifest.schema.json +6 -0
- package/consumer-reference/agent-native/schema/operation.schema.json +12 -0
- package/consumer-reference/agent-native/schema/protocol-binding.schema.json +9 -0
- package/consumer-reference/agent-native/schema/retrieval.schema.json +10 -0
- package/consumer-reference/baselines/calibration.json +260 -0
- package/consumer-reference/baselines/manifest.json +21 -0
- package/consumer-reference/contract.md +83 -0
- package/consumer-reference/fixtures/consumer-conformance/e2e-fixture.mjs +282 -0
- package/consumer-reference/fixtures/consumer-conformance/manifest.json +102 -0
- package/consumer-reference/fixtures/consumer-conformance/runtime-proof.mjs +32 -0
- package/consumer-reference/fixtures/consumer-conformance/valid-migration-result.json +18 -0
- package/consumer-reference/fixtures/consumer-conformance/valid-migration.json +142 -0
- package/consumer-reference/fixtures/invalid-stable-ended-support.json +19 -0
- package/consumer-reference/fixtures/promotion/invalid-blocking-evidence.json +26 -0
- package/consumer-reference/fixtures/promotion/invalid-count-only.json +29 -0
- package/consumer-reference/fixtures/promotion/invalid-missing-owner-migration.json +25 -0
- package/consumer-reference/fixtures/promotion/invalid-normative-bypass-no-regression.json +25 -0
- package/consumer-reference/fixtures/promotion/invalid-related-counted-independent.json +45 -0
- package/consumer-reference/fixtures/promotion/invalid-stable-ended-support.json +26 -0
- package/consumer-reference/fixtures/promotion/manifest.json +15 -0
- package/consumer-reference/fixtures/promotion/valid-deferred-example.json +67 -0
- package/consumer-reference/fixtures/promotion/valid-normative-bypass.json +67 -0
- package/consumer-reference/fixtures/token-portability/invalid-cycle.json +7 -0
- package/consumer-reference/fixtures/token-portability/invalid-dangling-alias.json +6 -0
- package/consumer-reference/fixtures/token-portability/invalid-extends.json +4 -0
- package/consumer-reference/fixtures/token-portability/invalid-json-pointer.json +7 -0
- package/consumer-reference/fixtures/token-portability/invalid-resolver.json +9 -0
- package/consumer-reference/fixtures/token-portability/invalid-type-mismatch.json +10 -0
- package/consumer-reference/fixtures/token-portability/invalid-unknown-reserved.json +6 -0
- package/consumer-reference/fixtures/token-portability/invalid-untested-type.json +6 -0
- package/consumer-reference/fixtures/token-portability/valid-border.json +14 -0
- package/consumer-reference/fixtures/token-portability/valid-reference.json +32 -0
- package/consumer-reference/fixtures/token-portability/valid-whole-alias.json +7 -0
- package/consumer-reference/fixtures/valid-deprecated.json +21 -0
- package/consumer-reference/fixtures/valid-experimental.json +19 -0
- package/consumer-reference/generated/manifest.json +40 -0
- package/consumer-reference/generated/tokens.css +12 -0
- package/consumer-reference/index.md +32 -0
- package/consumer-reference/policies/shared-experimental.json +37 -0
- package/consumer-reference/schema/ax-evidence.schema.json +30 -0
- package/consumer-reference/schema/baseline-manifest.schema.json +55 -0
- package/consumer-reference/schema/calibration-record.schema.json +190 -0
- package/consumer-reference/schema/capture-session.schema.json +161 -0
- package/consumer-reference/schema/component-state.schema.json +150 -0
- package/consumer-reference/schema/consumer-conformance-record.schema.json +365 -0
- package/consumer-reference/schema/dom-evidence.schema.json +38 -0
- package/consumer-reference/schema/evidence-record.schema.json +81 -0
- package/consumer-reference/schema/fixture-manifest.schema.json +32 -0
- package/consumer-reference/schema/item.schema.json +188 -0
- package/consumer-reference/schema/page-evidence-manifest.schema.json +216 -0
- package/consumer-reference/schema/page-evidence-session.schema.json +119 -0
- package/consumer-reference/schema/portable-tokens.schema.json +104 -0
- package/consumer-reference/schema/promotion-rfc.schema.json +219 -0
- package/consumer-reference/schema/runtime-evidence-manifest.schema.json +33 -0
- package/consumer-reference/schema/visual-evidence.schema.json +31 -0
- package/design-engineering/consumer-migration-readiness.md +124 -0
- package/design-engineering/index.md +28 -0
- package/design-engineering/interface-craft.md +107 -0
- package/design-engineering/reference-profiles/external-adaptation/index.md +12 -0
- package/design-engineering/reference-profiles/governed-local/editorial/components/button.component.json +125 -0
- package/design-engineering/reference-profiles/governed-local/editorial/evidence/button.evidence.json +3504 -0
- package/design-engineering/reference-profiles/governed-local/editorial/fixtures/button.fixture.json +65 -0
- package/design-engineering/reference-profiles/governed-local/editorial/generated/evidence-coverage.md +23 -0
- package/design-engineering/reference-profiles/governed-local/editorial/generated/keyboard-matrix.md +19 -0
- package/design-engineering/reference-profiles/governed-local/editorial/generated/state-matrix.md +21 -0
- package/design-engineering/reference-profiles/governed-local/editorial/local-foundations.json +12 -0
- package/design-engineering/reference-profiles/governed-local/editorial/profile.json +43 -0
- package/design-engineering/reference-profiles/governed-local/editorial/states/button.states.json +195 -0
- package/design-engineering/reference-profiles/governed-local/editorial/tokens.dtcg.json +17 -0
- package/design-engineering/reference-profiles/governed-local/index.md +26 -0
- package/design-engineering/reference-profiles/governed-local/terminal/components/button.component.json +125 -0
- package/design-engineering/reference-profiles/governed-local/terminal/evidence/button.evidence.json +3504 -0
- package/design-engineering/reference-profiles/governed-local/terminal/fixtures/button.fixture.json +65 -0
- package/design-engineering/reference-profiles/governed-local/terminal/generated/evidence-coverage.md +23 -0
- package/design-engineering/reference-profiles/governed-local/terminal/generated/keyboard-matrix.md +19 -0
- package/design-engineering/reference-profiles/governed-local/terminal/generated/state-matrix.md +21 -0
- package/design-engineering/reference-profiles/governed-local/terminal/local-foundations.json +12 -0
- package/design-engineering/reference-profiles/governed-local/terminal/profile.json +43 -0
- package/design-engineering/reference-profiles/governed-local/terminal/states/button.states.json +195 -0
- package/design-engineering/reference-profiles/governed-local/terminal/tokens.dtcg.json +17 -0
- package/design-engineering/reference-profiles/index.md +19 -0
- package/game-ui/classification.md +82 -0
- package/game-ui/index.md +35 -0
- package/game-ui/reference-record.md +62 -0
- package/game-ui/screen-hierarchy.md +107 -0
- package/game-ui/unity/architecture.md +166 -0
- package/game-ui/unity/cli-loop.md +84 -0
- package/game-ui/unity/data/unity-technologies-public-repositories.json +26654 -0
- package/game-ui/unity/org-wiki.md +146 -0
- package/game-ui/unity/repository-map.md +102 -0
- package/game-ui/unity/ui-systems.md +85 -0
- package/guides/decision-tree.md +149 -0
- package/guides/documentation-mode-taxonomy.md +157 -0
- package/guides/layout-brief.md +220 -0
- package/guides/vocabulary.md +148 -0
- package/guides/webpage-generation-workflow.md +185 -0
- package/index.md +36 -0
- package/layout/index.md +26 -0
- package/motion/index.md +24 -0
- package/motion/practice-reference.md +145 -0
- package/motion/review-workflow.md +86 -0
- package/motion/vocabulary.md +82 -0
- package/package.json +78 -0
- package/patterns/centering/center.md +87 -0
- package/patterns/centering/index.md +6 -0
- package/patterns/centering/super-center.md +89 -0
- package/patterns/containment/box.md +87 -0
- package/patterns/containment/clamped-card.md +86 -0
- package/patterns/containment/content-limiter.md +87 -0
- package/patterns/containment/fluid-styles.md +86 -0
- package/patterns/containment/index.md +8 -0
- package/patterns/grid-repetition/card-grid.md +88 -0
- package/patterns/grid-repetition/columns.md +87 -0
- package/patterns/grid-repetition/dense-grid.md +88 -0
- package/patterns/grid-repetition/grid-wrapper.md +89 -0
- package/patterns/grid-repetition/index.md +12 -0
- package/patterns/grid-repetition/masonry-approx.md +87 -0
- package/patterns/grid-repetition/page-grid.md +90 -0
- package/patterns/grid-repetition/ram-grid.md +88 -0
- package/patterns/grid-repetition/twelve-span-grid.md +92 -0
- package/patterns/in-line-grouping/badge-list.md +94 -0
- package/patterns/in-line-grouping/breadcrumb.md +89 -0
- package/patterns/in-line-grouping/cluster.md +89 -0
- package/patterns/in-line-grouping/deconstructed-pancake.md +92 -0
- package/patterns/in-line-grouping/index.md +13 -0
- package/patterns/in-line-grouping/pagination.md +89 -0
- package/patterns/in-line-grouping/reel.md +90 -0
- package/patterns/in-line-grouping/split-nav.md +97 -0
- package/patterns/in-line-grouping/tab-strip.md +88 -0
- package/patterns/in-line-grouping/wrap-row.md +89 -0
- package/patterns/index.md +13 -0
- package/patterns/media-fit/frame.md +95 -0
- package/patterns/media-fit/icon-frame.md +87 -0
- package/patterns/media-fit/index.md +6 -0
- package/patterns/overlay-exception/imposter.md +95 -0
- package/patterns/overlay-exception/index.md +6 -0
- package/patterns/overlay-exception/overlay-stack.md +89 -0
- package/patterns/split-sidebar/index.md +12 -0
- package/patterns/split-sidebar/list-detail.md +95 -0
- package/patterns/split-sidebar/main-with-rail.md +95 -0
- package/patterns/split-sidebar/media-object.md +102 -0
- package/patterns/split-sidebar/sidebar.md +101 -0
- package/patterns/split-sidebar/split-screen.md +92 -0
- package/patterns/split-sidebar/sticky-aside.md +97 -0
- package/patterns/split-sidebar/supporting-pane.md +95 -0
- package/patterns/split-sidebar/switcher.md +93 -0
- package/patterns/stacking/feed.md +88 -0
- package/patterns/stacking/index.md +8 -0
- package/patterns/stacking/line-up.md +95 -0
- package/patterns/stacking/stack.md +87 -0
- package/patterns/stacking/step-nav.md +88 -0
- package/patterns/viewport-shell/cover.md +90 -0
- package/patterns/viewport-shell/fixed-sidenav-shell.md +97 -0
- package/patterns/viewport-shell/holy-grail.md +112 -0
- package/patterns/viewport-shell/index.md +11 -0
- package/patterns/viewport-shell/panel-layout.md +95 -0
- package/patterns/viewport-shell/scroll-body-shell.md +93 -0
- package/patterns/viewport-shell/sticky-footer.md +92 -0
- package/patterns/viewport-shell/sticky-header.md +86 -0
- package/platform-guides/apple-interaction.md +89 -0
- package/platform-guides/index.md +26 -0
- package/quality/claim-records/index.md +3 -0
- package/quality/claim-records/samples.md +92 -0
- package/quality/claim-records/stylegallery-multidomain-scope.md +42 -0
- package/quality/claims.md +77 -0
- package/quality/evidence/accessibility.md +58 -0
- package/quality/evidence/consumer-migration.md +42 -0
- package/quality/evidence/design-rationale.md +34 -0
- package/quality/evidence/executable-evidence.md +79 -0
- package/quality/evidence/families.md +56 -0
- package/quality/evidence/hci-evaluation.md +36 -0
- package/quality/evidence/index.md +16 -0
- package/quality/evidence/pattern-contract-audit.md +96 -0
- package/quality/evidence/search-metadata-polyhierarchy.md +86 -0
- package/quality/evidence/sources.md +43 -0
- package/quality/evidence/tokens.md +33 -0
- package/quality/evidence/visual-qa.md +41 -0
- package/quality/gates/accessibility-evidence.md +60 -0
- package/quality/gates/consumer-migration-evidence.md +53 -0
- package/quality/gates/design-claim.md +56 -0
- package/quality/gates/harmony-evaluation.md +78 -0
- package/quality/gates/index.md +13 -0
- package/quality/gates/layout.md +52 -0
- package/quality/gates/rationale.md +53 -0
- package/quality/gates/visual-evidence.md +47 -0
- package/quality/index.md +55 -0
- package/quality/principles.md +58 -0
- package/recipes/article-page.md +52 -0
- package/recipes/command-surface.md +55 -0
- package/recipes/dashboard.md +56 -0
- package/recipes/form-flow.md +55 -0
- package/recipes/homepage.md +89 -0
- package/recipes/index.md +13 -0
- package/recipes/list-detail.md +55 -0
- package/recipes/primitive-to-recipe-matrix.md +83 -0
- package/recipes/saas-settings.md +52 -0
- package/scripts/agent-native/a2a-projection.mjs +248 -0
- package/scripts/agent-native/agui-projection.mjs +178 -0
- package/scripts/agent-native/canonical-json.mjs +109 -0
- package/scripts/agent-native/cli-adapter.mjs +68 -0
- package/scripts/agent-native/events.mjs +113 -0
- package/scripts/agent-native/execution.mjs +227 -0
- package/scripts/agent-native/fixture.mjs +159 -0
- package/scripts/agent-native/identity.mjs +184 -0
- package/scripts/agent-native/immutable-store.mjs +102 -0
- package/scripts/agent-native/knowledge.mjs +168 -0
- package/scripts/agent-native/learning-records.mjs +244 -0
- package/scripts/agent-native/learning.mjs +247 -0
- package/scripts/agent-native/mcp-adapter.mjs +173 -0
- package/scripts/agent-native/queries.mjs +173 -0
- package/scripts/agent-native/registry.mjs +154 -0
- package/scripts/agent-native/retrieval.mjs +171 -0
- package/scripts/agent-native/self-description.mjs +160 -0
- package/scripts/artifact-metadata.mjs +20 -0
- package/scripts/audit-evidence-freshness.mjs +308 -0
- package/scripts/baseline-contract.mjs +189 -0
- package/scripts/baseline-schema-parity.mjs +40 -0
- package/scripts/build-reference-artifacts.mjs +127 -0
- package/scripts/calibration-raw-contract.mjs +172 -0
- package/scripts/capture-session-contract.mjs +187 -0
- package/scripts/component-state-artifact-fixture.mjs +44 -0
- package/scripts/component-state-contract.mjs +99 -0
- package/scripts/component-state-semantics.mjs +128 -0
- package/scripts/component-state-workflow-contract.mjs +67 -0
- package/scripts/component-state-workflow-negative-cases.mjs +64 -0
- package/scripts/consumer-conformance-contract.mjs +198 -0
- package/scripts/consumer-evidence-governance-contract.mjs +210 -0
- package/scripts/consumer-reference-case-runner.mjs +93 -0
- package/scripts/consumer-reference-schema.mjs +155 -0
- package/scripts/create-component-state-session.mjs +100 -0
- package/scripts/create-page-evidence-session.mjs +139 -0
- package/scripts/domain-document-boundaries.mjs +40 -0
- package/scripts/domain-validation-checks.mjs +141 -0
- package/scripts/evidence-artifact-contract.mjs +191 -0
- package/scripts/finalize-component-state-evidence.mjs +165 -0
- package/scripts/finalize-page-evidence.mjs +197 -0
- package/scripts/generate-consumer-reference-evidence.mjs +154 -0
- package/scripts/generate-patterns.mjs +218 -0
- package/scripts/governance-matrix-contract.mjs +73 -0
- package/scripts/governance-matrix-negative-cases.mjs +114 -0
- package/scripts/governance-policy-contract.mjs +49 -0
- package/scripts/governance-test-fixture.mjs +321 -0
- package/scripts/governance-workflow-negative-cases.mjs +241 -0
- package/scripts/governed-profile-registry.mjs +125 -0
- package/scripts/json-schema-formats.mjs +31 -0
- package/scripts/markdown-structure.mjs +45 -0
- package/scripts/page-artifact-metadata.mjs +124 -0
- package/scripts/page-evidence-contract.mjs +297 -0
- package/scripts/page-evidence-fixture.mjs +271 -0
- package/scripts/pattern-data.mjs +325 -0
- package/scripts/profile-record-contract.mjs +140 -0
- package/scripts/promotion-attestation-contract.mjs +91 -0
- package/scripts/promotion-boundary-test-contract.mjs +92 -0
- package/scripts/promotion-fixture-inventory.mjs +109 -0
- package/scripts/promotion-governance-contract.mjs +28 -0
- package/scripts/reference-artifact-path-contract.mjs +28 -0
- package/scripts/reference-profile-contract.mjs +114 -0
- package/scripts/reference-token-contract.mjs +156 -0
- package/scripts/run-consumer-page-evidence-ci.mjs +170 -0
- package/scripts/sg-mcp.mjs +16 -0
- package/scripts/sg.mjs +27 -0
- package/scripts/strict-json.mjs +72 -0
- package/scripts/summarize-sentinel-calibration.mjs +98 -0
- package/scripts/test-agent-adapter-conformance.mjs +250 -0
- package/scripts/test-agent-conformance-receipt.mjs +106 -0
- package/scripts/test-agent-events.mjs +81 -0
- package/scripts/test-agent-execution-effects.mjs +114 -0
- package/scripts/test-agent-execution-fixtures.mjs +140 -0
- package/scripts/test-agent-execution-kernel.mjs +39 -0
- package/scripts/test-agent-execution-learning.mjs +130 -0
- package/scripts/test-agent-execution-lifecycle.mjs +143 -0
- package/scripts/test-agent-execution-safety.mjs +158 -0
- package/scripts/test-agent-execution-views.mjs +117 -0
- package/scripts/test-agent-identity-integrity-cases.mjs +160 -0
- package/scripts/test-agent-knowledge-kernel.mjs +183 -0
- package/scripts/test-agent-learning.mjs +246 -0
- package/scripts/test-agent-mcp.mjs +246 -0
- package/scripts/test-agent-native-schemas.mjs +215 -0
- package/scripts/test-agent-projections.mjs +249 -0
- package/scripts/test-agent-registry-mcp-integrity.mjs +215 -0
- package/scripts/test-agent-registry-mutations.mjs +110 -0
- package/scripts/test-audit-evidence-freshness.mjs +177 -0
- package/scripts/test-component-state-sentinel.mjs +35 -0
- package/scripts/test-component-state-source-contract.mjs +83 -0
- package/scripts/test-consumer-conformance-sentinel.mjs +165 -0
- package/scripts/test-consumer-reference-sentinel.mjs +31 -0
- package/scripts/test-generate-consumer-reference-evidence.mjs +124 -0
- package/scripts/test-json-cli-output.mjs +151 -0
- package/scripts/test-json-schema-formats.mjs +40 -0
- package/scripts/test-reference-adapters.mjs +199 -0
- package/scripts/test-renderer-purity.mjs +34 -0
- package/scripts/test-sg-cli.mjs +129 -0
- package/scripts/test-summarize-sentinel-calibration.mjs +226 -0
- package/scripts/test-validate-baseline-manifest.mjs +234 -0
- package/scripts/test-validate-component-state-artifacts.mjs +243 -0
- package/scripts/test-validate-component-state.mjs +106 -0
- package/scripts/test-validate-consumer-conformance.mjs +427 -0
- package/scripts/test-validate-consumer-reference-cli.mjs +69 -0
- package/scripts/test-validate-consumer-reference.mjs +263 -0
- package/scripts/test-validate-domains.mjs +357 -0
- package/scripts/test-validate-governance.mjs +292 -0
- package/scripts/test-validate-ia.mjs +262 -0
- package/scripts/test-validate-okf.mjs +73 -0
- package/scripts/test-validate-page-evidence.mjs +302 -0
- package/scripts/test-validate-patterns.mjs +157 -0
- package/scripts/test-validate-promotion-rfc.mjs +250 -0
- package/scripts/test-validate-reference-profiles.mjs +170 -0
- package/scripts/test-validate-unity-org-wiki.mjs +57 -0
- package/scripts/test-validate-unity-source-contracts.mjs +67 -0
- package/scripts/test-validate-vocabulary.mjs +174 -0
- package/scripts/test-validate-webpage-workflow.mjs +293 -0
- package/scripts/validate-baseline-manifest.mjs +44 -0
- package/scripts/validate-catalog.mjs +65 -0
- package/scripts/validate-component-state.mjs +141 -0
- package/scripts/validate-consumer-conformance.mjs +477 -0
- package/scripts/validate-consumer-reference.mjs +288 -0
- package/scripts/validate-domains.mjs +237 -0
- package/scripts/validate-governance.mjs +248 -0
- package/scripts/validate-ia.mjs +136 -0
- package/scripts/validate-links.mjs +66 -0
- package/scripts/validate-okf.mjs +104 -0
- package/scripts/validate-page-evidence.mjs +191 -0
- package/scripts/validate-patterns.mjs +246 -0
- package/scripts/validate-promotion-rfc.mjs +224 -0
- package/scripts/validate-reference-artifacts.mjs +125 -0
- package/scripts/validate-renderer-purity.mjs +56 -0
- package/scripts/validate-unity-org-wiki.mjs +146 -0
- package/scripts/validate-unity-source-contracts.mjs +107 -0
- package/scripts/validate-vocabulary.mjs +115 -0
- package/scripts/validate-webpage-workflow.mjs +254 -0
- package/scripts/visual-expectation-contract.mjs +20 -0
- package/scripts/workflow-action-contract.mjs +163 -0
package/design-engineering/reference-profiles/governed-local/terminal/fixtures/button.fixture.json
ADDED
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"fixture_id": "terminal-button-runtime",
|
|
4
|
+
"component_id": "button",
|
|
5
|
+
"profile_id": "terminal-reference-profile",
|
|
6
|
+
"component_record": "../components/button.component.json",
|
|
7
|
+
"state_record": "../states/button.states.json",
|
|
8
|
+
"scenarios": [
|
|
9
|
+
{
|
|
10
|
+
"id": "action-disabled-busy",
|
|
11
|
+
"semantic_mode": "action",
|
|
12
|
+
"label": "Command unavailable",
|
|
13
|
+
"activation_key": "Enter",
|
|
14
|
+
"required_channels": [
|
|
15
|
+
"visual",
|
|
16
|
+
"dom",
|
|
17
|
+
"ax"
|
|
18
|
+
]
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"id": "action-focused",
|
|
22
|
+
"semantic_mode": "action",
|
|
23
|
+
"label": "Run command",
|
|
24
|
+
"activation_key": "Enter",
|
|
25
|
+
"required_channels": [
|
|
26
|
+
"visual",
|
|
27
|
+
"dom",
|
|
28
|
+
"ax"
|
|
29
|
+
]
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"id": "action-loading-busy",
|
|
33
|
+
"semantic_mode": "action",
|
|
34
|
+
"label": "Command running",
|
|
35
|
+
"activation_key": "Enter",
|
|
36
|
+
"required_channels": [
|
|
37
|
+
"visual",
|
|
38
|
+
"dom",
|
|
39
|
+
"ax"
|
|
40
|
+
]
|
|
41
|
+
},
|
|
42
|
+
{
|
|
43
|
+
"id": "disclosure-expanded-loading",
|
|
44
|
+
"semantic_mode": "disclosure",
|
|
45
|
+
"label": "Show process log",
|
|
46
|
+
"activation_key": "Enter",
|
|
47
|
+
"required_channels": [
|
|
48
|
+
"visual",
|
|
49
|
+
"dom",
|
|
50
|
+
"ax"
|
|
51
|
+
]
|
|
52
|
+
},
|
|
53
|
+
{
|
|
54
|
+
"id": "toggle-focused-pressed",
|
|
55
|
+
"semantic_mode": "toggle",
|
|
56
|
+
"label": "Pin output",
|
|
57
|
+
"activation_key": "Space",
|
|
58
|
+
"required_channels": [
|
|
59
|
+
"visual",
|
|
60
|
+
"dom",
|
|
61
|
+
"ax"
|
|
62
|
+
]
|
|
63
|
+
}
|
|
64
|
+
]
|
|
65
|
+
}
|
package/design-engineering/reference-profiles/governed-local/terminal/generated/evidence-coverage.md
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: Generated Evidence
|
|
3
|
+
title: "terminal button evidence coverage"
|
|
4
|
+
description: "Claim-scoped evidence channels and artifacts derived from canonical JSON."
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from canonical JSON. Do not edit. -->
|
|
8
|
+
# terminal button evidence coverage
|
|
9
|
+
|
|
10
|
+
Claim boundary: Scenario artifacts are evidence, not visual regression baselines or accessibility certification.
|
|
11
|
+
|
|
12
|
+
| Scenario | Required channels | Recorded channels | Pass records | Artifacts |
|
|
13
|
+
| --- | --- | --- | --- | --- |
|
|
14
|
+
| <code>action-disabled-busy</code> | <code>visual</code>, <code>dom</code>, <code>ax</code> | <code>ax</code>, <code>dom</code>, <code>visual</code> | 3 | <code>runtime/terminal-action-disabled-busy.ax.json</code><br><code>runtime/terminal-action-disabled-busy.dom.json</code><br><code>runtime/terminal-action-disabled-busy.png</code> |
|
|
15
|
+
| <code>action-focused</code> | <code>visual</code>, <code>dom</code>, <code>ax</code> | <code>ax</code>, <code>dom</code>, <code>visual</code> | 3 | <code>runtime/terminal-action-focused.ax.json</code><br><code>runtime/terminal-action-focused.dom.json</code><br><code>runtime/terminal-action-focused.png</code> |
|
|
16
|
+
| <code>action-loading-busy</code> | <code>visual</code>, <code>dom</code>, <code>ax</code> | <code>ax</code>, <code>dom</code>, <code>visual</code> | 3 | <code>runtime/terminal-action-loading-busy.ax.json</code><br><code>runtime/terminal-action-loading-busy.dom.json</code><br><code>runtime/terminal-action-loading-busy.png</code> |
|
|
17
|
+
| <code>disclosure-expanded-loading</code> | <code>visual</code>, <code>dom</code>, <code>ax</code> | <code>ax</code>, <code>dom</code>, <code>visual</code> | 3 | <code>runtime/terminal-disclosure-expanded-loading.ax.json</code><br><code>runtime/terminal-disclosure-expanded-loading.dom.json</code><br><code>runtime/terminal-disclosure-expanded-loading.png</code> |
|
|
18
|
+
| <code>toggle-focused-pressed</code> | <code>visual</code>, <code>dom</code>, <code>ax</code> | <code>ax</code>, <code>dom</code>, <code>visual</code> | 3 | <code>runtime/terminal-toggle-focused-pressed.ax.json</code><br><code>runtime/terminal-toggle-focused-pressed.dom.json</code><br><code>runtime/terminal-toggle-focused-pressed.png</code> |
|
|
19
|
+
|
|
20
|
+
## IA Navigation
|
|
21
|
+
|
|
22
|
+
Parent: [Keyboard Matrix](keyboard-matrix.md).
|
|
23
|
+
Next: [Reference Profiles](../../../index.md).
|
package/design-engineering/reference-profiles/governed-local/terminal/generated/keyboard-matrix.md
ADDED
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: Generated Evidence
|
|
3
|
+
title: "terminal button keyboard matrix"
|
|
4
|
+
description: "Keyboard behavior and live fixture coverage derived from canonical JSON."
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from canonical JSON. Do not edit. -->
|
|
8
|
+
# terminal button keyboard matrix
|
|
9
|
+
|
|
10
|
+
| Mode | Element | Role | Keys | Behavior | Runtime scenario |
|
|
11
|
+
| --- | --- | --- | --- | --- | --- |
|
|
12
|
+
| <code>action</code> | button | button | <code>Enter</code>, <code>Space</code> | <code>invoke</code> | <code>action-loading-busy</code> |
|
|
13
|
+
| <code>disclosure</code> | button | button | <code>Enter</code>, <code>Space</code> | <code>control</code> | <code>disclosure-expanded-loading</code> |
|
|
14
|
+
| <code>toggle</code> | button | button | <code>Enter</code>, <code>Space</code> | <code>toggle</code> | <code>toggle-focused-pressed</code> |
|
|
15
|
+
|
|
16
|
+
## IA Navigation
|
|
17
|
+
|
|
18
|
+
Parent: [State Matrix](state-matrix.md).
|
|
19
|
+
Next: [Evidence Coverage](evidence-coverage.md).
|
package/design-engineering/reference-profiles/governed-local/terminal/generated/state-matrix.md
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: Generated Evidence
|
|
3
|
+
title: "terminal button state matrix"
|
|
4
|
+
description: "Compound state sets and channel expectations derived from canonical JSON."
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
<!-- Generated from canonical JSON. Do not edit. -->
|
|
8
|
+
# terminal button state matrix
|
|
9
|
+
|
|
10
|
+
| Scenario | Mode | State set | ARIA | Visual | Activation |
|
|
11
|
+
| --- | --- | --- | --- | --- | --- |
|
|
12
|
+
| <code>action-disabled-busy</code> | action | <code>busy</code>, <code>disabled</code> | <code>aria-busy=true</code><br><code>aria-disabled=true</code> | <code>busy</code>, <code>disabled</code> | suppressed |
|
|
13
|
+
| <code>action-focused</code> | action | <code>focus</code> | none | <code>focus</code>, <code>ready</code> | allowed |
|
|
14
|
+
| <code>action-loading-busy</code> | action | <code>busy</code>, <code>focus</code>, <code>loading</code> | <code>aria-busy=true</code> | <code>busy</code>, <code>focus</code>, <code>loading</code> | suppressed |
|
|
15
|
+
| <code>disclosure-expanded-loading</code> | disclosure | <code>busy</code>, <code>expanded</code>, <code>focus</code>, <code>loading</code> | <code>aria-busy=true</code><br><code>aria-expanded=true</code> | <code>busy</code>, <code>expanded</code>, <code>focus</code>, <code>loading</code> | allowed |
|
|
16
|
+
| <code>toggle-focused-pressed</code> | toggle | <code>focus</code>, <code>pressed</code> | <code>aria-pressed=true</code> | <code>focus</code>, <code>pressed</code> | allowed |
|
|
17
|
+
|
|
18
|
+
## IA Navigation
|
|
19
|
+
|
|
20
|
+
Parent: [Governed Local Profiles](../../index.md).
|
|
21
|
+
Next: [Keyboard Matrix](keyboard-matrix.md).
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
{
|
|
2
|
+
"bindings": {
|
|
3
|
+
"accent": "{color.accent}",
|
|
4
|
+
"body_font_family": "SFMono-Regular, Consolas, monospace",
|
|
5
|
+
"canvas": "{color.screen}",
|
|
6
|
+
"content_rhythm": "{space.rhythm}",
|
|
7
|
+
"text": "{color.ink}"
|
|
8
|
+
},
|
|
9
|
+
"identity": "Dark high-density operator terminal",
|
|
10
|
+
"profile_id": "terminal-reference-profile",
|
|
11
|
+
"schema_version": "1.0"
|
|
12
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"artifact_mode": "governed_local",
|
|
3
|
+
"component_records": ["components/button.component.json"],
|
|
4
|
+
"default": false,
|
|
5
|
+
"environment_assumptions": {
|
|
6
|
+
"reset": {
|
|
7
|
+
"body_margin": "0",
|
|
8
|
+
"box_sizing": "border-box",
|
|
9
|
+
"figure_margin": "0"
|
|
10
|
+
},
|
|
11
|
+
"user_agent_styles": "Preserve semantic browser defaults except for the declared reset."
|
|
12
|
+
},
|
|
13
|
+
"example_only": true,
|
|
14
|
+
"evidence_records": ["evidence/button.evidence.json"],
|
|
15
|
+
"fixture_independence": "related",
|
|
16
|
+
"fixture_records": ["fixtures/button.fixture.json"],
|
|
17
|
+
"generated_records": ["generated/evidence-coverage.md", "generated/keyboard-matrix.md", "generated/state-matrix.md"],
|
|
18
|
+
"handoff": {
|
|
19
|
+
"record": "design-engineering/reference-profiles/governed-local/terminal/profile.json",
|
|
20
|
+
"status": "declared"
|
|
21
|
+
},
|
|
22
|
+
"id": "terminal-reference-profile",
|
|
23
|
+
"layout_source_sha": "775430bbaf4ee208a642220f440f6926d79c90a3",
|
|
24
|
+
"local_foundations": "local-foundations.json",
|
|
25
|
+
"maturity": "experimental",
|
|
26
|
+
"owner": {
|
|
27
|
+
"enforcement": "placeholder",
|
|
28
|
+
"name": "Design Engineering owner"
|
|
29
|
+
},
|
|
30
|
+
"profile_kind": "governed_local",
|
|
31
|
+
"related_fixture_set_id": "layout-identity-adversarial-pair",
|
|
32
|
+
"review_independence": "single_account",
|
|
33
|
+
"schema_version": "1.0",
|
|
34
|
+
"selection": {
|
|
35
|
+
"method": "profile_path",
|
|
36
|
+
"required": true
|
|
37
|
+
},
|
|
38
|
+
"support": {
|
|
39
|
+
"status": "active"
|
|
40
|
+
},
|
|
41
|
+
"state_records": ["states/button.states.json"],
|
|
42
|
+
"tokens": "tokens.dtcg.json"
|
|
43
|
+
}
|
package/design-engineering/reference-profiles/governed-local/terminal/states/button.states.json
ADDED
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schema_version": "1.0",
|
|
3
|
+
"record_kind": "state_set",
|
|
4
|
+
"component_id": "button",
|
|
5
|
+
"profile_id": "terminal-reference-profile",
|
|
6
|
+
"visual_environments": [
|
|
7
|
+
{
|
|
8
|
+
"id": "darwin-arm64-chromium-1228",
|
|
9
|
+
"browser": "Google Chrome for Testing 149.0.7827.55",
|
|
10
|
+
"browser_revision": "chromium-1228",
|
|
11
|
+
"container_image": "local-host:25.5.0",
|
|
12
|
+
"platform": "darwin/arm64",
|
|
13
|
+
"playwright": "1.61.0",
|
|
14
|
+
"viewport": "1024x768"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"id": "linux-amd64-chromium-1228",
|
|
18
|
+
"browser": "Google Chrome for Testing 149.0.7827.55",
|
|
19
|
+
"browser_revision": "chromium-1228",
|
|
20
|
+
"container_image": "mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a",
|
|
21
|
+
"platform": "linux/amd64",
|
|
22
|
+
"playwright": "1.61.0",
|
|
23
|
+
"viewport": "1024x768"
|
|
24
|
+
}
|
|
25
|
+
],
|
|
26
|
+
"scenarios": [
|
|
27
|
+
{
|
|
28
|
+
"id": "action-disabled-busy",
|
|
29
|
+
"semantic_mode": "action",
|
|
30
|
+
"states": [
|
|
31
|
+
"busy",
|
|
32
|
+
"disabled"
|
|
33
|
+
],
|
|
34
|
+
"aria": {
|
|
35
|
+
"busy": "true",
|
|
36
|
+
"disabled": "true"
|
|
37
|
+
},
|
|
38
|
+
"expected": {
|
|
39
|
+
"visual": [
|
|
40
|
+
"busy",
|
|
41
|
+
"disabled"
|
|
42
|
+
],
|
|
43
|
+
"visual_image": [
|
|
44
|
+
{ "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:d346be9e96750f636f29078d17d9871a04c2f4442b6849b029fa754c2795674e", "width": 640, "height": 56 },
|
|
45
|
+
{ "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:f28ac192821773d5d692ad978075da5b1480971e3b3bc9be8983e3eb2cd43484", "width": 640, "height": 56 }
|
|
46
|
+
],
|
|
47
|
+
"dom": {
|
|
48
|
+
"active": "false",
|
|
49
|
+
"aria-busy": "true",
|
|
50
|
+
"disabled": "true",
|
|
51
|
+
"role": "button"
|
|
52
|
+
},
|
|
53
|
+
"ax": {
|
|
54
|
+
"busy": true,
|
|
55
|
+
"disabled": true,
|
|
56
|
+
"focused": false,
|
|
57
|
+
"role": "button"
|
|
58
|
+
},
|
|
59
|
+
"activation": "suppressed"
|
|
60
|
+
}
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"id": "action-focused",
|
|
64
|
+
"semantic_mode": "action",
|
|
65
|
+
"states": [
|
|
66
|
+
"focus"
|
|
67
|
+
],
|
|
68
|
+
"aria": {},
|
|
69
|
+
"expected": {
|
|
70
|
+
"visual": [
|
|
71
|
+
"focus",
|
|
72
|
+
"ready"
|
|
73
|
+
],
|
|
74
|
+
"visual_image": [
|
|
75
|
+
{ "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:39b96bc2459e2f0f442ce7b709f22e46b44f49b17c52d61940dff0246108ec48", "width": 640, "height": 56 },
|
|
76
|
+
{ "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:7497f0542e2a4b77749ee47cfa7f575b640bad737c652a71610e9f86f8e5f2b8", "width": 640, "height": 56 }
|
|
77
|
+
],
|
|
78
|
+
"dom": {
|
|
79
|
+
"active": "true",
|
|
80
|
+
"role": "button"
|
|
81
|
+
},
|
|
82
|
+
"ax": {
|
|
83
|
+
"focused": true,
|
|
84
|
+
"role": "button"
|
|
85
|
+
},
|
|
86
|
+
"activation": "allowed"
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"id": "action-loading-busy",
|
|
91
|
+
"semantic_mode": "action",
|
|
92
|
+
"states": [
|
|
93
|
+
"busy",
|
|
94
|
+
"focus",
|
|
95
|
+
"loading"
|
|
96
|
+
],
|
|
97
|
+
"aria": {
|
|
98
|
+
"busy": "true"
|
|
99
|
+
},
|
|
100
|
+
"expected": {
|
|
101
|
+
"visual": [
|
|
102
|
+
"busy",
|
|
103
|
+
"focus",
|
|
104
|
+
"loading"
|
|
105
|
+
],
|
|
106
|
+
"visual_image": [
|
|
107
|
+
{ "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:05cbe173a8274cfa7e6aab05713d1cb925820a7412bffceadb94d83498c17747", "width": 640, "height": 56 },
|
|
108
|
+
{ "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:1521023b829210f899d2f56750e362cbfc30e8d6045f6f78a6c553a43bf610c4", "width": 640, "height": 56 }
|
|
109
|
+
],
|
|
110
|
+
"dom": {
|
|
111
|
+
"active": "true",
|
|
112
|
+
"aria-busy": "true",
|
|
113
|
+
"role": "button"
|
|
114
|
+
},
|
|
115
|
+
"ax": {
|
|
116
|
+
"busy": true,
|
|
117
|
+
"focused": true,
|
|
118
|
+
"role": "button"
|
|
119
|
+
},
|
|
120
|
+
"activation": "suppressed"
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
"id": "disclosure-expanded-loading",
|
|
125
|
+
"semantic_mode": "disclosure",
|
|
126
|
+
"states": [
|
|
127
|
+
"busy",
|
|
128
|
+
"expanded",
|
|
129
|
+
"focus",
|
|
130
|
+
"loading"
|
|
131
|
+
],
|
|
132
|
+
"aria": {
|
|
133
|
+
"busy": "true",
|
|
134
|
+
"expanded": "true"
|
|
135
|
+
},
|
|
136
|
+
"expected": {
|
|
137
|
+
"visual": [
|
|
138
|
+
"busy",
|
|
139
|
+
"expanded",
|
|
140
|
+
"focus",
|
|
141
|
+
"loading"
|
|
142
|
+
],
|
|
143
|
+
"visual_image": [
|
|
144
|
+
{ "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:d8c7ba056dd2a61ce6c85d8ec6bf56733cdc34da07678dd9b4175c7de9ab926a", "width": 640, "height": 88 },
|
|
145
|
+
{ "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:7cef4e68a5a3df50c1705c7b88936bf0988317e2f6bed92ae5c04992388126a3", "width": 640, "height": 91 }
|
|
146
|
+
],
|
|
147
|
+
"dom": {
|
|
148
|
+
"active": "true",
|
|
149
|
+
"aria-busy": "true",
|
|
150
|
+
"aria-expanded": "true",
|
|
151
|
+
"role": "button"
|
|
152
|
+
},
|
|
153
|
+
"ax": {
|
|
154
|
+
"busy": true,
|
|
155
|
+
"expanded": true,
|
|
156
|
+
"focused": true,
|
|
157
|
+
"role": "button"
|
|
158
|
+
},
|
|
159
|
+
"activation": "allowed"
|
|
160
|
+
}
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"id": "toggle-focused-pressed",
|
|
164
|
+
"semantic_mode": "toggle",
|
|
165
|
+
"states": [
|
|
166
|
+
"focus",
|
|
167
|
+
"pressed"
|
|
168
|
+
],
|
|
169
|
+
"aria": {
|
|
170
|
+
"pressed": "true"
|
|
171
|
+
},
|
|
172
|
+
"expected": {
|
|
173
|
+
"visual": [
|
|
174
|
+
"focus",
|
|
175
|
+
"pressed"
|
|
176
|
+
],
|
|
177
|
+
"visual_image": [
|
|
178
|
+
{ "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:838229be984b8bda1ebfe6095564f1093df18fdd2ca1e6c3d5b5c086162d4692", "width": 640, "height": 56 },
|
|
179
|
+
{ "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:1c105821f16a028e974bdf00590e3d9aee8042016ee341f4efe56b4a525b867d", "width": 640, "height": 56 }
|
|
180
|
+
],
|
|
181
|
+
"dom": {
|
|
182
|
+
"active": "true",
|
|
183
|
+
"aria-pressed": "true",
|
|
184
|
+
"role": "button"
|
|
185
|
+
},
|
|
186
|
+
"ax": {
|
|
187
|
+
"focused": true,
|
|
188
|
+
"pressed": true,
|
|
189
|
+
"role": "button"
|
|
190
|
+
},
|
|
191
|
+
"activation": "allowed"
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
]
|
|
195
|
+
}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"color": {
|
|
3
|
+
"$type": "color",
|
|
4
|
+
"accent": { "$value": { "alpha": 1, "colorSpace": "srgb", "components": [0.25, 0.92, 0.55] } },
|
|
5
|
+
"ink": { "$value": { "alpha": 1, "colorSpace": "srgb", "components": [0.76, 0.95, 0.83] } },
|
|
6
|
+
"screen": { "$value": { "alpha": 1, "colorSpace": "srgb", "components": [0.02, 0.05, 0.04] } }
|
|
7
|
+
},
|
|
8
|
+
"duration": {
|
|
9
|
+
"$type": "duration",
|
|
10
|
+
"feedback": { "$value": { "unit": "ms", "value": 80 } }
|
|
11
|
+
},
|
|
12
|
+
"space": {
|
|
13
|
+
"$type": "dimension",
|
|
14
|
+
"page": { "$value": { "unit": "rem", "value": 1 } },
|
|
15
|
+
"rhythm": { "$value": { "unit": "rem", "value": 0.5 } }
|
|
16
|
+
}
|
|
17
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Design Engineering Reference Profiles
|
|
2
|
+
|
|
3
|
+
Domain classification: design-engineering.
|
|
4
|
+
|
|
5
|
+
These experimental examples challenge the consumer-reference contract with intentionally different identities over the same pinned Layout source. They are related adversarial fixtures, not defaults, canonical guidance, production consumers, or independent adoption evidence.
|
|
6
|
+
|
|
7
|
+
## Routes
|
|
8
|
+
|
|
9
|
+
- [Governed Local Profiles](governed-local/index.md) explains the two explicitly selected repository-owned examples.
|
|
10
|
+
- [External Adaptation](external-adaptation/index.md) explains how external consumers retain their records without creating an in-repository adopter record.
|
|
11
|
+
|
|
12
|
+
## Ownership Boundary
|
|
13
|
+
|
|
14
|
+
Design Engineering owns profile identity and values. Consumer Reference validates shape and provenance without owning those values. Layout remains upstream and cannot import these records.
|
|
15
|
+
|
|
16
|
+
## IA Navigation
|
|
17
|
+
|
|
18
|
+
Parent: [Design Engineering](../index.md).
|
|
19
|
+
Next: [Governed Local Profiles](governed-local/index.md).
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: Domain Guide
|
|
3
|
+
title: Game UI Classification
|
|
4
|
+
description: Engine-neutral method for classifying game interfaces by player task, presentation, input, state, and motion.
|
|
5
|
+
domain: game-ui
|
|
6
|
+
lifecycle: experimental
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Game UI Classification
|
|
10
|
+
|
|
11
|
+
Primary role: game-interface classification guide.
|
|
12
|
+
|
|
13
|
+
## Repository Boundary
|
|
14
|
+
|
|
15
|
+
This guide proposes a local, project-neutral taxonomy for classifying observable game-interface behavior without assuming a specific engine or art direction. Its player-task classes and classification axes are review tools, not a universal ontology. It does not turn a visual genre into a functional category or authorize decorative properties in reusable Layout patterns.
|
|
16
|
+
|
|
17
|
+
## Reusable Method
|
|
18
|
+
|
|
19
|
+
1. Capture the rendered screen or interaction in context.
|
|
20
|
+
2. Assign one primary player-task class.
|
|
21
|
+
3. Add secondary classes only when the same surface genuinely composes responsibilities.
|
|
22
|
+
4. Record visual language, input, state, motion, and implementation as separate axes.
|
|
23
|
+
5. Attach evidence for default, exceptional, and transitional states.
|
|
24
|
+
6. State what is observed, inferred, and still unverified.
|
|
25
|
+
|
|
26
|
+
## Player-Task Classes
|
|
27
|
+
|
|
28
|
+
| Primary class | Player question | Typical examples |
|
|
29
|
+
| --- | --- | --- |
|
|
30
|
+
| `hud` | What is happening during play right now? | Health, ammo, objective, marker, cooldown |
|
|
31
|
+
| `navigation` | Where can I go next? | Main menu, pause menu, chapter or mode selection |
|
|
32
|
+
| `dialog` | What decision or interruption needs attention? | Confirmation, reconnect, privacy, system notice |
|
|
33
|
+
| `inventory` | What do I own, equip, compare, or improve? | Loadout, stash, equipment, crafting, upgrade |
|
|
34
|
+
| `progression` | What did I unlock or how am I advancing? | Results, level up, rewards, rank change |
|
|
35
|
+
| `commerce` | What can I acquire and at what cost? | Shop, offer, product detail, currency shortage |
|
|
36
|
+
| `tutorial` | What action should I learn or perform? | Coach mark, forced step, contextual hint |
|
|
37
|
+
| `narrative` | What story or authored event is being presented? | Dialogue, boss intro, cinematic overlay |
|
|
38
|
+
| `system-status` | Is the application ready and connected? | Splash, loading, sign-in, reconnect, patch status |
|
|
39
|
+
| `input-surface` | How do I directly control the game? | Virtual stick, action button, key binding |
|
|
40
|
+
|
|
41
|
+
## Classification Axes
|
|
42
|
+
|
|
43
|
+
| Axis | Example values | Evidence requirement |
|
|
44
|
+
| --- | --- | --- |
|
|
45
|
+
| World relationship | `diegetic`, `spatial`, `overlay`, `full-screen` | Capture placement relative to play space |
|
|
46
|
+
| Material character | `flat-graphic`, `framed`, `skeuomorphic`, `translucent`, `textural` | Capture repeated surface treatment |
|
|
47
|
+
| Genre signal | `tactical`, `industrial`, `fantasy-ornamental`, `arcade`, `horror`, `casual` | Show repeated shape, type, icon, and material cues |
|
|
48
|
+
| Information density | `sparse`, `standard`, `dense` | Count simultaneous choices and information groups |
|
|
49
|
+
| Emphasis model | `typographic`, `icon-led`, `character-led`, `item-led`, `effect-led` | Identify first and second attention targets |
|
|
50
|
+
| Input | pointer, keyboard, gamepad, touch, gaze, mixed | Exercise every declared input mode |
|
|
51
|
+
| Motion role | affordance, activation, state change, transition, value change, reward, guidance, ambient | Record trigger, properties, timing, and interruption |
|
|
52
|
+
|
|
53
|
+
## Opinionated Guidance
|
|
54
|
+
|
|
55
|
+
- Organize the gallery first by player task, then filter by presentation and implementation axes.
|
|
56
|
+
- Use two or three visual tags supported by repeated evidence.
|
|
57
|
+
- Classify independent player-task regions separately when a screen composes them.
|
|
58
|
+
- Do not infer style or behavior from project, prefab, widget, scene, or class names alone.
|
|
59
|
+
|
|
60
|
+
## Platform-Specific Guidance
|
|
61
|
+
|
|
62
|
+
Record engine, UI framework, render space, scaling policy, navigation system, text system, and motion system as implementation evidence. Route detailed engine hierarchy and API guidance to the matching engine-specific Game UI guide.
|
|
63
|
+
|
|
64
|
+
## Unsupported Absolutes
|
|
65
|
+
|
|
66
|
+
- A genre label does not establish a visual style.
|
|
67
|
+
- A screenshot does not prove responsive behavior, focus behavior, or motion interruption.
|
|
68
|
+
- A production project's folder structure is not a universal architecture.
|
|
69
|
+
- Similar appearance does not prove equivalent accessibility, performance, or interaction behavior.
|
|
70
|
+
|
|
71
|
+
## Verification Contract
|
|
72
|
+
|
|
73
|
+
Verify narrow and wide surfaces, every declared input mode, long localized text, empty and loading states, disabled and error states, repeated open and close, rapid selection changes, and interrupted motion where relevant.
|
|
74
|
+
|
|
75
|
+
## Source, License, And Attribution
|
|
76
|
+
|
|
77
|
+
This page is a locally authored, project-neutral proposed taxonomy. It reproduces no game assets, project-specific hierarchy, or upstream implementation samples.
|
|
78
|
+
|
|
79
|
+
## IA Navigation
|
|
80
|
+
|
|
81
|
+
Parent: [Game UI](index.md).
|
|
82
|
+
Next: [Game UI Screen Hierarchy](screen-hierarchy.md).
|
package/game-ui/index.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Game UI
|
|
2
|
+
|
|
3
|
+
Game UI owns engine-neutral guidance for game-interface purpose, presentation, screen hierarchy, and evidence records, plus named engine implementation guides.
|
|
4
|
+
|
|
5
|
+
## Scope Boundary
|
|
6
|
+
|
|
7
|
+
In scope: player-task classification, screen and overlay hierarchy, reusable reference metadata, state coverage, cross-engine comparison vocabulary, and engine-specific implementation guidance.
|
|
8
|
+
|
|
9
|
+
Out of scope: reusable Layout CSS, universal visual prescriptions, and treating one engine's scene graph or API as a cross-engine requirement.
|
|
10
|
+
|
|
11
|
+
## Evidence And Research Boundary
|
|
12
|
+
|
|
13
|
+
The player-task classes and classification axes are a local taxonomy proposed for StyleGallery review, not Interface In Game's universal ontology.
|
|
14
|
+
|
|
15
|
+
Interface In Game was reviewed on 2026-07-14 through its [home page](https://interfaceingame.com/), [games index](https://interfaceingame.com/games/), and representative records for [Team Fortress 2](https://interfaceingame.com/games/team-fortress-2/), [Genshin Impact (Mobile)](https://interfaceingame.com/games/genshin-impact-mobile/), and [Gris](https://interfaceingame.com/games/gris/). In this bounded sample, the site exposed site-local facets such as Genres, Themes, and Platforms, while screenshots used Elements. The sample informs the local separation of player task from other axes; it does not cover the archive or establish the site's full information model.
|
|
16
|
+
|
|
17
|
+
## Available Guides
|
|
18
|
+
|
|
19
|
+
- [Game UI Classification](classification.md) separates player purpose from visual language, input, state, and motion.
|
|
20
|
+
- [Game UI Screen Hierarchy](screen-hierarchy.md) defines engine-neutral layers from application shell to atomic control.
|
|
21
|
+
- [Game UI Reference Record](reference-record.md) provides the minimum evidence schema for gallery entries.
|
|
22
|
+
- [Unity UI Architecture](unity/architecture.md) maps the hierarchy roles to Unity Scenes, Canvas layers, prefabs, runtime instances, input, and motion ownership.
|
|
23
|
+
- [Unity UI Systems](unity/ui-systems.md) compares uGUI, UI Toolkit, and NGUI ownership and capability shapes at pinned sources.
|
|
24
|
+
- [Unity CLI Loop](unity/cli-loop.md) defines a source-pinned command loop for Unity UI inspection and stack-specific interaction evidence.
|
|
25
|
+
- [Unity Repository Map](unity/repository-map.md) maps the public Unity-Technologies repository snapshot by UI relevance, authority, and lifecycle.
|
|
26
|
+
- [Unity Organization Compressed Wiki](unity/org-wiki.md) routes all 804 captured public repositories through a tracked inventory and bounded exclusive clusters.
|
|
27
|
+
|
|
28
|
+
## Domain Contract
|
|
29
|
+
|
|
30
|
+
Game UI describes interface purpose, screen composition, and how named engines can realize that model. Platform Guides cover non-game platform conventions; Layout owns portable spatial patterns.
|
|
31
|
+
|
|
32
|
+
## IA Navigation
|
|
33
|
+
|
|
34
|
+
Parent: [StyleGallery](../index.md).
|
|
35
|
+
Next: [Game UI Classification](classification.md).
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: Domain Guide
|
|
3
|
+
title: Game UI Reference Record
|
|
4
|
+
description: Minimum evidence record for adding a game-interface reference to StyleGallery.
|
|
5
|
+
domain: game-ui
|
|
6
|
+
lifecycle: experimental
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Game UI Reference Record
|
|
10
|
+
|
|
11
|
+
Primary role: gallery evidence template.
|
|
12
|
+
|
|
13
|
+
## Repository Boundary
|
|
14
|
+
|
|
15
|
+
This record captures enough context to compare a game UI reference without importing its assets, source hierarchy, or implementation assumptions as gallery policy.
|
|
16
|
+
|
|
17
|
+
## Reusable Method
|
|
18
|
+
|
|
19
|
+
Complete the record from rendered evidence first, then add hierarchy and implementation facts. Mark unknown fields instead of guessing from names.
|
|
20
|
+
|
|
21
|
+
## Minimum Record
|
|
22
|
+
|
|
23
|
+
| Field | Required content |
|
|
24
|
+
| --- | --- |
|
|
25
|
+
| Identity | Entry name, source, capture date, source revision or version |
|
|
26
|
+
| Player task | One primary class and justified secondary classes |
|
|
27
|
+
| Presentation | Two or three visual-language tags with rendered evidence |
|
|
28
|
+
| Hierarchy | Root, layer, screen, region, component, and control ownership |
|
|
29
|
+
| Platform | Engine, UI framework, relevant package or runtime versions |
|
|
30
|
+
| Surface | Render space, aspect ratios, safe area, scaling policy |
|
|
31
|
+
| Input | Supported modes, initial focus, navigation, cancellation, focus return |
|
|
32
|
+
| States | Default, selected, disabled, loading, error, empty, modal |
|
|
33
|
+
| Motion | Role, trigger, properties, timing, interruption, completion |
|
|
34
|
+
| Evidence | Screen capture, recording, hierarchy capture, relevant source paths |
|
|
35
|
+
| Boundary | Observed facts, inferences, unknowns, and reuse restrictions |
|
|
36
|
+
|
|
37
|
+
## Opinionated Guidance
|
|
38
|
+
|
|
39
|
+
Prefer a complete record to a large screenshot collection missing state, hierarchy, or input evidence. It must explain the classification and what remains unproven.
|
|
40
|
+
|
|
41
|
+
## Platform-Specific Guidance
|
|
42
|
+
|
|
43
|
+
Use the matching engine-specific Game UI guide to fill implementation fields. Engine terms supplement this record; they do not replace the engine-neutral player-task and hierarchy roles.
|
|
44
|
+
|
|
45
|
+
## Unsupported Absolutes
|
|
46
|
+
|
|
47
|
+
- A source path is not rendered evidence.
|
|
48
|
+
- A polished capture is not proof of edge-state behavior.
|
|
49
|
+
- A single aspect ratio or input mode is not broad platform coverage.
|
|
50
|
+
|
|
51
|
+
## Verification Contract
|
|
52
|
+
|
|
53
|
+
Reject an entry if its primary player task, rendered state, source identity, or evidence boundary is unknown. Keep incomplete entries in draft; do not infer missing facts.
|
|
54
|
+
|
|
55
|
+
## Source, License, And Attribution
|
|
56
|
+
|
|
57
|
+
Record source licensing and reuse restrictions per entry. Do not copy protected game assets into the repository merely to make the record self-contained.
|
|
58
|
+
|
|
59
|
+
## IA Navigation
|
|
60
|
+
|
|
61
|
+
Parent: [Game UI](index.md).
|
|
62
|
+
Next: [Unity UI Architecture](unity/architecture.md).
|