@kvyverse/world-runtime 0.4.2 → 0.6.0

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

@@ -17,7 +17,7 @@ var PointerLockCameraControls = class extends Object3DBehaviour {
 	_detach;
 	onEnable() {
 		const env = this.modules.env;
-		this._canBeLocked = env.prod && !env.isMobile;
+		this._canBeLocked = !env.dev && !env.isMobile;
 		this._isMobile = env.isMobile;
 		const dom = this.ctx.renderer.domElement;
 		const lock = () => {

package/dist/WorldRuntime.d.ts

@@ -26,6 +26,7 @@ export declare class WorldRuntime implements RuntimeApi {
     /** Reverse index for `getUrl(resource)` — play mode resolves objects too. */
     private readonly _pathByResource;
     private _ctx;
+    private _starter;
     private _bloom;
     private _scriptContext;
     constructor(definition: RuntimeDefinitionSlice, options: LoadWorldOptions);
@@ -35,6 +36,8 @@ export declare class WorldRuntime implements RuntimeApi {
     get ctx(): ThreeContext;
     /** @internal Set by bootstrap. */
     setContext(ctx: ThreeContext): void;
+    /** @internal Set by bootstrap — backs `world.addModules` (register before start). */
+    setStarter(starter: ThreeStart): void;
     /** @internal World bloom, if enabled in the renderer config. */
     setBloom(bloom: SceneBloom): void;
     /** @internal Libs (config + required by modules/behaviours) and externals. */

package/dist/index.js

@@ -551,15 +551,17 @@ function isMobileDevice() {
 //#endregion
 //#region packages/world-runtime/src/modules/EnvModule.ts
 var EnvModule = class extends ContextModule {
-	dev = true;
-	prod = true;
 	mode;
+	dev;
+	prod;
+	selfHosted;
 	isMobile;
 	constructor(mode) {
 		super();
 		this.mode = mode;
 		this.dev = mode === "dev";
 		this.prod = mode === "prod";
+		this.selfHosted = mode === "selfhosted";
 		this.isMobile = isMobileDevice();
 	}
 };
@@ -945,7 +947,7 @@ var entries = [
 	{
 		uuid: "pointerlockcameracontrols",
 		name: "PointerLockCameraController",
-		load: () => loadDefault(import("./PointerLockCameraControls-DYxxMeSw.js"))
+		load: () => loadDefault(import("./PointerLockCameraControls-DIK3cVmo.js"))
 	},
 	{
 		uuid: "simplewasdmovement",
@@ -1332,6 +1334,7 @@ var WorldRuntime = class {
 	/** Reverse index for `getUrl(resource)` — play mode resolves objects too. */
 	_pathByResource = /* @__PURE__ */ new Map();
 	_ctx = null;
+	_starter = null;
 	_bloom = null;
 	_scriptContext = null;
 	constructor(definition, options) {
@@ -1352,6 +1355,10 @@ var WorldRuntime = class {
 	setContext(ctx) {
 		this._ctx = ctx;
 	}
+	/** @internal Set by bootstrap — backs `world.addModules` (register before start). */
+	setStarter(starter) {
+		this._starter = starter;
+	}
 	/** @internal World bloom, if enabled in the renderer config. */
 	setBloom(bloom) {
 		this._bloom = bloom;
@@ -1538,7 +1545,11 @@ var WorldRuntime = class {
 				stores: this.stores,
 				rendering: { get bloom() {
 					return runtime.bloomApi;
-				} }
+				} },
+				addModules: (modules) => {
+					if (!runtime._starter) throw new Error("world.addModules is only available in the entry script (main.ts), before the world starts.");
+					runtime._starter.addModules(modules);
+				}
 			},
 			modules: lazyProxy(() => runtime.ctx.modules),
 			require: this.require,
@@ -1566,7 +1577,7 @@ function isAbsoluteUrl(url) {
 }
 //#endregion
 //#region packages/world-runtime/src/version.gen.ts
-var RUNTIME_VERSION = "0.4.2";
+var RUNTIME_VERSION = "0.6.0";
 //#endregion
 //#region packages/world-runtime/src/version.ts
 /**
@@ -1604,6 +1615,7 @@ async function bootstrapWorld(definition, options) {
 	runtime.reportProgress("Initializing 3D context");
 	const world = await createWorld(definition, runtime);
 	runtime.setContext(world.ctx);
+	runtime.setStarter(world);
 	await runtime.applyRequiredPatches(world);
 	runtime.reportProgress("Applying scene settings");
 	definition.applySceneSettings?.(runtime, world.ctx.scene);
@@ -1632,7 +1644,7 @@ async function createWorld(definition, runtime) {
 		scene: new THREE.Scene(),
 		autoInitRenderer: false
 	}, runtime);
-	world.addModules(await createWorldModules("prod", {
+	world.addModules(await createWorldModules("selfhosted", {
 		addons: runtime.addons,
 		modules: runtime.definition.addons?.modules
 	}));

package/dist/modules/EnvModule.d.ts

@@ -1,11 +1,13 @@
 import { ContextModule } from "three-start";
 import type { EnvModuleApi } from "./contracts/env.module-api";
-/** Where the world runs: `dev` — testplay from the editor, `prod` — the game. */
+/** Where the world runs: `dev` — editor testplay, `prod` — platform game,
+ *  `selfhosted` — self-hosted export. */
 export type EnvMode = EnvModuleApi["mode"];
 export declare class EnvModule extends ContextModule implements EnvModuleApi {
-    dev: boolean;
-    prod: boolean;
-    mode: EnvMode;
-    isMobile: boolean;
+    readonly mode: EnvMode;
+    readonly dev: boolean;
+    readonly prod: boolean;
+    readonly selfHosted: boolean;
+    readonly isMobile: boolean;
     constructor(mode: EnvMode);
 }

package/dist/modules/contracts/env.module-api.d.ts

@@ -1,7 +1,16 @@
-/** Public API of the `env` module — environment flags (dev/prod, mobile). */
+/**
+ * Public API of the `env` module — where the world runs. Exactly one of
+ * `dev`/`prod`/`selfHosted` is true, matching `mode`. For "any real run, not
+ * editor testplay" use `!env.dev`.
+ */
 export interface EnvModuleApi {
+    /** Editor testplay run. */
     readonly dev: boolean;
+    /** Published game on the Kvyverse platform. */
     readonly prod: boolean;
-    readonly mode: "dev" | "prod";
+    /** Self-hosted export, running outside the Kvyverse platform. */
+    readonly selfHosted: boolean;
+    /** Precise runtime context. */
+    readonly mode: "dev" | "prod" | "selfhosted";
     readonly isMobile: boolean;
 }

package/dist/version.gen.d.ts

@@ -1 +1 @@
-export declare const RUNTIME_VERSION = "0.4.2";
+export declare const RUNTIME_VERSION = "0.6.0";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kvyverse/world-runtime",
-	"version": "0.4.2",
+	"version": "0.6.0",
 	"description": "Runtime for worlds exported from the Kvyverse platform for self-hosting",
 	"license": "SEE LICENSE IN LICENSE.md",
 	"author": "Vladislav Kruteniuk",