@alneas/appkit-react 0.1.0 → 0.2.0

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

@@ -1,104 +1,269 @@
 import { Select as SelectPrimitive } from '@base-ui/react/select';
 import * as React from 'react';
 /**
- * Select Component
- * セレクトコンポーネント
+ * Coordinates a Base UI single or multiple selection popup.
+ * @typeParam Value - Option value shape inferred from root props and selection callbacks.
+ * @typeParam Multiple - Whether selection uses an array; extends boolean | undefined and defaults to false.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered Select composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare const Select: typeof SelectPrimitive.Root;
 /**
- * 選択肢をグループ化するためのコンポーネント。
+ * Groups related select options.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectGroup({ className, ...props }: SelectPrimitive.Group.Props): React.JSX.Element;
 /**
- * トリガー内に現在選択されている値やプレースホルダーを表示するコンポーネント。
+ * Displays the current selection or an upstream placeholder inside a trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectValue composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectValue({ className, children, ...props }: SelectPrimitive.Value.Props & {
+    /**
+     * Text displayed while no value is selected/entered; omitted means no placeholder.
+     */
     placeholder?: string;
 }): React.JSX.Element;
+/**
+ * Base UI trigger props with Appkit sizing and test selector.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectTrigger
+ */
 interface SelectTriggerProps extends SelectPrimitive.Trigger.Props {
+    /**
+     * Visual size preset; defaults to default unless the owning component states otherwise.
+     */
     size?: 'sm' | 'default';
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
+/**
+ * Renders the select opener with a trailing chevron and optional test ID.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: size='default'.
+ * @returns The rendered SelectTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
+ */
 declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 /**
- * 選択肢のリストを格納するドロップダウンポップアップコンテナ。
+ * Portals the positioned option popup with a list and scroll controls.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='bottom', sideOffset=4, align='center', alignOffset=0, alignItemWithTrigger=true.
+ * @returns The rendered SelectContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectContent({ className, children, side, sideOffset, align, alignOffset, alignItemWithTrigger, ...props }: SelectPrimitive.Popup.Props & Pick<SelectPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset' | 'alignItemWithTrigger'>): React.JSX.Element;
 /**
- * グループのタイトルや見出しを表すラベルコンポーネント。
+ * Provides the label for a select option group.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectLabel({ className, ...props }: SelectPrimitive.GroupLabel.Props): React.JSX.Element;
+/**
+ * Base UI option props with a stable selector for the option element.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectItem
+ */
 interface SelectItemProps extends SelectPrimitive.Item.Props {
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
 /**
- * ドロップダウンリスト内の個々の選択肢アイテム。
+ * Renders an option with selected-state checkmark and optional test ID.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectItem({ className, children, testId, ...props }: SelectItemProps): React.JSX.Element;
 /**
- * アイテムやグループを区切るためのセパレーター（区切り線）。
+ * Draws a noninteractive divider between option groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectSeparator({ className, ...props }: SelectPrimitive.Separator.Props): React.JSX.Element;
 /**
- * リストが長い場合に、上方向にスクロールするためのインジケーターボタン。
+ * Renders the upstream upward-scroll control with an up chevron.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectScrollUpButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.  children are replaced by the fixed scroll chevron.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectScrollUpButton({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.ScrollUpArrow>): React.JSX.Element;
 /**
- * リストが長い場合に、下方向にスクロールするためのインジケーターボタン。
+ * Renders the upstream downward-scroll control with a down chevron.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectScrollDownButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.  children are replaced by the fixed scroll chevron.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectScrollDownButton({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.ScrollDownArrow>): React.JSX.Element;
 /**
- * セレクトボックスの選択肢を表すインターフェースです。
+ * Display content, string value and disabled state for a SelectInput option.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectInput
  */
 export interface SelectOption {
-    /** 表示されるラベルテキストまたは要素 */
+    /**
+     * Visible React content for this option.
+     */
     label: React.ReactNode;
-    /** 選択時に使用される値 */
+    /**
+     * Unique string identity passed to selection callbacks.
+     */
     value: string;
-    /** 選択肢を無効化するかどうか */
+    /**
+     * Prevents option selection when true; omitted means enabled.
+     */
     disabled?: boolean;
 }
 /**
- * SelectInputコンポーネントのプロパティです。
+ * Base UI root props with option data and trigger presentation/accessibility settings.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectInput
  */
 export interface SelectInputProps extends React.ComponentProps<typeof SelectPrimitive.Root> {
-    /** Accessible name applied to the interactive trigger. */
+    /**
+     * Accessible name applied to the interactive trigger.
+     */
     'aria-label'?: string;
-    /** ID of the label for the interactive trigger. */
+    /**
+     * Space-separated element IDs that label the interactive trigger.
+     */
     'aria-labelledby'?: string;
-    /** 選択肢の配列 */
+    /**
+     * Options in popup order; labels are also resolved for controlled values.
+     */
     options: SelectOption[];
-    /** 未選択時に表示されるプレースホルダーテキスト */
+    /**
+     * Text displayed while no value is selected/entered; omitted means no placeholder.
+     */
     placeholder?: string;
-    /** 追加のCSSクラス名 */
+    /**
+     * Additional classes on the interactive SelectTrigger.
+     */
     className?: string;
-    /** テスト用のID */
+    /**
+     * data-testid on the SelectTrigger; no per-option IDs are synthesized.
+     */
     testId?: string;
-    /** コンポーネントのサイズ */
+    /**
+     * Trigger size; defaults to default.
+     */
     size?: 'default' | 'sm';
-    /** 左側に表示するカスタムアイコン要素 */
+    /**
+     * Optional content before SelectValue inside the trigger.
+     */
     icon?: React.ReactNode;
 }
 /**
- * シンプルで使いやすいセレクトボックスラッパーコンポーネントです。
- *
- * 内部で `Select`, `SelectTrigger`, `SelectValue`, `SelectContent`, `SelectItem` などの
- * 複雑な構造を隠蔽し、`options` を渡すだけで完結するように設計されています。
- * 単一の検索機能を持たないシンプルなドロップダウンが必要な場合に最適です。
- *
- * `React.forwardRef` に対応しているため、`react-hook-form` の `Controller` と直接組み合わせて使用できます。
- *
+ * Builds a complete select from an options array and forwards its ref to the trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: size='default'.
+ * @returns The rendered SelectInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback. The ref prop forwards to the rendered control or container declared by the component ref type.
  * @example
  * ```tsx
- * <SelectInput
- *     value={sortBy}
- *     onValueChange={setSortBy}
- *     options={[
- *         { label: "日付順", value: "date" },
- *         { label: "名前順", value: "name" }
- *     ]}
- *     placeholder="並び替え..."
- * />
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
  * ```
  */
 declare const SelectInput: React.ForwardRefExoticComponent<SelectInputProps & React.RefAttributes<never>>;

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

@@ -1,104 +1,269 @@
 import { Select as SelectPrimitive } from '@base-ui/react/select';
 import * as React from 'react';
 /**
- * Select Component
- * セレクトコンポーネント
+ * Coordinates a Base UI single or multiple selection popup.
+ * @typeParam Value - Option value shape inferred from root props and selection callbacks.
+ * @typeParam Multiple - Whether selection uses an array; extends boolean | undefined and defaults to false.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered Select composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare const Select: typeof SelectPrimitive.Root;
 /**
- * 選択肢をグループ化するためのコンポーネント。
+ * Groups related select options.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectGroup({ className, ...props }: SelectPrimitive.Group.Props): React.JSX.Element;
 /**
- * トリガー内に現在選択されている値やプレースホルダーを表示するコンポーネント。
+ * Displays the current selection or an upstream placeholder inside a trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectValue composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectValue({ className, children, ...props }: SelectPrimitive.Value.Props & {
+    /**
+     * Text displayed while no value is selected/entered; omitted means no placeholder.
+     */
     placeholder?: string;
 }): React.JSX.Element;
