@oyna360/lobby-sdk 0.1.0

package/dist/avatar-asset-manager.js.map

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

package/dist/avatar-clips.d.ts

@@ -0,0 +1,17 @@
+import type { LobbyAnimationState } from './protocol';
+/** Alias lists used to map lobby locomotion → clip names in a GLB. */
+export declare const AVATAR_CLIP_ALIASES: Record<LobbyAnimationState, string[]>;
+export type NamedClip = {
+    name: string;
+};
+/**
+ * Pick the best animation clip for a locomotion state.
+ *
+ * Important: never fall back idle → walk (Meshy often ships only Walking;
+ * playing it while standing looks like the avatar always walks).
+ * Returns null when no suitable clip exists — caller should freeze bind pose.
+ */
+export declare function pickAvatarClip<T extends NamedClip>(clips: readonly T[], state: LobbyAnimationState): T | null;
+/** Drop duplicate clip names (Meshy often emits the same anim twice). Keep first. */
+export declare function dedupeClipsByName<T extends NamedClip>(clips: readonly T[]): T[];
+//# sourceMappingURL=avatar-clips.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-clips.d.ts","sourceRoot":"","sources":["../src/avatar-clips.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAMrE,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMzC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAChD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,KAAK,EAAE,mBAAmB,GACzB,CAAC,GAAG,IAAI,CAgBV;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAU/E"}

package/dist/avatar-clips.js

