zmdms-utils 0.0.75 → 0.0.76

package/dist/es/qiankunUtils.js

@@ -0,0 +1,32 @@
+/**
+ * @description 关于qiankun的一些方法
+ */
+/**
+ * @description 环境判断
+ */
+function isQiankun() {
+    return window.__POWERED_BY_QIANKUN__;
+}
+/**
+ * @description 取微应用地址
+ */
+function getMicroUrl(appKey, apps) {
+    var _a;
+    if (apps === void 0) { apps = []; }
+    var result = (_a = apps === null || apps === void 0 ? void 0 : apps.find) === null || _a === void 0 ? void 0 : _a.call(apps, function (app) { return (app === null || app === void 0 ? void 0 : app.appCode) === appKey; });
+    if (result && result.appUrl) {
+        try {
+            return result.appUrl.endsWith("/")
+                ? result.appUrl.slice(result.appUrl.length - 1)
+                : result.appUrl;
+        }
+        catch (err) {
+            console.log("未取到对应的微应用地址!");
+            return "";
+        }
+    }
+    console.log("未取到对应的微应用地址!");
+    return "";
+}
+
+export { getMicroUrl, isQiankun };

package/dist/es/request.d.ts

@@ -0,0 +1,87 @@
+import { AxiosResponse, AxiosRequestConfig, InternalAxiosRequestConfig } from 'axios';
+import { Crypto } from './crypto.js';
+
+declare class AxiosRequest {
+    private otherOptions;
+    private crypto;
+    private jumpCallback;
+    private isExpired;
+    private isOffline;
+    private isNotFound;
+    private isTimeout;
+    private isTimeoutConfirm?;
+    private isTimeoutConfirmStr?;
+    private messageWarning?;
+    private modalConfirm?;
+    private instanceAxios;
+    private tokenKey;
+    constructor(otherOptions: IOtherOptions);
+    private defaultSetting;
+    private interceptorsRequest;
+    private interceptorsResponse;
+    private responseSuccess;
+    private responseError;
+    private logoutHandle;
+    request(options: IOptions): Promise<AxiosResponse<any, any>>;
+}
+interface IOptions extends AxiosRequestConfig {
+    isFormData?: boolean;
+    /**
+     * 是否需要携带请求头默认携带
+     */
+    isAuth?: boolean;
+    /**
+     * 是否对传输数据开启加密模式
+     */
+    isCrypto?: boolean | "aes" | "des";
+    /**
+     * 是否交给实例处理异常
+     */
+    isErrorMessage?: boolean;
+    /**
+     * 实例返回信息 简化处理
+     */
+    isEasyMessage?: boolean;
+    /**
+     * 登录过期是否交给自己处理
+     */
+    isHandleLoginExpiration?: boolean;
+    /**
+     * 登录过期跳转逻辑交给实例自己处理
+     */
+    expirationHandle?: (options: any) => void;
+}
+interface IOtherOptions {
+    /** token过期等 需要跳转到登录页 */
+    jumpCallback?: (status: number) => void;
+    /** 提示方法 外部传入 */
+    messageWarning?: (msg: string, duration: number, callback?: () => void) => void;
+    modalConfirm?: (msg: string, callback?: () => void) => void;
+    /** @deprecated 租户ID，只有登录接口 需要 传递。 */
+    TenantId?: string;
+    /** auth值 */
+    Authorization?: string;
+    /** 公用请求头 */
+    commonHeaders?: {
+        [prop: string]: any;
+    };
+    /** 请求认证TOKEN KEY */
+    tokenKey?: string;
+    /** 超时时间 */
+    timeout?: number;
+    /** 基础url */
+    baseURL?: string;
+    /** 加密实例方法 */
+    crypto?: Crypto;
+    /** 超时是否需要弹框 */
+    isTimeoutConfirm?: boolean;
+    /** 超时弹框提示内容 */
+    isTimeoutConfirmStr?: string;
+    /** 拦截器自定义 */
+    interceptorsRequestHandle?: () => void;
+    interceptorsRequestConfig?: (config: InternalAxiosRequestConfig<any>) => InternalAxiosRequestConfig<any>;
+    /** 响应器自定义 */
+    interceptorsResponseHandle?: () => void;
+}
+
+export { AxiosRequest, IOptions, IOtherOptions };

package/dist/es/request.js

