@rainbow-robotics/muscat-plugin-kit 0.1.2-dev.7 → 0.1.2-dev.8

package/cli/bin/muscat-pk.mjs

@@ -10,6 +10,7 @@ import { runDev } from "../src/dev.mjs";
 import { runUpdate } from "../src/update.mjs";
 import { runSdk } from "../src/sdk.mjs";
 import { runType } from "../src/type.mjs";
+import { runPreview } from "../src/preview.mjs";
 
 const [, , cmd, ...args] = process.argv;
 
@@ -25,6 +26,7 @@ Commands:
   dev              Run dev:ui and dev:back together
   dev:ui           Preview the plugin in a mini-Muscat (preview-host)
   dev:back         Run the plugin back end (python: watchfiles reload / ros2: Docker)
+  preview          Preview against a real Muscat server (prompts for robot IP)
   update           Update @rainbow-robotics/muscat-plugin-kit and @rainbow-robotics/plugin-ui
   sdk <list|update [version]>   Manage the python rainbow-rb-sdk version
 
@@ -47,6 +49,8 @@ async function main() {
         return await runDevUi(args);
       case "dev:back":
         return await runDevBack(args);
+      case "preview":
+        return await runPreview(args);
       case "update":
         return await runUpdate(args);
       case "sdk":

package/cli/src/devUi.mjs

@@ -81,4 +81,4 @@ export async function runDevUi(args = []) {
   child.on("exit", (code) => process.exit(code ?? 0));
 }
 
-export { findPluginRoot };
+export { findPluginRoot, findPreviewHostRoot };

package/cli/src/preview.mjs

@@ -0,0 +1,91 @@
+// muscat-pk preview — build the plugin and open preview-host connected to a
+// real Muscat server (robot or local). No local Socket.IO server is started.
+import { createInterface } from "node:readline";
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { buildPlugin } from "./build.mjs";
+import { findPreviewHostRoot } from "./devUi.mjs";
+import { checkKitUpdate, log, parseArgs } from "./util.mjs";
+
+function prompt(question, defaultValue) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((res) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      res(answer.trim() || defaultValue);
+    });
+  });
+}
+
+export async function runPreview(args = []) {
+  const opts = parseArgs(args, { booleans: ["help"] });
+
+  if (opts.help) {
+    console.log(
+      [
+        "",
+        "Usage: muscat-pk preview [options]",
+        "",
+        "  빌드된 플러그인을 실제 Muscat 서버에 연결해 미리봅니다.",
+        "  Socket.IO 서버를 직접 띄우지 않습니다.",
+        "",
+        "Options:",
+        "  --host <ip>    Muscat 서버 IP 또는 hostname (default: localhost)",
+        "  --port <n>     preview-host 로컬 포트 (default: 4180)",
+        "  --ws-port <n>  Muscat Socket.IO 포트 (default: 10000)",
+        "",
+      ].join("\n"),
+    );
+    return;
+  }
+
+  await checkKitUpdate();
+
+  // ── 로봇 IP 결정 ────────────────────────────────────────────────────────────
+  let robotHost = opts.host ?? "";
+  if (!robotHost) {
+    robotHost = await prompt(
+      "Muscat 서버 IP 또는 hostname [localhost]: ",
+      "localhost",
+    );
+  }
+  const wsPort = opts["ws-port"] ?? "10000";
+  const socketUrl = `ws://${robotHost}:${wsPort}`;
+
+  const previewPort = opts.port ?? "4180";
+
+  log.step(`Muscat 서버: ${socketUrl}`);
+
+  // ── 플러그인 빌드 ────────────────────────────────────────────────────────────
+  const { distDir } = await buildPlugin();
+
+  // ── preview-host 실행 ────────────────────────────────────────────────────────
+  const previewRoot = findPreviewHostRoot();
+  const serveEntry = resolve(previewRoot, "serve.mjs");
+
+  if (!existsSync(resolve(previewRoot, "dist", "index.html"))) {
+    log.step("preview-host 번들 빌드 중 (최초 1회)…");
+    await new Promise((res, rej) => {
+      const p = spawn(process.execPath, [resolve(previewRoot, "build.mjs")], {
+        stdio: "inherit",
+      });
+      p.on("exit", (c) => (c === 0 ? res() : rej(new Error("preview-host build failed"))));
+    });
+  }
+
+  log.step(`preview-host 시작 → http://localhost:${previewPort}`);
+  log.step(`Socket.IO URL: ${socketUrl}`);
+
+  const child = spawn(
+    process.execPath,
+    [
+      serveEntry,
+      "--plugin", distDir,
+      "--port", String(previewPort),
+      "--socket-url", socketUrl,
+    ],
+    { stdio: "inherit" },
+  );
+  child.on("exit", (code) => process.exit(code ?? 0));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rainbow-robotics/muscat-plugin-kit",
-  "version": "0.1.2-dev.7",
+  "version": "0.1.2-dev.8",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -31,7 +31,7 @@
     "@types/react-dom": "^19.0.4"
   },
   "dependencies": {
-    "@rainbow-robotics/preview-host": "0.1.2-dev.7",
+    "@rainbow-robotics/preview-host": "0.1.2-dev.8",
     "esbuild": "^0.25.0"
   },
   "optionalDependencies": {