create-gesso-app 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# create-gesso-app
+
+## 0.1.0
+
+First public release.
+
+```bash
+npm create gesso-app my-app
+```
+
+Scaffolds a Gesso application: a Vite project whose interface is built,
+laid out and painted in a render worker, with the main thread holding
+the canvas and forwarding input.
+
+Two templates. `web` is a browser project with the render worker, the
+Vite plugin and the development error overlay wired up. `electrobun` is
+a native window with its state in the main process, where every window
+is a replica of the same channels.
+
+`--local` packs the packages out of a Gesso checkout instead of
+installing them from the registry, which is how to scaffold a project
+against changes that are not released yet. It is also how
+`pnpm check:scaffold` runs, so that gate tests the working tree rather
+than the last release.
+
+The CLI is compiled rather than shipped as TypeScript, because `node`
+only strips types on 24 and later and this is the first thing a
+stranger runs.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Baker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,117 @@
+# create-gesso-app
+
+Scaffolds a Gesso application: a Vite project whose interface is built,
+laid out and painted in a render worker.
+
+```bash
+npm create gesso-app my-app
+npm create gesso-app my-app -- --template electrobun   # a native window
+```
+
+The packages come from the registry. `--local` packs them out of a
+Gesso checkout instead, for scaffolding against changes that are not
+released yet; that is the mode `pnpm check:scaffold` uses, so the gate
+tests the working tree and not the last release.
+
+## What the `web` template writes
+
+```text
+index.html        a host element with a size, and nothing else
+tsconfig.json     bundler resolution, and the two lines that buy JSX
+vite.config.ts    empty, because Gesso needs no plugin
+src/main.ts       the main thread: name the worker, mount into #app
+src/worker.ts     the render worker: name the root component
+src/App.tsx       the screen
+```
+
+## What the `electrobun` template writes
+
+```text
+electrobun.config.ts   the app, and where the built assets go in the bundle
+hutch.config.ts        what `hutch run <script>` does, and which Electrobun
+vite.config.ts         the window's assets, with the projected SDK aliased
+tsconfig.json          extends the devkit's, plus the two lines that buy JSX
+src/shared/Counter.ts  the channel both processes import
+src/shared/rpc.ts      the one message a window and the main process exchange
+src/main/index.ts      the main process: the state, and the windows
+src/view/main.ts       a window's main thread: build the bridge, mount
+src/view/render.worker.ts  the render worker, and the channels it attaches
+src/render/App.tsx     the screen
+```
+
+Each template's `package.json` names version ranges, and an ordinary
+install fetches them.
+
+## What `--local` does, and why it exists
+
+`--local` packs the packages a template needs out of a Gesso checkout
+with `pnpm pack`, writes the tarballs into the new project's `vendor/`
+and points `dependencies` and `overrides` at them with `file:`
+specifiers. It only works from inside the workspace, and it says so
+rather than failing obscurely.
+
+It exists so a scaffold can be made against changes that are not
+released. `pnpm check:scaffold` runs this way for exactly that reason:
+a gate that installed the last release would pass no matter what the
+working tree did.
+
+`pnpm pack` and not a workspace link, because packing is the only thing
+that applies each package's `publishConfig`, which rewrites `exports`
+from `src/*.ts` to `dist`. A link never goes through it, so a project
+that linked would be testing a resolution no consumer ever gets. That
+is the same route `scripts/check-install.ts` takes and for the same
+reason.
+
+A `web` project installs with **npm**. npm satisfies the packages'
+declarations of each other from the tarballs already in its tree; pnpm 11
+resolves them independently and asks a registry that has never heard of
+them. An `electrobun` project installs with **`hutch install`**, because
+Hutch owns that project's `node_modules` and projects the Electrobun
+devkit into it, and two package managers cannot own one `node_modules`.
+`overrides` is written for both, and is what keeps either installer from
+going to a registry for a package it already has as a tarball.
+
+## The Electrobun template, and what is different about it
+
+The application is the same shape: the same render worker, the same
+components, the same channels. Three things around it are not.
+
+**It is set up by Hutch, not by npm.** Electrobun 2.x is a toolchain a
+launcher downloads, and `hutch electrobun prepare` projects the SDK into
+the project's own `.hutch/devkit`. There is no `electrobun` dependency
+in the generated `package.json` and adding one would not help: the npm
+package of that name is a bootstrap for the launcher. Both
+`vite.config.ts` and `tsconfig.json` read the SDK out of `.hutch/devkit`,
+so neither can be loaded before the first prepare, which is why every
+script in `hutch.config.ts` runs prepare first. The generated project's
+README says how to get `hutch` if it is not on the path.
+
+**The application layer is a process rather than a worker.** The state
+lives in the main process and every window replicates it, so the
+template ships a channel, a two-line RPC schema, and a main process that
+serves one and opens windows over the other.
+
+**The main process is not pre-bundled, and this is the one judgement
+call in the template.** An application that imports the framework
+out of this workspace has to bundle its main process with esbuild before
+Electrobun sees it, because a bundler cannot resolve a package that was
+never installed. A scaffolded project
+installs them, so `electrobun.config.ts` points Cottontail at
+`src/main/index.ts` and lets Electrobun bundle it, which is the ordinary
+arrangement. The generated README records the escape hatch in case a
+future toolchain disagrees.
+
+## The checks, and what is not checked
+
+`pnpm check:scaffold` runs the CLI into a temporary directory, installs,
+typechecks and builds the result, starts the dev server the CLI told the
+person to start, and drives it in headless Chrome until the counter
+counts. **It covers the `web` template only.** Run it after changing
+anything under `templates/web/`.
+
+Nothing in this repository can open a native window, and standing a Hutch
+project up in a gate would mean downloading a native toolchain to check
+an import, so the `electrobun` template has no automated gate at all. It
+is checked by scaffolding it and running it on a machine with the
+toolchain, which is how every other Electrobun claim in this repository
+was checked.

