@skyvexsoftware/stratos-sdk 0.1.4 → 0.1.6

package/dist/vite/plugin-config.d.ts

@@ -29,13 +29,16 @@ declare const BG_EXTERNALS: string[];
  */
 declare function stratosExternals(): Plugin;
 export type PluginBuildOptions = {
-    pluginDir: string;
+    /** Plugin root directory. Defaults to process.cwd(). */
+    pluginDir?: string;
     ui?: {
         entry: string;
     };
     background?: {
         entry: string;
     };
+    /** Extra Vite config to merge (plugins, css, etc.) */
+    vite?: UserConfig;
 };
 /**
  * Create a Vite config for building a Stratos plugin.

package/dist/vite/plugin-config.js

@@ -17,7 +17,6 @@
  */
 import * as fs from "fs";
 import * as path from "path";
-import react from "@vitejs/plugin-react";
 import { UI_EXTERNALS } from "./externals.js";
 import { serveExternals } from "./serve-externals.js";
 import { stratosDevServer } from "./stratos-dev-server.js";
@@ -158,27 +157,20 @@ function copyDirSync(src, dest) {
  * - "background"     → builds the background module (Node.js, ESM)
  */
 export function createPluginConfig(options) {
-    const { pluginDir, ui, background } = options;
+    const { pluginDir = process.cwd(), ui, background, vite: extraConfig, } = options;
     const target = process.env.BUILD_TARGET;
     if (target === "background" && background) {
         return createBackgroundConfig(pluginDir, background.entry);
     }
     if (ui) {
-        return createUIConfig(pluginDir, ui.entry);
+        return createUIConfig(pluginDir, ui.entry, extraConfig);
     }
     throw new Error("No build target. Provide a ui entry or set BUILD_TARGET=background.");
 }
-function createUIConfig(pluginDir, entry) {
+function createUIConfig(pluginDir, entry, extraConfig) {
     const isProduction = process.env.NODE_ENV === "production";
     return {
         root: pluginDir,
-        plugins: [
-            { ...react(), apply: "serve" },
-            serveExternals(),
-            stratosDevServer({ pluginDir }),
-            stratosExternals(),
-            copyPluginAssets(pluginDir),
-        ],
         server: {
             cors: {
                 origin: [
@@ -187,6 +179,22 @@ function createUIConfig(pluginDir, entry) {
                     /^http:\/\/localhost:\d+$/,
                 ],
             },
+            hmr: {
+                // When modules are loaded via stratos-dev:// protocol, Vite's HMR
+                // client needs to connect back to THIS dev server's WebSocket directly.
+                // Without this, it would try to derive the WS URL from the custom
+                // protocol scheme, which doesn't work.
+                protocol: "ws",
+                host: "localhost",
+            },
+        },
+        optimizeDeps: {
+            exclude: [
+                ...UI_EXTERNALS,
+                "react/jsx-runtime",
+                "react/jsx-dev-runtime",
+                "react-dom/client",
+            ],
         },
         build: {
             outDir: path.resolve(pluginDir, "dist/ui"),
@@ -206,6 +214,15 @@ function createUIConfig(pluginDir, entry) {
             jsx: "automatic",
             jsxImportSource: "react",
         },
+        // Merge extra config: plugins are concatenated, other keys shallow-merged
+        ...extraConfig,
+        plugins: [
+            serveExternals(),
+            stratosDevServer({ pluginDir }),
+            stratosExternals(),
+            copyPluginAssets(pluginDir),
+            ...(extraConfig?.plugins ?? []),
+        ],
     };
 }
 function createBackgroundConfig(pluginDir, entry) {

package/dist/vite/serve-externals.js

@@ -19,7 +19,7 @@ export function serveExternals() {
     return {
         name: "stratos-serve-externals",
         apply: "serve",
-        enforce: "pre",
+        enforce: "post",
         transform(code, id) {
             // Only process JS/TS source files
             const ext = id.slice(id.lastIndexOf("."));
@@ -69,6 +69,23 @@ export function serveExternals() {
                 // 6. Side-effect imports: import "pkg"
                 result = result.replace(new RegExp(`import\\s+['"]${escaped}['"]\\s*;?`, "g"), `// (stratos-serve-externals: side-effect import of "${modId}" removed)`);
             }
+            // Second pass: catch Vite-resolved paths like
+            //   import { jsxDEV } from "/node_modules/react/jsx-dev-runtime.js?v=..."
+            // These are injected by esbuild's JSX transform after our source-level pass.
+            for (const modId of EXTERNAL_PACKAGES) {
+                // Convert package name to a path pattern: "react/jsx-dev-runtime" -> "react/jsx-dev-runtime"
+                const pathPattern = modId.replace(/\//g, "/");
+                const global = `window.__stratos_modules__[${JSON.stringify(modId)}]`;
+                // Match: import { x } from "/node_modules/{pkg}.js?v=..." or "/{pkg}?..."
+                const resolvedRe = new RegExp(`import\\s*\\{([^}]+)\\}\\s+from\\s+['"][^'"]*/${escapeRegExp(pathPattern)}(?:\\.js)?(?:\\?[^'"]*)?['"]\\s*;?`, "g");
+                result = result.replace(resolvedRe, (_, names) => {
+                    const destructured = names.replace(/([\w$]+)\s+as\s+([\w$]+)/g, "$1: $2");
+                    return `const {${destructured}} = ${global};`;
+                });
+                // Match: import Default from "/node_modules/{pkg}.js?v=..."
+                const resolvedDefaultRe = new RegExp(`import\\s+([\\w$]+)\\s+from\\s+['"][^'"]*/${escapeRegExp(pathPattern)}(?:\\.js)?(?:\\?[^'"]*)?['"]\\s*;?`, "g");
+                result = result.replace(resolvedDefaultRe, (_, def) => `const ${def} = ${global}.default || ${global};`);
+            }
             if (result === code)
                 return null;
             return { code: result, map: null };

package/dist/vite/stratos-dev-server.js

@@ -20,6 +20,9 @@ import { io as ioClient } from "socket.io-client";
  */
 export function stratosDevServer(options) {
     const { pluginDir } = options;
+    // Shared state between configureServer and handleHotUpdate hooks
+    let socket = null;
+    let pluginId = "unknown";
     return {
         name: "stratos-dev-server",
         apply: "serve",
@@ -28,7 +31,6 @@ export function stratosDevServer(options) {
                 (process.env.STRATOS_PORT
                     ? parseInt(process.env.STRATOS_PORT, 10)
                     : 2066);
-            let socket = null;
             let retryTimeout = null;
             let retryDelay = 3000;
             const MAX_RETRY_DELAY = 30000;
@@ -41,7 +43,7 @@ export function stratosDevServer(options) {
             catch {
                 console.error("[stratos-dev-server] Failed to read plugin.json at", manifestPath);
             }
-            const pluginId = manifest.id ?? "unknown";
+            pluginId = manifest.id ?? "unknown";
             function clearRetry() {
                 if (retryTimeout) {
                     clearTimeout(retryTimeout);
@@ -186,6 +188,19 @@ export function stratosDevServer(options) {
                 connect();
             });
         },
+        // Notify Stratos when UI source files change so it can reload the plugin
+        handleHotUpdate({ file }) {
+            // Only signal for UI source changes (not background, not config files)
+            if (file.includes("/src/") && !file.includes("/src/background/")) {
+                if (socket?.connected) {
+                    console.log(`[stratos-dev-server] UI source changed: ${path.basename(file)}`);
+                    socket.emit("dev:plugin-ui-updated", {
+                        pluginId,
+                        timestamp: Date.now(),
+                    });
+                }
+            }
+        },
     };
 }
 //# sourceMappingURL=stratos-dev-server.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyvexsoftware/stratos-sdk",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Plugin SDK for Stratos — types, hooks, and UI components",
   "author": {
     "name": "Skyvex Software",