@mml-io/3d-web-experience-client 0.26.1 → 0.27.0

package/build/AvatarType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AvatarType.d.ts","sourceRoot":"","sources":["../src/AvatarType.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,CACA;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,IAAI,CAAC;IAC1B,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,GACD;IACE,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,GACD;IACE,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,kBAAkB,CAAC,EAAE,IAAI,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB,CACJ,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,gBAAgB,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC"}

package/build/ClientEventEmitter.d.ts

@@ -0,0 +1,32 @@
+import type { UpdatableConfig } from "./Networked3dWebExperienceClient";
+export type ClientEventMap = {
+    chat: {
+        username: string;
+        message: string;
+        fromConnectionId: number;
+        userId: string;
+        isLocal: boolean;
+    };
+    userJoined: {
+        connectionId: number;
+        userId: string;
+        username: string | null;
+    };
+    userLeft: {
+        connectionId: number;
+        userId: string;
+        username: string | null;
+    };
+    configChanged: Partial<UpdatableConfig>;
+    ready: void;
+    disposed: void;
+};
+export declare class ClientEventEmitter {
+    private handlers;
+    on<K extends keyof ClientEventMap>(event: K, handler: (data: ClientEventMap[K]) => void): void;
+    off<K extends keyof ClientEventMap>(event: K, handler: (data: ClientEventMap[K]) => void): void;
+    protected emit<K extends keyof ClientEventMap>(event: K, ...args: ClientEventMap[K] extends void ? [] : [ClientEventMap[K]]): void;
+    /** Remove all registered event handlers. Called during dispose to prevent leaks. */
+    protected clearAllHandlers(): void;
+}
+//# sourceMappingURL=ClientEventEmitter.d.ts.map

package/build/ClientEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientEventEmitter.d.ts","sourceRoot":"","sources":["../src/ClientEventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,UAAU,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9E,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC5E,aAAa,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACxC,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,IAAI,CAAC;CAChB,CAAC;AAKF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAsD;IAEtE,EAAE,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAS9F,GAAG,CAAC,CAAC,SAAS,MAAM,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAI/F,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,cAAc,EAC3C,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GACjE,IAAI;IAQP,oFAAoF;IACpF,SAAS,CAAC,gBAAgB,IAAI,IAAI;CAGnC"}

package/build/DefaultAvatarSelectionPlugin.d.ts

@@ -0,0 +1,36 @@
+import type { Networked3dWebExperienceClient } from "./Networked3dWebExperienceClient";
+import type { UIPlugin } from "./plugins";
+export declare class DefaultAvatarSelectionPlugin implements UIPlugin {
+    private container;
+    private scrollStyle;
+    private client;
+    private panelOpen;
+    private selectedIndex;
+    private avatars;
+    private allowCustomAvatars;
+    private allowCustomDisplayName;
+    private customAvatarType;
+    private toggleBtn;
+    private panel;
+    private grid;
+    private nameInput;
+    private customInput;
+    private customSection;
+    private escapeHandler;
+    mount(_container: HTMLElement, client: Networked3dWebExperienceClient): void;
+    onConfigChanged(config: Record<string, unknown>): void;
+    dispose(): void;
+    private buildToggleButton;
+    private rebuildPanel;
+    private buildPanel;
+    private renderGrid;
+    private buildCustomAvatarTypeSelector;
+    private getCustomPlaceholder;
+    private buildCustomAvatarInput;
+    private rebuildCustomInput;
+    private addTextLabel;
+    private setPanelOpen;
+    private syncCurrentState;
+    private applyChanges;
+}
+//# sourceMappingURL=DefaultAvatarSelectionPlugin.d.ts.map

package/build/DefaultAvatarSelectionPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAvatarSelectionPlugin.d.ts","sourceRoot":"","sources":["../src/DefaultAvatarSelectionPlugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAa1C,qBAAa,4BAA6B,YAAW,QAAQ;IAC3D,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,MAAM,CAA+C;IAE7D,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,sBAAsB,CAAS;IACvC,OAAO,CAAC,gBAAgB,CAA6C;IAGrE,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,WAAW,CAAuD;IAC1E,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAA6C;IAElE,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI;IAsB5E,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkBtD,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,UAAU;IAiMlB,OAAO,CAAC,UAAU;IA4DlB,OAAO,CAAC,6BAA6B;IAyCrC,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,sBAAsB;IA0C9B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,YAAY;CA2CrB"}

package/build/DefaultChatPlugin.d.ts

