@hangox/mg-cli 1.3.3 → 1.5.0

package/dist/{index-AVsoGQ0e.d.ts → index-DuCpsEXk.d.ts}

@@ -41,6 +41,9 @@ declare const HEARTBEAT_INTERVAL = 30000;
 declare const HEARTBEAT_TIMEOUT = 90000;
 /** 请求超时（毫秒）- 30 秒 */
 declare const REQUEST_TIMEOUT = 30000;
+/** 请求超时上限（毫秒）- 10 分钟。写操作（如 create_node 大树）可通过
+ * 请求消息的 timeoutMs 字段放宽超时，此常量防止传入过大值长期占用资源 */
+declare const MAX_REQUEST_TIMEOUT = 600000;
 /** Server 启动等待超时（毫秒）- 5 秒 */
 declare const SERVER_START_TIMEOUT = 5000;
 /** CLI 重试间隔（毫秒） */
@@ -63,13 +66,21 @@ declare enum MessageType {
     REGISTER = "register",
     REGISTER_ACK = "register_ack",
     GET_NODE_BY_ID = "get_node_by_id",
+    GET_NODE_CONTEXT = "get_node_context",
     GET_PAGE_BY_ID = "get_page_by_id",
     GET_ALL_NODES = "get_all_nodes",
     GET_SELECTION = "get_selection",
     EXPORT_IMAGE = "export_image",
     EXECUTE_CODE = "execute_code",
+    LIST_FONTS = "list_fonts",
+    LIST_LIBRARY = "list_library",
+    IMPORT_COMPONENT = "import_component",
     GET_ALL_PAGES = "get_all_pages",
     GET_COMMENTS = "get_comments",
+    CREATE_PAGE = "create_page",
+    CREATE_NODE = "create_node",
+    DELETE_NODE = "delete_node",
+    UPDATE_NODE = "update_node",
     LIST_EXTENSIONS = "list_extensions",
     OPEN_PAGE = "open_page",
     NAVIGATE_TO_NODE = "navigate_to_node",
@@ -120,6 +131,10 @@ declare enum ErrorCode {
     CONNECTION_LOST = "E017",
     /** 没有扩展连接到 Server */
     NO_EXTENSION_CONNECTED = "E018",
+    /** 页面只读 / 无编辑权限，无法执行写操作 */
+    EDIT_NOT_ALLOWED = "E019",
+    /** 创建节点整体性失败（根节点都建不出来） */
+    CREATE_NODE_FAILED = "E020",
     /** 未知错误 */
     UNKNOWN_ERROR = "E099"
 }
@@ -181,6 +196,11 @@ interface RequestMessage extends BaseMessage {
     pageUrl?: string;
     /** 请求参数 */
     params?: Record<string, unknown>;
+    /**
+     * 请求超时（毫秒）。Server 转发时以此为准（上限 MAX_REQUEST_TIMEOUT），
+     * 缺省使用 REQUEST_TIMEOUT。用于 create_node 等大树写操作放宽超时
+     */
+    timeoutMs?: number;
 }
 /** 响应消息 */
 interface ResponseMessage extends BaseMessage {
@@ -399,6 +419,180 @@ interface NodeInfo {
     /** 其他属性（根据节点类型不同而不同） */
     [key: string]: unknown;
 }
+/** MasterGo 可用字体条目 */
+interface AvailableFontInfo {
+    fontName: {
+        family: string;
+        style: string;
+    };
+    localizedFontName?: {
+        family: string;
+        style: string;
+    };
+    dataStyle?: number;
+    referrer?: string;
+    [key: string]: unknown;
+}
+/** LIST_FONTS 请求参数 */
+interface ListFontsParams {
+    /** 按字体 family/style/localized 名称做大小写不敏感过滤 */
+    filter?: string;
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** LIST_FONTS 响应数据 */
+interface ListFontsResult {
+    fonts: AvailableFontInfo[];
+    total: number;
+    filter?: string;
+}
+/** LIST_LIBRARY 请求参数 */
+interface ListLibraryParams {
+    /** 按库名/组件名做大小写不敏感过滤 */
+    filter?: string;
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** 团队库组件/组件集信息 */
+interface LibraryComponentInfo {
+    id: string;
+    name: string;
+    ukey: string;
+    description?: string;
+    type: 'COMPONENT' | 'COMPONENT_SET';
+    cover?: string;
+    width?: number;
+    height?: number;
+    componentSetUkey?: string;
+    libraryId: string;
+    libraryName: string;
+}
+/** 单个团队库信息 */
+interface LibraryInfo {
+    id: string;
+    name: string;
+    components: LibraryComponentInfo[];
+    componentCount: number;
+    styleCounts: Record<string, number>;
+}
+/** LIST_LIBRARY 响应数据 */
+interface ListLibraryResult {
+    libraries: LibraryInfo[];
+    totalLibraries: number;
+    totalComponents: number;
+    filter?: string;
+}
+/** IMPORT_COMPONENT 请求参数：ukey/ukeySet 二选一；placeInstance=true 时会额外摆放一个可见 INSTANCE */
+interface ImportComponentParams {
+    ukey?: string;
+    ukeySet?: string;
+    /** 是否在导入组件定义后立即创建并摆放一个 INSTANCE */
+    placeInstance?: boolean;
+    /** INSTANCE 目标父节点 ID，缺省 = 当前页面 */
+    parentId?: string;
+    /** INSTANCE 放置位置 X */
+    x?: number;
+    /** INSTANCE 放置位置 Y */
+    y?: number;
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** 已摆放的实例信息 */
+interface PlacedInstanceInfo {
+    id: string;
+    nodeId: string;
+    name: string;
+    type: 'INSTANCE';
+    parentId?: string;
+    x?: number;
+    y?: number;
+}
+/** IMPORT_COMPONENT 响应数据 */
+interface ImportComponentResult {
+    /** 导入到当前文件的组件/组件集定义 ID（不是画布实例） */
+    id: string;
+    nodeId: string;
+    name: string;
+    type: 'COMPONENT' | 'COMPONENT_SET';
+    ukey: string;
+    /** placeInstance=true 时返回实际摆到画布上的 INSTANCE */
+    instance?: PlacedInstanceInfo;
+    instanceId?: string;
+}
+/** 创建节点 warning 分类 */
+type CreateNodeWarningKind = 
+/** 类型不支持，降级为 FRAME 占位 */
+'UNSUPPORTED_TYPE_DOWNGRADED'
+/** 属性 setter 抛异常 */
+ | 'PROPERTY_SET_FAILED'
+/** 明知不支持主动跳过（如 IMAGE fill 资源） */
+ | 'PROPERTY_SKIPPED'
+/** 字体加载失败用了回退字体 */
+ | 'FONT_FALLBACK';
+/** 创建节点过程中的单条 warning */
+interface CreateNodeWarning {
+    /** 出问题的源节点 */
+    sourceNodeId: string;
+    kind: CreateNodeWarningKind;
+    /** 相关属性名 */
+    property?: string;
+    message: string;
+}
+/** CREATE_NODE 请求参数 */
+interface CreateNodeParams {
+    /**
+     * 节点 JSON。整树模式：get_node_by_id --raw 导出的全树（含 children）；
+     * 逐节点模式：单节点（无 children 的退化树），字段与 NodeInfo 同名（读写对称）
+     */
+    node: NodeInfo;
+    /** 目标父节点 ID，缺省 = 当前页面 (mg.document.currentPage) */
+    parentId?: string;
+    /** 覆盖根节点放置位置（缺省用 node.x / node.y） */
+    x?: number;
+    y?: number;
+    /**
+     * 仅 type=GROUP 的逐节点模式：把已存在的节点成组（mg.group）。
+     * 与 node.children 互斥——childIds 引用已建好的节点，children 是待递归创建的数据
+     */
+    childIds?: string[];
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** CREATE_NODE 响应数据 */
+interface CreateNodeResult {
+    /** 新建根节点 ID */
+    nodeId: string;
+    /** 源节点 ID → 新建节点 ID（全树） */
+    idMap: Record<string, string>;
+    warnings: CreateNodeWarning[];
+}
+/** DELETE_NODE 请求参数 */
+interface DeleteNodeParams {
+    nodeId: string;
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** DELETE_NODE 响应数据 */
+interface DeleteNodeResult {
+    deleted: true;
+}
+/** UPDATE_NODE 请求参数 */
+interface UpdateNodeParams {
+    /** 要更新的节点 ID */
+    nodeId: string;
+    /**
+     * 要设置的属性（字段与 NodeInfo 同名，读写对称）。
+     * 语义：仅设置给出的字段，未给出的字段不动
+     */
+    props: Partial<NodeInfo>;
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** UPDATE_NODE 响应数据 */
+interface UpdateNodeResult {
+    nodeId: string;
+    warnings: CreateNodeWarning[];
+}
 /** 空间节点信息（仅包含位置和尺寸，用于 AI 理解空间布局） */
 interface SpaceNodeInfo {
     /** 节点 ID */
@@ -437,6 +631,127 @@ interface GetNodeParams {
     /** 索引签名 */
     [key: string]: unknown;
 }
+/** 获取节点上下文参数（get_node_context） */
+interface GetNodeContextParams {
+    /** 目标节点 ID */
+    nodeId: string;
+    /** 向上取几层祖先：-1 = 直到并包含 PAGE（对应 CLI `all`），n>0 = 取 n 层 */
+    ancestorLevels?: number;
+    /** 是否返回 siblings 数组，默认 true */
+    includeSiblings?: boolean;
+    /** 兄弟数量上限，超出时以目标为中心开窗，默认 50 */
+    maxSiblings?: number;
+    /** 目标节点自身子树深度，默认 1 */
+    maxDepth?: number;
+    /** 是否包含不可见节点（仅作用于 siblings 过滤与 node 子树，不影响祖先链） */
+    includeInvisible?: boolean;
+    /** 索引签名 */
+    [key: string]: unknown;
+}
+/**
+ * 祖先节点摘要信息（浅提取，固定字段清单，无 children）
+ * AutoLayout 组输出规则：flexMode 恒输出（含 "NONE"）；组内其余字段仅当 flexMode 存在且 ≠ NONE 时输出。
+ * CLI 侧不对 ancestors 做 trimNodeDefaults
+ */
+interface AncestorInfo {
+    /** 层级，从 1（直接父）递增 */
+    level: number;
+    /** 节点 ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点类型（含 PAGE） */
+    type: string;
+    /** 是否可见（不可见祖先不断链，标 false） */
+    visible?: boolean;
+    /** X 坐标（PAGE 无 LayoutMixin，不含几何组） */
+    x?: number;
+    /** Y 坐标 */
+    y?: number;
+    /** 宽度 */
+    width?: number;
+    /** 高度 */
+    height?: number;
+    /** 直接子节点数量 */
+    childCount?: number;
+    /** 自动布局方向 (NONE | HORIZONTAL | VERTICAL) */
+    flexMode?: string;
+    /** 换行设置 */
+    flexWrap?: string;
+    /** 主轴间距 */
+    itemSpacing?: number;
+    /** 交叉轴间距 */
+    crossAxisSpacing?: number;
+    /** 主轴对齐 */
+    mainAxisAlignItems?: string;
+    /** 交叉轴对齐 */
+    crossAxisAlignItems?: string;
+    /** 主轴尺寸模式 (FIXED | AUTO) */
+    mainAxisSizingMode?: string;
+    /** 交叉轴尺寸模式 (FIXED | AUTO) */
+    crossAxisSizingMode?: string;
+    /** 内边距（上） */
+    paddingTop?: number;
+    /** 内边距（右） */
+    paddingRight?: number;
+    /** 内边距（下） */
+    paddingBottom?: number;
+    /** 内边距（左） */
+    paddingLeft?: number;
+    /** 裁剪内容 */
+    clipsContent?: boolean;
+    /** 布局定位方式 (AUTO | ABSOLUTE) */
+    layoutPositioning?: string;
+    /** 主组件 ID（INSTANCE 专属） */
+    mainComponentId?: string;
+}
+/** 兄弟节点摘要信息（含目标自己，isSelf: true） */
+interface SiblingInfo {
+    /** 过滤前真实序号（与 indexInParent 同源，0-based） */
+    index: number;
+    /** 节点 ID */
+    id: string;
+    /** 节点名称 */
+    name: string;
+    /** 节点类型 */
+    type: string;
+    /** 是否可见 */
+    visible: boolean;
+    /** X 坐标 */
+    x?: number;
+    /** Y 坐标 */
+    y?: number;
+    /** 宽度 */
+    width?: number;
+    /** 高度 */
+    height?: number;
+    /** 布局定位方式（absolute 定位的兄弟不参与 AutoLayout 流） */
+    layoutPositioning?: string;
+    /** 是否是目标节点自己 */
+    isSelf: boolean;
+}
+/**
+ * 节点上下文信息（get_node_context 响应）
+ * 序列化 key 顺序：contextSummary 排第一位，node 大对象排最后
+ */
+interface NodeContextInfo {
+    /** 人类/AI 可读摘要。仅供阅读，不得作为机器解析对象 */
+    contextSummary: string;
+    /** 目标在父节点 children 中的序号（过滤前真实序号，0-based）；无父节点时为 -1 */
+    indexInParent: number;
+    /** 父节点过滤前 children 总数（含目标自己），恒等于 ancestors[0].childCount */
+    siblingCount: number;
+    /** true = siblings 被 maxSiblings 开窗截断。false 时省略 */
+    siblingsTruncated?: boolean;
+    /** true = parent 链中断（未走到 PAGE），已返回部分祖先。false 时省略 */
+    ancestorsIncomplete?: boolean;
+    /** 祖先链，level 从 1（直接父）递增，直到并包含 PAGE */
+    ancestors: AncestorInfo[];
+    /** 兄弟摘要（含目标自己），按真实 index 升序。--no-siblings 时省略 */
+    siblings?: SiblingInfo[];
+    /** 目标节点完整 NodeInfo（深度 = maxDepth） */
+    node: NodeInfo;
+}
 /** 获取页面参数 */
 interface GetPageParams {
     /** 页面 ID */
@@ -625,6 +940,30 @@ interface AllPagesInfo {
     /** 页面总数 */
     totalCount: number;
 }
+/** CREATE_PAGE 请求参数 */
+interface CreatePageParams {
+    /** 新页面名称；未提供时使用 MasterGo 默认命名（页面 N） */
+    name?: string;
+    /** 索引签名（适配 request params 约束） */
+    [key: string]: unknown;
+}
+/** CREATE_PAGE 响应数据 */
+interface CreatePageResult {
+    /** 新页面 ID */
+    pageId: string;
+    /** 新页面 ID（兼容 id 字段） */
+    id: string;
+    /** 新页面名称 */
+    name: string;
+    /** 节点类型，固定为 PAGE */
+    type: 'PAGE';
+    /** 直接子节点数量，新建页面默认为 0 */
+    childCount: number;
+    /** 创建前当前页面 ID */
+    previousPageId?: string;
+    /** 是否已自动切换到新页面 */
+    current: boolean;
+}
 /** 扩展实例信息 */
 interface ExtensionInfo {
     /** 扩展实例序号（1-based） */
@@ -812,6 +1151,7 @@ declare class MGServer {
         stats: {
             providers: number;
             consumers: number;
+            extensions: number;
             total: number;
         };
         connectedPages: string[];
@@ -990,4 +1330,4 @@ declare class RequestHandler {
     cleanupAll(): void;
 }
 
-export { type MgPageInfo as $, type PongMessage as A, type BaseMessage as B, CONFIG_DIR as C, DEV_DEFAULT_PORT as D, ErrorCode as E, type ConnectionInfo as F, type GetNodeParams as G, HEARTBEAT_INTERVAL as H, IS_DEV_MODE as I, type GetPageParams as J, type GetAllNodesParams as K, LOG_DIR as L, MessageType as M, type NodeInfo as N, type ExportImageParams as O, PROD_DEFAULT_PORT as P, type CommentLocation as Q, REQUEST_TIMEOUT as R, type ServerInfo as S, type CommentUserInfo as T, type CommentNearbyNode as U, type CommentInfo as V, type GetCommentsParams as W, type GetCommentsResult as X, type OutputFormatter as Y, type CliOptions as Z, type RGBA as _, type SpaceNodeInfo as a, type AllPagesInfo as a0, type ExtensionInfo as a1, type OpenPageParams as a2, type NavigateToNodeParams as a3, type ConnectedPageInfo as a4, type ServerStatusResponse as a5, MGServer as a6, createServer as a7, type ServerOptions as a8, ConnectionManager as a9, type ManagedWebSocket as aa, RequestHandler as ab, Logger as ac, createLogger as ad, LogLevel as ae, type LoggerOptions as af, PROD_PORT_RANGE_START as b, PROD_PORT_RANGE_END as c, DEV_PORT_RANGE_START as d, DEV_PORT_RANGE_END as e, DEFAULT_PORT as f, PORT_RANGE_START as g, PORT_RANGE_END as h, MAX_PORT_ATTEMPTS as i, PORT_SCAN_TIMEOUT as j, SERVER_INFO_FILE as k, SERVER_LOG_FILE as l, HEARTBEAT_TIMEOUT as m, SERVER_START_TIMEOUT as n, RETRY_INTERVALS as o, MAX_RETRY_COUNT as p, ConnectionType as q, ErrorNames as r, ErrorMessages as s, MGError as t, createError as u, type RequestMessage as v, type ResponseMessage as w, type ErrorInfo as x, type RegisterMessage as y, type PingMessage as z };
+export { type CreateNodeParams as $, type PingMessage as A, type BaseMessage as B, CONFIG_DIR as C, DEV_DEFAULT_PORT as D, ErrorCode as E, type PongMessage as F, type ConnectionInfo as G, HEARTBEAT_INTERVAL as H, IS_DEV_MODE as I, type AvailableFontInfo as J, type ListFontsParams as K, LOG_DIR as L, MessageType as M, type NodeInfo as N, type ListFontsResult as O, PROD_DEFAULT_PORT as P, type ListLibraryParams as Q, REQUEST_TIMEOUT as R, type ServerInfo as S, type LibraryComponentInfo as T, type LibraryInfo as U, type ListLibraryResult as V, type ImportComponentParams as W, type PlacedInstanceInfo as X, type ImportComponentResult as Y, type CreateNodeWarningKind as Z, type CreateNodeWarning as _, type SpaceNodeInfo as a, type CreateNodeResult as a0, type DeleteNodeParams as a1, type DeleteNodeResult as a2, type UpdateNodeParams as a3, type UpdateNodeResult as a4, type GetNodeParams as a5, type GetNodeContextParams as a6, type AncestorInfo as a7, type SiblingInfo as a8, type NodeContextInfo as a9, RequestHandler as aA, Logger as aB, createLogger as aC, LogLevel as aD, type LoggerOptions as aE, type GetPageParams as aa, type GetAllNodesParams as ab, type ExportImageParams as ac, type CommentLocation as ad, type CommentUserInfo as ae, type CommentNearbyNode as af, type CommentInfo as ag, type GetCommentsParams as ah, type GetCommentsResult as ai, type OutputFormatter as aj, type CliOptions as ak, type RGBA as al, type MgPageInfo as am, type AllPagesInfo as an, type CreatePageParams as ao, type CreatePageResult as ap, type ExtensionInfo as aq, type OpenPageParams as ar, type NavigateToNodeParams as as, type ConnectedPageInfo as at, type ServerStatusResponse as au, MGServer as av, createServer as aw, type ServerOptions as ax, ConnectionManager as ay, type ManagedWebSocket as az, PROD_PORT_RANGE_START as b, PROD_PORT_RANGE_END as c, DEV_PORT_RANGE_START as d, DEV_PORT_RANGE_END as e, DEFAULT_PORT as f, PORT_RANGE_START as g, PORT_RANGE_END as h, MAX_PORT_ATTEMPTS as i, PORT_SCAN_TIMEOUT as j, SERVER_INFO_FILE as k, SERVER_LOG_FILE as l, HEARTBEAT_TIMEOUT as m, MAX_REQUEST_TIMEOUT as n, SERVER_START_TIMEOUT as o, RETRY_INTERVALS as p, MAX_RETRY_COUNT as q, ConnectionType as r, ErrorNames as s, ErrorMessages as t, MGError as u, createError as v, type RequestMessage as w, type ResponseMessage as x, type ErrorInfo as y, type RegisterMessage as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ServerInfo, N as NodeInfo, a as SpaceNodeInfo, M as MessageType } from './index-AVsoGQ0e.js';
-export { a0 as AllPagesInfo, B as BaseMessage, C as CONFIG_DIR, Z as CliOptions, V as CommentInfo, Q as CommentLocation, U as CommentNearbyNode, T as CommentUserInfo, a4 as ConnectedPageInfo, F as ConnectionInfo, a9 as ConnectionManager, q as ConnectionType, f as DEFAULT_PORT, D as DEV_DEFAULT_PORT, e as DEV_PORT_RANGE_END, d as DEV_PORT_RANGE_START, E as ErrorCode, x as ErrorInfo, s as ErrorMessages, r as ErrorNames, O as ExportImageParams, a1 as ExtensionInfo, K as GetAllNodesParams, W as GetCommentsParams, X as GetCommentsResult, G as GetNodeParams, J as GetPageParams, H as HEARTBEAT_INTERVAL, m as HEARTBEAT_TIMEOUT, I as IS_DEV_MODE, L as LOG_DIR, ae as LogLevel, ac as Logger, af as LoggerOptions, i as MAX_PORT_ATTEMPTS, p as MAX_RETRY_COUNT, t as MGError, a6 as MGServer, aa as ManagedWebSocket, $ as MgPageInfo, a3 as NavigateToNodeParams, a2 as OpenPageParams, Y as OutputFormatter, h as PORT_RANGE_END, g as PORT_RANGE_START, j as PORT_SCAN_TIMEOUT, P as PROD_DEFAULT_PORT, c as PROD_PORT_RANGE_END, b as PROD_PORT_RANGE_START, z as PingMessage, A as PongMessage, R as REQUEST_TIMEOUT, o as RETRY_INTERVALS, _ as RGBA, y as RegisterMessage, ab as RequestHandler, v as RequestMessage, w as ResponseMessage, k as SERVER_INFO_FILE, l as SERVER_LOG_FILE, n as SERVER_START_TIMEOUT, a8 as ServerOptions, a5 as ServerStatusResponse, u as createError, ad as createLogger, a7 as createServer } from './index-AVsoGQ0e.js';
+import { S as ServerInfo, N as NodeInfo, a as SpaceNodeInfo, M as MessageType } from './index-DuCpsEXk.js';
+export { an as AllPagesInfo, a7 as AncestorInfo, J as AvailableFontInfo, B as BaseMessage, C as CONFIG_DIR, ak as CliOptions, ag as CommentInfo, ad as CommentLocation, af as CommentNearbyNode, ae as CommentUserInfo, at as ConnectedPageInfo, G as ConnectionInfo, ay as ConnectionManager, r as ConnectionType, $ as CreateNodeParams, a0 as CreateNodeResult, _ as CreateNodeWarning, Z as CreateNodeWarningKind, ao as CreatePageParams, ap as CreatePageResult, f as DEFAULT_PORT, D as DEV_DEFAULT_PORT, e as DEV_PORT_RANGE_END, d as DEV_PORT_RANGE_START, a1 as DeleteNodeParams, a2 as DeleteNodeResult, E as ErrorCode, y as ErrorInfo, t as ErrorMessages, s as ErrorNames, ac as ExportImageParams, aq as ExtensionInfo, ab as GetAllNodesParams, ah as GetCommentsParams, ai as GetCommentsResult, a6 as GetNodeContextParams, a5 as GetNodeParams, aa as GetPageParams, H as HEARTBEAT_INTERVAL, m as HEARTBEAT_TIMEOUT, I as IS_DEV_MODE, W as ImportComponentParams, Y as ImportComponentResult, L as LOG_DIR, T as LibraryComponentInfo, U as LibraryInfo, K as ListFontsParams, O as ListFontsResult, Q as ListLibraryParams, V as ListLibraryResult, aD as LogLevel, aB as Logger, aE as LoggerOptions, i as MAX_PORT_ATTEMPTS, n as MAX_REQUEST_TIMEOUT, q as MAX_RETRY_COUNT, u as MGError, av as MGServer, az as ManagedWebSocket, am as MgPageInfo, as as NavigateToNodeParams, a9 as NodeContextInfo, ar as OpenPageParams, aj as OutputFormatter, h as PORT_RANGE_END, g as PORT_RANGE_START, j as PORT_SCAN_TIMEOUT, P as PROD_DEFAULT_PORT, c as PROD_PORT_RANGE_END, b as PROD_PORT_RANGE_START, A as PingMessage, X as PlacedInstanceInfo, F as PongMessage, R as REQUEST_TIMEOUT, p as RETRY_INTERVALS, al as RGBA, z as RegisterMessage, aA as RequestHandler, w as RequestMessage, x as ResponseMessage, k as SERVER_INFO_FILE, l as SERVER_LOG_FILE, o as SERVER_START_TIMEOUT, ax as ServerOptions, au as ServerStatusResponse, a8 as SiblingInfo, a3 as UpdateNodeParams, a4 as UpdateNodeResult, v as createError, aC as createLogger, aw as createServer } from './index-DuCpsEXk.js';
 import 'ws';
 
 /**
@@ -246,12 +246,15 @@ declare class MGClient {
     private register;
     /**
      * 发送请求并等待响应
+     * @param timeoutMs 请求超时（毫秒），缺省 REQUEST_TIMEOUT。
+     *                  会随消息透传给 Server，使 Server 侧转发超时同步放宽
      */
-    request<T = unknown>(type: MessageType, params?: Record<string, unknown>, pageUrl?: string): Promise<T>;
+    request<T = unknown>(type: MessageType, params?: Record<string, unknown>, pageUrl?: string, timeoutMs?: number): Promise<T>;
     /**
      * 带重试的请求
+     * @param timeoutMs 请求超时（毫秒），透传给 request()
      */
-    requestWithRetry<T = unknown>(type: MessageType, params?: Record<string, unknown>, pageUrl?: string): Promise<T>;
+    requestWithRetry<T = unknown>(type: MessageType, params?: Record<string, unknown>, pageUrl?: string, timeoutMs?: number): Promise<T>;
     /**
      * 关闭连接
      */

package/dist/index.js

@@ -20,6 +20,7 @@ var SERVER_LOG_FILE = join(LOG_DIR, "server.log");
 var HEARTBEAT_INTERVAL = 3e4;
 var HEARTBEAT_TIMEOUT = 9e4;
 var REQUEST_TIMEOUT = 3e4;
+var MAX_REQUEST_TIMEOUT = 6e5;
 var SERVER_START_TIMEOUT = 5e3;
 var RETRY_INTERVALS = [1e3, 2e3, 4e3];
 var MAX_RETRY_COUNT = 3;
@@ -35,13 +36,21 @@ var MessageType = /* @__PURE__ */ ((MessageType2) => {
   MessageType2["REGISTER"] = "register";
   MessageType2["REGISTER_ACK"] = "register_ack";
   MessageType2["GET_NODE_BY_ID"] = "get_node_by_id";
+  MessageType2["GET_NODE_CONTEXT"] = "get_node_context";
   MessageType2["GET_PAGE_BY_ID"] = "get_page_by_id";
   MessageType2["GET_ALL_NODES"] = "get_all_nodes";
   MessageType2["GET_SELECTION"] = "get_selection";
   MessageType2["EXPORT_IMAGE"] = "export_image";
   MessageType2["EXECUTE_CODE"] = "execute_code";
+  MessageType2["LIST_FONTS"] = "list_fonts";
+  MessageType2["LIST_LIBRARY"] = "list_library";
+  MessageType2["IMPORT_COMPONENT"] = "import_component";
   MessageType2["GET_ALL_PAGES"] = "get_all_pages";
   MessageType2["GET_COMMENTS"] = "get_comments";
+  MessageType2["CREATE_PAGE"] = "create_page";
+  MessageType2["CREATE_NODE"] = "create_node";
+  MessageType2["DELETE_NODE"] = "delete_node";
+  MessageType2["UPDATE_NODE"] = "update_node";
   MessageType2["LIST_EXTENSIONS"] = "list_extensions";
   MessageType2["OPEN_PAGE"] = "open_page";
   MessageType2["NAVIGATE_TO_NODE"] = "navigate_to_node";
@@ -72,6 +81,8 @@ var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
   ErrorCode2["SERVER_ALREADY_RUNNING"] = "E016";
   ErrorCode2["CONNECTION_LOST"] = "E017";
   ErrorCode2["NO_EXTENSION_CONNECTED"] = "E018";
+  ErrorCode2["EDIT_NOT_ALLOWED"] = "E019";
+  ErrorCode2["CREATE_NODE_FAILED"] = "E020";
   ErrorCode2["UNKNOWN_ERROR"] = "E099";
   return ErrorCode2;
 })(ErrorCode || {});
@@ -94,6 +105,8 @@ var ErrorNames = {
   ["E016" /* SERVER_ALREADY_RUNNING */]: "SERVER_ALREADY_RUNNING",
   ["E017" /* CONNECTION_LOST */]: "CONNECTION_LOST",
   ["E018" /* NO_EXTENSION_CONNECTED */]: "NO_EXTENSION_CONNECTED",
+  ["E019" /* EDIT_NOT_ALLOWED */]: "EDIT_NOT_ALLOWED",
+  ["E020" /* CREATE_NODE_FAILED */]: "CREATE_NODE_FAILED",
   ["E099" /* UNKNOWN_ERROR */]: "UNKNOWN_ERROR"
 };
 var ErrorMessages = {
@@ -115,6 +128,8 @@ var ErrorMessages = {
   ["E016" /* SERVER_ALREADY_RUNNING */]: "Server \u5DF2\u5728\u8FD0\u884C\u4E2D",
   ["E017" /* CONNECTION_LOST */]: "\u8FDE\u63A5\u65AD\u5F00",
   ["E018" /* NO_EXTENSION_CONNECTED */]: "\u6CA1\u6709 Chrome \u6269\u5C55\u8FDE\u63A5\u5230 Server\u3002\u8BF7\u786E\u4FDD\u6D4F\u89C8\u5668\u5DF2\u6253\u5F00\u5E76\u5B89\u88C5\u4E86 MG Plugin",
+  ["E019" /* EDIT_NOT_ALLOWED */]: "\u9875\u9762\u53EA\u8BFB\u6216\u65E0\u7F16\u8F91\u6743\u9650\uFF0C\u65E0\u6CD5\u6267\u884C\u5199\u64CD\u4F5C",
+  ["E020" /* CREATE_NODE_FAILED */]: "\u521B\u5EFA\u8282\u70B9\u5931\u8D25\uFF08\u6839\u8282\u70B9\u65E0\u6CD5\u521B\u5EFA\uFF09",
   ["E099" /* UNKNOWN_ERROR */]: "\u672A\u77E5\u9519\u8BEF"
 };
 var MGError = class extends Error {
@@ -481,7 +496,6 @@ var NODE_DEFAULTS = {
   layoutPositioning: "AUTO",
   constrainProportions: false,
   // 容器专属属性 (FrameNode)
-  flexMode: "NONE",
   flexWrap: "NO_WRAP",
   itemSpacing: 0,
   crossAxisSpacing: 0,
@@ -894,6 +908,12 @@ var ConnectionManager = class {
 };
 
 // src/server/request-handler.ts
+function resolveRequestTimeout(timeoutMs) {
+  if (typeof timeoutMs !== "number" || !Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+    return REQUEST_TIMEOUT;
+  }
+  return Math.min(timeoutMs, MAX_REQUEST_TIMEOUT);
+}
 var RequestHandler = class {
   logger;
   connectionManager;
@@ -926,7 +946,7 @@ var RequestHandler = class {
     }
     const timer = setTimeout(() => {
       this.handleTimeout(requestId);
-    }, REQUEST_TIMEOUT);
+    }, resolveRequestTimeout(message.timeoutMs));
     this.pendingRequests.set(requestId, {
       id: requestId,
       consumer,
@@ -1653,7 +1673,7 @@ var MGClient = class {
         const currentVersion = getVersion();
         if (!isVersionMatch(currentVersion, serverInfo.version)) {
           console.warn(`\u26A0\uFE0F \u7248\u672C\u4E0D\u5339\u914D: CLI ${currentVersion} vs Server ${serverInfo.version}`);
-          console.warn("\u63D0\u793A: \u5982\u9700\u5BF9\u9F50\u7248\u672C\uFF0C\u8BF7\u624B\u52A8\u8FD0\u884C `npx -y @hangox/mg-cli@latest server restart`");
+          console.warn("\u63D0\u793A: \u5982\u9700\u5BF9\u9F50\u7248\u672C\uFF0C\u8BF7\u624B\u52A8\u8FD0\u884C `mg-cli server restart`");
         }
         try {
           await this.tryConnect(serverInfo.port);
@@ -1739,8 +1759,10 @@ var MGClient = class {
   }
   /**
    * 发送请求并等待响应
+   * @param timeoutMs 请求超时（毫秒），缺省 REQUEST_TIMEOUT。
+   *                  会随消息透传给 Server，使 Server 侧转发超时同步放宽
    */
-  async request(type, params, pageUrl) {
+  async request(type, params, pageUrl, timeoutMs) {
     if (!this.ws) {
       throw new MGError("E001" /* CONNECTION_FAILED */, "\u672A\u8FDE\u63A5\u5230 Server");
     }
@@ -1750,12 +1772,13 @@ var MGClient = class {
       type,
       params,
       pageUrl,
+      timeoutMs,
       timestamp: Date.now()
     };
     return new Promise((resolve2, reject) => {
       const timer = setTimeout(() => {
         reject(new MGError("E012" /* REQUEST_TIMEOUT */, ErrorMessages["E012" /* REQUEST_TIMEOUT */]));
-      }, REQUEST_TIMEOUT);
+      }, timeoutMs ?? REQUEST_TIMEOUT);
       const messageHandler = (data) => {
         try {
           const response = JSON.parse(data.toString());
@@ -1783,15 +1806,16 @@ var MGClient = class {
   }
   /**
    * 带重试的请求
+   * @param timeoutMs 请求超时（毫秒），透传给 request()
    */
-  async requestWithRetry(type, params, pageUrl) {
+  async requestWithRetry(type, params, pageUrl, timeoutMs) {
     if (this.options.noRetry) {
-      return this.request(type, params, pageUrl);
+      return this.request(type, params, pageUrl, timeoutMs);
     }
     let lastError = null;
     for (let attempt = 0; attempt <= MAX_RETRY_COUNT; attempt++) {
       try {
-        return await this.request(type, params, pageUrl);
+        return await this.request(type, params, pageUrl, timeoutMs);
       } catch (error) {
         lastError = error instanceof Error ? error : new Error(String(error));
         if (error instanceof MGError) {
@@ -1840,6 +1864,7 @@ export {
   LogLevel,
   Logger,
   MAX_PORT_ATTEMPTS,
+  MAX_REQUEST_TIMEOUT,
   MAX_RETRY_COUNT,
   MGClient,
   MGError,