@rainbow-robotics/plugin-ui 0.1.2-dev.9 → 1.0.1

package/dist/react.js

@@ -1,57 +1,8 @@
-import { createRemoteComponent } from "@remote-dom/react";
-import {
-  RbSliderElement,
-  RbButtonElement,
-  RbIconButtonElement,
-  RbTextElement,
-  RbTextInputElement,
-  RbSwitchElement,
-  RbSelectElement
-} from "./elements";
-const events = (map) => ({ eventProps: map });
-const Slider = createRemoteComponent(
-  "rb-slider",
-  RbSliderElement,
-  events({ onChange: { event: "change" } })
-);
-const Button = createRemoteComponent(
-  "rb-button",
-  RbButtonElement,
-  events({ onPress: { event: "press" } })
-);
-const IconButton = createRemoteComponent(
-  "rb-icon-button",
-  RbIconButtonElement,
-  events({ onPress: { event: "press" } })
-);
-const Text = createRemoteComponent(
-  "rb-text",
-  RbTextElement
-);
-const TextInput = createRemoteComponent(
-  "rb-text-input",
-  RbTextInputElement,
-  events({ onInput: { event: "input" } })
-);
-const Switch = createRemoteComponent(
-  "rb-switch",
-  RbSwitchElement,
-  events({ onChange: { event: "change" } })
-);
-const Select = createRemoteComponent(
-  "rb-select",
-  RbSelectElement,
-  events({ onChange: { event: "change" } })
-);
-import { useRb } from "./sdk";
+export * from "@repo/rb-components/new_components";
+import { useRb, useRbFormData, useRbSave } from "./sdk.js";
 export {
-  Button,
-  IconButton,
-  Select,
-  Slider,
-  Switch,
-  Text,
-  TextInput,
-  useRb
+  useRb,
+  useRbFormData,
+  useRbSave
 };
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/react.tsx"],
-  "sourcesContent": ["/**\n * Author bindings \u2014 the React components a plugin author imports from\n * `@rainbow-robotics/plugin-ui/react`.\n *\n * These are *name tags*: they render rb-* custom elements into the sandbox's\n * remote DOM. The real rb-components are rendered by the host (see ./host).\n * Event names from each element's `remoteEvents` surface as `onX` props\n * (e.g. `change` \u2192 `onChange`) carrying a `RemoteEvent` whose `detail` holds\n * the payload.\n */\nimport { createRemoteComponent } from \"@remote-dom/react\";\nimport type { ComponentType, ReactNode, Ref } from \"react\";\nimport {\n  RbSliderElement,\n  RbButtonElement,\n  RbIconButtonElement,\n  RbTextElement,\n  RbTextInputElement,\n  RbSwitchElement,\n  RbSelectElement,\n  type RbButtonProps,\n  type RbIconButtonProps,\n  type RbSelectProps,\n  type RbSliderProps,\n  type RbSwitchProps,\n  type RbTextInputProps,\n  type RbTextProps,\n} from \"./elements\";\n\n// NOTE: createRemoteComponent only treats a prop as an event listener when it is\n// declared in `eventProps`; it does NOT auto-derive from the element's\n// `remoteEvents`. These maps MUST mirror the host's eventProps (see ./host).\n//\n// `eventProps` is typed against the element's *typed* EventListeners generic.\n// Fully typing those generics would also force typing every `remoteProperties`\n// shape on the classes (remote-dom itself uses @ts-expect-error around this), so\n// we cast the event maps here. The values are verified by the demo e2e, and the\n// returned components keep their element-derived prop types for plugin authors.\ntype EventMap = Record<string, { event: string }>;\nconst events = (map: EventMap) => ({ eventProps: map }) as never;\n\ntype NoEventProps = Record<never, never>;\n\ntype RemoteElementComponentProps<\n  Element,\n  Props,\n  EventProps = NoEventProps,\n> = Props &\n  EventProps & {\n    children?: ReactNode;\n    ref?: Ref<Element>;\n    slot?: string;\n  };\n\ntype RemoteElementComponent<\n  Element,\n  Props,\n  EventProps = NoEventProps,\n> = ComponentType<RemoteElementComponentProps<Element, Props, EventProps>>;\n\nexport type RbSliderChangeEvent = { detail: number };\nexport type RbTextInputEvent = { detail: string };\nexport type RbSwitchChangeEvent = { detail: boolean };\nexport type RbSelectChangeEvent = { detail: string };\n\nexport interface RbSliderEventProps {\n  onChange?: (event: RbSliderChangeEvent) => void;\n}\n\nexport interface RbPressEventProps {\n  onPress?: () => void;\n}\n\nexport interface RbTextInputEventProps {\n  onInput?: (event: RbTextInputEvent) => void;\n}\n\nexport interface RbSwitchEventProps {\n  onChange?: (event: RbSwitchChangeEvent) => void;\n}\n\nexport interface RbSelectEventProps {\n  onChange?: (event: RbSelectChangeEvent) => void;\n}\n\nexport const Slider = createRemoteComponent(\n  \"rb-slider\",\n  RbSliderElement,\n  events({ onChange: { event: \"change\" } }),\n) as RemoteElementComponent<RbSliderElement, RbSliderProps, RbSliderEventProps>;\nexport const Button = createRemoteComponent(\n  \"rb-button\",\n  RbButtonElement,\n  events({ onPress: { event: \"press\" } }),\n) as RemoteElementComponent<RbButtonElement, RbButtonProps, RbPressEventProps>;\nexport const IconButton = createRemoteComponent(\n  \"rb-icon-button\",\n  RbIconButtonElement,\n  events({ onPress: { event: \"press\" } }),\n) as RemoteElementComponent<\n  RbIconButtonElement,\n  RbIconButtonProps,\n  RbPressEventProps\n>;\nexport const Text = createRemoteComponent(\n  \"rb-text\",\n  RbTextElement,\n) as RemoteElementComponent<RbTextElement, RbTextProps>;\nexport const TextInput = createRemoteComponent(\n  \"rb-text-input\",\n  RbTextInputElement,\n  events({ onInput: { event: \"input\" } }),\n) as RemoteElementComponent<\n  RbTextInputElement,\n  RbTextInputProps,\n  RbTextInputEventProps\n>;\nexport const Switch = createRemoteComponent(\n  \"rb-switch\",\n  RbSwitchElement,\n  events({ onChange: { event: \"change\" } }),\n) as RemoteElementComponent<RbSwitchElement, RbSwitchProps, RbSwitchEventProps>;\nexport const Select = createRemoteComponent(\n  \"rb-select\",\n  RbSelectElement,\n  events({ onChange: { event: \"change\" } }),\n) as RemoteElementComponent<RbSelectElement, RbSelectProps, RbSelectEventProps>;\n\nexport { useRb } from \"./sdk\";\nexport type { RbSdk, RbNotifyType } from \"./sdk\";\nexport type { RbSelectOption } from \"./elements\";\n"],
-  "mappings": "AAUA,SAAS,6BAA6B;AAEtC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AAYP,MAAM,SAAS,CAAC,SAAmB,EAAE,YAAY,IAAI;AA8C9C,MAAM,SAAS;AAAA,EACpB;AAAA,EACA;AAAA,EACA,OAAO,EAAE,UAAU,EAAE,OAAO,SAAS,EAAE,CAAC;AAC1C;AACO,MAAM,SAAS;AAAA,EACpB;AAAA,EACA;AAAA,EACA,OAAO,EAAE,SAAS,EAAE,OAAO,QAAQ,EAAE,CAAC;AACxC;AACO,MAAM,aAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA,OAAO,EAAE,SAAS,EAAE,OAAO,QAAQ,EAAE,CAAC;AACxC;AAKO,MAAM,OAAO;AAAA,EAClB;AAAA,EACA;AACF;AACO,MAAM,YAAY;AAAA,EACvB;AAAA,EACA;AAAA,EACA,OAAO,EAAE,SAAS,EAAE,OAAO,QAAQ,EAAE,CAAC;AACxC;AAKO,MAAM,SAAS;AAAA,EACpB;AAAA,EACA;AAAA,EACA,OAAO,EAAE,UAAU,EAAE,OAAO,SAAS,EAAE,CAAC;AAC1C;AACO,MAAM,SAAS;AAAA,EACpB;AAAA,EACA;AAAA,EACA,OAAO,EAAE,UAAU,EAAE,OAAO,SAAS,EAAE,CAAC;AAC1C;AAEA,SAAS,aAAa;",
+  "sourcesContent": ["/**\n * Author component surface \u2014 re-exports the @repo/rb-components new_components\n * barrel, plus the sdk hooks.\n *\n *   import { RBSlider, RBLabelButton, useRb } from \"@rainbow-robotics/plugin-ui/react\";\n *\n * The runtime import-map shim (./viteHost.ts) reads this module's exports\n * rather than a hardcoded list, so the two stay in sync.\n */\nexport * from \"@repo/rb-components/new_components\";\n\nexport { useRb, useRbFormData, useRbSave } from \"./sdk.js\";\nexport type { RbSdk } from \"./sdk\";\n"],
+  "mappings": "AASA,cAAc;AAEd,SAAS,OAAO,eAAe,iBAAiB;",
   "names": []
 }

