ranuts 0.1.0-alpha → 0.1.0-alpha-22

package/dist/src/utils/memoize.d.ts

@@ -0,0 +1,7 @@
+export type Func = () => unknown;
+/**
+ * @description: 返回缓存的函数，执行一次后，无须执行直接返回结果
+ * @param {Func} fn
+ * @return {Func}
+ */
+export declare const memoize: (fn: unknown) => Func;

package/dist/src/utils/mimeType.d.ts

@@ -0,0 +1,9 @@
+export declare const MimeType: Map<string, string>;
+export declare const setMime: (ext: string, mimeType: string) => Map<string, string>;
+export declare function getMime(ext: string): string | undefined;
+/**
+ * Get file extensions from MIME type
+ * @param mimeType The MIME type to get extensions for
+ * @returns Array of file extensions (without dot)
+ */
+export declare const getExtensions: (mimeType: string) => string[];

package/dist/src/utils/monitor.d.ts

@@ -0,0 +1,38 @@
+export interface Payload {
+    payload: Record<string, unknown>;
+    type?: string;
+}
+export declare class Monitor {
+    constructor();
+    /**
+     * @description: 页面加载性能上报
+     * @param {Payload} param1
+     */
+    reportPerformance(): void;
+    /**
+     * @description: 手动触发的上报
+     * @param {Record} payload
+     * @param {*} unknown
+     */
+    log(payload: Record<string, unknown>): void;
+    /**
+     * @description: 点击上报
+     * @return {*}
+     */
+    reportClick(): void;
+    reportXhr(): void;
+    /**
+     * @description: fetch上报
+     */
+    reportFetch(): void;
+    /**
+     * @description: 错误上报
+     */
+    reportError(): void;
+    /**
+     * @description: 上报console
+     */
+    reportConsole(): void;
+    init: () => void;
+    initialize(): void;
+}

package/dist/src/utils/network.d.ts

@@ -0,0 +1,39 @@
+declare const status: {
+    message: Map<number, string>;
+    code: Map<string, number>;
+    codes: number[];
+    redirect: {
+        300: boolean;
+        301: boolean;
+        302: boolean;
+        303: boolean;
+        305: boolean;
+        307: boolean;
+        308: boolean;
+    };
+    empty: {
+        204: boolean;
+        205: boolean;
+        304: boolean;
+    };
+    retry: {
+        502: boolean;
+        503: boolean;
+        504: boolean;
+    };
+};
+/**
+ * Get the status code.
+ *
+ * Given a number, this will throw if it is not a known status
+ * code, otherwise the code will be returned. Given a string,
+ * the string will be parsed for a number and return the code
+ * if valid, otherwise will lookup the code assuming this is
+ * the status message.
+ *
+ * @param {string|number} code
+ * @returns {number}
+ * @public
+ */
+declare function getStatus(code?: number | string): number | string | undefined;
+export { getStatus, status };

package/dist/src/utils/noop.d.ts

@@ -0,0 +1,2 @@
+export declare const noop: () => void;
+export type Noop = () => void;

package/dist/src/utils/number.d.ts

@@ -0,0 +1,45 @@
+interface ComputeNumberResult {
+    result: number;
+    next: (a: string, b: number) => ComputeNumberResult;
+}
+/**
+ * @description: 百分比转换成数字
+ * @param {string} str
+ * @return {*}
+ */
+export declare const perToNum: (str?: string) => number;
+/**
+ * @description: 限制最大和最小值
+ * @return {*}
+ */
+export declare const range: (num: number, min?: number, max?: number) => number;
+/**
+ * 数字运算（主要用于小数点精度问题）
+ * @param {number} a 前面的值
+ * @param {"+"|"-"|"*"|"/"} type 计算方式
+ * @param {number} b 后面的值
+ * @example
+ * ```js
+ * // 可链式调用
+ * const res = computeNumber(1.3, "-", 1.2).next("+", 1.5).next("*", 2.3).next("/", 0.2).result;
+ * console.log(res);
+ * ```
+ */
+export declare class Mathjs {
+    /**
+     * 获取数字小数点的长度
+     * @param {number} n 数字
+     */
+    getDecimalLength: (n: number) => number;
+    amend: (n: number, precision?: number) => number;
+    power: (a: number, b: number) => number;
+    static handleMethod: (l: number, r: number) => ((type: string) => number | undefined);
+    static add: (a: number, b: number) => number | undefined;
+    static divide: (a: number, b: number) => number | undefined;
+    static multiply: (a: number, b: number) => number | undefined;
+    static subtract: (a: number, b: number) => number | undefined;
+}
+export declare function mathjs(a: number, type: string, b: number): ComputeNumberResult;
+export declare const transformNumber: (value: string, locale?: string, precision?: number, fixed?: number) => string;
+export declare const addNumSym: (value: string | number, flag?: string | number) => string;
+export {};

