feat(create-tsdown): migrate from Gugustinette/create-tsdown (#535)

Author: sxzz

docs/guide/getting-started.md

@@ -64,7 +64,7 @@ bun add -D typescript
 
 ### Starter Templates {#starter-templates}
 
-To get started even faster, you can use the [create-tsdown](https://github.com/gugustinette/create-tsdown) CLI, which provides a set of starter templates for building pure TypeScript libraries, as well as frontend libraries like React and Vue.
+To get started even faster, you can use the [create-tsdown](https://github.com/rolldown/tsdown/tree/main/packages/create-tsdown) CLI, which provides a set of starter templates for building pure TypeScript libraries, as well as frontend libraries like React and Vue.
 
 ::: code-group
 

docs/zh-CN/guide/getting-started.md

@@ -64,7 +64,7 @@ bun add -D typescript
 
 ### 起步模板 {#starter-templates}
 
-为了更快速地开始，您可以使用 [create-tsdown](https://github.com/gugustinette/create-tsdown) CLI，它提供了一系列起步模板，适用于构建纯 TypeScript 库以及如 React、Vue 等前端库。
+为了更快速地开始，您可以使用 [create-tsdown](https://github.com/rolldown/tsdown/tree/main/packages/create-tsdown) CLI，它提供了一系列起步模板，适用于构建纯 TypeScript 库以及如 React、Vue 等前端库。
 
 ::: code-group
 

eslint.config.js

@@ -4,7 +4,7 @@ export default sxzz({
   pnpm: true,
 })
   .append({
-    files: ['examples/**'],
+    files: ['templates/**'],
     rules: {
       'pnpm/json-enforce-catalog': 'off',
     },

examples/simple/package.json

@@ -53,7 +53,7 @@
     "test": "vitest",
     "typecheck": "tsc --noEmit",
     "format": "prettier --cache --write .",
-    "release": "bumpp",
+    "release": "bumpp -r",
     "prepublishOnly": "pnpm run build",
     "docs:dev": "pnpm -C docs run dev",
     "docs:build": "pnpm -C docs run build",

examples/simple/src/index.ts

@@ -0,0 +1,53 @@
+{
+  "name": "create-tsdown",
+  "version": "0.0.3",
+  "description": "Create a new tsdown project",
+  "type": "module",
+  "license": "MIT",
+  "homepage": "https://github.com/rolldown/tsdown/tree/main/packages/create#readme",
+  "bugs": {
+    "url": "https://github.com/rolldown/tsdown/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rolldown/tsdown.git",
+    "directory": "packages/create-tsdown"
+  },
+  "author": "Kevin Deng <sxzz@sxzz.moe>",
+  "funding": "https://github.com/sponsors/sxzz",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./run": "./dist/run.mjs",
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*",
+        "./*"
+      ]
+    }
+  },
+  "bin": {
+    "create-tsdown": "./dist/run.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {},
+  "dependencies": {
+    "@clack/prompts": "catalog:prod",
+    "cac": "catalog:prod",
+    "giget": "catalog:prod",
+    "package-manager-detector": "catalog:prod"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  }
+}

examples/simple/tsdown.config.ts

@@ -0,0 +1,31 @@
+import process from 'node:process'
+import { log } from '@clack/prompts'
+import { cac } from 'cac'
+import { version } from '../package.json'
+import { create, type Options } from './index'
+
+const cli = cac('create-tsdown')
+cli.help().version(version)
+
+cli
+  .command('[path]', 'Create a tsdown project', {
+    ignoreOptionDefaultValue: true,
+    allowUnknownOptions: true,
+  })
+  .option(
+    '-t, --template <template>',
+    'Available templates: default, minimal, vue, react, solid',
+    { default: 'default' },
+  )
+  .action((path: string | undefined, options: Options) => create(path, options))
+
+export async function runCLI(): Promise<void> {
+  cli.parse(process.argv, { run: false })
+
+  try {
+    await cli.runMatchedCommand()
+  } catch (error) {
+    log.error(String(error))
+    process.exit(1)
+  }
+}

package.json

@@ -0,0 +1,105 @@
+import process from 'node:process'
+import { styleText } from 'node:util'
+import {
+  cancel,
+  intro,
+  isCancel,
+  outro,
+  select,
+  spinner,
+  text,
+} from '@clack/prompts'
+import { downloadTemplate } from 'giget'
+import { getUserAgent } from 'package-manager-detector'
+
+export interface Options {
+  template?: 'default' | 'minimal' | 'vue' | 'react' | 'solid'
+  path?: string
+}
+
+export type ResolvedOptions = Required<Options>
+
+/**
+ * Create a tsdown project.
+ */
+export async function create(
+  path: string | undefined,
+  options: Options,
+): Promise<void> {
+  intro(`Creating a tsdown project...`)
+
+  const resolved = await resolveOptions({ ...options, path })
+
+  const s = spinner()
+  s.start('Cloning the template...')
+
+  await downloadTemplate(`gh:sxzz/tsdown-templates/${resolved.template}`, {
+    dir: resolved.path,
+  })
+
+  s.stop('Template cloned')
+
+  const pm = getUserAgent() || 'npm'
+  outro(
+    `Done! Now run:\n` +
+      `  ${styleText('green', `cd ${resolved.path}`)}\n` +
+      `  ${styleText('green', `${pm} install`)}\n` +
+      `  ${styleText('green', `${pm} run build`)}\n\n` +
+      `For more information, visit: ${styleText('underline', `https://tsdown.dev/`)}`,
+  )
+}
+
+/**
+ * Resolve the user options and configs
+ * @param options The user options
+ * @returns The resolved options
+ */
+export async function resolveOptions(
+  options: Options,
+): Promise<ResolvedOptions> {
+  let path: Options['path'] | symbol = options.path
+
+  if (!path) {
+    const defaultPath = './my-tsdown-package'
+    path =
+      (await text({
+        message: 'What is the name of your package?',
+        placeholder: defaultPath,
+      })) || defaultPath
+    if (isCancel(path)) {
+      cancel('Operation cancelled.')
+      process.exit(1)
+    }
+  }
+
+  let template: Options['template'] | symbol = options.template
+  if (template) {
+    if (!['default', 'minimal', 'vue', 'react', 'solid'].includes(template)) {
+      throw new Error(
+        `Invalid template "${template}". Available templates: default, vue, react, solid`,
+      )
+    }
+  } else {
+    template = await select({
+      message: 'Which template do you want to use?',
+      options: [
+        { value: 'default', label: 'Default' },
+        { value: 'minimal', label: 'Minimal' },
+        { value: 'vue', label: 'Vue' },
+        { value: 'react', label: 'React' },
+        { value: 'solid', label: 'Solid' },
+      ],
+      initialValue: 'default',
+    })
+
+    if (isCancel(template)) {
+      cancel('Operation cancelled.')
+      process.exit(1)
+    }
+  }
+
+  return {
+    path,
+    template,
+  } satisfies ResolvedOptions
+}