@vgai/engine 0.5.11 → 0.5.12

package/dist/asset-formats/parse.js

@@ -1,34 +0,0 @@
-import { AssetParseError } from '../asset-parse-error';
-import { InstancesFileSchema } from './instances';
-import { MaterialFileSchema } from './material';
-// The error class itself is format-neutral and lives in
-// `engine/src/asset-parse-error.ts` (the input-map loader raises it too).
-// Re-exported here so callers have one import for parse + error.
-export { AssetParseError };
-/**
- * Parse a `.mat.json` shared material asset (T4.6). There is no version-range
- * gate for this format — `MaterialFileSchema`'s `version` field is RESERVED
- * (see `schema-consumption-map.ts`).
- *
- * Formerly `@engine/scene/parse`'s `parseMaterialFile`; moved here when WO-8
- * deleted the `.vscn` scene format that module was named for.
- */
-export function parseMaterialFile(json, filePath) {
-    const result = MaterialFileSchema.safeParse(json);
-    if (!result.success) {
-        throw new AssetParseError(result.error.issues, filePath);
-    }
-    return result.data;
-}
-/**
- * Parse a `.instances.json` instance-transform asset (F3). Mirrors
- * `parseMaterialFile` exactly — no version-range gate (the format is a bare
- * tuple array, no `version` field).
- */
-export function parseInstancesFile(json, filePath) {
-    const result = InstancesFileSchema.safeParse(json);
-    if (!result.success) {
-        throw new AssetParseError(result.error.issues, filePath);
-    }
-    return result.data;
-}

package/dist/pixi/ingest-iframe.d.ts

