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

package/dist/lib/geometry/segment.cjs

@@ -0,0 +1,88 @@
+//#region src/geometry/segment.ts
+var DEG_TO_RAD = Math.PI / 180;
+var normalize = (v) => {
+	const len = Math.hypot(v[0], v[1]);
+	if (len === 0) return [1, 0];
+	return [v[0] / len, v[1] / len];
+};
+/** 直线段 from → to */
+var lineSegmentSample = (from, to, t) => ({
+	point: [from[0] + (to[0] - from[0]) * t, from[1] + (to[1] - from[1]) * t],
+	tangent: normalize([to[0] - from[0], to[1] - from[1]])
+});
+/**
+* 二次贝塞尔 from → control → to。
+* P(t)  = (1-t)²·P0 + 2(1-t)t·P1 + t²·P2
+* P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
+*/
+var quadSegmentSample = (from, control, to, t) => {
+	const u = 1 - t;
+	return {
+		point: [u * u * from[0] + 2 * u * t * control[0] + t * t * to[0], u * u * from[1] + 2 * u * t * control[1] + t * t * to[1]],
+		tangent: normalize([2 * u * (control[0] - from[0]) + 2 * t * (to[0] - control[0]), 2 * u * (control[1] - from[1]) + 2 * t * (to[1] - control[1])])
+	};
+};
+/**
+* 三次贝塞尔 from → c1 → c2 → to。
+* P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
+*/
+var cubicSegmentSample = (from, c1, c2, to, t) => {
+	const u = 1 - t;
+	return {
+		point: [u * u * u * from[0] + 3 * u * u * t * c1[0] + 3 * u * t * t * c2[0] + t * t * t * to[0], u * u * u * from[1] + 3 * u * u * t * c1[1] + 3 * u * t * t * c2[1] + t * t * t * to[1]],
+		tangent: normalize([3 * u * u * (c1[0] - from[0]) + 6 * u * t * (c2[0] - c1[0]) + 3 * t * t * (to[0] - c2[0]), 3 * u * u * (c1[1] - from[1]) + 6 * u * t * (c2[1] - c1[1]) + 3 * t * t * (to[1] - c2[1])])
+	};
+};
+/**
+* 折角段 from → corner → to。
+* t∈[0, 0.5] 走第一段（参数 2t）；t∈(0.5, 1] 走第二段（参数 2t-1）。
+* t=0.5 落在 corner，切线取第一段方向（与"靠近 prev 一侧"一致）。
+*/
+var foldSegmentSample = (from, corner, to, t) => {
+	if (t <= .5) return lineSegmentSample(from, corner, t * 2);
+	return lineSegmentSample(corner, to, t * 2 - 1);
+};
+/**
+* 弧段（与 ir/path arc 同约定，角度单位为度）。
+* 切线沿"扫描方向"——endAngle ≥ startAngle 时为 (-sin, cos)，否则反向。
+*/
+var arcSegmentSample = (center, radius, startAngleDeg, endAngleDeg, t) => {
+	const rad = (startAngleDeg + t * (endAngleDeg - startAngleDeg)) * DEG_TO_RAD;
+	const cos = Math.cos(rad);
+	const sin = Math.sin(rad);
+	const sweepSign = endAngleDeg >= startAngleDeg ? 1 : -1;
+	return {
+		point: [center[0] + radius * cos, center[1] + radius * sin],
+		tangent: normalize([-sin * sweepSign, cos * sweepSign])
+	};
+};
+/**
+* 整圆——从 0°（east）开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致。
+*/
+var circleSegmentSample = (center, radius, t) => {
+	const rad = t * 360 * DEG_TO_RAD;
+	const cos = Math.cos(rad);
+	const sin = Math.sin(rad);
+	return {
+		point: [center[0] + radius * cos, center[1] + radius * sin],
+		tangent: normalize([-sin, cos])
+	};
+};
+/** 整椭圆——参数化 (rx·cos(2πt), ry·sin(2πt)) */
+var ellipseSegmentSample = (center, rx, ry, t) => {
+	const rad = t * 360 * DEG_TO_RAD;
+	const cos = Math.cos(rad);
+	const sin = Math.sin(rad);
+	return {
+		point: [center[0] + rx * cos, center[1] + ry * sin],
+		tangent: normalize([-rx * sin, ry * cos])
+	};
+};
+//#endregion
+exports.arcSegmentSample = arcSegmentSample;
+exports.circleSegmentSample = circleSegmentSample;
+exports.cubicSegmentSample = cubicSegmentSample;
+exports.ellipseSegmentSample = ellipseSegmentSample;
+exports.foldSegmentSample = foldSegmentSample;
+exports.lineSegmentSample = lineSegmentSample;
+exports.quadSegmentSample = quadSegmentSample;

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

