ksk-design-system 2.0.0 → 2.0.1

package/MIGRATION.md

@@ -116,7 +116,7 @@ install に失敗しうるため、SemVer どおり major に倒した。
 
 ## v1 系内の minor 変更（参考）
 
-### 次のリリース — `ResponsiveOverlayFrame` に `preset="plain"` を追加（issue #486）
+### v1.70.0 — `ResponsiveOverlayFrame` に `preset="plain"` を追加（issue #486）
 
 `side="bottom"` の経路は必ず `BottomSheetFrame` の preset を通るため、
 `sm:`（640px 以上）でフロートカード化し、内側 padding も落ちる（`p-0`）。
@@ -162,7 +162,7 @@ install に失敗しうるため、SemVer どおり major に倒した。
 - `desktopPosition` は `"center"` / `"top"` のみ。`"fullscreen"` は plain の
   幅指定と噛み合わないため型で禁止している。
 
-### 次のリリース — `ResponsiveOverlayFrame` が float / float-glass シートを受けられるようになった（issue #479）
+### v1.69.0 — `ResponsiveOverlayFrame` が float / float-glass シートを受けられるようになった（issue #479）
 
 #472 で入った `ResponsiveOverlayFrame` は内部で `BottomSheetFrame`（`side="bottom"` 固定）を
 使うため、左右・下に余白を持つカード型のシート（`side="float"` / `"float-glass"`）を
@@ -226,7 +226,7 @@ global CSS（`!important`）を残す必要があった。
   `side="bottom"` 専用なので、`snapPoints` と float 系の併用は snap もデスクトップ変換も
   効かない「何も起きない」組み合わせになる。どちらかに寄せること。
 
-### 次のリリース — `ResponsiveOverlayFrame` 追加（`BottomSheetFrame` + 消費側デスクトップ CSS からの移行 / issue #472）
+### v1.67.0 — `ResponsiveOverlayFrame` 追加（`BottomSheetFrame` + 消費側デスクトップ CSS からの移行 / issue #472）
 
 `BottomSheetFrame` はモバイルの preset（`mobile-full` / `mobile-page` /
 `mobile-form`）を持つ一方でデスクトップでは中央モーダルにならず、消費側は
@@ -298,7 +298,7 @@ global CSS で `position` / `transform` / `width` / `max-height` / `radius` を
 既存の `BottomSheetFrame` / `ResponsiveDialogContent` は非推奨ではない
 （モバイル専用面・preset 不要の面では引き続きそのまま使う）。
 
-### 次のリリース — `typescript` が必須依存から optional peer dependency になった（issue #409）
+### v1.62.0 — `typescript` が必須依存から optional peer dependency になった（issue #409）
 
 CLI の1ルール（P046）のためだけに typescript（24MB）が全 consumer の
 node_modules に入っていたのを解消した。install サイズが減り、`ksk-ds lint` の
@@ -311,7 +311,7 @@ node_modules に入っていたのを解消した。install サイズが減り
   typescript を追加すること
 
 
-### 次のリリース — `ksk-ds lint` の severity 語彙が `warn` → `warning` に統一（要確認）
+### v1.62.0 — `ksk-ds lint` の severity 語彙が `warn` → `warning` に統一（要確認）
 
 `--format json` の `results[].severity` と text 出力の severity 表記が、これまで
 `"warn"` と `"warning"` で不統一だった（contract の `contracts/rules.json` は
@@ -335,7 +335,7 @@ text 出力の要約行も `0 error / 3 warn` → `0 error / 3 warning` に変
 - **未知のオプションはエラー終了**（従来は黙って捨てられ、CI に書いた
   `--strict` が無言で効かないまま緑になっていた）
 
-### 次のリリース — `ksk-ds lint` の escape がルール単位・行単位で書けるようになった
+### v1.62.0 — `ksk-ds lint` の escape がルール単位・行単位で書けるようになった
 
 ファイル全体・全ルールを無期限に外す `// ksk-ds-allow-custom-ui: 理由` は
 後方互換で残るが**非推奨**。新規はルール単位を使う（issue #405）:
@@ -351,7 +351,7 @@ ignore は効かない。あわせて escape マーカーは**文字列リテラ
 無効化されていた）。既に short な理由を書いていたファイルは lint が復活するので、
 理由を書き足すか違反を直すこと。
 
