mantur-components 0.1.13-beta.1 → 0.1.13-beta.2

package/README.md

@@ -42,7 +42,13 @@ export function Header({
 }: {
   userInfo: { username?: string; nickname?: string; avatar?: string } | null;
 }) {
-  return <ManturHeader user={userInfo} appName={import.meta.env.VITE_APP_NAME} />;
+  return (
+    <ManturHeader
+      user={userInfo}
+      appName={import.meta.env.VITE_APP_NAME}
+      mainPrefix={import.meta.env.VITE_MAIN_PREFIX}
+    />
+  );
 }
 ```
 
@@ -63,6 +69,7 @@ export function Header({
       user={userInfo}
       disabled={disabled}
       appName={import.meta.env.VITE_APP_NAME}
+      mainPrefix={import.meta.env.VITE_MAIN_PREFIX}
       brandSlot={<span className="text-lg font-bold">自定义品牌</span>}
     >
       <div className="px-4">自定义中间内容</div>
@@ -82,6 +89,7 @@ interface ManturHeaderProps {
   onTenantContextChange?: (detail: ManturTenantContextDetail) => void;
   rechargePaymentMethod?: "card" | "alipay" | "wechat_pay";
   appName?: string;
+  mainPrefix?: string;
   stripePublishableKey?: string;
   stripePaymentWindowFeatures?: string;
 }
@@ -101,6 +109,8 @@ interface ManturHeaderProps {
 
 `appName`：当前宿主应用名，建议宿主在调用 Header 时传 `appName={import.meta.env.VITE_APP_NAME}`。充值创建订单时会优先使用该值作为请求体 `app`，不传时才回退到 `window.__MANTUR_APP_NAME__`、组件库构建环境或本地开发端口推断。
 
+`mainPrefix`：主应用域名前缀，建议宿主传 `mainPrefix={import.meta.env.VITE_MAIN_PREFIX}`。Header logo hover 时展示“主页/Home”，点击会跳回主应用首页；本地开发环境（`localhost`/`127.0.0.1`）固定跳到 `:80`，测试和生产环境按 `mainPrefix` 替换当前子域名。
+
 `stripePublishableKey`：Stripe publishable key。订单返回 Checkout Session `clientSecret`（字段名为 `clientSecret`，值以 `cs_` 开头）时，组件库会在自己的支付弹窗中挂载 Stripe Checkout Elements。
 
 `stripePaymentWindowFeatures`：兼容旧版本的窗口配置参数。当前支付不再打开新窗口，不读取该参数。
@@ -191,6 +201,7 @@ function Header({ userInfo }: { userInfo: UserInfo | null }) {
     <ManturHeader
       user={userInfo}
       appName={import.meta.env.VITE_APP_NAME}
+      mainPrefix={import.meta.env.VITE_MAIN_PREFIX}
       onTenantContextChange={applyTenantContext}
     />
   );
@@ -249,12 +260,13 @@ formatDateByLang("2026-05-19T12:00:00Z", "datetime", "en-US");
 
 ## 主应用跳转工具
 
-组件库导出 `redirectToManturMain`，用于从当前子应用跳转到主应用入口：
+组件库导出 `redirectToManturMain` 和 `redirectToManturMainHome`，用于从当前子应用跳转到主应用：
 
 ```ts
-import { redirectToManturMain } from "mantur-components";
+import { redirectToManturMain, redirectToManturMainHome } from "mantur-components";
 
 redirectToManturMain(import.meta.env.VITE_MAIN_PREFIX, import.meta.env.VITE_APP_NAME);
+redirectToManturMainHome(import.meta.env.VITE_MAIN_PREFIX);
 ```
 
 行为说明：
@@ -262,12 +274,19 @@ redirectToManturMain(import.meta.env.VITE_MAIN_PREFIX, import.meta.env.VITE_APP_
 - `VITE_MAIN_PREFIX` 为空时保留当前域名并移除端口。
 - `VITE_MAIN_PREFIX` 存在时，将当前 URL 的子域名替换为 `VITE_MAIN_PREFIX`。
 - 非 dev 跳转会追加 `appName=VITE_APP_NAME` 和 `redirect=当前路由地址` 参数。
+- `redirectToManturMainHome` 只跳主应用首页；本地开发固定跳 `localhost:80`。
 - 需要只生成 URL 不跳转时，可传 `{ navigate: false }`。
 
 ## 公共导出
 
 ```ts
-import { ManturHeader, formatDateByLang, redirectToManturMain } from "mantur-components";
+import {
+  ManturHeader,
+  formatDateByLang,
+  redirectToManturMain,
+  redirectToManturMainHome,
+  resolveManturMainHomeUrl,
+} from "mantur-components";
 import type {
   ManturBillingPackageDTO,
   ManturCreateRechargeOrderResponse,

package/dist/header/ManturHeader.d.ts

@@ -1,2 +1,2 @@
 import type { ManturHeaderProps } from "../types";
-export declare function ManturHeader({ user, disabled, brandSlot, children, onTenantContextChange, appName, stripePublishableKey, }: ManturHeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ManturHeader({ user, disabled, brandSlot, children, onTenantContextChange, appName, mainPrefix, stripePublishableKey, }: ManturHeaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { cancelManturRechargeOrder, createManturRechargeOrder, getManturBillingA
 export type { ManturBillingAccountDTO, ManturBillingPackageDTO, ManturChargePointWithModelsDTO, ManturCreateRechargeOrderRequest, ManturCreateRechargeOrderResponse, ManturLedgerEntryDTO, ManturLedgerQuery, ManturModelRuleDTO, ManturPageResult, ManturRechargeOrderDTO, } from "./api";
 export { formatDateByLang } from "./utils/date";
 export type { ManturDateFormatType, ManturDateInput } from "./utils/date";
-export { getManturRechargeRedirectContext, redirectToManturMain } from "./utils/url";
+export { getManturRechargeRedirectContext, redirectToManturMain, redirectToManturMainHome, resolveManturMainHomeUrl, } from "./utils/url";
 export type { ManturMainRedirectOptions } from "./utils/url";
 export { isManturStripePaymentWindowMessage, MANTUR_STRIPE_PAYMENT_ROUTE, MANTUR_STRIPE_PAYMENT_WINDOW_MESSAGE_TYPE, postManturStripePaymentWindowMessage, resolveManturRechargePaymentPageUrl, resolveManturStripePaymentPageUrl, } from "./utils/stripe-payment-window";
 export type { ManturStripePaymentPageUrlOptions, ManturStripePaymentWindowAction, ManturStripePaymentWindowMessage, } from "./utils/stripe-payment-window";