ice-entity-designer 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -1
- package/dist/index.cjs +1 -1
- package/dist/index.mjs +1 -1
- package/dist/index.umd.js +1 -1
- package/dist/react.cjs +1 -1
- package/dist/react.mjs +1 -1
- package/dist/types/bpmn/BpmnSimulator.d.mts +1 -1
- package/dist/types/bpmn/BpmnSimulator.d.ts +1 -1
- package/dist/types/bpmn/bpmn_shapes.d.mts +8 -8
- package/dist/types/bpmn/bpmn_shapes.d.ts +8 -8
- package/dist/types/er-component/Entity.d.mts +1 -1
- package/dist/types/er-component/Entity.d.ts +1 -1
- package/dist/types/er-component/Relation.d.mts +1 -1
- package/dist/types/er-component/Relation.d.ts +1 -1
- package/dist/types/flow/FlowNode.d.mts +1 -1
- package/dist/types/flow/FlowNode.d.ts +1 -1
- package/dist/types/flow/flow_shapes.d.mts +2 -2
- package/dist/types/flow/flow_shapes.d.ts +2 -2
- package/dist/types/gantt/GanttDependency.d.mts +1 -1
- package/dist/types/gantt/GanttDependency.d.ts +1 -1
- package/dist/types/gantt/GanttRuler.d.mts +1 -1
- package/dist/types/gantt/GanttRuler.d.ts +1 -1
- package/dist/types/gantt/GanttTask.d.mts +1 -1
- package/dist/types/gantt/GanttTask.d.ts +1 -1
- package/dist/types/power/PowerDesigner.d.mts +1 -1
- package/dist/types/power/PowerDesigner.d.ts +1 -1
- package/dist/types/power/power_shapes.d.mts +1 -1
- package/dist/types/power/power_shapes.d.ts +1 -1
- package/dist/types/secondary/SecondaryDesigner.d.mts +1 -1
- package/dist/types/secondary/SecondaryDesigner.d.ts +1 -1
- package/dist/types/secondary/secondary_shapes.d.mts +2 -2
- package/dist/types/secondary/secondary_shapes.d.ts +2 -2
- package/dist/types/statechart/StateNode.d.mts +1 -1
- package/dist/types/statechart/StateNode.d.ts +1 -1
- package/dist/types/statechart/StateTransition.d.mts +1 -1
- package/dist/types/statechart/StateTransition.d.ts +1 -1
- package/dist/types/uml/UmlClass.d.mts +1 -1
- package/dist/types/uml/UmlClass.d.ts +1 -1
- package/dist/types/uml/UmlRelation.d.mts +1 -1
- package/dist/types/uml/UmlRelation.d.ts +1 -1
- package/dist/types/utils/component_type_util.d.mts +4 -0
- package/dist/types/utils/component_type_util.d.ts +4 -0
- package/dist/types/utils/type-registry.d.mts +11 -0
- package/dist/types/utils/type-registry.d.ts +11 -0
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -213,6 +213,12 @@ designer.undo();
|
|
|
213
213
|
#### 5.1 项目快照契约
|
|
214
214
|
|
|
215
215
|
- 快照带 `schemaVersion`（当前 `1`）与每个节点的 `typeId`；载入时**按 `typeId` 分派构造函数**（走 ICE 注册表，下游 `ice.registerType()` 注册的领域图元同样可载入）。旧快照没有 `typeId` 时，按所在数组归位（`entities[]` → `Entity`，`relations[]` → `Relation`）。
|
|
216
|
+
- **`typeId` 一律是 `namespace:Type` 格式**（2026-09-13 起）：本包的领域图元统一用 `ice-entity-designer:*`
|
|
217
|
+
（`ice-entity-designer:Entity`、`ice-entity-designer:FlowNode`、`ice-entity-designer:GanttTask`…），
|
|
218
|
+
与引擎内置的 `ice-render:*`、图表的 `ice-chart:*` 分属不同命名空间，因此**跨包不会撞名**。
|
|
219
|
+
注册走 `registerIEDType()`（`src/utils/type-registry.ts`）；**不做旧名兼容**（家族仍在发布初期），
|
|
220
|
+
旧快照里的 `Entity`、`FlowNode` 之类无 namespace 值会被当作未注册类型跳过并记入 `report.unknownTypes`。
|
|
221
|
+
判型不要拿字面量与 `typeId` 比：用 `x instanceof FlowNode` 或 `selected.constructor.typeId === FlowNode.typeId`。
|
|
216
222
|
- **容错加载**：遇到未注册的 `typeId` 只跳过该节点并记录（`report.unknownTypes` / `report.skipped`），不会让整份数据打不开——与引擎 `Deserializer` 的语义一致。
|
|
217
223
|
- **自洽保证**：`serializeProject()` 的产物永远能通过 `loadProject()` 的结构校验（结构契约见 `src/utils/project-snapshot.schema.json`）；载入失败时当前项目与 `undo`/`redo` 栈都不会被改动。
|
|
218
224
|
- **唯一字段定义**：快照写什么、校验查什么，都由 `src/utils/project_codec.ts` 的一份定义驱动（不再 snapshot 一份、validator 一份）。新增 state 字段却忘了登记时，`tests/designer/codec-completeness.test.ts` 会以「未覆盖的 state 键」直接报红。
|
|
@@ -686,7 +692,7 @@ React 里可沿用 `createFlowSession` 的模式自建一层封装。
|
|
|
686
692
|
| 连线 | 引擎折线（插槽吸附 / 正交·贝塞尔路由 / 标签 / 跟随宿主）；**端点标记进路径点集**，因此描边、填充、导出都自动带上 | `UmlRelation`：六种关系 = 线型 + 三角/菱形/开放箭头 |
|
|
687
693
|
| 应用层 | `FlowDesigner`（选择 / 增删改 / 连线 / 撤销重做 / 快照 / 适应视图 / 订阅 / `toSvg`） | `UmlDesigner` 只重写「建什么图元 + 类型过滤」 |
|
|
688
694
|
| 语义校验 | 结构校验之外的部分自写，规则直白 | `validateUml()`：重名类 / 悬空关系 / 继承成环 |
|
|
689
|
-
| 文档格式 |
|
|
695
|
+
| 文档格式 | 引擎序列化（`namespace:Type` 的 typeId 注册表 + `hasDerivedChildren`），零登记 | 类与关系统统自动往返 |
|
|
690
696
|
| 互操作 | 有标准格式的域就做 | BPMN 2.0 XML（导入 + 导出，含 BPMNDI 布局）；UML 类图与状态机的 PlantUML 文本互操作；甘特的 Mermaid gantt 文本互操作 |
|
|
691
697
|
| 交付物 | 示例页 + e2e + README + （可选）JSON DSL 与技能 | `examples/uml-editor.html` + `e2e/uml-editor.spec.ts` |
|
|
692
698
|
|