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

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"}

package/dist/lib/index.cjs

@@ -14,10 +14,12 @@ const require_coordinate = require("./ir/coordinate.cjs");
 const require_transform = require("./ir/transform.cjs");
 const require_scope = require("./ir/scope.cjs");
 const require_scene = require("./ir/scene.cjs");
+const require__transform = require("./geometry/_transform.cjs");
 const require_rect = require("./geometry/rect.cjs");
 const require_circle = require("./geometry/circle.cjs");
-const require_diamond = require("./geometry/diamond.cjs");
 const require_ellipse = require("./geometry/ellipse.cjs");
+const require_diamond = require("./geometry/diamond.cjs");
+const require_index = require("./shapes/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");
@@ -30,9 +32,11 @@ exports.ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = require_arrow.ARROW_MARKER_HOLL
 exports.ARROW_SHAPES = require_arrow.ARROW_SHAPES;
 exports.AT_DIRECTIONS = require_at_position.AT_DIRECTIONS;
 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_SHAPES = require_index.BUILTIN_SHAPES;
 exports.BendStepSchema = require_step.BendStepSchema;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
 exports.ChildSchema = require_scene.ChildSchema;
@@ -48,14 +52,17 @@ exports.EllipsePathStepSchema = require_step.EllipsePathStepSchema;
 exports.FoldStepSchema = require_step.FoldStepSchema;
 exports.FontSchema = require_font.FontSchema;
 exports.HOLLOW_ARROW_SHAPES = require_arrow.HOLLOW_ARROW_SHAPES;
+exports.LabelDefaultSchema = require_scope.LabelDefaultSchema;
 exports.LineSpecSchema = require_text.LineSpecSchema;
 exports.LineStepSchema = require_step.LineStepSchema;
 exports.MoveStepSchema = require_step.MoveStepSchema;
 exports.NODE_SHAPES = require_node.NODE_SHAPES;
 exports.NODE_TEXT_ALIGNS = require_node.NODE_TEXT_ALIGNS;
+exports.NodeDefaultSchema = require_scope.NodeDefaultSchema;
 exports.NodeLabelSchema = require_node.NodeLabelSchema;
 exports.NodeSchema = require_node.NodeSchema;
 exports.OffsetPositionSchema = require_offset_position.OffsetPositionSchema;
+exports.PathDefaultSchema = require_scope.PathDefaultSchema;
 exports.PathSchema = require_path.PathSchema;
 exports.PolarPositionSchema = require_polar_position.PolarPositionSchema;
 exports.PositionSchema = require_position.PositionSchema;
@@ -75,8 +82,10 @@ exports.computeLayout = require_layout.computeLayout;
 exports.diamond = require_diamond.diamond;
 exports.ellipse = require_ellipse.ellipse;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;
+exports.localToWorld = require__transform.localToWorld;
 exports.parseTargetSugar = require_parseTargetSugar.parseTargetSugar;
 exports.parseWay = require_parseWay.parseWay;
 exports.point = require_point.point;
 exports.polar = require_polar.polar;
 exports.rect = require_rect.rect;
+exports.worldToLocal = require__transform.worldToLocal;

package/dist/lib/index.d.ts

@@ -2,8 +2,8 @@
  * @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, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, IRArrowDetail, IRArrowEndDetail, NodeShape, NodeTextAlign, } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, 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, } 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 type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
