@hjmds/design-contracts 1.47.0 → 1.49.0

package/docs/usage/components/timeline.md

@@ -4,15 +4,32 @@
 - 상태: 배포
 - 지원: Web · Native
 - 적용: 1.12.1
-- 검토일: 2026-10-23
+- 검토일: 2026-10-27
 - 근거: [Timeline](../../timeline.md), `src/timeline.ts`(`timelineRecipe`)
 - 스토리북: `배포/컴포넌트/데이터 표시/타임라인`
 
+## 기본 표현: 여행 일지 (2026-10-27 개발 소스, 미게시)
+
+사용자가 다이어리 비교 시안의 「여행 일지」를 선택한 뒤 옵션이 아닌 기본형으로 지정했다.
+`variant` 기본값은 `journal`이다. 박스·선택 배경 없이 작은 점과 연결선으로 기록을 잇고 제목 아래에
+시각을 둔다. 이전 면·테두리 표현이 꼭 필요한 경우에만 `variant="record"`를 명시한다.
+
+- 수동 기록은 모든 설명·metadata·기존 행동을 계속 표시한다. 경기 중계·버전 복구·활동 이력이 자동으로 접히지 않는다.
+- `selectedId`/`onSelectedIdChange`가 있으면 선택한 기록의 설명·metadata만 펼친다. 다시 누르면 상세만 접고 선택은 유지한다.
+- 다른 행·지도·날짜에서 선택을 바꾸면 새 기록을 펼친다. 제목·시각은 접어도 남는다. 펼침 상태·chevron은 HJM이 소유한다.
+- Web 기본형은 `<ol><li><button aria-expanded aria-controls>`의 disclosure 목록이다. 모든 기록 버튼에 Tab으로 접근하고 ↑/↓/Home/End로 이동·선택할 수 있다. Enter/Space는 native button 동작으로 펼침을 전환한다.
+- Native는 `Pressable`의 selected·expanded 상태를 제공한다. 접힌 설명은 접근성 이름에서도 제외한다.
+- `tone`의 의미와 독립 행동의 접근성·가상화 경계는 유지한다. `emphasized`의 큰 배경 면은 journal에 적용하지 않는다.
+
+현재 사용처: 다이어리 웹·앱 여정, 번뚝 웹·앱 버전/이야기/피드 기록, 야잘알 앱 경기 중계·선수 경력,
+Today갈게 partner-web·partner 활동 기록, portfolio-site 성과 이력. 이들은 기본 디자인 변경의 영향 대상이며
+제품별 기능·데이터를 바꾸거나 운영 반영을 확인했다는 뜻은 아니다. 웹·앱 Storybook에도 여행 일지 예제를 둔다.
+
 ## 언제 쓰나
 
 이미 일어난 일을 시간 순서대로 보여 줄 때 쓴다. 경기 플레이 기록, 이적·변경 이력, 주문 처리
 기록처럼 "무슨 일이 언제 있었나"를 위→아래 한 방향으로 나열한다. 현재 위치(커서)는 없다.
-기록 하나를 골라 옆의 지도·상세를 바꿔야 하면 `selectedId`/`onSelectedIdChange`로 기록 자체를 선택 대상으로 만든다(개발 소스, 미게시).
+기록 하나를 골라 옆의 지도·상세를 바꿔야 하면 `selectedId`/`onSelectedIdChange`로 기록 자체를 선택·펼침 대상으로 만든다(개발 소스, 미게시).
 
 ## 쓰지 않을 때
 
@@ -20,7 +37,7 @@
 | --- | --- |
 | 흐름에서 지금 어디에 있는지(현재 단계) | [Steps](steps.md) |
 | 항목을 눌러 다른 화면으로 이동 | [List](list.md), [ListRow](list-row.md) |
