nhanh-pure-function 4.0.0 → 4.1.0

package/dist/Animate/index.d.ts

@@ -40,6 +40,16 @@ export declare function _Animate_CreateOscillator(initialMin: number, initialMax
  * @param targetValue - 目标值
  * @param stepCount - 动画步数
  * @param callback - 每帧回调函数
- * @param precision - 数值精度（默认2位小数）
+ * @param precision - 数值精度（默认4位小数）
  */
 export declare function _Animate_NumericTransition(startValue: number, targetValue: number, stepCount: number, callback: (currentValue: number) => void, precision?: number): void;
+/**
+ * 三次贝塞尔缓动（与 CSS `cubic-bezier(x1, y1, x2, y2)` 语义一致）
+ * 曲线端点为 (0,0) → (1,1)，控制点为 (x1,y1)、(x2,y2)。
+ * @param x1 第一个控制点 x
+ * @param y1 第一个控制点 y
+ * @param x2 第二个控制点 x
+ * @param y2 第二个控制点 y
+ * @returns 接收归一化时间 `t ∈ [0,1]`，返回缓动后的进度 `∈ [0,1]`（一般情况）
+ */
+export declare function _Animate_CubicBezier(x1: number, y1: number, x2: number, y2: number): (t: number) => number;

package/dist/Browser/Runtime/index.d.ts

@@ -0,0 +1,2 @@
+export * from './soundEffects';
+export * from './webSocketClient';

package/dist/Browser/Runtime/soundEffects.d.ts

@@ -0,0 +1,47 @@
+/** 资源映射类型 */
+type Resource<T extends string> = Record<T, string>;
+/** 播放配置 */
+interface PlayOptions {
+    /** 是否无限循环播放 */
+    loop?: boolean;
+    /** 循环次数（优先级高于 loop，最少为 1 次） */
+    loopCount?: number;
+}
+/** 构造选项 */
+interface SoundEffectsOptions<T extends string> {
+    /**
+     * 初始化时即 fetch 下载为 Blob，并将 `soundSources` 中对应 key 的地址替换为 blob URL
+     */
+    holdKeys?: readonly T[];
+}
+/**
+ * 音效管理类
+ * 负责音效的加载与播放
+ */
+export declare class _Browser_SoundEffects<T extends string> {
+    /** 音效资源地址映射（preload 成功后对应项会替换为 blob: URL） */
+    private soundSources;
+    /** 各 key 下载任务，避免重复发起 */
+    private readonly preloadTasks;
+    constructor(resource: Resource<T>, options?: SoundEffectsOptions<T>);
+    /**
+     * 下载指定 key 的音频为 Blob，并将 `soundSources[key]` 替换为 `URL.createObjectURL` 结果（与 holdKeys 同一逻辑）
+     */
+    preload(key: T): Promise<void>;
+    preload(keys: readonly T[]): Promise<void>;
+    private fetchAndReplaceSource;
+    /**
+     * 根据 key 播放音效
+     * @param key 资源 key
+     * @param options 播放配置（循环等）
+     */
+    play(key: T, options?: PlayOptions): (() => void) | undefined;
+    /**
+     * 根据 URL 播放音效
+     * @param url 音频地址
+     * @param options 播放配置（循环等）
+     * @returns 停止播放的方法
+     */
+    playUrl(url: string, options?: PlayOptions): (() => void) | undefined;
+}
+export {};

package/dist/Browser/Runtime/webSocketClient.d.ts

@@ -0,0 +1,68 @@
+/** ping 配置 */
+interface WebSocketClientPingConfig {
+    /** 是否启用 */
+    enabled?: boolean;
+    /** 间隔（毫秒） */
+    interval?: number;
+    /** 发送内容 */
+    content?: string;
+}
+/** WebSocket 客户端配置 */
+interface WebSocketClientConfig {
+    url?: string;
+    /** true 启用并采用默认参数，或传入具体配置 */
+    ping?: boolean | WebSocketClientPingConfig;
+    /** 最大重试次数，默认 3 */
+    maxRetryCount?: number;
+    /** 重试间隔（毫秒），默认 1000 */
+    retryInterval?: number;
+}
+/** WebSocket客户端 */
+export declare class _Browser_WebSocketClient {
+    /** WebSocket地址 */
+    url?: string;
+    /** WebSocket实例 */
+    private socket?;
+    /** 连接回调 */
+    onopen?: (ev: Event) => any;
+    /** 接收消息回调 */
+    onmessage?: (ev: MessageEvent) => any;
+    /** 错误回调 */
+    onerror?: (ev: Event) => any;
+    /** 关闭回调 */
+    onclose?: (ev: CloseEvent) => any;
+    /** ping 配置 */
+    readonly pingConfig: {
+        /** 是否启用 */
+        enabled: boolean;
+        /** 间隔（毫秒） */
+        interval: number;
+        /** 发送内容 */
+        content: string;
+    };
+    /** ping 定时器 */
+    private pingTimer?;
+    /** 重试配置 */
+    readonly retryConfig: {
+        /** 最大次数 */
+        maxCount: number;
+        /** 当前次数 */
+        currentCount: number;
+        /** 间隔（毫秒） */
+        interval: number;
+    };
+    /** 是否准备完毕 */
+    get ready(): boolean;
+    constructor(config?: WebSocketClientConfig);
+    /** 开始ping */
+    private startPing;
+    /** 开始重试 */
+    private startRetry;
+    /** 开始 */
+    start(url: string): void;
+    /** 停止 */
+    stop(): void;
+    /** 发送信息 */
+    send: WebSocket["send"];
+}
+export {};

package/dist/Browser/index.d.ts

@@ -1,4 +1,5 @@
 import { PaperType, WindowTarget } from '../Constant';
+export * from './Runtime';
 /**
  * 获取帧率
  * @param {(fps , frameTime)=>void} callback callback( 帧率 , 每帧时间 )
@@ -66,3 +67,36 @@ export declare class _Browser_SameOriginTabManager {
     /** 获取所有已经打开的标签页 */
     static getAllWindows(): Promise<string[]>;
 }
