# @a-little-world/little-world-design-system-core 中文文档

规范地址：https://npmcn.com/package/%40a-little-world/little-world-design-system-core/

版本：1\.18\.0
npm 元数据更新时间：2026-10-16T10:18:32.104Z
中文译文更新时间：2026-11-08T09:39:09.569Z
软件包许可：LGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40a-little-world/little-world-design-system-core
原文对照：https://npmcn.com/package/%40a-little-world/little-world-design-system-core/?lang=original
项目主页：https://github.com/a-little-world/little-world-design-system#readme
源码仓库：https://github.com/a-little-world/little-world-design-system

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

- 包体积（解压后）：4.4 MB，1289 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：4 个
- peer 依赖：react ^19\.0\.0，react-dom ^19\.0\.0
- 首次发布：2025-12-30T18:40:05.598Z
- 最新版本发布：2026-10-16T10:18:31.524Z
- 近 30 天下载量：1828（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

小世界设计系统的核心设计标志和公用事业

## 安装

```sh
npm install @a-little-world/little-world-design-system-core
```

也可以使用：`pnpm add @a-little-world/little-world-design-system-core`、`yarn add @a-little-world/little-world-design-system-core`、`bun add @a-little-world/little-world-design-system-core`

## README

# @ a- little-world/ little-world-设计系统核心

小世界设计系统的核心设计标志,公用事业,以及共享类型.

## 安装

```bash
pnpm add @a-little-world/little-world-design-system-core
```

## 使用量

```tsx
import { colors, spacing, typography } from '@a-little-world/little-world-design-system-core';

// Use design tokens
const styles = {
  backgroundColor: colors.primary,
  padding: spacing.medium,
  fontSize: typography.body.fontSize,
};
```

## 设计托肯斯

核心一揽子计划提供:

-   **颜色** - 初级、二级和语义色彩调色板
-   **类型** - 字体家庭、大小、重量和行高
-   **间距** - 一致的间隔尺度
-   **断点** - 响应性设计断点
-   **阴影** - 高度和阴影定义
-   **边框半径** - 一致的边界半径值

## 字体

字体二进制 `src/fonts/` 从 `src/fonts/index.ts`类型脚本编译 **没有** 复制 `.ttf` 文件输入 `dist/`;一个单独的复制步骤运行在建筑的末尾,因此所发布的包包括所编集的JS旁边的字体文件.

### 建设管道

这个 `build` 脚本运行, 顺序 :

1.  `clean` — 删除 `dist/` 生成 `.d.ts` 文件在 `src/`
2.  `preprocess-svgs` ——处理 SVG 资产(与字体无关)
3.  `build:esm` 编号 : `build:cjs` ——编译类型脚本到 `dist/esm` 财务报告和审定财务报表 `dist/cjs` (包括 `fonts/index.js`,但不包括 `.ttf` 二进制)
4.  `copy-fonts` ——将字体文件复制到两个输出树上

`copy-fonts` 用途 [`cpy-cli`](https://github.com/sindresorhus/cpy-cli) 与 `--flat`,因此每个文件直接在 `dist/esm/fonts/` 财务报告和审定财务报表 `dist/cjs/fonts/` (没有嵌入源路径):

```bash
copy-fonts:esm  → dist/esm/fonts/
copy-fonts:cjs  → dist/cjs/fonts/
```

已复制文件( 必须匹配文件名 ) `src/fonts/`:

-   `SignikaNegative-Variable.ttf`
-   `SignikaNegative-Bold.ttf`
-   `DMSans-Variable.ttf`

如果添加或重命名字体文件,则更新 `copy-fonts:esm` 财务报告和审定财务报表 `copy-fonts:cjs` 内 `package.json` 和路径 `src/fonts/index.ts`。 。 。 .

### 运行时输出( E)`src/fonts/index.ts`(中文(简体) )

字体模块从软件包条目中再导出(`export * from './fonts'`) (中文(简体) ).

| 导出 | 目的 |
| --- | --- |
| `fontPaths` | 相对路径到 `.ttf` 文件在 `./fonts/` ——对于从已发布的包中装入字体的网络消费者(例如. `@font-face` `url()`) (中文(简体) ). |
| `fontFamilies` | CSS / 反应原生字体姓氏( R)`Signika Negative`, (中文(简体) ), `DM Sans`(见a/c.5/49/70,附件). |
| `fontFiles` | 姓氏分布图 来源 `require('./….ttf')` 原生反应( N)`expo-font` 编号 : `Font.loadAsync`) (中文(简体) ). 内建 `try`编号 :`catch` 故网络捆绑器不能 `require` 二进制不会失败;在网络上, `fontFiles` 留下来 `undefined`。 。 。 . |

