@open-core/framework 1.0.4-beta.1 → 1.0.5-beta.1

package/dist/runtime/client/system/processors/onRpc.processor.js

@@ -0,0 +1,62 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from 'tsyringe';
+import z from 'zod';
+import { RpcAPI } from '../../../../adapters/contracts/transport/rpc.api';
+import { coreLogger, LogDomain } from '../../../../kernel/logger';
+import { processTupleSchema } from '../../../server/helpers/process-tuple-schema';
+import { METADATA_KEYS } from '../metadata-client.keys';
+const clientRpcLogger = coreLogger.child('Rpc', LogDomain.CLIENT);
+let ClientOnRpcProcessor = class ClientOnRpcProcessor {
+    rpc;
+    metadataKey = METADATA_KEYS.NET_RPC;
+    constructor(rpc) {
+        this.rpc = rpc;
+    }
+    process(target, methodName, metadata) {
+        const handler = target[methodName].bind(target);
+        const handlerName = `${target.constructor.name}.${methodName}`;
+        const schema = metadata.schema;
+        this.rpc.on(metadata.eventName, async (_ctx, ...args) => {
+            try {
+                if (!schema) {
+                    return await handler(...args);
+                }
+                if (schema instanceof z.ZodTuple) {
+                    const processedArgs = processTupleSchema(schema, args);
+                    const validatedArgs = schema.parse(processedArgs);
+                    return await handler(...validatedArgs);
+                }
+                if (args.length !== 1) {
+                    throw new Error(`Invalid argument count in ${metadata.eventName}`);
+                }
+                const validated = schema.parse(args[0]);
+                return await handler(validated);
+            }
+            catch (error) {
+                clientRpcLogger.error(`Handler error in RPC`, {
+                    event: metadata.eventName,
+                    handler: handlerName,
+                }, error);
+                throw error;
+            }
+        });
+        clientRpcLogger.debug(`Registered: ${metadata.eventName} -> ${handlerName}`);
+    }
+};
+ClientOnRpcProcessor = __decorate([
+    injectable(),
+    __param(0, inject(RpcAPI)),
+    __metadata("design:paramtypes", [RpcAPI])
+], ClientOnRpcProcessor);
+export { ClientOnRpcProcessor };

package/dist/runtime/client/system/processors/resourceLifecycle.processor.d.ts

@@ -0,0 +1,9 @@
+import { DecoratorProcessor } from '../../../../kernel/di/decorator-processor';
+export declare class ResourceStartProcessor implements DecoratorProcessor {
+    readonly metadataKey: string;
+    process(target: any, methodName: string): void;
+}
+export declare class ResourceStopProcessor implements DecoratorProcessor {
+    readonly metadataKey: string;
+    process(target: any, methodName: string): void;
+}

package/dist/runtime/client/system/processors/resourceLifecycle.processor.js

@@ -0,0 +1,62 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { injectable } from 'tsyringe';
+import { coreLogger, LogDomain } from '../../../../kernel/logger';
+import { METADATA_KEYS } from '../metadata-client.keys';
+const clientLifecycle = coreLogger.child('Lifecycle', LogDomain.CLIENT);
+let ResourceStartProcessor = class ResourceStartProcessor {
+    metadataKey = METADATA_KEYS.RESOURCE_START;
+    process(target, methodName) {
+        const handler = target[methodName].bind(target);
+        const handlerName = `${target.constructor.name}.${methodName}`;
+        const currentResource = GetCurrentResourceName();
+        on('onClientResourceStart', async (resourceName) => {
+            if (resourceName !== currentResource)
+                return;
+            try {
+                await handler(resourceName);
+            }
+            catch (error) {
+                clientLifecycle.error(`Resource start handler error`, {
+                    handler: handlerName,
+                    resource: resourceName,
+                }, error);
+            }
+        });
+        clientLifecycle.debug(`Registered resource start handler: ${handlerName}`);
+    }
+};
+ResourceStartProcessor = __decorate([
+    injectable()
+], ResourceStartProcessor);
+export { ResourceStartProcessor };
+let ResourceStopProcessor = class ResourceStopProcessor {
+    metadataKey = METADATA_KEYS.RESOURCE_STOP;
+    process(target, methodName) {
+        const handler = target[methodName].bind(target);
+        const handlerName = `${target.constructor.name}.${methodName}`;
+        const currentResource = GetCurrentResourceName();
+        on('onClientResourceStop', async (resourceName) => {
+            if (resourceName !== currentResource)
+                return;
+            try {
+                await handler(resourceName);
+            }
+            catch (error) {
+                clientLifecycle.error(`Resource stop handler error`, {
+                    handler: handlerName,
+                    resource: resourceName,
+                }, error);
+            }
+        });
+        clientLifecycle.debug(`Registered resource stop handler: ${handlerName}`);
+    }
+};
+ResourceStopProcessor = __decorate([
+    injectable()
+], ResourceStopProcessor);
+export { ResourceStopProcessor };

