@fusion.dev/create-helix-app 0.227.0 → 0.228.0

package/README.md

@@ -3,17 +3,22 @@
 Starts a Helix project.
 
 ```sh
-npm create @fusion.dev/helix-app@latest my-app
+npm create @fusion.dev/helix-app@latest
 ```
 
-Named without a template, it lists the templates and writes nothing: a
-scaffolder that picks for you writes a project you didn't choose. Name one after
-`--`, which is how `npm create` passes a flag on rather than reading it itself:
+It asks for a project name and a template, then writes the project. It prints the
+commands that install and start it, for the package manager you ran it with.
+
+Name both on the command line to skip the questions. Outside a terminal, such as
+in a script, a missing name is an error and a missing template lists the templates
+and writes nothing.
 
 ```sh
-npm create @fusion.dev/helix-app@latest my-app -- --template react-vite
+npm create @fusion.dev/helix-app@latest my-app --template react-vite
 ```
 
+The same command works with `yarn create`, `pnpm create`, and `bun create`.
+
 | Template | What it is |
 |---|---|
 | `react-vite` | React and TypeScript on Vite. The shortest path to a running app. |

package/bin.mjs

@@ -95,7 +95,24 @@ const newer = () => {
    the registry only if it is slower than the scaffold. */
 const checking = newer()
 
-const running = spawn(process.execPath, [helix, 'new', ...process.argv.slice(2)], {
+/**
+ * What was asked, with the template put back where npm took it from.
+ *
+ * **npm reads `--template` as its own setting.** It drops the flag and passes the
+ * value on, so `npm create @fusion.dev/helix-app my-app --template react-vite`
+ * arrives here as two bare words, and `helix new` refused the second. Nothing
+ * else is two bare words, so every package manager can use the one command.
+ */
+const asked = (args) =>
+  args.length === 2 && !args.some((one) => one.startsWith('-'))
+    ? [args[0], '--template', args[1]]
+    : args
+
+/** The package manager that ran this, from what each one sets, or npm. */
+const manager = () =>
+  /^(bun|pnpm|yarn)\//.exec(process.env.npm_config_user_agent ?? '')?.[1] ?? 'npm'
+
+const running = spawn(process.execPath, [helix, 'new', ...asked(process.argv.slice(2))], {
   env: { ...process.env, HELIX_TEMPLATES: process.env.HELIX_TEMPLATES ?? templates },
   stdio: 'inherit',
 })
@@ -109,7 +126,7 @@ running.on('close', async (status) => {
   if (latest !== undefined) {
     console.error(
       `\nHelix ${latest} is out, and this is ${own.version}. For the newest templates:\n\n` +
-        `  npm create ${own.name.replace('create-', '')}@latest\n`,
+        `  ${manager()} create ${own.name.replace('create-', '')}@latest\n`,
     )
   }
   process.exit(status ?? 70)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/create-helix-app",
   "description": "Starts a Helix project: `npm create @fusion.dev/helix-app`, which is `helix new` for somebody with no project yet.",
-  "version": "0.227.0",
+  "version": "0.228.0",
   "license": "MIT",
   "author": "Fusion Development Group",
   "repository": {
@@ -21,8 +21,8 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-cli": "0.227.0",
-    "@fusion.dev/helix-templates": "0.227.0"
+    "@fusion.dev/helix-cli": "0.228.0",
+    "@fusion.dev/helix-templates": "0.228.0"
   },
   "homepage": "https://fusion.dev",
   "keywords": [