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

package/dist/runtime/client/services/index.d.ts

@@ -0,0 +1,14 @@
+export * from './blip.service';
+export * from './camera';
+export * from './camera-effects.registry';
+export * from './cinematic-builder';
+export * from './cinematic';
+export * from './marker.service';
+export * from './notification.service';
+export * from './ped.service';
+export * from './progress.service';
+export * from './spawn.service';
+export * from './streaming.service';
+export * from './textui.service';
+export * from './vehicle.service';
+export * from './vehicle-client.service';

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

@@ -0,0 +1,14 @@
+export * from './blip.service';
+export * from './camera';
+export * from './camera-effects.registry';
+export * from './cinematic-builder';
+export * from './cinematic';
+export * from './marker.service';
+export * from './notification.service';
+export * from './ped.service';
+export * from './progress.service';
+export * from './spawn.service';
+export * from './streaming.service';
+export * from './textui.service';
+export * from './vehicle.service';
+export * from './vehicle-client.service';

package/dist/runtime/client/services/marker.service.d.ts

@@ -0,0 +1,94 @@
+import { Vector3 } from '../../../kernel/utils/vector3';
+export interface MarkerOptions {
+    /** Marker type (0-43) */
+    type?: number;
+    /** Scale of the marker */
+    scale?: Vector3;
+    /** Rotation of the marker */
+    rotation?: Vector3;
+    /** Color (RGBA) */
+    color?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+    /** Whether the marker should bob up and down */
+    bobUpAndDown?: boolean;
+    /** Whether the marker should face the camera */
+    faceCamera?: boolean;
+    /** Whether the marker should rotate */
+    rotate?: boolean;
+    /** Draw on entities */
+    drawOnEnts?: boolean;
+}
+export interface ManagedMarker {
+    id: string;
+    position: Vector3;
+    options: Required<MarkerOptions>;
+    visible: boolean;
+}
+/**
+ * Service for managing and rendering markers in the game world.
+ * Handles automatic rendering via tick.
+ */
+export declare class MarkerService {
+    private markers;
+    private tickHandle;
+    private idCounter;
+    /**
+     * Create a new managed marker.
+     *
+     * @param position - World position for the marker
+     * @param options - Marker appearance options
+     * @returns The marker ID
+     */
+    create(position: Vector3, options?: MarkerOptions): string;
+    /**
+     * Remove a marker by ID.
+     *
+     * @param id - The marker ID to remove
+     */
+    remove(id: string): boolean;
+    /**
+     * Remove all markers.
+     */
+    removeAll(): void;
+    /**
+     * Update a marker's position.
+     *
+     * @param id - The marker ID
+     * @param position - New position
+     */
+    setPosition(id: string, position: Vector3): boolean;
+    /**
+     * Update marker options.
+     *
+     * @param id - The marker ID
+     * @param options - Options to update
+     */
+    setOptions(id: string, options: Partial<MarkerOptions>): boolean;
+    /**
+     * Set marker visibility.
+     *
+     * @param id - The marker ID
+     * @param visible - Whether the marker should be visible
+     */
+    setVisible(id: string, visible: boolean): boolean;
+    /**
+     * Get a marker by ID.
+     */
+    get(id: string): ManagedMarker | undefined;
+    /**
+     * Get all managed markers.
+     */
+    getAll(): ManagedMarker[];
+    /**
+     * Draw a marker immediately (one frame only).
+     * For persistent markers, use create() instead.
+     */
+    drawOnce(position: Vector3, options?: MarkerOptions): void;
+    private ensureTickRunning;
+    private stopTick;
+    private checkTickNeeded;
+}

package/dist/runtime/client/services/marker.service.js

