@nice2dev/game-engine 0.1.0

package/dist/types/ecs/World.d.ts

@@ -0,0 +1,219 @@
+import type { EntityId, Component, ComponentType, Vec2, Color } from '../core/types';
+import { EventBus } from '../core/EventBus';
+export interface Entity {
+    readonly id: EntityId;
+    name: string;
+    tags: Set<string>;
+    enabled: boolean;
+    parent: EntityId | null;
+    children: EntityId[];
+}
+export interface TransformComponent extends Component {
+    type: 'Transform';
+    position: Vec2;
+    rotation: number;
+    scale: Vec2;
+    /** Previous position (for interpolation) */
+    prevPosition: Vec2;
+    prevRotation: number;
+}
+export interface SpriteComponent extends Component {
+    type: 'Sprite';
+    /** Asset ID or null for procedural shapes */
+    assetId: string | null;
+    /** Source rectangle in spritesheet */
+    srcRect: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | null;
+    width: number;
+    height: number;
+    anchor: Vec2;
+    tint: Color;
+    opacity: number;
+    flipX: boolean;
+    flipY: boolean;
+    layer: number;
+    visible: boolean;
+}
+export interface ShapeComponent extends Component {
+    type: 'Shape';
+    shape: 'rect' | 'circle' | 'polygon' | 'line';
+    width: number;
+    height: number;
+    radius: number;
+    points: Vec2[];
+    lineStart: Vec2;
+    lineEnd: Vec2;
+    fillColor: Color;
+    strokeColor: Color;
+    strokeWidth: number;
+    layer: number;
+    visible: boolean;
+}
+export interface Collider2DComponent extends Component {
+    type: 'Collider2D';
+    shape: 'aabb' | 'circle' | 'polygon';
+    width: number;
+    height: number;
+    radius: number;
+    points: Vec2[];
+    offset: Vec2;
+    isTrigger: boolean;
+    layer: number;
+    mask: number;
+}
+export interface RigidBody2DComponent extends Component {
+    type: 'RigidBody2D';
+    bodyType: 'dynamic' | 'static' | 'kinematic';
+    velocity: Vec2;
+    acceleration: Vec2;
+    angularVelocity: number;
+    mass: number;
+    drag: number;
+    angularDrag: number;
+    restitution: number;
+    friction: number;
+    gravityScale: number;
+    fixedRotation: boolean;
+}
+export interface TextComponent extends Component {
+    type: 'Text';
+    text: string;
+    fontSize: number;
+    fontFamily: string;
+    color: Color;
+    align: 'left' | 'center' | 'right';
+    baseline: 'top' | 'middle' | 'bottom';
+    layer: number;
+    visible: boolean;
+}
+export interface AnimatorComponent extends Component {
+    type: 'Animator';
+    currentAnimation: string;
+    animations: Record<string, SpriteAnimation>;
+    frame: number;
+    elapsed: number;
+    playing: boolean;
+    loop: boolean;
+}
+export interface SpriteAnimation {
+    frames: AnimationFrame[];
+    fps: number;
+    loop: boolean;
+}
+export interface AnimationFrame {
+    assetId: string;
+    srcRect: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | null;
+    duration?: number;
+}
+export interface ScriptComponent extends Component {
+    type: 'Script';
+    scriptId: string;
+    variables: Record<string, unknown>;
+}
+export interface AudioSourceComponent extends Component {
+    type: 'AudioSource';
+    soundId: string;
+    volume: number;
+    loop: boolean;
+    spatial: boolean;
+    maxDistance: number;
+    autoPlay: boolean;
+    playing: boolean;
+}
+export interface ParticleEmitterComponent extends Component {
+    type: 'ParticleEmitter';
+    emitting: boolean;
+    rate: number;
+    lifetime: [number, number];
+    speed: [number, number];
+    angle: [number, number];
+    size: [number, number];
+    sizeEnd: [number, number];
+    color: Color;
+    colorEnd: Color;
+    gravity: Vec2;
+    maxParticles: number;
+}
+export interface CameraTargetComponent extends Component {
+    type: 'CameraTarget';
+    priority: number;
+    smoothing: number;
+    deadzone: Vec2;
+    lookahead: Vec2;
+}
+/** Union of all known component types */
+export type BuiltInComponent = TransformComponent | SpriteComponent | ShapeComponent | Collider2DComponent | RigidBody2DComponent | TextComponent | AnimatorComponent | ScriptComponent | AudioSourceComponent | ParticleEmitterComponent | CameraTargetComponent;
+export type ComponentMap = {
+    Transform: TransformComponent;
+    Sprite: SpriteComponent;
+    Shape: ShapeComponent;
+    Collider2D: Collider2DComponent;
+    RigidBody2D: RigidBody2DComponent;
+    Text: TextComponent;
+    Animator: AnimatorComponent;
+    Script: ScriptComponent;
+    AudioSource: AudioSourceComponent;
+    ParticleEmitter: ParticleEmitterComponent;
+    CameraTarget: CameraTargetComponent;
+};
+export declare function createDefaultComponent<K extends keyof ComponentMap>(type: K, entityId: EntityId): ComponentMap[K];
+export declare abstract class System {
+    enabled: boolean;
+    readonly priority: number;
+    constructor(priority?: number);
+    /** Called once when added to world. */
+    init(_world: World): void;
+    /** Called every frame. */
+    update(_world: World, _dt: number): void;
+    /** Called at fixed timestep (physics). */
+    fixedUpdate(_world: World, _fixedDt: number): void;
+    /** Called when removed from world. */
+    destroy(_world: World): void;
+    /** Alias for destroy() — unified cleanup pattern. */
+    dispose(world: World): void;
+}
+export declare class World {
+    readonly events: EventBus;
+    private _nextId;
+    private entities;
+    private components;
+    private systems;
+    private systemsSorted;
+    createEntity(name?: string): Entity;
+    destroyEntity(id: EntityId): void;
+    getEntity(id: EntityId): Entity | undefined;
+    /** Get all entities (alive). */
+    allEntities(): Entity[];
+    /** Find first entity with given tag. */
+    findByTag(tag: string): Entity | undefined;
+    /** Find all entities with given tag. */
+    findAllByTag(tag: string): Entity[];
+    /** Find first entity with given name. */
+    findByName(name: string): Entity | undefined;
+    get entityCount(): number;
+    setParent(childId: EntityId, parentId: EntityId | null): void;
+    addComponent<K extends keyof ComponentMap>(entityId: EntityId, type: K, overrides?: Partial<ComponentMap[K]>): ComponentMap[K];
+    removeComponent(entityId: EntityId, type: ComponentType): void;
+    getComponent<K extends keyof ComponentMap>(entityId: EntityId, type: K): ComponentMap[K] | undefined;
+    hasComponent(entityId: EntityId, type: ComponentType): boolean;
+    /** Query all entities that have ALL specified components. */
+    query(...types: ComponentType[]): EntityId[];
+    /** Get all components of a type (as a Map). */
+    getComponentsOfType<K extends keyof ComponentMap>(type: K): Map<EntityId, ComponentMap[K]>;
+    addSystem(system: System): void;
+    removeSystem(system: System): void;
+    private ensureSorted;
+    update(dt: number): void;
+    fixedUpdate(fixedDt: number): void;
+    /** Clear all entities, components, and systems. */
+    clear(): void;
+}

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

