melta-app 0.2.3 → 0.4.0

package/LICENSE

@@ -1,6 +1,6 @@
-The MIT License (MIT)
+MIT License
 
-Copyright (c) 2015-present 650 Industries, Inc. (aka Expo)
+Copyright (c) 2026 tsubotax
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -36,6 +36,44 @@ export default function App() {
 
 テーマは `ThemeProvider` が OS の light / dark に自動追従（`forcedMode` で固定も可）。トークンは `useTheme()` / `nativeTheme` から取れる。Icon だけは subpath（[後述](#icon-だけ-subpath-エントリmelta-appicons)）。
 
+### ブランドテーマを注入する
+
+`theme` を渡すと自分のブランドトークンで塗り替わる。未指定なら melta 既定（`nativeTheme`）。
+
+```tsx
+import { defineTheme, ThemeProvider } from "melta-app";
+
+// module スコープで1回だけ組み立てる（render 中に作ると毎レンダー参照が変わり全体が再レンダーする）
+const theme = defineTheme({
+  id: "acme",
+  color: { /* primary / body / semantic / status */ },
+  typography: { /* … */ },
+  spacing: { /* … */ }, radius: { /* … */ },
+  elevation: { /* … */ }, motion: { /* … */ }, zIndex: { /* … */ },
+});
+
+export default function App() {
+  return <ThemeProvider theme={theme}>{/* … */}</ThemeProvider>;
+}
+```
+
+**単一の配色しか持たないブランド**（例: dark しか作らない）は、持っていない mode を **書かない**。
+
+```tsx
+const theme = defineTheme({
+  id: "acme",
+  color: { /* … */ semantic: { dark: darkColors } },  // light は書かない
+  /* … */
+});
+```
+
+- `useTheme().capabilities.colorScheme` が `"single-dark"` として導出される（宣言する欄は無い。`color.semantic` のキー集合がそのまま能力になる）
+- OS が light を返しても **dark で描画する**（警告は出さない。light を作らないのは設計判断で、OS 設定は事故ではない）
+- `forcedMode="light"` のように**対応していない mode を明示指定**した場合も描画は止めず clamp するが、開発時は `console.error` で1回報告する。light/dark トグル UI を出すなら `capabilities.colorScheme` を見て出し分けること
+- `theme.color.semantic.light` を直接読むと、原因を名指しするエラーで落ちる（値を捏造して静かに間違った色を返すことはしない）。現在 mode の色は `useTheme().colors` から取る
+
+> 現状 `color.primary` / `text-accent` / `elevation` / status の light 値は、単一 dark のテーマでも**必須のまま**。省略できるのは `color.semantic` の mode だけで、他の軸を「持たない」と宣言する仕組みは後続で入れる。
+
 ## 設計の核
 
 - **契約は共有、実装は各最適**: tokens / 禁止ルール / component 契約は `melta-contracts`（JSON）が SSOT。melta-app に token は持たない（二重化を物理防止）。
@@ -219,6 +257,7 @@ enableSafeAreaContext({ edges: ["top"] });
   - 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 変換先の受け皿
 - ✅ showcase（https://app.melta.tsubotax.com — melta-ui 様式シェル + 実 RN カタログの Live 埋め込み。表・統計は契約からビルド時生成）
+- ✅ AI 入口: [llms.txt](https://app.melta.tsubotax.com/llms.txt)（契約から生成・drift 検査対象）+ [docs/patterns.md](docs/patterns.md)（フォームの組み方規範。スニペットは実コードと機械同期）
 - ✅ [npm publish（0.1.0）](https://www.npmjs.com/package/melta-app)
 - ⬜ React Native Directory 登録（[PR #2606](https://github.com/react-native-community/directory/pull/2606) レビュー待ち）
 

package/docs/patterns.md

@@ -0,0 +1,263 @@
+# melta-app Form Patterns（フォームの組み方）
+
+> フォーム構成の規範 + コピペ可能スニペット。スニペットは example/screens/FormValidationScreen.tsx
+> からの抜粋で、`npm run check:drift` が実コードとの一致を機械検査する（手で fence を編集しない。
+> 実装を変えたら fence を実装に合わせる）。web 版の規範は melta-ui patterns/form.md。
+
+## 1. 原則
+
+フォームは「入力者を信頼し、間違えたときだけ静かに助ける」方向で組む。melta-app の公開 API だけで成立する形を規範とし、form ライブラリは前提にしない。
+
+| 原則 | 理由 |
+|---|---|
+| フィールドは縦積み（`Stack gap="4"`） | モバイル幅で横並びフィールドは折返し事故の温床。1 カラムが読む順序 = 入力順序になる |
+| ラベルは入力欄の上 | `TextField` の `label`（必須 prop）が構造で強制する。placeholder をラベル代わりにしない |
+| エラーはフィールド直下 | `errorText` / `Radio.error` が描画位置を固定する。離れた場所のサマリーだけに頼らない |
+| 主要アクションは full-width | モバイルでは web の右寄せボタンを持ち込まない。`Stack` 直下の `Button` は stretch される |
+| フォーム全体は `Stack gap="4"` | フィールド間隔はトークン経由。raw spacing は lint が落とす |
+
+## 2. 検証タイミング — blur で検証し、change で赦し、submit で全量
+
+1. **blur で初回検証**（touched フラグを立てる）— 入力途中に叱らない。
+2. **エラー表示中は change で即時再評価** — errors は values からの `useMemo` 導出なので、修正した瞬間にエラーが消える（punish late, reward early）。
+3. **submit で全量検証** — `submitAttempted` を立てて未 touch フィールドのエラーも表示し、フォームレベルのサマリーを Alert で出す。
+4. **送信ボタンは disable しない** — 「なぜ押せないか」を伝えられないため。二重送信だけ `loading` で防ぎ、**送信中は全フィールドを `disabled={submitting}` でロックする**（後出し編集で成功表示が嘘になるのを防ぐ）。編集が再開されたら前回の成功表示は破棄する（`setField` に集約）。
+5. **エラーはスクリーンリーダーにも伝える** — TextField / Radio の errorText は liveRegion（Android）+ accessibilityLabel 合成（再フォーカス時読み上げ）を内蔵。submit 失敗のサマリーは `AccessibilityInfo.announceForAccessibility` で iOS にも通知する（スニペット参照）。
+5. **エラーの自動非表示はしない** — 修正されるまで表示し続ける（web 版 form.md の禁止パターンと同一規範）。
+
+検証は state に持たず、values からの pure function 導出にする。これが規範 2 を無料にする。
+
+<!-- snippet:validators source=example/screens/FormValidationScreen.tsx -->
+```tsx
+interface FormValues {
+  name: string;
+  email: string;
+  capacity: string; // TextInput は文字列で保持し、検証時に数値解釈する
+  visibility: string | undefined; // Radio 未選択は undefined
+  notifyOnDone: boolean;
+  agreed: boolean;
+}
+
+type FieldKey = "name" | "email" | "capacity" | "visibility" | "agreed";
+type FieldErrors = Partial<Record<FieldKey, string>>;
+
+// 軽量ヒューリスティック（RFC 完全準拠はしない）。正規化 + サーバー側検証を前提にする
+const EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+/** 全フィールドの検証（pure）。エラーが無いフィールドはキーごと持たない。 */
+function validate(values: FormValues): FieldErrors {
+  const errors: FieldErrors = {};
+  if (values.name.trim() === "") errors.name = "プロジェクト名を入力してください";
+  const email = values.email.trim(); // 前後空白は入力ミス扱いせず、正規化してから判定する
+  if (email === "") errors.email = "通知先メールアドレスを入力してください";
+  else if (!EMAIL_RE.test(email)) errors.email = "メールアドレスの形式が正しくありません";
+  const capacity = values.capacity.trim();
+  if (capacity === "") errors.capacity = "定員を入力してください";
+  // number-pad は paste・物理キーボードを制約しないので digits-only を正面から検査する
+  // （Number() 変換だけだと "1e1" や "0x10" が通ってしまう）
+  else if (!/^\d+$/.test(capacity) || Number(capacity) < 1 || Number(capacity) > 99)
+    errors.capacity = "定員は 1〜99 の整数で入力してください";
+  if (values.visibility == null) errors.visibility = "公開範囲を選択してください";
+  if (!values.agreed) errors.agreed = "利用規約への同意が必要です";
+  return errors;
+}
+```
+
+フィールド側は `onBlur` で touched を立て、`shownError(key)`（blur 済み or 送信試行後だけエラーを返す）で表示を制御する。「通った」ことを積極的に伝えたいフィールド（この見本ではメールアドレスのみ）は、valid かつ touched のとき `variant="success"` にする — 全フィールドに付ける必要はない。`helperText` と `errorText` は排他表示（TextField が内部で制御）。
+
+<!-- snippet:field-blur source=example/screens/FormValidationScreen.tsx -->
+```tsx
+<TextField
+  label="プロジェクト名（必須）"
+  value={values.name}
+  onChangeText={(text) => setField("name", text)}
+  placeholder="例: 道東撮影プロジェクト"
+  variant={shownError("name") != null ? "error" : "default"}
+  errorText={shownError("name")}
+  onBlur={() => touch("name")}
+  disabled={submitting}
+/>
+<TextField
+  label="通知先メールアドレス（必須）"
+  value={values.email}
+  onChangeText={(text) => setField("email", text)}
+  placeholder="user@example.com"
+  keyboardType="email-address"
+  autoCapitalize="none"
+  autoCorrect={false}
+  variant={
+    shownError("email") != null
+      ? "error"
+      : touched.email === true && errors.email == null && values.email !== ""
+        ? "success"
+        : "default"
+  }
+  helperText="進捗の通知に使う。プロフィールには表示されない"
+  errorText={shownError("email")}
+  onBlur={() => touch("email")}
+  disabled={submitting}
+/>
+```
+
+## 3. required の示し方
+
+label 文字列に「（必須）」「（任意）」を明記する。web の赤アスタリスクは RN の `label: string` では表現できず、スクリーンリーダーの読み上げでも意味を成さないため、文字で書く。色だけの必須表示は禁止。任意フィールドが少数派なら「（任意）」だけを付ける形でもよいが、1 フォーム内で流儀を混ぜない。
+
+## 4. エラーの伝え方（FORM_NO_COLOR_ONLY_ERROR）
+
+色だけでエラーを伝えない。コンポーネントごとにテキスト表示の経路が違う:
+
+| コンポーネント | エラー表示 |
+|---|---|
+| `TextField` | `variant="error"` + `errorText`（テキスト必須） |
+| `Radio` | `error?: string` — 枠色 + メッセージ表示まで内蔵 |
+| `Checkbox` | `error: boolean` のみ — **隣接 `Text` で文言を必ず併記**（errorText prop は無い） |
+| フォームレベル | `Alert variant="error"`（サマリー）/ 成功は `variant="success"` |
+
+エラーの自動非表示（数秒で消す等）は禁止。修正されるまで表示する。
+
+<!-- snippet:choice-errors source=example/screens/FormValidationScreen.tsx -->
+```tsx
+<Radio
+  label="公開範囲（必須）"
+  options={VISIBILITY_OPTIONS}
+  value={values.visibility}
+  onChange={(value) => setField("visibility", value)}
+  error={shownError("visibility")}
+  disabled={submitting}
+/>
+<Toggle
+  value={values.notifyOnDone}
+  onValueChange={(value) => setField("notifyOnDone", value)}
+  label="完了時に通知する（任意）"
+  disabled={submitting}
+/>
+<Stack gap="1">
+  <Checkbox
+    label="利用規約に同意する（必須）"
+    checked={values.agreed}
+    onChange={(checked) => setField("agreed", checked)}
+    error={shownError("agreed") != null}
+    disabled={submitting}
+  />
+  {/* Checkbox は errorText を持たないため、隣接 Text で必ず文言でも伝える
+      （FORM_NO_COLOR_ONLY_ERROR = 色だけで伝えない）。View の liveRegion で
+      出現も通知する（melta Text は a11y props を透過しない） */}
+  {shownError("agreed") != null && (
+    <View accessibilityLiveRegion="polite">
+      <Text variant="xs" style={{ color: theme.color.status.danger.base }}>
+        {shownError("agreed")}
+      </Text>
+    </View>
+  )}
+</Stack>
+```
+
+## 5. keyboardType の選び方
+
+入力内容に合ったキーボードを必ず指定する（`default` のまま数値やメールを打たせない）:
+
+| 用途 | keyboardType | 併用 |
+|---|---|---|
+| 自由テキスト | `default` | — |
+| メール | `email-address` | `autoCapitalize="none"` `autoCorrect={false}` |
+| 整数（個数・回数） | `number-pad` | 値は string で保持し検証で数値化 |
+| 小数（距離・金額） | `decimal-pad` | 同上 |
+| 電話番号 | `phone-pad` | — |
+
+※ `TextField` が RN `TextInput` へ透過するのは入力メソッド系 props（`keyboardType` / `autoCapitalize` / `autoCorrect` / `maxLength` / `returnKeyType` / `onSubmitEditing` / `onBlur` / `onFocus`）のみ。style 系 props は透過しない（token 純度維持）。
+
+## 6. キーボード回避
+
+現行公開 API での正攻法は **`KeyboardAvoidingView`（iOS のみ `behavior="padding"`）+ `Screen variant="fixed" padding="none"` + 自前 `ScrollView`** の組み合わせ。`Screen variant="scroll"` は `keyboardShouldPersistTaps` を公開していないため、キーボード表示中の送信ボタンが 1 タップ目で反応しない（タップがキーボード dismiss に食われる）。フォーム画面では自前 ScrollView に `keyboardShouldPersistTaps="handled"` を必ず付ける。padding は `theme.spacing` から取る（raw 値は lint が落とす）。
+
+<!-- snippet:keyboard-shell source=example/screens/FormValidationScreen.tsx -->
+```tsx
+export function FormValidationScreen() {
+  const { theme } = useTheme();
+  return (
+    <KeyboardAvoidingView
+      style={{ flex: 1 }}
+      behavior={Platform.OS === "ios" ? "padding" : undefined}
+    >
+      {/* Screen(variant="scroll") は keyboardShouldPersistTaps を公開していないため、
+          フォーム画面は fixed + 自前 ScrollView で組む。"handled" にしないと
+          キーボード表示中の送信ボタンが 1 タップ目で反応しない（dismiss に食われる） */}
+      <Screen variant="fixed" padding="none" header={<Header title="新規プロジェクト" />}>
+        <ScrollView
+          contentContainerStyle={{ padding: theme.spacing["4"] }}
+          keyboardShouldPersistTaps="handled"
+        >
+          <FormValidationForm />
+        </ScrollView>
+      </Screen>
+    </KeyboardAvoidingView>
+  );
+}
+```
+
+## 7. 送信ボタンの制御
+
+送信ボタンは**常時活性**にする。disabled-until-valid は「なぜ押せないか」を伝えられず、a11y 的にも不利。押下時に全量検証してサマリー Alert で理由を見せる方が誠実。二重送信だけ `Button` の `loading`（Spinner + disabled 相当）で防ぐ。
+
+<!-- snippet:submit-handler source=example/screens/FormValidationScreen.tsx -->
+```tsx
+const handleSubmit = () => {
+  setSubmitAttempted(true); // 以後は未 blur フィールドのエラーも表示する
+  if (Object.keys(errors).length > 0) {
+    // 視覚はサマリー Alert(variant="error")。liveRegion の無い iOS にも announce で伝える
+    AccessibilityInfo.announceForAccessibility("入力内容を確認してください");
+    return;
+  }
+  setSubmitted(false);
+  setSubmitting(true); // 送信中は全フィールドを disabled にする（後出し編集で成功表示が嘘になるのを防ぐ）
+  // 実アプリではここで API 呼び出し。見本ではダミー遅延で loading を見せる
+  setTimeout(() => {
+    setSubmitting(false);
+    setSubmitted(true);
+  }, 800);
+};
+```
+
+<!-- snippet:submit-button source=example/screens/FormValidationScreen.tsx -->
+```tsx
+{submitAttempted && Object.keys(errors).length > 0 && (
+  <Alert
+    variant="error"
+    title="入力内容を確認してください"
+    message={Object.values(errors).join("\n")}
+  />
+)}
+{submitted && (
+  <Alert
+    variant="success"
+    message="プロジェクトを作成しました"
+    onClose={() => setSubmitted(false)}
+  />
+)}
+{/* 送信は常時活性（なぜ押せないかを伝えられない disabled-until-valid にしない）。
+    二重送信だけ loading で防ぐ */}
+<Button label="プロジェクトを作成" onPress={handleSubmit} loading={submitting} />
+```
+
+## 8. state 設計の最小形
+
+form ライブラリを DS として強制しない。素の React で必要十分な最小形:
+
+- state は 5 つ: `values` / `touched: Partial<Record<FieldKey, boolean>>` / `submitAttempted` / `submitting` / `submitted`
+- `errors = useMemo(() => validate(values), [values])` — 検証結果は state に持たず、values からの純導出にする（エラー中の修正が即座に画面へ反映される）
+- `shownError(key) = (touched[key] || submitAttempted) ? errors[key] : undefined` — 表示制御はこの 1 関数に集約
+- 数値入力も `TextInput` の値は string で保持し、検証・送信時に数値解釈する
+
+プロジェクト側で form ライブラリを使うのは自由だが、このパターン文書とカタログ見本は素の React を正とする。
+
+## 9. 禁止パターン
+
+| 禁止 | 理由 / 代替 |
+|---|---|
+| ラベル省略 | `TextField` は `label` 必須で型的に不可能。他コンポーネントでも省略しない |
+| 色だけのエラー表示 | FORM_NO_COLOR_ONLY_ERROR。必ずテキストを併記（§4 の対応表） |
+| エラーの自動非表示 | 修正されるまで表示する。トースト等で数秒だけ見せるのは不可 |
+| disabled-until-valid の常用 | 「なぜ押せないか」を伝えられない。常時活性 + submit 時全量検証 + サマリー Alert |
+| placeholder をラベル代わりにする | 入力を始めた瞬間に文脈が消える。placeholder は例示専用 |
+| 生値スタイル（hex / 数値 spacing 直書き） | lint（--max-warnings 0）が落とす。`theme.color.*` / `theme.spacing[*]` 経由のみ |

package/lib/module/components/Radio.js

@@ -118,13 +118,17 @@ export function Radio({
     }), hasError ?
     /*#__PURE__*/
     // danger.text-light は SemanticColors 外なので style で上書き（Button の textColor と同じ扱い）。
-    _jsx(Text, {
-      variant: "xs",
-      style: {
-        color: group.errorTextStyle.color,
-        marginTop: group.errorTextStyle.marginTop
-      },
-      children: error
+    // View の liveRegion で出現を通知（melta Text は a11y props を透過しないため）。
+    _jsx(View, {
+      accessibilityLiveRegion: "polite",
+      children: /*#__PURE__*/_jsx(Text, {
+        variant: "xs",
+        style: {
+          color: group.errorTextStyle.color,
+          marginTop: group.errorTextStyle.marginTop
+        },
+        children: error
+      })
     }) : null]
   });
 }

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

@@ -1 +1 @@
-{"version":3,"names":["useMemo","Pressable","View","Text","useTheme","CONTRACTS","RADIO_SPEC","resolveRadioCircleStyle","resolveRadioGroupStyle","jsx","_jsx","jsxs","_jsxs","Radio","label","options","value","onChange","variant","error","disabled","testID","theme","mode","hasError","group","circles","unselected","selected","style","opacity","disabledOpacity","undefined","children","weight","color","marginBottom","groupLabelStyle","accessibilityRole","containerStyle","map","option","optionDisabled","onPress","accessibilityState","checked","accessibilityLabel","cardStyle","cardSelectedStyle","flexDirection","alignItems","description","gap","optionGap","dotStyle","flexShrink","errorTextStyle","marginTop","__contract","radio"],"sourceRoot":"../../../src","sources":["components/Radio.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useMemo","Pressable","View","Text","useTheme","CONTRACTS","RADIO_SPEC","resolveRadioCircleStyle","resolveRadioGroupStyle","jsx","_jsx","jsxs","_jsxs","Radio","label","options","value","onChange","variant","error","disabled","testID","theme","mode","hasError","group","circles","unselected","selected","style","opacity","disabledOpacity","undefined","children","weight","color","marginBottom","groupLabelStyle","accessibilityRole","containerStyle","map","option","optionDisabled","onPress","accessibilityState","checked","accessibilityLabel","cardStyle","cardSelectedStyle","flexDirection","alignItems","description","gap","optionGap","dotStyle","flexShrink","accessibilityLiveRegion","errorTextStyle","marginTop","__contract","radio"],"sourceRoot":"../../../src","sources":["components/Radio.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/TextField.js

@@ -7,11 +7,18 @@
  * - variant は検証状態（default/error/success）。disabled=true で variant を "disabled" に上書きし、
  *   editable=false + accessibilityState.disabled を併せて適用する（recipe description の規約）。
  * - error 時は errorText を必ずテキストで表示する（FORM_NO_COLOR_ONLY_ERROR = 色だけで伝えない）。
- *   RN には aria-describedby 相当が無いため、accessibilityState ではなく Text の実表示で伝える。
+ *   RN には aria-describedby 相当が無いため、(a) errorText を input の accessibilityLabel に合成
+ *   （再フォーカス時に読み上げ）、(b) errorText 側に accessibilityLiveRegion="polite"（Android は
+ *   出現時に通知。iOS の即時通知が要る画面は submit 時に announceForAccessibility を併用する —
+ *   docs/patterns.md 参照）。
  * - focus は内部 state（onFocus/onBlur）で recipe states.focus の inputStyle 差分
- *   （borderColor=primary.500）を重ねる。disabled 時は focus させない。
+ *   （borderColor=primary.500）を重ねる。disabled 時は focus スタイルを付けない。
+ *   外部の onFocus/onBlur は RN の event ごと常に透過する（内部の視覚 state と分離）。
  * - 色・寸法の決定は pure resolver（textfield.styles.ts）に分離。
  *   recipes/app/textfield.recipe.json との機械照合は scripts/lib/textfield-conformance.test.ts が行う。
+ * - RN TextInput へ透過するのは入力メソッド系 props（keyboardType / autoCapitalize / autoCorrect /
+ *   maxLength / returnKeyType / onSubmitEditing / onBlur / onFocus）のみ。style 系 props は
+ *   透過しない（token 純度維持）。
  */
 
 import { useMemo, useState } from "react";
@@ -57,6 +64,14 @@ export function TextField({
   size = "medium",
   helperText,
   errorText,
+  keyboardType,
+  autoCapitalize,
+  autoCorrect,
+  maxLength,
+  returnKeyType,
+  onSubmitEditing,
+  onBlur,
+  onFocus,
   style,
   testID
 }) {
@@ -87,19 +102,30 @@ export function TextField({
       placeholder: placeholder,
       placeholderTextColor: colors["text-muted"],
       editable: !disabled,
-      accessibilityLabel: label,
+      keyboardType: keyboardType,
+      autoCapitalize: autoCapitalize,
+      autoCorrect: autoCorrect,
+      maxLength: maxLength,
+      returnKeyType: returnKeyType,
+      onSubmitEditing: onSubmitEditing,
+      accessibilityLabel: showError ? `${label}。エラー: ${errorText}` : label,
       accessibilityState: {
         disabled
       },
-      onFocus: () => {
+      onFocus: e => {
         if (!disabled) setFocused(true);
+        onFocus?.(e);
+      },
+      onBlur: e => {
+        setFocused(false);
+        onBlur?.(e);
       },
-      onBlur: () => setFocused(false),
       style: [resolved.input, INPUT_VERTICAL_FIX, focused && !disabled ? focusStyle : null]
     }), helperText != null && !showError && /*#__PURE__*/_jsx(RNText, {
       style: resolved.helperText,
       children: helperText
     }), showError && /*#__PURE__*/_jsx(RNText, {
+      accessibilityLiveRegion: "polite",
       style: resolved.errorText,
       children: errorText
     })]

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

@@ -1 +1 @@
-{"version":3,"names":["useMemo","useState","Platform","TextInput","View","Text","RNText","useTheme","CONTRACTS","resolveTextFieldStyle","resolveTextFieldFocusStyle","jsx","_jsx","jsxs","_jsxs","resolveInputVerticalFix","os","paddingVertical","paddingBottom","textAlignVertical","INPUT_VERTICAL_FIX","OS","TextField","label","value","onChangeText","placeholder","variant","disabled","size","helperText","errorText","style","testID","theme","mode","colors","focused","setFocused","effectiveVariant","resolved","focusStyle","showError","children","placeholderTextColor","editable","accessibilityLabel","accessibilityState","onFocus","onBlur","input","__contract","textfield"],"sourceRoot":"../../../src","sources":["components/TextField.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useMemo","useState","Platform","TextInput","View","Text","RNText","useTheme","CONTRACTS","resolveTextFieldStyle","resolveTextFieldFocusStyle","jsx","_jsx","jsxs","_jsxs","resolveInputVerticalFix","os","paddingVertical","paddingBottom","textAlignVertical","INPUT_VERTICAL_FIX","OS","TextField","label","value","onChangeText","placeholder","variant","disabled","size","helperText","errorText","keyboardType","autoCapitalize","autoCorrect","maxLength","returnKeyType","onSubmitEditing","onBlur","onFocus","style","testID","theme","mode","colors","focused","setFocused","effectiveVariant","resolved","focusStyle","showError","children","placeholderTextColor","editable","accessibilityLabel","accessibilityState","e","input","accessibilityLiveRegion","__contract","textfield"],"sourceRoot":"../../../src","sources":["components/TextField.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/safe-area/index.js

@@ -17,13 +17,17 @@
  * Provider の context 値を render 中に同期参照して padding を付けるため、native
  * SafeAreaView の layout/state 更新を待たず、初回 render から inset が反映される。
  *
- * ⚠️ 前提: アプリの root に SafeAreaProvider が必要。初回 render から正しい inset を
- * 使うには Provider に initialMetrics も渡す。React Navigation / Expo Router 利用時は
- * Provider が設置済みのことが多い。
+ * ⚠️ 前提: アプリの root に SafeAreaProvider が必要（無いと useSafeAreaInsets が throw
+ * する）。初回 render から正しい inset を使うには Provider に initialMetrics も渡す。
+ * React Navigation / Expo Router 利用時は Provider が設置済みのことが多い。
+ *
+ * ⚠️ 公開契約: safe-area と合成する padding は数値のみサポート。"5%" 等の非数値は
+ * 基底値として扱えず、対象 edge の padding は inset 値に置き換わる（RNSAC native も
+ * percentage padding 未サポートのため、より弱い保証を契約化はしない）。
  */
 
 import { createElement, useMemo } from "react";
-import { StyleSheet, View } from "react-native";
+import { I18nManager, StyleSheet, View } from "react-native";
 import { useSafeAreaInsets } from "react-native-safe-area-context";
 import { setSafeAreaView } from "../components/safe-area-registry.js";
 const ALL_EDGES = ["top", "right", "bottom", "left"];
@@ -32,26 +36,27 @@ const ALL_EDGES = ["top", "right", "bottom", "left"];
 
 function additivePadding(style, insets, edges) {
   const flat = StyleSheet.flatten(style) ?? {};
-  const base = edge => {
-    const edgeValue = flat[`padding${edge[0].toUpperCase()}${edge.slice(1)}`];
-    const axisValue = edge === "top" || edge === "bottom" ? flat.paddingVertical : flat.paddingHorizontal;
-    const value = edgeValue ?? axisValue ?? flat.padding;
-    return typeof value === "number" ? value : 0;
-  };
-  return {
-    ...(edges.has("top") ? {
-      paddingTop: base("top") + insets.top
-    } : null),
-    ...(edges.has("right") ? {
-      paddingRight: base("right") + insets.right
-    } : null),
-    ...(edges.has("bottom") ? {
-      paddingBottom: base("bottom") + insets.bottom
-    } : null),
-    ...(edges.has("left") ? {
-      paddingLeft: base("left") + insets.left
-    } : null)
-  };
+  const num = value => typeof value === "number" ? value : null;
+
+  // 基底 padding の解決は Yoga の優先順位（論理 > 物理 > 軸 > 全体）に合わせる。
+  // 論理キー（paddingStart/End）を読まないと、基底が論理指定のとき取りこぼす。
+  const isRTL = I18nManager.isRTL;
+  const baseVertical = edge => num(edge === "top" ? flat.paddingTop : flat.paddingBottom) ?? num(flat.paddingVertical) ?? num(flat.padding) ?? 0;
+  const baseHorizontal = edge => num(flat[edge === "left" === !isRTL ? "paddingStart" : "paddingEnd"]) ?? num(edge === "left" ? flat.paddingLeft : flat.paddingRight) ?? num(flat.paddingHorizontal) ?? num(flat.padding) ?? 0;
+
+  // 水平方向は論理キーで出力する。物理キー（paddingLeft/Right）で上書きすると、
+  // 基底 style 側に paddingStart/End があるとき論理キーが Yoga 上で勝ち、
+  // inset の加算結果ごと無視されるため。
+  const out = {};
+  if (edges.has("top")) out.paddingTop = baseVertical("top") + insets.top;
+  if (edges.has("bottom")) out.paddingBottom = baseVertical("bottom") + insets.bottom;
+  if (edges.has("left")) {
+    out[isRTL ? "paddingEnd" : "paddingStart"] = baseHorizontal("left") + insets.left;
+  }
+  if (edges.has("right")) {
+    out[isRTL ? "paddingStart" : "paddingEnd"] = baseHorizontal("right") + insets.right;
+  }
+  return out;
 }
 function createContextSafeAreaView(selectedEdges) {
   const edges = new Set(selectedEdges);

package/lib/module/safe-area/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["createElement","useMemo","StyleSheet","View","useSafeAreaInsets","setSafeAreaView","ALL_EDGES","additivePadding","style","insets","edges","flat","flatten","base","edge","edgeValue","toUpperCase","slice","axisValue","paddingVertical","paddingHorizontal","value","padding","has","paddingTop","top","paddingRight","right","paddingBottom","bottom","paddingLeft","left","createContextSafeAreaView","selectedEdges","Set","ContextSafeAreaView","props","paddingStyle","displayName","enableSafeAreaContext","options"],"sourceRoot":"../../../src","sources":["safe-area/index.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["createElement","useMemo","I18nManager","StyleSheet","View","useSafeAreaInsets","setSafeAreaView","ALL_EDGES","additivePadding","style","insets","edges","flat","flatten","num","value","isRTL","baseVertical","edge","paddingTop","paddingBottom","paddingVertical","padding","baseHorizontal","paddingLeft","paddingRight","paddingHorizontal","out","has","top","bottom","left","right","createContextSafeAreaView","selectedEdges","Set","ContextSafeAreaView","props","paddingStyle","displayName","enableSafeAreaContext","options"],"sourceRoot":"../../../src","sources":["safe-area/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/theme/ThemeProvider.js

@@ -8,24 +8,63 @@
  * useColorScheme() を Provider 内で1回だけ読む（RN コア、追加依存なし）。
  *
  * context value は useMemo 必須（§3）: 毎レンダで新オブジェクトを配ると全 consumer が再レンダする。
+ *
+ * theme 注入（Step 2-①）: `theme` を渡すと消費者ブランドの theme で塗り替わる。未指定なら
+ * 従来どおり codegen 済みの `nativeTheme`（＝既存消費者に破壊的変更なし）。渡せるのは
+ * `defineTheme()` の戻り値だけ（define-theme.ts 参照）。
  */
 
 import { createContext, useContext, useMemo } from "react";
 import { useColorScheme } from "react-native";
 import { nativeTheme } from "./native-theme.js";
+import { defineTheme, isDev, resolveMode } from "./define-theme.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 const ThemeContext = /*#__PURE__*/createContext(null);
+
+/** 既定 theme。melta-contracts 由来の codegen 結果を注入経路と同じ形に通す（自分でも dogfood する）。 */
+const DEFAULT_THEME = defineTheme({
+  ...nativeTheme,
+  id: "melta"
+});
+
+/** 同じ矛盾を毎レンダー報告しないためのラッチ（StrictMode の二重 render も1回に畳む）。 */
+const reportedViolations = new Set();
+function reportViolation(themeId, violation) {
+  const key = `${themeId ?? "(id 未設定)"}:${violation.requested}`;
+  if (reportedViolations.has(key)) return;
+  reportedViolations.add(key);
+  console.error(`melta: forcedMode="${violation.requested}" が指定されたが、この theme は ` + `colorScheme=${violation.colorScheme} なので "${violation.resolved}" で描画する。` + `useTheme().capabilities.colorScheme を見て、対応していない mode は UI 側で出さないこと。`);
+}
 export function ThemeProvider({
   children,
-  forcedMode
+  forcedMode,
+  theme
 }) {
   const system = useColorScheme();
-  const mode = forcedMode ?? (system === "dark" ? "dark" : "light");
-  const value = useMemo(() => ({
-    theme: nativeTheme,
+  const activeTheme = theme ?? DEFAULT_THEME;
+  const {
     mode,
-    colors: nativeTheme.color.semantic[mode]
-  }), [mode]);
+    violation
+  } = resolveMode(activeTheme.capabilities.colorScheme, forcedMode, system === "dark" ? "dark" : "light");
+  if (isDev && violation) reportViolation(activeTheme.id, violation);
+  const value = useMemo(() => {
+    const colors = activeTheme.color.semantic[mode];
+    if (!colors) {
+      // resolveMode が capability に従って選んだ mode なので、ここに来るのは theme が壊れている場合だけ。
+      // 色が undefined のまま下流に流れると全 component が別々の場所で死ぬので、ここで落とす。
+      throw new Error(`melta: theme "${activeTheme.id ?? "(id 未設定)"}" に mode="${mode}" の semantic 色が無い。`);
+    }
+    return {
+      // 配布時の型は NativeTheme のまま（既存の全 style resolver の署名を維持するため）。
+      // 単一 colorScheme の theme では持たない mode のキーが実体に無く、型が実体より広い。
+      // 到達しうる読みは resolveMode が保証した現在 mode だけで、他 mode を直接読んだ場合は
+      // define-theme.ts の guard getter が原因を名指しして落とす。
+      theme: activeTheme,
+      mode,
+      colors,
+      capabilities: activeTheme.capabilities
+    };
+  }, [activeTheme, mode]);
   return /*#__PURE__*/_jsx(ThemeContext.Provider, {
     value: value,
     children: children