@hjmds/design-contracts 1.9.0 → 1.11.0

package/docs/cross-platform-core-normalization.md

@@ -1,5 +1,7 @@
 # Cross-platform core normalization
 
+검토일: 2026-10-02 · 2.0 source contract
+
 Text, Surface, Stack, Grid, Button, IconButton, Tag, Card의 공통 의미 축은 contracts가 소유하고 Web과
 Native renderer는 각 플랫폼 host로 번역한다. 라이브러리 비교와 채택/기각 근거는
 [library-reference-decisions.md](./library-reference-decisions.md)를 따른다.
@@ -53,7 +55,8 @@ edge를 항상 그린다.
 
 ## 0.5 compatibility aliases
 
-0.6에서 canonical API로 옮길 수 있도록 기존 Native 호출은 당분간 동작한다.
+아래는 0.6 이관 당시의 before/canonical 비교다. 현재 지원 여부는 각 API 타입을 따른다.
+아래 before API는 모두 [2.0 이관](./migration-native-legacy-removal.md)에서 제거했다.
 
 ```tsx
 // before
@@ -73,30 +76,25 @@ edge를 항상 그린다.
 <IconButton label="닫기" tone="ghost"><CloseIcon /></IconButton>
 ```
 
-- Native `Stack.direction`: `row → inline`, `column → block` deprecated alias
-- Native `Button.label`, `Tag.label`: `children` deprecated alias
-- Native `Surface.sunken`, `Surface.brand`: 각각 `subtle`, `accent` deprecated alias
-- Native `Grid.descriptor`: flat `columns`/`gap`/`minColumnWidth`를 위한 deprecated alias
-- Native `IconButton.accessibilityLabel`, `icon`: `label`, `children` deprecated alias
-- Native `IconButton tone="link"`: `ghost`로 번역되는 deprecated alias
-
-호환 alias는 새 문서와 예제에서 사용하지 않는다. 제거는 major release에서만 한다.
+Native `Surface.sunken`은 공통 recipe에 독립적으로 정의된 tone이며 deprecated alias가 아니다.
+`brand`만 제거하고 `accent`로 이관한다. 1.x의 호환 별칭 지원 설명은 현재 2.0 소스에 적용하지 않는다.
 
 ## Collection and state vocabulary
 
-공통 제품 코드에서 같은 역할은 같은 이름을 사용한다. Web을 기준으로 Native의 비파괴 호환
-bridge를 추가했으며, 새 코드는 canonical 열만 사용한다.
+공통 제품 코드에서 같은 역할은 같은 이름을 사용한다. 1.x에서 제공했던 Native bridge를
+2.0에서 제거했으므로 아래 canonical API만 사용한다.
 
-| Component | Canonical Web/Native API | Deprecated Native alias |
-| --- | --- | --- |
-| Switch | `checked`, `defaultChecked`, `onCheckedChange` | `value`, `defaultValue`, `onValueChange` |
-| RadioGroup | `items: RadioGroupItem[]` | `options: RadioOption[]` |
-| SegmentedControl | `items: SegmentedControlItem[]` | `options: SegmentedControlOption[]` |
-| Tabs | `items: TabItem[]`, item key `id` | `options: TabOption[]`, item key `value` |
-| Select | `source`/`items`/`sections`, `selectedKey`, `defaultSelectedKey`, `onSelectionChange` | `options`, `value`, `defaultValue`, `onValueChange` |
-
-한 인스턴스에서 canonical과 deprecated channel을 함께 전달하면 타입과 runtime 모두 실패한다.
-이 규칙은 TypeScript를 우회하는 JavaScript 소비자에게도 결정적인 상태 모델을 보장한다.
+| Component | Canonical Web/Native API |
+| --- | --- |
+| Switch | `checked`, `defaultChecked`, `onCheckedChange` |
+| RadioGroup | `items: RadioGroupItem[]` |
+| SegmentedControl | `items: SegmentedControlItem[]` |
+| Tabs | `items: TabItem[]`, item key `id` |
+| Select | `source`/`items`/`sections`, `selectedKey`, `defaultSelectedKey`, `onSelectionChange` |
+| Menu | 항목 key `id`, 실행 `onAction`, 선택 `selection.onSelectionChange` |
+
+Web Menu의 선택 prop 배치는 Web Menu 타입을 따른다. 두 플랫폼 모두 실행과 선택 변경을
+구분하며 item-local `onSelect` 또는 Native `onSelect` 호환 콜백은 사용하지 않는다.
 
 ## Reference application notes
 

package/docs/data-table.md

@@ -84,10 +84,13 @@ async 상태와 narrow long-copy 회귀로 확인하고, 소비 제품의 데이
 `@hjmds/react/data-table`의 `DataTable`이 이 계약을 실행한다. Web renderer는 전용 keyboard·
 selection·320px long-copy proof를 통과해 2026-09-29 stable로 승격한다. Native는 `unsupported`다.
 
