@rydr/game-sdk 1.12.0 → 1.14.0

package/README.md

@@ -14,11 +14,11 @@ This package is the **public contract** between platform and game:
 
 ## Install
 
-Public git dependency (no registry, no token):
+Public npm package (no token needed — the source repo is private, the package is public):
 
 ```jsonc
 // package.json
-"dependencies": { "@rydr/game-sdk": "github:bdefrenne/rydr-game-sdk#semver:^1.0.0" }
+"dependencies": { "@rydr/game-sdk": "^1.0.0" }
 ```
 
 **Starting a new game?** Don't wire this by hand — scaffold from

package/dist/protocol/version.d.ts

@@ -8,5 +8,5 @@
  */
 export declare const RYDR_PROTOCOL_VERSION: 5;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging. */
-export declare const RYDR_SDK_VERSION = "1.12.0";
+export declare const RYDR_SDK_VERSION = "1.14.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/protocol/version.js

@@ -10,5 +10,5 @@
 // shells omit it, the client falls back to its default).
 export const RYDR_PROTOCOL_VERSION = 5;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging. */
-export const RYDR_SDK_VERSION = "1.12.0";
+export const RYDR_SDK_VERSION = "1.14.0";
 //# sourceMappingURL=version.js.map

package/dist/three/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `@rydr/game-sdk/three` — optional three.js helpers, kept out of the renderer-agnostic core.
+ *
+ * Importing this entry point requires `three` (declared as a peer dependency). Games that render a
+ * platform world should load it through {@link loadWorldGroup} here instead of hand-rolling a
+ * `GLTFLoader` + DRACO + caching per game.
+ */
+export * from "./world-loader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/three/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC"}

package/dist/three/index.js

@@ -0,0 +1,9 @@
+/**
+ * `@rydr/game-sdk/three` — optional three.js helpers, kept out of the renderer-agnostic core.
+ *
+ * Importing this entry point requires `three` (declared as a peer dependency). Games that render a
+ * platform world should load it through {@link loadWorldGroup} here instead of hand-rolling a
+ * `GLTFLoader` + DRACO + caching per game.
+ */
+export * from "./world-loader.js";
+//# sourceMappingURL=index.js.map

package/dist/three/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,mBAAmB,CAAC"}

package/dist/three/world-loader.d.ts

