ice-entity-designer 0.0.22 → 0.0.24

package/dist/types/ice-render/export/SvgExporter.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @file SVG 导出
+ *
+ * 引擎的渲染是 canvas 光栅化的，但**几何描述一直都在**：`Path2DRecorder` 让每个路径组件都持有
+ * 自己的命令流（见 cross-platform/Path2DRecorder.ts），于是同一份场景可以再输出一份矢量。
+ *
+ * 导出器刻意**镜像渲染器的口径**，而不是另起一套：
+ * - 绘制顺序 = 渲染队列的顺序（`flattenTree` 后按 `state.zIndex` 稳定排序），工具层默认不导出；
+ * - 每个组件的变换 = `composeMatrix()`（本地 → 世界），整体再套一层「世界 → 视图」矩阵，
+ *   与 `applyTransformToCtx()` 的 `viewport · composed` 完全对应；
+ * - 填充/描边 = `state.fill` / `state.stroke` + `props.style` 与 `state.style` 合并后的键
+ *   （state 覆盖 props，与 `applyStyleToCtx()` 同序）；
+ * - 透明度 = `getEffectiveOpacity()`（自身 × 祖先），与画布的 `globalAlpha` 同一口径；
+ * - 裁剪 = 祖先链上所有 `clipChildren` 的世界包围盒，与 `__applyAncestorClips()` 一致。
+ *
+ * 已支持：任意 `ICEPath` 家族（矩形/圆角矩形/椭圆/自定义形状/折线/贝塞尔/组自身背景）、
+ * 文本（多行、水平/垂直对齐、换行后的行）、图片（含圆形裁剪）、线性/径向渐变、虚线、
+ * 视口或内容自适应尺寸、透明背景。
+ *
+ * 暂未支持（有意留白，都会在文档里写明）：
+ * - 阴影（canvas 的 shadow* → SVG 需要 filter，且模糊半径语义不完全等价）；
+ * - 雪碧图切图（`sx/sy/sw/sh`）与 `fillRule` 的奇偶填充差异；
+ * - 蚂蚁线动画（导出的是**静态瞬间**，只保留当前 dash 相位）。
+ *
+ * 文本的**字形度量**在 canvas 与 SVG 之间不可能逐像素一致（字体回退、行高、基线定义不同），
+ * 因此导出器用 `text-anchor` / `dominant-baseline` 表达对齐，而不是把测出来的宽度写死；
+ * 左对齐（默认）与画布逐字对齐，居中/右对齐按锚点对齐、宽度由渲染方自己定。
+ */
+export type SvgExportOptions = {
+    /** 导出范围：`content`（默认，按内容包围盒紧凑裁切）或 `viewport`（当前画布视口） */
+    area?: 'content' | 'viewport';
+    /** `area: 'content'` 时的四周留白，默认 0 */
+    padding?: number;
+    /** 缩放倍数，默认 1（内容模式下按世界尺寸 1:1） */
+    scale?: number;
+    /** 背景色；默认不铺背景（透明） */
+    background?: string | null;
+    /** 是否把工具层（控制面板、对齐辅助线）也导出，默认 false */
+    includeTools?: boolean;
+    /** 坐标保留小数位，默认 2（避免 `d` 属性里出现一长串浮点噪声） */
+    precision?: number;
+};
+export type SvgExportResult = {
+    svg: string;
+    width: number;
+    height: number;
+};
+/**
+ * 导出场景为 SVG 字符串。
+ *
+ * @param target ICE 实例（导出整幅画布）或任意组件（导出它的子树）
+ */
+export declare function exportSvg(target: any, options?: SvgExportOptions): string;
+export declare function exportSvgResult(target: any, options?: SvgExportOptions): SvgExportResult;

package/dist/types/ice-render/graphic/ICEComponent.d.mts

@@ -10,6 +10,30 @@ import EventBus from '../event/EventBus.mjs';
 import ICEEventTarget from '../event/ICEEventTarget.mjs';
 import ICEBoundingBox from '../geometry/ICEBoundingBox.mjs';
 import ICE from '../ICE.mjs';
