@fivem-nui/svelte 0.0.0-stage → 1.0.0

package/dist/actions/layer/layer.js

@@ -0,0 +1,118 @@
+import { nuiFocusTrap } from '../focusTrap';
+import { toLayerOptions } from './types';
+import { pushLayer, removeLayer, getTopLayer, nextLayerId } from './layerStack';
+/**
+ * Managing an overlay layer in FiveM NUI.
+ *
+ * Coordinates:
+ * - **Escape key**: Traverses the layer stack top-to-bottom. The topmost active layer that handles Escape
+ *   receives the event and dismisses. If the topmost layer disables Escape (`onEscape: false`),
+ *   lower layers can handle it.
+ * - **Outside click**: Evaluates strictly the topmost active layer. If the topmost layer disables outside
+ *   clicks (`onClickOutside: false`), clicks outside are blocked and do NOT fall through to underlying layers,
+ *   preserving modal barrier isolation.
+ * - **Focus trap**: Integrates `nuiFocusTrap` synchronized with layer priority so focus containment and Tab
+ *   navigation are enforced by the topmost layer even when layers have varying priorities.
+ * - **Portal integration**: `allowOutside` allows portaled children (selects, datepickers, tooltips)
+ *   without triggering outside clicks or breaking focus containment.
+ *
+ * @param node - The DOM element attaching the layer action.
+ * @param parameter - Dismissal callback function or layer configuration options object.
+ *
+ * @example
+ * ```svelte
+ * <div use:nuiLayer={() => (isOpen = false)}>...</div>
+ * <div use:nuiLayer={{ onDismiss: close, allowOutside: '.portal-menu' }}>...</div>
+ * ```
+ */
+export const nuiLayer = (node, parameter) => {
+    let currentParam = parameter;
+    let active = false;
+    let trapAction = null;
+    const id = toLayerOptions(parameter).id ?? nextLayerId();
+    function getOptions() {
+        return toLayerOptions(currentParam);
+    }
+    function isEnabled() {
+        const opts = getOptions();
+        const { enabled } = opts;
+        return typeof enabled === 'function' ? enabled() : (enabled ?? true);
+    }
+    const instance = {
+        id,
+        node,
+        getOptions
+    };
+    function syncFocusTrap() {
+        const opts = getOptions();
+        const enabled = isEnabled();
+        if (!enabled || opts.trapFocus === false) {
+            if (trapAction) {
+                trapAction.destroy?.();
+                trapAction = null;
+            }
+            return;
+        }
+        const trapConfig = typeof opts.trapFocus === 'object' ? { ...opts.trapFocus } : {};
+        if (trapConfig.allowOutside === undefined && opts.allowOutside !== undefined) {
+            trapConfig.allowOutside = opts.allowOutside;
+        }
+        if (trapConfig.initialFocus === undefined && opts.initialFocus !== undefined) {
+            trapConfig.initialFocus = opts.initialFocus;
+        }
+        if (trapConfig.returnFocus === undefined && opts.returnFocus !== undefined) {
+            trapConfig.returnFocus = opts.returnFocus;
+        }
+        if (trapConfig.autofocus === undefined && opts.autofocus !== undefined) {
+            trapConfig.autofocus = opts.autofocus;
+        }
+        trapConfig.enabled = enabled;
+        trapConfig.isTopmost = () => getTopLayer() === instance;
+        if (!trapAction) {
+            trapAction = nuiFocusTrap(node, trapConfig);
+        }
+        else {
+            trapAction.update?.(trapConfig);
+        }
+    }
+    function setup() {
+        if (active)
+            return;
+        active = true;
+        pushLayer(instance);
+        syncFocusTrap();
+    }
+    function deactivate() {
+        if (!active)
+            return;
+        active = false;
+        if (trapAction) {
+            trapAction.destroy?.();
+            trapAction = null;
+        }
+        removeLayer(instance);
+    }
+    if (isEnabled()) {
+        setup();
+    }
+    return {
+        update(newParam) {
+            const wasEnabled = active;
+            currentParam = newParam;
+            const nowEnabled = isEnabled();
+            if (!wasEnabled && nowEnabled) {
+                setup();
+            }
+            else if (wasEnabled && !nowEnabled) {
+                deactivate();
+            }
+            else if (nowEnabled) {
+                syncFocusTrap();
+            }
+        },
+        destroy() {
+            deactivate();
+        }
+    };
+};
+//# sourceMappingURL=layer.js.map

