@sesamehr/react-design-system 2.0.0-beta.12 → 2.0.0-beta.14

package/dist/Forms/Inputs/Combobox/Combobox.d.ts

@@ -16,6 +16,25 @@ export interface ComboboxProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     /** Emitted when the open state changes. */
     onOpenChange?: (open: boolean) => void;
     children?: React.ReactNode;
+    /**
+     * The term to search for, once typing has stopped. Binding it is what tells
+     * the combobox its options are an answer it asked for — see `ignoreFilter`.
+     */
+    onSearch?: (term: string) => void;
+    /**
+     * Quiet period, in milliseconds, between the last keystroke and `onSearch`.
+     * `0` emits in the same tick.
+     */
+    debounce?: number;
+    /**
+     * Whether to skip filtering the rendered options in the browser. Left unset
+     * it follows `onSearch`: options the caller went and fetched have already
+     * been filtered, by something that knows more than a literal text match does
+     * — search "peres", get "Ana Pérez" back from a server that folds accents,
+     * and a second pass here hides a correct answer with nothing logged. Pass it
+     * explicitly to override, `false` included.
+     */
+    ignoreFilter?: boolean;
     dataTestid: string;
 }
 /**

package/dist/Forms/Inputs/Combobox/ComboboxChipsInput.d.ts

@@ -3,6 +3,13 @@ export interface ComboboxChipsInputProps extends Omit<React.InputHTMLAttributes<
     placeholder?: string;
     disabled?: boolean;
     size?: InputSize;
+    /**
+     * Names a chip the options cannot: a selection that arrived with the record,
+     * from a server, before any item existed to report a label. Return
+     * `undefined` for anything it does not know and the option's own label is
+     * used, so it never has to answer for values the list can speak for itself.
+     */
+    chipLabel?: (value: string) => string | undefined;
     /** Custom trigger content (defaults to a chevron icon). */
     trigger?: React.ReactNode;
 }

package/dist/Forms/Inputs/Combobox/context.d.ts

@@ -22,6 +22,12 @@ export interface ComboboxContextValue extends ComboboxEditing {
     /** Search string driving cmdk filtering. */
     search: string;
     setSearch: (search: string) => void;
+    /** Typing: restart the quiet period before the root's `onSearch`. */
+    scheduleSearch: (term: string) => void;
+    /** A gesture that settles the term — clearing it. Report now. */
+    searchImmediately: (term: string) => void;
+    /** Whether cmdk should leave the rendered options alone. */
+    skipFilter: boolean;
     /**
      * The text each option renders, keyed by the value it selects, so the field
      * can show `Barcelona` rather than `barcelona`. See `useComboboxLabels` for

package/dist/Forms/Inputs/Combobox/useComboboxSearch.d.ts

@@ -0,0 +1,20 @@
+export interface ComboboxSearch {
+    /** Typing: restart the quiet period, emit when it elapses. */
+    schedule: (term: string) => void;
+    /** A gesture that settles the term — clearing it. Emit now. */
+    immediately: (term: string) => void;
+}
+/**
+ * The wire between whichever field is typed into and the root's `onSearch`.
+ *
+ * The root is where `debounce` and `onSearch` belong — there are three fields
+ * (`ComboboxInput`, `ComboboxChipsInput`, and `ComboboxCancel` clearing one of
+ * them) and a prop on each would be the same number asked three times. The
+ * fields reach it through the shared context, beside `setSearch`.
+ *
+ * The fields report from their `onChange` rather than from the term itself,
+ * because the term is also written when a value is selected — the field is
+ * reset and the resolved label put in its place — and a search fired for the
+ * text of the option the user just picked is a request nobody asked for.
+ */
+export declare function useComboboxSearch(debounce: number, onSearch: ((term: string) => void) | undefined): ComboboxSearch;

package/dist/Forms/Inputs/SearchBar/SearchBar.d.ts

@@ -6,14 +6,14 @@ export interface SearchBarProps extends Omit<React.InputHTMLAttributes<HTMLInput
      * Milliseconds of no typing before `onSearch` fires. `0` fires on every
      * keystroke.
      */
-    delay?: number;
+    debounce?: number;
     /** Controlled term. Pair with `onValueChange`; omit for uncontrolled. */
     value?: string;
     /** Starting term when uncontrolled. */
     defaultValue?: string;
     /** Called on every keystroke with the next term, without waiting. */
     onValueChange?: (value: string) => void;
