@nice2dev/game-engine 1.3.12 → 1.3.14

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @nice2dev/game-engine — Changelog
 
+## 1.3.14
+
+No changes in this release.
+
+## 1.3.13
+
+No changes in this release.
+
 ## 1.3.12
 
 No changes in this release.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nice2dev/game-engine",
-  "version": "1.3.12",
+  "version": "1.3.14",
   "description": "Nice2Dev Game Engine — No-code game engine and editor for React",
   "author": "NiceToDev <contact@nicetodev.com>",
   "license": "SEE LICENSE IN LICENSE",
@@ -73,7 +73,7 @@
   },
   "devDependencies": {
     "@microsoft/signalr": "^10.0.11",
-    "@nice2dev/ui": "^1.3.12",
+    "@nice2dev/ui": "^1.3.14",
     "@rollup/plugin-commonjs": "^29.0.3",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",

package/dist/types/accessibility/index.d.ts

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

package/dist/types/ai/index.d.ts

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

package/dist/types/animation/index.d.ts

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

package/dist/types/audio/HRTFAudio.d.ts

@@ -1,180 +0,0 @@
-export type Vec3 = {
-    x: number;
-    y: number;
-    z: number;
-};
-export interface HRTFDatabase {
-    /** Database name (e.g., 'KEMAR', 'MIT', 'CIPIC') */
-    name: string;
-    /** Sample rate of impulse responses */
-    sampleRate: number;
-    /** Number of elevation angles */
-    elevationCount: number;
-    /** Number of azimuth angles per elevation */
-    azimuthCounts: number[];
-    /** Impulse response length (samples) */
-    irLength: number;
-    /** Left ear impulse responses */
-    leftIRs: Float32Array[];
-    /** Right ear impulse responses */
-    rightIRs: Float32Array[];
-    /** ITD (Interaural Time Delay) data */
-    itdData: Float32Array;
-}
-export interface HRTFConfig {
-    /** Enable HRTF processing */
-    enabled: boolean;
-    /** HRTF database to use */
-    database: HRTFDatabase | null;
-    /** Enable head tracking (WebXR) */
-    headTracking: boolean;
-    /** Interpolation method */
-    interpolation: 'nearest' | 'bilinear' | 'spherical';
-    /** Crossfade duration (ms) for smooth transitions */
-    crossfadeDuration: number;
-    /** Enable near-field compensation */
-    nearFieldCompensation: boolean;
-    /** Near-field reference distance (m) */
-    nearFieldReference: number;
-}
-export declare const DEFAULT_HRTF_CONFIG: HRTFConfig;
-export interface HRTFListener {
-    /** Position in world space */
-    position: Vec3;
-    /** Forward direction (normalized) */
-    forward: Vec3;
-    /** Up direction (normalized) */
-    up: Vec3;
-    /** Velocity for Doppler */
-    velocity: Vec3;
-    /** Head width (for ITD calculation) */
-    headWidth: number;
-    /** Current head rotation (from WebXR) */
-    headRotation: {
-        yaw: number;
-        pitch: number;
-        roll: number;
-    };
-}
-export declare const DEFAULT_LISTENER: HRTFListener;
-export interface HRTFSource {
-    /** Unique identifier */
-    id: string;
-    /** Position in world space */
-    position: Vec3;
-    /** Velocity for Doppler */
-    velocity: Vec3;
-    /** Source cone parameters */
-    cone?: {
-        innerAngle: number;
-        outerAngle: number;
-        outerGain: number;
-    };
-    /** Distance model */
-    distanceModel: DistanceModel;
-    /** Reference distance */
-    refDistance: number;
-    /** Maximum distance (for linear model) */
-    maxDistance: number;
-    /** Rolloff factor */
-    rolloffFactor: number;
-    /** Enable Doppler */
-    dopplerEnabled: boolean;
-    /** Doppler factor */
-    dopplerFactor: number;
-    /** Enable occlusion */
-    occlusionEnabled: boolean;
-    /** Current occlusion value (0-1) */
-    occlusion: number;
-    /** Audio buffer/stream */
-    audioBuffer: AudioBuffer | null;
-    /** Source node */
-    sourceNode: AudioBufferSourceNode | null;
-    /** Current state */
-    state: 'stopped' | 'playing' | 'paused';
-    /** Loop playback */
-    loop: boolean;
-    /** Gain value */
-    gain: number;
-}
-export type DistanceModel = 'linear' | 'inverse' | 'exponential' | 'logarithmic';
-export interface RoomAcoustics {
-    /** Room dimensions */
-    dimensions: Vec3;
-    /** Wall materials (absorption coefficients by frequency band) */
-    materials: {
-        left: MaterialAbsorption;
-        right: MaterialAbsorption;
-        floor: MaterialAbsorption;
-        ceiling: MaterialAbsorption;
-        front: MaterialAbsorption;
-        back: MaterialAbsorption;
-    };
-    /** Air absorption coefficient */
-    airAbsorption: number;
-    /** Enable early reflections */
-    earlyReflections: boolean;
-    /** Enable late reverb */
-    lateReverb: boolean;
-    /** Reverb time (T60) */
-    reverbTime: number;
-    /** Reverb pre-delay (ms) */
-    reverbPreDelay: number;
-    /** Reverb wet/dry mix */
-    reverbMix: number;
-}
-export interface MaterialAbsorption {
-    /** Absorption at 125 Hz */
-    low: number;
-    /** Absorption at 500 Hz */
-    mid: number;
-    /** Absorption at 2000 Hz */
-    high: number;
-    /** Absorption at 8000 Hz */
-    veryHigh: number;
-    /** Scattering coefficient */
-    scattering: number;
-}
-export declare const MATERIAL_PRESETS: Record<string, MaterialAbsorption>;
-export declare const DEFAULT_ROOM: RoomAcoustics;
-export declare class HRTFProcessor {
-    private ctx;
-    private config;
-    private listener;
-    private sources;
-    private masterGain;
-    private convolverLeft;
-    private convolverRight;
-    private merger;
-    private room;
-    private reverbConvolver;
-    constructor(ctx: AudioContext, config?: Partial<HRTFConfig>);
-    /** Load HRTF database from URL or ArrayBuffer */
-    loadDatabase(source: string | ArrayBuffer): Promise<void>;
-    private parseHRTFData;
-    /** Update listener position and orientation */
-    updateListener(listener: Partial<HRTFListener>): void;
-    /** Create a new HRTF-processed audio source */
-    createSource(config: Partial<HRTFSource>): string;
-    private createSourceNode;
-    private updateSourceHRTF;
-    private getRelativePosition;
-    private calculateDistanceGain;
-    private calculateITD;
-    private calculateILD;
-    /** Set room acoustics for reverb */
-    setRoom(room: RoomAcoustics | null): void;
-    private createReverbConvolver;
-    /** Update source position */
-    updateSource(id: string, updates: Partial<HRTFSource>): void;
-    /** Play a source */
-    playSource(id: string, buffer?: AudioBuffer): void;
-    /** Stop a source */
-    stopSource(id: string): void;
-    /** Remove a source */
-    removeSource(id: string): void;
-    /** Update all sources (call in animation frame) */
-    update(): void;
-    /** Dispose all resources */
-    dispose(): void;
-}

package/dist/types/audio/index.d.ts

@@ -1,2 +0,0 @@
-export { AudioManager, type SoundOptions, type MusicOptions } from './AudioManager';
-export { HRTFProcessor, DEFAULT_HRTF_CONFIG, DEFAULT_LISTENER, DEFAULT_ROOM, MATERIAL_PRESETS, type HRTFDatabase, type HRTFConfig, type HRTFListener, type HRTFSource, type DistanceModel, type RoomAcoustics, type MaterialAbsorption, } from './HRTFAudio';

package/dist/types/community/Community.d.ts

@@ -1,112 +0,0 @@
-export interface CommunityConfig {
-    projectName: string;
-    repoUrl: string;
-    license: 'MIT' | 'Apache-2.0' | 'BSD-3-Clause' | 'GPL-3.0';
-    discordUrl?: string;
-    websiteUrl?: string;
-    maintainers: string[];
-}
-export interface GameJamEntry {
-    id: string;
-    title: string;
-    author: string;
-    description: string;
-    url: string;
-    thumbnailUrl: string;
-    tags: string[];
-    submittedAt: number;
-    rating: number;
-    votes: number;
-}
-export interface ShowcaseProject {
-    id: string;
-    title: string;
-    author: string;
-    description: string;
-    url: string;
-    thumbnailUrl: string;
-    engineVersion: string;
-    features: string[];
-    stars: number;
-}
-export interface CertificationLevel {
-    id: string;
-    name: string;
-    description: string;
-    requirements: string[];
-    badge: string;
-}
-export interface SecurityCheckItem {
-    id: string;
-    category: string;
-    description: string;
-    severity: 'critical' | 'high' | 'medium' | 'low';
-    passed: boolean;
-    notes?: string;
-}
-export interface RoadmapItem {
-    id: string;
-    title: string;
-    description: string;
-    status: 'planned' | 'in-progress' | 'completed' | 'deferred';
-    milestone: string;
-    priority: 'critical' | 'high' | 'medium' | 'low';
-    estimatedVersion: string;
-}
-export declare function generateContributing(config: CommunityConfig): string;
-export declare function generateCodeOfConduct(config: CommunityConfig): string;
-export declare class GameJamPlatform {
-    private entries;
-    private jamActive;
-    private jamTitle;
-    private jamTheme;
-    private jamDeadline;
-    createJam(title: string, theme: string, durationDays: number): void;
-    submit(entry: Omit<GameJamEntry, 'submittedAt' | 'rating' | 'votes'>): GameJamEntry | null;
-    vote(entryId: string, rating: number): boolean;
-    getLeaderboard(): GameJamEntry[];
-    getEntries(tag?: string): GameJamEntry[];
-    get info(): {
-        title: string;
-        theme: string;
-        active: boolean;
-        deadline: number;
-        entryCount: number;
-        timeRemaining: number;
-    };
-    endJam(): GameJamEntry[];
-}
-export declare class ShowcaseGallery {
-    private projects;
-    add(project: ShowcaseProject): void;
-    remove(id: string): boolean;
-    star(id: string): void;
-    getFeatured(count?: number): ShowcaseProject[];
-    getByFeature(feature: string): ShowcaseProject[];
-    search(query: string): ShowcaseProject[];
-    getAll(): ShowcaseProject[];
-}
-export declare const CERTIFICATION_LEVELS: CertificationLevel[];
-export declare function checkCertification(levelId: string, completedRequirements: string[]): {
-    eligible: boolean;
-    completed: number;
-    total: number;
-    missing: string[];
-};
-export declare const SECURITY_AUDIT_CHECKLIST: SecurityCheckItem[];
-export declare function runSecurityAudit(checks: SecurityCheckItem[]): {
-    passed: number;
-    failed: number;
-    criticalFailures: SecurityCheckItem[];
-    score: number;
-};
-export declare function generateGitHubActionsCI(_config: CommunityConfig): string;
-export declare const V2_ROADMAP: RoadmapItem[];
-export declare function getRoadmapByMilestone(milestone: string): RoadmapItem[];
-export declare function getRoadmapProgress(): {
-    total: number;
-    completed: number;
-    inProgress: number;
-    planned: number;
-    percent: number;
-};

package/dist/types/community/index.d.ts

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

package/dist/types/core/TypeSafety.d.ts

@@ -1,190 +0,0 @@
-import type { Vec2, Vec3, Rect, Color, EntityId, Component, ComponentType } from './types';
-/**
- * Discriminated union of all built-in component types.
- * Use `component.type` to narrow the type safely.
- */
-export type BuiltInComponentType = 'Transform' | 'Sprite' | 'Shape' | 'Collider2D' | 'RigidBody2D' | 'Text' | 'Animator' | 'Script' | 'AudioSource' | 'ParticleEmitter' | 'CameraTarget';
-/**
- * Discriminated union mapping.
- * Given a component `type` literal, resolves to the concrete component interface.
- */
-export interface ComponentTypeMap {
-    Transform: {
-        type: 'Transform';
-        position: Vec2;
-        rotation: number;
-        scale: Vec2;
-        prevPosition: Vec2;
-        prevRotation: number;
-    };
-    Sprite: {
-        type: 'Sprite';
-        assetId: string | null;
-        width: number;
-        height: number;
-        opacity: number;
-        layer: number;
-        visible: boolean;
-    };
-    Shape: {
-        type: 'Shape';
-        shape: 'rect' | 'circle' | 'polygon' | 'line';
-        fillColor: Color;
-        strokeColor: Color;
-        layer: number;
-        visible: boolean;
-    };
-    Collider2D: {
-        type: 'Collider2D';
-        shape: 'aabb' | 'circle' | 'polygon';
-        width: number;
-        height: number;
-        radius: number;
-        isTrigger: boolean;
-    };
-    RigidBody2D: {
-        type: 'RigidBody2D';
-        bodyType: 'dynamic' | 'static' | 'kinematic';
-        velocity: Vec2;
-        mass: number;
-    };
-    Text: {
-        type: 'Text';
-        text: string;
-        fontSize: number;
-        fontFamily: string;
-    };
-    Animator: {
-        type: 'Animator';
-    };
-    Script: {
-        type: 'Script';
-        scriptId: string;
-    };
-    AudioSource: {
-        type: 'AudioSource';
-        soundId: string;
-        playing: boolean;
-    };
-    ParticleEmitter: {
-        type: 'ParticleEmitter';
-        rate: number;
-        maxParticles: number;
-    };
-    CameraTarget: {
-        type: 'CameraTarget';
-        priority: number;
-    };
-}
-/** Any concrete built-in component (discriminated union). */
-export type AnyBuiltInComponent = ComponentTypeMap[BuiltInComponentType] & Component;
-export declare function isVec2(value: unknown): value is Vec2;
-export declare function isVec3(value: unknown): value is Vec3;
-export declare function isRect(value: unknown): value is Rect;
-export declare function isColor(value: unknown): value is Color;
-export declare function isComponent(value: unknown): value is Component;
-export declare function isEntityId(value: unknown): value is EntityId;
-/** Narrow component to a specific built-in type. */
-export declare function isComponentOfType<T extends BuiltInComponentType>(component: Component, type: T): component is ComponentTypeMap[T] & Component;
-/**
- * Get a component with type-safe narrowing instead of `as` cast.
- * Returns undefined if entity doesn't have that component.
- */
-export declare function getTypedComponent<T extends BuiltInComponentType>(components: Component[], type: T): (ComponentTypeMap[T] & Component) | undefined;
-/**
- * Require a component — throws if not found (use only when guaranteed).
- */
-export declare function requireComponent<T extends BuiltInComponentType>(components: Component[], type: T, entityId: EntityId): ComponentTypeMap[T] & Component;
-/**
- * Standard event name pattern: `namespace:action`
- * This type restricts event names to the correct format.
- */
-export type EngineEventName = `engine:${string}` | `ecs:${string}` | `physics:${string}` | `input:${string}` | `audio:${string}` | `scene:${string}` | `render:${string}` | `network:${string}` | `editor:${string}` | `tutorial:${string}` | `plugin:${string}` | `collision:${string}` | `entity:${string}` | `sound:${string}` | `music:${string}` | `ui:${string}` | `game:${string}`;
-/** Known engine events with typed payloads. */
-export interface EngineEventMap {
-    'engine:start': void;
-    'engine:stop': void;
-    'engine:pause': void;
-    'engine:resume': void;
-    'ecs:entity-created': {
-        entityId: EntityId;
-    };
-    'ecs:entity-destroyed': {
-        entityId: EntityId;
-    };
-    'ecs:component-added': {
-        entityId: EntityId;
-        type: ComponentType;
-    };
-    'ecs:component-removed': {
-        entityId: EntityId;
-        type: ComponentType;
-    };
-    'physics:collision-enter': {
-        entityA: EntityId;
-        entityB: EntityId;
-    };
-    'physics:collision-exit': {
-        entityA: EntityId;
-        entityB: EntityId;
-    };
-    'input:gamepad-connected': {
-        index: number;
-    };
-    'input:gamepad-disconnected': {
-        index: number;
-    };
-    'audio:sound-play': {
-        id: string;
-        soundId: number;
-    };
-    'audio:music-play': {
-        id: string;
-    };
-    'scene:load': {
-        sceneId: string;
-    };
-    'scene:unload': {
-        sceneId: string;
-    };
-}
-/**
- * Standard time parameter type.
- * Use `dt` everywhere for delta time (seconds).
- */
-export interface TimeDelta {
-    /** Delta time in seconds since last frame. */
-    readonly dt: number;
-    /** Fixed delta time in seconds (for physics). */
-    readonly fixedDt: number;
-    /** Total elapsed time in seconds. */
-    readonly elapsed: number;
-    /** Frame count since start. */
-    readonly frame: number;
-}
-/** Generic record type (replaces `Record<string, any>`). */
-export type StrictRecord<V = unknown> = Record<string, V>;
-/** JSON-serializable value (replaces `any` in serialization). */
-export type JsonValue = string | number | boolean | null | JsonValue[] | {
-    [key: string]: JsonValue;
-};
-/** Callback with optional data (replaces `(...args: any[]) => void`). */
-export type EventCallback<T = unknown> = (data: T) => void;
-/**
- * Mark properties as strictly typed — no implicit `any` allowed.
- * Use instead of `Partial<T>` where undefined is meaningful.
- */
-export type StrictPartial<T> = {
-    [K in keyof T]?: T[K] | undefined;
-};
-/**
- * Ensure at least one property is defined (replaces loose optionals).
- */
-export type AtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
-    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
-}[Keys];
-/**
- * Use in `default` of switch to ensure all cases are handled.
- * Compile-time error if a new case is added but not handled.
- */
-export declare function assertNever(value: never, message?: string): never;

