@foldkit/ui 0.112.0

package/dist/calendar/public.d.ts

@@ -0,0 +1,3 @@
+export { init, update, view, selectDate, reflectSelectedDate, reflectMinDate, reflectMaxDate, reflectDisabledDates, reflectDisabledDaysOfWeek, dropToDays, Model, ViewMode, Message, OutMessage, ChangedViewMonth, SelectedDate, ClickedDay, PressedKeyOnGrid, ClickedPreviousMonthButton, ClickedNextMonthButton, ClickedHeading, SelectedMonth, SelectedYear, PagedYears, FocusedGrid, BlurredGrid, RefreshedToday, CompletedFocusGrid, FocusGrid, } from './index.js';
+export type { InitConfig, ViewInputs, CalendarAttributes, DaysModeAttributes, MonthsModeAttributes, YearsModeAttributes, DayCell, ColumnHeader, Week, MonthCell, YearCell, } from './index.js';
+//# sourceMappingURL=public.d.ts.map

package/dist/calendar/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/calendar/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,IAAI,EACJ,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,yBAAyB,EACzB,UAAU,EACV,KAAK,EACL,QAAQ,EACR,OAAO,EACP,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,OAAO,EACP,YAAY,EACZ,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAA"}

package/dist/calendar/public.js

@@ -0,0 +1 @@
+export { init, update, view, selectDate, reflectSelectedDate, reflectMinDate, reflectMaxDate, reflectDisabledDates, reflectDisabledDaysOfWeek, dropToDays, Model, ViewMode, Message, OutMessage, ChangedViewMonth, SelectedDate, ClickedDay, PressedKeyOnGrid, ClickedPreviousMonthButton, ClickedNextMonthButton, ClickedHeading, SelectedMonth, SelectedYear, PagedYears, FocusedGrid, BlurredGrid, RefreshedToday, CompletedFocusGrid, FocusGrid, } from './index.js';

package/dist/checkbox/index.d.ts

