@cloudcome/utils-uni 1.22.1 → 1.23.0

package/dist/app.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const shared = require("@cloudcome/utils-vue/shared");
+const uniApp = require("@dcloudio/uni-app");
+function useAppShow(appShow) {
+  shared._runLifeHook(uniApp.onShow, uniApp.onHide, appShow);
+}
+exports.useAppShow = useAppShow;
+//# sourceMappingURL=app.cjs.map

package/dist/app.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.cjs","sources":["../src/app.ts"],"sourcesContent":["import type { HookListenerWithDispose } from '@cloudcome/utils-vue/component';\nimport { _runLifeHook } from '@cloudcome/utils-vue/shared';\nimport { onHide, onShow } from '@dcloudio/uni-app';\n\n/**\n * 应用显示状态生命周期钩子函数\n *\n * 该函数用于监听应用从后台进入前台的生命周期事件。\n * 当应用从后台切换到前台时触发 onShow 回调，\n * 当应用从前台切换到后台时触发 onHide 回调。\n *\n * @param appShow - 应用显示状态变化时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * useAppShow(() => {\n *   console.log('应用进入前台');\n *\n *   // 可选：返回一个清理函数，在应用进入后台时执行\n *   return () => {\n *     console.log('应用进入后台');\n *   };\n * });\n *\n * @example\n * // 带有异步操作的用法\n * useAppShow(async () => {\n *   // 应用进入前台时刷新数据\n *   await refreshUserData();\n *\n *   // 返回清理函数\n *   return () => {\n *     // 应用进入后台时保存数据\n *     saveUserData();\n *   };\n * });\n */\nexport function useAppShow(appShow: HookListenerWithDispose) {\n  _runLifeHook(onShow, onHide, appShow);\n}\n"],"names":["_runLifeHook","onShow","onHide"],"mappings":";;;;AAqCO,SAAS,WAAW,SAAkC;AAC9CA,sBAAAC,OAAAA,QAAQC,eAAQ,OAAO;AACtC;;"}

package/dist/app.d.ts

@@ -0,0 +1,35 @@
+import { HookListenerWithDispose } from '@cloudcome/utils-vue/component';
+/**
+ * 应用显示状态生命周期钩子函数
+ *
+ * 该函数用于监听应用从后台进入前台的生命周期事件。
+ * 当应用从后台切换到前台时触发 onShow 回调，
+ * 当应用从前台切换到后台时触发 onHide 回调。
+ *
+ * @param appShow - 应用显示状态变化时的回调函数，可以返回一个清理函数
+ *
+ * @example
+ * // 基本用法
+ * useAppShow(() => {
+ *   console.log('应用进入前台');
+ *
+ *   // 可选：返回一个清理函数，在应用进入后台时执行
+ *   return () => {
+ *     console.log('应用进入后台');
+ *   };
+ * });
+ *
+ * @example
+ * // 带有异步操作的用法
+ * useAppShow(async () => {
+ *   // 应用进入前台时刷新数据
+ *   await refreshUserData();
+ *
+ *   // 返回清理函数
+ *   return () => {
+ *     // 应用进入后台时保存数据
+ *     saveUserData();
+ *   };
+ * });
+ */
+export declare function useAppShow(appShow: HookListenerWithDispose): void;

package/dist/app.mjs

@@ -0,0 +1,9 @@
+import { _runLifeHook } from "@cloudcome/utils-vue/shared";
+import { onShow, onHide } from "@dcloudio/uni-app";
+function useAppShow(appShow) {
+  _runLifeHook(onShow, onHide, appShow);
+}
+export {
+  useAppShow
+};
+//# sourceMappingURL=app.mjs.map

package/dist/app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.mjs","sources":["../src/app.ts"],"sourcesContent":["import type { HookListenerWithDispose } from '@cloudcome/utils-vue/component';\nimport { _runLifeHook } from '@cloudcome/utils-vue/shared';\nimport { onHide, onShow } from '@dcloudio/uni-app';\n\n/**\n * 应用显示状态生命周期钩子函数\n *\n * 该函数用于监听应用从后台进入前台的生命周期事件。\n * 当应用从后台切换到前台时触发 onShow 回调，\n * 当应用从前台切换到后台时触发 onHide 回调。\n *\n * @param appShow - 应用显示状态变化时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * useAppShow(() => {\n *   console.log('应用进入前台');\n *\n *   // 可选：返回一个清理函数，在应用进入后台时执行\n *   return () => {\n *     console.log('应用进入后台');\n *   };\n * });\n *\n * @example\n * // 带有异步操作的用法\n * useAppShow(async () => {\n *   // 应用进入前台时刷新数据\n *   await refreshUserData();\n *\n *   // 返回清理函数\n *   return () => {\n *     // 应用进入后台时保存数据\n *     saveUserData();\n *   };\n * });\n */\nexport function useAppShow(appShow: HookListenerWithDispose) {\n  _runLifeHook(onShow, onHide, appShow);\n}\n"],"names":[],"mappings":";;AAqCO,SAAS,WAAW,SAAkC;AAC9C,eAAA,QAAQ,QAAQ,OAAO;AACtC;"}

