@hjmds/design-contracts 1.16.1 → 1.17.0

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 /** Package release shown by documentation surfaces. Kept in sync by a test. */
-export declare const designSystemVersion: "1.16.1";
+export declare const designSystemVersion: "1.17.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 /** Package release shown by documentation surfaces. Kept in sync by a test. */
-export const designSystemVersion = "1.16.1";
+export const designSystemVersion = "1.17.0";
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAiB,CAAC","sourcesContent":["/** Package release shown by documentation surfaces. Kept in sync by a test. */\nexport const designSystemVersion = \"1.16.1\" as const;\n"]}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAiB,CAAC","sourcesContent":["/** Package release shown by documentation surfaces. Kept in sync by a test. */\nexport const designSystemVersion = \"1.17.0\" as const;\n"]}

package/docs/bottom-navigation.md

@@ -147,3 +147,10 @@ icon/label을 제공합니다. `primaryAction`은 컬렉션 밖의 별도 원형
 선택 캡슐과 분리된 추가 행동을 참고했으며, 원본 소스는 복제하지 않았습니다.
 
 Storybook: **컴포넌트 → 탐색 → 캡슐 네비게이션**, Default/Dark/LargeText.
+
+### Native floating pressed-edge geometry (2026-10-08)
+
+Spint reproduced the first/last pressed background covering the rounded frame. Edge destinations now
+use the frame radius minus its border width on their logical outer corners; interior corners keep
+the item radius. This preserves the existing public API, router activation and focus behavior. Do not
+clip the entire elevated surface as a workaround: that also clips its shadow and focus outline.

package/docs/generated/component-maturity.md

@@ -1,6 +1,6 @@
 # Component maturity and evidence manifest
 
-> Generated from `@hjmds/design-contracts` 1.16.1. Do not edit this file directly; run `pnpm contracts:sync`.
+> Generated from `@hjmds/design-contracts` 1.17.0. Do not edit this file directly; run `pnpm contracts:sync`.
 
 This document is the human-readable projection of the same catalog and Showcase manifest consumed by product CI.
 

