@retikz/react 0.1.0-alpha.1 → 0.1.0-alpha.3

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.
Files changed (67) hide show
  1. package/dist/es/index.d.ts +5 -5
  2. package/dist/es/index.d.ts.map +1 -1
  3. package/dist/es/index.js +3 -1
  4. package/dist/es/kernel/Node.d.ts +59 -8
  5. package/dist/es/kernel/Node.d.ts.map +1 -1
  6. package/dist/es/kernel/Path.d.ts +12 -0
  7. package/dist/es/kernel/Path.d.ts.map +1 -1
  8. package/dist/es/kernel/Step.d.ts +86 -3
  9. package/dist/es/kernel/Step.d.ts.map +1 -1
  10. package/dist/es/kernel/Text.d.ts +31 -0
  11. package/dist/es/kernel/Text.d.ts.map +1 -0
  12. package/dist/es/kernel/Text.js +22 -0
  13. package/dist/es/kernel/_builder.d.ts.map +1 -1
  14. package/dist/es/kernel/_builder.js +215 -27
  15. package/dist/es/kernel/_displayNames.d.ts +4 -0
  16. package/dist/es/kernel/_displayNames.d.ts.map +1 -1
  17. package/dist/es/kernel/_displayNames.js +5 -1
  18. package/dist/es/kernel/_unbuilder.d.ts.map +1 -1
  19. package/dist/es/kernel/_unbuilder.js +78 -2
  20. package/dist/es/kernel/index.d.ts +1 -0
  21. package/dist/es/kernel/index.d.ts.map +1 -1
  22. package/dist/es/kernel/index.js +1 -0
  23. package/dist/es/render/renderPrim.d.ts.map +1 -1
  24. package/dist/es/render/renderPrim.js +31 -13
  25. package/dist/es/sugar/Draw.d.ts +20 -2
  26. package/dist/es/sugar/Draw.d.ts.map +1 -1
  27. package/dist/es/sugar/Draw.js +57 -3
  28. package/dist/es/sugar/EdgeLabel.d.ts +20 -0
  29. package/dist/es/sugar/EdgeLabel.d.ts.map +1 -0
  30. package/dist/es/sugar/EdgeLabel.js +13 -0
  31. package/dist/es/sugar/index.d.ts +1 -0
  32. package/dist/es/sugar/index.d.ts.map +1 -1
  33. package/dist/es/sugar/index.js +1 -0
  34. package/dist/lib/index.cjs +4 -0
  35. package/dist/lib/index.d.ts +5 -5
  36. package/dist/lib/index.d.ts.map +1 -1
  37. package/dist/lib/kernel/Node.d.ts +59 -8
  38. package/dist/lib/kernel/Node.d.ts.map +1 -1
  39. package/dist/lib/kernel/Path.d.ts +12 -0
  40. package/dist/lib/kernel/Path.d.ts.map +1 -1
  41. package/dist/lib/kernel/Step.d.ts +86 -3
  42. package/dist/lib/kernel/Step.d.ts.map +1 -1
  43. package/dist/lib/kernel/Text.cjs +22 -0
  44. package/dist/lib/kernel/Text.d.ts +31 -0
  45. package/dist/lib/kernel/Text.d.ts.map +1 -0
  46. package/dist/lib/kernel/_builder.cjs +214 -26
  47. package/dist/lib/kernel/_builder.d.ts.map +1 -1
  48. package/dist/lib/kernel/_displayNames.cjs +6 -0
  49. package/dist/lib/kernel/_displayNames.d.ts +4 -0
  50. package/dist/lib/kernel/_displayNames.d.ts.map +1 -1
  51. package/dist/lib/kernel/_unbuilder.cjs +78 -2
  52. package/dist/lib/kernel/_unbuilder.d.ts.map +1 -1
  53. package/dist/lib/kernel/index.cjs +1 -0
  54. package/dist/lib/kernel/index.d.ts +1 -0
  55. package/dist/lib/kernel/index.d.ts.map +1 -1
  56. package/dist/lib/render/renderPrim.cjs +31 -13
  57. package/dist/lib/render/renderPrim.d.ts.map +1 -1
  58. package/dist/lib/sugar/Draw.cjs +57 -3
  59. package/dist/lib/sugar/Draw.d.ts +20 -2
  60. package/dist/lib/sugar/Draw.d.ts.map +1 -1
  61. package/dist/lib/sugar/EdgeLabel.cjs +13 -0
  62. package/dist/lib/sugar/EdgeLabel.d.ts +20 -0
  63. package/dist/lib/sugar/EdgeLabel.d.ts.map +1 -0
  64. package/dist/lib/sugar/index.cjs +1 -0
  65. package/dist/lib/sugar/index.d.ts +1 -0
  66. package/dist/lib/sugar/index.d.ts.map +1 -1
  67. package/package.json +2 -2
