@alneas/appkit-react 0.1.0 → 0.2.0

package/dist/ui/components/ui/combobox-components.d.cts

@@ -1,65 +1,260 @@
 import { Combobox as ComboboxPrimitive } from '@base-ui/react/combobox';
 import * as React from 'react';
+/**
+ * Coordinates searchable selection using the Base UI Combobox root.
+ * @typeParam Value - Selection value represented by an item and emitted by selection callbacks; inferred from the root props.
+ * @typeParam Multiple - Whether selection uses an array; extends boolean | undefined and defaults to false.
+ * @typeParam Item - Root collection item shape, defaulting to Value; may differ when explicit item-to-value conversion is configured.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered Combobox composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
+ */
 declare const Combobox: typeof ComboboxPrimitive.Root;
 /**
- * コントロール内に現在選択されている値を表示するコンポーネント。
+ * Renders the current combobox selection using its root context.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxValue composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxValue({ ...props }: ComboboxPrimitive.Value.Props): React.JSX.Element;
 /**
- * コボボックスのドロップダウンメニューを展開するためのトリガーボタン。
+ * Renders the control that toggles the combobox popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxTrigger({ className, children, ...props }: ComboboxPrimitive.Trigger.Props): React.JSX.Element;
 /**
- * ユーザーが検索クエリを入力するためのテキスト入力フィールド。
+ * Combines a search input with optional trigger and clear controls.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: disabled=false, showTrigger=true, showClear=false.
+ * @returns The rendered ComboboxInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option. className targets the outer InputGroup; children are appended inside that group. disabled defaults to false.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxInput({ className, children, disabled, showTrigger, showClear, ...props }: ComboboxPrimitive.Input.Props & {
+    /**
+     * Includes the popup toggle beside the combobox input; defaults to true.
+     */
     showTrigger?: boolean;
