@retikz/core 0.1.0 → 0.2.0-alpha.2

package/dist/lib/compile/scope.cjs

@@ -0,0 +1,261 @@
+const require_rect = require("../geometry/rect.cjs");
+const require_position = require("./position.cjs");
+//#region src/compile/scope.ts
+/**
+* 把 IR 6 变体 transforms 展平为 Scene 3 变体（Cartesian translate / rotate / scale）
+* @description 4 个 translate 变体（translate / polar-translate / at-translate / offset-translate）
+*   各自构造对应 Position 字面量并调用 `resolvePosition` 拿到 Cartesian (x, y)，再写成 Cartesian translate；
+*   rotate / scale 直接透传。referent 未解析时返回 null（上游负责发 warn / throw）
+*/
+var lowerScopeTransforms = (transforms, nameStack, nodeDistance) => {
+	const out = [];
+	for (const t of transforms) switch (t.kind) {
+		case "translate":
+			out.push({
+				kind: "translate",
+				x: t.x,
+				y: t.y
+			});
+			break;
+		case "polar-translate": {
+			const polar = {
+				angle: t.angle,
+				radius: t.radius
+			};
+			if (t.origin !== void 0) polar.origin = t.origin;
+			const resolved = require_position.resolvePosition(polar, nameStack, nodeDistance);
+			if (!resolved) return null;
+			out.push({
+				kind: "translate",
+				x: resolved[0],
+				y: resolved[1]
+			});
+			break;
+		}
+		case "at-translate": {
+			const at = {
+				direction: t.direction,
+				of: t.of
+			};
+			if (t.distance !== void 0) at.distance = t.distance;
+			const resolved = require_position.resolvePosition(at, nameStack, nodeDistance);
+			if (!resolved) return null;
+			out.push({
+				kind: "translate",
+				x: resolved[0],
+				y: resolved[1]
+			});
+			break;
+		}
+		case "offset-translate": {
+			const resolved = require_position.resolvePosition({
+				of: t.of,
+				offset: t.offset ?? [0, 0]
+			}, nameStack, nodeDistance);
+			if (!resolved) return null;
+			out.push({
+				kind: "translate",
+				x: resolved[0],
+				y: resolved[1]
+			});
+			break;
+		}
+		case "rotate": {
+			const r = {
+				kind: "rotate",
+				degrees: t.degrees
+			};
+			if (t.cx !== void 0) r.cx = t.cx;
+			if (t.cy !== void 0) r.cy = t.cy;
+			out.push(r);
+			break;
+		}
+		case "scale": {
+			const s = {
+				kind: "scale",
+				x: t.x
+			};
+			if (t.y !== void 0) s.y = t.y;
+			out.push(s);
+			break;
+		}
+	}
+	return out;
+};
+/**
+* 把局部坐标点 (x, y) 按 Cartesian-only transform 链 apply 到全局坐标
+* @description 数组语义与 SVG `transform="t0 t1 t2"` / TikZ scope option 顺序一致：
+*   array[0] 是最外层（最后 apply 到 local），array[last] 是最内层（最先 apply）；
+*   即对局部点 P，结果 = t0(t1(t2(P)))。实现上从数组尾部往头部迭代依次 apply。
+*   只接受已被 `lowerScopeTransforms` 展平后的 3 变体（translate / rotate / scale）
+*/
+var applyTransformChain = (local, chain) => {
+	let x = local[0];
+	let y = local[1];
+	for (let i = chain.length - 1; i >= 0; i--) {
+		const t = chain[i];
+		if (t.kind === "translate") {
+			x += t.x;
+			y += t.y;
+		} else if (t.kind === "rotate") {
+			const cx = t.cx ?? 0;
+			const cy = t.cy ?? 0;
+			const rad = t.degrees * Math.PI / 180;
+			const cos = Math.cos(rad);
+			const sin = Math.sin(rad);
+			const dx = x - cx;
+			const dy = y - cy;
+			x = cx + dx * cos - dy * sin;
+			y = cy + dx * sin + dy * cos;
+		} else {
+			const sy = t.y ?? t.x;
+			x *= t.x;
+			y *= sy;
+		}
+	}
+	return [x, y];
+};
+/**
+* 把全局坐标点反向投影回 scope 局部坐标系（`applyTransformChain` 的逆）
+* @description chain = [t0, t1, t2]（array[0] 最外层、最后 apply）的逆 =
+*   按数组正序应用每个 transform 的逆：t0^-1 / t1^-1 / t2^-1。
+*   translate(-x, -y) / rotate(-deg, cx, cy) / scale(1/x, 1/y)。
+*   scale 分量为 0 时反向投影未定义——退化为返回原点 (0, 0) 当前层，避免 NaN 污染下游。
+*   作用：referent 全局点 → 当前 scope 局部坐标系，配合 `applyTransformChain` 实现
+*   "referent 全局 + relative 部分在当前 scope 局部度量 + 末端正向投影回全局" 的语义。
+*/
+var inverseTransformChain = (global, chain) => {
+	let x = global[0];
+	let y = global[1];
+	for (const t of chain) if (t.kind === "translate") {
+		x -= t.x;
+		y -= t.y;
+	} else if (t.kind === "rotate") {
+		const cx = t.cx ?? 0;
+		const cy = t.cy ?? 0;
+		const rad = -t.degrees * Math.PI / 180;
+		const cos = Math.cos(rad);
+		const sin = Math.sin(rad);
+		const dx = x - cx;
+		const dy = y - cy;
+		x = cx + dx * cos - dy * sin;
+		y = cy + dx * sin + dy * cos;
+	} else {
+		const sy = t.y ?? t.x;
+		if (t.x === 0 || sy === 0) {
+			x = 0;
+			y = 0;
+			continue;
+		}
+		x /= t.x;
+		y /= sy;
+	}
+	return [x, y];
+};
+/**
+* 复制 NodeLayout 并把 rect 中心点 + rotate + 尺寸全部按 scope transform chain 投到全局
+* @description rect 中心走 `applyTransformChain`；chain 里的 rotate 累加到 `rect.rotate`（弧度）、
+*   scale 乘进 rect.width / height / margin——这样 path 端点的 boundary clip 取的是与 SVG `<g>`
+*   实际渲染一致的视觉尺寸 / 朝向，跨 / 入 / 出 rotate / scale scope 的 path 都贴节点视觉边界。
+*   非均匀 scale 与 rotate 在 chain 中混合时，按"累加 rotate + 分量相乘 scale"近似（uniform scale 精确，
+*   anisotropic + rotate 的剪切耦合不展开——alpha 阶段限制）。
+*/
+var projectLayoutToGlobal = (layout, chain) => {
+	const [gx, gy] = applyTransformChain([layout.rect.x, layout.rect.y], chain);
+	let rotateAccumRad = 0;
+	let scaleX = 1;
+	let scaleY = 1;
+	for (const t of chain) if (t.kind === "rotate") rotateAccumRad += t.degrees * Math.PI / 180;
+	else if (t.kind === "scale") {
+		scaleX *= t.x;
+		scaleY *= t.y ?? t.x;
+	}
+	const globalRect = {
+		...layout.rect,
+		x: gx,
+		y: gy,
+		rotate: (layout.rect.rotate ?? 0) + rotateAccumRad,
+		width: layout.rect.width * scaleX,
+		height: layout.rect.height * scaleY
+	};
+	const marginScale = Math.max(Math.abs(scaleX), Math.abs(scaleY));
+	return {
+		...layout,
+		rect: globalRect,
+		margin: layout.margin * marginScale
+	};
+};
+/**
+* 收集一组 NodeLayout 的全局 axis-aligned bounding box
+* @description 每个 layout 的 4 角点已是全局坐标系（Pass 1 累积 chain apply 后），
+*   取每个 layout 的 rotate-aware `north-west` / `north-east` / `south-west` / `south-east`
+*   4 角点（rect.anchor 已含 layout.rect.rotate 处理）并求 AABB；
+*   layout 是 0×0（coordinate / 空 scope 占位）时退化为单点也合法；
+*   空 layouts 数组返回 null（调用方按"empty scope + fallback origin"退化为 0×0 占位）
+*/
+var computeScopeBoundingBox = (layouts) => {
+	if (layouts.length === 0) return null;
+	let minX = Infinity;
+	let minY = Infinity;
+	let maxX = -Infinity;
+	let maxY = -Infinity;
+	for (const layout of layouts) {
+		const corners = [
+			require_rect.rect.anchor(layout.rect, "north-west"),
+			require_rect.rect.anchor(layout.rect, "north-east"),
+			require_rect.rect.anchor(layout.rect, "south-west"),
+			require_rect.rect.anchor(layout.rect, "south-east")
+		];
+		for (const [cx, cy] of corners) {
+			if (cx < minX) minX = cx;
+			if (cy < minY) minY = cy;
+			if (cx > maxX) maxX = cx;
+			if (cy > maxY) maxY = cy;
+		}
+	}
+	return {
+		x: (minX + maxX) / 2,
+		y: (minY + maxY) / 2,
+		width: maxX - minX,
+		height: maxY - minY
+	};
+};
+/**
+* 用 scope id + bbox 构造 synthetic rectangle NodeLayout
+* @description bbox 为 null 时退化为 fallbackOrigin 的 0×0 占位（空 scope 仍要有可引用句柄）。
+*   synthetic layout 完全复用 rectangle 路径：`scope.id.<keyword>` / `scope.id.<deg>` / `scope.id` 作为 referent
+*   走与普通 rectangle Node 完全一致的 anchorOf / boundaryPointOf / 中心点取值
+*/
+var registerScopeAsLayout = (id, bbox, fallbackOrigin) => {
+	const box = bbox ?? {
+		x: fallbackOrigin[0],
+		y: fallbackOrigin[1],
+		width: 0,
+		height: 0
+	};
+	return {
+		id,
+		shape: "rectangle",
+		rect: {
+			x: box.x,
+			y: box.y,
+			width: box.width,
+			height: box.height,
+			rotate: 0
+		},
+		rotateDeg: 0,
+		margin: 0,
+		textWidth: box.width,
+		textHeight: box.height,
+		align: "middle",
+		lineHeight: 0,
+		fontSize: 0
+	};
+};
+//#endregion
+exports.applyTransformChain = applyTransformChain;
+exports.computeScopeBoundingBox = computeScopeBoundingBox;
+exports.inverseTransformChain = inverseTransformChain;
+exports.lowerScopeTransforms = lowerScopeTransforms;
+exports.projectLayoutToGlobal = projectLayoutToGlobal;
+exports.registerScopeAsLayout = registerScopeAsLayout;

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

