@kvyverse/world-runtime 0.6.3 → 0.6.8

package/README.md

@@ -102,8 +102,8 @@ world.stores.set("difficulty", "hard");
   and the world format version, and refuses to load on an incompatible runtime.
   Re-export the world after a major runtime update.
 - **Not everything crosses over.** Platform features (multiplayer server, user
-  state, launcher worlds, the editor's debug overlay) stay in Kvyverse; the
-  export report lists whatever your particular world loses.
+  state, switching the page to another world, the editor's debug overlay) stay in
+  Kvyverse; the export report lists whatever your particular world loses.
 
 ## License
 

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

@@ -1,28 +1,29 @@
-import { t as CHAT_COMMAND_KEY } from "./chat.module-descriptor-BTsep-Kq.js";
+import { t as CHAT_COMMAND_KEY } from "./chat.module-descriptor-CGeOaq16.js";
 import { ContextModule, ThreeContextEvents } from "three-start";
 import van from "vanjs-core";
 //#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";
+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}\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/* 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 packages/world-runtime/src/modules/chat/ChatDom.ts
-var { button, div, form, input } = van.tags;
+var { div, input } = van.tags;
 var STYLE_ID = "kvyverse-chat-styles";
+/** How long a send waits for the keyboard to commit the typed word (ms). */
+var COMPOSITION_COMMIT_TIMEOUT = 150;
 /**
 * Chat DOM: the message feed plus the input field.
 *
-* Built to survive real devices: submit through a `<form>` (Enter/Go/Send on any
-* mobile keyboard), an IME composition guard, and lifting above the on-screen
-* keyboard via `visualViewport`. Details —
-* `./README.md`.
+* Built to survive real devices: sending on the Enter keydown (no `<form>`: a
+* sandboxed host may block form submission), an IME composition guard, and
+* lifting above the on-screen keyboard via `visualViewport`. Details — `./README.md`.
 */
 var ChatDom = class ChatDom {
 	root;
 	feed;
-	form;
 	input;
 	_options;
 	_lines = [];
-	_isComposing = false;
+	/** Timer of a send waiting for the keyboard to commit its composition. */
+	_pendingSubmit = 0;
 	_viewportRaf = 0;
 	_mounted = false;
 	constructor(options = {}) {
@@ -40,16 +41,8 @@ var ChatDom = class ChatDom {
 		this.input.spellcheck = false;
 		this.input.setAttribute("autocorrect", "off");
 		this.input.setAttribute("autocapitalize", "sentences");
-		this.form = form({
-			class: "kvy-chat__form",
-			novalidate: true
-		}, this.input, button({
-			class: "kvy-chat__submit",
-			type: "submit",
-			tabindex: "-1"
-		}, "Send"));
 		this.feed = div({ class: "kvy-chat__feed" });
-		this.root = div({ class: "kvy-chat" }, this.feed, this.form);
+		this.root = div({ class: "kvy-chat" }, this.feed, div({ class: "kvy-chat__form" }, this.input));
 	}
 	/** The focus policy is only known at runtime (mobile/desktop, canvas). */
 	setFocusPolicy(policy) {
@@ -185,10 +178,8 @@ var ChatDom = class ChatDom {
 		line.el.classList.toggle("kvy-chat__line--faded", faded);
 	}
 	_bind() {
-		this.form.addEventListener("submit", this._onSubmit);
-		this.input.addEventListener("compositionstart", this._onCompositionStart);
-		this.input.addEventListener("compositionend", this._onCompositionEnd);
 		this.input.addEventListener("beforeinput", this._onBeforeInput);
+		this.input.addEventListener("compositionend", this._onCompositionEnd);
 		this.input.addEventListener("keydown", this._onKeyDown);
 		this.input.addEventListener("keyup", this._stopPropagation);
 		this.input.addEventListener("focus", this._onFocus);
@@ -200,10 +191,9 @@ var ChatDom = class ChatDom {
 		}
 	}
 	_unbind() {
-		this.form.removeEventListener("submit", this._onSubmit);
-		this.input.removeEventListener("compositionstart", this._onCompositionStart);
-		this.input.removeEventListener("compositionend", this._onCompositionEnd);
+		this._cancelPendingSubmit();
 		this.input.removeEventListener("beforeinput", this._onBeforeInput);
+		this.input.removeEventListener("compositionend", this._onCompositionEnd);
 		this.input.removeEventListener("keydown", this._onKeyDown);
 		this.input.removeEventListener("keyup", this._stopPropagation);
 		this.input.removeEventListener("focus", this._onFocus);
@@ -218,9 +208,7 @@ var ChatDom = class ChatDom {
 			this._viewportRaf = 0;
 		}
 	}
-	_onSubmit = (e) => {
-		e.preventDefault();
-		if (this._isComposing) return;
+	_submit() {
 		const text = this.input.value.trim();
 		this.clear();
 		if (!text) return;
@@ -231,25 +219,54 @@ var ChatDom = class ChatDom {
 		}
 		this.blur();
 		this._options.returnFocusTo?.focus({ preventScroll: true });
-	};
-	_onCompositionStart = () => {
-		this._isComposing = true;
+	}
+	/**
+	* Sends now or, while the keyboard still holds the typed word as a composition
+	* (Android), once it commits the word: clearing the field under a live
+	* composition can bring the word back into it.
+	*/
+	_requestSubmit(isComposing) {
+		if (!isComposing) {
+			this._cancelPendingSubmit();
+			this._submit();
+			return;
+		}
+		if (this._pendingSubmit) return;
+		this._pendingSubmit = window.setTimeout(this._flushSubmit, COMPOSITION_COMMIT_TIMEOUT);
+	}
+	_cancelPendingSubmit() {
+		if (!this._pendingSubmit) return;
+		clearTimeout(this._pendingSubmit);
+		this._pendingSubmit = 0;
+	}
+	_flushSubmit = () => {
+		this._pendingSubmit = 0;
+		this._submit();
 	};
 	_onCompositionEnd = () => {
-		this._isComposing = false;
-	};
-	/** Some Android keyboards send no Enter keydown, only `insertLineBreak`. */
-	_onBeforeInput = (e) => {
-		if (e.inputType !== "insertLineBreak") return;
-		e.preventDefault();
-		this.form.requestSubmit();
+		if (!this._pendingSubmit) return;
+		clearTimeout(this._pendingSubmit);
+		this._pendingSubmit = window.setTimeout(this._flushSubmit, 0);
 	};
 	_onKeyDown = (e) => {
 		e.stopPropagation();
+		if (isImeProcessedKey(e)) return;
+		if (e.key === "Enter") {
+			e.preventDefault();
+			this._requestSubmit(e.isComposing);
+			return;
+		}
 		if (e.key !== "Escape") return;
 		this.blur();
 		this._options.returnFocusTo?.focus({ preventScroll: true });
 	};
+	/** Fallback for keyboards that insert a line break instead of sending Enter. */
+	_onBeforeInput = (e) => {
+		const { inputType, data, isComposing } = e;
+		if (!(inputType === "insertLineBreak" || inputType === "insertParagraph" || inputType === "insertText" && data === "\n")) return;
+		e.preventDefault();
+		this._requestSubmit(isComposing);
+	};
 	_stopPropagation = (e) => {
 		e.stopPropagation();
 	};
@@ -298,6 +315,14 @@ var ChatDom = class ChatDom {
 		document.head.append(style);
 	}
 };
+/**
+* The key went to the IME, not the page: every engine marks it with `keyCode 229`
+* (Safari even after `compositionend`). Not `isComposing`: on Android the typed word
+* is always a composition, and an Enter that reaches the page there means "send".
+*/
+function isImeProcessedKey(e) {
+	return e.keyCode === 229;
+}
 //#endregion
 //#region packages/world-runtime/src/modules/chat/ChatModule.ts
 /**

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

@@ -18,7 +18,7 @@ var SightInteractableArea = class SightInteractableArea extends Object3DBehaviou
 		this.object.getWorldPosition(this._initWorldPos);
 	}
 	onDisable() {
-		this._deactivate();
+		this._hidePrompt();
 	}
 	setRadius(r) {
 		this.radius = r;
@@ -38,10 +38,10 @@ var SightInteractableArea = class SightInteractableArea extends Object3DBehaviou
 		if (this._active === active) return;
 		this._active = active;
 		this.emit("activechanged", active);
-		if (active) this._activate();
-		else this._deactivate();
+		if (active) this._showPrompt();
+		else this._hidePrompt();
 	}
-	_activate() {
+	_showPrompt() {
 		const modules = this.modules;
 		SightInteractableArea._CURRENT = this.object.id;
 		modules.html.setCrosshair(this.hint);
@@ -50,7 +50,7 @@ var SightInteractableArea = class SightInteractableArea extends Object3DBehaviou
 			modules.html.crosshair.addEventListener("pointerdown", this._interact);
 		} else this.ctx.renderer.domElement.addEventListener("mousedown", this._interact);
 	}
-	_deactivate() {
+	_hidePrompt() {
 		const modules = this.modules;
 		if (SightInteractableArea._CURRENT === this.object.id) {
 			SightInteractableArea._CURRENT = null;
@@ -66,7 +66,7 @@ var SightInteractableArea = class SightInteractableArea extends Object3DBehaviou
 		const current = SightInteractableArea._CURRENT;
 		if (!(current === this.object.id || current === null)) return;
 		this.interactEnabled = false;
-		this._deactivate();
+		this._hidePrompt();
 		this._active = false;
 		this.emit("interaction");
 		console.log("interaction with ", this.object.name);

package/dist/addons/AddonsRuntime.d.ts

@@ -9,10 +9,9 @@ import type { AddonsConfig, WorldImports } from "./types";
  * by a module/behaviour through `requiredLibs`. Scripts reach all of them by
  * `require("<key>")`.
  *
- * This is the `addons` ctx module, but it also works without a ctx: launcher
- * worlds have no 3d context while `require` still has to work, so there the
- * instance is used directly. How to import optional packages is up to the
- * runtime owner (see `WorldImports`).
+ * This is the `addons` ctx module, but it is loaded before the ctx exists: a
+ * module may need its lib (physics needs rapier) the moment the ctx is built.
+ * How to import optional packages is up to the runtime owner (see `WorldImports`).
  */
 export declare class AddonsRuntime extends ContextModule implements AddonsModuleApi {
     private readonly _imports;

package/dist/behaviours/player/SightInteractableArea.d.ts

@@ -17,7 +17,7 @@ export default class SightInteractableArea extends Object3DBehaviour<{
     onDisable(): void;
     setRadius(r: number): void;
     onBeforeRender(): void;
-    private _activate;
-    private _deactivate;
+    private _showPrompt;
+    private _hidePrompt;
     private _interact;
 }

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

@@ -49,7 +49,7 @@ var chatModuleDescriptor = {
 	normalize: (raw) => normalizeChat(raw),
 	defaultConfig: () => ({ ...DEFAULTS }),
 	create: async (config) => {
-		const { ChatModule } = await import("./ChatModule-2tiWS_Yr.js");
+		const { ChatModule } = await import("./ChatModule-BFNVVLA8.js");
 		return new ChatModule(config);
 	},
 	schema: {

package/dist/index.d.ts

@@ -7,8 +7,9 @@ export { WorldEvent } from "./world-events";
 export { lazyProxy } from "./utils/lazy";
 export { WorldStores } from "./world-stores";
 export type { WorldStore } from "./world-stores";
-export { createWorldModules, EnvModule, HtmlHudModule, InputSystemModule, isMobileDevice, SoundsModule, UtilsModule, } from "./modules";
+export { createWorldModules, EnvModule, HtmlHudModule, InputSystemModule, isMobileDevice, NullPlatformModule, SoundsModule, UtilsModule, } from "./modules";
 export type { EnvMode, WorldModules } from "./modules";
+export type { PlatformModuleApi, PlatformPlayerApi, PlatformPlayerStorageApi, WorldName, WorldNamesRegister, WorldOpenParams, } from "./modules/contracts/platform.module-api";
 export { DEFAULT_RESOURCE_IDS, DefaultResourceId, getDefaultResource, isDefaultResourceId, } from "./resources/default-resources";
 export type { DefaultResourceIdValue, DefaultResourceTypes, } from "./resources/default-resources";
 export { AssetLoaders, configureAssetLoaders, LOADING_MANAGER } from "./resources/loaders";

package/dist/index.js

@@ -1,4 +1,4 @@
-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 OPTIONAL_MODULE_IDS, i as normalizeChat, n as CHAT_INPUT_MODES, o as OptionalModuleId, r as chatModuleDescriptor } from "./chat.module-descriptor-CGeOaq16.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";
@@ -875,6 +875,36 @@ function isUiKeyboardTarget(target) {
 	}
 }
 //#endregion
+//#region packages/world-runtime/src/modules/platform/NullPlatformModule.ts
+var NO_PARAMS = Object.freeze({});
+var NULL_PLAYER = {
+	username: null,
+	storage: {
+		get: () => Promise.resolve(null),
+		save: () => Promise.resolve()
+	}
+};
+/**
+* `world.platform` без платформы: self-hosted экспорт, мир без моста. Все вызовы
+* безопасны — чтения пустые, записи ничего не делают. Мир на платформе получает
+* вместо него реализацию хоста, переданную в `createWorldModules({ platform })`.
+*/
+var NullPlatformModule = class extends ContextModule {
+	available = false;
+	player = NULL_PLAYER;
+	openedWith = NO_PARAMS;
+	referrer = null;
+	openWorld() {
+		return Promise.resolve(false);
+	}
+	resolveWorld() {
+		return Promise.resolve(null);
+	}
+	openLink() {
+		return Promise.resolve(false);
+	}
+};
+//#endregion
 //#region packages/world-runtime/src/modules/SoundsModule.ts
 var SoundsModule = class extends ContextModule {
 	global = Howler;
@@ -913,6 +943,7 @@ async function createWorldModules(mode = "prod", options) {
 		env: new EnvModule(mode),
 		html: new HtmlHudModule(),
 		input: new InputSystemModule(),
+		platform: options.platform ?? new NullPlatformModule(),
 		sounds: new SoundsModule(),
 		utils: new UtilsModule()
 	};
@@ -963,7 +994,7 @@ var entries = [
 	{
 		uuid: "sightinteractablearea",
 		name: "SightInteractableArea",
-		load: () => loadDefault(import("./SightInteractableArea-DrqyB41W.js"))
+		load: () => loadDefault(import("./SightInteractableArea-BK8IXNIl.js"))
 	},
 	{
 		uuid: "meshinstansing",
@@ -1155,10 +1186,9 @@ function collectRequiredLibs(addons, usedBuiltinUuids = []) {
 * by a module/behaviour through `requiredLibs`. Scripts reach all of them by
 * `require("<key>")`.
 *
-* This is the `addons` ctx module, but it also works without a ctx: launcher
-* worlds have no 3d context while `require` still has to work, so there the
-* instance is used directly. How to import optional packages is up to the
-* runtime owner (see `WorldImports`).
+* This is the `addons` ctx module, but it is loaded before the ctx exists: a
+* module may need its lib (physics needs rapier) the moment the ctx is built.
+* How to import optional packages is up to the runtime owner (see `WorldImports`).
 */
 var AddonsRuntime = class extends ContextModule {
 	_imports;
@@ -1578,7 +1608,7 @@ function isAbsoluteUrl(url) {
 }
 //#endregion
 //#region packages/world-runtime/src/version.gen.ts
-var RUNTIME_VERSION = "0.6.3";
+var RUNTIME_VERSION = "0.6.8";
 //#endregion
 //#region packages/world-runtime/src/version.ts
 /**
@@ -2109,4 +2139,4 @@ var TONE_MAPPING_NAMES = [
 	"Neutral"
 ];
 //#endregion
-export { AddonsRuntime, AssetLoaders, AudioSource, BLOOM_MODES, BUILTIN_BEHAVIOURS, BUILTIN_BEHAVIOUR_LIST, BUILTIN_LIB_DESCRIPTORS, CHAT_INPUT_MODES, DEFAULT_RESOURCE_IDS, DefaultResourceId, EXTERNAL_TYPES, EnvModule, FontSource, HtmlHudModule, InputSystemModule, LIBS, LIB_DESCRIPTORS, LIB_IDS, LOADING_MANAGER, LibId, OPTIONAL_LIB_DESCRIPTORS, OPTIONAL_LIB_IDS, OPTIONAL_MODULES, OPTIONAL_MODULE_IDS, OptionalModuleId, PHYSICS_ENGINES, RUNTIME_VERSION, SHADOW_MAP_TYPES, SceneBloom, SoundsModule, TONE_MAPPING_NAMES, TslNode, UNIFORM_DEFAULTS, UNIFORM_TYPES, UtilsModule, VideoSource, WORLD_FORMAT_VERSION, World, WorldEvent, WorldStores, applyRendererConfig, applyTextureDefaults, collectModelSubResources, collectRequiredLibs, configureAssetLoaders, createAudio, createFont, createTslNode, createUniformNode, createVideo, createWorldModules, defineWorld, enableSceneEmissiveMrt, fontFormatFromMime, getBuiltinBehaviour, getDefaultResource, getHalfheightRadiusScale, getOptionalModuleDescriptor, getRadiusScale, isDefaultResourceId, isMobileDevice, isUniformType, lazyProxy, libByRequireKey, loadGeometry, loadHdr, loadModel, loadTexture, normalizeChat, normalizePhysics, parseGeometryJson, parseHdr, parseModel, rapierPhysicsPatch, setColor, uniformType };
+export { AddonsRuntime, AssetLoaders, AudioSource, BLOOM_MODES, BUILTIN_BEHAVIOURS, BUILTIN_BEHAVIOUR_LIST, BUILTIN_LIB_DESCRIPTORS, CHAT_INPUT_MODES, DEFAULT_RESOURCE_IDS, DefaultResourceId, EXTERNAL_TYPES, EnvModule, FontSource, HtmlHudModule, InputSystemModule, LIBS, LIB_DESCRIPTORS, LIB_IDS, LOADING_MANAGER, LibId, NullPlatformModule, OPTIONAL_LIB_DESCRIPTORS, OPTIONAL_LIB_IDS, OPTIONAL_MODULES, OPTIONAL_MODULE_IDS, OptionalModuleId, PHYSICS_ENGINES, RUNTIME_VERSION, SHADOW_MAP_TYPES, SceneBloom, SoundsModule, TONE_MAPPING_NAMES, TslNode, UNIFORM_DEFAULTS, UNIFORM_TYPES, UtilsModule, VideoSource, WORLD_FORMAT_VERSION, World, WorldEvent, WorldStores, applyRendererConfig, applyTextureDefaults, collectModelSubResources, collectRequiredLibs, configureAssetLoaders, createAudio, createFont, createTslNode, createUniformNode, createVideo, createWorldModules, defineWorld, enableSceneEmissiveMrt, fontFormatFromMime, getBuiltinBehaviour, getDefaultResource, getHalfheightRadiusScale, getOptionalModuleDescriptor, getRadiusScale, isDefaultResourceId, isMobileDevice, isUniformType, lazyProxy, libByRequireKey, loadGeometry, loadHdr, loadModel, loadTexture, normalizeChat, normalizePhysics, parseGeometryJson, parseHdr, parseModel, rapierPhysicsPatch, setColor, uniformType };

package/dist/modules/chat/ChatDom.d.ts

@@ -28,19 +28,18 @@ export interface ChatDomOptions {
 /**
  * Chat DOM: the message feed plus the input field.
  *
- * Built to survive real devices: submit through a `<form>` (Enter/Go/Send on any
- * mobile keyboard), an IME composition guard, and lifting above the on-screen
- * keyboard via `visualViewport`. Details —
- * `./README.md`.
+ * Built to survive real devices: sending on the Enter keydown (no `<form>`: a
+ * sandboxed host may block form submission), an IME composition guard, and
+ * lifting above the on-screen keyboard via `visualViewport`. Details — `./README.md`.
  */
 export declare class ChatDom {
     readonly root: HTMLDivElement;
     readonly feed: HTMLDivElement;
-    readonly form: HTMLFormElement;
     readonly input: HTMLInputElement;
     private readonly _options;
     private _lines;
-    private _isComposing;
+    /** Timer of a send waiting for the keyboard to commit its composition. */
+    private _pendingSubmit;
     private _viewportRaf;
     private _mounted;
     constructor(options?: ChatDomOptions);
@@ -77,12 +76,19 @@ export declare class ChatDom {
     private _setFaded;
     private _bind;
     private _unbind;
-    private readonly _onSubmit;
-    private readonly _onCompositionStart;
+    private _submit;
+    /**
+     * Sends now or, while the keyboard still holds the typed word as a composition
+     * (Android), once it commits the word: clearing the field under a live
+     * composition can bring the word back into it.
+     */
+    private _requestSubmit;
+    private _cancelPendingSubmit;
+    private readonly _flushSubmit;
     private readonly _onCompositionEnd;
-    /** Some Android keyboards send no Enter keydown, only `insertLineBreak`. */
-    private readonly _onBeforeInput;
     private readonly _onKeyDown;
+    /** Fallback for keyboards that insert a line break instead of sending Enter. */
+    private readonly _onBeforeInput;
     private readonly _stopPropagation;
     private readonly _onFocus;
     private readonly _onBlur;

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

@@ -0,0 +1,60 @@
+/**
+ * Public API of the `platform` module — the world's link to the Kvyverse
+ * platform. Off the platform (self-hosted export) every call is a safe no-op:
+ * nothing throws, reads resolve to empty values.
+ */
+export interface PlatformModuleApi {
+    /** The world runs on the platform and the link is established. */
+    readonly available: boolean;
+    readonly player: PlatformPlayerApi;
+    /** Parameters this world was opened with; empty when opened from its own page. */
+    readonly openedWith: Readonly<WorldOpenParams>;
+    /**
+     * The world that switched to this one with `openWorld`; `null` when the
+     * player came straight to this page (a reload included).
+     */
+    readonly referrer: WorldName | null;
+    /**
+     * Asks the platform to put another world of the same author on this page,
+     * in place of this one. `state` reaches it as its `openedWith`. Resolves to
+     * `false` when the platform refuses (another author, no such world) or off
+     * the platform; on success this world is torn down.
+     */
+    openWorld: (world: WorldName, state?: WorldOpenParams) => Promise<boolean>;
+    /**
+     * Checks a name that came at runtime (a chat command, player input) against
+     * the author's worlds: resolves to its url-name, typed as `WorldName`, or
+     * `null` when there is no such world of this author, or off the platform.
+     * Takes a url-name or an id.
+     */
+    resolveWorld: (world: string) => Promise<WorldName | null>;
+    /**
+     * Asks the platform to open an external link. The platform shows the address
+     * and asks the player; resolves to `false` when they decline, when the
+     * address is not http(s), or off the platform.
+     */
+    openLink: (url: string) => Promise<boolean>;
+}
+/** Parameters a world is opened with. Values are strings. */
+export type WorldOpenParams = Record<string, string>;
+/**
+ * Filled in by the Kvyverse editor for the author's own world: `worlds` lists
+ * the author's worlds. Not filled (anywhere else) — any string.
+ */
+export interface WorldNamesRegister {
+}
+/** Url-name of one of the author's worlds: what `openWorld` takes and `referrer` holds. */
+export type WorldName = WorldNamesRegister extends {
+    worlds: infer TWorld extends string;
+} ? TWorld : string;
+export interface PlatformPlayerApi {
+    /** Display name of the current player; `null` for a guest or off-platform. */
+    readonly username: string | null;
+    /** Server-side storage for this world + player pair. */
+    readonly storage: PlatformPlayerStorageApi;
+}
+/** Storage of one world for one player. Never throws: no platform — no value. */
+export interface PlatformPlayerStorageApi {
+    get: () => Promise<string | null>;
+    save: (data: string) => Promise<void>;
+}

package/dist/modules/index.d.ts

@@ -7,13 +7,16 @@ import { UtilsModule } from "./UtilsModule";
 import type { AddonsRuntime } from "../addons/AddonsRuntime";
 import type { AddonsConfig } from "../addons/types";
 import type { EnvMode } from "./EnvModule";
+import type { PlatformModuleApi } from "./contracts/platform.module-api";
 import type { KvyverseModules } from "./registry";
+import type { ContextModule } from "three-start";
 export type { ChatModule } from "./chat/ChatModule";
 export type { ChatDom, ChatDomOptions } from "./chat/ChatDom";
 export { ControlsModule } from "./controls/ControlsModule";
 export { EnvModule } from "./EnvModule";
 export { HtmlHudModule } from "./HtmlHudModule";
 export { InputSystemModule } from "./InputSystemModule";
+export { NullPlatformModule } from "./platform/NullPlatformModule";
 export { SoundsModule } from "./SoundsModule";
 export { UtilsModule } from "./UtilsModule";
 export { isMobileDevice } from "./is-mobile-device";
@@ -25,6 +28,7 @@ export type CoreWorldModules = {
     env: EnvModule;
     html: HtmlHudModule;
     input: InputSystemModule;
+    platform: ContextModule & PlatformModuleApi;
     sounds: SoundsModule;
     utils: UtilsModule;
 };
@@ -35,6 +39,8 @@ export interface CreateWorldModulesOptions {
     addons: AddonsRuntime;
     /** `settings.addons.json → modules`: which pluggable modules are on, and how. */
     modules?: AddonsConfig["modules"];
+    /** `world.platform`: the host's implementation; omitted off the platform, and it turns no-op. */
+    platform?: ContextModule & PlatformModuleApi;
 }
 /**
  * Assembles the world's ctx modules: core ones always, pluggable ones per config.

package/dist/modules/platform/NullPlatformModule.d.ts

@@ -0,0 +1,16 @@
+import { ContextModule } from "three-start";
+import type { PlatformModuleApi, PlatformPlayerApi, WorldOpenParams } from "../contracts/platform.module-api";
+/**
+ * `world.platform` без платформы: self-hosted экспорт, мир без моста. Все вызовы
+ * безопасны — чтения пустые, записи ничего не делают. Мир на платформе получает
+ * вместо него реализацию хоста, переданную в `createWorldModules({ platform })`.
+ */
+export declare class NullPlatformModule extends ContextModule implements PlatformModuleApi {
+    readonly available = false;
+    readonly player: PlatformPlayerApi;
+    readonly openedWith: Readonly<WorldOpenParams>;
+    readonly referrer: null;
+    openWorld(): Promise<boolean>;
+    resolveWorld(): Promise<null>;
+    openLink(): Promise<boolean>;
+}

package/dist/modules/registry.d.ts

@@ -1,3 +1,4 @@
+import type { ContextModule } from "three-start";
 import type { RapierPhysics } from "./physics/RapierPhysics";
 import type { AddonsRuntime } from "../addons/AddonsRuntime";
 import type { ChatModule } from "./chat/ChatModule";
@@ -5,6 +6,7 @@ import type { ControlsModule } from "./controls/ControlsModule";
 import type { EnvModule } from "./EnvModule";
 import type { HtmlHudModule } from "./HtmlHudModule";
 import type { InputSystemModule } from "./InputSystemModule";
+import type { PlatformModuleApi } from "./contracts/platform.module-api";
 import type { SoundsModule } from "./SoundsModule";
 import type { UtilsModule } from "./UtilsModule";
 /**
@@ -23,6 +25,8 @@ export interface KvyverseModules {
     controls: ControlsModule;
     env: EnvModule;
     html: HtmlHudModule;
+    /** Реализацию даёт тот, кто собирает мир: хост на платформе или пустая. */
+    platform: ContextModule & PlatformModuleApi;
     sounds: SoundsModule;
     utils: UtilsModule;
     rapier: RapierPhysics;

package/dist/version.gen.d.ts

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

package/package.json

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