package/dist/src/utils/obj.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @description: 对象转 url 字符串
+ * @param {*} data
+ * @return {*}
+ */
+export declare function querystring(data?: {}): string;
+export declare const formatJson: (jsonObj: string, callback?: () => void) => string;
+/**
+ * @description: 过滤对象的属性，去除对象中在list数组里面有的属性，返回一个新对象，一般是用于去除空字符和null
+ * @param {Object} obj 传入对象
+ * @param {Array} list 传入数组
+ * @return {Object}
+ */
+export declare const filterObj: (obj: Record<string, unknown>, list: Array<string>) => Record<string, unknown>;
+type Obj = Record<string, any>;
+/**
+ * @description: 合并对象
+ * @param {Obj} a
+ * @param {Obj} b
+ * @return {*}
+ */
+export declare const merge: (a: Obj, b?: Obj) => Obj;
+/**
+ * 重写对象上面的某个属性
+ *
+ * @export
+ * @param {IAnyObject} source 需要被重写的对象
+ * @param {string} name 需要被重写对象的 key
+ * @param {(...args: any[]) => any} replacement 以原有的函数作为参数，执行并重写原有函数
+ * @param {boolean} isForced 是否强制重写（可能原先没有该属性）
+ */
+export declare function replaceOld(source: any, name: string, replacement: (...args: unknown[]) => unknown, isForced?: boolean): void;
+/**
+ * @description: 将 exports 对象拼接到 obj 上，并冻结 obj
+ * @param {Object} obj
+ * @param {Object} exports
+ * @return {Object}
+ */
+export declare const mergeExports: (obj: Record<string, string>, exports: Record<string, string>) => Record<string, string>;
+/**
+ * @description: 给全局对象上增加属性
+ * @param {string} name
+ * @param {string} value
+ * @return {*}
+ */
+export declare const setAttributeByGlobal: (name: string, value: unknown) => void;
+/**
+ * 深度比较两个值是否相等
+ * 实现类似 Lodash 的 isEqual 函数
+ */
+/**
+ * 检查两个值是否为基本相同的值
+ * 处理特殊情况如 NaN, -0/+0
+ */
+export declare function sameValueZero(x: any, y: any): boolean;
+/**
+ * 判断是否为类对象
+ */
+export declare function isObjectLike(value: any): boolean;
+/**
+ * 获取对象的标签
+ */
+export declare function getTag(value: any): string;
+/**
+ * 检查是否是类数组对象
+ */
+export declare function isArrayLike(value: any): boolean;
+/**
+ * 深度比较两个值是否相等
+ * @param value 第一个值
+ * @param other 第二个值
+ * @param seen 已经比较过的对象（用于处理循环引用）
+ * @returns 两个值是否相等
+ */
+export declare function isEqual(value: any, other: any, seen?: Map<any, any>): boolean;
+/**
+ * 深克隆函数，支持各种复杂数据类型和循环引用
+ * @param value 需要深度克隆的值
+ * @param cloneMap 用于跟踪已克隆的对象，避免循环引用问题
+ * @returns 克隆后的值
+ */
+export declare const cloneDeep: <T>(value: T, cloneMap?: WeakMap<object, any>) => T;
+export {};

package/dist/src/utils/performance.d.ts

@@ -0,0 +1,21 @@
+interface BasicType {
+    [x: string]: number | undefined;
+    dnsSearch: number;
+    tcpConnect: number;
+    sslConnect: number;
+    request: number;
+    response: number;
+    parseDomTree: number;
+    resource: number;
+    domReady: number;
+    httpHead: number;
+    interactive: number;
+    complete: number;
+    redirect: number;
+    redirectTime: number;
+    duration: number;
+    fp: number | undefined;
+    fcp: number | undefined;
+}
+export declare function getPerformance(): BasicType | undefined;
+export {};

