stylegallery 0.1.0 → 0.1.1

package/design-engineering/reference-profiles/governed-local/terminal/fixtures/button.fixture.json

@@ -1,65 +0,0 @@
-{
-  "schema_version": "1.0",
-  "fixture_id": "terminal-button-runtime",
-  "component_id": "button",
-  "profile_id": "terminal-reference-profile",
-  "component_record": "../components/button.component.json",
-  "state_record": "../states/button.states.json",
-  "scenarios": [
-    {
-      "id": "action-disabled-busy",
-      "semantic_mode": "action",
-      "label": "Command unavailable",
-      "activation_key": "Enter",
-      "required_channels": [
-        "visual",
-        "dom",
-        "ax"
-      ]
-    },
-    {
-      "id": "action-focused",
-      "semantic_mode": "action",
-      "label": "Run command",
-      "activation_key": "Enter",
-      "required_channels": [
-        "visual",
-        "dom",
-        "ax"
-      ]
-    },
-    {
-      "id": "action-loading-busy",
-      "semantic_mode": "action",
-      "label": "Command running",
-      "activation_key": "Enter",
-      "required_channels": [
-        "visual",
-        "dom",
-        "ax"
-      ]
-    },
-    {
-      "id": "disclosure-expanded-loading",
-      "semantic_mode": "disclosure",
-      "label": "Show process log",
-      "activation_key": "Enter",
-      "required_channels": [
-        "visual",
-        "dom",
-        "ax"
-      ]
-    },
-    {
-      "id": "toggle-focused-pressed",
-      "semantic_mode": "toggle",
-      "label": "Pin output",
-      "activation_key": "Space",
-      "required_channels": [
-        "visual",
-        "dom",
-        "ax"
-      ]
-    }
-  ]
-}

package/design-engineering/reference-profiles/governed-local/terminal/generated/evidence-coverage.md

@@ -1,23 +0,0 @@
----
-type: Generated Evidence
-title: "terminal button evidence coverage"
-description: "Claim-scoped evidence channels and artifacts derived from canonical JSON."
----
-
-<!-- Generated from canonical JSON. Do not edit. -->
-# terminal button evidence coverage
-
-Claim boundary: Scenario artifacts are evidence, not visual regression baselines or accessibility certification.
-
-| Scenario | Required channels | Recorded channels | Pass records | Artifacts |
-| --- | --- | --- | --- | --- |
-| <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> |
-| <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> |
-| <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> |
-| <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> |
-| <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> |
-
-## IA Navigation
-
-Parent: [Keyboard Matrix](keyboard-matrix.md).
-Next: [Reference Profiles](../../../index.md).

package/design-engineering/reference-profiles/governed-local/terminal/generated/keyboard-matrix.md

@@ -1,19 +0,0 @@
----
-type: Generated Evidence
-title: "terminal button keyboard matrix"
-description: "Keyboard behavior and live fixture coverage derived from canonical JSON."
----
-
-<!-- Generated from canonical JSON. Do not edit. -->
-# terminal button keyboard matrix
-
-| Mode | Element | Role | Keys | Behavior | Runtime scenario |
-| --- | --- | --- | --- | --- | --- |
-| <code>action</code> | button | button | <code>Enter</code>, <code>Space</code> | <code>invoke</code> | <code>action-loading-busy</code> |
-| <code>disclosure</code> | button | button | <code>Enter</code>, <code>Space</code> | <code>control</code> | <code>disclosure-expanded-loading</code> |
-| <code>toggle</code> | button | button | <code>Enter</code>, <code>Space</code> | <code>toggle</code> | <code>toggle-focused-pressed</code> |
-
-## IA Navigation
-
-Parent: [State Matrix](state-matrix.md).
-Next: [Evidence Coverage](evidence-coverage.md).

package/design-engineering/reference-profiles/governed-local/terminal/generated/state-matrix.md