@@ -6,12 +6,12 @@
6
6
  *
7
7
  * 渲染管道:buildIR → compileToScene → renderPrim → SVG
8
8
  */
9
- export { Tikz, Node, Path, Step } from './kernel';
10
- export type { TikzProps, NodeProps, PathProps, StepProps } from './kernel';
11
- export { Draw } from './sugar';
12
- export type { DrawProps } from './sugar';
9
+ export { Tikz, Node, Path, Step, Text } from './kernel';
10
+ export type { TikzProps, NodeProps, PathProps, StepProps, TextProps } from './kernel';
11
+ export { Draw, EdgeLabel } from './sugar';
12
+ export type { DrawProps, EdgeLabelProps } from './sugar';
13
13
  export { DrawWay } from '@retikz/core';
14
- export type { WayItem, WayDSL, WayCycle, WayVia } from '@retikz/core';
14
+ export type { WayItem, WayDSL, WayCycle, WayVia, WayRelItem, WayLabel, WayLabelOp, } from '@retikz/core';
15
15
  export { buildIR as convertReactNodeToIR } from './kernel/_builder';
16
16
  export { convertIRToReactNode } from './kernel/_unbuilder';
17
17
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE3E,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAC/B,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtE,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}
package/dist/es/index.js CHANGED
@@ -3,9 +3,11 @@ import { Tikz } from "./kernel/Tikz.js";
3
3
  import { Node } from "./kernel/Node.js";
4
4
  import { Path } from "./kernel/Path.js";
5
5
  import { Step } from "./kernel/Step.js";
6
+ import { Text } from "./kernel/Text.js";
6
7
  import "./kernel/index.js";
7
8
  import { Draw } from "./sugar/Draw.js";
9
+ import { EdgeLabel } from "./sugar/EdgeLabel.js";
8
10
  import "./sugar/index.js";
9
11
  import { convertIRToReactNode } from "./kernel/_unbuilder.js";
10
12
  import { DrawWay } from "@retikz/core";
11
- export { Draw, DrawWay, Node, Path, Step, Tikz, convertIRToReactNode, buildIR as convertReactNodeToIR };
13
+ export { Draw, DrawWay, EdgeLabel, Node, Path, Step, Text, Tikz, convertIRToReactNode, buildIR as convertReactNodeToIR };
@@ -1,5 +1,5 @@
1
1
  import { FC, ReactNode } from 'react';
2
- import { IRNode, IRPosition, PolarPosition } from '@retikz/core';
2
+ import { IRFont, IRLineSpec, IRNode, IRPosition, NodeTextAlign, PolarPosition } from '@retikz/core';
3
3
  /** <Node> 组件的 props */