@@ -1,82 +0,0 @@
-/**
- * Pixi iframe ingest tiers — the PixiJS analogs of the 3D ingest-iframe adapters.
- *
- *  - OPAQUE EMBED (tier 0-1): a prebuilt/self-contained bundle runs in a sandboxed
- *    iframe; hosted + sized + disposed, NOT introspectable.
- *  - IFRAME-REACHABLE (tier 2-3): a bundle runs in its own iframe realm, but its
- *    `import 'pixi.js'` is wired (via an importmap) to a blob module re-exporting the
- *    HOST's pixi instance, so every Application/Sprite it creates is a HOST-realm
- *    object → the host `Application.prototype.render` trap fires and capture works.
- */
-import { type CapturedRuntime2D, type SceneCapture2DHandle } from './scene-capture';
-export interface EmbedMount2D {
-    iframe: HTMLIFrameElement;
-    dispose: () => void;
-}
-/** OPAQUE EMBED: sandboxed iframe, no scene introspection (tier 0-1). */
-export declare function mountIngestGame2DEmbed(html: string, container: HTMLElement): EmbedMount2D;
-export interface IframeReachableMultiOpts {
-    captureTimeoutMs?: number;
-    /**
-     * Bare-specifier → host module-namespace map. MUST include the pixi.js instance the trap is
-     * installed on (passed separately as `pixiNamespace`); list the game's OTHER shared bare deps
-     * here (@pixi/sound, @pixi/ui, gsap, pixi-filters) so they resolve to host instances and their
-     * extension side-effects register on the host pixi (the trapped instance).
-     */
-    extraDeps?: Record<string, Record<string, unknown>>;
-    /**
-     * Bare-specifier -> VERBATIM URL importmap entries (the
-     * project-node_modules fallback for a specifier that isn't in the
-     * host-namespace registry but IS installed in the open project's own
-     * `node_modules`). Written into the importmap DIRECTLY alongside the
-     * `extraDeps` blob-namespace entries — no host-side import, no blob
-     * wrapping, no decision logic here: this function just merges whatever
-     * `Record<specifier, url>` the caller (editor-side
-     * `host-namespace-registry.ts`) already decided. The URL's own transitive
-     * `import 'pixi.js'` resolves through this SAME importmap back to the host
-     * pixi trap (§0.3), keeping module identity converged without a second pixi
-     * instance.
-     */
-    extraDepUrls?: Record<string, string>;
-    /** <base href> for the iframe so the game's relative asset URLs (Assets basePath) resolve. */
-    baseHref?: string;
-    /**
-     * HOST-SIDE asset URL remap (the Pixi analog of the three.js DefaultLoadingManager.setURLModifier
-     * asset adapter). A document.write iframe keeps the PARENT's window.location, so PixiJS's Assets
-     * resolver (which builds absolute URLs from window.location, not document.baseURI) would resolve
-     * the game's relative `basePath:'assets'` against the parent page. Wrapping the host pixi's
-     * Assets.init to force this ABSOLUTE basePath fixes resolution without touching the game source —
-     * pure host library configuration, restored on dispose.
-     */
-    assetBaseUrl?: string;
-    /** Load the game bundle from this absolute URL (a built multi-file game). */
-    bundleUrl?: string;
-    /** …or run this inline module source (a single-file game). One of bundleUrl/inlineSrc required. */
-    inlineSrc?: string;
-    /** DOM the game expects to find before it boots (e.g. a `<div id="game-root">` it appends to). */
-    bodyHtml?: string;
-}
-/**
- * IFRAME-REACHABLE for REAL MULTI-FILE GAMES (cov2d-bundled-dedupe): run a built game bundle
- * (its OWN unaltered source, externalized against pixi at build time) in its own iframe realm
- * whose importmap maps EVERY shared bare dep — pixi.js + @pixi/sound/@pixi/ui/gsap/… — to the
- * HOST instances, and (optionally) a <base href> so its AssetPack/manifest URLs resolve. The
- * host `Application.prototype.render` trap then captures the live stage IN-REALM. The game's
- * source is never touched; all of this is host-side wiring.
- */
-export declare function mountIngestGame2DIframeReachableMulti(pixiNamespace: unknown, container: HTMLElement, opts: IframeReachableMultiOpts): Promise<IframeReachableMount2D>;
-export interface IframeReachableMount2D {
-    iframe: HTMLIFrameElement;
-    capture: SceneCapture2DHandle;
-    captured: CapturedRuntime2D | null;
-    dispose: () => void;
-}
-/**
- * IFRAME-REACHABLE (tier 2-3): run `gameModuleSrc` in an iframe whose importmap maps
- * `pixi.js` to a host-pixi re-export blob, and trap the host `Application.prototype`
- * so the bundle's render is captured in-realm.
- */
-export declare function mountIngestGame2DIframeReachable(pixiNamespace: unknown, gameModuleSrc: string, container: HTMLElement, opts?: {
-    captureTimeoutMs?: number;
-}): Promise<IframeReachableMount2D>;
-//# sourceMappingURL=ingest-iframe.d.ts.map

package/dist/pixi/ingest-iframe.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ingest-iframe.d.ts","sourceRoot":"","sources":["../../src/pixi/ingest-iframe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,KAAK,iBAAiB,EAEtB,KAAK,oBAAoB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,YAAY,CASzF;AAsCD,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpD;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mGAAmG;IACnG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,qCAAqC,CACzD,aAAa,EAAE,OAAO,EACtB,SAAS,EAAE,WAAW,EACtB,IAAI,EAAE,wBAAwB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CA2EjC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAsB,gCAAgC,CACpD,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,WAAW,EACtB,IAAI,GAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAO,GACvC,OAAO,CAAC,sBAAsB,CAAC,CAqCjC"}

package/dist/pixi/ingest-iframe.js

