@lt-three/love3 0.1.0 → 0.1.1

package/dist/native/layout/tabs.d.ts

@@ -10,19 +10,19 @@ export type TabType = {
 export type TabsProps = {
   tabs: TabType;
   defaultValue?: string;
-  /** 制御モード: 外部から選択値を管理する場合に指定する。 */
+  /** Controlled mode: specify it to manage the selected value from outside. */
   value?: string;
   onValueChange?: (value: string) => void;
-  /** タブ列と同じ行の右端に置くスロット（ツールバー的に使う）。 */
+  /** Slot placed at the right end of the same row as the tab strip (used like a toolbar). */
   trailing?: ReactNode;
   className?: string;
 };
 /**
- * `@lt-three/web` の layout/tabs と同じレコード駆動の API を持つタブ。
- * 見た目は web の base/tabs に揃えたフラッシュレフトの下線タブで、
- * 共有の薄い罫線の上にアクティブの 2px インディゴ下線が乗る。
+ * Tabs with the same record-driven API as the web `layout/tabs`.
+ * Visually they are flush-left underlined tabs matching the web base/tabs:
+ * a 2px indigo underline for the active tab sits on a shared faint rule.
  *
- * タブ数が増えても折り返さないよう横スクロールする（web の `flex-wrap` の代わり）。
+ * They scroll horizontally so they never wrap as the tab count grows (instead of web's `flex-wrap`).
  */
 export declare function Tabs({ tabs, defaultValue, value, onValueChange, trailing, className }: TabsProps): import("react").JSX.Element;
 //#endregion

package/dist/native/layout/tabs.js

@@ -6,11 +6,11 @@ import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/native/layout/tabs.tsx
 /**
-* `@lt-three/web` の layout/tabs と同じレコード駆動の API を持つタブ。
-* 見た目は web の base/tabs に揃えたフラッシュレフトの下線タブで、
-* 共有の薄い罫線の上にアクティブの 2px インディゴ下線が乗る。
+* Tabs with the same record-driven API as the web `layout/tabs`.
+* Visually they are flush-left underlined tabs matching the web base/tabs:
+* a 2px indigo underline for the active tab sits on a shared faint rule.
 *
-* タブ数が増えても折り返さないよう横スクロールする（web の `flex-wrap` の代わり）。
+* They scroll horizontally so they never wrap as the tab count grows (instead of web's `flex-wrap`).
 */
 function Tabs({ tabs, defaultValue, value, onValueChange, trailing, className }) {
 	const keys = Object.keys(tabs);

package/dist/native/layout/tuning-panel.d.ts

@@ -1,24 +1,24 @@
 import { Tuning, TuningCatalog } from "../../tuning/types.js";
 //#region src/native/layout/tuning-panel.d.ts
 export type TuningPanelProps = {
-  /** 調整の内容（既定との差分）。保存先はアプリが持つ。 */
+  /** The tuning content (the difference from the defaults). Where it is stored is up to the app. */
   tuning: Tuning;
   onChange: (next: Tuning) => void;
-  /** 調整の対象。既定は love3 の生成物。 */
+  /** What is tuned. Defaults to love3's generated output. */
   catalog?: TuningCatalog;
-  /** 書き出したとき（コピー・共有などはアプリが決める）。JSON の文字列が渡る。 */
+  /** Called on export (copying, sharing, etc. is up to the app). Receives the JSON string. */
   onExport?: (json: string) => void;
 };
 /**
- * native の調整の画面（最小限）。トークンを動かし、`love3-tuning` の JSON で書き出し・読み込みする。web の `/tuning` と同じ形式。
+ * The native tuning screen (minimal). Moves tokens and exports/imports them as `love3-tuning` JSON, the same format as web's `/tuning`.
  *
- * - 色: 今のテーマ（ライト・ダーク）の値を 16 進で編集する。読めない値は赤い枠のままで、適用しない
- * - 角丸: 役割ごとに px（実機ではビルド時に固定されるので効かない。JSON には残る）
- * - JSON: 「書き出す」で今の調整を欄に出し（`onExport` にも渡す）、「読み込む」で欄の JSON を検証して適用する。
- *   1 つでも不正なら全体を断り、理由を出す（部分適用しない）
- * - 実機で効かない項目は、`nativeLimits` の説明を出す
+ * - Colors: edits the current theme's (light or dark) values in hex. An unreadable value keeps a red border and is not applied
+ * - Radius: px per role (fixed at build time on real devices, so it has no effect there; it remains in the JSON)
+ * - JSON: "書き出す" (Export) puts the current tuning in the field (and also passes it to `onExport`); "読み込む" (Import) validates the JSON in the field and applies it.
+ *   If even one entry is invalid, the whole input is rejected and the reasons are shown (no partial application)
+ * - For items that have no effect on real devices, the `nativeLimits` explanation is shown
  *
- * 作り込みはしない（love3 の native 部品だけで組んだ検証用）。
+ * It is not polished (a verification screen built only from love3's native components).
  */
 export declare function TuningPanel({ tuning, onChange, catalog, onExport }: TuningPanelProps): import("react").JSX.Element;
 //#endregion

package/dist/native/layout/tuning-panel.js

@@ -15,7 +15,7 @@ import { View } from "react-native";
 import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/native/layout/tuning-panel.tsx
-/** 色の編集に出すトークンの区分（ランプ・主操作・状態・チャート。ブランド色は共通なので別）。 */
+/** Token groups shown in the color editor (ramp, primary action, state, chart; brand colors are shared, so they are separate). */
 const EDITABLE_GROUPS = /* @__PURE__ */ new Set([
 	"ramp",
 	"action",
@@ -23,15 +23,15 @@ const EDITABLE_GROUPS = /* @__PURE__ */ new Set([
 	"chart"
 ]);
 /**
-* native の調整の画面（最小限）。トークンを動かし、`love3-tuning` の JSON で書き出し・読み込みする。web の `/tuning` と同じ形式。
+* The native tuning screen (minimal). Moves tokens and exports/imports them as `love3-tuning` JSON, the same format as web's `/tuning`.
 *
-* - 色: 今のテーマ（ライト・ダーク）の値を 16 進で編集する。読めない値は赤い枠のままで、適用しない
-* - 角丸: 役割ごとに px（実機ではビルド時に固定されるので効かない。JSON には残る）
-* - JSON: 「書き出す」で今の調整を欄に出し（`onExport` にも渡す）、「読み込む」で欄の JSON を検証して適用する。
-*   1 つでも不正なら全体を断り、理由を出す（部分適用しない）
-* - 実機で効かない項目は、`nativeLimits` の説明を出す
+* - Colors: edits the current theme's (light or dark) values in hex. An unreadable value keeps a red border and is not applied
+* - Radius: px per role (fixed at build time on real devices, so it has no effect there; it remains in the JSON)
+* - JSON: "書き出す" (Export) puts the current tuning in the field (and also passes it to `onExport`); "読み込む" (Import) validates the JSON in the field and applies it.
+*   If even one entry is invalid, the whole input is rejected and the reasons are shown (no partial application)
+* - For items that have no effect on real devices, the `nativeLimits` explanation is shown
 *
-* 作り込みはしない（love3 の native 部品だけで組んだ検証用）。
+* It is not polished (a verification screen built only from love3's native components).
 */
 function TuningPanel({ tuning, onChange, catalog: catalog$1 = catalog, onExport }) {
 	const scheme = useActiveScheme();
@@ -152,7 +152,7 @@ function TuningPanel({ tuning, onChange, catalog: catalog$1 = catalog, onExport
 		]
 	});
 }
-/** 入力が読めないときの理由。行の下に `role="alert"` で出し、入力欄から `aria-describedby` で結ぶ。 */
+/** The reason shown when the input is unreadable. Rendered under the row with `role="alert"` and linked from the input via `aria-describedby`. */
 function Reason({ id, text }) {
 	return /* @__PURE__ */ jsx(Text$1, {
 		id,
@@ -162,10 +162,10 @@ function Reason({ id, text }) {
 	});
 }
 /**
-* 色 1 件。**入力中の文字（draft）を自分で持ち、フォーカスが外れるまで欄に出し続ける**（`#abc` は有効な 3 桁の形だが、
-* 6 桁の途中でもある。反映した値で欄を置き換えると、6 桁を打ち切れない）。読める値になったら、打つたびに反映する
-* （反映した値は正規の形 `#aabbcc` になるが、欄には打った文字のまま）。外れたら、反映した値（正規の形）を欄に出す。
-* 読めない値は理由を出し、反映しない。
+* One color. **Keeps its own in-progress text (draft) and keeps showing it in the field until focus leaves** (`#abc` is a valid 3-digit form
+* but may also be partway through a 6-digit one; replacing the field with the applied value would make it impossible to finish typing 6 digits). Once the value is readable, it is applied on every keystroke
+* (the applied value takes the canonical form `#aabbcc`, but the field keeps the text as typed). On blur, the applied value (canonical form) is shown in the field.
+* An unreadable value shows a reason and is not applied.
 */
 function ColorRow({ name, value, alpha, onCommit }) {
 	const reasonId = useId();
@@ -202,13 +202,13 @@ function ColorRow({ name, value, alpha, onCommit }) {
 		})]
 	});
 }