@@ -1,21 +0,0 @@
----
-type: Generated Evidence
-title: "terminal button state matrix"
-description: "Compound state sets and channel expectations derived from canonical JSON."
----
-
-<!-- Generated from canonical JSON. Do not edit. -->
-# terminal button state matrix
-
-| Scenario | Mode | State set | ARIA | Visual | Activation |
-| --- | --- | --- | --- | --- | --- |
-| <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 |
-| <code>action-focused</code> | action | <code>focus</code> | none | <code>focus</code>, <code>ready</code> | allowed |
-| <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 |
-| <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 |
-| <code>toggle-focused-pressed</code> | toggle | <code>focus</code>, <code>pressed</code> | <code>aria-pressed=true</code> | <code>focus</code>, <code>pressed</code> | allowed |
-
-## IA Navigation
-
-Parent: [Governed Local Profiles](../../index.md).
-Next: [Keyboard Matrix](keyboard-matrix.md).

package/design-engineering/reference-profiles/governed-local/terminal/local-foundations.json

@@ -1,12 +0,0 @@
-{
-  "bindings": {
-    "accent": "{color.accent}",
-    "body_font_family": "SFMono-Regular, Consolas, monospace",
-    "canvas": "{color.screen}",
-    "content_rhythm": "{space.rhythm}",
-    "text": "{color.ink}"
-  },
-  "identity": "Dark high-density operator terminal",
-  "profile_id": "terminal-reference-profile",
-  "schema_version": "1.0"
-}

package/design-engineering/reference-profiles/governed-local/terminal/profile.json

@@ -1,43 +0,0 @@
-{
-  "artifact_mode": "governed_local",
-  "component_records": ["components/button.component.json"],
-  "default": false,
-  "environment_assumptions": {
-    "reset": {
-      "body_margin": "0",
-      "box_sizing": "border-box",
-      "figure_margin": "0"
-    },
-    "user_agent_styles": "Preserve semantic browser defaults except for the declared reset."
-  },
-  "example_only": true,
-  "evidence_records": ["evidence/button.evidence.json"],
-  "fixture_independence": "related",
-  "fixture_records": ["fixtures/button.fixture.json"],
-  "generated_records": ["generated/evidence-coverage.md", "generated/keyboard-matrix.md", "generated/state-matrix.md"],
-  "handoff": {
-    "record": "design-engineering/reference-profiles/governed-local/terminal/profile.json",
-    "status": "declared"
-  },
-  "id": "terminal-reference-profile",
-  "layout_source_sha": "775430bbaf4ee208a642220f440f6926d79c90a3",
-  "local_foundations": "local-foundations.json",
-  "maturity": "experimental",
-  "owner": {
-    "enforcement": "placeholder",
-    "name": "Design Engineering owner"
-  },
-  "profile_kind": "governed_local",
-  "related_fixture_set_id": "layout-identity-adversarial-pair",
-  "review_independence": "single_account",
-  "schema_version": "1.0",
-  "selection": {
-    "method": "profile_path",
-    "required": true
-  },
-  "support": {
-    "status": "active"
-  },
-  "state_records": ["states/button.states.json"],
-  "tokens": "tokens.dtcg.json"
-}

package/design-engineering/reference-profiles/governed-local/terminal/states/button.states.json