@@ -0,0 +1,119 @@
+import { Option, Schema as S } from 'effect';
+import type { Command } from 'foldkit/command';
+import { type ChildAttribute, type Html } from 'foldkit/html';
+import { type Reflect } from 'foldkit/submodel';
+/** Schema for the checkbox component's state, tracking the checked status. */
+export declare const Model: S.Struct<{
+    readonly id: S.String;
+    readonly isChecked: S.Boolean;
+}>;
+export type Model = typeof Model.Type;
+/** Sent when the user toggles the checkbox via click or Space key. */
+export declare const Toggled: import("foldkit/schema").CallableTaggedStruct<"Toggled", {}>;
+/** Sent to set the checked state to a specific value. Use this for
+ *  programmatic state assignment (e.g. a "select all" handler that forces
+ *  all child checkboxes to the same state) where `Toggled`'s flip semantics
+ *  would not reliably reach the desired state. */
+export declare const SetChecked: import("foldkit/schema").CallableTaggedStruct<"SetChecked", {
+    isChecked: S.Boolean;
+}>;
+/** Schema for all messages the checkbox component can produce. */
+export declare const Message: S.Union<readonly [import("foldkit/schema").CallableTaggedStruct<"Toggled", {}>, import("foldkit/schema").CallableTaggedStruct<"SetChecked", {
+    isChecked: S.Boolean;
+}>]>;
+export type Toggled = typeof Toggled.Type;
+export type SetChecked = typeof SetChecked.Type;
+export type Message = typeof Message.Type;
+/** Sent to the parent each time the checkbox toggles. Carries the new
+ *  checked state. Consumers pattern-match this in their `GotCheckboxMessage`
+ *  handler to lift the toggle into a domain Message (e.g., persisting the
+ *  flag, dispatching a save command). */
+export declare const ToggledChecked: import("foldkit/schema").CallableTaggedStruct<"ToggledChecked", {
+    isChecked: S.Boolean;
+}>;
+/** Union of out-messages the checkbox component can produce. Surfaced as
+ *  the third element of `update`'s return tuple and pattern-matched by
+ *  the parent. */
+export declare const OutMessage: S.Union<readonly [import("foldkit/schema").CallableTaggedStruct<"ToggledChecked", {
+    isChecked: S.Boolean;
+}>]>;
+export type ToggledChecked = typeof ToggledChecked.Type;
+export type OutMessage = typeof OutMessage.Type;
+/** Configuration for creating a checkbox model with `init`. */
+export type InitConfig = Readonly<{
+    id: string;
+    isChecked?: boolean;
+}>;
+/** Creates an initial checkbox model from a config. Defaults to unchecked. */
+export declare const init: (config: InitConfig) => Model;
+/** Processes a checkbox message and returns the next model, commands,
+ *  and a `ToggledChecked` OutMessage carrying the new checked state. */
+export declare const update: (model: Model, message: Message) => readonly [Model, ReadonlyArray<Command<Message>>, Option.Option<OutMessage>];
+/** Programmatically sets the checked state. Emits a `ToggledChecked`
+ *  OutMessage just like a user-initiated toggle. Use this in domain-event
+ *  handlers where you need to force a specific state (e.g. "select all"). */
+export declare const setChecked: (model: Model, isChecked: boolean) => readonly [Model, ReadonlyArray<Command<Message>>, Option.Option<OutMessage>];
+/** Reflects an externally-sourced checked state onto the model without
+ *  emitting an OutMessage. Use this to mirror external truth (saved
+ *  settings, a server value) onto the checkbox without triggering the
+ *  downstream reaction a user toggle would cause. Contrast with
+ *  `setChecked`, which emits `ToggledChecked` so the parent reacts to a
+ *  programmatic assignment the same way it reacts to a user toggle. Returns
+ *  the model directly because it produces no commands and no OutMessage. */
+export declare const reflectChecked: Reflect<Model, boolean>;
+/** Attribute groups the checkbox component provides to the consumer's
+ *  `toView` callback. Each group is a `ReadonlyArray<ChildAttribute>`:
+ *  attributes published from inside Checkbox's own boundary that the
+ *  consumer can spread directly into its own element attribute arrays:
+ *
+ *  ```ts
+ *  toView: attributes =>
+ *    h.div(
+ *      [...attributes.checkbox, h.Class('my-class'), h.OnClick(MyOwnMsg())],
+ *      [...],
+ *    )
+ *  ```
+ *
+ *  Checkbox's own `OnClick(Toggled())` handlers (carried inside
+ *  `attributes.checkbox` etc.) dispatch `Toggled` through Checkbox's
+ *  boundary wrap at event-fire time. The consumer's own
+ *  `OnClick(MyOwnMsg())` lives in the parent's boundary and dispatches
+ *  unwrapped. The two routes are tracked separately by the runtime; the
+ *  consumer never has to think about which boundary an attribute belongs
+ *  to. */
+export type CheckboxAttributes = Readonly<{
+    checkbox: ReadonlyArray<ChildAttribute>;
+    label: ReadonlyArray<ChildAttribute>;
+    description: ReadonlyArray<ChildAttribute>;
+    hiddenInput: ReadonlyArray<ChildAttribute>;
+}>;
+/** Per-render view inputs passed to `view` via `h.submodel`'s `viewInputs` field.
+ *  Slot content (`toView`) and behavioral flags live here; the parent
+ *  declares them at the embed site rather than threading them through the
+ *  Submodel as a generic-parameterized callback. */
+export type ViewInputs = Readonly<{
+    toView: (attributes: CheckboxAttributes) => Html;
+    isDisabled?: boolean;
+    isIndeterminate?: boolean;
+    name?: string;
+    value?: string;
+}>;
+/** Renders an accessible checkbox by building ARIA attribute groups and
+ *  delegating layout to the consumer's `toView` callback. Embedded via
+ *  `h.submodel`. */
+export declare const view: import("foldkit/submodel").View<{
+    readonly id: string;
+    readonly isChecked: boolean;
+}, {
+    readonly _tag: "Toggled";
+} | {
+    readonly _tag: "SetChecked";
+    readonly isChecked: boolean;
+}, Readonly<{
+    toView: (attributes: CheckboxAttributes) => Html;
+    isDisabled?: boolean;
+    isIndeterminate?: boolean;
+    name?: string;
+    value?: string;
+}>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/checkbox/index.d.ts.map

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

