nhanh-pure-function 3.0.6-beta.8 → 3.0.6

package/dist/Browser/index.d.ts

@@ -10,46 +10,6 @@ export declare function _Browser_GetFrameRate(callback: (fps: number, frameTime:
  * @param {string} text
  */
 export declare function _Browser_CopyToClipboard(text: string): Promise<void>;
-/**
- * 管理通过键值对打开的窗口
- */
-export declare class _Browser_KeyedWindowManager {
-    private static keys;
-    /** 请使用静态方法 */
-    private constructor();
-    /** 添加已有窗口 */
-    static add(key: string, win: Window): void;
-    /**
-     * 根据键打开或聚焦窗口
-     * @param key 窗口的唯一键
-     * @param url 要打开的URL
-     * @param target 窗口的目标
-     * @param windowFeatures 新窗口的特性
-     * @returns 返回已打开或新打开的窗口
-     */
-    static open(key: string, url?: string | URL, target?: WindowTarget, windowFeatures?: string): Window | undefined;
-    /**
-     * 检查指定键的窗口是否打开
-     * @param key 窗口的唯一键
-     * @returns 如果窗口打开则返回true，否则返回false
-     */
-    static isOpen(key: string): boolean;
-    /**
-     * 获取与指定键关联的窗口
-     * @param key 窗口的唯一键
-     * @returns 返回对应的窗口，如果窗口已关闭则返回undefined
-     */
-    static getWindow(key: string): Window | undefined;
-    /**
-     * 关闭与指定键关联的窗口
-     * @param key 窗口的唯一键
-     */
-    static close(key: string): void;
-    /**
-     * 关闭所有打开的窗口并清空Map
-     */
-    static closeAll(): void;
-}
 /**
  * 计算纸张内容可用宽高及边距（考虑设备DPI）
  * 确保：contentWidth + 2*paddingPx = 纸张宽度像素
@@ -63,7 +23,7 @@ export declare class _Browser_KeyedWindowManager {
  *   paperHeightPx: number; // 纸张总高度(px)
  * }
  */
-export declare function _Browser_CalculatePrintableArea(type: PaperType, padding: number): {
+export declare function _Browser_CalculatePrintableArea(type: PaperType, padding: number): void | {
     /** 内容宽度（像素） */
     contentWidth: number;
     /** 内容高度（像素） */
@@ -75,3 +35,34 @@ export declare function _Browser_CalculatePrintableArea(type: PaperType, padding
     /** 纸张高度（像素） */
     paperHeightPx: number;
 };
+/** 同源标签页管理器类 */
+export declare class _Browser_SameOriginTabManager {
+    /** 初始化完成标志 */
+    private static initFinish;
+    /** 频道 */
+    private static channel;
+    /** 等待回执消息时间上限（上限） */
+    static timeout: number;
+    /**
+     * 待处理查询
+     * @param key 回执消息key
+     * @param callback 匹配标签页的回调函数
+     */
+    private static pendingQueries;
+    private constructor();
+    /** 初始化标签页管理器 */
+    static init(name: string): void;
+    /** 设置事件监听器 */
+    private static setupEventListeners;
+    /** 处理BroadcastChannel消息 */
+    private static handleChannelMessage;
+    /**
+     * 获取已经打开的指定名称的标签页
+     * @param name 标签页名称
+     */
+    static getWindow(name: string): Promise<number>;
+    /** 打开标签页 */
+    static openWindow(name: string, url: string, target?: WindowTarget, windowFeatures?: string): Promise<Window | null>;
+    /** 获取所有已经打开的标签页 */
+    static getAllWindows(): Promise<string[]>;
+}

package/dist/Canvas/OverlayGroup/arc.d.ts

@@ -1,6 +1,7 @@
 import { default as Overlay } from './public/overlay';
 import { OverlayType } from './index';
 import { EventHandler } from '../public/eventController';
+import { ArcStyleType, PolygonStyleType } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof Overlay<ArcStyleType, [number, number]>>[0] & {
     /** 是否填充 */
     isFill?: boolean;

package/dist/Canvas/OverlayGroup/arcTo.d.ts

@@ -1,6 +1,7 @@
 import { default as Overlay } from './public/overlay';
 import { OverlayType } from './index';
 import { EventHandler } from '../public/eventController';
+import { ArcToStyleType } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof Overlay<ArcToStyleType, [number, number][]>>[0] & {
     /** 是否可显示控制点 */
     isHandlePointsVisible?: boolean;

package/dist/Canvas/OverlayGroup/line.d.ts

@@ -1,5 +1,6 @@
 import { OverlayType } from './index';
 import { default as GeometricBoundary } from './public/geometricBoundary';
+import { LineStyleType } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof GeometricBoundary<LineStyleType>>[0] & {
     /** 是否是 两点相连向外延展的无限线 */
     isInfinite?: boolean;

package/dist/Canvas/OverlayGroup/point.d.ts

@@ -1,6 +1,7 @@
 import { default as Overlay } from './public/overlay';
 import { OverlayType } from './index';
 import { EventHandler } from '../public/eventController';
+import { PointStyleType } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof Overlay<PointStyleType, [number, number]>>[0];
 export default class Point extends Overlay<PointStyleType, [number, number]> {
     private angle;

package/dist/Canvas/OverlayGroup/polygon.d.ts

@@ -1,5 +1,6 @@
 import { OverlayType } from './index';
 import { default as GeometricBoundary } from './public/geometricBoundary';
+import { PolygonStyleType } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof GeometricBoundary<PolygonStyleType>>[0] & {
     /** 是否为矩形 */
     isRect?: boolean;

package/dist/Canvas/OverlayGroup/public/overlay.d.ts

@@ -2,6 +2,7 @@ import { default as _Canvas } from '../..';
 import { OverlayType } from '../index';
 import { EventHandler, default as EventController } from '../../public/eventController';
 import { _Type_DeepPartial } from '../../..';
+import { BaseLineStyle, PointStyleType } from '../../common.type';
 type ConstructorOption<T, V> = ConstructorParameters<typeof EventController>[0] & {
     /** 样式 */
     style?: _Type_DeepPartial<T> | string;
@@ -12,7 +13,7 @@ type ConstructorOption<T, V> = ConstructorParameters<typeof EventController>[0]
     /** 动态点位 */
     dynamicPosition?: V;
     /** 坐标轴上的值 */
-    value?: V;
+    value: V;
     /** 偏移 */
     offset?: {
         x: number;

package/dist/Canvas/OverlayGroup/text.d.ts

@@ -1,6 +1,7 @@
 import { default as Overlay } from './public/overlay';
 import { OverlayType } from './index';
 import { EventHandler } from '../public/eventController';
+import { TextStyleType } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof Overlay<TextStyleType, [number, number]>>[0] & {
     /** 文字 */
     text?: string;

package/dist/Canvas/common.type.d.ts

@@ -0,0 +1,117 @@
+/** 默认中心点 */
+export type DefaultCenter = Partial<{
+    top: number | `${number}%` | "top" | "middle" | "bottom";
+    bottom: number | `${number}%`;
+    left: number | `${number}%` | "left" | "center" | "right";
+    right: number | `${number}%`;
+}>;
+export type KnownStyleKeys = "light" | "dark";
+/** 文本样式 */
+export type TextStyleType = {
+    /** 颜色 */
+    color: string;
+    /** secondary颜色 */
+    secondary: string;
+    /** 描边色 */
+    stroke: string;
+    /** 字体大小 */
+    size: number;
+    /** 字体族 */
+    family: string;
+    /** 是否加粗 */
+    bold: boolean;
+};
+/** 网格样式 */
+export type GridStyleType = {
+    axis: string;
+    grid: string;
+    innerGrid: string;
+};
+/** 点位样式 */
+export type PointStyleType = {
+    /** 半径 */
+    radius: number;
+    /** 边框颜色 */
+    stroke: string;
+    /** 边框大小 */
+    width: number;
+    /** 填充颜色 */
+    fill: string;
+};
+/** 基础线样式 */
+export type BaseLineStyle = {
+    /** 颜色 */
+    color: string;
+    /** 颜色 - hover */
+    color_hover: string;
+    /** 宽度 */
+    width: number;
+    /** 虚线 */
+    dash: boolean;
+    /** 虚线间隔 */
+    dashGap: number[];
+    /** 偏移虚线 */
+    dashOffset: number;
+    /** 末端的形状 */
+    cap: "butt" | "round" | "square";
+    /** 路径中的相连部分的形状 */
+    join: "bevel" | "round" | "miter";
+};
+/** 线样式 */
+export type LineStyleType = {
+    /** 描边 */
+    stroke: BaseLineStyle;
+    /** 点位样式 */
+    point: PointStyleType;
+};
+/** 圆弧样式 */
+export type ArcStyleType = {
+    /** 填充色 */
+    fill: string;
+    /** 填充色 - hover */
+    fill_hover: string;
+    /** 描边 */
+    stroke: BaseLineStyle;
+    /** 点位样式 */
+    point: PointStyleType;
+};
+/** 圆角样式 */
+export type ArcToStyleType = {
+    /** 描边 */
+    stroke: BaseLineStyle;
+    /** 点位样式 */
+    point: PointStyleType;
+};
+/** 面样式 */
+export type PolygonStyleType = {
+    /** 填充色 */
+    fill: string;
+    /** 填充色 - hover */
+    fill_hover: string;
+    /** 描边 */
+    stroke: BaseLineStyle;
+    /** 点位样式 */
+    point: PointStyleType;
+};
+/** 主题样式 */
+export type StyleItemType = {
+    /** 背景色 */
+    background: string;
+    /** 文本样式 */
+    text: TextStyleType;
+    /** 网格样式 */
+    grid: GridStyleType;
+    /** 点位样式 */
+    point: PointStyleType;
+    /** 线样式 */
+    line: LineStyleType;
+    /** 圆弧样式 */
+    arc: ArcStyleType;
+    /** 圆角样式 */
+    arcTo: ArcToStyleType;
+    /** 面样式 */
+    polygon: PolygonStyleType;
+};
+/** 主题样式 */
+export type StyleType = Record<KnownStyleKeys, StyleItemType> & Record<string, StyleItemType>;
+export type DeepArray<T> = T | T[] | DeepArray<T>[];

package/dist/Canvas/core/axis.d.ts

@@ -3,8 +3,11 @@ import { _Type_DeepPartial } from '../..';
 export default class Axis {
     /** 画布 */
     private canvas;
+    /** 轴画布 */
     private axis_canvas;
+    /** 轴画布上下文 */
     private ctx;
+    /** 是否重新绘制轴 */
     private isReload;
     /** 网格开关 */
     show: {

package/dist/Canvas/core/basedata.d.ts

@@ -1,6 +1,7 @@
 import { default as Axis } from './axis';
 import { default as LayerGroup } from '../LayerGroup';
 import { default as EventController } from '../public/eventController';
+import { DefaultCenter } from '../common.type';
 type ConstructorOption = ConstructorParameters<typeof EventController>[0] & {
     /** 画布 id */
     id: string;

package/dist/Canvas/core/draw.d.ts

@@ -9,7 +9,6 @@ export default class Draw extends Style {
     currentDrawOverlays: OverlayType[];
     /** 计算坐标所需依赖 */
     private rely;
-    private isResizeObserverFirstRun;
     constructor(option: ConstructorOption);
     /** 更新 计算坐标所需依赖 */
     private updateRely;

package/dist/Canvas/core/quikmethod.d.ts

@@ -4,6 +4,7 @@ import { default as Event } from './event';
 import { default as OverlayGroup, OverlayType } from '../OverlayGroup';
 import { default as LayerGroup } from '../LayerGroup';
 import { default as Layer } from '../LayerGroup/layer';
+import { KnownStyleKeys, StyleType } from '../common.type';
 type NodeType = LayerGroup | Layer | OverlayGroup | OverlayType;
 type SingleOrArray<T> = T | T[];
 declare class QuickMethod_Get extends Event {

package/dist/Canvas/core/style.d.ts

@@ -1,4 +1,5 @@
 import { _Type_DeepPartial } from '../..';
+import { KnownStyleKeys, StyleType } from '../common.type';
 import { default as BaseData } from './basedata';
 type ConstructorOption = ConstructorParameters<typeof BaseData>[0] & {
     theme?: KnownStyleKeys;

package/dist/Canvas/index.d.ts

@@ -9,6 +9,7 @@ import { default as Polygon } from './OverlayGroup/polygon';
 import { default as Custom } from './OverlayGroup/custom';
 import { default as Arc } from './OverlayGroup/arc';
 import { default as ArcTo } from './OverlayGroup/arcTo';
+import { DeepArray } from './common.type';
 export type * from './index.types';
 type ConstructorOption = ConstructorParameters<typeof QuickMethod>[0] & {
     /** 轴线显示属性 */

package/dist/Element/index.d.ts

@@ -58,7 +58,7 @@ export declare function _Element_IsFullscreen(element?: HTMLElement | string): b
  * @param {HTMLElement} content - 需要进入全屏的元素
  * 该函数通过检查不同浏览器的特定方法来实现全屏切换
  */
-export declare function _Element_Fullscreen(element?: HTMLElement | string): () => void;
+export declare function _Element_Fullscreen(element?: HTMLElement | string): (() => void) | undefined;
 /**
  * 元素全屏状态观察器
  * 监听元素的全屏状态变化，并通过回调函数通知状态改变
@@ -66,7 +66,7 @@ export declare function _Element_Fullscreen(element?: HTMLElement | string): ()
  * @param selectors - 要观察的元素或元素选择器，默认为document.documentElement
  * @returns 返回一个清理函数，调用后可移除所有事件监听器
  */
-export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): () => void;
+export declare function _Element_FullscreenObserver(notify: (isFull: boolean) => void, selectors?: HTMLElement | string): (() => void) | undefined;
 /**
  * 单位转换 12** -> **px
  * @param {string} width

package/dist/Format/index.d.ts

@@ -84,7 +84,7 @@ declare const UnitConfigs: readonly [readonly ["年", number], readonly ["月",
 type UnitName = (typeof UnitConfigs)[number][0];
 /**
  * 格式化毫秒数为易读的时间单位（基于固定换算规则）
- * @param ms 待格式化的毫秒数（需为非负整数）
+ * @param ms 待格式化的毫秒数（需为非负数）
  * @param maxUnit 最大单位限制（可选，如传入"天"则最大只显示到天，不显示年/月/周）
  *                可选值："年"|"月"|"周"|"天"|"时"|"分"|"秒"|"毫秒"
  * @returns 格式化后的时间字符串（如 1.3秒、300毫秒、1,234年）
@@ -97,7 +97,7 @@ type UnitName = (typeof UnitConfigs)[number][0];
  *     - 自动匹配不超过最大单位限制的最优单位（数值≥单位阈值时使用该单位）
  *     - 非整数数值保留1位小数（如1.3秒），整数自动去除末尾.0（如1秒而非1.0秒）
  *     - "年"单位数值会自动应用千分位格式化（如1,234年）
- *  3. 输入校验：非整数或负数会返回"0毫秒"
+ *  3. 输入校验：负数会返回"0毫秒"
  */
 export declare function _Format_MillisecondToReadable(ms: number, maxUnit?: UnitName): string;
 /**

package/dist/Utility/index.d.ts

@@ -3,14 +3,14 @@
  * @param callback  需执行的方法
  * @param timeout 超时时间
  */
-export declare function _Utility_ExecuteWhenIdle(callback: Function, timeout?: number): void;
+export declare function _Utility_ExecuteWhenIdle(callback: (deadline?: IdleDeadline) => void, timeout?: number): void;
 /**
  * 等待条件满足
  * @param conditionChecker 条件检查器
  * @param timeoutMillis 超时毫秒数
- * @returns Promise<unknown>
+ * @returns Promise<number> 耗时
  */
-export declare function _Utility_WaitForCondition(conditionChecker: () => boolean, timeoutMillis: number): Promise<"完成" | "超时">;
+export declare function _Utility_WaitForCondition(conditionChecker: () => boolean, timeoutMillis: number): Promise<number>;
 /**
  * 合并对象  注意: 本函数会直接操作 A
  * @param {Object | Array} A
@@ -74,12 +74,22 @@ export declare function _Utility_RotateList<T>(list: T[]): T[][];
  */
 export declare function _Utility_Clone<T>(val: T): T;
 /**
- * 函数装饰器，用于测量并记录另一个函数的执行时间
- * @param func 要测量执行时间的函数
- * @param level 耗时与颜色对应的数组，用于在控制台中着色显示
- * @param maxHistory 保留的最大历史记录数，默认为30
+ * 函数装饰器：精准测量并记录目标函数的执行耗时（单位：毫秒）
+ *
+ * @template T - 泛型参数，约束为任意函数类型，保证装饰器返回值类型与原函数一致
+ * @param {T} func - 待测量执行时间的目标函数
+ * @param {Object} [config] - 可选配置对象，用于自定义耗时测量规则
+ * @param {Array<[number, string]>} [config.level] - 耗时阈值（毫秒）与控制台输出颜色的映射数组
+ *                                                   规则：当函数耗时（ms）≥ level[n][0] 时，使用 level[n][1] 指定的颜色输出
+ * @param {number} [config.maxHistory=30] - 执行耗时历史记录的最大保留条数，默认值为30
+ * @param {string} [config.prefix] - 控制台输出耗时日志时的自定义前缀文本（可选）
+ * @returns {T | void} 包装后的函数（保留原函数所有功能，新增耗时测量/记录/日志输出逻辑）；若入参非法则返回 void
  */
-export declare function _Utility_TimeConsumption(func: Function, level: [number, string][], maxHistory?: number): void | ((...args: any[]) => any);
+export declare function _Utility_TimeConsumption<T extends Function>(func: T, config?: {
+    level?: [number, string][];
+    maxHistory?: number;
+    prefix?: string;
+}): T | void;
 /**
  * 暂停执行指定毫秒数的操作
  * 此函数通过 busy-wait（忙等待）的方式实现，它会持续执行一些无用的操作以消耗时间

package/dist/Valid/index.d.ts

@@ -91,7 +91,7 @@ export declare class _Valid_FileTypeChecker {
     static parseAddresses(url: string): {
         url: string;
         name: string;
-        type: "audio" | "code" | "script" | "video" | "text" | "image" | "ppt" | "word" | "excel" | "pdf" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
+        type: "image" | "ppt" | "word" | "excel" | "pdf" | "text" | "audio" | "video" | "archive" | "code" | "font" | "database" | "markup" | "configuration" | "logs" | "script" | "unknown";
     }[];
     /**
      * 检查 MIME 类型是否与指定的模式匹配
@@ -121,5 +121,5 @@ export declare class _Valid_FileTypeChecker {
      * @param {string} url - 文件的URL
      * @returns {string} - 如果URL与任何已知类型匹配，则返回文件类型，否则返回"unknown"
      */
-    static _detectFileType(url: string): "audio" | "code" | "script" | "video" | "text" | "image" | "ppt" | "word" | "excel" | "pdf" | "archive" | "font" | "database" | "markup" | "configuration" | "logs" | "unknown";
+    static _detectFileType(url: string): "image" | "ppt" | "word" | "excel" | "pdf" | "text" | "audio" | "video" | "archive" | "code" | "font" | "database" | "markup" | "configuration" | "logs" | "script" | "unknown";
 }