@@ -0,0 +1,44 @@
+import type { Networked3dWebExperienceClient, UpdatableConfig } from "./Networked3dWebExperienceClient";
+import type { UIPlugin } from "./plugins";
+export declare class DefaultChatPlugin implements UIPlugin {
+    private container;
+    private scrollStyle;
+    private client;
+    private enabled;
+    private messages;
+    private nextId;
+    private panelOpen;
+    private unreadCount;
+    private filterIndex;
+    private proximityMode;
+    private userScrolledUp;
+    private toggleBtn;
+    private unreadBadge;
+    private passiveArea;
+    private panel;
+    private messageArea;
+    private input;
+    private filterPill;
+    private proxPill;
+    private globalKeydownHandler;
+    private chatHandler;
+    mount(_container: HTMLElement, client: Networked3dWebExperienceClient): void;
+    onConfigChanged(config: Partial<UpdatableConfig>): void;
+    dispose(): void;
+    private buildToggleButton;
+    private buildPassiveArea;
+    private buildPanel;
+    private sendMessage;
+    private calculateDistance;
+    private setPanelOpen;
+    private updateUnreadBadge;
+    private updateFilterPill;
+    private updateProxPill;
+    private shouldShowMessage;
+    private scrollToBottom;
+    private createMessageElement;
+    private rerenderMessages;
+    private addPassiveMessage;
+    private addMessageToUI;
+}
+//# sourceMappingURL=DefaultChatPlugin.d.ts.map

package/build/DefaultChatPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultChatPlugin.d.ts","sourceRoot":"","sources":["../src/DefaultChatPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AA4C1C,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,OAAO,CAAQ;IAEvB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,oBAAoB,CAA6C;IAEzE,OAAO,CAAC,WAAW,CAAqC;IAExD,KAAK,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI;IA6B5E,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IASvD,OAAO,IAAI,IAAI;IAef,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,UAAU;IAqOlB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,oBAAoB;IAiE5B,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,iBAAiB;IAyCzB,OAAO,CAAC,cAAc;CAkCvB"}

package/build/DefaultHUDPlugin.d.ts

@@ -0,0 +1,18 @@
+import type { Networked3dWebExperienceClient, UpdatableConfig } from "./Networked3dWebExperienceClient";
+import type { UIPlugin } from "./plugins";
+export type DefaultHUDPluginOptions = {
+    minimap?: boolean;
+    playerList?: boolean;
+};
+export declare class DefaultHUDPlugin implements UIPlugin {
+    private hud;
+    private container;
+    private client;
+    private currentMinimap;
+    private currentPlayerList;
+    private hudInitialized;
+    mount(container: HTMLElement, client: Networked3dWebExperienceClient): void;
+    onConfigChanged(config: Partial<UpdatableConfig>): void;
+    dispose(): void;
+}
+//# sourceMappingURL=DefaultHUDPlugin.d.ts.map

package/build/DefaultHUDPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultHUDPlugin.d.ts","sourceRoot":"","sources":["../src/DefaultHUDPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAwB1C,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAmmBF,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,GAAG,CAAwC;IACnD,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,iBAAiB,CAAQ;IAGjC,OAAO,CAAC,cAAc,CAAS;IAE/B,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI;IAK3E,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAyCvD,OAAO,IAAI,IAAI;CAMhB"}

package/build/DefaultRespawnButtonPlugin.d.ts

@@ -0,0 +1,13 @@
+import type { Networked3dWebExperienceClient, UpdatableConfig } from "./Networked3dWebExperienceClient";
+import type { UIPlugin } from "./plugins";
+export declare class DefaultRespawnButtonPlugin implements UIPlugin {
+    private client;
+    private container;
+    private button;
+    mount(container: HTMLElement, client: Networked3dWebExperienceClient): void;
+    onConfigChanged(config: Partial<UpdatableConfig>): void;
+    dispose(): void;
+    private show;
+    private hide;
+}
+//# sourceMappingURL=DefaultRespawnButtonPlugin.d.ts.map

package/build/DefaultRespawnButtonPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultRespawnButtonPlugin.d.ts","sourceRoot":"","sources":["../src/DefaultRespawnButtonPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,qBAAa,0BAA2B,YAAW,QAAQ;IACzD,OAAO,CAAC,MAAM,CAA+C;IAC7D,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAA+B;IAE7C,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI;IAK3E,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAUvD,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,IAAI;IAgEZ,OAAO,CAAC,IAAI;CAIb"}

