@cratis/components 3.6.0 → 4.0.0

package/dist/esm/Dropdown/Dropdown.js

@@ -1,37 +1,15 @@
-import { jsx, jsxs } from 'react/jsx-runtime';
-import { Select } from 'primereact/select';
+import { unstable_useSlot } from '../renderer/RendererContext.js';
+import { renderSlot } from '../renderer/renderSlot.js';
+import { DropdownImplementation } from './DropdownImplementation.js';
 
-/**
- * Cratis single/multi select built on PrimeReact 11's compositional `Select`.
- *
- * PrimeReact 11 replaced the monolithic v10 `Dropdown` with a headless,
- * compositional `Select` (Root → Trigger/Value → Portal → Positioner → Popup →
- * List/Option). This wrapper assembles that composition once behind a small,
- * familiar `value` / `options` / `optionLabel` / `optionValue` / `onChange`
- * API so slices never touch the parts directly. `Select.List` auto-renders the
- * `options`, so no manual option mapping is needed.
- *
- * The options popup renders through `Select.Portal` and stacks correctly above
- * modal dialogs via PrimeReact 11's overlay manager — the v10 `appendTo` /
- * manual z-index workaround is no longer required.
- */
-/**
- * PrimeReact 10's `Dropdown` read `label` and `value` off option objects when no
- * `optionLabel` / `optionValue` was given; v11's `Select` compares the option object
- * itself against the value instead, so `[{ label, value }]` options with a scalar
- * `value` never match. Resolve the v10 convention here so those call sites keep working.
- */
-const conventionalField = (options, field) => {
-    const first = options?.[0];
-    return first !== null && typeof first === 'object' && field in first
-        ? field
-        : undefined;
-};
-const Dropdown = ({ value, options, optionLabel = conventionalField(options, 'label'), optionValue = conventionalField(options, 'value'), placeholder, filter, filterPlaceholder, multiple, showClear, invalid, disabled, className, style, id, name, tabIndex, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, 'aria-describedby': ariaDescribedby, onChange, onBlur, pt, ptOptions, unstyled, }) => {
-    return (jsx("span", { onBlur: onBlur, children: jsxs(Select.Root, { value: value, options: options, optionLabel: optionLabel, optionValue: optionValue, multiple: multiple, invalid: invalid, disabled: disabled, className: className, style: style, name: name, onValueChange: (event) => onChange?.({
-                value: event.value,
-                originalEvent: event.originalEvent,
-            }), pt: pt, ptOptions: ptOptions, unstyled: unstyled, children: [jsxs(Select.Trigger, { id: id, tabIndex: tabIndex, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "aria-describedby": ariaDescribedby, children: [jsx(Select.Value, { placeholder: placeholder }), showClear && (jsx(Select.Clear, { children: jsx("i", { className: 'pi pi-times' }) })), jsx(Select.Indicator, { children: jsx("i", { className: 'pi pi-chevron-down' }) })] }), jsx(Select.Portal, { children: jsx(Select.Positioner, { children: jsxs(Select.Popup, { children: [filter && (jsx(Select.Filter, { placeholder: filterPlaceholder ?? placeholder })), jsx(Select.List, {})] }) }) })] }) }));
+const coreDropdownDeclaration = Object.freeze({
+    mode: 'atomic',
+    fidelity: 'native',
+    render: DropdownImplementation,
+});
+const Dropdown = (props) => {
+    const declaration = unstable_useSlot('dropdown.select', coreDropdownDeclaration);
+    return renderSlot(declaration, props);
 };
 Dropdown.displayName = 'Dropdown';
 

package/dist/esm/Dropdown/Dropdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"Dropdown.js","sources":["../../../Dropdown/Dropdown.tsx"],"sourcesContent":[null],"names":["_jsx","_jsxs"],"mappings":";;;AA4GA;;;;;;;;;;;;;AAaG;AACH;;;;;AAKG;AACH,MAAM,iBAAiB,GAAG,CACtB,OAA8B,EAC9B,KAAwB,KACJ;AACpB,IAAA,MAAM,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC;IAC1B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAK;AAC5D,UAAE;UACA,SAAS;AACnB,CAAC;AAEM,MAAM,QAAQ,GAAG,CAAe,EACnC,KAAK,EACL,OAAO,EACP,WAAW,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EACjD,WAAW,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,EACjD,WAAW,EACX,MAAM,EACN,iBAAiB,EACjB,QAAQ,EACR,SAAS,EACT,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,kBAAkB,EAAE,eAAe,EACnC,QAAQ,EACR,MAAM,EACN,EAAE,EACF,SAAS,EACT,QAAQ,GACO,KAAI;AACnB,IAAA,QAEIA,GAAA,CAAA,MAAA,EAAA,EAAM,MAAM,EAAE,MAAM,EAAA,QAAA,EAChBC,IAAA,CAAC,MAAM,CAAC,IAAI,EAAA,EACR,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,aAAa,EAAE,CAAC,KAA6B,KACzC,QAAQ,GAAG;gBACP,KAAK,EAAE,KAAK,CAAC,KAAU;gBACvB,aAAa,EAAE,KAAK,CAAC,aAAa;aACrC,CAAC,EAEN,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,aAElBA,IAAA,CAAC,MAAM,CAAC,OAAO,EAAA,EACX,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,QAAQ,EAAA,YAAA,EACN,SAAS,qBACJ,cAAc,EAAA,kBAAA,EACb,eAAe,EAAA,QAAA,EAAA,CAEjCD,GAAA,CAAC,MAAM,CAAC,KAAK,EAAA,EAAC,WAAW,EAAE,WAAW,EAAA,CAAI,EAGzC,SAAS,KACNA,GAAA,CAAC,MAAM,CAAC,KAAK,EAAA,EAAA,QAAA,EACTA,GAAA,CAAA,GAAA,EAAA,EAAG,SAAS,EAAC,aAAa,EAAA,CAAG,EAAA,CAClB,CAClB,EACDA,GAAA,CAAC,MAAM,CAAC,SAAS,EAAA,EAAA,QAAA,EACbA,WAAG,SAAS,EAAC,oBAAoB,EAAA,CAAG,EAAA,CACrB,CAAA,EAAA,CACN,EACjBA,GAAA,CAAC,MAAM,CAAC,MAAM,EAAA,EAAA,QAAA,EACVA,GAAA,CAAC,MAAM,CAAC,UAAU,EAAA,EAAA,QAAA,EACdC,IAAA,CAAC,MAAM,CAAC,KAAK,eACR,MAAM,KACHD,GAAA,CAAC,MAAM,CAAC,MAAM,EAAA,EACV,WAAW,EAAE,iBAAiB,IAAI,WAAW,EAAA,CAC/C,CACL,EACDA,GAAA,CAAC,MAAM,CAAC,IAAI,EAAA,EAAA,CAAG,CAAA,EAAA,CACJ,EAAA,CACC,EAAA,CACR,CAAA,EAAA,CACN,EAAA,CACX;AAEf;AAEA,QAAQ,CAAC,WAAW,GAAG,UAAU;;"}
+{"version":3,"file":"Dropdown.js","sources":["../../../Dropdown/Dropdown.tsx"],"sourcesContent":[null],"names":[],"mappings":";;;;AAiIA,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC1C,IAAA,IAAI,EAAE,QAAQ;AACd,IAAA,QAAQ,EAAE,QAAQ;AAClB,IAAA,MAAM,EAAE,sBAAsB;AACjC,CAAA,CAAuD;AAGjD,MAAM,QAAQ,GAAG,CAAe,KAAuB,KAAI;IAC9D,MAAM,WAAW,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;AAChF,IAAA,OAAO,UAAU,CAAC,WAAW,EAAE,KAA+B,CAAC;AACnE;AAEA,QAAQ,CAAC,WAAW,GAAG,UAAU;;"}