@@ -0,0 +1,148 @@
+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';
+const DEFAULT_OPTIONS = {
+    type: 1,
+    scale: { x: 1.0, y: 1.0, z: 1.0 },
+    rotation: { x: 0, y: 0, z: 0 },
+    color: { r: 255, g: 0, b: 0, a: 200 },
+    bobUpAndDown: false,
+    faceCamera: false,
+    rotate: false,
+    drawOnEnts: false,
+};
+/**
+ * Service for managing and rendering markers in the game world.
+ * Handles automatic rendering via tick.
+ */
+let MarkerService = class MarkerService {
+    markers = new Map();
+    tickHandle = null;
+    idCounter = 0;
+    /**
+     * Create a new managed marker.
+     *
+     * @param position - World position for the marker
+     * @param options - Marker appearance options
+     * @returns The marker ID
+     */
+    create(position, options = {}) {
+        const id = `marker_${++this.idCounter}`;
+        const marker = {
+            id,
+            position,
+            options: { ...DEFAULT_OPTIONS, ...options },
+            visible: true,
+        };
+        this.markers.set(id, marker);
+        this.ensureTickRunning();
+        return id;
+    }
+    /**
+     * Remove a marker by ID.
+     *
+     * @param id - The marker ID to remove
+     */
+    remove(id) {
+        const deleted = this.markers.delete(id);
+        this.checkTickNeeded();
+        return deleted;
+    }
+    /**
+     * Remove all markers.
+     */
+    removeAll() {
+        this.markers.clear();
+        this.stopTick();
+    }
+    /**
+     * Update a marker's position.
+     *
+     * @param id - The marker ID
+     * @param position - New position
+     */
+    setPosition(id, position) {
+        const marker = this.markers.get(id);
+        if (!marker)
+            return false;
+        marker.position = position;
+        return true;
+    }
+    /**
+     * Update marker options.
+     *
+     * @param id - The marker ID
+     * @param options - Options to update
+     */
+    setOptions(id, options) {
+        const marker = this.markers.get(id);
+        if (!marker)
+            return false;
+        marker.options = { ...marker.options, ...options };
+        return true;
+    }
+    /**
+     * Set marker visibility.
+     *
+     * @param id - The marker ID
+     * @param visible - Whether the marker should be visible
+     */
+    setVisible(id, visible) {
+        const marker = this.markers.get(id);
+        if (!marker)
+            return false;
+        marker.visible = visible;
+        return true;
+    }
+    /**
+     * Get a marker by ID.
+     */
+    get(id) {
+        return this.markers.get(id);
+    }
+    /**
+     * Get all managed markers.
+     */
+    getAll() {
+        return Array.from(this.markers.values());
+    }
+    /**
+     * Draw a marker immediately (one frame only).
+     * For persistent markers, use create() instead.
+     */
+    drawOnce(position, options = {}) {
+        const opts = { ...DEFAULT_OPTIONS, ...options };
+        DrawMarker(opts.type, position.x, position.y, position.z, 0, 0, 0, opts.rotation.x, opts.rotation.y, opts.rotation.z, opts.scale.x, opts.scale.y, opts.scale.z, opts.color.r, opts.color.g, opts.color.b, opts.color.a, opts.bobUpAndDown, opts.faceCamera, 2, opts.rotate, null, null, opts.drawOnEnts);
+    }
+    ensureTickRunning() {
+        if (this.tickHandle !== null)
+            return;
+        this.tickHandle = setTick(() => {
+            for (const marker of this.markers.values()) {
+                if (!marker.visible)
+                    continue;
+                const { position, options } = marker;
+                DrawMarker(options.type, position.x, position.y, position.z, 0, 0, 0, options.rotation.x, options.rotation.y, options.rotation.z, options.scale.x, options.scale.y, options.scale.z, options.color.r, options.color.g, options.color.b, options.color.a, options.bobUpAndDown, options.faceCamera, 2, options.rotate, null, null, options.drawOnEnts);
+            }
+        });
+    }
+    stopTick() {
+        if (this.tickHandle !== null) {
+            clearTick(this.tickHandle);
+            this.tickHandle = null;
+        }
+    }
+    checkTickNeeded() {
+        if (this.markers.size === 0) {
+            this.stopTick();
+        }
+    }
+};
+MarkerService = __decorate([
+    injectable()
+], MarkerService);
+export { MarkerService };

package/dist/runtime/client/services/notification.service.js

