incanto 0.37.0 → 0.38.0

package/dist/debug.d.ts

@@ -1,4 +1,4 @@
-import { T as RendererStats, b as Engine, kt as LogLevel } from "./behavior-5o1EkbLD.js";
+import { T as RendererStats, b as Engine, kt as LogLevel } from "./behavior-B5PJ32eu.js";
 
 //#region src/debug/panel.d.ts
 /** Minimal document surface the overlay needs (injectable for tests). */

package/dist/editor.js

@@ -1121,6 +1121,27 @@ var ht = {
 				en: "Options are the locales the scene declares in \"strings\", each labeled with its own endonym. Picking one switches the game live and persists it. English is the base: any key a locale omits falls back to it, on purpose.",
 				ko: "옵션은 씬의 \"strings\"가 선언한 로케일이며, 각 언어의 자기 이름으로 표시됩니다. 선택하면 즉시 바뀌고 저장됩니다. 영어가 기준이라 로케일이 빠뜨린 키는 의도적으로 영어로 표시됩니다."
 			}),
+			R("UiQualitySelect", {
+				en: "Graphics quality — Low, Medium, High. Already wired.",
+				ko: "그래픽 품질 — Low, Medium, High. 이미 연결되어 있습니다."
+			}, {
+				en: "Low turns off shadows, bloom, post and clouds; Medium keeps shadows but makes them static and drops post; High is everything. Applies live and persists. Antialiasing follows the tier on the NEXT launch — it is a WebGL context attribute and cannot change while a context exists. Picking records a human choice, so device detection never overrides it later.",
+				ko: "Low는 그림자·블룸·포스트·구름을 끄고, Medium은 그림자를 정적으로 유지하며 포스트를 끄고, High는 전부 켭니다. 즉시 적용되고 저장됩니다. 안티에일리어싱만 다음 실행부터 반영됩니다(WebGL 컨텍스트 속성이라 생성 후에는 못 바꿉니다). 사람이 고른 값으로 기록되어 이후 자동 감지가 덮어쓰지 않습니다."
+			}),
+			R("UiFrameCapSelect", {
+				en: "Frame rate cap — 30, 60, 120 or Unlimited.",
+				ko: "프레임 제한 — 30, 60, 120 또는 무제한."
+			}, {
+				en: "Gates the whole frame, not just the render, so it saves CPU as well as GPU — a cooler phone and a longer battery. Unlimited (0) is the default. Restrict the list with options, e.g. \"60,120,0\".",
+				ko: "렌더뿐 아니라 프레임 전체를 제한하므로 GPU와 CPU를 함께 아낍니다 — 발열과 배터리에 유리합니다. 기본값은 무제한(0). options로 목록을 줄일 수 있습니다(예: \"60,120,0\")."
+			}),
+			R("UiRenderScaleSelect", {
+				en: "Resolution scale — 50%, 75%, 100%.",
+				ko: "해상도 배율 — 50%, 75%, 100%."
+			}, {
+				en: "The cheapest frames on a weak GPU: at 75% the fragment shaders run over 56% of the pixels for a slightly softer image and nothing else, where dropping a quality tier costs the shadows outright. Multiplies with the engine's automatic resolution governor rather than fighting it.",
+				ko: "저사양 GPU에서 가장 값싼 프레임: 75%면 픽셀의 약 56%만 셰이딩하므로 이미지가 약간 부드러워질 뿐이지만, 품질 단계를 낮추면 그림자가 통째로 사라집니다. 엔진의 자동 해상도 조절과 충돌하지 않고 곱해집니다."
+			}),
 			R("UiSelect", {
 				en: "One of several — quality, resolution, language.",
 				ko: "여러 개 중 하나 — 품질, 해상도, 언어."

package/dist/{environment-presets-DWHxLHM5.js → environment-presets-C0Axpfth.js}

@@ -1,4 +1,4 @@
-import { t as registerCoreNodes } from "./register-DOWGnxe1.js";
+import { t as registerCoreNodes } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-IyWCGe4q.js";

package/dist/gameplay.d.ts

@@ -1,4 +1,4 @@
-import { Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-5o1EkbLD.js";
+import { Tt as Node, b as Engine, d as PropSchema, n as BehaviorCtor, t as Behavior } from "./behavior-B5PJ32eu.js";
 import { c as JsonValue, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/gameplay/chase.d.ts

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { $ as translationKey, A as qualityEnvironment, At as LogManager, B as restoreBehaviors, C as EngineStats, Ct as AudioBuses, D as QualityTier, Dt as SceneTree, E as DeviceHints, Et as NodeLifecycle, F as RestoreReport, G as OrderGroupTable, H as createSaveStore, I as SaveSlot, J as BASE_LOCALE, K as effectiveOrder, L as SaveSlots, M as suggestQuality, Mt as SignalListener, N as Scene, O as Settings, Ot as LogEntry, P as BehaviorState, Q as suggestLocale, R as behaviorsWithoutSave, S as Scheduler, St as PlayMusicOptions, T as RendererStats, Tt as Node, U as ORDER_GROUP_BASE, V as SaveStore, W as OrderGroup, X as Localization, Y as LocaleTables, Z as T_PREFIX, _ as mergeStaticSignals, _t as SynthOptions, a as clearBehaviors, at as VoicePreset, b as Engine, bt as MusicManager, c as registeredBehaviors, ct as RolloffModel, d as PropSchema, dt as spatialGain, et as InputMap, f as clearRegistry, ft as spatialPan, g as getNodeType, gt as SfxWave, h as getNodeSignals, ht as SfxParams, i as behaviorSignals, it as Voice, j as readDeviceHints, jt as Signal, k as SettingsValues, kt as LogLevel, l as NodeCtor, lt as SpatialParams, m as getNodeSchema, mt as SFX_PRESET_NAMES, n as BehaviorCtor, nt as SfxPlayOptions, o as getBehavior, ot as Listener, p as createNode, pt as SFX_PRESETS, q as resolveOrderGroups, r as behaviorSchema, rt as isAudioContextAvailable, s as registerBehavior, st as ROLLOFF_MODELS, t as Behavior, tt as SfxEngine, u as PropDef, ut as Vec3, v as registerNode, vt as synthSfx, w as GameStats, wt as BusName, x as EngineOptions, xt as MusicTrack, y as registeredTypes, yt as MusicBackend, z as captureBehaviors } from "./behavior-5o1EkbLD.js";
+import { $ as translationKey, A as qualityEnvironment, At as LogManager, B as restoreBehaviors, C as EngineStats, Ct as AudioBuses, D as QualityTier, Dt as SceneTree, E as DeviceHints, Et as NodeLifecycle, F as RestoreReport, G as OrderGroupTable, H as createSaveStore, I as SaveSlot, J as BASE_LOCALE, K as effectiveOrder, L as SaveSlots, M as suggestQuality, Mt as SignalListener, N as Scene, O as Settings, Ot as LogEntry, P as BehaviorState, Q as suggestLocale, R as behaviorsWithoutSave, S as Scheduler, St as PlayMusicOptions, T as RendererStats, Tt as Node, U as ORDER_GROUP_BASE, V as SaveStore, W as OrderGroup, X as Localization, Y as LocaleTables, Z as T_PREFIX, _ as mergeStaticSignals, _t as SynthOptions, a as clearBehaviors, at as VoicePreset, b as Engine, bt as MusicManager, c as registeredBehaviors, ct as RolloffModel, d as PropSchema, dt as spatialGain, et as InputMap, f as clearRegistry, ft as spatialPan, g as getNodeType, gt as SfxWave, h as getNodeSignals, ht as SfxParams, i as behaviorSignals, it as Voice, j as readDeviceHints, jt as Signal, k as SettingsValues, kt as LogLevel, l as NodeCtor, lt as SpatialParams, m as getNodeSchema, mt as SFX_PRESET_NAMES, n as BehaviorCtor, nt as SfxPlayOptions, o as getBehavior, ot as Listener, p as createNode, pt as SFX_PRESETS, q as resolveOrderGroups, r as behaviorSchema, rt as isAudioContextAvailable, s as registerBehavior, st as ROLLOFF_MODELS, t as Behavior, tt as SfxEngine, u as PropDef, ut as Vec3, v as registerNode, vt as synthSfx, w as GameStats, wt as BusName, x as EngineOptions, xt as MusicTrack, y as registeredTypes, yt as MusicBackend, z as captureBehaviors } from "./behavior-B5PJ32eu.js";
 import { a as Rng, c as JsonValue, d as jsonKind, i as SceneJson, l as jsonClone, n as NodeJson, o as JsonKind, r as SCENE_FORMAT, s as JsonObject, t as ConnectionJson, u as jsonEquals } from "./schema-CFeioQRE.js";
-import { n as loadScene, t as LoadSceneOptions } from "./loader-iGq2PT_k.js";
+import { n as loadScene, t as LoadSceneOptions } from "./loader-DSMdqasu.js";
 import { n as ParticleSimConfig, r as ParticleView, t as ParticleSim } from "./particle-sim-BzJ1yxoE.js";
-import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-pPrqtlWS.js";
-import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-DGzhZWrM.js";
+import { a as AudioElementLike, i as gridFromRows, n as PathGrid, o as AudioPlayer, r as findPath, t as FindPathOptions } from "./pathfinding-BrE5Uec6.js";
+import { a as startRecording, c as IncantoErrorDetails, i as replay, l as auditScene, n as ReplayEvent, o as IncantoError, r as ReplayJson, s as IncantoErrorCode, t as Recorder } from "./replay-Cxrr-ApH.js";
 
 //#region src/core/audio/crossfade.d.ts
 /**

package/dist/index.js

@@ -1,8 +1,8 @@
 import { C as getBehavior, E as Signal, S as clearBehaviors, T as registeredBehaviors, _ as InputMap, a as SCENE_FORMAT, b as behaviorSchema, c as SceneTree, d as resolveConstants, f as Node, g as resolveOrderGroups, h as effectiveOrder, i as serializeNode, l as CONST_REF_KEY, m as ORDER_GROUP_BASE, n as loadScene, o as computeViewport, p as parseNodePath, r as Scene, s as resolveViewport, u as isConstRef, w as registerBehavior, x as behaviorSignals, y as Behavior } from "./loader-r49nDwB4.js";
-import { A as translationKey, B as WebAudioMusicBackend, C as restoreBehaviors, D as Localization, E as BASE_LOCALE, F as spatialPan, H as fadeGain, I as SFX_PRESETS, L as SFX_PRESET_NAMES, M as isAudioContextAvailable, N as ROLLOFF_MODELS, O as T_PREFIX, P as spatialGain, R as synthSfx, S as captureBehaviors, T as LogManager, U as AudioBuses, V as crossfadeGains, _ as qualityEnvironment, a as UiSlider, b as SaveSlots, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as SfxEngine, k as suggestLocale, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, v as readDeviceHints, w as createSaveStore, x as behaviorsWithoutSave, y as suggestQuality, z as MusicManager } from "./register-DOWGnxe1.js";
+import { A as suggestLocale, B as MusicManager, C as captureBehaviors, D as BASE_LOCALE, E as LogManager, F as spatialGain, H as crossfadeGains, I as spatialPan, L as SFX_PRESETS, M as SfxEngine, N as isAudioContextAvailable, O as Localization, P as ROLLOFF_MODELS, R as SFX_PRESET_NAMES, S as behaviorsWithoutSave, T as createSaveStore, U as fadeGain, V as WebAudioMusicBackend, W as AudioBuses, _ as qualityEnvironment, a as UiSlider, b as suggestQuality, c as UiButton, d as UiBanner, f as UiBar, g as Settings, h as Engine, i as UiSelect, j as translationKey, k as T_PREFIX, l as UiDialogue, m as AudioPlayer, n as UiImage, o as UiToggle, p as UiText, r as UiPanel, s as Timer, t as registerCoreNodes, u as HudLayer, w as restoreBehaviors, x as SaveSlots, y as readDeviceHints, z as synthSfx } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-BuOTl5rM.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DH0UOuZ-.js";
 import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { a as getNodeSignals, c as mergeStaticSignals, i as getNodeSchema, l as registerNode, n as clearRegistry, o as getNodeType, r as createNode, u as registeredTypes } from "./registry-IyWCGe4q.js";
 import { t as createNoise2D } from "./noise-CGUMx44x.js";
@@ -172,6 +172,6 @@ function newUid() {
 //#endregion
 //#region src/index.ts
 /** Engine version. Kept in sync with package.json by the release pipeline. */
-const VERSION = "0.37.0";
+const VERSION = "0.38.0";
 //#endregion
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiImage, UiPanel, UiSelect, UiSlider, UiText, UiToggle, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, 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, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveConstants, resolveOrderGroups, resolveRendering, resolveViewport, restoreBehaviors, serializeNode, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/{loader-iGq2PT_k.d.ts → loader-DSMdqasu.d.ts}

@@ -1,4 +1,4 @@
-import { N as Scene, b as Engine } from "./behavior-5o1EkbLD.js";
+import { N as Scene, b as Engine } from "./behavior-B5PJ32eu.js";
 import { i as SceneJson } from "./schema-CFeioQRE.js";
 
 //#region src/core/scene/loader.d.ts

package/dist/net.d.ts

@@ -1,4 +1,4 @@
-import { Tt as Node, b as Engine, d as PropSchema, jt as Signal } from "./behavior-5o1EkbLD.js";
+import { Tt as Node, b as Engine, d as PropSchema, jt as Signal } from "./behavior-B5PJ32eu.js";
 import { c as JsonValue, i as SceneJson, s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/net/types.d.ts

package/dist/net.js

@@ -1,9 +1,9 @@
 import { n as loadScene } from "./loader-r49nDwB4.js";
-import { h as Engine } from "./register-DOWGnxe1.js";
+import { h as Engine } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as jsonClone } from "./json-BLk7H2Qa.js";
 import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-t15rydSm.js";
+import { i as applySyncPatch, n as NetworkSpawner, r as NetworkManager, t as registerNodesNet } from "./register-B4RRQbyq.js";
 //#region src/net/loopback.ts
 /**
 * In-memory multiplayer hub implementing the SAME kernel contract as

package/dist/{pathfinding-pPrqtlWS.d.ts → pathfinding-BrE5Uec6.d.ts}

@@ -1,4 +1,4 @@
-import { Tt as Node, d as PropSchema, ot as Listener } from "./behavior-5o1EkbLD.js";
+import { Tt as Node, d as PropSchema, ot as Listener } from "./behavior-B5PJ32eu.js";
 
 //#region src/core/nodes/audio-player.d.ts
 /**

package/dist/{physics-2d-C8Hi40qb.js → physics-2d-OfKb0PV_.js}

@@ -1,7 +1,7 @@
 import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
 import { v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DFSW2Y30.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-DnB9m7Rl.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 //#region src/2d/physics/physics-2d.ts
 var physics_2d_exports = /* @__PURE__ */ __exportAll({

package/dist/{physics-3d-C0mWoWXC.js → physics-3d-C8242nXr.js}

@@ -3,7 +3,7 @@ import { v as diagnose } from "./loader-r49nDwB4.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { F as PhysicsBody3D, I as RigidBody3D, N as Area3D, P as CharacterBody3D, R as Node3D, z as validateCollider3D } from "./gameplay-CsJDUQh_.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
-import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-DWHxLHM5.js";
+import { A as Terrain3D, F as InstancedMesh3D, L as buildMeshGeometry, P as Joint3D } from "./environment-presets-C0Axpfth.js";
 import { Euler, Matrix4, Quaternion, Vector3 } from "three";
 //#region src/3d/physics/collider-lines.ts
 /**

package/dist/react.d.ts

@@ -1,4 +1,4 @@
-import { N as Scene, b as Engine, n as BehaviorCtor } from "./behavior-5o1EkbLD.js";
+import { N as Scene, b as Engine, n as BehaviorCtor } from "./behavior-B5PJ32eu.js";
 import { c as JsonValue } from "./schema-CFeioQRE.js";
 import { CSSProperties, ReactNode } from "react";
 

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-QqrrK3yr.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-DmGc-Mrn.js").then((n) => n.n)).createGame2D(o)))(opts);
+			const next = await (_gameFactory ?? (mode === "3d" ? async (o) => (await import("./create-game-DqY2lMBc.js").then((n) => n.n)).createGame3D(o) : async (o) => (await import("./create-game-C4t5gVhc.js").then((n) => n.n)).createGame2D(o)))(opts);
 			if (disposed) {
 				next.dispose();
 				return;

package/dist/{register-t15rydSm.js → register-B4RRQbyq.js}

@@ -1,5 +1,5 @@
 import { E as Signal, f as Node, t as buildNodeJson } from "./loader-r49nDwB4.js";
-import { t as registerCoreNodes } from "./register-DOWGnxe1.js";
+import { t as registerCoreNodes } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { n as jsonEquals, t as jsonClone } from "./json-BLk7H2Qa.js";
 import { l as registerNode } from "./registry-IyWCGe4q.js";

package/dist/{register-DOWGnxe1.js → register-Dm7nrd-E.js}

@@ -1403,7 +1403,10 @@ const DEFAULTS = {
 	sensitivity: 1,
 	invertY: false,
 	reduceMotion: false,
-	language: "en"
+	language: "en",
+	qualityChosen: false,
+	maxFps: 0,
+	renderScale: 1
 };
 const TIERS = [
 	"low",
@@ -1469,6 +1472,64 @@ var Settings = class {
 		for (const key of Object.keys(DEFAULTS)) this.set(key, DEFAULTS[key]);
 	}
 	/**
+	* Choose a starting tier from the device, ONCE.
+	*
+	* Only on a first visit: after someone has picked a tier, re-detecting on
+	* every launch would silently undo their choice — which is the behaviour every
+	* player experiences as "the settings do not save".
+	*/
+	autoQuality(hints = readDeviceHints()) {
+		if (!this.values.qualityChosen) this.values.quality = suggestQuality(hints);
+		return this.values.quality;
+	}
+	/** Record that the tier came from a person, not from the device probe. */
+	chooseQuality(tier) {
+		this.set("quality", tier);
+		this.set("qualityChosen", true);
+	}
+	/**
+	* Apply the saved quality tier to a live scene, and keep applying it.
+	*
+	* The same shape as `bindAudio` and `bindLocale`. Until 0.38 this did not
+	* exist: `settings.quality` was written to disk and read by NOBODY, and
+	* `qualityEnvironment` — the function that turns a tier into something the
+	* renderer understands — emitted patches the environment parser rejects, for
+	* all three tiers. Both were public, documented and never once called.
+	*/
+	bindQuality(apply) {
+		apply(qualityEnvironment(this.values.quality));
+		return this.changed.connect((key) => {
+			if (key === "quality") apply(qualityEnvironment(this.values.quality));
+		});
+	}
+	/**
+	* Apply the saved frame cap, and again whenever it changes.
+	*
+	* Separate from `bindQuality` because it is not a tier: a player caps the
+	* frame rate to keep a phone cool or a battery alive, on the highest visual
+	* settings the device can hold, and those two choices do not belong on one
+	* slider. 0 means uncapped. Returns the unsubscribe.
+	*/
+	bindFrameCap(apply) {
+		apply(this.values.maxFps);
+		return this.changed.connect((key) => {
+			if (key === "maxFps") apply(this.values.maxFps);
+		});
+	}
+	/**
+	* Apply the saved resolution multiplier, and again whenever it changes.
+	*
+	* The lever that buys the most frames per unit of ugliness on a weak GPU —
+	* shading 44% of the pixels at 0.66 costs a soft image and nothing else,
+	* while dropping a quality tier costs shadows entirely.
+	*/
+	bindRenderScale(apply) {
+		apply(this.values.renderScale);
+		return this.changed.connect((key) => {
+			if (key === "renderScale") apply(this.values.renderScale);
+		});
+	}
+	/**
 	* Apply the saved language, and keep it in step both ways.
 	*
 	* The same shape as `bindAudio`: a game that writes
@@ -1502,45 +1563,67 @@ var Settings = class {
 	}
 };
 /**
-* What a quality tier MEANS, as an environment patch.
+* What a quality tier MEANS, as a LIVE environment patch.
+*
+* Only the levers that actually cost: shadows, post, bloom and clouds.
+* Deliberately an `environment` patch, because `setEnvironment3D(engine, patch)`
+* already applies one live and validated — this is not a second rendering
+* pipeline, it is three presets for the one that exists.
 *
-* Only the levers that actually cost: shadows, post, clouds, and the resolution
-* the renderer draws at. Deliberately an `environment` patch, because
-* `setEnvironment3D(engine, patch)` already applies one live and validated —
-* this is not a second rendering pipeline, it is three presets for the one that
-* exists.
+* The `off` spelling matters and got this wrong for three releases: every tier
+* emitted `{ enabled: false }`, which the environment parser rejects
+* (`environment.bloom has unknown key 'enabled'`). Nothing called this function,
+* so nothing found out. In a live patch `null` DELETES a key — that is how a
+* stage is turned off — and `shadows` alone takes a real `false`.
+*
+* Antialiasing and pixel ratio are NOT here: `antialias` is a WebGL context
+* attribute and cannot change without rebuilding the renderer. See
+* `qualityRendering`.
 */
 function qualityEnvironment(tier) {
 	if (tier === "low") return {
-		shadows: { enabled: false },
-		bloom: { enabled: false },
-		post: { enabled: false },
-		clouds: { enabled: false },
-		rendering: {
-			antialias: false,
-			pixelRatio: 1
-		}
+		shadows: false,
+		bloom: null,
+		post: null,
+		clouds: null
 	};
 	if (tier === "medium") return {
-		shadows: {
-			enabled: true,
-			static: true
-		},
-		bloom: { enabled: true },
-		post: { enabled: false },
-		rendering: {
-			antialias: true,
-			pixelRatio: 1
-		}
+		shadows: { static: true },
+		bloom: {},
+		post: null
 	};
 	return {
-		shadows: { enabled: true },
-		bloom: { enabled: true },
-		post: { enabled: true },
-		rendering: {
-			antialias: true,
-			pixelRatio: "device"
-		}
+		shadows: true,
+		bloom: {},
+		post: {}
+	};
+}
+/**
+* What a quality tier means for the levers that can only be set at BOOT.
+*
+* `antialias` is a context attribute: three fixes it when the WebGL context is
+* created, so a settings menu that changes it is choosing what the NEXT launch
+* gets. Every engine has this constraint and every game's options screen says
+* "requires restart" next to it — `createGame3D` reads the saved tier at boot,
+* so the restart is all it takes.
+*
+* `pixelRatio` CAN change live (adaptive resolution already does it), but it
+* belongs with antialias as "how many pixels do we draw" rather than "what is in
+* the scene".
+*/
+function qualityRendering(tier) {
+	const device = Math.min(globalThis.devicePixelRatio ?? 1, 2);
+	if (tier === "low") return {
+		antialias: false,
+		pixelRatio: 1
+	};
+	if (tier === "medium") return {
+		antialias: true,
+		pixelRatio: Math.min(device, 1.5)
+	};
+	return {
+		antialias: true,
+		pixelRatio: device
 	};
 }
 //#endregion
@@ -1671,6 +1754,7 @@ var Engine = class {
 		this.maxFixedSteps = opts.maxFixedStepsPerTick ?? 5;
 		this.scheduler = opts.scheduler ?? rafScheduler;
 		this.rng = new Rng(opts.seed ?? Math.random() * 4294967295 >>> 0);
+		this.maxFps = opts.maxFps ?? 0;
 	}
 	get scene() {
 		return this._scene;
@@ -1693,6 +1777,7 @@ var Engine = class {
 	start() {
 		if (this.disposeScheduler) return;
 		this.disposeScheduler = this.scheduler((now) => {
+			if (!this.frameIsDue(now)) return;
 			try {
 				this.tick(now);
 			} catch (error) {
@@ -1701,6 +1786,51 @@ var Engine = class {
 		});
 	}
 	/**
+	* The frame cap: fps, or 0 for "as fast as the display goes" (the default).
+	*
+	* Live — a settings menu writes it mid-game. It gates the whole frame, not
+	* just the render: an uncapped loop on a 144 Hz phone burns battery running
+	* game logic nobody sees.
+	*
+	* `tick()` is deliberately NOT gated. A headless harness driving its own
+	* clock asked for that frame; the cap is about the real-time loop.
+	*/
+	maxFps = 0;
+	nextFrameAt = 0;
+	lastOfferedAt = null;
+	displayPeriodMs = 0;
+	/**
+	* Should this display frame run?
+	*
+	* The obvious `if (now - last < interval) return` is wrong in a way that only
+	* shows up between the round numbers: a 45 fps cap on a 60 Hz display misses
+	* every other deadline by a fraction of a millisecond, waits a whole display
+	* frame more, and delivers 30 — asking for 45 makes the game slower than not
+	* capping at all. The fix is to allow a frame that is within half a display
+	* period of its deadline, and to advance the deadline by the interval rather
+	* than from `now`, so the error does not accumulate.
+	*/
+	frameIsDue(now) {
+		const prev = this.lastOfferedAt;
+		this.lastOfferedAt = now;
+		if (prev !== null) {
+			const delta = now - prev;
+			if (delta > 0 && delta < 500) this.displayPeriodMs = this.displayPeriodMs === 0 ? delta : this.displayPeriodMs * .9 + delta * .1;
+		}
+		if (!(this.maxFps > 0)) {
+			this.nextFrameAt = 0;
+			return true;
+		}
+		const interval = 1e3 / this.maxFps;
+		if (this.nextFrameAt === 0) {
+			this.nextFrameAt = now + interval;
+			return true;
+		}
+		if (now < this.nextFrameAt - this.displayPeriodMs * .5) return false;
+		this.nextFrameAt = Math.max(now, this.nextFrameAt + interval);
+		return true;
+	}
+	/**
 	* A frame threw somewhere outside a single node (a renderer, physics, a
 	* signal handler). Report the first one and count the rest: a broken frame
 	* repeats sixty times a second, and sixty identical traces a second is how
@@ -3241,6 +3371,161 @@ var UiLanguageSelect = class extends UiSelect {
 		return ENDONYMS[value] ?? value;
 	}
 };
+/**
+* A select bound to one persisted setting — the shape all three graphics
+* controls share.
+*
+* The engine owns quality tiers, the frame cap and the resolution scale, and
+* every one of them was reachable only from TypeScript. A vibe-coded game whose
+* whole world is JSON could not put a graphics menu on screen without a
+* behavior, a signal connection, and the knowledge that `Settings` persists —
+* which is how "supports low-end devices" quietly becomes "does not".
+*
+* Subclasses say which setting, what the options are, and what they read as.
+*/
+var UiSettingSelect = class extends UiSelect {
+	/** Last value we PUSHED into the select, to tell an engine change from a player one. */
+	lastPushed = null;
+	_engine() {
+		return this.tree?.engine ?? null;
+	}
+	/**
+	* The translated option label, or the English one.
+	*
+	* `locale.t` returns the KEY when nothing declares it, and a menu reading
+	* `settings.quality.high` is worse than one reading `High`. English is the
+	* base language and the fallback, always.
+	*/
+	_tOr(key, fallback) {
+		const locale = this._engine()?.locale;
+		return locale?.has(key) ? locale.t(key) : fallback;
+	}
+	_sync() {
+		const engine = this._engine();
+		if (engine) {
+			const stored = this._read(engine);
+			if (stored !== this.lastPushed) {
+				this.lastPushed = stored;
+				this.value = stored;
+			} else if (this.value !== stored) {
+				this._write(engine, this.value);
+				this.lastPushed = this._read(engine);
+			}
+		}
+		super._sync();
+	}
+};
+/**
+* The graphics quality picker.
+*
+* ```json
+* { "name": "Quality", "type": "UiQualitySelect" }
+* ```
+*
+* Writes through `chooseQuality`, NOT `set('quality')`: a tier a person picked
+* has to survive the next launch's device detection, and the two are
+* indistinguishable afterwards unless the choice is recorded as one.
+*
+* Shadows, bloom, post and clouds follow immediately. Antialiasing follows on
+* the next launch — it is a WebGL context attribute and cannot change while a
+* context exists.
+*/
+var UiQualitySelect = class extends UiSettingSelect {
+	static typeName = "UiQualitySelect";
+	static props = {
+		...UiSelect.props,
+		label: { default: "Quality" },
+		options: { default: "low,medium,high" }
+	};
+	label = "Quality";
+	options = "low,medium,high";
+	_key() {
+		return "quality";
+	}
+	_read(engine) {
+		return String(engine.settings.get("quality"));
+	}
+	_write(engine, value) {
+		if (value === "low" || value === "medium" || value === "high") engine.settings.chooseQuality(value);
+	}
+	_optionLabel(value) {
+		const english = value.charAt(0).toUpperCase() + value.slice(1);
+		return this._tOr(`settings.quality.${value}`, english);
+	}
+};
+/**
+* The frame-rate cap: fewer frames, a cooler phone, a longer battery.
+*
+* ```json
+* { "name": "FrameCap", "type": "UiFrameCapSelect" }
+* ```
+*
+* `0` is uncapped and is the default — a cap nobody asked for is a downgrade.
+* The cap gates the whole frame, so it saves the CPU as well as the GPU.
+*/
+var UiFrameCapSelect = class extends UiSettingSelect {
+	static typeName = "UiFrameCapSelect";
+	static props = {
+		...UiSelect.props,
+		label: { default: "Frame rate" },
+		/** `0` means uncapped and reads as a word, not as a number. */
+		options: { default: "30,60,120,0" }
+	};
+	label = "Frame rate";
+	options = "30,60,120,0";
+	_key() {
+		return "maxFps";
+	}
+	_read(engine) {
+		return String(engine.settings.get("maxFps"));
+	}
+	_write(engine, value) {
+		const fps = Number(value);
+		if (!Number.isFinite(fps) || fps < 0) return;
+		engine.settings.set("maxFps", fps);
+		engine.maxFps = fps;
+	}
+	_optionLabel(value) {
+		if (value === "0") return this._tOr("settings.frameCap.unlimited", "Unlimited");
+		return value;
+	}
+};
+/**
+* The resolution scale — the cheapest frames on a weak GPU.
+*
+* ```json
+* { "name": "Resolution", "type": "UiRenderScaleSelect" }
+* ```
+*
+* At 75% the fragment shaders run over 56% of the pixels for a slightly softer
+* image and nothing else, where dropping a quality tier costs the shadows
+* outright. Reads as a percentage, because `0.75` means nothing to a player.
+*/
+var UiRenderScaleSelect = class extends UiSettingSelect {
+	static typeName = "UiRenderScaleSelect";
+	static props = {
+		...UiSelect.props,
+		label: { default: "Resolution" },
+		options: { default: "0.5,0.75,1" }
+	};
+	label = "Resolution";
+	options = "0.5,0.75,1";
+	_key() {
+		return "renderScale";
+	}
+	_read(engine) {
+		return String(engine.settings.get("renderScale"));
+	}
+	_write(engine, value) {
+		const scale = Number(value);
+		if (!Number.isFinite(scale) || scale <= 0) return;
+		engine.settings.set("renderScale", scale);
+	}
+	_optionLabel(value) {
+		const pct = Math.round(Number(value) * 100);
+		return Number.isFinite(pct) ? `${pct}%` : value;
+	}
+};
 //#endregion
 //#region src/core/register.ts
 /**
@@ -3264,6 +3549,9 @@ function registerCoreNodes() {
 	registerNode(UiToggle);
 	registerNode(UiSelect);
 	registerNode(UiLanguageSelect);
+	registerNode(UiQualitySelect);
+	registerNode(UiFrameCapSelect);
+	registerNode(UiRenderScaleSelect);
 }
 //#endregion
-export { translationKey as A, WebAudioMusicBackend as B, restoreBehaviors as C, Localization as D, BASE_LOCALE as E, spatialPan as F, fadeGain as H, SFX_PRESETS as I, SFX_PRESET_NAMES as L, isAudioContextAvailable as M, ROLLOFF_MODELS as N, T_PREFIX as O, spatialGain as P, synthSfx as R, captureBehaviors as S, LogManager as T, AudioBuses as U, crossfadeGains as V, qualityEnvironment as _, UiSlider as a, SaveSlots as b, UiButton as c, UiBanner as d, UiBar as f, Settings as g, Engine as h, UiSelect as i, SfxEngine as j, suggestLocale as k, UiDialogue as l, AudioPlayer as m, UiImage as n, UiToggle as o, UiText as p, UiPanel as r, Timer as s, registerCoreNodes as t, HudLayer as u, readDeviceHints as v, createSaveStore as w, behaviorsWithoutSave as x, suggestQuality as y, MusicManager as z };
+export { suggestLocale as A, MusicManager as B, captureBehaviors as C, BASE_LOCALE as D, LogManager as E, spatialGain as F, crossfadeGains as H, spatialPan as I, SFX_PRESETS as L, SfxEngine as M, isAudioContextAvailable as N, Localization as O, ROLLOFF_MODELS as P, SFX_PRESET_NAMES as R, behaviorsWithoutSave as S, createSaveStore as T, fadeGain as U, WebAudioMusicBackend as V, AudioBuses as W, qualityEnvironment as _, UiSlider as a, suggestQuality as b, UiButton as c, UiBanner as d, UiBar as f, Settings as g, Engine as h, UiSelect as i, translationKey as j, T_PREFIX as k, UiDialogue as l, AudioPlayer as m, UiImage as n, UiToggle as o, UiText as p, UiPanel as r, Timer as s, registerCoreNodes as t, HudLayer as u, qualityRendering as v, restoreBehaviors as w, SaveSlots as x, readDeviceHints as y, synthSfx as z };

package/dist/{register-DFSW2Y30.js → register-DnB9m7Rl.js}

@@ -1,5 +1,5 @@
 import { f as Node, h as effectiveOrder } from "./loader-r49nDwB4.js";
-import { t as registerCoreNodes } from "./register-DOWGnxe1.js";
+import { t as registerCoreNodes } from "./register-Dm7nrd-E.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
 import { t as Rng } from "./rng-DP-SR7eg.js";
 import { i as getNodeSchema, l as registerNode } from "./registry-IyWCGe4q.js";

package/dist/{replay-DGzhZWrM.d.ts → replay-Cxrr-ApH.d.ts}

@@ -1,4 +1,4 @@
-import { b as Engine } from "./behavior-5o1EkbLD.js";
+import { b as Engine } from "./behavior-B5PJ32eu.js";
 import { s as JsonObject } from "./schema-CFeioQRE.js";
 
 //#region src/core/audit.d.ts

package/dist/{replay-BuOTl5rM.js → replay-DH0UOuZ-.js}

@@ -1,4 +1,4 @@
-import { A as translationKey } from "./register-DOWGnxe1.js";
+import { j as translationKey } from "./register-Dm7nrd-E.js";
 //#region src/core/audit.ts
 const ANIMATED_TYPES = new Set([
 	"Particles2D",