@lt-three/love3 0.1.0 → 0.1.1

package/dist/native/atom/text-field.d.ts

@@ -8,42 +8,42 @@ export type TextFieldProps = ControlA11yProps & {
   placeholder?: string;
   type?: TextFieldType;
   disabled?: boolean;
-  /** エラー。罫線が destructive になり、`aria-invalid` が付く（フォームの中では `FormControl` が渡す）。 */
+  /** Error state. The border becomes destructive and `aria-invalid` is set (inside a form, `FormControl` passes it). */
   invalid?: boolean;
   /**
-   * 自動入力の種類（web の `TextInput.autoComplete` と同じ意味の語。`email`・`current-password`・`one-time-code` など）。
-   * RN の `autoComplete` にそのまま渡り、iOS では `textContentType` にも読み替えて渡す（`lib/autocomplete.ts`）。
-   * web より型が狭い（RN が受ける語だけ）。
+   * The kind of autofill (the same terms as the web `TextInput.autoComplete`: `email`, `current-password`, `one-time-code`, etc.).
+   * Passed straight to RN's `autoComplete`, and on iOS also mapped to `textContentType` (`lib/autocomplete.ts`).
+   * The type is narrower than the web's (only the terms RN accepts).
    */
   autoComplete?: AutoComplete;
   autoCapitalize?: "none" | "sentences" | "words" | "characters";
-  /** `false` で自動修正（スマート引用符への置き換えなど）を切る。JSON・コード・ID を打たせる欄に使う。 */
+  /** `false` turns off autocorrection (such as smart-quote replacement). Use it for fields where JSON, code or IDs are typed. */
   autoCorrect?: boolean;
-  /** フォーカスが外れたとき（入力中の文字を確定する・破棄するのに使う）。 */
+  /** Called when focus leaves the field (used to commit or discard the text being typed). */
   onBlur?: () => void;
   multiline?: boolean;
-  /** 複数行のときの行数目安（`multiline` と併用する）。 */
+  /** Approximate number of lines when multiline (use together with `multiline`). */
   numberOfLines?: number;
   onSubmitEditing?: () => void;
   returnKeyType?: "done" | "go" | "next" | "search" | "send";
   accessibilityLabel?: string;
   /**
-   * E2E から一意に掴むための識別子（iOS では accessibilityIdentifier になる）。
+   * An identifier for targeting the field uniquely from E2E (becomes accessibilityIdentifier on iOS).
    *
-   * ラベルと入力欄が同じ文言を持つフォームでは、テキスト一致だと**見出しの方に当たって
-   * 入力が消える**（Maestro で実際に踏んだ）。掴ませたい入力欄には付けること。
+   * In a form where the label and the input share the same text, matching by text **hits the heading
+   * and the input gets cleared** (observed with Maestro). Set it on any input that must be targeted.
    */
   testID?: string;
   className?: string;
 };
 export declare const textFieldClass = "min-h-9 w-full rounded-control border border-line-strong bg-raised px-3 py-1.5 text-sm text-foreground";
 /**
- * 素のテキスト入力。`@lt-three/web` の base/input に対応する入力枠で、
- * TanStack Form を使わない画面（ログイン・設定・メモ欄など）から直接使う。
+ * A plain text input. The input frame corresponding to the web base/input,
+ * used directly on screens that do not use TanStack Form (login, settings, memo fields, etc.).
  *
- * `base/input` は `@expo/ui` の OS ネイティブ TextField なので**トークンで塗れない**。
- * web と同じ見た目にしたい入力はこちらを使うこと。フォーム統合が要るときは
- * `form/text-input`（これを内側で使っている）。
+ * `base/input` is the OS-native TextField from `@expo/ui`, so it **cannot be painted with tokens**.
+ * Use this one for inputs that should look the same as the web. When form integration is needed,
+ * use `form/text-input` (which uses this one internally).
  */
 export declare function TextField({ value, onChangeText, placeholder, type, disabled, invalid, autoComplete, autoCapitalize, autoCorrect, onBlur, multiline, numberOfLines, onSubmitEditing, returnKeyType, accessibilityLabel, accessibilityHint, testID, className, id, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid }: TextFieldProps): import("react").JSX.Element;
 //#endregion

package/dist/native/atom/text-field.js