@@ -1,195 +0,0 @@
-{
-  "schema_version": "1.0",
-  "record_kind": "state_set",
-  "component_id": "button",
-  "profile_id": "terminal-reference-profile",
-  "visual_environments": [
-    {
-      "id": "darwin-arm64-chromium-1228",
-      "browser": "Google Chrome for Testing 149.0.7827.55",
-      "browser_revision": "chromium-1228",
-      "container_image": "local-host:25.5.0",
-      "platform": "darwin/arm64",
-      "playwright": "1.61.0",
-      "viewport": "1024x768"
-    },
-    {
-      "id": "linux-amd64-chromium-1228",
-      "browser": "Google Chrome for Testing 149.0.7827.55",
-      "browser_revision": "chromium-1228",
-      "container_image": "mcr.microsoft.com/playwright:v1.61.0-noble@sha256:57b65fdc9ceabe0ef613124c7bbe2babcf9362c4d85e382fe3b03604e84b428a",
-      "platform": "linux/amd64",
-      "playwright": "1.61.0",
-      "viewport": "1024x768"
-    }
-  ],
-  "scenarios": [
-    {
-      "id": "action-disabled-busy",
-      "semantic_mode": "action",
-      "states": [
-        "busy",
-        "disabled"
-      ],
-      "aria": {
-        "busy": "true",
-        "disabled": "true"
-      },
-      "expected": {
-        "visual": [
-          "busy",
-          "disabled"
-        ],
-        "visual_image": [
-          { "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:d346be9e96750f636f29078d17d9871a04c2f4442b6849b029fa754c2795674e", "width": 640, "height": 56 },
-          { "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:f28ac192821773d5d692ad978075da5b1480971e3b3bc9be8983e3eb2cd43484", "width": 640, "height": 56 }
-        ],
-        "dom": {
-          "active": "false",
-          "aria-busy": "true",
-          "disabled": "true",
-          "role": "button"
-        },
-        "ax": {
-          "busy": true,
-          "disabled": true,
-          "focused": false,
-          "role": "button"
-        },
-        "activation": "suppressed"
-      }
-    },
-    {
-      "id": "action-focused",
-      "semantic_mode": "action",
-      "states": [
-        "focus"
-      ],
-      "aria": {},
-      "expected": {
-        "visual": [
-          "focus",
-          "ready"
-        ],
-        "visual_image": [
-          { "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:39b96bc2459e2f0f442ce7b709f22e46b44f49b17c52d61940dff0246108ec48", "width": 640, "height": 56 },
-          { "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:7497f0542e2a4b77749ee47cfa7f575b640bad737c652a71610e9f86f8e5f2b8", "width": 640, "height": 56 }
-        ],
-        "dom": {
-          "active": "true",
-          "role": "button"
-        },
-        "ax": {
-          "focused": true,
-          "role": "button"
-        },
-        "activation": "allowed"
-      }
-    },
-    {
-      "id": "action-loading-busy",
-      "semantic_mode": "action",
-      "states": [
-        "busy",
-        "focus",
-        "loading"
-      ],
-      "aria": {
-        "busy": "true"
-      },
-      "expected": {
-        "visual": [
-          "busy",
-          "focus",
-          "loading"
-        ],
-        "visual_image": [
-          { "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:05cbe173a8274cfa7e6aab05713d1cb925820a7412bffceadb94d83498c17747", "width": 640, "height": 56 },
-          { "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:1521023b829210f899d2f56750e362cbfc30e8d6045f6f78a6c553a43bf610c4", "width": 640, "height": 56 }
-        ],
-        "dom": {
-          "active": "true",
-          "aria-busy": "true",
-          "role": "button"
-        },
-        "ax": {
-          "busy": true,
-          "focused": true,
-          "role": "button"
-        },
-        "activation": "suppressed"
-      }
-    },
-    {
-      "id": "disclosure-expanded-loading",
-      "semantic_mode": "disclosure",
-      "states": [
-        "busy",
-        "expanded",
-        "focus",
-        "loading"
-      ],
-      "aria": {
-        "busy": "true",
-        "expanded": "true"
-      },
-      "expected": {
-        "visual": [
-          "busy",
-          "expanded",
-          "focus",
-          "loading"
-        ],
-        "visual_image": [
-          { "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:d8c7ba056dd2a61ce6c85d8ec6bf56733cdc34da07678dd9b4175c7de9ab926a", "width": 640, "height": 88 },
-          { "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:7cef4e68a5a3df50c1705c7b88936bf0988317e2f6bed92ae5c04992388126a3", "width": 640, "height": 91 }
-        ],
-        "dom": {
-          "active": "true",
-          "aria-busy": "true",
-          "aria-expanded": "true",
-          "role": "button"
-        },
-        "ax": {
-          "busy": true,
-          "expanded": true,
-          "focused": true,
-          "role": "button"
-        },
-        "activation": "allowed"
-      }
-    },
-    {
-      "id": "toggle-focused-pressed",
-      "semantic_mode": "toggle",
-      "states": [
-        "focus",
-        "pressed"
-      ],
-      "aria": {
-        "pressed": "true"
-      },
-      "expected": {
-        "visual": [
-          "focus",
-          "pressed"
-        ],
-        "visual_image": [
-          { "environment_id": "darwin-arm64-chromium-1228", "sha256": "sha256:838229be984b8bda1ebfe6095564f1093df18fdd2ca1e6c3d5b5c086162d4692", "width": 640, "height": 56 },
-          { "environment_id": "linux-amd64-chromium-1228", "sha256": "sha256:1c105821f16a028e974bdf00590e3d9aee8042016ee341f4efe56b4a525b867d", "width": 640, "height": 56 }
-        ],
-        "dom": {
-          "active": "true",
-          "aria-pressed": "true",
-          "role": "button"
-        },
-        "ax": {
-          "focused": true,
-          "pressed": true,
-          "role": "button"
-        },
-        "activation": "allowed"
-      }
-    }
-  ]
-}