@@ -0,0 +1,308 @@
+import { __rest, __assign } from './_virtual/_tslib.js';
+import axios from 'axios';
+import { removeToken, getToken } from './auth.js';
+import { TOKEN_KEY } from './constants.js';
+
+var defaultOptions = {
+    // TenantId: "000000", // 租户ID不需要了
+    Authorization: "Basic em1kbXM6em1kbXNfc2VjcmV0",
+    timeout: 60000,
+};
+var AxiosRequest = /** @class */ (function () {
+    function AxiosRequest(otherOptions) {
+        // 登录是否过期 这个变量是为了让弹出提示只展示一次
+        this.isExpired = false;
+        // 被挤下线 定义变量的目的同上
+        this.isOffline = false;
+        // 404
+        this.isNotFound = false;
+        // timeout
+        this.isTimeout = false;
+        // axios单例
+        this.instanceAxios = axios.create();
+        // tokenKey
+        this.tokenKey = TOKEN_KEY;
+        var crypto = otherOptions.crypto, jumpCallback = otherOptions.jumpCallback, isTimeoutConfirm = otherOptions.isTimeoutConfirm, isTimeoutConfirmStr = otherOptions.isTimeoutConfirmStr, messageWarning = otherOptions.messageWarning, modalConfirm = otherOptions.modalConfirm, tokenKey = otherOptions.tokenKey, resetOtherOptions = __rest(otherOptions, ["crypto", "jumpCallback", "isTimeoutConfirm", "isTimeoutConfirmStr", "messageWarning", "modalConfirm", "tokenKey"]);
+        this.otherOptions = __assign(__assign({}, defaultOptions), resetOtherOptions);
+        this.crypto = crypto;
+        this.tokenKey = tokenKey || TOKEN_KEY;
+        this.isTimeoutConfirm = isTimeoutConfirm;
+        this.isTimeoutConfirmStr = isTimeoutConfirmStr;
+        this.jumpCallback = jumpCallback;
+        this.messageWarning = messageWarning;
+        this.modalConfirm = modalConfirm;
+        this.defaultSetting();
+        this.interceptorsRequest();
+        this.interceptorsResponse();
+    }
+    // 设置axios方法默认值
+    AxiosRequest.prototype.defaultSetting = function () {
+        var _this = this;
+        // 设置默认请求头
+        // 租户ID只有登录的时候才需要传递
+        // this.instanceAxios.defaults.headers.common["Tenant-Id"] =
+        //   this.otherOptions.TenantId;
+        this.instanceAxios.defaults.headers.common["Authorization"] =
+            this.otherOptions.Authorization;
+        if (this.otherOptions.commonHeaders) {
+            Object.keys(this.otherOptions.commonHeaders).forEach(function (key) {
+                var _a;
+                _this.instanceAxios.defaults.headers.common[key] =
+                    (_a = _this.otherOptions.commonHeaders) === null || _a === void 0 ? void 0 : _a[key];
+            });
+        }
+        // 其他默认参数
+        this.instanceAxios.defaults.timeout = this.otherOptions.timeout;
+        this.instanceAxios.defaults.baseURL = this.otherOptions.baseURL;
+    };
+    // 拦截请求
+    AxiosRequest.prototype.interceptorsRequest = function () {
+        var _this = this;
+        if (this.otherOptions.interceptorsRequestHandle) {
+            this.otherOptions.interceptorsRequestHandle();
+            return;
+        }
+        this.instanceAxios.interceptors.request.use(function (config) {
+            if (_this.otherOptions.interceptorsRequestConfig) {
+                return _this.otherOptions.interceptorsRequestConfig(config);
+            }
+            return config;
+        }, function (error) {
+            return Promise.reject(error);
+        });
+    };
+    // 拦截响应
+    AxiosRequest.prototype.interceptorsResponse = function () {
+        var _this = this;
+        if (this.otherOptions.interceptorsResponseHandle) {
+            this.otherOptions.interceptorsResponseHandle();
+            return;
+        }
+        this.instanceAxios.interceptors.response.use(function (response) {
+            // console.log(response);
+            // 统一处理响应正常
+            var result = _this.responseSuccess(response);
+            return result;
+        }, function (error) {
+            console.log(error);
+            // 统一处理响应异常
+            _this.responseError(error);
+            return Promise.reject(error);
+        });
+    };
+    // 响应成功处理
+    AxiosRequest.prototype.responseSuccess = function (response) {
+        var _a;
+        var config = response.config, status = response.status, data = response.data;
+        // 对返回数据进行解密后 返回给客户端
+        if ((_a = response.config) === null || _a === void 0 ? void 0 : _a.isCrypto) ;
+        if (!config.isEasyMessage) {
+            return response;
+        }
+        // 简化处理信息
+        if (status === 200) {
+            // 字符串的情况也基本不会出现
+            if (typeof data === "string") {
+                return {
+                    success: true,
+                    msg: "操作成功",
+                    data: data,
+                };
+            }
+            // 这里的data 不存在 可能说明这个接口没有返回信息
+            // 大多数情况下 不会这样 如果这种情况 也认为接口返回正常
+            if (!data) {
+                return {
+                    success: true,
+                    msg: "操作成功",
+                    data: data,
+                };
+            }
+            // 大多数情况下 都是这种逻辑
+            if ((data === null || data === void 0 ? void 0 : data.code) === 200) {
+                return data;
+            }
+        }
+        // 201也可能出现，比如附件下载
+        if (status === 201) {
+            return response;
+        }
+        return Promise.reject(response.data);
+    };
+    // 响应错误处理
+    AxiosRequest.prototype.responseError = function (error) {
+        var _this = this;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
+        if (error === void 0) { error = {}; }
+        var response = error.response;
+        // 登录过期是否自己处理
+        var isHandleLoginExpiration = (_a = error === null || error === void 0 ? void 0 : error.config) === null || _a === void 0 ? void 0 : _a.isHandleLoginExpiration;
+        var expirationHandle = (_b = error === null || error === void 0 ? void 0 : error.config) === null || _b === void 0 ? void 0 : _b.expirationHandle;
+        // 处理token失效
+        // TODO: 刷新token逻辑
+        if ((response === null || response === void 0 ? void 0 : response.status) === 401 && !isHandleLoginExpiration) {
+            removeToken();
+            if (!this.isExpired) {
+                this.isExpired = true;
+                (_c = this.messageWarning) === null || _c === void 0 ? void 0 : _c.call(this, "登录过期", 3.5, function () {
+                    _this.isExpired = false;
+                });
+                if (expirationHandle) {
+                    expirationHandle(response);
+                }
+                else {
+                    this.logoutHandle(response.status);
+                }
+            }
+            return;
+        }
+        // 处理被挤下线逻辑
+        if ((response === null || response === void 0 ? void 0 : response.status) === 501 && !isHandleLoginExpiration) {
+            removeToken();
+            if (!this.isOffline) {
+                this.isOffline = true;
+                (_d = this.messageWarning) === null || _d === void 0 ? void 0 : _d.call(this, "你的账号已在其他地方登录！", 3.5, function () {
+                    _this.isOffline = false;
+                });
+                if (expirationHandle) {
+                    expirationHandle(response);
+                }
+                else {
+                    this.logoutHandle(response.status);
+                }
+            }
+            return;
+        }
+        // 处理404逻辑
+        if ((response === null || response === void 0 ? void 0 : response.status) === 404) {
+            if (!this.isNotFound) {
+                this.isNotFound = true;
+                (_e = this.messageWarning) === null || _e === void 0 ? void 0 : _e.call(this, "\u63A5\u53E3\uFF1A".concat(response.config.url, " \u672A\u627E\u5230\uFF01"), 3.5, function () {
+                    _this.isNotFound = false;
+                });
+            }
+            return;
+        }
+        // 处理接口超时逻辑
+        if (this.isTimeoutConfirm &&
+            ((_h = (_g = (_f = error === null || error === void 0 ? void 0 : error.config) === null || _f === void 0 ? void 0 : _f.method) === null || _g === void 0 ? void 0 : _g.toUpperCase) === null || _h === void 0 ? void 0 : _h.call(_g)) === "POST" &&
+            !response &&
+            error.code === "ECONNABORTED" &&
+            ((_k = (_j = error.message) === null || _j === void 0 ? void 0 : _j.indexOf) === null || _k === void 0 ? void 0 : _k.call(_j, "".concat(error.config.timeout, "ms"))) !== -1) {
+            if (!this.isTimeout) {
+                this.isTimeout = true;
+                (_l = this.modalConfirm) === null || _l === void 0 ? void 0 : _l.call(this, "".concat(this.isTimeoutConfirmStr
+                    ? this.isTimeoutConfirmStr
+                    : "请求超时，请稍后再试，或联系相关人员确认后处理！", "\n          \u63A5\u53E3\u5730\u5740: ").concat((_m = error === null || error === void 0 ? void 0 : error.config) === null || _m === void 0 ? void 0 : _m.url, "\n          \u8BF7\u6C42\u65B9\u5F0F: ").concat((_o = error === null || error === void 0 ? void 0 : error.config) === null || _o === void 0 ? void 0 : _o.method, "\n          \u8BF7\u6C42\u8D85\u65F6\u65F6\u95F4: ").concat(((_p = error === null || error === void 0 ? void 0 : error.config) === null || _p === void 0 ? void 0 : _p.timeout) / 1000, "\u79D2\n        "), function () {
+                    _this.isTimeout = false;
+                });
+            }
+            return;
+        }
+        // 提示业务错误
+        if ((_q = error === null || error === void 0 ? void 0 : error.config) === null || _q === void 0 ? void 0 : _q.isErrorMessage) {
+            // 详细信息 再开发模式开启 之后上到别的环境会去掉
+            (_r = this.modalConfirm) === null || _r === void 0 ? void 0 : _r.call(this, "".concat(((_t = (_s = error === null || error === void 0 ? void 0 : error.response) === null || _s === void 0 ? void 0 : _s.data) === null || _t === void 0 ? void 0 : _t.msg) || (error === null || error === void 0 ? void 0 : error.msg) || "服务器异常"));
+            // 接口地址: ${error?.config?.url}
+            // 响应状态码: ${error?.response?.status}
+            // 请求方式: ${error?.config?.method}
+            return;
+        }
+    };
+    // 跳转逻辑处理
+    AxiosRequest.prototype.logoutHandle = function (status) {
+        // 自定义跳转
+        if (this.jumpCallback) {
+            this.jumpCallback(status);
+        }
+        else {
+            window.location.href = "/login";
+        }
+    };
+    // 实例方法
+    AxiosRequest.prototype.request = function (options) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        var isFormData = options.isFormData, _k = options.isAuth, isAuth = _k === void 0 ? true : _k, resetOptions = __rest(options, ["isFormData", "isAuth"]);
+        var newOptions = resetOptions;
+        // 自定义请求头
+        if (!newOptions.headers) {
+            newOptions.headers = {};
+        }
+        if (isAuth) {
+            var token = getToken();
+            newOptions.headers[this.tokenKey] = "bearer ".concat(token);
+        }
+        // 遍历params，将undefined值 转为null值
+        if (newOptions.data) {
+            newOptions.data = transformData(newOptions.data);
+        }
+        if (newOptions.params) {
+            newOptions.params = transformData(newOptions.params);
+        }
+        // 处理特殊请求
+        var specialMethod = ["POST", "PUT", "PATCH"];
+        var method = ((_a = newOptions.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()) || "";
+        if (specialMethod.includes(method)) {
+            if (isFormData) {
+                var formData = new FormData();
+                var dataObj = newOptions.data || {};
+                var dataKey = Object.keys(dataObj);
+                var dataVal = Object.values(dataObj);
+                for (var i = 0; i < dataKey.length; i++) {
+                    if (dataVal[i]) {
+                        formData.append(dataKey[i], dataVal[i]);
+                    }
+                }
+                newOptions.headers["Content-Type"] = "multipart/form-data";
+                newOptions.data = formData;
+            }
+            else {
+                newOptions.headers = __assign({ "Content-Type": "application/json" }, newOptions.headers);
+            }
+        }
+        // 数据加密处理 TODO:
+        // 将参数进行aes加密
+        if (newOptions.isCrypto === true || newOptions.isCrypto === "aes") {
+            if (newOptions.data) {
+                newOptions.data = (_c = (_b = this.crypto) === null || _b === void 0 ? void 0 : _b.encrypt) === null || _c === void 0 ? void 0 : _c.call(_b, JSON.stringify(newOptions.data));
+            }
+            if (newOptions.params) {
+                newOptions.params = (_e = (_d = this.crypto) === null || _d === void 0 ? void 0 : _d.encrypt) === null || _e === void 0 ? void 0 : _e.call(_d, JSON.stringify(newOptions.params));
+            }
+        }
+        // 将参数进行des加密
+        if (newOptions.isCrypto === "des") {
+            if (newOptions.data) {
+                newOptions.data = (_g = (_f = this.crypto) === null || _f === void 0 ? void 0 : _f.encrypt_des) === null || _g === void 0 ? void 0 : _g.call(_f, JSON.stringify(newOptions.data));
+            }
+            if (newOptions.params) {
+                newOptions.params = (_j = (_h = this.crypto) === null || _h === void 0 ? void 0 : _h.encrypt_des) === null || _j === void 0 ? void 0 : _j.call(_h, JSON.stringify(newOptions.params));
+            }
+        }
+        return this.instanceAxios(newOptions);
+    };
+    return AxiosRequest;
+}());
+function transformData(data) {
+    if (data == null) {
+        return data;
+    }
+    if (typeof data !== "object") {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return data.map(function (item) { return transformData(item); });
+    }
+    if (Object.prototype.toString.call(data) === "[object Object]") {
+        var newData = {};
+        for (var key in data) {
+            if (data.hasOwnProperty(key)) {
+                newData[key] = transformData(data[key]);
+            }
+        }
+        return newData;
+    }
+    return data;
+}
+
+export { AxiosRequest };

