zmdms-utils 0.0.75 → 0.0.76

package/dist/es/htmlToPdf.d.ts

@@ -0,0 +1,44 @@
+import { IImgToPdfConfig } from './pdf.js';
+
+interface IConfig {
+    /** 容器，从哪个容器里面找需要转换的元素 */
+    container?: HTMLElement;
+    /**
+     * 需要转换的dom 可以是一个字符串
+     * 如果是字符串的话 那么就是通过querySelectorAll的形式查找
+     * 如果是一个dom实例
+     * 如果是多个dom实例
+     **/
+    pageDom?: string | HTMLElement | HTMLElement[];
+    /**
+     * 是否使用canvas直接转
+     */
+    useCanvas?: boolean;
+    /**
+     * 是否生成多份PDF
+     */
+    isMultiple?: boolean;
+    /**
+     * pdf名称 默认取dom元素配置的 data-title属性
+     */
+    pdfName?: string;
+    /**
+     * pdf相关配置
+     */
+    pdfConfig?: IImgToPdfConfig["pdfConfig"];
+    /**
+     * 生成PDF的左边距
+     */
+    leftPadding?: number;
+    /**
+     * 是否下载pdf
+     */
+    isDownload?: boolean;
+    /**
+     * 水印相关
+     */
+    waterConfig?: IImgToPdfConfig["waterConfig"];
+}
+declare function htmlToPdf(config: IConfig): Promise<unknown>;
+
+export { htmlToPdf };

package/dist/es/htmlToPdf.js

@@ -0,0 +1,84 @@
+import { __awaiter, __generator } from './_virtual/_tslib.js';
+import dayjs from 'dayjs';
+import { imgToPdf } from './pdf.js';
+import { domToCanvas } from './canvas.js';
+
+function htmlToPdf(config) {
+    var _this = this;
+    var container = config.container, pageDom = config.pageDom, _a = config.useCanvas, useCanvas = _a === void 0 ? true : _a, isMultiple = config.isMultiple, pdfConfig = config.pdfConfig, pdfName = config.pdfName, isDownload = config.isDownload, waterConfig = config.waterConfig, leftPadding = config.leftPadding;
+    // 找到需要转换的dom
+    var domList;
+    if (typeof pageDom === "string") {
+        domList = container
+            ? container.querySelectorAll(pageDom)
+            : document.body.querySelectorAll(pageDom);
+        domList = Array.from(domList);
+    }
+    else {
+        domList = Array.isArray(pageDom) ? pageDom : [pageDom];
+    }
+    if (domList.length === 0) {
+        return Promise.reject("没有可以导出的元素!");
+    }
+    if (!useCanvas) {
+        // 直接导出html 待实现
+        return Promise.resolve();
+    }
+    // 通过html => canvas => pdf 的形式导出
+    // 多份导出
+    if (isMultiple) {
+        var promiseArr_1 = [];
+        domList.forEach(function (domItem, index) {
+            var dataTitle = domItem.dataset.title || "".concat(dayjs().format("YYYY-MM-DD"), "-").concat(index + 1);
+            var item = domToCanvas(domItem).then(function (canvas) { return __awaiter(_this, void 0, void 0, function () {
+                var canvasWidth, canvasHeight, pdf;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0:
+                            canvasWidth = canvas.width;
+                            canvasHeight = canvas.height;
+                            return [4 /*yield*/, imgToPdf({
+                                    images: {
+                                        image: canvas,
+                                        width: canvasWidth,
+                                        height: canvasHeight,
+                                    },
+                                    pdfConfig: pdfConfig,
+                                    leftPadding: leftPadding,
+                                    pdfDownloadConfig: {
+                                        isDownload: isDownload,
+                                        pdfName: pdfName ? pdfName : dataTitle,
+                                    },
+                                    waterConfig: waterConfig,
+                                })];
+                        case 1:
+                            pdf = _a.sent();
+                            return [2 /*return*/, pdf];
+                    }
+                });
+            }); });
+            promiseArr_1.push(item);
+        });
+        return Promise.all(promiseArr_1);
+    }
+    else {
+        // 创建canvas组
+        var promiseArr = domList.map(function (domItem, index) {
+            return domToCanvas(domItem);
+        });
+        var dataTitle = domList[0].dataset.title || "".concat(dayjs().format("YYYY-MM-DD"));
+        // 合并成一个pdf导出
+        return imgToPdf({
+            images: promiseArr,
+            pdfConfig: pdfConfig,
+            pdfDownloadConfig: {
+                isDownload: isDownload,
+                pdfName: pdfName ? pdfName : dataTitle,
+            },
+            waterConfig: waterConfig,
+            leftPadding: leftPadding,
+        });
+    }
+}
+
+export { htmlToPdf };

