incanto 0.23.0 → 0.24.0

package/dist/3d.d.ts

@@ -377,6 +377,9 @@ interface CreateGame3DOptions {
   seed?: number;
   fixedHz?: number;
   pixelRatio?: number;
+  /** Keep the frame rate by rendering fewer pixels while frames run slow
+  * (default ON). `false` pins the resolution — screenshots, capture, tests. */
+  adaptiveResolution?: boolean;
   resolveScene?: LoadSceneOptions["resolveScene"];
   /** @internal Test seam — replaces the Renderer3D construction. */
   _rendererFactory?: (engine: Engine, canvas: HTMLCanvasElement) => GameRenderer;
@@ -2466,6 +2469,14 @@ interface Renderer3DOptions {
   assets?: AssetStore3D;
   /** Defaults to `window.devicePixelRatio` capped at 2. */
   pixelRatio?: number;
+  /**
+  * Keep the frame rate by rendering at fewer pixels when frames run slow, and
+  * hand them back when they recover (default ON). A retina display asks for
+  * 4× the pixels; shaded water is fragment-heavy; the honest answer is fewer
+  * pixels of the same world, only while it is actually needed. `false` pins
+  * the resolution — for screenshots, video capture and pixel-diff tests.
+  */
+  adaptiveResolution?: boolean;
 }
 /**
 * WebGL presentation layer: subscribes to `engine.updated`, mirrors the active
@@ -2533,10 +2544,22 @@ declare class Renderer3D {
   private bloomCompositeScene;
   private bloomCompositeUniforms;
   constructor(opts: Renderer3DOptions);
+  /** The pixel ratio the scene ASKED for — the governor scales this, never replaces it. */
+  private readonly basePixelRatio;
+  private readonly adaptive;
+  private lastFrameAt;
   private readonly debugLines;
   private readonly selectionLines;
   private syncSelectionOutline;
   private syncDebugLines;
+  /**
+  * Frame-rate governor: measure the frame, and when the median of a window is
+  * slow, render the same world at fewer pixels (and hand them back when it
+  * recovers). Resizing the drawing buffer is all it takes — every render
+  * target in the pipeline is keyed off `getDrawingBufferSize`, so the water
+  * grab, the mirror and the bloom chain follow automatically.
+  */
+  private governResolution;
   private render;
   /**
   * Bloom post pass (only when `environment.bloom` is declared). LDR and safe:

package/dist/3d.js

@@ -1,6 +1,6 @@
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { A as Water3D, F as StaticBody3D, I as Node3D, M as CharacterBody3D, N as PhysicsBody3D, P as RigidBody3D, j as Area3D, z as WATER_MAX_RIPPLES } from "./gameplay-BJ5gXIks.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-OyjhYUL3.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-DjWIgtQ_.js";
 import { A as QUARTER_PITCH, C as BoneAttachment3D, D as TERRAIN_THEMES, E as DEFAULT_TERRAIN_TEXTURE_BASE, M as keyboardIntensity, N as movementState, O as terrainThemeLayers, P as rigPose, S as BoneLookAt3D, T as Terrain3D, _ as Flowers3D, a as Trail3D, b as CharacterController3D, c as Particles3D, d as DirectionalLight3D, f as OmniLight3D, g as DENSITY_PRESETS, h as Foliage3D, i as Tree3D, j as cameraRelative, k as Joint3D, l as ModelInstance3D, m as MeshInstance3D, n as VOXEL_PALETTE, o as River3D, p as InstancedMesh3D, r as VoxelGrid3D, s as traceDownhillPath, t as registerNodes3D, u as LoftMesh3D, v as resolveFlowerDensity, w as Billboard3D, x as Camera3D, y as FLOWER_VARIETIES } from "./register-CpJORtm4.js";
 import { n as splatWeights, t as buildHeightmap } from "./heightmap-CRK0M4jT.js";
 import { n as enablePhysics3D, t as Physics3D } from "./physics-3d-CpIB9C-F.js";

package/dist/{create-game-OyjhYUL3.js → create-game-DjWIgtQ_.js}

@@ -126,6 +126,50 @@ var AssetStore3D = class {
 	}
 };
 //#endregion
+//#region src/3d/adaptive-resolution.ts
+const DEFAULTS = {
+	slowMs: 20,
+	fastMs: 13,
+	minScale: .6,
+	step: .15,
+	window: 45
+};
+var AdaptiveResolution = class {
+	opts;
+	samples = [];
+	scale = 1;
+	constructor(options = {}) {
+		this.opts = {
+			...DEFAULTS,
+			...options
+		};
+	}
+	/** The fraction of the requested pixel ratio to render at right now. */
+	current() {
+		return this.scale;
+	}
+	/**
+	* Feed one frame's duration. Returns the new scale when it CHANGED (the
+	* caller then resizes), else null — so a steady frame rate costs nothing.
+	*/
+	push(frameMs) {
+		if (!(frameMs > 0) || !Number.isFinite(frameMs)) return null;
+		this.samples.push(frameMs);
+		if (this.samples.length < this.opts.window) return null;
+		const sorted = [...this.samples].sort((a, b) => a - b);
+		const median = sorted[Math.floor(sorted.length / 2)];
+		this.samples = [];
+		const before = this.scale;
+		if (median > this.opts.slowMs) this.scale = Math.max(this.opts.minScale, this.scale - this.opts.step);
+		else if (median < this.opts.fastMs && this.scale < 1) this.scale = Math.min(1, this.scale + this.opts.step);
+		return this.scale === before ? null : this.scale;
+	}
+	/** Forget the window (a paused or backgrounded game is not "slow"). */
+	reset() {
+		this.samples = [];
+	}
+};
+//#endregion
 //#region src/3d/bloom/bloom-composite.ts
 /**
 * HDR bloom post pass:
@@ -1421,7 +1465,9 @@ var Renderer3D = class {
 			canvas: opts.canvas,
 			antialias: rendering.antialias
 		});
+		this.basePixelRatio = rendering.pixelRatio;
 		this.webgl.setPixelRatio(rendering.pixelRatio);
+		this.adaptive = opts.adaptiveResolution === false ? null : new AdaptiveResolution();
 		this.webgl.shadowMap.enabled = true;
 		this.webgl.shadowMap.type = PCFShadowMap;
 		this.webgl.toneMapping = ACESFilmicToneMapping;
@@ -1445,6 +1491,10 @@ var Renderer3D = class {
 		this.threeScene.add(this.selectionLines);
 		this.disconnect = this.engine.updated.connect(() => this.render());
 	}
+	/** The pixel ratio the scene ASKED for — the governor scales this, never replaces it. */
+	basePixelRatio;
+	adaptive;
+	lastFrameAt = 0;
 	debugLines;
 	selectionLines;
 	syncSelectionOutline() {
@@ -1468,9 +1518,35 @@ var Renderer3D = class {
 		this.debugLines.visible = vertices !== null;
 		if (vertices) this.debugLines.geometry.setAttribute("position", new BufferAttribute(vertices, 3));
 	}
+	/**
+	* Frame-rate governor: measure the frame, and when the median of a window is
+	* slow, render the same world at fewer pixels (and hand them back when it
+	* recovers). Resizing the drawing buffer is all it takes — every render
+	* target in the pipeline is keyed off `getDrawingBufferSize`, so the water
+	* grab, the mirror and the bloom chain follow automatically.
+	*/
+	governResolution() {
+		const gov = this.adaptive;
+		if (!gov) return;
+		const now = globalThis.performance?.now?.() ?? 0;
+		const prev = this.lastFrameAt;
+		this.lastFrameAt = now;
+		if (prev === 0) return;
+		const frameMs = now - prev;
+		if (frameMs > 500) {
+			gov.reset();
+			return;
+		}
+		const scale = gov.push(frameMs);
+		if (scale === null) return;
+		this.webgl.setPixelRatio(this.basePixelRatio * scale);
+		const size = this.lastSize;
+		if (size.w > 0 && size.h > 0) this.webgl.setSize(size.w, size.h, false);
+	}
 	render() {
 		const scene = this.engine.scene;
 		if (!scene) return;
+		this.governResolution();
 		this.syncDebugLines();
 		this.syncSelectionOutline();
 		if (scene.assets && !this.loadedAssetScenes.has(scene)) {
@@ -1937,7 +2013,8 @@ async function createGame3D(opts) {
 	const renderer = opts._rendererFactory ? opts._rendererFactory(engine, opts.canvas) : new Renderer3D({
 		canvas: opts.canvas,
 		engine,
-		...opts.pixelRatio !== void 0 ? { pixelRatio: opts.pixelRatio } : {}
+		...opts.pixelRatio !== void 0 ? { pixelRatio: opts.pixelRatio } : {},
+		...opts.adaptiveResolution !== void 0 ? { adaptiveResolution: opts.adaptiveResolution } : {}
 	});
 	if (opts.debug ?? false) {
 		const host = opts.touchContainer ?? opts.canvas.parentElement ?? (typeof document !== "undefined" ? document.body : null);

package/dist/index.js

@@ -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.23.0";
+const VERSION = "0.24.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-OyjhYUL3.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DrcEgRup.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DjWIgtQ_.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DrcEgRup.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/editor/assets/{agent8-C_pbgaQC.js → agent8-DlMVayXX.js}

@@ -1 +1 @@
-import{t as e}from"./index-D-bWhSDj.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};
+import{t as e}from"./index-B5y_MdYb.js";async function t(t){return new n((await e(()=>import(`./GameServer-C56iOUgF.js`),[],import.meta.url)).GameServer,t)}var n=class{raw;active=new Map;reconnecting=!1;disposed=!1;constructor(e,t){this.raw=new e({...t})}get account(){return this.raw.account}get connected(){return this.raw.connected}connect(){return this.raw.connected?Promise.resolve(!0):(this.disposed=!1,this.rawConnect())}rawConnect(){return this.raw.connect({onDisconnect:()=>void this.reconnect()})}disconnect(){this.disposed=!0;for(let e of this.active.values())e.off();return this.active.clear(),this.raw.disconnect()}remoteFunction(e,t,n){return this.raw.remoteFunction(e,t,n)}track(e){let t=Symbol(`sub`),n={make:e,off:e()};return this.active.set(t,n),()=>{n.off(),this.active.delete(t)}}async reconnect(){if(!this.disposed&&!this.reconnecting){this.reconnecting=!0;try{await this.rawConnect();for(let e of this.active.values())e.off(),e.off=e.make()}finally{this.reconnecting=!1}}}subscribeRoomState(e,t){return this.track(()=>this.raw.subscribeRoomState(e,t))}subscribeRoomMyState(e,t){return this.track(()=>this.raw.subscribeRoomMyState(e,t))}subscribeRoomAllUserStates(e,t){return this.track(()=>this.raw.subscribeRoomAllUserStates(e,e=>{let n={};for(let t of e??[]){if(!t||typeof t.account!=`string`||t.__leaved)continue;let{account:e,__updated:r,__leaved:i,...a}=t;n[e]=a}t(n)}))}subscribeRoomCollection(e,t,n){return this.track(()=>this.raw.subscribeRoomCollection(e,t,({items:e})=>{let t={};for(let n of e??[])n&&typeof n.__id==`string`&&(t[n.__id]=n);n(t)}))}onRoomMessage(e,t,n){return this.track(()=>this.raw.onRoomMessage(e,t,n))}onRoomUserJoin(e,t){return this.track(()=>this.raw.onRoomUserJoin(e,t))}onRoomUserLeave(e,t){return this.track(()=>this.raw.onRoomUserLeave(e,t))}subscribeGlobalState(e){return this.track(()=>this.raw.subscribeGlobalState(e))}subscribeGlobalMyState(e){return this.track(()=>this.raw.subscribeGlobalMyState(e))}subscribeGlobalUserState(e,t){return this.track(()=>this.raw.subscribeGlobalUserState(e,t))}subscribeGlobalCollection(e,t){return this.track(()=>this.raw.subscribeGlobalCollection(e,({items:e})=>{let n={};for(let t of e??[])t&&typeof t.__id==`string`&&(n[t.__id]=t);t(n)}))}subscribeAsset(e,t){return this.track(()=>this.raw.subscribeAsset(e,t))}onGlobalMessage(e,t){return this.track(()=>this.raw.onGlobalMessage(e,t))}};export{t as createAgent8Server};