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

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

@@ -1 +1 @@
-{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/ir/scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,aAAa,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAChC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;CAC3D,CAAC;AAOF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,CAAC,CAAC,UAAU,KAAG,IAE5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCrB,CAAC"}
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../../src/ir/scope.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmGrB,CAAC"}

package/dist/es/ir/scope.js

@@ -1,6 +1,47 @@
+import { FontSchema } from "./font.js";
+import { ArrowDetailSchema } from "./path/arrow.js";
+import { PathSchema } from "./path/path.js";
+import { NodeSchema } from "./node.js";
 import { TransformSchema } from "./transform.js";
 import { z } from "zod";
 //#region src/ir/scope.ts
+/**
+* every node 默认样式 schema
+* @description 从 NodeSchema 派生，排除实例专属字段（type / id / position / text / label）；
+*   含形状 / 间距 / scale / rotate / color 等所有可作默认的 node 样式字段
+*/
+var NodeDefaultSchema = NodeSchema.omit({
+	type: true,
+	id: true,
+	position: true,
+	text: true,
+	label: true
+}).strict();
+/**
+* every path 默认样式 schema
+* @description 从 PathSchema 派生，排除 type / children / arrow / arrowDetail（arrow 走独立 arrowDefault 通道，免双入口）
+*/
+var PathDefaultSchema = PathSchema.omit({
+	type: true,
+	children: true,
+	arrow: true,
+	arrowDetail: true
+}).strict();
+/**
+* every label 默认样式 schema（node label 与 step label 共享）
+* @description 单通道双宿主：node-label 跟 node.color、step-label 跟 path.color；本 schema 只定义可继承的 label 样式字段
+*/
+var LabelDefaultSchema = z.object({
+	color: z.string().optional().describe("Master color for labels in this scope; textColor falls back to it."),
+	textColor: z.string().optional().describe("Default text color for node labels and step labels in this scope."),
+	opacity: z.number().min(0).max(1).optional().describe("Default label opacity 0..1."),
+	font: FontSchema.optional().describe("Default label font (family / size / weight / style); per-field fallback.")
+}).strict().describe("Default style applied to every label (node label + step label) in this scope (TikZ `every label`). All fields optional; unknown keys are rejected.");
+/**
+* every arrow 默认样式 schema
+* @description 直接复用 ArrowDetailSchema（shape / scale / length / width / color / fill / opacity / lineWidth + start / end）
+*/
+var ArrowDefaultSchema = ArrowDetailSchema;
 /** schema 注册顺序：scene.ts import 时由 __registerChildSchema 一次性回灌；之后只读 */
 var childSchemaRef = null;
 /**
@@ -11,19 +52,38 @@ var __registerChildSchema = (schema) => {
 	childSchemaRef = schema;
 };
 /**
-* Scope schema：4 IRScope 字段
+* Scope schema：容器 + 局部 transform + 样式默认挂点
 * @description 直接 `z.object` 让 ChildSchema discriminatedUnion 能识别 `type` 鉴别字段；
-* children 字段内部用 z.lazy 引用 ChildSchema 实现递归，避免直接 `z.lazy(() => z.object(...))` 让外层 union 拒识 type
+* children 字段内部用 z.lazy 引用 ChildSchema 实现递归，避免直接 `z.lazy(() => z.object(...))` 让外层 union 拒识 type。
+* alpha.2 加：① 级联 graphic state（color + stroke / fill / strokeWidth / opacity / fillOpacity / drawOpacity）；
+* ② 四通道 every-X 默认（nodeDefault / pathDefault / labelDefault / arrowDefault）；③ resetStyle 继承屏障。
 */
 var ScopeSchema = z.object({
 	type: z.literal("scope").describe("Discriminator marking this child as a scope container."),
 	id: z.string().min(1).optional().describe("Optional reference id; when set, the scope registers a synthetic rectangle bbox node in the **parent** namespace frame so paths / positions can target the scope as a whole. scope.id always registers in the parent frame, regardless of `localNamespace` (it is the external handle)."),
 	localNamespace: z.boolean().optional().describe("When true, the scope creates a local namespace boundary — child node / coordinate / nested-scope ids registered inside do NOT propagate to the parent namespace; external lookups cannot see them. Default false (matches TikZ pgf default: child ids flow up to global). scope.id itself always registers in the parent frame regardless of this flag."),
 	transforms: z.array(TransformSchema).optional().describe("Local transforms applied to all scope children; array order = application order (first element applied innermost, matching Scene `GroupPrim.transforms` / SVG transform list). Supports 6 variants; the 4 translate variants are lowered to Cartesian translate at compile time."),
+	color: z.string().optional().describe("Cascading master color for all elements in this scope (TikZ scope `color=`). Stroke / fill / text of inner elements default to it unless individually overridden; cascades into edge labels and arrows."),
+	stroke: z.string().optional().describe("Cascading default stroke color for inner nodes and paths; overrides the cascading master color for the stroke channel."),
+	fill: z.string().optional().describe("Cascading default fill color for inner nodes and paths."),
+	strokeWidth: z.number().optional().describe("Cascading default stroke width (user units) for inner nodes and paths."),
+	opacity: z.number().min(0).max(1).optional().describe("Cascading default whole-element opacity 0..1. Replaces (does NOT compound across nested scopes — TikZ default)."),
+	fillOpacity: z.number().min(0).max(1).optional().describe("Cascading default fill opacity 0..1 for inner nodes and paths."),
+	drawOpacity: z.number().min(0).max(1).optional().describe("Cascading default stroke opacity 0..1 (TikZ `draw opacity`) for inner nodes and paths."),
+	nodeDefault: NodeDefaultSchema.optional().describe("Default style applied to every node in this scope (TikZ `every node`). Flat channel, independent from the other defaults."),
+	pathDefault: PathDefaultSchema.optional().describe("Default style applied to every path in this scope (TikZ `every path`); arrows use the separate arrowDefault channel."),
+	labelDefault: LabelDefaultSchema.optional().describe("Default style applied to every label (node label + step label) in this scope (TikZ `every label`)."),
+	arrowDefault: ArrowDefaultSchema.optional().describe("Default style applied to every arrow in this scope (TikZ `every arrow`)."),
+	resetStyle: z.union([z.boolean(), z.array(z.enum([
+		"node",
+		"path",
+		"label",
+		"arrow"
+	]))]).optional().describe("Inheritance barrier: drop the outer scope cascade + every-X defaults for the listed channels (or all when true), falling back to the built-in baseline. Only cuts the scope-inheritance axis; labels / arrows still follow their host path / node resolved color (structural relation, not scope inheritance)."),
 	children: z.array(z.lazy(() => {
 		if (!childSchemaRef) throw new Error("ScopeSchema: ChildSchema not registered yet; ensure scene.ts loaded");
 		return childSchemaRef;
 	})).describe("Scope children: nested nodes / paths / coordinates / scopes. Recursive via the parent ChildSchema (registered late to break the IRChild <-> IRScope cycle).")
-}).describe("Scope container: groups child IR elements and applies local transforms. Corresponds to TikZ `\\begin{scope}` (with optional `local bounding box=id` when id is set, and `name prefix`-like isolation when localNamespace is true).");
+}).describe("Scope container: groups child IR elements, applies local transforms, and acts as a style-default anchor (cascading graphic state + every-X defaults + resetStyle barrier). Corresponds to TikZ `\\begin{scope}`.");
 //#endregion