package/dist/esm/Dropdown/DropdownImplementation.d.ts

@@ -0,0 +1,7 @@
+import type { JSX } from 'react';
+import type { DropdownProps } from './Dropdown.js';
+/** A renderer-independent single or multiple select with stable Cratis parts. */
+export declare const DropdownImplementation: {
+    <T = unknown>({ value, options, optionLabel, optionValue, placeholder, filter, filterPlaceholder, multiple, showClear, invalid, disabled, className, style, id, inputId, panelClassName, name, tabIndex, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "aria-describedby": ariaDescribedby, ariaLabel: ariaLabelAlias, ariaLabelledBy, ariaDescribedBy, ariaInvalid, onChange, onBlur, pt, }: DropdownProps<T>): JSX.Element;
+    displayName: string;
+};

package/dist/esm/Dropdown/DropdownImplementation.js

@@ -0,0 +1,156 @@
+import { jsx, jsxs } from 'react/jsx-runtime';
+import { useState } from 'react';
+import { Select, Button as Button$1, SelectValue, Popover as Popover$1, ListBox as ListBox$1, ListBoxItem as ListBoxItem$1 } from 'react-aria-components/Select';
+import { ComboBox, ComboBoxValue, Input, Button, Popover, ListBox, ListBoxItem } from 'react-aria-components/ComboBox';
+import { UNSAFE_PortalProvider } from 'react-aria';
+import { unstable_useOverlayEnvironment } from '../renderer/RendererContext.js';
+import 'react-aria-components/I18nProvider';
+import 'ts-deepmerge';
+import 'react-dom';
+import { useCratisComponentsConfig } from '../Common/CratisComponentsContext.js';
+import '../Notifications/toast.js';
+import { asReactAriaButtonProps, asReactAriaListBoxItemProps, asReactAriaListBoxProps } from '../Common/reactAriaProps.js';
+
+const conventionalField = (options, field) => {
+    const first = options?.[0];
+    return first !== null && typeof first === 'object' && field in first
+        ? field
+        : undefined;
+};
+const optionValue = (value) => {
+    if (typeof value === 'function')
+        return String(value);
+    return value;
+};
+const readField = (option, field) => {
+    if (!field || option === null || typeof option !== 'object')
+        return optionValue(option);
+    return field in option
+        ? optionValue(option[field])
+        : optionValue(option);
+};
+const resolveOptions = (options, optionLabel, optionValue) => (options ?? []).map((option, index) => {
+    const value = readField(option, optionValue);
+    const labelValue = readField(option, optionLabel);
+    const keyValue = value ?? index;
+    const disabled = option !== null && typeof option === 'object' && 'disabled' in option
+        ? Boolean(option.disabled)
+        : false;
+    return {
+        key: `${typeof keyValue}:${String(keyValue)}:${index}`,
+        label: String(labelValue ?? value ?? ''),
+        value,
+        disabled,
+    };
+});
+const classNames = (...values) => values.filter(Boolean).join(' ');
+const renderTriggerWithOpenState = (props) => (jsx("button", { ...props, "data-open": props['aria-expanded'] === true || props['aria-expanded'] === 'true'
+        ? true
+        : undefined }));
+const DropdownImplementation = ({ value, options, optionLabel = conventionalField(options, 'label'), optionValue = conventionalField(options, 'value'), placeholder, filter, filterPlaceholder, multiple, showClear, invalid, disabled, className, style, id, inputId, panelClassName, name, tabIndex, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, 'aria-describedby': ariaDescribedby, ariaLabel: ariaLabelAlias, ariaLabelledBy, ariaDescribedBy, ariaInvalid, onChange, onBlur, pt, }) => {
+    const [isOpen, setIsOpen] = useState(false);
+    const overlayEnvironment = unstable_useOverlayEnvironment();
+    const { messages } = useCratisComponentsConfig();
+    const dropdownMessages = messages?.dropdown;
+    const showOptionsLabel = pt?.trigger?.['aria-label'] ??
+        pt?.select?.['aria-label'] ??
+        dropdownMessages?.showOptions ??
+        'Show options';
+    const clearSelectionLabel = pt?.clear?.['aria-label'] ??
+        dropdownMessages?.clearSelection ??
+        'Clear selection';
+    const resolvedOptions = resolveOptions(options, optionLabel, optionValue);
+    const selectedOption = resolvedOptions.find((option) => Object.is(option.value, value));
+    const selectedKey = selectedOption?.key ?? null;
+    const effectiveAriaLabel = ariaLabel ??
+        ariaLabelAlias ??
+        pt?.input?.['aria-label'] ??
+        pt?.select?.['aria-label'];
+    const effectiveAriaLabelledby = ariaLabelledby ??
+        ariaLabelledBy ??
+        pt?.input?.['aria-labelledby'] ??
+        pt?.select?.['aria-labelledby'];
+    const effectiveAriaDescribedby = ariaDescribedby ??
+        ariaDescribedBy ??
+        pt?.input?.['aria-describedby'] ??
+        pt?.select?.['aria-describedby'];
+    const inputAriaInvalid = pt?.input?.['aria-invalid'] ?? pt?.select?.['aria-invalid'];
+    const effectiveInvalid = invalid ??
+        ariaInvalid ??
+        (inputAriaInvalid === true ||
+            inputAriaInvalid === 'true' ||
+            inputAriaInvalid === 'grammar' ||
+            inputAriaInvalid === 'spelling');
+    const rootClassName = classNames('cratis-dropdown', pt?.root?.className, pt?.select?.className, className);
+    const triggerId = id ?? inputId ?? pt?.trigger?.id ?? pt?.input?.id ?? pt?.select?.id;
+    const selectOption = (key) => {
+        const option = resolvedOptions.find((candidate) => candidate.key === String(key));
+        onChange?.((option?.value ?? null), { source: 'user' });
+    };
+    const selectOptions = (keys) => {
+        const selectedKeys = new Set(keys.map(String));
+        const values = resolvedOptions
+            .filter((option) => selectedKeys.has(option.key))
+            .map((option) => option.value);
+        onChange?.(values, { source: 'user' });
+    };
+    const applyTriggerState = (element) => {
+        if (!element)
+            return;
+        if (effectiveInvalid)
+            element.setAttribute('aria-invalid', 'true');
+        else
+            element.removeAttribute('aria-invalid');
+        if (tabIndex !== undefined)
+            element.tabIndex = tabIndex;
+    };
+    if (multiple) {
+        const selectedValues = Array.isArray(value) ? value : [];
+        const selectedKeys = resolvedOptions
+            .filter((option) => selectedValues.some((selected) => Object.is(selected, option.value)))
+            .map((option) => option.key);
+        if (filter) {
+            return (jsx("span", { ...pt?.root, className: rootClassName, "data-cratis-part": 'root', "data-invalid": effectiveInvalid || undefined, "data-disabled": disabled || undefined, "data-open": isOpen || undefined, "data-selected": selectedKeys.length > 0 || undefined, style: { ...pt?.root?.style, ...pt?.select?.style, ...style }, onBlur: onBlur, children: jsx(UNSAFE_PortalProvider, { getContainer: overlayEnvironment.getContainer, children: jsxs(ComboBox, { selectionMode: 'multiple', onOpenChange: setIsOpen, value: selectedKeys, onChange: selectOptions, isDisabled: disabled, isInvalid: effectiveInvalid, name: name, "aria-label": effectiveAriaLabel, "aria-labelledby": effectiveAriaLabelledby, "aria-describedby": effectiveAriaDescribedby, allowsEmptyCollection: true, className: 'cratis-dropdown__combobox', children: [jsx(ComboBoxValue, { ...pt?.value, placeholder: placeholder, className: classNames('cratis-dropdown__value', pt?.value?.className), "data-cratis-part": 'value', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-open": isOpen || undefined, "data-selected": selectedKeys.length > 0 || undefined }), jsx(Input, { ...pt?.filter, id: triggerId, placeholder: filterPlaceholder ?? placeholder, tabIndex: tabIndex, "aria-invalid": effectiveInvalid || undefined, className: classNames('cratis-dropdown__filter', pt?.input?.className, pt?.filter?.className), style: { ...pt?.input?.style, ...pt?.filter?.style }, "data-cratis-part": 'filter', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-open": isOpen || undefined }), jsx(Button, { ...asReactAriaButtonProps(pt?.trigger), className: classNames('cratis-dropdown__indicator', pt?.trigger?.className), "data-cratis-part": 'trigger', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-selected": selectedKeys.length > 0 || undefined, render: renderTriggerWithOpenState, "aria-label": showOptionsLabel, children: jsx("span", { "aria-hidden": 'true', children: "\u2304" }) }), showClear && selectedKeys.length > 0 && (jsx("button", { ...pt?.clear, type: 'button', disabled: disabled, className: classNames('cratis-dropdown__clear', pt?.clear?.className), "data-cratis-part": 'clear', "data-disabled": disabled || undefined, "aria-label": clearSelectionLabel, onClick: (event) => onChange?.([], {
+                                    source: 'user',
+                                    nativeEvent: event.nativeEvent,
+                                }), children: jsx("span", { "aria-hidden": 'true', children: "\u00D7" }) })), jsx(Popover, { ...pt?.popover, className: classNames('cratis-dropdown__popover', pt?.popover?.className, panelClassName), style: {
+                                    zIndex: 'var(--cratis-z-index-overlay)',
+                                    ...pt?.popover?.style,
+                                }, "data-cratis-part": 'popover', "data-open": true, children: jsx(ListBox, { ...asReactAriaListBoxProps(pt?.listbox), items: resolvedOptions, className: classNames('cratis-dropdown__listbox', pt?.listbox?.className), "data-cratis-part": 'listbox', "data-open": true, children: (option) => (jsx(ListBoxItem, { ...asReactAriaListBoxItemProps(pt?.option), id: option.key, textValue: option.label, isDisabled: option.disabled, className: classNames('cratis-dropdown__option', pt?.option?.className), "data-cratis-part": 'option', "data-disabled": option.disabled || undefined, "data-selected": selectedKeys.includes(option.key) ||
+                                            undefined, children: option.label })) }) })] }) }) }));
+        }
+        return (jsxs("span", { ...pt?.root, className: rootClassName, "data-cratis-part": 'root', "data-invalid": effectiveInvalid || undefined, "data-disabled": disabled || undefined, "data-selected": selectedKeys.length > 0 || undefined, style: { ...pt?.root?.style, ...pt?.select?.style, ...style }, onBlur: onBlur, children: [jsx("select", { ...pt?.multiple, id: triggerId ?? pt?.multiple?.id, name: name, multiple: true, disabled: disabled, value: selectedKeys, tabIndex: tabIndex, "aria-label": effectiveAriaLabel, "aria-labelledby": effectiveAriaLabelledby, "aria-describedby": effectiveAriaDescribedby, "aria-invalid": effectiveInvalid || undefined, className: classNames('cratis-dropdown__multiple', pt?.input?.className, pt?.multiple?.className), "data-cratis-part": 'multiple', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-selected": selectedKeys.length > 0 || undefined, onChange: (event) => {
+                        const keys = Array.from(event.currentTarget.selectedOptions, (option) => option.value);
+                        const values = resolvedOptions
+                            .filter((option) => keys.includes(option.key))
+                            .map((option) => option.value);
+                        onChange?.(values, {
+                            source: 'user',
+                            nativeEvent: event.nativeEvent,
+                        });
+                    }, children: resolvedOptions.map((option) => (jsx("option", { value: option.key, disabled: option.disabled, "data-disabled": option.disabled || undefined, "data-selected": selectedKeys.includes(option.key) || undefined, children: option.label }, option.key))) }), showClear && selectedKeys.length > 0 && (jsx("button", { ...pt?.clear, type: 'button', disabled: disabled, className: classNames('cratis-dropdown__clear', pt?.clear?.className), "data-cratis-part": 'clear', "data-disabled": disabled || undefined, "aria-label": clearSelectionLabel, onClick: (event) => onChange?.([], {
+                        source: 'user',
+                        nativeEvent: event.nativeEvent,
+                    }), children: jsx("span", { "aria-hidden": 'true', children: "\u00D7" }) }))] }));
+    }
+    if (filter) {
+        return (jsx("span", { ...pt?.root, className: rootClassName, "data-cratis-part": 'root', "data-invalid": effectiveInvalid || undefined, "data-disabled": disabled || undefined, "data-open": isOpen || undefined, "data-selected": selectedKey !== null || undefined, style: { ...pt?.root?.style, ...pt?.select?.style, ...style }, onBlur: onBlur, children: jsx(UNSAFE_PortalProvider, { getContainer: overlayEnvironment.getContainer, children: jsxs(ComboBox, { onOpenChange: setIsOpen, value: selectedKey, onChange: selectOption, isDisabled: disabled, isInvalid: effectiveInvalid, name: name, "aria-label": effectiveAriaLabel, "aria-labelledby": effectiveAriaLabelledby, "aria-describedby": effectiveAriaDescribedby, allowsEmptyCollection: true, className: 'cratis-dropdown__combobox', children: [jsx(Input, { ...pt?.filter, id: triggerId, placeholder: filterPlaceholder ?? placeholder, tabIndex: tabIndex, "aria-invalid": effectiveInvalid || undefined, className: classNames('cratis-dropdown__filter', pt?.input?.className, pt?.filter?.className), style: { ...pt?.input?.style, ...pt?.filter?.style }, "data-cratis-part": 'filter', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-open": isOpen || undefined }), jsx(Button, { ...asReactAriaButtonProps(pt?.trigger), className: classNames('cratis-dropdown__indicator', pt?.trigger?.className), "data-cratis-part": 'trigger', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-selected": selectedKey !== null || undefined, render: renderTriggerWithOpenState, "aria-label": showOptionsLabel, children: jsx("span", { "aria-hidden": 'true', children: "\u2304" }) }), showClear && selectedKey !== null && (jsx("button", { ...pt?.clear, type: 'button', disabled: disabled, className: classNames('cratis-dropdown__clear', pt?.clear?.className), "data-cratis-part": 'clear', "data-disabled": disabled || undefined, "aria-label": clearSelectionLabel, onClick: (event) => onChange?.(null, {
+                                source: 'user',
+                                nativeEvent: event.nativeEvent,
+                            }), children: jsx("span", { "aria-hidden": 'true', children: "\u00D7" }) })), jsx(Popover, { ...pt?.popover, className: classNames('cratis-dropdown__popover', pt?.popover?.className, panelClassName), style: {
+                                zIndex: 'var(--cratis-z-index-overlay)',
+                                ...pt?.popover?.style,
+                            }, "data-cratis-part": 'popover', "data-open": true, children: jsx(ListBox, { ...asReactAriaListBoxProps(pt?.listbox), items: resolvedOptions, className: classNames('cratis-dropdown__listbox', pt?.listbox?.className), "data-cratis-part": 'listbox', "data-open": true, children: (option) => (jsx(ListBoxItem, { ...asReactAriaListBoxItemProps(pt?.option), id: option.key, textValue: option.label, isDisabled: option.disabled, className: classNames('cratis-dropdown__option', pt?.option?.className), "data-cratis-part": 'option', "data-disabled": option.disabled || undefined, "data-selected": option.key === selectedKey || undefined, children: option.label })) }) })] }) }) }));
+    }
+    return (jsx("span", { ...pt?.root, className: rootClassName, "data-cratis-part": 'root', "data-invalid": effectiveInvalid || undefined, "data-disabled": disabled || undefined, "data-open": isOpen || undefined, "data-selected": selectedKey !== null || undefined, style: { ...pt?.root?.style, ...pt?.select?.style, ...style }, onBlur: onBlur, children: jsx(UNSAFE_PortalProvider, { getContainer: overlayEnvironment.getContainer, children: jsxs(Select, { onOpenChange: setIsOpen, value: selectedKey, onChange: selectOption, isDisabled: disabled, isInvalid: effectiveInvalid, name: name, "aria-label": effectiveAriaLabel, "aria-labelledby": effectiveAriaLabelledby, "aria-describedby": effectiveAriaDescribedby, className: 'cratis-dropdown__select', children: [jsxs(Button$1, { ...asReactAriaButtonProps(pt?.trigger), ref: applyTriggerState, id: triggerId, excludeFromTabOrder: tabIndex === -1, "aria-invalid": effectiveInvalid || undefined, className: classNames('cratis-dropdown__trigger', pt?.input?.className, pt?.trigger?.className), style: { ...pt?.input?.style, ...pt?.trigger?.style }, "data-cratis-part": 'trigger', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-selected": selectedKey !== null || undefined, render: renderTriggerWithOpenState, children: [jsx(SelectValue, { ...pt?.value, className: classNames('cratis-dropdown__value', pt?.value?.className), "data-cratis-part": 'value', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-open": isOpen || undefined, "data-selected": selectedKey !== null || undefined, children: selectedOption?.label ?? placeholder }), jsx("span", { ...pt?.indicator, className: classNames('cratis-dropdown__indicator', pt?.indicator?.className), "data-cratis-part": 'indicator', "data-disabled": disabled || undefined, "data-invalid": effectiveInvalid || undefined, "data-open": isOpen || undefined, "aria-hidden": 'true', children: "\u2304" })] }), showClear && selectedKey !== null && (jsx("button", { ...pt?.clear, type: 'button', disabled: disabled, className: classNames('cratis-dropdown__clear', pt?.clear?.className), "data-cratis-part": 'clear', "data-disabled": disabled || undefined, "aria-label": clearSelectionLabel, onClick: (event) => onChange?.(null, {
+                            source: 'user',
+                            nativeEvent: event.nativeEvent,
+                        }), children: jsx("span", { "aria-hidden": 'true', children: "\u00D7" }) })), jsx(Popover$1, { ...pt?.popover, className: classNames('cratis-dropdown__popover', pt?.popover?.className, panelClassName), style: {
+                            zIndex: 'var(--cratis-z-index-overlay)',
+                            ...pt?.popover?.style,
+                        }, "data-cratis-part": 'popover', "data-open": true, children: jsx(ListBox$1, { ...asReactAriaListBoxProps(pt?.listbox), items: resolvedOptions, className: classNames('cratis-dropdown__listbox', pt?.listbox?.className), "data-cratis-part": 'listbox', "data-open": true, children: (option) => (jsx(ListBoxItem$1, { ...asReactAriaListBoxItemProps(pt?.option), id: option.key, textValue: option.label, isDisabled: option.disabled, className: classNames('cratis-dropdown__option', pt?.option?.className), "data-cratis-part": 'option', "data-disabled": option.disabled || undefined, "data-selected": option.key === selectedKey || undefined, children: option.label })) }) })] }) }) }));
+};
+DropdownImplementation.displayName = 'DropdownImplementation';
+
+export { DropdownImplementation };
+//# sourceMappingURL=DropdownImplementation.js.map

