import { BodyType, Cache, ChunkDetail, ChunkInfo, ComparisonOperator, Credentials, DateString, Deadline, DeviceType, Direction, DotImageCanvasOptions, DotTextCanvasOptions, DragEvent, EventBus, FileChunk, FileMD5, FileSpliceOptions, FileType, IFetchConfig, IFetchInterceptors, IFetchOptions, IShellMessage, ISignature, ImageData as ImageData$1, IsESModule, JSCookie, LRU, Lang, MaybeElement, Merge, Method, Mode, MutationObserverInit, NodeWorkerPayload, ParsedURL, PkgTool, Position, Redirect, ResponseType, TimeUnit, TrimType, UseTimeoutReturn } from "./types-Bz_zk0kF.js";
import { Element as Element$1 } from "domhandler";

//#region src/array/diff.d.ts
interface Options$2 {
  compare?: 'same' | 'different';
  result?: 'value' | 'index';
}
/**
 * 比较两个数组，返回相同项或不同项（值或索引）
 * @description EN: Compare two arrays and return either same/different items or their indices.
 * @param {any[]} array1 First array.
 * @param {any[]} array2 Second array.
 * @param {Options} [options] Comparison options.
 * @returns {any[] | number[][]} Depending on options, returns matching values, indices, or paired differences.
 */
declare function diff(array1: any[], array2: any[], options?: Options$2): any[] | number[][];

//#endregion
//#region src/array/forEach.d.ts
interface ForEachCallback<T> {
  (value: T, index: number, array: T[]): any;
}
/**
 * 遍历数组并允许通过返回值提前退出
 * @description EN: Iterate over an array and allow early return if the callback returns a defined value.
 * @param {T[]} array Input array to iterate.
 * @param {(value: T, index: number, array: T[]) => any} callback Callback invoked for each element.
 * @returns {any} The first defined (non-undefined) return value from the callback, or undefined.
 */
declare function forEach<T>(array: T[], callback: ForEachCallback<T>): any;

//#endregion
//#region src/array/getAverage.d.ts
/**
 * 计算数字数组的平均值并格式化为指定小数位
 * @description EN: Compute the average of a number array and return it formatted to a fixed number of decimal places.
 * @param {number[]} array Input numbers.
 * @param {number} [fraction] Number of decimal places to keep.
 * @returns {string} Formatted average as string (from toFixed).
 */
declare function getAverage(array: number[], fraction?: number): string;

//#endregion
//#region src/array/quickFilter.d.ts
/**
 * 快速筛选数组项，支持简易条件或正则
 * @description EN: Filter an array quickly by simple conditions or regex expressions. Keys can be 'prop=value' or regex literals.
 * @param {any[]} array Input array of objects.
 * @param {string | string[]} key Filter key or array of keys.
 * @returns {any[]} Filtered array.
 */
declare function quickFilter(array: any[], key: string | Array<string>): any[];

//#endregion
//#region src/array/quickFind.d.ts
/**
 * 快速建立基于主键的查找结构（支持增删改）
 * @description EN: Build a quick-find helper for arrays keyed by a primary field. Returns an object with find/set/delete utilities.
 * @template T Record-like item type.
 * @param {T[]} array Input array of records.
 * @param {keyof T | string} id Property name used as primary key.
 * @returns {QuickFind<T>} QuickFind wrapper instance.
 */
declare function quickFind<T extends Record<string, any>>(array: T[], id: keyof T | string): QuickFind<T>;
/**
 * QuickFind helper class wrapping an array and an index map keyed by the provided id.
 * Provides convenience methods to find, set, update and delete items by id.
 * This class is returned by the `quickFind` factory function.
 *
 * @template T Item record type.
 */
declare class QuickFind<T extends Record<string, any>> {
  array: T[];
  indexMap: Map<any, number>;
  id: keyof T | string;
  constructor(array: T[], indexMap: Map<any, number>, id: keyof T | string);
  /**
   * Find an item by its id.
   * @param id - primary key value to look up
   * @returns the found item or undefined when not present
   */
  find(id: any): T | undefined;
  /**
   * Internal update helper. When `key` is undefined the whole item is replaced.
   * Otherwise a single property on the target item is updated.
   * @internal
   */
  _update(id: any, key: keyof T | T, value: any): T[];
  /**
   * Delete an item by id. Returns the mutated array when deletion happened.
   * @param id - primary key value
   * @returns the array after deletion, or undefined when id not found
   */
  delete(id: any): T[] | undefined;
  /**
   * Set or insert an item by id. If an item with `id` exists it will be updated;
   * otherwise the provided value will be pushed (must include the primary id).
   *
   * Usage:
   * - set(id, item) -> inserts or replaces the whole item
   * - set(id, key, value) -> updates a single property on existing item
   *
   * @param id - primary key value
   * @param key - either a property key to update or the full item when inserting
   * @param value - when `key` is a property key this is the new value; optional when inserting
   * @returns the array after mutation
   */
  set(id: any, key: keyof T | T, value?: any): T[];
}

//#endregion
//#region src/array/sort.d.ts
/**
 *
 * @param { any[] } array 数组
 * @param { Array<string | number> | number | string } match 匹配条件
 * @returns
 */
declare function sort<T>(array: T[], match: Array<string | number> | number | string): T[];

//#endregion
//#region src/array/sortByOrder.d.ts
/**
 * 根据指定顺序对数组排序
 * @description EN: Sort items in `array` according to the given `order` sequence. Items not in `order` will be placed after ordered items. Use `key` to pick nested values (dot path supported).
 * @param {T[]} array The input array to sort.
 * @param {Array<string|number>} order An array specifying the desired order of values. Use "*" in `order` to mark the insertion index for remaining items.
 * @param {string} [key] Optional dot-separated key name to extract the value from objects in `array`.
 * @returns {T[]} A new array sorted according to `order`.
 */
declare function sortByOrder<T>(array: T[], order: Array<string | number>, key?: string): T[];

//#endregion
//#region src/array/uniqueArray.d.ts
/**
 * 数组去重函数
 * @description EN: Remove duplicates from an array. Optionally dedupe by specified key paths (supports nested paths like 'target.age').
 * @param { any[] } array 数组
 * @param { string[] } keys 可选，指定比较的键路径数组，如 ['name', 'target.age']。如果指定了keys，则只要这些指定的键值都相同，就认为是同一项进行去重
 * @returns 去重后的数组
 * @example
 * // 基本去重
 * uniqueArray([1, 2, 2, 3]) // [1, 2, 3]
 *
 * // 按指定键去重
 * uniqueArray([
 *   { name: 'Tom', age: 20 },
 *   { name: 'Tom', age: 25 },
 *   { name: 'Jerry', age: 20 }
 * ], ['name']) // [{ name: 'Tom', age: 20 }, { name: 'Jerry', age: 20 }]
 *
 * // 按多个键去重
 * uniqueArray([...], ['name', 'age']) // 只有name和age都相同才认为是重复项
 *
 * // 按嵌套键去重
 * uniqueArray([...], ['target.age']) // 支持深层嵌套访问
 */
declare function uniqueArray(array: any[], keys?: string[]): any[];

//#endregion
//#region src/array/chunk.d.ts
/**
 * 将数组拆分为指定大小的块
 * @description EN: Split an array into chunks of the given size.
 * @param {T[]} arr Input array to split.
 * @param {number} [size] Maximum size of each chunk.
 * @returns {T[][]} Array of chunked arrays.
 */
declare function chunk<T>(arr: T[], size?: number): T[][];

//#endregion
//#region src/array/countBy.d.ts
/**
 * 按照迭代器结果统计数组中元素出现次数
 * @description EN: Count elements in an array grouped by the value returned from the iterator.
 * @param { any[] } array Input array to count.
 * @param { Function } iterator Function that maps each item to a key.
 * @returns {Record<string, number>} Map from key to its occurrence count.
 */
declare function countBy<T extends Record<string, any>>(array: T[], iterator: (item: T) => any): Record<string, number>;

//#endregion
//#region src/array/flatten.d.ts
/**
 * 将嵌套结构扁平化为数组
 * @description EN: Flatten a nested tree-like structure into a flat array. The property used for children can be customized.
 * @param { Record<string, any> | Record<string, any>[] } o Object or array to flatten.
 * @param { string } [flattenProps] Property name that holds children.
 * @param { boolean } [onlyLastNode] When true, only keep leaf nodes.
 * @param { any[] } [result] Internal accumulator used during recursion.
 * @returns { any[] } Flattened array of nodes.
 */
declare function flatten<T extends Record<string, any>>(o: T | T[], flattenProps?: string, onlyLastNode?: boolean, result?: T[]): T[];

//#endregion
//#region src/array/filterEmpty.d.ts
/**
/**
 * 过滤数组中的空值（falsey 值）
 * @description EN: Remove empty/falsey values from an array (filters with Boolean).
 * @param {T[]} array Input array.
 * @returns {T[]} Filtered array with truthy values only.
 */
declare function filterEmpty<T>(array: T[]): T[];

//#endregion
//#region src/canvas/Canvas.d.ts
declare class Canvas {
  canvas: HTMLCanvasElement;
  ctx: CanvasRenderingContext2D;
  constructor(width?: number, height?: number);
}

//#endregion
//#region src/canvas/CreateSignatureCanvas.d.ts
/**
 * 创建签名画布工具类
 * @description EN: Utility class to create and manage a signature canvas with drawing, undo/redo, and export features.
 */
declare class CreateSignatureCanvas implements ISignature {
  canvas: HTMLCanvasElement;
  ctx: CanvasRenderingContext2D;
  stop: (() => void)[];
  active: boolean;
  historyStack: ImageData[];
  resetStack: ImageData[];
  color: string;
  bg: string;
  constructor(lineWidth?: number, w?: number, h?: number, color?: string, bg?: string);
  createCanvas(lineWidth: number | undefined, w: number, h: number): void;
  clearCanvas(): void;
  mount(el: MaybeElement): this;
  setColor(color: string): void;
  setBgColor(color: string): void;
  unmount(): void;
  listen(): void;
  undo(): void;
  redo(): void;
  erase(lineWidth?: number): void;
  unerased(): void;
  save(type?: string, quality?: number): string;
}

//#endregion
//#region src/canvas/DotImageCanvas.d.ts
/**
 * DotImageCanvas 将图片转换为点阵图形式展示，并提供动画绘制效果
 *
 * 支持多种绘制方向，颜色控制，背景设置，以及动画效果控制
 * @class
 * @description EN: Convert an image to a dot-matrix representation and provide animated drawing controls with various directions, colors, background and animation options.
 */
declare class DotImageCanvas {
  /** 用于绘制的 Canvas 元素 */
  canvas: HTMLCanvasElement;
  /** Canvas 的绘制上下文 */
  ctx: CanvasRenderingContext2D;
  /** 缓存已处理图像的点阵数据 */
  points: Map<string, Record<string, any>>;
  /** 原始图片源地址 */
  originSrc: string;
  /** 点阵图颜色，设置后将覆盖原图颜色 */
  color: string;
  /** 点阵粗细，影响绘制的圆点大小 */
  fontWeight: number;
  /** 绘制状态：pending-绘制中，success-完成，fail-失败，reverted-已撤销 */
  status: string;
  /** 背景颜色 */
  bgColor?: string;
  /** 停止当前动画的函数 */
  stop: () => void;
  /** 绘制方向 */
  direction: Direction;
  /** 所有绘制任务 */
  allTasks: Function[];
  /** 已完成的任务索引 */
  completedTaskIndex: number;
  /** 是否正在撤销绘制 */
  isReverting: boolean;
  /** 每个绘制任务中的点坐标记录 */
  drawnPoints: Array<{
    x: number;
    y: number;
    color: any;
  }[]>;
  /** 清除任务列表 */
  clearTasks: Function[];
  /** 是否使用优先渲染模式 (RAF) */
  isPreferred: boolean;
  /** 是否已挂载到DOM */
  mounted: boolean;
  /**
   * 创建 DotImageCanvas 实例
   *
   * @param {string | DotImageCanvasOptions} srcOrOptions - 图片URL或选项对象
   * @param {string} [color] - 绘制颜色，为空时保留原图颜色
   * @param {number} [fontWeight] - 点阵粗细
   * @param {string} [bgColor] - 背景颜色
   * @param {Direction} [direction] - 绘制方向
   */
  constructor(srcOrOptions: string | DotImageCanvasOptions, color?: string, fontWeight?: number, bgColor?: string, direction?: Direction);
  createDotImage(img: HTMLImageElement): (string | number | undefined)[][];
  createImage(): Promise<unknown> | undefined;
  hasImage(): boolean;
  executor(): Promise<this>;
  /**
   * 创建绘制和清除任务的辅助方法 - 保持原有实现方式
   */
  createDrawAndClearTasks(pointsGenerator: () => {
    x: number;
    y: number;
    color: any;
  }[], size: number): {
    drawTask: () => void;
    clearTask: () => void;
  };
  getCanvas(imagePointSet: (string | number | undefined)[][]): void;
  startAnimation(): this;
  revert(): this;
  continue(): this;
  initOptions(src: string, color: string, fontWeight: number, bgColor: string, direction?: Direction): void;
  /**
   * 重新绘制图像，可以更新配置
   *
   * @param {string | Partial<DotImageCanvasOptions>} srcOrOptions - 图片URL或选项对象
   * @param {string} [color] - 点阵颜色
   * @param {number} [fontWeight] - 点阵粗细
   * @param {string} [bgColor] - 背景颜色
   * @param {Direction} [direction] - 绘制方向
   * @returns {Promise<DotImageCanvas>} 更新后的实例
   */
  repaint(srcOrOptions: string | Partial<DotImageCanvasOptions>, color?: string, fontWeight?: number, bgColor?: string, direction?: Direction): Promise<this>;
  clearCanvas(): void;
  append(container: MaybeElement): this;
  destory(): void;
}

//#endregion
//#region src/canvas/DotTextCanvas.d.ts
/**
 * DotTextCanvas 将文字转换为点阵形式展示，并提供动画绘制效果
 *
 * 支持多种绘制方向、颜色控制、间距设置以及动画效果
 * @class
 * @description EN: Convert text into a dot-matrix representation and animate the drawing with configurable direction, color and spacing options.
 */
declare class DotTextCanvas {
  /** 用于绘制的 Canvas 元素 */
  canvas: HTMLCanvasElement;
  /** Canvas 的绘制上下文 */
  ctx: CanvasRenderingContext2D;
  /** 缓存已处理字符的点阵数据 */
  points: Map<string, Array<number[]>>;
  /** 原始文本内容 */
  originText: string;
  /** 字体大小 */
  fontSize: number;
  /** 点阵颜色 */
  color: string;
  /** 点阵粗细，影响绘制的圆点大小 */
  fontWeight: number;
  /** 绘制方向 */
  direction: Direction;
  /** 全局字符间距，默认为0 */
  charSpacing: number;
  /** 每个字符对之间的间距数组，优先级高于全局间距 */
  charSpacings: number[];
  /** 存储最终合成的点阵数据 */
  textPointSet: Array<number[]>;
  /** 绘制状态：pending-绘制中，success-完成 */
  status: string;
  /** 容器元素 */
  container?: HTMLElement;
  /** 停止当前动画的函数 */
  stop: () => void;
  /** 是否已挂载到DOM */
  mounted: boolean;
  /** 是否使用优先渲染模式(RAF) */
  isPreferred: boolean;
  /** 用于文本绘制的临时Canvas元素 */
  private _textCanvas?;
  /** 临时Canvas的绘制上下文 */
  private _textCtx?;
  /**
   * 创建 DotTextCanvas 实例
   *
   * @param {string | DotTextCanvasOptions} textOrOptions - 文本内容或选项对象
   * @param {number} [fontSize] - 字体大小
   * @param {string} [color] - 点阵颜色
   * @param {number} [fontWeight] - 点阵粗细
   * @param {Direction} [direction] - 绘制方向
   * @param {boolean} [isPreferred] - 是否使用优先渲染模式
   * @param {number} [charSpacing] - 全局字符间距
   * @param {number[]} [charSpacings] - 每个字符对之间的间距数组
   */
  constructor(textOrOptions: string | DotTextCanvasOptions, fontSize?: number, color?: string, fontWeight?: number, direction?: Direction, isPreferred?: boolean, charSpacing?: number, charSpacings?: number[]);
  /**
   * 为单个字符创建点阵数据
   *
   * @param {string} text - 要转换为点阵的字符
   * @returns {Array<number[]>} 字符的点阵数据
   */
  createTextPoint(text: string): number[][];
  /**
   * 执行文字点阵转换流程
   */
  executor(): void;
  /**
   * 获取字符的点阵数据，如果不存在则创建
   *
   * @param {string} text - 要获取点阵数据的字符
   * @returns {Array<number[]>|undefined} 字符的点阵数据
   */
  getText(text: string): number[][] | undefined;
  /**
   * 合并所有字符的点阵数据，并应用字符间距
   *
   * @returns {Array<number[]>} 合并后的点阵数据
   */
  combineText(): number[][];
  /**
   * 根据绘制方向生成点坐标数组
   *
   * @param {number} h - 点阵高度
   * @param {number} w - 点阵宽度
   * @returns {Array<[number, number]>} 按指定方向排列的点坐标数组
   */
  getPointsForDirection(h: number, w: number): Array<[number, number]>;
  /**
   * 设置Canvas大小并准备绘制
   */
  getCanvas(): void;
  /**
   * 创建分批绘制任务
   *
   * @param {Array<[number, number]>} pointsToDraw - 要绘制的点坐标数组
   * @param {number} batchSize - 每批绘制的点数量
   * @param {Function} getPoint - 点坐标计算函数
   * @param {number} size - 点的大小
   * @returns {Array<Function>} 绘制任务数组
   */
  createDrawTasks(pointsToDraw: Array<[number, number]>, batchSize: number, getPoint: Function, size: number): Function[];
  /**
   * 创建一批点的绘制任务
   *
   * @param {Array<[number, number]>} points - 一批要绘制的点坐标
   * @param {Function} getPoint - 点坐标计算函数
   * @param {number} size - 点的大小
   * @returns {Function} 绘制任务函数
   */
  createBatchDrawTask(points: Array<[number, number]>, getPoint: Function, size: number): () => void;
  /**
   * 开始执行动画绘制
   *
   * @param {Array<Function>} tasks - 绘制任务数组
   */
  startDrawing(tasks: Array<Function>): void;
  /**
   * 重新绘制文字，可以更新配置
   *
   * @param {string | Partial<DotTextCanvasOptions>} textOrOptions - 文本内容或选项对象
   * @param {number} [fontSize] - 字体大小
   * @param {string} [color] - 点阵颜色
   * @param {number} [fontWeight] - 点阵粗细
   * @param {Direction} [direction] - 绘制方向
   * @returns {DotTextCanvas} 当前实例
   */
  repaint(this: any, textOrOptions: string | Partial<DotTextCanvasOptions>, fontSize?: number, color?: string, fontWeight?: number, direction?: Direction): DotTextCanvas;
  /**
   * 清除Canvas上的内容
   */
  clearCanvas(): void;
  /**
   * 将Canvas元素添加到DOM容器中
   *
   * @param {MaybeElement} container - 要插入的容器元素
   * @returns {DotTextCanvas} 当前实例
   */
  append(container: MaybeElement): this;
  /**
   * 销毁实例，移除DOM元素并停止所有动画
   */
  destory(): void;
}

//#endregion
//#region src/canvas/getImageData.d.ts
declare function getImageData(src: string): Promise<ImageData$1>;

//#endregion
//#region src/canvas/removeRoundSpace.d.ts
declare function removeRoundSpace(data: number[][]): number[][];

//#endregion
//#region src/canvas/sliderValidation.d.ts
declare function sliderValidation(url: string, container: HTMLElement | string, l?: number | (() => void), callback?: () => void): Promise<void>;

