@lingxiteam/ebe-utils 0.0.1

package/lib/public/src/utils/i18n/locale/pc/zh_HK.ts

@@ -0,0 +1,105 @@
+import merge from 'lodash/merge';
+import { baseZHHK } from '../base';
+
+export default merge(baseZHHK, {
+  'Quill.uploadImages': '只能上傳格式為.jpg,.gif,.png的圖片',
+  'Quill.imageSizeLimit': '每張圖片不能大於3000KB',
+  'Quill.selectZh': '請先選中文字，再點擊鏈接',
+  'Table.pageNotEmptyWarning': '當前頁碼為空',
+  'Tree.appendTreeNodeWarning':
+    '加載樹的子節點數據必須有key鍵值，沒有key不能操作',
+  'Tree.appendMenuNodeWarning': '加載菜單節點必須有key鍵值，沒有key不能操作',
+  'Tree.editingWarn': '沒有正在操作的樹節點',
+  'Audio.cannotPlay': '音頻節點被移除,無法播放',
+  'Audio.cannotStop': '音頻節點被移除,無法暫停',
+  'Audio.cannotSwitch': '音頻節點被移除,無法切換',
+  'Audio.warning': '音頻文件獲取出錯',
+  'Icon.imgFormatWarning': '圖片格式錯誤',
+  'Input.lenRule': '內容長度須大於等於@{minLength}且小於等於@{maxLength}',
+  'Input.maxRule': '內容長度須小於等於@{maxLength}',
+  'Input.minRule': '內容長度須大於等於@{minLength}',
+  'Upload.download': '該文件正在下載，請耐心等待',
+  'Upload.readonly': '當前為只讀狀態，不允許上傳或移除文件!',
+  'Upload.maxSize': '當前文件最大上傳大小為@{singleFileMaxSize}，請重新上傳',
+  'Upload.minSize': '當前文件最小上傳大小為@{singleFileMinSize}，請重新上傳',
+  'Upload.maxNum': '當前文件最大上傳個數為@{numberLimit}，不允許繼續上傳',
+  'Upload.format': '文件格式不正確，請上傳@{acceptType}格式的文件',
+  'Upload.limit': '當前文件最大上傳個數為@{numberLimit}，請重新選擇',
+  'Upload.text': '點擊或者拖動文件到虛線框內上傳',
+  'Upload.uploadText': '點擊上傳',
+  'Upload.downloadText': '下載',
+  'Upload.origin': '源文件下載',
+  'Upload.waterMark': '加水印下載',
+  'Upload.downloadType': '文件下載方式',
+  'Pagination.showTotal': '共 @{tol} 條',
+  'RadarChart.warning': '維度數據配置有誤',
+  'RemoteComponent.fail': '自定義組件加載失敗',
+  'Steps.wait': '等待狀態',
+  'Steps.process': '處理中狀態',
+  'Steps.finish': '完成狀態',
+  'Steps.error': '錯誤狀態',
+  'Table.dateTypeWarning': '數據類型不一致',
+  'Table.headTips': '通過左側圖標拖拽可調整列順序',
+  'Table.headCol': '列設置',
+  'Table.needObj': '添加行數據的格式應該為對象，但接受到非對象的值',
+  'VerificationCode.text': '發送驗證碼',
+  'VerificationCode.refresh': '重新獲取',
+  'Img.fileIdError':
+    '指令錯誤：接收的值不匹配，當前值為:@{field}, 期望為數字或字符串',
+  'Form.actionWarning': '該組件不支持使用getFormValues指令',
+  'Transfer.unit': '@{num}項',
+  'Transfer.min': '@{name}最少需要選@{min}條數據',
+  'Transfer.max': '@{name}最多可選@{max}條數據',
+  'Table.filter.empty': '空白',
+  'Table.expand.component': '已關聯業務組件：',
+  'Table.data.typeError': '表格數據類型錯誤，當前類型為@{type}，請檢查配置',
+  'SuperSelect.load': '僅加載50條數據，更多數據請搜索',
+  'DatePicker.afterToday': '@{name}必須在今天之後（含今天）',
+  'DatePicker.beforeToday': '@{name}必須在今天之前（含今天）',
+  'DatePicker.period': '@{name}必須在@{startTime}到@{endTime}的範圍內',
+  'DatePicker.after': '@{name}不能小於@{startTime}',
+  'DatePicker.before': '@{name}不能大於@{endTime}',
+  'ExpBusiObjModal.title': '按字段導出業務對象數據',
+  'ExpBusiObjModal.exportFieldError': '請先選擇要導出的字段',
+  'ExpSQLServiceModal.title': '按字段導出SQL查詢服務數據',
+  'ExpSQLServiceModal.importData': '導入數據',
+  'ExpSQLServiceModal.importFieldError': '請先選擇要導入的字段',
+  'ExpBusiObjModal.downloadMutiTpl': '下載批量導入模板',
+  'ExpBusiObjModal.downloadTpl': '下載導入模板',
+  'ExpBusiObjModal.dataDealing': '數據處理中...',
+  'ExpBusiObjModal.downloadFailReason': '下載導入失敗數據，查看失敗原因',
+  'ExpBusiObjModal.validField': '指定導入的有效字段',
+  'ExpBusiObjModal.dragView': '點擊選擇文件或拖動文件到此區域進行上傳',
+  'ExpBusiObjModal.onlySingleUpload': '僅支持單個文件上傳',
+  'ExpBusiObjModal.validTable': '請上傳合法的表格',
+  'ExpBusiObjModal.uploadFail': '@{name}文件上傳失敗，請重試！',
+  'ExpBusiObjModal.noFile': '無上傳文件，請先選擇文件',
+  'ExpBusiObjModal.importFailList': '導入失敗列表-@{name}.xlsx',
+  'ExpBusiObjModal.partImportFailTitle': '部分數據導入失敗',
+  'ExpBusiObjModal.importSuccessTitle': '導入成功',
+  'ExpBusiObjModal.importSuccessMsg': '數據導入成功，請選擇前往列表查看',
+  'ExpBusiObjModal.importFailTitle': '導入失敗',
+  'ExpBusiObjModal.importFailMsg':
+    '數據導入失敗，請核對以下信息後，再重新提交。',
+  'AccountDivideModal.setAccount': '設置分賬',
+  'AccountDivideModal.edit': '變更計劃',
+  'AccountDivideModal.detail': '計劃詳情',
+  'AccountDivideModal.disableAutoFill': '不符合自動填充條件',
+  'AccountDivideModal.fillFail':
+    '自動填充失敗，請至少先手動填入一項依據數據然後重試',
+  'AccountDivideModal.AccountNoFinish': '分賬未完成，請仔細檢查',
+  'AccountDivideModal.validDate': '請選擇有效的開始日期',
+  'AccountDivideModal.startDatePlaceholder': '請選擇有效的開始日期',
+  'AccountDivideModal.accountMode': '出賬方式',
+  'ProgressComp.cancelMessage': '取消將無法獲得下載結果，請確認是否需要取消',
+  'ProgressComp.progressMsg': '@{fileName} 正在@{text}：',
+  'ImportBusiObjModal.tips':
+    '導入總記錄數@{total}條，其中@{success}條成功，@{fail}條失敗',
+  'AccountDivideDetail.subject': '科目：',
+  'AccountDivideDetail.plan': '當前計劃',
+  'AccountDivideDetail.aleterAfter': '變更後計劃',
+  'Upload.uploadPlaceholder': '點擊或拖拽文件到此處上傳',
+  'Upload.singleStrict': '單文件模式不允許上傳多個文件',
+  'Upload.actionStrict': '上傳接口未配置，請返回修改！',
+  'Upload.fileLimit': '超出文件數量限制，當前為@{num}',
+});

