melta-app 0.3.0 → 0.4.1

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 は持たない（二重化を物理防止）。

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

package/lib/module/theme/ThemeProvider.js.map

@@ -1 +1 @@
-{"version":3,"names":["createContext","useContext","useMemo","useColorScheme","nativeTheme","jsx","_jsx","ThemeContext","ThemeProvider","children","forcedMode","system","mode","value","theme","colors","color","semantic","Provider","useTheme","ctx","Error"],"sourceRoot":"../../../src","sources":["theme/ThemeProvider.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAwB,OAAO;AAC1E,SAASC,cAAc,QAAQ,cAAc;AAC7C,SAASC,WAAW,QAAQ,mBAAgB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAc7C,MAAMC,YAAY,gBAAGP,aAAa,CAA2B,IAAI,CAAC;AAWlE,OAAO,SAASQ,aAAaA,CAAC;EAAEC,QAAQ;EAAEC;AAA+B,CAAC,EAAE;EAC1E,MAAMC,MAAM,GAAGR,cAAc,CAAC,CAAC;EAC/B,MAAMS,IAAe,GAAGF,UAAU,KAAKC,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;EAE5E,MAAME,KAAK,GAAGX,OAAO,CACnB,OAAO;IACLY,KAAK,EAAEV,WAAW;IAClBQ,IAAI;IACJG,MAAM,EAAEX,WAAW,CAACY,KAAK,CAACC,QAAQ,CAACL,IAAI;EACzC,CAAC,CAAC,EACF,CAACA,IAAI,CACP,CAAC;EAED,oBAAON,IAAA,CAACC,YAAY,CAACW,QAAQ;IAACL,KAAK,EAAEA,KAAM;IAAAJ,QAAA,EAAEA;EAAQ,CAAwB,CAAC;AAChF;AAEA,OAAO,SAASU,QAAQA,CAAA,EAAsB;EAC5C,MAAMC,GAAG,GAAGnB,UAAU,CAACM,YAAY,CAAC;EACpC,IAAI,CAACa,GAAG,EAAE;IACR,MAAM,IAAIC,KAAK,CAAC,yCAAyC,CAAC;EAC5D;EACA,OAAOD,GAAG;AACZ","ignoreList":[]}
+{"version":3,"names":["createContext","useContext","useMemo","useColorScheme","nativeTheme","defineTheme","isDev","resolveMode","jsx","_jsx","ThemeContext","DEFAULT_THEME","id","reportedViolations","Set","reportViolation","themeId","violation","key","requested","has","add","console","error","colorScheme","resolved","ThemeProvider","children","forcedMode","theme","system","activeTheme","mode","capabilities","value","colors","color","semantic","Error","Provider","useTheme","ctx"],"sourceRoot":"../../../src","sources":["theme/ThemeProvider.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAwB,OAAO;AAC1E,SAASC,cAAc,QAAQ,cAAc;AAC7C,SAASC,WAAW,QAAQ,mBAAgB;AAC5C,SAASC,WAAW,EAAEC,KAAK,EAAEC,WAAW,QAAsF,mBAAgB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAsB/I,MAAMC,YAAY,gBAAGV,aAAa,CAA2B,IAAI,CAAC;;AAElE;AACA,MAAMW,aAAkC,GAAGN,WAAW,CAAC;EAAE,GAAGD,WAAW;EAAEQ,EAAE,EAAE;AAAQ,CAAC,CAAC;;AAEvF;AACA,MAAMC,kBAAkB,GAAG,IAAIC,GAAG,CAAS,CAAC;AAE5C,SAASC,eAAeA,CAACC,OAA2B,EAAEC,SAA6B,EAAQ;EACzF,MAAMC,GAAG,GAAG,GAAGF,OAAO,IAAI,UAAU,IAAIC,SAAS,CAACE,SAAS,EAAE;EAC7D,IAAIN,kBAAkB,CAACO,GAAG,CAACF,GAAG,CAAC,EAAE;EACjCL,kBAAkB,CAACQ,GAAG,CAACH,GAAG,CAAC;EAC3BI,OAAO,CAACC,KAAK,CACX,sBAAsBN,SAAS,CAACE,SAAS,uBAAuB,GAC9D,eAAeF,SAAS,CAACO,WAAW,SAASP,SAAS,CAACQ,QAAQ,UAAU,GACzE,qEACJ,CAAC;AACH;AAoBA,OAAO,SAASC,aAAaA,CAAC;EAAEC,QAAQ;EAAEC,UAAU;EAAEC;AAA0B,CAAC,EAAE;EACjF,MAAMC,MAAM,GAAG3B,cAAc,CAAC,CAAC;EAC/B,MAAM4B,WAAW,GAAGF,KAAK,IAAIlB,aAAa;EAE1C,MAAM;IAAEqB,IAAI;IAAEf;EAAU,CAAC,GAAGV,WAAW,CACrCwB,WAAW,CAACE,YAAY,CAACT,WAAW,EACpCI,UAAU,EACVE,MAAM,KAAK,MAAM,GAAG,MAAM,GAAG,OAC/B,CAAC;EACD,IAAIxB,KAAK,IAAIW,SAAS,EAAEF,eAAe,CAACgB,WAAW,CAACnB,EAAE,EAAEK,SAAS,CAAC;EAElE,MAAMiB,KAAK,GAAGhC,OAAO,CAAoB,MAAM;IAC7C,MAAMiC,MAAM,GAAGJ,WAAW,CAACK,KAAK,CAACC,QAAQ,CAACL,IAAI,CAAC;IAC/C,IAAI,CAACG,MAAM,EAAE;MACX;MACA;MACA,MAAM,IAAIG,KAAK,CACb,iBAAiBP,WAAW,CAACnB,EAAE,IAAI,UAAU,aAAaoB,IAAI,oBAChE,CAAC;IACH;IACA,OAAO;MACL;MACA;MACA;MACA;MACAH,KAAK,EAAEE,WAAqC;MAC5CC,IAAI;MACJG,MAAM;MACNF,YAAY,EAAEF,WAAW,CAACE;IAC5B,CAAC;EACH,CAAC,EAAE,CAACF,WAAW,EAAEC,IAAI,CAAC,CAAC;EAEvB,oBAAOvB,IAAA,CAACC,YAAY,CAAC6B,QAAQ;IAACL,KAAK,EAAEA,KAAM;IAAAP,QAAA,EAAEA;EAAQ,CAAwB,CAAC;AAChF;AAEA,OAAO,SAASa,QAAQA,CAAA,EAAsB;EAC5C,MAAMC,GAAG,GAAGxC,UAAU,CAACS,YAAY,CAAC;EACpC,IAAI,CAAC+B,GAAG,EAAE;IACR,MAAM,IAAIH,KAAK,CAAC,yCAAyC,CAAC;EAC5D;EACA,OAAOG,GAAG;AACZ","ignoreList":[]}

package/lib/module/theme/define-theme.js

@@ -0,0 +1,360 @@
+"use strict";
+
+/**
+ * define-theme — 消費者ブランドの theme を注入するための入口（設計書 Step 2-①）。
+ *
+ * melta 既定の theme は melta-contracts から codegen した `nativeTheme` だが、消費者が自分の
+ * ブランドトークンで塗り替えられる正規の口をここで提供する。`defineTheme()` を通した成果物だけを
+ * `<ThemeProvider theme={...}>` が受け取る（Chakra の `$$chakra` と同じ brand 方式。
+ * 生オブジェクトの直渡しを型で塞ぎ、validation を必ず1回通すため）。
+ *
+ * 設計の要点:
+ * - **capability は宣言でなく導出する**。「この theme は dark しか持たない」は
+ *   `color.semantic` のキー集合そのものが語る（Primer の colorSchemes / DTCG Resolver の contexts と同じ流儀）。
+ *   別欄で宣言すると「宣言と実体の不一致」という新種の嘘が生まれ、それを警備する検査が要るだけになる。
+ * - **嘘の値で埋めない**。単一 colorScheme の theme は存在しない mode を **書かない**。
+ *   ゼロ埋め・他 mode のコピー・センチネル値はいずれも「その mode が存在する」という嘘をトークンに残す。
+ * - **Proxy は使わない**。Hermes は Proxy が使われていなくても全プロパティアクセスに分岐が入る
+ *   （hermes#33）。存在しない mode の検出は non-enumerable な getter で行う（下記）。
+ *
+ * 注: accent（primary パレット / text-accent）・elevation・status の light 値は、単一 dark の
+ * theme でも現状 **必須のまま**。①の射程は colorScheme 軸だけで、それらの capability 化は
+ * 後続（accent 依存の除去）で扱う。
+ */
+
+// ---------------------------------------------------------------------------
+// dev 判定
+// ---------------------------------------------------------------------------
+
+/**
+ * 開発ビルドか。**裸の `__DEV__` を直接書かないこと。**
+ *
+ * `__DEV__` は Metro のグローバルで、Metro なら prod ビルド時に `false` へ畳み込まれて
+ * dev ブロックごと消える。一方 melta は package.json の exports の `import` / `default` 条件で
+ * 同じ ESM を非 Metro の web バンドラにも配っており、react-native-web は `__DEV__` を
+ * **定義しない**（vendored 側で `process.env.NODE_ENV` にローカル shim している）。
+ * そこで `typeof` で存在を確かめ、無い環境では `NODE_ENV === "development"` のときだけ有効にする
+ * （判定不能なら dev 機能を**切る**側に倒す ＝ 本番に dev コストを漏らさない）。
+ * `process` を識別子として直接参照しないのは、それを書くと tsconfig.build.json（bob build）だけが
+ * TS2591 で落ちるため（typecheck は通ってしまうので気づけない）。
+ */
+export const isDev = typeof __DEV__ !== "undefined" ? __DEV__ : globalThis.process?.env?.NODE_ENV === "development";
+
+// ---------------------------------------------------------------------------
+// 型
+// ---------------------------------------------------------------------------
+
+/** theme が持つ配色の能力。`color.semantic` のキー集合から導出される（宣言ではない）。 */
+
+/**
+ * 解決済みの capability 集合。context 経由で全 component が読める。
+ * 後続で accent / elevation の軸が増えるのもこの器（それらはキー集合から導出できないので宣言になる）。
+ */
+
+/**
+ * `defineTheme()` の入力。`NativeTheme` との差は `color.semantic` が mode ごとに任意な点だけ。
+ * 持っていない mode は **書かない**（capability はキー集合から導出される）。
+ */
+
+/**
+ * `defineTheme()` の成果物。`ThemeProvider` の `theme` prop が受け取れる唯一の形。
+ * `$$melta` brand により生オブジェクトの直渡しを型で塞ぐ（＝ validation を必ず1回通す）。
+ */
+
+/** 解決した mode が theme の能力と食い違ったこと。ThemeProvider は dev で報告し、値は clamp する。 */
+
+// ---------------------------------------------------------------------------
+// キー集合（型と実行時の二重管理を防ぐ: Record<K, true> で網羅性を tsc に検査させる）
+// ---------------------------------------------------------------------------
+
+function keysOf(map) {
+  return Object.keys(map);
+}
+const MODES = keysOf({
+  light: true,
+  dark: true
+});
+const SEMANTIC_KEYS = keysOf({
+  "bg-page": true,
+  "bg-page-alt": true,
+  "bg-surface": true,
+  "bg-surface-alt": true,
+  "text-heading": true,
+  "text-default": true,
+  "text-muted": true,
+  "border-default": true,
+  "border-strong": true,
+  "input-bg": true,
+  "input-border": true,
+  "text-accent": true,
+  "text-on-accent": true
+});
+const PRIMARY_KEYS = keysOf({
+  "50": true,
+  "100": true,
+  "200": true,
+  "300": true,
+  "400": true,
+  "500": true,
+  "600": true,
+  "700": true,
+  "800": true,
+  "900": true,
+  "950": true
+});
+const STATUS_KINDS = keysOf({
+  success: true,
+  warning: true,
+  danger: true
+});
+const STATUS_COLOR_KEYS = keysOf({
+  base: true,
+  subtleLight: true,
+  textLight: true,
+  subtleDark: true,
+  textDark: true
+});
+const SPACING_KEYS = keysOf({
+  "1": true,
+  "2": true,
+  "3": true,
+  "4": true,
+  "5": true,
+  "6": true,
+  "8": true,
+  "10": true,
+  "12": true,
+  "14": true,
+  "16": true
+});
+const RADIUS_KEYS = keysOf({
+  sm: true,
+  md: true,
+  lg: true,
+  full: true
+});
+const ELEVATION_KEYS = keysOf({
+  none: true,
+  sm: true,
+  md: true,
+  overlay: true
+});
+const FONT_SIZE_KEYS = keysOf({
+  xxs: true,
+  xs: true,
+  sm: true,
+  base: true,
+  lg: true,
+  xl: true,
+  "2xl": true,
+  "3xl": true
+});
+const FONT_WEIGHT_KEYS = keysOf({
+  normal: true,
+  medium: true,
+  semibold: true,
+  bold: true
+});
+
+// ---------------------------------------------------------------------------
+// capability の導出
+// ---------------------------------------------------------------------------
+
+/** theme が実際に値を持っている mode（enumerable なキーのみ ＝ dev getter を踏まない）。 */
+export function declaredModes(semantic) {
+  return MODES.filter(mode => Object.prototype.hasOwnProperty.call(semantic, mode));
+}
+
+/** colorScheme capability を `color.semantic` のキー集合から導出する。 */
+export function deriveColorScheme(semantic) {
+  const modes = declaredModes(semantic);
+  if (modes.length === 2) return "light-dark";
+  if (modes[0] === "dark") return "single-dark";
+  if (modes[0] === "light") return "single-light";
+  throw new Error("melta: theme.color.semantic に light / dark のどちらも無い。最低1つの mode が要る。");
+}
+
+/** capability が実際に描ける mode。 */
+export function supportedModes(colorScheme) {
+  if (colorScheme === "single-dark") return ["dark"];
+  if (colorScheme === "single-light") return ["light"];
+  return ["light", "dark"];
+}
+
+// ---------------------------------------------------------------------------
+// mode 解決
+// ---------------------------------------------------------------------------
+
+/**
+ * 表示 mode を解決する（純関数。ThemeProvider はこの結果に従うだけで判定はしない）。
+ *
+ * - **OS 由来の不一致は無反応で clamp する**。「light テーマを作らない」は消費者の意図的な設計判断で、
+ *   OS が light なのは環境の事実にすぎない。ここで警告を出すと light 設定のユーザ全員に出てしまう
+ *   （CSS の `color-scheme` / Expo の `userInterfaceStyle` も黙って clamp する）。
+ * - **`forcedMode` との不一致は報告する**。宣言同士の矛盾＝呼び出し側の間違いなので violation を返す。
+ *   ただし throw はしない（clamp して描き続ける）。厳格に落としたいテストや compiler が
+ *   violation を error に昇格させる側の責務にする。
+ */
+export function resolveMode(colorScheme, forcedMode, systemMode) {
+  const supported = supportedModes(colorScheme);
+  const requested = forcedMode ?? systemMode;
+  if (supported.includes(requested)) return {
+    mode: requested
+  };
+  const resolved = supported[0];
+  // OS 由来の clamp は「事故」ではないので violation を立てない。
+  if (forcedMode === undefined) return {
+    mode: resolved
+  };
+  return {
+    mode: resolved,
+    violation: {
+      kind: "forced-mode-unsupported",
+      requested,
+      resolved,
+      colorScheme
+    }
+  };
+}
+
+// ---------------------------------------------------------------------------
+// validation（開発時のみ。純関数なのでテストからも直接呼べる）
+// ---------------------------------------------------------------------------
+
+function missingKeys(target, keys) {
+  if (target === null || typeof target !== "object") return [...keys].map(String);
+  return keys.filter(key => !Object.prototype.hasOwnProperty.call(target, key)).map(String);
+}
+
+/**
+ * theme の形を検査して問題の一覧を返す（空配列 ＝ 問題なし）。
+ *
+ * 「宣言した mode の色が欠けている」「as キャストでキーが抜けた」といった、型を通り抜けた欠落を拾う。
+ * `defineTheme()` が dev で1回だけ呼ぶ。**render 中に呼ばないこと**（theme-ui は Provider の
+ * render body で毎レンダー全色を再帰走査して性能を落とした前例がある）。
+ */
+export function validateTheme(options) {
+  const problems = [];
+  const where = options.id ? `theme "${options.id}"` : "theme";
+  const semantic = options.color?.semantic;
+  if (semantic === null || typeof semantic !== "object") {
+    problems.push(`${where}: color.semantic が無い`);
+    return problems;
+  }
+  const unknownModes = Object.keys(semantic).filter(key => !MODES.includes(key));
+  for (const key of unknownModes) {
+    problems.push(`${where}: color.semantic の未知のキー "${key}"（light / dark のみ）`);
+  }
+  const modes = declaredModes(semantic);
+  if (modes.length === 0) {
+    problems.push(`${where}: color.semantic に light / dark のどちらも無い`);
+  }
+  for (const mode of modes) {
+    const missing = missingKeys(semantic[mode], SEMANTIC_KEYS);
+    if (missing.length > 0) {
+      problems.push(`${where}: color.semantic.${mode} に欠けている色 — ${missing.join(", ")}`);
+    }
+  }
+  const groups = [["color.primary", options.color?.primary, PRIMARY_KEYS], ["spacing", options.spacing, SPACING_KEYS], ["radius", options.radius, RADIUS_KEYS], ["elevation", options.elevation, ELEVATION_KEYS], ["typography.fontSize", options.typography?.fontSize, FONT_SIZE_KEYS], ["typography.fontWeight", options.typography?.fontWeight, FONT_WEIGHT_KEYS], ["color.status", options.color?.status, STATUS_KINDS]];
+  for (const [label, target, keys] of groups) {
+    const missing = missingKeys(target, keys);
+    if (missing.length > 0) {
+      problems.push(`${where}: ${label} に欠けているキー — ${missing.join(", ")}`);
+    }
+  }
+  const status = options.color?.status;
+  if (status !== null && typeof status === "object") {
+    for (const kind of STATUS_KINDS) {
+      if (!Object.prototype.hasOwnProperty.call(status, kind)) continue;
+      const missing = missingKeys(status[kind], STATUS_COLOR_KEYS);
+      if (missing.length > 0) {
+        problems.push(`${where}: color.status.${kind} に欠けているキー — ${missing.join(", ")}`);
+      }
+    }
+  }
+  return problems;
+}
+
+// ---------------------------------------------------------------------------
+// defineTheme
+// ---------------------------------------------------------------------------
+
+/**
+ * 持っていない mode に「読んだら落ちる」getter を置く（**dev / production 共通**）。
+ *
+ * 値は捏造しない（他 mode のコピーもゼロ埋めもしない）。放置して `undefined` にすると
+ * 実際に踏んだとき `Cannot read properties of undefined (reading 'bg-page')` としか出ず、
+ * どの theme のどの mode の話か分からない。**落ちること自体は getter の有無に関わらず同じ**なので、
+ * 原因を名指しするメッセージを本番のクラッシュレポートにも残す方を選ぶ。
+ *
+ * **non-enumerable にするのが要点**: spread / `Object.keys` / `JSON.stringify` /
+ * React DevTools の context 列挙では踏まれない。`theme.color.semantic.light` と
+ * 明示的に書いたときだけ落ちる。
+ *
+ * ホットパス（全 style resolver が引く `semantic[mode]`）にアクセサを混ぜることになるが、
+ * getter が付くのは **単一 colorScheme の theme を注入した場合だけ**。既定の light-dark theme
+ * には1つも付かないので、既存消費者の実行経路は変わらない。
+ */
+function installMissingModeGuards(semantic, where, colorScheme) {
+  for (const mode of MODES) {
+    if (Object.prototype.hasOwnProperty.call(semantic, mode)) continue;
+    Object.defineProperty(semantic, mode, {
+      enumerable: false,
+      configurable: true,
+      get() {
+        throw new Error(`melta: ${where} は colorScheme=${colorScheme} なので color.semantic.${mode} を持たない。` + `現在の mode の色は useTheme().colors（または color.semantic[mode]）から取ること。`);
+      }
+    });
+  }
+}
+
+/** dev 限定の再帰 freeze。enumerable なキーだけ辿るので上の guard getter は踏まない。 */
+function deepFreeze(value) {
+  if (value === null || typeof value !== "object") return;
+  if (Object.isFrozen(value)) return;
+  Object.freeze(value);
+  for (const key of Object.keys(value)) {
+    deepFreeze(value[key]);
+  }
+}
+
+/**
+ * ブランド theme を組み立てる。`ThemeProvider` の `theme` prop に渡せるのはこの戻り値だけ。
+ *
+ * **module スコープで1回だけ呼ぶこと**（render の中で呼ぶと毎レンダー新しい参照になり、
+ * context の consumer が全部再レンダーする）。styled-components / Emotion が docs で
+ * 同じことを求めているのと同じ理由。
+ *
+ * dev では validateTheme を1回通し、問題があれば throw する（構造が壊れた theme は
+ * 後段で必ず事故になるので早く落とす）。production では検査ごと省く。
+ */
+export function defineTheme(options) {
+  if (isDev) {
+    const problems = validateTheme(options);
+    if (problems.length > 0) {
+      throw new Error(`melta: theme の形が不正。\n- ${problems.join("\n- ")}`);
+    }
+  }
+  const semantic = {
+    ...options.color.semantic
+  };
+  const colorScheme = deriveColorScheme(semantic);
+  const theme = {
+    ...options,
+    color: {
+      ...options.color,
+      semantic
+    },
+    capabilities: {
+      colorScheme
+    },
+    $$melta: true
+  };
+
+  // guard は本番でも置く（値は捏造せず、踏んだときのメッセージだけ良くする）。
+  // freeze より先に置くこと（freeze 後は defineProperty できない）。
+  installMissingModeGuards(semantic, options.id ? `theme "${options.id}"` : "theme", colorScheme);
+  if (isDev) deepFreeze(theme);
+  return theme;
+}
+//# sourceMappingURL=define-theme.js.map

package/lib/module/theme/define-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isDev","__DEV__","globalThis","process","env","NODE_ENV","keysOf","map","Object","keys","MODES","light","dark","SEMANTIC_KEYS","PRIMARY_KEYS","STATUS_KINDS","success","warning","danger","STATUS_COLOR_KEYS","base","subtleLight","textLight","subtleDark","textDark","SPACING_KEYS","RADIUS_KEYS","sm","md","lg","full","ELEVATION_KEYS","none","overlay","FONT_SIZE_KEYS","xxs","xs","xl","FONT_WEIGHT_KEYS","normal","medium","semibold","bold","declaredModes","semantic","filter","mode","prototype","hasOwnProperty","call","deriveColorScheme","modes","length","Error","supportedModes","colorScheme","resolveMode","forcedMode","systemMode","supported","requested","includes","resolved","undefined","violation","kind","missingKeys","target","String","key","validateTheme","options","problems","where","id","color","push","unknownModes","missing","join","groups","primary","spacing","radius","elevation","typography","fontSize","fontWeight","status","label","installMissingModeGuards","defineProperty","enumerable","configurable","get","deepFreeze","value","isFrozen","freeze","defineTheme","theme","capabilities","$$melta"],"sourceRoot":"../../../src","sources":["theme/define-theme.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/theme/index.js

@@ -3,11 +3,13 @@
 /**
  * melta-app theme エントリ。
  * 型は types.ts、値は native-theme.ts（melta-contracts から自動生成）。
+ * 消費者ブランドの theme を注入する口は define-theme.ts（`defineTheme`）。
  */
 
 export * from "./types.js";
 export { nativeTheme } from "./native-theme.js";
 export { ThemeProvider, useTheme } from "./ThemeProvider.js";
+export { defineTheme, validateTheme, resolveMode, supportedModes, deriveColorScheme, declaredModes } from "./define-theme.js";
 /**
  * letterSpacingRatio（em 相当の比率）を、適用先の fontSize から RN の letterSpacing(pt) に解決する。
  * 例: resolveLetterSpacing(18, theme.typography.letterSpacingRatio.body)

package/lib/module/theme/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["nativeTheme","ThemeProvider","useTheme","resolveLetterSpacing","fontSize","ratio"],"sourceRoot":"../../../src","sources":["theme/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,cAAc,YAAS;AACvB,SAASA,WAAW,QAAQ,mBAAgB;AAC5C,SAASC,aAAa,EAAEC,QAAQ,QAAQ,oBAAiB;AAGzD;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACC,QAAgB,EAAEC,KAAa,EAAU;EAC5E,OAAOD,QAAQ,GAAGC,KAAK;AACzB","ignoreList":[]}
+{"version":3,"names":["nativeTheme","ThemeProvider","useTheme","defineTheme","validateTheme","resolveMode","supportedModes","deriveColorScheme","declaredModes","resolveLetterSpacing","fontSize","ratio"],"sourceRoot":"../../../src","sources":["theme/index.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;;AAEA,cAAc,YAAS;AACvB,SAASA,WAAW,QAAQ,mBAAgB;AAC5C,SAASC,aAAa,EAAEC,QAAQ,QAAQ,oBAAiB;AAEzD,SACEC,WAAW,EACXC,aAAa,EACbC,WAAW,EACXC,cAAc,EACdC,iBAAiB,EACjBC,aAAa,QACR,mBAAgB;AASvB;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,oBAAoBA,CAACC,QAAgB,EAAEC,KAAa,EAAU;EAC5E,OAAOD,QAAQ,GAAGC,KAAK;AACzB","ignoreList":[]}

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

@@ -6,27 +6,48 @@
  * useColorScheme() を Provider 内で1回だけ読む（RN コア、追加依存なし）。
  *
  * context value は useMemo 必須（§3）: 毎レンダで新オブジェクトを配ると全 consumer が再レンダする。
+ *
+ * theme 注入（Step 2-①）: `theme` を渡すと消費者ブランドの theme で塗り替わる。未指定なら
+ * 従来どおり codegen 済みの `nativeTheme`（＝既存消費者に破壊的変更なし）。渡せるのは
+ * `defineTheme()` の戻り値だけ（define-theme.ts 参照）。
  */
 import { type ReactNode } from "react";
-import type { NativeTheme, SemanticColors } from "./types";
-export type ThemeMode = "light" | "dark";
+import { type ResolvedCapabilities, type ResolvedNativeTheme } from "./define-theme";
+import type { NativeTheme, SemanticColors, ThemeMode } from "./types";
+export type { ThemeMode };
 export interface ThemeContextValue {
-    /** 正規化済み theme 全体（色以外の形状トークンもここから取る）。 */
+    /**
+     * 正規化済み theme 全体（色以外の形状トークンもここから取る）。
+     *
+     * 注: 単一 colorScheme の theme を注入した場合、`color.semantic` は**宣言された mode しか持たない**
+     * （型は両方あるように見える）。持たない側を直接読むと原因を名指しするエラーで落ちる。
+     * 現在 mode の色は `colors` を使うこと。
+     */
     theme: NativeTheme;
     /** 現在の表示モード。 */
     mode: ThemeMode;
     /** 現在 mode の semantic 色（= theme.color.semantic[mode]）。最頻アクセスなので展開済みで配る。 */
     colors: SemanticColors;
+    /** theme が持つ能力（`color.semantic` のキー集合などから導出済み）。 */
+    capabilities: ResolvedCapabilities;
 }
 interface ThemeProviderProps {
     children: ReactNode;
     /**
      * 明示モード。指定時は OS の colorScheme を無視して固定する。
      * カタログの light/dark トグル（§6）や、特定画面の固定表示に使う。
+     *
+     * theme が対応していない mode を渡した場合は theme 側の mode に clamp する（描画は止めない）。
+     * dev ではその矛盾を console.error で1回だけ報告する。
      */
     forcedMode?: ThemeMode;
+    /**
+     * 消費者ブランドの theme。未指定なら melta 既定（`nativeTheme`）。
+     * `defineTheme()` の戻り値を **module スコープで保持したもの**を渡すこと
+     * （render 中に組み立てると毎レンダー参照が変わり、全 consumer が再レンダする）。
+     */
+    theme?: ResolvedNativeTheme;
 }
-export declare function ThemeProvider({ children, forcedMode }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThemeProvider({ children, forcedMode, theme }: ThemeProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useTheme(): ThemeContextValue;
-export {};
 //# sourceMappingURL=ThemeProvider.d.ts.map

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;;;;;;;;GAQG;AAEH,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3E,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE3D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,KAAK,EAAE,WAAW,CAAC;IACnB,gBAAgB;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,2EAA2E;IAC3E,MAAM,EAAE,cAAc,CAAC;CACxB;AAID,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,kBAAkB,2CAczE;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,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;AAqBD,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"}