@monimesl/dot-cli 0.1.0-alpha.2

package/README.md

@@ -0,0 +1,26 @@
+# @monimesl/dot-cli
+
+The `dotctl` command: build mini apps and run them in the simulator. Platform tasks such as
+packaging, signing and publishing mini apps will live here too.
+
+```sh
+dotctl create [dir]  # scaffold a dot (asks for its name), with a sample home page
+dotctl build [root]   # compile the dot into dist/ui and dist/logic, minified
+dotctl dev [root]     # build, open it in the browser simulator, rebuild and reload on change
+```
+
+| Option                | Applies to | What it does                                            |
+| --------------------- | ---------- | ------------------------------------------------------- |
+| `--out-dir <dir>`     | both       | Output directory (default: `<root>/dist`)               |
+| `--conditions <list>` | both       | Extra export conditions, such as `@monimesl/dot-source` |
+| `--port <port>`       | `dev`      | Simulator port (default: `3680`, or the next free one)  |
+
+## `dotctl create`
+
+Asks for the dot's name (`Dot` by default, or pass `--name`) and creates a self-contained project
+in `dir` (by default, the name in kebab case) with one page, `home`: a short welcome, localized for
+Sierra Leone, to a dot running inside Dash. The dot depends on `@monimesl/dot-runtime` and `@monimesl/dot-cli`; inside
+the Dot repository it uses the workspace packages instead. It then offers to install the
+dependencies and start the simulator inside the new dot, asking which of the installed package
+managers to use (npm, pnpm, yarn or bun; the one that launched `dotctl`, or npm, by default).
+`--pm <name>` answers that up front.

package/bin/dotctl.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.js';

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/cli.js