@@ -0,0 +1,38 @@
+import { Position } from './point';
+export type SegmentSample = {
+    /** t 处的点坐标 */
+    point: Position;
+    /** t 处的切线方向（单位向量；零向量时回退到 [1, 0]） */
+    tangent: Position;
+};
+/** 直线段 from → to */
+export declare const lineSegmentSample: (from: Position, to: Position, t: number) => SegmentSample;
+/**
+ * 二次贝塞尔 from → control → to。
+ * P(t)  = (1-t)²·P0 + 2(1-t)t·P1 + t²·P2
+ * P'(t) = 2(1-t)(P1-P0) + 2t(P2-P1)
+ */
+export declare const quadSegmentSample: (from: Position, control: Position, to: Position, t: number) => SegmentSample;
+/**
+ * 三次贝塞尔 from → c1 → c2 → to。
+ * P'(t) = 3(1-t)²(P1-P0) + 6(1-t)t(P2-P1) + 3t²(P3-P2)
+ */
+export declare const cubicSegmentSample: (from: Position, c1: Position, c2: Position, to: Position, t: number) => SegmentSample;
+/**
+ * 折角段 from → corner → to。
+ * t∈[0, 0.5] 走第一段（参数 2t）；t∈(0.5, 1] 走第二段（参数 2t-1）。
+ * t=0.5 落在 corner，切线取第一段方向（与"靠近 prev 一侧"一致）。
+ */
+export declare const foldSegmentSample: (from: Position, corner: Position, to: Position, t: number) => SegmentSample;
+/**
+ * 弧段（与 ir/path arc 同约定，角度单位为度）。
+ * 切线沿"扫描方向"——endAngle ≥ startAngle 时为 (-sin, cos)，否则反向。
+ */
+export declare const arcSegmentSample: (center: Position, radius: number, startAngleDeg: number, endAngleDeg: number, t: number) => SegmentSample;
+/**
+ * 整圆——从 0°（east）开始，与 compile/path circlePath 输出方向（右→左→右，sweep=1）一致。
+ */
+export declare const circleSegmentSample: (center: Position, radius: number, t: number) => SegmentSample;
+/** 整椭圆——参数化 (rx·cos(2πt), ry·sin(2πt)) */
+export declare const ellipseSegmentSample: (center: Position, rx: number, ry: number, t: number) => SegmentSample;
+//# sourceMappingURL=segment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../../src/geometry/segment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAuBxC,MAAM,MAAM,aAAa,GAAG;IAC1B,cAAc;IACd,KAAK,EAAE,QAAQ,CAAC;IAChB,oCAAoC;IACpC,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAQF,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,SAAS,QAAQ,EACjB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aASF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,MAAM,QAAQ,EACd,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAqBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,QAAQ,EACd,QAAQ,QAAQ,EAChB,IAAI,QAAQ,EACZ,GAAG,MAAM,KACR,aAGF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,aAAa,MAAM,EACnB,GAAG,MAAM,KACR,aAUF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,QAAQ,EAChB,QAAQ,MAAM,EACd,GAAG,MAAM,KACR,aASF,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,QAAQ,EAChB,IAAI,MAAM,EACV,IAAI,MAAM,EACV,GAAG,MAAM,KACR,aASF,CAAC"}

