foldkit 0.24.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foldkit",
-  "version": "0.24.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"

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/listbox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,MAAM,IAAI,CAAC,EAGZ,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAAE,KAAK,IAAI,EAAQ,MAAM,YAAY,CAAA;AAO5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEpD,OAAO,EAAE,qBAAqB,EAAE,CAAA;AAIhC,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,oCAAmC,CAAA;AACjE,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAA;AAE7D,8GAA8G;AAC9G,eAAO,MAAM,eAAe,qFAM3B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AAEzD,0FAA0F;AAC1F,eAAO,MAAM,WAAW,uCAAsC,CAAA;AAC9D,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AAEjD,oJAAoJ;AACpJ,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;EAiBhB,CAAA;AAEF,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAA;AAIrC,sJAAsJ;AACtJ,eAAO,MAAM,MAAM;;EAEjB,CAAA;AACF,qEAAqE;AACrE,eAAO,MAAM,MAAM,2DAAc,CAAA;AACjC,8EAA8E;AAC9E,eAAO,MAAM,WAAW,gEAAmB,CAAA;AAC3C,mGAAmG;AACnG,eAAO,MAAM,aAAa;;;EAGxB,CAAA;AACF,kDAAkD;AAClD,eAAO,MAAM,eAAe,oEAAuB,CAAA;AACnD,kGAAkG;AAClG,eAAO,MAAM,YAAY;;EAAwC,CAAA;AACjE,kHAAkH;AAClH,eAAO,MAAM,kBAAkB;;EAE7B,CAAA;AACF,qEAAqE;AACrE,eAAO,MAAM,QAAQ;;;EAGnB,CAAA;AACF,4EAA4E;AAC5E,eAAO,MAAM,aAAa;;EAA4C,CAAA;AACtE,mHAAmH;AACnH,eAAO,MAAM,oBAAoB;;;;EAI/B,CAAA;AACF,yDAAyD;AACzD,eAAO,MAAM,IAAI,yDAAY,CAAA;AAC7B,oGAAoG;AACpG,eAAO,MAAM,uBAAuB,4EAA+B,CAAA;AACnE,8FAA8F;AAC9F,eAAO,MAAM,eAAe,oEAAuB,CAAA;AACnD,yHAAyH;AACzH,eAAO,MAAM,sBAAsB,2EAA8B,CAAA;AACjE,kHAAkH;AAClH,eAAO,MAAM,sBAAsB;;;EAGjC,CAAA;AAEF,+DAA+D;AAC/D,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;IAgBnB,CAAA;AAED,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AACvC,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,IAAI,CAAA;AACvC,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,IAAI,CAAA;AACjD,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AACrD,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AACzD,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AACnD,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AACnE,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC,IAAI,CAAA;AAC/D,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,IAAI,CAAA;AAC3C,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;AACrD,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,CAAA;AACnC,MAAM,MAAM,uBAAuB,GAAG,OAAO,uBAAuB,CAAC,IAAI,CAAA;AACzE,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAA;AACzD,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AACvE,MAAM,MAAM,sBAAsB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAA;AAEvE,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAA;AAOzC,0VAA0V;AAC1V,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;CACtC,CAAC,CAAA;AAEF,+GAA+G;AAC/G,eAAO,MAAM,IAAI,GAAI,QAAQ,UAAU,KAAG,KAexC,CAAA;AAqBF,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAG5D,2EAA2E;AAC3E,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,EAAE,SAAS,OAAO,KAAG,YA0RvD,CAAA;AAID,iEAAiE;AACjE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,IAAI,CAAA;CACd,CAAC,CAAA;AAEF,yEAAyE;AACzE,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,IAAI,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB,CAAC,CAAA;AAEF,yDAAyD;AACzD,MAAM,MAAM,UAAU,CAAC,OAAO,EAAE,IAAI,IAAI,QAAQ,CAAC;IAC/C,KAAK,EAAE,KAAK,CAAA;IACZ,SAAS,EAAE,CACT,OAAO,EACH,MAAM,GACN,MAAM,GACN,WAAW,GACX,aAAa,GACb,eAAe,GACf,YAAY,GACZ,oBAAoB,GACpB,kBAAkB,GAClB,QAAQ,GACR,sBAAsB,GACtB,IAAI,KACL,OAAO,CAAA;IACZ,KAAK,EAAE,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1B,YAAY,EAAE,CACZ,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,QAAQ,CAAC;QAChB,QAAQ,EAAE,OAAO,CAAA;QACjB,UAAU,EAAE,OAAO,CAAA;QACnB,UAAU,EAAE,OAAO,CAAA;KACpB,CAAC,KACC,UAAU,CAAA;IACf,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACvD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACxD,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,aAAa,EAAE,IAAI,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACpD,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAA;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAC,CAAA;AAIF,6IAA6I;AAC7I,eAAO,MAAM,IAAI,GAAI,OAAO,EAAE,IAAI,EAChC,QAAQ,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,KAChC,IAodF,CAAA"}