package/lib/public/src/utils/i18n/localeMonitor.ts

@@ -0,0 +1,71 @@
+import { LanguageKeys } from './types';
+
+export type ListenerParams = {
+  language: LanguageKeys;
+  locale: Record<string, any>;
+  getLocaleLanguage: any;
+  getLocale: any;
+  getLocaleEnv: any;
+};
+
+export type ListenerCallback = (opts: ListenerParams) => void;
+
+/**
+ * 监听语言变更
+ */
+class LocaleMonitor {
+  protected listenerCallbacks: ListenerCallback[] = [];
+
+  protected onceCallbacks: ListenerCallback[] = [];
+
+  /**
+   * 监听语言变更
+   */
+  public addListener = (callback: ListenerCallback) => {
+    this.listenerCallbacks.push(callback);
+  };
+
+  /**
+   * 移除监听
+   * @param callback
+   */
+  public removeListener = (callback: ListenerCallback) => {
+    this.listenerCallbacks = this.listenerCallbacks.filter(
+      (fn) => fn !== callback,
+    );
+  };
+
+  /**
+   * 监听一次
+   * @param callback
+   */
+  public onceListener = (callback: ListenerCallback) => {
+    this.onceCallbacks.push(callback);
+  };
+
+  /**
+   * 只监听一次的
+   * @param params
+   */
+  protected emitOnce = (params: ListenerParams) => {
+    this.onceCallbacks.forEach((callback) => {
+      callback(params);
+    });
+    // 清空
+    this.onceCallbacks = [];
+  };
+
+  /**
+   * 消息发送
+   */
+  public emit = (params: ListenerParams) => {
+    this.emitOnce(params);
+    this.listenerCallbacks.forEach((cb) => {
+      cb(params);
+    });
+  };
+}
+
+export default LocaleMonitor;
+
+export const localeMonitor = new LocaleMonitor();

