@retikz/core 0.3.0-alpha.3 → 0.3.0-alpha.5

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

@@ -0,0 +1,218 @@
+import { z } from 'zod';
+import { ValueOf } from '../types';
+/**
+ * 可动画属性通道（renderer 无关；DrawWay 风格 const + 派生类型，裸字面量 'opacity' 仍第一形态）
+ * @description `viewBox` 仅在 scene 根合法（镜头），元素级 viewBox track 由 compile / render 拒；
+ *   `pathDraw` 是 0..1 路径画出进度；`scaleX` / `scaleY` 是非均匀缩放（柱状图从基线长出等），`scale` 是均匀缩放；
+ *   transform 通道（scale / scaleX / scaleY / rotate）的支点见 track 级 `origin`，缺省几何中心。
+ *   各后端按通道翻译：SVG WAAPI/CSS、Canvas rAF 几何 lerp。
+ */
+export declare const AnimationProperty: {
+    readonly Opacity: "opacity";
+    readonly Fill: "fill";
+    readonly Stroke: "stroke";
+    readonly StrokeWidth: "strokeWidth";
+    readonly TranslateX: "translateX";
+    readonly TranslateY: "translateY";
+    readonly Rotate: "rotate";
+    readonly Scale: "scale";
+    readonly ScaleX: "scaleX";
+    readonly ScaleY: "scaleY";
+    readonly PathDraw: "pathDraw";
+    readonly ViewBox: "viewBox";
+};
+/** 内置可动画属性通道名联合 */
+export type BuiltinAnimationProperty = ValueOf<typeof AnimationProperty>;
+/** 属性名：内置 ∪ 任意自定义字符串（`& {}` 保内置自动补全，同 NodeShape 范式）；自定义通道由后续 renderer 注册的插值器解释 */
+export type AnimationPropertyRef = BuiltinAnimationProperty | (string & {});
+/** 缓动具名预设（与 CSS 同名）；track / keyframe 亦可改用 cubic-bezier 四元组 */
+export declare const AnimationEasing: {
+    readonly Linear: "linear";
+    readonly Ease: "ease";
+    readonly EaseIn: "ease-in";
+    readonly EaseOut: "ease-out";
+    readonly EaseInOut: "ease-in-out";
+};
+/** 缓动预设名联合 */
+export type AnimationEasingName = ValueOf<typeof AnimationEasing>;
+/** 每次迭代的播放方向（抄 WAAPI / CSS animation-direction） */
+export declare const AnimationDirection: {
+    readonly Normal: "normal";
+    readonly Reverse: "reverse";
+    readonly Alternate: "alternate";
+    readonly AlternateReverse: "alternate-reverse";
+};
+/** 播放方向名联合 */
+export type AnimationDirectionName = ValueOf<typeof AnimationDirection>;
+/** 活动区间外取值（抄 WAAPI / CSS animation-fill-mode） */
+export declare const AnimationFill: {
+    readonly None: "none";
+    readonly Forwards: "forwards";
+    readonly Backwards: "backwards";
+    readonly Both: "both";
+};
+/** 填充模式名联合 */
+export type AnimationFillName = ValueOf<typeof AnimationFill>;
+export declare const EasingSchema: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>;
+export declare const KeyframeSchema: z.ZodObject<{
+    at: z.ZodNumber;
+    value: z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>;
+    easing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>>;
+}, "strip", z.ZodTypeAny, {
+    value: import('./json').JsonValue;
+    at: number;
+    easing?: string | [number, number, number, number] | undefined;
+}, {
+    value: import('./json').JsonValue;
+    at: number;
+    easing?: string | [number, number, number, number] | undefined;
+}>;
+/** 播放触发器关键字（runtime 落地；DrawWay 风格 const + 派生类型，与其它 Animation 枚举单一真源一致） */
+export declare const AnimationTrigger: {
+    readonly Load: "load";
+    readonly Visible: "visible";
+    readonly Manual: "manual";
+};
+/** 触发器关键字联合（不含 { onEvent } 对象形态） */
+export type AnimationTriggerName = ValueOf<typeof AnimationTrigger>;
+export declare const TriggerSchema: z.ZodUnion<[z.ZodNativeEnum<{
+    readonly Load: "load";
+    readonly Visible: "visible";
+    readonly Manual: "manual";
+}>, z.ZodObject<{
+    onEvent: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    onEvent: string;
+}, {
+    onEvent: string;
+}>]>;
+export declare const OriginSchema: z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>;
+export declare const AnimationTrackSchema: z.ZodEffects<z.ZodObject<{
+    property: z.ZodString;
+    keyframes: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        at: z.ZodNumber;
+        value: z.ZodType<import('./json').JsonValue, z.ZodTypeDef, import('./json').JsonValue>;
+        easing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>>;
+    }, "strip", z.ZodTypeAny, {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }, {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }>, "many">, {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[], {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[]>;
+    duration: z.ZodNumber;
+    delay: z.ZodOptional<z.ZodNumber>;
+    easing: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>]>>;
+    iterations: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodLiteral<"infinite">]>>;
+    direction: z.ZodOptional<z.ZodNativeEnum<{
+        readonly Normal: "normal";
+        readonly Reverse: "reverse";
+        readonly Alternate: "alternate";
+        readonly AlternateReverse: "alternate-reverse";
+    }>>;
+    fill: z.ZodOptional<z.ZodNativeEnum<{
+        readonly None: "none";
+        readonly Forwards: "forwards";
+        readonly Backwards: "backwards";
+        readonly Both: "both";
+    }>>;
+    trigger: z.ZodOptional<z.ZodUnion<[z.ZodNativeEnum<{
+        readonly Load: "load";
+        readonly Visible: "visible";
+        readonly Manual: "manual";
+    }>, z.ZodObject<{
+        onEvent: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        onEvent: string;
+    }, {
+        onEvent: string;
+    }>]>>;
+    origin: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>]>>;
+}, "strip", z.ZodTypeAny, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}>, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}, {
+    property: string;
+    keyframes: {
+        value: import('./json').JsonValue;
+        at: number;
+        easing?: string | [number, number, number, number] | undefined;
+    }[];
+    duration: number;
+    fill?: "none" | "forwards" | "backwards" | "both" | undefined;
+    origin?: string | [number, number] | undefined;
+    direction?: "reverse" | "normal" | "alternate" | "alternate-reverse" | undefined;
+    easing?: string | [number, number, number, number] | undefined;
+    delay?: number | undefined;
+    iterations?: number | "infinite" | undefined;
+    trigger?: "load" | "visible" | "manual" | {
+        onEvent: string;
+    } | undefined;
+}>;
+/** 时间轴动画 track（renderer 无关、JSON 可序列化、无函数；keyframe 给绝对展示值、末帧 = 元素 base 终态） */
+export type IRAnimationTrack = z.infer<typeof AnimationTrackSchema>;
+/** 单个动画关键帧 */
+export type IRKeyframe = z.infer<typeof KeyframeSchema>;
+/** transform 支点（命名 anchor ∪ 局部坐标点；scale / scaleX / scaleY / rotate 用，缺省几何中心） */
+export type IRAnimationOrigin = z.infer<typeof OriginSchema>;
+/** 动画播放触发器（load / visible / manual / { onEvent }） */
+export type IRAnimationTrigger = z.infer<typeof TriggerSchema>;
+//# sourceMappingURL=animation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../../src/ir/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;CAapB,CAAC;AACX,mBAAmB;AACnB,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACzE,kFAAkF;AAClF,MAAM,MAAM,oBAAoB,GAAG,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5E,8DAA8D;AAC9D,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE,mDAAmD;AACnD,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAExE,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAE9D,eAAO,MAAM,YAAY,mGAOtB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;EAgBgF,CAAC;AAE5G,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;CAAkE,CAAC;AAChG,oCAAoC;AACpC,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEpE,eAAO,MAAM,aAAa;;;;;;;;;;IAYvB,CAAC;AAEJ,eAAO,MAAM,YAAY,yEActB,CAAC;AAEJ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmF9B,CAAC;AAEJ,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACpE,cAAc;AACd,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,gFAAgF;AAChF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAC7D,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/es/ir/animation.js

