clickgo 7.3.2 → 7.4.0

package/dist/lib/control.d.ts

@@ -819,18 +819,28 @@ export interface IFabricObjectchangeEvent {
         'height': number;
     };
 }
-export interface IObjviewerLine {
-    /** -- 可自定义线段的名称 --- */
-    'name'?: string;
-    'start': clickgo.control.IObjviewerLineObj;
-    'end': clickgo.control.IObjviewerLineObj;
-    /** --- 默认 255 --- */
-    'hue'?: string;
-    'path'?: string;
-    /** --- 默认 solid --- */
-    'stroke'?: 'solid' | 'dashed' | 'up' | 'down';
-}
-export interface IObjviewerLineObj {
-    'obj': HTMLElement | AbstractControl;
-    'pos': 'lt' | 't' | 'tr' | 'r' | 'rb' | 'b' | 'bl' | 'l';
+/** --- 节点和连接的语义状态，不依赖主题的具体颜色 --- */
+export type TObjviewerStatus = 'default' | 'online' | 'warning' | 'offline';
+/** --- 按稳定节点 ID 声明的连接，节点暂不存在时不绘制，不保存 DOM 引用 --- */
+export interface IObjviewerEdge {
+    'source': string;
+    'target': string;
+    'label'?: string;
+    /** --- 默认 default，连接状态由应用明确提供 --- */
+    'status'?: TObjviewerStatus;
+    /** --- 默认 none，dash 为流动虚线，dots 为静止底线上的移动圆点 --- */
+    'animation'?: 'none' | 'dash' | 'dots';
+    /** --- 默认 forward，沿 source 到 target；reverse 反向，both 双向 --- */
+    'direction'?: 'forward' | 'reverse' | 'both';
+    /** --- 动画周期，单位秒，默认 3，限制为 0.25–60；dots 为走完整条路径的时间 --- */
+    'duration'?: number;
+    /** --- dots 模式每个方向的圆点数，默认 3，取整并限制为 1–8 --- */
+    'dotCount'?: number;
+}
+/** --- 节点选择事件，仅通知选择，不在控件内执行业务跳转 --- */
+export interface IObjviewerSelectEvent {
+    'detail': {
+        'nodeId': string;
+        'label': string;
+    };
 }

package/doc/clickgo-rag.md

@@ -1186,6 +1186,16 @@ cell 之间的间距，默认 0。
 
 是否使用与 Tag 相同的朴素模式，默认 false。语义色和主题色使用柔和底色、对应文字色及边框；最终外观由主题决定。
 
+#### pulse
+
+`boolean` | `string`
+
+是否启用同色扩散光圈，默认 false。光圈随 `type` 的语义色或主题色变化，实心与朴素模式均支持；圆点、内容及布局尺寸不参与缩放。启用系统“减少动态效果”时显示静态光圈。
+
+这是布尔开关；`string` 仅兼容 XML 属性传值，并非动画名称或多种效果的枚举。可用 `pulse` 开启，或用 `:pulse="online"` 绑定布尔状态。
+
+光圈向组件外侧绘制，放在 Flow 等滚动容器内时需在滚动区域内部留出空间，避免被 overflow 裁切。
+
 #### sub
 
 `boolean` | `string`
@@ -1211,6 +1221,8 @@ cell 之间的间距，默认 0。
 ```xml
 <circle type="primary" size="xl">A</circle>
 <circle type="cg" size="xl" plain>A</circle>
+<circle type="primary" pulse></circle>
+<circle type="cg" :pulse="online"></circle>
 ```
 
 
@@ -1324,48 +1336,34 @@ cell 之间的间距，默认 0。
 ## cube
 ---
 
-立方体 3D 展示组件。
+独立的立方体设备标识，可用于列表、概览卡片或 Objviewer 节点的 icon 插槽。固定占位内以三个 SVG 平面构成三维立方体，按统一视点投影；不监听内容尺寸，也不参与父空间的连接与布局。
 
-### 参数
+鼠标悬停时立方体向上和向前抬升并轻微转动，顶面与侧面的边随透视共同变化；顶面插槽、扫光同步跟随，落地阴影留在原处并变得柔和。外层占位和连线端点保持不变。动效由 CSS 三维面结构管理，无计时器或动画回调依赖；减少动态效果时保持静止立体姿态并关闭扫光，仅保留色彩反馈。
 
-#### hue
+### 参数
 
-`string`
+#### type
 
-色调值，默认 `255`。
+`'default' | 'primary' | 'info' | 'warning' | 'danger' | 'cg'`，默认 `cg`。使用框架语义色和用户主题色，三面明度随主题表面变化。
 
 #### size
 
-`'xs'` | `'s'` | `'m'` | `'mh'` | `'l'` | `'lh'` | `'xl'` | `'xlh'`
-
-尺寸，默认 `s`。
-
-### 事件
-
-#### anistart
-
-`() => void`
-
-动画开始时触发。
-
-#### aniend
-
-`() => void`
-
-动画结束时触发。
+`'s' | 'm' | 'l' | 'xl'`，默认 `m`，固定占位分别为 `32 / 48 / 64 / 88px`。插槽不会撑大占位，请使用适当尺寸的 Icon 或简短文字。
 
-### 样式
-
-使用 CSS 3D 变换实现立方体效果。顶面可通过插槽自定义内容。
+### 插槽
 
-支持鼠标悬停动画效果。具有透视效果和平滑的动画。
+默认插槽显示在顶面中央。Cube 本身不承担选择或动画事件；点击与状态由外层 Button、列表项或 Objviewer-item 负责。
 
 ### 示例
 
 ```xml
-<cube hue="180" size="m" @anistart="onStart">Top</cube>
+<cube type="info" size="m"><icon name="cpu" size="s"></icon></cube>
+<objviewer-item node-id="server" variant="hub" label="Server" status="online">
+    <template v-slot:icon><cube type="cg"><icon name="cpu" size="s"></icon></cube></template>
+</objviewer-item>
 ```
 
+
 ## date
 ---
 
@@ -1383,7 +1381,7 @@ cell 之间的间距，默认 0。
 
 `string[]` | `string`
 
-禁用日期列表。
+禁用日期列表，date 模式使用 YYYYMMDD，month 模式使用 YYYYMM。
 
 #### modelValue
 
@@ -1391,6 +1389,14 @@ cell 之间的间距，默认 0。
 
 双向绑定，时间戳毫秒值。
 
+month 模式将值归一到所选时区的当月 1 日 00:00:00.000；外部传入日期也会归一并同步绑定值。固定 UTC 月初时传 `:tz="0"`，不依赖设备时区。
+
+#### mode
+
+`'date'` | `'month'`
+
+选择粒度，默认 date。month 只显示年份和月份，不提供日格或时间选择，并忽略 date、time、hourminute 参数；zone 和 tz 仍按原有规则工作。
+
 #### tz
 
 `number` | `string`
@@ -1413,13 +1419,13 @@ cell 之间的间距，默认 0。
 
 `number` | `string`
 
-可选开始时间。
+可选开始时间，沿用 datepanel 的秒/毫秒约定；month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### end
 
 `number` | `string`
 
-可选结束时间。
+可选结束时间，沿用 datepanel 的秒/毫秒约定；month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### date
 
@@ -1443,7 +1449,7 @@ cell 之间的间距，默认 0。
 
 `boolean` | `string`
 
-选择后是否自动关闭，默认 true。
+是否显示清空按钮，默认 true。
 
 ### 事件
 
@@ -1451,7 +1457,7 @@ cell 之间的间距，默认 0。
 
 `(event: IDateChangedEvent) => void`
 
-值改变后触发，包含 `value`、`zone` 和 `dates` 信息。
+值改变后触发，包含 `before` 和 `value`。month 模式选中月份或清空时触发，归一化外部赋值不视为用户选择。
 
 #### yearmonthchanged
 
@@ -1471,8 +1477,10 @@ cell 之间的间距，默认 0。
 
 ```xml
 <date v-model="timestamp"></date>
+<date mode="month" v-model="monthTimestamp" :tz="0"></date>
 ```
 
+
 ## datepanel
 ---
 
@@ -1496,7 +1504,7 @@ cell 之间的间距，默认 0。
 
 `string[]` | `string`
 
-禁用日期列表。
+禁用日期列表，date 模式使用 YYYYMMDD，month 模式使用 YYYYMM。
 
 #### modelValue
 
@@ -1504,17 +1512,25 @@ cell 之间的间距，默认 0。
 
 双向绑定，时间戳值（毫秒）。
 
+month 模式归一到所选时区的当月 1 日 00:00:00.000；外部传入日期也会归一并同步绑定值。
+
+#### mode
+
+`'date'` | `'month'`
+
+选择粒度，默认 date。month 使用年份导航和十二个月份按钮，隐藏日格与时间选择，忽略 time、hourminute、range 和 cursor。月份按钮复用全部内置语种的月份名称。
+
 #### start
 
 `number` | `string`
 
-可选开始时间（秒/毫秒）。
+可选开始时间（秒/毫秒）。month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### end
 
 `number` | `string`
 
-可选结束时间（秒/毫秒）。
+可选结束时间（秒/毫秒）。month 模式按所选时区的年月限制，包含边界所在月份。
 
 #### tz
 
@@ -1594,7 +1610,7 @@ cell 之间的间距，默认 0。
 
 `(event: IDatepanelSelectedEvent) => void`
 
-选中日期时触发。
+选中日期时触发。month 模式的 date 固定为 1，month 仍从 0 开始，time 为所选时区的月初毫秒时间戳。
 
 #### range
 
@@ -1614,8 +1630,10 @@ cell 之间的间距，默认 0。
 
 ```xml
 <datepanel v-model="timestamp" time></datepanel>
+<datepanel mode="month" v-model="monthTimestamp" :tz="0"></datepanel>
 ```
 
+
 ## daterange
 ---
 
@@ -6224,121 +6242,142 @@ noVNC 远程桌面组件。
 ## objviewer
 ---
 
-对象查看器组件，用于在可缩放的画布上展示内容。
+节点关系空间。以稳定 ID 声明节点与连接，自动布局和尺寸测量在控件内部完成；平移、滚轮、双指缩放和视口适应复用 Panzoom。不是 3D 场景或流程编辑器。
 
 ### 参数
 
-#### direction
+#### edges
 
-`'h'` | `'v'`
+`clickgo.control.IObjviewerEdge[]`，默认 `[]`。每条连接含 `source`、`target` 节点 ID，可选 `label`、`status`（`default / online / warning / offline`）。端点不存在时暂不绘制，恢复节点后自动出现。状态与是否启用动画均由应用提供，不从端点猜测。
 
-布局方向，默认 `h`。
+每条连接可独立设置动画：
+
+- `animation`：`none / dash / dots`，默认 `none`；分别为静止连接、流动虚线、静止底线上的多个移动圆点。颜色跟随连接状态，选中关联节点时使用主题色。
+- `direction`：`forward / reverse / both`，默认 `forward`；分别沿 source → target、target → source、同时双向流动。仅改变动画，不交换节点关系或改变布局。
+- `duration`：周期秒数，默认 `3`，限制为 `0.25–60`；dots 为圆点走完整条路径的时间，dash 为虚线纹理的一个动画周期。
+- `dotCount`：dots 模式每个方向的圆点数，默认 `3`，取整并限制为 `1–8`。圆点均匀错开，双向时两组错开半个间隔。
+
+路径随节点、容器与布局变化更新；减少动态效果时隐藏移动圆点并停止虚线动画，保留静止连接。
+
+#### layout
+
+`'auto' | 'radial' | 'tree' | 'manual'`，默认 `auto`。自动模式在 600px 以下容器改为紧凑纵排与侧边关系线，宽容器使用环形。显式 radial 固定环形，以节点的可视标识中心定位；tree 分层适合设备树和依赖概览；manual 使用各节点的 x/y。支持环、孤立节点与多个连通分量，不持续运行力模拟。非紧凑布局使用直线；中心节点的标识与说明共同决定端点，连线遇到说明时止于说明外缘，不穿字或局部绕行。不提供通用避障路由或端口编辑。
+
+#### root
+
+`string`，默认空。优先根节点 ID；未提供时优先无入边节点，再选择连接较多的节点。
+
+#### gap
+
+`number | string`，默认 `48`，环形和分层布局的最小间隔，单位 CSS 像素，限制为 `24–400`。紧凑模式的纵向间隔固定为 24px。
 
 #### bg
 
-`'dot'` | `'grid'`
+`'none' | 'dot' | 'grid'`，默认 `none`。
+
+#### modelValue
 
-背景样式，默认 `dot`。
+`string`，当前选中节点 ID，默认空，可用 v-model。移除选中节点时清空绑定，不触发 select。
 
-#### gutter
+#### disabled
 
-`number` | `string`
+`boolean | string`，默认 false，禁用视图手势、工具栏和节点选择。
 
-子元素间距。
+#### label
 
-#### alignH
+`string`，空间无障碍名称，由应用提供本地化文案。
 
-`string` | `undefined`
+### 事件
 
-水平对齐方式。
+#### select
 
-#### alignV
+`clickgo.control.IObjviewerSelectEvent`：`detail: {nodeId, label}`。点击、Enter 或空格激活不同的可操作节点时触发；重复选择不触发。控件不执行业务跳转。
 
-`string` | `undefined`
+### 方法
 
-垂直对齐方式。
+- `fit()`：恢复完整显示，之后随视口缩放继续适应。
+- `zoom(factor)`：围绕视口中心按相对比例缩放，如 `1.2`。用户缩放/平移后调整窗口保持当前比例和中心；内容边界变化重新适应。
 
-### 样式
+### 插槽与尺寸
 
-支持缩放和平移的画布容器。背景可显示点阵或网格。
+默认插槽仅放直属 objviewer-item，可用 v-for/v-if。节点 ID 必须非空且唯一；无效项隐藏，重复 ID 只使用第一项。`empty` 插槽自定义空态。
 
-可在内部放置 objviewer-item 子组件，支持连接线绘制。
+给容器明确高度或 flex 剩余空间；场景按真实节点尺寸及 48px 留白计算，不用屏幕坐标反推，也无需 addLine、动画回调或延时 refresh。首次完整显示，大图可通过工具栏/手势放大查看文字。0 大小或隐藏视口恢复后自动适应；减少动态效果时连接静止。
 
 ### 示例
 
 ```xml
-<objviewer>
-    <objviewer-item label="Item 1">Content</objviewer-item>
+<objviewer :edges="[{source: 'gateway', target: 'device', status: 'online', animation: 'dots', direction: 'both', duration: 3, dotCount: 3}]" root="gateway" v-model="selected" style="height:420px;">
+    <objviewer-item node-id="gateway" variant="hub" label="Gateway" status="online" icon="cpu"></objviewer-item>
+    <objviewer-item node-id="device" label="Device" description="Branch office" status="online"></objviewer-item>
 </objviewer>
 ```
 
+
 ## objviewer-item
 ---
 
-对象查看器项组件。
+Objviewer 的直属节点。节点自己显示内容和状态，父空间负责位置与连接；不再承担通用 Layout 的职责。
 
 ### 参数
 
-#### hue
-
-`string`
-
-色调值，默认 `255`。
+#### nodeId
 
-#### hover
-
-`boolean` | `string`
+`string`，默认空，必填的稳定唯一 ID，用于连接和选择。不使用 ref 或 DOM 引用作为端点。
 
-是否启用悬停效果，默认 false。
+#### label
 
-#### direction
+`string`，名称，默认空，空时显示 nodeId。
 
-`'h'` | `'v'`
+#### description
 
-布局方向，默认 `h`。
+`string`，辅助说明，默认空，可显示地址、位置、数量等。
 
-#### border
+#### icon
 
-`'solid'` | `'dotted'` | `'dashed'` | `'ani'`
+`string`，框架图标名称，默认空。hub 未提供时显示 cpu。
 
-边框样式，默认 `solid`。
+#### status
 
-#### gutter
+`'default' | 'online' | 'warning' | 'offline'`，默认 `default`。状态通过圆点与本地化文字共同表达，不只依靠颜色；语义色跟随主题。
 
-`number` | `string`
+#### statusLabel
 
-子元素间距。
+`string`，默认空，覆盖状态文字，应用可用于“维护中”等业务状态说明。
 
-#### alignH
+#### variant
 
-`string` | `undefined`
+`'card' | 'hub'`，默认 `card`。卡片为 184px 宽、自然高度；中心节点为 144px 宽，含 72px 圆形标识。名称/描述自动换行，自定义内容的尺寸变化自动通知空间。父空间自动切换紧凑模式时优先展示名称和状态，辅助说明及卡片图标收起；完整说明保留在无障碍描述，应用也可根据选中 ID 显示详情。
 
-水平对齐方式。
+#### pulse
 
-#### alignV
+`boolean | string`，默认 true，仅 online 状态显示 Circle 的同色光圈；减少动态效果时静止。
 
-`string` | `undefined`
+#### disabled
 
-垂直对齐方式。
+`boolean | string`，默认 false，禁止鼠标和键盘选择，状态与内容仍可见。
 
-#### label
+#### x
 
-`string`
+`number | string`，默认 `0`，manual 布局下的内容水平坐标。
 
-标签文本。
+#### y
 
-### 样式
+`number | string`，默认 `0`，manual 布局下的内容垂直坐标。坐标可为负数，空间统一归一化并留白。
 
-作为 objviewer 的子组件，显示单个卡片项。
+### 插槽
 
-支持不同的边框样式和色调。可显示标签文本。
+`icon` 自定义标识，可放 Icon、Cube 或图片；默认插槽在说明下增加内容。节点内独立按钮/输入不触发节点选择。选择事件由 Objviewer 统一发出。
 
 ### 示例
 
 ```xml
-<objviewer-item label="Item 1">Content</objviewer-item>
+<objviewer-item node-id="worker" label="Background worker" status="warning" description="Queue waiting">
+    <tag type="warning" plain size="xs">12 jobs</tag>
+</objviewer-item>
 ```
 
+
 ## page
 ---
 
@@ -14117,8 +14156,8 @@ lib/control/index.md
 - [INavItemSelectEvent](interfaces/INavItemSelectEvent.md)
 - [INumberBeforeChangeEvent](interfaces/INumberBeforeChangeEvent.md)
 - [INumberMinMaxChangeEvent](interfaces/INumberMinMaxChangeEvent.md)
-- [IObjviewerLine](interfaces/IObjviewerLine.md)
-- [IObjviewerLineObj](interfaces/IObjviewerLineObj.md)
+- [IObjviewerEdge](interfaces/IObjviewerEdge.md)
+- [IObjviewerSelectEvent](interfaces/IObjviewerSelectEvent.md)
 - [IPaletteChangedEvent](interfaces/IPaletteChangedEvent.md)
 - [IPanelGoEvent](interfaces/IPanelGoEvent.md)
 - [IPanelWentEvent](interfaces/IPanelWentEvent.md)
@@ -14154,6 +14193,7 @@ lib/control/index.md
 - [TControlPackage](type-aliases/TControlPackage.md)
 - [TDesktopLayoutReason](type-aliases/TDesktopLayoutReason.md)
 - [TDesktopPositions](type-aliases/TDesktopPositions.md)
+- [TObjviewerStatus](type-aliases/TObjviewerStatus.md)
 
 ## Functions
 
@@ -16707,101 +16747,125 @@ Defined in: [lib/control.ts:971](https://github.com/maiyun/clickgo/blob/master/d
 
 [`ICustomEvent`](ICustomEvent.md).[`preventDefault`](ICustomEvent.md#preventdefault)
 
-lib/control/interfaces/IObjviewerLine.md
+lib/control/interfaces/IObjviewerEdge.md
 ---
 
 [**Documents for clickgo**](../../../index.md)
 
 ***
 
-[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerLine
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerEdge
 
-# Interface: IObjviewerLine
+# Interface: IObjviewerEdge
 
-Defined in: [lib/control.ts:1737](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1737)
+Defined in: [lib/control.ts:1741](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1741)
+
+按稳定节点 ID 声明的连接，节点暂不存在时不绘制，不保存 DOM 引用
 
 ## Properties
 
-### end
+### animation?
 
-> **end**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
+> `optional` **animation?**: `"none"` \| `"dash"` \| `"dots"`
 
-Defined in: [lib/control.ts:1741](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1741)
+Defined in: [lib/control.ts:1748](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1748)
+
+默认 none，dash 为流动虚线，dots 为静止底线上的移动圆点
 
 ***
 
-### hue?
+### direction?
 
-> `optional` **hue?**: `string`
+> `optional` **direction?**: `"reverse"` \| `"forward"` \| `"both"`
 
-Defined in: [lib/control.ts:1743](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1743)
+Defined in: [lib/control.ts:1750](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1750)
 
-默认 255
+默认 forward，沿 source 到 target；reverse 反向，both 双向
 
 ***
 
-### name?
+### dotCount?
 
-> `optional` **name?**: `string`
+> `optional` **dotCount?**: `number`
 
-Defined in: [lib/control.ts:1739](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1739)
+Defined in: [lib/control.ts:1754](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1754)
 
--- 可自定义线段的名称
+dots 模式每个方向的圆点数，默认 3，取整并限制为 1–8
 
 ***
 
-### path?
+### duration?
 
-> `optional` **path?**: `string`
+> `optional` **duration?**: `number`
+
+Defined in: [lib/control.ts:1752](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1752)
+
+动画周期，单位秒，默认 3，限制为 0.25–60；dots 为走完整条路径的时间
+
+***
+
+### label?
+
+> `optional` **label?**: `string`
 
 Defined in: [lib/control.ts:1744](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1744)
 
 ***
 
-### start
+### source
 
-> **start**: [`IObjviewerLineObj`](IObjviewerLineObj.md)
+> **source**: `string`
 
-Defined in: [lib/control.ts:1740](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1740)
+Defined in: [lib/control.ts:1742](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1742)
 
 ***
 
-### stroke?
+### status?
 
-> `optional` **stroke?**: `"solid"` \| `"dashed"` \| `"up"` \| `"down"`
+> `optional` **status?**: [`TObjviewerStatus`](../type-aliases/TObjviewerStatus.md)
 
 Defined in: [lib/control.ts:1746](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1746)
 
-默认 solid
+默认 default，连接状态由应用明确提供
+
+***
+
+### target
 
-lib/control/interfaces/IObjviewerLineObj.md
+> **target**: `string`
+
+Defined in: [lib/control.ts:1743](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1743)
+
+lib/control/interfaces/IObjviewerSelectEvent.md
 ---
 
 [**Documents for clickgo**](../../../index.md)
 
 ***
 
-[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerLineObj
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / IObjviewerSelectEvent
+
+# Interface: IObjviewerSelectEvent
 
-# Interface: IObjviewerLineObj
+Defined in: [lib/control.ts:1758](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1758)
 
-Defined in: [lib/control.ts:1749](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1749)
+节点选择事件，仅通知选择，不在控件内执行业务跳转
 
 ## Properties
 
-### obj
+### detail
 
-> **obj**: `HTMLElement` \| [`AbstractControl`](../classes/AbstractControl.md)
+> **detail**: `object`
 
-Defined in: [lib/control.ts:1750](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1750)
+Defined in: [lib/control.ts:1759](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1759)
 
-***
+#### label
 
-### pos
+> **label**: `string`
 
-> **pos**: `"b"` \| `"tr"` \| `"l"` \| `"lt"` \| `"t"` \| `"r"` \| `"rb"` \| `"bl"`
+#### nodeId
 
-Defined in: [lib/control.ts:1751](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1751)
+> **nodeId**: `string`
 
 lib/control/interfaces/IPaletteChangedEvent.md
 ---
@@ -18307,6 +18371,23 @@ Defined in: [lib/control.ts:1321](https://github.com/maiyun/clickgo/blob/master/
 
 图标 ID 到位置的映射，可独立保存和恢复
 
+lib/control/type-aliases/TObjviewerStatus.md
+---
+
+[**Documents for clickgo**](../../../index.md)
+
+***
+
+[Documents for clickgo](../../../index.md) / [lib/control](../index.md) / TObjviewerStatus
+
+# Type Alias: TObjviewerStatus
+
+> **TObjviewerStatus** = `"default"` \| `"online"` \| `"warning"` \| `"offline"`
+
+Defined in: [lib/control.ts:1738](https://github.com/maiyun/clickgo/blob/master/dist/lib/control.ts#L1738)
+
+节点和连接的语义状态，不依赖主题的具体颜色
+
 lib/core/classes/AbstractApp.md
 ---
 
@@ -21856,7 +21937,7 @@ Defined in: [lib/dom.ts:1910](https://github.com/maiyun/clickgo/blob/master/dist
 
 ### pos
 
-`"b"` \| `"tr"` \| `"l"` \| `"lt"` \| `"t"` \| `"r"` \| `"rb"` \| `"bl"`
+`"b"` \| `"tr"` \| `"l"` \| `"rb"` \| `"lt"` \| `"t"` \| `"r"` \| `"bl"`
 
 ## Returns