@retikz/vanilla 0.3.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 pionpill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,50 @@
+# @retikz/vanilla
+
+Framework-free runtime + SSR entry for [retikz](https://pionpill.github.io/retikz/). No JSX, no UI framework — mount a diagram to the DOM, render it to an SVG string on the server, or compose one with an imperative named builder.
+
+retikz 的无框架 runtime / SSR 入口：不依赖任何 UI 框架。`renderToSvgString` 走服务端 / 构建期（零 DOM）产 SVG 字符串；`mountSvg` 在浏览器把图形挂到 DOM；命令式 builder（`figure`/`node`/`draw`/`coordinate`/`scope`）让你像 React 一样具名构图、产同一份 IR。组合 `@retikz/render` 内核，不自维护第二套渲染逻辑。
+
+## Install
+
+```bash
+pnpm add @retikz/vanilla @retikz/core @retikz/render
+```
+
+## Render IR / Scene
+
+```ts
+import { renderToSvgString, mountSvg } from '@retikz/vanilla';
+
+// server / build time — no DOM
+const svg = renderToSvgString(ir);
+
+// browser
+mountSvg(document.querySelector('#diagram'), ir);
+```
+
+## Imperative builder
+
+```ts
+import { figure, node, draw } from '@retikz/vanilla';
+
+const fig = figure([
+  node('a', { position: [0, 0], text: 'A' }),
+  node('b', { position: [120, 0], text: 'B' }),
+  draw(['a', 'b'], { arrow: '->' }),
+]);
+
+const svg = fig.toSvgString();   // also: fig.mount(el) / fig.toCanvas(canvas)
+```
+
+## Exports
+
+- Runtime: `renderToSvgString`, `mountSvg`
+- Builder: `figure` / `node` / `draw` / `coordinate` / `scope` + the `Figure` view (`.toSvgString` / `.mount` / `.toCanvas`)
+
+## Docs
+
+<https://pionpill.github.io/retikz/>
+
+## License
+
+MIT

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

@@ -0,0 +1,8 @@
+import { Child, CoordinateConfig } from './types';
+/**
+ * 构造一个 coordinate IR 子节点（具名点占位，不绘制）
+ * @description `id` 必要（coordinate 存在意义就是被引用），提为首 positional；`position` 在 config 必填
+ *   （类型层 `CoordinateConfig` 派生自 `IRCoordinate` 故 position 非可选），缺失在编译期由 schema 报错。
+ */
+export declare const coordinate: (id: string, config: CoordinateConfig) => Child;
+//# sourceMappingURL=coordinate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate.d.ts","sourceRoot":"","sources":["../../../src/builder/coordinate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,IAAI,MAAM,EAAE,QAAQ,gBAAgB,KAAG,KAIhE,CAAC"}

package/dist/es/builder/coordinate.js

@@ -0,0 +1,13 @@
+//#region src/builder/coordinate.ts
+/**
+* 构造一个 coordinate IR 子节点（具名点占位，不绘制）
+* @description `id` 必要（coordinate 存在意义就是被引用），提为首 positional；`position` 在 config 必填
+*   （类型层 `CoordinateConfig` 派生自 `IRCoordinate` 故 position 非可选），缺失在编译期由 schema 报错。
+*/
+var coordinate = (id, config) => ({
+	type: "coordinate",
+	id,
+	...config
+});
+//#endregion
+export { coordinate };

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

@@ -0,0 +1,8 @@
+import { Child, DrawConfig, Way } from './types';
+/**
+ * 构造一个 path IR 子节点
+ * @description `way` 经 core `parseWay` 解析成 IRStep 序列（与 React `<Draw way>` 同一解析、同一全集，零漂移）；
+ *   `config` 是 path 级样式（arrow / stroke / dashPattern / fill …），原样并入。
+ */
+export declare const draw: (way: Way, config?: DrawConfig) => Child;
+//# sourceMappingURL=draw.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draw.d.ts","sourceRoot":"","sources":["../../../src/builder/draw.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,KAAK,GAAG,EAAE,SAAS,UAAU,KAAG,KAInD,CAAC"}

package/dist/es/builder/draw.js

@@ -0,0 +1,14 @@
+import { parseWay } from "@retikz/core";
+//#region src/builder/draw.ts
+/**
+* 构造一个 path IR 子节点
+* @description `way` 经 core `parseWay` 解析成 IRStep 序列（与 React `<Draw way>` 同一解析、同一全集，零漂移）；
+*   `config` 是 path 级样式（arrow / stroke / dashPattern / fill …），原样并入。
+*/
+var draw = (way, config) => ({
+	type: "path",
+	children: parseWay(way),
+	...config
+});
+//#endregion
+export { draw };

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

@@ -0,0 +1,21 @@
+import { Figure } from '../figure';
+import { Child, FigureConfig } from './types';
+/**
+ * `figure` 的重载签名
+ * @description children-array 形态排在 config 之前——`FigureConfig` 字段全可选，数组也结构上「可赋给」它，
+ *   顺序反了会让 `figure([...])` 误匹配 config 重载。
+ */
+type FigureFn = {
+    (): Figure;
+    (children: Array<Child>): Figure;
+    (config: FigureConfig): Figure;
+    (config: FigureConfig, children: Array<Child>): Figure;
+};
+/**
+ * 命令式 builder 入口
+ * @description 四种调用：`figure()` 空图；`figure(children)` 省略 config 直接传子节点；`figure(config)` 起
+ *   fluent；`figure(config, children)` hyperscript。都返回同一 `Figure`、`.ir` 一致、可混用。
+ */
+export declare const figure: FigureFn;
+export {};
+//# sourceMappingURL=figure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure.d.ts","sourceRoot":"","sources":["../../../src/builder/figure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAgB,MAAM,WAAW,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;GAIG;AACH,KAAK,QAAQ,GAAG;IACd,IAAI,MAAM,CAAC;IACX,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;IACjC,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;IAC/B,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;CACxD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,QAMpB,CAAC"}

package/dist/es/builder/figure.js

@@ -0,0 +1,13 @@
+import { createFigure } from "../figure.js";
+//#region src/builder/figure.ts
+/**
+* 命令式 builder 入口
+* @description 四种调用：`figure()` 空图；`figure(children)` 省略 config 直接传子节点；`figure(config)` 起
+*   fluent；`figure(config, children)` hyperscript。都返回同一 `Figure`、`.ir` 一致、可混用。
+*/
+var figure = (configOrChildren, children) => {
+	if (Array.isArray(configOrChildren)) return createFigure({}, configOrChildren);
+	return createFigure(configOrChildren ?? {}, children ?? []);
+};
+//#endregion
+export { figure };

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

@@ -0,0 +1,6 @@
+import { Figure } from '../figure';
+/** Figure 品牌标记（Symbol.for 跨包/重复 import 仍同一）；标准 mountSvg/renderToSvgString 用它区分 Figure 与 IR/Scene */
+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

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

@@ -0,0 +1 @@
+{"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/builder/isFigure.js

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

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

@@ -0,0 +1,9 @@
+import { Child, NodeConfig } from './types';
+/**
+ * 构造一个 node IR 子节点
+ * @description `node(config)` 匿名；`node(id, config)` 具名（首参为字符串即 id）。单签名联合参数同时接受两种
+ *   形态。纯构造 IRNode（`{ type:'node', id?, ...config }`）；字段不自列、必填项（如 position）由 core schema
+ *   在 compile 期校验，故构造边界用一处断言收口（builder 故意宽松、缺字段不在此拦、交 compileToScene 报错）。
+ */
+export declare const node: (arg1?: string | NodeConfig, arg2?: NodeConfig) => Child;
+//# sourceMappingURL=node.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/builder/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,GAAG,UAAU,EAAE,OAAO,UAAU,KAAG,KAKpE,CAAC"}

package/dist/es/builder/node.js

@@ -0,0 +1,20 @@
+//#region src/builder/node.ts
+/**
+* 构造一个 node IR 子节点
+* @description `node(config)` 匿名；`node(id, config)` 具名（首参为字符串即 id）。单签名联合参数同时接受两种
+*   形态。纯构造 IRNode（`{ type:'node', id?, ...config }`）；字段不自列、必填项（如 position）由 core schema
+*   在 compile 期校验，故构造边界用一处断言收口（builder 故意宽松、缺字段不在此拦、交 compileToScene 报错）。
+*/
+var node = (arg1, arg2) => {
+	const named = typeof arg1 === "string";
+	const config = named ? arg2 : arg1;
+	return {
+		...named ? {
+			type: "node",
+			id: arg1
+		} : { type: "node" },
+		...config
+	};
+};
+//#endregion
+export { node };

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

@@ -0,0 +1,23 @@
+import { coordinate } from './coordinate';
+import { draw } from './draw';
+import { node } from './node';
+import { Child, ScopeConfig } from './types';
+/**
+ * scope 的 fluent 收集器
+ * @description `scope(config, build)` 把它交给回调；`.node/.draw/.coordinate/.scope` 把子节点推进内部数组、
+ *   链式返回 this。与 hyperscript 数组形态产同一份 children。
+ */
+export type ScopeBuilder = {
+    node: (...args: Parameters<typeof node>) => ScopeBuilder;
+    draw: (...args: Parameters<typeof draw>) => ScopeBuilder;
+    coordinate: (...args: Parameters<typeof coordinate>) => ScopeBuilder;
+    scope: (config: ScopeConfig, build: (s: ScopeBuilder) => void) => ScopeBuilder;
+};
+/**
+ * 构造一个 scope IR 子节点（分组容器 + 样式默认 + transforms）
+ * @description `config` 与 core `IRScope` / React `<Scope>` 顶层逐字一致——只透传 `transforms`（IRTransform[]，
+ *   合并顺序 = 数组顺序，首元素最内层）+ 样式默认，**不自造 xshift/yshift 糖**。children 两形态：数组
+ *   （hyperscript）或回调（fluent，经 ScopeBuilder 收集），单签名联合参数同时接受。
+ */
+export declare const scope: (config: ScopeConfig, arg: Array<Child> | ((s: ScopeBuilder) => void)) => Child;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/builder/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,YAAY,CAAC;IACzD,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,KAAK,YAAY,CAAC;IACzD,UAAU,EAAE,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,KAAK,YAAY,CAAC;IACrE,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,KAAK,YAAY,CAAC;CAChF,CAAC;AAwBF;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,WAAW,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC,KAAG,KAS5F,CAAC"}

package/dist/es/builder/scope.js

@@ -0,0 +1,45 @@
+import { coordinate } from "./coordinate.js";
+import { draw } from "./draw.js";
+import { node } from "./node.js";
+//#region src/builder/scope.ts
+var createScopeBuilder = (sink) => {
+	const self = {
+		node(...args) {
+			sink.push(node(...args));
+			return self;
+		},
+		draw(...args) {
+			sink.push(draw(...args));
+			return self;
+		},
+		coordinate(...args) {
+			sink.push(coordinate(...args));
+			return self;
+		},
+		scope(config, build) {
+			sink.push(scope(config, build));
+			return self;
+		}
+	};
+	return self;
+};
+/**
+* 构造一个 scope IR 子节点（分组容器 + 样式默认 + transforms）
+* @description `config` 与 core `IRScope` / React `<Scope>` 顶层逐字一致——只透传 `transforms`（IRTransform[]，
+*   合并顺序 = 数组顺序，首元素最内层）+ 样式默认，**不自造 xshift/yshift 糖**。children 两形态：数组
+*   （hyperscript）或回调（fluent，经 ScopeBuilder 收集），单签名联合参数同时接受。
+*/
+var scope = (config, arg) => {
+	let children;
+	if (typeof arg === "function") {
+		children = [];
+		arg(createScopeBuilder(children));
+	} else children = arg;
+	return {
+		type: "scope",
+		...config,
+		children
+	};
+};
+//#endregion
+export { scope };

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

@@ -0,0 +1,26 @@
+import { CompileOptions, 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 */
+export type NodeConfig = Omit<IRNode, 'type' | 'id'>;
+/** draw 的 config：从 IRPath 派生，剔除 type 与由 way 生成的 children（steps） */
+export type DrawConfig = Omit<IRPath, 'type' | 'children'>;
+/** coordinate 的 config：从 IRCoordinate 派生，剔除 type 与 positional 的 id（剩 position 必填） */
+export type CoordinateConfig = Omit<IRCoordinate, 'type' | 'id'>;
+/** scope 的 config：从 IRScope 派生，剔除 type 与单列的 children（含 transforms 等全部样式默认） */
+export type ScopeConfig = Omit<IRScope, 'type' | 'children'>;
+/** draw 的 way：直接复用 core 的 way DSL 全集（id 串 / 坐标 / Cycle / 折角 / 相对 / 曲线 / 弧 …） */
+export type Way = WayDSL;
+/**
+ * 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。
+ */
+export type FigureConfig = {
+    width?: number;
+    height?: number;
+    viewBox?: IRViewBox;
+    idPrefix?: string;
+} & CompileOptions;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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"}

package/dist/es/figure.d.ts

@@ -0,0 +1,26 @@
+import { IR } from '@retikz/core';
+import { RenderOptions } from '@retikz/render/canvas';
+import { FIGURE_BRAND } from './builder/isFigure';
+import { node } from './builder/node';
+import { ScopeBuilder } from './builder/scope';
+import { Child, CoordinateConfig, DrawConfig, FigureConfig, ScopeConfig, Way } from './builder/types';
+import { MountOptions, RenderToStringOptions, VanillaView } from './types';
+/**
+ * 命令式 builder 的装配产物 —— 唯一返回类型
+ * @description hyperscript（`figure(config, children)`）与 fluent（`figure(config).node(...)`）都产它、可混用、`.ir` 一致。
+ *   `.mount`/`.toSvgString`/`.toCanvas` 把 `this.ir`（IR，非 Figure）交底层 renderer；fluent 方法往内部 children 追加、链式返回 this。
+ */
+export type Figure = {
+    readonly [FIGURE_BRAND]: true;
+    readonly ir: IR;
+    mount: (container: Element, options?: MountOptions) => VanillaView;
+    toSvgString: (options?: RenderToStringOptions) => string;
+    toCanvas: (canvas: HTMLCanvasElement, options?: RenderOptions) => void;
+    node: (...args: Parameters<typeof node>) => Figure;
+    draw: (way: Way, config?: DrawConfig) => Figure;
+    coordinate: (id: string, config: CoordinateConfig) => Figure;
+    scope: (config: ScopeConfig, build: (s: ScopeBuilder) => void) => Figure;
+};
+/** figure() 的内部入口：装配 Figure（持 config + children，方法闭包其上） */
+export declare const createFigure: (config: FigureConfig, children: Array<Child>) => Figure;
+//# sourceMappingURL=figure.d.ts.map

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

@@ -0,0 +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;AAI3G,OAAO,KAAK,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEhF;;;;GAIG;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,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,KAAK,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,KAAK,MAAM,CAAC;CAC1E,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,YAAY,GAAI,QAAQ,YAAY,EAAE,UAAU,KAAK,CAAC,KAAK,CAAC,KAAG,MAoD3E,CAAC"}

package/dist/es/figure.js

@@ -0,0 +1,66 @@
+import { FIGURE_BRAND } from "./builder/isFigure.js";
+import { toScene } from "./toScene.js";
+import { renderToSvgString } from "./renderToSvgString.js";
+import { mountSvg } from "./mountSvg.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 { renderToCanvas } from "@retikz/render/canvas";
+//#region src/figure.ts
+/** figure() 的内部入口：装配 Figure（持 config + children，方法闭包其上） */
+var createFigure = (config, children) => {
+	/** call-site options 覆盖 figure 存的 config（call-site wins）：viewBox 已并进 ir，其余（width/height/idPrefix + 全套 CompileOptions）全透传 */
+	const renderOptions = (callSite) => {
+		const merged = {
+			...config,
+			...callSite
+		};
+		delete merged.viewBox;
+		return merged;
+	};
+	const fig = {
+		[FIGURE_BRAND]: true,
+		get ir() {
+			return {
+				version: 1,
+				type: "scene",
+				children,
+				...config.viewBox ? { viewBox: config.viewBox } : {}
+			};
+		},
+		mount(container, options) {
+			return mountSvg(container, fig.ir, renderOptions(options));
+		},
+		toSvgString(options) {
+			return renderToSvgString(fig.ir, renderOptions(options));
+		},
+		toCanvas(canvas, options) {
+			const compile = { ...config };
+			delete compile.viewBox;
+			delete compile.idPrefix;
+			delete compile.width;
+			delete compile.height;
+			renderToCanvas(canvas, toScene(fig.ir, compile), options ?? {});
+		},
+		node(...args) {
+			children.push(node(...args));
+			return fig;
+		},
+		draw(way, drawConfig) {
+			children.push(draw(way, drawConfig));
+			return fig;
+		},
+		coordinate(id, coordConfig) {
+			children.push(coordinate(id, coordConfig));
+			return fig;
+		},
+		scope(scopeConfig, build) {
+			children.push(scope(scopeConfig, build));
+			return fig;
+		}
+	};
+	return fig;
+};
+//#endregion
+export { createFigure };

package/dist/es/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @retikz/vanilla 公开 API —— framework-free runtime / SSR 入口 + 命令式 builder
+ *
+ * 无框架 / SSR 的 runtime 门面：组合 `@retikz/render/svg`（descriptor / 字符串）与 `@retikz/render/canvas`（后置），
+ * 不自维护第二套 Scene→输出内核。`renderToSvgString` 走 SSR（零 DOM）；`mountSvg` 走浏览器 DOM 挂载。
+ * `figure`/`node`/`draw`/`coordinate`/`scope` 是命令式 builder：用具名图元 + 自定义 shape 构图、产同一份 IR。
+ * 模块顶层不触碰任何 DOM 全局——`import` 在纯 Node 下安全。
+ */
+export { renderToSvgString } from './renderToSvgString';
+export { mountSvg } from './mountSvg';
+export { figure } from './builder/figure';
+export { node } from './builder/node';
+export { draw } from './builder/draw';
+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 { RenderInput, CommonOptions, MountOptions, RenderToStringOptions, VanillaView } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,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,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/es/index.js

@@ -0,0 +1,8 @@
+import { renderToSvgString } from "./renderToSvgString.js";
+import { mountSvg } from "./mountSvg.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 } from "./builder/figure.js";
+export { coordinate, draw, figure, mountSvg, node, renderToSvgString, scope };

package/dist/es/mountSvg.d.ts

@@ -0,0 +1,10 @@
+import { MountOptions, RenderInput, VanillaView } from './types';
+/**
+ * 把 IR / Scene / Figure 挂成真实 SVG DOM（无框架浏览器 runtime）
+ * @description 收 `Figure` 时 delegate 给 `figure.mount`（Figure 自持 config，call-site options 覆盖）。收
+ *   IR/Scene 时：`toScene`（收 ir 时 compile）→ `buildSvgDocument`（`@retikz/render/svg`）→ 物化进**稳定复用**的 root
+ *   `<svg>`；`width`/`height` 若给则写回根（`@retikz/render/svg` 只产 viewBox，显示尺寸是 adapter 本分）。`update`
+ *   原地重渲染、root 元素 identity 跨 update 不变、不失效。DOM 仅在调用时惰性触碰，`import` 本模块不碰 DOM——守 SSR 导入安全。
+ */
+export declare const mountSvg: (container: Element, input: RenderInput, options?: MountOptions) => VanillaView;
+//# sourceMappingURL=mountSvg.d.ts.map

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

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

package/dist/es/mountSvg.js

@@ -0,0 +1,48 @@
+import { isFigure } from "./builder/isFigure.js";
+import { toScene } from "./toScene.js";
+import { applyAttrs, svgNodeToDom } from "./svgNodeToDom.js";
+import { buildSvgDocument } from "@retikz/render/svg";
+//#region src/mountSvg.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 覆盖）。收
+*   IR/Scene 时：`toScene`（收 ir 时 compile）→ `buildSvgDocument`（`@retikz/render/svg`）→ 物化进**稳定复用**的 root
+*   `<svg>`；`width`/`height` 若给则写回根（`@retikz/render/svg` 只产 viewBox，显示尺寸是 adapter 本分）。`update`
+*   原地重渲染、root 元素 identity 跨 update 不变、不失效。DOM 仅在调用时惰性触碰，`import` 本模块不碰 DOM——守 SSR 导入安全。
+*/
+var mountSvg = (container, input, options = {}) => {
+	if (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 root = document.createElementNS(SVG_NS, "svg");
+	const renderInto = (next) => {
+		if (isFigure(next)) throw new Error("mountSvg: view.update does not accept a Figure; pass figure.ir instead.");
+		const doc = buildSvgDocument(toScene(next, options), { idPrefix });
+		while (root.firstChild) root.removeChild(root.firstChild);
+		for (const attr of [...root.attributes]) root.removeAttribute(attr.name);
+		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) : svgNodeToDom(child));
+	};
+	renderInto(input);
+	container.appendChild(root);
+	let disposed = false;
+	return {
+		root,
+		update(next) {
+			if (disposed) throw new Error("mountSvg: view already disposed.");
+			renderInto(next);
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			root.remove();
+		}
+	};
+};
+//#endregion
+export { mountSvg };

package/dist/es/renderToSvgString.d.ts

@@ -0,0 +1,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。
+ */
+export declare const renderToSvgString: (input: RenderInput, options?: RenderToStringOptions) => string;
+//# sourceMappingURL=renderToSvgString.d.ts.map

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

@@ -0,0 +1 @@
+{"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,MAI3F,CAAC"}

package/dist/es/renderToSvgString.js

@@ -0,0 +1,23 @@
+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 }), options.width, options.height);
+};
+//#endregion
+export { renderToSvgString$1 as renderToSvgString };

