@astrolimit/vue3-web-hooks 25.10.10 → 25.12.14

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as vue0 from "vue";
-import { Ref, VNode } from "vue";
+import { DefineComponent, FunctionalComponent, Ref, VNode } from "vue";
 import * as _vueuse_core0 from "@vueuse/core";
 import mitt from "mitt";
 import * as _vue_reactivity0 from "@vue/reactivity";
@@ -33,7 +33,7 @@ declare const useDivSize: (target?: Ref<HTMLDivElement | undefined> | HTMLDivEle
  * @returns
  */
 declare const useDrawerWidth: (percentage?: number, minWidth?: number) => {
-  drawerWidth: vue0.ComputedRef<number | undefined>;
+  drawerWidth: vue0.ComputedRef<number>;
 };
 //#endregion
 //#region src/hooks/useMitt.d.ts
@@ -78,6 +78,23 @@ declare const useNow: (immediate?: boolean) => {
   meridiem: vue0.Ref<string, string>;
 };
 //#endregion
+//#region src/hooks/usePageSize.d.ts
+/**
+ * @example
+ * const pagita = usePageSize()
+ * @returns
+ */
+declare const usePageSize: () => {
+  total: vue0.WritableComputedRef<number, number>;
+  page: vue0.WritableComputedRef<number, number>;
+  pageNo: vue0.WritableComputedRef<number, number>;
+  limit: vue0.WritableComputedRef<number, number>;
+  pageSize: vue0.WritableComputedRef<number, number>;
+  pending: vue0.WritableComputedRef<boolean, boolean>;
+  loading: vue0.WritableComputedRef<boolean, boolean>;
+  resetPageAndFetch(fn: () => Promise<void>): Promise<void>;
+};
+//#endregion
 //#region src/hooks/useStyleSheetLink.d.ts
 /**
  * 基于vue3组合式api的样式注入（动态创建link标签）
@@ -122,13 +139,6 @@ declare const useSortable: <T extends AnyRecord>(params: {
   isSorting: Ref<boolean, boolean>;
 };
 //#endregion
-//#region src/hooks/useTitle.d.ts
-declare const setGlobalAppTitle: (title: string) => void;
-declare const setI18nTransFunc: (t: (val: string) => string) => void;
-declare const getGlobalAppTitle: () => string | undefined;
-declare const getI18nTransFunc: () => ((...args: any[]) => any) | undefined;
-declare const useTitle: (newTitle?: string | Ref<string>) => Ref<string, string>;
-//#endregion
 //#region src/hooks/useViewRefresh.d.ts
 type PlaceholderProps = {
   children?: VNode | VNode[] | null | (() => VNode | VNode[] | null);
@@ -175,4 +185,23 @@ declare function useWatermark(opts?: {
   clear: () => void;
 };
 //#endregion
-export { getGlobalAppTitle, getI18nTransFunc, setGlobalAppTitle, setI18nTransFunc, useDivSize, useDrawerWidth, useInjectMitt, useNetwork, useNewMitt, useNow, useSortable, useStyleSheetLink, useTitle, useViewRefresh, useVueInterval, useWatermark };
+//#region src/ivue/index.d.ts
+/**
+ * 提取函数第一个参数的类型
+ */
+type ExtractFirstParam<T> = T extends ((first: infer U, ...args: any[]) => any) ? U : never;
+/**
+ * Vue 组件类型
+ */
+type IVueComponent = DefineComponent<any, any, any, any> | (new (...args: any[]) => any) | FunctionalComponent<any>;
+type ExtractComponentProps<C> = C extends (new (...args: any[]) => {
+  $props: infer P;
+}) ? P : C extends {
+  new (...args: any[]): any;
+} ? InstanceType<C>['$props'] : C extends DefineComponent<any, any, any, any> ? InstanceType<C>['$props'] : C extends FunctionalComponent<infer P> ? P : never;
+/**
+ * 提取 Vue 组件的 props 类型
+ */
+type IVueProps<T> = Partial<ExtractComponentProps<T>>;
+//#endregion
+export { type ExtractFirstParam, type IVueComponent, type IVueProps, useDivSize, useDrawerWidth, useInjectMitt, useNetwork, useNewMitt, useNow, usePageSize, useSortable, useStyleSheetLink, useViewRefresh, useVueInterval, useWatermark };

package/dist/index.js

@@ -1,8 +1,8 @@
 import _, { cloneDeep } from "lodash";
-import { computed, createElementVNode, defineComponent, getCurrentInstance, inject, isRef, nextTick, onBeforeUnmount, onMounted, onUnmounted, provide, reactive, ref, toRefs, unref, watch } from "vue";
+import { computed, createElementVNode, defineComponent, inject, isRef, nextTick, onBeforeUnmount, onMounted, onUnmounted, provide, reactive, ref, toRefs, unref, watch } from "vue";
 import { tryOnMounted, tryOnUnmounted, useDebounceFn, useWindowSize } from "@vueuse/core";
 import mitt from "mitt";
-import { get, isInteger, isNil, isString } from "lodash-es";
+import { get, isInteger, isNil, toSafeInteger } from "lodash-es";
 import dayjs from "dayjs";
 import Sortable from "sortablejs";
 
@@ -227,6 +227,69 @@ const useNow = (immediate = true) => {
 	};
 };
 
