ice-entity-designer-dsl 0.0.3 → 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 大漠穷秋
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,14 +1,20 @@
 # ice-entity-designer-dsl
 
-JSON-first ER DSL for AI agents to drive `ice-entity-designer` without learning the imperative canvas API.
+JSON-first DSL for AI agents to drive `ice-entity-designer` without learning the imperative canvas API.
+
+One document kind, two shapes:
+
+- **ER document** (`entities` / `relations`): entity-relation models and database schemas.
+- **Flowchart document** (`kind: "flowchart"` with `nodes` / `edges`): process flows,
+  decision trees, and algorithms, with optional coordinates (layered auto-layout).
 
 The package contains:
 
-- DSL types and schema
+- DSL types and schema (ER + flowchart)
 - structural validator
-- compiler from DSL to Entity/Relation props
+- compilers from DSL to Entity/Relation or FlowNode/FlowEdge props
 - browser runtime that renders DSL through `ice-entity-designer`
-- browser example with a JSON editor
+- browser examples with a JSON editor (`examples/entity-editor-dsl.html`, `examples/flowchart-dsl.html`)
 
 ## Install
 
@@ -44,19 +50,51 @@ npm run build
 ## Node/ESM usage
 
 ```ts
-import { validateDsl, compileDsl, renderDsl } from 'ice-render-dsl';
+import { validateDsl, compileDsl, compileFlowDsl, renderDsl } from 'ice-entity-designer-dsl';
 ```
 
+## Flowchart usage
+
+Node coordinates are optional: if any node omits `left`/`top`, the whole graph is laid
+out in layers (layer 0 = nodes without incoming edges; every other node = max
+predecessor layer + 1).
+
+```js
+const flowchart = {
+  schemaVersion: 1,
+  kind: 'flowchart',
+  nodes: [
+    { id: 'start', kind: 'terminator', title: '开始' },
+    { id: 'check', kind: 'decision', title: '库存充足？' },
+    { id: 'done', kind: 'terminator', title: '结束' },
+    { id: 'restock', kind: 'io', title: '通知补货' },
+  ],
+  edges: [
+    { source: 'start', target: 'check' },
+    { source: 'check', target: 'done', label: '是' },
+    { source: 'check', target: 'restock', label: '否', sourcePort: 'R', targetPort: 'L' },
+  ],
+};
+
+// kind === 'flowchart' 时 result.designer 是 FlowDesigner（createNode / createEdge / undo / …）
+const result = ICEDSL.renderDsl('canvas', flowchart);
+```
+
+Node kinds: `terminator` (start/end pill) / `process` (action, default) / `decision`
+(diamond) / `io` (parallelogram). Edge ports are `T` / `R` / `B` / `L` / `C` (default
+`B` → `T`); `linkShape` is `visio` (orthogonal, default) or `bezier`.
+
 ## API
 
-- `validateDsl(dsl)`
-- `compileDsl(dsl)`
-- `renderDsl(canvasOrId, dsl)`
+- `validateDsl(dsl)` —— ER / flowchart documents (dispatches on `kind`); `validateFlowDsl(dsl)` for flowcharts only
+- `compileDsl(dsl)` —— ER document → `Entity` / `Relation` props
+- `compileFlowDsl(dsl)` —— flowchart document → `FlowNode` / `FlowEdge` props (with layered auto-layout)
+- `renderDsl(canvasOrId, dsl)` —— renders either kind, returns `{ kind, ice, designer }`
 - `DSL_SCHEMA_VERSION`
 
 ## Example
 
-Open `examples/entity-editor-dsl.html` after building.
+Open `examples/entity-editor-dsl.html` (ER) or `examples/flowchart-dsl.html` (flowchart) after building.
 
 ## Agent discovery
 
@@ -64,7 +102,7 @@ Agents can use this project through:
 
 1. npm package exports
 2. `AGENTS.md`
