@worldmesh/runtime 0.2.2 → 0.2.3

package/README.md

@@ -25,9 +25,9 @@ The package is ESM only and targets ES2022 browsers. It touches `window` and
 If you already have a scene, a camera and a renderer, this is the whole job:
 
 ```js
-import { createWorldMesh } from '@worldmesh/runtime';
+import { loadWorldMesh } from '@worldmesh/runtime';
 
-const world = createWorldMesh({
+const world = await loadWorldMesh({
   scene,
   camera,
   renderer,
@@ -43,13 +43,22 @@ person with a consistent toggle, pointer-lock handling, touch controls on touch
 devices, immersive VR through the shared Enter VR control when WebXR is
 available, the shared overlay and portals between worlds.
 
-Removing the `createWorldMesh` call leaves you with the Three.js project you
+Removing the `loadWorldMesh` call leaves you with the Three.js project you
 started with.
 
+## Staying current
+
+`loadWorldMesh` runs the current runtime from worldmesh.net, with your copy of
+Three.js, so fixes and improvements reach your world without a rebuild. If it
+cannot be loaded, the copy in this package runs instead (in its own chunk,
+downloaded only then). `createWorldMesh` takes the same options and always
+runs the copy in this package, synchronously. Details:
+[Staying current](https://github.com/eliaswillnat/worldmesh/blob/main/docs/compatibility.md#staying-current-loadworldmesh-and-createworldmesh).
+
 ## Visitors' own avatars (optional)
 
 ```js