//#endregion
//#region src/canvas/Line.d.ts
declare class Line {
  ctx: CanvasRenderingContext2D;
  color: string;
  isFill: boolean;
  constructor(ctx: CanvasRenderingContext2D, color?: string, isFill?: boolean);
  draw(points: number[][], color?: string): void;
}

//#endregion
//#region src/canvas/Point.d.ts
declare class Point {
  r: number;
  ctx: CanvasRenderingContext2D;
  color: string;
  constructor(ctx: CanvasRenderingContext2D, r?: number, color?: string);
  draw(x: number, y: number, color?: string, r?: number): void;
}

//#endregion
//#region src/canvas/Square.d.ts
declare class Square {
  ctx: CanvasRenderingContext2D;
  r: number;
  color: string;
  isFill: boolean;
  constructor(ctx: CanvasRenderingContext2D, r?: number, color?: string, isFill?: boolean);
  draw(x: number, y: number, r?: number): void;
}

//#endregion
//#region src/compress/compressCss.d.ts
declare function compressCss(s: string): string;

//#endregion
//#region src/compress/compressImage.d.ts
/**
 * @description EN: Minify CSS rules by trimming selectors and removing redundant whitespace in declarations.
 * @param s - CSS string to compress
 * @returns compressed CSS string
 */
type CompressImageOptionsType = 'base64' | 'blob';
interface CompressImageOptions {
  quality?: number;
  maxWidth?: number;
  maxHeight?: number;
  type?: CompressImageOptionsType;
}
declare function compressImage(source: string | File, options?: CompressImageOptions): Promise<unknown>;

//#endregion
//#region src/css/getClasses.d.ts
declare const classesReg: RegExp;
declare function getClasses(str: string, callback: (classes: string, block: string, index: number) => string): string;

//#endregion
//#region src/css/getCssVar.d.ts
declare function getCssVar(element: MaybeElement, style: string, callback: (css: string) => void): void;

//#endregion
//#region src/css/hasClassName.d.ts
declare function hasClassName(element: Element, className: string): boolean;

//#endregion
//#region src/css/setCssVar.d.ts
declare function setCssVar(element: MaybeElement, styleObj: Record<string, string>): void;

//#endregion
//#region src/css/useNamespace.d.ts
declare function useNamespace(defaultNamespace: string): (block: string) => {
  namespace: string;
  b: (blockSuffix?: string) => string;
  e: (element?: string) => string;
  m: (modifier?: string) => string;
  be: (blockSuffix?: string, element?: string) => string;
  em: (element?: string, modifier?: string) => string;
  bm: (blockSuffix?: string, modifier?: string) => string;
  bem: (blockSuffix?: string, element?: string, modifier?: string) => string;
  is: {
    (name: string, state: boolean | undefined): string;
    (name: string): string;
  };
  cssVar: (object: Record<string, string>) => Record<string, string>;
  cssVarName: (name: string) => string;
  cssVarBlock: (object: Record<string, string>) => Record<string, string>;
  cssVarBlockName: (name: string) => string;
};

//#endregion
//#region src/css/setStyle.d.ts
declare function setStyle(el: HTMLElement | string, styleObj: Record<string, any>): void;

//#endregion
//#region src/css/removeStyle.d.ts
declare function removeStyle(el: HTMLElement | string, styles: string[] | string): void;

//#endregion
//#region src/css/addStyleRules.d.ts
/**
 *
 * @param { string } rule '#blanc { color: white }'
 * @param { number } [index] cssRules 中的位置
 * @description EN: Insert a CSS rule string into the first stylesheet at an optional index.
 */
declare function addRules(rule: string, index?: number): void;

//#endregion
//#region src/css/addClass.d.ts
/**
 * dom上添加class
 * @description EN: Add a CSS class to the provided element(s).
 * @param { MaybeElement } selector 元素
 * @param { string } className class类
 * @returns
 */
declare function addClass(selector: MaybeElement, className: string): void;

//#endregion
//#region src/css/removeClass.d.ts
/**
 * dom上删除class
 * @description EN: Remove a CSS class from the provided element(s).
 * @param { MaybeElement } selector 元素
 * @param { string } className class类
 * @returns
 */
declare function removeClass(selector: MaybeElement, className: string): void;

//#endregion
//#region src/date/formateDate.d.ts
declare function formateDate(datetime: Date, fmt?: string): string;

//#endregion
//#region src/date/getDateList.d.ts
/**
 * Generates a list of dates starting from a given date.
 *
 * @param {string} start - The start date in the format 'YYYY-MM-DD' or 'YYYY/MM/DD'.
 * @param {number} [day] - The number of days to generate. If negative, dates will be generated in reverse order.
 * @returns {string[]} An array of date strings in the format 'YYYY-MM-DD'.
 *
 * @example
 * ```typescript
 * getDateList('2023-01-01', 5);
 * // Returns ['2023-01-01', '2023-01-02', '2023-01-03', '2023-01-04', '2023-01-05', '2023-01-06']
 * ```
 */
declare function getDateList(start: string, day?: number): string[];

//#endregion
//#region src/date/getDaysOfMonth.d.ts
/**
 * Returns the number of days in a given month.
 *
 * @param {number} currentMonth - The month for which to get the number of days (0-based, where 0 = January, 11 = December).
 * @returns {number} The number of days in the specified month.
 */
declare function getDaysOfMonth(currentMonth: number): number;

//#endregion
//#region src/date/createCalendar.d.ts
/**
 * 返回当前月份的日历数组信息
 * @description EN: Generate a 6x7 calendar grid for the specified month index (0-based), returning an array of weeks with day numbers.
 * @param currentMonth 今天的月份-1 从0开始
 * @returns number[][]
 */
declare function createCalendar(currentMonth: number): unknown[][];

//#endregion
//#region src/date/compareDate.d.ts
/**
 * 比较2个月份的大小
 * @description EN: Compare two full dates (YYYY-MM-DD or YYYY/MM/DD) returning -1/0/1 when date1 is less/equal/greater than date2.
 * @param date1 '2021-02-01' | '2021/02/01'
 * @param date2 '2021-03-02' | '2021/03/02'
 * @param separator '-' | '/' 默认 '-'
 * @returns -1 | 1 | 0
 */
declare function compareDate(date1: DateString, date2: DateString, separator?: '-' | '/'): 0 | 1 | -1;

//#endregion
//#region src/date/compareTime.d.ts
/**
 * 比较两个时间的大小
 *
 * 该函数接受两个时间字符串，格式为 'HH:MM'，并比较它们的大小。
 * 返回值为 0 表示两个时间相同，1 表示第一个时间大于第二个时间，-1 表示第一个时间小于第二个时间。
 * @description EN: Compare two times given as 'HH:MM'. Returns 0 if equal, 1 if time1 > time2, -1 if time1 < time2.
 *
 * @param {string} time1 - 第一个时间字符串，格式为 'HH:MM'
 * @param {string} time2 - 第二个时间字符串，格式为 'HH:MM'
 * @returns {number} - 返回 0 表示两个时间相同，1 表示第一个时间大于第二个时间，-1 表示第一个时间小于第二个时间
 */
declare function compareTime(time1: string, time2: string): 0 | 1 | -1;

//#endregion
//#region src/date/compareDateTime.d.ts
/**
 * 比较2个日期时间的大小
 * @description EN: Compare two date-time strings and return -1 if date1 < date2, 1 if date1 > date2, or 0 if equal.
 * @param date1 '2021-02-01 12:00:01' | '2021/02/01 12:00:01'
 * @param date2 '2021-03-02 12:00:00' | '2021/03/02 12:00:00'
 * @param separator '-' | '/' 默认 '-'
 * @returns -1 | 1 | 0
 */
declare function compareDateTime(date1: DateString, date2: DateString): 0 | 1 | -1;

//#endregion
//#region src/date/getFirstDay.d.ts
/**
 * 获取当前周的周一日期
 * @description EN: Return the ISO date string for Monday of the current week (YYYY-MM-DD).
 * @returns
 */
declare function getFirstDay(): string;

//#endregion
//#region src/date/getDifferenceDays.d.ts
declare function getDifferenceDays(date1: Date | string, date2?: Date | string, unit?: TimeUnit): number;

//#endregion
//#region src/event/createElement.d.ts
/**
 * Create a DOM element with optional attributes and innerHTML.
 *
 * @param tag - tag name to create (e.g. 'div')
 * @param attributes - optional attributes object to set on the element
 * @param innerHTML - optional innerHTML to insert
 * @param options - optional ElementCreationOptions for custom elements
 * @returns the created HTMLElement
 */
declare function createElement<T extends keyof HTMLElementTagNameMap>(tag: T, attributes?: Record<string, string>, innerHTML?: string, options?: ElementCreationOptions): HTMLElementTagNameMap[T];

//#endregion
//#region src/event/createFragment.d.ts
/**
 * Create and return a DocumentFragment. Useful as a lightweight container
 * for building up DOM nodes before inserting them into the live document.
 *
 * @returns DocumentFragment
 */
declare function createFragment(): DocumentFragment;

//#endregion
//#region src/event/dragEvent.d.ts
/**
 * Unified drag event helper that supports mouse and touch.
 * It normalizes touch events to look like mouse events (clientX/clientY etc.).
 *
 * @param target - Element or selector to attach drag handlers to
 * @param options - Handlers: dragStart, dragMove, dragEnd
 * @param trigger - When true, move events only fire after a start
 * @returns A stop function to remove all listeners
 */
declare function dragEvent(target: HTMLElement | string, options?: DragEvent, trigger?: boolean): () => true | undefined;

//#endregion
//#region src/event/findElement.d.ts
/**
 * Find element(s) by CSS selector.
 *
 * - If `selector` is a string and `all` is truthy, returns a NodeList of matches.
 * - If `selector` is a string and `all` is falsy, returns the first matched
 *   HTMLElement or null.
 * - If `selector` is an array of selectors, returns an array of Elements
 *   matching all selectors (flattened).
 * - If an actual HTMLElement or NodeList is passed as `selector`, it is
 *   returned unchanged (passthrough) which makes this helper safe to call
 *   on union-typed variables.
 *
 * @param selector - CSS selector, array of selectors, HTMLElement, NodeList, or falsy
 * @param all - when true, return all matched nodes; when an HTMLElement is
 *   passed, it is used as the `currentNode` to query from. Default is false.
 * @param currentNode - Root node to query from (defaults to `document`).
 */
declare function findElement(selector: string, all?: true | HTMLElement, currentNode?: HTMLElement | Document): NodeListOf<Element> | undefined;
declare function findElement(selector: string, all?: false | undefined | HTMLElement, currentNode?: HTMLElement | Document): HTMLElement | null;
declare function findElement(selector: string[], all?: boolean | HTMLElement, currentNode?: HTMLElement | Document): Element[];
declare function findElement(selector: HTMLElement | NodeListOf<Element> | null | undefined): HTMLElement | NodeListOf<Element> | null | undefined;

//#endregion
//#region src/event/insertElement.d.ts
/**
 * Insert an element into a parent node.
 *
 * `parent` may be an HTMLElement or a selector string (the implementation uses
 * `mount` which resolves strings). `element` may be an HTMLElement,
 * DocumentFragment, or HTML string. If `target` is supplied, the element is
 * inserted before that child; otherwise it is appended.
 *
 * @param parent - parent element or selector
 * @param element - element, fragment or HTML string to insert
 * @param target - optional node to insert before
 */
declare function insertElement(parent: HTMLElement | string, element: HTMLElement | DocumentFragment | string, target?: HTMLElement | null): void;

//#endregion
//#region src/event/removeElement.d.ts
/**
 * Remove an element from the DOM.
 *
 * Accepts an HTMLElement (or ChildNode/DocumentFragment) or a selector string.
 * If a selector is provided it will be resolved via `findElement` (caller
 * should resolve before calling if passing a selector).
 *
 * @param el - Element or selector to remove
 * @returns the parent HTMLElement that contained the removed node, or null
 */
declare function removeElement(el: HTMLElement | ChildNode | DocumentFragment | string): HTMLElement | null;

//#endregion
//#region src/event/useClick.d.ts
/**
 * Attach a click listener to a target (element or selector).
 * The listener will be mounted when the element becomes available and can be stopped.
 *
 * @param target - A DOM element, selector string, or Document to attach the listener to
 * @param callback - MouseEvent handler
 * @returns A function that stops the listener. If called before the element exists, it will cancel mounting.
 */
declare function useClick(target: MaybeElement | Document, callback: (e: MouseEvent) => void): () => true | undefined;

//#endregion
//#region src/event/useElementBounding.d.ts
/**
 * Watch an element's bounding rect and invoke callback when you want to sample it.
 * The function installs a mount handler to obtain the element and returns a
 * scroll listener stop function so callers can keep the rect up-to-date on scroll.
 *
 * @param element - Element or selector to measure
 * @param callback - Receives the element's DOMRect
 * @returns Stop function for the scroll listener
 */
declare function useElementBounding(element: Element | string, callback: (rect: DOMRect) => void): () => void;

//#endregion
//#region src/event/useEventListener.d.ts
/**
 * Add an event listener to a target. The function supports Window, Document, Element,
 * MediaQueryList or selector string. Listener is automatically cleaned up when unmounted.
 *
 * @template T - Event name type from WindowEventMap & DocumentEventMap
 * @param target - Target to attach to (element, selector, window, document, or media query list)
 * @param eventName - Event name
 * @param callback - Event handler
 * @param useCapture - Options for addEventListener (capture or options object)
 * @param autoRemove - If true the listener will remove itself after first call
 * @returns A function that stops/removes the listener
 */
declare function useEventListener<T extends keyof (WindowEventMap & DocumentEventMap)>(target: Window | Document | Element | MediaQueryList | string, eventName: T, callback: (e: (WindowEventMap & DocumentEventMap)[T]) => void, useCapture?: boolean | AddEventListenerOptions, autoRemove?: boolean): () => void;

//#endregion
//#region src/event/useFocus.d.ts
/**
 * Focus the first input within the provided target when it becomes available.
 *
 * @param target - Element, selector, or 'body' to search input within
 */
declare function useFocus(target?: MaybeElement): void;

//#endregion
//#region src/event/useHover.d.ts
/**
 * Listen for hover enter/leave on a target and invoke callback with the hover state.
 *
 * @param target - Element or selector to observe
 * @param callback - Called with (isHover, event)
 * @returns A function that stops both listeners
 */
declare function useHover(target: MaybeElement, callback: (isHover: boolean, e: MouseEvent) => void): () => void;

//#endregion
//#region src/event/useIntersectionObserver.d.ts
interface IntersectionObserverOptions {
  root?: Element | Document | string | null;
  rootMargin?: string;
  threshold?: number | number[];
}
/**
 * Observe intersection changes for an element and call callback with entries.
 * `options.root` may be a selector string; if so it will be resolved via `findElement`.
 *
 * @param element - Element or selector to observe
 * @param callback - Receives IntersectionObserverEntry[] when the observer fires
 * @param options - IntersectionObserver options (root may be selector string)
 * @returns A stop function that disconnects the observer
 */
declare function useIntersectionObserver(element: Element | string, callback: (entries: IntersectionObserverEntry[]) => void, options?: IntersectionObserverOptions): () => void;

//#endregion
//#region src/event/useInterval.d.ts
interface UseIntervalControls {
  isActive: () => boolean;
  pause: () => void;
  resume: () => void;
}
type UseIntervalReturn<T> = T extends Function ? ((...args: any[]) => void) & UseIntervalControls : undefined;
/**
 * A small helper around setInterval which exposes pause/resume controls.
 * If fn is not a function undefined is returned.
 *
 * @param fn - Callback function to run on each interval
 * @param duration - Interval duration in milliseconds
 * @returns Controls object with isActive, pause and resume methods, or undefined
 */
declare function useInterval<T>(fn: T, duration: number): UseIntervalReturn<T>;

//#endregion
//#region src/event/useKeyBoard.d.ts
/**
 * Listen for specific keyboard shortcut string, e.g. "Ctrl+Shift+X".
 * Calls the callback when the generated key string matches the provided one.
 *
 * @param c - Shortcut string to match
 * @param callback - Called with the matched code when it occurs
 * @returns A stop function that removes the keydown listener
 */
declare function useKeyBoard(c: string, callback: (code: string) => void): () => void;

//#endregion
//#region src/event/useMouse.d.ts
/**
 * Throttled mousemove listener. The callback will be called at most once per `delay` ms.
 *
 * @param callback - MouseEvent handler
 * @param delay - Minimum ms between invocations
 * @returns A stop function to remove the listener
 */
declare function useMouse(callback: (e: MouseEvent) => void, delay?: number): () => void;

//#endregion
//#region src/event/useMutationObserver.d.ts
/**
 * Observe DOM mutations on a parent node and invoke callback when changes occur.
 *
 * @param element - The node or selector to observe
 * @param callback - MutationCallback invoked with mutations
 * @param options - MutationObserverInit options (defaults to { childList: true })
 * @returns A stop function to disconnect the observer
 */
declare function useMutationObserver(element: Element | string | ParentNode | Text | null, callback: MutationCallback, options?: MutationObserverInit): (() => true | undefined) | undefined;

//#endregion
//#region src/event/useResizeObserver.d.ts
/**
 * Call the callback when the window is resized, returning the viewport width and height.
 *
 * @param callback - Receives (width, height)
 * @returns A stop function for the resize listener
 */
declare function useResizeObserver(callback: (width: number, height: number) => void): () => void;

//#endregion
//#region src/event/useWindowScroll.d.ts
/**
 * Listen to document scroll and call callback with current scrollLeft/scrollTop.
 *
 * @param callback - Receives (left, top)
 * @returns A stop function for the scroll listener
 */
declare function useWindowScroll(callback: (left: number, top: number) => void): () => void;

//#endregion
//#region src/event/useTimeout.d.ts
/**
 * Run a function once after a delay and return a stop function.
 * If fn is not a function, undefined is returned.
 *
 * @param fn - Function to run after the delay
 * @param duration - Delay in milliseconds (default 0)
 * @returns A function that clears the timeout, or undefined if fn is not a function
 */
declare function useTimeout<T>(fn: T, duration?: number): UseTimeoutReturn<T>;

//#endregion
//#region src/event/collisionDetection.d.ts
/**
 * Return whether two elements overlap (axis-aligned bounding box collision).
 *
 * @param o1 - Element, selector, or null-like value for the first object
 * @param o2 - Element, selector, or null-like value for the second object
 * @returns true if the two bounding boxes overlap, false otherwise
 */
declare function collisionDetection(o1: MaybeElement, o2: MaybeElement): boolean;

//#endregion
//#region src/event/download.d.ts
/**
 * Trigger a download by creating a temporary anchor and clicking it.
 *
 * @param href - URL to download
 * @param download - suggested filename
 */
declare function download(href: string, download?: string): void;

//#endregion
//#region src/event/useHead.d.ts
interface IMeta {
  name: 'description' | 'viewport' | 'keywords' | 'robots' | string;
  content: string;
}
interface IScript {
  src: string;
  type: 'async' | 'module' | 'nomodule' | 'defer';
}
interface ILink {
  rel: 'stylesheet' | 'preload' | 'icon' | 'prefetch' | string;
  href: string;
}
interface HeadOptions {
  title?: string | (() => string);
  meta?: IMeta[];
  script?: IScript[];
  link?: ILink[];
}
/**
 * Mount meta/script/link elements and optionally set document.title.
 * The created nodes are inserted into document.head and a function to remove
 * the created fragment is returned.
 *
 * @param options - Head options (title, meta, script, link)
 * @returns A function that removes the inserted nodes from the head
 */
declare function useHead(options: HeadOptions): HTMLElement | null;

//#endregion
//#region src/event/useLongPress.d.ts
/**
 * Fire callback when the target receives a long mouse press (mousedown -> mouseup after ms).
 *
 * @param el - target element or selector
 * @param ms - duration threshold in milliseconds
 * @param callback - invoked when a long press is detected
 * @returns A stop function to remove listeners
 */