@@ -0,0 +1,424 @@
+import { createRequire } from "node:module";
+import { spawn, spawnSync } from "node:child_process";
+import { basename, dirname, join, relative, resolve, sep } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { parseArgs } from "node:util";
+import { CompileError, build, installedRuntime, loadProject } from "@monimesl/dot-compiler";
+import { DEFAULT_PORT, startSimulator } from "@monimesl/dot-simulator";
+import { existsSync, readFileSync, readdirSync, watch } from "node:fs";
+import { cp, mkdir, writeFile } from "node:fs/promises";
+import { DmlParseError } from "@monimesl/dot-dml-parser";
+import { ScriptParseError } from "@monimesl/dot-script-parser";
+//#region src/create/template.ts
+const TEMPLATE_FILES = [
+	"dot.ts",
+	"pages",
+	"statics",
+	".env"
+];
+const DOT_JSON_SCHEMA = "./node_modules/@monimesl/dot-runtime/dot.schema.json";
+const json = (value) => `${JSON.stringify(value, null, 2)}\n`;
+function projectFiles(options) {
+	return {
+		"package.json": packageJson(options),
+		"tsconfig.json": tsconfig(options),
+		".gitignore": "node_modules/\ndist/\n# Types generated by dotctl\n.dot/\n",
+		"dot.json": json({
+			$schema: DOT_JSON_SCHEMA,
+			id: `com.example.${idWord(options.packageName)}`,
+			name: options.name,
+			version: "0.1.0"
+		}),
+		"README.md": readme(options.name)
+	};
+}
+function packageJson({ packageName, dotVersion, workspace }) {
+	const conditions = workspace ? " --conditions @monimesl/dot-source" : "";
+	return json({
+		name: packageName,
+		private: true,
+		type: "module",
+		scripts: {
+			dev: `dotctl dev${conditions}`,
+			build: `dotctl build${conditions}`,
+			typecheck: "tsc --noEmit"
+		},
+		dependencies: { "@monimesl/dot-runtime": dotVersion },
+		devDependencies: {
+			"@monimesl/dot-cli": dotVersion,
+			typescript: "^5.9.3"
+		}
+	});
+}
+function tsconfig({ workspace }) {
+	const compilerOptions = {
+		target: "ES2022",
+		module: "ESNext",
+		moduleResolution: "bundler",
+		lib: ["ES2022"],
+		types: ["@monimesl/dot-runtime/globals"],
+		strict: true,
+		noEmit: true,
+		skipLibCheck: true,
+		verbatimModuleSyntax: true
+	};
+	if (workspace) compilerOptions.customConditions = ["@monimesl/dot-source"];
+	return json({
+		compilerOptions,
+		include: [
+			"dot.ts",
+			"pages",
+			".dot/pages.d.ts",
+			".dot/env.d.ts"
+		]
+	});
+}
+function readme(name) {
+	return `# ${name}
+
+A dot: a mini app that runs inside Dash.
+
+\`\`\`sh
+npm install
+npm run dev     # run it in the simulator; it reloads on every change
+npm run build   # build it for Dash
+\`\`\`
+
+Each page is a folder under \`pages/\` with three files: \`view.dml\` (what it shows),
+\`state.ts\` (what it starts with) and \`controller.ts\` (how it changes). List new pages in
+\`dot.ts\`; the first one is where the dot starts.
+
+\`dot.json\` describes the dot to Dash. Change its \`id\` from \`com.example.…\` to a reverse domain
+name you own before you publish: it can't change afterwards. Your editor completes the other fields
+from the schema it points to.
+
+\`.env\` holds public configuration: variables named \`DOT_PUBLIC_…\`, which the service reads as
+\`env.DOT_PUBLIC_…\`. They are built into the dot, so anyone who has it can read them: never put a
+secret there. \`.env.development\` and \`.env.production\` override it for \`dev\` and \`build\`.
+
+It starts as a counter with two pages. \`index\` counts taps with mutations. \`help/tips\` shows
+navigation: each page you open goes on top of the stack, Back returns to the one below, and the
+trail at the top shows where you are.
+`;
+}
+function idWord(packageName) {
+	return packageName.slice(0, 63).replace(/-+$/, "");
+}
+//#endregion
+//#region src/create/create.ts
+async function create({ name, dir }) {
+	const root = resolve(dir);
+	if (existsSync(root) && readdirSync(root).length > 0) throw new Error(`${dir} already exists and is not empty`);
+	const packageName = toPackageName(name);
+	if (!packageName) throw new Error(`"${name}" needs at least one letter or digit`);
+	const workspace = isInDotWorkspace(root);
+	const template = templateDir();
+	await mkdir(root, { recursive: true });
+	for (const path of TEMPLATE_FILES) await cp(join(template, path), join(root, path), { recursive: true });
+	const generated = projectFiles({
+		name,
+		packageName,
+		dotVersion: workspace ? "workspace:*" : `^${cliVersion()}`,
+		workspace
+	});
+	for (const [path, content] of Object.entries(generated)) await writeFile(join(root, path), content);
+	return {
+		root,
+		workspace
+	};
+}
+function toPackageName(name) {
+	return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function toDisplayName(dir) {
+	return basename(resolve(dir)).split(/[-_\s]+/).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+function isInDotWorkspace(dir) {
+	let current = dirname(dir);
+	while (true) {
+		if (existsSync(join(current, "pnpm-workspace.yaml"))) {
+			const runtimeManifest = join(current, "packages/runtime/package.json");
+			if (!existsSync(runtimeManifest)) return false;
+			return readPackageJson(runtimeManifest).name === "@monimesl/dot-runtime";
+		}
+		const parent = dirname(current);
+		if (parent === current) return false;
+		current = parent;
+	}
+}
+function templateDir() {
+	const example = join(cliRoot(), "../../examples/counter");
+	return existsSync(example) ? example : join(cliRoot(), "dist/template");
+}
+function cliVersion() {
+	return readPackageJson(join(cliRoot(), "package.json")).version;
+}
+function readPackageJson(path) {
+	return JSON.parse(readFileSync(path, "utf8"));
+}
+function cliRoot() {
+	return dirname(createRequire(import.meta.url).resolve("@monimesl/dot-cli/package.json"));
+}
+//#endregion
+//#region src/create/package-manager.ts
+const PACKAGE_MANAGERS = [
+	"npm",
+	"pnpm",
+	"yarn",
+	"bun"
+];
+function isPackageManager(name) {
+	return PACKAGE_MANAGERS.includes(name);
+}
+function launchedBy(userAgent = process.env.npm_config_user_agent ?? "") {
+	return PACKAGE_MANAGERS.find((name) => userAgent.startsWith(`${name}/`)) ?? "npm";
+}
+function installedManagers(isInstalled = onPath) {
+	return PACKAGE_MANAGERS.filter(isInstalled);
+}
+function onPath(name) {
+	return spawnSync(name, ["--version"], {
+		stdio: "ignore",
+		shell: process.platform === "win32"
+	}).status === 0;
+}
+//#endregion
+//#region src/report.ts
+function describeError(error) {
+	if (error instanceof CompileError || error instanceof DmlParseError || error instanceof ScriptParseError) return error.message;
+	if (error.code?.startsWith("ERR_PARSE_ARGS")) {
+		const [firstSentence] = error.message.split(". ");
+		return `${firstSentence}. See dotctl --help.`;
+	}
+	return error instanceof Error ? error.stack ?? error.message : String(error);
+}
+function printWarnings({ warnings }) {
+	for (const warning of warnings) console.warn(`warning: ${warning.message}`);
+}
+function printBuildTime(startedAt) {
+	console.log(`Built in ${Math.round(performance.now() - startedAt)}ms`);
+}
+//#endregion
+//#region src/dev.ts
+const CHANGE_DEBOUNCE_MS = 50;
+async function dev({ port, ...options }) {
+	const project = await loadProject(options.root);
+	const outDir = resolve(project.root, options.outDir ?? "dist");
+	const buildOptions = {
+		mode: "development",
+		...options,
+		outDir
+	};
+	const buildApp = async () => {
+		const started = performance.now();
+		try {
+			printWarnings(await build(buildOptions));
+			printBuildTime(started);
+			return null;
+		} catch (error) {
+			const message = describeError(error).replaceAll(project.root + sep, "");
+			console.error(`error: ${message}`);
+			return message;
+		}
+	};
+	const firstError = await buildApp();
+	const simulator = await startSimulator({
+		dotDir: outDir,
+		reactHostDir: installedRuntime(project.root).react.dir,
+		name: project.dotJson.name,
+		port
+	});
+	if (firstError) simulator.error(firstError);
+	console.log(`\n  Simulator running at: ${simulator.url}\n`);
+	const rebuilds = new RebuildQueue(async () => {
+		const error = await buildApp();
+		if (error) simulator.error(error);
+		else simulator.reload();
+	});
+	let debounceTimer;
+	const watcher = watch(project.root, { recursive: true }, (_event, file) => {
+		if (!file || isIgnored(file)) return;
+		const path = resolve(project.root, file);
+		if (path === outDir || path.startsWith(outDir + sep)) return;
+		clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(() => {
+			console.log(`Changed ${relative(project.root, path)}`);
+			rebuilds.request();
+		}, CHANGE_DEBOUNCE_MS);
+	});
+	return async () => {
+		clearTimeout(debounceTimer);
+		watcher.close();
+		await simulator.close();
+	};
+}
+var RebuildQueue = class {
+	#rebuild;
+	#building = false;
+	#changedWhileBuilding = false;
+	constructor(rebuild) {
+		this.#rebuild = rebuild;
+	}
+	request() {
+		if (this.#building) {
+			this.#changedWhileBuilding = true;
+			return;
+		}
+		this.#build();
+	}
+	async #build() {
+		this.#building = true;
+		this.#changedWhileBuilding = false;
+		try {
+			await this.#rebuild();
+		} finally {
+			this.#building = false;
+		}
+		if (this.#changedWhileBuilding) this.request();
+	}
+};
+function isIgnored(file) {
+	return file.split(/[\\/]/).some((segment) => {
+		if (segment === ".env" || segment.startsWith(".env.")) return false;
+		return segment === "node_modules" || segment.startsWith(".");
+	});
+}
+//#endregion
+//#region src/cli.ts
+const USAGE = `Usage:
+  dotctl create [dir] [--name <name>] [--pm <npm|pnpm|yarn|bun>]
+                                        Create a dot (asks for its name)
+  dotctl build [root] [options]         Build the minified bundles the host app runs
+  dotctl dev [root] [options]           Run in the browser simulator, rebuilding on change
+
+Options:
+  --out-dir <dir>       Output directory (default: <root>/dist)
+  --conditions <list>   Extra export conditions, comma separated
+  --port <port>         Simulator port for \`dev\`; the next free one is used if taken
+                        (default: ${DEFAULT_PORT})
+  -h, --help            Show this message`;
+async function main(argv) {
+	const { values, positionals } = parseArgs({
+		args: argv,
+		allowPositionals: true,
+		options: {
+			"out-dir": { type: "string" },
+			conditions: { type: "string" },
+			port: { type: "string" },
+			name: { type: "string" },
+			pm: { type: "string" },
+			help: {
+				type: "boolean",
+				short: "h"
+			}
+		}
+	});
+	const [command, target] = positionals;
+	if (command === "create" && !values.help) return createApp(target, values.name, values.pm);
+	if (values.help || command !== "build" && command !== "dev") {
+		console.log(USAGE);
+		return values.help ? 0 : 1;
+	}
+	const port = values.port === void 0 ? void 0 : Number(values.port);
+	if (port !== void 0 && !Number.isInteger(port)) {
+		console.error(`Invalid --port "${values.port}"`);
+		return 1;
+	}
+	const options = { root: target ?? "." };
+	if (values["out-dir"] !== void 0) options.outDir = values["out-dir"];
+	if (values.conditions !== void 0) options.conditions = values.conditions.split(",");
+	if (command === "dev") {
+		const stop = await dev({
+			...options,
+			port
+		});
+		await new Promise((resolve) => process.once("SIGINT", resolve));
+		await stop();
+		return 0;
+	}
+	const started = performance.now();
+	const result = await build(options);
+	for (const file of result.files.filter((file) => !file.endsWith(".map"))) console.log(`  ${relative(process.cwd(), file)}`);
+	printWarnings(result);
+	printBuildTime(started);
+	return 0;
+}
+async function createApp(dir, name, packageManagerFlag) {
+	if (packageManagerFlag !== void 0 && !isPackageManager(packageManagerFlag)) {
+		console.error(`--pm must be one of ${PACKAGE_MANAGERS.join(", ")}`);
+		return 1;
+	}
+	name ??= await ask("Dot name:", dir ? toDisplayName(dir) : "Dot");
+	if (!name) {
+		console.error("A dot needs a name: dotctl create [dir] --name \"My Dot\"");
+		return 1;
+	}
+	const { root, workspace } = await create({
+		name,
+		dir: dir ?? toPackageName(name)
+	});
+	const path = relative(process.cwd(), root) || ".";
+	console.log(`\nCreated ${name} in ${path}`);
+	if (workspace) console.log("It is inside the Dot repository, so it uses the workspace packages.");
+	let packageManager = workspace ? "pnpm" : packageManagerFlag ?? launchedBy();
+	if (await confirm("\nInstall and start it now?")) {
+		if (!workspace && !packageManagerFlag) packageManager = await choosePackageManager(packageManager);
+		if (await run(packageManager, ["install"], root) === 0) return run(packageManager, ["run", "dev"], root);
+		console.error(`\n${packageManager} install failed.`);
+	}
+	console.log(`\nNext:\n\n  cd ${path}\n  ${packageManager} install\n  ${packageManager} run dev\n`);
+	return 0;
+}
+function run(command, args, cwd) {
+	return new Promise((resolvePromise, reject) => {
+		const child = spawn(command, args, {
+			cwd,
+			stdio: "inherit",
+			shell: process.platform === "win32"
+		});
+		child.on("error", reject);
+		child.on("exit", (code) => resolvePromise(code ?? 1));
+	});
+}
+async function confirm(question) {
+	if (!process.stdin.isTTY) return false;
+	const answer = await readAnswer(`${question} (Y/n)`, "y");
+	return answer !== void 0 && answer.toLowerCase().startsWith("y");
+}
+async function ask(question, fallback) {
+	return readAnswer(`${question}${fallback ? ` (${fallback})` : ""}`, fallback);
+}
+async function readAnswer(prompt, fallback) {
+	if (!process.stdin.isTTY) return fallback;
+	const readline = createInterface({
+		input: process.stdin,
+		output: process.stdout
+	});
+	try {
+		return (await readline.question(`${prompt} `)).trim() || fallback;
+	} catch (error) {
+		if (error.name === "AbortError") return;
+		throw error;
+	} finally {
+		readline.close();
+	}
+}
+async function choosePackageManager(suggested) {
+	const installed = installedManagers();
+	if (installed.length < 2) return installed[0] ?? suggested;
+	const fallback = installed.includes(suggested) ? suggested : installed[0];
+	while (true) {
+		const answer = await ask(`Package manager? ${installed.join(" / ")}`, fallback);
+		if (answer === void 0) return fallback;
+		if (isPackageManager(answer) && installed.includes(answer)) return answer;
+		console.log(`Choose one of ${installed.join(", ")}.`);
+	}
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (error) => {
+	console.error(`error: ${describeError(error)}`);
+	process.exit(1);
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/create/template.ts","../src/create/create.ts","../src/create/package-manager.ts","../src/report.ts","../src/dev.ts","../src/cli.ts"],"sourcesContent":["export interface TemplateOptions {\n  name: string;\n  packageName: string;\n  dotVersion: string;\n  workspace: boolean;\n}\n\n// The dot itself is copied from the counter example; these are the files around it.\nexport const TEMPLATE_FILES = ['dot.ts', 'pages', 'statics', '.env'] as const;\n\n// Editors that follow `$schema` check dot.json and complete its fields.\nconst DOT_JSON_SCHEMA = './node_modules/@monimesl/dot-runtime/dot.schema.json';\n\nconst json = (value: unknown) => `${JSON.stringify(value, null, 2)}\\n`;\n\nexport function projectFiles(options: TemplateOptions): Record<string, string> {\n  return {\n    'package.json': packageJson(options),\n    'tsconfig.json': tsconfig(options),\n    '.gitignore': 'node_modules/\\ndist/\\n# Types generated by dotctl\\n.dot/\\n',\n    'dot.json': json({\n      $schema: DOT_JSON_SCHEMA,\n      id: `com.example.${idWord(options.packageName)}`,\n      name: options.name,\n      version: '0.1.0',\n    }),\n    'README.md': readme(options.name),\n  };\n}\n\nfunction packageJson({ packageName, dotVersion, workspace }: TemplateOptions): string {\n  const conditions = workspace ? ' --conditions @monimesl/dot-source' : '';\n  return json({\n    name: packageName,\n    private: true,\n    type: 'module',\n    scripts: {\n      dev: `dotctl dev${conditions}`,\n      build: `dotctl build${conditions}`,\n      typecheck: 'tsc --noEmit',\n    },\n    dependencies: { '@monimesl/dot-runtime': dotVersion },\n    devDependencies: { '@monimesl/dot-cli': dotVersion, typescript: '^5.9.3' },\n  });\n}\n\nfunction tsconfig({ workspace }: TemplateOptions): string {\n  const compilerOptions: Record<string, unknown> = {\n    target: 'ES2022',\n    module: 'ESNext',\n    moduleResolution: 'bundler',\n    lib: ['ES2022'],\n    types: ['@monimesl/dot-runtime/globals'],\n    strict: true,\n    noEmit: true,\n    skipLibCheck: true,\n    verbatimModuleSyntax: true,\n  };\n  if (workspace) {\n    compilerOptions.customConditions = ['@monimesl/dot-source'];\n  }\n  return json({\n    compilerOptions,\n    include: ['dot.ts', 'pages', '.dot/pages.d.ts', '.dot/env.d.ts'],\n  });\n}\n\nfunction readme(name: string): string {\n  return `# ${name}\n\nA dot: a mini app that runs inside Dash.\n\n\\`\\`\\`sh\nnpm install\nnpm run dev     # run it in the simulator; it reloads on every change\nnpm run build   # build it for Dash\n\\`\\`\\`\n\nEach page is a folder under \\`pages/\\` with three files: \\`view.dml\\` (what it shows),\n\\`state.ts\\` (what it starts with) and \\`controller.ts\\` (how it changes). List new pages in\n\\`dot.ts\\`; the first one is where the dot starts.\n\n\\`dot.json\\` describes the dot to Dash. Change its \\`id\\` from \\`com.example.…\\` to a reverse domain\nname you own before you publish: it can't change afterwards. Your editor completes the other fields\nfrom the schema it points to.\n\n\\`.env\\` holds public configuration: variables named \\`DOT_PUBLIC_…\\`, which the service reads as\n\\`env.DOT_PUBLIC_…\\`. They are built into the dot, so anyone who has it can read them: never put a\nsecret there. \\`.env.development\\` and \\`.env.production\\` override it for \\`dev\\` and \\`build\\`.\n\nIt starts as a counter with two pages. \\`index\\` counts taps with mutations. \\`help/tips\\` shows\nnavigation: each page you open goes on top of the stack, Back returns to the one below, and the\ntrail at the top shows where you are.\n`;\n}\n\n// A word of the dot's id: the package name, which is already lowercase letters, digits and inner\n// hyphens, cut to the 63 characters a host name allows.\nfunction idWord(packageName: string): string {\n  return packageName.slice(0, 63).replace(/-+$/, '');\n}\n","import { existsSync, readdirSync, readFileSync } from 'node:fs';\nimport { cp, mkdir, writeFile } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\nimport { basename, dirname, join, resolve } from 'node:path';\n\nimport { projectFiles, TEMPLATE_FILES } from './template';\n\nexport interface CreateOptions {\n  name: string;\n  dir: string;\n}\n\nexport interface CreateResult {\n  readonly root: string;\n  readonly workspace: boolean;\n}\n\ninterface PackageJson {\n  name: string;\n  version: string;\n}\n\nexport async function create({ name, dir }: CreateOptions): Promise<CreateResult> {\n  const root = resolve(dir);\n  if (existsSync(root) && readdirSync(root).length > 0) {\n    throw new Error(`${dir} already exists and is not empty`);\n  }\n  const packageName = toPackageName(name);\n  if (!packageName) {\n    throw new Error(`\"${name}\" needs at least one letter or digit`);\n  }\n\n  const workspace = isInDotWorkspace(root);\n  const template = templateDir();\n  await mkdir(root, { recursive: true });\n  for (const path of TEMPLATE_FILES) {\n    await cp(join(template, path), join(root, path), { recursive: true });\n  }\n  const generated = projectFiles({\n    name,\n    packageName,\n    dotVersion: workspace ? 'workspace:*' : `^${cliVersion()}`,\n    workspace,\n  });\n  for (const [path, content] of Object.entries(generated)) {\n    await writeFile(join(root, path), content);\n  }\n  return { root, workspace };\n}\n\nexport function toPackageName(name: string): string {\n  return name\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n\nexport function toDisplayName(dir: string): string {\n  return basename(resolve(dir))\n    .split(/[-_\\s]+/)\n    .filter(Boolean)\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(' ');\n}\n\n// True when the nearest pnpm workspace above `dir` is the Dot repository.\nexport function isInDotWorkspace(dir: string): boolean {\n  let current = dirname(dir);\n  while (true) {\n    if (existsSync(join(current, 'pnpm-workspace.yaml'))) {\n      const runtimeManifest = join(current, 'packages/runtime/package.json');\n      if (!existsSync(runtimeManifest)) {\n        return false;\n      }\n      return readPackageJson(runtimeManifest).name === '@monimesl/dot-runtime';\n    }\n    const parent = dirname(current);\n    if (parent === current) {\n      return false;\n    }\n    current = parent;\n  }\n}\n\n// The counter example: read from the repository, or from the copy the published CLI ships.\nfunction templateDir(): string {\n  const example = join(cliRoot(), '../../examples/counter');\n  return existsSync(example) ? example : join(cliRoot(), 'dist/template');\n}\n\nfunction cliVersion(): string {\n  return readPackageJson(join(cliRoot(), 'package.json')).version;\n}\n\nfunction readPackageJson(path: string): PackageJson {\n  return JSON.parse(readFileSync(path, 'utf8')) as PackageJson;\n}\n\nfunction cliRoot(): string {\n  return dirname(createRequire(import.meta.url).resolve('@monimesl/dot-cli/package.json'));\n}\n","import { spawnSync } from 'node:child_process';\n\nexport const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun'] as const;\nexport type PackageManager = (typeof PACKAGE_MANAGERS)[number];\n\nexport function isPackageManager(name: string): name is PackageManager {\n  return (PACKAGE_MANAGERS as readonly string[]).includes(name);\n}\n\nexport function launchedBy(userAgent = process.env.npm_config_user_agent ?? ''): PackageManager {\n  return PACKAGE_MANAGERS.find((name) => userAgent.startsWith(`${name}/`)) ?? 'npm';\n}\n\nexport function installedManagers(\n  isInstalled: (name: PackageManager) => boolean = onPath,\n): PackageManager[] {\n  return PACKAGE_MANAGERS.filter(isInstalled);\n}\n\nfunction onPath(name: PackageManager): boolean {\n  return (\n    spawnSync(name, ['--version'], { stdio: 'ignore', shell: process.platform === 'win32' })\n      .status === 0\n  );\n}\n","import { DmlParseError } from '@monimesl/dot-dml-parser';\nimport type { BuildResult } from '@monimesl/dot-compiler';\nimport { CompileError } from '@monimesl/dot-compiler';\nimport { ScriptParseError } from '@monimesl/dot-script-parser';\n\nexport function describeError(error: unknown): string {\n  const known =\n    error instanceof CompileError ||\n    error instanceof DmlParseError ||\n    error instanceof ScriptParseError;\n  if (known) {\n    return error.message;\n  }\n  if ((error as { code?: string }).code?.startsWith('ERR_PARSE_ARGS')) {\n    // Node's message goes on to explain `--` for positional arguments, which is noise here.\n    const [firstSentence] = (error as Error).message.split('. ');\n    return `${firstSentence}. See dotctl --help.`;\n  }\n  return error instanceof Error ? (error.stack ?? error.message) : String(error);\n}\n\nexport function printWarnings({ warnings }: BuildResult): void {\n  for (const warning of warnings) {\n    console.warn(`warning: ${warning.message}`);\n  }\n}\n\nexport function printBuildTime(startedAt: number): void {\n  console.log(`Built in ${Math.round(performance.now() - startedAt)}ms`);\n}\n","import { watch } from 'node:fs';\nimport { relative, resolve, sep } from 'node:path';\n\nimport type { BuildOptions } from '@monimesl/dot-compiler';\nimport { build, installedRuntime, loadProject } from '@monimesl/dot-compiler';\nimport { startSimulator } from '@monimesl/dot-simulator';\n\nimport { describeError, printBuildTime, printWarnings } from './report';\n\nexport interface DevOptions extends BuildOptions {\n  port?: number | undefined;\n}\n\n// Editors save a file in several writes; waiting this long turns them into one rebuild.\nconst CHANGE_DEBOUNCE_MS = 50;\n\nexport async function dev({ port, ...options }: DevOptions): Promise<() => Promise<void>> {\n  const project = await loadProject(options.root);\n  const outDir = resolve(project.root, options.outDir ?? 'dist');\n  const buildOptions: BuildOptions = { mode: 'development', ...options, outDir };\n\n  // Returns the error to show, with paths relative to the project.\n  const buildApp = async (): Promise<string | null> => {\n    const started = performance.now();\n    try {\n      printWarnings(await build(buildOptions));\n      printBuildTime(started);\n      return null;\n    } catch (error) {\n      const message = describeError(error).replaceAll(project.root + sep, '');\n      console.error(`error: ${message}`);\n      return message;\n    }\n  };\n\n  const firstError = await buildApp();\n  const simulator = await startSimulator({\n    dotDir: outDir,\n    reactHostDir: installedRuntime(project.root).react.dir,\n    name: project.dotJson.name,\n    port,\n  });\n  if (firstError) {\n    simulator.error(firstError);\n  }\n  console.log(`\\n  Simulator running at: ${simulator.url}\\n`);\n\n  const rebuilds = new RebuildQueue(async () => {\n    const error = await buildApp();\n    if (error) {\n      simulator.error(error);\n    } else {\n      simulator.reload();\n    }\n  });\n\n  let debounceTimer: NodeJS.Timeout | undefined;\n  const watcher = watch(project.root, { recursive: true }, (_event, file) => {\n    if (!file || isIgnored(file)) {\n      return;\n    }\n    const path = resolve(project.root, file);\n    if (path === outDir || path.startsWith(outDir + sep)) {\n      return;\n    }\n    clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(() => {\n      console.log(`Changed ${relative(project.root, path)}`);\n      rebuilds.request();\n    }, CHANGE_DEBOUNCE_MS);\n  });\n\n  return async () => {\n    clearTimeout(debounceTimer);\n    watcher.close();\n    await simulator.close();\n  };\n}\n\n// Runs one rebuild at a time; changes that arrive mid-build trigger exactly one more once it ends.\nclass RebuildQueue {\n  readonly #rebuild: () => Promise<void>;\n  #building = false;\n  #changedWhileBuilding = false;\n\n  constructor(rebuild: () => Promise<void>) {\n    this.#rebuild = rebuild;\n  }\n\n  request(): void {\n    if (this.#building) {\n      this.#changedWhileBuilding = true;\n      return;\n    }\n    void this.#build();\n  }\n\n  async #build(): Promise<void> {\n    this.#building = true;\n    this.#changedWhileBuilding = false;\n    try {\n      await this.#rebuild();\n    } finally {\n      this.#building = false;\n    }\n    if (this.#changedWhileBuilding) {\n      this.request();\n    }\n  }\n}\n\n// Dependencies and hidden folders such as .git or .dot, but not .env files, which the build reads.\nfunction isIgnored(file: string): boolean {\n  return file.split(/[\\\\/]/).some((segment) => {\n    if (segment === '.env' || segment.startsWith('.env.')) {\n      return false;\n    }\n    return segment === 'node_modules' || segment.startsWith('.');\n  });\n}\n","import { spawn } from 'node:child_process';\nimport { relative } from 'node:path';\nimport { createInterface } from 'node:readline/promises';\nimport { parseArgs } from 'node:util';\n\nimport type { BuildOptions } from '@monimesl/dot-compiler';\nimport { build } from '@monimesl/dot-compiler';\nimport { DEFAULT_PORT } from '@monimesl/dot-simulator';\n\nimport { create, toDisplayName, toPackageName } from './create/create';\nimport type { PackageManager } from './create/package-manager';\nimport {\n  installedManagers,\n  isPackageManager,\n  launchedBy,\n  PACKAGE_MANAGERS,\n} from './create/package-manager';\nimport { dev } from './dev';\nimport { describeError, printBuildTime, printWarnings } from './report';\n\nconst USAGE = `Usage:\n  dotctl create [dir] [--name <name>] [--pm <npm|pnpm|yarn|bun>]\n                                        Create a dot (asks for its name)\n  dotctl build [root] [options]         Build the minified bundles the host app runs\n  dotctl dev [root] [options]           Run in the browser simulator, rebuilding on change\n\nOptions:\n  --out-dir <dir>       Output directory (default: <root>/dist)\n  --conditions <list>   Extra export conditions, comma separated\n  --port <port>         Simulator port for \\`dev\\`; the next free one is used if taken\n                        (default: ${DEFAULT_PORT})\n  -h, --help            Show this message`;\n\nasync function main(argv: string[]): Promise<number> {\n  const { values, positionals } = parseArgs({\n    args: argv,\n    allowPositionals: true,\n    options: {\n      'out-dir': { type: 'string' },\n      conditions: { type: 'string' },\n      port: { type: 'string' },\n      name: { type: 'string' },\n      pm: { type: 'string' },\n      help: { type: 'boolean', short: 'h' },\n    },\n  });\n\n  const [command, target] = positionals;\n  if (command === 'create' && !values.help) {\n    return createApp(target, values.name, values.pm);\n  }\n  if (values.help || (command !== 'build' && command !== 'dev')) {\n    console.log(USAGE);\n    return values.help ? 0 : 1;\n  }\n  const port = values.port === undefined ? undefined : Number(values.port);\n  if (port !== undefined && !Number.isInteger(port)) {\n    console.error(`Invalid --port \"${values.port}\"`);\n    return 1;\n  }\n\n  const options: BuildOptions = { root: target ?? '.' };\n  if (values['out-dir'] !== undefined) {\n    options.outDir = values['out-dir'];\n  }\n  if (values.conditions !== undefined) {\n    options.conditions = values.conditions.split(',');\n  }\n\n  if (command === 'dev') {\n    const stop = await dev({ ...options, port });\n    await new Promise((resolve) => process.once('SIGINT', resolve));\n    await stop();\n    return 0;\n  }\n\n  const started = performance.now();\n  const result = await build(options);\n  for (const file of result.files.filter((file) => !file.endsWith('.map'))) {\n    console.log(`  ${relative(process.cwd(), file)}`);\n  }\n  printWarnings(result);\n  printBuildTime(started);\n  return 0;\n}\n\nasync function createApp(\n  dir: string | undefined,\n  name: string | undefined,\n  packageManagerFlag: string | undefined,\n): Promise<number> {\n  if (packageManagerFlag !== undefined && !isPackageManager(packageManagerFlag)) {\n    console.error(`--pm must be one of ${PACKAGE_MANAGERS.join(', ')}`);\n    return 1;\n  }\n  name ??= await ask('Dot name:', dir ? toDisplayName(dir) : 'Dot');\n  if (!name) {\n    console.error('A dot needs a name: dotctl create [dir] --name \"My Dot\"');\n    return 1;\n  }\n  const { root, workspace } = await create({ name, dir: dir ?? toPackageName(name) });\n  const path = relative(process.cwd(), root) || '.';\n  console.log(`\\nCreated ${name} in ${path}`);\n  if (workspace) {\n    console.log('It is inside the Dot repository, so it uses the workspace packages.');\n  }\n\n  // A command cannot change its shell's directory, so it offers to carry on inside the new dot instead.\n  let packageManager: PackageManager = workspace ? 'pnpm' : (packageManagerFlag ?? launchedBy());\n  if (await confirm('\\nInstall and start it now?')) {\n    if (!workspace && !packageManagerFlag) {\n      packageManager = await choosePackageManager(packageManager);\n    }\n    const installed = await run(packageManager, ['install'], root);\n    if (installed === 0) {\n      return run(packageManager, ['run', 'dev'], root);\n    }\n    console.error(`\\n${packageManager} install failed.`);\n  }\n  console.log(\n    `\\nNext:\\n\\n  cd ${path}\\n  ${packageManager} install\\n  ${packageManager} run dev\\n`,\n  );\n  return 0;\n}\n\nfunction run(command: string, args: string[], cwd: string): Promise<number> {\n  return new Promise((resolvePromise, reject) => {\n    const child = spawn(command, args, {\n      cwd,\n      stdio: 'inherit',\n      shell: process.platform === 'win32',\n    });\n    child.on('error', reject);\n    child.on('exit', (code) => resolvePromise(code ?? 1));\n  });\n}\n\nasync function confirm(question: string): Promise<boolean> {\n  if (!process.stdin.isTTY) {\n    return false;\n  }\n  const answer = await readAnswer(`${question} (Y/n)`, 'y');\n  return answer !== undefined && answer.toLowerCase().startsWith('y');\n}\n\n// Shows the fallback after the question, as the answer an empty reply gives.\nasync function ask(question: string, fallback?: string): Promise<string | undefined> {\n  const hint = fallback ? ` (${fallback})` : '';\n  return readAnswer(`${question}${hint}`, fallback);\n}\n\nasync function readAnswer(prompt: string, fallback?: string): Promise<string | undefined> {\n  if (!process.stdin.isTTY) {\n    return fallback;\n  }\n  const readline = createInterface({ input: process.stdin, output: process.stdout });\n  try {\n    const answer = await readline.question(`${prompt} `);\n    return answer.trim() || fallback;\n  } catch (error) {\n    // Ctrl+C or Ctrl+D\n    if ((error as Error).name === 'AbortError') {\n      return undefined;\n    }\n    throw error;\n  } finally {\n    readline.close();\n  }\n}\n\nasync function choosePackageManager(suggested: PackageManager): Promise<PackageManager> {\n  const installed = installedManagers();\n  if (installed.length < 2) {\n    return installed[0] ?? suggested;\n  }\n  const fallback = installed.includes(suggested) ? suggested : installed[0]!;\n  while (true) {\n    const answer = await ask(`Package manager? ${installed.join(' / ')}`, fallback);\n    if (answer === undefined) {\n      return fallback;\n    }\n    if (isPackageManager(answer) && installed.includes(answer)) {\n      return answer;\n    }\n    console.log(`Choose one of ${installed.join(', ')}.`);\n  }\n}\n\nmain(process.argv.slice(2)).then(\n  (code) => process.exit(code),\n  (error: unknown) => {\n    console.error(`error: ${describeError(error)}`);\n    process.exit(1);\n  },\n);\n"],"mappings":"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"}

package/dist/template/.env

@@ -0,0 +1,3 @@
+# Public configuration for the dot. Only DOT_PUBLIC_ variables reach it, and anyone with the dot
+# can read them: never put a secret here. Read them in the service as `env.DOT_PUBLIC_…`.
+DOT_PUBLIC_GREETING=Dash draws this alert, not the dot.

package/dist/template/dot.ts

@@ -0,0 +1,6 @@
+import { logger } from '@monimesl/dot-runtime';
+
+export default defineDot({
+  pages: ['index', 'help/tips'],
+  plugins: [logger()],
+});

package/dist/template/pages/help/tips/controller.ts

@@ -0,0 +1,30 @@
+import state from './state';
+
+export default definePage({
+  initialState: state,
+  hooks: {
+    // The page that opens this one passes its own trail and depth.
+    onLoad(options) {
+      this.setState({
+        count: Number(options.count ?? 0),
+        trail: `${options.trail ?? 'Home'} › Tips`,
+        depth: Number(options.depth ?? 1) + 1,
+      });
+    },
+  },
+  actions: {
+    back() {
+      this.navigation.back();
+    },
+    openAnother(state) {
+      this.navigation.push('help/tips', {
+        count: String(state.count),
+        trail: state.trail,
+        depth: String(state.depth),
+      });
+    },
+    startOver() {
+      this.navigation.reset('index');
+    },
+  },
+});

package/dist/template/pages/help/tips/state.ts

@@ -0,0 +1,11 @@
+export default {
+  count: 0,
+  trail: '',
+  depth: 0,
+  maxPages: 8,
+  tips: [
+    'Every tap is handled by controller.ts in a Worker',
+    'The view only renders the state it receives',
+    'Pages open on top of each other; Back returns to the one below',
+  ],
+};

package/dist/template/pages/help/tips/view.dml

@@ -0,0 +1,15 @@
+<Text variant="caption">{{ trail }}</Text>
+<Text variant="title">Tips</Text>
+<Text>Page {{ depth }} of {{ maxPages }}, opened at {{ count }} taps.</Text>
+
+<View variant="card" gap="small">
+  <For each="{{ tips }}" item="tip" key="*this">
+    <Text>{{ tip }}</Text>
+  </For>
+</View>
+
+<View direction="row">
+  <Button onClick="back">Back</Button>
+  <Button variant="secondary" onClick="openAnother" disabled="{{ depth >= maxPages }}">Open another</Button>
+  <Button variant="secondary" onClick="startOver">Start over</Button>
+</View>

package/dist/template/pages/index/controller.ts

@@ -0,0 +1,67 @@
+import state from './state';
+
+export default definePage({
+  initialState: state,
+  hooks: {
+    onShow() {
+      this.setState((current) => ({ visits: current.visits + 1 }));
+    },
+  },
+  mutations: {
+    increment: (state) => {
+      const count = state.count + 1;
+      return { count, taps: [{ id: count }, ...state.taps] };
+    },
+    reset: () => ({ count: 0, taps: [] }),
+    rename: (_state, event: DotEvent<{ value: string }>) => ({ title: event.detail.value }),
+    logoLoaded: (_state, event: DotEvent<{ width: number; height: number }>) => ({
+      logoStatus: 'loaded' as const,
+      logoSize: `${event.detail.width}x${event.detail.height}`,
+    }),
+    logoFailed: () => ({ logoStatus: 'failed' as const }),
+  },
+  actions: {
+    fillUp() {
+      while (this.state.count < this.state.limit) {
+        this.mutations.increment();
+      }
+    },
+    async sayHello(state) {
+      try {
+        const { action } = await dash.ui.alert(
+          {
+            title: `Hello from ${state.title}`,
+            message: env.DOT_PUBLIC_GREETING,
+            actions: [
+              { id: 'nice', label: 'Nice' },
+              { id: 'close', label: 'Close', role: 'cancel' },
+            ],
+          },
+          { timeout: 30_000 },
+        );
+        this.setState({ dashNote: `You chose "${action}"` });
+      } catch (error) {
+        this.setState({ dashNote: errorMessage(error) });
+      }
+    },
+    async vibrate() {
+      await dash.system.vibrate({ style: 'success' });
+    },
+    async toggleTorch(state) {
+      const next = state.torch === 'on' ? 'off' : 'on';
+      try {
+        await dash.system.torch(next);
+        this.setState({ torch: next, dashNote: `Torch ${next}` });
+      } catch (error) {
+        this.setState({ dashNote: errorMessage(error) });
+      }
+    },
+    openTips(state) {
+      this.navigation.push('help/tips', { count: String(state.count), trail: 'Home', depth: '1' });
+    },
+  },
+});
+
+function errorMessage(error: unknown): string {
+  return error instanceof Error ? error.message : String(error);
+}

package/dist/template/pages/index/state.ts

@@ -0,0 +1,17 @@
+export interface Tap {
+  id: number;
+}
+
+export type LogoStatus = 'loading' | 'loaded' | 'failed';
+
+export default {
+  title: 'Dot Counter',
+  logoStatus: 'loading' as LogoStatus,
+  logoSize: '',
+  count: 0,
+  limit: 5,
+  taps: [] as Tap[],
+  visits: 0,
+  torch: 'off' as 'on' | 'off',
+  dashNote: '',
+};

package/dist/template/pages/index/view.dml

@@ -0,0 +1,66 @@
+<Text variant="caption">Home</Text>
+
+<View direction="row" align="center" gap="large">
+  <Image src="statics/logo.png" alt="Dot logo" width="48" height="48" onLoad="logoLoaded" onError="logoFailed" />
+  <View gap="none">
+    <Text variant="title">{{ title }}</Text>
+    <If condition="{{ logoStatus === 'loaded' }}">
+      <Text variant="caption">Logo loaded at {{ logoSize }}</Text>
+    </If>
+    <ElseIf condition="{{ logoStatus === 'failed' }}">
+      <Text variant="caption">Logo failed to load</Text>
+    </ElseIf>
+    <Else>
+      <Text variant="caption">Loading logo…</Text>
+    </Else>
+  </View>
+</View>
+
+<View variant="card">
+  <Text variant="title">{{ count }} / {{ limit }}</Text>
+  <If condition="{{ count >= limit }}">
+    <Text>Limit reached</Text>
+  </If>
+  <ElseIf condition="{{ count > 0 }}">
+    <Text>Keep tapping</Text>
+  </ElseIf>
+  <Else>
+    <Text>Tap to start 🚀</Text>
+  </Else>
+  <View direction="row">
+    <Button onClick="increment" disabled="{{ count >= limit }}">Add one</Button>
+    <Button variant="secondary" onClick="reset" disabled="{{ count === 0 }}">Reset</Button>
+    <Button variant="secondary" onClick="fillUp" disabled="{{ count >= limit }}">Fill up</Button>
+  </View>
+</View>
+
+<View variant="card" gap="small">
+  <Text variant="caption">Name your counter</Text>
+  <Input label="Counter name" placeholder="Dot Counter" value="{{ title }}" maxLength="24" onChange="rename" />
+</View>
+
+<View variant="card" gap="small">
+  <Text variant="caption">Dash</Text>
+  <View direction="row">
+    <Button variant="secondary" onClick="sayHello">Say hello</Button>
+    <Button variant="secondary" onClick="vibrate">Vibrate</Button>
+    <Button variant="secondary" onClick="toggleTorch">{{ torch === 'on' ? 'Torch off' : 'Torch on' }}</Button>
+  </View>
+  <If condition="{{ dashNote }}">
+    <Text variant="caption">{{ dashNote }}</Text>
+  </If>
+</View>
+
+<View variant="card" onTap="openTips">
+  <Text>Tips -> </Text>
+  <Text variant="caption">Shown {{ visits }} {{ visits === 1 ? 'time' : 'times' }}</Text>
+</View>
+
+<If condition="{{ taps.length > 0 }}">
+  <View variant="card" gap="small">
+    <Text variant="caption">History</Text>
+    <For each="{{ taps }}" index="i" item="tap" key="id">
+      <Text>{{ i + 1 }}. Tap #{{ tap.id }}</Text>
+    </For>
+  </View>
+</If>

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@monimesl/dot-cli",
+  "version": "0.1.0-alpha.2",
+  "description": "The dotctl command: build mini apps and run them in the simulator",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/monime-lab/dot.git",
+    "directory": "packages/cli"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "bin": {
+    "dotctl": "./bin/dotctl.js"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@monimesl/dot-dml-parser": "0.1.0-alpha.2",
+    "@monimesl/dot-script-parser": "0.1.0-alpha.2",
+    "@monimesl/dot-compiler": "0.1.0-alpha.2",
+    "@monimesl/dot-simulator": "0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.4",
+    "publint": "^0.3.24",
+    "rimraf": "^6.1.3",
+    "tsdown": "^0.23.0",
+    "typescript": "^5.9.3",
+    "vitest": "^5.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "clean": "rimraf dist *.tsbuildinfo",
+    "test": "vitest run"
+  }
+}