@tap-payments/os-micro-frontend-shared

中文文档
0.3.265发布于 2026/11/02MITTypeScriptES Module

Tap Payments微前端的共享组件和实用程序

中文使用文档
文档目录14 节
  1. 这是什么?
  2. 快速入门
  3. 文档
  4. 关键特性
  5. 开发
  6. 出版
  7. 自动化(推荐)
  8. 手册
  9. 贡献
  10. 项目结构
  11. 技术堆栈
  12. 许可证
  13. 链接
  14. 支持

os-micro-frontend-shared

用于Tap Payments微前端的共享React组件库

npm version License: MIT

这是什么?

一个全面的React组件库提供:

  • 100+ UI组件 (按钮、表格、对话框、表单、过滤器)
  • 18个定制钩子 (烤面包,窗口尺寸,主题模式)
  • 47个实用模块 (日期/货币格式,验证)
  • 完整的TypeScript支持 使用类型定义
  • MUI-based主题 具有暗/亮模式和RTL/LTR支持
  • 高性能虚拟表 对于大型数据集

快速入门

npm install @tap-payments/os-micro-frontend-shared
# or
yarn add @tap-payments/os-micro-frontend-shared
import { Button, VirtualTable, useToast } from '@tap-payments/os-micro-frontend-shared'

function MyApp() {
  const toast = useToast()

  return (
    <Button variant="primary" onClick={() => toast.success('Hello!')}>
      Click me
    </Button>
  )
}

文档

📚 完整文档→

文档描述阅读时间
概述功能、包规格、特性15分钟
设置和堆栈安装、命令、工作流10分钟
体系结构布局,导出,模块边界15分钟
组件指南用示例对所有组件进行分类参考
组件开发构建新组件20分钟

为开发人员按顺序阅读: 概述 → 设置 → 组件指南.

关键特性

  • ✅ ESM-only -现代模块系统与树摇
  • ✅ 同行依赖性 —避免版本冲突
  • ✅ 完整的打印稿 -完全型安全
  • ✅ 100 +组件 -全面的UI库
  • ✅ 虚拟表 -高性能列表
  • ✅ React Hook表单 -集成表单组件
  • ✅ 主题 -暗/亮模式,RTL/LTR
  • ✅ memoize的 -优化性能

开发

# Install dependencies
yarn install

# Start dev server
yarn dev

# Build library
yarn build

# Test locally in another project
yarn push:local   # requires yalc

看到 安装指南 详细说明。

出版

将PR合并到 main 自动:

  1. 补丁版本
  2. 提交版本变更
  3. 构建图书馆
  4. 向npm发布

版本提交使用该格式 chore(release): vX.Y.Z.

查找已发布版本的提交:

git log --oneline --grep="release: vX.Y.Z"

手册

# Test version (with -test tag)
yarn push:test

# Production
yarn push

看到 出版 获取详细信息。

贡献

  1. 创建特性分支
  2. 进行更改 src/
  3. 运行 yarn lint:fix 和 yarn prettier:fix
  4. 提交(预提交钩子将运行)
  5. 推动和创建公关 main

看到 开发 详细指南。

项目结构

src/
├── components/      # 100+ React components
├── hooks/          # 18 custom React hooks
├── utils/          # 47 utility modules
├── types/          # TypeScript type definitions
├── constants/      # App constants and configs
└── theme/          # MUI theme configuration

看到 文件夹/模块结构 获取详细信息。

技术堆栈

  • React 18 + TypeScript 5
  • MUI(材质- ui) 5 +情感
  • React Hook Form +是的
  • Vite 6(构建+开发)
  • ESLint + Prettier

看到 技术堆栈 查看完整的列表。

许可证

麻省理工学院© 利用支付


支持

有关问题、问题或贡献,请参阅 文档 或者制造一个问题。

版本与发布记录

@tap-payments/os-micro-frontend-shared 共发布 2,672 个版本,首次发布于 2025/05/21;过去 12 个月发布了 1384 个版本。

版本发布日期距今
0.3.265latest2026/11/02今天
0.3.264-test.17936231192026/11/02今天
0.3.264-test.17936202472026/11/02今天
0.3.189-payout-v1-node24-axios2026/11/021 天前
0.3.264-test.17936096942026/11/021 天前
0.3.264-test.17935486842026/11/021 天前

其他发布通道:alpha → 0.0.173-alpha-15,production-wallet-latest → 0.1.476-production-wallet-latest,production-relic-3-6-2026 → 0.1.420-production-billing-latest,production-acceptance-authentication-latest → 0.1.420-production-acceptance-authentication-latest,production-payout-latest → 0.1.420-production-payout-latest,acceptance → 0.2.28-acceptance-v1。

关于 @tap-payments/os-micro-frontend-shared 的常见问题

@tap-payments/os-micro-frontend-shared 是什么?

Tap Payments微前端的共享组件和实用程序

如何安装 @tap-payments/os-micro-frontend-shared?

在项目目录运行 npm install @tap-payments/os-micro-frontend-shared,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18)、i18next(^22)、react-dom(^18)、@mui/material(^5)、framer-motion(^10)、react-i18next(^12)、@emotion/react(^11)、@emotion/styled(^11)、react-router-dom(^7.7.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@tap-payments/os-micro-frontend-shared 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@tap-payments/os-micro-frontend-shared 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@tap-payments/os-micro-frontend-shared 可以商用吗?

@tap-payments/os-micro-frontend-shared 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@tap-payments/os-micro-frontend-shared 还在维护吗?

最新版本 0.3.265 发布于 2026/11/02(今天);至今共发布 2672 个版本,其中过去 12 个月发布了 1384 个;首次发布于 2025/05/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。