declare function useLongPress(el: MaybeElement, ms: number, callback: () => void): () => void;

//#endregion
//#region src/event/useBlur.d.ts
/**
 * Call callback when focus is lost from the given element.
 * Internally it uses click listeners to determine when clicks happen inside/outside.
 *
 * @param el - Target element or selector
 * @param callback - Called when focus is lost (click outside)
 * @returns A stop function to remove listeners
 */
declare function useBlur(el: MaybeElement, callback: () => void): () => true | undefined;

//#endregion
//#region src/event/createTextNode.d.ts
/**
 * Create a DOM Text node from a string.
 *
 * @param {string} text Text content.
 * @returns {Text} A DOM Text node.
 */
declare function createTextNode(text: string): Text;

//#endregion
//#region src/event/useRange.d.ts
/**
 * Get the bounding client rect for a caret/cursor position at the start of a node.
 * Useful for positioning popups next to inline nodes. If the container has offsets
 * the caller may need to subtract them.
 *
 * @param target - Node to measure
 * @returns DOMRect representing the range bounding box
 */
declare function useRange(target: Node): DOMRect;

//#endregion
//#region src/flex/waterfall.d.ts
/**
 * 创建图片瀑布流并挂载到目标容器
 * @description EN: Create a simple waterfall (masonry) layout for images and mount it into the target container. Returns an `append` function to add more images.
 * @param { string[] } imageList 图片 URL 列表
 * @param { MaybeElement | number } target 目标容器或直接传入宽度（当传数字时表示宽度并默认挂载到 body）
 * @param { number } width 图片显示宽度（像素），默认为 200
 * @param { number } space 图片间距（像素），默认 20
 * @returns {(imageList: string[]) => void} 返回一个函数，用于追加更多图片到瀑布流
 */
declare function waterfall(imageList: string[], target: MaybeElement | number, width?: number, space?: number): (imageList: string[]) => void;

//#endregion
//#region src/html/escapeHtml.d.ts
/**
 * 转义html
 * @description EN: Escape HTML special characters in a string to their entity equivalents.
 * @param { string } s 字符串
 * @returns
 */
declare function escapeHtml(s: string): string;

//#endregion
//#region src/html/htmlTransform.d.ts
interface Update {
  setAttribs: (key: string, value?: string) => void;
  beforeInsert: (str: string) => void;
  afterInsert: (s: string) => void;
  renameAttribs: (key: string, value: string) => void;
}
type HtmlTransformOptions = Record<string, (node: Element$1, update: Update) => void>;
/**
 * htmlparser
 * @description EN: Parse an HTML string into a DOM-like structure, allow transformations via callbacks, and return the transformed HTML string.
 * @param { string } s 字符串
 * @param options {}
 * @param { (key: string, value?: string) => void } options.setAttribs 设置属性
 * @param { (str: string) => void } options.beforeInsert 插入前
 * @param { (s: string) => void } options.afterInsert 插入后
 * @param { (key: string, value?: string) => void } options.renameAttribs 重命名
 * @returns
 */
declare function htmlTransform(s?: string, options?: HtmlTransformOptions): Promise<string>;

//#endregion
//#region src/html/unescapeHtml.d.ts
/**
 * 反转义html
 * @description EN: Convert HTML entities back into their corresponding characters.
 * @param { string } s 字符串
 * @returns
 */
declare function unescapeHtml(s: string): string;

//#endregion
//#region src/html/getStyles.d.ts
declare const stylesReg: RegExp;
/**
 *
 * @param { string } str 字符串模板
 * @param { Function } callback 读取style时的回调
 * @returns
 * @description EN: Extract inline style attributes from HTML-like strings and call `callback` with each style and the full matching block.
 */
declare function getStyles(str: string, callback: (style: string, block: string, index: number) => string): string;

//#endregion
//#region src/https/httpsRedirect.d.ts
/**
 * http重定向到https
 * @description EN: If the current page is loaded over HTTP, redirect to the HTTPS version of the same URL.
 */
declare function httpsRedirect(): void;

//#endregion
//#region src/is/isAbsolute.d.ts
/**
 * 判断是否是绝对路径
 * @description EN: Return true when the provided path looks like an absolute path. Matches Unix absolute paths, Windows drive letters, or leading slashes/backslashes.
 * @param {string} url Path or URL string to test.
 * @returns {boolean} True when the path appears absolute.
 */
declare function isAbsolute(url: string): boolean;

//#endregion
//#region src/is/isArray.d.ts
/**
 * 判断是否是数组
 * @description EN: Alias for Array.isArray.
 */
declare const isArray: (arg: any) => arg is any[];

//#endregion
//#region src/is/isBlob.d.ts
/**
 * 判断是否是blob
 * @description EN: Check whether a value is a Blob object.
 * @param o - candidate value
 * @returns boolean
 */
declare function isBlob(o: any): o is Blob;

//#endregion
//#region src/is/isBool.d.ts
/**
 * 判断是否是boolean类型
 * @description EN: Check whether a value is a boolean.
 * @param value - candidate value
 * @returns boolean
 */
declare function isBool(value: any): value is boolean;

//#endregion
//#region src/is/isBottom.d.ts
/**
 * Determine whether the document is scrolled to the bottom (within `distance`).
 * @description EN: Returns true when the document scroll position is at or near the bottom.
 * @param {number} [distance] Additional threshold in pixels.
 * @returns {boolean}
 */
declare function isBottom(distance?: number): boolean;

//#endregion
//#region src/is/isBrowser.d.ts
/**
 * 判断当前环境是否具有浏览器全局（window）
 * @description EN: True in environments where `globalThis.window` is defined (typical browsers).
 */
declare const isBrowser: boolean;

//#endregion
//#region src/is/isContainCn.d.ts
/**
 * 判断是否包含中文
 * @description EN: Returns true if the input string contains any CJK Unified Ideographs (Chinese characters).
 * @param s - input string
 * @returns boolean
 */
declare function isContainCn(s: string): boolean;

//#endregion
//#region src/is/isDate.d.ts
/**
 * 判断是否是日期格式
 * @description EN: Check whether a value is a Date instance.
 * @param d - candidate value
 * @returns boolean
 */
declare function isDate(d: any): d is Date;

//#endregion
//#region src/is/isDef.d.ts
/**
 * 判断元素不是undefined
 * @description EN: Determine whether a value is defined (not undefined).
 * @param v - candidate value
 * @returns boolean
 */
declare function isDef<T = any>(v: T): v is T extends undefined ? never : T;

//#endregion
//#region src/is/isElement.d.ts
/**
 * 判断元素是HTMLElement
 * @description EN: Check whether a value is an HTMLElement.
 * @param element - candidate value
 * @returns boolean
 */
declare function isElement(element: any): element is HTMLElement;

//#endregion
//#region src/is/isEqual.d.ts
/**
 * 深度比较两个值是否相等
 * @description EN: Deep equality check for plain objects and arrays.
 * @param {any} o1 First value.
 * @param {any} o2 Second value.
 * @returns {boolean} True when values are deeply equal.
 */
declare function isEqual(o1: any, o2: any): boolean;

//#endregion
//#region src/is/isEsModule.d.ts
/**
 * 判断对象是ESModule
 * @description EN: Detect if an object is an ES module (common __esModule or Symbol.toStringTag).
 * @param obj - candidate object
 * @returns boolean
 */
declare function isESModule(obj: any): obj is IsESModule;

//#endregion
//#region src/is/isFalse.d.ts
/**
 * 判断是否是false
 * @description EN: Check whether a value is the boolean false.
 * @param v - candidate value
 * @returns boolean
 */
declare function isFalse(v: any): v is false;

//#endregion
//#region src/is/isFileType.d.ts
/**
 * 判断文件类型
 * @description EN: Test if a filename/path has a given extension.
 * @param { string } file 文件路径
 * @param { string } appendix 文件类型
 * @returns boolean
 */
declare function isFileType(file: string, appendix: string): boolean;

//#endregion
//#region src/is/isFn.d.ts
/**
 * 判断是否是函数
 * @description EN: Check whether a value is a function.
 * @param o - candidate value
 * @returns boolean
 */
declare function isFn(o: any): o is Function;

//#endregion
//#region src/is/isIPv4.d.ts
/**
 * 判断是否为 IPv4 地址
 * @description EN: Test whether a string is a valid IPv4 address.
 * @param {string} ip Candidate IP string.
 * @returns {boolean}
 */
declare function isIPv4(ip: string): boolean;

//#endregion
//#region src/is/isIPv6.d.ts
/**
 * 判断是否为 IPv6 地址
 * @description EN: Test whether a string matches common IPv6 patterns.
 * @param {string} ip Candidate IP address.
 * @returns {boolean}
 */
declare function isIPv6(ip: string): boolean;

//#endregion
//#region src/is/isIdCard.d.ts
/**
 * 判断是否是身份证
 * @param s
 * @returns
 */
/**
 * 判断是否为身份证号（中国身份证格式的简单校验）
 * @description EN: Heuristic check for Chinese ID card numbers (15 or 18 digits with possible 'X').
 * @param {string} s Candidate ID string.
 * @returns {boolean}
 */
declare function isIdCard(s: string): boolean;

//#endregion
//#region src/is/isLeapYear.d.ts
/**
 * Determine whether a year is a leap year.
 *
 * @param {number} year Year number.
 * @returns {boolean}
 */
/**
 * 判断是否为闰年
 * @description EN: Returns true for leap years (divisible by 400 or divisible by 4 and not by 100).
 * @param {number} year Year number.
 * @returns {boolean}
 */
declare function isLeapYear(year: number): boolean;

//#endregion
//#region src/is/isMap.d.ts
/**
 * 判断是否是 Map
 * @description EN: Check whether a value is a Map instance.
 * @param {any} o Candidate value.
 * @returns {o is Map<any, any>} True if the internal [[Class]] is 'Map'.
 */
declare function isMap(o: any): o is Map<any, any>;

//#endregion
//#region src/is/isMobile.d.ts
/**
 * 判断是否是手机号
 * @description EN: Check whether a string looks like a mobile phone number (China-focused pattern).
 * @param s - phone number string
 * @returns boolean
 */
declare function isMobile(s: string): boolean;

//#endregion
//#region src/is/isNaN.d.ts
/**
 * 判断是否为 NaN
 * @description EN: Wraps Number.isNaN for a consistent helper.
 * @param o Candidate value.
 * @returns {boolean}
 */
declare function isNaN(o: any): boolean;

//#endregion
//#region src/is/isNil.d.ts
/**
 * 判断是否为 null 或 undefined
 * @description EN: Returns true when the value is strictly null or undefined.
 * @param {any} value Candidate value.
 * @returns {value is null | undefined}
 */
declare function isNil(value: any): value is null | undefined;

//#endregion
//#region src/is/isNull.d.ts
/**
 * 判断是否为 null
 * @description EN: Check if a value is strictly `null`.
 * @param {any} o Candidate value.
 * @returns {o is null} True when the value is exactly null.
 */
declare function isNull(o: any): o is null;

//#endregion
//#region src/is/isNum.d.ts
/**
 * 判断是否是number类型
 */
/**
 * 判断是否为数字
 * @description EN: Check whether a value has type 'number'.
 * @param {any} o Candidate value.
 * @returns {o is number}
 */
declare function isNum(o: any): o is number;

//#endregion
//#region src/is/isObject.d.ts
/**
 * 判断是否为对象类型
 * @description EN: Returns true for values with typeof 'object' (note: arrays/null are objects too).
 * @param {any} value Candidate value.
 * @returns {boolean}
 */
declare function isObject(value: any): boolean;

//#endregion
//#region src/is/isPlainObject.d.ts
/**
 * Check whether value is a plain object (i.e. {}).
 *
 * @param {any} o Candidate value.
 * @returns {o is Record<any, any>} True when `o` is a plain object.
 */
declare function isPlainObject(o: any): o is Record<any, any>;

//#endregion
//#region src/is/isPostCode.d.ts
/**
 * 判断是否是邮编
 */
/**
 * 判断是否为邮政编码
 * @description EN: Simplified check for a 6-digit postal code (China-style).
 * @param {string|number} s Candidate value.
 * @returns {boolean}
 */
declare function isPostCode(s: string | number): boolean;

//#endregion
//#region src/is/isPromise.d.ts
/**
 * 判断是否是promise
 */
/**
 * 判断是否为 Promise
 * @description EN: Check whether a value is a Promise instance.
 * @param {any} o Candidate value.
 * @returns {o is Promise<any>}
 */
declare function isPromise(o: any): o is Promise<any>;

//#endregion
//#region src/is/isReg.d.ts
/**
 * 判断是否是正则
 * @description EN: Check whether a value is a RegExp instance.
 * @param o Candidate value.
 * @returns {o is RegExp} True when the value is a regular expression.
 */
declare function isReg(o: any): o is RegExp;

//#endregion
//#region src/is/isRelative.d.ts
/**
 * 判断是否是相对路径
 */
/**
 * 判断路径是否为相对路径
 * @description EN: Returns true for strings starting with './' or '../'.
 * @param {string} str Path string.
 * @returns {boolean}
 */
declare function isRelative(str: string): boolean;

//#endregion
//#region src/is/isSameDay.d.ts
/**
 * 判断是否是同一天
 * @param { Date } dateLeft 日期一
 * @param { Date } dateRight 日期二
 */
/**
 * 判断两个日期是否为同一天
 * @description EN: Compares year, month and date to determine whether two Date
 * objects represent the same calendar day.
 * @param {Date} dateLeft First date.
 * @param {Date} dateRight Second date.
 * @returns {boolean}
 */
declare function isSameDay(dateLeft: Date, dateRight: Date): boolean;

//#endregion
//#region src/is/isSet.d.ts
/**
 * 判断是否为 Set
 * @description EN: Check whether a value is a Set instance.
 * @param {any} o Candidate value.
 * @returns {o is Set<any>} True when the internal [[Class]] is 'Set'.
 */
declare function isSet(o: any): o is Set<any>;

//#endregion
//#region src/is/isStr.d.ts
/**
 * 判断是否为字符串
 * @description EN: Check whether a value has type 'string'.
 * @param {any} o Candidate value.
 * @returns {o is string}
 */
declare function isStr(o: any): o is string;

//#endregion
//#region src/is/isSupportCamera.d.ts
/**
 * 判断当前环境是否支持摄像头采集（getUserMedia）
 * @description EN: Heuristic detection for getUserMedia support across legacy vendor prefixes.
 * @returns {boolean}
 */
declare function isSupportCamera(): boolean;

//#endregion
//#region src/is/isSupportWebp.d.ts
/**
 * 判断当前浏览器是否支持 WebP
 * @description EN: Returns true when the current browser can encode a WebP
 * data URL from a canvas (a common heuristic for WebP support).
 * @returns {boolean}
 */
declare function isSupportWebp(): boolean;

//#endregion
//#region src/is/isSymbol.d.ts
/**
 * 判断是否是symbol类型
 */
/**
 * 判断是否为 symbol
 * @description EN: Check whether a value has type 'symbol'.
 * @param {any} o Candidate value.
 * @returns {o is symbol}
 */
declare function isSymbol(o: any): o is symbol;

//#endregion
//#region src/is/isTrue.d.ts
/**
 * 判断是否是true
/**
 * \u5224\u65ad\u662f\u5426\u662ftrue
 * @description EN: Check whether a value is the boolean literal true.
 * @param v - candidate value
 * @returns v is true
 */
declare function isTrue(v: any): v is true;

//#endregion
//#region src/is/isType.d.ts
/**
 * 判断对象类型
 */
/**
 * 判断值是否匹配指定的类型标签
 * @description EN: Flexible type checker that accepts a shorthand type string
 * (like 'str', 'array', 'map') or multiple types separated by '|'. The
 * implementation delegates to specific `isX` helpers.
 * @param s Candidate value to test.
 * @param type Type label or pipe-separated labels.
 * @returns boolean True when any of the provided type labels match.
 */
declare function isType<T>(s: T, type: string): boolean;

//#endregion
//#region src/is/isUndef.d.ts
/**
 * 判断是否为 undefined
 * @description EN: Returns true when the value is exactly `undefined`.
 * @param o Candidate value.
 * @returns {o is undefined}
 */
declare function isUndef(o: any): o is undefined;

//#endregion
//#region src/is/isUrl.d.ts
/**
 * 判断是否是 URL
 * @description EN: Simple check whether a string looks like an HTTP/HTTPS URL.
 * @param {string} url The candidate URL string.
 * @returns {boolean} True if the string begins with "http://" or "https://".
 */
declare function isUrl(url: string): boolean;

//#endregion
//#region src/is/isVideo.d.ts
/**
 * 判断是否为视频文件（基于扩展名）
 * @description EN: Returns true when the filepath ends with a known video file extension.
 * @param {string} filepath Path or filename.
 * @returns {boolean}
 */
declare function isVideo(filepath: string): boolean;

//#endregion
//#region src/is/isWeakMap.d.ts
/**
 * 判断是否为 WeakMap
 * @description EN: Check whether a value is a WeakMap instance.
 * @param {any} o Candidate value.
 * @returns {o is WeakMap<any, any>}
 */
declare function isWeakMap(o: any): o is WeakMap<any, any>;

//#endregion
//#region src/is/isWeakSet.d.ts
/**
 * 判断是否为 WeakSet
 * @description EN: Check whether a value is a WeakSet instance.
 * @param {any} o Candidate value.
 * @returns {o is WeakSet<any>}
 */
declare function isWeakSet(o: any): o is WeakSet<any>;

//#endregion
//#region src/is/isWin.d.ts
/**
 * 判断是否为 Windows 平台
 * @description EN: Returns true when running on Windows (platform 'win32').
 * @returns {boolean}
 */
declare function isWin(): boolean;

//#endregion
//#region src/is/isSocketUrl.d.ts
/**
 * 判断是否为 WebSocket URL
 * @description EN: Returns true for URLs that start with ws:// or wss://.
 * @param {string} url URL string.
 * @returns {boolean}
 */
declare function isSocketUrl(url: string): boolean;

//#endregion
//#region src/is/isBase64.d.ts
/**
 * Check whether a string is a base64 data URL.
 *
 * @description EN: Validate whether a string is a data URL that contains base64-encoded content.
 * @param {string} base64 Candidate string.
 * @returns {boolean} True when the string looks like a base64 data URL.
 */
declare function isBase64(base64: string): boolean;

//#endregion
//#region src/is/isTrainNumber.d.ts
/**
 * 判断是否是火车号
 */
/**
 * 判断是否为火车车次（简单校验）
 * @description EN: Heuristic check for train numbers using common prefixes and 1-4 digits.
 * @param {string} s Candidate train number string.
 * @returns {boolean}
 */
declare const isTrainNumber: (s: string) => boolean;

//#endregion
//#region src/is/isNameCn.d.ts
/**
 * 判断是否为中文姓名（含·）
 * @description EN: Test whether a string is a Chinese personal name (2-16 CJK chars or middle dot).
 * @param {string} s Candidate name string.
 * @returns {boolean}
 */
declare const isNameCn: (s: string) => boolean;

//#endregion
//#region src/is/isNameEn.d.ts
/**
 * 判断输入是否为英文姓名样式
 * @description EN: Simple heuristic to test for English name-like strings (letters and spaces, 2-22 chars).
 * @param {string} s Candidate string.
 * @returns {boolean}
 */
declare function isNameEn(s: string): boolean;

//#endregion
//#region src/is/isSoldierId.d.ts
/**
 * 判断是否是军官证
 * @description EN: Heuristic check for a soldier/officer ID string. This function uses a simple regex and may not cover all real-world formats; it is intended as a lightweight validator rather than authoritative verification.
 * @param {string} s Candidate ID string.
 * @returns {boolean} True when the string matches the expected pattern.
 */
declare function isSoldierId(s: string): boolean;

//#endregion
//#region src/is/isVersion.d.ts
/**
 * 判断是否为版本号
 * @description EN: Check whether a version string consists of dot-separated numeric parts.
 * @param {string} version Version string, e.g. '1.2.3'.
 * @returns {boolean}
 */