+/**
+ * 无操作（闲置）检测类
+ * 监听用户键盘、鼠标操作，更新用户活跃状态
+ * 支持注册/触发活跃/闲置状态的回调通知
+ */
+export declare class _Browser_IdleDetection {
+    /** 用户状态：active(活跃) / idle(闲置) */
+    status: "active" | "idle";
+    /** 活跃状态回调通知集合（key: 回调标识，value: 回调函数） */
+    readonly activeCallbacks: Map<string, () => void>;
+    /** 闲置状态回调通知集合（key: 回调标识，value: 回调函数） */
+    readonly idleCallbacks: Map<string, () => void>;
+    /** 闲置时间（分钟） */
+    idleTime: number;
+    /** 闲置判定定时器（5分钟无操作触发闲置状态） */
+    private timeoutTimer?;
+    constructor();
+    /**
+     * 重置闲置判定定时器
+     * 每次用户操作时重置，重新开始5分钟计时
+     */
+    resetTimeoutTimer(): void;
+    /**
+     * 激活为活跃状态
+     * 触发活跃回调，并重置定时器
+     */
+    private activate;
+    /**
+     * 标记为闲置状态
+     * 触发闲置回调，并清除定时器
+     */
+    private markAsIdle;
+}

package/dist/Browser/type.d.ts

@@ -0,0 +1,16 @@
+/** 定义消息类型枚举，避免硬编码字符串 */
+export declare enum ChannelMessageType {
+    /** 回执消息 */
+    RESPONSE = "response",
+    /** 询问消息 */
+    QUERY = "query"
+}
+/** 基础消息结构 */
+export interface ChannelMessage {
+    /** 消息类型 */
+    type: ChannelMessageType;
+    /** 消息关联的标识键 */
+    responseKey: string;
+    /** 标签页名称 "*" 表示所有标签页 */
+    name: string;
+}

package/dist/Canvas/TimeAxis/index.d.ts