-| 기록 옆에 번호·선택 `Button`을 두고 `tone`·`aria-pressed`로 선택을 흉내 | `selectedId`/`onSelectedIdChange`. 선택 표현·키보드·접근성 의미는 Timeline이 소유한다 |
+| 기록 옆에 번호·선택 `Button`을 두고 `tone`·`aria-pressed`로 선택을 흉내 | `selectedId`/`onSelectedIdChange`. 선택·펼침·키보드·접근성 의미는 Timeline이 소유한다 |
 | 항목이 하나도 없음 | Timeline을 마운트하지 않고 [EmptyState](empty-state.md) |
 | 과거 기록을 더 불러옴 | Timeline 아래에 [LoadMore](load-more.md)를 합성 |
 | 항목별 짧은 배지 | `renderMetadata` 슬롯에 제품의 [Badge](badge.md) 또는 [Tag](tag.md)를 연결 |
@@ -73,6 +90,7 @@ import { Timeline } from "@hjmds/react-native/data-display";
 
 | prop | 값 | 기본값 | 설명 |
 | --- | --- | --- | --- |
+| `variant` | `journal` · `record` | `journal` | 기본 여행 일지 / 이전 면·테두리 표현. 개발 소스, 미게시 |
 | `items`(필수) | `id`·`label` 필수, `timestamp`·`description`·`tone` 선택 | — | 배열 순서가 곧 표시 순서 |
 | `items[].dateTime` | string | — | timestamp의 원래 시각. Web time의 dateTime에 연결하며 표시 문구를 바꾸지 않는다. timestamp와 함께 사용 |
 | `items[].emphasized` | boolean | false | 기록 배경의 은은한 강조. 진행 커서·선택 상태를 만들지 않는다 |
@@ -89,6 +107,10 @@ import { Timeline } from "@hjmds/react-native/data-display";
 
 ## 배치
 
+기본 `journal`은 항목 사이 0, 위아래 `spacing.md` 16, 가로 안쪽 여백 0, dot 8, connector 1이다.
+선택 배경·테두리는 없으며 펼친 설명 앞에는 `spacing.xs` 8(Web), 본문 기본 간격 `spacing.xxs` 4(Native)를 쓴다.
+아래 표의 24/12/10 배치·중립 선택 면은 호환 `variant="record"`에 해당한다.
+
 | 항목 | 값 | 근거 |
 | --- | --- | --- |
 | 크기 | 각 항목은 [레일 16][본문] 두 열. 레일은 지름 10의 dot과 다음 항목까지 이어지는 1px connector. 기록 본문은 누름 대상이 아니며 `renderActions`가 있으면 별도의 행동 열을 추가한다 | `timelineRecipe`, `.hjm-timeline__item`·`__dot`·`__connector` |
@@ -110,6 +132,8 @@ import { Timeline } from "@hjmds/react-native/data-display";
 
 ## 플랫폼 차이
 
+아래 선택형 listbox/option 설명은 `variant="record"`이다. 기본 journal의 disclosure 의미는 위 기본 표현 절을 따른다.
+
 | 항목 | Web | Native |
 | --- | --- | --- |
 | 구조 | `<ol>` / `<li>`, dot·connector `aria-hidden` | `View` 행, rail·본문은 접근성 트리에서 숨김 |

package/docs/usage/compositions/interaction-adapters.md

@@ -15,7 +15,7 @@
 순서 바꾸기·행 작업·내용 전환·카드 넘기기·달성 축하·카드 확대 화면 전환 같은 선택형 상호작용 어댑터를 한 화면에서 함께 쓸 때, 각 어댑터를 어디에 놓고 무엇으로 감싸야 하는지 확인하는 구성이다.
 
 스토리는 2026-10-06 사용자 승인으로 스토리북 배포됐다. 어댑터 API 자체의 성숙도는 따로다: `sortable`·`swipe-actions`·`content-transition`·`carousel-motion`·`celebration`은
-Web·Native stable, Native `screen-transition`은 experimental이다. 각 어댑터는 root에서 재노출되지 않고 subpath로만 import하며, 제품에 해당 peer를 설치해야 한다.
+Web·Native stable, Native `screen-transition`도 명시한 React Navigation host 범위에서 stable이다. 각 어댑터는 root에서 재노출되지 않고 subpath로만 import하며, 제품에 해당 peer를 설치해야 한다.
 
 ## 구성 요소
 
