create-atom.io 0.0.0

package/bin/create-atom.bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/create-atom.x.js";

package/dist/create-atom-BV6WVRvY.js

@@ -0,0 +1,102 @@
+import { existsSync, promises } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import * as prompts from "@clack/prompts";
+import picocolors from "picocolors";
+import { x } from "tinyexec";
+
+//#region src/create-atom.ts
+const pico = picocolors.createColors(true);
+const s = prompts.spinner();
+async function createAtom(argDir, options) {
+	const skipHint = options.skipHints ?? false;
+	const packageManager = options.packageManager ?? getPkgManager();
+	prompts.intro(pico.greenBright(`atom.io - Data Components for TypeScript`));
+	const { dir } = await prompts.group({ dir: () => argDir ? Promise.resolve(argDir) : prompts.text({
+		message: `Project directory:`,
+		placeholder: `my-preact-app`,
+		validate(value) {
+			if (value.length === 0) return `Directory name is required!`;
+			if (existsSync(value)) return `Refusing to overwrite existing directory or file! Please provide a non-clashing name.`;
+		}
+	}) }, { onCancel: () => {
+		prompts.cancel(pico.yellow(`Cancelled`));
+		process.exit(0);
+	} });
+	const targetDir = resolve(process.cwd(), dir);
+	const opts = { packageManager };
+	await useSpinner(`Setting up your project directory...`, () => scaffold(targetDir, opts), `Set up project directory`);
+	await useSpinner(`Installing project dependencies...`, () => installDeps(targetDir, opts), `Installed project dependencies`);
+	if (skipHint === false) {
+		const gettingStarted = `
+			${pico.dim(`$`)} ${pico.blueBright(`cd ${dir}`)}
+			${pico.dim(`$`)} ${pico.blueBright(`${packageManager === `npm` ? `npm run` : packageManager === `bun` ? `bun run` : packageManager} dev`)}
+		`;
+		prompts.note(gettingStarted.trim().replace(/^\t\t\t/gm, ``), `Getting Started`);
+	}
+	prompts.outro(pico.green(`You're all set!`));
+}
+async function useSpinner(startMessage, fn, finishMessage) {
+	s.start(startMessage);
+	await fn();
+	s.stop(pico.green(finishMessage));
+}
+async function scaffold(to, opts) {
+	await promises.mkdir(to, { recursive: true });
+	await templateDir(resolve(dirname(fileURLToPath(import.meta.url)), `../templates`, `base`), to, opts);
+}
+/**
+* Recursive fs copy, swiped from `create-wmr`:
+* https://github.com/preactjs/wmr/blob/3c5672ecd2f958c8eaf372d33c084dc69228ae3f/packages/create-wmr/src/index.js#L108-L124
+*/
+async function templateDir(from, to, opts) {
+	const files = await promises.readdir(from);
+	return (await Promise.all(files.map(async (f) => {
+		if (f === `.` || f === `..`) return;
+		const filename = resolve(from, f);
+		if ((await promises.stat(filename)).isDirectory()) {
+			await promises.mkdir(resolve(to, f), { recursive: true });
+			return templateDir(filename, resolve(to, f), opts);
+		}
+		if (opts.packageManager !== `npm` && f === `README.md`) {
+			await promises.writeFile(resolve(to, f), (await promises.readFile(filename, `utf-8`)).replace(/npm run/g, opts.packageManager === `bun` ? `bun run` : opts.packageManager));
+			return;
+		}
+		if (f === `_gitignore`) f = `.gitignore`;
+		await promises.copyFile(filename, resolve(to, f));
+	}))).flat(99);
+}
+async function installDeps(to, opts) {
+	const dependencies = [];
+	const devDependencies = [];
+	const installOpts = {
+		packageManager: opts.packageManager,
+		to
+	};
+	await installPackages(dependencies, { ...installOpts });
+	devDependencies.length && await installPackages(devDependencies, {
+		...installOpts,
+		dev: true
+	});
+}
+function installPackages(pkgs, opts) {
+	return x(opts.packageManager, [
+		opts.packageManager === `yarn` ? pkgs.length ? `add` : `` : `install`,
+		opts.dev ? `-D` : ``,
+		...pkgs
+	].filter(Boolean), { nodeOptions: {
+		stdio: `ignore`,
+		cwd: opts.to
+	} });
+}
+function getPkgManager() {
+	const userAgent = process.env[`npm_config_user_agent`] ?? ``;
+	if (userAgent.startsWith(`yarn`)) return `yarn`;
+	if (userAgent.startsWith(`pnpm`)) return `pnpm`;
+	if (userAgent.startsWith(`bun`)) return `bun`;
+	return `npm`;
+}
+
+//#endregion
+export { pico as n, createAtom as t };
+//# sourceMappingURL=create-atom-BV6WVRvY.js.map