-export { ScopeSchema, __registerChildSchema };
+export { ArrowDefaultSchema, LabelDefaultSchema, NodeDefaultSchema, PathDefaultSchema, ScopeSchema, __registerChildSchema };

package/dist/lib/compile/compile.cjs

@@ -6,6 +6,7 @@ const require_node = require("./node.cjs");
 const require_text_metrics = require("./text-metrics.cjs");
 const require_index = require("./path/index.cjs");
 const require_precision = require("./precision.cjs");
+const require_style = require("./style.cjs");
 const require_layout = require("./layout.cjs");
 //#region src/compile/compile.ts
 /**
@@ -120,12 +121,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 = require_node.layoutNode(child, measureText, nameStack, nodeDistance, chain);
+				const layout = require_node.layoutNode(require_style.resolveNodeStyle(child, styleStack), measureText, nameStack, nodeDistance, chain, require_style.resolveLabelDefault(styleStack));
 				const globalLayout = chain.length === 0 ? layout : require_scope.projectLayoutToGlobal(layout, chain);
 				if (child.id) nameStack.register(child.id, globalLayout, `${locatorPrefix}children[${i}].node.id`);
 				for (const prim of require_node.emitNodePrimitives(layout, round)) sink.push(prim);
@@ -165,7 +167,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, require_style.buildStyleFrame(child)]);
 					if (child.id) {
 						const bbox = require_scope.computeScopeBoundingBox(innerLayouts);
 						const fallbackOrigin = innerChain.length === 0 ? [0, 0] : require_scope.applyTransformChain([0, 0], innerChain);
@@ -186,14 +188,14 @@ var compileToScene = (ir, options = {}) => {
 				if (hasOwnTransforms) group.transforms = [...ownTransforms];
 				sink.push(group);
 			} else pathsAccumulator.push({
-				path: child,
+				path: require_style.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/lib/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;AAoBhF,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,KA+MrE,CAAC"}

package/dist/lib/compile/node.cjs

@@ -154,7 +154,7 @@ 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) => {
 	const sx = node.xScale ?? node.scale ?? 1;
 	const sy = node.yScale ?? node.scale ?? 1;
 	const fontScale = Math.min(sx, sy);
@@ -233,12 +233,12 @@ 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 {

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

@@ -1,6 +1,6 @@
 import { Position } from '../geometry/point';
 import { Rect, RectAnchor } from '../geometry/rect';
-import { AtDirection, IRNode, NodeShape } from '../ir';
+import { AtDirection, IRLabelDefault, IRNode, NodeShape } from '../ir';
 import { ScenePrimitive, TextLine, Transform } from '../primitive';
 import { NameStack } from './name-stack';
 import { TextMeasurer } from './text-metrics';
@@ -99,7 +99,7 @@ export declare const angleBoundaryOf: (layout: NodeLayout, angleDeg: number) =>
  *   scope 局部度量），调用方负责后续 `projectLayoutToGlobal` / `applyTransformChain` 投回全局；
  *   笛卡尔字面量 `Position` 已在 scope 局部度量，行为延续 v0.1。
  */
-export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>) => NodeLayout;
+export declare const layoutNode: (node: IRNode, measureText: TextMeasurer, nameStack: NameStack, nodeDistance?: number, scopeChain?: ReadonlyArray<Transform>, labelDefault?: IRLabelDefault) => NodeLayout;
 /**
  * NodeLayout → Scene primitives
  * @description shape 主体按 shape 分发（rect/ellipse/path）；text 始终走 TextPrim；有旋转时外层 GroupPrim 用 `rotate(deg cx cy)` 统一包裹（text 必须靠 group 旋转）

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

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

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

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

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

@@ -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/lib/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/lib/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/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

@@ -30,6 +30,7 @@ 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;
@@ -48,14 +49,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;