@fivem-nui/svelte 0.0.0-stage → 1.0.0

package/dist/runes/layer.svelte.js

@@ -0,0 +1,48 @@
+import { untrack } from 'svelte';
+import { nuiLayer, NuiLayerDismissReason } from '../actions/layer';
+export { NuiLayerDismissReason };
+/**
+ * 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 function useLayer(target, getOptions) {
+    let action;
+    $effect(() => {
+        const node = target();
+        if (!node)
+            return;
+        action = nuiLayer(node, untrack(() => getOptions?.()));
+        return () => {
+            action?.destroy?.();
+            action = undefined;
+        };
+    });
+    $effect(() => {
+        const opts = getOptions?.();
+        action?.update?.(opts);
+    });
+}
+//# sourceMappingURL=layer.svelte.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layer.svelte.js","sourceRoot":"","sources":["../../src/runes/layer.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACjC,OAAO,EACL,QAAQ,EACR,qBAAqB,EAItB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACtB,CAAC;AAaF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA4C,EAC5C,UAAkC;IAElC,IAAI,MAA+C,CAAC;IAEpD,OAAO,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI;YAAE,OAAO;QAElB,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;QAEvD,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,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,104 @@
+import type { NuiEventKey, NuiEventRequest, NuiEventResponse } from '@fivem-nui/core';
+import { type RetryOptions } from '@fivem-nui/error';
+import type { SvelteNuiClient } from '../client';
+export { type RetryOptions };
+export declare enum NuiQueryStatus {
+    Idle = "idle",
+    Loading = "loading",
+    Success = "success",
+    Error = "error"
+}
+export interface NuiQueryOptions<TRequest = unknown, TResponse = unknown> {
+    /** Optional client override (defaults to context or global client). */
+    client?: SvelteNuiClient;
+    /** Request timeout in ms (0 for no timeout). */
+    timeout?: number;
+    /**
+     * Automatic retry configuration using exponential backoff.
+     * - `true`: enables default retry (3 attempts for timeout and network errors).
+     * - `RetryOptions`: custom retry configuration (maxRetries, delays, filter).
+     */
+    retry?: boolean | RetryOptions;
+    /** Execute automatically on mount. */
+    immediate?: boolean;
+    /** Initial payload used for immediate fetch or fallback refetch. */
+    initialRequest?: TRequest;
+    /** Called on successful response. */
+    onSuccess?: (data: TResponse) => void;
+    /** Called on request failure (except when aborted). */
+    onError?: (error: Error) => void;
+}
+/**
+ * Controller for an asynchronous NUI query.
+ */
+export interface NuiQuery<TRequest, TResponse> {
+    readonly status: NuiQueryStatus;
+    readonly data: TResponse | null;
+    readonly loading: boolean;
+    readonly error: Error | null;
+    readonly called: boolean;
+    readonly lastUpdated: number | null;
+    /** Sends the request to C#. Cancels any pending request for this query. */
+    execute(request?: TRequest, overrideTimeout?: number): Promise<TResponse>;
+    /** Retries the last request using the same payload. */
+    refetch(overrideTimeout?: number): Promise<TResponse>;
+    /** Cancels the active request and stops loading. */
+    abort(): void;
+    /** Aborts any pending request and resets data, error, and status to idle. */
+    reset(): void;
+    /** Cleans up the query and aborts pending requests. */
+    destroy(): void;
+}
+/**
+ * Reusable controller managing reactive state and network requests for a NUI query.
+ */
+export declare class NuiQueryController<TRequest = unknown, TResponse = unknown> implements NuiQuery<TRequest, TResponse> {
+    private readonly eventName;
+    private readonly options;
+    private readonly client;
+    data: TResponse | null;
+    loading: boolean;
+    error: Error | null;
+    called: boolean;
+    lastUpdated: number | null;
+    private isSuccess;
+    private lastRequest?;
+    private hasLastRequest;
+    private activeRequestId;
+    private abortController;
+    private isDisposed;
+    constructor(eventName: string, options: NuiQueryOptions<TRequest, TResponse> | undefined, client: SvelteNuiClient);
+    get status(): NuiQueryStatus;
+    private sendRequest;
+    execute: (...args: [request?: TRequest, overrideTimeout?: number]) => Promise<TResponse>;
+    refetch: (overrideTimeout?: number) => Promise<TResponse>;
+    abort: () => void;
+    reset: () => void;
+    destroy: () => void;
+}
+/**
+ * Reactive query for communicating with C# (`nui.request`).
+ * Manages reactive `data`, `loading`, `error`, and `status`.
+ *
+ * Note: Access properties directly (e.g. `query.data`). Do not destructure, or you'll lose reactivity.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useNuiQuery } from '@fivem-nui/svelte';
+ *
+ *   const buy = useNuiQuery('shop:buy');
+ * </script>
+ *
+ * <button onclick={() => buy.execute({ id: 'bread', qty: 1 })} disabled={buy.loading}>
+ *   {buy.loading ? 'Buying...' : 'Buy'}
+ * </button>
+ *
+ * {#if buy.error}
+ *   <p class="error">{buy.error.message}</p>
+ * {/if}
+ * ```
+ */
+export declare function useNuiQuery<K extends NuiEventKey>(eventName: K, options?: NuiQueryOptions<NuiEventRequest<K>, NuiEventResponse<K>>): NuiQuery<NuiEventRequest<K>, NuiEventResponse<K>>;
+export declare function useNuiQuery<TRequest = unknown, TResponse = unknown>(eventName: string, options?: NuiQueryOptions<TRequest, TResponse>): NuiQuery<TRequest, TResponse>;
+//# sourceMappingURL=query.svelte.d.ts.map

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

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