package/dist/es/locales/i18n.d.ts

@@ -0,0 +1,15 @@
+import i18next__default from 'i18next';
+export { default as i18n } from 'i18next';
+
+type InitOptions = Parameters<typeof i18next__default.init>;
+/**
+ * 初始化逻辑
+ * - 本函数主要用于初始化 i18next 实例，同时使用 react-i18next 插件进行 react 组件的支持
+ * - 本函数的调用时机，一般是在项目的入口文件中进行调用，如 src/main.tsx 中
+ * @param options 参数 同i18next.init 第一个参数
+ * @param callback 参数 同i18next.init 第二个参数
+ * @returns
+ */
+declare function initLocale(options: InitOptions[0], callback?: InitOptions[1]): Promise<i18next__default.TFunction<"translation", undefined>>;
+
+export { initLocale };

package/dist/es/locales/t-in-non-react.d.ts

@@ -0,0 +1,17 @@
+import { TOpionsEx } from './t-options.js';
+
+/**
+ * 同步版本的 i18n.t 函数（应对在 react 组件外使用的翻译函数）
+ * - 如果 i18n 未初始化，则返回默认值或键名
+ * - 如果 i18n 初始化后，键名不存在，则返回默认值或键名
+ * - 其他正常情况（已经初始化+键名存在），则返回翻译值
+ * @description 本函数为在非 react 组件中使用的翻译函数；（在react中请求使用 useTranslate() 返回的 t 函数）
+ * @param {string} key
+ * @param {TOpionsEx|string} defaultValue 必填值
+ * @returns {string}
+ * @example
+ *   const txt = t('someLocaleKey', '兜底默认值');
+ */
+declare function safeT(key: string, defaultValueOrOptions: string | TOpionsEx): string;
+
+export { safeT };

package/dist/es/locales/t-options.d.ts

@@ -0,0 +1,7 @@
+import { TOptions } from 'i18next';
+
+interface TOpionsEx extends TOptions {
+    defaultValue: string;
+}
+
+export { TOpionsEx };

package/dist/es/locales/use-translation.d.ts