declare function isVersion(version: string): boolean;

//#endregion
//#region src/is/isDivElement.d.ts
/**
 * 判断目标是否为 HTMLDivElement
 * @description EN: Narrow type guard to detect <div> elements.
 * @param {unknown} target Candidate value.
 * @returns {target is HTMLDivElement}
 */
declare function isDivElement(target: unknown): target is HTMLDivElement;

//#endregion
//#region src/is/isIFrameElement.d.ts
/**
 * 判断目标是否为 HTMLIFrameElement
 * @description EN: Narrow type guard for iframe elements.
 * @param {unknown} target Candidate value.
 * @returns {target is HTMLIFrameElement}
 */
declare function isIFrameElement(target: unknown): target is HTMLIFrameElement;

//#endregion
//#region src/is/isImageElement.d.ts
/**
 * 判断目标是否为 HTMLImageElement
 * @description EN: Narrow type check to determine whether the target is an <img> element.
 * @param {unknown} target Candidate value.
 * @returns {target is HTMLImageElement}
 */
declare function isImageElement(target: unknown): target is HTMLImageElement;

//#endregion
//#region src/is/isNode.d.ts
/**
 * 判断目标是否为 DOM Node
 * @description EN: Returns true when the target is a DOM Node or looks like one (has numeric nodeType).
 * @param {unknown} target Candidate value.
 * @returns {target is Node}
 */
declare function isNode(target: unknown): target is Node;

//#endregion
//#region src/is/isProxyDocument.d.ts
/**
 * 判断目标是否为 ProxyDocument（特定实现的代理文档对象）
 * @description EN: Type guard that tests for an object whose [[Class]] is 'ProxyDocument'.
 * @param {unknown} target Candidate value.
 * @returns {target is Document}
 */
declare function isProxyDocument(target: unknown): target is Document;

//#endregion
//#region src/is/isScriptElement.d.ts
/**
 * 判断目标是否为 HTMLScriptElement
 * @description EN: Narrow type guard for <script> elements.
 * @param {unknown} target Candidate value.
 * @returns {target is HTMLScriptElement}
 */
declare function isScriptElement(target: unknown): target is HTMLScriptElement;

//#endregion
//#region src/is/isShadowRoot.d.ts
/**
 * 判断目标是否为 ShadowRoot
 * @description EN: Type guard for ShadowRoot instances (if supported in environment).
 * @param {unknown} target Candidate value.
 * @returns {target is ShadowRoot}
 */
declare function isShadowRoot(target: unknown): target is ShadowRoot;

//#endregion
//#region src/is/isStyleElement.d.ts
/**
 * 判断目标是否为 HTMLStyleElement
 * @description EN: Narrow type guard for <style> elements.
 * @param {unknown} target Candidate value.
 * @returns {target is HTMLStyleElement}
 */
declare function isStyleElement(target: unknown): target is HTMLStyleElement;

//#endregion
//#region src/is/isVue.d.ts
/**
 * 判断文件是不是.vue
 * @param { string } src 文件路径
 * @returns
 */
/**
 * 判断文件路径是否是 Vue 单文件组件（.vue）
 * @description EN: Simple check for filenames ending with '.vue'.
 * @param {string} src Path or filename.
 * @returns {boolean}
 */
declare function isVue(src: string): boolean;

//#endregion
//#region src/is/isComment.d.ts
/**
 * 判断是否为 HTML 注释
 * @description EN: Test whether a string looks like an HTML comment (<!-- ... -->).
 * Matches across newlines as well.
 * @param {string} s Input string.
 * @returns {boolean}
 */
declare function isComment(s: string): boolean;

//#endregion
//#region src/is/isActive.d.ts
/**
 * 判断当前页面是否处于活跃状态
 * @returns
 */
/**
 * 判断当前页面是否处于活动（未被隐藏）状态
 * @description EN: Returns true when the document is currently visible/active
 * (i.e. `document.hidden` is falsy).
 * @returns {boolean}
 */
declare function isActive(): boolean;

//#endregion
//#region src/is/isFile.d.ts
/**
 * 判断是否是文件
 * @description EN: Check whether the input is a File (or file path on Node.js).
 * @param o - Blob, File or string path
 * @returns boolean
 */
declare function isFile(o: Blob | string): o is File;

//#endregion
//#region src/js/listenStack.d.ts
/**
 * 监听目标元素的子元素变化的栈
 * @description EN: Observe mutations (childList, subtree, attributes) on a target element and log a collapsed group trace when changes occur.
 * @param { string | Element } target 元素
 * @returns
 */
declare function listenStack(target: string | Element): (() => true | undefined) | undefined;

//#endregion
//#region src/js/copy.d.ts
/**
 * 获取电脑粘贴板的内容
 * @description EN: Copy the provided string to the system clipboard using a temporary textarea and execCommand.
 * @param { string } s 内容
 * @returns
 */
declare function copy(s: string): boolean;

//#endregion
//#region src/js/curry.d.ts
/**
 * 柯里化
 * @description EN: Create a curried version of the provided function.
 * @param { Function } f 函数
 * @returns 函数
 */
declare function curry(f: Function): (...args: any[]) => any;

//#endregion
//#region src/js/sleep.d.ts
/**
 * 等待函数
 * @param { number }  ms 延迟秒数
 * @returns
 * @description EN: Pause execution for `ms` milliseconds and resolve a Promise.
 */
declare function sleep(ms: number): Promise<unknown>;

//#endregion
//#region src/js/parallel.d.ts
/**
 * 并行执行
 * @param { any[] } tasks 数组
 * @param { (...args: any[]) => any } fn 函数
 * @returns
 * @description EN: Execute `fn` over `tasks` in parallel and return a Promise resolved with all results.
 */
declare function parallel(tasks: any[], fn: (...args: any[]) => any): Promise<any[]>;

//#endregion
//#region src/js/promiseFinally.d.ts
/**
 * Promise 最终处理
 * @description EN: Run `fn` (sync or async) and always call `finalFn`, mirroring JavaScript `try/finally` behaviour for returned values and errors.
 * @param { Function | Promise<any> } fn 可以是函数或已存在的 Promise
 * @param { Function } finalFn 最终一定会执行的回调
 * @returns { Promise<any> }
 */
declare function promiseFinally(fn: Promise<any> | Function, finalFn: Function): Promise<any>;

//#endregion
//#region src/js/timeout.d.ts
/**
 * 超时函数
 * @param { Function } fn 函数
 * @param { number } ms 时间
 * @param { string } msg 错误消息
 * @returns
 * @description EN: Run `fn` (which may be async) but reject with an Error(msg) if it doesn't finish within `ms` milliseconds.
 */
declare const timeout: (fn: Function, ms: number, msg: string) => Promise<any>;

//#endregion
//#region src/js/noop.d.ts
/**
 * 空函数
 * @description EN: A no-op helper that performs no action; useful as a default callback placeholder.
 */
declare function noop(): void;

//#endregion
//#region src/js/chainFns.d.ts
/**
 * 链式调用
 * @description EN: Compose multiple functions into one that calls them in sequence, returning the last non-undefined result.
 * @param { Function[] } fns 函数数组
 * @returns
 */
declare function chainFns(...fns: Function[]): Function;

//#endregion
//#region src/js/nextTick.d.ts
/**
 * 下一次执行任务
 * @description EN: Schedule a callback to run on the next microtask (via Promise). Falls back to MutationObserver or setTimeout when Promises are unavailable.
 * @param { () => any } flushCallbacks 待执行的回调函数
 */
declare function nextTick(flushCallbacks: () => any): void;

//#endregion
//#region src/js/singleModel.d.ts
/**
 * 单例模式
 * @description EN: Create a singleton proxy for a class so constructing it always returns the same instance.
 */
declare function singleModel(className: any): any;

//#endregion
//#region src/js/useWebWorker.d.ts
declare function useWebWorker(url: string | (() => void)): {
  emit: (msg: any) => void;
  on: (callback: (data: any) => void) => (data: any) => void;
  error: (err: (err: any) => void) => (err: any) => void;
  terminate: () => void;
};

//#endregion
//#region src/js/useServiceWorker.d.ts
/**
 * 注册 Service Worker
 * @description EN: Register a ServiceWorker from a script URL or an inline function that is transformed into a blob URL.
 * @param { string | (() => void) } url Service Worker 脚本地址，或一个将在 Worker 中执行的函数
 * @param { RegistrationOptions } options Service Worker 注册配置项
 * @returns { Promise<ServiceWorkerRegistration> }
 */
declare function useServiceWorker(url: string | (() => void), options: RegistrationOptions): Promise<ServiceWorkerRegistration>;

//#endregion
//#region src/js/noopFalse.d.ts
/**
 * 始终返回 false 的函数
 * @description EN: Returns a constant false value, handy for event handlers that must cancel default behaviour.
 */
declare const noopFalse: () => boolean;

//#endregion
//#region src/js/updateDetection.d.ts
/**
 * 用户停留在老页面但是已经有新的版本
 * @description EN: Detects if the served HTML has updated script sources and invokes a callback when an update is detected.
 */
/**
 * 检测首页中script src是否存在更新
 * @param { number } s 检测时间间隔 默认 2000
 * @param callback 如果页面检测出有更新则会被调用
 * @description EN: s is the check interval in ms (default 2000). callback is invoked when an update is detected.
 * @returns
 */
declare function updateDetection(s: number | undefined, callback: () => void): () => void;

//#endregion
//#region src/js/streamToUrl.d.ts
/**
 * 将流文件转为base64
 * @param { ArrayBuffer } stream 流
 * @returns
 * @description EN: Convert an ArrayBuffer (binary stream) into a data URL (base64) using a Blob and helper.
 */
declare function streamToUrl(stream: ArrayBuffer): Promise<string>;

//#endregion
//#region src/js/useReader.d.ts
/**
 * 读取 ReadableStream
 * @description EN: Read from a `ReadableStreamDefaultReader`, optionally process each chunk, and return the concatenated string.
 * @param { ReadableStreamDefaultReader<Uint8Array> } reader `stream.getReader()` 的返回值
 * @param { (value?: string) => any } [callback] 对每个文本块进行处理的回调
 * @returns { Promise<string> }
 */
declare function useReader(reader: ReadableStreamDefaultReader<Uint8Array>, callback?: (value?: any) => any): Promise<string>;

//#endregion
//#region src/js/useSwitch.d.ts
/**
 * 轮询返回数组中的值
 * @description EN: Cycle through the provided options on each call, returning to the first value after reaching the end.
 * @param { any[] } options 需要轮换返回的值列表
 * @returns { () => any }
 */
declare function useSwitch(options: any[]): () => any;

//#endregion
//#region src/js/catchAwait.d.ts
/**
 * 捕获 Promise 错误
 * @description EN: Await a promise and return a tuple `[error, result]`, optionally merging extra fields into the error object.
 * @param { Promise<T> } promise 需要处理的 Promise
 * @param { object } [errorExt] 发生错误时附加到错误对象的额外信息
 * @returns { Promise<[U | undefined, T | undefined]> }
 */
declare function catchAwait<T, U = Error>(promise: Promise<T> | any, errorExt?: object): Promise<[U, undefined] | [undefined, T]>;

//#endregion
//#region src/js/executeStr.d.ts
/**
 * 执行字符串表达式
 * @description EN: Evaluate the provided string as JavaScript expression and return its value. Use with caution.
 * @param { string } str 需要执行的表达式字符串
 * @returns { any }
 */
declare function executeStr(str: string): any;

//#endregion
//#region src/js/handleImageError.d.ts
/**
 * 图片加载失败时轮换备用图
 * @description EN: Return an error handler that swaps an image's `src` with fallback URLs each time a load failure occurs.
 * @param { string[] } errorImageSrc 备用图片地址列表
 * @returns { (event: Event) => void }
 */
declare function handleImageError(errorImageSrc: string[]): (event: Event) => void;

//#endregion
//#region src/js/replaceAsync.d.ts
/**
 * @description EN: Perform asynchronous replacements on matches in a string using a sync or async replacer.
 * @param {string} str The source string
 * @param {string|RegExp} searchValue Pattern to search for
 * @param {string|Function} replaceValue Replacement string or async replacer function
 */
declare function replaceAsync(str: string, searchValue: string | RegExp, replaceValue: string | ((...args: any[]) => string | Promise<string>)): Promise<string>;

//#endregion
//#region src/js/reduceAsync.d.ts
/**
 * 异步 reduce
 * @description EN: Perform an asynchronous reduction over an array, awaiting each reducer invocation before proceeding.
 * @param { K[] } arr 待处理的数组
 * @param { (acc: T, item: K, index: number, arr: K[]) => Promise<T> | T } reducer 异步或同步累加器
 * @param { T } initialValue 初始值
 * @returns { Promise<T> }
 */
declare function reduceAsync<T, K>(arr: K[], reducer: (acc: T, item: K, index: number, arr: K[]) => any, initialValue: T): Promise<T>;

//#endregion
//#region src/js/retryAsync.d.ts
/**
 * 异步重试
 * @description EN: Retry an asynchronous function up to `retries` times before rethrowing the last error.
 * @param { () => Promise<T> } fn 待执行的异步函数
 * @param { number } retries 最大重试次数
 * @returns { Promise<T> }
 */
declare function retryAsync<T>(fn: () => Promise<T>, retries: number): Promise<T>;

//#endregion
//#region src/log/debugWarn.d.ts
/**
 * 抛出具有作用域前缀的自定义错误
 * @description EN: Throw a namespaced `CustomerError` so invariant violations carry contextual scope information.
 * @param { string } scope 错误发生的作用域标识
 * @param { string } m 错误信息内容
 * @returns { never }
 */
declare function throwError(scope: string, m: string): never;
/**
 * 开发环境警告输出
 * @description EN: Emit a warning in non-production builds, accepting either an error instance or scope/message pair.
 * @param { Error | string } scope 错误对象或作用域标识
 * @param { string } [message] 当 scope 为字符串时对应的警告信息
 * @returns { void }
 */
declare function debugWarn(err: Error): void;
declare function debugWarn(scope: string, message: string): void;

//#endregion
//#region src/log/globalErrorCapture.d.ts
/**
 * 全局错误捕获
 * @description EN: Capture global window `error` events and log structured error information.
 * @returns { () => void } 注销监听器的清理函数
 */
declare function globalErrorCapture(): () => void;

//#endregion
//#region src/log/interceptError.d.ts
/**
 * 拦截并标准化函数错误
 * @description EN: Wrap a function so that thrown values and rejected Promises are normalized into standard `Error` instances.
 * @param { T } fn 需要包装的函数
 * @returns { T }
 */
declare function interceptError<T extends (...args: any[]) => any>(fn: T): T;

//#endregion
//#region src/log/log.d.ts
/**
 * 日志输出
 * @description EN: Print styled logs to console with optional level, CSS styles, and extra arguments.
 * @param { string | number } s 日志内容
 * @param {{ type?: 'warn' | 'error' | 'log'; style?: Record<string, string | number> | string; args?: any[] }} [options] 控制打印类型、样式与追加参数
 * @returns { void }
 */
declare function log(s: string | number, options?: {
  type?: 'warn' | 'error' | 'log';
  style?: Record<string, string | number> | string;
  args?: any[];
}): void;

//#endregion
//#region src/message/createEventBus.d.ts
/**
 * eventbus
 */
declare function createEventBus(): EventBus;

//#endregion
//#region src/message/useStorageListen.d.ts
/**
 *  跨标签页通信通过storage事件实现
 * @description EN: Listen to `storage` events for simple cross-tab messaging and provide a helper to send storage messages.
 * @param { (type: string, newValue: any, oldValue: any) => void } callback storage数据更新回调
 * @returns
 */
declare function useStorageListen(callback: (type: string, newValue: any, oldValue: any) => void): () => void;
declare function sendStorage(type: string, value: any): void;

//#endregion
//#region src/message/useSocket.d.ts
/**
 * WebSocket helper
 * @description EN: Small wrapper around the browser WebSocket that normalizes the URL and returns helper event attachers.
 * @param { string } url 要连接的 URL；这应该是 WebSocket 服务器将响应的 URL。
 * @param { string | string[] } [protocols] 一个协议字符串或者一个包含协议字符串的数组。
 * @returns An object with `socket`, `receive`, `send`, `open`, `close`, and `error` helpers.
 */
declare function useSocket(url: string, protocols?: string | string[]): {
  socket: WebSocket;
  receive: (callback: (event: MessageEvent<any>) => void) => void;
  send: (data: string | ArrayBufferLike | Blob | ArrayBufferView) => void;
  open: (callback: (event: Event) => void) => void;
  close: (callback: (event: Event) => void) => void;
  error: (callback: (event: Event) => void) => void;
};

//#endregion
//#region src/message/createChannel.d.ts
type Channel = BroadcastChannel & {
  listeners: Set<number>;
  id: number;
};
declare function createChannel(name: string): Channel;

//#endregion
//#region src/monitor/calFps.d.ts
/**
 * 计算并输出当前帧率
 * @description EN: Track frames with `requestAnimationFrame` and log the averaged FPS once per second.
 * @returns { () => void } 取消帧率监听的停止函数
 */
declare function calFps(): () => void;

//#endregion
//#region src/monitor/getDevice.d.ts
/**
 * 获取当前环境设备信息 os 手机设备 dev 浏览器环境
 * @description EN: Determine OS and device/browser identifiers from the
 * user agent string and return a DeviceType describing the environment.
 * @returns {DeviceType} 设备信息
 */
declare function getDevice(): DeviceType;

//#endregion
//#region src/monitor/monitorPef.d.ts
/**
 * 检测性能指标
 * @description EN: Collect navigation and timing metrics via the Performance API and return them as a record; fall back gracefully when unsupported.
 * @returns { Record<string, number> | null } 性能指标对象；若无法获取则返回 null
 */
declare function monitorPef(): Record<string, number> | null;

//#endregion
//#region src/monitor/timeCost.d.ts
/**
 * 检测函数执行耗时
 * @description EN: Measure and log the execution time (seconds) of the provided synchronous function.
 * @param { Function } fn 需要测量的函数
 * @returns { number } 函数执行耗时（秒）
 */
declare function timeCost(fn: Function): number;

//#endregion
//#region src/monitor/getLocation.d.ts
/**
 * 获取当前地理坐标
 * @description EN: Resolve the current geolocation coordinates with optional high-accuracy, timeout, and cache controls.
 * @param { boolean } [enableHighAccuracy] 是否启用高精度模式
 * @param { number } [timeout] 允许的最大定位耗时（毫秒）
 * @param { number } [maximumAge] 允许的最大缓存位置时间（毫秒）
 * @returns { Promise<GeolocationCoordinates> }
 */
declare function getLocation(enableHighAccuracy?: boolean, timeout?: number, maximumAge?: number): Promise<GeolocationCoordinates>;

//#endregion
//#region src/num/calNum.d.ts
/**
 * add 数字求和
 * sub 数字求差
 * mul 数字相乘
 * div 数字相除
 * @description EN: Helper for basic arithmetic operations that mitigates
 * floating-point rounding errors by scaling operands. Provides add, sub,
 * mul and div methods accepting numbers or numeric strings.
 */
declare const calNum: {
  add(...args: (number | string)[]): number;
  sub(...args: (number | string)[]): number;
  mul(...args: (number | string)[]): number;
  div(...args: (number | string)[]): number;
};

//#endregion
//#region src/num/formateNum.d.ts
/**
 * 数字格式化
 * @param { number } number 数字
 * @param { number } decimals 小数位
 * @param { 'floor' | 'ceil' } integer 向上截取 ｜ 向下截取 默认 'ceil'
 * @returns
 * @description EN: Format a number with thousands separators and a fixed number of decimal places. Supports rounding via 'floor' or 'ceil'.
 */
declare function formateNum(number: number | string, decimals?: number, integer?: 'floor' | 'ceil'): string;