package/dist/runes/query.svelte.js

@@ -0,0 +1,179 @@
+import { untrack } from 'svelte';
+import { globalErrorHandler, NuiErrorCategory, isAbortError, createAbortError } from '@fivem-nui/error';
+import { useNuiClient } from '../context';
+export {};
+export var NuiQueryStatus;
+(function (NuiQueryStatus) {
+    NuiQueryStatus["Idle"] = "idle";
+    NuiQueryStatus["Loading"] = "loading";
+    NuiQueryStatus["Success"] = "success";
+    NuiQueryStatus["Error"] = "error";
+})(NuiQueryStatus || (NuiQueryStatus = {}));
+/**
+ * Reusable controller managing reactive state and network requests for a NUI query.
+ */
+export class NuiQueryController {
+    eventName;
+    options;
+    client;
+    data = $state(null);
+    loading = $state(false);
+    error = $state(null);
+    called = $state(false);
+    lastUpdated = $state(null);
+    isSuccess = $state(false);
+    lastRequest;
+    hasLastRequest = false;
+    activeRequestId = 0;
+    abortController = null;
+    isDisposed = false;
+    constructor(eventName, options = {}, client) {
+        this.eventName = eventName;
+        this.options = options;
+        this.client = client;
+        this.lastRequest = options.initialRequest;
+        this.hasLastRequest = 'initialRequest' in options;
+    }
+    get status() {
+        if (this.loading)
+            return NuiQueryStatus.Loading;
+        if (this.error !== null)
+            return NuiQueryStatus.Error;
+        if (this.isSuccess)
+            return NuiQueryStatus.Success;
+        return NuiQueryStatus.Idle;
+    }
+    async sendRequest(payload, overrideTimeout) {
+        if (this.isDisposed) {
+            throw new Error('[useNuiQuery] Cannot execute request on a destroyed query controller.');
+        }
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+        const currentController = new AbortController();
+        this.abortController = currentController;
+        const currentRequestId = ++this.activeRequestId;
+        this.loading = true;
+        this.error = null;
+        this.called = true;
+        const requestFn = () => this.client.request(this.eventName, payload, overrideTimeout ?? this.options.timeout, currentController.signal);
+        try {
+            let result;
+            if (this.options.retry) {
+                const retryConfig = typeof this.options.retry === 'object' ? { ...this.options.retry } : {};
+                const userShouldRetry = retryConfig.shouldRetry;
+                retryConfig.shouldRetry = (errorInfo) => {
+                    if (currentRequestId !== this.activeRequestId ||
+                        currentController.signal.aborted ||
+                        isAbortError(errorInfo.error)) {
+                        return false;
+                    }
+                    if (userShouldRetry) {
+                        return userShouldRetry(errorInfo);
+                    }
+                    return ((retryConfig.retryOnTimeout !== false && errorInfo.category === NuiErrorCategory.TIMEOUT) ||
+                        (retryConfig.retryOnNetworkError !== false && errorInfo.category === NuiErrorCategory.NETWORK));
+                };
+                result = await globalErrorHandler.retry(requestFn, retryConfig);
+            }
+            else {
+                result = await requestFn();
+            }
+            if (currentRequestId !== this.activeRequestId || currentController.signal.aborted) {
+                throw createAbortError();
+            }
+            this.data = result;
+            this.isSuccess = true;
+            this.lastUpdated = Date.now();
+            try {
+                this.options.onSuccess?.(result);
+            }
+            catch (callbackErr) {
+                void globalErrorHandler
+                    .handle(callbackErr instanceof Error ? callbackErr : new Error(String(callbackErr)), { event: this.eventName }, 'useNuiQuery:onSuccess')
+                    .catch(() => { });
+                console.error(callbackErr);
+            }
+            return result;
+        }
+        catch (err) {
+            if (currentRequestId !== this.activeRequestId || currentController.signal.aborted) {
+                throw isAbortError(err) ? err : createAbortError();
+            }
+            if (isAbortError(err)) {
+                throw err;
+            }
+            const e = err instanceof Error ? err : new Error(String(err));
+            this.error = e;
+            this.isSuccess = false;
+            void globalErrorHandler
+                .handle(e, { event: this.eventName, payload }, 'useNuiQuery:request')
+                .catch(() => { });
+            try {
+                this.options.onError?.(e);
+            }
+            catch (callbackErr) {
+                void globalErrorHandler
+                    .handle(callbackErr instanceof Error ? callbackErr : new Error(String(callbackErr)), { event: this.eventName }, 'useNuiQuery:onError')
+                    .catch(() => { });
+                console.error(callbackErr);
+            }
+            throw e;
+        }
+        finally {
+            if (currentRequestId === this.activeRequestId) {
+                this.loading = false;
+                this.abortController = null;
+            }
+        }
+    }
+    execute = async (...args) => {
+        const hasExplicitRequest = args.length > 0;
+        if (hasExplicitRequest) {
+            this.lastRequest = args[0];
+            this.hasLastRequest = true;
+        }
+        return this.sendRequest(this.lastRequest, args[1]);
+    };
+    refetch = (overrideTimeout) => {
+        return this.sendRequest(this.lastRequest, overrideTimeout);
+    };
+    abort = () => {
+        if (this.abortController) {
+            this.abortController.abort();
+            this.abortController = null;
+        }
+        this.activeRequestId++;
+        this.loading = false;
+    };
+    reset = () => {
+        this.abort();
+        this.data = null;
+        this.error = null;
+        this.isSuccess = false;
+        this.called = false;
+        this.lastUpdated = null;
+        this.lastRequest = this.options.initialRequest;
+        this.hasLastRequest = 'initialRequest' in this.options;
+    };
+    destroy = () => {
+        if (this.isDisposed)
+            return;
+        this.isDisposed = true;
+        this.abort();
+    };
+}
+export function useNuiQuery(eventName, options = {}) {
+    const client = options.client ?? useNuiClient();
+    const query = new NuiQueryController(eventName, options, client);
+    $effect(() => () => query.destroy());
+    $effect(() => {
+        untrack(() => {
+            if (options.immediate) {
+                void query.execute(options.initialRequest).catch(() => { });
+            }
+        });
+    });
+    return query;
+}
+//# sourceMappingURL=query.svelte.js.map

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

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

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

