@retikz/core 0.1.0-alpha.0 → 0.1.0-alpha.2

package/dist/lib/geometry/ellipse.cjs

@@ -0,0 +1,86 @@
+//#region src/geometry/ellipse.ts
+var SQRT_HALF = Math.SQRT1_2;
+var localToWorld = (e, local) => {
+	const angle = e.rotate ?? 0;
+	if (angle === 0) return [e.x + local[0], e.y + local[1]];
+	const cos = Math.cos(angle);
+	const sin = Math.sin(angle);
+	return [e.x + local[0] * cos - local[1] * sin, e.y + local[0] * sin + local[1] * cos];
+};
+var worldToLocal = (e, world) => {
+	const tx = world[0] - e.x;
+	const ty = world[1] - e.y;
+	const angle = e.rotate ?? 0;
+	if (angle === 0) return [tx, ty];
+	const cos = Math.cos(angle);
+	const sin = Math.sin(angle);
+	return [tx * cos + ty * sin, -tx * sin + ty * cos];
+};
+/** 椭圆相关基础工具 */
+var ellipse = {
+	/** 中心 */
+	center: (e) => [e.x, e.y],
+	/** 判断点是否在椭圆内（含边界，考虑旋转） */
+	contains: (e, p) => {
+		const [lx, ly] = worldToLocal(e, p);
+		return lx * lx / (e.rx * e.rx) + ly * ly / (e.ry * e.ry) <= 1;
+	},
+	/**
+	* 9 个标准 anchor 的世界坐标。
+	* 对角 anchor（NE/NW/SE/SW）取参数曲线 t=π/4 处的点：
+	* (rx·cos(π/4), ry·sin(π/4)) = (rx/√2, ry/√2)。
+	* 这与 TikZ 椭圆对角 anchor 的"参数等分"约定一致。
+	*/
+	anchor: (e, name) => {
+		let lx = 0;
+		let ly = 0;
+		switch (name) {
+			case "center": break;
+			case "north":
+				ly = -e.ry;
+				break;
+			case "south":
+				ly = e.ry;
+				break;
+			case "east":
+				lx = e.rx;
+				break;
+			case "west":
+				lx = -e.rx;
+				break;
+			case "north-east":
+				lx = e.rx * SQRT_HALF;
+				ly = -e.ry * SQRT_HALF;
+				break;
+			case "north-west":
+				lx = -e.rx * SQRT_HALF;
+				ly = -e.ry * SQRT_HALF;
+				break;
+			case "south-east":
+				lx = e.rx * SQRT_HALF;
+				ly = e.ry * SQRT_HALF;
+				break;
+			case "south-west":
+				lx = -e.rx * SQRT_HALF;
+				ly = e.ry * SQRT_HALF;
+				break;
+		}
+		return localToWorld(e, [lx, ly]);
+	},
+	/**
+	* 从中心向 toward 方向画射线，求与椭圆的交点。
+	* 椭圆方程：(x/rx)² + (y/ry)² = 1。
+	* 沿方向 (lx, ly) 缩放 t 倍命中：t² × ((lx/rx)² + (ly/ry)²) = 1
+	* → t = 1 / √((lx/rx)² + (ly/ry)²)。
+	*/
+	boundaryPoint: (e, toward) => {
+		const [lx, ly] = worldToLocal(e, toward);
+		if (lx === 0 && ly === 0) return [e.x, e.y];
+		const a = lx / e.rx;
+		const b = ly / e.ry;
+		const t = 1 / Math.sqrt(a * a + b * b);
+		return localToWorld(e, [lx * t, ly * t]);
+	}
+};
+//#endregion
+exports.ellipse = ellipse;

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

