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

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;
-}

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

@@ -1,156 +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.TextUIService = void 0;
-const tsyringe_1 = require("tsyringe");
-const DEFAULT_OPTIONS = {
-    font: 4,
-    scale: 0.35,
-    color: { r: 255, g: 255, b: 255, a: 255 },
-    alignment: 0,
-    dropShadow: true,
-    outline: false,
-    wrapWidth: 0,
-};
-const DEFAULT_3D_OPTIONS = Object.assign(Object.assign({}, DEFAULT_OPTIONS), { scale: 0.25, background: false, backgroundColor: { r: 0, g: 0, b: 0, a: 150 }, backgroundPadding: 0.002 });
-/**
- * Service for rendering text UI elements on screen and in 3D world.
- */
-let TextUIService = class TextUIService {
-    constructor() {
-        this.activeTextUI = null;
-        this.tickHandle = null;
-    }
-    /**
-     * Show persistent text UI at the bottom-right of the screen.
-     *
-     * @param text - The text to display
-     * @param options - Text options
-     */
-    show(text, options = {}) {
-        this.activeTextUI = {
-            text,
-            options: Object.assign(Object.assign({}, DEFAULT_OPTIONS), options),
-        };
-        this.ensureTickRunning();
-    }
-    /**
-     * Hide the persistent text UI.
-     */
-    hide() {
-        this.activeTextUI = null;
-        this.stopTick();
-    }
-    /**
-     * Check if text UI is currently visible.
-     */
-    isVisible() {
-        return this.activeTextUI !== null;
-    }
-    /**
-     * 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, x, y, options = {}) {
-        const opts = Object.assign(Object.assign({}, DEFAULT_OPTIONS), options);
-        SetTextFont(opts.font);
-        SetTextScale(opts.scale, opts.scale);
-        SetTextColour(opts.color.r, opts.color.g, opts.color.b, opts.color.a);
-        SetTextJustification(opts.alignment);
-        if (opts.dropShadow) {
-            SetTextDropshadow(0, 0, 0, 0, 255);
-            SetTextDropShadow();
-        }
-        if (opts.outline) {
-            SetTextOutline();
-        }
-        if (opts.wrapWidth > 0) {
-            SetTextWrap(x, x + opts.wrapWidth);
-        }
-        if (opts.alignment === 2) {
-            SetTextRightJustify(true);
-            SetTextWrap(0.0, x);
-        }
-        BeginTextCommandDisplayText('STRING');
-        AddTextComponentString(text);
-        EndTextCommandDisplayText(x, y);
-    }
-    /**
-     * Draw 3D text in the game world.
-     *
-     * @param position - World position
-     * @param text - The text to draw
-     * @param options - Text options
-     */
-    drawText3D(position, text, options = {}) {
-        const opts = Object.assign(Object.assign({}, DEFAULT_3D_OPTIONS), options);
-        const [onScreen, screenX, screenY] = World3dToScreen2d(position.x, position.y, position.z);
-        if (!onScreen)
-            return;
-        // Calculate distance-based scale
-        const camCoords = GetGameplayCamCoords();
-        const distance = GetDistanceBetweenCoords(camCoords[0], camCoords[1], camCoords[2], position.x, position.y, position.z, true);
-        const scale = opts.scale * (1 / distance) * 2;
-        const scaledScale = Math.max(scale, 0.15);
-        // Draw background if enabled
-        if (opts.background) {
-            const factor = text.length / 300;
-            DrawRect(screenX, screenY + opts.backgroundPadding, factor + opts.backgroundPadding * 2, 0.03 + opts.backgroundPadding * 2, opts.backgroundColor.r, opts.backgroundColor.g, opts.backgroundColor.b, opts.backgroundColor.a);
-        }
-        // Draw text
-        SetTextScale(scaledScale, scaledScale);
-        SetTextFont(opts.font);
-        SetTextColour(opts.color.r, opts.color.g, opts.color.b, opts.color.a);
-        SetTextCentre(true);
-        if (opts.dropShadow) {
-            SetTextDropshadow(0, 0, 0, 0, 255);
-            SetTextDropShadow();
-        }
-        if (opts.outline) {
-            SetTextOutline();
-        }
-        BeginTextCommandDisplayText('STRING');
-        AddTextComponentString(text);
-        EndTextCommandDisplayText(screenX, screenY);
-    }
-    /**
-     * Get text width for layout calculations.
-     * Note: This is an approximation based on character count and scale.
-     */
-    getTextWidth(text, _font, scale) {
-        // Approximate text width based on character count and scale
-        // Average character width at scale 1.0 is approximately 0.01
-        return text.length * 0.01 * scale;
-    }
-    ensureTickRunning() {
-        if (this.tickHandle !== null)
-            return;
-        this.tickHandle = setTick(() => {
-            if (!this.activeTextUI)
-                return;
-            const { text, options } = this.activeTextUI;
-            // Draw at bottom-right
-            this.drawText(text, 0.985, 0.93, Object.assign(Object.assign({}, options), { alignment: 2 }));
-        });
-    }
-    stopTick() {
-        if (this.tickHandle !== null) {
-            clearTick(this.tickHandle);
-            this.tickHandle = null;
-        }
-    }
-};
-exports.TextUIService = TextUIService;
-exports.TextUIService = TextUIService = __decorate([
-    (0, tsyringe_1.injectable)()
-], TextUIService);