package/dist/create-atom-BV6WVRvY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-atom-BV6WVRvY.js","names":["pico: Colors","opts: CreateAtomOptions","fs","dependencies: string[]","devDependencies: string[]"],"sources":["../src/create-atom.ts"],"sourcesContent":["import { existsSync, promises as fs } from \"node:fs\"\nimport { dirname, resolve } from \"node:path\"\nimport { fileURLToPath } from \"node:url\"\n\nimport * as prompts from \"@clack/prompts\"\nimport picocolors from \"picocolors\"\nimport type { Colors } from \"picocolors/types\"\nimport { x } from \"tinyexec\"\n\nexport const pico: Colors = picocolors.createColors(true)\n\nconst s = prompts.spinner()\n\nexport type CreateAtomOptions = {\n\tpackageManager: `bun` | `npm` | `pnpm` | `yarn`\n}\n\nexport type CreateAtomOptionsPreloaded = {\n\t[K in keyof CreateAtomOptions]?: CreateAtomOptions[K] | undefined\n} & { skipHints?: boolean | undefined }\n\nexport async function createAtom(\n\targDir: string | undefined,\n\toptions: CreateAtomOptionsPreloaded,\n): Promise<void> {\n\tconst skipHint = options.skipHints ?? false\n\tconst packageManager = options.packageManager ?? getPkgManager()\n\n\tprompts.intro(pico.greenBright(`atom.io - Data Components for TypeScript`))\n\n\tconst { dir } = await prompts.group(\n\t\t{\n\t\t\tdir: () =>\n\t\t\t\targDir\n\t\t\t\t\t? Promise.resolve(argDir)\n\t\t\t\t\t: prompts.text({\n\t\t\t\t\t\t\tmessage: `Project directory:`,\n\t\t\t\t\t\t\tplaceholder: `my-preact-app`,\n\t\t\t\t\t\t\tvalidate(value) {\n\t\t\t\t\t\t\t\tif (value.length === 0) {\n\t\t\t\t\t\t\t\t\treturn `Directory name is required!`\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t\tif (existsSync(value)) {\n\t\t\t\t\t\t\t\t\treturn `Refusing to overwrite existing directory or file! Please provide a non-clashing name.`\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t}),\n\t\t},\n\t\t{\n\t\t\tonCancel: () => {\n\t\t\t\tprompts.cancel(pico.yellow(`Cancelled`))\n\t\t\t\tprocess.exit(0)\n\t\t\t},\n\t\t},\n\t)\n\tconst targetDir = resolve(process.cwd(), dir)\n\tconst opts: CreateAtomOptions = { packageManager }\n\n\tawait useSpinner(\n\t\t`Setting up your project directory...`,\n\t\t() => scaffold(targetDir, opts),\n\t\t`Set up project directory`,\n\t)\n\n\tawait useSpinner(\n\t\t`Installing project dependencies...`,\n\t\t() => installDeps(targetDir, opts),\n\t\t`Installed project dependencies`,\n\t)\n\n\tif (skipHint === false) {\n\t\tconst gettingStarted = `\n\t\t\t${pico.dim(`$`)} ${pico.blueBright(`cd ${dir}`)}\n\t\t\t${pico.dim(`$`)} ${pico.blueBright(\n\t\t\t\t`${\n\t\t\t\t\tpackageManager === `npm`\n\t\t\t\t\t\t? `npm run`\n\t\t\t\t\t\t: packageManager === `bun`\n\t\t\t\t\t\t\t? `bun run`\n\t\t\t\t\t\t\t: packageManager\n\t\t\t\t} dev`,\n\t\t\t)}\n\t\t`\n\t\tprompts.note(\n\t\t\tgettingStarted.trim().replace(/^\\t\\t\\t/gm, ``),\n\t\t\t`Getting Started`,\n\t\t)\n\t}\n\n\tprompts.outro(pico.green(`You're all set!`))\n}\n\nasync function useSpinner(\n\tstartMessage: string,\n\tfn: () => Promise<void>,\n\tfinishMessage: string,\n): Promise<void> {\n\ts.start(startMessage)\n\tawait fn()\n\ts.stop(pico.green(finishMessage))\n}\n\nasync function scaffold(to: string, opts: CreateAtomOptions): Promise<void> {\n\tawait fs.mkdir(to, { recursive: true })\n\n\tconst __dirname = dirname(fileURLToPath(import.meta.url))\n\tawait templateDir(resolve(__dirname, `../templates`, `base`), to, opts)\n}\n\n/**\n * Recursive fs copy, swiped from `create-wmr`:\n * https://github.com/preactjs/wmr/blob/3c5672ecd2f958c8eaf372d33c084dc69228ae3f/packages/create-wmr/src/index.js#L108-L124\n */\nasync function templateDir(\n\tfrom: string,\n\tto: string,\n\topts: CreateAtomOptions,\n): Promise<void[]> {\n\tconst files = await fs.readdir(from)\n\tconst results = await Promise.all(\n\t\tfiles.map(async (f) => {\n\t\t\tif (f === `.` || f === `..`) return\n\t\t\tconst filename = resolve(from, f)\n\t\t\tif ((await fs.stat(filename)).isDirectory()) {\n\t\t\t\tawait fs.mkdir(resolve(to, f), { recursive: true })\n\t\t\t\treturn templateDir(filename, resolve(to, f), opts)\n\t\t\t}\n\t\t\tif (opts.packageManager !== `npm` && f === `README.md`) {\n\t\t\t\tawait fs.writeFile(\n\t\t\t\t\tresolve(to, f),\n\t\t\t\t\t(await fs.readFile(filename, `utf-8`)).replace(\n\t\t\t\t\t\t/npm run/g,\n\t\t\t\t\t\topts.packageManager === `bun` ? `bun run` : opts.packageManager,\n\t\t\t\t\t),\n\t\t\t\t)\n\t\t\t\treturn\n\t\t\t}\n\t\t\t// Publishing to npm renames the .gitignore to .npmignore\n\t\t\t// https://github.com/npm/npm/issues/7252#issuecomment-253339460\n\t\t\tif (f === `_gitignore`) f = `.gitignore`\n\t\t\tawait fs.copyFile(filename, resolve(to, f))\n\t\t}),\n\t)\n\treturn results.flat(99)\n}\n\nasync function installDeps(to: string, opts: CreateAtomOptions) {\n\tconst dependencies: string[] = []\n\tconst devDependencies: string[] = []\n\n\tconst installOpts = {\n\t\tpackageManager: opts.packageManager,\n\t\tto,\n\t}\n\n\tawait installPackages(dependencies, { ...installOpts })\n\tdevDependencies.length &&\n\t\t(await installPackages(devDependencies, { ...installOpts, dev: true }))\n}\n\ntype InstallOptions = {\n\tpackageManager: `bun` | `npm` | `pnpm` | `yarn`\n\tto: string\n\tdev?: boolean\n}\n\nfunction installPackages(pkgs: string[], opts: InstallOptions) {\n\treturn x(\n\t\topts.packageManager,\n\t\t[\n\t\t\t// `yarn add` will fail if nothing is provided\n\t\t\topts.packageManager === `yarn` ? (pkgs.length ? `add` : ``) : `install`,\n\t\t\topts.dev ? `-D` : ``,\n\t\t\t...pkgs,\n\t\t].filter(Boolean),\n\t\t{\n\t\t\tnodeOptions: {\n\t\t\t\tstdio: `ignore`,\n\t\t\t\tcwd: opts.to,\n\t\t\t},\n\t\t},\n\t)\n}\n\nfunction getPkgManager(): `bun` | `npm` | `pnpm` | `yarn` {\n\tconst userAgent = process.env[`npm_config_user_agent`] ?? ``\n\tif (userAgent.startsWith(`yarn`)) return `yarn`\n\tif (userAgent.startsWith(`pnpm`)) return `pnpm`\n\tif (userAgent.startsWith(`bun`)) return `bun`\n\treturn `npm`\n}\n"],"mappings":"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"}