-/** 角丸の入力の問題（読めて、範囲内なら undefined）。 */
+/** The problem with a radius input (undefined if it is readable and within range). */
 function radiusProblem(text) {
 	const number = Number(text);
 	if (text.trim() === "" || !Number.isFinite(number)) return `角丸は数で入力してください（0〜${64}）`;
 	if (number < 0 || number > 64) return `角丸は 0〜${64} の数で入力してください（実際: ${text}）`;
 }
-/** 角丸 1 件。色と同じく、入力中の文字（`6.` など）は外れるまで欄に出し続ける。 */
+/** One radius. As with colors, in-progress text (such as `6.`) keeps showing in the field until focus leaves. */
 function RadiusRow({ role, value, onCommit }) {
 	const reasonId = useId();
 	const [draft, setDraft] = useState(null);

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

@@ -2,6 +2,6 @@ import { TextInputProps } from "react-native";
 //#region src/native/lib/autocomplete.d.ts
 export type AutoComplete = NonNullable<TextInputProps["autoComplete"]>;
 export type TextContentType = NonNullable<TextInputProps["textContentType"]>;
-/** iOS の `textContentType`。対応する語が無ければ `undefined`（iOS の既定に任せる）。 */
+/** iOS `textContentType`. `undefined` if there is no corresponding word (leave it to the iOS default). */
 export declare function textContentTypeOf(autoComplete: AutoComplete | undefined): TextContentType | undefined;
 //#endregion

package/dist/native/lib/autocomplete.js

@@ -25,7 +25,7 @@ const CONTENT_TYPE = {
 	"cc-number": "creditCardNumber",
 	off: "none"
 };
-/** iOS の `textContentType`。対応する語が無ければ `undefined`（iOS の既定に任せる）。 */
+/** iOS `textContentType`. `undefined` if there is no corresponding word (leave it to the iOS default). */
 function textContentTypeOf(autoComplete) {
 	return autoComplete === void 0 ? void 0 : CONTENT_TYPE[autoComplete];
 }

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

@@ -1,5 +1,5 @@
 //#region src/native/lib/breakpoints.d.ts
-/** web（Tailwind）と同じブレークポイント（px）。 */
+/** Same breakpoints (px) as web (Tailwind). */
 export declare const BREAKPOINT: {
   readonly sm: 640;
   readonly md: 768;
@@ -7,8 +7,8 @@ export declare const BREAKPOINT: {
 };
 export type Breakpoint = keyof typeof BREAKPOINT;
 /**
- * `hideBelow` の列を、この画面の幅で出すか。ブレークポイントちょうどの幅は**出す**（Tailwind の `sm:` は 640px 以上）。
- * 指定が無ければ常に出す。
+ * Whether to show a `hideBelow` column at this screen width. A width exactly at the breakpoint **shows** it (Tailwind's `sm:` is 640px and up).
+ * If unspecified, always shown.
  */
 export declare function isShownAtWidth(hideBelow: Breakpoint | undefined, width: number): boolean;
 //#endregion

package/dist/native/lib/breakpoints.js

@@ -1,13 +1,13 @@
 //#region src/native/lib/breakpoints.ts
-/** web（Tailwind）と同じブレークポイント（px）。 */
+/** Same breakpoints (px) as web (Tailwind). */
 const BREAKPOINT = {
 	sm: 640,
 	md: 768,
 	lg: 1024
 };
 /**
-* `hideBelow` の列を、この画面の幅で出すか。ブレークポイントちょうどの幅は**出す**（Tailwind の `sm:` は 640px 以上）。
-* 指定が無ければ常に出す。
+* Whether to show a `hideBelow` column at this screen width. A width exactly at the breakpoint **shows** it (Tailwind's `sm:` is 640px and up).
+* If unspecified, always shown.
 */
 function isShownAtWidth(hideBelow, width) {
 	return hideBelow === void 0 || width >= BREAKPOINT[hideBelow];

package/dist/native/lib/chart-palette.d.ts

@@ -1,8 +1,8 @@
 //#region src/native/lib/chart-palette.d.ts
 /**
- * チャートの既定配色。web の `--chart-1` 〜 `--chart-5`（色で系列を分ける 5 色。ダークでも読める別の値を持つ）と同じ順序で返す。
+ * Default chart colors, returned in the same order as the web `--chart-1` to `--chart-5` (five colors that separate series by hue; each has a distinct value that stays readable in dark mode).
  *
- * `--chart-*` は、ライト・ダークで別の値を持つ生の色のトークンなので、そのまま実値を引ける。`.dark` にも追従する。
+ * `--chart-*` are raw color tokens with separate light and dark values, so the actual values can be looked up directly. They also follow `.dark`.
  */
 export declare function useChartPalette(): string[];
 //#endregion

package/dist/native/lib/chart-palette.js

@@ -2,9 +2,9 @@ import { useTokenColor } from "./token-color.js";
 
 //#region src/native/lib/chart-palette.ts
 /**
-* チャートの既定配色。web の `--chart-1` 〜 `--chart-5`（色で系列を分ける 5 色。ダークでも読める別の値を持つ）と同じ順序で返す。
+* Default chart colors, returned in the same order as the web `--chart-1` to `--chart-5` (five colors that separate series by hue; each has a distinct value that stays readable in dark mode).
 *
-* `--chart-*` は、ライト・ダークで別の値を持つ生の色のトークンなので、そのまま実値を引ける。`.dark` にも追従する。
+* `--chart-*` are raw color tokens with separate light and dark values, so the actual values can be looked up directly. They also follow `.dark`.
 */
 function useChartPalette() {
 	return [

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

@@ -11,39 +11,38 @@ export type ConfirmDialogValue = {
   title?: string;
   description?: string;
   buttons?: ConfirmDialogButton[];
-  /** 外側を押したとき。未指定なら閉じない。`close` を呼ぶと閉じる。 */
+  /** When the outside is pressed. If unspecified, it does not close. Calling `close` closes it. */
   onOutsideClick?: (close: () => void) => void;
   /**
-   * ボタンを押さずに閉じられたとき（Escape・Android の戻る操作など）に描画側が呼ぶ。
-   * `confirm()` はこれで false を解決し、待っている呼び出し側が固まらないようにする。
+   * Called by the renderer when it is dismissed without a button press (Escape, the Android back action, etc.).
+   * `confirm()` resolves false with it so that the waiting caller does not hang.
    */
   onDismiss?: () => void;
 };
-/** `ConfirmDialog` が読む状態。命令的な API（`confirm()`）がここへ書く。 */
+/** State read by `ConfirmDialog`. The imperative API (`confirm()`) writes here. */
 export declare const confirmDialogStore: ExternalStore<ConfirmDialogValue>;
-/** 開いている確認ダイアログを閉じる（内容は残す。閉じるアニメーションの間、文字が消えないように）。 */
+/** Closes the open confirm dialog (keeps its content, so the text does not vanish during the closing animation). */
 export declare function closeConfirmDialog(): void;
 /**
- * `ConfirmDialog` がマウントされている間だけ呼ぶ（`once/confirm` が effect で呼ぶ）。戻り値は解除。
- * **最後の 1 つが外れたとき、開いたままの確認は false で解決して閉じる**（開いたまま unmount すると、待っている呼び出し側が
- * 固まり、次にマウントしたときに古い確認が出てしまう）。
+ * Call only while a `ConfirmDialog` is mounted (`once/confirm` calls it in an effect). Returns an unsubscribe function.
+ * **When the last one detaches, a confirm left open is resolved with false and closed** (if it unmounted while open, the waiting caller would
+ * hang, and an old confirm would appear the next time one mounts).
  */
 export declare function registerConfirmDialog(): () => void;
 export type ConfirmOptions = {
   description?: string;
-  /** 「はい」側のボタンの文言（既定「はい」）。 */
+  /** Label of the "yes" button (default "はい"). */
   yes?: string;
-  /** 「いいえ」側のボタンの文言（既定「いいえ」）。 */
+  /** Label of the "no" button (default "いいえ"). */
   no?: string;
-  /** 取り消せない操作の確認では `destructive` を渡し、見た目でも危険だと分かるようにする。 */
+  /** Pass `destructive` for confirming irreversible actions, so it also looks dangerous. */
   yesVariant?: ButtonProps["variant"];
 };
 /**
- * 確認ダイアログを開き、押されたボタンで解決する（はい = true、いいえ・外側・戻る操作 = false）。
- * アプリのルートに `once/confirm` の `ConfirmDialog` を 1 つ置いておく（**置いていないと、開かず、解決もしない**。開発時は警告を出す。
- * 後から置くと、その時点で開く）。
- * 移植元の `@lt-three/core` の `confirm(i18n, message, options)` から、i18n の引数を外した
- * （love3 は i18n に依存しない。文言は `yes` / `no` で渡し、既定は日本語）。
+ * Opens a confirm dialog and resolves with the pressed button (yes = true; no, outside press, back action = false).
+ * Place one `ConfirmDialog` from `once/confirm` at the app root (**without it, it neither opens nor resolves**; a warning is logged in development.
+ * If placed later, it opens at that point).
+ * Takes no i18n argument: love3 does not depend on i18n, text is passed as `yes` / `no`, and the defaults are Japanese.
  */
 export declare function confirm(message: string, options?: ConfirmOptions): Promise<boolean>;
 //#endregion

package/dist/native/lib/confirm.js

@@ -2,9 +2,9 @@ import { NO_LABEL, YES_LABEL } from "./labels.js";
 import { createExternalStore } from "./external-store.js";
 
 //#region src/native/lib/confirm.ts
-/** `ConfirmDialog` が読む状態。命令的な API（`confirm()`）がここへ書く。 */
+/** State read by `ConfirmDialog`. The imperative API (`confirm()`) writes here. */
 const confirmDialogStore = createExternalStore({ isOpen: false });
-/** 開いている確認ダイアログを閉じる（内容は残す。閉じるアニメーションの間、文字が消えないように）。 */
+/** Closes the open confirm dialog (keeps its content, so the text does not vanish during the closing animation). */
 function closeConfirmDialog() {
 	confirmDialogStore.update((prev) => ({
 		...prev,
@@ -13,9 +13,9 @@ function closeConfirmDialog() {
 }
 let mountedDialogs = 0;
 /**
-* `ConfirmDialog` がマウントされている間だけ呼ぶ（`once/confirm` が effect で呼ぶ）。戻り値は解除。
-* **最後の 1 つが外れたとき、開いたままの確認は false で解決して閉じる**（開いたまま unmount すると、待っている呼び出し側が
-* 固まり、次にマウントしたときに古い確認が出てしまう）。
+* Call only while a `ConfirmDialog` is mounted (`once/confirm` calls it in an effect). Returns an unsubscribe function.
+* **When the last one detaches, a confirm left open is resolved with false and closed** (if it unmounted while open, the waiting caller would
+* hang, and an old confirm would appear the next time one mounts).
 */
 function registerConfirmDialog() {
 	mountedDialogs += 1;
@@ -28,11 +28,10 @@ function registerConfirmDialog() {
 }
 let pendingResolve = null;
 /**
-* 確認ダイアログを開き、押されたボタンで解決する（はい = true、いいえ・外側・戻る操作 = false）。
-* アプリのルートに `once/confirm` の `ConfirmDialog` を 1 つ置いておく（**置いていないと、開かず、解決もしない**。開発時は警告を出す。
-* 後から置くと、その時点で開く）。
-* 移植元の `@lt-three/core` の `confirm(i18n, message, options)` から、i18n の引数を外した
-* （love3 は i18n に依存しない。文言は `yes` / `no` で渡し、既定は日本語）。
+* Opens a confirm dialog and resolves with the pressed button (yes = true; no, outside press, back action = false).
+* Place one `ConfirmDialog` from `once/confirm` at the app root (**without it, it neither opens nor resolves**; a warning is logged in development.
+* If placed later, it opens at that point).
+* Takes no i18n argument: love3 does not depend on i18n, text is passed as `yes` / `no`, and the defaults are Japanese.
 */
 function confirm(message, options) {
 	const { description, yes, no, yesVariant } = options ?? {};

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

@@ -1,12 +1,12 @@
 //#region src/native/lib/control.d.ts
 /**
- * 入力の部品（`atom/text-field` `checkbox` `switch` `slider`）が、フォームの外装（`base/form` の `FormControl`）から受け取る
- * アクセシビリティの props。web の `FormControl`（Radix の Slot が直下の入力に `id` / `aria-*` を渡す）に対応する。
+ * The accessibility props that input components (`atom/text-field`, `checkbox`, `switch`, `slider`) receive from the form wrapper (`FormControl` in `base/form`).
+ * Corresponds to the web `FormControl` (Radix's Slot passes `id` / `aria-*` to the direct child input).
  *
- * - `id` / `aria-labelledby` / `aria-describedby` / `aria-invalid`: react-native-web は DOM に出す（ラベルや説明との紐付けが効く）。
- *   実機の React Native は `aria-labelledby` を Android だけ、`aria-describedby` は読まないので、
- *   実機の読み上げには `accessibilityLabel` と `accessibilityHint` を渡す（フォームの部品が文字列のときに渡す）
- * - `accessibilityHint`: 補足（`description`）。実機の VoiceOver / TalkBack が名前のあとに読む
+ * - `id` / `aria-labelledby` / `aria-describedby` / `aria-invalid`: react-native-web emits them to the DOM (association with the label and description works).
+ *   Real-device React Native honors `aria-labelledby` on Android only and does not read `aria-describedby`,
+ *   so for real-device screen readers, pass `accessibilityLabel` and `accessibilityHint` (passed when the form's parts are strings)
+ * - `accessibilityHint`: supplementary text (`description`). Real-device VoiceOver / TalkBack reads it after the name
  */
 export type ControlA11yProps = {
   id?: string;
@@ -16,9 +16,9 @@ export type ControlA11yProps = {
   accessibilityHint?: string;
 };
 /**
- * 名前を自分で持つ入力（`atom/checkbox`＝右のラベル、`atom/slider`＝自分の `label`）が受ける props。
- * `aria-labelledby` は**型に含めない**（受け口が無いのに受けて黙って捨てない）。フォームの外装のラベルを名前にしたい入力
- * （`text-field`・`switch`）だけが `ControlA11yProps` の全部を受ける。
+ * Props received by inputs that carry their own name (`atom/checkbox` = the label on the right, `atom/slider` = its own `label`).
+ * `aria-labelledby` is **not included in the type** (no silently dropping what has nowhere to go). Only inputs that want the form wrapper's label as their name
+ * (`text-field`, `switch`) accept all of `ControlA11yProps`.
  */
 export type NamedControlA11yProps = Omit<ControlA11yProps, "aria-labelledby">;
 //#endregion

package/dist/native/lib/external-store.d.ts

@@ -1,16 +1,15 @@
 //#region src/native/lib/external-store.d.ts
 /**
- * 命令的な API（`confirm()`・`globalLoading()`）と、ルートに置く部品（`ConfirmDialog`・`LoadingLock`）の橋渡しをする、
- * 小さな外部ストア。`@lt-three/core` は jotai の atom と共有のストアでこれをやっていたが、love3 は jotai に依存しない
- * ので、React の `useSyncExternalStore` で読む。値は不変で扱う（`set` は新しい値を渡す）。
+ * A small external store that bridges the imperative APIs (`confirm()`, `globalLoading()`) and the components placed at the root (`ConfirmDialog`, `LoadingLock`).
+ * love3 does not depend on jotai, so it is read with React's `useSyncExternalStore`. Treat values as immutable (`set` takes a new value).
  */
 export type ExternalStore<T> = {
   get: () => T;
   set: (next: T) => void;
-  /** 前の値から次の値を作る。 */
+  /** Builds the next value from the previous one. */
   update: (updater: (prev: T) => T) => void;
   subscribe: (listener: () => void) => () => void;
-  /** 部品から読む。値が変わると描き直す。 */
+  /** Read from components. Re-renders when the value changes. */
   use: () => T;
 };
 export declare function createExternalStore<T>(initial: T): ExternalStore<T>;

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

@@ -1,15 +1,15 @@
 import { KeyDownEvent } from "react-native";
 //#region src/native/lib/keyboard.d.ts
 /**
- * Space で `activate` を呼ぶ `onKeyDown`（`Pressable` に渡す）。
+ * An `onKeyDown` that calls `activate` on Space (pass it to `Pressable`).
  *
- * react-native-web の `Pressable` は、Enter では押したことになるが、Space は **`<button>` か `role="button"` のときだけ**
- * 押したことになる（`PressResponder` の `isValidKeyPress`）。`role="radio"` / `"checkbox"` / `"switch"` は Space で動かない。
- * WAI-ARIA の APG は、この 3 つを Space で決定する（キーボードだけの人が選べない = WCAG 2.1.1）。
- * **Enter は react-native-web が押したことにする**ので、ここでは Space だけを扱う（Enter まで扱うと二重に呼ばれる）。
+ * react-native-web's `Pressable` treats Enter as a press, but treats Space as a press **only for `<button>` or `role="button"`**
+ * (`isValidKeyPress` in `PressResponder`). `role="radio"` / `"checkbox"` / `"switch"` do not respond to Space.
+ * The WAI-ARIA APG decides these three with Space (without it, people using only a keyboard cannot select them; WCAG 2.1.1).
+ * **Enter is already handled as a press by react-native-web**, so only Space is handled here (handling Enter too would call it twice).
  *
- * 実機の React Native は、`onKeyDown` を受けるキーを `keyDownEvents` で挙げたものだけにするので、何も渡さないこの使い方では
- * 呼ばれない（実機の挙動は変わらない）。修飾キー（Ctrl・Alt・Meta・Shift）つきと、押しっぱなしの繰り返しは無視する。
+ * Real-device React Native only delivers keys listed in `keyDownEvents` to `onKeyDown`, so with this usage, which passes none, it is
+ * never called (behavior on device does not change). Presses with modifier keys (Ctrl, Alt, Meta, Shift) and held-key repeats are ignored.
  */
 export declare function activateOnSpace(activate: () => void, disabled?: boolean | null): (event: KeyDownEvent) => void;
 //#endregion

package/dist/native/lib/keyboard.js

@@ -1,14 +1,14 @@
 //#region src/native/lib/keyboard.ts
 /**
-* Space で `activate` を呼ぶ `onKeyDown`（`Pressable` に渡す）。
+* An `onKeyDown` that calls `activate` on Space (pass it to `Pressable`).
 *
-* react-native-web の `Pressable` は、Enter では押したことになるが、Space は **`<button>` か `role="button"` のときだけ**
-* 押したことになる（`PressResponder` の `isValidKeyPress`）。`role="radio"` / `"checkbox"` / `"switch"` は Space で動かない。
-* WAI-ARIA の APG は、この 3 つを Space で決定する（キーボードだけの人が選べない = WCAG 2.1.1）。
-* **Enter は react-native-web が押したことにする**ので、ここでは Space だけを扱う（Enter まで扱うと二重に呼ばれる）。
+* react-native-web's `Pressable` treats Enter as a press, but treats Space as a press **only for `<button>` or `role="button"`**
+* (`isValidKeyPress` in `PressResponder`). `role="radio"` / `"checkbox"` / `"switch"` do not respond to Space.
+* The WAI-ARIA APG decides these three with Space (without it, people using only a keyboard cannot select them; WCAG 2.1.1).
+* **Enter is already handled as a press by react-native-web**, so only Space is handled here (handling Enter too would call it twice).
 *
-* 実機の React Native は、`onKeyDown` を受けるキーを `keyDownEvents` で挙げたものだけにするので、何も渡さないこの使い方では
-* 呼ばれない（実機の挙動は変わらない）。修飾キー（Ctrl・Alt・Meta・Shift）つきと、押しっぱなしの繰り返しは無視する。
+* Real-device React Native only delivers keys listed in `keyDownEvents` to `onKeyDown`, so with this usage, which passes none, it is
+* never called (behavior on device does not change). Presses with modifier keys (Ctrl, Alt, Meta, Shift) and held-key repeats are ignored.
 */
 function activateOnSpace(activate, disabled) {
 	return (event) => {

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

@@ -1,15 +1,15 @@
 //#region src/native/lib/labels.d.ts
-/** 読み込み中の表示（Spinner） */
+/** Loading indicator (Spinner) */
 export declare const LOADING_LABEL = "読み込み中";
-/** 確認ダイアログ（`confirm()`）の既定のボタン。使う側は `yes` / `no` で上書きする */
+/** Default buttons of the confirm dialog (`confirm()`). Callers override them with `yes` / `no` */
 export declare const YES_LABEL = "はい";
 export declare const NO_LABEL = "いいえ";
-/** 数値欄（`form/text-input` の `type="number"`）の入力が数として読めないとき */
+/** When the input of a number field (`type="number"` of `form/text-input`) cannot be read as a number */
 export declare const NUMBER_INVALID_LABEL = "数値で入力してください";
-/** 閉じるボタン（Sheet・Modal・Snackbar）。使う側は `closeLabel` で上書きする */
+/** Close button (Sheet, Modal, Snackbar). Callers override it with `closeLabel` */
 export declare const CLOSE_LABEL = "閉じる";
-/** `atom/select` の選択肢の見出し・名前が何も渡されなかったときの、最後の砦（無名のダイアログにしない） */
+/** Last resort for when no heading or name was passed for the options of `atom/select` (so it never becomes an unnamed dialog) */
 export declare const SELECT_LABEL = "選択肢";
-/** `form/select` の placeholder の既定（web の `form/select` と同じ文言） */
+/** Default placeholder of `form/select` (same wording as the web `form/select`) */
 export declare const SELECT_PLACEHOLDER_LABEL = "選択してください";
 //#endregion

package/dist/native/lib/labels.js

@@ -1,16 +1,16 @@
 //#region src/native/lib/labels.ts
-/** 読み込み中の表示（Spinner） */
+/** Loading indicator (Spinner) */
 const LOADING_LABEL = "読み込み中";
-/** 確認ダイアログ（`confirm()`）の既定のボタン。使う側は `yes` / `no` で上書きする */
+/** Default buttons of the confirm dialog (`confirm()`). Callers override them with `yes` / `no` */
 const YES_LABEL = "はい";
 const NO_LABEL = "いいえ";
-/** 数値欄（`form/text-input` の `type="number"`）の入力が数として読めないとき */
+/** When the input of a number field (`type="number"` of `form/text-input`) cannot be read as a number */
 const NUMBER_INVALID_LABEL = "数値で入力してください";
-/** 閉じるボタン（Sheet・Modal・Snackbar）。使う側は `closeLabel` で上書きする */
+/** Close button (Sheet, Modal, Snackbar). Callers override it with `closeLabel` */
 const CLOSE_LABEL = "閉じる";
-/** `atom/select` の選択肢の見出し・名前が何も渡されなかったときの、最後の砦（無名のダイアログにしない） */
+/** Last resort for when no heading or name was passed for the options of `atom/select` (so it never becomes an unnamed dialog) */
 const SELECT_LABEL = "選択肢";
-/** `form/select` の placeholder の既定（web の `form/select` と同じ文言） */
+/** Default placeholder of `form/select` (same wording as the web `form/select`) */
 const SELECT_PLACEHOLDER_LABEL = "選択してください";
 
 //#endregion

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

@@ -1,10 +1,10 @@
 import { ExternalStore } from "./external-store.js";
 //#region src/native/lib/loading.d.ts
-/** `LoadingLock` が読む状態。命令的な API（`globalLoading()`）がここへ書く。 */
+/** State read by `LoadingLock`. The imperative API (`globalLoading()`) writes here. */
 export declare const loadingStore: ExternalStore<boolean>;
 /**
- * アプリ全体の操作を塞ぐローディングを出す・消す。アプリのルートに `once/loading-lock` の `LoadingLock` を 1 つ置いておく。
- * 真偽の 1 つだけを持つ（重ねて呼んでも数えない。最後に `false` を渡した時点で消える。移植元と同じ）。
+ * Shows or hides a loading overlay that blocks interaction across the whole app. Place one `LoadingLock` from `once/loading-lock` at the app root.
+ * Holds a single boolean (repeated calls are not counted; the overlay goes away as soon as `false` is passed).
  */
 export declare function globalLoading(loading: boolean): void;
 //#endregion

package/dist/native/lib/loading.js

@@ -1,11 +1,11 @@
 import { createExternalStore } from "./external-store.js";
 
 //#region src/native/lib/loading.ts
-/** `LoadingLock` が読む状態。命令的な API（`globalLoading()`）がここへ書く。 */
+/** State read by `LoadingLock`. The imperative API (`globalLoading()`) writes here. */
 const loadingStore = createExternalStore(false);
 /**
-* アプリ全体の操作を塞ぐローディングを出す・消す。アプリのルートに `once/loading-lock` の `LoadingLock` を 1 つ置いておく。
-* 真偽の 1 つだけを持つ（重ねて呼んでも数えない。最後に `false` を渡した時点で消える。移植元と同じ）。
+* Shows or hides a loading overlay that blocks interaction across the whole app. Place one `LoadingLock` from `once/loading-lock` at the app root.
+* Holds a single boolean (repeated calls are not counted; the overlay goes away as soon as `false` is passed).
 */
 function globalLoading(loading) {
 	loadingStore.set(loading);

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

@@ -1,12 +1,11 @@
 //#region src/native/lib/network.d.ts
 /**
- * 現在オンラインかどうかを購読する。`once/offline-banner` の表示制御に使う。
- * 移植元（`@lt-three/native` の `hooks/network.ts`）は TanStack Query の `onlineManager` を NetInfo に委譲していたが、
- * love3 は TanStack Query に依存しないので、ここは NetInfo だけを見る（fetch の保留・復帰時の再取得を NetInfo に連動させたいアプリは、
- * 自分で `onlineManager.setEventListener` を NetInfo に繋ぐ）。
+ * Subscribes to whether the device is currently online. Used to control the display of `once/offline-banner`.
+ * It watches NetInfo only and does not depend on TanStack Query (an app that wants to tie fetch pausing and refetch on reconnect to NetInfo
+ * wires `onlineManager.setEventListener` to NetInfo itself).
  *
- * 実機は NetInfo の `isConnected`（判定中の `null` はオンライン扱いにして誤検知を避ける）。
- * web（react-native-web）でも NetInfo は動き、`navigator.onLine` と `online` / `offline` イベントを見る。
+ * On device it uses NetInfo's `isConnected` (a `null` while determining is treated as online to avoid false positives).
+ * On web (react-native-web) NetInfo also works, watching `navigator.onLine` and the `online` / `offline` events.
  */
 export declare function useIsOnline(): boolean;
 //#endregion

package/dist/native/lib/network.js

@@ -3,13 +3,12 @@ import { addEventListener } from "@react-native-community/netinfo";
 
 //#region src/native/lib/network.ts
 /**
-* 現在オンラインかどうかを購読する。`once/offline-banner` の表示制御に使う。
-* 移植元（`@lt-three/native` の `hooks/network.ts`）は TanStack Query の `onlineManager` を NetInfo に委譲していたが、
-* love3 は TanStack Query に依存しないので、ここは NetInfo だけを見る（fetch の保留・復帰時の再取得を NetInfo に連動させたいアプリは、
-* 自分で `onlineManager.setEventListener` を NetInfo に繋ぐ）。
+* Subscribes to whether the device is currently online. Used to control the display of `once/offline-banner`.
+* It watches NetInfo only and does not depend on TanStack Query (an app that wants to tie fetch pausing and refetch on reconnect to NetInfo
+* wires `onlineManager.setEventListener` to NetInfo itself).
 *
-* 実機は NetInfo の `isConnected`（判定中の `null` はオンライン扱いにして誤検知を避ける）。
-* web（react-native-web）でも NetInfo は動き、`navigator.onLine` と `online` / `offline` イベントを見る。
+* On device it uses NetInfo's `isConnected` (a `null` while determining is treated as online to avoid false positives).
+* On web (react-native-web) NetInfo also works, watching `navigator.onLine` and the `online` / `offline` events.
 */
 function useIsOnline() {
 	const [online, setOnline] = useState(true);

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

@@ -1,18 +1,18 @@
 import { TokenName } from "../../tokens/tokens.gen.js";
 //#region src/native/lib/scheme.d.ts
-/** テーマ選択。`system` は端末設定に追従する。保存先（AsyncStorage・設定画面）はアプリの責務で、ここでは持たない。 */
+/** Theme selection. `system` follows the device setting. Where it is stored (AsyncStorage, a settings screen) is the app's responsibility and is not handled here. */
 export type ThemePreference = "system" | "light" | "dark";
-/** 実際に描画に使われるテーマ。 */
+/** The theme actually used for rendering. */
 export type ActiveScheme = "light" | "dark";
-/** 選択と端末のカラースキームから、実際に使うテーマを決める。 */
+/** Decides the theme to actually use from the selection and the device color scheme. */
 export declare function resolveScheme(preference: ThemePreference, system: "light" | "dark" | "unspecified" | null | undefined): ActiveScheme;
-/** 色のトークンの名前（書体 `font-*` と角丸 `radius` を除く）。`useTokenColor` が受けるのはこれだけ。 */
+/** Names of color tokens (excluding the `font-*` typefaces and `radius`). These are the only ones `useTokenColor` accepts. */
 export type ColorTokenName = Exclude<TokenName, `font-${string}` | "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.
  */
 export declare function tokenColor(scheme: ActiveScheme, name: `--${ColorTokenName}` | ColorTokenName,
-/** 調整（`TuningRoot`）が配る実効値。あれば、その値を優先する（実行時の上書きに追従する）。 */
+/** Effective values distributed by tuning (`TuningRoot`). If present, they take priority (following runtime overrides). */
 overlay?: Readonly<Record<ActiveScheme, Readonly<Record<string, string>>>> | null): string;
 //#endregion