package/dist/index.cjs

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const VERSION = "1.22.0";
+const VERSION = "1.22.1";
 exports.VERSION = VERSION;
 //# sourceMappingURL=index.cjs.map

package/dist/index.mjs

@@ -1,4 +1,4 @@
-const VERSION = "1.22.0";
+const VERSION = "1.22.1";
 export {
   VERSION
 };

package/dist/page.cjs

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const shared = require("@cloudcome/utils-vue/shared");
 const uniApp = require("@dcloudio/uni-app");
 const vue = require("vue");
 function usePageQuery(onPageLoad) {
@@ -10,5 +11,13 @@ function usePageQuery(onPageLoad) {
   });
   return query;
 }
+function usePageLoad(load) {
+  shared._runLifeHook(uniApp.onLoad, uniApp.onUnload, load);
+}
+function usePageShow(pageShow) {
+  shared._runLifeHook(uniApp.onPageShow, uniApp.onPageHide, pageShow);
+}
+exports.usePageLoad = usePageLoad;
 exports.usePageQuery = usePageQuery;
+exports.usePageShow = usePageShow;
 //# sourceMappingURL=page.cjs.map

package/dist/page.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"page.cjs","sources":["../src/page.ts"],"sourcesContent":["import type { AnyObject } from '@cloudcome/utils-core/types';\nimport { onLoad } from '@dcloudio/uni-app';\nimport { type Reactive, reactive, unref } from 'vue';\n\n/**\n * 用于获取页面参数的 hook 函数\n * @template T - 页面参数对象的类型，继承自 AnyObject\n * @param {function} [onPageLoad] - 页面加载时的回调函数\n * @param {T} onLoad.query - 页面参数对象\n * @returns {T} 响应式的页面参数对象\n * @example\n * // 基本用法\n * const query = usePageQuery();\n *\n * // 带回调的用法\n * const query = usePageQuery((query) => {\n *   console.log('页面参数:', query);\n * });\n *\n * // 指定参数类型\n * interface PageParams {\n *   id: string;\n *   name?: string;\n * }\n * const query = usePageQuery<PageParams>();\n */\nexport function usePageQuery<T extends AnyObject>(onPageLoad?: (query: Reactive<T>) => void) {\n  const query = reactive<T>({} as T);\n\n  onLoad((_query) => {\n    Object.assign(query, _query);\n    onPageLoad?.(query);\n  });\n\n  return query;\n}\n"],"names":["reactive","onLoad"],"mappings":";;;;AA0BO,SAAS,aAAkC,YAA2C;AACrF,QAAA,QAAQA,IAAY,SAAA,EAAO;AAEjCC,SAAA,OAAO,CAAC,WAAW;AACV,WAAA,OAAO,OAAO,MAAM;AAC3B,iBAAa,KAAK;AAAA,EAAA,CACnB;AAEM,SAAA;AACT;;"}
+{"version":3,"file":"page.cjs","sources":["../src/page.ts"],"sourcesContent":["import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { HookListenerWithDispose } from '@cloudcome/utils-vue/component';\nimport { _runLifeHook } from '@cloudcome/utils-vue/shared';\nimport { onHide, onLoad, onPageHide, onPageShow, onShow, onUnload } from '@dcloudio/uni-app';\nimport { type Reactive, reactive, unref } from 'vue';\n\n/**\n * 用于获取页面参数的 hook 函数\n * @template T - 页面参数对象的类型，继承自 AnyObject\n * @param {function} [onPageLoad] - 页面加载时的回调函数\n * @param {T} onLoad.query - 页面参数对象\n * @returns {T} 响应式的页面参数对象\n * @example\n * // 基本用法\n * const query = usePageQuery();\n *\n * // 带回调的用法\n * const query = usePageQuery((query) => {\n *   console.log('页面参数:', query);\n * });\n *\n * // 指定参数类型\n * interface PageParams {\n *   id: string;\n *   name?: string;\n * }\n * const query = usePageQuery<PageParams>();\n */\nexport function usePageQuery<T extends AnyObject>(onPageLoad?: (query: Reactive<T>) => void) {\n  const query = reactive<T>({} as T);\n\n  onLoad((_query) => {\n    Object.assign(query, _query);\n    onPageLoad?.(query);\n  });\n\n  return query;\n}\n\n/**\n * 用于处理页面加载生命周期的 hook 函数\n *\n * 该函数会在页面加载时执行传入的回调函数，并在页面卸载时执行清理操作（如果提供了清理函数）。\n * 它是 uni-app 中 onLoad 和 onUnload 生命周期的封装。\n *\n * @param {HookListenerWithDispose} load - 页面加载时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * usePageLoad(() => {\n *   console.log('页面已加载');\n * });\n *\n * @example\n * // 带清理函数的用法\n * usePageLoad(() => {\n *   console.log('页面已加载');\n *\n *   // 返回一个清理函数，在页面卸载时执行\n *   return () => {\n *     console.log('页面将要卸载');\n *   };\n * });\n *\n * @example\n * // 异步用法\n * usePageLoad(async () => {\n *   const data = await fetchData();\n *   console.log('获取到数据:', data);\n *\n *   return () => {\n *     console.log('清理资源');\n *   };\n * });\n */\nexport function usePageLoad(load: HookListenerWithDispose) {\n  _runLifeHook(onLoad, onUnload, load);\n}\n\n/**\n * 用于处理页面显示生命周期的 hook 函数\n *\n * 该函数会在页面显示时执行传入的回调函数，并在页面隐藏时执行清理操作（如果提供了清理函数）。\n * 它是 uni-app 中 onPageShow 和 onPageHide 生命周期的封装。\n *\n * @param {HookListenerWithDispose} pageShow - 页面显示时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * usePageShow(() => {\n *   console.log('页面已显示');\n * });\n *\n * @example\n * // 带清理函数的用法\n * usePageShow(() => {\n *   console.log('页面已显示');\n *\n *   // 返回一个清理函数，在页面隐藏时执行\n *   return () => {\n *     console.log('页面将要隐藏');\n *   };\n * });\n */\nexport function usePageShow(pageShow: HookListenerWithDispose) {\n  _runLifeHook(onPageShow, onPageHide, pageShow);\n}\n"],"names":["reactive","onLoad","_runLifeHook","onUnload","onPageShow","onPageHide"],"mappings":";;;;;AA4BO,SAAS,aAAkC,YAA2C;AACrF,QAAA,QAAQA,IAAY,SAAA,EAAO;AAEjCC,SAAA,OAAO,CAAC,WAAW;AACV,WAAA,OAAO,OAAO,MAAM;AAC3B,iBAAa,KAAK;AAAA,EAAA,CACnB;AAEM,SAAA;AACT;AAsCO,SAAS,YAAY,MAA+B;AAC5CC,sBAAAD,OAAAA,QAAQE,iBAAU,IAAI;AACrC;AA2BO,SAAS,YAAY,UAAmC;AAChDD,sBAAAE,OAAAA,YAAYC,mBAAY,QAAQ;AAC/C;;;;"}

