@vgai/engine 0.5.11 → 0.5.13

package/dist/render/viewport-shading.js

@@ -49,6 +49,7 @@ export class ViewportShadingRenderer {
     }
     dispose() {
         for (const pair of this._derived.values()) {
+            pair.clay.dispose();
             pair.unlit.dispose();
             pair.wireframe.dispose();
         }
@@ -77,6 +78,19 @@ export class ViewportShadingRenderer {
                 fog: material.fog ?? true,
             };
             pair = {
+                clay: new THREE.MeshStandardMaterial({
+                    color: 0xaeb6c0,
+                    roughness: 0.82,
+                    metalness: 0,
+                    flatShading: true,
+                    alphaMap: textureOf(material, 'alphaMap'),
+                    alphaTest: material.alphaTest,
+                    opacity: material.opacity,
+                    transparent: material.transparent,
+                    side: material.side,
+                    depthTest: material.depthTest,
+                    depthWrite: material.depthWrite,
+                }),
                 unlit: new THREE.MeshBasicMaterial(common),
                 wireframe: new THREE.MeshBasicMaterial({ ...common, wireframe: true }),
             };

package/dist/runtime/create-runtime.d.ts

@@ -180,6 +180,18 @@ export interface RootsRuntimeConfig {
      * a 2D canvas renderer with no GPU. Never set `true` in a real host.
      */
     headless?: boolean | undefined;
+    /**
+     * `vgai.project.json`'s `rendering.antialias` — whether every three root's
+     * WebGL context is built with a multisampled drawing buffer.
+     *
+     * It is a RUNTIME-CONFIG option rather than a world's own
+     * `WorldRendererConfig` field for the reason that file's header gives: a
+     * context's sample count is fixed at CREATION, before any world exists, so
+     * there is no honest moment at which a world could ask for it. The
+     * manifest-aware boot path (`mount-manifest.ts`) is the real reader;
+     * omitting it leaves `createHostRenderer`'s own registry default alone.
+     */
+    antialias?: boolean | undefined;
     /** D15 (T-D15.1) — the root seed `ctx.random` boots from on every world
      *  mounted onto this session's Game, forwarded to `createGame` BEFORE any
      *  world's `mount()`/`setup()` runs (this function constructs the Game

package/dist/runtime/create-runtime.d.ts.map

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

package/dist/runtime/create-runtime.js

@@ -130,10 +130,14 @@ function createHeadlessRendererStub() {
  *  `createRootsGameRuntime` purely to keep that function's own branching
  *  simple — see `mountOnePixiRoot` for the canvas sibling. */
 async function mountOneThreeRoot(spec, ctx) {
-    const { game, canvas, w, h, dpr, isBottom, headless, assets } = ctx;
+    const { game, canvas, w, h, dpr, isBottom, headless, assets, antialias } = ctx;
     const renderer = headless
         ? createHeadlessRendererStub()
-        : createHostRenderer(canvas, w, h, undefined, {
+        : createHostRenderer(canvas, w, h, 
+        // The manifest's `rendering.antialias` reaches the WebGL context here and NOWHERE else:
+        // `createHostRenderer` passes it straight to the constructor, and the sample count is
+        // fixed from that moment. Omitted → the render-settings registry's own default.
+        antialias === undefined ? undefined : { antialias }, {
             alpha: !isBottom,
             preserveDrawingBuffer: true,
         });
@@ -562,6 +566,7 @@ async function createRootsGameRuntime(config) {
         dpr,
         headless,
         assets,
+        antialias: config.antialias,
     });
     // --- Delegating input router (D5 §2a) ---
     const router = createInputRouter(container, routerEntries);

package/dist/runtime/mount-game.d.ts

@@ -29,7 +29,7 @@ export interface ManifestHost {
     /** Resolve asset/scene URLs relative to the project — forwarded to a
      *  registered {@link AdapterSurfaceFactory} via {@link AdapterSurfaceFactoryContext},
      *  never called by this module itself (a factory only needs it for a
-     *  non-default resolution scheme, e.g. a hosted-editor iframe). */
+     *  non-default resolution scheme, e.g. a project served under a base path). */
     resolveUrl?(path: string): string;
     readonly width?: number | undefined;
     readonly height?: number | undefined;

package/dist/runtime/mount-game.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-game.d.ts","sourceRoot":"","sources":["../../src/runtime/mount-game.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,UAAU,EAAuC,MAAM,kBAAkB,CAAC;AAQxF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;6DACyD;IACzD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD;;;uEAGmE;IACnE,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;gEAC4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,4BAA4B,KAC9B,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAQtC;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAUlF;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAcD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,EAAE,qBAexC,CAAC;AAMF,MAAM,WAAW,gBAAgB;IAC/B;;;kEAG8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAyCtB"}
+{"version":3,"file":"mount-game.d.ts","sourceRoot":"","sources":["../../src/runtime/mount-game.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,KAAK,UAAU,EAAuC,MAAM,kBAAkB,CAAC;AAQxF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;6DACyD;IACzD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD;;;mFAG+E;IAC/E,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;gEAC4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACzC;AAED,+EAA+E;AAC/E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,4BAA4B,KAC9B,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAQtC;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAUlF;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,IAAI,IAAI,CAE5D;AAcD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,0BAA0B,EAAE,qBAexC,CAAC;AAMF,MAAM,WAAW,gBAAgB;IAC/B;;;kEAG8D;IAC9D,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,YAAY,EAClB,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,WAAW,CAAC,CAyCtB"}

package/dist/runtime/mount-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-manifest.d.ts","sourceRoot":"","sources":["../../src/runtime/mount-manifest.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mount-manifest.d.ts","sourceRoot":"","sources":["../../src/runtime/mount-manifest.ts"],"names":[],"mappings":"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"}

package/dist/runtime/mount-manifest.js

@@ -120,7 +120,7 @@ function resolveThreeAdapter(world, entry) {
     if (world.adapter.type === 'ingest') {
         throw new Error(`mountManifestRoots: world "${world.id}" (three) declares an { ingest } adapter — ` +
             "ingest roots require the editor's dev-server-backed mount machinery (an EditorStore " +
-            "plus iframe/DOM capture, see adapter-resolver.ts's resolveIngestThreeAdapter) and are " +
+            "plus in-realm scene capture, see adapter-resolver.ts's resolveIngestThreeAdapter) and are " +
             'not supported by mountManifestRoots (no porting aids, no hosted ingest routes).');
     }
     // type === 'default'
@@ -252,6 +252,10 @@ export async function mountManifestRoots(opts) {
         width: opts.width ?? manifest.resolution?.width,
         height: opts.height ?? manifest.resolution?.height,
         headless: opts.headless,
+        // `rendering.antialias` reaches the WebGL context at CONSTRUCTION and can be honoured
+        // nowhere else — see the manifest schema's own `rendering` block and
+        // `world3d-react/renderer-config.ts`'s header for why it is not a world-level declaration.
+        ...(manifest.rendering === undefined ? {} : { antialias: manifest.rendering.antialias }),
         seed: resolvedSeed,
         playtest: opts.playtest,
     });

package/dist/world3d-react/r3f-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"r3f-adapter.d.ts","sourceRoot":"","sources":["../../src/world3d-react/r3f-adapter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAoB,WAAW,EAAoB,MAAM,YAAY,CAAC;AAMlF,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAYvF,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;uBAEmB;IACnB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B;;;;0CAIsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD;;;iDAG6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CAqc9E"}
+{"version":3,"file":"r3f-adapter.d.ts","sourceRoot":"","sources":["../../src/world3d-react/r3f-adapter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AASH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAoB,WAAW,EAAoB,MAAM,YAAY,CAAC;AAalF,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAYvF,sEAAsE;AACtE,MAAM,WAAW,uBAAuB;IACtC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;uBAEmB;IACnB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B;;;;0CAIsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClD;;;iDAG6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CACrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CAge9E"}

package/dist/world3d-react/r3f-adapter.js

@@ -21,7 +21,10 @@
 import { advance, createRoot, extend, events as pointerEvents, } from '@react-three/fiber';
 import { createElement } from 'react';
 import { registerRenderVitals } from '../dev/register-render-vitals';
+import { createRenderDebugAdapter, frameCaptureContextFor, } from '../dev/render-debug-adapter';
+import { collectRenderMemory } from '../dev/render-memory';
 import { RENDER_SUBMIT_PHASE } from '../dev/render-vitals';
+import { createWebGLFrameCapture } from '../dev/webgl-frame-capture';
 import { WorldProvider } from '../react/world-state';
 import { devLayersEnabled } from '../runtime/dev-layers';
 import { EngineBridge } from './engine-bridge';
@@ -328,6 +331,25 @@ export function createR3FAdapter(options) {
                     renderer: host.renderer,
                 });
             }
+            // Engine-owned render introspection, built over the SAME renderer and
+            // scene Fiber uses. A design-time stand-in has no context and a
+            // headless mount returned above, so both honestly omit the capability.
+            // `frameCaptureContextFor` is the same construction gate as the classic
+            // Three adapter; no editor-side renderer inference is involved.
+            const rendererContext = typeof host.renderer.getContext === 'function' ? host.renderer.getContext() : undefined;
+            const frameCaptureContext = frameCaptureContextFor(false, rendererContext);
+            const frameCapture = frameCaptureContext
+                ? createWebGLFrameCapture(frameCaptureContext)
+                : null;
+            const renderDebugWiring = frameCapture
+                ? createRenderDebugAdapter({
+                    capture: frameCapture,
+                    scene: state.scene,
+                    memory: () => collectRenderMemory(live().scene, host.renderer.info),
+                })
+                : null;
+            if (renderDebugWiring)
+                runtime.systemAdapters.renderDebug = renderDebugWiring.adapter;
             // The engine drives every `useFrame` through the mounted world's
             // `update(dt)` hook, never off a raw host-loop callback. That is the
             // whole pause story: `runFrameImpl` (`runtime/game.ts`) calls
@@ -379,9 +401,10 @@ export function createR3FAdapter(options) {
                     return live().camera;
                 },
                 drivesOwnLoop: false,
-                // Adapter surface: `debug` pre-seeded (the shared game registry's
-                // adapter); game code adds capabilities via
-                // `ctx.registerSystemAdapter` exactly as in a classic world.
+                // Adapter surface: `debug` (the shared game registry) and, when a real
+                // WebGL2 context exists, `renderDebug` are engine-seeded. Game code
+                // adds its own capabilities via `ctx.registerSystemAdapter` exactly
+                // as in a classic world.
                 systems: runtime.systemAdapters,
                 update(dt) {
                     elapsed += dt;
@@ -399,51 +422,58 @@ export function createR3FAdapter(options) {
                     // then fiber's advance (useFrame callbacks + the actual render see
                     // the fresh state). Both are host-gated: neither runs while frozen.
                     systems.run(dt);
-                    const profiler = host.game?.profiler;
-                    if (!profiler?.enabled) {
-                        advance(elapsed, true, current);
-                        return;
-                    }
-                    // Issue #1504's measurement, produced where the draw actually
-                    // happens. `advance()` under `frameloop: 'never'` is what calls
-                    // `gl.render(scene, camera)`, so this bracket — not a phase span
-                    // inside `systems` — is the frame's CPU submission cost, and it is
-                    // also what makes this frame a PRESENTATION as far as the vitals
-                    // fold is concerned (`../dev/render-vitals.ts`: no bracket, no
-                    // display frame). The profiler's phase clock is a stack, so
-                    // bracketing here cannot truncate an enclosing phase.
-                    const info = host.renderer.info;
-                    const passesBefore = info?.render.frame ?? 0;
-                    profiler.beginPhase();
+                    renderDebugWiring?.beforeRender();
                     try {
-                        advance(elapsed, true, current);
+                        const profiler = host.game?.profiler;
+                        if (!profiler?.enabled) {
+                            advance(elapsed, true, current);
+                            return;
+                        }
+                        // Issue #1504's measurement, produced where the draw actually
+                        // happens. `advance()` under `frameloop: 'never'` is what calls
+                        // `gl.render(scene, camera)`, so this bracket — not a phase span
+                        // inside `systems` — is the frame's CPU submission cost, and it is
+                        // also what makes this frame a PRESENTATION as far as the vitals
+                        // fold is concerned (`../dev/render-vitals.ts`: no bracket, no
+                        // display frame). The profiler's phase clock is a stack, so
+                        // bracketing here cannot truncate an enclosing phase.
+                        const info = host.renderer.info;
+                        const passesBefore = info?.render.frame ?? 0;
+                        profiler.beginPhase();
+                        try {
+                            advance(elapsed, true, current);
+                        }
+                        finally {
+                            profiler.endPhase(RENDER_SUBMIT_PHASE);
+                        }
+                        // Checked, not assumed — a duck-typed/design-time renderer supplies
+                        // only what a mount needs, and a mount with no counters must report
+                        // NOTHING rather than throw once per frame (the classic adapter's
+                        // `postFrame` pays for the same assumption for the same reason).
+                        // `gpuMs` is null: this path runs no GPU timer, and the profiler
+                        // keeps the previous reading rather than inventing a zero.
+                        if (info) {
+                            profiler.reportRender({
+                                gpuMs: null,
+                                drawCalls: info.render.calls,
+                                triangles: info.render.triangles,
+                                geometries: info.memory.geometries,
+                                textures: info.memory.textures,
+                                renderPasses: info.render.frame - passesBefore,
+                            });
+                        }
                     }
                     finally {
-                        profiler.endPhase(RENDER_SUBMIT_PHASE);
-                    }
-                    // Checked, not assumed — a duck-typed/design-time renderer supplies
-                    // only what a mount needs, and a mount with no counters must report
-                    // NOTHING rather than throw once per frame (the classic adapter's
-                    // `postFrame` pays for the same assumption for the same reason).
-                    // `gpuMs` is null: this path runs no GPU timer, and the profiler
-                    // keeps the previous reading rather than inventing a zero.
-                    if (info) {
-                        profiler.reportRender({
-                            gpuMs: null,
-                            drawCalls: info.render.calls,
-                            triangles: info.render.triangles,
-                            geometries: info.memory.geometries,
-                            textures: info.memory.textures,
-                            renderPasses: info.render.frame - passesBefore,
-                        });
+                        renderDebugWiring?.afterRender();
                     }
                 },
                 resize(width, height) {
                     live().setSize(width, height);
                 },
                 dispose() {
-                    // Unmount FIRST so component effect cleanups run, then tear the
-                    // runtime down (scoped debug-registry strip).
+                    // Reject/restore a pending capture while its renderables still
+                    // exist, then unmount component effects and strip runtime state.
+                    renderDebugWiring?.dispose();
                     root.unmount();
                     // The vitals fold owns two `profiler.subscribe` registrations, and
                     // `runtime.dispose()`'s `strip(id)` removes the REGISTRATIONS only —

package/dist/world3d-react/renderer-config.d.ts

@@ -36,11 +36,26 @@ export type WorldToneMapping = 'none' | 'linear' | 'reinhard' | 'cineon' | 'aces
  *    result is already in display space and encoding it a second time washes the frame out.
  */
 export type WorldOutputColorSpace = 'srgb' | 'srgb-linear';
+/**
+ * The shadow-map filter, named as data rather than as three's numeric enum.
+ *
+ * This is a renderer INSTANCE property (`WebGLRenderer.shadowMap.type`), not a context attribute,
+ * so unlike MSAA it has an honest moment at which a world can ask for it — which is the whole test
+ * this file's header states. A source engine that declares its own shadow filter (Godot 3's
+ * `rendering/quality/shadows/filter_mode`) would otherwise inherit whatever the host built with.
+ */
+export type WorldShadowMapType = 'basic' | 'pcf' | 'pcf-soft' | 'vsm';
 /** What a world may declare about the renderer that draws it. Every field is optional; see header. */
 export interface WorldRendererConfig {
     readonly toneMapping?: WorldToneMapping | undefined;
     readonly toneMappingExposure?: number | undefined;
     readonly outputColorSpace?: WorldOutputColorSpace | undefined;
+    /**
+     * `WebGLRenderer.shadowMap.type`. Writing it after a shadow map has already been built needs
+     * `shadowMap.needsUpdate`, which this function sets — three caches the compiled depth material
+     * per type and would otherwise keep filtering with the previous one.
+     */
+    readonly shadowMapType?: WorldShadowMapType | undefined;
     /**
      * The colour the frame is cleared to, as a CSS hex string. The renderer's existing clear ALPHA
      * is preserved: a stacked canvas is transparent on purpose (`create-runtime.ts` gives every

package/dist/world3d-react/renderer-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer-config.d.ts","sourceRoot":"","sources":["../../src/world3d-react/renderer-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3D,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,KAAK,EACnB,QAAQ,EAAE,KAAK,CAAC,aAAa,EAC7B,MAAM,EAAE,mBAAmB,GAC1B,MAAM,IAAI,CAgEZ"}
+{"version":3,"file":"renderer-config.d.ts","sourceRoot":"","sources":["../../src/world3d-react/renderer-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,mGAAmG;AACnG,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,CAAC;AAEd;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,CAAC;AAEtE,sGAAsG;AACtG,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACxD;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,KAAK,EACnB,QAAQ,EAAE,KAAK,CAAC,aAAa,EAC7B,MAAM,EAAE,mBAAmB,GAC1B,MAAM,IAAI,CA+EZ"}

package/dist/world3d-react/renderer-config.js

@@ -56,6 +56,12 @@ export function applyWorldRendererConfig(three, renderer, config) {
         srgb: three.SRGBColorSpace,
         'srgb-linear': three.LinearSRGBColorSpace,
     };
+    const shadowMapTypes = {
+        basic: three.BasicShadowMap,
+        pcf: three.PCFShadowMap,
+        'pcf-soft': three.PCFSoftShadowMap,
+        vsm: three.VSMShadowMap,
+    };
     const restores = [];
     if (config.toneMapping !== undefined) {
         const previous = renderer.toneMapping;
@@ -78,6 +84,15 @@ export function applyWorldRendererConfig(three, renderer, config) {
             renderer.outputColorSpace = previous;
         });
     }
+    if (config.shadowMapType !== undefined && renderer.shadowMap !== undefined) {
+        const previous = renderer.shadowMap.type;
+        renderer.shadowMap.type = shadowMapTypes[config.shadowMapType];
+        renderer.shadowMap.needsUpdate = true;
+        restores.push(() => {
+            renderer.shadowMap.type = previous;
+            renderer.shadowMap.needsUpdate = true;
+        });
+    }
     if (config.clearColor !== undefined) {
         const previousColor = new three.Color();
         renderer.getClearColor(previousColor);

package/dist/world3d-react/world-context.d.ts

@@ -98,7 +98,8 @@ export interface R3FRootRuntime {
     /** The world-local phase runner `mount().update(dt)` ticks. */
     readonly systems: ReturnType<typeof createSystemRunner>;
     /** The mounted world's `SystemAdapters` bag (`mounted.systems`) —
-     *  `ctx.registerSystemAdapter` writes into it; `debug` is pre-seeded. */
+     *  `ctx.registerSystemAdapter` writes into it; `debug` is pre-seeded here,
+     *  and the R3F mount adds renderer-backed engine capabilities after commit. */
     readonly systemAdapters: SystemAdapters;
     /** The registry every registration of this world's lands in — the game's
      *  own when a `Game` hosts it, a private mount-local one otherwise. Exposed

package/dist/world3d-react/world-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-context.d.ts","sourceRoot":"","sources":["../../src/world3d-react/world-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgCK;AAEL,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAOhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;iFACiF;AACjF,eAAO,MAAM,sBAAsB,qCAAqC,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,WAAW,EACT,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,SAAS,GACT,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,UAAU,GACV,uBAAuB,CAC1B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC;gFAC4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnD;AAED;+EAC+E;AAC/E,MAAM,WAAW,cAAc;IAC7B;6EACyE;IACzE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACxD;6EACyE;IACzE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;;;yDAMqD;IACrD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC;qEACiE;IACjE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;4DAGwD;IACxD,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/D;;gFAE4E;IAC5E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAsKhB"}
+{"version":3,"file":"world-context.d.ts","sourceRoot":"","sources":["../../src/world3d-react/world-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgCK;AAEL,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAOhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;iFACiF;AACjF,eAAO,MAAM,sBAAsB,qCAAqC,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,WAAW,EACT,OAAO,GACP,QAAQ,GACR,YAAY,GACZ,OAAO,GACP,QAAQ,GACR,SAAS,GACT,OAAO,GACP,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,UAAU,GACV,uBAAuB,CAC1B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC;gFAC4E;IAC5E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACnD;AAED;+EAC+E;AAC/E,MAAM,WAAW,cAAc;IAC7B;6EACyE;IACzE,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IACxD;;mFAE+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;;;;yDAMqD;IACrD,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC;qEACiE;IACjE,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;4DAGwD;IACxD,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IAC/D;;gFAE4E;IAC5E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,qBAAqB,GAC7B,cAAc,CAsKhB"}

package/dist-config/config.js

@@ -1,5 +1,110 @@
-// src/data/data-ref.ts
+// src/data/curve.ts
 import { z } from "zod";
+var CURVE_META_KEY = "x-vgai-curve";
+function axisLabel(axes, axis) {
+  return axes[axis].label ?? axis;
+}
+function checkPoints(value, axes, ctx) {
+  const points = value.points;
+  for (let i = 0; i < points.length; i++) {
+    const point = points[i];
+    for (const axis of ["x", "y"]) {
+      const { min, max } = axes[axis];
+      if (point[axis] < min || point[axis] > max) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["points", i, axis],
+          message: `${point[axis]} is outside this curve's ${axisLabel(axes, axis)} domain [${min}, ${max}] \u2014 move the point inside the domain, or widen the axis in the schema (curve({ ${axis}: { min, max } })).`
+        });
+      }
+    }
+    if (i === 0) continue;
+    const previous = points[i - 1];
+    if (point.x <= previous.x) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["points", i, "x"],
+        message: `${point.x} must be strictly greater than the previous point's x (${previous.x}) \u2014 curve points run left to right along x, with no duplicate x. Sort the points, or nudge this one.`
+      });
+    }
+  }
+}
+function curve(axes) {
+  const point = z.strictObject({
+    x: z.number().describe(`Position along ${axisLabel(axes, "x")}.`),
+    y: z.number().describe(`Value at that position, along ${axisLabel(axes, "y")}.`)
+  });
+  return z.strictObject({
+    interpolation: z.enum(["linear", "smooth"]).describe(
+      'How the value moves between points: "linear" for straight segments, "smooth" for a monotone cubic that never overshoots them.'
+    ),
+    points: z.array(point).min(2, {
+      message: 'a curve needs at least two points \u2014 add another { "x": \u2026, "y": \u2026 } so the value has somewhere to travel between.'
+    }).describe("Keys in increasing x order; the value is clamped outside the first/last x.")
+  }).superRefine((value, ctx) => checkPoints(value, axes, ctx)).meta({ [CURVE_META_KEY]: axes });
+}
+function monotoneTangents(points) {
+  const n = points.length;
+  const secants = [];
+  for (let i = 0; i < n - 1; i++) {
+    const left = points[i];
+    const right = points[i + 1];
+    secants.push((right.y - left.y) / (right.x - left.x));
+  }
+  const tangents = [secants[0]];
+  for (let i = 1; i < n - 1; i++) {
+    tangents.push((secants[i - 1] + secants[i]) / 2);
+  }
+  tangents.push(secants[n - 2]);
+  for (let i = 0; i < n - 1; i++) {
+    const secant = secants[i];
+    if (secant === 0) {
+      tangents[i] = 0;
+      tangents[i + 1] = 0;
+      continue;
+    }
+    let alpha = tangents[i] / secant;
+    let beta = tangents[i + 1] / secant;
+    if (alpha < 0) {
+      tangents[i] = 0;
+      alpha = 0;
+    }
+    if (beta < 0) {
+      tangents[i + 1] = 0;
+      beta = 0;
+    }
+    const radius = alpha * alpha + beta * beta;
+    if (radius > 9) {
+      const scale = 3 / Math.sqrt(radius);
+      tangents[i] = scale * alpha * secant;
+      tangents[i + 1] = scale * beta * secant;
+    }
+  }
+  return tangents;
+}
+function sampleCurve(value, x) {
+  const points = value.points;
+  if (points.length === 0) return 0;
+  const first = points[0];
+  const last = points[points.length - 1];
+  if (points.length === 1 || x <= first.x) return first.y;
+  if (x >= last.x) return last.y;
+  let i = 0;
+  while (i < points.length - 2 && x >= points[i + 1].x) i++;
+  const left = points[i];
+  const right = points[i + 1];
+  const span = right.x - left.x;
+  if (span <= 0) return left.y;
+  const t = (x - left.x) / span;
+  if (value.interpolation === "linear") return left.y + (right.y - left.y) * t;
+  const tangents = monotoneTangents(points);
+  const t2 = t * t;
+  const t3 = t2 * t;
+  return (2 * t3 - 3 * t2 + 1) * left.y + (t3 - 2 * t2 + t) * span * tangents[i] + (-2 * t3 + 3 * t2) * right.y + (t3 - t2) * span * tangents[i + 1];
+}
+
+// src/data/data-ref.ts
+import { z as z2 } from "zod";
 
 // src/data/data-check-core.ts
 var DATA_REF_PATTERN = /^([A-Za-z0-9_-]+)#([A-Za-z0-9_-]+(?:\.[A-Za-z0-9_-]+)*)$/;
@@ -96,7 +201,7 @@ function refPattern(target) {
   return new RegExp(`^${target}#[A-Za-z0-9_-]+(?:\\.[A-Za-z0-9_-]+)*$`);
 }
 function dataRef(target) {
-  return z.string().regex(refPattern(target), {
+  return z2.string().regex(refPattern(target), {
     message: `must be a "${target}#<key>" reference \u2014 expected the target asset stem "${target}", e.g. "${target}#some-key".`
   }).meta({ "x-vgai-ref": target });
 }
@@ -138,14 +243,10 @@ function getRef(target, ref) {
   return node;
 }
 
-// src/data/vite-plugin-data.ts
-import { readdirSync, readFileSync, statSync } from "node:fs";
-import { join, relative } from "node:path";
-
 // src/data/data-asset.ts
-import { z as z2 } from "zod";
+import { z as z3 } from "zod";
 function toDataJsonSchema(schema) {
-  const emitted = z2.toJSONSchema(schema, { io: "input" });
+  const emitted = z3.toJSONSchema(schema, { io: "input" });
   if (emitted["type"] === "object") {
     const properties = emitted["properties"] ?? {};
     properties["$schema"] ??= { type: "string" };
@@ -168,17 +269,27 @@ Fix the JSON to match the Zod schema (its emitted twin, "${sourcePath.replace(/\
 }
 
 // src/data/vite-plugin-data.ts
-function findDataFiles(dir) {
+async function loadNodeIo() {
+  const [fs, path] = await Promise.all([import("node:fs"), import("node:path")]);
+  return {
+    readdirSync: fs.readdirSync,
+    readFileSync: fs.readFileSync,
+    statSync: fs.statSync,
+    join: path.join,
+    relative: path.relative
+  };
+}
+function findDataFiles(io, dir) {
   let entries;
   try {
-    entries = readdirSync(dir);
+    entries = io.readdirSync(dir);
   } catch {
     return [];
   }
   const out = [];
   for (const entry of entries) {
-    const full = join(dir, entry);
-    if (statSync(full).isDirectory()) out.push(...findDataFiles(full));
+    const full = io.join(dir, entry);
+    if (io.statSync(full).isDirectory()) out.push(...findDataFiles(io, full));
     else if (entry.endsWith(".data.json")) out.push(full);
   }
   return out;
@@ -187,17 +298,17 @@ function assetStem(sourcePath) {
   const rel = sourcePath.split("\\").join("/");
   return rel.split("/").pop()?.replace(/\.data\.json$/, "") ?? rel;
 }
-function parseAllDataFiles(root, registered, errors, warnings) {
+function parseAllDataFiles(io, root, registered, errors, warnings) {
   const parsedByStem = /* @__PURE__ */ new Map();
   const pathsByStem = /* @__PURE__ */ new Map();
-  for (const abs of findDataFiles(join(root, "src", "data"))) {
-    const rel = relative(root, abs).split("\\").join("/");
+  for (const abs of findDataFiles(io, io.join(root, "src", "data"))) {
+    const rel = io.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")));
+      parsedByStem.set(stem, JSON.parse(io.readFileSync(abs, "utf-8")));
     } catch (err) {
       errors.push(
         `"${rel}" is not valid JSON: ${err instanceof Error ? err.message : String(err)}`
@@ -221,12 +332,19 @@ function parseAllDataFiles(root, registered, errors, warnings) {
   }
   return { parsedByStem, ambiguousStems };
 }
-function collectDataCheckProblems(options) {
+async function collectDataCheckProblems(options) {
+  const io = await loadNodeIo();
   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);
+  const { parsedByStem, ambiguousStems } = parseAllDataFiles(
+    io,
+    root,
+    registered,
+    errors,
+    warnings
+  );
   for (const asset of options.assets) {
     const rel = asset.sourcePath.split("\\").join("/");
     if (!parsedByStem.has(assetStem(rel))) {
@@ -268,8 +386,8 @@ function vgaiDataCheck(options) {
   return {
     name: "vgai:data-check",
     apply: "build",
-    buildStart() {
-      const { errors, warnings } = collectDataCheckProblems(options);
+    async buildStart() {
+      const { errors, warnings } = await collectDataCheckProblems(options);
       for (const warning of warnings) this.warn(warning);
       if (errors.length > 0) {
         this.error(
@@ -296,8 +414,10 @@ ${[...leaked].map((id) => `  - ${id}`).join("\n")}`
   };
 }
 export {
+  curve,
   dataRef,
   getRef,
+  sampleCurve,
   vgaiDataCheck
 };
 //# sourceMappingURL=config.js.map