@doyuli/create-lib 0.2.1

package/README.md

@@ -0,0 +1,9 @@
+### Usage
+
+```bash
+npx @doyuli/create-lib
+
+# or
+
+npm create @doyuli/lib
+```

package/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.mjs'

package/dist/index.mjs

@@ -0,0 +1,100 @@
+import * as path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { intro, outro } from "@clack/prompts";
+import { getCommand, getPackageManager, renderFile, renderTemplate, setupFeatures, setupProject, setupPrompts } from "@doyuli/kits-core";
+import pico from "picocolors";
+import * as fs from "node:fs";
+
+//#region src/constants.ts
+const DEFAULT_BANNER = "Template-Kits - 快速生成你的模板代码";
+const FEATURE_OPTIONS = [
+	{
+		value: "monorepo",
+		label: "Monorepo（pnpm workspace 多包管理）"
+	},
+	{
+		value: "simple-git-hooks",
+		label: "Simple Git Hooks（Git Commit 检查）"
+	},
+	{
+		value: "github-workflows",
+		label: "GitHub Workflows（CI/CD 自动化）"
+	}
+];
+
+//#endregion
+//#region src/helper.ts
+/**
+* Convert devDependencies to catalog: references and generate pnpm-workspace.yaml
+*/
+function renderMonorepoDeps(root) {
+	const pkgPath = path.join(root, "package.json");
+	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+	const devDeps = pkg.devDependencies ?? {};
+	const sortedEntries = Object.entries(devDeps).sort(([a], [b]) => a.localeCompare(b));
+	pkg.devDependencies = Object.fromEntries(sortedEntries.map(([k]) => [k, "catalog:"]));
+	renderFile(root, "package.json", `${JSON.stringify(pkg, null, 2)}\n`);
+	renderFile(root, "pnpm-workspace.yaml", [
+		"shellEmulator: true",
+		"trustPolicy: no-downgrade",
+		"",
+		"packages:",
+		"  - packages/*",
+		"",
+		"catalog:",
+		sortedEntries.map(([name, version]) => {
+			return `  ${name.includes("/") ? `'${name}'` : name}: ${version}`;
+		}).join("\n"),
+		""
+	].join("\n"));
+}
+
+//#endregion
+//#region src/index.ts
+(async function() {
+	const cwd = process.cwd();
+	const { positionals } = parseArgs({
+		strict: true,
+		allowPositionals: true
+	});
+	intro(pico.magenta(DEFAULT_BANNER));
+	const inputTargetDir = positionals[0];
+	const { result, targetDir } = await setupPrompts(inputTargetDir, [setupFeatures("features", { options: [...FEATURE_OPTIONS] })]);
+	const root = await setupProject(cwd, result, targetDir);
+	renderTemplates(root, result);
+	outro(getOutroMessage(root, cwd));
+})();
+function getOutroMessage(root, cwd) {
+	const manager = getPackageManager();
+	let message = `项目初始化完成，可执行以下命令：\n\n`;
+	if (root !== cwd) {
+		const cdProjectName = path.relative(cwd, root);
+		message += `   ${pico.bold(pico.green(`cd ${cdProjectName.includes(" ") ? `"${cdProjectName}"` : cdProjectName}`))}\n`;
+	}
+	message += `   ${pico.bold(pico.green(getCommand(manager, "install")))}\n`;
+	message += `   ${pico.bold(pico.green(getCommand(manager, "dev")))}\n`;
+	return message;
+}
+function renderTemplates(root, result) {
+	const { features } = result;
+	const needsMonorepo = features.includes("monorepo");
+	const needsGitHooks = features.includes("simple-git-hooks");
+	const needsWorkflows = features.includes("github-workflows");
+	const templateRoot = fileURLToPath(new URL("../template", import.meta.url));
+	const render = (templateName) => {
+		renderTemplate(path.resolve(templateRoot, templateName), root);
+	};
+	render("base");
+	render("eslint");
+	if (needsGitHooks) render("git-hooks");
+	if (needsWorkflows) render("github-workflows");
+	if (needsMonorepo) {
+		render("monorepo");
+		renderMonorepoDeps(root);
+	} else render("single-repo");
+}
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@doyuli/create-lib",
+  "type": "module",
+  "version": "0.2.1",
+  "description": "@doyuli/create-lib",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/doyuli/template-kits.git",
+    "directory": "packages/create-lib"
+  },
+  "keywords": [
+    "templates",
+    "create-lib"
+  ],
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "bin": {
+    "create-lib": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "template",
+    "template/**/settings.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "prepack": "pnpm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "catalog:",
+    "@doyuli/kits-core": "workspace:^",
+    "picocolors": "catalog:"
+  }
+}

package/template/base/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["vitest.explorer", "dbaeumer.vscode-eslint"]
+}

package/template/base/.vscode/settings.json

