# @forgedevstack/bear 中文文档

规范地址：https://npmcn.com/package/%40forgedevstack/bear/

版本：1\.3\.7
npm 元数据更新时间：2026-11-05T08:45:27.039Z
中文译文更新时间：2026-11-15T07:43:50.715Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40forgedevstack/bear
原文对照：https://npmcn.com/package/%40forgedevstack/bear/?lang=original
项目主页：https://bearui.com/
源码仓库：https://github.com/yaghobieh/bear

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.4 MB，2275 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \>=18\.0\.0，react-dom \>=18\.0\.0
- 首次发布：2026-01-24T12:09:33.729Z
- 最新版本发布：2026-11-05T08:45:26.741Z
- 近 30 天下载量：2859（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

强而可靠的反应UI组件. AeroCraft动力,零配置需要. 福盖斯塔克的保护力量.

## 安装

```sh
npm install @forgedevstack/bear
```

也可以使用：`pnpm add @forgedevstack/bear`、`yarn add @forgedevstack/bear`、`bun add @forgedevstack/bear`

## README

# @forgedevstack/ bear (英语)

反应组件,一个主题提供者,和AeroCraft标志. 本存储库中1.3.6版本. 出版发生在此发行被合并到主版时.

作者:约翰·亚高比耶. 文档 : [bruui.com (英语)](https://bearui.com/)软件包 : [@forgedevstack/ bear (英语)](https://www.npmjs.com/package/@forgedevstack/bear)。 。 。 .

## 安装

```bash
npm install @forgedevstack/bear
```

安装是组件集和主题 。 图标是一个单独的包. 图表今天仍在核心建筑内部发行,它们也有一个专用的软件包条目,以便您可以自行导入.

```bash
npm install @forgedevstack/bear-grid
npm install @forgedevstack/bear-blocks
npm install @forgedevstack/bear-icons
npm install @forgedevstack/bear-x-charts
npm install @forgedevstack/bear-x-ai
npm install @forgedevstack/bear-x-code
npm install @forgedevstack/bear-map
npm install @forgedevstack/kanban
npm install @forgedevstack/calendar
```

`@forgedevstack/bear-icons` 财务报告和审定财务报表 `@forgedevstack/calendar` 时间为npm(`calendar` 表示 1. 0.1 ; 1.0.2 , 事件日历在此 repo 中。 图表,AI,代码,地图,和kanban还没有在npm上.

保留媒体播放 [火炬](https://www.npmjs.com/package/@forgedevstack/torch)。丰富的文本编辑器将保留 [墨迹](https://www.npmjs.com/package/@forgedevstack/ink)。 。 。 .

## 套装大小

大小随每次发布而变化。 打开您要添加的软件包包恐惧症 :

-   [核心](https://bundlephobia.com/package/@forgedevstack/bear)
-   [图标](https://bundlephobia.com/package/@forgedevstack/bear-icons)
-   [图表](https://bundlephobia.com/package/@forgedevstack/bear-x-charts)
-   [大赦国际](https://bundlephobia.com/package/@forgedevstack/bear-x-ai)
-   [代码](https://bundlephobia.com/package/@forgedevstack/bear-x-code)
-   [地图](https://bundlephobia.com/package/@forgedevstack/bear-map)
-   [关班](https://bundlephobia.com/package/@forgedevstack/kanban)
-   [日历](https://bundlephobia.com/package/@forgedevstack/calendar)

门户网站产品页面和库页面的链接与按钮相同.

## 提供者

导入样式表一次, 然后将树包入 .

```tsx
import '@forgedevstack/bear/styles.css';
import { BearProvider, Button, Card, CardBody, Typography } from '@forgedevstack/bear';

export function App() {
  return (
    <BearProvider
      colorScheme="system"
      theme={{ colors: { primary: '#ec4899' } }}
    >
      <Card>
        <CardBody>
          <Typography variant="h4">Bear</Typography>
          <Button variant="primary">Save</Button>
        </CardBody>
      </Card>
    </BearProvider>
  );
}
```

`colorScheme` 实值 `light`, (中文(简体) ), `dark`,或 `system`。暗模式跟随 `.dark` 课从提供者.

## 图表

```tsx
import { BarChart } from '@forgedevstack/bear-x-charts';
import '@forgedevstack/bear/styles.css';

<BarChart
  data={[
    { label: 'Jan', value: 30 },
    { label: 'Feb', value: 45 },
  ]}
  showLabels
/>
```

此 repo 中的图视图 : `bar`, (中文(简体) ), `line`, (中文(简体) ), `area`, (中文(简体) ), `pie`, (中文(简体) ), `donut`, (中文(简体) ), `radar`, (中文(简体) ), `funnel`, (中文(简体) ), `stacked`馅饼也 `full`, (中文(简体) ), `half`,以及 `rose`. Sparkline, Gauge, Ring Progress, Heatmap, 和 时光线 图表坐在旁边 动议是 `grow`, (中文(简体) ), `fade`, (中文(简体) ), `scale`,或 `none`,以及 `animated` 是一个布尔。 这些是零依赖性SVG图表. 它们不是 Chart.js 插件 .

## 图标

```tsx
import { SearchIcon } from '@forgedevstack/bear-icons';

<SearchIcon size={24} />
```

## 日历

Per of Bear. 1.0.2 添加了活动月和资源时间表. 弹出和过滤器使用"熊".

```tsx
import { EventCalendar, EventTimeline } from '@forgedevstack/calendar';
import '@forgedevstack/calendar/styles.css';
import '@forgedevstack/bear/styles.css';

<EventCalendar events={events} mode="dark" />
<EventTimeline events={events} />
```

## 地图和坎班

```tsx
import { Map } from '@forgedevstack/bear-map';
import { Kanban } from '@forgedevstack/kanban';
```

虎克会留在核心。 约会选手留在核心.

## 国 际

Forge CLI是今天存在的安装器.

```bash
npx create-forge my-app
```

当您选择小熊时, CLI 打印出 Loto 吉祥物, 并询问哪些库包括:图标、图表、AI、代码、地图、 kanban 和日历 。 后以出家相求为主色相. `--yes` 选择小熊和那些库.

在现有应用程序中添加一个软件包 :

```bash
forge add bear
forge add bear-icons
forge add calendar
```

`forge add bear` 问同一个图书馆问题。 从 npm 安装图标和日历。 图表、AI、代码、地图和kanban记录在以下注释中: `src/main.tsx` 直到这些软件包发布,所以安装不会在缺失软件包上失败.

`npx @forgedevstack/bear-cli` 是只为熊保留的二进制名称。 此二进制尚未发布, 因此这些命令尚未运行 .

## 1.3.6 添加的内容

-   `bear_flutter` 内 `packages/bear_flutter`。在"熊"符号上免费的部件.
-   `@forgedevstack/bear-grid`. 平分、分组和Excel导出。 水印有牌照钥匙 专业是每年9美元。 数据表保持免费.
-   `@forgedevstack/bear-blocks`免费 `DashboardBlock`。 。 。 .
-   门户定价 故事书条目 和沙盒食谱.
-   `@forgedevstack/bear-icons` 在主页和图书馆列表中列出.

## 1.3.5 添加的内容

-   选项包 : `@forgedevstack/bear-x-charts`, (中文(简体) ), `@forgedevstack/bear-x-ai`, (中文(简体) ), `@forgedevstack/bear-x-code`, (中文(简体) ), `@forgedevstack/bear-map`, (中文(简体) ), `@forgedevstack/kanban`。 。 。 .
-   将公开和密切的动议重叠在小组上: `none`, (中文(简体) ), `fade`, (中文(简体) ), `slide-down`, (中文(简体) ), `scale`, (中文(简体) ), `fold`, (中文(简体) ), `elastic`, (中文(简体) ), `reveal`, (中文(简体) ), `expand`默认为 `fold`。 。 。 .
-   每个库的门户产品页面,并带有"Bundlephool"按钮.
-   `@forgedevstack/calendar` 1.0.2:事件日历,资源过滤器,侧编辑器,以及时间表.

## 构成部分

| 区域 | 实例 |
| --- | --- |
| 行动 | 按钮、按钮组、 切换组、 FAB、 分块按钮 |
| 表单 | 输入、 选择、 复选框、 收音机、 切换、 滑动、 日期选择、 时间选择 |
| 重叠 | Modal, Drawer, 提醒Dialog, Popover, 工具提示, 菜单, 命令Palette |
| 反馈 | 警报、土司、斯宾纳、进步、斯凯通、徽章 |
| 版式 | 集装箱、Flex、网格、纸张、分块、分块 |
| 数据 | 数据表、图表、日历、时间表 |

## 脚本

```bash
npm run build
cd portal && npm run test:e2e:smoke
```

## 许可证

麻省理工学院. 约翰·雅格霍比耶和福格斯塔克队.

## 常见问题

### @forgedevstack/bear 是什么？

强而可靠的反应UI组件\. AeroCraft动力,零配置需要\. 福盖斯塔克的保护力量\.

### 如何安装 @forgedevstack/bear？

在项目目录运行 npm install @forgedevstack/bear，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18\.0\.0）、react-dom（\>=18\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @forgedevstack/bear 支持 TypeScript 吗？

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

### @forgedevstack/bear 支持 ESM 还是 CommonJS？

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

### @forgedevstack/bear 可以商用吗？

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

### @forgedevstack/bear 的下载量有多少？

根据 npm 官方下载统计，@forgedevstack/bear 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,859 次，日均约 95 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @forgedevstack/bear 还在维护吗？

最新版本 1\.3\.7 发布于 2026/11/05（10 天前）；至今共发布 35 个版本，其中过去 12 个月发布了 35 个；首次发布于 2026/01/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。