locusing 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,1411 @@
+/**
+ * @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;
+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$1(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;
+};
+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';
+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;
+}
+type Shape = GroupShape | PathShape | RectShape | CircleShape | EllipseShape | LineShape | PolylineShape | PolygonShape | TextShape | ArcShape;
+interface RenderOptions {
+    width?: number;
+    height?: number;
+    background?: string;
+    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/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;
+    /** 平移 */
+    translate(x: number, y: number): Diagram;
+    translate(v: Vector2): Diagram;
+    /** 移动到指定位置 */
+    position(x: number, y: number): Diagram;
+    position(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;
+    /** 获取包围盒 */
+    bounds(): {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** 获取指定方向的边缘点 */
+    edge(direction: Vector2): Vector2;
+    /** 获取相对于另一个图形的位置 */
+    nextTo(other: Diagram, direction: Vector2, buffer?: number): Diagram;
+    /** 克隆图形 */
+    clone(): Diagram;
+    /** 复制到指定位置 */
+    copy(): Diagram;
+}
+
+/**
+ * @locusing/core - 基础图元工厂函数
+ *
+ * 提供 square, circle, line, polygon, text 等图元创建函数
+ */
+
+/** 创建矩形 */
+declare function rect(width: number, height: number, options?: {
+    rx?: number;
+    ry?: number;
+    centered?: boolean;
+}): Diagram;
+/** 创建正方形 */
+declare function square(size: number, options?: {
+    rx?: number;
+    centered?: boolean;
+}): Diagram;
+/** 创建圆形 */
+declare function circle(radius: number): Diagram;
+/** 创建椭圆 */
+declare function ellipse(rx: number, ry: number): Diagram;
+/** 创建点（小圆） */
+declare function dot(position?: Vector2, radius?: number): Diagram;
+/** 创建直线 */
+declare function line(from: Vector2, to: Vector2): Diagram;
+/** 创建箭头 */
+declare function arrow(from: Vector2, to: Vector2, options?: {
+    headSize?: number;
+    headAngle?: number;
+}): Diagram;
+/** 创建双向箭头 */
+declare function doubleArrow(from: Vector2, to: Vector2, options?: {
+    headSize?: number;
+    headAngle?: number;
+}): Diagram;
+/** 创建多边形 */
+declare function polygon(...points: Vector2[]): Diagram;
+/** 创建正多边形 */
+declare function regularPolygon(sides: number, radius: number): Diagram;
+/** 创建三角形 */
+declare function triangle(width: number, height: number): Diagram;
+/** 创建等边三角形 */
+declare function equilateralTriangle(sideLength: number): Diagram;
+/** 创建星形 */
+declare function star(points: number, outerRadius: number, innerRadius?: number): Diagram;
+/** 创建折线 */
+declare function polyline(...points: Vector2[]): Diagram;
+/** 创建圆弧 */
+declare function arc(radius: number, startAngle: number, endAngle: number): Diagram;
+/** 创建扇形 */
+declare function sector(radius: number, startAngle: number, endAngle: number): Diagram;
+/** 创建路径 */
+declare function path(commands: PathCommand[]): Diagram;
+/** 从 SVG 路径字符串创建 */
+declare function pathFromString(d: string): Diagram;
+/** 创建文本 */
+declare function text(content: string, options?: {
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: string | number;
+    fontStyle?: string;
+    anchor?: 'start' | 'middle' | 'end';
+}): Diagram;
+/** 创建 LaTeX 公式（占位符，需要 MathJax 支持） */
+declare function tex(latex: string, options?: {
+    fontSize?: number;
+}): Diagram;
+/** 组合多个图形 */
+declare function combine(...diagrams: Diagram[]): Diagram;
+/** 创建空组 */
+declare function group(): Diagram;
+
+/**
+ * @locusing/core - SVG 渲染器
+ *
+ * 将 Diagram 渲染为 SVG 元素
+ */
+
+/**
+ * 渲染 Diagram 到 SVG 元素
+ */
+declare function renderToSVG(diagram: Diagram, container: SVGSVGElement | HTMLElement, options?: RenderOptions): SVGSVGElement;
+/**
+ * 将 Diagram 转换为 SVG 字符串
+ */
+declare function toSVGString(diagram: Diagram, options?: RenderOptions): string;
+
+/**
+ * @locusing/core - Rough.js 渲染器
+ *
+ * 将 Diagram 渲染为手绘风格的 SVG
+ */
+
+/**
+ * Rough.js 渲染选项
+ */
+interface RoughRenderOptions extends RenderOptions {
+    roughness?: number;
+    bowing?: number;
+    seed?: number;
+    fillStyle?: 'hachure' | 'solid' | 'zigzag' | 'cross-hatch' | 'dots' | 'dashed' | 'zigzag-line';
+    fillWeight?: number;
+    hachureAngle?: number;
+    hachureGap?: number;
+}
+/**
+ * 渲染 Diagram 到 SVG（手绘风格）
+ */
+declare function renderToRough(diagram: Diagram, container: SVGSVGElement | HTMLElement, options?: RoughRenderOptions): SVGSVGElement;
+declare const roughPresets: {
+    /** 默认手绘风格 */
+    default: {
+        roughness: number;
+        bowing: number;
+        fillStyle: "hachure";
+    };
+    /** 粉笔风格 */
+    chalk: {
+        roughness: number;
+        bowing: number;
+        fillStyle: "zigzag";
+        fillWeight: number;
+    };
+    /** 钢笔风格 */
+    pen: {
+        roughness: number;
+        bowing: number;
+        fillStyle: "cross-hatch";
+    };
+    /** 铅笔风格 */
+    pencil: {
+        roughness: number;
+        bowing: number;
+        fillStyle: "hachure";
+        fillWeight: number;
+    };
+    /** 马克笔风格 */
+    marker: {
+        roughness: number;
+        bowing: number;
+        fillStyle: "solid";
+        strokeWidth: number;
+    };
+    /** 涂鸦风格 */
+    doodle: {
+        roughness: number;
+        bowing: number;
+        fillStyle: "zigzag-line";
+    };
+};
+
+/**
+ * @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;
+
+/**
+ * @locusing/animate - Scene 场景管理
+ *
+ * Manim 风格的场景类
+ */
+
+interface SceneConfig {
+    width?: number;
+    height?: number;
+    background?: string;
+    fps?: number;
+    rough?: boolean;
+}
+/**
+ * Scene 类 - Manim 风格的场景管理
+ *
+ * 使用方式：
+ * ```typescript
+ * class MyScene extends Scene {
+ *   construct() {
+ *     const sq = square(100).fill('#EA580C');
+ *     this.play(Create(sq));
+ *     this.wait(1);
+ *     this.play(FadeOut(sq));
+ *   }
+ * }
+ * ```
+ */
+declare abstract class Scene {
+    protected container: HTMLElement;
+    protected svg: SVGSVGElement;
+    protected config: Required<SceneConfig>;
+    protected timeline: Timeline;
+    protected objects: Map<string, Diagram>;
+    protected currentTime: number;
+    constructor(container: HTMLElement, config?: SceneConfig);
+    /** 子类实现此方法来构建动画 */
+    abstract construct(): void;
+    /**
+     * 添加图形到场景（不带动画）
+     */
+    add(...diagrams: Diagram[]): void;
+    /**
+     * 从场景移除图形
+     */
+    remove(...diagrams: Diagram[]): void;
+    /**
+     * 播放动画
+     *
+     * @param animations - 要播放的动画
+     * @param config - 动画配置
+     */
+    play(...args: (Animation | AnimationConfig)[]): void;
+    /**
+     * 等待指定时间
+     */
+    wait(seconds?: number): void;
+    /**
+     * 运行场景
+     */
+    render(): Promise<void>;
+    /**
+     * 渲染单个图形到 SVG
+     */
+    protected renderDiagram(diagram: Diagram): SVGElement | null;
+    /**
+     * 获取图形对应的 SVG 元素
+     */
+    getElement(diagram: Diagram): SVGElement | null;
+    /**
+     * 获取或创建图形元素
+     */
+    getOrCreateElement(diagram: Diagram): SVGElement;
+    /**
+     * 获取 SVG 容器
+     */
+    getSVG(): SVGSVGElement;
+    /**
+     * 获取配置
+     */
+    getConfig(): Required<SceneConfig>;
+    /**
+     * 导出为 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;
+    };
+}
+
+/**
+ * 创建类动画 - Create, Write, DrawBorderThenFill
+ */
+
+/**
+ * Create - 描边绘制动画
+ *
+ * 模拟手绘效果，从路径起点到终点绘制
+ */
+declare function Create(target: Diagram, options?: CreateOptions): Animation;
+/**
+ * Write - 文字书写效果
+ *
+ * 逐字显示文本
+ */
+declare function Write(target: Diagram, options?: CreateOptions): Animation;
+/**
+ * DrawBorderThenFill - 先描边再填充
+ */
+declare function DrawBorderThenFill(target: Diagram, options?: CreateOptions): Animation;
+/**
+ * GrowFromCenter - 从中心放大出现
+ */
+declare function GrowFromCenter(target: Diagram, options?: CreateOptions): Animation;
+/**
+ * GrowFromPoint - 从指定点放大
+ */
+declare function GrowFromPoint(target: Diagram, point: [number, number], options?: CreateOptions): Animation;
+/**
+ * GrowFromEdge - 从边缘生长
+ */
+declare function GrowFromEdge(target: Diagram, edge?: 'LEFT' | 'RIGHT' | 'TOP' | 'BOTTOM', options?: CreateOptions): Animation;
+/**
+ * SpinInFromNothing - 旋转出现
+ */
+declare function SpinInFromNothing(target: Diagram, options?: CreateOptions): Animation;
+
+/**
+ * 淡入淡出动画 - FadeIn, FadeOut
+ */
+
+/**
+ * FadeIn - 淡入动画
+ */
+declare function FadeIn(target: Diagram, options?: FadeOptions): Animation;
+/**
+ * FadeOut - 淡出动画
+ */
+declare function FadeOut(target: Diagram, options?: FadeOptions): Animation;
+/**
+ * FadeInFrom - 从指定方向淡入
+ */
+declare function FadeInFrom(target: Diagram, direction: Vector2 | 'UP' | 'DOWN' | 'LEFT' | 'RIGHT', options?: Omit<FadeOptions, 'direction'>): Animation;
+/**
+ * FadeOutTo - 向指定方向淡出
+ */
+declare function FadeOutTo(target: Diagram, direction: Vector2 | 'UP' | 'DOWN' | 'LEFT' | 'RIGHT', options?: Omit<FadeOptions, 'direction'>): Animation;
+/**
+ * FadeInFromDown - 从下方淡入
+ */
+declare function FadeInFromDown(target: Diagram, options?: Omit<FadeOptions, 'direction'>): Animation;
+/**
+ * FadeInFromUp - 从上方淡入
+ */
+declare function FadeInFromUp(target: Diagram, options?: Omit<FadeOptions, 'direction'>): Animation;
+/**
+ * FadeInFromLeft - 从左侧淡入
+ */
+declare function FadeInFromLeft(target: Diagram, options?: Omit<FadeOptions, 'direction'>): Animation;
+/**
+ * FadeInFromRight - 从右侧淡入
+ */
+declare function FadeInFromRight(target: Diagram, options?: Omit<FadeOptions, 'direction'>): Animation;
+/**
+ * FadeTransform - 淡入淡出变换（一个淡出同时另一个淡入）
+ */
+declare function FadeTransform(source: Diagram, target: Diagram, options?: FadeOptions): Animation;
+
+/**
+ * 变换动画 - Transform, ReplacementTransform, Morphing
+ */
+
+/**
+ * Transform - 形变动画（保留原对象）
+ *
+ * 将源图形变换为目标图形的形状
+ */
+declare function Transform(source: Diagram, target: Diagram, options?: TransformOptions): Animation;
+/**
+ * ReplacementTransform - 替换变形
+ *
+ * 与 Transform 类似，但直接替换元素
+ */
+declare function ReplacementTransform(source: Diagram, target: Diagram, options?: TransformOptions): Animation;
+/**
+ * MoveToTarget - 移动到目标状态
+ *
+ * 将图形移动到其目标副本的位置
+ */
+declare function MoveToTarget(target: Diagram, options?: TransformOptions): Animation;
+/**
+ * Morphing - 路径变形动画
+ *
+ * 平滑地将一个路径变形为另一个路径
+ */
+declare function Morphing(source: Diagram, target: Diagram, options?: TransformOptions): Animation;
+/**
+ * TransformMatchingShapes - 匹配形状变换
+ *
+ * 智能匹配源和目标中的相似形状进行变换
+ */
+declare function TransformMatchingShapes(source: Diagram, target: Diagram, options?: TransformOptions): Animation;
+
+/**
+ * 移动动画 - Shift, MoveTo, MoveAlongPath
+ */
+
+/**
+ * Shift - 平移动画
+ */
+declare function Shift(target: Diagram, offset: Vector2, options?: AnimationConfig): Animation;
+/**
+ * MoveTo - 移动到指定位置
+ */
+declare function MoveTo(target: Diagram, position: Vector2, options?: AnimationConfig): Animation;
+/**
+ * MoveAlongPath - 沿路径移动
+ */
+declare function MoveAlongPath(target: Diagram, path: Diagram | string, options?: MoveOptions): Animation;
+/**
+ * Rotate - 旋转动画
+ */
+declare function Rotate(target: Diagram, angle: number, options?: AnimationConfig & {
+    aboutPoint?: Vector2;
+}): Animation;
+/**
+ * Rotating - 持续旋转
+ */
+declare function Rotating(target: Diagram, options?: AnimationConfig & {
+    angularVelocity?: number;
+    aboutPoint?: Vector2;
+}): Animation;
+/**
+ * Scale - 缩放动画
+ */
+declare function Scale(target: Diagram, factor: number | [number, number], options?: AnimationConfig & {
+    aboutPoint?: Vector2;
+}): Animation;
+/**
+ * ScaleInPlace - 原地缩放
+ */
+declare function ScaleInPlace(target: Diagram, factor: number, options?: AnimationConfig): Animation;
+
+/**
+ * 指示动画 - Indicate, Circumscribe, Wiggle, Flash
+ */
+
+/**
+ * Indicate - 闪烁高亮动画
+ *
+ * 让图形闪烁变色以吸引注意力
+ */
+declare function Indicate(target: Diagram, options?: IndicateOptions): Animation;
+/**
+ * Circumscribe - 圈出强调动画
+ *
+ * 在图形周围画一个圈或框来强调
+ */
+declare function Circumscribe(target: Diagram, options?: CircumscribeOptions): Animation;
+/**
+ * Wiggle - 抖动动画
+ */
+declare function Wiggle(target: Diagram, options?: WiggleOptions): Animation;
+/**
+ * Flash - 闪光动画
+ *
+ * 在图形位置产生放射状闪光效果
+ */
+declare function Flash(target: Diagram, options?: FlashOptions): Animation;
+/**
+ * ShowPassingFlash - 流光效果
+ *
+ * 沿路径移动的高亮效果
+ */
+declare function ShowPassingFlash(target: Diagram, options?: IndicateOptions): Animation;
+/**
+ * Blink - 闪烁动画
+ */
+declare function Blink(target: Diagram, options?: IndicateOptions & {
+    times?: number;
+}): Animation;
+
+/**
+ * 组合动画 - AnimationGroup, Succession, LaggedStart
+ */
+
+/**
+ * AnimationGroup - 同时播放多个动画
+ */
+declare function AnimationGroup(animations: Animation[], options?: AnimationGroupOptions): Animation;
+/**
+ * Succession - 依次播放动画
+ */
+declare function Succession(animations: Animation[], options?: AnimationConfig): Animation;
+/**
+ * LaggedStart - 错开播放动画
+ *
+ * 类似于 AnimationGroup，但使用固定的延迟比例
+ */
+declare function LaggedStart(animations: Animation[], options?: AnimationGroupOptions): Animation;
+/**
+ * LaggedStartMap - 对多个目标应用相同动画
+ *
+ * @param animationFn - 动画工厂函数
+ * @param targets - 目标图形数组
+ * @param options - 选项
+ */
+declare function LaggedStartMap<T extends Animation>(animationFn: (target: Diagram, options?: AnimationConfig) => T, targets: Diagram[], options?: AnimationGroupOptions & {
+    animationOptions?: AnimationConfig;
+}): Animation;
+/**
+ * Wait - 等待动画（占位符）
+ */
+declare function Wait(duration?: number): Animation;
+/**
+ * ApplyMethod - 应用方法动画
+ *
+ * 对 Diagram 应用一个方法并动画化变化
+ */
+declare function ApplyMethod(target: Diagram, method: (d: Diagram) => Diagram, options?: AnimationConfig): Animation;
+/**
+ * UpdateFromFunc - 基于函数更新
+ *
+ * 每帧调用函数来更新图形状态
+ */
+declare function UpdateFromFunc(target: Diagram, updateFn: (diagram: Diagram, t: number) => void, options?: AnimationConfig): Animation;
+/**
+ * UpdateFromAlphaFunc - 基于 Alpha 值更新
+ *
+ * 类似于 UpdateFromFunc，但专门用于透明度动画
+ */
+declare function UpdateFromAlphaFunc(target: Diagram, updateFn: (diagram: Diagram, alpha: number) => void, options?: AnimationConfig): Animation;
+/**
+ * Homotopy - 同伦动画
+ *
+ * 对路径进行平滑变换
+ */
+declare function Homotopy(target: Diagram, homotopyFn: (x: number, y: number, t: number) => [number, number], options?: AnimationConfig): Animation;
+
+/**
+ * @locusing/geometry - 坐标系
+ *
+ * 实现 Axes、NumberLine、NumberPlane 等
+ */
+
+interface AxesConfig {
+    xRange?: [number, number, number?];
+    yRange?: [number, number, number?];
+    xLength?: number;
+    yLength?: number;
+    origin?: Vector2;
+    showTicks?: boolean;
+    showLabels?: boolean;
+    showGrid?: boolean;
+    axisColor?: string;
+    gridColor?: string;
+    labelSize?: number;
+}
+/**
+ * Axes - 二维坐标系
+ */
+declare class Axes {
+    private config;
+    private diagram;
+    constructor(config?: AxesConfig);
+    /** 构建坐标系图形 */
+    private build;
+    /** 坐标转像素 */
+    c2p(x: number, y: number): Vector2;
+    c2p(point: Vector2): Vector2;
+    /** 像素转坐标 */
+    p2c(px: number, py: number): Vector2;
+    p2c(point: Vector2): Vector2;
+    /** 绑制函数图像 */
+    plot(fn: (x: number) => number, options?: {
+        xRange?: [number, number];
+        color?: string;
+        strokeWidth?: number;
+        samples?: number;
+    }): Diagram;
+    /** 绘制参数曲线 */
+    plotParametric(fn: (t: number) => Vector2, options?: {
+        tRange?: [number, number];
+        color?: string;
+        strokeWidth?: number;
+        samples?: number;
+    }): Diagram;
+    /** 获取函数图像下方区域 */
+    getArea(graph: Diagram, options?: {
+        xRange?: [number, number];
+        color?: string;
+        opacity?: number;
+    }): Diagram;
+    /** 获取图形标签 */
+    getGraphLabel(graph: Diagram, label: string, options?: {
+        position?: 'end' | 'start' | 'center';
+        direction?: Vector2;
+        fontSize?: number;
+    }): Diagram;
+    /** 获取 Diagram */
+    toDiagram(): Diagram;
+}
+/**
+ * NumberLine - 数轴
+ */
+declare class NumberLine {
+    private config;
+    private diagram;
+    constructor(config?: {
+        range?: [number, number, number?];
+        length?: number;
+        origin?: Vector2;
+        showTicks?: boolean;
+        showLabels?: boolean;
+        color?: string;
+    });
+    private build;
+    n2p(n: number): Vector2;
+    p2n(p: Vector2): number;
+    toDiagram(): Diagram;
+}
+/**
+ * NumberPlane - 数平面（带网格的坐标系）
+ */
+declare function NumberPlane(config?: AxesConfig): Axes;
+/**
+ * 创建极坐标系
+ */
+declare function PolarAxes(config?: {
+    maxRadius?: number;
+    origin?: Vector2;
+    divisions?: number;
+    color?: string;
+}): Diagram;
+
+/**
+ * @locusing/geometry - 几何构造
+ *
+ * 尺规作图、几何变换等
+ */
+
+/**
+ * 线段垂直平分线
+ */
+declare function perpendicularBisector(a: Vector2, b: Vector2, length?: number): Diagram;
+/**
+ * 过点作垂线
+ */
+declare function perpendicularLine(point: Vector2, lineStart: Vector2, lineEnd: Vector2, length?: number): Diagram;
+/**
+ * 点到直线的垂足
+ */
+declare function footOfPerpendicular(point: Vector2, lineStart: Vector2, lineEnd: Vector2): Vector2;
+/**
+ * 过一点作平行线
+ */
+declare function parallelLine(point: Vector2, lineStart: Vector2, lineEnd: Vector2, length?: number): Diagram;
+/**
+ * 角度标记
+ */
+declare function angleMarker(vertex: Vector2, a: Vector2, b: Vector2, options?: {
+    radius?: number;
+    color?: string;
+    label?: string;
+}): Diagram;
+/**
+ * 直角标记
+ */
+declare function rightAngleMarker(vertex: Vector2, a: Vector2, b: Vector2, size?: number): Diagram;
+/**
+ * 过三点的圆
+ */
+declare function circumscribedCircle(a: Vector2, b: Vector2, c: Vector2): {
+    center: Vector2;
+    radius: number;
+    diagram: Diagram;
+};
+/**
+ * 内切圆
+ */
+declare function inscribedCircle(a: Vector2, b: Vector2, c: Vector2): {
+    center: Vector2;
+    radius: number;
+    diagram: Diagram;
+};
+/**
+ * 两圆的交点
+ */
+declare function circleIntersections(c1: Vector2, r1: number, c2: Vector2, r2: number): Vector2[];
+/**
+ * 重心
+ */
+declare function centroid(a: Vector2, b: Vector2, c: Vector2): Vector2;
+/**
+ * 垂心
+ */
+declare function orthocenter(a: Vector2, b: Vector2, c: Vector2): Vector2;
+/**
+ * 中线
+ */
+declare function median(vertex: Vector2, opposite1: Vector2, opposite2: Vector2): Diagram;
+/**
+ * 角平分线
+ */
+declare function angleBisector(vertex: Vector2, a: Vector2, b: Vector2, length?: number): Diagram;
+/**
+ * 高
+ */
+declare function altitude(vertex: Vector2, opposite1: Vector2, opposite2: Vector2): Diagram;
+/**
+ * 点关于点的对称
+ */
+declare function reflectPoint(point: Vector2, center: Vector2): Vector2;
+/**
+ * 点关于直线的对称
+ */
+declare function reflectPointOverLine(point: Vector2, lineStart: Vector2, lineEnd: Vector2): Vector2;
+/**
+ * 图形关于点对称
+ */
+declare function reflectOverPoint(diagram: Diagram, center: Vector2): Diagram;
+/**
+ * 两直线交点
+ */
+declare function lineIntersection(l1Start: Vector2, l1End: Vector2, l2Start: Vector2, l2End: Vector2): Vector2 | null;
+
+/**
+ * @locusing/interactive - Interactive 控制器
+ *
+ * Diagramatics 风格的交互系统
+ */
+
+interface InteractiveOptions {
+    width?: number;
+    height?: number;
+    background?: string;
+    /** 控件面板位置 */
+    controlsPosition?: 'top' | 'bottom' | 'left' | 'right';
+    /** 控件面板样式 */
+    controlsStyle?: Partial<CSSStyleDeclaration>;
+    /** 是否使用手绘风格 */
+    rough?: boolean;
+}
+interface SliderConfig {
+    min: number;
+    max: number;
+    value?: number;
+    step?: number;
+    label?: string;
+    showPlayButton?: boolean;
+    playDuration?: number;
+    loop?: boolean;
+}
+interface LocatorConfig {
+    x: number;
+    y: number;
+    radius?: number;
+    color?: string;
+    constraint?: (p: Vector2) => Vector2;
+}
+interface ButtonConfig {
+    label: string;
+    onClick: () => void;
+}
+type ControlValue = number | Vector2 | boolean;
+type ControlValues = Record<string, ControlValue>;
+/**
+ * Interactive 类 - 交互控制器
+ *
+ * 使用方式：
+ * ```typescript
+ * const int = new Interactive(container);
+ * int.slider('angle', { min: 0, max: 360, value: 0 });
+ * int.locator('point', { x: 100, y: 100 });
+ * int.draw((v) => {
+ *   return square(100).rotate(v.angle).position(v.point);
+ * });
+ * ```
+ */
+declare class Interactive {
+    private container;
+    private svgContainer;
+    private controlsContainer;
+    private svg;
+    private options;
+    private values;
+    private controls;
+    private locators;
+    private drawFn;
+    private animationId;
+    private playingSliders;
+    constructor(container: HTMLElement, options?: InteractiveOptions);
+    /** 设置布局 */
+    private setupLayout;
+    /** 创建 SVG */
+    private createSVG;
+    /** 添加滑块控件 */
+    slider(name: string, config: SliderConfig): this;
+    /** 添加可拖拽点 */
+    locator(name: string, config: LocatorConfig): this;
+    /** 添加按钮 */
+    button(config: ButtonConfig): this;
+    /** 添加复选框 */
+    checkbox(name: string, config?: {
+        label?: string;
+        value?: boolean;
+    }): this;
+    /** 设置绘制函数 */
+    draw(fn: (values: ControlValues) => Diagram): this;
+    /** 重新绘制 */
+    private redraw;
+    /** 启动动画循环 */
+    private startAnimationLoop;
+    /** 获取当前值 */
+    getValue<T extends ControlValue>(name: string): T;
+    /** 设置值 */
+    setValue(name: string, value: ControlValue): this;
+    /** 销毁 */
+    destroy(): void;
+}
+/**
+ * 创建交互实例
+ */
+declare function createInteractive(container: HTMLElement, options?: InteractiveOptions): Interactive;
+
+/**
+ * @locusing/interactive
+ *
+ * 交互系统 - Diagramatics 风格的交互控件
+ */
+
+/**
+ * 圆形约束 - 将点约束到圆周上
+ */
+declare function circleConstraint(cx: number, cy: number, radius: number): (p: Vector2) => Vector2;
+/**
+ * 线段约束 - 将点约束到线段上
+ */
+declare function lineConstraint(x1: number, y1: number, x2: number, y2: number): (p: Vector2) => Vector2;
+/**
+ * 矩形约束 - 将点约束到矩形内
+ */
+declare function rectConstraint(x: number, y: number, width: number, height: number): (p: Vector2) => Vector2;
+/**
+ * 网格约束 - 将点吸附到网格
+ */
+declare function gridConstraint(gridSize: number, offsetX?: number, offsetY?: number): (p: Vector2) => Vector2;
+/**
+ * 极坐标约束 - 将点约束到极坐标系
+ */
+declare function polarConstraint(cx: number, cy: number, minRadius: number, maxRadius: number): (p: Vector2) => Vector2;
+/**
+ * 函数曲线约束 - 将点约束到函数曲线上
+ */
+declare function functionConstraint(fn: (x: number) => number, minX: number, maxX: number): (p: Vector2) => Vector2;
+
+export { type Animation, type AnimationConfig, AnimationGroup, type AnimationGroupOptions, type AnimationOptions, type AnimationStatus, ApplyMethod, type ArcShape, Axes, type AxesConfig, type BaseShape, Blink, type ButtonConfig, type CircleShape, Circumscribe, type CircumscribeOptions, Create, type CreateOptions, DEGREES, DL, DOWN, DR, Diagram, DrawBorderThenFill, type EasingFunction, type EllipseShape, FadeIn, FadeInFrom, FadeInFromDown, FadeInFromLeft, FadeInFromRight, FadeInFromUp, type FadeOptions, FadeOut, FadeOutTo, FadeTransform, Flash, type FlashOptions, type GroupShape, GrowFromCenter, GrowFromEdge, GrowFromPoint, Homotopy, IDENTITY, Indicate, type IndicateOptions, Interactive, type InteractiveOptions, LEFT, LaggedStart, LaggedStartMap, type LineShape, type LocatorConfig, type LocatorOptions, type Matrix3, Morphing, MoveAlongPath, type MoveOptions, MoveTo, MoveToTarget, NumberLine, NumberPlane, ORIGIN, PI, type PathCommand, type PathShape, type Point, PolarAxes, type PolygonShape, type PolylineShape, RIGHT, type RectShape, type RenderOptions, ReplacementTransform, Rotate, type RotateOptions, Rotating, type RoughRenderOptions, Scale, ScaleInPlace, type ScaleOptions, Scene, type SceneConfig, type Shape, type ShapeType, Shift, ShowPassingFlash, type SliderConfig, type SliderOptions, SpinInFromNothing, type Style, Succession, TAU, type TextShape, type TextStyle, Timeline, type TimelineOptions, Transform, TransformMatchingShapes, type TransformOptions, UL, UP, UR, UpdateFromAlphaFunc, UpdateFromFunc, V2, V3, ValueTracker, type Vector2, type Vector3, Wait, Wiggle, type WiggleOptions, Write, add, altitude, angle, angleBetween, angleBisector, angleMarker, applyMatrix, arc, arrow, centroid, circle, circleConstraint, circleIntersections, circumscribedCircle, clamp, combine, createInteractive, createScene, createTimeline, cross, cubicBezier, degToRad, distance, div, dot, doubleArrow, easing, easingMap, ellipse, equilateralTriangle, footOfPerpendicular, functionConstraint, getGSAPEasing, gridConstraint, group, inscribedCircle, length, lerp, lerpNumber, line, lineConstraint, lineIntersection, mapRange, matrixMultiply, median, midpoint, mul, normalize, orthocenter, parallelLine, path, pathFromString, perpendicular, perpendicularBisector, perpendicularLine, polarConstraint, polygon, polyline, quadraticBezier, radToDeg, rect, rectConstraint, reflect, reflectOverPoint, reflectPoint, reflectPointOverLine, regularPolygon, renderToRough, renderToSVG, rightAngleMarker, rotate, rotationMatrix, roughPresets, sampleParametric, scaleMatrix, sector, square, star, sub, tex, text, toSVGString, translationMatrix, triangle, dot$1 as vectorDot };