ice-entity-designer 0.9.0 → 0.10.0

package/dist/types/utils/register-types.d.mts

@@ -0,0 +1,23 @@
+/**
+ * 把 IED 的全部领域图元类型注册到某个 `ICE` 实例上（幂等，重复调用无副作用）。
+ *
+ * **为什么需要它**：类型注册是**按实例**的（`ice.registerType(typeId, Ctor)`），而 `Deserializer`
+ * 完全靠这张注册表还原组件 —— 应用里那台 ICE 由各 Designer 的构造函数顺手注册（`FlowDesigner`
+ * 注册 `FlowNode/FlowEdge`、`UmlDesigner` 注册 `UmlClass/UmlRelation`……）。
+ *
+ * 但 **worker 侧的镜像那台 ICE 没有任何 Designer**：它只做"按文档重建 + 渲染"。
+ * 不注册的后果不是报错，而是**静默丢内容** —— 反序列化器会跳过整棵未注册的子树
+ * （`MirrorTarget.applyScene()` 会把 `unknownTypes` 原样报回来，这正是那条上报存在的意义）。
+ *
+ * 用法（worker 脚本里，`importScripts` 引擎与 IED 两个 UMD 之后）：
+ * ```js
+ * ICE.init(offscreenCanvas.getContext('2d'));
+ * IED.registerDesignerTypes(ice);
+ * const target = new ICE.MirrorTarget(ice);
+ * ```
+ *
+ * 不需要全部领域时，也可以只注册用到的那几个类（`iedTypeId('FlowNode')` → 直接 `ice.registerType`）。
+ */
+export declare function registerDesignerTypes(ice: any): number;
+/** 注册表里有哪些类型（调试 / 文档用）。 */
+export declare function designerTypeIds(): string[];

package/dist/types/utils/register-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 把 IED 的全部领域图元类型注册到某个 `ICE` 实例上（幂等，重复调用无副作用）。
+ *
+ * **为什么需要它**：类型注册是**按实例**的（`ice.registerType(typeId, Ctor)`），而 `Deserializer`
+ * 完全靠这张注册表还原组件 —— 应用里那台 ICE 由各 Designer 的构造函数顺手注册（`FlowDesigner`
+ * 注册 `FlowNode/FlowEdge`、`UmlDesigner` 注册 `UmlClass/UmlRelation`……）。
+ *
+ * 但 **worker 侧的镜像那台 ICE 没有任何 Designer**：它只做"按文档重建 + 渲染"。
+ * 不注册的后果不是报错，而是**静默丢内容** —— 反序列化器会跳过整棵未注册的子树
+ * （`MirrorTarget.applyScene()` 会把 `unknownTypes` 原样报回来，这正是那条上报存在的意义）。
+ *
+ * 用法（worker 脚本里，`importScripts` 引擎与 IED 两个 UMD 之后）：
+ * ```js
+ * ICE.init(offscreenCanvas.getContext('2d'));
+ * IED.registerDesignerTypes(ice);
+ * const target = new ICE.MirrorTarget(ice);
+ * ```
+ *
+ * 不需要全部领域时，也可以只注册用到的那几个类（`iedTypeId('FlowNode')` → 直接 `ice.registerType`）。
+ */
+export declare function registerDesignerTypes(ice: any): number;
+/** 注册表里有哪些类型（调试 / 文档用）。 */
+export declare function designerTypeIds(): string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-entity-designer",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "An entity designer based on ice-render.",
   "repository": {
     "type": "git",
@@ -59,7 +59,7 @@
     "types:watch": "npm run types:check -- --watch"
   },
   "peerDependencies": {
-    "ice-render": "^2.19.0",
+    "ice-render": "^4.0.0",
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19"
   },
@@ -101,7 +101,7 @@
     "eslint-plugin-react-hooks": "4.6.0",
     "http-server": "14.1.1",
     "husky": "8.0.3",
-    "ice-render": "^2.19.0",
+    "ice-render": "^4.0.0",
     "jest": "29.7.0",
     "jest-environment-jsdom": "29.7.0",
     "lint-staged": "15.5.2",