@@ -0,0 +1,66 @@
+import { IRPosition, IRTransform } from '../ir';
+import { Transform } from '../primitive';
+import { NameStack } from './name-stack';
+import { NodeLayout } from './node';
+/**
+ * 把 IR 6 变体 transforms 展平为 Scene 3 变体（Cartesian translate / rotate / scale）
+ * @description 4 个 translate 变体（translate / polar-translate / at-translate / offset-translate）
+ *   各自构造对应 Position 字面量并调用 `resolvePosition` 拿到 Cartesian (x, y)，再写成 Cartesian translate；
+ *   rotate / scale 直接透传。referent 未解析时返回 null（上游负责发 warn / throw）
+ */
+export declare const lowerScopeTransforms: (transforms: ReadonlyArray<IRTransform>, nameStack: NameStack, nodeDistance?: number) => Array<Transform> | null;
+/**
+ * 把局部坐标点 (x, y) 按 Cartesian-only transform 链 apply 到全局坐标
+ * @description 数组语义与 SVG `transform="t0 t1 t2"` / TikZ scope option 顺序一致：
+ *   array[0] 是最外层（最后 apply 到 local），array[last] 是最内层（最先 apply）；
+ *   即对局部点 P，结果 = t0(t1(t2(P)))。实现上从数组尾部往头部迭代依次 apply。
+ *   只接受已被 `lowerScopeTransforms` 展平后的 3 变体（translate / rotate / scale）
+ */
+export declare const applyTransformChain: (local: IRPosition, chain: ReadonlyArray<Transform>) => IRPosition;
+/**
+ * 把全局坐标点反向投影回 scope 局部坐标系（`applyTransformChain` 的逆）
+ * @description chain = [t0, t1, t2]（array[0] 最外层、最后 apply）的逆 =
+ *   按数组正序应用每个 transform 的逆：t0^-1 / t1^-1 / t2^-1。
+ *   translate(-x, -y) / rotate(-deg, cx, cy) / scale(1/x, 1/y)。
+ *   scale 分量为 0 时反向投影未定义——退化为返回原点 (0, 0) 当前层，避免 NaN 污染下游。
+ *   作用：referent 全局点 → 当前 scope 局部坐标系，配合 `applyTransformChain` 实现
+ *   "referent 全局 + relative 部分在当前 scope 局部度量 + 末端正向投影回全局" 的语义。
+ */
+export declare const inverseTransformChain: (global: IRPosition, chain: ReadonlyArray<Transform>) => IRPosition;
+/**
+ * 复制 NodeLayout 并把 rect 中心点 + rotate + 尺寸全部按 scope transform chain 投到全局
+ * @description rect 中心走 `applyTransformChain`；chain 里的 rotate 累加到 `rect.rotate`（弧度）、
+ *   scale 乘进 rect.width / height / margin——这样 path 端点的 boundary clip 取的是与 SVG `<g>`
+ *   实际渲染一致的视觉尺寸 / 朝向，跨 / 入 / 出 rotate / scale scope 的 path 都贴节点视觉边界。
+ *   非均匀 scale 与 rotate 在 chain 中混合时，按"累加 rotate + 分量相乘 scale"近似（uniform scale 精确，
+ *   anisotropic + rotate 的剪切耦合不展开——alpha 阶段限制）。
+ */
+export declare const projectLayoutToGlobal: (layout: NodeLayout, chain: ReadonlyArray<Transform>) => NodeLayout;
+/** scope bbox 计算结果：bbox 几何中心 + 尺寸（width/height ≥ 0；空 scope 退化为 0×0 占位时仍合法） */
+export type ScopeBoundingBox = {
+    /** bbox 几何中心 x（全局坐标） */
+    x: number;
+    /** bbox 几何中心 y（全局坐标） */
+    y: number;
+    /** bbox 宽度（≥ 0；空 scope / 单点退化为 0） */
+    width: number;
+    /** bbox 高度（≥ 0；空 scope / 单点退化为 0） */
+    height: number;
+};
+/**
+ * 收集一组 NodeLayout 的全局 axis-aligned bounding box
+ * @description 每个 layout 的 4 角点已是全局坐标系（Pass 1 累积 chain apply 后），
+ *   取每个 layout 的 rotate-aware `north-west` / `north-east` / `south-west` / `south-east`
+ *   4 角点（rect.anchor 已含 layout.rect.rotate 处理）并求 AABB；
+ *   layout 是 0×0（coordinate / 空 scope 占位）时退化为单点也合法；
+ *   空 layouts 数组返回 null（调用方按"empty scope + fallback origin"退化为 0×0 占位）
+ */
+export declare const computeScopeBoundingBox: (layouts: ReadonlyArray<NodeLayout>) => ScopeBoundingBox | null;
+/**
+ * 用 scope id + bbox 构造 synthetic rectangle NodeLayout
+ * @description bbox 为 null 时退化为 fallbackOrigin 的 0×0 占位（空 scope 仍要有可引用句柄）。
+ *   synthetic layout 完全复用 rectangle 路径：`scope.id.<keyword>` / `scope.id.<deg>` / `scope.id` 作为 referent
+ *   走与普通 rectangle Node 完全一致的 anchorOf / boundaryPointOf / 中心点取值
+ */
+export declare const registerScopeAsLayout: (id: string, bbox: ScopeBoundingBox | null, fallbackOrigin: IRPosition) => NodeLayout;
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/compile/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,UAAU,EACV,WAAW,EAEZ,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAGzC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,aAAa,CAAC,WAAW,CAAC,EACtC,WAAW,SAAS,EACpB,eAAe,MAAM,KACpB,KAAK,CAAC,SAAS,CAAC,GAAG,IAiDrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,UAAU,EACjB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAyBF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAgCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,aAAa,CAAC,SAAS,CAAC,KAC9B,UAuBF,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,wBAAwB;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,aAAa,CAAC,UAAU,CAAC,KACjC,gBAAgB,GAAG,IA2BrB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,IAAI,MAAM,EACV,MAAM,gBAAgB,GAAG,IAAI,EAC7B,gBAAgB,UAAU,KACzB,UAeF,CAAC"}

