@elizaos/app-core 2.0.0-alpha.73 → 2.0.0-alpha.75

package/components/apps/AppDetailPane.d.ts

@@ -0,0 +1,15 @@
+import type { RegistryAppInfo } from "../../api";
+interface AppDetailPaneProps {
+    app: RegistryAppInfo;
+    busy: boolean;
+    compact?: boolean;
+    hasActiveViewer: boolean;
+    isActive: boolean;
+    onBack: () => void;
+    onLaunch: () => void;
+    onOpenCurrentGame: () => void;
+    onOpenCurrentGameInNewTab: () => void;
+}
+export declare function AppDetailPane({ app, busy, compact, hasActiveViewer, isActive, onBack, onLaunch, onOpenCurrentGame, onOpenCurrentGameInNewTab, }: AppDetailPaneProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AppDetailPane.d.ts.map

package/components/apps/AppDetailPane.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppDetailPane.d.ts","sourceRoot":"","sources":["../../../src/components/apps/AppDetailPane.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAKjD,UAAU,kBAAkB;IAC1B,GAAG,EAAE,eAAe,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,yBAAyB,EAAE,MAAM,IAAI,CAAC;CACvC;AAED,wBAAgB,aAAa,CAAC,EAC5B,GAAG,EACH,IAAI,EACJ,OAAe,EACf,eAAe,EACf,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,iBAAiB,EACjB,yBAAyB,GAC1B,EAAE,kBAAkB,2CAqNpB"}

package/components/apps/AppDetailPane.js

@@ -0,0 +1,13 @@
+import { jsxs as _jsxs, jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button } from "@elizaos/ui";
+import { useApp } from "../../state";
+import { getAppDetailExtension } from "./extensions/registry";
+import { CATEGORY_LABELS, getAppEmoji } from "./helpers";
+export function AppDetailPane({ app, busy, compact = false, hasActiveViewer, isActive, onBack, onLaunch, onOpenCurrentGame, onOpenCurrentGameInNewTab, }) {
+    const { t } = useApp();
+    const DetailExtension = getAppDetailExtension(app);
+    if (compact) {
+        return (_jsxs("div", { className: "phone-inline-detail", children: [_jsxs("button", { type: "button", className: "flex items-center gap-1.5 text-[12px] text-muted hover:text-txt mb-4 cursor-pointer", onClick: onBack, children: ["\u2190 ", t("appsview.Back")] }), _jsxs("div", { className: "flex items-center gap-3 mb-4", children: [_jsx("div", { className: "phone-app-icon-lg", children: getAppEmoji(app) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("div", { className: "font-bold text-sm text-txt truncate", children: app.displayName ?? app.name }), _jsx("div", { className: "flex items-center gap-2 mt-0.5", children: isActive ? (_jsx("span", { className: "text-[10px] font-bold text-ok", children: t("appsview.Active") })) : (_jsx("span", { className: "text-[10px] text-muted", children: t("appsview.Inactive") })) })] })] }), _jsx("div", { className: "text-[12px] text-muted leading-relaxed mb-4", children: app.description ?? "No description" }), _jsx(Button, { variant: "default", size: "sm", className: "rounded-xl shadow-sm w-full mb-4", disabled: busy, onClick: onLaunch, children: busy ? "Launching..." : "Launch" }), hasActiveViewer ? (_jsx(Button, { variant: "outline", size: "sm", className: "rounded-xl shadow-sm w-full mb-4", onClick: onOpenCurrentGame, children: "Resume Session" })) : null] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: "mb-4", children: _jsx(Button, { variant: "outline", size: "sm", className: "rounded-xl shadow-sm", onClick: onBack, children: t("appsview.Back") }) }), _jsxs("div", { className: "flex items-center gap-4 mb-5", children: [_jsx("div", { className: "phone-app-icon-lg", children: getAppEmoji(app) }), _jsxs("div", { className: "flex-1 min-w-0", children: [_jsx("div", { className: "font-bold text-lg text-txt", children: app.displayName ?? app.name }), _jsxs("div", { className: "flex items-center gap-2 mt-1", children: [isActive ? (_jsx("span", { className: "text-[10px] font-bold text-ok", children: t("appsview.Active") })) : (_jsx("span", { className: "text-[10px] text-muted", children: t("appsview.Inactive") })), app.category ? (_jsx("span", { className: "text-[10px] px-1.5 py-0.5 rounded-full border border-border text-muted", children: CATEGORY_LABELS[app.category] ?? app.category })) : null, app.latestVersion ? (_jsxs("span", { className: "text-[10px] text-muted font-mono", children: ["v", app.latestVersion] })) : null] })] })] }), _jsx("div", { className: "text-[13px] text-muted leading-relaxed mb-5 pb-5 border-b border-border", children: app.description ?? "No description available." }), _jsxs("div", { className: "flex flex-wrap gap-2 mb-5", children: [_jsx(Button, { variant: "default", size: "sm", className: "rounded-xl shadow-sm px-6", disabled: busy, onClick: onLaunch, children: busy ? "Launching..." : "Launch" }), hasActiveViewer ? (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "outline", size: "sm", className: "rounded-xl shadow-sm", onClick: onOpenCurrentGame, children: "Resume Session" }), _jsx(Button, { variant: "outline", size: "sm", className: "rounded-xl shadow-sm", onClick: onOpenCurrentGameInNewTab, children: "Open in Tab" })] })) : null] }), _jsxs("div", { className: "flex flex-col gap-3 text-[12px] mb-5", children: [_jsxs("div", { className: "flex justify-between", children: [_jsx("span", { className: "text-muted", children: "Launch type" }), _jsx("span", { className: "text-txt", children: app.launchType || "—" })] }), app.launchUrl ? (_jsxs("div", { className: "flex justify-between", children: [_jsx("span", { className: "text-muted", children: "URL" }), _jsx("span", { className: "text-txt truncate max-w-[260px]", children: app.launchUrl })] })) : null, app.repository ? (_jsxs("div", { className: "flex justify-between", children: [_jsx("span", { className: "text-muted", children: "Repository" }), _jsx("a", { href: app.repository, target: "_blank", rel: "noreferrer", className: "text-accent hover:underline truncate max-w-[260px]", children: "GitHub" })] })) : null] }), app.capabilities?.length ? (_jsxs("div", { className: "mb-5", children: [_jsx("div", { className: "text-[11px] text-muted mb-2 font-semibold uppercase tracking-wider", children: "Capabilities" }), _jsx("div", { className: "flex flex-wrap gap-1.5", children: app.capabilities.map((capability) => (_jsx("span", { className: "text-[10px] px-2 py-0.5 rounded-full border border-border text-muted", children: capability }, capability))) })] })) : null, app.viewer ? (_jsxs("div", { className: "mb-5 p-3 rounded-xl border border-border bg-surface", children: [_jsx("div", { className: "text-[11px] text-muted mb-2 font-semibold uppercase tracking-wider", children: "Viewer" }), _jsxs("div", { className: "flex flex-col gap-1.5 text-[11px]", children: [_jsxs("div", { className: "flex justify-between", children: [_jsx("span", { className: "text-muted", children: "URL" }), _jsx("span", { className: "text-txt truncate max-w-[240px]", children: app.viewer.url })] }), _jsxs("div", { className: "flex justify-between", children: [_jsx("span", { className: "text-muted", children: "Auth" }), _jsx("span", { className: "text-txt", children: app.viewer.postMessageAuth ? "enabled" : "disabled" })] })] })] })) : null, DetailExtension ? (_jsx("div", { className: "border-t border-border pt-4", children: _jsx(DetailExtension, { app: app }) })) : null] }));
+}

