@nikala-ui/folio 0.13.0

package/dist/hooks/create-clipboard.js

@@ -0,0 +1,48 @@
+import { createSignal, onCleanup } from "solid-js";
+/**
+ * SolidJS reactive primitive for copying text to clipboard with automatic reset state.
+ *
+ * @param options Configuration options including copied status reset timeout duration.
+ */
+export function createClipboard(options = {}) {
+    const timeoutDuration = options.timeout ?? 2000;
+    const [copied, setCopied] = createSignal(false);
+    const [error, setError] = createSignal(undefined);
+    let timer;
+    const clearTimer = () => {
+        if (timer) {
+            clearTimeout(timer);
+            timer = undefined;
+        }
+    };
+    const copy = async (text) => {
+        clearTimer();
+        setError(undefined);
+        try {
+            if (typeof window !== "undefined" && navigator.clipboard && navigator.clipboard.writeText) {
+                await navigator.clipboard.writeText(text);
+                setCopied(true);
+                timer = setTimeout(() => {
+                    setCopied(false);
+                }, timeoutDuration);
+                return true;
+            }
+            throw new Error("Clipboard API not supported");
+        }
+        catch (err) {
+            const copyError = err instanceof Error ? err : new Error(String(err));
+            setError(copyError);
+            setCopied(false);
+            return false;
+        }
+    };
+    onCleanup(() => {
+        clearTimer();
+    });
+    return {
+        copied,
+        copy,
+        error,
+    };
+}
+//# sourceMappingURL=create-clipboard.js.map

package/dist/hooks/create-clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-clipboard.js","sourceRoot":"","sources":["../../src/hooks/create-clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AAgBlE;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAA2B,EAAE;IAClE,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IAChD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,YAAY,CAAoB,SAAS,CAAC,CAAC;IACrE,IAAI,KAAgD,CAAC;IAErD,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,KAAK,EAAE,CAAC;YACV,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,EAAE,IAAY,EAAoB,EAAE;QACpD,UAAU,EAAE,CAAC;QACb,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEpB,IAAI,CAAC;YACH,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;gBAC1F,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC1C,SAAS,CAAC,IAAI,CAAC,CAAC;gBAEhB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,SAAS,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC,EAAE,eAAe,CAAC,CAAC;gBAEpB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YACtE,QAAQ,CAAC,SAAS,CAAC,CAAC;YACpB,SAAS,CAAC,KAAK,CAAC,CAAC;YACjB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,IAAI;QACJ,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/hooks/create-color-mode.d.ts

@@ -0,0 +1,27 @@
+import { type Accessor } from "solid-js";
+export type ColorMode = "light" | "dark" | "system";
+export interface CreateColorModeOptions {
+    /** Initial color mode fallback. Defaults to 'system'. */
+    initialValue?: ColorMode;
+    /** LocalStorage key for persisting color mode state. Defaults to 'nikala-color-mode'. */
+    storageKey?: string;
+    /** HTML attribute to apply dark mode class on document.documentElement. Defaults to 'class'. */
+    attribute?: string;
+}
+export interface CreateColorModeReturn {
+    /** Accessor for current active color mode ('light', 'dark', 'system') */
+    mode: Accessor<ColorMode>;
+    /** Function to update current color mode */
+    setMode: (mode: ColorMode) => void;
+    /** Function to toggle color mode between 'light' and 'dark' */
+    toggleColorMode: () => void;
+    /** Accessor indicating if current resolved mode is dark */
+    isDark: Accessor<boolean>;
+}
+/**
+ * SolidJS reactive primitive for managing dark/light color mode themes and system preferences.
+ *
+ * @param options Configuration options including storage key and initial mode.
+ */
+export declare function createColorMode(options?: CreateColorModeOptions): CreateColorModeReturn;
+//# sourceMappingURL=create-color-mode.d.ts.map

