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

package/dist/lib/ir/paint.cjs

@@ -0,0 +1,54 @@
+let zod = require("zod");
+//#region src/ir/paint.ts
+/**
+* 渐变 stop：位置 + 颜色 + 可选透明度
+* @description offset 0..1（沿渐变轴的位置）；color 任意 CSS 颜色（含 `currentColor` 主题反应）；opacity 0..1。
+*/
+var GradientStopSchema = zod.z.object({
+	offset: zod.z.number().min(0).max(1).describe("Stop position along the gradient axis, 0..1"),
+	color: zod.z.string().describe("Any CSS color (e.g. \"#08f\", \"navy\", \"currentColor\")"),
+	opacity: zod.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 = zod.z.discriminatedUnion("type", [
+	zod.z.object({
+		type: zod.z.literal("linearGradient"),
+		stops: zod.z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
+		angle: zod.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"),
+	zod.z.object({
+		type: zod.z.literal("radialGradient"),
+		stops: zod.z.array(GradientStopSchema).min(2).describe("Gradient stops, at least 2"),
+		center: zod.z.tuple([zod.z.number().finite(), zod.z.number().finite()]).optional().describe("Center in objectBoundingBox units (0..1 relative to the filled shape); omitted = (0.5, 0.5)"),
+		radius: zod.z.number().finite().positive().optional().describe("Radius in objectBoundingBox units (0..1); omitted = 0.5")
+	}).describe("Radial gradient paint server"),
+	zod.z.object({
+		type: zod.z.literal("pattern"),
+		shape: zod.z.enum([
+			"lines",
+			"dots",
+			"grid"
+		]).describe("Pattern motif: `lines` (hatching) / `dots` / `grid` (crosshatch)"),
+		color: zod.z.string().optional().describe("Motif color; any CSS color, defaults to `currentColor`"),
+		background: zod.z.string().optional().describe("Tile background fill; omitted = transparent"),
+		size: zod.z.number().finite().positive().optional().describe("Tile period in user units (line gap / dot spacing); default 8"),
+		lineWidth: zod.z.number().finite().positive().optional().describe("Line / grid stroke width; for dots, drives the dot radius. Default 1 (dots default to size/5)"),
+		rotation: zod.z.number().finite().optional().describe("Rotate the whole pattern, in degrees")
+	}).describe("Pattern paint server (hatching / dots / grid)"),
+	zod.z.object({
+		type: zod.z.literal("image"),
+		href: zod.z.string().min(1).describe("Image URL (http(s) or data URI)"),
+		fit: zod.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
+exports.GradientStopSchema = GradientStopSchema;
+exports.PaintSpecSchema = PaintSpecSchema;

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

@@ -0,0 +1,132 @@
+import { z } from 'zod';
+/**
+ * 渐变 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.ZodEnum<["lines", "dots", "grid"]>;
+    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: "lines" | "dots" | "grid";
+    size?: number | undefined;
+    color?: string | undefined;
+    background?: string | undefined;
+    lineWidth?: number | undefined;
+    rotation?: number | undefined;
+}, {
+    type: "pattern";
+    shape: "lines" | "dots" | "grid";
+    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/lib/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;AAExB;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAMY,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmEwF,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/lib/ir/path/arrow.d.ts

@@ -50,21 +50,21 @@ 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;
+    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;
+    lineWidth?: number | undefined;
     scale?: number | undefined;
     width?: number | undefined;
-    color?: string | undefined;
-    lineWidth?: number | undefined;
 }>;
 /**
  * Path 级箭头详细配置 schema
@@ -108,21 +108,21 @@ 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;
+        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;
+        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<{
@@ -144,79 +144,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;
+        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;
+        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;
+    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;
+        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;
+        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;
+    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;
+        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;
+        lineWidth?: number | undefined;
         scale?: number | undefined;
         width?: number | undefined;
-        color?: string | undefined;
-        lineWidth?: number | undefined;
     } | undefined;
 }>;
 /** 端点级箭头视觉规格 */

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

@@ -1,3 +1,4 @@
+const require_paint = require("../paint.cjs");
 const require_arrow = require("./arrow.cjs");
 const require_step = require("./step.cjs");
 let zod = require("zod");
@@ -15,7 +16,7 @@ var PathSchema = zod.z.object({
 		"<->"
 	]).optional().describe("Path-level arrow direction. omitted/`none` = no arrows; `->` = arrow at end; `<-` = at start; `<->` = both."),
 	arrowDetail: require_arrow.ArrowDetailSchema.optional().describe("Detailed arrow visual config (shape / scale / length / width / color / fill / opacity / lineWidth) with optional `start` / `end` per-end overrides. Omitted = built-in defaults (shape `stealth`, all visuals inherit from path stroke / opacity)."),
-	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."),
+	fill: zod.z.union([zod.z.string(), require_paint.PaintSpecSchema]).optional().describe("Fill of the closed region: any CSS color string, or a PaintSpec (linear / radial gradient, pattern, or image). 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) winds-by-direction; `evenodd` toggles fill on each crossing — useful for ring / donut shapes."),
 	lineCap: zod.z.enum([
 		"butt",