@retikz/core 0.1.0-alpha.1 → 0.1.0-alpha.2

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

@@ -23,6 +23,140 @@ export declare const NODE_SHAPES: {
 };
 /** 节点形状字面量类型，由 `NODE_SHAPES` 派生 */
 export type NodeShape = ValueOf<typeof NODE_SHAPES>;
+/**
+ * 节点字体规格——family / size / weight / style 全部可选；
+ * 单字段透传到 SVG `<text>` 的 `font-*` 属性 / `font-size`。
+ *
+ * 取代 alpha.1 的标量 `fontSize` 字段（已删）。
+ */
+export declare const FontSchema: z.ZodObject<{
+    family: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+    style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+}, "strip", z.ZodTypeAny, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}, {
+    family?: string | undefined;
+    size?: number | undefined;
+    weight?: number | "normal" | "bold" | undefined;
+    style?: "normal" | "italic" | "oblique" | undefined;
+}>;
+/** 节点字体规格（IR 层）——所有字段可选，编译期解析默认值 */
+export type IRFont = z.infer<typeof FontSchema>;
+/**
+ * 单行文本规格——纯字符串走块级默认样式；对象形式可对该行覆盖 fill / opacity / font。
+ *
+ * 行级覆盖只生效于本行的 `<tspan>`：
+ * - `fill`：仅这一行颜色
+ * - `opacity`：仅这一行 0~1 透明度
+ * - `font`：family / size / weight / style 任意子集；未填字段继承块级 font
+ *
+ * 块级 `align` / `lineHeight` 不可被行覆盖（多行块整体属性）。
+ */
+export declare const LineSpecSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    text: z.ZodString;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}>]>;
+/** 行规格 IR 类型（string 或对象） */
+export type IRLineSpec = z.infer<typeof LineSpecSchema>;
+/**
+ * 节点文本——单行字符串或非空多行数组（每元素一个 LineSpec）：
+ * - `'Hello'` 等价于 `[{ text: 'Hello' }]`，按一行渲染
+ * - `['Line 1', 'Line 2']` 两行无样式覆盖
+ * - `[{ text: 'Heading', fill: 'red', font: { weight: 'bold' } }, 'body']` 混排
+ *
+ * 选 `Array<LineSpec>` 而非 `'\n'` 字符串：JSON 友好（无 escape）；行级覆盖天然落字段。
+ */
+export declare const NodeTextSchema: z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+    text: z.ZodString;
+    fill: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}, {
+    text: string;
+    fill?: string | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
+}>]>, "many">]>;
+/** 节点文本对齐（多行内文本对齐）——TikZ `align=` 同义词 */
+export declare const NODE_TEXT_ALIGNS: {
+    readonly left: "left";
+    readonly center: "center";
+    readonly right: "right";
+};
+/** 多行文本对齐字面量类型 */
+export type NodeTextAlign = ValueOf<typeof NODE_TEXT_ALIGNS>;
 export declare const NodeSchema: z.ZodObject<{
     type: z.ZodLiteral<"node">;
     id: z.ZodOptional<z.ZodString>;
@@ -34,13 +168,91 @@ export declare const NodeSchema: z.ZodObject<{
     }>>;
     position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>]>;
     rotate: z.ZodOptional<z.ZodNumber>;
-    text: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        text: z.ZodString;
+        fill: z.ZodOptional<z.ZodString>;
+        opacity: z.ZodOptional<z.ZodNumber>;
+        font: z.ZodOptional<z.ZodObject<{
+            family: z.ZodOptional<z.ZodString>;
+            size: z.ZodOptional<z.ZodNumber>;
+            weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+            style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+        }, "strip", z.ZodTypeAny, {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        }, {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    }, {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    }>]>, "many">]>>;
+    align: z.ZodOptional<z.ZodNativeEnum<{
+        readonly left: "left";
+        readonly center: "center";
+        readonly right: "right";
+    }>>;
+    lineHeight: z.ZodOptional<z.ZodNumber>;
     fill: z.ZodOptional<z.ZodString>;
+    fillOpacity: z.ZodOptional<z.ZodNumber>;
     stroke: z.ZodOptional<z.ZodString>;
+    drawOpacity: z.ZodOptional<z.ZodNumber>;
     strokeWidth: z.ZodOptional<z.ZodNumber>;
+    dashed: z.ZodOptional<z.ZodBoolean>;
+    dotted: z.ZodOptional<z.ZodBoolean>;
+    dashArray: z.ZodOptional<z.ZodString>;
+    roundedCorners: z.ZodOptional<z.ZodNumber>;
+    minimumWidth: z.ZodOptional<z.ZodNumber>;
+    minimumHeight: z.ZodOptional<z.ZodNumber>;
+    minimumSize: z.ZodOptional<z.ZodNumber>;
+    scale: z.ZodOptional<z.ZodNumber>;
+    xScale: z.ZodOptional<z.ZodNumber>;
+    yScale: z.ZodOptional<z.ZodNumber>;
+    textColor: z.ZodOptional<z.ZodString>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+    innerXSep: z.ZodOptional<z.ZodNumber>;
+    innerYSep: z.ZodOptional<z.ZodNumber>;
+    outerSep: z.ZodOptional<z.ZodNumber>;
     padding: z.ZodOptional<z.ZodNumber>;
     margin: z.ZodOptional<z.ZodNumber>;
