incanto 0.75.0 → 0.77.0

package/dist/2d.d.ts

@@ -2,7 +2,7 @@ import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as Spatial
 import { P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-B_245qRy.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson, s as JsonObject } from "./rng-BsXZg3D6.js";
-import { t as EditorSwitchOptions } from "./editor-switch-O8mxpgRX.js";
+import { t as EditorSwitchOptions } from "./editor-switch-Bzt0GzVp.js";
 import { r as FrameStats } from "./frame-report-DNxDAb1w.js";
 import { t as LoadSceneOptions } from "./loader-CbkVdXL8.js";
 import { n as AnimationEntry } from "./sprite-animation-CMr6f1K2.js";

package/dist/2d.js

@@ -1,10 +1,10 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
 import { t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-DnwhJ5nW.js";
-import { _ as Node2D, f as Area2D, g as StaticBody2D, h as RigidBody2D, m as PhysicsBody2D, p as CharacterBody2D } from "./gameplay-D-JuGura.js";
-import { a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, i as mergeSolidRects, l as CharacterController2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D } from "./register-DxAbTO2T.js";
-import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-x3bCrQf0.js";
+import { a as AssetStore2D, i as syncTree2D, r as Renderer2D, t as createGame2D } from "./create-game-BMIPKrQW.js";
+import { _ as Node2D, f as Area2D, g as StaticBody2D, h as RigidBody2D, m as PhysicsBody2D, p as CharacterBody2D } from "./gameplay-Bfff_beb.js";
+import { a as parseCells, c as ColorRect2D, d as AnimatedSprite2D, f as Sprite2D, i as mergeSolidRects, l as CharacterController2D, n as UILayer, o as Particles2D, p as Joint2D, r as TileMap2D, s as Label, t as registerNodes2D, u as Camera2D } from "./register-7E3P1gz6.js";
+import { n as enablePhysics2D, t as Physics2D } from "./physics-2d-Tuf5LAyq.js";
 //#region src/2d/library-sprite.ts
 /**
 * What a `CharacterController2D`/`3D` will ask a skin to play, and the clip in

package/dist/3d.d.ts

@@ -2,7 +2,7 @@ import { c as showBootFailure, i as ParticleSim, o as ParticleView, r as Spatial
 import { D as QualityCaps, P as Scene$1, S as Scheduler, T as RendererStats, b as Engine, d as PropSchema, jt as Node, n as BehaviorCtor, w as GameStats, x as EngineOptions } from "./behavior-B_245qRy.js";
 import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
 import { a as SceneJson$1, s as JsonObject } from "./rng-BsXZg3D6.js";
-import { t as EditorSwitchOptions } from "./editor-switch-O8mxpgRX.js";
+import { t as EditorSwitchOptions } from "./editor-switch-Bzt0GzVp.js";
 import { a as GridCell, c as diffText, d as frameText, i as FrameStatsOptions, l as frameSignature, n as FrameSignature, o as SIGNATURE_GRID, r as FrameStats, s as diffSignatures, t as FrameDiff, u as frameStats } from "./frame-report-DNxDAb1w.js";
 import { t as LoadSceneOptions } from "./loader-CbkVdXL8.js";
 import { n as PathGrid } from "./pathfinding-_fGrCFmH.js";
@@ -1763,8 +1763,18 @@ declare class CharacterController3D extends Node3D {
   * is what a drowning pit wants and what every scene got before this.
   */
   swimSpeed: number;
-  /** Where the body's origin rides below the surface while swimming (m). */
-  swimDepth: number;
+  /**
+  * How far the body's ORIGIN rides below the surface while swimming (m), or
+  * `null` (the default) to take it from the body: deep enough that the head
+  * rides 15 cm clear and the rest is in the water, which is what treading
+  * water looks like.
+  *
+  * The origin is the middle of the capsule, so a fixed number is only ever
+  * right for one character size. The 0.35 m this used to default to left the
+  * head of a standard 1.68 m rig 0.46 m clear of the surface — a person
+  * floating like a boat, chest and shoulders in the air.
+  */
+  swimDepth: number | null;
   /** Held: swim down at `swimSpeed`. Missing from the input map is fine. */
   diveAction: string;
   /**
@@ -1820,6 +1830,20 @@ declare class CharacterController3D extends Node3D {
   * 200 kg character does not move a seesaw a 70 kg crate tips.
   */
   stepHeight: number;
+  /**
+  * The steepest ground this character STANDS on, in degrees (0-90).
+  *
+  * At or under it the ground is ground: the character holds its place with no
+  * slide at all, however long you leave it there. Over it the ground stops
+  * counting as ground — no hover spring, no `grounded`, no jump reset — and
+  * the body slips off the face, which is what a slope limit means in every
+  * engine that has one.
+  *
+  * 55° is a person. A mountain goat is 80; something on wheels is 25. `90`
+  * turns the limit off — which is what this controller did before it had one,
+  * and why it slid down a 7° hillside.
+  */
+  slopeLimitDeg: number;
   mouseLook: boolean;
   zoomMin: number;
   zoomMax: number;
@@ -1907,6 +1931,10 @@ declare class CharacterController3D extends Node3D {
   /** idle | walk | run | fastRun | airborne | swim — drive animations from this. */
   state: MovementState;
   grounded: boolean;
+  /** Slope of the ground under the character, degrees — 0 when there is none. */
+  groundSlopeDeg: number;
+  /** Its outward normal, or null. `[0, 1, 0]` is flat ground. */
+  groundNormal: [number, number, number] | null;
   /** In water too deep to stand in — held at the surface by the swim spring. */
   swimming: boolean;
   /** The head is under the surface (diving, or a wave over it). */
@@ -1936,6 +1964,12 @@ declare class CharacterController3D extends Node3D {
   private jumping;
   /** Seconds of air control still suppressed after a wall kick. */
   private wallLockout;
+  /** What the anti-slide has learned it must keep paying to hold a slope. */
+  private slideHold;
+  /** Where the body stood last step, for the anti-slide's position error. */
+  private slideFrom;
+  /** Seconds since the player last asked this character to move. */
+  private stillFor;
   /** The outward normal of the wall being pressed into this step, if any. */
   private wallNormal;
   private get body();
@@ -1959,6 +1993,8 @@ declare class CharacterController3D extends Node3D {
   */
   private setHeight;
   private sceneGravity;
+  /** `swimDepth`, or what it is derived to be for this body (see the prop). */
+  private effectiveSwimDepth;
   private surfaceAt;
   /**
   * Read an input action this controller is allowed to be missing.
@@ -3500,6 +3536,12 @@ declare class River3D extends Node3D implements SunConsumer3D {
   private rockScanAt;
   private world;
   private readonly _bodies;
+  private cubeTarget;
+  private cubeCamera;
+  private lastSkyAt;
+  private rippleFft;
+  private rippleSpectrum;
+  private fftUnsupported;
   /** Loader hook: a malformed river fails at LOAD, not as an invisible ribbon. */
   static validateJson(node: Node): void;
   protected override _createObject3D(): Object3D;
@@ -3511,6 +3553,10 @@ declare class River3D extends Node3D implements SunConsumer3D {
   override _syncObject3D(): void;
   /** Rocks are picked per FRAME (nearest to the eye), scanned on a timer. */
   _onRender3D(ctx: RenderContext3D): void;
+  /** The sky cube: the world beyond the banks, from above the channel's middle. */
+  private syncSky;
+  /** The ripple FFT, advected by the fragment in the ribbon's own frame. */
+  private syncRipple;
   /**
   * @internal Water surface height over a world point, or null where this
   * river does not run — the question scattered vegetation asks before it
@@ -4143,6 +4189,16 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   */
   mirror: boolean;
   /**
+  * Screen-space reflections (fancy only, default on): the scene ABOVE the
+  * waterline is rendered once at half resolution and every water pixel
+  * marches its reflected ray through that image — so a rock, a pier, a
+  * wader or a boat is mirrored on the water WITHOUT the planar `mirror`
+  * pass. What the screen cannot see (behind the camera, off its edges)
+  * falls back to the sky cube, which is why a mirror-calm lake still wants
+  * `mirror: true`; with `mirror` on this is skipped as redundant.
+  */
+  ssr: boolean;
+  /**
   * Milliseconds between planar-mirror re-renders. A reflection seen through a
   * rippling surface does not need 60 Hz — 33 ms halves the pass's cost and
   * nobody can tell. 0 re-renders every frame.
@@ -4203,6 +4259,30 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   /** Primary swell wavelength in meters (the two crossing trains derive). */
   swellWavelength: number;
   /**
+  * The bottom under this water: a node path to a Terrain3D (fancy only). With
+  * it the swell KNOWS the beach — waves slow and rise as the bottom comes up
+  * (Green's law), their crests peak, and at 0.78× the depth they BREAK into
+  * foam, with spray sprites bursting where the foam fronts pass. Sampled
+  * once into a 256² depth grid over the terrain's footprint; beyond it the
+  * water is assumed deep. Pair with `swell` (the waves that shoal) and
+  * `shoreWaves` (the foam fronts the spray rides).
+  */
+  bed: string;
+  /**
+  * Wind speed in m/s — THE realistic-sea dial (fancy only; 0 = off). Above 0
+  * the surface stops being a noise field and becomes a JONSWAP spectrum:
+  * thousands of waves at every wavelength and heading, each moving at the
+  * speed deep water gives it, inverse-FFT'd on the GPU every frame into a
+  * tiling patch with real crest shapes, choppy horizontal drag and whitecaps
+  * born where the surface folds. The wind blows toward `swellDirectionDeg`.
+  * 4 = a light breeze (ripples, 20 cm), 7 = a fresh breeze (1 m waves),
+  * 12 = rough. The CPU twin (buoyancy, waders) sums the same spectrum.
+  */
+  wind: number;
+  /** Horizontal drag of the FFT sea toward its crests, 0..~1.5 — narrow
+  * crests, broad troughs; past ~1.2 the surface folds and foams everywhere. */
+  choppiness: number;
+  /**
   * GERSTNER pinch on the swell: 0 keeps the legacy height-only trains, 1 is
   * maximum trochoid (crests narrow to a peak, troughs go broad). It also
   * decides where whitecaps break — the surface's Jacobian collapses on a
@@ -4265,6 +4345,26 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   /** Per-frame scene pre-pass: depth (absorption/foam) + color grab (refraction). */
   private scenePassTarget;
   private mirrorTarget;
+  /** Half-res render of the scene ABOVE the waterline — what SSR reflects. */
+  private aboveTarget;
+  private readonly ssrViewProj;
+  /** The FFT sea (wind > 0): the GPU passes, and the CPU spectrum they share. */
+  private seaFft;
+  private seaFftUnsupported;
+  private spectrum;
+  private spectrumKey;
+  private uploadedSpectrumKey;
+  private rippleFft;
+  private rippleSpectrum;
+  private rippleKey;
+  private uploadedRippleKey;
+  /** The bed depth grid (see `bed`), its footprint, and the spray that rides it. */
+  private bedTexture;
+  private bedRect;
+  private bedKey;
+  private spray;
+  /** Vertex spacing of the fancy grid — the mip the vertex shader reads at. */
+  private fancySegments;
   private readonly mirrorCamera;
   private readonly mirrorMatrix;
   private lastMirrorAt;
@@ -4379,6 +4479,11 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   private renderCutoutMasks;
   private syncFancy;
   /**
+  * The bed depth grid and the spray that rides it. Built once per `bed`
+  * (terrain heights are static); torn down when the path is cleared.
+  */
+  private syncBed;
+  /**
   * @internal Environment-sky sun hand-off (see {@link SunConsumer3D}): the
   * sky's sun drives the glint ONLY while the `sunDirection` prop sits at its
   * schema default — an explicitly authored prop always wins. Runs right
@@ -4423,6 +4528,19 @@ declare class Water3D extends Node3D implements RenderHook3D, SunConsumer3D {
   _waterYAt(x: number, z: number): number | null;
   /** Base wave height at world (x, z) — the CPU twin of the active shader.
   * Ripples are excluded on purpose: a splash must not re-trigger itself. */
+  /**
+  * The sea's spectrum, or null when there is no wind (or the tier collapsed
+  * the surface to the simple shader, whose CPU waves are its own). Built on
+  * the CPU once per (wind, heading, choppiness) and shared by the GPU upload
+  * and the headless twin — one sea, two evaluators.
+  */
+  private seaSpectrum;
+  /**
+  * The ripple layer's spectrum: the sea's own wind when it blows, else the
+  * breeze that puts wind ripple on a pool — its ENERGY is irrelevant (the
+  * layer is normalized to `detailStrength` by rms slope), only its shape.
+  */
+  private rippleSpectrumFor;
   private waveOffsetAt;
 }
 //#endregion

package/dist/3d.js

@@ -2,11 +2,11 @@ import { D as sunDirectionFromElevationAzimuth, E as parseEnvironment3D, O as su
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
 import { t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
 import { a as frameSignature, n as diffSignatures, o as frameStats, r as diffText, s as frameText, t as SIGNATURE_GRID } from "./frame-report-D-_7YF2G.js";
-import { $ as Water3D, at as PhysicsBody3D, ct as Node3D, dt as WATER_MAX_RIPPLES, et as WATER_CUTOUT_MAX, it as CharacterBody3D, ot as RigidBody3D, rt as Area3D, st as StaticBody3D, tt as WaterCutout3D } from "./gameplay-D-JuGura.js";
-import { A as CharacterController3D, B as InstancedMesh3D, C as SpotLight3D, D as resolveFlowerDensity, E as Flowers3D, F as Terrain3D, G as keyboardIntensity, I as DEFAULT_TERRAIN_TEXTURE_BASE, J as TextureCache3D, K as movementState, L as TERRAIN_THEMES, M as BoneLookAt3D, N as BoneAttachment3D, O as FLOWER_VARIETIES, P as Billboard3D, R as terrainThemeLayers, S as OmniLight3D, T as DENSITY_PRESETS, U as QUARTER_PITCH, V as MeshInstance3D, W as cameraRelative, X as acquireTexture, Y as acquireOwnTexture, _ as Ragdoll3D, a as VoxelGrid3D, b as LoftMesh3D, c as Trail3D, d as findRiverCoverageGaps, f as projectToRiver, g as traceDownhillPath, h as smoothCourse, i as VOXEL_PALETTE, j as Camera3D, k as Flock3D, l as River3D, m as riverStepFor, n as registerNodes3D, o as Vehicle3D, p as riverCarveChannels, q as rigPose, r as Weather3D, s as Tree3D, u as buildRiverRings, v as Particles3D, w as Foliage3D, x as DirectionalLight3D, y as ModelInstance3D, z as Joint3D } from "./environment-presets-BP77Dl0K.js";
-import { a as Environment3D, c as AssetStore3D, i as syncTree, o as applyQualityTier3D, r as Renderer3D, s as setEnvironment3D, t as createGame3D } from "./create-game-DVUhHs2B.js";
+import { $ as Water3D, at as PhysicsBody3D, ct as Node3D, dt as WATER_MAX_RIPPLES, et as WATER_CUTOUT_MAX, it as CharacterBody3D, ot as RigidBody3D, rt as Area3D, st as StaticBody3D, tt as WaterCutout3D } from "./gameplay-Bfff_beb.js";
+import { A as CharacterController3D, B as InstancedMesh3D, C as SpotLight3D, D as resolveFlowerDensity, E as Flowers3D, F as Terrain3D, G as keyboardIntensity, I as DEFAULT_TERRAIN_TEXTURE_BASE, J as TextureCache3D, K as movementState, L as TERRAIN_THEMES, M as BoneLookAt3D, N as BoneAttachment3D, O as FLOWER_VARIETIES, P as Billboard3D, R as terrainThemeLayers, S as OmniLight3D, T as DENSITY_PRESETS, U as QUARTER_PITCH, V as MeshInstance3D, W as cameraRelative, X as acquireTexture, Y as acquireOwnTexture, _ as Ragdoll3D, a as VoxelGrid3D, b as LoftMesh3D, c as Trail3D, d as findRiverCoverageGaps, f as projectToRiver, g as traceDownhillPath, h as smoothCourse, i as VOXEL_PALETTE, j as Camera3D, k as Flock3D, l as River3D, m as riverStepFor, n as registerNodes3D, o as Vehicle3D, p as riverCarveChannels, q as rigPose, r as Weather3D, s as Tree3D, u as buildRiverRings, v as Particles3D, w as Foliage3D, x as DirectionalLight3D, y as ModelInstance3D, z as Joint3D } from "./environment-presets-e_9YCnGu.js";
+import { a as Environment3D, c as AssetStore3D, i as syncTree, o as applyQualityTier3D, r as Renderer3D, s as setEnvironment3D, t as createGame3D } from "./create-game-Dai5vfVu.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-BYgD5Edk.js";
-import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-Bz2VPQ6D.js";
+import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-C5MOujfQ.js";
 //#region src/3d/model-verdict.ts
 /** Mixamo exports every bone as `mixamorigX`; the retargeter binds by that name. */
 const MIXAMO = /^mixamorig[:_]?/i;

package/dist/{create-game-DnwhJ5nW.js → create-game-BMIPKrQW.js}

@@ -4,12 +4,12 @@ import { T as qualityRendering, b as Engine, y as AudioPlayer } from "./register
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-CioTZB-y.js";
 import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, t as nodeFromHits, u as claimCanvasGestures } from "./picking-Buita5T9.js";
+import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, t as nodeFromHits, u as claimCanvasGestures } from "./picking-DIwE48sU.js";
 import { o as frameStats } from "./frame-report-D-_7YF2G.js";
-import { _ as Node2D, m as PhysicsBody2D, n as registerGameplayBehaviors } from "./gameplay-D-JuGura.js";
+import { _ as Node2D, m as PhysicsBody2D, n as registerGameplayBehaviors } from "./gameplay-Bfff_beb.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { n as UILayer, t as registerNodes2D, u as Camera2D } from "./register-DxAbTO2T.js";
-import { n as enablePhysics2D } from "./physics-2d-x3bCrQf0.js";
+import { n as UILayer, t as registerNodes2D, u as Camera2D } from "./register-7E3P1gz6.js";
+import { n as enablePhysics2D } from "./physics-2d-Tuf5LAyq.js";
 import { Box3, BufferAttribute, BufferGeometry, Color, LineBasicMaterial, LineSegments, LinearFilter, NearestFilter, OrthographicCamera, Raycaster, SRGBColorSpace, Scene, TextureLoader, Vector2, Vector3, WebGLRenderer } from "three";
 //#region src/2d/assets.ts
 /**
@@ -1034,7 +1034,7 @@ async function createGame2D(opts) {
 					await open({
 						scene: sourceJson,
 						play: reboot,
-						exit: () => reboot(sourceJson),
+						exit: (working) => reboot(working ?? sourceJson),
 						...editorSwitch.save ? { save: editorSwitch.save } : {},
 						...editorSwitch.library ? { library: editorSwitch.library === true ? devServerLibrary() : editorSwitch.library } : {}
 					});

package/dist/{create-game-DVUhHs2B.js → create-game-Dai5vfVu.js}

@@ -4,12 +4,12 @@ import { C as qualityCaps, T as qualityRendering, b as Engine, w as qualityEnvir
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as attachTouchControls } from "./touch-CioTZB-y.js";
 import { n as withWebGLContext, r as resolveRendering } from "./webgl-unavailable-C8aDbGmR.js";
-import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, s as poseFromRenderer, t as nodeFromHits, u as claimCanvasGestures } from "./picking-Buita5T9.js";
+import { a as devServerLibrary, c as applyDriveStep, d as audioErrors, i as crossFade, l as wireDevChannel, n as teardown, o as openBundledEditor, r as pauseWhenHidden, s as poseFromRenderer, t as nodeFromHits, u as claimCanvasGestures } from "./picking-DIwE48sU.js";
 import { o as frameStats } from "./frame-report-D-_7YF2G.js";
-import { at as PhysicsBody3D, ct as Node3D, n as registerGameplayBehaviors, ut as createCausticsQuad } from "./gameplay-D-JuGura.js";
+import { at as PhysicsBody3D, ct as Node3D, n as registerGameplayBehaviors, ut as createCausticsQuad } from "./gameplay-Bfff_beb.js";
 import { t as debugSources } from "./debug-draw-BM3DsvtT.js";
-import { J as TextureCache3D, j as Camera3D, n as registerNodes3D, t as resolveEnvironmentHdri, x as DirectionalLight3D, y as ModelInstance3D } from "./environment-presets-BP77Dl0K.js";
-import { n as enablePhysics3D } from "./physics-3d-Bz2VPQ6D.js";
+import { J as TextureCache3D, j as Camera3D, n as registerNodes3D, t as resolveEnvironmentHdri, x as DirectionalLight3D, y as ModelInstance3D } from "./environment-presets-e_9YCnGu.js";
+import { n as enablePhysics3D } from "./physics-3d-C5MOujfQ.js";
 import { ACESFilmicToneMapping, AmbientLight, Box3, BufferAttribute, BufferGeometry, Color, DepthTexture, EquirectangularReflectionMapping, FloatType, Fog, HalfFloatType, LineBasicMaterial, LineSegments, LoadingManager, Matrix4, Mesh, PCFShadowMap, PMREMGenerator, PerspectiveCamera, PlaneGeometry, Quaternion, Raycaster, Scene, ShaderMaterial, Vector2, Vector3, WebGLRenderTarget, WebGLRenderer } from "three";
 import { VRMLoaderPlugin, VRMUtils } from "@pixiv/three-vrm";
 import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
@@ -2405,7 +2405,7 @@ async function createGame3D(opts) {
 						scene: sourceJson,
 						...camera ? { camera } : {},
 						play: reboot,
-						exit: () => reboot(sourceJson),
+						exit: (working) => reboot(working ?? sourceJson),
 						...editorSwitch.save ? { save: editorSwitch.save } : {},
 						...editorSwitch.library ? { library: editorSwitch.library === true ? devServerLibrary() : editorSwitch.library } : {}
 					});

package/dist/{editor-switch-O8mxpgRX.d.ts → editor-switch-Bzt0GzVp.d.ts}

@@ -14,8 +14,18 @@ interface EditorOpenOptions {
   camera?: CameraPose;
   /** Called when the editor hands the page back — boot the game from `working`. */
   play(working: JsonObject, camera?: CameraPose): void | Promise<void>;
-  /** Called when the user leaves the editor without playing. */
-  exit?(): void | Promise<void>;
+  /**
+  * Called when the user leaves the editor by the ✕ — with the scene as the
+  * editor has it.
+  *
+  * It carries the working scene for the same reason ▶ does: you have been
+  * editing it, and half the time you have SAVED it. Handing back the scene the
+  * page booted with instead would show you your own edit disappearing, which
+  * is what it did until saving stopped reloading the page and made the
+  * difference visible. `undefined` (an editor that does not offer one) leaves
+  * the caller to fall back to whatever it opened with.
+  */
+  exit?(working?: JsonObject): void | Promise<void>;
   /** Persist edits (from `editor.save`). Omitted: no save button. */
   save?(working: JsonObject): void | Promise<void>;
   /** Asset-library search (from `editor.library`). Omitted: no 📚 buttons. */