@retikz/core 0.2.0-alpha.7 → 0.2.0-alpha.9

package/dist/lib/compile/marker-prim.cjs

@@ -0,0 +1,63 @@
+//#region src/compile/marker-prim.ts
+/**
+* marker 窄子集运行时栅栏（arrow + pattern 共用）
+* @description `MarkerPrimitive` 的窄子集（type 限 path/ellipse/rect/group、fill 限 string | contextStroke、
+*   无外部 resourceRef / text / 函数）TS 只能编译期守门；第三方 / LLM 写出的 emit 会在运行时绕过类型，
+*   故这里做运行时校验。arrow（marker 几何）与 pattern（motif 几何）emit 产物同契约，复用本组校验。
+*   `owner` 是错误消息里的归属串（如 `Arrow 'normal'` / `Pattern 'lines'`），便于第三方 / LLM 自修。
+*/
+/** marker 子集允许的 primitive type（窄子集运行时栅栏） */
+var MARKER_PRIM_TYPES = new Set([
+	"path",
+	"ellipse",
+	"rect",
+	"group"
+]);
+/** 深度查 emit 产物里有没有函数（守 Scene 100% JSON 可序列化） */
+var assertNoFunction = (owner, value) => {
+	if (typeof value === "function") throw new Error(`${owner} emit produced a marker containing a function; markers must be plain JSON data.`);
+	if (Array.isArray(value)) for (const v of value) assertNoFunction(owner, v);
+	else if (value !== null && typeof value === "object") for (const v of Object.values(value)) assertNoFunction(owner, v);
+};
+/**
+* 深度查 emit 产物里有没有非 finite 数（NaN / Infinity）
+* @description 第三方 / LLM 的 emit 算错坐标（除零 / 溢出）会产 NaN / Infinity；`JSON.stringify` 把它们变成
+*   `null`，破坏 Scene round-trip 等价。故在此抛含 owner 的清晰错，不放任非 finite 流入 Scene（与 arrow
+*   geometry / path generator 的 finite 守卫同源）。
+*/
+var assertFiniteNumbers = (owner, value) => {
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw new Error(`${owner} emit produced a marker with a non-finite number (${String(value)}); marker coordinates must be finite.`);
+		return;
+	}
+	if (Array.isArray(value)) for (const v of value) assertFiniteNumbers(owner, v);
+	else if (value !== null && typeof value === "object") for (const v of Object.values(value)) assertFiniteNumbers(owner, v);
+};
+/**
+* 递归校验单个 emit 产物符合 `MarkerPrimitive` 窄子集（运行时栅栏，TS 只能编译期守门）
+* @description type 限 path/ellipse/rect/group（拒 text 等）；fill 限 string | contextStroke（拒 resourceRef
+*   等外部资源引用）；group 递归 children。守"marker 内无文本布局 / 无外部资源 / 无递归 marker"契约。
+*/
+var assertValidMarkerPrim = (owner, prim) => {
+	if (prim === null || typeof prim !== "object") throw new Error(`${owner} emit produced a non-object marker primitive.`);
+	const type = prim.type;
+	if (typeof type !== "string" || !MARKER_PRIM_TYPES.has(type)) throw new Error(`${owner} emit produced an invalid marker primitive type '${String(type)}'; allowed: group, path, ellipse, rect.`);
+	const fill = prim.fill;
+	if (fill !== void 0 && typeof fill !== "string" && !(typeof fill === "object" && fill !== null && fill.kind === "contextStroke")) throw new Error(`${owner} marker fill must be a color string or { kind: 'contextStroke' }; external paint references are not allowed inside markers.`);
+	if (type === "group") {
+		const children = prim.children;
+		if (!Array.isArray(children)) throw new Error(`${owner} marker group must have a children array.`);
+		for (const child of children) assertValidMarkerPrim(owner, child);
+	}
+};
+/**
+* 跑完整窄子集 + JSON-safe 校验（产物逐个过 `assertValidMarkerPrim` + 深度无函数检查）
+* @description arrow / pattern 调 emit 收齐 `MarkerPrimitive[]` 后调用；任一原语违窄子集即抛含 owner 的清晰错。
+*/
+var validateMarkerPrimitives = (owner, marker) => {
+	for (const prim of marker) assertValidMarkerPrim(owner, prim);
+	assertNoFunction(owner, marker);
+	assertFiniteNumbers(owner, marker);
+};
+//#endregion
+exports.validateMarkerPrimitives = validateMarkerPrimitives;

package/dist/lib/compile/marker-prim.d.ts