package/components/apps/AppsCatalogGrid.d.ts

@@ -0,0 +1,20 @@
+import type { RegistryAppInfo } from "../../api";
+interface AppsCatalogGridProps {
+    activeAppNames: Set<string>;
+    activeGameDisplayName: string;
+    error: string | null;
+    hasCurrentGame: boolean;
+    loading: boolean;
+    searchQuery: string;
+    selectedAppName: string | null;
+    showActiveOnly: boolean;
+    visibleApps: RegistryAppInfo[];
+    onOpenCurrentGame: () => void;
+    onRefresh: () => void;
+    onSearchQueryChange: (value: string) => void;
+    onSelectApp: (appName: string) => void;
+    onToggleActiveOnly: () => void;
+}
+export declare function AppsCatalogGrid({ activeAppNames, activeGameDisplayName, error, hasCurrentGame, loading, searchQuery, selectedAppName, showActiveOnly, visibleApps, onOpenCurrentGame, onRefresh, onSearchQueryChange, onSelectApp, onToggleActiveOnly, }: AppsCatalogGridProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AppsCatalogGrid.d.ts.map

package/components/apps/AppsCatalogGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppsCatalogGrid.d.ts","sourceRoot":"","sources":["../../../src/components/apps/AppsCatalogGrid.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,UAAU,oBAAoB;IAC5B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC;AAED,wBAAgB,eAAe,CAAC,EAC9B,cAAc,EACd,qBAAqB,EACrB,KAAK,EACL,cAAc,EACd,OAAO,EACP,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,kBAAkB,GACnB,EAAE,oBAAoB,2CAmGtB"}

package/components/apps/AppsCatalogGrid.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { Button } from "@elizaos/ui";
+import { useApp } from "../../state";
+import { getAppEmoji, getAppShortName } from "./helpers";
+export function AppsCatalogGrid({ activeAppNames, activeGameDisplayName, error, hasCurrentGame, loading, searchQuery, selectedAppName, showActiveOnly, visibleApps, onOpenCurrentGame, onRefresh, onSearchQueryChange, onSelectApp, onToggleActiveOnly, }) {
+    const { t } = useApp();
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: "mb-4", children: _jsx("input", { type: "text", placeholder: "Search...", value: searchQuery, onChange: (event) => onSearchQueryChange(event.target.value), className: "w-full px-3 py-2 text-[12px] rounded-xl border border-border bg-surface text-txt placeholder:text-muted/50 focus:border-accent focus:outline-none" }) }), _jsxs("div", { className: "mb-4 flex gap-2", children: [_jsx(Button, { variant: "outline", size: "sm", className: "rounded-xl shadow-sm", onClick: onRefresh, children: t("appsview.Refresh") }), _jsx(Button, { variant: showActiveOnly ? "default" : "outline", size: "sm", className: "rounded-xl shadow-sm", onClick: onToggleActiveOnly, children: t("appsview.ActiveOnly") })] }), hasCurrentGame ? (_jsxs("button", { type: "button", className: "w-full mb-4 px-3 py-2.5 rounded-xl border border-ok/30 bg-ok/5 flex items-center gap-2 cursor-pointer hover:bg-ok/10 transition-colors", onClick: onOpenCurrentGame, children: [_jsx("span", { className: "w-2 h-2 rounded-full bg-ok animate-pulse" }), _jsx("span", { className: "text-[11px] font-semibold text-txt flex-1 text-left truncate", children: activeGameDisplayName || "Game running" }), _jsx("span", { className: "text-[10px] text-muted", children: "\u2192" })] })) : null, error ? (_jsx("div", { className: "px-3 py-2 border border-danger/30 rounded-xl text-danger text-[11px] mb-4", children: error })) : null, loading ? (_jsx("div", { className: "text-center py-16 text-muted text-[12px]", children: "Loading..." })) : visibleApps.length === 0 ? (_jsx("div", { className: "text-center py-16 text-muted text-[12px]", children: searchQuery ? "No apps found" : "No apps available" })) : (_jsx("div", { style: {
+                    display: "grid",
+                    gridTemplateColumns: "repeat(3, 1fr)",
+                    gap: "14px 4px",
+                    justifyItems: "center",
+                }, children: visibleApps.map((app) => {
+                    const isActive = activeAppNames.has(app.name);
+                    const isSelected = selectedAppName === app.name;
+                    const displayName = app.displayName ?? getAppShortName(app);
+                    return (_jsxs("button", { type: "button", className: `phone-app-tile group ${isSelected ? "is-selected" : ""}`, title: `Open ${displayName}`, "aria-label": `Open ${displayName}`, onClick: () => onSelectApp(app.name), children: [_jsxs("div", { className: "phone-app-icon", children: [isActive ? (_jsx("span", { className: "absolute -top-0.5 -right-0.5 w-2.5 h-2.5 rounded-full bg-ok border-2 border-card z-10" })) : null, _jsx("span", { className: "text-xl", children: getAppEmoji(app) })] }), _jsx("span", { className: "phone-app-label", children: getAppShortName(app) })] }, app.name));
+                }) }))] }));
+}

