@taicode/common-base 1.1.0 → 1.1.2

package/output/number/index.js

@@ -0,0 +1 @@
+export * from './number';

package/output/number/number.d.ts

@@ -0,0 +1,2 @@
+export declare function bigintToNumber(value: bigint | null): number;
+//# sourceMappingURL=number.d.ts.map

package/output/number/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../source/number/number.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAwB3D"}

package/output/number/number.js

@@ -0,0 +1,23 @@
+export function bigintToNumber(value) {
+    if (value === null)
+        return 0;
+    // JavaScript 的 number 类型最大值
+    const MAX_SAFE_INTEGER = Number.MAX_SAFE_INTEGER; // 2^53 - 1
+    const MIN_SAFE_INTEGER = Number.MIN_SAFE_INTEGER; // -(2^53 - 1)
+    try {
+        // 检查输入是否为 bigint
+        if (typeof value !== 'bigint') {
+            throw new TypeError('Input must be a bigint');
+        }
+        // 检查是否溢出
+        if (value > BigInt(MAX_SAFE_INTEGER) || value < BigInt(MIN_SAFE_INTEGER)) {
+            return MAX_SAFE_INTEGER; // 溢出，返回 NaN
+        }
+        // 将 bigint 转换为 number
+        return Number(value);
+    }
+    catch {
+        // 捕获任何错误并返回 NaN
+        return 0;
+    }
+}

package/output/number/number.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=number.test.d.ts.map

package/output/number/number.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.test.d.ts","sourceRoot":"","sources":["../../source/number/number.test.ts"],"names":[],"mappings":""}

package/output/number/number.test.js

@@ -0,0 +1,50 @@
+import { describe, it, expect } from 'vitest';
+import { bigintToNumber } from './number';
+describe('bigintToNumber 函数', () => {
+    it('应该将小的 bigint 转换为 number', () => {
+        const result = bigintToNumber(123n);
+        expect(result).toBe(123);
+    });
+    it('应该将负数 bigint 转换为 number', () => {
+        const result = bigintToNumber(-456n);
+        expect(result).toBe(-456);
+    });
+    it('应该将零 bigint 转换为 number', () => {
+        const result = bigintToNumber(0n);
+        expect(result).toBe(0);
+    });
+    it('应该为 null 输入返回 0', () => {
+        const result = bigintToNumber(null);
+        expect(result).toBe(0);
+    });
+    it('应该处理 MAX_SAFE_INTEGER 的 bigint', () => {
+        const maxSafe = BigInt(Number.MAX_SAFE_INTEGER);
+        const result = bigintToNumber(maxSafe);
+        expect(result).toBe(Number.MAX_SAFE_INTEGER);
+    });
+    it('应该处理 MIN_SAFE_INTEGER 的 bigint', () => {
+        const minSafe = BigInt(Number.MIN_SAFE_INTEGER);
+        const result = bigintToNumber(minSafe);
+        expect(result).toBe(Number.MIN_SAFE_INTEGER);
+    });
+    it('应该为 bigint 溢出（正数）返回 MAX_SAFE_INTEGER', () => {
+        const tooBig = BigInt(Number.MAX_SAFE_INTEGER) + 1n;
+        const result = bigintToNumber(tooBig);
+        expect(result).toBe(Number.MAX_SAFE_INTEGER);
+    });
+    it('应该为 bigint 溢出（负数）返回 MAX_SAFE_INTEGER', () => {
+        const tooSmall = BigInt(Number.MIN_SAFE_INTEGER) - 1n;
+        const result = bigintToNumber(tooSmall);
+        expect(result).toBe(Number.MAX_SAFE_INTEGER);
+    });
+    it('应该处理非常大的 bigint', () => {
+        const veryLarge = 999999999999999999999n;
+        const result = bigintToNumber(veryLarge);
+        expect(result).toBe(Number.MAX_SAFE_INTEGER);
+    });
+    it('应该处理从 number 创建的 bigint', () => {
+        const bigintFromNumber = BigInt(42);
+        const result = bigintToNumber(bigintFromNumber);
+        expect(result).toBe(42);
+    });
+});

package/output/object/index.d.ts

@@ -0,0 +1,2 @@
+export * from './object';
+//# sourceMappingURL=index.d.ts.map

package/output/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/object/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}

package/output/object/index.js

@@ -0,0 +1 @@
+export * from './object';