package/docs/generated/renderer-evidence.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "designSystemVersion": "1.16.1",
+  "designSystemVersion": "1.17.0",
   "source": "packages/design-contracts/docs/generated/showcase-manifest.json",
   "surfaces": {
     "web": {
       "packageName": "@hjmds/react",
-      "packageVersion": "1.16.1",
+      "packageVersion": "1.17.0",
       "activeComponents": 103,
       "claimedComponents": 103,
       "completeScenarioComponents": 103,
@@ -5642,7 +5642,7 @@
     },
     "native": {
       "packageName": "@hjmds/react-native",
-      "packageVersion": "1.16.1",
+      "packageVersion": "1.17.0",
       "activeComponents": 83,
       "claimedComponents": 83,
       "completeScenarioComponents": 83,

package/docs/generated/renderer-evidence.md

@@ -1,6 +1,6 @@
 # Renderer evidence coverage
 
-> Generated for HJM 1.16.1. Do not edit directly; run `pnpm evidence:sync`.
+> Generated for HJM 1.17.0. Do not edit directly; run `pnpm evidence:sync`.
 
 This projection joins the canonical surface maturity manifest with first-party renderer claims. Missing scenarios are explicit beta promotion debt; stable surfaces are blocked by CI until none remain.
 

package/docs/generated/showcase-manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "designSystemVersion": "1.16.1",
+  "designSystemVersion": "1.17.0",
   "packageName": "@hjmds/design-contracts",
   "components": [
     {

package/docs/screen-patterns.md

@@ -380,3 +380,10 @@ Web·Native가 같은 규칙이라 홈 actions 병합이나 콜백 분리는 양
 CommentThreadItem.actions sits beside likeAction in one inline row, with spacing.xxs between them,
 since the 2026-10-07 user requested a vertical-ellipsis overflow next to the heart. The slot remains
 product-owned and nullable custom likeAction remains supported; action handlers are independent.
+
+### 댓글 본문 앞 소개 슬롯
+
+CommentThreadScreen의 optional threadHeader는 첫 댓글 앞의 스크롤 콘텐츠다. Web과 Native
+모두 같은 본문에 배치하고 상태 교체 시 함께 숨긴다. fixed header는 짧은 탐색 영역, composer는
+고정 작성 영역이다. Spint의 2026-10-08 이중 스크롤 문제 때문에 추가했으며 상세 사용법은
+[댓글 화면](usage/components/comment-thread-screen.md#배치)을 따른다.

package/docs/usage/components/bottom-navigation.md

@@ -4,7 +4,7 @@
 - 상태: 배포
 - 지원: Web · Native
 - 적용: 1.12.1
-- 검토일: 2026-10-07
+- 검토일: 2026-10-08
 - 근거: [BottomNavigation](../../bottom-navigation.md), recipe `bottomNavigationRecipe`
 - 스토리북: `배포/컴포넌트/탐색/하단 탐색`
 
@@ -87,6 +87,8 @@ import { BottomNavigation } from "@hjmds/react-native/navigation";
 
 ## 배치
 
+2026-10-08 Spint 누름 상태 점검: Native floating의 양 끝 항목은 프레임 안쪽 곡률을 따라 누름 배경을 그린다. 작은 일반 항목 모서리가 프레임을 덮던 문제를 수정하며, 전체 표면 clipping으로 그림자·포커스를 자르지 않는다.
+
 Native floating 프레임·선택 표시·항목 모서리는 각 recipe radius 역할을 Provider token에서 읽는다. full/capsule 원형 역할과 목적지·키보드 동작은 유지한다.
 
 | 항목 | 값 | 근거 |

package/docs/usage/components/comment-thread-screen.md

@@ -92,6 +92,18 @@ import { MessageComposer } from "@hjmds/react-native/screens";
 
 ## 배치
 
+
+`threadHeader?: ReactNode`는 장소 소개·원문·필터처럼 댓글과 함께 스크롤할 콘텐츠다.
+공통 본문 안에서 첫 댓글 앞에 놓이고, `threadFooter`는 마지막 댓글 뒤에 놓인다.
+`header`는 뒤로 버튼·짧은 제목 같은 고정 탐색 영역에만 쓴다. 소개 영역 안에 별도 ScrollView를
+넣지 않는다. `composer`는 기존 고정 작성 영역을 유지한다. 화면 상태가 본문을 교체하면
+threadHeader도 댓글과 함께 숨겨지므로 항상 보여야 하는 안내는 `notice`를 사용한다.
+
+2026-10-08 Spint 실제 화면에서 긴 소개를 고정 header에 넣고 높이를 제한하자 스팟 선택이
+잘리고 스크롤이 둘로 나뉘었다. 임의의 댓글 항목에 소개를 끼워 넣으면 댓글 ID·펼침 계약이
+오염되므로 두 renderer에 동일한 optional 슬롯을 추가했다. 생략한 기존 호출은 바뀌지 않는다.
+
+
 | 항목 | 값 | 근거 |
 | --- | --- | --- |
 | 크기 | ScreenLayout 폭(최대 720); 본문 열이 남은 폭을 채우고(`flex: 1`, 최소 폭 0) 오른쪽 끝에 좋아요와 `actions`를 같은 가로 행으로; 답글·펼침 버튼은 `Button size="small"` ghost | Web·Native `CommentThreadScreen` |

package/docs/usage/screens/common-comments.md

@@ -14,6 +14,13 @@ CommentThreadScreen을 사용해 댓글 흐름을 구성한다. 제품이 데이
 
 ## 영역 구조
 
+
+짧은 뒤로/제목 행은 `header`, 장소 소개·원문·필터는 `threadHeader`, 추가 페이지 버튼은
+`threadFooter`, 작성기는 `composer`에 둔다. threadHeader와 댓글은 하나의 본문 스크롤을
+공유한다. 소개를 고정 header 안의 별도 스크롤로 제한하지 않는다. Spint의 소개가 잘려
+스팟 선택이 숨는 문제(2026-10-08)를 해결하기 위한 배치다.
+
+
 ```text
 host: 남은 높이·safe area·키보드
 └─ 원댓글 → 한 단계 답글 → 더 보기 → 작성창

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hjmds/design-contracts",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "description": "Renderer-neutral design contracts, tokens, recipes, and behaviors shared by HJM products.",
   "license": "MIT",
   "repository": {