package/dist/hooks/create-color-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-color-mode.d.ts","sourceRoot":"","sources":["../../src/hooks/create-color-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkD,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzF,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,yDAAyD;IACzD,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACnC,+DAA+D;IAC/D,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,2DAA2D;IAC3D,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAmFvB"}

package/dist/hooks/create-color-mode.js

@@ -0,0 +1,86 @@
+import { createEffect, createSignal, onCleanup, onMount } from "solid-js";
+/**
+ * SolidJS reactive primitive for managing dark/light color mode themes and system preferences.
+ *
+ * @param options Configuration options including storage key and initial mode.
+ */
+export function createColorMode(options = {}) {
+    const initialMode = options.initialValue ?? "system";
+    const storageKey = options.storageKey ?? "nikala-color-mode";
+    const attribute = options.attribute ?? "class";
+    const [mode, setModeSignal] = createSignal(initialMode);
+    const [systemDark, setSystemDark] = createSignal(false);
+    const isDark = () => {
+        const currentMode = mode();
+        if (currentMode === "system")
+            return systemDark();
+        return currentMode === "dark";
+    };
+    const applyTheme = (dark) => {
+        if (typeof document === "undefined")
+            return;
+        const root = document.documentElement;
+        if (attribute === "class") {
+            if (dark)
+                root.classList.add("dark");
+            else
+                root.classList.remove("dark");
+        }
+        else {
+            root.setAttribute(attribute, dark ? "dark" : "light");
+        }
+    };
+    const setMode = (newMode) => {
+        setModeSignal(newMode);
+        if (typeof window !== "undefined") {
+            try {
+                localStorage.setItem(storageKey, newMode);
+            }
+            catch (e) {
+                console.warn(`[nikala-ui/hooks] Error setting color mode storage:`, e);
+            }
+        }
+    };
+    const toggleColorMode = () => {
+        const next = isDark() ? "light" : "dark";
+        setMode(next);
+    };
+    createEffect(() => {
+        applyTheme(isDark());
+    });
+    onMount(() => {
+        if (typeof window === "undefined")
+            return;
+        // Check system preference
+        const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
+        setSystemDark(mediaQuery.matches);
+        const handleMediaChange = (e) => {
+            setSystemDark(e.matches);
+        };
+        if (mediaQuery.addEventListener) {
+            mediaQuery.addEventListener("change", handleMediaChange);
+        }
+        // Check localStorage
+        try {
+            const stored = localStorage.getItem(storageKey);
+            if (stored && ["light", "dark", "system"].includes(stored)) {
+                setModeSignal(stored);
+            }
+        }
+        catch (e) {
+            console.warn(`[nikala-ui/hooks] Error reading color mode storage:`, e);
+        }
+        onCleanup(() => {
+            if (mediaQuery.removeEventListener) {
+                mediaQuery.removeEventListener("change", handleMediaChange);
+            }
+        });
+    });
+    return {
+        mode,
+        setMode,
+        toggleColorMode,
+        isDark,
+    };
+}
+//# sourceMappingURL=create-color-mode.js.map

package/dist/hooks/create-color-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-color-mode.js","sourceRoot":"","sources":["../../src/hooks/create-color-mode.ts"],"names":[],"mappings":"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"}

package/dist/hooks/create-controllable-signal.d.ts

@@ -0,0 +1,17 @@
+import { type Accessor } from "solid-js";
+export interface CreateControllableSignalOptions<T> {
+    /** Controlled value accessor or raw value */
+    value?: Accessor<T | undefined> | T;
+    /** Uncontrolled default initial value */
+    defaultValue?: T;
+    /** Callback fired whenever the value changes */
+    onChange?: (value: T) => void;
+}
+/**
+ * SolidJS reactive primitive for managing state supporting both controlled and uncontrolled modes.
+ *
+ * @param options Configuration options for value, defaultValue, and onChange callback.
+ * @returns A tuple containing [valueAccessor, setValueFunction].
+ */
+export declare function createControllableSignal<T>(options: CreateControllableSignalOptions<T>): [Accessor<T | undefined>, (nextValue: T | ((prev: T | undefined) => T)) => void];
+//# sourceMappingURL=create-controllable-signal.d.ts.map