@@ -0,0 +1,42 @@
+import * as i18next from 'i18next';
+import { useTranslation } from 'react-i18next';
+export { Trans } from 'react-i18next';
+import { TOpionsEx } from './t-options.js';
+
+type Prams = Parameters<typeof useTranslation>;
+type NS = Prams[0];
+type Options = Prams[1];
+type EnhanceTFunc = (key: string, defaultValueOrOptions: string | TOpionsEx) => string;
+/**
+ * 这里只是简单代理一下useTranslation，方便后续扩展或添加其他逻辑
+ * @param ns 命名空间 大多数情况下都不需要传入这个参数，除非你用到了命名空间。
+ * @param options 其他参数 大多数情况下，都不需要关注这个参数。
+ * options.keyPrefix 为所有翻译键添加前缀
+ *  // JSON 文件：{ "greeting": { "welcome": "Welcome" } }
+ *  const { t } = useTranslation('common', { keyPrefix: 'greeting' });
+ *  // 使用时省略前缀
+ *  t('welcome'); // 等价于 t('greeting:welcome')
+ * @returns { t, i18n, ready }
+ * t: 翻译方法
+ * i18n: i18next实例 访问 i18next 的完整 API（如切换语言、加载命名空间）
+ * i18n.changeLanguage('zh-CN'); 使用它切换语言，可以触发组件渲染。但是当前项目中是使用全局刷新的模式，来更新语言的。
+ * ready: 是否加载完成
+ */
+declare function useZtTranslation(ns?: NS, options?: Options): {
+    /**
+     * t函数的使用方式：基本上使用1、2两种方式就可以了。
+     * 1、t('key') // 基础用法
+     * 2、t('greeting', { name: 'John' }); // 对应 JSON: "greeting": "Hello {{name}}"
+     * 3、t('auth:login'); // 显式指定命名空间
+     *
+     * 关于t函数的第二个参数的说明。
+     * 为了防止一些异常情况，翻译失败。可以传入一个默认值。这个默认值就是原本的中文就行。
+     * 1、t('key', '默认值');
+     * 2、t('key', { defaultValue: '默认值', ...otherOptions });
+     */
+    t: EnhanceTFunc;
+    i18n: i18next.i18n;
+    ready: boolean;
+};
+
+export { useZtTranslation as useTranslation };

package/dist/es/mainApp.d.ts

@@ -0,0 +1,36 @@
+interface IEntry {
+    scripts?: string[];
+    styles?: string[];
+    html?: string;
+}
+type IActiveRule = (location: Location) => boolean;
+interface IMicroApp {
+    name: string;
+    entry: string | IEntry;
+    container: string | HTMLElement;
+    activeRule: string | string[] | IActiveRule | IActiveRule[];
+    loader?: (loading: boolean) => void;
+    props?: object;
+}
+interface IOtherOptions {
+    /** 过滤掉的一些资源的关键词，必须保证不过滤掉一些不该过滤的东西 */
+    whiteWords?: string[];
+    /** loading 发生变化触发事件 */
+    loader?: (loading: boolean) => void;
+    startOptions?: any;
+}
+/**
+ * 主应用初始化逻辑
+ * @param microApps 子应用列表
+ * @param defaultAppLink 设置主应用启动后默认进入的微应用
+ * @param otherOptions
+ */
+declare function initMainApp(microApps: IMicroApp[], defaultAppLink: string, otherOptions?: IOtherOptions): void;
+/**
+ * 全局错误处理
+ * @param handle 错误函数
+ * @returns 清空监听
+ */
+declare function initGlobalError(handle: (event: any) => void): () => void;
+
+export { IMicroApp, initGlobalError, initMainApp };

package/dist/es/mainApp.js

@@ -0,0 +1,44 @@
+import { __assign } from './_virtual/_tslib.js';
+import { registerMicroApps, setDefaultMountApp, start, runAfterFirstMounted, addGlobalUncaughtErrorHandler, removeGlobalUncaughtErrorHandler } from 'qiankun';
+
+/**
+ * 主应用初始化逻辑
+ * @param microApps 子应用列表
+ * @param defaultAppLink 设置主应用启动后默认进入的微应用
+ * @param otherOptions
+ */
+function initMainApp(microApps, defaultAppLink, otherOptions) {
+    if (otherOptions === void 0) { otherOptions = {}; }
+    var _a = otherOptions.whiteWords, whiteWords = _a === void 0 ? [] : _a, loader = otherOptions.loader, _b = otherOptions.startOptions, startOptions = _b === void 0 ? {} : _b;
+    /**
+     * Step2 注册子应用
+     */
+    registerMicroApps(microApps.map(function (item) { return (__assign(__assign({}, item), { loader: loader })); }));
+    /**
+     * Setp3 设置默认进入的子应用
+     */
+    setDefaultMountApp(defaultAppLink);
+    /**
+     * Setp4 启动应用
+     */
+    start(__assign({ excludeAssetFilter: function (urls) {
+            // 指定部分特殊的动态加载的微应用资源（css/js) 不被 qiankun 劫持处理
+            return whiteWords.some(function (w) { return urls.includes(w); });
+        } }, startOptions));
+    runAfterFirstMounted(function () {
+        console.log("第一个微应用加载成功!");
+    });
+}
+/**
+ * 全局错误处理
+ * @param handle 错误函数
+ * @returns 清空监听
+ */
+function initGlobalError(handle) {
+    addGlobalUncaughtErrorHandler(handle);
+    return function () {
+        removeGlobalUncaughtErrorHandler(handle);
+    };
+}
+
+export { initGlobalError, initMainApp };