-    fontSize: z.ZodOptional<z.ZodNumber>;
+    font: z.ZodOptional<z.ZodObject<{
+        family: z.ZodOptional<z.ZodString>;
+        size: z.ZodOptional<z.ZodNumber>;
+        weight: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["normal", "bold"]>, z.ZodNumber]>>;
+        style: z.ZodOptional<z.ZodEnum<["normal", "italic", "oblique"]>>;
+    }, "strip", z.ZodTypeAny, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }, {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     type: "node";
     position: [number, number] | import('./position').PolarPosition;
@@ -48,12 +260,46 @@ export declare const NodeSchema: z.ZodObject<{
     shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
+    text?: string | (string | {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    })[] | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
-    text?: string | undefined;
+    align?: "left" | "center" | "right" | undefined;
+    lineHeight?: number | undefined;
+    fillOpacity?: number | undefined;
+    drawOpacity?: number | undefined;
+    dashed?: boolean | undefined;
+    dotted?: boolean | undefined;
+    dashArray?: string | undefined;
+    roundedCorners?: number | undefined;
+    minimumWidth?: number | undefined;
+    minimumHeight?: number | undefined;
+    minimumSize?: number | undefined;
+    scale?: number | undefined;
+    xScale?: number | undefined;
+    yScale?: number | undefined;
+    textColor?: string | undefined;
+    innerXSep?: number | undefined;
+    innerYSep?: number | undefined;
+    outerSep?: number | undefined;
     padding?: number | undefined;
     margin?: number | undefined;
-    fontSize?: number | undefined;
 }, {
     type: "node";
     position: [number, number] | import('./position').PolarPosition;
@@ -61,12 +307,46 @@ export declare const NodeSchema: z.ZodObject<{
     shape?: "diamond" | "circle" | "rectangle" | "ellipse" | undefined;
     stroke?: string | undefined;
     strokeWidth?: number | undefined;
+    text?: string | (string | {
+        text: string;
+        fill?: string | undefined;
+        opacity?: number | undefined;
+        font?: {
+            family?: string | undefined;
+            size?: number | undefined;
+            weight?: number | "normal" | "bold" | undefined;
+            style?: "normal" | "italic" | "oblique" | undefined;
+        } | undefined;
+    })[] | undefined;
+    opacity?: number | undefined;
+    font?: {
+        family?: string | undefined;
+        size?: number | undefined;
+        weight?: number | "normal" | "bold" | undefined;
+        style?: "normal" | "italic" | "oblique" | undefined;
+    } | undefined;
     id?: string | undefined;
     rotate?: number | undefined;
-    text?: string | undefined;
+    align?: "left" | "center" | "right" | undefined;
+    lineHeight?: number | undefined;
+    fillOpacity?: number | undefined;
+    drawOpacity?: number | undefined;
+    dashed?: boolean | undefined;
+    dotted?: boolean | undefined;
+    dashArray?: string | undefined;
+    roundedCorners?: number | undefined;
+    minimumWidth?: number | undefined;
+    minimumHeight?: number | undefined;
+    minimumSize?: number | undefined;
+    scale?: number | undefined;
+    xScale?: number | undefined;
+    yScale?: number | undefined;
+    textColor?: string | undefined;
+    innerXSep?: number | undefined;
+    innerYSep?: number | undefined;
+    outerSep?: number | undefined;
     padding?: number | undefined;
     margin?: number | undefined;
-    fontSize?: number | undefined;
 }>;
 /** 节点：可定位的形状容器（矩形 / 圆 / 椭圆 / 菱形）+ 可选文本标签 */
 export type IRNode = z.infer<typeof NodeSchema>;

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;AAGxC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,mCAAmC;AACnC,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuEpB,CAAC;AAEJ,4CAA4C;AAC5C,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;AAGxC;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX,mCAAmC;AACnC,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,WAAW,CAAC,CAAC;AAEpD;;;;;GAKG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;EAwBpB,CAAC;AAEJ,oCAAoC;AACpC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEhD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsBxB,CAAC;AAEJ,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAIxB,CAAC;AAEJ,yCAAyC;AACzC,eAAO,MAAM,gBAAgB;;;;CAInB,CAAC;AAEX,kBAAkB;AAClB,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyKpB,CAAC;AAEJ,4CAA4C;AAC5C,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC"}