-3. `skills/ice-render-dsl/SKILL.md`
+3. `skills/ice-entity-designer-dsl/SKILL.md`
 4. optional MCP wrapper in a separate package
 
 The core runtime does not require MCP.

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("ice-entity-designer");function validateDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};if(void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion),Array.isArray(e.entities)){const i=new Set;e.entities.forEach((e,r)=>{const n=`entities[${r}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${n}.id is duplicated: ${e.id}`):i.add(e.id):t.push(n+".id must be a non-empty string"),Array.isArray(e.fields)?e.fields.forEach((e,i)=>{e&&"object"==typeof e&&"string"==typeof e.name&&e.name.trim()||t.push(`${n}.fields[${i}].name must be a non-empty string`)}):t.push(n+".fields must be an array")):t.push(n+" must be an object")})}else t.push("entities must be an array");return void 0===e.relations||Array.isArray(e.relations)?(e.relations||[]).forEach((e,i)=>{const r=`relations[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()||t.push(r+".source must be a non-empty string"),"string"==typeof e.target&&e.target.trim()||t.push(r+".target must be a non-empty string")):t.push(r+" must be an object")}):t.push("relations must be an array"),{valid:0===t.length,errors:t}}function entityName(e){return e.entityName||e.name||e.id}function relationType(e){return e.relationType||e.type||"one-to-many"}function compileDsl(e){return{entities:e.entities.map(e=>({id:e.id,entityName:entityName(e),fields:e.fields||[],left:e.left,top:e.top,width:e.width,height:e.height,style:e.style,headerStyle:e.headerStyle,fieldStyle:e.fieldStyle,dividerStyle:e.dividerStyle,draggable:e.draggable,interactive:e.interactive})),relations:(e.relations||[]).map((e,t)=>({id:e.id||"relation-"+t,relationType:relationType(e),sourceId:e.source,targetId:e.target,sourceField:e.sourceField||"id",targetField:e.targetField||"id",nullable:e.nullable,onDelete:e.onDelete,onUpdate:e.onUpdate,joinTableName:e.joinTableName,fromKey:e.fromKey,toKey:e.toKey,sourceCardinality:e.sourceCardinality,targetCardinality:e.targetCardinality,label:e.label,style:e.style,arrow:e.arrow,linkShape:e.linkShape,routeType:e.routeType,routeOffset:e.routeOffset,curveType:e.curveType,lineDash:e.lineDash})),layout:e.layout,options:e.options}}exports.DSL_SCHEMA_VERSION=1,exports.compileDsl=compileDsl,exports.renderDsl=function renderDsl(t,i){const r=validateDsl(i);if(!r.valid)throw new Error(r.errors.join("\n"));const n=compileDsl(i),a=n.options||{},o=(new e.ICE).init(t),s=new e.EntityDesigner(o);return n.entities.forEach(e=>{s.createEntity(e)}),function positionLinks(e,t,i){const r=new Map;return e.entities.forEach(e=>{r.set(e.state.id,e.getMinBoundingBox(!0))}),t.relations.map(e=>{const t=r.get(e.sourceId),n=r.get(e.targetId);let a="R",o="L";if(t&&n){const e=n.center[0]-t.center[0],i=n.center[1]-t.center[1];Math.abs(e)>Math.abs(i)?(a=e>=0?"R":"L",o=e>=0?"L":"R"):(a=i>=0?"B":"T",o=i>=0?"T":"B")}return{...e,routeType:e.routeType||i||"orthogonal",linkShape:e.linkShape||"visio",links:{start:{id:e.sourceId,position:a},end:{id:e.targetId,position:o}}}})}(s,n,a.routeType).forEach(e=>{s.createRelation(e)}),"layered"!==n.layout&&"horizontal"!==n.layout||new e.ICELayeredLayout({gapX:a.gapX||120,gapY:a.gapY||50}).layoutContainer(o),a.viewport?o.setViewport(a.viewport.scale,a.viewport.tx,a.viewport.ty):a.fitViewport&&function fitViewport(e,t,i){const r=t.entities||[];let n=1/0,a=1/0,o=-1/0,s=-1/0;r.forEach(e=>{const t=e.getMinBoundingBox(!0).getMinAndMaxPoint();n=Math.min(n,t.minX),a=Math.min(a,t.minY),o=Math.max(o,t.maxX),s=Math.max(s,t.maxY)});const l=o-n,d=s-a,p=e.canvasWidth||0,u=e.canvasHeight||0;if(!p||!u||l<=0||d<=0)return;const c=Number.isFinite(i)&&i>=0?i:40,y=Math.max(1,p-2*c),m=Math.max(1,u-2*c),h=Math.min(y/l,m/d,1),f=(p-l*h)/2-n*h,g=(u-d*h)/2-a*h;e.setViewport(h,f,g)}(o,s,a.fitViewportPadding),{ice:o,designer:s}},exports.validateDsl=validateDsl;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("ice-entity-designer");function isFlowDsl(e){return!!e&&"object"==typeof e&&"flowchart"===e.kind}const t=["terminator","process","decision","io"],i=["T","R","B","L","C"];function validateDsl(e){return isFlowDsl(e)?validateFlowDsl(e):function validateErDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion);if(Array.isArray(e.entities)){const i=new Set;e.entities.forEach((e,o)=>{const r=`entities[${o}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${r}.id is duplicated: ${e.id}`):i.add(e.id):t.push(r+".id must be a non-empty string"),Array.isArray(e.fields)?e.fields.forEach((e,i)=>{e&&"object"==typeof e&&"string"==typeof e.name&&e.name.trim()||t.push(`${r}.fields[${i}].name must be a non-empty string`)}):t.push(r+".fields must be an array")):t.push(r+" must be an object")})}else t.push("entities must be an array");void 0===e.relations||Array.isArray(e.relations)?(e.relations||[]).forEach((e,i)=>{const o=`relations[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()||t.push(o+".source must be a non-empty string"),"string"==typeof e.target&&e.target.trim()||t.push(o+".target must be a non-empty string")):t.push(o+" must be an object")}):t.push("relations must be an array");return{valid:0===t.length,errors:t}}(e)}function validateFlowDsl(e){const o=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};void 0!==e.schemaVersion&&1!==e.schemaVersion&&o.push("Unsupported schemaVersion: "+e.schemaVersion);const r=new Set;return Array.isArray(e.nodes)?e.nodes.forEach((e,i)=>{const s=`nodes[${i}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?r.has(e.id)?o.push(`${s}.id is duplicated: ${e.id}`):r.add(e.id):o.push(s+".id must be a non-empty string"),void 0!==e.kind&&-1===t.indexOf(e.kind)&&o.push(`${s}.kind must be one of ${t.join("/")}`),["left","top","width","height"].forEach(t=>{const i=e[t];void 0!==i&&"number"!=typeof i&&o.push(`${s}.${t} must be a number when present`)})):o.push(s+" must be an object")}):o.push("nodes must be an array"),void 0===e.edges||Array.isArray(e.edges)?(e.edges||[]).forEach((e,t)=>{const s=`edges[${t}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()&&r.has(e.source)||o.push(s+".source must reference an existing node id"),"string"==typeof e.target&&e.target.trim()&&r.has(e.target)||o.push(s+".target must reference an existing node id"),void 0!==e.label&&"string"!=typeof e.label&&o.push(s+".label must be a string when present"),void 0!==e.sourcePort&&-1===i.indexOf(e.sourcePort)&&o.push(`${s}.sourcePort must be one of ${i.join("/")}`),void 0!==e.targetPort&&-1===i.indexOf(e.targetPort)&&o.push(`${s}.targetPort must be one of ${i.join("/")}`),void 0!==e.linkShape&&"visio"!==e.linkShape&&"bezier"!==e.linkShape&&o.push(s+'.linkShape must be "visio" or "bezier" when present')):o.push(s+" must be an object")}):o.push("edges must be an array when present"),{valid:0===o.length,errors:o}}function entityName(e){return e.entityName||e.name||e.id}function relationType(e){return e.relationType||e.type||"one-to-many"}function compileDsl(e){if(isFlowDsl(e))throw new Error("compileDsl() 只处理 ER 文档；流程图文档请使用 compileFlowDsl()");if(!e||!Array.isArray(e.entities))throw new Error("ER 文档必须包含 entities 数组");return{entities:e.entities.map(e=>({id:e.id,entityName:entityName(e),fields:e.fields||[],left:e.left,top:e.top,width:e.width,height:e.height,style:e.style,headerStyle:e.headerStyle,fieldStyle:e.fieldStyle,dividerStyle:e.dividerStyle,draggable:e.draggable,interactive:e.interactive})),relations:(e.relations||[]).map((e,t)=>({id:e.id||"relation-"+t,relationType:relationType(e),sourceId:e.source,targetId:e.target,sourceField:e.sourceField||"id",targetField:e.targetField||"id",nullable:e.nullable,onDelete:e.onDelete,onUpdate:e.onUpdate,joinTableName:e.joinTableName,fromKey:e.fromKey,toKey:e.toKey,sourceCardinality:e.sourceCardinality,targetCardinality:e.targetCardinality,label:e.label,style:e.style,arrow:e.arrow,linkShape:e.linkShape,routeType:e.routeType,routeOffset:e.routeOffset,curveType:e.curveType,lineDash:e.lineDash})),layout:e.layout,options:e.options}}const o={terminator:{width:e.FLOW_NODE_KINDS.terminator.width,height:e.FLOW_NODE_KINDS.terminator.height,fill:e.FLOW_NODE_KINDS.terminator.fill,stroke:e.FLOW_NODE_KINDS.terminator.stroke},process:{width:e.FLOW_NODE_KINDS.process.width,height:e.FLOW_NODE_KINDS.process.height,fill:e.FLOW_NODE_KINDS.process.fill,stroke:e.FLOW_NODE_KINDS.process.stroke},decision:{width:e.FLOW_NODE_KINDS.decision.width,height:e.FLOW_NODE_KINDS.decision.height,fill:e.FLOW_NODE_KINDS.decision.fill,stroke:e.FLOW_NODE_KINDS.decision.stroke},io:{width:e.FLOW_NODE_KINDS.io.width,height:e.FLOW_NODE_KINDS.io.height,fill:e.FLOW_NODE_KINDS.io.fill,stroke:e.FLOW_NODE_KINDS.io.stroke}};function compileFlowDsl(e){const t=e.options||{},i=(e.nodes||[]).map(e=>{const t=function nodeKind(e){return e.kind&&o[e.kind]?e.kind:"process"}(e),i=o[t];return{id:e.id,typeId:"FlowNode",kind:t,title:(r=e,r.title||r.name||r.id),left:"number"==typeof e.left?e.left:Number.NaN,top:"number"==typeof e.top?e.top:Number.NaN,width:"number"==typeof e.width?e.width:i.width,height:"number"==typeof e.height?e.height:i.height,fillColor:e.fillColor||i.fill,strokeColor:e.strokeColor||i.stroke};var r}),r=(e.edges||[]).map((e,t)=>({id:e.id||"edge-"+t,sourceId:e.source,targetId:e.target,sourcePort:e.sourcePort||"B",targetPort:e.targetPort||"T",label:e.label||"",linkShape:e.linkShape||"visio"})),s=t.layout||"layered";return"none"!==s&&i.some(e=>Number.isNaN(e.left)||Number.isNaN(e.top))&&(i.forEach(e=>{Number.isNaN(e.left)&&(e.left=0),Number.isNaN(e.top)&&(e.top=0)}),function autoLayout(e,t,i,o){const r=new Map;e.forEach(e=>r.set(e.id,e));const s=new Map,n=new Map;e.forEach(e=>{s.set(e.id,0),n.set(e.id,[])}),t.forEach(e=>{r.has(e.sourceId)&&r.has(e.targetId)&&(s.set(e.targetId,(s.get(e.targetId)||0)+1),n.get(e.sourceId).push(e.targetId))});const a=new Map,l=[];e.forEach(e=>{0===(s.get(e.id)||0)&&(a.set(e.id,0),l.push(e.id))}),!l.length&&e.length&&(a.set(e[0].id,0),l.push(e[0].id));let d=e.length*e.length+e.length;for(;l.length&&d-- >0;){const e=l.shift(),t=a.get(e)||0;(n.get(e)||[]).forEach(e=>{const i=t+1;(a.get(e)??-1)<i&&(a.set(e,i),l.push(e))})}e.forEach(e=>{a.has(e.id)||a.set(e.id,0)});const p=new Map;e.forEach(e=>{const t=a.get(e.id)||0;p.has(t)||p.set(t,[]),p.get(t).push(e)});const h=[...p.keys()].sort((e,t)=>e-t),c=h.map(e=>Math.max(...p.get(e).map(e=>e.height)));c.reduce((e,t)=>e+t,0),Math.max(h.length-1,0);let u=0;h.forEach((e,t)=>{const r=p.get(e);let s=-(r.reduce((e,t)=>e+t.width,0)+Math.max(r.length-1,0)*i)/2;r.forEach(e=>{e.left=Math.round(s),e.top=Math.round(u+(c[t]-e.height)/2),s+=e.width+i}),u+=c[t]+o});const f=Math.min(...e.map(e=>e.left)),m=Math.min(...e.map(e=>e.top));e.forEach(e=>{e.left+=80-f,e.top+=80-m})}(i,r,Number(t.gapX)||90,Number(t.gapY)||90)),i.forEach(e=>{Number.isNaN(e.left)&&(e.left=0),Number.isNaN(e.top)&&(e.top=0)}),{kind:"flowchart",nodes:i,edges:r,layout:s,options:t}}function renderFlowDsl(t,i){const o=compileFlowDsl(i),r=o.options||{},s=(new e.ICE).init(t),n=new e.FlowDesigner(s);return o.nodes.forEach(e=>{n.createNode(e.kind,e)}),o.edges.forEach(e=>{n.createEdge(e)}),n.select(null),r.viewport?s.setViewport(r.viewport.scale,r.viewport.tx,r.viewport.ty):!1!==r.fitViewport&&n.fitViewport(r.fitViewportPadding),n.resetHistory(),{kind:"flowchart",ice:s,designer:n}}exports.DSL_SCHEMA_VERSION=1,exports.compileDsl=compileDsl,exports.compileFlowDsl=compileFlowDsl,exports.isFlowDsl=isFlowDsl,exports.renderDsl=function renderDsl(t,i){const o=validateDsl(i);if(!o.valid)throw new Error(o.errors.join("\n"));return isFlowDsl(i)?renderFlowDsl(t,i):function renderErDsl(t,i){const o=compileDsl(i),r=o.options||{},s=(new e.ICE).init(t),n=new e.EntityDesigner(s);o.entities.forEach(e=>{n.createEntity(e)}),function positionLinks(e,t,i){const o=new Map;return e.entities.forEach(e=>{o.set(e.state.id,e.getMinBoundingBox(!0))}),t.relations.map(e=>{const t=o.get(e.sourceId),r=o.get(e.targetId);let s="R",n="L";if(t&&r){const e=r.center[0]-t.center[0],i=r.center[1]-t.center[1];Math.abs(e)>Math.abs(i)?(s=e>=0?"R":"L",n=e>=0?"L":"R"):(s=i>=0?"B":"T",n=i>=0?"T":"B")}return{...e,routeType:e.routeType||i||"orthogonal",linkShape:e.linkShape||"visio",links:{start:{id:e.sourceId,position:s},end:{id:e.targetId,position:n}}}})}(n,o,r.routeType).forEach(e=>{n.createRelation(e)}),("layered"===o.layout||"horizontal"===o.layout)&&new e.ICELayeredLayout({gapX:r.gapX||120,gapY:r.gapY||50}).layoutContainer(s);r.viewport?s.setViewport(r.viewport.scale,r.viewport.tx,r.viewport.ty):r.fitViewport&&function fitViewport(e,t,i){const o=t.entities||[];let r=1/0,s=1/0,n=-1/0,a=-1/0;o.forEach(e=>{const t=e.getMinBoundingBox(!0).getMinAndMaxPoint();r=Math.min(r,t.minX),s=Math.min(s,t.minY),n=Math.max(n,t.maxX),a=Math.max(a,t.maxY)});const l=n-r,d=a-s,p=e.canvasWidth||0,h=e.canvasHeight||0;if(!p||!h||l<=0||d<=0)return;const c=Number.isFinite(i)&&i>=0?i:40,u=Math.max(1,p-2*c),f=Math.max(1,h-2*c),m=Math.min(u/l,f/d,1),g=(p-l*m)/2-r*m,y=(h-d*m)/2-s*m;e.setViewport(m,g,y)}(s,n,r.fitViewportPadding);return{kind:"entity",ice:s,designer:n}}(t,i)},exports.renderFlowDsl=renderFlowDsl,exports.validateDsl=validateDsl,exports.validateFlowDsl=validateFlowDsl;