package/dist/es/math.d.ts

@@ -0,0 +1,29 @@
+type numType = number | string;
+/**
+ * 加法
+ */
+declare function plus(num1: numType, num2: numType): number;
+/**
+ * 减法
+ */
+declare function minus(num1: numType, num2: numType): number;
+/**
+ * 乘法
+ */
+declare function times(num1: numType, num2: numType): number;
+/**
+ * 除法
+ */
+declare function divide(num1: numType, num2: numType, precision?: number): number;
+/**
+ * 四舍五入保留小数
+ */
+declare function exactRound(num: numType, ratio: number): numType;
+/**
+ * 将字节数加上合适的单位
+ * @param numBytes 字节数
+ * @returns
+ */
+declare function formatUnit(numBytes: number): string | number;
+
+export { divide, exactRound, formatUnit, minus, plus, times };

package/dist/es/math.js

@@ -0,0 +1,147 @@
+import { Decimal } from './node_modules/decimal.js/decimal.js';
+
+/**
+ * 如果传入的数，有非数字的情况 那么忽略这个数
+ * 非数字的情况包括 null undefined
+ * 因为null转数字的结果是 0  可能会影响计算结果。
+ * 而这个可能不符合预期
+ */
+function initNum(num1, num2) {
+    // 如果两个数都是非数字 那么直接返回0
+    if (isNaN(num1) && isNaN(num2)) {
+        return 0;
+    }
+    if (isNaN(num1)) {
+        return num2;
+    }
+    if (isNaN(num2)) {
+        return num1;
+    }
+}
+/**
+ * 加法
+ */
+function plus(num1, num2) {
+    try {
+        var _num1 = num1 == null ? NaN : Number(num1);
+        var _num2 = num2 == null ? NaN : Number(num2);
+        // 如果两个数都是非数字 那么直接返回0
+        var result = initNum(_num1, _num2);
+        if (typeof result === "number") {
+            return result;
+        }
+        return new Decimal(_num1).add(_num2).toNumber();
+        // return (isNaN(_num1) ? 0 : _num1) + (isNaN(_num2) ? 0 : _num2);
+    }
+    catch (err) {
+        console.error("计算加法出错", err);
+        return 0;
+    }
+}
+/**
+ * 减法
+ */
+function minus(num1, num2) {
+    try {
+        var _num1 = num1 == null ? NaN : Number(num1);
+        var _num2 = num2 == null ? NaN : Number(num2);
+        // 如果两个数都是非数字 那么直接返回0
+        var result = initNum(_num1, _num2);
+        if (typeof result === "number") {
+            return result;
+        }
+        return new Decimal(_num1).sub(_num2).toNumber();
+        // return (isNaN(_num1) ? 0 : _num1) - (isNaN(_num2) ? 0 : _num2);
+    }
+    catch (err) {
+        console.error("计算减法出错", err);
+        return 0;
+    }
+}
+/**
+ * 乘法
+ */
+function times(num1, num2) {
+    try {
+        var _num1 = num1 == null ? NaN : Number(num1);
+        var _num2 = num2 == null ? NaN : Number(num2);
+        // 如果两个数都是非数字 那么直接返回0
+        var result = initNum(_num1, _num2);
+        if (typeof result === "number") {
+            return result;
+        }
+        return new Decimal(_num1).mul(_num2).toNumber();
+        // return (isNaN(_num1) ? 0 : _num1) * (isNaN(_num2) ? 0 : _num2);
+    }
+    catch (err) {
+        console.error("计算乘法出错", err);
+        return 0;
+    }
+}
+/**
+ * 除法
+ */
+function divide(num1, num2, precision) {
+    if (precision === void 0) { precision = 5; }
+    try {
+        var _num1 = num1 == null ? NaN : Number(num1);
+        var _num2 = num2 == null ? NaN : Number(num2);
+        // 如果两个数都是非数字 那么直接返回0
+        var result = initNum(_num1, _num2);
+        if (typeof result === "number") {
+            return result;
+        }
+        // FIXME: 不记得这里为什么要先设置下小数位了。
+        // 会影响其他值的计算.
+        // Decimal.set({ precision });
+        // return new Decimal(_num1).div(_num2).toNumber();
+        // 这里改成这种模式。行为基本与之前是一致的
+        return Number(new Decimal(_num1).div(_num2).toFixed(precision));
+    }
+    catch (err) {
+        console.error("计算除法出错", err);
+        return 0;
+    }
+}
+/**
+ * 四舍五入保留小数
+ */
+function exactRound(num, ratio) {
+    try {
+        var _num1 = num == null ? NaN : Number(num);
+        if (isNaN(_num1)) {
+            return 0;
+            // return (0).toFixed(ratio);
+        }
+        var value = new Decimal(num).toFixed(ratio);
+        // 设置exactRound去掉小数位后面的0
+        if (window.__EXACT_ROUND_TYPE__ === "TRIM_ZEROS") {
+            value = Number(value);
+        }
+        return value;
+        // return Number(num).toFixed(ratio);
+    }
+    catch (err) {
+        return num;
+    }
+}
+/**
+ * 将字节数加上合适的单位
+ * @param numBytes 字节数
+ * @returns
+ */
+function formatUnit(numBytes) {
+    var _numBytes = Number(numBytes);
+    if (isNaN(_numBytes)) {
+        return numBytes;
+    }
+    var units = ["B", "KB", "MB", "GB", "TB"];
+    var unitIndex = 0;
+    while (_numBytes >= 1024 && unitIndex < units.length - 1) {
+        _numBytes /= 1024;
+        unitIndex++;
+    }
+    return _numBytes.toFixed(2) + units[unitIndex];
+}
+
+export { divide, exactRound, formatUnit, minus, plus, times };