@@ -182,7 +182,7 @@ const gutter = resolveWindowClass(useWindowDimensions().width) === "compact" ? "
 | 행 작업 | 버튼 상시 노출 | 스와이프로 드러냄 + 상시 "작업 보기", `rowId`·`openRowId`·`actionsLabel` 필수 |
 | 카드 크기 | 부모 폭 | 측정한 `width`·`height` 필수 |
 | 축하 위치 | 자체 canvas | 스크롤 밖 화면 오버레이, Skia 필요 |
-| 화면 전환 | 없음(제품 라우터) | `screen-transition`(experimental, React Navigation 7.4.1 + exports patch) |
+| 화면 전환 | 없음(제품 라우터) | `screen-transition`(stable, React Navigation 7.4.1 + 문서화한 patch) |
 | 제스처 host | — | 화면 루트 `GestureHandlerRootView` |
 
 ## 함정

package/docs/usage/compositions/optional-adapters.md

@@ -14,7 +14,7 @@
 
 Native 앱 한 화면에서 이미지 확대 보기, 끌어서 높이를 바꾸는 시트, OS 길게 누르기 메뉴, 키보드를 따라 올라가는 하단 행동을 함께 쓸 때 provider 중첩 순서와 각 요소의 자리를 확인하는 구성이다.
 
-네 어댑터(`image-viewer`·`sheet-gesture`·`context-menu-native`·`keyboard-controller`)는 모두 experimental이고 Native 전용이다. 링크된 네이티브 모듈이 필요하므로
+네 어댑터(`image-viewer`·`sheet-gesture`·`context-menu-native`·`keyboard-controller`)는 문서화한 peer/host 범위에서 stable이고 Native 전용이다. 링크된 네이티브 모듈이 필요하므로
 Expo Go가 아니라 호환 개발 클라이언트에서만 확인된다. 이 기능이 필요 없으면 기본 [Sheet](../components/sheet.md)·[ContextMenu](../components/context-menu.md)·
 [KeyboardAvoiding](../components/keyboard-avoiding.md)을 쓴다.
 
@@ -158,7 +158,7 @@ const gutter = resolveWindowClass(useWindowDimensions().width) === "compact" ? "
 
 | 항목 | Web | Native |
 | --- | --- | --- |
-| 지원 | 없음(기본 Sheet·ContextMenu 사용) | 네 어댑터 experimental |
+| 지원 | 없음(기본 Sheet·ContextMenu 사용) | 네 어댑터 stable(명시한 peer/host 범위) |
 | 실행 환경 | — | 호환 개발 클라이언트(Expo Go 불가) |
 
 ## 함정

package/docs/usage/screens/common-follow-list.md

@@ -1,12 +1,12 @@
 # 팔로워와 팔로잉
 
 - 단계: 화면
-- 상태: 실험
+- 상태: 배포
 - 지원: Web · Native
-- 적용: 미게시(1.46.1 이후)
+- 적용: 1.47.0
 - 검토일: 2026-10-25
 - 근거: 사용자 Instagram 팔로워 화면 요청
-- 스토리북: `실험/화면/소통/팔로워와 팔로잉`
+- 스토리북: `배포/화면/소통/팔로워와 팔로잉`
 
 ## 목적
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hjmds/design-contracts",
-  "version": "1.47.0",
+  "version": "1.49.0",
   "description": "Renderer-neutral design contracts, tokens, recipes, and behaviors shared by HJM products.",
   "license": "MIT",
   "repository": {
@@ -823,11 +823,22 @@
       "import": "./dist/shortcut-rail.js",
       "default": "./dist/shortcut-rail.js"
     },
+    "./share-sheet": {
+      "types": "./dist/share-sheet.d.ts",
+      "react-native": "./dist/share-sheet.js",
+      "import": "./dist/share-sheet.js",
+      "default": "./dist/share-sheet.js"
+    },
     "./components/time-picker": {
       "types": "./dist/time-picker.d.ts",
       "react-native": "./dist/time-picker.js",
       "import": "./dist/time-picker.js",
       "default": "./dist/time-picker.js"
+    },
+    "./components/drawing-editor": {
+      "types": "./dist/drawing-editor.d.ts",
+      "import": "./dist/drawing-editor.js",
+      "default": "./dist/drawing-editor.js"
     }
   },
   "files": [