@book000/create-ts 0.0.0 → 0.1.7

package/dist/src/generate.d.ts

@@ -0,0 +1,25 @@
+import type { ProjectOptions } from './types.js';
+/**
+ * バリアントの package.json にプロジェクト固有の値を適用する。
+ * テンプレートのプレースホルダーを実際の値で上書きする。
+ */
+export declare function patchPackageJson(packageJson: Record<string, unknown>, options: Pick<ProjectOptions, 'name' | 'org' | 'repo' | 'description' | 'author' | 'license' | 'homepage' | 'bugUrl' | 'esm' | 'test'>, nodeMajor: number): Record<string, unknown>;
+/**
+ * tsconfig.json にモジュール形式・テスト設定のパッチを適用する。
+ */
+export declare function patchTsConfig(tsconfig: Record<string, unknown>, options: Pick<ProjectOptions, 'esm' | 'test'>): Record<string, unknown>;
+/**
+ * docker.yml のプレースホルダーをプロジェクト固有の値に置換する。
+ */
+export declare function patchDockerWorkflow(content: string, org: string, repo: string): string;
+/**
+ * .gitignore を生成する。
+ * バンドルされた Node.gitignore（pnpm セクション付き）をベースに、
+ * 任意で data/ セクションを追記する。
+ */
+export declare function generateGitignore(ignoreData: boolean): string;
+/**
+ * .depcheckrc.json の ignores 配列を更新する。
+ * テンプレートの depcheckIgnore と Jest 関連パッケージを追加する（重複除去）。
+ */
+export declare function updateDepcheck(depcheckJson: Record<string, unknown>, depcheckIgnore: string[], test: boolean): Record<string, unknown>;

package/dist/src/generate.js

