incanto 0.69.0 → 0.70.0

package/dist/index.js

@@ -1,15 +1,13 @@
-import { A as describeRefProblem, B as registeredBehaviors, C as ORDER_GROUP_BASE, E as InputMap, F as behaviorSchema, I as behaviorSignals, L as clearBehaviors, M as resolveRefInJson, N as parseNodePath, O as Node, P as Behavior, R as getBehavior, S as createSaveStore, T as resolveOrderGroups, V as Signal, _ as SaveSlots, a as serializeNode, b as restoreBehaviors, d as computeViewport, f as resolveViewport, g as resolveConstants, h as isConstRef, i as Scene, j as nodeRefWarnings, m as CONST_REF_KEY, n as loadScene, o as SCENE_FORMAT, p as SceneTree, v as behaviorsWithoutSave, w as effectiveOrder, x as savesWithoutUid, y as captureBehaviors, z as registerBehavior } from "./loader-DZE7B07H.js";
-import { A as UiBanner, B as isAudioContextAvailable, D as EffectLog, E as LogManager, F as T_PREFIX, G as SFX_PRESET_NAMES, H as spatialGain, I as suggestLocale, J as MusicManager, K as sfxDuration, M as UiText, N as BASE_LOCALE, O as HudLayer, P as Localization, Q as AudioBuses, R as translationKey, S as qualityEnvironment, T as suggestQuality, U as spatialPan, V as ROLLOFF_MODELS, W as SFX_PRESETS, X as crossfadeGains, Y as WebAudioMusicBackend, Z as fadeGain, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as UiBar, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as synthSfx, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SfxEngine } from "./register-mmfugpaQ.js";
+import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CfTjpvW8.js";
+import { C as isConstRef, D as newUid, E as resolveViewport, H as UiBar, J as describeRefProblem, K as Node, M as effectiveOrder, N as resolveOrderGroups, O as SceneTree, P as InputMap, Q as Behavior, R as HudLayer, S as CONST_REF_KEY, T as computeViewport, U as UiText, V as UiBanner, X as resolveRefInJson, Y as nodeRefWarnings, Z as parseNodePath, _ as SCENE_FORMAT, a as restoreBehaviors, at as registeredBehaviors, et as behaviorSchema, g as serializeNode, h as Scene, i as captureBehaviors, it as registerBehavior, j as ORDER_GROUP_BASE, k as createSaveStore, n as SaveSlots, nt as clearBehaviors, o as savesWithoutUid, ot as Signal, p as loadScene, r as behaviorsWithoutSave, rt as getBehavior, s as duplicateNode, tt as behaviorSignals, w as resolveConstants } from "./save-slots-BXVg148r.js";
+import { A as T_PREFIX, B as SFX_PRESET_NAMES, D as EffectLog, E as LogManager, F as isAudioContextAvailable, G as crossfadeGains, H as synthSfx, I as ROLLOFF_MODELS, K as fadeGain, L as spatialGain, N as translationKey, O as BASE_LOCALE, P as SfxEngine, R as spatialPan, S as qualityEnvironment, T as suggestQuality, U as MusicManager, V as sfxDuration, W as WebAudioMusicBackend, _ as AudioPlayer, a as UiMuteToggle, b as Settings, c as UiRenderScaleSelect, d as UiToggle, f as UiVolumeSlider, g as UiDialogue, h as UiButton, i as UiLanguageSelect, j as suggestLocale, k as Localization, l as UiSelect, m as Respawn, n as UiFrameCapSelect, o as UiPanel, p as Timer, q as AudioBuses, r as UiImage, s as UiQualitySelect, t as registerCoreNodes, u as UiSlider, v as Engine, w as readDeviceHints, z as SFX_PRESETS } from "./register-6DYnKZcy.js";
 import { t as IncantoError } from "./errors-BpWbnbb_.js";
