@retikz/core 0.2.0-alpha.6 → 0.2.0-alpha.8

package/dist/es/ir/paint.d.ts

@@ -0,0 +1,154 @@
+import { z } from 'zod';
+import { ValueOf } from '../types';
+/**
+ * 内置 pattern motif 名常量（用 const + ValueOf 派生，不用 TS enum）
+ * @description 内置 3 motif：`lines`（横向阴影线）/ `dots`（波点）/ `grid`（横竖网格）。
+ *   各 motif 的 tile 几何由 `BUILTIN_PATTERNS` 的 `PatternDefinition.emit` 在 compile 期产出。
+ */
+export declare const PATTERN_SHAPES: {
+    readonly lines: "lines";
+    readonly dots: "dots";
+    readonly grid: "grid";
+};
+/**
+ * 内置 3 pattern motif 名联合
+ * @description `BUILTIN_PATTERNS` 的 Record key（保穷尽性约束，不随 `PatternShapeName` 开放而退化为 `string`）
+ */
+export type BuiltinPatternName = ValueOf<typeof PATTERN_SHAPES>;
+/**
+ * pattern motif 名：开放字符串
+ * @description 内置 `BuiltinPatternName`，或经 `CompileOptions.patterns` 注册的扩展 motif 名；
+ *   `& {}` 让 IDE 仍对内置 3 名自动补全，同时接受任意非空字符串
+ */
+export type PatternShapeName = BuiltinPatternName | (string & {});
+/**
+ * 渐变 stop：位置 + 颜色 + 可选透明度
+ * @description offset 0..1（沿渐变轴的位置）；color 任意 CSS 颜色（含 `currentColor` 主题反应）；opacity 0..1。
+ */
+export declare const GradientStopSchema: z.ZodObject<{
+    offset: z.ZodNumber;
+    color: z.ZodString;
+    opacity: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    offset: number;
+    color: string;
+    opacity?: number | undefined;
+}, {
+    offset: number;
+    color: string;
+    opacity?: number | undefined;
+}>;
+/**
+ * Paint server 规格（渐变 / 图案 / 图片）；纯色仍是 `fill` / `stroke` 上的 string，不进此 schema
+ * @description 四种 paint server：linear / radial gradient、pattern（图案）、image（图片）。纯 JSON 形态，保 IR 可序列化。
+ *   linear 方向用 `angle`（度，polar 约定：0°=+x，90°=+y 屏幕下）；radial 的 `center` / `radius` 用 objectBoundingBox（0..1，随形状缩放）。
+ */
+export declare const PaintSpecSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"linearGradient">;
+    stops: z.ZodArray<z.ZodObject<{
+        offset: z.ZodNumber;
+        color: z.ZodString;
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }>, "many">;
+    angle: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "linearGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    angle?: number | undefined;
+}, {
+    type: "linearGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    angle?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"radialGradient">;
+    stops: z.ZodArray<z.ZodObject<{
+        offset: z.ZodNumber;
+        color: z.ZodString;
+        opacity: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }, {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }>, "many">;
+    center: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    radius: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "radialGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    radius?: number | undefined;
+    center?: [number, number] | undefined;
+}, {
+    type: "radialGradient";
+    stops: {
+        offset: number;
+        color: string;
+        opacity?: number | undefined;
+    }[];
+    radius?: number | undefined;
+    center?: [number, number] | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"pattern">;
+    shape: z.ZodString;
+    color: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    lineWidth: z.ZodOptional<z.ZodNumber>;
+    rotation: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "pattern";
+    shape: string;
+    size?: number | undefined;
+    color?: string | undefined;
+    background?: string | undefined;
+    lineWidth?: number | undefined;
+    rotation?: number | undefined;
+}, {
+    type: "pattern";
+    shape: string;
+    size?: number | undefined;
+    color?: string | undefined;
+    background?: string | undefined;
+    lineWidth?: number | undefined;
+    rotation?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    href: z.ZodString;
+    fit: z.ZodOptional<z.ZodEnum<["fill", "contain", "cover"]>>;
+}, "strip", z.ZodTypeAny, {
+    type: "image";
+    href: string;
+    fit?: "fill" | "contain" | "cover" | undefined;
+}, {
+    type: "image";
+    href: string;
+    fit?: "fill" | "contain" | "cover" | undefined;
+}>]>;
+/** 渐变 stop 类型 */
+export type IRGradientStop = z.infer<typeof GradientStopSchema>;
+/** Paint server 规格类型（渐变 / 图案 / 图片） */
+export type IRPaintSpec = z.infer<typeof PaintSpecSchema>;
+//# sourceMappingURL=paint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../../src/ir/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,cAAc,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAMY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsEwF,CAAC;AAErH,iBAAiB;AACjB,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/es/ir/paint.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+//#region src/ir/paint.ts
+/**
+* 内置 pattern motif 名常量（用 const + ValueOf 派生，不用 TS enum）
+* @description 内置 3 motif：`lines`（横向阴影线）/ `dots`（波点）/ `grid`（横竖网格）。
+*   各 motif 的 tile 几何由 `BUILTIN_PATTERNS` 的 `PatternDefinition.emit` 在 compile 期产出。
+*/
+var PATTERN_SHAPES = {
+	lines: "lines",
+	dots: "dots",
+	grid: "grid"
+};
+/**
+* 渐变 stop：位置 + 颜色 + 可选透明度
+* @description offset 0..1（沿渐变轴的位置）；color 任意 CSS 颜色（含 `currentColor` 主题反应）；opacity 0..1。
+*/
+var GradientStopSchema = z.object({
+	offset: z.number().min(0).max(1).describe("Stop position along the gradient axis, 0..1"),
+	color: z.string().describe("Any CSS color (e.g. \"#08f\", \"navy\", \"currentColor\")"),
+	opacity: z.number().min(0).max(1).optional().describe("Stop opacity 0..1; omitted = fully opaque")
+}).describe("A single gradient color stop");
+/**
+* Paint server 规格（渐变 / 图案 / 图片）；纯色仍是 `fill` / `stroke` 上的 string，不进此 schema
+* @description 四种 paint server：linear / radial gradient、pattern（图案）、image（图片）。纯 JSON 形态，保 IR 可序列化。
+*   linear 方向用 `angle`（度，polar 约定：0°=+x，90°=+y 屏幕下）；radial 的 `center` / `radius` 用 objectBoundingBox（0..1，随形状缩放）。
+*/
+var PaintSpecSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("linearGradient"),
+		stops: z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
+		angle: z.number().finite().optional().describe("Gradient direction in degrees (polar convention; 0°=+x, 90°=+y screen-down); omitted = renderer default (left→right)")
+	}).describe("Linear gradient paint server"),
+	z.object({
+		type: z.literal("radialGradient"),
+		stops: z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
+		center: z.tuple([z.number().finite(), z.number().finite()]).optional().describe("Center in objectBoundingBox units (0..1 relative to the filled shape); omitted = (0.5, 0.5)"),
+		radius: z.number().finite().positive().optional().describe("Radius in objectBoundingBox units (0..1); omitted = 0.5")
+	}).describe("Radial gradient paint server"),
+	z.object({
+		type: z.literal("pattern"),
+		shape: z.string().min(1).describe("Registered pattern motif name; built-in `lines` (hatching) / `dots` / `grid` (crosshatch), or an extension motif registered via `CompileOptions.patterns`. Any non-empty string passes schema validation; unregistered names are rejected at compile time."),
+		color: z.string().optional().describe("Motif color; any CSS color, defaults to `currentColor`"),
+		background: z.string().optional().describe("Tile background fill; omitted = transparent"),
+		size: z.number().finite().positive().optional().describe("Tile period in user units (line gap / dot spacing); default 8"),
+		lineWidth: z.number().finite().positive().optional().describe("Line / grid stroke width; for dots, drives the dot radius. Default 1 (dots default to size/5)"),
+		rotation: z.number().finite().optional().describe("Rotate the whole pattern, in degrees")
+	}).describe("Pattern paint server (hatching / dots / grid)"),
+	z.object({
+		type: z.literal("image"),
+		href: z.string().min(1).describe("Image URL (http(s) or data URI)"),
+		fit: z.enum([
+			"fill",
+			"contain",
+			"cover"
+		]).optional().describe("How the image maps to the shape: `fill` (stretch) / `contain` / `cover`. Default `cover`")
+	}).describe("Image paint server (fills the shape with an image)")
+]).describe("Paint server spec: gradient / pattern / image. Solid color stays a plain string on `fill` / `stroke`.");
+//#endregion
+export { GradientStopSchema, PATTERN_SHAPES, PaintSpecSchema };

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

