stylegallery 0.1.6 → 0.1.7

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.
Files changed (63) hide show
  1. package/DOMAINS.md +4 -4
  2. package/GOVERNANCE.md +1 -1
  3. package/LICENSE +28 -0
  4. package/LICENSE-DOCS +42 -0
  5. package/NOTICE +38 -0
  6. package/README.md +25 -6
  7. package/consumer-reference/agent-native/README.md +7 -7
  8. package/consumer-reference/agent-native/v2/admission-policy.json +171 -1
  9. package/consumer-reference/agent-native/v2/material-registry.json +1 -1
  10. package/consumer-reference/agent-native/v2/schema/admission-policy.schema.json +2 -2
  11. package/design-engineering/component-contract.md +19 -3
  12. package/design-engineering/decision-tree.md +1 -0
  13. package/design-engineering/index.md +48 -0
  14. package/design-engineering/loading-and-feedback.md +91 -0
  15. package/design-engineering/native-interaction-contracts.md +94 -0
  16. package/design-engineering/state-management/decision-tree.md +60 -0
  17. package/design-engineering/state-management/index.md +61 -0
  18. package/design-engineering/state-management/patterns/derived-state.md +85 -0
  19. package/design-engineering/state-management/patterns/draft-and-baseline.md +86 -0
  20. package/design-engineering/state-management/patterns/id-selection.md +85 -0
  21. package/design-engineering/state-management/patterns/identity-reset.md +89 -0
  22. package/design-engineering/state-management/patterns/latest-request-wins.md +94 -0
  23. package/design-engineering/state-management/patterns/optimistic-overlay.md +98 -0
  24. package/design-engineering/state-management/patterns/single-flight.md +92 -0
  25. package/design-engineering/state-management/patterns/single-owner.md +89 -0
  26. package/design-engineering/state-management/patterns/submitted-snapshot.md +107 -0
  27. package/design-engineering/state-management/patterns/unsaved-navigation.md +100 -0
  28. package/design-engineering/state-management/patterns/url-state.md +96 -0
  29. package/design-engineering/state-management/patterns/versioned-restore.md +95 -0
  30. package/design-engineering/state-management/recipes/delete-undo.md +65 -0
  31. package/design-engineering/state-management/recipes/index.md +64 -0
  32. package/design-engineering/state-management/recipes/multi-step-form.md +65 -0
  33. package/design-engineering/state-management/recipes/search-detail.md +65 -0
  34. package/design-engineering/state-management/recipes/settings-save.md +64 -0
  35. package/design-engineering/state-management/state-brief.md +83 -0
  36. package/design-engineering/state-management/verification.md +65 -0
  37. package/design-engineering/text-input-and-internationalization.md +91 -0
  38. package/design-engineering/worked-examples.md +2 -0
  39. package/design-terminology/conflict-cases.md +50 -7
  40. package/design-terminology/index.md +6 -0
  41. package/design-terminology/interaction-semantics.md +87 -0
  42. package/design-terminology/source-vocabularies.md +17 -1
  43. package/design-terminology/token-semantics.md +90 -0
  44. package/design-terminology/typography-semantics.md +86 -0
  45. package/log.md +29 -0
  46. package/motion/accessible-motion.md +90 -0
  47. package/motion/index.md +7 -0
  48. package/motion/interaction-recipes.md +8 -2
  49. package/motion/interruption-and-retargeting.md +90 -0
  50. package/motion/observed-choreography.md +73 -0
  51. package/motion/rendering-and-performance.md +89 -0
  52. package/package.json +60 -8
  53. package/platform-guides/adaptive-navigation.md +85 -0
  54. package/platform-guides/index.md +6 -0
  55. package/platform-guides/input-and-focus.md +91 -0
  56. package/platform-guides/preferences-and-accessibility.md +90 -0
  57. package/scripts/compiler/README.md +112 -0
  58. package/scripts/compiler/cli.mjs +51 -0
  59. package/scripts/compiler/mcp.mjs +53 -0
  60. package/scripts/compiler/operations.mjs +70 -0
  61. package/scripts/compiler/runtime.mjs +156 -0
  62. package/scripts/sg-entry.mjs +20 -0
  63. package/scripts/sg-server.mjs +20 -0
package/DOMAINS.md CHANGED
@@ -26,11 +26,11 @@ This manifest is the source of truth for top-level StyleGallery domains. A domai
26
26
  | Domain | Manual hub | Governed leaves |
27
27
  | --- | --- | --- |