本地应用软件应注意使用:

```tsx
import { fontFiles } from '@a-little-world/little-world-design-system-core';

if (fontFiles) {
  await Font.loadAsync(fontFiles);
}
```

## 地方发展

### QQ 重要: 从根来构建

**总是从单列波的根来构建和发布,从不从单个包目录来构建和发布.**

✅ **正确( 从根) :**

```bash
pnpm build:core
pnpm --filter=@a-little-world/little-world-design-system-core publish
```

❌ **不正确( 从软件包目录) :**

```bash
cd packages/core
pnpm run build
pnpm publish  # This will break workspace dependencies!
```

### 大楼

```bash
# From root of monorepo
pnpm build:core

# Or from the core package directory
cd packages/core
pnpm run build
```

### 用原生软件包测试

运行本地测试时, 核心包会自动构建和测试 App :

```bash
# This will build both core and native packages
pnpm native:setup
```

### 发展 工作流量

1.  **进行修改** 设计标志或公用事业
2.  **构建核心** - 说吧 `pnpm build:core`
3.  **本地测试** - 说吧 `pnpm native:setup-and-start` (重建与试验)
4.  **网络测试** - 说吧 `pnpm storybook:web` (如果网络组件使用核心符号)

## 出版

### 自动释放(建议)

**理想的情况是,释放应自动化,并通过合并到回收品的主要分支来处理.**

见 [Root README 中的版本和发布部分](https://npmcn.com/package/README.md#versioning-and-releases) 以获取关于使用变换器自动发布进程的详细信息.

自动工作流程将:

-   检测软件包中的版本变化
-   发布到 GitHub 软件包注册
-   创建带有更改日志信息的 GitHub 发布
-   自动处理所有出版步骤

### 手动发布( Fallback)

如果需要手动发布( 不推荐):

```bash
# Ensure you're authenticated to GitHub Packages
pnpm login --registry=https://npm.pkg.github.com

# Build the package
pnpm build:core

# Publish from the core package directory
cd packages/core
pnpm publish --access restricted
```

**说明**:手工出版绕过自动更改日志生成和发行管理. 尽可能使用自动进程.

## 类型脚本

该套件包括所有设计符号和公用事业的TypeScript定义:

```tsx
import type { ColorToken, SpacingToken } from '@a-little-world/little-world-design-system-core';

// Type-safe usage
const color: ColorToken = 'primary'; // ✅ Valid
const invalidColor: ColorToken = 'invalid'; // ❌ TypeScript error
```

## 依赖关系

这个软件包有最小的依赖性来避免冲突:

-   `typescript` - 类型定义
-   无运行时间依赖关系(纯设计标志和公用事业)

## 常见问题

### @a-little-world/little-world-design-system-core 是什么？

小世界设计系统的核心设计标志和公用事业

### 如何安装 @a-little-world/little-world-design-system-core？

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

### @a-little-world/little-world-design-system-core 支持 TypeScript 吗？

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

### @a-little-world/little-world-design-system-core 支持 ESM 还是 CommonJS？

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

### @a-little-world/little-world-design-system-core 可以商用吗？

@a-little-world/little-world-design-system-core 使用 LGPL-3\.0-only 许可。弱 Copyleft：作为库被调用时通常不要求开源你自己的代码，但修改库本身需以 LGPL 开源；前端打包合并后的适用边界存在不同理解。以上为概括，不构成法律意见，请以许可原文为准。

### @a-little-world/little-world-design-system-core 的下载量有多少？

根据 npm 官方下载统计，@a-little-world/little-world-design-system-core 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,828 次，日均约 61 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @a-little-world/little-world-design-system-core 还在维护吗？

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