create-dormer 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# create-dormer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`npm create dormer my-app -- --template react` scaffolds a Dormer desktop application and installs its
+dependencies. Templates: `vanilla`, `react`, `vue`, `svelte`. The native host binary arrives through
+`@dormer/cli`'s optional dependency on the prebuilt `@dormer/host-<platform>-<arch>` package for your
+platform, so no Rust toolchain is needed.
+
+```sh
+npm create dormer my-app -- --template react
+cd my-app
+npm run dev          # Vite with HMR + the Node.js backend + a native window
+npm run package      # installers through dormer-bundle (@dormer/bundle-<platform>-<arch>)
+```
+
+The wrapper runs `dormer create` from `@dormer/cli` and then `npm install` (or the package manager that
+invoked it: pnpm, yarn, bun). `--no-install` skips the install step.

package/bin/create-dormer.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// `npm create dormer <dir> -- --template react` (also `npx create-dormer`, `pnpm create dormer`,
+// `yarn create dormer`). Thin wrapper: runs `dormer create` from the @dormer/cli this package depends on,
+// then installs the new app's dependencies with the package manager that invoked us.
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+// @dormer/cli has an exports map; resolve its package root through "./package.json" (exported) with a
+// fallback through the main entry (<pkg>/src/index.ts) for older copies.
+function cliPackageDir() {
+  try { return path.dirname(fileURLToPath(import.meta.resolve("@dormer/cli/package.json"))); }
+  catch { return path.dirname(path.dirname(fileURLToPath(import.meta.resolve("@dormer/cli")))); }
+}
+const cliBin = path.join(cliPackageDir(), "bin", "dormer.mjs");
+
+const args = process.argv.slice(2);
+if (args.length === 0 || args.includes("-h") || args.includes("--help")) {
+  console.log(`usage: npm create dormer <dir> -- [--template vanilla|react|vue|svelte] [--no-install]
+
+Creates a Dormer desktop app: a Node.js backend (src/main.ts, @dormer/api), a Vite renderer
+(renderer/, @dormer/renderer) and dormer.config.json, then installs dependencies.
+Next: cd <dir> && npm run dev`);
+  process.exit(args.length === 0 ? 64 : 0);
+}
+
+const install = !args.includes("--no-install");
+const cliArgs = args.filter((a) => a !== "--no-install");
+if (!cliArgs.some((a) => a === "--template" || a.startsWith("--template="))) cliArgs.push("--template", "react");
+
+// npm_config_user_agent tells us which package manager ran `create`; mirror it for the install step.
+const ua = process.env.npm_config_user_agent ?? "";
+const pm = ua.startsWith("pnpm") ? "pnpm" : ua.startsWith("yarn") ? "yarn" : ua.startsWith("bun") ? "bun" : "npm";
+if (!cliArgs.includes("--pm")) cliArgs.push("--pm", pm);
+
+const created = spawnSync(process.execPath, [cliBin, "create", ...cliArgs], { stdio: "inherit" });
+if (created.status !== 0) process.exit(created.status ?? 1);
+
+const dir = cliArgs.find((a) => !a.startsWith("-") && !["vanilla", "react", "vue", "svelte", pm].includes(a));
+if (install && dir && existsSync(dir)) {
+  console.log(`\n[create-dormer] installing dependencies with ${pm}…`);
+  const installed = spawnSync(pm, ["install"], { cwd: dir, stdio: "inherit", shell: process.platform === "win32" });
+  if (installed.status !== 0) process.exit(installed.status ?? 1);
+  console.log(`\n[create-dormer] done. Next:\n  cd ${dir}\n  ${pm === "npm" ? "npm run" : pm} dev`);
+}

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "create-dormer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "npm create dormer: scaffold a Dormer desktop app (Node.js backend + system WebView) from a template",
+  "type": "module",
+  "license": "Apache-2.0 OR MIT",
+  "bin": {
+    "create-dormer": "bin/create-dormer.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "dependencies": {
+    "@dormer/cli": "0.1.0"
+  },
+  "engines": {
+    "node": ">=22.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}