package/dist/checkbox/index.js

@@ -0,0 +1,111 @@
+import { Function, Match as M, Option, Schema as S } from 'effect';
+import { childAttributes, html, } from 'foldkit/html';
+import { m } from 'foldkit/message';
+import { evo } from 'foldkit/struct';
+import { defineView } from 'foldkit/submodel';
+// MODEL
+/** Schema for the checkbox component's state, tracking the checked status. */
+export const Model = S.Struct({
+    id: S.String,
+    isChecked: S.Boolean,
+});
+// MESSAGE
+/** Sent when the user toggles the checkbox via click or Space key. */
+export const Toggled = m('Toggled');
+/** Sent to set the checked state to a specific value. Use this for
+ *  programmatic state assignment (e.g. a "select all" handler that forces
+ *  all child checkboxes to the same state) where `Toggled`'s flip semantics
+ *  would not reliably reach the desired state. */
+export const SetChecked = m('SetChecked', { isChecked: S.Boolean });
+/** Schema for all messages the checkbox component can produce. */
+export const Message = S.Union([Toggled, SetChecked]);
+// OUT MESSAGE
+/** Sent to the parent each time the checkbox toggles. Carries the new
+ *  checked state. Consumers pattern-match this in their `GotCheckboxMessage`
+ *  handler to lift the toggle into a domain Message (e.g., persisting the
+ *  flag, dispatching a save command). */
+export const ToggledChecked = m('ToggledChecked', { isChecked: S.Boolean });
+/** Union of out-messages the checkbox component can produce. Surfaced as
+ *  the third element of `update`'s return tuple and pattern-matched by
+ *  the parent. */
+export const OutMessage = S.Union([ToggledChecked]);
+/** Creates an initial checkbox model from a config. Defaults to unchecked. */
+export const init = (config) => ({
+    id: config.id,
+    isChecked: config.isChecked ?? false,
+});
+// UPDATE
+/** Processes a checkbox message and returns the next model, commands,
+ *  and a `ToggledChecked` OutMessage carrying the new checked state. */
+export const update = (model, message) => M.value(message).pipe(M.withReturnType(), M.tagsExhaustive({
+    Toggled: () => {
+        const nextIsChecked = !model.isChecked;
+        return [
+            evo(model, { isChecked: () => nextIsChecked }),
+            [],
+            Option.some(ToggledChecked({ isChecked: nextIsChecked })),
+        ];
+    },
+    SetChecked: ({ isChecked }) => [
+        evo(model, { isChecked: () => isChecked }),
+        [],
+        Option.some(ToggledChecked({ isChecked })),
+    ],
+}));
+/** Programmatically sets the checked state. Emits a `ToggledChecked`
+ *  OutMessage just like a user-initiated toggle. Use this in domain-event
+ *  handlers where you need to force a specific state (e.g. "select all"). */
+export const setChecked = (model, isChecked) => update(model, SetChecked({ isChecked }));
+/** Reflects an externally-sourced checked state onto the model without
+ *  emitting an OutMessage. Use this to mirror external truth (saved
+ *  settings, a server value) onto the checkbox without triggering the
+ *  downstream reaction a user toggle would cause. Contrast with
+ *  `setChecked`, which emits `ToggledChecked` so the parent reacts to a
+ *  programmatic assignment the same way it reacts to a user toggle. Returns
+ *  the model directly because it produces no commands and no OutMessage. */
+export const reflectChecked = Function.dual(2, (model, isChecked) => evo(model, { isChecked: () => isChecked }));
+const labelId = (id) => `${id}-label`;
+const descriptionId = (id) => `${id}-description`;
+/** Renders an accessible checkbox by building ARIA attribute groups and
+ *  delegating layout to the consumer's `toView` callback. Embedded via
+ *  `h.submodel`. */
+export const view = defineView((model, viewInputs) => {
+    const h = html();
+    const { id, isChecked } = model;
+    const { isDisabled = false, isIndeterminate = false, name, value: formValue = 'on', } = viewInputs;
+    const handleKeyUp = (key) => M.value(key).pipe(M.when(' ', () => Option.some(Toggled())), M.orElse(() => Option.none()));
+    const stateAttributes = isIndeterminate
+        ? [h.DataAttribute('indeterminate', '')]
+        : isChecked
+            ? [h.DataAttribute('checked', '')]
+            : [];
+    const disabledAttributes = isDisabled
+        ? [h.AriaDisabled(true), h.DataAttribute('disabled', '')]
+        : [];
+    const checkboxAttributes = [
+        h.Role('checkbox'),
+        h.AriaChecked(isIndeterminate ? 'mixed' : isChecked),
+        h.AriaLabelledBy(labelId(id)),
+        h.AriaDescribedBy(descriptionId(id)),
+        h.Tabindex(0),
+        ...stateAttributes,
+        ...disabledAttributes,
+        ...(isDisabled
+            ? []
+            : [h.OnClick(Toggled()), h.OnKeyUpPreventDefault(handleKeyUp)]),
+    ];
+    const labelAttributes = [
+        h.Id(labelId(id)),
+        ...(isDisabled ? [] : [h.OnClick(Toggled())]),
+    ];
+    const descriptionAttributes = [h.Id(descriptionId(id))];
+    const hiddenInputAttributes = name
+        ? [h.Type('hidden'), h.Name(name), h.Value(isChecked ? formValue : '')]
+        : [];
+    return viewInputs.toView({
+        checkbox: childAttributes(checkboxAttributes),
+        label: childAttributes(labelAttributes),
+        description: childAttributes(descriptionAttributes),
+        hiddenInput: childAttributes(hiddenInputAttributes),
+    });
+});