package/dist/create-atom.d.ts

@@ -0,0 +1,14 @@
+import { Colors } from "picocolors/types";
+
+//#region src/create-atom.d.ts
+declare const pico: Colors;
+type CreateAtomOptions = {
+  packageManager: `bun` | `npm` | `pnpm` | `yarn`;
+};
+type CreateAtomOptionsPreloaded = { [K in keyof CreateAtomOptions]?: CreateAtomOptions[K] | undefined } & {
+  skipHints?: boolean | undefined;
+};
+declare function createAtom(argDir: string | undefined, options: CreateAtomOptionsPreloaded): Promise<void>;
+//#endregion
+export { CreateAtomOptions, CreateAtomOptionsPreloaded, createAtom, pico };
+//# sourceMappingURL=create-atom.d.ts.map

package/dist/create-atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-atom.d.ts","names":["pico: Colors"],"sources":["../src/create-atom.ts"],"sourcesContent":[],"mappings":";;;cASaA,MAAM;KAIP,iBAAA;EAJZ,cAAmB,EAAA,KAAA,GAAA,KAAA,GAAA,MAAA,GAAA,MAAA;AAInB,CAAA;AAIY,KAAA,0BAAA,GAAA,QAAA,MACC,iBADD,IACsB,iBADtB,CACwC,CADxC,CAAA,GAAA,SAAA,EAAA,GAAA;EACC,SAAA,CAAA,EAAA,OAAA,GAAA,SAAA;CAAqB;AAAkB,iBAG9B,UAAA,CAH8B,MAAA,EAAA,MAAA,GAAA,SAAA,EAAA,OAAA,EAK1C,0BAL0C,CAAA,EAMjD,OANiD,CAAA,IAAA,CAAA"}