@@ -0,0 +1,38 @@
+import { Position } from './point';
+/** 椭圆：几何中心 (x, y) + 半长轴 rx / 半短轴 ry + 可选旋转（弧度） */
+export type Ellipse = {
+    /** 中心横坐标 */
+    x: number;
+    /** 中心纵坐标 */
+    y: number;
+    /** 半长轴（沿本地 +x 方向） */
+    rx: number;
+    /** 半短轴（沿本地 +y 方向） */
+    ry: number;
+    /** 绕几何中心旋转弧度；省略或 0 表示不旋转 */
+    rotate?: number;
+};
+/** 椭圆 9 个标准 anchor 名（含义与 RECT_ANCHORS 一致） */
+export type EllipseAnchor = 'center' | 'north' | 'south' | 'east' | 'west' | 'north-east' | 'north-west' | 'south-east' | 'south-west';
+/** 椭圆相关基础工具 */
+export declare const ellipse: {
+    /** 中心 */
+    center: (e: Ellipse) => Position;
+    /** 判断点是否在椭圆内（含边界，考虑旋转） */
+    contains: (e: Ellipse, p: Position) => boolean;
+    /**
+     * 9 个标准 anchor 的世界坐标。
+     * 对角 anchor（NE/NW/SE/SW）取参数曲线 t=π/4 处的点：
+     * (rx·cos(π/4), ry·sin(π/4)) = (rx/√2, ry/√2)。
+     * 这与 TikZ 椭圆对角 anchor 的"参数等分"约定一致。
+     */
+    anchor: (e: Ellipse, name: EllipseAnchor) => Position;
+    /**
+     * 从中心向 toward 方向画射线，求与椭圆的交点。
+     * 椭圆方程：(x/rx)² + (y/ry)² = 1。
+     * 沿方向 (lx, ly) 缩放 t 倍命中：t² × ((lx/rx)² + (ly/ry)²) = 1
+     * → t = 1 / √((lx/rx)² + (ly/ry)²)。
+     */
+    boundaryPoint: (e: Ellipse, toward: Position) => Position;
+};
+//# sourceMappingURL=ellipse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../../src/geometry/ellipse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,kDAAkD;AAClD,MAAM,MAAM,OAAO,GAAG;IACpB,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,YAAY;IACZ,CAAC,EAAE,MAAM,CAAC;IACV,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAIF,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,MAAM,GACN,YAAY,GACZ,YAAY,GACZ,YAAY,GACZ,YAAY,CAAC;AAoBjB,eAAe;AACf,eAAO,MAAM,OAAO;IAClB,SAAS;gBACG,OAAO,KAAG,QAAQ;IAC9B,0BAA0B;kBACZ,OAAO,KAAK,QAAQ,KAAG,OAAO;IAI5C;;;;;OAKG;gBACS,OAAO,QAAQ,aAAa,KAAG,QAAQ;IAqCnD;;;;;OAKG;uBACgB,OAAO,UAAU,QAAQ,KAAG,QAAQ;CAQxD,CAAC"}

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

@@ -1,4 +1,7 @@
 export * from './point';
 export * from './rect';
+export * from './circle';
+export * from './ellipse';
+export * from './diamond';
 export * from './polar';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/geometry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/lib/index.cjs

@@ -1,22 +1,35 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_position = require("./ir/position/position.cjs");
 const require_polar_position = require("./ir/position/polar-position.cjs");
