@rainbow-robotics/plugin-ui 0.1.2-dev.5 → 0.1.2-dev.50

package/dist/ws.d.ts

@@ -0,0 +1,73 @@
+import type { PluginUIServices } from "./host-ui";
+export interface WsHandle {
+    undeclare(): void;
+}
+export type WsSubscriber = WsHandle;
+export type WsQueryable = WsHandle;
+export declare class RbWs {
+    private readonly _socket;
+    private readonly _pluginId;
+    private readonly _subHandlers;
+    private readonly _serveHandlers;
+    private constructor();
+    static connect(url: string, pluginId: string): Promise<RbWs>;
+    private _key;
+    pub<P = any>(topic: string, payload: P): Promise<void>;
+    sub<P = any>(topic: string, handler: (payload: P) => void): Promise<WsSubscriber>;
+    action<R = any, P = any>(topic: string, payload?: P): Promise<R>;
+    serve<P = any, R = any>(topic: string, handler: (payload?: P) => R | Promise<R>): Promise<WsQueryable>;
+    close(): void;
+}
+/**
+ * Builds an rb-sdk-shaped object (pub/sub/action/serve + the passed-through
+ * toast/alert/confirm/prompt) that lazily awaits a not-yet-connected `RbWs` —
+ * so callers don't block their first render on the WebSocket handshake (there
+ * may be no backend reachable yet). Shared by both host mount paths (see
+ * ./host.tsx and muscat-plugin-kit's dev bootstrap), which otherwise
+ * duplicate this wiring.
+ */
+export declare function createLazyRbSdk(wsPromise: Promise<RbWs>, services: PluginUIServices, mount?: {
+    data?: unknown;
+    onSave?: (getPayload: () => unknown) => () => void;
+}): {
+    pub: (topic: string, payload: any) => Promise<void>;
+    sub: (topic: string, handler: (payload: any) => void) => Promise<WsHandle>;
+    action: (topic: string, payload?: any) => Promise<any>;
+    serve: (topic: string, handler: (payload?: any) => any) => Promise<WsHandle>;
+    toast: (params: {
+        title?: string;
+        message: string | import("react").ReactElement;
+        type?: "info" | "danger" | "warning" | "caution" | "success";
+        actionLabel?: string;
+        handleActionClick?: () => void;
+        closeOnActionClick?: boolean;
+        duration?: number;
+        onClose?: () => void;
+    }) => void;
+    alert: (params: {
+        title?: string;
+        message: string;
+        buttonText?: string;
+    }) => Promise<void>;
+    confirm: (params: {
+        title?: string;
+        message: string;
+        buttonText?: {
+            yes: string;
+            no: string;
+        };
+    }) => Promise<boolean>;
+    prompt: (params: {
+        title?: string;
+        message: string;
+        value?: string;
+        placeholder?: string;
+        buttonText?: {
+            yes: string;
+            no: string;
+        };
+    }) => Promise<string | undefined>;
+    data: unknown;
+    onSave: (getPayload: () => unknown) => () => void;
+};
+//# sourceMappingURL=ws.d.ts.map

package/dist/ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.ts","sourceRoot":"","sources":["../src/ws.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;AACpC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;AAMnC,qBAAa,IAAI;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAGzB;IACJ,OAAO,CAAC,QAAQ,CAAC,cAAc,CAG3B;IAEJ,OAAO;IA+BP,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB5D,OAAO,CAAC,IAAI;IAKN,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,GAC5B,OAAO,CAAC,YAAY,CAAC;IAsBlB,MAAM,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgBhE,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvC,OAAO,CAAC,WAAW,CAAC;IAYvB,KAAK,IAAI,IAAI;CAGd;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,EACxB,QAAQ,EAAE,gBAAgB,EAI1B,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACpD;iBAIoB,MAAM,WAAW,GAAG;iBAG9B,MAAM,WAEJ,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI;oBAGX,MAAM,YAAY,GAAG;mBAGlC,MAAM,WAEJ,CAAC,OAAO,CAAC,EAAE,GAAG,KAAK,GAAG;;aAnLtB,CAAC;;YAIE,CAAC;mBAGF,CAAC;yBAA+B,CAAC;0BAC7B,CAAC;gBAAuB,CAAC;eAAqB,CAAC;;;aApB1B,CAAA;;kBAC9B,CAAC;;;aACgB,CAAC;;kBAExB,CAAC;;;;;;aAEF,CAAD;;aAED,CAAC;mBAAyB,CAAC;kBAC3B,CAAA;;;;;;yBAoKuB,MAAM,OAAO,KAAK,MAAM,IAAI;EA2BrD"}

