@fivem-nui/svelte 0.0.0-stage → 1.0.0

package/dist/actions/focusTrap.d.ts

@@ -0,0 +1,24 @@
+import type { Action } from 'svelte/action';
+import { FOCUSABLE_SELECTORS, getFocusables, resolveInitialElement, handleTabKey } from './focusables';
+import { type FocusTrapAllowOutsideTarget, type FocusTrapAllowOutside, type FocusTrapEntry, getTopTrap, resolveAllowOutsideElement, isNodeAllowedOutside } from './trapStack';
+import { type NuiFocusTrapOptions, type NuiFocusTrapInput, toFocusTrapOptions } from './focusTrap.types';
+export { FOCUSABLE_SELECTORS, getFocusables, resolveInitialElement, handleTabKey };
+export { type FocusTrapAllowOutsideTarget, type FocusTrapAllowOutside, type FocusTrapEntry, getTopTrap, resolveAllowOutsideElement, isNodeAllowedOutside };
+export { type NuiFocusTrapOptions, type NuiFocusTrapInput, toFocusTrapOptions };
+/**
+ * Svelte Action for trapping Tab key navigation inside an element.
+ *
+ * Essential in FiveM NUI to prevent keyboard navigation from leaking out of CEF
+ * modals or into the background game window.
+ *
+ * @param node - The container DOM element confining focus.
+ * @param parameter - Configuration options or boolean enabled flag.
+ *
+ * @example
+ * ```svelte
+ * <div class="modal" use:nuiFocusTrap={isOpen}>...</div>
+ * <div class="dialog" use:nuiFocusTrap={{ enabled: true, allowOutside: '.datepicker-portal' }}>...</div>
+ * ```
+ */
+export declare const nuiFocusTrap: Action<HTMLElement, NuiFocusTrapInput>;
+//# sourceMappingURL=focusTrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.d.ts","sourceRoot":"","sources":["../../src/actions/focusTrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,YAAY,EACb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,UAAU,EACV,0BAA0B,EAC1B,oBAAoB,EAGrB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,kBAAkB,EACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,YAAY,EACb,CAAC;AACF,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,UAAU,EACV,0BAA0B,EAC1B,oBAAoB,EACrB,CAAC;AACF,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,kBAAkB,EACnB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAkM/D,CAAC"}

package/dist/actions/focusTrap.js