package/lib/public/src/utils/i18n/locales.ts

@@ -0,0 +1,30 @@
+import antdEnUS from 'antd/es/locale/en_US';
+import antdZhCN from 'antd/es/locale/zh_CN';
+import antdZhHK from 'antd/es/locale/zh_HK';
+import pcLocale from './locale/pc';
+import { localeMonitor } from './localeMonitor';
+
+export const setLocaleChange = ({
+  getLocale,
+  language,
+}: Record<string, any>) => {
+  // 这里进行多语言切换
+};
+
+// 这里处理了个监听逻辑， 过多的静态方法需要监听语言变更时刷新locale，
+localeMonitor.addListener(setLocaleChange);
+
+export default {
+  'en-US': {
+    antd: antdEnUS,
+    lowcode: pcLocale.enUS,
+  },
+  'zh-CN': {
+    antd: antdZhCN,
+    lowcode: pcLocale.zhCN,
+  },
+  'zh-HK': {
+    antd: antdZhHK,
+    lowcode: pcLocale.zhHK,
+  },
+};

package/lib/public/src/utils/i18n/replaceMessage.ts

@@ -0,0 +1,29 @@
+import { isUndefined } from 'lodash';
+
+/**
+ * 替换动态模板
+ * @param template
+ * @param kv
+ * @returns
+ */
+export function replaceMessage(
+  template?: string,
+  placeholder?: string,
+  kv?: Record<string, string>,
+): string {
+  if (isUndefined(template)) {
+    return placeholder ?? '';
+  }
+
+  if (typeof template === 'string' && /@\{\w+\}/.test(template)) {
+    if (kv) {
+      return template.replace(/@\{\w+\}/g, (str: string) => {
+        const key = str.slice(2, -1);
+        return kv[key] ?? '';
+      });
+    }
+    return template.replace(/@\{\w+\}/g, '');
+  }
+
+  return template ?? '';
+}

package/lib/public/src/utils/i18n/types.ts

@@ -0,0 +1,2 @@
+export type InnerLanguageKeys = 'zh-CN' | 'zh-HK' | 'en-US';
+export type LanguageKeys = InnerLanguageKeys | (string & {});

package/lib/public/src/utils/i18n/useLocale.ts