package/dist/runtime/client/system/processors/tick.processor.d.ts

@@ -0,0 +1,5 @@
+import { DecoratorProcessor } from '../../../../kernel/di/decorator-processor';
+export declare class TickProcessor implements DecoratorProcessor {
+    readonly metadataKey: string;
+    process(target: any, methodName: string): void;
+}

package/dist/runtime/client/system/processors/tick.processor.js

@@ -0,0 +1,32 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { injectable } from 'tsyringe';
+import { coreLogger, LogDomain } from '../../../../kernel/logger';
+import { METADATA_KEYS } from '../metadata-client.keys';
+const clientTick = coreLogger.child('Tick', LogDomain.CLIENT);
+let TickProcessor = class TickProcessor {
+    metadataKey = METADATA_KEYS.TICK;
+    process(target, methodName) {
+        const handler = target[methodName].bind(target);
+        const handlerName = `${target.constructor.name}.${methodName}`;
+        setTick(async () => {
+            try {
+                await handler();
+            }
+            catch (error) {
+                clientTick.error(`Tick handler error`, {
+                    handler: handlerName,
+                }, error);
+            }
+        });
+        clientTick.debug(`Registered: ${handlerName}`);
+    }
+};
+TickProcessor = __decorate([
+    injectable()
+], TickProcessor);
+export { TickProcessor };

package/dist/runtime/client/system/processors/view.processor.d.ts

@@ -0,0 +1,7 @@
+import { DecoratorProcessor } from '../../../../kernel/di/decorator-processor';
+export declare class ViewProcessor implements DecoratorProcessor {
+    readonly metadataKey: string;
+    process(target: any, methodName: string, metadata: {
+        eventName: string;
+    }): void;
+}

package/dist/runtime/client/system/processors/view.processor.js

@@ -0,0 +1,36 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { injectable } from 'tsyringe';
+import { loggers } from '../../../../kernel/logger';
+import { METADATA_KEYS } from '../metadata-client.keys';
+let ViewProcessor = class ViewProcessor {
+    metadataKey = METADATA_KEYS.VIEW;
+    process(target, methodName, metadata) {
+        const handler = target[methodName].bind(target);
+        const handlerName = `${target.constructor.name}.${methodName}`;
+        RegisterNuiCallbackType(metadata.eventName);
+        on(`__cfx_nui:${metadata.eventName}`, async (data, cb) => {
+            try {
+                const result = await handler(data);
+                cb({ ok: true, data: result });
+            }
+            catch (error) {
+                loggers.nui.error(`NUI callback error`, {
+                    event: metadata.eventName,
+                    handler: handlerName,
+                }, error);
+                const message = error instanceof Error ? error.message : String(error);
+                cb({ ok: false, error: message });
+            }
+        });
+        loggers.nui.debug(`Registered: ${metadata.eventName} -> ${handlerName}`);
+    }
+};
+ViewProcessor = __decorate([
+    injectable()
+], ViewProcessor);
+export { ViewProcessor };

package/dist/runtime/client/system/processors.register.js

@@ -0,0 +1,28 @@
+import { di } from '../client-container';
+import { ClientExportProcessor } from './processors/export.processor';
+import { GameEventProcessor } from './processors/gameEvent.processor';
+import { IntervalProcessor } from './processors/interval.processor';
+import { KeyMappingProcessor } from './processors/key.processor';
+import { ClientLibraryEventProcessor } from './processors/libraryEvent.processor';
+import { LocalEventProcessor } from './processors/localEvent.processor';
+import { ClientNetEventProcessor } from './processors/netEvent.processor';
+import { ClientOnRpcProcessor } from './processors/onRpc.processor';
+import { ViewProcessor } from './processors/view.processor';
+import { ResourceStartProcessor, ResourceStopProcessor, } from './processors/resourceLifecycle.processor';
+import { TickProcessor } from './processors/tick.processor';
+export function registerSystemClient() {
+    // Core processors
+    di.register('DecoratorProcessor', { useClass: KeyMappingProcessor });
+    di.register('DecoratorProcessor', { useClass: TickProcessor });
+    di.register('DecoratorProcessor', { useClass: ViewProcessor });
+    di.register('DecoratorProcessor', { useClass: ClientNetEventProcessor });
+    di.register('DecoratorProcessor', { useClass: ClientOnRpcProcessor });
+    // New processors
+    di.register('DecoratorProcessor', { useClass: LocalEventProcessor });
+    di.register('DecoratorProcessor', { useClass: ClientLibraryEventProcessor });
+    di.register('DecoratorProcessor', { useClass: IntervalProcessor });
+    di.register('DecoratorProcessor', { useClass: ClientExportProcessor });
+    di.register('DecoratorProcessor', { useClass: ResourceStartProcessor });
+    di.register('DecoratorProcessor', { useClass: ResourceStopProcessor });
+    di.register('DecoratorProcessor', { useClass: GameEventProcessor });
+}