28
28
  | Layout | `layout/index.md` | Existing `GUIDE.md`, Layout-specific `guides/*.md`, and `recipes/*.md`; generated `patterns/**/*.md` and `CATALOG.md` remain at current paths. Shared `quality/**/*.md` infrastructure governs every domain without becoming a Layout leaf. |
29
- | Motion | `motion/index.md` | `motion/vocabulary.md`, `motion/review-workflow.md`, `motion/practice-reference.md`, `motion/decision-tree.md`, `motion/motion-brief.md`, `motion/interaction-recipes.md` |
30
- | Design Engineering | `design-engineering/index.md` | `design-engineering/interface-craft.md`, `design-engineering/consumer-migration-readiness.md`, `design-engineering/reference-profiles/index.md`, `design-engineering/reference-profiles/governed-local/index.md`, `design-engineering/reference-profiles/external-adaptation/index.md`, `design-engineering/decision-tree.md`, `design-engineering/component-contract.md`, `design-engineering/worked-examples.md` |
29
+ | Motion | `motion/index.md` | `motion/vocabulary.md`, `motion/review-workflow.md`, `motion/practice-reference.md`, `motion/decision-tree.md`, `motion/motion-brief.md`, `motion/interaction-recipes.md`, `motion/observed-choreography.md`, `motion/accessible-motion.md`, `motion/interruption-and-retargeting.md`, `motion/rendering-and-performance.md` |
30
+ | Design Engineering | `design-engineering/index.md` | `design-engineering/interface-craft.md`, `design-engineering/consumer-migration-readiness.md`, `design-engineering/reference-profiles/index.md`, `design-engineering/reference-profiles/governed-local/index.md`, `design-engineering/reference-profiles/external-adaptation/index.md`, `design-engineering/decision-tree.md`, `design-engineering/component-contract.md`, `design-engineering/worked-examples.md`, `design-engineering/state-management/decision-tree.md`, `design-engineering/state-management/index.md`, `design-engineering/state-management/patterns/derived-state.md`, `design-engineering/state-management/patterns/draft-and-baseline.md`, `design-engineering/state-management/patterns/id-selection.md`, `design-engineering/state-management/patterns/identity-reset.md`, `design-engineering/state-management/patterns/latest-request-wins.md`, `design-engineering/state-management/patterns/optimistic-overlay.md`, `design-engineering/state-management/patterns/single-flight.md`, `design-engineering/state-management/patterns/single-owner.md`, `design-engineering/state-management/patterns/submitted-snapshot.md`, `design-engineering/state-management/patterns/unsaved-navigation.md`, `design-engineering/state-management/patterns/url-state.md`, `design-engineering/state-management/patterns/versioned-restore.md`, `design-engineering/state-management/recipes/delete-undo.md`, `design-engineering/state-management/recipes/index.md`, `design-engineering/state-management/recipes/multi-step-form.md`, `design-engineering/state-management/recipes/search-detail.md`, `design-engineering/state-management/recipes/settings-save.md`, `design-engineering/state-management/state-brief.md`, `design-engineering/state-management/verification.md`, `design-engineering/native-interaction-contracts.md`, `design-engineering/text-input-and-internationalization.md`, `design-engineering/loading-and-feedback.md` |
31
31
  | Game UI | `game-ui/index.md` | `game-ui/classification.md`, `game-ui/screen-hierarchy.md`, `game-ui/reference-record.md`, `game-ui/unity/architecture.md`, `game-ui/unity/ui-systems.md`, `game-ui/unity/cli-loop.md`, `game-ui/unity/repository-map.md`, `game-ui/unity/org-wiki.md`, `game-ui/decision-tree.md`, `game-ui/screen-recipes.md`, `game-ui/verification-workflow.md` |
32
- | Platform Guides | `platform-guides/index.md` | `platform-guides/apple-interaction.md`, `platform-guides/adaptation-workflow.md`, `platform-guides/android-interaction.md`, `platform-guides/windows-interaction.md`, `platform-guides/compatibility-matrix.md` |
33
- | Design Terminology | `design-terminology/index.md` | `design-terminology/source-kinds.md`, `design-terminology/source-vocabularies.md`, `design-terminology/concept-families.md`, `design-terminology/relation-types.md`, `design-terminology/conflict-cases.md`, `design-terminology/comparison-workflow.md` |
32
+ | Platform Guides | `platform-guides/index.md` | `platform-guides/apple-interaction.md`, `platform-guides/adaptation-workflow.md`, `platform-guides/android-interaction.md`, `platform-guides/windows-interaction.md`, `platform-guides/compatibility-matrix.md`, `platform-guides/adaptive-navigation.md`, `platform-guides/preferences-and-accessibility.md`, `platform-guides/input-and-focus.md` |
33
+ | Design Terminology | `design-terminology/index.md` | `design-terminology/source-kinds.md`, `design-terminology/source-vocabularies.md`, `design-terminology/concept-families.md`, `design-terminology/relation-types.md`, `design-terminology/conflict-cases.md`, `design-terminology/comparison-workflow.md`, `design-terminology/token-semantics.md`, `design-terminology/interaction-semantics.md`, `design-terminology/typography-semantics.md` |
34
34
 