package/output/object/object.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 递归合并对象，只针对对象类型的属性进行合并，其他类型后者覆盖前者
+ */
+export declare function objectMerge<T extends object>(target: T, ...rest: Partial<T>[]): T;
+export declare function ObjectKeys<T extends object>(obj: T): (keyof T)[];
+export declare function ObjectValues<T extends object>(obj: T): T[keyof T][];
+//# sourceMappingURL=object.d.ts.map

package/output/object/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../source/object/object.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAiBjF;AAED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAEhE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAEnE"}

package/output/object/object.js

@@ -0,0 +1,27 @@
+/**
+ * 递归合并对象，只针对对象类型的属性进行合并，其他类型后者覆盖前者
+ */
+export function objectMerge(target, ...rest) {
+    for (const source of rest) {
+        for (const key in source) {
+            if (source.hasOwnProperty(key)) {
+                if (typeof source[key] === 'object' && source[key] !== null && !Array.isArray(source[key])) {
+                    if (!target.hasOwnProperty(key)) {
+                        target[key] = {};
+                    }
+                    objectMerge(target[key], source[key]);
+                }
+                else {
+                    target[key] = source[key];
+                }
+            }
+        }
+    }
+    return target;
+}
+export function ObjectKeys(obj) {
+    return Object.keys(obj);
+}
+export function ObjectValues(obj) {
+    return Object.values(obj);
+}

package/output/object/object.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=object.test.d.ts.map

package/output/object/object.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.test.d.ts","sourceRoot":"","sources":["../../source/object/object.test.ts"],"names":[],"mappings":""}

package/output/object/object.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { objectMerge } from './object';
+describe('merge 函数', () => {
+    it('应该合并两个简单对象', () => {
+        const target = { a: 1 };
+        const source = { b: 2 };
+        const result = objectMerge(target, source);
+        expect(result).toEqual({ a: 1, b: 2 });
+    });
+    it('应该合并嵌套对象', () => {
+        const target = { a: 1, b: { c: 2 } };
+        const source = { b: { d: 3 }, e: 4 };
+        const result = objectMerge(target, source);
+        expect(result).toEqual({ a: 1, b: { c: 2, d: 3 }, e: 4 });
+    });
+    it('应该合并多个对象', () => {
+        const target = { a: 1 };
+        const source1 = { b: 2 };
+        const source2 = { c: 3 };
+        const result = objectMerge(target, source1, source2);
+        expect(result).toEqual({ a: 1, b: 2, c: 3 });
+    });
+    it('应该覆盖现有属性', () => {
+        const target = { a: 1, b: 2 };
+        const source = { b: 3, c: 4 };
+        const result = objectMerge(target, source);
+        expect(result).toEqual({ a: 1, b: 3, c: 4 });
+    });
+    it('应该处理 null 和数组值', () => {
+        const target = { a: 1, b: null };
+        const source = { b: [1, 2, 3], c: 4 };
+        const result = objectMerge(target, source);
+        expect(result).toEqual({ a: 1, b: [1, 2, 3], c: 4 });
+    });
+    it('应该不改变原始目标对象', () => {
+        const target = { a: 1 };
+        const source = { b: 2 };
+        const result = objectMerge(target, source);
+        expect(result).toEqual({ a: 1, b: 2 });
+        expect(source).toEqual({ b: 2 }); // Target should remain unchanged
+    });
+});

package/output/service/index.d.ts

@@ -0,0 +1,2 @@
+export { Service } from './service';
+//# sourceMappingURL=index.d.ts.map

package/output/service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

package/output/service/index.js

@@ -0,0 +1 @@
+export { Service } from './service';

package/output/service/service.d.ts

@@ -0,0 +1,6 @@
+/** */
+export declare abstract class Service {
+    abstract inited: boolean;
+    abstract init(): Promise<boolean>;
+}
+//# sourceMappingURL=service.d.ts.map

package/output/service/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../source/service/service.ts"],"names":[],"mappings":"AAAA,MAAM;AACN,8BAAsB,OAAO;IAC3B,SAAgB,MAAM,EAAE,OAAO,CAAA;aACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;CACzC"}

package/output/service/service.js

@@ -0,0 +1,3 @@
+/** */
+export class Service {
+}

package/output/string/index.d.ts

@@ -0,0 +1,2 @@
+export * from './string';
+//# sourceMappingURL=index.d.ts.map

package/output/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/string/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA"}

package/output/string/index.js

@@ -0,0 +1 @@
+export * from './string';

package/output/string/string.d.ts

@@ -0,0 +1,3 @@
+/** 生成随机字符串，可以指定字符集和长度 */
+export declare function randomString(length: number, charset?: string): string;
+//# sourceMappingURL=string.d.ts.map