package/dist/types/core/index.d.ts

@@ -1,7 +0,0 @@
-export * from './types';
-export { GameLoop, type GameLoopCallbacks } from './GameLoop';
-export { GameClock } from './GameClock';
-export { GameConfig, DEFAULT_SETTINGS, DEFAULT_PHYSICS, DEFAULT_AUDIO, DEFAULT_RENDERING, } from './GameConfig';
-export { EventBus, type EventHandler } from './EventBus';
-export { ServiceLocator, SERVICE_KEYS } from './ServiceLocator';
-export { v2 } from './math';

package/dist/types/devtools/AssetStore.d.ts

@@ -1,133 +0,0 @@
-export type AssetCategory = 'sprite' | 'audio' | 'tileset' | 'template' | 'font' | 'shader' | 'model3d' | 'particle' | 'animation';
-export type AssetLicense = 'free' | 'cc0' | 'cc-by' | 'premium' | 'subscription';
-export interface StoreAsset {
-    id: string;
-    name: string;
-    description: string;
-    category: AssetCategory;
-    tags: string[];
-    author: string;
-    license: AssetLicense;
-    price: number;
-    currency: string;
-    thumbnailUrl: string;
-    downloadUrl: string;
-    fileSize: number;
-    downloads: number;
-    rating: number;
-    ratingCount: number;
-    createdAt: string;
-    updatedAt: string;
-    version: string;
-    compatibility: string[];
-    preview?: string[];
-}
-export interface StoreSearchParams {
-    query?: string;
-    category?: AssetCategory;
-    license?: AssetLicense;
-    minRating?: number;
-    maxPrice?: number;
-    sortBy?: 'popular' | 'newest' | 'rating' | 'name' | 'price';
-    page?: number;
-    pageSize?: number;
-    tags?: string[];
-}
-export interface StoreSearchResult {
-    assets: StoreAsset[];
-    total: number;
-    page: number;
-    pageSize: number;
-    totalPages: number;
-}
-export interface InstalledAsset {
-    asset: StoreAsset;
-    installedAt: string;
-    localPath: string;
-    version: string;
-}
-export declare const BUILTIN_FREE_ASSETS: StoreAsset[];
-export declare class AssetStore {
-    private installed;
-    private allAssets;
-    /** Search available assets. */
-    search(params?: StoreSearchParams): StoreSearchResult;
-    /** Get featured assets. */
-    getFeatured(): StoreAsset[];
-    /** Get assets by category. */
-    getByCategory(category: AssetCategory): StoreAsset[];
-    /** Install an asset (downloads and registers locally). */
-    install(assetId: string, localPath: string): InstalledAsset | null;
-    /** Uninstall an asset. */
-    uninstall(assetId: string): boolean;
-    /** Get installed assets. */
-    getInstalled(): InstalledAsset[];
-    /** Check if an asset is installed. */
-    isInstalled(assetId: string): boolean;
-    /** Register external assets (from remote catalog). */
-    registerAssets(assets: StoreAsset[]): void;
-}
-export type DiffType = 'added' | 'removed' | 'modified' | 'unchanged';
-export interface DiffEntry {
-    path: string;
-    type: DiffType;
-    oldValue?: unknown;
-    newValue?: unknown;
-    children?: DiffEntry[];
-}
-export interface ProjectDiff {
-    timestamp: string;
-    versionA: string;
-    versionB: string;
-    entities: DiffEntry[];
-    scenes: DiffEntry[];
-    assets: DiffEntry[];
-    settings: DiffEntry[];
-    summary: {
-        added: number;
-        removed: number;
-        modified: number;
-        unchanged: number;
-    };
-}
-/**
- * Compare two serialized game projects and produce a diff.
- */
-export declare function compareProjects(projectA: Record<string, unknown>, projectB: Record<string, unknown>, versionA?: string, versionB?: string): ProjectDiff;
-/** Format diff as human-readable text. */
-export declare function formatDiff(diff: ProjectDiff): string;
-export interface MarketplaceConfig {
-    /** Remote catalog endpoint URL */
-    catalogUrl?: string;
-    /** Max concurrent downloads */
-    maxConcurrent: number;
-    /** Auto-update installed plugins */
-    autoUpdate: boolean;
-    /** Allowed categories */
-    categories: string[];
-}
-export declare const DEFAULT_MARKETPLACE_CONFIG: MarketplaceConfig;
-export interface PluginInstallResult {
-    pluginId: string;
-    success: boolean;
-    version: string;
-    message: string;
-}
-/**
- * Plugin Marketplace UI controller.
- * Extends the PluginSDK's PluginMarketplace with one-click install flow.
- */
-export declare class PluginMarketplaceUI {
-    private config;
-    private installing;
-    private installHistory;
-    constructor(config?: Partial<MarketplaceConfig>);
-    /** Check if a plugin is currently being installed. */
-    isInstalling(pluginId: string): boolean;
-    /** One-click install: validate, download, activate. */
-    installPlugin(pluginId: string, version?: string): Promise<PluginInstallResult>;
-    /** Uninstall a plugin. */
-    uninstallPlugin(pluginId: string): PluginInstallResult;
-    /** Get install history. */
-    getHistory(): PluginInstallResult[];
-}

package/dist/types/devtools/index.d.ts

@@ -1,3 +0,0 @@
-export * from './AssetStore';
-export * from './DeveloperExperience';
-export * from './DevTools';

package/dist/types/dialogue/index.d.ts

@@ -1,2 +0,0 @@
-export { DialogueEngine, DialogueTreeBuilder, DialogueBox, ChoiceList, useTypewriter, serializeDialogueTree, deserializeDialogueTree, validateDialogueTree, findUnreachableNodes, extractTranslatableStrings, applyLocalization, DEFAULT_TEXT_SPEED, EMOTION_COLORS, createEmptyDialogueTree, } from './DialogueSystem';
-export type { DialogueNodeType, DialogueNode, DialogueNodeBase, StartNode, TextNode, ChoiceNode, ChoiceOption, BranchNode, SetVariableNode, CheckVariableNode, EventNode, RandomNode, EndNode, DialogueVarType, DialogueVariable, VariableCondition, ComparisonOp, DialogueCharacter, EmotionType, TextEffectType, DialogueTree, DialogueState, DialogueEventType, DialogueEvent, DialogueLocalization, DialogueBoxProps, ChoiceListProps, } from './DialogueSystem';