package/dist/hooks/create-controllable-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-controllable-signal.d.ts","sourceRoot":"","sources":["../../src/hooks/create-controllable-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,WAAW,+BAA+B,CAAC,CAAC;IAChD,6CAA6C;IAC7C,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC,yCAAyC;IACzC,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,OAAO,EAAE,+BAA+B,CAAC,CAAC,CAAC,GAC1C,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAoClF"}

package/dist/hooks/create-controllable-signal.js

@@ -0,0 +1,35 @@
+import { createSignal } from "solid-js";
+/**
+ * SolidJS reactive primitive for managing state supporting both controlled and uncontrolled modes.
+ *
+ * @param options Configuration options for value, defaultValue, and onChange callback.
+ * @returns A tuple containing [valueAccessor, setValueFunction].
+ */
+export function createControllableSignal(options) {
+    const [internalValue, setInternalValue] = createSignal(options.defaultValue);
+    const getValue = () => {
+        if (typeof options.value === "function") {
+            return options.value();
+        }
+        return options.value;
+    };
+    const isControlled = () => getValue() !== undefined;
+    const value = () => {
+        const controlledVal = getValue();
+        return controlledVal !== undefined ? controlledVal : internalValue();
+    };
+    const setValue = (nextValue) => {
+        const current = value();
+        const resolvedNext = typeof nextValue === "function"
+            ? nextValue(current)
+            : nextValue;
+        if (!isControlled()) {
+            setInternalValue(resolvedNext);
+        }
+        if (typeof options.onChange === "function") {
+            options.onChange(resolvedNext);
+        }
+    };
+    return [value, setValue];
+}
+//# sourceMappingURL=create-controllable-signal.js.map

package/dist/hooks/create-controllable-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-controllable-signal.js","sourceRoot":"","sources":["../../src/hooks/create-controllable-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,UAAU,CAAC;AAWvD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA2C;IAE3C,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,YAAY,CACpD,OAAO,CAAC,YAAY,CACrB,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAkB,EAAE;QACnC,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACxC,OAAQ,OAAO,CAAC,KAAiC,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,SAAS,CAAC;IAEpD,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,MAAM,aAAa,GAAG,QAAQ,EAAE,CAAC;QACjC,OAAO,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACvE,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,SAA2C,EAAE,EAAE;QAC/D,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;QACxB,MAAM,YAAY,GAChB,OAAO,SAAS,KAAK,UAAU;YAC7B,CAAC,CAAE,SAAwC,CAAC,OAAO,CAAC;YACpD,CAAC,CAAC,SAAS,CAAC;QAEhB,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YACpB,gBAAgB,CAAC,YAAmB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACjC,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAC3B,CAAC"}

package/dist/hooks/create-focus-trap.d.ts

@@ -0,0 +1,15 @@
+import { type Accessor } from "solid-js";
+export interface CreateFocusTrapOptions {
+    /** Whether focus trap is actively enabled. Defaults to true. */
+    enabled?: boolean | Accessor<boolean>;
+    /** Whether to return focus to previously focused element on cleanup. Defaults to true. */
+    returnFocusOnDeactivate?: boolean;
+}
+/**
+ * SolidJS reactive primitive for trapping keyboard focus inside target container element.
+ *
+ * @param target Target element or accessor returning HTML element.
+ * @param options Configuration options for focus trap behavior.
+ */
+export declare function createFocusTrap(target: HTMLElement | Accessor<HTMLElement | undefined>, options?: CreateFocusTrapOptions): void;
+//# sourceMappingURL=create-focus-trap.d.ts.map

package/dist/hooks/create-focus-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-focus-trap.d.ts","sourceRoot":"","sources":["../../src/hooks/create-focus-trap.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtC,0FAA0F;IAC1F,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,EACvD,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAwEN"}