@@ -15,6 +15,18 @@ export declare const ARROW_SHAPES: {
 };
 /** 箭头形状字面量类型 */
 export type ArrowShape = ValueOf<typeof ARROW_SHAPES>;
+/**
+ * 内置 7 箭头名联合
+ * @description `BUILTIN_ARROWS` 的 Record key（保穷尽性约束，不随 `ArrowShapeName` 开放而退化为 `string`）；
+ *   等价于历史 `ArrowShape`，独立命名对齐 `node.ts` 的 `BuiltinShapeName` 范式
+ */
+export type BuiltinArrowName = ValueOf<typeof ARROW_SHAPES>;
+/**
+ * 箭头形状名：开放字符串
+ * @description 内置 `BuiltinArrowName`，或经 `CompileOptions.arrows` 注册的扩展箭头名；
+ *   `& {}` 让 IDE 仍对内置 7 名自动补全，同时接受任意非空字符串（对齐 `node.ts` 的 `NodeShape`）
+ */
+export type ArrowShapeName = BuiltinArrowName | (string & {});
 /** 箭头默认形状 */
 export declare const DEFAULT_ARROW_SHAPE: "stealth";
 /**
@@ -31,15 +43,7 @@ export declare const ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
  * @description 顶层 8 字段全 optional；fill 在空心 shape 上 silent no-op（schema 不拒绝、compile/render 丢字段）；start/end 子对象用相同字段集（无 start/end 递归）
  */
 export declare const ArrowEndDetailSchema: z.ZodObject<{
-    shape: z.ZodOptional<z.ZodNativeEnum<{
-        readonly normal: "normal";
-        readonly open: "open";
-        readonly stealth: "stealth";
-        readonly diamond: "diamond";
-        readonly openDiamond: "openDiamond";
-        readonly circle: "circle";
-        readonly openCircle: "openCircle";
-    }>>;
+    shape: z.ZodOptional<z.ZodString>;
     scale: z.ZodOptional<z.ZodNumber>;
     length: z.ZodOptional<z.ZodNumber>;
     width: z.ZodOptional<z.ZodNumber>;
@@ -50,36 +54,28 @@ export declare const ArrowEndDetailSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    color?: string | undefined;
     opacity?: number | undefined;
-    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    shape?: string | undefined;
+    lineWidth?: number | undefined;
     scale?: number | undefined;
     width?: number | undefined;
-    color?: string | undefined;
-    lineWidth?: number | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    color?: string | undefined;
     opacity?: number | undefined;
-    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    shape?: string | undefined;
+    lineWidth?: number | undefined;
     scale?: number | undefined;
     width?: number | undefined;
-    color?: string | undefined;
-    lineWidth?: number | undefined;
 }>;
 /**
  * Path 级箭头详细配置 schema
  * @description 顶层视觉字段（与 `ArrowEndDetailSchema` 同字段集）作为起末共享默认；`start` / `end` 子对象逐字段 merge 顶层（缺省字段继承，已填字段 override）
  */
 export declare const ArrowDetailSchema: z.ZodObject<{
-    shape: z.ZodOptional<z.ZodNativeEnum<{
-        readonly normal: "normal";
-        readonly open: "open";
-        readonly stealth: "stealth";
-        readonly diamond: "diamond";
-        readonly openDiamond: "openDiamond";
-        readonly circle: "circle";
-        readonly openCircle: "openCircle";
-    }>>;
+    shape: z.ZodOptional<z.ZodString>;
     scale: z.ZodOptional<z.ZodNumber>;
     length: z.ZodOptional<z.ZodNumber>;
     width: z.ZodOptional<z.ZodNumber>;
@@ -89,15 +85,7 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     lineWidth: z.ZodOptional<z.ZodNumber>;
 } & {
     start: z.ZodOptional<z.ZodObject<{
-        shape: z.ZodOptional<z.ZodNativeEnum<{
-            readonly normal: "normal";
-            readonly open: "open";
-            readonly stealth: "stealth";
-            readonly diamond: "diamond";
-            readonly openDiamond: "openDiamond";
-            readonly circle: "circle";
-            readonly openCircle: "openCircle";
-        }>>;
+        shape: z.ZodOptional<z.ZodString>;
         scale: z.ZodOptional<z.ZodNumber>;
         length: z.ZodOptional<z.ZodNumber>;
         width: z.ZodOptional<z.ZodNumber>;
@@ -108,32 +96,24 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     }>>;
     end: z.ZodOptional<z.ZodObject<{
-        shape: z.ZodOptional<z.ZodNativeEnum<{
-            readonly normal: "normal";
-            readonly open: "open";
-            readonly stealth: "stealth";
-            readonly diamond: "diamond";
-            readonly openDiamond: "openDiamond";
-            readonly circle: "circle";
-            readonly openCircle: "openCircle";
-        }>>;
+        shape: z.ZodOptional<z.ZodString>;
         scale: z.ZodOptional<z.ZodNumber>;
         length: z.ZodOptional<z.ZodNumber>;
         width: z.ZodOptional<z.ZodNumber>;
@@ -144,79 +124,79 @@ export declare const ArrowDetailSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     }, {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     length?: number | undefined;
     fill?: string | undefined;
+    color?: string | undefined;
     opacity?: number | undefined;
-    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    shape?: string | undefined;
+    lineWidth?: number | undefined;
     scale?: number | undefined;
     width?: number | undefined;
-    color?: string | undefined;
-    lineWidth?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     } | undefined;
 }, {
     length?: number | undefined;
     fill?: string | undefined;
+    color?: string | undefined;
     opacity?: number | undefined;
-    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    shape?: string | undefined;
+    lineWidth?: number | undefined;
     scale?: number | undefined;
     width?: number | undefined;
-    color?: string | undefined;
-    lineWidth?: number | undefined;
     start?: {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     } | undefined;
     end?: {
         length?: number | undefined;
         fill?: string | undefined;
+        color?: string | undefined;
         opacity?: number | undefined;
-        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        shape?: string | undefined;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     } | undefined;
 }>;
 /** 端点级箭头视觉规格 */