+//#endregion
+//#region src/hooks/usePageSize.ts
+/**
+* @example
+* const pagita = usePageSize()
+* @returns
+*/
+const usePageSize = () => {
+	const _data = reactive({
+		pending: false,
+		total: 0,
+		page: 1,
+		limit: 10
+	});
+	const total = computed({
+		get() {
+			return _data.total;
+		},
+		set(val) {
+			_data.total = toSafeInteger(val);
+		}
+	});
+	const page = computed({
+		get() {
+			return _data.page;
+		},
+		set(val) {
+			_data.page = toSafeInteger(val);
+		}
+	});
+	const limit = computed({
+		get() {
+			return _data.limit;
+		},
+		set(val) {
+			_data.limit = toSafeInteger(val);
+		}
+	});
+	const pending = computed({
+		get() {
+			return _data.pending;
+		},
+		set(val) {
+			_data.pending = val ? true : false;
+		}
+	});
+	return {
+		total,
+		page,
+		pageNo: page,
+		limit,
+		pageSize: limit,
+		pending,
+		loading: pending,
+		async resetPageAndFetch(fn) {
+			_data.pending = true;
+			_data.page = 1;
+			await fn();
+			_data.pending = false;
+		}
+	};
+};
+
 //#endregion
 //#region src/hooks/useStyleSheetLink.ts
 /**
@@ -329,50 +392,6 @@ const useSortable = (params) => {
 	};
 };
 
-//#endregion
-//#region src/hooks/useTitle.ts
-const setGlobalAppTitle = (title) => {
-	const app = getCurrentInstance();
-	if (_.isNil(app)) return;
-	app.appContext.app.config.globalProperties.$appTitle = `${title}`;
-};
-const setI18nTransFunc = (t) => {
-	const app = getCurrentInstance();
-	if (_.isNil(app)) return;
-	if (!_.isFunction(t)) return;
-	app.appContext.app.config.globalProperties.$t = t;
-};
-const getGlobalAppTitle = () => {
-	const app = getCurrentInstance();
-	if (_.isNil(app)) return;
-	if (!_.isString(app.appContext.app.config.globalProperties.$appTitle)) return;
-	return app.appContext.app.config.globalProperties.$appTitle;
-};
-const getI18nTransFunc = () => {
-	const app = getCurrentInstance();
-	if (_.isNil(app)) return;
-	if (!_.isFunction(app.appContext.app.config.globalProperties.$t)) return;
-	return app.appContext.app.config.globalProperties.$t;
-};
-const useTitle = (newTitle) => {
-	const _props = {
-		get t() {
-			return getI18nTransFunc() || ((val) => val);
-		},
-		get appTitle() {
-			return getGlobalAppTitle() || "";
-		}
-	};
-	const title = ref("");
-	watch(() => `${_props.appTitle}-${unref(newTitle)}`, (n, o) => {
-		if (isString(n) && n !== o && document) {
-			title.value = newTitle ? `${_props.appTitle} - ${_props.t(newTitle)}` : _props.appTitle;
-			document.title = title.value;
-		}
-	}, { immediate: true });
-	return title;
-};
-
 //#endregion
 //#region src/hooks/useViewRefresh.ts
 /**
@@ -512,4 +531,4 @@ function useWatermark(opts) {
 }
 
 //#endregion
-export { getGlobalAppTitle, getI18nTransFunc, setGlobalAppTitle, setI18nTransFunc, useDivSize, useDrawerWidth, useInjectMitt, useNetwork, useNewMitt, useNow, useSortable, useStyleSheetLink, useTitle, useViewRefresh, useVueInterval, useWatermark };
+export { useDivSize, useDrawerWidth, useInjectMitt, useNetwork, useNewMitt, useNow, usePageSize, useSortable, useStyleSheetLink, useViewRefresh, useVueInterval, useWatermark };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrolimit/vue3-web-hooks",
-  "version": "25.10.010",
+  "version": "25.12.014",
   "description": "A starter for creating a Vue component library.",
   "type": "module",
   "license": "SFR",