mantur-components 0.1.2 → 0.1.4

package/README.md

@@ -14,7 +14,9 @@ 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
 
@@ -158,20 +160,50 @@ 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 {
-  getManturCurrentTenant,
-  getManturTenantContextSnapshot,
-  getManturTenants,
-  getManturUserPoints,
-  MANTUR_POINTS_REFRESH_EVENT,
-  MANTUR_TENANT_CONTEXT_CHANGE_EVENT,
-  refreshManturTenantContext,
-  refreshManturUserPoints,
-  switchAndRefreshManturTenant,
-  switchManturTenant,
+import { ManturHeader, formatDateByLang } from "mantur-components";
+import type {
+  ManturDateFormatType,
+  ManturDateInput,
+  ManturHeaderProps,
+  ManturHeaderUser,
+  ManturTenant,
+  ManturTenantContextDetail,
 } from "mantur-components";
 ```
 

package/dist/index.d.ts

@@ -1,7 +1,4 @@
 export { ManturHeader } from "./header";
-export { getManturCurrentTenant, getManturTenantContextSnapshot, getManturTenants, getManturUserPoints, MANTUR_POINTS_REFRESH_EVENT, MANTUR_TENANT_CONTEXT_CHANGE_EVENT, refreshManturUserPoints, refreshManturTenantContext, switchAndRefreshManturTenant, switchManturTenant, } from "./api";
-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 type { ManturLocale, ManturMessages } from "./i18n";
+export { formatDateByLang } from "./utils/date";
+export type { ManturDateFormatType, ManturDateInput } from "./utils/date";
 export type { ManturHeaderLabels, ManturHeaderProps, ManturHeaderUser, ManturProfileValues, ManturRole, ManturTenant, ManturTenantAuthContext, ManturTenantContextDetail, ManturUserPoints, } from "./types";