package/output/string/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../source/string/string.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,MAAyE,GAAG,MAAM,CAOvI"}

package/output/string/string.js

@@ -0,0 +1,9 @@
+/** 生成随机字符串，可以指定字符集和长度 */
+export function randomString(length, charset = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789') {
+    let result = '';
+    const charsetLength = charset.length;
+    for (let i = 0; i < length; i++) {
+        result += charset.charAt(Math.floor(Math.random() * charsetLength));
+    }
+    return result;
+}

package/output/string/string.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=string.test.d.ts.map

package/output/string/string.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.test.d.ts","sourceRoot":"","sources":["../../source/string/string.test.ts"],"names":[],"mappings":""}

package/output/string/string.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { randomString } from './string';
+describe('randomString 函数', () => {
+    beforeEach(() => {
+        // 重置随机数生成器的模拟
+        vi.clearAllMocks();
+    });
+    it('应该生成指定长度的字符串', () => {
+        const result = randomString(10);
+        expect(result).toHaveLength(10);
+    });
+    it('应该为零长度生成空字符串', () => {
+        const result = randomString(0);
+        expect(result).toBe('');
+    });
+    it('应该在未指定时使用默认字符集', () => {
+        const result = randomString(100);
+        const defaultCharset = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        // 检查结果只包含默认字符集中的字符
+        for (const char of result) {
+            expect(defaultCharset).toContain(char);
+        }
+    });
+    it('应该在提供时使用自定义字符集', () => {
+        const customCharset = '123';
+        const result = randomString(10, customCharset);
+        // 检查结果只包含自定义字符集中的字符
+        for (const char of result) {
+            expect(customCharset).toContain(char);
+        }
+    });
+    it('应该在多次调用时生成不同的字符串', () => {
+        const result1 = randomString(20);
+        const result2 = randomString(20);
+        // 虽然理论上可能相同，但实际上几乎不可能
+        expect(result1).not.toBe(result2);
+    });
+    it('应该对单字符字符集正常工作', () => {
+        const result = randomString(5, 'A');
+        expect(result).toBe('AAAAA');
+    });
+    it('应该对字符集中的特殊字符正常工作', () => {
+        const specialCharset = '!@#$%^&*()';
+        const result = randomString(10, specialCharset);
+        expect(result).toHaveLength(10);
+        // 检查结果只包含特殊字符集中的字符
+        for (const char of result) {
+            expect(specialCharset).toContain(char);
+        }
+    });
+    it('应该对字符集中的Unicode字符正常工作', () => {
+        const unicodeCharset = '你好世界🎉';
+        const result = randomString(5, unicodeCharset);
+        expect(result).toHaveLength(5);
+        // 检查结果只包含Unicode字符集中的字符
+        for (const char of result) {
+            expect(unicodeCharset).toContain(char);
+        }
+    });
+    it('应该处理大长度值', () => {
+        const result = randomString(1000);
+        expect(result).toHaveLength(1000);
+    });
+    it('应该对固定的Math.random具有确定性', () => {
+        // 模拟Math.random返回固定值
+        const mockRandom = vi.spyOn(Math, 'random');
+        mockRandom.mockReturnValueOnce(0); // 第一个字符
+        mockRandom.mockReturnValueOnce(0.5); // 第二个字符
+        const charset = 'ABC';
+        const result = randomString(2, charset);
+        // 基于模拟的随机值，应该返回特定的字符
+        // Math.floor(0 * 3) = 0 -> 'A'
+        // Math.floor(0.5 * 3) = 1 -> 'B'
+        expect(result).toBe('AB');
+        mockRandom.mockRestore();
+    });
+});

package/output/throttle/index.d.ts

@@ -0,0 +1,2 @@
+export * from './throttle';
+//# sourceMappingURL=index.d.ts.map

package/output/throttle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../source/throttle/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/output/throttle/index.js

@@ -0,0 +1 @@
+export * from './throttle';

package/output/throttle/throttle.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 节流装饰器 - 基于 TC39 Stage 3 Decorators 提案
+ * 限制函数在指定时间内最多执行一次
+ */
+interface ThrottleOptions {
+    leading?: boolean;
+    trailing?: boolean;
+}
+export declare function throttleFn<T extends (...args: any[]) => any>(fn: T, wait: number, options?: ThrottleOptions): T;
+export declare function throttle<T extends (...args: any[]) => any>(wait: number, options?: ThrottleOptions): (originalMethod: T, context: ClassMethodDecoratorContext) => T;
+export type { ThrottleOptions };
+//# sourceMappingURL=throttle.d.ts.map