4
4
  export type NodeProps = {
5
5
  /** 节点 id;其他 Path/Draw 通过这个 id 引用本节点 */
@@ -10,22 +10,73 @@ export type NodeProps = {
10
10
  position: IRPosition | PolarPosition;
11
11
  /** 旋转角度(度数,与 TikZ 一致),绕节点中心;正值顺时针 */
12
12
  rotate?: number;
13
- /** 文本内容;也支持 children 形式(仅字符串) */
13
+ /**
14
+ * 文本内容(也可以用 children 写);与 `text` 二选一,`text` 优先。
15
+ *
16
+ * children 多行写法:
17
+ * - `<Node>{'Line 1\nLine 2'}</Node>`(字符串内嵌 `\n`)
18
+ * - ``<Node>{`Line 1\nLine 2`}</Node>``(模板字面量)
19
+ * - `<Node>{['Line 1', 'Line 2']}</Node>`(数组)
20
+ * - `<Node><Text fill="red">L1</Text>L2</Node>`(混 `<Text>` 带样式行)
21
+ */
14
22
  children?: ReactNode;
15
- /** 显式 text,优先级高于 children */
16
- text?: string;
17
- /** 字号;不填用默认值 */
18
- fontSize?: number;
19
- /** 内边距:内容到 border 的距离 */
23
+ /**
24
+ * 显式 text,优先级高于 children:
25
+ * - `string` — 单行
26
+ * - `Array<string>` — 多行无样式覆盖
27
+ * - `Array<string | LineSpec>` — 多行,可对单行覆盖 fill / opacity / font
28
+ */
29
+ text?: string | Array<IRLineSpec>;
30
+ /** 多行文本对齐:left / center(默认)/ right;只影响多行块内各行的水平对齐 */
31
+ align?: NodeTextAlign;
32
+ /** 行高(user units);不填走 `font.size × 1.2` 默认 */
33
+ lineHeight?: number;
34
+ /** 字体规格:family / size / weight / style 全部可选;不填走渲染端默认值 */
35
+ font?: IRFont;
36
+ /** 横向内边距(text → 左右 border);不填走 `padding` 兜底,再走默认 */
37
+ innerXSep?: number;
38
+ /** 纵向内边距(text → 上下 border);不填走 `padding` 兜底,再走默认 */
39
+ innerYSep?: number;
40
+ /** 外边距(border → path 附着点);不影响 border 位置;不填走 `margin` 兜底 */
41
+ outerSep?: number;
42
+ /** 内边距对称别名——等价于同时设 `innerXSep` 和 `innerYSep`;轴特化字段优先 */
20
43
  padding?: number;
21
- /** 外边距:border path 附着点的距离;不影响 border 位置;必须 ≥ 0 */
44
+ /** 外边距对称别名——等价于 `outerSep`;轴特化字段优先 */
22
45
  margin?: number;
23
46
  /** 背景色 */
24
47
  fill?: IRNode['fill'];
48
+ /** 填充透明度 0~1 */
49
+ fillOpacity?: number;
25
50
  /** 描边色 */
26
51
  stroke?: IRNode['stroke'];
52
+ /** 描边透明度 0~1(TikZ `draw opacity`) */
53
+ drawOpacity?: number;
27
54
  /** 描边宽度 */
28
55
  strokeWidth?: number;
56
+ /** 描边虚线预设:等价于 dashArray="4 2";与 `dotted` / `dashArray` 优先级:dashArray > dashed > dotted */
57
+ dashed?: boolean;
58
+ /** 描边点线预设:等价于 dashArray="1 2" */
59
+ dotted?: boolean;
60
+ /** 显式 SVG stroke-dasharray 值(如 "4 2");优先级最高 */
61
+ dashArray?: string;
62
+ /** 圆角半径(user units);只对 `rectangle` shape 生效 */
63
+ roundedCorners?: number;
64
+ /** 最小 border 宽度(user units);不足时撑开 bbox */
65
+ minimumWidth?: number;
66
+ /** 最小 border 高度(user units) */
67
+ minimumHeight?: number;
68
+ /** 对称最小尺寸别名——等价于同时设 `minimumWidth` 与 `minimumHeight`;轴特化字段优先 */
69
+ minimumSize?: number;
70
+ /** 均匀缩放因子;同时影响 bbox / 字号 / padding / margin / 路径附着点(与 TikZ scale 一致) */
71
+ scale?: number;
72
+ /** 横向缩放,优先于 `scale` */
73
+ xScale?: number;
74
+ /** 纵向缩放,优先于 `scale` */
75
+ yScale?: number;
76
+ /** 文字颜色(块级默认;行级 LineSpec.fill 可覆盖);不填走 `currentColor` */
77
+ textColor?: string;
78
+ /** 整节点透明度 0~1(同时作用于 shape 与 text) */
79
+ opacity?: number;
29
80
  };
30
81
  /**
31
82
  * Node 是 DSL 标记组件——本身不渲染任何 React 元素。
@@ -1 +1 @@
1
- {"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/kernel/Node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGtE,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,oCAAoC;IACpC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAAC;IACrC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
1
+ {"version":3,"file":"Node.d.ts","sourceRoot":"","sources":["../../../src/kernel/Node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EACV,MAAM,EACN,UAAU,EACV,aAAa,EACb,aAAa,EACd,MAAM,cAAc,CAAC;AAGtB,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB,oCAAoC;IACpC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAAC;IACrC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,qDAAqD;IACrD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU;IACV,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
@@ -8,6 +8,12 @@ export type PathProps = {
8
8
  strokeWidth?: IRPath['strokeWidth'];
9
9
  /** SVG stroke-dasharray 模式(如 "4 2") */
10
10
  strokeDasharray?: IRPath['strokeDasharray'];
11
+ /** 端点形状(SVG `stroke-linecap`):`'butt'`(默认 / 直角)/ `'round'`(半圆)/ `'square'`(方头外扩半 stroke) */
12
+ lineCap?: IRPath['lineCap'];
13
+ /** 拐点形状(SVG `stroke-linejoin`):`'miter'`(默认 / 尖角)/ `'round'`(圆角)/ `'bevel'`(切角) */
14
+ lineJoin?: IRPath['lineJoin'];
15
+ /** 语义 stroke 档位(TikZ `ultra thin` … `ultra thick`);显式 `strokeWidth` 始终优先 */
16
+ thickness?: IRPath['thickness'];
11
17
  /**
12
18
  * 路径级箭头方向。`'->'` = 终点;`'<-'` = 起点;`'<->'` = 两端;
13
19
  * 省略或 `'none'` = 无箭头。
@@ -22,6 +28,12 @@ export type PathProps = {
22
28
  fill?: IRPath['fill'];
23
29
  /** SVG fill-rule:`'nonzero'`(默认)/ `'evenodd'`(环形 / 孔洞) */
24
30
  fillRule?: IRPath['fillRule'];
31
+ /** 整 path 透明度 0~1;同时作用于 stroke 与 fill */
32
+ opacity?: IRPath['opacity'];
33
+ /** 仅 fill 透明度 0~1 */
34
+ fillOpacity?: IRPath['fillOpacity'];
35
+ /** 仅 stroke 透明度 0~1(TikZ `draw opacity`) */
36
+ drawOpacity?: IRPath['drawOpacity'];
25
37
  /** 应当全部是 <Step /> */
26
38
  children: ReactNode;
27
39
  };