package/dist/es/microAppCreator.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @description 微应用初始化
+ * @param render 加载应用方法
+ * @param microAppOptions 微应用的一些配置
+ */
+interface IMicroAppOptions {
+    /**
+     * @deprecated 该属性已废弃，无意义
+     */
+    microAppContainerId: string;
+    microAppKey: string;
+    /**
+     * @deprecated 该属性已废弃，无意义
+     */
+    microAppRoot: any;
+    /**
+     * 只会在微应用初始化的时候调用一次，下次微应用重新进入时会直接调用 mount 钩子，不会再重复触发 bootstrap
+     * 通常我们可以在这里做一些全局变量的初始化，比如不会在 unmount 阶段被销毁的应用级别的缓存等。
+     **/
+    microAppBootstrapHandle?: () => void;
+    /**
+     * 应用每次进入都会调用 mount 方法，通常我们在这里触发应用的渲染方法
+     */
+    microAppMountHandle: (props: any) => void;
+    /**
+     * 应用每次 切出/卸载 会调用的方法，通常在这里我们会卸载微应用的应用实例
+     */
+    microAppUnMountHandle: (props: any) => void;
+    /**
+     * 可选生命周期钩子，仅使用 loadMicroApp 方式加载微应用时生效
+     */
+    microAppUpdateHandle?: (props: any) => void;
+}
+declare function initMicroApp(render: any, microAppOptions: IMicroAppOptions): {
+    bootstrap?: undefined;
+    mount?: undefined;
+    unmount?: undefined;
+    update?: undefined;
+} | {
+    bootstrap: () => Promise<void>;
+    mount: (props: any) => Promise<void>;
+    unmount: (props: any) => Promise<void>;
+    update: (props: any) => Promise<void>;
+};
+
+export { IMicroAppOptions, initMicroApp };

