@kvyverse/world-runtime 0.6.2 → 0.6.3

package/LICENSE.md

@@ -1,6 +1,6 @@
 # Kvyverse World Runtime License
 
-Copyright (c) 2026 Vladislav Kruteniuk (Kvyverse). All rights reserved.
+Copyright (c) 2026 Kvyverse, Inc. All rights reserved.
 
 This package (`@kvyverse/world-runtime`, the "Software") is proprietary
 software. It is **not** open source.
@@ -54,4 +54,4 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
-For other licensing needs, contact: vladislove2402@gmail.com
+For other licensing needs, contact: legal@kvyverse.com

package/dist/{BallCollider-DdxrnexK.js → BallCollider-3L5vOrcL.js}

@@ -1,6 +1,6 @@
-import { n as getRadiusScale } from "./get-scale-from-obj-bFMquHMV.js";
-import { t as Collider } from "./Collider-ElnvKET2.js";
-//#region src/behaviours/physics/BallCollider.ts
+import { n as getRadiusScale } from "./get-scale-from-obj-B7JlVPni.js";
+import { t as Collider } from "./Collider-CPUCG3RA.js";
+//#region packages/world-runtime/src/behaviours/physics/BallCollider.ts
 var BallCollider = class extends Collider {
 	type = "Ball";
 	/**

package/dist/{CapsuleCollider-XlGZqg_O.js → CapsuleCollider-CBTsR-Ys.js}

@@ -1,6 +1,6 @@
-import { t as getHalfheightRadiusScale } from "./get-scale-from-obj-bFMquHMV.js";
-import { t as Collider } from "./Collider-ElnvKET2.js";
-//#region src/behaviours/physics/CapsuleCollider.ts
+import { t as getHalfheightRadiusScale } from "./get-scale-from-obj-B7JlVPni.js";
+import { t as Collider } from "./Collider-CPUCG3RA.js";
+//#region packages/world-runtime/src/behaviours/physics/CapsuleCollider.ts
 var CapsuleCollider = class extends Collider {
 	type = "Capsule";
 	/**

package/dist/{ChatModule-DzNY_v-3.js → ChatModule-2tiWS_Yr.js}

@@ -1,10 +1,10 @@
-import { t as CHAT_COMMAND_KEY } from "./chat.module-descriptor-BMy5jpOU.js";
+import { t as CHAT_COMMAND_KEY } from "./chat.module-descriptor-BTsep-Kq.js";
 import { ContextModule, ThreeContextEvents } from "three-start";
 import van from "vanjs-core";
-//#region src/modules/chat/chat.css?inline
+//#region packages/world-runtime/src/modules/chat/chat.css?inline
 var chat_default = "/* Neutral base for the chat input: only what it breaks without on real devices.\n   Looks are left to the world. */\n\n.kvy-chat {\n	position: absolute;\n	left: 0;\n	bottom: 0;\n	width: 100%;\n	box-sizing: border-box;\n	display: flex;\n	flex-direction: column;\n	justify-content: flex-end;\n	/* On-screen keyboard: ChatDom writes the overlap height here. */\n	padding-bottom: var(--kvy-chat-keyboard-inset, 0px);\n	/* Click-through like the HUD around it: the root stretches over the whole feed,\n	   so catching events here would kill clicks on the world behind the messages.\n	   Only the input takes events back. */\n	pointer-events: none;\n}\n\n.kvy-chat__form {\n	display: flex;\n	margin: 0;\n}\n\n.kvy-chat__input {\n	flex: 1 1 auto;\n	min-width: 0;\n	/* 16px — below that iOS Safari zooms the page on focus. */\n	font: inherit;\n	font-size: 16px;\n	line-height: 1.25;\n	color: inherit;\n	background: transparent;\n	border: 0;\n	outline: none;\n	padding: 4px 6px;\n	-webkit-appearance: none;\n	appearance: none;\n	border-radius: 0;\n	/* The one interactive part of the chat. */\n	pointer-events: auto;\n	/* No 300ms delay and no double-tap zoom on the input. */\n	touch-action: manipulation;\n}\n\n/* The message feed is a TTL queue, not a scroll container. It sticks to the\n   bottom and extra lines are cut from the top — no scrollbar here by design. */\n.kvy-chat__feed {\n	display: flex;\n	flex-direction: column;\n	justify-content: flex-end;\n	max-height: 40vh;\n	overflow: hidden;\n	/* Belt and braces: the root is already click-through, but a world restyling it\n	   must not accidentally make messages catch clicks. */\n	pointer-events: none;\n}\n\n.kvy-chat__line {\n	opacity: 1;\n	transition: opacity 300ms ease;\n	overflow-wrap: anywhere;\n}\n\n/* The line has outlived its time: it fades but stays in the DOM — opening the\n   chat shows it again instead of rebuilding the feed. */\n.kvy-chat__line--faded {\n	opacity: 0;\n}\n\n/* Hidden submit button: backs up implicit submission in old webviews. */\n.kvy-chat__submit {\n	position: absolute;\n	width: 1px;\n	height: 1px;\n	padding: 0;\n	margin: -1px;\n	overflow: hidden;\n	clip-path: inset(50%);\n	white-space: nowrap;\n	border: 0;\n}\n\n/* Toggle mode: the input is hidden until entered (Enter on the canvas).\n   Opacity, not visibility/display: an element hidden by those cannot be focused\n   programmatically, leaving nothing to open the chat with. */\n.kvy-chat--idle-hidden .kvy-chat__input {\n	opacity: 0;\n	pointer-events: none;\n}\n";
 //#endregion
-//#region src/modules/chat/ChatDom.ts
+//#region packages/world-runtime/src/modules/chat/ChatDom.ts
 var { button, div, form, input } = van.tags;
 var STYLE_ID = "kvyverse-chat-styles";
 /**
@@ -299,7 +299,7 @@ var ChatDom = class ChatDom {
 	}
 };
 //#endregion
-//#region src/modules/chat/ChatModule.ts
+//#region packages/world-runtime/src/modules/chat/ChatModule.ts
 /**
 * The world chat as a pluggable ctx module: message history plus its own DOM
 * input (`dom`), no React. Enabled from `settings.addons.json → modules`; it

package/dist/{Collider-ElnvKET2.js → Collider-CPUCG3RA.js}

@@ -1,7 +1,7 @@
-import { t as Rigidbody } from "./Rigidbody-BHRxJKXd.js";
+import { t as Rigidbody } from "./Rigidbody-DLhN8ddv.js";
 import * as THREE from "three/webgpu";
 import { Object3DBehaviour, assertDefined, getComponents } from "three-start";
-//#region src/behaviours/physics/Collider.ts
+//#region packages/world-runtime/src/behaviours/physics/Collider.ts
 /** Walk the parent chain (ancestors only); stop when `cb` returns `false`. */
 function traverseUp(obj, cb) {
 	let cur = obj.parent;

package/dist/{ConeCollider-CQfGphDa.js → ConeCollider-C3XU3Y9X.js}

@@ -1,6 +1,6 @@
-import { t as getHalfheightRadiusScale } from "./get-scale-from-obj-bFMquHMV.js";
-import { t as Collider } from "./Collider-ElnvKET2.js";
-//#region src/behaviours/physics/ConeCollider.ts
+import { t as getHalfheightRadiusScale } from "./get-scale-from-obj-B7JlVPni.js";
+import { t as Collider } from "./Collider-CPUCG3RA.js";
+//#region packages/world-runtime/src/behaviours/physics/ConeCollider.ts
 var ConeCollider = class extends Collider {
 	type = "Cone";
 	/**

package/dist/{ConvexMeshCollider-0Q2u7QAL.js → ConvexMeshCollider-DzNV4HTO.js}

@@ -1,5 +1,5 @@
-import { t as Collider } from "./Collider-ElnvKET2.js";
-//#region src/behaviours/physics/ConvexMeshCollider.ts
+import { t as Collider } from "./Collider-CPUCG3RA.js";
+//#region packages/world-runtime/src/behaviours/physics/ConvexMeshCollider.ts
 var ConvexMeshCollider = class extends Collider {
 	type = "Convex";
 	getDesc(rapier) {

package/dist/{CuboidCollider-Cm7kKRMA.js → CuboidCollider-Dp1DZoFM.js}

@@ -1,5 +1,5 @@
-import { t as Collider } from "./Collider-ElnvKET2.js";
-//#region src/behaviours/physics/CuboidCollider.ts
+import { t as Collider } from "./Collider-CPUCG3RA.js";
+//#region packages/world-runtime/src/behaviours/physics/CuboidCollider.ts
 var CuboidCollider = class extends Collider {
 	type = "Cuboid";
 	/**

package/dist/{CylinderCollider-P2oZeEyb.js → CylinderCollider-C0h_nhB5.js}

@@ -1,6 +1,6 @@
-import { t as getHalfheightRadiusScale } from "./get-scale-from-obj-bFMquHMV.js";
-import { t as Collider } from "./Collider-ElnvKET2.js";
-//#region src/behaviours/physics/CylinderCollider.ts
+import { t as getHalfheightRadiusScale } from "./get-scale-from-obj-B7JlVPni.js";
+import { t as Collider } from "./Collider-CPUCG3RA.js";
+//#region packages/world-runtime/src/behaviours/physics/CylinderCollider.ts
 var CylinderCollider = class extends Collider {
 	type = "Cylinder";
 	/**

package/dist/{FpsCameraController-CuYDbMHJ.js → FpsCameraController-2GNWJM5D.js}

@@ -1,5 +1,5 @@
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/controls/FpsCameraController.ts
+//#region packages/world-runtime/src/behaviours/controls/FpsCameraController.ts
 var FpsCameraController = class extends Object3DBehaviour {
 	sensitivity = .002;
 	mobileSensitivity = .006;

package/dist/{MeshInstansing-CSd1gjpu.js → MeshInstansing-Bxij0Yc9.js}

@@ -1,6 +1,6 @@
 import * as THREE from "three/webgpu";
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/utils/MeshInstansing.ts
+//#region packages/world-runtime/src/behaviours/utils/MeshInstansing.ts
 var MeshInstansing = class MeshInstansing extends Object3DBehaviour {
 	static _totalInstance = 0;
 	geometry = null;

package/dist/{PointerLockCameraControls-Cq0m2NLS.js → PointerLockCameraControls-DIK3cVmo.js}

@@ -1,6 +1,6 @@
 import * as THREE from "three/webgpu";
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/controls/PointerLockCameraControls.ts
+//#region packages/world-runtime/src/behaviours/controls/PointerLockCameraControls.ts
 var _euler = new THREE.Euler(0, 0, 0, "YXZ");
 var _vector = new THREE.Vector3();
 var _MOUSE_SENSITIVITY = .002;

package/dist/{RapierDebugRenderer-BSsFENi2.js → RapierDebugRenderer-BQy_m-3C.js}

@@ -1,5 +1,5 @@
 import * as THREE from "three/webgpu";
-//#region src/modules/physics/RapierDebugRenderer.ts
+//#region packages/world-runtime/src/modules/physics/RapierDebugRenderer.ts
 /**
 * Draws rapier colliders as lines. Not a ctx module: it lives inside
 * `RapierPhysics` (`enableDebug`/`disableDebug`) and is pulled dynamically —

package/dist/{RapierFpsPlayerController-By_mnB5m.js → RapierFpsPlayerController-DthD8dw9.js}

@@ -1,6 +1,6 @@
 import * as THREE from "three/webgpu";
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/physics/RapierFpsPlayerController.ts
+//#region packages/world-runtime/src/behaviours/physics/RapierFpsPlayerController.ts
 var RapierFpsPlayerController = class extends Object3DBehaviour {
 	halfHeight = .85;
 	radius = .5;

package/dist/{RapierPhysics-C22OXUaE.js → RapierPhysics-yrsRPFS3.js}

@@ -1,6 +1,6 @@
-import { a as LibId } from "./lib-registry-B-NnzKUx.js";
+import { a as LibId } from "./lib-registry-CPwXvdYs.js";
 import { ContextModule, ThreeContextEvents, defineProps, readOnly } from "three-start";
-//#region src/modules/physics/RapierPhysics.ts
+//#region packages/world-runtime/src/modules/physics/RapierPhysics.ts
 var RapierPhysics = class RapierPhysics extends ContextModule {
 	isRapierPhysics;
 	api;
@@ -53,7 +53,7 @@ var RapierPhysics = class RapierPhysics extends ContextModule {
 	}
 	/** Turn on collider debug drawing; the renderer is fetched on demand. */
 	async enableDebug() {
-		this._debug ??= new (await (import("./RapierDebugRenderer-BSsFENi2.js"))).RapierDebugRenderer(this.ctx, this);
+		this._debug ??= new (await (import("./RapierDebugRenderer-BQy_m-3C.js"))).RapierDebugRenderer(this.ctx, this);
 		this._debug.start();
 	}
 	disableDebug() {

package/dist/{Rigidbody-BHRxJKXd.js → Rigidbody-DLhN8ddv.js}

@@ -12,7 +12,7 @@ var __exportAll = (all, no_symbols) => {
 	return target;
 };
 //#endregion
-//#region src/behaviours/physics/Rigidbody.ts
+//#region packages/world-runtime/src/behaviours/physics/Rigidbody.ts
 var Rigidbody_exports = /* @__PURE__ */ __exportAll({ default: () => Rigidbody });
 /**
 * @see {@link https://github.com/vladkrutenyuk/three-kvy-core/blob/main/src/addons/Rigidbody.ts | Source}

package/dist/{ScalingToFro-CmXQHfR5.js → ScalingToFro-BD-E5-uR.js}

@@ -1,5 +1,5 @@
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/animation/ScalingToFro.ts
+//#region packages/world-runtime/src/behaviours/animation/ScalingToFro.ts
 var ScalingToFro = class extends Object3DBehaviour {
 	scale = 1;
 	max = 2;

package/dist/{SightInteractableArea-C7xBqoQo.js → SightInteractableArea-DrqyB41W.js}

@@ -1,6 +1,6 @@
 import * as THREE from "three/webgpu";
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/player/SightInteractableArea.ts
+//#region packages/world-runtime/src/behaviours/player/SightInteractableArea.ts
 var raycaster = new THREE.Raycaster();
 var SightInteractableArea = class SightInteractableArea extends Object3DBehaviour {
 	static _CURRENT = null;

package/dist/{SimpleWASDMovement-BYu0AFeG.js → SimpleWASDMovement-C2m53YYH.js}

@@ -1,5 +1,5 @@
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/controls/SimpleWASDMovement.ts
+//#region packages/world-runtime/src/behaviours/controls/SimpleWASDMovement.ts
 var SimpleWASDMovement = class extends Object3DBehaviour {
 	speed = 4;
 	onBeforeRender() {

package/dist/{Spinning-DDhlLF3g.js → Spinning-sgUhHld8.js}

@@ -1,5 +1,5 @@
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/animation/Spinning.ts
+//#region packages/world-runtime/src/behaviours/animation/Spinning.ts
 var Spinning = class extends Object3DBehaviour {
 	speed = 5;
 	onBeforeRender() {

package/dist/{StartAnimation-BbY1HgSj.js → StartAnimation-B9eomOS2.js}

@@ -1,6 +1,6 @@
 import * as THREE from "three/webgpu";
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/animation/StartAnimation.ts
+//#region packages/world-runtime/src/behaviours/animation/StartAnimation.ts
 var StartAnimation = class extends Object3DBehaviour {
 	mixer;
 	_action;

package/dist/{TrimeshCollider-CGirnNOf.js → TrimeshCollider-7dIs_xtZ.js}

@@ -1,5 +1,5 @@
 import { Object3DBehaviour } from "three-start";
-//#region src/behaviours/physics/TrimeshCollider.ts
+//#region packages/world-runtime/src/behaviours/physics/TrimeshCollider.ts
 var TrimeshCollider = class extends Object3DBehaviour {
 	recursive = false;
 	_detach;

package/dist/addons/lib-registry.d.ts

@@ -30,7 +30,8 @@ export declare enum LibId {
     Stats = "stats",
     Rapier = "rapier",
     Css2d = "css2d",
-    Css3d = "css3d"
+    Css3d = "css3d",
+    OrbitControls = "orbitControls"
 }
 export interface LibDescriptor {
     readonly id: LibId;

package/dist/{chat.module-descriptor-BMy5jpOU.js → chat.module-descriptor-BTsep-Kq.js}

@@ -1,4 +1,4 @@
-//#region src/modules/optional-module-descriptor.ts
+//#region packages/world-runtime/src/modules/optional-module-descriptor.ts
 /**
 * Keys of the pluggable modules — the same keys as in
 * `settings.addons.json → modules`. Core modules (`addons`/`env`/`html`/`input`/
@@ -11,7 +11,7 @@ var OptionalModuleId = /* @__PURE__ */ function(OptionalModuleId) {
 }({});
 var OPTIONAL_MODULE_IDS = Object.values(OptionalModuleId);
 //#endregion
-//#region src/modules/chat/chat.module-descriptor.ts
+//#region packages/world-runtime/src/modules/chat/chat.module-descriptor.ts
 /** `Slash` opens the chat with a "/" already typed — the Minecraft command gesture. */
 var CHAT_COMMAND_KEY = "Slash";
 var CHAT_INPUT_MODES = ["always", "toggle"];
@@ -49,7 +49,7 @@ var chatModuleDescriptor = {
 	normalize: (raw) => normalizeChat(raw),
 	defaultConfig: () => ({ ...DEFAULTS }),
 	create: async (config) => {
-		const { ChatModule } = await import("./ChatModule-DzNY_v-3.js");
+		const { ChatModule } = await import("./ChatModule-2tiWS_Yr.js");
 		return new ChatModule(config);
 	},
 	schema: {

package/dist/{get-scale-from-obj-bFMquHMV.js → get-scale-from-obj-B7JlVPni.js}

@@ -1,5 +1,5 @@
 import * as THREE from "three/webgpu";
-//#region src/behaviours/physics/get-scale-from-obj.ts
+//#region packages/world-runtime/src/behaviours/physics/get-scale-from-obj.ts
 var _hrScale = {
 	radius: 1,
 	halfHeight: 1

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as OPTIONAL_MODULE_IDS, i as normalizeChat, n as CHAT_INPUT_MODES, o as OptionalModuleId, r as chatModuleDescriptor } from "./chat.module-descriptor-BMy5jpOU.js";
-import { a as LibId, c as libByRequireKey, i as LIB_IDS, n as LIBS, o as OPTIONAL_LIB_DESCRIPTORS, r as LIB_DESCRIPTORS, s as OPTIONAL_LIB_IDS, t as BUILTIN_LIB_DESCRIPTORS } from "./lib-registry-B-NnzKUx.js";
-import { n as getRadiusScale, t as getHalfheightRadiusScale } from "./get-scale-from-obj-bFMquHMV.js";
+import { a as OPTIONAL_MODULE_IDS, i as normalizeChat, n as CHAT_INPUT_MODES, o as OptionalModuleId, r as chatModuleDescriptor } from "./chat.module-descriptor-BTsep-Kq.js";
+import { a as LibId, c as libByRequireKey, i as LIB_IDS, n as LIBS, o as OPTIONAL_LIB_DESCRIPTORS, r as LIB_DESCRIPTORS, s as OPTIONAL_LIB_IDS, t as BUILTIN_LIB_DESCRIPTORS } from "./lib-registry-CPwXvdYs.js";
+import { n as getRadiusScale, t as getHalfheightRadiusScale } from "./get-scale-from-obj-B7JlVPni.js";
 import * as THREE from "three/webgpu";
 import { BufferGeometryLoader, LoadingManager, TextureLoader } from "three/webgpu";
 import * as ThreeStartNS from "three-start";
@@ -15,7 +15,7 @@ import { clone } from "three/examples/jsm/utils/SkeletonUtils.js";
 import EventEmitter from "eventemitter3";
 import * as nanostores from "nanostores";
 import { atom } from "nanostores";
-//#region src/world-events.ts
+//#region packages/world-runtime/src/world-events.ts
 /**
 * World lifecycle events, emitted on `game.emitter` (`world.events` in scripts)
 * during classic-load. The entry script runs BEFORE them (step 9) — subscriptions
@@ -31,7 +31,7 @@ var WorldEvent = /* @__PURE__ */ function(WorldEvent) {
 	return WorldEvent;
 }({});
 //#endregion
-//#region src/World.ts
+//#region packages/world-runtime/src/World.ts
 /**
 * A loaded world is a three-start app with the scene already assembled.
 * Mounting and starting are manual: `mount(container)` attaches the canvas and
@@ -66,7 +66,7 @@ var World = class extends ThreeStart {
 	}
 };
 //#endregion
-//#region src/utils/lazy.ts
+//#region packages/world-runtime/src/utils/lazy.ts
 /**
 * Object that forwards every access to `resolve()`. For script globals that are
 * shortcuts into something created later (`modules` → `ctx.modules`): the script
@@ -100,7 +100,7 @@ function lazy(factory) {
 	} };
 }
 //#endregion
-//#region src/resources/loaders.ts
+//#region packages/world-runtime/src/resources/loaders.ts
 var LOADING_MANAGER = new LoadingManager();
 LOADING_MANAGER.onError = (url) => {
 	console.error(`Loading asset failed: ${url}`);
@@ -174,7 +174,7 @@ var AssetLoaders = {
 	})
 };
 //#endregion
-//#region src/rendering/renderer-apply.ts
+//#region packages/world-runtime/src/rendering/renderer-apply.ts
 var SHADOW_MAP_TYPES$1 = {
 	Basic: THREE.BasicShadowMap,
 	PCF: THREE.PCFShadowMap,
@@ -210,7 +210,7 @@ function applyRendererConfig(renderer, cfg) {
 	renderer.setPixelRatio(window.devicePixelRatio * pixelResolution);
 }
 //#endregion
-//#region src/rendering/SceneBloom.ts
+//#region packages/world-runtime/src/rendering/SceneBloom.ts
 /** BloomNode loads as a chunk only when bloom is enabled. */
 var lazyBloomModule = lazy(() => import("three/addons/tsl/display/BloomNode.js"));
 /**
@@ -296,7 +296,7 @@ function finiteOr(value, fallback) {
 	return typeof value === "number" && Number.isFinite(value) ? value : fallback;
 }
 //#endregion
-//#region src/modules/controls/KeyboardControlsDriver.ts
+//#region packages/world-runtime/src/modules/controls/KeyboardControlsDriver.ts
 /** A diagonal must not be faster than a straight line. */
 var DIAGONAL = Math.SQRT1_2;
 /**
@@ -328,7 +328,7 @@ var KeyboardControlsDriver = class {
 	}
 };
 //#endregion
-//#region src/modules/controls/ControlsModule.ts
+//#region packages/world-runtime/src/modules/controls/ControlsModule.ts
 /**
 * The player's movement intent — what they want to do, whatever the hardware is.
 * Input sources register as drivers (`addDriver`); the module polls them once a
@@ -441,8 +441,8 @@ var ControlsModule = class extends ContextModule {
 	}
 };
 //#endregion
-//#region src/behaviours/physics/_required-patch.ts
-var lazyRapierPhysicsModule = lazy(async () => (await import("./RapierPhysics-C22OXUaE.js")).default);
+//#region packages/world-runtime/src/behaviours/physics/_required-patch.ts
+var lazyRapierPhysicsModule = lazy(async () => (await import("./RapierPhysics-yrsRPFS3.js")).default);
 /** The only place the physics module is created — called by the registry
 *  descriptor. The module itself takes rapier from `ctx.modules.addons` on awake. */
 async function createRapierPhysicsModule(config) {
@@ -468,7 +468,7 @@ async function applyRapierPhysicsPatch(starter) {
 	starter.addModules({ rapier: module });
 }
 //#endregion
-//#region src/modules/physics/physics.module-descriptor.ts
+//#region packages/world-runtime/src/modules/physics/physics.module-descriptor.ts
 var PHYSICS_ENGINES = ["rapier"];
 /** Physics defaults: the rapier engine, debug off. */
 function normalizePhysics(value) {
@@ -484,6 +484,7 @@ function normalizePhysics(value) {
 }
 var physicsModuleDescriptor = {
 	id: OptionalModuleId.Physics,
+	ctxKey: "rapier",
 	normalize: (raw) => normalizePhysics(raw),
 	defaultConfig: () => ({
 		engine: "rapier",
@@ -521,7 +522,7 @@ var physicsModuleDescriptor = {
 	}
 };
 //#endregion
-//#region src/modules/optional-modules.ts
+//#region packages/world-runtime/src/modules/optional-modules.ts
 /**
 * Table of contents for the world's pluggable modules: what can be enabled from
 * `settings.addons.json → modules`. The descriptors themselves live next to
@@ -538,7 +539,7 @@ function getOptionalModuleDescriptor(id) {
 	return descriptor;
 }
 //#endregion
-//#region src/modules/is-mobile-device.ts
+//#region packages/world-runtime/src/modules/is-mobile-device.ts
 function isMobileDevice() {
 	if (typeof navigator === "undefined" || typeof window === "undefined") return false;
 	const ua = navigator.userAgent || navigator.vendor || window.opera;
@@ -549,7 +550,7 @@ function isMobileDevice() {
 	return "ontouchstart" in window || navigator.maxTouchPoints && navigator.maxTouchPoints > 0 || navigator.msMaxTouchPoints > 0;
 }
 //#endregion
-//#region src/modules/EnvModule.ts
+//#region packages/world-runtime/src/modules/EnvModule.ts
 var EnvModule = class extends ContextModule {
 	mode;
 	dev;
@@ -566,7 +567,7 @@ var EnvModule = class extends ContextModule {
 	}
 };
 //#endregion
-//#region src/modules/HtmlHudModule.ts
+//#region packages/world-runtime/src/modules/HtmlHudModule.ts
 var { div } = van.tags;
 var LAYER_STYLE = "position:fixed;inset:0;pointer-events:none;";
 var HtmlHudModule = class extends ContextModule {
@@ -622,7 +623,7 @@ var HtmlHudModule = class extends ContextModule {
 	};
 };
 //#endregion
-//#region src/modules/InputSystemModule.ts
+//#region packages/world-runtime/src/modules/InputSystemModule.ts
 var InputSystemModule = class extends ContextModule {
 	_dom;
 	_keys = /* @__PURE__ */ new Set();
@@ -874,7 +875,7 @@ function isUiKeyboardTarget(target) {
 	}
 }
 //#endregion
-//#region src/modules/SoundsModule.ts
+//#region packages/world-runtime/src/modules/SoundsModule.ts
 var SoundsModule = class extends ContextModule {
 	global = Howler;
 	/** three-start ContextModule has no onDestroy; teardown is explicit. */
@@ -883,7 +884,7 @@ var SoundsModule = class extends ContextModule {
 	}
 };
 //#endregion
-//#region src/modules/UtilsModule.ts
+//#region packages/world-runtime/src/modules/UtilsModule.ts
 var UtilsModule = class extends ContextModule {
 	cloneObject3D;
 	mergeGeometries;
@@ -894,7 +895,7 @@ var UtilsModule = class extends ContextModule {
 	}
 };
 //#endregion
-//#region src/modules/index.ts
+//#region packages/world-runtime/src/modules/index.ts
 /**
 * Assembles the world's ctx modules: core ones always, pluggable ones per config.
 * Pluggable classes are pulled dynamically, so a disabled module never reaches
@@ -919,7 +920,7 @@ async function createWorldModules(mode = "prod", options) {
 		const config = descriptor.normalize(options.modules?.[descriptor.id]);
 		if (!config) continue;
 		try {
-			modules[descriptor.id] = await descriptor.create(config);
+			modules[descriptor.ctxKey ?? descriptor.id] = await descriptor.create(config);
 		} catch (error) {
 			console.error(`[modules] failed to create "${descriptor.id}"`, error);
 		}
@@ -927,100 +928,100 @@ async function createWorldModules(mode = "prod", options) {
 	return modules;
 }
 //#endregion
-//#region src/behaviours/registry.ts
+//#region packages/world-runtime/src/behaviours/registry.ts
 var entries = [
 	{
 		uuid: "spinning",
 		name: "Spinning",
-		load: () => loadDefault(import("./Spinning-DDhlLF3g.js"))
+		load: () => loadDefault(import("./Spinning-sgUhHld8.js"))
 	},
 	{
 		uuid: "scalingtofro",
 		name: "ScalingToFro",
-		load: () => loadDefault(import("./ScalingToFro-CmXQHfR5.js"))
+		load: () => loadDefault(import("./ScalingToFro-BD-E5-uR.js"))
 	},
 	{
 		uuid: "startanim",
 		name: "StartAnimation",
-		load: () => loadDefault(import("./StartAnimation-BbY1HgSj.js"))
+		load: () => loadDefault(import("./StartAnimation-B9eomOS2.js"))
 	},
 	{
 		uuid: "pointerlockcameracontrols",
 		name: "PointerLockCameraController",
-		load: () => loadDefault(import("./PointerLockCameraControls-Cq0m2NLS.js"))
+		load: () => loadDefault(import("./PointerLockCameraControls-DIK3cVmo.js"))
 	},
 	{
 		uuid: "simplewasdmovement",
 		name: "SimpleWASDMovement",
-		load: () => loadDefault(import("./SimpleWASDMovement-BYu0AFeG.js"))
+		load: () => loadDefault(import("./SimpleWASDMovement-C2m53YYH.js"))
 	},
 	{
 		uuid: "fpscameracontroller",
 		name: "FpsCameraController",
-		load: () => loadDefault(import("./FpsCameraController-CuYDbMHJ.js"))
+		load: () => loadDefault(import("./FpsCameraController-2GNWJM5D.js"))
 	},
 	{
 		uuid: "sightinteractablearea",
 		name: "SightInteractableArea",
-		load: () => loadDefault(import("./SightInteractableArea-C7xBqoQo.js"))
+		load: () => loadDefault(import("./SightInteractableArea-DrqyB41W.js"))
 	},
 	{
 		uuid: "meshinstansing",
 		name: "MeshInstansing",
-		load: () => loadDefault(import("./MeshInstansing-CSd1gjpu.js"))
+		load: () => loadDefault(import("./MeshInstansing-Bxij0Yc9.js"))
 	},
 	{
 		uuid: "rrb",
 		name: "Rigidbody",
-		load: () => loadDefault(import("./Rigidbody-BHRxJKXd.js").then((n) => n.n)),
+		load: () => loadDefault(import("./Rigidbody-DLhN8ddv.js").then((n) => n.n)),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapierballcol",
 		name: "BallCollider",
-		load: () => loadDefault(import("./BallCollider-DdxrnexK.js")),
+		load: () => loadDefault(import("./BallCollider-3L5vOrcL.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapiercapscol",
 		name: "CapsuleCollider",
-		load: () => loadDefault(import("./CapsuleCollider-XlGZqg_O.js")),
+		load: () => loadDefault(import("./CapsuleCollider-CBTsR-Ys.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapierconecol",
 		name: "ConeCollider",
-		load: () => loadDefault(import("./ConeCollider-CQfGphDa.js")),
+		load: () => loadDefault(import("./ConeCollider-C3XU3Y9X.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapierconvxcol",
 		name: "ConvexMeshCollider",
-		load: () => loadDefault(import("./ConvexMeshCollider-0Q2u7QAL.js")),
+		load: () => loadDefault(import("./ConvexMeshCollider-DzNV4HTO.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapiercubcol",
 		name: "CuboidCollider",
-		load: () => loadDefault(import("./CuboidCollider-Cm7kKRMA.js")),
+		load: () => loadDefault(import("./CuboidCollider-Dp1DZoFM.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapiercylcol",
 		name: "CylinderCollider",
-		load: () => loadDefault(import("./CylinderCollider-P2oZeEyb.js")),
+		load: () => loadDefault(import("./CylinderCollider-C0h_nhB5.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapiertricol",
 		name: "TrimeshCollider",
-		load: () => loadDefault(import("./TrimeshCollider-CGirnNOf.js")),
+		load: () => loadDefault(import("./TrimeshCollider-7dIs_xtZ.js")),
 		requiredPatch: rapierPhysicsPatch
 	},
 	{
 		uuid: "rapierfpsplayercontroller",
 		name: "RapierFpsPlayerController",
-		load: () => loadDefault(import("./RapierFpsPlayerController-By_mnB5m.js")),
+		load: () => loadDefault(import("./RapierFpsPlayerController-DthD8dw9.js")),
 		requiredPatch: rapierPhysicsPatch
 	}
 ];
@@ -1034,7 +1035,7 @@ async function loadDefault(module) {
 	return (await module).default;
 }
 //#endregion
-//#region src/resources/font.ts
+//#region packages/world-runtime/src/resources/font.ts
 var FORMAT_BY_MIME = {
 	"font/ttf": "truetype",
 	"font/otf": "opentype",
@@ -1096,7 +1097,7 @@ function createFont(url, family, mime, name) {
 	return source;
 }
 //#endregion
-//#region src/addons/builtin-libs.ts
+//#region packages/world-runtime/src/addons/builtin-libs.ts
 /**
 * Libraries the runtime bundles itself: `require("<key>")` hands these back in
 * every world, no config and no importer involved. Metadata (keys, labels) is
@@ -1123,7 +1124,7 @@ var BUILTIN_GLOBALS = {
 	van
 };
 //#endregion
-//#region src/addons/required-libs.ts
+//#region packages/world-runtime/src/addons/required-libs.ts
 /**
 * Libs the world needs beyond what `libs` lists: an enabled module or a built-in
 * behaviour on the scene declares them itself (`requiredLibs`), so physics keeps
@@ -1146,7 +1147,7 @@ function collectRequiredLibs(addons, usedBuiltinUuids = []) {
 	return [...required];
 }
 //#endregion
-//#region src/addons/AddonsRuntime.ts
+//#region packages/world-runtime/src/addons/AddonsRuntime.ts
 /**
 * External dependencies of the world: libs and external scripts. Built-in libs
 * are registered right away (the runtime bundles them), optional ones are loaded
@@ -1253,7 +1254,7 @@ function unwrapLib(id, module) {
 	return module.default ?? module;
 }
 //#endregion
-//#region src/world-stores.ts
+//#region packages/world-runtime/src/world-stores.ts
 /**
 * Shared reactive key-value state of a world (`world.stores` in scripts) — the
 * state counterpart of the `world.events` bus. Stores are created lazily on
@@ -1314,7 +1315,7 @@ var WorldStores = class {
 	}
 };
 //#endregion
-//#region src/WorldRuntime.ts
+//#region packages/world-runtime/src/WorldRuntime.ts
 /**
 * Owner of the world's runtime state: assets, script execution, ctx access.
 * The only object the generated code receives.
@@ -1576,10 +1577,10 @@ function isAbsoluteUrl(url) {
 	return /^(?:[a-z]+:)?\/\//i.test(url) || url.startsWith("data:");
 }
 //#endregion
-//#region src/version.gen.ts
-var RUNTIME_VERSION = "0.6.2";
+//#region packages/world-runtime/src/version.gen.ts
+var RUNTIME_VERSION = "0.6.3";
 //#endregion
-//#region src/version.ts
+//#region packages/world-runtime/src/version.ts
 /**
 * Format version of the generated world. The codegen stamps it into the artifact,
 * the runtime checks it on load. A breaking format change = package major bump.
@@ -1593,7 +1594,7 @@ function assertFormatVersion(version) {
 	throw new Error(`@kvyverse/world-runtime: world format v${version} is not supported by runtime (expected v1). Re-export the world or pin a matching runtime version.`);
 }
 //#endregion
-//#region src/bootstrap.ts
+//#region packages/world-runtime/src/bootstrap.ts
 /**
 * World assembly order. The only place where it is fixed: the artifact supplies
 * the data and steps, the runtime owns the sequence. Mirrors the game's
@@ -1662,7 +1663,7 @@ async function createWorld(definition, runtime) {
 	return world;
 }
 //#endregion
-//#region src/define-world.ts
+//#region packages/world-runtime/src/define-world.ts
 /**
 * Entry point of the generated artifact: world definition → public `loadWorld`.
 * The codegen prints `export const { loadWorld } = defineWorld({ ... })`.
@@ -1671,7 +1672,7 @@ function defineWorld(definition) {
 	return { loadWorld: (options = {}) => bootstrapWorld(definition, options) };
 }
 //#endregion
-//#region src/values.ts
+//#region packages/world-runtime/src/values.ts
 /**
 * Writes a color into an object field, creating a `Color` if the slot is empty.
 * Mirrors the `$C` branch of `applyValues` — needed by generated code for fields
@@ -1688,7 +1689,7 @@ function setColor(target, key, hex) {
 	holder[key] = new THREE.Color(hex);
 }
 //#endregion
-//#region src/resources/default-resources.ts
+//#region packages/world-runtime/src/resources/default-resources.ts
 /**
 * Built-in engine resources with fixed uuids: world values reference them via
 * a regular ref (`{$A:"6"}`), so the identifiers must never change.
@@ -1759,7 +1760,7 @@ function isDefaultResourceId(uuid) {
 	return DEFAULT_RESOURCE_IDS.includes(uuid);
 }
 //#endregion
-//#region src/resources/texture.ts
+//#region packages/world-runtime/src/resources/texture.ts
 /**
 * World texture defaults: clamp wrapping switches to repeat, color space
 * is sRGB. Identical in the editor, the game and the exported world.
@@ -1777,7 +1778,7 @@ async function loadTexture(url, name) {
 	return texture;
 }
 //#endregion
-//#region src/resources/model.ts
+//#region packages/world-runtime/src/resources/model.ts
 /** Parses model bytes into a hierarchy. `data`: ArrayBuffer, for obj — text. */
 async function parseModel(data, format, name) {
 	let root;
@@ -1846,7 +1847,7 @@ function collectModelSubResources(root) {
 	};
 }
 //#endregion
-//#region src/resources/hdr.ts
+//#region packages/world-runtime/src/resources/hdr.ts
 /** Parses hdr/exr into a `DataTexture` with environment defaults (equirect, no mipmaps). */
 async function parseHdr(data, format, name) {
 	let texture;
@@ -1874,7 +1875,7 @@ async function loadHdr(url, format, name) {
 	return parseHdr(await response.arrayBuffer(), format, name);
 }
 //#endregion
-//#region src/resources/geometry.ts
+//#region packages/world-runtime/src/resources/geometry.ts
 /** Geometry from our json format (`BufferGeometry.toJSON`). */
 function parseGeometryJson(json, name) {
 	const geometry = AssetLoaders.bufferGeometry.get().parse(json);
@@ -1888,7 +1889,7 @@ async function loadGeometry(url, name) {
 	return parseGeometryJson(await response.json(), name);
 }
 //#endregion
-//#region src/resources/audio.ts
+//#region packages/world-runtime/src/resources/audio.ts
 /**
 * Audio asset source: a `Howl` with identity — this is what scripts get
 * from `require("/Sounds/...")`.
@@ -1921,7 +1922,7 @@ function createAudio(url, format, name) {
 	});
 }
 //#endregion
-//#region src/resources/video.ts
+//#region packages/world-runtime/src/resources/video.ts
 /**
 * Video asset source: a `<video>` with identity — this is what scripts get
 * from `require("/Videos/...")` (and `THREE.VideoTexture` from `element`).
@@ -1978,7 +1979,7 @@ async function createVideo(url, name) {
 	return source;
 }
 //#endregion
-//#region src/rendering/tsl-node.ts
+//#region packages/world-runtime/src/rendering/tsl-node.ts
 /**
 * World TSL node: the built graph node + its uniform nodes. This is what
 * `require("/Shaders/....tsl")` returns, so the method set matches the editor's
@@ -2021,7 +2022,7 @@ function createTslNode(uniforms, build, name) {
 	return new TslNode(uniforms, build, name);
 }
 //#endregion
-//#region src/rendering/tsl-uniforms.ts
+//#region packages/world-runtime/src/rendering/tsl-uniforms.ts
 var UNIFORM_TYPES = [
 	"float",
 	"int",
@@ -2082,10 +2083,10 @@ var UNIFORM_DEFAULTS = {
 	texture: () => getDefaultResource(DefaultResourceId.Texture)
 };
 //#endregion
-//#region src/addons/externals.ts
+//#region packages/world-runtime/src/addons/externals.ts
 var EXTERNAL_TYPES = ["umd", "module"];
 //#endregion
-//#region src/rendering/renderer-options.ts
+//#region packages/world-runtime/src/rendering/renderer-options.ts
 /**
 * String names for renderer options set as words in the config and mapped to
 * THREE constants at runtime (game). Single source for the JSON schema

package/dist/{lib-registry-B-NnzKUx.js → lib-registry-CPwXvdYs.js}

@@ -1,4 +1,4 @@
-//#region src/addons/lib-registry.ts
+//#region packages/world-runtime/src/addons/lib-registry.ts
 /**
 * Registry of the libraries scripts can `require`. One entry describes one
 * library; the flags say how it gets into the world:
@@ -32,6 +32,7 @@ var LibId = /* @__PURE__ */ function(LibId) {
 	LibId["Rapier"] = "rapier";
 	LibId["Css2d"] = "css2d";
 	LibId["Css3d"] = "css3d";
+	LibId["OrbitControls"] = "orbitControls";
 	return LibId;
 }({});
 var LIBS = {
@@ -126,6 +127,12 @@ var LIBS = {
 		requireKey: "three/addons/renderers/CSS3DRenderer.js",
 		packageName: "three",
 		label: "CSS3DRenderer (DOM elements in 3d)"
+	},
+	["orbitControls"]: {
+		id: "orbitControls",
+		requireKey: "three/addons/controls/OrbitControls.js",
+		packageName: "three",
+		label: "OrbitControls (camera orbiting a target)"
 	}
 };
 var LIB_IDS = Object.values(LibId);

package/dist/modules/optional-module-descriptor.d.ts

@@ -1,3 +1,4 @@
+import type { KvyverseModules } from "./registry";
 import type { ContextModule } from "three-start";
 import type { LibId } from "../addons/lib-registry";
 /**
@@ -22,6 +23,12 @@ export type ModuleJsonSchema = Record<string, unknown>;
  */
 export interface OptionalModuleDescriptor<TConfig = unknown> {
     id: OptionalModuleId;
+    /**
+     * Key in `ctx.modules`, when it differs from the config key `id` (physics is
+     * configured as `modules.physics` but lives on `ctx.modules.rapier`, named
+     * after the engine). Defaults to `id`.
+     */
+    ctxKey?: keyof KvyverseModules;
     /** Config value → normalized config; `null` means the module is off. */
     normalize: (raw: unknown) => TConfig | null;
     /** Config for an on-demand enable (a behaviour pulled the module in without config). */

package/dist/version.gen.d.ts

@@ -1 +1 @@
-export declare const RUNTIME_VERSION = "0.6.2";
+export declare const RUNTIME_VERSION = "0.6.3";

package/package.json

@@ -1,9 +1,9 @@
 {
 	"name": "@kvyverse/world-runtime",
-	"version": "0.6.2",
+	"version": "0.6.3",
 	"description": "Runtime for worlds exported from the Kvyverse platform for self-hosting",
 	"license": "SEE LICENSE IN LICENSE.md",
-	"author": "Vladislav Kruteniuk",
+	"author": "Kvyverse, Inc.",
 	"homepage": "https://kvyverse.com",
 	"type": "module",
 	"main": "./dist/index.js",