@@ -0,0 +1,22 @@
+import { MarkerPrimitive } from '../primitive/marker';
+/** 深度查 emit 产物里有没有函数（守 Scene 100% JSON 可序列化） */
+export declare const assertNoFunction: (owner: string, value: unknown) => void;
+/**
+ * 深度查 emit 产物里有没有非 finite 数（NaN / Infinity）
+ * @description 第三方 / LLM 的 emit 算错坐标（除零 / 溢出）会产 NaN / Infinity；`JSON.stringify` 把它们变成
+ *   `null`，破坏 Scene round-trip 等价。故在此抛含 owner 的清晰错，不放任非 finite 流入 Scene（与 arrow
+ *   geometry / path generator 的 finite 守卫同源）。
+ */
+export declare const assertFiniteNumbers: (owner: string, value: unknown) => void;
+/**
+ * 递归校验单个 emit 产物符合 `MarkerPrimitive` 窄子集（运行时栅栏，TS 只能编译期守门）
+ * @description type 限 path/ellipse/rect/group（拒 text 等）；fill 限 string | contextStroke（拒 resourceRef
+ *   等外部资源引用）；group 递归 children。守"marker 内无文本布局 / 无外部资源 / 无递归 marker"契约。
+ */
+export declare const assertValidMarkerPrim: (owner: string, prim: unknown) => void;
+/**
+ * 跑完整窄子集 + JSON-safe 校验（产物逐个过 `assertValidMarkerPrim` + 深度无函数检查）
+ * @description arrow / pattern 调 emit 收齐 `MarkerPrimitive[]` 后调用；任一原语违窄子集即抛含 owner 的清晰错。
+ */
+export declare const validateMarkerPrimitives: (owner: string, marker: ReadonlyArray<MarkerPrimitive>) => void;
+//# sourceMappingURL=marker-prim.d.ts.map

package/dist/lib/compile/marker-prim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marker-prim.d.ts","sourceRoot":"","sources":["../../../src/compile/marker-prim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAa3D,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,OAAO,OAAO,KAAG,IAWhE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,EAAE,OAAO,OAAO,KAAG,IAcnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,EAAE,MAAM,OAAO,KAAG,IA2BpE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,MAAM,EACb,QAAQ,aAAa,CAAC,eAAe,CAAC,KACrC,IAIF,CAAC"}

package/dist/lib/compile/node.cjs

@@ -205,7 +205,7 @@ var angleBoundaryOf = (layout, angleDeg) => {
 *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
 *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
 */
-var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], labelDefault, shapes = require_index.BUILTIN_SHAPES) => {
+var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], labelDefault, shapes = require_index.BUILTIN_SHAPES, resolveBetweenGlobal) => {
 	const shapeName = node.shape ?? "rectangle";
 	const shapeDef = Object.prototype.hasOwnProperty.call(shapes, shapeName) ? shapes[shapeName] : void 0;
 	if (!shapeDef) throw new Error(`Unknown shape '${shapeName}'; registered shapes: ${Object.keys(shapes).sort().join(", ")}`);
@@ -263,8 +263,8 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], l
 	const innerHalfH = Math.max(textHeight / 2 + ySep, ySep, minH / 2);
 	const { halfWidth: boundsHalfW, halfHeight: boundsHalfH } = shapeDef.circumscribe(innerHalfW, innerHalfH);
 	const rotateDeg = node.rotate ?? 0;
