@retikz/core 0.3.0-alpha.4 → 0.3.0-beta.1

package/dist/lib/index.d.ts

@@ -2,10 +2,11 @@
  * @retikz/core 公开 API
  * @description 任何 framework adapter（@retikz/react、@retikz/vue、@retikz/render/canvas、@retikz/ssr）只能 import 本文件导出内容，不准走子路径。本包零 React/零 DOM 依赖
  */
-export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AT_DIRECTIONS, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
-export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirection, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShape, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, NodeTextAlign, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
-export { ARROW_SHAPES, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, NODE_SHAPES, NODE_TEXT_ALIGNS, PATTERN_SHAPES, Boundary, BoundarySchema, } from './ir';
-export type { BoundaryKeyword, IRBoundary } from './ir';
+export { PositionSchema, PolarPositionSchema, AtPositionSchema, OffsetPositionSchema, AtDirection, TargetSchema, AnchorRefSchema, NodeTargetSchema, RelativeTargetSchema, RelativeAccumulateTargetSchema, AbsoluteTargetSchema, BetweenPositionSchema, MoveStepSchema, LineStepSchema, FoldStepSchema, CycleStepSchema, CurveStepSchema, CubicStepSchema, BendStepSchema, ArcStepSchema, CirclePathStepSchema, EllipsePathStepSchema, RectangleStepSchema, GeneratorStepSchema, ControlPointSchema, StepLabelSchema, StepSchema, NodeSchema, NodeLabelSchema, ShapeRefSchema, CoordinateSchema, FontSchema, TextBlockSchema, LineSpecSchema, PathSchema, ArrowDetailSchema, ArrowEndDetailSchema, ScopeSchema, CompositeBaseSchema, NodeDefaultSchema, PathDefaultSchema, LabelDefaultSchema, ArrowDefaultSchema, TransformSchema, ChildSchema, SceneSchema, CURRENT_IR_VERSION, PaintSpecSchema, GradientStopSchema, JsonValueSchema, JsonObjectSchema, ClipSpecSchema, ViewBoxSchema, } from './ir';
+export type { IRPosition, IRAtPosition, IROffsetPosition, AtDirectionValue, IRTarget, IRAnchorRef, IRNodeTarget, IRRelativeTarget, IRRelativeAccumulateTarget, IRAbsoluteTarget, IRBetweenPosition, IRMoveStep, IRLineStep, IRFoldStep, IRCycleStep, IRCurveStep, IRCubicStep, IRBendStep, IRArcStep, IRCirclePathStep, IREllipsePathStep, IRRectangleStep, IRGeneratorStep, IRControlPoint, IRStepLabel, IRStep, IRNode, IRNodeLabel, IRShapeRef, IRCoordinate, IRFont, IRLineSpec, IRTextBlock, IRPath, IRScope, IRComposite, IRNodeDefault, IRPathDefault, IRLabelDefault, IRArrowDefault, StyleChannel, IRTransform, IRTranslateTransform, IRPolarTranslateTransform, IRAtTranslateTransform, IROffsetTranslateTransform, IRRotateTransform, IRScaleTransform, IRChild, IR, ArrowShapeValue, BuiltinArrowName, ArrowShapeName, IRArrowDetail, IRArrowEndDetail, NodeShape, BuiltinShapeName, BuiltinShapeValue, NodeTextAlignValue, PatternShapeValue, PatternShapeName, BuiltinPatternName, IRPaintSpec, IRGradientStop, JsonValue, IRJsonObject, IRClipSpec, IRViewBox, } from './ir';
+export { ArrowShape, DEFAULT_ARROW_SHAPE, HOLLOW_ARROW_SHAPES, ARROW_MARKER_DEFAULT_SIZE, ARROW_MARKER_HOLLOW_DEFAULT_LINE_WIDTH, BuiltinShape, NodeTextAlign, PatternShape, Boundary, BoundarySchema, AnimationProperty, AnimationEasing, AnimationDirection, AnimationFill, AnimationTrigger, AnimationTrackSchema, KeyframeSchema, TriggerSchema, EasingSchema, OriginSchema, } from './ir';
+export type { BoundaryValue, IRBoundary } from './ir';
+export type { BuiltinAnimationProperty, AnimationPropertyRef, AnimationEasingValue, AnimationDirectionValue, AnimationFillValue, AnimationTriggerValue, IRAnimationTrack, IRKeyframe, IRAnimationTrigger, IRAnimationOrigin, } from './ir';
 export type { ScenePrimitive, RectPrim, EllipsePrim, TextPrim, TextLine, PathPrim, PathCommand, 
 /** 7 个 named PathCommand 分支（便于 wrapper / Pick<>） */
 MovePathCommand, LinePathCommand, QuadPathCommand, CubicPathCommand, ArcPathCommand, EllipseArcPathCommand, ClosePathCommand, ArrowEndSpec, GroupPrim, Transform, 
@@ -21,16 +22,18 @@ export type { FontSpec, TextMetrics, TextMeasurer, CompileOptions, CompileWarnin
 export { computeLayout, fallbackMeasurer, compileToScene } from './compile';
 export type { WayItem, WayDSL, WayCycle, WayVia, WayRelativeItem, WayLabel, WayLabelOp, } from './parsers';
 export { parseWay, DrawWay, parseTargetSugar, parseNodeTarget } from './parsers';
-export type { Position, Rect, RectAnchor, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
-export { point, rect, circle, ellipse, diamond, RECT_ANCHORS, polar } from './geometry';
+export { fadeIn, drawOn, scaleIn, grow, growUp, slideIn, colorShift, cameraTo, pulse, spin, loop, flash, blink, wiggle, stagger, } from './presets';
+export type { AnimationPresetOptions, ScaleInOptions, GrowUpOptions, SlideInOptions, ColorShiftOptions, CameraToOptions, PulseOptions, SpinOptions, LoopOptions, FlashOptions, BlinkOptions, WiggleOptions, } from './presets';
+export type { Position, CompassAnchorValue, AnchorInput, WebAnchorValue, Rect, Circle, Ellipse, Diamond, PolarPosition, } from './geometry';
+export { point, CompassAnchor, WebAnchor, normalizeCompassAnchor, rect, circle, ellipse, diamond, polar, } from './geometry';
 export type { ShapeDefinition, ShapeDefinitionInput, ShapeStyle } from './shapes';
 export { BUILTIN_SHAPES, defineShape, worldToLocal, localToWorld } from './shapes';
 export type { ArrowDefinition, ArrowEmitContext } from './arrows';
-export { BUILTIN_ARROWS } from './arrows';
+export { BUILTIN_ARROWS, defineArrow } from './arrows';
 export type { PatternDefinition, PatternEmitContext } from './patterns';
-export { BUILTIN_PATTERNS } from './patterns';
-export type { PathGeneratorDefinition, PathGeneratorContext } from './pathGenerators';
-export { definePathGenerator } from './pathGenerators';
+export { BUILTIN_PATTERNS, definePattern } from './patterns';
+export type { PathGeneratorDefinition, PathGeneratorContext } from './path-generators';
+export { definePathGenerator } from './path-generators';
 export type { CompositeDefinition } from './composites';
 export { defineComposite } from './composites';
 export type { ValueOf, AssertEqual } from './types';

package/dist/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/ir/animation.cjs

@@ -0,0 +1,127 @@
+const require_json = require("./json.cjs");
+let zod = require("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 = zod.z.union([zod.z.string().min(1), zod.z.tuple([
+	zod.z.number().finite(),
+	zod.z.number().finite(),
+	zod.z.number().finite(),
+	zod.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 = zod.z.object({
+	at: zod.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: require_json.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 = zod.z.union([zod.z.nativeEnum(AnimationTrigger), zod.z.object({ onEvent: zod.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 = zod.z.union([zod.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."), zod.z.tuple([zod.z.number().finite(), zod.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 = zod.z.object({
+	property: zod.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: zod.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: zod.z.number().finite().positive().describe("One-iteration duration in milliseconds (> 0)."),
+	delay: zod.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: zod.z.union([zod.z.number().finite().positive(), zod.z.literal("infinite")]).optional().describe("Total play count (WAAPI iterations): a positive number (may be fractional) or \"infinite\". Omitted = 1 = play once."),
+	direction: zod.z.nativeEnum(AnimationDirection).optional().describe("Per-iteration playback direction (WAAPI / CSS animation-direction). Defaults to \"normal\"."),
+	fill: zod.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: zod.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: zod.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: zod.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
+exports.AnimationDirection = AnimationDirection;
+exports.AnimationEasing = AnimationEasing;
+exports.AnimationFill = AnimationFill;
+exports.AnimationProperty = AnimationProperty;
+exports.AnimationTrackSchema = AnimationTrackSchema;
+exports.AnimationTrigger = AnimationTrigger;
+exports.EasingSchema = EasingSchema;
+exports.KeyframeSchema = KeyframeSchema;
+exports.OriginSchema = OriginSchema;
+exports.TriggerSchema = TriggerSchema;

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

@@ -0,0 +1,219 @@
+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 AnimationPropertyValue = ValueOf<typeof AnimationProperty>;
+export type BuiltinAnimationProperty = AnimationPropertyValue;
+/** 属性名：内置 ∪ 任意自定义字符串（`& {}` 保内置自动补全，同 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 AnimationEasingValue = 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 AnimationDirectionValue = 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 AnimationFillValue = 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 AnimationTriggerValue = 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/lib/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,sBAAsB,GAAG,OAAO,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACvE,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC9D,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,oBAAoB,GAAG,OAAO,CAAC,OAAO,eAAe,CAAC,CAAC;AAEnE,mDAAmD;AACnD,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEzE,iDAAiD;AACjD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AACX,cAAc;AACd,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,aAAa,CAAC,CAAC;AAE/D,eAAO,MAAM,YAAY,mGAOtB,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;EAgBgF,CAAC;AAE5G,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB;;;;CAAkE,CAAC;AAChG,oCAAoC;AACpC,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE,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/lib/ir/boundary.d.ts

@@ -21,5 +21,5 @@ export declare const Boundary: {
     readonly Circle: "circle";
 };
 /** 连接面保留关键字联合（'shape' | 'circle'；其余取值为借用的 shape 引用） */
-export type BoundaryKeyword = ValueOf<typeof Boundary>;
+export type BoundaryValue = ValueOf<typeof Boundary>;
 //# sourceMappingURL=boundary.d.ts.map

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

@@ -1 +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"}
+{"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,aAAa,GAAG,OAAO,CAAC,OAAO,QAAQ,CAAC,CAAC"}

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

@@ -8,14 +8,14 @@ export declare const CoordinateSchema: z.ZodObject<{
     id: z.ZodString;
     position: z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodType<import('./position').PolarPosition, z.ZodTypeDef, import('./position').PolarPosition>, z.ZodObject<{
         direction: z.ZodNativeEnum<{
-            readonly above: "above";
-            readonly below: "below";
-            readonly left: "left";
-            readonly right: "right";
-            readonly 'above-left': "above-left";
-            readonly 'above-right': "above-right";
-            readonly 'below-left': "below-left";
-            readonly 'below-right': "below-right";
+            readonly Above: "above";
+            readonly Below: "below";
+            readonly Left: "left";
+            readonly Right: "right";
+            readonly AboveLeft: "above-left";
+            readonly AboveRight: "above-right";
+            readonly BelowLeft: "below-left";
+            readonly BelowRight: "below-right";
         }>;
         of: z.ZodString;
         distance: z.ZodOptional<z.ZodNumber>;

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

@@ -1,6 +1,7 @@
 export * from './position';
 export * from './font';
 export * from './json';
+export * from './animation';
 export * from './paint';
 export * from './clip';
 export * from './text';

package/dist/lib/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,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"}
+{"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"}

package/dist/lib/ir/node.cjs

@@ -7,25 +7,26 @@ const require_shape = require("./shape.cjs");
 const require_boundary = require("./boundary.cjs");
 const require_between_position = require("./position/between-position.cjs");
 const require_font = require("./font.cjs");
+const require_animation = require("./animation.cjs");
 const require_paint = require("./paint.cjs");
 const require_text = require("./text.cjs");
 let zod = require("zod");
 //#region src/ir/node.ts
 /**
 * 节点形状常量（用 const + ValueOf 派生，不用 TS enum）
-* @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 45° preset 别名（`{ type:'polygon', params:{ sides:4, rotate:45 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
+* @description rectangle 默认；几何语义：node 视觉边界包"text 矩形 + padding"；rectangle: 视觉=text；ellipse: rx=innerHalfW×√2,ry=innerHalfH×√2。circle 是 ellipse 等轴 preset 别名（`{ type:'ellipse', params:{ circumscribe:'equal' } }`，两轴 = 内框对角线半长 √(innerHalfW²+innerHalfH²)）；diamond 是 polygon 4 边形 preset 别名（`{ type:'polygon', params:{ sides:4, rotate:0 } }`）——circle / diamond 均保留为合法 shape 名向后兼容，编译期分别消解为 ellipse / polygon，不进 shape 注册表
 */
-var NODE_SHAPES = {
-	rectangle: "rectangle",
-	circle: "circle",
-	ellipse: "ellipse",
-	diamond: "diamond"
+var BuiltinShape = {
+	Rectangle: "rectangle",
+	Circle: "circle",
+	Ellipse: "ellipse",
+	Diamond: "diamond"
 };
 /** 节点文本对齐（TikZ `align=` 同义） */
-var NODE_TEXT_ALIGNS = {
-	left: "left",
-	center: "center",
-	right: "right"
+var NodeTextAlign = {
+	Left: "left",
+	Center: "center",
+	Right: "right"
 };
 /**
 * 节点附属标签 label（TikZ `[label=above:foo]` 同义）
@@ -33,7 +34,7 @@ var NODE_TEXT_ALIGNS = {
 */
 var NodeLabelSchema = zod.z.object({
 	text: zod.z.string().describe("Label text content; rendered as a single line."),
-	position: zod.z.union([zod.z.nativeEnum(require_at_position.AT_DIRECTIONS), zod.z.number()]).optional().describe("Placement around the node border: 8-direction enum (above / right / above-left / ...) or numeric angle in degrees (`label=30:foo` for radial placement). Default `above`. Numeric uses the polar convention (0° = +x, 90° = +y, screen-down)."),
+	position: zod.z.union([zod.z.nativeEnum(require_at_position.AtDirection), zod.z.number()]).optional().describe("Placement around the node border: 8-direction enum (above / right / above-left / ...) or numeric angle in degrees (`label=30:foo` for radial placement). Default `above`. Numeric uses the polar convention (0° = +x, 90° = +y, screen-down)."),
 	distance: zod.z.number().nonnegative().optional().describe("Gap between the node border and the label center, in user units. Default 12."),
 	textColor: zod.z.string().optional().describe("Label text color; falls back to currentColor."),
 	opacity: zod.z.number().min(0).max(1).optional().describe("Label-only opacity 0..1; multiplied with the node opacity if both are set."),
@@ -56,6 +57,7 @@ var NodeSchema = zod.z.object({
 	shape: zod.z.union([zod.z.string().min(1), require_shape.ShapeRefSchema]).optional().describe("Node visual shape: a bare name string (parameterless, e.g. \"rectangle\") or `{ type, params }` carrying a JSON params object (e.g. `{ type:\"sector\", params:{ innerRadius, outerRadius, startAngle, endAngle } }`). Built-in or registered via CompileOptions.shapes; unregistered type rejected at compile time. Defaults to \"rectangle\"."),
 	boundary: require_boundary.BoundarySchema.optional().describe("Default connection surface for edges meeting this node (see BoundarySchema). Defaults to \"shape\" (use the visual shape). Per-edge overridable via the edge endpoint `boundary` field."),
 	meta: require_json.JsonObjectSchema.optional().describe("Opaque provenance metadata carried by this element (e.g. a Tier 2 lowering tagging which datum / series / layer it came from). Provenance passthrough: preserved verbatim into the Scene primitive(s) this element emits, ignored by renderers, and never interpreted by the compiler — it does not affect layout, connection, style, or bounding box. Must be a JSON object (fully serializable). Not inherited across scopes; not part of the every-X style defaults."),
+	animations: zod.z.array(require_animation.AnimationTrackSchema).optional().describe("Declarative timeline animation tracks for this element (fadeIn / drawOn / pulse / …). Each track animates one renderer-agnostic property over normalized time; the element base value is the settled (animation-end) state. Carried verbatim into the Scene primitive(s) this element emits; renderers play them or, when unable, render the static settled state with a diagnosable warning. Does not affect layout / bounding box (animations may transiently overflow). Not inherited across scopes; not part of the every-X style defaults."),
 	position: zod.z.union([
 		require_position.PositionSchema,
 		require_polar_position.PolarPositionSchema,
@@ -63,9 +65,9 @@ var NodeSchema = zod.z.object({
 		require_offset_position.OffsetPositionSchema,
 		require_between_position.BetweenPositionSchema
 	]).describe("Center point of the node content box; Cartesian [x, y], polar, relative-to-another-node (`at`-style with `direction` / `of` / `distance?`), offset from a base point (`{ of, offset }` form mirroring TikZ `calc`), or between two endpoints (`{ between: [A, B], t }` proportional point). All non-Cartesian forms resolve at compile time."),
-	rotate: zod.z.number().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
-	text: require_text.TextBlockSchema.optional(),
-	align: zod.z.nativeEnum(NODE_TEXT_ALIGNS).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
+	rotate: zod.z.number().finite().optional().describe("Rotation in degrees around the node center; positive = clockwise (matches TikZ rotate=...)"),
+	text: require_text.TextBlockSchema.optional().describe("Optional node text content; accepts a string, an array of lines, or styled text line objects. A literal newline (\"\\n\") inside any string is a hard line break, so one string with newlines renders as multiple lines. When omitted the node emits only its shape primitive; when present it participates in text measurement, node box sizing, and TextPrim emission."),
+	align: zod.z.nativeEnum(NodeTextAlign).optional().describe("Multi-line text alignment within the text block; `left` / `center` / `right`. Defaults to `center` (matches TikZ)."),
 	lineHeight: zod.z.number().positive().optional().describe("Line height in user units; falls back to `font.size × 1.2` when omitted."),
 	maxTextWidth: zod.z.number().finite().positive().optional().describe("Max line width before wrapping (user units). The text box shrinks to the actual longest line for short text — this is a wrap threshold, NOT a fixed paragraph width. Western text wraps on word boundaries, CJK per character. Omitted = no auto-wrap (only manual line breaks)."),
 	color: zod.z.string().optional().describe("Master color (TikZ `color=`). When set, stroke / fill / text default to it unless individually overridden, and it cascades to the inner text and edge labels. Individual fields (stroke / fill / textColor) always win over this within the same node."),
@@ -73,10 +75,10 @@ var NodeSchema = zod.z.object({
 	fillOpacity: zod.z.number().min(0).max(1).optional().describe("Fill opacity 0..1; affects only the shape fill, leaves stroke / text alone."),
 	stroke: zod.z.string().optional().describe("Border color of the node shape; any CSS color. Defaults to currentColor when omitted"),
 	drawOpacity: zod.z.number().min(0).max(1).optional().describe("Stroke opacity 0..1 (TikZ `draw opacity`); affects only the border."),
-	strokeWidth: zod.z.number().optional().describe("Border width in user units; defaults to 1 when omitted"),
-	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashArray` takes precedence."),
-	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashArray` and `dashed` take precedence."),
-	dashArray: zod.z.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
+	strokeWidth: zod.z.number().finite().nonnegative().optional().describe("Border width in user units; defaults to 1 when omitted"),
+	dashed: zod.z.boolean().optional().describe("Border style preset: dashed line (TikZ `dashed`); compiled to a default dash pattern. `dashPattern` takes precedence."),
+	dotted: zod.z.boolean().optional().describe("Border style preset: dotted line (TikZ `dotted`); compiled to a default dot pattern. `dashPattern` and `dashed` take precedence."),
+	dashPattern: zod.z.array(zod.z.number().finite().nonnegative()).min(1).optional().describe("Explicit stroke dash pattern lengths in user units (e.g. [4, 2]); overrides `dashed` / `dotted`."),
 	cornerRadius: zod.z.number().nonnegative().optional().describe("Migration-period top-level corner radius in user units; only effective on `rectangle` shape. Prefer the shape params form `{ type: \"rectangle\", params: { cornerRadius } }`."),
 	minimumWidth: zod.z.number().nonnegative().optional().describe("Minimum visual border width in user units; floors the bounding box width."),
 	minimumHeight: zod.z.number().nonnegative().optional().describe("Minimum visual border height in user units; floors the bounding box height."),
@@ -88,15 +90,15 @@ var NodeSchema = zod.z.object({
 	opacity: zod.z.number().min(0).max(1).optional().describe("Whole-node opacity 0..1; applies uniformly to shape and text."),
 	innerXSep: zod.z.number().nonnegative().optional().describe("Inner horizontal padding from text to border in user units. Falls back to `padding` then default."),
 	innerYSep: zod.z.number().nonnegative().optional().describe("Inner vertical padding from text to border in user units. Falls back to `padding` then default."),
-	outerSep: zod.z.number().nonnegative().optional().describe("Outer margin from border to path attachment point in user units; does NOT change the visible border. Falls back to `margin`."),
+	outerSep: zod.z.number().nonnegative().optional().describe("Uniform outer offset (TikZ `outer sep`) around the node connection boundary, in user units. Applies to ALL border references — automatic edge endpoints AND explicit compass/angle anchors (e.g. `A.north`, `A.30`) — and is included in the node layout footprint / viewBox. Does NOT change the visible shape; center, shape-specific anchors, edge points, and label attachment stay on the visual shape. Default 0. Falls back to `margin`."),
 	padding: zod.z.number().nonnegative().optional().describe("Symmetric inner padding (alias for `innerXSep` + `innerYSep`); axis-specific fields take precedence."),
-	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer margin (alias for `outerSep`); axis-specific field takes precedence."),
+	margin: zod.z.number().nonnegative().optional().describe("Symmetric outer offset, alias for `outerSep` (TikZ `outer sep`); the axis-specific `outerSep` field takes precedence."),
 	font: require_font.FontSchema.optional().describe("Font spec for the inner text label (family / size / weight / style); all fields optional, all fall back to renderer defaults."),
 	label: zod.z.union([NodeLabelSchema, zod.z.array(NodeLabelSchema)]).optional().describe("Extra label(s) attached around the node border (TikZ `[label=above:foo]`); single object or array form. Compiled into one TextPrim per label, positioned by `position` direction / angle and `distance`."),
 	zIndex: zod.z.number().int().finite().optional().describe("Explicit stacking order among sibling IR children. Higher draws on top. Omitted = 0 = source order. Sorting is stable: same zIndex keeps source order. Scoped per group (a node inside a scope only restacks within that scope).")
-}).describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
+}).strict().describe("Node primitive: a positioned, optionally textual shape (rectangle / circle / ellipse / diamond)");
 //#endregion
-exports.NODE_SHAPES = NODE_SHAPES;
-exports.NODE_TEXT_ALIGNS = NODE_TEXT_ALIGNS;
+exports.BuiltinShape = BuiltinShape;
 exports.NodeLabelSchema = NodeLabelSchema;
 exports.NodeSchema = NodeSchema;
+exports.NodeTextAlign = NodeTextAlign;