package/build/DefaultVirtualJoystickPlugin.d.ts

@@ -0,0 +1,16 @@
+import type { Networked3dWebExperienceClient } from "./Networked3dWebExperienceClient";
+import type { UIPlugin } from "./plugins";
+export type VirtualJoystickPluginOptions = {
+    radius?: number;
+    innerRadius?: number;
+    mouseSupport?: boolean;
+};
+export declare class DefaultVirtualJoystickPlugin implements UIPlugin {
+    private options;
+    private wrapper;
+    private joystick;
+    constructor(options?: VirtualJoystickPluginOptions);
+    mount(container: HTMLElement, client: Networked3dWebExperienceClient): void;
+    dispose(): void;
+}
+//# sourceMappingURL=DefaultVirtualJoystickPlugin.d.ts.map

package/build/DefaultVirtualJoystickPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultVirtualJoystickPlugin.d.ts","sourceRoot":"","sources":["../src/DefaultVirtualJoystickPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,4BAA6B,YAAW,QAAQ;IAI/C,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,QAAQ,CAAgC;gBAE5B,OAAO,GAAE,4BAAiC;IAE9D,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI;IAa3E,OAAO,IAAI,IAAI;CAKhB"}

package/build/Networked3dWebExperienceClient.d.ts

@@ -1,21 +1,40 @@
-import { AnimationConfig, CameraManager, CollisionsManager, EnvironmentConfiguration, LoadingScreenConfig, SpawnConfiguration, IRenderer, MMLDocumentConfiguration, TweakPane, RendererConfig } from "@mml-io/3d-web-client-core";
-import { ServerBroadcastMessage } from "@mml-io/3d-web-user-networking";
+import { AnimationConfig, CameraManager, CharacterDescription, CollisionsManager, EnvironmentConfiguration, LoadingScreenConfig, SpawnConfiguration, SpawnConfigurationState, InputProvider, IRenderer, CharacterManager, MMLDocumentConfiguration, TweakPane, RendererConfig } from "@mml-io/3d-web-client-core";
+import { type ServerBroadcastMessage } from "@mml-io/3d-web-experience-protocol";
+import { UserData } from "@mml-io/3d-web-user-networking";
 import { LoadingProgressManager } from "@mml-io/mml-web";
-import { AvatarConfiguration } from "./avatar-selection-ui";
-import { StringToHslOptions } from "./chat-ui";
+import { AvatarConfiguration } from "./AvatarType";
+import { ClientEventEmitter } from "./ClientEventEmitter";
+import type { UIPlugin } from "./plugins";
+import { WorldConnection } from "./WorldConnection";
 export type Networked3dWebExperienceClientConfig = {
     userNetworkAddress: string;
     sessionToken: string;
-    authToken?: string | null;
-    chatVisibleByDefault?: boolean;
-    userNameToColorOptions?: StringToHslOptions;
     animationConfig: AnimationConfig;
     voiceChatAddress?: string;
     updateURLLocation?: boolean;
     onServerBroadcast?: (broadcast: ServerBroadcastMessage) => void;
     loadingScreen?: LoadingScreenConfig;
     createRenderer?: (options: CreateRendererOptions) => IRenderer;
+    waitForWorldConfig?: boolean;
+    /** Virtual joystick for touch/mobile input. Defaults to built-in joystick. Pass `null` to disable. */
+    virtualJoystickPlugin?: UIPlugin | null;
+    /** Respawn button overlay. Defaults to built-in button. Pass `null` to disable. */
+    respawnButtonPlugin?: UIPlugin | null;
+    /**
+     * Additional UI plugins mounted alongside the built-in plugins.
+     * Use this to add arbitrary overlay UI (HUD, minimap, voice
+     * controls, etc.) that participates in the standard plugin lifecycle.
+     */
+    plugins?: UIPlugin[];
 } & UpdatableConfig;
