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

package/dist/lib/presets/animation.cjs

@@ -0,0 +1,286 @@
+const require_animation = require("../ir/animation.cjs");
+//#region src/presets/animation.ts
+/**
+* 具名动画 preset 工厂（Sugar）：把 roadmap §动画配方表实装成 `fadeIn()` / `spin()` / `growUp()` … 函数
+* @description 纯函数、产 `IRAnimationTrack`，用于 `animations={[fadeIn(), scaleIn()]}`。不引入新能力——
+*   产出逐字段等于手写 track（Sugar=Kernel 等价），播放 / 降级全走 renderer 既有通路。默认值 = 配方表，单一真源。
+*/
+/** 把公共项叠到 track（duration/easing 取 opts 覆盖否则 preset 默认；delay/trigger 仅在给定时写入） */
+var applyBase = (base, opts) => ({
+	duration: opts.duration ?? base.duration,
+	easing: opts.easing ?? base.easing,
+	...opts.delay !== void 0 ? { delay: opts.delay } : {},
+	...opts.trigger !== void 0 ? { trigger: opts.trigger } : {}
+});
+/** 淡入：`opacity` 0→1（末帧 = base，降级见完整图） */
+var fadeIn = (opts = {}) => ({
+	property: require_animation.AnimationProperty.Opacity,
+	keyframes: [{
+		at: 0,
+		value: 0
+	}, {
+		at: 1,
+		value: 1
+	}],
+	...applyBase({
+		duration: 400,
+		easing: "ease-out"
+	}, opts)
+});
+/** 描边画出：`pathDraw` 0→1（仅对有描边元素有效） */
+var drawOn = (opts = {}) => ({
+	property: require_animation.AnimationProperty.PathDraw,
+	keyframes: [{
+		at: 0,
+		value: 0
+	}, {
+		at: 1,
+		value: 1
+	}],
+	...applyBase({
+		duration: 600,
+		easing: "ease-in-out"
+	}, opts)
+});
+/** 缩放入场：`scale` from→1（均匀，绕 origin） */
+var scaleIn = (opts = {}) => ({
+	property: require_animation.AnimationProperty.Scale,
+	keyframes: [{
+		at: 0,
+		value: opts.from ?? .8
+	}, {
+		at: 1,
+		value: 1
+	}],
+	...opts.origin !== void 0 ? { origin: opts.origin } : {},
+	...applyBase({
+		duration: 400,
+		easing: "ease-out"
+	}, opts)
+});
+/** 从无到有放大：`scaleIn` 的 `from: 0` 别名 */
+var grow = (opts = {}) => scaleIn({
+	...opts,
+	from: 0
+});
+/** 从基线长出：`scaleY` 0→1，支点底边（柱状图入场） */
+var growUp = (opts = {}) => ({
+	property: require_animation.AnimationProperty.ScaleY,
+	keyframes: [{
+		at: 0,
+		value: 0
+	}, {
+		at: 1,
+		value: 1
+	}],
+	origin: opts.origin ?? "south",
+	...applyBase({
+		duration: 500,
+		easing: "ease-out"
+	}, opts)
+});
+/** 滑入：`translateX|Y` offset→0 */
+var slideIn = (opts = {}) => ({
+	property: (opts.axis ?? "x") === "y" ? require_animation.AnimationProperty.TranslateY : require_animation.AnimationProperty.TranslateX,
+	keyframes: [{
+		at: 0,
+		value: opts.offset ?? -20
+	}, {
+		at: 1,
+		value: 0
+	}],
+	...applyBase({
+		duration: 400,
+		easing: "ease-out"
+	}, opts)
+});
+/** 变色：`fill|stroke` from→to（oklch 插值，由 renderer 端处理） */
+var colorShift = (opts) => {
+	const { from, to } = opts;
+	if (from == null || to == null) throw new Error("colorShift: `from` and `to` colors are required.");
+	return {
+		property: (opts.channel ?? "fill") === "stroke" ? require_animation.AnimationProperty.Stroke : require_animation.AnimationProperty.Fill,
+		keyframes: [{
+			at: 0,
+			value: from
+		}, {
+			at: 1,
+			value: to
+		}],
+		...applyBase({
+			duration: 400,
+			easing: "ease-in-out"
+		}, opts)
+	};
+};
+/** 镜头：scene 根 `viewBox` from→to（挂 `<Layout animations>` / IR 根 `animations`） */
+var cameraTo = (opts) => {
+	const { from, to } = opts;
+	if (from == null || to == null) throw new Error("cameraTo: `from` and `to` viewBox [x, y, w, h] are required.");
+	return {
+		property: require_animation.AnimationProperty.ViewBox,
+		keyframes: [{
+			at: 0,
+			value: from
+		}, {
+			at: 1,
+			value: to
+		}],
+		...applyBase({
+			duration: 800,
+			easing: "ease-in-out"
+		}, opts)
+	};
+};
+/** 脉冲：`scale` 1→peak→1 无限循环（强调 / 心跳） */
+var pulse = (opts = {}) => ({
+	property: require_animation.AnimationProperty.Scale,
+	keyframes: [
+		{
+			at: 0,
+			value: 1
+		},
+		{
+			at: .5,
+			value: opts.peak ?? 1.1
+		},
+		{
+			at: 1,
+			value: 1
+		}
+	],
+	iterations: "infinite",
+	...opts.origin !== void 0 ? { origin: opts.origin } : {},
+	...applyBase({
+		duration: 1e3,
+		easing: "ease-in-out"
+	}, opts)
+});
+/** 旋转：`rotate` 0→360 无限循环、匀速（loader） */
+var spin = (opts = {}) => ({
+	property: require_animation.AnimationProperty.Rotate,
+	keyframes: [{
+		at: 0,
+		value: 0
+	}, {
+		at: 1,
+		value: 360
+	}],
+	iterations: "infinite",
+	...opts.origin !== void 0 ? { origin: opts.origin } : {},
+	...applyBase({
+		duration: 1e3,
+		easing: "linear"
+	}, opts)
+});
+/** 循环包装：给任意 track 叠加无限（或指定次数）循环 + 方向 */
+var loop = (track, opts = {}) => ({
+	...track,
+	iterations: opts.iterations ?? "infinite",
+	...opts.direction !== void 0 ? { direction: opts.direction } : {}
+});
+/** 闪一下强调：`opacity` 1→dim→1，默认闪 2 次（末帧 = base = 完整可见） */
+var flash = (opts = {}) => ({
+	property: require_animation.AnimationProperty.Opacity,
+	keyframes: [
+		{
+			at: 0,
+			value: 1
+		},
+		{
+			at: .5,
+			value: opts.dim ?? 0
+		},
+		{
+			at: 1,
+			value: 1
+		}
+	],
+	iterations: opts.iterations ?? 2,
+	...applyBase({
+		duration: 300,
+		easing: "ease-in-out"
+	}, opts)
+});
+/** 持续闪烁：`opacity` 1→dim→1 无限循环（blink = 无限版 flash） */
+var blink = (opts = {}) => ({
+	property: require_animation.AnimationProperty.Opacity,
+	keyframes: [
+		{
+			at: 0,
+			value: 1
+		},
+		{
+			at: .5,
+			value: opts.dim ?? 0
+		},
+		{
+			at: 1,
+			value: 1
+		}
+	],
+	iterations: opts.iterations ?? "infinite",
+	...applyBase({
+		duration: 800,
+		easing: "ease-in-out"
+	}, opts)
+});
+/** 抖动强调：`rotate` 0→+a→−a→+a→0 来回摆（末帧 = base 不旋转） */
+var wiggle = (opts = {}) => {
+	const angle = opts.angle ?? 5;
+	return {
+		property: require_animation.AnimationProperty.Rotate,
+		keyframes: [
+			{
+				at: 0,
+				value: 0
+			},
+			{
+				at: .25,
+				value: angle
+			},
+			{
+				at: .5,
+				value: -angle
+			},
+			{
+				at: .75,
+				value: angle
+			},
+			{
+				at: 1,
+				value: 0
+			}
+		],
+		iterations: opts.iterations ?? 3,
+		...opts.origin !== void 0 ? { origin: opts.origin } : {},
+		...applyBase({
+			duration: 400,
+			easing: "ease-in-out"
+		}, opts)
+	};
+};
+/**
+* 错峰：给一组 track 依次叠加 delay（`startMs + i*stepMs`），实现「N 元素依次入场」
+* @description 覆盖各 track 原有 delay（错峰编排以本 helper 为准）。
+*/
+var stagger = (tracks, stepMs, startMs = 0) => tracks.map((track, index) => ({
+	...track,
+	delay: startMs + index * stepMs
+}));
+//#endregion
+exports.blink = blink;
+exports.cameraTo = cameraTo;
+exports.colorShift = colorShift;
+exports.drawOn = drawOn;
+exports.fadeIn = fadeIn;
+exports.flash = flash;
+exports.grow = grow;
+exports.growUp = growUp;
+exports.loop = loop;
+exports.pulse = pulse;
+exports.scaleIn = scaleIn;
+exports.slideIn = slideIn;
+exports.spin = spin;
+exports.stagger = stagger;
+exports.wiggle = wiggle;

