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

package/dist/es/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/es/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/es/ir/node.js

@@ -2,6 +2,9 @@ import { PositionSchema } from "./position/position.js";
 import { PolarPositionSchema } from "./position/polar-position.js";
 import { AT_DIRECTIONS, AtPositionSchema } from "./position/at-position.js";
 import { OffsetPositionSchema } from "./position/offset-position.js";
+import { JsonObjectSchema } from "./json.js";
+import { ShapeRefSchema } from "./shape.js";
+import { BoundarySchema } from "./boundary.js";
 import { BetweenPositionSchema } from "./position/between-position.js";
 import { FontSchema } from "./font.js";
 import { PaintSpecSchema } from "./paint.js";
@@ -10,7 +13,7 @@ import { z } from "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 = z.object({
 var NodeSchema = z.object({
 	type: z.literal("node").describe("Discriminator marking this child as a node"),
 	id: z.string().min(1).optional().describe("Optional unique id; required if any path needs to reference this node by string"),
-	shape: 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: z.union([z.string().min(1), 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: 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: 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: z.union([
 		PositionSchema,
 		PolarPositionSchema,
@@ -72,7 +77,7 @@ var NodeSchema = z.object({
 	dashed: z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
 	dotted: z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
 	dashArray: z.array(z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
-	roundedCorners: z.number().nonnegative().optional().describe("Corner radius in user units; only effective on `rectangle` shape."),
+	cornerRadius: 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: z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
 	minimumSize: z.number().nonnegative().optional().describe("Symmetric alias for `minimumWidth` + `minimumHeight`; axis-specific fields take precedence."),

package/dist/es/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;