@@ -0,0 +1,90 @@
+/**
+ * world-loader — opinionated three.js helper for loading a platform {@link CoreWorld} into a scene.
+ *
+ * The SDK core ({@link applyWorld}) is deliberately renderer-agnostic: it walks a `CoreWorld` and calls
+ * back a `loadGlb(url)` you provide, never touching `three`. This module is the **three-aware layer on
+ * top** — it owns a `GLTFLoader` + DRACO decoder and the caching every game was otherwise copy-pasting,
+ * so it lives behind the optional `@rydr/game-sdk/three` entry point (with `three` as a peer
+ * dependency) and never burdens games that don't render 3D.
+ *
+ * ## A world is loaded once and reused
+ *
+ * A platform world is a static environment, so it is fetched, DRACO-decoded, uploaded to the GPU and
+ * shader-compiled **once** ({@link loadWorld}, cached by {@link CoreWorld.id}) and then reused — a game
+ * that tears down and rebuilds gameplay on every restart still gets an instant world. Two caches back
+ * this: a per-URL GLB dedup inside {@link createGlbLoader} (repeated props clone shared
+ * geometry/material instead of re-downloading), and the per-world {@link LoadedWorld} handle cache.
+ *
+ * ## The handle owns the GPU resources — disposal is safe
+ *
+ * {@link loadWorld} returns a {@link LoadedWorld} handle, the single owner of the world's GPU
+ * resources. Use `attach`/`detach` for the cheap per-restart show/hide, and `dispose` as the *only*
+ * way to free memory (it also evicts the cache). This makes the cache impossible to corrupt: there is
+ * no "remember to detach, never dispose the shared group" rule to get wrong.
+ */
+import * as THREE from "three";
+import type { CoreWorld } from "../protocol/worlds.js";
+/** DRACO decoder — pinned to the same version the platform world editor uses. */
+export declare const DRACO_DECODER_PATH = "https://www.gstatic.com/draco/versioned/decoders/1.5.6/";
+export interface GlbLoaderOptions {
+    /** Override the DRACO decoder directory (defaults to {@link DRACO_DECODER_PATH}). */
+    dracoDecoderPath?: string;
+}
+/** A transform applied to a loaded world group: translate · Y-rotation · uniform scale. */
+export interface WorldPlacement {
+    position?: [number, number, number];
+    /** Y-axis rotation, radians. */
+    rotationY?: number;
+    /** Uniform scale. */
+    scale?: number;
+}
+export interface LoadWorldOptions extends GlbLoaderOptions {
+    /** Optional transform applied to the world group on every `loadWorld` call (incl. cache hits). */
+    placement?: WorldPlacement;
+}
+/**
+ * A loaded platform world — the single owner of its GPU resources.
+ *
+ * Lifecycle: `attach(scene)` to show it, `detach()` to cheaply remove it (the per-restart op — keeps
+ * everything on the GPU), and `dispose()` to actually free its geometry/materials and evict it from
+ * the cache (real teardown, or switching to a different world). Never call `geometry.dispose()` on
+ * `group` yourself — the resources are shared with the cache; use `dispose()`.
+ */
+export interface LoadedWorld {
+    /** The {@link CoreWorld.id} this was built from. */
+    readonly id: string;
+    /** The assembled meshes. Cached/shared — manage its lifetime through this handle, don't dispose it. */
+    readonly group: THREE.Group;
+    /** Add the world to a scene (or any parent). Idempotent; re-attaching after `detach` is the cheap resume. */
+    attach(parent: THREE.Object3D): void;
+    /** Remove the world from its parent **without** freeing GPU resources — the cheap per-restart teardown. */
+    detach(): void;
+    /** Free geometry + materials and evict from the cache. For real teardown or switching worlds. */
+    dispose(): void;
+}
+/**
+ * A `loadGlb` callback for {@link applyWorld}: fetches a glb by URL and resolves to its root scene.
+ *
+ * The returned closure shares one `GLTFLoader` + DRACO decoder across all URLs and fetches +
+ * DRACO-decodes each URL **once** — repeated URLs resolve to a lightweight `.clone()` (shared
+ * geometry/material) rather than re-downloading and re-decoding. Cloning is also required for
+ * correctness: `applyWorld` adds every returned object to the group, and a single Object3D can't be
+ * parented twice.
+ */
+export declare function createGlbLoader(opts?: GlbLoaderOptions): (url: string) => Promise<THREE.Object3D>;
+/**
+ * Load (and cache by id) a platform world's meshes. Re-calling for the same `coreWorld.id` resolves to
+ * the **same** {@link LoadedWorld} handle instantly — no re-fetch / re-decode / re-upload — so games
+ * that rebuild gameplay on restart keep an instant world. `placement`, if given, is applied to the
+ * group on every call (cheap). Rejects if any glb fails to load.
+ */
+export declare function loadWorld(coreWorld: CoreWorld, opts?: LoadWorldOptions): Promise<LoadedWorld>;
+/** Apply a {@link WorldPlacement} (translate · Y-rotation · uniform scale) to a group. */
+export declare function applyPlacement(group: THREE.Object3D, placement: WorldPlacement): void;
+/**
+ * Release cached worlds and dispose their geometry + materials (textures are left alone — they may be
+ * shared elsewhere). Pass an `id` to drop a single world, or omit it to clear everything. Equivalent
+ * to calling `dispose()` on the matching handle(s); use it when you don't hold the handle.
+ */
+export declare function clearWorldCache(id?: string): void;
+//# sourceMappingURL=world-loader.d.ts.map

