@retikz/vanilla 0.3.0-alpha.5 → 0.3.0-beta.2

package/dist/lib/{mountCanvas.cjs → mount-canvas.cjs}

@@ -1,9 +1,9 @@
-const require_isFigure = require("./builder/isFigure.cjs");
-const require_toScene = require("./toScene.cjs");
+const require_is_figure = require("./builder/is-figure.cjs");
+const require_to_scene = require("./to-scene.cjs");
 let _retikz_render_animation = require("@retikz/render/animation");
 let _retikz_render_hydration = require("@retikz/render/hydration");
 let _retikz_render_canvas = require("@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;
@@ -12,19 +12,24 @@ var resolveDevicePixelRatio = (override) => {
 };
 /**
 * 把 IR / Scene / Figure 挂成真实 `<canvas>` DOM（无框架浏览器 runtime，对齐 `mountSvg`）
-* @description 收 IR 时 `toScene` compile、收 Scene 直用、收 Figure 解 `figure.ir`。位图按「名义显示尺寸」
+* @description 收 `Figure` 时 delegate 给 `figure.mountCanvas`（与 mountSvg→`figure.mount` 对称）。收 IR 时
+*   `toScene` compile、收 Scene 直用。位图按「名义显示尺寸」
 *   `width`/`height`（均为有限数值时）× dpr 开、否则回退内容边界；`renderToCanvas` 再把 Scene 内容 meet-fit
 *   进去（镜像 SVG `preserveAspectRatio=meet` + CanvasHost）。返回的 `CanvasView` 暴露 `hydrate`（hitTest 定位）
 *   与 `clientToScene`（逆 meet-fit 坐标映射）。DOM 仅在调用时惰性触碰，`import` 本模块不碰 DOM——守 SSR 导入安全。
 */
 var mountCanvas = (container, input, options = {}) => {
+	if (require_is_figure.isFigure(input)) return input.mountCanvas(container, options);
 	if (typeof Element === "undefined" || !(container instanceof Element)) throw new Error("mountCanvas: container must be a DOM Element.");
 	const canvas = document.createElement("canvas");
 	const ratio = resolveDevicePixelRatio(options.devicePixelRatio);
 	const animate = options.animate !== false && !(0, _retikz_render_animation.prefersReducedMotion)();
 	let clock;
 	const registry = (0, _retikz_render_animation.createIdClockRegistry)();
+	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",
@@ -42,9 +47,52 @@ var mountCanvas = (container, input, options = {}) => {
 			resolvePrimAnimation: (id) => resolvePrim(id, time)
 		});
 	};