@@ -0,0 +1,47 @@
+/** Alias lists used to map lobby locomotion → clip names in a GLB. */
+export const AVATAR_CLIP_ALIASES = {
+    idle: ['idle', 'Idle', 'stand', 'Standing', 'TPose', 'APose'],
+    walk: ['walk', 'Walk', 'walking', 'Walking', 'locomotion'],
+    run: ['run', 'Run', 'running', 'Running', 'sprint', 'Sprint'],
+    jump: ['jump', 'Jump'],
+    fall: ['fall', 'Fall', 'falling', 'Falling'],
+};
+function matchAlias(clips, aliases) {
+    return clips.find((c) => aliases.some((a) => c.name.toLowerCase().includes(a.toLowerCase()))) ?? null;
+}
+/**
+ * Pick the best animation clip for a locomotion state.
+ *
+ * Important: never fall back idle → walk (Meshy often ships only Walking;
+ * playing it while standing looks like the avatar always walks).
+ * Returns null when no suitable clip exists — caller should freeze bind pose.
+ */
+export function pickAvatarClip(clips, state) {
+    if (!clips.length)
+        return null;
+    const direct = matchAlias(clips, AVATAR_CLIP_ALIASES[state]);
+    if (direct)
+        return direct;
+    if (state === 'run') {
+        return matchAlias(clips, AVATAR_CLIP_ALIASES.walk);
+    }
+    if (state === 'jump' || state === 'fall') {
+        return matchAlias(clips, AVATAR_CLIP_ALIASES.idle);
+    }
+    // idle / walk with no matching clip → null (bind pose), never invent a clip
+    return null;
+}
+/** Drop duplicate clip names (Meshy often emits the same anim twice). Keep first. */
+export function dedupeClipsByName(clips) {
+    const seen = new Set();
+    const out = [];
+    for (const clip of clips) {
+        const key = clip.name.trim().toLowerCase() || `__anon_${out.length}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(clip);
+    }
+    return out;
+}
+//# sourceMappingURL=avatar-clips.js.map

package/dist/avatar-clips.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-clips.js","sourceRoot":"","sources":["../src/avatar-clips.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAA0C;IACxE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC;IAC7D,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC;IAC1D,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC7D,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;CAC7C,CAAC;AAIF,SAAS,UAAU,CAAsB,KAAmB,EAAE,OAAiB;IAC7E,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAmB,EACnB,KAA0B;IAE1B,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,UAAU,CAAC,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACzC,OAAO,UAAU,CAAC,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,4EAA4E;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,iBAAiB,CAAsB,KAAmB;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,UAAU,GAAG,CAAC,MAAM,EAAE,CAAC;QACrE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/avatar-config.d.ts

@@ -0,0 +1,4 @@
+import type { SdkLobbyAvatar } from './platform-types';
+/** Resolve absolute/relative glbUrl from SdkLobbyAvatar (phase A config). */
+export declare function resolveGlbUrl(avatar: SdkLobbyAvatar): string | null;
+//# sourceMappingURL=avatar-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-config.d.ts","sourceRoot":"","sources":["../src/avatar-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAKnE"}

package/dist/avatar-config.js

@@ -0,0 +1,9 @@
+/** Resolve absolute/relative glbUrl from SdkLobbyAvatar (phase A config). */
+export function resolveGlbUrl(avatar) {
+    if (avatar.presetKind !== 'glb')
+        return null;
+    const config = (avatar.customConfig ?? {});
+    const url = config.glbUrl;
+    return typeof url === 'string' && url.trim() ? url.trim() : null;
+}
+//# sourceMappingURL=avatar-config.js.map

package/dist/avatar-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-config.js","sourceRoot":"","sources":["../src/avatar-config.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,IAAI,MAAM,CAAC,UAAU,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAA4B,CAAC;IACtE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1B,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC"}

package/dist/avatar-factory.d.ts

@@ -0,0 +1,64 @@
+import { Scene, TransformNode } from '@babylonjs/core';
+import type { AnimationGroup } from '@babylonjs/core';
+import '@babylonjs/loaders/glTF';
+/** Register Draco decoder so compressed avatar GLBs (KHR_draco_mesh_compression) load. */
+import '@babylonjs/core/Meshes/Compression/dracoCompression';
+import type { SdkLobbyAvatar } from './platform-types';
+import { AvatarInstance } from './avatar-instance';
+import { applyAvatarBaseAlbedo, applyAvatarTint, hardenAvatarMaterials, readBaseAlbedoUrlFromConfig } from './avatar-material-pipeline';
+import { type AvatarRig } from './avatar-rig-builder';
+export type { AvatarRig } from './avatar-rig-builder';
+export { AvatarRigBuilder } from './avatar-rig-builder';
+export { applyAvatarTint, applyAvatarBaseAlbedo, readBaseAlbedoUrlFromConfig, hardenAvatarMaterials, };
+/** Resolve absolute/relative glbUrl from SdkLobbyAvatar (phase A config). */
+export { resolveGlbUrl } from './avatar-config';
+export declare class AvatarFactory {
+    static create(scene: Scene, avatar: SdkLobbyAvatar, name?: string, displayName?: string, username?: string, options?: {
+        collider?: boolean | 'player' | 'body';
+        skipNameTag?: boolean;
+    }): TransformNode;
+    /** Procedural sync create, or GLB load when presetKind is glb + glbUrl. */
+    static createAsync(scene: Scene, avatar: SdkLobbyAvatar, name?: string, displayName?: string, username?: string, options?: {
+        collider?: boolean | 'player' | 'body';
+        skipAccessories?: boolean;
+        skipNameTag?: boolean;
+    }): Promise<TransformNode>;
+    static markLobbyAvatar(root: TransformNode, scene: Scene): void;
+    /**
+     * Recount avatars and drop extra PBR maps / bloom once the room fills up.
+     * Safe to call after spawn or dispose.
+     */
+    static syncCrowdBudget(scene: Scene): void;
+    /** Re-tint materials without reloading the GLB (legacy / procedural). */
+    static setTint(root: TransformNode, hex: string | undefined | null): void;
+    /** Swap base albedo without reloading the GLB (clothing texture variants). */
+    static setBaseAlbedo(root: TransformNode, textureUrl: string | undefined | null): void;
+    private static createFromGlb;
+    static getRig(root: TransformNode): AvatarRig | null;
+    static getAnimationGroups(root: TransformNode): AnimationGroup[] | undefined;
+    static setPosition(root: TransformNode, position: {
+        x: number;
+        y: number;
+        z: number;
+    }): void;
+    static setRotationY(root: TransformNode, rotationY: number): void;
+    /** Phase-1: wrap a factory-built root as AvatarInstance (no rebuild). */
+    static wrap(root: TransformNode): AvatarInstance;
+    /**
+     * Phase-1 high-level spawn API for remotes/controllers.
+     * Builds a procedural stand-in without exposing GLB/material details to callers.
+     */
+    static createPlaceholderInstance(scene: Scene, avatar: SdkLobbyAvatar, name: string, displayName?: string, username?: string, options?: {
+        collider?: boolean | 'player' | 'body';
+        skipNameTag?: boolean;
+    }): AvatarInstance;
+    /**
+     * Phase-1 high-level spawn API — same pipeline as createAsync, returns AvatarInstance.
+     */
+    static createInstanceAsync(scene: Scene, avatar: SdkLobbyAvatar, name?: string, displayName?: string, username?: string, options?: {
+        collider?: boolean | 'player' | 'body';
+        skipAccessories?: boolean;
+        skipNameTag?: boolean;
+    }): Promise<AvatarInstance>;
+}
+//# sourceMappingURL=avatar-factory.d.ts.map

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

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

package/dist/avatar-factory.js

@@ -0,0 +1,464 @@
+import { Color3, Mesh, MeshBuilder, StandardMaterial, TransformNode, Vector3 as BVector3, VertexBuffer, } from '@babylonjs/core';
+import '@babylonjs/loaders/glTF';
+/** Register Draco decoder so compressed avatar GLBs (KHR_draco_mesh_compression) load. */
+import '@babylonjs/core/Meshes/Compression/dracoCompression';
+import { dedupeClipsByName } from './avatar-clips';
+import { resolveGlbUrl } from './avatar-config';
+import { attachNameTag } from './name-tag';
+import { isTouchDevice, shouldTrimAvatarDetailMaps } from './quality';
+import { isLobbyPerfDiagEnabled, lobbyPerfMark, lobbyPerfTimeAsync } from './lobby-perf-diag';
+import { AvatarInstance } from './avatar-instance';
+import { AvatarAssetManager } from './avatar-asset-manager';
+import { AvatarMaterialPipeline, applyAvatarBaseAlbedo, applyAvatarTint, hardenAvatarMaterials, lobbyQualityOf, readBaseAlbedoUrlFromConfig, readTintFromConfig, trimDetailMapsOnMaterials, } from './avatar-material-pipeline';
+import { AvatarRigBuilder } from './avatar-rig-builder';
+import { yieldToRenderLoop } from './yield-to-render';
+export { AvatarRigBuilder } from './avatar-rig-builder';
+export { applyAvatarTint, applyAvatarBaseAlbedo, readBaseAlbedoUrlFromConfig, hardenAvatarMaterials, };
+const PRESET_LOOKS = {
+    'default-1': { bodyColor: '#6366f1', accentColor: '#fbbf24', pantsColor: '#1e3a5f', hairColor: '#312e81' },
+    'default-2': { bodyColor: '#22c55e', accentColor: '#fde68a', pantsColor: '#14532d', hairColor: '#166534' },
+    'default-3': { bodyColor: '#f97316', accentColor: '#fecaca', pantsColor: '#7c2d12', hairColor: '#9a3412' },
+    'default-4': { bodyColor: '#64748b', accentColor: '#e2e8f0', pantsColor: '#0f172a', hairColor: '#334155' },
+};
+function colorFromConfig(value, fallback) {
+    try {
+        return Color3.FromHexString(typeof value === 'string' ? value : fallback);
+    }
+    catch {
+        return Color3.FromHexString(fallback);
+    }
+}
+function solid(scene, id, hex) {
+    const m = new StandardMaterial(id, scene);
+    m.diffuseColor = hex;
+    m.specularColor = new Color3(0.08, 0.08, 0.08);
+    return m;
+}
+function box(scene, name, size, material, parent, local) {
+    const mesh = MeshBuilder.CreateBox(name, size, scene);
+    mesh.material = material;
+    mesh.parent = parent;
+    mesh.position.set(local.x, local.y, local.z);
+    mesh.isPickable = false;
+    mesh.checkCollisions = false;
+    return mesh;
+}
+/** Resolve absolute/relative glbUrl from SdkLobbyAvatar (phase A config). */
+export { resolveGlbUrl } from './avatar-config';
+function fitGlbToHumanHeight(model, meshes, targetHeight = 1.85) {
+    if (!meshes.length)
+        return;
+    model.computeWorldMatrix(true);
+    for (const m of meshes) {
+        m.computeWorldMatrix(true);
+        try {
+            m.refreshBoundingInfo?.(true, true);
+        }
+        catch {
+            // ignore
+        }
+    }
+    let { min, max } = model.getHierarchyBoundingVectors(true);
+    let height = max.y - min.y;
+    // Skinned / broken bounds can be astronomical — fall back to local vertex AABB.
+    if (!(height > 0.01) || height > 20) {
+        let minY = Infinity;
+        let maxY = -Infinity;
+        let minX = Infinity;
+        let maxX = -Infinity;
+        let minZ = Infinity;
+        let maxZ = -Infinity;
+        for (const m of meshes) {
+            if (!(m instanceof Mesh))
+                continue;
+            const pos = m.getVerticesData(VertexBuffer.PositionKind);
+            if (!pos)
+                continue;
+            for (let i = 0; i < pos.length; i += 3) {
+                minX = Math.min(minX, pos[i]);
+                maxX = Math.max(maxX, pos[i]);
+                minY = Math.min(minY, pos[i + 1]);
+                maxY = Math.max(maxY, pos[i + 1]);
+                minZ = Math.min(minZ, pos[i + 2]);
+                maxZ = Math.max(maxZ, pos[i + 2]);
+            }
+        }
+        height = maxY - minY;
+        if (!(height > 0.01))
+            return;
+        const scale = targetHeight / height;
+        model.scaling.setAll(scale);
+        model.position.y = -minY * scale;
+        return;
+    }
+    const scale = targetHeight / height;
+    model.scaling.setAll(scale);
+    model.computeWorldMatrix(true);
+    for (const m of meshes)
+        m.computeWorldMatrix(true);
+    const fitted = model.getHierarchyBoundingVectors(true);
+    model.position.y -= fitted.min.y;
+}
+function stripCloneSuffix(name) {
+    return (name ?? '').replace(/__a\d+$/, '');
+}
+function isImportRootName(name) {
+    const base = stripCloneSuffix(name).toLowerCase();
+    return base === '__root__' || base === 'world';
+}
+export class AvatarFactory {
+    static create(scene, avatar, name = 'avatar', displayName, username, options = {}) {
+        const fromPreset = PRESET_LOOKS[avatar.presetKey] ?? PRESET_LOOKS['default-1'];
+        const config = {
+            ...fromPreset,
+            ...avatar.customConfig,
+        };
+        const shirt = colorFromConfig(config.bodyColor, '#4f46e5');
+        const skin = colorFromConfig(config.accentColor, '#fbbf24');
+        const pants = colorFromConfig(config.pantsColor, '#1e3a5f');
+        const shirtMat = solid(scene, `${name}-shirt-mat`, shirt);
+        const skinMat = solid(scene, `${name}-skin-mat`, skin);
+        const pantsMat = solid(scene, `${name}-pants-mat`, pants);
+        const visual = new TransformNode(`${name}-visual`, scene);
+        const tintMeshes = [];
+        const torso = new TransformNode(`${name}-torso`, scene);
+        torso.parent = visual;
+        torso.position.y = 1.18;
+        tintMeshes.push(box(scene, `${name}-body`, { width: 0.78, height: 0.82, depth: 0.42 }, shirtMat, torso, { x: 0, y: 0, z: 0 }));
+        tintMeshes.push(box(scene, `${name}-hip`, { width: 0.62, height: 0.22, depth: 0.36 }, pantsMat, torso, { x: 0, y: -0.48, z: 0 }));
+        const head = new TransformNode(`${name}-head-pivot`, scene);
+        head.parent = visual;
+        head.position.y = 1.78;
+        tintMeshes.push(box(scene, `${name}-head`, { width: 0.5, height: 0.5, depth: 0.5 }, skinMat, head, { x: 0, y: 0, z: 0 }));
+        tintMeshes.push(box(scene, `${name}-hair`, { width: 0.54, height: 0.16, depth: 0.54 }, solid(scene, `${name}-hair-mat`, colorFromConfig(config.hairColor, '#1f2937')), head, {
+            x: 0,
+            y: 0.28,
+            z: 0,
+        }));
+        const armL = new TransformNode(`${name}-arm-l`, scene);
+        armL.parent = visual;
+        armL.position.set(-0.52, 1.48, 0);
+        tintMeshes.push(box(scene, `${name}-arm--1`, { width: 0.22, height: 0.78, depth: 0.22 }, shirtMat, armL, { x: 0, y: -0.4, z: 0 }));
+        tintMeshes.push(box(scene, `${name}-hand--1`, { width: 0.2, height: 0.2, depth: 0.2 }, skinMat, armL, { x: 0, y: -0.82, z: 0 }));
+        const armR = new TransformNode(`${name}-arm-r`, scene);
+        armR.parent = visual;
+        armR.position.set(0.52, 1.48, 0);
+        tintMeshes.push(box(scene, `${name}-arm-1`, { width: 0.22, height: 0.78, depth: 0.22 }, shirtMat, armR, { x: 0, y: -0.4, z: 0 }));
+        tintMeshes.push(box(scene, `${name}-hand-1`, { width: 0.2, height: 0.2, depth: 0.2 }, skinMat, armR, { x: 0, y: -0.82, z: 0 }));
+        const legL = new TransformNode(`${name}-leg-l`, scene);
+        legL.parent = visual;
+        legL.position.set(-0.18, 0.9, 0);
+        tintMeshes.push(box(scene, `${name}-leg--1`, { width: 0.26, height: 0.88, depth: 0.28 }, pantsMat, legL, { x: 0, y: -0.44, z: 0 }));
+        const legR = new TransformNode(`${name}-leg-r`, scene);
+        legR.parent = visual;
+        legR.position.set(0.18, 0.9, 0);
+        tintMeshes.push(box(scene, `${name}-leg-1`, { width: 0.26, height: 0.88, depth: 0.28 }, pantsMat, legR, { x: 0, y: -0.44, z: 0 }));
+        if (!options.skipNameTag) {
+            attachNameTag(scene, visual, displayName ?? '', username ?? '', name);
+        }
+        let collider = null;
+        let root = visual;
+        if (options.collider === true || options.collider === 'player') {
+            collider = MeshBuilder.CreateBox(`${name}-collider`, { width: 0.12, height: 0.12, depth: 0.12 }, scene);
+            collider.isVisible = false;
+            collider.isPickable = false;
+            collider.checkCollisions = true;
+            collider.ellipsoid = new BVector3(0.42, 1.05, 0.42);
+            collider.ellipsoidOffset = new BVector3(0, 1.05, 0);
+            visual.parent = collider;
+            visual.position.set(0, 0, 0);
+            root = collider;
+        }
+        else if (options.collider === 'body') {
+            collider = MeshBuilder.CreateBox(`${name}-bodycol`, { width: 0.12, height: 0.12, depth: 0.12 }, scene);
+            collider.isVisible = false;
+            collider.isPickable = false;
+            collider.checkCollisions = false;
+            visual.parent = collider;
+            visual.position.set(0, 0, 0);
+            root = collider;
+        }
+        root.name = name;
+        const rig = { root, visual, collider, torso, head, armL, armR, legL, legR };
+        root.metadata = { ...(root.metadata ?? {}), rig, tintMeshes, isLobbyAvatarRoot: true };
+        return root;
+    }
+    /** Procedural sync create, or GLB load when presetKind is glb + glbUrl. */
+    static async createAsync(scene, avatar, name = 'avatar', displayName, username, options = {}) {
+        const run = async () => {
+            const glbUrl = resolveGlbUrl(avatar);
+            const cfg = avatar.customConfig;
+            console.info('[lobby-sdk] avatar createAsync', {
+                presetKey: avatar.presetKey,
+                presetKind: avatar.presetKind,
+                glbUrl,
+                colorVariantKey: cfg?.colorVariantKey ?? null,
+                baseAlbedo: readBaseAlbedoUrlFromConfig(cfg),
+            });
+            let root;
+            if (!glbUrl) {
+                root = AvatarFactory.create(scene, avatar, name, displayName, username, options);
+            }
+            else {
+                const candidates = [glbUrl];
+                try {
+                    const absolute = new URL(glbUrl, typeof window !== 'undefined' ? window.location.href : 'http://localhost');
+                    if (absolute.pathname && absolute.pathname !== glbUrl) {
+                        candidates.push(absolute.pathname);
+                    }
+                }
+                catch {
+                    // ignore
+                }
+                let lastError;
+                let loaded = null;
+                for (const url of candidates) {
+                    try {
+                        loaded = await AvatarFactory.createFromGlb(scene, url, name, displayName, username, options);
+                        break;
+                    }
+                    catch (err) {
+                        lastError = err;
+                        console.warn('[lobby-sdk] GLB avatar load failed, trying next URL', url, err);
+                    }
+                }
+                if (!loaded) {
+                    console.warn('[lobby-sdk] GLB avatar failed, falling back to procedural', glbUrl, lastError);
+                    root = AvatarFactory.create(scene, avatar, name, displayName, username, options);
+                }
+                else {
+                    root = loaded;
+                }
+            }
+            if (!options.skipAccessories) {
+                try {
+                    const tAcc = performance.now();
+                    const { attachAccessoriesFromAvatarConfig } = await import('./avatar-accessories');
+                    await attachAccessoriesFromAvatarConfig(scene, root, avatar.customConfig);
+                    if (isLobbyPerfDiagEnabled()) {
+                        lobbyPerfMark('accessories', performance.now() - tAcc);
+                    }
+                }
+                catch (err) {
+                    console.warn('[lobby-sdk] accessories skipped', err);
+                }
+            }
+            // Appearance (baked clothing albedo) always applies — independent of mesh accessories.
+            const baseAlbedo = readBaseAlbedoUrlFromConfig(avatar.customConfig);
+            const tAppear = performance.now();
+            try {
+                applyAvatarBaseAlbedo(root, baseAlbedo);
+            }
+            catch (err) {
+                console.warn('[lobby-sdk] base albedo skipped', err);
+            }
+            // Whole-avatar tint is legacy (procedural). Never multiply over clothing texture variants.
+            if (!baseAlbedo) {
+                applyAvatarTint(root, readTintFromConfig(avatar.customConfig));
+            }
+            else {
+                applyAvatarTint(root, null);
+            }
+            if (isLobbyPerfDiagEnabled()) {
+                lobbyPerfMark('albedo_tint', performance.now() - tAppear);
+            }
+            AvatarFactory.markLobbyAvatar(root, scene);
+            return root;
+        };
+        if (!isLobbyPerfDiagEnabled())
+            return run();
+        return lobbyPerfTimeAsync('createAsync_total', run, name);
+    }
+    static markLobbyAvatar(root, scene) {
+        root.metadata = { ...(root.metadata ?? {}), isLobbyAvatarRoot: true };
+        root.onDisposeObservable.addOnce(() => {
+            queueMicrotask(() => {
+                if (scene.isDisposed)
+                    return;
+                AvatarFactory.syncCrowdBudget(scene);
+            });
+        });
+        AvatarFactory.syncCrowdBudget(scene);
+    }
+    /**
+     * Recount avatars and drop extra PBR maps / bloom once the room fills up.
+     * Safe to call after spawn or dispose.
+     */
+    static syncCrowdBudget(scene) {
+        let count = 0;
+        for (const node of scene.transformNodes) {
+            if (!node.isDisposed() && node.metadata?.isLobbyAvatarRoot)
+                count++;
+        }
+        for (const mesh of scene.meshes) {
+            if (!mesh.isDisposed() && mesh.metadata?.isLobbyAvatarRoot)
+                count++;
+        }
+        scene.metadata?.applyLobbyCrowdLoad?.(count);
+        if (!shouldTrimAvatarDetailMaps({
+            quality: lobbyQualityOf(scene),
+            touch: isTouchDevice(),
+            avatarCount: count,
+        })) {
+            return;
+        }
+        trimDetailMapsOnMaterials(scene.meshes.filter((mesh) => mesh.metadata?.isLobbyAvatar));
+    }
+    /** Re-tint materials without reloading the GLB (legacy / procedural). */
+    static setTint(root, hex) {
+        AvatarMaterialPipeline.applyTint(root, hex);
+    }
+    /** Swap base albedo without reloading the GLB (clothing texture variants). */
+    static setBaseAlbedo(root, textureUrl) {
+        AvatarMaterialPipeline.applyBaseAlbedo(root, textureUrl);
+    }
+    static async createFromGlb(scene, glbUrl, name, displayName, username, options) {
+        const visual = new TransformNode(`${name}-visual`, scene);
+        // Separate model node so HumanoidAnimator can freely set visual.position.y
+        // without undoing the "feet on ground" offset.
+        const model = new TransformNode(`${name}-model`, scene);
+        model.parent = visual;
+        const result = await AvatarAssetManager.instantiateAvatarGlb(scene, glbUrl);
+        // Spread post-clone preparation across frames so remote different-base joins
+        // do not freeze the lobby on one long sync resume.
+        await yieldToRenderLoop();
+        const transformNodes = result.transformNodes;
+        const skeletons = result.skeletons;
+        const animationGroups = dedupeClipsByName(result.animationGroups);
+        const importRoot = result.meshes.find((m) => isImportRootName(m.name)) ??
+            transformNodes.find((t) => isImportRootName(t.name)) ??
+            result.meshes[0];
+        // Preserve glTF right-handed flip if present on import root.
+        const rootScaleZ = importRoot?.scaling?.z ?? 1;
+        const prepared = AvatarRigBuilder.prepareGlbSkeleton({
+            scene,
+            name,
+            glbUrl,
+            model,
+            importRoot,
+            rootScaleZ,
+            meshes: result.meshes,
+            transformNodes,
+            skeletons,
+            animationGroups,
+        });
+        const { clips, displayMeshes, rigidGlb, boneDriven, limbRig, originalAnimationGroups, skeletons: preparedSkeletons, transformNodes: preparedTransformNodes, } = prepared;
+        const hasSkeleton = skeletons.length > 0 || result.meshes.some((m) => !!m.skeleton);
+        for (const mesh of displayMeshes) {
+            mesh.isPickable = false;
+            mesh.checkCollisions = false;
+            mesh.receiveShadows = false;
+        }
+        await yieldToRenderLoop();
+        fitGlbToHumanHeight(model, displayMeshes);
+        {
+            const tHarden = performance.now();
+            AvatarMaterialPipeline.harden(displayMeshes);
+            if (isLobbyPerfDiagEnabled()) {
+                lobbyPerfMark('harden_materials', performance.now() - tHarden);
+            }
+        }
+        AvatarRigBuilder.padSkinnedBounds(displayMeshes);
+        AvatarMaterialPipeline.trimForLowEnd(scene, displayMeshes);
+        await yieldToRenderLoop();
+        const humanoid = AvatarRigBuilder.buildHumanoidAfterFit(visual, preparedSkeletons, preparedTransformNodes, boneDriven);
+        console.info('[lobby-sdk] GLB loaded', {
+            glbUrl,
+            hasSkeleton,
+            boneDriven,
+            humanoid: !!humanoid,
+            rigidGlb,
+            display: displayMeshes.map((m) => m.name),
+        });
+        const { torso, head, armL, armR, legL, legR } = AvatarRigBuilder.resolveLimbPivots(scene, name, visual, limbRig);
+        if (!options.skipNameTag) {
+            attachNameTag(scene, visual, displayName ?? '', username ?? '', name);
+        }
+        let collider = null;
+        let root = visual;
+        if (options.collider === true || options.collider === 'player') {
+            collider = MeshBuilder.CreateBox(`${name}-collider`, { width: 0.12, height: 0.12, depth: 0.12 }, scene);
+            collider.isVisible = false;
+            collider.isPickable = false;
+            collider.checkCollisions = true;
+            collider.ellipsoid = new BVector3(0.42, 1.05, 0.42);
+            collider.ellipsoidOffset = new BVector3(0, 1.05, 0);
+            visual.parent = collider;
+            visual.position.set(0, 0, 0);
+            root = collider;
+        }
+        else if (options.collider === 'body') {
+            collider = MeshBuilder.CreateBox(`${name}-bodycol`, { width: 0.12, height: 0.12, depth: 0.12 }, scene);
+            collider.isVisible = false;
+            collider.isPickable = false;
+            collider.checkCollisions = false;
+            visual.parent = collider;
+            visual.position.set(0, 0, 0);
+            root = collider;
+        }
+        root.name = name;
+        const rig = {
+            root,
+            visual,
+            collider,
+            torso,
+            head,
+            armL,
+            armR,
+            legL,
+            legR,
+            boneDriven,
+            humanoid,
+            restRotation: limbRig?.restRotation,
+        };
+        root.metadata = {
+            ...(root.metadata ?? {}),
+            rig,
+            animationGroups: clips,
+            /** Original GLB clips (emotes later); locomotion uses boneDriven procedural. */
+            sourceClips: boneDriven ? originalAnimationGroups : clips,
+            glbModel: model,
+            rigidGlb,
+            boneDriven,
+            tintMeshes: displayMeshes.filter((m) => !!m?.material && m.isEnabled?.() !== false && !isImportRootName(m.name)),
+            isLobbyAvatarRoot: true,
+        };
+        return root;
+    }
+    static getRig(root) {
+        return root.metadata?.rig ?? null;
+    }
+    static getAnimationGroups(root) {
+        const groups = root.metadata?.animationGroups;
+        return groups?.length ? groups : undefined;
+    }
+    static setPosition(root, position) {
+        root.position = new BVector3(position.x, position.y, position.z);
+    }
+    static setRotationY(root, rotationY) {
+        const rig = AvatarFactory.getRig(root);
+        const target = rig?.visual ?? root;
+        target.rotation.y = rotationY;
+    }
+    /** Phase-1: wrap a factory-built root as AvatarInstance (no rebuild). */
+    static wrap(root) {
+        return AvatarInstance.fromRoot(root);
+    }
+    /**
+     * Phase-1 high-level spawn API for remotes/controllers.
+     * Builds a procedural stand-in without exposing GLB/material details to callers.
+     */
+    static createPlaceholderInstance(scene, avatar, name, displayName, username, options = {}) {
+        const root = AvatarFactory.create(scene, avatar, name, displayName, username, options);
+        AvatarFactory.markLobbyAvatar(root, scene);
+        return AvatarInstance.fromRoot(root);
+    }
+    /**
+     * Phase-1 high-level spawn API — same pipeline as createAsync, returns AvatarInstance.
+     */
+    static async createInstanceAsync(scene, avatar, name = 'avatar', displayName, username, options = {}) {
+        const root = await AvatarFactory.createAsync(scene, avatar, name, displayName, username, options);
+        return AvatarInstance.fromRoot(root);
+    }
+}
+//# sourceMappingURL=avatar-factory.js.map