package/output/throttle/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../source/throttle/throttle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,eAAe;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAGD,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC1D,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,CAAC,CAuCH;AAGD,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,IAER,gBAAgB,CAAC,EAAE,SAAS,2BAA2B,KAAG,CAAC,CAY7E;AAED,YAAY,EAAE,eAAe,EAAE,CAAA"}

package/output/throttle/throttle.js

@@ -0,0 +1,55 @@
+/**
+ * 节流装饰器 - 基于 TC39 Stage 3 Decorators 提案
+ * 限制函数在指定时间内最多执行一次
+ */
+// 通用节流函数
+export function throttleFn(fn, wait, options = {}) {
+    const { leading = true, trailing = true } = options;
+    let timeout = null;
+    let lastCallTime = 0;
+    let lastArgs;
+    let lastThis;
+    let result;
+    function throttled(...args) {
+        const now = Date.now();
+        // 如果是第一次调用且不允许 leading
+        if (lastCallTime === 0 && !leading) {
+            lastCallTime = now;
+        }
+        const remaining = wait - (now - lastCallTime);
+        lastArgs = args;
+        lastThis = this;
+        if (remaining <= 0 || remaining > wait) {
+            if (timeout) {
+                clearTimeout(timeout);
+                timeout = null;
+            }
+            lastCallTime = now;
+            result = fn.apply(this, args);
+        }
+        else if (!timeout && trailing) {
+            timeout = setTimeout(() => {
+                lastCallTime = leading ? Date.now() : 0;
+                timeout = null;
+                result = fn.apply(lastThis, lastArgs);
+            }, remaining);
+        }
+        return result;
+    }
+    return throttled;
+}
+// TC39 Stage 3 装饰器实现
+export function throttle(wait, options) {
+    return function (originalMethod, context) {
+        let methodKey = context.name;
+        context.addInitializer(function () {
+            const self = this;
+            // 只 patch 原型上的原始方法，避免多层嵌套
+            const descriptor = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(self), methodKey);
+            const method = descriptor?.value ?? originalMethod;
+            const throttledMethod = throttleFn(method.bind(self), wait, options);
+            self[methodKey] = throttledMethod;
+        });
+        return originalMethod;
+    };
+}

package/output/throttle/throttle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=throttle.test.d.ts.map

package/output/throttle/throttle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.test.d.ts","sourceRoot":"","sources":["../../source/throttle/throttle.test.ts"],"names":[],"mappings":""}

package/output/throttle/throttle.test.js

