@hjmds/design-contracts 1.17.2 → 1.19.0

package/docs/consumer-policy.md

@@ -2,12 +2,15 @@
 
 상태: **Normative**
 정책 버전: **2.0.0**
-검토일: 2026-10-06 · Web `layoutStyle` 전수 제공(이전: 2026-10-02 deprecated API 제거)
+검토일: 2026-10-13 · 현재 소비 계약과 변경 범위 검증
 적용 대상: 신규 HJM Web·React Native 앱과 기존 앱의 새 화면
 
 이 원문은 `@hjmds/design-contracts/consumer-policy.md`에서 제공한다. 소비 앱은 설치한
 패키지 버전의 정책과 HJM-APP-STANDARD release snapshot을 함께 확인한다. 이 checkout의
-1.11 소스 갱신을 아직 설치하지 않은 앱에 자동 적용된 것으로 판단하지 않는다.
+미게시 변경을 설치된 패키지의 기능으로 판단하지 않는다.
+
+2026-10-13 지침 점검에서 종료된 foundation bridge와 스타일 제거 예정 조건이 현재 규칙에
+남아 있었다. 해당 레거시 절차는 제거하고 과거 버전의 이관표와 검증 기록은 보존한다.
 
 이 문서는 "HJM답게 보인다"를 특정 화면 복제로 정의하지 않습니다. 모든 제품이 공유해야
 하는 것은 정보 위계, semantic role, 상태 피드백, 접근성 품질과 플랫폼별 행동입니다.
@@ -24,6 +27,10 @@
 - 앱 runtime은 granular subpath를 우선하고 catalog·showcase·evidence entry는 CI나
   tooling에서만 사용해야 합니다(SHOULD).
 
+저장소의 `module.contract.json` 소비 목록은 호환성 검토 대상을 기록하며 설치·배포 완료를
+뜻하지 않는다. 2026-10-13 실제 package 의존성을 대조해 누락된 Utilverse와 App Release Hub를
+추가했다. Hub는 정책 사이트 생성에 colors/foundations만 사용하므로 renderer 이관과 구분한다.
+
 ## 2. 성숙도별 채택
 
 | 사용할 surface 상태 | 신규 앱 기본 정책 | 추가 조건 |
@@ -34,7 +41,8 @@
 | `deprecated` | 신규 사용 금지 | 공지된 migration 기한 안에 제거 |
 
 `surfaceStatus`가 사용 플랫폼의 채택 기준입니다. contract `status`가 stable이어도
-다른 renderer까지 안정화됐다는 뜻은 아닙니다. 예를 들어 TopBar는 Web stable / Native beta입니다.
+다른 renderer까지 안정화됐다는 뜻은 아닙니다. 현재 값은 설치 버전의
+[성숙도 표](generated/component-maturity.md)를 확인합니다. Storybook의 배포/실험은 API 안정성이나 npm 게시 상태가 아닙니다.
 
 신규 앱 scaffold의 기본 선택은 Stable Core입니다(SHOULD). Beta 사용은 정책 예외가 아닙니다.
 앱의 기존 contract 또는 TASKS 한 곳에 컴포넌트·표면, 사용하는 이유, 담당자와 관련 회귀
@@ -42,40 +50,12 @@
 재검토 날짜는 요구하지 않습니다. 실제 기기·브라우저 QA는 바뀐 사용자 흐름과 플랫폼 위험에
 맞춰 앱 릴리스에서 수행합니다. Beta라는 이유만으로 제품 전체 QA를 반복하지 않습니다.
 
-2026-09-29 점검에서 HJM 자체 검증을 통과한 표시 컴포넌트도 제품 수·배포 이력 때문에
-승격이 막혔습니다. 1.4.0은 컴포넌트 호환성 약속과 제품 릴리스 검증을 분리합니다.
-[승격 기준](stable-promotion.md)을 따르며 기존 versioned app profile의 검사 요건은 그
-profile을 명시적으로 갱신하기 전까지 유지합니다.
-
-### 2.1 Stable Core와 필수 foundation bridge
-
-1.5.0에서 Stable Core는 17개 컴포넌트였습니다. 1.4까지의 `Surface`, `Button`, `Field`, `TextArea`에
-더해, 첫 제품 화면에 필요한 foundation인 `Text`, `Icon`, `Stack`, `Container`,
-`DesignSystemProvider`와 세 제품 이상이 쓰는 `IconButton`, `Badge`, `Card`, `Tag`, `Notice`,
-`Progress`, `Spinner`, `Skeleton`이 stable로 승격됐습니다. 승격 근거는 이름뿐이던 시나리오 증거를
-실제 계산 스타일 검사로 바꾼 뒤 두 renderer에서 요구 시나리오가 모두 통과한 것입니다
-([Stable Core](stable-core.md)). 이번 개정에서는 `Divider`, `Section`, `ListRow`, `Statistic`,
-`DescriptionList`, `EmptyState`, `Result`, `Heading`, `Top`, `BottomCTA`를 양쪽에서 승격하고,
-`TopBar`는 계약·Web만 승격했습니다. 계약/Web stable은 28개, Native stable은 27개입니다.
-배포된 패키지의 catalog가 소비 앱의 기준입니다. 남은 beta를 `stable`로
-간주하거나 `betaAdoptions: []`로 기록하는 것은 허용하지 않습니다(MUST NOT).
-
-HJM-APP-STANDARD가 versioned `requiredFoundations` 목록을 선언한 경우 다음 bridge를
-적용합니다.
-
-- 필수 foundation의 채택 이유와 최소 목록은 중앙 profile이 소유합니다. 앱마다 같은
-  선택 이유를 새로 발명하지 않습니다(MUST).
-- 각 앱은 실제 adapter와 사용 환경에 대한 evidence를 소유합니다(MUST). `draft` /
-  `incubating` contract에서는 evidence가 `planned`일 수 있지만, `active` 또는 release gate는
-  timestamp가 있는 `verified` evidence 없이는 통과하면 안 됩니다(MUST NOT).
-- 중앙 필수 목록 밖의 `beta`는 제품별 optional adoption이며 §2의 간단한 채택 기록을
-  사용합니다. 예전 profile이 ADR·verified evidence를 요구하면 해당 profile 갱신 때 이관합니다.
-- foundation이 catalog에서 `stable`로 승격되면 기존 표준의 의미를 조용히 바꾸지 않고
-  다음 versioned app profile에서 bridge 목록을 줄입니다(MUST).
-
-이 bridge는 성숙도 예외가 아니라 공개된 임시 채택 계약입니다. 1.5.0에서 bridge의 다섯
-foundation이 모두 stable이 됐으므로, 중앙 app profile의 다음 개정에서 `requiredFoundations`
-목록을 비웁니다. 개정 전까지 기존 profile을 쓰는 앱의 evidence 요구는 조용히 바뀌지 않습니다.
+컴포넌트 승격은 [승격 기준](stable-promotion.md)을 따르고 과거 판정은
+[Stable Core 기록](stable-core.md)에 보존한다. 현재 규칙에 이전 버전의 개수나 임시 foundation
+bridge를 복제하지 않는다. 구버전 소비자는 설치된 정책·profile과 해당 이관표를 확인한다.
+
+화면은 [선택 기준](usage/SELECTION.md)에 따라 그대로 사용, 공개 슬롯 확장, 제품 전용 구성 중 고른다.
+이름이 같다는 이유로 저장·스크롤·권한 흐름이 다른 화면에 공통 API를 강제하지 않는다.
 
 ## 3. 코드 경계
 