package/dist/hooks/create-focus-trap.js

@@ -0,0 +1,72 @@
+import { createEffect, onCleanup } from "solid-js";
+const FOCUSABLE_SELECTOR = 'a[href], area[href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), button:not([disabled]), iframe, object, embed, [tabindex]:not([tabindex="-1"]), [contenteditable]';
+/**
+ * SolidJS reactive primitive for trapping keyboard focus inside target container element.
+ *
+ * @param target Target element or accessor returning HTML element.
+ * @param options Configuration options for focus trap behavior.
+ */
+export function createFocusTrap(target, options = {}) {
+    const getTarget = () => {
+        if (typeof target === "function") {
+            return target();
+        }
+        return target;
+    };
+    const isEnabled = () => {
+        if (typeof options.enabled === "function") {
+            return options.enabled();
+        }
+        return options.enabled ?? true;
+    };
+    createEffect(() => {
+        if (typeof window === "undefined" || !isEnabled())
+            return;
+        const container = getTarget();
+        if (!container)
+            return;
+        const previousActiveElement = document.activeElement;
+        const getFocusableElements = () => {
+            return Array.from(container.querySelectorAll(FOCUSABLE_SELECTOR)).filter((el) => el.offsetWidth > 0 || el.offsetHeight > 0 || el.getClientRects().length > 0);
+        };
+        const focusable = getFocusableElements();
+        if (focusable.length > 0) {
+            focusable[0].focus();
+        }
+        else {
+            container.focus();
+        }
+        const handleKeyDown = (event) => {
+            if (event.key !== "Tab")
+                return;
+            const elements = getFocusableElements();
+            if (elements.length === 0) {
+                event.preventDefault();
+                return;
+            }
+            const firstElement = elements[0];
+            const lastElement = elements[elements.length - 1];
+            const activeElement = document.activeElement;
+            if (event.shiftKey) {
+                if (activeElement === firstElement || !container.contains(activeElement)) {
+                    event.preventDefault();
+                    lastElement.focus();
+                }
+            }
+            else {
+                if (activeElement === lastElement || !container.contains(activeElement)) {
+                    event.preventDefault();
+                    firstElement.focus();
+                }
+            }
+        };
+        document.addEventListener("keydown", handleKeyDown);
+        onCleanup(() => {
+            document.removeEventListener("keydown", handleKeyDown);
+            if (options.returnFocusOnDeactivate !== false && previousActiveElement) {
+                previousActiveElement.focus?.();
+            }
+        });
+    });
+}
+//# sourceMappingURL=create-focus-trap.js.map

package/dist/hooks/create-focus-trap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-focus-trap.js","sourceRoot":"","sources":["../../src/hooks/create-focus-trap.ts"],"names":[],"mappings":"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"}

package/dist/hooks/create-keybindings.d.ts

@@ -0,0 +1,34 @@
+import { type Accessor } from "solid-js";
+export interface KeybindingDefinition {
+    /** Key combination string, e.g. "meta+k", "ctrl+k", "Escape", "Shift+Enter" */
+    key: string | string[];
+    /** Callback handler invoked when the key combination is triggered */
+    handler: (event: KeyboardEvent) => void;
+    /** Whether to prevent default browser action. Defaults to false. */
+    preventDefault?: boolean;
+    /** Whether to stop event propagation. Defaults to false. */
+    stopPropagation?: boolean;
+}
+export interface CreateKeybindingsOptions {
+    /** Event target to attach listener to. Defaults to window. */
+    target?: HTMLElement | Window | Accessor<HTMLElement | Window | undefined>;
+    /** Event type: "keydown" (default) or "keyup" */
+    eventType?: "keydown" | "keyup";
+    /** Whether keybinding listeners are active. Defaults to true. */
+    enabled?: boolean | Accessor<boolean>;
+}
+/**
+ * SolidJS reactive primitive for listening to single or multiple keyboard shortcuts.
+ *
+ * @param bindings Array of keybinding definitions or single definition object.
+ * @param options Configuration options including target, event type, and enabled state.
+ */
+export declare function createKeybindings(bindings: KeybindingDefinition | KeybindingDefinition[], options?: CreateKeybindingsOptions): void;
+/**
+ * SolidJS primitive specialized for handling Escape key presses.
+ *
+ * @param handler Callback invoked when Escape key is pressed.
+ * @param options Keybindings options.
+ */
+export declare function createEscapeKey(handler: (event: KeyboardEvent) => void, options?: CreateKeybindingsOptions): void;
+//# sourceMappingURL=create-keybindings.d.ts.map

