@rtorcato/js-tooling 2.5.0 → 2.6.0

package/dist/cli/commands/fix.js

@@ -124,9 +124,10 @@ const FIXERS = [
     },
     {
         target: 'husky',
-        description: 'Set up Husky + lint-staged (deep-merges existing lint-staged field)',
+        description: 'Set up Husky + lint-staged',
         appliesTo: ['Husky', 'lint-staged'],
         outputs: ['.husky/pre-commit', 'package.json (lint-staged field)'],
+        riskLevel: 'safe-merge',
         canFixDrift: true,
         async run({ targetDir, pkg }) {
             const pkgPath = path.join(targetDir, 'package.json');
@@ -209,9 +210,10 @@ const FIXERS = [
     },
     {
         target: 'engines',
-        description: 'Add engines.node to package.json (never overwrites)',
+        description: 'Add engines.node to package.json',
         appliesTo: ['engines.node'],
         outputs: ['package.json (engines.node field)'],
+        riskLevel: 'safe-merge',
         canFixDrift: true,
         async run({ targetDir }) {
             const result = await ensureEnginesNode(targetDir);
@@ -234,6 +236,7 @@ const FIXERS = [
         description: 'Add @rtorcato/js-tooling to devDependencies',
         appliesTo: ['package.json'],
         outputs: ['package.json (devDependencies)'],
+        riskLevel: 'safe-merge',
         canFixDrift: true,
         async run({ targetDir, pkg }) {
             const pkgPath = path.join(targetDir, 'package.json');
@@ -282,15 +285,29 @@ async function applyFixer(fixer, result, targetDir, pkg, dryRun, silent) {
     }
     return { filesWritten, dryRun: false };
 }
+function promptMessageFor(fixer, result) {
+    const risk = fixer.riskLevel ?? 'destructive';
+    if (risk === 'safe-merge') {
+        return { message: `${fixer.description} (existing fields preserved)?`, default: true };
+    }
+    if (risk === 'safe-add') {
+        return { message: `${fixer.description}?`, default: true };
+    }
+    // destructive
+    if (result.status === 'drift') {
+        return {
+            message: `⚠️  ${fixer.description} — overwrite existing file? user customizations will be lost`,
+            default: false,
+        };
+    }
+    return { message: `Apply ${fixer.description}?`, default: true };
+}
 async function confirmApply(fixer, result, assumeYes) {
     if (assumeYes)
         return true;
-    const isDrift = result.status === 'drift';
-    const message = isDrift
-        ? `⚠️  ${fixer.description} — overwrite existing file? user customizations will be lost`
-        : `Apply ${fixer.description}?`;
+    const { message, default: defaultValue } = promptMessageFor(fixer, result);
     const { confirm } = await inquirer.prompt([
-        { type: 'confirm', name: 'confirm', message, default: !isDrift },
+        { type: 'confirm', name: 'confirm', message, default: defaultValue },
     ]);
     return confirm === true;
 }

package/dist/cli/commands/setup-presets.js

@@ -0,0 +1,193 @@
+export const PRESET_NAMES = [
+    'library',
+    'web-app',
+    'node-api',
+    'nextjs-app',
+    'react-app',
+];
+const BASE = {
+    linting: { tool: 'biome' },
+    formatting: { tool: 'biome' },
+    testing: { framework: 'vitest', environment: 'node' },
+    gitHooks: true,
+    commitLint: true,
+    semanticRelease: false,
+    securityAutomation: true,
+};
+export function buildPresetConfig(name, projectName) {
+    switch (name) {
+        case 'library':
+            return {
+                ...BASE,
+                projectName,
+                projectType: 'library',
+                typescript: { enabled: true, config: 'base' },
+                semanticRelease: true,
+                bundler: 'tsup',
+            };
+        case 'web-app':
+            return {
+                ...BASE,
+                projectName,
+                projectType: 'web-app',
+                typescript: { enabled: true, config: 'base' },
+                testing: { framework: 'vitest', environment: 'browser' },
+                bundler: 'vite',
+            };
+        case 'node-api':
+            return {
+                ...BASE,
+                projectName,
+                projectType: 'node-api',
+                typescript: { enabled: true, config: 'node' },
+                bundler: 'esbuild',
+            };
+        case 'nextjs-app':
+            return {
+                ...BASE,
+                projectName,
+                projectType: 'nextjs-app',
+                typescript: { enabled: true, config: 'next' },
+                linting: { tool: 'eslint', eslintConfig: 'nextjs' },
+                formatting: { tool: 'prettier' },
+                bundler: 'none',
+            };
+        case 'react-app':
+            return {
+                ...BASE,
+                projectName,
+                projectType: 'react-app',
+                typescript: { enabled: true, config: 'react' },
+                testing: { framework: 'vitest', environment: 'browser' },
+                bundler: 'vite',
+            };
+    }
+}
+export const CONFIG_SCHEMA = {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rtorcato.github.io/js-tooling/schemas/project-config.json',
+    title: 'ProjectConfig',
+    description: '@rtorcato/js-tooling setup configuration',
+    type: 'object',
+    additionalProperties: false,
+    required: [
+        'projectName',
+        'projectType',
+        'typescript',
+        'linting',
+        'formatting',
+        'testing',
+        'gitHooks',
+        'commitLint',
+        'semanticRelease',
+        'securityAutomation',
+        'bundler',
+    ],
+    properties: {
+        projectName: { type: 'string', minLength: 1 },
+        projectType: {
+            type: 'string',
+            enum: ['library', 'web-app', 'node-api', 'nextjs-app', 'react-app'],
+        },
+        typescript: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['enabled', 'config'],
+            properties: {
+                enabled: { type: 'boolean' },
+                config: { type: 'string', enum: ['base', 'react', 'next', 'node', 'express'] },
+            },
+        },
+        linting: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['tool'],
+            properties: {
+                tool: { type: 'string', enum: ['biome', 'eslint', 'both', 'none'] },
+                eslintConfig: { type: 'string', enum: ['base', 'nextjs'] },
+            },
+        },
+        formatting: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['tool'],
+            properties: { tool: { type: 'string', enum: ['biome', 'prettier', 'none'] } },
+        },
+        testing: {
+            type: 'object',
+            additionalProperties: false,
+            required: ['framework'],
+            properties: {
+                framework: { type: 'string', enum: ['vitest', 'jest', 'playwright', 'none'] },
+                environment: { type: 'string', enum: ['node', 'browser', 'both'] },
+            },
+        },
+        gitHooks: { type: 'boolean' },
+        commitLint: { type: 'boolean' },
+        semanticRelease: { type: 'boolean' },
+        securityAutomation: { type: 'boolean' },
+        bundler: { type: 'string', enum: ['tsup', 'esbuild', 'vite', 'none'] },
+    },
+};
+const ALLOWED_KEYS = new Set(CONFIG_SCHEMA.required);
+export function validateProjectConfig(input) {
+    const errors = [];
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        return { valid: false, errors: ['Config must be a JSON object'] };
+    }
+    const obj = input;
+    for (const key of Object.keys(obj)) {
+        if (!ALLOWED_KEYS.has(key))
+            errors.push(`Unknown field: ${key}`);
+    }
+    for (const required of CONFIG_SCHEMA.required) {
+        if (!(required in obj))
+            errors.push(`Missing required field: ${required}`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+export function computeFileList(config) {
+    const files = ['package.json'];
+    files.push('.editorconfig', '.nvmrc', 'knip.json');
+    if (config.typescript.enabled) {
+        files.push('tsconfig.json', 'reset.d.ts');
+    }
+    if (config.linting.tool === 'biome' || config.linting.tool === 'both') {
+        files.push('biome.jsonc');
+    }
+    if (config.linting.tool === 'eslint' || config.linting.tool === 'both') {
+        files.push('eslint.config.mjs');
+    }
+    if (config.linting.tool === 'eslint') {
+        files.push('prettier.config.mjs');
+    }
+    if (config.testing.framework === 'vitest') {
+        files.push('vitest.config.ts', 'vitest.setup.ts');
+    }
+    if (config.testing.framework === 'jest') {
+        files.push('jest.config.mjs');
+    }
+    if (config.testing.framework === 'playwright') {
+        files.push('playwright.config.ts');
+    }
+    if (config.gitHooks) {
+        files.push('.husky/pre-commit', '.gitignore');
+    }
+    if (config.commitLint) {
+        files.push('.husky/commit-msg', 'commitlint.config.mjs');
+    }
+    files.push('.github/workflows/ci.yml');
+    if (config.securityAutomation) {
+        files.push('.github/dependabot.yml', '.github/workflows/codeql.yml');
+    }
+    if (config.bundler === 'tsup')
+        files.push('tsup.config.ts');
+    else if (config.bundler === 'esbuild')
+        files.push('build.mjs');
+    else if (config.bundler === 'vite')
+        files.push('vite.config.ts');
+    if (config.semanticRelease)
+        files.push('release.config.mjs');
+    files.push('README.md');
+    return files;
+}

package/dist/cli/commands/setup.js

@@ -1,17 +1,58 @@
+import path from 'node:path';
 import chalk from 'chalk';
 import fs from 'fs-extra';
 import inquirer from 'inquirer';
-import path from 'node:path';
 import { generateConfigs } from '../generators/index.js';
 import { installDependencies } from '../utils/install.js';
+import { buildPresetConfig, computeFileList, CONFIG_SCHEMA, PRESET_NAMES, validateProjectConfig, } from './setup-presets.js';
+async function resolveConfig(options) {
+    if (options.config && options.preset) {
+        console.warn(chalk.yellow('⚠️  Both --config and --preset given; --config wins.\n'));
+    }
+    if (options.config) {
+        const configPath = path.resolve(options.config);
+        if (!(await fs.pathExists(configPath))) {
+            throw new Error(`Config file not found: ${configPath}`);
+        }
+        const raw = await fs.readJson(configPath);
+        const { valid, errors } = validateProjectConfig(raw);
+        if (!valid) {
+            throw new Error(`Invalid config:\n  - ${errors.join('\n  - ')}`);
+        }
+        return raw;
+    }
+    if (options.preset) {
+        if (!PRESET_NAMES.includes(options.preset)) {
+            throw new Error(`Unknown preset: ${options.preset}. Available: ${PRESET_NAMES.join(', ')}`);
+        }
+        const projectName = path.basename(path.resolve(options.directory));
+        return buildPresetConfig(options.preset, projectName);
+    }
+    return promptForConfig();
+}
 export async function setupProject(options) {
+    if (options.configSchema) {
+        console.log(JSON.stringify(CONFIG_SCHEMA, null, 2));
+        return;
+    }
     const targetDir = path.resolve(options.directory);
-    console.log(chalk.cyan('\n🛠️  Welcome to JS Tooling Setup!\n'));
-    console.log(chalk.gray(`Setting up tooling in: ${targetDir}\n`));
+    const interactive = !options.config && !options.preset;
+    const dryRun = options.dryRun === true;
+    if (interactive && !dryRun) {
+        console.log(chalk.cyan('\n🛠️  Welcome to JS Tooling Setup!\n'));
+        console.log(chalk.gray(`Setting up tooling in: ${targetDir}\n`));
+    }
     try {
-        // Check if directory exists and is writable
         await fs.ensureDir(targetDir);
-        const config = await promptForConfig();
+        const config = await resolveConfig(options);
+        if (dryRun) {
+            const files = computeFileList(config);
+            console.log(JSON.stringify({ directory: targetDir, config, files }, null, 2));
+            return;
+        }
+        if (!interactive) {
+            console.log(chalk.cyan(`\n🛠️  Scaffolding ${config.projectType} in ${targetDir}\n`));
+        }
         console.log(chalk.cyan('\n📝 Generating configuration files...\n'));
         await generateConfigs(config, targetDir);
         if (!options.skipInstall) {
@@ -19,7 +60,6 @@ export async function setupProject(options) {
             await installDependencies(config, targetDir);
         }
         console.log(chalk.green('\n✅ Setup completed successfully!\n'));
-        // Show next steps
         showNextSteps(config, targetDir);
     }
     catch (error) {

package/dist/cli/generators/build.js

@@ -53,32 +53,17 @@ console.log('Build completed!')
 `;
     await fs.writeFile(esbuildConfigPath, esbuildConfig);
 }
-async function generateViteConfig(config, targetDir) {
+export async function generateViteConfig(config, targetDir) {
     const viteConfigPath = path.join(targetDir, 'vite.config.ts');
-    let viteConfig = `import { defineConfig } from 'vite'
-`;
-    if (config.projectType === 'react-app') {
-        viteConfig += `import react from '@vitejs/plugin-react'
-`;
-    }
-    viteConfig += `
-export default defineConfig({
-  plugins: [${config.projectType === 'react-app' ? 'react()' : ''}],
-  resolve: {
-    alias: {
-      '@': '/src',
-      '~': '/src'
-    }
-  },
-  build: {
-    outDir: 'dist',
-    sourcemap: true,
-  },
-  server: {
-    port: 3000,
-    open: true
-  }
-})
+    // React apps need the plugin; we layer it on top of the shipped preset.
+    const viteConfig = config.projectType === 'react-app'
+        ? `import preset from '@rtorcato/js-tooling/vite'
+import react from '@vitejs/plugin-react'
+import { defineConfig, mergeConfig } from 'vite'
+
+export default mergeConfig(preset, defineConfig({ plugins: [react()] }))
+`
+        : `export { default } from '@rtorcato/js-tooling/vite'
 `;
     await fs.writeFile(viteConfigPath, viteConfig);
 }

package/dist/cli/generators/testing.js

@@ -38,41 +38,9 @@ async function generateJestConfig(config, targetDir) {
 `;
     await fs.writeFile(jestConfigPath, jestConfig);
 }
-async function generatePlaywrightConfig(targetDir) {
+export async function generatePlaywrightConfig(targetDir) {
     const playwrightConfigPath = path.join(targetDir, 'playwright.config.ts');
-    const playwrightConfig = `import { defineConfig } from '@playwright/test'
-
-export default defineConfig({
-  testDir: './tests/e2e',
-  fullyParallel: true,
-  forbidOnly: !!process.env.CI,
-  retries: process.env.CI ? 2 : 0,
-  workers: process.env.CI ? 1 : undefined,
-  reporter: 'html',
-  use: {
-    baseURL: 'http://localhost:3000',
-    trace: 'on-first-retry',
-  },
-  projects: [
-    {
-      name: 'chromium',
-      use: { ...devices['Desktop Chrome'] },
-    },
-    {
-      name: 'firefox',
-      use: { ...devices['Desktop Firefox'] },
-    },
-    {
-      name: 'webkit',
-      use: { ...devices['Desktop Safari'] },
-    },
-  ],
-  webServer: {
-    command: 'npm run dev',
-    url: 'http://localhost:3000',
-    reuseExistingServer: !process.env.CI,
-  },
-})
+    const playwrightConfig = `export { default } from '@rtorcato/js-tooling/playwright'
 `;
     await fs.writeFile(playwrightConfigPath, playwrightConfig);
 }

package/dist/cli/index.js

@@ -28,6 +28,10 @@ program
     .description('🚀 Setup tooling for a new or existing project')
     .option('-d, --directory <path>', 'Target directory for setup', process.cwd())
     .option('--skip-install', 'Skip installing dependencies')
+    .option('--preset <name>', 'Skip prompts; use defaults for a project type')
+    .option('--config <path>', 'Skip prompts; read a JSON ProjectConfig from <path>')
+    .option('--dry-run', 'Print the resolved config and file list, write nothing')
+    .option('--config-schema', 'Print the JSON Schema for ProjectConfig and exit')
     .action(setupProject);
 program
     .command('copy <config>')
@@ -52,41 +56,155 @@ program
         console.error(chalk.red(`\n❌ Error copying configuration: ${error}\n`));
     }
 });
+const TOOL_CATALOG = [
+    {
+        name: 'TypeScript',
+        description: 'Base, React, Next.js, Node.js, Express tsconfig presets',
+        exports: [
+            '@rtorcato/js-tooling/typescript/base',
+            '@rtorcato/js-tooling/typescript/react',
+            '@rtorcato/js-tooling/typescript/next',
+            '@rtorcato/js-tooling/typescript/node',
+            '@rtorcato/js-tooling/typescript/express',
+            '@rtorcato/js-tooling/typescript/test',
+            '@rtorcato/js-tooling/typescript/reset',
+        ],
+        fixTarget: 'tsconfig',
+    },
+    {
+        name: 'ESLint',
+        description: 'Base and Next.js ESLint configurations',
+        exports: ['@rtorcato/js-tooling/eslint/base', '@rtorcato/js-tooling/eslint/nextjs'],
+        fixTarget: 'eslint',
+    },
+    {
+        name: 'Biome',
+        description: 'Fast formatter and linter configuration',
+        exports: ['@rtorcato/js-tooling/biome'],
+        fixTarget: 'biome',
+    },
+    {
+        name: 'Prettier',
+        description: 'Code formatter configuration',
+        exports: ['@rtorcato/js-tooling/prettier'],
+        fixTarget: 'prettier',
+    },
+    {
+        name: 'Vitest',
+        description: 'Testing framework configuration',
+        exports: [
+            '@rtorcato/js-tooling/vitest/config',
+            '@rtorcato/js-tooling/vitest/react',
+            '@rtorcato/js-tooling/vitest/setup',
+        ],
+        fixTarget: 'vitest',
+    },
+    {
+        name: 'Jest',
+        description: 'Testing framework presets for browser and Node.js',
+        exports: [
+            '@rtorcato/js-tooling/jest-presets/browser/jest-preset',
+            '@rtorcato/js-tooling/jest-presets/node/jest-preset',
+        ],
+        fixTarget: null,
+    },
+    {
+        name: 'Playwright',
+        description: 'End-to-end testing configuration',
+        exports: ['@rtorcato/js-tooling/playwright'],
+        fixTarget: null,
+    },
+    {
+        name: 'Commitlint',
+        description: 'Conventional commit linting',
+        exports: ['@rtorcato/js-tooling/commitlint/config'],
+        fixTarget: 'commitlint',
+    },
+    {
+        name: 'Husky',
+        description: 'Git hooks for pre-commit validation',
+        exports: [],
+        fixTarget: 'husky',
+    },
+    {
+        name: 'lint-staged',
+        description: 'Run linters on staged files (pairs with Husky)',
+        exports: [],
+        fixTarget: 'husky',
+    },
+    {
+        name: 'Semantic Release',
+        description: 'Automated versioning and publishing',
+        exports: [
+            '@rtorcato/js-tooling/semantic-release',
+            '@rtorcato/js-tooling/semantic-release/github',
+            '@rtorcato/js-tooling/semantic-release/docker',
+        ],
+        fixTarget: 'semantic-release',
+    },
+    {
+        name: 'tsup',
+        description: 'TypeScript bundler configuration',
+        exports: ['@rtorcato/js-tooling/tsup'],
+        fixTarget: null,
+    },
+    {
+        name: 'esbuild',
+        description: 'Fast JavaScript bundler configuration',
+        exports: ['@rtorcato/js-tooling/esbuild'],
+        fixTarget: null,
+    },
+    {
+        name: 'Vite',
+        description: 'Modern web app build tool configuration',
+        exports: ['@rtorcato/js-tooling/vite'],
+        fixTarget: null,
+    },
+    {
+        name: 'EditorConfig',
+        description: 'Cross-editor formatting consistency (.editorconfig)',
+        exports: [],
+        fixTarget: 'editorconfig',
+    },
+    {
+        name: '.nvmrc',
+        description: 'Pin Node version per repository',
+        exports: [],
+        fixTarget: 'nvmrc',
+    },
+    {
+        name: 'knip',
+        description: 'Find unused files, exports, and dependencies',
+        exports: [],
+        fixTarget: 'knip',
+    },
+    {
+        name: 'Dependabot',
+        description: 'Weekly automated dependency updates',
+        exports: [],
+        fixTarget: 'dependabot',
+    },
+    {
+        name: 'CodeQL',
+        description: 'GitHub security scanning workflow',
+        exports: [],
+        fixTarget: 'codeql',
+    },
+];
 program
     .command('list')
     .alias('ls')
     .description('📋 List all available tooling configurations')
-    .action(() => {
+    .option('--json', 'Emit machine-readable JSON output')
+    .action((options) => {
+    if (options.json) {
+        console.log(JSON.stringify({ tools: TOOL_CATALOG }, null, 2));
+        return;
+    }
     console.log(chalk.cyan('\n🛠️  Available tooling configurations:\n'));
-    const configs = [
-        {
-            name: 'TypeScript',
-            desc: 'Base, React, Next.js, Node.js, Express configurations',
-        },
-        { name: 'ESLint', desc: 'Base and Next.js ESLint configurations' },
-        { name: 'Biome', desc: 'Fast formatter and linter configuration' },
-        { name: 'Prettier', desc: 'Code formatter configuration' },
-        { name: 'Vitest', desc: 'Testing framework configuration' },
-        {
-            name: 'Jest',
-            desc: 'Testing framework presets for browser and Node.js',
-        },
-        { name: 'Playwright', desc: 'End-to-end testing configuration' },
-        { name: 'Commitlint', desc: 'Conventional commit linting' },
-        { name: 'Husky', desc: 'Git hooks for pre-commit validation' },
-        { name: 'lint-staged', desc: 'Run linters on staged files (pairs with Husky)' },
-        { name: 'Semantic Release', desc: 'Automated versioning and publishing' },
-        { name: 'tsup', desc: 'TypeScript bundler configuration' },
-        { name: 'esbuild', desc: 'Fast JavaScript bundler configuration' },
-        { name: 'EditorConfig', desc: 'Cross-editor formatting consistency (.editorconfig)' },
-        { name: '.nvmrc', desc: 'Pin Node version per repository' },
-        { name: 'knip', desc: 'Find unused files, exports, and dependencies' },
-        { name: 'Dependabot', desc: 'Weekly automated dependency updates' },
-        { name: 'CodeQL', desc: 'GitHub security scanning workflow' },
-    ];
-    configs.forEach(({ name, desc }) => {
-        console.log(`  ${chalk.green('●')} ${chalk.bold(name)}: ${chalk.gray(desc)}`);
-    });
+    for (const { name, description } of TOOL_CATALOG) {
+        console.log(`  ${chalk.green('●')} ${chalk.bold(name)}: ${chalk.gray(description)}`);
+    }
     console.log(chalk.dim('\n💡 Run `js-tooling setup` for a new project'));
     console.log(chalk.dim('   or `js-tooling fix` to apply missing pieces to an existing one\n'));
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@rtorcato/js-tooling",
-	"version": "2.5.0",
+	"version": "2.6.0",
 	"description": "JavaScript and TypeScript tooling for Node.js, React, Next.js, and Vitest.",
 	"type": "module",
 	"keywords": [
@@ -47,10 +47,14 @@
 		"tooling/eslint/*.d.mts",
 		"tooling/eslint/types.d.ts",
 		"tooling/jest-presets/**",
+		"tooling/playwright/playwright.config.mjs",
+		"tooling/playwright/playwright.config.d.mts",
 		"tooling/prettier/index.mjs",
 		"tooling/prettier/index.d.mts",
 		"tooling/typescript/*.json",
 		"tooling/typescript/reset.d.ts",
+		"tooling/vite/vite.config.mjs",
+		"tooling/vite/vite.config.d.mts",
 		"tooling/vitest/vitest.config.mjs",
 		"tooling/vitest/vitest.config.d.mts",
 		"tooling/vitest/vitest.config.react.mjs",
@@ -88,6 +92,10 @@
 			"types": "./tooling/jest-presets/node/jest-preset.d.mts",
 			"import": "./tooling/jest-presets/node/jest-preset.mjs"
 		},
+		"./playwright": {
+			"types": "./tooling/playwright/playwright.config.d.mts",
+			"import": "./tooling/playwright/playwright.config.mjs"
+		},
 		"./prettier": {
 			"types": "./tooling/prettier/index.d.mts",
 			"import": "./tooling/prettier/index.mjs"
@@ -99,6 +107,10 @@
 		"./typescript/react": "./tooling/typescript/tsconfig.react.json",
 		"./typescript/test": "./tooling/typescript/tsconfig.test.json",
 		"./typescript/reset": "./tooling/typescript/reset.d.ts",
+		"./vite": {
+			"types": "./tooling/vite/vite.config.d.mts",
+			"import": "./tooling/vite/vite.config.mjs"
+		},
 		"./vitest/config": {
 			"types": "./tooling/vitest/vitest.config.d.mts",
 			"import": "./tooling/vitest/vitest.config.mjs"

package/tooling/commitlint/commitlint.mjs

@@ -20,8 +20,9 @@ export default {
 				"test",
 			],
 		],
-		// Enforce length limits (strict)
-		"header-max-length": [2, "always", 50],
+		// Enforce length limits: 72 chars matches the conventional-commits
+		// recommendation and git's default email format
+		"header-max-length": [2, "always", 72],
 		"body-max-line-length": [2, "always", 72],
 		"footer-max-line-length": [2, "always", 72],
 		// Enforce case rules (allow common patterns)

package/tooling/playwright/playwright.config.d.mts

@@ -0,0 +1,4 @@
+import type { PlaywrightTestConfig } from '@playwright/test'
+
+declare const config: PlaywrightTestConfig
+export default config

package/tooling/playwright/playwright.config.mjs

@@ -0,0 +1,19 @@
+import { defineConfig, devices } from '@playwright/test'
+
+export default defineConfig({
+	testDir: './tests/e2e',
+	fullyParallel: true,
+	forbidOnly: !!process.env.CI,
+	retries: process.env.CI ? 2 : 0,
+	workers: process.env.CI ? 1 : undefined,
+	reporter: 'html',
+	use: {
+		baseURL: process.env.PLAYWRIGHT_BASE_URL ?? 'http://localhost:3000',
+		trace: 'on-first-retry',
+	},
+	projects: [
+		{ name: 'chromium', use: { ...devices['Desktop Chrome'] } },
+		{ name: 'firefox', use: { ...devices['Desktop Firefox'] } },
+		{ name: 'webkit', use: { ...devices['Desktop Safari'] } },
+	],
+})

package/tooling/vite/vite.config.d.mts

@@ -0,0 +1,4 @@
+import type { UserConfig } from 'vite'
+
+declare const config: UserConfig
+export default config

package/tooling/vite/vite.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+	resolve: {
+		alias: {
+			'@': '/src',
+			'~': '/src',
+		},
+	},
+	build: {
+		outDir: 'dist',
+		sourcemap: true,
+	},
+	server: {
+		port: 3000,
+		open: true,
+	},
+})