package/dist/src/utils/queue.d.ts

@@ -0,0 +1,33 @@
+import type { Func } from '@/utils/memoize';
+interface QuestQueueOptions {
+    simultaneous: number;
+    total: number;
+}
+type Fun = Function | Func;
+export declare class QuestQueue {
+    current: number;
+    queue: Fun[];
+    simultaneous: number;
+    executed: number;
+    total: number;
+    constructor({ simultaneous, total }: QuestQueueOptions);
+    /**
+     * @description: 传入异步函数，添加到队列并执行
+     * @param {Fun} asynchronous
+     * @return {*}
+     */
+    add: (asynchronous: Fun) => void;
+    /**
+     * @description: 执行异步函数
+     * @param {*} Promise
+     * @return {*}
+     */
+    running: () => Promise<unknown>;
+    /**
+     * @description: 并发执行所有的异步函数，并返回所有的结果
+     * @param {*} Promise
+     * @return {*}
+     */
+    allSettled: () => Promise<unknown>;
+}
+export {};

package/dist/src/utils/report.d.ts

@@ -0,0 +1,8 @@
+interface BeaconPayload {
+    url?: string;
+    type?: string;
+    payload: Record<string, unknown>;
+}
+export declare const report: ({ url, type, payload, }: BeaconPayload) => boolean | undefined | void;
+export declare function createData(params?: Record<string, unknown>): Record<string, unknown>;
+export {};

package/dist/src/utils/request.d.ts

@@ -0,0 +1,17 @@
+export type Hooks = (...args: unknown[]) => void;
+export interface Options {
+    requestHook: Hooks;
+    responseHook: Hooks;
+    errorHook: Hooks;
+}
+/**
+ * @description: fetch
+ * @param {Partial} options
+ */
+export declare const handleFetchHook: (options?: Partial<Options>) => void;
+/**
+ * @description: xhr
+ * @param {Partial} options
+ * @return {*}
+ */
+export declare const handleXhrHook: (options?: Partial<Options>) => void;

package/dist/src/utils/script.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 动态插入 script/link 标签
+ * @param {Array | String} url script/link的url队列
+ * @param {Element} append 插入的父元素 默认 body
+ * @param {Function} callback 所有 script onload 回调 也可通过返回的 promise 执行回调
+ */
+export declare const scriptOnLoad: (urls: string[], append?: HTMLElement, callback?: Function) => Promise<void>;

package/dist/src/utils/signal.d.ts

@@ -0,0 +1,6 @@
+import { SyncHook } from './subscribe';
+export declare const subscribers: SyncHook;
+export declare const createSignal: <T = unknown>(value: T, options?: {
+    subscriber?: string;
+    equals?: boolean | ((prev: T | undefined, next: T) => boolean);
+}) => [() => T, (newValue: T) => void];

package/dist/src/utils/storage.d.ts

@@ -0,0 +1,2 @@
+export declare const localStorageSetItem: (name: string, value: string) => void;
+export declare const localStorageGetItem: (name: string) => string;

package/dist/src/utils/str.d.ts