@@ -0,0 +1,201 @@
+import { FOCUSABLE_SELECTORS, getFocusables, resolveInitialElement, handleTabKey } from './focusables';
+import { getTopTrap, resolveAllowOutsideElement, isNodeAllowedOutside, pushTrap, removeTrap } from './trapStack';
+import { toFocusTrapOptions } from './focusTrap.types';
+export { FOCUSABLE_SELECTORS, getFocusables, resolveInitialElement, handleTabKey };
+export { getTopTrap, resolveAllowOutsideElement, isNodeAllowedOutside };
+export { toFocusTrapOptions };
+/**
+ * Svelte Action for trapping Tab key navigation inside an element.
+ *
+ * Essential in FiveM NUI to prevent keyboard navigation from leaking out of CEF
+ * modals or into the background game window.
+ *
+ * @param node - The container DOM element confining focus.
+ * @param parameter - Configuration options or boolean enabled flag.
+ *
+ * @example
+ * ```svelte
+ * <div class="modal" use:nuiFocusTrap={isOpen}>...</div>
+ * <div class="dialog" use:nuiFocusTrap={{ enabled: true, allowOutside: '.datepicker-portal' }}>...</div>
+ * ```
+ */
+export const nuiFocusTrap = (node, parameter) => {
+    let currentParam = parameter;
+    let active = false;
+    let previouslyFocused = null;
+    let rafId = null;
+    let controller = null;
+    let addedTabindex = false;
+    function isEnabled() {
+        const opts = toFocusTrapOptions(currentParam);
+        const { enabled } = opts;
+        return typeof enabled === 'function' ? enabled() : (enabled ?? true);
+    }
+    function containsOrAllowed(target) {
+        if (!target)
+            return false;
+        if (node.contains(target))
+            return true;
+        const opts = toFocusTrapOptions(currentParam);
+        return isNodeAllowedOutside(target, opts.allowOutside);
+    }
+    function focusFirst() {
+        if (!active || !node.isConnected)
+            return;
+        const focusables = getFocusables(node);
+        if (focusables.length > 0) {
+            if (addedTabindex) {
+                node.removeAttribute('tabindex');
+                addedTabindex = false;
+            }
+            focusables[0].focus();
+        }
+        else {
+            if (!node.hasAttribute('tabindex')) {
+                node.setAttribute('tabindex', '-1');
+                addedTabindex = true;
+            }
+            node.focus();
+        }
+    }
+    function focusInitial() {
+        if (!active || !node.isConnected)
+            return;
+        const opts = toFocusTrapOptions(currentParam);
+        if (opts.autofocus === false)
+            return;
+        const targetEl = resolveInitialElement(node, opts.initialFocus);
+        if (targetEl &&
+            targetEl.isConnected &&
+            (node.contains(targetEl) || isNodeAllowedOutside(targetEl, opts.allowOutside))) {
+            if (addedTabindex) {
+                node.removeAttribute('tabindex');
+                addedTabindex = false;
+            }
+            targetEl.focus();
+            return;
+        }
+        if (!containsOrAllowed(document.activeElement)) {
+            focusFirst();
+        }
+    }
+    function checkIsTopmost() {
+        const opts = toFocusTrapOptions(currentParam);
+        if (typeof opts.isTopmost === 'function') {
+            return opts.isTopmost();
+        }
+        return getTopTrap()?.node === node;
+    }
+    function onFocusIn(event) {
+        if (!active || !node.isConnected)
+            return;
+        if (!checkIsTopmost())
+            return;
+        const target = event.target;
+        if (!target || containsOrAllowed(target))
+            return;
+        focusFirst();
+    }
+    function onKeyDown(event) {
+        if (!active || !checkIsTopmost())
+            return;
+        const opts = toFocusTrapOptions(currentParam);
+        handleTabKey(event, node, opts.allowOutside, focusFirst);
+    }
+    function restoreFocus() {
+        const opts = toFocusTrapOptions(currentParam);
+        if (opts.returnFocus === false)
+            return;
+        if (opts.returnFocus instanceof HTMLElement && opts.returnFocus.isConnected) {
+            opts.returnFocus.focus();
+        }
+        else if (previouslyFocused && previouslyFocused.isConnected) {
+            previouslyFocused.focus();
+        }
+        const topEntry = getTopTrap();
+        if (topEntry && !topEntry.containsOrAllowed(document.activeElement)) {
+            topEntry.focusFirst();
+        }
+    }
+    function teardown() {
+        if (rafId !== null) {
+            if (typeof cancelAnimationFrame !== 'undefined') {
+                cancelAnimationFrame(rafId);
+            }
+            rafId = null;
+        }
+        if (controller) {
+            controller.abort();
+            controller = null;
+        }
+        removeTrap(node);
+    }
+    const entry = {
+        node,
+        focusFirst,
+        containsOrAllowed,
+        isTopmost: () => {
+            const opts = toFocusTrapOptions(currentParam);
+            return typeof opts.isTopmost === 'function' ? opts.isTopmost() : undefined;
+        }
+    };
+    function setup() {
+        teardown();
+        if (!isEnabled())
+            return;
+        previouslyFocused = document.activeElement;
+        if (previouslyFocused && node.contains(previouslyFocused)) {
+            previouslyFocused = null;
+        }
+        active = true;
+        pushTrap(entry);
+        controller = new AbortController();
+        document.addEventListener('keydown', onKeyDown, { capture: true, signal: controller.signal });
+        document.addEventListener('focusin', onFocusIn, { signal: controller.signal });
+        if (typeof requestAnimationFrame !== 'undefined') {
+            rafId = requestAnimationFrame(() => {
+                rafId = null;
+                if (active && node.isConnected) {
+                    focusInitial();
+                }
+            });
+        }
+        else if (typeof queueMicrotask !== 'undefined') {
+            queueMicrotask(() => {
+                if (active && node.isConnected) {
+                    focusInitial();
+                }
+            });
+        }
+    }
+    function deactivate() {
+        const wasActive = active;
+        active = false;
+        teardown();
+        if (addedTabindex) {
+            node.removeAttribute('tabindex');
+            addedTabindex = false;
+        }
+        if (wasActive) {
+            restoreFocus();
+        }
+    }
+    setup();
+    return {
+        update(newParam) {
+            const wasEnabled = active;
+            currentParam = newParam;
+            const nowEnabled = isEnabled();
+            if (!wasEnabled && nowEnabled) {
+                setup();
+            }
+            else if (wasEnabled && !nowEnabled) {
+                deactivate();
+            }
+        },
+        destroy() {
+            deactivate();
+        }
+    };
+};
+//# sourceMappingURL=focusTrap.js.map

