@iconsets/svg-morpheus-ts/dist/svg-morpheus.d.ts

ESM TypeScript library enabling SVG icons to morph from one to the other. It implements Material Design's Delightful Details transitions. Refactored with modern TypeScript + Vite + pnpm stack. Supports both Chinese and English documentation.

import { CallbackFunction, EasingFunction, SVGMorpheusOptions, ToMethodOptions } from './types';
export declare class SVGMorpheus {
    private readonly _icons;
    private readonly _defDuration;
    private readonly _defEasing;
    private readonly _defRotation;
    private readonly _defCallback;
    private readonly _lite;
    private _curIconId;
    private _toIconId;
    private _curIconItems;
    private _fromIconItems;
    private _toIconItems;
    private _morphNodes;
    private _morphG;
    private _startTime;
    private _duration;
    private _easing;
    private _rotation;
    private _callback;
    private _rafid;
    private _svgDoc;
    private _fnTick;
    /**
     * SVGMorpheus Constructor | SVGMorpheus 构造器
     * Creates a new SVGMorpheus instance for morphing SVG icons | 创建一个新的 SVGMorpheus 实例用于变形 SVG 图标
     *
     * @param element - Target SVG element or CSS selector | 目标 SVG 元素或 CSS 选择器
     *    - string: CSS selector to find the SVG element | 字符串：用于查找 SVG 元素的 CSS 选择器
     *    - HTMLElement: Direct reference to HTML element containing SVG | HTML 元素：直接引用包含 SVG 的 HTML 元素
     *    - SVGSVGElement: Direct reference to SVG element | SVG 元素：直接引用 SVG 元素
     *
     * @param options - Configuration options for default behavior | 默认行为的配置选项
     *
     * @param callback - Default callback function executed after animations complete | 动画完成后执行的默认回调函数
     *     Called when any morphing animation finishes | 当任何变形动画完成时被调用
     *     Can be overridden by individual to() method calls | 可以被单独的 to() 方法调用覆盖
     */
    constructor(element: string | HTMLElement | SVGSVGElement, options?: SVGMorpheusOptions, callback?: CallbackFunction);
    private _init;
    private _setupAnimation;
    private _updateAnimationProgress;
    private _animationEnd;
    /**
     * 变形到目标图标
     *
     * @param iconId - 要变形到的目标图标ID，必须匹配 SVG 中某个 <g> 元素的 ID；
     * @param options - 此次特定变形的动画选项；
     * @param callback - 此次特定变形的回调函数，只有发生了变形调用时才会调用此函数；
     */
    to(iconId: string, options?: ToMethodOptions, callback?: CallbackFunction): void;
    /**
     * 当前正在展示的图标 ID
     */
    currIconId(): string;
    /**
     * Register custom easing function | 注册自定义缓动函数
     * Adds a custom easing function that can be used in animations | 添加可在动画中使用的自定义缓动函数
     *
     * @param name Unique name for the easing function | 缓动函数的唯一名称
     *  his name will be used to reference the function in options | 此名称将用于在选项中引用该函数
     *
     * @param fn Custom easing function | 自定义缓动函数
     *  es progress (0-1) and returns eased progress (typically 0-1) | 接受进度值(0-1)并返回缓动后的进度值(通常为0-1)
     *  ram progress Animation progress from 0 to 1 | 从0到1的动画进度
     *  turns Eased progress value | 缓动后的进度值
     *
     * @example
     * // Register a custom bounce easing | 注册自定义弹跳缓动
     * morpheus.registerEasing('my-bounce', (t) => {
     *   return t < 0.5 ? 2 * t * t : -1 + (4 - 2 * t) * t;
     * });
     */
    registerEasing(name: string, fn: EasingFunction): void;
    /**
     * 动态插入转换后的 defs 到 SVG 文档中
     */
    private _injectTransformedDefs;
    /**
     * 插入 defs 内容到 defs 元素中
     */
    private _insertDefsContent;
}
export default SVGMorpheus;
//# sourceMappingURL=svg-morpheus.d.ts.map