package/dist/runtime/client/types/game-events.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Game Events - low-level events captured by CitizenFX runtimes
+ *
+ * Documentation: https://docs.fivem.net/docs/game-references/game-events/
+ *
+ * These are low-level events from the RAGE engine. The arguments are
+ * passed as arrays from the native layer.
+ *
+ * Note: this list is GTA5-oriented and may differ on RedM (rdr3).
+ */
+export type GameEventName = 'CEventNetworkEntityDamage' | 'CEventNetworkPlayerEnteredVehicle' | 'CEventNetworkPlayerLeftVehicle' | 'CEventNetworkVehicleUndrivable' | 'CEventNetworkPlayerSpawn' | 'CEventNetworkPlayerCollectedPickup' | 'CEventNetworkPlayerCollectedAmbientPickup' | 'CEventShockingSeenPedKilled' | 'CEventShockingWeaponThreat' | 'CEventShockingGunshotFired' | 'CEventShockingExplosion' | 'CEventGunShot' | 'CEventGunShotWhizzedBy' | 'CEventExplosionHeard' | 'CEventShockingCarCrash' | 'CEventShockingBicycleCrash' | 'CEventShockingSeenCarStolen' | (string & {});
+/**
+ * CEventNetworkEntityDamage
+ * Fired when any networked entity takes damage
+ */
+export interface EntityDamageEvent {
+    /** Entity that was damaged */
+    victim: number;
+    /** Entity that caused the damage (0 if none) */
+    attacker: number;
+    /** Unknown parameter */
+    arg2: number;
+    /** Unknown parameter */
+    arg3: number;
+    /** Unknown parameter */
+    arg4: number;
+    /** Whether the victim died from this damage */
+    victimDied: boolean;
+    /** Weapon hash used */
+    weaponHash: number;
+    /** Unknown parameter */
+    arg7: number;
+    /** Unknown parameter */
+    arg8: number;
+    /** Unknown parameter - possibly damage amount related */
+    arg9: number;
+}
+/**
+ * CEventNetworkPlayerEnteredVehicle
+ * Fired when a player enters a vehicle
+ */
+export interface PlayerEnteredVehicleEvent {
+    /** Player that entered */
+    player: number;
+    /** Vehicle entered */
+    vehicle: number;
+}
+/**
+ * CEventNetworkPlayerLeftVehicle
+ * Fired when a player leaves a vehicle
+ */
+export interface PlayerLeftVehicleEvent {
+    /** Player that left */
+    player: number;
+    /** Vehicle left */
+    vehicle: number;
+}
+/**
+ * CEventShockingSeenPedKilled
+ * Fired when a ped witnesses another ped being killed
+ */
+export interface SeenPedKilledEvent {
+    /** Ped that witnessed the death */
+    witness: number;
+    /** Ped that was killed */
+    victim: number;
+}
+/**
+ * CEventGunShot
+ * Fired when a weapon is fired
+ */
+export interface GunShotEvent {
+    /** Entity that fired */
+    shooter: number;
+    /** Target coordinates */
+    coords: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+/**
+ * CEventNetworkVehicleUndrivable
+ * Fired when a vehicle becomes undrivable (destroyed)
+ */
+export interface VehicleUndrivableEvent {
+    /** Vehicle that became undrivable */
+    vehicle: number;
+    /** Entity responsible (if any) */
+    attacker: number;
+    /** Weapon hash that caused it */
+    weaponHash: number;
+}
+export declare const GameEventParsers: {
+    /**
+     * Parse CEventNetworkEntityDamage arguments
+     */
+    parseEntityDamage(args: number[]): EntityDamageEvent;
+    /**
+     * Parse CEventNetworkPlayerEnteredVehicle arguments
+     */
+    parsePlayerEnteredVehicle(args: number[]): PlayerEnteredVehicleEvent;
+    /**
+     * Parse CEventNetworkPlayerLeftVehicle arguments
+     */
+    parsePlayerLeftVehicle(args: number[]): PlayerLeftVehicleEvent;
+    /**
+     * Parse CEventShockingSeenPedKilled arguments
+     */
+    parseSeenPedKilled(args: number[]): SeenPedKilledEvent;
+    /**
+     * Parse CEventNetworkVehicleUndrivable arguments
+     */
+    parseVehicleUndrivable(args: number[]): VehicleUndrivableEvent;
+    /**
+     * Parse CEventGunShot arguments
+     */
+    parseGunShot(args: number[]): GunShotEvent;
+};
+export interface GameEventMap {
+    CEventNetworkEntityDamage: EntityDamageEvent;
+    CEventNetworkPlayerEnteredVehicle: PlayerEnteredVehicleEvent;
+    CEventNetworkPlayerLeftVehicle: PlayerLeftVehicleEvent;
+    CEventShockingSeenPedKilled: SeenPedKilledEvent;
+    CEventNetworkVehicleUndrivable: VehicleUndrivableEvent;
+    CEventGunShot: GunShotEvent;
+    [key: string]: unknown;
+}

package/dist/runtime/client/types/game-events.js

@@ -0,0 +1,72 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// Event Parsers - Convert raw args to typed objects
+// ─────────────────────────────────────────────────────────────────────────────
+export const GameEventParsers = {
+    /**
+     * Parse CEventNetworkEntityDamage arguments
+     */
+    parseEntityDamage(args) {
+        return {
+            victim: args[0],
+            attacker: args[1],
+            arg2: args[2],
+            arg3: args[3],
+            arg4: args[4],
+            victimDied: args[5] === 1,
+            weaponHash: args[6],
+            arg7: args[7],
+            arg8: args[8],
+            arg9: args[9],
+        };
+    },
+    /**
+     * Parse CEventNetworkPlayerEnteredVehicle arguments
+     */
+    parsePlayerEnteredVehicle(args) {
+        return {
+            player: args[0],
+            vehicle: args[1],
+        };
+    },
+    /**
+     * Parse CEventNetworkPlayerLeftVehicle arguments
+     */
+    parsePlayerLeftVehicle(args) {
+        return {
+            player: args[0],
+            vehicle: args[1],
+        };
+    },
+    /**
+     * Parse CEventShockingSeenPedKilled arguments
+     */
+    parseSeenPedKilled(args) {
+        return {
+            witness: args[0],
+            victim: args[1],
+        };
+    },
+    /**
+     * Parse CEventNetworkVehicleUndrivable arguments
+     */
+    parseVehicleUndrivable(args) {
+        return {
+            vehicle: args[0],
+            attacker: args[1],
+            weaponHash: args[2],
+        };
+    },
+    /**
+     * Parse CEventGunShot arguments
+     */
+    parseGunShot(args) {
+        return {
+            shooter: args[0],
+            coords: {
+                x: args[1],
+                y: args[2],
+                z: args[3],
+            },
+        };
+    },
+};

package/dist/runtime/client/types/index.js

@@ -0,0 +1 @@
+export * from './game-events';

package/dist/runtime/client/ui-bridge.js

@@ -0,0 +1,196 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { injectable } from 'tsyringe';
+import { coreLogger, LogDomain } from '../../kernel/logger';
+const nuiLogger = coreLogger.child('NUI', LogDomain.CLIENT);
+/**
+ * Type-safe NUI (Native UI) Bridge for client-server communication.
+ *
+ * Generic types allow for full type safety when sending/receiving messages.
+ * Define your event maps and pass them as type parameters.
+ *
+ * @example
+ * ```typescript
+ * interface ClientToUI {
+ *   'showMenu': { items: string[] }
+ *   'hideMenu': void
+ * }
+ *
+ * interface UIToClient {
+ *   'menuItemSelected': { index: number }
+ *   'menuClosed': void
+ * }
+ *
+ * const nui = new NuiBridge<ClientToUI, UIToClient>()
+ * nui.send('showMenu', { items: ['Option 1', 'Option 2'] })
+ * nui.on('menuItemSelected', async (data) => console.log(data.index))
+ * ```
+ */
+let NuiBridge = class NuiBridge {
+    _isVisible = false;
+    _hasFocus = false;
+    _hasCursor = false;
+    /**
+     * Whether the NUI frame is currently visible
+     */
+    get isVisible() {
+        return this._isVisible;
+    }
+    /**
+     * Whether the NUI has input focus
+     */
+    get hasFocus() {
+        return this._hasFocus;
+    }
+    /**
+     * Whether the cursor is visible
+     */
+    get hasCursor() {
+        return this._hasCursor;
+    }
+    /**
+     * Send a message to the NUI (UI frame).
+     *
+     * @param action - The action/event name
+     * @param data - The data payload
+     */
+    send(action, data) {
+        SendNuiMessage(JSON.stringify({ action, data }));
+        nuiLogger.debug(`Sent message: ${action}`);
+    }
+    /**
+     * Send a raw message to the NUI without type checking.
+     *
+     * @param action - The action/event name
+     * @param data - The data payload
+     */
+    sendRaw(action, data) {
+        SendNuiMessage(JSON.stringify({ action, data }));
+        nuiLogger.debug(`Sent raw message: ${action}`);
+    }
+    /**
+     * Register a callback for NUI events from the UI.
+     *
+     * @param action - The action/event name to listen for
+     * @param handler - The callback handler
+     * @returns Cleanup function to unregister the callback
+     */
+    on(action, handler) {
+        RegisterNuiCallbackType(action);
+        on(`__cfx_nui:${action}`, async (data, cb) => {
+            try {
+                await handler(data);
+                cb({ ok: true });
+            }
+            catch (error) {
+                nuiLogger.error(`NUI callback error`, { action }, error);
+                cb({ ok: false, error: String(error) });
+            }
+        });
+        nuiLogger.debug(`Registered callback: ${action}`);
+    }
+    /**
+     * Register a callback that expects a return value.
+     *
+     * @param action - The action/event name to listen for
+     * @param handler - The callback handler that returns data
+     */
+    onWithResponse(action, handler) {
+        RegisterNuiCallbackType(action);
+        on(`__cfx_nui:${action}`, async (data, cb) => {
+            try {
+                const result = await handler(data);
+                cb({ ok: true, data: result });
+            }
+            catch (error) {
+                nuiLogger.error(`NUI callback error`, { action }, error);
+                cb({ ok: false, error: String(error) });
+            }
+        });
+        nuiLogger.debug(`Registered callback with response: ${action}`);
+    }
+    /**
+     * Set NUI focus state.
+     *
+     * @param hasFocus - Whether the NUI should have input focus
+     * @param hasCursor - Whether to show the cursor (defaults to hasFocus value)
+     */
+    focus(hasFocus, hasCursor) {
+        this._hasFocus = hasFocus;
+        this._hasCursor = hasCursor ?? hasFocus;
+        SetNuiFocus(this._hasFocus, this._hasCursor);
+        nuiLogger.debug(`Focus set: focus=${this._hasFocus}, cursor=${this._hasCursor}`);
+    }
+    /**
+     * Remove NUI focus (convenience method).
+     */
+    blur() {
+        this.focus(false, false);
+    }
+    /**
+     * Set NUI visibility state.
+     * Note: This only tracks state, you need to handle actual visibility in your UI.
+     *
+     * @param visible - Whether the NUI should be visible
+     */
+    setVisible(visible) {
+        this._isVisible = visible;
+        this.send('setVisible', { visible });
+        nuiLogger.debug(`Visibility set: ${visible}`);
+    }
+    /**
+     * Show the NUI and optionally set focus.
+     *
+     * @param withFocus - Whether to also set focus
+     * @param withCursor - Whether to show cursor (defaults to withFocus)
+     */
+    show(withFocus = true, withCursor) {
+        this.setVisible(true);
+        if (withFocus) {
+            this.focus(true, withCursor);
+        }
+    }
+    /**
+     * Hide the NUI and remove focus.
+     */
+    hide() {
+        this.setVisible(false);
+        this.blur();
+    }
+    /**
+     * Toggle NUI visibility.
+     *
+     * @param withFocus - Whether to set focus when showing
+     */
+    toggle(withFocus = true) {
+        if (this._isVisible) {
+            this.hide();
+        }
+        else {
+            this.show(withFocus);
+        }
+    }
+    /**
+     * Keep input focus but allow game input.
+     * Useful for HUDs that need to capture some keys but not all.
+     *
+     * @param keepInput - Whether to keep game input enabled
+     */
+    setKeepInput(keepInput) {
+        SetNuiFocusKeepInput(keepInput);
+        nuiLogger.debug(`Keep input set: ${keepInput}`);
+    }
+};
+NuiBridge = __decorate([
+    injectable()
+], NuiBridge);
+export { NuiBridge };
+/**
+ * Default untyped NUI instance for quick usage.
+ * For type-safe usage, create your own instance with proper generics.
+ */
+export const NUI = new NuiBridge();