@retikz/core 0.1.0-alpha.4 → 0.1.0-beta.1

package/dist/lib/primitive/group.d.ts

@@ -1,10 +1,44 @@
 import { ScenePrimitive } from './scene';
-/** 编组：把若干 primitive 用 transform 包起来 */
+/** Translate transform：沿 x / y 平移（user units） */
+export type TranslateTransform = {
+    /** 鉴别字面量 */
+    kind: 'translate';
+    /** x 方向位移 */
+    x: number;
+    /** y 方向位移（屏幕 y-down） */
+    y: number;
+};
+/** Rotate transform：按角度旋转，可指定旋转中心；中心缺省 = 绕原点 (0, 0) */
+export type RotateTransform = {
+    /** 鉴别字面量 */
+    kind: 'rotate';
+    /** 旋转角度（度，正向 = 屏幕 y-down 下的视觉顺时针） */
+    degrees: number;
+    /** 旋转中心 x（缺省 0） */
+    cx?: number;
+    /** 旋转中心 y（缺省 0） */
+    cy?: number;
+};
+/** Scale transform：等比 / 非等比缩放；y 缺省 = x（等比） */
+export type ScaleTransform = {
+    /** 鉴别字面量 */
+    kind: 'scale';
+    /** x 轴缩放因子 */
+    x: number;
+    /** y 轴缩放因子；缺省 = x（等比缩放） */
+    y?: number;
+};
+/**
+ * Group transform：结构化变换（3 分支 discriminated union）
+ * @description 按数组顺序应用（与 SVG transform 多操作列表语义一致）；角度=度，缩放 y 缺省等比 x，rotate cx/cy 缺省绕原点。每个 kind 有对应 named type export。
+ */
+export type Transform = TranslateTransform | RotateTransform | ScaleTransform;
+/** 编组：把若干 primitive 用结构化 transforms 包起来 */
 export type GroupPrim = {
     /** 类型判别符 */
     type: 'group';
-    /** SVG transform 字符串（translate / rotate / scale 等） */
-    transform?: string;
+    /** 结构化变换序列，按数组顺序应用；undefined / 空数组表示无变换 */
+    transforms?: Array<Transform>;
     /** 组内子原语 */
     children: Array<ScenePrimitive>;
 };

package/dist/lib/primitive/group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/primitive/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CACjC,CAAC"}
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../../src/primitive/group.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,iDAAiD;AACjD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY;IACZ,IAAI,EAAE,WAAW,CAAC;IAClB,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,cAAc;IACd,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,kBAAkB,GAClB,eAAe,GACf,cAAc,CAAC;AAEnB,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG;IACtB,YAAY;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,2CAA2C;IAC3C,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9B,YAAY;IACZ,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CACjC,CAAC"}

package/dist/lib/primitive/path.d.ts

@@ -1,10 +1,110 @@
 import { ArrowShape } from '../ir/path/arrow';