package/dist/hooks/create-keybindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-keybindings.d.ts","sourceRoot":"","sources":["../../src/hooks/create-keybindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE7D,MAAM,WAAW,oBAAoB;IACnC,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,qEAAqE;IACrE,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3E,iDAAiD;IACjD,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAChC,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACvC;AA4CD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,EACvD,OAAO,GAAE,wBAA6B,GACrC,IAAI,CAsDN;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EACvC,OAAO,GAAE,wBAA6B,GACrC,IAAI,CASN"}

package/dist/hooks/create-keybindings.js

@@ -0,0 +1,113 @@
+import { onMount, onCleanup } from "solid-js";
+/**
+ * Normalizes key string into standardized combination signature (e.g. "ctrl+meta+k").
+ */
+function normalizeKeyCombination(keyStr) {
+    const parts = keyStr.toLowerCase().split("+").map((p) => p.trim());
+    const modifiers = new Set();
+    let mainKey = "";
+    for (const part of parts) {
+        if (part === "meta" || part === "cmd" || part === "command" || part === "⌘") {
+            modifiers.add("meta");
+        }
+        else if (part === "ctrl" || part === "control") {
+            modifiers.add("ctrl");
+        }
+        else if (part === "alt" || part === "option" || part === "⌥") {
+            modifiers.add("alt");
+        }
+        else if (part === "shift" || part === "⇧") {
+            modifiers.add("shift");
+        }
+        else {
+            mainKey = part;
+        }
+    }
+    const sortedMods = Array.from(modifiers).sort();
+    return [...sortedMods, mainKey].join("+");
+}
+/**
+ * Checks if a KeyboardEvent matches a normalized key combination.
+ */
+function isEventMatch(event, targetCombination) {
+    const modifiers = new Set();
+    if (event.metaKey)
+        modifiers.add("meta");
+    if (event.ctrlKey)
+        modifiers.add("ctrl");
+    if (event.altKey)
+        modifiers.add("alt");
+    if (event.shiftKey)
+        modifiers.add("shift");
+    const mainKey = event.key.toLowerCase();
+    const eventCombination = [...Array.from(modifiers).sort(), mainKey].join("+");
+    return eventCombination === targetCombination;
+}
+/**
+ * SolidJS reactive primitive for listening to single or multiple keyboard shortcuts.
+ *
+ * @param bindings Array of keybinding definitions or single definition object.
+ * @param options Configuration options including target, event type, and enabled state.
+ */
+export function createKeybindings(bindings, options = {}) {
+    const bindingList = Array.isArray(bindings) ? bindings : [bindings];
+    const isEnabled = () => {
+        if (typeof options.enabled === "function") {
+            return options.enabled();
+        }
+        return options.enabled ?? true;
+    };
+    const getTargetElement = () => {
+        if (!options.target) {
+            return typeof window !== "undefined" ? window : undefined;
+        }
+        if (typeof options.target === "function") {
+            return options.target();
+        }
+        return options.target;
+    };
+    const handleKeyboardEvent = (event) => {
+        if (!isEnabled())
+            return;
+        for (const binding of bindingList) {
+            const keys = Array.isArray(binding.key) ? binding.key : [binding.key];
+            for (const keyCombo of keys) {
+                const normalizedCombo = normalizeKeyCombination(keyCombo);
+                if (isEventMatch(event, normalizedCombo)) {
+                    if (binding.preventDefault) {
+                        event.preventDefault();
+                    }
+                    if (binding.stopPropagation) {
+                        event.stopPropagation();
+                    }
+                    binding.handler(event);
+                    break;
+                }
+            }
+        }
+    };
+    onMount(() => {
+        const target = getTargetElement();
+        if (!target)
+            return;
+        const eventType = options.eventType || "keydown";
+        target.addEventListener(eventType, handleKeyboardEvent);
+        onCleanup(() => {
+            target.removeEventListener(eventType, handleKeyboardEvent);
+        });
+    });
+}
+/**
+ * SolidJS primitive specialized for handling Escape key presses.
+ *
+ * @param handler Callback invoked when Escape key is pressed.
+ * @param options Keybindings options.
+ */
+export function createEscapeKey(handler, options = {}) {
+    createKeybindings({
+        key: "Escape",
+        handler,
+        preventDefault: true,
+    }, options);
+}
+//# sourceMappingURL=create-keybindings.js.map

