@bitmagic/asset-core 0.2.38-dev.3 → 0.2.38-dev.5

package/dist/engine-specifiers.d.ts

@@ -0,0 +1,88 @@
+import type * as TS from 'typescript';
+/** Which syntactic form named the module. */
+export type SpecifierKind = 'static' | 'dynamic' | 'importType' | 'jest' | 'require' | 'url' | 'ambient';
+export declare const SPECIFIER_KINDS: readonly SpecifierKind[];
+/** A string literal that names a module, with its position in the file's text. */
+export interface FoundSpecifier {
+    kind: SpecifierKind;
+    /** The literal's value: `engine/Door.js`. */
+    value: string;
+    /** Offset of the opening quote. */
+    start: number;
+    /** Offset just past the closing quote. */
+    end: number;
+    /** The quote character the literal is written with (`'`, `"` or a backtick). */
+    quote: string;
+}
+export interface SpecifierScan {
+    specifiers: FoundSpecifier[];
+    /** `import(<expr>)` calls whose specifier is computed, as `import(<expr text>)`: no tool can rewrite them. */
+    computedDynamic: string[];
+}
+/** The `jest.*` calls whose first argument is a module path. */
+export declare const JEST_PATH_CALLS: ReadonlySet<string>;
+/**
+ * Every module specifier in a TypeScript file: static imports and re-exports, dynamic `import()`,
+ * inline `import('…')` types, `jest.mock` and the other `jest.*` path calls, `require()`,
+ * `new URL('…', import.meta.url)` and `declare module '…'`.
+ */
+export declare function findModuleSpecifiers(ts: typeof TS, fileName: string, text: string): SpecifierScan;
+/** A path without its source/output extension: `engine/Door.ts` → `engine/Door`. */
+export declare function stemOf(p: string): string;
+/** The extension a specifier is written with (`.js`, `.ts`, `.mjs`), or '' for none. */
+export declare function extOf(spec: string): string;
+export interface ResolveOptions {
+    /** The directory paths under the source root are relative to (absolute). */
+    srcRoot: string;
+    /** Alias prefixes that name a directory directly under the source root (`engine`, `types`, …). */
+    aliasRoots: readonly string[];
+    /** Whether a file exists, given its absolute path. */
+    exists: (abs: string) => boolean;
+}
+export interface ResolvedSpecifier {
+    /** The file under the source root, posix, with `.ts`: `engine/Door.ts`. */
+    rel: string;
+    /** True when the specifier names a directory and resolves to its `index.ts`. */
+    viaIndex: boolean;
+}
+/**
+ * The file under the source root an alias (`engine/Door.js`) or relative (`../engine/Door.js`)
+ * specifier written in `importerAbs` names, or null when it names something else (a package, a
+ * file outside the root, a file that does not exist).
+ */
+export declare function resolveSourceSpecifier(spec: string, importerAbs: string, options: ResolveOptions): ResolvedSpecifier | null;
+export interface SpecifierTarget {
+    /** Where the named file is after the move (its current path when it does not move), under the source root. */
+    newRel: string;
+    /** As resolved: the specifier named a directory's index. */
+    viaIndex: boolean;
+    /** Whether the named file itself moves (false when only the importer does). */
+    targetMoves: boolean;
+}
+/**
+ * The specifier to write for a target, in the style of the original: an alias stays an alias,
+ * a relative specifier stays relative (to the importer's new folder), the extension it was
+ * written with is kept, and an index import of a directory that does not move keeps naming the
+ * directory.
+ */
+export declare function formatSpecifier(spec: string, target: SpecifierTarget, importerNewAbs: string, srcRoot: string): string;
+/** One moved module, as `engine/compat/aliases.ts` lists it (paths under the source root). */
+export interface MovedModuleEntry {
+    from: string;
+    to: string;
+}
+/**
+ * The `MOVED_MODULES` list out of the text of `engine/compat/aliases.ts`. The file is generated
+ * by `engine-move.mjs` in one fixed format (`{ from: '…', to: '…', removeIn: '…' }` per line), so
+ * this reads it with the same pattern the `no-internal-shim-imports` lint rule uses rather than
+ * evaluating TypeScript.
+ */
+export declare function parseMovedModules(aliasesText: string): MovedModuleEntry[];
+export interface TextEdit {
+    start: number;
+    end: number;
+    text: string;
+}
+/** Apply position edits (non-overlapping) to a text, last first so earlier offsets stay valid. */
+export declare function applyTextEdits(text: string, edits: readonly TextEdit[]): string;
+//# sourceMappingURL=engine-specifiers.d.ts.map