@@ -14,12 +14,12 @@ const KEYBOARD = {
 	tel: "phone-pad"
 };
 /**
-* 素のテキスト入力。`@lt-three/web` の base/input に対応する入力枠で、
-* TanStack Form を使わない画面（ログイン・設定・メモ欄など）から直接使う。
+* A plain text input. The input frame corresponding to the web base/input,
+* used directly on screens that do not use TanStack Form (login, settings, memo fields, etc.).
 *
-* `base/input` は `@expo/ui` の OS ネイティブ TextField なので**トークンで塗れない**。
-* web と同じ見た目にしたい入力はこちらを使うこと。フォーム統合が要るときは
-* `form/text-input`（これを内側で使っている）。
+* `base/input` is the OS-native TextField from `@expo/ui`, so it **cannot be painted with tokens**.
+* Use this one for inputs that should look the same as the web. When form integration is needed,
+* use `form/text-input` (which uses this one internally).
 */
 function TextField({ value, onChangeText, placeholder, type = "text", disabled, invalid, autoComplete, autoCapitalize, autoCorrect, onBlur, multiline, numberOfLines, onSubmitEditing, returnKeyType, accessibilityLabel, accessibilityHint, testID, className, id, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, "aria-invalid": ariaInvalid }) {
 	const mutedInk = useTokenColor("--ink-500");

package/dist/native/atom/theme-toggle.d.ts

@@ -2,20 +2,20 @@ import { ActiveScheme } from "../lib/scheme.js";
 import "../lib/theme.js";
 //#region src/native/atom/theme-toggle.d.ts
 export type ThemeToggleProps = {
-  /** 切り替えたいテーマ（`light` / `dark`）を受け取る。保存先（AsyncStorage・jotai など）はアプリが持つ。 */
+  /** Receives the theme to switch to (`light` / `dark`). Where it is stored (AsyncStorage, jotai, etc.) is up to the app. */
   onSchemeChange: (scheme: ActiveScheme) => void;
-  /** いまのテーマ。省略すると `useActiveScheme()`（`ThemeRoot`、無ければ端末の設定）に従う。 */
+  /** The current theme. When omitted, follows `useActiveScheme()` (`ThemeRoot`, or the device setting if there is none). */
   scheme?: ActiveScheme;
-  /** スクリーンリーダー向けのラベル。 */
+  /** Label for screen readers. */
   accessibilityLabel?: string;
   className?: string;
 };
 /**
- * ライト / ダークを 1 タップで入れ替える。
- * 「システム追従」を含む 3 択が要るなら、アプリが `ThemeRoot` の `preference` を直接持つ。
+ * Switches between light and dark with a single tap.
+ * If a three-way choice including "follow system" is needed, the app owns the `ThemeRoot` `preference` directly.
  *
- * 移植元は jotai の `themePreferenceAtom` を直接書き換えていた。love3 はテーマの保存先を持たない（`ThemeRoot` は
- * `preference` を props で受ける）ので、`onSchemeChange` で次のテーマを渡す形にした。
+ * love3 has no place to store the theme (`ThemeRoot` receives
+ * `preference` via props), so the next theme is handed over through `onSchemeChange`.
  */
 export declare function ThemeToggle({ onSchemeChange, scheme: schemeProp, accessibilityLabel, className }: ThemeToggleProps): import("react").JSX.Element;
 //#endregion

package/dist/native/atom/theme-toggle.js

@@ -7,11 +7,11 @@ import Feather from "@expo/vector-icons/Feather";
 
 //#region src/native/atom/theme-toggle.tsx
 /**
-* ライト / ダークを 1 タップで入れ替える。
-* 「システム追従」を含む 3 択が要るなら、アプリが `ThemeRoot` の `preference` を直接持つ。
+* Switches between light and dark with a single tap.
+* If a three-way choice including "follow system" is needed, the app owns the `ThemeRoot` `preference` directly.
 *
-* 移植元は jotai の `themePreferenceAtom` を直接書き換えていた。love3 はテーマの保存先を持たない（`ThemeRoot` は
-* `preference` を props で受ける）ので、`onSchemeChange` で次のテーマを渡す形にした。
+* love3 has no place to store the theme (`ThemeRoot` receives
+* `preference` via props), so the next theme is handed over through `onSchemeChange`.
 */
 function ThemeToggle({ onSchemeChange, scheme: schemeProp, accessibilityLabel = "テーマ切り替え", className }) {
 	const active = useActiveScheme();

package/dist/native/atom/timezone-select.d.ts

@@ -1,16 +1,16 @@
 import { SelectProps } from "./select.js";
 //#region src/native/atom/timezone-select.d.ts
 export type TimezoneSelectProps = Pick<SelectProps, "label" | "description" | "placeholder" | "disabled" | "size" | "className" | "wrapperClassName" | "sheetTitle" | "closeLabel" | "accessibilityLabel"> & {
-  /** 選択中の IANA タイムゾーン。空文字は「まだ決まっていない」（placeholder を出す）。 */
+  /** The selected IANA time zone. An empty string means "not decided yet" (the placeholder is shown). */
   value: string;
   onValueChange: (zone: string) => void;
 };
 /**
- * タイムゾーン（IANA 文字列）を選ぶ Select。`@lt-three/web` の atom/timezone-select と同じ名前・同じ props。
+ * A Select for choosing a time zone (IANA string). Same name and props as the web atom/timezone-select.
  *
- * 選択肢は主要な都市の固定リストに、この端末のタイムゾーンと選択中の値を足したもの（`lib/timezone.ts`）。
- * Hermes に `Intl.supportedValuesOf` が無いので固定リストにしている。
- * 下から出るシートで選ぶので、`closeLabel` は呼び出し側の言語で渡すこと（既定は日本語）。
+ * The options are a fixed list of major cities plus this device's time zone and the selected value (`lib/timezone.ts`).
+ * The list is fixed because Hermes has no `Intl.supportedValuesOf`.
+ * It is chosen in a bottom sheet, so pass `closeLabel` in the caller's language (the default is Japanese).
  */
 export declare function TimezoneSelect({ value, onValueChange, ...props }: TimezoneSelectProps): import("react").JSX.Element;
 //#endregion

package/dist/native/atom/timezone-select.js

@@ -5,11 +5,11 @@ import { jsx } from "react/jsx-runtime";
 
 //#region src/native/atom/timezone-select.tsx
 /**
-* タイムゾーン（IANA 文字列）を選ぶ Select。`@lt-three/web` の atom/timezone-select と同じ名前・同じ props。
+* A Select for choosing a time zone (IANA string). Same name and props as the web atom/timezone-select.
 *
-* 選択肢は主要な都市の固定リストに、この端末のタイムゾーンと選択中の値を足したもの（`lib/timezone.ts`）。
-* Hermes に `Intl.supportedValuesOf` が無いので固定リストにしている。
-* 下から出るシートで選ぶので、`closeLabel` は呼び出し側の言語で渡すこと（既定は日本語）。
+* The options are a fixed list of major cities plus this device's time zone and the selected value (`lib/timezone.ts`).
+* The list is fixed because Hermes has no `Intl.supportedValuesOf`.
+* It is chosen in a bottom sheet, so pass `closeLabel` in the caller's language (the default is Japanese).
 */
 function TimezoneSelect({ value, onValueChange, ...props }) {
 	const options = useMemo(() => timeZoneOptions(getDeviceTimeZone(), value).map((zone) => ({

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

@@ -6,8 +6,8 @@ export type SectionTitleProps = {
   className?: string;
 };
 /**
- * セクション見出し。`@lt-three/web` の atom/typography の SectionTitle に対応する。
- * 左端の 2px インディゴのバー + 太字の見出し + 任意の説明という同じ構成。
+ * A section heading. Mirrors SectionTitle of the web atom/typography.
+ * Same structure: a 2px indigo bar on the left edge + a bold heading + an optional description.
  */
 export declare function SectionTitle({ children, description, className }: SectionTitleProps): import("react").JSX.Element;
 //#endregion

package/dist/native/atom/typography.js

@@ -5,8 +5,8 @@ import { jsx, jsxs } from "react/jsx-runtime";
 
 //#region src/native/atom/typography.tsx
 /**
-* セクション見出し。`@lt-three/web` の atom/typography の SectionTitle に対応する。
-* 左端の 2px インディゴのバー + 太字の見出し + 任意の説明という同じ構成。
+* A section heading. Mirrors SectionTitle of the web atom/typography.
+* Same structure: a 2px indigo bar on the left edge + a bold heading + an optional description.
 */
 function SectionTitle({ children, description, className }) {
 	return /* @__PURE__ */ jsxs(View, {

package/dist/native/base/button.d.ts

@@ -3,10 +3,10 @@ import { ReactNode } from "react";
 import { ViewStyle } from "react-native";
 //#region src/native/base/button.d.ts
 /**
- * ボタンの見た目バリアント。**`atom/button`（と web の Button）と同じ名前**（`@lt-three/love3/shared` の `ButtonVariant`）に、
- * iOS 26 の Liquid Glass だけの `glass` を足したもの。
- * - `glass`: iOS 26 の Liquid Glass ボタン（主要アクション向け。iOS 26 未満・Android では塗りつぶしに落ちる）
- * - ほかは `atom/button` と同じ意味。OS のコントロールが持つ 3 つの形（塗り・枠・文字だけ）に写す（下の表）
+ * The button's appearance variants. **The same names as `atom/button` (and the web Button)** (`ButtonVariant` from `@lt-three/love3/shared`),
+ * plus `glass`, which exists only for iOS 26 Liquid Glass.
+ * - `glass`: the iOS 26 Liquid Glass button (for primary actions; falls back to a filled button below iOS 26 and on Android)
+ * - The others mean the same as in `atom/button`. They are mapped onto the three shapes the OS control has (filled, outlined, text only) (see the tables below)
  */
 export type NativeButtonVariant = ButtonVariant | "glass";
 declare const IOS_BUTTON_STYLE: {
@@ -37,24 +37,24 @@ type ButtonProps = {
   disabled?: boolean;
   variant?: NativeButtonVariant;
   /**
-   * アクセント色（iOS の SwiftUI `.tint()`）。省略すると、variant に合わせたトークンの色
-   * （`default` は主操作のインディゴ、`destructive` は destructive-solid、`<3` はブランド色）。
+   * The accent color (SwiftUI `.tint()` on iOS). When omitted, the token color matching the variant
+   * (`default` is the primary action's indigo, `destructive` is destructive-solid, `<3` is the brand color).
    */
   tintColor?: string;
   /**
-   * ラベル文字色（iOS の SwiftUI `.foregroundStyle()`）。省略すると、塗りの上で読める組のトークンの色。
-   * prominent 系は既定でラベルが白のため、明るい tint と組み合わせると読めなくなる（反転する面でも同じ）。
+   * The label text color (SwiftUI `.foregroundStyle()` on iOS). When omitted, the token color paired to be readable on the fill.
+   * Prominent styles default to a white label, so combining them with a light tint makes the label unreadable (the same applies on surfaces that invert).
    */
   labelColor?: string;
-  /** Host コンテナ（RN View）に適用するスタイル。幅・余白の調整に使う。 */
+  /** Style applied to the Host container (an RN View). Used to adjust width and margins. */
   style?: ViewStyle;
 };
 /**
- * ネイティブボタン（OS のコントロールの層）。iOS は SwiftUI の `Button`、Android は Jetpack Compose の
- * `Button` を描画する（`@expo/ui` universal 経由）。iOS 26 では `glass` が Liquid Glass になる。
+ * The native button (the OS control layer). Renders SwiftUI's `Button` on iOS and Jetpack Compose's
+ * `Button` on Android (via `@expo/ui` universal). On iOS 26, `glass` becomes Liquid Glass.
  *
- * `atom/button`（RN の `Pressable`。トークンで塗るボタン）に対する、**OS ネイティブ版の base 層**。
- * web と同じ見た目にしたい場所は `atom/button`、OS の標準の見た目・触感がほしい場所はこちら。
+ * The **OS-native base layer** counterpart of `atom/button` (an RN `Pressable`, a button painted with tokens).
+ * Use `atom/button` where it should look the same as the web, and this one where the OS's standard look and feel is wanted.
  */
 declare function Button({ children, onPress, disabled, variant, tintColor, labelColor, style }: ButtonProps): import("react").JSX.Element;
 //#endregion

package/dist/native/base/button.js

@@ -28,11 +28,11 @@ const UNIVERSAL_VARIANT = {
 	glass: "filled"
 };
 /**
-* ネイティブボタン（OS のコントロールの層）。iOS は SwiftUI の `Button`、Android は Jetpack Compose の
-* `Button` を描画する（`@expo/ui` universal 経由）。iOS 26 では `glass` が Liquid Glass になる。
+* The native button (the OS control layer). Renders SwiftUI's `Button` on iOS and Jetpack Compose's
+* `Button` on Android (via `@expo/ui` universal). On iOS 26, `glass` becomes Liquid Glass.
 *
-* `atom/button`（RN の `Pressable`。トークンで塗るボタン）に対する、**OS ネイティブ版の base 層**。
-* web と同じ見た目にしたい場所は `atom/button`、OS の標準の見た目・触感がほしい場所はこちら。
+* The **OS-native base layer** counterpart of `atom/button` (an RN `Pressable`, a button painted with tokens).
+* Use `atom/button` where it should look the same as the web, and this one where the OS's standard look and feel is wanted.
 */
 function Button({ children, onPress, disabled, variant = "default", tintColor, labelColor, style }) {
 	const primary = useTokenColor("--primary");

package/dist/native/base/form.d.ts

@@ -1,10 +1,10 @@
 import { ReactNode } from "react";
 //#region src/native/base/form.d.ts
 /**
- * 外装の id の組と、エラー。`FormItem` の中で使う。フィールドの外（制御モード）でも落ちない。
+ * The set of chrome ids and the errors. Use it inside `FormItem`. It does not crash outside a field (controlled mode) either.
  *
- * **表示するエラーはここで 1 つに決める**（field のエラー + `FormItem` の `errors`）。`FormLabel` の色・`FormMessage` の文・
- * `FormControl` の `aria-invalid` / `aria-describedby` は全部これを読むので、文が出ているのに `aria-invalid` が無い、などの食い違いが起きない。
+ * **The errors to display are decided in one place here** (the field's errors + the `errors` of `FormItem`). The `FormLabel` color, the `FormMessage` text and
+ * the `FormControl` `aria-invalid` / `aria-describedby` all read from it, so mismatches such as a message being shown without `aria-invalid` cannot occur.
  */
 export declare function useFormField(): {
   id: string;
@@ -18,9 +18,9 @@ export declare function FormItem({ children, className, errors }: {
   children: ReactNode;
   className?: string;
   /**
-   * field（TanStack Form）のエラーに**足す**エラー。フィールドの外で使うとき、またはフィールドの中でも入力の部品自身が
-   * 持つエラー（数値欄の「数として読めない」など）を出したいときに使う。入力の `aria-invalid` と `aria-describedby`、
-   * ラベルの色、`FormMessage` の表示に同じように効く。空配列を渡しても、field のエラーは隠れない。
+   * Errors **added to** the field's (TanStack Form) errors. Use it outside a field, or inside a field when you want to show an error
+   * owned by the input component itself (such as "not readable as a number" on a numeric field). It affects the input's `aria-invalid` and `aria-describedby`,
+   * the label color and the `FormMessage` display alike. Passing an empty array does not hide the field's errors.
    */
   errors?: readonly unknown[];
 }): import("react").JSX.Element;
@@ -30,7 +30,7 @@ export declare function FormLabel({ children, required, helpText, className }: {
   helpText?: ReactNode;
   className?: string;
 }): import("react").JSX.Element;
-/** `FormControl` が入力の部品に渡す props（部品の `ControlA11yProps` と同じ形）。 */
+/** The props `FormControl` passes to the input component (the same shape as the component's `ControlA11yProps`). */
 export type FormControlProps = {
   id: string;
   "aria-labelledby": string | undefined;
@@ -38,7 +38,7 @@ export type FormControlProps = {
   "aria-invalid": boolean;
 };
 /**
- * 入力の部品に `id`・`aria-labelledby`・`aria-describedby`・`aria-invalid` を渡す。子は関数で受ける。
+ * Passes `id`, `aria-labelledby`, `aria-describedby` and `aria-invalid` to the input component. The child is received as a function.
  *
  * ```tsx
  * <FormControl labelled={Boolean(label)} described={Boolean(description)}>
@@ -46,11 +46,11 @@ export type FormControlProps = {
  * </FormControl>
  * ```
  *
- * - `labelled`: `FormLabel` を置いているとき。ラベルの文字を入力の名前にする（`aria-labelledby`）。置いていないときは
- *   存在しない id を指さないよう付けない。右にラベルを持つ入力（checkbox・radio）は、自分の文字が名前なので付けない
- * - `described`: `FormDescription` を置いているとき。説明を `aria-describedby` に足す。エラーがあるときは、エラーの文も足す
- * - `id`: 既定は `formItemId`（1 つの field に入力が 1 つのとき）。**1 つの field に入力が複数あるとき**（radio の選択肢）は、
- *   同じ id が重ならないよう、選択肢ごとに渡す
+ * - `labelled`: when a `FormLabel` is placed. Makes the label text the input's name (`aria-labelledby`). When none is placed,
+ *   it is not set so it never points to a nonexistent id. Inputs that carry their own label on the right (checkbox, radio) do not set it, because their own text is the name
+ * - `described`: when a `FormDescription` is placed. Adds the description to `aria-describedby`. When there is an error, the error text is added too
+ * - `id`: defaults to `formItemId` (when a field has one input). **When a field has several inputs** (radio options),
+ *   pass one per option so the same id does not collide
  */
 export declare function FormControl({ children, id, labelled, described }: {
   children: (control: FormControlProps) => ReactNode;
@@ -63,8 +63,8 @@ export declare function FormDescription({ children, className }: {
   className?: string;
 }): import("react").JSX.Element;
 /**
- * エラーの文。出すエラーは `useFormField` の 1 つだけ（`FormItem` の `errors` で足す）。
- * web の `FormMessage` にある「このメッセージだけに出すエラー」（`errors`）は持たない（文だけ変えると `aria-invalid` と食い違うため）。
+ * The error text. The only errors shown are the single set from `useFormField` (add more via the `errors` of `FormItem`).
+ * It does not have the web `FormMessage`'s "errors shown only in this message" (`errors`), because changing only the text would disagree with `aria-invalid`.
  */
 export declare function FormMessage({ className }: {
   className?: string;

package/dist/native/base/form.js

@@ -8,10 +8,10 @@ import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/native/base/form.tsx
 const FormItemContext = createContext({ id: "" });
 /**
-* 外装の id の組と、エラー。`FormItem` の中で使う。フィールドの外（制御モード）でも落ちない。
+* The set of chrome ids and the errors. Use it inside `FormItem`. It does not crash outside a field (controlled mode) either.
 *
-* **表示するエラーはここで 1 つに決める**（field のエラー + `FormItem` の `errors`）。`FormLabel` の色・`FormMessage` の文・
-* `FormControl` の `aria-invalid` / `aria-describedby` は全部これを読むので、文が出ているのに `aria-invalid` が無い、などの食い違いが起きない。
+* **The errors to display are decided in one place here** (the field's errors + the `errors` of `FormItem`). The `FormLabel` color, the `FormMessage` text and
+* the `FormControl` `aria-invalid` / `aria-describedby` all read from it, so mismatches such as a message being shown without `aria-invalid` cannot occur.
 */
 function useFormField() {
 	const itemContext = useContext(FormItemContext);
@@ -61,7 +61,7 @@ function FormLabel({ children, required, helpText, className }) {
 	});
 }
 /**
-* 入力の部品に `id`・`aria-labelledby`・`aria-describedby`・`aria-invalid` を渡す。子は関数で受ける。
+* Passes `id`, `aria-labelledby`, `aria-describedby` and `aria-invalid` to the input component. The child is received as a function.
 *
 * ```tsx
 * <FormControl labelled={Boolean(label)} described={Boolean(description)}>
@@ -69,11 +69,11 @@ function FormLabel({ children, required, helpText, className }) {
 * </FormControl>
 * ```
 *
-* - `labelled`: `FormLabel` を置いているとき。ラベルの文字を入力の名前にする（`aria-labelledby`）。置いていないときは
-*   存在しない id を指さないよう付けない。右にラベルを持つ入力（checkbox・radio）は、自分の文字が名前なので付けない
-* - `described`: `FormDescription` を置いているとき。説明を `aria-describedby` に足す。エラーがあるときは、エラーの文も足す
-* - `id`: 既定は `formItemId`（1 つの field に入力が 1 つのとき）。**1 つの field に入力が複数あるとき**（radio の選択肢）は、
-*   同じ id が重ならないよう、選択肢ごとに渡す
+* - `labelled`: when a `FormLabel` is placed. Makes the label text the input's name (`aria-labelledby`). When none is placed,
+*   it is not set so it never points to a nonexistent id. Inputs that carry their own label on the right (checkbox, radio) do not set it, because their own text is the name
+* - `described`: when a `FormDescription` is placed. Adds the description to `aria-describedby`. When there is an error, the error text is added too
+* - `id`: defaults to `formItemId` (when a field has one input). **When a field has several inputs** (radio options),
+*   pass one per option so the same id does not collide
 */
 function FormControl({ children, id, labelled = false, described = false }) {
 	const { errors, formItemId, formLabelId, formDescriptionId, formMessageId } = useFormField();
@@ -95,8 +95,8 @@ function FormDescription({ children, className }) {
 	});
 }
 /**
-* エラーの文。出すエラーは `useFormField` の 1 つだけ（`FormItem` の `errors` で足す）。
-* web の `FormMessage` にある「このメッセージだけに出すエラー」（`errors`）は持たない（文だけ変えると `aria-invalid` と食い違うため）。
+* The error text. The only errors shown are the single set from `useFormField` (add more via the `errors` of `FormItem`).
+* It does not have the web `FormMessage`'s "errors shown only in this message" (`errors`), because changing only the text would disagree with `aria-invalid`.
 */
 function FormMessage({ className }) {
 	const { errors: list, formMessageId } = useFormField();

package/dist/native/base/glass-card.d.ts

@@ -6,9 +6,9 @@ type GlassCardProps = {
   style?: ViewStyle;
 };
 /**
- * Liquid Glass のカードサーフェス。iOS 26 以上では `GlassView`（`UIGlassEffect`）で
- * 背後をぼかしたグラス表現になり、非対応環境（iOS 26 未満・Android・web）では枠線付きの通常 View にフォールバックする。
- * フォールバックの枠線は、トークンの罫線色（`--line`）。移植元は `rgba(…)` の直書きで、トークンから外れていた。
+ * A Liquid Glass card surface. On iOS 26 and later it uses `GlassView` (`UIGlassEffect`)
+ * for a glass look that blurs what is behind it; on unsupported environments (below iOS 26, Android, web) it falls back to a plain View with a border.
+ * The fallback border uses the token's line color (`--line`).
  */
 declare function GlassCard({ children, style }: GlassCardProps): import("react").JSX.Element;
 //#endregion

package/dist/native/base/glass-card.js

@@ -10,9 +10,9 @@ const BASE = {
 	overflow: "hidden"
 };
 /**
-* Liquid Glass のカードサーフェス。iOS 26 以上では `GlassView`（`UIGlassEffect`）で
-* 背後をぼかしたグラス表現になり、非対応環境（iOS 26 未満・Android・web）では枠線付きの通常 View にフォールバックする。
-* フォールバックの枠線は、トークンの罫線色（`--line`）。移植元は `rgba(…)` の直書きで、トークンから外れていた。
+* A Liquid Glass card surface. On iOS 26 and later it uses `GlassView` (`UIGlassEffect`)
+* for a glass look that blurs what is behind it; on unsupported environments (below iOS 26, Android, web) it falls back to a plain View with a border.
+* The fallback border uses the token's line color (`--line`).
 */
 function GlassCard({ children, style }) {
 	const line = useTokenColor("--line");

package/dist/native/base/input.d.ts

@@ -2,7 +2,7 @@ import { KeyboardTypeOptions } from "react-native";
 //#region src/native/base/input.d.ts
 type InputProps = {
   placeholder?: string;
-  /** 表示する値。外部 state と同期する場合に渡す（内部は非制御で駆動する）。 */
+  /** The value to display. Pass it when syncing with external state (internally it is driven uncontrolled). */
   value?: string;
   onChangeText?: (text: string) => void;
   secureTextEntry?: boolean;
@@ -14,15 +14,15 @@ type InputProps = {
   onSubmitEditing?: (text: string) => void;
 };
 /**
- * ネイティブテキスト入力（OS のコントロールの層）。iOS は SwiftUI の `TextField` / `SecureField`、
- * Android は Jetpack Compose の `TextField` を描画する（`@expo/ui` universal 経由）。
+ * The native text input (the OS control layer). Renders SwiftUI's `TextField` / `SecureField` on iOS
+ * and Jetpack Compose's `TextField` on Android (via `@expo/ui` universal).
  *
- * `atom/text-field`（RN の `TextInput`。トークンで塗る入力枠）に対する、**OS ネイティブ版の base 層**。
- * **トークンで塗れない**ので、web と同じ見た目にしたい入力は `atom/text-field`（フォームなら `form/text-input`）を使う。
+ * The **OS-native base layer** counterpart of `atom/text-field` (an RN `TextInput`, an input frame painted with tokens).
+ * It **cannot be painted with tokens**, so for inputs that should look the same as the web use `atom/text-field` (or `form/text-input` in a form).
  *
- * universal の `value` は `ObservableState` 型のため、素の string を扱えるよう
- * `defaultValue`（非制御）+ `onChangeText` で駆動する。外部 state は
- * `onChangeText` を通じて同期する。
+ * The universal `value` is an `ObservableState` type, so to handle a plain string it is driven by
+ * `defaultValue` (uncontrolled) + `onChangeText`. External state is
+ * synced through `onChangeText`.
  */
 declare function Input({ value, ...props }: InputProps): import("react").JSX.Element;
 //#endregion

package/dist/native/base/input.js

@@ -3,15 +3,15 @@ import { Host, TextInput } from "@expo/ui";
 
 //#region src/native/base/input.tsx
 /**
-* ネイティブテキスト入力（OS のコントロールの層）。iOS は SwiftUI の `TextField` / `SecureField`、
-* Android は Jetpack Compose の `TextField` を描画する（`@expo/ui` universal 経由）。
+* The native text input (the OS control layer). Renders SwiftUI's `TextField` / `SecureField` on iOS
+* and Jetpack Compose's `TextField` on Android (via `@expo/ui` universal).
 *
-* `atom/text-field`（RN の `TextInput`。トークンで塗る入力枠）に対する、**OS ネイティブ版の base 層**。
-* **トークンで塗れない**ので、web と同じ見た目にしたい入力は `atom/text-field`（フォームなら `form/text-input`）を使う。
+* The **OS-native base layer** counterpart of `atom/text-field` (an RN `TextInput`, an input frame painted with tokens).
+* It **cannot be painted with tokens**, so for inputs that should look the same as the web use `atom/text-field` (or `form/text-input` in a form).
 *
-* universal の `value` は `ObservableState` 型のため、素の string を扱えるよう
-* `defaultValue`（非制御）+ `onChangeText` で駆動する。外部 state は
-* `onChangeText` を通じて同期する。
+* The universal `value` is an `ObservableState` type, so to handle a plain string it is driven by
+* `defaultValue` (uncontrolled) + `onChangeText`. External state is
+* synced through `onChangeText`.
 */
 function Input({ value, ...props }) {
 	return /* @__PURE__ */ jsx(Host, {

package/dist/native/base/sheet.d.ts

@@ -3,68 +3,68 @@ import { ReactNode } from "react";
 export type SheetShellProps = {
   open: boolean;
   onOpenChange: (open: boolean) => void;
-  /** 背面タップで閉じるか（既定 true）。 */
+  /** Whether tapping the backdrop closes it (default true). */
   dismissOnBackdropPress?: boolean;
-  /** 画面高に対する最大の高さ（既定 0.85）。 */
+  /** The maximum height as a ratio of the screen height (default 0.85). */
   maxHeightRatio?: number;
   /**
-   * 閉じ切って `Modal` を畳んだ後に**1 度だけ**呼ばれる（開いたことが無いとき・再描画のたびには呼ばれない）。
-   * **次のシートを開くときはここで開くこと。**
-   * `open` を false にした直後に別のシートを開くと、閉じるアニメーションの間だけ `Modal` が
-   * 2 枚並び、iOS は後から出したほうを出さない（何も起きないように見える）。
+   * Called **exactly once** after it has fully closed and the `Modal` has been dismissed (not called if it was never opened, nor on every re-render).
+   * **Open the next sheet from here.**
+   * If another sheet is opened right after setting `open` to false, two `Modal`s coexist for the duration of the
+   * closing animation, and iOS does not present the later one (it looks like nothing happens).
    *
-   * **確認ダイアログ（`once/confirm`）も `Modal`。** シートの中から確認を出すときも
-   * 同じ理由でここを使うこと。
+   * **A confirm dialog (`once/confirm`) is also a `Modal`.** When showing a confirmation from inside a sheet,
+   * use this for the same reason.
    */
   onClosed?: () => void;
   /**
-   * ダイアログの名前になる見出しの `id`（`SheetHeader` の `titleId` と同じ値）。`aria-label` が無いときに必須級
-   * （名前の無いダイアログは支援技術に「ダイアログ」としか伝わらない）。
+   * The `id` of the heading that names the dialog (the same value as `SheetHeader`'s `titleId`). Practically required when there is no `aria-label`
+   * (a dialog without a name is conveyed to assistive technology only as "dialog").
    */
   "aria-labelledby"?: string;
-  /** 見出しが文字列でないとき、または見出しを出さないときの、ダイアログの名前。 */
+  /** The dialog's name when the heading is not a string or no heading is shown. */
   "aria-label"?: string;
-  /** 補足の `id`（`SheetHeader` の `descriptionId` と同じ値）。 */
+  /** The `id` of the supplementary text (the same value as `SheetHeader`'s `descriptionId`). */
   "aria-describedby"?: string;
   children: ReactNode;
 };
 /**
- * `Modal` の `animationType="slide"` は使わない。あれは**スクリムごと**競り上がるので、
- * 暗幕が下から生えてくる安っぽい見え方になる。ここではスクリムのフェードとパネルの
- * スライドを別々の曲線で動かす。
+ * Do not use `Modal`'s `animationType="slide"`. It slides up **together with the scrim**,
+ * so the dark overlay appears to grow from the bottom and looks cheap. Here the scrim's fade and the panel's
+ * slide are driven by separate curves.
  *
- * ダイアログの役割（`role="dialog"`・`aria-modal`）・フォーカスの閉じ込め・Esc（`onRequestClose`）は `Modal` が持つ
- * （react-native-web の `Modal` は役割と閉じ込めを出す。名前は持たないので `aria-label(ledby)` を渡す）。
+ * The dialog role (`role="dialog"`, `aria-modal`), focus trapping and Esc (`onRequestClose`) are provided by `Modal`
+ * (react-native-web's `Modal` emits the role and the trap. It has no name of its own, so pass `aria-label(ledby)`).
  */
 export declare function SheetShell({ open, onOpenChange, dismissOnBackdropPress, maxHeightRatio, onClosed, "aria-labelledby": ariaLabelledBy, "aria-label": ariaLabel, "aria-describedby": ariaDescribedBy, children }: SheetShellProps): import("react").JSX.Element | null;
 export type SheetHeaderProps = {
   title?: ReactNode;
   description?: ReactNode;
-  /** 閉じるボタンの読み上げ名（既定は「閉じる」）。 */
+  /** Screen reader name of the close button (the default is the Japanese "close" label). */
   closeLabel?: string;
   onClose: () => void;
-  /** 見出しの `id`。`SheetShell` の `aria-labelledby` に同じ値を渡すと、見出しがダイアログの名前になる。 */
+  /** The `id` of the heading. Pass the same value to `SheetShell`'s `aria-labelledby` and the heading becomes the dialog's name. */
   titleId?: string;
-  /** 補足の `id`。`SheetShell` の `aria-describedby` に同じ値を渡す。 */
+  /** The `id` of the supplementary text. Pass the same value to `SheetShell`'s `aria-describedby`. */
   descriptionId?: string;
 };
-/** 掴む合図（グラバー）・見出し・閉じるボタン。 */
+/** The grab cue (grabber), the heading and the close button. */
 export declare function SheetHeader({ title, description, closeLabel, onClose, titleId, descriptionId }: SheetHeaderProps): import("react").JSX.Element;
 export type SheetScrollProps = {
-  /** 中身に余白を敷くか（既定 true）。端まで敷き詰める行リストでは false。 */
+  /** Whether to pad the content (default true). Use false for a row list that fills edge to edge. */
   padded?: boolean;
-  /** フッターがあるか。無いときは中身の下端で safe-area を吸う。 */
+  /** Whether there is a footer. When there is none, the content's bottom edge absorbs the safe area. */
   hasFooter?: boolean;
   children: ReactNode;
 };
 /**
- * シートの本文。
+ * The sheet body.
  *
- * `contentContainerClassName` は react-native-css で**効かない**（無言で padding が消えて
- * 文字が端で切れる）。余白は必ず `contentContainerStyle` に書くこと。
+ * `contentContainerClassName` **does not work** with react-native-css (the padding silently disappears and
+ * text gets clipped at the edge). Always write padding in `contentContainerStyle`.
  */
 export declare function SheetScroll({ padded, hasFooter, children }: SheetScrollProps): import("react").JSX.Element;
-/** シートのフッター。ホームインジケータに潜らないよう safe-area を足す。 */
+/** The sheet footer. Adds the safe area so it does not slip under the home indicator. */
 export declare function SheetFooter({ children }: {
   children: ReactNode;
 }): import("react").JSX.Element;