-    /** Called once typing has been quiet for `delay` ms — and at once on Enter or clear. */
+    /** Called once typing has been quiet for `debounce` ms — and at once on Enter or clear. */
     onSearch?: (term: string) => void;
     dataTestid: string;
 }

package/dist/Forms/Inputs/SearchBar/index.d.ts

@@ -1,8 +1,6 @@
 import { VariantProps } from 'class-variance-authority';
 export { SearchBar } from './SearchBar.tsx';
 export type { SearchBarProps } from './SearchBar.tsx';
-export { useSearchDelay } from './useSearchDelay.ts';
-export type { UseSearchDelayReturn } from './useSearchDelay.ts';
 /**
  * Class names, not utilities — see `Button/index.ts` for why the package
  * cannot publish `.h-10` and `.rounded-lg` of its own. `SearchBar.module.css`

package/dist/hooks/index.d.ts

@@ -8,5 +8,7 @@
  * sibling's folder and a reader having to know that `Textarea`'s sizing is
  * really `ChatInput`'s. See `.claude/rules/component-architecture.md` §13.
  */
-export { useAutoGrow } from './useAutoGrow.ts';
-export type { UseAutoGrowReturn } from './useAutoGrow.ts';
+export { useAutoGrow } from './useAutoGrow/useAutoGrow.ts';
+export type { UseAutoGrowReturn } from './useAutoGrow/useAutoGrow.ts';
+export { useSearchDebounce } from './useSearchDebounce/useSearchDebounce.ts';
+export type { UseSearchDebounceReturn } from './useSearchDebounce/useSearchDebounce.ts';

package/dist/{Forms/Inputs/SearchBar/useSearchDelay.d.ts → hooks/useSearchDebounce/useSearchDebounce.d.ts}

@@ -1,6 +1,6 @@
 /**
  * The quiet period between typing and searching — mirrors
- * `@sesame/orxata-core` `useSearchDelay`.
+ * `@sesame/orxata-core` `useSearchDebounce`.
  *
  * A search field that emits on every keystroke turns "Marie" into five
  * requests, four of which are already stale by the time they land. Waiting for
@@ -13,7 +13,7 @@
  * drops whatever `schedule` had pending, which would otherwise fire a moment
  * later with a term the user has already moved on from.
  */