@@ -0,0 +1,212 @@
+/**
+ * @description: 将字符串转对象，比如
+ * @param {string} url 'a=1&b=2&c=3'
+ * @param {string} sep &
+ * @param {string} eq =
+ * @return {object} {a:1,b:2,c:3}
+ */
+export declare const strParse: (str?: string, sep?: string | RegExp, eq?: string | RegExp) => Record<string, string>;
+/**
+ * @description: 清除空格和换行
+ * @param {*} str
+ * @return {*}
+ */
+export declare const clearBr: (str?: string) => string;
+/**
+ * @description: 传入字符串和指定的格式，将字符串转成 xml
+ * @param {string} xmlStr
+ * @param {DOMParserSupportedType} format
+ * @return {Document}
+ */
+export declare const str2Xml: (xmlStr: string, format?: DOMParserSupportedType) => HTMLElement | undefined;
+export declare const isString: (obj: unknown) => boolean;
+export declare function randomString(len?: number): string;
+export declare function changeHumpToLowerCase(str: string): string;
+interface ClearStrOption {
+    urlencoded?: boolean;
+}
+/**
+ * @description: 去除字符串首尾的空格，encode 编码，首尾的引号
+ * @param {string} str
+ * @return {string}
+ */
+export declare const clearStr: (str: string, options?: ClearStrOption) => string;
+/**
+ * 获取文本中包含搜索关键词的完整句子，对于重复的句子只保留最长的一个
+ * @param text 原文本
+ * @param searchValue 搜索关键词
+ * @returns 包含关键词的完整句子数组（已去重）
+ */
+export declare function getMatchingSentences(text: string, searchValue: string): string[];
+export declare const toString: (value: string | number) => string;
+export declare const checkEncoding: (uint8Array: Uint8Array) => string;
+export interface TransformText {
+    encoding: string;
+    content: string;
+}
+export declare const transformText: (content: string | ArrayBuffer) => TransformText | undefined;
+/**
+ * MD5 hash function implementation
+ * @param str The string to hash
+ * @returns The MD5 hash as a hexadecimal string
+ */
+export declare const md5: (str: string) => string;
+export declare const getRandomString: (len?: number) => string;
+type FileChunk = {
+    name: string;
+    type: string;
+    size: number;
+    lastModified: number;
+    totalChunks: number;
+    chunkIndex: number;
+    data: string;
+};
+/**
+ * 消息编解码工具
+ * 正确处理所有 Unicode 字符，包括中文、emoji 等
+ * 编码后的字符串只包含 A-Z, a-z, 0-9, +, /, = 这些安全字符
+ * 适合在 URL、Cookie 等场景使用
+ * 编码解码过程是双向的，不会丢失数据，不会出现编码解码不一致的问题
+ */
+export declare const MessageCodec: {
+    /**
+     * 编码消息
+     * @param data 要编码的数据
+     * @returns 编码后的字符串
+     */
+    encode(data: any): string;
+    /**
+     * 解码消息
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的数据
+     */
+    decode<T = any>(encodedStr: string): T | null;
+    /**
+     * 编码文件对象
+     * @param file File对象
+     * @returns 编码后的字符串
+     * @throws {MessageCodecError} 当文件编码失败时抛出
+     */
+    encodeFile(file: File): Promise<string>;
+    /**
+     * 解码文件对象
+     * @param encoded 编码后的字符串
+     * @returns 解码后的 File 对象
+     * @throws {MessageCodecError} 当解码失败或类型不匹配时抛出
+     */
+    decodeFile(encoded: string): File;
+    /**
+     * 编码 Blob 对象
+     * @param blob Blob 对象
+     * @returns 编码后的字符串
+     * @throws {MessageCodecError} 当编码失败时抛出
+     */
+    encodeBlob(blob: Blob): Promise<string>;
+    /**
+     * 解码 Blob 对象
+     * @param encoded 编码后的字符串
+     * @returns 解码后的 Blob 对象
+     * @throws {MessageCodecError} 当解码失败或类型不匹配时抛出
+     */
+    decodeBlob(encoded: string): Blob;
+    /**
+     * 编码 Date 对象
+     * @param date Date 对象
+     * @returns 编码后的字符串
+     */
+    encodeDate(date: Date): string;
+    /**
+     * 解码 Date 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 Date 对象
+     */
+    decodeDate(encodedStr: string): Date;
+    /**
+     * 编码 RegExp 对象
+     * @param regexp RegExp 对象
+     * @returns 编码后的字符串
+     */
+    encodeRegExp(regexp: RegExp): string;
+    /**
+     * 解码 RegExp 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 RegExp 对象
+     */
+    decodeRegExp(encodedStr: string): RegExp;
+    /**
+     * 编码 Map 对象
+     * @param map Map 对象
+     * @returns 编码后的字符串
+     */
+    encodeMap<K, V>(map: Map<K, V>): string;
+    /**
+     * 解码 Map 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 Map 对象
+     */
+    decodeMap<K, V>(encodedStr: string): Map<K, V>;
+    /**
+     * 编码 Set 对象
+     * @param set Set 对象
+     * @returns 编码后的字符串
+     */
+    encodeSet<T>(set: Set<T>): string;
+    /**
+     * 解码 Set 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 Set 对象
+     */
+    decodeSet<T>(encodedStr: string): Set<T>;
+    /**
+     * 编码 Error 对象
+     * @param error Error 对象
+     * @returns 编码后的字符串
+     */
+    encodeError(error: Error): string;
+    /**
+     * 解码 Error 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 Error 对象
+     */
+    decodeError(encodedStr: string): Error;
+    /**
+     * 编码 ArrayBuffer 对象
+     * @param buffer ArrayBuffer 对象
+     * @returns 编码后的字符串
+     */
+    encodeArrayBuffer(buffer: ArrayBuffer): string;
+    /**
+     * 解码 ArrayBuffer 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 ArrayBuffer 对象
+     */
+    decodeArrayBuffer(encodedStr: string): ArrayBuffer;
+    /**
+     * 编码 TypedArray 对象
+     * @param typedArray TypedArray 对象
+     * @returns 编码后的字符串
+     */
+    encodeTypedArray(typedArray: ArrayBufferView): string;
+    /**
+     * 解码 TypedArray 对象
+     * @param encodedStr 编码后的字符串
+     * @returns 解码后的 TypedArray 对象
+     */
+    decodeTypedArray(encodedStr: string): ArrayBufferView;
+    /**
+     * 分片编码文件对象
+     * @param file File 对象
+     * @param chunkSize 分片大小，默认 1MB
+     * @returns 包含文件信息和分片数据的可传输对象数组
+     * @throws {MessageCodecError} 当分片编码失败时抛出
+     */
+    encodeFileChunked(file: File, chunkSize?: number): Promise<FileChunk[]>;
+    /**
+     * 解码分片文件对象
+     * @param chunks 编码后的文件分片数组
+     * @returns 重建的File对象
+     * @throws {MessageCodecError} 当分片解码失败或分片不完整时抛出
+     */
+    decodeFileChunked(chunks: FileChunk[]): Promise<File>;
+};
+export {};