@@ -0,0 +1,118 @@
+import { JsonValueSchema } from "./json.js";
+import { z } from "zod";
+//#region src/ir/animation.ts
+/**
+* 可动画属性通道（renderer 无关；DrawWay 风格 const + 派生类型，裸字面量 'opacity' 仍第一形态）
+* @description `viewBox` 仅在 scene 根合法（镜头），元素级 viewBox track 由 compile / render 拒；
+*   `pathDraw` 是 0..1 路径画出进度；`scaleX` / `scaleY` 是非均匀缩放（柱状图从基线长出等），`scale` 是均匀缩放；
+*   transform 通道（scale / scaleX / scaleY / rotate）的支点见 track 级 `origin`，缺省几何中心。
+*   各后端按通道翻译：SVG WAAPI/CSS、Canvas rAF 几何 lerp。
+*/
+var AnimationProperty = {
+	Opacity: "opacity",
+	Fill: "fill",
+	Stroke: "stroke",
+	StrokeWidth: "strokeWidth",
+	TranslateX: "translateX",
+	TranslateY: "translateY",
+	Rotate: "rotate",
+	Scale: "scale",
+	ScaleX: "scaleX",
+	ScaleY: "scaleY",
+	PathDraw: "pathDraw",
+	ViewBox: "viewBox"
+};
+/** 缓动具名预设（与 CSS 同名）；track / keyframe 亦可改用 cubic-bezier 四元组 */
+var AnimationEasing = {
+	Linear: "linear",
+	Ease: "ease",
+	EaseIn: "ease-in",
+	EaseOut: "ease-out",
+	EaseInOut: "ease-in-out"
+};
+/** 每次迭代的播放方向（抄 WAAPI / CSS animation-direction） */
+var AnimationDirection = {
+	Normal: "normal",
+	Reverse: "reverse",
+	Alternate: "alternate",
+	AlternateReverse: "alternate-reverse"
+};
+/** 活动区间外取值（抄 WAAPI / CSS animation-fill-mode） */
+var AnimationFill = {
+	None: "none",
+	Forwards: "forwards",
+	Backwards: "backwards",
+	Both: "both"
+};
+var EasingSchema = z.union([z.string().min(1), z.tuple([
+	z.number().finite(),
+	z.number().finite(),
+	z.number().finite(),
+	z.number().finite()
+])]).describe("Easing: a named preset (built-in linear / ease / ease-in / ease-out / ease-in-out, or a custom name resolved by a renderer-registered easing) or a cubic-bezier control-point tuple [x1, y1, x2, y2]. Defaults to linear when omitted.");
+var KeyframeSchema = z.object({
+	at: z.number().min(0).max(1).describe("Normalized keyframe time in [0, 1] (WAAPI offset, decoupled from duration). Keyframes within a track must be sorted ascending by `at`."),
+	value: JsonValueSchema.describe("Keyframe value (any JSON value). For built-in properties it is narrowed by the track-level refinement: a finite number (opacity / scale / rotate / translateX|Y / strokeWidth / pathDraw 0..1), a color string (fill / stroke, interpolated in oklch), or a 4-number array [x, y, w, h] (viewBox). Custom (non-built-in) properties accept any JSON value, interpreted by a renderer-registered interpolator."),
+	easing: EasingSchema.optional().describe("Per-segment easing from this keyframe to the next; overrides the track-level easing.")
+}).describe("A single animation keyframe: a value at a normalized time, with optional per-segment easing.");
+/** 播放触发器关键字（runtime 落地；DrawWay 风格 const + 派生类型，与其它 Animation 枚举单一真源一致） */
+var AnimationTrigger = {
+	Load: "load",
+	Visible: "visible",
+	Manual: "manual"
+};
+var TriggerSchema = z.union([z.nativeEnum(AnimationTrigger), z.object({ onEvent: z.string().min(1).describe("Event name (e.g. \"click\") the runtime binds to start playback; the handler function never enters the IR.") })]).describe("When playback starts: \"load\" (on render, SSR-friendly) / \"visible\" (runtime IntersectionObserver) / \"manual\" (runtime API) / { onEvent } (bridge to hydration; only the event name is stored, never a callback). Defaults to \"load\".");
+var OriginSchema = z.union([z.string().min(1).describe("Named transform pivot reusing the node anchor vocabulary (center / north / south / east / west / north-east / ... / south-west), resolved against the element boundary by the renderer."), z.tuple([z.number().finite(), z.number().finite()]).describe("Explicit pivot in the element local coordinate space [x, y].")]).describe("Transform pivot for scale / scaleX / scaleY / rotate channels: a named anchor or an explicit local-space point. Ignored by non-transform channels. Defaults to the element geometric center.");
+var AnimationTrackSchema = z.object({
+	property: z.string().min(1).describe("Renderer-agnostic animated channel. Built-in: opacity / fill / stroke / strokeWidth / translateX / translateY / rotate / scale (uniform) / scaleX / scaleY (non-uniform) / pathDraw (0..1 reveal) / viewBox (scene-root camera only). Any other string is a custom channel that passes through to a renderer-registered interpolator. `viewBox` is valid only at the scene root (enforced at compile)."),
+	keyframes: z.array(KeyframeSchema).min(1).refine((frames) => frames.every((frame, index) => index === 0 || frame.at >= frames[index - 1].at), { message: "keyframes must be sorted ascending by `at`" }).describe("Ordered keyframes (at least one), sorted ascending by `at` within [0, 1]. Each keyframe gives the absolute display value at that time (NOT a delta on top of the base). By convention the final keyframe equals the element base (settled) state, so ignoring the animation renders the complete base figure."),
+	duration: z.number().finite().positive().describe("One-iteration duration in milliseconds (> 0)."),
+	delay: z.number().finite().nonnegative().optional().describe("Delay before the first iteration, in milliseconds (>= 0). Group-level stagger is compiled by sugar into per-track delays."),
+	easing: EasingSchema.optional().describe("Track-level easing applied to each segment that lacks its own keyframe easing. Defaults to linear."),
+	iterations: z.union([z.number().finite().positive(), z.literal("infinite")]).optional().describe("Total play count (WAAPI iterations): a positive number (may be fractional) or \"infinite\". Omitted = 1 = play once."),
+	direction: z.nativeEnum(AnimationDirection).optional().describe("Per-iteration playback direction (WAAPI / CSS animation-direction). Defaults to \"normal\"."),
+	fill: z.nativeEnum(AnimationFill).optional().describe("Value held outside the active interval (WAAPI / CSS fill-mode). Defaults to \"forwards\" so the element settles at its base (end) state, matching the static-settled invariant."),
+	trigger: TriggerSchema.optional().describe("Playback trigger; defaults to \"load\"."),
+	origin: OriginSchema.optional().describe("Transform pivot for scale / scaleX / scaleY / rotate channels; ignored by other channels. Defaults to the element geometric center.")
+}).superRefine((track, ctx) => {
+	const numeric = new Set([
+		AnimationProperty.Opacity,
+		AnimationProperty.StrokeWidth,
+		AnimationProperty.TranslateX,
+		AnimationProperty.TranslateY,
+		AnimationProperty.Rotate,
+		AnimationProperty.Scale,
+		AnimationProperty.ScaleX,
+		AnimationProperty.ScaleY,
+		AnimationProperty.PathDraw
+	]);
+	track.keyframes.forEach((frame, index) => {
+		const value = frame.value;
+		const path = [
+			"keyframes",
+			index,
+			"value"
+		];
+		if (track.property === AnimationProperty.ViewBox) {
+			if (!Array.isArray(value) || value.length !== 4) ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				path,
+				message: "viewBox keyframe value must be a 4-number array [x, y, w, h]"
+			});
+		} else if (track.property === AnimationProperty.Fill || track.property === AnimationProperty.Stroke) {
+			if (typeof value !== "string") ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				path,
+				message: `${track.property} keyframe value must be a color string`
+			});
+		} else if (numeric.has(track.property)) {
+			if (typeof value !== "number") ctx.addIssue({
+				code: z.ZodIssueCode.custom,
+				path,
+				message: `${track.property} keyframe value must be a number`
+			});
+		}
+	});
+}).describe("A declarative timeline animation track on a single renderer-agnostic property: keyframes over normalized time plus WAAPI-style timing options. The `property` is open (built-in channels or a custom name resolved by a renderer-registered interpolator). Fully JSON-serializable (no functions); playback control and callbacks live in the runtime, not the IR. Renderers that cannot animate render the static settled state and emit a diagnosable warning.");
+//#endregion
+export { AnimationDirection, AnimationEasing, AnimationFill, AnimationProperty, AnimationTrackSchema, AnimationTrigger, EasingSchema, KeyframeSchema, OriginSchema, TriggerSchema };

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

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+import { ValueOf } from '../types';
+/** 连接面引用：保留字 'shape'/'circle' 或借用已注册 shape（裸名 / {type, params}） */
+export declare const BoundarySchema: 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;
+}>]>;
+/** 连接面引用类型（'shape' | 'circle' | 其它 shape 名 | {type, params}） */
+export type IRBoundary = z.infer<typeof BoundarySchema>;
+/** 连接面保留关键字：非「借用已注册 shape」的两个内置语义（编译期消解） */
+export declare const Boundary: {
+    /** 连接面 = 节点自身视觉形状（默认） */
+    readonly Self: "shape";
+    /** 真圆：半径 = 节点 AABB 较长半轴 max(halfWidth, halfHeight) */
+    readonly Circle: "circle";
+};
+/** 连接面保留关键字联合（'shape' | 'circle'；其余取值为借用的 shape 引用） */
+export type BoundaryKeyword = ValueOf<typeof Boundary>;
+//# sourceMappingURL=boundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../../../src/ir/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,mEAAmE;AACnE,eAAO,MAAM,cAAc;;;;;;;;;IAIxB,CAAC;AAEJ,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ;IACnB,yBAAyB;;IAEzB,sDAAsD;;CAE9C,CAAC;AAEX,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/es/ir/boundary.js

