stylegallery 0.1.10 → 0.1.12

package/design-engineering/loading-and-feedback.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Loading, Progress, And Feedback
 description: Separate input acknowledgement, pending work, stale content, confirmed completion, and measurable responsiveness.
+aliases: ["loading state","spinner","skeleton","progress indicator","로딩 상태","스켈레톤","진행 표시"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/native-interaction-contracts.md

@@ -2,6 +2,8 @@
 type: Domain Guide
 title: Native Interaction Contracts
 description: Choose disclosure, dialog, popover, menu, and combobox behavior by semantics, focus, dismissal, and input ownership.
+aliases: ["dialog","popover","modal","menu","combobox","다이얼로그","팝오버","모달"]
+questions: ["When should I use a dialog instead of a popover?"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/state-management/patterns/latest-request-wins.md

@@ -2,6 +2,8 @@
 type: Domain Guide
 title: Latest Request Wins
 description: Prevent an older read response from replacing the result of a newer user intent.
+aliases: ["race condition","stale response","out of order responses","경쟁 조건","오래된 응답"]
+questions: ["How do I stop an older search response from replacing newer results?"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/state-management/patterns/optimistic-overlay.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Optimistic Overlay And Recovery
 description: Show a speculative change while preserving an authoritative base for recovery.
+aliases: ["optimistic update","optimistic UI","rollback","낙관적 업데이트"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/state-management/patterns/single-flight.md

@@ -2,6 +2,8 @@
 type: Domain Guide
 title: Single Flight And Duplicate Submission
 description: Apply an explicit policy to repeated activation of one pending operation.
+aliases: ["double submit","duplicate submission","prevent double click","중복 제출","중복 클릭 방지","중복 제출 방지"]
+questions: ["How do I prevent a form from being submitted twice?"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/state-management/patterns/unsaved-navigation.md

@@ -2,6 +2,8 @@
 type: Domain Guide
 title: Unsaved Changes And Navigation
 description: Make leaving an edited screen an explicit decision without losing the current draft.
+aliases: ["unsaved changes warning","leave page confirmation","beforeunload","저장하지 않은 변경 사항","이탈 경고"]
+questions: ["How do I warn before leaving with unsaved changes?"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/state-management/patterns/url-state.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: URL State And History
 description: Keep shareable screen state consistent across links, refresh, and browser history.
+aliases: ["query string state","filters in URL","deep link","URL 상태","쿼리 파라미터"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/state-management/recipes/delete-undo.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Deletion And Supported Undo
 description: Remove the intended entity and provide recovery that matches actual backend capabilities.
+aliases: ["undo delete","delete with undo","삭제 취소","실행 취소"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/design-engineering/text-input-and-internationalization.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Text Input And Internationalization
 description: Design composition-aware editing, explicit text units, bidirectional content, and locale-bound presentation without corrupting user input.
+aliases: ["IME","composition events","RTL","bidi","한글 입력","입력기 조합"]
 domain: design-engineering
 lifecycle: experimental
 provenance_kind: local

package/expression/directions/nocturne-editorial.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Nocturne Editorial Direction
 description: A dark, glowing, editorial direction with concrete type, color, texture, and motion-density values.
+aliases: ["dark theme direction","dark editorial","다크 에디토리얼"]
 domain: expression
 lifecycle: experimental
 provenance_kind: local

package/expression/directions/warm-print.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Warm Print Direction
 description: A light, warm, print-inspired direction with concrete type, color, texture, and motion-density values.
+aliases: ["light print style","warm editorial","따뜻한 인쇄 느낌"]
 domain: expression
 lifecycle: experimental
 provenance_kind: local

package/expression/techniques/gradient-atmosphere.md

@@ -2,6 +2,7 @@
 type: Domain Recipe
 title: Gradient Atmosphere
 description: Copy-ready blurred gradient fields, card glows, and gradient text for expressive product pages.
+aliases: ["blurred gradient","glow","gradient text","그라데이션 배경"]
 domain: expression
 lifecycle: experimental
 provenance_kind: local

package/expression/techniques/grain-and-texture.md

@@ -2,6 +2,7 @@
 type: Domain Recipe
 title: Grain And Texture
 description: Copy-ready film grain, noise, and halftone textures without image files.
+aliases: ["film grain","noise texture","halftone","그레인","노이즈 텍스처"]
 domain: expression
 lifecycle: experimental
 provenance_kind: local

package/expression/techniques/webgl-hero.md

@@ -2,6 +2,7 @@
 type: Domain Recipe
 title: WebGL Hero Field
 description: A three.js point field behind a hero, with pointer parallax, offscreen pausing, and safe fallbacks.
+aliases: ["three.js hero","WebGL background","3D hero","3D 배경"]
 domain: expression
 lifecycle: experimental
 provenance_kind: local

package/guides/decision-tree.md

@@ -2,6 +2,8 @@
 type: Planning Guide
 title: Layout Decision Tree
 description: Question-driven route from screen constraints to StyleGallery Layout patterns and recipes.
+aliases: ["choose a layout pattern","which pattern","레이아웃 패턴 고르기","패턴 선택"]
+questions: ["Which layout pattern should I use for this screen?"]
 ---
 
 # Layout Decision Tree

package/guides/webpage-generation-workflow.md

@@ -2,6 +2,8 @@
 type: Planning Guide
 title: Webpage Generation Workflow
 description: Intake-to-implementation workflow for turning raw content into a homepage or ordinary webpage layout.
+aliases: ["build a webpage from content","landing page workflow","웹페이지 만들기","랜딩 페이지 만들기"]
+questions: ["How do I turn raw content into a homepage or webpage layout?"]
 ---
 
 # Webpage Generation Workflow

package/log.md

@@ -1,7 +1,36 @@
 # StyleGallery Log
 
+## 2026-10-19
+
+Understood as: release `stylegallery@0.1.12`, which makes agent search one `stylegallery` command with BM25F ranking, Korean aliases, readable ids, section reads, and a CI retrieval gate.
+
+- CLI: `stylegallery` is the only command name. It adds `search`, `read`, `retrieve`, `help`/`--help`, and `version`/`--version` beside the existing governed and compiler commands; `context --query` builds the material context. The `sg` bin is removed because it collides with ast-grep. `sg-material`, `stylegallery-material`, and `stylegallery-material-mcp` print a rename notice and delegate in this release only. `stylegallery-mcp` gains `search` and `read` tools that return the same JSON as the CLI.
+- Search v3 (`scripts/agent-native/v2/material-search-v3.mjs`): BM25F over title, aliases, description, questions, path, headings, and body; Hangul 2-grams indexed only from Korean aliases, questions, and titles; an optional `query_en`; readable ids `sg:<domain>/<slug>` with hash identities kept for `--detailed`; schema 3.0 results with a verbatim snippet and the next `read` command; `read --outline` and `read --section`.
+- Metadata: frontmatter `aliases` and `questions` (JSON lists) for all 46 Layout patterns, through `scripts/pattern-data.mjs` and the pattern generator, and for 29 recipe, guide, motion, design-engineering, platform, and expression documents.
+- Evaluation: `eval/search/questions.json` holds 75 questions (56 English, 19 Korean or mixed, 19 must-pass, 15 held out from alias writing). `eval/search/scores.json` records the legacy ranker on the original corpus and search v3: Hit@5 0.613 to 0.973, nDCG@5 0.482 to 0.863, MRR 0.510 to 0.876, must-pass 14/19 to 19/19, Korean Hit@5 0.105 to 1.0, held-out Hit@5 0.533 to 0.867. `validate.yml` runs `scripts/test-stylegallery-search.mjs` and `scripts/search-eval.mjs --gate` on every pull request.
+- `skills/stylegallery-search/SKILL.md` ships one search how-to skill.
+
+Consumer reference: not_applicable
+Consumer reference reason: This change adds retrieval tooling and search metadata and selects no consumer-reference profile or record.
+
 ## 2026-10-16
 
+Understood as: release `stylegallery@0.1.11`, the first version published by the Trusted Publishing workflow from PR #57.
+
+- Bumped the package version from `0.1.10` to `0.1.11`. The release carries PR #57: `.github/workflows/publish.yml` publishes the package when a GitHub Release is published, authenticating to npm with GitHub OIDC instead of a token, and the README Releasing section describes the flow. This version is published by creating the GitHub Release `v0.1.11`, not from a local machine.
+- The package `files` list is unchanged. This release changes only the version, this log entry, the material registry for the log bytes, and the A2A and AG-UI caller inventories bound to `package.json` and the registry.
+
+Consumer reference: not_applicable
+Consumer reference reason: This change releases a package version and selects no consumer-reference profile or record.
+
+Understood as: publish the npm package from GitHub Actions through npm Trusted Publishing (OIDC) instead of a local token.
+
+- Added `.github/workflows/publish.yml`. A published GitHub Release runs it on a GitHub-hosted runner with `id-token: write`, Node 22, and npm 11.21.1 (Trusted Publishing needs npm 11.5.1 or later and Node 22.14 or later). It checks that the release tag is `v` plus the `package.json` version, runs the governance, lifecycle, reference-artifact, material, and Registrar checks and `npm pack --dry-run`, then runs `npm publish`. No npm token secret is used, and npm generates provenance for the public repository. Actions are pinned to the same commit SHAs as the other workflows.
+- `README.md` gains a Releasing section: merge the version-bump pull request, create a GitHub Release tagged `v<version>`, and the workflow publishes. The workflow cannot publish until the `stylegallery` package names `changeroa/StyleGallery` and `publish.yml` as a Trusted Publisher on npmjs.com with `npm publish` allowed. That registration is not done yet, because a new entry expires unless its first publish succeeds within two days. Source: https://docs.npmjs.com/trusted-publishers, read 2026-10-16.
+
+Consumer reference: not_applicable
+Consumer reference reason: This change adds a release workflow and its documentation and selects no consumer-reference profile or record.
+
 Understood as: release `stylegallery@0.1.10` with the Registrar, the Conservator, and the holy-grail and icon-frame doc fixes from PR #55.
 
 - Bumped the package version from `0.1.9` to `0.1.10`. The release carries PR #55: `sg registrar` checks every claim record against 35 rules, `sg conservator` renders all 46 Layout pattern exhibits at 320, 768, and 1440 CSS pixels with negative controls, `holy-grail` stacks below 48rem, and the `icon-frame` sample has `role="img"`.

package/motion/accessible-motion.md

@@ -2,6 +2,8 @@
 type: Domain Guide
 title: Accessible Motion And Equivalent Feedback
 description: Separate motion preferences, automatic updates, flashing, and semantic feedback before designing reduced-motion behavior.
+aliases: ["reduced motion","prefers-reduced-motion","motion sensitivity","모션 줄이기","애니메이션 줄이기","접근성 모션"]
+questions: ["How should the interface respond to prefers-reduced-motion?"]
 domain: motion
 lifecycle: experimental
 provenance_kind: local

package/motion/interruption-and-retargeting.md

@@ -2,6 +2,8 @@
 type: Domain Guide
 title: Interruption And Retargeting
 description: Keep semantic intent, presented motion, cancellation, and teardown consistent under repeated input.
+aliases: ["interrupted animation","animation cancellation","repeated clicks during animation","애니메이션 중단"]
+questions: ["What happens when the user triggers the same transition again mid-animation?"]
 domain: motion
 lifecycle: experimental
 provenance_kind: local

package/motion/rendering-and-performance.md

@@ -2,6 +2,7 @@
 type: Domain Guide
 title: Motion Rendering And Performance
 description: Diagnose animation cost and choose native transition mechanisms with measurable behavior and complete fallbacks.
+aliases: ["animation performance","jank","dropped frames","애니메이션 성능","버벅임"]
 domain: motion
 lifecycle: experimental
 provenance_kind: local

package/motion/techniques/kinetic-type.md

@@ -2,6 +2,7 @@
 type: Domain Recipe
 title: Kinetic Type Technique
 description: Copy-ready split-word headline rises, scroll-lit paragraphs, count-ups, and marquees that keep accessible text intact.
+aliases: ["text animation","headline animation","kinetic typography","텍스트 애니메이션","타이포 애니메이션"]
 domain: motion
 lifecycle: experimental
 provenance_kind: local

package/motion/techniques/scroll-choreography.md

@@ -2,6 +2,8 @@
 type: Domain Recipe
 title: Scroll Choreography Technique
 description: Copy-ready GSAP ScrollTrigger and Lenis setup, pinned horizontal travel, scrubbed scenes, and a native CSS scroll-timeline equivalent.
+aliases: ["scroll animation","ScrollTrigger","scroll-driven animation","pinned section","스크롤 애니메이션","스크롤 연출"]
+questions: ["How do I build a pinned horizontal scroll scene?"]
 domain: motion
 lifecycle: experimental
 provenance_kind: local

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stylegallery",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "A governed gallery of portable interface knowledge with knowledge CLIs, website compilation, and MCP servers.",
   "type": "module",
   "license": "MIT",
@@ -251,6 +251,7 @@
     "scripts/agent-native/v2/material-operation-registry.mjs",
     "scripts/agent-native/v2/material-queries.mjs",
     "scripts/agent-native/v2/material-registry.mjs",
+    "scripts/agent-native/v2/material-search-v3.mjs",
     "scripts/compiler/README.md",
     "scripts/compiler/cli.mjs",
     "scripts/compiler/mcp.mjs",
@@ -258,6 +259,8 @@
     "scripts/compiler/runtime.mjs",
     "scripts/conservator-exhibits.mjs",
     "scripts/conservator.mjs",
+    "scripts/legacy-sg-material-mcp.mjs",
+    "scripts/legacy-sg-material.mjs",
     "scripts/markdown-structure.mjs",
     "scripts/pattern-data.mjs",
     "scripts/registrar.mjs",
@@ -268,14 +271,15 @@
     "scripts/sg-server.mjs",
     "scripts/sg.mjs",
     "scripts/strict-json.mjs",
-    "showcase/README.md"
+    "scripts/stylegallery-cli.mjs",
+    "showcase/README.md",
+    "skills/stylegallery-search/SKILL.md"
   ],
   "bin": {
-    "sg": "scripts/sg-entry.mjs",
-    "sg-material": "scripts/sg-material.mjs",
+    "sg-material": "scripts/legacy-sg-material.mjs",
     "stylegallery": "scripts/sg-entry.mjs",
-    "stylegallery-material": "scripts/sg-material.mjs",
-    "stylegallery-material-mcp": "scripts/sg-material-mcp.mjs",
+    "stylegallery-material": "scripts/legacy-sg-material.mjs",
+    "stylegallery-material-mcp": "scripts/legacy-sg-material-mcp.mjs",
     "stylegallery-mcp": "scripts/sg-server.mjs"
   },
   "publishConfig": {
@@ -301,7 +305,6 @@
     "test:material": "node scripts/agent-native/v2/test-material-admission.mjs && node scripts/agent-native/v2/test-material-registry.mjs && node scripts/agent-native/v2/test-material-query.mjs && node scripts/agent-native/v2/test-material-context.mjs && node scripts/agent-native/v2/test-sg-material-cli.mjs && node scripts/agent-native/v2/test-material-mcp.mjs && node scripts/agent-native/v2/test-material-mcp-stdio.mjs && node scripts/agent-native/v2/test-sg-material-package.mjs",
     "test:lifecycle-dispositions": "node scripts/test-lifecycle-disposition.mjs",
     "validate:lifecycle-dispositions": "node scripts/validate-lifecycle-disposition.mjs --json",
-    "sg": "node scripts/sg-entry.mjs",
     "sg:material": "node scripts/sg-material.mjs",
     "sg:material:mcp": "node scripts/sg-material-mcp.mjs",
     "sg:mcp": "node scripts/sg-server.mjs",
@@ -318,7 +321,10 @@
     "showcase:serve": "node scripts/serve-showcase.mjs",
     "test:compiler": "node --test scripts/test-sg-compiler.mjs",
     "sg:v1": "node scripts/sg.mjs",
-    "sg:mcp:v1": "node scripts/sg-mcp.mjs"
+    "sg:mcp:v1": "node scripts/sg-mcp.mjs",
+    "stylegallery": "node scripts/sg-entry.mjs",
+    "test:search": "node --test scripts/test-stylegallery-search.mjs",
+    "eval:search": "node scripts/search-eval.mjs --gate"
   },
   "devDependencies": {
     "@playwright/test": "1.61.0",

package/patterns/centering/center.md

@@ -4,6 +4,7 @@ name: center
 title: center
 category: Centering
 description: Center a block while respecting a maximum measure.
+aliases: ["center horizontally","max width centered","가운데 정렬","수평 가운데 정렬"]
 primary_spatial_problem: Center a block while respecting a maximum measure.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/centering/super-center.md

@@ -4,6 +4,8 @@ name: super-center
 title: super-center
 category: Centering
 description: Center one region along both axes.
+aliases: ["center horizontally and vertically","center a div","place-items center","가운데 정렬","정중앙 정렬"]
+questions: ["How do I center an element both horizontally and vertically?"]
 primary_spatial_problem: Center one region along both axes.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/containment/box.md

@@ -4,6 +4,7 @@ name: box
 title: box
 category: Containment
 description: Wrap content with predictable internal spacing.
+aliases: ["padded box","내부 여백 박스"]
 primary_spatial_problem: Wrap content with predictable internal spacing.
 secondary_spatial_problems: none
 layout_axis: block

package/patterns/containment/clamped-card.md

@@ -4,6 +4,7 @@ name: clamped-card
 title: clamped-card
 category: Containment
 description: Constrain a card to a readable fluid width.
+aliases: ["card max width clamp","카드 폭 제한"]
 primary_spatial_problem: Constrain a card to a readable fluid width.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/containment/content-limiter.md

@@ -4,6 +4,8 @@ name: content-limiter
 title: content-limiter
 category: Containment
 description: Keep prose width readable inside fluid containers.
+aliases: ["readable line length","max measure","prose width","읽기 좋은 줄 길이","본문 폭 제한"]
+questions: ["How do I keep prose at a readable line length?"]
 primary_spatial_problem: Keep prose width readable inside fluid containers.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/containment/fluid-styles.md

@@ -4,6 +4,7 @@ name: fluid-styles
 title: fluid-styles
 category: Containment
 description: Let a region fill available width without exceeding a readable max.
+aliases: ["fluid width with max","유동 폭"]
 primary_spatial_problem: Let a region fill available width without exceeding a readable max.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/grid-repetition/card-grid.md

@@ -4,6 +4,8 @@ name: card-grid
 title: card-grid
 category: Grid / Repetition
 description: Align repeating cards in rows and columns.
+aliases: ["responsive card grid","cards in rows and columns","카드 그리드","반응형 카드 그리드","카드 목록"]
+questions: ["How do I align repeating cards into a responsive grid?"]
 primary_spatial_problem: Align repeating cards in rows and columns.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/grid-repetition/columns.md

@@ -4,6 +4,7 @@ name: columns
 title: columns
 category: Grid / Repetition
 description: Flow long content into balanced text columns.
+aliases: ["multi-column text","css columns","다단 텍스트"]
 primary_spatial_problem: Flow long content into balanced text columns.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/grid-repetition/dense-grid.md

@@ -4,6 +4,7 @@ name: dense-grid
 title: dense-grid
 category: Grid / Repetition
 description: Fill a compact grid with repeated small items.
+aliases: ["compact grid","grid-auto-flow dense","촘촘한 그리드"]
 primary_spatial_problem: Fill a compact grid with repeated small items.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/grid-repetition/grid-wrapper.md

@@ -4,6 +4,7 @@ name: grid-wrapper
 title: grid-wrapper
 category: Grid / Repetition
 description: Center grid tracks while allowing full-width breakout tracks.
+aliases: ["full bleed breakout","full-width breakout","풀 블리드","전체 폭 확장"]
 primary_spatial_problem: Center grid tracks while allowing full-width breakout tracks.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/grid-repetition/masonry-approx.md

@@ -4,6 +4,7 @@ name: masonry-approx
 title: masonry-approx
 category: Grid / Repetition
 description: Approximate staggered content with columns when exact row alignment is not needed.
+aliases: ["masonry","pinterest style","staggered layout","메이슨리","핀터레스트 스타일"]
 primary_spatial_problem: Approximate staggered content with columns when exact row alignment is not needed.
 secondary_spatial_problems: none
 layout_axis: block

package/patterns/grid-repetition/page-grid.md

@@ -4,6 +4,7 @@ name: page-grid
 title: page-grid
 category: Grid / Repetition
 description: Align page content to margins, gutters, and a central track.
+aliases: ["page margins and gutters","central content track","페이지 그리드"]
 primary_spatial_problem: Align page content to margins, gutters, and a central track.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/grid-repetition/ram-grid.md

@@ -4,6 +4,8 @@ name: ram-grid
 title: ram-grid
 category: Grid / Repetition
 description: Repeat items into as many useful columns as space allows.
+aliases: ["repeat auto-fit minmax","responsive grid without media queries","auto-fit grid","반응형 그리드","반응형 카드 그리드"]
+questions: ["How do I make a grid that fits as many columns as space allows without media queries?"]
 primary_spatial_problem: Repeat items into as many useful columns as space allows.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/grid-repetition/twelve-span-grid.md

@@ -4,6 +4,7 @@ name: twelve-span-grid
 title: twelve-span-grid
 category: Grid / Repetition
 description: Provide a twelve-column placement scaffold.
+aliases: ["12 column grid","twelve column layout","12단 그리드"]
 primary_spatial_problem: Provide a twelve-column placement scaffold.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/in-line-grouping/badge-list.md

@@ -4,6 +4,7 @@ name: badge-list
 title: badge-list
 category: In-line grouping
 description: Align item labels with trailing counts.
+aliases: ["tags with counts","labels with trailing counts","배지 목록","개수 표시 목록"]
 primary_spatial_problem: Align item labels with trailing counts.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/breadcrumb.md

@@ -4,6 +4,7 @@ name: breadcrumb
 title: breadcrumb
 category: In-line grouping
 description: Lay out hierarchy links compactly with wrapping.
+aliases: ["breadcrumbs","hierarchy links","브레드크럼","경로 표시"]
 primary_spatial_problem: Lay out hierarchy links compactly with wrapping.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/cluster.md

@@ -4,6 +4,7 @@ name: cluster
 title: cluster
 category: In-line grouping
 description: Keep related items together while allowing wrapping.
+aliases: ["inline group that wraps","tag group","항목 묶음","줄바꿈 그룹"]
 primary_spatial_problem: Keep related items together while allowing wrapping.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/deconstructed-pancake.md

@@ -4,6 +4,7 @@ name: deconstructed-pancake
 title: deconstructed-pancake
 category: In-line grouping
 description: Let equal cards stretch in a row and stack naturally when narrow.
+aliases: ["cards stretch then stack","flex wrap cards","카드 가로 배치 후 세로 쌓기"]
 primary_spatial_problem: Let equal cards stretch in a row and stack naturally when narrow.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/pagination.md

@@ -4,6 +4,7 @@ name: pagination
 title: pagination
 category: In-line grouping
 description: Lay out page controls as a bounded wrapping row.
+aliases: ["page numbers","page controls","페이지네이션","페이지 번호"]
 primary_spatial_problem: Lay out page controls as a bounded wrapping row.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/reel.md

@@ -4,6 +4,8 @@ name: reel
 title: reel
 category: In-line grouping
 description: Let a row scroll horizontally instead of wrapping.
+aliases: ["horizontal scroll row","carousel row","scrollable row","가로 스크롤","가로 스크롤 목록"]
+questions: ["How do I make a row scroll horizontally instead of wrapping?"]
 primary_spatial_problem: Let a row scroll horizontally instead of wrapping.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/split-nav.md

@@ -4,6 +4,7 @@ name: split-nav
 title: split-nav
 category: In-line grouping
 description: Separate primary and secondary nav actions in one row.
+aliases: ["navbar with left and right items","primary and secondary nav","내비게이션 바","좌우 분리 내비게이션"]
 primary_spatial_problem: Separate primary and secondary nav actions in one row.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/tab-strip.md

@@ -4,6 +4,7 @@ name: tab-strip
 title: tab-strip
 category: In-line grouping
 description: Keep peer tabs in one stable row that can wrap.
+aliases: ["tabs row","tab bar","탭 바","탭 메뉴"]
 primary_spatial_problem: Keep peer tabs in one stable row that can wrap.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/in-line-grouping/wrap-row.md

@@ -4,6 +4,7 @@ name: wrap-row
 title: wrap-row
 category: In-line grouping
 description: Wrap controls into rows with stable gaps.
+aliases: ["wrapping toolbar","button row that wraps","버튼 줄바꿈"]
 primary_spatial_problem: Wrap controls into rows with stable gaps.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/media-fit/frame.md

@@ -4,6 +4,8 @@ name: frame
 title: frame
 category: Media / Fit
 description: Preserve media aspect ratio in a responsive slot.
+aliases: ["aspect ratio box","responsive image slot","object-fit","이미지 비율 유지","종횡비"]
+questions: ["How do I keep media at a fixed aspect ratio?"]
 primary_spatial_problem: Preserve media aspect ratio in a responsive slot.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/media-fit/icon-frame.md

@@ -4,6 +4,7 @@ name: icon-frame
 title: icon-frame
 category: Media / Fit
 description: Keep an icon aligned inside a fixed square slot.
+aliases: ["icon slot","square icon box","아이콘 정렬"]
 primary_spatial_problem: Keep an icon aligned inside a fixed square slot.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/overlay-exception/imposter.md

@@ -4,6 +4,7 @@ name: imposter
 title: imposter
 category: Overlay / Exception
 description: Place an overlay region over a parent without changing document order.
+aliases: ["overlay over parent","positioned overlay","modal over card","오버레이","겹쳐 띄우기"]
 primary_spatial_problem: Place an overlay region over a parent without changing document order.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/overlay-exception/overlay-stack.md

@@ -4,6 +4,7 @@ name: overlay-stack
 title: overlay-stack
 category: Overlay / Exception
 description: Stack several regions into the same grid cell.
+aliases: ["stack in one grid cell","text over image","겹치는 레이어","이미지 위 텍스트"]
 primary_spatial_problem: Stack several regions into the same grid cell.
 secondary_spatial_problems: none
 layout_axis: both

package/patterns/split-sidebar/list-detail.md

@@ -4,6 +4,7 @@ name: list-detail
 title: list-detail
 category: Split / Sidebar
 description: Place an explorable list beside its detail region.
+aliases: ["master detail","list and detail panes","목록 상세","리스트 디테일"]
 primary_spatial_problem: Place an explorable list beside its detail region.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/split-sidebar/main-with-rail.md

@@ -4,6 +4,7 @@ name: main-with-rail
 title: main-with-rail
 category: Split / Sidebar
 description: Keep primary content dominant with a narrow secondary rail.
+aliases: ["content with right rail","secondary rail","메인과 보조 레일"]
 primary_spatial_problem: Keep primary content dominant with a narrow secondary rail.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/split-sidebar/media-object.md

@@ -4,6 +4,7 @@ name: media-object
 title: media-object
 category: Split / Sidebar
 description: Align media and descriptive content as a stable pair.
+aliases: ["image beside text","avatar with text","미디어 오브젝트","이미지와 텍스트 나란히"]
 primary_spatial_problem: Align media and descriptive content as a stable pair.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/split-sidebar/sidebar.md

@@ -4,6 +4,8 @@ name: sidebar
 title: sidebar
 category: Split / Sidebar
 description: Let a narrow sidebar and wider content wrap when space is tight.
+aliases: ["wrapping sidebar","intrinsic sidebar","사이드바","사이드바 레이아웃"]
+questions: ["How do I make a sidebar wrap under the content when space is tight?"]
 primary_spatial_problem: Let a narrow sidebar and wider content wrap when space is tight.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/split-sidebar/split-screen.md

@@ -4,6 +4,7 @@ name: split-screen
 title: split-screen
 category: Split / Sidebar
 description: Split a viewport or region into two balanced panes.
+aliases: ["two column split","50/50 split","화면 분할","2단 분할"]
 primary_spatial_problem: Split a viewport or region into two balanced panes.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/split-sidebar/sticky-aside.md

@@ -4,6 +4,8 @@ name: sticky-aside
 title: sticky-aside
 category: Split / Sidebar
 description: Keep related aside content visible during long reads.
+aliases: ["sticky sidebar","sticky table of contents","고정 사이드 영역","스티키 사이드바"]
+questions: ["How do I keep an aside visible during long reads?"]
 primary_spatial_problem: Keep related aside content visible during long reads.
 secondary_spatial_problems: none
 layout_axis: block