package/dist/index.mjs

@@ -1 +1 @@
-import{ICE as e,EntityDesigner as t,ICELayeredLayout as i}from"ice-entity-designer";const r=1;function validateDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};if(void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion),Array.isArray(e.entities)){const i=new Set;e.entities.forEach((e,r)=>{const n=`entities[${r}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${n}.id is duplicated: ${e.id}`):i.add(e.id):t.push(n+".id must be a non-empty string"),Array.isArray(e.fields)?e.fields.forEach((e,i)=>{e&&"object"==typeof e&&"string"==typeof e.name&&e.name.trim()||t.push(`${n}.fields[${i}].name must be a non-empty string`)}):t.push(n+".fields must be an array")):t.push(n+" must be an object")})}else t.push("entities must be an array");return void 0===e.relations||Array.isArray(e.relations)?(e.relations||[]).forEach((e,i)=>{const r=`relations[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()||t.push(r+".source must be a non-empty string"),"string"==typeof e.target&&e.target.trim()||t.push(r+".target must be a non-empty string")):t.push(r+" must be an object")}):t.push("relations must be an array"),{valid:0===t.length,errors:t}}function entityName(e){return e.entityName||e.name||e.id}function relationType(e){return e.relationType||e.type||"one-to-many"}function compileDsl(e){return{entities:e.entities.map(e=>({id:e.id,entityName:entityName(e),fields:e.fields||[],left:e.left,top:e.top,width:e.width,height:e.height,style:e.style,headerStyle:e.headerStyle,fieldStyle:e.fieldStyle,dividerStyle:e.dividerStyle,draggable:e.draggable,interactive:e.interactive})),relations:(e.relations||[]).map((e,t)=>({id:e.id||"relation-"+t,relationType:relationType(e),sourceId:e.source,targetId:e.target,sourceField:e.sourceField||"id",targetField:e.targetField||"id",nullable:e.nullable,onDelete:e.onDelete,onUpdate:e.onUpdate,joinTableName:e.joinTableName,fromKey:e.fromKey,toKey:e.toKey,sourceCardinality:e.sourceCardinality,targetCardinality:e.targetCardinality,label:e.label,style:e.style,arrow:e.arrow,linkShape:e.linkShape,routeType:e.routeType,routeOffset:e.routeOffset,curveType:e.curveType,lineDash:e.lineDash})),layout:e.layout,options:e.options}}function renderDsl(r,n){const a=validateDsl(n);if(!a.valid)throw new Error(a.errors.join("\n"));const o=compileDsl(n),s=o.options||{},l=(new e).init(r),d=new t(l);return o.entities.forEach(e=>{d.createEntity(e)}),function positionLinks(e,t,i){const r=new Map;return e.entities.forEach(e=>{r.set(e.state.id,e.getMinBoundingBox(!0))}),t.relations.map(e=>{const t=r.get(e.sourceId),n=r.get(e.targetId);let a="R",o="L";if(t&&n){const e=n.center[0]-t.center[0],i=n.center[1]-t.center[1];Math.abs(e)>Math.abs(i)?(a=e>=0?"R":"L",o=e>=0?"L":"R"):(a=i>=0?"B":"T",o=i>=0?"T":"B")}return{...e,routeType:e.routeType||i||"orthogonal",linkShape:e.linkShape||"visio",links:{start:{id:e.sourceId,position:a},end:{id:e.targetId,position:o}}}})}(d,o,s.routeType).forEach(e=>{d.createRelation(e)}),"layered"!==o.layout&&"horizontal"!==o.layout||new i({gapX:s.gapX||120,gapY:s.gapY||50}).layoutContainer(l),s.viewport?l.setViewport(s.viewport.scale,s.viewport.tx,s.viewport.ty):s.fitViewport&&function fitViewport(e,t,i){const r=t.entities||[];let n=1/0,a=1/0,o=-1/0,s=-1/0;r.forEach(e=>{const t=e.getMinBoundingBox(!0).getMinAndMaxPoint();n=Math.min(n,t.minX),a=Math.min(a,t.minY),o=Math.max(o,t.maxX),s=Math.max(s,t.maxY)});const l=o-n,d=s-a,p=e.canvasWidth||0,c=e.canvasHeight||0;if(!p||!c||l<=0||d<=0)return;const u=Number.isFinite(i)&&i>=0?i:40,y=Math.max(1,p-2*u),m=Math.max(1,c-2*u),h=Math.min(y/l,m/d,1),f=(p-l*h)/2-n*h,g=(c-d*h)/2-a*h;e.setViewport(h,f,g)}(l,d,s.fitViewportPadding),{ice:l,designer:d}}export{r as DSL_SCHEMA_VERSION,compileDsl,renderDsl,validateDsl};
+import{FLOW_NODE_KINDS as e,ICE as t,FlowDesigner as i,EntityDesigner as o,ICELayeredLayout as r}from"ice-entity-designer";function isFlowDsl(e){return!!e&&"object"==typeof e&&"flowchart"===e.kind}const n=1,s=["terminator","process","decision","io"],a=["T","R","B","L","C"];function validateDsl(e){return isFlowDsl(e)?validateFlowDsl(e):function validateErDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion);if(Array.isArray(e.entities)){const i=new Set;e.entities.forEach((e,o)=>{const r=`entities[${o}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${r}.id is duplicated: ${e.id}`):i.add(e.id):t.push(r+".id must be a non-empty string"),Array.isArray(e.fields)?e.fields.forEach((e,i)=>{e&&"object"==typeof e&&"string"==typeof e.name&&e.name.trim()||t.push(`${r}.fields[${i}].name must be a non-empty string`)}):t.push(r+".fields must be an array")):t.push(r+" must be an object")})}else t.push("entities must be an array");void 0===e.relations||Array.isArray(e.relations)?(e.relations||[]).forEach((e,i)=>{const o=`relations[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()||t.push(o+".source must be a non-empty string"),"string"==typeof e.target&&e.target.trim()||t.push(o+".target must be a non-empty string")):t.push(o+" must be an object")}):t.push("relations must be an array");return{valid:0===t.length,errors:t}}(e)}function validateFlowDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion);const i=new Set;return Array.isArray(e.nodes)?e.nodes.forEach((e,o)=>{const r=`nodes[${o}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${r}.id is duplicated: ${e.id}`):i.add(e.id):t.push(r+".id must be a non-empty string"),void 0!==e.kind&&-1===s.indexOf(e.kind)&&t.push(`${r}.kind must be one of ${s.join("/")}`),["left","top","width","height"].forEach(i=>{const o=e[i];void 0!==o&&"number"!=typeof o&&t.push(`${r}.${i} must be a number when present`)})):t.push(r+" must be an object")}):t.push("nodes must be an array"),void 0===e.edges||Array.isArray(e.edges)?(e.edges||[]).forEach((e,o)=>{const r=`edges[${o}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()&&i.has(e.source)||t.push(r+".source must reference an existing node id"),"string"==typeof e.target&&e.target.trim()&&i.has(e.target)||t.push(r+".target must reference an existing node id"),void 0!==e.label&&"string"!=typeof e.label&&t.push(r+".label must be a string when present"),void 0!==e.sourcePort&&-1===a.indexOf(e.sourcePort)&&t.push(`${r}.sourcePort must be one of ${a.join("/")}`),void 0!==e.targetPort&&-1===a.indexOf(e.targetPort)&&t.push(`${r}.targetPort must be one of ${a.join("/")}`),void 0!==e.linkShape&&"visio"!==e.linkShape&&"bezier"!==e.linkShape&&t.push(r+'.linkShape must be "visio" or "bezier" when present')):t.push(r+" must be an object")}):t.push("edges must be an array when present"),{valid:0===t.length,errors:t}}function entityName(e){return e.entityName||e.name||e.id}function relationType(e){return e.relationType||e.type||"one-to-many"}function compileDsl(e){if(isFlowDsl(e))throw new Error("compileDsl() 只处理 ER 文档；流程图文档请使用 compileFlowDsl()");if(!e||!Array.isArray(e.entities))throw new Error("ER 文档必须包含 entities 数组");return{entities:e.entities.map(e=>({id:e.id,entityName:entityName(e),fields:e.fields||[],left:e.left,top:e.top,width:e.width,height:e.height,style:e.style,headerStyle:e.headerStyle,fieldStyle:e.fieldStyle,dividerStyle:e.dividerStyle,draggable:e.draggable,interactive:e.interactive})),relations:(e.relations||[]).map((e,t)=>({id:e.id||"relation-"+t,relationType:relationType(e),sourceId:e.source,targetId:e.target,sourceField:e.sourceField||"id",targetField:e.targetField||"id",nullable:e.nullable,onDelete:e.onDelete,onUpdate:e.onUpdate,joinTableName:e.joinTableName,fromKey:e.fromKey,toKey:e.toKey,sourceCardinality:e.sourceCardinality,targetCardinality:e.targetCardinality,label:e.label,style:e.style,arrow:e.arrow,linkShape:e.linkShape,routeType:e.routeType,routeOffset:e.routeOffset,curveType:e.curveType,lineDash:e.lineDash})),layout:e.layout,options:e.options}}const l={terminator:{width:e.terminator.width,height:e.terminator.height,fill:e.terminator.fill,stroke:e.terminator.stroke},process:{width:e.process.width,height:e.process.height,fill:e.process.fill,stroke:e.process.stroke},decision:{width:e.decision.width,height:e.decision.height,fill:e.decision.fill,stroke:e.decision.stroke},io:{width:e.io.width,height:e.io.height,fill:e.io.fill,stroke:e.io.stroke}};function compileFlowDsl(e){const t=e.options||{},i=(e.nodes||[]).map(e=>{const t=function nodeKind(e){return e.kind&&l[e.kind]?e.kind:"process"}(e),i=l[t];return{id:e.id,typeId:"FlowNode",kind:t,title:(o=e,o.title||o.name||o.id),left:"number"==typeof e.left?e.left:Number.NaN,top:"number"==typeof e.top?e.top:Number.NaN,width:"number"==typeof e.width?e.width:i.width,height:"number"==typeof e.height?e.height:i.height,fillColor:e.fillColor||i.fill,strokeColor:e.strokeColor||i.stroke};var o}),o=(e.edges||[]).map((e,t)=>({id:e.id||"edge-"+t,sourceId:e.source,targetId:e.target,sourcePort:e.sourcePort||"B",targetPort:e.targetPort||"T",label:e.label||"",linkShape:e.linkShape||"visio"})),r=t.layout||"layered";return"none"!==r&&i.some(e=>Number.isNaN(e.left)||Number.isNaN(e.top))&&(i.forEach(e=>{Number.isNaN(e.left)&&(e.left=0),Number.isNaN(e.top)&&(e.top=0)}),function autoLayout(e,t,i,o){const r=new Map;e.forEach(e=>r.set(e.id,e));const n=new Map,s=new Map;e.forEach(e=>{n.set(e.id,0),s.set(e.id,[])}),t.forEach(e=>{r.has(e.sourceId)&&r.has(e.targetId)&&(n.set(e.targetId,(n.get(e.targetId)||0)+1),s.get(e.sourceId).push(e.targetId))});const a=new Map,l=[];e.forEach(e=>{0===(n.get(e.id)||0)&&(a.set(e.id,0),l.push(e.id))}),!l.length&&e.length&&(a.set(e[0].id,0),l.push(e[0].id));let d=e.length*e.length+e.length;for(;l.length&&d-- >0;){const e=l.shift(),t=a.get(e)||0;(s.get(e)||[]).forEach(e=>{const i=t+1;(a.get(e)??-1)<i&&(a.set(e,i),l.push(e))})}e.forEach(e=>{a.has(e.id)||a.set(e.id,0)});const h=new Map;e.forEach(e=>{const t=a.get(e.id)||0;h.has(t)||h.set(t,[]),h.get(t).push(e)});const p=[...h.keys()].sort((e,t)=>e-t),c=p.map(e=>Math.max(...h.get(e).map(e=>e.height)));c.reduce((e,t)=>e+t,0),Math.max(p.length-1,0);let u=0;p.forEach((e,t)=>{const r=h.get(e);let n=-(r.reduce((e,t)=>e+t.width,0)+Math.max(r.length-1,0)*i)/2;r.forEach(e=>{e.left=Math.round(n),e.top=Math.round(u+(c[t]-e.height)/2),n+=e.width+i}),u+=c[t]+o});const f=Math.min(...e.map(e=>e.left)),m=Math.min(...e.map(e=>e.top));e.forEach(e=>{e.left+=80-f,e.top+=80-m})}(i,o,Number(t.gapX)||90,Number(t.gapY)||90)),i.forEach(e=>{Number.isNaN(e.left)&&(e.left=0),Number.isNaN(e.top)&&(e.top=0)}),{kind:"flowchart",nodes:i,edges:o,layout:r,options:t}}function renderDsl(e,i){const n=validateDsl(i);if(!n.valid)throw new Error(n.errors.join("\n"));return isFlowDsl(i)?renderFlowDsl(e,i):function renderErDsl(e,i){const n=compileDsl(i),s=n.options||{},a=(new t).init(e),l=new o(a);n.entities.forEach(e=>{l.createEntity(e)}),function positionLinks(e,t,i){const o=new Map;return e.entities.forEach(e=>{o.set(e.state.id,e.getMinBoundingBox(!0))}),t.relations.map(e=>{const t=o.get(e.sourceId),r=o.get(e.targetId);let n="R",s="L";if(t&&r){const e=r.center[0]-t.center[0],i=r.center[1]-t.center[1];Math.abs(e)>Math.abs(i)?(n=e>=0?"R":"L",s=e>=0?"L":"R"):(n=i>=0?"B":"T",s=i>=0?"T":"B")}return{...e,routeType:e.routeType||i||"orthogonal",linkShape:e.linkShape||"visio",links:{start:{id:e.sourceId,position:n},end:{id:e.targetId,position:s}}}})}(l,n,s.routeType).forEach(e=>{l.createRelation(e)}),("layered"===n.layout||"horizontal"===n.layout)&&new r({gapX:s.gapX||120,gapY:s.gapY||50}).layoutContainer(a);s.viewport?a.setViewport(s.viewport.scale,s.viewport.tx,s.viewport.ty):s.fitViewport&&function fitViewport(e,t,i){const o=t.entities||[];let r=1/0,n=1/0,s=-1/0,a=-1/0;o.forEach(e=>{const t=e.getMinBoundingBox(!0).getMinAndMaxPoint();r=Math.min(r,t.minX),n=Math.min(n,t.minY),s=Math.max(s,t.maxX),a=Math.max(a,t.maxY)});const l=s-r,d=a-n,h=e.canvasWidth||0,p=e.canvasHeight||0;if(!h||!p||l<=0||d<=0)return;const c=Number.isFinite(i)&&i>=0?i:40,u=Math.max(1,h-2*c),f=Math.max(1,p-2*c),m=Math.min(u/l,f/d,1),g=(h-l*m)/2-r*m,y=(p-d*m)/2-n*m;e.setViewport(m,g,y)}(a,l,s.fitViewportPadding);return{kind:"entity",ice:a,designer:l}}(e,i)}function renderFlowDsl(e,o){const r=compileFlowDsl(o),n=r.options||{},s=(new t).init(e),a=new i(s);return r.nodes.forEach(e=>{a.createNode(e.kind,e)}),r.edges.forEach(e=>{a.createEdge(e)}),a.select(null),n.viewport?s.setViewport(n.viewport.scale,n.viewport.tx,n.viewport.ty):!1!==n.fitViewport&&a.fitViewport(n.fitViewportPadding),a.resetHistory(),{kind:"flowchart",ice:s,designer:a}}export{n as DSL_SCHEMA_VERSION,compileDsl,compileFlowDsl,isFlowDsl,renderDsl,renderFlowDsl,validateDsl,validateFlowDsl};

package/dist/index.umd.js

@@ -1 +1 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("ice-entity-designer")):"function"==typeof define&&define.amd?define(["exports","ice-entity-designer"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).ICEDSL={},e.IED)}(this,(function(e,t){"use strict";function validateDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};if(void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion),Array.isArray(e.entities)){const i=new Set;e.entities.forEach((e,n)=>{const r=`entities[${n}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${r}.id is duplicated: ${e.id}`):i.add(e.id):t.push(r+".id must be a non-empty string"),Array.isArray(e.fields)?e.fields.forEach((e,i)=>{e&&"object"==typeof e&&"string"==typeof e.name&&e.name.trim()||t.push(`${r}.fields[${i}].name must be a non-empty string`)}):t.push(r+".fields must be an array")):t.push(r+" must be an object")})}else t.push("entities must be an array");return void 0===e.relations||Array.isArray(e.relations)?(e.relations||[]).forEach((e,i)=>{const n=`relations[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()||t.push(n+".source must be a non-empty string"),"string"==typeof e.target&&e.target.trim()||t.push(n+".target must be a non-empty string")):t.push(n+" must be an object")}):t.push("relations must be an array"),{valid:0===t.length,errors:t}}function entityName(e){return e.entityName||e.name||e.id}function relationType(e){return e.relationType||e.type||"one-to-many"}function compileDsl(e){return{entities:e.entities.map(e=>({id:e.id,entityName:entityName(e),fields:e.fields||[],left:e.left,top:e.top,width:e.width,height:e.height,style:e.style,headerStyle:e.headerStyle,fieldStyle:e.fieldStyle,dividerStyle:e.dividerStyle,draggable:e.draggable,interactive:e.interactive})),relations:(e.relations||[]).map((e,t)=>({id:e.id||"relation-"+t,relationType:relationType(e),sourceId:e.source,targetId:e.target,sourceField:e.sourceField||"id",targetField:e.targetField||"id",nullable:e.nullable,onDelete:e.onDelete,onUpdate:e.onUpdate,joinTableName:e.joinTableName,fromKey:e.fromKey,toKey:e.toKey,sourceCardinality:e.sourceCardinality,targetCardinality:e.targetCardinality,label:e.label,style:e.style,arrow:e.arrow,linkShape:e.linkShape,routeType:e.routeType,routeOffset:e.routeOffset,curveType:e.curveType,lineDash:e.lineDash})),layout:e.layout,options:e.options}}e.DSL_SCHEMA_VERSION=1,e.compileDsl=compileDsl,e.renderDsl=function renderDsl(e,i){const n=validateDsl(i);if(!n.valid)throw new Error(n.errors.join("\n"));const r=compileDsl(i),a=r.options||{},o=(new t.ICE).init(e),s=new t.EntityDesigner(o);return r.entities.forEach(e=>{s.createEntity(e)}),function positionLinks(e,t,i){const n=new Map;return e.entities.forEach(e=>{n.set(e.state.id,e.getMinBoundingBox(!0))}),t.relations.map(e=>{const t=n.get(e.sourceId),r=n.get(e.targetId);let a="R",o="L";if(t&&r){const e=r.center[0]-t.center[0],i=r.center[1]-t.center[1];Math.abs(e)>Math.abs(i)?(a=e>=0?"R":"L",o=e>=0?"L":"R"):(a=i>=0?"B":"T",o=i>=0?"T":"B")}return{...e,routeType:e.routeType||i||"orthogonal",linkShape:e.linkShape||"visio",links:{start:{id:e.sourceId,position:a},end:{id:e.targetId,position:o}}}})}(s,r,a.routeType).forEach(e=>{s.createRelation(e)}),"layered"!==r.layout&&"horizontal"!==r.layout||new t.ICELayeredLayout({gapX:a.gapX||120,gapY:a.gapY||50}).layoutContainer(o),a.viewport?o.setViewport(a.viewport.scale,a.viewport.tx,a.viewport.ty):a.fitViewport&&function fitViewport(e,t,i){const n=t.entities||[];let r=1/0,a=1/0,o=-1/0,s=-1/0;n.forEach(e=>{const t=e.getMinBoundingBox(!0).getMinAndMaxPoint();r=Math.min(r,t.minX),a=Math.min(a,t.minY),o=Math.max(o,t.maxX),s=Math.max(s,t.maxY)});const l=o-r,d=s-a,p=e.canvasWidth||0,u=e.canvasHeight||0;if(!p||!u||l<=0||d<=0)return;const c=Number.isFinite(i)&&i>=0?i:40,y=Math.max(1,p-2*c),f=Math.max(1,u-2*c),m=Math.min(y/l,f/d,1),h=(p-l*m)/2-r*m,g=(u-d*m)/2-a*m;e.setViewport(m,h,g)}(o,s,a.fitViewportPadding),{ice:o,designer:s}},e.validateDsl=validateDsl,Object.defineProperty(e,"__esModule",{value:!0})}));
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports,require("ice-entity-designer")):"function"==typeof define&&define.amd?define(["exports","ice-entity-designer"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).ICEDSL={},e.IED)}(this,(function(e,t){"use strict";function isFlowDsl(e){return!!e&&"object"==typeof e&&"flowchart"===e.kind}const i=["terminator","process","decision","io"],o=["T","R","B","L","C"];function validateDsl(e){return isFlowDsl(e)?validateFlowDsl(e):function validateErDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion);if(Array.isArray(e.entities)){const i=new Set;e.entities.forEach((e,o)=>{const r=`entities[${o}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?i.has(e.id)?t.push(`${r}.id is duplicated: ${e.id}`):i.add(e.id):t.push(r+".id must be a non-empty string"),Array.isArray(e.fields)?e.fields.forEach((e,i)=>{e&&"object"==typeof e&&"string"==typeof e.name&&e.name.trim()||t.push(`${r}.fields[${i}].name must be a non-empty string`)}):t.push(r+".fields must be an array")):t.push(r+" must be an object")})}else t.push("entities must be an array");void 0===e.relations||Array.isArray(e.relations)?(e.relations||[]).forEach((e,i)=>{const o=`relations[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()||t.push(o+".source must be a non-empty string"),"string"==typeof e.target&&e.target.trim()||t.push(o+".target must be a non-empty string")):t.push(o+" must be an object")}):t.push("relations must be an array");return{valid:0===t.length,errors:t}}(e)}function validateFlowDsl(e){const t=[];if(!e||"object"!=typeof e||Array.isArray(e))return{valid:!1,errors:["DSL root must be an object"]};void 0!==e.schemaVersion&&1!==e.schemaVersion&&t.push("Unsupported schemaVersion: "+e.schemaVersion);const r=new Set;return Array.isArray(e.nodes)?e.nodes.forEach((e,o)=>{const n=`nodes[${o}]`;e&&"object"==typeof e?("string"==typeof e.id&&e.id.trim()?r.has(e.id)?t.push(`${n}.id is duplicated: ${e.id}`):r.add(e.id):t.push(n+".id must be a non-empty string"),void 0!==e.kind&&-1===i.indexOf(e.kind)&&t.push(`${n}.kind must be one of ${i.join("/")}`),["left","top","width","height"].forEach(i=>{const o=e[i];void 0!==o&&"number"!=typeof o&&t.push(`${n}.${i} must be a number when present`)})):t.push(n+" must be an object")}):t.push("nodes must be an array"),void 0===e.edges||Array.isArray(e.edges)?(e.edges||[]).forEach((e,i)=>{const n=`edges[${i}]`;e&&"object"==typeof e?("string"==typeof e.source&&e.source.trim()&&r.has(e.source)||t.push(n+".source must reference an existing node id"),"string"==typeof e.target&&e.target.trim()&&r.has(e.target)||t.push(n+".target must reference an existing node id"),void 0!==e.label&&"string"!=typeof e.label&&t.push(n+".label must be a string when present"),void 0!==e.sourcePort&&-1===o.indexOf(e.sourcePort)&&t.push(`${n}.sourcePort must be one of ${o.join("/")}`),void 0!==e.targetPort&&-1===o.indexOf(e.targetPort)&&t.push(`${n}.targetPort must be one of ${o.join("/")}`),void 0!==e.linkShape&&"visio"!==e.linkShape&&"bezier"!==e.linkShape&&t.push(n+'.linkShape must be "visio" or "bezier" when present')):t.push(n+" must be an object")}):t.push("edges must be an array when present"),{valid:0===t.length,errors:t}}function entityName(e){return e.entityName||e.name||e.id}function relationType(e){return e.relationType||e.type||"one-to-many"}function compileDsl(e){if(isFlowDsl(e))throw new Error("compileDsl() 只处理 ER 文档；流程图文档请使用 compileFlowDsl()");if(!e||!Array.isArray(e.entities))throw new Error("ER 文档必须包含 entities 数组");return{entities:e.entities.map(e=>({id:e.id,entityName:entityName(e),fields:e.fields||[],left:e.left,top:e.top,width:e.width,height:e.height,style:e.style,headerStyle:e.headerStyle,fieldStyle:e.fieldStyle,dividerStyle:e.dividerStyle,draggable:e.draggable,interactive:e.interactive})),relations:(e.relations||[]).map((e,t)=>({id:e.id||"relation-"+t,relationType:relationType(e),sourceId:e.source,targetId:e.target,sourceField:e.sourceField||"id",targetField:e.targetField||"id",nullable:e.nullable,onDelete:e.onDelete,onUpdate:e.onUpdate,joinTableName:e.joinTableName,fromKey:e.fromKey,toKey:e.toKey,sourceCardinality:e.sourceCardinality,targetCardinality:e.targetCardinality,label:e.label,style:e.style,arrow:e.arrow,linkShape:e.linkShape,routeType:e.routeType,routeOffset:e.routeOffset,curveType:e.curveType,lineDash:e.lineDash})),layout:e.layout,options:e.options}}const r={terminator:{width:t.FLOW_NODE_KINDS.terminator.width,height:t.FLOW_NODE_KINDS.terminator.height,fill:t.FLOW_NODE_KINDS.terminator.fill,stroke:t.FLOW_NODE_KINDS.terminator.stroke},process:{width:t.FLOW_NODE_KINDS.process.width,height:t.FLOW_NODE_KINDS.process.height,fill:t.FLOW_NODE_KINDS.process.fill,stroke:t.FLOW_NODE_KINDS.process.stroke},decision:{width:t.FLOW_NODE_KINDS.decision.width,height:t.FLOW_NODE_KINDS.decision.height,fill:t.FLOW_NODE_KINDS.decision.fill,stroke:t.FLOW_NODE_KINDS.decision.stroke},io:{width:t.FLOW_NODE_KINDS.io.width,height:t.FLOW_NODE_KINDS.io.height,fill:t.FLOW_NODE_KINDS.io.fill,stroke:t.FLOW_NODE_KINDS.io.stroke}};function compileFlowDsl(e){const t=e.options||{},i=(e.nodes||[]).map(e=>{const t=function nodeKind(e){return e.kind&&r[e.kind]?e.kind:"process"}(e),i=r[t];return{id:e.id,typeId:"FlowNode",kind:t,title:(o=e,o.title||o.name||o.id),left:"number"==typeof e.left?e.left:Number.NaN,top:"number"==typeof e.top?e.top:Number.NaN,width:"number"==typeof e.width?e.width:i.width,height:"number"==typeof e.height?e.height:i.height,fillColor:e.fillColor||i.fill,strokeColor:e.strokeColor||i.stroke};var o}),o=(e.edges||[]).map((e,t)=>({id:e.id||"edge-"+t,sourceId:e.source,targetId:e.target,sourcePort:e.sourcePort||"B",targetPort:e.targetPort||"T",label:e.label||"",linkShape:e.linkShape||"visio"})),n=t.layout||"layered";return"none"!==n&&i.some(e=>Number.isNaN(e.left)||Number.isNaN(e.top))&&(i.forEach(e=>{Number.isNaN(e.left)&&(e.left=0),Number.isNaN(e.top)&&(e.top=0)}),function autoLayout(e,t,i,o){const r=new Map;e.forEach(e=>r.set(e.id,e));const n=new Map,s=new Map;e.forEach(e=>{n.set(e.id,0),s.set(e.id,[])}),t.forEach(e=>{r.has(e.sourceId)&&r.has(e.targetId)&&(n.set(e.targetId,(n.get(e.targetId)||0)+1),s.get(e.sourceId).push(e.targetId))});const a=new Map,l=[];e.forEach(e=>{0===(n.get(e.id)||0)&&(a.set(e.id,0),l.push(e.id))}),!l.length&&e.length&&(a.set(e[0].id,0),l.push(e[0].id));let d=e.length*e.length+e.length;for(;l.length&&d-- >0;){const e=l.shift(),t=a.get(e)||0;(s.get(e)||[]).forEach(e=>{const i=t+1;(a.get(e)??-1)<i&&(a.set(e,i),l.push(e))})}e.forEach(e=>{a.has(e.id)||a.set(e.id,0)});const h=new Map;e.forEach(e=>{const t=a.get(e.id)||0;h.has(t)||h.set(t,[]),h.get(t).push(e)});const p=[...h.keys()].sort((e,t)=>e-t),c=p.map(e=>Math.max(...h.get(e).map(e=>e.height)));c.reduce((e,t)=>e+t,0),Math.max(p.length-1,0);let u=0;p.forEach((e,t)=>{const r=h.get(e);let n=-(r.reduce((e,t)=>e+t.width,0)+Math.max(r.length-1,0)*i)/2;r.forEach(e=>{e.left=Math.round(n),e.top=Math.round(u+(c[t]-e.height)/2),n+=e.width+i}),u+=c[t]+o});const f=Math.min(...e.map(e=>e.left)),m=Math.min(...e.map(e=>e.top));e.forEach(e=>{e.left+=80-f,e.top+=80-m})}(i,o,Number(t.gapX)||90,Number(t.gapY)||90)),i.forEach(e=>{Number.isNaN(e.left)&&(e.left=0),Number.isNaN(e.top)&&(e.top=0)}),{kind:"flowchart",nodes:i,edges:o,layout:n,options:t}}function renderFlowDsl(e,i){const o=compileFlowDsl(i),r=o.options||{},n=(new t.ICE).init(e),s=new t.FlowDesigner(n);return o.nodes.forEach(e=>{s.createNode(e.kind,e)}),o.edges.forEach(e=>{s.createEdge(e)}),s.select(null),r.viewport?n.setViewport(r.viewport.scale,r.viewport.tx,r.viewport.ty):!1!==r.fitViewport&&s.fitViewport(r.fitViewportPadding),s.resetHistory(),{kind:"flowchart",ice:n,designer:s}}e.DSL_SCHEMA_VERSION=1,e.compileDsl=compileDsl,e.compileFlowDsl=compileFlowDsl,e.isFlowDsl=isFlowDsl,e.renderDsl=function renderDsl(e,i){const o=validateDsl(i);if(!o.valid)throw new Error(o.errors.join("\n"));return isFlowDsl(i)?renderFlowDsl(e,i):function renderErDsl(e,i){const o=compileDsl(i),r=o.options||{},n=(new t.ICE).init(e),s=new t.EntityDesigner(n);o.entities.forEach(e=>{s.createEntity(e)}),function positionLinks(e,t,i){const o=new Map;return e.entities.forEach(e=>{o.set(e.state.id,e.getMinBoundingBox(!0))}),t.relations.map(e=>{const t=o.get(e.sourceId),r=o.get(e.targetId);let n="R",s="L";if(t&&r){const e=r.center[0]-t.center[0],i=r.center[1]-t.center[1];Math.abs(e)>Math.abs(i)?(n=e>=0?"R":"L",s=e>=0?"L":"R"):(n=i>=0?"B":"T",s=i>=0?"T":"B")}return{...e,routeType:e.routeType||i||"orthogonal",linkShape:e.linkShape||"visio",links:{start:{id:e.sourceId,position:n},end:{id:e.targetId,position:s}}}})}(s,o,r.routeType).forEach(e=>{s.createRelation(e)}),("layered"===o.layout||"horizontal"===o.layout)&&new t.ICELayeredLayout({gapX:r.gapX||120,gapY:r.gapY||50}).layoutContainer(n);r.viewport?n.setViewport(r.viewport.scale,r.viewport.tx,r.viewport.ty):r.fitViewport&&function fitViewport(e,t,i){const o=t.entities||[];let r=1/0,n=1/0,s=-1/0,a=-1/0;o.forEach(e=>{const t=e.getMinBoundingBox(!0).getMinAndMaxPoint();r=Math.min(r,t.minX),n=Math.min(n,t.minY),s=Math.max(s,t.maxX),a=Math.max(a,t.maxY)});const l=s-r,d=a-n,h=e.canvasWidth||0,p=e.canvasHeight||0;if(!h||!p||l<=0||d<=0)return;const c=Number.isFinite(i)&&i>=0?i:40,u=Math.max(1,h-2*c),f=Math.max(1,p-2*c),m=Math.min(u/l,f/d,1),g=(h-l*m)/2-r*m,y=(p-d*m)/2-n*m;e.setViewport(m,g,y)}(n,s,r.fitViewportPadding);return{kind:"entity",ice:n,designer:s}}(e,i)},e.renderFlowDsl=renderFlowDsl,e.validateDsl=validateDsl,e.validateFlowDsl=validateFlowDsl,Object.defineProperty(e,"__esModule",{value:!0})}));

