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

package/dist/es/geometry/point.d.ts

@@ -9,6 +9,12 @@ export declare const point: {
     sub: (a: Position, b: Position) => Position;
     /** 等比缩放 a * k */
     scale: (a: Position, k: number) => Position;
+    /** 向量长度 */
+    length: (a: Position) => number;
+    /** 归一化向量；零长度 / 极短向量回退到 fallback */
+    normalize: (a: Position, fallback?: Position, epsilon?: number) => Position;
+    /** 把点 p 沿 target 方向移动 dist */
+    shiftToward: (p: Position, target: Position, dist: number) => Position;
     /** 两点精确相等（不带容差） */
     equal: (a: Position, b: Position) => boolean;
     /** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */

package/dist/es/geometry/point.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../src/geometry/point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,SAAS,CAAC;AAEpD,oBAAoB;AACpB,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAIxC,wBAAwB;AACxB,eAAO,MAAM,KAAK;IAChB,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,iBAAiB;eACN,QAAQ,KAAK,MAAM,KAAG,QAAQ;IACzC,mBAAmB;eACR,QAAQ,KAAK,QAAQ,KAAG,OAAO;IAC1C,oDAAoD;iBACvC,QAAQ,KAAG,aAAa;IAIrC;;;;;OAKG;oBAEE,QAAQ,GAAG,aAAa,KACxB,QAAQ,GAAG,aAAa,yBAE1B,OAAO;CASX,CAAC"}
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../../src/geometry/point.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAS,MAAM,SAAS,CAAC;AAEpD,oBAAoB;AACpB,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAKxC,wBAAwB;AACxB,eAAO,MAAM,KAAK;IAChB,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,gBAAgB;aACP,QAAQ,KAAK,QAAQ,KAAG,QAAQ;IACzC,iBAAiB;eACN,QAAQ,KAAK,MAAM,KAAG,QAAQ;IACzC,WAAW;gBACC,QAAQ,KAAG,MAAM;IAC7B,mCAAmC;mBAE9B,QAAQ,aACD,QAAQ,uBAEjB,QAAQ;IAKX,8BAA8B;qBACb,QAAQ,UAAU,QAAQ,QAAQ,MAAM,KAAG,QAAQ;IAOpE,mBAAmB;eACR,QAAQ,KAAK,QAAQ,KAAG,OAAO;IAC1C,oDAAoD;iBACvC,QAAQ,KAAG,aAAa;IAIrC;;;;;OAKG;oBAEE,QAAQ,GAAG,aAAa,KACxB,QAAQ,GAAG,aAAa,yBAE1B,OAAO;CASX,CAAC"}

package/dist/es/geometry/point.js

@@ -1,6 +1,7 @@
 import { polar } from "./polar.js";
 //#region src/geometry/point.ts
 var RAD_TO_DEG = 180 / Math.PI;
+var DEFAULT_EPSILON = 1e-9;
 /** 二维向量 / 坐标的基础运算工具集 */
 var point = {
 	/** 向量加 a + b */
@@ -9,6 +10,22 @@ var point = {
 	sub: (a, b) => [a[0] - b[0], a[1] - b[1]],
 	/** 等比缩放 a * k */
 	scale: (a, k) => [a[0] * k, a[1] * k],
+	/** 向量长度 */
+	length: (a) => Math.hypot(a[0], a[1]),
+	/** 归一化向量；零长度 / 极短向量回退到 fallback */
+	normalize: (a, fallback = [1, 0], epsilon = DEFAULT_EPSILON) => {
+		const len = Math.hypot(a[0], a[1]);
+		if (len < epsilon) return fallback;
+		return [a[0] / len, a[1] / len];
+	},
+	/** 把点 p 沿 target 方向移动 dist */
+	shiftToward: (p, target, dist) => {
+		if (dist === 0) return p;
+		const delta = [target[0] - p[0], target[1] - p[1]];
+		const dir = point.normalize(delta, [0, 0]);
+		if (point.equal(dir, [0, 0])) return p;
+		return [p[0] + dir[0] * dist, p[1] + dir[1] * dist];
+	},
 	/** 两点精确相等（不带容差） */
 	equal: (a, b) => a[0] === b[0] && a[1] === b[1],
 	/** 笛卡尔 → 极坐标（angle ∈ (-180,180]，origin 默认 [0,0]） */

package/dist/es/geometry/rect.d.ts

@@ -1,4 +1,5 @@
-import { Side } from './_edge';
+import { Side } from './edge';
+import { CompassAnchorValue } from './anchor';
 import { Position } from './point';
 /** 轴对齐矩形：几何中心 + 宽高 + 可选绕中心旋转 */
 export type Rect = {
@@ -9,27 +10,13 @@ export type Rect = {
     /** 绕中心旋转弧度 */
     rotate?: number;
 };
-/** 矩形 9 个标准 anchor 名常量（与 RectAnchor 配对，用 RECT_ANCHORS.NORTH 避免拼错） */
-export declare const RECT_ANCHORS: {
-    readonly CENTER: "center";
-    readonly NORTH: "north";
-    readonly SOUTH: "south";
-    readonly EAST: "east";
-    readonly WEST: "west";
-    readonly NORTH_EAST: "north-east";
-    readonly NORTH_WEST: "north-west";
-    readonly SOUTH_EAST: "south-east";
-    readonly SOUTH_WEST: "south-west";
-};
-/** 矩形 anchor 名（与 TikZ 命名一致） */
-export type RectAnchor = (typeof RECT_ANCHORS)[keyof typeof RECT_ANCHORS];
 export declare const rect: {
     /** 几何中心 */
     center: (r: Rect) => Position;
     /** 点是否在矩形内（含边界，含旋转） */
     contains: (r: Rect, p: Position) => boolean;
-    /** 9 个 anchor 之一的世界坐标（含旋转），TikZ 命名 */
-    anchor: (r: Rect, name: RectAnchor) => Position;
+    /** 9 个标准方位 anchor 之一的世界坐标（含旋转），TikZ 命名 */
+    anchor: (r: Rect, name: CompassAnchorValue) => Position;
     /** 从中心向 toward 方向射线与矩形边界交点（含旋转），Path 端点贴 Node 边界用 */
     boundaryPoint: (r: Rect, toward: Position) => Position;
     /** 边上比例点：side 直边 t∈[0,1] 处（两角 anchor 线性插值，含旋转）；方向见 EDGE_ENDS */

package/dist/es/geometry/rect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,IAAI,EAAa,MAAM,SAAS,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,YAAY;;;;;;;;;;CAUf,CAAC;AAEX,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE1E,eAAO,MAAM,IAAI;IACf,WAAW;gBACC,IAAI,KAAG,QAAQ;IAC3B,uBAAuB;kBACT,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC,sCAAsC;gBAC1B,IAAI,QAAQ,UAAU,KAAG,QAAQ;IAuC7C,qDAAqD;uBAClC,IAAI,UAAU,QAAQ,KAAG,QAAQ;IAUpD,gEAAgE;mBACjD,IAAI,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAItD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,eAAe,MAAM,KACpB,KAAK,CAAC,aAAa,CAgCrB,CAAC"}
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../src/geometry/rect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,IAAI,EAAa,MAAM,QAAQ,CAAC;AAEzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,gCAAgC;AAChC,MAAM,MAAM,IAAI,GAAG;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,IAAI;IACf,WAAW;gBACC,IAAI,KAAG,QAAQ;IAC3B,uBAAuB;kBACT,IAAI,KAAK,QAAQ,KAAG,OAAO;IAMzC,0CAA0C;gBAC9B,IAAI,QAAQ,kBAAkB,KAAG,QAAQ;IAuCrD,qDAAqD;uBAClC,IAAI,UAAU,QAAQ,KAAG,QAAQ;IAUpD,gEAAgE;mBACjD,IAAI,QAAQ,IAAI,KAAK,MAAM,KAAG,QAAQ;CAItD,CAAC;AAEF,4FAA4F;AAC5F,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtB;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,eAAe,MAAM,KACpB,KAAK,CAAC,aAAa,CAgCrB,CAAC"}

package/dist/es/geometry/rect.js

@@ -1,18 +1,6 @@
-import { localToWorld, worldToLocal } from "./_transform.js";
-import { EDGE_ENDS, lerpPoint } from "./_edge.js";
+import { EDGE_ENDS, lerpPoint } from "./edge.js";
+import { localToWorld, worldToLocal } from "./transform.js";
 //#region src/geometry/rect.ts
-/** 矩形 9 个标准 anchor 名常量（与 RectAnchor 配对，用 RECT_ANCHORS.NORTH 避免拼错） */
-var RECT_ANCHORS = {
-	CENTER: "center",
-	NORTH: "north",
-	SOUTH: "south",
-	EAST: "east",
-	WEST: "west",
-	NORTH_EAST: "north-east",
-	NORTH_WEST: "north-west",
-	SOUTH_EAST: "south-east",
-	SOUTH_WEST: "south-west"
-};
 var rect = {
 	/** 几何中心 */
 	center: (r) => [r.x, r.y],
@@ -23,7 +11,7 @@ var rect = {
 		const halfH = r.height / 2;
 		return lx >= -halfW && lx <= halfW && ly >= -halfH && ly <= halfH;
 	},
-	/** 9 个 anchor 之一的世界坐标（含旋转），TikZ 命名 */
+	/** 9 个标准方位 anchor 之一的世界坐标（含旋转），TikZ 命名 */
 	anchor: (r, name) => {
 		const halfW = r.width / 2;
 		const halfH = r.height / 2;
@@ -163,4 +151,4 @@ var rectOutline = (from, to, cornerRadius) => {
 	];
 };
 //#endregion
-export { RECT_ANCHORS, rect, rectOutline };
+export { rect, rectOutline };

package/dist/es/geometry/segment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAiBxC;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAQF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,GAClC,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aASF,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aASF,CAAC"}
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,SAAS,CAAC;AAiB3D;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,wBAAwB;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,iCAAiC;IACjC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAqBF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAAwF,CAAC;AAE5F,gEAAgE;AAChE,eAAO,MAAM,uBAAuB,GAClC,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAAgF,CAAC;AAEpF,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aAAoE,CAAC;AAExE,yCAAyC;AACzC,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aAA4D,CAAC"}

package/dist/es/geometry/segment.js

@@ -1,14 +1,20 @@
+import { point } from "./point.js";
 //#region src/geometry/segment.ts
 var DEG_TO_RAD = Math.PI / 180;
-var normalize = (v) => {
-	const len = Math.hypot(v[0], v[1]);
-	if (len === 0) return [1, 0];
-	return [v[0] / len, v[1] / len];
+var sampleEllipseArc = (center, rx, ry, startAngleDeg, endAngleDeg, t) => {
+	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
+	const cos = Math.cos(rad);
+	const sin = Math.sin(rad);
+	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
+	return {
+		point: [center[0] + rx * cos, center[1] + ry * sin],
+		tangent: point.normalize([-rx * sin * sweepSign, ry * cos * sweepSign])
+	};
 };
 /** 直线段 from → to */
 var lineSegmentSample = (from, to, t) => ({
 	point: [from[0] + (to[0] - from[0]) * t, from[1] + (to[1] - from[1]) * t],
-	tangent: normalize([to[0] - from[0], to[1] - from[1]])
+	tangent: point.normalize([to[0] - from[0], to[1] - from[1]])
 });
 /**
 * 二次贝塞尔 from → control → to
@@ -16,9 +22,12 @@ var lineSegmentSample = (from, to, t) => ({
 */
 var quadSegmentSample = (from, control, to, t) => {
 	const u = 1 - t;
+	const point$1 = [u * u * from[0] + 2 * u * t * control[0] + t * t * to[0], u * u * from[1] + 2 * u * t * control[1] + t * t * to[1]];
+	const tx = 2 * u * (control[0] - from[0]) + 2 * t * (to[0] - control[0]);
+	const ty = 2 * u * (control[1] - from[1]) + 2 * t * (to[1] - control[1]);
 	return {
-		point: [u * u * from[0] + 2 * u * t * control[0] + t * t * to[0], u * u * from[1] + 2 * u * t * control[1] + t * t * to[1]],
-		tangent: normalize([2 * u * (control[0] - from[0]) + 2 * t * (to[0] - control[0]), 2 * u * (control[1] - from[1]) + 2 * t * (to[1] - control[1])])
+		point: point$1,
+		tangent: point.normalize([tx, ty])
 	};
 };
 /**
@@ -27,9 +36,12 @@ var quadSegmentSample = (from, control, to, t) => {
 */
 var cubicSegmentSample = (from, c1, c2, to, t) => {
 	const u = 1 - t;
+	const point$2 = [u * u * u * from[0] + 3 * u * u * t * c1[0] + 3 * u * t * t * c2[0] + t * t * t * to[0], u * u * u * from[1] + 3 * u * u * t * c1[1] + 3 * u * t * t * c2[1] + t * t * t * to[1]];
+	const tx = 3 * u * u * (c1[0] - from[0]) + 6 * u * t * (c2[0] - c1[0]) + 3 * t * t * (to[0] - c2[0]);
+	const ty = 3 * u * u * (c1[1] - from[1]) + 6 * u * t * (c2[1] - c1[1]) + 3 * t * t * (to[1] - c2[1]);
 	return {
-		point: [u * u * u * from[0] + 3 * u * u * t * c1[0] + 3 * u * t * t * c2[0] + t * t * t * to[0], u * u * u * from[1] + 3 * u * u * t * c1[1] + 3 * u * t * t * c2[1] + t * t * t * to[1]],
-		tangent: normalize([3 * u * u * (c1[0] - from[0]) + 6 * u * t * (c2[0] - c1[0]) + 3 * t * t * (to[0] - c2[0]), 3 * u * u * (c1[1] - from[1]) + 6 * u * t * (c2[1] - c1[1]) + 3 * t * t * (to[1] - c2[1])])
+		point: point$2,
+		tangent: point.normalize([tx, ty])
 	};
 };
 /**
@@ -41,46 +53,12 @@ var foldSegmentSample = (from, corner, to, t) => {
 	return lineSegmentSample(corner, to, t * 2 - 1);
 };
 /** 弧段（角度度数，与 ir/path arc 同约定）；切线沿扫描方向：endAngle ≥ start 取 (-sin,cos)，否则反向 */
-var arcSegmentSample = (center, radius, startAngleDeg, endAngleDeg, t) => {
-	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
-	return {
-		point: [center[0] + radius * cos, center[1] + radius * sin],
-		tangent: normalize([-sin * sweepSign, cos * sweepSign])
-	};
-};
+var arcSegmentSample = (center, radius, startAngleDeg, endAngleDeg, t) => sampleEllipseArc(center, radius, radius, startAngleDeg, endAngleDeg, t);
 /** 椭圆弧段（参数角度数，与 ir/path arc 同约定）；点用 (rx·cos, ry·sin)，切线沿扫描方向 */
-var ellipseArcSegmentSample = (center, rx, ry, startAngleDeg, endAngleDeg, t) => {
-	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
-	return {
-		point: [center[0] + rx * cos, center[1] + ry * sin],
-		tangent: normalize([-rx * sin * sweepSign, ry * cos * sweepSign])
-	};
-};
+var ellipseArcSegmentSample = (center, rx, ry, startAngleDeg, endAngleDeg, t) => sampleEllipseArc(center, rx, ry, startAngleDeg, endAngleDeg, t);
 /** 整圆，从 0°(east) 开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致 */
-var circleSegmentSample = (center, radius, t) => {
-	const rad = t * 360 * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	return {
-		point: [center[0] + radius * cos, center[1] + radius * sin],
-		tangent: normalize([-sin, cos])
-	};
-};
+var circleSegmentSample = (center, radius, t) => sampleEllipseArc(center, radius, radius, 0, 360, t);
 /** 整椭圆，参数化 (rx·cos(2πt), ry·sin(2πt)) */
-var ellipseSegmentSample = (center, rx, ry, t) => {
-	const rad = t * 360 * DEG_TO_RAD;
-	const cos = Math.cos(rad);
-	const sin = Math.sin(rad);
-	return {
-		point: [center[0] + rx * cos, center[1] + ry * sin],
-		tangent: normalize([-rx * sin, ry * cos])
-	};
-};
+var ellipseSegmentSample = (center, rx, ry, t) => sampleEllipseArc(center, rx, ry, 0, 360, t);
 //#endregion
 export { arcSegmentSample, circleSegmentSample, cubicSegmentSample, ellipseArcSegmentSample, ellipseSegmentSample, foldSegmentSample, lineSegmentSample, quadSegmentSample };

package/dist/{lib/geometry/_transform.d.ts → es/geometry/transform.d.ts}

@@ -18,4 +18,4 @@ export declare const localToWorld: (s: CenteredShape, local: Position) => Positi
  * @description 先反平移到中心、再反旋转回本地基；旋转矩阵转置即逆
  */
 export declare const worldToLocal: (s: CenteredShape, world: Position) => Position;
-//# sourceMappingURL=_transform.d.ts.map
+//# sourceMappingURL=transform.d.ts.map

package/dist/es/geometry/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/geometry/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,OAAO,QAAQ,KAAG,QAShE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,OAAO,QAAQ,KAAG,QAQhE,CAAC"}

package/dist/es/geometry/{_transform.js → transform.js}

@@ -1,4 +1,4 @@
-//#region src/geometry/_transform.ts
+//#region src/geometry/transform.ts
 /**
 * 本地坐标（以中心为原点）→ 世界坐标
 * @description rotate=0 / 缺省时退化为平移；非零时按右手系绕中心旋转后再平移

package/dist/es/index.d.ts

@@ -2,10 +2,11 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/render/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
-export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, PATTERN_SHAPES, Boundary, BoundarySchema, } from './ir';
-export type { BoundaryKeyword, IRBoundary } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AtDirection, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirectionValue, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShapeValue, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, BuiltinShapeValue, NodeTextAlignValue, PatternShapeValue, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
+export { ArrowShape, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, BuiltinShape, NodeTextAlign, PatternShape, Boundary, BoundarySchema, AnimationProperty, AnimationEasing, AnimationDirection, AnimationFill, AnimationTrigger, AnimationTrackSchema, KeyframeSchema, TriggerSchema, EasingSchema, OriginSchema, } from './ir';
+export type { BoundaryValue, IRBoundary } from './ir';
+export type { BuiltinAnimationProperty, AnimationPropertyRef, AnimationEasingValue, AnimationDirectionValue, AnimationFillValue, AnimationTriggerValue, IRAnimationTrack, IRKeyframe, IRAnimationTrigger, IRAnimationOrigin, } from './ir';
 export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
 MovePathCommand, LinePathCommand, QuadPathCommand, CubicPathCommand, ArcPathCommand, EllipseArcPathCommand, ClosePathCommand, ArrowEndSpec, GroupPrim, Transform, 
@@ -21,16 +22,18 @@ export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, CompileWarnin
 export { computeLayout, fallbackMeasurer, compileToScene } from './compile';
 export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayLabelOp, } from './parsers';
 export { parseWay, DrawWay, parseTargetSugar, parseNodeTarget } from './parsers';
-export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
-export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
+export { fadeIn, drawOn, scaleIn, grow, growUp, slideIn, colorShift, cameraTo, pulse, spin, loop, flash, blink, wiggle, stagger, } from './presets';
+export type { AnimationPresetOptions, ScaleInOptions, GrowUpOptions, SlideInOptions, ColorShiftOptions, CameraToOptions, PulseOptions, SpinOptions, LoopOptions, FlashOptions, BlinkOptions, WiggleOptions, } from './presets';
+export type { Position, CompassAnchorValue, AnchorInput, WebAnchorValue, Rect, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
+export { point, CompassAnchor, WebAnchor, normalizeCompassAnchor, rect, circle, ellipse, diamond, polar, } from './geometry';
 export type { ShapeDefinition, ShapeDefinitionInput, ShapeStyle } from './shapes';
 export { BUILTIN_SHAPES, defineShape, worldToLocal, localToWorld } from './shapes';
 export type { ArrowDefinition, ArrowEmitContext } from './arrows';
-export { BUILTIN_ARROWS } from './arrows';
+export { BUILTIN_ARROWS, defineArrow } from './arrows';
 export type { PatternDefinition, PatternEmitContext } from './patterns';
-export { BUILTIN_PATTERNS } from './patterns';
-export type { PathGeneratorDefinition, PathGeneratorContext } from './pathGenerators';
-export { definePathGenerator } from './pathGenerators';
+export { BUILTIN_PATTERNS, definePattern } from './patterns';
+export type { PathGeneratorDefinition, PathGeneratorContext } from './path-generators';
+export { definePathGenerator } from './path-generators';
 export type { CompositeDefinition } from './composites';
 export { defineComposite } from './composites';
 export type { ValueOf, AssertEqual } from './types';

package/dist/es/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/es/index.js

@@ -1,6 +1,6 @@
 import { PositionSchema } from "./ir/position/position.js";
 import { PolarPositionSchema } from "./ir/position/polar-position.js";
-import { AT_DIRECTIONS, AtPositionSchema } from "./ir/position/at-position.js";
+import { AtDirection, AtPositionSchema } from "./ir/position/at-position.js";
 import { OffsetPositionSchema } from "./ir/position/offset-position.js";
 import { JsonObjectSchema, JsonValueSchema } from "./ir/json.js";
 import { ShapeRefSchema } from "./ir/shape.js";
@@ -8,35 +8,40 @@ import { Boundary, BoundarySchema } from "./ir/boundary.js";
 import { AnchorRefSchema, NodeTargetSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, TargetSchema } from "./ir/path/target.js";
 import { AbsoluteTargetSchema, BetweenPositionSchema } from "./ir/position/between-position.js";
 import { FontSchema } from "./ir/font.js";
-import { GradientStopSchema, PATTERN_SHAPES, PaintSpecSchema } from "./ir/paint.js";
+import { AnimationDirection, AnimationEasing, AnimationFill, AnimationProperty, AnimationTrackSchema, AnimationTrigger, EasingSchema, KeyframeSchema, OriginSchema, TriggerSchema } from "./ir/animation.js";
+import { GradientStopSchema, PaintSpecSchema, PatternShape } from "./ir/paint.js";
 import { ClipSpecSchema } from "./ir/clip.js";
 import { LineSpecSchema, TextBlockSchema } from "./ir/text.js";
-import { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, ArrowDetailSchema, ArrowEndDetailSchema, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES } from "./ir/path/arrow.js";
+import { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ArrowDetailSchema, ArrowEndDetailSchema, ArrowShape, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES } from "./ir/path/arrow.js";
 import { ArcStepSchema, BendStepSchema, CirclePathStepSchema, ControlPointSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, EllipsePathStepSchema, FoldStepSchema, GeneratorStepSchema, LineStepSchema, MoveStepSchema, RectangleStepSchema, StepLabelSchema, StepSchema } from "./ir/path/step.js";
 import { PathSchema } from "./ir/path/path.js";
-import { NODE_SHAPES, NODE_TEXT_ALIGNS, NodeLabelSchema, NodeSchema } from "./ir/node.js";
+import { BuiltinShape, NodeLabelSchema, NodeSchema, NodeTextAlign } from "./ir/node.js";
 import { CoordinateSchema } from "./ir/coordinate.js";
 import { TransformSchema } from "./ir/transform.js";
 import { ArrowDefaultSchema, LabelDefaultSchema, NodeDefaultSchema, PathDefaultSchema, ScopeSchema } from "./ir/scope.js";
 import { CompositeBaseSchema } from "./ir/composite.js";
 import { CURRENT_IR_VERSION, ChildSchema, SceneSchema, ViewBoxSchema } from "./ir/scene.js";
-import { localToWorld, worldToLocal } from "./geometry/_transform.js";
-import { RECT_ANCHORS, rect } from "./geometry/rect.js";
+import { localToWorld, worldToLocal } from "./geometry/transform.js";
+import { rect } from "./geometry/rect.js";
 import { defineShape } from "./shapes/define.js";
 import { ellipse } from "./geometry/ellipse.js";
+import { CompassAnchor, WebAnchor, normalizeCompassAnchor } from "./geometry/anchor.js";
+import { polar } from "./geometry/polar.js";
+import { point } from "./geometry/point.js";
 import { BUILTIN_SHAPES } from "./shapes/index.js";
+import { defineArrow } from "./arrows/define.js";
 import { BUILTIN_ARROWS } from "./arrows/index.js";
+import { definePattern } from "./patterns/define.js";
 import { BUILTIN_PATTERNS } from "./patterns/index.js";
 import { fallbackMeasurer } from "./compile/text-metrics.js";
 import { computeLayout } from "./compile/layout.js";
 import { compileToScene } from "./compile/compile.js";
-import { parseNodeTarget } from "./parsers/parseNodeTarget.js";
-import { parseTargetSugar } from "./parsers/parseTargetSugar.js";
-import { DrawWay, parseWay } from "./parsers/parseWay.js";
-import { polar } from "./geometry/polar.js";
-import { point } from "./geometry/point.js";
+import { parseNodeTarget } from "./parsers/node-target.js";
+import { parseTargetSugar } from "./parsers/target-sugar.js";
+import { DrawWay, parseWay } from "./parsers/way.js";
+import { blink, cameraTo, colorShift, drawOn, fadeIn, flash, grow, growUp, loop, pulse, scaleIn, slideIn, spin, stagger, wiggle } from "./presets/animation.js";
 import { circle } from "./geometry/circle.js";
 import { diamond } from "./geometry/diamond.js";
-import { definePathGenerator } from "./pathGenerators/define.js";
-import { defineComposite } from "./composites/types.js";
-export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, ARROW_SHAPES, AT_DIRECTIONS, AbsoluteTargetSchema, AnchorRefSchema, ArcStepSchema, ArrowDefaultSchema, ArrowDetailSchema, ArrowEndDetailSchema, AtPositionSchema, BUILTIN_ARROWS, BUILTIN_PATTERNS, BUILTIN_SHAPES, BendStepSchema, BetweenPositionSchema, Boundary, BoundarySchema, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ClipSpecSchema, CompositeBaseSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DEFAULT_ARROW_SHAPE, DrawWay, EllipsePathStepSchema, FoldStepSchema, FontSchema, GeneratorStepSchema, GradientStopSchema, HOLLOW_ARROW_SHAPES, JsonObjectSchema, JsonValueSchema, LabelDefaultSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NODE_SHAPES, NODE_TEXT_ALIGNS, NodeDefaultSchema, NodeLabelSchema, NodeSchema, NodeTargetSchema, OffsetPositionSchema, PATTERN_SHAPES, PaintSpecSchema, PathDefaultSchema, PathSchema, PolarPositionSchema, PositionSchema, RECT_ANCHORS, RectangleStepSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, ScopeSchema, ShapeRefSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, TransformSchema, ViewBoxSchema, circle, compileToScene, computeLayout, defineComposite, definePathGenerator, defineShape, diamond, ellipse, fallbackMeasurer, localToWorld, parseNodeTarget, parseTargetSugar, parseWay, point, polar, rect, worldToLocal };
+import { definePathGenerator } from "./path-generators/define.js";
+import { defineComposite } from "./composites/define.js";
+export { ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, AbsoluteTargetSchema, AnchorRefSchema, AnimationDirection, AnimationEasing, AnimationFill, AnimationProperty, AnimationTrackSchema, AnimationTrigger, ArcStepSchema, ArrowDefaultSchema, ArrowDetailSchema, ArrowEndDetailSchema, ArrowShape, AtDirection, AtPositionSchema, BUILTIN_ARROWS, BUILTIN_PATTERNS, BUILTIN_SHAPES, BendStepSchema, BetweenPositionSchema, Boundary, BoundarySchema, BuiltinShape, CURRENT_IR_VERSION, ChildSchema, CirclePathStepSchema, ClipSpecSchema, CompassAnchor, CompositeBaseSchema, ControlPointSchema, CoordinateSchema, CubicStepSchema, CurveStepSchema, CycleStepSchema, DEFAULT_ARROW_SHAPE, DrawWay, EasingSchema, EllipsePathStepSchema, FoldStepSchema, FontSchema, GeneratorStepSchema, GradientStopSchema, HOLLOW_ARROW_SHAPES, JsonObjectSchema, JsonValueSchema, KeyframeSchema, LabelDefaultSchema, LineSpecSchema, LineStepSchema, MoveStepSchema, NodeDefaultSchema, NodeLabelSchema, NodeSchema, NodeTargetSchema, NodeTextAlign, OffsetPositionSchema, OriginSchema, PaintSpecSchema, PathDefaultSchema, PathSchema, PatternShape, PolarPositionSchema, PositionSchema, RectangleStepSchema, RelativeAccumulateTargetSchema, RelativeTargetSchema, SceneSchema, ScopeSchema, ShapeRefSchema, StepLabelSchema, StepSchema, TargetSchema, TextBlockSchema, TransformSchema, TriggerSchema, ViewBoxSchema, WebAnchor, blink, cameraTo, circle, colorShift, compileToScene, computeLayout, defineArrow, defineComposite, definePathGenerator, definePattern, defineShape, diamond, drawOn, ellipse, fadeIn, fallbackMeasurer, flash, grow, growUp, localToWorld, loop, normalizeCompassAnchor, parseNodeTarget, parseTargetSugar, parseWay, point, polar, pulse, rect, scaleIn, slideIn, spin, stagger, wiggle, worldToLocal };

package/dist/es/ir/animation.d.ts

@@ -0,0 +1,219 @@
+import { z } from 'zod';
+import { ValueOf } from '../types';
+/**
+ * 可动画属性通道（renderer 无关；DrawWay 风格 const + 派生类型，裸字面量 'opacity' 仍第一形态）
+ * @description `viewBox` 仅在 scene 根合法（镜头），元素级 viewBox track 由 compile / render 拒；
+ *   `pathDraw` 是 0..1 路径画出进度；`scaleX` / `scaleY` 是非均匀缩放（柱状图从基线长出等），`scale` 是均匀缩放；
+ *   transform 通道（scale / scaleX / scaleY / rotate）的支点见 track 级 `origin`，缺省几何中心。
+ *   各后端按通道翻译：SVG WAAPI/CSS、Canvas rAF 几何 lerp。
+ */
+export declare const AnimationProperty: {
+    readonly Opacity: "opacity";
+    readonly Fill: "fill";
+    readonly Stroke: "stroke";
+    readonly StrokeWidth: "strokeWidth";
+    readonly TranslateX: "translateX";
+    readonly TranslateY: "translateY";
+    readonly Rotate: "rotate";
+    readonly Scale: "scale";
+    readonly ScaleX: "scaleX";
+    readonly ScaleY: "scaleY";
+    readonly PathDraw: "pathDraw";
+    readonly ViewBox: "viewBox";
+};
+/** 内置可动画属性通道名联合 */
+export type AnimationPropertyValue = ValueOf<typeof AnimationProperty>;
+export type BuiltinAnimationProperty = AnimationPropertyValue;
+/** 属性名：内置 ∪ 任意自定义字符串（`& {}` 保内置自动补全，同 NodeShape 范式）；自定义通道由后续 renderer 注册的插值器解释 */
+export type AnimationPropertyRef = BuiltinAnimationProperty | (string & {});
+/** 缓动具名预设（与 CSS 同名）；track / keyframe 亦可改用 cubic-bezier 四元组 */
+export declare const AnimationEasing: {
+    readonly Linear: "linear";
+    readonly Ease: "ease";
+    readonly EaseIn: "ease-in";
+    readonly EaseOut: "ease-out";
+    readonly EaseInOut: "ease-in-out";
+};
+/** 缓动预设名联合 */
+export type AnimationEasingValue = ValueOf<typeof AnimationEasing>;
+/** 每次迭代的播放方向（抄 WAAPI / CSS animation-direction） */
+export declare const AnimationDirection: {
+    readonly Normal: "normal";
+    readonly Reverse: "reverse";
+    readonly Alternate: "alternate";
+    readonly AlternateReverse: "alternate-reverse";
+};
+/** 播放方向名联合 */
+export type AnimationDirectionValue = ValueOf<typeof AnimationDirection>;
+/** 活动区间外取值（抄 WAAPI / CSS animation-fill-mode） */
+export declare const AnimationFill: {
+    readonly None: "none";
+    readonly Forwards: "forwards";
+    readonly Backwards: "backwards";
+    readonly Both: "both";
+};
+/** 填充模式名联合 */
+export type AnimationFillValue = ValueOf<typeof AnimationFill>;
+export declare const EasingSchema: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>;
+export declare const KeyframeSchema: z.ZodObject<{
+    at: z.ZodNumber;
+    value: z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>;
+    easing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>>;
+}, "strip", z.ZodTypeAny, {
+    value: import('./json').JsonValue;
+    at: number;
+    easing?: string | [number, number, number, number] | undefined;
+}, {
+    value: import('./json').JsonValue;
+    at: number;
+    easing?: string | [number, number, number, number] | undefined;
+}>;
+/** 播放触发器关键字（runtime 落地；DrawWay 风格 const + 派生类型，与其它 Animation 枚举单一真源一致） */
+export declare const AnimationTrigger: {
+    readonly Load: "load";
+    readonly Visible: "visible";
+    readonly Manual: "manual";
+};
+/** 触发器关键字联合（不含 { onEvent } 对象形态） */
+export type AnimationTriggerValue = ValueOf<typeof AnimationTrigger>;
+export declare const TriggerSchema: z.ZodUnion<[z.ZodNativeEnum<{
+    readonly Load: "load";
+    readonly Visible: "visible";
+    readonly Manual: "manual";
+}>, z.ZodObject<{
+    onEvent: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    onEvent: string;
+}, {
+    onEvent: string;
+}>]>;
+export declare const OriginSchema: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>;
+export declare const AnimationTrackSchema: z.ZodEffects<z.ZodObject<{
+    property: z.ZodString;
+    keyframes: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        at: z.ZodNumber;
+        value: z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>;
+        easing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }, {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }>, "many">, {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[], {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[]>;
+    duration: z.ZodNumber;
+    delay: z.ZodOptional<z.ZodNumber>;
+    easing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>>;
+    iterations: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"infinite">]>>;
+    direction: z.ZodOptional<z.ZodNativeEnum<{
+        readonly Normal: "normal";
+        readonly Reverse: "reverse";
+        readonly Alternate: "alternate";
+        readonly AlternateReverse: "alternate-reverse";
+    }>>;
+    fill: z.ZodOptional<z.ZodNativeEnum<{
+        readonly None: "none";
+        readonly Forwards: "forwards";
+        readonly Backwards: "backwards";
+        readonly Both: "both";
+    }>>;
+    trigger: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
+        readonly Load: "load";
+        readonly Visible: "visible";
+        readonly Manual: "manual";
+    }>, z.ZodObject<{
+        onEvent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        onEvent: string;
+    }, {
+        onEvent: string;
+    }>]>>;
+    origin: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>>;
+}, "strip", z.ZodTypeAny, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}>, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}>;
+/** 时间轴动画 track（renderer 无关、JSON 可序列化、无函数；keyframe 给绝对展示值、末帧 = 元素 base 终态） */
+export type IRAnimationTrack = z.infer<typeof AnimationTrackSchema>;
+/** 单个动画关键帧 */
+export type IRKeyframe = z.infer<typeof KeyframeSchema>;
+/** transform 支点（命名 anchor ∪ 局部坐标点；scale / scaleX / scaleY / rotate 用，缺省几何中心） */
+export type IRAnimationOrigin = z.infer<typeof OriginSchema>;
+/** 动画播放触发器（load / visible / manual / { onEvent }） */
+export type IRAnimationTrigger = z.infer<typeof TriggerSchema>;
+//# sourceMappingURL=animation.d.ts.map