-- **기존 `Table`과 겹치지 않는다.** `@hjmds/react`의 `Table`(advanced-display)은 열·행을
-  그려 주는 표시용이고 선택·tri-state·async 상태·정렬 상태 순환이 없다. DataTable은 그
-  상호작용 계약을 실행하는 쪽이다. 단순 표는 계속 `Table`을 쓴다 — 같은 화면에 둘을 겹쳐
-  쓰지 않는다.
+- **기존 `Table`과 정렬 기능은 공유한다.** 2026-10-01 중복 조사에서 Table도 정렬 버튼과
+  ascending/descending 순환을 제공하는데 표시 전용으로 설명했던 불일치를 확인했다.
+  Table은 generic row·caption·emptyState와 두 방향 정렬을 제공하고, DataTable은
+  ID 기반 row/column·선택·tri-state·async 상태 및 정렬 해제를 포함하는 세 상태 순환을 제공한다.
+  정렬 전환은 같은 계약 함수, header button은 같은 내부 renderer를 소비한다.
+  caption과 단순 generic row 표는 Table, 행 선택·loading/error와 정렬 해제가 필요한 표는
+  DataTable을 선택한다. API를 합치면 caption·emptyState·row 모델 호환성을 잃으므로 두 API를 유지한다.
 - **정렬 버튼은 header 안에 있다.** `th` 자체를 버튼으로 만들지 않고, 방향은
   `aria-sort`에 그대로 흘린다. 다음 상태는 `getNextDataTableSortState`가 정하고 실제 정렬은
   제품이 한다.
@@ -103,4 +106,4 @@ selection·320px long-copy proof를 통과해 2026-09-29 stable로 승격한다.
 - 로컬 검증: `test/data-table.browser.test.tsx` 5개(header 안 정렬 버튼과 aria-sort 3단계,
   tri-state 선택과 disabled 제외, 단일 선택 radio 의미, 셀당 컨트롤 하나와 기본 tab 순서,
   async 상태 발표와 footer 조합), `test/data-table.keyboard.browser.test.tsx` 1개(실제 Tab·Enter·Space
-  입력), 그리고 `Patterns/CommandPalette`의 표 화면.
+  입력), 그리고 `컴포넌트/탐색/Command Palette`의 표 화면.

package/docs/dialog.md

@@ -37,3 +37,5 @@ a narrow viewport. React Native renderer tests cover modal role/name/state,
 action labels and close requests, back/outside dismissal, busy guards, and long
 title/description copy. These tests exercise renderer contracts; device and
 screen-reader behavior remains a separate consumer validation concern.
+
+Native accessibility follow-up (2026-10-01): at 200% text scale, the close glyph was clipped inside the fixed IconButton frame. Dialog and Sheet now render that decorative glyph at a fixed icon size, matching Toast; title/body text still scales and the named close action and touch target are preserved. `sheet-viewport.test.tsx` checks both renderers and close callbacks.

package/docs/effect-surface.md

@@ -0,0 +1,50 @@
+# Composable decorative surfaces
+
+2026-10-01. Optional Web/Native presentation, independent implementation inspired
+by layered shader composition. No Shaders.com engine, presets or source is shipped.
+
+Import `EffectSurface` from the renderer `/effect-surface` entry. The shared
+`/effect-surface` contract accepts unique `layers` (`mesh`, `glow`, `grain`), a
+stable `seed`, `intensity` from 0 to 1, a cycle `period` from 2 to 120 seconds,
+`active` (false by default), and three semantic color references. Web uses local
+SVG/WAAPI; Native requires the existing optional SVG peer and core Animated.
+No WebGPU context, network request or new native animation runtime is required.
+
+```tsx
+<EffectSurface descriptor={{ layers: ['mesh', 'grain'], seed: 'welcome', active: true }}>
+  <WelcomeContent />
+</EffectSurface>
+```
+
+Web accepts `className`; Native accepts container `style` and host `visible`.
+Native screen/list owners must pass `visible={false}` when hidden or outside the
+visible list window. Web observes intersection and document visibility. Both
+honor the HJM provider's reduced-motion setting; Native also handles AppState.
+The static seeded geometry and the base theme background stay visible when motion
+stops. Effects never duplicate content, take focus, intercept touches or add an
+accessible name. The content itself stays in normal layout.
+
+Noise uses a seeded repeating small-dot tile rather than large spots. Geometry
+is shared, while host rasterization and transform details can differ. This is
+atmospheric parity, not a pixel-identical renderer promise. Motion is opt-in and
+slow by default to avoid adding continuous work to ordinary content screens.
+Use `active` only while an effect matters; avoid many simultaneously moving rows.
+
+The component does not automatically guarantee text contrast across arbitrary
+brand colors/intensities. Verify the actual composition or put important text
+and controls on an opaque HJM Surface. The fallback background is the current
+provider background, not an independently selected palette.
+
+`갤러리/시각 효과` demonstrates layers separately and together.
+This optional surface is supplemental presentation; it does not add another
+canonical Surface or replace ThinkingOrb's actual-work state semantics.
+
+
+Host failure fallback (2026-10-02): if Web animation creation is rejected, the SVG
+stays static and no visibility event repeatedly retries it. Native SVG/Animated
+render errors remove only the decoration until the surface remounts; product
+children keep their state and remain interactive on the base theme background.
+A failed Native foreground animation start keeps the static decoration and stops
+retrying for that effect lifecycle. Descriptor validation stays outside this
+fallback so invalid caller input is still reported. This implements integration
+plan §5's requirement that decorative failures must not remove product content.

package/docs/floating-action-button.md

@@ -109,7 +109,7 @@ FAB는 collection 항목이 아니다. 스크롤 콘텐츠 **뒤**에 오는 고
 
 ## 검증 화면
 
-2026-09-16: React/RN `Patterns/Floating action button`에 스크롤 목록 → 기록 작성
+2026-09-16: React/RN `패턴/빠른 메모 작성`에 스크롤 목록 → 기록 작성
 Dialog → 새 기록 추가 흐름을 구현했다. Flutter 앱은 이번 이관 범위에서 제외한다.
 
 ## React / React Native 공개 API

package/docs/folder-preview.md

