melta-app 0.6.0 → 0.7.0

package/README.md

@@ -1,5 +1,8 @@
 # melta for APP（melta-app）
 
+[![Check](https://github.com/tsubotax/melta-app/actions/workflows/check.yml/badge.svg)](https://github.com/tsubotax/melta-app/actions/workflows/check.yml)
+[![npm](https://img.shields.io/npm/v/melta-app)](https://www.npmjs.com/package/melta-app)
+
 **web と同じデザイン契約を React Native に降ろす UI kit。使う側のコードにも lint 強制層を npm で配る。**
 アプリ本体ではなく `npm install melta-app` で使うライブラリ。
 
@@ -21,7 +24,7 @@
 
 - **ドキュメントは契約からの生成物** — 下の[コンポーネント表](#コンポーネント)・[llms.txt](https://app.melta.tsubotax.com/llms.txt)・showcase の統計は `melta-contracts` から生成し、手書きの表はこのリポに存在しない。腐りは drift 検査が落とす（[scripts/check-drift.ts](./scripts/check-drift.ts) / [CI](./.github/workflows/check.yml)）
 - **消費者プロジェクトでの実導入検証（2026-08-04）** — 別リポジトリの自プロジェクト（非公開 RN アプリ）に npm 経由で導入し、AI が違反コードを書いた直後に検出 → 修正フィードバック → 自己修正、のループを実測で確認。導入時に見つかった hook の欠陥（実行失敗時に無言で素通りする）は同日中に本体へ還元し、故障系を含む E2E 14 ケースで固定（[scripts/lib/hook-lint.test.ts](./scripts/lib/hook-lint.test.ts) / [CHANGELOG 0.5.3](./CHANGELOG.md#053--2026-08-04)）
-- **「npm install すれば動く」の機械証明** — pack → tarball 実体検査 → fixture へ install → 本体 / icons / safe-area の import + typecheck → lint plugin を実 import してルール 4 本と推奨 severity を照合、までを公開ゲートにしている（[scripts/check-installability.sh](./scripts/check-installability.sh)。`npm run release` の必須ステップ）
+- **「npm install すれば動く」の機械証明** — pack → tarball 実体検査 → [attw](https://github.com/arethetypeswrong/arethetypeswrong.github.io) で exports の型解決を resolution mode ごとに検査 → fixture へ install → 本体 / icons / safe-area / eslint-plugin の import + typecheck を **`moduleResolution` 3 種（bundler / node16 / nodenext）すべてで**実行 → lint plugin を実 import してルール 4 本と推奨 severity を照合、までを公開ゲートにしている（[scripts/check-installability.sh](./scripts/check-installability.sh)。`npm run release` の必須ステップ）
 
 ## Quickstart
 
@@ -29,7 +32,17 @@
 npm install melta-app
 ```
 
-必須の peerDependencies は `react` / `react-native` の 2 つ（runtime 依存ゼロ）。機能別の optional peer が 2 つ — `react-native-svg`（`melta-app/icons` を使う場合のみ）と `react-native-safe-area-context`（`melta-app/safe-area` を使う場合のみ）。検証済み構成は Expo 56 / RN 0.85 / React 19.2。
+必須の peerDependencies は `react` / `react-native` の 2 つ（runtime 依存ゼロ）。機能別の optional peer が 2 つ — `react-native-svg`（`melta-app/icons` を使う場合のみ）と `react-native-safe-area-context`（`melta-app/safe-area` を使う場合のみ）。配布物は **ESM のみ**（`require()` では読めない。検証済みは Expo 56 / Metro — 他バンドラは ESM 対応が前提）。型は `moduleResolution` が `bundler` / `node16` / `nodenext` のいずれでも解決できることを CI で検査している（`skipLibCheck: true` の消費者でも型が欠落しない）。eslint plugin / hook などの Node ツール面は Node.js 22 で検証している（`engines` 宣言）。
+
+**React Native バージョン対応**（下限 0.71 は `gap` / `role` 使用のため。型・Jest で検証済みなのは Expo 56 / RN 0.85 / React 19.2 の組のみ）:
+
+| RN | melta-app | optional peer の目安 |
+|---|---|---|
+| 0.85（検証済み） | ✅ | safe-area-context 5.x / svg 15.13+ |
+| 0.74〜0.84 | 型上は互換（未検証） | safe-area-context 5.x / svg 15.8+ |
+| 0.73 | 型上は互換（未検証） | safe-area-context 4.x / svg 15.8+ |
+| 0.71〜0.72 | 型上は互換（未検証） | safe-area-context 4.x / svg 15.0〜15.7 |
+| 〜0.70 | ❌（`gap` レイアウトが崩れる） | — |
 
 > ⚠️ **0.x 系につき破壊的変更は minor で入る**（CHANGELOG 方針）。`^` 範囲でなく**バージョン固定か `~` 範囲**を推奨。
 
@@ -52,6 +65,57 @@ export default function App() {
 
 テーマは `ThemeProvider` が OS の light / dark に自動追従（`forcedMode` で固定も可）。トークンは `useTheme()` / `nativeTheme` から取れる。自分のブランドで塗り替えるなら[テーマを注入する](#テーマを注入するブランドトークン)。本体エントリ以外は subpath 3 つ（[Icon](#iconmelta-appicons) / [SafeArea 差替](#safearea-の差し替えmelta-appsafe-area) / [lint plugin](#利用側コードの-lint-強制層melta-appeslint-plugin)）。
 
+### bare React Native（Expo を使わない場合）
+
+melta-app 本体は JS のみで、ネイティブモジュールを含まない。ただし**optional peer の 2 つ
+（`react-native-safe-area-context` / `react-native-svg`）は本物のネイティブモジュール**なので、
+bare RN では npm install だけでは動かない。iOS は Pods の再インストールと、両 OS ともネイティブの
+再ビルドが要る（JS の reload では反映されない）:
+
+```bash
+# bare RN — 使う subpath に対応する peer だけ入れる
+npm install react-native-svg react-native-safe-area-context
+npx pod-install            # iOS（= cd ios && pod install）
+# その後 Xcode / Gradle でネイティブを**再ビルド**する（Metro の reload では足りない）
+```
+
+Expo（managed / prebuild）なら従来どおり `npx expo install` が RN 版に合う版を選び、
+config plugin と prebuild が iOS/Android 側を面倒見る:
+
+```bash
+npx expo install react-native-svg react-native-safe-area-context
+```
+
+どちらの peer も使わない（`melta-app` 本体エントリだけ import する）なら、
+melta-app の導入にネイティブ作業は発生しない。
+
+> 検証済みの構成は **Expo 56 / RN 0.85 / React 19.2** の組だけ（[制約と正直な範囲](#制約と正直な範囲)）。
+> bare RN 構成は型・依存関係の上では成立するが、実機での検証は行っていない。
+
+### dev 検証と `__DEV__`
+
+melta の dev 専用チェックは `__DEV__`（Metro のグローバル）が真のときだけ動く:
+
+- `defineTheme()` の `validateTheme` — 壊れた theme をその場で throw
+- 解決済み theme の `deepFreeze` — 後からの書き換えを凍結して検出
+- `ThemeProvider` の mode 違反レポート / `Card` の不正 prop 組み合わせの `console.error`
+
+**Metro 以外のバンドラ（Vite / webpack での react-native-web など）は `__DEV__` を定義しない。**
+その環境では `process.env.NODE_ENV === "development"` にフォールバックし、
+どちらも判定できなければ dev 検証は**自動で無効**になる（本番に dev コストを漏らさない側に倒す設計）。
+つまり「警告が一度も出ない ＝ 違反が無い」ではない。有効にしたい場合はどちらかを与える:
+
+```js
+// Vite
+export default { define: { __DEV__: JSON.stringify(true) } };
+// webpack
+new webpack.DefinePlugin({ __DEV__: JSON.stringify(true) });
+// もしくは NODE_ENV=development でビルド / 起動する
+```
+
+production ビルドでは `__DEV__` を偽（または未定義）のままにする — dev 検証は本番で不要な
+コストであり、Metro は偽に畳み込まれた分岐ごとバンドルから落とす。
+
 ## 利用側コードの lint 強制層（`melta-app/eslint-plugin`）
 
 melta 契約からの逸脱を機械検知する eslint カスタムルール 4 本を同梱している。
@@ -240,6 +304,110 @@ export default [
 
 0.4.x からの移行は [CHANGELOG](./CHANGELOG.md#050--2026-07-29) を参照。
 
+### 画面骨格（`Screen`）
+
+`Screen` は safe-area + `bg-page` + content padding + ScrollView を 1 つにまとめた画面の器。
+
+| prop | 型 | default | 意味 |
+|---|---|---|---|
+| `variant` | `"scroll"` \| `"fixed"` | `"scroll"` | content を ScrollView に載せるか、`flex: 1` の View に載せるか |
+| `padding` | spacing token キー \| `"none"` | `"4"` | content の padding |
+| `edges` | `readonly ("top" \| "right" \| "bottom" \| "left")[]` | [`enableSafeAreaContext`](#safearea-の差し替えmelta-appsafe-area) の既定 | safe-area を適用する辺 |
+| `header` | `ReactNode` | — | scroll の外（safe-area 直下）に固定されるヘッダー slot |
+| `scrollViewProps` | `Omit<ScrollViewProps, "children">` | — | 内部 ScrollView への passthrough（`variant="scroll"` のみ） |
+| `scrollViewRef` | `Ref<ScrollView>` | — | 内部 ScrollView の ref（`scrollTo` / `scrollToEnd` 用） |
+| `style` | `StyleProp<ViewStyle>` | — | safe-area の器に重ねる style |
+| `testID` | `string` | — | — |
+
+```tsx
+const listRef = useRef<ScrollView>(null);
+
+<Screen
+  header={<Header title="フィード" />}
+  scrollViewProps={{ onScroll: handleScroll, keyboardShouldPersistTaps: "handled" }}
+  scrollViewRef={listRef}
+>
+  <Text>本文</Text>
+</Screen>
+```
+
+契約（passthrough は「素通し」ではない）:
+
+- **`contentInsetAdjustmentBehavior` は渡さないこと。** safe-area は Screen が持つので二重 inset になる
+- `contentContainerStyle` は DS の padding と**配列合成**される（渡した側が後勝ち）。padding を**消す**目的では使えない（消したいときは `padding="none"`）
+- `scrollEventThrottle` は Screen 側の既定が `16`（iOS の既定 0 では `onScroll` が 1 ドラッグ 1 発しか来ずスクロール連動ヘッダが動かない）。消費者の指定で上書きできる
+- `variant="fixed"` に `scrollViewProps` / `scrollViewRef` を渡すと dev ビルドで警告する（内部 ScrollView が無いので黙って捨てられる）
+
+タブバーと併用する画面は、bottom をタブバー側に任せる:
+
+```tsx
+// タブ配下の画面だけ edge を絞る（アプリ全体を top-only にしない。下記 SafeArea 節を参照）
+<Screen edges={["top"]}>…</Screen>
+```
+
+## アクセシビリティの既定
+
+3 点（タップ標的 / OS の文字サイズ拡大 / 読み上げラベル）は**利用側で何もしなくても既定で満たす**ように組んである。
+
+### タップ標的 44pt
+
+すべての操作要素は**視覚寸法を変えないまま**実効タップ標的 44pt を満たす。
+契約側の正本は melta-contracts の `A11Y_MIN_TAP_TARGET_44`、実装との照合は
+[scripts/lib/tap-target-conformance.test.ts](./scripts/lib/tap-target-conformance.test.ts)（CI で毎回検査）。
+
+| 要素 | 視覚寸法 | 手当て | 実効 |
+|---|---|---|---|
+| `Button` small / medium / large（labeled） | minHeight 32 / 40 / 48 | 縦 hitSlop 6 / 2 / 0 | 44 / 44 / 48 |
+| `Button`（iconOnly） | 32 / 40 / 48 の正方形 | 四方 hitSlop 6 / 2 / 0 | 同上（縦横とも） |
+| `Tag variant="filter-chip"` | 高さ 34（padding 駆動） | 縦 hitSlop 5 | 44 |
+| `Tag variant="removable"` の × / `Toast` の × / `Alert` の × / `Modal` の × | 24 の箱 | hitSlop 10 | 44 |
+| `Radio` の option 行 | 行の高さ 36 | `minHeight: 44` | 44 |
+| `Toggle` medium / large | track 24 / 28 | 縦 hitSlop 10 / 8 | 44 |
+| `Checkbox` の行 | box 20（行は label 込み） | `minHeight: 44` | 44 |
+
+- **背景を持つ要素は hitSlop、持たない要素は `minHeight`**。背景がある要素を minHeight で伸ばすと見た目が変わるため
+- **横方向の hitSlop は隣接する操作要素との gap の 1/2 まで**。超えると当たり判定が重なって押し違いが起きる
+  （`Toast` の action と × はこれで実際に 8pt 重なっていた。0.7.0 で修正）
+- ⚠️ **iconOnly の `Button` だけは横にも hitSlop が付く**（幅 32/40 では 44pt に届かないため）。
+  iconOnly を横に並べるときは **gap を hitSlop の 2 倍以上**（small: 12 / medium: 4）取ること。
+  gap 0 で密着させると当たり判定が重なる
+
+### OS の文字サイズ拡大（fontScale）
+
+- `Button` / `TextField` の高さは **`minHeight`**（`height` 固定ではない）。文字が拡大しても縦にクリップしない
+- `Text` は `allowFontScaling` / `maxFontSizeMultiplier` を RN `Text` へ透過する。**既定は未指定 = RN 既定**（拡大に追随）。
+  固定寸法の図版ラベルなど、拡大するとレイアウトが壊れる箇所だけ opt-in で絞る
+
+  ```tsx
+  <Text maxFontSizeMultiplier={1.3}>グラフの軸ラベル</Text>
+  ```
+
+- `Avatar` の initials は器（円）が伸びないため、size 別に上限を掛けている（small 1.6 / medium 1.5 / large 1.3）。
+  拡大は許しつつ円からの溢れだけを止める設定で、利用側の指定は不要
+
+### 読み上げラベルの差し替え（i18n）
+
+内蔵の日本語ラベルは props で差し替えられる。**既定値は日本語のまま**（変えると既存アプリの VoiceOver 読み上げが変わるため）。
+
+| コンポーネント | prop | 既定 |
+|---|---|---|
+| `Toast` / `Alert` / `Modal` | `closeAccessibilityLabel` | `"閉じる"` |
+| `TextField` | `formatErrorAccessibilityLabel: (label, errorText) => string` | `` `${label}。エラー: ${errorText}` `` |
+| `ActionSheet` | `cancelLabel` | `"キャンセル"` |
+| `Skeleton` | `accessibilityLabel` | `"読み込み中"` |
+
+```tsx
+<Modal title="Delete route" closeAccessibilityLabel="Close" onClose={close} visible>…</Modal>
+
+<TextField
+  label="Email"
+  value={email}
+  variant="error"
+  errorText="Invalid format"
+  formatErrorAccessibilityLabel={(label, error) => `${label}. Error: ${error}`}
+/>
+```
+
 ## テーマを注入する（ブランドトークン）
 
 `theme` を渡すと自分のブランドトークンで塗り替わる。未指定なら melta 既定（`nativeTheme`）。
@@ -307,13 +475,19 @@ export const theme = defineTheme({
   typography: {
     fontFamily: {},  // 未指定 = OS デフォルト（RN の fontFamily は string 一本。embed は expo-font 側の責務）
     fontSize: {
-      xxs: { fontSize: 10, lineHeight: 14 }, xs: { fontSize: 12, lineHeight: 18 },
+      // lineHeight は fontSize × minLineHeightRatio（既定 1.45）以上にする。未満を書いても
+      // 実行時に下限へクランプされ、宣言値と描画値がズレるだけ（機序は src/theme/line-height.ts）
+      xxs: { fontSize: 10, lineHeight: 15 }, xs: { fontSize: 12, lineHeight: 18 },
       sm: { fontSize: 14, lineHeight: 21 }, base: { fontSize: 16, lineHeight: 26 },
-      lg: { fontSize: 18, lineHeight: 27 }, xl: { fontSize: 20, lineHeight: 28 },
-      "2xl": { fontSize: 24, lineHeight: 31 }, "3xl": { fontSize: 30, lineHeight: 36 },
+      lg: { fontSize: 18, lineHeight: 27 }, xl: { fontSize: 20, lineHeight: 29 },
+      "2xl": { fontSize: 24, lineHeight: 35 }, "3xl": { fontSize: 30, lineHeight: 44 },
     },
     fontWeight: { normal: "400", medium: "500", semibold: "600", bold: "700" },
     letterSpacingRatio: { heading: -0.02, body: 0 },  // em 比率（px ではない）
+    // フォントを同梱するなら、そのフォントが要求する最小行間比を宣言する（例: LINE Seed JP = 1.61。
+    // 下回る lineHeight は RN Android で字形が欠けるため実行時に下限へクランプされる）。
+    // 未宣言は日本語安全側の 1.45（Android system の Noto Sans CJK JP 実測）:
+    // minLineHeightRatio: 1.61,
   },
   spacing: { "1": 4, "2": 8, "3": 12, "4": 16, "5": 20, "6": 24, "8": 32, "10": 40, "12": 48, "14": 56, "16": 64 },
   radius: { sm: 4, md: 8, lg: 16, full: 9999 },
@@ -369,13 +543,22 @@ Icon は唯一 `react-native-svg`（optional peerDependency）に依存するた
 npx expo install react-native-svg
 ```
 
+> bare RN（Expo なし）は `npm install` + `npx pod-install` + ネイティブ再ビルド。
+> [bare React Native](#bare-react-nativeexpo-を使わない場合) を参照。
+
 ```tsx
 import { Icon } from "melta-app/icons";
 
 <Icon name="like-on" accessibilityLabel="いいね" />        // 意味を持つ icon は label 必須
 <Icon name="close" size="sm" color="text-muted" />         // 省略時は装飾扱い（a11y ツリーから除外）
+<Icon name="check" color="status-success" />               // status 色（Alert / Toast と同じ status token）
 ```
 
+`color` は semantic token キーに加えて `"status-success"` / `"status-warning"` / `"status-error"` を受ける
+（`theme.color.status.*.base` を引く。生 hex は受けない）。
+`"status-info"` は**無い** — status token に info の実体が無いため（web 側と同じ割り切り）。
+info 相当は `color="text-accent"` で表す。
+
 グリフは Charcoal Icons（pixiv、Apache-2.0）の curated サブセット + Charcoal に無いグリフの
 Material Symbols Rounded（Google、Apache-2.0）補完（`assets/icons/*.svg` →
 `npm run generate:icons` で `src/icons/glyphs.ts` に codegen、commit 済みを配布）。
@@ -383,29 +566,47 @@ Material Symbols Rounded（Google、Apache-2.0）補完（`assets/icons/*.svg`
 
 ### SafeArea の差し替え（`melta-app/safe-area`）
 
-Screen の SafeArea は default で RN core の SafeAreaView（deprecated / iOS のみの最小対応、
-依存ゼロ維持）。`react-native-safe-area-context` を使うアプリは subpath から一度有効化すると
-Screen が context 版に切り替わり、RN 0.85+ の deprecation 警告も出なくなる:
+safe-area は default で RN core の SafeAreaView（deprecated / iOS のみの最小対応、依存ゼロ維持。
+**Android では完全な no-op**）。`react-native-safe-area-context` を使うアプリは subpath から
+一度有効化すると `Screen` / `ActionSheet` / `BottomSheet` が context 版に切り替わり、
+Android でも inset が入り、RN 0.85+ の deprecation 警告も出なくなる:
 
 ```bash
 npx expo install react-native-safe-area-context
 ```
 
+> bare RN（Expo なし）は `npm install` + `npx pod-install` + ネイティブ再ビルド。
+> [bare React Native](#bare-react-nativeexpo-を使わない場合) を参照。
+
 ```tsx
-// アプリの entry（Screen の初回 render より前）で一度だけ
+// アプリの entry（初回 render より前）で一度だけ
 import { enableSafeAreaContext } from "melta-app/safe-area";
 enableSafeAreaContext();
 
-// ボトムタブバー等が bottom inset を自前処理するアプリは edge を絞る
-// （全 edge のまま使うとタブ内 Screen の bottom が二重余白になる）
-enableSafeAreaContext({ edges: ["top"] });
+// edges は「Screen の既定値」。省略した Screen にだけ効く
+enableSafeAreaContext({ edges: ["top", "left", "right"] });
 ```
 
+適用する辺の決まり方は 3 段（後のものが勝つ）:
+
+| 対象 | 適用される edge |
+|---|---|
+| `Screen`（`edges` 省略） | `enableSafeAreaContext({ edges })` の既定（未指定なら全 edge） |
+| `Screen edges={[...]}` | その指定（画面ごとに変えられる） |
+| `ActionSheet` / `BottomSheet` | 常に bottom + 左右（画面下端に出るため top は不要） |
+
+> ボトムタブバーがある画面は、アプリ全体を `edges: ["top"]` にするのではなく
+> **タブ配下の画面だけ [`<Screen edges={["top"]}>`](#画面骨格screen)** で絞る。シート系は
+> bottom inset を自前で持つので、グローバル top-only はシートの下余白まで削ってしまう
+> （0.5.x までのアプリ全体 1 個のグローバル指定はこの理由で推奨から外した）。
+
 ⚠️ 前提と契約:
 
 - 祖先に `SafeAreaProvider` が**必須**（無いと `useSafeAreaInsets` が **throw する**。
   React Navigation / Expo Router を使っていれば設置済みのことが多い）。初回 render から
   正しい inset を使うには Provider に `initialMetrics` を渡す
+- **adapter 未登録（RN core フォールバック）では `edges` は無視される。** core の SafeAreaView は
+  「安全域と交差する辺すべて」に padding を入れる仕様で辺を選べないため（Android は no-op）
 - adapter は `useSafeAreaInsets()` を render 中に同期参照して View padding に加算する方式
   （native SafeAreaView の初回フレーム inset 未適用によるフラッシュを避けるため）
 - safe-area と合成する padding は**数値のみ**サポート（`"5%"` 等の非数値は基底として扱えず、
@@ -434,10 +635,17 @@ enableSafeAreaContext({ edges: ["top"] });
 ## 成熟度・メンテナンス
 
 - **0.x**。API は安定に向かっているが、破壊的変更は minor で入る（[CHANGELOG](./CHANGELOG.md) が変更の正本。npm に公開した版だけを記録する）
+- **バグ・要望は [GitHub Issues](https://github.com/tsubotax/melta-app/issues)**、コントリビュートの手引きは [CONTRIBUTING.md](./CONTRIBUTING.md)、脆弱性は [SECURITY.md](./SECURITY.md) の非公開経路へ
 - **個人メンテナンスのプロジェクト**（tsubotax）。SLA・サポート窓口は無い。issue / PR は歓迎するが応答は best effort
 - **現在の adopter は 1 つ**（非公開プロジェクトのモバイルアプリ）。dogfood はそこで回している。D2I は当初想定していた最初の adopter だが、mobile 側はまだ melta-app を導入していない（D2I の web 側が使っているのは melta-ui）
 - React Native Directory 登録は [PR #2606](https://github.com/react-native-community/directory/pull/2606) がレビュー待ち
 
+### 安定性の読み方
+
+- **何も書いていない公開 API は安定**として扱ってよい。変更は semver に従う（0.x なので破壊的変更は minor bump で入り、移行手順を CHANGELOG に書く）
+- **`@experimental` 注記が付いたものは予告なく変わる**（挙動・シグネチャ・メッセージとも）。現在は theme の解決規則ヘルパ（`validateTheme` / `resolveMode` / `supportedModes` / `deriveColorScheme` / `declaredModes`）が該当し、JSDoc と型定義に注記が出る
+- **公開面の増減は機械強制**。export の増減は snapshot テスト（[scripts/lib/export-surface.test.ts](./scripts/lib/export-surface.test.ts)）が、契約の破壊的変更は melta-ui 側の `npm run design:compat` が semver bump を要求する。「気づいたら消えていた」は CI で止まる
+
 ## セキュリティ・データ境界
 
 lint も theme 生成もすべて**ローカル処理**で完結する。コード・トークン・生成物を外部へ送信しない。

package/docs/architecture.md

@@ -27,10 +27,17 @@ melta-app/
     generate-native-theme.ts    melta-contracts/tokens.json → src/theme/native-theme.ts
     generate-contract-types.ts  契約 JSON → src/contracts/contract-types.ts
     check-drift.ts              README / docs / catalog / allowlist の drift 検査（--write で heal）
-    check-installability.sh     pack → install → import → typecheck の公開ゲート
+    check-installability.sh     pack → attw → install → import → typecheck の公開ゲート
     lib/                        token 正規化 + conformance / consumer テスト
 ```
 
+## style resolver
+
+見た目の値の解決は component（`.tsx`）ではなく隣の `<component>.styles.ts`（react-native を値 import しない
+pure module）に置く。node の `tsx --test` から直接実行できることが conformance テストの前提になっている。
+書き方の規約（`<COMPONENT>_SPEC` / slot 単位の戻り値 / 命名 / 共有 module）は [AGENTS.md](../AGENTS.md) が正。
+resolver は3世代が混在しているので、**現行世代を規範とする**（初代の `button.styles.ts` を写さない）。
+
 ## トークン正規化（web → RN）
 
 `scripts/lib/normalize-tokens.ts` が変換する。壊れやすい箇所はテスト必須。
@@ -41,7 +48,7 @@ melta-app/
 | spacing / radius / fontSize | rem + px | px の数値を採用（RN は unitless） |
 | shadow | CSS box-shadow | iOS shadow* + Android elevation に分解（1 ViewStyle に同居） |
 | fontFamily | 配列 | 単一文字列（先頭採用、未ロード時 OS デフォルト fallback） |
-| lineHeight | 比率（"2.0"） | `fontSize × ratio` を px 算出 |
+| lineHeight | 比率（"2.0"） | `fontSize × ratio` を px 算出（四捨五入）し、安全下限 `ceil(fontSize × minLineHeightRatio)`（既定 1.45）でクランプ（RN Android の字形欠け対策。根拠は `src/theme/line-height.ts`） |
 | letterSpacing | em | **em ratio の数値で保持**（fontSize 相対のため token 単体で px 化不可。適用側が `fontSize × ratio` で解決） |
 | motion duration | "150ms" | 150（数値） |
 | motion easing | cubic-bezier | `[a,b,c,d]` tuple（`Easing.bezier(...)` に展開） |
@@ -67,7 +74,7 @@ npm run ios   # または android / web
 - ✅ ライブラリ化（root=ライブラリ / example=カタログアプリ、peerDeps react + react-native、runtime deps ゼロ）
 - ✅ `melta-contracts` を npm 依存として購読（recipes/app の styleRefs 同梱）
 - ✅ conformance: 契約源 ↔ 生成メタ ↔ `__contract` 宣言の照合 + consumer テスト（契約 subset / token 実在 / contractVersion 同期）+ styleRefs conformance（全実装コンポーネント展開済み）+ RN mount smoke（light/dark × 全公開コンポーネント）
-- ✅ ハーネス: design lint（CI `--max-warnings 0` + PostToolUse hook）/ drift 検査（README・docs・catalog・allowlist 突合）/ installability ゲート（pack → tarball 実体検査 → fixture へ install → 本体 / icons / safe-area の import + typecheck → eslint plugin を実 import してルール 4 本の実在を照合 → exports の解決先確認。`npm run release` チェーンの必須ステップ）
+- ✅ ハーネス: design lint（CI `--max-warnings 0` + PostToolUse hook）/ drift 検査（README・docs・catalog・allowlist 突合）/ installability ゲート（pack → tarball 実体検査 → attw で exports の型解決を resolution mode ごとに検査 → fixture へ install → 本体 / icons / safe-area / eslint-plugin の import + typecheck を moduleResolution 3 種（bundler / node16 / nodenext）で実行 → eslint plugin を実 import してルール 4 本の実在を照合 → exports の解決先確認。`npm run release` チェーンの必須ステップ）
 - ✅ layout 6 個（Stack / Row / Screen / Header / Icon / Avatar）— dogfood 不足 1〜4 を解消、ProjectFeedScreen は公開 primitive だけで構成
   - Screen の SafeArea は adapter registry 化済み: default は RN core SafeAreaView（依存ゼロ維持）、`melta-app/safe-area` の `enableSafeAreaContext()` で react-native-safe-area-context に差し替え可（optional peer）
 - ✅ form / feedback 10 個（TextField / Toggle / Checkbox / Radio / Alert / Toast / Progress / Modal / ActionSheet / BottomSheet）— checkbox / radio は Pressable + 描画（svg 非依存）、ActionSheet / BottomSheet は select / dropdown の adapted 変換先の受け皿
@@ -89,4 +96,4 @@ push / PR で以下を順に回す。CI には兄弟ディレクトリ（melta-u
 4. `npm test`（consumer + conformance）
 5. `npm run check:drift`（README / docs / catalog / allowlist）
 6. `npm run test:rn`（RN mount smoke）
-7. `npm run check:installability`（pack → install → import → typecheck）
+7. `npm run check:installability`（pack → attw → install → import → typecheck ×3 解決）

package/eslint-rules/melta.d.mts

@@ -0,0 +1,44 @@
+/**
+ * melta design lint プラグインの型宣言（melta.mjs の手書き型）。
+ *
+ * `melta.mjs` は実装の正本。この宣言は npm 利用者（moduleResolution: node16/nodenext）が
+ * `melta-app/eslint-plugin` を型付きで import できるようにするためだけに存在する。
+ * 実装を変えたらこちらも手で追随させる（ルール名は check-installability が機械照合している）。
+ *
+ * ESLint 本体の型（`eslint` / `@types/eslint`）には**意図的に依存しない**。
+ * eslint は melta-app の dependencies ではないため、import すると
+ * 「eslint 未 install の利用者で型が壊れる」経路を作ってしまう。
+ * flat config に差し込むのに必要な最小限を構造的に宣言する。
+ */
+
+/** ESLint のルール実装（AST visitor を返す `create` と表示用 `meta`）。 */
+export interface MeltaRule {
+  meta: {
+    type: "problem" | "suggestion" | "layout";
+    docs: { description: string };
+  };
+  // AST ノード型は eslint の型に依存しないため unknown 止まり（消費者は呼び出さない）。
+  create(context: unknown): Record<string, (...args: never[]) => void>;
+}
+
+/** このプラグインが提供するルール ID（`melta/` prefix なし）。 */
+export type MeltaRuleName =
+  | "no-raw-color"
+  | "no-raw-radius"
+  | "no-raw-spacing"
+  | "no-raw-fontsize";
+
+/** flat config の 1 要素として展開できる推奨設定。 */
+export interface MeltaFlatConfig {
+  name: string;
+  plugins: { melta: MeltaPlugin };
+  /** severity の正本は melta.mjs の RECOMMENDED_RULES（ドキュメントではない）。 */
+  rules: Record<string, "error" | "warn" | "off">;
+}
+
+export interface MeltaPlugin {
+  rules: Record<MeltaRuleName, MeltaRule>;
+  configs: { recommended: MeltaFlatConfig };
+}
+
+export declare const meltaPlugin: MeltaPlugin;

package/lib/module/a11y/tap-target.js

@@ -0,0 +1,41 @@
+"use strict";
+
+/**
+ * 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
+};
+
+/**
+ * 視覚寸法 `visual` を実効 44pt に届かせるのに必要な**片側** hitSlop（切り上げ ＝ 安全側）。
+ *
+ * ⚠️ 実装の hitSlop 値をこの関数で計算しないこと（上のコメント参照）。
+ * 使うのは (a) 値を決めるときの検算、(b) conformance テストの期待値算出。
+ */
+export function requiredHitSlop(visual) {
+  return Math.max(0, Math.ceil((MIN_TAP_TARGET - visual) / 2));
+}
+//# sourceMappingURL=tap-target.js.map

package/lib/module/a11y/tap-target.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MIN_TAP_TARGET","CANONICAL_TAP_TARGET","minWidth","minHeight","hitSlop","requiredHitSlop","visual","Math","max","ceil"],"sourceRoot":"../../../src","sources":["a11y/tap-target.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,MAAMA,cAAc,GAAG,EAAE;;AAEhC;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,GAAG;EAClCC,QAAQ,EAAE,EAAE;EACZC,SAAS,EAAE,EAAE;EACbC,OAAO,EAAE;AACX,CAAU;;AAEV;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACC,MAAc,EAAU;EACtD,OAAOC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAED,IAAI,CAACE,IAAI,CAAC,CAACT,cAAc,GAAGM,MAAM,IAAI,CAAC,CAAC,CAAC;AAC9D","ignoreList":[]}

package/lib/module/components/ActionSheet.js

@@ -11,17 +11,28 @@
  *   色だけでなくラベル文言でも破壊的操作と分かる文言にするのは呼び出し側の責務（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 { 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 } from "./action-sheet.styles.js";
+import { resolveSafeAreaView } from "./safe-area-registry.js";
+
+/** シートは画面下端に密着するので top inset は不要。 */
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const SHEET_EDGES = ["bottom", "left", "right"];
 export function ActionSheet({
   visible,
   onClose,
@@ -35,6 +46,7 @@ export function ActionSheet({
     mode
   } = useTheme();
   const styles = useMemo(() => resolveActionSheetStyle(theme, mode), [theme, mode]);
+  const SafeArea = resolveSafeAreaView(SHEET_EDGES);
   return /*#__PURE__*/_jsx(RNModal, {
     visible: visible,
     transparent: true,
@@ -45,7 +57,7 @@ export function ActionSheet({
       style: styles.overlayStyle,
       onPress: onClose,
       accessible: false,
-      children: /*#__PURE__*/_jsxs(SafeAreaView, {
+      children: /*#__PURE__*/_jsxs(View, {
         accessibilityViewIsModal: true,
         onStartShouldSetResponder: () => true,
         testID: testID,
@@ -74,9 +86,11 @@ export function ActionSheet({
           accessibilityRole: "button",
           onPress: onClose,
           style: styles.cancelStyle,
-          children: /*#__PURE__*/_jsx(RNText, {
-            style: styles.cancelTextStyle,
-            children: cancelLabel
+          children: /*#__PURE__*/_jsx(SafeArea, {
+            children: /*#__PURE__*/_jsx(RNText, {
+              style: styles.cancelTextStyle,
+              children: cancelLabel
+            })
           })
         })]
       })

package/lib/module/components/ActionSheet.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","Modal","RNModal","Pressable","SafeAreaView","Text","RNText","View","useTheme","CONTRACTS","resolveActionSheetStyle","jsx","_jsx","jsxs","_jsxs","ActionSheet","visible","onClose","title","actions","cancelLabel","testID","theme","mode","styles","transparent","animationType","onRequestClose","statusBarTranslucent","children","style","overlayStyle","onPress","accessible","accessibilityViewIsModal","onStartShouldSetResponder","sheetStyle","titleStyle","map","action","index","accessibilityRole","actionStyle","borderTopWidth","destructive","destructiveTextStyle","actionTextStyle","label","cancelStyle","cancelTextStyle","__contract","actionSheet"],"sourceRoot":"../../../src","sources":["components/ActionSheet.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useMemo","Modal","RNModal","Pressable","Text","RNText","View","useTheme","CONTRACTS","resolveActionSheetStyle","resolveSafeAreaView","jsx","_jsx","jsxs","_jsxs","SHEET_EDGES","ActionSheet","visible","onClose","title","actions","cancelLabel","testID","theme","mode","styles","SafeArea","transparent","animationType","onRequestClose","statusBarTranslucent","children","style","overlayStyle","onPress","accessible","accessibilityViewIsModal","onStartShouldSetResponder","sheetStyle","titleStyle","map","action","index","accessibilityRole","actionStyle","borderTopWidth","destructive","destructiveTextStyle","actionTextStyle","label","cancelStyle","cancelTextStyle","__contract","actionSheet"],"sourceRoot":"../../../src","sources":["components/ActionSheet.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAQ,OAAO;AAC/B,SAASC,KAAK,IAAIC,OAAO,EAAEC,SAAS,EAAEC,IAAI,IAAIC,MAAM,EAAEC,IAAI,QAAQ,cAAc;AAChF,SAASC,QAAQ,QAAQ,mBAAmB;AAC5C,SAASC,SAAS,QAAQ,gCAAgC;AAC1D,SAASC,uBAAuB,QAA+B,0BAA0B;AACzF,SAASC,mBAAmB,QAA2B,yBAAyB;;AAEhF;AAAA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AACA,MAAMC,WAAoC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC;AAsBxE,OAAO,SAASC,WAAWA,CAAC;EAC1BC,OAAO;EACPC,OAAO;EACPC,KAAK;EACLC,OAAO;EACPC,WAAW,GAAG,OAAO;EACrBC;AACgB,CAAC,EAAE;EACnB,MAAM;IAAEC,KAAK;IAAEC;EAAK,CAAC,GAAGjB,QAAQ,CAAC,CAAC;EAElC,MAAMkB,MAAM,GAAGzB,OAAO,CACpB,MAAMS,uBAAuB,CAACc,KAAK,EAAEC,IAAI,CAAC,EAC1C,CAACD,KAAK,EAAEC,IAAI,CACd,CAAC;EAED,MAAME,QAAQ,GAAGhB,mBAAmB,CAACK,WAAW,CAAC;EAEjD,oBACEH,IAAA,CAACV,OAAO;IACNe,OAAO,EAAEA,OAAQ;IACjBU,WAAW;IACXC,aAAa,EAAC,OAAO;IACrBC,cAAc,EAAEX,OAAQ;IACxBY,oBAAoB;IAAAC,QAAA,eAEpBnB,IAAA,CAACT,SAAS;MAAC6B,KAAK,EAAEP,MAAM,CAACQ,YAAa;MAACC,OAAO,EAAEhB,OAAQ;MAACiB,UAAU,EAAE,KAAM;MAAAJ,QAAA,eAEzEjB,KAAA,CAACR,IAAI;QACH8B,wBAAwB;QACxBC,yBAAyB,EAAEA,CAAA,KAAM,IAAK;QACtCf,MAAM,EAAEA,MAAO;QAAAS,QAAA,gBAEfjB,KAAA,CAACR,IAAI;UAAC0B,KAAK,EAAEP,MAAM,CAACa,UAAW;UAAAP,QAAA,GAC5BZ,KAAK,IAAI,IAAI,iBAAIP,IAAA,CAACP,MAAM;YAAC2B,KAAK,EAAEP,MAAM,CAACc,UAAW;YAAAR,QAAA,EAAEZ;UAAK,CAAS,CAAC,EACnEC,OAAO,CAACoB,GAAG,CAAC,CAACC,MAAM,EAAEC,KAAK,kBACzB9B,IAAA,CAACT,SAAS;YAERwC,iBAAiB,EAAC,QAAQ;YAC1BT,OAAO,EAAEA,CAAA,KAAM;cACbO,MAAM,CAACP,OAAO,CAAC,CAAC;cAChBhB,OAAO,CAAC,CAAC;YACX,CAAE;YACFc,KAAK,EAAE,CACLP,MAAM,CAACmB,WAAW;YAClB;YACAF,KAAK,KAAK,CAAC,IAAIvB,KAAK,IAAI,IAAI,GAAG;cAAE0B,cAAc,EAAE;YAAE,CAAC,GAAG,IAAI,CAC3D;YAAAd,QAAA,eAEFnB,IAAA,CAACP,MAAM;cACL2B,KAAK,EAAES,MAAM,CAACK,WAAW,GAAGrB,MAAM,CAACsB,oBAAoB,GAAGtB,MAAM,CAACuB,eAAgB;cAAAjB,QAAA,EAEhFU,MAAM,CAACQ;YAAK,CACP;UAAC,GAhBJ,GAAGP,KAAK,IAAID,MAAM,CAACQ,KAAK,EAiBpB,CACZ,CAAC;QAAA,CACE,CAAC,eACPrC,IAAA,CAACT,SAAS;UAACwC,iBAAiB,EAAC,QAAQ;UAACT,OAAO,EAAEhB,OAAQ;UAACc,KAAK,EAAEP,MAAM,CAACyB,WAAY;UAAAnB,QAAA,eAEhFnB,IAAA,CAACc,QAAQ;YAAAK,QAAA,eACPnB,IAAA,CAACP,MAAM;cAAC2B,KAAK,EAAEP,MAAM,CAAC0B,eAAgB;cAAApB,QAAA,EAAEV;YAAW,CAAS;UAAC,CACrD;QAAC,CACF,CAAC;MAAA,CACR;IAAC,CACE;EAAC,CACL,CAAC;AAEd;AAEAL,WAAW,CAACoC,UAAU,GAAG5C,SAAS,CAAC6C,WAAW","ignoreList":[]}

package/lib/module/components/Alert.js

@@ -7,6 +7,8 @@
  * - RN では border を持たず bg subtle + text 色で表現（status token に border 用の中間色が無い、
  *   recipe description）。COLOR_ONLY_FORBIDDEN は title/message のテキストと icon slot で担保する設計。
  * - icon は ReactNode slot（EmptyState 前例。Icon を差すなら melta-app/icons を利用者が opt-in）。
+ * - × の accessibilityLabel は既定 "閉じる"（closeAccessibilityLabel で差し替え可能）。
+ *   当たり判定は正典パターン（24 + hitSlop 10 = 44pt）。
  * - a11y（§2 web→RN mapping）: web の role=alert(error/warning) / status(info/success) を、
  *   error/warning → accessibilityRole="alert"、info/success → accessibilityLiveRegion="polite"
  *   （Android のみ有効。RN に status role が無いための写像）に落とす。
@@ -20,7 +22,7 @@ import { Pressable, View } from "react-native";
 import { Text } from "../primitives/Text.js";
 import { useTheme } from "../theme/index.js";
 import { CONTRACTS } from "../contracts/contract-types.js";
-import { ALERT_SPEC, resolveAlertStyles } from "./alert.styles.js";
+import { ALERT_CLOSE_TAP_TARGET, ALERT_SPEC, resolveAlertStyles } from "./alert.styles.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 export function Alert({
   variant,
@@ -28,6 +30,7 @@ export function Alert({
   message,
   icon,
   onClose,
+  closeAccessibilityLabel = "閉じる",
   style,
   testID
 }) {
@@ -65,15 +68,15 @@ export function Alert({
       })]
     }), onClose != null &&
     /*#__PURE__*/
-    // 最小タップターゲット確保: min 24 + hitSlop（Tag removable と同じ手当て）。
+    // 最小タップターゲット確保: 正典パターン 24 + hitSlop 10 = 実効 44pt（Tag removable と同型）。
     _jsx(Pressable, {
       onPress: onClose,
       accessibilityRole: "button",
-      accessibilityLabel: "\u9589\u3058\u308B",
-      hitSlop: 10,
+      accessibilityLabel: closeAccessibilityLabel,
+      hitSlop: ALERT_CLOSE_TAP_TARGET.hitSlop,
       style: {
-        minWidth: 24,
-        minHeight: 24,
+        minWidth: ALERT_CLOSE_TAP_TARGET.minWidth,
+        minHeight: ALERT_CLOSE_TAP_TARGET.minHeight,
         alignItems: "center",
         justifyContent: "center"
       },
@@ -88,6 +91,7 @@ export function Alert({
   });
 }
 
-// Phase 2 conformance test 用の contract メタ（§2 A-3）。
+// conformance test 用の contract メタ（§2 A-3）。scripts/lib/conformance.test.ts が
+// 「この宣言が正しい contract を指しているか」を静的スキャンで照合する。
 Alert.__contract = CONTRACTS.alert;
 //# sourceMappingURL=Alert.js.map

package/lib/module/components/Alert.js.map

@@ -1 +1 @@
-{"version":3,"names":["useMemo","Pressable","View","Text","useTheme","CONTRACTS","ALERT_SPEC","resolveAlertStyles","jsx","_jsx","jsxs","_jsxs","Alert","variant","title","message","icon","onClose","style","testID","theme","mode","styles","urgent","accessibilityRole","undefined","accessibilityLiveRegion","containerStyle","children","flex","gap","spacing","titleFont","weight","titleWeight","color","titleStyle","messageFont","messageStyle","onPress","accessibilityLabel","hitSlop","minWidth","minHeight","alignItems","justifyContent","__contract","alert"],"sourceRoot":"../../../src","sources":["components/Alert.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,OAAO,QAAwB,OAAO;AAC/C,SAASC,SAAS,EAAEC,IAAI,QAAwC,cAAc;AAC9E,SAASC,IAAI,QAAQ,uBAAoB;AACzC,SAASC,QAAQ,QAAQ,mBAAU;AACnC,SAASC,SAAS,QAAQ,gCAA6B;AACvD,SAASC,UAAU,EAAEC,kBAAkB,QAA2B,mBAAgB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAiBnF,OAAO,SAASC,KAAKA,CAAC;EAAEC,OAAO;EAAEC,KAAK;EAAEC,OAAO;EAAEC,IAAI;EAAEC,OAAO;EAAEC,KAAK;EAAEC;AAAmB,CAAC,EAAE;EAC3F,MAAM;IAAEC,KAAK;IAAEC;EAAK,CAAC,GAAGjB,QAAQ,CAAC,CAAC;EAClC,MAAMkB,MAAM,GAAGtB,OAAO,CAAC,MAAMO,kBAAkB,CAACa,KAAK,EAAEC,IAAI,EAAER,OAAO,CAAC,EAAE,CAACO,KAAK,EAAEC,IAAI,EAAER,OAAO,CAAC,CAAC;EAC9F,MAAMU,MAAM,GAAGV,OAAO,KAAK,OAAO,IAAIA,OAAO,KAAK,SAAS;EAE3D,oBACEF,KAAA,CAACT,IAAI;IACHsB,iBAAiB,EAAED,MAAM,GAAG,OAAO,GAAGE,SAAU;IAChDC,uBAAuB,EAAEH,MAAM,GAAGE,SAAS,GAAG,QAAS;IACvDN,MAAM,EAAEA,MAAO;IACfD,KAAK,EAAE,CAACI,MAAM,CAACK,cAAc,EAAET,KAAK,CAAE;IAAAU,QAAA,GAErCZ,IAAI,IAAI,IAAI,iBAAIP,IAAA,CAACP,IAAI;MAAA0B,QAAA,EAAEZ;IAAI,CAAO,CAAC,eACpCL,KAAA,CAACT,IAAI;MAACgB,KAAK,EAAE;QAAEW,IAAI,EAAE,CAAC;QAAEC,GAAG,EAAEV,KAAK,CAACW,OAAO,CAAC,GAAG;MAAE,CAAE;MAAAH,QAAA,GAC/Cd,KAAK,IAAI,IAAI,iBACZL,IAAA,CAACN,IAAI;QACHU,OAAO,EAAEP,UAAU,CAAC0B,SAAU;QAC9BC,MAAM,EAAE3B,UAAU,CAAC4B,WAAY;QAC/BhB,KAAK,EAAE;UAAEiB,KAAK,EAAEb,MAAM,CAACc,UAAU,CAACD;QAAM,CAAE;QAAAP,QAAA,EAEzCd;MAAK,CACF,CACP,eACDL,IAAA,CAACN,IAAI;QAACU,OAAO,EAAEP,UAAU,CAAC+B,WAAY;QAACnB,KAAK,EAAE;UAAEiB,KAAK,EAAEb,MAAM,CAACgB,YAAY,CAACH;QAAM,CAAE;QAAAP,QAAA,EAChFb;MAAO,CACJ,CAAC;IAAA,CACH,CAAC,EACNE,OAAO,IAAI,IAAI;IAAA;IACd;IACAR,IAAA,CAACR,SAAS;MACRsC,OAAO,EAAEtB,OAAQ;MACjBO,iBAAiB,EAAC,QAAQ;MAC1BgB,kBAAkB,EAAC,oBAAK;MACxBC,OAAO,EAAE,EAAG;MACZvB,KAAK,EAAE;QAAEwB,QAAQ,EAAE,EAAE;QAAEC,SAAS,EAAE,EAAE;QAAEC,UAAU,EAAE,QAAQ;QAAEC,cAAc,EAAE;MAAS,CAAE;MAAAjB,QAAA,eAEvFnB,IAAA,CAACN,IAAI;QAACU,OAAO,EAAC,IAAI;QAACK,KAAK,EAAE;UAAEiB,KAAK,EAAEb,MAAM,CAACgB,YAAY,CAACH;QAAM,CAAE;QAAAP,QAAA,EAAC;MAEhE,CAAM;IAAC,CACE,CACZ;EAAA,CACG,CAAC;AAEX;;AAEA;AACAhB,KAAK,CAACkC,UAAU,GAAGzC,SAAS,CAAC0C,KAAK","ignoreList":[]}
+{"version":3,"names":["useMemo","Pressable","View","Text","useTheme","CONTRACTS","ALERT_CLOSE_TAP_TARGET","ALERT_SPEC","resolveAlertStyles","jsx","_jsx","jsxs","_jsxs","Alert","variant","title","message","icon","onClose","closeAccessibilityLabel","style","testID","theme","mode","styles","urgent","accessibilityRole","undefined","accessibilityLiveRegion","containerStyle","children","flex","gap","spacing","titleFont","weight","titleWeight","color","titleStyle","messageFont","messageStyle","onPress","accessibilityLabel","hitSlop","minWidth","minHeight","alignItems","justifyContent","__contract","alert"],"sourceRoot":"../../../src","sources":["components/Alert.tsx"],"mappings":"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","ignoreList":[]}