@@ -0,0 +1,50 @@
+{
+  // Disable the default formatter, use eslint instead
+  "prettier.enable": false,
+  "editor.formatOnSave": false,
+
+  // Auto fix
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.organizeImports": "never"
+  },
+
+  // Silent the stylistic rules in you IDE, but still auto fix them
+  "eslint.rules.customizations": [
+    { "rule": "style/*", "severity": "off", "fixable": true },
+    { "rule": "format/*", "severity": "off", "fixable": true },
+    { "rule": "*-indent", "severity": "off", "fixable": true },
+    { "rule": "*-spacing", "severity": "off", "fixable": true },
+    { "rule": "*-spaces", "severity": "off", "fixable": true },
+    { "rule": "*-order", "severity": "off", "fixable": true },
+    { "rule": "*-dangle", "severity": "off", "fixable": true },
+    { "rule": "*-newline", "severity": "off", "fixable": true },
+    { "rule": "*quotes", "severity": "off", "fixable": true },
+    { "rule": "*semi", "severity": "off", "fixable": true }
+  ],
+
+  // Enable eslint for all supported languages
+  "eslint.validate": [
+    "javascript",
+    "javascriptreact",
+    "typescript",
+    "typescriptreact",
+    "vue",
+    "html",
+    "markdown",
+    "json",
+    "jsonc",
+    "yaml",
+    "toml",
+    "xml",
+    "gql",
+    "graphql",
+    "astro",
+    "svelte",
+    "css",
+    "less",
+    "scss",
+    "pcss",
+    "postcss"
+  ]
+}

package/template/base/_editorconfig

@@ -0,0 +1,6 @@
+root = true
+
+[*]
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true

package/template/base/_gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

package/template/base/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+.DS_Store
+dist
+*.log
+.eslintcache

package/template/base/package.json

