@nice2dev/game-engine 0.1.0

package/dist/esm/docs/DocGenerator.js

@@ -0,0 +1,353 @@
+import { EventBus } from '../core/EventBus.js';
+
+/* ────────────────────────────────────────────────────────────────
+   Documentation Generator — LEGENDARY L10
+   
+   Auto-generates API docs from registered modules:
+   • Markdown output
+   • Interactive docs browser model (JSON structure)
+   • Search index for API lookup
+   • Example code linking
+──────────────────────────────────────────────────────────────── */
+/* ══════════════════════════════════════════════════════════════
+   DocRegistry — Central API documentation registry
+   ══════════════════════════════════════════════════════════════ */
+class DocRegistry {
+    constructor() {
+        this.events = new EventBus();
+        this.modules = new Map();
+    }
+    /** Register a module's documentation. */
+    registerModule(mod) {
+        this.modules.set(mod.name, mod);
+        this.events.emit('doc:module-registered', { name: mod.name });
+    }
+    /** Unregister a module. */
+    unregisterModule(name) {
+        this.modules.delete(name);
+    }
+    /** Get a module by name. */
+    getModule(name) {
+        return this.modules.get(name);
+    }
+    /** Get all registered modules. */
+    getAllModules() {
+        return Array.from(this.modules.values());
+    }
+    /** Get all modules in a category. */
+    getModulesByCategory(category) {
+        const result = [];
+        for (const mod of this.modules.values()) {
+            if (mod.category === category)
+                result.push(mod);
+        }
+        return result;
+    }
+    /** Search across all docs. */
+    search(query, maxResults = 20) {
+        const q = query.toLowerCase();
+        const results = [];
+        for (const mod of this.modules.values()) {
+            for (const member of mod.members) {
+                const score = this.scoreMember(member, q);
+                if (score > 0) {
+                    results.push({ member, module: mod.name, score });
+                }
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, maxResults);
+    }
+    scoreMember(member, query) {
+        let score = 0;
+        const name = member.name.toLowerCase();
+        // Exact name match
+        if (name === query)
+            return 100;
+        // Name starts with query
+        if (name.startsWith(query))
+            score += 50;
+        // Name contains query
+        if (name.indexOf(query) >= 0)
+            score += 30;
+        // Description match
+        if (member.description.toLowerCase().indexOf(query) >= 0)
+            score += 10;
+        // Tag match
+        if (member.tags) {
+            for (const tag of member.tags) {
+                if (tag.toLowerCase().indexOf(query) >= 0)
+                    score += 15;
+            }
+        }
+        return score;
+    }
+    /** Get a specific member by name. */
+    findMember(memberName) {
+        const lower = memberName.toLowerCase();
+        for (const mod of this.modules.values()) {
+            for (const member of mod.members) {
+                if (member.name.toLowerCase() === lower) {
+                    return { member, module: mod.name };
+                }
+            }
+        }
+        return null;
+    }
+    /** Generate Markdown docs for a single module. */
+    generateModuleMarkdown(moduleName) {
+        const mod = this.modules.get(moduleName);
+        if (!mod)
+            return `Module "${moduleName}" not found.`;
+        const lines = [];
+        lines.push(`# ${mod.name}`);
+        lines.push('');
+        lines.push(mod.description);
+        lines.push('');
+        // Group by kind
+        const groups = new Map();
+        for (const m of mod.members) {
+            let arr = groups.get(m.kind);
+            if (!arr) {
+                arr = [];
+                groups.set(m.kind, arr);
+            }
+            arr.push(m);
+        }
+        const kindOrder = ['class', 'interface', 'type', 'function', 'constant', 'enum'];
+        const kindTitles = {
+            class: 'Classes',
+            interface: 'Interfaces',
+            type: 'Types',
+            function: 'Functions',
+            constant: 'Constants',
+            enum: 'Enums',
+        };
+        for (const kind of kindOrder) {
+            const members = groups.get(kind);
+            if (!members)
+                continue;
+            lines.push(`## ${kindTitles[kind]}`);
+            lines.push('');
+            for (const m of members) {
+                lines.push(`### ${m.name}`);
+                if (m.deprecated)
+                    lines.push(`> **Deprecated:** ${m.deprecated}`);
+                lines.push('');
+                if (m.signature)
+                    lines.push('```typescript\n' + m.signature + '\n```');
+                lines.push('');
+                lines.push(m.description);
+                lines.push('');
+                if (m.params && m.params.length > 0) {
+                    lines.push('**Parameters:**');
+                    lines.push('');
+                    lines.push('| Name | Type | Description |');
+                    lines.push('|------|------|-------------|');
+                    for (const p of m.params) {
+                        const opt = p.optional ? ' (optional)' : '';
+                        const def = p.defaultValue ? ` Default: \`${p.defaultValue}\`` : '';
+                        lines.push(`| \`${p.name}\`${opt} | \`${p.type}\` | ${p.description}${def} |`);
+                    }
+                    lines.push('');
+                }
+                if (m.returns) {
+                    lines.push(`**Returns:** ${m.returns}`);
+                    lines.push('');
+                }
+                if (m.example) {
+                    lines.push('**Example:**');
+                    lines.push('```typescript');
+                    lines.push(m.example);
+                    lines.push('```');
+                    lines.push('');
+                }
+                if (m.seeAlso && m.seeAlso.length > 0) {
+                    lines.push(`**See also:** ${m.seeAlso.map(s => `\`${s}\``).join(', ')}`);
+                    lines.push('');
+                }
+                if (m.since) {
+                    lines.push(`*Since: ${m.since}*`);
+                    lines.push('');
+                }
+                lines.push('---');
+                lines.push('');
+            }
+        }
+        return lines.join('\n');
+    }
+    /** Generate full Markdown documentation for all modules. */
+    generateFullMarkdown() {
+        const lines = [];
+        lines.push('# nice2dev Game Engine — API Reference');
+        lines.push('');
+        // Table of contents
+        lines.push('## Table of Contents');
+        lines.push('');
+        const categories = ['core', 'ecs', 'rendering', 'physics', 'audio', 'input', 'ui', 'scene', 'multiplayer', 'editor', 'legendary', 'other'];
+        for (const cat of categories) {
+            const mods = this.getModulesByCategory(cat);
+            if (mods.length === 0)
+                continue;
+            lines.push(`### ${cat.charAt(0).toUpperCase() + cat.slice(1)}`);
+            for (const mod of mods) {
+                lines.push(`- [${mod.name}](#${mod.name.toLowerCase().replace(/[^a-z0-9]+/g, '-')})`);
+            }
+            lines.push('');
+        }
+        // Module docs
+        for (const mod of this.modules.values()) {
+            lines.push(this.generateModuleMarkdown(mod.name));
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /** Generate a JSON index for interactive docs browser. */
+    generateSearchIndex() {
+        var _a;
+        const index = [];
+        for (const mod of this.modules.values()) {
+            for (const m of mod.members) {
+                index.push({
+                    name: m.name,
+                    module: mod.name,
+                    kind: m.kind,
+                    description: m.description,
+                    tags: (_a = m.tags) !== null && _a !== void 0 ? _a : [],
+                });
+            }
+        }
+        return index;
+    }
+    /** Total number of documented members. */
+    get totalMembers() {
+        let count = 0;
+        for (const mod of this.modules.values())
+            count += mod.members.length;
+        return count;
+    }
+    /** Reset. */
+    clear() {
+        this.modules.clear();
+    }
+}
+/* ══════════════════════════════════════════════════════════════
+   Built-in ECS Module Docs (example)
+   ══════════════════════════════════════════════════════════════ */
+const DOCS_ECS = {
+    name: 'ECS',
+    category: 'ecs',
+    description: 'Entity-Component-System architecture. The core of the game engine.',
+    members: [
+        {
+            name: 'World',
+            kind: 'class',
+            description: 'The ECS world manages entities, components, and systems.',
+            signature: 'class World',
+            tags: ['ecs', 'entity', 'system'],
+            example: "const world = new World();\nconst id = world.createEntity();\nworld.addComponent(id, 'Transform', { x: 0, y: 0 });\nworld.addSystem('move', (dt, w) => { /* ... */ });",
+            seeAlso: ['System', 'Entity'],
+        },
+        {
+            name: 'World.createEntity',
+            kind: 'function',
+            description: 'Create a new entity and return its numeric ID.',
+            signature: 'createEntity(): number',
+            returns: 'The new entity ID.',
+            tags: ['ecs', 'entity', 'create'],
+        },
+        {
+            name: 'World.addComponent',
+            kind: 'function',
+            description: 'Add a component to an entity.',
+            signature: "addComponent(entityId: number, type: string, data: object): void",
+            params: [
+                { name: 'entityId', type: 'number', description: 'The entity to add the component to.' },
+                { name: 'type', type: 'string', description: "Component type name (e.g. 'Transform', 'Sprite')." },
+                { name: 'data', type: 'object', description: 'Component data.' },
+            ],
+            tags: ['ecs', 'component'],
+        },
+        {
+            name: 'World.getComponent',
+            kind: 'function',
+            description: 'Get a single component from an entity.',
+            signature: "getComponent<T>(entityId: number, type: string): T | undefined",
+            params: [
+                { name: 'entityId', type: 'number', description: 'Entity ID.' },
+                { name: 'type', type: 'string', description: 'Component type name.' },
+            ],
+            returns: 'The component data or undefined.',
+            tags: ['ecs', 'component', 'query'],
+        },
+        {
+            name: 'World.query',
+            kind: 'function',
+            description: 'Query entities that have all specified component types.',
+            signature: "query(...types: string[]): number[]",
+            params: [
+                { name: 'types', type: 'string[]', description: 'Component types (spread args, not array!).' },
+            ],
+            returns: 'Array of entity IDs matching the query.',
+            example: "const ids = world.query('Transform', 'Sprite');\n// NOT world.query(['Transform', 'Sprite'])",
+            tags: ['ecs', 'query', 'entity'],
+        },
+        {
+            name: 'World.addSystem',
+            kind: 'function',
+            description: 'Register a system that runs every frame.',
+            signature: "addSystem(name: string, updateFn: (dt: number, world: World) => void, priority?: number): void",
+            params: [
+                { name: 'name', type: 'string', description: 'System name.' },
+                { name: 'updateFn', type: 'function', description: 'Update function called each frame.' },
+                { name: 'priority', type: 'number', description: 'Execution order (lower = earlier).', optional: true },
+            ],
+            tags: ['ecs', 'system'],
+        },
+        {
+            name: 'World.destroyEntity',
+            kind: 'function',
+            description: 'Destroy an entity and all its components.',
+            signature: 'destroyEntity(entityId: number): void',
+            tags: ['ecs', 'entity', 'destroy'],
+        },
+        {
+            name: 'World.allEntities',
+            kind: 'function',
+            description: 'Returns all entity IDs. Note: use allEntities(), NOT getAllEntities().',
+            signature: 'allEntities(): number[]',
+            returns: 'Array of all entity IDs.',
+            tags: ['ecs', 'entity', 'query'],
+        },
+    ],
+};
+const DOCS_RENDERING = {
+    name: 'Rendering',
+    category: 'rendering',
+    description: '2D Canvas rendering pipeline with sprite batching, cameras, and post-processing.',
+    members: [
+        {
+            name: 'Camera2D',
+            kind: 'class',
+            description: '2D camera with zoom, pan, and shake support.',
+            signature: 'class Camera2D',
+            tags: ['camera', 'rendering', '2d'],
+            example: "const cam = new Camera2D(canvas.width, canvas.height);\ncam.follow(playerEntity);\ncam.shake(5, 300); // intensity=5, duration=300ms",
+            seeAlso: ['Renderer2D', 'SpriteRenderer'],
+        },
+        {
+            name: 'Camera2D.worldToScreen',
+            kind: 'function',
+            description: 'Convert world coordinates to screen coordinates.',
+            signature: 'worldToScreen(worldPos: Vec2): Vec2',
+            params: [
+                { name: 'worldPos', type: 'Vec2', description: 'Takes a Vec2, not separate x,y!' },
+            ],
+            returns: 'Screen-space Vec2.',
+            tags: ['camera', 'coordinate'],
+        },
+    ],
+};
+
+export { DOCS_ECS, DOCS_RENDERING, DocRegistry };
+//# sourceMappingURL=DocGenerator.js.map

package/dist/esm/docs/DocGenerator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocGenerator.js","sources":["../../../src/docs/DocGenerator.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/ecs/World.js

@@ -0,0 +1,276 @@
+import { EventBus } from '../core/EventBus.js';
+
+/* ────────────────────────────────────────────────────────────────
+   ECS — Entity-Component-System architecture
+──────────────────────────────────────────────────────────────── */
+/* ────────────────────────────────────────────────────────────────
+   COMPONENT DEFAULTS
+──────────────────────────────────────────────────────────────── */
+const WHITE = { r: 1, g: 1, b: 1, a: 1 };
+const BLACK = { r: 0, g: 0, b: 0, a: 1 };
+const ZERO = { x: 0, y: 0 };
+const ONE = { x: 1, y: 1 };
+function createDefaultComponent(type, entityId) {
+    const base = { entityId, enabled: true };
+    switch (type) {
+        case 'Transform':
+            return { ...base, type: 'Transform', position: { ...ZERO }, rotation: 0, scale: { ...ONE }, prevPosition: { ...ZERO }, prevRotation: 0 };
+        case 'Sprite':
+            return { ...base, type: 'Sprite', assetId: null, srcRect: null, width: 32, height: 32, anchor: { x: 0.5, y: 0.5 }, tint: { ...WHITE }, opacity: 1, flipX: false, flipY: false, layer: 0, visible: true };
+        case 'Shape':
+            // as unknown as: TS can't narrow generic K in switch; Shape.shape conflicts with Collider2D.shape
+            return { ...base, type: 'Shape', shape: 'rect', width: 32, height: 32, radius: 16, points: [], lineStart: { ...ZERO }, lineEnd: { x: 32, y: 0 }, fillColor: { ...WHITE }, strokeColor: { ...BLACK }, strokeWidth: 0, layer: 0, visible: true };
+        case 'Collider2D':
+            return { ...base, type: 'Collider2D', shape: 'aabb', width: 32, height: 32, radius: 16, points: [], offset: { ...ZERO }, isTrigger: false, layer: 1, mask: 0xFFFF };
+        case 'RigidBody2D':
+            return { ...base, type: 'RigidBody2D', bodyType: 'dynamic', velocity: { ...ZERO }, acceleration: { ...ZERO }, angularVelocity: 0, mass: 1, drag: 0, angularDrag: 0, restitution: 0.3, friction: 0.5, gravityScale: 1, fixedRotation: false };
+        case 'Text':
+            return { ...base, type: 'Text', text: '', fontSize: 16, fontFamily: 'sans-serif', color: { ...WHITE }, align: 'center', baseline: 'middle', layer: 10, visible: true };
+        case 'Animator':
+            return { ...base, type: 'Animator', currentAnimation: '', animations: {}, frame: 0, elapsed: 0, playing: false, loop: true };
+        case 'Script':
+            return { ...base, type: 'Script', scriptId: '', variables: {} };
+        case 'AudioSource':
+            return { ...base, type: 'AudioSource', soundId: '', volume: 1, loop: false, spatial: false, maxDistance: 500, autoPlay: false, playing: false };
+        case 'ParticleEmitter':
+            return { ...base, type: 'ParticleEmitter', emitting: false, rate: 10, lifetime: [0.5, 1.5], speed: [50, 150], angle: [0, 360], size: [2, 6], sizeEnd: [0, 0], color: { ...WHITE }, colorEnd: { r: 1, g: 1, b: 1, a: 0 }, gravity: { x: 0, y: 100 }, maxParticles: 100 };
+        case 'CameraTarget':
+            return { ...base, type: 'CameraTarget', priority: 0, smoothing: 0.1, deadzone: { x: 50, y: 30 }, lookahead: { ...ZERO } };
+        default:
+            throw new Error(`Unknown component type: ${type}`);
+    }
+}
+/* ────────────────────────────────────────────────────────────────
+   SYSTEM — base class for game systems
+──────────────────────────────────────────────────────────────── */
+class System {
+    constructor(priority = 0) {
+        this.enabled = true;
+        this.priority = priority;
+    }
+    /** Called once when added to world. */
+    init(_world) { }
+    /** Called every frame. */
+    update(_world, _dt) { }
+    /** Called at fixed timestep (physics). */
+    fixedUpdate(_world, _fixedDt) { }
+    /** Called when removed from world. */
+    destroy(_world) { }
+    /** Alias for destroy() — unified cleanup pattern. */
+    dispose(world) { this.destroy(world); }
+}
+/* ────────────────────────────────────────────────────────────────
+   WORLD — Container for entities, components, and systems
+──────────────────────────────────────────────────────────────── */
+class World {
+    constructor() {
+        this.events = new EventBus();
+        this._nextId = 1;
+        this.entities = new Map();
+        this.components = new Map();
+        this.systems = [];
+        this.systemsSorted = false;
+    }
+    /* ── Entity management ──────────────────────────────────────── */
+    createEntity(name = 'Entity') {
+        const id = this._nextId++;
+        const entity = {
+            id,
+            name,
+            tags: new Set(),
+            enabled: true,
+            parent: null,
+            children: [],
+        };
+        this.entities.set(id, entity);
+        this.events.emit('entity:created', id);
+        return entity;
+    }
+    destroyEntity(id) {
+        const entity = this.entities.get(id);
+        if (!entity) {
+            if (typeof console !== 'undefined')
+                console.warn(`[World] destroyEntity: entity ${id} not found`);
+            return;
+        }
+        // Destroy children recursively
+        for (const childId of [...entity.children]) {
+            this.destroyEntity(childId);
+        }
+        // Remove from parent
+        if (entity.parent != null) {
+            const parent = this.entities.get(entity.parent);
+            if (parent) {
+                parent.children = parent.children.filter(c => c !== id);
+            }
+        }
+        // Remove all components
+        for (const [, compMap] of this.components) {
+            compMap.delete(id);
+        }
+        this.entities.delete(id);
+        this.events.emit('entity:destroyed', id);
+    }
+    getEntity(id) {
+        return this.entities.get(id);
+    }
+    /** Get all entities (alive). */
+    allEntities() {
+        return Array.from(this.entities.values());
+    }
+    /** Find first entity with given tag. */
+    findByTag(tag) {
+        for (const e of this.entities.values()) {
+            if (e.tags.has(tag))
+                return e;
+        }
+        return undefined;
+    }
+    /** Find all entities with given tag. */
+    findAllByTag(tag) {
+        const result = [];
+        for (const e of this.entities.values()) {
+            if (e.tags.has(tag))
+                result.push(e);
+        }
+        return result;
+    }
+    /** Find first entity with given name. */
+    findByName(name) {
+        for (const e of this.entities.values()) {
+            if (e.name === name)
+                return e;
+        }
+        return undefined;
+    }
+    get entityCount() {
+        return this.entities.size;
+    }
+    /* ── Parenting ──────────────────────────────────────────────── */
+    setParent(childId, parentId) {
+        const child = this.entities.get(childId);
+        if (!child) {
+            if (typeof console !== 'undefined')
+                console.warn(`[World] setParent: entity ${childId} not found`);
+            return;
+        }
+        // Remove from old parent
+        if (child.parent != null) {
+            const oldParent = this.entities.get(child.parent);
+            if (oldParent) {
+                oldParent.children = oldParent.children.filter(c => c !== childId);
+            }
+        }
+        child.parent = parentId;
+        if (parentId != null) {
+            const parent = this.entities.get(parentId);
+            if (parent && !parent.children.includes(childId)) {
+                parent.children.push(childId);
+            }
+        }
+    }
+    /* ── Component management ───────────────────────────────────── */
+    addComponent(entityId, type, overrides) {
+        const comp = createDefaultComponent(type, entityId);
+        if (overrides)
+            Object.assign(comp, overrides, { type, entityId });
+        let map = this.components.get(type);
+        if (!map) {
+            map = new Map();
+            this.components.set(type, map);
+        }
+        map.set(entityId, comp);
+        this.events.emit('component:added', { entityId, type });
+        return comp;
+    }
+    removeComponent(entityId, type) {
+        const map = this.components.get(type);
+        if (map) {
+            map.delete(entityId);
+            this.events.emit('component:removed', { entityId, type });
+        }
+    }
+    getComponent(entityId, type) {
+        const map = this.components.get(type);
+        return map === null || map === void 0 ? void 0 : map.get(entityId);
+    }
+    hasComponent(entityId, type) {
+        var _a;
+        const map = this.components.get(type);
+        return (_a = map === null || map === void 0 ? void 0 : map.has(entityId)) !== null && _a !== void 0 ? _a : false;
+    }
+    /** Query all entities that have ALL specified components. */
+    query(...types) {
+        if (types.length === 0)
+            return [];
+        const maps = types.map(t => this.components.get(t));
+        if (maps.some(m => !m))
+            return [];
+        // Start with smallest set for efficiency
+        const sorted = maps.slice().sort((a, b) => { var _a, _b; return ((_a = a === null || a === void 0 ? void 0 : a.size) !== null && _a !== void 0 ? _a : 0) - ((_b = b === null || b === void 0 ? void 0 : b.size) !== null && _b !== void 0 ? _b : 0); });
+        const smallest = sorted[0];
+        const rest = sorted.slice(1);
+        const result = [];
+        for (const id of smallest.keys()) {
+            if (rest.every(m => m.has(id))) {
+                const entity = this.entities.get(id);
+                if (entity === null || entity === void 0 ? void 0 : entity.enabled)
+                    result.push(id);
+            }
+        }
+        return result;
+    }
+    /** Get all components of a type (as a Map). */
+    getComponentsOfType(type) {
+        var _a;
+        return ((_a = this.components.get(type)) !== null && _a !== void 0 ? _a : new Map());
+    }
+    /* ── System management ──────────────────────────────────────── */
+    addSystem(system) {
+        this.systems.push(system);
+        this.systemsSorted = false;
+        system.init(this);
+        this.events.emit('system:added', system);
+    }
+    removeSystem(system) {
+        const idx = this.systems.indexOf(system);
+        if (idx >= 0) {
+            system.destroy(this);
+            this.systems.splice(idx, 1);
+        }
+    }
+    ensureSorted() {
+        if (!this.systemsSorted) {
+            this.systems.sort((a, b) => a.priority - b.priority);
+            this.systemsSorted = true;
+        }
+    }
+    /* ── Update ─────────────────────────────────────────────────── */
+    update(dt) {
+        this.ensureSorted();
+        for (const sys of this.systems) {
+            if (sys.enabled)
+                sys.update(this, dt);
+        }
+    }
+    fixedUpdate(fixedDt) {
+        this.ensureSorted();
+        for (const sys of this.systems) {
+            if (sys.enabled)
+                sys.fixedUpdate(this, fixedDt);
+        }
+    }
+    /* ── Serialization ──────────────────────────────────────────── */
+    /** Clear all entities, components, and systems. */
+    clear() {
+        for (const sys of this.systems)
+            sys.destroy(this);
+        this.systems.length = 0;
+        this.entities.clear();
+        this.components.clear();
+        this._nextId = 1;
+    }
+}
+
+export { System, World, createDefaultComponent };
+//# sourceMappingURL=World.js.map