@rtorcato/js-tooling 1.0.6

package/dist/cli/generators/readme.js

@@ -0,0 +1,224 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function generateReadme(config, targetDir) {
+    const readmePath = path.join(targetDir, 'README.md');
+    const readme = `# ${config.projectName}
+
+> Generated with [@rtorcato/js-tooling](https://www.npmjs.com/package/@rtorcato/js-tooling)
+
+## Description
+
+Your project description here.
+
+## Installation
+
+\`\`\`bash
+# Using pnpm (recommended)
+pnpm install
+
+# Using npm
+npm install
+
+# Using yarn
+yarn install
+\`\`\`
+
+## Development
+
+${generateDevelopmentSection(config)}
+
+## Testing
+
+${generateTestingSection(config)}
+
+## Building
+
+${generateBuildingSection(config)}
+
+## Scripts
+
+${generateScriptsSection(config)}
+
+## Project Structure
+
+\`\`\`
+${config.projectName}/
+├── src/                 # Source code
+${config.typescript.enabled ? '├── reset.d.ts           # TypeScript reset types' : ''}
+${config.testing.framework !== 'none' ? '├── tests/              # Test files' : ''}
+├── dist/               # Build output${config.projectType === 'library' ? ' (library)' : ''}
+├── package.json
+${config.typescript.enabled ? '├── tsconfig.json        # TypeScript configuration' : ''}
+${config.linting.tool === 'biome' || config.linting.tool === 'both' ? '├── biome.jsonc          # Biome configuration' : ''}
+${config.linting.tool === 'eslint' || config.linting.tool === 'both' ? '├── eslint.config.mjs    # ESLint configuration' : ''}
+${config.linting.tool === 'eslint' ? '├── prettier.config.mjs  # Prettier configuration' : ''}
+${config.testing.framework === 'vitest' ? '├── vitest.config.ts     # Vitest configuration' : ''}
+${config.testing.framework === 'jest' ? '├── jest.config.mjs     # Jest configuration' : ''}
+${config.testing.framework === 'playwright' ? '├── playwright.config.ts # Playwright configuration' : ''}
+${config.bundler === 'tsup' ? '├── tsup.config.ts       # tsup configuration' : ''}
+${config.bundler === 'esbuild' ? '├── build.mjs           # esbuild configuration' : ''}
+${config.bundler === 'vite' ? '├── vite.config.ts       # Vite configuration' : ''}
+${config.commitLint ? '├── commitlint.config.mjs # Commitlint configuration' : ''}
+${config.gitHooks ? '├── .husky/             # Git hooks' : ''}
+└── README.md
+\`\`\`
+
+## Tooling
+
+This project uses:
+
+${generateToolingList(config)}
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (\`git checkout -b feature/amazing-feature\`)
+3. Commit your changes (\`git commit -m 'feat: add amazing feature'\`)
+4. Push to the branch (\`git push origin feature/amazing-feature\`)
+5. Open a Pull Request
+
+${config.commitLint
+        ? `
+### Commit Convention
+
+This project follows [Conventional Commits](https://conventionalcommits.org/):
+
+- \`feat:\` new features
+- \`fix:\` bug fixes
+- \`docs:\` documentation changes
+- \`style:\` formatting changes
+- \`refactor:\` code refactoring
+- \`test:\` adding or updating tests
+- \`chore:\` maintenance tasks
+`
+        : ''}
+
+## License
+
+[Add your license here]
+`;
+    await fs.writeFile(readmePath, readme);
+}
+function generateDevelopmentSection(config) {
+    const sections = [];
+    if (config.bundler === 'vite') {
+        sections.push('```bash\npnpm dev\n```');
+    }
+    else {
+        sections.push('Start development by running your preferred development server.');
+    }
+    if (config.linting.tool !== 'none') {
+        const lintCommand = config.linting.tool === 'biome' || config.linting.tool === 'both'
+            ? 'pnpm check:fix'
+            : 'pnpm lint:fix';
+        sections.push(`\n### Linting & Formatting\n\n\`\`\`bash\n${lintCommand}\n\`\`\``);
+    }
+    if (config.typescript.enabled) {
+        sections.push('\n### Type Checking\n\n```bash\npnpm typecheck\n```');
+    }
+    return sections.length > 0 ? sections.join('\n') : 'No specific development commands configured.';
+}
+function generateTestingSection(config) {
+    if (config.testing.framework === 'none') {
+        return 'No testing framework configured.';
+    }
+    const commands = [];
+    if (config.testing.framework === 'vitest') {
+        commands.push('pnpm test          # Run tests');
+        commands.push('pnpm test:watch    # Run tests in watch mode');
+        commands.push('pnpm test:ui       # Run tests with UI');
+        commands.push('pnpm coverage      # Generate coverage report');
+    }
+    else if (config.testing.framework === 'jest') {
+        commands.push('pnpm test          # Run tests');
+        commands.push('pnpm test:watch    # Run tests in watch mode');
+        commands.push('pnpm coverage      # Generate coverage report');
+    }
+    else if (config.testing.framework === 'playwright') {
+        commands.push('pnpm test:e2e      # Run E2E tests');
+        commands.push('pnpm test:e2e:ui   # Run E2E tests with UI');
+    }
+    return `\`\`\`bash\n${commands.join('\n')}\n\`\`\``;
+}
+function generateBuildingSection(config) {
+    if (config.bundler === 'none') {
+        return 'No build configuration set up.';
+    }
+    return '```bash\npnpm build\n```';
+}
+function generateScriptsSection(config) {
+    const scripts = [];
+    scripts.push('- `pnpm install` - Install dependencies');
+    if (config.typescript.enabled) {
+        scripts.push('- `pnpm typecheck` - Type check TypeScript');
+    }
+    if (config.linting.tool !== 'none') {
+        if (config.linting.tool === 'biome' || config.linting.tool === 'both') {
+            scripts.push('- `pnpm lint` - Lint code with Biome');
+            scripts.push('- `pnpm format` - Format code with Biome');
+            scripts.push('- `pnpm check:fix` - Lint and format with Biome');
+        }
+        if (config.linting.tool === 'eslint' || config.linting.tool === 'both') {
+            scripts.push('- `pnpm lint` - Lint code with ESLint');
+            scripts.push('- `pnpm lint:fix` - Fix ESLint issues');
+            scripts.push('- `pnpm format` - Format code with Prettier');
+        }
+    }
+    if (config.testing.framework !== 'none') {
+        scripts.push('- `pnpm test` - Run tests');
+        if (config.testing.framework === 'vitest') {
+            scripts.push('- `pnpm test:watch` - Run tests in watch mode');
+            scripts.push('- `pnpm coverage` - Generate test coverage');
+        }
+    }
+    if (config.bundler !== 'none') {
+        scripts.push('- `pnpm build` - Build for production');
+    }
+    return scripts.join('\n');
+}
+function generateToolingList(config) {
+    const tools = [];
+    if (config.typescript.enabled) {
+        tools.push('- **TypeScript** - Type-safe JavaScript');
+    }
+    if (config.linting.tool === 'biome') {
+        tools.push('- **Biome** - Fast formatter and linter');
+    }
+    else if (config.linting.tool === 'eslint') {
+        tools.push('- **ESLint** - Linting utility');
+        tools.push('- **Prettier** - Code formatter');
+    }
+    else if (config.linting.tool === 'both') {
+        tools.push('- **Biome** - Fast formatter and linter');
+        tools.push('- **ESLint** - Additional linting rules');
+    }
+    if (config.testing.framework === 'vitest') {
+        tools.push('- **Vitest** - Fast testing framework');
+    }
+    else if (config.testing.framework === 'jest') {
+        tools.push('- **Jest** - Testing framework');
+    }
+    else if (config.testing.framework === 'playwright') {
+        tools.push('- **Playwright** - End-to-end testing');
+    }
+    if (config.bundler === 'tsup') {
+        tools.push('- **tsup** - TypeScript bundler');
+    }
+    else if (config.bundler === 'esbuild') {
+        tools.push('- **esbuild** - Fast JavaScript bundler');
+    }
+    else if (config.bundler === 'vite') {
+        tools.push('- **Vite** - Fast build tool');
+    }
+    if (config.gitHooks) {
+        tools.push('- **Husky** - Git hooks');
+        tools.push('- **lint-staged** - Run linters on staged files');
+    }
+    if (config.commitLint) {
+        tools.push('- **Commitlint** - Conventional commit linting');
+    }
+    if (config.semanticRelease) {
+        tools.push('- **Semantic Release** - Automated versioning and publishing');
+    }
+    return tools.join('\n');
+}

