@pearpages/pulp-react 0.0.0

package/dist/combobox.d.ts

@@ -0,0 +1,75 @@
+import * as react from 'react';
+import { ReactNode, Ref } from 'react';
+import { L as ListboxItem } from './ListboxOptions-DLsT-dkV.js';
+
+type ComboboxItem = ListboxItem;
+type ComboboxSize = 'sm' | 'md' | 'lg';
+/** `contains` and `startsWith` filter `items` as the user types; `none` shows `items` as given (you filtered them, typically after a fetch). */
+type ComboboxFilter = 'contains' | 'startsWith' | 'none';
+interface ComboboxProps {
+    /** Visible label. Always rendered. */
+    label: ReactNode;
+    description?: ReactNode;
+    /** Presence marks the control invalid and announces the message. */
+    error?: ReactNode;
+    /** The options. With `filter="none"` they are shown as given. */
+    items: readonly ComboboxItem[];
+    /** Selected id (controlled). `null` is "nothing selected". */
+    value?: string | null;
+    defaultValue?: string | null;
+    onChange?: (value: string | null) => void;
+    /** The text in the input (controlled). Pair with `onInputChange` to fetch options as the user types. */
+    inputValue?: string;
+    defaultInputValue?: string;
+    onInputChange?: (text: string) => void;
+    /** @default 'contains' */
+    filter?: ComboboxFilter;
+    /** Keeps the list open with a spinner in the control while options load. @default false */
+    loading?: boolean;
+    /** Shown in the open list when no option matches. @default 'No results' */
+    emptyMessage?: ReactNode;
+    /** Announced while `loading`. @default 'Loading…' */
+    loadingMessage?: ReactNode;
+    /** Let the typed text stand as the value even when it matches no option. @default false */
+    allowsCustomValue?: boolean;
+    /** When the list opens: on focus, on typing, or only from the button and arrow keys. @default 'input' */
+    menuTrigger?: 'focus' | 'input' | 'manual';
+    placeholder?: string;
+    /** @default 'md' */
+    size?: ComboboxSize;
+    /** @default false */
+    required?: boolean;
+    /** @default false */
+    disabled?: boolean;
+    /** @default false */
+    readOnly?: boolean;
+    /** Submitted with a form: the selected id (or the text with `allowsCustomValue`). */
+    name?: string;
+    autoFocus?: boolean;
+    /** Applied to the field wrapper, not the input. */
+    className?: string;
+    /** The `<input>` element. */
+    ref?: Ref<HTMLInputElement>;
+}
+/**
+ * A text input that suggests options as the user types, on React Aria's
+ * combobox (decision record 001): the list is announced through
+ * `aria-activedescendant`, arrows move, Enter selects, Escape closes and
+ * then clears. Static lists filter themselves; for async options, control
+ * `inputValue`, fetch, and pass the results with `filter="none"` and
+ * `loading` while they arrive. Options look the same as Listbox's.
+ *
+ * @status experimental
+ * @category Forms
+ * @accessibility A `combobox` input with `aria-autocomplete="list"`; the open list is a `listbox` announced through `aria-activedescendant`, so focus stays in the input. Arrows move, Enter selects, Escape closes and then clears. Loading and empty states are announced from inside the list.
+ * @do Use `filter="none"` with controlled `inputValue` for server-side search.
+ * Keep `loading` true until the results for the current text arrive.
+ * @dont Use it for fewer than five fixed options; use Picker or the native Select.
+ * Set `menuTrigger="focus"` on a long list; opening on every focus is noisy.
+ */
+declare function Combobox({ label, description, error, items, value, defaultValue, onChange, inputValue, defaultInputValue, onInputChange, filter, loading, emptyMessage, loadingMessage, allowsCustomValue, menuTrigger, placeholder, size, required, disabled, readOnly, name, autoFocus, className, ref, }: ComboboxProps): react.JSX.Element;
+declare namespace Combobox {
+    var displayName: string;
+}
+
+export { Combobox, type ComboboxFilter, type ComboboxItem, type ComboboxProps, type ComboboxSize };

package/dist/combobox.js

@@ -0,0 +1,10 @@
+export { Combobox } from './chunk-Q6J6BMSB.js';
+import './chunk-I4KC4V6A.js';
+import './chunk-Z4PN6B2C.js';
+import './chunk-4HRNRTXI.js';
+import './chunk-YUHS5S5Y.js';
+import './chunk-T76YSNTZ.js';
+import './chunk-ASNTNTJW.js';
+import './chunk-MI4QUKQS.js';
+//# sourceMappingURL=combobox.js.map
+//# sourceMappingURL=combobox.js.map

package/dist/combobox.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"combobox.js"}