@@ -0,0 +1,26 @@
+# Folder preview
+
+Reviewed: 2026-10-01. Both renderers expose FolderPreview through `/folder-preview`.
+It is an optional Collapsible composition for collections with a decorative cover,
+not a new navigation or overlay controller. Pass localized `label`, controlled
+`open`, `onOpenChange`, up to three useful `previews`, actual `children`, and optional
+`disabled`. Further preview nodes are intentionally not rendered.
+
+Previews are decorative snapshots, not interactive controls. Their wrapper is inert
+on Web and hides descendants from Native accessibility/touch. Use existing Asset or
+Image components in slots when artwork is needed, and repeat meaningful item names
+and actions in expanded children. The label should describe the collection/count.
+The existing Collapsible owns expanded state and unmounts closed content.
+
+The bounded 260×160 artwork uses overlapping cards that fan out when opened. Web
+transitions transforms and respects reduced motion. Native uses the existing
+ContentTransition around the artwork, inheriting its reduced-motion/AppState rules.
+Labels and real content remain fluid; the illustration is not their sizing model.
+
+Both showcases register 컴포넌트/데이터 표시/Folder Preview with Default, Dark and
+LargeText. Tests cover controlled expansion and decorative accessibility boundaries.
+[Native and Web LargeText flow evidence](../../../docs/evidence/component-flows-2026-10-01/README.md)
+verifies opening/closing and readable expanded content. The examples use document line
+artwork in decorative slots: enlarged text there previously overlapped inside the fixed
+illustration. Actual item names remain in the fluid content below. Physical-device and
+manually heard screen-reader verification remain separate.

package/docs/generated/component-maturity.md

@@ -1,6 +1,6 @@
 # Component maturity and evidence manifest
 
-> Generated from `@hjmds/design-contracts` 1.9.0. Do not edit this file directly; run `pnpm contracts:sync`.
+> Generated from `@hjmds/design-contracts` 1.11.0. Do not edit this file directly; run `pnpm contracts:sync`.
 
 This document is the human-readable projection of the same catalog and Showcase manifest consumed by product CI.
 