@@ -0,0 +1,129 @@
+import merge from 'lodash/merge';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { localeMonitor } from './localeMonitor';
+import { replaceMessage } from './replaceMessage';
+import { LanguageKeys } from './types';
+
+type LocaleReturnType = {
+  antd: Record<string, any>;
+  lowcode: Record<string, any>;
+};
+
+export interface I18nOptions {
+  language: LanguageKeys;
+  remoteLocale?: Record<string, string>;
+  locale: LocaleReturnType;
+
+  /**
+   * 通过init注册进来的多语言
+   */
+  configLocale: Record<string, Record<string, any>>;
+}
+
+export const useLocale = (
+  i18n: I18nOptions,
+  defaultLocales: Record<LanguageKeys, LocaleReturnType>,
+) => {
+  const { locale: loca, language = 'zh-CN', configLocale } = i18n || {};
+  const [locale, setLocale] = useState<{
+    antd: Record<string, any>;
+    lowcode: Record<string, any>;
+  }>({
+    antd: {},
+    lowcode: {},
+  });
+
+  const localeInfo = useRef({
+    language,
+    locale,
+    remoteLocale: i18n.remoteLocale,
+  }).current;
+
+  /**
+   * 获取当前的语种;
+   * @returns
+   */
+  const getLocaleEnv = () => {
+    return localeInfo.language;
+  };
+
+  const setLocalFn = useCallback(async () => {
+    if (typeof loca === 'object') {
+      setLocale(merge({ lowcode: configLocale[language] }, loca));
+      return;
+    }
+
+    const defaultLocale = await defaultLocales[language as LanguageKeys];
+    setLocale(merge({}, defaultLocale || {}, { lowcode: configLocale }));
+  }, [loca, language]);
+
+  useEffect(() => {
+    setLocalFn();
+  }, [setLocalFn]);
+
+  // fix: 由于闭包问题引起的数据不同步，导致getLocale访问错误。
+  localeInfo.language = language;
+  localeInfo.remoteLocale = i18n.remoteLocale;
+  localeInfo.locale = locale;
+
+  /**
+   * 获取静态语言包。硬编码
+   * @param key 语言key值, 如果传入的是 xxxx.aaa 那么优先找xxxx.aaa的key，如果找不到则会找aaa
+   * @param placeholder key值不存在时的占位文字
+   * @param kv 替换的动态模板，语言模板可以是 "${year}年${month}月"   kv: { year: '2003', month: 12 }; 则结果为 '2003年12月';
+   * @returns
+   */
+  const getLocale = (
+    key: string,
+    placeholder?: string,
+    kv?: Record<string, string>,
+  ) => {
+    const obj: any = localeInfo.locale.lowcode;
+    if (obj?.[key] || obj?.[key] === '') {
+      return replaceMessage(obj?.[key], placeholder, kv);
+    }
+    if (key.includes('.')) {
+      const keys = key.split('.');
+      const newKey = keys[keys.length - 1];
+      return replaceMessage(obj?.[newKey], placeholder, kv);
+    }
+    return replaceMessage(obj?.[key], placeholder, kv);
+  };
+
+  /**
+   * 远端文字配置
+   * @param key 语言key值
+   * @param placeholder key值不存在时的占位文字
+   * @param kv 替换的动态模板，语言模板可以是 "${year}年${month}月"   kv: { year: '2003', month: 12 }; 则结果为 '2003年12月';
+   * @param id
+   */
+  const getLocaleLanguage = (
+    id: string,
+    placeholder?: string,
+    kv?: Record<string, string>,
+  ) => {
+    const { remoteLocale } = localeInfo;
+    if (!id || !remoteLocale) {
+      return placeholder;
+    }
+    return replaceMessage(remoteLocale[id], placeholder, kv);
+  };
+
+  useEffect(() => {
+    localeMonitor.emit({
+      language: localeInfo.language,
+      locale: localeInfo.locale,
+      getLocale,
+      getLocaleEnv,
+      getLocaleLanguage,
+    });
+  }, [locale]);
+
+  return {
+    getLocaleLanguage,
+    getLocale,
+    getLocaleEnv,
+    locale: localeInfo.locale,
+    language: localeInfo.language,
+  };
+};

package/lib/public/src/utils/lcdpApi.ts