@@ -0,0 +1,14 @@
+import { ShapeRefSchema } from "./shape.js";
+import { z } from "zod";
+//#region src/ir/boundary.ts
+/** 连接面引用：保留字 'shape'/'circle' 或借用已注册 shape（裸名 / {type, params}） */
+var BoundarySchema = z.union([z.string().min(1), ShapeRefSchema]).describe("Connection surface: how edges meet this node and how compass anchors resolve, independent of the visual `shape`. Reserved keywords: \"shape\" (default — the node's own visual shape) and \"circle\" (true circle, radius = larger AABB half-axis). Any other registered shape name (\"rectangle\" / \"ellipse\" / \"polygon\" / …) or `{ type, params }` borrows that shape's boundary over this node's bounding box. Layout-neutral: never changes the node footprint. Named shape-specific anchors and edge proportional points always resolve against the visual shape.");
+/** 连接面保留关键字：非「借用已注册 shape」的两个内置语义（编译期消解） */
+var Boundary = {
+	/** 连接面 = 节点自身视觉形状（默认） */
+	Self: "shape",
+	/** 真圆：半径 = 节点 AABB 较长半轴 max(halfWidth, halfHeight) */
+	Circle: "circle"
+};
+//#endregion
+export { Boundary, BoundarySchema };

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

@@ -1,10 +1,13 @@
 export * from './position';
 export * from './font';
 export * from './json';
+export * from './animation';
 export * from './paint';
 export * from './clip';
 export * from './text';
 export * from './path';
+export * from './shape';
+export * from './boundary';
 export * from './node';
 export * from './coordinate';
 export * from './transform';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ir/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}