package/dist/es/src/locales/i18n.js

@@ -0,0 +1,16 @@
+import instance from '../../node_modules/i18next/dist/esm/i18next.js';
+import { initReactI18next } from '../../node_modules/react-i18next/dist/es/initReactI18next.js';
+
+/**
+ * 初始化逻辑
+ * - 本函数主要用于初始化 i18next 实例，同时使用 react-i18next 插件进行 react 组件的支持
+ * - 本函数的调用时机，一般是在项目的入口文件中进行调用，如 src/main.tsx 中
+ * @param options 参数 同i18next.init 第一个参数
+ * @param callback 参数 同i18next.init 第二个参数
+ * @returns
+ */
+function initLocale(options, callback) {
+    return instance.use(initReactI18next).init(options, callback);
+}
+
+export { instance as i18n, initLocale };

package/dist/es/src/locales/t-in-non-react.js

@@ -0,0 +1,54 @@
+import instance from '../../node_modules/i18next/dist/esm/i18next.js';
+import { getTFuncArgs } from './t-options.js';
+
+/**
+ * t 函数封装：
+ * - 本文件的几个 t 函数，主要用于弥补一些在 React 组件之外使用的场景
+ * - 常规情况下，在 react 组件中，更加推荐的是使用 react-i18next 包中的 t 函数，即 const { t } = useTranslate(); 形式
+ */
+/** 包裹一层 try-catch 的 t 函数 */
+var tryT = function (key, defaultValueOrOptions) {
+    var _a = getTFuncArgs(defaultValueOrOptions), defaultValue = _a.defaultValue, options = _a.options;
+    if (!key) {
+        // 情况1：键名为空，返回默认值或键名
+        console.error("tryT: \u8BF7\u4E0D\u8981\u4F20\u5165\u7A7A key \u503C\u8FDB\u884C i18n.t \u51FD\u6570\u6267\u884C\uFF0C\u8FD9\u5C06\u4F1A\u5BFC\u81F4\u76F4\u63A5\u8FD4\u56DE\u7A7A\u5B57\u7B26\u4E32\uFF01");
+        return defaultValue || key;
+    }
+    if (!instance.exists(key)) {
+        // 情况2：键名不存在，返回默认值或键名
+        console.error("tryT: i18n-key '".concat(key, "' \u4E0D\u5B58\u5728\uFF0C\u8BF7\u68C0\u67E5\u5BF9\u5E94\u7684 @/locales/resources/locales/xx.json \u4E2D\u662F\u5426\u5B58\u5728\u5BF9\u5E94\u503C"));
+        return defaultValue || key;
+    }
+    try {
+        // 情况3：尝试执行 i18n.t 函数
+        return instance.t(key, options);
+    }
+    catch (err) {
+        // 情况4：执行 i18n.t 函数异常，返回默认值或键名
+        console.error("tryT: i18n.t key=".concat(key, " \u51FD\u6570\u6267\u884C\u5F02\u5E38\uFF1Aerr="), err);
+        return defaultValue || key;
+    }
+};
+/**
+ * 同步版本的 i18n.t 函数（应对在 react 组件外使用的翻译函数）
+ * - 如果 i18n 未初始化，则返回默认值或键名
+ * - 如果 i18n 初始化后，键名不存在，则返回默认值或键名
+ * - 其他正常情况（已经初始化+键名存在），则返回翻译值
+ * @description 本函数为在非 react 组件中使用的翻译函数；（在react中请求使用 useTranslate() 返回的 t 函数）
+ * @param {string} key
+ * @param {TOpionsEx|string} defaultValue 必填值
+ * @returns {string}
+ * @example
+ *   const txt = t('someLocaleKey', '兜底默认值');
+ */
+function safeT(key, defaultValueOrOptions) {
+    if (instance.isInitialized) {
+        return tryT(key, defaultValueOrOptions);
+    }
+    // 异常情况：没有初始化完成时，返回默认值
+    var defaultValue = getTFuncArgs(defaultValueOrOptions).defaultValue;
+    console.warn("safeT: i18n is not initialized. Returning defaultValue(".concat(defaultValue, ") or origin key (").concat(key, ")."));
+    return defaultValue || key;
+}
+
+export { safeT };