package/dist/checkbox/public.d.ts

@@ -0,0 +1,3 @@
+export { init, update, setChecked, reflectChecked, view, Model, Message, OutMessage, SetChecked, ToggledChecked, } from './index.js';
+export type { Toggled, InitConfig, ViewInputs, CheckboxAttributes, } from './index.js';
+//# sourceMappingURL=public.d.ts.map

package/dist/checkbox/public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/checkbox/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,MAAM,EACN,UAAU,EACV,cAAc,EACd,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,OAAO,EACP,UAAU,EACV,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAA"}

package/dist/checkbox/public.js

@@ -0,0 +1 @@
+export { init, update, setChecked, reflectChecked, view, Model, Message, OutMessage, SetChecked, ToggledChecked, } from './index.js';

package/dist/combobox/multi.d.ts

@@ -0,0 +1,183 @@
+import { Option, Schema as S } from 'effect';
+import type * as Command from 'foldkit/command';
+import type { Reflect, View as SubmodelView } from 'foldkit/submodel';
+import { type BaseInitConfig, type BaseViewInputs, type Message, type OutMessage } from './shared.js';
+/** 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.Struct<{
+    readonly selectedItems: S.$Array<S.String>;
+    readonly id: S.String;
+    readonly isOpen: S.Boolean;
+    readonly isAnimated: S.Boolean;
+    readonly isModal: S.Boolean;
+    readonly nullable: S.Boolean;
+    readonly immediate: S.Boolean;
+    readonly selectInputOnFocus: S.Boolean;
+    readonly animation: S.Struct<{
+        readonly id: S.String;
+        readonly isShowing: S.Boolean;
+        readonly transitionState: S.Literals<readonly ["Idle", "EnterStart", "EnterAnimating", "LeaveStart", "LeaveAnimating"]>;
+    }>;
+    readonly maybeActiveItemIndex: S.Option<S.Number>;
+    readonly activationTrigger: S.Literals<readonly ["Pointer", "Keyboard"]>;
+    readonly inputValue: S.String;
+    readonly maybeLastPointerPosition: S.Option<S.Struct<{
+        readonly screenX: S.Number;
+        readonly screenY: S.Number;
+    }>>;
+}>;
+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 selectedItems: readonly string[];
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly nullable: boolean;
+    readonly immediate: boolean;
+    readonly selectInputOnFocus: boolean;
+    readonly animation: {
+        readonly id: string;
+        readonly isShowing: boolean;
+        readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    };
+    readonly maybeActiveItemIndex: Option.Option<number>;
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly inputValue: string;
+    readonly maybeLastPointerPosition: Option.Option<{
+        readonly screenX: number;
+        readonly screenY: number;
+    }>;
+}, message: Message) => readonly [{
+    readonly selectedItems: readonly string[];
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly nullable: boolean;
+    readonly immediate: boolean;
+    readonly selectInputOnFocus: boolean;
+    readonly animation: {
+        readonly id: string;
+        readonly isShowing: boolean;
+        readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    };
+    readonly maybeActiveItemIndex: Option.Option<number>;
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly inputValue: string;
+    readonly maybeLastPointerPosition: Option.Option<{
+        readonly screenX: number;
+        readonly screenY: number;
+    }>;
+}, readonly Readonly<{
+    name: string;
+    args?: Record<string, unknown>;
+    effect: import("effect/Effect").Effect<{
+        readonly _tag: "CompletedLockScroll";
+    } | {
+        readonly _tag: "CompletedUnlockScroll";
+    } | {
+        readonly _tag: "CompletedInertOthers";
+    } | {
+        readonly _tag: "CompletedRestoreInert";
+    } | {
+        readonly _tag: "Closed";
+    } | {
+        readonly _tag: "Opened";
+        readonly maybeActiveItemIndex: Option.Option<number>;
+    } | {
+        readonly _tag: "BlurredInput";
+    } | {
+        readonly _tag: "ActivatedItem";
+        readonly index: number;
+        readonly activationTrigger: "Pointer" | "Keyboard";
+        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 index: number;
+        readonly screenX: number;
+        readonly screenY: number;
+    } | {
+        readonly _tag: "RequestedItemClick";
+        readonly index: number;
+    } | {
+        readonly _tag: "CompletedFocusInput";
+    } | {
+        readonly _tag: "CompletedScrollIntoView";
+    } | {
+        readonly _tag: "CompletedClickItem";
+    } | {
+        readonly _tag: "CompletedAnchorCombobox";
+    } | {
+        readonly _tag: "CompletedAttachComboboxPreventBlur";
+    } | {
+        readonly _tag: "CompletedAttachComboboxSelectOnFocus";
+    } | {
+        readonly _tag: "CompletedPortalComboboxBackdrop";
+    } | {
+        readonly _tag: "GotAnimationMessage";
+        readonly message: {
+            readonly _tag: "Showed";
+        } | {
+            readonly _tag: "Hid";
+        } | {
+            readonly _tag: "AdvancedAnimationFrame";
+        } | {
+            readonly _tag: "EndedAnimation";
+        };
+    } | {
+        readonly _tag: "UpdatedInputValue";
+        readonly value: string;
+    } | {
+        readonly _tag: "PressedToggleButton";
+    }, never, never>;
+}>[], Option.Option<Readonly<{
+    readonly _tag: "Selected";
+    readonly value: string;
+    readonly wasAdded: boolean;
+}>>];
+type UpdateReturn = ReturnType<typeof update>;
+/** Programmatically opens the combobox, updating the model and returning
+ *  focus and modal commands. Use this in domain-event handlers to open the combobox. */
+export declare const open: (model: Model) => UpdateReturn;
+/** Programmatically closes the combobox, updating the model and returning
+ *  focus and modal commands. Use this in domain-event handlers to close the combobox. */
+export declare const close: (model: Model) => UpdateReturn;
+/** Programmatically toggles an item in the multi-select combobox. Emits `Selected({ value, wasAdded })`. */
+export declare const selectItem: (model: Model, item: string) => UpdateReturn;
+/** Reflects an externally-sourced selection set onto the model without
+ *  emitting an OutMessage or running selection side effects. Use this to
+ *  mirror external truth (URL parameters, restored storage, a server push)
+ *  onto the combobox's selected items. Contrast with `selectItem`, which
+ *  toggles a single item as a user *choice* and emits `Selected`. Returns
+ *  the model directly because it produces no commands and no OutMessage. */
+export declare const reflectSelectedItems: Reflect<Model, ReadonlyArray<string>>;
+/** Per-render view inputs passed to the view via `h.submodel`'s `viewInputs` field. */
+export type ViewInputs<Item extends string> = BaseViewInputs<Item>;
+/** Pairs the multi-select combobox's `view` and `update` (and programmatic
+ *  helpers) behind a single Item-typed entry point. */
+export declare const create: <Item extends string = string>() => Readonly<{
+    view: SubmodelView<Model, Message, BaseViewInputs<Item>>;
+    update: (model: Model, message: Message) => readonly [Model, ReadonlyArray<Command.Command<Message>>, Option.Option<OutMessage<Item>>];
+    selectItem: (model: Model, item: Item) => readonly [Model, ReadonlyArray<Command.Command<Message>>, Option.Option<OutMessage<Item>>];
+    open: (model: Model) => readonly [Model, ReadonlyArray<Command.Command<Message>>, Option.Option<OutMessage<Item>>];
+    close: (model: Model) => readonly [Model, ReadonlyArray<Command.Command<Message>>, Option.Option<OutMessage<Item>>];
+    reflectSelectedItems: Reflect<Model, ReadonlyArray<Item>>;
+}>;
+export {};
+//# sourceMappingURL=multi.d.ts.map

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

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

