@open-core/framework 0.1.0-alpha.1

package/dist/client/services/streaming.service.d.ts

@@ -0,0 +1,165 @@
+export interface StreamingRequest {
+    type: 'model' | 'animDict' | 'ptfx' | 'texture' | 'audio';
+    asset: string;
+    loaded: boolean;
+    hash?: number;
+}
+/**
+ * Service for managing asset streaming (models, animations, particles, etc.).
+ */
+export declare class StreamingService {
+    private loadedAssets;
+    /**
+     * Request and load a model.
+     *
+     * @param model - Model name or hash
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the model was loaded successfully
+     */
+    requestModel(model: string | number, timeout?: number): Promise<boolean>;
+    /**
+     * Check if a model is loaded.
+     *
+     * @param model - Model name or hash
+     */
+    isModelLoaded(model: string | number): boolean;
+    /**
+     * Release a loaded model.
+     *
+     * @param model - Model name or hash
+     */
+    releaseModel(model: string | number): void;
+    /**
+     * Check if a model is valid and exists in the game files.
+     *
+     * @param model - Model name or hash
+     */
+    isModelValid(model: string | number): boolean;
+    /**
+     * Check if a model is a vehicle.
+     *
+     * @param model - Model name or hash
+     */
+    isModelVehicle(model: string | number): boolean;
+    /**
+     * Check if a model is a ped.
+     *
+     * @param model - Model name or hash
+     */
+    isModelPed(model: string | number): boolean;
+    /**
+     * Request and load an animation dictionary.
+     *
+     * @param dict - Animation dictionary name
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the dictionary was loaded successfully
+     */
+    requestAnimDict(dict: string, timeout?: number): Promise<boolean>;
+    /**
+     * Check if an animation dictionary is loaded.
+     *
+     * @param dict - Animation dictionary name
+     */
+    isAnimDictLoaded(dict: string): boolean;
+    /**
+     * Release a loaded animation dictionary.
+     *
+     * @param dict - Animation dictionary name
+     */
+    releaseAnimDict(dict: string): void;
+    /**
+     * Request and load a particle effect asset.
+     *
+     * @param asset - PTFX asset name
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the asset was loaded successfully
+     */
+    requestPtfxAsset(asset: string, timeout?: number): Promise<boolean>;
+    /**
+     * Check if a PTFX asset is loaded.
+     *
+     * @param asset - PTFX asset name
+     */
+    isPtfxAssetLoaded(asset: string): boolean;
+    /**
+     * Release a loaded PTFX asset.
+     *
+     * @param asset - PTFX asset name
+     */
+    releasePtfxAsset(asset: string): void;
+    /**
+     * Start a particle effect at a position.
+     *
+     * @param asset - PTFX asset name
+     * @param effectName - Effect name within the asset
+     * @param position - World position
+     * @param rotation - Rotation
+     * @param scale - Scale
+     * @param looped - Whether to loop
+     * @returns The particle effect handle
+     */
+    startParticleEffect(asset: string, effectName: string, position: {
+        x: number;
+        y: number;
+        z: number;
+    }, rotation?: {
+        x: number;
+        y: number;
+        z: number;
+    }, scale?: number, looped?: boolean): Promise<number>;
+    /**
+     * Stop a looped particle effect.
+     *
+     * @param handle - Particle effect handle
+     */
+    stopParticleEffect(handle: number): void;
+    /**
+     * Request and load a texture dictionary.
+     *
+     * @param dict - Texture dictionary name
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the dictionary was loaded successfully
+     */
+    requestTextureDict(dict: string, timeout?: number): Promise<boolean>;
+    /**
+     * Check if a texture dictionary is loaded.
+     *
+     * @param dict - Texture dictionary name
+     */
+    isTextureDictLoaded(dict: string): boolean;
+    /**
+     * Release a loaded texture dictionary.
+     *
+     * @param dict - Texture dictionary name
+     */
+    releaseTextureDict(dict: string): void;
+    /**
+     * Request and load a script audio bank.
+     *
+     * @param audioBank - Audio bank name
+     * @param networked - Whether the audio should be networked
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the audio bank was loaded successfully
+     */
+    requestAudioBank(audioBank: string, networked?: boolean, _timeout?: number): Promise<boolean>;
+    /**
+     * Release a loaded audio bank.
+     *
+     * @param audioBank - Audio bank name
+     */
+    releaseAudioBank(audioBank: string): void;
+    /**
+     * Get all currently loaded assets.
+     */
+    getLoadedAssets(): StreamingRequest[];
+    /**
+     * Release all loaded assets.
+     */
+    releaseAll(): void;
+    /**
+     * Get hash key for a string.
+     *
+     * @param str - String to hash
+     */
+    getHash(str: string): number;
+}

