@alneas/appkit-react 0.1.0 → 0.3.0

package/dist/ui/components/ui/field.d.cts

@@ -1,44 +1,235 @@
 import { VariantProps } from 'class-variance-authority';
+import { Field as FieldPrimitive } from '@base-ui/react/field';
 import { Fieldset as FieldsetPrimitive } from '@base-ui/react/fieldset';
 import * as React from 'react';
 /**
- * フォーム内で関連する入力フィールドをグループ化するためのコンテナ。
+ * Groups related form fields using the Base UI fieldset root.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldSet composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldSet({ className, ...props }: FieldsetPrimitive.Root.Props): React.JSX.Element;
 /**
- * FieldSet グループのタイトル（見出し）を指定するコンポーネント。
+ * Labels the fieldset with legend or compact label styling.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: variant='legend'.
+ * @returns The rendered FieldLegend composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. variant defaults to legend; label selects smaller typography.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldLegend({ className, variant, ...props }: FieldsetPrimitive.Legend.Props & {
+    /**
+     * Visual treatment from the declared variant union; changing it does not alter host action semantics.
+     */
     variant?: 'legend' | 'label';
 }): React.JSX.Element;
 /**
- * 複数のフィールドをまとめて配置・整理するためのグループコンテナ。
+ * Lays out a vertical group of fields and nested field groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldGroup({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare const Field: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldRootProps & VariantProps<(props?: ({
+declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
-} & import('class-variance-authority/types').ClassProp) | undefined) => string>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
 /**
- * フィールド内のコントロールや説明、エラーメッセージを囲むコンテンツ領域。
+ * Coordinates one field control, label, description and validation state.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: orientation='vertical'.
+ * @returns The rendered Field composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type. orientation defaults to vertical; horizontal/responsive change layout rather than field validation.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function Field({ ref, className, orientation, ...props }: React.PropsWithoutRef<FieldPrimitive.Root.Props & VariantProps<typeof fieldVariants>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace Field {
+    var displayName: string;
+}
+/**
+ * Groups the textual content adjacent to a field control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare const FieldLabel: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldLabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;
 /**
- * フィールドのタイトル（ラベル）用のコンポーネント。
+ * Associates a visible label with its Base UI field control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function FieldLabel({ ref, className, ...props }: React.PropsWithoutRef<FieldPrimitive.Label.Props> & React.RefAttributes<HTMLLabelElement>): React.JSX.Element;
+declare namespace FieldLabel {
+    var displayName: string;
+}
+/**
+ * Styles label-like title content without creating a label association.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldTitle composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldTitle({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare const FieldDescription: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 /**
- * フォームセクションやフィールド間を区切るためのセパレーター（区切り線）。
+ * Provides descriptive text associated with the surrounding field.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldDescription composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function FieldDescription({ ref, className, ...props }: React.PropsWithoutRef<FieldPrimitive.Description.Props> & React.RefAttributes<HTMLParagraphElement>): React.JSX.Element;
+declare namespace FieldDescription {
+    var displayName: string;
+}
+/**
+ * Draws a divider with optional centered text between field groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldSeparator({ children, className, ...props }: React.ComponentProps<'div'> & {
+    /**
+     * Content rendered in the wrapper's child region.
+     */
     children?: React.ReactNode;
 }): React.JSX.Element;