package/dist/combobox/multi.js

@@ -0,0 +1,81 @@
+import { Array, Function, Option, Schema as S } from 'effect';
+import { evo } from 'foldkit/struct';
+import { BaseModel, Closed, Opened, SelectedItem, Selected as SharedSelected, baseInit, closedBaseModel, makeUpdate, makeView, } from './shared.js';
+// MODEL
+/** Schema for the multi-select combobox component's state, tracking open/closed status, active item, input value, and selected items. */
+export const Model = S.Struct({
+    ...BaseModel.fields,
+    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 wasAdded = !Array.contains(model.selectedItems, item);
+        const nextSelectedItems = wasAdded
+            ? Array.append(model.selectedItems, item)
+            : Array.filter(model.selectedItems, selected => selected !== item);
+        return [
+            evo(model, { selectedItems: () => nextSelectedItems }),
+            [],
+            Option.some(SharedSelected({ value: item, wasAdded })),
+        ];
+    },
+    handleImmediateActivation: (model, item) => evo(model, {
+        selectedItems: () => toggleItem(model.selectedItems, item),
+    }),
+});
+/** Programmatically opens the combobox, updating the model and returning
+ *  focus and modal commands. Use this in domain-event handlers to open the combobox. */
+export const open = (model) => update(model, Opened({ maybeActiveItemIndex: Option.none() }));
+/** Programmatically closes the combobox, updating the model and returning
+ *  focus and modal commands. Use this in domain-event handlers to close the combobox. */
+export const close = (model) => update(model, Closed());
+/** Programmatically toggles an item in the multi-select combobox. Emits `Selected({ value, wasAdded })`. */
+export const selectItem = (model, item) => update(model, SelectedItem({ item, displayText: item }));
+/** Reflects an externally-sourced selection set onto the model without
+ *  emitting an OutMessage or running selection side effects. Use this to
+ *  mirror external truth (URL parameters, restored storage, a server push)
+ *  onto the combobox's selected items. Contrast with `selectItem`, which
+ *  toggles a single item as a user *choice* and emits `Selected`. Returns
+ *  the model directly because it produces no commands and no OutMessage. */
+export const reflectSelectedItems = Function.dual(2, (model, items) => evo(model, { selectedItems: () => items }));
+const internalView = makeView({
+    isItemSelected: (model, itemValue) => Array.contains(model.selectedItems, itemValue),
+    ariaMultiSelectable: true,
+});
+/** Pairs the multi-select combobox's `view` and `update` (and programmatic
+ *  helpers) behind a single Item-typed entry point. */
+export const create = () => {
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+    const typedUpdate = update;
+    return {
+        view: internalView(),
+        update: typedUpdate,
+        selectItem: (model, item) => typedUpdate(model, SelectedItem({ item, displayText: item })),
+        open: model => typedUpdate(model, Opened({ maybeActiveItemIndex: Option.none() })),
+        close: model => typedUpdate(model, Closed()),
+        /* eslint-disable-next-line @typescript-eslint/consistent-type-assertions */
+        reflectSelectedItems: reflectSelectedItems,
+    };
+};

