@hjmds/design-contracts 1.7.0 → 1.8.0

package/docs/stable-core.md

@@ -1,5 +1,77 @@
 # Stable Core
 
+## 2026-09-29 컴포넌트 승격 (다음 minor)
+
+`Divider`, `Section`, `ListRow`, `Statistic`, `DescriptionList`, `EmptyState`, `Result`, `Layout`, `Splitter`, `Accordion`, `Agreement`, `FilePicker`, `Tabs`, `BottomNavigation`, `LoadMore`, `Mentions`,
+`Heading`, `Top`, `BottomCTA`, `AspectRatio`, `Grid`, `Steps`, `TopBar`, `AuthScreenLayout`, `Radio`,
+`Avatar`, `Asset`, `CounterBadge`, `Image`, `VisuallyHidden`, `List`, `Timeline`, `BottomInfo`, `Link`, `AuthProviderButton`, `PasswordField`, `CheckboxGroup`, `RadioGroup`, `Chip`, `SegmentedControl`, `SearchField`, `NumberField`, `Toast`, `FloatingActionButton`, `Checkbox`, `Switch`, `ToggleGroup`, `Slider`, `OtpField`, `TagsInput`, `DatePicker`, `DateRangePicker`, `Breadcrumb`, `Pagination`, `Menubar`, `Form`, `Sidebar(Web)`, `TransferList`, `UploadItem`, `ContextMenu(Web)`, `Menu`, `Anchor(Web)`, `Collapsible`, `DataTable(Web)`, `Tree(Web)`, `Calendar`, `Carousel`, `Tour(Web)`, `ThinkingOrb`, `Dialog`, `AlertDialog`, `Sheet`, `SidePanel(Web)`, `Popover(Web)`, `Tooltip(Web)`, `CommandPalette(Web)`, `SkipNav(Web)`을 각 지원 surface에서 stable로 승격합니다.
+TextFormat, Splitter, Breadcrumb, Pagination, Menubar, Sidebar와 Web 전용 overlay/navigation 컴포넌트는 Web-only stable입니다. DateRangePicker, Accordion, Agreement, FilePicker, Tabs, BottomNavigation, LoadMore, Mentions, Form, TransferList, UploadItem, Menu, Collapsible, Calendar, Carousel, Dialog, AlertDialog, Sheet는 Web·Native stable입니다. ThinkingOrb도 Web·Native stable입니다. 현재 계약 stable은 100개, Web stable은 100개, Native stable은 83개입니다.
+
+## 2026-09-29 Beta → Stable 확인
+
+- TransferList와 UploadItem은 두 renderer의 Web keyboard·Native host action 및 긴 문구 증거를 연결했습니다. TransferList의 narrow panel 라벨은 flex item intrinsic minimum을 초기화해 wrap되도록 고쳤습니다. UploadItem의 실제 transfer/network lifecycle은 소비 제품 소유라 maturity gate가 아닙니다.
+- ContextMenu, Menu, Anchor, Collapsible, DataTable, Tree, Calendar는 각 surface에 적용되는 interaction과 긴 문구를 component-owned test로 확인했습니다. Unsupported surface는 계속 unsupported입니다.
+- Carousel, Tour, Dialog, AlertDialog, Sheet, SidePanel, Popover, Tooltip, CommandPalette, SkipNav는 keyboard/focus/action과 좁은 viewport·긴 localized copy를 전용 renderer test로 확인했습니다. Native 증거는 host action simulation이며 실제 OS screen-reader claim이 아닙니다.
+- Form Native는 `firstInvalidFieldRef`가 가리킨 제품 선택 입력으로 focus와 accessibility focus를 옮기고 제출 callback을 막는 경로를 추가했습니다. 제품은 validation·필드 순서를 계속 소유합니다.
+- ThinkingOrb Web 전용 matrix는 dark, 200% text, RTL, reduced motion, accessibility semantics를 확인합니다. Native도 환경 matrix와 설치한 iOS·Android Skia smoke를 통과했습니다([검증 기록](thinking-orb.md)).
+- 새 stable surface는 생성된 renderer evidence와 canonical `pnpm ci:check`가 통과해야 완료로 기록합니다. 제품 채택·배포·실기기 보조기기 QA는 소비자 릴리스에서 별도로 검증합니다.
+
+- TextFormat은 `<kbd>`, `<code>`, `<blockquote>` 의미를 Web에서 제공하고 Native는 unsupported입니다.
+  실제 긴 코드를 `<code>` slot에 넣는 Chromium matrix proof를 새로 연결했습니다.
+- AspectRatio는 Web Chromium과 Native renderer matrix에서 비율 컨테이너 안의 긴 자식 콘텐츠를 검증했습니다.
+  미디어 의미와 crop은 계속 제품이 소유합니다.
+- Grid는 Web Chromium과 Native renderer matrix에서 셀 안의 긴 텍스트 줄바꿈을 검증했습니다.
+- Steps는 계약이 요구하는 두 단계 이상 흐름에서 긴 단계 label을 Web Chromium과 Native matrix로 검증했습니다.
+- TopBar Native compact title의 잘림을 제거해 `screen-chrome.md`의 줄바꿈 계약에 맞췄고, 긴 제목 matrix를 통과했습니다.
+- AuthScreenLayout은 제품 소유 긴 제목을 hero slot에 넣어 Web Chromium과 Native matrix에서 검증했습니다.
+- Radio는 긴 option label이 좁은 Web 열을 넓히지 않도록 선택 label의 최대 폭을 제한하고 Web/Native matrix에서 확인했습니다.
+- List는 행 title에 긴 문구를 넣어 Web Chromium과 Native renderer matrix에서 줄바꿈을 확인했습니다.
+- Timeline은 실제 이벤트 label의 긴 문구를 Web Chromium과 Native matrix에서 검증했습니다.
+- BottomInfo는 제품 소유 안내 문구를 길게 넣어 Web Chromium과 Native matrix에서 줄바꿈을 확인했습니다.
+- Link는 browser의 anchor Enter 활성화와 Native router host action을 각각 별도 interaction proof로 연결했습니다.
+- AuthProviderButton은 Web Enter/Space와 Native host press에서 제품 소유 동작 호출을 확인했습니다.
+- PasswordField는 Web Enter/Space로 값은 보존한 채 표시 상태가 바뀌고, Native host press도 같은 상태 전이를 일으키는지 검증했습니다.
+- CheckboxGroup은 Web Space와 Native host press에서 선택 집합이 바뀌는 것을 각각 확인했습니다.
+- RadioGroup은 Web Space와 Native host press에서 선택 옵션이 바뀌는 것을 각각 확인했습니다.
+- Chip은 Web Space와 Native host press에서 선택 상태가 바뀌는 것을 각각 확인했습니다.
+- SegmentedControl은 Web 화살표 키와 Native host press에서 선택값 전이를 확인했습니다.
+- SearchField는 label 긴 문구 줄바꿈과 Web typing/clear, Native input/clear action을 검증했습니다.
+- NumberField는 긴 label, Web ArrowUp, Native adjustable increment를 확인했습니다.
+- Toast는 Web Enter 닫기와 Escape 해제, Native 접근성 닫기 action을 별도 회귀로 검증했습니다. Liquid presentation은 선택형 adapter로 stable을 상속하지 않습니다.
+- FloatingActionButton은 Web/Native 긴 이름 렌더와 Web Enter·Native host press 활성화를 회귀로 확인했습니다. 기존 scroll 방향·focus 유지·safe-area 검증도 유지합니다.
+- Checkbox는 Web/Native 긴 label과 Web Space·Native host press에서 선택값 전이를 확인했습니다.
+- Switch는 Web/Native 긴 label과 Web Space·Native host press에서 checked 전이를 확인했습니다.
+- ToggleGroup은 Web/Native 긴 option label과 Web Space·Native host press에서 pressed-id 집합 전이를 확인했습니다.
+- Slider는 Web/Native 긴 label, Web ArrowRight, Native adjustable increment를 검증했습니다.
+- OtpField는 양 renderer의 긴 label과 키보드 입력·숫자 정리 동작을 검증했습니다. 인증 절차 전체는 제품 소유로 남습니다.
+- TagsInput은 Web Enter 확정과 Native Return 확정·이름 있는 삭제 action을 각각 검증했습니다. Native blur는 초안을 확정하지 않으며, Web 후보 키 탐색과 2단계 Backspace 동작은 Native parity로 주장하지 않습니다.
+- Select는 긴 field label과 Web ArrowDown/Enter 선택, Native option host action을 확인했습니다. Native 선택은 실제 OS dialog 시각·접근성 검증을 포함하지 않습니다.
+- Combobox는 긴 label과 Web 입력·ArrowDown/Enter 선택, Native 후보 host action 후 sheet dismissal commit을 검증했습니다. 실제 IME와 OS sheet·스크린 리더 동작은 기기에서 확인하지 않았습니다.
+- Layout은 두 renderer의 긴 본문·접근성·환경 matrix와 Web skip-link Tab/Enter를 검증했습니다. Native에는 skip-link나 host action 계약이 없어 keyboard proof를 요구하지 않습니다. 제품 shell의 스크린 리더·실기기 확인은 제품 릴리스 QA 범위입니다.
+- Splitter는 Web long-copy·접근성·환경 matrix와 실제 Tab focus 뒤 focused separator에서의 ArrowRight 조절을 검증했습니다. 기존 회귀는 drag/keyboard 동일 step grid·Home/End·RTL·disabled·44px hit target을 검사합니다. 제품 화면과 스크린 리더 실측은 보증하지 않습니다.
+- DatePicker는 양 renderer의 긴 label·접근성·환경 matrix, Web의 trigger Tab/Enter와 날짜 ArrowRight/Enter 선택·닫힘·focus 복귀, Native 날짜 선택 host action을 검증했습니다. 제품 폼 및 실제 OS 스크린 리더 검증은 소비 앱 QA입니다.
+- Breadcrumb는 긴 label matrix와 Tab/Shift+Tab·Enter 조상 링크 이동, 현재 위치의 non-interactive `aria-current` 동작을 Web에서 확인했습니다. Pagination은 Tab focus 순서, Space/Enter 페이지 전환, 현재 페이지 발표, 양쪽 경계의 focus 유지와 중복 전환 차단을 Web에서 검증했습니다. Pagination은 소비자 문장을 표시하지 않으므로 long-copy 요구를 제외했고, 숫자 폭은 320px·200%·RTL 테스트에 남겼습니다.
+- Accordion은 Web Tab/Enter 확장·축소와 Native 이름 있는 press action의 expanded 상태를 검증했습니다. Agreement는 양쪽 표면에서 개별/전체 동의와 전문 보기 분리를 확인했고, FilePicker는 Web 키보드 trigger와 선택 결과 및 Native 제품 adapter action·공통 선택 판정을 검증했습니다. FilePicker OS 피커 연결과 법적 문구·동의 기록은 소비 앱 소유입니다.
+- Tabs는 disabled skip, manual selection, 긴 이름의 실제 keyboard focus/activation을 검증했습니다. Chromium에서 overflow strip 안 긴 탭이 키보드 포커스 뒤 보이지 않는 문제를 고쳐 `scrollIntoView`를 연결하고 reduced motion일 때 즉시 이동을 확인했습니다. Native `activate` action도 확인했습니다. BottomNavigation은 Web Tab/Enter와 Native navigate/reselect action이 선택 상태를 외부 navigator에 남기는지, LoadMore는 observer/onEndReached gate·수동 retry·긴 상태 문구를 확인했습니다.
+- Mentions는 Web/Native long-label matrix, Web Arrow/Enter/Escape/pointer 흐름, Native caret query callback과 이름 있는 후보 press action을 검증했습니다. Native callback은 parent state update를 render 중 실행하지 않습니다. Candidate filtering과 실제 IME device QA는 제품 소유입니다.
+- Sidebar는 Web에서 disabled 항목을 건너뛰는 실제 Tab 순서, Enter로 접기, 접힌 상태의 접근성 이름, 긴 그룹·항목 라벨 줄바꿈을 Chromium으로 검증했습니다. 모바일 목적지는 기존 BottomNavigation 계약을 사용합니다.
+- Avatar는 이름을 visible 문장으로 렌더하지 않고 initials/media로 나타내며, Asset과 Image는 visible media와 alt accessibility semantics를 제공합니다.
+  CounterBadge는 숫자/dot만, VisuallyHidden은 의도적으로 숨긴 accessibility text만 내므로 long-copy overflow는 이들의 계약을 시험하지 않습니다.
+  이를 확인해 required scenario를 제외하고 기본·접근성·fallback proof를 유지했습니다. 기존 Icon·Skeleton 등 예외에 이 다섯 이름을 추가했습니다.
+- 처음 7개는 변경 전에도 양쪽 renderer의 필수 시나리오 누락이 0이었습니다. 제품 채택 수만으로
+  보류했던 조건을 [승격 기준](stable-promotion.md)에서 제거했습니다.
+- Heading/Top은 행동이 없는 계약에 붙은 keyboard 요구만, BottomCTA는 중복 parity 요구만
+  남아 있었습니다. TopBar는 Native 긴 제목 잘림을 고친 뒤 세 surface를 모두 승격합니다.
+- Web은 `test/scenario-matrix.browser.test.tsx`, Native는 `test/scenario-matrix.test.tsx`의
+  default/접근성/환경 증거와 기존 컴포넌트 회귀를 사용합니다. Native 검사는 renderer mock이며
+  기기·VoiceOver/TalkBack 실측을 주장하지 않습니다.
+- 검증 명령은 canonical `pnpm ci:check`입니다. 실행 결과는
+  [이번 변경 기록](../../../docs/plans/beta-to-stable.md)에 남깁니다.
+- 실제 제품 수·제품 배포 여부는 승격 조건이 아닙니다. 선택형 AnimatedStatistic·Liquid Toast·
+  기타 확장은 기본 컴포넌트의 stable 상태를 상속하지 않습니다.
+
+아래 절은 각 릴리스 당시 기록입니다. 현재 조건은 위 승격 기준을 따릅니다.
+
 ## 1.5.0 승격
 
 다음 13개를 stable로 올렸습니다: `Text`, `Icon`, `Stack`, `Container`, `DesignSystemProvider`,