@@ -0,0 +1,93 @@
+import { readTemplate } from './template.js';
+/**
+ * バリアントの package.json にプロジェクト固有の値を適用する。
+ * テンプレートのプレースホルダーを実際の値で上書きする。
+ */
+export function patchPackageJson(packageJson, options, nodeMajor) {
+    const { name, org, repo, description, author, license, homepage, bugUrl, esm, test, } = options;
+    const result = structuredClone(packageJson);
+    result.name = `@${org.toLowerCase()}/${name}`;
+    result.description = description;
+    result.license = license;
+    result.author = author;
+    result.engines.node = `>=${nodeMajor}`;
+    result.repository.url =
+        `git+https://github.com/${org}/${repo}.git`;
+    result.bugs.url = bugUrl;
+    if (homepage) {
+        result.homepage = homepage;
+    }
+    if (esm) {
+        result.type = 'module';
+        if (test) {
+            result.jest = {
+                preset: 'ts-jest/presets/default-esm',
+                extensionsToTreatAsEsm: ['.ts'],
+                transform: {
+                    '^.+\\.tsx?$': ['ts-jest', { useESM: true }],
+                },
+            };
+        }
+    }
+    if (!test) {
+        delete result.scripts.test;
+        delete result.jest;
+    }
+    return result;
+}
+/**
+ * tsconfig.json にモジュール形式・テスト設定のパッチを適用する。
+ */
+export function patchTsConfig(tsconfig, options) {
+    const result = structuredClone(tsconfig);
+    const compilerOptions = result.compilerOptions;
+    if (options.esm) {
+        compilerOptions.module = 'es2015';
+    }
+    if (options.test) {
+        compilerOptions.types ??= ['node'];
+        if (!compilerOptions.types.includes('jest')) {
+            compilerOptions.types.push('jest');
+        }
+    }
+    return result;
+}
+/**
+ * docker.yml のプレースホルダーをプロジェクト固有の値に置換する。
+ */
+export function patchDockerWorkflow(content, org, repo) {
+    let result = content;
+    result = result.replaceAll('tomacheese/twitter-dm-memo', `${org.toLowerCase()}/${repo.toLowerCase()}`);
+    result = result.replaceAll('packageName: "twitter-dm-memo"', `packageName: "${repo}"`);
+    return result;
+}
+/**
+ * .gitignore を生成する。
+ * バンドルされた Node.gitignore（pnpm セクション付き）をベースに、
+ * 任意で data/ セクションを追記する。
+ */
+export function generateGitignore(ignoreData) {
+    let result = readTemplate('gitignore/Node.gitignore');
+    if (ignoreData) {
+        result += '\n\n# データディレクトリ\ndata/';
+    }
+    return result;
+}
+/**
+ * .depcheckrc.json の ignores 配列を更新する。
+ * テンプレートの depcheckIgnore と Jest 関連パッケージを追加する（重複除去）。
+ */
+export function updateDepcheck(depcheckJson, depcheckIgnore, test) {
+    const result = structuredClone(depcheckJson);
+    const ignores = result.ignores ?? [];
+    result.ignores = ignores;
+    for (const pkg of depcheckIgnore) {
+        if (!ignores.includes(pkg)) {
+            ignores.push(pkg);
+        }
+    }
+    if (test && !ignores.includes('@types/jest')) {
+        ignores.push('@types/jest');
+    }
+    return result;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/src/index.js

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+import { intro, log, outro, spinner } from '@clack/prompts';
+import { Command } from 'commander';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execa } from 'execa';
+import { generateGitignore, patchDockerWorkflow, patchPackageJson, patchTsConfig, updateDepcheck, } from './generate.js';
+import { collectOptions, confirmOverwrite, displaySummary } from './prompts.js';
+import { fetchTemplateConfig, readTemplate } from './template.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(path.join(__dirname, '../package.json'), 'utf8'));
+/** ファイルを書き込む。親ディレクトリが存在しない場合は作成する。 */
+function writeFile(filePath, content) {
+    const dir = path.dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(filePath, content, 'utf8');
+}
+/** node / pnpm の存在と Node.js バージョンを確認する。メジャーバージョンを返す。 */
+async function checkPrerequisites() {
+    let nodeMajor;
+    try {
+        const { stdout: nodeVer } = await execa('node', ['--version']);
+        nodeMajor = Number.parseInt(nodeVer.trim().replace('v', '').split('.', 1)[0], 10);
+    }
+    catch {
+        log.error('Error: node not found. Please install Node.js v20 or later.');
+        process.exit(1);
+    }
+    if (nodeMajor < 20) {
+        log.error(`Error: Node.js v${nodeMajor} is too old. Please install Node.js v20 or later.`);
+        process.exit(1);
+    }
+    try {
+        await execa('pnpm', ['--version']);
+    }
+    catch {
+        log.error('Error: pnpm not found. Run "corepack enable" or "npm install -g pnpm".');
+        process.exit(1);
+    }
+    return nodeMajor;
+}
+async function main() {
+    const program = new Command();
+    program
+        .name('create-ts')
+        .description('Create book000-style TypeScript projects')
+        .version(version)
+        .argument('[outdir]', '出力ディレクトリ', '.')
+        .option('--name <name>', 'プロジェクト名（npm パッケージ名規則）')
+        .option('--org <org>', 'GitHub 組織 / ユーザー名')
+        .option('--repo <repo>', 'リポジトリ名')
+        .option('--description <desc>', 'プロジェクトの説明')
+        .option('--author <author>', '作者名')
+        .option('--license <spdx>', 'SPDX ライセンス識別子')
+        .option('--homepage <url>', 'ホームページ URL')
+        .option('--bug-url <url>', 'バグ報告 URL')
+        .option('--variant <variant>', 'バリアント (base/config-batch/fastify/discord-bot)')
+        .option('--esm', 'ESM モジュール形式を有効にする')
+        .option('--no-esm', 'CommonJS モジュール形式（デフォルト）')
+        .option('--test', 'Jest テストを追加する')
+        .option('--no-test', 'Jest テストを追加しない（デフォルト）')
+        .option('--docker', 'Dockerfile を追加する')
+        .option('--no-docker', 'Dockerfile を追加しない（デフォルト）')
+        .option('--ignore-data', 'data/ を .gitignore に追加する')
+        .option('--no-ignore-data', 'data/ を .gitignore に追加しない（デフォルト）')
+        .option('--add-reviewer', 'add-reviewer ワークフローを追加する')
+        .option('--no-add-reviewer', 'add-reviewer ワークフローを追加しない（デフォルト）')
+        .option('--overwrite', '既存ファイルを確認なしで上書きする');
+    program.parse();
+    const outDirArg = program.args[0] ?? '.';
+    const outDir = path.resolve(outDirArg);
+    const opts = program.opts();
+    /** CLI で明示的に指定されたかどうか確認して boolean | undefined を返す */
+    const getCLIBoolFlag = (name) => {
+        const source = program.getOptionValueSource(name);
+        if (source === 'cli' || source === 'env') {
+            return opts[name];
+        }
+        return undefined;
+    };
+    intro('create-ts');
+    // ステップ 1: 前提チェック
+    const s = spinner();
+    s.start('前提条件を確認しています...');
+    const nodeMajor = await checkPrerequisites();
+    s.stop('前提条件を確認しました');
+    // 対話プロンプトでオプション収集
+    const options = await collectOptions(outDir, {
+        name: opts.name,
+        org: opts.org,
+        repo: opts.repo,
+        description: opts.description,
+        author: opts.author,
+        license: opts.license,
+        homepage: opts.homepage,
+        bugUrl: opts.bugUrl,
+        variant: opts.variant,
+        esm: getCLIBoolFlag('esm'),
+        test: getCLIBoolFlag('test'),
+        docker: getCLIBoolFlag('docker'),
+        ignoreData: getCLIBoolFlag('ignoreData'),
+        addReviewer: getCLIBoolFlag('addReviewer'),
+        overwrite: opts.overwrite,
+    });
+    // 既存ファイルの確認
+    if (!options.overwrite) {
+        const hasExisting = existsSync(path.join(outDir, 'package.json')) ||
+            existsSync(path.join(outDir, 'tsconfig.json')) ||
+            existsSync(path.join(outDir, 'src'));
+        if (hasExisting) {
+            await confirmOverwrite(outDir);
+        }
+    }
+    // サマリー表示
+    displaySummary(options);
+    // 出力ディレクトリを作成
+    if (!existsSync(outDir)) {
+        mkdirSync(outDir, { recursive: true });
+    }
+    try {
+        // ステップ 2: template.json の読み込み
+        s.start('テンプレート設定を読み込んでいます...');
+        const templateConfig = fetchTemplateConfig(options.variant);
+        s.stop('テンプレート設定を読み込みました');
+        // ステップ 3: 共通テンプレートファイルのコピー
+        const commonFiles = [
+            'tsconfig.json',
+            '.prettierrc.yml',
+            'eslint.config.mjs',
+            'renovate.json',
+            '.depcheckrc.json',
+            '.fixpackrc',
+            'pnpm-workspace.yaml',
+            '.devcontainer/devcontainer.json',
+        ];
+        if (options.docker) {
+            commonFiles.push('Dockerfile', 'entrypoint.sh');
+        }
+        s.start('共通ファイルをコピーしています...');
+        for (const file of commonFiles) {
+            const content = readTemplate(`nodejs/common/${file}`);
+            writeFile(path.join(outDir, file), content);
+        }
+        s.stop(`共通ファイルをコピーしました (${commonFiles.length} ファイル)`);
+        // ステップ 4: バリアント src ファイルのコピー
+        const filesToCopy = [...templateConfig.src];
+        if (options.test && templateConfig.testSrc) {
+            filesToCopy.push(...templateConfig.testSrc);
+        }
+        s.start('src ファイルをコピーしています...');
+        for (const srcFile of filesToCopy) {
+            const content = readTemplate(`nodejs/${options.variant}/${srcFile}`);
+            writeFile(path.join(outDir, srcFile), content);
+        }
+        s.stop(`src ファイルをコピーしました (${filesToCopy.length} ファイル)`);
+        // ステップ 5: tsconfig.json のパッチ
+        const tsconfigPath = path.join(outDir, 'tsconfig.json');
+        const tsconfig = JSON.parse(readFileSync(tsconfigPath, 'utf8'));
+        const patchedTsConfig = patchTsConfig(tsconfig, options);
+        writeFileSync(tsconfigPath, JSON.stringify(patchedTsConfig, null, 2) + '\n', 'utf8');
+        // ステップ 6: .gitignore / .node-version の生成
+        s.start('.gitignore を生成しています...');
+        const gitignoreContent = generateGitignore(options.ignoreData);
+        writeFileSync(path.join(outDir, '.gitignore'), gitignoreContent, 'utf8');
+        const { stdout: nodeVersion } = await execa('node', ['--version']);
+        const nodeVersionNumber = nodeVersion.trim().replace('v', '');
+        writeFileSync(path.join(outDir, '.node-version'), `${nodeVersionNumber}\n`, 'utf8');
+        s.stop('.gitignore と .node-version を生成しました');
+        // ステップ 7: LICENSE の生成
+        s.start('LICENSE を生成しています...');
+        try {
+            const licenseRes = await fetch(`https://api.github.com/licenses/${options.license.toLowerCase()}`);
+            if (!licenseRes.ok)
+                throw new Error(`HTTP ${licenseRes.status}`);
+            const licenseJson = (await licenseRes.json());
+            const licenseText = licenseJson.body
+                .replaceAll('[year]', String(new Date().getFullYear()))
+                .replaceAll('[fullname]', options.author);
+            writeFileSync(path.join(outDir, 'LICENSE'), licenseText, 'utf8');
+            s.stop('LICENSE を生成しました');
+        }
+        catch {
+            s.stop('LICENSE の取得をスキップしました（取得失敗）');
+            log.warn('警告: LICENSE の取得に失敗しました。後で手動で追加してください。');
+        }
+        // ステップ 8: ワークフローファイルのコピー
+        s.start('ワークフローファイルをコピーしています...');
+        const workflowDir = path.join(outDir, '.github', 'workflows');
+        mkdirSync(workflowDir, { recursive: true });
+        const ciYml = readTemplate('workflows/nodejs-ci-pnpm.yml');
+        writeFileSync(path.join(workflowDir, 'nodejs-ci-pnpm.yml'), ciYml, 'utf8');
+        if (options.docker) {
+            const dockerYml = readTemplate('workflows/docker.yml');
+            const patchedDockerYml = patchDockerWorkflow(dockerYml, options.org, options.repo);
+            const expected = `${options.org.toLowerCase()}/${options.repo.toLowerCase()}`;
+            if (!patchedDockerYml.includes(expected)) {
+                log.warn('警告: docker.yml の文字列置換が正しく行われなかった可能性があります。');
+            }
+            writeFileSync(path.join(workflowDir, 'docker.yml'), patchedDockerYml, 'utf8');
+        }
+        if (options.addReviewer) {
+            const addReviewerYml = readTemplate('workflows/add-reviewer.yml');
+            writeFileSync(path.join(workflowDir, 'add-reviewer.yml'), addReviewerYml, 'utf8');
+        }
+        s.stop('ワークフローファイルをコピーしました');
+        // ステップ 9: package.json の生成
+        s.start('package.json を生成しています...');
+        // 9-1: バリアントの package.json を読み込み
+        const variantPkgText = readTemplate(`nodejs/${options.variant}/package.json`);
+        const variantPkgJson = JSON.parse(variantPkgText);
+        // 9-2〜9-4: プロジェクト固有の値を適用
+        const patchedPkgJson = patchPackageJson(variantPkgJson, options, nodeMajor);
+        // 9-5: .depcheckrc.json の更新
+        const depcheckIgnore = templateConfig.depcheckIgnore ?? [];
+        if (depcheckIgnore.length > 0 || options.test) {
+            const depcheckPath = path.join(outDir, '.depcheckrc.json');
+            const depcheckJson = JSON.parse(readFileSync(depcheckPath, 'utf8'));
+            const updatedDepcheck = updateDepcheck(depcheckJson, depcheckIgnore, options.test);
+            writeFileSync(depcheckPath, JSON.stringify(updatedDepcheck, null, 2) + '\n', 'utf8');
+        }
+        // 9-6: schema/ ディレクトリの作成
+        if (templateConfig.configSchema) {
+            mkdirSync(path.join(outDir, 'schema'), { recursive: true });
+        }
+        // 9-7: package.json の保存
+        writeFileSync(path.join(outDir, 'package.json'), JSON.stringify(patchedPkgJson, null, 2) + '\n', 'utf8');
+        s.stop('package.json を生成しました');
+        // ステップ 10: pnpm-lock.yaml のコピー
+        s.start('pnpm-lock.yaml をコピーしています...');
+        const pnpmLock = readTemplate(`nodejs/${options.variant}/pnpm-lock.yaml`);
+        writeFileSync(path.join(outDir, 'pnpm-lock.yaml'), pnpmLock, 'utf8');
+        s.stop('pnpm-lock.yaml をコピーしました');
+        // ステップ 11: pnpm install
+        s.start('pnpm install を実行しています...');
+        await execa('pnpm', ['install', '--frozen-lockfile'], {
+            cwd: outDir,
+            stdio: 'inherit',
+        });
+        s.stop('依存パッケージをインストールしました');
+        // ステップ 12: jest 関連の除去（テストなし時）
+        if (!options.test) {
+            s.start('Jest 関連パッケージを削除しています...');
+            await execa('pnpm', ['remove', 'jest', '@types/jest', 'ts-jest'], {
+                cwd: outDir,
+            });
+            s.stop('Jest 関連パッケージを削除しました');
+        }
+        // ステップ 13: fixpack / fixdevcontainer
+        s.start('fixpack を実行しています...');
+        try {
+            await execa('npx', ['--yes', 'fixpack'], { cwd: outDir });
+            s.stop('fixpack を実行しました');
+        }
+        catch {
+            s.stop('fixpack をスキップしました（失敗）');
+        }
+        try {
+            await execa('npx', ['--yes', 'fixdevcontainer'], { cwd: outDir });
+            log.success('fixdevcontainer を実行しました');
+        }
+        catch {
+            log.warn('fixdevcontainer をスキップしました（失敗）');
+        }
+        // ステップ 14: 完了メッセージ
+        const completionLines = [
+            '=== セットアップ完了！ ===',
+            '',
+            `プロジェクト : @${options.org.toLowerCase()}/${options.name}`,
+            `バリアント   : ${options.variant}`,
+            `モジュール   : ${options.esm ? 'ESM' : 'CommonJS'}`,
+            '',
+            '次のステップ:',
+            '  1. git init && git add . && git commit -m "feat: 初期コミット"',
+            '  2. pnpm run lint',
+        ];
+        let stepNum = 3;
+        if (templateConfig.configSchema) {
+            completionLines.push(`  ${stepNum}. pnpm run generate-schema`);
+            stepNum++;
+        }
+        if (options.test) {
+            completionLines.push(`  ${stepNum}. pnpm run test`);
+        }
+        outro(completionLines.join('\n'));
+    }
+    catch (error) {
+        log.error(`エラーが発生しました: ${error.message}`);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    log.error(`予期しないエラーが発生しました: ${error.message}`);
+    process.exit(1);
+});

package/dist/src/prompts.d.ts

@@ -0,0 +1,33 @@
+import type { ProjectOptions } from './types.js';
+/** CLI フラグから渡される部分的なオプション */
+export interface CliFlags {
+    name?: string;
+    org?: string;
+    repo?: string;
+    description?: string;
+    author?: string;
+    license?: string;
+    homepage?: string;
+    bugUrl?: string;
+    variant?: string;
+    esm?: boolean;
+    test?: boolean;
+    docker?: boolean;
+    ignoreData?: boolean;
+    addReviewer?: boolean;
+    overwrite?: boolean;
+}
+/**
+ * 対話プロンプトで ProjectOptions を収集する。
+ * CLI フラグで指定済みの項目はスキップする。
+ */
+export declare function collectOptions(outDir: string, flags: CliFlags): Promise<ProjectOptions>;
+/**
+ * セットアップ内容のサマリーを note() で表示する。
+ */
+export declare function displaySummary(options: ProjectOptions): void;
+/**
+ * 既存ファイルの上書き確認を行う。
+ * キャンセル / 拒否時はプロセスを終了する。
+ */
+export declare function confirmOverwrite(outDir: string): Promise<void>;