@hjmds/design-contracts 0.8.2

package/docs/upload-item.md

@@ -0,0 +1,68 @@
+# UploadItem contract
+
+**문제.** 사용자가 고른 파일 하나가 지금 어디쯤 있는지 보여준다 — 대기 중인지,
+전송 중이며 얼마나 갔는지, 끝났는지, 실패해서 무엇을 할 수 있는지. 어떤 파일을
+고를지는 [[file-picker]]의 몫이고, 업로드 요청·재시도 로직·서버 응답은 제품의
+몫이다. UploadItem은 그 상태를 화면에 어떻게 표현할지만 소유한다. antd `Upload`는
+[[file-picker]]와 이 컴포넌트로 decompose된다(`src/component-references.ts`).
+
+**일반화한 계약.**
+
+- 상태는 `pending | uploading | success | error` 네 값의 discriminated union이다.
+  `progress`(0..1 또는 불확정이면 `null`)는 `uploading`에만 있고, `message`는
+  `error`에만 있다 — 타입이 허용하지 않으니 "success인데 progress가 있다" 같은
+  조합이 애초에 만들어지지 않는다.
+- 취소/재시도 가능 여부를 별도 boolean으로 저장하지 않는다.
+  `getUploadItemAvailableAction(state)`가 `status`에서 매번 다시 계산해
+  `uploading`일 때만 `"cancel"`, `error`일 때만 `"retry"`를 돌려준다. 저장된 값이
+  상태와 따로 놀 수 있는 여지 자체를 없앤다 — `SheetOpenState`가 controlled/
+  uncontrolled 축을 섞지 않는 것, `LoadMoreState`가 `complete`에 `requestKey`를
+  아예 두지 않는 것과 같은 이유다.
+- `resolveUploadItemAnnouncement`가 `{ label, description }`을 돌려준다. `label`은
+  파일명으로 상태와 무관하게 고정하고([[statistic]]이 label/value/hint/trend를
+  독립된 접근성 이름으로 유지하는 것과 같은 원칙), `description`이 상태 문장을
+  맡는다 — 진행률 채움 막대 색만으로 상태를 말하지 않는다.
+- `progress`가 색으로만 말해지지 않도록 항상 낭독 가능한 문장을 만든다.
+  우선순위는 제품이 준 `progressLabel` → (숫자 진행률이면) 반올림 퍼센트 →
+  `labels.uploading` 정적 문구다. 퍼센트 자동 계산은 이 모듈에서 유일하게
+  "제품이 포맷한 문자열을 받는다"는 [[statistic]] 원칙과 다르게 판단한 자리다 —
+  Statistic의 값은 통화·단위처럼 로케일에 따라 표기가 갈리지만, `Math.round(x*100)
+  + "%"`는 로케일 중립적인 숫자와 기호뿐이라 Slider의 raw-value fallback과 같은
+  근거로 예외를 둔다. 그래도 제품이 `progressLabel`을 주면 항상 그것을 우선한다.
+- `validateUploadItemList`가 한 목록 안에서 stable id 중복을 거부한다 —
+  [[statistic]]의 `validateStatisticGroup`과 같은 이유로, 목록 재조정 시 행이
+  잘못된 항목과 뒤바뀌는 사고를 막는다.
+- 진행 표시는 이미 beta인 `progressRecipe`(`component-recipes.ts`)를 그대로
+  재사용한다 — `uploadItemRecipe.progress`는 새 막대를 만들지 않고
+  `progressRecipe.defaults.size`/`.tone`을 그대로 참조한다. 실패 상태의 막대
+  색만 `progressRecipe.tones.danger`로 바꾼다.
+- 넣지 않은 것: 자동 업로드 시작, 이미지 미리보기 썸네일, 순서 재배치(drag
+  reorder), 여러 파일의 배치 재시도 정책. 이 모듈은 한 파일 한 행의 표현만
+  안다 — 목록 레이아웃과 배치 동작은 제품이 [[file-picker]]의 선택 결과 위에
+  조합한다.
+
+**HJM 기본값.** 행 높이는 `layout.rowHeight.twoLine`(파일명 + 상태/진행 두 줄
+정보 밀도)이고, 취소/재시도 target은 `control.minTouchTarget`(44) 이상을
+유지한다. 상태별 강조 색은 `pending=content.secondary`,
+`uploading=content.brand`, `success=feedback.success.foreground`,
+`error=content.danger`이며, 어떤 상태도 색만으로 구분되지 않고 `statusText`
+슬롯의 문장이 항상 함께 있다.
+
+**플랫폼 번역.**
+
+- Web: 행을 `role="group"`으로 묶고 진행 막대는 `role="progressbar"`, 취소/재시도는
+  `role="button"`이다. 진행률 변경은 진행 중인 값이 잦게 바뀌므로 매 tick을
+  발표하지 않고(LoadMore의 loading status와 같은 절제) 상태 전이(시작/완료/실패)
+  시점에만 announce한다 — tick마다 알리는 정책은 이 계약에 넣지 않는다.
+- Native: `accessibilityState.busy`가 `uploading`에 대응하고, `cancel`/`retry`
+  action이 각각 uploading/error에서만 노출된다. `NativeAccessibilityState`
+  enum에는 error/success 전용 상태가 없어 `busy` 하나로만 표현하고, 나머지
+  구분은 `statusText`의 문장이 맡는다.
+- `stateAxes.content`는 공통 축 `idle | loading | loadingMore | empty | error |
+  complete` 중 `idle`(pending), `loading`(uploading), `complete`(success),
+  `error`만 쓴다. `loadingMore`와 `empty`는 목록 페이지네이션 개념이라 한 파일의
+  상태에는 적용되지 않는다.
+
+**검증 화면.** first-party Web·Native renderer와 cancel/retry 상태 테스트는 연결되어
+surface는 `beta`다. 실제 전송 lifecycle을 쓰는 제품 vertical slice는 아직 없으므로
+`stable` 승격 gate는 닫혀 있다.