package/dist/actions/focusTrap.js.map

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

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

@@ -0,0 +1,50 @@
+import type { FocusTrapAllowOutside } from './trapStack';
+export interface NuiFocusTrapOptions {
+    /**
+     * Whether the focus trap is actively confining focus.
+     * Accepts a boolean or a reactive getter `() => boolean`.
+     * @defaultValue true
+     */
+    enabled?: boolean | (() => boolean);
+    /**
+     * Custom element, selector or getter to receive initial focus upon activation.
+     * If omitted, the first focusable element inside the node receives focus.
+     */
+    initialFocus?: HTMLElement | string | (() => HTMLElement | null | undefined);
+    /**
+     * Whether to restore focus to the previously focused element upon deactivation.
+     * Can also be a specific HTMLElement to return focus to.
+     * @defaultValue true
+     */
+    returnFocus?: boolean | HTMLElement;
+    /**
+     * Whether to automatically move focus inside the trap on activation.
+     * @defaultValue true
+     */
+    autofocus?: boolean;
+    /**
+     * Elements, selectors, or getters outside the container that are permitted to receive focus
+     * without being redirected back into the trap.
+     *
+     * Essential for portaled child elements such as select dropdowns, date pickers, or tooltips
+     * rendered into `document.body` outside the modal container.
+     */
+    allowOutside?: FocusTrapAllowOutside;
+    /**
+     * Optional custom predicate to determine if this trap is currently topmost.
+     * When provided, takes precedence over the default `trapStack` activation-order check.
+     * Used by coordinators such as `nuiLayer` to synchronize focus trapping with priority order.
+     *
+     * @remarks
+     * If providing custom `isTopmost` predicates manually, ensure only one active trap
+     * evaluates to `true` at any given time to avoid conflicting focus containment.
+     * Note that `nuiLayer` automatically controls and overrides this predicate based on layer priority.
+     */
+    isTopmost?: () => boolean;
+}
+export type NuiFocusTrapInput = boolean | NuiFocusTrapOptions | undefined;
+/**
+ * Normalizes boolean or option object parameters into `NuiFocusTrapOptions`.
+ */
+export declare function toFocusTrapOptions(input: NuiFocusTrapInput): NuiFocusTrapOptions;
+//# sourceMappingURL=focusTrap.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.types.d.ts","sourceRoot":"","sources":["../../src/actions/focusTrap.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;IAEpC;;;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;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,qBAAqB,CAAC;IAErC;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAAC;AAE1E;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GACvB,mBAAmB,CAKrB"}

package/dist/actions/focusTrap.types.js

@@ -0,0 +1,10 @@
+/**
+ * Normalizes boolean or option object parameters into `NuiFocusTrapOptions`.
+ */
+export function toFocusTrapOptions(input) {
+    if (input === undefined || typeof input === 'boolean') {
+        return { enabled: input ?? true };
+    }
+    return input;
+}
+//# sourceMappingURL=focusTrap.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.types.js","sourceRoot":"","sources":["../../src/actions/focusTrap.types.ts"],"names":[],"mappings":"AAqDA;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAwB;IAExB,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;IACpC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/actions/focusables.d.ts

@@ -0,0 +1,39 @@
+import { type FocusTrapAllowOutside } from './trapStack';
+/**
+ * CSS selector matching all natively and custom focusable elements in HTML documents.
+ */
+export declare const FOCUSABLE_SELECTORS: string;
+/**
+ * Returns all currently focusable elements in Tab order within a container.
+ * Filters out disabled elements (including `<fieldset disabled>`), negative tabindexes,
+ * aria-hidden, inert, and hidden elements.
+ * Correctly scopes radio button groups per form so only the active radio button is in Tab order.
+ *
+ * @remarks
+ * Assumes DOM order for keyboard navigation. Elements with positive tabindex (> 0)
+ * alter standard browser tab sequencing and should generally be avoided.
+ *
+ * @param container - The root element to query focusable elements from.
+ * @returns Array of focusable HTML elements within the container.
+ */
+export declare function getFocusables(container: HTMLElement): HTMLElement[];
+/**
+ * Resolves the designated initial focus element from an element reference, selector, or getter.
+ *
+ * @param container - The container DOM element.
+ * @param initialFocus - Target element, selector string, or getter function.
+ * @returns The resolved HTMLElement, or null if none was found.
+ */
+export declare function resolveInitialElement(container: HTMLElement, initialFocus?: HTMLElement | string | (() => HTMLElement | null | undefined)): HTMLElement | null;
+/**
+ * Confines Tab and Shift+Tab keyboard navigation within a container element.
+ * Wraps around when reaching the start or end of the focus sequence.
+ * Skips redirection if the currently focused element is allowed outside (e.g. portaled child).
+ *
+ * @param event - The keyboard event.
+ * @param container - The container element confining focus.
+ * @param allowOutside - Elements or selectors permitted to retain focus.
+ * @param onEmptyFallback - Callback when no focusable elements exist in container.
+ */
+export declare function handleTabKey(event: KeyboardEvent, container: HTMLElement, allowOutside?: FocusTrapAllowOutside, onEmptyFallback?: () => void): void;
+//# sourceMappingURL=focusables.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"focusables.d.ts","sourceRoot":"","sources":["../../src/actions/focusables.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,qBAAqB,EAAwB,MAAM,aAAa,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,mBAAmB,QAapB,CAAC;AAEb;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,EAAE,CAmDnE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,WAAW,EACtB,YAAY,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,GAC3E,WAAW,GAAG,IAAI,CAYpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,WAAW,EACtB,YAAY,CAAC,EAAE,qBAAqB,EACpC,eAAe,CAAC,EAAE,MAAM,IAAI,GAC3B,IAAI,CA6BN"}