package/dist/ws.js

@@ -0,0 +1,129 @@
+import { io } from "socket.io-client";
+function resolveTopic(pluginId, topic) {
+  return topic.startsWith("/") ? topic.slice(1) : `${pluginId}/${topic}`;
+}
+class RbWs {
+  _socket;
+  _pluginId;
+  _subHandlers = /* @__PURE__ */ new Map();
+  _serveHandlers = /* @__PURE__ */ new Map();
+  constructor(socket, pluginId) {
+    this._socket = socket;
+    this._pluginId = pluginId;
+    socket.on(
+      "msg",
+      ({ topic, payload }) => {
+        this._subHandlers.get(topic)?.forEach((h) => h(payload));
+      }
+    );
+    socket.on(
+      "serve_call",
+      async ({
+        id,
+        topic,
+        payload
+      }) => {
+        const handler = this._serveHandlers.get(topic);
+        const result = handler ? await handler(payload) : void 0;
+        socket.emit("serve_reply", { id, payload: result });
+      }
+    );
+  }
+  static connect(url, pluginId) {
+    return new Promise((resolve, reject) => {
+      const socket = io(url, { transports: ["websocket"] });
+      const onConnect = () => {
+        cleanup();
+        resolve(new RbWs(socket, pluginId));
+      };
+      const onError = (err) => {
+        cleanup();
+        reject(err);
+      };
+      const cleanup = () => {
+        socket.off("connect", onConnect);
+        socket.off("connect_error", onError);
+      };
+      socket.once("connect", onConnect);
+      socket.once("connect_error", onError);
+    });
+  }
+  _key(topic) {
+    return resolveTopic(this._pluginId, topic);
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async pub(topic, payload) {
+    this._socket.emit("pub", { topic: this._key(topic), payload });
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async sub(topic, handler) {
+    const key = this._key(topic);
+    if (!this._subHandlers.has(key)) {
+      this._subHandlers.set(key, /* @__PURE__ */ new Set());
+      this._socket.emit("sub", { topic: key });
+    }
+    const h = handler;
+    this._subHandlers.get(key).add(h);
+    return {
+      undeclare: () => {
+        const set = this._subHandlers.get(key);
+        if (!set) return;
+        set.delete(h);
+        if (set.size === 0) {
+          this._subHandlers.delete(key);
+          this._socket.emit("unsub", { topic: key });
+        }
+      }
+    };
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async action(topic, payload) {
+    return new Promise((resolve, reject) => {
+      this._socket.timeout(1e4).emit(
+        "action",
+        { topic: this._key(topic), payload },
+        (err, result) => {
+          if (err) reject(err);
+          else resolve(result);
+        }
+      );
+    });
+  }
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async serve(topic, handler) {
+    const key = this._key(topic);
+    this._serveHandlers.set(key, handler);
+    this._socket.emit("serve_register", { topic: key });
+    return {
+      undeclare: () => {
+        this._serveHandlers.delete(key);
+        this._socket.emit("serve_unregister", { topic: key });
+      }
+    };
+  }
+  close() {
+    this._socket.disconnect();
+  }
+}
+function createLazyRbSdk(wsPromise, services, mount) {
+  return {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    pub: async (topic, payload) => (await wsPromise).pub(topic, payload),
+    sub: async (topic, handler) => (await wsPromise).sub(topic, handler),
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    action: async (topic, payload) => (await wsPromise).action(topic, payload),
+    serve: async (topic, handler) => (await wsPromise).serve(topic, handler),
+    toast: services.toast,
+    alert: services.alert,
+    confirm: services.confirm,
+    prompt: services.prompt,
+    data: mount?.data,
+    onSave: mount?.onSave ?? (() => () => {
+    })
+  };
+}
+export {
+  RbWs,
+  createLazyRbSdk
+};
+//# sourceMappingURL=ws.js.map

package/dist/ws.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/ws.ts"],
+  "sourcesContent": ["/**\n * Socket.IO communication client for plugin frontends.\n *\n * Topics are automatically namespaced to prevent cross-plugin collisions:\n *   \"sensor/data\"  \u2192  \"{pluginId}/sensor/data\"\n *   \"/broadcast/x\" \u2192  \"broadcast/x\"   (leading slash = absolute)\n *\n * Browser \u2190\u2192 Python backend protocol:\n *   browser emits : sub, unsub, pub, action (with ack), serve_reply\n *   server emits  : msg, serve_call\n */\nimport { io, type Socket } from \"socket.io-client\";\n// Type-only \u2014 no runtime coupling to host-ui.ts.\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport interface WsHandle {\n  undeclare(): void;\n}\n\nexport type WsSubscriber = WsHandle;\nexport type WsQueryable = WsHandle;\n\nfunction resolveTopic(pluginId: string, topic: string): string {\n  return topic.startsWith(\"/\") ? topic.slice(1) : `${pluginId}/${topic}`;\n}\n\nexport class RbWs {\n  private readonly _socket: Socket;\n  private readonly _pluginId: string;\n  private readonly _subHandlers = new Map<\n    string,\n    Set<(payload: unknown) => void>\n  >();\n  private readonly _serveHandlers = new Map<\n    string,\n    (payload?: unknown) => unknown | Promise<unknown>\n  >();\n\n  private constructor(socket: Socket, pluginId: string) {\n    this._socket = socket;\n    this._pluginId = pluginId;\n\n    // Deliver incoming pub/sub messages to registered handlers\n    socket.on(\n      \"msg\",\n      ({ topic, payload }: { topic: string; payload: unknown }) => {\n        this._subHandlers.get(topic)?.forEach((h) => h(payload));\n      },\n    );\n\n    // Python calls a browser-side serve handler\n    socket.on(\n      \"serve_call\",\n      async ({\n        id,\n        topic,\n        payload,\n      }: {\n        id: string;\n        topic: string;\n        payload: unknown;\n      }) => {\n        const handler = this._serveHandlers.get(topic);\n        const result = handler ? await handler(payload) : undefined;\n        socket.emit(\"serve_reply\", { id, payload: result });\n      },\n    );\n  }\n\n  static connect(url: string, pluginId: string): Promise<RbWs> {\n    return new Promise((resolve, reject) => {\n      const socket = io(url, { transports: [\"websocket\"] });\n      const onConnect = () => {\n        cleanup();\n        resolve(new RbWs(socket, pluginId));\n      };\n      const onError = (err: Error) => {\n        cleanup();\n        reject(err);\n      };\n      const cleanup = () => {\n        socket.off(\"connect\", onConnect);\n        socket.off(\"connect_error\", onError);\n      };\n      socket.once(\"connect\", onConnect);\n      socket.once(\"connect_error\", onError);\n    });\n  }\n\n  private _key(topic: string): string {\n    return resolveTopic(this._pluginId, topic);\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async pub<P = any>(topic: string, payload: P): Promise<void> {\n    this._socket.emit(\"pub\", { topic: this._key(topic), payload });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async sub<P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ): Promise<WsSubscriber> {\n    const key = this._key(topic);\n    if (!this._subHandlers.has(key)) {\n      this._subHandlers.set(key, new Set());\n      this._socket.emit(\"sub\", { topic: key });\n    }\n    const h = handler as (payload: unknown) => void;\n    this._subHandlers.get(key)!.add(h);\n    return {\n      undeclare: () => {\n        const set = this._subHandlers.get(key);\n        if (!set) return;\n        set.delete(h);\n        if (set.size === 0) {\n          this._subHandlers.delete(key);\n          this._socket.emit(\"unsub\", { topic: key });\n        }\n      },\n    };\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async action<R = any, P = any>(topic: string, payload?: P): Promise<R> {\n    return new Promise((resolve, reject) => {\n      this._socket\n        .timeout(10_000)\n        .emit(\n          \"action\",\n          { topic: this._key(topic), payload },\n          (err: Error | null, result: R) => {\n            if (err) reject(err);\n            else resolve(result);\n          },\n        );\n    });\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  async serve<P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ): Promise<WsQueryable> {\n    const key = this._key(topic);\n    this._serveHandlers.set(key, handler as (payload?: unknown) => unknown);\n    this._socket.emit(\"serve_register\", { topic: key });\n    return {\n      undeclare: () => {\n        this._serveHandlers.delete(key);\n        this._socket.emit(\"serve_unregister\", { topic: key });\n      },\n    };\n  }\n\n  close(): void {\n    this._socket.disconnect();\n  }\n}\n\n/**\n * Builds an rb-sdk-shaped object (pub/sub/action/serve + the passed-through\n * toast/alert/confirm/prompt) that lazily awaits a not-yet-connected `RbWs` \u2014\n * so callers don't block their first render on the WebSocket handshake (there\n * may be no backend reachable yet). Shared by both host mount paths (see\n * ./host.tsx and muscat-plugin-kit's dev bootstrap), which otherwise\n * duplicate this wiring.\n */\nexport function createLazyRbSdk(\n  wsPromise: Promise<RbWs>,\n  services: PluginUIServices,\n  // Per-mount, host-provided (unlike `services`, which is a global singleton):\n  // initial `data` and the `onSave` registration the host reads back. Plain\n  // values/closures, so they cross the dev React-instance boundary safely.\n  mount?: {\n    data?: unknown;\n    onSave?: (getPayload: () => unknown) => () => void;\n  },\n) {\n  return {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    pub: async (topic: string, payload: any) =>\n      (await wsPromise).pub(topic, payload),\n    sub: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload: any) => void,\n    ) => (await wsPromise).sub(topic, handler),\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    action: async (topic: string, payload?: any) =>\n      (await wsPromise).action(topic, payload),\n    serve: async (\n      topic: string,\n      // eslint-disable-next-line @typescript-eslint/no-explicit-any\n      handler: (payload?: any) => any,\n    ) => (await wsPromise).serve(topic, handler),\n    toast: services.toast,\n    alert: services.alert,\n    confirm: services.confirm,\n    prompt: services.prompt,\n    data: mount?.data,\n    onSave: mount?.onSave ?? (() => () => {}),\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/package.json

@@ -1,73 +1,92 @@
 {
   "name": "@rainbow-robotics/plugin-ui",
-  "version": "0.1.2-dev.5",
+  "version": "0.1.2-dev.50",
   "type": "module",
   "engines": {
     "node": ">=20"
   },
-  "description": "Muscat plugin UI contract/runtime: rb-* remote elements, sandbox bindings, and host renderer",
+  "description": "Muscat plugin UI contract/runtime: author bindings, robot SDK, and direct-mount host runtime",
   "publishConfig": {
     "access": "public"
   },
   "exports": {
-    "./elements": {
-      "import": "./dist/elements.js",
-      "types": "./dist/elements.d.ts"
-    },
     "./react": {
       "import": "./dist/react.js",
       "types": "./dist/react.d.ts"
     },
-    "./connect": {
-      "import": "./dist/connect.js",
-      "types": "./dist/connect.d.ts"
-    },
     "./sdk": {
       "import": "./dist/sdk.js",
       "types": "./dist/sdk.d.ts"
     },
+    "./ws": {
+      "import": "./dist/ws.js",
+      "types": "./dist/ws.d.ts"
+    },
+    "./host-ui": {
+      "import": "./dist/host-ui.js",
+      "types": "./dist/host-ui.d.ts"
+    },
     "./manifest": {
       "import": "./dist/manifest.js",
       "types": "./dist/manifest.d.ts"
     },
     "./host": "./src/host.tsx",
-    "./dist-browser": "./dist-browser",
+    "./plugin-data": "./src/pluginData.tsx",
+    "./vite-host": {
+      "import": "./dist/viteHost.js",
+      "types": "./dist/viteHost.d.ts"
+    },
     "./package.json": "./package.json"
   },
   "files": [
     "src",
     "dist",
-    "dist-browser",
-    "build-browser.mjs",
     "build-dist.mjs"
   ],
   "scripts": {
-    "build": "node build-dist.mjs && node build-browser.mjs",
+    "build-plugin-ui": "node build-dist.mjs",
     "lint": "node ../../node_modules/eslint/bin/eslint.js .",
     "check-types": "tsc --noEmit"
   },
   "devDependencies": {
     "@repo/eslint-config": "*",
+    "@repo/rb-components": "*",
     "@repo/typescript-config": "*",
+    "@rollup/plugin-node-resolve": "^15.3.0",
     "@types/node": "^22.13.9",
     "@types/react": "^19.0.10",
     "@types/react-dom": "^19.0.4",
     "esbuild": "^0.25.0",
-    "typescript": "^5.8.0"
+    "rollup-plugin-dts": "^6.1.1",
+    "typescript": "^5.8.0",
+    "vite": "^6.2.0"
   },
   "dependencies": {
-    "@quilted/threads": "^4.0.3",
-    "@remote-dom/core": "^1.11.1",
-    "@remote-dom/react": "^1.2.2"
+    "@radix-ui/react-context": "1.1.2",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "@radix-ui/react-menubar": "^1.1.6",
+    "@radix-ui/react-popover": "^1.1.7",
+    "@radix-ui/react-slider": "^1.2.3",
+    "@radix-ui/react-switch": "^1.2.5",
+    "@radix-ui/react-tabs": "^1.1.13",
+    "@radix-ui/react-toggle": "^1.1.10",
+    "@radix-ui/react-toggle-group": "^1.1.11",
+    "class-variance-authority": "^0.7.1",
+    "cmdk": "^1.1.1",
+    "react-day-picker": "8.10.1",
+    "react-resizable-panels": "^3.0.6",
+    "socket.io-client": "^4.8.0",
+    "vaul": "^1.1.2"
   },
   "peerDependencies": {
-    "@repo/rb-components": "*",
     "react": ">=18",
-    "react-dom": ">=18"
+    "react-dom": ">=18",
+    "vite": ">=5"
   },
   "peerDependenciesMeta": {
-    "@repo/rb-components": {
+    "vite": {
       "optional": true
     }
   }
-}
+}

package/src/host-ui.ts

@@ -0,0 +1,80 @@
+import { ReactElement } from "react";
+
+export interface PluginUIServices {
+  alert: (params: {
+    title?: string;
+    message: string;
+    buttonText?: string;
+  }) => Promise<void>;
+  confirm: (params: {
+    title?: string;
+    message: string;
+    buttonText?: {
+      yes: string;
+      no: string;
+    };
+  }) => Promise<boolean>;
+  prompt: (params: {
+    title?: string;
+    message: string;
+    value?: string;
+    placeholder?: string;
+    buttonText?: {
+      yes: string;
+      no: string;
+    };
+  }) => Promise<string | undefined>;
+  toast: (params: {
+    title?: string;
+    message: string | ReactElement;
+    type?: "info" | "danger" | "warning" | "caution" | "success";
+    actionLabel?: string;
+    handleActionClick?: () => void;
+    closeOnActionClick?: boolean;
+    duration?: number;
+    onClose?: () => void;
+  }) => void;
+}
+
+let services: PluginUIServices | null = null;
+
+/** Called by the host when it mounts a plugin. */
+export function setHostServices(next: PluginUIServices): void {
+  services = next;
+}
+
+/** Read the injected services, throwing a clear error if the host forgot. */
+export function getHostServices(): PluginUIServices {
+  if (!services) {
+    throw new Error(
+      "[plugin-ui] services not set — the plugin must be mounted by a Muscat host.",
+    );
+  }
+  return services;
+}
+
+/** Open a host alert dialog from a plugin. */
+export function alert(
+  params: Parameters<PluginUIServices["alert"]>[0],
+): Promise<void> {
+  return getHostServices().alert(params);
+}
+
+/** Open a host confirm dialog from a plugin. Resolves true/false. */
+export function confirm(
+  params: Parameters<PluginUIServices["confirm"]>[0],
+): Promise<boolean> {
+  return getHostServices().confirm(params);
+}
+
+/** Open a host prompt dialog from a plugin. Resolves the entered value, or undefined if cancelled. */
+export function prompt(
+  params: Parameters<PluginUIServices["prompt"]>[0],
+): Promise<string | undefined> {
+  return getHostServices().prompt(params);
+}
+
+/** Show a host toast from a plugin. */
+export function toast(params: Parameters<PluginUIServices["toast"]>[0]): void {
+  getHostServices().toast(params);
+}