-### 次のリリース — 自動生成物と DS 自身のトークン CSS を lint 対象外にした
+### v1.62.0 — 自動生成物と DS 自身のトークン CSS を lint 対象外にした
 
 - 先頭 12 行に自動生成マーカー（`AUTO-GENERATED` / `DO NOT EDIT` / `自動生成` 等）を
   持つファイルは全ルールを skip する（issue #408）。直す先は生成物ではなく生成元。
@@ -359,7 +359,7 @@ ignore は効かない。あわせて escape マーカーは**文字列リテラ
   トークン定義 CSS を対象外にする（issue #407）。`vendor/ksk-design-system/**` のように
   DS を再梱包しているリポで P049 が大量に出ていたのが解消する。
 
-### 次のリリース — `Footer` の `paymentIcons` 既定値が空になった（挙動変更）
+### v1.62.0 — `Footer` の `paymentIcons` 既定値が空になった（挙動変更）
 
 `Footer` は `paymentIcons` を省略すると `["VISA", "Master", "JCB", "AmEx", "PayPay", "LINE Pay"]`
 の決済バッジを既定で描画していた。EC 以外のプロダクトでも「取り扱っていない決済手段」が
@@ -376,7 +376,7 @@ ignore は効かない。あわせて escape マーカーは**文字列リテラ
 
 `paymentIcons` を明示的に渡していた箇所は影響なし。
 
-### 次のリリース — `postinstall` による AI ルールファイル自動設置を廃止（要確認）
+### v1.60.0 — `postinstall` による AI ルールファイル自動設置を廃止（要確認）
 
 これまで `npm install ksk-design-system` の `postinstall` フックが、消費側の
 プロジェクトルートに `CLAUDE.md` / `AGENTS.md`（`node_modules` 内の DS ルールを指す
@@ -397,7 +397,7 @@ npx ksk-ds init --force  # 既存ファイルを最新テンプレートで上
 `postinstall` を持つ限りバージョンを上げても判定が引き継がれる。あわせて
 `INIT_CWD` 参照も削除し、書き込み先はコマンドを実行したディレクトリに固定した。
 
-### 次のリリース — PillToggle の onChange/onValueChange 統一（破壊変更なし）
+### v1.49.0 — PillToggle の onChange/onValueChange 統一（破壊変更なし）
 
 `PillToggle` のみ他コンポーネント（Switch 等の native 系を除く）と異なり `onValueChange`
 を主 API として案内していたため、`onChange` に統一した（issue #264⑥）。
@@ -414,7 +414,7 @@ npx ksk-ds init --force  # 既存ファイルを最新テンプレートで上
 `onChange` と `onValueChange` を両方渡した場合は `onChange` が優先される。
 `onValueChange` は将来のメジャーバージョンで削除予定。
 
-### 次のリリース — Tailwind 4.1 以上が必要（要確認）
+### v1.49.0 — Tailwind 4.1 以上が必要（要確認）
 
 preset に DS 内部ユーティリティの safelist（`src/styles/source-safelist.css`・自動生成）を同梱した（issue #258）。
 これにより、消費側の `@source ".../ksk-design-system/dist"` の設定漏れやパスずれで