package/components/apps/extensions/registry.d.ts

@@ -0,0 +1,4 @@
+import type { RegistryAppInfo } from "../../../api";
+import type { AppDetailExtensionComponent } from "./types";
+export declare function getAppDetailExtension(app: RegistryAppInfo): AppDetailExtensionComponent | null;
+//# sourceMappingURL=registry.d.ts.map

package/components/apps/extensions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/components/apps/extensions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAK3D,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,eAAe,GACnB,2BAA2B,GAAG,IAAI,CAIpC"}

package/components/apps/extensions/registry.js

@@ -0,0 +1,7 @@
+const DETAIL_EXTENSION_COMPONENTS = {};
+export function getAppDetailExtension(app) {
+    const detailPanelId = app.uiExtension?.detailPanelId;
+    if (!detailPanelId)
+        return null;
+    return DETAIL_EXTENSION_COMPONENTS[detailPanelId] ?? null;
+}

package/components/apps/extensions/types.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentType } from "react";
+import type { RegistryAppInfo } from "../../../api";
+export interface AppDetailExtensionProps {
+    app: RegistryAppInfo;
+}
+export type AppDetailExtensionComponent = ComponentType<AppDetailExtensionProps>;
+//# sourceMappingURL=types.d.ts.map

package/components/apps/extensions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/apps/extensions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,eAAe,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GACrC,aAAa,CAAC,uBAAuB,CAAC,CAAC"}