package/dist/es/src/locales/t-options.js

@@ -0,0 +1,20 @@
+/**
+ * 获取 t 函数的参数
+ * @param {string | TOpionsEx} defaultValueOrOptions 默认值或者选项
+ * @returns { {defaultValue: string, options: TOpionsEx} } 默认值和选项
+ */
+function getTFuncArgs(defaultValueOrOptions) {
+    var options = null;
+    var defaultValue = "";
+    if (typeof defaultValueOrOptions === "string") {
+        defaultValue = defaultValueOrOptions;
+        options = { defaultValue: defaultValue };
+    }
+    else {
+        options = defaultValueOrOptions;
+        defaultValue = options.defaultValue;
+    }
+    return { defaultValue: defaultValue, options: options };
+}
+
+export { getTFuncArgs };

package/dist/es/src/locales/use-translation.js

@@ -0,0 +1,60 @@
+import { getTFuncArgs } from './t-options.js';
+import { useTranslation } from '../../node_modules/react-i18next/dist/es/useTranslation.js';
+
+/**
+ * 这里只是简单代理一下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: 是否加载完成
+ */
+function useZtTranslation(ns, options) {
+    var _a = useTranslation(ns, options), _tOld = _a.t, i18n = _a.i18n, ready = _a.ready;
+    // 扩展t方法，用于处理嵌套的翻译键
+    var tEnhance = function (key, defaultValueOrOptions) {
+        var _a = getTFuncArgs(defaultValueOrOptions), defaultValue = _a.defaultValue, options = _a.options;
+        if (!key) {
+            // 情况1：键名为空，返回默认值或键名
+            console.error("tEnhance: \u8BF7\u4E0D\u8981\u4F20\u5165\u7A7A key \u503C\u8FDB\u884C t \u51FD\u6570\u6267\u884C\uFF0C\u8FD9\u5C06\u4F1A\u5BFC\u81F4\u76F4\u63A5\u8FD4\u56DE\u7A7A\u5B57\u7B26\u4E32\uFF01");
+            return defaultValue || key;
+        }
+        if (!i18n.exists(key)) {
+            // 情况2：键名不存在，返回默认值或键名
+            console.error("tEnhance: i18n-key '".concat(key, "' \u4E0D\u5B58\u5728\uFF0C\u8BF7\u68C0\u67E5\u5BF9\u5E94\u7684 @/locales/resources/locales/xx.json \u4E2D\u662F\u5426\u5B58\u5728\u5BF9\u5E94\u503C"));
+            return defaultValue || key;
+        }
+        try {
+            return _tOld(key, options);
+        }
+        catch (error) {
+            console.warn("tEnhance: t \u51FD\u6570\u6267\u884C\u5F02\u5E38\uFF0C\u8BF7\u68C0\u67E5! key=".concat(key, ", err="), error);
+            return defaultValue || key || "unknown";
+        }
+    };
+    return {
+        /**
+         * 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: tEnhance,
+        i18n: i18n,
+        ready: ready,
+    };
+}
+
+export { useZtTranslation as useTranslation };