@retikz/vanilla 0.3.0-beta.1 → 0.3.0-beta.2

package/dist/es/builder/{isFigure.d.ts → is-figure.d.ts}

@@ -3,4 +3,4 @@ import { Figure } from '../figure';
 export declare const FIGURE_BRAND: unique symbol;
 /** 运行时判断一个值是不是 Figure（带 brand）；纯结构检查、零内部 import → 不与 mountSvg/Figure 形成运行时环 */
 export declare const isFigure: (value: unknown) => value is Figure;
-//# sourceMappingURL=isFigure.d.ts.map
+//# sourceMappingURL=is-figure.d.ts.map

package/dist/es/builder/is-figure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-figure.d.ts","sourceRoot":"","sources":["../../../src/builder/is-figure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,oGAAoG;AACpG,eAAO,MAAM,YAAY,EAAE,OAAO,MAA4C,CAAC;AAE/E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACuD,CAAC"}

package/dist/es/builder/{isFigure.js → is-figure.js}

@@ -1,4 +1,4 @@
-//#region src/builder/isFigure.ts
+//#region src/builder/is-figure.ts
 /** Figure 品牌标记（Symbol.for 跨包/重复 import 仍同一）；标准 mountSvg/renderToSvgString 用它区分 Figure 与 IR/Scene */
 var FIGURE_BRAND = Symbol.for("retikz.vanilla.figure");
 /** 运行时判断一个值是不是 Figure（带 brand）；纯结构检查、零内部 import → 不与 mountSvg/Figure 形成运行时环 */

package/dist/es/builder/types.d.ts

@@ -1,4 +1,4 @@
-import { CompileOptions, IRChild, IRCoordinate, IRNode, IRPath, IRScope, IRViewBox, WayDSL } from '@retikz/core';
+import { CompileOptions, IRAnimationTrack, IRChild, IRCoordinate, IRNode, IRPath, IRScope, IRViewBox, WayDSL } from '@retikz/core';
 /** builder 函数返回的 IR 子节点（node / draw / coordinate / scope 的产物） */
 export type Child = IRChild;
 /** node 的 config：从 IRNode 派生，剔除判别符 type 与提为 positional 的 id */
@@ -11,16 +11,29 @@ export type CoordinateConfig = Omit<IRCoordinate, 'type' | 'id'>;
 export type ScopeConfig = Omit<IRScope, 'type' | 'children'>;
 /** draw 的 way：直接复用 core 的 way DSL 全集（id 串 / 坐标 / Cycle / 折角 / 相对 / 曲线 / 弧 …） */
 export type Way = WayDSL;
+/**
+ * figure 根级级联样式默认（与 React `<Layout>` 顶层样式 props 对齐）
+ * @description 取 `IRScope` 的级联样式通道（graphic state + 四通道 every-X），**不含**容器 / 命名空间 / 变换 /
+ *   屏障 / 栈序 / 裁剪字段（那些挂在 figure 根上语义易混）。组 IR 时若任一字段携带样式指令，把根 children 包进
+ *   一层合成根 `<Scope>`，等价于用户手写一层根 scope；全缺省时不包，IR 形态逐字保持。
+ */
+export type FigureRootStyle = Pick<IRScope, 'color' | 'stroke' | 'fill' | 'strokeWidth' | 'opacity' | 'fillOpacity' | 'drawOpacity' | 'nodeDefault' | 'pathDefault' | 'labelDefault' | 'arrowDefault'>;
+/** {@link FigureRootStyle} 的字段表——`figure.ts` 组 IR 时拣根样式 + 从 render options 剔除（IR-only 字段不下发） */
+export declare const FIGURE_ROOT_STYLE_FIELDS: readonly ["color", "stroke", "fill", "strokeWidth", "opacity", "fillOpacity", "drawOpacity", "nodeDefault", "pathDefault", "labelDefault", "arrowDefault"];
 /**
  * figure 的 config
- * @description `viewBox` → IR.viewBox（内容坐标系）；`width`/`height` → 根 `<svg>` 显示尺寸（adapter 职责）；
- *   `idPrefix` → SVG 资源 id 前缀；其余（measureText / shapes / arrows / patterns / pathGenerators /
- *   padding / precision / nodeDistance / onWarn）派生自 core `CompileOptions`、原样喂 compileToScene。
+ * @description `viewBox` → IR.viewBox（内容坐标系）；`animations` → IR 根 `animations`（镜头时间轴，配 cameraTo
+ *   preset）；`width`/`height` → 根 `<svg>` 显示尺寸（adapter 职责）；`idPrefix` → SVG 资源 id 前缀；根级级联样式
+ *   （color / nodeDefault / pathDefault / labelDefault / arrowDefault 等）按需包合成根 `<Scope>`；其余（measureText /
+ *   shapes / arrows / patterns / pathGenerators / padding / precision / nodeDistance / onWarn）派生自 core
+ *   `CompileOptions`、原样喂 compileToScene。
  */
 export type FigureConfig = {
     width?: number;
     height?: number;
     viewBox?: IRViewBox;
     idPrefix?: string;
-} & CompileOptions;
+    /** scene 根（镜头）时间轴动画 tracks（`viewBox` property，配 `cameraTo()` preset）；注入 IR 根 `animations` */
+    animations?: Array<IRAnimationTrack>;
+} & FigureRootStyle & CompileOptions;
 //# sourceMappingURL=types.d.ts.map