package/docs/stable-promotion.md

@@ -1,51 +1,55 @@
-# stable 승격 절차
+# Stable 승격 기준
 
-2026-09-18 기준 `stable`은 네 개다: Surface, Button, Field, TextArea. 나머지 90여 개
-Web renderer는 `beta`이고, 그 뜻은 **"renderer는 있고 제품 실측은 없다"**이다. 커버리지
-감사가 "컴포넌트 수가 아니라 이 숫자가 배포 준비를 막는다"고 지적한 자리다.
+검토일: 2026-09-29. 이 문서가 성숙도 승격 조건의 원문입니다.
 
-이 문서는 그 숫자를 움직이는 **조건과 순서**만 정한다. 승격 자체는 증거가 모인 뒤에 한다.
+`stable`은 공개 API와 동작을 SemVer로 지원한다는 약속입니다. 변경을 영구히 금지하거나
+모든 제품·OS에서 검증을 마쳤다는 뜻은 아닙니다. `beta`는 API·동작 또는 renderer 검증에
+구체적인 미완료 항목이 있다는 뜻입니다. 채택 제품 수나 사용 기간으로 구분하지 않습니다.
 
-## 왜 자동으로 올리지 않는가
+## 컴포넌트 승격에 필요한 것
 
-`beta → stable`은 "이 API를 바꾸지 않겠다"는 약속이다. 테스트가 초록이라는 것은 우리가
-작성한 시나리오를 통과했다는 뜻이지, 실제 사용자가 그 화면을 통과했다는 뜻이 아니다.
-정적 검사로 승격하면 그 약속의 근거가 우리 자신의 테스트뿐이게 된다.
+1. 공개 타입·기본값·지원 동작이 문서와 일치하고, 알려진 계약 공백이 없어야 합니다.
+2. 승격할 surface의 실제 renderer에 default·접근성·적용되는 환경/행동 회귀 증거가 있어야
+   합니다. 필수 목록은 `showcaseManifest`이며 canonical `pnpm ci:check`를 통과해야 합니다.
+   문서 등록, story 존재 또는 mock 실행을 실제 기기 검증으로 바꿔 부르지 않습니다.
+3. catalog와 생성물, Changeset에 승격 범위를 함께 반영합니다. 기록은
+   [Stable Core](stable-core.md)에 대상·검사·남은 제한을 간단히 남깁니다.
 
