mantur-components 0.1.5 → 0.1.7

package/README.md

@@ -193,15 +193,33 @@ formatDateByLang("2026-05-19T12:00:00Z", "datetime", "en-US");
 
 未传语言时会读取组件库当前语言；中文输出 `YYYY-MM-DD` / `YYYY-MM-DD HH:mm:ss`，英文输出 `MM/DD/YYYY` / `MM/DD/YYYY HH:mm:ss`。
 
+## 主应用跳转工具
+
+组件库导出 `redirectToManturMain`，用于从当前子应用跳转到主应用入口：
+
+```ts
+import { redirectToManturMain } from "mantur-components";
+
+redirectToManturMain(import.meta.env.VITE_MAIN_PREFIX, import.meta.env.VITE_APP_NAME);
+```
+
+行为说明：
+
+- `VITE_MAIN_PREFIX` 为空时按 dev 环境处理，跳转到当前 URL 的 80 端口。
+- `VITE_MAIN_PREFIX` 存在时，将当前 URL 的子域名替换为 `VITE_MAIN_PREFIX`。
+- 非 dev 跳转会追加 `appName=VITE_APP_NAME` 和 `redirect=当前路由地址` 参数。
+- 需要只生成 URL 不跳转时，可传 `{ navigate: false }`。
+
 ## 公共导出
 
 ```ts
-import { ManturHeader, formatDateByLang } from "mantur-components";
+import { ManturHeader, formatDateByLang, redirectToManturMain } from "mantur-components";
 import type {
   ManturDateFormatType,
   ManturDateInput,
   ManturHeaderProps,
   ManturHeaderUser,
+  ManturMainRedirectOptions,
   ManturTenant,
   ManturTenantContextDetail,
 } from "mantur-components";

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export { ManturHeader } from "./header";
 export { formatDateByLang } from "./utils/date";
 export type { ManturDateFormatType, ManturDateInput } from "./utils/date";
+export { redirectToManturMain } from "./utils/url";
+export type { ManturMainRedirectOptions } from "./utils/url";
 export type { ManturHeaderLabels, ManturHeaderProps, ManturHeaderUser, ManturProfileValues, ManturRole, ManturTenant, ManturTenantAuthContext, ManturTenantContextDetail, ManturUserPoints, } from "./types";