@rshono/create 1.0.0-rc.0 → 1.0.0-rc.10

package/dist/cli.mjs

@@ -6,7 +6,7 @@ import { parseArgs, styleText as external_node_util_styleText } from "node:util"
 import node_process, { stdin as external_node_process_stdin, stdout as external_node_process_stdout } from "node:process";
 import node_readline from "node:readline";
 import "node:tty";
-import { existsSync as external_node_fs_existsSync, mkdirSync, readFileSync, readdirSync as external_node_fs_readdirSync, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync, readdirSync as external_node_fs_readdirSync, statSync, writeFileSync } from "node:fs";
 import { basename, dirname as external_node_path_dirname, join as external_node_path_join, posix, relative as external_node_path_relative, resolve, sep } from "node:path";
 import { spawnSync } from "node:child_process";
 var __webpack_modules__ = ({
@@ -2943,7 +2943,11 @@ function hasGit(cwd) {
 
 ;// CONCATENATED MODULE: ./src/generated/framework.ts
 // GENERATED by scripts/codegen.mjs from packages/core — do not edit. Run `pnpm --filter @rshono/create codegen`.
-/** The framework release a scaffolded app is pinned to: this package and rshono ship together. */ const RSHONO_VERSION = '1.0.0-rc.0';
+/** The framework release a scaffolded app is pinned to: this package and rshono ship together. */ const RSHONO_VERSION = '1.0.0-rc.10';
+/**
+ * The Node range rshono itself declares, restated in every scaffolded app's `engines` — so a CI image
+ * or a contributor on an older Node hears it from their package manager rather than from a stack trace.
+ */ const NODE_ENGINE = '>=22.18.0';
 /**
  * The dependency versions rshono is tested against, copied from its own manifest. Exact where it is
  * exact — React's RSC internals are coupled across builds, and a generated app has no workspace
@@ -2965,22 +2969,10 @@ function hasGit(cwd) {
         name: 'cloudflare',
         hint: 'deploy with `wrangler deploy`'
     },
-    {
-        name: 'bun',
-        hint: 'run `bun dist/server/main.mjs`'
-    },
-    {
-        name: 'deno',
-        hint: 'run `deno serve -A dist/server/main.mjs`'
-    },
     {
         name: 'vercel',
         hint: 'deploy with `vercel deploy --prebuilt`'
     },
-    {
-        name: 'netlify',
-        hint: 'deploy with `netlify deploy --build=false --dir=.netlify/publish`'
-    },
     {
         name: 'aws-lambda',
         hint: 'zip dist/ with the handler at dist/server/main.mjs'
@@ -2989,19 +2981,32 @@ function hasGit(cwd) {
 
 ;// CONCATENATED MODULE: ./src/options.ts
 
-const PACKAGE_MANAGERS = (/* unused pure expression or super */ null && ([
+/*
+ * The names each option accepts, spelled once. The types below are derived from them, the CLI validates
+ * its flags against them and prints them in `--help`, and `pm.ts` recognises a package manager by them
+ * — so a name added here reaches all three without a second list to remember.
+ */ const FORMATTER_NAMES = [
+    'prettier',
+    'biome',
+    'oxfmt',
+    'none'
+];
+const LINTER_NAMES = [
+    'oxlint',
+    'eslint',
+    'biome',
+    'none'
+];
+const PACKAGE_MANAGERS = [
     'npm',
     'pnpm',
     'yarn',
     'bun'
-]));
+];
 const DEPLOY_TARGET_NAMES = DEPLOY_TARGETS.map((target)=>target.name);
 function deployHint(name) {
     return DEPLOY_TARGETS.find((target)=>target.name === name)?.hint ?? '';
 }
-function isDeployTarget(value) {
-    return DEPLOY_TARGET_NAMES.includes(value);
-}
 const QUALITY_PRESETS = [
     {
         id: 'prettier-oxlint',
@@ -3010,6 +3015,13 @@ const QUALITY_PRESETS = [
         formatter: 'prettier',
         linter: 'oxlint'
     },
+    {
+        id: 'prettier-eslint',
+        label: 'Prettier + ESLint',
+        hint: 'type-aware rules — pins TypeScript 6, which is all typescript-eslint accepts',
+        formatter: 'prettier',
+        linter: 'eslint'
+    },
     {
         id: 'biome',
         label: 'Biome',
@@ -3081,7 +3093,7 @@ const QUALITY_PRESETS = [
 
 ;// CONCATENATED MODULE: ./src/versions.ts
 
-
+/** Passed straight through, so everything generated from the framework reaches the rest of the package here. */ 
 /** The framework range a scaffolded app gets. The two packages are released together, so this is ours. */ const RSHONO_RANGE = `^${RSHONO_VERSION}`;
 /**
  * Versions for the optional tooling the features can add — the one place in this package where a
@@ -3102,20 +3114,36 @@ const QUALITY_PRESETS = [
     '@biomejs/biome': '^2.5.6',
     oxlint: '^1.76.0',
     oxfmt: '^0.61.0',
+    eslint: '^10.8.0',
+    // ESLint's own recommended JavaScript rules, which typescript-eslint layers on top of rather than
+    // replaces, and the rules of hooks — the one class of React mistake no type checker sees.
+    '@eslint/js': '^10.0.1',
+    'typescript-eslint': '^8.65.0',
+    'eslint-plugin-react-hooks': '^7.1.1',
     wrangler: '^4.115.0'
 };
+/**
+ * The TypeScript an ESLint app pins, in place of the framework's own — the one deliberate exception to
+ * {@link FRAMEWORK_DEPS}.
+ *
+ * typescript-eslint reads TypeScript's compiler API directly rather than through a stable interface,
+ * so it accepts `typescript >=4.8.4 <6.1.0` and nothing above; `~6.0.3` is the newest that satisfies
+ * it. rshono's declarations compile the same under either, which is what makes this an app's business
+ * and not the framework's.
+ *
+ * When upstream widens the range, this constant and the ESLint feature's use of it are what to delete.
+ */ const ESLINT_TYPESCRIPT = '~6.0.3';
 
 ;// CONCATENATED MODULE: ./src/features/deploy.ts
 
 /**
- * What a deploy target adds beyond the `deploy` line in `rshono.config.ts` — which is the build's job
- * to read, and the template's to carry.
+ * What a deploy target adds beyond the `deploy` line in `rshono.config.ts`, which the template carries.
  *
- * Deliberately thin. The framework already knows how to arrange its own output for every platform, and
- * `rshono build` writes the one platform config that has to exist (`wrangler.jsonc`, with the
- * `compatibility_date` of the day it ran) if the project has none. Generating a second copy here would
- * be a copy that goes stale. So a target contributes a `deploy` script, the CLI it needs locally, and
- * the build artefacts its platform leaves in the project.
+ * Deliberately thin: the framework arranges its own output for every platform, and `rshono build`
+ * writes the one platform config that has to exist (`wrangler.jsonc`, dated the day it ran) if the
+ * project has none — a second copy generated here would only go stale. So a target contributes the
+ * command that ships the build, the CLI that command needs, the directories to gitignore, and a note
+ * for the step no command covers. Several contribute just one of those.
  */ const DEPLOY_FEATURES = {
     // Where a Node build goes from here is a Dockerfile or a process manager, neither of which this can
     // guess — so the target contributes only the command that runs what was built.
@@ -3125,25 +3153,18 @@ const QUALITY_PRESETS = [
             start: 'rshono start'
         }
     },
-    // `rshono start` is the Node target's launcher and refuses a build made for another platform, so
-    // these two get the command their own runtime uses under the same script name.
-    bun: {
-        id: 'deploy-bun',
-        scripts: {
-            start: 'bun dist/server/main.mjs'
-        }
-    },
-    deno: {
-        id: 'deploy-deno',
-        scripts: {
-            start: 'deno serve -A dist/server/main.mjs'
-        }
-    },
     cloudflare: {
         id: 'deploy-cloudflare',
         devDependencies: {
             wrangler: TOOL_VERSIONS.wrangler
         },
+        // The only two install scripts a scaffolded app can end up with, and wrangler brings both. Each
+        // one merely picks the platform binary out of the optional dependency that already carries it, so
+        // neither needs to run — `workerd --version` and `esbuild --version` both answer without it.
+        allowBuilds: {
+            esbuild: false,
+            workerd: false
+        },
         scripts: {
             deploy: 'rshono build && wrangler deploy'
         },
@@ -3166,15 +3187,6 @@ const QUALITY_PRESETS = [
             '--prebuilt uploads what rshono build assembled; the platform must not rebuild it.'
         ]
     },
-    netlify: {
-        id: 'deploy-netlify',
-        scripts: {
-            deploy: 'rshono build && netlify deploy --build=false --dir=.netlify/publish'
-        },
-        gitignore: [
-            '.netlify/'
-        ]
-    },
     'aws-lambda': {
         id: 'deploy-aws-lambda',
         notes: [
@@ -3193,8 +3205,10 @@ function deployFeature(target) {
  * deduplicates by `id`, so `formatter: 'biome', linter: 'biome'` contributes one set of files, one
  * dependency and one pair of scripts.
  *
- * Each tool brings its own `check` script alongside `format`/`lint`, because the writing half and the
- * CI half want different exit-code behaviour: `format` rewrites files, `check` fails instead.
+ * A formatter brings `format:check` beside `format`, because the writing half and the CI half want
+ * different exit-code behaviour: `format` rewrites files, `format:check` fails instead. A linter brings
+ * `lint:fix` beside `lint`, for the same reason in the other direction — `lint` is already the failing
+ * one. Biome adds a `check` of its own, which is the pair of them in a single pass.
  */ const PRETTIER = {
     id: 'prettier',
     overlays: [
@@ -3234,6 +3248,29 @@ const OXLINT = {
         'lint:fix': 'oxlint --fix'
     }
 };
+/**
+ * The one feature that changes a dependency the framework otherwise decides: typescript-eslint cannot
+ * be installed alongside the TypeScript rshono is tested against, so an ESLint app pins the newest one
+ * its peer range accepts (see {@link ESLINT_TYPESCRIPT}). Its rules are type-aware — the reason to
+ * reach for ESLint over a syntax-only linter — so the config it ships hands the parser the whole
+ * program rather than linting file by file.
+ */ const ESLINT = {
+    id: 'eslint',
+    overlays: [
+        'eslint'
+    ],
+    devDependencies: {
+        eslint: TOOL_VERSIONS.eslint,
+        '@eslint/js': TOOL_VERSIONS["@eslint/js"],
+        'typescript-eslint': TOOL_VERSIONS["typescript-eslint"],
+        'eslint-plugin-react-hooks': TOOL_VERSIONS["eslint-plugin-react-hooks"],
+        typescript: (/* inlined export .ESLINT_TYPESCRIPT */"~6.0.3")
+    },
+    scripts: {
+        lint: 'eslint .',
+        'lint:fix': 'eslint . --fix'
+    }
+};
 const BIOME = {
     id: 'biome',
     overlays: [
@@ -3258,6 +3295,7 @@ const FORMATTERS = {
 };
 const LINTERS = {
     oxlint: OXLINT,
+    eslint: ESLINT,
     biome: BIOME,
     none: null
 };
@@ -3271,14 +3309,13 @@ function linterFeature(linter) {
 ;// CONCATENATED MODULE: ./src/features/styling.ts
 
 /**
- * Tailwind is a PostCSS plugin and nothing more, which is the whole of this feature: four packages, and
- * an overlay carrying the `postcss.config.mjs` naming the plugin, an `rshono.config.ts` whose `rspack`
- * hook puts postcss-loader in front of the CSS parser, a Tailwind entry stylesheet, and the two views
- * written in utilities instead of classes of their own.
+ * Tailwind is a PostCSS plugin and nothing more, which is the whole of this feature: four packages,
+ * plus an overlay carrying `postcss.config.mjs`, an `rshono.config.ts` whose `rspack` hook puts
+ * postcss-loader in front of the CSS parser, a Tailwind entry stylesheet, and the two views rewritten
+ * in utilities.
  *
  * `postcss` and `postcss-loader` are the app's dependencies rather than the framework's — rshono
- * compiles CSS natively and has no PostCSS in it, so an app that does not want a plugin chain does not
- * install one.
+ * compiles CSS natively, so an app that does not want a plugin chain does not install one.
  */ const TAILWIND = {
     id: 'tailwind',
     overlays: [
@@ -3325,8 +3362,9 @@ function stylingFeature(styling) {
 ;// CONCATENATED MODULE: ./src/pkg.ts
 
 /**
- * The scripts every app gets. `start` is not among them: it is the *Node* launcher, and the deploy
- * features each contribute the command their own platform runs what was built with.
+ * The scripts every app gets. `start` is not among them, because it means something different per
+ * platform: `node` is the one target that runs the build itself, so it contributes its own, and a
+ * platform target contributes a `deploy` instead, where its platform has one command to give.
  */ const BASE_SCRIPTS = {
     dev: 'rshono dev',
     build: 'rshono build',
@@ -3346,6 +3384,30 @@ function stylingFeature(styling) {
 function sorted(record) {
     return Object.fromEntries(Object.entries(record).sort(([a], [b])=>a < b ? -1 : 1));
 }
+/**
+ * pnpm's settings for the new app, written only when a feature has something to put in them. `null`
+ * means there is nothing to say, so no file is written.
+ *
+ * It exists for one field, `allowBuilds`. pnpm fails an install — and every `pnpm dev` after it —
+ * until the project has said whether a dependency's install script should run. Nothing rshono itself
+ * installs has one, so most apps get no file; the packages that do (wrangler's esbuild and workerd)
+ * declare their answer on the feature that brings them.
+ *
+ * A file rather than a `pnpm` key in `package.json`, which pnpm 11 no longer reads.
+ */ function buildPnpmSettings(features) {
+    const allowBuilds = {};
+    for (const feature of features)Object.assign(allowBuilds, feature.allowBuilds);
+    const entries = Object.entries(sorted(allowBuilds));
+    if (entries.length === 0) return null;
+    return [
+        '# Which dependencies may run an install script. pnpm runs none it has not been told about, and',
+        '# fails the install rather than skip one quietly — so anything added later belongs here too.',
+        '# `false` means the script was looked at: these ship their real binary as an optional dependency.',
+        'allowBuilds:',
+        ...entries.map(([name, allowed])=>`  ${name}: ${allowed}`),
+        ''
+    ].join('\n');
+}
 /**
  * Assembles `package.json` from the answers and whatever the selected features contribute.
  *
@@ -3377,10 +3439,9 @@ function sorted(record) {
         version: '0.1.0',
         private: true,
         type: 'module',
-        // The floor the framework declares. Stated here too so a CI image or a contributor on an older
-        // Node finds out from their package manager rather than from a stack trace.
+        // Generated from the framework's own manifest, so the app's floor cannot drift below rshono's.
         engines: {
-            node: '>=22.1.0'
+            node: NODE_ENGINE
         },
         scripts,
         dependencies: sorted(dependencies),
@@ -3398,19 +3459,22 @@ function sorted(record) {
 
 ;// CONCATENATED MODULE: ./src/render.ts
 
-const TOKEN_PATTERN = /__[A-Z][A-Z\d_]*__/g;
+/**
+ * `{{NAME}}`, deliberately not `__NAME__`: templates are real files that real tools run over, and in
+ * markdown `__NAME__` *is* strong emphasis — Prettier rewrites it to `**NAME**` and the token stops
+ * matching. `{{…}}` means nothing to any format these templates are written in.
+ */ const TOKEN_PATTERN = /\{\{[A-Z][A-Z\d_]*\}\}/g;
 function tokensFor(answers, pm) {
     return {
-        __PROJECT_NAME__: answers.packageName,
-        __DEPLOY_TARGET__: answers.deploy,
-        __DEPLOY_HINT__: deployHint(answers.deploy),
-        __PM__: pm.name,
-        __PM_RUN__: pm.run
+        '{{PROJECT_NAME}}': answers.packageName,
+        '{{DEPLOY_TARGET}}': answers.deploy,
+        '{{DEPLOY_HINT}}': deployHint(answers.deploy),
+        '{{PM_RUN}}': pm.run
     };
 }
 /**
  * Substitutes tokens, and throws on one it doesn't know — a typo in a template would otherwise ship a
- * literal `__PORJECT_NAME__` into somebody's new app, which no test of the generator's logic would
+ * literal `{{PORJECT_NAME}}` into somebody's new app, which no test of the generator's logic would
  * catch.
  */ function render(contents, tokens, source) {
     return contents.replace(TOKEN_PATTERN, (token)=>{
@@ -3443,10 +3507,9 @@ function readTemplateDir(dir) {
 /**
  * `_gitignore` → `.gitignore`, and so on for every dotfile.
  *
- * npm strips a literal `.gitignore` out of a published tarball, so a template cannot simply contain
- * one — the file would exist in the repo, pass every local test, and be missing from the package
- * everybody actually installs. Naming them with an underscore and renaming here is the long-standing
- * fix. It applies to the basename only, so `src/lib/_x.ts` is a dotfile but `templates/_x/y.ts` is not.
+ * npm strips a literal `.gitignore` out of a published tarball, so a template cannot contain one — it
+ * would exist in the repo, pass every local test, and be missing from the package everybody installs.
+ * Applies to the basename only, so `src/lib/_x.ts` is a dotfile but `templates/_x/y.ts` is not.
  */ function undotted(path) {
     const segments = path.split(posix.sep);
     const name = segments.pop();
@@ -3486,6 +3549,9 @@ function readTemplateDir(dir) {
     const gitignore = files.get('.gitignore');
     if (gitignore) files.set('.gitignore', appendGitignore(gitignore, features));
     files.set('package.json', buildPackageJson(answers, features, pm));
+    // Only for pnpm, and only when a feature brought an install script to answer for — see `buildPnpmSettings`.
+    const pnpmSettings = pm.name === 'pnpm' ? buildPnpmSettings(features) : null;
+    if (pnpmSettings) files.set('pnpm-workspace.yaml', pnpmSettings);
     return {
         // Sorted, so both the write order and a test's snapshot are stable.
         files: new Map([
@@ -3498,6 +3564,7 @@ function readTemplateDir(dir) {
 
 ;// CONCATENATED MODULE: ./src/pm.ts
 
+
 const INSTALL = {
     npm: [
         'install'
@@ -3517,7 +3584,7 @@ const RUN = {
     bun: 'bun'
 };
 function isKnown(name) {
-    return name === 'npm' || name === 'pnpm' || name === 'yarn' || name === 'bun';
+    return PACKAGE_MANAGERS.includes(name);
 }
 function packageManager(name, version) {
     return {
@@ -3528,8 +3595,8 @@ function packageManager(name, version) {
     };
 }
 /**
- * Which package manager invoked us. Every one of them sets `npm_config_user_agent` for the process it
- * spawns — `pnpm/11.9.0 npm/? node/v22.14.0 darwin arm64` — so `pnpm create @rshono` scaffolds a pnpm
+ * Which package manager invoked us. Every one of them sets `npm_config_user_agent` on the process it
+ * spawns — `pnpm/11.9.0 npm/? node/v22.14.0 darwin arm64` — so `pnx @rshono/create` scaffolds a pnpm
  * project without asking, and the exact version comes along for the `packageManager` field.
  *
  * Falls back to npm, which is also what a bare `node bin/create-rshono.mjs` gets.
@@ -3546,12 +3613,6 @@ function packageManager(name, version) {
  */ function runInstall(pm, cwd) {
     return run(pm, pm.install, cwd);
 }
-/** `<pm> run <script>` — the one form every package manager accepts, Yarn v1 included. */ function runScript(pm, script, cwd) {
-    return run(pm, [
-        'run',
-        script
-    ], cwd);
-}
 function run(pm, args, cwd) {
     const result = spawnSync(pm.name, args, {
         cwd,
@@ -3611,15 +3672,20 @@ function run(pm, args, cwd) {
     '.vscode',
     'Thumbs.db'
 ]);
-function inspectTarget(dir) {
-    if (!external_node_fs_existsSync(dir)) return {
-        exists: false,
-        conflicts: []
-    };
-    return {
-        exists: true,
-        conflicts: external_node_fs_readdirSync(dir).filter((entry)=>!IGNORED_ENTRIES.has(entry))
-    };
+/**
+ * What is already at the target path, ignoring the entries a fresh clone or an editor leaves behind —
+ * which is what decides whether scaffolding into it is safe.
+ *
+ * A path that does not exist yet is no conflict. A path that exists and is *not* a directory throws
+ * rather than reporting an empty list, since `--force` should not write into one either — otherwise
+ * `create-rshono README.md` gets as far as `mkdir` before failing on a raw ENOTDIR.
+ */ function conflictingEntries(dir) {
+    const stats = statSync(dir, {
+        throwIfNoEntry: false
+    });
+    if (!stats) return [];
+    if (!stats.isDirectory()) throw new Error(`${dir} already exists and is not a directory.`);
+    return external_node_fs_readdirSync(dir).filter((entry)=>!IGNORED_ENTRIES.has(entry));
 }
 /**
  * Writes the plan. Directories are created as needed, and files are written with the plan's own
@@ -3647,20 +3713,21 @@ function inspectTarget(dir) {
 
 
 
+
 const DEFAULT_DIRECTORY = 'my-rshono-app';
-const HELP = `create-rshono — scaffold a new rshono app
+/** Every accepted name comes from `options.ts`, so the help cannot promise one the validation refuses. */ const HELP = `create-rshono — scaffold a new rshono app
 
 Usage:
-  npm create @rshono@latest [directory] [options]
+  npx @rshono/create@latest [directory] [options]
 
 Options:
   -y, --yes                accept the default for every question not given as a flag
   -d, --deploy <target>    ${DEPLOY_TARGET_NAMES.join(' | ')}
       --tailwind           Tailwind CSS (--no-tailwind for plain CSS)
       --quality <preset>   ${QUALITY_PRESETS.map((preset)=>preset.id).join(' | ')}
-      --formatter <name>   prettier | biome | oxfmt | none  (overrides --quality)
-      --linter <name>      oxlint | biome | none            (overrides --quality)
-      --pm <name>          npm | pnpm | yarn | bun          (default: whatever ran this)
+      --formatter <name>   ${FORMATTER_NAMES.join(' | ')}      (overrides --quality)
+      --linter <name>      ${LINTER_NAMES.join(' | ')}       (overrides --quality; eslint pins TypeScript 6)
+      --pm <name>          ${PACKAGE_MANAGERS.join(' | ')}              (default: whatever ran this)
       --no-install         write the files and stop
       --no-git             do not initialize a repository
       --force              scaffold into a directory that is not empty
@@ -3671,7 +3738,7 @@ Options:
 Every question can be answered by a flag, and a non-interactive terminal implies --yes — so one command
 scaffolds without prompting:
 
-  npm create @rshono@latest my-app -y --deploy cloudflare --tailwind --quality biome
+  npx @rshono/create@latest my-app -y --deploy cloudflare --tailwind --quality biome
 `;
 function fail(message) {
     log.error(message);
@@ -3688,92 +3755,89 @@ function fail(message) {
     if (off) return false;
     return undefined;
 }
-async function main() {
-    const { values, positionals } = parseArgs({
-        options: {
-            yes: {
-                type: 'boolean',
-                short: 'y'
-            },
-            deploy: {
-                type: 'string',
-                short: 'd'
-            },
-            tailwind: {
-                type: 'boolean'
-            },
-            'no-tailwind': {
-                type: 'boolean'
-            },
-            quality: {
-                type: 'string'
-            },
-            formatter: {
-                type: 'string'
-            },
-            linter: {
-                type: 'string'
-            },
-            pm: {
-                type: 'string'
-            },
-            install: {
-                type: 'boolean'
-            },
-            'no-install': {
-                type: 'boolean'
-            },
-            git: {
-                type: 'boolean'
-            },
-            'no-git': {
-                type: 'boolean'
-            },
-            force: {
-                type: 'boolean'
-            },
-            'dry-run': {
-                type: 'boolean'
-            },
-            help: {
-                type: 'boolean',
-                short: 'h'
+/** `parseArgs` names an unknown flag but says nothing about what to do next; this points at `--help`. */ function parse() {
+    try {
+        return parseArgs({
+            options: {
+                yes: {
+                    type: 'boolean',
+                    short: 'y'
+                },
+                deploy: {
+                    type: 'string',
+                    short: 'd'
+                },
+                tailwind: {
+                    type: 'boolean'
+                },
+                'no-tailwind': {
+                    type: 'boolean'
+                },
+                quality: {
+                    type: 'string'
+                },
+                formatter: {
+                    type: 'string'
+                },
+                linter: {
+                    type: 'string'
+                },
+                pm: {
+                    type: 'string'
+                },
+                install: {
+                    type: 'boolean'
+                },
+                'no-install': {
+                    type: 'boolean'
+                },
+                git: {
+                    type: 'boolean'
+                },
+                'no-git': {
+                    type: 'boolean'
+                },
+                force: {
+                    type: 'boolean'
+                },
+                'dry-run': {
+                    type: 'boolean'
+                },
+                help: {
+                    type: 'boolean',
+                    short: 'h'
+                },
+                version: {
+                    type: 'boolean',
+                    short: 'v'
+                }
             },
-            version: {
-                type: 'boolean',
-                short: 'v'
-            }
-        },
-        allowPositionals: true
-    });
+            allowPositionals: true
+        });
+    } catch (error) {
+        fail(`${error instanceof Error ? error.message : String(error)}\n\nRun with --help to see the options.`);
+    }
+}
+async function main() {
+    const { values, positionals } = parse();
     if (values.help) return console.log(HELP);
-    if (values.version) return console.log("1.0.0-rc.0");
-    // A pipe, a CI job or an agent gets the defaults rather than a prompt nothing can answer.
-    const interactive = Boolean(process.stdout.isTTY) && !values.yes;
-    const pmFlag = oneOf(values.pm, [
-        'npm',
-        'pnpm',
-        'yarn',
-        'bun'
-    ], 'pm');
+    if (values.version) return console.log("1.0.0-rc.10");
+    // A pipe, a CI job or an agent gets the defaults rather than a prompt nothing can answer. Both
+    // streams have to be a terminal: the prompts draw on stdout but *read from stdin*, so
+    // `echo | npx @rshono/create` would otherwise ask a question with nothing behind the keyboard.
+    const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY) && !values.yes;
+    const pmFlag = oneOf(values.pm, PACKAGE_MANAGERS, 'pm');
     const pm = pmFlag ? packageManager(pmFlag) : detectPackageManager();
     const deployFlag = oneOf(values.deploy, DEPLOY_TARGET_NAMES, 'deploy');
-    const formatterFlag = oneOf(values.formatter, [
-        'prettier',
-        'biome',
-        'oxfmt',
-        'none'
-    ], 'formatter');
-    const linterFlag = oneOf(values.linter, [
-        'oxlint',
-        'biome',
-        'none'
-    ], 'linter');
+    const formatterFlag = oneOf(values.formatter, FORMATTER_NAMES, 'formatter');
+    const linterFlag = oneOf(values.linter, LINTER_NAMES, 'linter');
     const qualityFlag = oneOf(values.quality, QUALITY_PRESETS.map((preset)=>preset.id), 'quality');
     const tailwindFlag = tristate(values.tailwind, values['no-tailwind'], 'tailwind');
     const installFlag = tristate(values.install, values['no-install'], 'install');
     const gitFlag = tristate(values.git, values['no-git'], 'git');
-    intro(`create-rshono  ·  rshono ${"1.0.0-rc.0"}`);
+    // The framework version, not this package's: it is the one the app will be pinned to, and the one
+    // worth reading here. `--version` reports create-rshono's own.
+    intro(`create-rshono  ·  rshono ${RSHONO_VERSION}`);
     // ── Where ───────────────────────────────────────────────────────────────────────────────────────
     let directory = positionals[0];
     if (!directory) {
@@ -3787,7 +3851,7 @@ async function main() {
     const targetDir = resolve(process.cwd(), directory);
     const packageName = toPackageName(directory === '.' ? basename(targetDir) : directory);
     if (!packageName || !isValidPackageName(packageName)) fail(`"${directory}" does not give a usable npm package name.`);
-    const conflicts = inspectTarget(targetDir).conflicts;
+    const conflicts = conflictingEntries(targetDir);
     if (conflicts.length > 0 && !values.force) {
         const where = directory === '.' ? 'this directory' : `"${directory}"`;
         const listed = `${conflicts.slice(0, 3).join(', ')}${conflicts.length > 3 ? ', …' : ''}`;
@@ -3813,7 +3877,7 @@ async function main() {
                 }))
         }));
     }
-    let styling = tailwindFlag === undefined ? 'css' : tailwindFlag ? 'tailwind' : 'css';
+    let styling = tailwindFlag ? 'tailwind' : 'css';
     if (tailwindFlag === undefined && interactive) {
         styling = unwrap(await dist_select({
             message: 'Styling?',
@@ -3832,10 +3896,9 @@ async function main() {
             ]
         }));
     }
-    /*
-   * The preset asks one question instead of two. The two axes stay independent underneath — a
-   * `--formatter` or `--linter` flag addresses either on its own, and skips the question entirely.
-   */ let preset = QUALITY_PRESETS.find((candidate)=>candidate.id === qualityFlag);
+    // One question instead of two. The axes stay independent underneath: a `--formatter` or `--linter`
+    // flag addresses either on its own, and skips the question entirely.
+    let preset = QUALITY_PRESETS.find((candidate)=>candidate.id === qualityFlag);
     if (!preset && !formatterFlag && !linterFlag) {
         const fallback = QUALITY_PRESETS["0"];
         if (interactive) {
@@ -3863,9 +3926,10 @@ async function main() {
             initialValue: true
         }));
     }
-    let git = gitFlag ?? !isInsideRepo(process.cwd());
+    // Asked once, not once per use: this shells out to `git rev-parse`.
+    const nested = isInsideRepo(process.cwd());
+    let git = gitFlag ?? !nested;
     if (gitFlag === undefined && interactive) {
-        const nested = isInsideRepo(process.cwd());
         git = unwrap(await dist_confirm({
             message: nested ? 'Initialize a git repository? (this is already inside one)' : 'Initialize a git repository?',
             initialValue: !nested
@@ -3873,14 +3937,10 @@ async function main() {
     }
     const answers = {
         packageName,
-        targetDir,
         deploy,
         styling,
         formatter,
-        linter,
-        packageManager: pm.name,
-        install,
-        git
+        linter
     };
     // ── Plan, then write ────────────────────────────────────────────────────────────────────────────
     const plan = plan_plan(answers, pm);
@@ -3897,14 +3957,7 @@ async function main() {
     if (install) {
         log.step(`Installing dependencies with ${pm.name}…`);
         installed = runInstall(pm, targetDir);
-        if (!installed) log.warn(`${pm.name} install failed — run it yourself and the rest will work.`);
-    }
-    /*
-   * Format the scaffold with the tool it was scaffolded with, so a fresh project passes its own
-   * `format:check` instead of reporting a diff nobody made. Needs the install, since the formatter is a
-   * devDependency — hence the skip, rather than a failure, when there is none.
-   */ if (installed && formatter !== 'none') {
-        if (!runScript(pm, 'format', targetDir)) log.warn(`\`${pm.run} format\` failed — the files are fine, the formatter is not.`);
+        if (!installed) log.warn(`${pm.name} install failed — the files are all written, so run it yourself in the project.`);
     }
     if (git) {
         if (!hasGit(targetDir)) {