-import { t as Rng } from "./rng-DP-SR7eg.js";
-import { n as jsonEquals, r as jsonKind, t as jsonClone } from "./json-CwwhxQgb.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-CF70EArN.js";
-import { i as joystickVector, n as attachTouchControls, t as TouchControls } from "./touch-DEAmqGdf.js";
-import { n as startRecording, r as auditScene, t as replay } from "./replay-BEHLDcQV.js";
+import { t as Rng } from "./rng-CDOMybym.js";
+import { c as getNodeSchema, f as mergeStaticSignals, i as joystickVector, l as getNodeSignals, m as registeredTypes, n as attachTouchControls, o as clearRegistry, p as registerNode, s as createNode, t as TouchControls, u as getNodeType } from "./touch-BnCyPA0G.js";
+import { n as startRecording, r as auditScene, t as replay } from "./replay-DjAkAzMq.js";
 import { t as showBootFailure } from "./boot-failure-CKYrEcGF.js";
-import { a as logText, i as logReport, o as parseDrive, r as resolveRendering, t as isWebGLAvailable } from "./webgl-unavailable-Z5_g8x9H.js";
-import { t as createNoise2D } from "./noise-CGUMx44x.js";
-import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CY-mrr1L.js";
-import { a as preloadUrls, i as preloadSceneAssets, n as newUid, o as findPath, r as assetUrls, s as gridFromRows, t as VERSION } from "./src-CYEu-_S9.js";
-import { t as duplicateNode } from "./duplicate-Dj4L-5AA.js";
+import { a as logText, i as logReport, o as parseDrive, r as resolveRendering, t as isWebGLAvailable } from "./webgl-unavailable-C8aDbGmR.js";
+import { t as createNoise2D } from "./noise-D3nPpmFg.js";
+import { a as PARTICLE_PRESETS, i as ParticleSim, n as resolveFrames, o as PARTICLE_PRESET_NAMES, s as applyParticlePreset, t as resolveAnimation } from "./sprite-animation-CqR2o3SA.js";
+import { a as findPath, i as preloadUrls, n as assetUrls, o as gridFromRows, r as preloadSceneAssets, t as VERSION } from "./src-Cxfiv1Hg.js";
 export { AudioBuses, AudioPlayer, BASE_LOCALE, Behavior, CONST_REF_KEY, EffectLog, Engine, HudLayer, IncantoError, InputMap, Localization, LogManager, MusicManager, Node, ORDER_GROUP_BASE, PARTICLE_PRESETS, PARTICLE_PRESET_NAMES, ParticleSim, ROLLOFF_MODELS, Respawn, Rng, SCENE_FORMAT, SFX_PRESETS, SFX_PRESET_NAMES, SaveSlots, Scene, SceneTree, Settings, SfxEngine, Signal, T_PREFIX, Timer, TouchControls, UiBanner, UiBar, UiButton, UiDialogue, UiFrameCapSelect, UiImage, UiLanguageSelect, UiMuteToggle, UiPanel, UiQualitySelect, UiRenderScaleSelect, UiSelect, UiSlider, UiText, UiToggle, UiVolumeSlider, VERSION, WebAudioMusicBackend, applyParticlePreset, assetUrls, attachTouchControls, auditScene, behaviorSchema, behaviorSignals, behaviorsWithoutSave, captureBehaviors, clearBehaviors, clearRegistry, computeViewport, createNode, createNoise2D, createSaveStore, crossfadeGains, describeRefProblem, duplicateNode, effectiveOrder, fadeGain, findPath, getBehavior, getNodeSchema, getNodeSignals, getNodeType, gridFromRows, isAudioContextAvailable, isConstRef, isWebGLAvailable, joystickVector, jsonClone, jsonEquals, jsonKind, loadScene, logReport, logText, mergeStaticSignals, newUid, nodeRefWarnings, parseDrive, parseNodePath, preloadSceneAssets, preloadUrls, qualityEnvironment, readDeviceHints, registerBehavior, registerCoreNodes, registerNode, registeredBehaviors, registeredTypes, replay, resolveAnimation, resolveConstants, resolveFrames, resolveOrderGroups, resolveRefInJson, resolveRendering, resolveViewport, restoreBehaviors, savesWithoutUid, serializeNode, sfxDuration, showBootFailure, spatialGain, spatialPan, startRecording, suggestLocale, suggestQuality, synthSfx, translationKey };

