@retikz/core 0.2.0-alpha.1 → 0.2.0-alpha.3

package/dist/es/compile/compile.d.ts

@@ -1,5 +1,6 @@
 import { IR } from '../ir';
 import { Scene } from '../primitive';
+import { ShapeDefinition } from '../shapes';
 import { TextMeasurer } from './text-metrics';
 /** 编译期警告：path / position 解析失败时通过 `CompileOptions.onWarn` 发出，不影响编译产物 */
 export type CompileWarning = {
@@ -7,7 +8,7 @@ export type CompileWarning = {
      * 警告类型代码（机器可读）
      * @description 用户可按 code 分支处理；未来 alpha 加新 code 不破坏调用方
      */
-    code: 'UNRESOLVED_NODE_REFERENCE' | 'PATH_TOO_SHORT' | 'ANCHOR_RESOLUTION_FAILED' | 'OFFSET_BASE_UNRESOLVED' | 'POLAR_ORIGIN_UNRESOLVED' | 'AT_TARGET_UNRESOLVED' | 'RELATIVE_INITIAL_NO_PREV_END' | 'BBOX_EXTREME_INPUT' | 'DUPLICATE_NODE_ID' | (string & {});
+    code: 'UNRESOLVED_NODE_REFERENCE' | 'PATH_TOO_SHORT' | 'ANCHOR_RESOLUTION_FAILED' | 'OFFSET_BASE_UNRESOLVED' | 'POLAR_ORIGIN_UNRESOLVED' | 'AT_TARGET_UNRESOLVED' | 'RELATIVE_INITIAL_NO_PREV_END' | 'BBOX_EXTREME_INPUT' | 'DUPLICATE_NODE_ID' | 'SHAPE_OVERRIDES_BUILTIN' | (string & {});
     /** 人类可读消息（英文） */
     message: string;
     /** IR locator 路径（jq-like，如 `'children[3].path.children[1].to'`） */
@@ -34,6 +35,12 @@ export type CompileOptions = {
      * @description path / position 解析失败时按 IR locator + code + message 同步触发；不传时 dev 模式（`process.env.NODE_ENV !== 'production'`）默认 `console.warn`、生产静默
      */
     onWarn?: (warning: CompileWarning) => void;
+    /**
+     * 运行时注入的第三方 shape（不进 IR）
+     * @description 有效 shape 表 = `{ ...BUILTIN_SHAPES, ...shapes }`——同名 key 覆盖内置，经 `onWarn` 发
+     *   `SHAPE_OVERRIDES_BUILTIN`。IR 的 `node.shape` 仍是字符串；未注册名在编译期 throw。
+     */
+    shapes?: Record<string, ShapeDefinition>;
 };
 /**
  * IR → Scene 纯函数转换，所有 adapter 共享

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

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAwC,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAa,KAAK,EAA6B,MAAM,cAAc,CAAC;AAahF,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA2CrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C,CAAC;AAsDF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KAoMrE,CAAC"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../../src/compile/compile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAwC,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,EAAa,KAAK,EAA6B,MAAM,cAAc,CAAC;AAEhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAoBjD,OAAO,EAAE,KAAK,YAAY,EAAoB,MAAM,gBAAgB,CAAC;AA4CrE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,IAAI,EACA,2BAA2B,GAC3B,gBAAgB,GAChB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,GACzB,sBAAsB,GACtB,8BAA8B,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAClB,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,2BAA2B;AAC3B,MAAM,MAAM,cAAc,GAAG;IAC3B,oCAAoC;IACpC,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C,CAAC;AAsDF;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,IAAI,EAAE,EAAE,UAAS,cAAmB,KAAG,KAgOrE,CAAC"}

package/dist/es/compile/compile.js

@@ -1,4 +1,5 @@
 import { rect } from "../geometry/rect.js";
+import { BUILTIN_SHAPES } from "../shapes/index.js";
 import { NameStack } from "./name-stack.js";
 import { applyTransformChain, computeScopeBoundingBox, lowerScopeTransforms, projectLayoutToGlobal, registerScopeAsLayout } from "./scope.js";
 import { resolvePosition } from "./position.js";
@@ -6,6 +7,7 @@ import { emitNodePrimitives, layoutNode } from "./node.js";
 import { fallbackMeasurer } from "./text-metrics.js";
 import { emitPathPrimitive } from "./path/index.js";
 import { makeRound } from "./precision.js";
+import { buildStyleFrame, resolveEffectivePath, resolveLabelDefault, resolveNodeStyle } from "./style.js";
 import { computeLayout } from "./layout.js";
 //#region src/compile/compile.ts
 /**
@@ -15,7 +17,8 @@ import { computeLayout } from "./layout.js";
 */
 var zeroSizeRectAt = (id, [cx, cy]) => ({
 	id,
-	shape: "rectangle",
+	shapeName: "rectangle",
+	shapeDef: BUILTIN_SHAPES.rectangle,
 	rect: {
 		x: cx,
 		y: cy,
@@ -83,6 +86,17 @@ var compileToScene = (ir, options = {}) => {
 	const round = makeRound(options.precision ?? 2);
 	const nodeDistance = options.nodeDistance;
 	const onWarn = options.onWarn ?? defaultWarnDispatcher;
+	const effectiveShapes = options.shapes ? {
+		...BUILTIN_SHAPES,
+		...options.shapes
+	} : BUILTIN_SHAPES;
+	if (options.shapes) {
+		for (const name of Object.keys(options.shapes)) if (Object.prototype.hasOwnProperty.call(BUILTIN_SHAPES, name)) onWarn({
+			code: "SHAPE_OVERRIDES_BUILTIN",
+			message: `Injected shape '${name}' overrides the built-in shape of the same name.`,
+			path: `options.shapes.${name}`
+		});
+	}
 	const primitives = [];
 	const nameStack = new NameStack({ onDuplicate: (info) => onWarn(formatDuplicateWarning(info)) });
 	const allPoints = [];
@@ -120,12 +134,13 @@ var compileToScene = (ir, options = {}) => {
 	* @param locatorPrefix IR locator 前缀（如 `''` 表示顶层、`children[2].scope.` 表示某 scope 内）
 	* @param layoutsAccumulator 当前 scope 子树所有"实体"layout（node / coordinate / 嵌套 scope.id synthetic）累积——专给上层 scope.id bbox 计算用；顶层调用传一个共享数组（用得着就用，丢弃也不影响）
 	* @param pathsAccumulator 当前层级收集的 pending paths——由调用方分配并在合适时机 resolve
+	* @param styleStack 从根到当前层级累积的样式 frame 栈（scope 级联 graphic state + 四通道 every-X + resetStyle）；node / path 进入时按 inside-out per-field 解析 effective 样式
 	*/
-	const processChildren = (children, chain, sink, locatorPrefix, layoutsAccumulator, pathsAccumulator) => {
+	const processChildren = (children, chain, sink, locatorPrefix, layoutsAccumulator, pathsAccumulator, styleStack) => {
 		for (let i = 0; i < children.length; i++) {
 			const child = children[i];
 			if (child.type === "node") {
-				const layout = layoutNode(child, measureText, nameStack, nodeDistance, chain);
+				const layout = layoutNode(resolveNodeStyle(child, styleStack), measureText, nameStack, nodeDistance, chain, resolveLabelDefault(styleStack), effectiveShapes);
 				const globalLayout = chain.length === 0 ? layout : projectLayoutToGlobal(layout, chain);
 				if (child.id) nameStack.register(child.id, globalLayout, `${locatorPrefix}children[${i}].node.id`);
 				for (const prim of emitNodePrimitives(layout, round)) sink.push(prim);
@@ -165,7 +180,7 @@ var compileToScene = (ir, options = {}) => {
 				*  让 scope 内 path 自引用本 scope.id 端点取真 bbox 而非 placeholder */
 				const innerPaths = [];
 				try {
-					processChildren(child.children, innerChain, innerSink, `${locatorPrefix}children[${i}].scope.`, innerLayouts, innerPaths);
+					processChildren(child.children, innerChain, innerSink, `${locatorPrefix}children[${i}].scope.`, innerLayouts, innerPaths, [...styleStack, buildStyleFrame(child)]);
 					if (child.id) {
 						const bbox = computeScopeBoundingBox(innerLayouts);
 						const fallbackOrigin = innerChain.length === 0 ? [0, 0] : applyTransformChain([0, 0], innerChain);
@@ -186,14 +201,14 @@ var compileToScene = (ir, options = {}) => {
 				if (hasOwnTransforms) group.transforms = [...ownTransforms];
 				sink.push(group);
 			} else pathsAccumulator.push({
-				path: child,
+				path: resolveEffectivePath(child, styleStack),
 				irPath: `${locatorPrefix}children[${i}].path`,
 				scopeChain: chain
 			});
 		}
 	};
 	const rootPaths = [];
-	processChildren(ir.children, [], primitives, "", [], rootPaths);
+	processChildren(ir.children, [], primitives, "", [], rootPaths, []);
 	resolvePendingPaths(rootPaths);
 	return {
 		primitives,

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

@@ -1,14 +1,17 @@
 import { Position } from '../geometry/point';
-import { Rect, RectAnchor } from '../geometry/rect';
-import { AtDirection, IRNode, NodeShape } from '../ir';
+import { Rect } from '../geometry/rect';
+import { AtDirection, IRLabelDefault, IRNode } from '../ir';
 import { ScenePrimitive, TextLine, Transform } from '../primitive';
+import { ShapeDefinition } from '../shapes';
 import { NameStack } from './name-stack';
 import { TextMeasurer } from './text-metrics';
 export type NodeLayout = {
     /** 节点 id（其他位置可引用） */
     id?: string;
-    /** 节点形状，所有几何 / boundaryPoint 按 shape 多态 */
-    shape: NodeShape;
+    /** 节点形状名（诊断 / 错误信息用；几何走 shapeDef） */
+    shapeName: string;
+    /** 已解析的 shape 定义；circumscribe / boundaryPoint / anchor / emit 多点复用，取代旧 switch */
+    shapeDef: ShapeDefinition;
     /**
      * 节点视觉边界框（所有 shape 共享语义）
      * @description rectangle: rect 本身；circle: width=height=2×radius；ellipse: 2×rx,2×ry；diamond: 2×halfA,2×halfB。x,y 是几何中心，rotate 弧度
@@ -79,14 +82,15 @@ export type NodeLabelLayout = {
 };
 /**
  * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
- * @description 按 shape 多态调用各自 boundaryPoint；margin > 0 时形状先外扩，让 path 在 border 外停 margin
+ * @description 走 shapeDef.boundaryPoint；margin > 0 时先膨胀外接 Rect，让 path 在 border 外停 margin
  */
 export declare const boundaryPointOf: (layout: NodeLayout, toward: Position) => Position;
 /**
- * 取节点 shape 命名 anchor（center / north / east / north-east 等 9 个）
- * @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点
+ * 取节点 shape 命名 anchor（center / north / east / north-east 等）
+ * @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点。
+ *   shapeDef.anchor 不认识的名字返回 undefined，此处抛 Unknown anchor（列出 shape 名）
  */
-export declare const anchorOf: (layout: NodeLayout, name: RectAnchor) => Position;
+export declare const anchorOf: (layout: NodeLayout, name: string) => Position;
 /**
  * 取节点 shape 在指定角度方向的边界点
  * @description 角度是节点**局部坐标系**下的极角（度数：0°=局部 +x，90°=局部 +y）。layout.rect.rotate 把局部基绕中心旋转，得到世界系下的视觉方向；shape boundaryPoint 内部用 rotate-aware 投影，所以这里把局部 (cos, sin) 经 rect.rotate 旋转后加到中心当作世界系 toward 传入。不应用 margin（同 anchorOf）；用于 `'A.30'` 落点
@@ -99,10 +103,11 @@ 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>) => NodeLayout;
+export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault, shapes?: Record<string, ShapeDefinition>) => NodeLayout;
 /**
  * NodeLayout → Scene primitives
- * @description shape 主体按 shape 分发（rect/ellipse/path）；text 始终走 TextPrim；有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹（text 必须靠 group 旋转）
+ * @description shape 主体走 `shapeDef.emit`（收轴对齐 rect、可出多 primitive）；text 始终走 TextPrim；
+ *   有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹 shape + text（diamond 顶点 / text 都靠 group 旋转）
  */
 export declare const emitNodePrimitives: (layout: NodeLayout, round: (n: number) => number) => Array<ScenePrimitive>;
 //# sourceMappingURL=node.d.ts.map

package/dist/es/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/es/compile/node.js

@@ -1,7 +1,4 @@
-import { rect } from "../geometry/rect.js";
-import { circle } from "../geometry/circle.js";
-import { diamond } from "../geometry/diamond.js";
-import { ellipse } from "../geometry/ellipse.js";
+import { BUILTIN_SHAPES } from "../shapes/index.js";
 import { resolvePosition } from "./position.js";
 //#region src/compile/node.ts
 var DEFAULT_FONT_SIZE = 14;
@@ -10,7 +7,6 @@ var DEFAULT_LINE_HEIGHT_FACTOR = 1.2;
 var DEG_TO_RAD = Math.PI / 180;
 /** Node label 与 node 边界默认距离（TikZ 默认 0pt 视觉太贴） */
 var DEFAULT_LABEL_DISTANCE = 12;
-var SQRT2 = Math.SQRT2;
 /** dashed 预设：4 px 实线 + 2 px 间隙循环 */
 var DASHED_PATTERN = [4, 2];
 /** dotted 预设：1 px 圆点 + 2 px 间隙 */
@@ -23,61 +19,28 @@ var resolveDashArray = (dashArray, dashed, dotted) => {
 };
 /** IR align → 文字对齐锚点（start / middle / end） */
 var alignToTextAnchor = (a) => a === "left" ? "start" : a === "right" ? "end" : "middle";
-/** 从 layout 构造 Rect（带 margin 扩张） */
-var rectOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	width: layout.rect.width + 2 * marginAdd,
-	height: layout.rect.height + 2 * marginAdd,
-	rotate: layout.rect.rotate
-});
-/** 从 layout 构造 Circle（radius=外接框边长/2 + margin） */
-var circleOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	radius: layout.rect.width / 2 + marginAdd,
-	rotate: layout.rect.rotate
-});
-/** 从 layout 构造 Ellipse（rx/ry 各加 margin） */
-var ellipseOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	rx: layout.rect.width / 2 + marginAdd,
-	ry: layout.rect.height / 2 + marginAdd,
-	rotate: layout.rect.rotate
-});
-/** 从 layout 构造 Diamond（halfA/halfB 各加 margin） */
-var diamondOf = (layout, marginAdd) => ({
-	x: layout.rect.x,
-	y: layout.rect.y,
-	halfA: layout.rect.width / 2 + marginAdd,
-	halfB: layout.rect.height / 2 + marginAdd,
-	rotate: layout.rect.rotate
-});
+/** 把 Rect 各方向外扩 m（margin generic：所有 shape 都 w+2m, h+2m，由 boundaryPointOf 调用前膨胀） */
+var inflateRect = (r, m) => m === 0 ? r : {
+	x: r.x,
+	y: r.y,
+	width: r.width + 2 * m,
+	height: r.height + 2 * m,
+	rotate: r.rotate
+};
 /**
 * 取节点 shape 在 toward 方向的附着点（path 端点贴边用）
-* @description 按 shape 多态调用各自 boundaryPoint；margin > 0 时形状先外扩，让 path 在 border 外停 margin
+* @description 走 shapeDef.boundaryPoint；margin > 0 时先膨胀外接 Rect，让 path 在 border 外停 margin
 */
-var boundaryPointOf = (layout, toward) => {
-	const m = layout.margin;
-	switch (layout.shape) {
-		case "rectangle": return rect.boundaryPoint(rectOf(layout, m), toward);
-		case "circle": return circle.boundaryPoint(circleOf(layout, m), toward);
-		case "ellipse": return ellipse.boundaryPoint(ellipseOf(layout, m), toward);
-		case "diamond": return diamond.boundaryPoint(diamondOf(layout, m), toward);
-	}
-};
+var boundaryPointOf = (layout, toward) => layout.shapeDef.boundaryPoint(inflateRect(layout.rect, layout.margin), toward);
 /**
-* 取节点 shape 命名 anchor（center / north / east / north-east 等 9 个）
-* @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点
+* 取节点 shape 命名 anchor（center / north / east / north-east 等）
+* @description 不应用 margin——TikZ 语义中 explicit anchor 取视觉边界点不涉及 outer sep；用于 `'A.north'` 落点。
+*   shapeDef.anchor 不认识的名字返回 undefined，此处抛 Unknown anchor（列出 shape 名）
 */
 var anchorOf = (layout, name) => {
-	switch (layout.shape) {
-		case "rectangle": return rect.anchor(rectOf(layout, 0), name);
-		case "circle": return circle.anchor(circleOf(layout, 0), name);
-		case "ellipse": return ellipse.anchor(ellipseOf(layout, 0), name);
-		case "diamond": return diamond.anchor(diamondOf(layout, 0), name);
-	}
+	const p = layout.shapeDef.anchor(layout.rect, name);
+	if (p === void 0) throw new Error(`Unknown anchor '${name}' for shape '${layout.shapeName}'`);
+	return p;
 };
 /** 8 方向 label position → (anchorName, 单位向量)；above 视觉上方即 y 减小 */
 var LABEL_DIRECTION_MAP = {
@@ -140,12 +103,7 @@ var angleBoundaryOf = (layout, angleDeg) => {
 	const cosR = Math.cos(rot);
 	const sinR = Math.sin(rot);
 	const toward = [layout.rect.x + lx * cosR - ly * sinR, layout.rect.y + lx * sinR + ly * cosR];
-	switch (layout.shape) {
-		case "rectangle": return rect.boundaryPoint(rectOf(layout, 0), toward);
-		case "circle": return circle.boundaryPoint(circleOf(layout, 0), toward);
-		case "ellipse": return ellipse.boundaryPoint(ellipseOf(layout, 0), toward);
-		case "diamond": return diamond.boundaryPoint(diamondOf(layout, 0), toward);
-	}
+	return layout.shapeDef.boundaryPoint(layout.rect, toward);
 };
 /**
 * IR Node → 内部 NodeLayout
@@ -154,7 +112,10 @@ var angleBoundaryOf = (layout, angleDeg) => {
 *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
 *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
 */
-var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = []) => {
+var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = [], labelDefault, shapes = BUILTIN_SHAPES) => {
+	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(", ")}`);
 	const sx = node.xScale ?? node.scale ?? 1;
 	const sy = node.yScale ?? node.scale ?? 1;
 	const fontScale = Math.min(sx, sy);
@@ -201,29 +162,7 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = []) =
 	const minH = node.minimumHeight ?? node.minimumSize ?? 0;
 	const innerHalfW = Math.max(textWidth / 2 + xSep, xSep, minW / 2);
 	const innerHalfH = Math.max(textHeight / 2 + ySep, ySep, minH / 2);
-	const shape = node.shape ?? "rectangle";
-	let boundsHalfW;
-	let boundsHalfH;
-	switch (shape) {
-		case "rectangle":
-			boundsHalfW = innerHalfW;
-			boundsHalfH = innerHalfH;
-			break;
-		case "circle": {
-			const r = Math.sqrt(innerHalfW * innerHalfW + innerHalfH * innerHalfH);
-			boundsHalfW = r;
-			boundsHalfH = r;
-			break;
-		}
-		case "ellipse":
-			boundsHalfW = innerHalfW * SQRT2;
-			boundsHalfH = innerHalfH * SQRT2;
-			break;
-		case "diamond":
-			boundsHalfW = innerHalfW * 2;
-			boundsHalfH = innerHalfH * 2;
-			break;
-	}
+	const { halfWidth: boundsHalfW, halfHeight: boundsHalfH } = shapeDef.circumscribe(innerHalfW, innerHalfH);
 	const rotateDeg = node.rotate ?? 0;
 	const center = 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`);
@@ -233,17 +172,18 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = []) =
 			text: lab.text,
 			position: lab.position ?? "above",
 			distance: lab.distance ?? DEFAULT_LABEL_DISTANCE,
-			textColor: lab.textColor ?? node.textColor,
-			opacity: lab.opacity,
-			fontSize: (labFont?.size ?? baseFontSize) * fontScale,
-			fontFamily: labFont?.family ?? fontFamily,
-			fontWeight: labFont?.weight ?? fontWeight,
-			fontStyle: labFont?.style ?? fontStyle
+			textColor: lab.textColor ?? labelDefault?.textColor ?? labelDefault?.color ?? node.textColor,
+			opacity: lab.opacity ?? labelDefault?.opacity,
+			fontSize: (labFont?.size ?? labelDefault?.font?.size ?? baseFontSize) * fontScale,
+			fontFamily: labFont?.family ?? labelDefault?.font?.family ?? fontFamily,
+			fontWeight: labFont?.weight ?? labelDefault?.font?.weight ?? fontWeight,
+			fontStyle: labFont?.style ?? labelDefault?.font?.style ?? fontStyle
 		};
 	});
 	return {
 		id: node.id,
-		shape,
+		shapeName,
+		shapeDef,
 		rect: {
 			x: center[0],
 			y: center[1],
@@ -274,97 +214,28 @@ var layoutNode = (node, measureText, nameStack, nodeDistance, scopeChain = []) =
 		labels
 	};
 };
-/** rectangle → RectPrim */
-var emitRectShape = (layout, round) => {
-	const halfW = layout.rect.width / 2;
-	const halfH = layout.rect.height / 2;
-	return {
-		type: "rect",
-		x: round(layout.rect.x - halfW),
-		y: round(layout.rect.y - halfH),
-		width: round(layout.rect.width),
-		height: round(layout.rect.height),
-		fill: layout.fill ?? "transparent",
-		fillOpacity: layout.fillOpacity,
-		stroke: layout.stroke ?? "currentColor",
-		strokeOpacity: layout.strokeOpacity,
-		strokeWidth: layout.strokeWidth ?? 1,
-		dashPattern: layout.dashPattern,
-		cornerRadius: layout.roundedCorners,
-		opacity: layout.opacity
-	};
-};
-/** circle/ellipse → EllipsePrim（圆形 rx=ry） */
-var emitEllipseShape = (layout, round) => ({
-	type: "ellipse",
-	cx: round(layout.rect.x),
-	cy: round(layout.rect.y),
-	rx: round(layout.rect.width / 2),
-	ry: round(layout.rect.height / 2),
-	fill: layout.fill ?? "transparent",
+/** 从 NodeLayout 收敛 emit 所需的视觉样式子集（ShapeStyle，不含几何 / 文本） */
+var toShapeStyle = (layout) => ({
+	fill: layout.fill,
 	fillOpacity: layout.fillOpacity,
-	stroke: layout.stroke ?? "currentColor",
+	stroke: layout.stroke,
 	strokeOpacity: layout.strokeOpacity,
-	strokeWidth: layout.strokeWidth ?? 1,
+	strokeWidth: layout.strokeWidth,
 	dashPattern: layout.dashPattern,
+	roundedCorners: layout.roundedCorners,
 	opacity: layout.opacity
 });
-/** diamond → PathPrim（4 顶点 + close 闭合） */
-var emitDiamondShape = (layout, round) => {
-	const diam = diamondOf(layout, 0);
-	const e = diamond.anchor(diam, "east");
-	const n = diamond.anchor(diam, "north");
-	const w = diamond.anchor(diam, "west");
-	const s = diamond.anchor(diam, "south");
-	return {
-		type: "path",
-		commands: [
-			{
-				kind: "move",
-				to: [round(e[0]), round(e[1])]
-			},
-			{
-				kind: "line",
-				to: [round(n[0]), round(n[1])]
-			},
-			{
-				kind: "line",
-				to: [round(w[0]), round(w[1])]
-			},
-			{
-				kind: "line",
-				to: [round(s[0]), round(s[1])]
-			},
-			{ kind: "close" }
-		],
-		fill: layout.fill ?? "transparent",
-		fillOpacity: layout.fillOpacity,
-		stroke: layout.stroke ?? "currentColor",
-		strokeOpacity: layout.strokeOpacity,
-		strokeWidth: layout.strokeWidth ?? 1,
-		dashPattern: layout.dashPattern,
-		opacity: layout.opacity
-	};
-};
 /**
 * NodeLayout → Scene primitives
-* @description shape 主体按 shape 分发（rect/ellipse/path）；text 始终走 TextPrim；有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹（text 必须靠 group 旋转）
+* @description shape 主体走 `shapeDef.emit`（收轴对齐 rect、可出多 primitive）；text 始终走 TextPrim；
+*   有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹 shape + text（diamond 顶点 / text 都靠 group 旋转）
 */
 var emitNodePrimitives = (layout, round) => {
-	let shapePrim;
-	switch (layout.shape) {
-		case "rectangle":
-			shapePrim = emitRectShape(layout, round);
-			break;
-		case "circle":
-		case "ellipse":
-			shapePrim = emitEllipseShape(layout, round);
-			break;
-		case "diamond":
-			shapePrim = emitDiamondShape(unrotated(layout), round);
-			break;
-	}
-	const inner = [shapePrim];
+	const axisAlignedRect = {
+		...layout.rect,
+		rotate: 0
+	};
+	const inner = [...layout.shapeDef.emit(axisAlignedRect, toShapeStyle(layout), round)];
 	if (layout.lines) {
 		const halfBlockW = layout.textWidth / 2;
 		const xOffset = layout.align === "start" ? -halfBlockW : layout.align === "end" ? halfBlockW : 0;
@@ -418,13 +289,5 @@ var emitNodePrimitives = (layout, round) => {
 		children: inner
 	}];
 };
-/** layout 的"未旋转"副本，让 diamond 顶点先按未旋转算，外层 group 统一旋转 */
-var unrotated = (layout) => ({
-	...layout,
-	rect: {
-		...layout.rect,
-		rotate: 0
-	}
-});
 //#endregion
 export { anchorOf, angleBoundaryOf, boundaryPointOf, emitNodePrimitives, layoutNode };

package/dist/es/compile/path/index.js

@@ -47,7 +47,7 @@ var emitPathPrimitive = (path, nameStack, round, measureText = fallbackMeasurer,
 	const collectLabel = (step, sampleAt) => {
 		if (step.kind === "move" || step.kind === "cycle" || !("label" in step) || !step.label) return;
 		const sample = sampleAt(tForLabelPosition(step.label.position));
-		const r = emitLabelPrimitive(step.label, sample, measureText, round);
+		const r = emitLabelPrimitive(step.label, sample, measureText, round, path.opacity);
 		labelPrims.push(r.primitive);
 		for (const p of r.points) points.push(p);
 	};

package/dist/es/compile/path/label.d.ts

@@ -11,7 +11,7 @@ export declare const tForLabelPosition: (pos: IRStepLabel["position"]) => number
  * step.label + 段采样 → TextPrim（sloped 时裹一层 group 旋转）
  * @description 默认 side='above'/position='midway'：above/below 锚点 y±offset、align=middle、baseline=bottom/top；left/right x±offset、align=end/start、baseline=middle；sloped 不偏移裹 group rotate(angle, cx, cy) 由切线 atan2 算（SVG y-down CW 正）。返回 primitive + layout 外接点
  */
-export declare const emitLabelPrimitive: (label: IRStepLabel, sample: SegmentSample, measureText: TextMeasurer, round: (n: number) => number) => {
+export declare const emitLabelPrimitive: (label: IRStepLabel, sample: SegmentSample, measureText: TextMeasurer, round: (n: number) => number, hostOpacity?: number) => {
     primitive: ScenePrimitive;
     points: Array<IRPosition>;
 };

package/dist/es/compile/path/label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAmBpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,WAAW,CAAC,UAAU,CAAC,KAAG,MAIhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,WAAW,EAClB,QAAQ,aAAa,EACrB,aAAa,YAAY,EACzB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,KAC3B;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CA8ExD,CAAC"}
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../../src/compile/path/label.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAmBpD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,WAAW,CAAC,UAAU,CAAC,KAAG,MAIhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,WAAW,EAClB,QAAQ,aAAa,EACrB,aAAa,YAAY,EACzB,OAAO,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAC5B,cAAc,MAAM,KACnB;IAAE,SAAS,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAkGxD,CAAC"}

package/dist/es/compile/path/label.js

@@ -27,13 +27,22 @@ var tForLabelPosition = (pos) => {
 * step.label + 段采样 → TextPrim（sloped 时裹一层 group 旋转）
 * @description 默认 side='above'/position='midway'：above/below 锚点 y±offset、align=middle、baseline=bottom/top；left/right x±offset、align=end/start、baseline=middle；sloped 不偏移裹 group rotate(angle, cx, cy) 由切线 atan2 算（SVG y-down CW 正）。返回 primitive + layout 外接点
 */
-var emitLabelPrimitive = (label, sample, measureText, round) => {
-	const fontSize = LABEL_FONT_SIZE;
+var emitLabelPrimitive = (label, sample, measureText, round, hostOpacity) => {
+	const fontSize = label.font?.size ?? LABEL_FONT_SIZE;
+	const fontFamily = label.font?.family;
+	const fontWeight = label.font?.weight;
+	const fontStyle = label.font?.style;
 	const lineHeight = fontSize * LABEL_LINE_HEIGHT_FACTOR;
-	const m = measureText(label.text, { size: fontSize });
+	const m = measureText(label.text, {
+		size: fontSize,
+		family: fontFamily,
+		weight: fontWeight,
+		style: fontStyle
+	});
 	const measuredWidth = m.width;
 	const measuredHeight = m.height || lineHeight;
 	const side = label.side ?? "above";
+	const labelOpacity = label.opacity !== void 0 ? hostOpacity !== void 0 ? label.opacity * hostOpacity : label.opacity : hostOpacity;
 	let x = sample.point[0];
 	let y = sample.point[1];
 	let align = "middle";
@@ -62,8 +71,12 @@ var emitLabelPrimitive = (label, sample, measureText, round) => {
 		lineHeight: round(lineHeight),
 		measuredWidth: round(measuredWidth),
 		measuredHeight: round(measuredHeight),
-		fill: "currentColor"
+		fill: label.textColor ?? "currentColor"
 	};
+	if (fontFamily !== void 0) text.fontFamily = fontFamily;
+	if (fontWeight !== void 0) text.fontWeight = fontWeight;
+	if (fontStyle !== void 0) text.fontStyle = fontStyle;
+	if (labelOpacity !== void 0) text.opacity = labelOpacity;
 	if (side === "sloped") {
 		const groupPrim = {
 			type: "group",

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

@@ -1 +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"}
+{"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;AAE9C,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,UAgBF,CAAC"}

package/dist/es/compile/scope.js

@@ -1,4 +1,5 @@
 import { rect } from "../geometry/rect.js";
+import { BUILTIN_SHAPES } from "../shapes/index.js";
 import { resolvePosition } from "./position.js";
 //#region src/compile/scope.ts
 /**
@@ -235,7 +236,8 @@ var registerScopeAsLayout = (id, bbox, fallbackOrigin) => {
 	};
 	return {
 		id,
-		shape: "rectangle",
+		shapeName: "rectangle",
+		shapeDef: BUILTIN_SHAPES.rectangle,
 		rect: {
 			x: box.x,
 			y: box.y,

package/dist/es/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/es/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"}