package/dist/types/compiler/dslToScene.d.ts

@@ -1,8 +1,9 @@
-import type { DslDocument } from '../types';
+import type { DslErDocument } from '../types';
 export declare type CompiledScene = {
     entities: Array<Record<string, any>>;
     relations: Array<Record<string, any>>;
     layout?: string;
     options?: Record<string, any>;
 };
-export declare function compileDsl(dsl: DslDocument): CompiledScene;
+/** ER 文档 → Entity / Relation 构造参数（流程图请用 compileFlowDsl） */
+export declare function compileDsl(dsl: DslErDocument): CompiledScene;

package/dist/types/compiler/flowToScene.d.ts

@@ -0,0 +1,37 @@
+import type { DslFlowDocument, DslFlowNodeKind } from '../types';
+export declare type CompiledFlowNode = {
+    id: string;
+    typeId: string;
+    kind: DslFlowNodeKind;
+    title: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    fillColor: string;
+    strokeColor: string;
+};
+export declare type CompiledFlowEdge = {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    sourcePort: string;
+    targetPort: string;
+    label: string;
+    linkShape: string;
+};
+export declare type CompiledFlowScene = {
+    kind: 'flowchart';
+    nodes: CompiledFlowNode[];
+    edges: CompiledFlowEdge[];
+    layout: string;
+    options?: Record<string, any>;
+};
+/**
+ * 流程图 DSL → FlowNode / FlowEdge 构造参数。
+ *
+ * - 节点缺省尺寸/配色取 `FLOW_NODE_KINDS` 预设；
+ * - 只要有一个节点缺坐标（或显式 `layout: 'layered'`），就对全部节点做分层自动布局；
+ * - 连线的端口默认「下出上入」（B → T），分支标签走 label。
+ */
+export declare function compileFlowDsl(dsl: DslFlowDocument): CompiledFlowScene;

