@fivem-nui/svelte 0.0.0-stage → 1.0.0

package/dist/mock/interceptor.js

@@ -0,0 +1,128 @@
+import { isNuiUrl, parseNuiUrl } from './url';
+/**
+ * Extracts the body payload from a `fetch` invocation, supporting both `init.body`
+ * and body text inside a `Request` instance.
+ */
+export async function extractRequestBody(input, init) {
+    let bodyText = typeof init?.body === 'string' ? init.body : null;
+    if (!bodyText && typeof Request !== 'undefined' && input instanceof Request) {
+        try {
+            bodyText = await input.clone().text();
+        }
+        catch {
+            // body already consumed or unreadable
+        }
+    }
+    if (bodyText) {
+        try {
+            return JSON.parse(bodyText);
+        }
+        catch {
+            return bodyText;
+        }
+    }
+    return null;
+}
+/**
+ * Creates the `window.fetch` interceptor function that simulates FiveM CEF transport.
+ */
+export function createFetchInterceptor(ctx) {
+    const { targetResource, latencyMs, log, activeRequests, activeCallbacks, activeSendHandlers, originalFetch } = ctx;
+    return async (input, init) => {
+        const url = typeof input === 'string'
+            ? input
+            : input instanceof URL
+                ? input.toString()
+                : input.url;
+        if (!isNuiUrl(url, targetResource)) {
+            return originalFetch(input, init);
+        }
+        const { resourceName, callbackName } = parseNuiUrl(url);
+        const bodyObj = await extractRequestBody(input, init);
+        const eventName = bodyObj?.event;
+        const correlationId = bodyObj?.id;
+        const payload = bodyObj?.payload ?? bodyObj?.data;
+        const messageType = bodyObj?.type;
+        if (log) {
+            console.debug(`[NUI Mock] -> POST https://${resourceName}/${callbackName} type='${messageType ?? 'event'}' event='${eventName ?? callbackName}' id=${correlationId ?? '-'}`, payload);
+        }
+        // Simulate consistent transport latency across all NUI operations
+        if (latencyMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, latencyMs));
+        }
+        let handled = false;
+        // Check callback notifications
+        if (activeCallbacks[callbackName]) {
+            handled = true;
+            try {
+                activeCallbacks[callbackName](payload);
+            }
+            catch (e) {
+                console.error(`[NUI Mock] Error in callback handler '${callbackName}':`, e);
+            }
+        }
+        // Check send handlers
+        if (eventName && activeSendHandlers[eventName]) {
+            handled = true;
+            try {
+                activeSendHandlers[eventName](payload);
+            }
+            catch (e) {
+                console.error(`[NUI Mock] Error in send handler '${eventName}':`, e);
+            }
+        }
+        // Handle correlated request/response
+        if (eventName && activeRequests[eventName]) {
+            handled = true;
+            try {
+                const result = await activeRequests[eventName](payload);
+                // In FiveM CEF, HTTP POST to https://<resource>/<callback> is strictly an outgoing transport ACK;
+                // the native C# backend delivers the correlated response envelope asynchronously via
+                // SendNuiMessage -> window.postMessage.
+                if (correlationId) {
+                    window.postMessage({
+                        type: 'response',
+                        id: correlationId,
+                        success: true,
+                        payload: result,
+                        data: result
+                    }, '*');
+                }
+                return new Response(JSON.stringify({ ok: true }), {
+                    status: 200,
+                    headers: { 'Content-Type': 'application/json' }
+                });
+            }
+            catch (err) {
+                const errorEnvelope = {
+                    code: err?.code ?? 'MOCK_ERROR',
+                    message: err instanceof Error ? err.message : String(err)
+                };
+                if (correlationId) {
+                    window.postMessage({
+                        type: 'response',
+                        id: correlationId,
+                        success: false,
+                        error: errorEnvelope
+                    }, '*');
+                }
+                return new Response(JSON.stringify({
+                    success: false,
+                    error: errorEnvelope
+                }), {
+                    status: 500,
+                    headers: { 'Content-Type': 'application/json' }
+                });
+            }
+        }
+        if (!handled && log) {
+            const targetEvent = eventName ?? callbackName;
+            console.warn(`[NUI Mock] Unhandled NUI message: no mock handler registered for '${targetEvent}'.`);
+        }
+        return new Response(JSON.stringify({ ok: true }), {
+            status: 200,
+            headers: { 'Content-Type': 'application/json' }
+        });
+    };
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/mock/interceptor.js.map

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