+/**
+ * 阴影简写预设：style.shadow: 'sm' | 'md' | 'lg' 一行搞定浮起效果，
+ * 对应展开为 shadowColor / shadowBlur / shadowOffsetX / shadowOffsetY。
+ */
+export declare const SHADOW_PRESETS: {
+    sm: {
+        shadowColor: string;
+        shadowBlur: number;
+        shadowOffsetX: number;
+        shadowOffsetY: number;
+    };
+    md: {
+        shadowColor: string;
+        shadowBlur: number;
+        shadowOffsetX: number;
+        shadowOffsetY: number;
+    };
+    lg: {
+        shadowColor: string;
+        shadowBlur: number;
+        shadowOffsetX: number;
+        shadowOffsetY: number;
+    };
+};
 declare abstract class ICEComponent extends ICEEventTarget {
     ice: ICE;
     root: any;
@@ -298,7 +322,13 @@ declare abstract class ICEComponent extends ICEEventTarget {
      *
      * 顶层组件直接返回（绝大多数组件没有祖先，热路径上不做遍历）；非法值按 1 处理。
      */
-    private __effectiveOpacity;
+    /**
+     * 有效不透明度 = 自身 `state.opacity` × 所有祖先的 `state.opacity`（默认 1）。
+     *
+     * 渲染把相乘的结果叠到 `ctx.globalAlpha` 上（祖先的 opacity 不会自动继承，组件是逐个绘制的）。
+     * 公开出来是因为**离屏与 SVG 导出必须用同一口径**，否则导出的图会比画布亮/暗一截。
+     */
+    getEffectiveOpacity(): number;
     /**
      * 世界坐标点是否落在某个「裁剪祖先」的盒子之外。
      *

package/dist/types/ice-render/graphic/ICEComponent.d.ts

@@ -10,6 +10,30 @@ import EventBus from '../event/EventBus';
 import ICEEventTarget from '../event/ICEEventTarget';
 import ICEBoundingBox from '../geometry/ICEBoundingBox';
 import ICE from '../ICE';
+/**
+ * 阴影简写预设：style.shadow: 'sm' | 'md' | 'lg' 一行搞定浮起效果，
+ * 对应展开为 shadowColor / shadowBlur / shadowOffsetX / shadowOffsetY。
+ */
+export declare const SHADOW_PRESETS: {
+    sm: {
+        shadowColor: string;
+        shadowBlur: number;
+        shadowOffsetX: number;
+        shadowOffsetY: number;
+    };
+    md: {
+        shadowColor: string;
+        shadowBlur: number;
+        shadowOffsetX: number;
+        shadowOffsetY: number;
+    };
+    lg: {
+        shadowColor: string;
+        shadowBlur: number;
+        shadowOffsetX: number;
+        shadowOffsetY: number;
+    };
+};
 declare abstract class ICEComponent extends ICEEventTarget {
     ice: ICE;
     root: any;
@@ -298,7 +322,13 @@ declare abstract class ICEComponent extends ICEEventTarget {
      *
      * 顶层组件直接返回（绝大多数组件没有祖先，热路径上不做遍历）；非法值按 1 处理。
      */
-    private __effectiveOpacity;
+    /**
+     * 有效不透明度 = 自身 `state.opacity` × 所有祖先的 `state.opacity`（默认 1）。
+     *
+     * 渲染把相乘的结果叠到 `ctx.globalAlpha` 上（祖先的 opacity 不会自动继承，组件是逐个绘制的）。
+     * 公开出来是因为**离屏与 SVG 导出必须用同一口径**，否则导出的图会比画布亮/暗一截。
+     */
+    getEffectiveOpacity(): number;
     /**
      * 世界坐标点是否落在某个「裁剪祖先」的盒子之外。
      *

package/dist/types/ice-render/graphic/ICEPath.d.mts

@@ -6,6 +6,13 @@ import ICEComponent from './ICEComponent.mjs';
  */
 declare abstract class ICEPath extends ICEComponent {
     path2D: any;
+    /**
+     * 确保路径命令流是最新的。
+     *
+     * 画布通道里由 `doRender()` 在 dirty 时重建；但**导出 / 服务端出图没有渲染循环**
+     * （Node 里连 canvas 都没有），此时必须显式建一次，否则命令流是空的、导出出来一片空白。
+     */
+    ensurePathBuilt(): void;
     /**
      * @cfg
      * {

package/dist/types/ice-render/graphic/ICEPath.d.ts

@@ -6,6 +6,13 @@ import ICEComponent from './ICEComponent';
  */
 declare abstract class ICEPath extends ICEComponent {
     path2D: any;
+    /**
+     * 确保路径命令流是最新的。
+     *
+     * 画布通道里由 `doRender()` 在 dirty 时重建；但**导出 / 服务端出图没有渲染循环**
+     * （Node 里连 canvas 都没有），此时必须显式建一次，否则命令流是空的、导出出来一片空白。
+     */
+    ensurePathBuilt(): void;
     /**
      * @cfg
      * {

package/dist/types/ice-render/graphic/link/ICEPolyLine.d.mts

@@ -251,6 +251,23 @@ declare class ICEPolyLine extends ICEDotPath {
      * `__measureLabelBoxForBounds()`（盒子计算不应留下渲染副作用）。
      */
     private __labelMetrics;
+    /**
+     * 连线标签的**渲染信息**（公开口径）：位置、尺寸、字体与配色。
+     *
+     * 与 `drawLabel()` / `__labelMetrics()` 同源 —— 画布怎么画，导出（SVG）就怎么描述。
+     * 连线标签是画布 `fillText` 出来的，不像节点标题那样是独立的 ICEText 子组件，
+     * 所以导出器必须显式问它，否则「是/否」「条件」这类标签会在导出里凭空消失。
+     */
+    getLabelRenderInfo(): {
+        text: string;
+        x: number;
+        y: number;
+        halfW: number;
+        halfH: number;
+        fontSize: number;
+        fillStyle: string;
+        backgroundColor: string;
+    } | null;
     /** `__localBox()` 专用包装：算完把 `ctx.font` 恢复 —— 盒子计算不该改变渲染状态。 */
     private __measureLabelBoxForBounds;
     /**

package/dist/types/ice-render/graphic/link/ICEPolyLine.d.ts

@@ -251,6 +251,23 @@ declare class ICEPolyLine extends ICEDotPath {
      * `__measureLabelBoxForBounds()`（盒子计算不应留下渲染副作用）。
      */
     private __labelMetrics;
+    /**
+     * 连线标签的**渲染信息**（公开口径）：位置、尺寸、字体与配色。
+     *
+     * 与 `drawLabel()` / `__labelMetrics()` 同源 —— 画布怎么画，导出（SVG）就怎么描述。
+     * 连线标签是画布 `fillText` 出来的，不像节点标题那样是独立的 ICEText 子组件，
+     * 所以导出器必须显式问它，否则「是/否」「条件」这类标签会在导出里凭空消失。
+     */
+    getLabelRenderInfo(): {
+        text: string;
+        x: number;
+        y: number;
+        halfW: number;
+        halfH: number;
+        fontSize: number;
+        fillStyle: string;
+        backgroundColor: string;
+    } | null;
     /** `__localBox()` 专用包装：算完把 `ctx.font` 恢复 —— 盒子计算不该改变渲染状态。 */
     private __measureLabelBoxForBounds;
     /**

package/dist/types/ice-render/graphic/text/ICEText.d.mts

@@ -91,6 +91,15 @@ declare class ICEText extends ICEComponent {
         width: any;
         height: any;
     };
+    /**
+     * 多行文本的行距系数。
+     *
+     * 为什么不能直接用 `actualBoundingBoxAscent + Descent`（字形墨迹高度）当行距：
+     * 墨迹只覆盖「有笔画的部分」，拉丁字母的 cap-height 比 em 小得多 —— 14px Tahoma 的
+     * 墨迹高 ≈ 12px，拿它当行距时中文（墨迹接近满 em）会**上下叠在一起**，看起来像文字被压扁。
+     * 按字号 × 1.35 取行距更接近系统的自然行高，同时保证 ≥ 墨迹高度（不会挤）。
+     */
+    private static readonly LINE_HEIGHT_RATIO;
     /**
      * @method measureText
      *
@@ -126,6 +135,18 @@ declare class ICEText extends ICEComponent {
     private __applyMeasuredSize;
     /** DOM 降级测量：line-height 归一为 1，减少 leading 干扰（旧环境/小程序）。 */
     private __measureByDOM;
+    /**
+     * 文本的**渲染行布局**：每一行的内容与基线坐标（组件本地坐标）。
+     *
+     * 画布渲染与 SVG 导出共用这一份口径 —— 两处各算一遍必然漂移（改了对齐公式忘了另一处，
+     * 表现为「导出的文字整体偏移」）。返回的 `x` 是**文字左边缘**（左/居中/右对齐都按画布公式算好），
+     * `y` 是 baseline 位置。
+     */
+    getRenderLines(): Array<{
+        text: string;
+        x: number;
+        y: number;
+    }>;
     /**
      * @method doRender
      * @overwrite

package/dist/types/ice-render/graphic/text/ICEText.d.ts

@@ -91,6 +91,15 @@ declare class ICEText extends ICEComponent {
         width: any;
         height: any;
     };
+    /**
+     * 多行文本的行距系数。
+     *
+     * 为什么不能直接用 `actualBoundingBoxAscent + Descent`（字形墨迹高度）当行距：
+     * 墨迹只覆盖「有笔画的部分」，拉丁字母的 cap-height 比 em 小得多 —— 14px Tahoma 的
+     * 墨迹高 ≈ 12px，拿它当行距时中文（墨迹接近满 em）会**上下叠在一起**，看起来像文字被压扁。
+     * 按字号 × 1.35 取行距更接近系统的自然行高，同时保证 ≥ 墨迹高度（不会挤）。
+     */
+    private static readonly LINE_HEIGHT_RATIO;
     /**
      * @method measureText
      *
@@ -126,6 +135,18 @@ declare class ICEText extends ICEComponent {
     private __applyMeasuredSize;
     /** DOM 降级测量：line-height 归一为 1，减少 leading 干扰（旧环境/小程序）。 */
     private __measureByDOM;
+    /**
+     * 文本的**渲染行布局**：每一行的内容与基线坐标（组件本地坐标）。
+     *
+     * 画布渲染与 SVG 导出共用这一份口径 —— 两处各算一遍必然漂移（改了对齐公式忘了另一处，
+     * 表现为「导出的文字整体偏移」）。返回的 `x` 是**文字左边缘**（左/居中/右对齐都按画布公式算好），
+     * `y` 是 baseline 位置。
+     */
+    getRenderLines(): Array<{
+        text: string;
+        x: number;
+        y: number;
+    }>;
     /**
      * @method doRender
      * @overwrite

package/dist/types/ice-render/index.d.mts

@@ -49,6 +49,8 @@ export { default as ICELayeredLayout } from './layout/ICELayeredLayout.mjs';
 export { default as ICETheme, baseTokens, DEFAULT_THEME, DARK_THEME, registerTheme, setTheme, getTheme, STYLE_PRESETS, } from './theme/ICETheme.mjs';
 export { default as ICE } from './ICE.mjs';
 export { default as CanvasRenderer } from './renderer/CanvasRenderer.mjs';
+export { exportSvg, exportSvgResult } from './export/SvgExporter.mjs';
+export type { SvgExportOptions, SvgExportResult } from './export/SvgExporter.mjs';
 export { default as PluginHost } from './plugin/PluginHost.mjs';
 export type { ICEPlugin, ICEPluginTool, ICERenderHook, ICERenderFrame } from './plugin/PluginHost.mjs';
 export { default as Serializer, SERIALIZATION_VERSION } from './persistence/Serializer.mjs';

package/dist/types/ice-render/index.d.ts

@@ -49,6 +49,8 @@ export { default as ICELayeredLayout } from './layout/ICELayeredLayout';
 export { default as ICETheme, baseTokens, DEFAULT_THEME, DARK_THEME, registerTheme, setTheme, getTheme, STYLE_PRESETS, } from './theme/ICETheme';
 export { default as ICE } from './ICE';
 export { default as CanvasRenderer } from './renderer/CanvasRenderer';
+export { exportSvg, exportSvgResult } from './export/SvgExporter';
+export type { SvgExportOptions, SvgExportResult } from './export/SvgExporter';
 export { default as PluginHost } from './plugin/PluginHost';
 export type { ICEPlugin, ICEPluginTool, ICERenderHook, ICERenderFrame } from './plugin/PluginHost';
 export { default as Serializer, SERIALIZATION_VERSION } from './persistence/Serializer';

package/dist/types/index.d.mts

@@ -25,6 +25,14 @@ export { validateBpmn } from './bpmn/bpmn_validate.mjs';
 export type { BpmnIssue } from './bpmn/bpmn_validate.mjs';
 export { toBpmnXml, fromBpmnXml } from './bpmn/bpmn_xml.mjs';
 export type { BpmnImportResult } from './bpmn/bpmn_xml.mjs';
+export { default as UmlClass } from './uml/UmlClass.mjs';
+export type { UmlClassKind } from './uml/UmlClass.mjs';
+export { default as UmlRelation, UML_RELATION_KINDS, UML_RELATION_STYLE } from './uml/UmlRelation.mjs';
+export type { UmlRelationKind, UmlMarker } from './uml/UmlRelation.mjs';
+export { default as UmlDesigner } from './uml/UmlDesigner.mjs';
+export type { UmlIssue } from './uml/UmlDesigner.mjs';
+export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text.mjs';
+export type { UmlTextImportResult } from './uml/uml_text.mjs';
 /**
  * 引擎内核（ice-render）在构建时已被打包进本包，这里一并导出。
  *

package/dist/types/index.d.ts

@@ -25,6 +25,14 @@ export { validateBpmn } from './bpmn/bpmn_validate';
 export type { BpmnIssue } from './bpmn/bpmn_validate';
 export { toBpmnXml, fromBpmnXml } from './bpmn/bpmn_xml';
 export type { BpmnImportResult } from './bpmn/bpmn_xml';
+export { default as UmlClass } from './uml/UmlClass';
+export type { UmlClassKind } from './uml/UmlClass';
+export { default as UmlRelation, UML_RELATION_KINDS, UML_RELATION_STYLE } from './uml/UmlRelation';
+export type { UmlRelationKind, UmlMarker } from './uml/UmlRelation';
+export { default as UmlDesigner } from './uml/UmlDesigner';
+export type { UmlIssue } from './uml/UmlDesigner';
+export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text';
+export type { UmlTextImportResult } from './uml/uml_text';
 /**
  * 引擎内核（ice-render）在构建时已被打包进本包，这里一并导出。
  *

package/dist/types/uml/UmlClass.d.mts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { ICEGroup, ICEPolyLine, ICERect, ICEText } from '../ice-render/index.mjs';
+export declare type UmlClassKind = 'class' | 'interface' | 'enum';
+/**
+ * @class UmlClass UML 类图的类框（三段式：类名 / 属性 / 方法）
+ *
+ * 与 ER 的 `Entity` 同一套做法：**复合组件** —— 类名、属性、方法、分隔线都是按 state
+ * 派生的内部子组件（`hasDerivedChildren() === true`），不写进文档、载入时重建。
+ *
+ * 与 Entity 的三点差异（这也是它值得单独做域包的原因）：
+ * - 三段式：类名带（含构造型）+ 属性区 + 方法区，分隔线两条；
+ * - 成员是**自由文本**（`- id: string`、`+ pay(): void`），可见性/静态/泛型都由文本表达 ——
+ *   这是 UML 工具与文本格式（PlantUML/Mermaid）通行的做法，也让 AI 生成不必学一套结构化语法；
+ * - **高度随成员自动增长**，不允许成员画出框外。
+ */
+export default class UmlClass extends ICEGroup {
+    /** 稳定类型标识（判型/序列化都用它，不要用 constructor.name：打包会被 mangle） */
+    static readonly typeId = "UmlClass";
+    protected stereotypeComponent: ICEText | null;
+    protected nameComponent: ICEText | null;
+    protected headerBackgroundComponent: ICERect | null;
+    protected memberComponents: ICEText[];
+    protected dividerComponents: ICEPolyLine[];
+    /** 内部子组件由 state 派生 → 不参与序列化 */
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /** 只需要重建内部排版的 state 键（拖动位置不该触发重建） */
+    private static readonly __layoutKeys;
+    setState(patch: any): void;
+    /** 应用层（属性面板 / DSL）改成员走这里，语义与 FlowNode.applyPatch 一致 */
+    applyPatch(patch?: any): void;
+    /**
+     * 按 state 重建三段式排版，并把**内容高度**写回自身（成员不会被画出框外）。
+     *
+     * 高度用 `this.state.height = h` 直接写：`setState()` 会再次触发重建，形成循环。
+     */
+    protected syncCompartments(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/uml/UmlClass.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { ICEGroup, ICEPolyLine, ICERect, ICEText } from '../ice-render/index';
+export declare type UmlClassKind = 'class' | 'interface' | 'enum';
+/**
+ * @class UmlClass UML 类图的类框（三段式：类名 / 属性 / 方法）
+ *
+ * 与 ER 的 `Entity` 同一套做法：**复合组件** —— 类名、属性、方法、分隔线都是按 state
+ * 派生的内部子组件（`hasDerivedChildren() === true`），不写进文档、载入时重建。
+ *
+ * 与 Entity 的三点差异（这也是它值得单独做域包的原因）：
+ * - 三段式：类名带（含构造型）+ 属性区 + 方法区，分隔线两条；
+ * - 成员是**自由文本**（`- id: string`、`+ pay(): void`），可见性/静态/泛型都由文本表达 ——
+ *   这是 UML 工具与文本格式（PlantUML/Mermaid）通行的做法，也让 AI 生成不必学一套结构化语法；
+ * - **高度随成员自动增长**，不允许成员画出框外。
+ */
+export default class UmlClass extends ICEGroup {
+    /** 稳定类型标识（判型/序列化都用它，不要用 constructor.name：打包会被 mangle） */
+    static readonly typeId = "UmlClass";
+    protected stereotypeComponent: ICEText | null;
+    protected nameComponent: ICEText | null;
+    protected headerBackgroundComponent: ICERect | null;
+    protected memberComponents: ICEText[];
+    protected dividerComponents: ICEPolyLine[];
+    /** 内部子组件由 state 派生 → 不参与序列化 */
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    /** 只需要重建内部排版的 state 键（拖动位置不该触发重建） */
+    private static readonly __layoutKeys;
+    setState(patch: any): void;
+    /** 应用层（属性面板 / DSL）改成员走这里，语义与 FlowNode.applyPatch 一致 */
+    applyPatch(patch?: any): void;
+    /**
+     * 按 state 重建三段式排版，并把**内容高度**写回自身（成员不会被画出框外）。
+     *
+     * 高度用 `this.state.height = h` 直接写：`setState()` 会再次触发重建，形成循环。
+     */
+    protected syncCompartments(): void;
+    private __clearDerivedChildren;
+}

package/dist/types/uml/UmlDesigner.d.mts

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import FlowDesigner from '../flow/FlowDesigner.mjs';
+import type { UmlRelationKind } from './UmlRelation.mjs';
+export declare type UmlIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/**
+ * @class UmlDesigner UML 类图设计器（域包 = 形状 + 应用层 + 校验 + 互操作 + 文档）
+ *
+ * 它是 `FlowDesigner` 的**薄扩展**，只做四件事，其余（选择、增删改、连线、撤销重做、
+ * 快照存取、适应视图、订阅）全部继承：
+ *
+ * 1. 建 UML 图元（`UmlClass` / `UmlRelation`）而不是流程图的 FlowNode/FlowEdge；
+ * 2. 节点/连线的**类型过滤**换成 UML 类型；
+ * 3. UML **语义校验**（重名类、悬空关系、继承环）。
+ *
+ * 之所以能这么薄：类框是复合组件（内部三段由 state 派生），关系是折线（标记进路径点集），
+ * 快照直接复用引擎序列化（typeId 注册表 + hasDerivedChildren）。
+ */
+export default class UmlDesigner extends FlowDesigner {
+    constructor(ice: any);
+    /** 只认 UML 类框（继承来的 FlowNode 过滤换掉） */
+    get nodes(): any[];
+    /** 只认 UML 关系线 */
+    get edges(): any[];
+    /** 建一个类/接口/枚举（`createNode` 的 UML 语义版本） */
+    createClass(props?: any): any;
+    /** 建一条 UML 关系（继承 / 实现 / 关联 / 聚合 / 组合 / 依赖） */
+    createRelation(props?: any): any;
+    /** 改关系种类：记法（线型 + 端点标记 + 填充）随之一并更新 */
+    setRelationKind(id: string, relationKind: UmlRelationKind): any;
+    /** 关系种类清单（属性面板/DSL 共用同一份词汇表） */
+    get relationKinds(): string[];
+    /**
+     * UML 语义校验（结构之外的部分）：
+     * - 类名重复（同一张图里两个类无法区分）；
+     * - 关系两端必须都还在（删除类时引擎会级联删关系，这里是防御性的）；
+     * - 继承/实现的**成环**（A 继承 B、B 又继承 A —— 类型系统不成立）。
+     */
+    validateUml(): UmlIssue[];
+    /** 关系记法的可读描述（属性面板/文档共用，避免三处各写一份文案） */
+    static describeRelationKind(kind: UmlRelationKind): string;
+    /** 端口点：与 FlowDesigner 的插槽语义一致（T/R/B/L/C），这里按 UML 常用左右出发 */
+    private __portPoint;
+}

package/dist/types/uml/UmlDesigner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import FlowDesigner from '../flow/FlowDesigner';
+import type { UmlRelationKind } from './UmlRelation';
+export declare type UmlIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/**
+ * @class UmlDesigner UML 类图设计器（域包 = 形状 + 应用层 + 校验 + 互操作 + 文档）
+ *
+ * 它是 `FlowDesigner` 的**薄扩展**，只做四件事，其余（选择、增删改、连线、撤销重做、
+ * 快照存取、适应视图、订阅）全部继承：
+ *
+ * 1. 建 UML 图元（`UmlClass` / `UmlRelation`）而不是流程图的 FlowNode/FlowEdge；
+ * 2. 节点/连线的**类型过滤**换成 UML 类型；
+ * 3. UML **语义校验**（重名类、悬空关系、继承环）。
+ *
+ * 之所以能这么薄：类框是复合组件（内部三段由 state 派生），关系是折线（标记进路径点集），
+ * 快照直接复用引擎序列化（typeId 注册表 + hasDerivedChildren）。
+ */
+export default class UmlDesigner extends FlowDesigner {
+    constructor(ice: any);
+    /** 只认 UML 类框（继承来的 FlowNode 过滤换掉） */
+    get nodes(): any[];
+    /** 只认 UML 关系线 */
+    get edges(): any[];
+    /** 建一个类/接口/枚举（`createNode` 的 UML 语义版本） */
+    createClass(props?: any): any;
+    /** 建一条 UML 关系（继承 / 实现 / 关联 / 聚合 / 组合 / 依赖） */
+    createRelation(props?: any): any;
+    /** 改关系种类：记法（线型 + 端点标记 + 填充）随之一并更新 */
+    setRelationKind(id: string, relationKind: UmlRelationKind): any;
+    /** 关系种类清单（属性面板/DSL 共用同一份词汇表） */
+    get relationKinds(): string[];
+    /**
+     * UML 语义校验（结构之外的部分）：
+     * - 类名重复（同一张图里两个类无法区分）；
+     * - 关系两端必须都还在（删除类时引擎会级联删关系，这里是防御性的）；
+     * - 继承/实现的**成环**（A 继承 B、B 又继承 A —— 类型系统不成立）。
+     */
+    validateUml(): UmlIssue[];
+    /** 关系记法的可读描述（属性面板/文档共用，避免三处各写一份文案） */
+    static describeRelationKind(kind: UmlRelationKind): string;
+    /** 端口点：与 FlowDesigner 的插槽语义一致（T/R/B/L/C），这里按 UML 常用左右出发 */
+    private __portPoint;
+}

package/dist/types/uml/UmlRelation.d.mts

@@ -0,0 +1,63 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { ICEPolyLine } from '../ice-render/index.mjs';
+/** UML 类图里的六种关系（记法见下方 STYLE_BY_KIND） */
+export declare const UML_RELATION_KINDS: readonly ["inheritance", "realization", "association", "aggregation", "composition", "dependency"];
+export declare type UmlRelationKind = (typeof UML_RELATION_KINDS)[number];
+/** 端点标记种类 */
+export declare type UmlMarker = 'none' | 'triangle' | 'diamond' | 'open';
+declare type UmlRelationStyle = {
+    marker: UmlMarker;
+    /** 标记画在哪一端：整体（owner）一侧 / 目标（被继承、被依赖）一侧 */
+    markerEnd: 'start' | 'end';
+    filled: boolean;
+    dashed: boolean;
+};
+/**
+ * 六种关系的**记法**（UML 2.5 规范）：
+ *
+ * | 关系 | 线型 | 端点 |
+ * |---|---|---|
+ * | 继承 generalization | 实线 | 空心三角，指向父类 |
+ * | 实现 realization | 虚线 | 空心三角，指向接口 |
+ * | 关联 association | 实线 | 无 |
+ * | 聚合 aggregation | 实线 | **空心菱形**，在整体一侧 |
+ * | 组合 composition | 实线 | **实心菱形**，在整体一侧 |
+ * | 依赖 dependency | 虚线 | 开放箭头，指向被依赖方 |
+ */
+export declare const UML_RELATION_STYLE: Record<UmlRelationKind, UmlRelationStyle>;
+/**
+ * @class UmlRelation UML 类图的关系线
+ *
+ * 复用引擎的折线（`ICEPolyLine`）：插槽吸附、正交/贝塞尔路由、标签、跟随宿主都是现成的。
+ * 这里只补 UML 特有的一件事 —— **端点标记**（三角/菱形/开放箭头）。
+ *
+ * 关键实现选择：标记**作为路径点插进 dots**（而不是画上去的装饰），因此
+ * - 描边/填充走引擎既有通道（空心/实心天然可分）；
+ * - SVG 导出**自动带上**标记（导出器读的是同一条命令流）；
+ * - 包围盒、命中检测也跟着正确。
+ */
+export default class UmlRelation extends ICEPolyLine {
+    static readonly typeId = "UmlRelation";
+    constructor(props?: any);
+    protected static arrangeParam(props: any): any;
+    setState(patch: any): void;
+    /** 属性面板/DSL 改关系种类走这里 */
+    applyPatch(patch?: any): void;
+    /** 把记法写进 state：线型、端点、填充、标记种类 */
+    private __applyNotation;
+    /**
+     * @overwrite
+     * 端点标记：按记法把三角/菱形/开放箭头的顶点插进 dots（因此它们是**路径的一部分**）。
+     *
+     * 引擎原生只支持三角（`doCalcArrowPoints()` 返回两个底角），这里对菱形做同样的展开：
+     * 菱形的四个顶点 = 端点 P、两个腰点、远端顶点 —— 闭合后就是一个菱形。
+     */
+    protected calcArrowPoints(): void;
+}
+export {};