package/dist/src/utils/subscribe.d.ts

@@ -0,0 +1,46 @@
+export type Callback = Function;
+export type EventName = string | symbol;
+export type EventItem = {
+    name?: string | symbol;
+    callback: Callback;
+    initialCallback?: Callback;
+};
+export declare const NEW_LISTENER = "NEW_LISTENER";
+export declare class SyncHook {
+    readonly _events: Map<EventName, Set<EventItem>>;
+    /**
+     * @description: 订阅事件
+     * @param {EventName} eventName
+     * @param {EventItem} eventItem
+     * @return {void}
+     */
+    tap: (eventName: EventName, eventItem: EventItem | Callback) => this;
+    /**
+     * @description: 触发事件
+     * @param {EventName} eventName
+     * @param {array} args
+     * @return {void}
+     */
+    call: (eventName: EventName, ...args: Array<unknown>) => this;
+    /**
+     * @description: 同步触发事件
+     * @param {EventName} eventName
+     * @param {array} args
+     * @return {Promise<void>}
+     */
+    callSync: (eventName: EventName, ...args: Array<unknown>) => Promise<this>;
+    /**
+     * @description: 只订阅一次事件，触发后就移除事件
+     * @param {EventName} eventName
+     * @param {EventItem} eventItem
+     * @return {void}
+     */
+    once: (eventName: EventName, eventItem: EventItem | Callback) => this;
+    /**
+     * @description: 移除订阅的事件
+     * @param {EventName} eventName
+     * @param {EventItem} eventItem
+     * @return {void}
+     */
+    off: (eventName: EventName, eventItem: EventItem | Callback) => this;
+}

package/dist/src/utils/throttle.d.ts

@@ -0,0 +1,15 @@
+type ThrottleFunc<T extends (...args: any[]) => void> = (...args: Parameters<T>) => any;
+/**
+ * @description: 节流
+ * @param {any} fn
+ * @param {*} wait
+ * @return {*}
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, delay?: number): ThrottleFunc<T>;
+/**
+ * @description: 生成节流函数
+ * @param {*} Function
+ * @return {*}
+ */
+export declare const generateThrottle: () => Function;
+export {};

package/dist/src/utils/time.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @description: 时间戳转日期
+ * @param {*} timestamp
+ * @param {*} returnType
+ * @return {*}
+ */
+export declare function timestampToTime(timestamp?: number | string): Date & {
+    format?: Function;
+};
+/**
+ * @description: 时间秒，转化成:分割的时间
+ * @param {number} time
+ * @return {*}
+ */
+export declare const timeFormat: (time: number) => string;
+/**
+ * @description: 获取当前时间戳
+ * @return {*}
+ */
+export declare const performanceTime: () => number;