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

package/dist/lib/compile/path/index.d.ts

@@ -1,8 +1,10 @@
 import { PaintResolver } from '../paint';
 import { IRPath, IRPosition } from '../../ir';
 import { ScenePrimitive, Transform } from '../../primitive';
+import { PathGeneratorDefinition } from '../../pathGenerators';
 import { NameStack } from '../name-stack';
 import { TextMeasurer } from '../text-metrics';
+import { EffectiveArrows } from './shrink';
 /** emitPathPrimitive 可选 warn 钩子 */
 export type EmitPathWarnHook = {
     /** 警告收集器（由 compileToScene 传入） */
@@ -21,6 +23,19 @@ export type EmitPathWarnHook = {
     scopeChain?: ReadonlyArray<Transform>;
     /** fill 解析器（PaintSpec → resourceRef + 登记资源）；缺省时纯色透传、PaintSpec 退化为无填充 */
     resolveFill?: PaintResolver;
+    /**
+     * 有效 arrow 表（内置 7 + 注入）；缺省 = 仅内置 7
+     * @description compileToScene 合并 `{ ...BUILTIN_ARROWS, ...options.arrows }` 传入；
+     *   endpointArrows 据此查表算 shrink / 调 def.emit；未注册名编译期 throw
+     */
+    effectiveArrows?: EffectiveArrows;
+    /**
+     * 有效 path generator 表（注入即全部，core 无内置）；缺省 = 空表
+     * @description compileToScene 传 `options.pathGenerators ?? {}`；generator step 据此查表（未注册名
+     *   编译期 throw，错误列出可用名）→ 双 parse 护栏 → targetParams resolve → 调 generate splice 命令。
+     *   解析逻辑由后续实现落地（此处仅声明 hook 入口）。
+     */
+    effectivePathGenerators?: Record<string, PathGeneratorDefinition>;
 };
 /**
  * IR Path → PathPrim

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,OAAO,KAAK,EACV,MAAM,EACN,UAAU,EAGX,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAEV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAkCtE,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,wEAAwE;IACxE,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IAqhBrE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAY9C,OAAO,KAAK,EACV,MAAM,EAEN,UAAU,EAGX,MAAM,UAAU,CAAC;AAElB,OAAO,KAAK,EAIV,cAAc,EACd,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AAKtE,OAAO,EAAE,KAAK,eAAe,EAA2D,MAAM,UAAU,CAAC;AA8FzG,mCAAmC;AACnC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,IAAI,CAAC;IACX,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACtC,wEAAwE;IACxE,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACnE,CAAC;AA0EF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,WAAW,SAAS,EACpB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAa,YAA+B,EAC5C,WAAU,gBAAqB,KAC9B;IAAE,UAAU,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAAG,IA0tBrE,CAAC"}

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

@@ -32,6 +32,14 @@ var normalizeRelativeTargets = (steps, nameStack, scopeChain = []) => {
 			out.push(step);
 			continue;
 		}
+		if (step.kind === "generator") {
+			out.push(step);
+			if (step.to !== void 0) {
+				const pos = require_anchor.refPointOfTarget(step.to, nameStack, scopeChain);
+				if (pos) prevEnd = pos;
+			}
+			continue;
+		}
 		const original = step.to;
 		let resolvedTo = original;
 		let updatePrevEnd = true;

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

@@ -1 +1 @@
-{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,KAAK,CAAC,MAAM,CA6Ed,CAAC"}
+{"version":3,"file":"relative.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/relative.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAc,MAAM,EAAY,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,aAAa,CAAC,MAAM,CAAC,EAC5B,WAAW,SAAS,EACpB,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,KAAK,CAAC,MAAM,CAuFd,CAAC"}

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

@@ -1,12 +1,21 @@
 const require_arrow = require("../../ir/path/arrow.cjs");
+const require_marker_prim = require("../marker-prim.cjs");
 const require_anchor = require("./anchor.cjs");
-const require_arrow_geometry = require("./arrow-geometry.cjs");
 //#region src/compile/path/shrink.ts
+/** 默认 baseSize（marker 局部基准边长，viewBox `0 0 baseSize baseSize`） */
+var ARROW_GEOMETRY_BASE_SIZE = 10;
+/** 查 effective 表取 def；未注册名编译期 throw（消息含字母序可用名列表） */
+var lookupArrowDef = (shape, effective) => {
+	if (Object.prototype.hasOwnProperty.call(effective, shape)) return effective[shape];
+	const available = Object.keys(effective).sort().join(", ");
+	throw new Error(`Unknown arrow shape '${shape}'; available: ${available}`);
+};
 /**
-* 端点级 spec：顶层默认 ⊕ end-side override（逐字段 merge）
-* @description 缺省字段继承顶层（不是"完全替换"）；空心 shape 上 fill 字段被丢（silent no-op）
+* 端点级视觉输入：顶层默认 ⊕ end-side override（逐字段 merge）
+* @description 缺省字段继承顶层（不是"完全替换"）；空心 def 上 fill 字段被丢（silent no-op）。
+*   产 compile-internal 中间体，供 shrink + emit 消费。
 */
-var resolveArrowEndSpec = (topLevel, endSide) => {
+var resolveArrowVisual = (topLevel, endSide, effective) => {
 	const baseShape = endSide?.shape ?? topLevel.shape ?? require_arrow.DEFAULT_ARROW_SHAPE;
 	const out = { shape: baseShape };
 	const scale = endSide?.scale ?? topLevel.scale;
@@ -21,35 +30,148 @@ var resolveArrowEndSpec = (topLevel, endSide) => {
 	if (opacity !== void 0) out.opacity = opacity;
 	const lineWidth = endSide?.lineWidth ?? topLevel.lineWidth;
 	if (lineWidth !== void 0) out.lineWidth = lineWidth;
-	if (!require_arrow_geometry.isHollowArrowShape(baseShape)) {
+	if (!lookupArrowDef(baseShape, effective).hollow) {
 		const fill = endSide?.fill ?? topLevel.fill;
 		if (fill !== void 0) out.fill = fill;
 	}
 	return out;
 };
-/** IR path-level `arrow` + `arrowDetail` → PathPrim 起末端点箭头规格 */
-var endpointArrows = (arrow, detail) => {
-	if (!arrow || arrow === "none") return {};
-	const top = detail ?? {};
-	const startSpec = resolveArrowEndSpec(top, top.start);
-	const endSpec = resolveArrowEndSpec(top, top.end);
-	switch (arrow) {
-		case "->": return { arrowEnd: endSpec };
-		case "<-": return { arrowStart: startSpec };
-		case "<->": return {
-			arrowStart: startSpec,
-			arrowEnd: endSpec
-		};
+/**
+* 校验 def 几何字段有限（baseSize 还须 > 0）
+* @description 第三方 / LLM 写出的 def 可能漏字段或塞 NaN / Infinity / 0 baseSize；这些数会经 shrink 公式
+*   污染 path 本体坐标（非仅 marker），故在此抛清晰错（含 shape 名，便于自修），不放任 NaN 静默流出。
+*/
+var assertFiniteGeometry = (shape, def) => {
+	if (!Number.isFinite(def.lineContactX)) throw new Error(`Arrow '${shape}' has a non-finite lineContactX (${String(def.lineContactX)}); it must be a finite number.`);
+	if (def.baseSize !== void 0 && (!Number.isFinite(def.baseSize) || def.baseSize <= 0)) throw new Error(`Arrow '${shape}' has an invalid baseSize (${String(def.baseSize)}); it must be a finite number greater than 0.`);
+	if (def.tipX !== void 0 && !Number.isFinite(def.tipX)) throw new Error(`Arrow '${shape}' has a non-finite tipX (${String(def.tipX)}); it must be a finite number.`);
+};
+/**
+* 调 def.emit 收集 marker 并跑窄子集 + JSON-safe 校验
+* @description emit 缺失 / 非函数 / 抛错 / 返回非 iterable 都包成含 shape 名的清晰错（便于第三方 / LLM 自修），
+*   不泄漏内部变量名；产物逐个过共享 `validateMarkerPrimitives`（窄子集 + 深度无函数检查，与 pattern motif 同套）。
+*/
+var callEmit = (shape, def, ctx) => {
+	if (typeof def.emit !== "function") throw new Error(`Arrow '${shape}' is missing an emit function (ArrowDefinition.emit is required).`);
+	let marker;
+	try {
+		marker = [...def.emit(ctx)];
+	} catch (e) {
+		throw new Error(`Arrow '${shape}' emit failed: ${e instanceof Error ? e.message : String(e)}`, { cause: e });
 	}
+	require_marker_prim.validateMarkerPrimitives(`Arrow '${shape}'`, marker);
+	return marker;
+};
+/** 据 def + 视觉输入解析端点几何（baseSize / tipX / contactX / resolved length·width） */
+var resolveGeometry = (visual, effective) => {
+	const def = lookupArrowDef(visual.shape, effective);
+	assertFiniteGeometry(visual.shape, def);
+	const baseSize = def.baseSize ?? ARROW_GEOMETRY_BASE_SIZE;
+	const tipX = def.tipX ?? baseSize;
+	const lineWidth = visual.lineWidth ?? 1.5;
+	const contactX = def.hollow ? def.lineContactX - lineWidth / 2 : def.lineContactX;
+	const scale = visual.scale ?? 1;
+	const resolvedLength = (visual.length ?? def.defaultLength ?? 6) * scale;
+	const resolvedWidth = (visual.width ?? def.defaultWidth ?? 6) * scale;
+	if (!Number.isFinite(resolvedLength) || !Number.isFinite(resolvedWidth)) throw new Error(`Arrow '${visual.shape}' resolved length/width is non-finite (length × scale overflowed); use smaller length / scale values.`);
+	return {
+		def,
+		baseSize,
+		tipX,
+		contactX,
+		lineWidth,
+		resolvedLength,
+		resolvedWidth
+	};
 };
 /**
 * 端点级 shrink（strokeWidth 倍）：line 末端朝起点缩这么多，让箭头尖端落回原 target
 * @description 不分实心 / 空心：路径端点接在箭头尾部或凹口，箭头尖端仍贴原 target。低 opacity 下不会再透出 line。
 */
-var computeShrink = (spec) => {
-	const geometry = require_arrow_geometry.resolveArrowShapeGeometry(spec);
-	const length = (spec.length ?? geometry.defaultLength) * (spec.scale ?? 1);
-	return (geometry.tipX - geometry.lineContactX) * length / geometry.baseSize;
+var computeShrink = (geometry) => (geometry.tipX - geometry.contactX) * geometry.resolvedLength / geometry.baseSize;
+/**
+* 据 def + 解析后视觉输入构 `ArrowEmitContext`
+* @description hollow def：fill 丢（neutral）、stroke = color override ?? contextStroke、lineWidth 启用；
+*   solid def：fill = fill ?? color ?? contextStroke、stroke = color ?? contextStroke。
+*/
+var buildEmitContext = (visual, geometry, round) => {
+	const contextStroke = { kind: "contextStroke" };
+	return {
+		stroke: visual.color ?? contextStroke,
+		fill: geometry.def.hollow ? contextStroke : visual.fill ?? visual.color ?? contextStroke,
+		lineWidth: geometry.lineWidth,
+		round
+	};
+};
+/**
+* 把视觉中间体物化成最终 `ArrowEndSpec`（已解析 marker 描述）
+* @description 构 `ArrowEmitContext` → 调 `def.emit` 收集 `MarkerPrimitive[]`，并算 baseSize /
+*   refX（hollow 减 lineWidth/2）/ markerWidth = 解析 length / markerHeight = 解析 width / opacity 透传。
+*/
+var materializeArrowEndSpec = (visual, geometry, round) => {
+	const ctx = buildEmitContext(visual, geometry, round);
+	const marker = callEmit(visual.shape, geometry.def, ctx);
+	const out = {
+		shape: visual.shape,
+		baseSize: geometry.baseSize,
+		refX: geometry.contactX,
+		markerWidth: geometry.resolvedLength,
+		markerHeight: geometry.resolvedWidth,
+		marker
+	};
+	if (visual.opacity !== void 0) out.opacity = visual.opacity;
+	return out;
+};
+/**
+* IR path-level `arrow` + `arrowDetail` → PathPrim 起末端点已解析 marker 描述
+* @description merge 视觉输入 → 查 effective 表 + 解析几何 → 算 shrink → 调 def.emit 物化最终 `ArrowEndSpec`。
+*   返回同时带 compile-internal 的 shrink 量（端点收缩在 compile 落，与 emit 落点无关）。
+*   未注册 shape 名在此 throw（lookupArrowDef）。
+*/
+var endpointArrows = (arrow, detail, effective, round) => {
+	if (!arrow || arrow === "none") return {
+		shrinkStart: 0,
+		shrinkEnd: 0
+	};
+	const top = detail ?? {};
+	const wantStart = arrow === "<-" || arrow === "<->";
+	const wantEnd = arrow === "->" || arrow === "<->";
+	const result = {
+		shrinkStart: 0,
+		shrinkEnd: 0
+	};
+	if (wantStart) {
+		const visual = resolveArrowVisual(top, top.start, effective);
+		const geometry = resolveGeometry(visual, effective);
+		result.arrowStart = materializeArrowEndSpec(visual, geometry, round);
+		result.shrinkStart = computeShrink(geometry);
+	}
+	if (wantEnd) {
+		const visual = resolveArrowVisual(top, top.end, effective);
+		const geometry = resolveGeometry(visual, effective);
+		result.arrowEnd = materializeArrowEndSpec(visual, geometry, round);
+		result.shrinkEnd = computeShrink(geometry);
+	}
+	return result;
+};
+/**
+* 解析一个中段标记 `IRArrowMark` 为已物化的 marker 描述（`ArrowEndSpec`）
+* @description 复用端点箭头同一管线：mark 自身视觉子集字段（shape / scale / length / width / color /
+*   fill / opacity / lineWidth）即 `ResolvedArrowVisual`（空心 def 上 fill 字段被丢）→ 查 effective 表
+*   解析几何 → 调 def.emit 物化局部 baseSize 几何 + wrapper 参数。方向由调用方按路径切线决定，本函数不含定向。
+*   未注册 shape 名在此 throw（lookupArrowDef）。
+*/
+var resolveMarkArrowSpec = (mark, effective, round) => {
+	const baseShape = mark.shape ?? require_arrow.DEFAULT_ARROW_SHAPE;
+	const visual = { shape: baseShape };
+	if (mark.scale !== void 0) visual.scale = mark.scale;
+	if (mark.length !== void 0) visual.length = mark.length;
+	if (mark.width !== void 0) visual.width = mark.width;
+	if (mark.color !== void 0) visual.color = mark.color;
+	if (mark.opacity !== void 0) visual.opacity = mark.opacity;
+	if (mark.lineWidth !== void 0) visual.lineWidth = mark.lineWidth;
+	if (!lookupArrowDef(baseShape, effective).hollow && mark.fill !== void 0) visual.fill = mark.fill;
+	return materializeArrowEndSpec(visual, resolveGeometry(visual, effective), round);
 };
 /** 取一个 PathCommand 末端 endpoint（move/line/quad/cubic → to；arc/ellipseArc → polar(end)；close 无端点） */
 var endpointOf = (cmd) => {
@@ -92,7 +214,7 @@ var setEndpoint = (commands, idx, newPt, round) => {
 * @description 让 line 端点接在 hollow arrow 尾部外缘、不贯穿 back outline；shrink=0 的实心 shape 跳过。in-place 改写 commands 数组
 */
 var applyArrowShrinks = (commands, shrinkStart, shrinkEnd, strokeWidth, round) => {
-	if (shrinkStart > 0) {
+	if (shrinkStart !== 0) {
 		const firstIdx = commands.findIndex((o) => o.kind === "move");
 		if (firstIdx >= 0) {
 			const cur = commands[firstIdx];
@@ -103,7 +225,7 @@ var applyArrowShrinks = (commands, shrinkStart, shrinkEnd, strokeWidth, round) =
 			}
 		}
 	}
-	if (shrinkEnd > 0) {
+	if (shrinkEnd !== 0) {
 		let lastIdx = -1;
 		for (let i = commands.length - 1; i >= 0; i--) if (commands[i].kind !== "close") {
 			lastIdx = i;
@@ -125,5 +247,5 @@ var applyArrowShrinks = (commands, shrinkStart, shrinkEnd, strokeWidth, round) =
 };
 //#endregion
 exports.applyArrowShrinks = applyArrowShrinks;
-exports.computeShrink = computeShrink;
 exports.endpointArrows = endpointArrows;
+exports.resolveMarkArrowSpec = resolveMarkArrowSpec;

package/dist/lib/compile/path/shrink.d.ts

@@ -1,15 +1,28 @@
-import { IRArrowDetail } from '../../ir';
+import { IRArrowDetail, IRArrowMark } from '../../ir';
+import { ArrowDefinition } from '../../arrows';
 import { ArrowEndSpec, PathCommand } from '../../primitive';
-/** IR path-level `arrow` + `arrowDetail` → PathPrim 起末端点箭头规格 */
-export declare const endpointArrows: (arrow: "none" | "->" | "<-" | "<->" | undefined, detail: IRArrowDetail | undefined) => {
+/** 有效 arrow 表：内置 7 + 注入（同名注入覆盖内置） */
+export type EffectiveArrows = Record<string, ArrowDefinition>;
+/**
+ * IR path-level `arrow` + `arrowDetail` → PathPrim 起末端点已解析 marker 描述
+ * @description merge 视觉输入 → 查 effective 表 + 解析几何 → 算 shrink → 调 def.emit 物化最终 `ArrowEndSpec`。
+ *   返回同时带 compile-internal 的 shrink 量（端点收缩在 compile 落，与 emit 落点无关）。
+ *   未注册 shape 名在此 throw（lookupArrowDef）。
+ */
+export declare const endpointArrows: (arrow: "none" | "->" | "<-" | "<->" | undefined, detail: IRArrowDetail | undefined, effective: EffectiveArrows, round: (n: number) => number) => {
     arrowStart?: ArrowEndSpec;
     arrowEnd?: ArrowEndSpec;
+    shrinkStart: number;
+    shrinkEnd: number;
 };
 /**
- * 端点级 shrink（strokeWidth 倍）：line 末端朝起点缩这么多，让箭头尖端落回原 target
- * @description 不分实心 / 空心：路径端点接在箭头尾部或凹口，箭头尖端仍贴原 target。低 opacity 下不会再透出 line。
+ * 解析一个中段标记 `IRArrowMark` 为已物化的 marker 描述（`ArrowEndSpec`）
+ * @description 复用端点箭头同一管线：mark 自身视觉子集字段（shape / scale / length / width / color /
+ *   fill / opacity / lineWidth）即 `ResolvedArrowVisual`（空心 def 上 fill 字段被丢）→ 查 effective 表
+ *   解析几何 → 调 def.emit 物化局部 baseSize 几何 + wrapper 参数。方向由调用方按路径切线决定，本函数不含定向。
+ *   未注册 shape 名在此 throw（lookupArrowDef）。
  */
-export declare const computeShrink: (spec: ArrowEndSpec) => number;
+export declare const resolveMarkArrowSpec: (mark: IRArrowMark, effective: EffectiveArrows, round: (n: number) => number) => ArrowEndSpec;
 /**
  * 按 shape + spec（length / scale / lineWidth）把首/末段端点向内缩短
  * @description 让 line 端点接在 hollow arrow 尾部外缘、不贯穿 back outline；shrink=0 的实心 shape 跳过。in-place 改写 commands 数组

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

@@ -1 +1 @@
-{"version":3,"file":"shrink.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/shrink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,aAAa,EAA0C,MAAM,UAAU,CAAC;AAC3G,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAmCjE,gEAAgE;AAChE,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,EAC/C,QAAQ,aAAa,GAAG,SAAS,KAChC;IAAE,UAAU,CAAC,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;CAatD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,KAAG,MAIlD,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,KAAK,CAAC,WAAW,CAAC,EAC5B,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,IA4CF,CAAC"}
+{"version":3,"file":"shrink.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/shrink.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAElB,KAAK,WAAW,EAEjB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAA+B,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAI9F,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAwM9D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,EAC/C,QAAQ,aAAa,GAAG,SAAS,EACjC,WAAW,eAAe,EAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B;IACD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAyBnB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,WAAW,EACjB,WAAW,eAAe,EAC1B,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,YAaF,CAAC;AAiDF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,UAAU,KAAK,CAAC,WAAW,CAAC,EAC5B,aAAa,MAAM,EACnB,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B,IA4CF,CAAC"}

package/dist/lib/compile/position.cjs

@@ -35,7 +35,7 @@ var DIRECTION_VECTOR = {
 *   - 节点 id lookup 走 NameStack.lookup 进行 inside-out 搜索（内层 frame 可见外层 frame）；
 *     nodeDistance 为容器 prop 注入默认距离，AtPosition 自带 distance 优先
 */
-var resolvePosition = (pos, nameStack, nodeDistance = DEFAULT_NODE_DISTANCE, scopeChain = []) => {
+var resolvePosition = (pos, nameStack, nodeDistance = DEFAULT_NODE_DISTANCE, scopeChain = [], resolveBetweenGlobal) => {
 	if (typeof pos === "string") {
 		const node = nameStack.lookup(pos);
 		if (!node) return null;
@@ -57,6 +57,12 @@ var resolvePosition = (pos, nameStack, nodeDistance = DEFAULT_NODE_DISTANCE, sco
 		if (!base) return null;
 		return [base[0] + pos.offset[0], base[1] + pos.offset[1]];
 	}
+	if ("between" in pos) {
+		if (!resolveBetweenGlobal) return null;
+		const global = resolveBetweenGlobal(pos, nameStack, scopeChain);
+		if (!global) return null;
+		return scopeChain.length === 0 ? global : require_scope.inverseTransformChain(global, scopeChain);
+	}
 	let origin;
 	if (!pos.origin) origin = [0, 0];
 	else {

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

@@ -1,6 +1,12 @@
-import { IRAtPosition, IROffsetPosition, IRPosition, PolarPosition } from '../ir';
+import { IRAtPosition, IRBetweenPosition, IROffsetPosition, IRPosition, PolarPosition } from '../ir';
 import { Transform } from '../primitive';
 import { NameStack } from './name-stack';
+/**
+ * between 端点 → 世界坐标解析器（依赖注入，避免 position.ts ↔ compile/path/anchor.ts 循环）
+ * @description 实参由 compile 层注入（= `refPointOfTarget`，处理 NodeTarget anchor / Cartesian / Polar /
+ *   Offset / 嵌套 between，返回世界坐标）。resolvePosition 收到 between 时调它取世界中点再反投影回局部。
+ */
+export type ResolveBetweenGlobal = (between: IRBetweenPosition, nameStack: NameStack, scopeChain: ReadonlyArray<Transform>) => IRPosition | null;
 /**
  * IR 各种位置形态（笛卡尔/极坐标/相对定位/偏移定位/节点 id）→ 笛卡尔位置
  * @description
@@ -20,5 +26,5 @@ import { NameStack } from './name-stack';
  *   - 节点 id lookup 走 NameStack.lookup 进行 inside-out 搜索（内层 frame 可见外层 frame）；
  *     nodeDistance 为容器 prop 注入默认距离，AtPosition 自带 distance 优先
  */
-export declare const resolvePosition: (pos: IRPosition | PolarPosition | IRAtPosition | IROffsetPosition | string, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>) => IRPosition | null;
+export declare const resolvePosition: (pos: IRPosition | PolarPosition | IRAtPosition | IROffsetPosition | IRBetweenPosition | string, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, resolveBetweenGlobal?: ResolveBetweenGlobal) => IRPosition | null;
 //# sourceMappingURL=position.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/compile/position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAqB9C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,GAAG,MAAM,EAC1E,WAAW,SAAS,EACpB,eAAc,MAA8B,EAC5C,aAAY,aAAa,CAAC,SAAS,CAAM,KACxC,UAAU,GAAG,IAyCf,CAAC"}
+{"version":3,"file":"position.d.ts","sourceRoot":"","sources":["../../../src/compile/position.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACvH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,KACjC,UAAU,GAAG,IAAI,CAAC;AAoBvB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,MAAM,EAC9F,WAAW,SAAS,EACpB,eAAc,MAA8B,EAC5C,aAAY,aAAa,CAAC,SAAS,CAAM,EACzC,uBAAuB,oBAAoB,KAC1C,UAAU,GAAG,IAiDf,CAAC"}

package/dist/lib/geometry/bend.cjs

@@ -14,5 +14,31 @@ var bendControlPoints = (from, to, direction, bendAngle) => {
 	const ctlOffset = 4 / 3 * (chord * Math.tan(bendAngle * Math.PI / 180 / 2));
 	return [[from[0] + dx / 3 + ctlOffset * nx, from[1] + dy / 3 + ctlOffset * ny], [from[0] + 2 * dx / 3 + ctlOffset * nx, from[1] + 2 * dy / 3 + ctlOffset * ny]];
 };
+/** 默认 looseness（looseness 缺省时） */
+var DEFAULT_LOOSENESS = 1;
+/** self-loop（from==to）默认环大小（user units，受 looseness 缩放） */
+var DEFAULT_LOOP_SIZE = 1;
+/** 直边 cubic 控制点距离系数（chord 的几分之一） */
+var OUTIN_DISTANCE_FACTOR = 1 / 3;
+/** 角度（度）转单位方向向量（0°=+x，90°=+y screen-down，与 IR 角度约定一致） */
+var dirOf = (angleDeg) => {
+	const rad = angleDeg * Math.PI / 180;
+	return [Math.cos(rad), Math.sin(rad)];
+};
+/**
+* out/in 角 + looseness 拟合 from→to 的非对称 cubic（含 self-loop 退化）
+* @description 标准 TikZ：control1 = from + d·dir(outAngle)，control2 = to + d·dir(inAngle)；
+*   d = looseness × distance，distance = chord × 系数（chord>0）或默认环大小（self-loop，from==to chord=0）。
+*   self-loop 时两控制点沿 out/in 两个不同方向各自从端点撑开，画出环（bend 对称弯在 chord=0 时退化为点，故 out/in 是自环唯一手段）。
+*/
+var outInControlPoints = (from, to, outAngle, inAngle, looseness) => {
+	const k = looseness ?? DEFAULT_LOOSENESS;
+	const chord = Math.hypot(to[0] - from[0], to[1] - from[1]);
+	const d = k * (chord === 0 ? DEFAULT_LOOP_SIZE : chord * OUTIN_DISTANCE_FACTOR);
+	const outDir = dirOf(outAngle);
+	const inDir = dirOf(inAngle);
+	return [[from[0] + d * outDir[0], from[1] + d * outDir[1]], [to[0] + d * inDir[0], to[1] + d * inDir[1]]];
+};
 //#endregion
 exports.bendControlPoints = bendControlPoints;
+exports.outInControlPoints = outInControlPoints;

package/dist/lib/geometry/bend.d.ts

@@ -4,4 +4,11 @@ import { Position } from './point';
  * @description apex offset = chord × tan(bendAngle/2)；控制点取 chord 1/3 与 2/3 处沿法向偏移，让 cubic 在 t=0.5 穿过 apex 故 ctlOffset = 4/3 × apexOffset。法向（screen y-down）：visual-left=(dy,-dx)/|chord|，visual-right=(-dy,dx)/|chord|。chord=0 时两控制点都返回 from
  */
 export declare const bendControlPoints: (from: Position, to: Position, direction: "left" | "right", bendAngle: number) => [Position, Position];
+/**
+ * out/in 角 + looseness 拟合 from→to 的非对称 cubic（含 self-loop 退化）
+ * @description 标准 TikZ：control1 = from + d·dir(outAngle)，control2 = to + d·dir(inAngle)；
+ *   d = looseness × distance，distance = chord × 系数（chord>0）或默认环大小（self-loop，from==to chord=0）。
+ *   self-loop 时两控制点沿 out/in 两个不同方向各自从端点撑开，画出环（bend 对称弯在 chord=0 时退化为点，故 out/in 是自环唯一手段）。
+ */
+export declare const outInControlPoints: (from: Position, to: Position, outAngle: number, inAngle: number, looseness?: number) => [Position, Position];
 //# sourceMappingURL=bend.d.ts.map

package/dist/lib/geometry/bend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bend.d.ts","sourceRoot":"","sources":["../../../src/geometry/bend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,WAAW,MAAM,GAAG,OAAO,EAC3B,WAAW,MAAM,KAChB,CAAC,QAAQ,EAAE,QAAQ,CAgBrB,CAAC"}
+{"version":3,"file":"bend.d.ts","sourceRoot":"","sources":["../../../src/geometry/bend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,WAAW,MAAM,GAAG,OAAO,EAC3B,WAAW,MAAM,KAChB,CAAC,QAAQ,EAAE,QAAQ,CAgBrB,CAAC;AAiBF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,UAAU,MAAM,EAChB,SAAS,MAAM,EACf,YAAY,MAAM,KACjB,CAAC,QAAQ,EAAE,QAAQ,CAUrB,CAAC"}

package/dist/lib/index.cjs

@@ -3,13 +3,16 @@ const require_position = require("./ir/position/position.cjs");
 const require_polar_position = require("./ir/position/polar-position.cjs");
 const require_at_position = require("./ir/position/at-position.cjs");
 const require_offset_position = require("./ir/position/offset-position.cjs");
+const require__transform = require("./geometry/_transform.cjs");
+const require_rect = require("./geometry/rect.cjs");
+const require_target = require("./ir/path/target.cjs");
+const require_between_position = require("./ir/position/between-position.cjs");
 const require_font = require("./ir/font.cjs");
+const require_json = require("./ir/json.cjs");
 const require_paint = require("./ir/paint.cjs");
+const require_clip = require("./ir/clip.cjs");
 const require_text = require("./ir/text.cjs");
 const require_arrow = require("./ir/path/arrow.cjs");
-const require__transform = require("./geometry/_transform.cjs");
-const require_rect = require("./geometry/rect.cjs");
-const require_target = require("./ir/path/target.cjs");
 const require_step = require("./ir/path/step.cjs");
 const require_path = require("./ir/path/path.cjs");
 const require_node = require("./ir/node.cjs");
@@ -21,6 +24,8 @@ const require_circle = require("./geometry/circle.cjs");
 const require_ellipse = require("./geometry/ellipse.cjs");
 const require_diamond = require("./geometry/diamond.cjs");
 const require_index = require("./shapes/index.cjs");
+const require_index$1 = require("./arrows/index.cjs");
+const require_index$2 = require("./patterns/index.cjs");
 const require_text_metrics = require("./compile/text-metrics.cjs");
 const require_layout = require("./compile/layout.cjs");
 const require_compile = require("./compile/compile.cjs");
@@ -29,21 +34,27 @@ const require_parseTargetSugar = require("./parsers/parseTargetSugar.cjs");
 const require_parseWay = require("./parsers/parseWay.cjs");
 const require_polar = require("./geometry/polar.cjs");
 const require_point = require("./geometry/point.cjs");
+const require_define = require("./pathGenerators/define.cjs");
 exports.ARROW_MARKER_DEFAULT_SIZE = require_arrow.ARROW_MARKER_DEFAULT_SIZE;
 exports.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = require_arrow.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH;
 exports.ARROW_SHAPES = require_arrow.ARROW_SHAPES;
 exports.AT_DIRECTIONS = require_at_position.AT_DIRECTIONS;
+exports.AbsoluteTargetSchema = require_between_position.AbsoluteTargetSchema;
 exports.AnchorRefSchema = require_target.AnchorRefSchema;
 exports.ArcStepSchema = require_step.ArcStepSchema;
 exports.ArrowDefaultSchema = require_scope.ArrowDefaultSchema;
 exports.ArrowDetailSchema = require_arrow.ArrowDetailSchema;
 exports.ArrowEndDetailSchema = require_arrow.ArrowEndDetailSchema;
 exports.AtPositionSchema = require_at_position.AtPositionSchema;
+exports.BUILTIN_ARROWS = require_index$1.BUILTIN_ARROWS;
+exports.BUILTIN_PATTERNS = require_index$2.BUILTIN_PATTERNS;
 exports.BUILTIN_SHAPES = require_index.BUILTIN_SHAPES;
 exports.BendStepSchema = require_step.BendStepSchema;
+exports.BetweenPositionSchema = require_between_position.BetweenPositionSchema;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
 exports.ChildSchema = require_scene.ChildSchema;
 exports.CirclePathStepSchema = require_step.CirclePathStepSchema;
+exports.ClipSpecSchema = require_clip.ClipSpecSchema;
 exports.ControlPointSchema = require_step.ControlPointSchema;
 exports.CoordinateSchema = require_coordinate.CoordinateSchema;
 exports.CubicStepSchema = require_step.CubicStepSchema;
@@ -54,8 +65,11 @@ exports.DrawWay = require_parseWay.DrawWay;
 exports.EllipsePathStepSchema = require_step.EllipsePathStepSchema;
 exports.FoldStepSchema = require_step.FoldStepSchema;
 exports.FontSchema = require_font.FontSchema;
+exports.GeneratorStepSchema = require_step.GeneratorStepSchema;
 exports.GradientStopSchema = require_paint.GradientStopSchema;
 exports.HOLLOW_ARROW_SHAPES = require_arrow.HOLLOW_ARROW_SHAPES;
+exports.JsonObjectSchema = require_json.JsonObjectSchema;
+exports.JsonValueSchema = require_json.JsonValueSchema;
 exports.LabelDefaultSchema = require_scope.LabelDefaultSchema;
 exports.LineSpecSchema = require_text.LineSpecSchema;
 exports.LineStepSchema = require_step.LineStepSchema;
@@ -67,6 +81,7 @@ exports.NodeLabelSchema = require_node.NodeLabelSchema;
 exports.NodeSchema = require_node.NodeSchema;
 exports.NodeTargetSchema = require_target.NodeTargetSchema;
 exports.OffsetPositionSchema = require_offset_position.OffsetPositionSchema;
+exports.PATTERN_SHAPES = require_paint.PATTERN_SHAPES;
 exports.PaintSpecSchema = require_paint.PaintSpecSchema;
 exports.PathDefaultSchema = require_scope.PathDefaultSchema;
 exports.PathSchema = require_path.PathSchema;
@@ -83,9 +98,11 @@ exports.StepSchema = require_step.StepSchema;
 exports.TargetSchema = require_target.TargetSchema;
 exports.TextBlockSchema = require_text.TextBlockSchema;
 exports.TransformSchema = require_transform.TransformSchema;
+exports.ViewBoxSchema = require_scene.ViewBoxSchema;
 exports.circle = require_circle.circle;
 exports.compileToScene = require_compile.compileToScene;
 exports.computeLayout = require_layout.computeLayout;
+exports.definePathGenerator = require_define.definePathGenerator;
 exports.diamond = require_diamond.diamond;
 exports.ellipse = require_ellipse.ellipse;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;

package/dist/lib/index.d.ts

@@ -2,14 +2,20 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, IRPaintSpec, IRGradientStop, } from './ir';
-export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
+export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, PATTERN_SHAPES, } from './ir';
 export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
 MovePathCommand, LinePathCommand, QuadPathCommand, CubicPathCommand, ArcPathCommand, EllipseArcPathCommand, ClosePathCommand, ArrowEndSpec, GroupPrim, Transform, 
 /** 3 个 named Transform 分支 */
-TranslateTransform, RotateTransform, ScaleTransform, Layout, Scene, PaintValue, SceneResource, } from './primitive';
+TranslateTransform, RotateTransform, ScaleTransform, Layout, Scene, PaintValue, SceneResource, PaintResource, 
+/** 裁剪资源（renderer-agnostic，adapter 物化 `<clipPath>`） */
+ClipResource, ClipShape, 
+/** 已解析 pattern tile（emit-in-compile 产物，进 Scene 资源，纯数据无函数） */
+ResolvedPatternTile, 
+/** marker 窄子集（ArrowDefinition.emit 产物，renderer-agnostic） */
+MarkerPrimitive, MarkerPathPrim, MarkerEllipsePrim, MarkerRectPrim, MarkerGroupPrim, MarkerPathCommand, MarkerFill, } from './primitive';
 export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, CompileWarning, } from './compile';
 export { computeLayout, fallbackMeasurer, compileToScene } from './compile';
 export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayLabelOp, } from './parsers';
@@ -18,5 +24,11 @@ export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPositio
 export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
 export type { ShapeDefinition, ShapeStyle } from './shapes';
 export { BUILTIN_SHAPES, worldToLocal, localToWorld } from './shapes';
+export type { ArrowDefinition, ArrowEmitContext } from './arrows';
+export { BUILTIN_ARROWS } from './arrows';
+export type { PatternDefinition, PatternEmitContext } from './patterns';
+export { BUILTIN_PATTERNS } from './patterns';
+export type { PathGeneratorDefinition, PathGeneratorContext } from './pathGenerators';
+export { definePathGenerator } from './pathGenerators';
 export type { ValueOf, AssertEqual } from './types';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/lib/ir/clip.cjs

@@ -0,0 +1,37 @@
+let zod = require("zod");
+//#region src/ir/clip.ts
+/**
+* 裁剪区规格（4 种结构化形状之一）
+* @description renderer-agnostic 的纯数值裁剪区：`rect` 取景窗 / `circle` 圆形遮罩 / `ellipse` 椭圆遮罩 /
+*   `polygon` 任意直边区域。坐标为所在 scope 的局部坐标系（与 scope children 同帧）。
+*   尺寸字段 `.positive().finite()`、坐标 `.finite()` 守 Scene JSON 可序列化（NaN/Infinity round-trip 失真）。
+*   不含 SVG path 迷你语言（任意贝塞尔裁剪推迟）。
+*/
+var ClipSpecSchema = zod.z.discriminatedUnion("kind", [
+	zod.z.object({
+		kind: zod.z.literal("rect"),
+		x: zod.z.number().finite().describe("Rect left-top x in scope-local coords"),
+		y: zod.z.number().finite().describe("Rect left-top y in scope-local coords"),
+		width: zod.z.number().finite().positive().describe("Rect width (> 0)"),
+		height: zod.z.number().finite().positive().describe("Rect height (> 0)")
+	}).describe("Rectangular clip region"),
+	zod.z.object({
+		kind: zod.z.literal("circle"),
+		cx: zod.z.number().finite().describe("Circle center x"),
+		cy: zod.z.number().finite().describe("Circle center y"),
+		r: zod.z.number().finite().positive().describe("Circle radius (> 0)")
+	}).describe("Circular clip region"),
+	zod.z.object({
+		kind: zod.z.literal("ellipse"),
+		cx: zod.z.number().finite().describe("Ellipse center x"),
+		cy: zod.z.number().finite().describe("Ellipse center y"),
+		rx: zod.z.number().finite().positive().describe("Ellipse x radius (> 0)"),
+		ry: zod.z.number().finite().positive().describe("Ellipse y radius (> 0)")
+	}).describe("Elliptical clip region"),
+	zod.z.object({
+		kind: zod.z.literal("polygon"),
+		points: zod.z.array(zod.z.tuple([zod.z.number().finite(), zod.z.number().finite()])).min(3).describe("Polygon vertices [x, y][]; at least 3 points, each finite")
+	}).describe("Polygon clip region (arbitrary straight-edge area)")
+]).describe("Clip region: one of rect / circle / ellipse / polygon, in scope-local coordinates. Used by `Scope.clip`; compiled into a renderer-agnostic ClipResource and referenced via the group `clipRef`.");
+//#endregion
+exports.ClipSpecSchema = ClipSpecSchema;