@@ -0,0 +1,72 @@
+import type { NuiEventKey, NuiEventPayload } from '@fivem-nui/core';
+import type { SvelteNuiClient } from '../client';
+export interface NuiStateOptions<T> {
+    /** Optional client override (defaults to context or global client). */
+    client?: SvelteNuiClient;
+    /** Transform or validate raw incoming payload before updating state. */
+    transform?: (raw: unknown) => T;
+    /** Called when payload handling or transform fails. */
+    onError?: (error: Error) => void;
+    /**
+     * Automatic cleanup on component unmount.
+     * - `false`: disables lifecycle hook (useful for global stores / singletons).
+     * - `true`: strictly requires component context (throws if called outside).
+     * - `undefined`: automatically hooks into component lifecycle if available.
+     */
+    autoDestroy?: boolean;
+}
+/**
+ * Controller for reactive state synchronized with a NUI event.
+ */
+export interface NuiState<T> {
+    /** Current value. */
+    value: T;
+    /** Timestamp (epoch ms) of the last received event, or null. */
+    readonly updatedAt: number | null;
+    /** Number of received events. */
+    readonly count: number;
+    /** Last processing or transform error, or null. */
+    readonly error: Error | null;
+    /** Sets the value manually without incrementing count or updatedAt. */
+    set(value: T): void;
+    /** Updates the value using an updater function. */
+    update(fn: (prev: T) => T): void;
+    /** Resets state back to the initial value and clears errors. */
+    reset(): void;
+    /** Unsubscribes from the event. */
+    destroy(): void;
+}
+/**
+ * Binds a FiveM NUI event to reactive state.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useNuiState } from '@fivem-nui/svelte';
+ *
+ *   const player = useNuiState('player:update', { health: 100, armor: 0 });
+ * </script>
+ *
+ * <div>Health: {player.value.health}</div>
+ * ```
+ */
+/**
+ * Controller managing reactive state synchronized with a NUI event.
+ */
+export declare class NuiStateController<T> implements NuiState<T> {
+    value: T;
+    updatedAt: number | null;
+    count: number;
+    error: Error | null;
+    private readonly initialValue;
+    private isDestroyed;
+    private readonly unsubscribe;
+    constructor(eventName: string, initialValue: T, options: NuiStateOptions<T> | undefined, client: SvelteNuiClient);
+    set: (v: T) => void;
+    update: (fn: (prev: T) => T) => void;
+    reset: () => void;
+    destroy: () => void;
+}
+export declare function useNuiState<K extends NuiEventKey>(eventName: K, initialValue: NuiEventPayload<K>, options?: NuiStateOptions<NuiEventPayload<K>>): NuiState<NuiEventPayload<K>>;
+export declare function useNuiState<T>(eventName: string, initialValue: T, options?: NuiStateOptions<T>): NuiState<T>;
+//# sourceMappingURL=state.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/state.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGjD,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,uEAAuE;IACvE,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB,wEAAwE;IACxE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,CAAC;IAEhC,uDAAuD;IACvD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,qBAAqB;IACrB,KAAK,EAAE,CAAC,CAAC;IAET,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAE7B,uEAAuE;IACvE,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAEpB,mDAAmD;IACnD,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IAEjC,gEAAgE;IAChE,KAAK,IAAI,IAAI,CAAC;IAEd,mCAAmC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH;;GAEG;AACH,qBAAa,kBAAkB,CAAC,CAAC,CAAE,YAAW,QAAQ,CAAC,CAAC,CAAC;IACvD,KAAK,IAAwC;IAC7C,SAAS,gBAA+B;IACxC,KAAK,SAAa;IAClB,KAAK,eAA8B;IAEnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAI;IACjC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,YACE,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,EACf,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,YAAK,EAChC,MAAM,EAAE,eAAe,EA+BxB;IAED,GAAG,MAAO,CAAC,KAAG,IAAI,CAEhB;IAEF,MAAM,OAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAG,IAAI,CAEjC;IAEF,KAAK,QAAO,IAAI,CAKd;IAEF,OAAO,QAAO,IAAI,CAIhB;CACH;AAED,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAC/C,SAAS,EAAE,CAAC,EACZ,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,EAChC,OAAO,CAAC,EAAE,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GAC5C,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,wBAAgB,WAAW,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,EACf,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,QAAQ,CAAC,CAAC,CAAC,CAAC"}

