vap1 0.0.1

package/hooks/useApp.d.ts

@@ -0,0 +1,243 @@
+/// <reference types="react" />
+import type { PlainObject } from '../basetype';
+import type { Language } from '../utils/_Support';
+import type { ApiGetRender } from '../utils/Renders/ApiGetRender';
+import type { ApiPostRender } from '../utils/Renders/ApiPostRender';
+import type { Render } from '../utils/Renders/_define';
+/**
+ * 系统皮肤信息
+*/
+export interface GlobalTheme {
+    /**
+     * 皮肤代码
+    */
+    theme: string;
+    /**
+    * Logo 图片
+    */
+    logo: string;
+    /**
+    * 当前语言
+    */
+    lang: Language;
+    /**
+    * 是否暗色模式
+    */
+    darkMode: boolean;
+    /**
+    * 是隐藏导航,在URL 里面加入参数则隐藏，隐藏后只显示内容区
+    * ?__HIDE=true
+    */
+    isHide: boolean;
+    /**
+     * 当前皮肤是否处于 insight 系列皮肤 ，用于一些交互性差异
+     * insight 系列皮肤与普通皮肤有一些差异，一般情况下不要用这个属性，高度问题后续提供方案
+    */
+    isInsight: boolean;
+    /**
+    * 是否为打印模式,在URL 里面加入参数则为打印模式,打印模式页面可与正常页面有所不同
+    * ?__PRINT=true
+    */
+    isPrint: boolean;
+    /**
+    * 内容区域宽度
+    */
+    contentWidth: number;
+    /**
+    * 内容区域高度
+    */
+    contentHeight: number;
+    /**
+     * 是否在全屏状态
+     * */
+    isFullScreen: boolean;
+}
+export type MenuCrumb = {
+    id: string;
+    name: string;
+    icon?: string;
+    path?: string;
+    sign?: string;
+};
+export type OpenOptions = {
+    /**
+     * 打开方式
+     * auto　：自动
+     * blank：　新标签页
+     * self：　本页面
+     * top：　顶层页
+    */
+    target?: 'auto' | 'blank' | 'self' | 'top';
+    /**
+     * 是否进行资源检测，默认为 false,
+     * 如果需要打开还未载入且需要传HASH参数的模块时，可以设为true,否则可能无法找到URL
+    */
+    notCheck?: true;
+    /**
+     * 向下一个页面传 Status 类型参数
+     * 说明 Status 类型参数不会体现在 url 里面，仅支持从 props 里面取出
+    */
+    status?: any;
+};
+/**
+ * 系统菜单信息
+*/
+export interface GlobalMenu {
+    /**
+     * 全部系统菜单
+    */
+    menus: PlainObject[];
+    /**
+     * 当前菜单
+    */
+    current: PlainObject;
+    /**
+     * 当前面包屑导航
+    */
+    crumbs: MenuCrumb[];
+    /**
+     * 方法 - 菜单跳转
+     * @param menu 参数支持
+     * 1. 一个路径：如 /admin/#/user
+     * 2. 一个菜单: 如 { root:'/admin', route:'/user' }
+     * 3. 一个地址: 如 https://www.qq.com ,（弹出新的TAB面面）
+     * 4. 菜单ID :  如 "1" , 将会通过 id 获取具体菜单（打开特殊 sign 菜单用此项）
+     *
+     * @param
+     *
+    */
+    toMenu: (menu: any, options?: OpenOptions) => void;
+}
+/**
+ * 系统用户
+*/
+export interface GlobalUser {
+    /**
+     * 用户信息
+    */
+    info: Record<string, any>;
+    /**
+     * 获取用户自定义kv配置
+     *
+     * getConfig(module)            :  返回 modlue 下所有 kv配置
+     * getConfig(module,key)        :  返回 modlue 下指定 key 配置,如果modlue没有加载的情况下，会载入module下的所有 key
+     * getConfig(module,key,true)   :  返回 modlue 下指定 key 配置,如果modlue没有加载的情况下，会载入module下指定的 key
+    */
+    /**
+     * 获取用户自定义kv配置
+     * 指定 模块 : 返回一个Map
+    */
+    getConfig(module: string): Promise<Map<string, string>>;
+    /**
+     * 获取用户自定义kv配置
+     * 指定 模块 和 key : 返回一个字串
+    */
+    getConfig(module: string, key: string): Promise<string>;
+    /**
+     * 获取用户自定义kv配置
+     * 指定 模块 和 key ， fetch = true: 返回一个字串,强制获取
+    */
+    getConfig(module: string, key: string, fetch: boolean): Promise<string>;
+    /**
+     * 设置用户自定义属性
+    */
+    setConfig: (module: string, key: string, value: string, needUpdate?: boolean) => Promise<boolean>;
+}
+/**
+ * 系统内置 render
+*/
+export interface GlobalRender {
+    /**
+     * 角色 ID => 角色名称，支持多个ID,以逗号分隔
+    */
+    roleRender: ApiGetRender;
+    /**
+    * 机构 CODE => 机构名称
+   */
+    orgRender: ApiPostRender;
+    /**
+    * 通用I P Render,用于统一跳转
+    * 通过 IP 地址生成一个链接
+    */
+    ipRender: (ip: string) => React.ReactNode;
+    /**
+    * 通用 idCard Render,用于统一跳转
+    * 通过 身份证号生成一一个目标链接
+   */
+    idRender: (idCard: string) => React.ReactNode;
+    /**
+    * 通用 应用系统 Render,用于统一跳转
+    * 通过 系统ID生成一个链接
+   */
+    sysRender: ApiPostRender;
+    /**
+     * 常用字符串长度截取的Render
+    */
+    str12Render: Render;
+    str16Render: Render;
+    str20Render: Render;
+    str24Render: Render;
+    str36Render: Render;
+    str48Render: Render;
+    str60Render: Render;
+}
+type ApiTask = {
+    api: string;
+    param?: PlainObject;
+    downApi?: (workId: string, data?: PlainObject) => string;
+};
+type FileTask = {
+    url: string;
+    fileName: string;
+    fileSize?: number;
+    delay?: number;
+};
+/**
+ * 系统通用下载
+*/
+export interface GlobalDownload {
+    /**
+     * 直接下载 说明：
+     * 1. 避免各和应用自己弄自己的下载，提供统一的下载方法，不会弹新窗口
+     * 2. url为下载地址 ，默认下载方法为 GET
+     * 3. 如果下载方法为 POST 需要传第二个参数，使用FormData 方式随请求一起发送
+    */
+    download: (url: string, postParam?: PlainObject) => void;
+    /**
+     * 方法 - 添加下载任务到下载队列 ，有动态进度，需要满足下载规范
+    */
+    addTask: (taskInfo: ApiTask) => void;
+    /**
+     * 方法 - 添加下载链接到下载队列 ，默认直接完成
+     * 通过 delay 可以设置假进度，（常用于延时下载）单位为毫秒，但不一定会准确，例如 delay:5000 可能 会在 4 - 6 秒之间完成
+    */
+    addFileTask: (taskInfo: FileTask) => void;
+}
+export interface App {
+    /**
+     * 全局-皮肤信息
+    */
+    theme: GlobalTheme;
+    /**
+     * 全局-菜单信息
+    */
+    menu: GlobalMenu;
+    /**
+     * 全局-用户信息，用户扩展配置设定方法
+    */
+    user: GlobalUser;
+    /**
+     * 全局-通用 Render
+    */
+    render: GlobalRender;
+    /**
+     * 全局-下载
+    */
+    download: GlobalDownload;
+}
+/**
+ * 返回系统内全局信息
+ * 包括皮肤、菜单、用户、等
+*/
+export declare const useApp: (() => App);
+export {};

