@oyna360/lobby-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 oyna360
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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.

package/README.md

@@ -0,0 +1,123 @@
+# @oyna360/lobby-sdk
+
+لابی سه‌بعدی **oyna360** برای بازی‌سازان — بر پایه Babylon.js.
+
+پلتفرم هویت، آواتار و اتاق WebSocket را می‌دهد.  
+**ظاهر لابی، پورتال‌ها و شروع گیم‌پلی مال شماست.**
+
+**نسخه پکیج:** مطابق GitHub tag · پروتکل داخل همین پکیج است — `@platform/lobby-protocol` را نصب نکنید.
+
+> اتصال اولیه به پلتفرم (سشن / Authorize) کار [`@oyna360/game-sdk`](https://github.com/mamadjavadrasti/oyna360-game-sdk) است. این SDK لابی را اجرا می‌کند، لاگین نمی‌کند.
+
+---
+
+## نصب
+
+```bash
+npm install github:mamadjavadrasti/oyna360-lobby-sdk#master @babylonjs/core
+```
+
+`@babylonjs/core` peer dependency است (نسخه ۷ توصیه می‌شود).
+
+```json
+{
+  "dependencies": {
+    "@oyna360/lobby-sdk": "github:mamadjavadrasti/oyna360-lobby-sdk#master",
+    "@babylonjs/core": "^7.44.0"
+  }
+}
+```
+
+تگ/`dist` تازه را پین کنید. اگر `dist/index.js` هنوز `@platform/lobby-protocol` import کند، بیلد کهنه است.
+
+---
+
+## سه حالت ورود به لابی
+
+| حالت | کی استفاده کنید | API |
+|------|------------------|-----|
+| **Production** | بازیکن از `/play/{slug}` آمده | `createFromPlatform` یا `create({ platformInit })` بعد از game-sdk |
+| **Direct Development** | بازی روی origin خودتان + game-sdk Authorize | `create({ platformInit })` با Context از `PlatformSDK.init()` |
+| **Offline / Fake** | تست UI بدون سرور | `createDev()` — مالتی‌پلیر واقعی ندارد |
+
+---
+
+## شروع سریع — با پلتفرم واقعی
+
+```ts
+import { PlatformSDK } from '@oyna360/game-sdk';
+import { PlatformLobby } from '@oyna360/lobby-sdk';
+
+const canvas = document.getElementById('lobby') as HTMLCanvasElement;
+
+// 1) Context از پلتفرم (iframe یا Direct Dev)
+const init = await PlatformSDK.init({
+  // Direct فقط:
+  // platformUrl, platformWebUrl, gameSlug
+});
+
+// 2) لابی واقعی
+const lobby = await PlatformLobby.create({
+  canvas,
+  platformInit: init,
+  roomId: init.lobby!.roomId,
+  wsUrl: init.lobby!.wsUrl,
+});
+
+lobby.applyPlazaLayout({
+  onRoomStart: (room) => {
+    lobby.destroy();
+    startGameplay(room.id);
+  },
+});
+```
+
+`wsUrl` / `roomId` را هاردکد نکنید.
+
+---
+
+## شروع سریع — فقط UI آفلاین
+
+```ts
+const lobby = await PlatformLobby.createDev({
+  canvas,
+  roomId: 'game:my-game',
+  config: { enableMultiplayer: false },
+});
+lobby.applyPlazaLayout();
+```
+
+این مسیر برای توسعه ظاهر است، نه تست مالتی‌پلیر روی سرور.
+
+---
+
+## مستندات
+
+| موضوع | فایل |
+|--------|------|
+| نقش SDK و مرز با game-sdk | [docs/00-overview.md](./docs/00-overview.md) |
+| اتصال و پیش‌نیاز | [docs/01-connect.md](./docs/01-connect.md) |
+| حالت‌های Production / Direct / Dev | [docs/03-modes.md](./docs/03-modes.md) |
+| API `PlatformLobby` | [docs/04-api.md](./docs/04-api.md) |
+| آواتار، چت، voice، data | [docs/05-features.md](./docs/05-features.md) |
+| کنترل‌ها و موبایل | [docs/06-controls.md](./docs/06-controls.md) |
+| عیب‌یابی | [docs/07-troubleshooting.md](./docs/07-troubleshooting.md) |
+| انتشار از GitHub | [docs/02-github.md](./docs/02-github.md) |
+
+---
+
+## امکانات اصلی
+
+- صحنه Babylon، دوربین سوم‌شخص، برخورد
+- آواتار procedural / GLB + اکسسوری
+- بازیکنان remote، حرکت، انیمیشن
+- چت زنده، presence، voice (اختیاری)
+- کانال `lobby:data` برای matchmaking / کنترل بازی
+- Plaza / Starter layout، zone، portal، plugin
+- کیفیت خودکار و UI فارسی/انگلیسی
+
+---
+
+## لایسنس
+
+MIT

package/dist/avatar-accessories.d.ts

@@ -0,0 +1,16 @@
+import { Scene, TransformNode } from '@babylonjs/core';
+export type AccessoryPrimitive = 'cap' | 'pack' | 'glasses' | 'watch';
+export interface EquippedAccessory {
+    slot: 'hat' | 'back' | 'face' | 'hand';
+    itemId: string;
+    glbUrl?: string;
+    primitive?: AccessoryPrimitive;
+    attachBone?: string;
+}
+/**
+ * Attach equipped accessories onto an avatar root produced by AvatarFactory.
+ * Safe to call repeatedly — clears previous `metadata.accessoryNodes` first.
+ */
+export declare function attachAvatarAccessories(scene: Scene, root: TransformNode, accessories: EquippedAccessory[] | undefined | null): Promise<void>;
+export declare function attachAccessoriesFromAvatarConfig(scene: Scene, root: TransformNode, customConfig: Record<string, unknown> | undefined): Promise<void>;
+//# sourceMappingURL=avatar-accessories.d.ts.map

package/dist/avatar-accessories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-accessories.d.ts","sourceRoot":"","sources":["../src/avatar-accessories.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,EAGL,aAAa,EAEd,MAAM,iBAAiB,CAAC;AAIzB,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAmLD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,iBAAiB,EAAE,GAAG,SAAS,GAAG,IAAI,iBA8CpD;AAED,wBAAsB,iCAAiC,CACrD,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,aAAa,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,iBAGlD"}

package/dist/avatar-accessories.js

@@ -0,0 +1,214 @@
+import { Color3, Material, MeshBuilder, SceneLoader, StandardMaterial, TransformNode, Vector3 as BVector3, } from '@babylonjs/core';
+function solid(scene, name, color) {
+    const mat = new StandardMaterial(name, scene);
+    mat.diffuseColor = Color3.FromHexString(color);
+    mat.specularColor = Color3.Black();
+    return mat;
+}
+function getRig(root) {
+    return root.metadata?.rig ?? null;
+}
+function resolveAttachParent(rig, slot, attachBone) {
+    if (attachBone && rig.humanoid?.joints) {
+        const joint = rig.humanoid.joints[attachBone];
+        if (joint?.node)
+            return joint.node;
+    }
+    const humanoid = rig.humanoid;
+    switch (slot) {
+        case 'hat':
+        case 'face':
+            return humanoid?.joints.head?.node ?? rig.head;
+        case 'back':
+            return humanoid?.joints.chest?.node ?? rig.torso;
+        case 'hand':
+            return humanoid?.joints.handR?.node ?? rig.armR;
+        default:
+            return rig.head;
+    }
+}
+function localOffset(slot) {
+    switch (slot) {
+        case 'hat':
+            return new BVector3(0, 0.18, 0);
+        case 'face':
+            return new BVector3(0, 0.02, 0.12);
+        case 'back':
+            return new BVector3(0, 0.05, -0.18);
+        case 'hand':
+            return new BVector3(0, -0.35, 0);
+    }
+}
+function buildPrimitive(scene, name, primitive, parent, slot) {
+    const root = new TransformNode(`${name}-acc`, scene);
+    root.parent = parent;
+    root.position = localOffset(slot);
+    if (primitive === 'cap') {
+        const mat = solid(scene, `${name}-cap-mat`, '#2563eb');
+        const brim = MeshBuilder.CreateCylinder(`${name}-brim`, { diameter: 0.42, height: 0.04, tessellation: 20 }, scene);
+        brim.parent = root;
+        brim.position.y = 0.02;
+        brim.material = mat;
+        const dome = MeshBuilder.CreateSphere(`${name}-dome`, { diameter: 0.34, segments: 12 }, scene);
+        dome.parent = root;
+        dome.position.y = 0.14;
+        dome.scaling.y = 0.7;
+        dome.material = mat;
+    }
+    else if (primitive === 'pack') {
+        const mat = solid(scene, `${name}-pack-mat`, '#78350f');
+        const pack = MeshBuilder.CreateBox(`${name}-pack`, { width: 0.36, height: 0.42, depth: 0.18 }, scene);
+        pack.parent = root;
+        pack.material = mat;
+    }
+    else if (primitive === 'glasses') {
+        const mat = solid(scene, `${name}-glasses-mat`, '#111827');
+        const left = MeshBuilder.CreateTorus(`${name}-gl`, { diameter: 0.12, thickness: 0.015, tessellation: 12 }, scene);
+        left.parent = root;
+        left.position.set(-0.07, 0, 0.02);
+        left.rotation.x = Math.PI / 2;
+        left.material = mat;
+        const right = left.clone(`${name}-gr`, root);
+        right.position.x = 0.07;
+    }
+    else if (primitive === 'watch') {
+        const mat = solid(scene, `${name}-watch-mat`, '#f59e0b');
+        const band = MeshBuilder.CreateTorus(`${name}-band`, { diameter: 0.1, thickness: 0.02, tessellation: 12 }, scene);
+        band.parent = root;
+        band.rotation.z = Math.PI / 2;
+        band.material = mat;
+    }
+    return root;
+}
+async function loadAccessoryGlb(scene, name, glbUrl, parent, slot) {
+    const slash = glbUrl.lastIndexOf('/');
+    const rootUrl = slash >= 0 ? glbUrl.slice(0, slash + 1) : '';
+    const fileName = slash >= 0 ? glbUrl.slice(slash + 1) : glbUrl;
+    const result = await SceneLoader.ImportMeshAsync('', rootUrl, fileName, scene);
+    const holder = new TransformNode(`${name}-acc`, scene);
+    holder.parent = parent;
+    holder.position = localOffset(slot);
+    const meshes = result.meshes;
+    for (const mesh of meshes) {
+        if (mesh.name === '__root__' || !mesh.parent || mesh.parent === scene) {
+            mesh.parent = holder;
+        }
+        mesh.receiveShadows = false;
+        if (mesh.material) {
+            const mat = mesh.material;
+            mat.backFaceCulling = false;
+            mat.alpha = 1;
+            mat.transparencyMode = Material.MATERIAL_OPAQUE;
+            mat.alphaMode = 0;
+            mat.disableDepthWrite = false;
+            mat.forceDepthWrite = false;
+        }
+    }
+    return holder;
+}
+function readAccessories(avatarConfig) {
+    const raw = avatarConfig?.accessories;
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const entry of raw) {
+        if (!entry || typeof entry !== 'object')
+            continue;
+        const slot = entry.slot;
+        const itemId = entry.itemId;
+        if (slot !== 'hat' && slot !== 'back' && slot !== 'face' && slot !== 'hand')
+            continue;
+        if (typeof itemId !== 'string' || !itemId)
+            continue;
+        const acc = { slot, itemId };
+        const glbUrl = entry.glbUrl;
+        const primitive = entry.primitive;
+        const attachBone = entry.attachBone;
+        if (typeof glbUrl === 'string' && glbUrl)
+            acc.glbUrl = glbUrl;
+        if (primitive === 'cap' ||
+            primitive === 'pack' ||
+            primitive === 'glasses' ||
+            primitive === 'watch') {
+            acc.primitive = primitive;
+        }
+        if (typeof attachBone === 'string' && attachBone)
+            acc.attachBone = attachBone;
+        out.push(acc);
+    }
+    return out;
+}
+/**
+ * Colour-variant albedo is one GPU texture shared by every avatar wearing it,
+ * so a node being disposed must let go of it instead of freeing it.
+ */
+function detachSharedTextures(node) {
+    for (const mesh of [node, ...node.getChildMeshes(false)]) {
+        const materials = [mesh.material, ...(mesh.material?.subMaterials ?? [])];
+        for (const material of materials) {
+            if (!material)
+                continue;
+            const mat = material;
+            for (const slot of ['albedoTexture', 'diffuseTexture']) {
+                const texture = mat[slot];
+                if (texture?.metadata?.sharedAvatarAlbedo)
+                    mat[slot] = null;
+            }
+        }
+    }
+}
+/**
+ * Attach equipped accessories onto an avatar root produced by AvatarFactory.
+ * Safe to call repeatedly — clears previous `metadata.accessoryNodes` first.
+ */
+export async function attachAvatarAccessories(scene, root, accessories) {
+    const previous = root.metadata?.accessoryNodes ?? [];
+    for (const node of previous) {
+        try {
+            detachSharedTextures(node);
+            node.dispose(false, true);
+        }
+        catch {
+            // ignore
+        }
+    }
+    const rig = getRig(root);
+    if (!rig || !accessories?.length) {
+        root.metadata = { ...(root.metadata ?? {}), accessoryNodes: [] };
+        return;
+    }
+    const nodes = [];
+    for (const acc of accessories) {
+        const parent = resolveAttachParent(rig, acc.slot, acc.attachBone);
+        const name = `${root.name}-${acc.slot}-${acc.itemId}`;
+        try {
+            if (acc.glbUrl) {
+                const absolute = typeof window !== 'undefined' && acc.glbUrl.startsWith('/')
+                    ? (() => {
+                        try {
+                            const ref = document.referrer ? new URL(document.referrer).origin : '';
+                            if (ref && ref !== window.location.origin)
+                                return `${ref}${acc.glbUrl}`;
+                        }
+                        catch {
+                            // ignore
+                        }
+                        return `${window.location.origin}${acc.glbUrl}`;
+                    })()
+                    : acc.glbUrl;
+                nodes.push(await loadAccessoryGlb(scene, name, absolute, parent, acc.slot));
+            }
+            else if (acc.primitive) {
+                nodes.push(buildPrimitive(scene, name, acc.primitive, parent, acc.slot));
+            }
+        }
+        catch (err) {
+            console.warn('[lobby-sdk] accessory attach failed', acc, err);
+        }
+    }
+    root.metadata = { ...(root.metadata ?? {}), accessoryNodes: nodes };
+}
+export async function attachAccessoriesFromAvatarConfig(scene, root, customConfig) {
+    await attachAvatarAccessories(scene, root, readAccessories(customConfig));
+}
+//# sourceMappingURL=avatar-accessories.js.map