package/dist/sdk.d.ts

@@ -1,9 +1,10 @@
 import type { WsSubscriber as Subscriber, WsQueryable as Queryable } from "./ws";
+import type { PluginUIServices } from "./host-ui";
 export type RbNotifyType = "info" | "success" | "warning" | "error";
 export interface RbSdk {
     /**
      * Publish JSON payload to a topic.
-     * "sensor/data" → plugin/{pluginId}/sensor/data
+     * "sensor/data" → {pluginId}/sensor/data
      * "/broadcast/x" → broadcast/x  (absolute)
      */
     pub: <P = any>(topic: string, payload: P) => Promise<void>;
@@ -20,9 +21,44 @@ export interface RbSdk {
      */
     serve: <P = any, R = any>(topic: string, handler: (payload?: P) => R | Promise<R>) => Promise<Queryable>;
     /** Show a transient notification through the host's toast system. */
-    toast: (message: string, type?: RbNotifyType) => void;
+    toast: PluginUIServices["toast"];
+    /** Show a host alert dialog. */
+    alert: PluginUIServices["alert"];
+    /** Show a host confirm dialog. Resolves true/false. */
+    confirm: PluginUIServices["confirm"];
+    /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */
+    prompt: PluginUIServices["prompt"];
+    /**
+     * Host-provided initial data for this mount — e.g. the previously-saved
+     * values when the host re-opens a form. `undefined` for a fresh mount.
+     * Prefer the `useRbFormData()` hook over reading this directly.
+     */
+    data?: unknown;
+    /**
+     * Register a getter the host calls (synchronously) to collect this plugin's
+     * save payload — e.g. when the host's Save button is clicked. The returned
+     * value must be JSON-serialisable (the host persists it). Returns an
+     * unregister fn. Prefer the `useRbSave()` hook.
+     */
+    onSave: (getPayload: () => unknown) => () => void;
 }
 export declare const RbContext: import("react").Context<RbSdk>;
 /** Access the host SDK from within a plugin component. */
 export declare function useRb(): RbSdk;
+/**
+ * Read the host-provided initial data for this mount (e.g. previously-saved
+ * form values). `undefined` for a fresh mount.
+ *
+ *   const saved = useRbFormData<MyArgs>();
+ *   const methods = useForm({ defaultValues: saved ?? DEFAULTS });
+ */
+export declare function useRbFormData<T = unknown>(): T | undefined;
+/**
+ * Register a getter the host calls to collect this plugin's save payload when
+ * the host's Save is clicked. The latest `getPayload` is always used, so it can
+ * close over current state. The returned value must be JSON-serialisable.
+ *
+ *   useRbSave(() => ({ args: getValues(), summary: buildSummary() }));
+ */
+export declare function useRbSave<T = unknown>(getPayload: () => T): void;
 //# sourceMappingURL=sdk.d.ts.map

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,IAAI,UAAU,EAAE,WAAW,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KACrC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExB,qEAAqE;IACrE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CACvD;AAuBD,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,0DAA0D;AAC1D,wBAAgB,KAAK,IAAI,KAAK,CAE7B"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,YAAY,IAAI,UAAU,EAC1B,WAAW,IAAI,SAAS,EACzB,MAAM,MAAM,CAAC;AAGd,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAEpE,MAAM,WAAW,KAAK;IACpB;;;;OAIG;IACH,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D,+DAA+D;IAC/D,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,KAC1B,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErE;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KACrC,OAAO,CAAC,SAAS,CAAC,CAAC;IAExB,qEAAqE;IACrE,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjC,gCAAgC;IAChC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACjC,uDAAuD;IACvD,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,wFAAwF;IACxF,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAEnC;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC;CACnD;AAuCD,eAAO,MAAM,SAAS,gCAAgC,CAAC;AAEvD,0DAA0D;AAC1D,wBAAgB,KAAK,IAAI,KAAK,CAE7B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,GAAG,SAAS,CAE1D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,CAKhE"}