@@ -0,0 +1,177 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { throttle, throttleFn } from './throttle';
+describe('throttle', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.useRealTimers();
+    });
+    describe('throttleFn', () => {
+        it('应该立即执行第一次调用', () => {
+            const mockFn = vi.fn().mockReturnValue('result');
+            const throttledFn = throttleFn(mockFn, 100);
+            const result = throttledFn('arg1', 'arg2');
+            expect(mockFn).toHaveBeenCalledOnce();
+            expect(mockFn).toHaveBeenCalledWith('arg1', 'arg2');
+            expect(result).toBe('result');
+        });
+        it('应该在间隔时间内忽略后续调用', () => {
+            const mockFn = vi.fn().mockReturnValue('result');
+            const throttledFn = throttleFn(mockFn, 100);
+            // 第一次调用应该立即执行
+            throttledFn('first');
+            expect(mockFn).toHaveBeenCalledOnce();
+            // 在间隔时间内的调用应该被忽略
+            throttledFn('second');
+            throttledFn('third');
+            expect(mockFn).toHaveBeenCalledOnce();
+        });
+        it('应该在间隔时间结束后允许新的调用', () => {
+            const mockFn = vi.fn().mockReturnValue('result');
+            const throttledFn = throttleFn(mockFn, 100);
+            // 第一次调用
+            throttledFn('first');
+            expect(mockFn).toHaveBeenCalledOnce();
+            // 推进时间超过间隔
+            vi.advanceTimersByTime(150);
+            // 现在应该允许新的调用
+            throttledFn('second');
+            expect(mockFn).toHaveBeenCalledTimes(2);
+            expect(mockFn).toHaveBeenLastCalledWith('second');
+        });
+        it('应该支持 leading: false 选项', () => {
+            const mockFn = vi.fn().mockReturnValue('result');
+            const throttledFn = throttleFn(mockFn, 100, { leading: false });
+            // 第一次调用不应该立即执行
+            throttledFn('first');
+            expect(mockFn).not.toHaveBeenCalled();
+        });
+        it('应该支持 trailing: true 选项', () => {
+            const mockFn = vi.fn().mockReturnValue('result');
+            const throttledFn = throttleFn(mockFn, 100, { trailing: true });
+            // 第一次调用
+            throttledFn('first');
+            expect(mockFn).toHaveBeenCalledOnce();
+            // 在间隔时间内的调用
+            throttledFn('second');
+            throttledFn('third');
+            // 推进时间，应该执行 trailing 调用
+            vi.advanceTimersByTime(100);
+            expect(mockFn).toHaveBeenCalledTimes(2);
+            expect(mockFn).toHaveBeenLastCalledWith('third');
+        });
+        it('应该支持 trailing: false 选项', () => {
+            const mockFn = vi.fn().mockReturnValue('result');
+            const throttledFn = throttleFn(mockFn, 100, { trailing: false });
+            // 第一次调用
+            throttledFn('first');
+            expect(mockFn).toHaveBeenCalledOnce();
+            // 在间隔时间内的调用
+            throttledFn('second');
+            throttledFn('third');
+            // 推进时间，不应该执行 trailing 调用
+            vi.advanceTimersByTime(100);
+            expect(mockFn).toHaveBeenCalledOnce();
+        });
+        it('应该保持 this 上下文', () => {
+            class TestClass {
+                value = 'test-value';
+                getValue() {
+                    return this.value;
+                }
+            }
+            const instance = new TestClass();
+            const throttledMethod = throttleFn(instance.getValue, 100);
+            const result = throttledMethod.call(instance);
+            expect(result).toBe('test-value');
+        });
+        it('应该返回最后一次执行的结果', () => {
+            const mockFn = vi.fn()
+                .mockReturnValueOnce('first')
+                .mockReturnValueOnce('second');
+            const throttledFn = throttleFn(mockFn, 100);
+            const result1 = throttledFn();
+            expect(result1).toBe('first');
+            // 在间隔时间内，应该返回缓存的结果
+            const result2 = throttledFn();
+            expect(result2).toBe('first');
+            // 推进时间后的新调用
+            vi.advanceTimersByTime(150);
+            const result3 = throttledFn();
+            expect(result3).toBe('second');
+        });
+    });
+    describe('throttle decorator', () => {
+        it('应该装饰类方法', () => {
+            class TestClass {
+                callCount = 0;
+                @throttle(100)
+                increment() {
+                    this.callCount++;
+                    return this.callCount;
+                }
+            }
+            const instance = new TestClass();
+            // 第一次调用应该立即执行
+            const result1 = instance.increment();
+            expect(result1).toBe(1);
+            expect(instance.callCount).toBe(1);
+            // 快速连续调用应该被节流
+            instance.increment();
+            instance.increment();
+            expect(instance.callCount).toBe(1);
+        });
+        it('应该为每个实例独立工作', () => {
+            class TestClass {
+                callCount = 0;
+                @throttle(100)
+                increment() {
+                    this.callCount++;
+                    return this.callCount;
+                }
+            }
+            const instance1 = new TestClass();
+            const instance2 = new TestClass();
+            instance1.increment();
+            instance2.increment();
+            expect(instance1.callCount).toBe(1);
+            expect(instance2.callCount).toBe(1);
+        });
+        it('应该支持带选项的装饰器', () => {
+            class TestClass {
+                callCount = 0;
+                @throttle(100, { leading: false, trailing: true })
+                increment() {
+                    this.callCount++;
+                    return this.callCount;
+                }
+            }
+            const instance = new TestClass();
+            // leading: false，第一次调用不应该立即执行
+            instance.increment();
+            expect(instance.callCount).toBe(0);
+            // trailing: true，应该在延迟后执行
+            vi.advanceTimersByTime(100);
+            expect(instance.callCount).toBe(1);
+        });
+        it('应该处理带参数的方法', () => {
+            class TestClass {
+                lastArgs = [];
+                @throttle(100)
+                saveArgs(...args) {
+                    this.lastArgs = args;
+                    return args.length;
+                }
+            }
+            const instance = new TestClass();
+            const result = instance.saveArgs(1, 2, 3);
+            expect(result).toBe(3);
+            expect(instance.lastArgs).toEqual([1, 2, 3]);
+            // 在间隔时间内的调用应该被忽略
+            instance.saveArgs(4, 5, 6, 7);
+            expect(instance.lastArgs).toEqual([1, 2, 3]); // 应该保持原值
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-base",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "author": "Alain",
   "license": "ISC",
   "description": "",
@@ -23,6 +23,9 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch"
   },
+  "files": [
+    "output"
+  ],
   "devDependencies": {
     "vitest": "^3.2.4"
   }