@hangox/mg-cli 1.0.2 → 1.0.5

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ServerInfo } from './index-DNrszrq9.js';
-export { A as AllPagesInfo, B as BaseMessage, C as CONFIG_DIR, x as CliOptions, u as ConnectionInfo, K as ConnectionManager, i as ConnectionType, D as DEFAULT_PORT, E as ErrorCode, q as ErrorInfo, l as ErrorMessages, k as ErrorNames, w as ExportImageParams, v as GetAllNodesParams, G as GetNodeParams, H as HEARTBEAT_INTERVAL, e as HEARTBEAT_TIMEOUT, L as LOG_DIR, W as LogLevel, U as Logger, X as LoggerOptions, M as MAX_PORT_ATTEMPTS, h as MAX_RETRY_COUNT, m as MGError, F as MGServer, Q as ManagedWebSocket, j as MessageType, z as MgPageInfo, N as NodeInfo, O as OutputFormatter, a as PORT_RANGE_END, P as PORT_RANGE_START, b as PORT_SCAN_TIMEOUT, s as PingMessage, t as PongMessage, R as REQUEST_TIMEOUT, g as RETRY_INTERVALS, y as RGBA, r as RegisterMessage, T as RequestHandler, o as RequestMessage, p as ResponseMessage, c as SERVER_INFO_FILE, d as SERVER_LOG_FILE, f as SERVER_START_TIMEOUT, J as ServerOptions, n as createError, V as createLogger, I as createServer } from './index-DNrszrq9.js';
+import { S as ServerInfo, N as NodeInfo, a as SpaceNodeInfo } from './index--AigFaD9.js';
+export { F as AllPagesInfo, B as BaseMessage, C as CONFIG_DIR, y as CliOptions, I as ConnectedPageInfo, v as ConnectionInfo, U as ConnectionManager, j as ConnectionType, D as DEFAULT_PORT, E as ErrorCode, r as ErrorInfo, m as ErrorMessages, l as ErrorNames, x as ExportImageParams, w as GetAllNodesParams, G as GetNodeParams, H as HEARTBEAT_INTERVAL, f as HEARTBEAT_TIMEOUT, L as LOG_DIR, Z as LogLevel, X as Logger, _ as LoggerOptions, M as MAX_PORT_ATTEMPTS, i as MAX_RETRY_COUNT, n as MGError, K as MGServer, V as ManagedWebSocket, k as MessageType, A as MgPageInfo, O as OutputFormatter, b as PORT_RANGE_END, P as PORT_RANGE_START, c as PORT_SCAN_TIMEOUT, t as PingMessage, u as PongMessage, R as REQUEST_TIMEOUT, h as RETRY_INTERVALS, z as RGBA, s as RegisterMessage, W as RequestHandler, p as RequestMessage, q as ResponseMessage, d as SERVER_INFO_FILE, e as SERVER_LOG_FILE, g as SERVER_START_TIMEOUT, T as ServerOptions, J as ServerStatusResponse, o as createError, Y as createLogger, Q as createServer } from './index--AigFaD9.js';
 import 'ws';
 
 /**
@@ -125,5 +125,32 @@ declare function extractFileIdFromMgpLink(link: string): string | null;
  * @returns fileId 或 null
  */
 declare function extractFileId(input: string): string | null;
+/**
+ * 四舍五入到一位小数
+ * 25.666667938232422 -> 25.7
+ */
+declare function roundToOneDecimal(value: number): number;
+/**
+ * MasterGo 节点属性默认值
+ * 基于官方文档定义，当值等于默认值时可以省略以减少 JSON 体积
+ */
+declare const NODE_DEFAULTS: Record<string, unknown>;
+/**
+ * 精简节点数据，移除等于默认值的字段
+ * 递归处理 children 数组
+ *
+ * @param node 原始节点数据
+ * @returns 精简后的节点数据
+ */
+declare function trimNodeDefaults<T extends Record<string, unknown>>(node: T): T;
+/**
+ * 提取节点的空间信息
+ * 只保留 id、name、x、y、width、height 和 children 字段
+ * 用于让 AI 以最少的字段理解节点的空间布局关系
+ *
+ * @param node 原始节点数据
+ * @returns 精简的空间节点信息
+ */
+declare function extractSpaceInfo(node: NodeInfo): SpaceNodeInfo;
 