-	const center = require_position.resolvePosition(node.position, nameStack, nodeDistance, scopeChain);
-	if (!center) throw new Error(`Cannot resolve position for node ${node.id ?? "(unnamed)"}; polar.origin or at.of may reference an undefined node`);
+	const center = require_position.resolvePosition(node.position, nameStack, nodeDistance, scopeChain, resolveBetweenGlobal);
+	if (!center) throw new Error(`Cannot resolve position for node ${node.id ?? "(unnamed)"}; polar.origin / at.of / between endpoint may reference an undefined node`);
 	const labels = (node.label === void 0 ? void 0 : Array.isArray(node.label) ? node.label : [node.label])?.map((lab) => {
 		const labFont = lab.font;
 		const labFontSize = (labFont?.size ?? labelDefault?.font?.size ?? baseFontSize) * fontScale;

package/dist/lib/compile/node.d.ts

@@ -5,6 +5,7 @@ import { PaintResolver } from './paint';
 import { ScenePrimitive, TextLine, Transform } from '../primitive';
 import { ShapeDefinition } from '../shapes';
 import { NameStack } from './name-stack';
+import { ResolveBetweenGlobal } from './position';
 import { TextMeasurer } from './text-metrics';
 export type NodeLayout = {
     /** 节点 id（其他位置可引用） */
@@ -116,7 +117,7 @@ export declare const angleBoundaryOf: (layout: NodeLayout, angleDeg: number) =>
  *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
  *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
  */
-export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault, shapes?: Record<string, ShapeDefinition>) => NodeLayout;
+export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault, shapes?: Record<string, ShapeDefinition>, resolveBetweenGlobal?: ResolveBetweenGlobal) => NodeLayout;
 /**
  * NodeLayout → Scene primitives
  * @description shape 主体走 `shapeDef.emit`（收轴对齐 rect、可出多 primitive）；text 始终走 TextPrim；

package/dist/lib/compile/node.d.ts.map

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

package/dist/lib/compile/paint.cjs

@@ -1,10 +1,65 @@
+const require_marker_prim = require("./marker-prim.cjs");
 //#region src/compile/paint.ts
+/** 内置 / 注入都缺 defaultSize 时的 tile 周期兜底（user units） */
+var FALLBACK_PATTERN_SIZE = 8;
+/** motif 缺省主色：CSS `currentColor`（继承 svg color，主题反应天然） */
+var DEFAULT_MOTIF_COLOR = "currentColor";
+/**
+* 查有效 pattern 表取 def；未注册名编译期 throw（消息含字母序可用名列表）
+* @description 仿 arrow / shape 的未注册 throw 风格——错误带可用名便于第三方 / LLM 自修。
+*/
+var lookupPatternDef = (shape, effective) => {
+	if (Object.prototype.hasOwnProperty.call(effective, shape)) return effective[shape];
+	const available = Object.keys(effective).sort().join(", ");
+	throw new Error(`Unknown pattern shape '${shape}'; available: ${available}`);
+};
+/**
+* 对一个 pattern spec 查表 + 调 `def.emit` 产已解析 tile
+* @description 构 `PatternEmitContext`（size = spec.size ?? def.defaultSize ?? 8；color = spec.color ??
+*   currentColor；background 透传；lineWidth 仅 spec 显式给值时存在——让 dots 缺省半径 size/5、lines/grid
+*   缺省描边 1）→ 调 emit 收 `MarkerPrimitive[]` → 跑共享窄子集 + JSON-safe 校验 → 组装 `ResolvedPatternTile`。
+*   emit 抛错 / 产非法原语都包成含 shape 名的清晰错（带 cause）。
+*/
+var resolvePatternTile = (spec, effectivePatterns, round) => {
+	const def = lookupPatternDef(spec.shape, effectivePatterns);
+	const rawSize = spec.size ?? def.defaultSize ?? FALLBACK_PATTERN_SIZE;
+	if (!Number.isFinite(rawSize) || rawSize <= 0) throw new Error(`Pattern '${spec.shape}' has an invalid size (${String(rawSize)}); it must be a finite number greater than 0.`);
+	if (spec.lineWidth !== void 0 && (!Number.isFinite(spec.lineWidth) || spec.lineWidth <= 0)) throw new Error(`Pattern '${spec.shape}' has an invalid lineWidth (${String(spec.lineWidth)}); it must be a finite number greater than 0.`);
+	if (spec.rotation !== void 0 && !Number.isFinite(spec.rotation)) throw new Error(`Pattern '${spec.shape}' has a non-finite rotation (${String(spec.rotation)}); it must be a finite number.`);
+	const size = round(rawSize);
+	const ctx = {
+		size,
+		color: spec.color ?? DEFAULT_MOTIF_COLOR,
+		round
+	};
+	if (spec.background !== void 0) ctx.background = spec.background;
+	if (spec.lineWidth !== void 0) ctx.lineWidth = spec.lineWidth;
+	if (typeof def.emit !== "function") throw new Error(`Pattern '${spec.shape}' is missing an emit function (PatternDefinition.emit is required).`);
+	let motif;
+	try {
+		motif = [...def.emit(ctx)];
+	} catch (e) {
+		throw new Error(`Pattern '${spec.shape}' emit failed: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+	}
+	require_marker_prim.validateMarkerPrimitives(`Pattern '${spec.shape}'`, motif);
+	const tile = {
+		size,
+		motif
+	};
+	if (spec.background !== void 0) tile.background = spec.background;
+	if (spec.rotation !== void 0) tile.rotation = spec.rotation;
+	return tile;
+};
 /**
 * 建一个 paint 登记表
 * @description resolve 对相同 PaintSpec（结构化 JSON 深比较）合并为一个资源、派稳定 id（`paint-1` / `paint-2`…，首见序）。
 *   同一份 IR 编译两次 → 同 id（快照稳定、SSR / CSR 一致）。SVG id 跨实例唯一性由 react adapter 加 useId 前缀解决。
+*   pattern 资源额外查 `effectivePatterns` + 调 `PatternDefinition.emit` 产 tile 写进 `SceneResource.tile`
+*   （未注册名 throw、含可用名）；gradient / image 资源只 spec。
+* @param effectivePatterns 有效 pattern 表（内置 + 注入），供 pattern 资源查表 + emit
+* @param round 精度取整（与 compile / render 同一 round，保 tile 几何一致）
 */
-var createPaintRegistry = () => {
+var createPaintRegistry = (effectivePatterns, round) => {
 	const idByKey = /* @__PURE__ */ new Map();
 	const list = [];
 	let counter = 0;
@@ -17,11 +72,13 @@ var createPaintRegistry = () => {
 			counter += 1;
 			id = `paint-${counter}`;
 			idByKey.set(key, id);
-			list.push({
+			const resource = {
 				kind: "paint",
 				id,
 				spec: fill
-			});
+			};
+			if (fill.type === "pattern") resource.tile = resolvePatternTile(fill, effectivePatterns, round);
+			list.push(resource);
 		}
 		return {
 			kind: "resourceRef",

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

@@ -1,4 +1,5 @@
 import { IRPaintSpec } from '../ir';
+import { PatternDefinition } from '../patterns';
 import { PaintValue, SceneResource } from '../primitive';
 /** fill 解析器：纯色 string 原样返回；PaintSpec 去重 + 派稳定 id → `{ kind:'resourceRef', id }`；undefined 透传 */
 export type PaintResolver = (fill: string | IRPaintSpec | undefined) => PaintValue | undefined;
@@ -11,6 +12,10 @@ export type PaintRegistry = {
  * 建一个 paint 登记表
  * @description resolve 对相同 PaintSpec（结构化 JSON 深比较）合并为一个资源、派稳定 id（`paint-1` / `paint-2`…，首见序）。
  *   同一份 IR 编译两次 → 同 id（快照稳定、SSR / CSR 一致）。SVG id 跨实例唯一性由 react adapter 加 useId 前缀解决。
+ *   pattern 资源额外查 `effectivePatterns` + 调 `PatternDefinition.emit` 产 tile 写进 `SceneResource.tile`
+ *   （未注册名 throw、含可用名）；gradient / image 资源只 spec。
+ * @param effectivePatterns 有效 pattern 表（内置 + 注入），供 pattern 资源查表 + emit
+ * @param round 精度取整（与 compile / render 同一 round，保 tile 几何一致）
  */
-export declare const createPaintRegistry: () => PaintRegistry;
+export declare const createPaintRegistry: (effectivePatterns: Record<string, PatternDefinition>, round: (n: number) => number) => PaintRegistry;
 //# sourceMappingURL=paint.d.ts.map

package/dist/lib/compile/paint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/compile/paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE9D,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,KAAK,UAAU,GAAG,SAAS,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAO,aAkBtC,CAAC"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/compile/paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAmB,UAAU,EAAuB,aAAa,EAAE,MAAM,cAAc,CAAC;AAGpG,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,KAAK,UAAU,GAAG,SAAS,CAAC;AAE/F,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;CACvC,CAAC;AA+EF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAC9B,mBAAmB,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,EACpD,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,aAuBF,CAAC"}

package/dist/lib/compile/path/anchor.cjs

@@ -1,3 +1,4 @@
+const require__edge = require("../../geometry/_edge.cjs");
 const require_scope = require("../scope.cjs");
 const require_position = require("../position.cjs");
 const require_node = require("../node.cjs");
@@ -5,6 +6,8 @@ const require_anchor_cache = require("../anchor-cache.cjs");
 //#region src/compile/path/anchor.ts
 /** target 是否对象形态 NodeTarget（`{ id, anchor?, offset? }`）；与 Position(array) / Polar / Offset(of) / Relative 区分（独有 `id`） */
 var isNodeTarget = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t;
+/** target 是否 between 比例点（`{ between, t }`）；独有 `between` 字段 */
+var isBetween = (t) => typeof t === "object" && !Array.isArray(t) && "between" in t;
 /** 解析 NodeTarget 的 anchor（非 undefined）到世界坐标：命名 / 角度走 resolveAnchor，`{ side, t }` 走 resolveEdgePoint */
 var resolveAnchorRef = (node, anchor) => {
 	if (typeof anchor === "number") return require_anchor_cache.resolveAnchor(node, String(anchor));
@@ -26,6 +29,14 @@ var refPointOfTarget = (target, nameStack, scopeChain = []) => {
 		if (!node) return null;
 		return addOffset(target.anchor === void 0 ? [node.rect.x, node.rect.y] : resolveAnchorRef(node, target.anchor), target.offset);
 	}
+	if (isBetween(target)) {
+		const a = refPointOfTarget(target.between[0], nameStack, scopeChain);
+		const b = refPointOfTarget(target.between[1], nameStack, scopeChain);
+		if (!a || !b) return null;
+		const mid = require__edge.lerpPoint(a, b, target.t);
+		if (!Number.isFinite(mid[0]) || !Number.isFinite(mid[1])) return null;
+		return mid;
+	}
 	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
 	const local = require_position.resolvePosition(target, nameStack, void 0, scopeChain);
 	if (!local) return null;
@@ -45,6 +56,7 @@ var clipForTarget = (target, toward, nameStack, scopeChain = []) => {
 		if (!node) return null;
 		return addOffset(target.anchor === void 0 ? require_node.boundaryPointOf(node, toward) : resolveAnchorRef(node, target.anchor), target.offset);
 	}
+	if (isBetween(target)) return refPointOfTarget(target, nameStack, scopeChain);
 	if (typeof target === "object" && !Array.isArray(target) && ("relative" in target || "relativeAccumulate" in target)) return null;
 	const local = require_position.resolvePosition(target, nameStack, void 0, scopeChain);
 	if (!local) return null;

package/dist/lib/compile/path/anchor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAqB/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAkBf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,IAAI,GAAG,IAAI,KACf,UACqD,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAkBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACzB,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAM7E,CAAC"}
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmC,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAyB/C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IA8Bf,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,GACnB,MAAM,UAAU,EAChB,MAAM,UAAU,EAChB,KAAK,IAAI,GAAG,IAAI,KACf,UACqD,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,QAAQ,EAChB,QAAQ,UAAU,EAClB,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAsBf,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,GAAG,IAAI,EAAE,GAAG,UAAU,GAAG,IAAI,KAAG,OACzB,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,WAAW,GAAI,GAAG,UAAU,EAAE,QAAQ,UAAU,EAAE,MAAM,MAAM,KAAG,UAM7E,CAAC"}

package/dist/lib/compile/path/index.cjs

@@ -1,4 +1,7 @@
 const require_rect = require("../../geometry/rect.cjs");
+const require_json = require("../../ir/json.cjs");
+const require_index = require("../../arrows/index.cjs");
+const require_scope = require("../scope.cjs");
 const require_arc = require("../../geometry/arc.cjs");
 const require_bend = require("../../geometry/bend.cjs");
 const require_segment = require("../../geometry/segment.cjs");
@@ -9,8 +12,56 @@ const require_relative = require("./relative.cjs");
 const require_shrink = require("./shrink.cjs");
 const require_split = require("./split.cjs");
 //#region src/compile/path/index.ts
-/** 目标若是对象 NodeTarget（`{ id, ... }`）返回其 id，否则 undefined——给 UNRESOLVED_NODE_REFERENCE 诊断用 */
-var nodeRefId = (t) => typeof t === "object" && !Array.isArray(t) && "id" in t ? t.id : void 0;
+/**
+* 目标里的一个代表性节点 id——给 UNRESOLVED_NODE_REFERENCE 诊断用
+* @description 对象 NodeTarget（`{ id, ... }`）直接取 id；between 比例点递归挖端点里第一个节点引用
+*   （端点未解析时整 between 失败，需照样报 unresolved 而非静默）；其余形态返回 undefined。
+*/
+var nodeRefId = (t) => {
+	if (typeof t !== "object" || Array.isArray(t)) return void 0;
+	if ("id" in t) return t.id;
+	if ("between" in t) return nodeRefId(t.between[0]) ?? nodeRefId(t.between[1]);
+};
+/** 有限数 */
+var isFiniteNum = (n) => typeof n === "number" && Number.isFinite(n);
+/** 有限坐标点 `[number, number]` */
+var isFinitePoint = (pt) => Array.isArray(pt) && pt.length >= 2 && isFiniteNum(pt[0]) && isFiniteNum(pt[1]);
+/**
+* 校验 path generator 产出的单条命令合法（kind 已知 + 引用坐标 / 数值有限）
+* @description 第三方 / LLM 写的 generate 误产坏命令（NaN/Infinity 坐标、未知 kind、缺字段、字符串当命令）时
+*   抛含 generator 名的清晰错——守 Scene 100% finite / JSON 可序列化，不放任非 finite 静默入 Scene
+*   （JSON.stringify(NaN/Infinity)=null 会让 round-trip 失真）。
+*/
+var assertValidGeneratedCommand = (name, cmd) => {
+	const bad = (detail) => {
+		throw new Error(`path generator '${name}' produced a ${detail}.`);
+	};
+	if (cmd === null || typeof cmd !== "object") {
+		bad(`non-object command (expected an object with a 'kind')`);
+		return;
+	}
+	const c = cmd;
+	switch (c.kind) {
+		case "move":
+		case "line":
+			if (!isFinitePoint(c.to)) bad(`non-finite coordinate in a '${String(c.kind)}' command`);
+			break;
+		case "quad":
+			if (!isFinitePoint(c.control) || !isFinitePoint(c.to)) bad(`non-finite coordinate in a 'quad' command`);
+			break;
+		case "cubic":
+			if (!isFinitePoint(c.control1) || !isFinitePoint(c.control2) || !isFinitePoint(c.to)) bad(`non-finite coordinate in a 'cubic' command`);
+			break;
+		case "arc":
+			if (!isFinitePoint(c.center) || !isFiniteNum(c.radius) || !isFiniteNum(c.startAngle) || !isFiniteNum(c.endAngle)) bad(`non-finite value in an 'arc' command`);
+			break;
+		case "ellipseArc":
+			if (!isFinitePoint(c.center) || !isFiniteNum(c.radiusX) || !isFiniteNum(c.radiusY) || !isFiniteNum(c.startAngle) || !isFiniteNum(c.endAngle)) bad(`non-finite value in an 'ellipseArc' command`);
+			break;
+		case "close": break;
+		default: bad(`command with unknown kind '${String(c.kind)}'`);
+	}
+};
 /**
 * 语义 stroke 档位 → 数值（user units）
 * @description 对齐 TikZ 比例（thin=0.4pt→1=默认 strokeWidth）：ultraThin 0.25、veryThin 0.5、thin 1、semithick 1.5、thick 2、veryThick 3、ultraThick 4。显式 strokeWidth 覆盖 thickness。
@@ -25,6 +76,93 @@ var THICKNESS_TO_WIDTH = {
 	veryThick: 3,
 	ultraThick: 4
 };
+/** 一组点的 axis-aligned 包围盒中心 */
+var bboxCenter = (pts) => {
+	let minX = Infinity;
+	let minY = Infinity;
+	let maxX = -Infinity;
+	let maxY = -Infinity;
+	for (const [x, y] of pts) {
+		if (x < minX) minX = x;
+		if (y < minY) minY = y;
+		if (x > maxX) maxX = x;
+		if (y > maxY) maxY = y;
+	}
+	return [(minX + maxX) / 2, (minY + maxY) / 2];
+};
+/**
+* path 整体 rotate / scale → 绕包围盒中心的 GroupPrim transforms
+* @description rotate 写成 `{ kind:'rotate', degrees, cx, cy }`（cx/cy = bbox center），等价包一个绕同中心旋转的 Scope；
+*   scale number → `{ kind:'scale', x }`（等比，y 省略），`{x,y}` → `{ kind:'scale', x, y }`。
+*   缩放支点同为 bbox center：用 translate(center) ∘ scale ∘ translate(-center) 三段表达。两者都缺时返回空数组。
+*   数组顺序与 GroupPrim 渲染一致（array[0] 最外层、最后 apply）：先 rotate 段再 scale 段（rotate 在外）。
+*/
+var buildPathTransforms = (rotate, scale, center, round) => {
+	const out = [];
+	if (rotate !== void 0) out.push({
+		kind: "rotate",
+		degrees: rotate,
+		cx: round(center[0]),
+		cy: round(center[1])
+	});
+	if (scale !== void 0) {
+		const sx = typeof scale === "number" ? scale : scale.x;
+		const sy = typeof scale === "number" ? void 0 : scale.y;
+		const scaleT = {
+			kind: "scale",
+			x: sx
+		};
+		if (sy !== void 0) scaleT.y = sy;
+		out.push({
+			kind: "translate",
+			x: round(center[0]),
+			y: round(center[1])
+		}, scaleT, {
+			kind: "translate",
+			x: round(-center[0]),
+			y: round(-center[1])
+		});
+	}
+	return out;
+};
+/**
+* 把已物化的 arrow marker（局部 baseSize 坐标系，尖端 +x）按路径切线定向放到采样点
+* @description marker 局部系：viewBox `0 0 baseSize baseSize`，参考点 (refX, baseSize/2)，尖端朝 +x。
+*   GroupPrim transforms 数组语义 array[0] 最外层（最后 apply），故链 = translate(point) ∘ rotate(tangentDeg)
+*   ∘ scale(markerWidth/baseSize, markerHeight/baseSize) ∘ translate(-refX, -baseSize/2)：先把参考点移到原点、
+*   缩放到目标尺寸、绕切线角旋转、平移到采样点。marker 几何（`MarkerPrimitive[]`）是 ScenePrimitive 的结构子集，直接作 children。
+*/
+var buildMarkMarkerGroup = (spec, sample, round) => {
+	const angleDeg = Math.atan2(sample.tangent[1], sample.tangent[0]) * 180 / Math.PI;
+	const sx = spec.markerWidth / spec.baseSize;
+	const sy = spec.markerHeight / spec.baseSize;
+	const refY = spec.baseSize / 2;
+	return {
+		type: "group",
+		transforms: [
+			{
+				kind: "translate",
+				x: round(sample.point[0]),
+				y: round(sample.point[1])
+			},
+			{
+				kind: "rotate",
+				degrees: round(angleDeg)
+			},
+			{
+				kind: "scale",
+				x: round(sx),
+				y: round(sy)
+			},
+			{
+				kind: "translate",
+				x: round(-spec.refX),
+				y: round(-refY)
+			}
+		],
+		children: [...spec.marker]
+	};
+};
 /**
 * IR Path → PathPrim
 * @description 每个绘制段独立用节点中心算两端 boundary clip——中段节点的入/出 boundary 点通常不同，path 在该节点可见"断开"（与 TikZ `\draw (A)--(B)--(C);` 段独立 clip 一致）。仍产一个 PathPrim：commands 用多组 move/line 表达 sub-path；段起点等于上段终点时复用 cursor 省 move。cycle 段闭回最近 move 起点，起点==lastEnd && 终点==subPathStart 时输出 close，否则显式画段 line。引用未定义节点/解析失败返回 null，并通过 `warnHook.onWarn` 同步触发 warning
@@ -47,15 +185,22 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 	}
 	/** 每段 step.label 翻译出的 TextPrim（或 sloped 旋转的 group），与 path 主体同级返回 */
 	const labelPrims = [];
-	/** 算 sample 后 emitLabelPrimitive，结果累积到 labelPrims/points */
+	/**
+	* 每个绘制段的几何采样器（按声明序）；中段 marking 用——把整条 path 的 pos∈[0,1] 分摊到 N 段
+	* @description 与 step label 同款便宜模型：N 段等分 pos 区间，pos 落在第 ⌊pos·N⌋ 段、段内参数 = 余数；
+	*   段内 t 的几何含义随段类型（line/step 弧长、curve/cubic/bend Bezier 参数、arc 角度），由各 `*SegmentSample` 决定。
+	*/
+	const segmentSamplers = [];
+	/** 算 sample 后 emitLabelPrimitive，结果累积到 labelPrims/points；同时登记本段采样器供 marks 用 */
 	const collectLabel = (step, sampleAt) => {
+		segmentSamplers.push(sampleAt);
 		if (step.kind === "move" || step.kind === "cycle" || !("label" in step) || !step.label) return;
 		const sample = sampleAt(require_label.tForLabelPosition(step.label.position));
 		const r = require_label.emitLabelPrimitive(step.label, sample, measureText, round, path.opacity);
 		labelPrims.push(r.primitive);
 		for (const p of r.points) points.push(p);
 	};
-	const hasTo = (s) => s.kind !== "cycle" && s.kind !== "arc" && s.kind !== "circlePath" && s.kind !== "ellipsePath" && s.kind !== "rectangle";
+	const hasTo = (s) => s.kind !== "cycle" && s.kind !== "arc" && s.kind !== "circlePath" && s.kind !== "ellipsePath" && s.kind !== "rectangle" && s.kind !== "generator";
 	const anchors = steps.map((s, idx) => {
 		if (!hasTo(s)) return null;
 		const ref = require_anchor.refPointOfTarget(s.to, nameStack, scopeChain);
@@ -91,6 +236,12 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 	* @description 设置 penOverride 让下个绘制段直接用此点当 fromClip 后清空。arc=弧终点；circlePath/ellipsePath=center（"画完留在圆心"）
 	*/
 	let penOverride = null;
+	/**
+	* 读当前游标（生成器分支用）
+	* @description 经函数边界读 `lastEnd`，让 TS 用其声明类型（`IRPosition | null`）而非按分支位置 narrow
+	*   成字面 `null`——generator 分支在源码上位于 lastEnd 各赋值点之前，直接读会被误判恒 null
+	*/
+	const readCursor = () => lastEnd;
 	const roundPoint = (p) => [round(p[0]), round(p[1])];
 	const emitMove = (p) => {
 		const rp = roundPoint(p);
@@ -187,6 +338,72 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		}
 		const step = steps[i];
 		if (step.kind === "move") continue;
+		if (step.kind === "generator") {
+			const generators = warnHook.effectivePathGenerators ?? {};
+			const def = Object.prototype.hasOwnProperty.call(generators, step.name) ? generators[step.name] : void 0;
+			if (!def) {
+				const available = Object.keys(generators).sort().join(", ") || "(none registered)";
+				throw new Error(`Unknown path generator '${step.name}'; available: ${available}`);
+			}
+			const parsed = def.paramsSchema.parse(step.params);
+			require_json.JsonObjectSchema.parse(parsed);
+			const paramsObj = parsed;
+			const resolvedTargets = {};
+			for (const key of def.targetParams ?? []) {
+				if (key.includes(".")) continue;
+				const raw = paramsObj[key];
+				if (raw === void 0) continue;
+				if (raw === null || typeof raw !== "string" && typeof raw !== "object") throw new Error(`path generator '${step.name}' targetParams key '${key}' must be a target (node id, coordinate, or target object); got ${raw === null ? "null" : typeof raw}.`);
+				const resolved = require_anchor.refPointOfTarget(raw, nameStack, scopeChain);
+				if (resolved) resolvedTargets[key] = resolved;
+			}
+			const prevGen = findPrev();
+			const fromGen = readCursor() ?? (prevGen ? prevGen.anchor : [0, 0]);
+			const toGen = (step.to !== void 0 ? require_anchor.refPointOfTarget(step.to, nameStack, scopeChain) : null) ?? void 0;
+			let produced;
+			try {
+				produced = def.generate({
+					from: fromGen,
+					...toGen !== void 0 ? { to: toGen } : {},
+					params: paramsObj,
+					resolvedTargets,
+					round
+				});
+			} catch (e) {
+				throw new Error(`path generator '${step.name}' threw: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+			}
+			if (!Array.isArray(produced)) throw new Error(`path generator '${step.name}' must return an array of path commands; got ${produced === null ? "null" : typeof produced}.`);
+			for (const cmd of produced) assertValidGeneratedCommand(step.name, cmd);
+			const generated = produced;
+			startSegment(fromGen);
+			for (const cmd of generated) switch (cmd.kind) {
+				case "move":
+					startSegment(cmd.to);
+					break;
+				case "line":
+					emitLine(cmd.to);
+					break;
+				case "quad":
+					emitQuad(cmd.control, cmd.to);
+					break;
+				case "cubic":
+					emitCubic(cmd.control1, cmd.control2, cmd.to);
+					break;
+				case "arc":
+					emitArc(cmd.center, cmd.radius, cmd.startAngle, cmd.endAngle);
+					break;
+				case "ellipseArc":
+					emitEllipseArc(cmd.center, cmd.radiusX, cmd.radiusY, cmd.startAngle, cmd.endAngle);
+					break;
+				case "close":
+					emitClose();
+					break;
+			}
+			const genEnd = readCursor() ?? fromGen;
+			collectLabel(step, (t) => require_segment.lineSegmentSample(fromGen, genEnd, t));
+			penOverride = readCursor();
+			continue;
+		}
 		if (step.kind === "cycle") {
 			const moveTo = lastMoveTo;
 			const prev = findPrev();
@@ -351,8 +568,8 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 			continue;
 		}
 		if (step.kind === "bend") {
-			const angle = step.bendAngle ?? 30;
-			const [c1, c2] = require_bend.bendControlPoints(prev.anchor, currAnchor, step.bendDirection, angle);
+			const [c1, c2] = step.outAngle !== void 0 || step.inAngle !== void 0 ? require_bend.outInControlPoints(prev.anchor, currAnchor, step.outAngle ?? 0, step.inAngle ?? 180, step.looseness) : require_bend.bendControlPoints(prev.anchor, currAnchor, step.bendDirection ?? "left", step.bendAngle ?? 30);
+			if (!isFinitePoint(c1) || !isFinitePoint(c2)) throw new Error("Bend produced a non-finite control point (looseness / angle too large); use smaller values.");
 			const fromClip = usedOverride ?? require_anchor.clipForTarget(prev.step.to, c1, nameStack, scopeChain);
 			const toClip = require_anchor.clipForTarget(step.to, c2, nameStack, scopeChain);
 			if (!fromClip || !toClip) return null;
@@ -383,11 +600,50 @@ var emitPathPrimitive = (path, nameStack, round, measureText = require_text_metr
 		fillOpacity: path.fillOpacity,
 		strokeOpacity: path.drawOpacity
 	};
-	const arrows = require_shrink.endpointArrows(path.arrow, path.arrowDetail);
-	require_shrink.applyArrowShrinks(commands, arrows.arrowStart ? require_shrink.computeShrink(arrows.arrowStart) : 0, arrows.arrowEnd ? require_shrink.computeShrink(arrows.arrowEnd) : 0, strokeWidth, round);
-	const { primitive } = require_split.splitSubPathsForEndpointArrows(commands, baseProps, arrows);
+	const effectiveArrows = warnHook.effectiveArrows ?? require_index.BUILTIN_ARROWS;
+	const arrows = require_shrink.endpointArrows(path.arrow, path.arrowDetail, effectiveArrows, round);
+	const markPrims = [];
+	if (path.marks && path.marks.length > 0 && segmentSamplers.length > 0) {
+		const segCount = segmentSamplers.length;
+		for (const { pos, mark } of path.marks) {
+			const scaled = pos * segCount;
+			const segIdx = Math.min(Math.floor(scaled), segCount - 1);
+			const localT = scaled - segIdx;
+			const sample = segmentSamplers[segIdx](pos === 1 ? 1 : localT);
+			const spec = require_shrink.resolveMarkArrowSpec(mark, effectiveArrows, round);
+			markPrims.push(buildMarkMarkerGroup(spec, sample, round));
+			points.push(sample.point);
+		}
+	}
+	require_shrink.applyArrowShrinks(commands, arrows.shrinkStart, arrows.shrinkEnd, strokeWidth, round);
+	const endpointSpecs = {};
+	if (arrows.arrowStart) endpointSpecs.arrowStart = arrows.arrowStart;
+	if (arrows.arrowEnd) endpointSpecs.arrowEnd = arrows.arrowEnd;
+	const { primitive } = require_split.splitSubPathsForEndpointArrows(commands, baseProps, endpointSpecs);
+	const bodyPrims = [
+		primitive,
+		...labelPrims,
+		...markPrims
+	];
+	if ((path.rotate !== void 0 || path.scale !== void 0) && points.length > 0) {
+		const center = bboxCenter(points);
+		const transforms = buildPathTransforms(path.rotate, path.scale, center, round);
+		if (transforms.length > 0) {
+			const group = {
+				type: "group",
+				transforms,
+				children: bodyPrims
+			};
+			const transformedPoints = points.map((p) => require_scope.applyTransformChain(p, transforms));
+			if (!transformedPoints.every(isFinitePoint)) throw new Error("Path rotate / scale produced a non-finite coordinate (scale too large); use a smaller scale.");
+			return {
+				primitives: [group],
+				points: transformedPoints
+			};
+		}
+	}
 	return {
-		primitives: [primitive, ...labelPrims],
+		primitives: bodyPrims,
 		points
 	};
 };