-## 승격 조건 (네 가지 전부)
+별도 승격 전용 JSON, 승인 단계, 소비 앱 배포 영수증을 추가하지 않습니다.
+Web과 Native는 `surfaceStatus`로 각각 판정합니다. Web-only의 승격에 Native 구현은 필요
+없습니다. 공유 contract의 승격과 각 renderer의 상태도 구분하고, 미구현 surface를 함께
+stable로 올리지 않습니다. 선택형 모션·네이티브 확장은 기본 컴포넌트의 상태를 상속하지 않습니다.
 
-1. **제품 채택** — 등록된 제품 최소 한 곳의 실제 화면에서 쓰이고, 그 화면이 배포돼 있다.
-   Showcase 사용은 채택이 아니다.
-2. **우회 없음** — 그 제품이 이 컴포넌트를 `.hjm-*` CSS로 덮거나 recipe 값을 다시 읽어
-   인라인 style로 싣고 있지 않다. 우회가 있으면 그것이 곧 API 공백이고, 공백이 있는 API를
-   고정하면 안 된다.
-3. **보조기기 실측** — 해당 표면에서 한 번 이상 실제 확인. Web은 화면 리더 1종 + 키보드
-   전용 통과, Native는 VoiceOver 또는 TalkBack 통과. 기록은 제품 저장소에 남긴다.
-4. **환경 4종** — dark, RTL, 2배 글자, reduced motion에서 그 **제품 화면**이 깨지지 않는다.
-   (renderer evidence의 시나리오와 별개다. 그쪽은 우리 스토리, 이쪽은 실제 화면이다.)
+## 별도로 확인할 것
 
-## 첫 후보 (다음 minor 게시 이후)
-
-BurnTok·Diairy가 실제로 소비 중이고 우회가 남아 있지 않은 것부터 본다.
-
-| 후보 | 채택처 | 남은 확인 |
+| 항목 | 소유 범위 | 성숙도와의 관계 |
 | --- | --- | --- |