@@ -85,83 +65,22 @@ foundation이 모두 stable이 됐으므로, 중앙 app profile의 다음 개정
   또는 제품 어댑터를 사용해야 합니다(MUST).
 - 도메인 상태는 화면마다 색을 정하지 않고 제품 어댑터에서 HJM `AccentTone`과 component
   variant에 매핑해야 합니다(MUST).
-- HJM component의 `style` escape hatch는 배치용 margin, width, flex와 화면 composition에만
+- HJM component의 `layoutStyle`은 배치용 margin, width, flex와 화면 composition에만
   사용해야 합니다(SHOULD). color, typography, radius, control height와 interaction state를
   덮어쓰는 용도로 사용하면 안 됩니다(MUST NOT).
 - 플랫폼 primitive가 필요한 경우 접근성 또는 플랫폼 관습 때문에 필요한 adapter에
   한정하고, 그 이유를 해당 adapter test로 고정해야 합니다(MUST).
 
-### 3.1 React Native legacy style compatibility boundary
-
-2026-10-02 전체 소비 버전업 결정에 따라 deprecated 공개 스타일 통로는 1.11에서 제거합니다.
-정확한 제거 속성과 대체 API는 [1.11 이관표](migration-native-legacy-removal.md)를 따릅니다.
-1.x 설치본의 caller-last 호환 동작은 역사적 동작이며 현재 소스에 유지되지 않습니다.
-
-- 배치에는 `layoutStyle`을 쓰고, 제공하지 않는 컴포넌트는 외부 composition wrapper를 씁니다.
-  Web은 2026-10-06부터 화면 흐름 안에 루트가 있는 모든 공개 컴포넌트가 `layoutStyle`을 받습니다.
-  사용 지침을 쓰다가 일부 컴포넌트에만 이 prop이 있어 wrapper나 내부 input에 걸리는 `style`로
-  배치하던 것을 확인해 넓혔습니다. 제외 대상은 provider·portal/viewport layer·recipe가 위치를 고정하는
-  요소이며 그 목록과 이유는 `@hjmds/react`의 `composition-style.ts`와 각 props 타입 주석에 있습니다.
-- `HjmCompositionStyle` / `layoutStyle`은 margin, width, flex 계열과 `alignSelf`만 제공합니다. color,
-  typography, padding, gap, border, radius, height, opacity, transform은 recipe/semantic API 소유입니다.
-- 내부 조합의 스타일은 비공개 renderer에 두며 앱에서 해당 내부 파일을 import하지 않습니다.
-- 정식 플랫폼 host·제품 소유 슬롯·이미지 renderer 스타일을 deprecated 별칭과 혼동하지 않습니다.
-
-소비 앱의 legacy prop이 실제로 무엇을 덮어쓰고 있었는지 확인한 뒤, 배치가 아닌 값은
-semantic axis로 옮겼습니다. 아래는 그 축과 대체 대상입니다.
-
-| 제품이 덮어썼던 것 | semantic axis |
-| --- | --- |
-| 컨트롤에 `minHeight: 44`를 다시 얹어 compact recipe의 36pt를 가리기 | provider 환경의 `minimumVisualTarget` |
-| Button `borderRadius: 999`로 pill 만들기 | `shape="pill"` |
-| Button `justifyContent: "flex-start"`로 라벨 좌측 정렬 | `align="leading"` |
-| ListRow leading slot에 40pt 원형 avatar 프레임을 제품이 다시 계산 | `leadingShape` (`listRowRecipe.leadingSize`를 renderer가 바인딩) |
-| 중첩 web Provider의 `display: contents` 인라인 중화 | `host="contents"` |
-| secondary 컨트롤 테두리를 제품 boundary 색으로 덮기 | `borderControl` semantic key + `semanticColors.border.control` |
-
-### Web renderer의 캐스케이드
-
-`@hjmds/react/styles.css`는 **CSS 레이어 밖**에 있다(레이어된 opt-in 파일과 전환 조건은
-[brand-boundary.md §3](./brand-boundary.md#3-css-재정의는-지원하는-테마-경로가-아니다)). Tailwind 4를 쓰는 소비 앱의
-유틸리티는 `@layer utilities` 안에 들어가고, 레이어 밖 규칙은 레이어 안 규칙을
-이긴다. 따라서 HJM 컴포넌트에 `px-0`·`rounded-none`·`justify-start` 같은
-유틸리티를 붙여 recipe 값을 덮으려는 시도는 **조용히 아무 일도 하지 않는다.**
-
-이건 결함이 아니라 이 정책이 의도한 결과다 — recipe 소유 값은 지나가는
-유틸리티로 흔들리면 안 된다. 다만 **조용하다**는 점이 문제라, 소비 앱은 다음을
-알고 있어야 한다.
-
-- 유틸리티로 recipe 값을 덮는 코드는 리뷰에서 걸러야 한다. 필요한 값은 semantic
-  axis로 요청한다.
-- HJM이 표현할 수 없는 값은 `.hjm-*` 재정의로 우회하지 않는다. 계약 공백으로 올린다. 기존 재정의는
-  추적되는 부채이며 이관 경로(opt-in `styles.layered.css`)와 규칙은 [brand-boundary.md](./brand-boundary.md)가 정한다.
-- 인라인 `style`은 모든 규칙을 이기므로 이관 전에는 보이던 값이 이관 후 조용히
-  사라질 수 있다. 이관은 브라우저에서 실제 렌더를 확인하며 진행한다.
-
-> `ThemeColors`에 semantic key를 더하는 것은 `brandPalette` 부분 주입 소비자에게는
-> 무해하지만, **완전한 팔레트를 직접 선언하는 소비자에게는 타입 파괴적**이다.
-> 0.x train에서는 patch로 내보내되 릴리스 노트에 그 사실을 적고, 소비자는 새 key를
-> 채워야 한다. 1.0 이후에는 이 형태의 추가를 minor 이상으로 올린다.
-| 토글 Button·IconButton의 selected 배경·테두리를 제품 style로 칠하기 | `selected` (`buttonRecipe.states.selected`, `iconButtonRecipe.states.selected`) |
-| `link` tone Button에서 `paddingHorizontal: 0`으로 인라인 정렬 복원 | tone별 `paddingHorizontal` (link=0) |
-| Web ListRow의 1행/2행 최소 높이·padding·gap을 제품이 다시 계산 | `--hjm-list-row-*` 변수로 density recipe를 stylesheet에 바인딩 |
-| Web Switch에 size 축이 없어 track/thumb 크기를 제품 변수로 구현 | `size` prop + `--hjm-switch-*` (`switchRecipe.sizes` 바인딩) |
-| Surface에 `overflow: hidden`을 얹어 자식 이미지의 라운드 코너 침범 막기 | `surfaceRecipe[tone].clipsContent` (elevated tone은 그림자가 잘리므로 예외) |
-| Chip·ListRow·Image·LoadMore·DescriptionList의 배치용 `style` | 각 컴포넌트의 `layoutStyle` |
-
-legacy raw style surface는 다음 조건이 모두 충족된 뒤 공지된 breaking train에서 제거합니다.
-
-1. Stable Core가 canonical `layoutStyle` 또는 동등한 좁은 composition API를 제공한다.
-2. HJM showcase와 관리 중인 앱이 새 API로 이동하고 light/dark, large text, RTL과 touch-target
-   evidence를 다시 검증한다.
-3. 최소 한 fixed release train 동안 deprecation과 migration 문서를 제공한다.
-4. 제거 Changeset이 영향을 받는 prop과 semantic 대안을 열거한다.
-
-2026-09-23 소비 감사에서 1.3.5에도 deprecated prop이 남아 있음을 확인했습니다. 이전의
-“1.0.0 이전 제거” 기한은 실제 release/API와 어긋나므로 폐기합니다. 이미 게시한 1.x의 타입과
-런타임을 minor에서 삭제하는 대신, 위 네 조건과 소비 앱별 이관 목록을 충족한 다음 major에서
-제거합니다. 1.4는 semantic API와 이관 경로를 추가하는 train이며, 기존 prop을 새 화면에 쓰는
-것은 계속 금지합니다. 2026-10-02 사용자의 전체 이관 결정으로 제거 train을 1.11로 확정했습니다.
+### 3.1 배치와 시각 값
+
+- 배치에는 `layoutStyle`을 쓰고, 제공하지 않는 컴포넌트는 외부 composition wrapper를 쓴다.
+  지원 속성은 각 renderer의 `HjmCompositionStyle` 타입과 컴포넌트 Props를 따른다.
+- 색·글꼴·모서리·높이·상태 표현은 semantic API, `brandPalette`, `designProfile`로 지정한다.
+  앱에서 내부 selector나 제거된 `style`·`labelStyle` 별칭으로 덮지 않는다.
+- 플랫폼 host·제품 소유 슬롯·이미지 renderer의 정식 style은 제거된 별칭과 구분한다.
+- CSS 레이어와 기존 재정의의 이관은 [브랜드 경계](brand-boundary.md#3-css-재정의는-지원하는-테마-경로가-아니다)가 소유한다.
+- 제거된 API와 대체 prop은 [Native 호환 API 이관표](migration-native-legacy-removal.md)에 보존한다.
+  종료된 제거 예정 조건이나 0.x 버전 규칙을 현재 소비 경로로 안내하지 않는다.
 
 권장 구조는 다음과 같습니다. 실제 폴더명은 stack 관습에 맞춰도 역할은 유지합니다.
 
@@ -195,27 +114,28 @@ on-color 대비, 색에 의존하지 않는 상태 표지, reduce-motion을 제
 
 ## 5. 필수 검증과 evidence
 
-앱 CI는 최소한 다음을 실패 조건으로 두어야 합니다(MUST).
+다음 제품 계약을 유지하고, 변경한 코드와 직접 소비하는 표면의 타입·빌드·관련 동작을 검사한다.
+같은 SHA·같은 범위의 성공은 재사용하며 전체 회귀는 명시적으로 선택한다.
+문서 형식·Storybook 분류·검사 명령 문자열은 제품 배포의 차단 조건이 아니다.
 
 1. contracts/renderer exact version 일치와 금지 dependency 형식 검사
-2. versioned `requiredFoundations` 전체의 선언과 lifecycle에 맞는 app evidence 검사
+2. 설치된 catalog·앱 profile과 실제 사용 표면의 일치
 3. HJM Provider 존재와 제품 theme adapter 존재 검사
 4. 원시 색·간격·radius의 화면 레이어 유입 방지 검사
 5. typecheck, unit/component test, production build
-6. light/dark, 100–200% 글자 크기, LTR/RTL, reduce motion 중 앱이 지원한다고 선언한 환경
+6. 영향 화면의 light/dark, 지원 방향과 reduced motion 등 변경에 관련된 환경
 7. optional Beta component를 쓴다면 §2의 채택 기록과 변경한 사용자 흐름의 회귀 검사
 
 앱이 지원하지 않는 플랫폼이나 환경은 가짜 통과 script로 만들지 않고 app contract에서
 `not-applicable`과 이유를 선언해야 합니다(MUST).
 
-## 6. 예외와 변경 절차
+OS 최대 글자 및 그 최대값 모사는 설계·검증·후속 조건에서 제외한다.
 
-필수 규칙의 예외는 암묵적으로 두지 않습니다. ADR에는 다음을 모두 기록해야 합니다.
+## 6. 예외와 변경 절차
 
-- 위반하는 정책 항목과 사용자 가치
-- 검토한 대안과 선택 이유
-- 위험, 보완 테스트와 담당자
-- 만료 또는 재검토 날짜
+계약 변경이나 예외의 이유·영향·검사 결과·미확인 범위는 기존 계약 문서, TASKS 또는 커밋에 남긴다.
+작은 수정에 별도 ADR, 고정 항목 수, 중복 승인을 요구하지 않는다. 임시 우회에는 제거 조건을 적는다.
+공개 API·데이터·호환성을 바꾸면 해당 계약과 migration을 갱신한다.
 
 공통 API를 바꾸는 것이 한 제품의 local override보다 적절하면 제품 코드를 복제하지 않고
 HJM에 Changeset과 Web/RN evidence를 먼저 제출합니다. 반대로 제품 의미가 들어가면 공통
@@ -226,8 +146,7 @@ package로 승격하지 않습니다.
 다음 질문에 모두 "예"라고 답할 수 있어야 HJM 채택이 완료된 것입니다.
 
 - exact fixed-train dependency와 Provider가 CI에서 검증되는가?
-- Stable은 기본 사용하고(1.5.0 이전 profile이면 필수 foundation은 중앙 목록+앱 evidence로),
-  optional Beta는 채택 기록과 관련 회귀 검사로 추적되는가?
+- 설치 버전의 surfaceStatus를 따르고 optional Beta는 채택 기록과 관련 회귀 검사로 추적되는가?
 - screen 코드가 semantic token·component를 우회하지 않는가?
 - 같은 상태가 Web/RN에서 같은 의미와 자연스러운 플랫폼 행동을 갖는가?
 - 로고를 제거해도 제품의 핵심 콘텐츠와 정보 구조가 다른 제품과 구분되는가?

package/docs/generated/component-maturity.md

@@ -1,6 +1,6 @@
 # Component maturity and evidence manifest
 
-> Generated from `@hjmds/design-contracts` 1.17.2. Do not edit this file directly; run `pnpm contracts:sync`.
+> Generated from `@hjmds/design-contracts` 1.19.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.17.2",
+  "designSystemVersion": "1.19.0",
   "source": "packages/design-contracts/docs/generated/showcase-manifest.json",
   "surfaces": {
     "web": {
       "packageName": "@hjmds/react",
-      "packageVersion": "1.17.2",
+      "packageVersion": "1.19.0",
       "activeComponents": 103,
       "claimedComponents": 103,
       "completeScenarioComponents": 103,
@@ -5642,7 +5642,7 @@
     },
     "native": {
       "packageName": "@hjmds/react-native",
-      "packageVersion": "1.17.2",
+      "packageVersion": "1.19.0",
       "activeComponents": 83,
       "claimedComponents": 83,
       "completeScenarioComponents": 83,

package/docs/generated/renderer-evidence.md

@@ -1,6 +1,6 @@
 # Renderer evidence coverage
 
-> Generated for HJM 1.17.2. Do not edit directly; run `pnpm evidence:sync`.
+> Generated for HJM 1.19.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.17.2",
+  "designSystemVersion": "1.19.0",
   "packageName": "@hjmds/design-contracts",
   "components": [
     {

package/docs/gravity-letters.md

@@ -24,3 +24,5 @@ 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.
+
+장식 animation 생성이 중간에 실패하면 이미 만든 animation을 정리하고 정적인 글자를 유지한다. 장식 실패로 본문을 제거하지 않는다.

package/docs/grid-reveal.md

@@ -9,3 +9,5 @@
 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 비용과 프레임별 효과 타이밍 검증은 별도다.
+
+장식 animation 생성이 중간에 실패하면 이미 만든 animation과 마스크를 정리하여 본문을 즉시 드러낸다.

package/docs/layout.md

@@ -69,8 +69,8 @@ Web의 `footer` slot은 `Layout`이 `<footer>` contentinfo를 정확히 한 번
 `BottomNavigation`은 자체 루트를 이름 있는 `<nav>`로 렌더링하고 contentinfo를
 만들지 않으므로 `footer={<BottomNavigation ... />}` 합성 결과도 `<footer>` 하나와
 `<nav>` 하나다. Native `Layout`은 같은 source order만 유지하며 skip link를
-렌더링하거나 요구하지 않는다. `skipLinkLabel` Native prop은 이전 호출부 호환을
-위해 deprecated 상태로만 남아 있다.
+렌더링하거나 요구하지 않는다. Native `LayoutProps`에는 `skipLinkLabel`이 없다.
+Web의 skip-link 입력을 Native에 공통 props로 넘기지 않는다.
 
 **현재 검증.** 공통 descriptor를 직접 소비하는 first-party Web/RN renderer가 실제
 landmark, source order, overlay adapter를 검증한다. Web Chromium test는 skip-link가 첫

package/docs/load-more.md

@@ -28,6 +28,11 @@ ready(requestKey) ─ request ─→ loading(requestKey)
 - loading copy는 status로, 오류는 alert로 한 번만 발표합니다. retry/manual target은 44-unit
   이상이고 focus indicator를 유지합니다.
 
+2026-10-13 수명 검수: 성공으로 완료된 Native viewport 요청만 같은 cursor의 자동 재요청을
+막는다. 진행 중 다른 요청에 막힌 cursor와 실패한 요청은 재시도할 수 있다. Web/Native 모두
+unmount 또는 mode 변경으로 교체된 footer의 늦은 outcome/error 콜백을 전달하지 않는다.
+제품 query 자체의 취소·데이터 저장은 여전히 제품 adapter가 소유한다.
+
 Web `IntersectionObserver`와 RN `onEndReached`는 감지 방식만 다르며 같은 controller와 state를
 사용합니다. 페이지 번호가 필요한 탐색은 `Pagination`, 사용자 의도 없이 계속 이어지는 긴
 목록은 `LoadMore`로 분리합니다.

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

@@ -1,6 +1,8 @@
-# 1.11 호환 API 제거와 소비 이관
+# Native 호환 API 제거와 소비 이관
 
-검토일: 2026-10-06 · 1.11 minor 소스 변경 · npm 게시와 소비 설치는 별도 확인
+검토일: 2026-10-13 · 잔여 시각 style 제거는 breaking 소스 변경 · npm 게시와 소비 설치는 별도 확인
+
+## 1.11 제거 이력
 
 사용자가 전체 소비 앱을 함께 버전업하므로 구형 호환 API도 제거하라고 요청했다.
 별칭과 deprecated 스타일 통로를 유지하는 대신 기존 canonical API로 이관한다.
@@ -46,34 +48,39 @@ renderer에 주입하는 이미지 스타일, 제품 소유 슬롯과 private re
 LoadMore의 내부 Button 조합은 비공개 RecipeButton을 써서 recipe의 크기·색·그림자를 보존한다.
 해당 구현을 패키지 entry에서 export하지 않는다.
 
-## 1.13 deprecated 시각 style (제거는 다음 major)
+## 2026-10-13 잔여 시각 style 제거
+
+1.13에서는 2026-10-06에 발견한 잔여 raw `StyleProp` 통로의 동작을 유지하고 개발 모드에서
+한 번 경고했다. 이는 당시 minor 호환성 조치였다. 2026-10-13 레거시 제거 요구에 따라 아래
+공개 속성과 시각 style 병합을 소스에서 제거했다. 최초 major 후보를 준비한 뒤 사용자가
+이번 버전도 minor로 올리도록 명시하여 **1.19.0**으로 결정했다. 호환성이 깨지는 제거이므로
+아래 소비 호출을 함께 이관한다. 버전 준비·npm 게시·소비 설치는 각각 별도로 확인한다.
 
-2026-10-06 사용 지침 작성 중 위 표 밖의 Native 컴포넌트가 아직 raw `StyleProp` 시각 통로를
-받는 것을 확인했다. 1.11처럼 minor에서 지우거나 Button처럼 throw하면 1.x 소비 앱이 깨지므로
-이번 minor는 동작을 유지한 채 `@deprecated` JSDoc과 개발 모드 1회 `console.warn`
-(`internal/deprecated-style.ts`, 컴포넌트·prop마다 한 번, production 무음)만 단다. 없던 곳에는
-`layoutStyle`을 추가했다. 실제 삭제는 [consumer-policy §3.1](consumer-policy.md#31-react-native-legacy-style-compatibility-boundary)의
-네 조건을 채운 다음 major에서 한다.
+정식 배치는 [consumer-policy §3.1](consumer-policy.md#31-배치와-시각-값)을 따른다.
+제거 속성은 타입 오류다. JavaScript 호출도 더 이상 외형을 바꾸지 못하며, host로 나머지 props를
+전달하는 컴포넌트는 제거 속성을 명시적으로 거부한다. 그 외 컴포넌트의 미지정 속성 무시는
+호환 지원을 뜻하지 않는다. 일반 Link 아이콘·Dialog 오류 진단은 `internal/diagnostics.ts`로
+분리해 보존했다.
 
-| 컴포넌트 | deprecated prop | 대체 |
+| 컴포넌트 | 제거한 prop | 대체 |
 | --- | --- | --- |
 | IconButton, Link, BottomCTA, Agreement, Asset, AssetGroup, AuthProviderButton, BottomInfo, Carousel, Collapsible, Container, Section, Icon, Steps, Top, UploadItem | `style` | 배치는 `layoutStyle`, 외형은 각 recipe·semantic prop |
 | Heading | `style`(TextStyle) | `layoutStyle`, 크기·굵기는 `level` |
 | Badge, Tag | `style`, `labelStyle` | `layoutStyle`, `tone`/`size`/`variant` |
-| ListRow | `titleStyle`, `descriptionStyle` | `density`·`selected`, listRowRecipe typography |
+| ListRow | `titleStyle`, `descriptionStyle` | `density`·`selected`·`tone="danger"`, listRowRecipe typography |
 | Avatar | `style`, `imageStyle` | `layoutStyle`, `size`/`renderFallback` |
 | Divider, CounterBadge, List, Timeline | `style` | `layoutStyle`, 각 컴포넌트 축 |
 | Accordion | `style`, `itemStyle`, `triggerStyle`, `titleStyle`, `indicatorStyle`, `panelStyle` | `layoutStyle`, `density`/`renderIndicator` |
 | DescriptionList, StatisticGroup | `style`, `itemStyle` | `layoutStyle`, descriptor·`density` |
 | Statistic | `style`, `labelStyle`, `valueStyle`, `affixStyle`, `trendStyle`, `hintStyle` | `layoutStyle`, `density`/`presentation` |
 | Notice, Result, Spinner, Skeleton, Toast | `style` | `layoutStyle`, `tone`/`status`/`size`/`shape`·`width`·`height` |
-| EmptyState | `style`, `illustrationStyle`, `titleStyle`, `descriptionStyle`, `actionStyle` | `layoutStyle`, `density`/`align` |
+| EmptyState | `style`, `illustrationStyle`, `titleStyle`, `descriptionStyle`, `actionStyle` | `layoutStyle`, `density`/`align`. illustration은 최소 크기와 실제 콘텐츠 크기를 함께 존중 |
 | Progress | `style`, `labelStyle`, `valueStyle`, `trackStyle`, `indicatorStyle` | `layoutStyle`, `tone`/`size`/`shape` |
 | ToastRegion | `style`, `toastStyle` | `layoutStyle`, `placement`/`safeAreaInsets` |
-| AlertDialog, Sheet | `contentStyle`의 배치 밖 key | 배치 key만 사용. 다음 major에서 Dialog처럼 `HjmCompositionStyleProp`으로 좁힘(배치 key만 넘기면 경고 없음) |
+| AlertDialog, Sheet | `contentStyle`의 배치 밖 key | `HjmCompositionStyleProp` 배치 key만 사용. AlertDialog 크기는 `size="small" | "medium" | "large"` |
 | Tabs | `style`, `tabListStyle` / TabPanel `style` | `layoutStyle`, `size`/`layout`/`overflow`/`appearance` |
 | BottomNavigation | `style`, `surfaceStyle`, `listStyle`, `primaryActionStyle` | `layoutStyle`, `configuration` |
-| TopBar | `style`, `leadingStyle`, `titleStyle`, `trailingStyle` / TopBar action `style`, `labelStyle` | `layoutStyle`, `centered`/`labelVisibility` |
+| TopBar | `style`, `leadingStyle`, `titleStyle`, `trailingStyle` | `layoutStyle`, `centered`/`labelVisibility` |
 | Menu | `style` | `layoutStyle`, `density` |
 | Checkbox, Radio, CheckboxGroup, RadioGroup | `style`, `controlStyle`, `indicatorStyle`, `leadingStyle`, `contentStyle`, `labelStyle`, `descriptionStyle` | `layoutStyle`(행 또는 그룹), selection control recipe |
 | Switch, SegmentedControl, Form, Select, Combobox, TagsInput, ToggleGroup, DatePicker, FilePicker, TransferList | `style` | `layoutStyle`, 각 컴포넌트 `size`·descriptor |
@@ -85,9 +92,10 @@ LoadMore의 내부 Button 조합은 비공개 RecipeButton을 써서 recipe의
 
 제외(정식 host·renderer 스타일): KeyboardAvoiding·KeyboardDock(플랫폼 host), Image·ImageAdapter `style`(renderer 주입),
 EffectSurface·ThinkingOrb·SharedTransition(optional motion host frame), Text·Stack·AspectRatio·Grid·Layout(내부 조합 전반이
-쓰는 layout primitive라 경고하면 HJM 자신이 경고를 낸다. 내부 renderer 분리 후 별도 train에서 다룬다).
+쓰는 layout primitive). TopBar `renderAction`에 주입하는 action appearance의 `style`·`labelStyle`,
+Section 슬롯과 Chip leading/indicator/trailing의 정식 배치 속성도 보존한다.
 
-이관: 경고 문구의 prop을 찾아 margin·width·flex·alignSelf만 남긴 값은 `layoutStyle`로 옮기고, 색·글꼴·padding·
+이관: 위 표의 호출과 래퍼 전파를 찾아 margin·width·flex·alignSelf만 남긴 값은 `layoutStyle`로 옮기고, 색·글꼴·padding·
 높이·radius는 semantic prop으로 옮긴다. 표현할 축이 없으면 `.hjm-*`·style 우회 대신 계약 공백으로 올린다.
 
 ## 관리 소비 저장소
@@ -95,7 +103,12 @@ EffectSurface·ThinkingOrb·SharedTransition(optional motion host frame), Text·
 번뚝·다에리·비행중·모펀의 직접 호출과 제품 래퍼를 함께 이관한다. 스핀트·유틸버스·포트폴리오
 사이트·App Release Hub도 새 공개 타입으로 검사한다. 웹과 앱이 있는 제품은 양쪽을 확인한다.
 소스 검사, 새 패키지 설치/lock 갱신, 기기 검증, npm 게시·운영 배포는 별개의 단계다.
-로컬 후보 선언을 연결한 검사만으로 게시된 1.11 소비 설치를 주장하지 않는다.
+로컬 후보 선언을 연결한 검사만으로 게시된 패키지의 소비 설치를 주장하지 않는다.
+
+설치된 1.18.0에도 있는 `layoutStyle` 이관은 먼저 적용할 수 있다. 새 `ListRow.tone`과
+`AlertDialog.size`는 후보 패키지에만 있으므로 기존 1.18.0 선언을 캐스트로 우회하지 않는다.
+Utilverse 계정 탈퇴 행과 BurnTok 대화상자 크기 어댑터는 새 패키지 설치·타입검사와 함께
+이관해야 한다. 이 두 호출이 남아 있는 동안 해당 흐름의 로컬 소스 모드를 완료로 보고하지 않는다.
 
 ## Storybook
 

package/docs/optional-adapters.md

@@ -172,3 +172,7 @@ 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.
+
+### 사진 앨범 탐색과 로딩 (2026-10-12)
+
+`CarouselMotion`의 선택적 `navigation="counter"`는 이전·현재/전체·다음 한 줄 컨트롤을 Web/Native에 제공한다. 기존 기본 버튼 탐색·유한한 keyed selection·숨겨진 항목의 초점 차단·동작 줄이기 계약은 유지한다. 번뚝의 사진 넘김을 기존 모션 어댑터에 연결하기 위한 표현이며 새 어댑터/peer를 만들지 않는다. `ImageViewer`의 loading 상태는 액자 중앙 Spinner와 접근성 전용 loadingLabel을 사용한다. 제품의 private query·Expo onDisplay·cachePolicy=none은 host 책임이다.

package/docs/screen-patterns.md

@@ -180,6 +180,10 @@ import { SearchScreen } from "@hjmds/react/screen-flows";
 Native는 import만 해당 renderer의 `screen-flows`로 바꾸고 플랫폼별 자식/host를 제공한다.
 React Query 등을 쓰는 제품은 이 화면의 callback을 기존 제품 query 상태와 연결하며 별도 캐시를 만들지 않는다.
 필터 변경은 debounce query 변경과 독립적이므로 제품 query key에 필터도 포함한다.
+
+`debounceMs` 기본값은 `searchScreenRecipe.debounceMs`(300ms)이며 양 renderer가
+`resolveSearchDebounceMs`로 해석한다. 0과 유한한 사용자 지연은 유지하고 음수는 기존처럼 0으로
+맞춘다. `NaN`·±`Infinity`는 호스트 타이머마다 다르게 해석될 수 있어 예약 전에 `RangeError`로 거부한다.
 예제 미디어는 로컬 샘플 사진과 모의 업로드이며 기기 갤러리·네트워크 업로드를 실행하지 않는다.
 예제 권한은 상태 분기만 보여 주며 실제 OS 권한을 바꾸지 않는다.
 
@@ -303,7 +307,7 @@ SearchScreen accepts a queryField slot for an existing accessible SearchField wi
 | 레일 첫 칩(`filterSheet.trigger`)은 HJM이 그리고 이름에 적용 개수를 넣는다(Web `aria-haspopup="dialog"`) | 적용 칩·모두 해제 뒤 포커스가 돌아갈 고정 대상이 필요하다 | 제품이 trigger를 그림(포커스 복귀 대상을 HJM이 모름) |
 | Web: 적용 칩·최근 검색 행을 지우면 같은 자리 다음 항목, 없으면 trigger(최근 검색은 입력)로 포커스. 목록이 실제로 줄어든 뒤에 옮긴다(`resolveFocusAfterRemoval`). Native는 옮기지 않는다 | 지운 버튼이 사라져 포커스가 `<body>`로 떨어지는 것을 막는다. Native는 프로그램 포커스 이동이 화면을 다시 읽게 해 낭독 커서를 그대로 둔다 | 항상 입력으로 이동(칩 줄 탐색이 끊김) |
 | 개수 낭독은 HJM: 입력 중 "제안 N개", 결과 개수, `searching`이면 `searchingLabel`. Web은 숨긴 `role="status"`, Native는 `announceForAccessibilityWithOptions(queue)`. 문구가 바뀔 때만 | 제품마다 live region을 다시 만들면 중복·누락 낭독이 생긴다 | 제품 소유 |
-| `resultSummary.count === null`이면 결과 머리 개수 자리에 Skeleton, `children` 대신 로딩 행 4개(`searchScreenRecipe.loadingRows`). Web은 ListRow `loading`(행 높이 유지) | 결과가 도착할 때 목록이 뛰지 않는다 | spinner로 본문 교체(`state="loading"`, 입력·필터·이전 결과가 사라짐) |
+| `resultSummary.count === null`이면 결과 머리 개수 자리에 Skeleton, `children` 대신 로딩 행 4개(`searchScreenRecipe.loadingRows`). 양 renderer는 ListRow `loading`으로 같은 두 줄 행 geometry를 사용하며 첫 행에만 loadingLabel을 제공 | 결과가 도착할 때 목록이 뛰지 않는다 | spinner로 본문 교체(`state="loading"`, 입력·필터·이전 결과가 사라짐) |
 | 정렬은 결과 머리 끝 Menu(single). 바꾸면 본문을 맨 위로 | Menu 지침이 정렬을 용도로 명시. 시트 안 정렬은 정렬 하나에 시트 왕복이 필요 | 필터 시트 안 정렬 |
 | `queryLabelVisibility="hidden"`: 보이는 label을 빼고 `queryLabel`을 접근성 이름(Web `aria-label`, Native `accessibilityLabel`)과 placeholder로 쓴다 | 참고 서비스 공통 모양. 1배 약 22, 2배 약 40만큼 고정 영역을 아낀다(2026-10-06 실측). placeholder가 검색 대상을 알린다(Apple HIG) | placeholder 없이 숨김(보이는 이름이 없는 입력) |
 | `searching`+`searchingLabel`: Web `loading`, Native `busy`+`busyLabel`을 한 이름으로. 둘 다 주거나 둘 다 생략(타입) | 2026-10-06 utilverse 적용 조사: 진행 표시 하나 때문에 제품이 입력을 `queryField`로 통째로 바꿨다 | 플랫폼별 이름 그대로 노출 |
@@ -387,3 +391,21 @@ CommentThreadScreen의 optional threadHeader는 첫 댓글 앞의 스크롤 콘
 모두 같은 본문에 배치하고 상태 교체 시 함께 숨긴다. fixed header는 짧은 탐색 영역, composer는
 고정 작성 영역이다. Spint의 2026-10-08 이중 스크롤 문제 때문에 추가했으며 상세 사용법은
 [댓글 화면](usage/components/comment-thread-screen.md#배치)을 따른다.
+
+
+### 화면별 독립 복구와 첫 행동 (미게시, 1.18.0 이후)
+
+2026-10-13 계층 점검에서 빈 채팅의 첫 입력이 사라지고 상세 조회 실패를 제품이 다시 조립해야 하는
+누락을 확인했다. 기존 화면 API를 다음과 같이 보강한다.
+
+- `ChatScreen`은 ready뿐 아니라 empty에서도 composer를 유지한다. loading/error/restricted에서는
+  입력을 숨긴다. 전송 실패는 ready/empty를 유지하고 notice로 알린다.
+- `ListDetailScreen.detail`에 선택 `state`, `stateAction`, `notice`를 받는다. 상세만 본문 교체 또는
+  비차단 실패를 표현하고 숨겨진 목록의 입력·스크롤은 유지한다. 기존 title/content는 호환된다.
+- `OnboardingScreen`은 complete.pending 또는 skip.pending 동안 다음·이전·완료·건너뛰기를
+  함께 잠근다. 제품의 입력값과 라우터 이탈 처리는 제품 소유다.
+- `CommentThreadScreen`은 루트마다 전체 items를 재탐색하지 않고 한 번 만든 부모별 인덱스로
+  답글을 읽는다. 루트·답글의 서버 순서와 펼침·동작 계약은 유지한다. 가상화 구현은 아니다.
+
+검증: 각 renderer의 `screen-recovery` 테스트. Web은 Chromium 동작 검사, Native는 host 렌더 검사이며
+실기기 성능·운영 서버·npm 게시·소비 앱 반영을 뜻하지 않는다.

package/docs/toast.md

@@ -45,7 +45,7 @@ const result = store.publish({
   `accessibilityLabel`에 완전한 이름을 제공합니다.
 - 기본 알림과 리퀴드 알림은 모두 표시 후 3초에 자동 닫힘을 시작합니다. 리퀴드는 진입 연출 동안 타이머를 멈춥니다.
   2026-10-02 사용자 요청으로 기존 5초 기본값·최솟값을 3초로 변경했습니다.
-- action이 있는 Toast는 기본 persistent입니다. 제품이 명시한 `durationMs`도 3000ms보다
+- action 또는 press가 있는 Toast는 기본 persistent입니다. 제품이 명시한 `durationMs`도 3000ms보다
   짧아질 수 없으며, `null`은 명시적 persistent입니다.
 
 `publish` 결과에는 stable id와 `visible | queued` 위치가 포함됩니다. 호출자는 반환된 함수
@@ -93,11 +93,50 @@ queued(waiting, 3000) ─ show ─→ visible(running, 3000)
 `action` reason으로 닫으며, `dismissOnAction: false`면 알림은 남지만 같은 action은 다시
 실행되지 않습니다. stable id update는 새 revision이므로 새 action을 한 번 실행할 수 있습니다.
 
-`timeout | action | close-action | escape | swipe | programmatic | queue-overflow | interrupted`
+`timeout | action | press | close-action | escape | swipe | programmatic | queue-overflow | interrupted`
 reason 중 하나만 최종 `onDismiss`로 전달됩니다. visible Toast는 exit 완료 시 callback을
 정산하고 queued overflow와 provider teardown은 visual exit 없이 즉시 정산합니다. 중복 action,
 close, exit complete와 두 번째 provider dispose는 아무 상태도 바꾸지 않습니다.
 
+## 카드 전체 활성화 — 2026-10-13 (미게시)
+
+댓글·답장 알림에서 카드 본문을 눌러 관련 화면으로 이동하도록 `press`를 추가했다.
+기존 `action`은 보이는 실행 버튼, `press`는 카드의 본문·미디어·여백을 누르는 동작이다.
+별도 알림 컴포넌트를 만들지 않고 동일 Toast descriptor/session/store에 연결한다.
+
+```ts
+store.publish({
+  id: "reply:42",
+  title: t("reply.receivedTitle"),
+  description: t("reply.receivedBody"),
+  closeLabel: t("common.closeNotification"),
+  press: { accessibilityLabel: t("reply.open"), onPress: openReply },
+});
+```
+
+참조 분석: MIT [expo-dynamic-notifications `use-dismiss-gesture.ts` @ 5de059a](https://github.com/rit3zh/expo-dynamic-notifications/blob/5de059a5cbefbe28c14efbe785166665a7c70bc5/src/hooks/use-dismiss-gesture.ts)는
+`Gesture.Exclusive(pan, tap)`으로 입력을 나누고 성공한 탭에서 콜백 후 dismiss를 예약한다.
+HJM은 그 동작 순서를 독립 구현한다. Native 표준/리퀴드와 Web이 같은 순수 session을 사용하며,
+이미 존재하는 큐·타이머를 교체하거나 optional gesture 의존성을 표준 Toast에 추가하지 않는다.
+
+- `press.accessibilityLabel`과 `press.onPress`는 필수. 라우팅과 문구는 제품 소유다.
+- 카드·실행·닫기는 형제 조작이다. Web의 실제 button은 Tab·Enter·Space와 포커스 표시를 제공한다.
+  Native는 독립 Pressable과 읽을 수 있는 이름/설명을 제공하고, 리퀴드의 상위 swipe responder가 탭을 취소한다.
+- `invokePress`는 visible revision당 한 번 실행하고 콜백 뒤 `press` 사유로 닫는다.
+  action/press의 재진입과 이미 닫히는 카드의 입력은 무시한다. 콜백이 같은 id를 새 revision으로 갱신하면
+  새 내용을 닫지 않으며, provider가 제거되면 기존 `interrupted` 정산을 보존한다.
+- 동기 콜백이 throw해도 닫힘을 시작하고 오류를 호출자에게 전달한다. 비동기 라우팅/요청 완료는 기다리지 않는다.
+- press가 있으면 기본 persistent, 명시적 duration은 기존 3초 하한을 적용한다. press가 없으면 기존 동작 그대로다.
+- 검증 파일: `test/toast-press.test.ts`(contracts), `packages/react/test/toast-press.browser.test.tsx`,
+  `packages/react-native/test/toast-press.test.tsx`, `packages/react-native/test/toast-liquid.test.tsx`.
+  Native host 테스트는 실제 기기 hit-test·스크린리더 검증이나 소비 앱 적용 증거가 아니다.
+
+검증: 계약 41개, Web Chromium 11개, Native host 20개의 관련 테스트 통과.
+세 패키지와 두 Showcase 타입 검사, 세 패키지 빌드 및 Web light/dark 기본 글자 화면을 확인했다.
+전체 회귀·실기기·npm 게시·소비 앱 적용은 미실행. `usage:sync`는 기존 다른 작업의
+`components/carousel.md`·`components/chat-message.md` 절 형식 2건으로 실패했으며 해당 변경은 보존했다.
+공개 API 이름 대응표는 변경 없이 검사 통과했다.
+
 ## Renderer acceptance
 
 ### Compact Web layout — 2026-09-15
@@ -169,6 +208,29 @@ overflow와 update를 검증합니다.
 - [Radix Toast](https://www.radix-ui.com/primitives/docs/components/toast)
 - [React Spectrum Toast](https://react-spectrum.adobe.com/Toast)
 
+## 패널 Toast — 미게시(1.17.2 이후)
+
+2026-10-10 사용자 요청("칩이랑 패널 디자인시스템에 넣고 … 패널은 디자인 시스템에 있는 토스트를 대체하고 리퀴드
+토스트의 토스트도 대체해 — 패널이 토스트가 되는거지")으로 BurnTok이 검수 상태용으로 만든 패널을 Toast 자체의
+모양으로 삼습니다. 별도 `Panel` API를 만들지 않은 이유: 같은 id 갱신·지속·닫기·낭독·큐를 Toast store가 이미
+소유하고, 두 번째 떠 있는 층을 만들면 큐와 낭독이 둘이 됩니다.
+
+- 모양: 모든 Toast의 모서리는 `xl`(24)입니다. Native 리퀴드 카드도 같은 패널 열(미디어/배지 · 문구 · 닫기)을
+  그리고, 프로필이 없을 때의 리퀴드 모서리도 12 → 24로 바뀝니다. 리퀴드의 투명 chrome·물방울 연출은 유지합니다.
+- `media?: unknown`: 제품 마스코트·아바타 같은 장식 시각물입니다. core는 검사하지 않고 그대로 넘기며
+  (`ResolvedToastDescriptor.media`, 없으면 `null`), renderer는 ReactNode로 그려 tone badge 자리(44, `toastRecipe.media.size`)를
+  대신하고 보조기술에서 숨깁니다. tone은 `data-tone`과 문구가 계속 전달합니다. renderer 전용 prop을 버린 이유는
+  store가 descriptor를 해석·보관하므로 그 밖의 값은 갱신 때 사라지기 때문입니다.
+- `progress?: { steps: readonly string[]; current: number }`: 실행 중인 작업 단계입니다. 단계는 2~5개의 비어 있지 않은
+  현지화 문자열이고(320 폭에서 한 줄 유지가 목표, 넘치면 줄바꿈) `current`는 0부터 시작하는 실행 단계 index입니다.
+  앞 단계는 완료로 그립니다. 기본 announcement는 `title. description. <현재 단계>`입니다.
+  점은 장식이고 단계 이름이 옆에 있어 색만으로 상태를 전달하지 않습니다(Web은 `ol`과 `aria-current="step"`).
+- action은 둘째 줄 끝이 아니라 **문구 아래 시작 쪽**(`toastRecipe.action.align = "start"`)입니다. 눈이 이미 있는 자리에
+  둔다는 BurnTok 패널 배치를 따랐습니다. pill 모양·44 target·대비는 1.10.0 그대로입니다.
+- 작업 상태 패널은 `id` 고정 + `durationMs: null`로 열고, 단계·결과가 바뀔 때 같은 id로 다시 publish해 제자리에서
+  갱신합니다. 여닫는 트리거는 [`ActivityChip`](activity-chip.md), 흐름은
+  [백그라운드 작업 상태 구성](usage/compositions/activity-status.md)입니다.
+
 ## 프로필 행간 소비 — 미게시
 
 2026-10-07 소비 감사에서 Web 제목/설명의 1.35/1.45 고정 행간이 `typography.body.lineHeight`를