package/dist/esm/Dropdown/DropdownImplementation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropdownImplementation.js","sources":["../../../Dropdown/DropdownImplementation.tsx"],"sourcesContent":[null],"names":["_jsx","_jsxs","ComboBoxButton","ComboBoxPopover","ComboBoxListBox","ComboBoxListBoxItem","AriaSelect","AriaButton","Popover","ListBox","ListBoxItem"],"mappings":"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"}

package/dist/esm/Dropdown/index.d.ts

@@ -1,2 +1 @@
-export * from './Dropdown';
-//# sourceMappingURL=index.d.ts.map
+export * from './Dropdown.js';

package/dist/esm/Dropdown/index.js

@@ -1,5 +1,2 @@
 export { Dropdown } from './Dropdown.js';
-
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
 //# sourceMappingURL=index.js.map

package/dist/esm/Dropdown/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../Dropdown/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;AACA"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/Filter/FilterEditor.d.ts

@@ -1,8 +1,34 @@
 import type { ReactNode } from 'react';
-import type { FilterEditorProps } from './types';
+import type { FilterEditorProps } from './FilterEditorProps.js';
+/**
+ * Props for the {@link FilterEditor} slot descriptor.
+ *
+ * Declares a custom editor for a specific filter group inside
+ * {@link FilterPanel}. The editor receives the current value and an
+ * `onChange` handler through the render prop.
+ */
 export interface FilterEditorSlotProps {
+    /** Must match the `key` of the corresponding `FilterDefinition`. */
     filterKey: string;
+    /** Render prop that receives `{ value, onChange }` and returns the editor UI. */
     children: (props: FilterEditorProps) => ReactNode;
 }