//#endregion
//#region src/num/uppercaseNum.d.ts
/**
 * 大写数字
 * @param { number } n 数字
 * @returns 返回大写数字
 * @description EN: Convert a number to Chinese uppercase currency representation (e.g., 壹贰叁元...).
 */
declare function uppercaseNum(n: number): string;

//#endregion
//#region src/num/multiply.d.ts
/**
 * 乘倍
 * @param { number | string } i
 * @param { number } multiple 倍数
 * @returns
 * @description EN: Multiply numeric inputs or repeat strings `multiple` times. If `i` is numeric, returns numeric product; otherwise repeats string.
 */
declare function multiply(i: number | string, multiple: number): string | number;

//#endregion
//#region src/num/isEven.d.ts
/**
 * 判断偶数
 * @param { number } n 数字
 * @returns
 * @description EN: Return true if `n` is an even integer (coerced to number).
 */
declare function isEven(n: number | string): boolean;

//#endregion
//#region src/object/deepMerge.d.ts
/**
 * 深合并
 * @param target 对象
 * @param sources 其他对象
 * @returns
 * @description EN: Recursively merge source plain objects into the target object.
 */
declare function deepMerge(target: Record<any, any>, ...sources: Record<any, any>[]): Record<any, any>;

//#endregion
//#region src/object/generateKeyObject.d.ts
declare function generateKeyObject(o: Record<string, any>, key: string, mapKey: string): {};

//#endregion
//#region src/object/mapTransform.d.ts
declare function mapTransform(o: Record<string, any>, map: Record<string, string>, keepRest?: boolean): Record<string, any>;
declare function mapTransformBack(o: Record<string, any>, map: Record<string, string>, keepRest?: boolean): {};

//#endregion
//#region src/object/stringify.d.ts
interface StringifyOptions {
  sep?: string;
  eq?: string;
  hyp?: boolean;
  px?: boolean;
  encode?: boolean;
}
/**
 * Serialize a plain object to a query-string-like representation.
 *
 * Options allow customizing separators, equality sign, whether to hyphenate
 * keys, append `px` to numeric values, and URL-encode values.
 *
 * @param {Record<string,string|number>} o Input object.
 * @param {StringifyOptions} [options] Formatting options.
 * @returns {string} Serialized string.
 * @description EN: Convert a plain object to a delimited key-value string with optional formatting (used for style strings, query strings, etc.).
 */
declare function stringify(o: Record<string, string | number>, options?: StringifyOptions): string;

//#endregion
//#region src/object/transformKey.d.ts
declare function transformKey(target: Record<string, any> | Record<string, any>[], options: Record<string, string>, deleteEmpty?: boolean): Record<string, any> | Record<string, any>[];

//#endregion
//#region src/object/traverse.d.ts
/**
 * 通过函数的方式获取对象中指定的数据
 * @param { Record<any, any> | any[] } target 对象或数组
 * @param { Record<string, Function> } options {}
 * @returns
 * @description EN: Walk a target object or array and invoke callback functions for specified paths, passing (value, index, target).
 */
declare function traverse<T extends Record<any, any> | any[]>(target: T, options?: Record<string, (res: any, i: number, target: T) => void>): T;

//#endregion
//#region src/object/deepClone.d.ts
/**
 * Deep clone a value.
 *
 * Performs a deep clone for plain objects and arrays. Built-in collection
 * types (Set, Map, WeakMap, WeakSet, RegExp, Date) are cloned via their
 * constructors. Functions and `null` are returned as-is. A per-call WeakMap
 * is used to handle circular references and to preserve object identity
 * within the cloned structure.
 *
 * @param {any} target Value to deep clone.
 * @returns {any} Deep-cloned value.
 */
declare function deepClone(target: any): any;

//#endregion
//#region src/object/deepCompare.d.ts
/**
 * 深比较
 * @param { any } comp1 对象1
 * @param { any } comp2 对象2
 * @param { string[] | RegExp } ignoreKeys 忽律某项属性的比较
 * @returns
 * @description EN: Deep-compare two values (objects/arrays/primitives), optionally ignoring keys. Returns errors and messages describing differences.
 */
declare function deepCompare(comp1: any, comp2: any, ignoreKeys?: string[] | RegExp, error?: string[], errorMsg?: string[], name?: string, index?: string): {
  error: string[];
  errorMsg: string[];
};

//#endregion
//#region src/object/objectToMap.d.ts
/**
 * Convert an object to a Map. Keys that look like JSON objects ("{...}") are
 * parsed back to objects using JSON.parse.
 *
 * @param {Record<string, any>} obj Input object.
 * @returns {Map<any, any>} Map representation.
 */
declare function objectToMap(obj: Record<string, any>): Map<any, any>;

//#endregion
//#region src/object/mapToObject.d.ts
/**
 * Convert a Map to a plain object. Non-string keys are JSON.stringified.
 *
 * @param {Map<any, any>} map Input Map.
 * @returns {Record<string, any>} Plain object representation.
 */
declare function mapToObject(map: Map<any, any>): Record<string, any>;

//#endregion
//#region src/parse/parse.d.ts
interface ParseOptions {
  sep?: string;
  eq?: string;
  camel?: boolean;
}
/**
 *
 * @param { string } str 字符串
 * @param { ParseOptions } options {
  sep?: string
  eq?: string
  camel?: boolean
}
 * @param { string } options.seq 默认 &
 * @param { string } options.eq 默认 =
 * @param { string } options.camel 默认 false
 * @returns
 * @description EN: Parse a delimited key=value string (like a query string) into an object, with optional camelCase conversion.
 */
declare function parse(str: string, options?: ParseOptions): Record<string, string>;

//#endregion
//#region src/parse/parseCss.d.ts
/**
 * 解析css转换为对象
 * @param { string } str
 * @returns
 * @description EN: Parse a block of CSS and return a mapping from selector to declaration string.
 */
declare function parseCss(str: string): Record<string, string>;

//#endregion
//#region src/parse/parseUrl.d.ts
declare function hasProtocol(inputStr: string, acceptProtocolRelative?: boolean): boolean;
/**
 * 解析URL
 * @param { string } input 链接
 * @param defaultProto
 * @returns
 * @description EN: Parse a URL string into its components (protocol, host, pathname, search, hash), with optional default protocol.
 */
declare function parseURL(input?: string, defaultProto?: string): ParsedURL;
declare function parsePath(input?: string): ParsedURL;

//#endregion
//#region src/perf/debounce.d.ts
/**
 * 防抖函数
 * @param { Function } fn 函数
 * @param { number } time 时间（毫秒）
 * @returns { Function } 返回被防抖包装的函数
 * @description EN: Return a debounced version of `fn` that delays invocation until `time` milliseconds have passed without a new call.
 */
declare function debounce(fn: Function, time: number): (this: any, e?: any) => void;

//#endregion
//#region src/perf/fileSplice.d.ts
/**
 *
 * @param { File } _file 文件
 * @param { number } _chunkSize 切分大小 默认 1024 * 100
 * @returns
 * @description EN: Split a large `File` into chunks for parallel processing using web workers and return chunk details.
 */
declare function fileSplice(options: FileSpliceOptions): Promise<ChunkDetail[]>;

//#endregion
//#region src/perf/getLru.d.ts
/**
 *
 * @param max 最大存储量 默认 50
 * @returns
 * @description EN: Create and return a small LRU cache object with `get`, `set`, `cache`, `max` and `size()`.
 */
declare function getLru(max?: number): LRU;

//#endregion
//#region src/perf/lazyLoad.d.ts
/**
 * 在容器元素中为图片/视频添加懒加载（IntersectionObserver）支持。
 * @param { MaybeElement } element 容器元素或选择器
 * @param { string } loadingUrl 占位 loading 图片 URL（当元素无 data-src 时使用）
 * @returns { Function } 停止懒加载的函数
 * @description EN: Observe images/videos inside the provided container and load their `data-src` when they enter the viewport. Returns a stop function to cancel observation.
 */
declare function lazyLoad(element: MaybeElement, loadingUrl?: string): void;

//#endregion
//#region src/perf/memorizeFn.d.ts
/**
 * 函数缓存结果
 * @param { Function } fn 函数
 * @param { Map<string, any> } cache 缓存对象
 * @param { number } maxSize 最大缓存条目数，默认为100
 * @returns { Function } 带缓存的函数
 * @description EN: Return a memoized version of `fn` that caches results by JSON-stringified arguments up to maxSize.
 */
declare function memorizeFn(fn: Function, cache?: Map<string, any>, maxSize?: number): (...args: any[]) => any;

//#endregion
//#region src/perf/preload.d.ts
/**
 * 图片视频预加载函数
 * @param { string[] } list 图片数组
 * @param { string } style 设置样式
 * @returns { HTMLImageElement[] } 图片数组
 */
declare function preload(list: string[] | string, style?: string): HTMLImageElement[];

//#endregion
//#region src/perf/prefetch.d.ts
/**
 * 借助浏览器空闲时间去加载一些图片资源
 * @param { string[] } list 图片或视频地址数组
 * @param { number } timeRemaining 浏览器空闲时间大于多少去加载
 * @returns { Function } 停止加载的函数
 * @description EN: Preload images or videos using requestIdleCallback (via `useRic`) to avoid blocking main work.
 */
declare function prefetch(list: string[], timeRemaining?: number): () => void;

//#endregion
//#region src/perf/throttle.d.ts
/**
 * 截流函数
 * @param { Function } fn 要执行的函数
 * @param { number } stop 限流时间窗口（毫秒）
 * @returns { Function } 返回被节流包装后的函数
 * @description EN: Create a throttled version of `fn` that ensures `fn` runs at most once every `stop` milliseconds.
 */
declare function throttle(fn: Function, stop: number): (this: any, ...args: any[]) => any;

//#endregion
//#region src/perf/useRaf.d.ts
/**
 * 使用 requestAnimationFrame 执行一个函数，并提供停止执行的功能。
 * @description EN: Run a callback using requestAnimationFrame with optional throttling (via `delta`) and an option to auto-stop after one invocation.
 *
 * @param {function(number): void} fn - Callback invoked each animation frame with the timestamp.
 * @param {object} [options] - Configuration.
 * @param {number} [options.delta] - Minimum time (ms) between invocations.
 * @param {boolean} [options.autoStop] - If true, stop after the first invocation.
 * @param {boolean} [options.immediate] - If true, invoke immediately on first frame.
 * @returns {function(): void} Stop function that cancels the scheduled frames.
 */
declare function useRaf(fn: (timestamp: number) => void, options?: {
  delta?: number;
  autoStop?: boolean;
  immediate?: boolean;
}): () => void;

//#endregion
//#region src/perf/useRic.d.ts
interface Options$1 {
  timeRemaining?: number;
  timeout?: number;
  callback?: (taskArr: any[]) => void;
}
/**
 * 浏览器空闲时期被调用
 * @param { Function[] } tasks 函数队列
 * @param {object} [options] 选项对象，可提供 timeRemaining/timeout/callback
 * @returns { Function } 停止调度的函数
 * @description EN: Schedule tasks during browser idle periods using requestIdleCallback (with a fallback). Executes queued tasks when the browser has available idle time and returns a stop function to cancel remaining tasks.
 */
declare function useRic(tasks: Function[], options?: Options$1): () => void;

//#endregion
//#region src/perf/once.d.ts
/**
 * 只执行一次函数
 * @param { Function } fn 函数
 * @returns { Function } 函数
 * @description EN: Wrap `fn` so it only runs once; subsequent calls are ignored.
 */
declare function once(fn: Function): Function;

//#endregion
//#region src/perf/createChunk.d.ts
/**
 * 创建并计算文件分片的哈希信息
 * @param { File } file 要分片的文件
 * @param { number } index 分片索引
 * @param { number } chunkSize 分片大小
 * @returns { Promise<ChunkInfo> } 分片信息（start/end/index/hash）
 * @description EN: Create a file chunk and compute its MD5 hash using ArrayBuffer; returns chunk metadata.
 */
declare function createChunk(file: File, index: number, chunkSize: number): Promise<ChunkInfo>;

//#endregion
//#region src/perf/createHybridMap.d.ts
type Primitive$1 = string | number | symbol | boolean | null | undefined;
type KeyType$1 = object | Primitive$1;
/**
 * HybridMap 是一个支持对象和原始类型（如字符串、数字、布尔值等）作为 key 的 Map 实现。
 * @description EN: A Map-like collection that stores object keys in a WeakMap and primitive keys in a Map.
 * - 对象类型的 key 使用 WeakMap 存储，原始类型的 key 使用 Map 存储。
 * - 这样既可以用对象做 key，也可以用字符串、数字等做 key，且对象 key 不会阻止垃圾回收。
 * - 不支持遍历和 size 属性，因为 WeakMap 无法遍历。
 *
 * 示例用法：
 * ```ts
 * const map = createHybridMap<any, string>([[{}, 'obj'], ['a', 'str']])
 * map.set(123, 'num')
 * map.set({}, 'another obj')
 * ```
 */
declare class HybridMap<K extends KeyType$1, V> {
  private objectStore;
  private primitiveStore;
  /**
   * 构造函数，可选初始化 entries
   * @param entries 初始键值对数组
   */
  constructor(entries?: readonly (readonly [K, V])[] | null);
  /** 判断 key 是否为 object 类型 */
  private isObjectKey;
  /**
   * 设置键值对
   * @param key 键
   * @param value 值
   */
  set(key: K, value: V): this;
  /**
   * 获取指定 key 的值
   * @param key 键
   */
  get(key: K): V | undefined;
  /**
   * 判断是否存在指定 key
   * @param key 键
   */
  has(key: K): boolean;
  /**
   * 删除指定 key
   * @param key 键
   */
  delete(key: K): boolean;
  /** 清空所有 key */
  clear(): void;
  /** 不支持 size 属性，因 WeakMap 无法遍历 */
  get size(): number;
  /** 不支持 forEach，因 WeakMap 无法遍历 */
  forEach(): void;
  /** 不支持 keys 迭代，因 WeakMap 无法遍历 */
  keys(): void;
  /** 不支持 values 迭代，因 WeakMap 无法遍历 */
  values(): void;
  /** 不支持 entries 迭代，因 WeakMap 无法遍历 */
  entries(): void;
  /** 不支持迭代器，因 WeakMap 无法遍历 */
  [Symbol.iterator](): void;
}
/**
 * createHybridMap 是 HybridMap 的工厂函数。
 * 用于创建支持对象和原始类型作为 key 的 Map 实例。
 * @param entries 可选的初始键值对数组
 * @returns HybridMap 实例
 *
 * 示例用法：
 * ```ts
 * const map = createHybridMap<any, string>([[{}, 'obj'], ['a', 'str']])
 * map.set(123, 'num')
 * map.set({}, 'another obj')
 * ```
 */
declare function createHybridMap<K extends KeyType$1, V>(entries?: readonly (readonly [K, V])[] | null): HybridMap<K, V>;

//#endregion
//#region src/perf/createHybridSet.d.ts
type Primitive = string | number | symbol | boolean | null | undefined;
type KeyType = object | Primitive;
/**
 * HybridSet 是一个支持对象和原始类型（如字符串、数字、布尔值等）作为元素的 Set 实现。
 * @description EN: A Set-like collection that stores object keys in a WeakSet and primitive values in a Set.
 * - 对象类型的元素使用 WeakSet 存储，原始类型的元素使用 Set 存储。
 * - 这样既可以用对象做元素，也可以用字符串、数字等做元素，且对象元素不会阻止垃圾回收。
 * - 不支持遍历和 size 属性，因为 WeakSet 无法遍历。
 *
 * 示例用法：
 * ```ts
 * const set = createHybridSet<any>([{}, 'a', 123])
 * set.add('b')
 * set.add({})
 * ```
 */
declare class HybridSet<T extends KeyType> {
  private objectStore;
  private primitiveStore;
  /**
   * 构造函数，可选初始化 values
   * @param values 初始元素数组
   */
  constructor(values?: readonly T[] | null);
  /** 判断元素是否为 object 类型 */
  private isObjectKey;
  /**
   * 添加元素
   * @param value 元素
   */
  add(value: T): this;
  /**
   * 判断是否存在指定元素
   * @param value 元素
   */
  has(value: T): boolean;
  /**
   * 删除指定元素
   * @param value 元素
   */
  delete(value: T): boolean;
  /** 清空所有元素 */
  clear(): void;
}
/**
 * createHybridSet 是 HybridSet 的工厂函数。
 * 用于创建支持对象和原始类型作为元素的 Set 实例。
 * @param values 可选的初始元素数组
 * @returns HybridSet 实例
 *
 * 示例用法：
 * ```ts
 * const set = createHybridSet<any>([{}, 'a', 123])
 * set.add('b')
 * set.add({})
 * ```
 */
declare function createHybridSet<T extends KeyType>(values?: readonly T[] | null): HybridSet<T>;

//#endregion
//#region src/qrcode/generateQRCode.d.ts
type Options<T, K> = T extends HTMLCanvasElement ? {
  errorCorrectionLevel: 'H';
} : K extends true ? {
  errorCorrectionLevel?: 'H';
  type?: 'image/png' | 'image/jpeg' | 'image/webp';
  quality?: number;
  margin?: number;
  color?: {
    dark: string;
    light: string;
  };
} : {
  type?: 'terminal' | 'utf8' | 'svg';
};
/**
 * 生成二维码
 * @param { string | HTMLCanvasElement } content 元素
 * @param { boolean } base64 生成base64格式
 * @param options
 * @returns
 * @description EN: Generate a QR code for content. If `content` is a canvas element it renders to it; if `base64` is true, returns a data URL; otherwise returns a string/terminal/svg depending on options.
 */
declare function generateQRCode<T extends string | HTMLCanvasElement, K extends boolean>(content: T, base64?: K, options?: Options<T, K>): Promise<unknown>;

//#endregion
//#region src/random/randomDate.d.ts
/**
 * 随机日期函数
 * @param { string } start 开始日期 默认 '1999/01/1
 * @param { string } [end] 截止日期
 * @returns
 * @description EN: Return a random Date between `start` and `end` (dates as strings). Defaults to 1999/01/1 -> today.
 */
declare function randomDate(start?: string, end?: string): Date;

//#endregion
//#region src/random/randomHexColor.d.ts
/**
 * 随机hex颜色
 * @returns
 * @description EN: Generate a random 6-digit hex color string like `#a1b2c3`.
 */
declare function randomHexColor(): string;

//#endregion
//#region src/random/randomRange.d.ts
/**
 * 获取随机范围值
 * @param min 最小值 默认 MIN_SAFE_INTEGER
 * @param max 最大值 默认 MAX_VALUE
 * @returns
 * @description EN: Return a random integer between min and max inclusive.
 */
declare function randomRange(min?: number, max?: number): number;

//#endregion
//#region src/random/randomRgba.d.ts
/**
 * 随机rgba颜色
 * @param { number } [opacity] 透明度 默认 1
 * @returns
 * @description EN: Generate a random `rgba(r,g,b,a)` color string with optional opacity.
 */
declare function randomRgba(opacity?: number): string;

//#endregion
//#region src/random/randomArray.d.ts
/**
 * 随机打乱数组
 * @description EN: Shuffle an array in-place using the Fisher–Yates algorithm.
 * @param array any[]
 * @returns array
 */
declare function randomArray(array: any[]): any[];

//#endregion
//#region src/random/uuid.d.ts
/**
 * Generate a UUID-like string.
 *
 * If `len` is provided a random string of that length is returned using the
 * provided radix. Otherwise a RFC-like UUID of 36 chars is returned.
 *
 * @param {number} [len] Length of id to generate.
 * @param {number|'hex'} [radix] Radix to use for character selection or 'hex'.
 * @returns {string} Generated id string.
 */
declare function uuid(len?: number, radix?: number | 'hex'): string;

//#endregion
//#region src/request/VFetch.d.ts
/**
 * Class fetch请求封装
 * @description EN: Fetch request wrapper class
 */
