zmdms-utils 0.0.72 → 0.0.74

package/dist/es/crypto.d.ts

@@ -1,3 +1,6 @@
+/**
+ * 对称加密和hash
+ */
 declare class Crypto {
     private aesKey;
     private desKey;

package/dist/es/crypto.js

@@ -1,5 +1,9 @@
 import CryptoJS from 'crypto-js';
+export { Base64 } from './node_modules/js-base64/base64.js';
 
+/**
+ * 对称加密和hash
+ */
 var Crypto = /** @class */ (function () {
     function Crypto(aesKey, desKey) {
         this.aesKey = aesKey;

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/microAppCreator.d.ts

@@ -4,20 +4,43 @@
  * @param microAppOptions 微应用的一些配置
  */
 interface IMicroAppOptions {
+    /**
+     * @deprecated 该属性已废弃，无意义
+     */
     microAppContainerId: string;
     microAppKey: string;
+    /**
+     * @deprecated 该属性已废弃，无意义
+     */
     microAppRoot: any;
-    microAppMountHandle?: (props: any) => void;
-    microAppUnMountHandle?: (props: any) => void;
+    /**
+     * 只会在微应用初始化的时候调用一次，下次微应用重新进入时会直接调用 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

@@ -15,7 +15,7 @@ function initMicroApp(render, microAppOptions) {
         return {};
     }
     // 2. 进入微前端环境的运行逻辑
-    var microAppKey = microAppOptions.microAppKey; microAppOptions.microAppRoot; var microAppMountHandle = microAppOptions.microAppMountHandle, microAppUnMountHandle = microAppOptions.microAppUnMountHandle;
+    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");
@@ -27,7 +27,10 @@ function initMicroApp(render, microAppOptions) {
     function bootstrap() {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                console.log("微应用 bootstraped");
+                console.log("\u5FAE\u5E94\u7528==".concat(microAppKey, "==bootstraped"));
+                if (microAppBootstrapHandle) {
+                    microAppBootstrapHandle();
+                }
                 return [2 /*return*/];
             });
         });
@@ -38,8 +41,10 @@ function initMicroApp(render, microAppOptions) {
     function mount(props) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                console.log("微应用 mount");
-                microAppMountHandle && microAppMountHandle(props);
+                console.log("\u5FAE\u5E94\u7528==".concat(microAppKey, "==mount"));
+                if (microAppMountHandle) {
+                    microAppMountHandle(props);
+                }
                 render(props);
                 return [2 /*return*/];
             });
@@ -51,8 +56,24 @@ function initMicroApp(render, microAppOptions) {
     function unmount(props) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
-                console.log("微应用 unmount", props);
-                microAppUnMountHandle && microAppUnMountHandle(props);
+                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*/];
             });
         });
@@ -61,6 +82,7 @@ function initMicroApp(render, microAppOptions) {
         bootstrap: bootstrap,
         mount: mount,
         unmount: unmount,
+        update: update,
     };
 }
 

package/dist/es/node_modules/html-parse-stringify/dist/html-parse-stringify.module.js

@@ -0,0 +1,5 @@
+import voidElements from '../../void-elements/index.js';
+
+var t=/\s([^'"/\s><]+?)[\s/>]|([^\s=]+)=\s?(".*?"|'.*?')/g;function n(n){var r={type:"tag",name:"",voidElement:!1,attrs:{},children:[]},i=n.match(/<\/?([^\s]+?)[/\s>]/);if(i&&(r.name=i[1],(voidElements[i[1]]||"/"===n.charAt(n.length-2))&&(r.voidElement=!0),r.name.startsWith("!--"))){var s=n.indexOf("--\x3e");return {type:"comment",comment:-1!==s?n.slice(4,s):""}}for(var a=new RegExp(t),c=null;null!==(c=a.exec(n));)if(c[0].trim())if(c[1]){var o=c[1].trim(),l=[o,""];o.indexOf("=")>-1&&(l=o.split("=")),r.attrs[l[0]]=l[1],a.lastIndex--;}else c[2]&&(r.attrs[c[2]]=c[3].trim().substring(1,c[3].length-1));return r}var r=/<[a-zA-Z0-9\-\!\/](?:"[^"]*"|'[^']*'|[^'">])*>/g,i=/^\s*$/,s=Object.create(null);function a(e,t){switch(t.type){case"text":return e+t.content;case"tag":return e+="<"+t.name+(t.attrs?function(e){var t=[];for(var n in e)t.push(n+'="'+e[n]+'"');return t.length?" "+t.join(" "):""}(t.attrs):"")+(t.voidElement?"/>":">"),t.voidElement?e:e+t.children.reduce(a,"")+"</"+t.name+">";case"comment":return e+"\x3c!--"+t.comment+"--\x3e"}}var c={parse:function(e,t){t||(t={}),t.components||(t.components=s);var a,c=[],o=[],l=-1,m=!1;if(0!==e.indexOf("<")){var u=e.indexOf("<");c.push({type:"text",content:-1===u?e:e.substring(0,u)});}return e.replace(r,function(r,s){if(m){if(r!=="</"+a.name+">")return;m=!1;}var u,f="/"!==r.charAt(1),h=r.startsWith("\x3c!--"),p=s+r.length,d=e.charAt(p);if(h){var v=n(r);return l<0?(c.push(v),c):((u=o[l]).children.push(v),c)}if(f&&(l++,"tag"===(a=n(r)).type&&t.components[a.name]&&(a.type="component",m=!0),a.voidElement||m||!d||"<"===d||a.children.push({type:"text",content:e.slice(p,e.indexOf("<",p))}),0===l&&c.push(a),(u=o[l-1])&&u.children.push(a),o[l]=a),(!f||a.voidElement)&&(l>-1&&(a.voidElement||a.name===r.slice(2,-1))&&(l--,a=-1===l?c:o[l]),!m&&"<"!==d&&d)){u=-1===l?c:o[l].children;var x=e.indexOf("<",p),g=e.slice(p,-1===x?void 0:x);i.test(g)&&(g=" "),(x>-1&&l+u.length>=0||" "!==g)&&u.push({type:"text",content:g});}}),c},stringify:function(e){return e.reduce(function(e,t){return e+a("",t)},"")}};
+
+export { c as default };