foldkit 0.25.0 → 0.27.0

package/dist/ui/{menu/anchor.js → anchor.js}

@@ -10,7 +10,7 @@ const getOrCreatePortalRoot = () => {
     return document.body.appendChild(root);
 };
 const anchorCleanups = new WeakMap();
-/** Returns insert/destroy hook callbacks that position the menu items container relative to its button using Floating UI. */
+/** Returns insert/destroy hook callbacks that position a floating element relative to its button using Floating UI. When `interceptTab` is true (default), Tab key in portal mode refocuses the button — set to false for components like Popover where Tab should navigate naturally within the panel. */
 export const anchorHooks = (config) => ({
     onInsert: (items) => {
         const button = document.getElementById(config.buttonId);
@@ -22,6 +22,7 @@ export const anchorHooks = (config) => ({
             getOrCreatePortalRoot().appendChild(items);
         }
         const { placement, gap, offset: crossAxis, padding } = config.anchor;
+        const shouldInterceptTab = config.interceptTab ?? true;
         let isFirstUpdate = true;
         const floatingCleanup = autoUpdate(button, items, () => {
             computePosition(button, items, {
@@ -49,7 +50,7 @@ export const anchorHooks = (config) => ({
                 }
             });
         });
-        if (isPortal) {
+        if (isPortal && shouldInterceptTab) {
             const handleTabKey = (event) => {
                 if (event instanceof KeyboardEvent && event.key === 'Tab') {
                     button.focus();

package/dist/ui/combobox/multi.d.ts

@@ -0,0 +1,178 @@
+import { Schema as S } from 'effect';
+import type { Html } from '../../html';
+import { type BaseInitConfig, type BaseViewConfig } from './shared';
+/** Schema for the multi-select combobox component's state, tracking open/closed status, active item, input value, and selected items. */
+export declare const Model: S.extend<S.Struct<{
+    id: typeof S.String;
+    isOpen: typeof S.Boolean;
+    isAnimated: typeof S.Boolean;
+    isModal: typeof S.Boolean;
+    nullable: typeof S.Boolean;
+    immediate: typeof S.Boolean;
+    selectInputOnFocus: typeof S.Boolean;
+    transitionState: S.Literal<["Idle", "EnterStart", "EnterAnimating", "LeaveStart", "LeaveAnimating"]>;
+    maybeActiveItemIndex: S.OptionFromSelf<typeof S.Number>;
+    activationTrigger: S.Literal<["Pointer", "Keyboard"]>;
+    inputValue: typeof S.String;
+    maybeLastPointerPosition: S.OptionFromSelf<S.Struct<{
+        screenX: typeof S.Number;
+        screenY: typeof S.Number;
+    }>>;
+}>, S.Struct<{
+    selectedItems: S.Array$<typeof S.String>;
+}>>;
+export type Model = typeof Model.Type;
+/** Configuration for creating a multi-select combobox model with `init`. `isAnimated` enables CSS transition coordination (default `false`). `isModal` locks page scroll and inerts other elements when open (default `false`). `selectedItems` sets the initial selection (default `[]`). */
+export type InitConfig = BaseInitConfig & Readonly<{
+    selectedItems?: ReadonlyArray<string>;
+}>;
+/** Creates an initial multi-select combobox model from a config. Defaults to closed with no active item, empty input, and no selection. */
+export declare const init: (config: InitConfig) => Model;
+/** Processes a combobox message and returns the next model and commands. Stays open on selection and toggles item membership (multi-select behavior). */
+export declare const update: (model: {
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly nullable: boolean;
+    readonly immediate: boolean;
+    readonly selectInputOnFocus: boolean;
+    readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    readonly maybeActiveItemIndex: import("effect/Option").Option<number>;
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly inputValue: string;
+    readonly maybeLastPointerPosition: import("effect/Option").Option<{
+        readonly screenX: number;
+        readonly screenY: number;
+    }>;
+} & {
+    readonly selectedItems: readonly string[];
+}, message: import("./shared").Message) => [{
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly nullable: boolean;
+    readonly immediate: boolean;
+    readonly selectInputOnFocus: boolean;
+    readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    readonly maybeActiveItemIndex: import("effect/Option").Option<number>;
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly inputValue: string;
+    readonly maybeLastPointerPosition: import("effect/Option").Option<{
+        readonly screenX: number;
+        readonly screenY: number;
+    }>;
+} & {
+    readonly selectedItems: readonly string[];
+}, readonly import("../../command").Command<{
+    readonly _tag: "Opened";
+    readonly maybeActiveItemIndex: import("effect/Option").Option<number>;
+} | {
+    readonly _tag: "Closed";
+} | {
+    readonly _tag: "ClosedByTab";
+} | {
+    readonly _tag: "ActivatedItem";
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly index: number;
+    readonly maybeImmediateSelection: import("effect/Option").Option<{
+        readonly item: string;
+        readonly displayText: string;
+    }>;
+} | {
+    readonly _tag: "DeactivatedItem";
+} | {
+    readonly _tag: "SelectedItem";
+    readonly item: string;
+    readonly displayText: string;
+} | {
+    readonly _tag: "MovedPointerOverItem";
+    readonly screenX: number;
+    readonly screenY: number;
+    readonly index: number;
+} | {
+    readonly _tag: "RequestedItemClick";
+    readonly index: number;
+} | {
+    readonly _tag: "NoOp";
+} | {
+    readonly _tag: "AdvancedTransitionFrame";
+} | {
+    readonly _tag: "EndedTransition";
+} | {
+    readonly _tag: "DetectedInputMovement";
+} | {
+    readonly _tag: "UpdatedInputValue";
+    readonly value: string;
+} | {
+    readonly _tag: "PressedToggleButton";
+}>[]];
+/** Configuration for rendering a multi-select combobox with `view`. */
+export type ViewConfig<Message, Item extends string> = BaseViewConfig<Message, Item, Model>;
+/** Renders a headless multi-select combobox with keyboard navigation, selection tracking, and aria-activedescendant focus management. */
+export declare const view: <Message, Item extends string>(config: Readonly<{
+    model: {
+        readonly id: string;
+        readonly isOpen: boolean;
+        readonly isAnimated: boolean;
+        readonly isModal: boolean;
+        readonly nullable: boolean;
+        readonly immediate: boolean;
+        readonly selectInputOnFocus: boolean;
+        readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+        readonly maybeActiveItemIndex: import("effect/Option").Option<number>;
+        readonly activationTrigger: "Pointer" | "Keyboard";
+        readonly inputValue: string;
+        readonly maybeLastPointerPosition: import("effect/Option").Option<{
+            readonly screenX: number;
+            readonly screenY: number;
+        }>;
+    } & {
+        readonly selectedItems: readonly string[];
+    };
+    toMessage: (message: import("./shared").Opened | import("./shared").Closed | import("./shared").ClosedByTab | import("./shared").ActivatedItem | import("./shared").DeactivatedItem | import("./shared").SelectedItem | import("./shared").MovedPointerOverItem | import("./shared").RequestedItemClick | import("./shared").UpdatedInputValue | import("./shared").PressedToggleButton | import("./shared").NoOp) => Message;
+    items: readonly Item[];
+    itemToConfig: (item: Item, context: Readonly<{
+        isActive: boolean;
+        isDisabled: boolean;
+        isSelected: boolean;
+    }>) => Readonly<{
+        className: string;
+        content: Html;
+    }>;
+    itemToValue: (item: Item, index: number) => string;
+    itemToDisplayText: (item: Item, index: number) => string;
+    isItemDisabled?: (item: Item, index: number) => boolean;
+    inputClassName: string;
+    inputPlaceholder?: string;
+    itemsClassName: string;
+    itemsScrollClassName?: string;
+    backdropClassName: string;
+    className?: string;
+    inputWrapperClassName?: string;
+    buttonContent?: Html;
+    buttonClassName?: string;
+    formName?: string;
+    isDisabled?: boolean;
+    isInvalid?: boolean;
+    openOnFocus?: boolean;
+    itemGroupKey?: (item: Item, index: number) => string;
+    groupToHeading?: (groupKey: string) => Readonly<{
+        content: Html;
+        className: string;
+    }> | undefined;
+    groupClassName?: string;
+    separatorClassName?: string;
+    anchor?: Readonly<{
+        placement?: import("@floating-ui/dom").Placement;
+        gap?: number;
+        offset?: number;
+        padding?: number;
+        portal?: boolean;
+    }>;
+}>) => Html;
+/** Creates a memoized multi-select combobox view. Static config is captured in a closure;
+ *  only `model` and `toMessage` are compared per render via `createLazy`. */
+export declare const lazy: <Message, Item extends string>(staticConfig: Omit<ViewConfig<Message, Item>, "model" | "toMessage">) => ((model: Model, toMessage: BaseViewConfig<Message, Item, Model>["toMessage"]) => Html);
+//# sourceMappingURL=multi.d.ts.map

package/dist/ui/combobox/multi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi.d.ts","sourceRoot":"","sources":["../../../src/ui/combobox/multi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,IAAI,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAGtC,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,cAAc,EAKpB,MAAM,UAAU,CAAA;AAIjB,yIAAyI;AACzI,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;GAEjB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAIrC,8RAA8R;AAC9R,MAAM,MAAM,UAAU,GAAG,cAAc,GACrC,QAAQ,CAAC;IACP,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACtC,CAAC,CAAA;AAEJ,2IAA2I;AAC3I,eAAO,MAAM,IAAI,GAAI,QAAQ,UAAU,KAAG,KAGxC,CAAA;AAcF,yJAAyJ;AACzJ,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwBjB,CAAA;AAIF,uEAAuE;AACvE,MAAM,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,SAAS,MAAM,IAAI,cAAc,CACnE,OAAO,EACP,IAAI,EACJ,KAAK,CACN,CAAA;AAED,yIAAyI;AACzI,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAIf,CAAA;AAEF;6EAC6E;AAC7E,eAAO,MAAM,IAAI,GAAI,OAAO,EAAE,IAAI,SAAS,MAAM,EAC/C,cAAc,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC,KACnE,CAAC,CACF,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,WAAW,CAAC,KACzD,IAAI,CAgBR,CAAA"}

package/dist/ui/combobox/multi.js

@@ -0,0 +1,53 @@
+import { Array, Schema as S } from 'effect';
+import { createLazy } from '../../html/lazy';
+import { evo } from '../../struct';
+import { BaseModel, baseInit, closedBaseModel, makeUpdate, makeView, } from './shared';
+// MODEL
+/** Schema for the multi-select combobox component's state, tracking open/closed status, active item, input value, and selected items. */
+export const Model = BaseModel.pipe(S.extend(S.Struct({ selectedItems: S.Array(S.String) })));
+/** Creates an initial multi-select combobox model from a config. Defaults to closed with no active item, empty input, and no selection. */
+export const init = (config) => ({
+    ...baseInit(config),
+    selectedItems: config.selectedItems ?? [],
+});
+// UPDATE
+const toggleItem = (selectedItems, item) => Array.contains(selectedItems, item)
+    ? Array.filter(selectedItems, selected => selected !== item)
+    : Array.append(selectedItems, item);
+const emptySelection = [];
+/** Processes a combobox message and returns the next model and commands. Stays open on selection and toggles item membership (multi-select behavior). */
+export const update = makeUpdate({
+    handleClose: model => {
+        if (model.nullable && model.inputValue === '') {
+            return evo(closedBaseModel(model), {
+                selectedItems: () => emptySelection,
+                inputValue: () => '',
+            });
+        }
+        return evo(closedBaseModel(model), {
+            inputValue: () => '',
+        });
+    },
+    handleSelectedItem: (model, item) => {
+        const nextSelectedItems = toggleItem(model.selectedItems, item);
+        return [evo(model, { selectedItems: () => nextSelectedItems }), []];
+    },
+    handleImmediateActivation: (model, item) => evo(model, {
+        selectedItems: () => toggleItem(model.selectedItems, item),
+    }),
+});
+/** Renders a headless multi-select combobox with keyboard navigation, selection tracking, and aria-activedescendant focus management. */
+export const view = makeView({
+    isItemSelected: (model, itemValue) => Array.contains(model.selectedItems, itemValue),
+    ariaMultiSelectable: true,
+});
+/** Creates a memoized multi-select combobox view. Static config is captured in a closure;
+ *  only `model` and `toMessage` are compared per render via `createLazy`. */
+export const lazy = (staticConfig) => {
+    const lazyView = createLazy();
+    return (model, toMessage) => lazyView((currentModel, currentToMessage) => view({
+        ...staticConfig,
+        model: currentModel,
+        toMessage: currentToMessage,
+    }), [model, toMessage]);
+};

package/dist/ui/combobox/multiPublic.d.ts

@@ -0,0 +1,3 @@
+export { init, update, view, lazy, Model } from './multi';
+export type { InitConfig, ViewConfig } from './multi';
+//# sourceMappingURL=multiPublic.d.ts.map

package/dist/ui/combobox/multiPublic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiPublic.d.ts","sourceRoot":"","sources":["../../../src/ui/combobox/multiPublic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA"}

package/dist/ui/combobox/multiPublic.js

@@ -0,0 +1 @@
+export { init, update, view, lazy, Model } from './multi';

package/dist/ui/combobox/public.d.ts

@@ -0,0 +1,8 @@
+export { init, update, view, lazy, Model } from './single';
+export { Message } from './shared';
+export { TransitionState } from '../transition';
+export type { ActivationTrigger, Opened, Closed, ClosedByTab, ActivatedItem, DeactivatedItem, SelectedItem, MovedPointerOverItem, RequestedItemClick, UpdatedInputValue, PressedToggleButton, NoOp, AdvancedTransitionFrame, EndedTransition, DetectedInputMovement, ItemConfig, GroupHeading, } from './shared';
+export type { InitConfig, ViewConfig } from './single';
+export type { AnchorConfig } from '../anchor';
+export * as Multi from './multiPublic';
+//# sourceMappingURL=public.d.ts.map

package/dist/ui/combobox/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/ui/combobox/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAE1D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAElC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,YAAY,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,IAAI,EACJ,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,YAAY,GACb,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAEtD,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,OAAO,KAAK,KAAK,MAAM,eAAe,CAAA"}

package/dist/ui/combobox/public.js

@@ -0,0 +1,4 @@
+export { init, update, view, lazy, Model } from './single';
+export { Message } from './shared';
+export { TransitionState } from '../transition';
+export * as Multi from './multiPublic';

package/dist/ui/combobox/shared.d.ts

@@ -0,0 +1,236 @@
+import { Option, Schema as S } from 'effect';
+import type { Command } from '../../command';
+import { type Html } from '../../html';
+import type { AnchorConfig } from '../anchor';
+import { groupContiguous } from '../group';
+export { groupContiguous };
+/** Schema for the activation trigger — whether the user interacted via mouse or keyboard. */
+export declare const ActivationTrigger: S.Literal<["Pointer", "Keyboard"]>;
+export type ActivationTrigger = typeof ActivationTrigger.Type;
+/** Schema fields shared by all combobox variants (single-select and multi-select). Spread into each variant's `S.Struct` to avoid duplicating field definitions. */
+export declare const BaseModel: S.Struct<{
+    id: typeof S.String;
+    isOpen: typeof S.Boolean;
+    isAnimated: typeof S.Boolean;
+    isModal: typeof S.Boolean;
+    nullable: typeof S.Boolean;
+    immediate: typeof S.Boolean;
+    selectInputOnFocus: typeof S.Boolean;
+    transitionState: S.Literal<["Idle", "EnterStart", "EnterAnimating", "LeaveStart", "LeaveAnimating"]>;
+    maybeActiveItemIndex: S.OptionFromSelf<typeof S.Number>;
+    activationTrigger: S.Literal<["Pointer", "Keyboard"]>;
+    inputValue: typeof S.String;
+    maybeLastPointerPosition: S.OptionFromSelf<S.Struct<{
+        screenX: typeof S.Number;
+        screenY: typeof S.Number;
+    }>>;
+}>;
+export type BaseModel = typeof BaseModel.Type;
+/** Configuration fields shared by all combobox variant `init` functions. */
+export type BaseInitConfig = Readonly<{
+    id: string;
+    isAnimated?: boolean;
+    isModal?: boolean;
+    nullable?: boolean;
+    immediate?: boolean;
+    selectInputOnFocus?: boolean;
+}>;
+/** Creates the shared base fields for a combobox model from a config. Each variant spreads this and adds its selection fields. */
+export declare const baseInit: (config: BaseInitConfig) => BaseModel;
+/** Sent when the combobox popup opens. Contains an optional initial active item index. */
+export declare const Opened: import("../../schema").CallableTaggedStruct<"Opened", {
+    maybeActiveItemIndex: S.OptionFromSelf<typeof S.Number>;
+}>;
+/** Sent when the combobox closes via Escape key or backdrop click. */
+export declare const Closed: import("../../schema").CallableTaggedStruct<"Closed", {}>;
+/** Sent when focus leaves the input via Tab key or blur. */
+export declare const ClosedByTab: import("../../schema").CallableTaggedStruct<"ClosedByTab", {}>;
+/** Sent when an item is highlighted via arrow keys or mouse hover. Includes activation trigger and optional immediate selection info. */
+export declare const ActivatedItem: import("../../schema").CallableTaggedStruct<"ActivatedItem", {
+    index: typeof S.Number;
+    activationTrigger: S.Literal<["Pointer", "Keyboard"]>;
+    maybeImmediateSelection: S.OptionFromSelf<S.Struct<{
+        item: typeof S.String;
+        displayText: typeof S.String;
+    }>>;
+}>;
+/** Sent when the mouse leaves an enabled item. */
+export declare const DeactivatedItem: import("../../schema").CallableTaggedStruct<"DeactivatedItem", {}>;
+/** Sent when an item is selected via Enter or click. Includes display text for restoring input value on close. */
+export declare const SelectedItem: import("../../schema").CallableTaggedStruct<"SelectedItem", {
+    item: typeof S.String;
+    displayText: typeof S.String;
+}>;
+/** Sent when the pointer moves over a combobox item. */
+export declare const MovedPointerOverItem: import("../../schema").CallableTaggedStruct<"MovedPointerOverItem", {
+    index: typeof S.Number;
+    screenX: typeof S.Number;
+    screenY: typeof S.Number;
+}>;
+/** Sent when Enter or Space is pressed on the active item, triggering a programmatic click. */
+export declare const RequestedItemClick: import("../../schema").CallableTaggedStruct<"RequestedItemClick", {
+    index: typeof S.Number;
+}>;
+/** Placeholder message used when no action is needed. */
+export declare const NoOp: import("../../schema").CallableTaggedStruct<"NoOp", {}>;
+/** Sent internally when a double-rAF completes, advancing the transition to its animating phase. */
+export declare const AdvancedTransitionFrame: import("../../schema").CallableTaggedStruct<"AdvancedTransitionFrame", {}>;
+/** Sent internally when all CSS transitions on the items container have completed. */
+export declare const EndedTransition: import("../../schema").CallableTaggedStruct<"EndedTransition", {}>;
+/** Sent internally when the input wrapper moves in the viewport during a leave transition, cancelling the animation. */
+export declare const DetectedInputMovement: import("../../schema").CallableTaggedStruct<"DetectedInputMovement", {}>;
+/** Sent when the user types in the input. */
+export declare const UpdatedInputValue: import("../../schema").CallableTaggedStruct<"UpdatedInputValue", {
+    value: typeof S.String;
+}>;
+/** Sent when the optional toggle button is clicked. */
+export declare const PressedToggleButton: import("../../schema").CallableTaggedStruct<"PressedToggleButton", {}>;
+/** Union of all messages the combobox component can produce. */
+export declare const Message: S.Union<[import("../../schema").CallableTaggedStruct<"Opened", {
+    maybeActiveItemIndex: S.OptionFromSelf<typeof S.Number>;
+}>, import("../../schema").CallableTaggedStruct<"Closed", {}>, import("../../schema").CallableTaggedStruct<"ClosedByTab", {}>, import("../../schema").CallableTaggedStruct<"ActivatedItem", {
+    index: typeof S.Number;
+    activationTrigger: S.Literal<["Pointer", "Keyboard"]>;
+    maybeImmediateSelection: S.OptionFromSelf<S.Struct<{
+        item: typeof S.String;
+        displayText: typeof S.String;
+    }>>;
+}>, import("../../schema").CallableTaggedStruct<"DeactivatedItem", {}>, import("../../schema").CallableTaggedStruct<"SelectedItem", {
+    item: typeof S.String;
+    displayText: typeof S.String;
+}>, import("../../schema").CallableTaggedStruct<"MovedPointerOverItem", {
+    index: typeof S.Number;
+    screenX: typeof S.Number;
+    screenY: typeof S.Number;
+}>, import("../../schema").CallableTaggedStruct<"RequestedItemClick", {
+    index: typeof S.Number;
+}>, import("../../schema").CallableTaggedStruct<"NoOp", {}>, import("../../schema").CallableTaggedStruct<"AdvancedTransitionFrame", {}>, import("../../schema").CallableTaggedStruct<"EndedTransition", {}>, import("../../schema").CallableTaggedStruct<"DetectedInputMovement", {}>, import("../../schema").CallableTaggedStruct<"UpdatedInputValue", {
+    value: typeof S.String;
+}>, import("../../schema").CallableTaggedStruct<"PressedToggleButton", {}>]>;
+export type Opened = typeof Opened.Type;
+export type Closed = typeof Closed.Type;
+export type ClosedByTab = typeof ClosedByTab.Type;
+export type ActivatedItem = typeof ActivatedItem.Type;
+export type DeactivatedItem = typeof DeactivatedItem.Type;
+export type SelectedItem = typeof SelectedItem.Type;
+export type MovedPointerOverItem = typeof MovedPointerOverItem.Type;
+export type RequestedItemClick = typeof RequestedItemClick.Type;
+export type NoOp = typeof NoOp.Type;
+export type AdvancedTransitionFrame = typeof AdvancedTransitionFrame.Type;
+export type EndedTransition = typeof EndedTransition.Type;
+export type DetectedInputMovement = typeof DetectedInputMovement.Type;
+export type UpdatedInputValue = typeof UpdatedInputValue.Type;
+export type PressedToggleButton = typeof PressedToggleButton.Type;
+export type Message = typeof Message.Type;
+export declare const inputSelector: (id: string) => string;
+export declare const inputWrapperSelector: (id: string) => string;
+export declare const itemsSelector: (id: string) => string;
+export declare const itemSelector: (id: string, index: number) => string;
+export declare const itemId: (id: string, index: number) => string;
+/** Resets only shared base fields to their closed state. Does not touch inputValue or selection — those are variant-specific. */
+export declare const closedBaseModel: <Model extends BaseModel>(model: Model) => Model;
+/** Context passed to the `handleSelectedItem` handler with commands for focus management and modal cleanup. */
+export type SelectedItemContext = Readonly<{
+    focusInput: Command<Message>;
+    maybeNextFrame: Option.Option<Command<Message>>;
+    maybeUnlockScroll: Option.Option<Command<Message>>;
+    maybeRestoreInert: Option.Option<Command<Message>>;
+}>;
+/** Creates a combobox update function from variant-specific handlers. Shared logic (open, close, activate, transition) is handled internally; only close, selection, and immediate-activation behavior varies by variant. */
+export declare const makeUpdate: <Model extends BaseModel>(handlers: Readonly<{
+    handleClose: (model: Model) => Model;
+    handleSelectedItem: (model: Model, item: string, displayText: string, context: SelectedItemContext) => [Model, ReadonlyArray<Command<Message>>];
+    handleImmediateActivation: (model: Model, item: string, displayText: string) => Model;
+}>) => (model: Model, message: Message) => [Model, readonly Command<{
+    readonly _tag: "Opened";
+    readonly maybeActiveItemIndex: Option.Option<number>;
+} | {
+    readonly _tag: "Closed";
+} | {
+    readonly _tag: "ClosedByTab";
+} | {
+    readonly _tag: "ActivatedItem";
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly index: number;
+    readonly maybeImmediateSelection: Option.Option<{
+        readonly item: string;
+        readonly displayText: string;
+    }>;
+} | {
+    readonly _tag: "DeactivatedItem";
+} | {
+    readonly _tag: "SelectedItem";
+    readonly item: string;
+    readonly displayText: string;
+} | {
+    readonly _tag: "MovedPointerOverItem";
+    readonly screenX: number;
+    readonly screenY: number;
+    readonly index: number;
+} | {
+    readonly _tag: "RequestedItemClick";
+    readonly index: number;
+} | {
+    readonly _tag: "NoOp";
+} | {
+    readonly _tag: "AdvancedTransitionFrame";
+} | {
+    readonly _tag: "EndedTransition";
+} | {
+    readonly _tag: "DetectedInputMovement";
+} | {
+    readonly _tag: "UpdatedInputValue";
+    readonly value: string;
+} | {
+    readonly _tag: "PressedToggleButton";
+}>[]];
+/** Configuration for an individual combobox item's appearance. */
+export type ItemConfig = Readonly<{
+    className: string;
+    content: Html;
+}>;
+/** Configuration for a group heading rendered above a group of items. */
+export type GroupHeading = Readonly<{
+    content: Html;
+    className: string;
+}>;
+/** Configuration for rendering a combobox with `view`. */
+export type BaseViewConfig<Message, Item extends string, Model extends BaseModel> = Readonly<{
+    model: Model;
+    toMessage: (message: Opened | Closed | ClosedByTab | ActivatedItem | DeactivatedItem | SelectedItem | MovedPointerOverItem | RequestedItemClick | UpdatedInputValue | PressedToggleButton | NoOp) => Message;
+    items: ReadonlyArray<Item>;
+    itemToConfig: (item: Item, context: Readonly<{
+        isActive: boolean;
+        isDisabled: boolean;
+        isSelected: boolean;
+    }>) => ItemConfig;
+    itemToValue: (item: Item, index: number) => string;
+    itemToDisplayText: (item: Item, index: number) => string;
+    isItemDisabled?: (item: Item, index: number) => boolean;
+    inputClassName: string;
+    inputPlaceholder?: string;
+    itemsClassName: string;
+    itemsScrollClassName?: string;
+    backdropClassName: string;
+    className?: string;
+    inputWrapperClassName?: string;
+    buttonContent?: Html;
+    buttonClassName?: string;
+    formName?: string;
+    isDisabled?: boolean;
+    isInvalid?: boolean;
+    openOnFocus?: boolean;
+    itemGroupKey?: (item: Item, index: number) => string;
+    groupToHeading?: (groupKey: string) => GroupHeading | undefined;
+    groupClassName?: string;
+    separatorClassName?: string;
+    anchor?: AnchorConfig;
+}>;
+/** Variant-specific view behavior injected into the shared combobox view factory. */
+export type ViewBehavior<Model extends BaseModel> = Readonly<{
+    isItemSelected: (model: Model, itemValue: string) => boolean;
+    ariaMultiSelectable: boolean;
+}>;
+/** Creates a combobox view function from variant-specific behavior. Shared rendering logic (input, items, transitions, keyboard navigation) is handled internally; only selection display varies by variant. */
+export declare const makeView: <Model extends BaseModel>(behavior: ViewBehavior<Model>) => <Message, Item extends string>(config: BaseViewConfig<Message, Item, Model>) => Html;
+//# sourceMappingURL=shared.d.ts.map

package/dist/ui/combobox/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/ui/combobox/shared.ts"],"names":[],"mappings":"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"}