mantur-components 0.1.1 → 0.1.3

package/README.md

@@ -14,6 +14,8 @@ npm install mantur-components
 npm install react react-dom @arco-design/web-react next-themes react-i18next
 ```
 
+`next-themes` 用于组件库内置的 `ThemeSwitch`，它不是 Next.js 框架本身，普通 React/Vite 宿主也可以使用。
+
 组件库使用 Tailwind 工具类，不再导出独立的 CSS 文件，不需要引入 `mantur-components/style.css`。
 
 ## ManturHeader
@@ -75,6 +77,7 @@ interface ManturHeaderProps {
   disabled?: boolean;
   brandSlot?: React.ReactNode;
   children?: React.ReactNode;
+  onTenantContextChange?: (detail: ManturTenantContextDetail) => void;
 }
 ```
 
@@ -86,6 +89,8 @@ interface ManturHeaderProps {
 
 `children`：Header 中间弹性区域插槽。传入后显示传入内容；不传则保持为空。
 
+`onTenantContextChange`：Header 完成团队上下文初始化或切换团队成功后触发，直接透出当前选中团队、团队列表和当前团队认证上下文。宿主项目需要同步自己的 store 时优先使用这个回调。
+
 ### 用户类型
 
 ```ts
@@ -118,14 +123,10 @@ window.__MANTUR_COMPONENTS_POINTS_ENDPOINT__ = "/users/me/points";
 
 团队列表、当前团队、切换团队都由 `ManturHeader` 内部处理。
 
-如果宿主项目需要同步自己的 store，例如 `activeTenantId`、权限、角色、已开通应用，可以监听 `MANTUR_TENANT_CONTEXT_CHANGE_EVENT`。
+如果宿主项目需要同步自己的 store，例如 `activeTenantId`、权限、角色、已开通应用，优先通过 `ManturHeader` 的 `onTenantContextChange` 回调获取当前团队上下文。
 
 ```tsx
-import {
-  getManturTenantContextSnapshot,
-  MANTUR_TENANT_CONTEXT_CHANGE_EVENT,
-  type ManturTenantContextDetail,
-} from "mantur-components";
+import { ManturHeader, type ManturTenantContextDetail } from "mantur-components";
 
 function applyTenantContext(detail: ManturTenantContextDetail) {
   const tenantId = detail.auth?.tenantId || detail.currentTenant?.tenantId;
@@ -137,15 +138,8 @@ function applyTenantContext(detail: ManturTenantContextDetail) {
   // setEnabledApps(detail.auth?.enabledApps || [])
 }
 
-window.addEventListener(MANTUR_TENANT_CONTEXT_CHANGE_EVENT, (event) => {
-  if (event instanceof CustomEvent) {
-    applyTenantContext(event.detail as ManturTenantContextDetail);
-  }
-});
-
-const snapshot = getManturTenantContextSnapshot();
-if (snapshot) {
-  applyTenantContext(snapshot);
+function Header({ userInfo }: { userInfo: UserInfo | null }) {
+  return <ManturHeader user={userInfo} onTenantContextChange={applyTenantContext} />;
 }
 ```
 
@@ -166,10 +160,44 @@ interface ManturTenantContextDetail {
 }
 ```
 
+## i18n 文案
+
+组件库文案按组件拆分为 JSON 文件，目录结构为：
+
+```text
+src/i18n/locales/{locale}/{component}.json
+```
+
+例如：
+
+```text
+src/i18n/locales/zh-CN/header.json
+src/i18n/locales/zh-CN/lang-switch.json
+src/i18n/locales/en-US/header.json
+src/i18n/locales/en-US/lang-switch.json
+```
+
+新增组件文案时，按组件新增对应 JSON 文件，并在 `src/i18n.ts` 中聚合。
+
+## 日期工具
+
+组件库导出 `formatDateByLang`，用于按语言格式化日期：
+
+```ts
+import { formatDateByLang } from "mantur-components";
+
+formatDateByLang("2026-05-19T12:00:00Z");
+formatDateByLang("2026-05-19T12:00:00Z", "date");
+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`。
+
 ## 导出的工具方法
 
 ```ts
 import {
+  formatDateByLang,
   getManturCurrentTenant,
   getManturTenantContextSnapshot,
   getManturTenants,

package/dist/header/ManturHeader.d.ts

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

package/dist/index.d.ts

@@ -3,5 +3,7 @@ export { getManturCurrentTenant, getManturTenantContextSnapshot, getManturTenant
 export { getManturMessages, getStoredManturLocale, MANTUR_LANGUAGE_CHANGE_EVENT, MANTUR_LANGUAGE_SOURCE_STORAGE_KEY, MANTUR_LANGUAGE_STORAGE_KEY, MANTUR_MESSAGES, normalizeManturLocale, } from "./i18n";
 export { LangSwitch, LANGUAGE_SOURCE_STORAGE_KEY, LANGUAGE_STORAGE_KEY } from "./lang-switch";
 export { ThemeSwitch } from "./theme-switch";
+export { formatDateByLang } from "./utils/date";
 export type { ManturLocale, ManturMessages } from "./i18n";
+export type { ManturDateFormatType, ManturDateInput } from "./utils/date";
 export type { ManturHeaderLabels, ManturHeaderProps, ManturHeaderUser, ManturProfileValues, ManturRole, ManturTenant, ManturTenantAuthContext, ManturTenantContextDetail, ManturUserPoints, } from "./types";