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

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

@@ -1,165 +0,0 @@
-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

@@ -1,341 +0,0 @@
-"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

@@ -1,82 +0,0 @@
-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;
-}