foldkit 0.23.0 → 0.25.0

package/dist/ui/listbox/single.d.ts

@@ -0,0 +1,172 @@
+import { Option, Schema as S } from 'effect';
+import { type BaseInitConfig, type BaseViewConfig } from './shared';
+/** Schema for the listbox component's state, tracking open/closed status, active item, selected item, activation trigger, and typeahead search. */
+export declare const Model: S.extend<S.Struct<{
+    id: typeof S.String;
+    isOpen: typeof S.Boolean;
+    isAnimated: typeof S.Boolean;
+    isModal: typeof S.Boolean;
+    orientation: S.Literal<["Vertical", "Horizontal"]>;
+    transitionState: S.Literal<["Idle", "EnterStart", "EnterAnimating", "LeaveStart", "LeaveAnimating"]>;
+    maybeActiveItemIndex: S.OptionFromSelf<typeof S.Number>;
+    activationTrigger: S.Literal<["Pointer", "Keyboard"]>;
+    searchQuery: typeof S.String;
+    searchVersion: typeof S.Number;
+    maybeLastPointerPosition: S.OptionFromSelf<S.Struct<{
+        screenX: typeof S.Number;
+        screenY: typeof S.Number;
+    }>>;
+    maybeLastButtonPointerType: S.OptionFromSelf<typeof S.String>;
+}>, S.Struct<{
+    maybeSelectedItem: S.OptionFromSelf<typeof S.String>;
+}>>;
+export type Model = typeof Model.Type;
+/** Configuration for creating a single-select listbox model with `init`. `isAnimated` enables CSS transition coordination (default `false`). `isModal` locks page scroll and inerts other elements when open (default `false`). `selectedItem` sets the initial selection (default none). */
+export type InitConfig = BaseInitConfig & Readonly<{
+    selectedItem?: string;
+}>;
+/** Creates an initial single-select listbox model from a config. Defaults to closed with no active item and no selection. */
+export declare const init: (config: InitConfig) => Model;
+/** Processes a listbox message and returns the next model and commands. Closes the listbox on selection (single-select behavior). */
+export declare const update: (model: {
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly orientation: "Vertical" | "Horizontal";
+    readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    readonly maybeActiveItemIndex: Option.Option<number>;
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly searchQuery: string;
+    readonly searchVersion: number;
+    readonly maybeLastPointerPosition: Option.Option<{
+        readonly screenX: number;
+        readonly screenY: number;
+    }>;
+    readonly maybeLastButtonPointerType: Option.Option<string>;
+} & {
+    readonly maybeSelectedItem: Option.Option<string>;
+}, message: import("./shared").Message) => [{
+    readonly id: string;
+    readonly isOpen: boolean;
+    readonly isAnimated: boolean;
+    readonly isModal: boolean;
+    readonly orientation: "Vertical" | "Horizontal";
+    readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+    readonly maybeActiveItemIndex: Option.Option<number>;
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly searchQuery: string;
+    readonly searchVersion: number;
+    readonly maybeLastPointerPosition: Option.Option<{
+        readonly screenX: number;
+        readonly screenY: number;
+    }>;
+    readonly maybeLastButtonPointerType: Option.Option<string>;
+} & {
+    readonly maybeSelectedItem: Option.Option<string>;
+}, readonly import("../../command").Command<{
+    readonly _tag: "Closed";
+} | {
+    readonly _tag: "NoOp";
+} | {
+    readonly _tag: "Opened";
+    readonly maybeActiveItemIndex: Option.Option<number>;
+} | {
+    readonly _tag: "ClosedByTab";
+} | {
+    readonly _tag: "ActivatedItem";
+    readonly activationTrigger: "Pointer" | "Keyboard";
+    readonly index: number;
+} | {
+    readonly _tag: "DeactivatedItem";
+} | {
+    readonly _tag: "SelectedItem";
+    readonly item: string;
+} | {
+    readonly _tag: "MovedPointerOverItem";
+    readonly screenX: number;
+    readonly screenY: number;
+    readonly index: number;
+} | {
+    readonly _tag: "RequestedItemClick";
+    readonly index: number;
+} | {
+    readonly _tag: "Searched";
+    readonly key: string;
+    readonly maybeTargetIndex: Option.Option<number>;
+} | {
+    readonly _tag: "ClearedSearch";
+    readonly version: number;
+} | {
+    readonly _tag: "AdvancedTransitionFrame";
+} | {
+    readonly _tag: "EndedTransition";
+} | {
+    readonly _tag: "DetectedButtonMovement";
+} | {
+    readonly _tag: "PressedPointerOnButton";
+    readonly button: number;
+    readonly pointerType: string;
+}>[]];
+/** Configuration for rendering a single-select listbox with `view`. */
+export type ViewConfig<Message, Item> = BaseViewConfig<Message, Item, Model>;
+/** Renders a headless single-select listbox with typeahead search, keyboard navigation, selection tracking, and aria-activedescendant focus management. */
+export declare const view: <Message, Item>(config: Readonly<{
+    model: {
+        readonly id: string;
+        readonly isOpen: boolean;
+        readonly isAnimated: boolean;
+        readonly isModal: boolean;
+        readonly orientation: "Vertical" | "Horizontal";
+        readonly transitionState: "Idle" | "EnterStart" | "EnterAnimating" | "LeaveStart" | "LeaveAnimating";
+        readonly maybeActiveItemIndex: Option.Option<number>;
+        readonly activationTrigger: "Pointer" | "Keyboard";
+        readonly searchQuery: string;
+        readonly searchVersion: number;
+        readonly maybeLastPointerPosition: Option.Option<{
+            readonly screenX: number;
+            readonly screenY: number;
+        }>;
+        readonly maybeLastButtonPointerType: Option.Option<string>;
+    } & {
+        readonly maybeSelectedItem: Option.Option<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").Searched | import("./shared").PressedPointerOnButton | import("./shared").NoOp) => Message;
+    items: readonly Item[];
+    itemToConfig: (item: Item, context: Readonly<{
+        isActive: boolean;
+        isDisabled: boolean;
+        isSelected: boolean;
+    }>) => Readonly<{
+        className: string;
+        content: import("../../html").Html;
+    }>;
+    isItemDisabled?: (item: Item, index: number) => boolean;
+    itemToSearchText?: (item: Item, index: number) => string;
+    itemToValue?: (item: Item) => string;
+    isButtonDisabled?: boolean;
+    buttonContent: import("../../html").Html;
+    buttonClassName: string;
+    itemsClassName: string;
+    backdropClassName: string;
+    className?: string;
+    itemGroupKey?: (item: Item, index: number) => string;
+    groupToHeading?: (groupKey: string) => Readonly<{
+        content: import("../../html").Html;
+        className: string;
+    }> | undefined;
+    groupClassName?: string;
+    separatorClassName?: string;
+    anchor?: Readonly<{
+        placement?: import("@floating-ui/dom").Placement;
+        gap?: number;
+        offset?: number;
+        padding?: number;
+        portal?: boolean;
+    }>;
+    name?: string;
+    form?: string;
+    isDisabled?: boolean;
+    isInvalid?: boolean;
+}>) => import("../../html").Html;
+//# sourceMappingURL=single.d.ts.map

package/dist/ui/listbox/single.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"single.d.ts","sourceRoot":"","sources":["../../../src/ui/listbox/single.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,MAAM,IAAI,CAAC,EAAQ,MAAM,QAAQ,CAAA;AAGzD,OAAO,EACL,KAAK,cAAc,EAEnB,KAAK,cAAc,EAKpB,MAAM,UAAU,CAAA;AAIjB,mJAAmJ;AACnJ,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;GAEjB,CAAA;AAED,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAIrC,6RAA6R;AAC7R,MAAM,MAAM,UAAU,GAAG,cAAc,GACrC,QAAQ,CAAC;IACP,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAC,CAAA;AAEJ,6HAA6H;AAC7H,eAAO,MAAM,IAAI,GAAI,QAAQ,UAAU,KAAG,KAGxC,CAAA;AAIF,qIAAqI;AACrI,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAYjB,CAAA;AAIF,uEAAuE;AACvE,MAAM,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;AAE5E,2JAA2J;AAC3J,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWf,CAAA"}

package/dist/ui/listbox/single.js

@@ -0,0 +1,29 @@
+import { Array, Option, Schema as S, pipe } from 'effect';
+import { evo } from '../../struct';
+import { BaseModel, baseInit, closedModel, makeUpdate, makeView, } from './shared';
+// MODEL
+/** Schema for the listbox component's state, tracking open/closed status, active item, selected item, activation trigger, and typeahead search. */
+export const Model = BaseModel.pipe(S.extend(S.Struct({ maybeSelectedItem: S.OptionFromSelf(S.String) })));
+/** Creates an initial single-select listbox model from a config. Defaults to closed with no active item and no selection. */
+export const init = (config) => ({
+    ...baseInit(config),
+    maybeSelectedItem: Option.fromNullable(config.selectedItem),
+});
+// UPDATE
+/** Processes a listbox message and returns the next model and commands. Closes the listbox on selection (single-select behavior). */
+export const update = makeUpdate((model, item, context) => [
+    evo(closedModel(model), {
+        maybeSelectedItem: () => Option.some(item),
+    }),
+    pipe(Array.getSomes([
+        context.maybeNextFrame,
+        context.maybeUnlockScroll,
+        context.maybeRestoreInert,
+    ]), Array.prepend(context.focusButton)),
+]);
+/** Renders a headless single-select listbox with typeahead search, keyboard navigation, selection tracking, and aria-activedescendant focus management. */
+export const view = makeView({
+    isItemSelected: (model, itemValue) => Option.exists(model.maybeSelectedItem, selectedItem => selectedItem === itemValue),
+    selectedItemIndex: (model, items, itemToValue) => Option.flatMap(model.maybeSelectedItem, selectedItem => Array.findFirstIndex(items, item => itemToValue(item) === selectedItem)),
+    ariaMultiSelectable: false,
+});

package/dist/ui/menu/index.d.ts

@@ -1,6 +1,8 @@
-import { Option, Schema as S } from 'effect';
+import { Schema as S } from 'effect';
 import type { Command } from '../../command';
 import { type Html } from '../../html';
+import { groupContiguous } from '../group';
+import { resolveTypeaheadMatch } from '../typeahead';
 import type { AnchorConfig } from './anchor';
 /** Schema for the activation trigger — whether the user interacted via mouse or keyboard. */
 export declare const ActivationTrigger: S.Literal<["Pointer", "Keyboard"]>;
@@ -182,14 +184,7 @@ export type ViewConfig<Message, Item extends string> = Readonly<{
     separatorClassName?: string;
     anchor?: AnchorConfig;
 }>;
-type Segment<A> = Readonly<{
-    key: string;
-    items: ReadonlyArray<A>;
-}>;
-export declare const groupContiguous: <A>(items: ReadonlyArray<A>, toKey: (item: A, index: number) => string) => ReadonlyArray<Segment<A>>;
-/** Finds the first enabled item whose search text starts with the query, searching forward from the active item and wrapping around. On a fresh search, starts after the active item; on a refinement, includes the active item. */
-export declare const resolveTypeaheadMatch: <Item extends string>(items: ReadonlyArray<Item>, query: string, maybeActiveItemIndex: Option.Option<number>, isDisabled: (index: number) => boolean, itemToSearchText: (item: Item, index: number) => string, isRefinement: boolean) => Option.Option<number>;
+export { groupContiguous, resolveTypeaheadMatch };
 /** Renders a headless menu with typeahead search, keyboard navigation, and aria-activedescendant focus management. */
 export declare const view: <Message, Item extends string>(config: ViewConfig<Message, Item>) => Html;
-export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/ui/menu/index.d.ts.map

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

package/dist/ui/menu/index.js

@@ -1,10 +1,12 @@
-import { Array, Effect, Match as M, Option, Schema as S, String as Str, pipe, } from 'effect';
+import { Array, Effect, Match as M, Option, Predicate, Schema as S, String as Str, pipe, } from 'effect';
 import { OptionExt } from '../../effectExtensions';
 import { html } from '../../html';
 import { m } from '../../message';
 import { evo } from '../../struct';
 import * as Task from '../../task';
-import { findFirstEnabledIndex, keyToIndex, wrapIndex } from '../keyboard';
+import { groupContiguous } from '../group';
+import { findFirstEnabledIndex, isPrintableKey, keyToIndex } from '../keyboard';
+import { resolveTypeaheadMatch } from '../typeahead';
 import { anchorHooks } from './anchor';
 // MODEL
 /** Schema for the activation trigger — whether the user interacted via mouse or keyboard. */
@@ -92,6 +94,7 @@ export const ReleasedPointerOnItems = m('ReleasedPointerOnItems', {
 export const Message = S.Union(Opened, Closed, ClosedByTab, ActivatedItem, DeactivatedItem, SelectedItem, MovedPointerOverItem, RequestedItemClick, Searched, ClearedSearch, NoOp, AdvancedTransitionFrame, EndedTransition, DetectedButtonMovement, PressedPointerOnButton, ReleasedPointerOnItems);
 // INIT
 const SEARCH_DEBOUNCE_MILLISECONDS = 350;
+const LEFT_MOUSE_BUTTON = 0;
 const POINTER_HOLD_THRESHOLD_MILLISECONDS = 200;
 const POINTER_MOVEMENT_THRESHOLD_PIXELS = 5;
 /** Creates an initial menu model from a config. Defaults to closed with no active item. */
@@ -251,7 +254,7 @@ export const update = (model, message) => {
             const withPointerType = evo(model, {
                 maybeLastButtonPointerType: () => Option.some(pointerType),
             });
-            if (pointerType !== 'mouse' || button !== 0) {
+            if (pointerType !== 'mouse' || button !== LEFT_MOUSE_BUTTON) {
                 return [withPointerType, []];
             }
             if (model.isOpen) {
@@ -303,30 +306,8 @@ export const update = (model, message) => {
         NoOp: () => [model, []],
     }));
 };
-export const groupContiguous = (items, toKey) => {
-    const tagged = Array.map(items, (item, index) => ({
-        key: toKey(item, index),
-        item,
-    }));
-    return Array.chop(tagged, nonEmpty => {
-        const key = Array.headNonEmpty(nonEmpty).key;
-        const [matching, rest] = Array.span(nonEmpty, tagged => tagged.key === key);
-        return [{ key, items: Array.map(matching, ({ item }) => item) }, rest];
-    });
-};
+export { groupContiguous, resolveTypeaheadMatch };
 const itemId = (id, index) => `${id}-item-${index}`;
-/** Finds the first enabled item whose search text starts with the query, searching forward from the active item and wrapping around. On a fresh search, starts after the active item; on a refinement, includes the active item. */
-export const resolveTypeaheadMatch = (items, query, maybeActiveItemIndex, isDisabled, itemToSearchText, isRefinement) => {
-    const lowerQuery = Str.toLowerCase(query);
-    const offset = isRefinement ? 0 : 1;
-    const startIndex = Option.match(maybeActiveItemIndex, {
-        onNone: () => 0,
-        onSome: index => index + offset,
-    });
-    const isEnabledMatch = (index) => !isDisabled(index) &&
-        pipe(items, Array.get(index), Option.exists(item => pipe(itemToSearchText(item, index), Str.toLowerCase, Str.startsWith(lowerQuery))));
-    return pipe(items.length, Array.makeBy(step => wrapIndex(startIndex + step, items.length)), Array.findFirst(isEnabledMatch));
-};
 /** Renders a headless menu with typeahead search, keyboard navigation, and aria-activedescendant focus management. */
 export const view = (config) => {
     const { div, AriaActiveDescendant, AriaControls, AriaDisabled, AriaExpanded, AriaHasPopup, AriaLabelledBy, Class, DataAttribute, Id, OnBlur, OnClick, OnDestroy, OnInsert, OnKeyDownPreventDefault, OnKeyUpPreventDefault, OnPointerDown, OnPointerLeave, OnPointerMove, OnPointerUp, Role, Style, Tabindex, Type, keyed, } = html();
@@ -348,7 +329,7 @@ export const view = (config) => {
         DataAttribute('leave', ''),
         DataAttribute('transition', ''),
     ]), M.orElse(() => []));
-    const isDisabled = (index) => !!isItemDisabled &&
+    const isDisabled = (index) => Predicate.isNotUndefined(isItemDisabled) &&
         pipe(items, Array.get(index), Option.exists(item => isItemDisabled(item, index)));
     const firstEnabledIndex = findFirstEnabledIndex(items.length, 0, isDisabled)(0, 1);
     const lastEnabledIndex = findFirstEnabledIndex(items.length, 0, isDisabled)(items.length - 1, -1);
@@ -388,7 +369,7 @@ export const view = (config) => {
         : Option.map(maybeActiveItemIndex, index => toMessage(RequestedItemClick({ index })))), M.whenOr('ArrowDown', 'ArrowUp', 'Home', 'End', 'PageUp', 'PageDown', () => Option.some(toMessage(ActivatedItem({
         index: resolveActiveIndex(key),
         activationTrigger: 'Keyboard',
-    })))), M.when(key => key.length === 1, () => searchForKey(key)), M.orElse(() => Option.none()));
+    })))), M.when(isPrintableKey, () => searchForKey(key)), M.orElse(() => Option.none()));
     const handleItemsPointerUp = (screenX, screenY, pointerType, timeStamp) => OptionExt.when(pointerType === 'mouse', toMessage(ReleasedPointerOnItems({ screenX, screenY, timeStamp })));
     const buttonAttributes = [
         Id(`${id}-button`),
@@ -450,7 +431,6 @@ export const view = (config) => {
         return keyed('div')(itemId(id, index), [
             Id(itemId(id, index)),
             Role('menuitem'),
-            Tabindex(-1),
             Class(itemConfig.className),
             ...(isActiveItem ? [DataAttribute('active', '')] : []),
             ...(isDisabledItem

package/dist/ui/typeahead.d.ts

@@ -0,0 +1,4 @@
+import { Option } from 'effect';
+/** Finds the first enabled item whose search text starts with the query, searching forward from the active item and wrapping around. On a fresh search, starts after the active item; on a refinement, includes the active item. */
+export declare const resolveTypeaheadMatch: <Item>(items: ReadonlyArray<Item>, query: string, maybeActiveItemIndex: Option.Option<number>, isDisabled: (index: number) => boolean, itemToSearchText: (item: Item, index: number) => string, isRefinement: boolean) => Option.Option<number>;
+//# sourceMappingURL=typeahead.d.ts.map

package/dist/ui/typeahead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeahead.d.ts","sourceRoot":"","sources":["../../src/ui/typeahead.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAuB,MAAM,QAAQ,CAAA;AAI3D,oOAAoO;AACpO,eAAO,MAAM,qBAAqB,GAAI,IAAI,EACxC,OAAO,aAAa,CAAC,IAAI,CAAC,EAC1B,OAAO,MAAM,EACb,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAC3C,YAAY,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,EACtC,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,EACvD,cAAc,OAAO,KACpB,MAAM,CAAC,MAAM,CAAC,MAAM,CA4BtB,CAAA"}

package/dist/ui/typeahead.js

@@ -0,0 +1,14 @@
+import { Array, Option, String as Str, pipe } from 'effect';
+import { wrapIndex } from './keyboard';
+/** Finds the first enabled item whose search text starts with the query, searching forward from the active item and wrapping around. On a fresh search, starts after the active item; on a refinement, includes the active item. */
+export const resolveTypeaheadMatch = (items, query, maybeActiveItemIndex, isDisabled, itemToSearchText, isRefinement) => {
+    const lowerQuery = Str.toLowerCase(query);
+    const offset = isRefinement ? 0 : 1;
+    const startIndex = Option.match(maybeActiveItemIndex, {
+        onNone: () => 0,
+        onSome: index => index + offset,
+    });
+    const isEnabledMatch = (index) => !isDisabled(index) &&
+        pipe(items, Array.get(index), Option.exists(item => pipe(itemToSearchText(item, index), Str.toLowerCase, Str.startsWith(lowerQuery))));
+    return pipe(items, Array.length, Array.makeBy(step => wrapIndex(startIndex + step, items.length)), Array.findFirst(isEnabledMatch));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foldkit",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Elm-inspired UI framework powered by Effect",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,6 +19,10 @@
       "types": "./dist/html/public.d.ts",
       "import": "./dist/html/public.js"
     },
+    "./managedResource": {
+      "types": "./dist/managedResource/public.d.ts",
+      "import": "./dist/managedResource/public.js"
+    },
     "./message": {
       "types": "./dist/message/public.d.ts",
       "import": "./dist/message/public.js"
@@ -47,6 +51,10 @@
       "types": "./dist/struct/public.d.ts",
       "import": "./dist/struct/public.js"
     },
+    "./subscription": {
+      "types": "./dist/subscription/public.d.ts",
+      "import": "./dist/subscription/public.js"
+    },
     "./task": {
       "types": "./dist/task/public.d.ts",
       "import": "./dist/task/public.js"
@@ -63,6 +71,10 @@
       "types": "./dist/ui/disclosure/public.d.ts",
       "import": "./dist/ui/disclosure/public.js"
     },
+    "./ui/listbox": {
+      "types": "./dist/ui/listbox/public.d.ts",
+      "import": "./dist/ui/listbox/public.js"
+    },
     "./ui/menu": {
       "types": "./dist/ui/menu/public.d.ts",
       "import": "./dist/ui/menu/public.js"