@nice2dev/game-engine 0.1.0

package/dist/esm/plugins/PluginTestKit.js

@@ -0,0 +1,359 @@
+import { EventBus } from '../core/EventBus.js';
+
+/* ────────────────────────────────────────────────────────────────
+   Plugin Test Kit — Testing framework for 3rd party plugins
+   
+   Sprint L9: Automated plugin testing with sandboxed context,
+   lifecycle assertions, extension point verification, and
+   snapshot testing for plugin storage.
+──────────────────────────────────────────────────────────────── */
+/* ══════════════════════════════════════════════════════════════
+   In-Memory Test Storage
+   ══════════════════════════════════════════════════════════════ */
+class TestPluginStorage {
+    constructor() {
+        this.data = new Map();
+    }
+    get(key) {
+        return this.data.get(key);
+    }
+    set(key, value) {
+        this.data.set(key, value);
+    }
+    remove(key) {
+        this.data.delete(key);
+    }
+    clear() {
+        this.data.clear();
+    }
+    keys() {
+        return Array.from(this.data.keys());
+    }
+    /** Snapshot current storage state for assertions. */
+    snapshot() {
+        const result = {};
+        for (const [k, v] of this.data) {
+            result[k] = v;
+        }
+        return result;
+    }
+    get size() {
+        return this.data.size;
+    }
+}
+/* ══════════════════════════════════════════════════════════════
+   Test Plugin Context — sandboxed context for testing
+   ══════════════════════════════════════════════════════════════ */
+class TestPluginContext {
+    constructor(manifest) {
+        this.logs = [];
+        this.warnings = [];
+        this.registeredExtensions = new Map();
+        this.log = (message) => {
+            this.logs.push(message);
+        };
+        this.warn = (message) => {
+            this.warnings.push(message);
+        };
+        this.registerExtension = (point, entry) => {
+            let list = this.registeredExtensions.get(point);
+            if (!list) {
+                list = [];
+                this.registeredExtensions.set(point, list);
+            }
+            list.push(entry);
+        };
+        this.unregisterExtension = (point, entry) => {
+            const list = this.registeredExtensions.get(point);
+            if (list) {
+                const idx = list.indexOf(entry);
+                if (idx >= 0)
+                    list.splice(idx, 1);
+            }
+        };
+        this.manifest = manifest;
+        this.events = new EventBus();
+        this.storage = new TestPluginStorage();
+    }
+    /* ── Assertion helpers ─────────────────────────────────────── */
+    /** Get all extensions registered for a given point. */
+    getExtensions(point) {
+        var _a;
+        return ((_a = this.registeredExtensions.get(point)) !== null && _a !== void 0 ? _a : []);
+    }
+    /** Count extensions for a given point. */
+    extensionCount(point) {
+        var _a;
+        return ((_a = this.registeredExtensions.get(point)) !== null && _a !== void 0 ? _a : []).length;
+    }
+    /** Check if any extension was registered for a given point. */
+    hasExtension(point) {
+        return this.extensionCount(point) > 0;
+    }
+    /** Get storage snapshot for assertion/comparison. */
+    storageSnapshot() {
+        return this.storage.snapshot();
+    }
+    /** Reset context to fresh state (between tests). */
+    reset() {
+        this.logs.length = 0;
+        this.warnings.length = 0;
+        this.registeredExtensions.clear();
+        this.storage.clear();
+    }
+}
+/* ══════════════════════════════════════════════════════════════
+   Assertion Utilities
+   ══════════════════════════════════════════════════════════════ */
+class PluginAssertionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PluginAssertionError';
+    }
+}
+const pluginAssert = {
+    /** Assert value is truthy. */
+    ok(value, message) {
+        if (!value) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `Expected truthy, got ${String(value)}`);
+        }
+    },
+    /** Assert strict equality. */
+    equal(actual, expected, message) {
+        if (actual !== expected) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `Expected ${String(expected)}, got ${String(actual)}`);
+        }
+    },
+    /** Assert not equal. */
+    notEqual(actual, notExpected, message) {
+        if (actual === notExpected) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `Expected not ${String(notExpected)}`);
+        }
+    },
+    /** Assert deep equality (JSON comparison). */
+    deepEqual(actual, expected, message) {
+        const a = JSON.stringify(actual);
+        const b = JSON.stringify(expected);
+        if (a !== b) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `Deep equality failed.\nActual: ${a}\nExpected: ${b}`);
+        }
+    },
+    /** Assert that a function throws. */
+    throws(fn, message) {
+        let threw = false;
+        try {
+            fn();
+        }
+        catch (_a) {
+            threw = true;
+        }
+        if (!threw) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : 'Expected function to throw');
+        }
+    },
+    /** Assert async function throws. */
+    async throwsAsync(fn, message) {
+        let threw = false;
+        try {
+            await fn();
+        }
+        catch (_a) {
+            threw = true;
+        }
+        if (!threw) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : 'Expected async function to throw');
+        }
+    },
+    /** Assert array contains element. */
+    contains(arr, item, message) {
+        if (arr.indexOf(item) < 0) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `Array does not contain ${String(item)}`);
+        }
+    },
+    /** Assert string includes substring. */
+    includes(str, substr, message) {
+        if (!str.includes(substr)) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `"${str}" does not include "${substr}"`);
+        }
+    },
+    /** Assert extension was registered. */
+    hasExtension(ctx, point, message) {
+        if (!ctx.hasExtension(point)) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `No extension registered for "${point}"`);
+        }
+    },
+    /** Assert extension count. */
+    extensionCount(ctx, point, expected, message) {
+        const actual = ctx.extensionCount(point);
+        if (actual !== expected) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `Expected ${expected} extensions for "${point}", got ${actual}`);
+        }
+    },
+    /** Assert log message was emitted. */
+    logged(ctx, substr, message) {
+        const found = ctx.logs.some(l => l.includes(substr));
+        if (!found) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `No log message containing "${substr}". Logs: [${ctx.logs.join(', ')}]`);
+        }
+    },
+    /** Assert warning was emitted. */
+    warned(ctx, substr, message) {
+        const found = ctx.warnings.some(w => w.includes(substr));
+        if (!found) {
+            throw new PluginAssertionError(message !== null && message !== void 0 ? message : `No warning containing "${substr}". Warnings: [${ctx.warnings.join(', ')}]`);
+        }
+    },
+};
+/* ══════════════════════════════════════════════════════════════
+   Plugin Test Runner
+   ══════════════════════════════════════════════════════════════ */
+class PluginTestRunner {
+    constructor() {
+        this.tests = [];
+        this._beforeEach = null;
+        this._afterEach = null;
+    }
+    /** Add a test case. */
+    test(name, fn) {
+        this.tests.push({ name, fn });
+        return this;
+    }
+    /** Add a skipped test case. */
+    skip(name, fn) {
+        this.tests.push({ name, fn, skip: true });
+        return this;
+    }
+    /** Run something before each test. */
+    beforeEach(fn) {
+        this._beforeEach = fn;
+        return this;
+    }
+    /** Run something after each test. */
+    afterEach(fn) {
+        this._afterEach = fn;
+        return this;
+    }
+    /** Run all tests against a plugin. */
+    async run(plugin, suiteName) {
+        const manifest = plugin.manifest;
+        const ctx = new TestPluginContext(manifest);
+        const results = [];
+        let passed = 0;
+        let failed = 0;
+        let skipped = 0;
+        const suiteStart = performance.now();
+        for (const tc of this.tests) {
+            if (tc.skip) {
+                results.push({ name: tc.name, status: 'skipped', duration: 0 });
+                skipped++;
+                continue;
+            }
+            ctx.reset();
+            const start = performance.now();
+            try {
+                if (this._beforeEach)
+                    await this._beforeEach(ctx);
+                await tc.fn(ctx);
+                if (this._afterEach)
+                    await this._afterEach(ctx);
+                results.push({
+                    name: tc.name,
+                    status: 'passed',
+                    duration: performance.now() - start,
+                });
+                passed++;
+            }
+            catch (err) {
+                results.push({
+                    name: tc.name,
+                    status: 'failed',
+                    duration: performance.now() - start,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                failed++;
+            }
+        }
+        return {
+            pluginId: manifest.id,
+            suiteName: suiteName !== null && suiteName !== void 0 ? suiteName : `${manifest.name} tests`,
+            results,
+            passed,
+            failed,
+            skipped,
+            totalDuration: performance.now() - suiteStart,
+        };
+    }
+}
+/* ══════════════════════════════════════════════════════════════
+   Convenience: Quick Plugin Test
+   ══════════════════════════════════════════════════════════════ */
+/** Create a default manifest for testing. */
+function createTestManifest(overrides) {
+    return {
+        id: 'com.test.plugin',
+        name: 'Test Plugin',
+        version: '1.0.0',
+        description: 'A plugin for testing',
+        author: 'Test',
+        types: ['component'],
+        engineVersion: '>=0.1.0',
+        ...overrides,
+    };
+}
+/** Quick lifecycle test — activate, verify, deactivate. */
+async function testPluginLifecycle(plugin) {
+    const runner = new PluginTestRunner();
+    runner
+        .test('should activate without errors', async (ctx) => {
+        await plugin.activate(ctx);
+    })
+        .test('should register at least one extension', async (ctx) => {
+        await plugin.activate(ctx);
+        let total = 0;
+        for (const [, entries] of ctx.registeredExtensions) {
+            total += entries.length;
+        }
+        pluginAssert.ok(total > 0, 'Plugin should register at least one extension');
+    })
+        .test('should deactivate without errors', async (ctx) => {
+        await plugin.activate(ctx);
+        if (plugin.deactivate) {
+            await plugin.deactivate(ctx);
+        }
+    })
+        .test('should survive activate → deactivate → activate cycle', async (ctx) => {
+        await plugin.activate(ctx);
+        if (plugin.deactivate)
+            await plugin.deactivate(ctx);
+        ctx.reset();
+        await plugin.activate(ctx);
+    })
+        .test('should produce log output', async (ctx) => {
+        await plugin.activate(ctx);
+        pluginAssert.ok(ctx.logs.length > 0, 'Plugin should log something on activation');
+    });
+    return runner.run(plugin, `${plugin.manifest.name} lifecycle`);
+}
+/** Format test results as a readable string. */
+function formatTestResults(suite) {
+    const lines = [
+        `━━━ ${suite.suiteName} (${suite.pluginId}) ━━━`,
+        '',
+    ];
+    for (const r of suite.results) {
+        const icon = r.status === 'passed' ? '✓' : r.status === 'failed' ? '✗' : '○';
+        const ms = r.duration.toFixed(1);
+        lines.push(`  ${icon} ${r.name} (${ms}ms)`);
+        if (r.error) {
+            lines.push(`    → ${r.error}`);
+        }
+    }
+    lines.push('');
+    lines.push(`  ${suite.passed} passed, ${suite.failed} failed, ${suite.skipped} skipped`);
+    lines.push(`  Total: ${suite.totalDuration.toFixed(1)}ms`);
+    lines.push('');
+    return lines.join('\n');
+}
+
+export { PluginAssertionError, PluginTestRunner, TestPluginContext, TestPluginStorage, createTestManifest, formatTestResults, pluginAssert, testPluginLifecycle };
+//# sourceMappingURL=PluginTestKit.js.map

package/dist/esm/plugins/PluginTestKit.js.map

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

package/dist/esm/procedural/Procedural.js

@@ -0,0 +1,282 @@
+/* ────────────────────────────────────────────────────────────────
+   Procedural Generation — Random, Noise, Wave, LootTable
+──────────────────────────────────────────────────────────────── */
+/* ────────────────────────────────────────────────────────────────
+   SEEDED RANDOM (xoshiro128**)
+──────────────────────────────────────────────────────────────── */
+class SeededRandom {
+    constructor(seed = Date.now()) {
+        this.s = new Uint32Array(4);
+        // SplitMix32 seed expansion
+        let z = seed >>> 0;
+        for (let i = 0; i < 4; i++) {
+            z = (z + 0x9e3779b9) >>> 0;
+            let t = z ^ (z >>> 16);
+            t = Math.imul(t, 0x21f0aaad);
+            t = t ^ (t >>> 15);
+            t = Math.imul(t, 0x735a2d97);
+            t = t ^ (t >>> 15);
+            this.s[i] = t >>> 0;
+        }
+    }
+    /** Returns [0, 1). */
+    next() {
+        const s = this.s;
+        const result = Math.imul(rotl(Math.imul(s[1], 5), 7), 9) >>> 0;
+        const t = s[1] << 9;
+        s[2] ^= s[0];
+        s[3] ^= s[1];
+        s[1] ^= s[2];
+        s[0] ^= s[3];
+        s[2] ^= t;
+        s[3] = rotl(s[3], 11);
+        return (result >>> 0) / 0x100000000;
+    }
+    /** Returns integer in [min, max] (inclusive). */
+    int(min, max) {
+        return min + Math.floor(this.next() * (max - min + 1));
+    }
+    /** Returns float in [min, max). */
+    float(min, max) {
+        return min + this.next() * (max - min);
+    }
+    /** Returns true with given probability (0-1). */
+    chance(probability) {
+        return this.next() < probability;
+    }
+    /** Pick a random element from an array. */
+    pick(arr) {
+        return arr[Math.floor(this.next() * arr.length)];
+    }
+    /** Shuffle array in-place (Fisher-Yates). */
+    shuffle(arr) {
+        for (let i = arr.length - 1; i > 0; i--) {
+            const j = Math.floor(this.next() * (i + 1));
+            const tmp = arr[i];
+            arr[i] = arr[j];
+            arr[j] = tmp;
+        }
+        return arr;
+    }
+    /** Weighted random pick. Returns index. */
+    weighted(weights) {
+        let total = 0;
+        for (const w of weights)
+            total += w;
+        let r = this.next() * total;
+        for (let i = 0; i < weights.length; i++) {
+            r -= weights[i];
+            if (r <= 0)
+                return i;
+        }
+        return weights.length - 1;
+    }
+    /** Random color. */
+    color(alpha = 1) {
+        return { r: this.next(), g: this.next(), b: this.next(), a: alpha };
+    }
+    /** Random unit vector. */
+    unitVec2() {
+        const angle = this.next() * Math.PI * 2;
+        return { x: Math.cos(angle), y: Math.sin(angle) };
+    }
+    /** Random point inside a circle. */
+    insideCircle(radius) {
+        const a = this.next() * Math.PI * 2;
+        const r = Math.sqrt(this.next()) * radius;
+        return { x: Math.cos(a) * r, y: Math.sin(a) * r };
+    }
+}
+function rotl(x, k) {
+    return ((x << k) | (x >>> (32 - k))) >>> 0;
+}
+/* ────────────────────────────────────────────────────────────────
+   PERLIN NOISE (2D, improved)
+──────────────────────────────────────────────────────────────── */
+class PerlinNoise {
+    constructor(seed = 0) {
+        this.perm = new Uint8Array(512);
+        const rng = new SeededRandom(seed);
+        const p = new Uint8Array(256);
+        for (let i = 0; i < 256; i++)
+            p[i] = i;
+        // Shuffle
+        for (let i = 255; i > 0; i--) {
+            const j = rng.int(0, i);
+            const tmp = p[i];
+            p[i] = p[j];
+            p[j] = tmp;
+        }
+        for (let i = 0; i < 512; i++)
+            this.perm[i] = p[i & 255];
+    }
+    /** Get noise value at (x, y) → [-1, 1]. */
+    noise2D(x, y) {
+        const X = Math.floor(x) & 255;
+        const Y = Math.floor(y) & 255;
+        const xf = x - Math.floor(x);
+        const yf = y - Math.floor(y);
+        const u = fade(xf);
+        const v = fade(yf);
+        const p = this.perm;
+        const A = p[X] + Y;
+        const B = p[X + 1] + Y;
+        return lerp(lerp(grad(p[A], xf, yf), grad(p[B], xf - 1, yf), u), lerp(grad(p[A + 1], xf, yf - 1), grad(p[B + 1], xf - 1, yf - 1), u), v);
+    }
+    /** Fractal Brownian Motion (layered noise). */
+    fbm(x, y, octaves = 4, lacunarity = 2, gain = 0.5) {
+        let value = 0;
+        let amplitude = 1;
+        let frequency = 1;
+        let maxValue = 0;
+        for (let i = 0; i < octaves; i++) {
+            value += this.noise2D(x * frequency, y * frequency) * amplitude;
+            maxValue += amplitude;
+            amplitude *= gain;
+            frequency *= lacunarity;
+        }
+        return value / maxValue;
+    }
+}
+function fade(t) {
+    return t * t * t * (t * (t * 6 - 15) + 10);
+}
+function lerp(a, b, t) {
+    return a + t * (b - a);
+}
+function grad(hash, x, y) {
+    const h = hash & 3;
+    const u = h < 2 ? x : y;
+    const v = h < 2 ? y : x;
+    return ((h & 1) === 0 ? u : -u) + ((h & 2) === 0 ? v : -v);
+}
+class WaveGenerator {
+    constructor(seed) {
+        this.rng = new SeededRandom(seed);
+    }
+    generateWave(waveNumber, config) {
+        const totalEnemies = Math.floor(config.baseEnemyCount * Math.pow(config.countGrowth, waveNumber - 1));
+        // Filter types available at this wave
+        const available = config.typeProbabilities.filter(tp => waveNumber >= tp.minWave);
+        if (available.length === 0)
+            return [];
+        const weights = available.map(a => a.weight);
+        const entries = [];
+        let remaining = totalEnemies;
+        let cumulativeDelay = 0;
+        while (remaining > 0) {
+            const groupCount = Math.min(remaining, this.rng.int(config.groupSize[0], config.groupSize[1]));
+            const typeIdx = this.rng.weighted(weights);
+            entries.push({
+                type: available[typeIdx].type,
+                count: groupCount,
+                delay: cumulativeDelay,
+                spawnInterval: this.rng.float(config.spawnInterval[0], config.spawnInterval[1]),
+            });
+            remaining -= groupCount;
+            cumulativeDelay += this.rng.float(config.groupDelay[0], config.groupDelay[1]);
+        }
+        return entries;
+    }
+}
+class LootTable {
+    constructor(drops, seed) {
+        this.drops = drops;
+        this.rng = new SeededRandom(seed);
+    }
+    /** Roll N items from the table. */
+    roll(count, level = 1) {
+        var _a;
+        const eligible = this.drops.filter(d => !d.minLevel || level >= d.minLevel);
+        if (eligible.length === 0)
+            return [];
+        const weights = eligible.map(d => d.weight);
+        const results = [];
+        const rollCounts = new Map();
+        for (let i = 0; i < count; i++) {
+            // rebuild weights excluding maxed-out items
+            const currentWeights = eligible.map((d, idx) => {
+                var _a;
+                if (d.maxPerRoll != null) {
+                    const used = (_a = rollCounts.get(d.id)) !== null && _a !== void 0 ? _a : 0;
+                    if (used >= d.maxPerRoll)
+                        return 0;
+                }
+                return weights[idx];
+            });
+            if (currentWeights.every(w => w === 0))
+                break;
+            const idx = this.rng.weighted(currentWeights);
+            const drop = eligible[idx];
+            const qty = this.rng.int(drop.quantity[0], drop.quantity[1]);
+            results.push({ id: drop.id, quantity: qty });
+            rollCounts.set(drop.id, ((_a = rollCounts.get(drop.id)) !== null && _a !== void 0 ? _a : 0) + 1);
+        }
+        return results;
+    }
+    /** Simple yes/no chance to drop each item independently. */
+    rollEach(level = 1) {
+        const results = [];
+        for (const drop of this.drops) {
+            if (drop.minLevel != null && level < drop.minLevel)
+                continue;
+            // Normalize weight as probability (assume max total = 100)
+            if (this.rng.chance(drop.weight / 100)) {
+                results.push({ id: drop.id, quantity: this.rng.int(drop.quantity[0], drop.quantity[1]) });
+            }
+        }
+        return results;
+    }
+}
+/* ────────────────────────────────────────────────────────────────
+   PROCEDURAL SPRITE — Generate simple procedural sprites
+──────────────────────────────────────────────────────────────── */
+class ProceduralSprite {
+    constructor(seed) {
+        this.rng = new SeededRandom(seed);
+    }
+    /**
+     * Generate a symmetrical pixel art sprite as ImageData.
+     * Good for enemies, ships, items.
+     */
+    generate(width, height, palette, symmetry = 'horizontal') {
+        const data = new ImageData(width, height);
+        const halfW = symmetry === 'horizontal' || symmetry === 'both' ? Math.ceil(width / 2) : width;
+        const halfH = symmetry === 'vertical' || symmetry === 'both' ? Math.ceil(height / 2) : height;
+        // Generate half, then mirror
+        const grid = new Array(halfW * halfH).fill(false);
+        const colors = new Array(halfW * halfH).fill(0);
+        for (let i = 0; i < grid.length; i++) {
+            if (this.rng.chance(0.45)) {
+                grid[i] = true;
+                colors[i] = this.rng.int(0, palette.length - 1);
+            }
+        }
+        // Write to ImageData
+        for (let y = 0; y < height; y++) {
+            for (let x = 0; x < width; x++) {
+                let sx = x;
+                let sy = y;
+                if ((symmetry === 'horizontal' || symmetry === 'both') && x >= halfW) {
+                    sx = width - 1 - x;
+                }
+                if ((symmetry === 'vertical' || symmetry === 'both') && y >= halfH) {
+                    sy = height - 1 - y;
+                }
+                const idx = sy * halfW + sx;
+                if (grid[idx]) {
+                    const c = palette[colors[idx]];
+                    const px = (y * width + x) * 4;
+                    data.data[px] = (c.r * 255) | 0;
+                    data.data[px + 1] = (c.g * 255) | 0;
+                    data.data[px + 2] = (c.b * 255) | 0;
+                    data.data[px + 3] = (c.a * 255) | 0;
+                }
+            }
+        }
+        return data;
+    }
+}
+
+export { LootTable, PerlinNoise, ProceduralSprite, SeededRandom, WaveGenerator };
+//# sourceMappingURL=Procedural.js.map