package/hooks/useApp.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useApp = void 0;
+const _Support_1 = require("../utils/_Support");
+const react_1 = require("react");
+;
+;
+;
+;
+;
+const _V_APPACTION = (0, _Support_1.globalDefault)('_V_APPACTION', (0, react_1.createContext)(null));
+/**
+ * 返回系统内全局信息
+ * 包括皮肤、菜单、用户、等
+*/
+const useApp = () => (0, react_1.useContext)(_V_APPACTION);
+exports.useApp = useApp;

package/hooks/useArray.d.ts

@@ -0,0 +1,21 @@
+import type { StaticListState, ListInit } from './_list';
+type ArrayOption = ListInit & {
+    /**
+     * 页面大小，默认为 VLIST 大小
+     * 默认为 0 ：为0时，不分页，非0时分页
+     * 说明：如果设置分页，为前端算法处理的假分页，不需要请求后台
+     * */
+    pageSize?: number;
+    /**
+     * 说明：
+     * 使用 api 模式时，会自动请求
+     * 如果不想输入时就请求，需要传 autoLoad = false
+    */
+    autoLoad?: boolean;
+};
+/**
+ * 静态数组 Table，支持 CRUD（不调接口）
+ * 同样适用于 VTable 等组件
+*/
+export declare const useArray: (options: ArrayOption) => StaticListState;
+export {};

package/hooks/useArray.js