@@ -16,5 +16,7 @@ export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayL
 export { parseWay, DrawWay, parseTargetSugar } from './parsers';
 export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
 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 { 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":"AAAA;;;GAGG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,8BAA8B,EAC9B,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,eAAe,EACf,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,MAAM,EACN,MAAM,EACN,WAAW,EACX,YAAY,EACZ,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,EACP,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,iBAAiB,EACjB,gBAAgB,EAChB,OAAO,EACP,EAAE,EACF,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,yBAAyB,EACzB,sCAAsC,EACtC,WAAW,EACX,gBAAgB,GACjB,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW;AACX,oDAAoD;AACpD,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,SAAS;AACT,6BAA6B;AAC7B,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,MAAM,EACN,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG5E,YAAY,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,eAAe,EACf,QAAQ,EACR,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAIhE,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,OAAO,EACP,OAAO,EACP,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxF,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/ir/node.cjs

@@ -37,7 +37,7 @@ var NodeLabelSchema = zod.z.object({
 var NodeSchema = zod.z.object({
 	type: zod.z.literal("node").describe("Discriminator marking this child as a node"),
 	id: zod.z.string().min(1).optional().describe("Optional unique id; required if any path needs to reference this node by string"),
-	shape: zod.z.nativeEnum(NODE_SHAPES).optional().describe("Node visual shape; defaults to `rectangle`. The boundary fully contains text + padding (circumscribed for circle / ellipse / diamond)."),
+	shape: zod.z.string().min(1).optional().describe("Node visual shape name; built-in `rectangle` / `circle` / `ellipse` / `diamond`, or an extension shape registered via `CompileOptions.shapes`. Any non-empty string passes schema validation; unregistered names are rejected at compile time. Defaults to `rectangle`. The boundary fully contains text + padding (circumscribed for circle / ellipse / diamond)."),
 	position: zod.z.union([
 		require_position.PositionSchema,
 		require_polar_position.PolarPositionSchema,
@@ -48,6 +48,7 @@ var NodeSchema = zod.z.object({
 	text: require_text.TextBlockSchema.optional(),
 	align: zod.z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
 	lineHeight: zod.z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
+	color: zod.z.string().optional().describe("Master color (TikZ `color=`). When set, stroke / fill / text default to it unless individually overridden, and it cascades to the inner text and edge labels. Individual fields (stroke / fill / textColor) always win over this within the same node."),
 	fill: zod.z.string().optional().describe("Background color of the node shape; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
 	fillOpacity: zod.z.number().min(0).max(1).optional().describe("Fill opacity 0..1; affects only the shape fill, leaves stroke / text alone."),
 	stroke: zod.z.string().optional().describe("Border color of the node shape; any CSS color. Defaults to currentColor when omitted"),

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

@@ -10,8 +10,17 @@ export declare const NODE_SHAPES: {
     readonly ellipse: "ellipse";
     readonly diamond: "diamond";
 };
-/** 节点形状字面量类型 */
-export type NodeShape = ValueOf<typeof NODE_SHAPES>;
+/**
+ * 内置 4 shape 名联合
+ * @description `BUILTIN_SHAPES` 的 Record key（保穷尽性约束，不随 `NodeShape` 开放而退化为 `string`）
+ */
+export type BuiltinShapeName = ValueOf<typeof NODE_SHAPES>;
+/**
+ * 节点形状名：开放字符串
+ * @description 内置 `BuiltinShapeName`，或经 `CompileOptions.shapes` 注册的扩展 shape 名；
+ *   `& {}` 让 IDE 仍对内置 4 名自动补全，同时接受任意非空字符串
+ */
+export type NodeShape = BuiltinShapeName | (string & {});
 /** 节点文本对齐（TikZ `align=` 同义） */
 export declare const NODE_TEXT_ALIGNS: {
     readonly left: "left";
@@ -84,12 +93,7 @@ export type IRNodeLabel = z.infer<typeof NodeLabelSchema>;
 export declare const NodeSchema: z.ZodObject<{
     type: z.ZodLiteral<"node">;
     id: z.ZodOptional<z.ZodString>;
-    shape: z.ZodOptional<z.ZodNativeEnum<{
-        readonly rectangle: "rectangle";
-        readonly circle: "circle";
-        readonly ellipse: "ellipse";
-        readonly diamond: "diamond";
-    }>>;
+    shape: z.ZodOptional<z.ZodString>;
     position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodObject<{
         direction: z.ZodNativeEnum<{
             readonly above: "above";
@@ -169,6 +173,7 @@ export declare const NodeSchema: z.ZodObject<{
         readonly right: "right";
     }>>;
     lineHeight: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
     fill: z.ZodOptional<z.ZodString>;
     fillOpacity: z.ZodOptional<z.ZodNumber>;
     stroke: z.ZodOptional<z.ZodString>;
@@ -347,8 +352,10 @@ export declare const NodeSchema: z.ZodObject<{
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    shape?: string | undefined;
     scale?: number | undefined;
+    color?: string | undefined;
+    textColor?: string | undefined;
     label?: {
         text: string;
         distance?: number | undefined;
@@ -378,7 +385,6 @@ export declare const NodeSchema: z.ZodObject<{
     strokeWidth?: number | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
-    textColor?: string | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;
@@ -426,8 +432,10 @@ export declare const NodeSchema: z.ZodObject<{
         weight?: number | "normal" | "bold" | undefined;
         style?: "normal" | "italic" | "oblique" | undefined;
     } | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    shape?: string | undefined;
     scale?: number | undefined;
+    color?: string | undefined;
+    textColor?: string | undefined;
     label?: {
         text: string;
         distance?: number | undefined;
@@ -457,7 +465,6 @@ export declare const NodeSchema: z.ZodObject<{
     strokeWidth?: number | undefined;
     fillOpacity?: number | undefined;
     drawOpacity?: number | undefined;
-    textColor?: string | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
     align?: "left" | "right" | "center" | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/ir/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgLpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/ir/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAEzD,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuLpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/lib/ir/path/path.cjs

@@ -4,6 +4,7 @@ let zod = require("zod");
 //#region src/ir/path/path.ts
 var PathSchema = zod.z.object({
 	type: zod.z.literal("path").describe("Discriminator marking this child as a path"),
+	color: zod.z.string().optional().describe("Master color (TikZ `color=`). When set, the stroke, arrow tips, and step labels default to it unless individually overridden. Following the master color (not the stroke) is how a colored line shares its color with its labels and arrows — `stroke=` alone only paints the line."),
 	stroke: zod.z.string().optional().describe("Stroke color of the path; any CSS color. Defaults to currentColor when omitted"),
 	strokeWidth: zod.z.number().optional().describe("Stroke width in user units; defaults to 1 when omitted"),
 	dashPattern: zod.z.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Stroke dash pattern lengths in user units (e.g. [4, 2]); omitted means solid line"),