@@ -1,3 +1,4 @@
+import { TimeAxisAnimationCurve, TimeAxisFillStyle, TimeAxisMouseTimeInfo } from './type';
 declare class TimeAxisCanvasManager {
     /** Canvas DOM id（用于 `document.getElementById` 定位） */
     private id;
@@ -34,25 +35,6 @@ declare class TimeAxisCanvasManager {
     /** 销毁 ResizeObserver，释放资源 */
     destroy(): void;
 }
-/**
- * 鼠标时间提示：仅负责计算鼠标位置对应的时间
- * - 监听 canvas 的 mousemove / mouseleave
- * - 通知外部：显示/隐藏、canvasX、time
- */
-type TimeAxisMouseTimeInfo = {
-    /** 是否显示指示线/时间提示 */
-    visible: boolean;
-    /** 鼠标在 canvas 内的 x（像素） */
-    canvasX: number;
-    /** 鼠标在 canvas 内的 y（像素） */
-    canvasY: number;
-    /** 鼠标位置对应的时间戳（ms） */
-    time: number;
-};
-/**
- * 时间轴动画曲线：入参 `t` 为 [0, 1]，返回 eased 后的进度（也应为 [0, 1]）
- */
-type TimeAxisAnimationCurve = (t: number) => number;
 declare class TimeAxisBase {
     /** 负责 canvas 引用、2D context 获取与尺寸同步 */
     protected canvasManager: TimeAxisCanvasManager;
@@ -140,6 +122,12 @@ declare class TimeAxisBase {
  * - 提供常用图形绘制方法（如按时间范围画圆角矩形）
  */
 export declare class _Canvas_TimeAxis extends TimeAxisBase {
+    /**
+     * 将填充样式解析为 ctx.fillStyle 可用的值（纯色或线性渐变）
+     * @param rect 矩形区域，用于计算渐变起止点
+     * @param fillStyle 纯色字符串或渐变配置
+     */
+    private resolveFillStyle;
     /**
      * 按时间范围绘制圆角矩形（常用于高亮某段时间区间）
      */
@@ -154,8 +142,8 @@ export declare class _Canvas_TimeAxis extends TimeAxisBase {
         height?: number;
         /** 圆角半径：可为单值或 canvas roundRect 支持的数组（默认 10） */
         radius?: number | number[];
-        /** 填充色：不传则不填充 */
-        fillStyle?: string;
+        /** 填充色：不传则不填充，支持纯色或线性渐变 */
+        fillStyle?: TimeAxisFillStyle;
         /** 描边色：不传则不描边 */
         strokeStyle?: string;
         /** 描边线宽（默认 1） */

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

@@ -0,0 +1,39 @@
+/**
+ * 鼠标时间提示信息
+ */
+export type TimeAxisMouseTimeInfo = {
+    /** 是否显示指示线/时间提示 */
+    visible: boolean;
+    /** 鼠标在 canvas 内的 x（像素） */
+    canvasX: number;
+    /** 鼠标在 canvas 内的 y（像素） */
+    canvasY: number;
+    /** 鼠标位置对应的时间戳（ms） */
+    time: number;
+};
+/** 矩形区域（像素坐标） */
+export type TimeAxisRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** 渐变颜色停靠点 */
+export type TimeAxisGradientColorStop = {
+    color: string;
+    offset: number;
+};
+/** 线性渐变配置：x1/y1/x2/y2 为相对矩形的比例 [0,1]，表示渐变起止方向 */
+export type TimeAxisGradientFillStyle = {
+    x1: number;
+    x2: number;
+    y1: number;
+    y2: number;
+    colorStops: TimeAxisGradientColorStop[];
+};
+/** 填充样式：纯色或线性渐变 */
+export type TimeAxisFillStyle = string | TimeAxisGradientFillStyle;
+/**
+ * 时间轴动画曲线：入参 `t` 为 [0, 1]，返回 eased 后的进度（也应为 [0, 1]）
+ */
+export type TimeAxisAnimationCurve = (t: number) => number;