+    /**
+     * Includes the clear-selection control beside the combobox input; defaults to false.
+     */
     showClear?: boolean;
 }): React.JSX.Element;
 /**
- * コボボックスのドロップダウンポップアップを表示するコンテナ。
+ * Portals and positions the combobox popup relative to its input or explicit anchor.
+ * @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=6, align='start', alignOffset=0.
+ * @returns The rendered ComboboxContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxContent({ className, side, sideOffset, align, alignOffset, anchor, ...props }: ComboboxPrimitive.Popup.Props & Pick<ComboboxPrimitive.Positioner.Props, 'side' | 'align' | 'sideOffset' | 'alignOffset' | 'anchor'>): React.JSX.Element;
 /**
- * 選択肢のリストを表示するためのコンテナコンポーネント。
+ * Renders the scrollable collection of combobox results.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxList composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxList({ className, ...props }: ComboboxPrimitive.List.Props): React.JSX.Element;
 /**
- * リスト内の個々の選択肢アイテム。
+ * Renders one selectable result with a built-in selected indicator.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxItem({ className, children, ...props }: ComboboxPrimitive.Item.Props): React.JSX.Element;
 /**
- * 複数の選択肢アイテムを関連するグループにまとめるためのコンポーネント。
+ * Groups related combobox results.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxGroup({ className, ...props }: ComboboxPrimitive.Group.Props): React.JSX.Element;
 /**
- * グループのヘッダーやタイトルを表示するラベル。
+ * Labels the surrounding combobox result group.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxLabel({ className, ...props }: ComboboxPrimitive.GroupLabel.Props): React.JSX.Element;
 /**
- * 動的なアイテムのコレクションを表示するためのヘルパーコンポーネント。
+ * Renders results from the root collection using Base UI collection semantics.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxCollection composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxCollection({ ...props }: ComboboxPrimitive.Collection.Props): React.JSX.Element;
 /**
- * 検索結果が空の時に表示されるメッセージコンポーネント。
+ * Displays an empty-results message in the combobox popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxEmpty composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxEmpty({ className, ...props }: ComboboxPrimitive.Empty.Props): React.JSX.Element;
 /**
- * グループやアイテム同士を区切るためのセパレーター（区切り線）。
+ * Draws a separator between result groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxSeparator({ className, ...props }: ComboboxPrimitive.Separator.Props): React.JSX.Element;
 /**
- * 複数選択時に選択された値をチップス（タグ）として表示するコンテナ。
+ * Lays out the selected chips for a multiple-selection combobox.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxChips composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxChips({ className, ...props }: React.ComponentPropsWithRef<typeof ComboboxPrimitive.Chips> & ComboboxPrimitive.Chips.Props): React.JSX.Element;
 /**
- * 選択された値を表す個々のチップ（タグ）コンポーネント。
+ * Renders one selected value with an optional remove control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: showRemove=true.
+ * @returns The rendered ComboboxChip composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxChip({ className, children, showRemove, ...props }: ComboboxPrimitive.Chip.Props & {
+    /**
+     * Includes a remove button in a selected chip; defaults to true.
+     */
     showRemove?: boolean;
 }): React.JSX.Element;
 /**
- * チップスモード用のテキスト入力フィールド。
+ * Renders the search input within a multiple-selection chip container.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxChipsInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxChipsInput({ className, ...props }: ComboboxPrimitive.Input.Props): React.JSX.Element;
 export { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxGroup, ComboboxLabel, ComboboxCollection, ComboboxEmpty, ComboboxSeparator, ComboboxChips, ComboboxChip, ComboboxChipsInput, ComboboxTrigger, ComboboxValue, };

package/dist/ui/components/ui/combobox-components.d.ts

@@ -1,65 +1,260 @@
 import { Combobox as ComboboxPrimitive } from '@base-ui/react/combobox';
 import * as React from 'react';
+/**
+ * Coordinates searchable selection using the Base UI Combobox root.
+ * @typeParam Value - Selection value represented by an item and emitted by selection callbacks; inferred from the root props.
+ * @typeParam Multiple - Whether selection uses an array; extends boolean | undefined and defaults to false.
+ * @typeParam Item - Root collection item shape, defaulting to Value; may differ when explicit item-to-value conversion is configured.
+ * @param props - Inherited primitive configuration, children and controlled/default state; the upstream prop type remains authoritative.
+ * @returns The rendered Combobox composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
+ */
 declare const Combobox: typeof ComboboxPrimitive.Root;
 /**
- * コントロール内に現在選択されている値を表示するコンポーネント。
+ * Renders the current combobox selection using its root context.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxValue composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxValue({ ...props }: ComboboxPrimitive.Value.Props): React.JSX.Element;
 /**
- * コボボックスのドロップダウンメニューを展開するためのトリガーボタン。
+ * Renders the control that toggles the combobox popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxTrigger composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxTrigger({ className, children, ...props }: ComboboxPrimitive.Trigger.Props): React.JSX.Element;
 /**
- * ユーザーが検索クエリを入力するためのテキスト入力フィールド。
+ * Combines a search input with optional trigger and clear controls.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: disabled=false, showTrigger=true, showClear=false.
+ * @returns The rendered ComboboxInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option. className targets the outer InputGroup; children are appended inside that group. disabled defaults to false.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxInput({ className, children, disabled, showTrigger, showClear, ...props }: ComboboxPrimitive.Input.Props & {
+    /**
+     * Includes the popup toggle beside the combobox input; defaults to true.
+     */
     showTrigger?: boolean;