+/**
+ * Declares a custom editor for a specific filter group inside `<FilterPanel>`.
+ *
+ * Place one or more `<FilterEditor>` elements as children of `<FilterPanel>`.
+ * The panel will slot each editor into the filter group whose key matches
+ * the `filterKey` prop.
+ *
+ * ```tsx
+ * <FilterPanel filters={filters} {...stateProps}>
+ *   <FilterEditor filterKey="rating">
+ *     {({ value, onChange }) => <MyRatingPicker value={value} onChange={onChange} />}
+ *   </FilterEditor>
+ * </FilterPanel>
+ * ```
+ *
+ * This component renders nothing itself — it is only used as a slot descriptor
+ * by `FilterPanel`.
+ */
 export declare function FilterEditor(_props: FilterEditorSlotProps): null;
-//# sourceMappingURL=FilterEditor.d.ts.map

package/dist/esm/Filter/FilterEditor.js

@@ -1,23 +1,3 @@
-// Copyright (c) Cratis. All rights reserved.
-// Licensed under the MIT license. See LICENSE file in the project root for full license information.
-/**
- * Declares a custom editor for a specific filter group inside `<FilterPanel>`.
- *
- * Place one or more `<FilterEditor>` elements as children of `<FilterPanel>`.
- * The panel will slot each editor into the filter group whose key matches
- * the `filterKey` prop.
- *
- * ```tsx
- * <FilterPanel filters={filters} {...stateProps}>
- *   <FilterEditor filterKey="rating">
- *     {({ value, onChange }) => <MyRatingPicker value={value} onChange={onChange} />}
- *   </FilterEditor>
- * </FilterPanel>
- * ```
- *
- * This component renders nothing itself — it is only used as a slot descriptor
- * by `FilterPanel`.
- */
 function FilterEditor(_props) {
     return null;
 }