-export interface UseSearchDelayReturn {
+export interface UseSearchDebounceReturn {
     /** Restart the quiet period; emit when it elapses. */
     schedule: (term: string) => void;
     /** Emit now, dropping anything pending. */
@@ -21,4 +21,4 @@ export interface UseSearchDelayReturn {
     /** Drop anything pending without emitting. */
     cancel: () => void;
 }
-export declare const useSearchDelay: (delay: number, emit: (term: string) => void) => UseSearchDelayReturn;
+export declare const useSearchDebounce: (debounce: number, emit: (term: string) => void) => UseSearchDebounceReturn;

package/dist/main.d.ts

@@ -44,6 +44,6 @@ export { PageControl as OxPageControl, pageControlDots, PAGE_CONTROL_WINDOW, typ
 export { Breadcrumb as OxBreadcrumb, BreadcrumbList as OxBreadcrumbList, BreadcrumbItem as OxBreadcrumbItem, BreadcrumbLink as OxBreadcrumbLink, BreadcrumbPage as OxBreadcrumbPage, BreadcrumbSeparator as OxBreadcrumbSeparator, BreadcrumbEllipsis as OxBreadcrumbEllipsis, } from './Navigation/Breadcrumb/index.ts';
 export { Counter as OxCounter, counterVariants, type CounterVariants, } from './Forms/Field/Counter/index.ts';
 export { FieldGroup as OxFieldGroup, FieldLabel as OxFieldLabel, FieldMessage as OxFieldMessage, useFieldControl, useFieldControlGroup, type FieldControlAttrs, type FieldControlGroupAttrs, type FieldGroupProps, type FieldVariant, } from './Forms/Field/index.ts';
-export { InputGroup as OxInputGroup, InputText as OxInputText, InputNumber as OxInputNumber, InputNumberContent as OxInputNumberContent, InputNumberDecrement as OxInputNumberDecrement, InputNumberIncrement as OxInputNumberIncrement, InputNumberInput as OxInputNumberInput, InputPassword as OxInputPassword, InputPasswordInput as OxInputPasswordInput, InputPasswordToggle as OxInputPasswordToggle, useInputPassword, InputOtp as OxInputOtp, InputOtpGroup as OxInputOtpGroup, InputOtpSlot as OxInputOtpSlot, InputOtpSeparator as OxInputOtpSeparator, useInputOtp, Calendar as OxCalendar, CalendarRange as OxCalendarRange, CalendarDay as OxCalendarDay, calendarDayVariants, Combobox as OxCombobox, ComboboxCancel as OxComboboxCancel, ComboboxInput as OxComboboxInput, ComboboxChipsInput as OxComboboxChipsInput, ComboboxContent as OxComboboxContent, ComboboxItem as OxComboboxItem, ComboboxItemEdit as OxComboboxItemEdit, ComboboxEmpty as OxComboboxEmpty, ComboboxGroup as OxComboboxGroup, ComboboxSeparator as OxComboboxSeparator, ChatInput as OxChatInput, DatePicker as OxDatePicker, DateRangePicker as OxDateRangePicker, DatePickerTrigger as OxDatePickerTrigger, DatePickerHeader as OxDatePickerHeader, DatePickerMonthSelect as OxDatePickerMonthSelect, DatePickerYearSelect as OxDatePickerYearSelect, SearchBar as OxSearchBar, searchBarVariants, useSearchDelay, SearchPanel as OxSearchPanel, SearchPanelInput as OxSearchPanelInput, SearchPanelList as OxSearchPanelList, SearchPanelGroup as OxSearchPanelGroup, SearchPanelItem as OxSearchPanelItem, SearchPanelEmpty as OxSearchPanelEmpty, Select as OxSelect, SelectTrigger as OxSelectTrigger, SelectContent as OxSelectContent, SelectItem as OxSelectItem, SelectGroup as OxSelectGroup, SelectSeparator as OxSelectSeparator, Textarea as OxTextarea, Switch as OxSwitch, Checkbox as OxCheckbox, RadioButton as OxRadioButton, RadioGroup as OxRadioGroup, ToggleGroup as OxToggleGroup, ToggleLabel as OxToggleLabel, ToggleDescription as OxToggleDescription, SWITCH_SIZES, type InputNumberProps, type InputPasswordProps, type InputPasswordContext, type InputOtpProps, type InputOtpSlotProps, type InputOtpContext, type CalendarProps, type CalendarRangeProps, type CalendarDateRange, type CalendarDayProps, type CalendarDayState, type CalendarDayVariants, type CalendarConstraints, type CalendarNav, type ComboboxProps, type ChatInputActionLabels, type ChatInputState, type DatePickerProps, type DateRangePickerProps, type DatePickerTriggerProps, type DatePickerHeaderProps, type DatePickerMonthSelectProps, type DatePickerYearSelectProps, type SearchBarVariants, type UseSearchDelayReturn, type SelectProps, type TextareaCounterState, type RadioGroupProps, type ToggleGroupProps, type ToggleLabelProps, type ToggleDescriptionProps, } from './Forms/Inputs/index.ts';
+export { InputGroup as OxInputGroup, InputText as OxInputText, InputNumber as OxInputNumber, InputNumberContent as OxInputNumberContent, InputNumberDecrement as OxInputNumberDecrement, InputNumberIncrement as OxInputNumberIncrement, InputNumberInput as OxInputNumberInput, InputPassword as OxInputPassword, InputPasswordInput as OxInputPasswordInput, InputPasswordToggle as OxInputPasswordToggle, useInputPassword, InputOtp as OxInputOtp, InputOtpGroup as OxInputOtpGroup, InputOtpSlot as OxInputOtpSlot, InputOtpSeparator as OxInputOtpSeparator, useInputOtp, Calendar as OxCalendar, CalendarRange as OxCalendarRange, CalendarDay as OxCalendarDay, calendarDayVariants, Combobox as OxCombobox, ComboboxCancel as OxComboboxCancel, ComboboxInput as OxComboboxInput, ComboboxChipsInput as OxComboboxChipsInput, ComboboxContent as OxComboboxContent, ComboboxItem as OxComboboxItem, ComboboxItemEdit as OxComboboxItemEdit, ComboboxEmpty as OxComboboxEmpty, ComboboxGroup as OxComboboxGroup, ComboboxSeparator as OxComboboxSeparator, ChatInput as OxChatInput, DatePicker as OxDatePicker, DateRangePicker as OxDateRangePicker, DatePickerTrigger as OxDatePickerTrigger, DatePickerHeader as OxDatePickerHeader, DatePickerMonthSelect as OxDatePickerMonthSelect, DatePickerYearSelect as OxDatePickerYearSelect, SearchBar as OxSearchBar, searchBarVariants, SearchPanel as OxSearchPanel, SearchPanelInput as OxSearchPanelInput, SearchPanelList as OxSearchPanelList, SearchPanelGroup as OxSearchPanelGroup, SearchPanelItem as OxSearchPanelItem, SearchPanelEmpty as OxSearchPanelEmpty, Select as OxSelect, SelectTrigger as OxSelectTrigger, SelectContent as OxSelectContent, SelectItem as OxSelectItem, SelectGroup as OxSelectGroup, SelectSeparator as OxSelectSeparator, Textarea as OxTextarea, Switch as OxSwitch, Checkbox as OxCheckbox, RadioButton as OxRadioButton, RadioGroup as OxRadioGroup, ToggleGroup as OxToggleGroup, ToggleLabel as OxToggleLabel, ToggleDescription as OxToggleDescription, SWITCH_SIZES, type InputNumberProps, type InputPasswordProps, type InputPasswordContext, type InputOtpProps, type InputOtpSlotProps, type InputOtpContext, type CalendarProps, type CalendarRangeProps, type CalendarDateRange, type CalendarDayProps, type CalendarDayState, type CalendarDayVariants, type CalendarConstraints, type CalendarNav, type ComboboxProps, type ChatInputActionLabels, type ChatInputState, type DatePickerProps, type DateRangePickerProps, type DatePickerTriggerProps, type DatePickerHeaderProps, type DatePickerMonthSelectProps, type DatePickerYearSelectProps, type SearchBarVariants, type SelectProps, type TextareaCounterState, type RadioGroupProps, type ToggleGroupProps, type ToggleLabelProps, type ToggleDescriptionProps, } from './Forms/Inputs/index.ts';
 export { Table as OxTable, TableVirtualized as OxTableVirtualized, TableHead as OxTableHead, TableBody as OxTableBody, TableRow as OxTableRow, TableCell as OxTableCell, TableHeaderCell as OxTableHeaderCell, TableSelectCell as OxTableSelectCell, TableDragCell as OxTableDragCell, TableBulkHeader as OxTableBulkHeader, TablePagination as OxTablePagination, TableEmpty as OxTableEmpty, TableRowExpanded as OxTableRowExpanded, TableExpandCell as OxTableExpandCell, TableColumnVisibility as OxTableColumnVisibility, useTable, useTableSelection, useTableSorting, useTablePagination, useTableDetailRow, useTablePinning, useTableColumns, useScrollShadow, useDragToScroll, useFixedColumns, useTableVirtual, } from './Data/Table/index.ts';
 export type { UseTableOptions, UseTableReturn, UseTableSelectionReturn, UseTableSortingReturn, UseTablePaginationOptions, UseTablePaginationReturn, DetailRowInstance, DetailRowOptions, DetailRowPluginDef, UseTablePinningOptions, UseTablePinningReturn, CellInfo, HeaderInfo, UseTableVirtualOptions, UseTableVirtualReturn, UseTableColumnsOptions, UseTableColumnsReturn, UseScrollShadowOptions, UseScrollShadowReturn, UseDragToScrollOptions, UseDragToScrollReturn, UseFixedColumnsOptions, TableProps, TableMode, ColumnDef, ColumnAlign, CellContext, SortingState, PaginationState, PaginationChangePayload, SortingChangePayload, SelectionChangePayload, FilterChangePayload, ColumnResizeMode, ColumnVisibilityState, ColumnOrderState, ExpandedState, ColumnVisibilityChangePayload, ColumnOrderChangePayload, RowExpandChangePayload, ColumnResizePayload, ColumnPinningState, } from './Data/Table/index.ts';