@@ -0,0 +1 @@
+export { World, System, createDefaultComponent, type Entity, type TransformComponent, type SpriteComponent, type ShapeComponent, type Collider2DComponent, type RigidBody2DComponent, type TextComponent, type AnimatorComponent, type ScriptComponent, type AudioSourceComponent, type ParticleEmitterComponent, type CameraTargetComponent, type BuiltInComponent, type ComponentMap, type SpriteAnimation, type AnimationFrame, } from './World';

package/dist/types/editor/AdvancedEditor.d.ts

@@ -0,0 +1,267 @@
+export type CollabOperation = {
+    type: 'insert';
+    path: string;
+    index: number;
+    value: unknown;
+} | {
+    type: 'delete';
+    path: string;
+    index: number;
+    count: number;
+} | {
+    type: 'set';
+    path: string;
+    value: unknown;
+} | {
+    type: 'move';
+    path: string;
+    fromIndex: number;
+    toIndex: number;
+};
+export interface CollabCursor {
+    userId: string;
+    displayName: string;
+    color: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    selectedEntityIds: string[];
+    viewportCenter: {
+        x: number;
+        y: number;
+    };
+    viewportZoom: number;
+    lastUpdate: number;
+}
+export interface CollabPresence {
+    userId: string;
+    displayName: string;
+    avatarUrl: string;
+    color: string;
+    status: 'active' | 'idle' | 'away';
+    currentScene: string;
+    cursor: CollabCursor;
+    joinedAt: number;
+}
+export interface CollabSession {
+    id: string;
+    projectId: string;
+    hostUserId: string;
+    participants: CollabPresence[];
+    createdAt: number;
+    permissions: CollabPermissions;
+    chat: CollabMessage[];
+}
+export interface CollabPermissions {
+    canEdit: string[];
+    canView: string[];
+    canManage: string[];
+    publicAccess: 'none' | 'view' | 'edit';
+}
+export interface CollabMessage {
+    id: string;
+    userId: string;
+    text: string;
+    timestamp: number;
+    type: 'chat' | 'system' | 'action';
+}
+/** CRDT-style version vector for conflict resolution. */
+export interface VersionVector {
+    [userId: string]: number;
+}
+export declare function mergeVersionVectors(a: VersionVector, b: VersionVector): VersionVector;
+export declare function happensBefore(a: VersionVector, b: VersionVector): boolean;
+export interface GitIntegrationConfig {
+    enabled: boolean;
+    autoCommit: boolean;
+    autoCommitInterval: number;
+    commitPrefix: string;
+    branch: string;
+    remote: string;
+    lfs: boolean;
+    lfsPatterns: string[];
+    ignorePatterns: string[];
+}
+export declare const DEFAULT_GIT_CONFIG: GitIntegrationConfig;
+export interface GitStatus {
+    branch: string;
+    ahead: number;
+    behind: number;
+    staged: GitFileChange[];
+    unstaged: GitFileChange[];
+    untracked: string[];
+    conflicts: string[];
+}
+export interface GitFileChange {
+    path: string;
+    status: 'added' | 'modified' | 'deleted' | 'renamed' | 'copied';
+    oldPath?: string;
+}
+export interface GitCommitInfo {
+    hash: string;
+    shortHash: string;
+    message: string;
+    author: string;
+    authorEmail: string;
+    date: number;
+    filesChanged: number;
+}
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    license: string;
+    engineVersion: string;
+    main: string;
+    dependencies: Record<string, string>;
+    permissions: PluginPermission[];
+    contributes: PluginContributions;
+}
+export type PluginPermission = 'filesystem' | 'network' | 'clipboard' | 'notifications' | 'camera' | 'microphone' | 'system-info' | 'full-api';
+export interface PluginContributions {
+    commands?: PluginCommand[];
+    menus?: PluginMenuItem[];
+    panels?: PluginPanel[];
+    nodeTypes?: PluginNodeType[];
+    themes?: PluginTheme[];
+    languages?: PluginLanguage[];
+    exporters?: PluginExporter[];
+    inspectors?: PluginInspector[];
+}
+export interface PluginCommand {
+    id: string;
+    title: string;
+    icon?: string;
+    keybinding?: string;
+    category?: string;
+}
+export interface PluginMenuItem {
+    commandId: string;
+    group: string;
+    order: number;
+}
+export interface PluginPanel {
+    id: string;
+    title: string;
+    icon: string;
+    location: 'left' | 'right' | 'bottom' | 'floating';
+    defaultWidth?: number;
+    defaultHeight?: number;
+}
+export interface PluginNodeType {
+    type: string;
+    category: string;
+    color: string;
+    inputs: {
+        name: string;
+        type: string;
+    }[];
+    outputs: {
+        name: string;
+        type: string;
+    }[];
+}
+export interface PluginTheme {
+    id: string;
+    name: string;
+    type: 'dark' | 'light';
+}
+export interface PluginLanguage {
+    id: string;
+    name: string;
+    locale: string;
+}
+export interface PluginExporter {
+    id: string;
+    name: string;
+    platform: string;
+    fileExtension: string;
+}
+export interface PluginInspector {
+    id: string;
+    componentType: string;
+    priority: number;
+}
+export type PluginState = 'installed' | 'active' | 'disabled' | 'error' | 'uninstalled';
+export interface PluginInstance {
+    manifest: PluginManifest;
+    state: PluginState;
+    error?: string;
+    activatedAt?: number;
+    api: Record<string, unknown>;
+}
+export declare class PluginRegistry {
+    private plugins;
+    register(manifest: PluginManifest): void;
+    activate(pluginId: string): boolean;
+    deactivate(pluginId: string): boolean;
+    getPlugin(pluginId: string): PluginInstance | undefined;
+    getActivePlugins(): PluginInstance[];
+    getContributions<K extends keyof PluginContributions>(key: K): NonNullable<PluginContributions[K]> extends Array<infer T> ? T[] : never;
+    getAllPlugins(): PluginInstance[];
+}
+export type NodePinType = 'exec' | 'boolean' | 'number' | 'string' | 'vec2' | 'vec3' | 'entity' | 'any' | 'array' | 'object';
+export interface CustomNodeDefinition {
+    id: string;
+    name: string;
+    category: string;
+    description: string;
+    color: string;
+    icon?: string;
+    inputs: NodePinDef[];
+    outputs: NodePinDef[];
+    properties: NodePropertyDef[];
+    isSubgraph: boolean;
+    subgraphId?: string;
+}
+export interface NodePinDef {
+    name: string;
+    type: NodePinType;
+    defaultValue?: unknown;
+    tooltip?: string;
+    required?: boolean;
+}
+export interface NodePropertyDef {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'enum' | 'color' | 'asset' | 'entity';
+    defaultValue: unknown;
+    options?: string[];
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export declare function createCustomNode(name: string, category: string): CustomNodeDefinition;
+export interface Keybinding {
+    id: string;
+    commandId: string;
+    key: string;
+    when?: string;
+    description: string;
+}
+export declare const DEFAULT_KEYBINDINGS: Keybinding[];
+export interface EditorLayout {
+    id: string;
+    name: string;
+    panels: EditorPanelLayout[];
+    toolbars: EditorToolbarLayout[];
+    activeScene: string;
+}
+export interface EditorPanelLayout {
+    panelId: string;
+    visible: boolean;
+    docked: boolean;
+    position: 'left' | 'right' | 'bottom' | 'floating';
+    width: number;
+    height: number;
+    order: number;
+}
+export interface EditorToolbarLayout {
+    id: string;
+    visible: boolean;
+    position: 'top' | 'left' | 'bottom';
+    items: string[];
+}
+export declare const DEFAULT_EDITOR_LAYOUT: EditorLayout;

package/dist/types/editor/AssetManager.d.ts

@@ -0,0 +1,45 @@
+import type { AssetType, AssetManifest } from '../core/types';
+import { EventBus } from '../core/EventBus';
+import type { World } from '../ecs/World';
+export interface AssetMetadata {
+    id: string;
+    name: string;
+    type: AssetType;
+    /** Relative path inside project. */
+    path: string;
+    size: number;
+    mimeType: string;
+    tags: string[];
+    thumbnailDataUrl?: string;
+    createdAt: number;
+    modifiedAt: number;
+}
+export interface AssetFolder {
+    name: string;
+    path: string;
+    children: (AssetFolder | AssetMetadata)[];
+}
+export declare class AssetManager {
+    readonly events: EventBus;
+    private assets;
+    private blobStore;
+    private objectUrls;
+    register(meta: AssetMetadata, blob?: Blob): void;
+    remove(id: string): void;
+    get(id: string): AssetMetadata | undefined;
+    getBlob(id: string): Blob | undefined;
+    getAll(): AssetMetadata[];
+    getByType(type: AssetType): AssetMetadata[];
+    search(query: string): AssetMetadata[];
+    getObjectUrl(id: string): string | null;
+    private revokeObjectUrl;
+    importFile(file: File, folder?: string): Promise<AssetMetadata>;
+    importFiles(files: FileList | File[], folder?: string): Promise<AssetMetadata[]>;
+    private inferType;
+    private generateImageThumbnail;
+    toManifest(): AssetManifest;
+    getFolderTree(): AssetFolder;
+    clear(): void;
+    /** Get assets not referenced by any entity in the given world. */
+    findUnused(world: World): AssetMetadata[];
+}

package/dist/types/editor/DebugTools.d.ts

@@ -0,0 +1,74 @@
+import type { EntityId } from '../core/types';
+import { World } from '../ecs/World';
+export interface ProfilerSample {
+    label: string;
+    startMs: number;
+    endMs: number;
+    durationMs: number;
+}
+export interface ProfilerFrame {
+    frameIndex: number;
+    totalMs: number;
+    samples: ProfilerSample[];
+}
+export declare class Profiler {
+    private frames;
+    private currentFrame;
+    private _pending;
+    private _frameIndex;
+    readonly maxFrames: number;
+    constructor(maxFrames?: number);
+    beginFrame(): void;
+    begin(label: string): void;
+    end(): void;
+    endFrame(): void;
+    getFrames(): ReadonlyArray<ProfilerFrame>;
+    getAverage(label: string): number;
+    getLastFrame(): ProfilerFrame | null;
+    clear(): void;
+}
+export declare class FPSCounter {
+    private times;
+    private _fps;
+    get fps(): number;
+    tick(now?: number): void;
+}
+export type LogLevel = 'info' | 'warn' | 'error' | 'debug';
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: number;
+    count: number;
+}
+export declare class ConsoleLogger {
+    private _entries;
+    readonly maxEntries: number;
+    private _onChange?;
+    constructor(maxEntries?: number);
+    set onChange(cb: (() => void) | undefined);
+    get entries(): ReadonlyArray<LogEntry>;
+    log(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    private add;
+    clear(): void;
+    filtered(levels: LogLevel[]): LogEntry[];
+}
+export interface EntitySnapshot {
+    id: EntityId;
+    name: string;
+    tags: string[];
+    enabled: boolean;
+    components: Record<string, Record<string, unknown>>;
+}
+export declare function snapshotEntity(world: World, id: EntityId): EntitySnapshot | null;
+export declare function snapshotWorld(world: World): EntitySnapshot[];
+export declare function renderCollisionDebug(ctx: CanvasRenderingContext2D, world: World): void;
+export interface MemoryStats {
+    entityCount: number;
+    systemCount: number;
+    jsHeapUsed: number | null;
+    jsHeapTotal: number | null;
+}
+export declare function getMemoryStats(world: World): MemoryStats;