@rainbow-robotics/plugin-ui 0.1.2-dev.8 → 1.0.0

package/dist/pluginData.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Plugin data seam (host-side). Resolves where each plugin's UI/assets load
+ * from. `muscat-pk dev` sets `window.__RB_PREVIEW_PLUGIN_ID__`; that id routes
+ * to preview-host, everything else to the installed-plugin back end, so both
+ * coexist. The host passes its dialog/toast as `hostServices`, registered via
+ * setHostServices (see ./host-ui).
+ */
+import { type PropsWithChildren } from "react";
+import type { PluginManifest } from "./manifest";
+import { type PluginUIServices } from "@rainbow-robotics/plugin-ui/host-ui";
+/**
+ * Where/how to load a plugin's UI module — no iframe involved, the host
+ * mounts it directly.
+ *
+ * - "dev": the plugin's own Vite dev server (muscat-pk dev). `bootstrapUrl` is
+ *   a plain ESM module exposing `mount(container, rb, hostServices)`; react
+ *   and plugin-ui resolve from that dev server's own module graph, so this
+ *   mount is a fully self-consistent, independently-rooted React tree.
+ * - "esm": a built plugin (`muscat-pk build` / robot runtime), a plain ESM
+ *   module the host dynamically imports. react / rb-components / plugin-ui
+ *   context modules are left external as bare specifiers, resolved by the host
+ *   page's import map to the host's own already-loaded instances — so it mounts
+ *   as a genuine nested React tree with working Context (RbContext, host-ui)
+ *   and no duplicate React instance.
+ */
+export type PluginModuleSource = {
+    kind: "dev";
+    bootstrapUrl: string;
+} | {
+    kind: "esm";
+    entryUrl: string;
+};
+export interface PluginDataSource {
+    /** Preview plugin manifest (only while a dev plugin is being previewed). */
+    usePluginManifest: () => {
+        data: PluginManifest | null;
+        isLoading: boolean;
+    };
+    /** Where/how to load a plugin's UI module for a given UI entry. */
+    getModuleSource: (pluginId: string, ui: string) => PluginModuleSource;
+    /** URL of a plugin asset (e.g. an icon) by its manifest-relative path. */
+    getAssetUrl: (pluginId: string, assetPath: string) => string;
+    /** Socket.IO server URL the plugin connects to. */
+    getSocketUrl: (pluginId: string) => string;
+}
+export declare function usePluginData(): PluginDataSource;
+export interface PluginDataProviderProps {
+    /**
+     * The host's real dialog/toast, registered for plugins to use via
+     * `@rainbow-robotics/plugin-ui/host-ui`. The host builds these ONCE inside
+     * its own React tree (calling its real useDialog) and passes the resulting
+     * plain functions here — safe to call from a plugin's separate React
+     * instance (dev). See ./host-ui.
+     */
+    hostServices: PluginUIServices;
+    /** Socket.IO URL for installed (non-preview) plugins. */
+    wsUrl?: string;
+    /** URL prefix the host serves installed plugins from. */
+    liveBase?: string;
+}
+export declare function PluginDataProvider({ children, hostServices, wsUrl, liveBase, }: PropsWithChildren<PluginDataProviderProps>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=pluginData.d.ts.map

package/dist/pluginData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginData.d.ts","sourceRoot":"","sources":["../src/pluginData.tsx"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,OAAO,EAML,KAAK,iBAAiB,EACvB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,iBAAiB,EAAE,MAAM;QAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7E,mEAAmE;IACnE,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,kBAAkB,CAAC;IACtE,0EAA0E;IAC1E,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7D,mDAAmD;IACnD,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAID,wBAAgB,aAAa,IAAI,gBAAgB,CAMhD;AAgHD,MAAM,WAAW,uBAAuB;IACtC;;;;;;OAMG;IACH,YAAY,EAAE,gBAAgB,CAAC;IAC/B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,YAAY,EACZ,KAA8B,EAC9B,QAAgD,GACjD,EAAE,iBAAiB,CAAC,uBAAuB,CAAC,2CAqC5C"}