@retikz/core 0.3.0-alpha.3 → 0.3.0-alpha.4

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

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { ValueOf } from '../types';
+/** 连接面引用：保留字 'shape'/'circle' 或借用已注册 shape（裸名 / {type, params}） */
+export declare const BoundarySchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    type: z.ZodString;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>>>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    params?: Record<string, import('./json').JsonValue> | undefined;
+}, {
+    type: string;
+    params?: Record<string, import('./json').JsonValue> | undefined;
+}>]>;
+/** 连接面引用类型（'shape' | 'circle' | 其它 shape 名 | {type, params}） */
+export type IRBoundary = z.infer<typeof BoundarySchema>;
+/** 连接面保留关键字：非「借用已注册 shape」的两个内置语义（编译期消解） */
+export declare const Boundary: {
+    /** 连接面 = 节点自身视觉形状（默认） */
+    readonly Self: "shape";
+    /** 真圆：半径 = 节点 AABB 较长半轴 max(halfWidth, halfHeight) */
+    readonly Circle: "circle";
+};
+/** 连接面保留关键字联合（'shape' | 'circle'；其余取值为借用的 shape 引用） */
+export type BoundaryKeyword = ValueOf<typeof Boundary>;
+//# sourceMappingURL=boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/ir/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,mEAAmE;AACnE,eAAO,MAAM,cAAc;;;;;;;;;IAIxB,CAAC;AAEJ,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ;IACnB,yBAAyB;;IAEzB,sDAAsD;;CAE9C,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC"}

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

@@ -5,6 +5,8 @@ export * from './paint';
 export * from './clip';
 export * from './text';
 export * from './path';
+export * from './shape';
+export * from './boundary';
 export * from './node';
 export * from './coordinate';
 export * from './transform';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/lib/ir/node.cjs

@@ -2,6 +2,9 @@ const require_position = require("./position/position.cjs");
 const require_polar_position = require("./position/polar-position.cjs");
 const require_at_position = require("./position/at-position.cjs");
 const require_offset_position = require("./position/offset-position.cjs");
+const require_json = require("./json.cjs");
+const require_shape = require("./shape.cjs");
+const require_boundary = require("./boundary.cjs");
 const require_between_position = require("./position/between-position.cjs");
 const require_font = require("./font.cjs");
 const require_paint = require("./paint.cjs");