package/dist/lib/presets/animation.d.ts

@@ -0,0 +1,123 @@
+import { IRAnimationOrigin, IRAnimationTrack } from '../ir/animation';
+/** preset 公共可调项（各 preset 在此之上加专有项；默认值由各 preset 给） */
+export type AnimationPresetOptions = {
+    /** 单次迭代时长（毫秒）；缺省由各 preset 给 */
+    duration?: number;
+    /** 首次迭代前延迟（毫秒） */
+    delay?: number;
+    /** 缓动：具名预设 / cubic-bezier 四元组 / 注册名；缺省由各 preset 给 */
+    easing?: IRAnimationTrack['easing'];
+    /** 播放触发器；缺省 load */
+    trigger?: IRAnimationTrack['trigger'];
+};
+/** 淡入：`opacity` 0→1（末帧 = base，降级见完整图） */
+export declare const fadeIn: (opts?: AnimationPresetOptions) => IRAnimationTrack;
+/** 描边画出：`pathDraw` 0→1（仅对有描边元素有效） */
+export declare const drawOn: (opts?: AnimationPresetOptions) => IRAnimationTrack;
+/** `scaleIn` 选项：起始均匀缩放 `from` + 支点 `origin` */
+export type ScaleInOptions = AnimationPresetOptions & {
+    /** 起始缩放（末帧恒为 1 = base）；缺省 0.8 */
+    from?: number;
+    /** 缩放支点（缺省几何中心） */
+    origin?: IRAnimationOrigin;
+};
+/** 缩放入场：`scale` from→1（均匀，绕 origin） */
+export declare const scaleIn: (opts?: ScaleInOptions) => IRAnimationTrack;
+/** 从无到有放大：`scaleIn` 的 `from: 0` 别名 */
+export declare const grow: (opts?: Omit<ScaleInOptions, "from">) => IRAnimationTrack;
+/** `growUp` 选项：支点 `origin`（缺省底边中点，柱状图从基线长出） */
+export type GrowUpOptions = AnimationPresetOptions & {
+    /** 缩放支点；缺省 'south'（底边中点） */
+    origin?: IRAnimationOrigin;
+};
+/** 从基线长出：`scaleY` 0→1，支点底边（柱状图入场） */
+export declare const growUp: (opts?: GrowUpOptions) => IRAnimationTrack;
+/** `slideIn` 选项：轴向 + 起始位移 */
+export type SlideInOptions = AnimationPresetOptions & {
+    /** 滑入轴向；缺省 'x' */
+    axis?: 'x' | 'y';
+    /** 起始位移（末帧恒为 0 = base）；缺省 −20 */
+    offset?: number;
+};
+/** 滑入：`translateX|Y` offset→0 */
+export declare const slideIn: (opts?: SlideInOptions) => IRAnimationTrack;
+/** `colorShift` 选项：通道 + 起止色（均必填，纯工厂无法取 base 色） */
+export type ColorShiftOptions = AnimationPresetOptions & {
+    /** 起始颜色（必填） */
+    from: string;
+    /** 终止颜色（必填） */
+    to: string;
+    /** 变色通道；缺省 'fill' */
+    channel?: 'fill' | 'stroke';
+};
+/** 变色：`fill|stroke` from→to（oklch 插值，由 renderer 端处理） */
+export declare const colorShift: (opts: ColorShiftOptions) => IRAnimationTrack;
+/** `cameraTo` 选项：起止取景 `[x,y,w,h]`（均必填，纯工厂无法取当前 layout） */
+export type CameraToOptions = AnimationPresetOptions & {
+    /** 起始取景 `[x, y, w, h]`（必填） */
+    from: [number, number, number, number];
+    /** 终止取景 `[x, y, w, h]`（必填） */
+    to: [number, number, number, number];
+};
+/** 镜头：scene 根 `viewBox` from→to（挂 `<Layout animations>` / IR 根 `animations`） */
+export declare const cameraTo: (opts: CameraToOptions) => IRAnimationTrack;
+/** `pulse` 选项：峰值缩放 + 支点 */
+export type PulseOptions = AnimationPresetOptions & {
+    /** 峰值缩放；缺省 1.1 */
+    peak?: number;
+    /** 缩放支点（缺省几何中心） */
+    origin?: IRAnimationOrigin;
+};
+/** 脉冲：`scale` 1→peak→1 无限循环（强调 / 心跳） */
+export declare const pulse: (opts?: PulseOptions) => IRAnimationTrack;
+/** `spin` 选项：旋转支点 */
+export type SpinOptions = AnimationPresetOptions & {
+    /** 旋转支点（缺省几何中心） */
+    origin?: IRAnimationOrigin;
+};
+/** 旋转：`rotate` 0→360 无限循环、匀速（loader） */
+export declare const spin: (opts?: SpinOptions) => IRAnimationTrack;
+/** `loop` 选项：循环次数 + 方向 */
+export type LoopOptions = {
+    /** 循环次数；缺省 'infinite' */
+    iterations?: IRAnimationTrack['iterations'];
+    /** 每次迭代方向（如 'alternate'） */
+    direction?: IRAnimationTrack['direction'];
+};
+/** 循环包装：给任意 track 叠加无限（或指定次数）循环 + 方向 */
+export declare const loop: (track: IRAnimationTrack, opts?: LoopOptions) => IRAnimationTrack;
+/** `flash` 选项：谷值不透明度 + 闪烁次数 */
+export type FlashOptions = AnimationPresetOptions & {
+    /** 闪烁谷值不透明度；缺省 0 */
+    dim?: number;
+    /** 闪烁次数；缺省 2 */
+    iterations?: IRAnimationTrack['iterations'];
+};
+/** 闪一下强调：`opacity` 1→dim→1，默认闪 2 次（末帧 = base = 完整可见） */
+export declare const flash: (opts?: FlashOptions) => IRAnimationTrack;
+/** `blink` 选项：谷值不透明度 + 闪烁次数（缺省无限） */
+export type BlinkOptions = AnimationPresetOptions & {
+    /** 闪烁谷值不透明度；缺省 0 */
+    dim?: number;
+    /** 闪烁次数；缺省 'infinite' */
+    iterations?: IRAnimationTrack['iterations'];
+};
+/** 持续闪烁：`opacity` 1→dim→1 无限循环（blink = 无限版 flash） */
+export declare const blink: (opts?: BlinkOptions) => IRAnimationTrack;
+/** `wiggle` 选项：抖动幅度（度）+ 支点 + 抖动次数 */
+export type WiggleOptions = AnimationPresetOptions & {
+    /** 抖动幅度（度）；缺省 5 */
+    angle?: number;
+    /** 旋转支点（缺省几何中心） */
+    origin?: IRAnimationOrigin;
+    /** 抖动次数；缺省 3 */
+    iterations?: IRAnimationTrack['iterations'];
+};
+/** 抖动强调：`rotate` 0→+a→−a→+a→0 来回摆（末帧 = base 不旋转） */
+export declare const wiggle: (opts?: WiggleOptions) => IRAnimationTrack;
+/**
+ * 错峰：给一组 track 依次叠加 delay（`startMs + i*stepMs`），实现「N 元素依次入场」
+ * @description 覆盖各 track 原有 delay（错峰编排以本 helper 为准）。
+ */
+export declare const stagger: (tracks: ReadonlyArray<IRAnimationTrack>, stepMs: number, startMs?: number) => Array<IRAnimationTrack>;
+//# sourceMappingURL=animation.d.ts.map