package/dist/json-CfTjpvW8.js

@@ -0,0 +1,67 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+//#region src/core/json.ts
+var json_exports = /* @__PURE__ */ __exportAll({
+	jsonClone: () => jsonClone,
+	jsonEquals: () => jsonEquals,
+	jsonKind: () => jsonKind,
+	parseJsonText: () => parseJsonText
+});
+/**
+* `JSON.parse`, minus the byte nobody can see.
+*
+* A UTF-8 byte order mark is legal in a UTF-8 file and meaningless in it, and
+* `JSON.parse` refuses it. Windows PowerShell 5.1's `Set-Content` writes one by
+* default and several editors add it on "save as UTF-8", so a scene written by
+* an ordinary tool came back as
+*
+* ```
+* [BAD_JSON] Unexpected token '\uFEFF', "\uFEFF{ "format"... is not valid JSON
+* ```
+*
+* about a character that is ZERO WIDTH: the author sees valid JSON, an error
+* pointing at nothing, and no way forward. Node's own `require()` of a .json
+* file has stripped it for a decade; `JSON.parse` is the one door that does not.
+*/
+function parseJsonText(text) {
+	return JSON.parse(text.charCodeAt(0) === 65279 ? text.slice(1) : text);
+}
+function jsonKind(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "array";
+	const t = typeof value;
+	if (t === "string" || t === "number" || t === "boolean") return t;
+	return "object";
+}
+/** Deep structural equality over JSON values (used for delta-only serialization). */
+function jsonEquals(a, b) {
+	if (a === b) return true;
+	if (Array.isArray(a) && Array.isArray(b)) return a.length === b.length && a.every((v, i) => jsonEquals(v, b[i]));
+	if (a !== null && b !== null && typeof a === "object" && typeof b === "object") {
+		if (Array.isArray(a) || Array.isArray(b)) return false;
+		const ka = Object.keys(a);
+		const kb = Object.keys(b);
+		return ka.length === kb.length && ka.every((k) => k in b && jsonEquals(a[k], b[k]));
+	}
+	return false;
+}
+/**
+* Deep clone of JSON-safe data (defaults must never be shared between
+* instances). The value must contain only JSON types.
+*/
+function jsonClone(value) {
+	if (value === null || typeof value !== "object") return value;
+	return JSON.parse(JSON.stringify(value));
+}
+//#endregion
+export { parseJsonText as a, json_exports as i, jsonEquals as n, __exportAll as o, jsonKind as r, jsonClone as t };

package/dist/{loader-DadV2QCT.d.ts → loader-Cff09LMm.d.ts}