@@ -1,166 +0,0 @@
-/**
- * Pixi iframe ingest tiers — the PixiJS analogs of the 3D ingest-iframe adapters.
- *
- *  - OPAQUE EMBED (tier 0-1): a prebuilt/self-contained bundle runs in a sandboxed
- *    iframe; hosted + sized + disposed, NOT introspectable.
- *  - IFRAME-REACHABLE (tier 2-3): a bundle runs in its own iframe realm, but its
- *    `import 'pixi.js'` is wired (via an importmap) to a blob module re-exporting the
- *    HOST's pixi instance, so every Application/Sprite it creates is a HOST-realm
- *    object → the host `Application.prototype.render` trap fires and capture works.
- */
-import { installSceneCapture2D, } from './scene-capture';
-/** OPAQUE EMBED: sandboxed iframe, no scene introspection (tier 0-1). */
-export function mountIngestGame2DEmbed(html, container) {
-    const iframe = document.createElement('iframe');
-    iframe.setAttribute('sandbox', 'allow-scripts');
-    iframe.style.border = '0';
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    iframe.srcdoc = html;
-    container.appendChild(iframe);
-    return { iframe, dispose: () => iframe.remove() };
-}
-const HOST_PIXI_KEY = '__vgaiHostPixi';
-/** Build a blob module that re-exports the host's pixi namespace (for the importmap). */
-function makeHostPixiReexportUrl(pixiNamespace) {
-    window[HOST_PIXI_KEY] = pixiNamespace;
-    const ident = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-    const keys = Object.keys(pixiNamespace).filter((k) => k !== 'default' && ident.test(k));
-    const body = `const T = window.parent[${JSON.stringify(HOST_PIXI_KEY)}];\n` +
-        `export default T;\n` +
-        keys.map((k) => `export const ${k} = T[${JSON.stringify(k)}];`).join('\n');
-    return URL.createObjectURL(new Blob([body], { type: 'text/javascript' }));
-}
-let _reexportKeySeq = 0;
-/**
- * Generalized host-namespace re-export (the multi-dep analog of {@link makeHostPixiReexportUrl}).
- * Stashes `ns` (an ES module namespace object, e.g. `import * as ns from 'gsap'`) on a unique
- * window key and builds a blob module re-exporting it, so the iframe's importmap can map a bare
- * specifier (pixi.js, @pixi/sound, @pixi/ui, gsap, …) to the HOST's single instance. Default-export
- * handling: `export default T.default ?? T` so `import gsap from 'gsap'` gets gsap, while a
- * default-less namespace (pixi.js) re-exports the namespace itself for `import * as`.
- */
-function makeHostNamespaceReexportUrl(ns) {
-    const key = `__vgaiHostNs_${_reexportKeySeq++}`;
-    window[key] = ns;
-    const ident = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-    const keys = Object.keys(ns).filter((k) => k !== 'default' && ident.test(k));
-    const body = `const T = window.parent[${JSON.stringify(key)}];\n` +
-        `export default (T && T.default !== undefined ? T.default : T);\n` +
-        keys.map((k) => `export const ${k} = T[${JSON.stringify(k)}];`).join('\n');
-    return URL.createObjectURL(new Blob([body], { type: 'text/javascript' }));
-}
-/**
- * IFRAME-REACHABLE for REAL MULTI-FILE GAMES (cov2d-bundled-dedupe): run a built game bundle
- * (its OWN unaltered source, externalized against pixi at build time) in its own iframe realm
- * whose importmap maps EVERY shared bare dep — pixi.js + @pixi/sound/@pixi/ui/gsap/… — to the
- * HOST instances, and (optionally) a <base href> so its AssetPack/manifest URLs resolve. The
- * host `Application.prototype.render` trap then captures the live stage IN-REALM. The game's
- * source is never touched; all of this is host-side wiring.
- */
-export async function mountIngestGame2DIframeReachableMulti(pixiNamespace, container, opts) {
-    const capture = installSceneCapture2D(pixiNamespace);
-    const created = [];
-    const mkUrl = (ns) => {
-        const u = makeHostNamespaceReexportUrl(ns);
-        created.push(u);
-        return u;
-    };
-    const imports = {
-        'pixi.js': mkUrl(pixiNamespace),
-    };
-    for (const [spec, ns] of Object.entries(opts.extraDeps ?? {}))
-        imports[spec] = mkUrl(ns);
-    // D-Z3 fallback: verbatim URL entries, no blob wrapping, merged in beside
-    // the host-namespace ones — decision-free (see `extraDepUrls`'s doc comment).
-    for (const [spec, url] of Object.entries(opts.extraDepUrls ?? {}))
-        imports[spec] = url;
-    // Host-side asset URL remap (asset adapter): force the game's Assets.init basePath to an
-    // absolute URL so its assets resolve to the served bundle dir, not the parent page path.
-    let restoreInit;
-    if (opts.assetBaseUrl) {
-        const assetsApi = pixiNamespace.Assets;
-        if (assetsApi?.init) {
-            const orig = assetsApi.init.bind(assetsApi);
-            assetsApi.init = (o = {}) => orig({ ...o, basePath: opts.assetBaseUrl });
-            restoreInit = () => {
-                assetsApi.init = orig;
-            };
-        }
-    }
-    const iframe = document.createElement('iframe');
-    iframe.style.border = '0';
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    container.appendChild(iframe);
-    // Split the closing script token so this module's own bundling never sees a literal
-    // </script> (defensive; matches the single-dep mount's convention).
-    const close = `</${'scr'}ipt>`;
-    const baseTag = opts.baseHref ? `<base href="${opts.baseHref}">` : '';
-    const scriptTag = opts.bundleUrl
-        ? `<script type="module" src="${opts.bundleUrl}">${close}`
-        : `<script type="module">${opts.inlineSrc ?? ''}${close}`;
-    const importmapTag = `<script type="importmap">${JSON.stringify({ imports })}${close}`;
-    const bodyHtml = opts.bodyHtml ?? '';
-    const doc = iframe.contentDocument;
-    doc.open();
-    doc.write(`<!doctype html><html><head><meta charset="utf-8">${baseTag}${importmapTag}</head><body>${bodyHtml}${scriptTag}</body></html>`);
-    doc.close();
-    let captured = null;
-    try {
-        captured = await capture.waitForCapture(opts.captureTimeoutMs ?? 12_000);
-    }
-    catch {
-        captured = null;
-    }
-    return {
-        iframe,
-        capture,
-        captured,
-        dispose: () => {
-            capture.uninstall();
-            restoreInit?.();
-            for (const u of created)
-                URL.revokeObjectURL(u);
-            iframe.remove();
-        },
-    };
-}
-/**
- * IFRAME-REACHABLE (tier 2-3): run `gameModuleSrc` in an iframe whose importmap maps
- * `pixi.js` to a host-pixi re-export blob, and trap the host `Application.prototype`
- * so the bundle's render is captured in-realm.
- */
-export async function mountIngestGame2DIframeReachable(pixiNamespace, gameModuleSrc, container, opts = {}) {
-    const capture = installSceneCapture2D(pixiNamespace);
-    const reexportUrl = makeHostPixiReexportUrl(pixiNamespace);
-    const iframe = document.createElement('iframe');
-    iframe.style.border = '0';
-    iframe.style.width = '100%';
-    iframe.style.height = '100%';
-    container.appendChild(iframe);
-    const doc = iframe.contentDocument;
-    doc.open();
-    doc.write(`<!doctype html><html><head><meta charset="utf-8">` +
-        `<script type="importmap">${JSON.stringify({ imports: { 'pixi.js': reexportUrl } })}</scr` +
-        `ipt></head><body><script type="module">${gameModuleSrc}</scr` +
-        `ipt></body></html>`);
-    doc.close();
-    let captured = null;
-    try {
-        captured = await capture.waitForCapture(opts.captureTimeoutMs ?? 8000);
-    }
-    catch {
-        captured = null;
-    }
-    return {
-        iframe,
-        capture,
-        captured,
-        dispose: () => {
-            capture.uninstall();
-            URL.revokeObjectURL(reexportUrl);
-            iframe.remove();
-        },
-    };
-}