package/design-engineering/reference-profiles/governed-local/terminal/tokens.dtcg.json

@@ -1,17 +0,0 @@
-{
-  "color": {
-    "$type": "color",
-    "accent": { "$value": { "alpha": 1, "colorSpace": "srgb", "components": [0.25, 0.92, 0.55] } },
-    "ink": { "$value": { "alpha": 1, "colorSpace": "srgb", "components": [0.76, 0.95, 0.83] } },
-    "screen": { "$value": { "alpha": 1, "colorSpace": "srgb", "components": [0.02, 0.05, 0.04] } }
-  },
-  "duration": {
-    "$type": "duration",
-    "feedback": { "$value": { "unit": "ms", "value": 80 } }
-  },
-  "space": {
-    "$type": "dimension",
-    "page": { "$value": { "unit": "rem", "value": 1 } },
-    "rhythm": { "$value": { "unit": "rem", "value": 0.5 } }
-  }
-}

package/game-ui/classification.md

@@ -1,82 +0,0 @@
----
-type: Domain Guide
-title: Game UI Classification
-description: Engine-neutral method for classifying game interfaces by player task, presentation, input, state, and motion.
-domain: game-ui
-lifecycle: experimental
----
-
-# Game UI Classification
-
-Primary role: game-interface classification guide.
-
-## Repository Boundary
-
-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.
-
-## Reusable Method
-
-1. Capture the rendered screen or interaction in context.
-2. Assign one primary player-task class.
-3. Add secondary classes only when the same surface genuinely composes responsibilities.
-4. Record visual language, input, state, motion, and implementation as separate axes.
-5. Attach evidence for default, exceptional, and transitional states.
-6. State what is observed, inferred, and still unverified.
-
-## Player-Task Classes
-
-| Primary class | Player question | Typical examples |
-| --- | --- | --- |
-| `hud` | What is happening during play right now? | Health, ammo, objective, marker, cooldown |
-| `navigation` | Where can I go next? | Main menu, pause menu, chapter or mode selection |
-| `dialog` | What decision or interruption needs attention? | Confirmation, reconnect, privacy, system notice |
-| `inventory` | What do I own, equip, compare, or improve? | Loadout, stash, equipment, crafting, upgrade |
-| `progression` | What did I unlock or how am I advancing? | Results, level up, rewards, rank change |
-| `commerce` | What can I acquire and at what cost? | Shop, offer, product detail, currency shortage |
-| `tutorial` | What action should I learn or perform? | Coach mark, forced step, contextual hint |
-| `narrative` | What story or authored event is being presented? | Dialogue, boss intro, cinematic overlay |
-| `system-status` | Is the application ready and connected? | Splash, loading, sign-in, reconnect, patch status |
-| `input-surface` | How do I directly control the game? | Virtual stick, action button, key binding |
-
-## Classification Axes
-
-| Axis | Example values | Evidence requirement |
-| --- | --- | --- |
-| World relationship | `diegetic`, `spatial`, `overlay`, `full-screen` | Capture placement relative to play space |
-| Material character | `flat-graphic`, `framed`, `skeuomorphic`, `translucent`, `textural` | Capture repeated surface treatment |
-| Genre signal | `tactical`, `industrial`, `fantasy-ornamental`, `arcade`, `horror`, `casual` | Show repeated shape, type, icon, and material cues |
-| Information density | `sparse`, `standard`, `dense` | Count simultaneous choices and information groups |
-| Emphasis model | `typographic`, `icon-led`, `character-led`, `item-led`, `effect-led` | Identify first and second attention targets |
-| Input | pointer, keyboard, gamepad, touch, gaze, mixed | Exercise every declared input mode |
-| Motion role | affordance, activation, state change, transition, value change, reward, guidance, ambient | Record trigger, properties, timing, and interruption |
-
-## Opinionated Guidance
-
-- Organize the gallery first by player task, then filter by presentation and implementation axes.
-- Use two or three visual tags supported by repeated evidence.
-- Classify independent player-task regions separately when a screen composes them.
-- Do not infer style or behavior from project, prefab, widget, scene, or class names alone.
-
-## Platform-Specific Guidance
-
-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.
-
-## Unsupported Absolutes
-
-- A genre label does not establish a visual style.
-- A screenshot does not prove responsive behavior, focus behavior, or motion interruption.
-- A production project's folder structure is not a universal architecture.
-- Similar appearance does not prove equivalent accessibility, performance, or interaction behavior.
-
-## Verification Contract
-
-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.
-
-## Source, License, And Attribution
-
-This page is a locally authored, project-neutral proposed taxonomy. It reproduces no game assets, project-specific hierarchy, or upstream implementation samples.
-
-## IA Navigation
-
-Parent: [Game UI](index.md).
-Next: [Game UI Screen Hierarchy](screen-hierarchy.md).

