@hjmds/design-contracts 1.17.2 → 1.19.0

package/docs/usage/components/toast.md

@@ -4,9 +4,9 @@
 - 상태: 배포
 - 지원: Web · Native
 - 적용: 1.12.1
-- 검토일: 2026-10-07
+- 검토일: 2026-10-13
 - 근거: [Toast](../../toast.md), [Liquid Toast](../../../../react-native/docs/liquid-toast.md), `src/component-recipes.ts`(`toastRecipe`)
-- 스토리북: `배포/컴포넌트/상태와 알림/토스트`, `배포/컴포넌트/상태와 알림/리퀴드 토스트`
+- 스토리북: `배포/컴포넌트/상태와 알림/토스트`, `배포/컴포넌트/상태와 알림/리퀴드 토스트`, `실험/구성/피드백과 복구/백그라운드 작업 상태`
 
 ## 언제 쓰나
 
@@ -20,6 +20,7 @@
 | 화면 안에 계속 남아야 하는 안내·경고(점검 예정, 권한 없음, 폼 오류 요약) | [Notice](notice.md) |
 | 사용자가 응답해야 진행되는 확인·삭제 확인·필수 선택 | [AlertDialog](alert-dialog.md) |
 | 작업 결과를 화면 전체로 보여 줌 | [Result](result.md) |
+| 헤더에 작업 상태를 상시 표시하고 눌러서 패널을 여닫음 | [ActivityChip](activity-chip.md) + 이 Toast 패널([구성](../compositions/activity-status.md)) |
 
 선택 기준: 사용자가 놓쳐도 되고 자리를 차지하면 안 되면 Toast, 그 화면을 보는 동안 계속 보여야 하거나
 읽지 않으면 다음 행동을 잘못할 수 있으면 Notice다. Toast에는 그 알림에서만 할 수 있는 행동을 두지 않는다.
