@hjmds/design-contracts 1.14.0 → 1.15.0

package/docs/usage/tokens/radius.md

@@ -4,7 +4,7 @@
 - 상태: 배포
 - 지원: Web · Native
 - 적용: 1.12.1
-- 검토일: 2026-10-06
+- 검토일: 2026-10-07
 - 근거: `src/foundations.ts`(`radius`), `src/base-recipes.ts`(`buttonRecipe.shapes`·`fieldRecipe.shapes`·`surfaceDefaults`), `src/component-recipes.ts`, `packages/react/src/theme.ts`
 - 스토리북: `배포/토큰/표면과 움직임/둥글기`
 
@@ -51,3 +51,10 @@ const styles = StyleSheet.create({ thumb: { borderRadius: radius.md, overflow: "
 - `border-radius: 10px`처럼 토큰에 없는 값을 쓰지 않는다.
 - HJM 컴포넌트의 radius를 `style`·`className`으로 덮지 않는다. Button·필드는 `shape`, Surface는 `radius` prop으로만 고른다.
 - 원형을 만들려고 `50%`나 폭의 절반을 계산하지 않는다. `radius.full`을 쓴다.
+
+### 디자인 프로필(실험·미게시)
+
+위 표는 프로필 없는 기본값이다. 앱이 [디자인 프로필](../../design-profile.md)을 선택하면 연결된
+컴포넌트는 Web CSS 변수 또는 Native `theme.tokens`/semantic palette를 읽는다.
+직접 foundations를 import한 값은 기본 상수이므로 프로필 변경을 따라가지 않는다. 현재 연결 API의 범위는
+프로필 계약에서 확인하고 앱 CSS로 내부 값을 덮지 않는다.

package/docs/usage/tokens/typography.md

@@ -4,7 +4,7 @@
 - 상태: 배포
 - 지원: Web · Native
 - 적용: 1.12.1
-- 검토일: 2026-10-06
+- 검토일: 2026-10-07
 - 근거: `src/foundations.ts`(`typography`·`heading`·`fontFamily`·`fontWeight`·`letterSpacing`·`numeric`·`largeTextThreshold`), `src/component-recipes.ts`(`textRecipe`), `packages/react/src/theme.ts`, `packages/react/src/provider.tsx`, `packages/react-native/src/provider.tsx`
 - 스토리북: `배포/토큰/색과 글자/타이포그래피`
 
@@ -87,3 +87,17 @@ import { Heading } from "@hjmds/react-native/heading";
 | 단위 | rem(16px 기준) × `--hjm-text-scale` | dp. OS 글자 크기를 따르고, Provider `textScale`을 주면 HJM이 한 번만 곱한다 |
 | 서체 | `--hjm-font-family-ui` 목록 | OS 기본 서체(HJM이 `fontFamily`를 지정하지 않음) |
 | 큰 글자 판정 | 루트 `data-large-text` | `isLargeTextScale(environment.textScale)` |
+
+### 디자인 프로필(실험·미게시)
+
+위 표는 프로필 없는 기본값이다. 앱이 [디자인 프로필](../../design-profile.md)을 선택하면 연결된
+컴포넌트는 Web CSS 변수 또는 Native `theme.tokens`/semantic palette를 읽는다.
+직접 foundations를 import한 값은 기본 상수이므로 프로필 변경을 따라가지 않는다. 현재 연결 API의 범위는
+프로필 계약에서 확인하고 앱 CSS로 내부 값을 덮지 않는다.
+
+
+Heading의 다섯 시각 단계는 `defineHjmDesignProfile({ tokens: { heading: ... } })`로
+일괄 지정한다. Web `--hjm-heading-size/line-height/weight`, Native Heading의 Text
+metrics로 연결된다. 해당 heading을 담은 Provider에서 가장 가까운 profile을 읽는다.
+level3/4/5는 기존 typography heading/titleLarge/title override를 기본으로 병합하며
+명시적인 heading 값이 우선한다. 문서의 h1~h6 순서는 `semanticLevel`이 소유한다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hjmds/design-contracts",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "description": "Renderer-neutral design contracts, tokens, recipes, and behaviors shared by HJM products.",
   "license": "MIT",
   "repository": {
@@ -702,6 +702,18 @@
       "react-native": "./dist/document-resource.js",
       "import": "./dist/document-resource.js",
       "default": "./dist/document-resource.js"
+    },
+    "./design-profile": {
+      "types": "./dist/design-profile.d.ts",
+      "react-native": "./dist/design-profile.js",
+      "import": "./dist/design-profile.js",
+      "default": "./dist/design-profile.js"
+    },
+    "./design-profile-layout": {
+      "types": "./dist/design-profile-layout.d.ts",
+      "react-native": "./dist/design-profile-layout.js",
+      "import": "./dist/design-profile-layout.js",
+      "default": "./dist/design-profile-layout.js"
     }
   },
   "files": [