package/game-ui/reference-record.md

@@ -1,62 +0,0 @@
----
-type: Domain Guide
-title: Game UI Reference Record
-description: Minimum evidence record for adding a game-interface reference to StyleGallery.
-domain: game-ui
-lifecycle: experimental
----
-
-# Game UI Reference Record
-
-Primary role: gallery evidence template.
-
-## Repository Boundary
-
-This record captures enough context to compare a game UI reference without importing its assets, source hierarchy, or implementation assumptions as gallery policy.
-
-## Reusable Method
-
-Complete the record from rendered evidence first, then add hierarchy and implementation facts. Mark unknown fields instead of guessing from names.
-
-## Minimum Record
-
-| Field | Required content |
-| --- | --- |
-| Identity | Entry name, source, capture date, source revision or version |
-| Player task | One primary class and justified secondary classes |
-| Presentation | Two or three visual-language tags with rendered evidence |
-| Hierarchy | Root, layer, screen, region, component, and control ownership |
-| Platform | Engine, UI framework, relevant package or runtime versions |
-| Surface | Render space, aspect ratios, safe area, scaling policy |
-| Input | Supported modes, initial focus, navigation, cancellation, focus return |
-| States | Default, selected, disabled, loading, error, empty, modal |
-| Motion | Role, trigger, properties, timing, interruption, completion |
-| Evidence | Screen capture, recording, hierarchy capture, relevant source paths |
-| Boundary | Observed facts, inferences, unknowns, and reuse restrictions |
-
-## Opinionated Guidance
-
-Prefer a complete record to a large screenshot collection missing state, hierarchy, or input evidence. It must explain the classification and what remains unproven.
-
-## Platform-Specific Guidance
-
-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.
-
-## Unsupported Absolutes
-
-- A source path is not rendered evidence.
-- A polished capture is not proof of edge-state behavior.
-- A single aspect ratio or input mode is not broad platform coverage.
-
-## Verification Contract
-
-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.
-
-## Source, License, And Attribution
-
-Record source licensing and reuse restrictions per entry. Do not copy protected game assets into the repository merely to make the record self-contained.
-
-## IA Navigation
-
-Parent: [Game UI](index.md).
-Next: [Unity UI Architecture](unity/architecture.md).

package/game-ui/screen-hierarchy.md