-createWorldMesh({ scene, camera, renderer, avatar: { source: 'worldmesh' } });
+loadWorldMesh({ scene, camera, renderer, avatar: { source: 'worldmesh' } });
 ```
 
 Visitors who picked a character in their WorldMesh Avatar Wallet (Sketchfab,
@@ -94,7 +103,8 @@ open other pages, as the page around your world is the hub's.
 
 | | |
 | --- | --- |
-| `createWorldMesh` | the one call a world needs |
+| `loadWorldMesh` | the one call a world needs, kept current |
+| `createWorldMesh`, `HOSTED_RUNTIME_URL` | the same call on the copy in this package; where `loadWorldMesh` loads from |
 | `Input`, `TouchControls`, `DEFAULT_KEYMAP`, `resolveKeymap` | the control convention |
 | `MovementController`, `CollisionWorld`, `DEFAULT_TUNING` | movement and collision |
 | `CameraRig`, `Player`, `createDefaultAvatar`, `AVATAR_EXPRESSIONS` | camera and figure |

package/dist/hosted.d.ts

@@ -0,0 +1,3 @@
+export { createWorldMesh } from './core/worldmesh.js';
+export { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+//# sourceMappingURL=hosted.d.ts.map

package/dist/hosted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.d.ts","sourceRoot":"","sources":["../src/hosted.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/hosted.js

@@ -0,0 +1,5 @@
+// The entry of the runtime worldmesh.net serves for loadWorldMesh
+// (src/load.ts, scripts/build-hosted.mjs). Not part of the npm entry.
+export { createWorldMesh } from './core/worldmesh.js';
+export { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+//# sourceMappingURL=hosted.js.map

package/dist/hosted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted.js","sourceRoot":"","sources":["../src/hosted.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,sEAAsE;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.d.ts

@@ -27,8 +27,8 @@ export type { PresenceOptions, SharedAvatar } from './net/presence.js';
 export { SharedAvatarLink, createShareVerifier, shareableAvatar } from './avatar/share.js';
 export { isOverAllowanceSignal, isRoomFullSignal, occupancyIsFull, occupancyProbeUrl, probeRoom, probeRoomFull, roomFullLabel } from './net/roomFull.js';
 export type { RoomProbe } from './net/roomFull.js';
-export declare const WORLDMESH_VERSION = "0.2.2";
-/** Bumped when the world-facing contract changes in an incompatible way. */
-export declare const WORLDMESH_PROTOCOL = 1;
+export { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+export { HOSTED_RUNTIME_URL, loadWorldMesh } from './load.js';
+export type { LoadWorldMeshOptions } from './load.js';
 export type { Abilities, AvatarOptions, InputAction, Keymap, MovementTuning, MultiplayerOptions, NetworkAdapter, PeerBody, PlayerOptions, PlayerState, PortalMode, PortalOptions, UiOptions, Vec3Tuple, ViewMode, ViewOptions, WorldMeshEvents, WorldMeshHandle, WorldMeshOptions, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -22,7 +22,6 @@ export { DEFAULT_PRESENCE_SERVER, Presence, createNameTag, createSpeechBubble }
 export { easeYaw } from './net/follow.js';
 export { SharedAvatarLink, createShareVerifier, shareableAvatar } from './avatar/share.js';
 export { isOverAllowanceSignal, isRoomFullSignal, occupancyIsFull, occupancyProbeUrl, probeRoom, probeRoomFull, roomFullLabel } from './net/roomFull.js';
-export const WORLDMESH_VERSION = '0.2.2';
-/** Bumped when the world-facing contract changes in an incompatible way. */
-export const WORLDMESH_PROTOCOL = 1;
+export { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+export { HOSTED_RUNTIME_URL, loadWorldMesh } from './load.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnI,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhG,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGzJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnI,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhG,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGzJ,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,23 @@
+import type { WorldMeshHandle, WorldMeshOptions } from './types.js';
+/**
+ * The current runtime for this protocol, served by WorldMesh
+ * (scripts/build-hosted.mjs). `loadWorldMesh` runs it, so a fix reaches a
+ * world the next time it is opened, without the world rebuilding.
+ */
+export declare const HOSTED_RUNTIME_URL = "https://worldmesh.net/runtime/1/index.js";
+export interface LoadWorldMeshOptions {
+    /** Run the runtime from here instead: a preview or a self-hosted copy. */
+    url?: string;
+    /** Give up on it after this many milliseconds and use the bundled copy. Default 8000. */
+    timeoutMs?: number;
+    /** false: always use the copy bundled with the world, as `createWorldMesh` does. */
+    hosted?: boolean;
+}
+/**
+ * `createWorldMesh`, kept current: runs the latest runtime WorldMesh serves for
+ * this protocol, with the world's own Three.js. If that cannot be loaded in
+ * time, or does not start, the copy bundled with the world runs instead, so
+ * the world works as it did when it was built.
+ */
+export declare function loadWorldMesh(options: WorldMeshOptions, load?: LoadWorldMeshOptions): Promise<WorldMeshHandle>;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGpE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,6CAAiE,CAAC;AAYjG,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,GAAE,oBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC,CAYxH"}

package/dist/load.js

@@ -0,0 +1,83 @@
+import * as THREE from 'three';
+import { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+/**
+ * The current runtime for this protocol, served by WorldMesh
+ * (scripts/build-hosted.mjs). `loadWorldMesh` runs it, so a fix reaches a
+ * world the next time it is opened, without the world rebuilding.
+ */
+export const HOSTED_RUNTIME_URL = `https://worldmesh.net/runtime/${WORLDMESH_PROTOCOL}/index.js`;
+/** Where the hosted runtime picks up the world's own Three.js (scripts/build-hosted.mjs). */
+const THREE_KEY = Symbol.for('worldmesh.three');
+const DEFAULT_TIMEOUT_MS = 8000;
+/**
+ * The runtime is asked for at a new URL this often, which bounds how long a
+ * browser keeps an old one. Cache headers can't: worldmesh.net's Browser
+ * Cache TTL stretches any shorter max-age on a .js file to 4 hours.
+ */
+const REFRESH_MS = 5 * 60_000;
+const loading = new Map();
+/**
+ * `createWorldMesh`, kept current: runs the latest runtime WorldMesh serves for
+ * this protocol, with the world's own Three.js. If that cannot be loaded in
+ * time, or does not start, the copy bundled with the world runs instead, so
+ * the world works as it did when it was built.
+ */
+export async function loadWorldMesh(options, load = {}) {
+    const useHosted = load.hosted !== false && typeof window !== 'undefined';
+    const hosted = useHosted ? await hostedRuntime(load.url ?? HOSTED_RUNTIME_URL, load.timeoutMs ?? DEFAULT_TIMEOUT_MS) : null;
+    if (hosted) {
+        try {
+            return hosted.createWorldMesh(options);
+        }
+        catch (error) {
+            console.warn(`[WorldMesh] Runtime ${hosted.WORLDMESH_VERSION} did not start; using the copy bundled with this world (${WORLDMESH_VERSION}).`, error);
+        }
+    }
+    const { createWorldMesh } = await import('./core/worldmesh.js');
+    return createWorldMesh(options);
+}
+function hostedRuntime(url, timeoutMs) {
+    let pending = loading.get(url);
+    if (!pending) {
+        pending = importHosted(url, timeoutMs);
+        loading.set(url, pending);
+    }
+    return pending;
+}
+async function importHosted(url, timeoutMs) {
+    const shared = globalThis;
+    shared[THREE_KEY] ??= THREE;
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(null), timeoutMs);
+    });
+    const fallback = `using the copy bundled with this world (${WORLDMESH_VERSION})`;
+    try {
+        // Left to the browser: bundlers must not try to resolve or inline it.
+        const imported = import(/* webpackIgnore: true */ /* @vite-ignore */ refreshed(url));
+        const runtime = await Promise.race([imported, timeout]);
+        if (!runtime) {
+            console.info(`[WorldMesh] ${url} took longer than ${timeoutMs} ms; ${fallback}.`);
+            return null;
+        }
+        if (runtime.WORLDMESH_PROTOCOL !== WORLDMESH_PROTOCOL || typeof runtime.createWorldMesh !== 'function') {
+            console.warn(`[WorldMesh] ${url} is not a protocol ${WORLDMESH_PROTOCOL} runtime; ${fallback}.`);
+            return null;
+        }
+        return runtime;
+    }
+    catch (error) {
+        console.info(`[WorldMesh] Could not load ${url}; ${fallback}.`, error);
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** `url` with `v` set to the current REFRESH_MS slot, e.g. `…/index.js?v=5867331`. */
+function refreshed(url) {
+    const fresh = new URL(url, globalThis.location?.href);
+    fresh.searchParams.set('v', String(Math.floor(Date.now() / REFRESH_MS)));
+    return fresh.href;
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+export declare const WORLDMESH_VERSION = "0.2.3";
+/** Bumped when the world-facing contract changes in an incompatible way. */
+export declare const WORLDMESH_PROTOCOL = 1;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,IAAI,CAAC"}

package/dist/version.js

@@ -0,0 +1,4 @@
+export const WORLDMESH_VERSION = '0.2.3';
+/** Bumped when the world-facing contract changes in an incompatible way. */
+export const WORLDMESH_PROTOCOL = 1;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC;AACzC,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@worldmesh/runtime",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "The shared WorldMesh navigation runtime: controls, movement, camera, player, abilities and portals.",
   "keywords": [
     "worldmesh",

package/src/hosted.ts

@@ -0,0 +1,4 @@
+// The entry of the runtime worldmesh.net serves for loadWorldMesh
+// (src/load.ts, scripts/build-hosted.mjs). Not part of the npm entry.
+export { createWorldMesh } from './core/worldmesh.js';
+export { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';

package/src/index.ts

@@ -46,9 +46,9 @@ export { SharedAvatarLink, createShareVerifier, shareableAvatar } from './avatar
 export { isOverAllowanceSignal, isRoomFullSignal, occupancyIsFull, occupancyProbeUrl, probeRoom, probeRoomFull, roomFullLabel } from './net/roomFull.js';
 export type { RoomProbe } from './net/roomFull.js';
 
-export const WORLDMESH_VERSION = '0.2.2';
-/** Bumped when the world-facing contract changes in an incompatible way. */
-export const WORLDMESH_PROTOCOL = 1;
+export { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+export { HOSTED_RUNTIME_URL, loadWorldMesh } from './load.js';
+export type { LoadWorldMeshOptions } from './load.js';
 
 export type {
   Abilities,

package/src/load.ts

@@ -0,0 +1,103 @@
+import * as THREE from 'three';
+import type { WorldMeshHandle, WorldMeshOptions } from './types.js';
+import { WORLDMESH_PROTOCOL, WORLDMESH_VERSION } from './version.js';
+
+/**
+ * The current runtime for this protocol, served by WorldMesh
+ * (scripts/build-hosted.mjs). `loadWorldMesh` runs it, so a fix reaches a
+ * world the next time it is opened, without the world rebuilding.
+ */
+export const HOSTED_RUNTIME_URL = `https://worldmesh.net/runtime/${WORLDMESH_PROTOCOL}/index.js`;
+
+/** Where the hosted runtime picks up the world's own Three.js (scripts/build-hosted.mjs). */
+const THREE_KEY = Symbol.for('worldmesh.three');
+const DEFAULT_TIMEOUT_MS = 8000;
+/**
+ * The runtime is asked for at a new URL this often, which bounds how long a
+ * browser keeps an old one. Cache headers can't: worldmesh.net's Browser
+ * Cache TTL stretches any shorter max-age on a .js file to 4 hours.
+ */
+const REFRESH_MS = 5 * 60_000;
+
+export interface LoadWorldMeshOptions {
+  /** Run the runtime from here instead: a preview or a self-hosted copy. */
+  url?: string;
+  /** Give up on it after this many milliseconds and use the bundled copy. Default 8000. */
+  timeoutMs?: number;
+  /** false: always use the copy bundled with the world, as `createWorldMesh` does. */
+  hosted?: boolean;
+}
+
+/** What the hosted runtime exports (src/hosted.ts). */
+interface HostedRuntime {
+  createWorldMesh(options: WorldMeshOptions): WorldMeshHandle;
+  WORLDMESH_PROTOCOL: number;
+  WORLDMESH_VERSION: string;
+}
+
+const loading = new Map<string, Promise<HostedRuntime | null>>();
+
+/**
+ * `createWorldMesh`, kept current: runs the latest runtime WorldMesh serves for
+ * this protocol, with the world's own Three.js. If that cannot be loaded in
+ * time, or does not start, the copy bundled with the world runs instead, so
+ * the world works as it did when it was built.
+ */
+export async function loadWorldMesh(options: WorldMeshOptions, load: LoadWorldMeshOptions = {}): Promise<WorldMeshHandle> {
+  const useHosted = load.hosted !== false && typeof window !== 'undefined';
+  const hosted = useHosted ? await hostedRuntime(load.url ?? HOSTED_RUNTIME_URL, load.timeoutMs ?? DEFAULT_TIMEOUT_MS) : null;
+  if (hosted) {
+    try {
+      return hosted.createWorldMesh(options);
+    } catch (error) {
+      console.warn(`[WorldMesh] Runtime ${hosted.WORLDMESH_VERSION} did not start; using the copy bundled with this world (${WORLDMESH_VERSION}).`, error);
+    }
+  }
+  const { createWorldMesh } = await import('./core/worldmesh.js');
+  return createWorldMesh(options);
+}
+
+function hostedRuntime(url: string, timeoutMs: number): Promise<HostedRuntime | null> {
+  let pending = loading.get(url);
+  if (!pending) {
+    pending = importHosted(url, timeoutMs);
+    loading.set(url, pending);
+  }
+  return pending;
+}
+
+async function importHosted(url: string, timeoutMs: number): Promise<HostedRuntime | null> {
+  const shared = globalThis as unknown as Record<symbol, unknown>;
+  shared[THREE_KEY] ??= THREE;
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const timeout = new Promise<null>((resolve) => {
+    timer = setTimeout(() => resolve(null), timeoutMs);
+  });
+  const fallback = `using the copy bundled with this world (${WORLDMESH_VERSION})`;
+  try {
+    // Left to the browser: bundlers must not try to resolve or inline it.
+    const imported = import(/* webpackIgnore: true */ /* @vite-ignore */ refreshed(url)) as Promise<HostedRuntime>;
+    const runtime = await Promise.race([imported, timeout]);
+    if (!runtime) {
+      console.info(`[WorldMesh] ${url} took longer than ${timeoutMs} ms; ${fallback}.`);
+      return null;
+    }
+    if (runtime.WORLDMESH_PROTOCOL !== WORLDMESH_PROTOCOL || typeof runtime.createWorldMesh !== 'function') {
+      console.warn(`[WorldMesh] ${url} is not a protocol ${WORLDMESH_PROTOCOL} runtime; ${fallback}.`);
+      return null;
+    }
+    return runtime;
+  } catch (error) {
+    console.info(`[WorldMesh] Could not load ${url}; ${fallback}.`, error);
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+/** `url` with `v` set to the current REFRESH_MS slot, e.g. `…/index.js?v=5867331`. */
+function refreshed(url: string): string {
+  const fresh = new URL(url, globalThis.location?.href);
+  fresh.searchParams.set('v', String(Math.floor(Date.now() / REFRESH_MS)));
+  return fresh.href;
+}

package/src/version.ts

@@ -0,0 +1,3 @@
+export const WORLDMESH_VERSION = '0.2.3';
+/** Bumped when the world-facing contract changes in an incompatible way. */
+export const WORLDMESH_PROTOCOL = 1;