@@ -78,20 +79,23 @@ function useProfileSavedToast() {
 
 | prop | 값 | 기본값 | 설명 |
 | --- | --- | --- | --- |
-| descriptor | `id`·`description`·`closeLabel` 필수, `title`·`tone`·`priority`·`durationMs`·`action`·`announcement`·`presentation` 선택 | — | 모두 `string`(ReactNode 아님) |
+| descriptor | `id`·`description`·`closeLabel` 필수, `title`·`tone`·`priority`·`durationMs`·`action`·`press`·`announcement`·`presentation`·`media`·`progress` 선택 | — | 문구는 모두 `string`(ReactNode 아님). `media`만 예외 |
+| `media` | `unknown`(Web·Native에서 `ReactNode`를 넘긴다) | — | 미게시(1.17.2 이후). 장식 시각물(마스코트·아바타). tone 배지 자리를 44(`toastRecipe.media.size`) 원으로 대신하고 보조기술에서 숨긴다 |
+| `progress` | `{ steps: readonly string[]; current: number }` | — | 미게시(1.17.2 이후). 단계 2~5개, `current`는 0부터. 설명 아래 점+이름 줄로 그리고, 기본 낭독 끝에 현재 단계 이름을 붙인다. 범위 밖이면 throw |
 | `action` | `{ label, accessibilityLabel?, onAction: () => void, dismissOnAction? }` | — | 누르면 `onAction`, 기본으로 알림이 닫힌다 |
+| `press` | `{ accessibilityLabel: string; onPress: () => void }` | 없음 | 미게시. 카드 본문·미디어·여백을 누르면 콜백 후 `press` 사유로 닫힌다. 실행·닫기 버튼과 스와이프는 열기 동작을 실행하지 않는다. Web은 Tab/Enter/Space, Native는 독립 접근성 버튼 |
 | `tone` | `neutral` · `info` · `success` · `warning` · `danger` | `neutral` | — |
 | `priority` | `normal` · `high` | — | 낭독 순서, 색과 무관 |
-| `durationMs` | ms · `null` | 3000 | 더 짧게 줘도 3000으로 올라간다. `null`은 수동으로 닫을 때까지 유지, `action`이 있으면 기본 유지 |
+| `durationMs` | ms · `null` | 3000 | 더 짧게 줘도 3000으로 올라간다. `null`은 수동으로 닫을 때까지 유지, `action` 또는 `press`가 있으면 기본 유지 |
 | `placement` | `bottom` · `top` · `top-start` · `top-end` · `bottom-start` · `bottom-end` | `bottom` | — |
 | 큐 | `maxVisible` · `maxQueued` · `duplicatePolicy` · `timerUpdatePolicy` · `overflowPolicy` | 1 · 20 · `update` · `preserve` · `discard-oldest` | — |
 | `publish` | Web `(descriptor, options?) => ToastPublishResult`, Native `(descriptor) => ToastPublishResult` | — | 결과는 `{ outcome: "added" \| "updated", id, position: "visible" \| "queued" }`, `{ outcome: "ignored", id, reason: "duplicate" \| "closing" }`, `{ outcome: "discarded", id, reason: "queue-overflow" }` 중 하나 |
 | `dismiss` | Web `(id, reason) => boolean`, Native `(id, reason?) => boolean` | — | 닫았으면 `true`. Web은 `close(id)`도 있다. Native는 `pause`·`resume(id, reason?)`도 있다 |
-| 닫힘 사유 `ToastDismissReason` | `timeout` · `action` · `close-action` · `escape` · `swipe` · `programmatic` · `queue-overflow` · `interrupted` | — | Web `Toast` `onDismissRequest`·Native `onDismiss`가 받는다 |
+| 닫힘 사유 `ToastDismissReason` | `timeout` · `action` · `press` · `close-action` · `escape` · `swipe` · `programmatic` · `queue-overflow` · `interrupted` | — | Web `Toast` `onDismissRequest`·Native `onDismiss`가 받는다 |
 | `toasts`/`defaultToasts` + `onToastsChange`(Native `ToastRegion`) | `readonly ToastDescriptor[]`, `(toasts) => void` | — | 큐를 제품 상태로 제어할 때 |
 | `safeAreaInsets`(Native) | `{ top?, bottom?, left?, right?, start?, end? }` | `{}` | — |
 | `layoutStyle`(Native `Toast`·`ToastRegion`) | `HjmCompositionStyleProp` | — | Web Toast·ToastProvider에는 없다(떠 있는 층이라 배치 대상이 아님) |
-| `style`·`toastStyle`(Native) | `StyleProp<ViewStyle>` | — | deprecated — `layoutStyle` 또는 `placement`·`safeAreaInsets`. 개발 모드에서 한 번 경고하고 다음 major에서 제거된다 |
+| `style`·`toastStyle`(Native) | 지원하지 않음 | — | 제거된 속성 — `layoutStyle` 또는 `placement`·`safeAreaInsets`. 현재 공개 props에서 제거되었다 |
 
 ### 디자인 프로필 상속
 
@@ -101,10 +105,10 @@ function useProfileSavedToast() {
 프로필 없는 소비자의 기본값은 유지한다. 상태·초안·선택·Modal teardown은 이 축의 소유가 아니다.
 플랫폼 근사와 미검증 범위는 [프로필 계약](../../design-profile.md#오버레이선택-입력의-프로필-연결-보완)을 따른다.
 
-Native의 선택형 `/toast-liquid`도 가장 가까운 프로필의 `radius.lg`와 `shadow.raised`를
+Native의 선택형 `/toast-liquid`도 가장 가까운 프로필의 `radius.xl`(패널 이전 `radius.lg`)과 `shadow.raised`를
 읽는다. 일반 Toast의 `floating` 대신 `raised`를 유지하는 이유는 리퀴드 카드의 얕은 깊이를
 정한 기존 검토다. RN 내용 clip과 Skia 카드 모서리를 함께 바꾸고 그림자의 위·아래·좌·우
-여유를 확보한다. 프로필이 없으면 기존 모서리 12와 foundation `raised`를 유지한다.
+여유를 확보한다. 프로필이 없으면 모서리 24(패널, 미게시 1.17.2 이후. 그전 12)와 foundation `raised`를 쓴다.
 원형 시작점·큐·행동은 유지하며 Web은 일반 Toast fallback이다. 기존
 `실험/구성/비교와 검증/테마 조합`의 Native ‘물방울 알림의 테마 비교’에서 같은 알림을
 유지한 채 다음 테마로 바꿀 수 있다. 기기 시각·음성·제스처 검증은 별도로 남는다.
@@ -114,9 +118,9 @@ Native의 선택형 `/toast-liquid`도 가장 가까운 프로필의 `radius.lg`
 
 | 항목 | 값 | 근거 |
 | --- | --- | --- |
-| 크기 | 카드 최대 폭 420(Web `min(420px, 100vw − 2×spacing.md)`, Native 화면 폭 − 안전 영역 − 2×16에서 420으로 자름). 최소 높이 56(`layout.rowHeight.singleLine`). 열은 [아이콘 배지 32][문구][닫기 44]. `action`은 높이 44(`control.minTouchTarget`), 좌우 여백 `spacing.md` 16의 pill | `toastRecipe.viewport`·`surface`·`icon`·`action`, `.hjm-toast`, `react-native/src/feedback.tsx` |
+| 크기 | 카드 최대 폭 420(Web `min(420px, 100vw − 2×spacing.md)`, Native 화면 폭 − 안전 영역 − 2×16에서 420으로 자름). 최소 높이 56(`layout.rowHeight.singleLine`). 모서리 `radius.xl` 24(패널, 미게시 1.17.2 이후. 그전 `lg` 16). 열은 [아이콘 배지 32 또는 `media` 44][문구][닫기 44]. `action`은 높이 44(`control.minTouchTarget`), 좌우 여백 `spacing.md` 16의 pill. `progress` 점 6(현재 단계 1.4배) | `toastRecipe.viewport`·`surface`·`icon`·`action`, `.hjm-toast`, `react-native/src/feedback.tsx` |
 | 간격 | 화면 가장자리에서 `spacing.md` 16 + 안전 영역(`safeAreaMode: "additive"`). 여러 장 사이 `spacing.sm` 12. 카드 안 열 간격 `spacing.sm` 12 | `toastRecipe.viewport`, `.hjm-toast-viewport` |
-| 순서·정렬 | 기본은 아래 가운데(`placement="bottom"`). 위쪽 배치는 위에서 아래로, 아래쪽 배치는 가장자리부터 위로 쌓인다. `action`은 둘째 줄 끝 | `toastRecipe.placements`, `.hjm-toast__action` |
+| 순서·정렬 | 기본은 아래 가운데(`placement="bottom"`). 위쪽 배치는 위에서 아래로, 아래쪽 배치는 가장자리부터 위로 쌓인다. 문구 열 안 순서는 제목 → 설명 → `progress` → `action`. `action`은 문구 아래 시작 쪽(`toastRecipe.action.align` `start`, 미게시 1.17.2 이후. 그전 둘째 줄 끝) | `toastRecipe.placements`, `.hjm-toast__action` |
 | 고정·스크롤 | 화면 흐름 밖에 떠 있는 층이라 본문 레이아웃에 자리를 만들지 않는다. 하단 고정 바(BottomNavigation·BottomCTA)가 있으면 Web `bottomOffset`(px 또는 CSS 길이), Native `keyboardOffset`으로 그 위에 띄운다. Native 아래쪽 배치는 `avoidKeyboard`(기본 true)로 키보드 위에 선다 | `react/src/toast.tsx`, `react-native/src/feedback.tsx`(`ToastRegion`) |
 | 좁은 폭·큰 글자 | 폭이 줄고 문구가 줄바꿈되어 카드가 세로로 자란다. 잘라 내지 않는다 | `.hjm-toast__content`(`overflow-wrap: anywhere`) |
 
@@ -126,13 +130,28 @@ Native의 선택형 `/toast-liquid`도 가장 가까운 프로필의 `radius.lg`
 │ 본문(스크롤)                 │      │ 본문(스크롤)                 │
 │                              │      │ ┌──────────────────────────┐ │
 │ ┌──────────────────────────┐ │      │ │(●) 저장했어요        [×] │ │
-│ │(●) 저장했어요        [×] │ │      │ │              [되돌리기]  │ │ ← action(선택)
+│ │(●) 저장했어요        [×] │ │      │ │    [되돌리기]            │ │ ← action(선택), 문구 아래 시작 쪽
 │ └──────────────────────────┘ │      │ └──────────────────────────┘ │
 │   ↑ 16 + 안전 영역           │      │   ↑ bottomOffset/keyboardOffset
 └──────────────────────────────┘      │ [홈] [검색] [내 정보]        │ ← 고정 바
   좌우 16, 최대 폭 420, 가운데         └──────────────────────────────┘
 ```
 
+### 패널 — media·progress (미게시, 1.17.2 이후)
+
+2026-10-10 사용자 요청으로 패널이 Toast의 모양이 됐다(기본·리퀴드 모두). 진행 중인 작업은 같은 `id`, `durationMs: null`로
+열어 두고 단계가 바뀔 때마다 같은 `id`로 다시 `publish`해 제자리에서 갱신한다. 끝나면 `progress`를 빼고 결과 문구와
+`action`으로 바꾼다. 여닫는 트리거는 [ActivityChip](activity-chip.md)이다.
+
+```text
+┌──────────────────────────────────────┐
+│ (🐥)  도우미                      [×] │  ← media 44가 tone 배지 자리를 대신
+│       앱을 다듬고 있어요.              │
+│       ● 읽기  ◉ 다듬기  ○ 확인         │  ← progress: 완료·현재(굵게)·예정, 점 6
+│       [결과 보기]                      │  ← action: 문구 아래 시작 쪽
+└──────────────────────────────────────┘    모서리 radius.xl 24
+```
+
 ## 꼭 지킬 것
 
 - Provider/Region은 앱에 하나만 두고 화면마다 새로 만들지 않는다. 진행 상태를 바꿀 때는 같은 `id`로 다시 `publish`한다.
@@ -159,14 +178,14 @@ Native의 선택형 `/toast-liquid`도 가장 가까운 프로필의 `radius.lg`
 - 리퀴드는 `placement="top"`과 `maxVisible={1}`일 때만 동작하고, 아니면 `ToastRegion`이 `TypeError`를 던진다.
   어댑터는 render 밖에서 만들거나 memo한다.
 - ToastRegion 배치는 `layoutStyle={{ flex: 1 }}`로 쓴다. Native 예제도 이 경로를 사용한다.
-- Web `Toast` 단독 렌더는 나머지 HTML 속성(id·data-*·이벤트)을 루트에 전달한다(미게시(1.12.1 이후). 1.12.1은 `className`만 전달). `role`·`aria-labelledby`·`aria-describedby`·`data-tone`·`data-state`는 Toast가 정하므로 덮이지 않는다. 배치는 Provider를 쓴다.
+- Web `Toast` 단독 렌더는 나머지 HTML 속성(id·data-*·이벤트)을 루트에 전달한다(1.13.0 변경. 1.12.1은 `className`만 전달). `role`·`aria-labelledby`·`aria-describedby`·`data-tone`·`data-state`는 Toast가 정하므로 덮이지 않는다. 배치는 Provider를 쓴다.
 
 
 ### 고정 아이콘과 큰 글자
 
 2026-10-06 최근 검색 삭제 기호가 큰 글자에서 잘린 재현에 따라 Native 내장 삭제·메뉴 기호는 고정 아이콘 틀의 크기를 유지한다. 주변 제목·라벨은 계속 확대한다. Chip의 체크와 Toast 닫기는 기존 비확대 경로를 유지하며 회귀 검사에 포함한다. 제품이 전달한 아이콘 슬롯은 제품이 같은 조건을 검증한다.
 
-### 프로필 행간 소비 — 미게시
+### 프로필 행간 소비 — 1.16.0 변경
 
 2026-10-07 소비 감사에서 Web 제목/설명의 1.35/1.45 고정 행간이 `typography.body.lineHeight`를
 우회하는 것을 확인했다. 두 slot은 기존 body 역할이므로 선택된 프로필의 `--hjm-type-body-line-height`를
@@ -174,3 +193,12 @@ Native의 선택형 `/toast-liquid`도 가장 가까운 프로필의 `radius.lg`
 일괄 기본 행간 변경은 기존 알림 레이아웃까지 바꾸므로 채택하지 않았다. Native 본문 행간은 이미 body
 토큰을 소비하며, 이번 Native 변경은 action 라벨의 ui 서체 역할만 명시한다. 알림 문구·큐·시간·닫기·
 행동·초점 계약은 바꾸지 않는다.
+
+### 카드에서 관련 화면 열기
+
+댓글·답장·작업 완료 알림에서 `press: { accessibilityLabel: t("reply.open"), onPress: openReply }`를
+같은 descriptor에 넣는다. `action`은 카드와 별개의 실행 버튼이 필요할 때만 함께 쓴다.
+본문·이미지·카드 여백 전체가 열기 영역이며 실행·닫기 버튼은 각각 자기 동작만 수행한다.
+Web은 전체 영역의 투명한 button과 두 제어 버튼을 형제로, Native는 뒤쪽 Pressable과 위쪽 제어 버튼을
+독립적으로 배치한다. label은 동작 이름, 설명은 기존 알림 문구이며 기본 카드 배치와 크기는 바뀌지 않는다.
+라우터는 HJM이 가져오지 않고 제품 콜백이 실행한다. 화면 이동 뒤 provider가 없어져도 중복 실행하지 않는다.

package/docs/usage/components/toggle-group.md

@@ -64,7 +64,7 @@ import { ToggleGroup } from "@hjmds/react-native/toggle-group";
 | `size` | `small` · `medium` | `medium` | medium은 최소 높이 44 |
 | `items[].disabled` | `boolean` | `false` | `disabled` 항목은 켜지지 않고 눌림 집합에도 들어가지 않는다. 사라진 id의 눌림 상태는 렌더 때 버려진다(`reconcileToggleGroupSelection`) |
 | `layoutStyle` | `HjmCompositionStyleProp` | — | 묶음 컨테이너 배치. Web·Native 모두 |
-| `style`(Native) | `StyleProp<ViewStyle>` | — | deprecated — `layoutStyle` 또는 `size`. 개발 모드에서 한 번 경고하고 다음 major에서 제거된다 |
+| `style`(Native) | 지원하지 않음 | — | 제거된 속성 — `layoutStyle` 또는 `size`. 현재 공개 props에서 제거되었다 |
 
 ## 배치
 
@@ -83,7 +83,7 @@ import { ToggleGroup } from "@hjmds/react-native/toggle-group";
 - 라벨은 i18n 키로 넣고 짧게 둔다. 단일 선택 모드는 없다. 하나만 고르게 하려고 변환하지 않는다.
 - 눌림 표시 색은 recipe(`idle`/`pressed`)가 소유한다. 상태는 Web `aria-pressed`, Native `selected`로
   알리므로 색만으로 상태를 바꿔 그리지 않는다.
-- 배치는 `layoutStyle`(묶음 컨테이너)로 한다. Web `className`·Native의 deprecated `style`로 항목 모양을 덮지 않는다.
+- 배치는 `layoutStyle`(묶음 컨테이너)로 한다. Web `className`·Native에서 제거된 `style`로 항목 모양을 덮지 않는다.
 
 ## 플랫폼 차이
 
@@ -91,7 +91,7 @@ import { ToggleGroup } from "@hjmds/react-native/toggle-group";
 | --- | --- | --- |
 | 컨테이너 | `role="group"` + `aria-label` | `View` + `accessibilityLabel`(role 없음) |
 | 배치 | CSS(`hjm-toggle-group`) | 가로 `flexWrap: "wrap"` |
-| 외부 꾸밈 | `className`, `ref`, `layoutStyle` | `layoutStyle`(`style`은 deprecated) |
+| 외부 꾸밈 | `className`, `ref`, `layoutStyle` | `layoutStyle`(`style`은 제거된 속성) |
 | 키보드 | 항목마다 tab stop(roving 없음) | 해당 없음 |
 
 ### 제품 테마의 모서리

package/docs/usage/components/tooltip.md

@@ -72,7 +72,7 @@ Native: 없음. 계약상 Native는 `unsupported`이고 hover UI를 흉내 내
 
 | 항목 | 값 | 근거 |
 | --- | --- | --- |
-| 크기 | 말풍선 안쪽 여백 사방 `spacing.xs` 8(`tooltipRecipe.surface.padding`; 2026-10-06까지 Web은 좌우 12였다, 1.12.1 이후 미게시), 모서리 `radius.sm` 8, 최대 폭 280(`tooltipRecipe.content.maxWidth`, 화면 폭 − 24를 넘지 않음). trigger는 그 자체로 최소 터치 영역 44를 지켜야 한다(Tooltip은 영역을 넓히지 않는다). 보통 [IconButton](icon-button.md) | `tooltipRecipe.surface`, `.hjm-tooltip__content` |
+| 크기 | 말풍선 안쪽 여백 사방 `spacing.xs` 8(`tooltipRecipe.surface.padding`; 2026-10-06까지 Web은 좌우 12였다, 1.13.0 변경), 모서리 `radius.sm` 8, 최대 폭 280(`tooltipRecipe.content.maxWidth`, 화면 폭 − 24를 넘지 않음). trigger는 그 자체로 최소 터치 영역 44를 지켜야 한다(Tooltip은 영역을 넓히지 않는다). 보통 [IconButton](icon-button.md) | `tooltipRecipe.surface`, `.hjm-tooltip__content` |
 | 간격 | trigger와 4(`positioning.sideOffset` = `spacing.xxs`), 뷰포트 가장자리와 최소 12(`positioning.collisionPadding` = `spacing.sm`) | `tooltipRecipe.positioning`, `react/src/overlays.tsx`(`Tooltip`) |
 | 순서·정렬 | trigger 바로 옆에 붙는다. 한 줄에 Tooltip 달린 아이콘 버튼이 여럿이면 하나만 보이고, 300ms 안에 옆으로 옮기면 바로 열린다 | `react/src/overlays.tsx`(`Tooltip`) |
 | 고정·스크롤 | 떠 있는 층(`position: fixed`)이라 문서 흐름에 자리를 만들지 않고 trigger 크기도 바꾸지 않는다. 공간이 모자라면 반대쪽으로 뒤집힌다 | `.hjm-tooltip__content`, `react/src/portal.tsx` |

package/docs/usage/components/top-bar.md

@@ -75,10 +75,11 @@ import { TopBar, TopBarAction } from "@hjmds/react-native/top-bar";
 | `titleLeading` | `ReactNode` | — | 제목 앞 작은 시각 요소 |
 | `leading` / `actions`(별칭 `trailing`) | `ReactNode` | — | 둘 중 한 이름만 쓴다 |
 | `layoutStyle` | `HjmCompositionStyleProp` | — | 루트 배치. Web·Native 모두 |
-| Native `style`·`leadingStyle`·`titleStyle`·`trailingStyle` | `StyleProp` | — | deprecated — `layoutStyle` 또는 `centered`. 개발 모드에서 한 번 경고하고 다음 major에서 제거된다 |
+| Native `style`·`leadingStyle`·`titleStyle`·`trailingStyle` | 지원하지 않음 | — | 제거된 속성 — `layoutStyle` 또는 `centered`. 현재 공개 props에서 제거되었다 |
 | `TopBarAction` `intent` | `button` · `link` | `button` | `button`은 `onPress: (event) => void`, `link`는 `destination` + `onNavigate?: (destination: LinkDestination) => void \| Promise<void>` 또는 `renderLink` |
 | `TopBarAction` `labelVisibility` | `visible` · `accessibility-only` | `visible` | — |
-| `TopBarAction` `layoutStyle` | `HjmCompositionStyleProp` | — | `style`·`labelStyle`은 deprecated |
+| `TopBarAction` `layoutStyle` | `HjmCompositionStyleProp` | — | `style`·`labelStyle`은 제거된 속성 |
+| Native `TopBarAction` `renderAction`·`renderLink` | 렌더 콜백 | — | 전달받은 control props의 `style`·접근성·동작은 정식 host 입력이다. 이를 host에 그대로 연결하며 제거된 소비자 override prop과 구분한다 |
 | `NavigationBar` | `label`·`brand`·`children` 필수, `actions` 선택 | — | Web만 `layoutStyle`도 받는다 |
 
 ## 배치
@@ -108,7 +109,7 @@ NavigationBar의 Native 프레임 모서리는 Provider의 `tokens.radius.xl`을
 - `title` 없이 `titleLeading`·`onTitleClick`/`onTitlePress`·`titleAccessibilityLabel`을 주면 `TypeError`다.
 - 이동은 슬롯 안의 Link(Native는 `intent="link"`)로, 제목 클릭은 실제 버튼으로 표현한다.
 - 화면 이름·행동 라벨은 i18n 키로, 아이콘은 제품 소유다. 높이·간격·제목 색은 recipe가 정한다.
-  배치는 `layoutStyle`로만 하고 Native의 deprecated 슬롯 스타일로 덮지 않는다.
+  배치는 `layoutStyle`로만 하고 Native에서 제거된 슬롯 스타일로 덮지 않는다.
 - 큰 글자에서 Native는 슬롯 구조를 다시 만들어 슬롯 안 로컬 상태·포커스가 초기화될 수 있다.
   유지할 상태는 TopBar 밖에 둔다.
 - `NavigationBar`는 `label`(빈 문자열이면 throw)·`brand`·`children` 필수, `actions` 선택이다.
@@ -120,7 +121,7 @@ NavigationBar의 Native 프레임 모서리는 Provider의 `tokens.radius.xl`을
 | --- | --- | --- |
 | 루트 | `div`(Dialog 안에서도 landmark를 추가하지 않음), ref·HTML 속성 전달 | `accessibilityRole="toolbar"` `View`, ref 없음 |
 | 제목 접근성 | `h1`~`h6` | `accessibilityRole="header"`, `titleAccessibilityHint`(`onTitlePress` 필수) |
-| 슬롯 스타일 | `className`·`style`, 배치는 `layoutStyle` | 배치는 `layoutStyle`(`style`·`leadingStyle`·`titleStyle`·`trailingStyle`은 deprecated) |
+| 슬롯 스타일 | `className`·`style`, 배치는 `layoutStyle` | 배치는 `layoutStyle`(`style`·`leadingStyle`·`titleStyle`·`trailingStyle`은 제거된 속성) |
 | 큰 글자 | CSS가 제목을 다음 행으로 | 글자 배율이 `largeTextThreshold` 이상이면 leading+제목 행 아래에 행동 행 |
 | 행동 컴포넌트 | 일반 `IconButton`·`Link` | `TopBarAction`(아이콘 + 마이크로 라벨, 44pt) |
 | `NavigationBar` 배경 | 지원 시 blur + 92% 불투명 | 불투명 surface(blur 없음) |

package/docs/usage/components/top.md

@@ -60,7 +60,7 @@ import { Top } from "@hjmds/react-native/top";
 | `descriptor.headingLevel` | `1` · `2` · `3` | `1` | 한 라우트가 여러 화면을 담을 때만 낮춘다(Web만 반영) |
 | `trailing` | `ReactNode`(요소 하나) | — | 제목 줄을 같이 쓰는 보조 행동. 공간이 모자라거나 큰 글자면 아래로 내려간다 |
 | `layoutStyle` | `HjmCompositionStyleProp` | — | 루트 배치. Web·Native 모두 |
-| `style`(Native) | `StyleProp<ViewStyle>` | — | deprecated — `layoutStyle`. 개발 모드에서 한 번 경고하고 다음 major에서 제거된다 |
+| `style`(Native) | 지원하지 않음 | — | 제거된 속성 — `layoutStyle`. 현재 공개 props에서 제거되었다 |
 
 ## 배치
 
@@ -78,7 +78,7 @@ import { Top } from "@hjmds/react-native/top";
 - `eyebrow`에는 제목을 한정하는 짧은 말(카테고리·단계)만 넣고 제목에 없는 새 정보를 넣지 않는다.
 - 주 행동을 `trailing`에 두지 않는다. 화면의 주 행동은 [BottomCTA](bottom-cta.md)나 본문 [Button](button.md)이다.
 - 상태가 없다. 제목을 바꾸려면 다른 문자열을 넘긴다.
-- 배치는 `layoutStyle`로 한다(Web `className`도 받는다). Native `style`은 deprecated다. 글자 크기·색은 recipe가 정하므로 덮지 않는다.
+- 배치는 `layoutStyle`로 한다(Web `className`도 받는다). Native `style`은 제거된 속성이다. 글자 크기·색은 recipe가 정하므로 덮지 않는다.
 
 ## 플랫폼 차이
 
@@ -92,4 +92,4 @@ import { Top } from "@hjmds/react-native/top";
 
 2026-10-07 소비 감사에서 두 renderer의 제목 크기·행간·굵기가 foundation으로 확정된 recipe를 직접 읽어 프로필을 우회했다. `large`는 가까운 프로필의 `heading.level2`, `medium`은 `typography.titleLarge`를 읽고 프로필이 없으면 기존 recipe를 유지한다. 시각 역할은 `headingLevel`과 독립이며 display 서체·제목 의미·보조 행동·초점은 바꾸지 않는다.
 
-프로필 연결은 1.15.0 이후 미게시 변경이며, 기본 배포 계약과 실제 Native 기기 검증은 구분한다.
+프로필 연결은 1.16.0 변경이며, 기본 배포 계약과 실제 Native 기기 검증은 구분한다.

package/docs/usage/components/transfer-list.md

@@ -73,7 +73,7 @@ import { TransferList } from "@hjmds/react-native/transfer-list";
 | `items` | `{ id, label, textValue, description?, disabled? }[]` | — | `disabled` 항목은 선택도 이동도 되지 않는다 |
 | 패널별 체크 선택 | 내부 상태 | — | 이동 전 임시 상태라 prop으로 받지 않는다. 이동 버튼은 해당 패널에 선택이 있을 때만 활성화된다 |
 | `layoutStyle` | `HjmCompositionStyleProp` | — | 최상위 컨테이너 배치. Web·Native 모두 |
-| `style`(Native) | `StyleProp<ViewStyle>` | — | deprecated — `layoutStyle`. 개발 모드에서 한 번 경고하고 다음 major에서 제거된다 |
+| `style`(Native) | 지원하지 않음 | — | 제거된 속성 — `layoutStyle`. 현재 공개 props에서 제거되었다 |
 
 ## 배치
 
@@ -101,7 +101,8 @@ Web ≥ 480                                  Web < 480 · Native
 
 - `labels`의 여섯 문구는 모두 제품 i18n으로 넣는다. HJM은 문장을 만들지 않는다.
 - 이동 결과 낭독은 제품 몫이다. `onMove(movedIds, direction)`로 "2명 이동" 같은 문장을 만들어 알린다.
-- 배치는 `layoutStyle`(최상위 컨테이너)로 한다. Web `className`·Native의 deprecated `style`로 패널·행 모양을 덮지 않는다.
+- 빈 패널의 안내는 해당 목록 내부에서 중앙 정렬한다. Native에서 패널에 남는 높이가 있으면 안내가 그 영역의 세로 중앙을 채운다.
+- 배치는 `layoutStyle`(최상위 컨테이너)로 한다. Web `className`·Native에서 제거된 `style`로 패널·행 모양을 덮지 않는다.
 
 ## 플랫폼 차이
 
@@ -112,10 +113,10 @@ Web ≥ 480                                  Web < 480 · Native
 | 키보드 | 화살표·Home/End 이동, Space 선택, Enter로 그 행만 이동 | 없음 |
 | 이동 후 포커스 | 빈 자리로 올라온 행, 비면 빈 상태 문구 | 옮기지 않음 |
 | 패널 비었을 때 전체 선택 | 활성 | `disabled` |
-| 외부 꾸밈 | `className`, `ref`, `layoutStyle` | `layoutStyle`(`style`은 deprecated) |
+| 외부 꾸밈 | `className`, `ref`, `layoutStyle` | `layoutStyle`(`style`은 제거된 속성) |
 
 ### 프로필 모서리·제목 소비
 
 2026-10-07 소비 감사에서 Native 패널의 모서리 12가 프로필을 우회했다. Web 패널의 기존 `radius.md`와 같은 역할을 Native도 가까운 프로필에서 읽으며, 프로필이 없으면 기존 12를 유지한다. 선택 집합·이동·비활성 항목·초점 계약은 바꾸지 않는다.
 
-프로필 연결은 1.15.0 이후 미게시 변경이며, 기본 배포 계약과 실제 Native 기기 검증은 구분한다.
+프로필 연결은 1.16.0 변경이며, 기본 배포 계약과 실제 Native 기기 검증은 구분한다.

package/docs/usage/components/upload-item.md

@@ -70,7 +70,7 @@ import { UploadItem } from "@hjmds/react-native/upload-item";
 | `onCancel` / `onRetry` | `(id: string) => void` | — | descriptor `id`를 받는다. `uploading`·`error` 상태에서는 각각 필수 |
 | `leading` | `ReactNode` | — | 아이콘·썸네일(장식) |
 | `layoutStyle` | `HjmCompositionStyleProp` | — | 행 바깥 배치. Web·Native 모두 |
-| `style`(Native) | `StyleProp<ViewStyle>` | — | deprecated — `layoutStyle`. 개발 모드에서 한 번 경고하고 다음 major에서 제거된다 |
+| `style`(Native) | 지원하지 않음 | — | 제거된 속성 — `layoutStyle`. 현재 공개 props에서 제거되었다 |
 
 ## 배치
 
@@ -96,7 +96,7 @@ import { UploadItem } from "@hjmds/react-native/upload-item";
 
 | 항목 | Web | Native |
 | --- | --- | --- |
-| 루트 | `role="group"`, `aria-label`=파일명, `HTMLAttributes`·`ref`·`layoutStyle` 전달 | 일반 `View`, `layoutStyle`(`style`은 deprecated) |
+| 루트 | `role="group"`, `aria-label`=파일명, `HTMLAttributes`·`ref`·`layoutStyle` 전달 | 일반 `View`, `layoutStyle`(`style`은 제거된 속성) |
 | 상태 낭독 | 상태 문장 live region | 파일 정보 묶음이 한 요소(`busy` state, value=상태 문장), 액션은 별도 버튼 |
 | `leading` | `aria-hidden` | 접근성 트리에서 숨김 |
 
@@ -104,4 +104,4 @@ import { UploadItem } from "@hjmds/react-native/upload-item";
 
 2026-10-07 소비 감사에서 Native 행의 모서리 12가 프로필을 우회했다. Web의 기존 `radius.md`와 같은 역할을 Native도 가까운 프로필에서 읽으며, 프로필이 없으면 기존 12를 유지한다. 업로드 상태·취소/재시도·진행 알림은 바꾸지 않는다.
 
-프로필 연결은 1.15.0 이후 미게시 변경이며, 기본 배포 계약과 실제 Native 기기 검증은 구분한다.
+프로필 연결은 1.16.0 변경이며, 기본 배포 계약과 실제 Native 기기 검증은 구분한다.

package/docs/usage/components/virtual-list.md

@@ -93,6 +93,7 @@ import { VirtualList } from "@hjmds/react-native/virtual-list";
 - `rowHeight`는 현재 글자 배율에서 행 내용이 들어가는 값으로 제품이 정한다. 행 내용이 넘쳐도 잘리거나 겹칠 뿐
   늘어나지 않는다. 높이를 확정할 수 없으면 List를 쓴다.
 - 행 내용·데이터 가져오기는 제품 소유, 창 계산·키보드 탐색은 HJM 소유다.
+- `empty` 안내는 `height`로 정한 목록 내부 영역의 가로·세로 중앙에 놓인다. Web에서 포인터나 프로그램으로 행에 초점을 옮긴 뒤에도 방향키는 그 행부터 이어진다.
 
 ## 플랫폼 차이
 

package/docs/usage/compositions/action-feedback.md

@@ -4,7 +4,7 @@
 - 상태: 배포
 - 지원: Web · Native
 - 적용: 1.14.0
-- 검토일: 2026-10-07
+- 검토일: 2026-10-13
 - 근거: 공개 API를 사용하는 `showcase/*/reference-adoption-previews.tsx`
 - 스토리북: `배포/구성/피드백과 복구/버튼 완료 피드백`
 
@@ -12,7 +12,7 @@
 
 ## 언제 쓰나
 
-입력을 유지하며 저장의 진행·성공·재시도 가능 실패를 보여 줄 때 쓴다. 별도 신규 wrapper API가 아니라 아래 공개 컴포넌트의 조합 규격이다.
+입력을 유지하며 저장의 진행·성공·재시도 가능 실패를 보여 줄 때 쓴다. 화면 wrapper 없이 아래 공개 컴포넌트와 `resolveSaveFeedback`을 조합한다.
 
 ## 구성 요소
 
@@ -50,16 +50,50 @@
 | 진행 중 | 실제 작업 상태에 맞는 loading 또는 열린 도구 | 중복 요청 차단, 입력 유지 |
 | 실패 | 문구와 가능한 재시도 | 원래 입력/파일 유지, 결과 안내 |
 
+## 현재 초안과 저장 응답 연결
+
+`@hjmds/design-contracts/action-session`의 `resolveSaveFeedback`은 Web/Native 공통 순수 함수다.
+알림 설정과 첫 기록 화면에서 반복하던 저장 응답·현재 초안 분기를 공유한다.
+`phase`는 기존 action session 또는 제품 mutation의 상태, `dirty`는 **현재 초안과 마지막 확정 값**의 비교,
+`valid`는 제품 검증 결과, `hasSaved`는 확정 값 존재 여부다. 낙관적 값과 비교해 저장 완료로 판단하지 않는다.
+선택적 `disabled`는 권한 등 제품의 실행 잠금이며 기본값은 false다.
+
+| 결과 | 의미 |
+| --- | --- |
+| `pending` | 요청 진행 중. 입력을 유지하고 제출은 막음 |
+| `saved` | 성공한 확정 값과 현재 초안이 같음 |
+| `saved-with-changes` | 이전 제출은 성공했지만 현재 초안은 아직 미저장 |
+| `error` | 요청 실패 후 변경이 남음. 현재 초안을 다시 저장할 수 있음 |
+| `unsaved` | 아직 저장하지 않은 변경이 있음 |
+| `unchanged` | 새 변경이 없음. 저장값으로 되돌린 뒤에는 이전 오류를 다시 표시하지 않음 |
+
+`feedback`과 별도로 `currentSaved`는 현재 초안이 확정 값과 같은지 나타낸다.
+`canSubmit`은 변경됨·유효함·진행 중 아님·잠금 아님을 모두 만족할 때만 true다.
+이 함수는 요청 잠금이나 응답 무효화를 구현하지 않는다. 기존 `session.run`이 중복 실행을 막고
+`session.reset`이 늦은 응답을 무효화한다. 버튼의 `disabled`만으로 요청 경합을 제어하지 않는다.
+제품은 비교·문구·영구 저장을 소유하고, 실패 후 현재 초안을 저장할 때 새 제출값을 캡처해 `run`한다.
+`retry`는 기존 실패 요청의 값 재시도이므로 현재 초안 저장과 구분한다.
+
+```ts
+import { resolveSaveFeedback } from "@hjmds/design-contracts/action-session";
+const feedback = resolveSaveFeedback({
+  phase: state.status,
+  dirty: !sameDraft(draft, confirmedValue),
+  valid: isValid(draft),
+  hasSaved,
+});
+```
+
 ## 코드 골격
 
 ```tsx
 // Web
-<Button loading={busy} onClick={save}>{busy ? pendingLabel : saveLabel}</Button>
+<Button loading={feedback.pending} disabled={!feedback.canSubmit} onClick={save}>{feedback.pending ? pendingLabel : saveLabel}</Button>
 ```
 
 ```tsx
 // Native
-<Button loading={busy} onPress={save}>{busy ? pendingLabel : saveLabel}</Button>
+<Button loading={feedback.pending} disabled={!feedback.canSubmit} onPress={save}>{feedback.pending ? pendingLabel : saveLabel}</Button>
 ```
 
 Web은 `@hjmds/react`의 해당 granular entry, Native는 `@hjmds/react-native` entry를 쓴다.
@@ -67,11 +101,13 @@ Button의 실행 콜백은 Web `onClick`, Native `onPress`로 연결한다. 위
 
 예제 응답은 useDemoAction의 인위 지연이며 실제 네트워크·영구 저장이 아니다.
 완료 문구는 응답 확정 뒤 표시한다. 저장 중 입력 편집이 가능하므로, 저장 결과는 현재
-초안으로 바꿔 쓰지 말고 응답 값으로 표시한다. 실패 체험 설정은 요청 중 바꾸지 않는다.
+초안으로 바꿔 쓰지 말고 응답 값으로 표시한다. 현재 초안과 저장한 제목이 다르면 완료 체크를 제거하고
+“현재 제목은 아직 저장하지 않았어요”와 마지막 저장 제목을 따로 보여 준다. 2026-10-13 실제 예제에서
+진행 중 편집한 제목에도 이전 요청의 완료 체크가 남는 경로를 확인해 구분했다. 실패 체험 설정은 요청 중 바꾸지 않는다.
 
 ## 플랫폼 차이
 
 | 항목 | Web | Native |
 | --- | --- | --- |
 | 배치/테마 | Stack과 HjmProvider | Stack과 HjmNativeProvider |
-| 큰 글자·좁은 폭 | 줄바꿈·단일 내용 | 같은 순서, OS 화면 검증은 별도 |
+| 좁은 폭 | 줄바꿈·단일 내용 | 같은 순서, OS 화면 검증은 별도 |

package/docs/usage/compositions/action-recovery-optimistic.md

@@ -129,6 +129,7 @@ function BookmarkToggle({ initial, setBookmark }: { initial: boolean; setBookmar
 
 ```tsx
 // Native
+import { StatusText } from "@hjmds/react-native/status-text";
 import { useState, useSyncExternalStore } from "react";
 import { ScrollView, useWindowDimensions } from "react-native";
 import { createActionSession } from "@hjmds/design-contracts/action-session";
@@ -163,7 +164,7 @@ function BookmarkToggle({ initial, setBookmark }: { initial: boolean; setBookmar
 }
 ```
 
-`setBookmark`(서버가 확정한 boolean을 돌려줌)과 `StatusText`는 제품 소유다([공통 절](action-recovery-save.md#공통-세션과-상태-알림)의 helper).
+`setBookmark`(서버가 확정한 boolean을 돌려줌)는 제품 소유다. `StatusText`는 [공개 Text companion](../components/text.md#statustext)이다.
 
 ## 플랫폼 차이
 
@@ -178,3 +179,7 @@ function BookmarkToggle({ initial, setBookmark }: { initial: boolean; setBookmar
 
 - 구획 제목은 Heading으로 표시한다. 이전 Text heading 예제는 2026-10-06 제목 의미 구조를 맞추면서 수정했다.
 - 재시도는 secondary로 두어 저장과 경쟁하는 primary를 만들지 않는다(2026-10-06 예제 반영).
+
+### 재시도 뒤 초점과 결과 구분
+
+Web 예제는 사라질 재시도 버튼에서 기존 북마크 토글로 초점을 옮긴다. pending의 토글은 `aria-disabled`와 Button의 실행 차단을 사용해 키보드 위치를 유지한다. Native 예제의 `disabled`와 구분한다. 서버 새 상태로 reset한 뒤 이전 완료는 상태나 초점을 덮지 않는다. 예제는 메모리 요청이며 실제 서버 정합성을 검증하지 않는다.

package/docs/usage/compositions/action-recovery-save.md

@@ -145,6 +145,7 @@ function SaveNote({ save }: { save(value: string): Promise<string> }) {
 
 ```tsx
 // Native
+import { StatusText } from "@hjmds/react-native/status-text";
 import { useState, useSyncExternalStore } from "react";
 import { ScrollView, useWindowDimensions } from "react-native";
 import { createActionSession } from "@hjmds/design-contracts/action-session";
@@ -173,7 +174,7 @@ function SaveNote({ save }: { save(value: string): Promise<string> }) {
             {t("common.save")}
           </Button>
           {state.status === "error" && <Button tone="secondary" onPress={() => void session.retry()}>{t("save.retry")}</Button>}
-          <StatusText>{t(saveStatusKey[state.status])}</StatusText>{/* 아래 공통 절의 제품 helper */}
+          <StatusText>{t(saveStatusKey[state.status])}</StatusText>{/* 공개 Text companion */}
           {state.value ? <Text>{t("save.savedValue", { value: state.value })}</Text> : null}
         </Stack>
       </Container>
@@ -190,31 +191,20 @@ function SaveNote({ save }: { save(value: string): Promise<string> }) {
   화면보다 오래 살아야 하면 제품의 작업 소유자(store)에 둔다. unmount 시 자동 reset은 기본으로 넣지 않는다.
 - 구독은 Web·Native 모두 `useSyncExternalStore(session.subscribe, session.getSnapshot, session.getSnapshot)`다. SSR은 요청별 세션을 만든다.
 - `reset(value)`는 세대를 바꿔 이전 응답과 재시도를 버린다. 서버 작업을 취소하지는 않는다.
-- 상태 문구 알림: Web은 `<Text role="status">`다. Native는 `Text`에 `accessibilityLiveRegion="polite"`(Android)를 주고,
-  iOS에서는 문구가 바뀌었고 비어 있지 않을 때만, 앱이 active일 때 `AccessibilityInfo.announceForAccessibilityWithOptions(message, { queue: true })`를 부른다.
-  스토리의 `PatternStatus`(`showcase/native/src/pattern-status.tsx`)는 공개 API가 아니므로 제품에서 같은 동작의 helper를 만든다.
-  나머지 Text prop은 `Omit<ComponentProps<typeof Text>, ...>`로 받아 그대로 넘긴다(optional prop을 `tone?: …`로 따로 받아 넘기면
-  `exactOptionalPropertyTypes`에서 TS2375가 난다).
+- 짧은 상태 문구는 공개 [StatusText](../components/text.md#statustext)를 쓴다. 문구와 실제 저장 결과는 제품이 소유하고,
+  Web live region·Native iOS 알림과 Android live region은 컴포넌트가 연결한다.
+- 계속 표시되는 최초 안내는 iOS에서 알리지 않는다. 행동 결과를 조건부로 새로 마운트하면 Native의
+  `announceOnMount`를 명시한다. 빈 문구·같은 문구 재렌더·배경 변경은 iOS에서 발표하지 않으며 복귀 때 재생하지 않는다.
+- Web은 동일 live node의 문구를 갱신한다. 조건부 마운트의 실제 낭독은 브라우저·보조기술에 따라 달라진다.
+  제목·설명·재시도 행동을 묶으면 Notice, 화면 위 일시 알림은 Toast를 고른다.
 
 ```tsx
 // Native
-import { useEffect, useRef, type ComponentProps } from "react";
-import { AccessibilityInfo, AppState, Platform } from "react-native";
-import { Text } from "@hjmds/react-native/primitives";
-
-type StatusTextProps = Omit<ComponentProps<typeof Text>, "children" | "accessibilityLiveRegion"> & { children: string };
-
-function StatusText({ children, ...props }: StatusTextProps) {
-  const previous = useRef(children); // 첫 렌더는 알리지 않는다
-  useEffect(() => {
-    const changed = previous.current !== children;
-    previous.current = children;
-    if (changed && children.trim() && Platform.OS === "ios" && AppState.currentState === "active") {
-      AccessibilityInfo.announceForAccessibilityWithOptions(children, { queue: true });
-    }
-  }, [children]);
-  return <Text {...props} accessibilityLiveRegion="polite">{children}</Text>;
-}
+import { StatusText } from "@hjmds/react-native/status-text";
+// Web: import { StatusText } from "@hjmds/react/status-text";
+
+<StatusText>{t(saveStatusKey[state.status])}</StatusText>
+{saved ? <StatusText announceOnMount>{t("save.complete")}</StatusText> : null} // Native
 ```
 
 ## 플랫폼 차이
@@ -233,3 +223,9 @@ function StatusText({ children, ...props }: StatusTextProps) {
 - 렌더 중 `createActionSession`을 부르면 매 렌더 새 세션이 생겨 중복 차단이 사라진다.
 - 구획 제목은 Heading으로 표시한다. 이전 Text heading 예제는 2026-10-06 제목 의미 구조를 맞추면서 수정했다.
 - 재시도는 secondary로 두어 저장과 경쟁하는 primary를 만들지 않는다(2026-10-06 예제 반영).
+
+### 재시도 뒤 초점과 결과 구분
+
+Web 예제는 재시도 버튼이 pending에서 사라지기 전에 저장 행동으로 초점을 옮긴다. 현재 입력이 비어 저장이 비활성화됐으면 입력칸으로 이동한다. 완료 시에는 추가 초점 이동을 하지 않아 사용자가 그동안 선택한 입력이나 다른 행동을 보존한다.
+
+재시도는 실패한 제출 snapshot을 다시 실행하며, 새로 입력한 초안은 주 저장 행동으로 제출한다. 성공한 snapshot과 현재 초안이 다르면 현재 입력이 아직 저장되지 않았다고 별도로 안내한다. 확정 값으로 편집 중인 초안을 덮어쓰지 않는다.

package/docs/usage/compositions/action-recovery-undo.md

@@ -138,6 +138,7 @@ function ArchiveItem({ id, name, api }: { id: string; name: string; api: Archive
 
 ```tsx
 // Native
+import { StatusText } from "@hjmds/react-native/status-text";
 import { useState, useSyncExternalStore } from "react";
 import { ScrollView, useWindowDimensions } from "react-native";
 import { createActionSession, type ActionSnapshot } from "@hjmds/design-contracts/action-session";
@@ -177,7 +178,7 @@ function ArchiveItem({ id, name, api }: { id: string; name: string; api: Archive
 }
 ```
 
-`api.archive`·`api.unarchive`(서버가 확정한 boolean을 돌려줌)와 `StatusText`는 제품 소유다([공통 절](action-recovery-save.md#공통-세션과-상태-알림)의 helper).
+`api.archive`·`api.unarchive`(서버가 확정한 boolean을 돌려줌)는 제품 소유다. `StatusText`는 [공개 Text companion](../components/text.md#statustext)이다.
 
 ## 플랫폼 차이
 
@@ -191,3 +192,7 @@ function ArchiveItem({ id, name, api }: { id: string; name: string; api: Archive
 
 - 구획 제목은 Heading으로 표시한다. 이전 Text heading 예제는 2026-10-06 제목 의미 구조를 맞추면서 수정했다.
 - 재시도는 secondary로 두어 저장과 경쟁하는 primary를 만들지 않는다(2026-10-06 예제 반영).
+
+### 재시도 뒤 초점과 결과 구분
+
+Web 예제는 사라질 재시도 버튼에서 기존 보관/실행 취소 행동으로 초점을 옮긴다. 해당 버튼은 pending에도 같은 노드로 남아 완료 후 다음 행동으로 이어진다. 역연산이 실패하면 마지막으로 확정된 보관 상태를 유지하고, 성공한 때에만 목록으로 돌아간다.