package/dist/mock/types.d.ts

@@ -0,0 +1,100 @@
+import type { NuiWindowAction } from '@fivem-nui/core';
+/**
+ * Message types for synthetic NUI postMessage envelopes in the mock environment.
+ */
+export declare enum NuiMessageType {
+    /**
+     * Standard event message.
+     */
+    Event = "event",
+    /**
+     * RPC request message.
+     */
+    Request = "request",
+    /**
+     * RPC response message.
+     */
+    Response = "response"
+}
+/**
+ * Configuration options for {@link setupNuiMock}.
+ */
+export interface NuiMockOptions {
+    /**
+     * Expected FiveM resource name to intercept.
+     * If omitted, falls back to `getResourceName('')` or `'nui'`.
+     */
+    resourceName?: string;
+    /**
+     * Mock handlers for requests sent via `nui.request(eventName, payload)`.
+     * Return the response payload or a Promise resolving to it.
+     */
+    requests?: Record<string, (payload: any) => Promise<any> | any>;
+    /**
+     * Mock callbacks registered with `nui.notify(callbackName, payload)`.
+     */
+    callbacks?: Record<string, (payload: any) => void>;
+    /**
+     * Listeners invoked when UI sends fire-and-forget messages (`nui.send`).
+     */
+    onSend?: Record<string, (payload: any) => void>;
+    /**
+     * Delay in milliseconds to simulate network latency in the browser.
+     * @defaultValue 50
+     */
+    latencyMs?: number;
+    /**
+     * Whether to log mock events and requests in the browser console.
+     * @defaultValue true
+     */
+    log?: boolean;
+}
+/**
+ * Controller interface returned by {@link setupNuiMock} for controlling the mock runtime.
+ */
+export interface NuiMockController {
+    /**
+     * Simulates an event dispatched from C#/server to NUI.
+     *
+     * @param eventName - Name of the simulated event.
+     * @param payload - Optional data payload.
+     * @param delayMs - Optional delay in milliseconds before dispatching.
+     */
+    emitEvent(eventName: string, payload?: unknown, delayMs?: number): void;
+    /**
+     * Simulates a window lifecycle action (`'open'`, `'close'`, `'focus'`, `'blur'`).
+     *
+     * @param action - The window lifecycle action.
+     * @param windowName - Optional target window identifier.
+     * @param delayMs - Optional delay in milliseconds before dispatching.
+     */
+    emitWindow(action: NuiWindowAction, windowName?: string, delayMs?: number): void;
+    /**
+     * Dynamically adds or updates a request mock handler.
+     *
+     * @param eventName - RPC request event name to intercept.
+     * @param handler - Handler function returning the mock response.
+     * @returns Unsubscribe function to remove the mock handler.
+     */
+    mockRequest<TRequest = unknown, TResponse = unknown>(eventName: string, handler: (payload: TRequest) => Promise<TResponse> | TResponse): () => void;
+    /**
+     * Removes a mock request handler.
+     *
+     * @param eventName - Name of the request to remove.
+     */
+    removeRequest(eventName: string): void;
+    /**
+     * Dynamically adds a listener for UI-sent messages (`nui.send`).
+     *
+     * @param eventName - Event name to listen for.
+     * @param handler - Callback invoked with the sent payload.
+     * @returns Unsubscribe function to remove the listener.
+     */
+    onSend<T = unknown>(eventName: string, handler: (payload: T) => void): () => void;
+    /**
+     * Restores original window.fetch and cleans up mock handlers.
+     */
+    destroy(): void;
+}
+export declare const NOOP_CONTROLLER: NuiMockController;
+//# sourceMappingURL=types.d.ts.map

package/dist/mock/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mock/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,oBAAY,cAAc;IACxB;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,QAAQ,aAAa;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAEhE;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC;IAEnD;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC;IAEhD;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExE;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjF;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,GAAG,OAAO,EAAE,SAAS,GAAG,OAAO,EACjD,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,GAC7D,MAAM,IAAI,CAAC;IAEd;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAElF;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,eAAe,EAAE,iBAO7B,CAAC"}

package/dist/mock/types.js

