@retikz/core 0.1.0-alpha.4 → 0.1.0-alpha.5

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

@@ -1,16 +1,8 @@
+import { z } from 'zod';
 import { ValueOf } from '../../types';
 /**
- * 箭头形状常量。值就是 IR / Scene 中 arrow 字段的字面字符串；
- * 用 const 而不是 TS enum——避免 enum 在数值场景生成 reverse-mapping、
- * 在 string 场景与字面量类型不互通的两个坑。
- *
- * - `normal`：实心三角（默认；最常见）
- * - `open`：空心三角（UML 泛化 / 继承）
- * - `stealth`：尖锐倒钩三角（流图常见、视觉锐利）
- * - `diamond`：实心菱形（UML 组合）
- * - `openDiamond`：空心菱形（UML 聚合）
- * - `circle`：实心圆点（连接点 / dot end）
- * - `openCircle`：空心圆点（白圈 / o-end）
+ * 箭头形状常量（用 const 而非 TS enum 避免 reverse-mapping 和字面量不互通）
+ * @description normal 实心三角（默认）；open 空心三角（UML 泛化/继承）；stealth 尖锐倒钩；diamond 实心菱形（UML 组合）；openDiamond 空心菱形（聚合）；circle 实心圆点；openCircle 空心圆点
  */
 export declare const ARROW_SHAPES: {
     readonly normal: "normal";
@@ -21,6 +13,212 @@ export declare const ARROW_SHAPES: {
     readonly circle: "circle";
     readonly openCircle: "openCircle";
 };
-/** 箭头形状字面量类型，由 `ARROW_SHAPES` 派生 */
+/** 箭头形状字面量类型 */
 export type ArrowShape = ValueOf<typeof ARROW_SHAPES>;
+/**
+ * 空心 shape 集合（fill 字段在这些 shape 上 silent no-op）
+ * @description compile 与 render 都引用此表判定 fill 是否丢弃；空心 shape 用 color 主导描边、lineWidth 控描边粗
+ */
+export declare const HOLLOW_ARROW_SHAPES: Set<ArrowShape>;
+/** marker 默认尺寸（length / width 的 fallback；arrowMarkers viewBox 内的几何也按 10 单位定义） */
+export declare const ARROW_MARKER_DEFAULT_SIZE = 6;
+/** 空心 shape 描边默认粗细（lineWidth fallback；refX / shrink 计算都用它做"back stroke 半宽"） */
+export declare const ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH = 1.5;
+/**
+ * 端点级箭头视觉规格 schema
+ * @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";
+    }>>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    length: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    lineWidth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    length?: number | undefined;
+    fill?: string | undefined;
+    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    scale?: number | undefined;
+    width?: number | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    lineWidth?: number | undefined;
+}, {
+    length?: number | undefined;
+    fill?: string | undefined;
+    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    scale?: number | undefined;
+    width?: number | undefined;
+    color?: string | undefined;
+    opacity?: number | 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";
+    }>>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    length: z.ZodOptional<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    color: z.ZodOptional<z.ZodString>;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    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";
+        }>>;
+        scale: z.ZodOptional<z.ZodNumber>;
+        length: z.ZodOptional<z.ZodNumber>;
+        width: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodString>;
+        fill: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        lineWidth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    }, {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | 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";
+        }>>;
+        scale: z.ZodOptional<z.ZodNumber>;
+        length: z.ZodOptional<z.ZodNumber>;
+        width: z.ZodOptional<z.ZodNumber>;
+        color: z.ZodOptional<z.ZodString>;
+        fill: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        lineWidth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    }, {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    length?: number | undefined;
+    fill?: string | undefined;
+    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    scale?: number | undefined;
+    width?: number | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    lineWidth?: number | undefined;
+    start?: {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    } | undefined;
+    end?: {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    } | undefined;
+}, {
+    length?: number | undefined;
+    fill?: string | undefined;
+    shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+    scale?: number | undefined;
+    width?: number | undefined;
+    color?: string | undefined;
+    opacity?: number | undefined;
+    lineWidth?: number | undefined;
+    start?: {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    } | undefined;
+    end?: {
+        length?: number | undefined;
+        fill?: string | undefined;
+        shape?: "normal" | "open" | "stealth" | "diamond" | "openDiamond" | "circle" | "openCircle" | undefined;
+        scale?: number | undefined;
+        width?: number | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        lineWidth?: number | undefined;
+    } | undefined;
+}>;
+/** 端点级箭头视觉规格 */
+export type IRArrowEndDetail = z.infer<typeof ArrowEndDetailSchema>;
+/** Path 级箭头详细配置 */
+export type IRArrowDetail = z.infer<typeof ArrowDetailSchema>;
 //# sourceMappingURL=arrow.d.ts.map

package/dist/lib/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,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,YAAY,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;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAA6D,CAAC;AAE9F,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,+EAA+E;AAC/E,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"}

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

@@ -13,7 +13,7 @@ var PathSchema = zod.z.object({
 		"<-",
 		"<->"
 	]).optional().describe("Path-level arrow direction. omitted/`none` = no arrows; `->` = arrow at end; `<-` = at start; `<->` = both."),
-	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`."),
+	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 `normal`, 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."),
 	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([