package/dist/avatar-accessories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-accessories.js","sourceRoot":"","sources":["../src/avatar-accessories.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,QAAQ,EACR,WAAW,EAEX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,OAAO,IAAI,QAAQ,GACpB,MAAM,iBAAiB,CAAC;AAczB,SAAS,KAAK,CAAC,KAAY,EAAE,IAAY,EAAE,KAAa;IACtD,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9C,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/C,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;IACnC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,MAAM,CAAC,IAAmB;IACjC,OAAQ,IAAI,CAAC,QAAQ,EAAE,GAA6B,IAAI,IAAI,CAAC;AAC/D,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAc,EAAE,IAA+B,EAAE,UAAmB;IAC/F,IAAI,UAAU,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,UAA8C,CAAC,CAAC;QAClF,IAAI,KAAK,EAAE,IAAI;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC9B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QACjD,KAAK,MAAM;YACT,OAAO,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;QACnD,KAAK,MAAM;YACT,OAAO,QAAQ,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC;QAClD;YACE,OAAO,GAAG,CAAC,IAAI,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAA+B;IAClD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK;YACR,OAAO,IAAI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,IAAI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACrC,KAAK,MAAM;YACT,OAAO,IAAI,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,MAAM;YACT,OAAO,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAAY,EACZ,IAAY,EACZ,SAA6B,EAC7B,MAAqB,EACrB,IAA+B;IAE/B,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,GAAG,IAAI,MAAM,EAAE,KAAK,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAElC,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,UAAU,EAAE,SAAS,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QACnH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAC/F,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;SAAM,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,SAAS,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;QACtG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;SAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,cAAc,EAAE,SAAS,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,IAAI,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAClH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,EAAE,IAAI,CAAE,CAAC;QAC9C,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1B,CAAC;SAAM,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,IAAI,YAAY,EAAE,SAAS,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,GAAG,IAAI,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;QAClH,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,KAAY,EACZ,IAAY,EACZ,MAAc,EACd,MAAqB,EACrB,IAA+B;IAE/B,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,GAAG,IAAI,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAwB,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAM,KAAkC,EAAE,CAAC;YACpG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAoB,CAAC;YACtC,GAAG,CAAC,eAAe,GAAG,KAAK,CAAC;YAC5B,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;YACd,GAAG,CAAC,gBAAgB,GAAG,QAAQ,CAAC,eAAe,CAAC;YAChD,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;YAClB,GAAG,CAAC,iBAAiB,GAAG,KAAK,CAAC;YAC9B,GAAG,CAAC,eAAe,GAAG,KAAK,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,YAAiD;IACxE,MAAM,GAAG,GAAG,YAAY,EAAE,WAAW,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,SAAS;QAClD,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;QAChD,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;QACtD,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM;YAAE,SAAS;QACtF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM;YAAE,SAAS;QACpD,MAAM,GAAG,GAAsB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAChD,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;QACtD,MAAM,SAAS,GAAI,KAAiC,CAAC,SAAS,CAAC;QAC/D,MAAM,UAAU,GAAI,KAAkC,CAAC,UAAU,CAAC;QAClE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM;YAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9D,IACE,SAAS,KAAK,KAAK;YACnB,SAAS,KAAK,MAAM;YACpB,SAAS,KAAK,SAAS;YACvB,SAAS,KAAK,OAAO,EACrB,CAAC;YACD,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QAC5B,CAAC;QACD,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU;YAAE,GAAG,CAAC,UAAU,GAAG,UAAU,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAAC,IAAmB;IAC/C,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAErD,EAAE,CAAC;QACH,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1E,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ;gBAAE,SAAS;YACxB,MAAM,GAAG,GAAG,QAGX,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAU,EAAE,CAAC;gBAChE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAuF,CAAC;gBAChH,IAAI,OAAO,EAAE,QAAQ,EAAE,kBAAkB;oBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC9D,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAY,EACZ,IAAmB,EACnB,WAAmD;IAEnD,MAAM,QAAQ,GAAI,IAAI,CAAC,QAAQ,EAAE,cAA8C,IAAI,EAAE,CAAC;IACtF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;QACjE,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACtD,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,MAAM,QAAQ,GACZ,OAAO,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC;oBACzD,CAAC,CAAC,CAAC,GAAG,EAAE;wBACJ,IAAI,CAAC;4BACH,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;4BACvE,IAAI,GAAG,IAAI,GAAG,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM;gCAAE,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;wBAC1E,CAAC;wBAAC,MAAM,CAAC;4BACP,SAAS;wBACX,CAAC;wBACD,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;oBAClD,CAAC,CAAC,EAAE;oBACN,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9E,CAAC;iBAAM,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,qCAAqC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,KAAY,EACZ,IAAmB,EACnB,YAAiD;IAEjD,MAAM,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/avatar-asset-manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Avatar GLB asset loading + per-scene container cache + clone/instantiate.
+ * Moved verbatim from AvatarFactory (phase-2 isolation). No behavior changes.
+ */
+import { Scene, Skeleton, TransformNode } from '@babylonjs/core';
+import type { AbstractMesh, AnimationGroup, AssetContainer } from '@babylonjs/core';
+import '@babylonjs/loaders/glTF';
+import '@babylonjs/core/Meshes/Compression/dracoCompression';
+/** Same file on :3000/uploads vs :3001/uploads must share one GPU/container copy. */
+export declare function assetCacheKey(url: string): string;
+export interface GlbInstance {
+    meshes: AbstractMesh[];
+    transformNodes: TransformNode[];
+    skeletons: Skeleton[];
+    animationGroups: AnimationGroup[];
+}
+/** Stable catalog entry for a shared base GLB (tint/accessories apply later on instances). */
+export interface AvatarBaseDef {
+    id: string;
+    glbUrl: string;
+}
+export declare class AvatarAssetManager {
+    /** Load (or cache-hit) + clone one avatar GLB instance into the scene. */
+    static instantiateAvatarGlb(scene: Scene, glbUrl: string): Promise<GlbInstance>;
+    /** Expose container load for diagnostics/tests — same cache as instantiate. */
+    static loadContainer(scene: Scene, glbUrl: string): Promise<AssetContainer>;
+    /**
+     * Warm the per-scene container cache for an arbitrary GLB URL (no registry required).
+     * Non-throwing — used when a remote joins with a base that was not pre-registered.
+     */
+    static warmGlbUrl(scene: Scene, glbUrl: string): Promise<AssetContainer | null>;
+    /** Register / replace a base avatar catalog entry (id → glbUrl). */
+    static registerAvatarBase(def: AvatarBaseDef): void;
+    static registerAvatarBases(defs: readonly AvatarBaseDef[]): void;
+    static getAvatarBase(id: string): AvatarBaseDef | undefined;
+    static listAvatarBases(): AvatarBaseDef[];
+    /** True when this scene already has a (pending or resolved) container promise for the URL. */
+    static isContainerCached(scene: Scene, glbUrl: string): boolean;
+    static isAvatarBaseCached(scene: Scene, id: string): boolean;
+    /**
+     * Warm the shared glbContainerCache for a registered base.
+     * Reuses loadGlbContainer — no duplicate parse path. Failures resolve to null (non-throwing).
+     */
+    static preloadAvatarBase(scene: Scene, id: string): Promise<AssetContainer | null>;
+    /**
+     * Preload one or more bases. Omitting ids preloads the full registry.
+     * Uses Promise.allSettled semantics per id (one failure does not abort others).
+     */
+    static preloadAvatarBases(scene: Scene, ids?: readonly string[]): Promise<Array<{
+        id: string;
+        ok: boolean;
+    }>>;
+}
+//# sourceMappingURL=avatar-asset-manager.d.ts.map

