melta-app 0.5.3 → 0.7.0

package/lib/typescript/src/primitives/tag.styles.d.ts

@@ -5,8 +5,41 @@
  * 直接実行できる。recipes/app/tag.recipe.json（melta-contracts の styleRefs）との
  * 機械照合は scripts/lib/tag-conformance.test.ts が行う。
  */
-import type { NativeTheme, ThemeMode, FontSizeKey } from "../theme";
+import type { NativeTheme, ThemeMode, FontSizeKey } from "../theme/index.js";
 export type TagVariant = "basic" | "removable" | "filter-chip";
+/** label の fontSize token キー（component / resolver / 検算が同じキーを読む SSOT）。 */
+export declare const TAG_SPEC: {
+    /** basic / removable の label。 */
+    readonly labelFont: "xs";
+    /** filter-chip の label（押せる要素なので一段大きい）。 */
+    readonly chipLabelFont: "sm";
+};
+/**
+ * removable の × の当たり判定（正典パターン: 視覚 24pt + hitSlop 10 = 実効 44pt）。
+ * 親 Tag の高さ（padding 駆動で 34pt 前後）を超えられないので × 自身に持たせる。
+ */
+export declare const TAG_REMOVE_TAP_TARGET: {
+    readonly minWidth: 24;
+    readonly minHeight: 24;
+    readonly hitSlop: 10;
+};
+/**
+ * filter-chip（押せる chip 本体）の縦 hitSlop。
+ *
+ * chip は背景と枠を持つので minHeight で伸ばすと**見た目が変わる**（他 variant と高さが揃わない）。
+ * よって視覚寸法は据え置き、当たり判定だけ広げる:
+ *   視覚高さ 34pt（paddingVertical 4 × 2 + label sm の lineHeight 26）+ 5 × 2 = 44pt。
+ *
+ * padding 駆動なので fontScale で視覚高さ自体が伸びる ＝ 拡大時に過剰な当たり判定にならない。
+ * ⚠️ literal で持つ（resolveTagFilterChipVisualHeight から導出しない）。導出にすると
+ * 寸法変更に hitSlop が黙って追随し、conformance が fail-open になる。
+ */
+export declare const TAG_FILTER_CHIP_VERTICAL_HIT_SLOP = 5;
+/**
+ * filter-chip の視覚高さ（padding 駆動）。conformance が 44pt 到達を検算するための実測値。
+ * = paddingVertical × 2 + label（sm）の lineHeight。
+ */
+export declare function resolveTagFilterChipVisualHeight(theme: NativeTheme): number;
 /** 共通形状（px-3 py-1 gap-1 rounded-full。tag.recipe の全 variant style と共通の寸法キー）。 */
 export declare function resolveTagBase(theme: NativeTheme): {
     gap: number;

package/lib/typescript/src/primitives/tag.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tag.styles.d.ts","sourceRoot":"","sources":["../../../../src/primitives/tag.styles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/D,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAOA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,UAAU,EACnB,QAAQ,UAAQ,GACf;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAwB7F"}
+{"version":3,"file":"tag.styles.d.ts","sourceRoot":"","sources":["../../../../src/primitives/tag.styles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAI7E,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/D,yEAAyE;AACzE,eAAO,MAAM,QAAQ;IACnB,iCAAiC;;IAEjC,0CAA0C;;CAE+B,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;CAAuB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAI3E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB,CAOA;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,UAAU,EACnB,QAAQ,UAAQ,GACf;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE,CAwB7F"}

package/lib/typescript/src/primitives/text.styles.d.ts

@@ -5,7 +5,7 @@
  * 直接実行できる。recipes/app/text.recipe.json（melta-contracts の styleRefs）との
  * 機械照合は scripts/lib/text-conformance.test.ts が行う。
  */
-import type { NativeTheme, FontSizeKey, FontWeightKey, FontWeightValue } from "../theme";
+import type { NativeTheme, FontSizeKey, FontWeightKey, FontWeightValue } from "../theme/index.js";
 /** letterSpacing の切替軸（text.recipe description の role prop に対応）。 */
 export type TextRole = "heading" | "body";
 /** Text の形状 style（mode 非依存部分。文字色は render 時に semantic colors から取る）。 */
@@ -18,9 +18,7 @@ export interface TextShape {
 /**
  * variant / role / weight → 形状解決（text.recipe styleRefs の 1:1 写像）。
  * - fontSize token は複合値（px + lineHeight 比率）。theme 生成時に lineHeight は px 化済み。
- * - letterSpacing は em 比率 token のため fontSize × ratio で pt 化する。
- *   theme の resolveLetterSpacing と同一式だが、theme index 経由の runtime import は
- *   ThemeProvider → react-native を引くため、pure に保つ目的でここでは式を直書きする。
+ * - letterSpacing は em 比率 token のため fontSize × ratio で pt 化する（resolveLetterSpacing）。
  */
 export declare function resolveTextShape(theme: NativeTheme, variant: FontSizeKey, role: TextRole, weight?: FontWeightKey): TextShape;
 //# sourceMappingURL=text.styles.d.ts.map

package/lib/typescript/src/primitives/text.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.styles.d.ts","sourceRoot":"","sources":["../../../../src/primitives/text.styles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEzF,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1C,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,aAAa,GACrB,SAAS,CAQX"}
+{"version":3,"file":"text.styles.d.ts","sourceRoot":"","sources":["../../../../src/primitives/text.styles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAMlG,mEAAmE;AACnE,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1C,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE,aAAa,GACrB,SAAS,CAUX"}

package/lib/typescript/src/safe-area/index.d.ts

@@ -11,9 +11,10 @@
  *   import { enableSafeAreaContext } from "melta-app/safe-area";
  *   enableSafeAreaContext();
  *
- * これで Screen の SafeArea が useSafeAreaInsets() + View の adapter に切り替わる。
- * Provider の context 値を render 中に同期参照して padding を付けるため、native
- * SafeAreaView の layout/state 更新を待たず、初回 render から inset が反映される。
+ * これで Screen / ActionSheet / BottomSheet の SafeArea が useSafeAreaInsets() + View の
+ * adapter に切り替わる。Provider の context 値を render 中に同期参照して padding を付けるため、
+ * native SafeAreaView の layout/state 更新を待たず、初回 render から inset が反映される。
+ * Android でも効く（RN core の SafeAreaView は Android では完全 no-op）。
  *
  * ⚠️ 前提: アプリの root に SafeAreaProvider が必要（無いと useSafeAreaInsets が throw
  * する）。初回 render から正しい inset を使うには Provider に initialMetrics も渡す。
@@ -26,9 +27,22 @@
 import { type Edge } from "react-native-safe-area-context";
 /** enableSafeAreaContext() の設定。edges 省略時は従来相当の全 edge。 */
 export interface EnableSafeAreaContextOptions {
-    /** Screen に適用する edge。tab bar 等が担当する edge は除外する。 */
+    /**
+     * **Screen の既定 edge**（`edges` prop を渡さなかった Screen に適用される）。
+     * tab bar 等が担当する edge は除外する。
+     *
+     * ⚠️ 0.5.x までは「アプリ全体で 1 個のグローバル」だったが、edge は消費者ごとに
+     * 決まるべきものなので既定値の意味に変わった。ActionSheet / BottomSheet は画面下端に
+     * 出る都合上、ここの指定に関わらず自前の edge（bottom + 左右）を使う。
+     * 画面ごとに変えたい場合は `<Screen edges={["top"]} />` のように Screen 側で指定する。
+     */
     edges?: readonly Edge[];
 }
-/** Screen の SafeArea を context 同期参照の View adapter に切り替える。 */
+/**
+ * melta の SafeArea を context 同期参照の View adapter に切り替える。
+ *
+ * registry には**ファクトリ**を渡す（消費者ごとに edges が違うため）。同じ edges 集合には
+ * 同じコンポーネント参照が返るよう memo するのは registry 側の責務。
+ */
 export declare function enableSafeAreaContext(options?: EnableSafeAreaContextOptions): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/safe-area/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/safe-area/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,EAEL,KAAK,IAAI,EAEV,MAAM,gCAAgC,CAAC;AASxC,yDAAyD;AACzD,MAAM,WAAW,4BAA4B;IAC3C,mDAAmD;IACnD,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;CACzB;AAyDD,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,IAAI,CAEtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/safe-area/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,EAEL,KAAK,IAAI,EAEV,MAAM,gCAAgC,CAAC;AASxC,yDAAyD;AACzD,MAAM,WAAW,4BAA4B;IAC3C;;;;;;;;OAQG;IACH,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;CACzB;AAyDD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,IAAI,CAEtF"}

package/lib/typescript/src/theme/ThemeProvider.d.ts

@@ -12,8 +12,8 @@
  * `defineTheme()` の戻り値だけ（define-theme.ts 参照）。
  */
 import { type ReactNode } from "react";
-import { type ResolvedCapabilities, type ResolvedNativeTheme } from "./define-theme";
-import type { NativeTheme, SemanticColors, ThemeMode } from "./types";
+import { type ResolvedCapabilities, type ResolvedNativeTheme } from "./define-theme.js";
+import type { NativeTheme, SemanticColors, ThemeMode } from "./types.js";
 export type { ThemeMode };
 export interface ThemeContextValue {
     /**

package/lib/typescript/src/theme/ThemeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3E,OAAO,EAAmC,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAA2B,MAAM,gBAAgB,CAAC;AAC/I,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEtE,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,2EAA2E;IAC3E,MAAM,EAAE,cAAc,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAmCD,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,kBAAkB,2CAiChF;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C"}
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3E,OAAO,EAAmC,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAA2B,MAAM,mBAAmB,CAAC;AAClJ,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzE,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,2EAA2E;IAC3E,MAAM,EAAE,cAAc,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAsCD,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;OAIG;IACH,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,kBAAkB,2CAiChF;AAED,wBAAgB,QAAQ,IAAI,iBAAiB,CAM5C"}

package/lib/typescript/src/theme/define-theme.d.ts

@@ -19,7 +19,7 @@
  * theme でも現状 **必須のまま**。①の射程は colorScheme 軸だけで、それらの capability 化は
  * 後続（accent 依存の除去）で扱う。
  */
-import type { NativeTheme, SemanticColors, ThemeColor, ThemeMode } from "./types";
+import type { NativeTheme, SemanticColors, ThemeColor, ThemeMode } from "./types.js";
 /**
  * 開発ビルドか。**裸の `__DEV__` を直接書かないこと。**
  *
@@ -78,9 +78,15 @@ export interface ThemeModeViolation {
  * プロパティにも true を返すので、それで判定すると「持っていない mode に置いた番人の getter」を
  * 値として数えてしまい、解決後の theme に対して常に light / dark 両方を返す（0.4.0 の不具合）。
  * 入力（素のデータプロパティ）と解決後（番人つき）のどちらに対しても正しく答える必要がある。
+ *
+ * @experimental 公開しているが安定 API ではない。挙動・シグネチャは予告なく変わりうる。
  */
 export declare function declaredModes(semantic: Partial<Record<ThemeMode, SemanticColors>>): ThemeMode[];
-/** colorScheme capability を `color.semantic` のキー集合から導出する。 */
+/**
+ * colorScheme capability を `color.semantic` のキー集合から導出する。
+ *
+ * @experimental 公開しているが安定 API ではない。挙動・シグネチャは予告なく変わりうる。
+ */
 export declare function deriveColorScheme(semantic: Partial<Record<ThemeMode, SemanticColors>>): ColorSchemeCapability;
 /**
  * capability が実際に描ける mode。
@@ -88,6 +94,8 @@ export declare function deriveColorScheme(semantic: Partial<Record<ThemeMode, Se
  * 未知の値は**黙って light-dark 扱いにしない**。TypeScript を使わない消費者や、将来
  * capability の値が増えたときに、誤った値が「両対応の theme」として通ってしまうと、
  * 持っていない mode で描画されて初めて壊れる（＝原因から遠い場所で落ちる）。
+ *
+ * @experimental 公開しているが安定 API ではない。挙動・シグネチャは予告なく変わりうる。
  */
 export declare function supportedModes(colorScheme: ColorSchemeCapability): ThemeMode[];
 /**
@@ -99,6 +107,8 @@ export declare function supportedModes(colorScheme: ColorSchemeCapability): Them
  * - **`forcedMode` との不一致は報告する**。宣言同士の矛盾＝呼び出し側の間違いなので violation を返す。
  *   ただし throw はしない（clamp して描き続ける）。厳格に落としたいテストや compiler が
  *   violation を error に昇格させる側の責務にする。
+ *
+ * @experimental 公開しているが安定 API ではない。挙動・シグネチャ・violation の内容は予告なく変わりうる。
  */
 export declare function resolveMode(colorScheme: ColorSchemeCapability, forcedMode: ThemeMode | undefined, systemMode: ThemeMode): {
     mode: ThemeMode;
@@ -127,6 +137,9 @@ export declare function validateTheme(options: ThemeOptions): string[];
  *
  * dev では validateTheme を1回通し、問題があれば throw する（構造が壊れた theme は
  * 後段で必ず事故になるので早く落とす）。production では検査ごと省く。
+ *
+ * dev では**戻り値だけ**が入れ子まで再帰 freeze される。入力オブジェクトと公開 export の
+ * `nativeTheme` は `cloneTokenTree` で参照を切ってあるので凍らない（0.4.3 で意図的にこうした）。
  */
 export declare function defineTheme(options: ThemeOptions): ResolvedNativeTheme;
 //# sourceMappingURL=define-theme.d.ts.map

package/lib/typescript/src/theme/define-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/define-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAIV,WAAW,EAGX,cAAc,EAGd,UAAU,EACV,SAAS,EACV,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,EAAE,OAID,CAAC;AAMpB,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,qBAAqB,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9D,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG;QACpC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;KACtD,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;CAC7C;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,yBAAyB,CAAC;IAChC,oCAAoC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,qBAAqB,CAAC;CACpC;AA0GD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,EAAE,CAG/F;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,GACnD,qBAAqB,CAQvB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAa9E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,qBAAqB,EAClC,UAAU,EAAE,SAAS,GAAG,SAAS,EACjC,UAAU,EAAE,SAAS,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAgBrD;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAwD7D;AA4FD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,CA4BtE"}
+{"version":3,"file":"define-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/define-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAIV,WAAW,EAGX,cAAc,EAGd,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAC;AAMpB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,KAAK,EAAE,OAID,CAAC;AAMpB,4DAA4D;AAC5D,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,cAAc,GAAG,aAAa,CAAC;AAElF;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,qBAAqB,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9D,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG;QACpC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;KACtD,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;CAC7C;AAED,0EAA0E;AAC1E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,yBAAyB,CAAC;IAChC,oCAAoC;IACpC,SAAS,EAAE,SAAS,CAAC;IACrB,oBAAoB;IACpB,QAAQ,EAAE,SAAS,CAAC;IACpB,WAAW,EAAE,qBAAqB,CAAC;CACpC;AA0GD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,GAAG,SAAS,EAAE,CAG/F;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,GACnD,qBAAqB,CAQvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAAE,CAa9E;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,qBAAqB,EAClC,UAAU,EAAE,SAAS,GAAG,SAAS,EACjC,UAAU,EAAE,SAAS,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAgBrD;AA2BD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CA0E7D;AA4FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,mBAAmB,CA4BtE"}

package/lib/typescript/src/theme/index.d.ts

@@ -3,22 +3,23 @@
  * 型は types.ts、値は native-theme.ts（melta-contracts から自動生成）。
  * 消費者ブランドの theme を注入する口は define-theme.ts（`defineTheme`）。
  */
-export * from "./types";
-export { nativeTheme } from "./native-theme";
-export { ThemeProvider, useTheme } from "./ThemeProvider";
-export type { ThemeContextValue, ThemeMode } from "./ThemeProvider";
-export { defineTheme } from "./define-theme";
+export * from "./types.js";
+export { nativeTheme } from "./native-theme.js";
+export { ThemeProvider, useTheme } from "./ThemeProvider.js";
+export type { ThemeContextValue, ThemeMode } from "./ThemeProvider.js";
+export { defineTheme } from "./define-theme.js";
+export { DEFAULT_MIN_LINE_HEIGHT_RATIO, minLineHeightFor, clampLineHeight, } from "./line-height.js";
+/**
+ * letterSpacingRatio（em 相当の比率）を適用先の fontSize から letterSpacing(pt) に解決する helper。
+ * 実体は pure module（./letter-spacing）。resolver 側は index を経由せず直接 import する
+ * （index は ThemeProvider = react-native を引くため）。
+ */
+export { resolveLetterSpacing } from "./letter-spacing.js";
 /**
  * 以下は theme の解決規則を外から検証・再利用するためのヘルパ。
  * **@experimental — 安定 API ではない。** 挙動・シグネチャ・メッセージは予告なく変わりうる。
  * アプリの実行時ロジックが依存する場合は、useTheme().capabilities を使うほうが安全。
  */
-export { validateTheme, resolveMode, supportedModes, deriveColorScheme, declaredModes, } from "./define-theme";
-export type { ColorSchemeCapability, ResolvedCapabilities, ResolvedNativeTheme, ThemeModeViolation, ThemeOptions, } from "./define-theme";
-/**
- * letterSpacingRatio（em 相当の比率）を、適用先の fontSize から RN の letterSpacing(pt) に解決する。
- * 例: resolveLetterSpacing(18, theme.typography.letterSpacingRatio.body)
- * theme.typography.letterSpacingRatio.* をそのまま style.letterSpacing に入れる誤用を避けるための helper。
- */
-export declare function resolveLetterSpacing(fontSize: number, ratio: number): number;
+export { validateTheme, resolveMode, supportedModes, deriveColorScheme, declaredModes, } from "./define-theme.js";
+export type { ColorSchemeCapability, ResolvedCapabilities, ResolvedNativeTheme, ThemeModeViolation, ThemeOptions, } from "./define-theme.js";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/theme/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/theme/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC"}

package/lib/typescript/src/theme/letter-spacing.d.ts

@@ -0,0 +1,15 @@
+/**
+ * letter-spacing — letterSpacingRatio（em 相当の比率）→ RN の letterSpacing(pt) の解決。
+ *
+ * theme/index.ts は ThemeProvider（react-native 依存）を re-export するので、pure style resolver や
+ * node テストから index 経由でこの helper を引くと RN を巻き込んでしまう。そのため実体は
+ * line-height.ts と同じく **pure module** に置き、index.ts は re-export だけする
+ * （公開 API の位置と名前は不変）。以前は index.ts に実体があり、pure 側は同じ式を直書きしていた。
+ */
+/**
+ * letterSpacingRatio（em 相当の比率）を、適用先の fontSize から RN の letterSpacing(pt) に解決する。
+ * 例: resolveLetterSpacing(18, theme.typography.letterSpacingRatio.body)
+ * theme.typography.letterSpacingRatio.* をそのまま style.letterSpacing に入れる誤用を避けるための helper。
+ */
+export declare function resolveLetterSpacing(fontSize: number, ratio: number): number;
+//# sourceMappingURL=letter-spacing.d.ts.map

package/lib/typescript/src/theme/letter-spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"letter-spacing.d.ts","sourceRoot":"","sources":["../../../../src/theme/letter-spacing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/lib/typescript/src/theme/line-height.d.ts

@@ -0,0 +1,44 @@
+/**
+ * line-height — 行間の安全下限（フォントの字形を欠かせない最小 lineHeight）。
+ *
+ * なぜ要るか（2026-08-05 modelog dogfood で実害）:
+ * RN Android の CustomLineHeightSpan は `leading = lineHeight - (ascent + descent)` を計算し、
+ * leading が負になると不足分を行の上下から半分ずつ削って帳尻を合わせる。削られた領域の字形
+ * （濁点は行の上端にある）は Text 既定の overflow: hidden で消える——「ギ」が「チ」に見える。
+ * web はこの機序を持たないため、web の実描画検査では検出できない（Android 実機のみで発現）。
+ *
+ * 下限は使用フォントのメトリクス（ascent + descent）に依存するが、melta はフォントを同梱しない
+ * （system フォント運用）ので、既定は **Android の日本語 system フォント Noto Sans CJK JP の
+ * 実測 1.448**（hhea: (1160 + 288) / 1000。AOSP 版・Google Fonts 版とも同値、2026-08-06 実測）
+ * を切り上げた 1.45 とする。iOS（Hiragino 1.50 相当）にはこの clip 機序が無いので基準にしない。
+ *
+ * フォントを同梱する消費者は、そのフォントの実測比率を theme の
+ * `typography.minLineHeightRatio` で宣言する（例: LINE Seed JP = 1.61）。
+ * 宣言が既定より小さいラテン専用フォント（例: Inter 1.21）も同じ口で下げられる。
+ */
+/**
+ * 既定の最小行間比。Android system 日本語フォント（Noto Sans CJK JP）の実測 1.448 の切り上げ。
+ * theme が `typography.minLineHeightRatio` を宣言しない場合にこの値へ倒れる（日本語安全側）。
+ */
+export declare const DEFAULT_MIN_LINE_HEIGHT_RATIO = 1.45;
+/**
+ * theme が宣言する最小行間比を取り出す（未宣言なら既定へ倒す）。
+ * `theme.typography.minLineHeightRatio ?? DEFAULT_MIN_LINE_HEIGHT_RATIO` を各 resolver が
+ * 写経すると、既定へ倒す規則が一箇所ずつ腐る（片方だけ ?? を落とす等）ためここに集約する。
+ */
+export declare function minRatioOf(theme: {
+    typography: {
+        minLineHeightRatio?: number;
+    };
+}): number;
+/**
+ * fontSize に対する安全な最小 lineHeight（px）。
+ * **切り上げ**であることが要点: 四捨五入だと 32 × 1.45 = 46.4 → 46 で下限を割る。
+ */
+export declare function minLineHeightFor(fontSize: number, minRatio: number): number;
+/**
+ * 宣言された lineHeight を安全下限でクランプする。
+ * 宣言値が下限以上ならそのまま（意匠の行間はどこまでも広げられる。詰める方向だけを止める）。
+ */
+export declare function clampLineHeight(fontSize: number, declaredLineHeight: number, minRatio: number): number;
+//# sourceMappingURL=line-height.d.ts.map

package/lib/typescript/src/theme/line-height.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-height.d.ts","sourceRoot":"","sources":["../../../../src/theme/line-height.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE;QAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,CAEzF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CAER"}

package/lib/typescript/src/theme/native-theme.d.ts

@@ -1,3 +1,3 @@
-import type { NativeTheme } from "./types";
+import type { NativeTheme } from "./types.js";
 export declare const nativeTheme: NativeTheme;
 //# sourceMappingURL=native-theme.d.ts.map

package/lib/typescript/src/theme/native-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-theme.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,WAAW,EAAE,WAsNzB,CAAC"}
+{"version":3,"file":"native-theme.d.ts","sourceRoot":"","sources":["../../../../src/theme/native-theme.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,eAAO,MAAM,WAAW,EAAE,WAuNzB,CAAC"}

package/lib/typescript/src/theme/types.d.ts

@@ -64,7 +64,7 @@ export interface ThemeTypography {
     /**
      * 初期は system default（未指定 = OS デフォルトフォント）。RN の fontFamily は string 一本で
      * web の fallback 配列のようには効かず、Inter 等を焼くと expo-font でのロード必須になり実機で崩れる。
-     * Inter / JetBrains Mono の embed は expo-font 導入後に generator へ font マップを渡す Phase 2。
+     * Inter / JetBrains Mono の embed は expo-font を導入し、generator へ font マップを渡す形になる（未着手）。
      * それまでは sans/mono とも未指定（= OS の sans / monospace）にする。
      */
     fontFamily: {
@@ -84,6 +84,15 @@ export interface ThemeTypography {
         heading: number;
         body: number;
     };
+    /**
+     * 使用フォントが要求する最小行間比（(ascent + descent) / unitsPerEm）。
+     * これを下回る lineHeight は RN Android で字形の描画領域を削り、濁点などが欠ける
+     * （機序と既定値 1.45 の根拠は theme/line-height.ts のコメント）。
+     * style resolver は `clampLineHeight()` でこの比率を下限として適用する。
+     * 未宣言は DEFAULT_MIN_LINE_HEIGHT_RATIO（1.45 = Android system 日本語フォント基準）へ倒れる。
+     * フォントを同梱する消費者は実測値を宣言する（例: LINE Seed JP = 1.61）。
+     */
+    minLineHeightRatio?: number;
 }
 /**
  * elevation 1段。iOS は shadow* を、Android は elevation を読む（互いに無視するので

package/lib/typescript/src/theme/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/theme/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/theme/types.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -6,7 +6,8 @@ UI を組む前に docs/patterns.md（組み方の規範）を読むこと。exa
 
 ## Docs
 
-- [README.md](https://github.com/tsubotax/melta-app#readme): 全体像（Install / 設計の核 / トークン正規化 / コンポーネント表）
+- [README.md](https://github.com/tsubotax/melta-app#readme): 使う側の全体像（Quickstart / 利用側コードの lint 強制層 / コンポーネント表 / テーマ注入 / 制約）
+- [architecture.md](https://github.com/tsubotax/melta-app/blob/main/docs/architecture.md): 触る側の台帳（ディレクトリ構成 / トークン正規化 web→RN / 実装ステータス詳細 / CI）
 - [patterns.md](https://app.melta.tsubotax.com/docs/patterns.md): フォーム等「組み方」の規範 + コピペ可能スニペット（実コードと drift 検査済み）
 - [showcase](https://app.melta.tsubotax.com/): Live Catalog（実 RN コンポーネントの web export）+ 実装状態の全量表
 - [tokens.json](https://melta.tsubotax.com/design/contracts/tokens.json): デザイントークン（契約 SSOT の配信面）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "melta-app",
-  "version": "0.5.3",
+  "version": "0.7.0",
   "description": "melta for APP — melta デザインシステムの React Native UI kit。melta-contracts（デザイン契約）を single source of truth に RN 実装でその契約を満たす。アプリ本体ではなくライブラリ。",
   "license": "MIT",
   "homepage": "https://app.melta.tsubotax.com",
@@ -37,8 +37,16 @@
       "import": "./lib/module/safe-area/index.js",
       "default": "./lib/module/safe-area/index.js"
     },
-    "./eslint-plugin": "./eslint-rules/melta.mjs",
-    "./eslint-rules/melta.mjs": "./eslint-rules/melta.mjs",
+    "./eslint-plugin": {
+      "types": "./eslint-rules/melta.d.mts",
+      "import": "./eslint-rules/melta.mjs",
+      "default": "./eslint-rules/melta.mjs"
+    },
+    "./eslint-rules/melta.mjs": {
+      "types": "./eslint-rules/melta.d.mts",
+      "import": "./eslint-rules/melta.mjs",
+      "default": "./eslint-rules/melta.mjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -55,8 +63,8 @@
     "example"
   ],
   "peerDependencies": {
-    "react": "*",
-    "react-native": "*",
+    "react": ">=18.2.0",
+    "react-native": ">=0.71.0",
     "react-native-safe-area-context": ">=4",
     "react-native-svg": ">=15"
   },
@@ -69,6 +77,7 @@
     }
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
     "@jest/globals": "^29.7.0",
     "@react-native/babel-preset": "^0.85.3",
     "@react-native/jest-preset": "^0.85.3",
@@ -77,7 +86,7 @@
     "@types/react": "~19.2.2",
     "eslint": "^10.4.1",
     "jest": "^29.7.0",
-    "melta-contracts": "^0.6.0",
+    "melta-contracts": "^0.7.0",
     "react": "19.2.3",
     "react-native": "0.85.3",
     "react-native-builder-bob": "^0.40.13",
@@ -117,7 +126,10 @@
     ],
     "testMatch": [
       "<rootDir>/src/**/__tests__/**/*.test.tsx"
-    ]
+    ],
+    "moduleNameMapper": {
+      "^(\\.{1,2}/.*)\\.js$": "$1"
+    }
   },
   "react-native-builder-bob": {
     "source": "src",
@@ -136,5 +148,8 @@
         }
       ]
     ]
+  },
+  "engines": {
+    "node": ">=22"
   }
 }

package/src/a11y/tap-target.ts

@@ -0,0 +1,38 @@
+/**
+ * tap-target — 実効タップ標的 44pt（横断方針）の数値 SSOT。
+ *
+ * 正本は melta-contracts の `A11Y_MIN_TAP_TARGET_44`（rules.json）:
+ * 「すべての操作要素は実効タップ標的 44pt を下回らない。視覚寸法は契約どおり据え置き、
+ * 当たり判定だけを広げる。app は視覚 24pt + hitSlop 10 の正典パターンか minHeight で下限を保証する
+ * （height 固定は fontScale でクリップするので使わない）」。
+ *
+ * ここは「44」という数と正典パターンの寸法を**一箇所**に置くための pure module。
+ * 各コンポーネントの hitSlop 値そのものは **literal で各 `*.styles.ts` に置く**（ここから
+ * 自動導出しない）。導出にすると視覚寸法が変わったとき hitSlop も一緒に動いてしまい、
+ * conformance テスト（scripts/lib/tap-target-conformance.test.ts）が構造的に fail-open になるため。
+ *
+ * react-native を import しない純粋モジュール（`*.styles.ts` と同じ規約）。
+ */
+
+/** 実効タップ標的の下限（pt）。WCAG 2.2 SC 2.5.5（AAA）水準を melta の横断方針として採る。 */
+export const MIN_TAP_TARGET = 44;
+
+/**
+ * 正典パターン: 視覚 24pt の箱 + hitSlop 10 → 実効 44pt。
+ * 背景を持たない小さな操作要素（Tag removable の × / Toast の × / Alert の × / Modal の ×）はこれ。
+ */
+export const CANONICAL_TAP_TARGET = {
+  minWidth: 24,
+  minHeight: 24,
+  hitSlop: 10,
+} as const;
+
+/**
+ * 視覚寸法 `visual` を実効 44pt に届かせるのに必要な**片側** hitSlop（切り上げ ＝ 安全側）。
+ *
+ * ⚠️ 実装の hitSlop 値をこの関数で計算しないこと（上のコメント参照）。
+ * 使うのは (a) 値を決めるときの検算、(b) conformance テストの期待値算出。
+ */
+export function requiredHitSlop(visual: number): number {
+  return Math.max(0, Math.ceil((MIN_TAP_TARGET - visual) / 2));
+}

package/src/components/ActionSheet.tsx

@@ -9,22 +9,27 @@
  *   色だけでなくラベル文言でも破壊的操作と分かる文言にするのは呼び出し側の責務（contract a11y）。
  * - 先頭 action の borderTop は title が無い場合は消す（title がある時だけ区切りとして意味を持つ）。
  * - action の onPress 後は onClose も呼ぶ（選択 = シートを閉じる）。
- * - sheet 群は SafeAreaView で包み下余白（ホームインジケータ）を確保（recipe description 参照）。
+ * - 下余白（ホームインジケータ）は SafeArea で確保する（recipe description 参照）。位置は
+ *   **最下部の面である cancel ブロックの内側**（BottomSheet と同じ「内側」方針に統一）。
+ *   0.5.x までは sheet 群の外側に置いていたため、iOS では inset 帯に overlay の黒が見えていた。
+ *   内側に移したことで inset 帯まで bg-surface で塗られる代わり、cancel ブロックは
+ *   inset のぶん背が高くなる（ラベルは上寄りに見える）＝意図した見た目の変更。
+ *   edge は bottom + 左右のみ（top は overlay 側で、シートは上端に接しない）。
+ *   SafeArea 実装は registry 経由（safe-area-registry.ts）— "melta-app/safe-area" を
+ *   有効化したアプリでは Android でも inset が入る（RN core の SafeAreaView は Android で no-op）。
  * - sheet 側は onStartShouldSetResponder で touch を claim し、overlay tap でだけ閉じる。
  * - style の決定は pure resolver（action-sheet.styles.ts）に分離 — recipe との機械照合対象。
  */
 
 import { useMemo } from "react";
-import {
-  Modal as RNModal,
-  Pressable,
-  SafeAreaView,
-  Text as RNText,
-  View,
-} from "react-native";
-import { useTheme } from "../theme";
-import { CONTRACTS } from "../contracts/contract-types";
-import { resolveActionSheetStyle, type ActionSheetStyle } from "./action-sheet.styles";
+import { Modal as RNModal, Pressable, Text as RNText, View } from "react-native";
+import { useTheme } from "../theme/index.js";
+import { CONTRACTS } from "../contracts/contract-types.js";
+import { resolveActionSheetStyle, type ActionSheetStyle } from "./action-sheet.styles.js";
+import { resolveSafeAreaView, type SafeAreaEdge } from "./safe-area-registry.js";
+
+/** シートは画面下端に密着するので top inset は不要。 */
+const SHEET_EDGES: readonly SafeAreaEdge[] = ["bottom", "left", "right"];
 
 export interface ActionSheetAction {
   label: string;
@@ -61,6 +66,8 @@ export function ActionSheet({
     [theme, mode],
   );
 
+  const SafeArea = resolveSafeAreaView(SHEET_EDGES);
+
   return (
     <RNModal
       visible={visible}
@@ -70,8 +77,8 @@ export function ActionSheet({
       statusBarTranslucent
     >
       <Pressable style={styles.overlayStyle} onPress={onClose} accessible={false}>
-        {/* sheet 群（sheet + cancel）: SafeArea で下余白を確保し、touch を claim して overlay へ流さない */}
-        <SafeAreaView
+        {/* sheet 群（sheet + cancel）: touch を claim して overlay へ流さない */}
+        <View
           accessibilityViewIsModal
           onStartShouldSetResponder={() => true}
           testID={testID}
@@ -101,9 +108,12 @@ export function ActionSheet({
             ))}
           </View>
           <Pressable accessibilityRole="button" onPress={onClose} style={styles.cancelStyle}>
-            <RNText style={styles.cancelTextStyle}>{cancelLabel}</RNText>
+            {/* SafeArea は最下部の面（cancel）の内側 = inset 帯を overlay の黒でなく bg-surface で塗る */}
+            <SafeArea>
+              <RNText style={styles.cancelTextStyle}>{cancelLabel}</RNText>
+            </SafeArea>
           </Pressable>
-        </SafeAreaView>
+        </View>
       </Pressable>
     </RNModal>
   );