package/dist/es/builder/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EACP,YAAY,EACZ,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACP,MAAM,cAAc,CAAC;AAEtB,iEAAiE;AACjE,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC;AAE5B,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE3D,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACP,MAAM,cAAc,CAAC;AAEtB,iEAAiE;AACjE,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC;AAE5B,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE3D,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,OAAO,EACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,aAAa,GACb,SAAS,GACT,aAAa,GACb,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,CACjB,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,4JAYoB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CACtC,GAAG,eAAe,GACjB,cAAc,CAAC"}

package/dist/es/builder/types.js

@@ -0,0 +1,17 @@
+//#region src/builder/types.ts
+/** {@link FigureRootStyle} 的字段表——`figure.ts` 组 IR 时拣根样式 + 从 render options 剔除（IR-only 字段不下发） */
+var FIGURE_ROOT_STYLE_FIELDS = [
+	"color",
+	"stroke",
+	"fill",
+	"strokeWidth",
+	"opacity",
+	"fillOpacity",
+	"drawOpacity",
+	"nodeDefault",
+	"pathDefault",
+	"labelDefault",
+	"arrowDefault"
+];
+//#endregion
+export { FIGURE_ROOT_STYLE_FIELDS };

package/dist/es/figure.d.ts

@@ -1,6 +1,6 @@
 import { IR } from '@retikz/core';
 import { RenderOptions } from '@retikz/render/canvas';
-import { FIGURE_BRAND } from './builder/isFigure';
+import { FIGURE_BRAND } from './builder/is-figure';
 import { node } from './builder/node';
 import { ScopeBuilder } from './builder/scope';
 import { Child, CoordinateConfig, DrawConfig, FigureConfig, ScopeConfig, Way } from './builder/types';

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