@@ -1,5 +1,5 @@
-import { P as Scene, b as Engine } from "./behavior-rm8vVzu_.js";
-import { i as SceneJson } from "./schema-B6ugCV1Q.js";
+import { P as Scene, b as Engine } from "./behavior-DZExDn9o.js";
+import { a as SceneJson } from "./rng-Bb-IutXB.js";
 
 //#region src/core/scene/loader.d.ts
 interface LoadSceneOptions {

package/dist/net.d.ts

@@ -1,5 +1,6 @@
-import { d as PropSchema, jt as Node } from "./behavior-rm8vVzu_.js";
-import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen-Cg76MCV5.js";
+import { d as PropSchema, jt as Node } from "./behavior-DZExDn9o.js";
+import { t as DiagnosticSink } from "./diagnostics-Cu85N3tL.js";
+import { a as NetworkManagerOptions, c as LocalGameServer, d as ServerClass, f as createLocalGameServer, g as Unsubscribe, h as NetworkTransport, i as NetworkManager, l as LocalGameServerOptions, m as LoopbackTransport, n as SplitScreenPlayer, o as applySyncPatch, p as LoopbackHub, r as createSplitScreen, s as CollectionOptions, t as SplitScreenOptions, u as LocalGameServerTransport } from "./split-screen--k-XpBjr.js";
 
 //#region src/net/agent8.d.ts
 /**
@@ -22,7 +23,7 @@ declare function createAgent8Server(config?: {
   verse?: string;
   account?: string;
   auth?: string;
-}): Promise<NetworkTransport>;
+}, diagnostics?: DiagnosticSink | null): Promise<NetworkTransport>;
 //#endregion
 //#region src/net/nodes/network-spawner.d.ts
 /**
@@ -48,6 +49,8 @@ declare class NetworkSpawner extends Node {
   private readonly positionTargets;
   private readonly failedKeys;
   private readonly reported;
+  /** Seconds spent looking for a NetworkManager — see the report in `update`. */
+  private waited;
   override update(dt: number): void;
   private currentEntries;
   /**
@@ -63,6 +66,27 @@ declare class NetworkSpawner extends Node {
   /** Say it ONCE per message — a per-frame repeat would drown the log. */
   private report;
   private setProp;
+  /**
+  * What the NETWORK last said this node's position is — not where it is drawn.
+  *
+  * A remote copy renders slightly in the past, chasing its target at
+  * ~12.5%/frame. That is the right way to draw one and the wrong way to
+  * COMPARE one: `incanto-multiplay`'s `agrees` rung read the rendered
+  * position, so a late joiner whose interpolation had not converged was
+  * reported as disagreeing with the owner —
+  *
+  *   ✗ late has p1's `position` as [-3.3465…], not [-3.3989…]
+  *
+  * — on both SHIPPED 2D multiplayer examples, which exit 1 today on the plain
+  * documented command. The size of the "disagreement" is the player's speed
+  * times the chase lag, so a faster game fails harder while replicating
+  * perfectly.
+  *
+  * `undefined` when this spawner has no target for that node: it is not one of
+  * ours, or `interpolate` is off, in which case the drawn value IS the
+  * received one.
+  */
+  replicatedPosition(node: Node): number[] | undefined;
   private stepInterpolation;
 }
 //#endregion

package/dist/net.js

@@ -1,3 +1,3 @@
-import { n as createAgent8Server } from "./agent8-CvsfVskX.js";
-import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-CauMwu6y.js";
+import { n as createAgent8Server } from "./agent8-CmNF01gA.js";
+import { a as NetworkManager, d as createLocalGameServer, f as LoopbackHub, l as LocalGameServer, n as registerNodesNet, o as applySyncPatch, p as LoopbackTransport, r as NetworkSpawner, t as createSplitScreen, u as LocalGameServerTransport } from "./split-screen-PL78oVXP.js";
 export { LocalGameServer, LocalGameServerTransport, LoopbackHub, LoopbackTransport, NetworkManager, NetworkSpawner, applySyncPatch, createAgent8Server, createLocalGameServer, createSplitScreen, registerNodesNet };

package/dist/{noise-CGUMx44x.js → noise-D3nPpmFg.js}

@@ -1,4 +1,4 @@
-import { t as Rng } from "./rng-DP-SR7eg.js";
+import { t as Rng } from "./rng-CDOMybym.js";
 //#region src/core/noise.ts
 /** Skewing factors for 2D simplex: F2 = (√3−1)/2, G2 = (3−√3)/6. */
 const F2 = .5 * (Math.sqrt(3) - 1);

package/dist/{physics-2d-CF5yyjbj.js → physics-2d-CE0Qvy3V.js}

@@ -1,7 +1,7 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
-import { k as diagnose } from "./loader-DZE7B07H.js";
+import { o as __exportAll } from "./json-CfTjpvW8.js";
+import { q as diagnose } from "./save-slots-BXVg148r.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-DbVArsns.js";
+import { _ as RigidBody2D, b as validateCollider2D, g as PhysicsBody2D, h as CharacterBody2D, m as Area2D, p as Joint2D, y as Node2D } from "./register-Bkk0wSDB.js";
 import { n as registerDebugSource } from "./debug-draw-BM3DsvtT.js";
 import { n as jointContacts, t as withoutRapierInitNoise } from "./quiet-rapier-C6fW4zcW.js";
 //#region src/2d/physics/physics-2d.ts