@@ -0,0 +1,27 @@
+/**
+ * Message types for synthetic NUI postMessage envelopes in the mock environment.
+ */
+export var NuiMessageType;
+(function (NuiMessageType) {
+    /**
+     * Standard event message.
+     */
+    NuiMessageType["Event"] = "event";
+    /**
+     * RPC request message.
+     */
+    NuiMessageType["Request"] = "request";
+    /**
+     * RPC response message.
+     */
+    NuiMessageType["Response"] = "response";
+})(NuiMessageType || (NuiMessageType = {}));
+export const NOOP_CONTROLLER = {
+    emitEvent: () => { },
+    emitWindow: () => { },
+    mockRequest: () => () => { },
+    removeRequest: () => { },
+    onSend: () => () => { },
+    destroy: () => { }
+};
+//# sourceMappingURL=types.js.map

package/dist/mock/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mock/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAN,IAAY,cAeX;AAfD,WAAY,cAAc;IACxB;;OAEG;IACH,iCAAe,CAAA;IAEf;;OAEG;IACH,qCAAmB,CAAA;IAEnB;;OAEG;IACH,uCAAqB,CAAA;AACvB,CAAC,EAfW,cAAc,KAAd,cAAc,QAezB;AAiGD,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;IACnB,UAAU,EAAE,GAAG,EAAE,GAAE,CAAC;IACpB,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;IAC3B,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;IACtB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;CAClB,CAAC"}

package/dist/mock/url.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Checks whether a given URL matches a targeted FiveM NUI endpoint:
+ * `https://<resourceName>/<callback>` or `https://cfx-nui-<resourceName>/<callback>`.
+ * Rejects localhost, IP addresses, ports, and external domains.
+ */
+export declare function isNuiUrl(url: string, targetResource: string): boolean;
+/**
+ * Extracts and safely decodes the resource name and callback endpoint from a NUI URL.
+ */
+export declare function parseNuiUrl(url: string): {
+    resourceName: string;
+    callbackName: string;
+};
+//# sourceMappingURL=url.d.ts.map

package/dist/mock/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/mock/url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAgBrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAUvF"}

package/dist/mock/url.js

@@ -0,0 +1,38 @@
+/**
+ * Checks whether a given URL matches a targeted FiveM NUI endpoint:
+ * `https://<resourceName>/<callback>` or `https://cfx-nui-<resourceName>/<callback>`.
+ * Rejects localhost, IP addresses, ports, and external domains.
+ */
+export function isNuiUrl(url, targetResource) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'https:' || parsed.port) {
+            return false;
+        }
+        const host = parsed.hostname.toLowerCase();
+        if (host === 'localhost' || host === '127.0.0.1' || host === '::1' || host.includes('.')) {
+            return false;
+        }
+        const expected = targetResource.toLowerCase();
+        return host === expected || host === `cfx-nui-${expected}`;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Extracts and safely decodes the resource name and callback endpoint from a NUI URL.
+ */
+export function parseNuiUrl(url) {
+    const urlParts = url.replace('https://', '').split('/');
+    const resourceName = urlParts[0];
+    let callbackName = urlParts[1] ?? 'nui';
+    try {
+        callbackName = decodeURIComponent(callbackName);
+    }
+    catch {
+        // malformed URI sequence, keep raw callbackName
+    }
+    return { resourceName, callbackName };
+}
+//# sourceMappingURL=url.js.map

package/dist/mock/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/mock/url.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,cAAsB;IAC1D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC3C,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACzF,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,WAAW,QAAQ,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjC,IAAI,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IACxC,IAAI,CAAC;QACH,YAAY,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;IACD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;AACxC,CAAC"}

package/dist/runes/clickOutside.svelte.d.ts

@@ -0,0 +1,29 @@
+import { type ClickOutsideTarget, type NuiClickOutsideParameter } from '../actions/clickOutside';
+export type { ClickOutsideTarget, NuiClickOutsideParameter };
+/**
+ * Detects clicks outside a target element and invokes a callback.
+ * Automatically cleans up listeners on unmount.
+ *
+ * @param target - Getter returning the target DOM element.
+ * @param getOptions - Getter returning options (onClickOutside, ignore, enabled).
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let panelEl = $state<HTMLElement>();
+ *   let triggerEl = $state<HTMLElement>();
+ *   let isOpen = $state(false);
+ *
+ *   useClickOutside(
+ *     () => panelEl,
+ *     () => ({
+ *       onClickOutside: () => { isOpen = false; },
+ *       ignore: [triggerEl],
+ *       enabled: isOpen
+ *     })
+ *   );
+ * </script>
+ * ```
+ */
+export declare function useClickOutside(target: () => Element | null | undefined, getOptions: () => NuiClickOutsideParameter): void;
+//# sourceMappingURL=clickOutside.svelte.d.ts.map