@@ -0,0 +1,182 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useArray = void 0;
+const lodash_1 = __importDefault(require("lodash"));
+const react_1 = require("react");
+const antd_1 = require("antd");
+const utils_1 = require("../utils");
+const _list_1 = require("./_list");
+const useSetState_1 = require("./useSetState");
+const useEffectFunction_1 = require("./useEffectFunction");
+const getList = (result) => {
+    if (lodash_1.default.has(result, 'code')) {
+        if (result.code != '0') {
+            if (result.message) {
+                antd_1.message.error(result.message);
+            }
+            return [];
+        }
+        if (lodash_1.default.has(result, 'list')) {
+            return result.list;
+        }
+        if (lodash_1.default.has(result, 'data') && lodash_1.default.isArray(result.data)) {
+            return result.data;
+        }
+        return [];
+    }
+    if (lodash_1.default.isArray(result)) {
+        return result;
+    }
+    return [];
+};
+/**
+ * 静态数组 Table，支持 CRUD（不调接口）
+ * 同样适用于 VTable 等组件
+*/
+const useArray = (options) => {
+    const AllRef = (0, react_1.useRef)(null);
+    const BASE = Object.assign(Object.assign({}, _list_1.DEFAULT_STATE), { pageSize: 0 });
+    if (options.rowKey)
+        BASE.rowKey = options.rowKey;
+    let lastQueryRef = (0, react_1.useRef)(options.param || {});
+    let pageToRef = (0, react_1.useRef)(null);
+    let orderByRef = (0, react_1.useRef)(null);
+    if (options.pageSize && options.pageSize > 0)
+        BASE.pageSize = options.pageSize;
+    const [state, setState] = (0, useSetState_1.useSetState)(BASE);
+    const queryRef = () => {
+        const param = lastQueryRef.current;
+        const pageTo = pageToRef.current;
+        const orderBy = orderByRef.current;
+        let list = AllRef.current.slice(0);
+        lodash_1.default.keys(param).map(field => {
+            if (lodash_1.default.endsWith('_'))
+                return;
+            const keyword = lodash_1.default.toLower(param[field] + '');
+            list = list.filter(item => {
+                if (lodash_1.default.has(item, field)) {
+                    return lodash_1.default.toLower(item[field] + '').indexOf(keyword) >= 0;
+                }
+                return true;
+            });
+        });
+        if (orderBy != null) {
+            list = lodash_1.default.orderBy(list, orderBy.order, orderBy.by);
+        }
+        if (pageTo == null) {
+            setState({ isQuerying: false, list, total: list.length, totalAcc: list.length, param, pageNo: 1, });
+            return;
+        }
+        let start = pageTo.pageSize * (pageTo.pageNo - 1);
+        let count = pageTo.pageSize;
+        setState({ isQuerying: false, list: list.slice(start, count), total: list.length, totalAcc: list.length, param, pageNo: 1, });
+    };
+    const queryApi = () => __awaiter(void 0, void 0, void 0, function* () {
+        const param = lastQueryRef.current;
+        setState({ isQuerying: true });
+        const resp = yield utils_1.Ajax.POST(options.api, param);
+        const list = getList(resp);
+        AllRef.current = list;
+        const pageTo = pageToRef.current;
+        if (pageTo == null) {
+            setState({ isQuerying: false, list, total: list.length, totalAcc: list.length, param, pageNo: 1, });
+            return;
+        }
+        let start = pageTo.pageSize * (pageTo.pageNo - 1);
+        let count = pageTo.pageSize;
+        setState({ isQuerying: false, list: list.slice(start, count), total: list.length, totalAcc: list.length, param, pageNo: 1, });
+    });
+    const query = (param, clean) => {
+        if (clean) {
+            lastQueryRef.current = param || {};
+        }
+        else {
+            lastQueryRef.current = lodash_1.default.merge(lastQueryRef.current, param);
+        }
+        if (lodash_1.default.has(param, 'order_') && lodash_1.default.has(param, 'by_')) {
+            orderByRef.current = { order: param.order_, by: param.by_ };
+        }
+        else {
+            orderByRef.current = null;
+        }
+        if (options.pageSize && options.pageSize > 0) {
+            pageToRef.current = { pageNo: 1, pageSize: options.pageSize };
+        }
+        else {
+            pageToRef.current = null;
+        }
+        if (options.api) {
+            queryApi();
+        }
+        else if (AllRef.current != null && lodash_1.default.isArray(AllRef.current)) {
+            queryRef();
+        }
+        else {
+            console.error('list 与　api 到少需要指定一项');
+        }
+    };
+    (0, useEffectFunction_1.useEffectFunction)(() => {
+        if (lodash_1.default.isArray(options.list))
+            AllRef.current = options.list;
+        if (options.autoLoad !== false)
+            query(options.param || {}, true);
+    });
+    const pageTo = (pageNo, pageSize) => {
+        if (options.pageSize && options.pageSize > 0) {
+            // pageToRef.current = { pageNo: 1, pageSize: options.pageSize }
+            console.error('静态Array默认不翻页，如果需要翻页，需要指定pageSize');
+            return;
+        }
+        pageToRef.current = { pageNo, pageSize };
+        if (AllRef.current != null && lodash_1.default.isArray(AllRef.current)) {
+            queryRef();
+        }
+        else if (options.api) {
+            queryApi();
+        }
+        else {
+            console.error('list 与　api 到少需要指定一项');
+        }
+    };
+    const orderBy = (order, by) => {
+        if (order == null || by == null) {
+            orderByRef.current = null;
+        }
+        else {
+            orderByRef.current = { order, by };
+        }
+        if (AllRef.current != null && lodash_1.default.isArray(AllRef.current)) {
+            queryRef();
+        }
+        else if (options.api) {
+            queryApi();
+        }
+        else {
+            console.error('list 与　api 到少需要指定一项');
+        }
+    };
+    const setList = (list) => {
+        AllRef.current = list.slice();
+        if (options.pageSize && options.pageSize > 0) {
+            pageToRef.current = { pageNo: 1, pageSize: options.pageSize };
+        }
+        else {
+            pageToRef.current = null;
+        }
+        queryRef();
+    };
+    return Object.assign(Object.assign({}, state), { mode: 'static', query, pageTo, orderBy, setList });
+};
+exports.useArray = useArray;