package/dist/combobox/multiPublic.d.ts

@@ -0,0 +1,3 @@
+export { init, create, Model } from './multi.js';
+export type { InitConfig, ViewInputs } from './multi.js';
+//# sourceMappingURL=multiPublic.d.ts.map

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

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

package/dist/combobox/multiPublic.js

@@ -0,0 +1 @@
+export { init, create, Model } from './multi.js';

package/dist/combobox/public.d.ts

@@ -0,0 +1,7 @@
+export { init, create, Model } from './single.js';
+export { Message, OutMessage, Selected, SelectedItem, CompletedLockScroll, CompletedUnlockScroll, CompletedInertOthers, CompletedRestoreInert, CompletedFocusInput, CompletedScrollIntoView, CompletedClickItem, CompletedAnchorCombobox, CompletedAttachComboboxPreventBlur, CompletedAttachComboboxSelectOnFocus, CompletedPortalComboboxBackdrop, AnchorCombobox, AttachComboboxPreventBlur, AttachComboboxSelectOnFocus, PortalComboboxBackdrop, GotAnimationMessage, LockScroll, UnlockScroll, InertOthers, RestoreInert, FocusInput, ScrollIntoView, ClickItem, DetectMovementOrAnimationEnd, } from './shared.js';
+export type { ActivationTrigger, Opened, Closed, BlurredInput, ActivatedItem, DeactivatedItem, MovedPointerOverItem, RequestedItemClick, UpdatedInputValue, PressedToggleButton, ItemConfig, GroupHeading, } from './shared.js';
+export type { InitConfig, ViewInputs } from './single.js';
+export type { AnchorConfig } from '../anchor.js';
+export * as Multi from './multiPublic.js';
+//# sourceMappingURL=public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../src/combobox/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,EACL,OAAO,EACP,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,kCAAkC,EAClC,oCAAoC,EACpC,+BAA+B,EAC/B,cAAc,EACd,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,4BAA4B,GAC7B,MAAM,aAAa,CAAA;AAEpB,YAAY,EACV,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,YAAY,EACZ,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,YAAY,GACb,MAAM,aAAa,CAAA;AAEpB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEzD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAA"}

package/dist/combobox/public.js

@@ -0,0 +1,3 @@
+export { init, create, Model } from './single.js';
+export { Message, OutMessage, Selected, SelectedItem, CompletedLockScroll, CompletedUnlockScroll, CompletedInertOthers, CompletedRestoreInert, CompletedFocusInput, CompletedScrollIntoView, CompletedClickItem, CompletedAnchorCombobox, CompletedAttachComboboxPreventBlur, CompletedAttachComboboxSelectOnFocus, CompletedPortalComboboxBackdrop, AnchorCombobox, AttachComboboxPreventBlur, AttachComboboxSelectOnFocus, PortalComboboxBackdrop, GotAnimationMessage, LockScroll, UnlockScroll, InertOthers, RestoreInert, FocusInput, ScrollIntoView, ClickItem, DetectMovementOrAnimationEnd, } from './shared.js';
+export * as Multi from './multiPublic.js';