package/dist/runes/clickOutside.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickOutside.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/clickOutside.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,OAAO,GAAG,IAAI,GAAG,SAAS,EACxC,UAAU,EAAE,MAAM,wBAAwB,GACzC,IAAI,CAeN"}

package/dist/runes/clickOutside.svelte.js

@@ -0,0 +1,42 @@
+import { untrack } from 'svelte';
+import { createClickOutsideHandler } from '../actions/clickOutside';
+/**
+ * Detects clicks outside a target element and invokes a callback.
+ * Automatically cleans up listeners on unmount.
+ *
+ * @param target - Getter returning the target DOM element.
+ * @param getOptions - Getter returning options (onClickOutside, ignore, enabled).
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let panelEl = $state<HTMLElement>();
+ *   let triggerEl = $state<HTMLElement>();
+ *   let isOpen = $state(false);
+ *
+ *   useClickOutside(
+ *     () => panelEl,
+ *     () => ({
+ *       onClickOutside: () => { isOpen = false; },
+ *       ignore: [triggerEl],
+ *       enabled: isOpen
+ *     })
+ *   );
+ * </script>
+ * ```
+ */
+export function useClickOutside(target, getOptions) {
+    const handler = createClickOutsideHandler(target, getOptions);
+    $effect(() => {
+        if (!target())
+            return;
+        const capture = untrack(() => getOptions().capture ?? true);
+        const ac = new AbortController();
+        document.addEventListener('pointerdown', handler, {
+            capture,
+            signal: ac.signal
+        });
+        return () => ac.abort();
+    });
+}
+//# sourceMappingURL=clickOutside.svelte.js.map

package/dist/runes/clickOutside.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickOutside.svelte.js","sourceRoot":"","sources":["../../src/runes/clickOutside.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EACL,yBAAyB,EAG1B,MAAM,yBAAyB,CAAC;AAIjC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAwC,EACxC,UAA0C;IAE1C,MAAM,OAAO,GAAG,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAE9D,OAAO,CAAC,GAAG,EAAE;QACX,IAAI,CAAC,MAAM,EAAE;YAAE,OAAO;QAEtB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;QAC5D,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,OAAO,EAAE;YAChD,OAAO;YACP,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runes/escape.svelte.d.ts

@@ -0,0 +1,34 @@
+import { type NuiEscapeParameter, NuiEscapeTarget } from '../actions/escape';
+export { NuiEscapeTarget };
+export type NuiEscapeComposableParameter = Omit<NuiEscapeParameter, 'target'> & {
+    /**
+     * Where to attach the global listener:
+     * - `'document'` / `NuiEscapeTarget.Document`: listens globally on the document (default)
+     * - `'window'` / `NuiEscapeTarget.Window`: listens globally on the window
+     *
+     * Note: To scope Escape to a specific DOM element with focus, use the `nuiEscapeAction` action instead.
+     * @defaultValue NuiEscapeTarget.Document
+     */
+    target?: NuiEscapeTarget.Window | NuiEscapeTarget.Document;
+};
+export type NuiEscapeComposableInput = ((event: KeyboardEvent) => void) | NuiEscapeComposableParameter;
+/**
+ * Listens for the Escape key and invokes a callback.
+ * Automatically cleans up listeners on unmount.
+ *
+ * @param getOptions - Getter returning options or an onEscape callback.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let isOpen = $state(false);
+ *
+ *   useEscape(() => ({
+ *     onEscape: () => { isOpen = false; },
+ *     enabled: isOpen
+ *   }));
+ * </script>
+ * ```
+ */
+export declare function useEscape(getOptions: () => NuiEscapeComposableInput): void;
+//# sourceMappingURL=escape.svelte.d.ts.map

package/dist/runes/escape.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/escape.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACvB,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,MAAM,MAAM,4BAA4B,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG;IAC9E;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC;CAC5D,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAChC,CAAC,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC,GAChC,4BAA4B,CAAC;AAEjC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,wBAAwB,GACzC,IAAI,CAwBN"}

package/dist/runes/escape.svelte.js