package/dist/hooks/create-keybindings.js.map

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

package/dist/hooks/create-lock-scroll.d.ts

@@ -0,0 +1,20 @@
+import { type Accessor } from "solid-js";
+export interface CreateLockScrollOptions {
+    /** Target element to lock scroll for. Defaults to document.body. */
+    target?: HTMLElement | Accessor<HTMLElement | undefined>;
+    /** Initial lock state. Defaults to true. */
+    enabled?: boolean | Accessor<boolean>;
+}
+export interface CreateLockScrollReturn {
+    /** Accessor indicating whether scroll is currently locked */
+    isLocked: Accessor<boolean>;
+    /** Setter function to programmatically lock or unlock scroll */
+    setLocked: (locked: boolean) => void;
+}
+/**
+ * SolidJS reactive primitive for locking target element (or document.body) scroll.
+ *
+ * @param options Configuration options including target element and initial enabled state.
+ */
+export declare function createLockScroll(options?: CreateLockScrollOptions): CreateLockScrollReturn;
+//# sourceMappingURL=create-lock-scroll.d.ts.map

package/dist/hooks/create-lock-scroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-lock-scroll.d.ts","sourceRoot":"","sources":["../../src/hooks/create-lock-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IACzD,4CAA4C;IAC5C,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5B,gEAAgE;IAChE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,sBAAsB,CA2E9F"}

package/dist/hooks/create-lock-scroll.js

@@ -0,0 +1,77 @@
+import { createEffect, createSignal, onCleanup } from "solid-js";
+/**
+ * SolidJS reactive primitive for locking target element (or document.body) scroll.
+ *
+ * @param options Configuration options including target element and initial enabled state.
+ */
+export function createLockScroll(options = {}) {
+    const [internalLocked, setInternalLocked] = createSignal(false);
+    const getTarget = () => {
+        if (typeof window === "undefined")
+            return undefined;
+        if (!options.target) {
+            return document.body;
+        }
+        if (typeof options.target === "function") {
+            return options.target();
+        }
+        return options.target;
+    };
+    const isEnabled = () => {
+        if (typeof options.enabled === "function") {
+            return options.enabled();
+        }
+        return options.enabled ?? true;
+    };
+    let originalOverflow;
+    const applyLock = (element) => {
+        if (originalOverflow === undefined) {
+            originalOverflow = element.style.overflow;
+        }
+        element.style.overflow = "hidden";
+        setInternalLocked(true);
+    };
+    const removeLock = (element) => {
+        if (originalOverflow !== undefined) {
+            element.style.overflow = originalOverflow;
+            originalOverflow = undefined;
+        }
+        else {
+            element.style.overflow = "";
+        }
+        setInternalLocked(false);
+    };
+    createEffect(() => {
+        const el = getTarget();
+        if (!el)
+            return;
+        if (isEnabled()) {
+            applyLock(el);
+        }
+        else {
+            removeLock(el);
+        }
+    });
+    onCleanup(() => {
+        const el = getTarget();
+        if (el) {
+            removeLock(el);
+        }
+    });
+    const setLocked = (locked) => {
+        const el = getTarget();
+        if (!el)
+            return;
+        if (locked) {
+            applyLock(el);
+        }
+        else {
+            removeLock(el);
+        }
+    };
+    return {
+        isLocked: internalLocked,
+        setLocked,
+    };
+}
+//# sourceMappingURL=create-lock-scroll.js.map