declare class VFetch {
  config: IFetchConfig;
  constructor(baseOptions?: IFetchOptions);
  init(this: VFetch, options: IFetchConfig): Promise<any>;
  request(this: VFetch): Promise<any>;
  getResponseData(response: Response, responseType?: ResponseType): Promise<any> | undefined;
  get(this: VFetch, url: string, options?: IFetchConfig): Promise<any>;
  get(this: VFetch, options: IFetchConfig): Promise<any>;
  post(this: VFetch, url: string, options?: IFetchConfig): Promise<any>;
  post(this: VFetch, options: IFetchConfig): Promise<any>;
  put(this: VFetch, url: string, options?: IFetchConfig): Promise<any>;
  put(this: VFetch, options: IFetchConfig): Promise<any>;
  delete(this: VFetch, url: string, options?: IFetchConfig): Promise<any>;
  delete(this: VFetch, options: IFetchConfig): Promise<any>;
}

//#endregion
//#region src/request/asyncPool.d.ts
/**
 * 并行执行任务
 * @description EN: Execute tasks in parallel with a concurrency limit
 * @param { number } limit 并行数量 默认 4
 * @param { Function[] } tasks 任务队列
 * @returns
 */
declare function asyncPool(limit: number | undefined, tasks: Function[]): Promise<any[]>;

//#endregion
//#region src/request/sendBeacon.d.ts
/**
 * 将分析数据发送到 Web 服务
 * @description EN: Convenience wrapper around navigator.sendBeacon triggered on document visibility change (page hide).
 * @param { string } url 接收数据的 URL
 * @param { BodyInit } [analyticsData] ArrayBuffer 、 TypedArray 、 DataView 、 Blob 、字符串文字或对象、包含要发送的数据的 FormData 或 URLSearchParams 对象。
 * @returns a function to remove the event listener (provided by useEventListener)
 */
declare function sendBeacon(url: string | URL, analyticsData?: BodyInit | null): () => void;

//#endregion
//#region src/screen/exitFullscreen.d.ts
/**
 * 退出全屏模式
 * @returns
 * @description EN: Exit fullscreen mode by attempting common vendor-prefixed cancel methods; returns an Error when unsupported.
 */
declare function exitFullscreen(): Error | undefined;

//#endregion
//#region src/screen/fullScreen.d.ts
/**
 * 全屏模式
 * @returns
 * @description EN: Request the browser to enter fullscreen using common vendor-prefixed APIs; returns an Error if not supported.
 */
declare function fullScreen(): Error | undefined;

//#endregion
//#region src/screen/picInPic.d.ts
/**
 * 画中画模式
 * @param {  HTMLVideoElement | string } video video元素
 * @returns
 * @description EN: Toggle picture-in-picture for a given video element (or selector) and return an async function to perform the toggle.
 */
declare function picInPic(video: HTMLVideoElement | string): () => Promise<void>;

//#endregion
//#region src/screen/shareScreen.d.ts
/**
 * 分享屏幕
 * @param { MaybeElement } container 容器
 * @param { Function } callback 停止回调
 * @returns
 * @description EN: Capture and display the user's screen media in the provided container and call callback when sharing stops.
 */
declare function shareScreen(container: MaybeElement, callback: (msg: string) => void): Promise<unknown>;

//#endregion
//#region src/screen/useCamera.d.ts
interface IVideo {
  width: number;
  height: number;
}
/**
 * 录像功能
 * @param video 容器大小 默认{ width: 640, height: 480 }
 * @param container 容器
 * @param autoplay 是否自动播放
 * @returns
 */
declare function useCamera(video?: IVideo | boolean, container?: string | HTMLVideoElement, autoplay?: boolean): void | (() => true | void | Promise<void>);

//#endregion
//#region src/screen/useShare.d.ts
/**
 * 分享内容
 * @param options    files?: File[];
    text?: string;
    title?: string;
    url?: string;
 * @returns
 */
declare function useShare(options?: ShareData): Promise<void> | undefined;

//#endregion
//#region src/screen/useVideo.d.ts
interface Sources {
  src: string;
  type: string;
}
interface VideoOptions {
  container: HTMLElement | string;
  controls?: boolean;
  width?: number;
  height?: number;
  className?: string;
  style?: string;
}
/**
 * 操作video
 * @param sources {
  src: string
  type: string
}
 * @param videoOptions {
  container: HTMLElement | string
  controls?: boolean
  width?: number
  height?: number
  className?: string
  style?: string
}
 * @returns
 */
declare function useVideo(sources: Sources[] | undefined, videoOptions: VideoOptions): {
  play(): void;
  playReset: () => void;
  playRate(rate?: number): void;
  playTime(timing?: number): void;
  playProgress(currentTime?: number): void;
};

//#endregion
//#region src/screen/useRecorder.d.ts
/**
 * 录制功能
 * @description EN: Helper that captures the current display and microphone audio, records a combined MediaStream to a WebM file and triggers a download.
 * @param fileName - 输出文件名（不包含扩展名），默认使用当前时间戳
 * @returns A stop function which, when called, stops the recording and triggers the download.
 */
declare function useRecorder(fileName?: string): Promise<() => void>;

//#endregion
//#region src/screen/useVideoSubtitle.d.ts
interface UseVideoSubtitle {
  start: number;
  duration?: number;
  end?: number;
  left: number;
  top: number;
  content: string;
}
/**
 * 生成弹幕内容
 * @param options
 * @param name
 */
declare function useVideoSubtitle(options: UseVideoSubtitle[], name?: string): string;

//#endregion
//#region src/screen/useAudio.d.ts
/**
 * 录音功能
 * @param { string | HTMLAudioElement } container 容器
 * @returns
 * @description EN: Provide simple audio recording utilities that attach to an audio element and allow toggling and downloading of recorded audio.
 */
declare function useAudio(container: string | HTMLAudioElement): void | {
  toggle(): true | void;
  download(): void;
};

//#endregion
//#region src/screen/useFrequency.d.ts
interface FrequencyOptions {
  audio: MaybeElement;
  fftSize?: number;
}
/**
 * 处理audio获取频域数组
 * @param { FrequencyOptions } options { audio: 目标元素, fftSize: 分析细粒度 2^n 默认 512 }
 * @param { ( dataArray: Uint8Array, audioCtx: AudioContext, analyser: AnalyserNode ) => void } callback 回调
 */
declare function useFrequency(options: FrequencyOptions, callback: (dataArray: Uint8Array, audioCtx: AudioContext, analyser: AnalyserNode) => void): void;

//#endregion
//#region src/screen/getVideoFrame.d.ts
/**
 * 从视频文件中获取指定时间帧的图片
 * @param file 视频类型的File对象
 * @param time 需要截取帧的时间（单位：秒）
 * @returns Promise<{ url: string; blob: Blob }>
 * @description EN: Extract a frame image from a video File at the given time (seconds) and return a blob URL and Blob.
 */
declare function getVideoFrame(file: File, time?: number): Promise<{
  url: string;
  blob: Blob;
}>;

//#endregion
//#region src/script/addLink.d.ts
/**
 * Add a <link rel="stylesheet"> tag to document head and return a remover.
 *
 * @param {string} href Stylesheet URL.
 * @returns {() => void} Function that removes the link element.
 */
declare function addLink(href: string): () => void;

//#endregion
//#region src/script/addScript.d.ts
/**
 * Add a <script> tag to the document head and return a remover function.
 *
 * @param {string} src Script URL to add to the page.
 * @returns {() => void} Function that removes the inserted script.
 */
declare function addScript(src: string): () => void;

//#endregion
//#region src/script/addStyle.d.ts
/**
 * Inject CSS into the document head.
 *
 * `s` may be a CSS string or an object of rules. If `scoped` is provided the
 * style will be transformed to a scoped variant via `addStyleScoped`.
 *
 * @param {string|StyleObject} s CSS string or style object.
 * @param {string} [scoped] Optional scope id to scope the styles.
 * @returns {() => void} Function to remove the injected style.
 */
type StyleObject = Record<string, Record<string, string | number>>;
declare function addStyle(s: string | StyleObject, scoped?: string): () => HTMLElement | null;

//#endregion
//#region src/script/addStyleScoped.d.ts
declare function addStyleScoped(s: string, scoped: string): string;

//#endregion
//#region src/scroll/getScrollPosition.d.ts
/**
 * 获取滚动条位置
 * @param el 默认window
 * @returns Position
 * @description EN: Return the current scroll position {x,y} for the given window-like object.
 */
declare function getScrollPosition(el?: Window): Position;

//#endregion
//#region src/scroll/scrollToTop.d.ts
/**
 * 滚动到顶部
 * @description EN: Smoothly scroll the document to the top using a requestAnimationFrame loop.
 */
declare function scrollToTop(): void;

//#endregion
//#region src/scroll/scrollToView.d.ts
/**
 * 滚动到可视区域
 * @param {  Element | string | null } e 元素
 * @param { ScrollIntoViewOptions } options {
 *   block?: ScrollLogicalPosition;
 *   inline?: ScrollLogicalPosition;
 * }
 * @returns void
 * @description EN: Smoothly scroll the given element or selector into view with optional options.
 */
declare function scrollToView(e: Element | string | null, options?: ScrollIntoViewOptions): void;

//#endregion
//#region src/scroll/getScrollProgress.d.ts
declare function getScrollProgress(callback: (percent: string) => void, time?: number): () => void;

//#endregion
//#region src/speak/speech.d.ts
/**
 * Speech options for text-to-speech
 * @description EN: Configuration for the speech utterance (text, voice, rate, pitch, volume, lang).
 */
interface SpeechOptions {
  text: string;
  voice?: SpeechSynthesisVoice | null;
  rate?: number;
  pitch?: number;
  volume?: number;
  lang?: Lang;
}
interface SpeechResult {
  cancel: () => void;
  pause: () => void;
  resume: () => void;
  speak: (options?: string | SpeechOptions) => void;
  isSpeaking: () => boolean;
}
declare function speech(text?: string): SpeechResult;
declare function speech(options?: SpeechOptions): SpeechResult;

//#endregion
//#region src/speak/speechToText.d.ts
/**
 * Speech-to-text options
 * @description EN: Options for the SpeechRecognition instance (continuous recognition, interim results, language).
 */
interface SpeechToTextOptions {
  continuous: boolean;
  interimResults: boolean;
  lang: Lang;
  maxAlternatives: number;
}
/**
 * 语音转文字
 * @description EN: Wrapper around the Web SpeechRecognition API. Returns controls to toggle recognition or abort.
 * @param options - SpeechToTextOptions or a callback when omitted
 * @param callback - optional callback invoked with recognition results
 * @returns controls { toggle, abort }
 */
declare function speechToText(options?: SpeechToTextOptions | ((result: any) => any), callback?: (result: any) => any): {
  toggle: () => void;
  abort: () => any;
};

//#endregion
//#region src/speak/analyzeUserVoice.d.ts
/**
 * 声音分析错误类
 * @description 用于表示声音分析过程中出现的各种错误
 * @description EN: Error class representing problems encountered during voice analysis.
 * @example
 * ```typescript
 * throw new VoiceAnalysisError('录制失败', 'RECORDING_FAILED', { device: 'microphone' })
 * ```
 */
declare class VoiceAnalysisError extends Error {
  readonly code: string;
  readonly details?: any | undefined;
  /**
   * 创建声音分析错误实例
   * @param message - 错误消息
   * @param code - 错误代码，用于程序化处理
   * @param details - 错误详细信息，可选
   */
  constructor(message: string, code: string, details?: any | undefined);
}
/**
 * 录制控制器接口
 * @description 提供录制过程的控制方法
 * @description EN: Controller interface for recording operations (stop, status, progress).
 */
interface RecordingController {
  /** 停止录制 */
  stop: () => void;
  /** 获取当前录制状态 */
  isRecording: () => boolean;
  /** 获取录制进度（0-1） */
  getProgress: () => number;
  /** 获取录制时长（毫秒） */
  getElapsedTime: () => number;
}
/**
 * 分析帧数据接口
 * @description 单个时间点的音频分析数据
 * @description EN: Single time-point audio analysis frame containing frequency and time-domain data.
 */
interface AnalysisFrame {
  /** 时间戳（毫秒） */
  timestamp: number;
  /** 频域数据 */
  frequency: number[];
  /** 时域数据 */
  timeDomain: number[];
  /** 音量（RMS值，可选） */
  volume?: number;
  /** 能量（可选） */
  energy?: number;
}
/**
 * 谐波信息接口
 * @description 声音的谐波特征
 * @description EN: Harmonic information for a detected harmonic (frequency and amplitude).
 */
interface Harmonic {
  /** 谐波频率（Hz） */
  frequency: number;
  /** 谐波幅度 */
  amplitude: number;
}
/**
 * 音色特征接口
 * @description 声音的音色特征参数
 * @description EN: Timbre-related characteristics used to describe voice color.
 */
interface TimbreCharacteristics {
  /** 明亮度（0-1） */
  brightness: number;
  /** 丰富度（0-1） */
  richness: number;
  /** 粗糙度（0-1） */
  roughness: number;
  /** 温暖度（0-1） */
  warmth: number;
}
/**
 * 声音特征接口
 * @description 完整的声音分析结果
 * @description EN: Aggregated voice characteristics including pitch, formants, intensity and timbre.
 */
interface VoiceCharacteristics {
  /** 基频（Hz） */
  fundamentalFrequency: number;
  /** 共振峰频率数组（Hz） */
  formants: number[];
  /** 音量强度 */
  intensity: number;
  /** 频谱重心 */
  spectralCentroid: number;
  /** 谐波信息 */
  harmonics: Harmonic[];
  /** 声音类型 */
  voiceType: 'male' | 'female' | 'child' | 'unknown';
  /** TTS 建议音调参数 */
  pitch: number;
  /** TTS 建议语速参数 */
  rate: number;
  /** 音色特征 */
  timbre: TimbreCharacteristics;
}
/**
 * TTS 参数接口
 * @description 文本转语音的参数配置
 * @description EN: Parameters suggested for TTS engines (pitch and rate).
 */
interface TTSParameters {
  /** 音调（0.1-2.0） */
  pitch: number;
  /** 语速（0.1-10.0） */
  rate: number;
}
/**
 * TTS 建议接口
 * @description 基于声音分析的 TTS 参数建议
 * @description EN: Suggested TTS configuration derived from analysis (voice, pitch, rate, etc.).
 */
interface TTSSuggestions {
  /** 建议的语音类型 */
  voice: string;
  /** 建议的音调 */
  pitch: number;
  /** 建议的语速 */
  rate: number;
  /** 建议的音量 */
  volume: number;
  /** 描述信息 */
  description: string;
}
/**
 * 分析结果接口
 * @description 完整的声音分析结果，包含特征和 TTS 建议
 * @description EN: Final analysis output containing voice characteristics and TTS suggestions.
 */
interface AnalysisResult {
  /** 声音特征 */
  characteristics: VoiceCharacteristics;
  /** TTS 参数建议 */
  suggestions: TTSSuggestions;
}
/**
 * 音频约束接口
 * @description 音频录制的约束配置
 * @description EN: Media constraints used when requesting microphone access (sampleRate, channelCount, etc.).
 */
interface AudioConstraints {
  /** 回声消除，默认 true */
  echoCancellation?: boolean;
  /** 噪声抑制，默认 true */
  noiseSuppression?: boolean;
  /** 自动增益控制，默认 true */
  autoGainControl?: boolean;
  /** 采样率，默认 44100 */
  sampleRate?: number;
  /** 采样大小 */
  sampleSize?: number;
  /** 声道数，默认 1 */
  channelCount?: number;
  /** 延迟，默认 0.01 */
  latency?: number;
}
/**
 * 分析选项接口
 * @description 声音分析的配置选项
 * @description EN: Options controlling recording duration, FFT size, callbacks and thresholds.
 */
interface AnalysisOptions {
  /** 录制时长（毫秒），默认 5000ms */
  duration?: number;
  /** FFT 大小，影响频率分辨率，默认 2048 */
  fftSize?: 256 | 512 | 1024 | 2048 | 4096 | 8192 | 16384 | 32768;
  /** 音频约束配置 */
  audioConstraints?: AudioConstraints;
  /** 峰值检测阈值（0-1），默认 0.3 */
  peakThreshold?: number;
  /** 是否启用实时回调，默认 false */
  enableRealtimeCallback?: boolean;
  /** 平滑时间常数，默认 0.8 */
  smoothingTimeConstant?: number;
  /** 实时分析回调函数 */
  onRealtimeData?: (frame: AnalysisFrame) => void;
  /** 进度回调函数 */
  onProgress?: (progress: number) => void;
  /** 录制开始回调 */
  onRecordingStart?: () => void;
  /** 录制结束回调 */
  onRecordingEnd?: () => void;
  /** 录制停止回调 */
  onRecordingStopped?: (reason: 'manual' | 'duration' | 'error') => void;
  /** 错误回调 */
  onError?: (error: Error) => void;
  /** 音量变化回调 */
  onVolumeChange?: (volume: number) => void;
}
/**
 * 声音分析配置接口
 * @description 声音分析算法的配置参数
 * @description EN: Algorithm-level configuration such as fundamental frequency range and formant/harmonic counts.
 */
interface VoiceAnalysisConfig {
  /** 人声基频检测范围最小值（Hz），默认 80 */
  minFundamentalFreq?: number;
  /** 人声基频检测范围最大值（Hz），默认 800 */
  maxFundamentalFreq?: number;
  /** 检测的共振峰数量，默认 3 */
  formantCount?: number;
  /** 检测的谐波数量，默认 5 */
  harmonicCount?: number;
  /** 是否启用声音分类，默认 true */
  enableVoiceClassification?: boolean;
  /** 是否生成 TTS 参数建议，默认 true */
  generateTTSParams?: boolean;
}
/**
 * 声明全局类型
 * @description EN: Extend Window with webkitAudioContext for older WebKit-based browsers.
 */
declare global {
  interface Window {
    /** WebKit 浏览器的 AudioContext */
    webkitAudioContext?: typeof AudioContext;
  }
}
/**
 * 声音分析器类
 * @description 提供实时声音录制、分析和特征提取功能
 * @example
 * ```typescript
 * const analyzer = new VoiceAnalyzer()
 * const { result, controller } = await analyzer.analyzeVoice({
 *   duration: 5000,
 *   onProgress: (progress) => console.log(`进度: ${progress * 100}%`)
/**
 * 声音分析器类
 * @description 提供实时声音录制、分析和特征提取功能
 * @description EN: VoiceAnalyzer manages microphone recording, real-time analysis and feature extraction.
 * @example
 * ```typescript
 * const analyzer = new VoiceAnalyzer()
 * const { result, controller } = await analyzer.analyzeVoice({
 *   duration: 5000,
 *   onProgress: (progress) => console.log(`进度: ${progress * 100}%`)
 * })
 *
 * // 手动停止录制
 */