package/docs/utility.md

@@ -0,0 +1,53 @@
+# Utility — 새 컴포넌트를 만들지 않는다
+
+## 이름이 이미 경고였다
+
+"유틸"은 컴포넌트가 아니다. 먼저 antd의 실제 `Util` 페이지가 무엇인지 확인했다(공식
+문서 확인, 아래 출처). antd `Util`은 UI 컴포넌트가 아니라 **`theme.useToken()` 훅으로
+현재 테마의 design token 값을 자신의 커스텀 컴포넌트에서 읽는 방법**을 설명하는 문서
+페이지다.
+
+## 판정: 이 패키지 자체가 이미 그 역할이다
+
+`useToken()`이 제공하는 것 — 현재 테마의 색·간격·타이포 값을 코드에서 직접 읽는 것 —
+은 이 저장소에서는 **훅이 아니라 이미 export된 상수**로 존재한다: `spacing`, `radius`,
+`typography`, `glyph`, `stroke`, `semanticColors`, `THEMES`(`foundations.ts`,
+`semantic-colors.ts`, `colors.ts`). antd는 이 값들을 Context에 넣고 훅으로 꺼내야 하지만
+(런타임 테마 스위칭이 Context 기반이므로), 이 패키지는 애초에 런타임 의존성이 없어 그
+값들을 정적 module import로 바로 쓴다 — **"컴포넌트에서 토큰 값을 읽는 방법"이라는 antd
+`Util` 페이지의 문제 자체가 이 패키지 구조에서는 발생하지 않는다.**
+
+즉 `Utility`라는 이름 아래 모일 실체가 없다:
+
+- 새 값 타입 없음 — 토큰은 이미 `foundations.ts`/`semantic-colors.ts`/`colors.ts`에 있다.
+- 새 접근 패턴 없음 — `import { spacing } from "@hjmds/design-contracts"`가 이미 `useToken()`이
+  하는 일과 같은 결과를 낸다(테마별 실제 색 resolve는 `resolveColorReference`가 이미
+  한다).
+- 새 접근성·상태 축 없음 — 컴포넌트가 아니므로 애초에 대상이 아니다.
+
+`ContextPanel`(`docs/context-panel.md`)과 같은 자리다 — crosswalk에 실체가 없는 이름이
+목록에 먼저 올라간 경우.
+
+## 결론
+
+`src/utility.ts`, `test/utility.test.ts`는 만들지 않는다.
+
+## 판정이 뒤집힐 조건
+
+antd `Util` 페이지가 이후 실제 유틸리티 함수(단순 토큰 읽기를 넘어서는, 예를 들어 이
+패키지가 아직 갖지 않은 계산 헬퍼)를 추가하고 그중 플랫폼 중립적으로 유용한 것이
+확인되면, 그건 `Utility`라는 이름의 새 컴포넌트가 아니라 **그 헬퍼가 속한 기존 모듈**
+(예: 숫자 관련이면 `number-field.ts`의 `clampToRange`류)에 함수로 추가하는 쪽을 권한다.
+
+## 배선 명세 제안 (리드 적용)
+
+`ContextPanel`과 같은 방식을 권한다.
+
+**(a) 권고: catalog에서 제거.** `src/catalog.ts`의 `{ name: "Utility", category:
+"utility", platform: "web", status: "planned", aliases: ["Util"] }`(`src/catalog.ts:127`)
+행을 지운다. `component-definitions.ts`의 예약 ID는 무해하니 남겨도 된다.
+
+**(b) 대안: catalog row 유지 + 이 문서만 링크.**
+
+이 저작자 판단은 (a)다 — 대응할 실체가 없는 `planned` 행이 "곧 만들 컴포넌트"로
+오인되는 비용이 검색 편의보다 크다고 봤다(`ContextPanel`과 같은 이유).