-| ListRow | BurnTok, Diairy, Taground | 우회 제거 후 재확인, 보조기기 |
-| Dialog | BurnTok(AppModal) | `onDismissComplete` 소비 후 0ms 타이머 제거 |
-| Sheet | BurnTok(AppSheet) | 같음 |
-| Toast | BurnTok | DS-01 우회 제거 |
-| Notice | Diairy | DS-11 우회 제거 |
-| Tabs | BurnTok | compact 우회가 제품 선택인지 API 공백인지 판정 |
-| TextField | BurnTok, Diairy | 설명·오류 동시 표시 변경 반영 확인 |
-| Select · Checkbox · Switch | 3개 제품 | 보조기기 |
-
-**순서**: minor 게시 → 소비 앱 dependency·lock 갱신 → 우회 제거 → 보조기기·환경 확인 →
-증거를 제품 저장소에 기록 → 이 표를 근거로 승격 PR.
-
-## 승격하지 않는 것
-
-- 제품이 아직 쓰지 않는 컴포넌트(이번에 추가한 Sidebar·TagsInput·Agreement 등). renderer가
-  있다는 것과 안심하고 쓸 수 있다는 것은 다른 말이다.
-- Native가 `planned`인 채로 Web만 성숙한 항목의 **contract status**. `status`는 계약
-  성숙도이고 표면별 성숙도는 `surfaceStatus`가 따로 갖는다 — 한쪽 표면만으로 계약을
-  stable로 올리면 다른 표면이 조용히 약속에 포함된다.
+| 제품 채택 수·사용 기간·배포 이력 | 채택 관측 | 우선순위와 개선 신호. 승격 최소치 없음 |
+| 제품 화면의 키보드·스크린 리더·기기 QA | 소비 앱 릴리스 | 바뀐 흐름과 플랫폼 위험에 맞춰 실행 |
+| HJM renderer 키 동작 / Native 접근성 action | Web `keyboard` / Native `native-actions` 증거 | 각 surface behavior contract에 실제 선언된 입력 방식만 요구 |
+| 제품 화면의 dark·RTL·200%·reduced motion | 소비 앱 릴리스 | 제품이 지원하는 환경 검증. HJM 테스트와 중복 영수증을 요구하지 않음 |
+| Web/Native 의미 일치 | 공통 계약과 관련 행동 회귀 | `adaptive` 전체에 별도 parity 테스트를 일괄 강제하지 않음 |
+| 제품의 style 우회 | API 공백 또는 제품 이관 | HJM API 공백이면 해결. 단순 제품 이관 지연은 승격 조건 아님 |
+
+컴포넌트의 접근성·환경 검증은 계속 필요합니다. 제품의 임의 조합과 도메인 흐름까지 HJM
+성숙도 하나로 보증하려는 조건을 분리한 것입니다. 모달 focus/dismiss, 선택값 전이, 입력 복구
+같은 고유 행동의 검증은 생략하지 않습니다. 실제 OS에 의존하는 확장의 미검증 제한도 유지합니다.
+
+Web keyboard는 DOM focus와 문서화된 key binding을 browser renderer에서 확인합니다. Native
+behavior contract은 물리 키가 아니라 접근성 role·state·action을 선언하므로, `onPress`나
+TalkBack action 테스트를 keyboard 증거로 기록하지 않습니다. Native `native-actions`는 그
+host action과 상태 전이를 renderer test에서 확인하며 실제 키보드·VoiceOver·TalkBack 기기 QA는
+소비 앱 릴리스에서 수행합니다.
+
+## 변경 이유
+
+2026-09-29 감사에서 architecture는 ‘두 제품 또는 두 플랫폼’, 이 문서는 ‘한 제품 배포 +
+제품 화면 실측’, 과거 Stable Core 기록은 ‘세 제품’을 사용하고 있었습니다. 이미 양쪽 renderer
+필수 시나리오가 갖춰진 표시 컴포넌트 7개도 채택 수 때문에 beta에 머물렀습니다.
+제품 인기도와 릴리스 절차가 API 지원 약속을 가로막는 문제를 없애기 위해 조건을 통일했습니다.
+소비 Beta는 [소비 정책 §2](consumer-policy.md#2-성숙도별-채택)의 간단한 채택 기록으로 관리합니다.
+
+2026-09-29 후속 증거 감사에서는 Native 실행 레지스트리의 `keyboard` 증거가 실제 물리 키보드
+입력이 아니라 React Native host action 테스트에 연결된 것을 확인했습니다. Native 계약에 없는
+입력을 공통 keyboard gate로 강제하거나 터치 action을 키보드 검증이라고 부르지 않도록 surface별
+시나리오를 분리했습니다.

package/docs/tags-input.md

@@ -21,5 +21,8 @@
 
 **삭제는 위치 기준이다.** 중복을 허용한 제품에서 값 기준으로 지우면 엉뚱한 것이 사라진다.
 
-**Native.** 아직 renderer가 없다(catalog `planned`). 자유 입력 + 칩 목록은 키보드
-회피·IME와 함께 검증해야 해서 Web 먼저 낸다.
+**Native.** 현재 renderer는 `TextInput`의 Return으로 값을 확정하고 각 태그 옆의 이름
+있는 button action으로 삭제한다. 제안 목록이 있으면 후보도 button으로 고를 수 있다.
+초안은 포커스를 잃는 것만으로 확정하지 않는다. Web의 ArrowUp/Down 후보 탐색과 빈 입력
+Backspace의 2단계 삭제는 Web 키보드 계약이며 Native에서 같은 키 동작을 주장하지 않는다.
+Native 입력·Return·삭제는 renderer 회귀로 확인하고, IME와 OS별 키보드 동작은 기기 검증 범위다.

package/docs/theme-palette.md

@@ -62,3 +62,30 @@ contracts·tree-select까지 연쇄로 초과).
 `borderControl`은 `#6b7684`를 그대로 둔다. 비텍스트 기준(3:1)이고 `surface` 위 4.19:1로 충분하다.
 
 **버린 대안:** 검사에서 `textSub`를 본문 기준에서 빼기. 실제 글자에 쓰이는 색을 기준에서 빼면 검사가 존재 이유를 잃는다.