package/dist/cli/generators/testing.js

@@ -0,0 +1,78 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function generateTestingConfigs(config, targetDir) {
+    if (config.testing.framework === 'vitest') {
+        await generateVitestConfig(config, targetDir);
+    }
+    else if (config.testing.framework === 'jest') {
+        await generateJestConfig(config, targetDir);
+    }
+    else if (config.testing.framework === 'playwright') {
+        await generatePlaywrightConfig(targetDir);
+    }
+}
+async function generateVitestConfig(config, targetDir) {
+    const vitestConfigPath = path.join(targetDir, 'vitest.config.ts');
+    const vitestConfig = `import { defineConfig } from 'vitest/config'
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: '${config.testing.environment === 'browser' ? 'jsdom' : 'node'}',
+    setupFiles: ['./vitest.setup.ts']
+  }
+})
+`;
+    await fs.writeFile(vitestConfigPath, vitestConfig);
+    // Create setup file
+    const setupPath = path.join(targetDir, 'vitest.setup.ts');
+    const setupContent = `// Vitest setup file
+// Add global test setup here
+`;
+    await fs.writeFile(setupPath, setupContent);
+}
+async function generateJestConfig(config, targetDir) {
+    const jestConfigPath = path.join(targetDir, 'jest.config.mjs');
+    const environment = config.testing.environment === 'browser' ? 'browser' : 'node';
+    const jestConfig = `export { default } from '@rtorcato/js-tooling/jest-presets/${environment}/jest-preset'
+`;
+    await fs.writeFile(jestConfigPath, jestConfig);
+}
+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,
+  },
+})
+`;
+    await fs.writeFile(playwrightConfigPath, playwrightConfig);
+}

package/dist/cli/generators/tsconfig.js

@@ -0,0 +1,28 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+export async function generateTSConfig(config, targetDir) {
+    const tsconfigPath = path.join(targetDir, 'tsconfig.json');
+    // Base configuration extends our tooling
+    const tsconfig = {
+        extends: `@rtorcato/js-tooling/typescript/${config.typescript.config}`,
+        compilerOptions: {
+            baseUrl: '.',
+            paths: {
+                '@/*': ['./src/*'],
+                '~/*': ['./src/*'],
+            },
+        },
+        include: ['src/**/*', 'reset.d.ts'],
+        exclude: ['node_modules', 'dist', 'build'],
+    };
+    // Adjust for project type
+    if (config.projectType === 'library') {
+        tsconfig.compilerOptions.outDir = './dist';
+        tsconfig.compilerOptions.rootDir = './src';
+    }
+    if (config.projectType === 'nextjs-app') {
+        tsconfig.include = ['next-env.d.ts', 'src', 'app', 'pages', 'components', 'reset.d.ts'];
+        tsconfig.exclude.push('.next');
+    }
+    await fs.writeJson(tsconfigPath, tsconfig, { spaces: 2 });
+}

package/dist/cli/index.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import chalk from 'chalk';
+import { Command } from 'commander';
+import packageJson from '../../package.json' with { type: 'json' };
+import { setupProject } from './commands/setup.js';
+const program = new Command();
+program
+    .name('@rtorcato/js-tooling')
+    .description('🛠️  JavaScript and TypeScript tooling setup for modern projects')
+    .version(packageJson.version);
+program
+    .command('setup')
+    .alias('init')
+    .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')
+    .action(setupProject);
+program
+    .command('list')
+    .alias('ls')
+    .description('📋 List all available tooling configurations')
+    .action(() => {
+    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: 'Semantic Release', desc: 'Automated versioning and publishing' },
+        { name: 'tsup', desc: 'TypeScript bundler configuration' },
+        { name: 'esbuild', desc: 'Fast JavaScript bundler configuration' },
+    ];
+    configs.forEach(({ name, desc }) => {
+        console.log(`  ${chalk.green('●')} ${chalk.bold(name)}: ${chalk.gray(desc)}`);
+    });
+    console.log(chalk.dim('\n💡 Run "js-tooling setup" to configure your project\n'));
+});
+// Handle unknown commands
+program.on('command:*', () => {
+    console.error(chalk.red(`\n❌ Unknown command: ${program.args.join(' ')}`));
+    console.log(chalk.gray('See --help for a list of available commands.\n'));
+    process.exit(1);
+});
+// Show help if no arguments
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}
+program.parse();

package/dist/cli/utils/install.js

@@ -0,0 +1,28 @@
+import chalk from 'chalk';
+import { spawn } from 'node:child_process';
+export async function installDependencies(_config, targetDir) {
+    return new Promise((resolve) => {
+        console.log(chalk.blue('📦 Installing dependencies with pnpm...'));
+        const child = spawn('pnpm', ['install'], {
+            cwd: targetDir,
+            stdio: 'inherit',
+            shell: true,
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                console.log(chalk.green('✅ Dependencies installed successfully!'));
+                resolve();
+            }
+            else {
+                console.error(chalk.red(`❌ pnpm install failed with code ${code}`));
+                console.log(chalk.yellow('💡 You can install dependencies manually with: pnpm install'));
+                resolve(); // Don't reject, just warn
+            }
+        });
+        child.on('error', (error) => {
+            console.error(chalk.red('❌ Error running pnpm install:'), error.message);
+            console.log(chalk.yellow('💡 You can install dependencies manually with: pnpm install'));
+            resolve(); // Don't reject, just warn
+        });
+    });
+}

package/package.json

@@ -0,0 +1,160 @@
+{
+	"name": "@rtorcato/js-tooling",
+	"version": "1.0.6",
+	"description": "JavaScript and TypeScript tooling for Node.js, React, Next.js, and Vitest.",
+	"type": "module",
+	"keywords": [
+		"tooling",
+		"typescript",
+		"eslint"
+	],
+	"author": "Richard Torcato",
+	"sideEffects": false,
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/rtorcato/js-tooling.git"
+	},
+	"homepage": "https://github.com/rtorcato/js-tooling#readme",
+	"bugs": {
+		"url": "https://github.com/rtorcato/js-tooling/issues"
+	},
+	"scripts": {
+		"build-dev": "rimraf ./dist && cross-env NODE_ENV=development node build.mjs && tsc --emitDeclarationOnly --project tsconfig.build.json && pnpm build-cli",
+		"build-prod": "rimraf ./dist && cross-env NODE_ENV=production node build.mjs && tsc --emitDeclarationOnly --project tsconfig.build.json && pnpm build-cli",
+		"build-cli": "rimraf ./dist/cli && tsc --project src/cli/tsconfig.json",
+		"prepublishOnly": "./scripts/fix-bins.sh",
+		"==================== Common ====================": "",
+		"lint": "pnpm exec biome lint .",
+		"format": "pnpm exec biome format .",
+		"check:fix": "pnpm exec biome check --fix",
+		"check": "pnpm exec biome check .",
+		"prepare": "is-ci || husky",
+		"typecheck1": "tsc --noEmit",
+		"test": "vitest",
+		"test:watch": "vitest --watch",
+		"coverage": "vitest run --coverage",
+		"commit": "cz",
+		"================================================": ""
+	},
+	"files": [
+		"dist/cli/**/*.js",
+		"tooling/*",
+		"tooling/commitlint/commitlint.config.mjs",
+		"tooling/esbuild/index.mjs",
+		"tooling/eslint/*.mjs",
+		"tooling/jest-presets/**",
+		"tooling/prettier/index.mjs",
+		"tooling/typescript/*.json",
+		"tooling/typescript/reset.d.ts",
+		"tooling/vitest/vitest.config.mjs",
+		"tooling/tsup/index.ts",
+		"tooling/biome/biome.json",
+		"tooling/semantic-release/*.mjs",
+		"README.md"
+	],
+	"exports": {
+		"./commitlint/config": {
+			"import": "./tooling/commitlint/commitlint.mjs"
+		},
+		"./esbuild": "./tooling/esbuild/index.mjs",
+		"./eslint/base": "./tooling/eslint/base.mjs",
+		"./eslint/nextjs": "./tooling/eslint/nextjs.mjs",
+		"./jest-presets/browser/jest-preset": "./tooling/jest-presets/browser/jest-preset.mjs",
+		"./jest-presets/node/jest-preset": "./tooling/jest-presets/node/jest-preset.mjs",
+		"./prettier": "./tooling/prettier/index.mjs",
+		"./typescript/base": "./tooling/typescript/tsconfig.base.json",
+		"./typescript/next": "./tooling/typescript/tsconfig.next.json",
+		"./typescript/express": "./tooling/typescript/tsconfig.express.json",
+		"./typescript/node": "./tooling/typescript/tsconfig.node.json",
+		"./typescript/react": "./tooling/typescript/tsconfig.react.json",
+		"./typescript/test": "./tooling/typescript/tsconfig.test.json",
+		"./typescript/reset": "./tooling/typescript/reset.d.ts",
+		"./vitest/config": "./tooling/vitest/vitest.config.mjs",
+		"./tsup": "./tooling/tsup/index.ts",
+		"./biome": "./tooling/biome/biome.json",
+		"./semantic-release": "./tooling/semantic-release/index.mjs",
+		"./semantic-release/github": "./tooling/semantic-release/github.mjs",
+		"./semantic-release/docker": "./tooling/semantic-release/docker.mjs"
+	},
+	"dependencies": {
+		"@biomejs/biome": "^2.3.0",
+		"@commitlint/cli": "^20.1.0",
+		"@commitlint/config-conventional": "^20.0.0",
+		"@playwright/test": "^1.56.1",
+		"@semantic-release/commit-analyzer": "^13.0.1",
+		"@semantic-release/exec": "^7.1.0",
+		"@semantic-release/git": "^10.0.1",
+		"@semantic-release/npm": "^13.1.1",
+		"@semantic-release/release-notes-generator": "^14.1.0",
+		"@total-typescript/ts-reset": "0.6.1",
+		"@types/node": "^24.9.1",
+		"@typescript-eslint/eslint-plugin": "^8.46.2",
+		"@typescript-eslint/parser": "^8.46.2",
+		"@vitejs/plugin-react": "^5.1.0",
+		"chalk": "^5.6.2",
+		"commander": "^14.0.1",
+		"commitizen": "^4.3.1",
+		"conventional-changelog-conventionalcommits": "^9.1.0",
+		"cz-conventional-changelog": "^3.3.0",
+		"esbuild": "^0.25.11",
+		"esbuild-node-externals": "^1.18.0",
+		"fs-extra": "^11.3.2",
+		"husky": "^9.1.7",
+		"inquirer": "^12.10.0",
+		"lint-staged": "^16.2.6",
+		"semantic-release": "^25.0.1",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "latest",
+		"vitest": "4.0.2"
+	},
+	"devDependencies": {
+		"@next/eslint-plugin-next": "^16.0.0",
+		"@semantic-release/changelog": "^6.0.3",
+		"@semantic-release/github": "^12.0.0",
+		"@types/fs-extra": "^11.0.4",
+		"@types/inquirer": "^9.0.9",
+		"cross-env": "^10.1.0",
+		"eslint": "9.38.0",
+		"eslint-config-airbnb": "^19.0.4",
+		"eslint-config-prettier": "10.1.8",
+		"eslint-config-turbo": "^2.5.8",
+		"eslint-plugin-import": "^2.32.0",
+		"eslint-plugin-jest": "29.0.1",
+		"eslint-plugin-jsx-a11y": "^6.10.2",
+		"eslint-plugin-react": "^7.37.5",
+		"eslint-plugin-react-hooks": "^7.0.0",
+		"eslint-plugin-vitest": "0.5.4",
+		"is-ci": "^4.1.0",
+		"prettier": "^3.6.2",
+		"prettier-plugin-tailwindcss": "^0.7.1",
+		"rimraf": "6.0.1",
+		"ts-jest": "^29.4.5",
+		"tsup": "8.5.0"
+	},
+	"lint-staged": {
+		"*.{js,ts,json,md}": [
+			"pnpm exec biome lint",
+			"pnpm exec biome format",
+			"git add"
+		]
+	},
+	"husky": {
+		"hooks": {
+			"pre-commit": "lint-staged"
+		}
+	},
+	"bin": {
+		"js-tooling": "./dist/cli/index.js",
+		"commitmessage": "scripts/commitmessage.sh",
+		"helloworld": "scripts/helloworld.sh"
+	},
+	"config": {
+		"commitizen": {
+			"path": "cz-conventional-changelog"
+		}
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/scripts/README.md

@@ -0,0 +1,8 @@
+pnpx js-tooling commitmessage
+pnpx js-tooling version-bump
+pnpx js-tooling genpassword
+
+<!-- run before publish -->
+pnpm exec ./scripts/fix-bins.sh
+
+pnpm link --global

package/scripts/commitmessage.sh

@@ -0,0 +1,44 @@
+#!/usr/bin/env bash
+
+# chmod +x scripts/commitmessage.sh
+set -e
+
+echo "Select commit type by number:"
+select type in "feat" "fix" "perf" "ci" "WIP" "chore" "docs" "test" "style" "refactor" "build" "BREAKING CHANGE" "revert"; do
+    if [ -n "$type" ]; then
+        break
+    else
+        echo "❌ Invalid selection. Try again."
+    fi
+done
+
+if [[ "$type" =~ ^(feat|fix|perf)$ ]]; then
+    echo "Select semantic version by number:"
+    select semantic_version in "none" "patch" "minor" "major"; do
+        [ -n "$semantic_version" ] && break
+    done
+else
+    semantic_version="none"
+fi
+
+read -p "Enter commit description: " description
+read -p "Skip CI? (y/n) [n]: " skip_ci
+skip_ci=${skip_ci:-n}
+
+msg="$type"
+[ "$semantic_version" != "none" ] && msg="$msg($semantic_version)"
+msg="$msg: $description"
+[ "$skip_ci" = "y" ] && msg="$msg [skip ci]"
+
+echo ""
+echo "🔍 Commit preview:"
+echo "$msg"
+read -p "Is this okay? (y/n): " confirm
+[ "$confirm" != "y" ] && echo "❌ Commit aborted." && exit 1
+
+git add -A
+git commit -m "$msg"
+
+echo ""
+read -p "Do you want to push the commit? (y/n): " push_confirm
+[ "$push_confirm" = "y" ] && git push || echo "🚫 Commit not pushed."

package/scripts/helloworld.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+# chmod +x scripts/helloworld.sh
+
+echo "👋 Hello, world from js-tooling!"

package/tooling/biome/biome.jsonc

@@ -0,0 +1,47 @@
+{
+	"root": false,
+	"$schema": "https://biomejs.dev/schemas/2.3.0/schema.json",
+	"vcs": {
+		"enabled": false,
+		"clientKind": "git",
+		"useIgnoreFile": true
+	},
+	"files": {
+		"ignoreUnknown": false,
+		"includes": [
+			"**",
+			"!**/node_modules",
+			"!**/package.json",
+			"!**/tsconfig*.json",
+			"!**/dist",
+			"!**/coverage",
+			"!**/.git",
+			"!**/.github",
+			"!**/.vscode"
+		]
+	},
+	"formatter": {
+		"enabled": true,
+		"indentStyle": "tab",
+		"lineWidth": 100
+	},
+	"assist": { "actions": { "source": { "organizeImports": "on" } } },
+	"linter": {
+		"enabled": true,
+		"rules": {
+			"recommended": true,
+			"style": {
+				"noInferrableTypes": "off"
+			}
+			// "noUnusedVariables": "error", ❌ Not supported yet
+			// "noExplicitAny": "warn"       ❌ Not supported yet
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"quoteStyle": "single",
+			"trailingCommas": "es5",
+			"semicolons": "asNeeded"
+		}
+	}
+}