+const require_arrow = require("./ir/path/arrow.cjs");
 const require_target = require("./ir/path/target.cjs");
 const require_step = require("./ir/path/step.cjs");
 const require_path = require("./ir/path/path.cjs");
 const require_node = require("./ir/node.cjs");
 const require_scene = require("./ir/scene.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_text_metrics = require("./compile/text-metrics.cjs");
 const require_compile = require("./compile/compile.cjs");
 const require_parseWay = require("./parsers/parseWay.cjs");
 const require_polar = require("./geometry/polar.cjs");
 const require_point = require("./geometry/point.cjs");
+exports.ARROW_SHAPES = require_arrow.ARROW_SHAPES;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
 exports.ChildSchema = require_scene.ChildSchema;
+exports.CycleStepSchema = require_step.CycleStepSchema;
+exports.DrawWay = require_parseWay.DrawWay;
+exports.FoldStepSchema = require_step.FoldStepSchema;
+exports.FontSchema = require_node.FontSchema;
+exports.LineSpecSchema = require_node.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.NodeSchema = require_node.NodeSchema;
+exports.NodeTextSchema = require_node.NodeTextSchema;
 exports.PathSchema = require_path.PathSchema;
 exports.PolarPositionSchema = require_polar_position.PolarPositionSchema;
 exports.PositionSchema = require_position.PositionSchema;
@@ -24,7 +37,10 @@ exports.RECT_ANCHORS = require_rect.RECT_ANCHORS;
 exports.SceneSchema = require_scene.SceneSchema;
 exports.StepSchema = require_step.StepSchema;
 exports.TargetSchema = require_target.TargetSchema;
+exports.circle = require_circle.circle;
 exports.compileToScene = require_compile.compileToScene;
+exports.diamond = require_diamond.diamond;
+exports.ellipse = require_ellipse.ellipse;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;
 exports.parseWay = require_parseWay.parseWay;
 exports.point = require_point.point;

package/dist/lib/index.d.ts

@@ -6,13 +6,15 @@
  *
  * 本包零 React、零 DOM 依赖。
  */
-export { PositionSchema, PolarPositionSchema, TargetSchema, MoveStepSchema, LineStepSchema, StepSchema, NodeSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
-export type { IRPosition, IRTarget, IRMoveStep, IRLineStep, IRStep, IRNode, IRPath, IRChild, IR, } from './ir';
-export type { ScenePrimitive, RectPrim, TextPrim, PathPrim, GroupPrim, ViewBox, Scene, } from './primitive';
+export { PositionSchema, PolarPositionSchema, TargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, StepSchema, NodeSchema, FontSchema, NodeTextSchema, LineSpecSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
+export type { IRPosition, IRTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRStep, IRNode, IRFont, IRLineSpec, IRPath, IRChild, IR, ArrowShape, NodeShape, NodeTextAlign, } from './ir';
+export { ARROW_SHAPES, NODE_SHAPES, NODE_TEXT_ALIGNS } from './ir';
+export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, GroupPrim, ViewBox, Scene, } from './primitive';
 export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, } from './compile';
 export { fallbackMeasurer, compileToScene } from './compile';
-export type { WayItem, WayDSL } from './parsers';
-export { parseWay } from './parsers';
-export type { Position, Rect, RectAnchor, PolarPosition } from './geometry';
-export { point, rect, RECT_ANCHORS, polar } from './geometry';
+export type { WayItem, WayDSL, WayCycle, WayVia } from './parsers';
+export { parseWay, DrawWay } from './parsers';
+export type { Position, Rect, RectAnchor, Circle, CircleAnchor, Ellipse, EllipseAnchor, Diamond, DiamondAnchor, PolarPosition, } from './geometry';
+export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
+export type { ValueOf } 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;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,EAAE,GACH,MAAM,MAAM,CAAC;AAGd,YAAY,EACV,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAIrC,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,UAAU,EACV,MAAM,EACN,OAAO,EACP,EAAE,EACF,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAGnE,YAAY,EACV,cAAc,EACd,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,OAAO,EACP,KAAK,GACN,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG7D,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAI9C,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,UAAU,EACV,MAAM,EACN,YAAY,EACZ,OAAO,EACP,aAAa,EACb,OAAO,EACP,aAAa,EACb,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,MAAM,SAAS,CAAC"}

package/dist/lib/ir/node.cjs

@@ -2,18 +2,111 @@ const require_position = require("./position/position.cjs");
 const require_polar_position = require("./position/polar-position.cjs");
 let zod = require("zod");
 //#region src/ir/node.ts
+/**
+* 节点形状常量。值是 IR 中 `shape` 字段的字面字符串；
+* 用 const + ValueOf 派生（不用 TS enum）。
+*
+* - `rectangle`：矩形（默认；UML 类、流程图常规节点）
+* - `circle`：圆形（流程图起止、状态机）
+* - `ellipse`：椭圆（状态机、集合图）
+* - `diamond`：菱形（流程图判定）
+*
+* 每个 shape 的几何语义：node 的视觉边界包住"text 矩形 + padding"——
+* - rectangle: 视觉 rect = text rect
+* - circle:    外接圆，r = √(innerHalfW² + innerHalfH²)
+* - ellipse:   外接椭圆，rx = innerHalfW×√2、ry = innerHalfH×√2
+* - diamond:   外接菱形，halfA = 2×innerHalfW、halfB = 2×innerHalfH
+*/
+var NODE_SHAPES = {
+	rectangle: "rectangle",
+	circle: "circle",
+	ellipse: "ellipse",
+	diamond: "diamond"
+};
+/**
+* 节点字体规格——family / size / weight / style 全部可选；
+* 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
+*
+* 取代 alpha.1 的标量 `fontSize` 字段（已删）。
+*/
+var FontSchema = zod.z.object({
+	family: zod.z.string().optional().describe("CSS font-family string, e.g. \"serif\", \"monospace\", \"Inter, sans-serif\""),
+	size: zod.z.number().positive().optional().describe("Font size in user units; falls back to the renderer default when omitted"),
+	weight: zod.z.union([zod.z.enum(["normal", "bold"]), zod.z.number()]).optional().describe("CSS font-weight: keyword `normal` / `bold` or numeric 100..900"),
+	style: zod.z.enum([
+		"normal",
+		"italic",
+		"oblique"
+	]).optional().describe("CSS font-style")
+}).describe("Font properties for the node text label; all fields optional, nested object form (replaces the alpha.1 `fontSize` scalar).");
+/**
+* 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
+*
+* 行级覆盖只生效于本行的 `<tspan>`：
+* - `fill`：仅这一行颜色
+* - `opacity`：仅这一行 0~1 透明度
+* - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
+*
+* 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
+*/
+var LineSpecSchema = zod.z.union([zod.z.string(), zod.z.object({
+	text: zod.z.string().describe("Line content"),
+	fill: zod.z.string().optional().describe("Per-line text color; overrides block default"),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Per-line opacity 0..1"),
+	font: FontSchema.optional().describe("Per-line font overrides; missing fields inherit from block-level `font`")
+})]).describe("Single line of text: bare string for default styling, or an object with per-line `fill` / `opacity` / `font` overrides.");
+/**
+* 节点文本——单行字符串或非空多行数组（每元素一个 LineSpec）：
+* - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
+* - `['Line 1', 'Line 2']` 两行无样式覆盖
+* - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
+*
+* 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
+*/
+var NodeTextSchema = zod.z.union([zod.z.string(), zod.z.array(LineSpecSchema).min(1)]).describe("Text label rendered inside the node: a single string for one line, or a non-empty array of line specs (string for default, object for per-line overrides).");
+/** 节点文本对齐（多行内文本对齐）——TikZ `align=` 同义词 */
+var NODE_TEXT_ALIGNS = {
+	left: "left",
+	center: "center",
+	right: "right"
+};
 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)."),
 	position: zod.z.union([require_position.PositionSchema, require_polar_position.PolarPositionSchema]).describe("Center point of the node content box; Cartesian [x, y] or polar (resolved at compile time)"),
 	rotate: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: zod.z.string().optional().describe("Text label rendered inside the node; omit for an empty node"),