-export { ServerInfo, deleteServerInfo, ensureConfigDir, ensureDir, ensureOutputDir, extractFileId, extractFileIdFromMgpLink, extractFileIdFromUrl, formatDuration, formatFileSize, formatLogTime, generateId, generateMgpLink, getCurrentISOTime, isDesignPageUrl, isProcessRunning, killProcess, normalizePageUrl, parseMgpLink, readServerInfo, resolveOutputPath, writeServerInfo };
+export { NODE_DEFAULTS, NodeInfo, ServerInfo, SpaceNodeInfo, deleteServerInfo, ensureConfigDir, ensureDir, ensureOutputDir, extractFileId, extractFileIdFromMgpLink, extractFileIdFromUrl, extractSpaceInfo, formatDuration, formatFileSize, formatLogTime, generateId, generateMgpLink, getCurrentISOTime, isDesignPageUrl, isProcessRunning, killProcess, normalizePageUrl, parseMgpLink, readServerInfo, resolveOutputPath, roundToOneDecimal, trimNodeDefaults, writeServerInfo };

package/dist/index.js

@@ -32,6 +32,7 @@ var MessageType = /* @__PURE__ */ ((MessageType2) => {
   MessageType2["EXPORT_IMAGE"] = "export_image";
   MessageType2["EXECUTE_CODE"] = "execute_code";
   MessageType2["GET_ALL_PAGES"] = "get_all_pages";
+  MessageType2["GET_SERVER_STATUS"] = "get_server_status";
   MessageType2["RESPONSE"] = "response";
   MessageType2["ERROR"] = "error";
   return MessageType2;
@@ -317,6 +318,152 @@ function extractFileId(input) {
   }
   return extractFileIdFromUrl(trimmed);
 }
+var NUMERIC_FIELDS = [
+  "x",
+  "y",
+  "width",
+  "height",
+  "rotation",
+  "opacity",
+  "cornerRadius",
+  "topLeftRadius",
+  "topRightRadius",
+  "bottomLeftRadius",
+  "bottomRightRadius",
+  "strokeWeight",
+  "strokeTopWeight",
+  "strokeLeftWeight",
+  "strokeBottomWeight",
+  "strokeRightWeight",
+  "paddingTop",
+  "paddingRight",
+  "paddingBottom",
+  "paddingLeft",
+  "itemSpacing",
+  "crossAxisSpacing",
+  "flexGrow"
+];
+function roundToOneDecimal(value) {
+  return Math.round(value * 10) / 10;
+}
+var NODE_DEFAULTS = {
+  // Scene Node 属性
+  visible: true,
+  isVisible: true,
+  isLocked: false,
+  // Blend 属性
+  opacity: 1,
+  blendMode: "NORMAL",
+  isMask: false,
+  isMaskOutline: false,
+  isMaskVisible: false,
+  effectStyleId: "",
+  // Geometry 属性
+  strokeStyle: "SOLID",
+  strokeWeight: 0,
+  strokeTopWeight: 0,
+  strokeLeftWeight: 0,
+  strokeBottomWeight: 0,
+  strokeRightWeight: 0,
+  strokeAlign: "CENTER",
+  strokeCap: "NONE",
+  strokeJoin: "MITER",
+  dashCap: "NONE",
+  fillStyleId: "",
+  strokeStyleId: "",
+  // Corner 属性
+  cornerSmooth: 0,
+  cornerRadius: 0,
+  topLeftRadius: 0,
+  topRightRadius: 0,
+  bottomLeftRadius: 0,
+  bottomRightRadius: 0,
+  // Layout 属性
+  rotation: 0,
+  flexGrow: 0,
+  alignSelf: "INHERIT",
+  layoutPositioning: "AUTO",
+  constrainProportions: false,
+  // 容器专属属性 (FrameNode)
+  flexMode: "NONE",
+  flexWrap: "NO_WRAP",
+  itemSpacing: 0,
+  crossAxisSpacing: 0,
+  paddingTop: 0,
+  paddingRight: 0,
+  paddingBottom: 0,
+  paddingLeft: 0,
+  clipsContent: false,
+  itemReverseZIndex: false,
+  strokesIncludedInLayout: false,
+  // 其他属性
+  componentPropertyReferences: null
+};
+var EMPTY_ARRAY_FIELDS = [
+  "fills",
+  "strokes",
+  "effects",
+  "strokeDashes",
+  "exportSettings",
+  "reactions",
+  "attachedConnectors"
+];
+function isEmptyArray(value) {
+  return Array.isArray(value) && value.length === 0;
+}
+function isEqual(a, b) {
+  if (a === b) return true;
+  if (a === null || b === null) return a === b;
+  if (typeof a !== typeof b) return false;
+  return false;
+}
+function trimNodeDefaults(node) {
+  const result = {};
+  for (const [key, value] of Object.entries(node)) {
+    if (key === "children" && Array.isArray(value)) {
+      const trimmedChildren = value.map(
+        (child) => typeof child === "object" && child !== null ? trimNodeDefaults(child) : child
+      );
+      if (trimmedChildren.length > 0) {
+        result[key] = trimmedChildren;
+      }
+      continue;
+    }
+    if (EMPTY_ARRAY_FIELDS.includes(key) && isEmptyArray(value)) {
+      continue;
+    }
+    if (NUMERIC_FIELDS.includes(key) && typeof value === "number") {
+      const roundedValue = roundToOneDecimal(value);
+      if (key in NODE_DEFAULTS && isEqual(roundedValue, NODE_DEFAULTS[key])) {
+        continue;
+      }
+      result[key] = roundedValue;
+      continue;
+    }
+    if (key in NODE_DEFAULTS) {
+      const defaultValue = NODE_DEFAULTS[key];
+      if (isEqual(value, defaultValue)) {
+        continue;
+      }
+    }
+    result[key] = value;
+  }
+  return result;
+}
+function extractSpaceInfo(node) {
+  const result = {
+    id: node.id,
+    name: node.name,
+    x: roundToOneDecimal(typeof node.x === "number" ? node.x : 0),
+    y: roundToOneDecimal(typeof node.y === "number" ? node.y : 0),
+    width: roundToOneDecimal(typeof node.width === "number" ? node.width : 0),
+    height: roundToOneDecimal(typeof node.height === "number" ? node.height : 0)
+  };
+  if (node.children && Array.isArray(node.children) && node.children.length > 0) {
+    result.children = node.children.map((child) => extractSpaceInfo(child));
+  }
+  return result;
+}
 
 // src/server/websocket-server.ts
 import { WebSocketServer } from "ws";
@@ -687,6 +834,54 @@ var RequestHandler = class {
   }
 };
 