package/dist/sdk.js

@@ -1,4 +1,4 @@
-import { createContext, useContext } from "react";
+import { createContext, useContext, useEffect, useRef } from "react";
 const noopSdk = {
   pub: async (_topic, _payload) => {
     console.warn("[plugin-ui] rb.pub called outside of a host context");
@@ -17,16 +17,41 @@ const noopSdk = {
     return { undeclare: async () => {
     } };
   },
-  toast: (message) => {
-    console.warn("[plugin-ui] rb.toast (no host):", message);
+  toast: (params) => {
+    console.warn("[plugin-ui] rb.toast (no host):", params);
+  },
+  alert: async (_) => {
+    console.warn("[plugin-ui] rb.alert called outside of a host context");
+  },
+  confirm: async (_) => {
+    console.warn("[plugin-ui] rb.confirm called outside of a host context");
+    return false;
+  },
+  prompt: async (_) => {
+    console.warn("[plugin-ui] rb.prompt called outside of a host context");
+    return void 0;
+  },
+  data: void 0,
+  onSave: () => () => {
   }
 };
 const RbContext = createContext(noopSdk);
 function useRb() {
   return useContext(RbContext);
 }
+function useRbFormData() {
+  return useRb().data;
+}
+function useRbSave(getPayload) {
+  const rb = useRb();
+  const ref = useRef(getPayload);
+  ref.current = getPayload;
+  useEffect(() => rb.onSave(() => ref.current()), [rb]);
+}
 export {
   RbContext,
-  useRb
+  useRb,
+  useRbFormData,
+  useRbSave
 };
 //# sourceMappingURL=sdk.js.map

package/dist/sdk.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/sdk.ts"],
-  "sourcesContent": ["/**\n * Plugin runtime SDK \u2014 the surface a plugin author calls from inside the sandbox.\n *\n * Zenoh methods (pub/sub/action/serve) talk directly to the Zenoh router via\n * WebSocket. Topics are auto-namespaced to plugin/{pluginId}/... to prevent\n * cross-plugin collisions. A leading \"/\" bypasses namespacing (absolute path).\n *\n * notify() is still host-mediated (goes through the Muscat shell).\n */\nimport { createContext, useContext } from \"react\";\nimport type { WsSubscriber as Subscriber, WsQueryable as Queryable } from \"./ws\";\n\nexport type RbNotifyType = \"info\" | \"success\" | \"warning\" | \"error\";\n\nexport interface RbSdk {\n  /**\n   * Publish JSON payload to a topic.\n   * \"sensor/data\" \u2192 plugin/{pluginId}/sensor/data\n   * \"/broadcast/x\" \u2192 broadcast/x  (absolute)\n   */\n  pub: <P = any>(topic: string, payload: P) => Promise<void>;\n\n  /** Subscribe to a topic. Returns a handle with undeclare(). */\n  sub: <P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ) => Promise<Subscriber>;\n\n  /**\n   * Send a request and await the first reply (Zenoh query).\n   * Use this to call a backend handler registered with rb.serve() / ZenohRouter.\n   */\n  action: <R = any, P = any>(topic: string, payload?: P) => Promise<R>;\n\n  /**\n   * Register a queryable \u2014 the frontend responds to backend queries.\n   * Mirror of rb.action() on the other side.\n   */\n  serve: <P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ) => Promise<Queryable>;\n\n  /** Show a transient notification through the host's toast system. */\n  toast: (message: string, type?: RbNotifyType) => void;\n}\n\nconst noopSdk: RbSdk = {\n  pub: async <P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.pub called outside of a host context\");\n  },\n  sub: async <P = any>(_topic?: string, _handler?: (payload: P) => void) => {\n    console.warn(\"[plugin-ui] rb.sub called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Subscriber;\n  },\n  action: async <R = any, P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.action called outside of a host context\");\n    return undefined as R;\n  },\n  serve: async <P = any, R = any>(_topic?: string, _handler?: (payload?: P) => R) => {\n    console.warn(\"[plugin-ui] rb.serve called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Queryable;\n  },\n  toast: (message) => {\n    console.warn(\"[plugin-ui] rb.toast (no host):\", message);\n  },\n};\n\nexport const RbContext = createContext<RbSdk>(noopSdk);\n\n/** Access the host SDK from within a plugin component. */\nexport function useRb(): RbSdk {\n  return useContext(RbContext);\n}\n"],
-  "mappings": "AASA,SAAS,eAAe,kBAAkB;AAsC1C,MAAM,UAAiB;AAAA,EACrB,KAAK,OAAgB,QAAiB,aAAiB;AACrD,YAAQ,KAAK,qDAAqD;AAAA,EACpE;AAAA,EACA,KAAK,OAAgB,QAAiB,aAAoC;AACxE,YAAQ,KAAK,qDAAqD;AAClE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,QAAQ,OAAyB,QAAiB,aAAiB;AACjE,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,OAAO,OAAyB,QAAiB,aAAkC;AACjF,YAAQ,KAAK,uDAAuD;AACpE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,OAAO,CAAC,YAAY;AAClB,YAAQ,KAAK,mCAAmC,OAAO;AAAA,EACzD;AACF;AAEO,MAAM,YAAY,cAAqB,OAAO;AAG9C,SAAS,QAAe;AAC7B,SAAO,WAAW,SAAS;AAC7B;",
+  "sourcesContent": ["/* eslint-disable @typescript-eslint/no-explicit-any */\n/**\n * Plugin runtime SDK (`useRb()`).\n *\n * pub/sub/action/serve talk to the Zenoh router over WebSocket. Topics are\n * namespaced to {pluginId}/... ; a leading \"/\" makes the path absolute.\n * alert/confirm/prompt/toast delegate to the host.\n */\nimport { createContext, useContext, useEffect, useRef } from \"react\";\nimport type {\n  WsSubscriber as Subscriber,\n  WsQueryable as Queryable,\n} from \"./ws\";\n// Type-only import \u2014 no runtime coupling to host-ui.ts (which itself has no\n// dependency back on sdk.ts, so this stays one-directional).\nimport type { PluginUIServices } from \"./host-ui\";\n\nexport type RbNotifyType = \"info\" | \"success\" | \"warning\" | \"error\";\n\nexport interface RbSdk {\n  /**\n   * Publish JSON payload to a topic.\n   * \"sensor/data\" \u2192 {pluginId}/sensor/data\n   * \"/broadcast/x\" \u2192 broadcast/x  (absolute)\n   */\n  pub: <P = any>(topic: string, payload: P) => Promise<void>;\n\n  /** Subscribe to a topic. Returns a handle with undeclare(). */\n  sub: <P = any>(\n    topic: string,\n    handler: (payload: P) => void,\n  ) => Promise<Subscriber>;\n\n  /**\n   * Send a request and await the first reply (Zenoh query).\n   * Use this to call a backend handler registered with rb.serve() / ZenohRouter.\n   */\n  action: <R = any, P = any>(topic: string, payload?: P) => Promise<R>;\n\n  /**\n   * Register a queryable \u2014 the frontend responds to backend queries.\n   * Mirror of rb.action() on the other side.\n   */\n  serve: <P = any, R = any>(\n    topic: string,\n    handler: (payload?: P) => R | Promise<R>,\n  ) => Promise<Queryable>;\n\n  /** Show a transient notification through the host's toast system. */\n  toast: PluginUIServices[\"toast\"];\n\n  /** Show a host alert dialog. */\n  alert: PluginUIServices[\"alert\"];\n  /** Show a host confirm dialog. Resolves true/false. */\n  confirm: PluginUIServices[\"confirm\"];\n  /** Show a host prompt dialog. Resolves the entered value, or undefined if cancelled. */\n  prompt: PluginUIServices[\"prompt\"];\n\n  /**\n   * Host-provided initial data for this mount \u2014 e.g. the previously-saved\n   * values when the host re-opens a form. `undefined` for a fresh mount.\n   * Prefer the `useRbFormData()` hook over reading this directly.\n   */\n  data?: unknown;\n\n  /**\n   * Register a getter the host calls (synchronously) to collect this plugin's\n   * save payload \u2014 e.g. when the host's Save button is clicked. The returned\n   * value must be JSON-serialisable (the host persists it). Returns an\n   * unregister fn. Prefer the `useRbSave()` hook.\n   */\n  onSave: (getPayload: () => unknown) => () => void;\n}\n\nconst noopSdk: RbSdk = {\n  pub: async <P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.pub called outside of a host context\");\n  },\n  sub: async <P = any>(_topic?: string, _handler?: (payload: P) => void) => {\n    console.warn(\"[plugin-ui] rb.sub called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Subscriber;\n  },\n  action: async <R = any, P = any>(_topic?: string, _payload?: P) => {\n    console.warn(\"[plugin-ui] rb.action called outside of a host context\");\n    return undefined as R;\n  },\n  serve: async <P = any, R = any>(\n    _topic?: string,\n    _handler?: (payload?: P) => R,\n  ) => {\n    console.warn(\"[plugin-ui] rb.serve called outside of a host context\");\n    return { undeclare: async () => {} } as unknown as Queryable;\n  },\n  toast: (params) => {\n    console.warn(\"[plugin-ui] rb.toast (no host):\", params);\n  },\n  alert: async (_) => {\n    console.warn(\"[plugin-ui] rb.alert called outside of a host context\");\n  },\n  confirm: async (_) => {\n    console.warn(\"[plugin-ui] rb.confirm called outside of a host context\");\n    return false;\n  },\n  prompt: async (_) => {\n    console.warn(\"[plugin-ui] rb.prompt called outside of a host context\");\n    return undefined;\n  },\n  data: undefined,\n  onSave: () => () => {},\n};\n\nexport const RbContext = createContext<RbSdk>(noopSdk);\n\n/** Access the host SDK from within a plugin component. */\nexport function useRb(): RbSdk {\n  return useContext(RbContext);\n}\n\n/**\n * Read the host-provided initial data for this mount (e.g. previously-saved\n * form values). `undefined` for a fresh mount.\n *\n *   const saved = useRbFormData<MyArgs>();\n *   const methods = useForm({ defaultValues: saved ?? DEFAULTS });\n */\nexport function useRbFormData<T = unknown>(): T | undefined {\n  return useRb().data as T | undefined;\n}\n\n/**\n * Register a getter the host calls to collect this plugin's save payload when\n * the host's Save is clicked. The latest `getPayload` is always used, so it can\n * close over current state. The returned value must be JSON-serialisable.\n *\n *   useRbSave(() => ({ args: getValues(), summary: buildSummary() }));\n */\nexport function useRbSave<T = unknown>(getPayload: () => T): void {\n  const rb = useRb();\n  const ref = useRef(getPayload);\n  ref.current = getPayload;\n  useEffect(() => rb.onSave(() => ref.current()), [rb]);\n}\n"],
+  "mappings": "AAQA,SAAS,eAAe,YAAY,WAAW,cAAc;AAkE7D,MAAM,UAAiB;AAAA,EACrB,KAAK,OAAgB,QAAiB,aAAiB;AACrD,YAAQ,KAAK,qDAAqD;AAAA,EACpE;AAAA,EACA,KAAK,OAAgB,QAAiB,aAAoC;AACxE,YAAQ,KAAK,qDAAqD;AAClE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,QAAQ,OAAyB,QAAiB,aAAiB;AACjE,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,OAAO,OACL,QACA,aACG;AACH,YAAQ,KAAK,uDAAuD;AACpE,WAAO,EAAE,WAAW,YAAY;AAAA,IAAC,EAAE;AAAA,EACrC;AAAA,EACA,OAAO,CAAC,WAAW;AACjB,YAAQ,KAAK,mCAAmC,MAAM;AAAA,EACxD;AAAA,EACA,OAAO,OAAO,MAAM;AAClB,YAAQ,KAAK,uDAAuD;AAAA,EACtE;AAAA,EACA,SAAS,OAAO,MAAM;AACpB,YAAQ,KAAK,yDAAyD;AACtE,WAAO;AAAA,EACT;AAAA,EACA,QAAQ,OAAO,MAAM;AACnB,YAAQ,KAAK,wDAAwD;AACrE,WAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,EACN,QAAQ,MAAM,MAAM;AAAA,EAAC;AACvB;AAEO,MAAM,YAAY,cAAqB,OAAO;AAG9C,SAAS,QAAe;AAC7B,SAAO,WAAW,SAAS;AAC7B;AASO,SAAS,gBAA4C;AAC1D,SAAO,MAAM,EAAE;AACjB;AASO,SAAS,UAAuB,YAA2B;AAChE,QAAM,KAAK,MAAM;AACjB,QAAM,MAAM,OAAO,UAAU;AAC7B,MAAI,UAAU;AACd,YAAU,MAAM,GAAG,OAAO,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;AACtD;",
   "names": []
 }

package/dist/viteHost.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Vite plugins for a HOST app previewing locally-developed plugins.
+ * Host-agnostic — paths are parameters.
+ *
+ *   import {
+ *     pluginPreviewRuntimePlugin,
+ *     pluginPreviewAssetsPlugin,
+ *     isPluginPreviewMode,
+ *   } from "@rainbow-robotics/plugin-ui/vite-host";
+ *
+ * A built plugin's bare imports (react, rb-components, plugin-ui/*) resolve via
+ * the import map this file injects, to the host's already-loaded instances.
+ * See ./host.tsx.
+ */
+import type { Plugin } from "vite";
+export declare const defaultPreviewAssetPrefixes: string[];
+export declare const contentTypeByExt: Record<string, string>;
+export declare const isPluginPreviewMode: (mode: string) => mode is "plugin-preview";
+/**
+ * Serves the shared-runtime shim modules at /plugin-shared/*.js and injects the
+ * import map so a dynamically-imported plugin's bare `import "react"` /
+ * `import "@rainbow-robotics/plugin-ui/react"` etc. resolve to the host's OWN
+ * instances (via window.__RB_SHARED__). Applied in all modes — any nexus build
+ * that can host plugins needs it.
+ */
+export declare const pluginSharedRuntimePlugin: () => Plugin;
+/** Inject the preview-host runtime flags into index.html (plugin-preview only). */
+export declare const pluginPreviewRuntimePlugin: () => Plugin;
+/** Serve the host's static assets (imgs/fonts/...) in plugin-preview dev mode. */
+export declare const pluginPreviewAssetsPlugin: (opts: {
+    assetsDir: string;
+    prefixes?: string[];
+}) => Plugin;
+/**
+ * All host-side plugin-ui Vite plugins in one call. Each self-gates by mode, so
+ * a host just spreads this into its `plugins` array.
+ *
+ *   plugins: [muscatVitePlugin({ previewAssetsDir: resolve(here, "../assets/public") })]
+ */
+export declare const muscatVitePlugin: (opts: {
+    /** Host static assets dir served in plugin-preview dev mode. */
+    previewAssetsDir: string;
+    /** Override preview asset URL prefixes. */
+    previewAssetPrefixes?: string[];
+}) => Plugin[];
+//# sourceMappingURL=viteHost.d.ts.map

package/dist/viteHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viteHost.d.ts","sourceRoot":"","sources":["../src/viteHost.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAOnC,eAAO,MAAM,2BAA2B,UAMvC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgBnD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,6BAA8B,CAAC;AAgK/E;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,QAAO,MA0B3C,CAAC;AAEH,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,QAAO,MAe5C,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,GAAI,MAAM;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,KAAG,MAwBH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC,KAAG,MAAM,EAOT,CAAC"}

package/dist/viteHost.js

@@ -0,0 +1,262 @@
+import { createReadStream, existsSync, readFileSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { extname, resolve } from "node:path";
+const require2 = createRequire(import.meta.url);
+const defaultPreviewAssetPrefixes = [
+  "/imgs/",
+  "/fonts/",
+  "/models/",
+  "/sounds/",
+  "/data/"
+];
+const contentTypeByExt = {
+  ".avif": "image/avif",
+  ".css": "text/css; charset=utf-8",
+  ".gif": "image/gif",
+  ".glb": "model/gltf-binary",
+  ".jpeg": "image/jpeg",
+  ".jpg": "image/jpeg",
+  ".js": "text/javascript; charset=utf-8",
+  ".json": "application/json; charset=utf-8",
+  ".mp3": "audio/mpeg",
+  ".png": "image/png",
+  ".svg": "image/svg+xml",
+  ".wasm": "application/wasm",
+  ".webp": "image/webp",
+  ".woff": "font/woff",
+  ".woff2": "font/woff2"
+};
+const isPluginPreviewMode = (mode) => mode === "plugin-preview";
+const SHARED_BASE = "/plugin-shared";
+const SHARED_MODULES = {
+  react: {
+    file: "react",
+    hasDefault: true,
+    names: [
+      "Children",
+      "Component",
+      "Fragment",
+      "Profiler",
+      "PureComponent",
+      "StrictMode",
+      "Suspense",
+      "cloneElement",
+      "createContext",
+      "createElement",
+      "createRef",
+      "forwardRef",
+      "isValidElement",
+      "lazy",
+      "memo",
+      "startTransition",
+      "useCallback",
+      "useContext",
+      "useDebugValue",
+      "useDeferredValue",
+      "useEffect",
+      "useId",
+      "useImperativeHandle",
+      "useInsertionEffect",
+      "useLayoutEffect",
+      "useMemo",
+      "useReducer",
+      "useRef",
+      "useState",
+      "useSyncExternalStore",
+      "useTransition",
+      "version"
+    ]
+  },
+  "react/jsx-runtime": {
+    file: "react_jsx-runtime",
+    names: ["Fragment", "jsx", "jsxs"]
+  },
+  "react/jsx-dev-runtime": {
+    file: "react_jsx-dev-runtime",
+    names: ["Fragment", "jsxDEV"]
+  },
+  "react-dom": {
+    file: "react-dom",
+    hasDefault: true,
+    names: [
+      "__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED",
+      "createPortal",
+      "createRoot",
+      "findDOMNode",
+      "flushSync",
+      "hydrate",
+      "hydrateRoot",
+      "render",
+      "unmountComponentAtNode",
+      "unstable_batchedUpdates",
+      "unstable_renderSubtreeIntoContainer",
+      "version"
+    ]
+  },
+  "react-dom/client": {
+    file: "react-dom_client",
+    names: ["createRoot", "hydrateRoot"]
+  },
+  "@rainbow-robotics/plugin-ui/react": {
+    file: "plugin-ui_react",
+    // react.tsx re-exports the full rb-components barrel (export *) plus the sdk
+    // hooks.
+    parseNamesFrom: {
+      specifier: "@repo/rb-components/new_components",
+      extraNames: ["useRb", "useRbFormData", "useRbSave"]
+    }
+  },
+  "@rainbow-robotics/plugin-ui/sdk": {
+    file: "plugin-ui_sdk",
+    names: ["RbContext", "useRb", "useRbFormData", "useRbSave"]
+  },
+  "@rainbow-robotics/plugin-ui/host-ui": {
+    file: "plugin-ui_host-ui",
+    names: [
+      "alert",
+      "confirm",
+      "getHostServices",
+      "prompt",
+      "setHostServices",
+      "toast"
+    ]
+  },
+  "@rainbow-robotics/plugin-ui/ws": {
+    file: "plugin-ui_ws",
+    names: ["RbWs", "createLazyRbSdk"]
+  }
+};
+function parseExportedValueNames(source) {
+  const names = /* @__PURE__ */ new Set();
+  const blockRe = /export\s+(type\s+)?\{([^}]*)\}/g;
+  let match;
+  while (match = blockRe.exec(source)) {
+    if (match[1]) continue;
+    for (const rawEntry of match[2].split(",")) {
+      const entry = rawEntry.trim();
+      if (!entry || entry.startsWith("type ")) continue;
+      const asMatch = entry.match(/^\S+\s+as\s+(\S+)$/);
+      names.add(asMatch ? asMatch[1] : entry);
+    }
+  }
+  return [...names];
+}
+const nameCache = /* @__PURE__ */ new Map();
+function resolveNames(spec) {
+  const mod = SHARED_MODULES[spec];
+  if (mod.names) return mod.names;
+  if (!mod.parseNamesFrom) {
+    throw new Error(`[plugin-ui] ${spec} has neither "names" nor "parseNamesFrom"`);
+  }
+  if (!nameCache.has(spec)) {
+    const { specifier, extraNames = [] } = mod.parseNamesFrom;
+    const sourcePath = require2.resolve(specifier);
+    const parsed = parseExportedValueNames(readFileSync(sourcePath, "utf8"));
+    nameCache.set(spec, [.../* @__PURE__ */ new Set([...parsed, ...extraNames])]);
+  }
+  return nameCache.get(spec);
+}
+function shimSource(spec) {
+  const mod = SHARED_MODULES[spec];
+  const names = resolveNames(spec);
+  const g = `(globalThis.__RB_SHARED__||{})[${JSON.stringify(spec)}]`;
+  return `const m = ${g};
+if (!m) throw new Error("[plugin-ui] host shared module not registered: ${spec}");
+export const { ${names.join(", ")} } = m;
+` + (mod.hasDefault ? `export default (m.default ?? m);
+` : "");
+}
+const fileToSpec = Object.fromEntries(
+  Object.entries(SHARED_MODULES).map(([spec, { file }]) => [file, spec])
+);
+function importMapScript() {
+  const imports = {};
+  for (const [spec, { file }] of Object.entries(SHARED_MODULES)) {
+    imports[spec] = `${SHARED_BASE}/${file}.js`;
+  }
+  return `<script type="importmap">${JSON.stringify({ imports })}</script>`;
+}
+const pluginSharedRuntimePlugin = () => ({
+  name: "plugin-ui-shared-runtime",
+  transformIndexHtml(html) {
+    return html.replace("</head>", `    ${importMapScript()}
+  </head>`);
+  },
+  configureServer(server) {
+    server.middlewares.use((req, res, next) => {
+      const url = req.url?.split("?")[0];
+      if (!url?.startsWith(`${SHARED_BASE}/`)) return next();
+      const file = url.slice(`${SHARED_BASE}/`.length).replace(/\.js$/, "");
+      const spec = fileToSpec[file];
+      if (!spec) return next();
+      res.setHeader("Content-Type", "text/javascript; charset=utf-8");
+      res.setHeader("Access-Control-Allow-Origin", "*");
+      res.end(shimSource(spec));
+    });
+  },
+  generateBundle() {
+    for (const [spec, { file }] of Object.entries(SHARED_MODULES)) {
+      this.emitFile({
+        type: "asset",
+        fileName: `plugin-shared/${file}.js`,
+        source: shimSource(spec)
+      });
+    }
+  }
+});
+const pluginPreviewRuntimePlugin = () => ({
+  name: "plugin-ui-preview-runtime",
+  apply: (_config, { mode }) => isPluginPreviewMode(mode),
+  transformIndexHtml(html) {
+    return html.replace(
+      "</head>",
+      [
+        "    <script>",
+        "      window.__RB_PLUGIN_PREVIEW_HOST__ = true;",
+        "      window.__RB_ASSETS_BASE_URL__ = window.location.origin;",
+        "    </script>",
+        "  </head>"
+      ].join("\n")
+    );
+  }
+});
+const pluginPreviewAssetsPlugin = (opts) => {
+  const { assetsDir, prefixes = defaultPreviewAssetPrefixes } = opts;
+  return {
+    name: "plugin-ui-preview-assets",
+    apply: (_config, { command, mode }) => command === "serve" && isPluginPreviewMode(mode),
+    configureServer(server) {
+      server.middlewares.use((req, res, next) => {
+        const url = req.url?.split("?")[0];
+        if (!url || !prefixes.some((prefix) => url.startsWith(prefix)))
+          return next();
+        const decodedUrl = decodeURIComponent(url);
+        const filePath = resolve(assetsDir, `.${decodedUrl}`);
+        if (!filePath.startsWith(assetsDir)) return next();
+        if (!existsSync(filePath) || !statSync(filePath).isFile()) return next();
+        const contentType = contentTypeByExt[extname(filePath)];
+        if (contentType) res.setHeader("Content-Type", contentType);
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        createReadStream(filePath).pipe(res);
+      });
+    }
+  };
+};
+const muscatVitePlugin = (opts) => [
+  pluginSharedRuntimePlugin(),
+  pluginPreviewRuntimePlugin(),
+  pluginPreviewAssetsPlugin({
+    assetsDir: opts.previewAssetsDir,
+    prefixes: opts.previewAssetPrefixes
+  })
+];
+export {
+  contentTypeByExt,
+  defaultPreviewAssetPrefixes,
+  isPluginPreviewMode,
+  muscatVitePlugin,
+  pluginPreviewAssetsPlugin,
+  pluginPreviewRuntimePlugin,
+  pluginSharedRuntimePlugin
+};
+//# sourceMappingURL=viteHost.js.map

package/dist/viteHost.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/viteHost.ts"],
+  "sourcesContent": ["/**\n * Vite plugins for a HOST app previewing locally-developed plugins.\n * Host-agnostic \u2014 paths are parameters.\n *\n *   import {\n *     pluginPreviewRuntimePlugin,\n *     pluginPreviewAssetsPlugin,\n *     isPluginPreviewMode,\n *   } from \"@rainbow-robotics/plugin-ui/vite-host\";\n *\n * A built plugin's bare imports (react, rb-components, plugin-ui/*) resolve via\n * the import map this file injects, to the host's already-loaded instances.\n * See ./host.tsx.\n */\nimport type { Plugin } from \"vite\";\nimport { createReadStream, existsSync, readFileSync, statSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport { extname, resolve } from \"node:path\";\n\nconst require = createRequire(import.meta.url);\n\nexport const defaultPreviewAssetPrefixes = [\n  \"/imgs/\",\n  \"/fonts/\",\n  \"/models/\",\n  \"/sounds/\",\n  \"/data/\",\n];\n\nexport const contentTypeByExt: Record<string, string> = {\n  \".avif\": \"image/avif\",\n  \".css\": \"text/css; charset=utf-8\",\n  \".gif\": \"image/gif\",\n  \".glb\": \"model/gltf-binary\",\n  \".jpeg\": \"image/jpeg\",\n  \".jpg\": \"image/jpeg\",\n  \".js\": \"text/javascript; charset=utf-8\",\n  \".json\": \"application/json; charset=utf-8\",\n  \".mp3\": \"audio/mpeg\",\n  \".png\": \"image/png\",\n  \".svg\": \"image/svg+xml\",\n  \".wasm\": \"application/wasm\",\n  \".webp\": \"image/webp\",\n  \".woff\": \"font/woff\",\n  \".woff2\": \"font/woff2\",\n};\n\nexport const isPluginPreviewMode = (mode: string) => mode === \"plugin-preview\";\n\n/* -------------------------------------------------------------------------- */\n/* Shared-runtime import map (plugins reuse the host's loaded instances)       */\n/* -------------------------------------------------------------------------- */\n\nconst SHARED_BASE = \"/plugin-shared\";\n\n// Each shared specifier \u2192 the named exports its shim re-exports from\n// window.__RB_SHARED__[specifier] (set by the host, e.g. nexus/src/pluginShared).\n//\n// `names`: hardcoded list (small, stable modules).\n// `parseNamesFrom`: parse the export names out of a source file's text \u2014 used\n// for react.tsx, which re-exports the whole rb-components barrel (100+ names).\n// We text-parse rather than import it: the barrel is .ts source, which plain\n// Node can't execute.\nconst SHARED_MODULES: Record<\n  string,\n  {\n    file: string;\n    names?: string[];\n    parseNamesFrom?: { specifier: string; extraNames?: string[] };\n    hasDefault?: boolean;\n  }\n> = {\n  react: {\n    file: \"react\",\n    hasDefault: true,\n    names: [\n      \"Children\", \"Component\", \"Fragment\", \"Profiler\", \"PureComponent\",\n      \"StrictMode\", \"Suspense\", \"cloneElement\", \"createContext\",\n      \"createElement\", \"createRef\", \"forwardRef\", \"isValidElement\", \"lazy\",\n      \"memo\", \"startTransition\", \"useCallback\", \"useContext\", \"useDebugValue\",\n      \"useDeferredValue\", \"useEffect\", \"useId\", \"useImperativeHandle\",\n      \"useInsertionEffect\", \"useLayoutEffect\", \"useMemo\", \"useReducer\",\n      \"useRef\", \"useState\", \"useSyncExternalStore\", \"useTransition\", \"version\",\n    ],\n  },\n  \"react/jsx-runtime\": {\n    file: \"react_jsx-runtime\",\n    names: [\"Fragment\", \"jsx\", \"jsxs\"],\n  },\n  \"react/jsx-dev-runtime\": {\n    file: \"react_jsx-dev-runtime\",\n    names: [\"Fragment\", \"jsxDEV\"],\n  },\n  \"react-dom\": {\n    file: \"react-dom\",\n    hasDefault: true,\n    names: [\n      \"__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED\",\n      \"createPortal\",\n      \"createRoot\",\n      \"findDOMNode\",\n      \"flushSync\",\n      \"hydrate\",\n      \"hydrateRoot\",\n      \"render\",\n      \"unmountComponentAtNode\",\n      \"unstable_batchedUpdates\",\n      \"unstable_renderSubtreeIntoContainer\",\n      \"version\",\n    ],\n  },\n  \"react-dom/client\": {\n    file: \"react-dom_client\",\n    names: [\"createRoot\", \"hydrateRoot\"],\n  },\n  \"@rainbow-robotics/plugin-ui/react\": {\n    file: \"plugin-ui_react\",\n    // react.tsx re-exports the full rb-components barrel (export *) plus the sdk\n    // hooks.\n    parseNamesFrom: {\n      specifier: \"@repo/rb-components/new_components\",\n      extraNames: [\"useRb\", \"useRbFormData\", \"useRbSave\"],\n    },\n  },\n  \"@rainbow-robotics/plugin-ui/sdk\": {\n    file: \"plugin-ui_sdk\",\n    names: [\"RbContext\", \"useRb\", \"useRbFormData\", \"useRbSave\"],\n  },\n  \"@rainbow-robotics/plugin-ui/host-ui\": {\n    file: \"plugin-ui_host-ui\",\n    names: [\n      \"alert\",\n      \"confirm\",\n      \"getHostServices\",\n      \"prompt\",\n      \"setHostServices\",\n      \"toast\",\n    ],\n  },\n  \"@rainbow-robotics/plugin-ui/ws\": {\n    file: \"plugin-ui_ws\",\n    names: [\"RbWs\", \"createLazyRbSdk\"],\n  },\n};\n\n// Parses `export { a, b as c, ... }` value names out of a source file's text\n// (skips `export type { ... }` blocks and individual `type X` entries within\n// a mixed block \u2014 types don't exist as runtime module properties). Static\n// text parsing, not module execution, so it works for .ts source files with\n// no loader and has no ESM-resolution footguns.\nfunction parseExportedValueNames(source: string): string[] {\n  const names = new Set<string>();\n  const blockRe = /export\\s+(type\\s+)?\\{([^}]*)\\}/g;\n  let match: RegExpExecArray | null;\n  while ((match = blockRe.exec(source))) {\n    if (match[1]) continue; // whole `export type { ... }` block\n    for (const rawEntry of match[2].split(\",\")) {\n      const entry = rawEntry.trim();\n      if (!entry || entry.startsWith(\"type \")) continue;\n      const asMatch = entry.match(/^\\S+\\s+as\\s+(\\S+)$/);\n      names.add(asMatch ? asMatch[1] : entry);\n    }\n  }\n  return [...names];\n}\n\nconst nameCache = new Map<string, string[]>();\n\nfunction resolveNames(spec: string): string[] {\n  const mod = SHARED_MODULES[spec];\n  if (mod.names) return mod.names;\n  if (!mod.parseNamesFrom) {\n    throw new Error(`[plugin-ui] ${spec} has neither \"names\" nor \"parseNamesFrom\"`);\n  }\n  if (!nameCache.has(spec)) {\n    const { specifier, extraNames = [] } = mod.parseNamesFrom;\n    const sourcePath = require.resolve(specifier);\n    const parsed = parseExportedValueNames(readFileSync(sourcePath, \"utf8\"));\n    nameCache.set(spec, [...new Set([...parsed, ...extraNames])]);\n  }\n  return nameCache.get(spec)!;\n}\n\nfunction shimSource(spec: string): string {\n  const mod = SHARED_MODULES[spec];\n  const names = resolveNames(spec);\n  const g = `(globalThis.__RB_SHARED__||{})[${JSON.stringify(spec)}]`;\n  return (\n    `const m = ${g};\\n` +\n    `if (!m) throw new Error(\"[plugin-ui] host shared module not registered: ${spec}\");\\n` +\n    `export const { ${names.join(\", \")} } = m;\\n` +\n    (mod.hasDefault ? `export default (m.default ?? m);\\n` : \"\")\n  );\n}\n\nconst fileToSpec = Object.fromEntries(\n  Object.entries(SHARED_MODULES).map(([spec, { file }]) => [file, spec]),\n);\n\nfunction importMapScript(): string {\n  const imports: Record<string, string> = {};\n  for (const [spec, { file }] of Object.entries(SHARED_MODULES)) {\n    imports[spec] = `${SHARED_BASE}/${file}.js`;\n  }\n  return `<script type=\"importmap\">${JSON.stringify({ imports })}</script>`;\n}\n\n/**\n * Serves the shared-runtime shim modules at /plugin-shared/*.js and injects the\n * import map so a dynamically-imported plugin's bare `import \"react\"` /\n * `import \"@rainbow-robotics/plugin-ui/react\"` etc. resolve to the host's OWN\n * instances (via window.__RB_SHARED__). Applied in all modes \u2014 any nexus build\n * that can host plugins needs it.\n */\nexport const pluginSharedRuntimePlugin = (): Plugin => ({\n  name: \"plugin-ui-shared-runtime\",\n  transformIndexHtml(html) {\n    return html.replace(\"</head>\", `    ${importMapScript()}\\n  </head>`);\n  },\n  configureServer(server) {\n    server.middlewares.use((req, res, next) => {\n      const url = req.url?.split(\"?\")[0];\n      if (!url?.startsWith(`${SHARED_BASE}/`)) return next();\n      const file = url.slice(`${SHARED_BASE}/`.length).replace(/\\.js$/, \"\");\n      const spec = fileToSpec[file];\n      if (!spec) return next();\n      res.setHeader(\"Content-Type\", \"text/javascript; charset=utf-8\");\n      res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n      res.end(shimSource(spec));\n    });\n  },\n  generateBundle() {\n    for (const [spec, { file }] of Object.entries(SHARED_MODULES)) {\n      this.emitFile({\n        type: \"asset\",\n        fileName: `plugin-shared/${file}.js`,\n        source: shimSource(spec),\n      });\n    }\n  },\n});\n\n/** Inject the preview-host runtime flags into index.html (plugin-preview only). */\nexport const pluginPreviewRuntimePlugin = (): Plugin => ({\n  name: \"plugin-ui-preview-runtime\",\n  apply: (_config, { mode }) => isPluginPreviewMode(mode),\n  transformIndexHtml(html) {\n    return html.replace(\n      \"</head>\",\n      [\n        \"    <script>\",\n        \"      window.__RB_PLUGIN_PREVIEW_HOST__ = true;\",\n        \"      window.__RB_ASSETS_BASE_URL__ = window.location.origin;\",\n        \"    </script>\",\n        \"  </head>\",\n      ].join(\"\\n\"),\n    );\n  },\n});\n\n/** Serve the host's static assets (imgs/fonts/...) in plugin-preview dev mode. */\nexport const pluginPreviewAssetsPlugin = (opts: {\n  assetsDir: string;\n  prefixes?: string[];\n}): Plugin => {\n  const { assetsDir, prefixes = defaultPreviewAssetPrefixes } = opts;\n  return {\n    name: \"plugin-ui-preview-assets\",\n    apply: (_config, { command, mode }) =>\n      command === \"serve\" && isPluginPreviewMode(mode),\n    configureServer(server) {\n      server.middlewares.use((req, res, next) => {\n        const url = req.url?.split(\"?\")[0];\n        if (!url || !prefixes.some((prefix) => url.startsWith(prefix)))\n          return next();\n\n        const decodedUrl = decodeURIComponent(url);\n        const filePath = resolve(assetsDir, `.${decodedUrl}`);\n        if (!filePath.startsWith(assetsDir)) return next();\n        if (!existsSync(filePath) || !statSync(filePath).isFile()) return next();\n\n        const contentType = contentTypeByExt[extname(filePath)];\n        if (contentType) res.setHeader(\"Content-Type\", contentType);\n        res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n        createReadStream(filePath).pipe(res);\n      });\n    },\n  };\n};\n\n/**\n * All host-side plugin-ui Vite plugins in one call. Each self-gates by mode, so\n * a host just spreads this into its `plugins` array.\n *\n *   plugins: [muscatVitePlugin({ previewAssetsDir: resolve(here, \"../assets/public\") })]\n */\nexport const muscatVitePlugin = (opts: {\n  /** Host static assets dir served in plugin-preview dev mode. */\n  previewAssetsDir: string;\n  /** Override preview asset URL prefixes. */\n  previewAssetPrefixes?: string[];\n}): Plugin[] => [\n  pluginSharedRuntimePlugin(),\n  pluginPreviewRuntimePlugin(),\n  pluginPreviewAssetsPlugin({\n    assetsDir: opts.previewAssetsDir,\n    prefixes: opts.previewAssetPrefixes,\n  }),\n];\n"],
+  "mappings": "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",
+  "names": ["require"]
+}

package/dist/ws.d.ts

@@ -1,3 +1,4 @@
+import type { PluginUIServices } from "./host-ui";
 export interface WsHandle {
     undeclare(): void;
 }
@@ -17,4 +18,56 @@ export declare class RbWs {
     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