@taicode/common-web 1.1.15 → 1.1.17

package/output/cache-api/cache-api.d.ts

@@ -1,7 +1,7 @@
 type ApiFunc<P extends unknown[], R = unknown> = (...args: P) => Promise<R>;
 export declare class CacheApi<P extends unknown[], R> {
     private func;
-    private cache;
+    private readonly cache;
     private lastArgs;
     private accessor pendingRequests;
     constructor(func: ApiFunc<P, R>);
@@ -14,6 +14,10 @@ export declare class CacheApi<P extends unknown[], R> {
      * @param force 强制刷新，清除缓存
      */
     refresh(force?: boolean): Promise<R>;
+    /**
+     * 重置缓存和状态
+     */
+    reset(): Promise<void>;
 }
 export {};
 //# sourceMappingURL=cache-api.d.ts.map

package/output/cache-api/cache-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-api.d.ts","sourceRoot":"","sources":["../../source/cache-api/cache-api.ts"],"names":[],"mappings":"AAKA,KAAK,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAE3E,qBAAa,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC;IAU9B,OAAO,CAAC,IAAI;IATxB,OAAO,CAAC,KAAK,CAAqB;IAGlC,OAAO,CAAC,QAAQ,CAAe;IAI/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAI;gBAEhB,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAIvC,IACI,OAAO,IAAI,OAAO,CAErB;IAED,IACI,KAAK,IAAI,OAAO,CAEnB;IAED,IACI,KAAK,IAAI,CAAC,GAAG,SAAS,CAEzB;IAGK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuBlC;;;OAGG;IAEG,OAAO,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,CAAC,CAAC;CAalD"}
+{"version":3,"file":"cache-api.d.ts","sourceRoot":"","sources":["../../source/cache-api/cache-api.ts"],"names":[],"mappings":"AAKA,KAAK,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;AAE3E,qBAAa,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC;IAW9B,OAAO,CAAC,IAAI;IATxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAG3C,OAAO,CAAC,QAAQ,CAAe;IAI/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAI;gBAEhB,IAAI,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAIvC,IACI,OAAO,IAAI,OAAO,CAErB;IAED,IACI,KAAK,IAAI,OAAO,CAEnB;IAED,IACI,KAAK,IAAI,CAAC,GAAG,SAAS,CAEzB;IAGK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAuBlC;;;OAGG;IAEG,OAAO,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,CAAC,CAAC;IAcjD;;OAEG;IAEG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/output/cache-api/cache-api.js

@@ -43,12 +43,12 @@ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
     return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
 };
-import { action, computed, observable } from 'mobx';
+import { action, computed, observable, when } from 'mobx';
 import { catchIt } from '@taicode/common-base';
 import { SideCache } from '../side-cache';
 let CacheApi = (() => {
     var _a, _CacheApi_pendingRequests_accessor_storage;
-    var _b, _c;
+    var _b, _c, _d;
     let _instanceExtraInitializers = [];
     let _pendingRequests_decorators;
     let _pendingRequests_initializers = [];
@@ -58,6 +58,7 @@ let CacheApi = (() => {
     let _get_value_decorators;
     let _call_decorators;
     let _refresh_decorators;
+    let _reset_decorators;
     return _a = class CacheApi {
             // 记录当前正在进行的请求数量
             get pendingRequests() { return __classPrivateFieldGet(this, _CacheApi_pendingRequests_accessor_storage, "f"); }
@@ -111,6 +112,14 @@ let CacheApi = (() => {
                 // 重新调用最近一次的参数
                 return await this.call(...this.lastArgs);
             }
+            /**
+             * 重置缓存和状态
+             */
+            async reset() {
+                await when(() => this.pendingRequests === 0);
+                this.lastArgs = undefined;
+                this.cache.clear();
+            }
         },
         _CacheApi_pendingRequests_accessor_storage = new WeakMap(),
         (() => {
@@ -121,12 +130,14 @@ let CacheApi = (() => {
             _get_value_decorators = [computed];
             _call_decorators = [(_b = action).bound.bind(_b)];
             _refresh_decorators = [(_c = action).bound.bind(_c)];
+            _reset_decorators = [(_d = action).bound.bind(_d)];
             __esDecorate(_a, null, _pendingRequests_decorators, { kind: "accessor", name: "pendingRequests", static: false, private: false, access: { has: obj => "pendingRequests" in obj, get: obj => obj.pendingRequests, set: (obj, value) => { obj.pendingRequests = value; } }, metadata: _metadata }, _pendingRequests_initializers, _pendingRequests_extraInitializers);
             __esDecorate(_a, null, _get_loading_decorators, { kind: "getter", name: "loading", static: false, private: false, access: { has: obj => "loading" in obj, get: obj => obj.loading }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(_a, null, _get_empty_decorators, { kind: "getter", name: "empty", static: false, private: false, access: { has: obj => "empty" in obj, get: obj => obj.empty }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(_a, null, _get_value_decorators, { kind: "getter", name: "value", static: false, private: false, access: { has: obj => "value" in obj, get: obj => obj.value }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(_a, null, _call_decorators, { kind: "method", name: "call", static: false, private: false, access: { has: obj => "call" in obj, get: obj => obj.call }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(_a, null, _refresh_decorators, { kind: "method", name: "refresh", static: false, private: false, access: { has: obj => "refresh" in obj, get: obj => obj.refresh }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _reset_decorators, { kind: "method", name: "reset", static: false, private: false, access: { has: obj => "reset" in obj, get: obj => obj.reset }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         })(),
         _a;

package/output/cache-api/cache-api.test.js

@@ -446,4 +446,165 @@ describe('CacheApi', () => {
             expect(noParamMockFunc).toHaveBeenCalledTimes(2);
         });
     });
+    describe('reset 方法', () => {
+        it('应该清除所有缓存数据', async () => {
+            mockApiFunc.mockResolvedValue('test-result');
+            // 先调用 API 产生缓存
+            await cacheApi.call('param1', 123);
+            expect(cacheApi.value).toBe('test-result');
+            expect(cacheApi.empty).toBe(false);
+            // 重置
+            await cacheApi.reset();
+            // 验证缓存被清除
+            expect(cacheApi.value).toBeUndefined();
+            expect(cacheApi.empty).toBe(true);
+        });
+        it('应该清除 lastArgs 参数记录', async () => {
+            mockApiFunc.mockResolvedValue('test-result');
+            // 先调用 API
+            await cacheApi.call('param1', 123);
+            // 重置
+            await cacheApi.reset();
+            // 尝试刷新应该抛出错误，因为 lastArgs 已被清除
+            await expect(cacheApi.refresh()).rejects.toThrow('没有可用的参数来刷新数据，请先调用 call 方法');
+        });
+        it('应该在没有任何调用时也能正常重置', async () => {
+            // 直接重置，不应该抛出错误
+            await expect(cacheApi.reset()).resolves.toBeUndefined();
+            // 验证状态
+            expect(cacheApi.value).toBeUndefined();
+            expect(cacheApi.empty).toBe(true);
+            expect(cacheApi.loading).toBe(false);
+        });
+        it('应该等待所有进行中的请求完成后再重置', async () => {
+            let resolveFn;
+            const promise = new Promise((resolve) => {
+                resolveFn = resolve;
+            });
+            mockApiFunc.mockReturnValue(promise);
+            // 启动一个异步请求
+            const callPromise = cacheApi.call('test', 1);
+            expect(cacheApi.loading).toBe(true);
+            // 开始重置（应该等待请求完成）
+            const resetPromise = cacheApi.reset();
+            // 此时请求还在进行中，缓存应该还有值
+            await new Promise(resolve => setTimeout(resolve, 10));
+            // 完成请求
+            resolveFn('result');
+            await callPromise;
+            // 等待重置完成
+            await resetPromise;
+            // 验证重置后的状态
+            expect(cacheApi.value).toBeUndefined();
+            expect(cacheApi.empty).toBe(true);
+            expect(cacheApi.loading).toBe(false);
+        });
+        it('应该等待多个并发请求都完成后再重置', async () => {
+            const resolvers = [];
+            mockApiFunc.mockImplementation((param) => {
+                return new Promise((resolve) => {
+                    resolvers.push((value) => resolve(`${param}-${value}`));
+                });
+            });
+            // 启动三个并发请求
+            const promise1 = cacheApi.call('req1', 1);
+            const promise2 = cacheApi.call('req2', 2);
+            const promise3 = cacheApi.call('req3', 3);
+            expect(cacheApi.loading).toBe(true);
+            // 开始重置
+            const resetPromise = cacheApi.reset();
+            // 等待一下
+            await new Promise(resolve => setTimeout(resolve, 10));
+            // 依次完成所有请求
+            resolvers[0]('result1');
+            await promise1;
+            resolvers[1]('result2');
+            await promise2;
+            resolvers[2]('result3');
+            await promise3;
+            // 等待重置完成
+            await resetPromise;
+            // 验证重置后的状态
+            expect(cacheApi.value).toBeUndefined();
+            expect(cacheApi.empty).toBe(true);
+            expect(cacheApi.loading).toBe(false);
+        });
+        it('应该在请求失败后也能正常重置', async () => {
+            const error = new Error('API Error');
+            mockApiFunc.mockRejectedValue(error);
+            // 调用失败的请求
+            try {
+                await cacheApi.call('test', 1);
+            }
+            catch (e) {
+                // 忽略错误
+            }
+            // 重置应该成功
+            await expect(cacheApi.reset()).resolves.toBeUndefined();
+            // 验证状态
+            expect(cacheApi.value).toBeUndefined();
+            expect(cacheApi.empty).toBe(true);
+            expect(cacheApi.loading).toBe(false);
+        });
+        it('重置后应该能够正常调用新的请求', async () => {
+            mockApiFunc.mockResolvedValueOnce('first-result');
+            mockApiFunc.mockResolvedValueOnce('second-result');
+            // 第一次调用
+            await cacheApi.call('param1', 123);
+            expect(cacheApi.value).toBe('first-result');
+            // 重置
+            await cacheApi.reset();
+            expect(cacheApi.value).toBeUndefined();
+            // 重置后再次调用
+            await cacheApi.call('param2', 456);
+            expect(cacheApi.value).toBe('second-result');
+            expect(cacheApi.empty).toBe(false);
+        });
+        it('重置后 refresh 应该需要先调用 call', async () => {
+            mockApiFunc.mockResolvedValue('test-result');
+            // 先调用并刷新
+            await cacheApi.call('test', 1);
+            await cacheApi.refresh();
+            // 重置
+            await cacheApi.reset();
+            // 重置后 refresh 应该抛出错误
+            await expect(cacheApi.refresh()).rejects.toThrow('没有可用的参数来刷新数据，请先调用 call 方法');
+        });
+        it('应该正确处理重置期间的 loading 状态', async () => {
+            let resolveFn;
+            const promise = new Promise((resolve) => {
+                resolveFn = resolve;
+            });
+            mockApiFunc.mockReturnValue(promise);
+            // 启动请求
+            const callPromise = cacheApi.call('test', 1);
+            expect(cacheApi.loading).toBe(true);
+            // 启动重置（会等待请求完成）
+            const resetPromise = cacheApi.reset();
+            // loading 应该还是 true
+            expect(cacheApi.loading).toBe(true);
+            // 完成请求
+            resolveFn('result');
+            await callPromise;
+            // loading 变为 false
+            expect(cacheApi.loading).toBe(false);
+            // 等待重置完成
+            await resetPromise;
+            // 重置后 loading 应该仍然是 false
+            expect(cacheApi.loading).toBe(false);
+        });
+        it('应该清除所有缓存的 key', async () => {
+            mockApiFunc.mockResolvedValue('result');
+            // 调用多次产生多个缓存
+            await cacheApi.call('param1', 1);
+            await cacheApi.call('param2', 2);
+            await cacheApi.call('param3', 3);
+            expect(cacheApi.empty).toBe(false);
+            // 重置
+            await cacheApi.reset();
+            // 验证所有缓存都被清除
+            expect(cacheApi.empty).toBe(true);
+            expect(cacheApi.value).toBeUndefined();
+        });
+    });
 });

package/output/size-provider/index.d.ts

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

package/output/size-provider/index.d.ts.map

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

package/output/size-provider/index.js

@@ -0,0 +1 @@
+export { SizeProvider } from './size-provider';

package/output/size-provider/size-provider.d.ts

@@ -0,0 +1,9 @@
+import React, { ReactNode } from 'react';
+interface SizeProviderProps {
+    className?: string;
+    render?: (width: number, height: number) => ReactNode;
+    children?: (width: number, height: number) => ReactNode;
+}
+export declare const SizeProvider: React.FC<SizeProviderProps>;
+export {};
+//# sourceMappingURL=size-provider.d.ts.map

package/output/size-provider/size-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"size-provider.d.ts","sourceRoot":"","sources":["../../source/size-provider/size-provider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAA+B,SAAS,EAAE,MAAM,OAAO,CAAA;AAErE,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,CAAA;IACrD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,CAAA;CACxD;AAED,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuCpD,CAAA"}

package/output/size-provider/size-provider.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import clsx from 'clsx';
+import { useRef, useState, useEffect } from 'react';
+export const SizeProvider = (props) => {
+    const { children, className } = props;
+    const [width, setWidth] = useState(0);
+    const [height, setHeight] = useState(0);
+    const sizeRef = useRef(null);
+    useEffect(() => {
+        const resizeObserver = new ResizeObserver((entries) => {
+            for (const entry of entries) {
+                const { width, height } = entry.contentRect;
+                setWidth(width);
+                setHeight(height);
+            }
+        });
+        if (sizeRef.current) {
+            resizeObserver.observe(sizeRef.current);
+        }
+        return () => {
+            if (sizeRef.current) {
+                // eslint-disable-next-line react-hooks/exhaustive-deps
+                resizeObserver.unobserve(sizeRef.current);
+            }
+        };
+    }, []);
+    const render = props.render || children || null;
+    return (_jsxs("div", { className: clsx(className, 'relative w-full h-full overflow-hidden isolate'), children: [_jsx("div", { ref: sizeRef, className: 'absolute flex-shrink-0 w-full h-full z-0 opacity-0', children: "SizeProvider" }), _jsx("div", { className: 'absolute w-full h-full z-1', children: render === null || render === void 0 ? void 0 : render(width, height) })] }));
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taicode/common-web",
-  "version": "1.1.15",
+  "version": "1.1.17",
   "author": "Alain",
   "license": "ISC",
   "description": "",