@@ -0,0 +1,215 @@
+import LcdpBaseApi from './lcdpBaseApi';
+
+export declare type LocaleFunction = (
+  key: string,
+  placeholder?: string,
+  kv?: Record<string, string>,
+) => string;
+// 对应用全局数据和全局方法访问的接口对象,为自定义代码提供更多可能性
+/* @__HOT_UPDATE__ */
+class LcdpApi extends LcdpBaseApi {
+  components: any;
+
+  static instance: LcdpApi;
+
+  mountObj: any;
+
+  getLocale: LocaleFunction = (k, placeholder) => placeholder || '';
+
+  /*  @__HOT_UPDATE__ @alias LcdpApi */
+  constructor(mountObj?: any, singletonLcdpApi?: any) {
+    super(mountObj, singletonLcdpApi);
+    // 废弃
+    // this.mount(mountObj);
+    if (singletonLcdpApi) {
+      // router 只应该由singletonLcdpApi访问
+      ['router'].forEach((k) => {
+        (() => {
+          // eslint-disable-next-line
+          let val = null;
+          Object.defineProperty(this, k, {
+            get() {
+              return (
+                url: string,
+                lcdpParentRenderId: string,
+                state?: Record<string, any>,
+              ) =>
+                singletonLcdpApi[k](
+                  url,
+                  this.data.pages,
+                  this.data.appConfig.appId,
+                  lcdpParentRenderId,
+                  state,
+                );
+            },
+            set(value) {
+              val = value;
+            },
+          });
+        })();
+      });
+    }
+  }
+
+  /**
+   * @name 路由跳转 考虑之后多应用页面跳转，所有跳转均通过单例lcdpApi访问，如存在多应用页面路径相同，优先跳转当前应用页面
+   * @param {string} url 页面的路径，如：/order 或者接收页面Id 如需要传参 如：/order?id=123
+   * @param currentAppPages 当前应用页面
+   * @param appId 当前应用的appId
+   * @param lcdpParentRenderId 父页面的渲染ID，是上下文中的renderId，打开弹窗/抽屉需要，否则调用父页面事件已出
+   * @param state 组件状态数据
+   */
+  router(
+    url: string,
+    currentAppPages: Array<any>,
+    appId: string,
+    lcdpParentRenderId: string,
+    state?: Record<string, any>,
+  ) {
+    const { message } = this.antd;
+    if (!url) {
+      message?.warning(
+        this.getLocale('lcdpApi.router.urlEmpty', '页面跳转地址缺失，请检查'),
+      );
+    }
+    if (
+      /^((http|https):)?\/\/[^\s]+/.test(url) ||
+      !this.refs.history ||
+      !this.data.pages
+    ) {
+      window.location.href = url;
+    } else {
+      const isPageId = /^\d+$/.test(url);
+      let pageData: any = null;
+      // 优先跳转当前应用页面
+      if (currentAppPages?.length) {
+        pageData = isPageId
+          ? currentAppPages.find((n: any) => n.pageId === url)
+          : currentAppPages.find((n: any) =>
+              url.split('?').includes(n.pagePath),
+            );
+      }
+      // this.data.pages 包含所有应用页面
+      if (!pageData) {
+        pageData = isPageId
+          ? this.data.pages.find((n: any) => n.pageId === url)
+          : this.data.pages.find((n: any) =>
+              url.split('?').includes(n.pagePath),
+            );
+      }
+      if (pageData) {
+        const [pathname, search] = url.split('?');
+        const searchPamams = search
+          ? search.split('&').reduce((pre: any, cur: any) => {
+              const [k, v] = cur.split('=');
+              if (v) {
+                pre[decodeURIComponent(k)] = decodeURIComponent(v);
+              }
+              return pre;
+            }, {})
+          : {};
+        switch (pageData.pageContainerType) {
+          case 'Page': {
+            let realSearch = search;
+            if (!searchPamams?.appId) {
+              realSearch = `${search === undefined ? '?' : `${search}&`}appId=${
+                pageData.appId || appId
+              }`;
+            }
+            this.refs.history.push({
+              pathname,
+              search: realSearch,
+            });
+            break;
+          }
+          case 'Drawer': {
+            try {
+              this.refs.ModalManager.current.openDrawer({
+                pageId: pageData.pageId,
+                params: {
+                  ...searchPamams,
+                  ...state,
+                },
+                lcdpParentRenderId,
+              });
+            } catch (e) {
+              console.error(e);
+              message?.warning(
+                this.getLocale(
+                  'lcdpApi.router.openFail',
+                  '打开新页面失败，缺失Drawer',
+                  { type: 'Drawer' },
+                ),
+              );
+            }
+            break;
+          }
+          case 'Modal':
+          case 'MobileModal': {
+            try {
+              this.refs.ModalManager.current.openModal({
+                pageId: pageData.pageId,
+                params: searchPamams,
+                lcdpParentRenderId,
+              });
+            } catch (e) {
+              console.error(e);
+              message?.warning(
+                this.getLocale(
+                  'lcdpApi.router.openFail',
+                  '打开新页面失败，缺失Modal',
+                  { type: 'Modal' },
+                ),
+              );
+            }
+            break;
+          }
+          default: {
+            message?.warning(
+              this.getLocale(
+                'lcdpApi.router.notSupport',
+                `不支持的页面类型: ${pageData.pageContainerType}`,
+                { type: pageData.pageContainerType },
+              ),
+            );
+            break;
+          }
+        }
+      } else {
+        message?.warning(
+          this.getLocale('lcdpApi.router.notFound', '找不到跳转页面的数据'),
+        );
+      }
+    }
+  }
+
+  // 静态方法(单例)
+  static getInstance(mountObj?: any) {
+    if (!this.instance) {
+      this.instance = new LcdpApi(mountObj);
+    }
+    return this.instance;
+  }
+
+  // 将data/refs/router 挂载在外部对象,供非module方式引入，进行数据访问
+  mount(obj: any) {
+    // 废弃
+    if (!obj || typeof obj !== 'object') return;
+    this.mountObj = obj;
+    obj.lcdpApi = {
+      data: this.data,
+      refs: this.refs,
+      apis: this.apis,
+      router: this.router,
+      copy: this.copy,
+      fetch: this.fetch,
+      isSupport: this.isSupport,
+      hooks: this.hooks,
+      selCustomFunc: this.selCustomFunc,
+      callSelCustomFunc: this.callSelCustomFunc,
+      messageHandlers: this.messageHandlers,
+    };
+  }
+}
+export default LcdpApi.getInstance();
+export { LcdpApi };