@@ -0,0 +1,44 @@
+import { untrack } from 'svelte';
+import { createEscapeHandler, toEscapeOptions, NuiEscapeTarget } from '../actions/escape';
+export { NuiEscapeTarget };
+/**
+ * Listens for the Escape key and invokes a callback.
+ * Automatically cleans up listeners on unmount.
+ *
+ * @param getOptions - Getter returning options or an onEscape callback.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let isOpen = $state(false);
+ *
+ *   useEscape(() => ({
+ *     onEscape: () => { isOpen = false; },
+ *     enabled: isOpen
+ *   }));
+ * </script>
+ * ```
+ */
+export function useEscape(getOptions) {
+    const normalized = () => toEscapeOptions(getOptions());
+    const handler = createEscapeHandler(normalized);
+    $effect(() => {
+        // Intentionally untracked: attach the DOM listener once upon mount,
+        // preserving event listener order. Reactive state (`enabled`, `onEscape`, etc.)
+        // is read lazily on each keydown event. Cleanup is called on component unmount.
+        const { target, capture } = untrack(() => {
+            const o = normalized();
+            return {
+                target: o?.target === NuiEscapeTarget.Window ? window : document,
+                capture: o?.capture ?? false
+            };
+        });
+        const ac = new AbortController();
+        target.addEventListener('keydown', handler, {
+            capture,
+            signal: ac.signal
+        });
+        return () => ac.abort();
+    });
+}
+//# sourceMappingURL=escape.svelte.js.map

package/dist/runes/escape.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.svelte.js","sourceRoot":"","sources":["../../src/runes/escape.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EACL,mBAAmB,EACnB,eAAe,EAEf,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,eAAe,EAAE,CAAC;AAkB3B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CACvB,UAA0C;IAE1C,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,eAAe,CAA+B,UAAU,EAAE,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,EAAE;QACX,oEAAoE;QACpE,gFAAgF;QAChF,gFAAgF;QAChF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;YACvC,MAAM,CAAC,GAAG,UAAU,EAAE,CAAC;YACvB,OAAO;gBACL,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;gBAChE,OAAO,EAAE,CAAC,EAAE,OAAO,IAAI,KAAK;aAC7B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,EAAE,GAAG,IAAI,eAAe,EAAE,CAAC;QACjC,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,OAAwB,EAAE;YAC3D,OAAO;YACP,MAAM,EAAE,EAAE,CAAC,MAAM;SAClB,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runes/focusTrap.svelte.d.ts

@@ -0,0 +1,21 @@
+import { type NuiFocusTrapInput, type NuiFocusTrapOptions, type FocusTrapAllowOutsideTarget, type FocusTrapAllowOutside } from '../actions/focusTrap';
+export type { NuiFocusTrapInput, NuiFocusTrapOptions, FocusTrapAllowOutsideTarget, FocusTrapAllowOutside };
+/**
+ * Traps Tab key navigation inside a container element.
+ * Automatically activates and tears down as the target element mounts/unmounts.
+ *
+ * @param target - Getter returning the container element.
+ * @param getOptions - Optional getter returning options or boolean enabled flag.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let modalEl = $state<HTMLElement>();
+ *   let isOpen = $state(false);
+ *
+ *   useFocusTrap(() => modalEl, () => isOpen);
+ * </script>
+ * ```
+ */
+export declare function useFocusTrap(target: () => HTMLElement | null | undefined, getOptions?: () => NuiFocusTrapInput): void;
+//# sourceMappingURL=focusTrap.svelte.d.ts.map

package/dist/runes/focusTrap.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/focusTrap.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,iBAAiB,EACjB,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACtB,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,EAC5C,UAAU,CAAC,EAAE,MAAM,iBAAiB,GACnC,IAAI,CAmBN"}

package/dist/runes/focusTrap.svelte.js

@@ -0,0 +1,37 @@
+import { untrack } from 'svelte';
+import { nuiFocusTrap } from '../actions/focusTrap';
+/**
+ * Traps Tab key navigation inside a container element.
+ * Automatically activates and tears down as the target element mounts/unmounts.
+ *
+ * @param target - Getter returning the container element.
+ * @param getOptions - Optional getter returning options or boolean enabled flag.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let modalEl = $state<HTMLElement>();
+ *   let isOpen = $state(false);
+ *
+ *   useFocusTrap(() => modalEl, () => isOpen);
+ * </script>
+ * ```
+ */
+export function useFocusTrap(target, getOptions) {
+    let action;
+    $effect(() => {
+        const node = target();
+        if (!node)
+            return;
+        action = nuiFocusTrap(node, untrack(() => getOptions?.() ?? true));
+        return () => {
+            action?.destroy?.();
+            action = undefined;
+        };
+    });
+    $effect(() => {
+        const opts = getOptions?.() ?? true;
+        action?.update?.(opts);
+    });
+}
+//# sourceMappingURL=focusTrap.svelte.js.map

