@vgai/engine 0.5.0 → 0.5.1

package/dist/data/vite-plugin-data.js

@@ -1,217 +0,0 @@
-/**
- * `vgaiDataCheck` — build-path validation for data assets and project tools
- * (docs/DATA-TOOLS-DESIGN.md §6.7, the enforcement half of W5). A Vite plugin
- * for the PROJECT's own `vite.config.ts` (the template wires it; the editor
- * dev server boots Vite from the ENGINE's config and never runs this — its
- * surface is covered by `vgai doctor` instead). Build-only (`apply: 'build'`):
- * in dev, `defineData`'s parse-on-load already fails loud in the console.
- *
- * Three checks, all failing the build loud:
- *
- * 1. **Schema integrity** (`buildStart`): every registered asset's
- *    `.data.json` is read fresh from disk and validated through
- *    {@link parseDataJson} — the EXACT parse `defineData` runs at load (§9.1:
- *    an emitted-JSON-Schema validator here could disagree with runtime; the
- *    Zod schema itself never can). The schemas arrive EXECUTABLE because
- *    `vite.config.ts` statically imports the project's data-asset registry
- *    (`src/data/assets.ts` in the template) — Vite's config loader bundles
- *    config-relative TS imports, which is what makes this the one build-side
- *    place project Zod schemas can run.
- * 2. **Ref integrity** (`buildStart`): every `file#key(.field)*` string in
- *    every `src/data/*.data.json` (registered or not) must resolve — shared
- *    definition with `vgai doctor` via {@link findDanglingDataRefs}, so the
- *    two surfaces can never disagree about what "dangling" means. A second,
- *    narrower ref check runs alongside it for REGISTERED assets only: any
- *    field declared with `dataRef(target)` (`./data-ref.ts`) whose `target`
- *    names no asset currently on disk fails loud too (§9.4's "renamed the
- *    target file" hole, closed for declared refs — see
- *    `collectDeclaredRefFields`/`findMissingRefTargets` in `data-check-core.ts`).
- * 3. **Tools never ship** (`generateBundle`): no emitted chunk may contain a
- *    module from `src/tools/` or a `*.tool.*` file (§4: tester serves and
- *    standalone builds strip tools entirely; W4 made this true by
- *    construction — nothing imports tools — and this check PINS it against
- *    the day some game module imports a tool "just for a helper").
- *
- * Unregistered data files (a `.data.json` with no entry in the passed
- * `assets` list) are a WARNING, not an error: they still get ref-integrity
- * and runtime parse-on-load, but no build-time schema check — the warning
- * names the registry file to fix.
- */
-import { readdirSync, readFileSync, statSync } from 'node:fs';
-import { join, relative } from 'node:path';
-import { parseDataJson, toDataJsonSchema } from './data-asset';
-import { collectDeclaredRefFields, findDanglingDataRefs, findMissingRefTargets, } from './data-check-core';
-/** Recursively collect `*.data.json` under `dir` (absent dir → empty — a project with no data assets builds fine). */
-function findDataFiles(dir) {
-    let entries;
-    try {
-        entries = readdirSync(dir);
-    }
-    catch {
-        return [];
-    }
-    const out = [];
-    for (const entry of entries) {
-        const full = join(dir, entry);
-        if (statSync(full).isDirectory())
-            out.push(...findDataFiles(full));
-        else if (entry.endsWith('.data.json'))
-            out.push(full);
-    }
-    return out;
-}
-/** `src/data/tuning.data.json` → `tuning` (normalizing either slash direction). */
-function assetStem(sourcePath) {
-    const rel = sourcePath.split('\\').join('/');
-    return (rel
-        .split('/')
-        .pop()
-        ?.replace(/\.data\.json$/, '') ?? rel);
-}
-function parseAllDataFiles(root, registered, errors, warnings) {
-    const parsedByStem = new Map();
-    const pathsByStem = new Map();
-    for (const abs of findDataFiles(join(root, 'src', 'data'))) {
-        const rel = relative(root, abs).split('\\').join('/');
-        const stem = assetStem(rel);
-        const paths = pathsByStem.get(stem);
-        if (paths)
-            paths.push(rel);
-        else
-            pathsByStem.set(stem, [rel]);
-        try {
-            parsedByStem.set(stem, JSON.parse(readFileSync(abs, 'utf-8')));
-        }
-        catch (err) {
-            errors.push(`"${rel}" is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
-            continue;
-        }
-        if (!registered.has(rel)) {
-            warnings.push(`"${rel}" is not registered in the data-asset registry (src/data/assets.ts), so it gets ` +
-                'no build-time schema check (runtime parse-on-load still applies). Register it there — ' +
-                'the template ships the worked example.');
-        }
-    }
-    const ambiguousStems = new Set();
-    for (const [stem, paths] of pathsByStem) {
-        if (paths.length < 2)
-            continue;
-        ambiguousStems.add(stem);
-        errors.push(`asset stem "${stem}" is claimed by ${paths.length} files (${paths.join(', ')}) — ` +
-            '"file#key" refs and the data-asset registry address a file by its stem alone (§2.2), so ' +
-            'this is an unresolvable identity collision. Rename one — asset stems must be unique ' +
-            'across the whole project, not just per directory.');
-        parsedByStem.delete(stem); // arbitrary otherwise — neither check below may resolve through it
-    }
-    return { parsedByStem, ambiguousStems };
-}
-/**
- * The fs half of checks 1 + 2, extracted from the plugin hook so it is
- * directly unit-testable against a fixture folder (no rollup context needed).
- */
-export function collectDataCheckProblems(options) {
-    const root = options.root ?? process.cwd();
-    const errors = [];
-    const warnings = [];
-    const registered = new Set(options.assets.map((a) => a.sourcePath.split('\\').join('/')));
-    const { parsedByStem, ambiguousStems } = parseAllDataFiles(root, registered, errors, warnings);
-    // Check 1 — registered assets validate through the exact runtime parse.
-    for (const asset of options.assets) {
-        const rel = asset.sourcePath.split('\\').join('/');
-        if (!parsedByStem.has(assetStem(rel))) {
-            // An AMBIGUOUS stem already has its own duplicate-stem error above,
-            // which fully explains why there's no single payload to validate
-            // against — a second "not found on disk" here would just be
-            // confusing noise about a file that plainly IS on disk.
-            if (!ambiguousStems.has(assetStem(rel))) {
-                errors.push(`registered data asset "${rel}" was not found on disk — fix the path in the registry ` +
-                    '(src/data/assets.ts) or restore the file.');
-            }
-            continue;
-        }
-        try {
-            parseDataJson(asset.schema, parsedByStem.get(assetStem(rel)), rel);
-        }
-        catch (err) {
-            errors.push(err instanceof Error ? err.message : String(err));
-        }
-    }
-    // Check 2 — no dangling refs anywhere.
-    for (const dangling of findDanglingDataRefs(parsedByStem)) {
-        errors.push(`dangling data ref in "src/data/${dangling.inAsset}.data.json" at ${dangling.atPath}: ` +
-            `"${dangling.ref}" — "${dangling.missingSegment}" does not exist in ` +
-            `src/data/${dangling.targetAsset}.data.json. Fix the key or remove the ref ` +
-            '(refs are "file#key" strings — docs/DATA-TOOLS-DESIGN.md §2.2).');
-    }
-    // Check 2b — every declared `dataRef(target)` field (registered assets
-    // only, same set check 1 already validates) must name a target that's
-    // actually on disk — the §9.4 fix: this fires even if NO current value
-    // happens to look like a ref, unlike check 2 above (see
-    // `data-check-core.ts`'s module doc).
-    const assetNames = new Set(parsedByStem.keys());
-    for (const asset of options.assets) {
-        const rel = asset.sourcePath.split('\\').join('/');
-        const declared = collectDeclaredRefFields(toDataJsonSchema(asset.schema));
-        for (const missing of findMissingRefTargets(declared, assetNames)) {
-            errors.push(`"${rel}" declares field "${missing.fieldPath}" as dataRef('${missing.targetStem}'), but ` +
-                `no "src/data/${missing.targetStem}.data.json" exists. Restore/rename the target file, ` +
-                `or update the dataRef('${missing.targetStem}') call in the schema.`);
-        }
-    }
-    return { errors, warnings };
-}
-/** True iff a bundled module id is tool code that must never ship (§4). Pure, unit-tested. */
-export function isToolModuleId(id) {
-    const normalized = id.split('\\').join('/');
-    return /\/src\/tools\//.test(normalized) || /\.tool\.[tj]sx?(\?|$)/.test(normalized);
-}
-/**
- * Build-path validation plugin — see the module doc. Wire it in the project's
- * `vite.config.ts`, passing the data-asset registry:
- *
- * ```ts
- * import { vgaiDataCheck } from '@vgai/engine/data/vite-plugin-data';
- * import { dataAssets } from './src/data/assets';
- * export default defineConfig({
- *   plugins: [vgaiDataCheck({
- *     root: __dirname,
- *     assets: dataAssets.map((a) => ({ schema: a.schema, sourcePath: `src/data/${a.name}.data.json` })),
- *   })],
- * });
- * ```
- */
-export function vgaiDataCheck(options) {
-    return {
-        name: 'vgai:data-check',
-        apply: 'build',
-        buildStart() {
-            const { errors, warnings } = collectDataCheckProblems(options);
-            for (const warning of warnings)
-                this.warn(warning);
-            if (errors.length > 0) {
-                // ONE error carrying every problem — fail loud with the full picture,
-                // not a fix-one-rebuild-see-the-next loop.
-                this.error(`data-asset validation failed (${errors.length} problem${errors.length === 1 ? '' : 's'} ` +
-                    `— docs/DATA-TOOLS-DESIGN.md §6.7):\n${errors.map((e) => `  - ${e}`).join('\n')}`);
-            }
-        },
-        generateBundle(_outputOptions, bundle) {
-            const leaked = new Set();
-            for (const output of Object.values(bundle)) {
-                if (output.type !== 'chunk')
-                    continue;
-                for (const id of Object.keys(output.modules)) {
-                    if (isToolModuleId(id))
-                        leaked.add(id.split('\\').join('/'));
-                }
-            }
-            if (leaked.size > 0) {
-                this.error('project tool code reached the game build — tools are editor-only and must never ship ' +
-                    'to players (docs/DATA-TOOLS-DESIGN.md §4). Remove every game-code import of these ' +
-                    `modules (tools may import game code, never the reverse):\n${[...leaked]
-                        .map((id) => `  - ${id}`)
-                        .join('\n')}`);
-            }
-        },
-    };
-}

package/dist/dev/console-bridge.d.ts

@@ -1,22 +0,0 @@
-/**
- * Dev-mode console bridge.
- *
- * Monkey-patches console.log / warn / error to also broadcast each message
- * via `window.postMessage`. Any parent frame (IDE, editor, test harness) can
- * listen for these messages — if nobody is listening they simply go nowhere.
- *
- * Also captures unhandled errors and promise rejections.
- *
- * Call once, as early as possible in the entry point:
- *
- *   import { installConsoleBridge } from '@engine/dev/console-bridge';
- *   if (import.meta.env.DEV) installConsoleBridge();
- */
-export interface ConsoleBridgeMessage {
-    type: 'console-bridge';
-    level: 'log' | 'warn' | 'error';
-    message: string;
-    timestamp: number;
-}
-export declare function installConsoleBridge(): void;
-//# sourceMappingURL=console-bridge.d.ts.map

package/dist/dev/console-bridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"console-bridge.d.ts","sourceRoot":"","sources":["../../src/dev/console-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AA6BD,wBAAgB,oBAAoB,IAAI,IAAI,CAiC3C"}

package/dist/dev/console-bridge.js

@@ -1,71 +0,0 @@
-/**
- * Dev-mode console bridge.
- *
- * Monkey-patches console.log / warn / error to also broadcast each message
- * via `window.postMessage`. Any parent frame (IDE, editor, test harness) can
- * listen for these messages — if nobody is listening they simply go nowhere.
- *
- * Also captures unhandled errors and promise rejections.
- *
- * Call once, as early as possible in the entry point:
- *
- *   import { installConsoleBridge } from '@engine/dev/console-bridge';
- *   if (import.meta.env.DEV) installConsoleBridge();
- */
-const LEVELS = ['log', 'warn', 'error'];
-function post(level, message) {
-    const msg = {
-        type: 'console-bridge',
-        level,
-        message,
-        timestamp: Date.now(),
-    };
-    window.postMessage(msg, '*');
-}
-function stringify(args) {
-    return args
-        .map((a) => {
-        if (typeof a === 'string')
-            return a;
-        try {
-            return JSON.stringify(a);
-        }
-        catch {
-            return String(a);
-        }
-    })
-        .join(' ');
-}
-let installed = false;
-export function installConsoleBridge() {
-    // Idempotent: a second call must not double-patch console (which would
-    // double-post every message) nor add duplicate window listeners.
-    if (installed)
-        return;
-    installed = true;
-    // Lazy import — avoid hard dep; if logger.ts isn't bundled the flag stays false
-    let getFlag = () => false;
-    import('./logger')
-        .then((m) => {
-        getFlag = () => m._engineLogActive;
-    })
-        .catch(() => { });
-    // Patch console methods
-    for (const level of LEVELS) {
-        const original = console[level].bind(console);
-        console[level] = (...args) => {
-            original(...args);
-            // Skip bridge posting when the engine logger is handling the message
-            // (it posts its own structured 'engine-log' message instead)
-            if (!getFlag())
-                post(level, stringify(args));
-        };
-    }
-    // Capture unhandled errors
-    window.addEventListener('error', (e) => {
-        post('error', e.message || String(e.error));
-    });
-    window.addEventListener('unhandledrejection', (e) => {
-        post('error', `Unhandled promise rejection: ${e.reason}`);
-    });
-}

package/dist/dev/debug-draw.d.ts

@@ -1,24 +0,0 @@
-import * as THREE from 'three';
-/**
- * Debug drawing utilities for development.
- *
- * Draw lines, spheres, boxes, and arrows for visualizing
- * physics colliders, raycasts, AI paths, etc.
- *
- * All debug objects are added to a dedicated group that can be toggled.
- */
-export declare function createDebugDraw(scene: THREE.Scene): {
-    /** Draw a line between two points */
-    line(from: THREE.Vector3, to: THREE.Vector3, color?: number): THREE.Line<THREE.BufferGeometry<THREE.NormalBufferAttributes>, THREE.LineBasicMaterial, THREE.Object3DEventMap>;
-    /** Draw a wireframe sphere at a position */
-    sphere(center: THREE.Vector3, radius?: number, color?: number): THREE.Mesh<THREE.SphereGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
-    /** Draw a wireframe box */
-    box(center: THREE.Vector3, size: THREE.Vector3, color?: number): THREE.Mesh<THREE.BoxGeometry, THREE.MeshBasicMaterial, THREE.Object3DEventMap>;
-    /** Draw an arrow (direction indicator) */
-    arrow(origin: THREE.Vector3, direction: THREE.Vector3, length?: number, color?: number): THREE.ArrowHelper;
-    /** Clear all debug drawings */
-    clear(): void;
-    /** Toggle debug draw visibility */
-    visible: boolean;
-};
-//# sourceMappingURL=debug-draw.d.ts.map

package/dist/dev/debug-draw.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug-draw.d.ts","sourceRoot":"","sources":["../../src/dev/debug-draw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK;IAM9C,qCAAqC;eAC1B,KAAK,CAAC,OAAO,MAAM,KAAK,CAAC,OAAO;IAQ3C,4CAA4C;mBAC7B,KAAK,CAAC,OAAO;IAS5B,2BAA2B;gBACf,KAAK,CAAC,OAAO,QAAQ,KAAK,CAAC,OAAO;IAS9C,0CAA0C;kBAC5B,KAAK,CAAC,OAAO,aAAa,KAAK,CAAC,OAAO;IAQrD,+BAA+B;;IAgB/B,mCAAmC;aACpB,OAAO;EAQzB"}

package/dist/dev/debug-draw.js

@@ -1,73 +0,0 @@
-import * as THREE from 'three';
-/**
- * Debug drawing utilities for development.
- *
- * Draw lines, spheres, boxes, and arrows for visualizing
- * physics colliders, raycasts, AI paths, etc.
- *
- * All debug objects are added to a dedicated group that can be toggled.
- */
-export function createDebugDraw(scene) {
-    const group = new THREE.Group();
-    group.name = 'debug-draw';
-    scene.add(group);
-    return {
-        /** Draw a line between two points */
-        line(from, to, color = 0x00ff00) {
-            const geometry = new THREE.BufferGeometry().setFromPoints([from, to]);
-            const material = new THREE.LineBasicMaterial({ color });
-            const line = new THREE.Line(geometry, material);
-            group.add(line);
-            return line;
-        },
-        /** Draw a wireframe sphere at a position */
-        sphere(center, radius = 0.1, color = 0xff0000) {
-            const geo = new THREE.SphereGeometry(radius, 8, 8);
-            const mat = new THREE.MeshBasicMaterial({ color, wireframe: true });
-            const mesh = new THREE.Mesh(geo, mat);
-            mesh.position.copy(center);
-            group.add(mesh);
-            return mesh;
-        },
-        /** Draw a wireframe box */
-        box(center, size, color = 0x00ffff) {
-            const geo = new THREE.BoxGeometry(size.x, size.y, size.z);
-            const mat = new THREE.MeshBasicMaterial({ color, wireframe: true });
-            const mesh = new THREE.Mesh(geo, mat);
-            mesh.position.copy(center);
-            group.add(mesh);
-            return mesh;
-        },
-        /** Draw an arrow (direction indicator) */
-        arrow(origin, direction, length = 1, color = 0xffff00) {
-            // Clone before normalize() — never mutate the caller's vector.
-            const dir = direction.clone().normalize();
-            const arrow = new THREE.ArrowHelper(dir, origin, length, color);
-            group.add(arrow);
-            return arrow;
-        },
-        /** Clear all debug drawings */
-        clear() {
-            while (group.children.length > 0) {
-                const child = group.children[0];
-                group.remove(child);
-                if (child instanceof THREE.Mesh || child instanceof THREE.Line) {
-                    // Mesh, Line and LineSegments all own geometry + material.
-                    child.geometry.dispose();
-                    child.material.dispose();
-                }
-                else if (child instanceof THREE.ArrowHelper) {
-                    // ArrowHelper owns a line + cone; dispose() frees both.
-                    child.dispose();
-                }
-            }
-        },
-        /** Toggle debug draw visibility */
-        set visible(v) {
-            group.visible = v;
-        },
-        get visible() {
-            return group.visible;
-        },
-    };
-}

package/dist/dev/logger.d.ts

@@ -1,30 +0,0 @@
-import { LogLayer } from 'loglayer';
-/**
- * Flag set while the engine logger is calling console.* so that the
- * console-bridge and play-mode patches can skip re-forwarding.
- * JS is single-threaded so this is safe.
- */
-export declare let _engineLogActive: boolean;
-declare const engineLog: LogLayer;
-export interface LogMeta {
-    entityId?: string | number | undefined;
-    [key: string]: unknown;
-}
-interface SubsystemLogger {
-    debug(msg: string, meta?: LogMeta): void;
-    info(msg: string, meta?: LogMeta): void;
-    warn(msg: string, meta?: LogMeta): void;
-    error(msg: string, meta?: LogMeta): void;
-}
-export declare const log: {
-    scene: SubsystemLogger;
-    physics: SubsystemLogger;
-    animation: SubsystemLogger;
-    network: SubsystemLogger;
-    audio: SubsystemLogger;
-    ai: SubsystemLogger;
-    input: SubsystemLogger;
-    core: SubsystemLogger;
-};
-export { engineLog };
-//# sourceMappingURL=logger.d.ts.map

package/dist/dev/logger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/dev/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,QAAQ,EAAY,MAAM,UAAU,CAAC;AAE9D;;;;GAIG;AACH,eAAO,IAAI,gBAAgB,SAAQ,CAAC;AAWpC,QAAA,MAAM,SAAS,UA4Cb,CAAC;AAKH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,eAAe;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1C;AAiBD,eAAO,MAAM,GAAG;;;;;;;;;CASf,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/dev/logger.js

@@ -1,90 +0,0 @@
-import { BlankTransport, LogLayer, LogLevel } from 'loglayer';
-/**
- * Flag set while the engine logger is calling console.* so that the
- * console-bridge and play-mode patches can skip re-forwarding.
- * JS is single-threaded so this is safe.
- */
-export let _engineLogActive = false;
-const CONSOLE_MAP = {
-    trace: 'log',
-    debug: 'log',
-    info: 'log',
-    warn: 'warn',
-    error: 'error',
-    fatal: 'error',
-};
-const engineLog = new LogLayer({
-    transport: new BlankTransport({
-        shipToLogger: ({ logLevel, messages, data, hasData }) => {
-            const method = CONSOLE_MAP[logLevel] ?? 'log';
-            // Extract _sub (subsystem tag) from data, pass the rest as metadata
-            let subsystem;
-            let metadata;
-            if (hasData && data) {
-                const { _sub, ...rest } = data;
-                subsystem = _sub ? String(_sub) : undefined;
-                if (Object.keys(rest).length > 0)
-                    metadata = rest;
-            }
-            // Call console for browser devtools
-            _engineLogActive = true;
-            if (metadata) {
-                // biome-ignore lint/suspicious/noConsole: intentional — this IS the logger
-                console[method](...messages, metadata);
-            }
-            else {
-                // biome-ignore lint/suspicious/noConsole: intentional — this IS the logger
-                console[method](...messages);
-            }
-            _engineLogActive = false;
-            // Post structured message for editor console
-            if (typeof window !== 'undefined') {
-                window.postMessage({
-                    type: 'engine-log',
-                    level: logLevel,
-                    message: messages.join(' '),
-                    subsystem,
-                    metadata,
-                    timestamp: Date.now(),
-                }, '*');
-            }
-            return messages;
-        },
-    }),
-    prefix: '[engine]',
-});
-// Default to 'info' — debug/trace are off unless explicitly enabled
-engineLog.setLevel(LogLevel.info);
-function createSubsystemLogger(subsystem) {
-    return {
-        debug: (msg, meta) => engineLog.withMetadata({ ...meta, _sub: subsystem }).debug(`[${subsystem}] ${msg}`),
-        info: (msg, meta) => engineLog.withMetadata({ ...meta, _sub: subsystem }).info(`[${subsystem}] ${msg}`),
-        warn: (msg, meta) => engineLog.withMetadata({ ...meta, _sub: subsystem }).warn(`[${subsystem}] ${msg}`),
-        error: (msg, meta) => engineLog.withMetadata({ ...meta, _sub: subsystem }).error(`[${subsystem}] ${msg}`),
-    };
-}
-// Pre-built subsystem loggers — all share the same LogLayer instance
-// so setLevel() on engineLog affects all of them.
-export const log = {
-    scene: createSubsystemLogger('scene'),
-    physics: createSubsystemLogger('physics'),
-    animation: createSubsystemLogger('animation'),
-    network: createSubsystemLogger('network'),
-    audio: createSubsystemLogger('audio'),
-    ai: createSubsystemLogger('ai'),
-    input: createSubsystemLogger('input'),
-    core: createSubsystemLogger('core'),
-};
-export { engineLog };
-// Expose to browser devtools: type setEngineLogLevel('debug') in console
-if (typeof window !== 'undefined') {
-    window['setEngineLogLevel'] = (level) => {
-        engineLog.setLevel(level);
-    };
-}
-// URL param override: ?engineLogLevel=debug
-if (typeof window !== 'undefined') {
-    const level = new URLSearchParams(window.location.search).get('engineLogLevel');
-    if (level)
-        engineLog.setLevel(level);
-}

package/dist/dev/performance-profiler.d.ts

@@ -1,60 +0,0 @@
-export interface PerformanceTiming {
-    readonly name: string;
-    readonly ms: number;
-}
-export interface PerformanceFrame {
-    readonly id: number;
-    readonly timestamp: number;
-    readonly intervalMs: number;
-    readonly cpuMs: number;
-    readonly phases: readonly PerformanceTiming[];
-}
-export interface PerformanceSnapshot {
-    readonly enabled: boolean;
-    readonly recording: boolean;
-    readonly fps: number;
-    readonly cpuMs: number;
-    readonly p95Ms: number;
-    readonly p99Ms: number;
-    readonly frames: readonly PerformanceFrame[];
-    readonly phases: readonly PerformanceTiming[];
-    readonly systems: readonly PerformanceTiming[];
-    readonly components: readonly PerformanceTiming[];
-    readonly render: {
-        readonly gpuMs: number | null;
-        readonly drawCalls: number;
-        readonly triangles: number;
-        readonly geometries: number;
-        readonly textures: number;
-    };
-}
-/** Game-owned, bounded external store for browser-native performance diagnostics. */
-export declare function createPerformanceProfiler(initiallyEnabled?: boolean): {
-    enabled: boolean;
-    readonly recording: boolean;
-    startRecording(): void;
-    stopRecording(): void;
-    clear(): void;
-    beginFrame(): void;
-    beginPhase(): void;
-    endPhase(name: string): void;
-    systemObserver: {
-        beginSystem(): void;
-        endSystem(scope: string, phase: string, name: string): void;
-    };
-    beginComponent(): void;
-    endComponent(name: string): void;
-    reportRender(stats: {
-        gpuMs: number | null;
-        drawCalls: number;
-        triangles: number;
-        geometries: number;
-        textures: number;
-    }): void;
-    endFrame(): void;
-    subscribe(listener: () => void): () => void;
-    getSnapshot(): PerformanceSnapshot;
-    exportJSON(): string;
-};
-export type PerformanceProfiler = ReturnType<typeof createPerformanceProfiler>;
-//# sourceMappingURL=performance-profiler.d.ts.map

package/dist/dev/performance-profiler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"performance-profiler.d.ts","sourceRoot":"","sources":["../../src/dev/performance-profiler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAUD,qFAAqF;AACrF,wBAAgB,yBAAyB,CAAC,gBAAgB,UAAQ;aA4D3C,OAAO;;;;;;;mBAkCX,MAAM;;;yBAYF,MAAM,SAAS,MAAM,QAAQ,MAAM;;;uBAWnC,MAAM;wBAIL;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB;;wBA4BmB,MAAM,IAAI;;;EAajC;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}