package/components/apps/extensions/types.js

@@ -0,0 +1 @@
+export {};

package/components/apps/helpers.d.ts

@@ -0,0 +1,7 @@
+import type { RegistryAppInfo } from "../../api";
+export declare const DEFAULT_VIEWER_SANDBOX = "allow-scripts allow-same-origin allow-popups";
+export declare const CATEGORY_LABELS: Record<string, string>;
+export declare function shouldShowAppInAppsView(app: Pick<RegistryAppInfo, "name">, isProd?: boolean): boolean;
+export declare function getAppShortName(app: RegistryAppInfo): string;
+export declare function getAppEmoji(app: RegistryAppInfo): string;
+//# sourceMappingURL=helpers.d.ts.map

package/components/apps/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/components/apps/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD,eAAO,MAAM,sBAAsB,iDACa,CAAC;AAIjD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKlD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EAClC,MAAM,UAAuB,GAC5B,OAAO,CAGT;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAI5D;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAcxD"}

package/components/apps/helpers.js

@@ -0,0 +1,44 @@
+export const DEFAULT_VIEWER_SANDBOX = "allow-scripts allow-same-origin allow-popups";
+const PROD_ALLOWED_APPS = new Set(["@iqlabs-official/plugin-clawbal"]);
+export const CATEGORY_LABELS = {
+    game: "Game",
+    social: "Social",
+    platform: "Platform",
+    world: "World",
+};
+export function shouldShowAppInAppsView(app, isProd = import.meta.env.PROD) {
+    if (!isProd)
+        return true;
+    return PROD_ALLOWED_APPS.has(app.name);
+}
+export function getAppShortName(app) {
+    const display = app.displayName ?? app.name;
+    const clean = display.replace(/^@[^/]+\/app-/, "");
+    return clean.charAt(0).toUpperCase() + clean.slice(1);
+}
+export function getAppEmoji(app) {
+    const name = (app.name ?? "").toLowerCase();
+    if (name.includes("2004") || name.includes("runescape"))
+        return "⚔️";
+    if (name.includes("town"))
+        return "🏘️";
+    if (name.includes("babylon"))
+        return "🏛️";
+    if (name.includes("clawbal"))
+        return "🎯";
+    if (name.includes("minecraft"))
+        return "⛏️";
+    if (name.includes("roblox"))
+        return "🧱";
+    if (name.includes("dungeons"))
+        return "🗡️";
+    if (name.includes("hyperfy"))
+        return "🌀";
+    if (app.category === "game")
+        return "🎮";
+    if (app.category === "social")
+        return "💬";
+    if (app.category === "world")
+        return "🌍";
+    return "📦";
+}

package/components/avatar/VrmAnimationLoader.d.ts

