@ggts-sh/svelte

中文文档
0.48.3发布于 2026/11/06MITTypeScriptES Module构建来源已验证近 30 天下载 4256

ggts:用于斯维尔特5的分层图形语法——ggplot2语义,JSON-序列可分谱,代理友好验证,和混合SVG/canvas渲染. ggts使CLI舰分别成为@ggts-sh/cli.

中文使用文档
文档目录5 节
  1. 示例
  2. 更小的捆绑:精细的输入
  3. 代理技能
  4. 移动旧代码
  5. 链接

@ggts-sh/ svelte (英语)

codecov

胶囊5个组件 再出口 @ggts-sh/spec 财务报告和审定财务报表 @ggts-sh/core。代理技能船分别作为 @ggts-sh/skill,则 ggts render CLI 作为 @ggts-sh/cli - 两者都安装在 每个沙盒里都有代理作者.

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

需要节点.js 22+和斯维尔特 5.33.1+. 导入捆绑数据示例 从 @ggts-sh/core/data,因此它安装了核心作为直接依赖. 内含数据的图表仅需 @ggts-sh/svelte。 。 。 .

示例

与只申报的儿童(主题、尺度、实验室、地理学)作曲。 别放 theme, (中文(简体) ), scales, (中文(简体) ), labs, (中文(简体) ), guides, (中文(简体) ), facet, (中文(简体) ), coord,或 legend 打开 <GGPlot> 这些道具在0.13.0被移除.

<script lang="ts">
  import {
    GeomPoint,
    GeomSmooth,
    GGPlot,
    Labs,
    ThemeMinimal,
  } from "@ggts-sh/svelte";
  import { kyotoSakura } from "@ggts-sh/core/data";
</script>

<GGPlot data={kyotoSakura} aes={{ x: "year", y: "bloomDoy" }}>
  <GeomSmooth method="loess" se={false} />
  <GeomPoint size={2} alpha={0.7} />
  <ThemeMinimal />
  <Labs
    title="Kyoto cherry blossom full-bloom dates, 812–2026"
    subtitle="Full bloom moved about ten days earlier after the industrial era"
    x="Year"
    y="Day of year"
  />
</GGPlot>

常规(ggplot2思维顺序):先标出分层,再标出分层/分层 / 层面,然后是主题/指南/实验室,然后是主机 <Inspect> 最后一个 语气 在画布、轴、传奇、文字和可获取的描述上可渲染出点 留在DOM内。 偏爱 <Inspect /> 财务报告和审定财务报表 <GuideLegend channel focus> 编号 : <GuideLegend channel filter> 用于交互,而不是图层 inspect, (中文(简体) ), legendFocus,或 legendFilter。 。 。 .

更小的捆绑:精细的输入

@ggts-sh/svelte 登记基本地理、统计、颜色和样式 缩放类型。 仅运出您的图表所使用的, 导入 从 @ggts-sh/svelte/lean 并启动时立即调用注册功能 :

<script lang="ts" module>
  import {
    registerBasicLines,
    registerBasicPoints,
    registerDefaultOrdinalColor,
  } from "@ggts-sh/svelte/lean";

  registerBasicPoints();
  registerBasicLines();
  registerDefaultOrdinalColor();
</script>

<script lang="ts">
  import { GeomLine, GeomPoint, GGPlot } from "@ggts-sh/svelte/lean";
</script>

对于有映射出颜色的点和行图,这节省了大约26 KB gzip. 如果一张图表需要一个没有注册的家庭, GGPlot 丢出错误 指定要调用的注册函数的名称。 一个从 @ggts-sh/svelte 在应用程序的任何地方 带来完整的基本注册.

代理技能

单独公布为 @ggts-sh/skill数字 : node_modules/@ggts-sh/skill/SKILL.md复制到您的代理技能中 目录为 ggts/ 并重印于版本的凸起相接相接的表面 这些 (0.27.0从本包中取出

Emit PortableSpec JSON, 运行 validate(),应用 fix.example 时间 path, (中文(简体) ), 重新验证,然后以 <GGPlot spec={…} />, (中文(简体) ), renderToSVGString,或 ggts render示马: 计划/v0.json。 。 。 .

移动旧代码

如果你还有0.13前的 手持语法道具的来源 <GGPlot>,则 代码重写给孩子 :

npm exec --package=@ggts-sh/svelte -- ggts-codemod src          # show what would change
npm exec --package=@ggts-sh/svelte -- ggts-codemod --write src  # apply

形状不会重写为 manual change required 链接 升级 指南从来没有半移民.

预1.0. 使用寿命和兼容性合同在文件网站上.

麻省理工学院 利亚姆·奥德

版本与发布记录

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

版本发布日期距今
0.48.3latest2026/11/0610 天前
0.48.22026/11/0610 天前
0.48.12026/11/0510 天前
0.48.02026/11/0511 天前
0.47.02026/11/0313 天前
0.46.02026/11/0313 天前

关于 @ggts-sh/svelte 的常见问题

@ggts-sh/svelte 是什么?

ggts:用于斯维尔特5的分层图形语法——ggplot2语义,JSON-序列可分谱,代理友好验证,和混合SVG/canvas渲染. ggts使CLI舰分别成为@ggts-sh/cli.

如何安装 @ggts-sh/svelte?

在项目目录运行 npm install @ggts-sh/svelte,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:svelte(^5.33.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 ggts-codemod,可以用 npx ggts-codemod 直接运行。

@ggts-sh/svelte 支持 TypeScript 吗?

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

@ggts-sh/svelte 支持 ESM 还是 CommonJS?

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

@ggts-sh/svelte 需要什么版本的 Node.js?

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

@ggts-sh/svelte 可以商用吗?

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

@ggts-sh/svelte 的下载量有多少?

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

@ggts-sh/svelte 还在维护吗?

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