package/dist/render/instance-mesh.d.ts

@@ -1,5 +0,0 @@
-import * as THREE from 'three';
-import type { InstancesFile } from '../asset-formats/instances';
-/** Build one native InstancedMesh from a parsed `.instances.json` tuple array. */
-export declare function buildInstancedMeshFromTuples(geometry: THREE.BufferGeometry, material: THREE.Material, tuples: InstancesFile): THREE.InstancedMesh;
-//# sourceMappingURL=instance-mesh.d.ts.map

package/dist/render/instance-mesh.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"instance-mesh.d.ts","sourceRoot":"","sources":["../../src/render/instance-mesh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,kFAAkF;AAClF,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,KAAK,CAAC,cAAc,EAC9B,QAAQ,EAAE,KAAK,CAAC,QAAQ,EACxB,MAAM,EAAE,aAAa,GACpB,KAAK,CAAC,aAAa,CAgBrB"}

package/dist/render/instance-mesh.js

@@ -1,19 +0,0 @@
-import * as THREE from 'three';
-/** Build one native InstancedMesh from a parsed `.instances.json` tuple array. */
-export function buildInstancedMeshFromTuples(geometry, material, tuples) {
-    const mesh = new THREE.InstancedMesh(geometry, material, tuples.length);
-    const position = new THREE.Vector3();
-    const quaternion = new THREE.Quaternion();
-    const scale = new THREE.Vector3();
-    const matrix = new THREE.Matrix4();
-    for (let index = 0; index < tuples.length; index += 1) {
-        const tuple = tuples[index];
-        position.set(tuple[0], tuple[1], tuple[2]);
-        quaternion.set(tuple[3], tuple[4], tuple[5], tuple[6]);
-        scale.set(tuple[7], tuple[8], tuple[9]);
-        matrix.compose(position, quaternion, scale);
-        mesh.setMatrixAt(index, matrix);
-    }
-    mesh.instanceMatrix.needsUpdate = true;
-    return mesh;
-}

