@cloudcome/utils-vue 1.13.2 → 1.13.3

package/dist/component.mjs

@@ -1,20 +1,111 @@
-import { ref } from "vue";
-import { b, u, a } from "./life.mjs";
-function useExpose(Comp) {
-  return ref(null);
+import { _runLifeHook } from "./shared.mjs";
+import { onActivated, onBeforeMount, onBeforeUnmount, onDeactivated, onMounted, onUnmounted, ref } from "vue";
+//#region src/component/life.ts
+/**
+* 页面挂载前生命周期钩子
+*
+* @param beforeMount - 在组件挂载前执行的回调函数，可以返回一个清理函数
+*
+* @example
+* ```ts
+* useMount(() => {
+*   console.log('组件即将挂载');
+*   // 可以返回一个清理函数，在组件卸载前执行
+*   return () => {
+*     console.log('组件即将卸载');
+*   };
+* });
+* ```
+*/
+function useMount(beforeMount) {
+	_runLifeHook(onBeforeMount, onBeforeUnmount, beforeMount);
 }
-function useEmit(Comp, event, listener) {
-  return listener;
+/**
+* 页面挂载后生命周期钩子
+*
+* @param mounted - 在组件挂载后执行的回调函数，可以返回一个清理函数
+*
+* @example
+* ```ts
+* useMounted(() => {
+*   console.log('组件已挂载');
+*   // 可以返回一个清理函数，在组件卸载前执行
+*   return () => {
+*     console.log('组件即将卸载');
+*   };
+* });
+* ```
+*/
+function useMounted(mounted) {
+	_runLifeHook(onMounted, onUnmounted, mounted);
 }
-function useMethod(Comp, name, method) {
-  return method;
+/**
+* 页面激活时生命周期钩子
+*
+* @param activated - 在组件被激活时执行的回调函数，可以返回一个清理函数
+*
+* @example
+* ```ts
+* useActivated(() => {
+*   console.log('组件已激活');
+*   // 可以返回一个清理函数，在组件失活前执行
+*   return () => {
+*     console.log('组件即将失活');
+*   };
+* });
+* ```
+*/
+function useActivated(activated) {
+	_runLifeHook(onActivated, onDeactivated, activated);
 }
-export {
-  b as useActivated,
-  useEmit,
-  useExpose,
-  useMethod,
-  u as useMount,
-  a as useMounted
-};
-//# sourceMappingURL=component.mjs.map
+//#endregion
+//#region src/component/self.ts
+/**
+* 创建一个响应式引用，用于暴露组件实例
+* @template T 组件类型
+* @param {T} Comp 组件定义
+* @returns 返回一个可响应式访问的组件实例引用
+* @example
+* const compRef = useExpose(MyComponent)
+*/
+function useExpose(_Comp) {
+	return ref(null);
+}
+/**
+* 创建一个组件emit事件监听器
+* @template T 组件类型
+* @template E 从组件props中提取的事件类型
+* @template K 事件名
+* @param {T} Comp 组件定义
+* @param {K} event 事件名称
+* @param {E[K]} listener 事件监听函数
+* @returns {E[K]} 返回传入的事件监听函数
+* @example
+* const handleClick = useEmit(MyComponent, 'click', (payload) => {
+*   console.log('click event', payload)
+* })
+*/
+function useEmit(_Comp, _event, listener) {
+	return listener;
+}
+/**
+* 从组件props中提取方法并返回指定方法
+* @template T 组件类型
+* @template M 从组件props中提取的方法类型
+* @template K 方法名类型
+* @param {T} Comp 组件定义
+* @param {K} name 方法名称
+* @param {M[K]} method 要返回的方法
+* @returns {M[K]} 返回传入的方法
+* @example
+* const handleUpdate = useMethod(MyComponent, 'update', (value) => {
+*   console.log('update value', value)
+* })
+*/
+function useMethod(_Comp, _name, method) {
+	return method;
+}
+//#endregion
+export { useActivated, useEmit, useExpose, useMethod, useMount, useMounted };
+
+//# sourceMappingURL=component.mjs.map

package/dist/component.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"component.mjs","sources":["../src/component/self.ts"],"sourcesContent":["import { type Ref, ref } from 'vue';\nimport type { ComponentExposed, ComponentProps } from 'vue-component-type-helpers';\n\n/**\n * 创建一个响应式引用，用于暴露组件实例\n * @template T 组件类型\n * @param {T} Comp 组件定义\n * @returns 返回一个可响应式访问的组件实例引用\n * @example\n * const compRef = useExpose(MyComponent)\n */\nexport function useExpose<T>(Comp: T) {\n  // 这里必须类型断言，否则构建会失败\n  return ref<ComponentExposed<T> | null>(null) as Ref<ComponentExposed<T> | null>;\n}\n\n/**\n * 将字符串的首字母转换为小写\n * @template S 字符串类型\n * @typedef {S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S} LowercaseFirst\n */\ntype LowercaseFirst<S extends string> = S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S;\n\n/**\n * 从组件props中提取事件类型\n * @template T 组件props类型\n * @typedef {Object} PickEmits\n * @property {Object} [K in keyof T as K extends `on${infer Rest}`...] 转换后的emit事件名\n *   - @property {Function} [...args: P] 事件回调函数\n */\ntype PickEmits<T> = {\n  [K in keyof T as K extends `on${infer Rest}`\n    ? // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n      T[K] extends (...args: any[]) => any\n      ? LowercaseFirst<Rest>\n      : never\n    : // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n      never]: T[K] extends (...args: infer P) => any ? (...args: P) => unknown : never;\n};\n\n/**\n * 创建一个组件emit事件监听器\n * @template T 组件类型\n * @template E 从组件props中提取的事件类型\n * @template K 事件名\n * @param {T} Comp 组件定义\n * @param {K} event 事件名称\n * @param {E[K]} listener 事件监听函数\n * @returns {E[K]} 返回传入的事件监听函数\n * @example\n * const handleClick = useEmit(MyComponent, 'click', (payload) => {\n *   console.log('click event', payload)\n * })\n */\nexport function useEmit<T, E extends PickEmits<Required<ComponentProps<T>>>, K extends keyof E>(\n  Comp: T,\n  event: K,\n  listener: E[K],\n) {\n  return listener;\n}\n\ntype PickMethods<T> = {\n  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n  [K in keyof T]: T[K] extends (...args: infer P) => any ? T[K] : never;\n};\n\n/**\n * 从组件props中提取方法并返回指定方法\n * @template T 组件类型\n * @template M 从组件props中提取的方法类型\n * @template K 方法名类型\n * @param {T} Comp 组件定义\n * @param {K} name 方法名称\n * @param {M[K]} method 要返回的方法\n * @returns {M[K]} 返回传入的方法\n * @example\n * const handleUpdate = useMethod(MyComponent, 'update', (value) => {\n *   console.log('update value', value)\n * })\n */\nexport function useMethod<T, M extends PickMethods<Required<ComponentProps<T>>>, K extends keyof M>(\n  Comp: T,\n  name: K,\n  method: M[K],\n) {\n  return method;\n}\n"],"names":[],"mappings":";;AAWO,SAAS,UAAa,MAAS;AAEpC,SAAO,IAAgC,IAAI;AAC7C;AAwCgB,SAAA,QACd,MACA,OACA,UACA;AACO,SAAA;AACT;AAqBgB,SAAA,UACd,MACA,MACA,QACA;AACO,SAAA;AACT;"}
+{"version":3,"file":"component.mjs","names":[],"sources":["../src/component/life.ts","../src/component/self.ts"],"sourcesContent":["import type { MaybePromise } from '@cloudcome/utils-core/types';\nimport {\n  onActivated,\n  onBeforeMount,\n  onBeforeUnmount,\n  onDeactivated,\n  onMounted,\n  onUnmounted,\n} from 'vue';\nimport { _runLifeHook } from '@/shared';\n\nexport type HookListener = () => MaybePromise<unknown>;\nexport type HookListenerWithDispose = () => MaybePromise<\n  undefined | HookListener\n>;\n\n/**\n * 页面挂载前生命周期钩子\n *\n * @param beforeMount - 在组件挂载前执行的回调函数，可以返回一个清理函数\n *\n * @example\n * ```ts\n * useMount(() => {\n *   console.log('组件即将挂载');\n *   // 可以返回一个清理函数，在组件卸载前执行\n *   return () => {\n *     console.log('组件即将卸载');\n *   };\n * });\n * ```\n */\nexport function useMount(beforeMount: HookListenerWithDispose) {\n  _runLifeHook(onBeforeMount, onBeforeUnmount, beforeMount);\n}\n\n/**\n * 页面挂载后生命周期钩子\n *\n * @param mounted - 在组件挂载后执行的回调函数，可以返回一个清理函数\n *\n * @example\n * ```ts\n * useMounted(() => {\n *   console.log('组件已挂载');\n *   // 可以返回一个清理函数，在组件卸载前执行\n *   return () => {\n *     console.log('组件即将卸载');\n *   };\n * });\n * ```\n */\nexport function useMounted(mounted: HookListenerWithDispose) {\n  _runLifeHook(onMounted, onUnmounted, mounted);\n}\n\n/**\n * 页面激活时生命周期钩子\n *\n * @param activated - 在组件被激活时执行的回调函数，可以返回一个清理函数\n *\n * @example\n * ```ts\n * useActivated(() => {\n *   console.log('组件已激活');\n *   // 可以返回一个清理函数，在组件失活前执行\n *   return () => {\n *     console.log('组件即将失活');\n *   };\n * });\n * ```\n */\nexport function useActivated(activated: HookListenerWithDispose) {\n  _runLifeHook(onActivated, onDeactivated, activated);\n}\n","import { type Ref, ref } from 'vue';\nimport type {\n  ComponentExposed,\n  ComponentProps,\n} from 'vue-component-type-helpers';\n\n/**\n * 创建一个响应式引用，用于暴露组件实例\n * @template T 组件类型\n * @param {T} Comp 组件定义\n * @returns 返回一个可响应式访问的组件实例引用\n * @example\n * const compRef = useExpose(MyComponent)\n */\nexport function useExpose<T>(_Comp: T) {\n  // 这里必须类型断言，否则构建会失败\n  return ref<ComponentExposed<T> | null>(\n    null,\n  ) as Ref<ComponentExposed<T> | null>;\n}\n\n/**\n * 将字符串的首字母转换为小写\n * @template S 字符串类型\n * @typedef {S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S} LowercaseFirst\n */\ntype LowercaseFirst<S extends string> = S extends `${infer First}${infer Rest}`\n  ? `${Lowercase<First>}${Rest}`\n  : S;\n\n/**\n * 从组件props中提取事件类型\n * @template T 组件props类型\n * @typedef {Object} PickEmits\n * @property {Object} [K in keyof T as K extends `on${infer Rest}`...] 转换后的emit事件名\n *   - @property {Function} [...args: P] 事件回调函数\n */\ntype PickEmits<T> = {\n  [K in keyof T as K extends `on${infer Rest}`\n    ? // biome-ignore lint/suspicious/noExplicitAny: 必须使用 any\n      T[K] extends (...args: any[]) => any\n      ? LowercaseFirst<Rest>\n      : never\n    : // biome-ignore lint/suspicious/noExplicitAny: 必须使用 any\n      never]: T[K] extends (...args: infer P) => any\n    ? (...args: P) => unknown\n    : never;\n};\n\n/**\n * 创建一个组件emit事件监听器\n * @template T 组件类型\n * @template E 从组件props中提取的事件类型\n * @template K 事件名\n * @param {T} Comp 组件定义\n * @param {K} event 事件名称\n * @param {E[K]} listener 事件监听函数\n * @returns {E[K]} 返回传入的事件监听函数\n * @example\n * const handleClick = useEmit(MyComponent, 'click', (payload) => {\n *   console.log('click event', payload)\n * })\n */\nexport function useEmit<\n  T,\n  E extends PickEmits<Required<ComponentProps<T>>>,\n  K extends keyof E,\n>(_Comp: T, _event: K, listener: E[K]) {\n  return listener;\n}\n\ntype PickMethods<T> = {\n  // biome-ignore lint/suspicious/noExplicitAny: 必须使用 any\n  [K in keyof T]: T[K] extends (...args: unknown[]) => any ? T[K] : never;\n};\n\n/**\n * 从组件props中提取方法并返回指定方法\n * @template T 组件类型\n * @template M 从组件props中提取的方法类型\n * @template K 方法名类型\n * @param {T} Comp 组件定义\n * @param {K} name 方法名称\n * @param {M[K]} method 要返回的方法\n * @returns {M[K]} 返回传入的方法\n * @example\n * const handleUpdate = useMethod(MyComponent, 'update', (value) => {\n *   console.log('update value', value)\n * })\n */\nexport function useMethod<\n  T,\n  M extends PickMethods<Required<ComponentProps<T>>>,\n  K extends keyof M,\n>(_Comp: T, _name: K, method: M[K]) {\n  return method;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,SAAS,aAAsC;CAC7D,aAAa,eAAe,iBAAiB,YAAY;;;;;;;;;;;;;;;;;;AAmB3D,SAAgB,WAAW,SAAkC;CAC3D,aAAa,WAAW,aAAa,QAAQ;;;;;;;;;;;;;;;;;;AAmB/C,SAAgB,aAAa,WAAoC;CAC/D,aAAa,aAAa,eAAe,UAAU;;;;;;;;;;;;AC3DrD,SAAgB,UAAa,OAAU;CAErC,OAAO,IACL,KACD;;;;;;;;;;;;;;;;AA6CH,SAAgB,QAId,OAAU,QAAW,UAAgB;CACrC,OAAO;;;;;;;;;;;;;;;;AAsBT,SAAgB,UAId,OAAU,OAAU,QAAc;CAClC,OAAO"}

package/dist/event.cjs

@@ -1,36 +1,43 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const emitter = require("@cloudcome/utils-core/emitter");
-const vue = require("vue");
+let vue = require("vue");
+let _cloudcome_utils_core_emitter = require("@cloudcome/utils-core/emitter");
+//#region src/event.ts
 function createEventHook(options = {}) {
-  const emitter$1 = options.emitter || new emitter.Emitter();
-  const on = (event, listener) => {
-    emitter$1.on(event, listener);
-  };
-  const off = (event, listener) => {
-    emitter$1.off(event, listener);
-  };
-  const emit = (event, ...payloads) => {
-    emitter$1.emit(event, ...payloads);
-  };
-  const useEvent = (event, fn) => {
-    if (options.stage === "mounted") {
-      vue.onMounted(() => {
-        on(event, fn);
-      });
-      vue.onUnmounted(() => {
-        off(event, fn);
-      });
-    } else {
-      vue.onBeforeMount(() => {
-        on(event, fn);
-      });
-      vue.onBeforeUnmount(() => {
-        off(event, fn);
-      });
-    }
-  };
-  return { on, off, emit, useEvent };
+	const emitter = options.emitter || new _cloudcome_utils_core_emitter.Emitter();
+	const on = (event, listener) => {
+		emitter.on(event, listener);
+	};
+	const off = (event, listener) => {
+		emitter.off(event, listener);
+	};
+	const emit = (event, ...payloads) => {
+		emitter.emit(event, ...payloads);
+	};
+	const useEvent = (event, fn) => {
+		if (options.stage === "mounted") {
+			(0, vue.onMounted)(() => {
+				on(event, fn);
+			});
+			(0, vue.onUnmounted)(() => {
+				off(event, fn);
+			});
+		} else {
+			(0, vue.onBeforeMount)(() => {
+				on(event, fn);
+			});
+			(0, vue.onBeforeUnmount)(() => {
+				off(event, fn);
+			});
+		}
+	};
+	return {
+		on,
+		off,
+		emit,
+		useEvent
+	};
 }
+//#endregion
 exports.createEventHook = createEventHook;
-//# sourceMappingURL=event.cjs.map
+
+//# sourceMappingURL=event.cjs.map

package/dist/event.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"event.cjs","sources":["../src/event.ts"],"sourcesContent":["import { Emitter, type EmitterListener, type EmitterMap } from '@cloudcome/utils-core/emitter';\nimport { onBeforeMount, onBeforeUnmount, onMounted, onUnmounted } from 'vue';\n\nexport type EventEmitter = {\n  on: (event: string, listener: (...payloads: unknown[]) => unknown) => unknown;\n  off: (event: string, listener: (...payloads: unknown[]) => unknown) => unknown;\n  emit: (event: string, ...payloads: unknown[]) => unknown;\n};\n\nexport type CreateEventCenterOptions = {\n  emitter?: EventEmitter;\n  stage?: 'mount' | 'mounted';\n};\n\nexport function createEventHook<E extends EmitterMap>(options: CreateEventCenterOptions = {}) {\n  const emitter = options.emitter || new Emitter();\n\n  const on = <K extends keyof E>(event: K, listener: EmitterListener<E, K>) => {\n    // @ts-ignore\n    emitter.on(event as string, listener);\n  };\n\n  const off = <K extends keyof E>(event: K, listener: EmitterListener<E, K>) => {\n    // @ts-ignore\n    emitter.off(event as string, listener);\n  };\n\n  const emit = <K extends keyof E>(event: K, ...payloads: E[K]) => {\n    emitter.emit(event as string, ...payloads);\n  };\n\n  const useEvent = <K extends keyof E>(event: K, fn: (...payloads: E[K]) => unknown) => {\n    if (options.stage === 'mounted') {\n      onMounted(() => {\n        on(event, fn);\n      });\n      onUnmounted(() => {\n        off(event, fn);\n      });\n    } else {\n      onBeforeMount(() => {\n        on(event, fn);\n      });\n      onBeforeUnmount(() => {\n        off(event, fn);\n      });\n    }\n  };\n\n  return { on, off, emit, useEvent };\n}\n"],"names":["emitter","Emitter","onMounted","onUnmounted","onBeforeMount","onBeforeUnmount"],"mappings":";;;;AAcgB,SAAA,gBAAsC,UAAoC,IAAI;AAC5F,QAAMA,YAAU,QAAQ,WAAW,IAAIC,QAAAA,QAAQ;AAEzC,QAAA,KAAK,CAAoB,OAAU,aAAoC;AAEnED,cAAA,GAAG,OAAiB,QAAQ;AAAA,EACtC;AAEM,QAAA,MAAM,CAAoB,OAAU,aAAoC;AAEpEA,cAAA,IAAI,OAAiB,QAAQ;AAAA,EACvC;AAEM,QAAA,OAAO,CAAoB,UAAa,aAAmB;AACvDA,cAAA,KAAK,OAAiB,GAAG,QAAQ;AAAA,EAC3C;AAEM,QAAA,WAAW,CAAoB,OAAU,OAAuC;AAChF,QAAA,QAAQ,UAAU,WAAW;AAC/BE,UAAAA,UAAU,MAAM;AACd,WAAG,OAAO,EAAE;AAAA,MAAA,CACb;AACDC,UAAAA,YAAY,MAAM;AAChB,YAAI,OAAO,EAAE;AAAA,MAAA,CACd;AAAA,IAAA,OACI;AACLC,UAAAA,cAAc,MAAM;AAClB,WAAG,OAAO,EAAE;AAAA,MAAA,CACb;AACDC,UAAAA,gBAAgB,MAAM;AACpB,YAAI,OAAO,EAAE;AAAA,MAAA,CACd;AAAA,IAAA;AAAA,EAEL;AAEA,SAAO,EAAE,IAAI,KAAK,MAAM,SAAS;AACnC;;"}
+{"version":3,"file":"event.cjs","names":[],"sources":["../src/event.ts"],"sourcesContent":["import {\n  Emitter,\n  type EmitterListener,\n  type EmitterMap,\n} from '@cloudcome/utils-core/emitter';\nimport { onBeforeMount, onBeforeUnmount, onMounted, onUnmounted } from 'vue';\n\nexport type EventEmitter = {\n  on: (event: string, listener: (...payloads: unknown[]) => unknown) => unknown;\n  off: (\n    event: string,\n    listener: (...payloads: unknown[]) => unknown,\n  ) => unknown;\n  emit: (event: string, ...payloads: unknown[]) => unknown;\n};\n\nexport type CreateEventCenterOptions = {\n  emitter?: EventEmitter;\n  stage?: 'mount' | 'mounted';\n};\n\nexport function createEventHook<E extends EmitterMap>(\n  options: CreateEventCenterOptions = {},\n) {\n  const emitter = options.emitter || new Emitter();\n\n  const on = <K extends keyof E>(event: K, listener: EmitterListener<E, K>) => {\n    // @ts-expect-error\n    emitter.on(event as string, listener);\n  };\n\n  const off = <K extends keyof E>(\n    event: K,\n    listener: EmitterListener<E, K>,\n  ) => {\n    // @ts-expect-error\n    emitter.off(event as string, listener);\n  };\n\n  const emit = <K extends keyof E>(event: K, ...payloads: E[K]) => {\n    emitter.emit(event as string, ...payloads);\n  };\n\n  const useEvent = <K extends keyof E>(\n    event: K,\n    fn: (...payloads: E[K]) => unknown,\n  ) => {\n    if (options.stage === 'mounted') {\n      onMounted(() => {\n        on(event, fn);\n      });\n      onUnmounted(() => {\n        off(event, fn);\n      });\n    } else {\n      onBeforeMount(() => {\n        on(event, fn);\n      });\n      onBeforeUnmount(() => {\n        off(event, fn);\n      });\n    }\n  };\n\n  return { on, off, emit, useEvent };\n}\n"],"mappings":";;;;AAqBA,SAAgB,gBACd,UAAoC,EAAE,EACtC;CACA,MAAM,UAAU,QAAQ,WAAW,IAAI,8BAAA,SAAS;CAEhD,MAAM,MAAyB,OAAU,aAAoC;EAE3E,QAAQ,GAAG,OAAiB,SAAS;;CAGvC,MAAM,OACJ,OACA,aACG;EAEH,QAAQ,IAAI,OAAiB,SAAS;;CAGxC,MAAM,QAA2B,OAAU,GAAG,aAAmB;EAC/D,QAAQ,KAAK,OAAiB,GAAG,SAAS;;CAG5C,MAAM,YACJ,OACA,OACG;EACH,IAAI,QAAQ,UAAU,WAAW;GAC/B,CAAA,GAAA,IAAA,iBAAgB;IACd,GAAG,OAAO,GAAG;KACb;GACF,CAAA,GAAA,IAAA,mBAAkB;IAChB,IAAI,OAAO,GAAG;KACd;SACG;GACL,CAAA,GAAA,IAAA,qBAAoB;IAClB,GAAG,OAAO,GAAG;KACb;GACF,CAAA,GAAA,IAAA,uBAAsB;IACpB,IAAI,OAAO,GAAG;KACd;;;CAIN,OAAO;EAAE;EAAI;EAAK;EAAM;EAAU"}

package/dist/event.mjs

@@ -1,36 +1,42 @@
+import { onBeforeMount, onBeforeUnmount, onMounted, onUnmounted } from "vue";
 import { Emitter } from "@cloudcome/utils-core/emitter";
-import { onMounted, onUnmounted, onBeforeMount, onBeforeUnmount } from "vue";
+//#region src/event.ts
 function createEventHook(options = {}) {
-  const emitter = options.emitter || new Emitter();
-  const on = (event, listener) => {
-    emitter.on(event, listener);
-  };
-  const off = (event, listener) => {
-    emitter.off(event, listener);
-  };
-  const emit = (event, ...payloads) => {
-    emitter.emit(event, ...payloads);
-  };
-  const useEvent = (event, fn) => {
-    if (options.stage === "mounted") {
-      onMounted(() => {
-        on(event, fn);
-      });
-      onUnmounted(() => {
-        off(event, fn);
-      });
-    } else {
-      onBeforeMount(() => {
-        on(event, fn);
-      });
-      onBeforeUnmount(() => {
-        off(event, fn);
-      });
-    }
-  };
-  return { on, off, emit, useEvent };
+	const emitter = options.emitter || new Emitter();
+	const on = (event, listener) => {
+		emitter.on(event, listener);
+	};
+	const off = (event, listener) => {
+		emitter.off(event, listener);
+	};
+	const emit = (event, ...payloads) => {
+		emitter.emit(event, ...payloads);
+	};
+	const useEvent = (event, fn) => {
+		if (options.stage === "mounted") {
+			onMounted(() => {
+				on(event, fn);
+			});
+			onUnmounted(() => {
+				off(event, fn);
+			});
+		} else {
+			onBeforeMount(() => {
+				on(event, fn);
+			});
+			onBeforeUnmount(() => {
+				off(event, fn);
+			});
+		}
+	};
+	return {
+		on,
+		off,
+		emit,
+		useEvent
+	};
 }
-export {
-  createEventHook
-};
-//# sourceMappingURL=event.mjs.map
+//#endregion
+export { createEventHook };
+
+//# sourceMappingURL=event.mjs.map

package/dist/event.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"event.mjs","sources":["../src/event.ts"],"sourcesContent":["import { Emitter, type EmitterListener, type EmitterMap } from '@cloudcome/utils-core/emitter';\nimport { onBeforeMount, onBeforeUnmount, onMounted, onUnmounted } from 'vue';\n\nexport type EventEmitter = {\n  on: (event: string, listener: (...payloads: unknown[]) => unknown) => unknown;\n  off: (event: string, listener: (...payloads: unknown[]) => unknown) => unknown;\n  emit: (event: string, ...payloads: unknown[]) => unknown;\n};\n\nexport type CreateEventCenterOptions = {\n  emitter?: EventEmitter;\n  stage?: 'mount' | 'mounted';\n};\n\nexport function createEventHook<E extends EmitterMap>(options: CreateEventCenterOptions = {}) {\n  const emitter = options.emitter || new Emitter();\n\n  const on = <K extends keyof E>(event: K, listener: EmitterListener<E, K>) => {\n    // @ts-ignore\n    emitter.on(event as string, listener);\n  };\n\n  const off = <K extends keyof E>(event: K, listener: EmitterListener<E, K>) => {\n    // @ts-ignore\n    emitter.off(event as string, listener);\n  };\n\n  const emit = <K extends keyof E>(event: K, ...payloads: E[K]) => {\n    emitter.emit(event as string, ...payloads);\n  };\n\n  const useEvent = <K extends keyof E>(event: K, fn: (...payloads: E[K]) => unknown) => {\n    if (options.stage === 'mounted') {\n      onMounted(() => {\n        on(event, fn);\n      });\n      onUnmounted(() => {\n        off(event, fn);\n      });\n    } else {\n      onBeforeMount(() => {\n        on(event, fn);\n      });\n      onBeforeUnmount(() => {\n        off(event, fn);\n      });\n    }\n  };\n\n  return { on, off, emit, useEvent };\n}\n"],"names":[],"mappings":";;AAcgB,SAAA,gBAAsC,UAAoC,IAAI;AAC5F,QAAM,UAAU,QAAQ,WAAW,IAAI,QAAQ;AAEzC,QAAA,KAAK,CAAoB,OAAU,aAAoC;AAEnE,YAAA,GAAG,OAAiB,QAAQ;AAAA,EACtC;AAEM,QAAA,MAAM,CAAoB,OAAU,aAAoC;AAEpE,YAAA,IAAI,OAAiB,QAAQ;AAAA,EACvC;AAEM,QAAA,OAAO,CAAoB,UAAa,aAAmB;AACvD,YAAA,KAAK,OAAiB,GAAG,QAAQ;AAAA,EAC3C;AAEM,QAAA,WAAW,CAAoB,OAAU,OAAuC;AAChF,QAAA,QAAQ,UAAU,WAAW;AAC/B,gBAAU,MAAM;AACd,WAAG,OAAO,EAAE;AAAA,MAAA,CACb;AACD,kBAAY,MAAM;AAChB,YAAI,OAAO,EAAE;AAAA,MAAA,CACd;AAAA,IAAA,OACI;AACL,oBAAc,MAAM;AAClB,WAAG,OAAO,EAAE;AAAA,MAAA,CACb;AACD,sBAAgB,MAAM;AACpB,YAAI,OAAO,EAAE;AAAA,MAAA,CACd;AAAA,IAAA;AAAA,EAEL;AAEA,SAAO,EAAE,IAAI,KAAK,MAAM,SAAS;AACnC;"}
+{"version":3,"file":"event.mjs","names":[],"sources":["../src/event.ts"],"sourcesContent":["import {\n  Emitter,\n  type EmitterListener,\n  type EmitterMap,\n} from '@cloudcome/utils-core/emitter';\nimport { onBeforeMount, onBeforeUnmount, onMounted, onUnmounted } from 'vue';\n\nexport type EventEmitter = {\n  on: (event: string, listener: (...payloads: unknown[]) => unknown) => unknown;\n  off: (\n    event: string,\n    listener: (...payloads: unknown[]) => unknown,\n  ) => unknown;\n  emit: (event: string, ...payloads: unknown[]) => unknown;\n};\n\nexport type CreateEventCenterOptions = {\n  emitter?: EventEmitter;\n  stage?: 'mount' | 'mounted';\n};\n\nexport function createEventHook<E extends EmitterMap>(\n  options: CreateEventCenterOptions = {},\n) {\n  const emitter = options.emitter || new Emitter();\n\n  const on = <K extends keyof E>(event: K, listener: EmitterListener<E, K>) => {\n    // @ts-expect-error\n    emitter.on(event as string, listener);\n  };\n\n  const off = <K extends keyof E>(\n    event: K,\n    listener: EmitterListener<E, K>,\n  ) => {\n    // @ts-expect-error\n    emitter.off(event as string, listener);\n  };\n\n  const emit = <K extends keyof E>(event: K, ...payloads: E[K]) => {\n    emitter.emit(event as string, ...payloads);\n  };\n\n  const useEvent = <K extends keyof E>(\n    event: K,\n    fn: (...payloads: E[K]) => unknown,\n  ) => {\n    if (options.stage === 'mounted') {\n      onMounted(() => {\n        on(event, fn);\n      });\n      onUnmounted(() => {\n        off(event, fn);\n      });\n    } else {\n      onBeforeMount(() => {\n        on(event, fn);\n      });\n      onBeforeUnmount(() => {\n        off(event, fn);\n      });\n    }\n  };\n\n  return { on, off, emit, useEvent };\n}\n"],"mappings":";;;AAqBA,SAAgB,gBACd,UAAoC,EAAE,EACtC;CACA,MAAM,UAAU,QAAQ,WAAW,IAAI,SAAS;CAEhD,MAAM,MAAyB,OAAU,aAAoC;EAE3E,QAAQ,GAAG,OAAiB,SAAS;;CAGvC,MAAM,OACJ,OACA,aACG;EAEH,QAAQ,IAAI,OAAiB,SAAS;;CAGxC,MAAM,QAA2B,OAAU,GAAG,aAAmB;EAC/D,QAAQ,KAAK,OAAiB,GAAG,SAAS;;CAG5C,MAAM,YACJ,OACA,OACG;EACH,IAAI,QAAQ,UAAU,WAAW;GAC/B,gBAAgB;IACd,GAAG,OAAO,GAAG;KACb;GACF,kBAAkB;IAChB,IAAI,OAAO,GAAG;KACd;SACG;GACL,oBAAoB;IAClB,GAAG,OAAO,GAAG;KACb;GACF,sBAAsB;IACpB,IAAI,OAAO,GAAG;KACd;;;CAIN,OAAO;EAAE;EAAI;EAAK;EAAM;EAAU"}

package/dist/index.cjs

@@ -1,5 +1,10 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const VERSION = "1.13.1";
+//#region src/index.ts
+/**
+* `@cloudcome/utils-vue` 版本号
+*/
+var VERSION = "1.13.3";
+//#endregion
 exports.VERSION = VERSION;
-//# sourceMappingURL=index.cjs.map
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["/**\n * `@cloudcome/utils-vue` 版本号\n */\nexport const VERSION = PKG_VERSION;\n"],"names":[],"mappings":";;AAGO,MAAM,UAAU;;"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@cloudcome/utils-vue` 版本号\n */\nexport const VERSION = PKG_VERSION;\n"],"mappings":";;;;;AAGA,IAAa,UAAA"}

package/dist/index.mjs

@@ -1,5 +1,9 @@
-const VERSION = "1.13.1";
-export {
-  VERSION
-};
-//# sourceMappingURL=index.mjs.map
+//#region src/index.ts
+/**
+* `@cloudcome/utils-vue` 版本号
+*/
+var VERSION = "1.13.3";
+//#endregion
+export { VERSION };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["/**\n * `@cloudcome/utils-vue` 版本号\n */\nexport const VERSION = PKG_VERSION;\n"],"names":[],"mappings":"AAGO,MAAM,UAAU;"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `@cloudcome/utils-vue` 版本号\n */\nexport const VERSION = PKG_VERSION;\n"],"mappings":";;;;AAGA,IAAa,UAAA"}

package/dist/request.cjs

@@ -1,78 +1,76 @@
-"use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const cache = require("@cloudcome/utils-core/cache");
-const _try = require("@cloudcome/utils-core/try");
-const type = require("@cloudcome/utils-core/type");
-const vue = require("vue");
-const async = require("./async.cjs");
-const defaultCacheStorage = new cache.MemoryCache();
-const defaultShareStorage = new cache.MemoryCache();
+const require_async = require("./async.cjs");
+let vue = require("vue");
+let _cloudcome_utils_core_type = require("@cloudcome/utils-core/type");
+let _cloudcome_utils_core_cache = require("@cloudcome/utils-core/cache");
+let _cloudcome_utils_core_try = require("@cloudcome/utils-core/try");
+//#region src/request.ts
+var defaultCacheStorage = new _cloudcome_utils_core_cache.MemoryCache();
+var defaultShareStorage = new _cloudcome_utils_core_cache.MemoryCache();
 function useRequest(fn, options) {
-  const { id, cache: cache2, share, onCacheHit, onSuccess } = options || {};
-  const shareStorage = defaultShareStorage;
-  const shareAble = type.isObject(share) ? !share.disabled : share;
-  const shareOptions = type.isObject(share) ? share : {};
-  const hitShare = vue.ref(false);
-  const _cached = defaultCacheStorage;
-  const cacheStorage = type.isObject(cache2) ? cache2.storage || _cached : _cached;
-  const cacheAble = type.isObject(cache2) ? !cache2.disabled : cache2;
-  const cacheOptions = type.isObject(cache2) ? cache2 : {};
-  const hitCache = vue.ref(false);
-  const cacheableFn = async (...inputs) => {
-    const requestId = type.isFunction(id) ? id() : id;
-    hitShare.value = false;
-    hitCache.value = false;
-    if (requestId && shareAble) {
-      const shared = shareStorage.get(requestId);
-      if (shared) {
-        hitShare.value = true;
-        const [err2, data2] = await _try.tryFlatten(shared.data);
-        if (err2) {
-          shareStorage.del(requestId);
-          throw err2;
-        }
-        return data2;
-      }
-    }
-    const { promise, resolve, reject } = Promise.withResolvers();
-    if (requestId && shareAble) {
-      shareStorage.set(requestId, promise, shareOptions);
-    }
-    if (requestId && cacheAble) {
-      const cached = await cacheStorage.get(requestId);
-      if (cached) {
-        const data2 = cached.data;
-        resolve(data2);
-        hitCache.value = true;
-        await onCacheHit?.(cached);
-        return promise;
-      }
-    }
-    const [err, data] = await _try.tryFlatten(fn(...inputs));
-    if (err) {
-      reject(err);
-      return promise;
-    }
-    if (requestId && cacheAble) {
-      cacheStorage.set(requestId, data, cacheOptions);
-    }
-    resolve(data);
-    return promise;
-  };
-  const { state: asyncState, run: send, runAsync: sendAsync, ...async$1 } = async.useAsync(cacheableFn, options);
-  const state = vue.computed(() => ({
-    ...asyncState.value,
-    hitShare: hitShare.value,
-    hitCache: hitCache.value
-  }));
-  return {
-    ...async$1,
-    state,
-    send,
-    sendAsync,
-    hitShare,
-    hitCache
-  };
+	const { id, cache, share, onCacheHit } = options || {};
+	const shareStorage = defaultShareStorage;
+	const shareAble = (0, _cloudcome_utils_core_type.isObject)(share) ? !share.disabled : share;
+	const shareOptions = (0, _cloudcome_utils_core_type.isObject)(share) ? share : {};
+	const hitShare = (0, vue.ref)(false);
+	const _cached = defaultCacheStorage;
+	const cacheStorage = (0, _cloudcome_utils_core_type.isObject)(cache) ? cache.storage || _cached : _cached;
+	const cacheAble = (0, _cloudcome_utils_core_type.isObject)(cache) ? !cache.disabled : cache;
+	const cacheOptions = (0, _cloudcome_utils_core_type.isObject)(cache) ? cache : {};
+	const hitCache = (0, vue.ref)(false);
+	const cacheableFn = async (...inputs) => {
+		const requestId = (0, _cloudcome_utils_core_type.isFunction)(id) ? id() : id;
+		hitShare.value = false;
+		hitCache.value = false;
+		if (requestId && shareAble) {
+			const shared = shareStorage.get(requestId);
+			if (shared) {
+				hitShare.value = true;
+				const [err, data] = await (0, _cloudcome_utils_core_try.tryFlatten)(shared.data);
+				if (err) {
+					shareStorage.del(requestId);
+					throw err;
+				}
+				return data;
+			}
+		}
+		const { promise, resolve, reject } = Promise.withResolvers();
+		if (requestId && shareAble) shareStorage.set(requestId, promise, shareOptions);
+		if (requestId && cacheAble) {
+			const cached = await cacheStorage.get(requestId);
+			if (cached) {
+				const data = cached.data;
+				resolve(data);
+				hitCache.value = true;
+				await onCacheHit?.(cached);
+				return promise;
+			}
+		}
+		const [err, data] = await (0, _cloudcome_utils_core_try.tryFlatten)(fn(...inputs));
+		if (err) {
+			reject(err);
+			return promise;
+		}
+		if (requestId && cacheAble) cacheStorage.set(requestId, data, cacheOptions);
+		resolve(data);
+		return promise;
+	};
+	const { state: asyncState, run: send, runAsync: sendAsync, ...async } = require_async.useAsync(cacheableFn, options);
+	const state = (0, vue.computed)(() => ({
+		...asyncState.value,
+		hitShare: hitShare.value,
+		hitCache: hitCache.value
+	}));
+	return {
+		...async,
+		state,
+		send,
+		sendAsync,
+		hitShare,
+		hitCache
+	};
 }
+//#endregion
 exports.useRequest = useRequest;
-//# sourceMappingURL=request.cjs.map
+
+//# sourceMappingURL=request.cjs.map

package/dist/request.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"request.cjs","sources":["../src/request.ts"],"sourcesContent":["import { type Cache, type CacheOptions, type Cached, MemoryCache } from '@cloudcome/utils-core/cache';\nimport type { DateValue } from '@cloudcome/utils-core/date';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction, isObject } from '@cloudcome/utils-core/type';\nimport type { AnyArray, MaybeCallable } from '@cloudcome/utils-core/types';\nimport type { ComputedRef, Ref } from 'vue';\nimport { computed, ref } from 'vue';\nimport {\n  type UseAsyncOptions,\n  type UseAsyncOutput,\n  type UseAsyncOutputFilled,\n  type UseAsyncState,\n  type UseAsyncStateFilled,\n  useAsync,\n} from './async';\n\n/**\n * 请求缓存配置选项。\n * @template T 缓存数据的类型。\n */\nexport type RequestCacheOptions<T> = CacheOptions & {\n  /**\n   * 是否禁用缓存，默认为 false。\n   * 如果设置为 true，则不会使用缓存。\n   */\n  disabled?: boolean;\n\n  /**\n   * 自定义缓存存储实现。\n   * 可以传入自定义的缓存类来替代默认的内存缓存。\n   */\n  storage?: Cache<T>;\n};\n\nexport type RequestShareOptions = {\n  /**\n   * 是否禁用共享请求，默认为 false。\n   * 如果设置为 true，则不会共享请求结果。\n   */\n  disabled?: boolean;\n\n  /**\n   * 共享的最大时长（毫秒），为 0 时表示永久共享。\n   * 超过该时长后，共享的请求结果将被清除。\n   */\n  maxAge?: number;\n\n  /**\n   * 共享的过期时间（时间戳、日期字符串、日期对象等）。\n   * 优先级比 maxAge 更高，指定具体的过期时间。\n   */\n  expiredAt?: DateValue;\n};\n\nexport type RetryOptions = {\n  /**\n   * 是否禁用重试，默认为 false。\n   * 如果设置为 true，则不会重试。\n   */\n  disabled?: boolean;\n};\n\n/**\n * 请求选项，扩展了异步操作的选项。\n * @template T 请求返回的数据类型。\n * @template I 请求参数的类型。\n */\nexport type UseRequestOptions<I extends AnyArray, O> = UseAsyncOptions<I, O> & {\n  /**\n   * 请求的唯一标识符，可以是字符串或函数返回的字符串。\n   * 用于缓存和共享的键值。\n   */\n  id?: MaybeCallable<string>;\n\n  /**\n   * 缓存配置，可以是布尔值或完整的缓存选项。\n   * 如果为 true，则启用默认缓存；如果为对象，则可以自定义缓存行为。\n   */\n  cache?: boolean | RequestCacheOptions<O>;\n\n  /**\n   * 共享配置，可以是布尔值或完整的共享选项。\n   * 共享时，相同的请求 ID 会复用第一次发出且没有响应完成的请求。\n   *\n   * 例如，10 组件同时或先后发起 10 次请求用于获取用户信息，\n   * 那么这 10 个组件会共同等待第一次发起的请求，直到完成。\n   *\n   * 共享与缓存是不同的概念，共享是进行时，缓存是过去时，即：\n   * - 共享是共享**正在发送**的请求\n   * - 缓存是缓存**已经发送**的请求\n   *\n   * 如果为 true，则启用默认共享；如果为对象，则可以自定义共享行为。\n   */\n  share?: boolean | RequestShareOptions;\n\n  /**\n   * 当命中缓存时的回调函数。\n   * 在缓存命中时触发，接收缓存的数据作为参数。\n   */\n  onCacheHit?: (cached: Cached<O>) => unknown;\n};\n\nexport type UseRequestState<O> = UseAsyncState<O> & {\n  /**\n   * 是否命中共享数据\n   */\n  hitShare: boolean;\n\n  /**\n   * 是否命中缓存\n   */\n  hitCache: boolean;\n};\n\nexport type UseRequestStateFilled<O> = UseAsyncStateFilled<O> & {\n  /**\n   * 是否命中共享数据\n   */\n  hitShare: boolean;\n\n  /**\n   * 是否命中缓存\n   */\n  hitCache: boolean;\n};\n\nexport type UseRequestOutput<I extends AnyArray, O> = Omit<UseAsyncOutput<I, O>, 'run' | 'runAsync' | 'state'> & {\n  state: ComputedRef<UseRequestState<O>>;\n  send: (...inputs: I) => void;\n  sendAsync: (...inputs: I) => Promise<O>;\n  hitShare: Ref<boolean>;\n  hitCache: Ref<boolean>;\n};\n\nexport type UseRequestOutputFilled<I extends AnyArray, O> = Omit<\n  UseAsyncOutputFilled<I, O>,\n  'run' | 'runAsync' | 'state'\n> & {\n  state: ComputedRef<UseRequestStateFilled<O>>;\n  send: (...inputs: I) => void;\n  sendAsync: (...inputs: I) => Promise<O>;\n  hitShare: Ref<boolean>;\n  hitCache: Ref<boolean>;\n};\n\nconst defaultCacheStorage = new MemoryCache();\nconst defaultShareStorage = new MemoryCache();\n\n/**\n * 使用请求功能的组合式函数。\n * 支持缓存和异步操作的封装。\n *\n * @template O 请求返回的数据类型。\n * @template I 请求参数的类型。\n * @param {() => Promise<O>} fn 实际的请求函数，返回一个 Promise。\n * @param {UseRequestOptions<I, O>} [options] 请求选项，包括缓存和回调配置。\n * @returns 返回一个对象，包含以下内容：\n * - 异步操作的状态（如 loading、error 等）。\n * - 是否命中缓存（hitCache）。\n * - 是否命中共享请求（hitShare）。\n */\nexport function useRequest<I extends AnyArray, O>(\n  fn: (...inputs: I) => Promise<O>,\n  options: Omit<UseRequestOptions<I, O>, 'placeholder'> & { placeholder: () => O },\n): UseRequestOutputFilled<I, O>;\nexport function useRequest<I extends AnyArray, O>(\n  fn: (...inputs: I) => Promise<O>,\n  options?: UseRequestOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useRequest<I extends AnyArray, O>(\n  fn: (...inputs: I) => Promise<O>,\n  options?: UseRequestOptions<I, O>,\n): UseRequestOutput<I, O> {\n  const { id, cache, share, onCacheHit, onSuccess } = options || {};\n\n  const shareStorage = defaultShareStorage as MemoryCache<Promise<O>>;\n  const shareAble = isObject(share) ? !share.disabled : share;\n  const shareOptions = isObject(share) ? share : {};\n  const hitShare = ref(false);\n\n  const _cached = defaultCacheStorage as Cache<O>;\n  const cacheStorage = isObject(cache) ? cache.storage || _cached : _cached;\n  const cacheAble = isObject(cache) ? !cache.disabled : cache;\n  const cacheOptions = isObject(cache) ? cache : {};\n  const hitCache = ref(false);\n\n  const cacheableFn = async (...inputs: I) => {\n    const requestId = isFunction(id) ? id() : id;\n\n    hitShare.value = false;\n    hitCache.value = false;\n\n    if (requestId && shareAble) {\n      const shared = shareStorage.get(requestId);\n      if (shared) {\n        hitShare.value = true;\n        const [err, data] = await tryFlatten(shared.data);\n        if (err) {\n          shareStorage.del(requestId);\n          throw err;\n        }\n\n        return data;\n      }\n    }\n\n    // 这里不能先执行，因为如果要缓存的话，必须用缓存结果\n    const { promise, resolve, reject } = Promise.withResolvers<O>();\n\n    if (requestId && shareAble) {\n      shareStorage.set(requestId, promise, shareOptions);\n    }\n\n    if (requestId && cacheAble) {\n      const cached = await cacheStorage.get(requestId);\n\n      if (cached) {\n        const data = cached.data;\n        resolve(data);\n        hitCache.value = true;\n        await onCacheHit?.(cached);\n        return promise;\n      }\n    }\n\n    const [err, data] = await tryFlatten(fn(...inputs));\n\n    if (err) {\n      reject(err);\n      return promise;\n    }\n\n    if (requestId && cacheAble) {\n      cacheStorage.set(requestId, data, cacheOptions);\n    }\n\n    resolve(data);\n    return promise;\n  };\n  const { state: asyncState, run: send, runAsync: sendAsync, ...async } = useAsync(cacheableFn, options);\n\n  const state = computed(() => ({\n    ...asyncState.value,\n    hitShare: hitShare.value,\n    hitCache: hitCache.value,\n  }));\n\n  return {\n    ...async,\n    state,\n    send,\n    sendAsync,\n    hitShare,\n    hitCache,\n  };\n}\n"],"names":["MemoryCache","cache","isObject","ref","isFunction","err","data","tryFlatten","async","useAsync","computed"],"mappings":";;;;;;;AAiJA,MAAM,sBAAsB,IAAIA,MAAAA,YAAY;AAC5C,MAAM,sBAAsB,IAAIA,MAAAA,YAAY;AAuB5B,SAAA,WACd,IACA,SACwB;AAClB,QAAA,EAAE,IAAI,OAAAC,QAAO,OAAO,YAAY,UAAU,IAAI,WAAW,CAAC;AAEhE,QAAM,eAAe;AACrB,QAAM,YAAYC,KAAAA,SAAS,KAAK,IAAI,CAAC,MAAM,WAAW;AACtD,QAAM,eAAeA,KAAA,SAAS,KAAK,IAAI,QAAQ,CAAC;AAC1C,QAAA,WAAWC,QAAI,KAAK;AAE1B,QAAM,UAAU;AAChB,QAAM,eAAeD,KAAAA,SAASD,MAAK,IAAIA,OAAM,WAAW,UAAU;AAClE,QAAM,YAAYC,KAAAA,SAASD,MAAK,IAAI,CAACA,OAAM,WAAWA;AACtD,QAAM,eAAeC,KAAA,SAASD,MAAK,IAAIA,SAAQ,CAAC;AAC1C,QAAA,WAAWE,QAAI,KAAK;AAEpB,QAAA,cAAc,UAAU,WAAc;AAC1C,UAAM,YAAYC,KAAA,WAAW,EAAE,IAAI,GAAO,IAAA;AAE1C,aAAS,QAAQ;AACjB,aAAS,QAAQ;AAEjB,QAAI,aAAa,WAAW;AACpB,YAAA,SAAS,aAAa,IAAI,SAAS;AACzC,UAAI,QAAQ;AACV,iBAAS,QAAQ;AACjB,cAAM,CAACC,MAAKC,KAAI,IAAI,MAAMC,KAAA,WAAW,OAAO,IAAI;AAChD,YAAIF,MAAK;AACP,uBAAa,IAAI,SAAS;AACpBA,gBAAAA;AAAAA,QAAA;AAGDC,eAAAA;AAAAA,MAAA;AAAA,IACT;AAIF,UAAM,EAAE,SAAS,SAAS,OAAO,IAAI,QAAQ,cAAiB;AAE9D,QAAI,aAAa,WAAW;AACb,mBAAA,IAAI,WAAW,SAAS,YAAY;AAAA,IAAA;AAGnD,QAAI,aAAa,WAAW;AAC1B,YAAM,SAAS,MAAM,aAAa,IAAI,SAAS;AAE/C,UAAI,QAAQ;AACV,cAAMA,QAAO,OAAO;AACpB,gBAAQA,KAAI;AACZ,iBAAS,QAAQ;AACjB,cAAM,aAAa,MAAM;AAClB,eAAA;AAAA,MAAA;AAAA,IACT;AAGI,UAAA,CAAC,KAAK,IAAI,IAAI,MAAMC,KAAAA,WAAW,GAAG,GAAG,MAAM,CAAC;AAElD,QAAI,KAAK;AACP,aAAO,GAAG;AACH,aAAA;AAAA,IAAA;AAGT,QAAI,aAAa,WAAW;AACb,mBAAA,IAAI,WAAW,MAAM,YAAY;AAAA,IAAA;AAGhD,YAAQ,IAAI;AACL,WAAA;AAAA,EACT;AACA,QAAM,EAAE,OAAO,YAAY,KAAK,MAAM,UAAU,WAAW,GAAGC,QAAM,IAAIC,eAAS,aAAa,OAAO;AAE/F,QAAA,QAAQC,IAAAA,SAAS,OAAO;AAAA,IAC5B,GAAG,WAAW;AAAA,IACd,UAAU,SAAS;AAAA,IACnB,UAAU,SAAS;AAAA,EAAA,EACnB;AAEK,SAAA;AAAA,IACL,GAAGF;AAAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;"}
+{"version":3,"file":"request.cjs","names":[],"sources":["../src/request.ts"],"sourcesContent":["import {\n  type Cache,\n  type Cached,\n  type CacheOptions,\n  MemoryCache,\n} from '@cloudcome/utils-core/cache';\nimport type { DateValue } from '@cloudcome/utils-core/date';\nimport { tryFlatten } from '@cloudcome/utils-core/try';\nimport { isFunction, isObject } from '@cloudcome/utils-core/type';\nimport type { AnyArray, MaybeCallable } from '@cloudcome/utils-core/types';\nimport type { ComputedRef, Ref } from 'vue';\nimport { computed, ref } from 'vue';\nimport {\n  type UseAsyncOptions,\n  type UseAsyncOutput,\n  type UseAsyncOutputFilled,\n  type UseAsyncState,\n  type UseAsyncStateFilled,\n  useAsync,\n} from './async';\n\n/**\n * 请求缓存配置选项。\n * @template T 缓存数据的类型。\n */\nexport type RequestCacheOptions<T> = CacheOptions & {\n  /**\n   * 是否禁用缓存，默认为 false。\n   * 如果设置为 true，则不会使用缓存。\n   */\n  disabled?: boolean;\n\n  /**\n   * 自定义缓存存储实现。\n   * 可以传入自定义的缓存类来替代默认的内存缓存。\n   */\n  storage?: Cache<T>;\n};\n\nexport type RequestShareOptions = {\n  /**\n   * 是否禁用共享请求，默认为 false。\n   * 如果设置为 true，则不会共享请求结果。\n   */\n  disabled?: boolean;\n\n  /**\n   * 共享的最大时长（毫秒），为 0 时表示永久共享。\n   * 超过该时长后，共享的请求结果将被清除。\n   */\n  maxAge?: number;\n\n  /**\n   * 共享的过期时间（时间戳、日期字符串、日期对象等）。\n   * 优先级比 maxAge 更高，指定具体的过期时间。\n   */\n  expiredAt?: DateValue;\n};\n\nexport type RetryOptions = {\n  /**\n   * 是否禁用重试，默认为 false。\n   * 如果设置为 true，则不会重试。\n   */\n  disabled?: boolean;\n};\n\n/**\n * 请求选项，扩展了异步操作的选项。\n * @template T 请求返回的数据类型。\n * @template I 请求参数的类型。\n */\nexport type UseRequestOptions<I extends AnyArray, O> = UseAsyncOptions<I, O> & {\n  /**\n   * 请求的唯一标识符，可以是字符串或函数返回的字符串。\n   * 用于缓存和共享的键值。\n   */\n  id?: MaybeCallable<string>;\n\n  /**\n   * 缓存配置，可以是布尔值或完整的缓存选项。\n   * 如果为 true，则启用默认缓存；如果为对象，则可以自定义缓存行为。\n   */\n  cache?: boolean | RequestCacheOptions<O>;\n\n  /**\n   * 共享配置，可以是布尔值或完整的共享选项。\n   * 共享时，相同的请求 ID 会复用第一次发出且没有响应完成的请求。\n   *\n   * 例如，10 组件同时或先后发起 10 次请求用于获取用户信息，\n   * 那么这 10 个组件会共同等待第一次发起的请求，直到完成。\n   *\n   * 共享与缓存是不同的概念，共享是进行时，缓存是过去时，即：\n   * - 共享是共享**正在发送**的请求\n   * - 缓存是缓存**已经发送**的请求\n   *\n   * 如果为 true，则启用默认共享；如果为对象，则可以自定义共享行为。\n   */\n  share?: boolean | RequestShareOptions;\n\n  /**\n   * 当命中缓存时的回调函数。\n   * 在缓存命中时触发，接收缓存的数据作为参数。\n   */\n  onCacheHit?: (cached: Cached<O>) => unknown;\n};\n\nexport type UseRequestState<O> = UseAsyncState<O> & {\n  /**\n   * 是否命中共享数据\n   */\n  hitShare: boolean;\n\n  /**\n   * 是否命中缓存\n   */\n  hitCache: boolean;\n};\n\nexport type UseRequestStateFilled<O> = UseAsyncStateFilled<O> & {\n  /**\n   * 是否命中共享数据\n   */\n  hitShare: boolean;\n\n  /**\n   * 是否命中缓存\n   */\n  hitCache: boolean;\n};\n\nexport type UseRequestOutput<I extends AnyArray, O> = Omit<\n  UseAsyncOutput<I, O>,\n  'run' | 'runAsync' | 'state'\n> & {\n  state: ComputedRef<UseRequestState<O>>;\n  send: (...inputs: I) => void;\n  sendAsync: (...inputs: I) => Promise<O>;\n  hitShare: Ref<boolean>;\n  hitCache: Ref<boolean>;\n};\n\nexport type UseRequestOutputFilled<I extends AnyArray, O> = Omit<\n  UseAsyncOutputFilled<I, O>,\n  'run' | 'runAsync' | 'state'\n> & {\n  state: ComputedRef<UseRequestStateFilled<O>>;\n  send: (...inputs: I) => void;\n  sendAsync: (...inputs: I) => Promise<O>;\n  hitShare: Ref<boolean>;\n  hitCache: Ref<boolean>;\n};\n\nconst defaultCacheStorage = new MemoryCache();\nconst defaultShareStorage = new MemoryCache();\n\n/**\n * 使用请求功能的组合式函数。\n * 支持缓存和异步操作的封装。\n *\n * @template O 请求返回的数据类型。\n * @template I 请求参数的类型。\n * @param {() => Promise<O>} fn 实际的请求函数，返回一个 Promise。\n * @param {UseRequestOptions<I, O>} [options] 请求选项，包括缓存和回调配置。\n * @returns 返回一个对象，包含以下内容：\n * - 异步操作的状态（如 loading、error 等）。\n * - 是否命中缓存（hitCache）。\n * - 是否命中共享请求（hitShare）。\n */\nexport function useRequest<I extends AnyArray, O>(\n  fn: (...inputs: I) => Promise<O>,\n  options: Omit<UseRequestOptions<I, O>, 'placeholder'> & {\n    placeholder: () => O;\n  },\n): UseRequestOutputFilled<I, O>;\nexport function useRequest<I extends AnyArray, O>(\n  fn: (...inputs: I) => Promise<O>,\n  options?: UseRequestOptions<I, O>,\n): UseRequestOutput<I, O>;\nexport function useRequest<I extends AnyArray, O>(\n  fn: (...inputs: I) => Promise<O>,\n  options?: UseRequestOptions<I, O>,\n): UseRequestOutput<I, O> {\n  const { id, cache, share, onCacheHit } = options || {};\n\n  const shareStorage = defaultShareStorage as MemoryCache<Promise<O>>;\n  const shareAble = isObject(share) ? !share.disabled : share;\n  const shareOptions = isObject(share) ? share : {};\n  const hitShare = ref(false);\n\n  const _cached = defaultCacheStorage as Cache<O>;\n  const cacheStorage = isObject(cache) ? cache.storage || _cached : _cached;\n  const cacheAble = isObject(cache) ? !cache.disabled : cache;\n  const cacheOptions = isObject(cache) ? cache : {};\n  const hitCache = ref(false);\n\n  const cacheableFn = async (...inputs: I) => {\n    const requestId = isFunction(id) ? id() : id;\n\n    hitShare.value = false;\n    hitCache.value = false;\n\n    if (requestId && shareAble) {\n      const shared = shareStorage.get(requestId);\n      if (shared) {\n        hitShare.value = true;\n        const [err, data] = await tryFlatten(shared.data);\n        if (err) {\n          shareStorage.del(requestId);\n          throw err;\n        }\n\n        return data;\n      }\n    }\n\n    // 这里不能先执行，因为如果要缓存的话，必须用缓存结果\n    const { promise, resolve, reject } = Promise.withResolvers<O>();\n\n    if (requestId && shareAble) {\n      shareStorage.set(requestId, promise, shareOptions);\n    }\n\n    if (requestId && cacheAble) {\n      const cached = await cacheStorage.get(requestId);\n\n      if (cached) {\n        const data = cached.data;\n        resolve(data);\n        hitCache.value = true;\n        await onCacheHit?.(cached);\n        return promise;\n      }\n    }\n\n    const [err, data] = await tryFlatten(fn(...inputs));\n\n    if (err) {\n      reject(err);\n      return promise;\n    }\n\n    if (requestId && cacheAble) {\n      cacheStorage.set(requestId, data, cacheOptions);\n    }\n\n    resolve(data);\n    return promise;\n  };\n  const {\n    state: asyncState,\n    run: send,\n    runAsync: sendAsync,\n    ...async\n  } = useAsync(cacheableFn, options);\n\n  const state = computed(() => ({\n    ...asyncState.value,\n    hitShare: hitShare.value,\n    hitCache: hitCache.value,\n  }));\n\n  return {\n    ...async,\n    state,\n    send,\n    sendAsync,\n    hitShare,\n    hitCache,\n  };\n}\n"],"mappings":";;;;;;;AAyJA,IAAM,sBAAsB,IAAI,4BAAA,aAAa;AAC7C,IAAM,sBAAsB,IAAI,4BAAA,aAAa;AAyB7C,SAAgB,WACd,IACA,SACwB;CACxB,MAAM,EAAE,IAAI,OAAO,OAAO,eAAe,WAAW,EAAE;CAEtD,MAAM,eAAe;CACrB,MAAM,aAAA,GAAA,2BAAA,UAAqB,MAAM,GAAG,CAAC,MAAM,WAAW;CACtD,MAAM,gBAAA,GAAA,2BAAA,UAAwB,MAAM,GAAG,QAAQ,EAAE;CACjD,MAAM,YAAA,GAAA,IAAA,KAAe,MAAM;CAE3B,MAAM,UAAU;CAChB,MAAM,gBAAA,GAAA,2BAAA,UAAwB,MAAM,GAAG,MAAM,WAAW,UAAU;CAClE,MAAM,aAAA,GAAA,2BAAA,UAAqB,MAAM,GAAG,CAAC,MAAM,WAAW;CACtD,MAAM,gBAAA,GAAA,2BAAA,UAAwB,MAAM,GAAG,QAAQ,EAAE;CACjD,MAAM,YAAA,GAAA,IAAA,KAAe,MAAM;CAE3B,MAAM,cAAc,OAAO,GAAG,WAAc;EAC1C,MAAM,aAAA,GAAA,2BAAA,YAAuB,GAAG,GAAG,IAAI,GAAG;EAE1C,SAAS,QAAQ;EACjB,SAAS,QAAQ;EAEjB,IAAI,aAAa,WAAW;GAC1B,MAAM,SAAS,aAAa,IAAI,UAAU;GAC1C,IAAI,QAAQ;IACV,SAAS,QAAQ;IACjB,MAAM,CAAC,KAAK,QAAQ,OAAA,GAAA,0BAAA,YAAiB,OAAO,KAAK;IACjD,IAAI,KAAK;KACP,aAAa,IAAI,UAAU;KAC3B,MAAM;;IAGR,OAAO;;;EAKX,MAAM,EAAE,SAAS,SAAS,WAAW,QAAQ,eAAkB;EAE/D,IAAI,aAAa,WACf,aAAa,IAAI,WAAW,SAAS,aAAa;EAGpD,IAAI,aAAa,WAAW;GAC1B,MAAM,SAAS,MAAM,aAAa,IAAI,UAAU;GAEhD,IAAI,QAAQ;IACV,MAAM,OAAO,OAAO;IACpB,QAAQ,KAAK;IACb,SAAS,QAAQ;IACjB,MAAM,aAAa,OAAO;IAC1B,OAAO;;;EAIX,MAAM,CAAC,KAAK,QAAQ,OAAA,GAAA,0BAAA,YAAiB,GAAG,GAAG,OAAO,CAAC;EAEnD,IAAI,KAAK;GACP,OAAO,IAAI;GACX,OAAO;;EAGT,IAAI,aAAa,WACf,aAAa,IAAI,WAAW,MAAM,aAAa;EAGjD,QAAQ,KAAK;EACb,OAAO;;CAET,MAAM,EACJ,OAAO,YACP,KAAK,MACL,UAAU,WACV,GAAG,UACD,cAAA,SAAS,aAAa,QAAQ;CAElC,MAAM,SAAA,GAAA,IAAA,iBAAwB;EAC5B,GAAG,WAAW;EACd,UAAU,SAAS;EACnB,UAAU,SAAS;EACpB,EAAE;CAEH,OAAO;EACL,GAAG;EACH;EACA;EACA;EACA;EACA;EACD"}

package/dist/request.d.ts

@@ -1,4 +1,4 @@
-import { Cache, CacheOptions, Cached } from '@cloudcome/utils-core/cache';
+import { Cache, Cached, CacheOptions } from '@cloudcome/utils-core/cache';
 import { DateValue } from '@cloudcome/utils-core/date';
 import { AnyArray, MaybeCallable } from '@cloudcome/utils-core/types';
 import { ComputedRef, Ref } from 'vue';