create-hsi-app 0.1.4 → 0.2.0

package/README.md

@@ -0,0 +1,35 @@
+# create-hsi-app
+
+Scaffold a new Vite + React + TypeScript app from the frontend template.
+
+## Usage
+
+### npm
+
+```bash
+npm create hsi-app@latest
+```
+
+### yarn
+
+```bash
+yarn create hsi-app
+```
+
+### pnpm
+
+```bash
+pnpm create hsi-app@latest
+```
+
+### bun
+
+```bash
+bun create hsi-app@latest
+```
+
+Pass the package manager flag after the initializer:
+
+```bash
+npm create hsi-app@latest -- --pnpm
+```

package/bin/create-hsi-app.mjs

@@ -10,9 +10,12 @@ import {
 import { basename, join, resolve } from 'node:path';
 
 const templateRepo = 'https://github.com/Hsiii/frontend-template.git';
-const templateTag = 'v0.1.4';
+const templateTag = 'v0.2.0';
 const defaultAppName = 'my-app';
-const targetArg = process.argv[2] ?? defaultAppName;
+const packageManagers = ['bun', 'npm', 'pnpm', 'yarn'];
+const rawArgs = process.argv.slice(2);
+const selectedPackageManager = parsePackageManagerFlag(rawArgs);
+const targetArg = rawArgs.find((arg) => !arg.startsWith('--')) ?? '.';
 const targetPath = resolve(targetArg);
 const appName = toPackageName(basename(targetPath));
 
@@ -34,18 +37,23 @@ run('git', [
 
 rmSync(join(targetPath, '.git'), { force: true, recursive: true });
 rmSync(join(targetPath, '.github'), { force: true, recursive: true });
+rmSync(join(targetPath, 'docs'), { force: true, recursive: true });
 rmSync(join(targetPath, 'packages'), { force: true, recursive: true });
+rmSync(join(targetPath, 'scripts'), { force: true, recursive: true });
 
 updatePackageJson();
 updateBunLock();
 updateAppText();
+updatePackageManagerFiles();
 writeAppReadme();
 
 console.log(`\nCreated ${appName} in ${targetPath}\n`);
 console.log('Next steps:');
-console.log(`  cd ${targetArg}`);
-console.log('  bun i');
-console.log('  bun run dev');
+if (targetArg !== '.') {
+    console.log(`  cd ${targetArg}`);
+}
+console.log(`  ${installCommand()}`);
+console.log(`  ${devCommand()}`);
 
 function run(command, args) {
     try {
@@ -63,9 +71,12 @@ function updatePackageJson() {
     packageJson.version = '0.1.0';
     delete packageJson.repository;
     delete packageJson.publishConfig;
-    delete packageJson.scripts['check:create'];
+    delete packageJson.packageManager;
+    delete packageJson.engines;
+    delete packageJson.scripts.release;
     packageJson.scripts.check =
-        'bun run typecheck && bun run lint && bun run format:check && bun run build';
+        'tsc -p tsconfig.json --noEmit && eslint . && prettier . --check && vite build';
+    packageJson.packageManager = packageManagerDeclaration();
 
     writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 4)}\n`);
 }
@@ -77,6 +88,11 @@ function updateBunLock() {
         return;
     }
 
+    if (selectedPackageManager !== 'bun') {
+        rmSync(lockPath, { force: true });
+        return;
+    }
+
     const lock = readFileSync(lockPath, 'utf8').replace(
         '"name": "frontend-template"',
         `"name": "${appName}"`
@@ -102,7 +118,44 @@ function updateAppText() {
     );
 }
 
+function updatePackageManagerFiles() {
+    rmSync(join(targetPath, 'bunfig.toml'), { force: true });
+    rmSync(join(targetPath, '.npmrc'), { force: true });
+    rmSync(join(targetPath, 'pnpm-workspace.yaml'), { force: true });
+    rmSync(join(targetPath, '.yarnrc.yml'), { force: true });
+
+    switch (selectedPackageManager) {
+        case 'bun':
+            writeFileSync(
+                join(targetPath, 'bunfig.toml'),
+                '[install]\nminimumReleaseAge = 604800\n'
+            );
+            return;
+        case 'npm':
+            writeFileSync(join(targetPath, '.npmrc'), 'min-release-age=7\n');
+            return;
+        case 'pnpm':
+            writeFileSync(
+                join(targetPath, 'pnpm-workspace.yaml'),
+                'minimumReleaseAge: 10080\n'
+            );
+            return;
+        case 'yarn':
+            writeFileSync(
+                join(targetPath, '.yarnrc.yml'),
+                'npmMinimalAgeGate: 7d\n'
+            );
+            return;
+        default:
+            fail(`Unsupported package manager: ${selectedPackageManager}`);
+    }
+}
+
 function writeAppReadme() {
+    const installLine = installCommand();
+    const devLine = devCommand();
+    const checkLine = checkCommand();
+    const securityNote = securityNoteForPackageManager();
     const readme = `# ${appName}
 
 Created from the frontend template.
@@ -110,20 +163,22 @@ Created from the frontend template.
 ## Install
 
 \`\`\`bash
-bun i
+${installLine}
 \`\`\`
 
 ## Develop
 
 \`\`\`bash
-bun run dev
+${devLine}
 \`\`\`
 
 ## Check
 
 \`\`\`bash
-bun run check
+${checkLine}
 \`\`\`
+
+${securityNote}
 `;
 
     writeFileSync(join(targetPath, 'README.md'), readme);
@@ -146,6 +201,101 @@ function toPackageName(value) {
     return name || defaultAppName;
 }
 
+function parsePackageManagerFlag(args) {
+    const selectedFlags = args.filter((arg) =>
+        ['--bun', '--npm', '--pnpm', '--yarn'].includes(arg)
+    );
+
+    if (selectedFlags.length > 1) {
+        fail('Pass only one of --bun, --npm, --pnpm, or --yarn.');
+    }
+
+    switch (selectedFlags[0]) {
+        case '--npm':
+            return 'npm';
+        case '--pnpm':
+            return 'pnpm';
+        case '--yarn':
+            return 'yarn';
+        case '--bun':
+        case undefined:
+            return 'bun';
+        default:
+            fail(`Unsupported package manager flag: ${selectedFlags[0]}`);
+    }
+}
+
+function packageManagerDeclaration() {
+    switch (selectedPackageManager) {
+        case 'bun':
+            return 'bun@1.3.9';
+        case 'npm':
+            return 'npm@11';
+        case 'pnpm':
+            return 'pnpm@10';
+        case 'yarn':
+            return 'yarn@4';
+        default:
+            fail(`Unsupported package manager: ${selectedPackageManager}`);
+    }
+}
+
+function installCommand() {
+    switch (selectedPackageManager) {
+        case 'bun':
+            return 'bun install';
+        case 'npm':
+            return 'npm install';
+        case 'pnpm':
+            return 'pnpm install';
+        case 'yarn':
+            return 'yarn install';
+        default:
+            fail(`Unsupported package manager: ${selectedPackageManager}`);
+    }
+}
+
+function devCommand() {
+    switch (selectedPackageManager) {
+        case 'yarn':
+            return 'yarn dev';
+        case 'bun':
+        case 'npm':
+        case 'pnpm':
+            return `${selectedPackageManager} run dev`;
+        default:
+            fail(`Unsupported package manager: ${selectedPackageManager}`);
+    }
+}
+
+function checkCommand() {
+    switch (selectedPackageManager) {
+        case 'yarn':
+            return 'yarn check';
+        case 'bun':
+        case 'npm':
+        case 'pnpm':
+            return `${selectedPackageManager} run check`;
+        default:
+            fail(`Unsupported package manager: ${selectedPackageManager}`);
+    }
+}
+
+function securityNoteForPackageManager() {
+    switch (selectedPackageManager) {
+        case 'bun':
+            return 'This project includes `bunfig.toml` with `minimumReleaseAge = 604800`.';
+        case 'npm':
+            return 'This project includes `.npmrc` with `min-release-age=7`.';
+        case 'pnpm':
+            return 'This project includes `pnpm-workspace.yaml` with `minimumReleaseAge: 10080`.';
+        case 'yarn':
+            return 'This project includes `.yarnrc.yml` with `npmMinimalAgeGate: 7d`.';
+        default:
+            fail(`Unsupported package manager: ${selectedPackageManager}`);
+    }
+}
+
 function fail(message) {
     console.error(`create-hsi-app: ${message}`);
     process.exit(1);

package/package.json

@@ -1,13 +1,14 @@
 {
     "name": "create-hsi-app",
-    "version": "0.1.4",
+    "version": "0.2.0",
     "type": "module",
     "description": "Create a new app from the frontend template.",
     "bin": {
         "create-hsi-app": "bin/create-hsi-app.mjs"
     },
     "files": [
-        "bin"
+        "bin",
+        "README.md"
     ],
     "engines": {
         "node": ">=18"