locusing 0.1.2

package/dist/diagram-Djxa_kGR.d.ts

@@ -0,0 +1,1945 @@
+/**
+ * @locusing/math - 数学工具库
+ *
+ * 提供向量、矩阵、贝塞尔曲线等数学运算
+ */
+type Vector2 = [number, number];
+type Vector3 = [number, number, number];
+type Point = Vector2;
+declare function V2(x: number, y: number): Vector2;
+declare function V3(x: number, y: number, z: number): Vector3;
+declare const ORIGIN: Vector2;
+declare const UP: Vector2;
+declare const DOWN: Vector2;
+declare const LEFT: Vector2;
+declare const RIGHT: Vector2;
+declare const UL: Vector2;
+declare const UR: Vector2;
+declare const DL: Vector2;
+declare const DR: Vector2;
+/**
+ * Manim 风格方向常量（数学坐标系，Y 向上为正）
+ *
+ * 用于 Frame 模式渲染，原点在画布中心
+ *
+ * @example
+ * ```typescript
+ * import { Dir, scale } from 'locusing';
+ *
+ * // 正方形向上移动 2 单位
+ * square(1).move(scale(Dir.UP, 2));
+ *
+ * // 圆形在右下角
+ * circle(0.5).move(scale(Dir.DR, 3));
+ * ```
+ */
+declare const Dir: {
+    /** 原点 [0, 0] */
+    ORIGIN: Vector2;
+    /** 向上 [0, 1] */
+    UP: Vector2;
+    /** 向下 [0, -1] */
+    DOWN: Vector2;
+    /** 向左 [-1, 0] */
+    LEFT: Vector2;
+    /** 向右 [1, 0] */
+    RIGHT: Vector2;
+    /** 左上 [-1, 1] */
+    UL: Vector2;
+    /** 右上 [1, 1] */
+    UR: Vector2;
+    /** 左下 [-1, -1] */
+    DL: Vector2;
+    /** 右下 [1, -1] */
+    DR: Vector2;
+};
+declare function add(a: Vector2, b: Vector2): Vector2;
+declare function sub(a: Vector2, b: Vector2): Vector2;
+declare function mul(v: Vector2, scalar: number): Vector2;
+declare function div(v: Vector2, scalar: number): Vector2;
+declare function dot(a: Vector2, b: Vector2): number;
+declare function cross(a: Vector2, b: Vector2): number;
+declare function length(v: Vector2): number;
+declare function normalize(v: Vector2): Vector2;
+declare function distance(a: Vector2, b: Vector2): number;
+declare function angle(v: Vector2): number;
+declare function angleBetween(a: Vector2, b: Vector2): number;
+declare function rotate(v: Vector2, radians: number): Vector2;
+declare function lerp(a: Vector2, b: Vector2, t: number): Vector2;
+declare function midpoint(a: Vector2, b: Vector2): Vector2;
+declare function perpendicular(v: Vector2): Vector2;
+declare function reflect(v: Vector2, normal: Vector2): Vector2;
+type Matrix3 = [
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number,
+    number
+];
+declare const IDENTITY: Matrix3;
+declare function matrixMultiply(a: Matrix3, b: Matrix3): Matrix3;
+declare function applyMatrix(m: Matrix3, v: Vector2): Vector2;
+declare function translationMatrix(tx: number, ty: number): Matrix3;
+declare function rotationMatrix(radians: number): Matrix3;
+declare function scaleMatrix(sx: number, sy?: number): Matrix3;
+declare function quadraticBezier(p0: Vector2, p1: Vector2, p2: Vector2, t: number): Vector2;
+declare function cubicBezier(p0: Vector2, p1: Vector2, p2: Vector2, p3: Vector2, t: number): Vector2;
+declare function sampleParametric(fn: (t: number) => Vector2, start?: number, end?: number, segments?: number): Vector2[];
+type EasingFunction = (t: number) => number;
+declare const easing: {
+    linear: (t: number) => number;
+    easeInQuad: (t: number) => number;
+    easeOutQuad: (t: number) => number;
+    easeInOutQuad: (t: number) => number;
+    easeInCubic: (t: number) => number;
+    easeOutCubic: (t: number) => number;
+    easeInOutCubic: (t: number) => number;
+    easeInSine: (t: number) => number;
+    easeOutSine: (t: number) => number;
+    easeInOutSine: (t: number) => number;
+    easeInExpo: (t: number) => number;
+    easeOutExpo: (t: number) => number;
+    easeInOutExpo: (t: number) => number;
+    easeInBack: (t: number) => number;
+    easeOutBack: (t: number) => number;
+    easeInOutBack: (t: number) => number;
+    easeInElastic: (t: number) => number;
+    easeOutElastic: (t: number) => number;
+    easeInBounce: (t: number) => number;
+    easeOutBounce: (t: number) => number;
+    /**
+     * thereAndBack - 去而复返
+     *
+     * 从 0 开始，到 0.5 时达到 1，然后回到 0
+     */
+    thereAndBack: (t: number) => number;
+    /**
+     * thereAndBackWithPause - 去而复返（带停顿）
+     *
+     * 类似 thereAndBack，但在中间有一段停留时间
+     * @param pauseRatio - 停顿占总时间的比例，默认 1/3
+     */
+    thereAndBackWithPause: (t: number, pauseRatio?: number) => number;
+    /**
+     * runningStart - 起跑式
+     *
+     * 先后退一点，再向前冲（类似起跑动作）
+     * @param pullFactor - 后退程度，默认 -0.3
+     */
+    runningStart: (t: number, pullFactor?: number) => number;
+    /**
+     * wiggle - 摇摆
+     *
+     * 产生摇摆效果，适合强调动画
+     */
+    wiggle: (t: number, wiggles?: number) => number;
+    /**
+     * exponentialDecay - 指数衰减
+     *
+     * 快速到达目标后缓慢稳定
+     * @param halfLife - 半衰期，值越小衰减越快，默认 0.1
+     */
+    exponentialDecay: (t: number, halfLife?: number) => number;
+};
+declare const PI: number;
+declare const TAU: number;
+declare const DEGREES: number;
+declare function degToRad(degrees: number): number;
+declare function radToDeg(radians: number): number;
+declare function clamp(value: number, min: number, max: number): number;
+declare function mapRange(value: number, inMin: number, inMax: number, outMin: number, outMax: number): number;
+declare function lerpNumber(a: number, b: number, t: number): number;
+
+/**
+ * @locusing/core - 核心类型定义
+ */
+
+interface Style {
+    fill?: string;
+    fillOpacity?: number;
+    stroke?: string;
+    strokeWidth?: number;
+    strokeOpacity?: number;
+    strokeDasharray?: string;
+    strokeLinecap?: 'butt' | 'round' | 'square';
+    strokeLinejoin?: 'miter' | 'round' | 'bevel';
+    opacity?: number;
+}
+interface TextStyle extends Style {
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: string | number;
+    fontStyle?: string;
+    textAnchor?: 'start' | 'middle' | 'end';
+    dominantBaseline?: 'auto' | 'middle' | 'hanging' | 'central';
+}
+type ShapeType = 'group' | 'path' | 'rect' | 'circle' | 'ellipse' | 'line' | 'polyline' | 'polygon' | 'text' | 'arc' | 'tex' | 'svg' | 'image';
+type PathCommand = {
+    type: 'M';
+    x: number;
+    y: number;
+} | {
+    type: 'L';
+    x: number;
+    y: number;
+} | {
+    type: 'H';
+    x: number;
+} | {
+    type: 'V';
+    y: number;
+} | {
+    type: 'C';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    type: 'S';
+    x2: number;
+    y2: number;
+    x: number;
+    y: number;
+} | {
+    type: 'Q';
+    x1: number;
+    y1: number;
+    x: number;
+    y: number;
+} | {
+    type: 'T';
+    x: number;
+    y: number;
+} | {
+    type: 'A';
+    rx: number;
+    ry: number;
+    angle: number;
+    largeArc: boolean;
+    sweep: boolean;
+    x: number;
+    y: number;
+} | {
+    type: 'Z';
+};
+interface BaseShape {
+    id: string;
+    type: ShapeType;
+    style: Style;
+    transform: Matrix3;
+    _bounds?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+interface GroupShape extends BaseShape {
+    type: 'group';
+    children: Shape[];
+}
+interface PathShape extends BaseShape {
+    type: 'path';
+    commands: PathCommand[];
+}
+interface RectShape extends BaseShape {
+    type: 'rect';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rx?: number;
+    ry?: number;
+}
+interface CircleShape extends BaseShape {
+    type: 'circle';
+    cx: number;
+    cy: number;
+    r: number;
+}
+interface EllipseShape extends BaseShape {
+    type: 'ellipse';
+    cx: number;
+    cy: number;
+    rx: number;
+    ry: number;
+}
+interface LineShape extends BaseShape {
+    type: 'line';
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+interface PolylineShape extends BaseShape {
+    type: 'polyline';
+    points: Vector2[];
+}
+interface PolygonShape extends BaseShape {
+    type: 'polygon';
+    points: Vector2[];
+}
+interface TextShape extends BaseShape {
+    type: 'text';
+    style: TextStyle;
+    x: number;
+    y: number;
+    content: string;
+}
+interface ArcShape extends BaseShape {
+    type: 'arc';
+    cx: number;
+    cy: number;
+    r: number;
+    startAngle: number;
+    endAngle: number;
+}
+interface TexShape extends BaseShape {
+    type: 'tex';
+    x: number;
+    y: number;
+    latex: string;
+    html: string;
+    fontSize: number;
+    color: string;
+}
+interface SVGShape extends BaseShape {
+    type: 'svg';
+    content: string;
+    width: number;
+    height: number;
+    originalWidth: number;
+    originalHeight: number;
+    viewBox?: string;
+}
+interface ImageShape extends BaseShape {
+    type: 'image';
+    src: string;
+    width: number;
+    height: number;
+    cornerRadius?: number;
+}
+type Shape = GroupShape | PathShape | RectShape | CircleShape | EllipseShape | LineShape | PolylineShape | PolygonShape | TextShape | ArcShape | TexShape | SVGShape | ImageShape;
+interface FrameConfig {
+    /** 逻辑宽度（默认 16） */
+    width: number;
+    /** 逻辑高度（默认 9，16:9 比例） */
+    height: number;
+}
+interface RenderOptions {
+    /** 画布像素宽度 */
+    width?: number;
+    /** 画布像素高度 */
+    height?: number;
+    /** 背景颜色 */
+    background?: string;
+    /**
+     * Frame 配置（Manim 风格坐标系）
+     *
+     * 启用后：
+     * - 原点在画布中心
+     * - Y 轴向上为正
+     * - 图形使用逻辑坐标，自动映射到像素
+     *
+     * 可以是 boolean（使用默认 16:9 frame）或 FrameConfig 对象
+     */
+    frame?: boolean | FrameConfig;
+    /** 手绘风格 */
+    rough?: boolean;
+    roughness?: number;
+    bowing?: number;
+    seed?: number;
+}
+interface SliderOptions {
+    min: number;
+    max: number;
+    value?: number;
+    step?: number;
+    label?: string;
+    showPlayButton?: boolean;
+    playDuration?: number;
+}
+interface LocatorOptions {
+    x: number;
+    y: number;
+    radius?: number;
+    constraint?: (p: Vector2) => Vector2;
+}
+interface AnimationOptions {
+    duration?: number;
+    easing?: string;
+    delay?: number;
+    lagRatio?: number;
+}
+
+/**
+ * @locusing/animate - 时间线引擎
+ *
+ * 基于 GSAP 的动画时间线管理
+ */
+type AnimationStatus = 'pending' | 'running' | 'paused' | 'completed';
+interface TimelineOptions {
+    duration?: number;
+    easing?: string;
+    delay?: number;
+    repeat?: number;
+    yoyo?: boolean;
+    onStart?: () => void;
+    onComplete?: () => void;
+    onUpdate?: (progress: number) => void;
+}
+/**
+ * Timeline 类 - 动画时间线管理
+ */
+declare class Timeline {
+    private timeline;
+    private _status;
+    constructor(options?: TimelineOptions);
+    /** 当前状态 */
+    get status(): AnimationStatus;
+    /** 当前进度 (0-1) */
+    get progress(): number;
+    /** 总时长 */
+    get duration(): number;
+    /** 当前时间 */
+    get time(): number;
+    /**
+     * 添加动画到时间线
+     */
+    add(target: object | string, vars: gsap.TweenVars, position?: gsap.Position): this;
+    /**
+     * 添加回调函数
+     */
+    call(callback: () => void, position?: gsap.Position): this;
+    /**
+     * 添加延迟
+     */
+    delay(seconds: number, position?: gsap.Position): this;
+    /**
+     * 添加标签
+     */
+    label(name: string, position?: gsap.Position): this;
+    /**
+     * 播放
+     */
+    play(): this;
+    /**
+     * 暂停
+     */
+    pause(): this;
+    /**
+     * 恢复
+     */
+    resume(): this;
+    /**
+     * 停止并重置
+     */
+    restart(): this;
+    /**
+     * 跳转到指定时间
+     */
+    seek(time: number | string): this;
+    /**
+     * 设置进度
+     */
+    setProgress(progress: number): this;
+    /**
+     * 设置速度
+     */
+    setSpeed(speed: number): this;
+    /**
+     * 反向播放
+     */
+    reverse(): this;
+    /**
+     * 销毁
+     */
+    kill(): void;
+    /**
+     * 等待完成
+     */
+    finished(): Promise<void>;
+}
+/**
+ * 创建时间线
+ */
+declare function createTimeline(options?: TimelineOptions): Timeline;
+/**
+ * GSAP 缓动函数映射
+ */
+declare const easingMap: Record<string, string>;
+/**
+ * 获取 GSAP 缓动字符串
+ */
+declare function getGSAPEasing(easing: string): string;
+
+/**
+ * Camera - 基础相机系统
+ *
+ * 控制 SVG 视口的位置和缩放
+ */
+
+/**
+ * 相机配置
+ */
+interface CameraConfig {
+    /** 视口中心位置 */
+    frameCenter?: Vector2;
+    /** 视口宽度 */
+    frameWidth?: number;
+    /** 视口高度 */
+    frameHeight?: number;
+}
+/**
+ * 视口帧
+ */
+interface Frame {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Camera 类
+ *
+ * 管理 SVG 视口，支持平移和缩放
+ */
+declare class Camera {
+    protected _center: Vector2;
+    protected _width: number;
+    protected _height: number;
+    /**
+     * 创建相机
+     * @param config - 相机配置
+     */
+    constructor(config?: CameraConfig);
+    /**
+     * 获取视口中心
+     */
+    get center(): Vector2;
+    /**
+     * 设置视口中心
+     */
+    set center(value: Vector2);
+    /**
+     * 获取视口宽度
+     */
+    get width(): number;
+    /**
+     * 设置视口宽度
+     */
+    set width(value: number);
+    /**
+     * 获取视口高度
+     */
+    get height(): number;
+    /**
+     * 设置视口高度
+     */
+    set height(value: number);
+    /**
+     * 获取可视区域
+     */
+    getFrame(): Frame;
+    /**
+     * 移动相机到指定位置
+     * @param point - 目标位置
+     */
+    moveTo(point: Vector2): this;
+    /**
+     * 相对移动相机
+     * @param delta - 移动增量
+     */
+    moveBy(delta: Vector2): this;
+    /**
+     * 缩放视口
+     * @param factor - 缩放因子（>1 缩小视野，<1 放大视野）
+     */
+    zoom(factor: number): this;
+    /**
+     * 设置视口大小
+     * @param width - 宽度
+     * @param height - 高度
+     */
+    setSize(width: number, height: number): this;
+    /**
+     * 重置相机到初始状态
+     */
+    reset(): this;
+    /**
+     * 获取 SVG viewBox 字符串
+     */
+    getViewBox(): string;
+    /**
+     * 应用相机设置到 SVG 元素
+     * @param svg - SVG 元素
+     */
+    applyToSVG(svg: SVGSVGElement): void;
+    /**
+     * 将屏幕坐标转换为世界坐标
+     * @param screenPoint - 屏幕坐标
+     * @param svgWidth - SVG 元素宽度
+     * @param svgHeight - SVG 元素高度
+     */
+    screenToWorld(screenPoint: Vector2, svgWidth: number, svgHeight: number): Vector2;
+    /**
+     * 将世界坐标转换为屏幕坐标
+     * @param worldPoint - 世界坐标
+     * @param svgWidth - SVG 元素宽度
+     * @param svgHeight - SVG 元素高度
+     */
+    worldToScreen(worldPoint: Vector2, svgWidth: number, svgHeight: number): Vector2;
+    /**
+     * 检查点是否在视口内
+     * @param point - 要检查的点
+     */
+    isPointInView(point: Vector2): boolean;
+    /**
+     * 获取当前缩放级别
+     * @param baseWidth - 基准宽度（默认 400）
+     */
+    getZoomLevel(baseWidth?: number): number;
+    /**
+     * 设置缩放级别
+     * @param level - 目标缩放级别
+     * @param baseWidth - 基准宽度（默认 400）
+     */
+    setZoomLevel(level: number, baseWidth?: number): this;
+    /**
+     * 克隆相机
+     */
+    clone(): Camera;
+}
+/**
+ * 创建相机
+ * @param config - 相机配置
+ */
+declare function createCamera(config?: CameraConfig): Camera;
+
+/**
+ * @locusing/animate - Scene 场景管理
+ *
+ * Manim 风格的场景类
+ */
+
+/** 预设配置类型 */
+type ScenePreset = 'default' | 'manim';
+interface SceneConfig {
+    width?: number;
+    height?: number;
+    background?: string;
+    fps?: number;
+    rough?: boolean;
+    /** 相机配置 */
+    camera?: CameraConfig;
+    /**
+     * 预设配置
+     * - 'default': Locusing 默认 (16×9)
+     * - 'manim': Manim 兼容模式 (14.22×8)
+     */
+    preset?: ScenePreset;
+    /**
+     * 是否自动适配容器比例
+     * 当为 true 且未指定 camera.frameWidth/frameHeight 时，
+     * 会根据容器的宽高比自动计算 frame 尺寸
+     * @default false
+     */
+    autoFitFrame?: boolean;
+}
+/**
+ * Scene 类 - Manim 风格的场景管理
+ *
+ * 使用方式一：继承并实现 construct 方法
+ * ```typescript
+ * class MyScene extends Scene {
+ *   construct() {
+ *     const sq = square(0.5).fill('#EA580C');
+ *     this.play(Create(sq));
+ *     this.wait(1);
+ *     this.play(FadeOut(sq));
+ *   }
+ * }
+ * // 在编辑器或文档中使用
+ * play(MyScene);
+ * ```
+ *
+ * 使用方式二：传入容器直接使用
+ * ```typescript
+ * const scene = new MyScene();
+ * scene.setup(svgElement, { width: 800, height: 600 });
+ * scene.construct();
+ * ```
+ */
+/** 内部配置类型（不包含 camera，因为 camera 作为独立实例管理） */
+interface InternalSceneConfig {
+    width: number;
+    height: number;
+    background: string;
+    fps: number;
+    rough: boolean;
+}
+/** Updater 函数类型 */
+type UpdaterFunction = (diagram: Diagram, dt: number) => void;
+/** Updater 配置 */
+interface UpdaterConfig {
+    /** Updater 函数 */
+    fn: UpdaterFunction;
+    /** 关联的图形 */
+    diagram: Diagram;
+}
+declare abstract class Scene {
+    protected container: HTMLElement | SVGSVGElement;
+    protected svg: SVGSVGElement;
+    /** Y 轴翻转组，所有内容都渲染到这个组中 */
+    protected flipGroup: SVGGElement;
+    protected config: InternalSceneConfig;
+    protected timeline: Timeline;
+    protected objects: Map<string, Diagram>;
+    protected currentTime: number;
+    protected _isSetup: boolean;
+    /** Frame 逻辑尺寸（用于坐标系统） */
+    protected frameWidth: number;
+    protected frameHeight: number;
+    /** 相机实例 */
+    camera: Camera;
+    /** Updaters 列表 */
+    protected updaters: UpdaterConfig[];
+    /** 上一帧时间（用于计算 dt） */
+    protected lastFrameTime: number;
+    /** 动画帧 ID */
+    protected animationFrameId: number | null;
+    /** 更新是否暂停 */
+    protected updatesSuspended: boolean;
+    /**
+     * 创建 Scene 实例
+     * @param container - 可选的容器元素。如果不传，需要后续调用 setup() 方法
+     * @param config - 场景配置
+     */
+    constructor(container?: HTMLElement | SVGSVGElement, config?: SceneConfig);
+    /**
+     * 初始化场景（内部方法）
+     */
+    private initScene;
+    /**
+     * 更新相机的 viewBox 到 SVG
+     * 在相机移动或缩放后调用此方法
+     */
+    updateCameraViewBox(): void;
+    /**
+     * 设置场景（延迟初始化）
+     * 用于编辑器和文档中的使用场景，在实例化后调用
+     *
+     * @param svgOrContainer - SVG 元素或容器元素
+     * @param config - 场景配置
+     */
+    setup(svgOrContainer: SVGSVGElement | HTMLElement, config?: SceneConfig): void;
+    /** 子类实现此方法来构建动画 */
+    abstract construct(): void | Promise<void>;
+    /**
+     * 添加图形到场景（不带动画）
+     */
+    add(...diagrams: Diagram[]): void;
+    /**
+     * 从场景移除图形
+     */
+    remove(...diagrams: Diagram[]): void;
+    /**
+     * 播放动画
+     *
+     * 支持 Animation、AnimateProxy 和 AnimationConfig
+     *
+     * @param args - 动画、AnimateProxy 或配置
+     *
+     * @example
+     * ```typescript
+     * // 普通动画
+     * this.play(Create(circle));
+     *
+     * // Manim 风格的 .animate 语法
+     * this.play(circle.animate.shift([2, 0]).scale(2));
+     *
+     * // 多个动画
+     * this.play(Create(circle), Create(square));
+     *
+     * // 带配置
+     * this.play(Create(circle), { lagRatio: 0.5 });
+     * ```
+     */
+    play(...args: (Animation | AnimateProxy | AnimationConfig)[]): void;
+    /**
+     * 等待指定时间
+     */
+    wait(seconds?: number): void;
+    /**
+     * 为图形添加 updater
+     *
+     * Updater 会在每一帧被调用，用于创建动态效果
+     *
+     * @param diagram - 要添加 updater 的图形
+     * @param fn - updater 函数，接收图形和时间增量
+     *
+     * @example
+     * ```typescript
+     * const dot = circle(0.1).fill('#EA580C');
+     * this.add(dot);
+     *
+     * // 让 dot 跟随鼠标或按时间变化
+     * this.addUpdater(dot, (d, dt) => {
+     *   const t = this.getTime();
+     *   return d.move([Math.cos(t), Math.sin(t)]);
+     * });
+     * ```
+     */
+    addUpdater(diagram: Diagram, fn: UpdaterFunction): void;
+    /**
+     * 移除图形的 updater
+     */
+    removeUpdater(diagram: Diagram, fn?: UpdaterFunction): void;
+    /**
+     * 清除所有 updaters
+     */
+    clearUpdaters(): void;
+    /**
+     * 获取图形的所有 updaters
+     *
+     * @param diagram - 可选，指定图形。如果不传则返回所有 updaters
+     */
+    getUpdaters(diagram?: Diagram): UpdaterFunction[];
+    /**
+     * 暂停更新
+     *
+     * 暂停所有 updater 的执行，直到调用 resumeUpdating()
+     */
+    suspendUpdating(): void;
+    /**
+     * 恢复更新
+     *
+     * 恢复所有 updater 的执行
+     */
+    resumeUpdating(): void;
+    /**
+     * 检查更新是否暂停
+     */
+    isUpdatingSuspended(): boolean;
+    /**
+     * 获取当前时间（秒）
+     */
+    getTime(): number;
+    /**
+     * 启动帧循环（用于 updaters）
+     */
+    protected startFrameLoop(): void;
+    /**
+     * 停止帧循环
+     */
+    protected stopFrameLoop(): void;
+    /**
+     * 运行场景
+     */
+    render(): Promise<void>;
+    /**
+     * 启动动画播放
+     * 调用此方法开始播放 construct() 中构建的动画
+     *
+     * @returns Promise 在动画完成后 resolve
+     */
+    start(): Promise<void>;
+    /**
+     * 渲染单个图形到 SVG（使用 Frame 模式）
+     */
+    protected renderDiagram(diagram: Diagram): SVGElement | null;
+    /**
+     * 获取图形对应的 SVG 元素
+     */
+    getElement(diagram: Diagram): SVGElement | null;
+    /**
+     * 获取或创建图形元素
+     */
+    getOrCreateElement(diagram: Diagram): SVGElement;
+    /**
+     * 更新场景中的对象映射
+     *
+     * 用于在动画完成后将旧对象替换为新对象
+     *
+     * @param oldDiagram - 旧图形
+     * @param newDiagram - 新图形
+     */
+    updateObject(oldDiagram: Diagram, newDiagram: Diagram): void;
+    /**
+     * 获取 SVG 容器
+     */
+    getSVG(): SVGSVGElement;
+    /**
+     * 获取配置
+     */
+    getConfig(): InternalSceneConfig;
+    /**
+     * 导出为 SVG 字符串
+     */
+    toSVGString(): string;
+    /**
+     * 暂停
+     */
+    pause(): void;
+    /**
+     * 恢复
+     */
+    resume(): void;
+    /**
+     * 重新开始
+     */
+    restart(): void;
+    /**
+     * 销毁场景
+     */
+    destroy(): void;
+}
+/**
+ * 创建简单场景（不需要继承）
+ */
+declare function createScene(container: HTMLElement, buildFn: (scene: SimpleScene) => void, config?: SceneConfig): SimpleScene;
+declare class SimpleScene extends Scene {
+    private buildFn;
+    constructor(container: HTMLElement, buildFn: (scene: SimpleScene) => void, config?: SceneConfig);
+    construct(): void;
+}
+
+/**
+ * @locusing/animate - 动画类型定义
+ */
+
+/**
+ * 动画配置
+ */
+interface AnimationConfig {
+    duration?: number;
+    easing?: string;
+    delay?: number;
+    lagRatio?: number;
+    runTime?: number;
+}
+/**
+ * 动画接口
+ */
+interface Animation {
+    /** 动画时长 */
+    duration: number;
+    /** 目标图形 */
+    target: Diagram;
+    /** 执行动画 */
+    execute(scene: Scene, timeline: Timeline, startTime: number): void;
+}
+/**
+ * 创建动画选项
+ */
+interface CreateOptions extends AnimationConfig {
+    /** 是否先描边再填充 */
+    drawBorderThenFill?: boolean;
+}
+/**
+ * 淡入淡出选项
+ */
+interface FadeOptions extends AnimationConfig {
+    /** 方向 */
+    direction?: Vector2 | 'UP' | 'DOWN' | 'LEFT' | 'RIGHT';
+    /** 位移距离 */
+    shift?: number;
+}
+/**
+ * 变换选项
+ */
+interface TransformOptions extends AnimationConfig {
+    /** 路径函数 */
+    pathFunc?: (t: number) => Vector2;
+    /** 是否替换原对象 */
+    replace?: boolean;
+}
+/**
+ * 移动选项
+ */
+interface MoveOptions extends AnimationConfig {
+    /** 路径 */
+    path?: Diagram;
+    /** 是否旋转跟随路径 */
+    rotateAlongPath?: boolean;
+}
+/**
+ * 旋转选项
+ */
+interface RotateOptions extends AnimationConfig {
+    /** 旋转中心 */
+    aboutPoint?: Vector2;
+    /** 旋转角度（弧度） */
+    angle?: number;
+}
+/**
+ * 缩放选项
+ */
+interface ScaleOptions extends AnimationConfig {
+    /** 缩放中心 */
+    aboutPoint?: Vector2;
+    /** 缩放因子 */
+    factor?: number;
+}
+/**
+ * 指示动画选项
+ */
+interface IndicateOptions extends AnimationConfig {
+    /** 高亮颜色 */
+    color?: string;
+    /** 缩放因子 */
+    scaleFactor?: number;
+}
+/**
+ * 圈出选项
+ */
+interface CircumscribeOptions extends AnimationConfig {
+    /** 形状：圆形或矩形 */
+    shape?: 'circle' | 'rectangle';
+    /** 颜色 */
+    color?: string;
+    /** 线条宽度 */
+    strokeWidth?: number;
+    /** 填充 */
+    fill?: boolean;
+    /** 填充透明度 */
+    fillOpacity?: number;
+}
+/**
+ * 闪光选项
+ */
+interface FlashOptions extends AnimationConfig {
+    /** 颜色 */
+    color?: string;
+    /** 线条数量 */
+    lineLength?: number;
+    /** 线条数量 */
+    numLines?: number;
+}
+/**
+ * 抖动选项
+ */
+interface WiggleOptions extends AnimationConfig {
+    /** 抖动次数 */
+    nWiggles?: number;
+    /** 抖动幅度 */
+    scaleValue?: number;
+    /** 旋转角度 */
+    rotationAngle?: number;
+}
+/**
+ * 动画组选项
+ */
+interface AnimationGroupOptions extends AnimationConfig {
+    /** 错开比例 */
+    lagRatio?: number;
+}
+/**
+ * ValueTracker - 用于跟踪数值变化
+ */
+declare class ValueTracker {
+    private _value;
+    private listeners;
+    constructor(initialValue?: number);
+    get value(): number;
+    set value(newValue: number);
+    /** 添加变化监听器 */
+    addListener(listener: (value: number) => void): () => void;
+    /** 创建动画目标对象 */
+    animate(targetValue: number): {
+        value: number;
+    };
+    /** 获取当前值的普通对象（用于 GSAP） */
+    toObject(): {
+        value: number;
+    };
+}
+/**
+ * ComplexValueTracker - 用于跟踪复数值变化
+ *
+ * 支持实部和虚部的独立动画，以及极坐标形式的动画
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ComplexValueTracker({ re: 1, im: 0 });
+ *
+ * // 监听变化
+ * tracker.addListener(z => {
+ *   console.log(`当前值: ${z.re} + ${z.im}i`);
+ * });
+ *
+ * // 设置新值
+ * tracker.value = { re: 0, im: 1 };
+ * ```
+ */
+declare class ComplexValueTracker {
+    private _re;
+    private _im;
+    private listeners;
+    constructor(initialValue?: {
+        re: number;
+        im: number;
+    });
+    /** 获取复数值 */
+    get value(): {
+        re: number;
+        im: number;
+    };
+    /** 设置复数值 */
+    set value(newValue: {
+        re: number;
+        im: number;
+    });
+    /** 获取实部 */
+    get re(): number;
+    /** 设置实部 */
+    set re(value: number);
+    /** 获取虚部 */
+    get im(): number;
+    /** 设置虚部 */
+    set im(value: number);
+    /** 获取模（绝对值） */
+    get modulus(): number;
+    /** 设置模（保持辐角不变） */
+    set modulus(r: number);
+    /** 获取辐角（弧度） */
+    get argument(): number;
+    /** 设置辐角（保持模不变） */
+    set argument(theta: number);
+    /** 通知所有监听器 */
+    private notifyListeners;
+    /** 添加变化监听器 */
+    addListener(listener: (value: {
+        re: number;
+        im: number;
+    }) => void): () => void;
+    /** 创建动画目标对象（用于 GSAP） */
+    animate(targetValue: {
+        re: number;
+        im: number;
+    }): {
+        re: number;
+        im: number;
+    };
+    /** 创建极坐标动画目标对象（用于 GSAP） */
+    animatePolar(targetModulus: number, targetArgument: number): {
+        modulus: number;
+        argument: number;
+    };
+    /** 获取当前值的普通对象（用于 GSAP） */
+    toObject(): {
+        re: number;
+        im: number;
+    };
+    /** 获取极坐标形式的普通对象（用于 GSAP） */
+    toPolarObject(): {
+        modulus: number;
+        argument: number;
+    };
+    /** 从极坐标设置值 */
+    setPolar(r: number, theta: number): void;
+    /** 获取共轭复数 */
+    conjugate(): {
+        re: number;
+        im: number;
+    };
+    /** 复数加法 */
+    add(other: {
+        re: number;
+        im: number;
+    }): void;
+    /** 复数乘法 */
+    multiply(other: {
+        re: number;
+        im: number;
+    }): void;
+    /** 标量乘法 */
+    scale(k: number): void;
+}
+
+/**
+ * AnimateProxy - Manim 风格的 .animate 语法支持
+ *
+ * 实现链式操作记录，用于创建从当前状态到目标状态的动画
+ *
+ * @example
+ * ```typescript
+ * // Manim 风格
+ * await scene.play(circle.animate.shift([2, 0]).scale(2));
+ *
+ * // 等价于
+ * const target = circle.shift([2, 0]).scale(2);
+ * await scene.play(Transform(circle, target));
+ * ```
+ */
+
+/**
+ * 操作类型
+ */
+type Operation = {
+    type: 'translate';
+    x: number;
+    y: number;
+} | {
+    type: 'shift';
+    x: number;
+    y: number;
+} | {
+    type: 'move';
+    x: number;
+    y: number;
+} | {
+    type: 'position';
+    x: number;
+    y: number;
+} | {
+    type: 'rotate';
+    radians: number;
+    center: Vector2 | undefined;
+} | {
+    type: 'rotateDeg';
+    degrees: number;
+    center: Vector2 | undefined;
+} | {
+    type: 'scale';
+    sx: number;
+    sy: number;
+    center: Vector2 | undefined;
+} | {
+    type: 'transform';
+    matrix: Matrix3;
+} | {
+    type: 'style';
+    style: Partial<Style>;
+} | {
+    type: 'fill';
+    color: string;
+} | {
+    type: 'stroke';
+    color: string;
+} | {
+    type: 'strokeWidth';
+    width: number;
+} | {
+    type: 'opacity';
+    value: number;
+} | {
+    type: 'setColor';
+    color: string;
+} | {
+    type: 'nextTo';
+    target: Diagram | Vector2;
+    direction: Vector2;
+    buffer: number;
+} | {
+    type: 'alignTo';
+    other: Diagram;
+    direction: Vector2;
+} | {
+    type: 'centerOnOrigin';
+} | {
+    type: 'flip';
+    axis: Vector2;
+} | {
+    type: 'stretch';
+    factor: number;
+    dimension: 0 | 1;
+};
+/**
+ * AnimateProxy - 动画代理类
+ *
+ * 记录对 Diagram 的操作链，生成动画
+ */
+declare class AnimateProxy {
+    private diagram;
+    private operations;
+    private config;
+    constructor(diagram: Diagram);
+    /**
+     * 设置动画时长
+     */
+    duration(seconds: number): AnimateProxy;
+    /**
+     * 设置动画缓动函数
+     */
+    easing(easing: string): AnimateProxy;
+    /**
+     * 设置动画运行时间（Manim 风格）
+     */
+    runTime(seconds: number): AnimateProxy;
+    /**
+     * 平移
+     */
+    translate(x: number, y: number): AnimateProxy;
+    translate(v: Vector2): AnimateProxy;
+    /**
+     * 相对移动（偏移）
+     */
+    shift(x: number, y: number): AnimateProxy;
+    shift(v: Vector2): AnimateProxy;
+    /**
+     * 移动到指定位置
+     */
+    move(x: number, y: number): AnimateProxy;
+    move(v: Vector2): AnimateProxy;
+    /**
+     * 移动到指定位置（别名）
+     */
+    position(x: number, y: number): AnimateProxy;
+    position(v: Vector2): AnimateProxy;
+    /**
+     * 移动到指定位置（Manim 风格别名）
+     */
+    moveTo(x: number, y: number): AnimateProxy;
+    moveTo(v: Vector2): AnimateProxy;
+    /**
+     * 旋转（弧度）
+     */
+    rotate(radians: number, center?: Vector2): AnimateProxy;
+    /**
+     * 旋转（度数）
+     */
+    rotateDeg(degrees: number, center?: Vector2): AnimateProxy;
+    /**
+     * 缩放
+     */
+    scale(factor: number, center?: Vector2): AnimateProxy;
+    scale(sx: number, sy: number, center?: Vector2): AnimateProxy;
+    /**
+     * 应用变换矩阵
+     */
+    transform(matrix: Matrix3): AnimateProxy;
+    /**
+     * 翻转（沿指定轴）
+     */
+    flip(axis?: Vector2): AnimateProxy;
+    /**
+     * 单向拉伸
+     */
+    stretch(factor: number, dimension: 0 | 1): AnimateProxy;
+    /**
+     * 设置填充颜色
+     */
+    fill(color: string): AnimateProxy;
+    /**
+     * 设置描边颜色
+     */
+    stroke(color: string): AnimateProxy;
+    /**
+     * 设置描边宽度
+     */
+    strokeWidth(width: number): AnimateProxy;
+    /**
+     * 设置透明度
+     */
+    opacity(value: number): AnimateProxy;
+    /**
+     * 批量设置样式
+     */
+    style(newStyle: Partial<Style>): AnimateProxy;
+    /**
+     * 同时设置填充和描边颜色（Manim 风格）
+     */
+    setColor(color: string): AnimateProxy;
+    /**
+     * 相对定位
+     */
+    nextTo(target: Diagram | Vector2, direction: Vector2, buffer?: number): AnimateProxy;
+    /**
+     * 对齐到另一个图形
+     */
+    alignTo(other: Diagram, direction: Vector2): AnimateProxy;
+    /**
+     * 将中心对齐到原点
+     */
+    centerOnOrigin(): AnimateProxy;
+    /**
+     * 构建目标 Diagram
+     *
+     * 应用所有记录的操作，返回最终状态的 Diagram
+     */
+    build(): Diagram;
+    /**
+     * 获取源 Diagram
+     */
+    getSource(): Diagram;
+    /**
+     * 获取动画配置
+     */
+    getConfig(): AnimationConfig;
+    /**
+     * 获取操作列表
+     */
+    getOperations(): Operation[];
+}
+
+/**
+ * @locusing/core - Diagram 不可变图形树
+ *
+ * 实现链式 API，支持声明式图形构造
+ */
+
+/**
+ * Diagram 类 - 不可变图形树的包装器
+ *
+ * 每个方法返回新的 Diagram 实例，保证不可变性
+ */
+declare class Diagram {
+    readonly shape: Shape;
+    constructor(shape: Shape);
+    /** 设置填充颜色 */
+    fill(color: string): Diagram;
+    /** 设置描边颜色 */
+    stroke(color: string): Diagram;
+    /** 设置描边宽度 */
+    strokeWidth(width: number): Diagram;
+    /** 设置透明度 */
+    opacity(value: number): Diagram;
+    /** 设置虚线样式 */
+    dashed(dasharray?: string): Diagram;
+    /** 批量设置样式 */
+    style(newStyle: Partial<Style>): Diagram;
+    /**
+     * 渐隐效果 - 设置透明度
+     *
+     * @param darkness 暗度值 0-1，0 完全可见，1 完全透明
+     * @returns 新的 Diagram
+     *
+     * @example
+     * ```typescript
+     * square(1).fade(0.5)  // 50% 透明
+     * square(1).fade(1)    // 完全透明
+     * square(1).fade(0)    // 完全可见
+     * ```
+     */
+    fade(darkness?: number): Diagram;
+    /**
+     * 设置填充透明度
+     */
+    fillOpacity(value: number): Diagram;
+    /**
+     * 设置描边透明度
+     */
+    strokeOpacity(value: number): Diagram;
+    /**
+     * 获取填充颜色
+     */
+    getFillColor(): string | undefined;
+    /**
+     * 获取描边颜色
+     */
+    getStrokeColor(): string | undefined;
+    /**
+     * 获取描边宽度
+     */
+    getStrokeWidth(): number | undefined;
+    /**
+     * 获取透明度
+     */
+    getOpacity(): number;
+    /**
+     * 获取填充透明度
+     */
+    getFillOpacity(): number;
+    /**
+     * 获取描边透明度
+     */
+    getStrokeOpacity(): number;
+    /**
+     * 设置颜色（同时设置填充和描边）
+     */
+    color(value: string): Diagram;
+    /**
+     * 获取颜色（返回填充颜色，如果没有则返回描边颜色）
+     */
+    getColor(): string | undefined;
+    /**
+     * 复制样式自另一个 Diagram
+     */
+    matchStyle(other: Diagram): Diagram;
+    /**
+     * 获取样式对象的副本
+     */
+    getStyle(): Style;
+    /** 平移 */
+    translate(x: number, y: number): Diagram;
+    translate(v: Vector2): Diagram;
+    /** 移动到指定位置 */
+    position(x: number, y: number): Diagram;
+    position(v: Vector2): Diagram;
+    /**
+     * 移动图形（Manim 风格）
+     *
+     * 将图形中心移动到指定位置。与 position() 相同，
+     * 但命名更符合 Manim 习惯。
+     *
+     * @example
+     * ```typescript
+     * import { square, Dir, mul } from 'locusing';
+     *
+     * // 移动到 (2, 3)
+     * square(1).move([2, 3]);
+     *
+     * // 使用方向常量
+     * square(1).move(mul(Dir.UP, 2));  // 向上移动 2 单位
+     * square(1).move(mul(Dir.RIGHT, 3));  // 向右移动 3 单位
+     *
+     * // 组合方向
+     * import { add } from 'locusing';
+     * square(1).move(add(mul(Dir.UP, 2), mul(Dir.RIGHT, 3)));  // 右上方
+     * ```
+     */
+    move(x: number, y: number): Diagram;
+    move(v: Vector2): Diagram;
+    /**
+     * 相对移动（偏移）
+     *
+     * 将图形从当前位置移动指定偏移量。
+     *
+     * @example
+     * ```typescript
+     * // 向右偏移 2 单位
+     * square(1).shift([2, 0]);
+     *
+     * // 使用方向常量
+     * square(1).shift(mul(Dir.UP, 1.5));
+     * ```
+     */
+    shift(x: number, y: number): Diagram;
+    shift(v: Vector2): Diagram;
+    /** 旋转（弧度） */
+    rotate(radians: number, center?: Vector2): Diagram;
+    /** 旋转（度数） */
+    rotateDeg(degrees: number, center?: Vector2): Diagram;
+    /** 缩放 */
+    scale(factor: number, center?: Vector2): Diagram;
+    scale(sx: number, sy: number, center?: Vector2): Diagram;
+    /** 应用变换矩阵 */
+    transform(matrix: Matrix3): Diagram;
+    /** 组合多个图形 */
+    combine(...others: Diagram[]): Diagram;
+    /** 添加子图形 */
+    add(...others: Diagram[]): Diagram;
+    /** 获取中心点 */
+    center(): Vector2;
+    /** Manim 风格别名：获取中心点 */
+    getCenter(): Vector2;
+    /** 获取包围盒 */
+    bounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** 获取宽度 */
+    width(): number;
+    /** Manim 风格别名：获取宽度 */
+    getWidth(): number;
+    /** 获取高度 */
+    height(): number;
+    /** Manim 风格别名：获取高度 */
+    getHeight(): number;
+    /** 获取左边缘 x 坐标 */
+    getLeft(): number;
+    /** 获取右边缘 x 坐标 */
+    getRight(): number;
+    /** 获取上边缘 y 坐标 */
+    getTop(): number;
+    /** 获取下边缘 y 坐标 */
+    getBottom(): number;
+    /** 获取左边缘点 */
+    getLeftEdge(): Vector2;
+    /** 获取右边缘点 */
+    getRightEdge(): Vector2;
+    /** 获取上边缘点 */
+    getTopEdge(): Vector2;
+    /** 获取下边缘点 */
+    getBottomEdge(): Vector2;
+    /** 获取指定方向的边缘点 */
+    edge(direction: Vector2): Vector2;
+    /**
+     * 获取图形的所有点
+     *
+     * 对于路径图形返回路径点，对于基本图形返回边界框角点
+     *
+     * @example
+     * ```typescript
+     * const pts = polygon([0, 0], [1, 0], [0.5, 1]).getAllPoints();
+     * // 返回多边形的顶点
+     * ```
+     */
+    getAllPoints(): Vector2[];
+    /**
+     * 获取起始点
+     *
+     * 对于路径/多边形返回第一个顶点，其他图形返回左边缘点
+     */
+    getStart(): Vector2;
+    /**
+     * 获取结束点
+     *
+     * 对于路径/多边形返回最后一个顶点，其他图形返回右边缘点
+     */
+    getEnd(): Vector2;
+    /**
+     * 根据比例获取点
+     *
+     * @param proportion 0-1 之间的比例值
+     * @returns 路径上对应比例位置的点
+     *
+     * @example
+     * ```typescript
+     * const line = polyline([0, 0], [4, 0]);
+     * line.pointFromProportion(0.25)  // 返回 [1, 0]
+     * line.pointFromProportion(0.5)   // 返回 [2, 0]
+     * ```
+     */
+    pointFromProportion(proportion: number): Vector2;
+    /**
+     * 获取点的数量
+     */
+    getNumPoints(): number;
+    /**
+     * 检查是否有点
+     */
+    hasPoints(): boolean;
+    /**
+     * 获取关键点（角落点）
+     */
+    getCriticalPoints(): Vector2[];
+    /**
+     * 获取最左侧的点
+     */
+    getLeftmostPoint(): Vector2;
+    /**
+     * 获取最右侧的点
+     */
+    getRightmostPoint(): Vector2;
+    /**
+     * 获取最顶部的点
+     */
+    getTopmostPoint(): Vector2;
+    /**
+     * 获取最底部的点
+     */
+    getBottommostPoint(): Vector2;
+    /**
+     * 从 Shape 提取点
+     * @internal
+     */
+    protected extractPoints(shape: Shape): Vector2[];
+    /**
+     * 相对定位 - 将图形放置在参考对象/点的指定方向
+     *
+     * @param target - 参考对象（Diagram）或参考点坐标（Vector2）
+     * @param direction - 放置方向，使用 Dir.UP/DOWN/LEFT/RIGHT/UR/UL/DR/DL
+     * @param buffer - 与参考对象的间距，默认 0.25
+     *
+     * @example
+     * ```typescript
+     * // 相对于另一个图形定位
+     * label.nextTo(circle, Dir.RIGHT)
+     *
+     * // 相对于坐标点定位
+     * label.nextTo([2, 0], Dir.RIGHT)
+     *
+     * // 带自定义间距
+     * label.nextTo(axes.c2p(2, 0), Dir.UP, 0.1)
+     * ```
+     */
+    nextTo(target: Diagram | Vector2, direction: Vector2, buffer?: number): Diagram;
+    /**
+     * 获取子对象列表
+     *
+     * Manim 风格：返回直接子对象的 Diagram 数组
+     */
+    get submobjects(): Diagram[];
+    /**
+     * 获取所有后代对象（包括自身）
+     *
+     * Manim 风格：递归获取所有子对象
+     */
+    getFamily(): Diagram[];
+    /**
+     * 获取所有后代对象（不包括自身）
+     */
+    getFamilyWithoutSelf(): Diagram[];
+    /**
+     * 按索引获取子对象
+     */
+    getSubmobjectAt(index: number): Diagram | undefined;
+    /**
+     * 获取子对象数量
+     */
+    get length(): number;
+    /**
+     * 对所有子对象应用变换
+     */
+    applyToFamily(fn: (diagram: Diagram) => Diagram): Diagram;
+    /**
+     * 将图形中心对齐到原点
+     */
+    centerOnOrigin(): Diagram;
+    /**
+     * 将图形对齐到另一个图形的指定边缘
+     *
+     * @param other - 参考图形
+     * @param direction - 对齐方向
+     */
+    alignTo(other: Diagram, direction: Vector2): Diagram;
+    /**
+     * 排列子对象
+     *
+     * 将组内的子对象按指定方向排列成一行或一列
+     *
+     * @param direction - 排列方向，默认 [1, 0]（水平向右）
+     * @param buff - 子对象间距，默认 0.25
+     *
+     * @example
+     * ```typescript
+     * // 水平排列
+     * group.arrange([1, 0]);
+     *
+     * // 垂直排列
+     * group.arrange([0, 1]);
+     *
+     * // 使用方向常量
+     * group.arrange(Dir.DOWN, 0.5);
+     * ```
+     */
+    arrange(direction?: Vector2, buff?: number): Diagram;
+    /**
+     * 网格排列子对象
+     *
+     * @param rows - 行数
+     * @param cols - 列数
+     * @param options - 配置选项
+     *
+     * @example
+     * ```typescript
+     * // 3x3 网格
+     * group.arrangeInGrid(3, 3);
+     *
+     * // 带间距配置
+     * group.arrangeInGrid(2, 4, { buffX: 0.5, buffY: 0.3 });
+     * ```
+     */
+    arrangeInGrid(rows: number, cols: number, options?: {
+        buffX?: number;
+        buffY?: number;
+        cellWidth?: number;
+        cellHeight?: number;
+    }): Diagram;
+    /**
+     * 移动到角落
+     *
+     * @param corner - 角落方向，如 [1, 1] 表示右上角
+     * @param buff - 与边缘的间距，默认 0.5
+     *
+     * @example
+     * ```typescript
+     * // 移动到右上角
+     * diagram.toCorner([1, 1]);
+     *
+     * // 使用方向常量
+     * diagram.toCorner(Dir.UL, 0.3);
+     * ```
+     */
+    toCorner(corner: Vector2, buff?: number): Diagram;
+    /**
+     * 移动到边缘
+     *
+     * @param edge - 边缘方向，如 [1, 0] 表示右边缘
+     * @param buff - 与边缘的间距，默认 0.5
+     *
+     * @example
+     * ```typescript
+     * // 移动到顶部边缘
+     * diagram.toEdge([0, 1]);
+     *
+     * // 使用方向常量
+     * diagram.toEdge(Dir.LEFT, 0.3);
+     * ```
+     */
+    toEdge(edge: Vector2, buff?: number): Diagram;
+    /**
+     * 匹配另一个图形的宽度
+     *
+     * @param other - 参考图形
+     *
+     * @example
+     * ```typescript
+     * rect.matchWidth(circle);
+     * ```
+     */
+    matchWidth(other: Diagram): Diagram;
+    /**
+     * 匹配另一个图形的高度
+     *
+     * @param other - 参考图形
+     *
+     * @example
+     * ```typescript
+     * rect.matchHeight(circle);
+     * ```
+     */
+    matchHeight(other: Diagram): Diagram;
+    /**
+     * 环绕另一个图形
+     *
+     * 缩放并移动当前图形，使其恰好包围目标图形
+     *
+     * @param other - 要包围的目标图形
+     * @param buff - 额外的边距，默认 0.1
+     *
+     * @example
+     * ```typescript
+     * // 用矩形框环绕文字
+     * rect.surround(text, 0.2);
+     * ```
+     */
+    surround(other: Diagram, buff?: number): Diagram;
+    /** 克隆图形 */
+    clone(): Diagram;
+    /** 复制到指定位置 */
+    copy(): Diagram;
+    /**
+     * 返回 AnimateProxy，用于 Manim 风格的动画语法
+     *
+     * @example
+     * ```typescript
+     * // 链式动画操作
+     * await scene.play(circle.animate.shift([2, 0]).scale(2));
+     *
+     * // 带配置
+     * await scene.play(circle.animate.runTime(2).shift([2, 0]));
+     * ```
+     */
+    get animate(): AnimateProxy;
+    /** 保存的状态栈 */
+    private static stateStack;
+    /**
+     * 保存当前状态
+     *
+     * 将当前 Shape 状态压入栈中，可以稍后用 restore() 恢复
+     *
+     * @example
+     * ```typescript
+     * const c = circle(1).fill('red');
+     * c.saveState();
+     * const moved = c.shift([2, 0]).fill('blue');
+     * // 稍后可以恢复
+     * const restored = moved.restore();  // 恢复到 fill('red') 的状态
+     * ```
+     */
+    saveState(): Diagram;
+    /**
+     * 恢复到保存的状态
+     *
+     * 从状态栈中弹出最近保存的状态并返回
+     */
+    restore(): Diagram;
+    /**
+     * 获取保存的状态（不移除）
+     */
+    getSavedState(): Diagram | undefined;
+    /**
+     * 生成目标副本
+     *
+     * 创建当前图形的副本，用于 MoveToTarget 动画
+     *
+     * @example
+     * ```typescript
+     * const c = circle(1);
+     * c.generateTarget();
+     * c.target = c.target.shift([2, 0]).scale(2);
+     * await scene.play(MoveToTarget(c));
+     * ```
+     */
+    generateTarget(): Diagram;
+    /** 目标状态（用于 MoveToTarget） */
+    target?: Diagram;
+    /**
+     * 替换为另一个 Diagram
+     *
+     * 返回一个与目标具有相同形状但保留原始 ID 的新 Diagram
+     *
+     * @example
+     * ```typescript
+     * const c = circle(1);
+     * const s = square(1);
+     * const newC = c.become(s);  // 现在 newC 看起来像 square
+     * ```
+     */
+    become(other: Diagram): Diagram;
+    /**
+     * 同时设置填充和描边颜色（Manim 风格）
+     */
+    setColor(color: string): Diagram;
+    /**
+     * 沿轴翻转
+     *
+     * @param axis - 翻转轴，默认 [1, 0]（水平翻转）
+     *
+     * @example
+     * ```typescript
+     * // 水平翻转（沿 x 轴）
+     * diagram.flip([1, 0]);
+     *
+     * // 垂直翻转（沿 y 轴）
+     * diagram.flip([0, 1]);
+     * ```
+     */
+    flip(axis?: Vector2): Diagram;
+    /**
+     * 单向拉伸
+     *
+     * @param factor - 拉伸因子
+     * @param dimension - 拉伸维度：0 为 x 方向，1 为 y 方向
+     *
+     * @example
+     * ```typescript
+     * // 水平拉伸 2 倍
+     * diagram.stretch(2, 0);
+     *
+     * // 垂直拉伸 0.5 倍
+     * diagram.stretch(0.5, 1);
+     * ```
+     */
+    stretch(factor: number, dimension: 0 | 1): Diagram;
+    /**
+     * 获取指定方向的角点
+     *
+     * @param direction - 方向向量，如 [1, 1] 表示右上角
+     *
+     * @example
+     * ```typescript
+     * // 获取右上角
+     * diagram.getCorner([1, 1]);
+     *
+     * // 使用方向常量
+     * diagram.getCorner(Dir.UR);
+     * ```
+     */
+    getCorner(direction: Vector2): Vector2;
+    /**
+     * 获取指定方向的边缘中点
+     *
+     * @param direction - 方向向量
+     */
+    getEdgeCenter(direction: Vector2): Vector2;
+    /**
+     * 获取关键点（角点或边缘中点）
+     *
+     * @param direction - 方向向量
+     */
+    getCriticalPoint(direction: Vector2): Vector2;
+}
+
+export { reflect as $, type Animation as A, dot as B, Camera as C, Diagram as D, type EasingFunction as E, type Frame as F, cross as G, length as H, type IndicateOptions as I, normalize as J, distance as K, LEFT as L, type MoveOptions as M, angle as N, ORIGIN as O, type PathCommand as P, angleBetween as Q, type RenderOptions as R, Scene as S, type TransformOptions as T, UP as U, type Vector2 as V, type WiggleOptions as W, rotate as X, lerp as Y, midpoint as Z, perpendicular as _, type CameraConfig as a, IDENTITY as a0, matrixMultiply as a1, applyMatrix as a2, translationMatrix as a3, rotationMatrix as a4, scaleMatrix as a5, quadraticBezier as a6, cubicBezier as a7, sampleParametric as a8, easing as a9, createCamera as aA, type RotateOptions as aB, type ScaleOptions as aC, ValueTracker as aD, ComplexValueTracker as aE, Timeline as aF, createTimeline as aG, getGSAPEasing as aH, easingMap as aI, type TimelineOptions as aJ, type AnimationStatus as aK, createScene as aL, type ScenePreset as aM, type UpdaterFunction as aN, type UpdaterConfig as aO, PI as aa, TAU as ab, DEGREES as ac, degToRad as ad, radToDeg as ae, clamp as af, mapRange as ag, lerpNumber as ah, type ShapeType as ai, type Shape as aj, type BaseShape as ak, type GroupShape as al, type PathShape as am, type RectShape as an, type CircleShape as ao, type EllipseShape as ap, type LineShape as aq, type PolylineShape as ar, type PolygonShape as as, type TextShape as at, type ArcShape as au, type TexShape as av, type FrameConfig as aw, type SliderOptions as ax, type LocatorOptions as ay, type AnimationOptions as az, type SceneConfig as b, type CreateOptions as c, type FadeOptions as d, type AnimationConfig as e, type CircumscribeOptions as f, type FlashOptions as g, type AnimationGroupOptions as h, type Style as i, type TextStyle as j, type Vector3 as k, type Point as l, type Matrix3 as m, V2 as n, V3 as o, DOWN as p, RIGHT as q, UL as r, UR as s, DL as t, DR as u, Dir as v, add as w, sub as x, mul as y, div as z };