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

package/README.md

@@ -42,7 +42,7 @@ export function Header({
 }: {
   userInfo: { username?: string; nickname?: string; avatar?: string } | null;
 }) {
-  return <ManturHeader user={userInfo} />;
+  return <ManturHeader user={userInfo} appName={import.meta.env.VITE_APP_NAME} />;
 }
 ```
 
@@ -62,6 +62,7 @@ export function Header({
     <ManturHeader
       user={userInfo}
       disabled={disabled}
+      appName={import.meta.env.VITE_APP_NAME}
       brandSlot={<span className="text-lg font-bold">自定义品牌</span>}
     >
       <div className="px-4">自定义中间内容</div>
@@ -80,6 +81,7 @@ interface ManturHeaderProps {
   children?: React.ReactNode;
   onTenantContextChange?: (detail: ManturTenantContextDetail) => void;
   rechargePaymentMethod?: "card" | "alipay" | "wechat_pay";
+  appName?: string;
   stripePublishableKey?: string;
   stripePaymentWindowFeatures?: string;
 }
@@ -97,6 +99,8 @@ interface ManturHeaderProps {
 
 `rechargePaymentMethod`：兼容旧版本的支付方式参数。当前充值创建订单不再主动提交支付方式，支付方式由 Stripe Checkout Session 内部选择。
 
+`appName`：当前宿主应用名，建议宿主在调用 Header 时传 `appName={import.meta.env.VITE_APP_NAME}`。充值创建订单时会优先使用该值作为请求体 `app`，不传时才回退到 `window.__MANTUR_APP_NAME__`、组件库构建环境或本地开发端口推断。
+
 `stripePublishableKey`：Stripe publishable key。订单返回 Checkout Session `clientSecret`（字段名为 `clientSecret`，值以 `cs_` 开头）时，组件库会在自己的支付弹窗中挂载 Stripe Checkout Elements。
 
 `stripePaymentWindowFeatures`：兼容旧版本的窗口配置参数。当前支付不再打开新窗口，不读取该参数。
@@ -153,7 +157,7 @@ import {
 } from "mantur-components";
 ```
 
-充值面板打开时会调用 `getManturBillingPackages()` 拉取 `/billing/packages`；点击支付时会调用 `createManturRechargeOrder()` 创建 `/billing/recharge/orders`，请求体传 `packageId` 或 `customAmount`，并固定传 `uiMode: "elements"`。请求体还会补齐 `app` 和 `redirect`：`app` 取 `window.__MANTUR_APP_NAME__` 或 `VITE_APP_NAME`；本地开发若没有这些配置，会用当前端口兜底识别应用（`:82` creative-agent、`:83` production-agent、`:81` traffic-engine、`:84` distribution-matrix）。`redirect` 与路由拦截器一致，只取当前页面的 `pathname + search + hash`，不拼接协议、域名或开发端口。订单创建成功后会触发浏览器事件 `mantur-recharge-order-created`，`detail` 为后端返回的订单信息。
+充值面板打开时会调用 `getManturBillingPackages()` 拉取 `/billing/packages`；点击支付时会调用 `createManturRechargeOrder()` 创建 `/billing/recharge/orders`，请求体传 `packageId` 或 `customAmount`，并固定传 `uiMode: "elements"`。请求体还会补齐 `app` 和 `redirect`：`app` 优先取 `ManturHeader` 的 `appName` prop，建议宿主传 `import.meta.env.VITE_APP_NAME`；未传时回退到 `window.__MANTUR_APP_NAME__` 或组件库内可读取的 `VITE_APP_NAME`；本地开发若没有这些配置，会用当前端口兜底识别应用（`:82` creative-agent、`:83` production-agent、`:81` traffic-engine、`:84` distribution-matrix）。`redirect` 与路由拦截器一致，只取当前页面的 `pathname + search + hash`，不拼接协议、域名或开发端口。订单创建成功后会触发浏览器事件 `mantur-recharge-order-created`，`detail` 为后端返回的订单信息。
 
 积分明细弹窗打开后会调用 `getManturBillingLedger()` 拉取 `/billing/accounts/me/ledger`，并根据“获得/消耗”、来源和日期范围筛选传递 `directions`、`bizTypes`、`fromTime`、`toTime`，分页总数使用接口返回的 `total`。
 
@@ -183,7 +187,13 @@ function applyTenantContext(detail: ManturTenantContextDetail) {
 }
 
 function Header({ userInfo }: { userInfo: UserInfo | null }) {
-  return <ManturHeader user={userInfo} onTenantContextChange={applyTenantContext} />;
+  return (
+    <ManturHeader
+      user={userInfo}
+      appName={import.meta.env.VITE_APP_NAME}
+      onTenantContextChange={applyTenantContext}
+    />
+  );
 }
 ```
 
@@ -277,3 +287,40 @@ import type {
 ```bash
 npm run build
 ```
+
+## 发布
+
+测试包和生产包直接发布到 npm，通过 npm tag 区分：
+
+```bash
+npm run publish:test
+npm run publish:pro
+```
+
+`publish:test` 会使用 `vite build --mode test` 构建，并发布到 `test` tag。测试包版本必须是 prerelease，例如：
+
+```bash
+npm version prerelease --preid beta --no-git-tag-version
+npm run publish:test
+```
+
+测试项目安装：
+
+```bash
+npm install mantur-components@test
+```
+
+`publish:pro` 会使用 `vite build --mode pro` 构建，并发布到 `latest` tag。生产包版本不能包含 `beta`、`alpha`、`rc` 等 prerelease 标识，例如：
+
+```bash
+npm version 0.1.13 --no-git-tag-version
+npm run publish:pro
+```
+
+生产项目安装：
+
+```bash
+npm install mantur-components@latest
+```
+
+环境变量读取遵循 Vite mode 规则：测试包读取 `.env` 和 `.env.test`，生产包读取 `.env` 和 `.env.pro`。发布前需要确认对应环境变量已经写入正确的 `VITE_*` 配置。

package/dist/header/ManturHeader.d.ts

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