@rtorcato/js-tooling 1.0.6

package/dist/cli/generators/github-actions.js

@@ -0,0 +1,261 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function generateGitHubActions(config, targetDir) {
+    const workflowsDir = path.join(targetDir, '.github', 'workflows');
+    await fs.ensureDir(workflowsDir);
+    const workflowPath = path.join(workflowsDir, 'ci.yml');
+    const workflow = generateWorkflowYAML(config);
+    await fs.writeFile(workflowPath, workflow);
+}
+function generateWorkflowYAML(config) {
+    const hasTests = config.testing.framework !== 'none';
+    const hasTypeScript = config.typescript.enabled;
+    const hasBuild = config.bundler !== 'none';
+    const isLibrary = config.projectType === 'library';
+    return `name: 🚀 CI/CD Pipeline
+
+on:
+  push:
+    branches: [main, release, develop]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: \${{ github.workflow }}-\${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check-skip:
+    runs-on: ubuntu-latest
+    outputs:
+      should-skip: \${{ steps.skip-check.outputs.should-skip }}
+    steps:
+      - name: Check for skip CI
+        id: skip-check
+        run: |
+          if [[ "\${{ github.event.head_commit.message }}" =~ \\[(ci skip|skip ci)\\] ]]; then
+            echo "should-skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "should-skip=false" >> $GITHUB_OUTPUT
+          fi
+
+  dependencies:
+    runs-on: ubuntu-latest
+    needs: check-skip
+    if: needs.check-skip.outputs.should-skip != 'true'
+    outputs:
+      cache-key: \${{ steps.cache-key.outputs.key }}
+    steps:
+      - name: 📦 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: 📦 Generate cache key
+        id: cache-key
+        run: echo "key=\${{ runner.os }}-pnpm-\${{ hashFiles('**/pnpm-lock.yaml') }}" >> $GITHUB_OUTPUT
+
+      - name: 📦 Cache dependencies
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.pnpm-store
+            node_modules
+          key: \${{ steps.cache-key.outputs.key }}
+          restore-keys: |
+            \${{ runner.os }}-pnpm-
+
+      - name: 📦 Install dependencies
+        run: pnpm install --frozen-lockfile
+
+  lint:
+    runs-on: ubuntu-latest
+    needs: [dependencies, check-skip]
+    if: needs.check-skip.outputs.should-skip != 'true'
+    steps:
+      - name: 📦 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: 📦 Restore dependencies cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.pnpm-store
+            node_modules
+          key: \${{ needs.dependencies.outputs.cache-key }}
+
+      - name: 🔍 Run linting
+        run: ${config.linting.tool === 'biome' || config.linting.tool === 'both' ? 'pnpm check' : 'pnpm lint'}
+${hasTypeScript
+        ? `
+  typecheck:
+    runs-on: ubuntu-latest
+    needs: [dependencies, check-skip]
+    if: needs.check-skip.outputs.should-skip != 'true'
+    steps:
+      - name: 📦 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: 📦 Restore dependencies cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.pnpm-store
+            node_modules
+          key: \${{ needs.dependencies.outputs.cache-key }}
+
+      - name: 🔍 Type check
+        run: pnpm typecheck`
+        : ''}
+${hasTests
+        ? `
+  test:
+    runs-on: ubuntu-latest
+    needs: [dependencies, check-skip]
+    if: needs.check-skip.outputs.should-skip != 'true'
+    steps:
+      - name: 📦 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: 📦 Restore dependencies cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.pnpm-store
+            node_modules
+          key: \${{ needs.dependencies.outputs.cache-key }}
+
+      - name: 🧪 Run tests
+        run: pnpm test`
+        : ''}
+${hasBuild
+        ? `
+  build:
+    runs-on: ubuntu-latest
+    needs: [dependencies, check-skip]
+    if: needs.check-skip.outputs.should-skip != 'true'
+    steps:
+      - name: 📦 Checkout repository
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: 📦 Restore dependencies cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.pnpm-store
+            node_modules
+          key: \${{ needs.dependencies.outputs.cache-key }}
+
+      - name: 🏗️ Build project
+        run: pnpm build
+
+      - name: 📦 Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: build-artifacts
+          path: |
+            dist/
+            package.json
+            README.md
+          retention-days: 7`
+        : ''}
+${isLibrary && config.semanticRelease
+        ? `
+  release:
+    runs-on: ubuntu-latest
+    needs: [dependencies, lint${hasTypeScript ? ', typecheck' : ''}${hasTests ? ', test' : ''}${hasBuild ? ', build' : ''}, check-skip]
+    if: needs.check-skip.outputs.should-skip != 'true' && github.ref == 'refs/heads/main'
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+      id-token: write
+    steps:
+      - name: 📦 Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: \${{ secrets.GITHUB_TOKEN }}
+
+      - name: 📦 Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: 📦 Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: latest
+
+      - name: 📦 Restore dependencies cache
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.pnpm-store
+            node_modules
+          key: \${{ needs.dependencies.outputs.cache-key }}
+
+      - name: 🔧 Configure Git
+        run: |
+          git config --global user.name "github-actions[bot]"
+          git config --global user.email "github-actions[bot]@users.noreply.github.com"
+
+      - name: 🚀 Run semantic-release
+        env:
+          GITHUB_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: \${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: \${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release`
+        : ''}
+`;
+}

package/dist/cli/generators/index.js

@@ -0,0 +1,53 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { generateBuildConfigs } from './build.js';
+import { generateGitConfigs } from './git.js';
+import { generateGitHubActions } from './github-actions.js';
+import { generateLintingConfigs } from './linting.js';
+import { generatePackageJson } from './package-json.js';
+import { generateReadme } from './readme.js';
+import { generateTestingConfigs } from './testing.js';
+import { generateTSConfig } from './tsconfig.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export async function generateConfigs(config, targetDir) {
+    // Generate package.json
+    await generatePackageJson(config, targetDir);
+    // Generate TypeScript configuration
+    if (config.typescript.enabled) {
+        await generateTSConfig(config, targetDir);
+    }
+    // Generate linting configurations
+    if (config.linting.tool !== 'none') {
+        await generateLintingConfigs(config, targetDir);
+    }
+    // Generate testing configurations
+    if (config.testing.framework !== 'none') {
+        await generateTestingConfigs(config, targetDir);
+    }
+    // Generate git configurations
+    if (config.gitHooks || config.commitLint) {
+        await generateGitConfigs(config, targetDir);
+    }
+    // Generate GitHub Actions workflow
+    await generateGitHubActions(config, targetDir);
+    // Generate build configurations
+    if (config.bundler !== 'none') {
+        await generateBuildConfigs(config, targetDir);
+    }
+    // Generate README
+    await generateReadme(config, targetDir);
+    // Copy ts-reset if TypeScript is enabled
+    if (config.typescript.enabled) {
+        await copyTSReset(targetDir);
+    }
+}
+async function copyTSReset(targetDir) {
+    const toolingRoot = path.resolve(__dirname, '../../../tooling');
+    const resetPath = path.join(toolingRoot, 'typescript', 'reset.d.ts');
+    const targetPath = path.join(targetDir, 'reset.d.ts');
+    if (await fs.pathExists(resetPath)) {
+        await fs.copy(resetPath, targetPath);
+    }
+}

package/dist/cli/generators/linting.js

@@ -0,0 +1,43 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function generateLintingConfigs(config, targetDir) {
+    // Generate Biome config
+    if (config.linting.tool === 'biome' || config.linting.tool === 'both') {
+        await generateBiomeConfig(targetDir);
+    }
+    // Generate ESLint config
+    if (config.linting.tool === 'eslint' || config.linting.tool === 'both') {
+        await generateESLintConfig(config, targetDir);
+    }
+    // Generate Prettier config if using ESLint
+    if (config.linting.tool === 'eslint') {
+        await generatePrettierConfig(targetDir);
+    }
+}
+async function generateBiomeConfig(targetDir) {
+    const biomeConfigPath = path.join(targetDir, 'biome.jsonc');
+    const biomeConfig = {
+        $schema: 'https://biomejs.dev/schemas/1.9.4/schema.json',
+        extends: ['@rtorcato/js-tooling/biome'],
+        files: {
+            include: ['src/**/*', '*.ts', '*.js', '*.tsx', '*.jsx'],
+            ignore: ['node_modules', 'dist', 'build', '.next'],
+        },
+    };
+    await fs.writeJson(biomeConfigPath, biomeConfig, { spaces: 2 });
+}
+async function generateESLintConfig(config, targetDir) {
+    const eslintConfigPath = path.join(targetDir, 'eslint.config.mjs');
+    const configType = config.linting.eslintConfig || 'base';
+    const eslintConfig = `import { default as config } from '@rtorcato/js-tooling/eslint/${configType}'
+
+export default config
+`;
+    await fs.writeFile(eslintConfigPath, eslintConfig);
+}
+async function generatePrettierConfig(targetDir) {
+    const prettierConfigPath = path.join(targetDir, 'prettier.config.mjs');
+    const prettierConfig = `export { default } from '@rtorcato/js-tooling/prettier'
+`;
+    await fs.writeFile(prettierConfigPath, prettierConfig);
+}

package/dist/cli/generators/package-json.js

@@ -0,0 +1,162 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function generatePackageJson(config, targetDir) {
+    const packageJsonPath = path.join(targetDir, 'package.json');
+    let existingPackageJson = {};
+    if (await fs.pathExists(packageJsonPath)) {
+        existingPackageJson = await fs.readJson(packageJsonPath);
+    }
+    const packageJson = {
+        name: config.projectName,
+        version: '0.1.0',
+        description: '',
+        type: 'module',
+        ...existingPackageJson,
+        scripts: {
+            ...getScripts(config),
+            ...existingPackageJson?.scripts,
+        },
+        dependencies: {
+            ...existingPackageJson?.dependencies,
+        },
+        devDependencies: {
+            '@rtorcato/js-tooling': 'latest',
+            ...getDependencies(config),
+            ...existingPackageJson?.devDependencies,
+        },
+    };
+    // Add additional package.json fields based on project type
+    if (config.projectType === 'library') {
+        packageJson.main = './dist/index.js';
+        packageJson.module = './dist/index.mjs';
+        packageJson.types = './dist/index.d.ts';
+        packageJson.exports = {
+            '.': {
+                import: './dist/index.mjs',
+                require: './dist/index.js',
+                types: './dist/index.d.ts',
+            },
+        };
+        packageJson.files = ['dist'];
+        packageJson.publishConfig = {
+            access: 'public',
+        };
+    }
+    await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+}
+function getScripts(config) {
+    const scripts = {};
+    // TypeScript scripts
+    if (config.typescript.enabled) {
+        scripts['typecheck'] = 'tsc --noEmit';
+    }
+    // Linting scripts
+    if (config.linting.tool === 'biome' || config.linting.tool === 'both') {
+        scripts['lint'] = 'biome lint .';
+        scripts['format'] = 'biome format .';
+        scripts['check'] = 'biome check .';
+        scripts['check:fix'] = 'biome check --fix .';
+    }
+    else if (config.linting.tool === 'eslint') {
+        scripts['lint'] = 'eslint .';
+        scripts['lint:fix'] = 'eslint . --fix';
+        scripts['format'] = 'prettier --write .';
+    }
+    // Testing scripts
+    if (config.testing.framework === 'vitest') {
+        scripts['test'] = 'vitest';
+        scripts['test:watch'] = 'vitest --watch';
+        scripts['test:ui'] = 'vitest --ui';
+        scripts['coverage'] = 'vitest run --coverage';
+    }
+    else if (config.testing.framework === 'jest') {
+        scripts['test'] = 'jest';
+        scripts['test:watch'] = 'jest --watch';
+        scripts['coverage'] = 'jest --coverage';
+    }
+    else if (config.testing.framework === 'playwright') {
+        scripts['test:e2e'] = 'playwright test';
+        scripts['test:e2e:ui'] = 'playwright test --ui';
+    }
+    // Build scripts
+    if (config.bundler === 'tsup') {
+        scripts['build'] = 'tsup';
+        scripts['build:watch'] = 'tsup --watch';
+    }
+    else if (config.bundler === 'esbuild') {
+        scripts['build'] = 'node build.mjs';
+    }
+    else if (config.bundler === 'vite') {
+        scripts['build'] = 'vite build';
+        scripts['dev'] = 'vite';
+        scripts['preview'] = 'vite preview';
+    }
+    // Git hooks
+    if (config.gitHooks) {
+        scripts['prepare'] = 'husky';
+    }
+    // Semantic release
+    if (config.semanticRelease) {
+        scripts['release'] = 'semantic-release';
+    }
+    return scripts;
+}
+function getDependencies(config) {
+    const deps = {};
+    // TypeScript
+    if (config.typescript.enabled) {
+        deps['typescript'] = '^5.9.3';
+        deps['@types/node'] = '^24.0.0';
+    }
+    // Linting tools
+    if (config.linting.tool === 'biome' || config.linting.tool === 'both') {
+        deps['@biomejs/biome'] = '^2.3.0';
+    }
+    if (config.linting.tool === 'eslint' || config.linting.tool === 'both') {
+        deps['eslint'] = '^9.0.0';
+        deps['prettier'] = '^3.0.0';
+    }
+    // Testing frameworks
+    if (config.testing.framework === 'vitest') {
+        deps['vitest'] = '^4.0.0';
+        if (config.testing.environment === 'browser' || config.testing.environment === 'both') {
+            deps['@vitest/ui'] = '^4.0.0';
+            deps['jsdom'] = '^25.0.0';
+        }
+    }
+    else if (config.testing.framework === 'jest') {
+        deps['jest'] = '^29.0.0';
+        if (config.typescript.enabled) {
+            deps['ts-jest'] = '^29.0.0';
+        }
+    }
+    else if (config.testing.framework === 'playwright') {
+        deps['@playwright/test'] = '^1.56.0';
+    }
+    // Build tools
+    if (config.bundler === 'tsup') {
+        deps['tsup'] = '^8.0.0';
+    }
+    else if (config.bundler === 'esbuild') {
+        deps['esbuild'] = '^0.25.0';
+    }
+    else if (config.bundler === 'vite') {
+        deps['vite'] = '^6.0.0';
+    }
+    // Git hooks
+    if (config.gitHooks) {
+        deps['husky'] = '^9.0.0';
+        deps['lint-staged'] = '^16.0.0';
+    }
+    // Commit linting
+    if (config.commitLint) {
+        deps['@commitlint/cli'] = '^20.0.0';
+        deps['@commitlint/config-conventional'] = '^20.0.0';
+    }
+    // Semantic release
+    if (config.semanticRelease) {
+        deps['semantic-release'] = '^25.0.0';
+        deps['@semantic-release/github'] = '^12.0.0';
+    }
+    return deps;
+}