@@ -1 +1 @@
-{"version":3,"file":"figure.d.ts","sourceRoot":"","sources":["../../src/figure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAK3G,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhH;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,WAAW,CAAC;IACnE,WAAW,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,UAAU,CAAC;IAC9E,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACvE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC7D,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC,KAAK,MAAM,CAAC;CACzF,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,EAAE,UAAU,KAAK,CAAC,KAAK,CAAC,KAAG,MAwD3E,CAAC"}
+{"version":3,"file":"figure.d.ts","sourceRoot":"","sources":["../../src/figure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAG3D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAmB,WAAW,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAK5H,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhH;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,WAAW,CAAC;IACnE,WAAW,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB,KAAK,UAAU,CAAC;IAC9E,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,qBAAqB,KAAK,MAAM,CAAC;IACzD,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;IACvE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC;IACnD,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,MAAM,CAAC;IAC7D,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC,KAAK,MAAM,CAAC;CACzF,CAAC;AAoBF,2DAA2D;AAC3D,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,EAAE,UAAU,KAAK,CAAC,KAAK,CAAC,KAAG,MAoE3E,CAAC"}

package/dist/es/figure.js

@@ -1,33 +1,61 @@
-import { FIGURE_BRAND } from "./builder/isFigure.js";
-import { toScene } from "./toScene.js";
-import { renderToSvgString } from "./renderToSvgString.js";
-import { mountSvg } from "./mountSvg.js";
-import { mountCanvas } from "./mountCanvas.js";
+import { FIGURE_BRAND } from "./builder/is-figure.js";
+import { toScene } from "./to-scene.js";
+import { renderToSvgString } from "./render-to-svg-string.js";
+import { mountSvg } from "./mount-svg.js";
+import { mountCanvas } from "./mount-canvas.js";
 import { coordinate } from "./builder/coordinate.js";
 import { draw } from "./builder/draw.js";
 import { node } from "./builder/node.js";
 import { scope } from "./builder/scope.js";
+import { FIGURE_ROOT_STYLE_FIELDS } from "./builder/types.js";
 import { renderToCanvas } from "@retikz/render/canvas";
 //#region src/figure.ts
+/**
+* 拣出真正携带样式指令的根样式字段
+* @description 在「取 defined」基础上剔除空对象的四通道 default（`nodeDefault: {}` 等）——空 default 无样式指令，
+*   留着只会让 figure 无谓包一层空合成根 `<Scope>`、改变 IR / Scene 拓扑却无视觉差异。标量通道的 falsy-但-defined
+*   值（`strokeWidth: 0` / `opacity: 0`）是有意义样式、保留（镜像 react `pickScopeStyle`）。
+*/
+var pickRootStyle = (config) => {
+	const picked = {};
+	for (const key of FIGURE_ROOT_STYLE_FIELDS) {
+		const value = config[key];
+		if (value === void 0) continue;
+		if (typeof value === "object" && Object.keys(value).length === 0) continue;
+		Object.assign(picked, { [key]: value });
+	}
+	return picked;
+};
 /** figure() 的内部入口：装配 Figure（持 config + children，方法闭包其上） */
 var createFigure = (config, children) => {
-	/** call-site options 覆盖 figure 存的 config（call-site wins）：viewBox 已并进 ir，其余（width/height/idPrefix + 全套 CompileOptions）全透传 */
+	/**
+	* call-site options 覆盖 figure 存的 config（call-site wins）：viewBox / animations / 根样式已并进 ir，
+	* 这些 IR-only 字段从下发的 render options 剔除；其余（width/height/idPrefix + 全套 CompileOptions）全透传。
+	*/
 	const renderOptions = (callSite) => {
 		const merged = {
 			...config,
 			...callSite
 		};
 		delete merged.viewBox;
+		delete merged.animations;
+		for (const key of FIGURE_ROOT_STYLE_FIELDS) delete merged[key];
 		return merged;
 	};
 	const fig = {
 		[FIGURE_BRAND]: true,
 		get ir() {
+			const rootStyle = pickRootStyle(config);
 			return {
 				version: 1,
 				type: "scene",
-				children,
-				...config.viewBox ? { viewBox: config.viewBox } : {}
+				children: Object.keys(rootStyle).length > 0 ? [{
+					type: "scope",
+					...rootStyle,
+					children
+				}] : children,
+				...config.viewBox ? { viewBox: config.viewBox } : {},
+				...config.animations ? { animations: config.animations } : {}
 			};
 		},
 		mount(container, options) {
@@ -45,6 +73,8 @@ var createFigure = (config, children) => {
 			delete compile.idPrefix;
 			delete compile.width;
 			delete compile.height;
+			delete compile.animations;
+			for (const key of FIGURE_ROOT_STYLE_FIELDS) delete compile[key];
 			renderToCanvas(canvas, toScene(fig.ir, compile), options ?? {});
 		},
 		node(...args) {

package/dist/es/index.d.ts

@@ -6,10 +6,10 @@
  * `figure`/`node`/`draw`/`coordinate`/`scope` 是命令式 builder：用具名图元 + 自定义 shape 构图、产同一份 IR。
  * 模块顶层不触碰任何 DOM 全局——`import` 在纯 Node 下安全。
  */
-export { renderToSvgString } from './renderToSvgString';
-export { mountSvg } from './mountSvg';
+export { renderToSvgString } from './render-to-svg-string';
+export { mountSvg } from './mount-svg';
 export { hydrate } from './hydrate';
-export { mountCanvas } from './mountCanvas';
+export { mountCanvas } from './mount-canvas';
 export type { RetikzEventValue, HydrationHandlers, HydrationHandler, HydrationContext, HydrationAnimationControls, HydrationGeometry, } from '@retikz/render/hydration';
 export { fadeIn, drawOn, scaleIn, grow, growUp, slideIn, colorShift, cameraTo, pulse, spin, loop, flash, blink, wiggle, stagger, } from '@retikz/core';
 export type { AnimationPresetOptions, ScaleInOptions, GrowUpOptions, SlideInOptions, ColorShiftOptions, CameraToOptions, PulseOptions, SpinOptions, LoopOptions, FlashOptions, BlinkOptions, WiggleOptions, } from '@retikz/core';
@@ -26,6 +26,6 @@ export { coordinate } from './builder/coordinate';
 export { scope } from './builder/scope';
 export type { Figure } from './figure';
 export type { ScopeBuilder } from './builder/scope';
-export type { Child, NodeConfig, DrawConfig, CoordinateConfig, ScopeConfig, FigureConfig, Way, } from './builder/types';
+export type { Child, NodeConfig, DrawConfig, CoordinateConfig, ScopeConfig, FigureConfig, FigureRootStyle, Way, } from './builder/types';
 export type { RenderInput, CommonOptions, MountOptions, RenderToStringOptions, VanillaView, CanvasView, MountCanvasOptions, HydrateOptions, HydrationHandle, ScenePoint, AnimationControls, } from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,GAAG,GACJ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,QAAQ,EACR,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC/E,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,WAAW,EACX,QAAQ,EACR,cAAc,GACf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACV,KAAK,EACL,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,eAAe,EACf,GAAG,GACJ,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,UAAU,EACV,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/es/index.js

@@ -1,7 +1,7 @@
-import { renderToSvgString } from "./renderToSvgString.js";
-import { mountSvg } from "./mountSvg.js";
+import { renderToSvgString } from "./render-to-svg-string.js";
+import { mountSvg } from "./mount-svg.js";
 import { hydrate } from "./hydrate.js";
-import { mountCanvas } from "./mountCanvas.js";
+import { mountCanvas } from "./mount-canvas.js";
 import { coordinate } from "./builder/coordinate.js";
 import { draw } from "./builder/draw.js";
 import { node } from "./builder/node.js";

package/dist/{lib/mountCanvas.d.ts → es/mount-canvas.d.ts}

@@ -8,4 +8,4 @@ import { CanvasView, MountCanvasOptions, RenderInput } from './types';
  *   与 `clientToScene`（逆 meet-fit 坐标映射）。DOM 仅在调用时惰性触碰，`import` 本模块不碰 DOM——守 SSR 导入安全。
  */
 export declare const mountCanvas: (container: Element, input: RenderInput, options?: MountCanvasOptions) => CanvasView;
-//# sourceMappingURL=mountCanvas.d.ts.map
+//# sourceMappingURL=mount-canvas.d.ts.map

package/dist/es/mount-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-canvas.d.ts","sourceRoot":"","sources":["../../src/mount-canvas.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAkB,kBAAkB,EAAE,WAAW,EAAc,MAAM,SAAS,CAAC;AASvG;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,OAAO,EAClB,OAAO,WAAW,EAClB,UAAS,kBAAuB,KAC/B,UA4PF,CAAC"}

package/dist/es/{mountCanvas.js → mount-canvas.js}

@@ -1,9 +1,9 @@
-import { isFigure } from "./builder/isFigure.js";
-import { toScene } from "./toScene.js";
+import { isFigure } from "./builder/is-figure.js";
+import { toScene } from "./to-scene.js";
 import { createClock, createIdClockRegistry, prefersReducedMotion, sceneAnimationDurationMs, sceneHasAnimations, sceneHasAutoplayTrigger } from "@retikz/render/animation";
 import { collectCanvasVisibleAnimationIds, createCanvasIdAnimationControls, createContextBuilder, createHydrationController, isCanvasAnimationIdVisible, withCanvasAnimationEventHandlers } from "@retikz/render/hydration";
 import { hitTest, renderToCanvas } from "@retikz/render/canvas";
-//#region src/mountCanvas.ts
+//#region src/mount-canvas.ts
 /** 设备像素比：取有限正数、否则回退 1（镜像 react CanvasHost） */
 var resolveDevicePixelRatio = (override) => {
 	if (typeof override === "number" && Number.isFinite(override) && override > 0) return override;
@@ -29,6 +29,7 @@ var mountCanvas = (container, input, options = {}) => {
 	let visibleActivated = /* @__PURE__ */ new Set();
 	let visibleTeardown;
 	let currentScene;
+	const liveHydrations = /* @__PURE__ */ new Set();
 	/** 把全局帧时刻折算成单个 prim 的动画解析（per-id）：stop→渲染 base；否则按有效时刻 + 是否含非自动播 track */
 	const resolvePrim = (id, globalTime) => id !== void 0 && registry.isStopped(id) ? { mode: "skip" } : {
 		mode: "at",
@@ -71,14 +72,22 @@ var mountCanvas = (container, input, options = {}) => {
 		visibleTeardown = void 0;
 		if (!animate || !sceneHasAnimations(currentScene)) return;
 		if (collectCanvasVisibleAnimationIds(currentScene).size === 0 || typeof window === "undefined") return;
-		const schedule = () => activateVisibleTracks();
+		let scheduledRaf;
+		const runScheduled = () => {
+			scheduledRaf = void 0;
+			activateVisibleTracks();
+		};
+		const schedule = () => {
+			if (scheduledRaf !== void 0) return;
+			scheduledRaf = window.requestAnimationFrame(runScheduled);
+		};
 		window.addEventListener("scroll", schedule, true);
 		window.addEventListener("resize", schedule);
-		const raf = window.requestAnimationFrame(schedule);
+		schedule();
 		visibleTeardown = () => {
 			window.removeEventListener("scroll", schedule, true);
 			window.removeEventListener("resize", schedule);
-			window.cancelAnimationFrame(raf);
+			if (scheduledRaf !== void 0) window.cancelAnimationFrame(scheduledRaf);
 		};
 	};
 	const renderInto = (next) => {
@@ -93,6 +102,15 @@ var mountCanvas = (container, input, options = {}) => {
 		if (options.width !== void 0) canvas.style.width = `${options.width}px`;
 		if (options.height !== void 0) canvas.style.height = `${options.height}px`;
 		canvas.style.objectFit = "contain";
+		if (options.snapshotAt !== void 0) {
+			renderToCanvas(canvas, scene, {
+				devicePixelRatio: ratio,
+				time: options.snapshotAt,
+				easings: options.easings,
+				animationProperties: options.animationProperties
+			});
+			return;
+		}
 		renderToCanvas(canvas, scene, { devicePixelRatio: ratio });
 		clock?.dispose();
 		clock = void 0;
@@ -166,19 +184,40 @@ var mountCanvas = (container, input, options = {}) => {
 				defaultId: id
 			})
 		});
-		return { dispose: createHydrationController(canvas, withCanvasAnimationEventHandlers(currentScene, hydrateOptions.handlers), locate, buildContext).dispose };
+		const userHandlers = hydrateOptions.handlers;
+		const bind = () => createHydrationController(canvas, withCanvasAnimationEventHandlers(currentScene, userHandlers), locate, buildContext);
+		let controller = bind();
+		const live = {
+			rebind: () => {
+				controller.dispose();
+				controller = bind();
+			},
+			unbind: () => controller.dispose()
+		};
+		liveHydrations.add(live);
+		return { dispose: () => {
+			live.unbind();
+			liveHydrations.delete(live);
+		} };
+	};
+	/** update 换 scene 后按新 scene 重建存活水合的 onEvent 动画 handler 表（新增 / 移除的 onEvent track 即时反映） */
+	const rebindHydrations = () => {
+		for (const live of liveHydrations) live.rebind();
 	};
 	return {
 		root: canvas,
 		update(next) {
 			if (disposed) throw new Error("mountCanvas: view already disposed.");
 			renderInto(next);
+			rebindHydrations();
 		},
 		dispose() {
 			if (disposed) return;
 			disposed = true;
 			visibleTeardown?.();
 			clock?.dispose();
+			for (const live of liveHydrations) live.unbind();
+			liveHydrations.clear();
 			canvas.remove();
 		},
 		hydrate,

package/dist/es/{mountSvg.d.ts → mount-svg.d.ts}

@@ -7,4 +7,4 @@ import { MountOptions, RenderInput, VanillaView } from './types';
  *   原地重渲染、root 元素 identity 跨 update 不变、不失效。DOM 仅在调用时惰性触碰，`import` 本模块不碰 DOM——守 SSR 导入安全。
  */
 export declare const mountSvg: (container: Element, input: RenderInput, options?: MountOptions) => VanillaView;
-//# sourceMappingURL=mountSvg.d.ts.map
+//# sourceMappingURL=mount-svg.d.ts.map

package/dist/es/mount-svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount-svg.d.ts","sourceRoot":"","sources":["../../src/mount-svg.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAmC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAIvG;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,OAAO,EAAE,OAAO,WAAW,EAAE,UAAS,YAAiB,KAAG,WAkF7F,CAAC"}

package/dist/es/{mountSvg.js → mount-svg.js}

@@ -1,10 +1,10 @@
-import { isFigure } from "./builder/isFigure.js";
-import { toScene } from "./toScene.js";
-import { applyAttrs, svgNodeToDom } from "./svgNodeToDom.js";
+import { isFigure } from "./builder/is-figure.js";
+import { toScene } from "./to-scene.js";
+import { applyAttrs, svgNodeToDom } from "./svg-node-to-dom.js";
 import { buildSvgDocument } from "@retikz/render/svg";
 import { bindWaapiDescriptors, prefersReducedMotion, sceneHasAnimations } from "@retikz/render/animation";
 import { createContextBuilder, createHydrationController, createSvgAnimationControls, locateSvg, resolvePointViaLayout, resolveSvgElement } from "@retikz/render/hydration";
-//#region src/mountSvg.ts
+//#region src/mount-svg.ts
 var SVG_NS = "http://www.w3.org/2000/svg";
 /**
 * 把 IR / Scene / Figure 挂成真实 SVG DOM（无框架浏览器 runtime）
@@ -21,6 +21,7 @@ var mountSvg = (container, input, options = {}) => {
 	const animate = options.animate !== false && !prefersReducedMotion();
 	let animationControls;
 	let currentScene;
+	const liveHydrationDisposers = /* @__PURE__ */ new Set();
 	const renderInto = (next) => {
 		if (isFigure(next)) throw new Error("mountSvg: view.update does not accept a Figure; pass figure.ir instead.");
 		const scene = toScene(next, options);
@@ -57,7 +58,13 @@ var mountSvg = (container, input, options = {}) => {
 			resolvePoint: (event) => resolvePointViaLayout(root, currentScene.layout)(event),
 			makeAnimation: (id) => createSvgAnimationControls(root, id)
 		});
-		return { dispose: createHydrationController(root, hydrateOptions.handlers, locateSvg, buildContext).dispose };
+		const controller = createHydrationController(root, hydrateOptions.handlers, locateSvg, buildContext);
+		const dispose = () => {
+			controller.dispose();
+			liveHydrationDisposers.delete(dispose);
+		};
+		liveHydrationDisposers.add(dispose);
+		return { dispose };
 	};
 	let disposed = false;
 	return {
@@ -70,6 +77,7 @@ var mountSvg = (container, input, options = {}) => {
 		dispose() {
 			if (disposed) return;
 			disposed = true;
+			for (const disposeHydration of [...liveHydrationDisposers]) disposeHydration();
 			animationControls?.dispose();
 			root.remove();
 		},

package/dist/{lib/renderToSvgString.d.ts → es/render-to-svg-string.d.ts}

@@ -6,4 +6,4 @@ import { RenderInput, RenderToStringOptions } from './types';
  *   `<svg>` attrs（不在本层对字符串做正则后处理）。零 DOM。
  */
 export declare const renderToSvgString: (input: RenderInput, options?: RenderToStringOptions) => string;
-//# sourceMappingURL=renderToSvgString.d.ts.map
+//# sourceMappingURL=render-to-svg-string.d.ts.map

package/dist/es/render-to-svg-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-to-svg-string.d.ts","sourceRoot":"","sources":["../../src/render-to-svg-string.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,EAAE,UAAS,qBAA0B,KAAG,MAU3F,CAAC"}

package/dist/es/{renderToSvgString.js → render-to-svg-string.js}

@@ -1,7 +1,7 @@
-import { isFigure } from "./builder/isFigure.js";
-import { toScene } from "./toScene.js";
+import { isFigure } from "./builder/is-figure.js";
+import { toScene } from "./to-scene.js";
 import { renderToSvgString } from "@retikz/render/svg";
-//#region src/renderToSvgString.ts
+//#region src/render-to-svg-string.ts
 /**
 * 把 IR / Scene / Figure 渲染成 SVG 字符串（SSR / 构建期）
 * @description 收 `Figure` 时 delegate 给 `figure.toSvgString`。收 IR/Scene 时薄包 `@retikz/render/svg`：`toScene`

package/dist/es/{svgNodeToDom.d.ts → svg-node-to-dom.d.ts}

@@ -11,4 +11,4 @@ export declare const applyAttrs: (el: SVGElement, node: SvgNode) => void;
  *   （`document.createElementNS`），模块顶层不碰任何 DOM 全局——守 SSR 导入安全。
  */
 export declare const svgNodeToDom: (node: SvgNode) => SVGElement;
-//# sourceMappingURL=svgNodeToDom.d.ts.map
+//# sourceMappingURL=svg-node-to-dom.d.ts.map

package/dist/es/svg-node-to-dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-node-to-dom.d.ts","sourceRoot":"","sources":["../../src/svg-node-to-dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAIlD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,IAAI,UAAU,EAAE,MAAM,OAAO,KAAG,IAS1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,KAAG,UAO5C,CAAC"}

package/dist/es/{svgNodeToDom.js → svg-node-to-dom.js}

@@ -1,4 +1,4 @@
-//#region src/svgNodeToDom.ts
+//#region src/svg-node-to-dom.ts
 var SVG_NS = "http://www.w3.org/2000/svg";
 /**
 * 把 `SvgNode` 的 attrs / style 写到一个（可复用的）SVG 元素上

package/dist/{lib/toScene.d.ts → es/to-scene.d.ts}

@@ -7,4 +7,4 @@ import { CommonOptions } from './types';
  *   `fallbackMeasurer`，Node 下确定可跑）。注：调用方须先把 `Figure` 解成 `ir`，此处只认 `IR | Scene`。
  */
 export declare const toScene: (input: Scene | IR, options: CommonOptions) => Scene;
-//# sourceMappingURL=toScene.d.ts.map
+//# sourceMappingURL=to-scene.d.ts.map

package/dist/es/to-scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-scene.d.ts","sourceRoot":"","sources":["../../src/to-scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,KAAK,EAAkB,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,GAAG,EAAE,EAAE,SAAS,aAAa,KAAG,KAOnE,CAAC"}

package/dist/es/{toScene.js → to-scene.js}

@@ -1,5 +1,5 @@
 import { compileToScene } from "@retikz/core";
-//#region src/toScene.ts
+//#region src/to-scene.ts
 /**
 * 入参归一成 `Scene`
 * @description 已是 `Scene`（有 `primitives`）直接用；否则当 `IR` 经 `compileToScene` 编译。剥掉 render-only 键

package/dist/es/types.d.ts

@@ -18,7 +18,7 @@ export type CommonOptions = {
     height?: number;
     /**
      * 是否播放动画（缺省 true）；`false` → 渲染 base 静态图（不 emit CSS/WAAPI、Canvas 不起 rAF）
-     * @description runtime 据 `{animate:false}` 或 `prefers-reduced-motion` 走静态路径（ADR-01「三事一路」）。
+     * @description runtime 据 `{animate:false}` 或 `prefers-reduced-motion` 走静态路径，不起任何动画。
      */
     animate?: boolean;
     /**
@@ -37,7 +37,7 @@ export type VanillaView = {
     readonly root: SVGSVGElement;
     /** 整图重渲染（原地复用 `root`，清子节点 + 重设 root attrs + 重物化），不承诺局部 patch */
     update: (next: RenderInput) => void;
-    /** 卸载：移除 `root`、置 view 失效（再调 `update` 抛、`dispose` noop） */
+    /** 卸载：解绑本 view 上未手动 dispose 的水合、移除 `root`、置 view 失效（再调 `update` 抛、`dispose` noop） */
     dispose: () => void;
     /**
      * 绑定 handler 到本 view 的 `<svg>`（locateSvg 定位）；handler 收 `(event, context)` 富上下文

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,oFAAoF;AACpF,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,cAAc,CAAC;AAEnB,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,gEAAgE;IAChE,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC,2DAA2D;IAC3D,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,CAAC;IACtD,yEAAyE;IACzE,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG;IAC5B,kCAAkC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qFAAqF;IACrF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG;IACvB,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,iDAAiD;IACjD,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC,gEAAgE;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4FAA4F;IAC5F,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,CAAC;IACtD;;;;OAIG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC;IAChE,6DAA6D;IAC7D,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,oFAAoF;AACpF,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,cAAc,CAAC;AAEnB,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC,6DAA6D;AAC7D,MAAM,MAAM,WAAW,GAAG;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,gEAAgE;IAChE,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC,qFAAqF;IACrF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;;;OAIG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,CAAC;IACtD,yEAAyE;IACzE,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,yCAAyC;AACzC,MAAM,MAAM,eAAe,GAAG;IAC5B,kCAAkC;IAClC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,kEAAkE;IAClE,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qFAAqF;IACrF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gFAAgF;IAChF,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG;IACvB,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,2BAA2B;IAC3B,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,iDAAiD;IACjD,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;IACpC,gEAAgE;IAChE,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,4FAA4F;IAC5F,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,eAAe,CAAC;IACtD;;;;OAIG;IACH,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,UAAU,CAAC;IAChE,6DAA6D;IAC7D,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG;IAC/C,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;CACjD,CAAC"}

package/dist/lib/builder/{isFigure.cjs → is-figure.cjs}

@@ -1,4 +1,4 @@
-//#region src/builder/isFigure.ts
+//#region src/builder/is-figure.ts
 /** Figure 品牌标记（Symbol.for 跨包/重复 import 仍同一）；标准 mountSvg/renderToSvgString 用它区分 Figure 与 IR/Scene */
 var FIGURE_BRAND = Symbol.for("retikz.vanilla.figure");
 /** 运行时判断一个值是不是 Figure（带 brand）；纯结构检查、零内部 import → 不与 mountSvg/Figure 形成运行时环 */

package/dist/lib/builder/{isFigure.d.ts → is-figure.d.ts}

@@ -3,4 +3,4 @@ import { Figure } from '../figure';
 export declare const FIGURE_BRAND: unique symbol;
 /** 运行时判断一个值是不是 Figure（带 brand）；纯结构检查、零内部 import → 不与 mountSvg/Figure 形成运行时环 */
 export declare const isFigure: (value: unknown) => value is Figure;
-//# sourceMappingURL=isFigure.d.ts.map
+//# sourceMappingURL=is-figure.d.ts.map

package/dist/lib/builder/is-figure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-figure.d.ts","sourceRoot":"","sources":["../../../src/builder/is-figure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,oGAAoG;AACpG,eAAO,MAAM,YAAY,EAAE,OAAO,MAA4C,CAAC;AAE/E,+EAA+E;AAC/E,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACuD,CAAC"}

package/dist/lib/builder/types.cjs

@@ -0,0 +1,17 @@
+//#region src/builder/types.ts
+/** {@link FigureRootStyle} 的字段表——`figure.ts` 组 IR 时拣根样式 + 从 render options 剔除（IR-only 字段不下发） */
+var FIGURE_ROOT_STYLE_FIELDS = [
+	"color",
+	"stroke",
+	"fill",
+	"strokeWidth",
+	"opacity",
+	"fillOpacity",
+	"drawOpacity",
+	"nodeDefault",
+	"pathDefault",
+	"labelDefault",
+	"arrowDefault"
+];
+//#endregion
+exports.FIGURE_ROOT_STYLE_FIELDS = FIGURE_ROOT_STYLE_FIELDS;

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

@@ -1,4 +1,4 @@
-import { CompileOptions, IRChild, IRCoordinate, IRNode, IRPath, IRScope, IRViewBox, WayDSL } from '@retikz/core';
+import { CompileOptions, IRAnimationTrack, IRChild, IRCoordinate, IRNode, IRPath, IRScope, IRViewBox, WayDSL } from '@retikz/core';
 /** builder 函数返回的 IR 子节点（node / draw / coordinate / scope 的产物） */
 export type Child = IRChild;
 /** node 的 config：从 IRNode 派生，剔除判别符 type 与提为 positional 的 id */
@@ -11,16 +11,29 @@ export type CoordinateConfig = Omit<IRCoordinate, 'type' | 'id'>;
 export type ScopeConfig = Omit<IRScope, 'type' | 'children'>;
 /** draw 的 way：直接复用 core 的 way DSL 全集（id 串 / 坐标 / Cycle / 折角 / 相对 / 曲线 / 弧 …） */
 export type Way = WayDSL;
+/**
+ * figure 根级级联样式默认（与 React `<Layout>` 顶层样式 props 对齐）
+ * @description 取 `IRScope` 的级联样式通道（graphic state + 四通道 every-X），**不含**容器 / 命名空间 / 变换 /
+ *   屏障 / 栈序 / 裁剪字段（那些挂在 figure 根上语义易混）。组 IR 时若任一字段携带样式指令，把根 children 包进
+ *   一层合成根 `<Scope>`，等价于用户手写一层根 scope；全缺省时不包，IR 形态逐字保持。
+ */
+export type FigureRootStyle = Pick<IRScope, 'color' | 'stroke' | 'fill' | 'strokeWidth' | 'opacity' | 'fillOpacity' | 'drawOpacity' | 'nodeDefault' | 'pathDefault' | 'labelDefault' | 'arrowDefault'>;
+/** {@link FigureRootStyle} 的字段表——`figure.ts` 组 IR 时拣根样式 + 从 render options 剔除（IR-only 字段不下发） */
+export declare const FIGURE_ROOT_STYLE_FIELDS: readonly ["color", "stroke", "fill", "strokeWidth", "opacity", "fillOpacity", "drawOpacity", "nodeDefault", "pathDefault", "labelDefault", "arrowDefault"];
 /**
  * figure 的 config
- * @description `viewBox` → IR.viewBox（内容坐标系）；`width`/`height` → 根 `<svg>` 显示尺寸（adapter 职责）；
- *   `idPrefix` → SVG 资源 id 前缀；其余（measureText / shapes / arrows / patterns / pathGenerators /
- *   padding / precision / nodeDistance / onWarn）派生自 core `CompileOptions`、原样喂 compileToScene。
+ * @description `viewBox` → IR.viewBox（内容坐标系）；`animations` → IR 根 `animations`（镜头时间轴，配 cameraTo
+ *   preset）；`width`/`height` → 根 `<svg>` 显示尺寸（adapter 职责）；`idPrefix` → SVG 资源 id 前缀；根级级联样式
+ *   （color / nodeDefault / pathDefault / labelDefault / arrowDefault 等）按需包合成根 `<Scope>`；其余（measureText /
+ *   shapes / arrows / patterns / pathGenerators / padding / precision / nodeDistance / onWarn）派生自 core
+ *   `CompileOptions`、原样喂 compileToScene。
  */
 export type FigureConfig = {
     width?: number;
     height?: number;
     viewBox?: IRViewBox;
     idPrefix?: string;
-} & CompileOptions;
+    /** scene 根（镜头）时间轴动画 tracks（`viewBox` property，配 `cameraTo()` preset）；注入 IR 根 `animations` */
+    animations?: Array<IRAnimationTrack>;
+} & FigureRootStyle & CompileOptions;
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EACP,YAAY,EACZ,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACP,MAAM,cAAc,CAAC;AAEtB,iEAAiE;AACjE,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC;AAE5B,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE3D,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,cAAc,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,OAAO,EACP,YAAY,EACZ,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,MAAM,EACP,MAAM,cAAc,CAAC;AAEtB,iEAAiE;AACjE,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC;AAE5B,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAErD,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE3D,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;AAE7D,gFAAgF;AAChF,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,OAAO,EACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,aAAa,GACb,SAAS,GACT,aAAa,GACb,aAAa,GACb,aAAa,GACb,aAAa,GACb,cAAc,GACd,cAAc,CACjB,CAAC;AAEF,gGAAgG;AAChG,eAAO,MAAM,wBAAwB,4JAYoB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;CACtC,GAAG,eAAe,GACjB,cAAc,CAAC"}