@@ -10,7 +13,7 @@ let zod = require("zod");
 //#region src/ir/node.ts
 /**
 * 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
-* @description rectangle 默认；circle/ellipse/diamond 几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；circle: r=√(innerHalfW²+innerHalfH²)；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2；diamond: halfA=2×innerHalfW,halfB=2×innerHalfH
+* @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 45° preset 别名（`{ type:'polygon', params:{ sides:4, rotate:45 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
 */
 var NODE_SHAPES = {
 	rectangle: "rectangle",
@@ -50,7 +53,9 @@ 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.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)."),
+	shape: zod.z.union([zod.z.string().min(1), require_shape.ShapeRefSchema]).optional().describe("Node visual shape: a bare name string (parameterless, e.g. \"rectangle\") or `{ type, params }` carrying a JSON params object (e.g. `{ type:\"sector\", params:{ innerRadius, outerRadius, startAngle, endAngle } }`). Built-in or registered via CompileOptions.shapes; unregistered type rejected at compile time. Defaults to \"rectangle\"."),
+	boundary: require_boundary.BoundarySchema.optional().describe("Default connection surface for edges meeting this node (see BoundarySchema). Defaults to \"shape\" (use the visual shape). Per-edge overridable via the edge endpoint `boundary` field."),
+	meta: require_json.JsonObjectSchema.optional().describe("Opaque provenance metadata carried by this element (e.g. a Tier 2 lowering tagging which datum / series / layer it came from). Provenance passthrough: preserved verbatim into the Scene primitive(s) this element emits, ignored by renderers, and never interpreted by the compiler — it does not affect layout, connection, style, or bounding box. Must be a JSON object (fully serializable). Not inherited across scopes; not part of the every-X style defaults."),
 	position: zod.z.union([
 		require_position.PositionSchema,
 		require_polar_position.PolarPositionSchema,
@@ -72,7 +77,7 @@ var NodeSchema = zod.z.object({
 	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.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
-	roundedCorners: zod.z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape."),
+	cornerRadius: zod.z.number().nonnegative().optional().describe("Migration-period top-level corner radius in user units; only effective on `rectangle` shape. Prefer the shape params form `{ type: \"rectangle\", params: { cornerRadius } }`."),
 	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."),

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

@@ -2,7 +2,7 @@ import { z } from 'zod';
 import { ValueOf } from '../types';
 /**
  * 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
- * @description rectangle 默认；circle/ellipse/diamond 几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；circle: r=√(innerHalfW²+innerHalfH²)；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2；diamond: halfA=2×innerHalfW,halfB=2×innerHalfH
+ * @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 45° preset 别名（`{ type:'polygon', params:{ sides:4, rotate:45 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
  */
 export declare const NODE_SHAPES: {
     readonly rectangle: "rectangle";
@@ -122,7 +122,27 @@ 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.ZodString>;
+    shape: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    }, {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    }>]>>;
+    boundary: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        type: z.ZodString;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>>>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    }, {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    }>]>>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>>>;
     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";
@@ -315,7 +335,7 @@ export declare const NodeSchema: z.ZodObject<{
     dashed: z.ZodOptional<z.ZodBoolean>;
     dotted: z.ZodOptional<z.ZodBoolean>;
     dashArray: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-    roundedCorners: z.ZodOptional<z.ZodNumber>;
+    cornerRadius: z.ZodOptional<z.ZodNumber>;
     minimumWidth: z.ZodOptional<z.ZodNumber>;
     minimumHeight: z.ZodOptional<z.ZodNumber>;
     minimumSize: z.ZodOptional<z.ZodNumber>;
@@ -555,10 +575,17 @@ export declare const NodeSchema: z.ZodObject<{
         href: string;
         fit?: "fill" | "contain" | "cover" | undefined;
     } | undefined;
+    shape?: string | {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    } | undefined;
     id?: string | undefined;
+    boundary?: string | {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    } | undefined;
     color?: string | undefined;
     opacity?: number | undefined;
-    shape?: string | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -617,7 +644,8 @@ export declare const NodeSchema: z.ZodObject<{
             dashPattern?: number[] | undefined;
         } | undefined;
     }[] | undefined;
-    roundedCorners?: number | undefined;
+    cornerRadius?: number | undefined;
+    meta?: Record<string, import('./json').JsonValue> | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
     fillOpacity?: number | undefined;
@@ -680,10 +708,17 @@ export declare const NodeSchema: z.ZodObject<{
         href: string;
         fit?: "fill" | "contain" | "cover" | undefined;
     } | undefined;
+    shape?: string | {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    } | undefined;
     id?: string | undefined;
+    boundary?: string | {
+        type: string;
+        params?: Record<string, import('./json').JsonValue> | undefined;
+    } | undefined;
     color?: string | undefined;
     opacity?: number | undefined;
-    shape?: string | undefined;
     text?: string | (string | {
         text: string;
         fill?: string | undefined;
@@ -742,7 +777,8 @@ export declare const NodeSchema: z.ZodObject<{
             dashPattern?: number[] | undefined;
         } | undefined;
     }[] | undefined;
-    roundedCorners?: number | undefined;
+    cornerRadius?: number | undefined;
+    meta?: Record<string, import('./json').JsonValue> | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
     fillOpacity?: number | 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;AAMxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2DzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6MpB,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;AASxC;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2DzB,CAAC;AAEJ,uBAAuB;AACvB,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoNpB,CAAC;AAEJ,sCAAsC;AACtC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}

package/dist/lib/ir/path/arrow.d.ts

@@ -54,18 +54,18 @@ export declare const ArrowEndDetailSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    shape?: string | undefined;
     color?: string | undefined;
     opacity?: number | undefined;
-    shape?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
     scale?: number | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    shape?: string | undefined;
     color?: string | undefined;
     opacity?: number | undefined;
-    shape?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
     scale?: number | undefined;
@@ -96,18 +96,18 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
@@ -124,18 +124,18 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
@@ -143,18 +143,18 @@ export declare const ArrowDetailSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    shape?: string | undefined;
     color?: string | undefined;
     opacity?: number | undefined;
-    shape?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
     scale?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
@@ -162,9 +162,9 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
@@ -172,18 +172,18 @@ export declare const ArrowDetailSchema: z.ZodObject<{
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    shape?: string | undefined;
     color?: string | undefined;
     opacity?: number | undefined;
-    shape?: string | undefined;
     lineWidth?: number | undefined;
     width?: number | undefined;
     scale?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;
@@ -191,9 +191,9 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        shape?: string | undefined;
         color?: string | undefined;
         opacity?: number | undefined;
-        shape?: string | undefined;
         lineWidth?: number | undefined;
         width?: number | undefined;
         scale?: number | undefined;

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

@@ -1,3 +1,4 @@
+const require_json = require("../json.cjs");
 const require_paint = require("../paint.cjs");
 const require_arrow = require("./arrow.cjs");
 const require_step = require("./step.cjs");
@@ -20,6 +21,7 @@ var ArrowMarkSchema = require_arrow.ArrowEndDetailSchema.extend({ kind: zod.z.li
 var PathSchema = zod.z.object({
 	type: zod.z.literal("path").describe("Discriminator marking this child as a path"),
 	id: zod.z.string().min(1).optional().describe("Optional stable id; required if another path needs to reference this path by string, and used as the hydration hook so client-side event handlers can be bound to the primitives this path emits."),
+	meta: require_json.JsonObjectSchema.optional().describe("Opaque provenance metadata carried by this element (e.g. a Tier 2 lowering tagging which datum / series / layer it came from). Provenance passthrough: preserved verbatim into the Scene primitive(s) this element emits, ignored by renderers, and never interpreted by the compiler — it does not affect layout, connection, style, or bounding box. Must be a JSON object (fully serializable). Not inherited across scopes; not part of the every-X style defaults."),
 	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"),