-/** 路径原语：SVG path d 字符串；Canvas/PDF renderer 自行解析 */
+/** Move command：移动游标到目标点，不绘制 */
+export type MovePathCommand = {
+    /** 鉴别字面量 */
+    kind: 'move';
+    /** 目标点 [x, y] */
+    to: [number, number];
+};
+/** Line command：从游标到目标点画直线 */
+export type LinePathCommand = {
+    /** 鉴别字面量 */
+    kind: 'line';
+    /** 终点 [x, y] */
+    to: [number, number];
+};
+/** Quad command：二次贝塞尔，一个控制点 */
+export type QuadPathCommand = {
+    /** 鉴别字面量 */
+    kind: 'quad';
+    /** 控制点 [x, y] */
+    control: [number, number];
+    /** 终点 [x, y] */
+    to: [number, number];
+};
+/** Cubic command：三次贝塞尔，两个控制点 */
+export type CubicPathCommand = {
+    /** 鉴别字面量 */
+    kind: 'cubic';
+    /** 第一控制点 [x, y]（影响起点切线） */
+    control1: [number, number];
+    /** 第二控制点 [x, y]（影响终点切线） */
+    control2: [number, number];
+    /** 终点 [x, y] */
+    to: [number, number];
+};
+/** Arc command：以 center 为圆心、给定半径与起末角度的圆弧（center-parameterization） */
+export type ArcPathCommand = {
+    /** 鉴别字面量 */
+    kind: 'arc';
+    /** 圆心 [x, y] */
+    center: [number, number];
+    /** 半径（user units） */
+    radius: number;
+    /** 起始角度（度，0° = +x、90° = +y screen-down） */
+    startAngle: number;
+    /** 终止角度（度） */
+    endAngle: number;
+    /** 是否逆时针扫描；缺省 / `false` = CW（屏幕坐标系正向） */
+    counterClockwise?: boolean;
+};
+/** EllipseArc command：以 center 为圆心、给定 x/y 半径与起末角度的椭圆弧；可选 rotation */
+export type EllipseArcPathCommand = {
+    /** 鉴别字面量 */
+    kind: 'ellipseArc';
+    /** 圆心 [x, y] */
+    center: [number, number];
+    /** x 轴半径 */
+    radiusX: number;
+    /** y 轴半径 */
+    radiusY: number;
+    /** 椭圆整体旋转角度（度），缺省 0 */
+    rotation?: number;
+    /** 起始角度（度） */
+    startAngle: number;
+    /** 终止角度（度） */
+    endAngle: number;
+    /** 是否逆时针扫描；缺省 / `false` = CW */
+    counterClockwise?: boolean;
+};
+/** Close command：闭合当前子路径回最近一次 move 起点 */
+export type ClosePathCommand = {
+    /** 鉴别字面量；无其他字段 */
+    kind: 'close';
+};
+/**
+ * Path 命令：结构化路径绘制操作（7 分支 discriminated union）
+ * @description discriminated union 按 kind 分发；坐标 / 角度均使用 user units（角度=度，0=+x、90=+y/视觉下、CW=正）。各 adapter 自行翻译为原生 API：SVG 拼 `d` 字符串、Canvas 调 ctx.moveTo/lineTo/arc 等。每个 kind 有对应 named type export，便于 wrapper / `Pick<>` 派生。
+ */
+export type PathCommand = MovePathCommand | LinePathCommand | QuadPathCommand | CubicPathCommand | ArcPathCommand | EllipseArcPathCommand | ClosePathCommand;
+/**
+ * 端点级解析后的箭头视觉规格（Scene primitive 层）
+ * @description compile/path.ts 把 IR `arrowDetail` 顶层 + start/end merge 后产出此结构。`shape` 必填、其余视觉字段全 optional：缺省字段交给 renderer 走 context-stroke / 硬编码 fallback，保持向后兼容
+ */
+export type ArrowEndSpec = {
+    /** 形状名 */
+    shape: ArrowShape;
+    /** 等比缩放因子（乘到 length/width 上）；缺省 1 */
+    scale?: number;
+    /** 尖长（user units）；缺省让 renderer 走默认 6 */
+    length?: number;
+    /** 尖宽（user units）；缺省让 renderer 走默认 6 */
+    width?: number;
+    /** 描边颜色 override；缺省走 context-stroke（继承 path stroke） */
+    color?: string;
+    /** 填充色 override（仅实心 shape 生效；空心 shape 已在 compile 阶段被丢） */
+    fill?: string;
+    /** 箭头不透明度 0..1；缺省继承 path opacity */
+    opacity?: number;
+    /** 空心 shape 描边粗细（user units）；缺省 1.5。实心 shape 忽略 */
+    lineWidth?: number;
+};
+/** 路径原语：结构化 commands 数组；adapter 在 render 时翻译为各自原生 API */
 export type PathPrim = {
     /** 类型判别符 */
     type: 'path';
-    /** SVG path d 字符串 */
-    d: string;
+    /** 结构化路径命令序列，按数组顺序绘制 */
+    commands: Array<PathCommand>;
     /** 填充色；不填表示不填充 */
     fill?: string;
     /** 填充透明度 0~1 */
@@ -23,10 +123,10 @@ export type PathPrim = {
     strokeLinecap?: 'butt' | 'round' | 'square';
     /** 拐点形状 */
     strokeLinejoin?: 'miter' | 'round' | 'bevel';
-    /** 起点箭头形状；undefined = 无 */
-    arrowStart?: ArrowShape;
-    /** 终点箭头形状；undefined = 无 */
-    arrowEnd?: ArrowShape;
+    /** 起点箭头视觉规格；undefined = 无箭头 */
+    arrowStart?: ArrowEndSpec;
+    /** 终点箭头视觉规格；undefined = 无箭头 */
+    arrowEnd?: ArrowEndSpec;
     /** 整体透明度 0~1 */
     opacity?: number;
 };

package/dist/lib/primitive/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/primitive/path.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,kBAAkB;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACjC,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW;IACX,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC5C,WAAW;IACX,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C,2BAA2B;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/primitive/path.ts"],"names":[],"mappings":"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"}

package/dist/lib/primitive/rect.d.ts

@@ -16,11 +16,11 @@ export type RectPrim = {
     fillOpacity?: number;
     /** 描边色 */
     stroke?: string;
-    /** 描边透明度 0~1（SVG stroke-opacity） */
+    /** 描边透明度 0~1 */
     strokeOpacity?: number;
     /** 描边宽度 */
     strokeWidth?: number;
-    /** SVG stroke-dasharray 模式 */
+    /** 描边 dash 模式（如 '4 2'，与 SVG/CSS `stroke-dasharray` 同格式） */
     strokeDasharray?: string;
     /** 圆角半径（同时作用于 rx/ry） */
     cornerRadius?: number;

package/dist/lib/primitive/rect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/primitive/rect.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/primitive/rect.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,aAAa;IACb,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/lib/primitive/scene.d.ts

@@ -5,10 +5,8 @@ import { RectPrim } from './rect';
 import { TextPrim } from './text';
 import { ViewBox } from './view-box';
 /**
- * Scene primitive：渲染目标无关的最大公约子集。
- * 所有 adapter（SVG / Canvas / PDF / Skia）都应能消费这些原语。
- *
- * 不允许出现 SVG-only 或 Canvas-only 特性（filter、marker、imageData 等）。
+ * Scene primitive：渲染目标无关的最大公约子集
+ * @description 所有 adapter（SVG/Canvas/PDF/Skia）都应能消费；不允许出现 SVG-only 或 Canvas-only 特性（filter/marker/imageData）
  */
 export type ScenePrimitive = RectPrim | EllipsePrim | TextPrim | PathPrim | GroupPrim;
 /** 场景：渲染目标无关的"已布局好的图元集合 + viewBox" */

package/dist/lib/primitive/scene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/primitive/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,sCAAsC;AACtC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../../src/primitive/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,sCAAsC;AACtC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/dist/lib/primitive/text.d.ts

@@ -1,62 +1,46 @@
-/**
- * 行级字段——`<tspan>` 上可独立指定的属性。
- * 块级（TextPrim 顶层）属性是默认值；行级未填字段走块级默认。
- */
+/** 行级字段（每行可独立指定），未填走块级 TextPrim 默认 */
 export type TextLine = {
-    /** 行内容（必填） */
+    /** 行文字内容 */
     text: string;
-    /** 行字号；未填走 TextPrim.fontSize */
+    /** 行级字号 override（user units）；缺省走块级 TextPrim.fontSize */
     fontSize?: number;
-    /** 行字体族；未填走 TextPrim.fontFamily */
+    /** 行级字体族 override（CSS font-family）；缺省走块级 */
     fontFamily?: string;
-    /** 行字重；未填走 TextPrim.fontWeight */
+    /** 行级字重 override（CSS font-weight）；缺省走块级 */
     fontWeight?: string | number;
-    /** 行字形；未填走 TextPrim.fontStyle */
+    /** 行级字形 override；缺省走块级 */
     fontStyle?: 'normal' | 'italic' | 'oblique';
-    /** 行颜色；未填走 TextPrim.fill */
+    /** 行级文字颜色 override；缺省走块级 TextPrim.fill */
     fill?: string;
-    /** 行透明度 0~1；未填走 TextPrim.opacity */
+    /** 行级透明度 0..1 override；缺省走块级 */
     opacity?: number;
 };
 /**
- * 文本原语；measuredWidth / Height 由 Scene 编译阶段算好，下游直接信任。
- *
- * 多行：`lines` 至少 1 行；renderer 把每行画为 `<tspan>`，按 `lineHeight` 堆叠，
- * 整块根据 `baseline` 在 (x, y) 锚点上下居中 / 顶 / 底对齐。
- *
- * 顶层 `fontSize` / `fontFamily` / `fontWeight` / `fontStyle` / `fill` / `opacity` 是默认值；
- * 单行可在 `TextLine` 上覆盖（仅生效于该行 `<tspan>`）。
+ * 文本原语（measuredWidth/Height 由 Scene 编译阶段算好）
+ * @description 多行 lines 至少 1 行；renderer 按 lineHeight 堆叠每行、按 baseline 在 (x,y) 锚点上下对齐。顶层属性是块级默认，单行 TextLine 可覆盖
  */
 export type TextPrim = {
-    /** 类型判别符 */
     type: 'text';
-    /** 锚点横坐标（具体含义由 align 决定）；多行下作为每行 `<tspan>` 的 x */
+    /** 锚点横坐标（具体含义由 align 决定） */
     x: number;
     /** 锚点纵坐标（具体含义由 baseline 决定） */
     y: number;
-    /** 文本行（至少 1 行）；单行节点也用 `[{ text: 'Hello' }]` 形式 */
+    /** 至少 1 行；单行节点也用 `[{ text: 'Hello' }]` */
     lines: Array<TextLine>;
-    /** 块级默认字号 */
     fontSize: number;
-    /** 块级默认字体族 */
     fontFamily?: string;
-    /** 块级默认字重 */
     fontWeight?: string | number;
-    /** 块级默认字形 */
     fontStyle?: 'normal' | 'italic' | 'oblique';
-    /** 水平对齐：start / middle / end 锚点位置 */
     align: 'start' | 'middle' | 'end';
-    /** 垂直基线对齐方式 */
     baseline: 'top' | 'middle' | 'bottom' | 'alphabetic';
-    /** 行高（user units）；多行下相邻 `<tspan>` 的垂直距离 */
+    /** 行高，多行下相邻行的垂直距离 */
     lineHeight: number;
-    /** 编译期算好的整块文字宽度（user units，= max line width） */
+    /** 编译期算好的整块文字宽度 = max line width */
     measuredWidth: number;
-    /** 编译期算好的整块文字高度（user units，≈ lines × lineHeight） */
+    /** 编译期算好的整块文字高度 ≈ lines × lineHeight */
     measuredHeight: number;
-    /** 块级默认文字颜色 */
     fill?: string;
-    /** 块级默认透明度 0~1 */
+    /** 整体透明度 0~1 */
     opacity?: number;
 };
 //# sourceMappingURL=text.d.ts.map

package/dist/lib/primitive/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,iCAAiC;IACjC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,kDAAkD;IAClD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,aAAa;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,aAAa;IACb,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,qCAAqC;IACrC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,eAAe;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,0BAA0B;IAC1B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,0CAA0C;IAC1C,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IAClC,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrD,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/lib/primitive/view-box.d.ts

@@ -1,4 +1,4 @@
-/** SVG viewBox 数值四元组 */
+/** viewBox 数值四元组 `[x, y, w, h]`（与 SVG `viewBox` 同语义） */
 export type ViewBox = {
     /** 视口左上角横坐标 */
     x: number;

package/dist/lib/primitive/view-box.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view-box.d.ts","sourceRoot":"","sources":["../../../src/primitive/view-box.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,MAAM,MAAM,OAAO,GAAG;IACpB,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}
+{"version":3,"file":"view-box.d.ts","sourceRoot":"","sources":["../../../src/primitive/view-box.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,MAAM,OAAO,GAAG;IACpB,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,eAAe;IACf,CAAC,EAAE,MAAM,CAAC;IACV,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC"}

package/dist/lib/types.d.ts

@@ -1,3 +1,11 @@
 /** 获取对象所有值的联合类型，等价于 (typeof T)[keyof typeof T] */
 export type ValueOf<T extends object> = T[keyof T];
+/**
+ * 类型层等价检查工具（internal idiom，公开 API 不导出）
+ * @description 当 A、B 完全等价时类型为 `true`，否则为 `false`——配合 `as const satisfies` 实现"字段表必须完备覆盖类型 key 集合"的互锁；漏字段或多字段 TS 编译期报错
+ * @example
+ *   const NODE_FIELDS = ['id', 'shape'] as const satisfies ReadonlyArray<keyof IRNode>;
+ *   type _Check = AssertEqual<typeof NODE_FIELDS[number], keyof IRNode>;
+ */
+export type AssertEqual<TActual, TExpected> = [TActual] extends [TExpected] ? [TExpected] extends [TActual] ? true : false : false;
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,EAAE,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,GACvE,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAC3B,IAAI,GACJ,KAAK,GACP,KAAK,CAAC"}

package/package.json

@@ -1,16 +1,25 @@
 {
   "name": "@retikz/core",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-beta.1",
   "description": "retikz v0.1 core: framework-agnostic IR, scene compiler, and pure parsers.",
   "type": "module",
+  "author": "Pionpill",
   "homepage": "https://pionpill.github.io/retikz/",
   "keywords": [
-    "react",
     "tikz",
-    "chart"
+    "diagram",
+    "svg",
+    "visualization"
   ],
   "license": "MIT",
-  "repository": "https://github.com/Pionpill/retikz",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pionpill/retikz.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/Pionpill/retikz/issues"
+  },
   "sideEffects": false,
   "main": "dist/lib/index.cjs",
   "module": "dist/es/index.js",

package/dist/es/compile/path.d.ts

@@ -1,30 +0,0 @@
-import { IRPath, IRPosition } from '../ir';
-import { ScenePrimitive } from '../primitive';
-import { NodeLayout } from './node';
-import { TextMeasurer } from './text-metrics';
-/**
- * 把 IR Path 翻译为单个 PathPrim。
- *
- * 关键算法（v0.1.0-alpha.1）：每个绘制段（line / fold）**独立**地用节点中心
- * 算两端 boundary clip——一个节点在路径中段时，"入边"和"出边" boundary 点
- * 通常不同，路径会在该节点处可见地"断开"。这与 TikZ 原生语义一致：
- *
- *   `\draw (A) -- (B) -- (C);`
- *   段 1：A.center → B.center 决定 A 出口、B 入口的 boundary 交点
- *   段 2：B.center → C.center 决定 B 出口、C 入口的 boundary 交点
- *   B 在两段里 clip 出来的点不同——视觉上看到两条独立线段。
- *
- * 实现上仍只产一个 PathPrim：d 字符串里以多组 `M ... L ...` 表达多个 sub-path。
- * 当某段起点恰好等于上一段终点（例如直接坐标连续，或未触发 clip 差异）时，
- * 复用 cursor，省掉冗余 M。
- *
- * cycle 段：闭回最近一次 move 起点。若 cycle 起点 == lastEnd 且终点 == subPathStart，
- * 输出 `Z`（最优雅）；否则显式画一段 line（与"段独立 clip"一致）。
- *
- * 引用未定义节点 / 解析失败时返回 null（path 整体跳过）。
- */
-export declare const emitPathPrimitive: (path: IRPath, nodeIndex: Map<string, NodeLayout>, round: (n: number) => number, measureText?: TextMeasurer) => {
-    primitives: Array<ScenePrimitive>;
-    points: Array<IRPosition>;
-} | null;
-//# sourceMappingURL=path.d.ts.map

package/dist/es/compile/path.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/compile/path.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAEV,MAAM,EACN,UAAU,EAIX,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAY,cAAc,EAAY,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,KAAK,UAAU,EAA8C,MAAM,QAAQ,CAAC;AAGrF,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AAoWrE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAClC,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,KAC3C;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA8arE,CAAC"}