@@ -0,0 +1,30 @@
+import type { VRM } from "@pixiv/three-vrm";
+import type * as THREE from "three";
+/**
+ * Context needed by the animation loader to check whether the owning engine
+ * is still alive / relevant for the load request.
+ */
+export type AnimationLoaderContext = {
+    /** Returns `true` if the loading sequence was aborted (engine disposed). */
+    isAborted: () => boolean;
+    /** Returns `true` if `vrm` is still the active model in the engine. */
+    isCurrentVrm: (vrm: VRM) => boolean;
+};
+/**
+ * Load and return an idle {@link THREE.AnimationClip} for the given VRM.
+ *
+ * Loads the GLB idle animation and retargets it to VRM bones.
+ * Returns `null` when the load was aborted (engine disposed / VRM replaced).
+ * Throws when the idle clip cannot be loaded.
+ */
+export declare function loadIdleClip(vrm: VRM, idleGlbUrl: string, ctx: AnimationLoaderContext): Promise<THREE.AnimationClip | null>;
+/**
+ * Load a single emote animation clip (GLB/FBX) and retarget it to
+ * the supplied VRM. Returns `null` when the load was aborted or the file
+ * format could not be processed.
+ *
+ * Supports both `.glb` / `.gltf` files (retargeted via retargetMixamoGltfToVrm)
+ * and Mixamo `.fbx` files (retargeted via retargetMixamoFbxToVrm).
+ */
+export declare function loadEmoteClip(path: string, vrm: VRM, ctx: AnimationLoaderContext): Promise<THREE.AnimationClip | null>;
+//# sourceMappingURL=VrmAnimationLoader.d.ts.map

package/components/avatar/VrmAnimationLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VrmAnimationLoader.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/VrmAnimationLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAIpC;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,uEAAuE;IACvE,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC;CACrC,CAAC;AA0CF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,GAAG,EACR,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CAwBrC;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,sBAAsB,GAC1B,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,CA6CrC"}

package/components/avatar/VrmAnimationLoader.js