package/dist/create-atom.js

@@ -0,0 +1,3 @@
+import { n as pico, t as createAtom } from "./create-atom-BV6WVRvY.js";
+
+export { createAtom, pico };

package/dist/create-atom.x.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { t as createAtom } from "./create-atom-BV6WVRvY.js";
+import { cli, helpOption, optional, parseBooleanOption } from "comline";
+import { z } from "zod/v4";
+
+//#region src/create-atom.x.ts
+const helper = helpOption();
+const CREATE_ATOM_OPTS = {
+	description: `Check for breaking changes in a package.`,
+	optionsSchema: z.object({
+		packageManager: z.union([
+			z.literal(`bun`),
+			z.literal(`npm`),
+			z.literal(`pnpm`),
+			z.literal(`yarn`)
+		]).optional(),
+		skipHints: z.boolean().optional()
+	}),
+	options: {
+		...helper.options,
+		packageManager: {
+			flag: `m`,
+			required: false,
+			description: `The package manager to use.`,
+			example: `--packageManager="npm"`
+		},
+		skipHints: {
+			flag: `k`,
+			required: false,
+			description: `Silences the 'Getting Started' info, mainly for use in other initializers that may wrap this one but provide their own scripts/instructions.`,
+			example: `--skipHints`,
+			parse: parseBooleanOption
+		}
+	}
+};
+const { inputs } = cli({
+	cliName: `create-atom`,
+	routes: optional({ $projectName: null }),
+	routeOptions: {
+		"": CREATE_ATOM_OPTS,
+		$projectName: CREATE_ATOM_OPTS
+	}
+}, {
+	error: console.error.bind(console),
+	info: () => {}
+})(process.argv);
+await createAtom(inputs.path[0], inputs.opts);
+
+//#endregion
+export {  };
+//# sourceMappingURL=create-atom.x.js.map

