acrylblends 0.0.0-stage → 0.2.0

package/bin/acrylblends.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from '../dist/index.js'
+
+process.exitCode = await runCli(process.argv.slice(2))

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+//#region src/io.d.ts
+/** Everything the CLI touches outside the filesystem. Tests pass their own. */
+interface Io {
+  stdout: {
+    write(text: string): unknown;
+  };
+  stderr: {
+    write(text: string): unknown;
+  };
+  cwd: string;
+  /** Ask one question; `undefined` when there is no terminal to ask on. */
+  ask: ((question: string) => Promise<string>) | undefined;
+  /** Install dependencies in a directory; resolves to the exit code. */
+  install(directory: string): Promise<number>;
+}
+//#endregion
+//#region src/add.d.ts
+interface AddOptions {
+  readonly names: readonly string[];
+  readonly directory: string | undefined;
+}
+/** Parse `add <plugin...> [--dir <app>]`. */
+export declare function parseAddOptions(argv: readonly string[]): AddOptions;
+/**
+ * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.
+ * Refuses a plugin the app already has. Returns the exit code.
+ */
+export declare function add(options: AddOptions, io: Io): Promise<number>;
+/** `acrylblends plugins`: the library, one line per plugin. */
+export declare function listPlugins(io: Io): number;
+//#endregion
+//#region src/cli.d.ts
+/** The version of this package. */
+export declare const VERSION: string;
+export declare const HELP: string;
+/**
+ * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.
+ */
+export declare function runCli(argv: readonly string[], io?: Io): Promise<number>;
+//#endregion
+//#region src/init.d.ts
+/** A command line mistake. The CLI prints it with the help text and exits 2. */
+export declare class UsageError extends Error {
+  name: string;
+}
+/** What `init` was asked for. Anything left undefined is asked for on a terminal, or defaulted. */
+interface InitOptions {
+  directory: string | undefined;
+  name: string | undefined;
+  agent: boolean | undefined;
+  install: boolean | undefined;
+  yes: boolean;
+}
+/** Parse `init [dir] [--agent|--no-agent] [--name n] [--install] [-y]`. */
+export declare function parseInitOptions(argv: readonly string[]): InitOptions;
+/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */
+export declare function init(options: InitOptions, io: Io): Promise<number>;
+//#endregion
+//#region src/library.d.ts
+/** One entry of the plugin library: `plugins/<name>/plugin.json` in this repository. */
+interface LibraryPlugin {
+  readonly name: string;
+  readonly description: string;
+  /** Library plugins this one imports; they are copied with it. */
+  readonly requires: readonly string[];
+  /** npm packages an app needs at run time for this plugin. */
+  readonly dependencies: Readonly<Record<string, string>>;
+  /** How to mount it, shown after `acrylblends add`. */
+  readonly mount?: string;
+}
+/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */
+export declare function libraryRoot(): string;
+/** Every plugin in the library, by name. */
+export declare function readLibrary(root?: string): Map<string, LibraryPlugin>;
+/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */
+export declare function closure(names: readonly string[], library: Map<string, LibraryPlugin>): LibraryPlugin[];
+/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */
+export declare function copyPlugin(plugin: LibraryPlugin, appDir: string, root?: string): string;
+//#endregion
+//#region src/project.d.ts
+/** Thrown when the target directory exists and is not empty. Nothing has been written. */
+export declare class TargetNotEmptyError extends Error {
+  readonly target: string;
+  constructor(target: string);
+}
+/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */
+export declare function isValidName(name: string): boolean;
+/** A valid default project name derived from a directory path. */
+export declare function nameFrom(directory: string): string;
+/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */
+export declare function assertTargetFree(target: string): void;
+/**
+ * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.
+ *
+ * @returns the copied files, relative to `target`
+ */
+export declare function copyTemplate(source: string, target: string, name: string): string[];
+export declare function readTemplatePlugins(templateDir: string): string[];
+/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */
+export declare function mergeDependencies(appDir: string, dependencies: Readonly<Record<string, string>>): string[];
+//#endregion
+//#region src/templates.d.ts
+/** The two templates: a Cordis app, and the same app with the offline agent. Both depend on `cordis` only. */
+export declare const TEMPLATES: readonly ["app", "agent"];
+type Template = (typeof TEMPLATES)[number];
+/** The template for an agent choice. */
+export declare function templateFor(agent: boolean): Template;
+/**
+ * The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build
+ * (`dist/`), so walk up until a `templates` folder holds the `app` template.
+ */
+export declare function templatesRoot(): string;
+/** Absolute path of a template folder. */
+export declare function templateDir(template: Template): string;
+//#endregion
+export type { AddOptions, InitOptions, Io, LibraryPlugin, Template };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,434 @@
+import { createRequire } from "node:module";
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { parseArgs } from "node:util";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+//#region src/library.ts
+/** Files of a library plugin that stay in the repository: its manifest and its tests. */
+const LIBRARY_ONLY = /* @__PURE__ */ new Set(["plugin.json", "test"]);
+var LibraryError = class extends Error {
+	name = "LibraryError";
+};
+/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */
+function libraryRoot() {
+	let dir = dirname(fileURLToPath(import.meta.url));
+	for (;;) {
+		const candidate = join(dir, "plugins");
+		if (existsSync(join(candidate, "http", "plugin.json"))) return candidate;
+		const parent = dirname(dir);
+		if (parent === dir) throw new LibraryError("acrylblends cannot find its plugin library (plugins/)");
+		dir = parent;
+	}
+}
+/** Every plugin in the library, by name. */
+function readLibrary(root = libraryRoot()) {
+	const plugins = /* @__PURE__ */ new Map();
+	for (const entry of readdirSync(root, { withFileTypes: true })) {
+		const manifest = join(root, entry.name, "plugin.json");
+		if (!entry.isDirectory() || !existsSync(manifest)) continue;
+		const plugin = JSON.parse(readFileSync(manifest, "utf8"));
+		if (plugin.name !== entry.name) throw new LibraryError(`plugins/${entry.name}/plugin.json names "${plugin.name}"`);
+		plugins.set(plugin.name, {
+			...plugin,
+			requires: plugin.requires ?? [],
+			dependencies: plugin.dependencies ?? {}
+		});
+	}
+	return plugins;
+}
+/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */
+function closure(names, library) {
+	const ordered = [];
+	const visiting = /* @__PURE__ */ new Set();
+	const visit = (name, trail) => {
+		if (ordered.some((plugin) => plugin.name === name)) return;
+		const plugin = library.get(name);
+		if (!plugin) throw new LibraryError(`no plugin "${name}" in the library${trail.length ? ` (required by ${trail.at(-1)})` : ""}`);
+		if (visiting.has(name)) throw new LibraryError(`plugins require each other in a cycle: ${[...trail, name].join(" -> ")}`);
+		visiting.add(name);
+		for (const required of plugin.requires) visit(required, [...trail, name]);
+		visiting.delete(name);
+		ordered.push(plugin);
+	};
+	for (const name of names) visit(name, []);
+	return ordered;
+}
+/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */
+function copyPlugin(plugin, appDir, root = libraryRoot()) {
+	const target = join(appDir, "src", "plugins", plugin.name);
+	if (existsSync(target)) throw new LibraryError(`src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`);
+	const source = join(root, plugin.name);
+	cpSync(source, target, {
+		recursive: true,
+		filter: (path) => !(dirname(path) === source && LIBRARY_ONLY.has(path.slice(source.length + 1)))
+	});
+	return target;
+}
+//#endregion
+//#region src/project.ts
+/** Thrown when the target directory exists and is not empty. Nothing has been written. */
+var TargetNotEmptyError = class extends Error {
+	target;
+	constructor(target) {
+		super(`refusing to write into "${target}": the directory is not empty. Choose an empty or new directory.`);
+		this.target = target;
+		this.name = "TargetNotEmptyError";
+	}
+};
+/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */
+function isValidName(name) {
+	return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 214;
+}
+/** A valid default project name derived from a directory path. */
+function nameFrom(directory) {
+	return (directory.split(/[\\/]/).filter(Boolean).pop() ?? "").toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^[^a-z]+/, "").replace(/-+$/, "") || "my-app";
+}
+/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */
+function assertTargetFree(target) {
+	if (!existsSync(target)) return;
+	if (!statSync(target).isDirectory() || readdirSync(target).length > 0) throw new TargetNotEmptyError(target);
+}
+/**
+* Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.
+*
+* @returns the copied files, relative to `target`
+*/
+function copyTemplate(source, target, name) {
+	assertTargetFree(target);
+	mkdirSync(target, { recursive: true });
+	const written = [];
+	const walk = (from, to, prefix) => {
+		for (const entry of readdirSync(from, { withFileTypes: true })) {
+			if (entry.name === "node_modules" || prefix === "" && entry.name === "template.json") continue;
+			const sourcePath = join(from, entry.name);
+			const targetName = prefix === "" && (entry.name === "gitignore" || entry.name === "dockerignore") ? `.${entry.name}` : entry.name;
+			const targetPath = join(to, targetName);
+			if (entry.isDirectory()) {
+				mkdirSync(targetPath, { recursive: true });
+				walk(sourcePath, targetPath, `${prefix}${entry.name}/`);
+				continue;
+			}
+			const text = readFileSync(sourcePath, "utf8");
+			if (text.includes("__APP_NAME__")) writeFileSync(targetPath, text.replaceAll("__APP_NAME__", name));
+			else cpSync(sourcePath, targetPath);
+			written.push(`${prefix}${targetName}`);
+		}
+	};
+	walk(source, target, "");
+	return written;
+}
+/** A template's own manifest, `template.json`: the library plugins it is built from. Never copied. */
+const TEMPLATE_MANIFEST = "template.json";
+function readTemplatePlugins(templateDir) {
+	const file = join(templateDir, TEMPLATE_MANIFEST);
+	if (!existsSync(file)) return [];
+	const { plugins } = JSON.parse(readFileSync(file, "utf8"));
+	return plugins ?? [];
+}
+/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */
+function mergeDependencies(appDir, dependencies) {
+	const file = join(appDir, "package.json");
+	const manifest = JSON.parse(readFileSync(file, "utf8"));
+	const current = manifest.dependencies ?? {};
+	const added = Object.keys(dependencies).filter((name) => !(name in current));
+	const merged = {
+		...dependencies,
+		...current
+	};
+	manifest.dependencies = Object.fromEntries(Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)));
+	writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\n`);
+	return added;
+}
+//#endregion
+//#region src/templates.ts
+/** The two templates: a Cordis app, and the same app with the offline agent. Both depend on `cordis` only. */
+const TEMPLATES = ["app", "agent"];
+/** The template for an agent choice. */
+function templateFor(agent) {
+	return agent ? "agent" : "app";
+}
+/**
+* The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build
+* (`dist/`), so walk up until a `templates` folder holds the `app` template.
+*/
+function templatesRoot() {
+	let dir = dirname(fileURLToPath(import.meta.url));
+	for (;;) {
+		const candidate = join(dir, "templates");
+		if (existsSync(join(candidate, "app"))) return candidate;
+		const parent = dirname(dir);
+		if (parent === dir) throw new Error("acrylblends cannot find its templates folder");
+		dir = parent;
+	}
+}
+/** Absolute path of a template folder. */
+function templateDir(template) {
+	return join(templatesRoot(), template);
+}
+//#endregion
+//#region src/init.ts
+/** A command line mistake. The CLI prints it with the help text and exits 2. */
+var UsageError = class extends Error {
+	name = "UsageError";
+};
+/** Parse `init [dir] [--agent|--no-agent] [--name n] [--install] [-y]`. */
+function parseInitOptions(argv) {
+	let parsed;
+	try {
+		parsed = parse$1(argv);
+	} catch (error) {
+		throw new UsageError(error.message);
+	}
+	const { values, positionals } = parsed;
+	if (positionals.length > 1) throw new UsageError("init takes at most one directory");
+	if (values.agent && values["no-agent"]) throw new UsageError("use --agent or --no-agent, not both");
+	return {
+		directory: positionals[0],
+		name: values.name,
+		agent: values.agent ? true : values["no-agent"] ? false : void 0,
+		install: values.install,
+		yes: values.yes === true
+	};
+}
+const parse$1 = (argv) => parseArgs({
+	args: [...argv],
+	allowPositionals: true,
+	strict: true,
+	options: {
+		name: { type: "string" },
+		agent: { type: "boolean" },
+		"no-agent": { type: "boolean" },
+		install: { type: "boolean" },
+		yes: {
+			type: "boolean",
+			short: "y"
+		}
+	}
+});
+const yes = (answer) => ["y", "yes"].includes(answer.trim().toLowerCase());
+/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */
+async function init(options, io) {
+	const relative = options.directory ?? ".";
+	const directory = resolve(io.cwd, relative);
+	const ask = options.yes ? void 0 : io.ask;
+	let name = options.name ?? nameFrom(directory);
+	if (options.name === void 0 && ask) name = (await ask(`Project name (${name}): `)).trim() || name;
+	if (!isValidName(name)) throw new UsageError(`"${name}" is not a valid project name (lower case letters, digits and dashes, starting with a letter)`);
+	const agent = options.agent ?? (ask ? yes(await ask("Include the offline agent? (y/N): ")) : false);
+	const install = options.install ?? (ask ? yes(await ask("Install dependencies with npm now? (y/N): ")) : false);
+	const template = templateFor(agent);
+	let files;
+	try {
+		files = copyTemplate(templateDir(template), directory, name);
+	} catch (error) {
+		if (!(error instanceof TargetNotEmptyError)) throw error;
+		io.stderr.write(`error: ${error.message}\n`);
+		return 1;
+	}
+	const plugins = closure(readTemplatePlugins(templateDir(template)), readLibrary());
+	for (const plugin of plugins) {
+		copyPlugin(plugin, directory);
+		mergeDependencies(directory, plugin.dependencies);
+	}
+	io.stdout.write(`created ${name} (${template}) in ${directory}: ${files.length} files, plugins ${plugins.map((plugin) => plugin.name).join(", ")}\n`);
+	if (install && await io.install(directory) !== 0) {
+		io.stderr.write("error: npm install failed; run it yourself in the new directory\n");
+		return 1;
+	}
+	const steps = [
+		relative === "." ? "" : `  cd ${relative}\n`,
+		install ? "" : "  npm install\n",
+		"  npm run dev\n  npm test\n"
+	];
+	io.stdout.write(`\nNext:\n${steps.join("")}`);
+	return 0;
+}
+//#endregion
+//#region src/add.ts
+/** Parse `add <plugin...> [--dir <app>]`. */
+function parseAddOptions(argv) {
+	let parsed;
+	try {
+		parsed = parse(argv);
+	} catch (error) {
+		throw new UsageError(error.message);
+	}
+	if (parsed.positionals.length === 0) throw new UsageError("add needs at least one plugin name (see \"acrylblends plugins\")");
+	return {
+		names: parsed.positionals,
+		directory: parsed.values.dir
+	};
+}
+const parse = (argv) => parseArgs({
+	args: [...argv],
+	allowPositionals: true,
+	strict: true,
+	options: { dir: { type: "string" } }
+});
+const present = (appDir, name) => existsSync(join(appDir, "src", "plugins", name));
+/**
+* Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.
+* Refuses a plugin the app already has. Returns the exit code.
+*/
+async function add(options, io) {
+	const appDir = resolve(io.cwd, options.directory ?? ".");
+	if (!existsSync(join(appDir, "package.json")) || !existsSync(join(appDir, "src"))) {
+		io.stderr.write(`error: ${appDir} is not an app (no package.json and src/); run "acrylblends init" first\n`);
+		return 1;
+	}
+	const external = options.names.filter((name) => /[\\/]/.test(name) || name.startsWith("."));
+	for (const folder of external) {
+		const code = addExternal(resolve(io.cwd, folder), appDir, io);
+		if (code !== 0) return code;
+	}
+	const names = options.names.filter((name) => !external.includes(name));
+	if (names.length === 0) return 0;
+	const already = names.filter((name) => present(appDir, name));
+	if (already.length > 0) {
+		io.stderr.write(`error: the app already has ${already.map((name) => `src/plugins/${name}`).join(", ")}\n`);
+		return 1;
+	}
+	const toCopy = closure(names, readLibrary()).filter((plugin) => !present(appDir, plugin.name));
+	const addedDependencies = [];
+	for (const plugin of toCopy) {
+		copyPlugin(plugin, appDir);
+		addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies));
+	}
+	io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(", ")} to ${appDir}\n`);
+	if (addedDependencies.length > 0) io.stdout.write(`new dependencies: ${addedDependencies.join(", ")} (run npm install)\n`);
+	for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) io.stdout.write(`\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\n`);
+	return 0;
+}
+const PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+/**
+* Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a
+* Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,
+* verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.
+*/
+function addExternal(folder, appDir, io) {
+	if (!existsSync(folder) || !statSync(folder).isDirectory()) {
+		io.stderr.write(`error: ${folder} is not a folder\n`);
+		return 1;
+	}
+	if (![
+		"index.ts",
+		"index.js",
+		"index.mjs"
+	].some((entry) => existsSync(join(folder, entry)))) {
+		io.stderr.write(`error: ${folder} has no index.ts that exports a Cordis plugin\n`);
+		return 1;
+	}
+	const manifestFile = join(folder, "package.json");
+	const manifest = existsSync(manifestFile) ? JSON.parse(readFileSync(manifestFile, "utf8")) : {};
+	const name = (manifest.name ?? basename(folder)).replace(/^@[^/]+\//, "");
+	if (!PLUGIN_NAME.test(name)) {
+		io.stderr.write(`error: "${name}" is not a plugin name (lowercase letters, digits and dashes)\n`);
+		return 1;
+	}
+	const target = join(appDir, "extensions", name);
+	if (existsSync(target)) {
+		io.stderr.write(`error: the app already has extensions/${name}\n`);
+		return 1;
+	}
+	cpSync(folder, target, {
+		recursive: true,
+		filter: (path) => !/[\\/](node_modules|\.git)([\\/]|$)/.test(path.slice(folder.length))
+	});
+	io.stdout.write(`added external plugin ${name} to ${join(appDir, "extensions")}; it installs at the next start\n`);
+	const dependencies = Object.keys(manifest.dependencies ?? {});
+	if (dependencies.length > 0) io.stdout.write(`it uses ${dependencies.join(", ")}: add them to the app with npm install first\n`);
+	return 0;
+}
+/** `acrylblends plugins`: the library, one line per plugin. */
+function listPlugins(io) {
+	for (const plugin of readLibrary().values()) {
+		const requires = plugin.requires.length > 0 ? ` (requires ${plugin.requires.join(", ")})` : "";
+		io.stdout.write(`${plugin.name.padEnd(12)} ${plugin.description}${requires}\n`);
+	}
+	return 0;
+}
+//#endregion
+//#region src/io.ts
+/** The real terminal and `npm install`. */
+function processIo() {
+	const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+	return {
+		stdout: process.stdout,
+		stderr: process.stderr,
+		cwd: process.cwd(),
+		ask: interactive ? async (question) => {
+			const rl = createInterface({
+				input: process.stdin,
+				output: process.stdout
+			});
+			try {
+				return await rl.question(question);
+			} finally {
+				rl.close();
+			}
+		} : void 0,
+		install: (directory) => new Promise((done) => {
+			const child = spawn("npm", ["install"], {
+				cwd: directory,
+				stdio: "inherit",
+				shell: process.platform === "win32"
+			});
+			child.on("error", () => done(1));
+			child.on("exit", (code) => done(code ?? 1));
+		})
+	};
+}
+//#endregion
+//#region src/cli.ts
+/** The version of this package. */
+const VERSION = createRequire(import.meta.url)("../package.json").version;
+const HELP = `acrylblends ${VERSION} - scaffold Cordis apps
+
+Usage:
+  acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory
+  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;
+                                      a folder path brings an external plugin into its extensions/
+  acrylblends plugins                    List the plugin library
+
+Options for init:
+  --agent / --no-agent   include the offline agent (asked when not given)
+  --name <name>          the project name (default: the directory name)
+  --install              run npm install after copying
+  -y, --yes              ask nothing; use defaults (no agent, no install)
+
+  -h, --help             show this help
+  -v, --version          show the version
+`;
+/**
+* Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.
+*/
+async function runCli(argv, io = processIo()) {
+	const [command, ...args] = argv;
+	try {
+		if (command === void 0 || command === "help" || command === "-h" || command === "--help") {
+			io.stdout.write(HELP);
+			return command === void 0 ? 2 : 0;
+		}
+		if (command === "version" || command === "-v" || command === "--version") {
+			io.stdout.write(`${VERSION}\n`);
+			return 0;
+		}
+		if (command === "init") return await init(parseInitOptions(args), io);
+		if (command === "add") return await add(parseAddOptions(args), io);
+		if (command === "plugins") return listPlugins(io);
+		throw new UsageError(`unknown command "${command}"`);
+	} catch (error) {
+		if (error instanceof UsageError) {
+			io.stderr.write(`error: ${error.message}\n\n${HELP}`);
+			return 2;
+		}
+		io.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\n`);
+		return 1;
+	}
+}
+//#endregion
+export { HELP, TEMPLATES, TargetNotEmptyError, UsageError, VERSION, add, assertTargetFree, closure, copyPlugin, copyTemplate, init, isValidName, libraryRoot, listPlugins, mergeDependencies, nameFrom, parseAddOptions, parseInitOptions, readLibrary, readTemplatePlugins, runCli, templateDir, templateFor, templatesRoot };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["parse"],"sources":["../src/library.ts","../src/project.ts","../src/templates.ts","../src/init.ts","../src/add.ts","../src/io.ts","../src/cli.ts"],"sourcesContent":["import { cpSync, existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** One entry of the plugin library: `plugins/<name>/plugin.json` in this repository. */\nexport interface LibraryPlugin {\n  readonly name: string\n  readonly description: string\n  /** Library plugins this one imports; they are copied with it. */\n  readonly requires: readonly string[]\n  /** npm packages an app needs at run time for this plugin. */\n  readonly dependencies: Readonly<Record<string, string>>\n  /** How to mount it, shown after `acrylblends add`. */\n  readonly mount?: string\n}\n\n/** Files of a library plugin that stay in the repository: its manifest and its tests. */\nconst LIBRARY_ONLY = new Set(['plugin.json', 'test'])\n\nexport class LibraryError extends Error {\n  override name = 'LibraryError'\n}\n\n/** The library folder (`plugins/` at the repository root): walk up from this module, in source or in the build. */\nexport function libraryRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'plugins')\n    if (existsSync(join(candidate, 'http', 'plugin.json'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir)\n      throw new LibraryError('acrylblends cannot find its plugin library (plugins/)')\n    dir = parent\n  }\n}\n\n/** Every plugin in the library, by name. */\nexport function readLibrary(root: string = libraryRoot()): Map<string, LibraryPlugin> {\n  const plugins = new Map<string, LibraryPlugin>()\n  for (const entry of readdirSync(root, { withFileTypes: true })) {\n    const manifest = join(root, entry.name, 'plugin.json')\n    if (!entry.isDirectory() || !existsSync(manifest)) continue\n    const plugin = JSON.parse(readFileSync(manifest, 'utf8')) as LibraryPlugin\n    if (plugin.name !== entry.name)\n      throw new LibraryError(`plugins/${entry.name}/plugin.json names \"${plugin.name}\"`)\n    plugins.set(plugin.name, {\n      ...plugin,\n      requires: plugin.requires ?? [],\n      dependencies: plugin.dependencies ?? {},\n    })\n  }\n  return plugins\n}\n\n/** The plugins to copy for `names`: each one after everything it requires, no duplicates. */\nexport function closure(\n  names: readonly string[],\n  library: Map<string, LibraryPlugin>,\n): LibraryPlugin[] {\n  const ordered: LibraryPlugin[] = []\n  const visiting = new Set<string>()\n  const visit = (name: string, trail: string[]) => {\n    if (ordered.some((plugin) => plugin.name === name)) return\n    const plugin = library.get(name)\n    if (!plugin)\n      throw new LibraryError(\n        `no plugin \"${name}\" in the library${trail.length ? ` (required by ${trail.at(-1)})` : ''}`,\n      )\n    if (visiting.has(name))\n      throw new LibraryError(\n        `plugins require each other in a cycle: ${[...trail, name].join(' -> ')}`,\n      )\n    visiting.add(name)\n    for (const required of plugin.requires) visit(required, [...trail, name])\n    visiting.delete(name)\n    ordered.push(plugin)\n  }\n  for (const name of names) visit(name, [])\n  return ordered\n}\n\n/** Copy one library plugin's source into `<app>/src/plugins/<name>/`. Throws when that folder already exists. */\nexport function copyPlugin(\n  plugin: LibraryPlugin,\n  appDir: string,\n  root: string = libraryRoot(),\n): string {\n  const target = join(appDir, 'src', 'plugins', plugin.name)\n  if (existsSync(target))\n    throw new LibraryError(\n      `src/plugins/${plugin.name} already exists; remove it first to copy a fresh one`,\n    )\n  const source = join(root, plugin.name)\n  cpSync(source, target, {\n    recursive: true,\n    filter: (path) =>\n      !(dirname(path) === source && LIBRARY_ONLY.has(path.slice(source.length + 1))),\n  })\n  return target\n}\n","import {\n  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  statSync,\n  writeFileSync,\n} from 'node:fs'\nimport { join } from 'node:path'\n\n/** Thrown when the target directory exists and is not empty. Nothing has been written. */\nexport class TargetNotEmptyError extends Error {\n  constructor(readonly target: string) {\n    super(\n      `refusing to write into \"${target}\": the directory is not empty. Choose an empty or new directory.`,\n    )\n    this.name = 'TargetNotEmptyError'\n  }\n}\n\n/** A project name npm accepts: lower case letters, digits and dashes, starting with a letter. */\nexport function isValidName(name: string): boolean {\n  return /^[a-z][a-z0-9-]*$/.test(name) && name.length <= 214\n}\n\n/** A valid default project name derived from a directory path. */\nexport function nameFrom(directory: string): string {\n  const base = directory.split(/[\\\\/]/).filter(Boolean).pop() ?? ''\n  const cleaned = base\n    .toLowerCase()\n    .replace(/[^a-z0-9-]+/g, '-')\n    .replace(/^[^a-z]+/, '')\n    .replace(/-+$/, '')\n  return cleaned || 'my-app'\n}\n\n/** Refuse a target that exists and is not an empty directory. A missing target is fine: it is created. */\nexport function assertTargetFree(target: string): void {\n  if (!existsSync(target)) return\n  if (!statSync(target).isDirectory() || readdirSync(target).length > 0)\n    throw new TargetNotEmptyError(target)\n}\n\n/**\n * Copy a template into `target`, replacing `__APP_NAME__` with `name`. Checks the target before writing anything.\n *\n * @returns the copied files, relative to `target`\n */\nexport function copyTemplate(source: string, target: string, name: string): string[] {\n  assertTargetFree(target)\n  mkdirSync(target, { recursive: true })\n  const written: string[] = []\n  const walk = (from: string, to: string, prefix: string) => {\n    for (const entry of readdirSync(from, { withFileTypes: true })) {\n      if (entry.name === 'node_modules' || (prefix === '' && entry.name === TEMPLATE_MANIFEST))\n        continue\n      const sourcePath = join(from, entry.name)\n      // npm and git treat a file named .gitignore specially, so templates keep it as `gitignore` (and `dockerignore`).\n      const targetName =\n        prefix === '' && (entry.name === 'gitignore' || entry.name === 'dockerignore')\n          ? `.${entry.name}`\n          : entry.name\n      const targetPath = join(to, targetName)\n      if (entry.isDirectory()) {\n        mkdirSync(targetPath, { recursive: true })\n        walk(sourcePath, targetPath, `${prefix}${entry.name}/`)\n        continue\n      }\n      const text = readFileSync(sourcePath, 'utf8')\n      if (text.includes('__APP_NAME__'))\n        writeFileSync(targetPath, text.replaceAll('__APP_NAME__', name))\n      else cpSync(sourcePath, targetPath)\n      written.push(`${prefix}${targetName}`)\n    }\n  }\n  walk(source, target, '')\n  return written\n}\n\n/** A template's own manifest, `template.json`: the library plugins it is built from. Never copied. */\nexport const TEMPLATE_MANIFEST = 'template.json'\n\nexport function readTemplatePlugins(templateDir: string): string[] {\n  const file = join(templateDir, TEMPLATE_MANIFEST)\n  if (!existsSync(file)) return []\n  const { plugins } = JSON.parse(readFileSync(file, 'utf8')) as { plugins?: string[] }\n  return plugins ?? []\n}\n\n/** Add run-time dependencies to an app's package.json, keeping what is there and sorting the keys. Returns the names added. */\nexport function mergeDependencies(\n  appDir: string,\n  dependencies: Readonly<Record<string, string>>,\n): string[] {\n  const file = join(appDir, 'package.json')\n  const manifest = JSON.parse(readFileSync(file, 'utf8')) as {\n    dependencies?: Record<string, string>\n  }\n  const current = manifest.dependencies ?? {}\n  const added = Object.keys(dependencies).filter((name) => !(name in current))\n  const merged = { ...dependencies, ...current }\n  manifest.dependencies = Object.fromEntries(\n    Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)),\n  )\n  writeFileSync(file, `${JSON.stringify(manifest, null, 2)}\\n`)\n  return added\n}\n","import { existsSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\n/** The two templates: a Cordis app, and the same app with the offline agent. Both depend on `cordis` only. */\nexport const TEMPLATES = ['app', 'agent'] as const\nexport type Template = (typeof TEMPLATES)[number]\n\n/** The template for an agent choice. */\nexport function templateFor(agent: boolean): Template {\n  return agent ? 'agent' : 'app'\n}\n\n/**\n * The `templates/` folder of this package. The module sits at different depths in source (`src/`) and in the build\n * (`dist/`), so walk up until a `templates` folder holds the `app` template.\n */\nexport function templatesRoot(): string {\n  let dir = dirname(fileURLToPath(import.meta.url))\n  for (;;) {\n    const candidate = join(dir, 'templates')\n    if (existsSync(join(candidate, 'app'))) return candidate\n    const parent = dirname(dir)\n    if (parent === dir) throw new Error('acrylblends cannot find its templates folder')\n    dir = parent\n  }\n}\n\n/** Absolute path of a template folder. */\nexport function templateDir(template: Template): string {\n  return join(templatesRoot(), template)\n}\n","import { resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport type { Io } from './io'\nimport { closure, copyPlugin, readLibrary } from './library'\nimport {\n  copyTemplate,\n  isValidName,\n  mergeDependencies,\n  nameFrom,\n  readTemplatePlugins,\n  TargetNotEmptyError,\n} from './project'\nimport { templateDir, templateFor } from './templates'\n\n/** A command line mistake. The CLI prints it with the help text and exits 2. */\nexport class UsageError extends Error {\n  override name = 'UsageError'\n}\n\n/** What `init` was asked for. Anything left undefined is asked for on a terminal, or defaulted. */\nexport interface InitOptions {\n  directory: string | undefined\n  name: string | undefined\n  agent: boolean | undefined\n  install: boolean | undefined\n  yes: boolean\n}\n\n/** Parse `init [dir] [--agent|--no-agent] [--name n] [--install] [-y]`. */\nexport function parseInitOptions(argv: readonly string[]): InitOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  const { values, positionals } = parsed\n  if (positionals.length > 1) throw new UsageError('init takes at most one directory')\n  if (values.agent && values['no-agent'])\n    throw new UsageError('use --agent or --no-agent, not both')\n  return {\n    directory: positionals[0],\n    name: values.name,\n    agent: values.agent ? true : values['no-agent'] ? false : undefined,\n    install: values.install,\n    yes: values.yes === true,\n  }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: {\n      name: { type: 'string' },\n      agent: { type: 'boolean' },\n      'no-agent': { type: 'boolean' },\n      install: { type: 'boolean' },\n      yes: { type: 'boolean', short: 'y' },\n    },\n  })\n\nconst yes = (answer: string) => ['y', 'yes'].includes(answer.trim().toLowerCase())\n\n/** Scaffold a Cordis app. Returns the exit code: 0 done, 1 refused or failed. Never overwrites anything. */\nexport async function init(options: InitOptions, io: Io): Promise<number> {\n  const relative = options.directory ?? '.'\n  const directory = resolve(io.cwd, relative)\n  const ask = options.yes ? undefined : io.ask\n\n  let name = options.name ?? nameFrom(directory)\n  if (options.name === undefined && ask)\n    name = (await ask(`Project name (${name}): `)).trim() || name\n  if (!isValidName(name)) {\n    throw new UsageError(\n      `\"${name}\" is not a valid project name (lower case letters, digits and dashes, starting with a letter)`,\n    )\n  }\n  const agent =\n    options.agent ?? (ask ? yes(await ask('Include the offline agent? (y/N): ')) : false)\n  const install =\n    options.install ?? (ask ? yes(await ask('Install dependencies with npm now? (y/N): ')) : false)\n\n  const template = templateFor(agent)\n  let files: string[]\n  try {\n    files = copyTemplate(templateDir(template), directory, name)\n  } catch (error) {\n    if (!(error instanceof TargetNotEmptyError)) throw error\n    io.stderr.write(`error: ${error.message}\\n`)\n    return 1\n  }\n  const plugins = closure(readTemplatePlugins(templateDir(template)), readLibrary())\n  for (const plugin of plugins) {\n    copyPlugin(plugin, directory)\n    mergeDependencies(directory, plugin.dependencies)\n  }\n  io.stdout.write(\n    `created ${name} (${template}) in ${directory}: ${files.length} files, plugins ${plugins.map((plugin) => plugin.name).join(', ')}\\n`,\n  )\n\n  if (install && (await io.install(directory)) !== 0) {\n    io.stderr.write('error: npm install failed; run it yourself in the new directory\\n')\n    return 1\n  }\n  const steps = [\n    relative === '.' ? '' : `  cd ${relative}\\n`,\n    install ? '' : '  npm install\\n',\n    '  npm run dev\\n  npm test\\n',\n  ]\n  io.stdout.write(`\\nNext:\\n${steps.join('')}`)\n  return 0\n}\n","import { cpSync, existsSync, readFileSync, statSync } from 'node:fs'\nimport { basename, join, resolve } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { UsageError } from './init'\nimport type { Io } from './io'\nimport { closure, copyPlugin, type LibraryPlugin, readLibrary } from './library'\nimport { mergeDependencies } from './project'\n\nexport interface AddOptions {\n  readonly names: readonly string[]\n  readonly directory: string | undefined\n}\n\n/** Parse `add <plugin...> [--dir <app>]`. */\nexport function parseAddOptions(argv: readonly string[]): AddOptions {\n  let parsed: ReturnType<typeof parse>\n  try {\n    parsed = parse(argv)\n  } catch (error) {\n    throw new UsageError((error as Error).message)\n  }\n  if (parsed.positionals.length === 0)\n    throw new UsageError('add needs at least one plugin name (see \"acrylblends plugins\")')\n  return { names: parsed.positionals, directory: parsed.values.dir }\n}\n\nconst parse = (argv: readonly string[]) =>\n  parseArgs({\n    args: [...argv],\n    allowPositionals: true,\n    strict: true,\n    options: { dir: { type: 'string' } },\n  })\n\nconst present = (appDir: string, name: string) => existsSync(join(appDir, 'src', 'plugins', name))\n\n/**\n * Copy library plugins into an existing app, with the plugins they require, and add their npm packages to its package.json.\n * Refuses a plugin the app already has. Returns the exit code.\n */\nexport async function add(options: AddOptions, io: Io): Promise<number> {\n  const appDir = resolve(io.cwd, options.directory ?? '.')\n  if (!existsSync(join(appDir, 'package.json')) || !existsSync(join(appDir, 'src'))) {\n    io.stderr.write(\n      `error: ${appDir} is not an app (no package.json and src/); run \"acrylblends init\" first\\n`,\n    )\n    return 1\n  }\n  // A path is an external plugin folder; anything else is a library plugin name.\n  const external = options.names.filter((name) => /[\\\\/]/.test(name) || name.startsWith('.'))\n  for (const folder of external) {\n    const code = addExternal(resolve(io.cwd, folder), appDir, io)\n    if (code !== 0) return code\n  }\n  const names = options.names.filter((name) => !external.includes(name))\n  if (names.length === 0) return 0\n  const already = names.filter((name) => present(appDir, name))\n  if (already.length > 0) {\n    io.stderr.write(\n      `error: the app already has ${already.map((name) => `src/plugins/${name}`).join(', ')}\\n`,\n    )\n    return 1\n  }\n  const toCopy: LibraryPlugin[] = closure(names, readLibrary()).filter(\n    (plugin) => !present(appDir, plugin.name),\n  )\n  const addedDependencies: string[] = []\n  for (const plugin of toCopy) {\n    copyPlugin(plugin, appDir)\n    addedDependencies.push(...mergeDependencies(appDir, plugin.dependencies))\n  }\n  io.stdout.write(`added ${toCopy.map((plugin) => plugin.name).join(', ')} to ${appDir}\\n`)\n  if (addedDependencies.length > 0)\n    io.stdout.write(`new dependencies: ${addedDependencies.join(', ')} (run npm install)\\n`)\n  for (const plugin of toCopy.filter((plugin) => names.includes(plugin.name))) {\n    io.stdout.write(\n      `\\n${plugin.name}: ${plugin.mount ?? `import it from './plugins/${plugin.name}/index.ts' and mount it in src/app.ts`}\\n`,\n    )\n  }\n  return 0\n}\n\nconst PLUGIN_NAME = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/\n\n/**\n * Bring an external plugin folder (a package made with the builder's package_plugin, or any folder with an index.ts that exports a\n * Cordis plugin) into the app's `extensions/`, where the extensions plugin installs it like any other: checked, staged, started,\n * verified. Its runtime dependencies are not installed here; they are reported so the user adds them deliberately.\n */\nfunction addExternal(folder: string, appDir: string, io: Io): number {\n  if (!existsSync(folder) || !statSync(folder).isDirectory()) {\n    io.stderr.write(`error: ${folder} is not a folder\\n`)\n    return 1\n  }\n  if (!['index.ts', 'index.js', 'index.mjs'].some((entry) => existsSync(join(folder, entry)))) {\n    io.stderr.write(`error: ${folder} has no index.ts that exports a Cordis plugin\\n`)\n    return 1\n  }\n  const manifestFile = join(folder, 'package.json')\n  const manifest = existsSync(manifestFile)\n    ? (JSON.parse(readFileSync(manifestFile, 'utf8')) as {\n        name?: string\n        dependencies?: Record<string, string>\n      })\n    : {}\n  const name = (manifest.name ?? basename(folder)).replace(/^@[^/]+\\//, '')\n  if (!PLUGIN_NAME.test(name)) {\n    io.stderr.write(\n      `error: \"${name}\" is not a plugin name (lowercase letters, digits and dashes)\\n`,\n    )\n    return 1\n  }\n  const target = join(appDir, 'extensions', name)\n  if (existsSync(target)) {\n    io.stderr.write(`error: the app already has extensions/${name}\\n`)\n    return 1\n  }\n  cpSync(folder, target, {\n    recursive: true,\n    filter: (path) => !/[\\\\/](node_modules|\\.git)([\\\\/]|$)/.test(path.slice(folder.length)),\n  })\n  io.stdout.write(\n    `added external plugin ${name} to ${join(appDir, 'extensions')}; it installs at the next start\\n`,\n  )\n  const dependencies = Object.keys(manifest.dependencies ?? {})\n  if (dependencies.length > 0)\n    io.stdout.write(\n      `it uses ${dependencies.join(', ')}: add them to the app with npm install first\\n`,\n    )\n  return 0\n}\n\n/** `acrylblends plugins`: the library, one line per plugin. */\nexport function listPlugins(io: Io): number {\n  for (const plugin of readLibrary().values()) {\n    const requires = plugin.requires.length > 0 ? ` (requires ${plugin.requires.join(', ')})` : ''\n    io.stdout.write(`${plugin.name.padEnd(12)} ${plugin.description}${requires}\\n`)\n  }\n  return 0\n}\n","import { spawn } from 'node:child_process'\nimport { createInterface } from 'node:readline/promises'\n\n/** Everything the CLI touches outside the filesystem. Tests pass their own. */\nexport interface Io {\n  stdout: { write(text: string): unknown }\n  stderr: { write(text: string): unknown }\n  cwd: string\n  /** Ask one question; `undefined` when there is no terminal to ask on. */\n  ask: ((question: string) => Promise<string>) | undefined\n  /** Install dependencies in a directory; resolves to the exit code. */\n  install(directory: string): Promise<number>\n}\n\n/** The real terminal and `npm install`. */\nexport function processIo(): Io {\n  const interactive = Boolean(process.stdin.isTTY && process.stdout.isTTY)\n  return {\n    stdout: process.stdout,\n    stderr: process.stderr,\n    cwd: process.cwd(),\n    ask: interactive\n      ? async (question) => {\n          const rl = createInterface({ input: process.stdin, output: process.stdout })\n          try {\n            return await rl.question(question)\n          } finally {\n            rl.close()\n          }\n        }\n      : undefined,\n    install: (directory) =>\n      new Promise((done) => {\n        const child = spawn('npm', ['install'], {\n          cwd: directory,\n          stdio: 'inherit',\n          shell: process.platform === 'win32',\n        })\n        child.on('error', () => done(1))\n        child.on('exit', (code) => done(code ?? 1))\n      }),\n  }\n}\n","import { createRequire } from 'node:module'\nimport { add, listPlugins, parseAddOptions } from './add'\nimport { init, parseInitOptions, UsageError } from './init'\nimport { type Io, processIo } from './io'\n\n/** The version of this package. */\nexport const VERSION: string = (\n  createRequire(import.meta.url)('../package.json') as { version: string }\n).version\n\nexport const HELP = `acrylblends ${VERSION} - scaffold Cordis apps\n\nUsage:\n  acrylblends init [dir] [options]       Create a Cordis app in an empty or new directory\n  acrylblends add <plugin...> [--dir d]  Copy library plugins (and what they require) into an app;\n                                      a folder path brings an external plugin into its extensions/\n  acrylblends plugins                    List the plugin library\n\nOptions for init:\n  --agent / --no-agent   include the offline agent (asked when not given)\n  --name <name>          the project name (default: the directory name)\n  --install              run npm install after copying\n  -y, --yes              ask nothing; use defaults (no agent, no install)\n\n  -h, --help             show this help\n  -v, --version          show the version\n`\n\n/**\n * Run the CLI and return the exit code: 0 done, 1 failed or refused, 2 a usage error. Never calls `process.exit`.\n */\nexport async function runCli(argv: readonly string[], io: Io = processIo()): Promise<number> {\n  const [command, ...args] = argv\n  try {\n    if (command === undefined || command === 'help' || command === '-h' || command === '--help') {\n      io.stdout.write(HELP)\n      return command === undefined ? 2 : 0\n    }\n    if (command === 'version' || command === '-v' || command === '--version') {\n      io.stdout.write(`${VERSION}\\n`)\n      return 0\n    }\n    if (command === 'init') return await init(parseInitOptions(args), io)\n    if (command === 'add') return await add(parseAddOptions(args), io)\n    if (command === 'plugins') return listPlugins(io)\n    throw new UsageError(`unknown command \"${command}\"`)\n  } catch (error) {\n    if (error instanceof UsageError) {\n      io.stderr.write(`error: ${error.message}\\n\\n${HELP}`)\n      return 2\n    }\n    io.stderr.write(`error: ${error instanceof Error ? error.message : String(error)}\\n`)\n    return 1\n  }\n}\n"],"mappings":"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"}