package/docs/virtual-list.md

@@ -0,0 +1,70 @@
+# VirtualList — 계약을 만들지 않는다
+
+## 제약
+
+`docs/ant-design-coverage.md`의 lifecycle 절이 이미 선언했다 — Ant Design 6.6.1이 기존
+`List`를 deprecated로 두고 `Listy`를 successor로 추가했지만, **HJM은 기존 비가상
+`List`와 planned `VirtualList`를 서로 다른 사용 문제로 유지한다.** 이 문서는 그 선언을
+뒤집지 않는다. 두 catalog row(`List` beta, `VirtualList` planned + `aliases: ["Listy"]`)를
+합치자는 이야기가 아니라, **`VirtualList`가 소유할 계약이 실제로 있는지**를 판정한다.
+
+## 판정: 지금은 아무것도 소유하지 않는다
+
+가상화가 계약이 되려면 "Web과 Native가 각자 다른 구현 기법으로 같은 결과를 낸다"는
+공통 semantic이 있어야 한다(`docs/architecture.md`의 `adaptive` 정의 그대로). 후보를
+셋으로 나눠 각각 판정했다.
+
+### 1. 항목 높이 추정(고정/가변) — 렌더러 기법이다
+
+Web windowing 라이브러리(react-window/virtua류)와 RN `FlatList`는 각자의 windowing
+파라미터(`itemSize`/`overscan` vs `getItemLayout`/`windowSize`/`initialNumToRender`)를
+갖지만 이름도, 단위도, 의미도 서로 대응하지 않는다. Slider의 `min`/`max`/`step`처럼
+두 플랫폼이 같은 사용자 의미를 공유하는 것이 아니라, 각 플랫폼의 렌더링 성능 엔진이
+내부적으로 요구하는 힌트일 뿐이다 — 공유할 semantic이 없다.
+
+### 2. 스크롤 위치 복원 — 가상화 전용 문제가 아니다
+
+가상화하지 않은 평범한 긴 목록도 스크롤 위치 복원이 필요하다(뒤로가기 후 원래 보던
+위치로). 이 문제는 "가상화됐는가"와 독립이고, 스크롤을 소유한 컨테이너/렌더러의 몫이다
+— `VirtualList`라는 이름 아래 있어야 할 이유가 없다.
+
+### 3. 총 개수의 낭독 — 실제로는 이미 있거나, 아직 없다
+
+가상화된 목록은 DOM/네이티브 뷰 트리에 일부만 마운트되므로 스크린 리더가 전체 개수를
+잘못 알 수 있다는 우려는 진짜다. 그런데 이 문제를 나눠보면:
+
+- 전체 데이터가 이미 메모리에 있는 경우(`items.length`를 제품이 이미 안다) — 총
+  개수는 이미 알려진 값이고, `aria-setsize`/`aria-posinset`류를 실제 배열 길이로
+  채우는 것은 렌더러가 창을 마운트할 때 하는 일이다. 이걸 계산하거나 유도할 판단이
+  없다 — Steps/Timeline/Carousel의 `position`/`total`처럼 커서 위치나 유효하지 않은
+  조합을 막는 로직이 있는 게 아니라, 그냥 `.length`를 읽는 일이다.
+- 전체 데이터가 아직 로딩 중인 경우(페이지네이션) — 이건 `src/load-more.ts`가 이미
+  소유한 문제다. `LoadMoreState`는 의도적으로 `totalCount`를 갖지 않는다 — 모르는
+  총합을 지어내는 것이 아무것도 말하지 않는 것보다 나쁘기 때문이다(`idle|loading|
+  loadingMore|error|complete` 중 어느 것도 총 개수를 전제하지 않는다). `VirtualList`가
+  이 자리에 총 개수 축을 새로 만들면 LoadMore가 이미 내린 판단과 충돌한다.
+
+즉 이 문제는 이미 있는 계약(`LoadMore`) 또는 렌더러가 이미 아는 값(`items.length`) 중
+하나로 항상 환원된다 — `VirtualList`가 따로 소유할 몫이 남지 않는다.
+
+## 결론
+
+측정된 제품 요구도 없다 — 로드맵·메모리 어디에도 "List+LoadMore로는 렌더링 성능이
+부족했다"는 vertical slice 기록이 없다. 야잘알의 긴 목록(팀 순위, 선수 검색 결과)은
+이미 List/ListRow + LoadMore 조합으로 충분히 설계돼 있다.
+
+`src/virtual-list.ts`, `test/virtual-list.test.ts`는 만들지 않는다. catalog row(`{ name:
+"VirtualList", category: "data-display", platform: "adaptive", status: "planned",
+aliases: ["Listy"] }`)는 건드리지 않는다 — 이름 자리를 지우자는 것이 아니라, 지금
+채울 계약이 없다는 것이다.
+
+## 뒤집힐 조건
+
+다음 중 하나가 실제로 측정되면 이 판정을 다시 연다.
+
+1. 실제 제품에서 List+LoadMore로 렌더링 성능(프레임 드랍, 초기 마운트 시간)이 측정
+   가능하게 부족한 vertical slice가 나온다.
+2. Web과 Native 렌더러가 **같은 이름의 파라미터**로 반응하는 windowing 설정이 두
+   플랫폼 모두에서 검증돼, 진짜 공유 semantic이 있다고 판단된다.
+3. 총 개수를 알 수 없는 채로 가상화해야 하는 화면이 나와, `LoadMore`의 "총합을 지어내지
+   않는다"는 원칙과 다른 새 발화 규칙이 필요해진다.