package/dist/lib/compile/style.cjs

@@ -0,0 +1,262 @@
+//#region src/compile/style.ts
+/** 拷贝源对象中 `!== undefined` 的字段（per-field 合并按存在性，不按真假值） */
+var pickDefinedKeys = (src) => {
+	const out = {};
+	for (const key of Object.keys(src)) {
+		const value = src[key];
+		if (value !== void 0) out[key] = value;
+	}
+	return out;
+};
+/**
+* 从 IRScope 抽取样式 frame
+* @description 只摘样式相关字段（级联 graphic state + 四通道 + resetStyle）；transforms / id / localNamespace 与样式正交，不进 frame
+*/
+var buildStyleFrame = (scope) => {
+	const cascade = {};
+	if (scope.color !== void 0) cascade.color = scope.color;
+	if (scope.stroke !== void 0) cascade.stroke = scope.stroke;
+	if (scope.fill !== void 0) cascade.fill = scope.fill;
+	if (scope.strokeWidth !== void 0) cascade.strokeWidth = scope.strokeWidth;
+	if (scope.opacity !== void 0) cascade.opacity = scope.opacity;
+	if (scope.fillOpacity !== void 0) cascade.fillOpacity = scope.fillOpacity;
+	if (scope.drawOpacity !== void 0) cascade.drawOpacity = scope.drawOpacity;
+	const frame = { cascade };
+	if (scope.nodeDefault) frame.nodeDefault = scope.nodeDefault;
+	if (scope.pathDefault) frame.pathDefault = scope.pathDefault;
+	if (scope.labelDefault) frame.labelDefault = scope.labelDefault;
+	if (scope.arrowDefault) frame.arrowDefault = scope.arrowDefault;
+	if (scope.resetStyle !== void 0) frame.resetStyle = scope.resetStyle;
+	return frame;
+};
+/** resetStyle 是否切某通道 */
+var cuts = (reset, channel) => {
+	if (reset === void 0 || reset === false) return false;
+	if (reset === true) return true;
+	return reset.includes(channel);
+};
+/** 级联 graphic state 投影到 node 样式字段（主色展开：stroke / fill / textColor 默认随 color） */
+var cascadeToNode = (c) => {
+	const out = {};
+	const master = c.color;
+	const stroke = c.stroke ?? master;
+	if (stroke !== void 0) out.stroke = stroke;
+	const fill = c.fill ?? master;
+	if (fill !== void 0) out.fill = fill;
+	if (master !== void 0) out.textColor = master;
+	if (c.strokeWidth !== void 0) out.strokeWidth = c.strokeWidth;
+	if (c.opacity !== void 0) out.opacity = c.opacity;
+	if (c.fillOpacity !== void 0) out.fillOpacity = c.fillOpacity;
+	if (c.drawOpacity !== void 0) out.drawOpacity = c.drawOpacity;
+	return out;
+};
+/** 级联 graphic state 投影到 path 样式字段（主色展开 stroke；path fill 不随主色——与 TikZ 一致） */
+var cascadeToPath = (c) => {
+	const out = {};
+	const stroke = c.stroke ?? c.color;
+	if (stroke !== void 0) out.stroke = stroke;
+	if (c.fill !== void 0) out.fill = c.fill;
+	if (c.strokeWidth !== void 0) out.strokeWidth = c.strokeWidth;
+	if (c.opacity !== void 0) out.opacity = c.opacity;
+	if (c.fillOpacity !== void 0) out.fillOpacity = c.fillOpacity;
+	if (c.drawOpacity !== void 0) out.drawOpacity = c.drawOpacity;
+	return out;
+};
+/** node 源同源主色展开：未显式给的 stroke / fill / textColor 取该源 color */
+var expandNodeColor = (src) => {
+	const out = { ...src };
+	const master = src.color;
+	if (master !== void 0) {
+		if (out.stroke === void 0) out.stroke = master;
+		if (out.fill === void 0) out.fill = master;
+		if (out.textColor === void 0) out.textColor = master;
+	}
+	return out;
+};
+/** path 源同源主色展开：未显式给的 stroke 取该源 color（fill 不随主色） */
+var expandPathColor = (src) => {
+	const out = { ...src };
+	if (src.color !== void 0 && out.stroke === void 0) out.stroke = src.color;
+	return out;
+};
+/**
+* 解析 node 最终样式——fold 外→内 frame 栈 + 元素显式
+* @description 优先级链（每分项就近 model A）：元素显式分项 > 元素 color > nodeDefault 分项 > nodeDefault color
+*   > scope 级联分项 > scope color > 内置（layoutNode 兜底）。同 frame 内 nodeDefault 优先于级联。
+*   resetStyle('node') 丢外层累积；position / id / text / label 取元素自身（不参与继承）。
+*/
+var resolveNodeStyle = (node, stack) => {
+	let acc = {};
+	for (const frame of stack) {
+		if (cuts(frame.resetStyle, "node")) acc = {};
+		acc = {
+			...acc,
+			...pickDefinedKeys(cascadeToNode(frame.cascade))
+		};
+		if (frame.nodeDefault) acc = {
+			...acc,
+			...pickDefinedKeys(expandNodeColor(frame.nodeDefault))
+		};
+	}
+	acc = {
+		...acc,
+		...pickDefinedKeys(expandNodeColor(node))
+	};
+	return acc;
+};
+/** fold labelDefault 通道（node label + step label 共享）；resetStyle('label') 丢外层 */
+var resolveLabelDefault = (stack) => {
+	let acc = {};
+	for (const frame of stack) {
+		if (cuts(frame.resetStyle, "label")) acc = {};
+		if (frame.labelDefault) acc = {
+			...acc,
+			...pickDefinedKeys(frame.labelDefault)
+		};
+	}
+	return acc;
+};
+/** 逐字段合并字体（a 优先，缺字段回退 b）；都空返回 undefined */
+var mergeFont = (a, b) => {
+	if (a === void 0) return b;
+	if (b === void 0) return a;
+	const out = {};
+	const family = a.family ?? b.family;
+	if (family !== void 0) out.family = family;
+	const size = a.size ?? b.size;
+	if (size !== void 0) out.size = size;
+	const weight = a.weight ?? b.weight;
+	if (weight !== void 0) out.weight = weight;
+	const style = a.style ?? b.style;
+	if (style !== void 0) out.style = style;
+	return out;
+};
+/**
+* 解析 step label 最终样式——消费 scope labelDefault + 宿主 path 已解析主色
+* @description 继承顺序：label 显式 > scope.labelDefault (textColor → color) > 宿主 path 主色 > currentColor（emit 兜底）。
+*   跟随的是宿主 path 主色（不是 stroke）；font 逐字段回退 labelDefault；opacity 与 path opacity 相乘在 emit 阶段。
+*   masterColor 是 host 轴（结构关系），不受 resetStyle('label') 影响——label 仍跟所属线，不成孤岛。
+*/
+var resolveStepLabel = (label, labelDefault, masterColor) => {
+	const out = { ...label };
+	const textColor = label.textColor ?? labelDefault.textColor ?? labelDefault.color ?? masterColor;
+	if (textColor !== void 0) out.textColor = textColor;
+	else delete out.textColor;
+	const font = mergeFont(label.font, labelDefault.font);
+	if (font !== void 0) out.font = font;
+	const opacity = label.opacity ?? labelDefault.opacity;
+	if (opacity !== void 0) out.opacity = opacity;
+	return out;
+};
+/** per-field 合并 arrow 端点 spec（b 覆盖 a 的 defined 字段；返回新对象，不共享引用） */
+var mergeArrowEnd = (a, b) => {
+	if (a === void 0) return b === void 0 ? void 0 : { ...b };
+	if (b === void 0) return { ...a };
+	return {
+		...a,
+		...pickDefinedKeys(b)
+	};
+};
+/** per-field 合并 arrow detail：顶层 + start / end 各自 nested per-field merge（返回新对象，不共享引用） */
+var mergeArrowDetail = (a, b) => {
+	const { start: aStart, end: aEnd, ...aTop } = a;
+	const { start: bStart, end: bEnd, ...bTop } = b;
+	const out = {
+		...aTop,
+		...pickDefinedKeys(bTop)
+	};
+	const start = mergeArrowEnd(aStart, bStart);
+	if (start !== void 0) out.start = start;
+	const end = mergeArrowEnd(aEnd, bEnd);
+	if (end !== void 0) out.end = end;
+	return out;
+};
+/** 去掉端点 spec 的 color（让端点 color 回退到顶层主色）；返回新对象 */
+var dropArrowEndColor = (end) => {
+	const next = { ...end };
+	delete next.color;
+	return next;
+};
+/**
+* 解析 arrow detail——fold arrowDefault 通道 + 跟宿主 path 主色 + 元素 arrowDetail
+* @description color 优先级（顶层与 start / end 端点同理）：元素显式 arrowDetail（含 start / end.color）> 宿主 path 已解析主色 > arrowDefault（含 start / end.color）> 内置。
+*   宿主主色（host 轴，决策 13）会清掉 arrowDefault 带来的端点 color，让 start / end 回退到顶层主色；元素自身 arrowDetail（含 start / end.color）仍最高。
+*   masterColor 不受 resetStyle('arrow') 影响（host 轴非 scope 继承）。lineWidth / fill 的主色映射推迟（render 端仍按现有兜底继承 path stroke）。
+*/
+var resolveArrowDetail = (explicit, stack, masterColor) => {
+	let acc = {};
+	let touched = false;
+	for (const frame of stack) {
+		if (cuts(frame.resetStyle, "arrow")) {
+			acc = {};
+			touched = false;
+		}
+		if (frame.arrowDefault) {
+			acc = mergeArrowDetail(acc, frame.arrowDefault);
+			touched = true;
+		}
+	}
+	if (masterColor !== void 0) {
+		acc.color = masterColor;
+		if (acc.start !== void 0) acc.start = dropArrowEndColor(acc.start);
+		if (acc.end !== void 0) acc.end = dropArrowEndColor(acc.end);
+		touched = true;
+	}
+	if (explicit) {
+		acc = mergeArrowDetail(acc, explicit);
+		touched = true;
+	}
+	return touched ? acc : void 0;
+};
+/** 替换 path children 中各 step 的 label 为已解析 effective label */
+var resolveStepLabels = (children, labelDefault, masterColor) => children.map((step) => {
+	if ("label" in step && step.label !== void 0) return {
+		...step,
+		label: resolveStepLabel(step.label, labelDefault, masterColor)
+	};
+	return step;
+});
+/**
+* 解析 path 最终样式——fold frame 栈 + 元素显式 + arrow / step-label 跟宿主主色
+* @description 返回 effective IRPath：base 样式 fold（优先级链同 node）；arrowDetail 消费 arrowDefault 通道 + 跟主色；
+*   每个 step.label 消费 labelDefault 通道 + 跟主色。masterColor = path 已解析主色（就近 color），arrow / step-label 跟它（不跟 stroke）。
+*/
+var resolveEffectivePath = (path, stack) => {
+	let acc = {};
+	let masterColor;
+	for (const frame of stack) {
+		if (cuts(frame.resetStyle, "path")) {
+			acc = {};
+			masterColor = void 0;
+		}
+		if (frame.cascade.color !== void 0) masterColor = frame.cascade.color;
+		acc = {
+			...acc,
+			...pickDefinedKeys(cascadeToPath(frame.cascade))
+		};
+		if (frame.pathDefault) {
+			if (frame.pathDefault.color !== void 0) masterColor = frame.pathDefault.color;
+			acc = {
+				...acc,
+				...pickDefinedKeys(expandPathColor(frame.pathDefault))
+			};
+		}
+	}
+	if (path.color !== void 0) masterColor = path.color;
+	acc = {
+		...acc,
+		...pickDefinedKeys(expandPathColor(path))
+	};
+	const effective = acc;
+	const arrowDetail = resolveArrowDetail(path.arrowDetail, stack, masterColor);
+	if (arrowDetail !== void 0) effective.arrowDetail = arrowDetail;
+	else delete effective.arrowDetail;
+	const labelDefault = resolveLabelDefault(stack);
+	effective.children = resolveStepLabels(path.children, labelDefault, masterColor);
+	return effective;
+};
+//#endregion
+exports.buildStyleFrame = buildStyleFrame;
+exports.resolveEffectivePath = resolveEffectivePath;
+exports.resolveLabelDefault = resolveLabelDefault;
+exports.resolveNodeStyle = resolveNodeStyle;

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