+// src/shared/version.ts
+import { readFileSync as readFileSync2, existsSync as existsSync3 } from "fs";
+import { fileURLToPath } from "url";
+import { dirname as dirname3, join as join2 } from "path";
+var cachedVersion = null;
+function getVersion() {
+  if (cachedVersion !== null) {
+    return cachedVersion;
+  }
+  try {
+    const currentFile = fileURLToPath(import.meta.url);
+    const currentDir = dirname3(currentFile);
+    const versionFilePaths = [
+      join2(currentDir, "..", "VERSION"),
+      // dist/xxx.js -> ../VERSION
+      join2(currentDir, "..", "..", "VERSION")
+      // src/shared/version.ts -> ../../VERSION
+    ];
+    for (const versionFilePath of versionFilePaths) {
+      if (existsSync3(versionFilePath)) {
+        const version = readFileSync2(versionFilePath, "utf-8").trim();
+        if (version) {
+          cachedVersion = version;
+          return cachedVersion;
+        }
+      }
+    }
+    const packageJsonPaths = [
+      join2(currentDir, "..", "package.json"),
+      join2(currentDir, "..", "..", "package.json")
+    ];
+    for (const packageJsonPath of packageJsonPaths) {
+      if (existsSync3(packageJsonPath)) {
+        const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
+        if (packageJson.name === "@hangox/mg-cli") {
+          cachedVersion = packageJson.version || "0.0.0";
+          return cachedVersion;
+        }
+      }
+    }
+    cachedVersion = "0.0.0";
+    return cachedVersion;
+  } catch {
+    cachedVersion = "0.0.0";
+    return cachedVersion;
+  }
+}
+
 // src/server/websocket-server.ts
 var MGServer = class {
   wss = null;
@@ -695,6 +890,7 @@ var MGServer = class {
   requestHandler;
   port;
   isRunning = false;
+  startedAt = null;
   constructor(options = {}) {
     this.port = options.port || DEFAULT_PORT;
     this.logger = options.logger || createLogger();
@@ -714,6 +910,7 @@ var MGServer = class {
       this.wss.on("listening", () => {
         this.port = port;
         this.isRunning = true;
+        this.startedAt = /* @__PURE__ */ new Date();
         this.logger.info(`Server \u542F\u52A8\u6210\u529F\uFF0C\u76D1\u542C\u7AEF\u53E3: ${port}`);
         this.connectionManager.startHeartbeatCheck(HEARTBEAT_INTERVAL);
         resolve2(port);
@@ -814,7 +1011,8 @@ var MGServer = class {
       success: true,
       data: {
         connectionId: managedWs.connectionId,
-        pageUrl
+        pageUrl,
+        serverVersion: getVersion()
       }
     };
     ws.send(JSON.stringify(ack));
@@ -828,6 +1026,9 @@ var MGServer = class {
       case "ping" /* PING */:
         this.handlePing(ws, message);
         break;
+      case "get_server_status" /* GET_SERVER_STATUS */:
+        this.handleGetServerStatus(ws, message);
+        break;
       case "response" /* RESPONSE */:
       case "error" /* ERROR */:
         this.requestHandler.handleResponse(message);
@@ -849,6 +1050,37 @@ var MGServer = class {
     };
     ws.send(JSON.stringify(pong));
   }
+  /**
+   * 处理 Server 状态查询
+   */
+  handleGetServerStatus(ws, message) {
+    const providers = this.connectionManager.getAllProviders();
+    const stats = this.connectionManager.getStats();
+    const connectedPages = providers.map((info) => ({
+      pageUrl: info.pageUrl || "",
+      connectedAt: info.connectedAt.toISOString(),
+      lastActiveAt: info.lastActiveAt.toISOString()
+    }));
+    const uptimeMs = this.startedAt ? Date.now() - this.startedAt.getTime() : 0;
+    const statusData = {
+      running: this.isRunning,
+      port: this.port,
+      pid: process.pid,
+      startedAt: this.startedAt?.toISOString() || "",
+      uptime: formatDuration(uptimeMs),
+      version: getVersion(),
+      stats,
+      connectedPages
+    };
+    const response = {
+      id: message.id || "",
+      type: "response" /* RESPONSE */,
+      success: true,
+      data: statusData
+    };
+    ws.send(JSON.stringify(response));
+    this.logger.info("\u8FD4\u56DE Server \u72B6\u6001\u4FE1\u606F");
+  }
   /**
    * 停止服务器
    */
@@ -913,6 +1145,7 @@ export {
   MGError,
   MGServer,
   MessageType,
+  NODE_DEFAULTS,
   PORT_RANGE_END,
   PORT_RANGE_START,
   PORT_SCAN_TIMEOUT,
@@ -932,6 +1165,7 @@ export {
   extractFileId,
   extractFileIdFromMgpLink,
   extractFileIdFromUrl,
+  extractSpaceInfo,
   formatDuration,
   formatFileSize,
   formatLogTime,
@@ -945,6 +1179,8 @@ export {
   parseMgpLink,
   readServerInfo,
   resolveOutputPath,
+  roundToOneDecimal,
+  trimNodeDefaults,
   writeServerInfo
 };
 //# sourceMappingURL=index.js.map