@@ -0,0 +1,108 @@
+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';
+/**
+ * Service for displaying native GTA V notifications.
+ */
+let NotificationService = class NotificationService {
+    /**
+     * Show a simple notification on screen.
+     *
+     * @param message - The message to display
+     * @param blink - Whether the notification should blink
+     */
+    show(message, blink = false) {
+        SetNotificationTextEntry('STRING');
+        AddTextComponentString(message);
+        DrawNotification(blink, true);
+    }
+    /**
+     * Show a notification with a type indicator using throbber icons.
+     *
+     * @param message - The message to display
+     * @param type - The notification type
+     */
+    showWithType(message, type = 'info') {
+        const iconMap = {
+            info: 1,
+            success: 2,
+            warning: 3,
+            error: 4,
+        };
+        BeginTextCommandThefeedPost('STRING');
+        AddTextComponentString(message);
+        EndTextCommandThefeedPostMessagetext('CHAR_SOCIAL_CLUB', 'CHAR_SOCIAL_CLUB', true, iconMap[type], '', message);
+    }
+    /**
+     * Show an advanced notification with picture/icon.
+     *
+     * @param options - Advanced notification options
+     */
+    showAdvanced(options) {
+        const { title, subtitle = '', message, textureDict = 'CHAR_HUMANDEFAULT', textureName = 'CHAR_HUMANDEFAULT', iconType = 1, flash = false, saveToBrief = true, backgroundColor, } = options;
+        SetNotificationTextEntry('STRING');
+        AddTextComponentString(message);
+        if (backgroundColor !== undefined) {
+            SetNotificationBackgroundColor(backgroundColor);
+        }
+        SetNotificationMessage(textureDict, textureName, flash, iconType, title, subtitle);
+        DrawNotification(flash, saveToBrief);
+    }
+    /**
+     * Show a help notification (appears at top-left).
+     *
+     * @param message - The help message
+     * @param duration - How long to show in milliseconds (-1 for indefinite)
+     * @param beep - Play a beep sound
+     * @param looped - Keep showing until cleared
+     */
+    showHelp(message, duration = 5000, beep = true, looped = false) {
+        BeginTextCommandDisplayHelp('STRING');
+        AddTextComponentSubstringPlayerName(message);
+        EndTextCommandDisplayHelp(0, looped, beep, duration);
+    }
+    /**
+     * Clear all help messages.
+     */
+    clearHelp() {
+        ClearAllHelpMessages();
+    }
+    /**
+     * Show a subtitle (centered at bottom of screen).
+     *
+     * @param message - The subtitle text
+     * @param duration - Duration in milliseconds
+     */
+    showSubtitle(message, duration = 2500) {
+        BeginTextCommandPrint('STRING');
+        AddTextComponentSubstringPlayerName(message);
+        EndTextCommandPrint(duration, true);
+    }
+    /**
+     * Clear the current subtitle.
+     */
+    clearSubtitle() {
+        ClearPrints();
+    }
+    /**
+     * Show a floating help text above the player's head.
+     *
+     * @param message - The message to display
+     */
+    showFloatingHelp(message) {
+        const [x, y, z] = GetEntityCoords(PlayerPedId(), true);
+        SetFloatingHelpTextWorldPosition(1, x, y, z);
+        SetFloatingHelpTextStyle(1, 1, 2, -1, 3, 0);
+        BeginTextCommandDisplayHelp('STRING');
+        AddTextComponentSubstringPlayerName(message);
+        EndTextCommandDisplayHelp(2, false, false, -1);
+    }
+};
+NotificationService = __decorate([
+    injectable()
+], NotificationService);
+export { NotificationService };

package/dist/runtime/client/services/ped.service.d.ts