package/hooks/useCounter.js

@@ -0,0 +1,82 @@
+// import { useMemo } from 'react';
+// import { useGetSet } from './useGetSet';
+// import { IHookStateInitAction, IHookStateSetAction, resolveHookState } from './_hookState';
+// interface CounterActions {
+//     inc: (delta?: number) => void;
+//     dec: (delta?: number) => void;
+//     get: () => number;
+//     set: (value: IHookStateSetAction<number>) => void;
+//     reset: (value?: IHookStateSetAction<number>) => void;
+// }
+// type UseCounter = (initialValue?: IHookStateInitAction<number>, max?: number, min?: number) => [number, CounterActions];
+// /**
+//  * 使用方法参考
+//  * https://github.com/streamich/react-use/blob/master/docs/useCounter.md
+// */
+// export const useCounter: UseCounter = (initialValue: IHookStateInitAction<number> = 0, max: number | null = null, min: number | null = null) => {
+//     let init = resolveHookState(initialValue);
+//     typeof init !== 'number' &&
+//         console.error('initialValue has to be a number, got ' + typeof initialValue);
+//     if (typeof min === 'number') {
+//         init = Math.max(init, min);
+//     } else if (min !== null) {
+//         console.error('min has to be a number, got ' + typeof min);
+//     }
+//     if (typeof max === 'number') {
+//         init = Math.min(init, max);
+//     } else if (max !== null) {
+//         console.error('max has to be a number, got ' + typeof max);
+//     }
+//     const [get, setInternal] = useGetSet(init);
+//     return [
+//         get(),
+//         useMemo(() => {
+//             const set = (newState: IHookStateSetAction<number>) => {
+//                 const prevState = get();
+//                 let rState = resolveHookState(newState, prevState);
+//                 if (prevState !== rState) {
+//                     if (typeof min === 'number') {
+//                         rState = Math.max(rState, min);
+//                     }
+//                     if (typeof max === 'number') {
+//                         rState = Math.min(rState, max);
+//                     }
+//                     prevState !== rState && setInternal(rState);
+//                 }
+//             };
+//             return {
+//                 get,
+//                 set,
+//                 inc: (delta: IHookStateSetAction<number> = 1) => {
+//                     const rDelta = resolveHookState(delta, get());
+//                     if (typeof rDelta !== 'number') {
+//                         console.error(
+//                             'delta has to be a number or function returning a number, got ' + typeof rDelta
+//                         );
+//                     }
+//                     set((num: number) => num + rDelta);
+//                 },
+//                 dec: (delta: IHookStateSetAction<number> = 1) => {
+//                     const rDelta = resolveHookState(delta, get());
+//                     if (typeof rDelta !== 'number') {
+//                         console.error(
+//                             'delta has to be a number or function returning a number, got ' + typeof rDelta
+//                         );
+//                     }
+//                     set((num: number) => num - rDelta);
+//                 },
+//                 reset: (value: IHookStateSetAction<number> = init) => {
+//                     const rValue = resolveHookState(value, get());
+//                     if (typeof rValue !== 'number') {
+//                         console.error(
+//                             'value has to be a number or function returning a number, got ' + typeof rValue
+//                         );
+//                     }
+//                     // eslint-disable-next-line react-hooks/exhaustive-deps
+//                     init = rValue;
+//                     set(rValue);
+//                 },
+//             };
+//         }, [init, min, max]),
+//     ];
+// }