package/schemas/mat.schema.json

@@ -1,255 +0,0 @@
-{
-  "$comment": "AUTO-GENERATED by scripts/generate-schema.ts — do not edit manually",
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "type": "object",
-  "properties": {
-    "version": {
-      "type": "number",
-      "description": "File format version"
-    },
-    "name": {
-      "type": "string",
-      "description": "Human-readable material name"
-    },
-    "material": {
-      "type": "object",
-      "properties": {
-        "type": {
-          "type": "string",
-          "enum": [
-            "standard",
-            "physical",
-            "basic",
-            "toon"
-          ],
-          "description": "Material shading model"
-        },
-        "color": {
-          "description": "Base color as CSS hex string (e.g. \"#ff0000\")",
-          "type": "string"
-        },
-        "metalness": {
-          "description": "Metalness factor 0–1 (standard/physical only)",
-          "type": "number"
-        },
-        "roughness": {
-          "description": "Roughness factor 0–1 (standard/physical only)",
-          "type": "number"
-        },
-        "map": {
-          "description": "Path to albedo/diffuse texture image",
-          "type": "string"
-        },
-        "normalMap": {
-          "description": "Path to normal map texture image",
-          "type": "string"
-        },
-        "emissive": {
-          "description": "Emissive color as CSS hex string",
-          "type": "string"
-        },
-        "emissiveIntensity": {
-          "description": "Emissive light intensity multiplier",
-          "type": "number"
-        },
-        "emissiveMap": {
-          "description": "Path to emissive map texture image",
-          "type": "string"
-        },
-        "aoMap": {
-          "description": "Path to ambient occlusion map texture image",
-          "type": "string"
-        },
-        "lightMap": {
-          "description": "Path to a baked lightmap texture (uses the mesh's second UV set). Applies the pre-baked GI/shadow result on top of the material.",
-          "type": "string"
-        },
-        "lightMapIntensity": {
-          "description": "Lightmap intensity multiplier (default 1).",
-          "type": "number"
-        },
-        "roughnessMap": {
-          "description": "Path to roughness map texture image",
-          "type": "string"
-        },
-        "metalnessMap": {
-          "description": "Path to metalness map texture image",
-          "type": "string"
-        },
-        "opacity": {
-          "description": "Opacity 0–1. Set transparent: true to enable",
-          "type": "number"
-        },
-        "transparent": {
-          "description": "Enable alpha blending for this material",
-          "type": "boolean"
-        },
-        "side": {
-          "description": "Which face sides to render",
-          "type": "string",
-          "enum": [
-            "front",
-            "back",
-            "double"
-          ]
-        },
-        "flatShading": {
-          "description": "Use flat (faceted) shading instead of smooth",
-          "type": "boolean"
-        },
-        "clearcoat": {
-          "description": "Clearcoat layer (physical only)",
-          "type": "object",
-          "properties": {
-            "clearcoat": {
-              "type": "number",
-              "description": "Clearcoat layer intensity 0–1"
-            },
-            "clearcoatRoughness": {
-              "description": "Clearcoat roughness 0–1",
-              "type": "number"
-            },
-            "clearcoatMap": {
-              "description": "Path to clearcoat intensity map",
-              "type": "string"
-            },
-            "clearcoatRoughnessMap": {
-              "description": "Path to clearcoat roughness map",
-              "type": "string"
-            }
-          },
-          "required": [
-            "clearcoat"
-          ],
-          "additionalProperties": false
-        },
-        "transmission": {
-          "description": "Light transmission (physical only)",
-          "type": "object",
-          "properties": {
-            "transmission": {
-              "type": "number",
-              "description": "Transmission intensity 0–1 (glass, liquid)"
-            },
-            "ior": {
-              "description": "Index of refraction (default 1.5)",
-              "type": "number"
-            },
-            "thickness": {
-              "description": "Volume thickness for refraction",
-              "type": "number"
-            },
-            "attenuationColor": {
-              "description": "Color absorbed over distance",
-              "type": "string"
-            },
-            "attenuationDistance": {
-              "description": "Distance at which attenuation color takes full effect",
-              "type": "number"
-            },
-            "transmissionMap": {
-              "description": "Path to transmission map",
-              "type": "string"
-            }
-          },
-          "required": [
-            "transmission"
-          ],
-          "additionalProperties": false
-        },
-        "sheen": {
-          "description": "Sheen layer (physical only)",
-          "type": "object",
-          "properties": {
-            "sheen": {
-              "type": "number",
-              "description": "Sheen intensity 0–1 (fabric, velvet)"
-            },
-            "sheenColor": {
-              "description": "Sheen tint color",
-              "type": "string"
-            },
-            "sheenRoughness": {
-              "description": "Sheen roughness 0–1",
-              "type": "number"
-            },
-            "sheenColorMap": {
-              "description": "Path to sheen color map",
-              "type": "string"
-            },
-            "sheenRoughnessMap": {
-              "description": "Path to sheen roughness map",
-              "type": "string"
-            }
-          },
-          "required": [
-            "sheen"
-          ],
-          "additionalProperties": false
-        },
-        "iridescence": {
-          "description": "Iridescence thin-film (physical only)",
-          "type": "object",
-          "properties": {
-            "iridescence": {
-              "type": "number",
-              "description": "Iridescence intensity 0–1 (soap bubbles, oil slick)"
-            },
-            "iridescenceIOR": {
-              "description": "Thin-film IOR (default 1.3)",
-              "type": "number"
-            },
-            "iridescenceThicknessRange": {
-              "description": "Min/max thin-film thickness in nm",
-              "type": "array",
-              "prefixItems": [
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "number"
-                }
-              ]
-            },
-            "iridescenceMap": {
-              "description": "Path to iridescence intensity map",
-              "type": "string"
-            },
-            "iridescenceThicknessMap": {
-              "description": "Path to iridescence thickness map",
-              "type": "string"
-            }
-          },
-          "required": [
-            "iridescence"
-          ],
-          "additionalProperties": false
-        },
-        "displacementMap": {
-          "description": "Path to displacement/height map",
-          "type": "string"
-        },
-        "displacementScale": {
-          "description": "Displacement height multiplier",
-          "type": "number"
-        },
-        "displacementBias": {
-          "description": "Displacement offset",
-          "type": "number"
-        }
-      },
-      "required": [
-        "type"
-      ],
-      "additionalProperties": false,
-      "description": "Material definition"
-    }
-  },
-  "required": [
-    "version",
-    "name",
-    "material"
-  ],
-  "additionalProperties": false,
-  "description": "Shared material asset file (.mat.json)"
-}

