ice-entity-designer-dsl, Changelog

Version history

1. v1.5.2LatestSep 22, 2026297de8b1430f

   1.5.2：运行时依赖引用跟版 —— ice-entity-designer ^0.12.2 + ice-render ^4.2.0（家族当前引擎 4.3.0）。0.x 的 caret 锁 minor，^0.11.0 吃不到 0.12.x：按旧引用装会把设计器顶回 0.11，把 0.12 的产物重建与 renderSubtreeTo 一起丢掉。

2. v1.5.1Sep 14, 20267263f7c6f67f

   1.5.1：补「哪些样式能写 $token」——设计器的节点 / 连线样式最终落在引擎图元上（节点可见形状是派生的 shapeComponent、标签是 ICEText、连线就是它自己），所以 fillColor: "$primary" / style.strokeStyle: "$danger" / style.label.fillStyle 都能引用主题 token；给出可用路径清单（$primary / $text / $border / $palette.<n> / $chrome.<组>.<键> / $base.<token>）与 validateDsl 的 ICE_DSL_THEME_TOKEN_UNKNOWN 诊断；并写清取舍：写 token 意味着颜色不固定在文档里、同一份文档在不同宿主主题下渲染不同，领域语义色仍应写字面量。

3. v1.5.0Sep 14, 20269244402a4b10

   1.5.0：补《主题与样式的边界》——领域语义色（电压等级 / 给排水介质 / UML / 状态机 / 甘特配色）留在文档里、不跟主题走；画布外壳（选中框 / 手柄 / 插槽 / 引导线 / 选区）与默认外观归宿主，设计器默认对齐 antd 并可用 ice.setChrome() / setTheme() 覆盖；样式值可引用主题 token（"$primary"，绘制时解析）。同时修正过期写法：分支标签颜色从 labelStyle.fillStyle 改为规范位置 style.label.fillStyle（老写法为弃用别名）。

4. v1.4.3Sep 13, 2026ba1e1c2bdc3e

   依赖引用对齐：ice-entity-designer-dsl@>=0.0.19，ice-entity-designer@^0.2.0 + ice-render@^2.0.0（家族当前引擎 2.2.0）

5. v1.4.2Sep 13, 2026f2010e1593a1

   ice-entity-designer 0.1.0 起改为 peer 共享 ice-render ^1.4.11，不再内联内核；浏览器端加载顺序改为 ice-render -> ice-entity-designer -> DSL。

6. v1.4.1Sep 12, 202698dd430f4c9d

   七个示例页新增「导出当前文档」按钮：改完图一键把实例写回左侧 JSON（toDsl 往返的可视化入口）；SKILL 补「生成 → 用户改 → 读回 → 增量更新」完整编排示例与四条纪律（不要重建文档、按 id 引用、增删规则、改完先校验再渲染）。

7. v1.4.0Sep 12, 202662bd583158f1

   新增 toDsl() 往返：渲染出的实例可把用户编辑（拖动/改名/开关分合/字段）写回同一份 DSL；id 与坐标保真、必过 validateDsl；七种 kind 均有测试兜底。同步 ice-entity-designer 0.0.40（建线路径透传 id）与 ice-entity-designer-dsl 0.0.16。

8. v1.3.9Sep 12, 202617dca6953957

   1.3.9：新增电力一次系统图文档 kind:'power'（设备 + 导体 + 母线 T 接 attachedTo；语义校验走 designer.validatePower）

9. v1.3.8Sep 12, 2026f2c08c5fd0a1

   1.3.8：状态机 PlantUML 与甘特 Mermaid 文本互操作（导出/导入），两个示例页可直接导出 .puml/.mmd

10. v1.3.7Sep 12, 2026336fcdbbe321

    1.3.7：编辑器示例页路径更新到 ice-entity-designer 的 examples/（示例页与单测目录拆分），无 API 变化

11. v1.3.6Sep 12, 202622bc373cdbee

    1.3.6：甘特关键路径口径写清楚（按尽早排归一化算浮时，有前置的任务由前置决定最早开工；手写很晚的末端日期不再让链路判定退化）

12. v1.3.5Sep 12, 202675ce8397d86a

    Gantt: resource field plus schedule-not-just-draw guidance (options.autoSchedule, criticalPath, resource-conflict validation). BPMN: how to demonstrate a process with the token simulator instead of hand-rolled timers.

13. v1.3.4Sep 12, 20269ad4a0d24d03

    Add the gantt document kind (kind: "gantt"): tasks with start/days/progress and finish-to-start dependencies, no coordinates (the axis is time), designer.validateGantt() cycle detection, dayWidth zoom, plus the anti-pattern list.

14. v1.3.3Sep 12, 2026943bc57467ab

    Add the statechart document kind (kind: "statechart"): initial/final pseudo-states, states, composite-state containers, transitions composed from event [guard] / action, left-to-right auto layering with composite auto-sizing, designer.validateStatechart() semantics, and the anti-pattern list.

15. v1.3.2Sep 12, 20263887b885faa9

    Add the UML class-diagram document kind (kind: "uml"): classes/interfaces/enums with free-text members, the six UML relation kinds and their direction convention, inheritance-driven auto layering, designer.validateUml() semantics, and PlantUML/Mermaid text interop.

16. v1.3.1Sep 12, 202681b5f8df6fce

    Add an SVG export section: when to export vector instead of screenshotting the canvas, the toSvg/exportSvgResult API and options (area/padding/scale/background/includeTools), server-side rendering via ICE.headless(), and the fidelity boundary (identical geometry/styles, glyph rasterisation may differ slightly).

17. v1.3.0Sep 12, 202682b886090292

    Add the BPMN 2.0 document kind (kind: "bpmn"): pools/lanes as containers linked by parent, container auto-geometry and container-scoped layered layout, the eight BPMN shapes and three flow types, designer.validateBpmn() semantic checks, and BPMN 2.0 XML interop (toBpmnXml / fromBpmnXml) with its scope and limits.

18. v1.2.4Sep 12, 202610b86197df0e

    Document the v2 flowchart document (engine payload) and reuse of the engine serialization mechanism (Serializer/Deserializer exports, hasDerivedChildren for composite components, state.data pass-through).

19. v1.2.3Sep 12, 2026c0cb1856230d

    Document the editable flowchart style props (textColor/fontSize, edge strokeStyle/lineWidth/labelStyle.fillStyle) and that they persist in snapshots.

20. v1.2.2Sep 12, 20267c8809ecaaa8

    Add flowchart editor guidance: imperative FlowDesigner API, React FlowDesignerCanvas/useFlowDesigner, and the canvas interaction contract (engine zoomAt, app-level pan, panel sync pitfalls).

21. v1.2.1Sep 12, 2026830034e1fd0f

    Zoom guidance now uses the engine primitive ICE.zoomAt() instead of hand-rolled screenToWorld math; panning documented as application-level.

22. v1.2.0Sep 12, 2026498758798821

    Add flowchart DSL: kind:flowchart documents with nodes/edges, four node kinds, labeled decision branches, and layered auto-layout when coordinates are omitted.

23. v1.1.0Sep 12, 2026f884bfc68f01

    Add interactive editor demo build guide and route demo/page requests to ice-entity-designer.

24. v1.0.2Sep 11, 20263b75e021ba40

    Align fitViewport and routeType options, add capability guide, relation cheat sheet, anti-patterns, and output checklist.

25. v1.0.1Sep 11, 202636598eac2cc0

    Expose supported platforms for Claude Code, Codex, Cursor, Copilot, Gemini, and other agents.

26. v1.0.0Sep 11, 202636598eac2cc0

    No changelog provided.