arch-tsdown

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

arch-tsdown is a TypeScript library starter (based on antfu/starter-ts) that uses tsdown for building. It provides a minimal, opinionated setup: ESM-only output, automatic

.d.ts

generation, pnpm, Vitest, ESLint, and optional npm Trusted Publisher for CI-based releases.

The skill is based on starter-ts (arch-tsdown source), generated at 2026-01-30.

Recommended practices:

Build pure ESM; enable
```
dts
```
and
```
exports
```
in tsdown config
Use npm Trusted Publisher for releases
Run publint (via tsdown’s
```
publint: true
```
) before publishing

arch-tsdown 是一个基于antfu/starter-ts的TypeScript库启动模板，使用tsdown进行构建。它提供了一个极简且带有预设配置的环境：仅ESM输出、自动生成

.d.ts

文件、pnpm包管理、Vitest测试、ESLint代码检查，以及可选的用于基于CI的发布的npm可信发布工具。

本模板基于starter-ts（arch-tsdown源码）生成，生成时间为2026-01-30。

推荐实践：

构建纯ESM库；在tsdown配置中启用
```
dts
```
和
```
exports
```
选项
使用npm可信发布工具进行版本发布
发布前运行publint（通过tsdown的
```
publint: true
```
配置）

Core References

核心参考文档

Topic	Description	Reference
Overview	Project purpose, structure, when to use	core-overview
tsdown Config	entry, dts, exports, publint	core-tsdown-config
Scripts & Release	build, dev, start, release, npm Trusted Publisher	core-scripts
Package Exports	dist output, types, exports, sideEffects	core-package-exports
pnpm Workspace	catalogs, version management, workspace	core-pnpm-workspace
Tooling	ESLint, TypeScript, Vitest config	core-tooling
Git Hooks	simple-git-hooks, lint-staged, pre-commit	core-git-hooks
CI	GitHub Actions — lint, typecheck, test matrix	core-ci
Release	Tag push, sxzz/workflows, npm Trusted Publisher	core-release
Testing	Vitest, vitest-package-exports, export snapshots	core-testing

主题	描述	参考链接
概览	项目用途、结构、适用场景	core-overview
tsdown配置	入口文件、dts生成、exports配置、publint	core-tsdown-config
脚本与发布	构建、开发、启动、发布、npm可信发布	core-scripts
包导出配置	构建输出、类型文件、exports配置、sideEffects	core-package-exports
pnpm工作区	目录管理、版本控制、工作区配置	core-pnpm-workspace
工具链	ESLint、TypeScript、Vitest配置	core-tooling
Git钩子	simple-git-hooks、lint-staged、提交前检查	core-git-hooks
CI配置	GitHub Actions — 代码检查、类型校验、测试矩阵	core-ci
发布流程	标签推送、sxzz/workflows、npm可信发布	core-release
测试	Vitest、vitest-package-exports、导出快照	core-testing

Best Practices

最佳实践

Topic	Description	Reference
tsdown & Package	ESM, dts, exports, tooling alignment	best-practices-tsdown

主题	描述	参考链接
tsdown与包配置	ESM、dts、exports、工具链对齐	best-practices-tsdown