@@ -1 +1 @@
1
- {"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../../src/kernel/Path.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACpC,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC5C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAClC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,qBAAqB;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
1
+ {"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../../src/kernel/Path.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,uBAAuB;AACvB,MAAM,MAAM,SAAS,GAAG;IACtB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1B,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACpC,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC5C,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACxB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAClC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5B,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACpC,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACpC,qBAAqB;IACrB,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
@@ -1,9 +1,14 @@
1
- import { FC } from 'react';
2
- import { IRTarget } from '@retikz/core';
1
+ import { FC, ReactNode } from 'react';
2
+ import { IRControlPoint, IRStepLabel, IRTarget } from '@retikz/core';
3
3
  /**
4
4
  * <Step> 组件的 props。
5
- * v0.1.0-alpha.1 支持四种 kind:'move' / 'line' / 'step'(折角)/ 'cycle'(闭合)。
5
+ * alpha.3 起支持十种 kind:'move' / 'line' / 'step'(折角)/ 'cycle'(闭合)/
6
+ * 'curve'(二次贝塞尔)/ 'cubic'(三次贝塞尔)/ 'bend'(弧形简记)/
7
+ * 'arc'(圆弧段)/ 'circlePath'(整圆)/ 'ellipsePath'(整椭圆)。
6
8
  * kind 默认 'line'。
9
+ *
10
+ * ADR-0004:除 'move' / 'cycle' 外的八种 kind 都可挂 `label?: IRStepLabel` 边标注;
11
+ * 等价的写法是用 sugar `<EdgeLabel>` 当 children。两者并存时 prop 优先。
7
12
  */
8
13
  export type StepProps = {
9
14
  /** 移动游标但不绘制(类似 SVG path "M") */
@@ -15,6 +20,10 @@ export type StepProps = {
15
20
  kind?: 'line';
16
21
  /** 直线终点 */
17
22
  to: IRTarget;
23
+ /** 边标注(ADR-0004),等价于 <EdgeLabel> child */
24
+ label?: IRStepLabel;
25
+ /** sugar 形态:`<Step><EdgeLabel>...</EdgeLabel></Step>`;其它 children 静默忽略 */
26
+ children?: ReactNode;
18
27
  } | {
19
28
  /** 折角段:从游标经一个直角拐点到目标点(TikZ `-|` / `|-`) */
20
29
  kind: 'step';
@@ -22,9 +31,83 @@ export type StepProps = {
22
31
  via: '-|' | '|-';
23
32
  /** 折角终点 */
24
33
  to: IRTarget;
34
+ /** 边标注(ADR-0004) */
35
+ label?: IRStepLabel;
36
+ /** sugar 形态 */
37
+ children?: ReactNode;
25
38
  } | {
26
39
  /** 闭合:把当前子路径回到最近一个 move 起点(TikZ `cycle` / SVG `Z`) */
27
40
  kind: 'cycle';
41
+ } | {
42
+ /** 二次贝塞尔:一个控制点(TikZ `.. controls (B) ..`) */
43
+ kind: 'curve';
44
+ /** 控制点(alpha.3 仅支持 [x, y],未来可能扩展) */
45
+ control: IRControlPoint;
46
+ /** 曲线终点 */
47
+ to: IRTarget;
48
+ /** 边标注(ADR-0004) */
49
+ label?: IRStepLabel;
50
+ /** sugar 形态 */
51
+ children?: ReactNode;
52
+ } | {
53
+ /** 三次贝塞尔:两个控制点(TikZ `.. controls (B) and (C) ..`) */
54
+ kind: 'cubic';
55
+ /** 第一控制点(影响起点切线) */
56
+ control1: IRControlPoint;
57
+ /** 第二控制点(影响终点切线) */
58
+ control2: IRControlPoint;
59
+ /** 曲线终点 */
60
+ to: IRTarget;
61
+ /** 边标注(ADR-0004) */
62
+ label?: IRStepLabel;
63
+ /** sugar 形态 */
64
+ children?: ReactNode;
65
+ } | {
66
+ /** 弧形简记:按方向 + 角度生成 cubic(TikZ `to[bend left=N]` / `to[bend right=N]`) */
67
+ kind: 'bend';
68
+ /** 弯向:'left' / 'right'(视觉左右,相对 from→to) */
69
+ bendDirection: 'left' | 'right';
70
+ /** 弯角度(度),缺省 30 */
71
+ bendAngle?: number;
72
+ /** 终点 */
73
+ to: IRTarget;
74
+ /** 边标注(ADR-0004) */
75
+ label?: IRStepLabel;
76
+ /** sugar 形态 */
77
+ children?: ReactNode;
78
+ } | {
79
+ /** 弧段:以游标为圆心,按起末角度 + 半径绘制(TikZ `arc[start angle=…, end angle=…, radius=…]`) */
80
+ kind: 'arc';
81
+ /** 弧的起始角度(度),CCW from +x(注意 retikz polar y 轴向下,角度 90 视觉朝下) */
82
+ startAngle: number;
83
+ /** 弧的终止角度(度) */
84
+ endAngle: number;
85
+ /** 弧的半径 */
86
+ radius: number;
87
+ /** 边标注(ADR-0004) */
88
+ label?: IRStepLabel;
89
+ /** sugar 形态 */
90
+ children?: ReactNode;
91
+ } | {
92
+ /** 整圆:以游标为圆心,按半径绘制;画完画笔留在圆心 */
93
+ kind: 'circlePath';
94
+ /** 圆的半径 */
95
+ radius: number;
96
+ /** 边标注(ADR-0004) */
97
+ label?: IRStepLabel;
98
+ /** sugar 形态 */
99
+ children?: ReactNode;
100
+ } | {
101
+ /** 整椭圆:以游标为圆心,按 x/y 轴半径绘制;画完画笔留在圆心 */
102
+ kind: 'ellipsePath';
103
+ /** 椭圆 x 轴半径 */
104
+ radiusX: number;
105
+ /** 椭圆 y 轴半径 */
106
+ radiusY: number;
107
+ /** 边标注(ADR-0004) */
108
+ label?: IRStepLabel;
109
+ /** sugar 形态 */
110
+ children?: ReactNode;
28
111
  };
29
112
  /**
30
113
  * Step 是 DSL 标记组件——本身不渲染。
@@ -1 +1 @@
1
- {"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../../src/kernel/Step.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GACjB;IACE,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
1
+ {"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../../src/kernel/Step.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG1E;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GACjB;IACE,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,EAAE,EAAE,QAAQ,CAAC;CACd,GACD;IACE,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;IACb,0CAA0C;IAC1C,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;IACb,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;CACf,GACD;IACE,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;IACb,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,oBAAoB;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,WAAW;IACX,EAAE,EAAE,QAAQ,CAAC;IACb,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS;IACT,EAAE,EAAE,QAAQ,CAAC;IACb,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,+EAA+E;IAC/E,IAAI,EAAE,KAAK,CAAC;IACZ,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,+BAA+B;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GACD;IACE,sCAAsC;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,eAAe;IACf,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC;AAEN;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { FC } from 'react';
2
+ import { IRFont } from '@retikz/core';
3
+ /** <Text> 组件的 props——Node 多行文本里给某一行带覆盖样式 */
4
+ export type TextProps = {
5
+ /** 行内容(必须是字符串) */
6
+ children: string;
7
+ /** 行级覆盖颜色;不填走 Node 块级默认 */
8
+ fill?: string;
9
+ /** 行级透明度 0~1;不填走 Node 块级默认 */
10
+ opacity?: number;
11
+ /** 行级字体覆盖;missing 字段继承 Node 的 `font` 块级值 */
12
+ font?: IRFont;
13
+ };
14
+ /**
15
+ * Text 是 Node 内的"行级"标记组件——本身不渲染,
16
+ * 由 buildIR 在扫描 Node children 时识别为 LineSpec。
17
+ *
18
+ * 和字符串 children 平等参与——String 按 `'\n'` 拆纯样式行;
19
+ * `<Text>` 一次贡献一行带样式行;保持 JSX 顺序。
20
+ *
21
+ * 用法:
22
+ * ```tsx
23
+ * <Node>
24
+ * <Text fill="red" font={{ weight: 'bold' }}>Heading</Text>
25
+ * body line 1
26
+ * body line 2
27
+ * </Node>
28
+ * ```
29
+ */
30
+ export declare const Text: FC<TextProps>;
31
+ //# sourceMappingURL=Text.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Text.d.ts","sourceRoot":"","sources":["../../../src/kernel/Text.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,4CAA4C;AAC5C,MAAM,MAAM,SAAS,GAAG;IACtB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI,EAAE,EAAE,CAAC,SAAS,CAAc,CAAC"}
@@ -0,0 +1,22 @@
1
+ import { TIKZ_TEXT } from "./_displayNames.js";
2
+ //#region src/kernel/Text.tsx
3
+ /**
4
+ * Text 是 Node 内的"行级"标记组件——本身不渲染,
5
+ * 由 buildIR 在扫描 Node children 时识别为 LineSpec。
6
+ *
7
+ * 和字符串 children 平等参与——String 按 `'\n'` 拆纯样式行;
8
+ * `<Text>` 一次贡献一行带样式行;保持 JSX 顺序。
9
+ *
10
+ * 用法:
11
+ * ```tsx
12
+ * <Node>
13
+ * <Text fill="red" font={{ weight: 'bold' }}>Heading</Text>
14
+ * body line 1
15
+ * body line 2
16
+ * </Node>
17
+ * ```
18
+ */
19
+ var Text = () => null;
20
+ Text.displayName = TIKZ_TEXT;
21
+ //#endregion
22
+ export { Text };
@@ -1 +1 @@
1
- {"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EAAE,EAAE,EAA2B,MAAM,cAAc,CAAC;AAoIhE;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}
1
+ {"version":3,"file":"_builder.d.ts","sourceRoot":"","sources":["../../../src/kernel/_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,SAAS,EAAkB,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EACV,EAAE,EAQH,MAAM,cAAc,CAAC;AAkXtB;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,SAAS,KAAG,EAI5C,CAAC"}
@@ -1,6 +1,6 @@
1
1
  import { TIKZ_NODE, TIKZ_PATH } from "./_displayNames.js";
2
2
  import { Children, isValidElement } from "react";
3
- import { CURRENT_IR_VERSION } from "@retikz/core";
3
+ import { CURRENT_IR_VERSION, parseTargetSugar } from "@retikz/core";
4
4
  //#region src/kernel/_builder.ts
5
5
  /** 取 React 元素 type 上的 displayName;type 为字符串时直接返回,用于识别 Kernel/Sugar 组件 */
6
6
  var getDisplayName = (el) => {
@@ -8,25 +8,130 @@ var getDisplayName = (el) => {
8
8
  if (typeof t === "string") return t;
9
9
  return t.displayName;
10
10
  };
11
- /** 把 <Node> props 翻成 IRChild;text 优先取 props.text,其次取字符串 children */
12
- var buildNode = (props) => {
13
- const text = typeof props.text === "string" ? props.text : typeof props.children === "string" ? props.children : void 0;
11
+ /**
12
+ * <Text> 元素的 props + children 串解析为 IRLineSpec 对象形式。
13
+ * children 必须是 string;非字符串 children 静默跳过此 <Text> 元素。
14
+ */
15
+ var textElementToLineSpec = (el) => {
16
+ const props = el.props;
17
+ if (typeof props.children !== "string") return void 0;
18
+ if (props.fill === void 0 && props.opacity === void 0 && props.font === void 0) return props.children;
14
19
  return {
15
- type: "node",
16
- id: props.id,
17
- shape: props.shape,
18
- position: props.position,
19
- rotate: props.rotate,
20
- text,
20
+ text: props.children,
21
21
  fill: props.fill,
22
- stroke: props.stroke,
23
- strokeWidth: props.strokeWidth,
24
- padding: props.padding,
25
- margin: props.margin,
26
- fontSize: props.fontSize
22
+ opacity: props.opacity,
23
+ font: props.font
27
24
  };
28
25
  };
29
26
  /**
27
+ * 递归收集 Node children 中的行:
28
+ * - 字符串按 `'\n'` 拆行(每段 → 字符串 LineSpec)
29
+ * - 数组(JSX 多 child 自动展平)逐项递归
30
+ * - <Text> 元素 → 对象 LineSpec(带覆盖样式)
31
+ * - 其它类型(其它 React 元素 / null / 数字等)忽略——附带让 `<br/>` 当软分段
32
+ *
33
+ * 顺序保留——按 JSX 写的顺序行就是 IR 行顺序。
34
+ */
35
+ var collectChildLines = (children) => {
36
+ const out = [];
37
+ const visit = (node) => {
38
+ if (typeof node === "string") {
39
+ for (const part of node.split("\n")) out.push(part);
40
+ return;
41
+ }
42
+ if (Array.isArray(node)) {
43
+ for (const c of node) visit(c);
44
+ return;
45
+ }
46
+ if (isValidElement(node) && getDisplayName(node) === "@retikz/Text") {
47
+ const spec = textElementToLineSpec(node);
48
+ if (spec !== void 0) out.push(spec);
49
+ }
50
+ };
51
+ visit(children);
52
+ return out;
53
+ };
54
+ /**
55
+ * Node 文本读取顺序:
56
+ * 1. `props.text`(string / string[] / LineSpec[])— 显式优先,直接透传到 IR
57
+ * 2. `props.children` — 字符串按 `'\n'` 拆行;`<Text>` 元素带样式贡献一行;保持 JSX 顺序
58
+ *
59
+ * 用 children 写多行的几种姿势:
60
+ * - 字符串带换行:`<Node>{'Line 1\nLine 2'}</Node>`
61
+ * - 模板字面量:``<Node>{`Line 1\nLine 2`}</Node>``
62
+ * - 数组:`<Node>{['Line 1', 'Line 2']}</Node>`
63
+ * - <Text>(带样式):`<Node><Text fill="red">Heading</Text>body</Node>`
64
+ */
65
+ var readNodeText = (props) => {
66
+ if (typeof props.text === "string") return props.text;
67
+ if (Array.isArray(props.text)) return props.text;
68
+ const lines = collectChildLines(props.children);
69
+ if (lines.length === 0) return void 0;
70
+ if (lines.length === 1 && typeof lines[0] === "string") return lines[0];
71
+ return lines;
72
+ };
73
+ /** 把 <Node> props 翻成 IRChild;text 优先取 props.text,其次取字符串 children */
74
+ var buildNode = (props) => ({
75
+ type: "node",
76
+ id: props.id,
77
+ shape: props.shape,
78
+ position: props.position,
79
+ rotate: props.rotate,
80
+ text: readNodeText(props),
81
+ align: props.align,
82
+ lineHeight: props.lineHeight,
83
+ fill: props.fill,
84
+ fillOpacity: props.fillOpacity,
85
+ stroke: props.stroke,
86
+ drawOpacity: props.drawOpacity,
87
+ strokeWidth: props.strokeWidth,
88
+ dashed: props.dashed,
89
+ dotted: props.dotted,
90
+ dashArray: props.dashArray,
91
+ roundedCorners: props.roundedCorners,
92
+ minimumWidth: props.minimumWidth,
93
+ minimumHeight: props.minimumHeight,
94
+ minimumSize: props.minimumSize,
95
+ scale: props.scale,
96
+ xScale: props.xScale,
97
+ yScale: props.yScale,
98
+ textColor: props.textColor,
99
+ opacity: props.opacity,
100
+ innerXSep: props.innerXSep,
101
+ innerYSep: props.innerYSep,
102
+ outerSep: props.outerSep,
103
+ padding: props.padding,
104
+ margin: props.margin,
105
+ font: props.font
106
+ });
107
+ /**
108
+ * 扫描 Step children,把首个 <EdgeLabel> 翻译为 IRStepLabel;
109
+ * 非字符串 children 静默跳过;多个 <EdgeLabel> 取首个。
110
+ */
111
+ var readEdgeLabel = (children) => {
112
+ let result;
113
+ Children.forEach(children, (child) => {
114
+ if (result !== void 0) return;
115
+ if (!isValidElement(child)) return;
116
+ if (getDisplayName(child) !== "@retikz/EdgeLabel") return;
117
+ const props = child.props;
118
+ if (typeof props.children !== "string") return;
119
+ const out = { text: props.children };
120
+ if (props.position !== void 0) out.position = props.position;
121
+ if (props.side !== void 0) out.side = props.side;
122
+ result = out;
123
+ });
124
+ return result;
125
+ };
126
+ /**
127
+ * 解析 Step 的 label 来源:prop `label` 优先于 sugar `<EdgeLabel>` child;
128
+ * 都缺省时返回 undefined。
129
+ */
130
+ var resolveStepLabel = (props) => {
131
+ if (props.label !== void 0) return props.label;
132
+ return readEdgeLabel(props.children);
133
+ };
134
+ /**
30
135
  * 扫描 <Path> children 收集 <Step> 序列。
31
136
  * 至少 2 段;首段不是 move 时强制改为 move(与 SVG path 的 "M …" 语义对齐);
32
137
  * cycle 没有 to 字段,若用户把 cycle 放在首段,coerce 时降级到 move (0,0)。
@@ -45,32 +150,109 @@ var readPathChildren = (children) => {
45
150
  });
46
151
  return;
47
152
  }
153
+ const label = kind === "move" ? void 0 : resolveStepLabel(props);
48
154
  if (kind === "step") {
49
- out.push({
155
+ const step = {
50
156
  type: "step",
51
157
  kind: "step",
52
158
  via: props.via,
53
- to: props.to
159
+ to: parseTargetSugar(props.to)
160
+ };
161
+ if (label) step.label = label;
162
+ out.push(step);
163
+ return;
164
+ }
165
+ if (kind === "curve") {
166
+ const step = {
167
+ type: "step",
168
+ kind: "curve",
169
+ to: parseTargetSugar(props.to),
170
+ control: props.control
171
+ };
172
+ if (label) step.label = label;
173
+ out.push(step);
174
+ return;
175
+ }
176
+ if (kind === "cubic") {
177
+ const step = {
178
+ type: "step",
179
+ kind: "cubic",
180
+ to: parseTargetSugar(props.to),
181
+ control1: props.control1,
182
+ control2: props.control2
183
+ };
184
+ if (label) step.label = label;
185
+ out.push(step);
186
+ return;
187
+ }
188
+ if (kind === "bend") {
189
+ const step = {
190
+ type: "step",
191
+ kind: "bend",
192
+ to: parseTargetSugar(props.to),
193
+ bendDirection: props.bendDirection
194
+ };
195
+ if (props.bendAngle !== void 0) step.bendAngle = props.bendAngle;
196
+ if (label) step.label = label;
197
+ out.push(step);
198
+ return;
199
+ }
200
+ if (kind === "arc") {
201
+ const step = {
202
+ type: "step",
203
+ kind: "arc",
204
+ startAngle: props.startAngle,
205
+ endAngle: props.endAngle,
206
+ radius: props.radius
207
+ };
208
+ if (label) step.label = label;
209
+ out.push(step);
210
+ return;
211
+ }
212
+ if (kind === "circlePath") {
213
+ const step = {
214
+ type: "step",
215
+ kind: "circlePath",
216
+ radius: props.radius
217
+ };
218
+ if (label) step.label = label;
219
+ out.push(step);
220
+ return;
221
+ }
222
+ if (kind === "ellipsePath") {
223
+ const step = {
224
+ type: "step",
225
+ kind: "ellipsePath",
226
+ radiusX: props.radiusX,
227
+ radiusY: props.radiusY
228
+ };
229
+ if (label) step.label = label;
230
+ out.push(step);
231
+ return;
232
+ }
233
+ if (kind === "move") {
234
+ out.push({
235
+ type: "step",
236
+ kind: "move",
237
+ to: parseTargetSugar(props.to)
54
238
  });
55
239
  return;
56
240
  }
57
- out.push({
241
+ const step = {
58
242
  type: "step",
59
- kind,
60
- to: props.to
61
- });
243
+ kind: "line",
244
+ to: parseTargetSugar(props.to)
245
+ };
246
+ if (label) step.label = label;
247
+ out.push(step);
62
248
  });
63
249
  if (out.length < 2) throw new Error("<Path> requires at least 2 <Step> children");
64
250
  if (out[0].kind !== "move") {
65
251
  const first = out[0];
66
- out[0] = first.kind === "cycle" ? {
67
- type: "step",
68
- kind: "move",
69
- to: [0, 0]
70
- } : {
252
+ out[0] = {
71
253
  type: "step",
72
254
  kind: "move",
73
- to: first.to
255
+ to: first.kind === "cycle" || first.kind === "arc" || first.kind === "circlePath" || first.kind === "ellipsePath" ? [0, 0] : first.to
74
256
  };
75
257
  }
76
258
  return out;
@@ -81,10 +263,16 @@ var buildPath = (props) => ({
81
263
  stroke: props.stroke,
82
264
  strokeWidth: props.strokeWidth,
83
265
  strokeDasharray: props.strokeDasharray,
266
+ lineCap: props.lineCap,
267
+ lineJoin: props.lineJoin,
268
+ thickness: props.thickness,
84
269
  arrow: props.arrow,
85
270
  arrowShape: props.arrowShape,
86
271
  fill: props.fill,
87
272
  fillRule: props.fillRule,
273
+ opacity: props.opacity,
274
+ fillOpacity: props.fillOpacity,
275
+ drawOpacity: props.drawOpacity,
88
276
  children: readPathChildren(props.children)
89
277
  });
90
278
  /**
@@ -4,4 +4,8 @@ export declare const TIKZ_NODE = "@retikz/Node";
4
4
  export declare const TIKZ_PATH = "@retikz/Path";
5
5
  /** <Step> 组件的 displayName */
6
6
  export declare const TIKZ_STEP = "@retikz/Step";
7
+ /** <Text> 组件的 displayName(Node 内多行文本带样式) */
8
+ export declare const TIKZ_TEXT = "@retikz/Text";
9
+ /** <EdgeLabel> 组件的 displayName(Step 内边标注,ADR-0004) */
10
+ export declare const TIKZ_EDGE_LABEL = "@retikz/EdgeLabel";
7
11
  //# sourceMappingURL=_displayNames.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC"}
1
+ {"version":3,"file":"_displayNames.d.ts","sourceRoot":"","sources":["../../../src/kernel/_displayNames.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,4CAA4C;AAC5C,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC,sDAAsD;AACtD,eAAO,MAAM,eAAe,sBAAsB,CAAC"}