package/dist/page.d.ts

@@ -1,4 +1,5 @@
 import { AnyObject } from '@cloudcome/utils-core/types';
+import { HookListenerWithDispose } from '@cloudcome/utils-vue/component';
 import { Reactive } from 'vue';
 /**
  * 用于获取页面参数的 hook 函数
@@ -23,3 +24,66 @@ import { Reactive } from 'vue';
  * const query = usePageQuery<PageParams>();
  */
 export declare function usePageQuery<T extends AnyObject>(onPageLoad?: (query: Reactive<T>) => void): Reactive<T>;
+/**
+ * 用于处理页面加载生命周期的 hook 函数
+ *
+ * 该函数会在页面加载时执行传入的回调函数，并在页面卸载时执行清理操作（如果提供了清理函数）。
+ * 它是 uni-app 中 onLoad 和 onUnload 生命周期的封装。
+ *
+ * @param {HookListenerWithDispose} load - 页面加载时的回调函数，可以返回一个清理函数
+ *
+ * @example
+ * // 基本用法
+ * usePageLoad(() => {
+ *   console.log('页面已加载');
+ * });
+ *
+ * @example
+ * // 带清理函数的用法
+ * usePageLoad(() => {
+ *   console.log('页面已加载');
+ *
+ *   // 返回一个清理函数，在页面卸载时执行
+ *   return () => {
+ *     console.log('页面将要卸载');
+ *   };
+ * });
+ *
+ * @example
+ * // 异步用法
+ * usePageLoad(async () => {
+ *   const data = await fetchData();
+ *   console.log('获取到数据:', data);
+ *
+ *   return () => {
+ *     console.log('清理资源');
+ *   };
+ * });
+ */
+export declare function usePageLoad(load: HookListenerWithDispose): void;
+/**
+ * 用于处理页面显示生命周期的 hook 函数
+ *
+ * 该函数会在页面显示时执行传入的回调函数，并在页面隐藏时执行清理操作（如果提供了清理函数）。
+ * 它是 uni-app 中 onPageShow 和 onPageHide 生命周期的封装。
+ *
+ * @param {HookListenerWithDispose} pageShow - 页面显示时的回调函数，可以返回一个清理函数
+ *
+ * @example
+ * // 基本用法
+ * usePageShow(() => {
+ *   console.log('页面已显示');
+ * });
+ *
+ * @example
+ * // 带清理函数的用法
+ * usePageShow(() => {
+ *   console.log('页面已显示');
+ *
+ *   // 返回一个清理函数，在页面隐藏时执行
+ *   return () => {
+ *     console.log('页面将要隐藏');
+ *   };
+ * });
+ */
+export declare function usePageShow(pageShow: HookListenerWithDispose): void;

