incanto 0.31.0 → 0.32.0

package/bin/incanto-play.mjs

@@ -17,6 +17,7 @@ import { dirname, join, resolve } from 'node:path';
  *   pointer <dx> <dy>        look deltas               wheel <dy>
  *   capture [file]           current state as scene JSON (stdout or file)
  *   describe                 one line per node, non-default props only
+ *   framing                  what the camera SEES: on/off screen, lights, overlaps
  *   logs                     engine.log entries since the last call
  *   quit
  *
@@ -56,7 +57,7 @@ if (args.help || !args.scene) {
   console.error(`Usage: incanto-play <scene.json> [--behaviors <file.ts|.js>] [--seed N] [--fixed-hz 60] [--commands <file>]
 
 Headless play: stdin commands (step/press/release/vector/key/mouse/pointer/
-wheel/capture/describe/logs/quit), JSON-line responses on stdout.`);
+wheel/capture/describe/framing/logs/quit), JSON-line responses on stdout.`);
   process.exit(args.help && args.scene !== undefined ? 0 : 1);
 }
 
@@ -175,6 +176,10 @@ function handle(line) {
       case 'describe':
         out({ ok: true, cmd, text: session.describe() });
         break;
+      case 'framing':
+        // what the camera can SEE — on/off screen, lit or black, overlaps
+        out({ ok: true, cmd, text: session.framing() });
+        break;
       case 'logs':
         out({ ok: true, cmd, entries: session.drainLogs() });
         break;
@@ -188,7 +193,7 @@ function handle(line) {
           cmd,
           error: {
             code: 'UNKNOWN_COMMAND',
-            message: `unknown command '${cmd}'. Commands: step press release vector key mouse pointer wheel capture describe logs quit`,
+            message: `unknown command '${cmd}'. Commands: step press release vector key mouse pointer wheel capture describe framing logs quit`,
           },
         });
     }

package/dist/2d.js

@@ -1,5 +1,5 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-z5XaB1p5.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-bKHgHcsZ.js";
 import { _ as RigidBody2D, a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, g as PhysicsBody2D, h as CharacterBody2D, i as mergeSolidRects, l as CharacterController2D, m as Area2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D, v as StaticBody2D, y as Node2D } from "./register-tkR_8tWg.js";
 import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-D9wquBvK.js";
 //#region src/2d/library-sprite.ts

package/dist/3d.d.ts

@@ -488,6 +488,16 @@ interface CreateGame3DOptions {
   /** Keep the frame rate by rendering fewer pixels while frames run slow
   * (default ON). `false` pins the resolution — screenshots, capture, tests. */
   adaptiveResolution?: boolean;
+  /**
+  * Keep the drawing buffer readable so the canvas can be screenshot.
+  *
+  * WebGL clears it the instant a frame composites, so `toDataURL()` — and every
+  * screenshot built on it — is BLANK without this. Off by default: it costs a
+  * buffer copy per frame and only a run that means to look at the output should
+  * pay for it. `environment.rendering.preserveDrawingBuffer` does the same from
+  * the scene.
+  */
+  preserveDrawingBuffer?: boolean;
   resolveScene?: LoadSceneOptions["resolveScene"];
   /**
   * Boot progress, for the loading screen an app already has.
@@ -2998,6 +3008,16 @@ interface Renderer3DOptions {
   * the resolution — for screenshots, video capture and pixel-diff tests.
   */
   adaptiveResolution?: boolean;
+  /**
+  * Keep the drawing buffer readable so the canvas can be SCREENSHOT.
+  *
+  * WebGL clears it the moment a frame composites, so `canvas.toDataURL()` and
+  * anything built on it (a Playwright screenshot, a pixel-diff test) comes
+  * back blank without this. Off by default — it costs a buffer copy per frame
+  * and only a run that intends to look at the output should pay it. The scene
+  * can ask for it too: `environment.rendering.preserveDrawingBuffer`.
+  */
+  preserveDrawingBuffer?: boolean;
 }
 /**
 * WebGL presentation layer: subscribes to `engine.updated`, mirrors the active

package/dist/3d.js

@@ -1,6 +1,6 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { A as Water3D, F as PhysicsBody3D, I as RigidBody3D, L as StaticBody3D, M as WaterCutout3D, N as Area3D, P as CharacterBody3D, R as Node3D, V as WATER_MAX_RIPPLES, j as WATER_CUTOUT_MAX } from "./gameplay-BftxM_It.js";
-import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-DqOjMBUS.js";
+import { a as Environment3D, c as sunDirectionFromElevationAzimuth, i as syncTree, l as sunDirectionFromSky, o as horizonColorFromSky, r as Renderer3D, s as parseEnvironment3D, t as createGame3D, u as AssetStore3D } from "./create-game-gXI7PYl0.js";
 import { A as Terrain3D, B as keyboardIntensity, C as resolveFlowerDensity, D as BoneLookAt3D, E as Camera3D, F as InstancedMesh3D, H as rigPose, I as MeshInstance3D, M as TERRAIN_THEMES, N as terrainThemeLayers, O as BoneAttachment3D, P as Joint3D, R as QUARTER_PITCH, S as Flowers3D, T as CharacterController3D, V as movementState, _ as LoftMesh3D, a as Tree3D, b as Foliage3D, c as buildRiverRings, d as riverCarveChannels, f as riverStepFor, g as ModelInstance3D, h as Particles3D, i as VoxelGrid3D, j as DEFAULT_TERRAIN_TEXTURE_BASE, k as Billboard3D, l as findRiverCoverageGaps, m as traceDownhillPath, n as registerNodes3D, o as Trail3D, p as smoothCourse, r as VOXEL_PALETTE, s as River3D, u as projectToRiver, v as DirectionalLight3D, w as FLOWER_VARIETIES, x as DENSITY_PRESETS, y as OmniLight3D, z as cameraRelative } from "./environment-presets--DigHNg4.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CnPygVGo.js";

package/dist/{create-game-z5XaB1p5.js → create-game-bKHgHcsZ.js}

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { m as diagnose, n as loadScene, o as computeViewport, s as resolveViewport, y as registerBehavior } from "./loader-BlaRQGaA.js";
 import { l as AudioPlayer, u as Engine } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
+import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.js";
 import { n as registerGameplayBehaviors } from "./gameplay-BftxM_It.js";
 import { g as PhysicsBody2D, n as UILayer, t as registerNodes2D, u as Camera2D, y as Node2D } from "./register-tkR_8tWg.js";
@@ -269,7 +269,8 @@ var Renderer2D = class {
 		this.assets = opts.assets ?? new AssetStore2D(void 0, this.engine);
 		const rendering = resolveRendering(opts.engine.scene?.environment, {
 			antialias: true,
-			pixelRatio: 1
+			pixelRatio: 1,
+			preserveDrawingBuffer: false
 		}, globalThis.devicePixelRatio ?? 1, opts);
 		this.webgl = new WebGLRenderer({
 			canvas: opts.canvas,

package/dist/{create-game-DqOjMBUS.js → create-game-gXI7PYl0.js}

@@ -2,7 +2,7 @@ import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { m as diagnose, n as loadScene, y as registerBehavior } from "./loader-BlaRQGaA.js";
 import { l as AudioPlayer, u as Engine } from "./register-Dzkd6-os.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { i as resolveRendering, n as attachTouchControls } from "./touch-031PxtCR.js";
+import { i as resolveRendering, n as attachTouchControls } from "./touch-BoNg_MnF.js";
 import { a as poseFromRenderer, i as openBundledEditor, n as crossFade, r as devServerLibrary, t as teardown } from "./teardown-ByzfDPyu.js";
 import { B as createCausticsQuad, F as PhysicsBody3D, R as Node3D, n as registerGameplayBehaviors } from "./gameplay-BftxM_It.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
@@ -1554,11 +1554,16 @@ var Renderer3D = class {
 		this.assets = opts.assets ?? new AssetStore3D(this.engine);
 		const rendering = resolveRendering(opts.engine.scene?.environment, {
 			antialias: true,
-			pixelRatio: Math.min(globalThis.devicePixelRatio ?? 1, 2)
-		}, globalThis.devicePixelRatio ?? 1, { pixelRatio: opts.pixelRatio });
+			pixelRatio: Math.min(globalThis.devicePixelRatio ?? 1, 2),
+			preserveDrawingBuffer: false
+		}, globalThis.devicePixelRatio ?? 1, {
+			pixelRatio: opts.pixelRatio,
+			preserveDrawingBuffer: opts.preserveDrawingBuffer
+		});
 		this.webgl = new WebGLRenderer({
 			canvas: opts.canvas,
-			antialias: rendering.antialias
+			antialias: rendering.antialias,
+			preserveDrawingBuffer: rendering.preserveDrawingBuffer
 		});
 		this.webgl.info.autoReset = false;
 		this.basePixelRatio = rendering.pixelRatio;
@@ -2194,7 +2199,8 @@ async function createGame3D(opts) {
 		canvas: opts.canvas,
 		engine,
 		...opts.pixelRatio !== void 0 ? { pixelRatio: opts.pixelRatio } : {},
-		...opts.adaptiveResolution !== void 0 ? { adaptiveResolution: opts.adaptiveResolution } : {}
+		...opts.adaptiveResolution !== void 0 ? { adaptiveResolution: opts.adaptiveResolution } : {},
+		...opts.preserveDrawingBuffer !== void 0 ? { preserveDrawingBuffer: opts.preserveDrawingBuffer } : {}
 	});
 	await report(.14, "renderer");
 	const wantDebug = opts.debug ?? false;

package/dist/index.d.ts

@@ -401,10 +401,20 @@ declare function registerCoreNodes(): void;
 interface ResolvedRendering {
   antialias: boolean;
   pixelRatio: number;
+  /**
+  * Keep the drawing buffer readable after a frame (default false).
+  *
+  * WebGL clears it as soon as the frame is composited, so `canvas.toDataURL()`
+  * — and therefore ANY screenshot a driver takes — comes back blank. Turning
+  * this on costs a buffer copy per frame, which is why it is off for games and
+  * on for the run where something is trying to LOOK at the output.
+  */
+  preserveDrawingBuffer: boolean;
 }
 declare function resolveRendering(environment: JsonObject | undefined, fallback: ResolvedRendering, devicePixelRatio: number, explicit?: {
   antialias?: boolean;
   pixelRatio?: number;
+  preserveDrawingBuffer?: boolean;
 }): ResolvedRendering;
 //#endregion
 //#region src/core/replay.d.ts

package/dist/index.js

@@ -8,7 +8,7 @@ import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
 import { n as ORDER_GROUP_BASE, r as effectiveOrder, t as duplicateNode } from "./duplicate-KRPtUtzl.js";
 import { i as applyParticlePreset, n as PARTICLE_PRESETS, r as PARTICLE_PRESET_NAMES, t as ParticleSim } from "./particle-sim-Bw7hB93B.js";
-import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-031PxtCR.js";
+import { i as resolveRendering, n as attachTouchControls, r as joystickVector, t as TouchControls } from "./touch-BoNg_MnF.js";
 //#region src/core/pathfinding.ts
 /**
 * A* from `from` to `to` (inclusive cell coords). Returns the cell path
@@ -295,6 +295,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.31.0";
+const VERSION = "0.32.0";
 //#endregion
 export { AudioBuses, AudioPlayer, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, Scene, SceneTree, SfxEngine, Signal, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiText, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, mergeStaticSignals, newUid, parseNodePath, preloadUrls, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveRendering, resolveViewport, serializeNode, spatialGain, spatialPan, startRecording, synthSfx };

package/dist/react.js

@@ -156,7 +156,7 @@ function IncantoCanvas(props) {
 				pointer: latest.pointer,
 				...keyboard !== void 0 ? { keyboard } : {}
 			};
-			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DqOjMBUS.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-z5XaB1p5.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-gXI7PYl0.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-bKHgHcsZ.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;