package/dist/es/ir/path/arrow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD,aAAa;AACb,eAAO,MAAM,mBAAmB,WAAuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAA6D,CAAC;AAE9F,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2D9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"arrow.d.ts","sourceRoot":"","sources":["../../../../src/ir/path/arrow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,gBAAgB;AAChB,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,YAAY,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE9D,aAAa;AACb,eAAO,MAAM,mBAAmB,WAAuB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAA6D,CAAC;AAE9F,wCAAwC;AACxC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,sCAAsC,MAAM,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgE9B,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,mBAAmB;AACnB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/es/ir/path/arrow.js

@@ -33,14 +33,14 @@ var ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
 * @description 顶层 8 字段全 optional；fill 在空心 shape 上 silent no-op（schema 不拒绝、compile/render 丢字段）；start/end 子对象用相同字段集（无 start/end 递归）
 */
 var ArrowEndDetailSchema = z.object({
-	shape: z.nativeEnum(ARROW_SHAPES).optional().describe("Arrow tip shape. Defaults to `stealth` (sharp barb). Other values: `normal` (filled triangle), `open` (hollow triangle), `diamond`, `openDiamond`, `circle`, `openCircle`."),
-	scale: z.number().positive().optional().describe("Uniform tip scale factor; multiplies `length` and `width` (e.g. `length=10, scale=1.5` → effective 15). Defaults to 1."),
-	length: z.number().nonnegative().optional().describe("Tip length in user units (the dimension along the path direction). Defaults to ~6."),
-	width: z.number().nonnegative().optional().describe("Tip width in user units (perpendicular to the path). Defaults to ~6."),
+	shape: z.string().min(1).optional().describe("Registered arrow name: built-in 7 (`normal` / `open` / `stealth` / `diamond` / `openDiamond` / `circle` / `openCircle`) or an extension arrow registered via `CompileOptions.arrows`. Any non-empty string passes schema validation; unregistered names are rejected at compile time (throw). Defaults to `stealth`."),
+	scale: z.number().finite().positive().optional().describe("Uniform tip scale factor; multiplies `length` and `width` (e.g. `length=10, scale=1.5` → effective 15). Defaults to 1."),
+	length: z.number().finite().nonnegative().optional().describe("Tip length in user units (the dimension along the path direction). Defaults to ~6."),
+	width: z.number().finite().nonnegative().optional().describe("Tip width in user units (perpendicular to the path). Defaults to ~6."),
 	color: z.string().optional().describe("Stroke color override. When omitted, the renderer should inherit the path stroke."),
 	fill: z.string().optional().describe("Fill color override (effective only on solid shapes). Hollow shapes (`open` / `openDiamond` / `openCircle`) silently ignore this field — `color` drives the stroke."),
 	opacity: z.number().min(0).max(1).optional().describe("Arrow opacity 0..1, independent from the path opacity. When omitted, inherits the path opacity."),
-	lineWidth: z.number().nonnegative().optional().describe("Stroke width for hollow shapes (user units). Defaults to 1.5. Solid shapes ignore this field.")
+	lineWidth: z.number().finite().nonnegative().optional().describe("Stroke width for hollow shapes (user units). Defaults to 1.5. Solid shapes ignore this field.")
 }).describe("Per-end arrow visual spec: shape + visual fields (scale / length / width / color / fill / opacity / lineWidth). All optional; omitted fields fall through to top-level `arrowDetail` defaults and then built-in defaults.");
 /**
 * Path 级箭头详细配置 schema