+/**
+ * The subset of the client config that can be updated at runtime, either via
+ * `updateConfig()` or delivered from the server as the JSON payload of a
+ * `FROM_SERVER_WORLD_CONFIG_MESSAGE_TYPE` message.
+ *
+ * The server-side equivalent is `WorldConfigPayload` from
+ * `@mml-io/3d-web-experience-protocol`.
+ */
 export type UpdatableConfig = {
     enableChat?: boolean;
     mmlDocuments?: {
@@ -28,6 +47,12 @@ export type UpdatableConfig = {
     enableTweakPane?: boolean;
     allowOrbitalCamera?: boolean;
     postProcessingEnabled?: boolean;
+    hud?: false | {
+        minimap?: boolean;
+        playerList?: boolean;
+        respawnButton?: boolean;
+        [key: string]: boolean | undefined;
+    };
 };
 export type CreateRendererOptions = {
     targetElement: HTMLElement;
@@ -44,7 +69,7 @@ export type CreateRendererOptions = {
     mmlAuthToken: string | null;
     onInitialized: () => void;
 };
-export declare class Networked3dWebExperienceClient {
+export declare class Networked3dWebExperienceClient extends ClientEventEmitter {
     private holderElement;
     private config;
     private element;
@@ -55,22 +80,31 @@ export declare class Networked3dWebExperienceClient {
     private collisionsManager;
     private characterManager;
     private keyInputManager;
-    private virtualJoystick;
-    private clientId;
-    private networkClient;
+    private resizeObserver;
+    private connectionId;
+    private worldConnection;
     private remoteUserStates;
     private userProfiles;
-    private textChatUI;
-    private avatarSelectionUI;
+    private virtualJoystickPlugin;
+    private respawnButtonPlugin;
+    private plugins;
     private tweakPane;
     private spawnConfiguration;
     private cameraValues;
     private characterControllerValues;
     private initialLoadCompleted;
+    private pendingChatMessages;
+    private latestConfig;
     private loadingProgressManager;
     private loadingScreen;
     private errorScreen?;
-    private respawnButton;
+    private mmlAuthToken;
+    private rendererInitialized;
+    private worldConfigReceived;
+    private worldConfigTimeoutId;
+    private disposed;
+    private static readonly WORLD_CONFIG_TIMEOUT_MS;
+    private static readonly MAX_PENDING_CHAT_MESSAGES;
     private currentRequestAnimationFrame;
     private lastUpdateTimeMs;
     private frameCounter;
@@ -81,16 +115,78 @@ export declare class Networked3dWebExperienceClient {
     constructor(holderElement: HTMLElement, config: Networked3dWebExperienceClientConfig);
     updateConfig(config: Partial<UpdatableConfig>): void;
     static createFullscreenHolder(): HTMLDivElement;
-    private createRespawnButton;
+    private getAllPlugins;
+    private checkReadyForInitialLoad;
     private resolveCharacterData;
     private onNetworkUpdate;
     private sendIdentityUpdateToServer;
     private handleChatMessage;
-    private connectToTextChat;
-    private mountAvatarSelectionUI;
     update(): void;
     private spawnCharacter;
     private disposeWithError;
+    /**
+     * Add a plugin at runtime. If the experience has already loaded, the plugin
+     * is mounted immediately and receives the latest config. Otherwise it will
+     * be mounted alongside the other plugins when loading completes.
+     */
+    addPlugin(plugin: UIPlugin): void;
+    /**
+     * Remove a previously added plugin. Calls `dispose()` on the plugin if the
+     * experience has already loaded (i.e. it was mounted).
+     */
+    removePlugin(plugin: UIPlugin): void;
+    /** Set an additional input provider (e.g. virtual joystick) for character control. */
+    setAdditionalInputProvider(inputProvider: InputProvider): void;
+    /** Returns the current spawn configuration (position, respawn trigger, etc.). */
+    getSpawnConfiguration(): SpawnConfigurationState;
+    /** Returns the local client's connection ID, or null before authentication. */
+    getConnectionId(): number | null;
+    /** Returns position and username of the local character, or null if not yet spawned. */
+    getLocalCharacterState(): {
+        connectionId: number;
+        userId: string;
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        username: string;
+    } | null;
+    /**
+     * Returns all connected users (including local). Each entry contains
+     * the user's connection ID, userId, position, and username.
+     */
+    getCharacterStates(): Map<number, {
+        connectionId: number;
+        userId: string;
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        username: string;
+        isLocal: boolean;
+    }>;
+    /** Update the character's avatar. */
+    selectAvatar(characterDescription: CharacterDescription): void;
+    /** Update the character's display name. */
+    setDisplayName(name: string): void;
+    /** Respawn the local character at the configured spawn point. */
+    respawn(): void;
+    /** Send a chat message. */
+    sendChatMessage(message: string): void;
+    /** Access the underlying world connection. */
+    getWorldConnection(): WorldConnection;
+    /** Access the renderer. */
+    getRenderer(): IRenderer;
+    /** Access the character manager (local/remote character state, spawning). */
+    getCharacterManager(): CharacterManager;
+    /** Access the camera manager. */
+    getCameraManager(): CameraManager;
+    /** Look up a user's profile (username, avatar, colors) by connection ID. */
+    getUserProfile(connectionId: number): UserData | null;
+    /** Get all user profiles. */
+    getUserProfiles(): ReadonlyMap<number, UserData>;
     dispose(): void;
 }
 //# sourceMappingURL=Networked3dWebExperienceClient.d.ts.map

package/build/Networked3dWebExperienceClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Networked3dWebExperienceClient.d.ts","sourceRoot":"","sources":["../src/Networked3dWebExperienceClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,aAAa,EAIb,iBAAiB,EACjB,wBAAwB,EAMxB,mBAAmB,EACnB,kBAAkB,EAMlB,SAAS,EAGT,wBAAwB,EACxB,SAAS,EAGT,cAAc,EACf,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAYL,sBAAsB,EAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAkC,MAAM,iBAAiB,CAAC;AAEzF,OAAO,EAAqB,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAA+B,MAAM,WAAW,CAAC;AAG5E,MAAM,MAAM,oCAAoC,GAAG;IACjD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,sBAAsB,CAAC,EAAE,kBAAkB,CAAC;IAC5C,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAChE,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,SAAS,CAAC;CAChE,GAAG,eAAe,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAAA;KAAE,CAAC;IAC3D,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IACpD,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,WAAW,CAAC;IAC3B,iBAAiB,EAAE,aAAa,CAAC;IACjC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,sBAAsB,EAAE,sBAAsB,CAAC;IAC/C,YAAY,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAAA;KAAE,CAAC;IAC1D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AA2BF,qBAAa,8BAA8B;IA+CvC,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,MAAM;IA/ChB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,YAAY,CAAiB;IAErC,OAAO,CAAC,QAAQ,CAAY;IAC5B,OAAO,CAAC,cAAc,CAAiB;IAEvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,eAAe,CAAkB;IAEzC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,gBAAgB,CAAiD;IACzE,OAAO,CAAC,YAAY,CAA+B;IAEnD,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,SAAS,CAAY;IAE7B,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,yBAAyB,CAA4C;IAE7E,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,sBAAsB,CAAgC;IAC9D,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,aAAa,CAA+B;IAGpD,OAAO,CAAC,4BAA4B,CAAuB;IAC3D,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAC7D,OAAO,CAAC,eAAe,CAAa;IAEpC,OAAO,CAAC,qBAAqB,CAI3B;gBAGQ,aAAa,EAAE,WAAW,EAC1B,MAAM,EAAE,oCAAoC;IA0N/C,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC;IA2EpD,MAAM,CAAC,sBAAsB,IAAI,cAAc;IAa/C,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,oBAAoB;IAc5B,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,0BAA0B;IAYlC,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,sBAAsB;IAuBvB,MAAM,IAAI,IAAI;IAyFrB,OAAO,CAAC,cAAc;IA+BtB,OAAO,CAAC,gBAAgB;IAMjB,OAAO;CAcf"}
+{"version":3,"file":"Networked3dWebExperienceClient.d.ts","sourceRoot":"","sources":["../src/Networked3dWebExperienceClient.ts"],"names":[],"mappings":"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"}

package/build/WorldConnection.d.ts

@@ -0,0 +1,142 @@
+import { type SessionConfigPayload, type WorldConfigPayload } from "@mml-io/3d-web-experience-protocol";
+import { type UserNetworkingClientUpdate, type CharacterDescription, type UserData, type NetworkUpdate } from "@mml-io/3d-web-user-networking";
+export type { SessionConfigPayload, WorldConfigPayload } from "@mml-io/3d-web-experience-protocol";
+export type OtherUser = {
+    userId: string;
+    username: string | null;
+    characterDescription: CharacterDescription | null;
+    colors: Array<[number, number, number]> | null;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+};
+export type ChatMessage = {
+    fromConnectionId: number;
+    userId: string;
+    username: string;
+    message: string;
+    timestamp: number;
+};
+export type WorldEvent = {
+    type: "connected";
+} | {
+    type: "disconnected";
+} | {
+    type: "reconnecting";
+} | {
+    type: "identity_assigned";
+    connectionId: number;
+} | {
+    type: "server_error";
+    errorType: string;
+    message: string;
+} | {
+    type: "chat";
+    message: ChatMessage;
+} | {
+    type: "user_joined";
+    connectionId: number;
+    userId: string;
+    username: string | null;
+    position: {
+        x: number;
+        y: number;
+        z: number;
+    };
+} | {
+    type: "user_left";
+    connectionId: number;
+    userId: string;
+    username: string | null;
+} | {
+    type: "session_config";
+    config: SessionConfigPayload;
+} | {
+    type: "world_config";
+    config: WorldConfigPayload;
+} | {
+    type: "server_broadcast";
+    broadcastType: string;
+    payload: Record<string, unknown>;
+} | {
+    type: "network_update";
+    update: NetworkUpdate;
+};
+export type WorldConnectionConfig = {
+    url: string;
+    sessionToken: string;
+    websocketFactory: (url: string) => WebSocket;
+    initialUserState?: UserData;
+    initialPosition?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    initialRotation?: {
+        eulerY: number;
+    };
+};
+export declare class WorldConnection {
+    private client;
+    private otherUsers;
+    private chatHistory;
+    private eventListeners;
+    private myConnectionId;
+    private connected;
+    private username;
+    private connectPromise;
+    private resolveConnect;
+    private rejectConnect;
+    private connectSettled;
+    private worldConfigResolve;
+    private worldConfigPromise;
+    private latestWorldConfig;
+    constructor(config: WorldConnectionConfig);
+    stop(): void;
+    /**
+     * Returns a promise that settles once for the **initial** connection attempt.
+     * It resolves when the first `Connected` status is received, or rejects if
+     * the connection fails before being established.
+     *
+     * This promise does **not** re-settle on reconnection. To react to
+     * subsequent connection/disconnection events, use {@link addEventListener}
+     * and listen for `"connected"` / `"disconnected"` / `"reconnecting"` events.
+     */
+    waitForConnection(): Promise<void>;
+    /**
+     * Wait for the server to send a world config message.
+     *
+     * The server pushes this over WebSocket after authentication. If the config
+     * has already been received, the returned promise resolves immediately with
+     * the cached value (so callers never miss a config that arrived before they
+     * called this method).
+     *
+     * Multiple concurrent callers share a single internal promise that resolves
+     * when the config arrives. Each caller gets an independent timeout --- if the
+     * timeout fires, that caller receives `null` but other callers with longer
+     * timeouts (or the shared promise itself) are unaffected.
+     *
+     * @returns The world config, or `null` if the timeout expires first.
+     */
+    waitForWorldConfig(timeoutMs?: number): Promise<WorldConfigPayload | null>;
+    getWorldConfig(): WorldConfigPayload | null;
+    sendUpdate(update: UserNetworkingClientUpdate): void;
+    getOtherUsers(): Array<{
+        connectionId: number;
+    } & OtherUser>;
+    getConnectionId(): number | null;
+    getUsername(): string | null;
+    isConnected(): boolean;
+    sendChatMessage(message: string): void;
+    sendCustomMessage(customType: number, contents: string): void;
+    updateUsername(username: string): void;
+    updateCharacterDescription(characterDescription: CharacterDescription): void;
+    updateColors(colors: Array<[number, number, number]>): void;
+    getChatHistory(since?: number): ChatMessage[];
+    addEventListener(listener: (event: WorldEvent) => void): void;
+    removeEventListener(listener: (event: WorldEvent) => void): void;
+    private emitEvent;
+}
+//# sourceMappingURL=WorldConnection.d.ts.map

package/build/WorldConnection.d.ts.map

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

package/build/index.d.ts

@@ -1,2 +1,12 @@
 export * from "./Networked3dWebExperienceClient";
+export type { ClientEventMap } from "./ClientEventEmitter";
+export type { UIPlugin } from "./plugins";
+export { DefaultChatPlugin } from "./DefaultChatPlugin";
+export { DefaultAvatarSelectionPlugin } from "./DefaultAvatarSelectionPlugin";
+export { DefaultHUDPlugin } from "./DefaultHUDPlugin";
+export { DefaultVirtualJoystickPlugin } from "./DefaultVirtualJoystickPlugin";
+export type { VirtualJoystickPluginOptions } from "./DefaultVirtualJoystickPlugin";
+export { DefaultRespawnButtonPlugin } from "./DefaultRespawnButtonPlugin";
+export { WorldConnection, type WorldConnectionConfig, type WorldEvent, type ChatMessage, type OtherUser, } from "./WorldConnection";
+export type { SessionConfigPayload, WorldConfigPayload } from "@mml-io/3d-web-experience-protocol";
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC"}