package/dist/engine-specifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-specifiers.d.ts","sourceRoot":"","sources":["../src/engine-specifiers.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAEtC,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzG,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAA6E,CAAC;AAElI,kFAAkF;AAClF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,8GAA8G;IAC9G,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,gEAAgE;AAChE,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,CAE9C,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CA6CjG;AAED,oFAAoF;AACpF,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,wFAAwF;AACxF,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAID,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAC;IAChB,kGAAkG;IAClG,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,sDAAsD;IACtD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,iBAAiB,GAAG,IAAI,CAY3H;AAED,MAAM,WAAW,eAAe;IAC9B,8GAA8G;IAC9G,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUtH;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAQzE;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAM/E"}

package/dist/engine-specifiers.js

@@ -0,0 +1,157 @@
+/**
+ * Finding and rewriting the module specifiers that name engine files — the one core that both
+ * `game/scripts/engine-move.mjs` (moving a file inside the repo) and `bitmagic upgrade` (moving
+ * a creator project's imports onto an upgraded engine) run, so the two cannot come to disagree on
+ * which specifiers count or how a rewritten one is spelt.
+ *
+ * It takes the TypeScript compiler as a parameter instead of importing it: the published CLI has
+ * no TypeScript of its own (it borrows the creator project's), and the move script hands in the
+ * copy ts-morph bundles. Nothing here reads the disk; whether a path exists is the caller's
+ * `exists` callback.
+ *
+ * Paths "under the source root" are the engine's own layout: `engine/Door.ts`, `types/game.ts`.
+ * The source root is `game/src` in the repo and a project's vendored `engine/` directory in a
+ * creator project, where `engine/engine/Door.ts` is the same file.
+ */
+import * as path from 'node:path';
+export const SPECIFIER_KINDS = ['static', 'dynamic', 'importType', 'jest', 'require', 'url', 'ambient'];
+/** The `jest.*` calls whose first argument is a module path. */
+export const JEST_PATH_CALLS = new Set([
+    'mock', 'doMock', 'unmock', 'dontMock', 'requireActual', 'requireMock', 'unstable_mockModule', 'createMockFromModule', 'setMock',
+]);
+/**
+ * Every module specifier in a TypeScript file: static imports and re-exports, dynamic `import()`,
+ * inline `import('…')` types, `jest.mock` and the other `jest.*` path calls, `require()`,
+ * `new URL('…', import.meta.url)` and `declare module '…'`.
+ */
+export function findModuleSpecifiers(ts, fileName, text) {
+    const kind = /\.tsx$/.test(fileName) ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    const sf = ts.createSourceFile(fileName, text, ts.ScriptTarget.Latest, true, kind);
+    const specifiers = [];
+    const computedDynamic = [];
+    const literalOf = (node) => node !== undefined && (ts.isStringLiteral(node) || ts.isNoSubstitutionTemplateLiteral(node)) ? node : null;
+    const add = (lit, k) => {
+        if (!lit)
+            return;
+        const start = lit.getStart(sf);
+        specifiers.push({ kind: k, value: lit.text, start, end: lit.end, quote: text[start] ?? "'" });
+    };
+    const visit = (node) => {
+        if (ts.isImportDeclaration(node) || ts.isExportDeclaration(node)) {
+            add(literalOf(node.moduleSpecifier), 'static');
+        }
+        else if (ts.isImportTypeNode(node)) {
+            const arg = node.argument;
+            if (ts.isLiteralTypeNode(arg))
+                add(literalOf(arg.literal), 'importType');
+        }
+        else if (ts.isModuleDeclaration(node)) {
+            if (ts.isStringLiteral(node.name))
+                add(node.name, 'ambient');
+        }
+        else if (ts.isCallExpression(node)) {
+            const callee = node.expression;
+            const first = node.arguments[0];
+            if (callee.kind === ts.SyntaxKind.ImportKeyword) {
+                const lit = literalOf(first);
+                if (lit)
+                    add(lit, 'dynamic');
+                else if (first)
+                    computedDynamic.push(`import(${first.getText(sf)})`);
+            }
+            else if (ts.isPropertyAccessExpression(callee) && callee.expression.getText(sf) === 'jest'
+                && JEST_PATH_CALLS.has(callee.name.text)) {
+                add(literalOf(first), 'jest');
+            }
+            else if (ts.isIdentifier(callee) && callee.text === 'require') {
+                add(literalOf(first), 'require');
+            }
+        }
+        else if (ts.isNewExpression(node)) {
+            const args = node.arguments ?? [];
+            if (node.expression.getText(sf) === 'URL' && args[1] !== undefined && args[1].getText(sf) === 'import.meta.url') {
+                add(literalOf(args[0]), 'url');
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(sf);
+    return { specifiers, computedDynamic };
+}
+/** A path without its source/output extension: `engine/Door.ts` → `engine/Door`. */
+export function stemOf(p) {
+    return p.replace(/\.(d\.ts|ts|js|mjs|cjs)$/, '');
+}
+/** The extension a specifier is written with (`.js`, `.ts`, `.mjs`), or '' for none. */
+export function extOf(spec) {
+    return /\.(ts|js|mjs)$/.exec(spec)?.[0] ?? '';
+}
+const toPosix = (p) => p.split(path.sep).join('/');
+/**
+ * The file under the source root an alias (`engine/Door.js`) or relative (`../engine/Door.js`)
+ * specifier written in `importerAbs` names, or null when it names something else (a package, a
+ * file outside the root, a file that does not exist).
+ */
+export function resolveSourceSpecifier(spec, importerAbs, options) {
+    let base;
+    if (spec.startsWith('.'))
+        base = path.resolve(path.dirname(importerAbs), spec);
+    else if (options.aliasRoots.includes(spec.split('/')[0] ?? ''))
+        base = path.join(options.srcRoot, spec);
+    else
+        return null;
+    base = stemOf(base);
+    for (const [candidate, viaIndex] of [[`${base}.ts`, false], [path.join(base, 'index.ts'), true]]) {
+        const rel = toPosix(path.relative(options.srcRoot, candidate));
+        if (rel.startsWith('..') || path.isAbsolute(rel))
+            return null;
+        if (options.exists(candidate))
+            return { rel, viaIndex };
+    }
+    return null;
+}
+/**
+ * The specifier to write for a target, in the style of the original: an alias stays an alias,
+ * a relative specifier stays relative (to the importer's new folder), the extension it was
+ * written with is kept, and an index import of a directory that does not move keeps naming the
+ * directory.
+ */
+export function formatSpecifier(spec, target, importerNewAbs, srcRoot) {
+    const ext = extOf(spec);
+    const keepDir = target.viaIndex && !target.targetMoves;
+    let targetStem = stemOf(target.newRel);
+    if (keepDir)
+        targetStem = path.posix.dirname(targetStem);
+    const withExt = keepDir ? targetStem : `${targetStem}${ext}`;
+    if (!spec.startsWith('.'))
+        return withExt;
+    let rel = toPosix(path.relative(path.dirname(importerNewAbs), path.join(srcRoot, withExt)));
+    if (!rel.startsWith('.'))
+        rel = `./${rel}`;
+    return rel;
+}
+/**
+ * The `MOVED_MODULES` list out of the text of `engine/compat/aliases.ts`. The file is generated
+ * by `engine-move.mjs` in one fixed format (`{ from: '…', to: '…', removeIn: '…' }` per line), so
+ * this reads it with the same pattern the `no-internal-shim-imports` lint rule uses rather than
+ * evaluating TypeScript.
+ */
+export function parseMovedModules(aliasesText) {
+    const out = [];
+    for (const m of aliasesText.matchAll(/\{\s*from:\s*'([^']+)',\s*to:\s*'([^']+)'/g)) {
+        const from = m[1];
+        const to = m[2];
+        if (from !== undefined && to !== undefined)
+            out.push({ from, to });
+    }
+    return out;
+}
+/** Apply position edits (non-overlapping) to a text, last first so earlier offsets stay valid. */
+export function applyTextEdits(text, edits) {
+    let out = text;
+    for (const edit of [...edits].sort((a, b) => b.start - a.start)) {
+        out = out.slice(0, edit.start) + edit.text + out.slice(edit.end);
+    }
+    return out;
+}
+//# sourceMappingURL=engine-specifiers.js.map

package/dist/engine-specifiers.js.map

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

package/dist/material-classifier.d.ts

@@ -24,7 +24,7 @@
 import { z } from 'zod';
 /**
  * The engine's closed vocabulary (`VoxelMaterialClassName` in
- * `game/src/engine/VoxelMaterialClass.ts`), mirrored because this package cannot
+ * `game/src/engine/voxel/materials/VoxelMaterialClass.ts`), mirrored because this package cannot
  * import the engine. A test pins the two lists to each other.
  */
 export declare const VOXEL_MATERIAL_CLASS_NAMES: readonly ["matte", "cloth", "fur", "leather", "wood", "stone", "plastic", "paint", "metal", "gold", "chrome", "gem", "glass", "filament", "neon", "lava"];

package/dist/material-classifier.js

@@ -24,7 +24,7 @@
 import { z } from 'zod';
 /**
  * The engine's closed vocabulary (`VoxelMaterialClassName` in
- * `game/src/engine/VoxelMaterialClass.ts`), mirrored because this package cannot
+ * `game/src/engine/voxel/materials/VoxelMaterialClass.ts`), mirrored because this package cannot
  * import the engine. A test pins the two lists to each other.
  */
 export const VOXEL_MATERIAL_CLASS_NAMES = [

package/dist/template-overlay.d.ts

@@ -0,0 +1,29 @@
+/** One layer of the merge. */
+export interface OverlayLayer {
+    /** The directory whose files the layer contributes. A missing directory contributes nothing. */
+    dir: string;
+    /** A folder (posix) the layer's files land under in the result: `source` puts `Game.ts` at `source/Game.ts`. */
+    prefix?: string;
+    /** Keep only the files this accepts, given their posix path relative to `dir`. */
+    include?: (rel: string) => boolean;
+}
+/** Every file under `dir`, as posix paths relative to it, sorted. */
+export declare function listFilesRecursive(dir: string): string[];
+/**
+ * The merged file map: result path (posix, relative to the destination) → the absolute source
+ * file that wins it. Later layers win, so pass the baseline first and the overlay after it.
+ */
+export declare function collectLayeredFiles(layers: readonly OverlayLayer[]): Map<string, string>;
+/** Copy a merged file map into `destDir`, creating folders as needed. Returns the number of files written. */
+export declare function writeLayeredFiles(files: ReadonlyMap<string, string>, destDir: string): number;
+export interface BaselineOverlayMerge {
+    baselineDir: string;
+    /** The template's overlay; absent or missing means the baseline alone. */
+    overlayDir?: string;
+    destDir: string;
+    /** Applied to both layers. */
+    include?: (rel: string) => boolean;
+}
+/** Baseline first, overlay wins, written to `destDir`. Returns the number of files written. */
+export declare function mergeBaselineAndOverlay(merge: BaselineOverlayMerge): number;
+//# sourceMappingURL=template-overlay.d.ts.map

package/dist/template-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-overlay.d.ts","sourceRoot":"","sources":["../src/template-overlay.ts"],"names":[],"mappings":"AAYA,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,gGAAgG;IAChG,GAAG,EAAE,MAAM,CAAC;IACZ,gHAAgH;IAChH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC;AAED,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxF;AAED,8GAA8G;AAC9G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAS7F;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACpC;AAED,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAI3E"}

package/dist/template-overlay.js

@@ -0,0 +1,62 @@
+/**
+ * The baseline-plus-overlay merge every new game is built from: the baseline's files first, then
+ * a community template's overlay on top, the overlay winning wherever both have a file.
+ *
+ * One implementation for the three places that do it — `bitmagic init` (cli/src/scaffold), the
+ * agent's template import and in-place template switch (ExportImportController) and the template
+ * type-check (game/scripts/check-templates.cjs) — so the game a creator gets, the game the
+ * Creator gets and the game `pnpm run check` compiles are the same merge.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/** Every file under `dir`, as posix paths relative to it, sorted. */
+export function listFilesRecursive(dir) {
+    const out = [];
+    const walk = (abs, rel) => {
+        for (const entry of fs.readdirSync(abs, { withFileTypes: true })) {
+            const childAbs = path.join(abs, entry.name);
+            const childRel = rel === '' ? entry.name : `${rel}/${entry.name}`;
+            if (entry.isDirectory())
+                walk(childAbs, childRel);
+            else
+                out.push(childRel);
+        }
+    };
+    if (fs.existsSync(dir))
+        walk(dir, '');
+    return out.sort();
+}
+/**
+ * The merged file map: result path (posix, relative to the destination) → the absolute source
+ * file that wins it. Later layers win, so pass the baseline first and the overlay after it.
+ */
+export function collectLayeredFiles(layers) {
+    const files = new Map();
+    for (const layer of layers) {
+        for (const rel of listFilesRecursive(layer.dir)) {
+            if (layer.include && !layer.include(rel))
+                continue;
+            const dest = layer.prefix ? `${layer.prefix.replace(/\/+$/, '')}/${rel}` : rel;
+            files.set(dest, path.join(layer.dir, ...rel.split('/')));
+        }
+    }
+    return files;
+}
+/** Copy a merged file map into `destDir`, creating folders as needed. Returns the number of files written. */
+export function writeLayeredFiles(files, destDir) {
+    let written = 0;
+    for (const [rel, abs] of files) {
+        const dest = path.join(destDir, ...rel.split('/'));
+        fs.mkdirSync(path.dirname(dest), { recursive: true });
+        fs.copyFileSync(abs, dest);
+        written++;
+    }
+    return written;
+}
+/** Baseline first, overlay wins, written to `destDir`. Returns the number of files written. */
+export function mergeBaselineAndOverlay(merge) {
+    const dirs = merge.overlayDir === undefined ? [merge.baselineDir] : [merge.baselineDir, merge.overlayDir];
+    const layers = dirs.map((dir) => ({ dir, include: merge.include }));
+    return writeLayeredFiles(collectLayeredFiles(layers), merge.destDir);
+}
+//# sourceMappingURL=template-overlay.js.map

package/dist/template-overlay.js.map

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

package/dist/trailer/capture.js

@@ -4,7 +4,7 @@
  * Two sinks run it: the CLI's `bitmagic dev` WebSocket (cli/src/editor/recording-stream.ts) and
  * game-play-agent's chunked-HTTP sink for the web Creator.
  *
- * The recorder's worker encodes every frame with WebCodecs (see game/src/debug/RecordStream.ts)
+ * The recorder's worker encodes every frame with WebCodecs (see game/src/engine/recording/RecordStream.ts)
  * and sends `[frameIndex u32 LE][keyframe u8][chunk bytes]`. H.264 arrives as Annex B — SPS/PPS
  * inline on every keyframe — so appending the chunks gives a valid `.h264` elementary stream; VP9
  * has no such framing, so its chunks go into an IVF file (a 32-byte header and a 12-byte header

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/asset-core",
-  "version": "0.2.38-dev.3",
+  "version": "0.2.38-dev.5",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
   "type": "module",
@@ -50,6 +50,14 @@
     "./trailer": {
       "types": "./dist/trailer/index.d.ts",
       "default": "./dist/trailer/index.js"
+    },
+    "./engine-specifiers": {
+      "types": "./dist/engine-specifiers.d.ts",
+      "default": "./dist/engine-specifiers.js"
+    },
+    "./template-overlay": {
+      "types": "./dist/template-overlay.d.ts",
+      "default": "./dist/template-overlay.js"
     }
   },
   "files": [