package/dist/hooks/create-lock-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-lock-scroll.js","sourceRoot":"","sources":["../../src/hooks/create-lock-scroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AAgBhF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAO,GAA4B,EAAE;IACpE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAEhE,MAAM,SAAS,GAAG,GAA4B,EAAE;QAC9C,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,SAAS,CAAC;QAEpD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YACzC,OAAQ,OAAO,CAAC,MAA4C,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,GAAY,EAAE;QAC9B,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;IACjC,CAAC,CAAC;IAEF,IAAI,gBAAoC,CAAC;IAEzC,MAAM,SAAS,GAAG,CAAC,OAAoB,EAAE,EAAE;QACzC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC5C,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAClC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,OAAoB,EAAE,EAAE;QAC1C,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,gBAAgB,CAAC;YAC1C,gBAAgB,GAAG,SAAS,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC;QAC9B,CAAC;QACD,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC,CAAC;IAEF,YAAY,CAAC,GAAG,EAAE;QAChB,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,SAAS,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,IAAI,EAAE,EAAE,CAAC;YACP,UAAU,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,MAAe,EAAE,EAAE;QACpC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE;YAAE,OAAO;QAEhB,IAAI,MAAM,EAAE,CAAC;YACX,SAAS,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,cAAc;QACxB,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/hooks/create-resize-observer.d.ts

@@ -0,0 +1,27 @@
+import { type Accessor } from "solid-js";
+export interface CreateResizeObserverOptions extends ResizeObserverOptions {
+    /** Whether the observer is active. Defaults to true. */
+    enabled?: boolean | Accessor<boolean>;
+}
+/**
+ * SolidJS reactive primitive for observing element size changes via ResizeObserver.
+ *
+ * @param target Target element or accessor returning HTML element.
+ * @param callback Observer callback invoked on element resize events.
+ * @param options ResizeObserver options (box, enabled).
+ */
+export declare function createResizeObserver(target: HTMLElement | Accessor<HTMLElement | undefined>, callback: ResizeObserverCallback, options?: CreateResizeObserverOptions): void;
+export interface CreateElementSizeReturn {
+    /** Accessor for element width in pixels */
+    width: Accessor<number>;
+    /** Accessor for element height in pixels */
+    height: Accessor<number>;
+}
+/**
+ * SolidJS reactive primitive returning width and height accessors for a target HTML element.
+ *
+ * @param target Target element or accessor returning HTML element.
+ * @param options ResizeObserver options.
+ */
+export declare function createElementSize(target: HTMLElement | Accessor<HTMLElement | undefined>, options?: CreateResizeObserverOptions): CreateElementSizeReturn;
+//# sourceMappingURL=create-resize-observer.d.ts.map

package/dist/hooks/create-resize-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-resize-observer.d.ts","sourceRoot":"","sources":["../../src/hooks/create-resize-observer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyC,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEhF,MAAM,WAAW,2BAA4B,SAAQ,qBAAqB;IACxE,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;CACvC;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,EACvD,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE,2BAAgC,GACxC,IAAI,CAgCN;AAED,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxB,4CAA4C;IAC5C,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC,WAAW,GAAG,SAAS,CAAC,EACvD,OAAO,GAAE,2BAAgC,GACxC,uBAAuB,CAoBzB"}