package/dist/esm/Filter/FilterEditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterEditor.js","sources":["../../../Filter/FilterEditor.tsx"],"sourcesContent":[null],"names":[],"mappings":"AAAA;AACA;AAYA;;;;;;;;;;;;;;;;;AAiBG;AACG,SAAU,YAAY,CAAC,MAA6B,EAAA;AACxD,IAAA,OAAO,IAAI;AACb;;"}
+{"version":3,"file":"FilterEditor.js","sources":["../../../Filter/FilterEditor.tsx"],"sourcesContent":[null],"names":[],"mappings":"AAsCM,SAAU,YAAY,CAAC,MAA6B,EAAA;AACtD,IAAA,OAAO,IAAI;AACf;;"}

package/dist/esm/Filter/FilterEditorProps.d.ts

@@ -0,0 +1,8 @@
+import type { ChangeHandler } from '../types/ChangeHandler.js';
+/** Props passed to a custom filter editor render function. */
+export interface FilterEditorProps {
+    /** The current value for this filter, or `undefined` when unset. */
+    value: unknown;
+    /** Called with the custom filter value and optional change-origin metadata. */
+    onChange: ChangeHandler<unknown>;
+}

package/dist/esm/Filter/FilterEditorProps.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=FilterEditorProps.js.map