package/dist/es/svgNodeToDom.d.ts

@@ -0,0 +1,14 @@
+import { SvgNode } from '@retikz/render/svg';
+/**
+ * 把 `SvgNode` 的 attrs / style 写到一个（可复用的）SVG 元素上
+ * @description attrs 键是 SVG 真名（呈现属性 kebab / 结构属性规范拼写如 `viewBox`），SVG 命名空间下 `setAttribute`
+ *   直用、零名字转换；含 `var()` 的值在 `node.style`（kebab）走 `setProperty`。mountSvg 的 root 复用也用它。
+ */
+export declare const applyAttrs: (el: SVGElement, node: SvgNode) => void;
+/**
+ * `SvgNode` descriptor → 真实 SVG DOM（与 react `svgToReact` 同层物化）
+ * @description Scene→SvgNode 仍单一留 `@retikz/render/svg`；本函数只把描述树物化成 DOM。仅在**调用时**触 DOM
+ *   （`document.createElementNS`），模块顶层不碰任何 DOM 全局——守 SSR 导入安全。
+ */
+export declare const svgNodeToDom: (node: SvgNode) => SVGElement;
+//# sourceMappingURL=svgNodeToDom.d.ts.map

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

@@ -0,0 +1 @@
+{"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/svgNodeToDom.js

@@ -0,0 +1,26 @@
+//#region src/svgNodeToDom.ts
+var SVG_NS = "http://www.w3.org/2000/svg";
+/**
+* 把 `SvgNode` 的 attrs / style 写到一个（可复用的）SVG 元素上
+* @description attrs 键是 SVG 真名（呈现属性 kebab / 结构属性规范拼写如 `viewBox`），SVG 命名空间下 `setAttribute`
+*   直用、零名字转换；含 `var()` 的值在 `node.style`（kebab）走 `setProperty`。mountSvg 的 root 复用也用它。
+*/
+var applyAttrs = (el, node) => {
+	for (const [key, value] of Object.entries(node.attrs)) if (value !== void 0) el.setAttribute(key, String(value));
+	if (node.style) {
+		for (const [key, value] of Object.entries(node.style)) if (value !== void 0 && value !== null) el.style.setProperty(key, String(value));
+	}
+};
+/**
+* `SvgNode` descriptor → 真实 SVG DOM（与 react `svgToReact` 同层物化）
+* @description Scene→SvgNode 仍单一留 `@retikz/render/svg`；本函数只把描述树物化成 DOM。仅在**调用时**触 DOM
+*   （`document.createElementNS`），模块顶层不碰任何 DOM 全局——守 SSR 导入安全。
+*/
+var svgNodeToDom = (node) => {
+	const el = document.createElementNS(SVG_NS, node.tag);
+	applyAttrs(el, node);
+	for (const child of node.children ?? []) el.appendChild(typeof child === "string" ? document.createTextNode(child) : svgNodeToDom(child));
+	return el;
+};
+//#endregion
+export { applyAttrs, svgNodeToDom };

package/dist/es/toScene.d.ts

@@ -0,0 +1,10 @@
+import { IR, Scene } from '@retikz/core';
+import { CommonOptions } from './types';
+/**
+ * 入参归一成 `Scene`
+ * @description 已是 `Scene`（有 `primitives`）直接用；否则当 `IR` 经 `compileToScene` 编译。剥掉 render-only 键
+ *   （`idPrefix`/`width`/`height`），其余即 core `CompileOptions` 原样透传（`measureText` 缺省时 core 回退
+ *   `fallbackMeasurer`，Node 下确定可跑）。注：调用方须先把 `Figure` 解成 `ir`，此处只认 `IR | Scene`。
+ */
+export declare const toScene: (input: Scene | IR, options: CommonOptions) => Scene;
+//# sourceMappingURL=toScene.d.ts.map