@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ui/components/ui/mobile-form.d.cts

@@ -2,54 +2,249 @@ import { Input as InputPrimitive } from '@base-ui/react/input';
 import { Button as ButtonPrimitive } from '@base-ui/react/button';
 import { VariantProps } from 'class-variance-authority';
 import { mobileButtonVariants, fabVariants } from './mobile-form-variants.cjs';
+/** Mobile-sized native and Base UI form controls with linked labels and Appkit variants. */
+import * as React from 'react';
 /**
- * モバイル最適化フォームコンポーネント
- *
- * shadcn/ui パターンに準拠:
- * - CVA でバリアント管理
- * - @base-ui/react プリミティブ使用
- * - テーマトークン使用
- * - testId prop 対応
+ * Native form attributes and a stable selector for MobileForm.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileForm
  */
-import * as React from 'react';
 export interface MobileFormProps extends React.FormHTMLAttributes<HTMLFormElement> {
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileForm: React.ForwardRefExoticComponent<MobileFormProps & React.RefAttributes<HTMLFormElement>>;
+/**
+ * Renders a mobile-spaced native form without adding a form-state provider.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileForm composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileForm({ ref, className, testId, ...props }: React.PropsWithoutRef<MobileFormProps> & React.RefAttributes<HTMLFormElement>): React.JSX.Element;
+declare namespace MobileForm {
+    var displayName: string;
+}
+/**
+ * Native div attributes and optional section heading/description.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileFormSection
+ */
 export interface MobileFormSectionProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Optional section heading rendered before its content.
+     */
     title?: string;
+    /**
+     * Supporting text displayed by the owning component.
+     */
     description?: string;
 }