@@ -0,0 +1,27 @@
+{
+  "type": "module",
+  "private": true,
+  "license": "MIT",
+  "packageManager": "pnpm@10.25.0",
+  "engines": {
+    "node": ">=20.18.0"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "test": "vitest",
+    "release": "bumpp -r",
+    "lint": "eslint --cache",
+    "lint:fix": "eslint --cache --fix",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.2",
+    "bumpp": "^10.4.1",
+    "tsdown": "^0.20.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/template/eslint/eslint.config.mjs

@@ -0,0 +1,8 @@
+// @ts-check
+import antfu from '@antfu/eslint-config'
+
+export default antfu(
+  {
+    formatters: true,
+  },
+)

package/template/eslint/package.json

@@ -0,0 +1,11 @@
+{
+  "scripts": {
+    "lint": "eslint --cache",
+    "lint:fix": "eslint --cache --fix"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "catalog:",
+    "eslint": "catalog:",
+    "eslint-plugin-format": "catalog:"
+  }
+}

package/template/git-hooks/package.json

@@ -0,0 +1,17 @@
+{
+  "scripts": {
+    "postinstall": "simple-git-hooks"
+  },
+  "devDependencies": {
+    "picocolors": "^1.1.1",
+    "lint-staged": "^16.1.6",
+    "simple-git-hooks": "^2.13.1"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm lint-staged",
+    "commit-msg": "node scripts/verify-commit.js"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  }
+}

package/template/git-hooks/scripts/verify-commit.js

@@ -0,0 +1,41 @@
+// @ts-check
+
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+import pico from 'picocolors'
+
+const msgPath = path.resolve('.git/COMMIT_EDITMSG')
+const msg = readFileSync(msgPath, 'utf-8').trim()
+
+// eslint-disable-next-line regexp/no-unused-capturing-group
+const COMMIT_RE = /^(revert: )?(feat|fix|docs|dx|style|refactor|perf|test|workflow|build|ci|chore|types|wip|release)(\(.+\))?: .{1,50}/
+
+if (!COMMIT_RE.test(msg)) {
+  console.log()
+  console.error(
+    `  ${pico.bgRed(pico.white(' ERROR '))} ${pico.red(`Invalid commit message format.`)}\n\n`
+    + `  ${pico.dim('Help us keep a meaningful git history by following')}\n\n`
+
+    + `  ${pico.yellow('Standard Format:')}\n`
+    + `  ${pico.green('<type>[optional scope]: <description>')}\n\n`
+
+    + `  ${pico.cyan('Common Types:')}\n`
+    + `  ${pico.green('  feat')}     ${pico.dim('A new feature')}\n`
+    + `  ${pico.green('  fix')}      ${pico.dim('A bug fix')}\n`
+    + `  ${pico.green('  docs')}     ${pico.dim('Documentation only changes')}\n`
+    + `  ${pico.green('  style')}    ${pico.dim('Changes that do not affect the meaning of the code')}\n`
+    + `  ${pico.green('  refactor')} ${pico.dim('Code change that neither fixes a bug nor adds a feature')}\n`
+    + `  ${pico.green('  perf')}     ${pico.dim('A code change that improves performance')}\n`
+    + `  ${pico.green('  test')}     ${pico.dim('Adding missing tests or correcting existing tests')}\n`
+    + `  ${pico.green('  build')}    ${pico.dim('Changes that affect the build system or external dependencies')}\n`
+    + `  ${pico.green('  ci')}       ${pico.dim('Changes to CI configuration files and scripts')}\n`
+    + `  ${pico.green('  chore')}    ${pico.dim('Other changes that don\'t modify src or test files')}\n`
+    + `  ${pico.green('  revert')}   ${pico.dim('Reverts a previous commit')}\n\n`
+
+    + `  ${pico.cyan('Correct Examples:')}\n`
+    + `  ${pico.white('  feat(ui): add secondary button style')}\n`
+    + `  ${pico.white('  fix(auth): resolve token expiration issue')}\n\n`,
+  )
+  process.exit(1)
+}

package/template/github-workflows/.github/workflows/release.yml

@@ -0,0 +1,36 @@
+name: Release
+
+permissions:
+  contents: write
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4.2.0
+
+      - name: Set node
+        uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+
+      - name: Generate GitHub Changelog
+        run: pnpx changelogithub
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Publish to NPM
+        run: pnpm -r publish --access public --no-git-checks

package/template/github-workflows/.github/workflows/unit-test.yml

@@ -0,0 +1,63 @@
+name: Unit Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4.2.0
+
+      - name: Set node LTS
+        uses: actions/setup-node@v6
+        with:
+          node-version: lts/*
+          cache: pnpm
+
+      - name: Install
+        run: pnpm install
+
+      - name: Lint
+        run: pnpm run lint
+
+      - name: Typecheck
+        run: pnpm run typecheck
+
+  test:
+    runs-on: ${{ matrix.os }}
+
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        node: [20, 22, 24]
+      fail-fast: false
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4.2.0
+
+      - name: Set node ${{ matrix.node }}
+        uses: actions/setup-node@v6
+        with:
+          node-version: ${{ matrix.node }}
+          cache: pnpm
+
+      - name: Install
+        run: pnpm install
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Test
+        run: pnpm run test

package/template/monorepo/eslint.config.mjs

@@ -0,0 +1,9 @@
+// @ts-check
+import antfu from '@antfu/eslint-config'
+
+export default antfu(
+  {
+    formatters: true,
+    pnpm: true,
+  },
+)

package/template/monorepo/packages/foo/README.md

@@ -0,0 +1,3 @@
+# @scope/foo
+
+@scope/foo

package/template/monorepo/packages/foo/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@scope/foo",
+  "type": "module",
+  "version": "0.0.0",
+  "packageManager": "pnpm@10.25.0",
+  "license": "MIT",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.18.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/monorepo/packages/foo/src/index.ts

@@ -0,0 +1 @@
+export const foo = 'foo'

package/template/monorepo/packages/foo/tests/index.test.ts

@@ -0,0 +1,6 @@
+import { expect, it } from 'vitest'
+import { foo } from '../src'
+
+it('simple', () => {
+  expect(foo).toBe('foo')
+})

package/template/monorepo/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+shellEmulator: true
+trustPolicy: no-downgrade
+
+packages:
+  - packages/*

package/template/monorepo/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "lib": ["es2023"],
+    "moduleDetection": "force",
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "types": ["node"],
+    "strict": true,
+    "noUnusedLocals": true,
+    "declaration": true,
+    "esModuleInterop": true,
+    "isolatedDeclarations": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true
+  },
+  "include": ["packages/*/src", "packages/*/tests"],
+  "exclude": ["packages/*/tests/fixtures"]
+}

package/template/monorepo/tsdown.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  workspace: true,
+  entry: ['src/index.ts'],
+  exports: true,
+  dts: true,
+  publint: true,
+})

package/template/single-repo/package.json

@@ -0,0 +1,13 @@
+{
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/template/single-repo/src/index.ts

@@ -0,0 +1 @@
+export const foo = 'foo'

package/template/single-repo/tests/index.test.ts

@@ -0,0 +1,6 @@
+import { expect, it } from 'vitest'
+import { foo } from '../src'
+
+it('simple', () => {
+  expect(foo).toBe('foo')
+})

package/template/single-repo/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "lib": ["es2023"],
+    "moduleDetection": "force",
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "types": ["node"],
+    "strict": true,
+    "noUnusedLocals": true,
+    "declaration": true,
+    "esModuleInterop": true,
+    "isolatedDeclarations": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true
+  },
+  "include": ["src", "tests"]
+}

package/template/single-repo/tsdown.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from 'tsdown'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  exports: true,
+  dts: true,
+  publint: true,
+})