package/dist/client/services/streaming.service.js

@@ -0,0 +1,341 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamingService = void 0;
+const tsyringe_1 = require("tsyringe");
+/**
+ * Service for managing asset streaming (models, animations, particles, etc.).
+ */
+let StreamingService = class StreamingService {
+    constructor() {
+        this.loadedAssets = new Map();
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Model Loading
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Request and load a model.
+     *
+     * @param model - Model name or hash
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the model was loaded successfully
+     */
+    async requestModel(model, timeout = 10000) {
+        var _a;
+        const hash = typeof model === 'string' ? GetHashKey(model) : model;
+        const key = `model:${hash}`;
+        // Already loaded
+        if ((_a = this.loadedAssets.get(key)) === null || _a === void 0 ? void 0 : _a.loaded) {
+            return true;
+        }
+        // Check if valid
+        if (!IsModelInCdimage(hash) || !IsModelValid(hash)) {
+            return false;
+        }
+        RequestModel(hash);
+        const startTime = GetGameTimer();
+        while (!HasModelLoaded(hash)) {
+            if (GetGameTimer() - startTime > timeout) {
+                return false;
+            }
+            await new Promise((r) => setTimeout(r, 0));
+        }
+        this.loadedAssets.set(key, { type: 'model', asset: String(model), loaded: true, hash });
+        return true;
+    }
+    /**
+     * Check if a model is loaded.
+     *
+     * @param model - Model name or hash
+     */
+    isModelLoaded(model) {
+        const hash = typeof model === 'string' ? GetHashKey(model) : model;
+        return HasModelLoaded(hash);
+    }
+    /**
+     * Release a loaded model.
+     *
+     * @param model - Model name or hash
+     */
+    releaseModel(model) {
+        const hash = typeof model === 'string' ? GetHashKey(model) : model;
+        SetModelAsNoLongerNeeded(hash);
+        this.loadedAssets.delete(`model:${hash}`);
+    }
+    /**
+     * Check if a model is valid and exists in the game files.
+     *
+     * @param model - Model name or hash
+     */
+    isModelValid(model) {
+        const hash = typeof model === 'string' ? GetHashKey(model) : model;
+        return IsModelInCdimage(hash) && IsModelValid(hash);
+    }
+    /**
+     * Check if a model is a vehicle.
+     *
+     * @param model - Model name or hash
+     */
+    isModelVehicle(model) {
+        const hash = typeof model === 'string' ? GetHashKey(model) : model;
+        return IsModelAVehicle(hash);
+    }
+    /**
+     * Check if a model is a ped.
+     *
+     * @param model - Model name or hash
+     */
+    isModelPed(model) {
+        const hash = typeof model === 'string' ? GetHashKey(model) : model;
+        return IsModelAPed(hash);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Animation Dictionary Loading
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Request and load an animation dictionary.
+     *
+     * @param dict - Animation dictionary name
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the dictionary was loaded successfully
+     */
+    async requestAnimDict(dict, timeout = 10000) {
+        var _a;
+        const key = `anim:${dict}`;
+        // Already loaded
+        if ((_a = this.loadedAssets.get(key)) === null || _a === void 0 ? void 0 : _a.loaded) {
+            return true;
+        }
+        RequestAnimDict(dict);
+        const startTime = GetGameTimer();
+        while (!HasAnimDictLoaded(dict)) {
+            if (GetGameTimer() - startTime > timeout) {
+                return false;
+            }
+            await new Promise((r) => setTimeout(r, 0));
+        }
+        this.loadedAssets.set(key, { type: 'animDict', asset: dict, loaded: true });
+        return true;
+    }
+    /**
+     * Check if an animation dictionary is loaded.
+     *
+     * @param dict - Animation dictionary name
+     */
+    isAnimDictLoaded(dict) {
+        return HasAnimDictLoaded(dict);
+    }
+    /**
+     * Release a loaded animation dictionary.
+     *
+     * @param dict - Animation dictionary name
+     */
+    releaseAnimDict(dict) {
+        RemoveAnimDict(dict);
+        this.loadedAssets.delete(`anim:${dict}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Particle Effects (PTFX) Loading
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Request and load a particle effect asset.
+     *
+     * @param asset - PTFX asset name
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the asset was loaded successfully
+     */
+    async requestPtfxAsset(asset, timeout = 10000) {
+        var _a;
+        const key = `ptfx:${asset}`;
+        // Already loaded
+        if ((_a = this.loadedAssets.get(key)) === null || _a === void 0 ? void 0 : _a.loaded) {
+            return true;
+        }
+        RequestNamedPtfxAsset(asset);
+        const startTime = GetGameTimer();
+        while (!HasNamedPtfxAssetLoaded(asset)) {
+            if (GetGameTimer() - startTime > timeout) {
+                return false;
+            }
+            await new Promise((r) => setTimeout(r, 0));
+        }
+        this.loadedAssets.set(key, { type: 'ptfx', asset, loaded: true });
+        return true;
+    }
+    /**
+     * Check if a PTFX asset is loaded.
+     *
+     * @param asset - PTFX asset name
+     */
+    isPtfxAssetLoaded(asset) {
+        return HasNamedPtfxAssetLoaded(asset);
+    }
+    /**
+     * Release a loaded PTFX asset.
+     *
+     * @param asset - PTFX asset name
+     */
+    releasePtfxAsset(asset) {
+        RemoveNamedPtfxAsset(asset);
+        this.loadedAssets.delete(`ptfx:${asset}`);
+    }
+    /**
+     * Start a particle effect at a position.
+     *
+     * @param asset - PTFX asset name
+     * @param effectName - Effect name within the asset
+     * @param position - World position
+     * @param rotation - Rotation
+     * @param scale - Scale
+     * @param looped - Whether to loop
+     * @returns The particle effect handle
+     */
+    async startParticleEffect(asset, effectName, position, rotation = { x: 0, y: 0, z: 0 }, scale = 1.0, looped = false) {
+        await this.requestPtfxAsset(asset);
+        UseParticleFxAssetNextCall(asset);
+        if (looped) {
+            return StartParticleFxLoopedAtCoord(effectName, position.x, position.y, position.z, rotation.x, rotation.y, rotation.z, scale, false, false, false, false);
+        }
+        else {
+            return StartParticleFxNonLoopedAtCoord(effectName, position.x, position.y, position.z, rotation.x, rotation.y, rotation.z, scale, false, false, false);
+        }
+    }
+    /**
+     * Stop a looped particle effect.
+     *
+     * @param handle - Particle effect handle
+     */
+    stopParticleEffect(handle) {
+        StopParticleFxLooped(handle, false);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Texture Dictionary Loading
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Request and load a texture dictionary.
+     *
+     * @param dict - Texture dictionary name
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the dictionary was loaded successfully
+     */
+    async requestTextureDict(dict, timeout = 10000) {
+        var _a;
+        const key = `texture:${dict}`;
+        // Already loaded
+        if ((_a = this.loadedAssets.get(key)) === null || _a === void 0 ? void 0 : _a.loaded) {
+            return true;
+        }
+        RequestStreamedTextureDict(dict, true);
+        const startTime = GetGameTimer();
+        while (!HasStreamedTextureDictLoaded(dict)) {
+            if (GetGameTimer() - startTime > timeout) {
+                return false;
+            }
+            await new Promise((r) => setTimeout(r, 0));
+        }
+        this.loadedAssets.set(key, { type: 'texture', asset: dict, loaded: true });
+        return true;
+    }
+    /**
+     * Check if a texture dictionary is loaded.
+     *
+     * @param dict - Texture dictionary name
+     */
+    isTextureDictLoaded(dict) {
+        return HasStreamedTextureDictLoaded(dict);
+    }
+    /**
+     * Release a loaded texture dictionary.
+     *
+     * @param dict - Texture dictionary name
+     */
+    releaseTextureDict(dict) {
+        SetStreamedTextureDictAsNoLongerNeeded(dict);
+        this.loadedAssets.delete(`texture:${dict}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Audio Loading
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Request and load a script audio bank.
+     *
+     * @param audioBank - Audio bank name
+     * @param networked - Whether the audio should be networked
+     * @param timeout - Maximum wait time in ms
+     * @returns Whether the audio bank was loaded successfully
+     */
+    async requestAudioBank(audioBank, networked = false, _timeout = 10000) {
+        var _a;
+        const key = `audio:${audioBank}`;
+        // Already loaded
+        if ((_a = this.loadedAssets.get(key)) === null || _a === void 0 ? void 0 : _a.loaded) {
+            return true;
+        }
+        const success = RequestScriptAudioBank(audioBank, networked);
+        if (!success)
+            return false;
+        this.loadedAssets.set(key, { type: 'audio', asset: audioBank, loaded: true });
+        return true;
+    }
+    /**
+     * Release a loaded audio bank.
+     *
+     * @param audioBank - Audio bank name
+     */
+    releaseAudioBank(audioBank) {
+        ReleaseScriptAudioBank();
+        this.loadedAssets.delete(`audio:${audioBank}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // Utility Methods
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Get all currently loaded assets.
+     */
+    getLoadedAssets() {
+        return Array.from(this.loadedAssets.values());
+    }
+    /**
+     * Release all loaded assets.
+     */
+    releaseAll() {
+        for (const asset of this.loadedAssets.values()) {
+            switch (asset.type) {
+                case 'model':
+                    if (asset.hash)
+                        SetModelAsNoLongerNeeded(asset.hash);
+                    break;
+                case 'animDict':
+                    RemoveAnimDict(asset.asset);
+                    break;
+                case 'ptfx':
+                    RemoveNamedPtfxAsset(asset.asset);
+                    break;
+                case 'texture':
+                    SetStreamedTextureDictAsNoLongerNeeded(asset.asset);
+                    break;
+                case 'audio':
+                    ReleaseScriptAudioBank();
+                    break;
+            }
+        }
+        this.loadedAssets.clear();
+    }
+    /**
+     * Get hash key for a string.
+     *
+     * @param str - String to hash
+     */
+    getHash(str) {
+        return GetHashKey(str);
+    }
+};
+exports.StreamingService = StreamingService;
+exports.StreamingService = StreamingService = __decorate([
+    (0, tsyringe_1.injectable)()
+], StreamingService);

package/dist/client/services/textui.service.d.ts

@@ -0,0 +1,82 @@
+import type { Vector3 } from '../../utils';
+export interface TextUIOptions {
+    /** Font (0-8) */
+    font?: number;
+    /** Scale (0.0-1.0+) */
+    scale?: number;
+    /** Color */
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    /** Text alignment (0=center, 1=left, 2=right) */
+    alignment?: number;
+    /** Drop shadow */
+    dropShadow?: boolean;
+    /** Text outline */
+    outline?: boolean;
+    /** Word wrap width (0 = no wrap) */
+    wrapWidth?: number;
+}
+export interface Text3DOptions extends TextUIOptions {
+    /** Whether to draw a background behind text */
+    background?: boolean;
+    /** Background color */
+    backgroundColor?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    /** Background padding */
+    backgroundPadding?: number;
+}
+/**
+ * Service for rendering text UI elements on screen and in 3D world.
+ */
+export declare class TextUIService {
+    private activeTextUI;
+    private tickHandle;
+    /**
+     * Show persistent text UI at the bottom-right of the screen.
+     *
+     * @param text - The text to display
+     * @param options - Text options
+     */
+    show(text: string, options?: TextUIOptions): void;
+    /**
+     * Hide the persistent text UI.
+     */
+    hide(): void;
+    /**
+     * Check if text UI is currently visible.
+     */
+    isVisible(): boolean;
+    /**
+     * Draw text on screen for one frame.
+     * Call this every frame for persistent display.
+     *
+     * @param text - The text to draw
+     * @param x - Screen X position (0.0-1.0)
+     * @param y - Screen Y position (0.0-1.0)
+     * @param options - Text options
+     */
+    drawText(text: string, x: number, y: number, options?: TextUIOptions): void;
+    /**
+     * Draw 3D text in the game world.
+     *
+     * @param position - World position
+     * @param text - The text to draw
+     * @param options - Text options
+     */
+    drawText3D(position: Vector3, text: string, options?: Text3DOptions): void;
+    /**
+     * Get text width for layout calculations.
+     * Note: This is an approximation based on character count and scale.
+     */
+    getTextWidth(text: string, _font: number, scale: number): number;
+    private ensureTickRunning;
+    private stopTick;
+}