package/docs/watermark.md

@@ -0,0 +1,58 @@
+# Watermark — 계약을 만들지 않는다
+
+## 문제로 제기된 것
+
+Ant Design `Watermark`는 콘텐츠 위에 반복되는 텍스트/이미지를 덮어 출처나 소유권을
+표시합니다. 이 컴포넌트를 검토하며 나온 관찰은, 유일하게 성립할 수 있는 계약이
+**"덮개가 본문 낭독과 조작을 방해하면 안 된다"**는 것이고, 두 제품에 실제 수요가
+없다면 만들지 않는다는 조건이었습니다.
+
+## 판정: 만들지 않는다
+
+### 1. 두 React 기반 제품 어디에도 실사용처가 없다
+
+`Yajalal RN`(`modules/app-rn/src`)과 `BurnTok`(`apps/web/src`,
+`packages/design-system/src`) 양쪽을 `watermark`로 전수 검색한 결과, 시각적으로 콘텐츠
+위에 반복 마크를 덮는 코드는 없었습니다. 유일한 매치는
+`modules/app-rn/src/features/notification/state.ts:48`의 "seen watermark"로, 이는 "이
+알림까지는 읽음 처리됐다"는 **읽음 커서**를 뜻하는 이름일 뿐 시각적 워터마크와 무관합니다.
+공유 흐름(`LineupRouteScreen.tsx`, `PlayerCompareScreen.tsx`)도 `Share.share({ message })`로
+텍스트만 공유하고, 이미지를 만들어 공유하는 경로 자체가 아직 없습니다.
+
+### 2. 같은 개념이 다른 스택에는 있지만, 이 패키지가 서비스하는 층이 아니다
+
+Flutter 앱(`modules/app`)에는 실제 시각 워터마크가 있습니다 —
+`modules/app/lib/managers/watermark.manager.dart`, `modules/app/lib/common/sharing/
+app_name_watermark.dart`(공유 이미지에 앱 이름을 얹는 `AppNameWatermark`),
+`player_detail_info.dart`의 등번호 배경 워터마크, `contrast.dart`의
+`watermarkAlphaFor`(배경 명도에 따라 0.08/0.16 알파를 고르는 대비 계산)까지 갖췄습니다.
+이는 "워터마크"라는 제품 개념이 회사 안에 이미 존재한다는 증거이지, **이 패키지가
+계약하는 React/RN 스택**(`docs/architecture.md`: "React, React Native, DOM, Expo import는
+코어에 들어오지 않는다")에서 검증된 vertical slice라는 증거는 아닙니다. Flutter 구현은
+같은 렌더러 경계를 공유하지 않으므로 이 판정의 근거로 세지 않았습니다.
+
+### 3. 유일하게 유효한 계약은 이미 있는 원칙의 적용일 뿐, 새 상태 축이 아니다
+
+`Icon`(`src/icon.ts`)과 `Image`(`src/image.ts`)가 이미 decorative/informative
+discriminated union으로 "장식용 콘텐츠는 접근성 트리에서 빠지고 상호작용을 가로채지
+않는다"는 원칙을 확립해 두었습니다. 반복 마크가 본문 낭독·조작을 방해하면 안 된다는
+관찰은 이 원칙을 "화면 전체를 덮는 장식 레이어"에 적용한 것일 뿐, Watermark만의 새
+상태 축이나 접근성 개념이 아닙니다. 타일 밀도, 회전 각도, 캔버스/SVG 렌더링 방식은
+"이 패키지의 층에 속하는가" 질문에서 렌더러의 몫입니다 — 플랫폼 중립 계약이 검증할 수
+있는 입력이 없습니다.
+
+## 만들지 않은 것
+
+`src/watermark.ts`, `test/watermark.test.ts`는 없습니다.
+`componentCatalog`의 `{ name: "Watermark", category: "feedback", platform: "web",
+status: "planned" }` 행과 crosswalk의 `Watermark → Watermark` direct 관계
+(`src/component-references.ts:123`)는 건드리지 않습니다.
+
+## 뒤집힐 조건
+
+1. BurnTok 또는 Yajalal RN에 실제 이미지 워터마크 요구(스크린샷 유출 방지, 공유 이미지에
+   앱 마크 삽입 등)가 나타나는 vertical slice가 측정된다.
+2. 그 슬라이스에서 "decorative overlay는 낭독·조작을 가로채지 않는다"는 기존 원칙 이상의
+   새 규칙(예: 워터마크 밀도가 본문 대비 요건과 충돌해 별도 최소 명도 대비 계산이
+   필요한 경우 — Flutter의 `watermarkAlphaFor`가 이미 이런 계산의 선례이니 이식 여부를
+   먼저 검토)이 필요해진다.

package/package.json

@@ -0,0 +1,402 @@
+{
+  "name": "@hjmds/design-contracts",
+  "version": "0.8.2",
+  "description": "Renderer-neutral design contracts, tokens, recipes, and behaviors shared by HJM products.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jim1286/hjm-design-system.git",
+    "directory": "packages/design-contracts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tokens": {
+      "types": "./dist/tokens.d.ts",
+      "react-native": "./dist/tokens.js",
+      "import": "./dist/tokens.js",
+      "default": "./dist/tokens.js"
+    },
+    "./foundations": {
+      "types": "./dist/foundations.d.ts",
+      "react-native": "./dist/foundations.js",
+      "import": "./dist/foundations.js",
+      "default": "./dist/foundations.js"
+    },
+    "./colors": {
+      "types": "./dist/colors.d.ts",
+      "react-native": "./dist/colors.js",
+      "import": "./dist/colors.js",
+      "default": "./dist/colors.js"
+    },
+    "./color-references": {
+      "types": "./dist/color-references.d.ts",
+      "react-native": "./dist/color-references.js",
+      "import": "./dist/color-references.js",
+      "default": "./dist/color-references.js"
+    },
+    "./responsive": {
+      "types": "./dist/responsive.d.ts",
+      "react-native": "./dist/responsive.js",
+      "import": "./dist/responsive.js",
+      "default": "./dist/responsive.js"
+    },
+    "./grid": {
+      "types": "./dist/grid.d.ts",
+      "react-native": "./dist/grid.js",
+      "import": "./dist/grid.js",
+      "default": "./dist/grid.js"
+    },
+    "./recipes": {
+      "types": "./dist/component-recipes.d.ts",
+      "react-native": "./dist/component-recipes.js",
+      "import": "./dist/component-recipes.js",
+      "default": "./dist/component-recipes.js"
+    },
+    "./recipes/base": {
+      "types": "./dist/base-recipes.d.ts",
+      "react-native": "./dist/base-recipes.js",
+      "import": "./dist/base-recipes.js",
+      "default": "./dist/base-recipes.js"
+    },
+    "./recipes/all": {
+      "types": "./dist/recipes.d.ts",
+      "react-native": "./dist/recipes.js",
+      "import": "./dist/recipes.js",
+      "default": "./dist/recipes.js"
+    },
+    "./behaviors": {
+      "types": "./dist/behaviors.d.ts",
+      "react-native": "./dist/behaviors.js",
+      "import": "./dist/behaviors.js",
+      "default": "./dist/behaviors.js"
+    },
+    "./contracts": {
+      "types": "./dist/component-contracts.d.ts",
+      "react-native": "./dist/component-contracts.js",
+      "import": "./dist/component-contracts.js",
+      "default": "./dist/component-contracts.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog.d.ts",
+      "react-native": "./dist/catalog.js",
+      "import": "./dist/catalog.js",
+      "default": "./dist/catalog.js"
+    },
+    "./evidence": {
+      "types": "./dist/evidence.d.ts",
+      "react-native": "./dist/evidence.js",
+      "import": "./dist/evidence.js",
+      "default": "./dist/evidence.js"
+    },
+    "./version": {
+      "types": "./dist/version.d.ts",
+      "react-native": "./dist/version.js",
+      "import": "./dist/version.js",
+      "default": "./dist/version.js"
+    },
+    "./manifest.json": {
+      "default": "./docs/generated/showcase-manifest.json"
+    },
+    "./renderer-evidence.json": {
+      "default": "./docs/generated/renderer-evidence.json"
+    },
+    "./components/alert-dialog": {
+      "types": "./dist/alert-dialog.d.ts",
+      "react-native": "./dist/alert-dialog.js",
+      "import": "./dist/alert-dialog.js",
+      "default": "./dist/alert-dialog.js"
+    },
+    "./components/bottom-navigation": {
+      "types": "./dist/bottom-navigation.d.ts",
+      "react-native": "./dist/bottom-navigation.js",
+      "import": "./dist/bottom-navigation.js",
+      "default": "./dist/bottom-navigation.js"
+    },
+    "./components/breadcrumb": {
+      "types": "./dist/breadcrumb.d.ts",
+      "react-native": "./dist/breadcrumb.js",
+      "import": "./dist/breadcrumb.js",
+      "default": "./dist/breadcrumb.js"
+    },
+    "./components/calendar": {
+      "types": "./dist/calendar.d.ts",
+      "react-native": "./dist/calendar.js",
+      "import": "./dist/calendar.js",
+      "default": "./dist/calendar.js"
+    },
+    "./components/card": {
+      "types": "./dist/card.d.ts",
+      "react-native": "./dist/card.js",
+      "import": "./dist/card.js",
+      "default": "./dist/card.js"
+    },
+    "./components/carousel": {
+      "types": "./dist/carousel.d.ts",
+      "react-native": "./dist/carousel.js",
+      "import": "./dist/carousel.js",
+      "default": "./dist/carousel.js"
+    },
+    "./components/collection": {
+      "types": "./dist/collection.d.ts",
+      "react-native": "./dist/collection.js",
+      "import": "./dist/collection.js",
+      "default": "./dist/collection.js"
+    },
+    "./components/command-palette": {
+      "types": "./dist/command-palette.d.ts",
+      "react-native": "./dist/command-palette.js",
+      "import": "./dist/command-palette.js",
+      "default": "./dist/command-palette.js"
+    },
+    "./components/content-state": {
+      "types": "./dist/content-state.d.ts",
+      "react-native": "./dist/content-state.js",
+      "import": "./dist/content-state.js",
+      "default": "./dist/content-state.js"
+    },
+    "./components/data-table": {
+      "types": "./dist/data-table.d.ts",
+      "react-native": "./dist/data-table.js",
+      "import": "./dist/data-table.js",
+      "default": "./dist/data-table.js"
+    },
+    "./components/date-picker": {
+      "types": "./dist/date-picker.d.ts",
+      "react-native": "./dist/date-picker.js",
+      "import": "./dist/date-picker.js",
+      "default": "./dist/date-picker.js"
+    },
+    "./components/description-list": {
+      "types": "./dist/description-list.d.ts",
+      "react-native": "./dist/description-list.js",
+      "import": "./dist/description-list.js",
+      "default": "./dist/description-list.js"
+    },
+    "./components/design-system-provider": {
+      "types": "./dist/design-system-provider.d.ts",
+      "react-native": "./dist/design-system-provider.js",
+      "import": "./dist/design-system-provider.js",
+      "default": "./dist/design-system-provider.js"
+    },
+    "./components/file-picker": {
+      "types": "./dist/file-picker.d.ts",
+      "react-native": "./dist/file-picker.js",
+      "import": "./dist/file-picker.js",
+      "default": "./dist/file-picker.js"
+    },
+    "./components/floating-action-button": {
+      "types": "./dist/floating-action-button.d.ts",
+      "react-native": "./dist/floating-action-button.js",
+      "import": "./dist/floating-action-button.js",
+      "default": "./dist/floating-action-button.js"
+    },
+    "./components/form": {
+      "types": "./dist/form.d.ts",
+      "react-native": "./dist/form.js",
+      "import": "./dist/form.js",
+      "default": "./dist/form.js"
+    },
+    "./components/icon": {
+      "types": "./dist/icon.d.ts",
+      "react-native": "./dist/icon.js",
+      "import": "./dist/icon.js",
+      "default": "./dist/icon.js"
+    },
+    "./components/image": {
+      "types": "./dist/image.d.ts",
+      "react-native": "./dist/image.js",
+      "import": "./dist/image.js",
+      "default": "./dist/image.js"
+    },
+    "./components/layout": {
+      "types": "./dist/layout.d.ts",
+      "react-native": "./dist/layout.js",
+      "import": "./dist/layout.js",
+      "default": "./dist/layout.js"
+    },
+    "./components/link": {
+      "types": "./dist/link.d.ts",
+      "react-native": "./dist/link.js",
+      "import": "./dist/link.js",
+      "default": "./dist/link.js"
+    },
+    "./components/load-more": {
+      "types": "./dist/load-more.d.ts",
+      "react-native": "./dist/load-more.js",
+      "import": "./dist/load-more.js",
+      "default": "./dist/load-more.js"
+    },
+    "./components/mentions": {
+      "types": "./dist/mentions.d.ts",
+      "react-native": "./dist/mentions.js",
+      "import": "./dist/mentions.js",
+      "default": "./dist/mentions.js"
+    },
+    "./components/number-field": {
+      "types": "./dist/number-field.d.ts",
+      "react-native": "./dist/number-field.js",
+      "import": "./dist/number-field.js",
+      "default": "./dist/number-field.js"
+    },
+    "./components/otp-field": {
+      "types": "./dist/otp-field.d.ts",
+      "react-native": "./dist/otp-field.js",
+      "import": "./dist/otp-field.js",
+      "default": "./dist/otp-field.js"
+    },
+    "./components/pagination": {
+      "types": "./dist/pagination.d.ts",
+      "react-native": "./dist/pagination.js",
+      "import": "./dist/pagination.js",
+      "default": "./dist/pagination.js"
+    },
+    "./components/password-field": {
+      "types": "./dist/password-field.d.ts",
+      "react-native": "./dist/password-field.js",
+      "import": "./dist/password-field.js",
+      "default": "./dist/password-field.js"
+    },
+    "./components/popover": {
+      "types": "./dist/popover.d.ts",
+      "react-native": "./dist/popover.js",
+      "import": "./dist/popover.js",
+      "default": "./dist/popover.js"
+    },
+    "./components/result": {
+      "types": "./dist/result.d.ts",
+      "react-native": "./dist/result.js",
+      "import": "./dist/result.js",
+      "default": "./dist/result.js"
+    },
+    "./components/sheet": {
+      "types": "./dist/sheet.d.ts",
+      "react-native": "./dist/sheet.js",
+      "import": "./dist/sheet.js",
+      "default": "./dist/sheet.js"
+    },
+    "./components/side-panel": {
+      "types": "./dist/side-panel.d.ts",
+      "react-native": "./dist/side-panel.js",
+      "import": "./dist/side-panel.js",
+      "default": "./dist/side-panel.js"
+    },
+    "./components/slider": {
+      "types": "./dist/slider.d.ts",
+      "react-native": "./dist/slider.js",
+      "import": "./dist/slider.js",
+      "default": "./dist/slider.js"
+    },
+    "./components/splitter": {
+      "types": "./dist/splitter.d.ts",
+      "react-native": "./dist/splitter.js",
+      "import": "./dist/splitter.js",
+      "default": "./dist/splitter.js"
+    },
+    "./components/statistic": {
+      "types": "./dist/statistic.d.ts",
+      "react-native": "./dist/statistic.js",
+      "import": "./dist/statistic.js",
+      "default": "./dist/statistic.js"
+    },
+    "./components/steps": {
+      "types": "./dist/steps.d.ts",
+      "react-native": "./dist/steps.js",
+      "import": "./dist/steps.js",
+      "default": "./dist/steps.js"
+    },
+    "./components/tag": {
+      "types": "./dist/tag.d.ts",
+      "react-native": "./dist/tag.js",
+      "import": "./dist/tag.js",
+      "default": "./dist/tag.js"
+    },
+    "./components/timeline": {
+      "types": "./dist/timeline.d.ts",
+      "react-native": "./dist/timeline.js",
+      "import": "./dist/timeline.js",
+      "default": "./dist/timeline.js"
+    },
+    "./components/toast": {
+      "types": "./dist/toast.d.ts",
+      "react-native": "./dist/toast.js",
+      "import": "./dist/toast.js",
+      "default": "./dist/toast.js"
+    },
+    "./components/tooltip": {
+      "types": "./dist/tooltip.d.ts",
+      "react-native": "./dist/tooltip.js",
+      "import": "./dist/tooltip.js",
+      "default": "./dist/tooltip.js"
+    },
+    "./components/tour": {
+      "types": "./dist/tour.d.ts",
+      "react-native": "./dist/tour.js",
+      "import": "./dist/tour.js",
+      "default": "./dist/tour.js"
+    },
+    "./components/transfer-list": {
+      "types": "./dist/transfer-list.d.ts",
+      "react-native": "./dist/transfer-list.js",
+      "import": "./dist/transfer-list.js",
+      "default": "./dist/transfer-list.js"
+    },
+    "./components/tree": {
+      "types": "./dist/tree.d.ts",
+      "react-native": "./dist/tree.js",
+      "import": "./dist/tree.js",
+      "default": "./dist/tree.js"
+    },
+    "./components/tree-select": {
+      "types": "./dist/tree-select.d.ts",
+      "react-native": "./dist/tree-select.js",
+      "import": "./dist/tree-select.js",
+      "default": "./dist/tree-select.js"
+    },
+    "./components/upload-item": {
+      "types": "./dist/upload-item.d.ts",
+      "react-native": "./dist/upload-item.js",
+      "import": "./dist/upload-item.js",
+      "default": "./dist/upload-item.js"
+    },
+    "./showcase": {
+      "types": "./dist/showcase.d.ts",
+      "react-native": "./dist/showcase.js",
+      "import": "./dist/showcase.js",
+      "default": "./dist/showcase.js"
+    }
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "check": "pnpm typecheck && pnpm test && pnpm build && pnpm contracts:check && pnpm bundle:check",
+    "contracts:sync": "pnpm build && node scripts/sync-contract-artifacts.mjs --write",
+    "contracts:check": "node scripts/sync-contract-artifacts.mjs",
+    "bundle:check": "node scripts/check-bundle-budget.mjs",
+    "reference:antd:verify": "node scripts/verify-antd-reference.mjs"
+  }
+}