+	const ensureClockPlaying = () => {
+		clock?.play();
+	};
+	/** Canvas visible trigger：按 canvas client rect 与 id 聚合 bbox 相交激活一次 */
+	const activateVisibleTracks = () => {
+		const ids = (0, _retikz_render_hydration.collectCanvasVisibleAnimationIds)(currentScene);
+		if (ids.size === 0) return;
+		let changed = false;
+		for (const id of ids) {
+			if (visibleActivated.has(id)) continue;
+			if (!(0, _retikz_render_hydration.isCanvasAnimationIdVisible)(canvas, currentScene, id)) continue;
+			registry.restart(id, clock?.time ?? 0);
+			visibleActivated.add(id);
+			changed = true;
+		}
+		if (!changed) return;
+		ensureClockPlaying();
+		renderFrame();
+	};
+	const resetVisibleBridge = () => {
+		visibleActivated = /* @__PURE__ */ new Set();
+		visibleTeardown?.();
+		visibleTeardown = void 0;
+		if (!animate || !(0, _retikz_render_animation.sceneHasAnimations)(currentScene)) return;
+		if ((0, _retikz_render_hydration.collectCanvasVisibleAnimationIds)(currentScene).size === 0 || typeof window === "undefined") return;
+		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);
+		schedule();
+		visibleTeardown = () => {
+			window.removeEventListener("scroll", schedule, true);
+			window.removeEventListener("resize", schedule);
+			if (scheduledRaf !== void 0) window.cancelAnimationFrame(scheduledRaf);
+		};
+	};
 	const renderInto = (next) => {
-		if (require_isFigure.isFigure(next)) throw new Error("mountCanvas: view.update does not accept a Figure; pass figure.ir instead.");
-		const scene = require_toScene.toScene(next, options);
+		if (require_is_figure.isFigure(next)) throw new Error("mountCanvas: view.update does not accept a Figure; pass figure.ir instead.");
+		const scene = require_to_scene.toScene(next, options);
 		currentScene = scene;
 		const hasNominalSize = typeof options.width === "number" && Number.isFinite(options.width) && typeof options.height === "number" && Number.isFinite(options.height);
 		const bitmapWidth = hasNominalSize ? options.width : scene.layout.width;
@@ -54,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) {
+			(0, _retikz_render_canvas.renderToCanvas)(canvas, scene, {
+				devicePixelRatio: ratio,
+				time: options.snapshotAt,
+				easings: options.easings,
+				animationProperties: options.animationProperties
+			});
+			return;
+		}
 		(0, _retikz_render_canvas.renderToCanvas)(canvas, scene, { devicePixelRatio: ratio });
 		clock?.dispose();
 		clock = void 0;
@@ -70,8 +127,9 @@ var mountCanvas = (container, input, options = {}) => {
 			});
 			if ((0, _retikz_render_animation.sceneHasAutoplayTrigger)(scene)) clock.play();
 		}
+		resetVisibleBridge();
 	};
