# @ggts-sh/core 中文文档

规范地址：https://npmcn.com/package/%40ggts-sh/core/

版本：0\.48\.3
npm 元数据更新时间：2026-11-05T23:48:17.192Z
中文译文更新时间：2026-11-16T07:33:04.317Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：10.5 MB，2784 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-09-08T13:03:49.106Z
- 最新版本发布：2026-11-05T23:48:16.861Z
- 近 30 天下载量：9197（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

ggts核心:框架-可知语法-图文管线,尺度稳定性,布局,和纯SVG-string渲染器.

## 安装

```sh
npm install @ggts-sh/core
```

也可以使用：`pnpm add @ggts-sh/core`、`yarn add @ggts-sh/core`、`bun add @ggts-sh/core`

## README

# @ggts-sh/ 调值

[![codecov](https://codecov.io/gh/ggts-sh/ggts/branch/main/graph/badge.svg?component=packages-core)](https://app.codecov.io/gh/ggts-sh/ggts/tree/main/packages%2Fcore)

语法管道(统计、位置、方面、尺度、布局)和纯 SVG-字符串 变形器。 主条目没有DOM——节点,边缘跑道,工人. 风帆和 命中试验在地下 `@ggts-sh/core/dom`. 预1.0.

```sh
bun add @ggts-sh/core     # or: npm install @ggts-sh/core
```

用于服务器,CLI和代理渲染. 使用 Svelte 应用程序 [`@ggts-sh/svelte`](https://www.npmjs.com/package/@ggts-sh/svelte)。 。 。 .

## 快速实例

作者与构建者来自 `@ggts-sh/spec`,在此渲染:

```ts
import { registerAll, renderToSVGString, runPipeline } from "@ggts-sh/core";
import { aes, gg } from "@ggts-sh/spec";

// The barrel is side-effect-free: register the grammar explicitly (or import
// "@ggts-sh/core/render" for identity charts only).
registerAll();

const spec = gg(
  [
    { year: "1835", value: 12 },
    { year: "2026", value: 31 },
  ],
  aes({ x: "year", y: "value" }),
)
  .geomLine()
  .spec();

const svg = renderToSVGString(spec, { width: 640, height: 400 });

const model = runPipeline(spec, { width: 640, height: 400 });
// model.scene, model.scaleDecisions, model.guidePlans,
// model.advisories, model.warnings, model.candidates
```

对于最小的点状无头包,选择一个相克家族:

```ts
import { renderToSVGString } from "@ggts-sh/core/headless";
import { registerBasicPoints } from "@ggts-sh/core/headless/register";

registerBasicPoints();
```

调色也可以保持无目录: 调用 `registerDefaultOrdinalColor()` 用于内置调色板或显式 `range`调用 `registerOrdinalColor()` 而不是当光谱选择一个命名的绝对, ColorBrewer, 顺序, 或 克拉梅里计划.

赤色可移植Spec JSON工作方式相同——通道映射使用 `{ field: "col" }`,而不是赤线:

```ts
import { renderToSVGString } from "@ggts-sh/core";

const svg = renderToSVGString(
  {
    data: {
      values: [
        { year: "1835", value: 12 },
        { year: "2026", value: 31 },
      ],
    },
    layers: [
      {
        geom: "line",
        aes: { x: { field: "year" }, y: { field: "value" } },
      },
    ],
  },
  { width: 640, height: 400 },
);
```

## 条目

| 导入 | 使用 |
| --- | --- |
| `@ggts-sh/core` | 完整的语法+时间+ SVG 字符串 |
| `@ggts-sh/core/render` | 精益身份图表面(自动注册基础) |
| `@ggts-sh/core/headless` | 无副作用无头管和SVG渲染器 |
| `@ggts-sh/core/headless/register` | 树木可移动基本地理学/统计家庭登记 |
| `@ggts-sh/core/data` | 包含任何框架的教学数据集 |
| `@ggts-sh/core/dom` | 浏览器画布 + 点击索引 |
| `@ggts-sh/core/temporal` | 时间多填充条目 |

CLI 不将此软件包安装为库 : [`ggts render`](https://www.npmjs.com/package/@ggts-sh/cli) (同样的管道, JSONL 诊断在stderr.

光谱验证通过 [`@ggts-sh/spec`](https://www.npmjs.com/package/@ggts-sh/spec)。 。 。 . 文档 : [ggts.sh (英语)](https://ggts.sh/) • 恢复: [github.com/ggts-sh/ggts (英语)](https://github.com/ggts-sh/ggts)

[麻省理工学院](https://github.com/ggts-sh/ggts/blob/main/LICENSE) 利亚姆·奥德

## 常见问题

### @ggts-sh/core 是什么？

ggts核心:框架-可知语法-图文管线,尺度稳定性,布局,和纯SVG-string渲染器\.

### 如何安装 @ggts-sh/core？

在项目目录运行 npm install @ggts-sh/core，或使用 pnpm add / yarn add / bun add。

### @ggts-sh/core 支持 TypeScript 吗？

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

### @ggts-sh/core 支持 ESM 还是 CommonJS？

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

### @ggts-sh/core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ggts-sh/core 可以商用吗？

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

### @ggts-sh/core 的下载量有多少？

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

### @ggts-sh/core 还在维护吗？

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

