stylegallery 0.1.11 → 0.1.13

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
@@ -39,6 +40,12 @@ Use pending-until-confirmed deletion by default in this recipe. An optimistic ov
 | Delete the last row | Show empty state and move focus to a logical heading |
 | Undo expires or restoration fails | Explain failure and reconcile actual collection state |
 
+### Confirmation Versus Reversal
+
+[WCAG Error Prevention, SC 3.3.4](https://www.w3.org/WAI/WCAG22/Understanding/error-prevention-legal-financial-data.html) was rechecked 2026-10-19 against the 2024 WCAG 2.2 Recommendation. For its scoped legal/financial, user-controlled stored-data, and test-response submissions, at least one of three conditions applies: reversibility, input checking with correction opportunity, or review/confirmation with correction before finalization. This is a normative alternative set, not a study showing Undo always beats confirmation.
+
+Local decision: prefer supported recovery for frequent reversible low-cost actions; use explicit review before genuinely consequential irreversible commitment. Keep the existing backend contract decisive. A five-second toast cannot make an irreversible write reversible, and a confirm dialog cannot establish the accuracy of the submitted snapshot. Test expiry, failed restoration, unknown outcome, and focus after deleting the last item.
+
 ## Opinionated Guidance
 
 Keep the ownership boundaries visible when composing the patterns. One screen can combine these mechanisms without making every value global. Record the rejected alternative and its user-visible cost in the [state brief](../state-brief.md).

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,5 +1,27 @@
 # StyleGallery Log
 
+## 2026-10-19
+
+Understood as: release `stylegallery@0.1.13`, which ships the evidence-based UI pattern documents from PR #61 and the README CLI reference from PR #62.
+
+- Design Engineering: `design-engineering/evidence-patterns/` adds 12 documents (inline validation, error recovery, form labels, input masks, faceted filters, autocomplete, empty states, data tables, tabs and segmented controls, breadcrumbs, bottom navigation, dark-mode contrast) with 22 cited sources; `loading-and-feedback`, `native-interaction-contracts`, `platform-guides/input-and-focus`, and the `delete-undo` recipe gain evidence sections.
+- Search evaluation: 91 questions, Hit@5 0.978, nDCG@5 0.877, must-pass 35/35.
+- README: a CLI reference under Quick Start lists the agent loop and every command with its options.
+
+Consumer reference: not_applicable
+Consumer reference reason: This release adds documentation and selects no consumer-reference profile or record.
+
+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.

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.11",
+  "version": "0.1.13",
   "description": "A governed gallery of portable interface knowledge with knowledge CLIs, website compilation, and MCP servers.",
   "type": "module",
   "license": "MIT",
@@ -55,6 +55,19 @@
     "design-engineering/component-contract.md",
     "design-engineering/consumer-migration-readiness.md",
     "design-engineering/decision-tree.md",
+    "design-engineering/evidence-patterns/autocomplete.md",
+    "design-engineering/evidence-patterns/bottom-navigation.md",
+    "design-engineering/evidence-patterns/breadcrumbs.md",
+    "design-engineering/evidence-patterns/dark-mode-contrast.md",
+    "design-engineering/evidence-patterns/data-tables.md",
+    "design-engineering/evidence-patterns/empty-states.md",
+    "design-engineering/evidence-patterns/error-recovery.md",
+    "design-engineering/evidence-patterns/faceted-filters.md",
+    "design-engineering/evidence-patterns/form-labels.md",
+    "design-engineering/evidence-patterns/index.md",
+    "design-engineering/evidence-patterns/inline-validation.md",
+    "design-engineering/evidence-patterns/input-masks.md",
+    "design-engineering/evidence-patterns/tabs-and-segmented-controls.md",
     "design-engineering/index.md",
     "design-engineering/interface-craft.md",
     "design-engineering/loading-and-feedback.md",
@@ -251,6 +264,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 +272,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 +284,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 +318,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 +334,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

package/patterns/split-sidebar/supporting-pane.md

@@ -4,6 +4,7 @@ name: supporting-pane
 title: supporting-pane
 category: Split / Sidebar
 description: Keep supplemental information beside a primary task.
+aliases: ["supporting panel","보조 패널"]
 primary_spatial_problem: Keep supplemental information beside a primary task.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/split-sidebar/switcher.md

@@ -4,6 +4,8 @@ name: switcher
 title: switcher
 category: Split / Sidebar
 description: Switch equal regions from row to stack without a viewport breakpoint.
+aliases: ["row to stack without media query","flex switcher","가로 세로 전환"]
+questions: ["How do I switch equal regions from a row to a stack without a breakpoint?"]
 primary_spatial_problem: Switch equal regions from row to stack without a viewport breakpoint.
 secondary_spatial_problems: none
 layout_axis: inline

package/patterns/stacking/feed.md

@@ -4,6 +4,7 @@ name: feed
 title: feed
 category: Stacking
 description: Stack repeated content items with stable rhythm.
+aliases: ["content feed","activity feed","피드"]
 primary_spatial_problem: Stack repeated content items with stable rhythm.
 secondary_spatial_problems: none
 layout_axis: block

package/patterns/stacking/line-up.md

@@ -4,6 +4,8 @@ name: line-up
 title: line-up
 category: Stacking
 description: Keep card footer actions aligned at the bottom.
+aliases: ["equal height cards","buttons aligned at bottom","card footer alignment","카드 버튼 하단 정렬"]
+questions: ["How do I align card footer actions at the bottom?"]
 primary_spatial_problem: Keep card footer actions aligned at the bottom.
 secondary_spatial_problems: none
 layout_axis: block