package/dist/actions/focusables.js

@@ -0,0 +1,142 @@
+import { isNodeAllowedOutside } from './trapStack';
+/**
+ * CSS selector matching all natively and custom focusable elements in HTML documents.
+ */
+export const FOCUSABLE_SELECTORS = [
+    'a[href]',
+    'area[href]',
+    'input:not([type="hidden"])',
+    'select',
+    'textarea',
+    'button',
+    'iframe',
+    'summary',
+    'audio[controls]',
+    'video[controls]',
+    '[contenteditable]:not([contenteditable="false"])',
+    '[tabindex]'
+].join(', ');
+/**
+ * Returns all currently focusable elements in Tab order within a container.
+ * Filters out disabled elements (including `<fieldset disabled>`), negative tabindexes,
+ * aria-hidden, inert, and hidden elements.
+ * Correctly scopes radio button groups per form so only the active radio button is in Tab order.
+ *
+ * @remarks
+ * Assumes DOM order for keyboard navigation. Elements with positive tabindex (> 0)
+ * alter standard browser tab sequencing and should generally be avoided.
+ *
+ * @param container - The root element to query focusable elements from.
+ * @returns Array of focusable HTML elements within the container.
+ */
+export function getFocusables(container) {
+    const elements = Array.from(container.querySelectorAll(FOCUSABLE_SELECTORS));
+    const focusables = [];
+    const radioGroups = new Map();
+    for (const el of elements) {
+        if (el.matches(':disabled') || el.closest('fieldset[disabled]'))
+            continue;
+        if (el.tabIndex < 0)
+            continue;
+        if (el.closest('[aria-hidden="true"], [inert]'))
+            continue;
+        if (typeof el.checkVisibility === 'function') {
+            if (!el.checkVisibility())
+                continue;
+        }
+        else {
+            const isVisible = el.offsetWidth > 0 ||
+                el.offsetHeight > 0 ||
+                el.getClientRects().length > 0 ||
+                el.offsetParent !== null;
+            if (!isVisible)
+                continue;
+        }
+        if (el instanceof HTMLInputElement && el.type === 'radio' && el.name) {
+            const form = el.form;
+            let formRadios = radioGroups.get(form);
+            if (!formRadios) {
+                formRadios = new Map();
+                radioGroups.set(form, formRadios);
+            }
+            const currentRadio = formRadios.get(el.name);
+            if (el.checked) {
+                formRadios.set(el.name, el);
+            }
+            else if (!currentRadio) {
+                formRadios.set(el.name, el);
+            }
+            continue;
+        }
+        focusables.push(el);
+    }
+    if (radioGroups.size > 0) {
+        const keep = new Set(focusables);
+        for (const formRadios of radioGroups.values()) {
+            for (const radio of formRadios.values()) {
+                keep.add(radio);
+            }
+        }
+        return elements.filter((el) => keep.has(el));
+    }
+    return focusables;
+}
+/**
+ * Resolves the designated initial focus element from an element reference, selector, or getter.
+ *
+ * @param container - The container DOM element.
+ * @param initialFocus - Target element, selector string, or getter function.
+ * @returns The resolved HTMLElement, or null if none was found.
+ */
+export function resolveInitialElement(container, initialFocus) {
+    if (!initialFocus)
+        return null;
+    if (typeof initialFocus === 'string') {
+        return (container.querySelector(initialFocus) ??
+            document.querySelector(initialFocus));
+    }
+    if (typeof initialFocus === 'function') {
+        return initialFocus() ?? null;
+    }
+    return initialFocus;
+}
+/**
+ * Confines Tab and Shift+Tab keyboard navigation within a container element.
+ * Wraps around when reaching the start or end of the focus sequence.
+ * Skips redirection if the currently focused element is allowed outside (e.g. portaled child).
+ *
+ * @param event - The keyboard event.
+ * @param container - The container element confining focus.
+ * @param allowOutside - Elements or selectors permitted to retain focus.
+ * @param onEmptyFallback - Callback when no focusable elements exist in container.
+ */
+export function handleTabKey(event, container, allowOutside, onEmptyFallback) {
+    if (event.key !== 'Tab')
+        return;
+    const activeEl = document.activeElement;
+    if (isNodeAllowedOutside(activeEl, allowOutside))
+        return;
+    const focusables = getFocusables(container);
+    if (focusables.length === 0) {
+        event.preventDefault();
+        if (!container.contains(activeEl)) {
+            onEmptyFallback?.();
+        }
+        return;
+    }
+    const first = focusables[0];
+    const last = focusables[focusables.length - 1];
+    if (event.shiftKey) {
+        if (activeEl === first || !container.contains(activeEl)) {
+            event.preventDefault();
+            last.focus();
+        }
+    }
+    else {
+        if (activeEl === last || !container.contains(activeEl)) {
+            event.preventDefault();
+            first.focus();
+        }
+    }
+}
+//# sourceMappingURL=focusables.js.map

