@ferrlabs/ui-foundation

中文文档
5.8.0发布于 2026/11/11MIT OR Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 7851

框架-不可知 FerrLabs 设计基础: SVG 图标,基础 CSS + 字体, Tailwind 预设符号. 由@ferrlabs/ui-ng和Astro网站直接使用.

中文使用文档
文档目录7 节
  1. 这里面是什么
  2. 使用量
  3. 反应应用程序
  4. 天体站点
  5. 半径符号
  6. 旧套件的迁移
  7. 许可证

@ferrlabs/ ui- foundation (英语)

框架-不可知FerrLabs设计基础. 捆绑在一起,什么是 原为三个独立的包件(@ferrlabs/ui-icons, (中文(简体) ), @ferrlabs/styles, (中文(简体) ), @ferrlabs/ui-tailwind所以消费者安装一个 包而不是三个。 在UI#105下被跟踪.

这里面是什么

子路径什麽用于
@ferrlabs/ui-foundation/iconsSVG 图标设定为原始字符串( Luide- inspirted strike 图标)反应 + Astro
@ferrlabs/ui-foundation/styles/global.css基础样式表 — 字体 + Tailwind 导入 + 品牌标志每个应用程序 global.css
@ferrlabs/ui-foundation/styles/tokens.css品牌颜色 + 印刷符号(通过 @theme(中文(简体) )应用程序/网站

使用量

反应应用程序

import { icons, type IconName } from '@ferrlabs/ui-foundation/icons';
/* app/src/index.css */
@import '@ferrlabs/ui-foundation/styles/global.css';

天体站点

---
import { icons } from '@ferrlabs/ui-foundation/icons';
---
<div set:html={icons.shield} />
/* site/src/styles/global.css */
@import '@ferrlabs/ui-foundation/styles/global.css';

半径符号

脚本数值尾风工具使用
--radius-control四进制rounded-control按钮、输入、选择、搜索、标签、小芯片
--radius-card8个pxrounded-card卡片、菜单、弹出器、铁道物品
--radius-modal12px 时速rounded-modal模块、切换面板、大表面
--radius-full999px (英语)rounded-full切换、外观、徽章、状态点

.btn-primary 财务报告和审定财务报表 .btn-ghost 使用情况 --radius-control。 。 。 .

旧套件的迁移

旧的套件(@ferrlabs/ui-icons, (中文(简体) ), @ferrlabs/styles, (中文(简体) ), @ferrlabs/ui-tailwind继续作为再出口贝壳在 过渡窗口 — 以您自己的速度更改导入 。 新消费者 应瞄准 @ferrlabs/ui-foundation 直接说.

许可证

根据其中任何一项颁发的许可证 阿帕奇 - 2.0 或者说 麻省理工学院随便你.

Fraunces和DM Mono字体不在本许可范围内. 他们被拉进来了 @fontsource/fraunces 财务报告和审定财务报表 @fontsource/dm-mono 根据SIL Open Font License 1.1 的附属关系和保留,其中每个软件包的文本载运.

版本与发布记录

@ferrlabs/ui-foundation 共发布 5 个版本,首次发布于 2026/09/27;过去 12 个月发布了 5 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
5.8.0latest2026/11/113 天前
5.7.02026/11/113 天前
5.6.02026/11/095 天前
5.5.02026/09/301 个月前
5.4.02026/09/271 个月前

关于 @ferrlabs/ui-foundation 的常见问题

@ferrlabs/ui-foundation 是什么?

框架-不可知 FerrLabs 设计基础: SVG 图标,基础 CSS + 字体, Tailwind 预设符号. 由@ferrlabs/ui-ng和Astro网站直接使用.

如何安装 @ferrlabs/ui-foundation?

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

@ferrlabs/ui-foundation 支持 TypeScript 吗?

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

@ferrlabs/ui-foundation 支持 ESM 还是 CommonJS?

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

@ferrlabs/ui-foundation 可以商用吗?

@ferrlabs/ui-foundation 使用 MIT OR Apache-2.0 许可。可在 MIT、Apache-2.0 中任选其一遵守。选择 MIT 时,宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ferrlabs/ui-foundation 的下载量有多少?

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

@ferrlabs/ui-foundation 还在维护吗?

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