+    /**
+     * Includes the clear-selection control beside the combobox input; defaults to false.
+     */
     showClear?: boolean;
 }): React.JSX.Element;
 /**
- * コボボックスのドロップダウンポップアップを表示するコンテナ。
+ * Portals and positions the combobox popup relative to its input or explicit anchor.
+ * @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=6, align='start', alignOffset=0.
+ * @returns The rendered ComboboxContent composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxContent({ className, side, sideOffset, align, alignOffset, anchor, ...props }: ComboboxPrimitive.Popup.Props & Pick<ComboboxPrimitive.Positioner.Props, 'side' | 'align' | 'sideOffset' | 'alignOffset' | 'anchor'>): React.JSX.Element;
 /**
- * 選択肢のリストを表示するためのコンテナコンポーネント。
+ * Renders the scrollable collection of combobox results.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxList composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxList({ className, ...props }: ComboboxPrimitive.List.Props): React.JSX.Element;
 /**
- * リスト内の個々の選択肢アイテム。
+ * Renders one selectable result with a built-in selected indicator.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxItem composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxItem({ className, children, ...props }: ComboboxPrimitive.Item.Props): React.JSX.Element;
 /**
- * 複数の選択肢アイテムを関連するグループにまとめるためのコンポーネント。
+ * Groups related combobox results.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxGroup composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxGroup({ className, ...props }: ComboboxPrimitive.Group.Props): React.JSX.Element;
 /**
- * グループのヘッダーやタイトルを表示するラベル。
+ * Labels the surrounding combobox result group.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxLabel composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxLabel({ className, ...props }: ComboboxPrimitive.GroupLabel.Props): React.JSX.Element;
 /**
- * 動的なアイテムのコレクションを表示するためのヘルパーコンポーネント。
+ * Renders results from the root collection using Base UI collection semantics.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxCollection composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxCollection({ ...props }: ComboboxPrimitive.Collection.Props): React.JSX.Element;
 /**
- * 検索結果が空の時に表示されるメッセージコンポーネント。
+ * Displays an empty-results message in the combobox popup.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxEmpty composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxEmpty({ className, ...props }: ComboboxPrimitive.Empty.Props): React.JSX.Element;
 /**
- * グループやアイテム同士を区切るためのセパレーター（区切り線）。
+ * Draws a separator between result groups.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxSeparator composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxSeparator({ className, ...props }: ComboboxPrimitive.Separator.Props): React.JSX.Element;
 /**
- * 複数選択時に選択された値をチップス（タグ）として表示するコンテナ。
+ * Lays out the selected chips for a multiple-selection combobox.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxChips composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxChips({ className, ...props }: React.ComponentPropsWithRef<typeof ComboboxPrimitive.Chips> & ComboboxPrimitive.Chips.Props): React.JSX.Element;
 /**
- * 選択された値を表す個々のチップ（タグ）コンポーネント。
+ * Renders one selected value with an optional remove control.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling. Wrapper defaults: showRemove=true.
+ * @returns The rendered ComboboxChip composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxChip({ className, children, showRemove, ...props }: ComboboxPrimitive.Chip.Props & {
+    /**
+     * Includes a remove button in a selected chip; defaults to true.
+     */
     showRemove?: boolean;
 }): React.JSX.Element;
 /**
- * チップスモード用のテキスト入力フィールド。
+ * Renders the search input within a multiple-selection chip container.
+ * @param props - Component attributes and children accepted by the declared Base UI or native prop type; className customizes wrapper styling.
+ * @returns The rendered ComboboxChipsInput composition.
+ * @remarks Import @alneas/appkit-react/styles in the rendering host. All interactive parts require Combobox context. Base UI owns generic value inference, selection and collection filtering; the wrapper does not fetch results. Input showTrigger defaults to true and showClear to false; Chip showRemove defaults to true. Content accepts an anchor for chip-based layouts; chips require the root multiple option.
+ * @example
+ * ```tsx
+ * import { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxEmpty } from '@alneas/appkit-react/ui';
+ * import '@alneas/appkit-react/styles';
+ *
+ * export function Example() {
+ *   return (<Combobox items={["Apple", "Pear"]}><ComboboxInput aria-label="Fruit" /><ComboboxContent><ComboboxEmpty>No results</ComboboxEmpty><ComboboxList>{(item: string) => <ComboboxItem key={item} value={item}>{item}</ComboboxItem>}</ComboboxList></ComboboxContent></Combobox>);
+ * }
+ * ```
  */
 declare function ComboboxChipsInput({ className, ...props }: ComboboxPrimitive.Input.Props): React.JSX.Element;
 export { Combobox, ComboboxInput, ComboboxContent, ComboboxList, ComboboxItem, ComboboxGroup, ComboboxLabel, ComboboxCollection, ComboboxEmpty, ComboboxSeparator, ComboboxChips, ComboboxChip, ComboboxChipsInput, ComboboxTrigger, ComboboxValue, };