+/**
+ * Base UI trigger props with Appkit sizing and test selector.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectTrigger
+ */
 interface SelectTriggerProps extends SelectPrimitive.Trigger.Props {
+    /**
+     * Visual size preset; defaults to default unless the owning component states otherwise.
+     */
     size?: 'sm' | 'default';
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
+/**
+ * Renders the select opener with a trailing chevron and optional test ID.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: size='default'.
+ * @returns The rendered SelectTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback. The ref prop forwards to the rendered control or container declared by the component ref type.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
+ */
 declare const SelectTrigger: React.ForwardRefExoticComponent<Omit<SelectTriggerProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
 /**
- * 選択肢のリストを格納するドロップダウンポップアップコンテナ。
+ * Portals the positioned option popup with a list and scroll controls.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: side='bottom', sideOffset=4, align='center', alignOffset=0, alignItemWithTrigger=true.
+ * @returns The rendered SelectContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectContent({ className, children, side, sideOffset, align, alignOffset, alignItemWithTrigger, ...props }: SelectPrimitive.Popup.Props & Pick<SelectPrimitive.Positioner.Props, 'align' | 'alignOffset' | 'side' | 'sideOffset' | 'alignItemWithTrigger'>): React.JSX.Element;
 /**
- * グループのタイトルや見出しを表すラベルコンポーネント。
+ * Provides the label for a select option group.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectLabel({ className, ...props }: SelectPrimitive.GroupLabel.Props): React.JSX.Element;
+/**
+ * Base UI option props with a stable selector for the option element.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectItem
+ */
 interface SelectItemProps extends SelectPrimitive.Item.Props {
+    /**
+     * Stable data-testid assigned to the rendered control/container; omitted means no selector.
+     */
     testId?: string;
 }
 /**
- * ドロップダウンリスト内の個々の選択肢アイテム。
+ * Renders an option with selected-state checkmark and optional test ID.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectItem({ className, children, testId, ...props }: SelectItemProps): React.JSX.Element;
 /**
- * アイテムやグループを区切るためのセパレーター（区切り線）。
+ * Draws a noninteractive divider between option groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectSeparator({ className, ...props }: SelectPrimitive.Separator.Props): React.JSX.Element;
 /**
- * リストが長い場合に、上方向にスクロールするためのインジケーターボタン。
+ * Renders the upstream upward-scroll control with an up chevron.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectScrollUpButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.  children are replaced by the fixed scroll chevron.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectScrollUpButton({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.ScrollUpArrow>): React.JSX.Element;
 /**
- * リストが長い場合に、下方向にスクロールするためのインジケーターボタン。
+ * Renders the upstream downward-scroll control with a down chevron.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered SelectScrollDownButton composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback.  children are replaced by the fixed scroll chevron.
+ * @example
+ * ```tsx
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
+ * ```
  */
 declare function SelectScrollDownButton({ className, ...props }: React.ComponentProps<typeof SelectPrimitive.ScrollDownArrow>): React.JSX.Element;
 /**
- * セレクトボックスの選択肢を表すインターフェースです。
+ * Display content, string value and disabled state for a SelectInput option.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectInput
  */
 export interface SelectOption {
-    /** 表示されるラベルテキストまたは要素 */
+    /**
+     * Visible React content for this option.
+     */
     label: React.ReactNode;
-    /** 選択時に使用される値 */
+    /**
+     * Unique string identity passed to selection callbacks.
+     */
     value: string;
-    /** 選択肢を無効化するかどうか */
+    /**
+     * Prevents option selection when true; omitted means enabled.
+     */
     disabled?: boolean;
 }
 /**
- * SelectInputコンポーネントのプロパティです。
+ * Base UI root props with option data and trigger presentation/accessibility settings.
+ * @remarks Inherited native or primitive props keep their upstream types and behavior; this declaration documents only the wrapper-owned options.
+ * @see SelectInput
  */
 export interface SelectInputProps extends React.ComponentProps<typeof SelectPrimitive.Root> {
-    /** Accessible name applied to the interactive trigger. */
+    /**
+     * Accessible name applied to the interactive trigger.
+     */
     'aria-label'?: string;
-    /** ID of the label for the interactive trigger. */
+    /**
+     * Space-separated element IDs that label the interactive trigger.
+     */
     'aria-labelledby'?: string;
-    /** 選択肢の配列 */
+    /**
+     * Options in popup order; labels are also resolved for controlled values.
+     */
     options: SelectOption[];
-    /** 未選択時に表示されるプレースホルダーテキスト */
+    /**
+     * Text displayed while no value is selected/entered; omitted means no placeholder.
+     */
     placeholder?: string;
-    /** 追加のCSSクラス名 */
+    /**
+     * Additional classes on the interactive SelectTrigger.
+     */
     className?: string;
-    /** テスト用のID */
+    /**
+     * data-testid on the SelectTrigger; no per-option IDs are synthesized.
+     */
     testId?: string;
-    /** コンポーネントのサイズ */
+    /**
+     * Trigger size; defaults to default.
+     */
     size?: 'default' | 'sm';
-    /** 左側に表示するカスタムアイコン要素 */
+    /**
+     * Optional content before SelectValue inside the trigger.
+     */
     icon?: React.ReactNode;
 }
 /**
- * シンプルで使いやすいセレクトボックスラッパーコンポーネントです。
- *
- * 内部で `Select`, `SelectTrigger`, `SelectValue`, `SelectContent`, `SelectItem` などの
- * 複雑な構造を隠蔽し、`options` を渡すだけで完結するように設計されています。
- * 単一の検索機能を持たないシンプルなドロップダウンが必要な場合に最適です。
- *
- * `React.forwardRef` に対応しているため、`react-hook-form` の `Controller` と直接組み合わせて使用できます。
- *
+ * Builds a complete select from an options array and forwards its ref to the trigger.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: size='default'.
+ * @returns The rendered SelectInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. Compound parts require Select context; GroupLabel belongs in a Group. Content supplies portal, positioner, List and scroll arrows. SelectInput className/testId/size and accessible labels target the trigger; remaining root props target Select. size defaults to default. If both value and defaultValue are absent, SelectInput passes controlled null; use defaultValue for upstream uncontrolled state. Controlled values are matched to option labels by String(value), with string/number fallback. The ref prop forwards to the rendered control or container declared by the component ref type.
  * @example
  * ```tsx
- * <SelectInput
- *     value={sortBy}
- *     onValueChange={setSortBy}
- *     options={[
- *         { label: "日付順", value: "date" },
- *         { label: "名前順", value: "name" }
- *     ]}
- *     placeholder="並び替え..."
- * />
+ * import { SelectInput } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<SelectInput aria-label="Sort order" defaultValue="date" options={[{ value: "date", label: "Date" }, { value: "name", label: "Name" }]} placeholder="Choose order" />);
+ * }
  * ```
  */
 declare const SelectInput: React.ForwardRefExoticComponent<SelectInputProps & React.RefAttributes<never>>;