package/dist/lib/index.cjs

@@ -13,14 +13,22 @@ 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_parseTargetSugar = require("./parsers/parseTargetSugar.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.ArcStepSchema = require_step.ArcStepSchema;
+exports.BendStepSchema = require_step.BendStepSchema;
 exports.CURRENT_IR_VERSION = require_scene.CURRENT_IR_VERSION;
 exports.ChildSchema = require_scene.ChildSchema;
+exports.CirclePathStepSchema = require_step.CirclePathStepSchema;
+exports.ControlPointSchema = require_step.ControlPointSchema;
+exports.CubicStepSchema = require_step.CubicStepSchema;
+exports.CurveStepSchema = require_step.CurveStepSchema;
 exports.CycleStepSchema = require_step.CycleStepSchema;
 exports.DrawWay = require_parseWay.DrawWay;
+exports.EllipsePathStepSchema = require_step.EllipsePathStepSchema;
 exports.FoldStepSchema = require_step.FoldStepSchema;
 exports.FontSchema = require_node.FontSchema;
 exports.LineSpecSchema = require_node.LineSpecSchema;
@@ -34,7 +42,10 @@ exports.PathSchema = require_path.PathSchema;
 exports.PolarPositionSchema = require_polar_position.PolarPositionSchema;
 exports.PositionSchema = require_position.PositionSchema;
 exports.RECT_ANCHORS = require_rect.RECT_ANCHORS;
+exports.RelAccumulateTargetSchema = require_target.RelAccumulateTargetSchema;
+exports.RelTargetSchema = require_target.RelTargetSchema;
 exports.SceneSchema = require_scene.SceneSchema;
+exports.StepLabelSchema = require_step.StepLabelSchema;
 exports.StepSchema = require_step.StepSchema;
 exports.TargetSchema = require_target.TargetSchema;
 exports.circle = require_circle.circle;
@@ -42,6 +53,7 @@ exports.compileToScene = require_compile.compileToScene;
 exports.diamond = require_diamond.diamond;
 exports.ellipse = require_ellipse.ellipse;
 exports.fallbackMeasurer = require_text_metrics.fallbackMeasurer;
+exports.parseTargetSugar = require_parseTargetSugar.parseTargetSugar;
 exports.parseWay = require_parseWay.parseWay;
 exports.point = require_point.point;
 exports.polar = require_polar.polar;

package/dist/lib/index.d.ts

@@ -6,14 +6,14 @@
  *
  * 本包零 React、零 DOM 依赖。
  */
-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 { PositionSchema, PolarPositionSchema, TargetSchema, RelTargetSchema, RelAccumulateTargetSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, FontSchema, NodeTextSchema, LineSpecSchema, PathSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, } from './ir';
+export type { IRPosition, IRTarget, IRRelTarget, IRRelAccumulateTarget, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRControlPoint, IRStepLabel, 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, WayCycle, WayVia } from './parsers';
-export { parseWay, DrawWay } from './parsers';
+export type { WayItem, WayDSL, WayCycle, WayVia, WayRelItem, WayLabel, WayLabelOp, } from './parsers';
+export { parseWay, DrawWay, parseTargetSugar } 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';

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,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,yBAAyB,EACzB,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,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,GACnB,MAAM,MAAM,CAAC;AACd,YAAY,EACV,UAAU,EACV,QAAQ,EACR,WAAW,EACX,qBAAqB,EACrB,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,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,EACV,OAAO,EACP,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,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,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.d.ts

@@ -257,9 +257,6 @@ export declare const NodeSchema: z.ZodObject<{
     type: "node";
     position: [number, number] | import('./position').PolarPosition;
     fill?: string | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
-    stroke?: string | undefined;
-    strokeWidth?: number | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -271,7 +268,12 @@ export declare const NodeSchema: z.ZodObject<{
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
     })[] | undefined;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    stroke?: string | undefined;
+    strokeWidth?: number | undefined;
     opacity?: number | undefined;
+    fillOpacity?: number | undefined;
+    drawOpacity?: number | undefined;
     font?: {
         family?: string | undefined;
         size?: number | undefined;
@@ -280,10 +282,8 @@ export declare const NodeSchema: z.ZodObject<{
     } | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "left" | "right" | "center" | undefined;
     lineHeight?: number | undefined;
-    fillOpacity?: number | undefined;
-    drawOpacity?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
     dashArray?: string | undefined;
@@ -304,9 +304,6 @@ export declare const NodeSchema: z.ZodObject<{
     type: "node";
     position: [number, number] | import('./position').PolarPosition;
     fill?: string | undefined;
-    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
-    stroke?: string | undefined;
-    strokeWidth?: number | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -318,7 +315,12 @@ export declare const NodeSchema: z.ZodObject<{
             style?: "normal" | "italic" | "oblique" | undefined;
         } | undefined;
     })[] | undefined;
+    shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
+    stroke?: string | undefined;
+    strokeWidth?: number | undefined;
     opacity?: number | undefined;
+    fillOpacity?: number | undefined;
+    drawOpacity?: number | undefined;
     font?: {
         family?: string | undefined;
         size?: number | undefined;
@@ -327,10 +329,8 @@ export declare const NodeSchema: z.ZodObject<{
     } | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
-    align?: "left" | "center" | "right" | undefined;
+    align?: "left" | "right" | "center" | undefined;
     lineHeight?: number | undefined;
-    fillOpacity?: number | undefined;
-    drawOpacity?: number | undefined;
     dashed?: boolean | undefined;
     dotted?: boolean | undefined;
     dashArray?: string | undefined;

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

@@ -16,6 +16,28 @@ var PathSchema = zod.z.object({
 	arrowShape: zod.z.nativeEnum(require_arrow.ARROW_SHAPES).optional().describe("Arrow tip shape; default `normal` (filled triangle). Other values: `open` (hollow triangle), `stealth` (sharp barb), `diamond`, `circle`."),
 	fill: zod.z.string().optional().describe("Fill color of the closed region; any CSS color. Omitted = no fill (stroke only). Pairs with `cycle` step for filled shapes."),
 	fillRule: zod.z.enum(["nonzero", "evenodd"]).optional().describe("How self-intersecting / nested sub-paths are filled. `nonzero` (default, SVG default) winds-by-direction; `evenodd` toggles fill on each crossing — useful for ring / donut shapes."),
+	lineCap: zod.z.enum([
+		"butt",
+		"round",
+		"square"
+	]).optional().describe("Stroke endpoint shape (SVG `stroke-linecap`). Default `butt` (sharp end); `round` adds a half-disc cap; `square` extends a half-stroke past the endpoint."),
+	lineJoin: zod.z.enum([
+		"miter",
+		"round",
+		"bevel"
+	]).optional().describe("Stroke corner shape (SVG `stroke-linejoin`). Default `miter` (sharp corner); `round` rounds the join; `bevel` cuts the corner flat."),
+	thickness: zod.z.enum([
+		"ultraThin",
+		"veryThin",
+		"thin",
+		"semithick",
+		"thick",
+		"veryThick",
+		"ultraThick"
+	]).optional().describe("Semantic stroke thickness preset (TikZ `ultra thin` … `ultra thick`). Compiled to a numeric stroke-width if `strokeWidth` is omitted. Explicit `strokeWidth` always wins."),
+	opacity: zod.z.number().min(0).max(1).optional().describe("Whole-path opacity 0..1; multiplies onto stroke and fill."),
+	fillOpacity: zod.z.number().min(0).max(1).optional().describe("Fill opacity 0..1; affects only the closed-region fill."),
+	drawOpacity: zod.z.number().min(0).max(1).optional().describe("Stroke opacity 0..1 (TikZ `draw opacity`); affects only the path stroke."),
 	children: zod.z.array(require_step.StepSchema).min(2).describe("Sequence of step actions defining the path; the first should usually be a `move`")
 }).describe("A drawn path composed of a sequence of step actions (move / line / ...)");
 //#endregion