+
+## 입력과 선택 항목은 흰 내부와 상태 테두리로 구분한다 (2026-09-29)
+
+전수 기기 확인 중 사용자가 회색·푸른색 입력/선택 배경을 제거하고, "푸른 테두리는 쓰는데 input 안은 흰색"으로 요청했다.
+입력 프레임, 검색·OTP·숫자·날짜 입력, 선택 카드·Chip·SegmentedControl·ToggleGroup은 라이트의 `bg`(`#ffffff`)를 사용한다.
+다크에는 같은 역할의 `bg`를 사용해 밝은 사각형이 따로 뜨지 않도록 한다. 포커스/선택 테두리와 체크 표시는 기존 브랜드색을 유지한다.
+휴지 상태 입력 테두리는 글자색 `textMuted` 대신 전용 `borderControl`을 사용한다.
+
+공식 참조는 [Ant Design Input](https://ant.design/components/input/)의 outlined 변형(흰 active/hover 내부, 파란 active 테두리),
+[Radix Text Field](https://www.radix-ui.com/themes/docs/components/text-field)의 surface/soft 변형 분리,
+[Atlassian Border](https://atlassian.design/foundations/border)의 기본·선택·포커스 테두리 역할 분리다.
+Ant의 원시 색상이나 낮은 테두리 대비까지 복제하지 않고, HJM의 의미 토큰과 대비를 유지한다.
+포커스 링은 기존 2px 계약을 유지하며, 작은 체크·스위치 트랙·선택 날짜 표식과 주요 CTA는 넓은 입력 채움 배경과 구분한다.
+
+**버린 대안:** 선택을 넓은 불투명 브랜드색 판으로 표현하거나 소비 앱에서 흰색 CSS만 덮어쓰기.
+전자는 이번 사용자 방향과 맞지 않고 후자는 웹·네이티브 및 다크 테마에 서로 다른 표현을 남긴다.
+
+### 전체 중립 표면으로 확대
+
+같은 화면 검토에서 사용자가 입력뿐 아니라 회색·연한 파란색 배경 전체를 제거하되 Create draft의 진한 파란색은 유지하도록 명확히 했다.
+`Surface`·Card·메뉴·목록·아바타·Skeleton·보조 버튼도 canvas를 사용하며, 경계가 사라지는 곳은 테두리로 구분한다.
+`ButtonTone.primary`와 주요 CTA/FAB, 작은 체크·스위치·진행 표시, 성공·위험 상태색은 그대로 유지한다.
+원시 팔레트의 surface/primary 색 자체를 흰색으로 덮지 않고 컴포넌트 배경 역할만 바꿔, 글자·아이콘·진행선의 의미가 바뀌지 않게 한다.
+
+버튼의 배경색은 소비 화면에서 직접 지정하지 않고 `ButtonTone`의 `primary | secondary | ghost | danger | link`로 선택한다.
+웹과 네이티브는 같은 `buttonRecipe`의 배경·글자·테두리 역할을 해석한다. Create draft는 `primary`를 유지하므로
+일반 표면의 canvas 전환과 독립적으로 기존 브랜드 채움색을 보존한다.

package/docs/thinking-orb.md

@@ -0,0 +1,124 @@
+# ThinkingOrb — AI 작업 상태
+
+검토일: 2026-09-29. 원본: [Thinking Orbs](https://github.com/Jakubantalik/thinking-orbs/tree/de85557ca220332586d070d8788c0e1d6e877a0d), MIT.
+
+## 결정과 범위
+
+사용자가 Thinking Orbs의 HJM 흡수를 요청했다. catalog 동결의 이번 예외는 실제 AI 작업의
+검색·듣기·생성 상태를 표시하는 컴포넌트 하나다. 기존 Spinner를 대체하거나 장식용으로
+자동 순환시키지 않는다. upstream 패키지를 runtime dependency로 연결하는 대신 고정 커밋의
+기하 엔진·튜닝만 편입한다. 두 renderer가 같은 엔진을 사용하고 HJM의 테마·접근성·생명주기를
+유지해야 하기 때문이다. 원본 고지는 배포 패키지의 THIRD_PARTY_NOTICES.md에 포함한다.
+
+## API
+
+웹은 `@hjmds/react/thinking-orb`, Native는 `@hjmds/react-native/thinking-orb`.
+공통 계약은 `@hjmds/design-contracts/components/thinking-orb`로만 가져온다.
+선택형 코드가 일반 컴포넌트 번들에 들어가지 않도록 root barrel에서는 재수출하지 않는다.
+
+```tsx
+<ThinkingOrb state="searching" size={64} label={t('agent.searching')} active={screenVisible} />
+```
+
+- `state`: working, searching, solving, listening, connecting, weaving, composing, breathing, shaping.
+  실제 상태를 앱에서 전달한다. listening은 음성 크기에 반응하는 오디오 시각화가 아니다.
+- `size`: 20 또는 64. 원본의 점 수·반지름 튜닝을 유지하며 임의 CSS 확대는 지원하지 않는다.
+- `label`: 필수. 앱에서 번역한 현재 작업 설명. 완료·오류 때는 별도 결과 UI로 교체한다.
+- `speed`: 기본 1, 유한수 0 초과 4 이하. 무제한 속도는 읽기 어려운 모션을 만들므로 제한한다.
+- `paused`: 프레임 시간을 유지. 재개 시 숨겨진 시간만큼 건너뛰지 않는다.
+- `active`: 기본 true. Native의 탭/내비게이션/가상 목록에서 보이지 않을 때 false를 전달한다.
+  AppState만으로는 여전히 mounted인 숨긴 화면을 알아낼 수 없기 때문이다.
+
+HJM provider의 `text` 색을 깊이에 따른 opacity와 조합한다. 원본의 고정 grayscale 팔레트는
+브랜드 테마와 배경에서 어긋날 수 있어 사용하지 않는다. 기하 좌표는 원본과 동일하다.
+모션 줄이기에서는 elapsed 0.6초 프레임만 그린다. 긴 JS 정체 후 이동은 최대 64ms로 제한해
+순간적인 모션 점프를 줄인다. 상태 전환은 새 모양으로 즉시 바뀌며 morph 전환은 제공하지 않는다.
+웹은 role=status와 숨긴 텍스트, Native는 접근 가능한 progressbar host를 사용한다.
+Canvas는 접근성 트리에서 제외한다. 외부에 문구를 함께 표시할 때 중복 live region을 두지 않는다.
+
+## 호환성과 증거 경계
+
+웹: React 19 + Canvas 2D. IntersectionObserver, document visibility, provider reduced motion에 반응.
+Native: 선택형 Skia 2.6.2 + Reanimated 4.5.1 + Worklets 0.10.1, Expo 57/RN 0.86.2 조합을 검증 대상으로 한다.
+기본 renderer의 RN >=0.81 계약이 이 선택형 효과의 지원 범위를 보장하지 않는다.
+Skia Picture를 shared value로 전달해 매 프레임 React commit을 피하지만 기하 계산과 picture
+recording은 JS thread에서 실행한다. UI worklet 기반이라는 주장은 하지 않는다.
+
+원본 Native는 기기 미검증을 명시하지만, HJM은 아래 설치 smoke를 별도로 수행했다.
+HJM Native 승격 조건은 실제 설치 앱에서 Skia가 그려지는 기본 smoke를 iOS와 Android에서 확인하는 것이다. 이 gate는 선택형 네이티브 모듈과
+렌더러 연결을 확인한다. Metro bundle과 mock lifecycle 검사만으로 이 연결을 증명할 수 없기
+때문이다.
+Web 승격에는 showcase manifest의 dark·large-text·RTL·reduced-motion·accessibility 행렬을
+실제 browser renderer에서 확인해야 한다. 제품 채택 수와 제품 화면의 VoiceOver/TalkBack 확인은
+소비 앱 QA이며 HJM renderer 성숙도의 추가 gate가 아니다([stable-promotion.md](stable-promotion.md)).
+Native smoke는 각 OS에서 설치 앱의 대표 상태 한 가지를 light/dark theme으로 렌더링하고 label이
+포함된 progressbar host를 확인한다. 9개 상태·두 크기의 geometry와 host 접근성 속성은 Native
+renderer 테스트에서 확인하며 reduced-motion·navigation·background/resume lifecycle도 mock
+회귀 테스트에서 확인한다. 이 분리는 모든 조합의 실제 device 캡처와 장시간 메모리 stress를
+승격 gate로 요구했던 이전 안이 소비 앱 QA와 성능 보증까지 HJM maturity에 넣었기 때문이다.
+VoiceOver/TalkBack 사용성은 소비 앱에서 확인하고, 성능 stress는 실측 이슈나 성능 주장이 생길
+때 수행한다. Native는 아래 iOS·Android smoke와 renderer matrix 통과 후 stable로 승격했다.
+
+원본 golden fixture 72개는 engine 좌표·반지름·깊이·정렬을 비교한다. Canvas lifecycle 검사는
+정지/재개/viewport/테마를 확인한다. default renderer proof와 실측 모션/성능 증거는 구별한다.
+
+## 이번 checkout 검증 — 2026-09-29
+
+- 공통 계약 테스트 883개(원본 72개 golden 포함), Web SSR 172개, Web Chromium 773개,
+  Native mock 731개 통과. 공개 export 목록 갱신 후 실패했던 경계 검사를 재실행했다.
+  Native 기존 provider-theme 테스트는 병렬 부하에서 timeout 후 worker 2개로 전체 재실행해 통과했다.
+- Web showcase 테스트·token 검사·production build 통과. 112 canonical story 중 97 Web renderer.
+  실제 브라우저에서 AllStates의 9상태 × 20/64, light/dark 화면 확인.
+- Native showcase typecheck/test, 기본 Metro Android production fixture 통과. ThinkingOrb Native
+  mock renderer regression now covers all 9 states × 2 sizes × 2 themes and lifecycle; this is not
+  installed-app Skia runtime proof.
+  Expo 57 showcase의 iOS/Android Hermes export 성공. 이것은 native binary 설치/실행 증거가 아니다.
+- contract/renderer bundle 예산, workspace/evidence 동기화, 문서 링크, release governance,
+  중앙 library-policy 정적 검사 통과. 원격 CI·게시·소비 앱 적용은 실행하지 않았다.
+- 기존 Device Hub 프로세스와 부팅된 iPhone 18 Pro / iOS 27.0을 확인했지만,
+  `com.apple.dt.Devices` 화면 조회는 `timeoutReached`로 실패했다. 새 기기를 만들거나
+  부팅하지 않았으며 Native visual/performance/assistive-technology 증거는 미완료다.
+
+### 설치 smoke 전 자동 검증 — 2026-09-29
+
+Native renderer 테스트가 820개로 확장되어 ThinkingOrb의 9상태 × 두 크기 × 두 테마,
+접근 가능한 progressbar host와 숨긴 Canvas semantics, reduced-motion/navigation/background
+lifecycle을 확인한다. React Native typecheck와 canonical `pnpm ci:check`가 통과했다.
+이 검사는 mock renderer 범위다. iOS·Android 각각의 설치 앱에서 Skia가 실제로 그려지는 smoke는
+아직 실행하지 않아 Native surface는 planned로 유지한다.
+
+### 설치 앱 검증 및 Native 승격 — 2026-09-29
+
+- 기존 iPhone 17 시뮬레이터(iOS 27.0)와 Android emulator-5554(Android 16/API 36)에서
+  설치된 HJM showcase의 Skia 렌더링을 확인했다. 물리 기기 검증은 아니다.
+- 두 OS 모두 9상태 × 두 크기 light/dark 화면을 확인했다. 접근성 snapshot에서
+  `검색 중` label과 busy 상태를 확인했다. iOS는 UpdatesFrequently trait, Android는
+  focusable host를 노출한다. progressbar React Native prop은 renderer 테스트로 확인하며
+  OS snapshot의 GenericElement/View 표기를 별도 progressbar class로 과장하지 않는다.
+- Android background 후 Playground 복귀 화면도 확인했다. 5개 환경 scenario와 canonical
+  default-render proof를 추가했으며 관련 renderer 검사 88개가 통과했다.
+- iOS 최초 실행은 UIScene 누락으로 SIGTRAP 종료됐다. Expo ~57.0.25와 scene lifecycle
+  config plugin 적용 후 빌드(오류/경고 0), 설치, 실행, light/dark 전환이 성공했다.
+  개발 서버는 RCT_jsLocation=localhost:8084로 연결했다.
+- Device Hub 조회는 timeoutReached로 두 번 실패하여 같은 시뮬레이터에서 simctl 캡처와
+  idb 접근성 조회로 검증했다. 새 기기는 만들거나 부팅하지 않았다.
+- iOS는 ThinkingOrb 집중 profile로 unrelated menu adapters를 제외했다. 전체 optional
+  showcase의 RCT-Folly 충돌을 해결했다는 뜻은 아니다. VoiceOver/TalkBack 제품 QA,
+  장시간 성능 검증, 게시 및 소비 앱 적용은 이 smoke 범위 밖이다.
+
+[캡처와 접근성 증거](../../../docs/evidence/thinking-orb-2026-09-29/README.md),
+[재현 절차](../../../showcase/native/README.md),
+[호스트 수정 근거](../../../docs/LIBRARY_POLICY.md)를 함께 유지한다.
+
+### 설치 smoke 후 최종 검사 — 2026-09-29
+
+Contracts 885, React SSR 174 + Chromium 886, React Native 826, Web Showcase 19,
+Native Showcase 1: 기능 테스트 총 2,791개 통과. 승격 과정에서 Native evidence export 목록과
+Storybook registry 누락을 수정해 해당 검사를 다시 통과했다. Evidence 메타데이터는
+10.7 kB raw / 2.72 kB gzip으로 늘어 한 모듈 graph 유지 확인 후 예산만 갱신했다.
+`pnpm ci:check` 단일 실행은 기존 evidence budget에서 중단되었고, 수정 후 그 단계부터
+나머지 canonical 명령을 순서대로 재실행하여 모두 통과했다. 최종 전체 명령을 다시
+한 번 실행했다고 주장하지 않는다. Renderer/contract budgets, Android Metro fixture,
+workspace/evidence/docs/governance, 양쪽 showcase 검사, Web Storybook build 및
+112 canonical story inventory, 중앙 library-policy 정적 검사, `git diff --check` 통과.
+게시·소비 앱 갱신은 실행하지 않았다.

package/docs/timeline.md

@@ -141,6 +141,5 @@ Ant Design Timeline의 `mode="alternate"`(항목이 좌우로 번갈아 배치)
 `LiveScreen.tsx:797-821`의 PBP 플레이 기록이 실제로 존재하는 후보다 — "일어난 일,
 순서, 커서 없음"이라는 경계는 정확히 일치한다. 다만 지금은 `timelineRecipe`의 dot/
 connector 시각이 아니라 평평한 `AppListRow` 목록으로 그려져 있어, 시각 recipe 쪽
-vertical slice는 아직 없다. `planned → beta` 승격은 실제 제품 vertical slice 이후
-리드가 진행한다(로드맵 maturity gate). 구단 상세의 영입·유출 이력은 여전히 미확인
-후보로 남긴다.
+vertical slice는 이 조사에서 확인하지 못했다. 구단 상세의 영입·유출 이력도 미확인 후보였다.
+2026-09-29부터 제품 채택은 관측으로 분리하며 [현재 승격 기준](stable-promotion.md)을 따른다.

package/docs/toast.md

@@ -1,5 +1,11 @@
 # Toast contract
 
+Native의 선택형 `liquid` presentation은 같은 descriptor/store를 사용합니다.
+[사용 및 호환성](../../react-native/docs/liquid-toast.md),
+[설계·검증 경계](../../../docs/plans/liquid-toast.md)를 따릅니다.
+Web 또는 adapter 없는 Native는 같은 알림을 standard surface로 표시합니다.
+`presentation`·`occlusion`은 renderer가 소유하는 독립 pause reason입니다.
+
 Toast는 사용자가 응답해야만 진행되는 modal UI가 아니라, 무시해도 안전한 짧은 알림입니다.
 필수 선택·삭제 확인·시간 안에 응답해야 하는 작업은 `AlertDialog`를 사용합니다.
 

package/docs/tooltip.md

@@ -3,7 +3,8 @@
 `Tooltip`은 Web에서 이미 의미와 focus를 가진 interactive trigger에 짧은 보충 설명을
 제공합니다. 중요한 정보, 오류, 행동, link를 Tooltip 안에 숨기지 않으며 Native에 억지로
 동일한 hover UI를 만들지 않습니다. BurnTok Web renderer와 실제 알림 trigger에서 아래
-수명주기·RTL·접근성 계약을 검증했으므로 catalog는 `web / beta`입니다.
+수명주기·RTL·접근성 계약과 전용 keyboard·320px long-copy browser proof를 통과해 catalog는
+2026-09-29부터 `Web / stable`입니다. Native는 `unsupported`입니다.
 
 ## Public descriptor
 

package/docs/tour.md

@@ -130,10 +130,13 @@ Popover처럼 순수 판정 함수(`resolveTourAdvance`, `validateTourOpenState`
 | "다시 보지 않기" 영속화 | **배제** — 제품이 `TourCloseReason`을 받아 직접 저장할 몫 |
 | 비동기 busy/error 상태 | **배제** — Tour에는 되돌릴 수 없는 side effect가 없다. AlertDialog의 세션 패턴을 가져올 이유가 없다 |
 
-## Web renderer (2026-09-18)
+## Web renderer (promotion scope reviewed 2026-09-29)
 
-`@hjmds/react/tour`의 `Tour`가 이 계약을 실행한다. catalog는 Web `beta`,
-Native `unsupported`다. 제품 vertical slice와 보조기기 실측은 아직 없다.
+`@hjmds/react/tour`의 `Tour`가 이 계약을 실행한다. 정확한 승격 범위는 Web
+renderer이며 Native는 계속 `unsupported`다. Web renderer 증거는 stable 승격에
+준비됐다. 전용 Chromium proof가 긴 번역 copy와 키보드 단계 진행·anchor 이동을
+확인하며, 테스트를 중앙 evidence 및 실행 시나리오에 등록했다. 생성 evidence와 canonical
+`pnpm ci:check`가 모두 통과한 뒤 catalog에 반영한다.
 
 - **anchor는 끝까지 제품 소유다.** props는 노드가 아니라
   `resolveAnchor(anchorId)`를 받는다. renderer는 단계가 바뀔 때마다, 그리고 스크롤·
@@ -147,11 +150,14 @@ Native `unsupported`다. 제품 vertical slice와 보조기기 실측은 아직
   포인터가 둘러보기를 끝내지 못한다. Escape와 건너뛰기는 어느 단계에서나 나간다.
 - **unmount는 `interrupted`로 한 번만 정산한다.** StrictMode의 probe cleanup과 실제
   unmount를 epoch로 구분한다(Sheet와 같은 방식).
-- 로컬 검증: `test/tour.browser.test.tsx` 6개(이름·안내·단계마다 초점 이동, 배경 inert와
-  바깥 pointer 무시, 첫 단계 이전은 no-op·마지막 다음은 complete, Escape·건너뛰기 탈출,
-  unmount의 1회 interrupted, controlled owner 종료와 320px 배치)와 `Patterns/Tour`.
+- 로컬 검증: `test/tour.browser.test.tsx` 7개(이름·안내·단계마다 초점 이동과 키보드
+  다음 단계에 맞춘 anchor 하이라이트, 배경 inert와 바깥 pointer 무시, 첫 단계 이전은
+  no-op·마지막 다음은 complete, Escape·건너뛰기 탈출, unmount의 1회 interrupted,
+  controlled owner 종료와 320px 배치, 긴 번역 copy 내부 스크롤·키보드 건너뛰기·호출자
+  focus 복귀)와 `Patterns/Tour`.
 
 ## 검증 화면
 
-제품 vertical slice는 아직 없다. 유력 후보는 Yajalal 홈 화면 첫 진입
-안내(검색 → 즐겨찾기 → 알림)이며, 채택 전까지 `beta`는 renderer 수준 증거만 뜻한다.
+제품 화면 통합과 실제 OS 스크린 리더·보조기기 확인은 소비 앱 릴리스 QA에서 수행한다.
+이는 [Stable 승격 기준](stable-promotion.md)의 consumer QA 범위이며 HJM Web renderer
+승격 조건이 아니다. 제품별 앵커 선택과 안내 문구 품질도 제품 소유 계약으로 남는다.

package/docs/transfer-list.md

@@ -91,24 +91,27 @@ Native의 "터치 전용"에도 같게 적용되므로, 버튼이 항상 스와
 
 ## 검증 화면
 
-아직 없음. `planned → beta` 승격은 실제 제품 vertical slice 이후 리드가 진행한다.
-
-## Web renderer (2026-09-18)
-
-`@hjmds/react/transfer-list`의 `TransferList`가 이 계약을 실행한다. catalog는 Web `beta`,
-Native `planned`다 — Native renderer는 아직 없다.
-
-- **이동은 키보드만으로 끝난다.** Space로 고르고 이동 버튼을 누르거나, 초점이 있는 행에서
-  Enter로 그 행 하나만 바로 옮긴다. 후자는 계약의 "단일 이동에 다중 선택을 먼저 만들게
-  하지 않는다"는 항목이다.
-- **이동 후 초점은 계약이 정한다.** `resolveTransferListFocusAfterMove`가 미끄러져 들어온
-  행을 돌려주고, 패널이 비면 빈 상태 문구(`tabIndex=-1`)로 보낸다. 문서 body로 초점이
-  풀리는 경우가 없다.
-- **옮긴 항목은 도착 패널에서 선택되지 않는다.** 이동은 값을 확정하는 것이지 사용자가 하지
-  않은 새 선택을 만드는 것이 아니다.
-- **모두 선택은 disabled를 분모에서 뺀다.** 분자·분모 모두에서 빠지므로 잠긴 행이 있어도
-  "모두 선택"이 mixed로 굳지 않는다.
-- **문장은 제품이 만든다.** `onMove`는 옮긴 id를 원래 패널 순서로만 넘긴다.
-- 로컬 검증: `test/transfer-list.browser.test.tsx` 5개(키보드 다중 이동과 id 보고, 단일
-  행 즉시 이동, 이동 후 초점과 빈 상태 초점, disabled 제외와 이동 금지, 되돌리기와 패널당
-  tab stop 하나)와 `Patterns/TransferList`.
+이 조사 당시 제품 채택은 미확인이었다. 2026-09-29부터 제품 채택은 관측으로 분리하며,
+현재 성숙도는 catalog와 [승격 기준](stable-promotion.md)을 따른다.
+
+## Renderer notes (2026-09-29)
+
+Web and Native both implement TransferList. These renderer notes describe source-level behavior;
+they do not claim installed-device, VoiceOver, or TalkBack validation.
+
+- **Web keyboard interaction:** Space toggles the focused row and the shared move button commits
+  a selection; Enter moves one focused row directly. ArrowUp/ArrowDown/Home/End change the roving
+  row focus. After a move, focus goes to the row that slides into the vacated position or to the
+  empty-state message, so it does not fall to the document body. See
+  `packages/react/test/transfer-list.browser.test.tsx`.
+- **Native host interaction:** each panel's `ScrollView` is exposed as a named list and each row is
+  an individually labelled checkbox. Selecting a row and activating the shared move button moves
+  it without relying on a swipe gesture. React Native's host renderer proves the accessibility
+  props and handler wiring, not physical keyboard or screen-reader behavior. See
+  `packages/react-native/test/transfer-list-actions.test.tsx`.
+- **Long copy:** both renderers leave row copy untruncated. Web wraps at narrow viewport widths;
+  Native leaves font scaling enabled and does not set a line limit. The browser and host-renderer
+  tests verify those source-level constraints.
+- **Shared behavior:** moved rows are not preselected at the destination, disabled rows cannot be
+  selected or moved, and select-all excludes disabled rows from its denominator. `onMove` gives
+  the product moved ids in source-panel order so it can compose an announcement.

package/docs/tree-select.md

@@ -98,7 +98,8 @@ antd `TreeSelect`의 `checkStrictly`(부모/자식을 독립적으로 체크할
 
 ## 검증 화면
 
-아직 없음. `planned → beta` 승격은 실제 제품 vertical slice 이후 리드가 진행한다.
+이 조사 당시 제품 채택은 미확인이었다. 2026-09-29부터 제품 채택은 관측으로 분리하며,
+현재 성숙도는 catalog와 [승격 기준](stable-promotion.md)을 따른다.
 
 ## 조합으로 제공한다 (2026-09-18)
 

package/docs/tree.md

@@ -110,7 +110,8 @@ Carousel과 같은 이유로 어순·조사를 여기서 조립하지 않는다)
 
 ## 검증 화면
 
-아직 없음. `planned → beta` 승격은 실제 제품 vertical slice 이후 리드가 진행한다.
+이 조사 당시 제품 채택은 미확인이었다. 2026-09-29부터 제품 채택은 관측으로 분리하며,
+현재 성숙도는 catalog와 [승격 기준](stable-promotion.md)을 따른다.
 
 ## TreeSelect 판정
 
@@ -124,8 +125,9 @@ popup/sheet 표면에 얹으면 된다. 새 recipe나 새 상태 축이 필요
 
 ## Web renderer (2026-09-18)
 
-`@hjmds/react/tree`의 `Tree`가 이 계약을 실행한다. catalog는 Web `beta`,
-Native `unsupported`다. 제품 채택·보조기기 실측은 아직 없다.
+`@hjmds/react/tree`의 `Tree`가 이 계약을 실행한다. Web hierarchy·keyboard focus·selection과 긴
+label proof를 통과해 2026-09-29 stable로 승격한다. Native는 `unsupported`이며 제품 채택·보조기기
+실측은 소비 앱 release QA에서 별도로 확인한다.
 
 - **판정은 전부 계약이 한다.** 화살표(`getTreeArrowResult`), 상하·Home/End
   (`getVisibleTreeNavigationTarget`), 타이핑 검색(`getVisibleTreeTypeaheadMatch`),
@@ -138,7 +140,10 @@ Native `unsupported`다. 제품 채택·보조기기 실측은 아직 없다.
 - **tri-state 체크는 노드 자체에 실린다.** `checkedStates`(=`resolveTreeCheckedStates`
   결과)를 주면 행이 `aria-checked`로 true/false/mixed를 말한다. 체크박스를 행 안에 넣으면
   tab stop 규칙이 깨지므로 넣지 않았다.
-- 로컬 검증: `test/tree.browser.test.tsx` 6개(깊이·형제 위치 발표, 단일 tab stop과 roving,
-  펼침·접힘과 접힌 subtree 건너뛰기, RTL 화살표 반전, disabled의 선택만 차단·타이핑 검색,
-  tri-state 파생과 enabled leaf만의 cascade)와 `Patterns/Tree`.
-
+- 브라우저 검증: `test/tree.browser.test.tsx` 8개. 기존 여섯 동작(깊이·형제 위치 발표,
+  단일 tab stop과 roving, 펼침·접힘과 접힌 subtree 건너뛰기, RTL 화살표 반전,
+  disabled의 선택만 차단·타이핑 검색, tri-state 파생과 enabled leaf만의 cascade)에 더해,
+  포커스된 자식에서 부모로 돌아온 뒤 접어도 선택 상태와 포커스가 유지되는지, 320px 폭에서
+  긴 라벨이 줄바꿈되어 트리 바깥으로 넘치지 않는지를 실제 브라우저에서 확인한다.
+  긴 문구 케이스는 환경 행렬에 연결할 수 있도록 `default-render-fixtures.tsx`에도 등록했다.
+  이 테스트는 보조기기 실측이나 제품 채택 근거를 대신하지 않는다.

package/docs/upload-item.md

@@ -63,6 +63,10 @@
   `error`만 쓴다. `loadingMore`와 `empty`는 목록 페이지네이션 개념이라 한 파일의
   상태에는 적용되지 않는다.
 
-**검증 화면.** first-party Web·Native renderer와 cancel/retry 상태 테스트는 연결되어
-surface는 `beta`다. 실제 전송 lifecycle을 쓰는 제품 vertical slice는 아직 없으므로
-`stable` 승격 gate는 닫혀 있다.
+**검증 화면.** Web browser test는 긴 파일명·크기·상태 문구가 좁은 화면에서도 유지되고
+취소 버튼이 Tab/Enter로 동작하는지 확인한다. Native renderer test는 긴 문구, uploading의
+`busy` 상태, 취소·재시도 action을 확인하지만 하드웨어 키보드나 VoiceOver/TalkBack 동작을
+증명하지 않는다. HJM은 caller가 전달한 전송 상태를 표시하고 action을 전달한다. 서버 전송,
+실제 취소, 재시도 lifecycle 검증은 소비 제품이 소유하므로 이 vertical slice의 부재는 HJM
+renderer 승격을 막지 않는다. 2026-09-29 승격 기준 정리에서 adoption/deployment 조건을
+분리했고, renderer 계약과 실제 제품 흐름을 중복 요구하지 않기로 했다.