package/hooks/useDefault.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="react" />
+/**
+ * 使用方法参考
+ * https://github.com/streamich/react-use/blob/master/docs/useDefault.md
+*/
+export declare const useDefault: <TStateType>(defaultValue: TStateType, initialValue: TStateType | (() => TStateType)) => readonly [TStateType, import("react").Dispatch<import("react").SetStateAction<TStateType>>];

package/hooks/useDefault.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDefault = void 0;
+const react_1 = require("react");
+/**
+ * 使用方法参考
+ * https://github.com/streamich/react-use/blob/master/docs/useDefault.md
+*/
+const useDefault = (defaultValue, initialValue) => {
+    const [value, setValue] = (0, react_1.useState)(initialValue);
+    if (value === undefined || value === null) {
+        return [defaultValue, setValue];
+    }
+    return [value, setValue];
+};
+exports.useDefault = useDefault;

package/hooks/useDoLoad.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 说明： doLoad 是一个更高阶的 doSetState, 支持异步方法，说明：可能会有BUG （尤其是在方法速度慢的时候）
+ *
+ * const [state,doLoad] =  useDoLoad({a:1,b:2,c:3});
+ *
+ * doLoad({b:5})
+ *
+ * doLoad((prevState)=>return {
+ *      c:prevState + 1
+ * })
+ *
+ * doLoad(async (prevState) =>{
+ *  const resp = await Ajax.GET('API')
+ *  return { c:resp.xxx }
+ * })
+*/
+export declare const useDoLoad: <T extends object>(initValue: T) => [T, (patch: Partial<T> | ((prevState: T) => Partial<T>) | ((prevState: T) => Promise<Partial<T>>)) => void];

package/hooks/useDoLoad.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useDoLoad = void 0;
+const react_1 = require("react");
+const useSetState_1 = require("./useSetState");
+/**
+ * 说明： doLoad 是一个更高阶的 doSetState, 支持异步方法，说明：可能会有BUG （尤其是在方法速度慢的时候）
+ *
+ * const [state,doLoad] =  useDoLoad({a:1,b:2,c:3});
+ *
+ * doLoad({b:5})
+ *
+ * doLoad((prevState)=>return {
+ *      c:prevState + 1
+ * })
+ *
+ * doLoad(async (prevState) =>{
+ *  const resp = await Ajax.GET('API')
+ *  return { c:resp.xxx }
+ * })
+*/
+const useDoLoad = (initValue) => {
+    const [state, setState] = (0, useSetState_1.useSetState)(initValue);
+    const ref = (0, react_1.useRef)(state);
+    (0, react_1.useEffect)(() => {
+        ref.current = state;
+    }, [state]);
+    const doLoader = (patch) => {
+        if (patch instanceof Function) {
+            let result = patch(ref.current);
+            if (result instanceof Promise) {
+                result.then((resp) => setState(resp));
+            }
+            else {
+                setState(result);
+            }
+        }
+        else {
+            setState(patch);
+        }
+    };
+    return [state, doLoader];
+};
+exports.useDoLoad = useDoLoad;

package/hooks/useEffectFunction.d.ts

@@ -0,0 +1,8 @@
+import { DependencyList } from 'react';
+/**
+ * 简写 useEffect 用于方法执行，
+ * 支持异步方法
+ * 不支持 Return (unmount),
+ * 默认没有 deps
+*/
+export declare const useEffectFunction: (fn: Function, deps?: DependencyList) => void;

package/hooks/useEffectFunction.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useEffectFunction = void 0;
+const react_1 = require("react");
+/**
+ * 简写 useEffect 用于方法执行，
+ * 支持异步方法
+ * 不支持 Return (unmount),
+ * 默认没有 deps
+*/
+const useEffectFunction = (fn, deps = []) => {
+    (0, react_1.useEffect)(() => {
+        fn();
+    }, deps);
+};
+exports.useEffectFunction = useEffectFunction;

package/hooks/useEffectOnce.d.ts

@@ -0,0 +1,5 @@
+import { EffectCallback } from 'react';
+/**
+ * 仅使用一次的Effect
+*/
+export declare const useEffectOnce: (fn: EffectCallback) => void;