@@ -1,107 +0,0 @@
----
-type: Domain Guide
-title: Game UI Screen Hierarchy
-description: Engine-neutral ownership model for composing game-interface shells, screens, layers, regions, components, and controls.
-domain: game-ui
-lifecycle: experimental
----
-
-# Game UI Screen Hierarchy
-
-Primary role: engine-neutral hierarchy guide.
-
-## Repository Boundary
-
-This hierarchy describes interface responsibility, not a required scene graph or prefab tree. Engines may realize the same roles through scenes, widgets, documents, entities, prefabs, or runtime objects.
-
-## Reusable Method
-
-Read a game UI hierarchy from ownership outward:
-
-1. Identify the lifetime owner.
-2. Identify the active player task.
-3. Separate persistent, replaceable, modal, transient, and world-linked layers.
-4. Name screen regions by responsibility.
-5. Find repeated components and atomic controls.
-6. Record navigation, input blocking, sorting, focus, and teardown ownership.
-
-## Reference Hierarchy
-
-```text
-Application UI Root
-├── Persistent Services
-│   ├── Input and Focus Routing
-│   ├── Loading and Blocking
-│   ├── Notifications
-│   └── Accessibility and Localization
-├── Screen Host
-│   └── Active Screen
-│       ├── Screen Header
-│       ├── Primary Region
-│       ├── Supporting Region
-│       └── Screen Actions
-├── HUD Layer
-│   ├── Player Status
-│   ├── World Status
-│   ├── Objectives
-│   └── Context Actions
-├── Modal Layer
-│   ├── Blocker
-│   └── Dialog or Popup Stack
-├── Transient Layer
-│   ├── Toasts
-│   ├── Tooltips
-│   └── Reward and Feedback Effects
-└── World-Linked UI
-    ├── Markers
-    ├── Labels
-    └── Interaction Prompts
-```
-
-## Hierarchy Roles
-
-| Level | Owns | Must not silently own |
-| --- | --- | --- |
-| Application root | Cross-screen lifetime, global routing, top-level sorting | Screen-specific business state |
-| Layer host | Ordering, visibility policy, input blocking | Individual component presentation |
-| Screen | One primary player task and its navigation boundary | Unrelated global services |
-| Region | A stable information or action responsibility | Whole-screen lifecycle |
-| Component | Reusable stateful presentation unit | Global navigation policy |
-| Control | One direct interaction or value presentation | Hidden cross-screen side effects |
-
-## Composition Rules
-
-- Keep persistent services independent from replaceable screen content.
-- Assign explicit ownership for modal blocking and modal content.
-- Separate popup stacks, notifications, tooltips, and reward effects when their lifetime, input, sorting, or interruption responsibilities differ.
-- Distinguish world-linked UI from screen-space HUD by camera, target, and lifetime ownership, not shared visual tokens.
-- Prefer explicit data and state inputs for repeated list cells, slots, tabs, meters, and buttons over implicit global-state access.
-- Preserve logical navigation order when visual sorting or animation changes.
-
-## Opinionated Guidance
-
-A shallow tree is not automatically better than a deep tree. Prefer boundaries that make lifetime, input, sorting, and reuse obvious. Undocumented nodes used only to offset animation, scaling, or masking side effects are a fragility signal.
-
-## Platform-Specific Guidance
-
-Map these roles to the target engine without copying the hierarchy literally. See [Unity UI Architecture](unity/architecture.md) for Unity Scene, Canvas, prefab, and runtime mapping.
-
-## Unsupported Absolutes
-
-- Do not require one root Canvas, widget tree, or scene for every game.
-- Do not equate folder nesting with runtime ownership.
-- Do not assume a prefab, widget, or component boundary is also a navigation boundary.
-- Do not infer input blocking or render order from hierarchy position alone.
-
-## Verification Contract
-
-Trace one screen from creation through teardown. Record its creator, sorting layer, input blocker, focus entry and return, what survives screen changes, and modal or transition interruption behavior.
-
-## Source, License, And Attribution
-
-This page synthesizes recurring hierarchy responsibilities observed across game UI implementations without reproducing any project-specific object tree.
-
-## IA Navigation
-
-Parent: [Game UI](index.md).
-Next: [Game UI Reference Record](reference-record.md).