xxf_react 0.6.3 → 0.6.4

package/dist/flow/{promise_ext.d.ts → PromiseExt.d.ts}

@@ -5,4 +5,4 @@ declare global {
 }
 export declare function isSafariLoadFailed(error: unknown): boolean;
 export declare function initPromiseErrorExtension(): void;
-//# sourceMappingURL=promise_ext.d.ts.map
+//# sourceMappingURL=PromiseExt.d.ts.map

package/dist/flow/PromiseExt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseExt.d.ts","sourceRoot":"","sources":["../../src/flow/PromiseExt.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,OAAO,CAAC,CAAC;QACf,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;KACjE;CACJ;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAgDhD"}

package/dist/flow/PromiseLifecycle.d.ts

@@ -0,0 +1,33 @@
+export interface PromiseLifecycle<T> {
+    /** 开始执行时（同步调用） */
+    doOnStart?: () => void;
+    /** 成功时 */
+    doOnSuccess?: (value: T) => void;
+    /** 失败时 */
+    doOnError?: (error: unknown) => void;
+    /** 无论成功失败都会调用（类似 doFinally） */
+    doFinally?: () => void;
+}
+/**
+ * 为 Promise 添加生命周期钩子
+ *
+ * @param promiseFn - 返回 Promise 的函数（使用回调形式以确保 doOnStart 在 Promise 执行前调用）
+ * @param lifecycle - 生命周期回调配置
+ * @returns 原始 Promise 的结果
+ *
+ * @example
+ * ```ts
+ * // 基本用法：管理 loading 状态
+ * withLifecycle(
+ *   () => fetchUserData(userId),
+ *   {
+ *     doOnStart: () => setLoading(true),
+ *     doOnSuccess: (user) => setUser(user),
+ *     doOnError: (err) => setError(err.message),
+ *     doFinally: () => setLoading(false)
+ *   }
+ * );
+ * ```
+ */
+export declare function withLifecycle<T>(promiseFn: () => Promise<T>, lifecycle: PromiseLifecycle<T>): Promise<T>;
+//# sourceMappingURL=PromiseLifecycle.d.ts.map

package/dist/flow/PromiseLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseLifecycle.d.ts","sourceRoot":"","sources":["../../src/flow/PromiseLifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,CAAC;IAC/B,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,UAAU;IACV,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACjC,UAAU;IACV,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC3B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC,CAiBZ"}

package/dist/flow/PromiseLifecycle.js

@@ -0,0 +1,37 @@
+/**
+ * 为 Promise 添加生命周期钩子
+ *
+ * @param promiseFn - 返回 Promise 的函数（使用回调形式以确保 doOnStart 在 Promise 执行前调用）
+ * @param lifecycle - 生命周期回调配置
+ * @returns 原始 Promise 的结果
+ *
+ * @example
+ * ```ts
+ * // 基本用法：管理 loading 状态
+ * withLifecycle(
+ *   () => fetchUserData(userId),
+ *   {
+ *     doOnStart: () => setLoading(true),
+ *     doOnSuccess: (user) => setUser(user),
+ *     doOnError: (err) => setError(err.message),
+ *     doFinally: () => setLoading(false)
+ *   }
+ * );
+ * ```
+ */
+export function withLifecycle(promiseFn, lifecycle) {
+    const { doOnStart, doOnSuccess, doOnError, doFinally } = lifecycle;
+    doOnStart === null || doOnStart === void 0 ? void 0 : doOnStart();
+    return promiseFn()
+        .then((value) => {
+        doOnSuccess === null || doOnSuccess === void 0 ? void 0 : doOnSuccess(value);
+        return value;
+    })
+        .catch((error) => {
+        doOnError === null || doOnError === void 0 ? void 0 : doOnError(error);
+        throw error; // 继续抛出，不吞掉错误
+    })
+        .finally(() => {
+        doFinally === null || doFinally === void 0 ? void 0 : doFinally();
+    });
+}

package/dist/flow/PromiseLoading.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 为 Promise 自动绑定 loading 状态
+ *
+ * @param promiseFn - 返回 Promise 的函数
+ * @param setLoading - React 的 setState 函数，用于设置 loading 状态
+ * @returns 原始 Promise 的结果
+ *
+ * @example
+ * ```tsx
+ * const [loading, setLoading] = useState(false);
+ *
+ * // 自动管理 loading 状态
+ * const handleSubmit = () => {
+ *   withLoading(() => submitForm(data), setLoading);
+ * };
+ *
+ * // 等价于
+ * withLifecycle(() => submitForm(data), {
+ *   doOnStart: () => setLoading(true),
+ *   doFinally: () => setLoading(false)
+ * });
+ * ```
+ */
+export declare function withLoading<T>(promiseFn: () => Promise<T>, setLoading: (loading: boolean) => void): Promise<T>;
+//# sourceMappingURL=PromiseLoading.d.ts.map

package/dist/flow/PromiseLoading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromiseLoading.d.ts","sourceRoot":"","sources":["../../src/flow/PromiseLoading.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EACzB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GACvC,OAAO,CAAC,CAAC,CAAC,CAKZ"}

package/dist/flow/PromiseLoading.js

@@ -0,0 +1,30 @@
+import { withLifecycle } from "./PromiseLifecycle";
+/**
+ * 为 Promise 自动绑定 loading 状态
+ *
+ * @param promiseFn - 返回 Promise 的函数
+ * @param setLoading - React 的 setState 函数，用于设置 loading 状态
+ * @returns 原始 Promise 的结果
+ *
+ * @example
+ * ```tsx
+ * const [loading, setLoading] = useState(false);
+ *
+ * // 自动管理 loading 状态
+ * const handleSubmit = () => {
+ *   withLoading(() => submitForm(data), setLoading);
+ * };
+ *
+ * // 等价于
+ * withLifecycle(() => submitForm(data), {
+ *   doOnStart: () => setLoading(true),
+ *   doFinally: () => setLoading(false)
+ * });
+ * ```
+ */
+export function withLoading(promiseFn, setLoading) {
+    return withLifecycle(promiseFn, {
+        doOnStart: () => setLoading(true),
+        doFinally: () => setLoading(false)
+    });
+}

package/dist/flow/index.d.ts

@@ -1,2 +1,4 @@
-export * from './promise_ext';
+export * from './PromiseExt';
+export * from './PromiseLifecycle';
+export * from './PromiseLoading';
 //# sourceMappingURL=index.d.ts.map

package/dist/flow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/flow/index.js

@@ -1 +1,3 @@
-export * from './promise_ext';
+export * from './PromiseExt';
+export * from './PromiseLifecycle';
+export * from './PromiseLoading';

package/dist/index.js

@@ -1,4 +1,4 @@
-import { initPromiseErrorExtension } from "./flow/promise_ext";
+import { initPromiseErrorExtension } from "./flow/PromiseExt";
 export * from './sse';
 export * from './fetch';
 export * from './utils';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xxf_react",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "private": false,
   "type": "module",
   "main": "dist/index.js",

package/dist/flow/promise_ext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"promise_ext.d.ts","sourceRoot":"","sources":["../../src/flow/promise_ext.ts"],"names":[],"mappings":"AAIA,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,OAAO,CAAC,CAAC;QACf,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;KACjE;CACJ;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAgDhD"}