@texturehq/edges 5.0.0 → 5.1.0

package/dist/{TimeField-rRIt80g3.d.ts → TimeField-DVuYVoDw.d.ts}

@@ -205,6 +205,93 @@ interface ColorFieldProps extends Omit<TextFieldProps$1, "isRequired" | "size" |
  */
 declare function ColorField({ label, description, errorMessage, size, tooltip, isRequired, transparent, className, validationResult, value: controlledValue, defaultValue, onChange, placeholder, showColorSwatch, reserveErrorSpace, ...props }: ColorFieldProps): react_jsx_runtime.JSX.Element;
 
+interface MultiSelectOption {
+    value: string;
+    label: string;
+    /** Display-only decoration. Never contributes to the search key. */
+    count?: number;
+    disabled?: boolean;
+    group?: string;
+}
+type MultiSelectMatcher = (text: string, query: string) => boolean;
+declare const defaultMultiSelectMatcher: MultiSelectMatcher;
+/**
+ * The only strings an option is searchable by. Presentational decoration —
+ * `count`, badges, anything a renderer composes — is deliberately excluded:
+ * making facet-count digits searchable turned a query for `5` into a match on
+ * a substation labelled `28 (15656)`.
+ */
+declare function multiSelectSearchKeys(option: MultiSelectOption): string[];
+declare function filterMultiSelectOptions<T extends MultiSelectOption>(options: readonly T[], query: string, matcher?: MultiSelectMatcher): T[];
+/**
+ * Whether the typed string should be offered as a selectable literal.
+ *
+ * The trigger is "the query is not already an identity in play" — not "nothing
+ * in the list matched". A match-count trigger is defeatable by any incidental
+ * substring hit, which is how single-digit values became unreachable in the
+ * control this component replaces.
+ */
+declare function shouldOfferLiteralOption(args: {
+    query: string;
+    options: readonly MultiSelectOption[];
+    selected: readonly string[];
+}): boolean;
+interface MultiSelectSelectionEntry {
+    value: string;
+    label: string;
+    count?: number;
+    /** True when the value is not present in the current `options` set. */
+    isUnknown: boolean;
+}
+/**
+ * Selections in insertion order, hydrating labels from `options` where possible.
+ * Values with no matching option still produce an entry so URL-hydrated state is
+ * never silently dropped.
+ */
+declare function multiSelectSelectionEntries(selected: readonly string[], options: readonly MultiSelectOption[]): MultiSelectSelectionEntry[];
+
+interface MultiSelectProps {
+    options: readonly MultiSelectOption[];
+    /** Controlled selection. Order is insertion order. */
+    value?: readonly string[];
+    /** Uncontrolled initial selection. */
+    defaultValue?: readonly string[];
+    onChange: (next: string[]) => void;
+    label: string;
+    placeholder?: string;
+    size?: Size;
+    loading?: boolean;
+    disabled?: boolean;
+    maxSelected?: number;
+    /** Offer the typed string as a selectable value. Off by default. */
+    allowLiteral?: boolean;
+    /** Server-side search. Debouncing is the caller's job. */
+    onSearchChange?: (query: string) => void;
+    /** `options` is a clipped set rather than the whole domain. */
+    truncated?: boolean;
+    /** Size of the whole domain. Rendered with `truncated` as "showing N of M". */
+    totalCount?: number;
+    emptyMessage?: string;
+    showSelectAll?: boolean;
+    description?: string;
+    errorMessage?: string;
+    isRequired?: boolean;
+    /** Fires when the search input loses focus. Form adapters use this to mark the field touched. */
+    onBlur?: (event: React__default.FocusEvent<HTMLInputElement>) => void;
+    /** Ref to the search input, so callers (and `setFocus`) can focus the control. */
+    inputRef?: React__default.Ref<HTMLInputElement>;
+    className?: string;
+    id?: string;
+}
+/**
+ * MultiSelect
+ *
+ * A combobox whose popup is a multi-select listbox (W3C ARIA APG): a search
+ * input narrows a checkbox list, and current selections live in their own
+ * pinned region above it.
+ */
+declare function MultiSelect({ options, value, defaultValue, onChange, label, placeholder, size, loading, disabled, maxSelected, allowLiteral, onSearchChange, truncated, totalCount, emptyMessage, showSelectAll, description, errorMessage, isRequired, onBlur, inputRef: forwardedInputRef, className, id, }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
 /**
  * NumberField
  *
@@ -546,4 +633,4 @@ interface TimeFieldProps extends Omit<TimeFieldProps$1<TimeValue>, "isRequired"
  */
 declare function TimeField({ label, description, errorMessage, size, tooltip, isRequired, isDisabled, isInvalid, reserveErrorSpace, validationResult, className, descriptionPlacement, ...props }: TimeFieldProps): react_jsx_runtime.JSX.Element;
 
-export { Autocomplete as A, Button as B, Checkbox as C, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, RadioGroup as c, Switch as d, TextField as e, type TimeFieldProps as f, type ButtonProps as g, type ColorFieldProps as h, Radio as i, RadioCard as j, type RadioCardGroupProps as k, type RadioCardProps as l, type SelectItem as m, TimeField as n };
+export { Autocomplete as A, Button as B, Checkbox as C, MultiSelect as M, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, type MultiSelectOption as c, RadioGroup as d, Switch as e, TextField as f, type TimeFieldProps as g, type ButtonProps as h, type ColorFieldProps as i, type MultiSelectMatcher as j, type MultiSelectProps as k, type MultiSelectSelectionEntry as l, Radio as m, RadioCard as n, type RadioCardGroupProps as o, type RadioCardProps as p, type SelectItem as q, TimeField as r, defaultMultiSelectMatcher as s, filterMultiSelectOptions as t, multiSelectSearchKeys as u, multiSelectSelectionEntries as v, shouldOfferLiteralOption as w };

package/dist/{TimeField-CJUNJDQT.d.cts → TimeField-DsHO9pLs.d.cts}

@@ -205,6 +205,93 @@ interface ColorFieldProps extends Omit<TextFieldProps$1, "isRequired" | "size" |
  */
 declare function ColorField({ label, description, errorMessage, size, tooltip, isRequired, transparent, className, validationResult, value: controlledValue, defaultValue, onChange, placeholder, showColorSwatch, reserveErrorSpace, ...props }: ColorFieldProps): react_jsx_runtime.JSX.Element;
 
+interface MultiSelectOption {
+    value: string;
+    label: string;
+    /** Display-only decoration. Never contributes to the search key. */
+    count?: number;
+    disabled?: boolean;
+    group?: string;
+}
+type MultiSelectMatcher = (text: string, query: string) => boolean;
+declare const defaultMultiSelectMatcher: MultiSelectMatcher;
+/**
+ * The only strings an option is searchable by. Presentational decoration —
+ * `count`, badges, anything a renderer composes — is deliberately excluded:
+ * making facet-count digits searchable turned a query for `5` into a match on
+ * a substation labelled `28 (15656)`.
+ */
+declare function multiSelectSearchKeys(option: MultiSelectOption): string[];
+declare function filterMultiSelectOptions<T extends MultiSelectOption>(options: readonly T[], query: string, matcher?: MultiSelectMatcher): T[];
+/**
+ * Whether the typed string should be offered as a selectable literal.
+ *
+ * The trigger is "the query is not already an identity in play" — not "nothing
+ * in the list matched". A match-count trigger is defeatable by any incidental
+ * substring hit, which is how single-digit values became unreachable in the
+ * control this component replaces.
+ */
+declare function shouldOfferLiteralOption(args: {
+    query: string;
+    options: readonly MultiSelectOption[];
+    selected: readonly string[];
+}): boolean;
+interface MultiSelectSelectionEntry {
+    value: string;
+    label: string;
+    count?: number;
+    /** True when the value is not present in the current `options` set. */
+    isUnknown: boolean;
+}
+/**
+ * Selections in insertion order, hydrating labels from `options` where possible.
+ * Values with no matching option still produce an entry so URL-hydrated state is
+ * never silently dropped.
+ */
+declare function multiSelectSelectionEntries(selected: readonly string[], options: readonly MultiSelectOption[]): MultiSelectSelectionEntry[];
+
+interface MultiSelectProps {
+    options: readonly MultiSelectOption[];
+    /** Controlled selection. Order is insertion order. */
+    value?: readonly string[];
+    /** Uncontrolled initial selection. */
+    defaultValue?: readonly string[];
+    onChange: (next: string[]) => void;
+    label: string;
+    placeholder?: string;
+    size?: Size;
+    loading?: boolean;
+    disabled?: boolean;
+    maxSelected?: number;
+    /** Offer the typed string as a selectable value. Off by default. */
+    allowLiteral?: boolean;
+    /** Server-side search. Debouncing is the caller's job. */
+    onSearchChange?: (query: string) => void;
+    /** `options` is a clipped set rather than the whole domain. */
+    truncated?: boolean;
+    /** Size of the whole domain. Rendered with `truncated` as "showing N of M". */
+    totalCount?: number;
+    emptyMessage?: string;
+    showSelectAll?: boolean;
+    description?: string;
+    errorMessage?: string;
+    isRequired?: boolean;
+    /** Fires when the search input loses focus. Form adapters use this to mark the field touched. */
+    onBlur?: (event: React__default.FocusEvent<HTMLInputElement>) => void;
+    /** Ref to the search input, so callers (and `setFocus`) can focus the control. */
+    inputRef?: React__default.Ref<HTMLInputElement>;
+    className?: string;
+    id?: string;
+}
+/**
+ * MultiSelect
+ *
+ * A combobox whose popup is a multi-select listbox (W3C ARIA APG): a search
+ * input narrows a checkbox list, and current selections live in their own
+ * pinned region above it.
+ */
+declare function MultiSelect({ options, value, defaultValue, onChange, label, placeholder, size, loading, disabled, maxSelected, allowLiteral, onSearchChange, truncated, totalCount, emptyMessage, showSelectAll, description, errorMessage, isRequired, onBlur, inputRef: forwardedInputRef, className, id, }: MultiSelectProps): react_jsx_runtime.JSX.Element;
+
 /**
  * NumberField
  *
@@ -546,4 +633,4 @@ interface TimeFieldProps extends Omit<TimeFieldProps$1<TimeValue>, "isRequired"
  */
 declare function TimeField({ label, description, errorMessage, size, tooltip, isRequired, isDisabled, isInvalid, reserveErrorSpace, validationResult, className, descriptionPlacement, ...props }: TimeFieldProps): react_jsx_runtime.JSX.Element;
 
-export { Autocomplete as A, Button as B, Checkbox as C, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, RadioGroup as c, Switch as d, TextField as e, type TimeFieldProps as f, type ButtonProps as g, type ColorFieldProps as h, Radio as i, RadioCard as j, type RadioCardGroupProps as k, type RadioCardProps as l, type SelectItem as m, TimeField as n };
+export { Autocomplete as A, Button as B, Checkbox as C, MultiSelect as M, NumberField as N, RadioCardGroup as R, Select as S, TextArea as T, CheckboxGroup as a, ColorField as b, type MultiSelectOption as c, RadioGroup as d, Switch as e, TextField as f, type TimeFieldProps as g, type ButtonProps as h, type ColorFieldProps as i, type MultiSelectMatcher as j, type MultiSelectProps as k, type MultiSelectSelectionEntry as l, Radio as m, RadioCard as n, type RadioCardGroupProps as o, type RadioCardProps as p, type SelectItem as q, TimeField as r, defaultMultiSelectMatcher as s, filterMultiSelectOptions as t, multiSelectSearchKeys as u, multiSelectSelectionEntries as v, shouldOfferLiteralOption as w };