35
35
  ## Shared Non-Domain Infrastructure
36
36
 
package/GOVERNANCE.md CHANGED
@@ -39,7 +39,7 @@ Use this file before editing repository documentation. It names which file is au
39
39
  | Domain manifest and scope decision | `DOMAINS.md`, `quality/claim-records/stylegallery-multidomain-scope.md` | Manual | None | `stable` | Domain membership, repository-scope, or provenance-policy changes. | `scripts/validate-domains.mjs`, `scripts/validate-governance.mjs` | Repository governance owner |
40
40
  | Layout domain hub | `layout/index.md` | Manual | None | `stable` | Layout route or ownership changes. | `scripts/validate-domains.mjs`, `scripts/validate-ia.mjs` | Pattern-data owner |
41
41
  | Motion domain guidance | `motion/*.md` | Manual | None | `experimental` | Upstream revision, evidence boundary, or guidance changes. | `scripts/validate-domains.mjs` | Motion domain owner |
42
- | Design Engineering domain guidance | `design-engineering/*.md` | Manual | None | `experimental` | Upstream revision, evidence boundary, or guidance changes. | `scripts/validate-domains.mjs` | Design Engineering domain owner |
42
+ | Design Engineering domain guidance | `design-engineering/*.md`, `design-engineering/state-management/**/*.md` | Manual | None | `experimental` | Upstream revision, evidence boundary, or guidance changes. | `scripts/validate-domains.mjs` | Design Engineering domain owner |
43
43
  | Game UI domain guidance | `game-ui/**/*.md` | Manual | None | `experimental` | Classification, hierarchy, engine implementation, evidence boundary, or route changes. | `scripts/validate-domains.mjs` | Game UI domain owner |
44
44
  | Platform Guides domain guidance | `platform-guides/*.md` | Manual | None | `experimental` | Platform version, upstream revision, evidence boundary, or guidance changes. | `scripts/validate-domains.mjs` | Platform Guides domain owner |
45
45
  | Design Terminology domain guidance | `design-terminology/*.md` | Manual; term and relation tables remain authoring sources | None | `experimental` | Source-kind, source-vocabulary, concept-family, relation-model, or conflict-case changes. | `scripts/validate-domains.mjs`, `scripts/validate-design-terminology.mjs` | Design Terminology domain owner |
