@sckyzo/cosmos-charts

中文文档
0.6.0发布于 2026/11/02MITTypeScriptESM + CJS构建来源已验证

Cosmos设计系统的React图表组件-可主题的Recharts包装器(条形图、线形图、区域图、甜甜圈图、径向量规、火花线、树状图、实时图、热图、雷达、散点图、气泡图、框图、范围条、混合图),遵循Cosmos主题和重点。

中文使用文档
文档目录4 节
  1. 安装
  2. 使用
  3. 文档
  4. 许可证

@sckyzo / cosmos-charts

npm

宇宙图表:自以为是的图表包装主题为宇宙设计系统,绘制与 Recharts. 放在专用的包装里,这样 @sckyzo/cosmos-react 不呈现图表的消费者不会提供图表库。

每个图表都是它自己的一个模块,并且包声明没有副作用,所以捆绑商发货 您导入的图表将其他的排除在外。

安装

npm install @sckyzo/cosmos-charts
npm install react react-dom   # peers, react 19+

三个Cosmos包共享一个版本号:安装每个包的相同版本。图表 的CSS变量读取它们的颜色 @sckyzo/cosmos-theme,所以他们遵循它的主题和 口音;如果没有主题CSS,它们会退回到内置调色板。要设置主题,请参见 开始. 几 图表带有Tailwind 4类,所以在CSS文件中也指向这个包 导入它,在 @source 线 @sckyzo/cosmos-react:

@source '../node_modules/@sckyzo/cosmos-charts/dist/**/*.{js,cjs}';

使用

import { LineAreaChart } from '@sckyzo/cosmos-charts';

<LineAreaChart
  series={[{ name: 'CPU', data: [12, 19, 23, 31, 22, 18, 25] }]}
  categories={['00h', '04h', '08h', '12h', '16h', '20h', '24h']}
/>;

文档

  • 图表指南:颜色如何跟随主题,每个图表的道具 共享,以及每种图表类型。
  • 故事书每一张带有 它的故事。

许可证

麻省理工学院,看到 许可证.

这些图表是用 Recharts (MIT),它吸收了 d3 (ISC)和bsd -3条款 d3-ease)。 WorldMap 也使用 d3-geo (ISC)和 topojson-client (ISC)。他们的许可证适用于他们发布的代码。 d3-geo 只发布ES模块,所以CommonJS构建将其包含在内部 WorldMap.cjs,与 d3-array 和 internmap 它拉; THIRD_PARTY_NOTICES.md 持有他们的执照。

版本与发布记录

@sckyzo/cosmos-charts 共发布 10 个版本,首次发布于 2026/05/21;过去 12 个月发布了 10 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.6.0latest2026/11/021 天前
0.5.02026/11/012 天前
0.4.12026/11/012 天前
0.4.02026/10/313 天前
0.3.12026/10/313 天前
0.3.02026/10/277 天前

关于 @sckyzo/cosmos-charts 的常见问题

@sckyzo/cosmos-charts 是什么?

Cosmos设计系统的React图表组件-可主题的Recharts包装器(条形图、线形图、区域图、甜甜圈图、径向量规、火花线、树状图、实时图、热图、雷达、散点图、气泡图、框图、范围条、混合图),遵循Cosmos主题和重点。

如何安装 @sckyzo/cosmos-charts?

在项目目录运行 npm install @sckyzo/cosmos-charts,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.0.0)、react-dom(^19.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@sckyzo/cosmos-charts 支持 TypeScript 吗?

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

@sckyzo/cosmos-charts 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@sckyzo/cosmos-charts 可以商用吗?

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

@sckyzo/cosmos-charts 还在维护吗?

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