package/dist/runes/state.svelte.js

@@ -0,0 +1,98 @@
+import { onDestroy } from 'svelte';
+import { globalErrorHandler } from '@fivem-nui/error';
+import { useNuiClient } from '../context';
+/**
+ * Binds a FiveM NUI event to reactive state.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useNuiState } from '@fivem-nui/svelte';
+ *
+ *   const player = useNuiState('player:update', { health: 100, armor: 0 });
+ * </script>
+ *
+ * <div>Health: {player.value.health}</div>
+ * ```
+ */
+/**
+ * Controller managing reactive state synchronized with a NUI event.
+ */
+export class NuiStateController {
+    value = $state(undefined);
+    updatedAt = $state(null);
+    count = $state(0);
+    error = $state(null);
+    initialValue;
+    isDestroyed = false;
+    unsubscribe;
+    constructor(eventName, initialValue, options = {}, client) {
+        this.initialValue = initialValue;
+        this.value = initialValue;
+        this.unsubscribe = client.on(eventName, (data) => {
+            try {
+                this.value = options.transform ? options.transform(data) : data;
+                this.updatedAt = Date.now();
+                this.count += 1;
+                this.error = null;
+            }
+            catch (err) {
+                const e = err instanceof Error ? err : new Error(String(err));
+                this.error = e;
+                void globalErrorHandler
+                    .handle(e, { event: eventName, payload: data }, 'useNuiState:transform')
+                    .catch(() => { });
+                try {
+                    options.onError?.(e);
+                }
+                catch (callbackErr) {
+                    void globalErrorHandler
+                        .handle(callbackErr instanceof Error ? callbackErr : new Error(String(callbackErr)), { event: eventName }, 'useNuiState:onError')
+                        .catch(() => { });
+                    console.error(callbackErr);
+                }
+            }
+        });
+    }
+    set = (v) => {
+        this.value = v;
+    };
+    update = (fn) => {
+        this.value = fn(this.value);
+    };
+    reset = () => {
+        this.value = this.initialValue;
+        this.updatedAt = null;
+        this.count = 0;
+        this.error = null;
+    };
+    destroy = () => {
+        if (this.isDestroyed)
+            return;
+        this.isDestroyed = true;
+        this.unsubscribe();
+    };
+}
+export function useNuiState(eventName, initialValue, options = {}) {
+    const client = options.client ?? useNuiClient();
+    const state = new NuiStateController(eventName, initialValue, options, client);
+    if (options.autoDestroy === true) {
+        try {
+            onDestroy(state.destroy);
+        }
+        catch (err) {
+            state.destroy();
+            throw err;
+        }
+    }
+    else if (options.autoDestroy !== false) {
+        try {
+            onDestroy(state.destroy);
+        }
+        catch {
+            // Called outside a component lifecycle; cleanup must be managed manually via destroy().
+        }
+    }
+    return state;
+}
+//# sourceMappingURL=state.svelte.js.map

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

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

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