-	fill: zod.z.string().optional().describe("Background color of the node rectangle; any CSS color (e.g. \"lightblue\", \"#fafafa\", \"rgba(...)\")"),
-	stroke: zod.z.string().optional().describe("Border color of the node rectangle; any CSS color. Defaults to currentColor when omitted"),
+	text: NodeTextSchema.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."),
+	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"),
+	drawOpacity: zod.z.number().min(0).max(1).optional().describe("Stroke opacity 0..1 (TikZ `draw opacity`); affects only the border."),
 	strokeWidth: zod.z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
-	padding: zod.z.number().optional().describe("Inner padding in user units between the text content and the node border"),
-	margin: zod.z.number().nonnegative().optional().describe("Outer margin in user units: distance between the visual border and where paths attach. Lines stop this far from the border. Defaults to 0."),
-	fontSize: zod.z.number().optional().describe("Text font size in user units; defaults to a fixed size for now (TikZ font sizes will be supported later)")
-}).describe("Rectangle node with optional text label; the basic positional drawing primitive");
+	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
+	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
+	dashArray: zod.z.string().optional().describe("Explicit SVG stroke-dasharray value (e.g. \"4 2\"); overrides `dashed` / `dotted`."),
+	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape (rx / ry on `<rect>`)."),
+	minimumWidth: zod.z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
+	minimumHeight: zod.z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
+	minimumSize: zod.z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),
+	scale: zod.z.number().positive().optional().describe("Uniform scale factor; multiplies all node dimensions (border, padding, text, fontSize) at layout time. Affects path attachment positions."),
+	xScale: zod.z.number().positive().optional().describe("Horizontal scale factor; overrides `scale` for the X axis."),
+	yScale: zod.z.number().positive().optional().describe("Vertical scale factor; overrides `scale` for the Y axis."),
+	textColor: zod.z.string().optional().describe("Text label color; any CSS color. Defaults to `currentColor`."),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Whole-node opacity 0..1; applies uniformly to shape and text."),
+	innerXSep: zod.z.number().nonnegative().optional().describe("Inner horizontal padding from text to border in user units. Falls back to `padding` then default."),
+	innerYSep: zod.z.number().nonnegative().optional().describe("Inner vertical padding from text to border in user units. Falls back to `padding` then default."),
+	outerSep: zod.z.number().nonnegative().optional().describe("Outer margin from border to path attachment point in user units; does NOT change the visible border. Falls back to `margin`."),
+	padding: zod.z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
+	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
+	font: FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults.")
+}).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
+exports.FontSchema = FontSchema;
+exports.LineSpecSchema = LineSpecSchema;
+exports.NODE_SHAPES = NODE_SHAPES;
+exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
 exports.NodeSchema = NodeSchema;
+exports.NodeTextSchema = NodeTextSchema;