package/contracts/components.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "name": "KSK Design System — Component Contracts",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "全コンポーネントの構造化定義。バリアント・アクセシビリティ要件・使用ルールを機械可読形式で管理。",
     "counts": {
       "ui": 68,

package/contracts/token-hex-cache.json

@@ -1,7 +1,7 @@
 {
   "meta": {
     "name": "KSK Design System — Semantic Token Hex Cache",
-    "version": "2.0.0",
+    "version": "2.0.1",
     "description": "semantic / semanticDark トークン（var(--Primitive-*) 参照）を実 hex に解決したサイドカー生成物。hex はデフォルト（Blue）テーマでの解決値であり、Brand 系（meta.themeDependentKeys に列挙）はテーマ差し替え（orange/green/violet 等）で実色が変わる。テーマ別の完全解決値は `ksk-design-system/native` エクスポート（バンドル済み native トークンモジュール）の themes を参照。tokens.json 本体のスキーマは変更せず、AI がこのファイルだけで実色を把握できるようにし、primitive 値の変更による semantic 実色のドリフトを --check で機械検出する。",
     "generatedBy": "scripts/generate-token-hex-cache.mjs",
     "theme": "default",

package/dist/index.js

@@ -1022,13 +1022,30 @@ function $t(e, t) {
 	e && typeof e == "object" && (e.current = t);
 }
 function en(e, t) {
-	return u.useCallback((n) => {
-		e(n);
-		let r = $t(t, n);
-		return () => {
-			e(null), r ? r() : $t(t, null);
+	let n = u.useRef(e), r = u.useRef(t), i = u.useRef(null), a = u.useRef(null), o = u.useRef(null), s = u.useCallback(() => {
+		let e = o.current;
+		e && (o.current = null, e.cleanup ? e.cleanup() : $t(e.ref, null));
+	}, []), c = u.useCallback((e, t) => {
+		o.current = {
+			ref: e,
+			cleanup: $t(e, t)
 		};
-	}, [e, t]);
+	}, []);
+	return u.useInsertionEffect(() => {
+		n.current = e, r.current = t;
+		let l = i.current;
+		if (l != null) {
+			if (a.current !== e) {
+				let t = a.current;
+				a.current = e, t?.(null), e(l);
+			}
+			o.current?.ref !== t && (s(), c(t, l));
+		}
+	}), u.useCallback((e) => (i.current = e, a.current = e == null ? null : n.current, n.current(e), s(), e != null && c(r.current, e), () => {
+		i.current = null;
+		let e = a.current;
+		a.current = null, e?.(null), s();
+	}), [c, s]);
 }
 //#endregion
 //#region src/lib/title-level.tsx
@@ -12689,8 +12706,8 @@ function of(e) {
 }
 var sf = "min(85dvh, 46rem)", cf = "min(90dvh, 46rem)";
 function lf(e, t, n) {
-	let r = u.useRef(null), [i, a] = u.useState(0), o = u.useCallback((e) => {
-		r.current = e, a((e) => e + 1);
+	let r = u.useRef(null), [i, a] = u.useState(null), o = u.useCallback((e) => {
+		r.current = e, a(e);
 	}, []), [s, c] = u.useState();
 	return u.useLayoutEffect(() => {
 		let n = r.current;

package/dist/types/components/patterns/responsive-overlay-frame.d.ts

@@ -13,6 +13,25 @@ import { type SheetSurface } from "./sheet-surface";
  * float 系では `preset` は効かず、代わりに `padding` が効く。
  */
 type ResponsiveOverlaySide = "bottom" | "float" | "float-glass";
+/**
+ * 面に実際に効いている `max-height`（実測値）。
+ *
+ * 既定キャップは className でも上書きできる（desktopClassName の max-h ユーティリティ）。
+ * inline style は className より強いので、経路の既定値だけを見て畳むと
+ * consumer が締めたキャップを緩めてしまう（#487 の Codex レビュー指摘）。
+ * 補正が当たっていない間の computed 値を読めば、className / inline style /
+ * 経路の既定のどれで決まっていても「いま効いているキャップ」が取れる。
+ *
+ * 補正が当たっている間は自分の inline 値を読み返してしまうので、その間だけ
+ * inline の max-height を外して測り、すぐ戻す（layout effect の中なので
+ * 塗り替えは挟まらない）。「Sheet からの切り替え直後にすでにキーボードが
+ * 出ている」（iPad を境界跨ぎで回転した等）ケースでも初回から実測できる
+ * ようにするため、active を理由に測定を諦めない（#487 の Codex レビュー指摘）。
+ */
+export declare function useEffectiveMaxHeight(active: boolean, consumerInlineMaxHeight: string, classSignature: string): {
+    setElement: (node: HTMLDivElement | null) => void;
+    measured: string | undefined;
+};
 /**
  * ズームを打ち消したソフトキーボード高さ（レイアウト px / issue #487）。
  *

package/dist/types/lib/compose-ref.d.ts

@@ -17,6 +17,13 @@ export declare function assignRef<T>(ref: React.Ref<T> | undefined, node: T | nu
  * - consumer が cleanup を返していれば、それを呼ぶ
  * - 返していなければ（object ref / 旧来のコールバック ref）`null` を書き戻す
  *
+ * **返すコールバック ref の identity は固定する**（issue #516）。React は
+ * コールバック ref の identity が render 間で変わると detach → re-attach を
+ * 行うため、`internal` / `external` を依存にして毎 render 作り直すと、
+ * consumer が毎 render 新しい関数を渡す呼び出し面（Radix の composeRefs が
+ * 生成する合成関数など）で ref chain 全体の付け外しが増える。identity を
+ * 固定し、差し替えは insertion effect で node を付け替えることで吸収する。
+ *
  * @param internal 内部側の setter。attach 時に node、detach 時に null で呼ばれる
  * @param external consumer から渡された ref（未指定可）
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ksk-design-system",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "type": "module",
   "description": "KSK Design System — フリーランス向けマルチテーマ対応デザインシステム",
   "license": "MIT",