package/src/asset-formats/instances.ts

@@ -1,38 +0,0 @@
-import { z } from 'zod';
-
-/**
- * `.instances.json` — a declarative, authored-data instance-transform asset
- * (F3). Referenced by `mesh.instances` as a bare array of 10-number tuples,
- * one per instance, each `[posX,posY,posZ, quatX,quatY,quatZ,quatW,
- * scaleX,scaleY,scaleZ]`. The scene loader fetches+parses this file and
- * renders it as one `THREE.InstancedMesh` (one draw call) — bulk transform
- * data is referenced as an asset, never inlined into the referencing
- * document (gate G4).
- *
- * WO-8: the document that referenced it was `.vscn.json`, and that format is
- * deleted. `.instances.json` survives as a FETCHED-ASSET format with its own
- * `parseInstancesFile` — nothing in the shipped tree references one today.
- */
-export const InstancesFileSchema = z
-  .array(
-    z.tuple([
-      z.number().describe('posX'),
-      z.number().describe('posY'),
-      z.number().describe('posZ'),
-      z.number().describe('quatX'),
-      z.number().describe('quatY'),
-      z.number().describe('quatZ'),
-      z.number().describe('quatW'),
-      z.number().describe('scaleX'),
-      z.number().describe('scaleY'),
-      z.number().describe('scaleZ'),
-    ]),
-  )
-  .describe(
-    'Instance-transform asset (.instances.json): an array of 10-number tuples ' +
-      '[posX,posY,posZ, quatX,quatY,quatZ,quatW, scaleX,scaleY,scaleZ], one per instance. ' +
-      'Referenced by a mesh via `mesh.instances` and rendered as a single THREE.InstancedMesh ' +
-      '(one draw call).',
-  );
-
-export type InstancesFile = z.infer<typeof InstancesFileSchema>;