@@ -0,0 +1,46 @@
+import { IRArrowDetail, IRLabelDefault, IRNode, IRPath, IRScope } from '../ir';
+/**
+ * scope 级联 graphic state——主色 color + 跨类共享分项
+ * @description 级联到 scope 内全部元素（= TikZ scope option / current color）
+ */
+type CascadeState = Pick<IRScope, 'color' | 'stroke' | 'fill' | 'strokeWidth' | 'opacity' | 'fillOpacity' | 'drawOpacity'>;
+/**
+ * 单层 scope 的样式 frame——compile 维护 frame 栈做 inside-out per-field 解析
+ * @description 级联 graphic state + 四通道 every-X 默认 + resetStyle 屏障；从 IRScope 抽取（buildStyleFrame）
+ */
+export type StyleFrame = {
+    /** 级联 graphic state（主色 + 跨类共享分项） */
+    cascade: CascadeState;
+    /** every node 默认 */
+    nodeDefault?: IRScope['nodeDefault'];
+    /** every path 默认 */
+    pathDefault?: IRScope['pathDefault'];
+    /** every label 默认（node label + step label 共享） */
+    labelDefault?: IRLabelDefault;
+    /** every arrow 默认 */
+    arrowDefault?: IRArrowDetail;
+    /** 朝外的继承屏障：切外层对应通道 */
+    resetStyle?: IRScope['resetStyle'];
+};
+/**
+ * 从 IRScope 抽取样式 frame
+ * @description 只摘样式相关字段（级联 graphic state + 四通道 + resetStyle）；transforms / id / localNamespace 与样式正交，不进 frame
+ */
+export declare const buildStyleFrame: (scope: IRScope) => StyleFrame;
+/**
+ * 解析 node 最终样式——fold 外→内 frame 栈 + 元素显式
+ * @description 优先级链（每分项就近 model A）：元素显式分项 > 元素 color > nodeDefault 分项 > nodeDefault color
+ *   > scope 级联分项 > scope color > 内置（layoutNode 兜底）。同 frame 内 nodeDefault 优先于级联。
+ *   resetStyle('node') 丢外层累积；position / id / text / label 取元素自身（不参与继承）。
+ */
+export declare const resolveNodeStyle: (node: IRNode, stack: ReadonlyArray<StyleFrame>) => IRNode;
+/** fold labelDefault 通道（node label + step label 共享）；resetStyle('label') 丢外层 */
+export declare const resolveLabelDefault: (stack: ReadonlyArray<StyleFrame>) => IRLabelDefault;
+/**
+ * 解析 path 最终样式——fold frame 栈 + 元素显式 + arrow / step-label 跟宿主主色
+ * @description 返回 effective IRPath：base 样式 fold（优先级链同 node）；arrowDetail 消费 arrowDefault 通道 + 跟主色；
+ *   每个 step.label 消费 labelDefault 通道 + 跟主色。masterColor = path 已解析主色（就近 color），arrow / step-label 跟它（不跟 stroke）。
+ */
+export declare const resolveEffectivePath: (path: IRPath, stack: ReadonlyArray<StyleFrame>) => IRPath;
+export {};
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/compile/style.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAGb,cAAc,EACd,MAAM,EACN,MAAM,EACN,OAAO,EAIR,MAAM,OAAO,CAAC;AAEf;;;GAGG;AACH,KAAK,YAAY,GAAG,IAAI,CACtB,OAAO,EACP,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CACxF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,oCAAoC;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC,oBAAoB;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACrC,iDAAiD;IACjD,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,qBAAqB;IACrB,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,sBAAsB;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CACpC,CAAC;AAYF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,UAgBhD,CAAC;AAiEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,OAAO,aAAa,CAAC,UAAU,CAAC,KAC/B,MAYF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,GAC9B,OAAO,aAAa,CAAC,UAAU,CAAC,KAC/B,cAOF,CAAC;AAyHF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,OAAO,aAAa,CAAC,UAAU,CAAC,KAC/B,MA2BF,CAAC"}