package/dist/actions/layer/layer.js.map

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

package/dist/actions/layer/layerStack.d.ts

@@ -0,0 +1,10 @@
+import { type LayerInstance } from './types';
+export declare function nextLayerId(): string;
+export declare function pushLayer(instance: LayerInstance): void;
+export declare function removeLayer(instance: LayerInstance): void;
+export declare function getLayerStack(): readonly LayerInstance[];
+export declare function resetLayerStack(): void;
+export declare function getTopLayer(): LayerInstance | undefined;
+export declare function ensureGlobalListeners(): void;
+export declare function cleanupGlobalListeners(): void;
+//# sourceMappingURL=layerStack.d.ts.map

package/dist/actions/layer/layerStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layerStack.d.ts","sourceRoot":"","sources":["../../../src/actions/layer/layerStack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAcpE,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAGvD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAMzD;AAED,wBAAgB,aAAa,IAAI,SAAS,aAAa,EAAE,CAExD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAQD,wBAAgB,WAAW,IAAI,aAAa,GAAG,SAAS,CAWvD;AA6FD,wBAAgB,qBAAqB,IAAI,IAAI,CAW5C;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C"}

package/dist/actions/layer/layerStack.js

@@ -0,0 +1,153 @@
+import { NuiLayerDismissReason } from './types';
+import { isNodeAllowedOutside } from '../focusTrap';
+import { resolveElement } from '../clickOutside';
+/**
+ * Global stack of active overlay layers.
+ * Manages hierarchical Escape key and outside click handling across modals, dialogs,
+ * drawers, and portaled overlays in FiveM NUI.
+ */
+const layerStack = [];
+let globalController = null;
+let layerIdCounter = 0;
+export function nextLayerId() {
+    return `nui-layer-${++layerIdCounter}`;
+}
+export function pushLayer(instance) {
+    layerStack.push(instance);
+    ensureGlobalListeners();
+}
+export function removeLayer(instance) {
+    const idx = layerStack.findIndex((l) => l === instance);
+    if (idx !== -1) {
+        layerStack.splice(idx, 1);
+    }
+    cleanupGlobalListeners();
+}
+export function getLayerStack() {
+    return [...layerStack];
+}
+export function resetLayerStack() {
+    layerStack.length = 0;
+    cleanupGlobalListeners();
+}
+function getSortedStack() {
+    return [...layerStack].sort((a, b) => {
+        return (a.getOptions().priority ?? 0) - (b.getOptions().priority ?? 0);
+    });
+}
+export function getTopLayer() {
+    const sorted = getSortedStack();
+    for (let i = sorted.length - 1; i >= 0; i--) {
+        const layer = sorted[i];
+        const opts = layer.getOptions();
+        const isEnabled = typeof opts.enabled === 'function' ? opts.enabled() : (opts.enabled ?? true);
+        if (isEnabled && layer.node.isConnected) {
+            return layer;
+        }
+    }
+    return undefined;
+}
+function onGlobalKeyDown(event) {
+    if (event.key !== 'Escape' || event.isComposing)
+        return;
+    if (layerStack.length === 0)
+        return;
+    const sorted = getSortedStack();
+    // Find the topmost active layer that handles Escape
+    for (let i = sorted.length - 1; i >= 0; i--) {
+        const layer = sorted[i];
+        const opts = layer.getOptions();
+        const isEnabled = typeof opts.enabled === 'function' ? opts.enabled() : (opts.enabled ?? true);
+        if (!isEnabled || !layer.node.isConnected)
+            continue;
+        const handlesEscape = opts.onEscape !== false &&
+            (typeof opts.onEscape === 'function' || typeof opts.onDismiss === 'function');
+        if (!handlesEscape)
+            continue;
+        if ((opts.ignoreRepeat ?? true) && event.repeat) {
+            if (opts.preventEscapeDefault ?? true) {
+                event.preventDefault();
+            }
+            return;
+        }
+        if (opts.preventEscapeDefault ?? true) {
+            event.preventDefault();
+        }
+        if (opts.stopEscapePropagation) {
+            event.stopPropagation();
+        }
+        try {
+            if (typeof opts.onEscape === 'function') {
+                opts.onEscape(event);
+            }
+            else if (typeof opts.onDismiss === 'function') {
+                opts.onDismiss(NuiLayerDismissReason.Escape);
+            }
+        }
+        catch (err) {
+            console.error('[NuiLayer] Error in onEscape/onDismiss callback:', err);
+        }
+        // Only the topmost handling layer responds to Escape
+        return;
+    }
+}
+function onGlobalPointerDown(event) {
+    if (event.button !== 0 || layerStack.length === 0)
+        return;
+    const topLayer = getTopLayer();
+    if (!topLayer)
+        return;
+    const opts = topLayer.getOptions();
+    const handlesOutside = opts.onClickOutside !== false &&
+        (typeof opts.onClickOutside === 'function' || typeof opts.onDismiss === 'function');
+    if (!handlesOutside)
+        return;
+    const path = event.composedPath();
+    // 1. Click inside top layer node
+    if (path.includes(topLayer.node))
+        return;
+    // 2. Click inside any allowed outside target (e.g. portaled dropdown)
+    if (opts.allowOutside && isNodeAllowedOutside(event.target, opts.allowOutside)) {
+        return;
+    }
+    // 3. Click inside any ignoreOutside target (e.g. trigger button)
+    if (opts.ignoreOutside) {
+        for (const item of opts.ignoreOutside) {
+            const el = resolveElement(item);
+            if (el && path.includes(el))
+                return;
+        }
+    }
+    // Trigger outside click for the topmost layer only
+    try {
+        if (typeof opts.onClickOutside === 'function') {
+            opts.onClickOutside(event);
+        }
+        else if (typeof opts.onDismiss === 'function') {
+            opts.onDismiss(NuiLayerDismissReason.Outside);
+        }
+    }
+    catch (err) {
+        console.error('[NuiLayer] Error in onClickOutside/onDismiss callback:', err);
+    }
+}
+export function ensureGlobalListeners() {
+    if (globalController || layerStack.length === 0)
+        return;
+    globalController = new AbortController();
+    document.addEventListener('keydown', onGlobalKeyDown, {
+        capture: true,
+        signal: globalController.signal
+    });
+    document.addEventListener('pointerdown', onGlobalPointerDown, {
+        capture: true,
+        signal: globalController.signal
+    });
+}
+export function cleanupGlobalListeners() {
+    if (layerStack.length === 0 && globalController) {
+        globalController.abort();
+        globalController = null;
+    }
+}
+//# sourceMappingURL=layerStack.js.map

