clickgo 5.12.6 → 5.12.8

package/doc/clickgo-rag.md

@@ -2000,6 +2000,12 @@ ECharts 配置选项。
 
 选区变更时触发，包括创建新选区、移动选区、组合选区、清除选区等所有导致选区矩形列表发生变化的操作。可在此事件中读取 `access.marquee` 获取最新的选区数据。
 
+#### layerlistchange
+
+`() => void`
+
+图层列表发生变化时触发。以下三种情况均会触发：调用 `addLayer` 新建空图层、调用 `removeLayer` 移除图层、通过 `canvas.add(obj)` 首次将某个新 `name` 对应的对象加入画布时自动注册。可在此事件中读取 `layers` 获取最新的图层列表。
+
 ### 属性
 
 #### access.canvas
@@ -2032,6 +2038,18 @@ fabric.js Canvas 对象，在 `init` 事件触发后可用。可通过此对象
 
 使用 `subtract` 或 `add` 组合模式时，列表中可能包含多个矩形。
 
+### 属性
+
+#### layers
+
+`string[]`
+
+所有图层名称列表，具有响应式。包含两类图层：
+- 通过 `addLayer` 创建的空图层（未包含任何对象）
+- 通过 `canvas.add(obj)` 加入对象时自动注册的图层
+
+注意：手动删除某图层内所有对象不会自动移除该图层，需显式调用 `removeLayer` 才能销毁。
+
 ### 方法
 
 #### zoomActual
@@ -2107,6 +2125,28 @@ setMarqueeRect(x: number, y: number, width: number, height: number): void
 - `width` — 矩形宽度
 - `height` — 矩形高度
 
+#### addLayer
+
+```typescript
+addLayer(name: string): boolean
+```
+
+新建一个空图层。若 `name` 已在 `access.layers` 中则返回 `false`，否则将 `name` 加入 `access.layers` 并触发 `layerlistchange` 事件，返回 `true`。
+
+**参数**：
+- `name` — 图层名称，须唯一
+
+#### removeLayer
+
+```typescript
+removeLayer(name: string): void
+```
+
+移除图层及其下属的所有 fabric 对象，并触发 `layerlistchange` 事件。若当前激活图层包含该 `name`，会同时从 `layer` prop 中移除并触发 `update:layer`。`name` 不存在时不做任何操作。
+
+**参数**：
+- `name` — 要移除的图层名称
+
 ### 插槽
 
 无

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clickgo",
-  "version": "5.12.6",
+  "version": "5.12.8",
   "description": "Background interface, software interface, mobile phone APP interface operation library.",
   "type": "module",
   "keywords": [