-declare const FieldError: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldErrorProps & {
+/**
+ * Renders supplied children or deduplicated error messages when content exists.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldError composition, or null when it has no visible content.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function FieldError({ ref, className, children, errors, ...props }: React.PropsWithoutRef<FieldPrimitive.Error.Props & {
+    /**
+     * Explicit validation messages; duplicate message strings are collapsed and missing/empty messages may yield no content.
+     */
     errors?: Array<{
+        /**
+         * Optional error message used for deduplication and display; missing messages do not render a list item.
+         */
+        /**
+         * Optional error message used for deduplication and display; missing messages do not render a list item.
+         */
         message?: string;
     } | undefined>;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element | null;
+declare namespace FieldError {
+    var displayName: string;
+}
+/**
+ * Exposes the surrounding Base UI field validity state to its child renderer.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered FieldValidity composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldValidity: React.FC<import('@base-ui/react').FieldValidityProps>;
+/**
+ * Renders a Base UI control bound to its surrounding field context.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered FieldControl composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldControl: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldControlProps, "ref"> & React.RefAttributes<HTMLElement>>;
 export { Field, FieldLabel, FieldControl, FieldError, FieldDescription, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, FieldValidity };

package/dist/ui/components/ui/field.d.ts

@@ -1,44 +1,235 @@
 import { VariantProps } from 'class-variance-authority';
+import { Field as FieldPrimitive } from '@base-ui/react/field';
 import { Fieldset as FieldsetPrimitive } from '@base-ui/react/fieldset';
 import * as React from 'react';
 /**
- * フォーム内で関連する入力フィールドをグループ化するためのコンテナ。
+ * Groups related form fields using the Base UI fieldset root.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldSet composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldSet({ className, ...props }: FieldsetPrimitive.Root.Props): React.JSX.Element;
 /**
- * FieldSet グループのタイトル（見出し）を指定するコンポーネント。
+ * Labels the fieldset with legend or compact label styling.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: variant='legend'.
+ * @returns The rendered FieldLegend composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. variant defaults to legend; label selects smaller typography.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldLegend({ className, variant, ...props }: FieldsetPrimitive.Legend.Props & {
+    /**
+     * Visual treatment from the declared variant union; changing it does not alter host action semantics.
+     */
     variant?: 'legend' | 'label';
 }): React.JSX.Element;
 /**
- * 複数のフィールドをまとめて配置・整理するためのグループコンテナ。
+ * Lays out a vertical group of fields and nested field groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldGroup({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare const Field: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldRootProps & VariantProps<(props?: ({
+declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
-} & import('class-variance-authority/types').ClassProp) | undefined) => string>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
 /**
- * フィールド内のコントロールや説明、エラーメッセージを囲むコンテンツ領域。
+ * Coordinates one field control, label, description and validation state.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: orientation='vertical'.
+ * @returns The rendered Field composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type. orientation defaults to vertical; horizontal/responsive change layout rather than field validation.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function Field({ ref, className, orientation, ...props }: React.PropsWithoutRef<FieldPrimitive.Root.Props & VariantProps<typeof fieldVariants>> & React.RefAttributes<HTMLDivElement>): React.JSX.Element;
+declare namespace Field {
+    var displayName: string;
+}
+/**
+ * Groups the textual content adjacent to a field control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare const FieldLabel: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldLabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;
 /**
- * フィールドのタイトル（ラベル）用のコンポーネント。
+ * Associates a visible label with its Base UI field control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function FieldLabel({ ref, className, ...props }: React.PropsWithoutRef<FieldPrimitive.Label.Props> & React.RefAttributes<HTMLLabelElement>): React.JSX.Element;
+declare namespace FieldLabel {
+    var displayName: string;
+}
+/**
+ * Styles label-like title content without creating a label association.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldTitle composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldTitle({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare const FieldDescription: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldDescriptionProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;
 /**
- * フォームセクションやフィールド間を区切るためのセパレーター（区切り線）。
+ * Provides descriptive text associated with the surrounding field.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldDescription composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function FieldDescription({ ref, className, ...props }: React.PropsWithoutRef<FieldPrimitive.Description.Props> & React.RefAttributes<HTMLParagraphElement>): React.JSX.Element;
+declare namespace FieldDescription {
+    var displayName: string;
+}
+/**
+ * Draws a divider with optional centered text between field groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
  */
 declare function FieldSeparator({ children, className, ...props }: React.ComponentProps<'div'> & {
+    /**
+     * Content rendered in the wrapper's child region.
+     */
     children?: React.ReactNode;
 }): React.JSX.Element;
-declare const FieldError: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldErrorProps & {
+/**
+ * Renders supplied children or deduplicated error messages when content exists.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered FieldError composition, or null when it has no visible content.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
+declare function FieldError({ ref, className, children, errors, ...props }: React.PropsWithoutRef<FieldPrimitive.Error.Props & {
+    /**
+     * Explicit validation messages; duplicate message strings are collapsed and missing/empty messages may yield no content.
+     */
     errors?: Array<{
+        /**
+         * Optional error message used for deduplication and display; missing messages do not render a list item.
+         */
+        /**
+         * Optional error message used for deduplication and display; missing messages do not render a list item.
+         */
         message?: string;
     } | undefined>;
-}, "ref"> & React.RefAttributes<HTMLDivElement>>;
+}> & React.RefAttributes<HTMLDivElement>): React.JSX.Element | null;
+declare namespace FieldError {
+    var displayName: string;
+}
+/**
+ * Exposes the surrounding Base UI field validity state to its child renderer.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered FieldValidity composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldValidity: React.FC<import('@base-ui/react').FieldValidityProps>;
+/**
+ * Renders a Base UI control bound to its surrounding field context.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered FieldControl composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Label, Control, Description, Error and Validity require the surrounding Field context. FieldSet/Legend provide related-field semantics. FieldError prefers truthy children; otherwise it deduplicates errors by message and returns null when empty. These wrappers do not persist form values.
+ * @example
+ * ```tsx
+ * import { FieldSet, FieldLegend, FieldGroup, Field, FieldLabel, FieldControl, FieldDescription, FieldError } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<FieldSet><FieldLegend>Contact</FieldLegend><FieldGroup><Field name="email"><FieldLabel>Email</FieldLabel><FieldControl type="email" /><FieldDescription>Used for replies</FieldDescription><FieldError /></Field></FieldGroup></FieldSet>);
+ * }
+ * ```
+ */
 declare const FieldControl: React.ForwardRefExoticComponent<Omit<import('@base-ui/react').FieldControlProps, "ref"> & React.RefAttributes<HTMLElement>>;
 export { Field, FieldLabel, FieldControl, FieldError, FieldDescription, FieldGroup, FieldLegend, FieldSeparator, FieldSet, FieldContent, FieldTitle, FieldValidity };