@@ -0,0 +1,120 @@
+import type { SvelteNuiClient } from '../client';
+/**
+ * Window lifecycle actions dispatched from C# backend to NUI UI.
+ */
+export declare enum NuiWindowActionType {
+    Open = "open",
+    Close = "close",
+    Focus = "focus",
+    Unfocus = "unfocus"
+}
+/**
+ * Window lifecycle notifications dispatched from UI to C# backend.
+ */
+export declare enum NuiWindowNotification {
+    Ready = "ready",
+    Close = "close"
+}
+export interface NuiWindowOptions {
+    /**
+     * Explicit client instance override.
+     * Defaults to the client provided via context (`useNuiClient()`) or global client.
+     */
+    client?: SvelteNuiClient;
+    /**
+     * Initial visibility without focus or backend notification.
+     * @defaultValue false
+     */
+    initialVisible?: boolean;
+    /**
+     * Automatically closes the window when Escape is pressed.
+     * @defaultValue true
+     */
+    closeOnEscape?: boolean;
+    /**
+     * Callback invoked when window visibility changes from hidden to visible.
+     */
+    onOpen?: () => void;
+    /**
+     * Callback invoked when window visibility changes from visible to hidden.
+     */
+    onClose?: () => void;
+    /**
+     * Callback invoked when window focus state changes.
+     */
+    onFocusChange?: (focused: boolean) => void;
+    /**
+     * Controls automatic cleanup through Svelte's component lifecycle.
+     *
+     * - `true`: Strictly requires component initialization lifecycle; throws if called outside.
+     * - `false`: Disables automatic lifecycle cleanup; call `destroy()` manually.
+     * - `undefined`: Attempts automatic cleanup, falling back to manual cleanup outside components.
+     *
+     * @defaultValue undefined
+     */
+    autoDestroy?: boolean;
+}
+/**
+ * Controller interface representing a reactive NUI window.
+ */
+export interface NuiWindow {
+    /** Whether the window is currently visible. */
+    readonly visible: boolean;
+    /** Whether the window currently has input focus. */
+    readonly focused: boolean;
+    /** Opens the window, sets focused to true, and sends a 'ready' notification to C#. */
+    open(): void;
+    /** Closes the window, clears focus, and sends a 'close' notification to C#. */
+    close(): void;
+    /** Toggles window visibility between open and closed. */
+    toggle(): void;
+    /** Destroys the window controller, unsubscribing from C# window events and key listeners. */
+    destroy(): void;
+}
+/**
+ * Controller managing reactive visibility, focus, and backend events for a named NUI window.
+ */
+export declare class NuiWindowController implements NuiWindow {
+    private readonly windowName;
+    private readonly options;
+    private readonly client;
+    visible: boolean;
+    focused: boolean;
+    private destroyed;
+    private listeningForEscape;
+    private readonly unsubscribe;
+    constructor(windowName: string, options: NuiWindowOptions | undefined, client: SvelteNuiClient);
+    private syncEscapeListener;
+    private handleEscape;
+    private transition;
+    private notifyAndDispatch;
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+    private handleWindowAction;
+    destroy: () => void;
+}
+/**
+ * Reactive controller for a named NUI window.
+ * Synchronizes visibility and focus states with the FiveM C# backend.
+ *
+ * @param windowName - Window identifier matching backend events.
+ * @param options - Optional configuration (callbacks, Escape handling).
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { useNuiWindow } from '@fivem-nui/svelte';
+ *
+ *   const win = useNuiWindow('inventory', { closeOnEscape: true });
+ * </script>
+ *
+ * {#if win.visible}
+ *   <div class="panel">
+ *     <button onclick={() => win.close()}>Close</button>
+ *   </div>
+ * {/if}
+ * ```
+ */
+export declare function useNuiWindow(windowName: string, options?: NuiWindowOptions): NuiWindow;
+//# sourceMappingURL=window.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"window.svelte.d.ts","sourceRoot":"","sources":["../../src/runes/window.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAGjD;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,qBAAqB;IAC/B,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,CAAC;IAEzB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE3C;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,sFAAsF;IACtF,IAAI,IAAI,IAAI,CAAC;IAEb,+EAA+E;IAC/E,KAAK,IAAI,IAAI,CAAC;IAEd,yDAAyD;IACzD,MAAM,IAAI,IAAI,CAAC;IAEf,6FAA6F;IAC7F,OAAO,IAAI,IAAI,CAAC;CACjB;AAuBD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,SAAS;IASjD,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,UAAiB;IACxB,OAAO,UAAiB;IAExB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,YACmB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,YAAK,EAC9B,MAAM,EAAE,eAAe,EAQzC;IAED,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,YAAY,CAKlB;IAEF,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,iBAAiB;IA4BzB,IAAI,QAAO,IAAI,CAKb;IAEF,KAAK,QAAO,IAAI,CAKd;IAEF,MAAM,QAAO,IAAI,CAKf;IAEF,OAAO,CAAC,kBAAkB,CA2BxB;IAEF,OAAO,QAAO,IAAI,CAMhB;CACH;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAgBX"}