package/dist/actions/layer/layerStack.js.map

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

package/dist/actions/layer/types.d.ts

@@ -0,0 +1,105 @@
+import type { NuiFocusTrapOptions, FocusTrapAllowOutside } from '../focusTrap';
+import type { ClickOutsideTarget } from '../clickOutside';
+export declare enum NuiLayerDismissReason {
+    Escape = "escape",
+    Outside = "outside"
+}
+export interface NuiLayerOptions {
+    /**
+     * Unique identifier for the layer.
+     * Auto-generated if omitted.
+     */
+    id?: string;
+    /**
+     * Whether the layer is active in the layer stack.
+     * Accepts a boolean or a reactive getter `() => boolean`.
+     * @defaultValue true
+     */
+    enabled?: boolean | (() => boolean);
+    /**
+     * Unified callback invoked when the layer should be dismissed
+     * (either via Escape key or outside click while topmost).
+     */
+    onDismiss?: (reason: NuiLayerDismissReason) => void;
+    /**
+     * Specific callback invoked when the Escape key is pressed while this layer is topmost.
+     * Set to `false` to disable Escape handling for this layer.
+     */
+    onEscape?: ((event: KeyboardEvent) => void) | boolean;
+    /**
+     * Specific callback invoked when a click occurs outside this layer while it is topmost.
+     * Set to `false` to disable outside click handling for this layer.
+     */
+    onClickOutside?: ((event: PointerEvent) => void) | boolean;
+    /**
+     * Focus trap configuration for this layer:
+     * - `true`: enables default focus trap (default)
+     * - `false`: disables focus trap
+     * - `NuiFocusTrapOptions`: custom focus trap options (initialFocus, returnFocus, autofocus, etc.)
+     *
+     * @remarks
+     * `nuiLayer` automatically controls and overrides `trapFocus.isTopmost` so focus containment
+     * is synchronized strictly with layer priority (`getTopLayer() === instance`).
+     * @defaultValue true
+     */
+    trapFocus?: boolean | NuiFocusTrapOptions;
+    /**
+     * Elements, selectors, or getters outside the container that are permitted.
+     * Shared between focus trap (won't redirect Tab from them) and click-outside (won't dismiss on them).
+     * Essential for portaled child elements (e.g. dropdowns, date pickers, tooltips).
+     */
+    allowOutside?: FocusTrapAllowOutside;
+    /**
+     * Additional elements, selectors, or getters to ignore specifically for click-outside detection
+     * (e.g. the toggle or trigger button that opened this layer).
+     */
+    ignoreOutside?: ClickOutsideTarget[];
+    /**
+     * Custom element, selector or getter to receive initial focus upon activation.
+     * Shorthand for `trapFocus.initialFocus`.
+     */
+    initialFocus?: HTMLElement | string | (() => HTMLElement | null | undefined);
+    /**
+     * Whether to restore focus to previously focused element upon layer deactivation.
+     * Shorthand for `trapFocus.returnFocus`.
+     * @defaultValue true
+     */
+    returnFocus?: boolean | HTMLElement;
+    /**
+     * Whether to automatically move focus inside the layer on activation.
+     * Shorthand for `trapFocus.autofocus`.
+     * @defaultValue true
+     */
+    autofocus?: boolean;
+    /**
+     * Priority/z-index override. Layers with higher priority are considered on top
+     * regardless of activation order. Equal priority layers follow activation order.
+     * @defaultValue 0
+     */
+    priority?: number;
+    /**
+     * Whether to ignore repeated keydown events fired while holding the Escape key down.
+     * If `true`, holding Escape will not dismiss subsequent layers in rapid succession.
+     * @defaultValue true
+     */
+    ignoreRepeat?: boolean;
+    /**
+     * Whether to call `event.preventDefault()` when Escape is handled.
+     * @defaultValue true
+     */
+    preventEscapeDefault?: boolean;
+    /**
+     * Whether to call `event.stopPropagation()` when Escape is handled.
+     * Defaults to `false` to avoid breaking uncoordinated parent listeners on window/document.
+     * @defaultValue false
+     */
+    stopEscapePropagation?: boolean;
+}
+export type NuiLayerInput = ((reason: NuiLayerDismissReason) => void) | NuiLayerOptions | undefined;
+export declare function toLayerOptions(input: NuiLayerInput): NuiLayerOptions;
+export interface LayerInstance {
+    id: string;
+    node: HTMLElement;
+    getOptions: () => NuiLayerOptions;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/layer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/actions/layer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,oBAAY,qBAAqB;IAC/B,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAEpD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC;IAEtD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAE1C;;;;OAIG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAE7E;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAEpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GACrB,CAAC,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC,GACzC,eAAe,GACf,SAAS,CAAC;AAEd,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAMpE;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,eAAe,CAAC;CACnC"}

package/dist/actions/layer/types.js

@@ -0,0 +1,14 @@
+export var NuiLayerDismissReason;
+(function (NuiLayerDismissReason) {
+    NuiLayerDismissReason["Escape"] = "escape";
+    NuiLayerDismissReason["Outside"] = "outside";
+})(NuiLayerDismissReason || (NuiLayerDismissReason = {}));
+export function toLayerOptions(input) {
+    if (!input)
+        return { enabled: true };
+    if (typeof input === 'function') {
+        return { enabled: true, onDismiss: input };
+    }
+    return input;
+}
+//# sourceMappingURL=types.js.map

package/dist/actions/layer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/actions/layer/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,0CAAiB,CAAA;IACjB,4CAAmB,CAAA;AACrB,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAiHD,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/actions/layer.d.ts

@@ -0,0 +1,133 @@
+import type { Action } from 'svelte/action';
+import { type NuiFocusTrapOptions, type FocusTrapAllowOutside } from './focusTrap';
+import { type ClickOutsideTarget } from './clickOutside';
+export declare enum NuiLayerDismissReason {
+    Escape = "escape",
+    Outside = "outside"
+}
+export interface NuiLayerOptions {
+    /**
+     * Unique identifier for the layer.
+     * Auto-generated if omitted.
+     */
+    id?: string;
+    /**
+     * Whether the layer is active in the layer stack.
+     * Accepts a boolean or a reactive getter `() => boolean`.
+     * @defaultValue true
+     */
+    enabled?: boolean | (() => boolean);
+    /**
+     * Unified callback invoked when the layer should be dismissed
+     * (either via Escape key or outside click while topmost).
+     */
+    onDismiss?: (reason: NuiLayerDismissReason) => void;
+    /**
+     * Specific callback invoked when the Escape key is pressed while this layer is topmost.
+     * Set to `false` to disable Escape handling for this layer.
+     */
+    onEscape?: ((event: KeyboardEvent) => void) | boolean;
+    /**
+     * Specific callback invoked when a click occurs outside this layer while it is topmost.
+     * Set to `false` to disable outside click handling for this layer.
+     */
+    onClickOutside?: ((event: PointerEvent) => void) | boolean;
+    /**
+     * Focus trap configuration for this layer:
+     * - `true`: enables default focus trap (default)
+     * - `false`: disables focus trap
+     * - `NuiFocusTrapOptions`: custom focus trap options (initialFocus, returnFocus, autofocus, etc.)
+     *
+     * @remarks
+     * `nuiLayer` automatically controls and overrides `trapFocus.isTopmost` so focus containment
+     * is synchronized strictly with layer priority (`getTopLayer() === instance`).
+     * @defaultValue true
+     */
+    trapFocus?: boolean | NuiFocusTrapOptions;
+    /**
+     * Elements, selectors, or getters outside the container that are permitted.
+     * Shared between focus trap (won't redirect Tab from them) and click-outside (won't dismiss on them).
+     * Essential for portaled child elements (e.g. dropdowns, date pickers, tooltips).
+     */
+    allowOutside?: FocusTrapAllowOutside;
+    /**
+     * Additional elements, selectors, or getters to ignore specifically for click-outside detection
+     * (e.g. the toggle or trigger button that opened this layer).
+     */
+    ignoreOutside?: ClickOutsideTarget[];
+    /**
+     * Custom element, selector or getter to receive initial focus upon activation.
+     * Shorthand for `trapFocus.initialFocus`.
+     */
+    initialFocus?: HTMLElement | string | (() => HTMLElement | null | undefined);
+    /**
+     * Whether to restore focus to previously focused element upon layer deactivation.
+     * Shorthand for `trapFocus.returnFocus`.
+     * @defaultValue true
+     */
+    returnFocus?: boolean | HTMLElement;
+    /**
+     * Whether to automatically move focus inside the layer on activation.
+     * Shorthand for `trapFocus.autofocus`.
+     * @defaultValue true
+     */
+    autofocus?: boolean;
+    /**
+     * Priority/z-index override. Layers with higher priority are considered on top
+     * regardless of activation order. Equal priority layers follow activation order.
+     * @defaultValue 0
+     */
+    priority?: number;
+    /**
+     * Whether to ignore repeated keydown events fired while holding the Escape key down.
+     * If `true`, holding Escape will not dismiss subsequent layers in rapid succession.
+     * @defaultValue true
+     */
+    ignoreRepeat?: boolean;
+    /**
+     * Whether to call `event.preventDefault()` when Escape is handled.
+     * @defaultValue true
+     */
+    preventEscapeDefault?: boolean;
+    /**
+     * Whether to call `event.stopPropagation()` when Escape is handled.
+     * Defaults to `false` to avoid breaking uncoordinated parent listeners on window/document.
+     * @defaultValue false
+     */
+    stopEscapePropagation?: boolean;
+}
+export type NuiLayerInput = ((reason: NuiLayerDismissReason) => void) | NuiLayerOptions | undefined;
+export declare function toLayerOptions(input: NuiLayerInput): NuiLayerOptions;
+export interface LayerInstance {
+    id: string;
+    node: HTMLElement;
+    getOptions: () => NuiLayerOptions;
+}
+export declare function getLayerStack(): readonly LayerInstance[];
+export declare function resetLayerStack(): void;
+export declare function getTopLayer(): LayerInstance | undefined;
+/**
+ * Svelte Action for managing an overlay layer in FiveM NUI.
+ *
+ * Coordinates:
+ * - **Escape key**: Traverses the layer stack top-to-bottom. The topmost active layer that handles Escape
+ *   receives the event and dismisses. If the topmost layer disables Escape (`onEscape: false`),
+ *   lower layers can handle it.
+ * - **Outside click**: Evaluates strictly the topmost active layer. If the topmost layer disables outside
+ *   clicks (`onClickOutside: false`), clicks outside are blocked and do NOT fall through to underlying layers,
+ *   preserving modal barrier isolation.
+ * - **Focus trap**: Integrates `nuiFocusTrap` synchronized with layer priority so focus containment and Tab
+ *   navigation are enforced by the topmost layer even when layers have varying priorities.
+ * - **Portal integration**: `allowOutside` allows portaled children (selects, datepickers, tooltips)
+ *   without triggering outside clicks or breaking focus containment.
+ * @param node - The DOM element attaching the layer action.
+ * @param parameter - Dismissal callback function or layer configuration options object.
+ *
+ * @example
+ * ```svelte
+ * <div use:nuiLayer={() => (isOpen = false)}>...</div>
+ * <div use:nuiLayer={{ onDismiss: close, allowOutside: '.portal-menu' }}>...</div>
+ * ```
+ */
+export declare const nuiLayer: Action<HTMLElement, NuiLayerInput>;
+//# sourceMappingURL=layer.d.ts.map

package/dist/actions/layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../src/actions/layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAE3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,oBAAY,qBAAqB;IAC/B,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAEpC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAEpD;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC;IAEtD;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;IAE1C;;;;OAIG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAE7E;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IAEpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAE/B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,aAAa,GACrB,CAAC,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC,GACzC,eAAe,GACf,SAAS,CAAC;AAEd,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,eAAe,CAMpE;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,eAAe,CAAC;CACnC;AAYD,wBAAgB,aAAa,IAAI,SAAS,aAAa,EAAE,CAExD;AAED,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAQD,wBAAgB,WAAW,IAAI,aAAa,GAAG,SAAS,CAWvD;AAiHD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,aAAa,CAyGvD,CAAC"}