package/dist/three/world-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-loader.d.ts","sourceRoot":"","sources":["../../src/three/world-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,4DAA4D,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,kGAAkG;IAClG,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IAC5B,6GAA6G;IAC7G,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrC,2GAA2G;IAC3G,MAAM,IAAI,IAAI,CAAC;IACf,iGAAiG;IACjG,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,gBAAqB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAcrG;AAKD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC,CAcjG;AAmBD,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,cAAc,GAAG,IAAI,CAIrF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAWjD"}

package/dist/three/world-loader.js

@@ -0,0 +1,138 @@
+/**
+ * world-loader — opinionated three.js helper for loading a platform {@link CoreWorld} into a scene.
+ *
+ * The SDK core ({@link applyWorld}) is deliberately renderer-agnostic: it walks a `CoreWorld` and calls
+ * back a `loadGlb(url)` you provide, never touching `three`. This module is the **three-aware layer on
+ * top** — it owns a `GLTFLoader` + DRACO decoder and the caching every game was otherwise copy-pasting,
+ * so it lives behind the optional `@rydr/game-sdk/three` entry point (with `three` as a peer
+ * dependency) and never burdens games that don't render 3D.
+ *
+ * ## A world is loaded once and reused
+ *
+ * A platform world is a static environment, so it is fetched, DRACO-decoded, uploaded to the GPU and
+ * shader-compiled **once** ({@link loadWorld}, cached by {@link CoreWorld.id}) and then reused — a game
+ * that tears down and rebuilds gameplay on every restart still gets an instant world. Two caches back
+ * this: a per-URL GLB dedup inside {@link createGlbLoader} (repeated props clone shared
+ * geometry/material instead of re-downloading), and the per-world {@link LoadedWorld} handle cache.
+ *
+ * ## The handle owns the GPU resources — disposal is safe
+ *
+ * {@link loadWorld} returns a {@link LoadedWorld} handle, the single owner of the world's GPU
+ * resources. Use `attach`/`detach` for the cheap per-restart show/hide, and `dispose` as the *only*
+ * way to free memory (it also evicts the cache). This makes the cache impossible to corrupt: there is
+ * no "remember to detach, never dispose the shared group" rule to get wrong.
+ */
+import * as THREE from "three";
+import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import { DRACOLoader } from "three/addons/loaders/DRACOLoader.js";
+import { applyWorld } from "../world-runtime.js";
+/** DRACO decoder — pinned to the same version the platform world editor uses. */
+export const DRACO_DECODER_PATH = "https://www.gstatic.com/draco/versioned/decoders/1.5.6/";
+/**
+ * A `loadGlb` callback for {@link applyWorld}: fetches a glb by URL and resolves to its root scene.
+ *
+ * The returned closure shares one `GLTFLoader` + DRACO decoder across all URLs and fetches +
+ * DRACO-decodes each URL **once** — repeated URLs resolve to a lightweight `.clone()` (shared
+ * geometry/material) rather than re-downloading and re-decoding. Cloning is also required for
+ * correctness: `applyWorld` adds every returned object to the group, and a single Object3D can't be
+ * parented twice.
+ */
+export function createGlbLoader(opts = {}) {
+    const loader = new GLTFLoader();
+    const draco = new DRACOLoader();
+    draco.setDecoderPath(opts.dracoDecoderPath ?? DRACO_DECODER_PATH);
+    loader.setDRACOLoader(draco);
+    const decoded = new Map();
+    return (url) => {
+        let p = decoded.get(url);
+        if (!p) {
+            p = loader.loadAsync(url).then((g) => g.scene);
+            decoded.set(url, p);
+        }
+        return p.then((scene) => scene.clone());
+    };
+}
+/** Loaded worlds, keyed by {@link CoreWorld.id}. See the module doc for the lifecycle contract. */
+const worldCache = new Map();
+/**
+ * Load (and cache by id) a platform world's meshes. Re-calling for the same `coreWorld.id` resolves to
+ * the **same** {@link LoadedWorld} handle instantly — no re-fetch / re-decode / re-upload — so games
+ * that rebuild gameplay on restart keep an instant world. `placement`, if given, is applied to the
+ * group on every call (cheap). Rejects if any glb fails to load.
+ */
+export function loadWorld(coreWorld, opts = {}) {
+    let p = worldCache.get(coreWorld.id);
+    if (!p) {
+        p = buildWorld(coreWorld, opts);
+        // Don't cache a rejected build — let the next attempt retry the fetch.
+        p.catch(() => {
+            if (worldCache.get(coreWorld.id) === p)
+                worldCache.delete(coreWorld.id);
+        });
+        worldCache.set(coreWorld.id, p);
+    }
+    return p.then((world) => {
+        if (opts.placement)
+            applyPlacement(world.group, opts.placement);
+        return world;
+    });
+}
+async function buildWorld(coreWorld, opts) {
+    const group = new THREE.Group();
+    group.name = "platform-world";
+    await applyWorld(group, coreWorld, { loadGlb: createGlbLoader(opts) });
+    const id = coreWorld.id;
+    return {
+        id,
+        group,
+        attach: (parent) => void parent.add(group),
+        detach: () => void group.removeFromParent(),
+        dispose: () => {
+            disposeGroup(group);
+            if (worldCache.has(id))
+                worldCache.delete(id);
+        },
+    };
+}
+/** Apply a {@link WorldPlacement} (translate · Y-rotation · uniform scale) to a group. */
+export function applyPlacement(group, placement) {
+    if (placement.position)
+        group.position.fromArray(placement.position);
+    if (placement.rotationY !== undefined)
+        group.rotation.y = placement.rotationY;
+    if (placement.scale !== undefined)
+        group.scale.setScalar(placement.scale);
+}
+/**
+ * Release cached worlds and dispose their geometry + materials (textures are left alone — they may be
+ * shared elsewhere). Pass an `id` to drop a single world, or omit it to clear everything. Equivalent
+ * to calling `dispose()` on the matching handle(s); use it when you don't hold the handle.
+ */
+export function clearWorldCache(id) {
+    const drop = (key, promise) => {
+        worldCache.delete(key);
+        void promise.then((w) => disposeGroup(w.group)).catch(() => { });
+    };
+    if (id !== undefined) {
+        const p = worldCache.get(id);
+        if (p)
+            drop(id, p);
+        return;
+    }
+    for (const [key, p] of worldCache)
+        drop(key, p);
+}
+/** Remove a group from its parent and dispose its geometry + materials (not textures). */
+function disposeGroup(group) {
+    group.removeFromParent();
+    group.traverse((o) => {
+        const mesh = o;
+        if (!mesh.isMesh)
+            return;
+        mesh.geometry?.dispose();
+        for (const m of Array.isArray(mesh.material) ? mesh.material : [mesh.material]) {
+            m?.dispose();
+        }
+    });
+}
+//# sourceMappingURL=world-loader.js.map

package/dist/three/world-loader.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rydr/game-sdk",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bdefrenne/rydr-game-sdk.git"
@@ -15,6 +15,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./three": {
+      "types": "./dist/three/index.d.ts",
+      "import": "./dist/three/index.js"
     }
   },
   "main": "./dist/index.js",
@@ -32,7 +36,17 @@
     "version": "node scripts/sync-version.mjs && node scripts/release-changelog.mjs && git add src/protocol/version.ts CHANGELOG.md",
     "postversion": "git push --follow-tags"
   },
+  "peerDependencies": {
+    "three": ">=0.160.0"
+  },
+  "peerDependenciesMeta": {
+    "three": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@types/three": "^0.184.0",
+    "three": "^0.184.0",
     "typescript": "^5.5.0"
   }
 }