declare class VoiceAnalyzer {
  private audioContext;
  private analyser;
  private dataArray;
  private bufferLength;
  private analysisConfig;
  private isRecording;
  private abortController;
  private currentStream;
  private currentSource;
  private recordingStartTime;
  private recordingDuration;
  /**
   * 初始化音频上下文
   * @param fftSize - FFT 大小，默认 2048
   * @param smoothingTimeConstant - 平滑时间常数，默认 0.8
   * @returns 初始化是否成功
   * @throws {VoiceAnalysisError} 当浏览器不支持 AudioContext 时
   */
  initializeAudioContext(fftSize?: number, smoothingTimeConstant?: number): Promise<boolean>;
  /**
   * 录制并分析声音
   * @param options - 分析选项配置
   * @returns 包含分析结果 Promise 和控制器的对象
   * @throws {VoiceAnalysisError} 当录制已在进行中或参数无效时
   * @description EN: Start recording from the microphone and perform analysis according to the options. Returns a controller and a Promise for the result.
   * @example
   * ```typescript
   * const { result, controller } = await analyzer.analyzeVoice({
   *   duration: 8000,
   *   onProgress: (progress) => console.log(`${progress * 100}%`),
   *   onVolumeChange: (volume) => updateVolumeIndicator(volume)
   * })
   *
   * // 3秒后停止录制
   * setTimeout(() => controller.stop(), 3000)
   *
   * const characteristics = await result
   * ```
   */
  analyzeVoice(options?: AnalysisOptions): Promise<{
    result: Promise<VoiceCharacteristics | null>;
    controller: RecordingController;
  }>;
  /**
   * 设置分析配置
   * @param config - 分析配置参数
   * @description EN: Merge user-provided configuration into the analyzer's algorithm settings.
   * @example
   * ```typescript
   * analyzer.setAnalysisConfig({
   *   minFundamentalFreq: 70,
   *   maxFundamentalFreq: 900,
   *   formantCount: 4,
   *   harmonicCount: 6
   * })
   * ```
   */
  setAnalysisConfig(config: VoiceAnalysisConfig): void;
  /**
   * 主动停止录制
   * @param reason - 停止原因
   * @param onRecordingStopped - 停止回调函数
   * @description EN: Stop an in-progress recording, abort internal operations and invoke the stopped callback.
   */
  stopRecording(reason?: 'manual' | 'duration' | 'error', onRecordingStopped?: (reason: 'manual' | 'duration' | 'error') => void): void;
  /**
   * 获取 TTS 语音建议
   * @param characteristics - 声音特征数据
   * @returns TTS 参数建议，如果输入为空则返回 null
   * @description EN: Convert detected voice characteristics to TTS parameter suggestions (pitch, rate, volume).
   * @example
   * ```typescript
   * const suggestions = analyzer.getTTSSuggestions(characteristics)
   * if (suggestions) {
   *   const utterance = new SpeechSynthesisUtterance("测试文本")
   *   utterance.pitch = suggestions.pitch
   *   utterance.rate = suggestions.rate
   *   speechSynthesis.speak(utterance)
   * }
   * ```
   */
  getTTSSuggestions(characteristics: VoiceCharacteristics | null): TTSSuggestions | null;
  /**
   * 资源清理
   * @description 清理所有音频资源，关闭音频上下文
   */
  dispose(): void;
  /**
   * 执行录制和分析
   * @private
   * @param options - 分析选项
   * @returns 声音特征分析结果
   * @description EN: Core implementation that handles getUserMedia, streaming into the analyser and collecting frames.
   */
  private performRecordingAnalysis;
  /**
   * 清理录制资源
   * @private
   */
  private cleanupRecording;
  /**
   * 获取录制进度
   * @private
   * @returns 录制进度（0-1）
   */
  private getRecordingProgress;
  /**
   * 获取已录制时长
   * @private
   * @returns 已录制时长（毫秒）
   */
  private getElapsedTime;
  /**
   * 计算 RMS 音量
   * @private
   * @param timeData - 时域数据
   * @returns RMS 音量值
   */
  private calculateRMSVolume;
  /**
   * 计算能量
   * @private
   * @param frequencyData - 频域数据
   * @returns 能量值
   */
  private calculateEnergy;
  /**
   * 执行音频分析
   * @private
   * @param duration - 分析时长
   * @param onRealtimeData - 实时数据回调
   * @param onProgress - 进度回调
   * @param onVolumeChange - 音量变化回调
   * @param abortSignal - 中止信号
   * @returns 分析帧数据数组
   * @description EN: Collect audio frames for the requested duration, invoking callbacks for realtime data and progress.
   */
  private performAnalysis;
  /**
   * 计算声音特征
   * @private
   * @param analysisData - 分析帧数据
   * @param options - 计算选项
   * @returns 声音特征数据
   */
  private calculateVoiceCharacteristics;
  /**
   * 计算平均频谱
   * @private
   * @param analysisData - 分析帧数据
   * @returns 平均频谱数据
   */
  private calculateAverageSpectrum;
  /**
   * 检测基频（音调）
   * @private
   * @param spectrum - 频谱数据
   * @param minFreq - 最小频率
   * @param maxFreq - 最大频率
   * @returns 基频值（Hz）
   */
  private detectFundamentalFrequency;
  /**
   * 检测共振峰
   * @private
   * @param spectrum - 频谱数据
   * @param threshold - 峰值检测阈值
   * @param count - 共振峰数量
   * @returns 共振峰频率数组
   */
  private detectFormants;
  /**
   * 检测谐波
   * @private
   * @param spectrum - 频谱数据
   * @param fundamentalFreq - 基频
   * @param count - 谐波数量
   * @returns 谐波信息数组
   */
  private detectHarmonics;
  /**
   * 寻找频谱峰值
   * @private
   * @param spectrum - 频谱数据
   * @param threshold - 峰值阈值
   * @returns 峰值索引数组
   */
  private findPeaks;
  /**
   * 计算音量强度
   * @private
   * @param analysisData - 分析帧数据
   * @returns 平均音量强度
   */
  private calculateIntensity;
  /**
   * 计算频谱重心
   * @private
   * @param spectrum - 频谱数据
   * @returns 频谱重心值
   */
  private calculateSpectralCentroid;
  /**
   * 分类声音类型
   * @private
   * @param characteristics - 声音特征
   * @returns 声音类型
   */
  private classifyVoiceType;
  /**
   * 生成 TTS 参数建议
   * @private
   * @param characteristics - 声音特征
   * @returns TTS 参数
   */
  private generateTTSParameters;
  /**
   * 分析音色特征
   * @private
   * @param spectrum - 频谱数据
   * @param characteristics - 声音特征
   * @returns 音色特征
   */
  private analyzeTimbre;
  /**
   * 计算粗糙度
   * @private
   * @param spectrum - 频谱数据
   * @returns 粗糙度值
   */
  private calculateRoughness;
}
/**
 * 分析用户声音的便捷函数
 * @description 提供简单易用的声音分析接口
 * @param options - 分析选项配置
 * @returns 包含分析结果 Promise 和控制器的对象
 * @throws {VoiceAnalysisError} 当录制失败或参数无效时
 * @example
 * ```typescript
 * // 基本使用
 * const { result, controller } = await analyzeUserVoice()
 *
 * // 自定义配置
 * const { result, controller } = await analyzeUserVoice({
 *   duration: 8000,
 *   onProgress: (progress) => {
 *     console.log(`录制进度: ${Math.round(progress * 100)}%`)
 *   },
 *   onVolumeChange: (volume) => {
 *     updateVolumeIndicator(volume)
 *   }
 * })
 *
 * // 手动停止
 * setTimeout(() => controller.stop(), 5000)
 *
 * // 获取结果
 * const analysis = await result
 * if (analysis) {
 *   console.log('声音特征:', analysis.characteristics)
 *   console.log('TTS建议:', analysis.suggestions)
 * }
 * ```
 */
declare function analyzeUserVoice(options?: AnalysisOptions): Promise<{
  result: Promise<AnalysisResult | null>;
  controller: RecordingController;
}>;

//#endregion
//#region src/storage/dbStorage.d.ts
/**
 * 快速操作indexedDB
 * @returns get set remove
 */
declare function dbStorage(): Promise<unknown>;

//#endregion
//#region src/storage/jsCookie.d.ts
/**
 * 快速操作cookie
 */
declare const jsCookie: JSCookie;

//#endregion
//#region src/storage/jsLocal.d.ts
/**
 * 快速操纵localstorage
 * @returns get set delete clear
 */
declare function jsLocal(): {
  set(key: string | Record<string, string>, value?: string): void;
  get(key: string): string | null;
  delete(key: string | string[]): void;
  clear(): void;
};

//#endregion
//#region src/storage/jsSession.d.ts
/**
 * 快速操纵session
 * @returns get set delete clear
 */
declare function jsSession(): {
  set(key: string | Record<string, string>, value?: string): void;
  get(key: string): string | null;
  delete(key: string | string[]): void;
  clear(): void;
};

//#endregion
//#region src/string/camelize.d.ts
/**
 * Convert a kebab-case string (hyphen-separated) to camelCase or PascalCase.
 *
 * Examples:
 *  - camelize('my-variable') => 'myVariable'
 *  - camelize('my-variable', true) => 'MyVariable'
 *
 * @param s - input string in kebab-case
 * @param pascalCase - if true, return PascalCase (first letter capitalized)
 * @returns the camelized string
 */
declare function camelize(s: string, pascalCase?: boolean): string;

//#endregion
//#region src/string/getUrlParam.d.ts
/**
 * Parse query parameters from a URL or a raw query string into an object.
 *
 * @param s - full URL or query string (if omitted, uses window.location.search)
 * @returns an object mapping keys to values, or undefined if no query present
 */
declare function getUrlParam(s?: string): Record<string, string> | undefined;

//#endregion
//#region src/string/hyphenate.d.ts
/**
 * 将大驼峰转为xx-xx
 * @param { string } s 字符串
 * @returns string
 */
/**
 * Convert a PascalCase or camelCase string to kebab-case (hyphen-separated).
 *
 * Example: "MyVariableName" -> "my-variable-name"
 *
 * @param s - input string in camelCase or PascalCase
 * @returns the hyphenated (kebab-case) string
 * @description EN: Convert camelCase or PascalCase to kebab-case.
 */
declare function hyphenate(s: string): string;

//#endregion
//#region src/string/pwdLevel.d.ts
/**
 * Compute a simple password strength level (0-4) based on presence of
 * lowercase, uppercase, digits and symbols. If the string is shorter than
 * `minimum` the level is 0.
 *
 * @param s - input string or number (coerced to string)
 * @param minimum - minimum length required (default: 6)
 * @returns strength level from 0 (weak) to 4 (strong)
 */
declare function pwdLevel(s: string | number, minimum?: number): number;

//#endregion
//#region src/string/trim.d.ts
/**
 * Trim whitespace from a string in different ways.
 *
 * @param s - input string
 * @param type - one of 'all' | 'pre' | 'around' | 'post'
 *  - 'all'   : remove all whitespace
 *  - 'pre'   : remove leading whitespace
 *  - 'post'  : remove trailing whitespace
 *  - 'around' (default) : remove leading and trailing whitespace
 * @returns trimmed string
 */
declare function trim(s: string, type?: TrimType): string;

//#endregion
//#region src/string/useJSONParse.d.ts
/**
 * Parse a JavaScript object-like string into a value using Function.
 * This allows parsing strings that are not strictly JSON (for example,
 * containing functions or unquoted property names). Use with caution as
 * it executes the input string as code.
 *
 * Example: useJSONParse("{ name: 'simon', age: 14 }") => { name: 'simon', age: 14 }
 *
 * @param str - string containing a JS expression representing a value
 * @returns the parsed value
 */
declare function useJSONParse(str: string): any;

//#endregion
//#region src/string/spaceFormat.d.ts
/**
 * Normalize repeated whitespace in a string by replacing runs of whitespace
 * characters with a single replacer string (default is a single space).
 *
 * @param str - input string
 * @param replacer - replacement for runs of whitespace (default: ' ')
 * @returns normalized string
 * @description EN: Replace consecutive whitespace characters with a single replacer string.
 */
declare function spaceFormat(str: string, replacer?: string): string;

//#endregion
//#region src/string/parseLrc.d.ts
interface ParseLrcResult {
  time: number;
  words: string;
}
/**
 * Parse an LRC formatted lyrics string into an array of time/lyric pairs.
 * Each returned entry has the shape { time: seconds, words: string }.
 *
 * @param lrc - lyrics string using [MM:SS.xx] timestamp prefixes per line
 * @returns array of parsed lyric entries
 * @example
 * const lrc = `[00:12.34]First line\n[00:25.67]Second line`
 * parseLrc(lrc)
 */
declare function parseLrc(lrc: string): ParseLrcResult[];

//#endregion
//#region src/string/parseTime.d.ts
/**
 * Parse a time string (HH:MM:SS or MM:SS) into total seconds.
 *
 * Example: '01:02:03' => 1 * 3600 + 2 * 60 + 3
 *
 * @param timeStr - time string in H:M:S or M:S form
 * @returns number of seconds represented by the string
 */
declare function parseTime(timeStr: string): number;

//#endregion
//#region src/string/hash.d.ts
/**
 * Fast string hash that returns a small alphanumeric token for the input.
 * This is non-cryptographic and intended for short, human-friendly keys.
 *
 * @param str - input string to hash
 * @returns 6-character base36 hash string
 */
declare function hash(str: string): string;

//#endregion
//#region src/string/transformWithBack.d.ts
/**
 * Replace matched parts of `code` (by provided regex rules) with stable hashes
 * and return a restore function that converts the hashes back to original
 * fragments. This is useful to protect segments during formatting or
 * transformations.
 *
 * @param code - Original code string to transform
 * @param rules - Array of RegExp rules to match fragments to replace
 * @returns A tuple: [transformedCode, restoreFunction]
 *
 * @example
 * ```ts
 * const code = 'const str = "hello world"; const num = 123;';
 * const rules = [/"[^"]*"/g, /\d+/g]; // match strings and numbers
 * const [transformed, restore] = transformWithBack(code, rules);
 * // process transformed...
 * const final = restore(transformed)
 * ```
 */
declare function transformWithBack(code: string, rules: RegExp[]): [string, (newCode: string) => string];

//#endregion
//#region src/string/escapeRegExp.d.ts
/**
 * Escape special characters in a string so it can be used safely inside a
 * regular expression pattern.
 *
 * @param str - input string
 * @returns escaped string safe for use in RegExp constructors
 * @description EN: Escape special characters so the string can be used inside a RegExp pattern.
 */
declare function escapeRegExp(str: string): string;

//#endregion
//#region src/string/compareVersion.d.ts
/**
 * Compare two semantic version strings (dot-separated numeric parts).
 *
 * Without an operator returns -1, 0, or 1. With an operator it returns a
 * boolean result of the comparison.
 *
 * @param version1 - first version string (e.g. '1.2.3')
 * @param version2 - second version string
 * @param operator - optional comparison operator ('>', '<', '=', '>=', '<=', '!=')
 * @returns number (-1, 0, 1) when operator is omitted, otherwise boolean
 */
declare function compareVersion(version1: string, version2: string): number;
declare function compareVersion(version1: string, version2: string, operator: ComparisonOperator): boolean;

//#endregion
//#region src/string/findMatchEnd.d.ts
/**
 * Find the offset from the start of `code` to the matching closing
 * bracket for a given opening bracket character. Useful when scanning
 * forward in code to find where a structure ends.
 *
 * @param matchStr - the opening bracket character to match (e.g. '{', '(', '[')
 * @param code - the code string to search (search starts from the beginning)
 * @returns offset from the start of the input to the matching closing bracket
 * @throws if no matching closing bracket is found
 */
declare function findMatchEndOffset(matchStr: string, code: string): number;

//#endregion
//#region src/string/findMatchStart.d.ts
/**
 * Find the offset from the end of `code` to the matching opening
 * bracket for a given closing bracket character. This is useful when
 * parsing snippets to find where a matching start bracket appears.
 *
 * @param matchStr - the closing bracket character to match (e.g. ')', '}', ']')
 * @param code - the code string to search (search starts from the end)
 * @returns offset from the end of the input to the matching opening bracket
 * @throws if no matching opening bracket is found
 */
declare function findMatchStartOffset(matchStr: string, code: string): number;

//#endregion
//#region src/to/arrayToExcel.d.ts
interface IArrayToExcel {
  data: Record<string, any>[];
  filename?: string;
  title?: string[];
  filter?: string[];
}
/**
 * Convert an array of objects into an Excel-compatible HTML table and
 * trigger a download as an .xls file.
 *
 * Each item may be a primitive value or an object with display metadata
 * (value, width, colspan, rowspan, style).
 *
 * @param options - Data and output options
 */
declare function arrayToExcel(options: IArrayToExcel): void;

//#endregion
//#region src/to/arrayToTree.d.ts
interface ArrayToTreeOptions {
  id?: number | string;
  pid?: number | string;
  children?: string;
}
/**
 * Convert a flat array of records into a tree structure.
 *
 * Example: pass an array with id/pid and this will nest children under the
 * configured `children` key. `options` can override the id/pid/children
 * property names.
 *
 * @param {Record<string, any>[]} array Source array of records.
 * @param {number|string} [parentId] Parent id to start building from.
 * @param {ArrayToTreeOptions} [options] Optional keys configuration.
 * @returns {Record<string, any>} A tree node (root node is returned).
 */
declare function arrayToTree(array: Record<string, any>[], parentId?: number, options?: ArrayToTreeOptions): Record<string, any>;

//#endregion
//#region src/to/base64ToBlob.d.ts
/**
 * Convert a base64 data URL to a `Blob`.
 *
 * @param {string} s Base64 data URL (e.g. 'data:image/png;base64,...').
 * @returns {Blob} A Blob containing the decoded bytes.
 */
declare function base64ToBlob(s: string): Blob;

//#endregion
//#region src/to/base64ToFile.d.ts
/**
 * Convert a base64 data URL to a File object.
 *
 * @param s - Base64 data URL (e.g. 'data:image/png;base64,...')
 * @param filename - Desired filename for the File
 * @returns A File built from the decoded base64 data
 */
declare function base64ToFile(s: string, filename: string): File;

//#endregion
//#region src/to/toAbsolutePath.d.ts
/**
 * 将相对路径转换为基于当前工作目录的绝对路径
 * @param {string} url 要转换的路径
 * @returns {string} 绝对路径
 * @description EN: Convert a relative filesystem path to an absolute path using process.cwd(); returns the original path if already absolute.
 */
declare function toAbsolutePath(url: string): string;

//#endregion
//#region src/to/toSlice.d.ts
/**
 * Fast slice implementation that copies elements from `start` to the end into
 * a new array. Designed to be faster than `Array.prototype.slice` in tight
 * loops for array-like structures.
 *
 * @param list - Array-like or string
 * @param start - Start index (defaults to 0)
 * @returns A new array containing the sliced values
 */
declare function toSlice(list: any, start?: number): Array<any>;

//#endregion
//#region src/to/toBase64.d.ts
/**
 * 转为base64格式
 * @param { File | string | Blob } o 传入类型 File | string | Blob
 * @returns { Promise<string> }
 */
/**
 * Convert a File/Blob or URL to a base64 data URL.
 *
 * If passed a File/Blob, it will be read as data URL. If passed a string it
 * will be treated as a remote URL and loaded into a canvas to extract a data
 * URL (subject to CORS).
 *
 * @param {File|string|Blob} o Input file/blob or URL.
 * @returns {Promise<string>} Base64 data URL.
 * @description EN: Convert a File/Blob or remote URL to a base64 data URL, using FileReader or drawing an image to canvas.
 */
declare function toBase64(o: File | string | Blob): Promise<string>;
/**
 * Read a File/Blob and return a data URL (base64 string).
 * @param {File|Blob} file
 * @returns {Promise<string>}
 */
declare function fileToBase64(file: File | Blob): Promise<string>;
/**
 * Load an image from `url` and draw to canvas to return data URL (base64).
 * Note: this requires the image to be CORS-enabled for canvas access.
 *
 * @param {string} url Image URL.
 * @returns {Promise<string>} Base64 data URL.
 */
declare function urlToBase64(url: string): Promise<string>;

//#endregion
//#region src/to/toObject.d.ts
/**
 * Convert an array of plain objects into an object keyed by property names.
 *
 * For each key present in the input objects, the returned object will have an
 * array of values collected from each item. Optionally restrict keys via
 * `filter`.
 *
 * @param arr - Input array of plain objects.
 * @param filter - Optional list of keys to include.
 * @returns Object mapping keys to arrays of values.
 */
declare function toObject(arr: Array<any>, filter?: string[]): object;

//#endregion
//#region src/to/toArray.d.ts
/**
 * Ensure value is an array. If input is already an array it is returned as-is;
 * otherwise the value is wrapped in a single-element array.
 *
 * @param array - Value or array of values.
 * @returns An array containing the original value(s).
 */
