@lt-three/love3 0.1.0 → 0.1.1

package/dist/native/lib/scheme.js

@@ -1,15 +1,15 @@
 import { tokenNames, tokens } from "../../tokens/tokens.gen.js";
 
 //#region src/native/lib/scheme.ts
-/** 選択と端末のカラースキームから、実際に使うテーマを決める。 */
+/** Decides the theme to actually use from the selection and the device color scheme. */
 function resolveScheme(preference, system) {
 	if (preference === "system") return system === "dark" ? "dark" : "light";
 	return preference;
 }
 const isColorToken = (name) => !name.startsWith("font-") && name !== "radius";
 /**
-* トークンの色の実値。DS が値を持ち（`@lt-three/love3/tokens`）、部品はここを通して引く。
-* 名前は CSS 変数の形（`--ink-500`）でも、トークン名（`ink-500`）でもよい。色でないトークン（書体・角丸）は受けない。
+* The actual value of a color token. The DS owns the values (`@lt-three/love3/tokens`), and components look them up through here.
+* The name may be in CSS variable form (`--ink-500`) or token name form (`ink-500`). Non-color tokens (typefaces, radius) are not accepted.
 */
 function tokenColor(scheme, name, overlay) {
 	const key = name.startsWith("--") ? name.slice(2) : name;

package/dist/native/lib/snackbar.d.ts

@@ -3,7 +3,7 @@ import { ExternalStore } from "./external-store.js";
 export type SnackbarIcon = "success" | "error" | "info" | "warning";
 export type SnackbarAction = {
   label: string;
-  /** 押すと呼ばれ、そのあとトーストは閉じる（web の sonner の action と同じ）。 */
+  /** Called when pressed; the toast closes afterward (same as the sonner action on web). */
   onPress: () => void;
 };
 export type SnackbarItem = {
@@ -20,27 +20,26 @@ export type SnackbarOptions = {
   description?: string;
   action?: SnackbarAction;
   /**
-   * true なら自動で消えない（`dismissSnackbar` か、閉じるボタンで消す）。
-   * **`action` があるときの既定は true**（押す前に消えると、キーボードや支援技術で操作する人が間に合わない。WCAG 2.2.1）。
-   * `action` つきでも、`duration` を渡すか `persistent: false` を明示すれば、自動で消える。
+   * If true, the toast does not dismiss itself (dismiss it with `dismissSnackbar` or the close button).
+   * **Defaults to true when `action` is set** (if it disappeared before being pressed, people using a keyboard or assistive technology could not reach it in time; WCAG 2.2.1).
+   * Even with `action`, passing `duration` or an explicit `persistent: false` makes it dismiss itself.
    */
   persistent?: boolean;
-  /** 自動で消えるまでの ms（既定 4000）。`persistent` のときは無視される。 */
+  /** Milliseconds until it dismisses itself (default 4000). Ignored when `persistent`. */
   duration?: number;
 };
-/** `Snackbar` が読む待ち行列。命令的な API（`snackbar()`）がここへ書く。 */
+/** The queue read by `Snackbar`. The imperative API (`snackbar()`) writes here. */
 export declare const snackbarStore: ExternalStore<readonly SnackbarItem[]>;
-/** `Snackbar` がマウントされている間だけ呼ぶ（`once/snackbar` が effect で呼ぶ）。戻り値は解除。未マウントの警告に使う。 */
+/** Call only while a `Snackbar` is mounted (`once/snackbar` calls it in an effect). Returns an unsubscribe function. Used for the not-mounted warning. */
 export declare function registerSnackbarHost(): () => void;
 /**
- * トーストを出す。戻り値の id は `dismissSnackbar` に渡せる。
- * アプリのルートに `once/snackbar` の `Snackbar` を 1 つ置いておく（**置いていないと出ない**。開発時は警告を出す。
- * 自動で消えるまでの時間は、置く前でも進む）。
- * 移植元の `@lt-three/native/lib/snackbar`（jotai の atom）と同じ形の API を、外部ストアで作り直した。
+ * Shows a toast. The returned id can be passed to `dismissSnackbar`.
+ * Place one `Snackbar` from `once/snackbar` at the app root (**nothing is shown without it**; a warning is logged in development.
+ * The auto-dismiss timer runs even before it is placed).
  */
 export declare function snackbar(title: string, options?: SnackbarOptions): string | number;
-/** 指定したトーストを閉じる。 */
+/** Dismisses the given toast. */
 export declare function dismissSnackbar(id: string | number): void;
-/** 出ているトーストを全部閉じる（自動で消える予約も全部取り消す）。 */
+/** Dismisses all visible toasts (and cancels all pending auto-dismiss timers). */
 export declare function dismissAllSnackbars(): void;
 //#endregion

package/dist/native/lib/snackbar.js

@@ -1,13 +1,13 @@
 import { createExternalStore } from "./external-store.js";
 
 //#region src/native/lib/snackbar.ts
-/** `Snackbar` が読む待ち行列。命令的な API（`snackbar()`）がここへ書く。 */
+/** The queue read by `Snackbar`. The imperative API (`snackbar()`) writes here. */
 const snackbarStore = createExternalStore([]);
 const DEFAULT_DURATION = 4e3;
 let sequence = 0;
 const timers = /* @__PURE__ */ new Map();
 let mountedHosts = 0;
-/** `Snackbar` がマウントされている間だけ呼ぶ（`once/snackbar` が effect で呼ぶ）。戻り値は解除。未マウントの警告に使う。 */
+/** Call only while a `Snackbar` is mounted (`once/snackbar` calls it in an effect). Returns an unsubscribe function. Used for the not-mounted warning. */
 function registerSnackbarHost() {
 	mountedHosts += 1;
 	return () => {
@@ -15,10 +15,9 @@ function registerSnackbarHost() {
 	};
 }
 /**
-* トーストを出す。戻り値の id は `dismissSnackbar` に渡せる。
-* アプリのルートに `once/snackbar` の `Snackbar` を 1 つ置いておく（**置いていないと出ない**。開発時は警告を出す。
-* 自動で消えるまでの時間は、置く前でも進む）。
-* 移植元の `@lt-three/native/lib/snackbar`（jotai の atom）と同じ形の API を、外部ストアで作り直した。
+* Shows a toast. The returned id can be passed to `dismissSnackbar`.
+* Place one `Snackbar` from `once/snackbar` at the app root (**nothing is shown without it**; a warning is logged in development.
+* The auto-dismiss timer runs even before it is placed).
 */
 function snackbar(title, options) {
 	if (__DEV__ && mountedHosts === 0) console.warn("snackbar(): Snackbar がマウントされていない。アプリのルートに <Snackbar /> を 1 つ置くまで、このトーストは出ない。");
@@ -38,12 +37,12 @@ function snackbar(title, options) {
 	if (!persistent) timers.set(id, setTimeout(() => dismissSnackbar(id), options?.duration ?? DEFAULT_DURATION));
 	return id;
 }
-/** 指定したトーストを閉じる。 */
+/** Dismisses the given toast. */
 function dismissSnackbar(id) {
 	clearTimer(id);
 	snackbarStore.update((items) => items.filter((candidate) => candidate.id !== id));
 }
-/** 出ているトーストを全部閉じる（自動で消える予約も全部取り消す）。 */
+/** Dismisses all visible toasts (and cancels all pending auto-dismiss timers). */
 function dismissAllSnackbars() {
 	for (const timer of timers.values()) clearTimeout(timer);
 	timers.clear();

package/dist/native/lib/theme.d.ts

@@ -2,32 +2,32 @@ import { ActiveScheme, ThemePreference } from "./scheme.js";
 import { ReactNode } from "react";
 //#region src/native/lib/theme.d.ts
 /**
- * 現在の有効テーマ。
+ * The current effective theme.
  *
- * 配色そのものはここでは返さない。色は NativeWind のセマンティッククラス
- * （`bg-background` / `text-foreground` 等）から取る。このフックは
- * ネイティブ側 API（react-navigation のテーマ、StatusBar、SF Symbols の tint、チャートの色等）に
- * ライト/ダークを渡す必要がある箇所だけで使う。
+ * It does not return the colors themselves. Colors come from NativeWind's semantic classes
+ * (`bg-background` / `text-foreground`, etc.). Use this hook only where
+ * a native-side API (react-navigation theme, StatusBar, SF Symbols tint, chart colors, etc.)
+ * needs light/dark passed to it.
  */
 export declare function useActiveScheme(): ActiveScheme;
 export type ThemeRootProps = {
-  /** テーマ選択。保存先（AsyncStorage・jotai など）はアプリが持ち、ここへは値だけを渡す。 */
+  /** Theme selection. Where it is stored (AsyncStorage, jotai, etc.) is up to the app; only the value is passed here. */
   preference: ThemePreference;
   children: ReactNode;
 };
 /**
- * テーマを実際の描画へ反映するルート。
+ * The root that applies the theme to actual rendering.
  *
- * `@lt-three/love3/styles.css` は `.dark { --paper: ...; ... }` という
- * **クラスベース**のダークトークンを定義している。react-native-css はこのクラス規則をそのまま
- * コンパイルするため、ルートに `className="dark"` を置けば子孫すべてにダークの CSS 変数が配られる。
- * web の `<html class="dark">` と同じ仕組みで、トークンを TS 側に複製しなくて済む。
+ * `@lt-three/love3/styles.css` defines dark tokens of the form `.dark { --paper: ...; ... }`,
+ * which are **class-based**. react-native-css compiles this class rule as is,
+ * so placing `className="dark"` on the root distributes the dark CSS variables to every descendant.
+ * This works the same way as `<html class="dark">` on web, so the tokens need not be duplicated in TS.
  *
- * あわせて RN の `Appearance` も同期する。ナビゲーションのテーマや StatusBar など、
- * NativeWind の外側にあるネイティブ UI がこれを見ている。
+ * It also syncs React Native's `Appearance`. Native UI outside NativeWind, such as the navigation theme and StatusBar,
+ * reads it.
  *
- * **web（react-native-web）では使わない。** web のテーマは `<html class="dark">` が持つ
- * （preview・vitest はそのまま切り替える）。
+ * **Not used on web (react-native-web).** The web theme is owned by `<html class="dark">`
+ * (preview and vitest switch it directly).
  */
 export declare function ThemeRoot({ preference, children }: ThemeRootProps): import("react").JSX.Element;
 //#endregion

package/dist/native/lib/theme.js

@@ -4,15 +4,15 @@ import { Appearance, View, useColorScheme } from "react-native";
 import { jsx } from "react/jsx-runtime";
 
 //#region src/native/lib/theme.tsx
-/** `ThemeRoot` が配る有効テーマ。`ThemeRoot` の外では端末のカラースキームに従う。 */
+/** The effective theme distributed by `ThemeRoot`. Outside `ThemeRoot` it follows the device color scheme. */
 const SchemeContext = createContext(null);
 /**
-* 現在の有効テーマ。
+* The current effective theme.
 *
-* 配色そのものはここでは返さない。色は NativeWind のセマンティッククラス
-* （`bg-background` / `text-foreground` 等）から取る。このフックは
-* ネイティブ側 API（react-navigation のテーマ、StatusBar、SF Symbols の tint、チャートの色等）に
-* ライト/ダークを渡す必要がある箇所だけで使う。
+* It does not return the colors themselves. Colors come from NativeWind's semantic classes
+* (`bg-background` / `text-foreground`, etc.). Use this hook only where
+* a native-side API (react-navigation theme, StatusBar, SF Symbols tint, chart colors, etc.)
+* needs light/dark passed to it.
 */
 function useActiveScheme() {
 	const fromRoot = useContext(SchemeContext);
@@ -20,18 +20,18 @@ function useActiveScheme() {
 	return fromRoot ?? resolveScheme("system", system);
 }
 /**
-* テーマを実際の描画へ反映するルート。
+* The root that applies the theme to actual rendering.
 *
-* `@lt-three/love3/styles.css` は `.dark { --paper: ...; ... }` という
-* **クラスベース**のダークトークンを定義している。react-native-css はこのクラス規則をそのまま
-* コンパイルするため、ルートに `className="dark"` を置けば子孫すべてにダークの CSS 変数が配られる。
-* web の `<html class="dark">` と同じ仕組みで、トークンを TS 側に複製しなくて済む。
+* `@lt-three/love3/styles.css` defines dark tokens of the form `.dark { --paper: ...; ... }`,
+* which are **class-based**. react-native-css compiles this class rule as is,
+* so placing `className="dark"` on the root distributes the dark CSS variables to every descendant.
+* This works the same way as `<html class="dark">` on web, so the tokens need not be duplicated in TS.
 *
-* あわせて RN の `Appearance` も同期する。ナビゲーションのテーマや StatusBar など、
-* NativeWind の外側にあるネイティブ UI がこれを見ている。
+* It also syncs React Native's `Appearance`. Native UI outside NativeWind, such as the navigation theme and StatusBar,
+* reads it.
 *
-* **web（react-native-web）では使わない。** web のテーマは `<html class="dark">` が持つ
-* （preview・vitest はそのまま切り替える）。
+* **Not used on web (react-native-web).** The web theme is owned by `<html class="dark">`
+* (preview and vitest switch it directly).
 */
 function ThemeRoot({ preference, children }) {
 	const system = useColorScheme();

package/dist/native/lib/timezone.d.ts

@@ -1,26 +1,26 @@
 //#region src/native/lib/timezone.d.ts
 /**
- * タイムゾーン（IANA 文字列）のユーティリティ。`atom/timezone-select` が使う。
- * 移植元は `@lt-three/core/lib/timezone`。love3 は core に依存しないので、native の `lib/` に持つ
- * （web の love3 に timezone-select が移ったら `shared/` へ移して共有する）。
+ * Utilities for time zones (IANA strings). Used by `atom/timezone-select`.
+ * love3 has no dependency on a shared core package, so this lives in native `lib/`
+ * (if a timezone-select is added to the web side of love3, move this to `shared/` and share it).
  *
- * 選択肢を `Intl.supportedValuesOf("timeZone")` から作らないのは、native の JS エンジン
- * Hermes にそれが無いため（Hermes 250829098.0.16 の hermesvm バイナリに文字列が無いことを確認した。
- * `Intl.DateTimeFormat` の `resolvedOptions().timeZone` は iOS / Android とも持つ）。
- * 全ゾーン（約 420）を出しても検索の無い選択リストでは使えないので、固定リストにしている。
+ * The options are not built from `Intl.supportedValuesOf("timeZone")` because the native JS engine
+ * Hermes does not have it (confirmed that the string is absent from the hermesvm binary of Hermes 250829098.0.16.
+ * `resolvedOptions().timeZone` of `Intl.DateTimeFormat` exists on both iOS and Android).
+ * Listing every zone (about 420) is unusable in a select list without search, so a fixed list is used.
  */
 /**
- * 主要な IANA タイムゾーン。各地域の代表的な都市を IANA の tz database から選んだ。
- * ここに無い値でも、デバイスのタイムゾーンと保存済みの値は `timeZoneOptions` が必ず足す。
+ * Major IANA time zones. Representative cities of each region, chosen from the IANA tz database.
+ * Even for values not listed here, `timeZoneOptions` always adds the device time zone and the saved value.
  */
 export declare const MAJOR_TIME_ZONES: readonly string[];
-/** この端末のタイムゾーン（IANA 文字列）。取れなければ空文字。 */
+/** This device's time zone (IANA string). An empty string if it cannot be obtained. */
 export declare function getDeviceTimeZone(): string;
 /**
- * 選択肢のタイムゾーン一覧。固定リストに `extra`（デバイスの値・保存済みの値）を足し、
- * 重複と空文字を除いて返す。リストに無い値が選択済みのとき、選択肢から消えて空表示になるのを防ぐ。
+ * The list of time zone options. Adds `extra` (the device value, the saved value) to the fixed list,
+ * and returns it with duplicates and the empty string removed. Prevents a selected value not in the list from vanishing from the options and showing as empty.
  */
 export declare function timeZoneOptions(...extra: string[]): string[];
-/** 表示用の名前。IANA の `_` は読みにくいので空白に直す（`America/New_York` → `America/New York`）。 */
+/** Display name. The IANA `_` is hard to read, so it is turned into a space (`America/New_York` → `America/New York`). */
 export declare function formatTimeZoneLabel(zone: string): string;
 //#endregion

package/dist/native/lib/timezone.js

@@ -1,17 +1,17 @@
 //#region src/native/lib/timezone.ts
 /**
-* タイムゾーン（IANA 文字列）のユーティリティ。`atom/timezone-select` が使う。
-* 移植元は `@lt-three/core/lib/timezone`。love3 は core に依存しないので、native の `lib/` に持つ
-* （web の love3 に timezone-select が移ったら `shared/` へ移して共有する）。
+* Utilities for time zones (IANA strings). Used by `atom/timezone-select`.
+* love3 has no dependency on a shared core package, so this lives in native `lib/`
+* (if a timezone-select is added to the web side of love3, move this to `shared/` and share it).
 *
-* 選択肢を `Intl.supportedValuesOf("timeZone")` から作らないのは、native の JS エンジン
-* Hermes にそれが無いため（Hermes 250829098.0.16 の hermesvm バイナリに文字列が無いことを確認した。
-* `Intl.DateTimeFormat` の `resolvedOptions().timeZone` は iOS / Android とも持つ）。
-* 全ゾーン（約 420）を出しても検索の無い選択リストでは使えないので、固定リストにしている。
+* The options are not built from `Intl.supportedValuesOf("timeZone")` because the native JS engine
+* Hermes does not have it (confirmed that the string is absent from the hermesvm binary of Hermes 250829098.0.16.
+* `resolvedOptions().timeZone` of `Intl.DateTimeFormat` exists on both iOS and Android).
+* Listing every zone (about 420) is unusable in a select list without search, so a fixed list is used.
 */
 /**
-* 主要な IANA タイムゾーン。各地域の代表的な都市を IANA の tz database から選んだ。
-* ここに無い値でも、デバイスのタイムゾーンと保存済みの値は `timeZoneOptions` が必ず足す。
+* Major IANA time zones. Representative cities of each region, chosen from the IANA tz database.
+* Even for values not listed here, `timeZoneOptions` always adds the device time zone and the saved value.
 */
 const MAJOR_TIME_ZONES = [
 	"UTC",
@@ -69,7 +69,7 @@ const MAJOR_TIME_ZONES = [
 	"Australia/Melbourne",
 	"Pacific/Auckland"
 ];
-/** この端末のタイムゾーン（IANA 文字列）。取れなければ空文字。 */
+/** This device's time zone (IANA string). An empty string if it cannot be obtained. */
 function getDeviceTimeZone() {
 	try {
 		return Intl.DateTimeFormat().resolvedOptions().timeZone ?? "";
@@ -78,15 +78,15 @@ function getDeviceTimeZone() {
 	}
 }
 /**
-* 選択肢のタイムゾーン一覧。固定リストに `extra`（デバイスの値・保存済みの値）を足し、
-* 重複と空文字を除いて返す。リストに無い値が選択済みのとき、選択肢から消えて空表示になるのを防ぐ。
+* The list of time zone options. Adds `extra` (the device value, the saved value) to the fixed list,
+* and returns it with duplicates and the empty string removed. Prevents a selected value not in the list from vanishing from the options and showing as empty.
 */
 function timeZoneOptions(...extra) {
 	const set = new Set(MAJOR_TIME_ZONES);
 	for (const zone of extra) if (zone) set.add(zone);
 	return [...set].sort((a, b) => a.localeCompare(b));
 }
-/** 表示用の名前。IANA の `_` は読みにくいので空白に直す（`America/New_York` → `America/New York`）。 */
+/** Display name. The IANA `_` is hard to read, so it is turned into a space (`America/New_York` → `America/New York`). */
 function formatTimeZoneLabel(zone) {
 	return zone.replaceAll("_", " ");
 }

package/dist/native/lib/token-color.d.ts

@@ -1,5 +1,5 @@
 import { ColorTokenName } from "./scheme.js";
 //#region src/native/lib/token-color.d.ts
-/** 引数は CSS 変数の形の色のトークン（`--ink-500`）。セマンティックな名前（`--muted-foreground`）も引ける。書体・角丸は受けない。 */
+/** The argument is a color token in CSS variable form (`--ink-500`). Semantic names (`--muted-foreground`) can also be looked up. Typefaces and radius are not accepted. */
 export declare function useTokenColor(name: `--${ColorTokenName}`): string;
 //#endregion

package/dist/native/lib/token-color.js

@@ -4,7 +4,7 @@ import { TuningTokensContext } from "./tuning-context.js";
 import { useContext } from "react";
 
 //#region src/native/lib/token-color.ts
-/** 引数は CSS 変数の形の色のトークン（`--ink-500`）。セマンティックな名前（`--muted-foreground`）も引ける。書体・角丸は受けない。 */
+/** The argument is a color token in CSS variable form (`--ink-500`). Semantic names (`--muted-foreground`) can also be looked up. Typefaces and radius are not accepted. */
 function useTokenColor(name) {
 	return tokenColor(useActiveScheme(), name, useContext(TuningTokensContext));
 }

package/dist/native/lib/tuning-context.d.ts

@@ -1,8 +1,8 @@
 import { Mode } from "../../tuning/types.js";
 //#region src/native/lib/tuning-context.d.ts
 /**
- * 調整（`TuningRoot`）が配る、トークンの実効値（ライト・ダーク別。参照を解決した値）。無ければ（`TuningRoot` の外）調整なし。
- * TS から色を引く `useTokenColor` が、これを見て実行時の上書きに追従する。
+ * The effective token values (separate for light and dark; references resolved) distributed by tuning (`TuningRoot`). If absent (outside `TuningRoot`), there is no tuning.
+ * `useTokenColor`, which looks up colors from TS, reads this to follow runtime overrides.
  */
 export type TuningTokens = Readonly<Record<Mode, Readonly<Record<string, string>>>>;
 export declare const TuningTokensContext: import("react").Context<Readonly<Record<Mode, Readonly<Record<string, string>>>> | null>;

package/dist/native/lib/tuning.d.ts

@@ -2,23 +2,23 @@ import { Tuning, TuningCatalog } from "../../tuning/types.js";
 import { ReactNode } from "react";
 //#region src/native/lib/tuning.d.ts
 export type TuningRootProps = {
-  /** 調整の内容（既定との差分。`@lt-three/love3/tuning` の `Tuning`。保存先はアプリが持つ）。 */
+  /** The tuning content (the diff from the defaults; `Tuning` of `@lt-three/love3/tuning`. Where it is stored is up to the app). */
   tuning: Tuning;
-  /** 調整の対象。既定は love3 の生成物（`tuning/catalog.gen.ts`）。 */
+  /** The tuning target. Defaults to love3's generated output (`tuning/catalog.gen.ts`). */
   catalog?: TuningCatalog;
   children: ReactNode;
 };
 /**
- * 調整（トークンの実行時の上書き）を、子孫の部品に反映するルート。**`ThemeRoot` の内側**に置く（有効テーマと、ダークの変数を受け取るため）。
+ * The root that applies tuning (runtime overrides of tokens) to descendant components. Place it **inside `ThemeRoot`** (to receive the effective theme and the dark variables).
  *
- * - `react-native-css` の `VariableContextProvider` で、変えた色・角丸・書体を CSS 変数として配る。実機で効くのは、
- *   ライト・ダークで値が違う色のトークンを使うクラス（`bg-card` など）と書体。`bg-action` などビルド時にリテラルへ
- *   畳み込まれるクラス・角丸・本文サイズ・セマンティックの参照先は、**実機では効かない**（`nativeLimits` が説明を返す。
- *   react-native-web では CSS 変数なので全部効く）
- * - TS から色を引く部品（`useTokenColor`）は、実効値（参照を解決した値）を `TuningTokensContext` から引くので、**全部追従する**
- * - 調整が無い（既定と同じ）なら、何も変えない（`tuning` を空にすれば元の見た目）
+ * - Distributes the changed colors, radius, and typefaces as CSS variables with `VariableContextProvider` from `react-native-css`. On device, what takes effect is
+ *   classes that use color tokens whose values differ between light and dark (such as `bg-card`) and typefaces. Classes folded into literals at build time, such as `bg-action`,
+ *   plus radius, body text size, and the targets of semantic references, **do not take effect on device** (`nativeLimits` returns an explanation.
+ *   On react-native-web they are CSS variables, so everything takes effect)
+ * - Components that look up colors from TS (`useTokenColor`) read the effective values (references resolved) from `TuningTokensContext`, so **all of them follow**
+ * - With no tuning (same as the defaults), nothing changes (empty `tuning` restores the original look)
  *
- * 実機（Expo）での確認は未実施。react-native-web の browser test で確かめた範囲を README に書いてある。
+ * Not yet verified on a real device (Expo). The README lists what was verified in react-native-web browser tests.
  */
 export declare function TuningRoot({ tuning, catalog, children }: TuningRootProps): import("react").JSX.Element;
 //#endregion

package/dist/native/lib/tuning.js

@@ -9,16 +9,16 @@ import { VariableContextProvider } from "react-native-css";
 
 //#region src/native/lib/tuning.tsx
 /**
-* 調整（トークンの実行時の上書き）を、子孫の部品に反映するルート。**`ThemeRoot` の内側**に置く（有効テーマと、ダークの変数を受け取るため）。
+* The root that applies tuning (runtime overrides of tokens) to descendant components. Place it **inside `ThemeRoot`** (to receive the effective theme and the dark variables).
 *
-* - `react-native-css` の `VariableContextProvider` で、変えた色・角丸・書体を CSS 変数として配る。実機で効くのは、
-*   ライト・ダークで値が違う色のトークンを使うクラス（`bg-card` など）と書体。`bg-action` などビルド時にリテラルへ
-*   畳み込まれるクラス・角丸・本文サイズ・セマンティックの参照先は、**実機では効かない**（`nativeLimits` が説明を返す。
-*   react-native-web では CSS 変数なので全部効く）
-* - TS から色を引く部品（`useTokenColor`）は、実効値（参照を解決した値）を `TuningTokensContext` から引くので、**全部追従する**
-* - 調整が無い（既定と同じ）なら、何も変えない（`tuning` を空にすれば元の見た目）
+* - Distributes the changed colors, radius, and typefaces as CSS variables with `VariableContextProvider` from `react-native-css`. On device, what takes effect is
+*   classes that use color tokens whose values differ between light and dark (such as `bg-card`) and typefaces. Classes folded into literals at build time, such as `bg-action`,
+*   plus radius, body text size, and the targets of semantic references, **do not take effect on device** (`nativeLimits` returns an explanation.
+*   On react-native-web they are CSS variables, so everything takes effect)
+* - Components that look up colors from TS (`useTokenColor`) read the effective values (references resolved) from `TuningTokensContext`, so **all of them follow**
+* - With no tuning (same as the defaults), nothing changes (empty `tuning` restores the original look)
 *
-* 実機（Expo）での確認は未実施。react-native-web の browser test で確かめた範囲を README に書いてある。
+* Not yet verified on a real device (Expo). The README lists what was verified in react-native-web browser tests.
 */
 function TuningRoot({ tuning, catalog: catalog$1 = catalog, children }) {
 	const scheme = useActiveScheme();

package/dist/native/lib/typography.d.ts

@@ -1,10 +1,10 @@
 import { TextStyle } from "react-native";
 //#region src/native/lib/typography.d.ts
 /**
- * 数字を等幅（タブラー）で揃えるスタイル。
+ * A style that aligns digits with equal widths (tabular).
  *
- * Tailwind の `tabular-nums`（`font-variant-numeric`）は react-native-css が
- * 未対応のため className では表現できない。数値表示にはこれを `style` で渡す。
+ * Tailwind's `tabular-nums` (`font-variant-numeric`) cannot be expressed in className because
+ * react-native-css does not support it. For numeric displays, pass this via `style`.
  */
 export declare const tabularNums: TextStyle;
 //#endregion

package/dist/native/lib/typography.js

@@ -1,9 +1,9 @@
 //#region src/native/lib/typography.ts
 /**
-* 数字を等幅（タブラー）で揃えるスタイル。
+* A style that aligns digits with equal widths (tabular).
 *
-* Tailwind の `tabular-nums`（`font-variant-numeric`）は react-native-css が
-* 未対応のため className では表現できない。数値表示にはこれを `style` で渡す。
+* Tailwind's `tabular-nums` (`font-variant-numeric`) cannot be expressed in className because
+* react-native-css does not support it. For numeric displays, pass this via `style`.
 */
 const tabularNums = { fontVariant: ["tabular-nums"] };
 

package/dist/native/lib/utils.d.ts

@@ -3,9 +3,9 @@ import { ClassValue } from "clsx";
 //#region src/native/lib/utils.d.ts
 export declare function cn(...inputs: ClassValue[]): string;
 /**
- * 何も描かない `ReactNode`（`null`・`undefined`・真偽値・空文字・それだけを持つ配列や `<></>`）。
- * 見出しやラベルが「ある」かの判定に使う（`""` や `<></>` のような空の見出しを、名前として指さない）。
- * 要素（`<Text />` など）は、中身が空でも「ある」とする（描かれる）。Fragment だけは、中身で決める。
+ * A `ReactNode` that renders nothing (`null`, `undefined`, booleans, the empty string, and arrays or `<></>` containing only those).
+ * Used to decide whether a heading or label "exists" (an empty heading such as `""` or `<></>` does not count as a name).
+ * An element (such as `<Text />`) counts as existing even if its content is empty (it is drawn). Only a Fragment is decided by its content.
  */
 export declare function isBlankNode(node: ReactNode): boolean;
 //#endregion

package/dist/native/lib/utils.js

@@ -7,9 +7,9 @@ function cn(...inputs) {
 	return twMerge(clsx(inputs));
 }
 /**
-* 何も描かない `ReactNode`（`null`・`undefined`・真偽値・空文字・それだけを持つ配列や `<></>`）。
-* 見出しやラベルが「ある」かの判定に使う（`""` や `<></>` のような空の見出しを、名前として指さない）。
-* 要素（`<Text />` など）は、中身が空でも「ある」とする（描かれる）。Fragment だけは、中身で決める。
+* A `ReactNode` that renders nothing (`null`, `undefined`, booleans, the empty string, and arrays or `<></>` containing only those).
+* Used to decide whether a heading or label "exists" (an empty heading such as `""` or `<></>` does not count as a name).
+* An element (such as `<Text />`) counts as existing even if its content is empty (it is drawn). Only a Fragment is decided by its content.
 */
 function isBlankNode(node) {
 	if (node === null || node === void 0 || typeof node === "boolean" || node === "") return true;

package/dist/native/once/confirm.d.ts

@@ -1,7 +1,7 @@
 //#region src/native/once/confirm.d.ts
 /**
- * `confirm()`（`lib/confirm.ts`）から呼ばれる確認ダイアログ。アプリのルートに 1 つだけ置く。
- * 移植元は jotai の `confirmDialogAtom` を読んでいたが、love3 は外部ストア（`confirmDialogStore`）を読む。
+ * The confirmation dialog invoked by `confirm()` (`lib/confirm.ts`). Place exactly one at the app root.
+ * It reads from an external store (`confirmDialogStore`).
  */
 export declare function ConfirmDialog(): import("react").JSX.Element;
 //#endregion

package/dist/native/once/confirm.js

@@ -7,8 +7,8 @@ import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/native/once/confirm.tsx
 /**
-* `confirm()`（`lib/confirm.ts`）から呼ばれる確認ダイアログ。アプリのルートに 1 つだけ置く。
-* 移植元は jotai の `confirmDialogAtom` を読んでいたが、love3 は外部ストア（`confirmDialogStore`）を読む。
+* The confirmation dialog invoked by `confirm()` (`lib/confirm.ts`). Place exactly one at the app root.
+* It reads from an external store (`confirmDialogStore`).
 */
 function ConfirmDialog() {
 	const dialog = confirmDialogStore.use();

package/dist/native/once/error-boundary.d.ts

@@ -7,15 +7,15 @@ export type ErrorBoundaryLabels = {
 };
 export type ErrorBoundaryProps = {
   children: ReactNode;
-  /** フォールバック画面の文言。i18n はアプリ側で解決して渡す。 */
+  /** Text for the fallback screen. The app resolves i18n and passes it in. */
   labels: ErrorBoundaryLabels;
 };
 type State = {
   hasError: boolean;
 };
 /**
- * アプリ全体を包むエラーバウンダリ。子ツリーのレンダリング例外を捕捉し、
- * 白画面クラッシュの代わりに復帰導線付きのフォールバックを表示する。
+ * An error boundary wrapping the whole app. It catches rendering exceptions in the child tree and,
+ * instead of a blank-screen crash, shows a fallback with a way to recover.
  */
 export declare class ErrorBoundary extends Component<ErrorBoundaryProps, State> {
   state: State;

package/dist/native/once/error-boundary.js

@@ -27,8 +27,8 @@ function ErrorFallback({ title, description, retry, onRetry }) {
 	});
 }
 /**
-* アプリ全体を包むエラーバウンダリ。子ツリーのレンダリング例外を捕捉し、
-* 白画面クラッシュの代わりに復帰導線付きのフォールバックを表示する。
+* An error boundary wrapping the whole app. It catches rendering exceptions in the child tree and,
+* instead of a blank-screen crash, shows a fallback with a way to recover.
 */
 var ErrorBoundary = class extends Component {
 	constructor(..._args) {

package/dist/native/once/loading-lock.d.ts

@@ -1,8 +1,8 @@
 //#region src/native/once/loading-lock.d.ts
 /**
- * グローバルローディング中に操作を塞ぐオーバーレイ。アプリのルートに 1 つだけ置く。
- * `globalLoading(true)`（`lib/loading.ts`）で出て、`false` で消える。
- * 移植元は jotai の `loadingAtom` を読んでいたが、love3 は外部ストア（`loadingStore`）を読む。
+ * An overlay that blocks interaction during global loading. Place exactly one at the app root.
+ * It appears on `globalLoading(true)` (`lib/loading.ts`) and disappears on `false`.
+ * It reads from an external store (`loadingStore`).
  */
 export declare function LoadingLock(): import("react").JSX.Element;
 //#endregion

package/dist/native/once/loading-lock.js

@@ -6,9 +6,9 @@ import { jsx } from "react/jsx-runtime";
 
 //#region src/native/once/loading-lock.tsx
 /**
-* グローバルローディング中に操作を塞ぐオーバーレイ。アプリのルートに 1 つだけ置く。
-* `globalLoading(true)`（`lib/loading.ts`）で出て、`false` で消える。
-* 移植元は jotai の `loadingAtom` を読んでいたが、love3 は外部ストア（`loadingStore`）を読む。
+* An overlay that blocks interaction during global loading. Place exactly one at the app root.
+* It appears on `globalLoading(true)` (`lib/loading.ts`) and disappears on `false`.
+* It reads from an external store (`loadingStore`).
 */
 function LoadingLock() {
 	const loading = loadingStore.use();

package/dist/native/once/offline-banner.d.ts

@@ -1,15 +1,15 @@
 //#region src/native/once/offline-banner.d.ts
 export type OfflineBannerProps = {
-  /** 表示する文言。love3 は i18n に依存しないので、アプリ側で解決して渡す。 */
+  /** The text to show. love3 does not depend on i18n, so the app resolves it and passes it in. */
   message: string;
 };
 /**
- * 通信断中に画面最上部へ常設表示するバナー。復帰すると自動的に消える。
- * ルートには `react-native-safe-area-context` の `SafeAreaProvider` が要る（Expo Router は標準で入れる）。
+ * A banner permanently shown at the top of the screen while the connection is down. It disappears automatically when the connection returns.
+ * The root needs `react-native-safe-area-context`'s `SafeAreaProvider` (Expo Router includes it by default).
  *
- * 配色は `destructive` の面と、その上の文字（`paper`。`atom/button` の destructive と同じ組）。
- * 移植元は色リテラル（赤の `#B91C1C` と白）でテーマ非依存に固定していたが、love3 は色リテラルを持たない（トークンを使う）。
- * 状態は `lib/network.ts` の `useIsOnline`（NetInfo。web は `navigator.onLine`）。切れると `role="alert"` で読み上げる。
+ * The colors are the `destructive` surface and the text on it (`paper`; the same pair as `atom/button`'s destructive).
+ * love3 has no color literals (it uses tokens), so the banner follows the theme.
+ * The state comes from `useIsOnline` in `lib/network.ts` (NetInfo; `navigator.onLine` on web). When the connection drops it is announced with `role="alert"`.
  */
 export declare function OfflineBanner({ message }: OfflineBannerProps): import("react").JSX.Element | null;
 //#endregion

package/dist/native/once/offline-banner.js

@@ -6,12 +6,12 @@ import { useSafeAreaInsets } from "react-native-safe-area-context";
 
 //#region src/native/once/offline-banner.tsx
 /**
-* 通信断中に画面最上部へ常設表示するバナー。復帰すると自動的に消える。
-* ルートには `react-native-safe-area-context` の `SafeAreaProvider` が要る（Expo Router は標準で入れる）。
+* A banner permanently shown at the top of the screen while the connection is down. It disappears automatically when the connection returns.
+* The root needs `react-native-safe-area-context`'s `SafeAreaProvider` (Expo Router includes it by default).
 *
-* 配色は `destructive` の面と、その上の文字（`paper`。`atom/button` の destructive と同じ組）。
-* 移植元は色リテラル（赤の `#B91C1C` と白）でテーマ非依存に固定していたが、love3 は色リテラルを持たない（トークンを使う）。
-* 状態は `lib/network.ts` の `useIsOnline`（NetInfo。web は `navigator.onLine`）。切れると `role="alert"` で読み上げる。
+* The colors are the `destructive` surface and the text on it (`paper`; the same pair as `atom/button`'s destructive).
+* love3 has no color literals (it uses tokens), so the banner follows the theme.
+* The state comes from `useIsOnline` in `lib/network.ts` (NetInfo; `navigator.onLine` on web). When the connection drops it is announced with `role="alert"`.
 */
 function OfflineBanner({ message }) {
 	const online = useIsOnline();