package/LICENSE ADDED
@@ -0,0 +1,28 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 IYEN
4
+
5
+ This license applies to the source code in this repository: scripts, CLI and
6
+ MCP server implementations, the website and server code under `site/`,
7
+ validators, and test code. The Markdown documentation, pattern and recipe
8
+ prose, and domain documents are licensed separately under CC BY 4.0; see
9
+ LICENSE-DOCS. Third-party material adapted into this repository keeps its
10
+ original rights; see NOTICE.
11
+
12
+ Permission is hereby granted, free of charge, to any person obtaining a copy
13
+ of this software and associated documentation files (the "Software"), to deal
14
+ in the Software without restriction, including without limitation the rights
15
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
16
+ copies of the Software, and to permit persons to whom the Software is
17
+ furnished to do so, subject to the following conditions:
18
+
19
+ The above copyright notice and this permission notice shall be included in all
20
+ copies or substantial portions of the Software.
21
+
22
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
23
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
25
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
26
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
27
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
28
+ SOFTWARE.
package/LICENSE-DOCS ADDED
@@ -0,0 +1,42 @@
1
+ Creative Commons Attribution 4.0 International (CC BY 4.0)
2
+
3
+ Copyright (c) 2026 IYEN
4
+
5
+ This license applies to the documentation in this repository: the Markdown
6
+ documents of the Layout, Motion, Design Engineering, Game UI, Platform Guides,
7
+ and Design Terminology domains, including `patterns/`, `recipes/`, `guides/`,
8
+ `GUIDE.md`, `CATALOG.md`, the domain index and contract documents, the
9
+ observation transcription formats, and the generated documentation under
10
+ `site/` that is derived from them.
11
+
12
+ It does not apply to source code (see LICENSE, MIT), and it does not apply to
13
+ material adapted from third-party sources, which keeps its original rights
14
+ (see NOTICE).
15
+
16
+ You are free to:
17
+
18
+ Share - copy and redistribute the material in any medium or format for any
19
+ purpose, even commercially.
20
+ Adapt - remix, transform, and build upon the material for any purpose, even
21
+ commercially.
22
+
23
+ Under the following terms:
24
+
25
+ Attribution - You must give appropriate credit, provide a link to the
26
+ license, and indicate if changes were made. You may do so in
27
+ any reasonable manner, but not in any way that suggests the
28
+ licensor endorses you or your use.
29
+
30
+ No additional restrictions - You may not apply legal terms or technological
31
+ measures that legally restrict others from doing anything the
32
+ license permits.
33
+
34
+ Suggested attribution:
35
+
36
+ "StyleGallery" by IYEN, https://github.com/changeroa/StyleGallery,
37
+ licensed under CC BY 4.0.
38
+
39
+ The summary above is not a substitute for the license. The full legal code is
40
+ the binding text:
41
+
42
+ https://creativecommons.org/licenses/by/4.0/legalcode
package/NOTICE ADDED
@@ -0,0 +1,38 @@
1
+ StyleGallery
2
+ Copyright (c) 2026 IYEN
3
+
4
+ Licensing of this repository is split by kind of content:
5
+
6
+ - Source code: MIT License, see LICENSE.
7
+ - Documentation: Creative Commons Attribution 4.0 International, see
8
+ LICENSE-DOCS.
9
+
10
+ Third-party material
11
+
12
+ Some documentation leaves are independent method rewrites adapted from
13
+ external sources. Those sources keep their own rights; the licenses above
14
+ cover only the StyleGallery-authored expression. The repository does not
15
+ retain upstream prose, tables, code samples, distinctive examples, or
16
+ distinctive sequence from those sources, and it does not claim any license
17
+ over them.
18
+
19
+ Where a leaf was adapted from an external source, that leaf's own page
20
+ metadata records `source_repository`, the exact `source_path`, and the full
21
+ `source_revision`. Leaves authored locally carry `provenance_kind: local` and
22
+ no upstream fields. The governing rules are in DOMAINS.md under "External
23
+ Adaptation Contract".
24
+
25
+ The initial five domain leaves were inspired by emilkowalski/skills
26
+ (https://github.com/emilkowalski/skills) at snapshot
27
+ 220e8607c90b17337d210125777b7b695f26c221, which is published under the MIT
28
+ License. If recognizable upstream expression is ever added, the full upstream
29
+ MIT notice is preserved alongside it and the copied material is recorded
30
+ separately before merge.
31
+
32
+ Observation records
33
+
34
+ Documents that describe observed behavior of third-party websites or
35
+ products are unofficial observation records. They are not affiliated with,
36
+ endorsed by, or derived from the code, assets, or copy of the sites they
37
+ describe, and product or company names in them are used only to identify the
38
+ subject of observation.
package/README.md CHANGED
@@ -7,7 +7,7 @@ description: Governed gallery of portable interface knowledge organized by domai
7
7
  # StyleGallery
8
8
 
9
9
  <p align="center">
10
- <img src="https://cdn.jsdelivr.net/gh/changeroa/StyleGallery@c18bc87/assets/stylegallery-hero-infographic.webp" alt="StyleGallery infographic connecting six governed interface-knowledge domains to shared consumer and agent infrastructure" width="100%">
10
+ <img width="1774" height="887" alt="ChatGPT Image 2026년 9월 17일 오후 04_28_00" src="https://github.com/user-attachments/assets/a5ce35c0-546a-4e19-9d79-751a51c5e103" />
11
11
  </p>
12
12
 
13
13
  StyleGallery is a governed gallery of portable interface knowledge. It separates reusable spatial patterns, product-layer motion guidance, design-engineering practice, platform-specific references, and comparative design terminology into explicit domains with different evidence and ownership boundaries.
@@ -18,7 +18,7 @@ The existing Layout corpus remains a gallery of minimal, portable CSS layout pat
18
18
 
19
19
  [Consumer Reference](consumer-reference/index.md) is shared non-domain infrastructure for optional consumer-owned reference handoffs. It carries schema, routing, provenance, and evidence metadata without owning profiles, visual values, components, or a seventh domain.
20
20
 
21
- [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) is the machine-facing entry point over that governed knowledge. Frozen v1 provides claim/evidence/governance records through `sg` and its MCP; isolated material v2 indexes admitted Markdown and exposes `sg-material` plus a separate read-only MCP. Lifecycle records own extension and archive dispositions. These material, trust/conformance, transport, and extension planes do not create a seventh domain, replace the Markdown corpus, permit mutation, or feed visual defaults back into Layout.
21
+ [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) documents the frozen v1 claim/evidence/governance interface. The `sg` CLI and main MCP server also expose [website compilation](scripts/compiler/README.md) through a separately installed compiler; isolated material v2 indexes admitted Markdown through `sg-material` and its read-only MCP. Lifecycle records own extension and archive dispositions. These interfaces do not create a seventh domain, replace the Markdown corpus, permit mutation of governed knowledge, or feed visual defaults back into Layout.
22
22
 
23
23
  ## Quick Start
24
24
 
@@ -46,7 +46,20 @@ sg context sg:profile/editorial-reference-profile --format json
46
46
  sg ops --format json
47
47
  ```
48
48
 
49
- Every command writes deterministic JSON to stdout. Invalid input returns an error object and a nonzero exit status. See [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) for the command contract, StableRef and VersionID model, MCP resources, and trust boundaries.
49
+ Every command writes JSON to stdout. Knowledge results retain their deterministic v1 payloads; `discover` and `ops` also report the local compiler installation. Invalid input returns an error object and a nonzero exit status. See [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) for the frozen knowledge contract, StableRef and VersionID model, MCP resources, and trust boundaries.
50
+
51
+ Compile a website directly through SG after [installing the compiler](scripts/compiler/README.md#setup):
52
+
53
+ ```sh
54
+ export SG_COMPILER_ROOT=/absolute/path/to/site-compiler
55
+ sg compile --url https://example.com --out ./captures/example
56
+ sg timeline --url https://example.com --out ./captures/example --step 500
57
+ sg workflow
58
+ ```
59
+
60
+ `compile`, `timeline`, `transcribe`, `sale`, `gate`, and `build` are direct SG commands and MCP tool names. See [SG Website Compilation](scripts/compiler/README.md) for all commands, configuration, output ownership, and verification.
61
+
62
+ Start with `sg workflow` to select the stages for reconstruction, adaptation, or sale-package production. For a faithful clone, use available original media and fill document gaps by inspecting the source. The automatic `build` command is a sale-edition preview with restricted source access; it is not the general clone builder.
50
63
 
51
64
  Material v2 searches the admitted Markdown corpus and returns JSON without an additional format flag:
52
65
 
@@ -66,7 +79,7 @@ The [Toss-inspired homepage clone](examples/toss-homepage-clone/README.md) appli
66
79
 
67
80
  The [Scroll Story Lab](examples/scroll-story/README.md) adds runnable scroll-controlled product chapters, an image sequence with bounded decoding, native CSS scrubbing, and a static reading path. Start from [Motion’s scroll-driven story](motion/interaction-recipes.md#scroll-driven-story) for ownership and failure cases. The [Scene Navigation example](examples/scene-navigation/README.md) keeps the entire page fixed while wheel, keys, chapter links, and art-surface swipes select scenes; its [separate contract](motion/interaction-recipes.md#full-viewport-scene-navigation) covers input ownership, history, focus, and reading escape.
68
81
 
69
- ### Read-only MCP server
82
+ ### MCP server
70
83
 
71
84
  Launch the packaged stdio server with:
72
85
 
@@ -87,7 +100,7 @@ Example MCP client configuration:
87
100
  }
88
101
  ```
89
102
 
90
- The MCP surface exposes governed read operations only. It cannot modify repository knowledge.
103
+ The main MCP server exposes governed read operations and compiler execution tools. Configure `SG_COMPILER_ROOT` in its environment to use the compiler. Execution tools declare file and network effects; the knowledge registry remains a read-only API. The frozen read-only server remains available as `npm run sg:mcp:v1`.
91
104
 
92
105
  The separate Material v2 MCP server is available as `stylegallery-material-mcp`.
93
106
 
@@ -110,6 +123,8 @@ sg discover --format json
110
123
 
111
124
  CLI와 MCP의 상세 사용법은 [Agent-Native StyleGallery 가이드](consumer-reference/agent-native/README.md)를 참고하세요. 사람이 문서를 탐색하려면 아래의 도메인 표에서 목적에 맞는 진입점을 선택하면 됩니다.
112
125
 
126
+ For UI state ownership, asynchronous races, drafts, URL/history, and persistence, start with [State Management](design-engineering/state-management/index.md) in Design Engineering.
127
+
113
128
  ## Domains
114
129
 
115
130
  | Domain | Owns | Does not own |
@@ -184,7 +199,7 @@ Each common task has one primary route. Use secondary links only after the prima
184
199
  | `check whether a layout or design claim is admissible` | [Quality Gates](quality/index.md) | It routes claims to gates and evidence boundaries. |
185
200
  | `prove repository checks and evidence coverage` | [Executable Evidence Coverage](quality/evidence/executable-evidence.md) | It maps validators, fixtures, CI commands, and their boundaries. |
186
201
  | `declare consumer reference applicability` | [Consumer Reference](consumer-reference/index.md) | It provides the required handoff field without moving consumer values into Layout. |
187
- | `use StyleGallery from an agent or automation` | [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) | It routes frozen v1 trust queries, material v2 discovery/search/get/context, both read-only MCPs, extensions, lifecycle dispositions, and archive boundaries. |
202
+ | `use StyleGallery from an agent or automation` | [Agent-Native StyleGallery](consumer-reference/agent-native/README.md) | It routes frozen v1 trust queries, material v2 discovery/search/get/context, extensions, lifecycle dispositions, and archive boundaries. Use [SG Website Compilation](scripts/compiler/README.md) for compiler commands in the main CLI and MCP. |
188
203
  | `prove an existing consumer migration` | [Consumer Migration Readiness](design-engineering/consumer-migration-readiness.md) | It requires thirteen explicit behavior classifications, runtime proof, adoption mappings, and source-bound page evidence when applicable. |
189
204
  | `change generated patterns, catalog, or governance policy` | [Governance, Lifecycle, And Docs-As-Code](GOVERNANCE.md) | It identifies source files, generated artifacts, validators, lifecycle state, and review ownership. |
190
205
  | `run findability QA` | [Tree-Test Findability QA](quality/index.md#tree-test-findability-qa) | It tests whether task routes are discoverable, not just linked. |
@@ -236,3 +251,7 @@ Every pattern documents its primary problem, structure, constraints, scroll owne
236
251
  ## Verification Matrix
237
252
 
238
253
  Pattern verification covers the relevant viewport, container, content, direction, writing-mode, interaction, overflow, focus, and sticky/scroll cases. See the [detailed verification matrix](layout/index.md#verification-matrix).
254
+
255
+ ## License
256
+
257
+ Source code is licensed under the MIT License ([LICENSE](LICENSE)). Documentation is licensed under Creative Commons Attribution 4.0 International ([LICENSE-DOCS](LICENSE-DOCS)). Material adapted from external sources keeps its original rights; see [NOTICE](NOTICE) and the [External Adaptation Contract](DOMAINS.md#external-adaptation-contract).
@@ -6,7 +6,7 @@ description: Machine-facing identity, query, execution, protocol-projection, and
6
6
 
7
7
  # Agent-Native StyleGallery
8
8
 
9
- Primary role: machine interface guide.
9
+ Primary role: frozen v1 knowledge interface guide. For the current `sg` CLI and main MCP server, including compiler execution, use [SG Website Compilation](../../scripts/compiler/README.md).
10
10
 
11
11
  Agent-Native StyleGallery lets a person, script, or agent inspect the governed StyleGallery knowledge graph without learning repository paths first. The Markdown corpus remains the human-readable source material; the agent-native layer gives its governed fixture records stable identities, closed schemas, deterministic operations, and protocol-specific projections.
12
12
 
@@ -31,11 +31,11 @@ The canonical fixture and operation inventory is [registry.json](registry.json).
31
31
  Run the CLI from the repository root:
32
32
 
33
33
  ```sh
34
- npm run sg -- discover --format json
35
- npm run sg -- resolve sg:profile/editorial-reference-profile --format json
36
- npm run sg -- claims sg:profile/editorial-reference-profile --format json
37
- npm run sg -- context sg:profile/editorial-reference-profile --format json
38
- npm run sg -- ops --format json
34
+ npm run sg:v1 -- discover --format json
35
+ npm run sg:v1 -- resolve sg:profile/editorial-reference-profile --format json
36
+ npm run sg:v1 -- claims sg:profile/editorial-reference-profile --format json
37
+ npm run sg:v1 -- context sg:profile/editorial-reference-profile --format json
38
+ npm run sg:v1 -- ops --format json
39
39
  ```
40
40
 
41
41
  The executable can also be invoked directly:
@@ -72,7 +72,7 @@ stylegallery-material search --query "design terminology source kinds" --paths-o
72
72
  Start the stdio MCP server with:
73
73
 
74
74
  ```sh
75
- npm run sg:mcp
75
+ npm run sg:mcp:v1
76
76
  ```
77
77
 
78
78
  An MCP client can launch it directly:
@@ -74,6 +74,126 @@
74
74
  "domain": "design-engineering",
75
75
  "lifecycle": "experimental"
76
76
  },
77
+ {
78
+ "repository_path": "design-engineering/loading-and-feedback.md",
79
+ "domain": "design-engineering",
80
+ "lifecycle": "experimental"
81
+ },
82
+ {
83
+ "repository_path": "design-engineering/native-interaction-contracts.md",
84
+ "domain": "design-engineering",
85
+ "lifecycle": "experimental"
86
+ },
87
+ {
88
+ "repository_path": "design-engineering/state-management/decision-tree.md",
89
+ "domain": "design-engineering",
90
+ "lifecycle": "experimental"
91
+ },
92
+ {
93
+ "repository_path": "design-engineering/state-management/index.md",
94
+ "domain": "design-engineering",
95
+ "lifecycle": "experimental"
96
+ },
97
+ {
98
+ "repository_path": "design-engineering/state-management/patterns/derived-state.md",
99
+ "domain": "design-engineering",
100
+ "lifecycle": "experimental"
101
+ },
102
+ {
103
+ "repository_path": "design-engineering/state-management/patterns/draft-and-baseline.md",
104
+ "domain": "design-engineering",
105
+ "lifecycle": "experimental"
106
+ },
107
+ {
108
+ "repository_path": "design-engineering/state-management/patterns/id-selection.md",
109
+ "domain": "design-engineering",
110
+ "lifecycle": "experimental"
111
+ },
112
+ {
113
+ "repository_path": "design-engineering/state-management/patterns/identity-reset.md",
114
+ "domain": "design-engineering",
115
+ "lifecycle": "experimental"
116
+ },
117
+ {
118
+ "repository_path": "design-engineering/state-management/patterns/latest-request-wins.md",
119
+ "domain": "design-engineering",
120
+ "lifecycle": "experimental"
121
+ },
122
+ {
123
+ "repository_path": "design-engineering/state-management/patterns/optimistic-overlay.md",
124
+ "domain": "design-engineering",
125
+ "lifecycle": "experimental"
126
+ },
127
+ {
128
+ "repository_path": "design-engineering/state-management/patterns/single-flight.md",
129
+ "domain": "design-engineering",
130
+ "lifecycle": "experimental"
131
+ },
132
+ {
133
+ "repository_path": "design-engineering/state-management/patterns/single-owner.md",
134
+ "domain": "design-engineering",
135
+ "lifecycle": "experimental"
136
+ },
137
+ {
138
+ "repository_path": "design-engineering/state-management/patterns/submitted-snapshot.md",
139
+ "domain": "design-engineering",
140
+ "lifecycle": "experimental"
141
+ },
142
+ {
143
+ "repository_path": "design-engineering/state-management/patterns/unsaved-navigation.md",
144
+ "domain": "design-engineering",
145
+ "lifecycle": "experimental"
146
+ },
147
+ {
148
+ "repository_path": "design-engineering/state-management/patterns/url-state.md",
149
+ "domain": "design-engineering",
150
+ "lifecycle": "experimental"
151
+ },
152
+ {
153
+ "repository_path": "design-engineering/state-management/patterns/versioned-restore.md",
154
+ "domain": "design-engineering",
155
+ "lifecycle": "experimental"
156
+ },
157
+ {
158
+ "repository_path": "design-engineering/state-management/recipes/delete-undo.md",
159
+ "domain": "design-engineering",
160
+ "lifecycle": "experimental"
161
+ },
162
+ {
163
+ "repository_path": "design-engineering/state-management/recipes/index.md",
164
+ "domain": "design-engineering",
165
+ "lifecycle": "experimental"
166
+ },
167
+ {
168
+ "repository_path": "design-engineering/state-management/recipes/multi-step-form.md",
169
+ "domain": "design-engineering",
170
+ "lifecycle": "experimental"
171
+ },
172
+ {
173
+ "repository_path": "design-engineering/state-management/recipes/search-detail.md",
174
+ "domain": "design-engineering",
175
+ "lifecycle": "experimental"
176
+ },
177
+ {
178
+ "repository_path": "design-engineering/state-management/recipes/settings-save.md",
179
+ "domain": "design-engineering",
180
+ "lifecycle": "experimental"
181
+ },
182
+ {
183
+ "repository_path": "design-engineering/state-management/state-brief.md",
184
+ "domain": "design-engineering",
185
+ "lifecycle": "experimental"
186
+ },
187
+ {
188
+ "repository_path": "design-engineering/state-management/verification.md",
189
+ "domain": "design-engineering",
190
+ "lifecycle": "experimental"
191
+ },
192
+ {
193
+ "repository_path": "design-engineering/text-input-and-internationalization.md",
194
+ "domain": "design-engineering",
195
+ "lifecycle": "experimental"
196
+ },
77
197
  {
78
198
  "repository_path": "design-engineering/worked-examples.md",
79
199
  "domain": "design-engineering",
@@ -99,6 +219,11 @@
99
219
  "domain": "design-terminology",
100
220
  "lifecycle": "experimental"
101
221
  },
222
+ {
223
+ "repository_path": "design-terminology/interaction-semantics.md",
224
+ "domain": "design-terminology",
225
+ "lifecycle": "experimental"
226
+ },
102
227
  {
103
228
  "repository_path": "design-terminology/relation-types.md",
104
229
  "domain": "design-terminology",
@@ -114,6 +239,16 @@
114
239
  "domain": "design-terminology",
115
240
  "lifecycle": "experimental"
116
241
  },
242
+ {
243
+ "repository_path": "design-terminology/token-semantics.md",
244
+ "domain": "design-terminology",
245
+ "lifecycle": "experimental"
246
+ },
247
+ {
248
+ "repository_path": "design-terminology/typography-semantics.md",
249
+ "domain": "design-terminology",
250
+ "lifecycle": "experimental"
251
+ },
117
252
  {
118
253
  "repository_path": "game-ui/classification.md",
119
254
  "domain": "game-ui",
@@ -214,6 +349,11 @@
214
349
  "domain": "shared",
215
350
  "lifecycle": "stable"
216
351
  },
352
+ {
353
+ "repository_path": "motion/accessible-motion.md",
354
+ "domain": "motion",
355
+ "lifecycle": "experimental"
356
+ },
217
357
  {
218
358
  "repository_path": "motion/decision-tree.md",
219
359
  "domain": "motion",
@@ -229,16 +369,31 @@
229
369
  "domain": "motion",
230
370
  "lifecycle": "experimental"
231
371
  },
372
+ {
373
+ "repository_path": "motion/interruption-and-retargeting.md",
374
+ "domain": "motion",
375
+ "lifecycle": "experimental"
376
+ },
232
377
  {
233
378
  "repository_path": "motion/motion-brief.md",
234
379
  "domain": "motion",
235
380
  "lifecycle": "experimental"
236
381
  },
382
+ {
383
+ "repository_path": "motion/observed-choreography.md",
384
+ "domain": "motion",
385
+ "lifecycle": "experimental"
386
+ },
237
387
  {
238
388
  "repository_path": "motion/practice-reference.md",
239
389
  "domain": "motion",
240
390
  "lifecycle": "experimental"
241
391
  },
392
+ {
393
+ "repository_path": "motion/rendering-and-performance.md",
394
+ "domain": "motion",
395
+ "lifecycle": "experimental"
396
+ },
242
397
  {
243
398
  "repository_path": "motion/review-workflow.md",
244
399
  "domain": "motion",
@@ -534,6 +689,11 @@
534
689
  "domain": "platform-guides",
535
690
  "lifecycle": "experimental"
536
691
  },
692
+ {
693
+ "repository_path": "platform-guides/adaptive-navigation.md",
694
+ "domain": "platform-guides",
695
+ "lifecycle": "experimental"
696
+ },
537
697
  {
538
698
  "repository_path": "platform-guides/android-interaction.md",
539
699
  "domain": "platform-guides",
@@ -554,6 +714,16 @@
554
714
  "domain": "platform-guides",
555
715
  "lifecycle": "experimental"
556
716
  },
717
+ {
718
+ "repository_path": "platform-guides/input-and-focus.md",
719
+ "domain": "platform-guides",
720
+ "lifecycle": "experimental"
721
+ },
722
+ {
723
+ "repository_path": "platform-guides/preferences-and-accessibility.md",
724
+ "domain": "platform-guides",
725
+ "lifecycle": "experimental"
726
+ },
557
727
  {
558
728
  "repository_path": "platform-guides/windows-interaction.md",
559
729
  "domain": "platform-guides",
@@ -817,5 +987,5 @@
817
987
  "code": "material_path_internal_excluded"
818
988
  }
819
989
  ],
820
- "version_id": "sg:policy/material-admission-v2@sha256:3bc645aa9b84393a404612ebc4d757aada288ef88f57bb2d2fca03022b4d201d"
990
+ "version_id": "sg:policy/material-admission-v2@sha256:9f2fc214681572314282a56dccc425d7faa1ac9aa939416892a97ab89c6c9b30"
821
991
  }