@@ -0,0 +1,182 @@
+import { Vector3 } from '../../../kernel/utils/vector3';
+export interface PedSpawnOptions {
+    /** Model name or hash */
+    model: string;
+    /** Spawn position */
+    position: Vector3;
+    /** Heading/rotation */
+    heading?: number;
+    /** Network the ped */
+    networked?: boolean;
+    /** Make the ped a mission entity */
+    missionEntity?: boolean;
+    /** Relationship group */
+    relationshipGroup?: string;
+    /** Whether to block non-temporary events */
+    blockEvents?: boolean;
+}
+export interface PedAnimationOptions {
+    /** Animation dictionary */
+    dict: string;
+    /** Animation name */
+    anim: string;
+    /** Blend in speed */
+    blendInSpeed?: number;
+    /** Blend out speed */
+    blendOutSpeed?: number;
+    /** Duration (-1 for looped) */
+    duration?: number;
+    /** Animation flags */
+    flags?: number;
+    /** Playback rate */
+    playbackRate?: number;
+}
+export interface ManagedPed {
+    id: string;
+    handle: number;
+    model: string;
+    position: Vector3;
+}
+/**
+ * Service for ped (NPC) operations and management.
+ */
+export declare class PedService {
+    private peds;
+    private idCounter;
+    /**
+     * Spawn a ped at a position.
+     *
+     * @param options - Spawn options
+     * @returns The ped ID and handle
+     */
+    spawn(options: PedSpawnOptions): Promise<{
+        id: string;
+        handle: number;
+    }>;
+    /**
+     * Delete a ped by ID.
+     *
+     * @param id - The ped ID
+     */
+    delete(id: string): boolean;
+    /**
+     * Delete a ped by handle.
+     *
+     * @param handle - The ped handle
+     */
+    deleteByHandle(handle: number): void;
+    /**
+     * Delete all managed peds.
+     */
+    deleteAll(): void;
+    /**
+     * Play an animation on a ped.
+     *
+     * @param handle - Ped handle
+     * @param options - Animation options
+     */
+    playAnimation(handle: number, options: PedAnimationOptions): Promise<void>;
+    /**
+     * Stop all animations on a ped.
+     *
+     * @param handle - Ped handle
+     */
+    stopAnimation(handle: number): void;
+    /**
+     * Stop animation immediately on a ped.
+     *
+     * @param handle - Ped handle
+     */
+    stopAnimationImmediately(handle: number): void;
+    /**
+     * Freeze a ped in place.
+     *
+     * @param handle - Ped handle
+     * @param freeze - Whether to freeze
+     */
+    freeze(handle: number, freeze: boolean): void;
+    /**
+     * Set ped invincibility.
+     *
+     * @param handle - Ped handle
+     * @param invincible - Whether invincible
+     */
+    setInvincible(handle: number, invincible: boolean): void;
+    /**
+     * Give a weapon to a ped.
+     *
+     * @param handle - Ped handle
+     * @param weapon - Weapon name/hash
+     * @param ammo - Ammo count
+     * @param hidden - Whether to hide the weapon
+     * @param forceInHand - Whether to force weapon in hand
+     */
+    giveWeapon(handle: number, weapon: string, ammo?: number, hidden?: boolean, forceInHand?: boolean): void;
+    /**
+     * Remove all weapons from a ped.
+     *
+     * @param handle - Ped handle
+     */
+    removeAllWeapons(handle: number): void;
+    /**
+     * Get the closest ped to the player.
+     *
+     * @param radius - Search radius
+     * @param excludePlayer - Exclude the player ped
+     * @returns Ped handle or null
+     */
+    getClosest(radius?: number, excludePlayer?: boolean): number | null;
+    /**
+     * Get all peds in a radius.
+     *
+     * @param position - Center position
+     * @param radius - Search radius
+     * @param excludePlayer - Exclude the player ped
+     * @returns Array of ped handles
+     */
+    getNearby(position: Vector3, radius: number, excludePlayer?: boolean): number[];
+    /**
+     * Make ped look at entity.
+     *
+     * @param handle - Ped handle
+     * @param entity - Entity to look at
+     * @param duration - Duration in ms (-1 for infinite)
+     */
+    lookAtEntity(handle: number, entity: number, duration?: number): void;
+    /**
+     * Make ped look at position.
+     *
+     * @param handle - Ped handle
+     * @param position - Position to look at
+     * @param duration - Duration in ms (-1 for infinite)
+     */
+    lookAtCoords(handle: number, position: Vector3, duration?: number): void;
+    /**
+     * Make ped walk to position.
+     *
+     * @param handle - Ped handle
+     * @param position - Target position
+     * @param speed - Walking speed (1.0 = walk, 2.0 = run)
+     */
+    walkTo(handle: number, position: Vector3, speed?: number): void;
+    /**
+     * Set ped combat attributes.
+     *
+     * @param handle - Ped handle
+     * @param canFight - Whether the ped can fight
+     * @param canUseCover - Whether the ped can use cover
+     */
+    setCombatAttributes(handle: number, canFight: boolean, canUseCover?: boolean): void;
+    /**
+     * Get a managed ped by ID.
+     */
+    get(id: string): ManagedPed | undefined;
+    /**
+     * Get all managed peds.
+     */
+    getAll(): ManagedPed[];
+    /**
+     * Check if a managed ped still exists.
+     */
+    exists(id: string): boolean;
+}