@fairys/taro-tools-react 0.0.1

package/esm/context/global.data.instance.js

@@ -0,0 +1,66 @@
+import { proxy, ref, useSnapshot } from "valtio";
+import utils_navigate from "../utils/navigate.js";
+import { createUseId } from "../utils/useId.js";
+import { ProxyInstanceObjectBase } from "../utils/valtio/instance.js";
+class GlobalDataInstance extends ProxyInstanceObjectBase {
+    loginPageRoute = 'pages/login/index';
+    store = proxy({
+        messageData: ref([]),
+        toastData: void 0
+    });
+    showMessage = (options, timeout = 3000)=>{
+        const _that = this;
+        let newItem = {
+            ...options
+        };
+        if (!_that.store.messageData) _that.store.messageData = ref([]);
+        newItem.visible = true;
+        if (!newItem.__id) newItem.__id = `${new Date().valueOf()}__${_that.store.messageData.length + 1}__` + createUseId('message');
+        _that.store.messageData = ref([
+            ..._that.store.messageData
+        ].concat([
+            newItem
+        ]));
+        if (timeout) {
+            const timer = setTimeout(()=>{
+                newItem.visible = false;
+                _that.store.messageData = ref((_that.store.messageData || []).filter((it)=>it.__id !== newItem.__id));
+                clearTimeout(timer);
+            }, timeout);
+        }
+        return newItem.__id;
+    };
+    hideMessage = (id)=>{
+        this.store.messageData = ref((this.store.messageData || []).filter((it)=>it.__id !== id));
+    };
+    showToast = (config = {})=>{
+        this.store.toastData = ref({
+            visible: true,
+            ...config
+        });
+    };
+    hideToast = ()=>{
+        this.store.toastData = ref({
+            ...this.store.toastData,
+            visible: false
+        });
+    };
+    toLoginPage = ()=>{
+        const isLoginPage = utils_navigate.isCurrentPage(this.loginPageRoute || '');
+        const _loginPageRoute = `${this.loginPageRoute || ''}`.replace(/^\//, '');
+        if (isLoginPage) return;
+        utils_navigate.navigateTo({
+            url: `/${_loginPageRoute}`
+        });
+    };
+}
+const globalDataInstance = new GlobalDataInstance();
+const useGlobalData = ()=>{
+    const store = useSnapshot(globalDataInstance.store);
+    return [
+        store,
+        globalDataInstance,
+        store.__defaultValue
+    ];
+};
+export { GlobalDataInstance, globalDataInstance, useGlobalData };

package/esm/context/global.setting.data.instance.d.ts

@@ -0,0 +1,28 @@
+import { ProxyInstanceObjectBase } from '../utils/valtio/instance';
+export interface GlobalSettingDataInstanceState {
+    /**
+     * 请求成功返回code
+     * @default 200
+     */
+    requestSuccessCode?: number;
+    /**数据默认值不使用*/
+    __defaultValue?: string;
+}
+export declare class GlobalSettingDataInstance extends ProxyInstanceObjectBase<GlobalSettingDataInstanceState> {
+    store: GlobalSettingDataInstanceState;
+    /**
+     * 扩展全局设置数据状态
+     */
+    extendStore: (state: Partial<GlobalSettingDataInstanceState>) => void;
+}
+/**
+ * 全局设置数据实例
+ */
+export declare const globalSettingDataInstance: GlobalSettingDataInstance;
+/**
+ * 全局设置数据状态管理
+ */
+export declare const useGlobalSettingData: () => readonly [{
+    readonly requestSuccessCode?: number;
+    readonly __defaultValue?: string;
+}, GlobalSettingDataInstance, string];

package/esm/context/global.setting.data.instance.js

@@ -0,0 +1,20 @@
+import { proxy, useSnapshot } from "valtio";
+import { ProxyInstanceObjectBase } from "../utils/valtio/instance.js";
+class GlobalSettingDataInstance extends ProxyInstanceObjectBase {
+    store = proxy({
+        requestSuccessCode: 200
+    });
+    extendStore = (state)=>{
+        this._setValues(state);
+    };
+}
+const globalSettingDataInstance = new GlobalSettingDataInstance();
+const useGlobalSettingData = ()=>{
+    const store = useSnapshot(globalSettingDataInstance.store);
+    return [
+        store,
+        globalSettingDataInstance,
+        store.__defaultValue
+    ];
+};
+export { GlobalSettingDataInstance, globalSettingDataInstance, useGlobalSettingData };

package/esm/context/index.d.ts

@@ -0,0 +1,4 @@
+export * from './global.data.instance';
+export * from './page.data.instance';
+export * from './page.info.data.instance';
+export * from './global.setting.data.instance';

package/esm/context/index.js

@@ -0,0 +1,4 @@
+export * from "./global.data.instance.js";
+export * from "./page.data.instance.js";
+export * from "./page.info.data.instance.js";
+export * from "./global.setting.data.instance.js";

package/esm/context/page.data.instance.d.ts

@@ -0,0 +1,71 @@
+import { ProxyInstanceObjectBase } from '../utils/valtio/instance';
+export interface PageDataInstanceState extends Object {
+    /**loading存储*/
+    loading?: Record<string, boolean>;
+    /**当前页*/
+    page?: number;
+    /**分页数*/
+    pageSize?: number;
+    /**总数*/
+    total?: number;
+    /**是否最后一页*/
+    hasLastPage?: boolean;
+    /**查询条件*/
+    search?: Object;
+    /**表格数据*/
+    dataList?: any[];
+    /**选择行数据*/
+    selectedRows?: any[];
+    selectedRowKeys?: any[];
+    /**数据默认值不使用*/
+    __defaultValue?: string;
+    [s: string]: any;
+}
+export declare class PageDataInstance<T extends PageDataInstanceState = PageDataInstanceState> extends ProxyInstanceObjectBase<T> {
+    /**是否滚动加载分页*/
+    is_scroll_page: boolean;
+    /**默认值*/
+    defaultInital: T;
+    requestConfig?: {
+        /**请求之前处理参数*/
+        onBefore?: (payload: any, store: T) => Partial<T>;
+        /**请求接口*/
+        getList?: (payload: any) => Promise<{
+            code?: number;
+            data?: any;
+            message?: string;
+        }>;
+        /**请求之后处理返回值进行存储*/
+        onAfter?: (data: Record<string, any>) => Partial<T>;
+        /** code!==1 时 触发*/
+        onError?: (data: Record<string, any>) => void;
+    };
+    constructor(options?: PageDataOptions<T>);
+    store: T;
+    /**初始化状态值*/
+    main_page_store: (initalValues?: Partial<T>, file?: string[]) => this;
+    /**更新页面级的 pageLoading */
+    updatedLoading: (loading?: boolean) => void;
+    /**内置——查询列表*/
+    main_getList: () => Promise<void>;
+    /**内置——翻页*/
+    main_onPageChange: (page: number) => void;
+    /**内置——翻页切换*/
+    main_onShowSizeChange: (_: number, pageSize: number) => void;
+    /**内置——查询方法*/
+    main_onSearch: () => void;
+    /**加载更多*/
+    main_onLoadMore: () => void;
+}
+export interface PageDataOptions<T extends PageDataInstanceState = PageDataInstanceState> {
+    /**请求配置*/
+    requestConfig?: PageDataInstance<T>['requestConfig'];
+    /**初始值*/
+    initialValues?: Partial<T>;
+    /**是否滚动加载更多*/
+    is_scroll_page?: boolean;
+}
+/**
+ * 页面级数据状态管理
+ */
+export declare const usePageData: <T extends PageDataInstanceState = PageDataInstanceState>(options?: PageDataOptions<T>) => readonly [T, PageDataInstance<T>, string];

package/esm/context/page.data.instance.js

@@ -0,0 +1,139 @@
+import { proxy, ref, useSnapshot } from "valtio";
+import { ProxyInstanceObjectBase } from "../utils/valtio/instance.js";
+import { useRef } from "react";
+import { globalSettingDataInstance } from "./global.setting.data.instance.js";
+class PageDataInstance extends ProxyInstanceObjectBase {
+    is_scroll_page = true;
+    defaultInital = {
+        page: 1,
+        pageSize: 10,
+        total: 0,
+        search: ref({}),
+        dataList: ref([]),
+        selectedRows: ref([]),
+        selectedRowKeys: ref([]),
+        loading: {
+            pageLoading: false
+        },
+        hasLastPage: false
+    };
+    requestConfig = {};
+    constructor(options){
+        super();
+        if (options?.initialValues) this.main_page_store(options.initialValues);
+        if (options.requestConfig) this.requestConfig = options.requestConfig || {};
+        if (options?.is_scroll_page !== void 0) this.is_scroll_page = options?.is_scroll_page;
+    }
+    store = proxy({
+        ...this.defaultInital
+    });
+    main_page_store = (initalValues = {}, file)=>{
+        const newStore = {
+            ...this.defaultInital,
+            ...initalValues
+        };
+        return this._ctor(newStore, [
+            ...file || [],
+            'loading'
+        ]);
+    };
+    updatedLoading = (loading = true)=>{
+        if ('object' == typeof this.store?.loading) this.store.loading.pageLoading = loading;
+        else this.store.loading = {
+            pageLoading: loading
+        };
+    };
+    main_getList = async ()=>{
+        if (!this.requestConfig?.getList) return void console.error("\u672A\u914D\u7F6E requestConfig.getList \u8BF7\u6C42\u65B9\u6CD5");
+        try {
+            this.updatedLoading(true);
+            const payload = {
+                ...this.store.search,
+                page: this.store.page,
+                pageSize: this.store.pageSize
+            };
+            let newParams = {
+                ...payload
+            };
+            if (this.requestConfig?.onBefore) newParams = this.requestConfig.onBefore(payload, this.store);
+            const result = await this.requestConfig.getList?.(newParams);
+            this.updatedLoading(false);
+            this.store.loading.loadMore = false;
+            if (result && result.code === globalSettingDataInstance.store.requestSuccessCode) {
+                let saveData = {};
+                if (this.requestConfig?.onAfter) saveData = this.requestConfig.onAfter(result);
+                else {
+                    const dataList = result?.data?.list || result?.data?.records || [];
+                    let newDataList = [];
+                    if (1 === this.store.page) newDataList = dataList;
+                    else if (this.is_scroll_page) newDataList = [
+                        ...this.store.dataList,
+                        ...dataList
+                    ];
+                    saveData = {
+                        dataList: newDataList,
+                        total: result?.data?.total || 0
+                    };
+                    if (1 === this.store.page) {
+                        saveData.selectedRows = ref([]);
+                        saveData.selectedRowKeys = ref([]);
+                    }
+                }
+                if (saveData) this._setValues(saveData);
+            } else if (this.requestConfig?.onError) this.requestConfig.onError(result);
+        } catch (error) {
+            console.log(error);
+            this.store.loading.loadMore = false;
+            this.updatedLoading(false);
+        }
+    };
+    main_onPageChange = (page)=>{
+        this._setValues({
+            page
+        });
+        this.main_getList();
+    };
+    main_onShowSizeChange = (_, pageSize)=>{
+        this._setValues({
+            page: 1,
+            pageSize
+        });
+        this.main_getList();
+    };
+    main_onSearch = ()=>{
+        this.main_onPageChange(1);
+    };
+    main_onLoadMore = ()=>{
+        if (this.store.loading?.pageLoading) return;
+        const total = this.store.total || 0;
+        const page = this.store.page || 1;
+        const pageSize = this.store.pageSize || 20;
+        const count = Math.ceil(total / pageSize);
+        let hasLastPage = false;
+        if (page >= count && total) {
+            hasLastPage = true;
+            this._setValues({
+                hasLastPage
+            });
+            return;
+        }
+        const nextPage = page + 1;
+        if (nextPage >= count && total) hasLastPage = true;
+        this.store.loading.loadMore = true;
+        this._setValues({
+            page: nextPage,
+            hasLastPage
+        });
+        this.main_getList();
+    };
+}
+const usePageData = (options = {})=>{
+    const pageDataInstance = useRef(new PageDataInstance(options)).current;
+    const store = useSnapshot(pageDataInstance.store);
+    return [
+        store,
+        pageDataInstance,
+        store.__defaultValue
+    ];
+};
+export { PageDataInstance, usePageData };

package/esm/context/page.info.data.instance.d.ts

@@ -0,0 +1,72 @@
+import { ProxyInstanceObjectBase } from '../utils/valtio/instance';
+export interface PageInfoDataInstanceState extends Object {
+    /**loading存储*/
+    loading?: Record<string, boolean>;
+    /**编辑表单数据*/
+    editFormData?: Record<string, any>;
+    /**编辑类型*/
+    editType?: 'add' | 'edit' | 'info';
+    /**查询详情是否成功*/
+    isInfoSuccess?: boolean;
+    /**数据默认值不使用*/
+    __defaultValue?: string;
+    [s: string]: any;
+}
+export declare class PageInfoDataInstance<T extends PageInfoDataInstanceState = PageInfoDataInstanceState> extends ProxyInstanceObjectBase<T> {
+    /**默认值*/
+    defaultInital: T;
+    requestInfoConfig?: {
+        /**详情查询-请求之前处理参数*/
+        onBefore?: (store: T) => Promise<Partial<T>> | Partial<T>;
+        /**详情查询-请求接口*/
+        getInfo?: (payload: any) => Promise<{
+            code?: number;
+            data?: any;
+            message?: string;
+        }>;
+        /**详情查询-请求之后处理返回值进行存储*/
+        onAfter?: (data: Record<string, any>) => Partial<T>;
+        /**详情查询-code!==1 时 触发*/
+        onError?: (data: Record<string, any>) => void;
+    };
+    requestSaveInfoConfig?: {
+        /**详情保存-请求之前处理参数*/
+        onSaveBefore?: (store: T) => Promise<Record<string, any>> | Record<string, any>;
+        /**详情保存接口*/
+        onSaveInfo?: (payload: any) => Promise<{
+            code?: number;
+            data?: any;
+            message?: string;
+        }>;
+        /**详情保存-请求之后处理返回值进行存储*/
+        onSaveAfter?: (data: Record<string, any>) => void;
+        /**详情查询-code!==1 时 触发*/
+        onSaveError?: (data: Record<string, any>) => void;
+        /**保存成功-跳转页面*/
+        saveSuccessNavigate?: string | 'navigateBack' | number | ((data: any) => void);
+        /**是否显示成功提示*/
+        isShowSuccessMessage?: boolean;
+    };
+    constructor(options?: PageInfoDataOptions<T>);
+    store: T;
+    /**初始化状态值*/
+    main_page_store: (initalValues?: Partial<T>, file?: string[]) => this;
+    /**更新页面级的 pageLoading */
+    updatedLoading: (loading?: boolean) => void;
+    /**内置——查询详细信息*/
+    main_getInfo: () => Promise<void>;
+    /**保存数据*/
+    main_saveInfo: () => Promise<void>;
+}
+export interface PageInfoDataOptions<T extends PageInfoDataInstanceState = PageInfoDataInstanceState> {
+    /**详情查询请求配置*/
+    requestInfoConfig?: PageInfoDataInstance<T>['requestInfoConfig'];
+    /**详情保存请求配置*/
+    requestSaveInfoConfig?: PageInfoDataInstance<T>['requestSaveInfoConfig'];
+    /**初始值*/
+    initialValues?: Partial<T>;
+}
+/**
+ * 页面级数据状态管理
+ */
+export declare const usePageInfoData: <T extends PageInfoDataInstanceState = PageInfoDataInstanceState>(options?: PageInfoDataOptions<T>) => readonly [T, PageInfoDataInstance<T>, string];

package/esm/context/page.info.data.instance.js

@@ -0,0 +1,107 @@
+import { proxy, useSnapshot } from "valtio";
+import { ProxyInstanceObjectBase } from "../utils/valtio/instance.js";
+import { useRef } from "react";
+import utils_navigate from "../utils/navigate.js";
+import { globalDataInstance } from "./global.data.instance.js";
+import { globalSettingDataInstance } from "./global.setting.data.instance.js";
+class PageInfoDataInstance extends ProxyInstanceObjectBase {
+    defaultInital = {
+        editType: 'add',
+        editFormData: {},
+        isInfoSuccess: false,
+        loading: {
+            pageLoading: false
+        }
+    };
+    requestInfoConfig;
+    requestSaveInfoConfig = {};
+    constructor(options){
+        super();
+        if (options?.initialValues) this.main_page_store(options.initialValues);
+        if (options.requestInfoConfig) this.requestInfoConfig = options.requestInfoConfig || {};
+        if (options.requestSaveInfoConfig) this.requestSaveInfoConfig = options.requestSaveInfoConfig || {};
+    }
+    store = proxy({
+        ...this.defaultInital
+    });
+    main_page_store = (initalValues = {}, file)=>{
+        const newStore = {
+            ...this.defaultInital,
+            ...initalValues
+        };
+        return this._ctor(newStore, [
+            ...file || [],
+            'loading'
+        ]);
+    };
+    updatedLoading = (loading = true)=>{
+        if ('object' == typeof this.store?.loading) this.store.loading.pageLoading = loading;
+        else this.store.loading = {
+            pageLoading: loading
+        };
+    };
+    main_getInfo = async ()=>{
+        if (!this.requestInfoConfig?.getInfo) return void console.error("\u672A\u914D\u7F6E requestInfoConfig.getInfo \u8BF7\u6C42\u65B9\u6CD5");
+        try {
+            this.updatedLoading(true);
+            let newParams = {};
+            if (this.requestInfoConfig?.onBefore) newParams = await this.requestInfoConfig.onBefore(this.store);
+            const result = await this.requestInfoConfig.getInfo?.(newParams);
+            this.updatedLoading(false);
+            if (result && result.code === globalSettingDataInstance.store.requestSuccessCode) {
+                let saveData = {};
+                saveData = this.requestInfoConfig?.onAfter ? this.requestInfoConfig.onAfter(result) : {
+                    editFormData: {
+                        ...result?.data
+                    }
+                };
+                if (saveData) this._setValues({
+                    ...saveData,
+                    isInfoSuccess: true
+                });
+            } else if (this.requestInfoConfig?.onError) this.requestInfoConfig.onError(result);
+        } catch (error) {
+            console.log(error);
+            this.updatedLoading(false);
+        }
+    };
+    main_saveInfo = async ()=>{
+        try {
+            if (this.requestSaveInfoConfig?.onSaveInfo) return void console.error("\u672A\u914D\u7F6E requestSaveInfoConfig.onSaveInfo \u8BF7\u6C42\u65B9\u6CD5");
+            this.updatedLoading(true);
+            const newParams = await this.requestSaveInfoConfig?.onSaveBefore?.(this.store);
+            const result = await this.requestSaveInfoConfig.onSaveInfo?.(newParams);
+            this.updatedLoading(false);
+            if (result && result.code === globalSettingDataInstance.store.requestSuccessCode) {
+                if (this.requestSaveInfoConfig?.isShowSuccessMessage !== false) globalDataInstance.showMessage({
+                    content: result.message || "\u4FDD\u5B58\u6210\u529F"
+                });
+                if (this.requestSaveInfoConfig?.onSaveAfter) this.requestSaveInfoConfig.onSaveAfter(result);
+                const saveSuccessNavigate = this.requestSaveInfoConfig?.saveSuccessNavigate;
+                if (saveSuccessNavigate) {
+                    if ('navigateBack' === saveSuccessNavigate) utils_navigate.navigateBack();
+                    else if ('function' == typeof saveSuccessNavigate) saveSuccessNavigate(result);
+                    else if ('number' == typeof saveSuccessNavigate) utils_navigate.navigateBack({
+                        delta: saveSuccessNavigate
+                    });
+                    else if ('string' == typeof saveSuccessNavigate) utils_navigate.navigateTo({
+                        url: saveSuccessNavigate
+                    });
+                }
+            } else if (this.requestSaveInfoConfig?.onSaveError) this.requestSaveInfoConfig.onSaveError(result);
+        } catch (error) {
+            console.log(error);
+            this.updatedLoading(false);
+        }
+    };
+}
+const usePageInfoData = (options = {})=>{
+    const pageDataInstance = useRef(new PageInfoDataInstance(options)).current;
+    const store = useSnapshot(pageDataInstance.store);
+    return [
+        store,
+        pageDataInstance,
+        store.__defaultValue
+    ];
+};
+export { PageInfoDataInstance, usePageInfoData };

package/esm/index.d.ts

@@ -0,0 +1,3 @@
+export * from './components';
+export * from './context';
+export * from './utils';

package/esm/index.js

@@ -0,0 +1,3 @@
+export * from "./components/index.js";
+export * from "./context/index.js";
+export * from "./utils/index.js";