package/dist/page.mjs

@@ -1,4 +1,5 @@
-import { onLoad } from "@dcloudio/uni-app";
+import { _runLifeHook } from "@cloudcome/utils-vue/shared";
+import { onLoad, onUnload, onPageShow, onPageHide } from "@dcloudio/uni-app";
 import { reactive } from "vue";
 function usePageQuery(onPageLoad) {
   const query = reactive({});
@@ -8,7 +9,15 @@ function usePageQuery(onPageLoad) {
   });
   return query;
 }
+function usePageLoad(load) {
+  _runLifeHook(onLoad, onUnload, load);
+}
+function usePageShow(pageShow) {
+  _runLifeHook(onPageShow, onPageHide, pageShow);
+}
 export {
-  usePageQuery
+  usePageLoad,
+  usePageQuery,
+  usePageShow
 };
 //# sourceMappingURL=page.mjs.map

package/dist/page.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"page.mjs","sources":["../src/page.ts"],"sourcesContent":["import type { AnyObject } from '@cloudcome/utils-core/types';\nimport { onLoad } from '@dcloudio/uni-app';\nimport { type Reactive, reactive, unref } from 'vue';\n\n/**\n * 用于获取页面参数的 hook 函数\n * @template T - 页面参数对象的类型，继承自 AnyObject\n * @param {function} [onPageLoad] - 页面加载时的回调函数\n * @param {T} onLoad.query - 页面参数对象\n * @returns {T} 响应式的页面参数对象\n * @example\n * // 基本用法\n * const query = usePageQuery();\n *\n * // 带回调的用法\n * const query = usePageQuery((query) => {\n *   console.log('页面参数:', query);\n * });\n *\n * // 指定参数类型\n * interface PageParams {\n *   id: string;\n *   name?: string;\n * }\n * const query = usePageQuery<PageParams>();\n */\nexport function usePageQuery<T extends AnyObject>(onPageLoad?: (query: Reactive<T>) => void) {\n  const query = reactive<T>({} as T);\n\n  onLoad((_query) => {\n    Object.assign(query, _query);\n    onPageLoad?.(query);\n  });\n\n  return query;\n}\n"],"names":[],"mappings":";;AA0BO,SAAS,aAAkC,YAA2C;AACrF,QAAA,QAAQ,SAAY,EAAO;AAEjC,SAAO,CAAC,WAAW;AACV,WAAA,OAAO,OAAO,MAAM;AAC3B,iBAAa,KAAK;AAAA,EAAA,CACnB;AAEM,SAAA;AACT;"}
+{"version":3,"file":"page.mjs","sources":["../src/page.ts"],"sourcesContent":["import type { AnyObject } from '@cloudcome/utils-core/types';\nimport type { HookListenerWithDispose } from '@cloudcome/utils-vue/component';\nimport { _runLifeHook } from '@cloudcome/utils-vue/shared';\nimport { onHide, onLoad, onPageHide, onPageShow, onShow, onUnload } from '@dcloudio/uni-app';\nimport { type Reactive, reactive, unref } from 'vue';\n\n/**\n * 用于获取页面参数的 hook 函数\n * @template T - 页面参数对象的类型，继承自 AnyObject\n * @param {function} [onPageLoad] - 页面加载时的回调函数\n * @param {T} onLoad.query - 页面参数对象\n * @returns {T} 响应式的页面参数对象\n * @example\n * // 基本用法\n * const query = usePageQuery();\n *\n * // 带回调的用法\n * const query = usePageQuery((query) => {\n *   console.log('页面参数:', query);\n * });\n *\n * // 指定参数类型\n * interface PageParams {\n *   id: string;\n *   name?: string;\n * }\n * const query = usePageQuery<PageParams>();\n */\nexport function usePageQuery<T extends AnyObject>(onPageLoad?: (query: Reactive<T>) => void) {\n  const query = reactive<T>({} as T);\n\n  onLoad((_query) => {\n    Object.assign(query, _query);\n    onPageLoad?.(query);\n  });\n\n  return query;\n}\n\n/**\n * 用于处理页面加载生命周期的 hook 函数\n *\n * 该函数会在页面加载时执行传入的回调函数，并在页面卸载时执行清理操作（如果提供了清理函数）。\n * 它是 uni-app 中 onLoad 和 onUnload 生命周期的封装。\n *\n * @param {HookListenerWithDispose} load - 页面加载时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * usePageLoad(() => {\n *   console.log('页面已加载');\n * });\n *\n * @example\n * // 带清理函数的用法\n * usePageLoad(() => {\n *   console.log('页面已加载');\n *\n *   // 返回一个清理函数，在页面卸载时执行\n *   return () => {\n *     console.log('页面将要卸载');\n *   };\n * });\n *\n * @example\n * // 异步用法\n * usePageLoad(async () => {\n *   const data = await fetchData();\n *   console.log('获取到数据:', data);\n *\n *   return () => {\n *     console.log('清理资源');\n *   };\n * });\n */\nexport function usePageLoad(load: HookListenerWithDispose) {\n  _runLifeHook(onLoad, onUnload, load);\n}\n\n/**\n * 用于处理页面显示生命周期的 hook 函数\n *\n * 该函数会在页面显示时执行传入的回调函数，并在页面隐藏时执行清理操作（如果提供了清理函数）。\n * 它是 uni-app 中 onPageShow 和 onPageHide 生命周期的封装。\n *\n * @param {HookListenerWithDispose} pageShow - 页面显示时的回调函数，可以返回一个清理函数\n *\n * @example\n * // 基本用法\n * usePageShow(() => {\n *   console.log('页面已显示');\n * });\n *\n * @example\n * // 带清理函数的用法\n * usePageShow(() => {\n *   console.log('页面已显示');\n *\n *   // 返回一个清理函数，在页面隐藏时执行\n *   return () => {\n *     console.log('页面将要隐藏');\n *   };\n * });\n */\nexport function usePageShow(pageShow: HookListenerWithDispose) {\n  _runLifeHook(onPageShow, onPageHide, pageShow);\n}\n"],"names":[],"mappings":";;;AA4BO,SAAS,aAAkC,YAA2C;AACrF,QAAA,QAAQ,SAAY,EAAO;AAEjC,SAAO,CAAC,WAAW;AACV,WAAA,OAAO,OAAO,MAAM;AAC3B,iBAAa,KAAK;AAAA,EAAA,CACnB;AAEM,SAAA;AACT;AAsCO,SAAS,YAAY,MAA+B;AAC5C,eAAA,QAAQ,UAAU,IAAI;AACrC;AA2BO,SAAS,YAAY,UAAmC;AAChD,eAAA,YAAY,YAAY,QAAQ;AAC/C;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudcome/utils-uni",
-  "version": "1.22.1",
+  "version": "1.23.0",
   "description": "cloudcome utils for uni-app",
   "engines": {
     "node": ">=22"
@@ -14,6 +14,11 @@
       "require": "./dist/index.cjs"
     },
     "./package.json": "./package.json",
+    "./app": {
+      "types": "./dist/app.d.ts",
+      "import": "./dist/app.mjs",
+      "require": "./dist/app.cjs"
+    },
     "./client": {
       "types": "./dist/client.d.ts",
       "import": "./dist/client.mjs",
@@ -37,6 +42,9 @@
   },
   "typesVersions": {
     "*": {
+      "app": [
+        "./dist/app.d.ts"
+      ],
       "client": [
         "./dist/client.d.ts"
       ],
@@ -59,7 +67,7 @@
   ],
   "dependencies": {
     "@cloudcome/utils-core": "~1.14.1",
-    "@cloudcome/utils-vue": "~1.10.1",
+    "@cloudcome/utils-vue": "~1.11.0",
     "@dcloudio/types": "^3.4.21",
     "@dcloudio/uni-app": "vue3",
     "vue": "^3.5.13",