package/src/asset-formats/parse.ts

@@ -1,39 +0,0 @@
-import { AssetParseError } from '../asset-parse-error';
-import type { InstancesFile } from './instances';
-import { InstancesFileSchema } from './instances';
-import type { MaterialFile } from './material';
-import { MaterialFileSchema } from './material';
-
-// The error class itself is format-neutral and lives in
-// `engine/src/asset-parse-error.ts` (the input-map loader raises it too).
-// Re-exported here so callers have one import for parse + error.
-export { AssetParseError };
-
-/**
- * Parse a `.mat.json` shared material asset (T4.6). There is no version-range
- * gate for this format — `MaterialFileSchema`'s `version` field is RESERVED
- * (see `schema-consumption-map.ts`).
- *
- * Formerly `@engine/scene/parse`'s `parseMaterialFile`; moved here when WO-8
- * deleted the `.vscn` scene format that module was named for.
- */
-export function parseMaterialFile(json: unknown, filePath?: string): MaterialFile {
-  const result = MaterialFileSchema.safeParse(json);
-  if (!result.success) {
-    throw new AssetParseError(result.error.issues, filePath);
-  }
-  return result.data;
-}
-
-/**
- * Parse a `.instances.json` instance-transform asset (F3). Mirrors
- * `parseMaterialFile` exactly — no version-range gate (the format is a bare
- * tuple array, no `version` field).
- */
-export function parseInstancesFile(json: unknown, filePath?: string): InstancesFile {
-  const result = InstancesFileSchema.safeParse(json);
-  if (!result.success) {
-    throw new AssetParseError(result.error.issues, filePath);
-  }
-  return result.data;
-}