package/dist/runes/focusTrap.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusTrap.svelte.js","sourceRoot":"","sources":["../../src/runes/focusTrap.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EACL,YAAY,EAKb,MAAM,sBAAsB,CAAC;AAS9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAC1B,MAA4C,EAC5C,UAAoC;IAEpC,IAAI,MAAmD,CAAC;IAExD,OAAO,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;QAEnE,OAAO,GAAG,EAAE;YACV,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;YACpB,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,UAAU,EAAE,EAAE,IAAI,IAAI,CAAC;QACpC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/runes/index.svelte.d.ts

@@ -0,0 +1,8 @@
+export { useNuiState, NuiStateController, type NuiState, type NuiStateOptions } from './state.svelte';
+export { useNuiQuery, NuiQueryController, type NuiQuery, type NuiQueryOptions, NuiQueryStatus } from './query.svelte';
+export { useNuiWindow, NuiWindowController, type NuiWindow, type NuiWindowOptions, NuiWindowActionType, NuiWindowNotification } from './window.svelte';
+export { useClickOutside } from './clickOutside.svelte';
+export { useEscape, type NuiEscapeComposableParameter, type NuiEscapeComposableInput } from './escape.svelte';
+export { useFocusTrap } from './focusTrap.svelte';
+export { useLayer, type NuiLayerComposableInput } from './layer.svelte';
+//# sourceMappingURL=index.svelte.d.ts.map

package/dist/runes/index.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/index.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,SAAS,EACT,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,QAAQ,EACR,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC"}

package/dist/runes/index.svelte.js

@@ -0,0 +1,8 @@
+export { useNuiState, NuiStateController } from './state.svelte';
+export { useNuiQuery, NuiQueryController, NuiQueryStatus } from './query.svelte';
+export { useNuiWindow, NuiWindowController, NuiWindowActionType, NuiWindowNotification } from './window.svelte';
+export { useClickOutside } from './clickOutside.svelte';
+export { useEscape } from './escape.svelte';
+export { useFocusTrap } from './focusTrap.svelte';
+export { useLayer } from './layer.svelte';
+//# sourceMappingURL=index.svelte.js.map

package/dist/runes/index.svelte.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.svelte.js","sourceRoot":"","sources":["../../src/runes/index.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,kBAAkB,EAGnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,WAAW,EACX,kBAAkB,EAGlB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,mBAAmB,EAGnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,SAAS,EAGV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EACL,QAAQ,EAET,MAAM,gBAAgB,CAAC"}

package/dist/runes/layer.svelte.d.ts

@@ -0,0 +1,36 @@
+import { NuiLayerDismissReason, type NuiLayerInput, type NuiLayerOptions, type LayerInstance } from '../actions/layer';
+export { NuiLayerDismissReason };
+export type { NuiLayerInput, NuiLayerOptions, LayerInstance };
+/**
+ * Reactive options getter for `useLayer`.
+ */
+export type NuiLayerComposableInput = () => NuiLayerOptions;
+/**
+ * Manages an overlay layer (modal, dialog, drawer) in FiveM NUI.
+ * Coordinates Escape key, outside click, and focus trapping through a central layer stack.
+ *
+ * @param target - Getter returning the container element.
+ * @param getOptions - Optional getter returning layer options.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   let modalEl = $state<HTMLElement>();
+ *   let isOpen = $state(false);
+ *
+ *   useLayer(
+ *     () => modalEl,
+ *     () => ({ onDismiss: () => { isOpen = false; }, enabled: isOpen })
+ *   );
+ * </script>
+ *
+ * {#if isOpen}
+ *   <div bind:this={modalEl} class="modal">
+ *     <h2>Modal</h2>
+ *     <button onclick={() => { isOpen = false; }}>Close</button>
+ *   </div>
+ * {/if}
+ * ```
+ */
+export declare function useLayer(target: () => HTMLElement | null | undefined, getOptions?: () => NuiLayerOptions): void;
+//# sourceMappingURL=layer.svelte.d.ts.map

package/dist/runes/layer.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/layer.svelte.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACtB,CAAC;AAEF,YAAY,EACV,aAAa,EACb,eAAe,EACf,aAAa,EACd,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,EAC5C,UAAU,CAAC,EAAE,MAAM,eAAe,GACjC,IAAI,CAmBN"}