package/dist/esm/Filter/FilterEditorProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterEditorProps.js","sourceRoot":"","sources":["../../../Filter/FilterEditorProps.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/esm/Filter/FilterPanel.d.ts

@@ -1,25 +1,68 @@
 import type { ReactNode } from 'react';
-import type { FilterDefinition, FilterValues, RangeValues, CustomFilterValues } from './types';
+import type { FilterDefinition, FilterValues, RangeValues, CustomFilterValues } from './types.js';
+/**
+ * Props for {@link FilterPanel}.
+ *
+ * Describes the filter definitions to render, the current state
+ * (selections, ranges, custom values), and the callbacks that fire when
+ * the user changes a filter or expands a filter group.
+ */
 export interface FilterPanelProps {
+    /** Whether the panel is visible. */
     isOpen: boolean;
+    /** Filter definitions, each describing one filter group. */
     filters: FilterDefinition[];
+    /** Current string/option selections, keyed by FilterDefinition.key. */
     filterValues: FilterValues;
+    /** Current numeric range selections, keyed by FilterDefinition.key. */
     rangeValues: RangeValues;
+    /** Current values for filters using a custom `<FilterEditor>` child, keyed by FilterDefinition.key. */
     customValues?: CustomFilterValues;
+    /** Current search text shown in the search box. */
     search?: string;
+    /** Placeholder text for the search input. Defaults to 'Search…'. */
     searchPlaceholder?: string;
+    /** Accessible name for a clear-filter button. Override to localize. Defaults to 'Clear filter'. */
     clearFilterAriaLabel?: string;
+    /** Accessible name for a clear-range button. Override to localize. Defaults to 'Clear range'. */
     clearRangeAriaLabel?: string;
+    /** Which filter group is currently expanded. */
     expandedFilterKey?: string | null;
+    /** The button element the panel anchors below. */
     anchorRef: React.RefObject<HTMLButtonElement | null>;
+    /** Called when the panel should close (e.g. click outside). */
     onClose: () => void;
+    /** Called when the search text changes. If omitted, the search box is hidden. */
     onSearchChange?: (value: string) => void;
+    /** Called when a string option is toggled. */
     onFilterToggle: (filterKey: string, optionKey: string, multi: boolean) => void;
+    /** Called when all selections for a filter are cleared. */
     onFilterClear: (filterKey: string) => void;
+    /** Called when a numeric range changes. */
     onRangeChange: (filterKey: string, range: [number, number] | null) => void;
+    /** Called when the expanded filter group changes. */
     onExpandedFilterChange: (key: string | null) => void;
+    /** Called when a custom-editor value changes. */
     onCustomValueChange?: (filterKey: string, value: unknown) => void;
+    /**
+     * `<FilterEditor>` elements that provide custom UI for specific filter groups.
+     *
+     * ```tsx
+     * <FilterPanel filters={filters} {...stateProps}>
+     *   <FilterEditor filterKey="rating">
+     *     {({ value, onChange }) => <MyPicker value={value} onChange={onChange} />}
+     *   </FilterEditor>
+     * </FilterPanel>
+     * ```
+     */
     children?: ReactNode;
 }
-export declare function FilterPanel({ isOpen, filters, filterValues, rangeValues, customValues, search, searchPlaceholder, clearFilterAriaLabel, clearRangeAriaLabel, expandedFilterKey, anchorRef, onClose, onSearchChange, onFilterToggle, onFilterClear, onRangeChange, onExpandedFilterChange, onCustomValueChange, children, }: FilterPanelProps): import("react").ReactPortal;
-//# sourceMappingURL=FilterPanel.d.ts.map
+/**
+ * A filter dropdown panel anchored below a trigger button. Renders filter
+ * groups, search, numeric range histograms, and custom editors. The panel
+ * appears as a portal at a fixed position on the page and closes when the
+ * user clicks outside.
+ *
+ * See the full documentation comment at line 169 for usage examples.
+ */
+export declare function FilterPanel({ isOpen, filters, filterValues, rangeValues, customValues, search, searchPlaceholder, clearFilterAriaLabel, clearRangeAriaLabel, expandedFilterKey, anchorRef, onClose, onSearchChange, onFilterToggle, onFilterClear, onRangeChange, onExpandedFilterChange, onCustomValueChange, children, }: FilterPanelProps): import("react").ReactPortal | null;