package/dist/lib/presets/animation.d.ts.map

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

package/dist/lib/presets/index.d.ts

@@ -0,0 +1,3 @@
+/** 动画 preset 工厂 barrel */
+export * from './animation';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/presets/index.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,cAAc,aAAa,CAAC"}

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

@@ -1,3 +1,4 @@
+import { IRAnimationTrack } from '../ir/animation';
 import { IRJsonObject } from '../ir/json';
 import { PaintValue } from './paint';
 export type EllipsePrim = {
@@ -6,6 +7,8 @@ export type EllipsePrim = {
     id?: string;
     /** provenance 元数据：compile 从 IR 元素（node / path / scope）的 `meta` 原样 stamp，renderer 忽略（不进 DOM），交互层 / 工具链从 Scene 读 */
     meta?: IRJsonObject;
+    /** 时间轴动画 tracks：compile 从 IR 元素的 animations 原样 stamp；renderer 能播则播、不能则渲染 settled 静态态并 warn（不丢图） */
+    animations?: Array<IRAnimationTrack>;
     cx: number;
     cy: number;
     rx: number;

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

@@ -1 +1 @@
-{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/primitive/ellipse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/primitive/ellipse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC"}

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

@@ -1,3 +1,4 @@
+import { IRAnimationTrack } from '../ir/animation';
 import { IRJsonObject } from '../ir/json';
 import { ScenePrimitive } from './scene';
 /** Translate transform：沿 x / y 平移（user units） */
@@ -42,6 +43,8 @@ export type GroupPrim = {
     id?: string;
     /** provenance 元数据：compile 从 IR 元素（node / path / scope）的 `meta` 原样 stamp，renderer 忽略（不进 DOM），交互层 / 工具链从 Scene 读 */
     meta?: IRJsonObject;
+    /** 时间轴动画 tracks：compile 从 IR 元素的 animations 原样 stamp；renderer 能播则播、不能则渲染 settled 静态态并 warn（不丢图） */
+    animations?: Array<IRAnimationTrack>;
     /** 结构化变换序列，按数组顺序应用；undefined / 空数组表示无变换 */
     transforms?: Array<Transform>;
     /**

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,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,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,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,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,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY;IACZ,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CACjC,CAAC"}

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

@@ -154,7 +154,7 @@ export type MarkerGroupPrim = {
  * @description renderer-agnostic：core 只产此结构（局部 baseSize 坐标系），react adapter 把它嵌进
  *   `<marker>`。相对 `ScenePrimitive` 的收窄——禁 `TextPrim`、禁 `arrowStart`/`arrowEnd`、禁外部
  *   `resourceRef`、禁 `clip`；`fill` 限 `MarkerFill`。这条收窄兜住"marker 内递归引用 marker / clip /
- *   文本布局"的复杂度（见 ADR-01 选项 C 的反例）。
+ *   文本布局"的复杂度。
  */
 export type MarkerPrimitive = MarkerPathPrim | MarkerEllipsePrim | MarkerRectPrim | MarkerGroupPrim;
 //# sourceMappingURL=marker.d.ts.map

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

@@ -5,7 +5,7 @@ import { MarkerPrimitive } from './marker';
  * paint 属性取值词汇表（可用于 fill / stroke，不绑定单一属性）
  * @description 渲染无关：`string` 纯色（含 var() 由 adapter 走 inline style）；`{ kind:'resourceRef' }` 指向
  *   `Scene.resources` 里的 paint server（gradient / 后续 pattern·image）；`{ kind:'contextStroke' }` 继承所在元素描边
- *   （adapter → SVG context-stroke，alpha.8 arrow 用）。
+ *   （adapter → SVG context-stroke）。
  */
 export type PaintValue = string | {
     kind: 'resourceRef';

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

@@ -1,4 +1,5 @@
 import { ArrowShapeName } from '../ir/path/arrow';
+import { IRAnimationTrack } from '../ir/animation';
 import { IRJsonObject } from '../ir/json';
 import { MarkerPrimitive } from './marker';
 import { PaintValue } from './paint';
@@ -90,7 +91,7 @@ export type PathCommand = MovePathCommand | LinePathCommand | QuadPathCommand |
  *   markerHeight>`，不再 switch、不调 emit、不需要 arrows 注册表。纯 JSON 数据（无函数）。
  */
 export type ArrowEndSpec = {
-    /** 形状名：内置 7 或经 `CompileOptions.arrows` 注册的扩展名；标识 / 调试用，已解析后渲染不依赖（保留） */
+    /** 形状名：内置 8 或经 `CompileOptions.arrows` 注册的扩展名；标识 / 调试用，已解析后渲染不依赖（保留） */
     shape: ArrowShapeName;
     /** marker viewBox 边长（`def.baseSize ?? 10`）；adapter 据此推 viewBox `0 0 baseSize baseSize` 与 refY = baseSize/2 */
     baseSize: number;
@@ -113,6 +114,8 @@ export type PathPrim = {
     id?: string;
     /** provenance 元数据：compile 从 IR 元素（node / path / scope）的 `meta` 原样 stamp，renderer 忽略（不进 DOM），交互层 / 工具链从 Scene 读 */
     meta?: IRJsonObject;
+    /** 时间轴动画 tracks：compile 从 IR 元素的 animations 原样 stamp；renderer 能播则播、不能则渲染 settled 静态态并 warn（不丢图） */
+    animations?: Array<IRAnimationTrack>;
     /** 结构化路径命令序列，按数组顺序绘制 */
     commands: Array<PathCommand>;
     /** 填充：纯色 / 资源表 paint server（gradient）/ contextStroke；不填表示不填充 */

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

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

@@ -1,3 +1,4 @@
+import { IRAnimationTrack } from '../ir/animation';
 import { IRJsonObject } from '../ir/json';
 import { PaintValue } from './paint';
 /** 矩形原语 */
@@ -8,6 +9,8 @@ export type RectPrim = {
     id?: string;
     /** provenance 元数据：compile 从 IR 元素（node / path / scope）的 `meta` 原样 stamp，renderer 忽略（不进 DOM），交互层 / 工具链从 Scene 读 */
     meta?: IRJsonObject;
+    /** 时间轴动画 tracks：compile 从 IR 元素的 animations 原样 stamp；renderer 能播则播、不能则渲染 settled 静态态并 warn（不丢图） */
+    animations?: Array<IRAnimationTrack>;
     /** 左上角横坐标 */
     x: 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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,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,iEAAiE;IACjE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,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,gCAAgC;IAChC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,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,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,WAAW;AACX,MAAM,MAAM,QAAQ,GAAG;IACrB,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,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,iEAAiE;IACjE,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,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,gCAAgC;IAChC,WAAW,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,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,6 +5,7 @@ import { RectPrim } from './rect';
 import { TextPrim } from './text';
 import { Layout } from './layout';
 import { SceneResource } from './paint';
+import { IRAnimationTrack } from '../ir/animation';
 export type { PaintValue, SceneResource, PaintResource, ResolvedPatternTile } from './paint';
 export type { ClipShape, ClipResource } from './clip';
 /**
@@ -20,5 +21,7 @@ export type Scene = {
     layout: Layout;
     /** 渲染无关资源表（paint server 等）；adapter 物化（SVG → `<defs>`）。无资源时省略 */
     resources?: Array<SceneResource>;
+    /** scene 根（镜头）时间轴动画 tracks（viewBox property）：compile 从 IR 根 animations 原样透传；renderer 能播则播、不能则用静态 layout 并 warn。无则省略 */
+    animations?: Array<IRAnimationTrack>;
 };
 //# sourceMappingURL=scene.d.ts.map

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,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7F,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,qCAAqC;AACrC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;CAClC,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,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7F,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF,qCAAqC;AACrC,MAAM,MAAM,KAAK,GAAG;IAClB,wBAAwB;IACxB,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAClC,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,uHAAuH;IACvH,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CACtC,CAAC"}

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

@@ -1,3 +1,4 @@
+import { IRAnimationTrack } from '../ir/animation';
 import { IRJsonObject } from '../ir/json';
 /** 行级字段（每行可独立指定），未填走块级 TextPrim 默认 */
 export type TextLine = {
@@ -26,6 +27,8 @@ export type TextPrim = {
     id?: string;
     /** provenance 元数据：compile 从 IR 元素（node / path / scope）的 `meta` 原样 stamp，renderer 忽略（不进 DOM），交互层 / 工具链从 Scene 读 */
     meta?: IRJsonObject;
+    /** 时间轴动画 tracks：compile 从 IR 元素的 animations 原样 stamp；renderer 能播则播、不能则渲染 settled 静态态并 warn（不丢图） */
+    animations?: Array<IRAnimationTrack>;
     /** 锚点横坐标（具体含义由 align 决定） */
     x: number;
     /** 锚点纵坐标（具体含义由 baseline 决定） */

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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,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,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,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"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/primitive/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,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,6FAA6F;IAC7F,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mGAAmG;IACnG,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACrC,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/shapes/arc.cjs

@@ -1,13 +1,13 @@
-const require__transform = require("../geometry/_transform.cjs");
+const require_transform = require("../geometry/transform.cjs");
 const require_arc = require("../geometry/arc.cjs");
 const require_define = require("./define.cjs");
-const require__shared = require("./_shared.cjs");
+const require_shared = require("./shared.cjs");
 let zod = require("zod");
 //#region src/shapes/arc.ts
 /** arc 的派生几何：圆心局部系 AABB + 圆心相对 AABB 中心偏移 */
 var arcGeometry = (params) => {
 	const { radius } = params;
-	const range = require__shared.normalizeAngularRange(params.startAngle, params.endAngle);
+	const range = require_shared.normalizeAngularRange(params.startAngle, params.endAngle);
 	const points = require_arc.arcBoundingPoints([0, 0], radius, range.start, range.end);
 	let minX = Infinity;
 	let maxX = -Infinity;
@@ -30,7 +30,7 @@ var arcGeometry = (params) => {
 	};
 };
 /** 圆心局部点（相对圆心）→ 世界系（+centerOffset 到相对 AABB 中心后经 rect 投影） */
-var arcLocalToWorld = (rect, centerOffset, localFromCenter) => require__transform.localToWorld(rect, [localFromCenter[0] + centerOffset[0], localFromCenter[1] + centerOffset[1]]);
+var arcLocalToWorld = (rect, centerOffset, localFromCenter) => require_transform.localToWorld(rect, [localFromCenter[0] + centerOffset[0], localFromCenter[1] + centerOffset[1]]);
 /**
 * arc 注册项：单半径曲线（描边、可选闭合为弓形）
 * @description circumscribe 返回弧 bbox 半轴（含弧跨过的 90°·k 轴向极值点），node position = AABB 中心；

package/dist/lib/shapes/{_contour.cjs → contour.cjs}

@@ -1,4 +1,4 @@
-//#region src/shapes/_contour.ts
+//#region src/shapes/contour.ts
 /**
 * 由顶点环构造闭合折线段序列（接缝顺序同顶点顺序）
 * @description 第 i 段 from = 顶点 i、to = 顶点 (i+1)%n；供 polygon / star 的 emit / boundaryPoint
@@ -56,6 +56,19 @@ var contourToPathCommands = (commands, round) => {
 	});
 	return out;
 };
+/** contour shape 共用的 path primitive 样式落地。 */
+var contourToPathPrimitive = (commands, style) => ({
+	type: "path",
+	commands,
+	fill: style.fill ?? "transparent",
+	fillOpacity: style.fillOpacity,
+	stroke: style.stroke ?? "currentColor",
+	strokeOpacity: style.strokeOpacity,
+	strokeWidth: style.strokeWidth ?? 1,
+	dashPattern: style.dashPattern,
+	opacity: style.opacity
+});
 //#endregion
 exports.contourToPathCommands = contourToPathCommands;
+exports.contourToPathPrimitive = contourToPathPrimitive;
 exports.verticesToSegments = verticesToSegments;