package/dist/create-gesso-app.mjs

@@ -0,0 +1,400 @@
+#!/usr/bin/env node
+import { execFileSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { basename, isAbsolute, join, resolve } from "node:path";
+//#region bin/create-gesso-app.ts
+/**
+* `create-gesso-app`: scaffolds a Gesso application (the
+* last item).
+*
+* What it writes is the configuration this framework is for. The
+* application runs in a render worker; the page's own script creates
+* the app, hands it a worker constructor and mounts it, and that is the
+* whole of the main thread's job.
+*
+* The one thing this CLI does that a public scaffolder would not is
+* vendor its own dependencies. No `gesso-*` package is on a registry,
+* so a generated `package.json` that named a version would produce a
+* project that cannot install. Instead the CLI packs the packages a
+* template needs out of this workspace with `pnpm pack`, drops the
+* tarballs into the new project's `vendor/` directory and writes
+* `file:` specifiers at them. That is the same route
+* `scripts/check-install.ts` takes, and it is the route that exercises
+* each package's `publishConfig`, which is the only thing that rewrites
+* `exports` from `src/*.ts` to `dist`. This ends the day the packages
+* are published to a registry.
+*
+*   node packages/create-gesso-app/bin/create-gesso-app.ts ../my-app
+*   node packages/create-gesso-app/bin/create-gesso-app.ts ../my-app --no-build
+*   node packages/create-gesso-app/bin/create-gesso-app.ts ../my-app --template electrobun
+*
+* The two templates differ in what runs beneath the same application.
+* `web` is a Vite project a browser loads. `electrobun` is a native
+* window whose application layer is a separate process, and it is set
+* up by Hutch rather than by npm: the Electrobun SDK is projected into
+* a project by `hutch electrobun prepare` rather than installed from a
+* registry, so the generated project depends on the toolchain being
+* present and says so.
+*/
+/** Where the packed tarballs land inside the generated project. */
+const VENDOR_DIR = "vendor";
+/** Template files whose names cannot be checked into this repository as-is. */
+const RENAMED = /* @__PURE__ */ new Map([["_gitignore", ".gitignore"]]);
+/**
+* The templates, and the two things that differ between them: what a
+* project depends on, and how a person starts it.
+*
+* `devtools` and `vite-plugin` joined the web template's first three
+* when the feedback loop was wired in by default:
+* the plugin is what writes the worker construction and the
+* hot-replacement wiring, and it loads the overlay from devtools the
+* first time the worker throws. Both are development dependencies of
+* the generated project and neither is reachable from a production
+* build.
+*/
+const TEMPLATES = {
+	web: {
+		vendored: [
+			"core",
+			"framework",
+			"components",
+			"devtools",
+			"vite-plugin"
+		],
+		substitute: ["index.html", "README.md"],
+		next: (name, where, local) => [
+			`\nCreated ${name} in ${where}.\n`,
+			`  cd ${where}`,
+			"  pnpm install     # or npm install",
+			"  pnpm dev\n",
+			...local ? [
+				"Gesso came from this workspace rather than the registry, packed into",
+				"vendor/. The packed packages ask each other for version ranges, so npm",
+				"is pointed at the tarballs by `overrides` in package.json and pnpm by",
+				"`overrides` in pnpm-workspace.yaml. The project's README says how to",
+				"move to the published packages.\n"
+			] : []
+		].join("\n")
+	},
+	electrobun: {
+		vendored: [
+			"core",
+			"framework",
+			"components",
+			"electrobun"
+		],
+		substitute: [
+			"electrobun.config.ts",
+			"src/main/index.ts",
+			"src/view/index.html",
+			"README.md"
+		],
+		next: (name, where) => `
+Created ${name} in ${where}.
+
+  cd ${where}
+  hutch install
+  hutch run dev
+
+Hutch rather than npm, and this is the part to read before running it.
+Electrobun 2.x is a toolchain a launcher downloads, not a package a
+registry serves: \`hutch electrobun prepare\` projects the SDK into the
+project's own .hutch/devkit, which is where vite.config.ts and
+tsconfig.json look for it, and every script in hutch.config.ts runs that
+first. \`hutch install\` runs npm underneath. If \`hutch\` is not on your
+path yet, the project's README says how to get it.
+
+\`pnpm check:scaffold:electrobun\` installs, typechecks and builds a
+project like this one without opening it. The window itself is checked
+by running it; the README records the last time that was done.
+`
+	}
+};
+const packageRoot = join(import.meta.dirname, "..");
+const workspaceRoot = join(packageRoot, "..", "..");
+const USAGE = `Usage: create-gesso-app <directory> [options]
+
+Creates a Gesso application in <directory>: a project whose interface is
+built, laid out and painted in a render worker.
+
+Options:
+  --name <name>     Package name for the new project. Defaults to the
+                    directory's own name.
+  --template <name> "web" for a Vite project a browser loads, or
+                    "electrobun" for a native window with its state in a
+                    main process. Defaults to "web".
+  --force           Write into a directory that already has files in it.
+  --local           Install the Gesso packages from this workspace, packed
+                    into the project, instead of from the registry. Only
+                    works inside a Gesso checkout.
+  --no-build        With --local, pack without rebuilding first. Only safe
+                    when dist/ is already current.
+  -h, --help        Print this.
+`;
+function fail(message) {
+	console.error(message);
+	process.exit(1);
+}
+function parseArgs(argv) {
+	let target;
+	let name;
+	let template = "web";
+	let force = false;
+	let build = true;
+	let local = false;
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		switch (arg) {
+			case "-h":
+			case "--help":
+				console.log(USAGE);
+				process.exit(0);
+				break;
+			case "--force":
+				force = true;
+				break;
+			case "--local":
+				local = true;
+				break;
+			case "--no-build":
+				build = false;
+				break;
+			case "--name":
+				name = argv[++i];
+				break;
+			case "--template":
+				template = argv[++i] ?? "";
+				break;
+			default:
+				if (arg.startsWith("-")) fail(`Unknown option ${arg}.\n\n${USAGE}`);
+				if (target !== void 0) fail(`Two directories were given, ${target} and ${arg}.\n\n${USAGE}`);
+				target = arg;
+		}
+	}
+	if (target === void 0) fail(`A directory to create is required.\n\n${USAGE}`);
+	if (name !== void 0 && !/^[a-z0-9][a-z0-9._-]*$/.test(name)) fail(`"${name}" is not a usable package name: use lowercase letters, digits, dots, dashes and underscores.`);
+	const absolute = isAbsolute(target) ? target : resolve(process.cwd(), target);
+	return {
+		target: absolute,
+		name: name ?? basename(absolute),
+		template,
+		force,
+		build,
+		local
+	};
+}
+/** Looks a template up, and lists the ones that exist when it is not one. */
+function templateOf(name) {
+	const template = TEMPLATES[name];
+	if (template === void 0 || !existsSync(join(packageRoot, "templates", name))) fail(`There is no "${name}" template. Available: ${Object.keys(TEMPLATES).join(", ")}.`);
+	return template;
+}
+function prepareTarget(options) {
+	if (!existsSync(options.target)) {
+		mkdirSync(options.target, { recursive: true });
+		return;
+	}
+	const existing = readdirSync(options.target);
+	if (existing.length > 0 && !options.force) fail(`${options.target} is not empty (${existing.length} entries). Pass --force to write into it anyway.`);
+}
+/**
+* Whether a package's `dist` is older than anything in its `src`.
+*
+* A newest-mtime comparison rather than a build system: it is wrong
+* only in the direction of building something that did not need it,
+* and a missing `dist` always builds. `--no-build` skips the question
+* entirely for the case where the caller knows.
+*/
+function needsBuild(pkg) {
+	const dir = join(workspaceRoot, "packages", pkg);
+	const dist = join(dir, "dist");
+	if (!existsSync(dist)) return true;
+	return newestChange(join(dir, "src")) > newestChange(dist);
+}
+/** The most recent modification time anywhere under a directory. */
+function newestChange(dir) {
+	let newest = 0;
+	for (const entry of readdirSync(dir, { withFileTypes: true })) {
+		const path = join(dir, entry.name);
+		newest = Math.max(newest, entry.isDirectory() ? newestChange(path) : statSync(path).mtimeMs);
+	}
+	return newest;
+}
+/**
+* Packs the workspace packages into the new project and returns the
+* `file:` specifier for each.
+*
+* The specifiers are relative to the project directory, so the whole
+* directory can be moved or copied and still install.
+*/
+function vendorPackages(options, template) {
+	if (options.build) {
+		const stale = template.vendored.filter(needsBuild);
+		if (stale.length > 0) {
+			console.log(`building ${stale.join(", ")}…`);
+			const filters = stale.flatMap((pkg) => ["--filter", `./packages/${pkg}`]);
+			execFileSync("pnpm", [...filters, "build"], {
+				cwd: workspaceRoot,
+				stdio: "ignore"
+			});
+		}
+	}
+	const into = join(options.target, VENDOR_DIR);
+	rmSync(into, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(into, { recursive: true });
+	console.log("packing them into the new project…");
+	const specifiers = /* @__PURE__ */ new Map();
+	for (const pkg of template.vendored) {
+		const before = new Set(readdirSync(into));
+		execFileSync("pnpm", [
+			"pack",
+			"--pack-destination",
+			into
+		], {
+			cwd: join(workspaceRoot, "packages", pkg),
+			stdio: "ignore"
+		});
+		const created = readdirSync(into).filter((entry) => !before.has(entry) && entry.endsWith(".tgz"));
+		if (created.length !== 1) fail(`pnpm pack in packages/${pkg} produced ${created.length} tarballs, expected 1.`);
+		specifiers.set(`gesso-${pkg}`, `file:${VENDOR_DIR}/${created[0]}`);
+	}
+	return specifiers;
+}
+/** Copies the template, renaming the files that had to be disguised. */
+function copyTemplate(from, options) {
+	cpSync(from, options.target, {
+		recursive: true,
+		force: true
+	});
+	for (const [disguised, real] of RENAMED) {
+		const path = join(options.target, disguised);
+		if (existsSync(path)) renameSync(path, join(options.target, real));
+	}
+}
+/**
+* Writes the project's name and its dependency specifiers.
+*
+* `overrides` carries the same specifiers, because the packages declare
+* each other by version range: `gesso-framework` and
+* `gesso-components` do, and so does `gesso-electrobun`. Without it an
+* installer is free to go looking for `gesso-core@^0.1.0` on a registry
+* that has never heard of it, and whether it does so depends on what
+* else is in the tree.
+*/
+function writeManifest(options, specifiers) {
+	const path = join(options.target, "package.json");
+	const manifest = JSON.parse(readFileSync(path, "utf8"));
+	manifest.name = options.name;
+	for (const [pkg, specifier] of specifiers) {
+		const where = manifest.dependencies[pkg] !== void 0 ? manifest.dependencies : manifest.devDependencies?.[pkg] !== void 0 ? manifest.devDependencies : void 0;
+		if (where === void 0) fail(`The ${options.template} template does not depend on ${pkg}, so there is nowhere to vendor it.`);
+		where[pkg] = specifier;
+	}
+	if (specifiers.size > 0) manifest.overrides = Object.fromEntries(specifiers);
+	else delete manifest.overrides;
+	writeFileSync(path, `${JSON.stringify(manifest, null, 2)}\n`);
+}
+/**
+* Says the same thing to pnpm that `overrides` says to npm.
+*
+* npm was chosen because pnpm did not work, and the reason is still
+* exactly right: `pnpm pack` rewrites `workspace:^`
+* into `^0.1.0`, so the packed `gesso-framework` asks for
+* `gesso-core@^0.1.0` and pnpm 11 goes to a registry that has never
+* heard of it. What that record then rejected was shipping a
+* `pnpm-workspace.yaml` in a project that is not a workspace.
+*
+* That trade has moved. The file is five lines, it is the only place
+* pnpm 11 reads `overrides` from, and the alternative is a scaffold
+* that fails for the package manager this repository itself uses. It
+* says what it is for and it is deleted along with `vendor/` the day
+* the packages are published.
+*/
+function writePnpmOverrides(options, specifiers) {
+	const lines = [
+		"# The tarballs in vendor/ again, for pnpm.",
+		"#",
+		"# Gesso is not published, so the packed gesso-* packages ask each",
+		"# other for version ranges no registry can answer. npm reads the",
+		"# `overrides` in package.json; pnpm 11 reads only this file. Both",
+		"# go away when the packages are on a registry: delete vendor/, this",
+		"# file and `overrides`, and put version ranges back.",
+		"overrides:",
+		...[...specifiers].map(([pkg, specifier]) => `  '${pkg}': '${specifier}'`),
+		""
+	];
+	writeFileSync(join(options.target, "pnpm-workspace.yaml"), lines.join("\n"));
+}
+/**
+* Substitutes the template's placeholders in the files that carry them.
+*
+* The list is the template's rather than a walk of the tree, so that a
+* placeholder added to a file nobody listed fails visibly in the
+* generated project instead of being quietly left as `{{name}}`
+* somewhere it is never read.
+*/
+function substitute(options, template) {
+	for (const relative of template.substitute) {
+		const path = join(options.target, relative);
+		if (!existsSync(path)) fail(`The ${options.template} template says ${relative} carries {{name}}, and it was not written.`);
+		writeFileSync(path, readFileSync(path, "utf8").replaceAll("{{name}}", options.name));
+	}
+}
+/**
+* Appends the `vendor/` explanation to the generated README.
+*
+* It lives here rather than in the template because a project made
+* without `--local` has no `vendor/`, and a README explaining a
+* directory that is not there is worse than one that says nothing.
+*/
+function explainVendoring(options) {
+	const path = join(options.target, "README.md");
+	if (!existsSync(path)) return;
+	const section = [
+		"",
+		"## Why `vendor/` exists, and how to remove it",
+		"",
+		"This project was scaffolded with `--local`, so it installs Gesso from",
+		"a checkout rather than from the registry: the packages were packed",
+		"into `vendor/` and the manifest points at the tarballs.",
+		"",
+		"The packed packages declare each other by version range, so without",
+		"help a package manager is free to go looking for `gesso-core@^0.1.0`",
+		"on the registry and get a different copy than the one beside it.",
+		"`overrides` in `package.json` is what tells npm; `overrides` in",
+		"`pnpm-workspace.yaml` is what tells pnpm, which reads it nowhere else.",
+		"",
+		"To pick up a further change, run `create-gesso-app --local` over this",
+		"directory again with `--force`.",
+		"",
+		"To move to the published packages: delete `vendor/`, delete",
+		"`pnpm-workspace.yaml`, delete `overrides`, and put version ranges back",
+		"in `dependencies`.",
+		""
+	].join("\n");
+	writeFileSync(path, readFileSync(path, "utf8").trimEnd() + "\n" + section);
+}
+function main() {
+	const options = parseArgs(process.argv.slice(2));
+	if (options.local && !existsSync(join(workspaceRoot, "packages", "core", "package.json"))) fail("--local packs the packages out of the Gesso workspace, and this is not one.\nRun it from inside a checkout, or drop --local to install from the registry.");
+	const template = templateOf(options.template);
+	prepareTarget(options);
+	copyTemplate(join(packageRoot, "templates", options.template), options);
+	const specifiers = options.local ? vendorPackages(options, template) : /* @__PURE__ */ new Map();
+	writeManifest(options, specifiers);
+	if (options.local) {
+		writePnpmOverrides(options, specifiers);
+		explainVendoring(options);
+	}
+	substitute(options, template);
+	const where = options.target.startsWith(process.cwd()) ? options.target.slice(process.cwd().length + 1) : options.target;
+	console.log(template.next(options.name, where, options.local));
+}
+main();
+//#endregion
+export {};
+
+//# sourceMappingURL=create-gesso-app.mjs.map

package/dist/create-gesso-app.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-gesso-app.mjs","names":[],"sources":["../bin/create-gesso-app.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `create-gesso-app`: scaffolds a Gesso application (the\n * last item).\n *\n * What it writes is the configuration this framework is for. The\n * application runs in a render worker; the page's own script creates\n * the app, hands it a worker constructor and mounts it, and that is the\n * whole of the main thread's job.\n *\n * The one thing this CLI does that a public scaffolder would not is\n * vendor its own dependencies. No `gesso-*` package is on a registry,\n * so a generated `package.json` that named a version would produce a\n * project that cannot install. Instead the CLI packs the packages a\n * template needs out of this workspace with `pnpm pack`, drops the\n * tarballs into the new project's `vendor/` directory and writes\n * `file:` specifiers at them. That is the same route\n * `scripts/check-install.ts` takes, and it is the route that exercises\n * each package's `publishConfig`, which is the only thing that rewrites\n * `exports` from `src/*.ts` to `dist`. This ends the day the packages\n * are published to a registry.\n *\n *   node packages/create-gesso-app/bin/create-gesso-app.ts ../my-app\n *   node packages/create-gesso-app/bin/create-gesso-app.ts ../my-app --no-build\n *   node packages/create-gesso-app/bin/create-gesso-app.ts ../my-app --template electrobun\n *\n * The two templates differ in what runs beneath the same application.\n * `web` is a Vite project a browser loads. `electrobun` is a native\n * window whose application layer is a separate process, and it is set\n * up by Hutch rather than by npm: the Electrobun SDK is projected into\n * a project by `hutch electrobun prepare` rather than installed from a\n * registry, so the generated project depends on the toolchain being\n * present and says so.\n */\nimport { execFileSync } from 'node:child_process';\nimport {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  readdirSync,\n  renameSync,\n  rmSync,\n  statSync,\n  writeFileSync\n} from 'node:fs';\nimport { basename, isAbsolute, join, resolve } from 'node:path';\n\n/** Where the packed tarballs land inside the generated project. */\nconst VENDOR_DIR = 'vendor';\n/** Template files whose names cannot be checked into this repository as-is. */\nconst RENAMED = new Map([['_gitignore', '.gitignore']]);\n\ninterface Template {\n  /** Workspace packages to pack into the project, in dependency order. */\n  readonly vendored: readonly string[];\n  /** Files carrying `{{name}}`, relative to the project directory. */\n  readonly substitute: readonly string[];\n  /** What to tell the person once the project is written. */\n  readonly next: (name: string, where: string, local: boolean) => string;\n}\n\n/**\n * The templates, and the two things that differ between them: what a\n * project depends on, and how a person starts it.\n *\n * `devtools` and `vite-plugin` joined the web template's first three\n * when the feedback loop was wired in by default:\n * the plugin is what writes the worker construction and the\n * hot-replacement wiring, and it loads the overlay from devtools the\n * first time the worker throws. Both are development dependencies of\n * the generated project and neither is reachable from a production\n * build.\n */\nconst TEMPLATES: Record<string, Template> = {\n  web: {\n    vendored: ['core', 'framework', 'components', 'devtools', 'vite-plugin'],\n    substitute: ['index.html', 'README.md'],\n    next: (name, where, local) =>\n      [\n        `\\nCreated ${name} in ${where}.\\n`,\n        `  cd ${where}`,\n        '  pnpm install     # or npm install',\n        '  pnpm dev\\n',\n        ...(local\n          ? [\n              'Gesso came from this workspace rather than the registry, packed into',\n              'vendor/. The packed packages ask each other for version ranges, so npm',\n              'is pointed at the tarballs by `overrides` in package.json and pnpm by',\n              \"`overrides` in pnpm-workspace.yaml. The project's README says how to\",\n              'move to the published packages.\\n'\n            ]\n          : [])\n      ].join('\\n')\n  },\n  electrobun: {\n    vendored: ['core', 'framework', 'components', 'electrobun'],\n    substitute: ['electrobun.config.ts', 'src/main/index.ts', 'src/view/index.html', 'README.md'],\n    next: (name, where) => `\nCreated ${name} in ${where}.\n\n  cd ${where}\n  hutch install\n  hutch run dev\n\nHutch rather than npm, and this is the part to read before running it.\nElectrobun 2.x is a toolchain a launcher downloads, not a package a\nregistry serves: \\`hutch electrobun prepare\\` projects the SDK into the\nproject's own .hutch/devkit, which is where vite.config.ts and\ntsconfig.json look for it, and every script in hutch.config.ts runs that\nfirst. \\`hutch install\\` runs npm underneath. If \\`hutch\\` is not on your\npath yet, the project's README says how to get it.\n\n\\`pnpm check:scaffold:electrobun\\` installs, typechecks and builds a\nproject like this one without opening it. The window itself is checked\nby running it; the README records the last time that was done.\n`\n  }\n};\n\nconst packageRoot = join(import.meta.dirname, '..');\nconst workspaceRoot = join(packageRoot, '..', '..');\n\ninterface Options {\n  readonly target: string;\n  readonly name: string;\n  readonly template: string;\n  readonly force: boolean;\n  readonly build: boolean;\n  /**\n   * Install the packages out of this workspace instead of the registry.\n   *\n   * What every scaffold did before the packages were published, kept\n   * because it is the only way to scaffold a project against changes\n   * that are not released yet. `pnpm check:scaffold` runs this way, so\n   * the gate tests the working tree rather than the last release.\n   */\n  readonly local: boolean;\n}\n\nconst USAGE = `Usage: create-gesso-app <directory> [options]\n\nCreates a Gesso application in <directory>: a project whose interface is\nbuilt, laid out and painted in a render worker.\n\nOptions:\n  --name <name>     Package name for the new project. Defaults to the\n                    directory's own name.\n  --template <name> \"web\" for a Vite project a browser loads, or\n                    \"electrobun\" for a native window with its state in a\n                    main process. Defaults to \"web\".\n  --force           Write into a directory that already has files in it.\n  --local           Install the Gesso packages from this workspace, packed\n                    into the project, instead of from the registry. Only\n                    works inside a Gesso checkout.\n  --no-build        With --local, pack without rebuilding first. Only safe\n                    when dist/ is already current.\n  -h, --help        Print this.\n`;\n\nfunction fail(message: string): never {\n  console.error(message);\n  process.exit(1);\n}\n\nfunction parseArgs(argv: readonly string[]): Options {\n  let target: string | undefined;\n  let name: string | undefined;\n  let template = 'web';\n  let force = false;\n  let build = true;\n  let local = false;\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i];\n    switch (arg) {\n      case '-h':\n      case '--help':\n        console.log(USAGE);\n        process.exit(0);\n        break;\n      case '--force':\n        force = true;\n        break;\n      case '--local':\n        local = true;\n        break;\n      case '--no-build':\n        build = false;\n        break;\n      case '--name':\n        name = argv[++i];\n        break;\n      case '--template':\n        template = argv[++i] ?? '';\n        break;\n      default:\n        if (arg.startsWith('-')) {\n          fail(`Unknown option ${arg}.\\n\\n${USAGE}`);\n        }\n        if (target !== undefined) {\n          fail(`Two directories were given, ${target} and ${arg}.\\n\\n${USAGE}`);\n        }\n        target = arg;\n    }\n  }\n\n  if (target === undefined) {\n    fail(`A directory to create is required.\\n\\n${USAGE}`);\n  }\n  if (name !== undefined && !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {\n    fail(`\"${name}\" is not a usable package name: use lowercase letters, digits, dots, dashes and underscores.`);\n  }\n\n  const absolute = isAbsolute(target) ? target : resolve(process.cwd(), target);\n  return { target: absolute, name: name ?? basename(absolute), template, force, build, local };\n}\n\n/** Looks a template up, and lists the ones that exist when it is not one. */\nfunction templateOf(name: string): Template {\n  const template = TEMPLATES[name];\n  if (template === undefined || !existsSync(join(packageRoot, 'templates', name))) {\n    fail(`There is no \"${name}\" template. Available: ${Object.keys(TEMPLATES).join(', ')}.`);\n  }\n  return template;\n}\n\nfunction prepareTarget(options: Options): void {\n  if (!existsSync(options.target)) {\n    mkdirSync(options.target, { recursive: true });\n    return;\n  }\n  const existing = readdirSync(options.target);\n  if (existing.length > 0 && !options.force) {\n    fail(`${options.target} is not empty (${existing.length} entries). Pass --force to write into it anyway.`);\n  }\n}\n\n/**\n * Whether a package's `dist` is older than anything in its `src`.\n *\n * A newest-mtime comparison rather than a build system: it is wrong\n * only in the direction of building something that did not need it,\n * and a missing `dist` always builds. `--no-build` skips the question\n * entirely for the case where the caller knows.\n */\nfunction needsBuild(pkg: string): boolean {\n  const dir = join(workspaceRoot, 'packages', pkg);\n  const dist = join(dir, 'dist');\n  if (!existsSync(dist)) {\n    return true;\n  }\n  return newestChange(join(dir, 'src')) > newestChange(dist);\n}\n\n/** The most recent modification time anywhere under a directory. */\nfunction newestChange(dir: string): number {\n  let newest = 0;\n  for (const entry of readdirSync(dir, { withFileTypes: true })) {\n    const path = join(dir, entry.name);\n    newest = Math.max(newest, entry.isDirectory() ? newestChange(path) : statSync(path).mtimeMs);\n  }\n  return newest;\n}\n\n/**\n * Packs the workspace packages into the new project and returns the\n * `file:` specifier for each.\n *\n * The specifiers are relative to the project directory, so the whole\n * directory can be moved or copied and still install.\n */\nfunction vendorPackages(options: Options, template: Template): Map<string, string> {\n  if (options.build) {\n    // Only the packages that go into the project, and only the ones\n    // whose `dist` is older than their `src`. Building the whole\n    // workspace took the better part of a minute for a scaffold that\n    // does not install two of the packages it built, and every second\n    // of it was spent between a person typing a command and seeing\n    // anything happen.\n    const stale = template.vendored.filter(needsBuild);\n    if (stale.length > 0) {\n      console.log(`building ${stale.join(', ')}…`);\n      const filters = stale.flatMap(pkg => ['--filter', `./packages/${pkg}`]);\n      execFileSync('pnpm', [...filters, 'build'], { cwd: workspaceRoot, stdio: 'ignore' });\n    }\n  }\n\n  const into = join(options.target, VENDOR_DIR);\n  rmSync(into, { recursive: true, force: true });\n  mkdirSync(into, { recursive: true });\n\n  console.log('packing them into the new project…');\n  const specifiers = new Map<string, string>();\n  for (const pkg of template.vendored) {\n    const before = new Set(readdirSync(into));\n    execFileSync('pnpm', ['pack', '--pack-destination', into], {\n      cwd: join(workspaceRoot, 'packages', pkg),\n      stdio: 'ignore'\n    });\n    const created = readdirSync(into).filter(entry => !before.has(entry) && entry.endsWith('.tgz'));\n    if (created.length !== 1) {\n      fail(`pnpm pack in packages/${pkg} produced ${created.length} tarballs, expected 1.`);\n    }\n    specifiers.set(`gesso-${pkg}`, `file:${VENDOR_DIR}/${created[0]}`);\n  }\n  return specifiers;\n}\n\n/** Copies the template, renaming the files that had to be disguised. */\nfunction copyTemplate(from: string, options: Options): void {\n  // `force` here is not the option of the same name: whether writing\n  // into an occupied directory is allowed was settled by `prepareTarget`,\n  // and a template file always wins over whatever it lands on.\n  cpSync(from, options.target, { recursive: true, force: true });\n  for (const [disguised, real] of RENAMED) {\n    const path = join(options.target, disguised);\n    if (existsSync(path)) {\n      renameSync(path, join(options.target, real));\n    }\n  }\n}\n\n/**\n * Writes the project's name and its dependency specifiers.\n *\n * `overrides` carries the same specifiers, because the packages declare\n * each other by version range: `gesso-framework` and\n * `gesso-components` do, and so does `gesso-electrobun`. Without it an\n * installer is free to go looking for `gesso-core@^0.1.0` on a registry\n * that has never heard of it, and whether it does so depends on what\n * else is in the tree.\n */\nfunction writeManifest(options: Options, specifiers: ReadonlyMap<string, string>): void {\n  const path = join(options.target, 'package.json');\n  const manifest = JSON.parse(readFileSync(path, 'utf8')) as {\n    name: string;\n    dependencies: Record<string, string>;\n    devDependencies?: Record<string, string>;\n    overrides?: Record<string, string>;\n  };\n  manifest.name = options.name;\n  for (const [pkg, specifier] of specifiers) {\n    // The plugin and the overlay are development dependencies and the\n    // runtime packages are not, so the specifier goes wherever the\n    // template already declared the package.\n    const where =\n      manifest.dependencies[pkg] !== undefined\n        ? manifest.dependencies\n        : manifest.devDependencies?.[pkg] !== undefined\n          ? manifest.devDependencies\n          : undefined;\n    if (where === undefined) {\n      fail(`The ${options.template} template does not depend on ${pkg}, so there is nowhere to vendor it.`);\n    }\n    where[pkg] = specifier;\n  }\n  if (specifiers.size > 0) {\n    manifest.overrides = Object.fromEntries(specifiers);\n  } else {\n    delete manifest.overrides;\n  }\n  writeFileSync(path, `${JSON.stringify(manifest, null, 2)}\\n`);\n}\n\n/**\n * Says the same thing to pnpm that `overrides` says to npm.\n *\n * npm was chosen because pnpm did not work, and the reason is still\n * exactly right: `pnpm pack` rewrites `workspace:^`\n * into `^0.1.0`, so the packed `gesso-framework` asks for\n * `gesso-core@^0.1.0` and pnpm 11 goes to a registry that has never\n * heard of it. What that record then rejected was shipping a\n * `pnpm-workspace.yaml` in a project that is not a workspace.\n *\n * That trade has moved. The file is five lines, it is the only place\n * pnpm 11 reads `overrides` from, and the alternative is a scaffold\n * that fails for the package manager this repository itself uses. It\n * says what it is for and it is deleted along with `vendor/` the day\n * the packages are published.\n */\nfunction writePnpmOverrides(options: Options, specifiers: ReadonlyMap<string, string>): void {\n  const lines = [\n    '# The tarballs in vendor/ again, for pnpm.',\n    '#',\n    '# Gesso is not published, so the packed gesso-* packages ask each',\n    '# other for version ranges no registry can answer. npm reads the',\n    '# `overrides` in package.json; pnpm 11 reads only this file. Both',\n    '# go away when the packages are on a registry: delete vendor/, this',\n    '# file and `overrides`, and put version ranges back.',\n    'overrides:',\n    ...[...specifiers].map(([pkg, specifier]) => `  '${pkg}': '${specifier}'`),\n    ''\n  ];\n  writeFileSync(join(options.target, 'pnpm-workspace.yaml'), lines.join('\\n'));\n}\n\n/**\n * Substitutes the template's placeholders in the files that carry them.\n *\n * The list is the template's rather than a walk of the tree, so that a\n * placeholder added to a file nobody listed fails visibly in the\n * generated project instead of being quietly left as `{{name}}`\n * somewhere it is never read.\n */\nfunction substitute(options: Options, template: Template): void {\n  for (const relative of template.substitute) {\n    const path = join(options.target, relative);\n    if (!existsSync(path)) {\n      fail(`The ${options.template} template says ${relative} carries {{name}}, and it was not written.`);\n    }\n    writeFileSync(path, readFileSync(path, 'utf8').replaceAll('{{name}}', options.name));\n  }\n}\n\n/**\n * Appends the `vendor/` explanation to the generated README.\n *\n * It lives here rather than in the template because a project made\n * without `--local` has no `vendor/`, and a README explaining a\n * directory that is not there is worse than one that says nothing.\n */\nfunction explainVendoring(options: Options): void {\n  const path = join(options.target, 'README.md');\n  if (!existsSync(path)) {\n    return;\n  }\n  const section = [\n    '',\n    '## Why `vendor/` exists, and how to remove it',\n    '',\n    'This project was scaffolded with `--local`, so it installs Gesso from',\n    'a checkout rather than from the registry: the packages were packed',\n    'into `vendor/` and the manifest points at the tarballs.',\n    '',\n    'The packed packages declare each other by version range, so without',\n    'help a package manager is free to go looking for `gesso-core@^0.1.0`',\n    'on the registry and get a different copy than the one beside it.',\n    '`overrides` in `package.json` is what tells npm; `overrides` in',\n    '`pnpm-workspace.yaml` is what tells pnpm, which reads it nowhere else.',\n    '',\n    'To pick up a further change, run `create-gesso-app --local` over this',\n    'directory again with `--force`.',\n    '',\n    'To move to the published packages: delete `vendor/`, delete',\n    '`pnpm-workspace.yaml`, delete `overrides`, and put version ranges back',\n    'in `dependencies`.',\n    ''\n  ].join('\\n');\n  writeFileSync(path, readFileSync(path, 'utf8').trimEnd() + '\\n' + section);\n}\n\nfunction main(): void {\n  const options = parseArgs(process.argv.slice(2));\n  if (options.local && !existsSync(join(workspaceRoot, 'packages', 'core', 'package.json'))) {\n    fail(\n      '--local packs the packages out of the Gesso workspace, and this is not one.\\n' +\n        'Run it from inside a checkout, or drop --local to install from the registry.'\n    );\n  }\n\n  const template = templateOf(options.template);\n  prepareTarget(options);\n  copyTemplate(join(packageRoot, 'templates', options.template), options);\n  // Without --local the template's own version ranges are the answer,\n  // and the manifest needs nothing but its name.\n  const specifiers = options.local ? vendorPackages(options, template) : new Map<string, string>();\n  writeManifest(options, specifiers);\n  if (options.local) {\n    writePnpmOverrides(options, specifiers);\n    explainVendoring(options);\n  }\n  substitute(options, template);\n\n  const where = options.target.startsWith(process.cwd())\n    ? options.target.slice(process.cwd().length + 1)\n    : options.target;\n  console.log(template.next(options.name, where, options.local));\n}\n\nmain();\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "create-gesso-app",
+  "version": "0.1.0",
+  "description": "Scaffolds a Gesso application: a Vite project whose interface runs in a render worker.",
+  "license": "MIT",
+  "author": "Kevin Baker",
+  "homepage": "https://gesso-docs.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kevinpbaker/gesso.git",
+    "directory": "packages/create-gesso-app"
+  },
+  "bugs": {
+    "url": "https://github.com/kevinpbaker/gesso/issues"
+  },
+  "keywords": [
+    "gesso",
+    "canvas",
+    "ui",
+    "typescript",
+    "scaffold",
+    "starter",
+    "cli",
+    "create-app",
+    "template"
+  ],
+  "type": "module",
+  "bin": {
+    "create-gesso-app": "./dist/create-gesso-app.mjs"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "files": [
+    "README.md",
+    "CHANGELOG.md",
+    "dist",
+    "LICENSE",
+    "templates"
+  ],
+  "devDependencies": {
+    "tsdown": "^0.22.14"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}