stylegallery 0.1.7 → 0.1.9

package/game-ui/unity/architecture.md

@@ -1,166 +0,0 @@
----
-type: Domain Guide
-title: Unity UI Architecture
-description: Unity-specific mapping from engine-neutral game UI hierarchy to Scenes, Canvas layers, prefabs, runtime instances, and motion ownership.
-domain: game-ui
-lifecycle: experimental
-source_repository: https://github.com/annulusgames/UGUIAnimationSamples
-source_path: README.md
-source_revision: 343c8110e5683be209cc01ccb4cb986175e61643
-platform: Unity uGUI and legacy Unity UI stacks
-platform_version: Unity 2022.3.7f1 sample evidence; Unity 6.3 LTS and uGUI 2.0 guidance
-reviewed_on: 2026-07-14
----
-
-# Unity UI Architecture
-
-Primary role: Unity hierarchy and implementation guide.
-
-## Repository Boundary
-
-This page maps the engine-neutral [Game UI Screen Hierarchy](../screen-hierarchy.md) to Unity concepts. It does not define game UI classification, require one universal Scene or Canvas structure, or treat a sample repository as a complete production architecture.
-
-## Version Boundary
-
-Two evidence contexts are intentionally separate:
-
-- **Pinned sample evidence:** the UGUI Animation Samples revision `343c8110e5683be209cc01ccb4cb986175e61643` records Unity `2022.3.7f1`, uGUI `1.0.0`, and TextMesh Pro `3.0.7`. Claims about its files apply only to that immutable snapshot.
-- **Current implementation guidance:** Unity Manual `6000.3` (Unity 6.3 LTS) and uGUI package `2.0` documentation were reviewed on 2026-07-14. Use those versioned documents for the concepts linked below, then verify the exact Unity and package versions recorded by each gallery entry.
-
-The pinned project is evidence about a small animation sample, not proof that its serialized hierarchy, packages, or lifecycle choices are appropriate for production or current Unity versions.
-
-## Reusable Method
-
-Inspect a Unity UI reference in this order:
-
-1. Record the Unity editor and UI package versions.
-2. Identify the Scene or persistent bootstrap object that owns UI lifetime.
-3. Locate root Canvas, UIDocument, or legacy NGUI panel boundaries.
-4. Identify screen, HUD, modal, transient, and world-space hosts.
-5. Trace prefab assets, nested prefabs, variants, scene instances, and runtime-created instances.
-6. Record sorting, input routing, focus, scaling, animation, and teardown ownership.
-7. Compare the rendered result with the engine-neutral Game UI record.
-
-## Scene And Runtime Hierarchy
-
-Unity's Hierarchy window shows GameObjects in the loaded Scene, including prefab instances. It does not by itself reveal asset ownership, runtime-created objects, persistent objects from another Scene, or the complete navigation policy.
-
-```text
-Bootstrap or Loaded Scene
-├── Persistent UI Services
-│   ├── EventSystem or Input Router
-│   ├── Loading and Blocking Host
-│   └── Notification Host
-├── Screen-Space UI Root
-│   ├── Screen Canvas or UIDocument
-│   ├── HUD Canvas
-│   ├── Modal Canvas
-│   └── Transient Effects Canvas
-└── World-Space UI Roots
-    ├── Markers
-    ├── Labels
-    └── Interaction Prompts
-```
-
-Treat this as a responsibility map. A project may combine or split these roots according to rebuild cost, sorting, camera setup, lifetime, input, and team ownership.
-
-## Prefab Hierarchy
-
-| Unity concept | What it represents | Review question |
-| --- | --- | --- |
-| Prefab asset | Reusable serialized GameObject hierarchy | What stable responsibility does the asset own? |
-| Prefab instance | Scene or runtime occurrence linked to an asset | Which properties are overrides, and who owns its lifetime? |
-| Nested prefab | Prefab instance preserved inside another prefab | Does nesting express reuse or hide cross-component coupling? |
-| Prefab variant | Asset inheriting from another prefab | Are differences intentional variants or accumulated overrides? |
-| Unpacked object | Hierarchy no longer linked as an instance | Was the loss of inheritance deliberate and recorded? |
-| Runtime instance | Object created during play | Where is it parented, initialized, focused, pooled, and destroyed? |
-
-Use prefab boundaries for stable ownership and reuse. Do not create a prefab for every visual node, and do not let a large screen prefab silently own global routing, data services, or unrelated modal layers.
-
-## Canvas And Layer Ownership
-
-| Layer responsibility | Typical Unity realization | Evidence to capture |
-| --- | --- | --- |
-| Persistent services | DontDestroyOnLoad root or bootstrap Scene | Creation order, duplicate prevention, teardown policy |
-| Active screen | Screen prefab under a screen host | Navigation boundary, initial focus, close behavior |
-| HUD | Dedicated Canvas or stable subtree | Camera relationship, update ownership, visibility policy |
-| Modal | Sorting layer with blocker and popup stack | Raycast blocking, stacking, cancellation, focus return |
-| Transient feedback | Pooled toast, tooltip, reward, or effect host | Sorting, pooling, interruption, time source |
-| World-linked UI | World Space Canvas or camera-projected element | Target loss, occlusion, distance, camera switching |
-
-Canvas boundaries create ownership, sorting, and configuration decisions. Measure batching and rebuild behavior with the actual content and update pattern, and profile representative target-device workloads before attributing a performance benefit to nested Canvases.
-
-## Component Hierarchy
-
-A reusable Unity UI component commonly separates these roles:
-
-```text
-Component Prefab Root
-├── Layout Root
-├── Visual States
-├── Content Bindings
-├── Interaction Target
-├── Optional Feedback Effects
-└── Component Controller
-```
-
-- `RectTransform` hierarchy expresses layout and parenting, not business ownership by itself.
-- `CanvasGroup` may coordinate visibility, interaction, and raycast blocking; verify all three properties.
-- `Selectable` navigation and EventSystem state require keyboard and gamepad evidence, not only pointer behavior.
-- ScrollRect structures should make viewport, content, scrollbar, cell reuse, and scroll ownership explicit.
-- Text components require localization, fallback, wrapping, material, and dynamic-size evidence.
-
-## Motion Ownership
-
-The pinned snapshot contains four serialized Scene YAML files and scripts for hover, button, text, and toggle examples. The scripts use LitMotion; `TextAnimation.cs` and the pinned package files contain text evidence of UniTask use for button-click subscriptions. Text and YAML inspection does not prove compilation, rendering, or runtime behavior, although the YAML records Screen Space Overlay Canvas, Canvas Scaler, and EventSystem components.
-
-Use the snapshot only as serialized evidence for component interaction motion. It does not establish a production Scene or prefab architecture, keyboard or gamepad coverage, responsive behavior, multi-Scene lifetime, successful runtime execution, or teardown policy. The inspected hover and button scripts contain `OnDestroy` cancellation paths; the two toggle scripts do not contain `OnDestroy`, but that absence alone is not proof of a leak or other runtime defect.
-
-Record whether motion is owned by Animator, a tween library, Timeline, a custom update loop, or a mixed system. For every transition, identify the trigger, animated properties, time source, cancellation behavior, disabled-object behavior, completion callback, and final state. A parent screen transition must not leave child controls focused, interactive, or visually stale.
-
-## Opinionated Guidance
-
-- Separate Scene lifetime, layer lifetime, screen lifetime, and component lifetime.
-- Prefer a small number of named layer hosts over ad hoc sorting overrides across unrelated prefabs.
-- Keep screen prefabs focused on one primary player task; route global blockers and notifications through explicit hosts.
-- Use nested prefabs and variants when inheritance is intentional and reviewable, not merely to reduce duplication at any cost.
-
-## Platform-Specific Guidance
-
-- Record whether the entry uses uGUI, UI Toolkit, legacy NGUI, or a mixed stack.
-- For uGUI, capture Canvas render mode, Canvas Scaler settings, sorting configuration, Graphic Raycaster, EventSystem, and relevant input module.
-- For UI Toolkit, capture Panel Settings, UIDocument ownership, visual tree source, style-sheet sources, focus behavior, and runtime document lifecycle.
-- For legacy or mixed stacks, name the bridge points, camera and sorting relationships, input ownership, and migration limits.
-
-## Unsupported Absolutes
-
-- Do not require one Canvas for an entire application or one Canvas per screen.
-- Do not equate Scene hierarchy order with render order, input priority, or lifetime ownership.
-- Do not assume a prefab instance is unchanged; inspect overrides and variants.
-- Do not call a UI responsive because Canvas Scaler is present.
-- Do not infer runtime behavior from YAML, asset paths, or prefab names alone.
-- Do not claim one animation system is faster or easier to maintain without measurements and project constraints.
-
-## Verification Contract
-
-Open the target Scene and Prefab Mode, then enter Play Mode. Capture the loaded Scene hierarchy, persistent objects, root UI hosts, prefab instance links and overrides, Canvas settings, sorting, EventSystem selection, and runtime-created objects. Exercise scene changes, repeated screen open and close, nested modals, focus return, safe areas, long localized text, paused or scaled time, and interrupted transitions.
-
-Repository YAML and metadata can establish hierarchy leads, but rendered appearance and runtime ownership remain unverified until Editor and Play Mode evidence is attached.
-
-## Source, License, And Attribution
-
-- Public sample snapshot: [annulusgames/UGUIAnimationSamples at `343c8110e5683be209cc01ccb4cb986175e61643`](https://github.com/annulusgames/UGUIAnimationSamples/tree/343c8110e5683be209cc01ccb4cb986175e61643) and its pinned [README.md](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/README.md)
-- Pinned version and dependency evidence: [ProjectVersion.txt](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/ProjectSettings/ProjectVersion.txt), [manifest.json](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Packages/manifest.json), and [packages-lock.json](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Packages/packages-lock.json)
-- Pinned serialized Scene evidence: [1_Hover.unity](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/1_Hover.unity), [2_Button.unity](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/2_Button/2_Button.unity), [3_Text.unity](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/3_Text/3_Text.unity), and [4_Toggle.unity](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/4_Toggle/4_Toggle.unity)
-- Pinned hover script evidence: [Hover1.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/Scripts/Hover1.cs), [Hover2.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/Scripts/Hover2.cs), [Hover3.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/Scripts/Hover3.cs), [Hover4.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/Scripts/Hover4.cs), [Hover5.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/Scripts/Hover5.cs), and [Hover6.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/1_Hover/Scripts/Hover6.cs)
-- Pinned button, text, and toggle script evidence: [Button1.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/2_Button/Scripts/Button1.cs), [Button2.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/2_Button/Scripts/Button2.cs), [TextAnimation.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/3_Text/Scripts/TextAnimation.cs), [Toggle1.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/4_Toggle/Scripts/Toggle1.cs), and [Toggle2.cs](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/Assets/Samples/4_Toggle/Scripts/Toggle2.cs)
-- Snapshot license: [The Unlicense](https://github.com/annulusgames/UGUIAnimationSamples/blob/343c8110e5683be209cc01ccb4cb986175e61643/LICENSE)
-- Unity 6.3 LTS Manual: [UI system comparison](https://docs.unity3d.com/6000.3/Documentation/Manual/UI-system-compare.html), [Hierarchy window](https://docs.unity3d.com/6000.3/Documentation/Manual/Hierarchy.html), [Prefabs](https://docs.unity3d.com/6000.3/Documentation/Manual/Prefabs.html), [creating Prefabs](https://docs.unity3d.com/6000.3/Documentation/Manual/CreatingPrefabs.html), [nested Prefabs](https://docs.unity3d.com/6000.3/Documentation/Manual/NestedPrefabs.html), [Prefab variants](https://docs.unity3d.com/6000.3/Documentation/Manual/PrefabVariants.html), [unpacking Prefab instances](https://docs.unity3d.com/6000.3/Documentation/Manual/UnpackingPrefabInstances.html), [`Object.Instantiate`](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/Object.Instantiate.html), and [`Object.DontDestroyOnLoad`](https://docs.unity3d.com/6000.3/Documentation/ScriptReference/Object.DontDestroyOnLoad.html)
-- uGUI 2.0 Manual: [Canvas](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/UICanvas.html), [Rect Transform](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/class-RectTransform.html), [Canvas Group](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/class-CanvasGroup.html), [Canvas Scaler](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/script-CanvasScaler.html), [navigation options](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/script-SelectableNavigation.html), [Event System](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/EventSystem.html), [Graphic Raycaster](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/script-GraphicRaycaster.html), and [Scroll Rect](https://docs.unity3d.com/Packages/com.unity.ugui@2.0/manual/script-ScrollRect.html)
-- Unity 6.3 LTS UI Toolkit Manual: [create a UI Document component](https://docs.unity3d.com/6000.3/Documentation/Manual/UIE-create-ui-document-component.html) and [focus order](https://docs.unity3d.com/6000.3/Documentation/Manual/UIE-focus-order.html)
-- Reuse form: independent, project-neutral architecture and review method; no game assets or upstream implementation samples are reproduced.
-
-## IA Navigation
-
-Parent: [Game UI](../index.md).
-Next: [Unity UI Systems](ui-systems.md).

package/game-ui/unity/cli-loop.md

@@ -1,84 +0,0 @@
----
-type: Domain Guide
-title: Unity CLI Loop
-description: Source-pinned workflow for inspecting and exercising Unity Game UI with unity-cli-loop while preserving UI-stack boundaries.
-domain: game-ui
-lifecycle: experimental
-source_repository: https://github.com/hatayama/unity-cli-loop
-source_path: README.md
-source_revision: 61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0
-platform: Unity 2022.3 or later as stated by the pinned source
-platform_version: unity-cli-loop source snapshot 61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0
-reviewed_on: 2026-07-14
----
-
-# Unity CLI Loop
-
-Primary role: Unity command-loop verification guide.
-
-## Repository Boundary
-
-This guide adapts the pinned unity-cli-loop command surface into a bounded Game UI inspection workflow. It documents what the audited source exposes for Editor control, hierarchy inspection, screenshots, uGUI interaction, input injection, and dynamic C# execution. No live Unity project was executed during this source review, so project compatibility and observed runtime results must be supplied by the user of the guide.
-
-## Reusable Method
-
-Use the loop in this order and preserve the evidence from each stage.
-
-1. **Launch the matching Editor.** Run the launch workflow from the Unity project so its recorded Editor version is selected. The pinned README exposes `uloop launch`, project-path selection, build-target selection, and restart behavior in its [direct CLI section](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/README.md#direct-cli-usage-advanced).
-2. **Compile from a clean console.** Clear stale console entries when appropriate, run `compile`, wait for domain reload when the task requires it, then collect logs. Do not proceed to UI interaction while compile errors make the runtime state ambiguous.
-3. **Inspect hierarchy and find objects.** Record the loaded Scene context, then use the hierarchy and GameObject search workflows to locate Transforms, `Canvas`, `EventSystem`, `UIDocument`, `UIRoot`, `UIPanel`, and other serialized components. The hierarchy service traverses GameObjects and Transforms in [`HierarchyService.cs`](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/Packages/src/Editor/Core/CoreTools/HierarchyAnalyzer/HierarchyService.cs#L338-L379). A UI Toolkit VisualElement child is not a Transform child, so finding a `UIDocument` does not enumerate its runtime visual tree.
-4. **Enter Play Mode when runtime evidence is required.** Use the Play Mode control workflow before Game View rendering capture and annotations, pointer simulation, Input System injection, input recording or replay, and inspection of runtime-created objects. Window screenshots may work outside Play Mode, but `CaptureMode: rendering` requires Play Mode at the pinned revision. Capture logs immediately after state changes.
-5. **Capture the correct screenshot.** An Editor-window screenshot can show editor chrome outside Play Mode. In Play Mode, use the Game View rendering capture and its annotations when coordinates or runtime UI evidence are needed. Keep the pre-action image.
-6. **Simulate through the stack-appropriate route.** Use the dedicated uGUI pointer workflow for EventSystem-handled UI. Use Input System mouse or keyboard injection only when the project actually reads that input path. For UI Toolkit or NGUI, combine rendering, component inspection, and narrowly scoped project code while keeping their distinct event routes explicit.
-7. **Use dynamic code for targeted inspection or mutation.** Query project state, inspect `UIDocument.rootVisualElement`, or make bounded editor changes with `execute-dynamic-code`. Treat the result as evidence of the code that ran, not as proof that a player-input path was exercised.
-
-   > [!IMPORTANT]
-   > **Dynamic-code security boundary:** Use the lowest sufficient security level and keep **Restricted** unless the task specifically requires an operation it blocks. Restricted is defense-in-depth, not a trust boundary or a Unity-only sandbox. At the pinned revision, submitted code can read arbitrary files available to the Editor process, can create files and write through permitted stream APIs, can call Unity APIs and .NET standard libraries, and can invoke user-defined project assemblies; those assemblies may expose additional capabilities. Selected deletion, direct file-writing helpers, network, process, dynamic-loading, thread, and registry operations are blocked, and the compiled assembly is validated before and after load, but these checks do not make untrusted code safe. **Review and trust submitted code in both Restricted and FullAccess modes. FullAccess removes the Restricted-mode checks and should be exceptional.** Run AI-generated or otherwise untrusted dynamic code only inside a disposable, least-privilege VM or container with no host credentials, personal files, production tokens, or writable host mounts. Before either mode, review the submitted code and the target Unity project, including project assemblies it can call. Turn off `execute-dynamic-code` in the tool settings when it is unnecessary. The security level is persisted in `.uloop/settings.permissions.json`; although the upstream README permits optional team sharing, keep permission and related local configuration out of commits or published artifacts when it would reveal the project's security policy. See the pinned [security policy](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/SECURITY.md#security-best-practices-for-users), [README security levels](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/README.md#10-execute-dynamic-code---dynamic-c-code-execution), and [settings file guidance](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/README.md#unity-cli-loop-files).
-8. **Capture the result and save intentionally.** Collect the post-action screenshot and logs, compare the expected state, and explicitly save Scene or prefab changes when the task changed serialized content.
-
-## Stack-Specific Interaction Boundary
-
-| Stack | What the pinned workflow exposes | Required caution |
-| --- | --- | --- |
-| uGUI | Dedicated annotation scans uGUI `Selectable` and EventSystem handler targets. `simulate-mouse-ui` constructs pointer/drag events and requires Play Mode plus an EventSystem; ordinary Canvas interaction also needs the project's raycast path, commonly an active Graphic Raycaster. See [`UIElementAnnotator.cs`](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/Packages/src/Editor/Utils/UIElementAnnotator.cs#L145-L215) and [`SimulateMouseUiTool.cs`](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/Packages/src/Editor/Api/McpTools/SimulateMouseUi/SimulateMouseUiTool.cs#L31-L49). | Confirm the active EventSystem, input module, raycaster, blockers, selected object, and target Scene before interpreting a click or drag. |
-| UI Toolkit | Rendering capture can show the Game View, and generic hierarchy inspection can find a `UIDocument` component. Dynamic C# can query its runtime `rootVisualElement`. | The VisualElement tree is Panel-owned rather than Transform-owned. At the pinned snapshot, the audited dedicated UI annotations and pointer tool are uGUI/EventSystem-oriented, so VisualElement lookup and manipulation remain project-specific work. |
-| NGUI | Rendering capture and generic GameObject/component inspection can locate `UIRoot`, `UIPanel`, widgets, and `UICamera`. Dynamic C# can read or set component state. | NGUI's pinned [`UICamera`](https://github.com/tasharen/ngui/blob/9bbc56f11e0e25b89fd55b9b9bc67ddf1f182fe2/Assets/NGUI/Scripts/UI/UICamera.cs#L13-L43) performs its own raycasts and message dispatch with legacy `UnityEngine.Input` defaults. EventSystem dispatch or New Input System injection does not by itself demonstrate that UICamera processed the same pointer route. |
-
-## Coordinate Contract
-
-Use the `SimX` and `SimY` values returned by the rendering annotation directly with the matching simulation call. They are caller-facing Game View input coordinates with a top-left origin. Do not substitute Transform positions, RectTransform positions, or Editor-window pixels, and do not apply an extra Y-axis flip. Keep the screenshot resolution and Game View state with the coordinate evidence.
-
-## Dynamic-Code Proof Boundary
-
-The pinned dynamic-code skill describes a generic Editor execution mechanism and compilation/error reporting in [`uloop-execute-dynamic-code/SKILL.md`](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/.agents/skills/uloop-execute-dynamic-code/SKILL.md#L22-L56). A direct property assignment or callback invocation can prove that the submitted code completed and that the inspected state changed. By itself it does not prove raycast blockers, hover and press transitions, drag thresholds, focus movement, cancellation, pointer capture, or the player's real input path.
-
-## Opinionated Guidance
-
-- Keep command outputs as separate evidence until the verification contract ties them to one claim.
-- Prefer the stack's input route for behavior verification. Use direct code for inspection or bounded setup, and reinspect after entering Play Mode when runtime-created or persistent objects matter.
-
-## Platform-Specific Guidance
-
-- For uGUI, confirm the Canvas, Graphic Raycaster, EventSystem, active input module, handler, and current selection before simulation.
-- For UI Toolkit, record the runtime Panel and focus owner. For NGUI, record its collider or raycast configuration and legacy-input delegates.
-- In mixed projects, label each action with the input and hierarchy system it targets.
-
-## Unsupported Absolutes
-
-No single command result proves end-to-end interaction: a screenshot does not prove dispatch; finding a component does not enumerate its non-Transform descendants; direct code does not prove the player's input path or that serialized changes were saved. Tool availability also does not prove that a project's packages and configuration meet its prerequisites.
-
-## Verification Contract
-
-For a complete UI loop, retain launch/version evidence, clean compile output, relevant logs, pre-action hierarchy, pre-action rendering screenshot, exact `SimX`/`SimY` or input parameters, the stack-specific input route, post-action screenshot, post-action logs, focus or selected-state evidence, and save confirmation for serialized edits. Repeat the critical interaction after a fresh Play Mode entry when persistence or initialization is part of the claim.
-
-## Source, License, And Attribution
-
-- Adapted source: [hatayama/unity-cli-loop README at `61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0`](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/README.md)
-- Source license: [MIT](https://github.com/hatayama/unity-cli-loop/blob/61a0fe6d7da0aa9d0bcbc6d95944dd069c483ff0/LICENSE.md)
-- Reuse form: independently authored Game UI verification workflow based on the pinned command documentation and implementation paths; no upstream command output or project asset is reproduced.
-- Review boundary: source inspection only; no live Unity project was run for this page.
-
-## IA Navigation
-
-Parent: [Game UI](../index.md).
-Next: [Unity Repository Map](repository-map.md).

package/game-ui/unity/org-wiki.md

@@ -1,146 +0,0 @@
----
-type: Domain Guide
-title: Unity Organization Compressed Wiki
-description: Independent cluster index over a tracked snapshot of 804 public Unity-Technologies repositories for bounded Game UI source discovery.
-domain: game-ui
-lifecycle: experimental
-platform: Unity-Technologies public GitHub organization
-platform_version: public repository snapshot captured 2026-07-14T12:59:16Z
-reviewed_on: 2026-07-15
----
-
-# Unity Organization Compressed Wiki
-
-Primary role: bounded organization-wide source discovery for Unity Game UI research.
-
-> **Independent research — not affiliated with or endorsed by Unity Technologies. Snapshot evidence, not a support-status catalog.**
-
-This locally authored index compresses **804** public repositories into one tracked data inventory and 20 exclusive primary clusters. It is not produced, sponsored, endorsed, or maintained by Unity Technologies. Organization placement does not establish authorship of forked, mirrored, vendored, or third-party content. Each repository retains its own license and terms.
-
-The machine-readable source is [`data/unity-technologies-public-repositories.json`](data/unity-technologies-public-repositories.json). It records one row per captured public repository, including stable identity, repository URL, raw fork/archive/template state, default branch and observed HEAD when resolved, snapshot time, license metadata, UI relevance, and one exclusive `primary_cluster`.
-
-The source snapshot was captured at `2026-07-14T12:59:16Z`. The pre-projection inventory SHA-256 was `8291b471251053a8921651eb7c791d13a4794984b73670a51cdb1116deb49657`; the tracked JSON SHA-256 is `b1438e6e8d438bab3eff2ff02f5a10e9374fdfb89b0581ffb936a42920fa2e05`. It records 59 archived repositories, 356 forks, and 4 templates.
-
-## Repository Boundary
-
-The inventory covers the public Unity-Technologies organization snapshot and no other owner. NGUI and other third-party sources remain outside its counts. Public organization metadata is discovery evidence; it is not an affiliation, authorship, quality, or support claim.
-
-## Reusable Method
-
-1. Start with [Unity UI Systems](ui-systems.md) for a current system-choice decision.
-2. Use the [Unity Repository Map](repository-map.md) to find UI authority, examples, adjacent evidence, and historical material.
-3. Use this page when a UI question depends on a broader engine subject such as rendering, input, ECS, networking, XR, platform integration, services, or tooling.
-4. Open the tracked inventory for individual repository URLs and captured metadata.
-5. Before turning a repository observation into guidance, resolve and pin the exact Unity/package version and source revision.
-
-The evidence order is: versioned Unity manuals and package changelogs; SHA-pinned implementation source; current version-bounded examples; dated announcements; historical demos; then community anecdotes. Stars, recent pushes, and organization placement are discovery signals, not authority or support status.
-
-## Exclusive Cluster Index
-
-First match wins. Fork and archive gates precede subjects; UI authority precedes adjacent technical subjects; technical subjects precede generic samples; the residual is an explicit covered value.
-
-| Primary cluster | Repositories | Game UI use boundary |
-| --- | ---: | --- |
-| `meta-forks-mirrors` | 356 | Discovery only. GitHub `fork: true` does not establish first-party authority. |
-| `meta-archived-historical` | 32 | Archaeology and migration context, not current guidance. |
-| `game-ui-primary` | 9 | Explicit UI sources/examples; refine lifecycle and version before use. |
-| `graphics-rendering` | 38 | Rendering constraints, shaders, pipelines, VFX, materials, and display behavior. |
-| `ecs-dots` | 22 | Data-oriented runtime architecture that can constrain UI state flow. |
-| `networking` | 21 | Multiplayer state, transport, lobby, relay, matchmaking, and server flows. |
-| `xr-ar` | 25 | Spatial interaction, device input, world-space presentation, and XR constraints. |
-| `ml-ai` | 23 | ML, inference, perception, and synthetic-data context; no UI defaults. |
-| `robotics` | 6 | Simulation and operator-interface observations only. |
-| `2d` | 7 | Sprite, tilemap, 2D package, and pixel-oriented implementation context. |
-| `animation` | 10 | Timeline, rigging, Cinemachine, and animation-system dependencies. |
-| `audio` | 3 | Audio/DSP and spatial-audio state dependencies. |
-| `physics` | 1 | Physics-system context only. |
-| `editor-tooling` | 29 | Authoring, profiling, build, package, recorder, and asset-tooling surfaces. |
-| `ci-infra` | 2 | Build and test infrastructure; not product UI evidence. |
-| `language-runtime` | 3 | Runtime, compilation, scripting, and serialization dependencies. |
-| `services-cloud` | 3 | Authentication, economy, analytics, leaderboard, and remote-service states. |
-| `platform-mobile` | 9 | Native integration, safe areas, packaging, device constraints, and platform input. |
-| `samples-templates` | 30 | Observation-only examples without a stronger subject assignment. |
-| `other-mixed-or-insufficient-metadata` | 175 | Covered residual; no speculative subject claim. |
-| **Total** | **804** | Exactly one primary cluster per tracked row. |
-
-`localization-text` remains a reserved search facet with zero primary rows in this snapshot. A zero primary count does not prove absence; use UI relevance and repository-specific inspection.
-
-## UI Authority Route
-
-The current source triangle is deliberately split:
-
-- [`uGUI`](https://github.com/Unity-Technologies/uGUI) owns the GameObject/Canvas UI package source and current TextMesh Pro source. Use the package version in the target project and a matching SHA.
-- [`UnityCsReference`](https://github.com/Unity-Technologies/UnityCsReference) contains the broad UI Toolkit reference implementation within engine C# reference source; it is not a package mirror.
-- [`InputSystem`](https://github.com/Unity-Technologies/InputSystem) owns UI-input integration such as action maps and `InputSystemUIInputModule`, not rendering or layout.
-
-Open UnityCsReference as a Unity-engine C# study and reference textbook surface when tracing module architecture, ownership boundaries, and version-pinned implementation paths. It is valuable for readers who already know C# and want to study how Unity's managed engine layer is organized; it is not a learn-C#-from-zero or general-purpose C# curriculum. Read a branch or SHA matched to the target Unity version line, and treat the repository as reference source rather than a package mirror or the complete engine: native/C++ implementation remains outside this corpus.
-
-Current scoped examples include [`BagelGame`](https://github.com/Unity-Technologies/BagelGame), [`ui-toolkit-manual-code-examples`](https://github.com/Unity-Technologies/ui-toolkit-manual-code-examples), and [`a11y-public-sample`](https://github.com/Unity-Technologies/a11y-public-sample). Preserve each example's recorded Unity/package baseline.
-
-Historical UIElements/UI Toolkit conference and runtime demos remain historical even if unarchived or recently pushed. [`com.unity.uiwidgets`](https://github.com/Unity-Technologies/com.unity.uiwidgets) is a separate archived framework, not UI Toolkit.
-
-NGUI is third-party [`tasharen/ngui`](https://github.com/tasharen/ngui). It is outside the Unity-Technologies 804-repository inventory and appears only as a separately pinned migration comparison in [Unity UI Systems](ui-systems.md).
-
-## Opinionated Guidance
-
-- Use `game-ui-primary` only as a candidate route; open the repository-map lifecycle disposition before citing it.
-- Prefer a matching release or Unity-version SHA over a mutable default-branch HEAD for implementation claims.
-- Keep engine-subject clusters as dependency context. They do not supply visual defaults or universal Game UI rules.
-- Treat stars, recent pushes, and repository names as discovery signals only.
-
-## Platform-Specific Guidance
-
-- Match uGUI and UnityCsReference source to the target Unity editor/package line.
-- Match Input System evidence to the project's installed package version and UI module configuration.
-- Revalidate XR, mobile, safe-area, HDR, and native-integration examples on the target device and render pipeline.
-- Preserve each sample's recorded Unity version even when its repository is unarchived or recently pushed.
-
-## Residual And Provenance Policy
-
-The 175-row residual means the bounded metadata classifier selected no earlier cluster. It does not mean irrelevant, empty, undocumented, or free of UI evidence. Curated overrides must be versioned and must recompute the full partition; do not edit cluster counts by hand.
-
-Raw `fork`, `archived`, and `is_template` values remain in the inventory. GitHub's fork flag is not a complete authorship model: non-fork repositories can still describe themselves as mirrors, forks, or vendored sources. Treat provenance as unresolved until repository evidence establishes it.
-
-## Completeness And Refresh Limits
-
-- The snapshot excludes private, deleted, transferred, and non-default-branch-only material.
-- Five stored tree scans were truncated and two zero-size repositories returned tree-fetch errors; absence claims do not rely on those trees.
-- Some repository HEADs, versions, licenses, lifecycle statements, and replacement paths remain unresolved.
-- X/Twitter evidence was unavailable during the research session. No post, handle, date, URL, or quotation is inferred from that absence.
-- The taxonomy is metadata-first. The residual protects against false precision; it is not editorial completion for 175 individual repositories.
-
-Refresh by rebuilding the complete public inventory, preserving stable identities and raw lifecycle fields, rerunning the exclusive classifier, validating all 804 assignments, reviewing changed authority records, and updating the snapshot identity. Never hand-edit one count without recomputing the whole partition.
-
-## Unsupported Absolutes
-
-- “In the Unity-Technologies organization” does not mean Unity authored every file.
-- “Unarchived” or “recently pushed” does not mean current or supported.
-- “No UI signal” does not prove a repository contains no interface code.
-- The 175-row residual does not mean the repositories are irrelevant or unclassifiable with deeper evidence.
-- This snapshot does not establish the contents of private, deleted, transferred, or non-default branches.
-
-## Verification Contract
-
-Run `node scripts/validate-unity-org-wiki.mjs --json` and `node scripts/test-validate-unity-org-wiki.mjs`. A refreshed publication must retain 804 unique identities for this snapshot, preserve the exclusive cluster sum, keep NGUI external, and update the page, data, snapshot identity, and tests together.
-
-## Source, License, And Attribution
-
-- Inventory basis: public GitHub repository metadata and captured default-branch inspection at `2026-07-14T12:59:16Z`.
-- Inventory identity before tracked projection: SHA-256 `8291b471251053a8921651eb7c791d13a4794984b73670a51cdb1116deb49657`; tracked JSON SHA-256 `b1438e6e8d438bab3eff2ff02f5a10e9374fdfb89b0581ffb936a42920fa2e05`; 59 archived repositories, 356 forks, and 4 templates.
-- Repository licenses and reuse terms differ. Follow each repository's recorded and current license before copying code or assets.
-- Reuse form: locally authored taxonomy, discovery index, and metadata projection; no Unity logos, trade dress, or first-person organizational voice.
-
-## Review Trigger
-
-Revisit this experimental page when the public snapshot is refreshed, a current UI authority source changes ownership or lifecycle, high-value unresolved HEAD/version fields are pinned, curated residual overrides are accepted, or verified social evidence materially changes the source-ranking discussion.
-
-Implementation handoff: Unity public-repository inventory and compressed discovery index.
-
-Consumer reference: `not_applicable`
-
-Consumer reference reason: This implementation adds repository provenance and discovery evidence, not consumer-specific visual or component guidance.
-
-## IA Navigation
-
-Parent: [Game UI](../index.md).
-Next: [Platform Guides](../../platform-guides/index.md).

package/game-ui/unity/repository-map.md

@@ -1,102 +0,0 @@
----
-type: Domain Guide
-title: Unity Repository Map
-description: Public default-branch snapshot map for locating Unity UI system sources, examples, adjacent references, and historical material.
-domain: game-ui
-lifecycle: experimental
-platform: Unity-Technologies public GitHub organization
-platform_version: public and default-branch snapshot captured 2026-07-14T12:59:16Z
-reviewed_on: 2026-07-14
----
-
-# Unity Repository Map
-
-Primary role: Unity public-source discovery and authority map.
-
-## Repository Boundary
-
-This locally authored map classifies the Unity-Technologies public organization snapshot captured at `2026-07-14T12:59:16Z`. GitHub organization metadata and fully paginated public-repository enumeration both returned 804 repositories. The pre-projection capture had SHA-256 `8291b471251053a8921651eb7c791d13a4794984b73670a51cdb1116deb49657`; the tracked classified [`data/unity-technologies-public-repositories.json`](data/unity-technologies-public-repositories.json) has SHA-256 `b1438e6e8d438bab3eff2ff02f5a10e9374fdfb89b0581ffb936a42920fa2e05` and records 59 archived repositories, 356 forks, and 4 templates.
-
-The map is a discovery index. A repository's presence, name, archive flag, or push date does not make it a current UI-system source.
-
-## Reusable Method
-
-1. Enumerate every public repository through REST pagination and retain stable repository identity and snapshot time.
-2. Record archive, fork, template, default branch, default-branch HEAD, README location, and tree-scan status.
-3. Scan default-branch paths for UXML, USS, UI Toolkit/UIElements, uGUI/Canvas/EventSystem, IMGUI, HUD/menu, accessibility, localization, text, and input signals.
-4. Counter-search descriptions and code paths so name-hidden candidates remain discoverable.
-5. Assign every repository one relevance class and a disposition reason.
-6. Deep-read only the authority subset, then pin each guidance claim to an exact revision and lifecycle context.
-
-## Snapshot Classification
-
-| UI relevance class | Repositories | Use |
-| --- | ---: | --- |
-| `primary-ui-source` | 8 | Unity UI system or explicit UI/example repository; refine lifecycle before use. |
-| `ui-adjacent-reference` | 5 | Input, reference source, safe-area, calibration, or vector-graphics evidence that constrains a UI review. |
-| `runtime-ui-observation` | 23 | Runtime UXML/USS or game/product UI implementation whose repository purpose is broader than UI. |
-| `legacy-ui-observation` | 72 | Multiple uGUI, HUD, menu, or Canvas observations in repositories owned for another purpose. |
-| `editor-or-incidental-uitoolkit` | 21 | UI Toolkit appears in editor tooling, inspectors, tests, or incidental help surfaces. |
-| `code-only-or-incidental-ui-signal` | 93 | Sparse or ambiguous UI-like paths do not justify reference status. |
-| `historical-ui-source` | 1 | Archived UIWidgets source retained as a separate historical framework. |
-| `excluded-misleading-name` | 1 | A UI-like repository name does not match a general UI source after inspection. |
-| `excluded-fork-or-vendor-ui` | 90 | Forked, mirrored, or vendored UI content is not automatically Unity-authored evidence. |
-| `no-ui-signal` | 490 | No UI signal was located in metadata, topics, default-branch path scan, or counter-search. |
-
-Total: 804 repositories.
-
-## Authority And Lifecycle Disposition
-
-| Disposition | Pinned examples | How to use them |
-| --- | --- | --- |
-| Current primary system/reference | uGUI's Unity 6000.3 [`Graphic.cs`](https://github.com/Unity-Technologies/uGUI/blob/9edb4420267b6652090ece4c28c38bd98746a68e/com.unity.ugui/Runtime/UGUI/UI/Core/Graphic.cs), UnityCsReference 6000.3.19f1 [`Panel.cs`](https://github.com/Unity-Technologies/UnityCsReference/blob/79f16640303119112ca5caed4d71c607d0dff6fb/Modules/UIElements/Core/Panel.cs), and InputSystem [`InputSystemUIInputModule.cs`](https://github.com/Unity-Technologies/InputSystem/blob/8a57d62081cf3546b46444e17223e0121a3568b2/Packages/com.unity.inputsystem/InputSystem/Runtime/Plugins/UI/InputSystemUIInputModule.cs) | Use version-pinned component and integration architecture. UnityCsReference remains reference source rather than a package mirror. |
-| Current explicit examples | [BagelGame README](https://github.com/Unity-Technologies/BagelGame/blob/5d0348bfa013f3c76299dd582c90a7549f66abce/README.md), [UI Toolkit manual code examples README](https://github.com/Unity-Technologies/ui-toolkit-manual-code-examples/blob/7ed6e7af9fc8a8f83facea818f47928d2e03a30f/README.md), and [accessibility sample README](https://github.com/Unity-Technologies/a11y-public-sample/blob/ec14cfcb8c10bafab83ea02cd17759d77b225fae/README.md) | BagelGame is a Unity 6.3 full-game UI Toolkit example; the manual repository contains documentation snippets; the accessibility sample is a Unity 2023.3 uGUI example. Keep each example's version and purpose attached. |
-| Adjacent and current observation examples | [EntityComponentSystemSamples README](https://github.com/Unity-Technologies/EntityComponentSystemSamples/blob/6786a741ee1f118ed14cecfa02beae8e926937b0/README.md), [XR Interaction Toolkit Examples README](https://github.com/Unity-Technologies/XR-Interaction-Toolkit-Examples/blob/881f7e197c7b0958621ebd1a05f249bbe254d36f/README.md), and [Unity Industry Viewer Template README](https://github.com/Unity-Technologies/unity-industry-viewer-template/blob/5d50da18f68b14c4dc15bcf3d535878cc2254497/README.md) | Use as implementation observations for their own product, ECS, XR, or industry-template context. They do not own the general UI-system contract. |
-| Historical UI examples | [UIElementsExamples README](https://github.com/Unity-Technologies/UIElementsExamples/blob/e940d1c9dddfe99fd500c9f34f4801856ad37f18/README.md), [Unite Copenhagen 2019 demo README](https://github.com/Unity-Technologies/UIElementsUniteCPH2019RuntimeDemo/blob/fa4f2c70cf2d6127ab624cc11a2742260ca6ff20/README.md), [Unite LA turret demo README](https://github.com/Unity-Technologies/UIElementsUniteLATurretDemo/blob/1fce133fe3a3473d418066d8005c64340e9985d5/README.md), and [Unity Royale runtime demo README](https://github.com/Unity-Technologies/UIToolkitUnityRoyaleRuntimeDemo/blob/9b5006d2580101b4d08d59d03d7dadc697d75311/README.md) | Retain for UIElements/UI Toolkit technique lineage and their recorded Unity-era context. Unarchived status or a recent push does not revise their baseline. |
-| Separate or excluded | Archived [UIWidgets README](https://github.com/Unity-Technologies/com.unity.uiwidgets/blob/0310984e947881eca6c2657f1a2fcaaa19329c22/README.md), [SimpleUIDemo README](https://github.com/Unity-Technologies/SimpleUIDemo/blob/c33907f1ffa0f8a30b46f958d3cf45e5da08b01c/README.md), and the 90 `excluded-fork-or-vendor-ui` rows | UIWidgets is a separate archived framework whose README points development elsewhere. SimpleUIDemo is a Project Tiny sample rather than a general UI reference. Fork and vendor content requires an independent provenance decision. |
-
-## Completeness Limits
-
-- The snapshot covers the public organization and each repository's observable default branch at capture time. It cannot observe private, deleted, transferred, or non-default-branch-only material.
-- `gen-playerid-stats` and `repotest123` returned tree-fetch errors; both reported repository size zero, leaving no default-branch content to inspect.
-- Recursive trees were truncated for Graphics, google-dawn, llvm-project, mono, and runtime. No absence claim relies on those truncated trees.
-- Broad GitHub Code Search has rate and result ceilings. It was used to counter-check candidates, not as the enumeration mechanism.
-- Path and metadata signals identify candidates; they do not prove compilation, rendered behavior, lifecycle correctness, or current support.
-
-## Opinionated Guidance
-
-- Start UI architecture research with the current primary sources, then use explicit examples for concrete version-scoped implementation evidence.
-- Keep product samples, historical demos, separate frameworks, forks, mirrors, and incidental UI in distinct evidence lanes.
-- Record repository owner, fork state, archive state, default-branch HEAD, README lifecycle statement, Unity/package version, authority class, and replacement path when one is named.
-- Rebuild the inventory instead of editing counts by hand when the organization snapshot changes.
-
-## Platform-Specific Guidance
-
-- Use the Unity 6000.3 branch and package context when applying the uGUI source linked here.
-- Use the UnityCsReference 6000.3.19f1 SHA for this page's UI Toolkit architecture boundary, not the newer default-branch head captured by the inventory.
-- Use InputSystem only for the input and UI integration behavior visible at its pinned SHA.
-- Preserve each sample's recorded Unity version and purpose in any downstream Game UI reference record.
-
-## Unsupported Absolutes
-
-- An unarchived repository is not proof of current guidance.
-- A recent `pushed_at` value is not proof that a sample's Unity baseline changed.
-- Repository ownership does not prove that every vendored or forked file is Unity-authored.
-- A matching path or term does not prove that the repository is a UI-system source.
-- This snapshot does not establish private or deleted repository history.
-
-## Verification Contract
-
-Before citing a repository, resolve the exact default-branch or release SHA, read its lifecycle statement and version files, inspect the relevant source path, and assign one of the dispositions above. For a refreshed map, repeat public pagination, verify unique ids and full names, recompute archive/fork/template totals and all ten class totals, record tree exceptions, and publish the new inventory hash and capture timestamp together.
-
-## Source, License, And Attribution
-
-- Inventory basis: public GitHub organization metadata, fully paginated public repository metadata, default-branch tree scans, and targeted counter-search captured on `2026-07-14T12:59:16Z`.
-- Inventory identity: 804 classified rows; pre-projection SHA-256 `8291b471251053a8921651eb7c791d13a4794984b73670a51cdb1116deb49657`; tracked JSON SHA-256 `b1438e6e8d438bab3eff2ff02f5a10e9374fdfb89b0581ffb936a42920fa2e05`; 59 archived repositories, 356 forks, and 4 templates.
-- Repository licenses and reuse terms differ. Follow the pinned repository's own license before copying code or assets.
-- Reuse form: locally authored discovery and authority map; repository metadata and links are evidence references, not imported implementation guidance.
-
-## IA Navigation
-
-Parent: [Game UI](../index.md).
-Next: [Unity Organization Compressed Wiki](org-wiki.md).