@@ -108,8 +108,10 @@ var Physics2D = class {
 				}
 				const lv = e.body.linvel();
 				node.linearVelocity = [lv.x * SCALE, lv.y * SCALE];
+				node.angularVelocity = e.body.angvel();
 				e.lastVX = node.linearVelocity[0] ?? 0;
 				e.lastVY = node.linearVelocity[1] ?? 0;
+				e.lastAV = node.angularVelocity;
 			}
 			const t2 = e.body.translation();
 			e.lastX = t2.x * SCALE;
@@ -130,6 +132,29 @@ var Physics2D = class {
 			}
 		});
 	}
+	/**
+	* May `candidate` carry `rider`?
+	*
+	* The rule used to be "never a CharacterBody2D", which is the whole CLASS —
+	* and a `CharacterBody2D` animated by POSITION WRITES is the documented
+	* moving-platform path (`Oscillate`, `MoveTo`, `PathFollow`, or a behaviour of
+	* your own). `incanto-physics-and-input.md` promises twice that a character
+	* standing on ANY moving body is carried; it was not, and the rider reported
+	* `isOnFloor() === true` the whole time while sliding off in world space.
+	*
+	* What the guard was really for is a CYCLE: two characters standing on each
+	* other would carry each other forever. So the test is the rider's own
+	* carrier chain, not the type — a platform that is not (transitively) riding
+	* you can carry you.
+	*/
+	canCarry(rider, candidate) {
+		let at = candidate;
+		for (let depth = 0; depth < 8 && at; depth++) {
+			if (at === rider) return false;
+			at = this.entries.get(at)?.ground ?? null;
+		}
+		return true;
+	}
 	/** @internal Called by CharacterBody2D.moveAndSlide (during tree fixedUpdate). */
 	moveAndSlide(node) {
 		const e = this.ensureEntry(node);
@@ -137,6 +162,8 @@ var Physics2D = class {
 		if (node.stickToGround && vy >= 0) this.kcc.enableSnapToGround(.05);
 		else this.kcc.disableSnapToGround();
 		this.kcc.setMaxSlopeClimbAngle(node.slopeLimitDeg * DEG);
+		if (node.stepHeight > 0) this.kcc.enableAutostep(node.stepHeight / SCALE, node.stepHeight / SCALE / 2, false);
+		else this.kcc.disableAutostep();
 		let carryX = 0;
 		let carryY = 0;
 		if (e.ground && e.ground._physics === this) {
@@ -144,9 +171,10 @@ var Physics2D = class {
 			carryX = gx - (e.groundX ?? gx);
 			carryY = gy - (e.groundY ?? gy);
 		} else e.ground = null;
+		const vyTerm = carryY < -.1 && node.isOnFloor?.() === true && vy > 0 ? 0 : vy * this.lastDt;
 		const desired = {
 			x: ((node.velocity[0] ?? 0) * this.lastDt + carryX) / SCALE * 1,
-			y: (vy * this.lastDt + carryY) / SCALE * 1
+			y: (vyTerm + carryY) / SCALE * 1
 		};
 		const charBottomPx = e.body.translation().y * SCALE + charHalfHeight(node);
 		const predicate = (collider) => {
@@ -171,7 +199,7 @@ var Physics2D = class {
 		for (let i = 0; i < hits; i++) {
 			const n = this.kcc.computedCollision(i)?.normal1;
 			if (!n) continue;
-			if (Math.abs(n.y) > .7) {
+			if (n.y > .7) {
 				if (!node._grounded) node._onCeiling = true;
 			} else if (Math.abs(n.x) > .7) node._onWall = n.x > 0 ? -1 : 1;
 		}
@@ -179,7 +207,7 @@ var Physics2D = class {
 			const footX = (t.x + corrected.x) * SCALE;
 			const footY = (t.y + corrected.y) * SCALE + charHalfHeight(node) - 2;
 			const hit = this.castRay([footX, footY], [0, 1], 8, node);
-			if (hit?.node && !(hit.node instanceof CharacterBody2D)) {
+			if (hit?.node && this.canCarry(node, hit.node)) {
 				e.ground = hit.node;
 				const [gx, gy] = worldPosition2D(hit.node);
 				e.groundX = gx;
@@ -340,13 +368,48 @@ var Physics2D = class {
 		return [...set];
 	}
 	/**
-	* World-space raycast in PIXELS (y-down). `exclude` skips that body — a
+	* Mass the solver actually uses (collider-derived unless overridden).
+	*
+	* The 3D twin has had this since `CharacterController3D` needed it to size an
+	* impulse; 2D had no way to ask, so a 2D game scaling a push by mass had to
+	* read the AUTHORED `mass` prop and hope it was the number Rapier settled on.
+	*/
+	massOf(node) {
+		return this.entries.get(node)?.body.mass() ?? 1;
+	}
+	/**
+	* Current solver velocity in px/s (fresher than the node prop mid-step).
+	*
+	* `linearVelocity` is written back once per step, so a behavior reading it
+	* from inside `fixedUpdate` — after a collision, before the write-back — sees
+	* the value from BEFORE the impact. That is exactly when a game wants to know
+	* how hard it hit something.
+	*/
+	velocityOf(node) {
+		const v = this.entries.get(node)?.body.linvel();
+		return v ? [v.x * SCALE, v.y * SCALE] : [0, 0];
+	}
+	/**
+	* A world-space impulse in px.kg/s (y-down) — the 2D twin of
+	* `Physics3D.applyImpulse`, which the physics skill has documented for both
+	* adapters while only one of them had it.
+	*/
+	applyImpulse(node, impulse) {
+		this.entries.get(node)?.body.applyImpulse({
+			x: impulse[0] / SCALE,
+			y: impulse[1] / SCALE
+		}, true);
+	}
+	/**
+	* World-space raycast in PIXELS (y-down); `dir` may be any length (it is
+	* normalized), so `distance` and `maxLen` are pixels. `exclude` skips that body — a
 	* shooter probing from inside its own collider needs it. Sensors (Area2D)
 	* never block rays. Returns distance (px), the surface normal, and the hit
 	* body — or null.
 	*/
 	castRay(origin, dir, maxLen, exclude, opts) {
-		const len = Math.hypot(dir[0], dir[1]) || 1;
+		const len = Math.hypot(dir[0], dir[1]);
+		if (!(len > 0)) return null;
 		const ray = new this.R.Ray({
 			x: origin[0] / SCALE,
 			y: origin[1] / SCALE
@@ -358,9 +421,44 @@ var Physics2D = class {
 		const flags = opts?.staticOnly ? this.R.QueryFilterFlags.EXCLUDE_DYNAMIC | this.R.QueryFilterFlags.EXCLUDE_KINEMATIC : void 0;
 		const hit = this.world.castRayAndGetNormal(ray, maxLen / SCALE, true, flags, void 0, excludeCollider, void 0, (collider) => !collider.isSensor());
 		if (!hit) return null;
+		const distance = hit.timeOfImpact * SCALE;
 		return {
-			distance: hit.timeOfImpact * SCALE,
+			distance,
 			normal: [hit.normal.x, hit.normal.y],
+			node: this.byColliderHandle.get(hit.collider.handle) ?? null,
+			point: [origin[0] + dir[0] / len * distance, origin[1] + dir[1] / len * distance]
+		};
+	}
+	/**
+	* Sweep a CIRCLE of `radius` from `origin` along `dir` — a thick ray, in
+	* pixels. The 2D twin of `Physics3D.castSphere`.
+	*
+	* 3D has had this since the camera spring arm needed it and 2D never got it,
+	* so the shared `PhysicsQuery` interface declares it OPTIONAL and every 2D
+	* game that wanted a probe with THICKNESS — a shot that must not thread a
+	* one-pixel gap between two tiles, a ledge feeler, a camera that should not
+	* clip a wall it skims — had to fire several thin rays and hope.
+	*
+	* Same filters as `castRay`: sensors never hit, `staticOnly` ignores dynamic
+	* and kinematic bodies, `dir` may be any length. Returns the travel distance
+	* of the circle's CENTRE, or null when the sweep is clear.
+	*/
+	castSphere(origin, dir, radius, maxLen, exclude, opts) {
+		const R = this.R;
+		const len = Math.hypot(dir[0], dir[1]);
+		if (!(len > 0)) return null;
+		const excludeEntry = exclude ? this.entries.get(exclude) : void 0;
+		const flags = opts?.staticOnly ? R.QueryFilterFlags.EXCLUDE_DYNAMIC | R.QueryFilterFlags.EXCLUDE_KINEMATIC : void 0;
+		const hit = this.world.castShape({
+			x: origin[0] / SCALE,
+			y: origin[1] / SCALE
+		}, 0, {
+			x: dir[0] / len,
+			y: dir[1] / len
+		}, new R.Ball(radius / SCALE), 0, maxLen / SCALE, true, flags, void 0, excludeEntry?.collider, excludeEntry?.body, (collider) => !collider.isSensor());
+		if (!hit) return null;
+		return {
+			distance: hit.time_of_impact * SCALE,
 			node: this.byColliderHandle.get(hit.collider.handle) ?? null
 		};
 	}
@@ -465,13 +563,15 @@ var Physics2D = class {
 			const x = wx / SCALE;
 			const y = wy / SCALE;
 			let desc;
-			if (node instanceof RigidBody2D) desc = R.RigidBodyDesc.dynamic();
+			const dyn = node instanceof RigidBody2D;
+			if (dyn) desc = R.RigidBodyDesc.dynamic();
 			else if (node instanceof CharacterBody2D || node instanceof Area2D) desc = R.RigidBodyDesc.kinematicPositionBased();
 			else desc = R.RigidBodyDesc.fixed();
 			desc.setTranslation(x, y).setRotation(node.rotation * DEG);
 			if (node instanceof RigidBody2D) {
 				desc.setGravityScale(node.gravityScale);
 				desc.setLinvel((node.linearVelocity[0] ?? 0) / SCALE, (node.linearVelocity[1] ?? 0) / SCALE);
+				desc.setAngvel(node.fixedRotation ? 0 : node.angularVelocity);
 				if (node.fixedRotation) desc.lockRotations();
 			}
 			const body = this.world.createRigidBody(desc);
@@ -488,7 +588,12 @@ var Physics2D = class {
 				lastY: wy,
 				lastRot: node.rotation,
 				lastVX: 0,
-				lastVY: 0
+				lastVY: 0,
+				lastAV: dyn ? node.angularVelocity : 0,
+				lastMass: dyn ? node.mass : 1,
+				lastFriction: dyn ? node.friction : .5,
+				lastRestitution: dyn ? node.restitution : 0,
+				lastGravityScale: dyn ? node.gravityScale : 1
 			};
 			this.entries.set(node, e);
 			this.byColliderHandle.set(collider.handle, node);
@@ -530,6 +635,26 @@ var Physics2D = class {
 				e.lastVX = vx;
 				e.lastVY = vy;
 			}
+			if (node.angularVelocity !== e.lastAV) {
+				e.body.setAngvel(node.angularVelocity, true);
+				e.lastAV = node.angularVelocity;
+			}
+			if (node.gravityScale !== e.lastGravityScale) {
+				e.body.setGravityScale(node.gravityScale, true);
+				e.lastGravityScale = node.gravityScale;
+			}
+			if (node.mass !== e.lastMass) {
+				e.collider.setMass(node.mass);
+				e.lastMass = node.mass;
+			}
+			if (node.friction !== e.lastFriction) {
+				e.collider.setFriction(node.friction);
+				e.lastFriction = node.friction;
+			}
+			if (node.restitution !== e.lastRestitution) {
+				e.collider.setRestitution(node.restitution);
+				e.lastRestitution = node.restitution;
+			}
 		}
 		return e;
 	}