package/dist/create-atom.x.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-atom.x.js","names":[],"sources":["../src/create-atom.x.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport type { OptionsGroup } from \"comline\"\nimport { cli, helpOption, optional, parseBooleanOption } from \"comline\"\nimport { z } from \"zod/v4\"\n\nimport type { CreateAtomOptionsPreloaded } from \"./create-atom.ts\"\nimport { createAtom } from \"./create-atom.ts\"\n\nconst helper = helpOption()\n\nconst CREATE_ATOM_OPTS = {\n\tdescription: `Check for breaking changes in a package.`,\n\toptionsSchema: z.object({\n\t\tpackageManager: z\n\t\t\t.union([\n\t\t\t\tz.literal(`bun`),\n\t\t\t\tz.literal(`npm`),\n\t\t\t\tz.literal(`pnpm`),\n\t\t\t\tz.literal(`yarn`),\n\t\t\t])\n\t\t\t.optional(),\n\t\tskipHints: z.boolean().optional(),\n\t}),\n\toptions: {\n\t\t...helper.options,\n\t\tpackageManager: {\n\t\t\tflag: `m`,\n\t\t\trequired: false,\n\t\t\tdescription: `The package manager to use.`,\n\t\t\texample: `--packageManager=\"npm\"`,\n\t\t},\n\t\tskipHints: {\n\t\t\tflag: `k`,\n\t\t\trequired: false,\n\t\t\tdescription: `Silences the 'Getting Started' info, mainly for use in other initializers that may wrap this one but provide their own scripts/instructions.`,\n\t\t\texample: `--skipHints`,\n\t\t\tparse: parseBooleanOption,\n\t\t},\n\t},\n} satisfies OptionsGroup<CreateAtomOptionsPreloaded>\n\nconst parse = cli(\n\t{\n\t\tcliName: `create-atom`,\n\t\troutes: optional({ $projectName: null }),\n\t\trouteOptions: {\n\t\t\t\"\": CREATE_ATOM_OPTS,\n\t\t\t$projectName: CREATE_ATOM_OPTS,\n\t\t},\n\t},\n\t{\n\t\terror: console.error.bind(console),\n\t\tinfo: () => {},\n\t},\n)\nconst { inputs } = parse(process.argv)\n\nawait createAtom(inputs.path[0], inputs.opts)\n"],"mappings":";;;;;;AASA,MAAM,SAAS,YAAY;AAE3B,MAAM,mBAAmB;CACxB,aAAa;CACb,eAAe,EAAE,OAAO;EACvB,gBAAgB,EACd,MAAM;GACN,EAAE,QAAQ,MAAM;GAChB,EAAE,QAAQ,MAAM;GAChB,EAAE,QAAQ,OAAO;GACjB,EAAE,QAAQ,OAAO;GACjB,CAAC,CACD,UAAU;EACZ,WAAW,EAAE,SAAS,CAAC,UAAU;EACjC,CAAC;CACF,SAAS;EACR,GAAG,OAAO;EACV,gBAAgB;GACf,MAAM;GACN,UAAU;GACV,aAAa;GACb,SAAS;GACT;EACD,WAAW;GACV,MAAM;GACN,UAAU;GACV,aAAa;GACb,SAAS;GACT,OAAO;GACP;EACD;CACD;AAgBD,MAAM,EAAE,WAdM,IACb;CACC,SAAS;CACT,QAAQ,SAAS,EAAE,cAAc,MAAM,CAAC;CACxC,cAAc;EACb,IAAI;EACJ,cAAc;EACd;CACD,EACD;CACC,OAAO,QAAQ,MAAM,KAAK,QAAQ;CAClC,YAAY;CACZ,CACD,CACwB,QAAQ,KAAK;AAEtC,MAAM,WAAW,OAAO,KAAK,IAAI,OAAO,KAAK"}

package/package.json

@@ -0,0 +1,56 @@
+{
+	"name": "create-atom.io",
+	"version": "0.0.0",
+	"license": "MIT",
+	"author": {
+		"name": "Jeremy Banka",
+		"email": "hello@jeremybanka.com"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/jeremybanka/wayforge.git",
+		"directory": "packages/create-atom"
+	},
+	"type": "module",
+	"files": [
+		"bin",
+		"dist",
+		"src",
+		"templates"
+	],
+	"main": "dist/create-atom.js",
+	"types": "dist/create-atom.d.ts",
+	"bin": "./bin/create-atom.bin.js",
+	"dependencies": {
+		"@clack/prompts": "0.11.0",
+		"comline": "workspace:*",
+		"picocolors": "1.1.1",
+		"tinyexec": "1.0.1",
+		"zod": "3.25.76"
+	},
+	"scripts": {
+		"build": "tsdown && rm -f dist/*.x.d.ts",
+		"lint:biome": "biome check -- .",
+		"lint:eslint": "eslint -- .",
+		"lint:types": "tsgo --noEmit",
+		"watch:types": "tsgo --watch --noEmit",
+		"lint": "concurrently \"bun:lint:*\"",
+		"test": "bun test --watch -- **/*.test.ts",
+		"test:once": "bun test -- **/*.test.ts",
+		"postversion": "biome format --write package.json"
+	},
+	"devDependencies": {
+		"@types/node": "24.9.1",
+		"@types/bun": "npm:bun-types@1.3.1",
+		"@types/tmp": "0.2.6",
+		"@typescript/native-preview": "7.0.0-dev.20251025.1",
+		"concurrently": "9.2.1",
+		"eslint": "9.38.0",
+		"rimraf": "6.0.1",
+		"tmp": "0.2.5",
+		"tsdown": "0.15.9"
+	}
+}