@@ -0,0 +1,99 @@
+import { FBXLoader } from "three/examples/jsm/loaders/FBXLoader.js";
+import { GLTFLoader } from "three/examples/jsm/loaders/GLTFLoader.js";
+function isGzipBuffer(buffer) {
+    if (buffer.byteLength < 2)
+        return false;
+    const bytes = new Uint8Array(buffer, 0, 2);
+    return bytes[0] === 0x1f && bytes[1] === 0x8b;
+}
+async function decompressGzipBuffer(buffer) {
+    if (typeof DecompressionStream !== "function") {
+        throw new Error("This runtime does not support gzip-compressed animation assets.");
+    }
+    const stream = new Blob([buffer])
+        .stream()
+        .pipeThrough(new DecompressionStream("gzip"));
+    return await new Response(stream).arrayBuffer();
+}
+async function fetchAnimationBuffer(path) {
+    const response = await fetch(path);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch animation asset: ${response.status}`);
+    }
+    const buffer = await response.arrayBuffer();
+    return isGzipBuffer(buffer) ? await decompressGzipBuffer(buffer) : buffer;
+}
+function getAssetResourcePath(path) {
+    const withoutQuery = path.split(/[?#]/, 1)[0] ?? path;
+    const lastSlash = withoutQuery.lastIndexOf("/");
+    return lastSlash >= 0 ? withoutQuery.slice(0, lastSlash + 1) : "./";
+}
+function isFbxAsset(path) {
+    const normalized = path.toLowerCase();
+    return normalized.endsWith(".fbx") || normalized.endsWith(".fbx.gz");
+}
+/**
+ * Load and return an idle {@link THREE.AnimationClip} for the given VRM.
+ *
+ * Loads the GLB idle animation and retargets it to VRM bones.
+ * Returns `null` when the load was aborted (engine disposed / VRM replaced).
+ * Throws when the idle clip cannot be loaded.
+ */
+export async function loadIdleClip(vrm, idleGlbUrl, ctx) {
+    const { retargetMixamoGltfToVrm } = await import("./retargetMixamoGltfToVrm");
+    if (ctx.isAborted() || !ctx.isCurrentVrm(vrm))
+        return null;
+    const gltfLoader = new GLTFLoader();
+    const gltf = await gltfLoader.parseAsync(await fetchAnimationBuffer(idleGlbUrl), getAssetResourcePath(idleGlbUrl));
+    if (ctx.isAborted() || !ctx.isCurrentVrm(vrm))
+        return null;
+    gltf.scene.updateMatrixWorld(true);
+    vrm.scene.updateMatrixWorld(true);
+    const clip = retargetMixamoGltfToVrm({ scene: gltf.scene, animations: gltf.animations }, vrm);
+    if (!clip) {
+        throw new Error("No usable idle animation (idle.glb)");
+    }
+    if (ctx.isAborted() || !ctx.isCurrentVrm(vrm))
+        return null;
+    return clip;
+}
+/**
+ * Load a single emote animation clip (GLB/FBX) and retarget it to
+ * the supplied VRM. Returns `null` when the load was aborted or the file
+ * format could not be processed.
+ *
+ * Supports both `.glb` / `.gltf` files (retargeted via retargetMixamoGltfToVrm)
+ * and Mixamo `.fbx` files (retargeted via retargetMixamoFbxToVrm).
+ */
+export async function loadEmoteClip(path, vrm, ctx) {
+    try {
+        if (!ctx.isCurrentVrm(vrm))
+            return null;
+        const isFbx = isFbxAsset(path);
+        if (isFbx) {
+            const { retargetMixamoFbxToVrm } = await import("./retargetMixamoFbxToVrm");
+            const fbxLoader = new FBXLoader();
+            const fbx = fbxLoader.parse(await fetchAnimationBuffer(path), getAssetResourcePath(path));
+            if (!ctx.isCurrentVrm(vrm))
+                return null;
+            const sourceClip = fbx.animations[0];
+            if (!sourceClip) {
+                console.warn(`[VrmEngine] FBX has no animations: ${path}`);
+                return null;
+            }
+            return retargetMixamoFbxToVrm(fbx, sourceClip, vrm);
+        }
+        const { retargetMixamoGltfToVrm } = await import("./retargetMixamoGltfToVrm");
+        const loader = new GLTFLoader();
+        const gltf = await loader.parseAsync(await fetchAnimationBuffer(path), getAssetResourcePath(path));
+        if (!ctx.isCurrentVrm(vrm))
+            return null;
+        gltf.scene.updateMatrixWorld(true);
+        vrm.scene.updateMatrixWorld(true);
+        return retargetMixamoGltfToVrm({ scene: gltf.scene, animations: gltf.animations }, vrm);
+    }
+    catch (err) {
+        console.error(`[VrmEngine] Failed to load emote: ${path}`, err);
+        return null;
+    }
+}

package/components/avatar/VrmBlinkController.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Self-contained blink state machine for VRM eye-blink animation.
+ *
+ * State flow: idle -> closing -> closed -> opening -> idle
+ * Random interval between blinks with occasional double-blinks.
+ */
+export declare class VrmBlinkController {
+    private blinkPhase;
+    private blinkTimer;
+    private blinkPhaseTimer;
+    private _blinkValue;
+    private nextBlinkDelay;
+    /** Duration (seconds) for eyelids to close */
+    private static readonly BLINK_CLOSE_DURATION;
+    /** Duration (seconds) eyelids stay fully closed */
+    private static readonly BLINK_HOLD_DURATION;
+    /** Duration (seconds) for eyelids to re-open */
+    private static readonly BLINK_OPEN_DURATION;
+    /** Minimum seconds between blinks */
+    private static readonly BLINK_MIN_INTERVAL;
+    /** Maximum seconds between blinks */
+    private static readonly BLINK_MAX_INTERVAL;
+    /** Probability of a quick double-blink */
+    private static readonly DOUBLE_BLINK_CHANCE;
+    /** Current blink expression weight (0 = open, 1 = closed). */
+    get blinkValue(): number;
+    /**
+     * Advance the blink state machine by `delta` seconds.
+     * Returns the current blink expression weight (0..1).
+     */
+    update(delta: number): number;
+    /** Reset blink state (called when a new VRM is loaded). */
+    reset(): void;
+    /** Pick the delay (seconds) until the next blink. */
+    private scheduleNextBlink;
+}
+//# sourceMappingURL=VrmBlinkController.d.ts.map

package/components/avatar/VrmBlinkController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VrmBlinkController.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/VrmBlinkController.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,cAAc,CAAyB;IAE/C,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAQ;IACpD,mDAAmD;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IACnD,gDAAgD;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IACnD,qCAAqC;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IACjD,qCAAqC;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IACjD,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAQ;IAEnD,8DAA8D;IAC9D,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAyD7B,2DAA2D;IAC3D,KAAK,IAAI,IAAI;IAQb,qDAAqD;IACrD,OAAO,CAAC,iBAAiB;CAY1B"}

package/components/avatar/VrmBlinkController.js

@@ -0,0 +1,98 @@
+/**
+ * Self-contained blink state machine for VRM eye-blink animation.
+ *
+ * State flow: idle -> closing -> closed -> opening -> idle
+ * Random interval between blinks with occasional double-blinks.
+ */
+export class VrmBlinkController {
+    blinkPhase = "idle";
+    blinkTimer = 0;
+    blinkPhaseTimer = 0;
+    _blinkValue = 0;
+    nextBlinkDelay = 2 + Math.random() * 3;
+    /** Duration (seconds) for eyelids to close */
+    static BLINK_CLOSE_DURATION = 0.06;
+    /** Duration (seconds) eyelids stay fully closed */
+    static BLINK_HOLD_DURATION = 0.04;
+    /** Duration (seconds) for eyelids to re-open */
+    static BLINK_OPEN_DURATION = 0.12;
+    /** Minimum seconds between blinks */
+    static BLINK_MIN_INTERVAL = 1.8;
+    /** Maximum seconds between blinks */
+    static BLINK_MAX_INTERVAL = 5.5;
+    /** Probability of a quick double-blink */
+    static DOUBLE_BLINK_CHANCE = 0.15;
+    /** Current blink expression weight (0 = open, 1 = closed). */
+    get blinkValue() {
+        return this._blinkValue;
+    }
+    /**
+     * Advance the blink state machine by `delta` seconds.
+     * Returns the current blink expression weight (0..1).
+     */
+    update(delta) {
+        switch (this.blinkPhase) {
+            case "idle":
+                this.blinkTimer += delta;
+                if (this.blinkTimer >= this.nextBlinkDelay) {
+                    this.blinkPhase = "closing";
+                    this.blinkPhaseTimer = 0;
+                }
+                break;
+            case "closing": {
+                this.blinkPhaseTimer += delta;
+                const t = Math.min(1, this.blinkPhaseTimer / VrmBlinkController.BLINK_CLOSE_DURATION);
+                // Ease-in (accelerate) — eyelids speed up as they close
+                this._blinkValue = t * t;
+                if (t >= 1) {
+                    this.blinkPhase = "closed";
+                    this.blinkPhaseTimer = 0;
+                    this._blinkValue = 1;
+                }
+                break;
+            }
+            case "closed":
+                this.blinkPhaseTimer += delta;
+                if (this.blinkPhaseTimer >= VrmBlinkController.BLINK_HOLD_DURATION) {
+                    this.blinkPhase = "opening";
+                    this.blinkPhaseTimer = 0;
+                }
+                break;
+            case "opening": {
+                this.blinkPhaseTimer += delta;
+                const t = Math.min(1, this.blinkPhaseTimer / VrmBlinkController.BLINK_OPEN_DURATION);
+                // Ease-out (decelerate) — eyelids slow down as they finish opening
+                const eased = 1 - (1 - t) * (1 - t);
+                this._blinkValue = 1 - eased;
+                if (t >= 1) {
+                    this.blinkPhase = "idle";
+                    this.blinkPhaseTimer = 0;
+                    this._blinkValue = 0;
+                    this.blinkTimer = 0;
+                    this.scheduleNextBlink();
+                }
+                break;
+            }
+        }
+        return this._blinkValue;
+    }
+    /** Reset blink state (called when a new VRM is loaded). */
+    reset() {
+        this.blinkPhase = "idle";
+        this.blinkTimer = 0;
+        this.blinkPhaseTimer = 0;
+        this._blinkValue = 0;
+        this.nextBlinkDelay = 1.5 + Math.random() * 2;
+    }
+    /** Pick the delay (seconds) until the next blink. */
+    scheduleNextBlink() {
+        const range = VrmBlinkController.BLINK_MAX_INTERVAL -
+            VrmBlinkController.BLINK_MIN_INTERVAL;
+        this.nextBlinkDelay =
+            VrmBlinkController.BLINK_MIN_INTERVAL + Math.random() * range;
+        // Occasional quick double-blink
+        if (Math.random() < VrmBlinkController.DOUBLE_BLINK_CHANCE) {
+            this.nextBlinkDelay = 0.12 + Math.random() * 0.08;
+        }
+    }
+}

package/components/avatar/VrmCameraManager.d.ts

@@ -0,0 +1,57 @@
+import type { VRM } from "@pixiv/three-vrm";
+import * as THREE from "three";
+import type { OrbitControls } from "three/examples/jsm/controls/OrbitControls.js";
+export type CameraProfile = "chat" | "companion" | "companion_close";
+export type InteractionMode = "free" | "orbitZoom";
+export type CameraAnimationConfig = {
+    enabled: boolean;
+    swayAmplitude: number;
+    bobAmplitude: number;
+    rotationAmplitude: number;
+    speed: number;
+};
+/**
+ * Handles VRM avatar framing, camera profile application, companion-mode
+ * bounds-based camera fitting, subtle companion camera motion, interaction modes,
+ * and VRM face-orientation correction.
+ */
+export declare class VrmCameraManager {
+    private readonly tempBoundsSize;
+    private readonly tempBoundsCenter;
+    private readonly tempWorldPosition;
+    private readonly tempSecondaryWorldPosition;
+    private readonly tempTertiaryWorldPosition;
+    private readonly tempOrbitOffset;
+    private readonly tempOrbitSpherical;
+    /**
+     * Position and scale the VRM for the active camera profile, then place the
+     * camera accordingly. Updates `lookAtTarget` and `baseCameraPosition` in place.
+     */
+    centerAndFrame(vrm: VRM, camera: THREE.PerspectiveCamera, controls: OrbitControls | null, cameraProfile: CameraProfile, lookAtTarget: THREE.Vector3, baseCameraPosition: THREE.Vector3, applyInteractionMode: (controls: OrbitControls) => void): void;
+    private normalizeAvatarToStage;
+    /**
+     * For the companion profile, adapt camera distance so the full avatar
+     * body stays in frame regardless of model dimensions.
+     */
+    adjustCompanionCameraForAvatarBounds(vrm: VRM, camera: THREE.PerspectiveCamera, controls: OrbitControls | null, cameraProfile: CameraProfile, lookAtTarget: THREE.Vector3): void;
+    private getAvatarFeetAnchor;
+    private getAvatarNeckHeight;
+    /**
+     * Apply preset camera position, FOV and orbit constraints for the given
+     * camera profile.
+     */
+    applyCameraProfileToCamera(camera: THREE.PerspectiveCamera, controls: OrbitControls | null, cameraProfile: CameraProfile): void;
+    /**
+     * Animate the camera in a shallow front-facing orbit around the avatar's
+     * look target so companion mode feels alive without breaking the framing.
+     */
+    applyCameraMotion(camera: THREE.PerspectiveCamera, baseCameraPosition: THREE.Vector3, lookAtTarget: THREE.Vector3, cameraAnimation: CameraAnimationConfig, elapsedTime: number): void;
+    /** Configure OrbitControls for the given interaction mode. */
+    applyInteractionMode(controls: OrbitControls, interactionMode: InteractionMode): void;
+    /**
+     * Detect whether the VRM is facing away from the camera using eye-bone
+     * heuristics, and rotate it 180 degrees if needed.
+     */
+    ensureFacingCamera(vrm: VRM, camera: THREE.PerspectiveCamera): void;
+}
+//# sourceMappingURL=VrmCameraManager.d.ts.map

package/components/avatar/VrmCameraManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VrmCameraManager.d.ts","sourceRoot":"","sources":["../../../src/components/avatar/VrmCameraManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAIlF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC;AACrE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnD,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuB;IACtD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuB;IACzD,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAuB;IAClE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAuB;IACjE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAE5D;;;OAGG;IACH,cAAc,CACZ,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAC/B,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,KAAK,CAAC,OAAO,EAC3B,kBAAkB,EAAE,KAAK,CAAC,OAAO,EACjC,oBAAoB,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,GACtD,IAAI;IAuBP,OAAO,CAAC,sBAAsB;IAsC9B;;;OAGG;IACH,oCAAoC,CAClC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAC/B,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,KAAK,CAAC,OAAO,GAC1B,IAAI;IAkEP,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IA2B3B;;;OAGG;IACH,0BAA0B,CACxB,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAC/B,QAAQ,EAAE,aAAa,GAAG,IAAI,EAC9B,aAAa,EAAE,aAAa,GAC3B,IAAI;IA+BP;;;OAGG;IACH,iBAAiB,CACf,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAC/B,kBAAkB,EAAE,KAAK,CAAC,OAAO,EACjC,YAAY,EAAE,KAAK,CAAC,OAAO,EAC3B,eAAe,EAAE,qBAAqB,EACtC,WAAW,EAAE,MAAM,GAClB,IAAI;IA2DP,8DAA8D;IAC9D,oBAAoB,CAClB,QAAQ,EAAE,aAAa,EACvB,eAAe,EAAE,eAAe,GAC/B,IAAI;IAmBP;;;OAGG;IACH,kBAAkB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,iBAAiB,GAAG,IAAI;CAgDpE"}