@elizaos/app-core 2.0.0-alpha.37

package/dist/config/ui-spec.d.ts

@@ -0,0 +1,164 @@
+/**
+ * ui-spec.ts — TypeScript types for the json-render declarative UI spec.
+ *
+ * A UiSpec describes a tree of UI components that can be rendered
+ * from a JSON declaration. This is the full json-render component model.
+ *
+ * Structure:
+ *   { root: "main", elements: { [id]: UiElement }, state: { ... } }
+ *
+ * Each element has a type, props, optional children (IDs), event bindings,
+ * conditional visibility, validation, and repeat/list support.
+ */
+/** A value that can be either a literal or a path reference. */
+export type DynamicProp<T = string> = T | {
+    $path: string;
+};
+/** Conditional expression for dynamic prop resolution. */
+export interface CondExpr {
+    $cond: {
+        eq?: [unknown, unknown];
+        neq?: [unknown, unknown];
+        gt?: [unknown, unknown];
+        lt?: [unknown, unknown];
+        gte?: [unknown, unknown];
+        lte?: [unknown, unknown];
+        truthy?: unknown;
+        falsy?: unknown;
+        path?: string;
+    };
+    $then: unknown;
+    $else: unknown;
+}
+export type VisibilityOperator = "eq" | "ne" | "gt" | "gte" | "lt" | "lte";
+/** Path-based visibility condition. */
+export interface PathVisibility {
+    path: string;
+    operator: VisibilityOperator;
+    value: unknown;
+}
+/** Auth-based visibility condition. */
+export interface AuthVisibility {
+    auth: "signedIn" | "signedOut" | "admin" | string;
+}
+/** Logical combinators for complex visibility. */
+export interface AndVisibility {
+    and: VisibilityCondition[];
+}
+export interface OrVisibility {
+    or: VisibilityCondition[];
+}
+export interface NotVisibility {
+    not: VisibilityCondition;
+}
+export type VisibilityCondition = PathVisibility | AuthVisibility | AndVisibility | OrVisibility | NotVisibility;
+/** Built-in validator function names. */
+export type BuiltinValidator = "required" | "email" | "minLength" | "maxLength" | "pattern" | "min" | "max";
+/** A single validation check on a field. */
+export interface ValidationCheck {
+    fn: string;
+    args?: Record<string, unknown>;
+    message: string;
+}
+/** Validation configuration for a form element. */
+export interface ValidationConfig {
+    checks: ValidationCheck[];
+    validateOn?: "change" | "blur" | "submit";
+}
+/** Action success/error handlers. */
+export interface ActionOnSuccess {
+    action: string;
+    params?: Record<string, unknown>;
+}
+export interface ActionOnError {
+    action: string;
+    params?: Record<string, unknown>;
+}
+/** Confirmation prompt before action execution. */
+export interface ActionConfirm {
+    title: string;
+    message?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+}
+export interface UiAction {
+    action: string;
+    params?: Record<string, unknown>;
+    confirm?: ActionConfirm;
+    onSuccess?: ActionOnSuccess;
+    onError?: ActionOnError;
+}
+export type UiEventBindings = Record<string, UiAction>;
+export interface RepeatConfig {
+    path: string;
+    key: string;
+}
+export type UiComponentType = "Stack" | "Grid" | "Card" | "Separator" | "Heading" | "Text" | "Input" | "Textarea" | "Select" | "Checkbox" | "Radio" | "Switch" | "Slider" | "Toggle" | "ToggleGroup" | "ButtonGroup" | "Table" | "Carousel" | "Badge" | "Avatar" | "Image" | "Alert" | "Progress" | "Rating" | "Skeleton" | "Spinner" | "Button" | "Link" | "DropdownMenu" | "Tabs" | "Pagination" | "Metric" | "BarGraph" | "LineGraph" | "Tooltip" | "Popover" | "Collapsible" | "Accordion" | "Dialog" | "Drawer";
+export interface UiElement {
+    type: UiComponentType;
+    props: Record<string, unknown>;
+    children: string[];
+    on?: UiEventBindings;
+    repeat?: RepeatConfig;
+    visible?: VisibilityCondition;
+    validation?: ValidationConfig;
+}
+export interface UiSpec {
+    root: string;
+    elements: Record<string, UiElement>;
+    state: Record<string, unknown>;
+}
+export interface AuthState {
+    isSignedIn: boolean;
+    roles?: string[];
+}
+export interface UiRenderContext {
+    spec: UiSpec;
+    state: Record<string, unknown>;
+    setState: (path: string, value: unknown) => void;
+    onAction?: (action: string, params?: Record<string, unknown>) => void;
+    /** Current repeat item data (set when inside a repeat block). */
+    repeatItem?: Record<string, unknown>;
+    /** Auth state for visibility evaluation. */
+    auth?: AuthState;
+    /** Whether the renderer is in a loading/streaming state. */
+    loading?: boolean;
+    /** Custom validator functions. */
+    validators?: Record<string, (value: unknown, args?: Record<string, unknown>) => boolean | Promise<boolean>>;
+    /** Field validation errors keyed by statePath. */
+    fieldErrors?: Record<string, string[]>;
+    /** Trigger validation for a field. */
+    validateField?: (statePath: string) => void;
+}
+/** RFC 6902 JSON Patch operation. */
+export type PatchOp = {
+    op: "add";
+    path: string;
+    value: unknown;
+} | {
+    op: "remove";
+    path: string;
+} | {
+    op: "replace";
+    path: string;
+    value: unknown;
+} | {
+    op: "move";
+    from: string;
+    path: string;
+} | {
+    op: "copy";
+    from: string;
+    path: string;
+} | {
+    op: "test";
+    path: string;
+    value: unknown;
+};
+/** Stream configuration for useUIStream. */
+export interface UIStreamConfig {
+    api: string;
+    onComplete?: (spec: UiSpec) => void;
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=ui-spec.d.ts.map

package/dist/config/ui-spec.d.ts.map

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

package/dist/config/ui-spec.js

@@ -0,0 +1,13 @@
+/**
+ * ui-spec.ts — TypeScript types for the json-render declarative UI spec.
+ *
+ * A UiSpec describes a tree of UI components that can be rendered
+ * from a JSON declaration. This is the full json-render component model.
+ *
+ * Structure:
+ *   { root: "main", elements: { [id]: UiElement }, state: { ... } }
+ *
+ * Each element has a type, props, optional children (IDs), event bindings,
+ * conditional visibility, validation, and repeat/list support.
+ */
+export {};

package/dist/events/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Typed constants for milady:* custom events dispatched across the app.
+ *
+ * Using these constants instead of raw strings prevents typo-driven drift
+ * between producers (main.tsx, bridge, components) and consumers (AppContext,
+ * EmotePicker, ChatView, etc.).
+ */
+export declare const COMMAND_PALETTE_EVENT: "milady:command-palette";
+export declare const EMOTE_PICKER_EVENT: "milady:emote-picker";
+export declare const STOP_EMOTE_EVENT: "milady:stop-emote";
+export declare const AGENT_READY_EVENT: "milady:agent-ready";
+export declare const BRIDGE_READY_EVENT: "milady:bridge-ready";
+export declare const SHARE_TARGET_EVENT: "milady:share-target";
+export declare const TRAY_ACTION_EVENT: "milady:tray-action";
+export declare const APP_RESUME_EVENT: "milady:app-resume";
+export declare const APP_PAUSE_EVENT: "milady:app-pause";
+export declare const CONNECT_EVENT: "milady:connect";
+export declare const VOICE_CONFIG_UPDATED_EVENT: "milady:voice-config-updated";
+export declare const CHAT_AVATAR_VOICE_EVENT: "milady:chat-avatar-voice";
+export declare const APP_EMOTE_EVENT: "milady:app-emote";
+export declare const SELF_STATUS_SYNC_EVENT: "milady:self-status-refresh";
+export interface AppEmoteEventDetail {
+    emoteId: string;
+    path: string;
+    duration: number;
+    loop: boolean;
+    showOverlay?: boolean;
+}
+export interface ChatAvatarVoiceEventDetail {
+    mouthOpen: number;
+    isSpeaking: boolean;
+}
+export type MiladyDocumentEventName = typeof COMMAND_PALETTE_EVENT | typeof EMOTE_PICKER_EVENT | typeof STOP_EMOTE_EVENT | typeof AGENT_READY_EVENT | typeof BRIDGE_READY_EVENT | typeof SHARE_TARGET_EVENT | typeof TRAY_ACTION_EVENT | typeof APP_RESUME_EVENT | typeof APP_PAUSE_EVENT | typeof CONNECT_EVENT;
+export type MiladyWindowEventName = typeof VOICE_CONFIG_UPDATED_EVENT | typeof CHAT_AVATAR_VOICE_EVENT | typeof APP_EMOTE_EVENT | typeof SELF_STATUS_SYNC_EVENT;
+export type MiladyEventName = MiladyDocumentEventName | MiladyWindowEventName;
+/** Dispatch a typed custom event on `document`. */
+export declare function dispatchMiladyEvent(name: MiladyDocumentEventName, detail?: unknown): void;
+/** Dispatch a typed custom event on `window`. */
+export declare function dispatchWindowEvent(name: MiladyWindowEventName, detail?: unknown): void;
+/** Dispatch a normalized app-wide emote event on `window`. */
+export declare function dispatchAppEmoteEvent(detail: AppEmoteEventDetail): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,eAAO,MAAM,qBAAqB,EAAG,wBAAiC,CAAC;AACvE,eAAO,MAAM,kBAAkB,EAAG,qBAA8B,CAAC;AACjE,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAG7D,eAAO,MAAM,iBAAiB,EAAG,oBAA6B,CAAC;AAC/D,eAAO,MAAM,kBAAkB,EAAG,qBAA8B,CAAC;AACjE,eAAO,MAAM,kBAAkB,EAAG,qBAA8B,CAAC;AACjE,eAAO,MAAM,iBAAiB,EAAG,oBAA6B,CAAC;AAG/D,eAAO,MAAM,gBAAgB,EAAG,mBAA4B,CAAC;AAC7D,eAAO,MAAM,eAAe,EAAG,kBAA2B,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAG,gBAAyB,CAAC;AAGvD,eAAO,MAAM,0BAA0B,EACrC,6BAAsC,CAAC;AACzC,eAAO,MAAM,uBAAuB,EAAG,0BAAmC,CAAC;AAC3E,eAAO,MAAM,eAAe,EAAG,kBAA2B,CAAC;AAG3D,eAAO,MAAM,sBAAsB,EAAG,4BAAqC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,uBAAuB,GAC/B,OAAO,qBAAqB,GAC5B,OAAO,kBAAkB,GACzB,OAAO,gBAAgB,GACvB,OAAO,iBAAiB,GACxB,OAAO,kBAAkB,GACzB,OAAO,kBAAkB,GACzB,OAAO,iBAAiB,GACxB,OAAO,gBAAgB,GACvB,OAAO,eAAe,GACtB,OAAO,aAAa,CAAC;AAEzB,MAAM,MAAM,qBAAqB,GAC7B,OAAO,0BAA0B,GACjC,OAAO,uBAAuB,GAC9B,OAAO,eAAe,GACtB,OAAO,sBAAsB,CAAC;AAElC,MAAM,MAAM,eAAe,GAAG,uBAAuB,GAAG,qBAAqB,CAAC;AAI9E,mDAAmD;AACnD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,EAC7B,MAAM,CAAC,EAAE,OAAO,GACf,IAAI,CAEN;AAED,iDAAiD;AACjD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,qBAAqB,EAC3B,MAAM,CAAC,EAAE,OAAO,GACf,IAAI,CAGN;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAEvE"}

package/dist/events/index.js

@@ -0,0 +1,41 @@
+/**
+ * Typed constants for milady:* custom events dispatched across the app.
+ *
+ * Using these constants instead of raw strings prevents typo-driven drift
+ * between producers (main.tsx, bridge, components) and consumers (AppContext,
+ * EmotePicker, ChatView, etc.).
+ */
+// ── App lifecycle ────────────────────────────────────────────────────────
+export const COMMAND_PALETTE_EVENT = "milady:command-palette";
+export const EMOTE_PICKER_EVENT = "milady:emote-picker";
+export const STOP_EMOTE_EVENT = "milady:stop-emote";
+// ── Agent / bridge ───────────────────────────────────────────────────────
+export const AGENT_READY_EVENT = "milady:agent-ready";
+export const BRIDGE_READY_EVENT = "milady:bridge-ready";
+export const SHARE_TARGET_EVENT = "milady:share-target";
+export const TRAY_ACTION_EVENT = "milady:tray-action";
+// ── App state ────────────────────────────────────────────────────────────
+export const APP_RESUME_EVENT = "milady:app-resume";
+export const APP_PAUSE_EVENT = "milady:app-pause";
+export const CONNECT_EVENT = "milady:connect";
+// ── Voice / config ───────────────────────────────────────────────────────
+export const VOICE_CONFIG_UPDATED_EVENT = "milady:voice-config-updated";
+export const CHAT_AVATAR_VOICE_EVENT = "milady:chat-avatar-voice";
+export const APP_EMOTE_EVENT = "milady:app-emote";
+// ── Sidebar sync ─────────────────────────────────────────────────────────
+export const SELF_STATUS_SYNC_EVENT = "milady:self-status-refresh";
+// ── Helpers ──────────────────────────────────────────────────────────────
+/** Dispatch a typed custom event on `document`. */
+export function dispatchMiladyEvent(name, detail) {
+    document.dispatchEvent(new CustomEvent(name, { detail }));
+}
+/** Dispatch a typed custom event on `window`. */
+export function dispatchWindowEvent(name, detail) {
+    if (typeof window === "undefined")
+        return;
+    window.dispatchEvent(new CustomEvent(name, { detail }));
+}
+/** Dispatch a normalized app-wide emote event on `window`. */
+export function dispatchAppEmoteEvent(detail) {
+    dispatchWindowEvent(APP_EMOTE_EVENT, detail);
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./useBugReport";
+export * from "./useCanvasWindow";
+export * from "./useChatAvatarVoice";
+export * from "./useContextMenu";
+export * from "./useKeyboardShortcuts";
+export * from "./useLifoSync";
+export * from "./useMemoryMonitor";
+export * from "./useRenderGuard";
+export * from "./useRetakeCapture";
+export * from "./useStreamPopoutNavigation";
+export * from "./useTimeout";
+export * from "./useVoiceChat";
+export * from "./useWhatsAppPairing";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,13 @@
+export * from "./useBugReport";
+export * from "./useCanvasWindow";
+export * from "./useChatAvatarVoice";
+export * from "./useContextMenu";
+export * from "./useKeyboardShortcuts";
+export * from "./useLifoSync";
+export * from "./useMemoryMonitor";
+export * from "./useRenderGuard";
+export * from "./useRetakeCapture";
+export * from "./useStreamPopoutNavigation";
+export * from "./useTimeout";
+export * from "./useVoiceChat";
+export * from "./useWhatsAppPairing";

package/dist/hooks/useBugReport.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from "react";
+interface BugReportContextValue {
+    isOpen: boolean;
+    open: () => void;
+    close: () => void;
+}
+export declare function useBugReport(): BugReportContextValue;
+export declare function useBugReportState(): BugReportContextValue;
+export declare function BugReportProvider({ children, value, }: {
+    children: ReactNode;
+    value: BugReportContextValue;
+}): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=useBugReport.d.ts.map

package/dist/hooks/useBugReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBugReport.d.ts","sourceRoot":"","sources":["../../src/hooks/useBugReport.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AAEf,UAAU,qBAAqB;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAID,wBAAgB,YAAY,IAAI,qBAAqB,CAKpD;AAED,wBAAgB,iBAAiB,IAAI,qBAAqB,CAKzD;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,KAAK,EAAE,qBAAqB,CAAC;CAC9B,2CAMA"}

package/dist/hooks/useBugReport.js

@@ -0,0 +1,18 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useState, } from "react";
+const BugReportContext = createContext(null);
+export function useBugReport() {
+    const ctx = useContext(BugReportContext);
+    if (!ctx)
+        throw new Error("useBugReport must be used within BugReportProvider");
+    return ctx;
+}
+export function useBugReportState() {
+    const [isOpen, setIsOpen] = useState(false);
+    const open = useCallback(() => setIsOpen(true), []);
+    const close = useCallback(() => setIsOpen(false), []);
+    return { isOpen, open, close };
+}
+export function BugReportProvider({ children, value, }) {
+    return (_jsx(BugReportContext.Provider, { value: value, children: children }));
+}

package/dist/hooks/useCanvasWindow.d.ts

@@ -0,0 +1,38 @@
+/**
+ * useCanvasWindow
+ *
+ * Creates a floating BrowserWindow (via the Electrobun canvas RPC) that is
+ * positioned and sized to match a DOM placeholder div.  The BrowserWindow
+ * appears to be "embedded" because it is always kept aligned with the div.
+ *
+ * Works in:
+ *   - Electrobun — calls via the preload-exposed renderer RPC
+ *   - Legacy Electron — falls back to the historical Electron bridge
+ *
+ * Falls back gracefully (isReady=false, no window created) when neither
+ * runtime is detected (web / Capacitor / SSR).
+ */
+export interface UseCanvasWindowOptions {
+    /** URL to load inside the floating BrowserWindow. */
+    url: string;
+    /** When false the window is not created (and any existing one is destroyed). */
+    enabled: boolean;
+    /** Window title passed to canvasCreateWindow. */
+    title?: string;
+}
+export interface UseCanvasWindowResult {
+    /** Attach to the placeholder <div> that the BrowserWindow should cover. */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /** The canvas window ID returned by canvasCreateWindow, or null before ready. */
+    windowId: string | null;
+    /** True once the window has been created and positioned. */
+    isReady: boolean;
+    /** Navigate the canvas window to a new URL. */
+    navigate: (url: string) => void;
+    /** Show the canvas window (if it was hidden). */
+    show: () => void;
+    /** Hide the canvas window. */
+    hide: () => void;
+}
+export declare function useCanvasWindow(options: UseCanvasWindowOptions): UseCanvasWindowResult;
+//# sourceMappingURL=useCanvasWindow.d.ts.map

package/dist/hooks/useCanvasWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCanvasWindow.d.ts","sourceRoot":"","sources":["../../src/hooks/useCanvasWindow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,2EAA2E;IAC3E,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,iFAAiF;IACjF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,iDAAiD;IACjD,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAyBD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CA4SvB"}

package/dist/hooks/useCanvasWindow.js

@@ -0,0 +1,273 @@
+/**
+ * useCanvasWindow
+ *
+ * Creates a floating BrowserWindow (via the Electrobun canvas RPC) that is
+ * positioned and sized to match a DOM placeholder div.  The BrowserWindow
+ * appears to be "embedded" because it is always kept aligned with the div.
+ *
+ * Works in:
+ *   - Electrobun — calls via the preload-exposed renderer RPC
+ *   - Legacy Electron — falls back to the historical Electron bridge
+ *
+ * Falls back gracefully (isReady=false, no window created) when neither
+ * runtime is detected (web / Capacitor / SSR).
+ */
+import { useCallback, useEffect, useRef, useState } from "react";
+import { invokeDesktopBridgeRequest } from "../bridge";
+// ---------------------------------------------------------------------------
+// Geometry helpers
+// ---------------------------------------------------------------------------
+function getScreenRect(el) {
+    const rect = el.getBoundingClientRect();
+    return {
+        x: Math.round(rect.left + window.scrollX),
+        y: Math.round(rect.top + window.scrollY),
+        width: Math.round(rect.width),
+        height: Math.round(rect.height),
+    };
+}
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+export function useCanvasWindow(options) {
+    const { url, enabled, title } = options;
+    const containerRef = useRef(null);
+    const windowIdRef = useRef(null);
+    const [windowId, setWindowId] = useState(null);
+    const [isReady, setIsReady] = useState(false);
+    // Stable refs so callbacks don't need to re-bind.
+    const urlRef = useRef(url);
+    urlRef.current = url;
+    const titleRef = useRef(title);
+    titleRef.current = title;
+    // Track last-synced bounds to avoid redundant bridge calls.
+    const lastBoundsRef = useRef(null);
+    const syncFrameRef = useRef(null);
+    const trackingFrameRef = useRef(null);
+    const animationTrackerCountRef = useRef(0);
+    // ---------------------------------------------------------------------------
+    // Sync position/size to the placeholder div
+    // ---------------------------------------------------------------------------
+    const syncBounds = useCallback(() => {
+        const el = containerRef.current;
+        const id = windowIdRef.current;
+        if (!el || !id)
+            return;
+        const bounds = getScreenRect(el);
+        const last = lastBoundsRef.current;
+        if (last &&
+            last.x === bounds.x &&
+            last.y === bounds.y &&
+            last.width === bounds.width &&
+            last.height === bounds.height) {
+            return; // Nothing changed — skip the bridge call.
+        }
+        lastBoundsRef.current = bounds;
+        void invokeDesktopBridgeRequest({
+            rpcMethod: "canvasSetBounds",
+            ipcChannel: "canvas:setBounds",
+            params: { id, ...bounds },
+        }).catch((err) => {
+            console.warn("[useCanvasWindow] canvas:setBounds failed", err);
+        });
+    }, []);
+    const scheduleSyncBounds = useCallback(() => {
+        if (trackingFrameRef.current !== null || syncFrameRef.current !== null) {
+            return;
+        }
+        syncFrameRef.current = requestAnimationFrame(() => {
+            syncFrameRef.current = null;
+            syncBounds();
+        });
+    }, [syncBounds]);
+    const startTrackingBounds = useCallback(() => {
+        if (trackingFrameRef.current !== null) {
+            return;
+        }
+        const loop = () => {
+            syncBounds();
+            trackingFrameRef.current = requestAnimationFrame(loop);
+        };
+        trackingFrameRef.current = requestAnimationFrame(loop);
+    }, [syncBounds]);
+    const stopTrackingBounds = useCallback(() => {
+        if (trackingFrameRef.current !== null) {
+            cancelAnimationFrame(trackingFrameRef.current);
+            trackingFrameRef.current = null;
+        }
+        if (syncFrameRef.current !== null) {
+            cancelAnimationFrame(syncFrameRef.current);
+            syncFrameRef.current = null;
+        }
+    }, []);
+    // ---------------------------------------------------------------------------
+    // Lifecycle: create / destroy window
+    // ---------------------------------------------------------------------------
+    useEffect(() => {
+        if (!enabled)
+            return;
+        let destroyed = false;
+        let createdId = null;
+        // Determine initial position from the container div (if already mounted).
+        const el = containerRef.current;
+        const initial = el
+            ? getScreenRect(el)
+            : { x: 100, y: 100, width: 800, height: 600 };
+        void invokeDesktopBridgeRequest({
+            rpcMethod: "canvasCreateWindow",
+            ipcChannel: "canvas:createWindow",
+            params: {
+                url: urlRef.current,
+                title: titleRef.current ?? "Canvas",
+                x: initial.x,
+                y: initial.y,
+                width: initial.width,
+                height: initial.height,
+            },
+        })
+            .then((result) => {
+            if (!result) {
+                return;
+            }
+            if (destroyed) {
+                // Component unmounted before the promise resolved — clean up.
+                const id = result.id;
+                if (id) {
+                    void invokeDesktopBridgeRequest({
+                        rpcMethod: "canvasDestroyWindow",
+                        ipcChannel: "canvas:destroyWindow",
+                        params: { id },
+                    }).catch(() => { });
+                }
+                return;
+            }
+            const id = result.id;
+            if (!id) {
+                console.warn("[useCanvasWindow] canvasCreateWindow returned no id");
+                return;
+            }
+            createdId = id;
+            windowIdRef.current = id;
+            setWindowId(id);
+            lastBoundsRef.current = null; // Force a setBounds on next sync.
+            setIsReady(true);
+            scheduleSyncBounds();
+        })
+            .catch((err) => {
+            console.warn("[useCanvasWindow] canvas:createWindow failed", err);
+        });
+        const isTrackedTarget = (target) => {
+            const trackedElement = containerRef.current;
+            return (trackedElement !== null &&
+                target instanceof Node &&
+                trackedElement.contains(target));
+        };
+        const handleViewportChange = () => {
+            scheduleSyncBounds();
+        };
+        const startAnimationTracking = (event) => {
+            if (!isTrackedTarget(event.target)) {
+                return;
+            }
+            animationTrackerCountRef.current += 1;
+            startTrackingBounds();
+        };
+        const stopAnimationTracking = (event) => {
+            if (!isTrackedTarget(event.target)) {
+                return;
+            }
+            animationTrackerCountRef.current = Math.max(0, animationTrackerCountRef.current - 1);
+            if (animationTrackerCountRef.current === 0) {
+                stopTrackingBounds();
+                scheduleSyncBounds();
+            }
+        };
+        window.addEventListener("resize", handleViewportChange);
+        window.addEventListener("scroll", handleViewportChange, true);
+        window.addEventListener("transitionstart", startAnimationTracking, true);
+        window.addEventListener("transitionend", stopAnimationTracking, true);
+        window.addEventListener("transitioncancel", stopAnimationTracking, true);
+        window.addEventListener("animationstart", startAnimationTracking, true);
+        window.addEventListener("animationend", stopAnimationTracking, true);
+        window.addEventListener("animationcancel", stopAnimationTracking, true);
+        window.visualViewport?.addEventListener("resize", handleViewportChange);
+        window.visualViewport?.addEventListener("scroll", handleViewportChange);
+        // ResizeObserver: pick up size changes from layout shifts.
+        let ro = null;
+        if (el && typeof ResizeObserver !== "undefined") {
+            ro = new ResizeObserver(() => {
+                scheduleSyncBounds();
+            });
+            ro.observe(el);
+        }
+        return () => {
+            destroyed = true;
+            animationTrackerCountRef.current = 0;
+            stopTrackingBounds();
+            ro?.disconnect();
+            window.removeEventListener("resize", handleViewportChange);
+            window.removeEventListener("scroll", handleViewportChange, true);
+            window.removeEventListener("transitionstart", startAnimationTracking, true);
+            window.removeEventListener("transitionend", stopAnimationTracking, true);
+            window.removeEventListener("transitioncancel", stopAnimationTracking, true);
+            window.removeEventListener("animationstart", startAnimationTracking, true);
+            window.removeEventListener("animationend", stopAnimationTracking, true);
+            window.removeEventListener("animationcancel", stopAnimationTracking, true);
+            window.visualViewport?.removeEventListener("resize", handleViewportChange);
+            window.visualViewport?.removeEventListener("scroll", handleViewportChange);
+            const id = createdId ?? windowIdRef.current;
+            if (id) {
+                windowIdRef.current = null;
+                setWindowId(null);
+                setIsReady(false);
+                lastBoundsRef.current = null;
+                void invokeDesktopBridgeRequest({
+                    rpcMethod: "canvasDestroyWindow",
+                    ipcChannel: "canvas:destroyWindow",
+                    params: { id },
+                }).catch(() => { });
+            }
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [enabled, scheduleSyncBounds, startTrackingBounds, stopTrackingBounds]);
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    const navigate = useCallback((newUrl) => {
+        const id = windowIdRef.current;
+        if (!id)
+            return;
+        void invokeDesktopBridgeRequest({
+            rpcMethod: "canvasNavigate",
+            ipcChannel: "canvas:navigate",
+            params: { id, url: newUrl },
+        }).catch((err) => {
+            console.warn("[useCanvasWindow] canvas:navigate failed", err);
+        });
+    }, []);
+    const show = useCallback(() => {
+        const id = windowIdRef.current;
+        if (!id)
+            return;
+        void invokeDesktopBridgeRequest({
+            rpcMethod: "canvasShow",
+            ipcChannel: "canvas:show",
+            params: { id },
+        }).catch((err) => {
+            console.warn("[useCanvasWindow] canvas:show failed", err);
+        });
+    }, []);
+    const hide = useCallback(() => {
+        const id = windowIdRef.current;
+        if (!id)
+            return;
+        void invokeDesktopBridgeRequest({
+            rpcMethod: "canvasHide",
+            ipcChannel: "canvas:hide",
+            params: { id },
+        }).catch((err) => {
+            console.warn("[useCanvasWindow] canvas:hide failed", err);
+        });
+    }, []);
+    return { containerRef, windowId, isReady, navigate, show, hide };
+}