package/dist/es/microAppCreator.js

@@ -0,0 +1,89 @@
+import { __awaiter, __generator } from './_virtual/_tslib.js';
+import { isQiankun } from './qiankunUtils.js';
+
+/**
+ * 可选生命周期钩子，仅使用 loadMicroApp 方式加载微应用时生效
+ */
+function update(props) {
+    console.log("可以在update声明周期中做的一些公共处理的事！", props);
+}
+function initMicroApp(render, microAppOptions) {
+    // 初始加载应用
+    // 1. 如果不是微前端环境，那么应用直接运行
+    if (!isQiankun()) {
+        render({});
+        return {};
+    }
+    // 2. 进入微前端环境的运行逻辑
+    var microAppKey = microAppOptions.microAppKey, microAppBootstrapHandle = microAppOptions.microAppBootstrapHandle, microAppMountHandle = microAppOptions.microAppMountHandle, microAppUnMountHandle = microAppOptions.microAppUnMountHandle, microAppUpdateHandle = microAppOptions.microAppUpdateHandle;
+    // 唯一key没传 给出开发提示
+    if (!microAppKey) {
+        throw Error("\u6CA1\u6709\u914D\u7F6E\u5FAE\u5E94\u7528\u7684\u552F\u4E00key\u503C\uFF0C\u8FD9\u4F1A\u5BFC\u81F4\u5FAE\u524D\u7AEF\u8FD0\u884C\u51FA\u9519\uFF01");
+    }
+    /**
+     * bootstrap 只会在微应用初始化的时候调用一次，下次微应用重新进入时会直接调用 mount 钩子，不会再重复触发 bootstrap。
+     * 通常我们可以在这里做一些全局变量的初始化，比如不会在 unmount 阶段被销毁的应用级别的缓存等。
+     */
+    function bootstrap() {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                console.log("\u5FAE\u5E94\u7528==".concat(microAppKey, "==bootstraped"));
+                if (microAppBootstrapHandle) {
+                    microAppBootstrapHandle();
+                }
+                return [2 /*return*/];
+            });
+        });
+    }
+    /**
+     * 应用每次进入都会调用 mount 方法，通常我们在这里触发应用的渲染方法
+     */
+    function mount(props) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                console.log("\u5FAE\u5E94\u7528==".concat(microAppKey, "==mount"));
+                if (microAppMountHandle) {
+                    microAppMountHandle(props);
+                }
+                render(props);
+                return [2 /*return*/];
+            });
+        });
+    }
+    /**
+     * 应用每次 切出/卸载 会调用的方法，通常在这里我们会卸载微应用的应用实例
+     */
+    function unmount(props) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                console.log("\u5FAE\u5E94\u7528==".concat(microAppKey, "==unmount"));
+                if (microAppUnMountHandle) {
+                    microAppUnMountHandle(props);
+                }
+                return [2 /*return*/];
+            });
+        });
+    }
+    /**
+     * 应用每次 切出/卸载 会调用的方法，通常在这里我们会卸载微应用的应用实例
+     */
+    function update(props) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                console.log("\u5FAE\u5E94\u7528==".concat(microAppKey, "==update"));
+                if (microAppUpdateHandle) {
+                    microAppUpdateHandle(props);
+                }
+                return [2 /*return*/];
+            });
+        });
+    }
+    return {
+        bootstrap: bootstrap,
+        mount: mount,
+        unmount: unmount,
+        update: update,
+    };
+}
+
+export { initMicroApp, update };