package/dist/types/index.d.ts

@@ -1,6 +1,8 @@
 export * from './types';
-export { DSL_SCHEMA_VERSION, validateDsl } from './validate';
+export { DSL_SCHEMA_VERSION, validateDsl, validateFlowDsl } from './validate';
 export { compileDsl } from './compiler/dslToScene';
 export type { CompiledScene } from './compiler/dslToScene';
-export { renderDsl } from './runtime/renderDsl';
-export type { RenderDslResult } from './runtime/renderDsl';
+export { compileFlowDsl } from './compiler/flowToScene';
+export type { CompiledFlowScene, CompiledFlowNode, CompiledFlowEdge } from './compiler/flowToScene';
+export { renderDsl, renderFlowDsl } from './runtime/renderDsl';
+export type { RenderDslResult, RenderErDslResult, RenderFlowDslResult } from './runtime/renderDsl';

package/dist/types/runtime/renderDsl.d.ts

@@ -1,6 +1,21 @@
-import type { DslDocument } from '../types';
-export declare type RenderDslResult = {
+import type { DslDocument, DslFlowDocument } from '../types';
+export declare type RenderErDslResult = {
+    kind: 'entity';
     ice: any;
     designer: any;
 };
+export declare type RenderFlowDslResult = {
+    kind: 'flowchart';
+    ice: any;
+    designer: any;
+};
+export declare type RenderDslResult = RenderErDslResult | RenderFlowDslResult;
+/**
+ * 渲染一份 DSL 文档：ER 文档（entities/relations）或流程图文档（kind: 'flowchart'）。
+ *
+ * 两种文档共用同一个入口，返回的 `kind` 表明实际渲染的是哪一类，
+ * `designer` 分别是 `EntityDesigner` / `FlowDesigner` 实例。
+ */
 export declare function renderDsl(canvasOrId: any, dsl: DslDocument): RenderDslResult;
+/** 渲染流程图文档：节点缺坐标时已由 compileFlowDsl 做过分层自动布局 */
+export declare function renderFlowDsl(canvasOrId: any, dsl: DslFlowDocument): RenderFlowDslResult;

package/dist/types/types.d.ts

@@ -55,7 +55,8 @@ export declare type DslRelation = {
     lineDash?: number[];
 };
 export declare type DslLayout = 'grid' | 'layered' | 'horizontal' | 'vertical';
-export declare type DslDocument = {
+/** ER 文档（实体 / 关系） */
+export declare type DslErDocument = {
     schemaVersion?: number;
     entities: DslEntity[];
     relations?: DslRelation[];
@@ -67,7 +68,60 @@ export declare type DslDocument = {
         gapY?: number;
     };
 };
+export declare type DslPort = 'T' | 'R' | 'B' | 'L' | 'C';
+export declare type DslFlowNodeKind = 'terminator' | 'process' | 'decision' | 'io';
+export declare type DslFlowNode = {
+    id: string;
+    /** 节点类型，默认 process */
+    kind?: DslFlowNodeKind;
+    /** 节点文字（title / name 二者取一，name 兼容 ER 文档写法） */
+    title?: string;
+    name?: string;
+    left?: number;
+    top?: number;
+    width?: number;
+    height?: number;
+    fillColor?: string;
+    strokeColor?: string;
+};
+export declare type DslFlowEdge = {
+    id?: string;
+    source: string;
+    target: string;
+    /** 分支标签，例如「是 / 否」 */
+    label?: string;
+    /** 连线离开源节点的位置，默认 B（下） */
+    sourcePort?: DslPort;
+    /** 连线进入目标节点的位置，默认 T（上） */
+    targetPort?: DslPort;
+    linkShape?: 'visio' | 'bezier';
+};
+export declare type DslFlowDocumentOptions = {
+    /** 是否自动适应视图，默认 true */
+    fitViewport?: boolean;
+    fitViewportPadding?: number;
+    viewport?: {
+        scale: number;
+        tx: number;
+        ty: number;
+    };
+    /** 节点缺坐标时的自动布局，默认 layered */
+    layout?: 'layered' | 'none';
+    gapX?: number;
+    gapY?: number;
+};
+export declare type DslFlowDocument = {
+    schemaVersion?: number;
+    kind: 'flowchart';
+    nodes: DslFlowNode[];
+    edges?: DslFlowEdge[];
+    options?: DslFlowDocumentOptions;
+};
+/** 一份 DSL 文档：ER（默认）或 流程图（kind: 'flowchart'） */
+export declare type DslDocument = DslErDocument | DslFlowDocument;
 export declare type DslValidationResult = {
     valid: boolean;
     errors: string[];
 };
+/** 运行时判别：带 kind: 'flowchart' 的按流程图文档处理 */
+export declare function isFlowDsl(dsl: any): dsl is DslFlowDocument;

package/dist/types/validate.d.ts

@@ -1,3 +1,6 @@
-import type { DslDocument, DslValidationResult } from './types';
+import type { DslDocument, DslFlowDocument, DslValidationResult } from './types';
 export declare const DSL_SCHEMA_VERSION = 1;
+/** 校验一份 DSL 文档：ER 文档（entities/relations）或流程图文档（kind: 'flowchart' + nodes/edges） */
 export declare function validateDsl(dsl: DslDocument): DslValidationResult;
+/** 流程图文档校验：结构 + 端点必须指向已存在的节点（与 ER 的关系校验同一口径） */
+export declare function validateFlowDsl(dsl: DslFlowDocument): DslValidationResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ice-entity-designer-dsl",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "A JSON-first DSL layer for AI agents to drive ice-entity-designer.",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -19,7 +19,7 @@
     "types:check": "tsc --noEmit"
   },
   "dependencies": {
-    "ice-entity-designer": "^0.0.17"
+    "ice-entity-designer": "^0.0.20"
   },
   "devDependencies": {
     "@babel/core": "7.17.8",