package/dist/actions/focusables.js.map

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

package/dist/actions/index.d.ts

@@ -0,0 +1,5 @@
+export { nuiEscapeAction, NuiEscapeTarget, type NuiEscapeParameter, type NuiEscapeInput } from './escape';
+export { nuiFocusTrap, type NuiFocusTrapOptions, type NuiFocusTrapInput, type FocusTrapAllowOutsideTarget, type FocusTrapAllowOutside, type FocusTrapEntry, FOCUSABLE_SELECTORS, getFocusables } from './focusTrap';
+export { nuiClickOutside, type NuiClickOutsideParameter, type NuiClickOutsideInput, type ClickOutsideTarget } from './clickOutside';
+export { nuiLayer, type NuiLayerOptions, type NuiLayerInput, NuiLayerDismissReason, type LayerInstance, getLayerStack, getTopLayer, resetLayerStack } from './layer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,mBAAmB,EACnB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EACf,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,qBAAqB,EACrB,KAAK,aAAa,EAClB,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,SAAS,CAAC"}

package/dist/actions/index.js

@@ -0,0 +1,5 @@
+export { nuiEscapeAction, NuiEscapeTarget } from './escape';
+export { nuiFocusTrap, FOCUSABLE_SELECTORS, getFocusables } from './focusTrap';
+export { nuiClickOutside } from './clickOutside';
+export { nuiLayer, NuiLayerDismissReason, getLayerStack, getTopLayer, resetLayerStack } from './layer';
+//# sourceMappingURL=index.js.map

package/dist/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EAGhB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,YAAY,EAMZ,mBAAmB,EACnB,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,eAAe,EAIhB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EAGR,qBAAqB,EAErB,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,4 @@
+export { nuiLayer } from './layer';
+export { NuiLayerDismissReason, type NuiLayerOptions, type NuiLayerInput, type LayerInstance, toLayerOptions } from './types';
+export { getLayerStack, getTopLayer, resetLayerStack } from './layerStack';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/actions/layer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,cAAc,EACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,cAAc,CAAC"}

package/dist/actions/layer/index.js

@@ -0,0 +1,4 @@
+export { nuiLayer } from './layer';
+export { NuiLayerDismissReason, toLayerOptions } from './types';
+export { getLayerStack, getTopLayer, resetLayerStack } from './layerStack';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/actions/layer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EACL,qBAAqB,EAIrB,cAAc,EACf,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,WAAW,EACX,eAAe,EAChB,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { Action } from 'svelte/action';
+import { type NuiLayerInput } from './types';
+/**
+ * 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/layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.d.ts","sourceRoot":"","sources":["../../../src/actions/layer/layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAEL,KAAK,aAAa,EAGnB,MAAM,SAAS,CAAC;AAQjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,WAAW,EAAE,aAAa,CAoGvD,CAAC"}