-declare const MobileFormSection: React.ForwardRefExoticComponent<MobileFormSectionProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Groups mobile form controls under an optional title and description.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileFormSection composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileFormSection({ ref, title, description, className, children, ...props }: React.PropsWithoutRef<MobileFormSectionProps> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace MobileFormSection {
+    var displayName: string;
+}
+/**
+ * Base UI input attributes with required visible label and linked helper/error content.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileInput
+ */
 export interface MobileInputProps extends React.ComponentProps<typeof InputPrimitive> {
+    /**
+     * Visible control/option text or content; does not perform persistence or validation.
+     */
     label: string;
+    /**
+     * Error text displayed and used to mark the control invalid; the host supplies validation results.
+     */
     error?: string;
+    /**
+     * Supporting text linked through aria-describedby when no error is present.
+     */
     helperText?: string;
+    /**
+     * Leading visual content; provide an accessible name separately when it is the only button content.
+     */
     icon?: React.ReactNode;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileInput: React.ForwardRefExoticComponent<Omit<MobileInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+/**
+ * Renders a labeled large-touch input with generated IDs and linked helper/error text.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileInput({ ref, label, error, helperText, icon, className, testId, ...props }: React.PropsWithoutRef<MobileInputProps> & React.RefAttributes<HTMLInputElement>): React.JSX.Element;
+declare namespace MobileInput {
+    var displayName: string;
+}
+/**
+ * Native select attributes with required label and option data.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileSelect
+ */
 export interface MobileSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+    /**
+     * Visible control/option text or content; does not perform persistence or validation.
+     */
     label: string;
+    /**
+     * Native option entries in display order; each value must be a stable unique string and label is its visible text.
+     */
     options: Array<{
-        value: string;
+        /**
+         * Identity for this choice within the surrounding group; provide a distinct stable string.
+         */
+        value: string; /**
+       * Visible control/option text or content; does not perform persistence or validation.
+       */
+        /**
+         * Visible control/option text or content; does not perform persistence or validation.
+         */
         label: string;
     }>;
+    /**
+     * Error text displayed and used to mark the control invalid; the host supplies validation results.
+     */
     error?: string;
+    /**
+     * Text displayed while no value is selected/entered; omitted means no placeholder.
+     */
     placeholder?: string;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileSelect: React.ForwardRefExoticComponent<MobileSelectProps & React.RefAttributes<HTMLSelectElement>>;
+/**
+ * Renders a labeled native select with generated IDs and linked error text.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileSelect composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileSelect({ ref, label, options, error, placeholder, className, testId, ...props }: React.PropsWithoutRef<MobileSelectProps> & React.RefAttributes<HTMLSelectElement>): React.JSX.Element;
+declare namespace MobileSelect {
+    var displayName: string;
+}
+/**
+ * Base UI button attributes with mobile variants, loading state and optional icon.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileButton
+ */
 export interface MobileButtonProps extends ButtonPrimitive.Props, VariantProps<typeof mobileButtonVariants> {
+    /**
+     * Shows the loading spinner and disables activation when true; omitted means not loading. This does not manage an asynchronous task.
+     */
     loading?: boolean;
+    /**
+     * Leading visual content; provide an accessible name separately when it is the only button content.
+     */
     icon?: React.ReactNode;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileButton: React.ForwardRefExoticComponent<Omit<MobileButtonProps, "ref"> & React.RefAttributes<HTMLElement>>;
+/**
+ * Renders a large-touch Base UI button with optional loading spinner or leading icon.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileButton({ ref, className, variant, size, loading, icon, disabled, children, testId, ...props }: React.PropsWithoutRef<MobileButtonProps> & React.RefAttributes<HTMLElement>): React.JSX.Element;
+declare namespace MobileButton {
+    var displayName: string;
+}
+/**
+ * Base UI button attributes and fixed-position floating-action styling.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see FAB
+ */
 export interface FABProps extends ButtonPrimitive.Props, VariantProps<typeof fabVariants> {
+    /**
+     * Required visual content in the floating action button; provide aria-label for icon-only use.
+     */
     icon: React.ReactNode;
+    /**
+     * Optional visible text; a truthy label forces extended styling even when extended=false.
+     */
     label?: string;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const FAB: React.ForwardRefExoticComponent<Omit<FABProps, "ref"> & React.RefAttributes<HTMLElement>>;
+/**
+ * Renders a fixed floating action button that expands when label content is supplied.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FAB composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function FAB({ ref, icon, label, position, extended, className, testId, ...props }: React.PropsWithoutRef<FABProps> & React.RefAttributes<HTMLElement>): React.JSX.Element;
+declare namespace FAB {
+    var displayName: string;
+}
 export { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB };

package/dist/ui/components/ui/mobile-form.d.ts

@@ -2,54 +2,249 @@ import { Input as InputPrimitive } from '@base-ui/react/input';
 import { Button as ButtonPrimitive } from '@base-ui/react/button';
 import { VariantProps } from 'class-variance-authority';
 import { mobileButtonVariants, fabVariants } from './mobile-form-variants.js';
+/** Mobile-sized native and Base UI form controls with linked labels and Appkit variants. */
+import * as React from 'react';
 /**
- * モバイル最適化フォームコンポーネント
- *
- * shadcn/ui パターンに準拠:
- * - CVA でバリアント管理
- * - @base-ui/react プリミティブ使用
- * - テーマトークン使用
- * - testId prop 対応
+ * Native form attributes and a stable selector for MobileForm.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileForm
  */
-import * as React from 'react';
 export interface MobileFormProps extends React.FormHTMLAttributes<HTMLFormElement> {
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileForm: React.ForwardRefExoticComponent<MobileFormProps & React.RefAttributes<HTMLFormElement>>;
+/**
+ * Renders a mobile-spaced native form without adding a form-state provider.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileForm composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileForm({ ref, className, testId, ...props }: React.PropsWithoutRef<MobileFormProps> & React.RefAttributes<HTMLFormElement>): React.JSX.Element;
+declare namespace MobileForm {
+    var displayName: string;
+}
+/**
+ * Native div attributes and optional section heading/description.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileFormSection
+ */
 export interface MobileFormSectionProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Optional section heading rendered before its content.
+     */
     title?: string;
+    /**
+     * Supporting text displayed by the owning component.
+     */
     description?: string;
 }
-declare const MobileFormSection: React.ForwardRefExoticComponent<MobileFormSectionProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Groups mobile form controls under an optional title and description.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileFormSection composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileFormSection({ ref, title, description, className, children, ...props }: React.PropsWithoutRef<MobileFormSectionProps> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace MobileFormSection {
+    var displayName: string;
+}
+/**
+ * Base UI input attributes with required visible label and linked helper/error content.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileInput
+ */
 export interface MobileInputProps extends React.ComponentProps<typeof InputPrimitive> {
+    /**
+     * Visible control/option text or content; does not perform persistence or validation.
+     */
     label: string;
+    /**
+     * Error text displayed and used to mark the control invalid; the host supplies validation results.
+     */
     error?: string;
+    /**
+     * Supporting text linked through aria-describedby when no error is present.
+     */
     helperText?: string;
+    /**
+     * Leading visual content; provide an accessible name separately when it is the only button content.
+     */
     icon?: React.ReactNode;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileInput: React.ForwardRefExoticComponent<Omit<MobileInputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+/**
+ * Renders a labeled large-touch input with generated IDs and linked helper/error text.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileInput({ ref, label, error, helperText, icon, className, testId, ...props }: React.PropsWithoutRef<MobileInputProps> & React.RefAttributes<HTMLInputElement>): React.JSX.Element;
+declare namespace MobileInput {
+    var displayName: string;
+}
+/**
+ * Native select attributes with required label and option data.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileSelect
+ */
 export interface MobileSelectProps extends React.SelectHTMLAttributes<HTMLSelectElement> {
+    /**
+     * Visible control/option text or content; does not perform persistence or validation.
+     */
     label: string;
+    /**
+     * Native option entries in display order; each value must be a stable unique string and label is its visible text.
+     */
     options: Array<{
-        value: string;
+        /**
+         * Identity for this choice within the surrounding group; provide a distinct stable string.
+         */
+        value: string; /**
+       * Visible control/option text or content; does not perform persistence or validation.
+       */
+        /**
+         * Visible control/option text or content; does not perform persistence or validation.
+         */
         label: string;
     }>;
+    /**
+     * Error text displayed and used to mark the control invalid; the host supplies validation results.
+     */
     error?: string;
+    /**
+     * Text displayed while no value is selected/entered; omitted means no placeholder.
+     */
     placeholder?: string;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileSelect: React.ForwardRefExoticComponent<MobileSelectProps & React.RefAttributes<HTMLSelectElement>>;
+/**
+ * Renders a labeled native select with generated IDs and linked error text.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileSelect composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileSelect({ ref, label, options, error, placeholder, className, testId, ...props }: React.PropsWithoutRef<MobileSelectProps> & React.RefAttributes<HTMLSelectElement>): React.JSX.Element;
+declare namespace MobileSelect {
+    var displayName: string;
+}
+/**
+ * Base UI button attributes with mobile variants, loading state and optional icon.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see MobileButton
+ */
 export interface MobileButtonProps extends ButtonPrimitive.Props, VariantProps<typeof mobileButtonVariants> {
+    /**
+     * Shows the loading spinner and disables activation when true; omitted means not loading. This does not manage an asynchronous task.
+     */
     loading?: boolean;
+    /**
+     * Leading visual content; provide an accessible name separately when it is the only button content.
+     */
     icon?: React.ReactNode;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const MobileButton: React.ForwardRefExoticComponent<Omit<MobileButtonProps, "ref"> & React.RefAttributes<HTMLElement>>;
+/**
+ * Renders a large-touch Base UI button with optional loading spinner or leading icon.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered MobileButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function MobileButton({ ref, className, variant, size, loading, icon, disabled, children, testId, ...props }: React.PropsWithoutRef<MobileButtonProps> & React.RefAttributes<HTMLElement>): React.JSX.Element;
+declare namespace MobileButton {
+    var displayName: string;
+}
+/**
+ * Base UI button attributes and fixed-position floating-action styling.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see FAB
+ */
 export interface FABProps extends ButtonPrimitive.Props, VariantProps<typeof fabVariants> {
+    /**
+     * Required visual content in the floating action button; provide aria-label for icon-only use.
+     */
     icon: React.ReactNode;
+    /**
+     * Optional visible text; a truthy label forces extended styling even when extended=false.
+     */
     label?: string;
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
-declare const FAB: React.ForwardRefExoticComponent<Omit<FABProps, "ref"> & React.RefAttributes<HTMLElement>>;
+/**
+ * Renders a fixed floating action button that expands when label content is supplied.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FAB composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. The host owns submit effects and values. Input/Select use the caller id or React useId and append -description for help/errors; error text takes precedence over helperText. testId targets the control/form/button. MobileInput uses Base UI Input directly, not Appkit Input numeric normalization. MobileButton loading disables it and replaces icon with a spinner. FAB label forces extended styling even if extended=false; an icon-only FAB needs an accessible name. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<><MobileForm onSubmit={event => event.preventDefault()}><MobileFormSection title="Contact"><MobileInput label="Name" /><MobileSelect label="Method" defaultValue="email" options={[{ value: "email", label: "Email" }]} /><MobileButton type="submit">Save</MobileButton></MobileFormSection></MobileForm><FAB icon={<span>+</span>} label="Create" /></>);
+ * }
+ * ```
+ */
+declare function FAB({ ref, icon, label, position, extended, className, testId, ...props }: React.PropsWithoutRef<FABProps> & React.RefAttributes<HTMLElement>): React.JSX.Element;
+declare namespace FAB {
+    var displayName: string;
+}
 export { MobileForm, MobileFormSection, MobileInput, MobileSelect, MobileButton, FAB };