zdashboard 2.13.0 → 2.15.0

package/dist/cli.js

@@ -1,15 +1,15 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import path9 from "path";
-import fs9 from "fs";
+import path7 from "path";
+import fs8 from "fs";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { access, readdir } from "fs/promises";
 
 // package.json
 var package_default = {
   name: "zdashboard",
-  version: "2.13.0",
+  version: "2.15.0",
   description: "ZCode skill dashboard platform \u2014 pluggable viewers for zdesign/zview/zreview/zgoal",
   type: "module",
   bin: {
@@ -423,6 +423,7 @@ var ServerService = class extends Service {
   page;
   det;
   dataDir;
+  host;
   routes = /* @__PURE__ */ new Map();
   sses = /* @__PURE__ */ new Map();
   prefixStatic = /* @__PURE__ */ new Map();
@@ -437,6 +438,7 @@ var ServerService = class extends Service {
     this.page = config.page;
     this.det = config.detect;
     this.dataDir = config.dataDir;
+    this.host = config.host ?? "127.0.0.1";
     this.onListen = config.onListen;
     ctx.effect(() => () => this.dispose());
     this.refreshGitInfo();
@@ -482,13 +484,13 @@ var ServerService = class extends Service {
     });
     this.start(config.port);
   }
-  route(path10, handler) {
-    this.routes.set(path10, handler);
-    this.ctx.effect(() => () => this.routes.delete(path10));
+  route(path8, handler) {
+    this.routes.set(path8, handler);
+    this.ctx.effect(() => () => this.routes.delete(path8));
   }
-  sse(path10, onConnect) {
-    this.sses.set(path10, onConnect);
-    this.ctx.effect(() => () => this.sses.delete(path10));
+  sse(path8, onConnect) {
+    this.sses.set(path8, onConnect);
+    this.ctx.effect(() => () => this.sses.delete(path8));
   }
   static(prefix, dir) {
     this.prefixStatic.set(prefix, dir);
@@ -657,15 +659,17 @@ var ServerService = class extends Service {
         this.start(port + 1);
       } else throw err;
     });
-    this.server.listen(port, "127.0.0.1", () => {
+    this.server.listen(port, this.host, () => {
       const addr = this.server?.address();
       const bound = typeof addr === "object" && addr ? addr.port : port;
+      const loopback = this.host === "127.0.0.1" || this.host === "localhost" || this.host === "::1";
       const u = `http://localhost:${bound}`;
       const target = this.page ? `${u}#${this.page}` : u;
       console.log(`[zdashboard] v${VERSION} dashboard -> ${u}`);
       console.log(`[zdashboard] project   -> ${this.root}`);
       console.log(`[zdashboard] detect    -> openspec:${this.det.hasOpenspec} docs:${this.det.hasDocs} just:${this.det.hasJust}`);
       if (this.dataDir) console.log(`[zdashboard] data      -> ${this.dataDir}`);
+      if (!loopback) console.log(`[zdashboard] host      -> ${this.host}(\u975E\u56DE\u73AF\u76D1\u542C:\u5C40\u57DF\u7F51/Tailscale \u53EF\u8BBF\u95EE;\u65E0\u9274\u6743,\u6CE8\u610F\u7F51\u7EDC\u8FB9\u754C)`);
       if (this.open) openUrl(target);
       this.onListen?.(bound);
     });
@@ -1361,18 +1365,18 @@ function definePlugin(def) {
           );
           return { ...defaults, ...stored };
         },
-        route(path10, handler) {
-          ctx.server.route(path10, respondWith(handler));
+        route(path8, handler) {
+          ctx.server.route(path8, respondWith(handler));
         },
-        guardedRoute(path10, handler) {
+        guardedRoute(path8, handler) {
           const token = () => ctx.server.stopToken;
-          ctx.server.route(path10, (req, res) => {
+          ctx.server.route(path8, (req, res) => {
             if (!guarded(req, res, token())) return;
             void respondWith(handler)(req, res);
           });
         },
-        sse(path10, handler) {
-          ctx.server.sse(path10, handler);
+        sse(path8, handler) {
+          ctx.server.sse(path8, handler);
         },
         static(prefix, dir) {
           ctx.server.static(prefix, dir);
@@ -1495,102 +1499,22 @@ var apply3 = defineBuiltin({
   }
 });
 
-// src/plugins/design/index.ts
-import path7 from "path";
-import fs7 from "fs";
-
-// src/server/design-assets.ts
-import path6 from "path";
-var PAGE_EXTS = [".html", ".htm"];
-var ICON_EXTS = [".svg", ".png", ".ico", ".jpg", ".jpeg", ".gif", ".webp"];
-var VIDEO_EXTS = [".mp4", ".webm", ".mov", ".ogg", ".ogv"];
-var AUDIO_EXTS = [".mp3", ".wav", ".flac", ".aac", ".m4a"];
-var CODE_EXTS = [".js", ".mjs", ".cjs", ".mts", ".cts", ".ts", ".tsx", ".jsx", ".css", ".json", ".txt", ".xml", ".yml", ".yaml", ".sh", ".md"];
-var FONT_EXTS = [".woff", ".woff2", ".ttf", ".otf"];
-var TOKEN_RE = /token|theme|design|color|palette|typograph/i;
-function categorize(rel, ext) {
-  if (rel.indexOf("components/") === 0) return "component";
-  if (VIDEO_EXTS.includes(ext)) return "video";
-  if (AUDIO_EXTS.includes(ext)) return "audio";
-  if (ext === ".pdf") return "pdf";
-  if (ext === ".md") return "md";
-  if (ext === ".excalidraw" || ext === ".drawio") return "diagram";
-  if (FONT_EXTS.includes(ext)) return "font";
-  if (ICON_EXTS.includes(ext)) return "icon";
-  if (PAGE_EXTS.includes(ext)) return "page";
-  if (CODE_EXTS.includes(ext)) {
-    if (TOKEN_RE.test(rel) && (ext === ".css" || ext === ".json")) return "token";
-    return null;
-  }
-  return null;
-}
-function scanAssets(root, subDir = "") {
-  const out = {};
-  const keys = ["page", "component", "icon", "token", "md", "video", "audio", "pdf", "font", "diagram"];
-  for (const k of keys) out[k] = [];
-  const SKIP = /* @__PURE__ */ new Set(["node_modules", ".git", "dist", "build", "coverage", ".next", ".cache"]);
-  const scanRoot = subDir ? path6.join(root, subDir) : root;
-  walkDir(scanRoot, { skip: SKIP, onFile: (abs, rel) => {
-    const ext = path6.extname(abs).toLowerCase();
-    const t = categorize(rel, ext);
-    if (t) out[t].push({ path: rel, name: path6.basename(abs), ext, type: t });
-  } });
-  return out;
-}
-
 // src/plugins/design/manifest.ts
 var manifest2 = {
   mode: "design",
   label: "\u8BBE\u8BA1\u8D44\u4EA7",
   icon: "\u{1F3A8}",
-  description: "\u8BBE\u8BA1\u8D44\u4EA7\u5206\u7C7B\u6D4F\u89C8 \xB7 zdesign",
+  description: "\u8BBE\u8BA1\u76EE\u5F55\u6D4F\u89C8 \xB7 prototypes/design",
   order: 30
 };
 
 // src/plugins/design/index.ts
-var ASSET_KEYS = ["page", "component", "icon", "token", "md", "video", "audio", "pdf", "font", "diagram"];
-function emptyScan() {
-  const out = {};
-  for (const k of ASSET_KEYS) out[k] = [];
-  return out;
-}
+var SCAN_DIRS = ["prototypes", "design"];
 var apply4 = defineBuiltin({
   manifest: manifest2,
   setup(ctx, root) {
     ctx.route("/__design/assets", async () => {
-      const designRoot = path7.join(root, ".zdev", "design");
-      return fs7.existsSync(designRoot) ? scanAssets(designRoot) : emptyScan();
-    });
-    ctx.route("/__design/asset", async (req, res) => {
-      const rel = new URL(req.url || "/", "http://localhost").searchParams.get("path") ?? "";
-      if (!rel || rel.includes("..") || rel.includes("\\") || path7.isAbsolute(rel)) {
-        res.writeHead(400);
-        res.end("bad path");
-        return;
-      }
-      const designRoot = path7.join(root, ".zdev", "design");
-      const filePath = path7.join(designRoot, rel);
-      if (!filePath.startsWith(designRoot + path7.sep)) {
-        res.writeHead(400);
-        res.end("bad path");
-        return;
-      }
-      fs7.stat(filePath, (err) => {
-        if (err) {
-          res.writeHead(404);
-          return res.end("Not found");
-        }
-        const ct = MIME[path7.extname(filePath).toLowerCase()] ?? "application/octet-stream";
-        res.writeHead(200, { "Content-Type": ct, "Cache-Control": "no-cache" });
-        const stream = fs7.createReadStream(filePath);
-        stream.on("error", () => {
-          try {
-            res.destroy();
-          } catch {
-          }
-        });
-        stream.pipe(res);
-      });
+      return { tree: scanTree(root, [...SCAN_DIRS], { defaultExpandDepth: 2 }) };
     });
   }
 });
@@ -1612,8 +1536,8 @@ var apply5 = defineBuiltin({
 });
 
 // src/plugins/stats/index.ts
-import fs8 from "fs";
-import path8 from "path";
+import fs7 from "fs";
+import path6 from "path";
 import { execFile as execFile7 } from "child_process";
 
 // src/plugins/stats/manifest.ts
@@ -1634,14 +1558,14 @@ function execFilePromise(file, args, opts) {
 }
 function scan(root) {
   const stats = {
-    root: path8.basename(root),
+    root: path6.basename(root),
     files: 0,
     dirs: 0,
     totalSize: 0,
     byExt: [],
     markdown: 0,
     openspec: { active: 0, archived: 0 },
-    hasJust: fs8.existsSync(path8.join(root, "justfile")),
+    hasJust: fs7.existsSync(path6.join(root, "justfile")),
     worktrees: 0
   };
   const extMap = /* @__PURE__ */ new Map();
@@ -1651,22 +1575,22 @@ function scan(root) {
     }, onFile: (abs) => {
       stats.files++;
       try {
-        stats.totalSize += fs8.statSync(abs).size;
+        stats.totalSize += fs7.statSync(abs).size;
       } catch {
       }
-      const ext = path8.extname(abs).toLowerCase() || "(\u65E0\u6269\u5C55\u540D)";
+      const ext = path6.extname(abs).toLowerCase() || "(\u65E0\u6269\u5C55\u540D)";
       extMap.set(ext, (extMap.get(ext) ?? 0) + 1);
       if (ext === ".md" || ext === ".markdown") stats.markdown++;
     } });
   };
   walk(root);
-  const changesDir = path8.join(root, "openspec", "changes");
-  if (fs8.existsSync(changesDir)) {
-    for (const ent of fs8.readdirSync(changesDir, { withFileTypes: true })) {
+  const changesDir = path6.join(root, "openspec", "changes");
+  if (fs7.existsSync(changesDir)) {
+    for (const ent of fs7.readdirSync(changesDir, { withFileTypes: true })) {
       if (!ent.isDirectory() || ent.name.startsWith(".")) continue;
       if (ent.name === "archive") {
         try {
-          stats.openspec.archived = fs8.readdirSync(path8.join(changesDir, "archive"), { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".")).length;
+          stats.openspec.archived = fs7.readdirSync(path6.join(changesDir, "archive"), { withFileTypes: true }).filter((e) => e.isDirectory() && !e.name.startsWith(".")).length;
         } catch {
         }
       } else stats.openspec.active++;
@@ -1702,7 +1626,7 @@ var apply6 = defineBuiltin({
 });
 
 // src/cli.ts
-var __dirname2 = path9.dirname(fileURLToPath2(import.meta.url));
+var __dirname2 = path7.dirname(fileURLToPath2(import.meta.url));
 var DEFAULT_PORT = 4190;
 function parseArgs() {
   const args = process.argv.slice(2);
@@ -1710,6 +1634,7 @@ function parseArgs() {
     options: {
       dir: { type: "string" },
       port: { type: "string" },
+      host: { type: "string" },
       open: { type: "boolean", default: false },
       page: { type: "string" },
       restart: { type: "boolean", default: false },
@@ -1723,6 +1648,7 @@ function parseArgs() {
     dir: typeof values.dir === "string" ? values.dir : process.cwd(),
     port: typeof values.port === "string" ? Number(values.port) : DEFAULT_PORT,
     portExplicit: args.some((a) => a === "--port" || a.startsWith("--port=")),
+    host: typeof values.host === "string" && values.host.trim() ? values.host.trim() : "127.0.0.1",
     open: !!values.open,
     page: typeof values.page === "string" ? values.page : null,
     restart: !!values.restart,
@@ -1752,7 +1678,7 @@ async function loadExternal(ctx, dir, root) {
       if (!ent.isDirectory()) continue;
       const candidates = tsxLoaded ? ["index.ts", "index.js", "index.mjs"] : ["index.js", "index.mjs"];
       for (const name of candidates) {
-        const p = path9.join(dir, ent.name, name);
+        const p = path7.join(dir, ent.name, name);
         if (await pathExists(p)) {
           try {
             const mod = await import(p);
@@ -1767,8 +1693,8 @@ async function loadExternal(ctx, dir, root) {
               const m = ctx.dashboard.get(ent.name);
               if (m && m.mode === ent.name) {
                 const patch = { external: true };
-                const webDir = path9.join(dir, ent.name, "web");
-                if (await pathExists(path9.join(webDir, "index.html"))) {
+                const webDir = path7.join(dir, ent.name, "web");
+                if (await pathExists(path7.join(webDir, "index.html"))) {
                   ctx.server.static(`${PLUGIN_STATIC_PREFIX}${ent.name}/`, webDir);
                   if (!m.viewerUrl) patch.viewerUrl = `${PLUGIN_STATIC_PREFIX}${ent.name}/`;
                 }
@@ -1787,7 +1713,7 @@ async function loadExternal(ctx, dir, root) {
 }
 async function main() {
   const args = parseArgs();
-  const root = path9.resolve(args.dir);
+  const root = path7.resolve(args.dir);
   const found = await findReusable(root, package_default.version);
   const existing = found?.record ?? null;
   const autoUpgrade = found?.status === "stale-version";
@@ -1809,20 +1735,21 @@ async function main() {
     }
     await stopInstance(oldRecord);
   }
-  const appDir = path9.resolve(__dirname2, "web");
+  const appDir = path7.resolve(__dirname2, "web");
   const BUILTIN_PLUGINS = [apply6, apply3, apply4, apply5];
   if (stripDeadPluginConfig(root, BUILTIN_PLUGINS.map((p) => p.manifest))) {
     console.log("[zdashboard] \u5DF2\u6E05\u7406 dashboard.json \u4E2D\u5185\u7F6E\u63D2\u4EF6\u7684\u8FC7\u65F6\u914D\u7F6E\u952E");
   }
   const startPort = oldRecord && !args.portExplicit ? oldRecord.port : args.port;
-  const zdevDir = path9.join(root, ".zdev");
-  const dataDir = fs9.existsSync(zdevDir) ? ".zdev/" : "";
+  const zdevDir = path7.join(root, ".zdev");
+  const dataDir = fs8.existsSync(zdevDir) ? ".zdev/" : "";
   const det = await detect(root);
   const ctx = new Context();
   ctx.plugin(ServerService, {
     root,
     appDir,
     port: startPort,
+    host: args.host,
     open: args.open,
     detect: det,
     page: args.page,
@@ -1841,7 +1768,7 @@ async function main() {
     }
   }
   if (args.plugins) {
-    await loadExternal(ctx, path9.resolve(args.plugins), root);
+    await loadExternal(ctx, path7.resolve(args.plugins), root);
   }
   const shutdown = () => {
     try {