package/dist/avatar-asset-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-asset-manager.d.ts","sourceRoot":"","sources":["../src/avatar-asset-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,KAAK,EAEL,QAAQ,EACR,aAAa,EACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpF,OAAO,yBAAyB,CAAC;AACjC,OAAO,qDAAqD,CAAC;AAK7D,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,eAAe,EAAE,cAAc,EAAE,CAAC;CACnC;AAED,8FAA8F;AAC9F,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAyHD,qBAAa,kBAAkB;IAC7B,0EAA0E;IAC1E,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI/E,+EAA+E;IAC/E,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAI3E;;;OAGG;WACU,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAWrF,oEAAoE;IACpE,MAAM,CAAC,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAKnD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI;IAIhE,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI3D,MAAM,CAAC,eAAe,IAAI,aAAa,EAAE;IAIzC,8FAA8F;IAC9F,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAM/D,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IAM5D;;;OAGG;WACU,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqBxF;;;OAGG;WACU,kBAAkB,CAC7B,KAAK,EAAE,KAAK,EACZ,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAU/C"}

package/dist/avatar-asset-manager.js

@@ -0,0 +1,215 @@
+/**
+ * Avatar GLB asset loading + per-scene container cache + clone/instantiate.
+ * Moved verbatim from AvatarFactory (phase-2 isolation). No behavior changes.
+ */
+import { SceneLoader, } from '@babylonjs/core';
+import '@babylonjs/loaders/glTF';
+import '@babylonjs/core/Meshes/Compression/dracoCompression';
+import { ensureDracoDecoder } from './draco';
+import { isLobbyPerfDiagEnabled, lobbyPerfMark, lobbyPerfTimeAsync } from './lobby-perf-diag';
+import { yieldToRenderLoop } from './yield-to-render';
+/** Same file on :3000/uploads vs :3001/uploads must share one GPU/container copy. */
+export function assetCacheKey(url) {
+    if (!url || url.startsWith('data:'))
+        return url;
+    try {
+        const parsed = new URL(url, 'http://lobby.local');
+        return parsed.pathname || url;
+    }
+    catch {
+        return url;
+    }
+}
+/** App-level base registry (not per-scene). Container cache remains per-scene. */
+const avatarBaseRegistry = new Map();
+/** One download + parse per avatar GLB per scene; every player clones from it. */
+const glbContainerCache = new WeakMap();
+let glbCloneSerial = 0;
+function getSceneContainerMap(scene) {
+    let byUrl = glbContainerCache.get(scene);
+    if (!byUrl) {
+        byUrl = new Map();
+        glbContainerCache.set(scene, byUrl);
+        scene.onDisposeObservable.addOnce(() => glbContainerCache.delete(scene));
+    }
+    return byUrl;
+}
+function loadGlbContainer(scene, glbUrl) {
+    const byUrl = getSceneContainerMap(scene);
+    const cacheKey = assetCacheKey(glbUrl);
+    const cached = byUrl.get(cacheKey);
+    if (cached) {
+        if (isLobbyPerfDiagEnabled()) {
+            return lobbyPerfTimeAsync('glb_container_load', () => cached, 'cache_hit');
+        }
+        return cached;
+    }
+    // Draco WASM must be ready before the first compressed avatar parse.
+    const pending = (async () => {
+        const tDraco = performance.now();
+        await ensureDracoDecoder();
+        if (isLobbyPerfDiagEnabled()) {
+            lobbyPerfMark('draco_ensure', performance.now() - tDraco, glbUrl.slice(-48));
+        }
+        const tLoad = performance.now();
+        const container = await SceneLoader.LoadAssetContainerAsync('', glbUrl, scene, null, 
+        // A data URI carries no filename for the loader to sniff an extension from.
+        glbUrl.startsWith('data:') ? '.glb' : undefined);
+        if (isLobbyPerfDiagEnabled()) {
+            lobbyPerfMark('glb_container_load', performance.now() - tLoad, `cache_miss:${glbUrl.slice(-64)}`);
+        }
+        // Template stays in the scene for cloning. Keep it off so it cannot render
+        // or steal a skeleton from a named lookup of "Mesh0" / "Armature".
+        for (const mesh of container.meshes) {
+            mesh.setEnabled(false);
+            mesh.isVisible = false;
+        }
+        return container;
+    })();
+    // A failed load must not poison later attempts (fallback URLs are retried).
+    pending.catch(() => byUrl?.delete(cacheKey));
+    byUrl.set(cacheKey, pending);
+    return pending;
+}
+/**
+ * Clone an avatar from the cached container instead of re-importing the file.
+ * Geometry and textures are shared; materials and skeletons are per avatar, so
+ * each player keeps their own colour variant and pose.
+ *
+ * Names MUST be unique. Babylon's instantiate looks up nodes by name; two
+ * avatars named "Mesh0"/"Armature" make the second clone steal the first
+ * skeleton — local body vanishes when someone else joins.
+ */
+async function instantiateGlb(scene, glbUrl) {
+    const container = await loadGlbContainer(scene, glbUrl);
+    // Container parse/Draco may resume on the main thread; yield so the lobby can paint
+    // (remote placeholder) before the deep clone/instantiate spike.
+    await yieldToRenderLoop();
+    const t0 = performance.now();
+    const serial = ++glbCloneSerial;
+    const entries = container.instantiateModelsToScene((name) => `${name}__a${serial}`, true, {
+        doNotInstantiate: true,
+    });
+    // Cloning a disabled template copies isEnabled=false. Turn the clone on,
+    // and keep the shared template off so it never renders under the plaza.
+    for (const mesh of container.meshes) {
+        mesh.setEnabled(false);
+        mesh.isVisible = false;
+    }
+    const meshes = [];
+    const transformNodes = [];
+    for (const rootNode of entries.rootNodes) {
+        rootNode.setEnabled(true);
+        for (const node of [rootNode, ...rootNode.getDescendants(false)]) {
+            node.setEnabled(true);
+            const mesh = node;
+            if (typeof mesh.getTotalVertices === 'function') {
+                mesh.isVisible = true;
+                mesh.visibility = 1;
+                meshes.push(mesh);
+            }
+            else {
+                transformNodes.push(node);
+            }
+        }
+    }
+    if (isLobbyPerfDiagEnabled()) {
+        lobbyPerfMark('glb_instantiate', performance.now() - t0, `serial=${serial}`);
+    }
+    console.info('[lobby-sdk] GLB cloned', { serial, names: meshes.map((m) => m.name) });
+    return {
+        meshes,
+        transformNodes,
+        skeletons: entries.skeletons,
+        animationGroups: entries.animationGroups,
+    };
+}
+export class AvatarAssetManager {
+    /** Load (or cache-hit) + clone one avatar GLB instance into the scene. */
+    static instantiateAvatarGlb(scene, glbUrl) {
+        return instantiateGlb(scene, glbUrl);
+    }
+    /** Expose container load for diagnostics/tests — same cache as instantiate. */
+    static loadContainer(scene, glbUrl) {
+        return loadGlbContainer(scene, glbUrl);
+    }
+    /**
+     * Warm the per-scene container cache for an arbitrary GLB URL (no registry required).
+     * Non-throwing — used when a remote joins with a base that was not pre-registered.
+     */
+    static async warmGlbUrl(scene, glbUrl) {
+        const url = typeof glbUrl === 'string' ? glbUrl.trim() : '';
+        if (!url)
+            return null;
+        try {
+            return await loadGlbContainer(scene, url);
+        }
+        catch (err) {
+            console.warn('[lobby-sdk] warmGlbUrl failed', url.slice(-64), err);
+            return null;
+        }
+    }
+    /** Register / replace a base avatar catalog entry (id → glbUrl). */
+    static registerAvatarBase(def) {
+        if (!def?.id || typeof def.glbUrl !== 'string' || !def.glbUrl.trim())
+            return;
+        avatarBaseRegistry.set(def.id, { id: def.id, glbUrl: def.glbUrl.trim() });
+    }
+    static registerAvatarBases(defs) {
+        for (const def of defs)
+            this.registerAvatarBase(def);
+    }
+    static getAvatarBase(id) {
+        return avatarBaseRegistry.get(id);
+    }
+    static listAvatarBases() {
+        return [...avatarBaseRegistry.values()];
+    }
+    /** True when this scene already has a (pending or resolved) container promise for the URL. */
+    static isContainerCached(scene, glbUrl) {
+        const byUrl = glbContainerCache.get(scene);
+        if (!byUrl)
+            return false;
+        return byUrl.has(assetCacheKey(glbUrl));
+    }
+    static isAvatarBaseCached(scene, id) {
+        const base = avatarBaseRegistry.get(id);
+        if (!base)
+            return false;
+        return this.isContainerCached(scene, base.glbUrl);
+    }
+    /**
+     * Warm the shared glbContainerCache for a registered base.
+     * Reuses loadGlbContainer — no duplicate parse path. Failures resolve to null (non-throwing).
+     */
+    static async preloadAvatarBase(scene, id) {
+        const base = avatarBaseRegistry.get(id);
+        if (!base) {
+            console.warn('[lobby-sdk] preloadAvatarBase: unknown base id', id);
+            return null;
+        }
+        try {
+            if (isLobbyPerfDiagEnabled()) {
+                return await lobbyPerfTimeAsync('glb_preload', () => loadGlbContainer(scene, base.glbUrl), id);
+            }
+            return await loadGlbContainer(scene, base.glbUrl);
+        }
+        catch (err) {
+            console.warn('[lobby-sdk] preloadAvatarBase failed', id, err);
+            return null;
+        }
+    }
+    /**
+     * Preload one or more bases. Omitting ids preloads the full registry.
+     * Uses Promise.allSettled semantics per id (one failure does not abort others).
+     */
+    static async preloadAvatarBases(scene, ids) {
+        const list = ids?.length ? [...ids] : [...avatarBaseRegistry.keys()];
+        const settled = await Promise.all(list.map(async (id) => {
+            const container = await this.preloadAvatarBase(scene, id);
+            return { id, ok: !!container };
+        }));
+        return settled;
+    }
+}
+//# sourceMappingURL=avatar-asset-manager.js.map