declare function toArray<T>(array: T): (T & any[]) | T[];

//#endregion
//#region src/to/treeToArray.d.ts
/**
 * Flatten a tree into an array. The root node is included and children are
 * recursively appended. The `children` property is removed from returned
 * objects.
 *
 * @param {Record<string, any>} tree Root node.
 * @param {string} [children] Children key name.
 * @returns {Record<string, any>[]} Flattened node array.
 */
declare function treeToArray(tree?: Record<string, any>, children?: string): Record<string, any>[];

//#endregion
//#region src/to/fileToBlob.d.ts
/**
 * Convert a File to a Blob (preserves provided MIME type).
 *
 * @param file - File to convert
 * @param type - Optional MIME type for the resulting Blob
 * @returns A Blob built from the file's ArrayBuffer
 */
declare function fileToBlob(file: File, type?: string): Promise<Blob>;

//#endregion
//#region src/to/fileToArrayBuffer.d.ts
/**
 * Read a File/Blob as an ArrayBuffer and return a Uint8Array.
 *
 * @param {File} file File or Blob to read.
 * @returns {Promise<Uint8Array>} Resolves with file bytes.
 */
declare function fileToArrayBuffer(file: File): Promise<Uint8Array>;

//#endregion
//#region src/to/blobToUrl.d.ts
/**
 * Create an object URL for a Blob.
 *
 * @param blob - Blob to create a URL for
 * @returns A blob URL that can be used as a src/href
 */
declare function blobToUrl(blob: Blob): string;

//#endregion
//#region src/to/rgbToHex.d.ts
/**
 * Convert an `rgb(r,g,b)` CSS color string to hex format `#rrggbb`.
 *
 * Returns `undefined` when input doesn't match `rgb(...)` pattern.
 *
 * @param {string} style CSS rgb string, e.g. 'rgb(255, 255, 255)'.
 * @returns {string | undefined} Hex color string or undefined.
 */
declare function rgbToHex(style: string): string | undefined;

//#endregion
//#region src/to/hexToRgb.d.ts
/**
 * Convert a hex color string to rgb or rgba string.
 *
 * Accepts short and full hex formats like '#fff' or '#ffffff'.
 *
 * @param {string} hex Hex color string (with leading '#').
 * @param {number} [opacity] Optional opacity for rgba result.
 * @returns {string} 'rgb(r,g,b)' or 'rgba(r,g,b,a)'.
 */
declare function hexToRgb(hex: string, opacity?: number): string;

//#endregion
//#region src/utils/common.d.ts
/**
 * `Object.prototype.toString` 的安全引用
 * @description EN: Cached reference to `Object.prototype.toString` for reliable type inspection.
 */
declare const _toString: () => string;
/**
 * 匹配静态 ESM `import` 语句
 * @description EN: Regular expression that captures static ESM import statements, including specifiers and imported bindings.
 */
declare const ESM_STATIC_IMPORT_RE: RegExp;
/**
 * 匹配动态 `import()` 调用
 * @description EN: Regular expression that extracts the expression inside dynamic `import()` calls.
 */
declare const DYNAMIC_IMPORT_RE: RegExp;
/**
 * 匹配具名导出的声明语句
 * @description EN: Regular expression that locates `export function|const|class ...` declarations and captures their names.
 */
declare const EXPORT_DECAL_RE: RegExp;
/**
 * 匹配具名导出的花括号语法
 * @description EN: Regular expression that captures `export { ... }` statements, optionally with re-export specifiers.
 */
declare const EXPORT_NAMED_RE: RegExp;
/**
 * 匹配 `export *` 语句
 * @description EN: Regular expression used to detect star exports, optionally capturing aliased names and source specifiers.
 */
declare const EXPORT_STAR_RE: RegExp;
/**
 * 匹配默认导出语句
 * @description EN: Regular expression that identifies `export default` statements.
 */
declare const EXPORT_DEFAULT_RE: RegExp;

//#endregion
//#region src/utils/hasOwn.d.ts
/**
 * 判断对象是否拥有指定的自有属性
 * @description EN: Check whether the given object has an own property named `key`.
 * @param { object } obj 需要检查的对象
 * @param { string } key 属性名
 * @returns { boolean }
 */
declare function hasOwn(obj: object, key: string): boolean;

//#endregion
//#region src/utils/mount.d.ts
type MountArgs = [...Array<string | Element | Window | Document | MediaQueryList | ParentNode | Text>, (...elements: HTMLElement[]) => void];
/**
 * 挂载：等待元素存在然后执行回调。支持选择器字符串或直接传入 DOM 对象。
 * - 最后一个参数必须是回调，前面的参数为要等待/解析的元素或选择器。
 * - 回调会在元素可用时被调用，并接收解析后的元素参数。
 *
 * @param ...args - 多个元素或选择器，最后一个参数为回调函数
 * @returns void
 * @description EN: Wait for one or more elements (or selectors) to become available and invoke the provided callback with the resolved elements. Useful for mounting listeners or components when DOM nodes may not exist yet.
 */
declare function mount(...args: MountArgs): void;

//#endregion
//#region src/utils/unmount.d.ts
/**
 * 浏览器卸载时
 * @description EN: Register a callback to run when the window unloads.
 * @param { (ev: Event) => void } callback 回调
 * @returns { (ev: Event) => void }
 */
declare function unmount(callback: (ev: Event) => void): (ev: Event) => void;

//#endregion
//#region src/utils/assign.d.ts
/**
 * 兼容的 Object.assign 别名
 * @description EN: Alias for Object.assign, provided for convenience and consistent imports.
 */
declare const assign: {
  <T extends {}, U>(target: T, source: U): T & U;
  <T extends {}, U, V>(target: T, source1: U, source2: V): T & U & V;
  <T extends {}, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
  (target: object, ...sources: any[]): any;
};

//#endregion
//#region src/utils/beforeUnmount.d.ts
/**
 * 浏览器关闭前
 * @description EN: Register a callback to run before the window unloads (beforeunload).
 * @param { (ev: Event) => void } callback 回调
 * @returns { (ev: Event) => void }
 */
declare function beforeUnmount(callback: (ev: Event) => void): (ev: Event) => void;

//#endregion
//#region src/iframe/postMessage.d.ts
/**
 * Forward a postMessage to an iframe's contentWindow.
 *
 * @param {HTMLIFrameElement} el Target iframe element.
 * @param {any} data Data to postMessage.
 * @param {string} targetOrigin Target origin string (e.g. '*').
 * @param {Transferable[]} [transfer] Optional transfer list.
 * @returns {void}
 */
declare function postMessage(el: HTMLIFrameElement, data: any, targetOrigin: string, transfer?: Transferable[]): void;

//#endregion
//#region src/animate/backIn.d.ts
/**
 * 回拉进入缓动曲线
 * @description EN: Back-in easing that briefly reverses direction before accelerating forward.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function backIn(t: number): number;

//#endregion
//#region src/animate/backInOut.d.ts
/**
 * 回拉往返缓动曲线
 * @description EN: Back-in-out easing that overshoots when starting and ending the motion.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function backInOut(t: number): number;

//#endregion
//#region src/animate/backOut.d.ts
/**
 * 回拉离开缓动曲线
 * @description EN: Back-out easing that overshoots the target before settling at the end.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function backOut(t: number): number;

//#endregion
//#region src/animate/bounceIn.d.ts
/**
 * 弹跳进入缓动曲线
 * @description EN: Bounce-in easing that simulates a bouncing object accelerating toward the start.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function bounceIn(t: number): number;

//#endregion
//#region src/animate/bounceInOut.d.ts
/**
 * 弹跳往返缓动曲线
 * @description EN: Bounce-in-out easing that bounces when starting and when finishing the motion.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function bounceInOut(t: number): number;

//#endregion
//#region src/animate/bounceOut.d.ts
/**
 * 弹跳离开缓动曲线
 * @description EN: Bounce-out easing that mimics an object dropping and bouncing to rest.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function bounceOut(t: number): number;

//#endregion
//#region src/animate/circIn.d.ts
/**
 * 圆形进入缓动曲线
 * @description EN: Circular ease-in that accelerates as if moving along a quarter circle.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function circIn(t: number): number;

//#endregion
//#region src/animate/circInOut.d.ts
/**
 * 圆形往返缓动曲线
 * @description EN: Circular ease-in-out that starts and ends with circular acceleration and deceleration.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function circInOut(t: number): number;

//#endregion
//#region src/animate/circOut.d.ts
/**
 * 圆形离开缓动曲线
 * @description EN: Circular ease-out that decelerates smoothly toward the end of the motion.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function circOut(t: number): number;

//#endregion
//#region src/animate/cubicIn.d.ts
/**
 * 立方进入缓动曲线
 * @description EN: Cubic ease-in that accelerates following a cubic curve.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function cubicIn(t: number): number;

//#endregion
//#region src/animate/cubicInOut.d.ts
/**
 * 立方往返缓动曲线
 * @description EN: Cubic ease-in-out that accelerates and decelerates with a cubic curve.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function cubicInOut(t: number): number;

//#endregion
//#region src/animate/cubicOut.d.ts
/**
 * 立方离开缓动曲线
 * @description EN: Cubic ease-out that decelerates following a cubic falloff.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function cubicOut(t: number): number;

//#endregion
//#region src/animate/elasticIn.d.ts
/**
 * 弹性进入缓动曲线
 * @description EN: Elastic ease-in that overshoots with oscillations before moving forward.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function elasticIn(t: number): number;

//#endregion
//#region src/animate/elasticInOut.d.ts
/**
 * 弹性往返缓动曲线
 * @description EN: Elastic ease-in-out that oscillates at both the start and end of the motion.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function elasticInOut(t: number): number;

//#endregion
//#region src/animate/elasticOut.d.ts
/**
 * 弹性离开缓动曲线
 * @description EN: Elastic ease-out that releases with oscillations while settling at the end.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function elasticOut(t: number): number;

//#endregion
//#region src/animate/expoIn.d.ts
/**
 * 指数进入缓动曲线
 * @description EN: Exponential ease-in that starts slowly then grows rapidly.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function expoIn(t: number): number;

//#endregion
//#region src/animate/expoInOut.d.ts
/**
 * 指数往返缓动曲线
 * @description EN: Exponential ease-in-out that uses steep growth and decay for a dramatic motion.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function expoInOut(t: number): number;

//#endregion
//#region src/animate/expoOut.d.ts
/**
 * 指数离开缓动曲线
 * @description EN: Exponential ease-out that decays rapidly toward the end.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function expoOut(t: number): number;

//#endregion
//#region src/animate/quadIn.d.ts
/**
 * 二次进入缓动曲线
 * @description EN: Quadratic ease-in that accelerates proportionally to the square of progress.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quadIn(t: number): number;

//#endregion
//#region src/animate/quadInOut.d.ts
/**
 * 二次往返缓动曲线
 * @description EN: Quadratic ease-in-out that blends acceleration and deceleration symmetrically.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quadInOut(t: number): number;

//#endregion
//#region src/animate/quadOut.d.ts
/**
 * 二次离开缓动曲线
 * @description EN: Quadratic ease-out that decelerates with a simple parabolic curve.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quadOut(t: number): number;

//#endregion
//#region src/animate/quartIn.d.ts
/**
 * 四次进入缓动曲线
 * @description EN: Quartic ease-in that ramps up rapidly using a fourth-power curve.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quartIn(t: number): number;

//#endregion
//#region src/animate/quartInOut.d.ts
/**
 * 四次往返缓动曲线
 * @description EN: Quartic ease-in-out that uses a fourth-power curve for sharp acceleration and deceleration.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quartInOut(t: number): number;

//#endregion
//#region src/animate/quartOut.d.ts
/**
 * 四次离开缓动曲线
 * @description EN: Quartic ease-out that slows down using a fourth-power falloff.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quartOut(t: number): number;

//#endregion
//#region src/animate/quintIn.d.ts
/**
 * 五次进入缓动曲线
 * @description EN: Quintic ease-in that accelerates aggressively using a fifth-power curve.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quintIn(t: number): number;

//#endregion
//#region src/animate/quintInOut.d.ts
/**
 * 五次往返缓动曲线
 * @description EN: Quintic ease-in-out that combines strong acceleration and deceleration using a fifth-power curve.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quintInOut(t: number): number;

//#endregion
//#region src/animate/quintOut.d.ts
/**
 * 五次离开缓动曲线
 * @description EN: Quintic ease-out that decelerates sharply with a fifth-power falloff.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function quintOut(t: number): number;

//#endregion
//#region src/animate/sineIn.d.ts
/**
 * 正弦进入缓动曲线
 * @description EN: Sine ease-in that starts gently following a quarter sine wave.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function sineIn(t: number): number;

//#endregion
//#region src/animate/sineInOut.d.ts
/**
 * 正弦往返缓动曲线
 * @description EN: Sine ease-in-out that follows a half sine wave for smooth start and end.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function sineInOut(t: number): number;

//#endregion
//#region src/animate/sineOut.d.ts
/**
 * 正弦离开缓动曲线
 * @description EN: Sine ease-out that eases smoothly to the end along a sine wave.
 * @param { number } t 归一化时间进度，范围 0-1
 * @returns { number }
 */
declare function sineOut(t: number): number;

//#endregion
//#region src/animate/useNumberAnimation.d.ts
/**
 * 贝塞尔曲线变化数字
 * @description EN: Animate a number from `from` to `to` using a Bezier easing curve and call `onProgress` on each step.
 * @param from 起始数字
 * @param to 结束数字
 * @param duration 动画时长
 * @param onProgress 回调
 */
declare function useNumberAnimation(from: number, to: number, duration: number, onProgress?: (newValue: number) => void): void;

//#endregion
//#region src/theme/useSystemColor.d.ts
type Color = 'light' | 'dark';
/**
 * 监听系统颜色模式
 * @description EN: Observe the OS color-scheme preference and invoke the callback with `light` or `dark` whenever it changes.
 * @param { (color: 'light' | 'dark') => void } callback 接收系统配色的回调
 * @returns { () => void } 解绑监听的函数
 */
declare function useSystemColor(callback: (color: Color) => void): () => void;

//#endregion
export { AnalysisFrame, AnalysisOptions, AnalysisResult, AudioConstraints, BodyType, Cache, Canvas, ChunkDetail, ChunkInfo, ComparisonOperator, CreateSignatureCanvas, Credentials, DYNAMIC_IMPORT_RE, DateString, Deadline, DeviceType, Direction, DotImageCanvas, DotImageCanvasOptions, DotTextCanvas, DotTextCanvasOptions, DragEvent, ESM_STATIC_IMPORT_RE, EXPORT_DECAL_RE, EXPORT_DEFAULT_RE, EXPORT_NAMED_RE, EXPORT_STAR_RE, EventBus, FileChunk, FileMD5, FileSpliceOptions, FileType, Harmonic, HeadOptions, HybridMap, HybridSet, IFetchConfig, IFetchInterceptors, IFetchOptions, ILink, IMeta, IScript, IShellMessage, ISignature, ImageData$1 as ImageData, IsESModule, JSCookie, LRU, Lang, Line, MaybeElement, Merge, Method, Mode, MutationObserverInit, NodeWorkerPayload, ParsedURL, PkgTool, Point, Position, RecordingController, Redirect, ResponseType, SpeechOptions, SpeechResult, SpeechToTextOptions, Square, TTSParameters, TTSSuggestions, TimbreCharacteristics, TimeUnit, TrimType, UseTimeoutReturn, VFetch, VoiceAnalysisConfig, VoiceAnalysisError, VoiceAnalyzer, VoiceCharacteristics, _toString, addClass, addLink, addRules, addScript, addStyle, addStyleScoped, analyzeUserVoice, arrayToExcel, arrayToTree, assign, asyncPool, backIn, backInOut, backOut, base64ToBlob, base64ToFile, beforeUnmount, blobToUrl, bounceIn, bounceInOut, bounceOut, calFps, calNum, camelize, catchAwait, chainFns, chunk, circIn, circInOut, circOut, classesReg, collisionDetection, compareDate, compareDateTime, compareTime, compareVersion, compressCss, compressImage, copy, countBy, createCalendar, createChannel, createChunk, createElement, createEventBus, createFragment, createHybridMap, createHybridSet, createTextNode, cubicIn, cubicInOut, cubicOut, curry, dbStorage, debounce, debugWarn, deepClone, deepCompare, deepMerge, diff, download, dragEvent, elasticIn, elasticInOut, elasticOut, escapeHtml, escapeRegExp, executeStr, exitFullscreen, expoIn, expoInOut, expoOut, fileSplice, fileToArrayBuffer, fileToBase64, fileToBlob, filterEmpty, findElement, findMatchEndOffset, findMatchStartOffset, flatten, forEach, formateDate, formateNum, fullScreen, generateKeyObject, generateQRCode, getAverage, getClasses, getCssVar, getDateList, getDaysOfMonth, getDevice, getDifferenceDays, getFirstDay, getImageData, getLocation, getLru, getScrollPosition, getScrollProgress, getStyles, getUrlParam, getVideoFrame, globalErrorCapture, handleImageError, hasClassName, hasOwn, hasProtocol, hash, hexToRgb, htmlTransform, httpsRedirect, hyphenate, insertElement, interceptError, isAbsolute, isActive, isArray, isBase64, isBlob, isBool, isBottom, isBrowser, isComment, isContainCn, isDate, isDef, isDivElement, isESModule, isElement, isEqual, isEven, isFalse, isFile, isFileType, isFn, isIFrameElement, isIPv4, isIPv6, isIdCard, isImageElement, isLeapYear, isMap, isMobile, isNaN, isNameCn, isNameEn, isNil, isNode, isNull, isNum, isObject, isPlainObject, isPostCode, isPromise, isProxyDocument, isReg, isRelative, isSameDay, isScriptElement, isSet, isShadowRoot, isSocketUrl, isSoldierId, isStr, isStyleElement, isSupportCamera, isSupportWebp, isSymbol, isTrainNumber, isTrue, isType, isUndef, isUrl, isVersion, isVideo, isVue, isWeakMap, isWeakSet, isWin, jsCookie, jsLocal, jsSession, lazyLoad, listenStack, log, mapToObject, mapTransform, mapTransformBack, memorizeFn, monitorPef, mount, multiply, nextTick, noop, noopFalse, objectToMap, once, parallel, parse, parseCss, parseLrc, parsePath, parseTime, parseURL, picInPic, postMessage, prefetch, preload, promiseFinally, pwdLevel, quadIn, quadInOut, quadOut, quartIn, quartInOut, quartOut, quickFilter, quickFind, quintIn, quintInOut, quintOut, randomArray, randomDate, randomHexColor, randomRange, randomRgba, reduceAsync, removeClass, removeElement, removeRoundSpace, removeStyle, replaceAsync, retryAsync, rgbToHex, scrollToTop, scrollToView, sendBeacon, sendStorage, setCssVar, setStyle, shareScreen, sineIn, sineInOut, sineOut, singleModel, sleep, sliderValidation, sort, sortByOrder, spaceFormat, speech, speechToText, streamToUrl, stringify, stylesReg, throttle, throwError, timeCost, timeout, toAbsolutePath, toArray, toBase64, toObject, toSlice, transformKey, transformWithBack, traverse, treeToArray, trim, unescapeHtml, uniqueArray, unmount, updateDetection, uppercaseNum, urlToBase64, useAudio, useBlur, useCamera, useClick, useElementBounding, useEventListener, useFocus, useFrequency, useHead, useHover, useIntersectionObserver, useInterval, useJSONParse, useKeyBoard, useLongPress, useMouse, useMutationObserver, useNamespace, useNumberAnimation, useRaf, useRange, useReader, useRecorder, useResizeObserver, useRic, useServiceWorker, useShare, useSocket, useStorageListen, useSwitch, useSystemColor, useTimeout, useVideo, useVideoSubtitle, useWebWorker, useWindowScroll, uuid, waterfall };