-	renderInto(require_isFigure.isFigure(input) ? input.ir : input);
+	renderInto(input);
 	container.appendChild(canvas);
 	/**
 	* 把指针的 client 像素坐标逆 meet-fit 映射成 Scene user units
@@ -109,38 +167,57 @@ var mountCanvas = (container, input, options = {}) => {
 			context2d?.setTransform(1, 0, 0, 1, 0, 0);
 			return (0, _retikz_render_canvas.hitTest)(currentScene, scenePoint, { context2d });
 		};
-		const buildContext = (event, id) => {
-			const mouse = event;
-			return {
-				id,
-				meta: (0, _retikz_render_hydration.metaOf)(currentScene, id),
-				renderer: "canvas",
-				element: null,
-				root: canvas,
-				point: typeof mouse.clientX === "number" ? clientToScene(mouse.clientX, mouse.clientY) : null,
-				geometry: (0, _retikz_render_hydration.geometryOf)(currentScene, id),
-				animation: (0, _retikz_render_hydration.createCanvasIdAnimationControls)({
-					registry,
-					clockTime: () => clock?.time ?? 0,
-					ensurePlaying: () => clock?.play(),
-					renderFrame,
-					defaultId: id
-				}),
-				scene: currentScene
-			};
+		const buildContext = (0, _retikz_render_hydration.createContextBuilder)({
+			renderer: "canvas",
+			root: canvas,
+			scene: () => currentScene,
+			resolveElement: () => null,
+			resolvePoint: (event) => {
+				const mouse = event;
+				return typeof mouse.clientX === "number" ? clientToScene(mouse.clientX, mouse.clientY) : null;
+			},
+			makeAnimation: (id) => (0, _retikz_render_hydration.createCanvasIdAnimationControls)({
+				registry,
+				clockTime: () => clock?.time ?? 0,
+				ensurePlaying: () => clock?.play(),
+				renderFrame,
+				defaultId: id
+			})
+		});
+		const userHandlers = hydrateOptions.handlers;
+		const bind = () => (0, _retikz_render_hydration.createHydrationController)(canvas, (0, _retikz_render_hydration.withCanvasAnimationEventHandlers)(currentScene, userHandlers), locate, buildContext);
+		let controller = bind();
+		const live = {
+			rebind: () => {
+				controller.dispose();
+				controller = bind();
+			},
+			unbind: () => controller.dispose()
 		};
-		return { dispose: (0, _retikz_render_hydration.createHydrationController)(canvas, hydrateOptions.handlers, locate, buildContext).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/mountCanvas.d.ts → lib/mount-canvas.d.ts}

@@ -1,10 +1,11 @@
 import { CanvasView, MountCanvasOptions, RenderInput } from './types';
 /**
  * 把 IR / Scene / Figure 挂成真实 `<canvas>` DOM（无框架浏览器 runtime，对齐 `mountSvg`）
- * @description 收 IR 时 `toScene` compile、收 Scene 直用、收 Figure 解 `figure.ir`。位图按「名义显示尺寸」
+ * @description 收 `Figure` 时 delegate 给 `figure.mountCanvas`（与 mountSvg→`figure.mount` 对称）。收 IR 时
+ *   `toScene` compile、收 Scene 直用。位图按「名义显示尺寸」
  *   `width`/`height`（均为有限数值时）× dpr 开、否则回退内容边界；`renderToCanvas` 再把 Scene 内容 meet-fit
  *   进去（镜像 SVG `preserveAspectRatio=meet` + CanvasHost）。返回的 `CanvasView` 暴露 `hydrate`（hitTest 定位）
  *   与 `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/lib/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/lib/{mountSvg.cjs → mount-svg.cjs}

@@ -1,13 +1,11 @@
-const require_isFigure = require("./builder/isFigure.cjs");
-const require_toScene = require("./toScene.cjs");
-const require_svgNodeToDom = require("./svgNodeToDom.cjs");
+const require_is_figure = require("./builder/is-figure.cjs");
+const require_to_scene = require("./to-scene.cjs");
+const require_svg_node_to_dom = require("./svg-node-to-dom.cjs");
 let _retikz_render_svg = require("@retikz/render/svg");
 let _retikz_render_animation = require("@retikz/render/animation");
 let _retikz_render_hydration = require("@retikz/render/hydration");
-//#region src/mountSvg.ts
+//#region src/mount-svg.ts
 var SVG_NS = "http://www.w3.org/2000/svg";
-/** 默认资源 id 前缀（确定性）；多实例同页须经 `options.idPrefix` 显式区分 */
-var DEFAULT_ID_PREFIX = "r";
 /**
 * 把 IR / Scene / Figure 挂成真实 SVG DOM（无框架浏览器 runtime）
 * @description 收 `Figure` 时 delegate 给 `figure.mount`（Figure 自持 config，call-site options 覆盖）。收
@@ -16,16 +14,17 @@ var DEFAULT_ID_PREFIX = "r";
 *   原地重渲染、root 元素 identity 跨 update 不变、不失效。DOM 仅在调用时惰性触碰，`import` 本模块不碰 DOM——守 SSR 导入安全。
 */
 var mountSvg = (container, input, options = {}) => {
-	if (require_isFigure.isFigure(input)) return input.mount(container, options);
+	if (require_is_figure.isFigure(input)) return input.mount(container, options);
 	if (typeof Element === "undefined" || !(container instanceof Element)) throw new Error("mountSvg: container must be a DOM Element.");
-	const idPrefix = options.idPrefix ?? DEFAULT_ID_PREFIX;
+	const idPrefix = options.idPrefix ?? "r";
 	const root = document.createElementNS(SVG_NS, "svg");
 	const animate = options.animate !== false && !(0, _retikz_render_animation.prefersReducedMotion)();
 	let animationControls;
 	let currentScene;
+	const liveHydrationDisposers = /* @__PURE__ */ new Set();
 	const renderInto = (next) => {
-		if (require_isFigure.isFigure(next)) throw new Error("mountSvg: view.update does not accept a Figure; pass figure.ir instead.");
-		const scene = require_toScene.toScene(next, options);
+		if (require_is_figure.isFigure(next)) throw new Error("mountSvg: view.update does not accept a Figure; pass figure.ir instead.");
+		const scene = require_to_scene.toScene(next, options);
 		currentScene = scene;
 		const doc = (0, _retikz_render_svg.buildSvgDocument)(scene, {
 			idPrefix,
@@ -35,10 +34,10 @@ var mountSvg = (container, input, options = {}) => {
 		});
 		while (root.firstChild) root.removeChild(root.firstChild);
 		for (const attr of [...root.attributes]) root.removeAttribute(attr.name);
-		require_svgNodeToDom.applyAttrs(root, doc);
+		require_svg_node_to_dom.applyAttrs(root, doc);
 		if (options.width !== void 0) root.setAttribute("width", String(options.width));
 		if (options.height !== void 0) root.setAttribute("height", String(options.height));
-		for (const child of doc.children ?? []) root.appendChild(typeof child === "string" ? document.createTextNode(child) : require_svgNodeToDom.svgNodeToDom(child));
+		for (const child of doc.children ?? []) root.appendChild(typeof child === "string" ? document.createTextNode(child) : require_svg_node_to_dom.svgNodeToDom(child));
 		animationControls?.dispose();
 		animationControls = animate && (0, _retikz_render_animation.sceneHasAnimations)(scene) ? (0, _retikz_render_animation.bindWaapiDescriptors)(root) : void 0;
 	};
@@ -51,18 +50,21 @@ var mountSvg = (container, input, options = {}) => {
 	*   `data-retikz-animation-owner` 双查 `getAnimations()` per-id 控制。
 	*/
 	const hydrate = (hydrateOptions) => {
-		const buildContext = (event, id) => ({
-			id,
-			meta: (0, _retikz_render_hydration.metaOf)(currentScene, id),
+		const buildContext = (0, _retikz_render_hydration.createContextBuilder)({
 			renderer: "svg",
-			element: (0, _retikz_render_hydration.resolveSvgElement)(event),
 			root,
-			point: (0, _retikz_render_hydration.resolvePointViaLayout)(root, currentScene.layout)(event),
-			geometry: (0, _retikz_render_hydration.geometryOf)(currentScene, id),
-			animation: (0, _retikz_render_hydration.createSvgAnimationControls)(root, id),
-			scene: currentScene
+			scene: () => currentScene,
+			resolveElement: _retikz_render_hydration.resolveSvgElement,
+			resolvePoint: (event) => (0, _retikz_render_hydration.resolvePointViaLayout)(root, currentScene.layout)(event),
+			makeAnimation: (id) => (0, _retikz_render_hydration.createSvgAnimationControls)(root, id)
 		});
-		return { dispose: (0, _retikz_render_hydration.createHydrationController)(root, hydrateOptions.handlers, _retikz_render_hydration.locateSvg, buildContext).dispose };
+		const controller = (0, _retikz_render_hydration.createHydrationController)(root, hydrateOptions.handlers, _retikz_render_hydration.locateSvg, buildContext);
+		const dispose = () => {
+			controller.dispose();
+			liveHydrationDisposers.delete(dispose);
+		};
+		liveHydrationDisposers.add(dispose);
+		return { dispose };
 	};
 	let disposed = false;
 	return {
@@ -75,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/{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/lib/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/lib/render-to-svg-string.cjs

@@ -0,0 +1,23 @@
+const require_is_figure = require("./builder/is-figure.cjs");
+const require_to_scene = require("./to-scene.cjs");
+let _retikz_render_svg = require("@retikz/render/svg");
+//#region src/render-to-svg-string.ts
+/**
+* 把 IR / Scene / Figure 渲染成 SVG 字符串（SSR / 构建期）
+* @description 收 `Figure` 时 delegate 给 `figure.toSvgString`。收 IR/Scene 时薄包 `@retikz/render/svg`：`toScene`
+*   （ir 缺省走 core fallback measurer、确定性）→ 序列化。`width`/`height` 直接透传给 render，由其结构化写进根
+*   `<svg>` attrs（不在本层对字符串做正则后处理）。零 DOM。
+*/
+var renderToSvgString = (input, options = {}) => {
+	if (require_is_figure.isFigure(input)) return input.toSvgString(options);
+	return (0, _retikz_render_svg.renderToSvgString)(require_to_scene.toScene(input, options), {
+		idPrefix: options.idPrefix ?? "r",
+		animate: options.animate,
+		snapshotAt: options.snapshotAt,
+		easings: options.easings,
+		width: options.width,
+		height: options.height
+	});
+};
+//#endregion
+exports.renderToSvgString = renderToSvgString;

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

@@ -2,7 +2,8 @@ import { RenderInput, RenderToStringOptions } from './types';
 /**
  * 把 IR / Scene / Figure 渲染成 SVG 字符串（SSR / 构建期）
  * @description 收 `Figure` 时 delegate 给 `figure.toSvgString`。收 IR/Scene 时薄包 `@retikz/render/svg`：`toScene`
- *   （ir 缺省走 core fallback measurer、确定性）→ 序列化 → 若给 `width`/`height` 注入根 `<svg>`。零 DOM。
+ *   （ir 缺省走 core fallback measurer、确定性）→ 序列化。`width`/`height` 直接透传给 render，由其结构化写进根
+ *   `<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/lib/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/lib/{svgNodeToDom.cjs → svg-node-to-dom.cjs}

@@ -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/{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/lib/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/lib/{toScene.cjs → to-scene.cjs}

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

package/dist/lib/{toScene.d.ts → 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/lib/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/lib/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/lib/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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@retikz/vanilla",
-  "version": "0.3.0-alpha.5",
-  "description": "Framework-free runtime for retikz: mount Scene/IR to SVG DOM, or render to SVG string for SSR.",
+  "version": "0.3.0-beta.2",
+  "description": "Framework-free retikz runtime: mount SVG/Canvas, hydrate interactions, control animations, or render SVG strings for SSR.",
   "type": "module",
   "author": "Pionpill",
   "homepage": "https://pionpill.github.io/retikz/",
@@ -39,17 +39,16 @@
     "dist/**/*"
   ],
   "dependencies": {
-    "@retikz/core": "0.3.0-alpha.5",
-    "@retikz/render": "0.3.0-alpha.5"
+    "@retikz/core": "0.3.0-beta.2",
+    "@retikz/render": "0.3.0-beta.2"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
     "typescript": "^6.0.3",
     "vite": "^8.0.10",
     "vite-plugin-dts": "^4.5.4",
-    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.1.5",
-    "zod": "^3.23.8"
+    "zod": "^4.4.3"
   },
   "scripts": {
     "dev": "vite",

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

@@ -1 +0,0 @@
-{"version":3,"file":"isFigure.d.ts","sourceRoot":"","sources":["../../../src/builder/isFigure.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/mountCanvas.d.ts.map

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

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

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"renderToSvgString.d.ts","sourceRoot":"","sources":["../../src/renderToSvgString.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAYlE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,EAAE,UAAS,qBAA0B,KAAG,MAS3F,CAAC"}

package/dist/es/renderToSvgString.js

@@ -1,28 +0,0 @@
-import { isFigure } from "./builder/isFigure.js";
-import { toScene } from "./toScene.js";
-import { renderToSvgString } from "@retikz/render/svg";
-//#region src/renderToSvgString.ts
-/** 默认资源 id 前缀（确定性）；多实例同页须经 `options.idPrefix` 显式区分 */
-var DEFAULT_ID_PREFIX = "r";
-/** 把 `width`/`height` 注入到开头的 `<svg` 标签（@retikz/render/svg 只产 viewBox） */
-var injectSize = (svg, width, height) => {
-	if (width === void 0 && height === void 0) return svg;
-	const attrs = [width !== void 0 ? ` width="${width}"` : "", height !== void 0 ? ` height="${height}"` : ""].join("");
-	return svg.replace(/^<svg/, `<svg${attrs}`);
-};
-/**
-* 把 IR / Scene / Figure 渲染成 SVG 字符串（SSR / 构建期）
-* @description 收 `Figure` 时 delegate 给 `figure.toSvgString`。收 IR/Scene 时薄包 `@retikz/render/svg`：`toScene`
-*   （ir 缺省走 core fallback measurer、确定性）→ 序列化 → 若给 `width`/`height` 注入根 `<svg>`。零 DOM。
-*/
-var renderToSvgString$1 = (input, options = {}) => {
-	if (isFigure(input)) return input.toSvgString(options);
-	return injectSize(renderToSvgString(toScene(input, options), {
-		idPrefix: options.idPrefix ?? DEFAULT_ID_PREFIX,
-		animate: options.animate,
-		snapshotAt: options.snapshotAt,
-		easings: options.easings
-	}), options.width, options.height);
-};
-//#endregion
-export { renderToSvgString$1 as renderToSvgString };

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

@@ -1 +0,0 @@
-{"version":3,"file":"svgNodeToDom.d.ts","sourceRoot":"","sources":["../../src/svgNodeToDom.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/toScene.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toScene.d.ts","sourceRoot":"","sources":["../../src/toScene.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/lib/builder/isFigure.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"isFigure.d.ts","sourceRoot":"","sources":["../../../src/builder/isFigure.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/mountCanvas.d.ts.map

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

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

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

package/dist/lib/renderToSvgString.cjs

@@ -1,28 +0,0 @@
-const require_isFigure = require("./builder/isFigure.cjs");
-const require_toScene = require("./toScene.cjs");
-let _retikz_render_svg = require("@retikz/render/svg");
-//#region src/renderToSvgString.ts
-/** 默认资源 id 前缀（确定性）；多实例同页须经 `options.idPrefix` 显式区分 */
-var DEFAULT_ID_PREFIX = "r";
-/** 把 `width`/`height` 注入到开头的 `<svg` 标签（@retikz/render/svg 只产 viewBox） */
-var injectSize = (svg, width, height) => {
-	if (width === void 0 && height === void 0) return svg;
-	const attrs = [width !== void 0 ? ` width="${width}"` : "", height !== void 0 ? ` height="${height}"` : ""].join("");
-	return svg.replace(/^<svg/, `<svg${attrs}`);
-};
-/**
-* 把 IR / Scene / Figure 渲染成 SVG 字符串（SSR / 构建期）
-* @description 收 `Figure` 时 delegate 给 `figure.toSvgString`。收 IR/Scene 时薄包 `@retikz/render/svg`：`toScene`
-*   （ir 缺省走 core fallback measurer、确定性）→ 序列化 → 若给 `width`/`height` 注入根 `<svg>`。零 DOM。
-*/
-var renderToSvgString = (input, options = {}) => {
-	if (require_isFigure.isFigure(input)) return input.toSvgString(options);
-	return injectSize((0, _retikz_render_svg.renderToSvgString)(require_toScene.toScene(input, options), {
-		idPrefix: options.idPrefix ?? DEFAULT_ID_PREFIX,
-		animate: options.animate,
-		snapshotAt: options.snapshotAt,
-		easings: options.easings
-	}), options.width, options.height);
-};
-//#endregion
-exports.renderToSvgString = renderToSvgString;

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

@@ -1 +0,0 @@
-{"version":3,"file":"renderToSvgString.d.ts","sourceRoot":"","sources":["../../src/renderToSvgString.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAYlE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,WAAW,EAAE,UAAS,qBAA0B,KAAG,MAS3F,CAAC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"svgNodeToDom.d.ts","sourceRoot":"","sources":["../../src/svgNodeToDom.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/lib/toScene.d.ts.map

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