package/docs/generated/renderer-evidence.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "designSystemVersion": "1.9.0",
+  "designSystemVersion": "1.11.0",
   "source": "packages/design-contracts/docs/generated/showcase-manifest.json",
   "surfaces": {
     "web": {
       "packageName": "@hjmds/react",
-      "packageVersion": "1.9.0",
+      "packageVersion": "1.11.0",
       "activeComponents": 103,
       "claimedComponents": 103,
       "completeScenarioComponents": 103,
@@ -5642,7 +5642,7 @@
     },
     "native": {
       "packageName": "@hjmds/react-native",
-      "packageVersion": "1.9.0",
+      "packageVersion": "1.11.0",
       "activeComponents": 83,
       "claimedComponents": 83,
       "completeScenarioComponents": 83,

package/docs/generated/renderer-evidence.md

@@ -1,6 +1,6 @@
 # Renderer evidence coverage
 
-> Generated for HJM 1.9.0. Do not edit directly; run `pnpm evidence:sync`.
+> Generated for HJM 1.11.0. Do not edit directly; run `pnpm evidence:sync`.
 
 This projection joins the canonical surface maturity manifest with first-party renderer claims. Missing scenarios are explicit beta promotion debt; stable surfaces are blocked by CI until none remain.
 

package/docs/generated/showcase-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "designSystemVersion": "1.9.0",
+  "designSystemVersion": "1.11.0",
   "packageName": "@hjmds/design-contracts",
   "components": [
     {

package/docs/gooey-navigation.md

@@ -0,0 +1,36 @@
+# Gooey navigation
+
+Reviewed: 2026-10-01
+
+Use the existing `Tabs` from `@hjmds/react/navigation` or
+`@hjmds/react-native/navigation` with `appearance="gooey"`. The default remains
+`standard`. A new navigation controller would duplicate existing selection,
+keyboard, disabled-item and panel contracts, so only the selected indicator is
+extended. Vertical tabs deliberately retain the standard line: stretching a
+horizontal bridge across a vertical list would obscure unrelated items.
+
+`@hjmds/design-contracts/gooey-navigation` owns the measured source/destination
+bridge. It expands to the union of their edges at 45% progress, then contracts to
+the destination over 320ms. This independently authored elastic presentation
+uses no copied effects, shader or physics engine. Six-point indicator height is
+decorative geometry; colors and corner radius reuse tokens. Text and hit targets
+never transform. On Web, selected-tab measurements and ResizeObserver track
+font/viewport changes; Native uses tab onLayout measurements. Measured physical
+coordinates also support RTL and horizontal scrolling.
+
+Reduced motion, backgrounding and cleanup settle the indicator without changing
+selection. Native width animation uses Core Animated's JS driver because width
+cannot use the native transform driver without distorting corner radii. No new
+optional animation dependency is introduced. Rapid re-selection targets the last
+selected tab; this is deterministic selection feedback, not a physics simulation.
+
+Both Storybooks expose `컴포넌트 / 탐색 / Gooey Navigation` with Default,
+Dark and LargeText plus a direction toggle. Disabled tabs, existing activation
+mode and panel associations remain canonical. The Native renderer is tested with
+mock layout events; actual device appearance remains to be verified.
+
+Native horizontal scrollable Tabs centers the selected measured tab within the scroll
+content bounds when selection, direction or viewport width changes. This corrects a
+LargeText RTL selected-label clipping issue found in the [device flow audit](../../../docs/evidence/component-flows-2026-10-01/README.md).
+The standard appearance shares this behavior; fitted and non-scrollable lists do not
+programmatically scroll. Selection semantics and the host's panel ownership are unchanged.

package/docs/gravity-letters.md

@@ -0,0 +1,26 @@
+# Gravity Letters
+
+Reviewed: 2026-10-01
+
+Optional `@hjmds/react/gravity-letters` and `@hjmds/react-native/gravity-letters`
+provide an independently authored promotional drop/rebound accent. This is not a
+replacement for Text or ContentTransition: the whole effect is decorative and
+hidden from accessibility APIs. Keep the meaningful static heading outside it.
+The Web presentation inherits typography; Native uses canonical heading Text.
+
+Pass `glyphs` as host-segmented graphemes/words (at most 32 nonempty single-line
+strings). Never split emoji or complex scripts with UTF-16 `split("")`. Spaces
+are preserved. The bound prevents a headline effect becoming paragraph-scale
+animation work. `active` defaults to false; set true and change `replayKey` for an
+explicit replay. No timer, physics dependency or pointer gesture is installed.
+
+The contract owns the 36-point drop, small rebound, alternating tilt and 24ms
+stagger. These are decorative geometry, not layout spacing tokens. The reserved
+upper inset keeps the drop inside the component bounds. Web WAAPI and Native Core
+Animated cancel on inactivity, reduced motion, backgrounding, replacement or
+unmount; text rests at its final position. Foregrounding alone does not replay.
+
+Both Storybooks: `컴포넌트 / Display / Gravity Letters`, with Default, Dark
+and LargeText. Web glyph typography can be inherited from a surrounding heading
+Text. Renderer behavior tests cover explicit replay and motion bypass; Native
+mock tests do not prove actual device rendering.

package/docs/grid-reveal.md

@@ -0,0 +1,11 @@
+# GridReveal
+
+검토일: 2026-10-01.
+
+`@hjmds/react/grid-reveal`, `@hjmds/react-native/grid-reveal`는 기존 Image 주위에 합성하는 장식 마스크다. `ready`를 Image의 `onLoadStatusChange`가 loaded일 때만 true로 두고, 이미지 소스 변경/재시도 전에는 false로 초기화한다. 오류일 때는 false로 돌린다. Image의 크기 예약·접근성 이름·로딩·실패·재시도 동작은 그대로 유지한다.
+
+`children`이 실제 콘텐츠를 소유한다. `active=false`는 숨겨진 화면의 효과를 중단한다. 격자 4×4와 최대 180ms 지연, 기존 normal 지속 시간을 공유한다. 마스크만 투명해지며 이미지 픽셀·터치 대상·접근성 트리를 복제하지 않는다. 모션 줄이기에서는 마스크를 생략하고 이미지를 바로 보여준다. 웹 문서 숨김 또는 Native AppState 비활성에서도 마스크를 지운다.
+
+Web은 WAAPI, Native는 Core Animated를 사용한다. Native 화면이 mounted인 채 가려지면 제품이 active=false를 전달해야 한다. 부모를 이미지 크기에 맞게 배치하며, 둥근 이미지 모서리가 필요하면 동일한 클리핑 프레임으로 둘을 감싼다.
+
+양쪽 Storybook 컴포넌트/시각 효과/Grid Reveal에서 Default/Dark/LargeText, 다시 보기와 이미지 실패/재시도를 제공한다. 예제 풍경은 코드로 만든 자체 이미지다. [Native 후속 검증](../../../docs/evidence/component-flows-2026-10-01/README.md)에서 기존 iPhone 17 / iOS 27 시뮬레이터의 큰 글씨 오류·재시도 화면을 실제 조작하고 확인했다. Image 계약에 따라 오류 전후 같은 이미지 설명을 유지하며, 시각적 오류 문구는 중복 접근성 이름으로 읽지 않는다. 물리 기기의 GPU 비용과 프레임별 효과 타이밍 검증은 별도다.

package/docs/icon.md

@@ -20,3 +20,29 @@ name을 제품 adapter가 Web SVG 또는 React Native glyph로 번역해, 아이
 
 WAI의 기준처럼 주변 텍스트와 중복되는 그림은 장식으로 숨기고, 기능을 단독으로 전달하는
 그림은 모양 이름이 아니라 동작/목적을 접근성 이름으로 제공합니다.
+
+## Lucide adapter — 2026-10-01
+
+`createLucideGlyph` from either renderer `/icon-lucide` entry accepts named
+Lucide imports mapped to semantic names. This keeps only the selected glyphs
+reachable; it never loads a dynamic full-library dictionary.
+
+```tsx
+import { Search, ArrowLeft } from 'lucide-react';
+import { createLucideGlyph } from '@hjmds/react/icon-lucide';
+const renderGlyph = createLucideGlyph({ search: Search, back: ArrowLeft });
+// Web: <Icon name="search" renderGlyph={renderGlyph} />
+// Native: use lucide-react-native and <Icon descriptor={{name:'search'}} renderGlyph={renderGlyph}/>
+```
+
+Web now supports an optional `renderGlyph` inside its existing SVG frame. Omit it
+or return null to preserve the built-in glyph. Its callback receives a 24-unit
+viewBox size and currentColor; the outer frame resolves the actual token size.
+Native receives resolved numeric size/color/stroke and retains its existing
+renderGlyph contract. Both adapters hide artwork and leave naming, directionality
+and mirroring on Icon. Missing map entries throw to reveal product mapping errors.
+
+Lucide 1.49.0 is the verified development/showcase version and optional peer.
+The Native factory uses a scalar-only component interface instead of exporting
+one host version's RN StyleProp types, keeping consumers on supported newer RN
+versions structurally compatible. This does not replace provider/brand logos.

package/docs/image.md

@@ -75,8 +75,8 @@ intrinsic ratio 예약, 장식/정보 이미지의 alt 의미, load/error 상태
 `nativeResizeModes`로 fit을 번역하며, 장식 기본값·정보 이미지의 fallback 이름 유지·built-in
 fallback·`src` 변경 후 재시도를 component test로 검증한다. `sourceAdapter`와 `renderImage`
 경계로 bare RN의 `ImageSourcePropType` 및 `expo-image` 같은 optimized host를 연결할 수 있다.
-이전 RN `source` API는 마이그레이션 호환용 deprecated 경계일 뿐 intrinsic-size 계약의
-증거로 세지 않는다.
+이전 RN `source` 호환 경로는 다음 major 소스에서 제거했다. 이관은
+[Native 호환 별칭 제거](./migration-native-legacy-removal.md)를 따른다.
 
 이전 후보였던 야잘알 팀 엠블럼은 여전히 Avatar 성격이므로 Image의 제품 증거로 세지 않고,
 BurnTok의 data URI 아이콘도 network failure 증거로 세지 않는다. 실제 network asset의

package/docs/layout.md

@@ -22,8 +22,7 @@ stable)이다. `Layout`이 그 콘텐츠나 상태를 다시 계약하면 두
   Web 전용 `validateLayoutWebDescriptor`가 이 규칙을 강제한다 — `hasHeader`나
   `sidebar`가 있는데 `skipLinkLabel`이 없으면 던진다. 공통
   `validateLayoutRegions`는 region/sidebar 구조만 검사하므로, bypass-link 개념이
-  없는 Native에 Web 요구를 강제하지 않는다. 기존 `validateLayoutDescriptor`는
-  Web validator의 호환 alias다.
+  없는 Native에 Web 요구를 강제하지 않는다. 기존 `validateLayoutDescriptor` 호환 alias는 2.0에서 제거했다.
 - **플랫폼 번역**: 성립하지만 비대칭적으로 성립한다. Web은 실제 랜드마크
   엘리먼트(`<header>`/`<nav>`/`<main>`/`<footer>`)가 있다. Native는 랜드마크
   개념 자체가 없다 — `accessibilityRole`은 heading/control용이지 페이지 영역용이

package/docs/migration-0.5.md

@@ -1,5 +1,8 @@
 # v0.5 migration
 
+이 문서는 0.5 당시의 이관 기록이다. 여기서 유지한다고 설명한 coverage 별칭은
+[2.0 이관](migration-native-legacy-removal.md)에서 제거했으며 현재 API 지원을 뜻하지 않는다.
+
 v0.4 → v0.5는 기존 foundation/recipe 런타임 값을 유지하는 additive release입니다. 다만
 catalog status를 그대로 열거하거나 Showcase route 존재를 renderer 증거로 사용한 소비자는
 아래 두 가지를 확인해야 합니다.
@@ -65,7 +68,7 @@ value.palette;
 
 - 91개 canonical route를 Web reference, contract-only, Web unsupported로 분리합니다.
 - planned route는 구현된 것처럼 보이는 JSX를 렌더링하지 않습니다.
-- Home/Explorer 수치는 실제 evidence registry에서 계산합니다.
+- 시작하기/Explorer 수치는 실제 evidence registry에서 계산합니다.
 - Storybook manager와 preview가 foundation token을 사용합니다.
 - token-boundary 검사와 static classification 검사가 Showcase check에 포함됩니다.
 - Ant Design reference는 6.6.1로 고정됩니다. v0.7부터 외부 registry drift 검사는 자동 CI가

package/docs/migration-native-legacy-removal.md

@@ -0,0 +1,59 @@
+# 1.11 호환 API 제거와 소비 이관
+
+검토일: 2026-10-02 · 1.11 minor 소스 변경 · npm 게시와 소비 설치는 별도 확인
+
+사용자가 전체 소비 앱을 함께 버전업하므로 구형 호환 API도 제거하라고 요청했다.
+별칭과 deprecated 스타일 통로를 유지하는 대신 기존 canonical API로 이관한다.
+2026-10-02 사용자 결정에 따라 호환 API 제거를 1.11.0 minor Changeset에 포함한다.
+기존 1.x 소비자는 정확한 버전을 고정한 상태에서 이 이관표를 적용한 뒤 올려야 한다.
+
+| 제거 | 대체 |
+| --- | --- |
+| Native Switch `value` / `defaultValue` / `onValueChange` | `checked` / `defaultChecked` / `onCheckedChange` |
+| Native Button·Tag `label` | `children` |
+| Native IconButton `icon`, 접근성 이름용 `accessibilityLabel`, `link` tone | `children`, `label`, `ghost` tone |
+| Native Image `source`, `LegacyImageRenderProps`, adapter `legacySource` | `src`·`width`·`height`, `ImageRenderProps`, `sourceAdapter` |
+| Native ToastRegionController `show` | `publish` |
+| Native RadioGroup·SegmentedControl `options`와 Option 타입 | `items`와 Item 타입 |
+| Native Tabs `options`, TabOption `value` | `items`, TabItem `id` |
+| Native Select `options`, `value`, `defaultValue`, `onValueChange`, SelectOption | `items`/`sections`/`source`, `selectedKey`, `defaultSelectedKey`, `onSelectionChange`, CollectionItemDescriptor |
+| Native Menu item `value`·`icon`·`accessibilityHint`, `onSelect` | `id`, `renderLeading`, `description`, `onAction` |
+| Web Menu·MenuMorph item `onSelect` | 컴포넌트 `onAction(id)` |
+| Web/Native Tabs와 Web Select leading `glyphSize` | `size` |
+| Native Stack `direction`, Grid `descriptor` | `axis`, 직접 `columns`·`gap`·`minColumnWidth` |
+| Native Surface `brand` tone, 숫자 padding/radius | `accent` tone, spacing/radius 토큰 |
+| Native Layout `skipLinkLabel` | 삭제: Web 전용 속성 |
+| Native 입력 `supportText`, ListRow `badge` | `description`, `titleMetadata` |
+| Native Button `style`·`labelStyle`, Surface/Card·Field·AuthScreenLayout·Chip·ListRow·LoadMore `style` | 배치만 `layoutStyle`, 시각 값은 semantic props/recipe |
+| Native 입력 `inputStyle`·`containerStyle`, Image `containerStyle`, Section `titleStyle`·`descriptionStyle` | 배치는 `layoutStyle`, 입력 크기는 `size`, 문구는 typography recipe |
+| Contracts `validateLayoutDescriptor` | `validateLayoutWebDescriptor` 또는 `validateLayoutRegions` |
+| Catalog summary `fullyPreviewable`·`partiallyPreviewable`·`contractOnly` | `fullyMature`·`partiallyMature`·`plannedOnly` |
+
+Select의 `onSelectionChange`에는 선택 해제를 뜻하는 null이 올 수 있다. 이전 비-null
+handler를 이관할 때는 null 처리 방침을 제품에서 명시한다. 메뉴의 실행과 선택 상태 변경은
+각각 `onAction`과 `selection.onSelectionChange`로 구분한다. 항목별 실행 콜백을 섞지 않는다.
+
+Image의 `sourceAdapter(descriptor)`는 유지한다. 인증 header·캐시 옵션이 있는 RN source나
+번들 자산은 이 경계로 넘기되 실제 크기와 canonical src를 제공한다. 이미지 크기를 임의로
+추정하지 않는다. React Native 자체의 Image·Switch API는 HJM 이관 대상이 아니다.
+
+## 스타일 경계
+
+제거 대상은 위 표에 열거한 deprecated 공개 통로다. 플랫폼 host의 정식 `style`,
+renderer에 주입하는 이미지 스타일, 제품 소유 슬롯과 private recipe 스타일까지 일괄 삭제하는
+변경은 아니다. 배치에 paint 값을 넣어 타입을 우회하지 않는다. FloatingActionButton과
+LoadMore의 내부 Button 조합은 비공개 RecipeButton을 써서 recipe의 크기·색·그림자를 보존한다.
+해당 구현을 패키지 entry에서 export하지 않는다.
+
+## 관리 소비 저장소
+
+번뚝·다에리·비행중·모펀의 직접 호출과 제품 래퍼를 함께 이관한다. 스핀트·유틸버스·포트폴리오
+사이트·App Release Hub도 새 공개 타입으로 검사한다. 웹과 앱이 있는 제품은 양쪽을 확인한다.
+소스 검사, 새 패키지 설치/lock 갱신, 기기 검증, npm 게시·운영 배포는 별개의 단계다.
+로컬 후보 선언을 연결한 검사만으로 게시된 1.11 소비 설치를 주장하지 않는다.
+
+## Storybook
+
+Web/Native 프로필 편집은 기본·어두운 테마·큰 글자를 유지한다. 중복 Playground 링크는
+`patterns-profile-studio--default`로 바꾼다. Web showcase 색상 변수는 `--hjm-color-*`만 쓴다.
+이 내부 변수 이관은 공개 renderer CSS 토큰 변경이 아니다. 모든 예제는 위 canonical API로 갱신한다.

package/docs/navigation-bar.md

@@ -0,0 +1,28 @@
+# NavigationBar — 글래스 네비게이션 바
+
+검토일: 2026-10-01
+
+`NavigationBar`는 브랜드·탐색·검색/계정 행동을 배치하는 상단 탐색 조합입니다.
+`@hjmds/react/navigation-bar`, `@hjmds/react-native/navigation-bar`에서 가져옵니다.
+
+```tsx
+<NavigationBar label="사이트 탐색" brand={<Text>브랜드</Text>} actions={<SearchField /* 제품의 현지화된 필드 props */ />}>
+  {/* 제품의 Link, Menu, Button 등 탐색 항목 */}
+</NavigationBar>
+```
+
+- 필수 `label`, `brand`, `children`, 선택 `actions` 슬롯을 받습니다.
+- Web은 이름이 있는 nav와 줄바꿈되는 세 슬롯, Native는 큰 글씨에서도 늘어나는 두 행입니다.
+- Web은 배경 흐림이 지원되면 92% 불투명 semantic surface와 blur를 사용합니다.
+  미지원/투명도 줄이기/강제 색상에서는 불투명 배경을 유지합니다.
+- Native는 core renderer에 필수 blur 의존성을 추가하지 않고 불투명 semantic surface로
+  대체합니다. 실제 iOS 유리 굴절 효과를 구현했다고 주장하지 않습니다.
+- 메뉴의 초점·키보드·닫힘과 검색/계정 상태는 기존 Menu/SearchField 및 제품이 소유합니다.
+  슬롯을 하나의 접근성 요소로 합치지 않습니다. 브랜드/목적지는 앱에서 Link로 전달할 수 있습니다.
+- `TopBar`는 화면 제목·뒤로가기·소수 행동을 위한 chrome, `BottomNavigation`은 최상위 route,
+  `NavigationBar`는 사이트 탐색의 다중 슬롯 조합입니다. 같은 선택 상태를 중복 보관하지 않습니다.
+
+근거: 사용자가 제공한 [Glassy Navbar 릴](https://www.instagram.com/reel/Dd8_OYaTwmG/)의
+브랜드·드롭다운·검색·계정 배치를 관찰해 독립 구현했습니다. 원본 소스/에셋은 가져오지 않았습니다.
+Storybook: **컴포넌트 → 탐색 → 글래스 네비게이션 바**, Default/Dark/LargeText.
+구현·검증 기록은 [같은 변경의 증거](../../../docs/evidence/navigation-references-2026-10-01/README.md)를 따릅니다.

package/docs/optional-adapters.md

@@ -93,7 +93,7 @@ Expo Go cannot verify these linked native modules.
 
 ## Evidence and promotion
 
-Web stories: Patterns/Optional Motion. Native stories: Experimental/Optional Adapters.
+Web stories: 갤러리/모션 연동. Native stories: 실험실/선택적 연동.
 Tests cover adaptation logic and web browser behavior; native mocks cannot prove OS gestures,
 keyboard animation, accessibility focus, native linking or installed-device health. Keep native
 adapters experimental until iOS/Android device evidence exists. No consumer migration or publication
@@ -124,3 +124,26 @@ product image/menu behavior and removes the matching peers. There is no persiste
   reports transitive UI packages expecting Storybook 10.6 and safe-area-context 5.8 versus 5.7.
   Builds passing do not erase these warnings or prove device compatibility.
 - No npm publication, consumer migration, native binary build, commit or push was performed.
+
+## Shared behavior after the component overlap audit
+
+The 2026-10-01 audit found independent typeahead policies in Menu, MorphingMenu and ContextMenu.
+Their Web item searches now share the base Menu's 500ms reset, declared textValue, circular search
+and repeated-character cycling. Menu opening, OS context-menu behavior and presentation stay host-owned.
+
+CarouselMotion now resolves slide IDs, selected/inert state, accessible names and finite navigation
+through the canonical Carousel contract in both renderers. Its optional composeAccessibleName
+accepts the same localized position/name composer as Carousel; omitting it preserves the slide label.
+It remains a controlled swipe/motion presentation without autoplay or uncontrolled defaults.
+
+Native Field and built-in text inputs share a recipe-owned label/support/error frame.
+GestureSheetInput retains BottomSheetTextInput's keyboard tracking but now uses the base field's
+input geometry, typography, placeholder and provider font scaling instead of separate constants.
+
+## Static Avatar fallback — 2026-10-01
+
+Both renderer `/avatar-blobatar` entries now provide `createBlobatarFallback` for
+existing Avatar. They are optional factories, not new canonical components or
+root exports. See the [fallback contract](avatar-fallback.md) for installation,
+source recovery and identity/accessibility rules. This addition does not imply
+that the earlier device evidence covers Blobatar.

package/docs/otp-field.md

@@ -102,3 +102,18 @@ Backspace → 앞 칸으로)도 이 모델에서는 별도 로직이 필요 없
 
 이 조사 당시 제품 채택은 미확인이었다. 2026-09-29부터 제품 채택은 관측으로 분리하며,
 현재 성숙도는 catalog와 [승격 기준](stable-promotion.md)을 따른다.
+
+## Presentation options (2026-10-01)
+
+Web and Native accept `presentation="boxes" | "underline"`; boxes remains the
+compatible default. Underline removes the side/top slot outlines and keeps a
+strong bottom border with the same focus, filled and error colors. This changes
+only decorative slots: one actual input still owns selection, paste, numeric
+sanitization, SMS autocomplete and the completion callback. Never replace it with
+six separately focused fields to obtain this appearance.
+
+Both showcases place the interactive preview under 컴포넌트/입력/OtpField
+with Default, Dark and LargeText. The two presentations share a controlled sample
+value and an explicit error toggle. “Input complete” means six characters entered,
+not a successful server verification. Existing input behavior tests now exercise
+both presentations on Web and Native; actual device autofill remains separate QA.

package/docs/pagination.md

@@ -138,7 +138,7 @@ Steps와 같은 이유다: 순서를 나타내는 문장의 어순과 조사는
 필수입니다. 상태·데이터 요청·결과 교체와 URL 동기화는 제품이 소유합니다.
 
 2026-09-16 사용자의 명시적 확장 요청으로 라이브러리 beta를 제공하고 제품 채택은 별도로
-추적합니다. `Patterns/WebNavigation`에서 125개 로컬 기록의 실제 페이지별 목록과 표시 범위가
+추적합니다. `갤러리/웹 탐색`에서 125개 로컬 기록의 실제 페이지별 목록과 표시 범위가
 바뀝니다. 서버 요청이나 제품 적용을 검증한 것은 아닙니다.
 
 [MUI Pagination](https://mui.com/material-ui/react-pagination/)의 명시적 페이지 탐색과

package/docs/popover.md

@@ -37,7 +37,7 @@ label/textValue, selection mode)을 따르는 항목 **목록**이고 그 role/k
 catalog에 별도 `planned` 항목으로 있는 `ConfirmPopover`(antd `Popconfirm`,
 `relationship: "adapted"`)는 이 Popover 위의 **조합**이다 — Popover의 anchored
 비모달 surface에 되돌릴 수 있는 행동의 확인·취소를 얹은 조합이다. 파괴적 동작은
-AlertDialog를 사용한다. `Patterns/Popover/ReversibleConfirmation`은 기록 보관·취소가
+AlertDialog를 사용한다. `컴포넌트/오버레이/Popover/ReversibleConfirmation`은 기록 보관·취소가
 작동하는 예제이며 새 독립 renderer 수에 더하지 않는다.
 
 ## 일반화한 계약
@@ -142,7 +142,7 @@ Dialog 안의 Popover는 첫 Escape를 소유한다. 내부 Menu가 Escape를
 
 2026-09-16 사용자의 확장 요청으로 Web beta를 제공했다. 2026-09-29 focus/keyboard·hover/touch·
 320px long-copy browser proof를 확인해 stable로 승격한다. Native는 `unsupported`; 제품 채택은 별도다.
-`Patterns/Popover/Filters`는 제목·즐겨찾기 조건 적용/취소/초기화와 실제 목록 교체를 제공한다.
+`컴포넌트/오버레이/Popover/Filters`는 제목·즐겨찾기 조건 적용/취소/초기화와 실제 목록 교체를 제공한다.
 `ReversibleConfirmation`은 보관 후 취소 버튼으로 초점을 옮기며 실제로 복원한다.
 
 [Radix Popover](https://www.radix-ui.com/primitives/docs/components/popover)의 비모달 focus·

package/docs/product-adoption-1.4.md

@@ -13,6 +13,13 @@ Native의 외부 배치는 `layoutStyle`, UI 식별은 `testID`를 사용한다.
 Web의 상위 앱 셸에 이미 main landmark가 있으면 `as="section"`을 사용한다. 이 옵션은
 다에리 WebShell의 main 안에 로그인 레이아웃을 채택할 때 중첩 main을 피하기 위해 추가했다.
 
+2026-10-01 로그인 조합 변경은 [로그인 화면 계약](auth-screen.md)의 mainCard와 pendingLabel을
+사용한다. 제공자 버튼 label은 지역화 카탈로그에서 이름만 남기고, 인증 시작부터 완료·취소·실패까지
+같은 main 내용을 유지한 채 pendingLabel만 켜고 끈다. 기존 제품 카드 wrapper를 제거하고 mainCard로
+옮기면 배경까지 유지된다. 버튼마다 busy를 켜는 기존 연결은 이 카드 상태로 옮긴다.
+HJM npm 게시만으로 이 변경이 제품에 자동 적용되지는 않는다. exact dependency·lock·계약을
+업데이트하고 제품의 상태 연결과 문구를 바꾼 뒤 웹·앱을 함께 검증한다.
+
 ## 설정 한 행
 
 `Switch presentation="row"`에 label/description/checked/onCheckedChange를 전달하면 행 전체가

package/docs/product-audit-2026-09-15.md

@@ -54,7 +54,7 @@ Yajalal과 Choose Window의 현재 제품은 Flutter이므로 JS renderer 소비
   dark/long-copy/large-text/rtl 환경으로 직접 실행한다.
 - Showcase 격리: `packages/react/test/showcase-style-isolation.browser.test.tsx`.
   SSR class 확인만으로 발견되지 않은 Tabs 가로 배치와 버튼 모양을 실제 browser로 검사한다.
-- Review: `Patterns/Toast layout`, 기존 Button/IconButton/Tabs/Notice story.
+- Review: `패턴/토스트 배치`, 기존 Button/IconButton/Tabs/Notice story.
 - Toast는 1280px 창의 420px 카드에서도 액션 행을 유지한다. 창 breakpoint만으로 판단하면
   실제 provider의 좁은 카드에서 큰 글자 버튼이 다시 압축되므로 grid를 카드 기본 구조로 둔다.
 - NativeProvider: `packages/react/test/native-provider-hydration.browser.test.tsx`5개와

package/docs/provider-button.md

@@ -1,6 +1,6 @@
 # AuthProviderButton contract
 
-**문제.** "Google로 계속하기", "카카오로 계속하기" 같은 소셜 로그인 버튼. BurnTok이
+**문제.** 제공자 브랜드 규정을 따르는 소셜 로그인 버튼. BurnTok이
 `.hjm-button.bt-provider-google` 네 줄로 HJM 버튼을 덮어 쓰던 자리다.
 
 **왜 Button의 tone이 아닌가.** HJM의 tone은 **의미**다 — primary/secondary/danger는
@@ -26,8 +26,11 @@
 **포커스 링은 바깥에 그린다.** `#FEE500`부터 `#000000`까지 어떤 배경 위에서도 보여야
 하므로 `focusOutlineOffset`으로 fill 밖에 둔다.
 
-**busy는 라벨을 지우지 않는다.** 스피너만 옆에 붙고 폭도 유지한다 — 버튼이 줄어들면
-그 아래 제공자 버튼들이 밀린다.
+**로그인 화면의 진행 상태는 카드가 소유한다.** 2026-10-01 사용자 요청으로 로그인 조합은
+`AuthScreenLayout`의 pendingLabel을 사용한다. 모든 제공자 버튼을 숨기고 기존 카드 크기에서
+중앙 로딩 하나만 보여 준다([로그인 화면 계약](auth-screen.md)). 버튼 label은 제품이 제공자
+이름만 전달한다. 이전 버전 소비와 단독 버튼의 호환성을 위해 descriptor.busy는 유지하며,
+카드 진행 상태와 동시에 사용하지 않는다.
 
 **값의 출처.** 각 제공자의 공개 브랜드 가이드라인(2026-09 확인). 가이드라인이 바뀌면
 `authProviderPalettes` 한 곳만 고친다.