package/src/create-atom.ts

@@ -0,0 +1,191 @@
+import { existsSync, promises as fs } from "node:fs"
+import { dirname, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+import * as prompts from "@clack/prompts"
+import picocolors from "picocolors"
+import type { Colors } from "picocolors/types"
+import { x } from "tinyexec"
+
+export const pico: Colors = picocolors.createColors(true)
+
+const s = prompts.spinner()
+
+export type CreateAtomOptions = {
+	packageManager: `bun` | `npm` | `pnpm` | `yarn`
+}
+
+export type CreateAtomOptionsPreloaded = {
+	[K in keyof CreateAtomOptions]?: CreateAtomOptions[K] | undefined
+} & { skipHints?: boolean | undefined }
+
+export async function createAtom(
+	argDir: string | undefined,
+	options: CreateAtomOptionsPreloaded,
+): Promise<void> {
+	const skipHint = options.skipHints ?? false
+	const packageManager = options.packageManager ?? getPkgManager()
+
+	prompts.intro(pico.greenBright(`atom.io - Data Components for TypeScript`))
+
+	const { dir } = await prompts.group(
+		{
+			dir: () =>
+				argDir
+					? Promise.resolve(argDir)
+					: prompts.text({
+							message: `Project directory:`,
+							placeholder: `my-preact-app`,
+							validate(value) {
+								if (value.length === 0) {
+									return `Directory name is required!`
+								}
+								if (existsSync(value)) {
+									return `Refusing to overwrite existing directory or file! Please provide a non-clashing name.`
+								}
+							},
+						}),
+		},
+		{
+			onCancel: () => {
+				prompts.cancel(pico.yellow(`Cancelled`))
+				process.exit(0)
+			},
+		},
+	)
+	const targetDir = resolve(process.cwd(), dir)
+	const opts: CreateAtomOptions = { packageManager }
+
+	await useSpinner(
+		`Setting up your project directory...`,
+		() => scaffold(targetDir, opts),
+		`Set up project directory`,
+	)
+
+	await useSpinner(
+		`Installing project dependencies...`,
+		() => installDeps(targetDir, opts),
+		`Installed project dependencies`,
+	)
+
+	if (skipHint === false) {
+		const gettingStarted = `
+			${pico.dim(`$`)} ${pico.blueBright(`cd ${dir}`)}
+			${pico.dim(`$`)} ${pico.blueBright(
+				`${
+					packageManager === `npm`
+						? `npm run`
+						: packageManager === `bun`
+							? `bun run`
+							: packageManager
+				} dev`,
+			)}
+		`
+		prompts.note(
+			gettingStarted.trim().replace(/^\t\t\t/gm, ``),
+			`Getting Started`,
+		)
+	}
+
+	prompts.outro(pico.green(`You're all set!`))
+}
+
+async function useSpinner(
+	startMessage: string,
+	fn: () => Promise<void>,
+	finishMessage: string,
+): Promise<void> {
+	s.start(startMessage)
+	await fn()
+	s.stop(pico.green(finishMessage))
+}
+
+async function scaffold(to: string, opts: CreateAtomOptions): Promise<void> {
+	await fs.mkdir(to, { recursive: true })
+
+	const __dirname = dirname(fileURLToPath(import.meta.url))
+	await templateDir(resolve(__dirname, `../templates`, `base`), to, opts)
+}
+
+/**
+ * Recursive fs copy, swiped from `create-wmr`:
+ * https://github.com/preactjs/wmr/blob/3c5672ecd2f958c8eaf372d33c084dc69228ae3f/packages/create-wmr/src/index.js#L108-L124
+ */
+async function templateDir(
+	from: string,
+	to: string,
+	opts: CreateAtomOptions,
+): Promise<void[]> {
+	const files = await fs.readdir(from)
+	const results = await Promise.all(
+		files.map(async (f) => {
+			if (f === `.` || f === `..`) return
+			const filename = resolve(from, f)
+			if ((await fs.stat(filename)).isDirectory()) {
+				await fs.mkdir(resolve(to, f), { recursive: true })
+				return templateDir(filename, resolve(to, f), opts)
+			}
+			if (opts.packageManager !== `npm` && f === `README.md`) {
+				await fs.writeFile(
+					resolve(to, f),
+					(await fs.readFile(filename, `utf-8`)).replace(
+						/npm run/g,
+						opts.packageManager === `bun` ? `bun run` : opts.packageManager,
+					),
+				)
+				return
+			}
+			// Publishing to npm renames the .gitignore to .npmignore
+			// https://github.com/npm/npm/issues/7252#issuecomment-253339460
+			if (f === `_gitignore`) f = `.gitignore`
+			await fs.copyFile(filename, resolve(to, f))
+		}),
+	)
+	return results.flat(99)
+}
+
+async function installDeps(to: string, opts: CreateAtomOptions) {
+	const dependencies: string[] = []
+	const devDependencies: string[] = []
+
+	const installOpts = {
+		packageManager: opts.packageManager,
+		to,
+	}
+
+	await installPackages(dependencies, { ...installOpts })
+	devDependencies.length &&
+		(await installPackages(devDependencies, { ...installOpts, dev: true }))
+}
+
+type InstallOptions = {
+	packageManager: `bun` | `npm` | `pnpm` | `yarn`
+	to: string
+	dev?: boolean
+}
+
+function installPackages(pkgs: string[], opts: InstallOptions) {
+	return x(
+		opts.packageManager,
+		[
+			// `yarn add` will fail if nothing is provided
+			opts.packageManager === `yarn` ? (pkgs.length ? `add` : ``) : `install`,
+			opts.dev ? `-D` : ``,
+			...pkgs,
+		].filter(Boolean),
+		{
+			nodeOptions: {
+				stdio: `ignore`,
+				cwd: opts.to,
+			},
+		},
+	)
+}
+
+function getPkgManager(): `bun` | `npm` | `pnpm` | `yarn` {
+	const userAgent = process.env[`npm_config_user_agent`] ?? ``
+	if (userAgent.startsWith(`yarn`)) return `yarn`
+	if (userAgent.startsWith(`pnpm`)) return `pnpm`
+	if (userAgent.startsWith(`bun`)) return `bun`
+	return `npm`
+}

package/src/create-atom.x.ts

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+
+import type { OptionsGroup } from "comline"
+import { cli, helpOption, optional, parseBooleanOption } from "comline"
+import { z } from "zod/v4"
+
+import type { CreateAtomOptionsPreloaded } from "./create-atom.ts"
+import { createAtom } from "./create-atom.ts"
+
+const helper = helpOption()
+
+const CREATE_ATOM_OPTS = {
+	description: `Check for breaking changes in a package.`,
+	optionsSchema: z.object({
+		packageManager: z
+			.union([
+				z.literal(`bun`),
+				z.literal(`npm`),
+				z.literal(`pnpm`),
+				z.literal(`yarn`),
+			])
+			.optional(),
+		skipHints: z.boolean().optional(),
+	}),
+	options: {
+		...helper.options,
+		packageManager: {
+			flag: `m`,
+			required: false,
+			description: `The package manager to use.`,
+			example: `--packageManager="npm"`,
+		},
+		skipHints: {
+			flag: `k`,
+			required: false,
+			description: `Silences the 'Getting Started' info, mainly for use in other initializers that may wrap this one but provide their own scripts/instructions.`,
+			example: `--skipHints`,
+			parse: parseBooleanOption,
+		},
+	},
+} satisfies OptionsGroup<CreateAtomOptionsPreloaded>
+
+const parse = cli(
+	{
+		cliName: `create-atom`,
+		routes: optional({ $projectName: null }),
+		routeOptions: {
+			"": CREATE_ATOM_OPTS,
+			$projectName: CREATE_ATOM_OPTS,
+		},
+	},
+	{
+		error: console.error.bind(console),
+		info: () => {},
+	},
+)
+const { inputs } = parse(process.argv)
+
+await createAtom(inputs.path[0], inputs.opts)

package/templates/base/_gitignore

@@ -0,0 +1,24 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?