@moku-labs/web 0.1.0-alpha.4 → 0.3.0

package/dist/bin/moku.cjs

@@ -1,1383 +0,0 @@
-#!/usr/bin/env bun
-const require_project = require('../project-B8z4jeMC.cjs');
-const require_wrangler = require('../wrangler-Bomk9mU-.cjs');
-let node_fs = require("node:fs");
-let node_fs_promises = require("node:fs/promises");
-let node_path = require("node:path");
-let node_util = require("node:util");
-
-//#region src/bin/help.ts
-/** @file Help text and banner formatters for the moku CLI. */
-/**
-* Format the banner line shown before any output.
-*
-* @param version - The package version.
-* @returns The banner string.
-*/
-const formatBanner = (version) => `moku v${version}`;
-/**
-* Format the top-level help text listing all commands and global flags.
-*
-* @returns The help text.
-*/
-const formatHelp = () => `
-Usage: moku <command> [options]
-
-Commands:
-  build [folder]    Build static site (default folder: src/)
-  dev [folder]      Start dev server with watch + rebuild
-  preview [folder]  Build and serve site for local preview
-  deploy [folder]   Deploy dist/ to Cloudflare Pages (run \`deploy init\` once first)
-
-Options:
-  --version         Show version number
-  --help, -h        Show help
-
-Run moku <command> --help for command-specific options.`.trim();
-/**
-* Format the help text for `moku build`.
-*
-* @returns The help text.
-*/
-const formatBuildHelp = () => `
-Usage: moku build [folder] [options]
-
-Arguments:
-  folder            Source folder containing main.ts (default: src/)
-
-Options:
-  --verbose, -v     Show detailed build output
-  --mode <mode>     Build mode: ssg, spa, hybrid
-  --help, -h        Show help`.trim();
-/**
-* Format the help text for `moku dev`.
-*
-* @returns The help text.
-*/
-const formatDevHelp = () => `
-Usage: moku dev [folder] [options]
-
-Arguments:
-  folder            Source folder containing main.ts (default: src/)
-
-Options:
-  --verbose, -v     Show detailed build output
-  --port, -p <n>    Server port (default: 4173)
-  --help, -h        Show help`.trim();
-/**
-* Format the help text for `moku deploy`.
-*
-* @returns The help text.
-*/
-const formatDeployHelp = () => `
-Usage: moku deploy [folder] [options]
-       moku deploy init [folder] [options]
-
-Arguments:
-  folder            Source folder containing main.ts (default: src/)
-
-Deploy options:
-  --build           Run \`moku build\` before deploying
-  --branch <name>   Branch to deploy to (default: from wrangler.jsonc workflow)
-  --help, -h        Show help
-
-Init options:
-  --ci              Also generate .github/workflows/deploy.yml
-  --force           Overwrite existing files (warns on slug change)
-  --create-project  Transactionally create the Cloudflare project before writing wrangler.jsonc
-  --check           Diff only, no writes; exits non-zero on drift
-  --branch <name>   Override the auto-detected default branch
-  --help, -h        Show help`.trim();
-/**
-* Format the help text for `moku preview`.
-*
-* @returns The help text.
-*/
-const formatPreviewHelp = () => `
-Usage: moku preview [folder] [options]
-
-Arguments:
-  folder            Source folder containing main.ts (default: src/)
-
-Options:
-  --port, -p <n>    Server port (default: 3000)
-  --help, -h        Show help`.trim();
-
-//#endregion
-//#region src/bin/parse.ts
-/** @file Argument parsers for the moku CLI built on node:util parseArgs. */
-const VALID_MODES = new Set([
-	"ssg",
-	"spa",
-	"hybrid"
-]);
-const MIN_PORT = 1;
-const MAX_PORT = 65535;
-const DEFAULT_DEV_PORT = 4173;
-const DEFAULT_PREVIEW_PORT = 3e3;
-/**
-* Classify the top-level invocation into version / help / unknown-flag / command.
-*
-* @param argv - The argv slice (already stripped of `process.argv[0..1]`).
-* @returns A {@link TopLevel} discriminant.
-*/
-const parseTopLevel = (argv) => {
-	if (argv.length === 0) return { kind: "help" };
-	const [first, ...rest] = argv;
-	if (first === void 0) return { kind: "help" };
-	if (first === "--version") return { kind: "version" };
-	if (first === "--help" || first === "-h") return { kind: "help" };
-	if (first.startsWith("-")) return {
-		kind: "unknown-flag",
-		flag: first
-	};
-	return {
-		kind: "command",
-		command: first,
-		rest
-	};
-};
-const parsePort = (value, fallback) => {
-	if (value === void 0) return {
-		ok: true,
-		value: fallback
-	};
-	const port = Number.parseInt(value, 10);
-	if (!Number.isFinite(port) || `${port}` !== value) return {
-		ok: false,
-		message: `Invalid port: ${value}. Must be a number.`
-	};
-	if (port < MIN_PORT || port > MAX_PORT) return {
-		ok: false,
-		message: `Invalid port: ${port}. Must be ${MIN_PORT}-${MAX_PORT}.`
-	};
-	return {
-		ok: true,
-		value: port
-	};
-};
-/**
-* Parse `moku build` arguments.
-*
-* @param argv - Argv after the `build` keyword.
-* @returns A {@link ParseResult} carrying a {@link BuildArgs} or an error message.
-*/
-const parseBuild = (argv) => {
-	try {
-		const { values, positionals } = (0, node_util.parseArgs)({
-			args: argv,
-			options: {
-				verbose: {
-					type: "boolean",
-					short: "v",
-					default: false
-				},
-				mode: { type: "string" },
-				help: {
-					type: "boolean",
-					short: "h",
-					default: false
-				}
-			},
-			allowPositionals: true,
-			strict: true
-		});
-		if (values.mode !== void 0 && !VALID_MODES.has(values.mode)) return {
-			ok: false,
-			message: `Invalid mode: ${values.mode}. Must be one of: ssg, spa, hybrid.`
-		};
-		const mode = values.mode;
-		return {
-			ok: true,
-			value: {
-				folder: positionals[0] ?? "src",
-				verbose: values.verbose,
-				help: values.help,
-				...mode === void 0 ? {} : { mode }
-			}
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			message: error.message
-		};
-	}
-};
-/**
-* Parse `moku dev` arguments.
-*
-* @param argv - Argv after the `dev` keyword.
-* @returns A {@link ParseResult} carrying a {@link DevArgs} or an error message.
-*/
-const parseDev = (argv) => {
-	try {
-		const { values, positionals } = (0, node_util.parseArgs)({
-			args: argv,
-			options: {
-				verbose: {
-					type: "boolean",
-					short: "v",
-					default: false
-				},
-				port: {
-					type: "string",
-					short: "p"
-				},
-				help: {
-					type: "boolean",
-					short: "h",
-					default: false
-				}
-			},
-			allowPositionals: true,
-			strict: true
-		});
-		const port = parsePort(values.port, DEFAULT_DEV_PORT);
-		if (!port.ok) return port;
-		return {
-			ok: true,
-			value: {
-				folder: positionals[0] ?? "src",
-				verbose: values.verbose,
-				help: values.help,
-				port: port.value
-			}
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			message: error.message
-		};
-	}
-};
-/**
-* Parse `moku deploy` arguments.
-*
-* @param argv - Argv after the `deploy` keyword (NOT including `init`).
-* @returns A {@link ParseResult} carrying a {@link DeployArgs} or an error message.
-*/
-const parseDeploy = (argv) => {
-	try {
-		const { values, positionals } = (0, node_util.parseArgs)({
-			args: argv,
-			options: {
-				build: {
-					type: "boolean",
-					default: false
-				},
-				branch: { type: "string" },
-				help: {
-					type: "boolean",
-					short: "h",
-					default: false
-				}
-			},
-			allowPositionals: true,
-			strict: true
-		});
-		return {
-			ok: true,
-			value: {
-				folder: positionals[0] ?? "src",
-				help: values.help,
-				build: values.build,
-				...values.branch === void 0 ? {} : { branch: values.branch }
-			}
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			message: error.message
-		};
-	}
-};
-/**
-* Parse `moku deploy init` arguments.
-*
-* @param argv - Argv after the `deploy init` keywords.
-* @returns A {@link ParseResult} carrying a {@link DeployInitArgs} or an error message.
-*/
-const parseDeployInit = (argv) => {
-	try {
-		const { values, positionals } = (0, node_util.parseArgs)({
-			args: argv,
-			options: {
-				ci: {
-					type: "boolean",
-					default: false
-				},
-				force: {
-					type: "boolean",
-					default: false
-				},
-				"create-project": {
-					type: "boolean",
-					default: false
-				},
-				check: {
-					type: "boolean",
-					default: false
-				},
-				branch: { type: "string" },
-				help: {
-					type: "boolean",
-					short: "h",
-					default: false
-				}
-			},
-			allowPositionals: true,
-			strict: true
-		});
-		return {
-			ok: true,
-			value: {
-				folder: positionals[0] ?? "src",
-				help: values.help,
-				ci: values.ci,
-				force: values.force,
-				createProject: values["create-project"],
-				check: values.check,
-				...values.branch === void 0 ? {} : { branch: values.branch }
-			}
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			message: error.message
-		};
-	}
-};
-/**
-* Parse `moku preview` arguments.
-*
-* @param argv - Argv after the `preview` keyword.
-* @returns A {@link ParseResult} carrying a {@link PreviewArgs} or an error message.
-*/
-const parsePreview = (argv) => {
-	try {
-		const { values, positionals } = (0, node_util.parseArgs)({
-			args: argv,
-			options: {
-				port: {
-					type: "string",
-					short: "p"
-				},
-				help: {
-					type: "boolean",
-					short: "h",
-					default: false
-				}
-			},
-			allowPositionals: true,
-			strict: true
-		});
-		const port = parsePort(values.port, DEFAULT_PREVIEW_PORT);
-		if (!port.ok) return port;
-		return {
-			ok: true,
-			value: {
-				folder: positionals[0] ?? "src",
-				help: values.help,
-				port: port.value
-			}
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			message: error.message
-		};
-	}
-};
-
-//#endregion
-//#region src/bin/version.ts
-const parseSemver = (raw) => {
-	const stripped = raw.split(/[+-]/, 1)[0] ?? raw;
-	const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(stripped);
-	if (match === null) return null;
-	return {
-		major: Number(match[1]),
-		minor: Number(match[2]),
-		patch: Number(match[3])
-	};
-};
-const compareSemver = (a, b) => {
-	if (a.major !== b.major) return a.major - b.major;
-	if (a.minor !== b.minor) return a.minor - b.minor;
-	return a.patch - b.patch;
-};
-const satisfiesRange = (actual, min, prefix) => {
-	if (prefix === "^") return actual.major === min.major && compareSemver(actual, min) >= 0;
-	if (prefix === "~") {
-		if (actual.major !== min.major || actual.minor !== min.minor) return false;
-		return actual.patch >= min.patch;
-	}
-	return compareSemver(actual, min) >= 0;
-};
-const splitRange = (engine) => {
-	const trimmed = engine.trim();
-	const match = /^(>=|\^|~)(.+)$/.exec(trimmed);
-	if (match === null) return {
-		prefix: ">=",
-		rawMin: trimmed
-	};
-	return {
-		prefix: match[1],
-		rawMin: match[2] ?? ""
-	};
-};
-/**
-* Check whether a Bun runtime version satisfies a simple engines range.
-*
-* Supports `>=A.B.C`, `^A.B.C`, `~A.B.C`. Returns ok=true if `engine` is
-* undefined (no constraint). Pre-release suffixes on `bunVersion` are stripped
-* for the comparison.
-*
-* @param bunVersion - The current `Bun.version` string.
-* @param engine - The `engines.bun` field from package.json (or undefined).
-* @returns A {@link VersionCheck} with `ok: false` carrying a user-facing message.
-*/
-const checkBunVersion = (bunVersion, engine) => {
-	if (engine === void 0) return { ok: true };
-	const actual = parseSemver(bunVersion);
-	if (actual === null) return {
-		ok: false,
-		message: `Unable to parse Bun version: ${bunVersion}`
-	};
-	const { prefix, rawMin } = splitRange(engine);
-	const min = parseSemver(rawMin);
-	if (min === null) return {
-		ok: false,
-		message: `Unable to parse engine range: ${engine}`
-	};
-	if (satisfiesRange(actual, min, prefix)) return { ok: true };
-	return {
-		ok: false,
-		message: `Bun ${bunVersion} does not satisfy engines.bun "${engine}". Install Bun ${rawMin} or newer.`
-	};
-};
-
-//#endregion
-//#region src/bin/cli.ts
-/** @file runCli — pure dispatch over injected deps. Tested without spawning subprocesses. */
-/**
-* Top-level CLI dispatcher.
-*
-* Exit codes:
-*   0 - success
-*   1 - config / discovery error
-*   2 - build / runtime error
-*   3 - invalid arguments
-*   4 - unsupported runtime
-*
-* @param argv - Argv slice (already stripped of `node`/`bun` + script path).
-* @param deps - Injected dependencies.
-* @returns The exit code wrapper.
-*/
-const runCli = async (argv, deps) => {
-	const top = parseTopLevel(argv);
-	if (top.kind === "version") {
-		deps.stdout(deps.version);
-		return { code: 0 };
-	}
-	if (top.kind === "help") {
-		deps.stdout(formatBanner(deps.version));
-		deps.stdout(formatHelp());
-		return { code: 0 };
-	}
-	if (top.kind === "unknown-flag") {
-		deps.stderr(`Unknown flag: ${top.flag}`);
-		deps.stdout(formatHelp());
-		return { code: 3 };
-	}
-	const versionCheck = checkBunVersion(deps.bunVersion, deps.bunEngine);
-	if (!versionCheck.ok) {
-		deps.stderr(versionCheck.message);
-		return { code: 4 };
-	}
-	deps.stdout(formatBanner(deps.version));
-	switch (top.command) {
-		case "build": return deps.buildCommand(top.rest);
-		case "dev": return deps.devCommand(top.rest);
-		case "preview": return deps.previewCommand(top.rest);
-		case "deploy": return deps.deployCommand(top.rest);
-		default:
-			deps.stderr(`Unknown command: ${top.command}`);
-			deps.stdout(formatHelp());
-			return { code: 3 };
-	}
-};
-
-//#endregion
-//#region src/bin/commands/prepare.ts
-/**
-* Parse argv, branch on help/error, then load the app. Reduces command
-* complexity by hiding the four-way branch behind a single discriminant.
-*
-* @param options - Parser + loader + cwd.
-* @returns A {@link PreparedOutcome}.
-*/
-const prepareApp = async (options) => {
-	const parsed = options.parse(options.argv);
-	if (!parsed.ok) return {
-		kind: "bad-args",
-		message: parsed.message
-	};
-	if (parsed.value.help) return { kind: "help" };
-	const loaded = await options.loadApp({
-		cwd: options.cwd,
-		folder: parsed.value.folder
-	});
-	if (!loaded.ok) return {
-		kind: "load-failed",
-		message: loaded.message
-	};
-	return {
-		kind: "ready",
-		args: parsed.value,
-		app: loaded.value
-	};
-};
-/**
-* Time a build run and report it.
-*
-* @param app - The loaded CliApp.
-* @param stdout - Output channel.
-* @returns Exit code (0 ok, 2 build failure) and message already emitted.
-*/
-const runBuildOnce = async (app, stdout, stderr) => {
-	const start = performance.now();
-	try {
-		await app.build.run();
-	} catch (error) {
-		stderr(`Build failed: ${error.message}`);
-		return { code: 2 };
-	}
-	stdout(`Built in ${Math.round((performance.now() - start) / 100) / 10}s`);
-	return { code: 0 };
-};
-
-//#endregion
-//#region src/bin/commands/build.ts
-/** @file `moku build` command — load app, run app.build.run(), report timing. */
-/**
-* Run the build subcommand.
-*
-* @param argv - Argv after the `build` keyword.
-* @param deps - Injected IO / loader dependencies.
-* @returns Exit code: 0 ok, 1 config error, 2 build error, 3 arg error.
-*/
-const buildCommand = async (argv, deps) => {
-	const prepared = await prepareApp({
-		argv,
-		parse: parseBuild,
-		loadApp: deps.loadApp,
-		cwd: deps.cwd
-	});
-	if (prepared.kind === "help") {
-		deps.stdout(formatBuildHelp());
-		return { code: 0 };
-	}
-	if (prepared.kind === "bad-args") {
-		deps.stderr(prepared.message);
-		deps.stdout(formatBuildHelp());
-		return { code: 3 };
-	}
-	if (prepared.kind === "load-failed") {
-		deps.stderr(prepared.message);
-		return { code: 1 };
-	}
-	return runBuildOnce(prepared.app, deps.stdout, deps.stderr);
-};
-
-//#endregion
-//#region src/plugins/deploy/generators/github-workflow.ts
-/** @file deploy plugin GitHub Actions workflow generator — SHA-pinned, single-source-of-truth wrangler version. */
-/** Pinned SHAs for the standard runner actions. Update on each plugin release. */
-const CHECKOUT_ACTION_SHA = "11bd71901bbe5b1630ceea73d27597364c9af683";
-const SETUP_BUN_ACTION_SHA = "4bc047ad259df6fc24a6c9b0f9a0cb08cf17fbe5";
-/**
-* Generate the textual contents of `.github/workflows/deploy.yml`.
-*
-* Notes baked in:
-* - SHA-pinned actions (supply-chain hygiene).
-* - `wranglerVersion` pinned via {@link MOKU_WRANGLER_VERSION} — single SoT with `ensureWrangler()`.
-* - Command line uses `buildWranglerArgs(...)` so runtime and CI emit identical argv.
-* - No `--project-name` flag — wrangler reads `name` from `wrangler.jsonc`.
-* - Two-step pattern: `bun run moku build` then `wrangler-action` (enables Actions cache reuse).
-* - `gitHubToken` enables GitHub Deployments status updates on PRs and commits.
-*
-* @param input - Target, outdir, and branch.
-* @returns YAML text suitable for writing to `.github/workflows/deploy.yml`.
-*/
-const generateGitHubWorkflow = (input) => {
-	const args = require_wrangler.buildWranglerArgs(input.target, input.outdir, input.branch).join(" ");
-	return `# .github/workflows/deploy.yml — generated by \`moku deploy init --ci\`.
-# To re-sync after config changes, run \`moku deploy init --ci --force\`.
-
-name: Deploy
-
-on:
-  push:
-    branches: [${input.branch}]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@${CHECKOUT_ACTION_SHA}
-      - uses: oven-sh/setup-bun@${SETUP_BUN_ACTION_SHA}
-      - run: bun install --frozen-lockfile
-      # Two-step pattern (build then deploy) enables GitHub Actions cache reuse.
-      - run: bun run moku build
-      - uses: cloudflare/wrangler-action@${require_wrangler.WRANGLER_ACTION_SHA}
-        with:
-          apiToken: \${{ secrets.CLOUDFLARE_API_TOKEN }}
-          accountId: \${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
-          wranglerVersion: "${require_wrangler.MOKU_WRANGLER_VERSION}"
-          gitHubToken: \${{ secrets.GITHUB_TOKEN }}
-          # buildWranglerArgs() — keep aligned with runtime argv. wrangler.jsonc#name is SSoT
-          # for the project name, so we deliberately do NOT pass --project-name here.
-          command: ${args}
-`;
-};
-/** Resolve the workflow path inside `cwd`. */
-const workflowPath = (cwd) => (0, node_path.join)(cwd, ".github", "workflows", "deploy.yml");
-/** Check whether `.github/workflows/deploy.yml` exists in `cwd`. */
-const githubWorkflowExists = (cwd) => (0, node_fs.existsSync)(workflowPath(cwd));
-/** Write the generated workflow file, creating `.github/workflows/` as needed. */
-const writeGitHubWorkflow = async (cwd, content) => {
-	const path = workflowPath(cwd);
-	(0, node_fs.mkdirSync)((0, node_path.dirname)(path), { recursive: true });
-	await (0, node_fs_promises.writeFile)(path, content, "utf8");
-};
-
-//#endregion
-//#region src/plugins/deploy/slug.ts
-/** @file deploy plugin slug derivation — Cloudflare Pages project-name validation + slugification. */
-/**
-* Cloudflare Pages project-name regex: lowercase alphanumerics and dashes only,
-* 1–58 chars, no leading/trailing dash, no underscores. Source: workers-sdk #3222.
-*/
-const CLOUDFLARE_PROJECT_NAME_REGEX = /^[a-z0-9][a-z0-9-]{0,56}[a-z0-9]$/;
-const MAX_PROJECT_NAME_LENGTH = 58;
-/**
-* Derive a Cloudflare Pages–valid project slug from an arbitrary site name.
-*
-* Algorithm: lowercase → replace non-alphanumeric with `-` → collapse repeated
-* dashes → strip leading/trailing dashes → truncate to 58 chars → strip
-* trailing dashes again after truncation.
-*
-* @param siteName - The consumer-facing site name (typically `site.name`).
-* @returns A slug matching {@link CLOUDFLARE_PROJECT_NAME_REGEX}.
-* @throws Error when the input slugifies to an empty string or fails regex validation.
-*/
-const slugify = (siteName) => {
-	const raw = siteName.toLowerCase().replaceAll(/[^a-z0-9-]/g, "-").replaceAll(/-+/g, "-").replace(/^-+/, "").replace(/-+$/, "").slice(0, MAX_PROJECT_NAME_LENGTH).replace(/-+$/, "");
-	if (raw === "") throw new Error(`deploy: cannot derive a Cloudflare project slug from "${siteName}" — result is empty after sanitization`);
-	if (!CLOUDFLARE_PROJECT_NAME_REGEX.test(raw)) throw new Error(`deploy: derived slug "${raw}" does not match Cloudflare Pages project-name regex`);
-	return raw;
-};
-/**
-* Validate that an explicit project name matches Cloudflare's rules.
-*
-* @param name - Candidate project name.
-* @throws Error if the name violates {@link CLOUDFLARE_PROJECT_NAME_REGEX}.
-*/
-const assertValidProjectName = (name) => {
-	if (!CLOUDFLARE_PROJECT_NAME_REGEX.test(name)) throw new Error(`deploy: project name "${name}" must match ^[a-z0-9][a-z0-9-]{0,56}[a-z0-9]$ (1–58 chars, lowercase alphanumerics and dashes only, no leading/trailing dash, no underscores)`);
-};
-
-//#endregion
-//#region src/plugins/deploy/init.ts
-/** @file deploy plugin init orchestrator — branch detection, slug derivation, generators, checklist. */
-const DEFAULT_BRANCH = "main";
-const sanitizedProcessEnv = () => {
-	const out = {};
-	for (const [k, v] of Object.entries(process.env)) if (typeof v === "string") out[k] = v;
-	return out;
-};
-const getBun = () => globalThis;
-const runGitSymbolicRef = async () => {
-	const { Bun: bun } = getBun();
-	if (bun === void 0) return null;
-	try {
-		const proc = bun.spawn([
-			"git",
-			"symbolic-ref",
-			"refs/remotes/origin/HEAD"
-		], {
-			env: sanitizedProcessEnv(),
-			stdout: "pipe",
-			stderr: "pipe"
-		});
-		const stdout = await new Response(proc.stdout).text();
-		if (await proc.exited !== 0) return null;
-		return stdout.trim().match(/refs\/remotes\/origin\/(.+)$/)?.[1] ?? null;
-	} catch {
-		return null;
-	}
-};
-const runGitInitDefaultBranch = async () => {
-	const { Bun: bun } = getBun();
-	if (bun === void 0) return null;
-	try {
-		const proc = bun.spawn([
-			"git",
-			"config",
-			"--get",
-			"init.defaultBranch"
-		], {
-			env: sanitizedProcessEnv(),
-			stdout: "pipe",
-			stderr: "pipe"
-		});
-		const stdout = (await new Response(proc.stdout).text()).trim();
-		return await proc.exited === 0 && stdout !== "" ? stdout : null;
-	} catch {
-		return null;
-	}
-};
-/** Spawn `git symbolic-ref` with a fallback to `git config --get init.defaultBranch`. */
-const defaultDetectDefaultBranch = async () => {
-	const primary = await runGitSymbolicRef();
-	if (primary !== null) return primary;
-	return await runGitInitDefaultBranch() ?? DEFAULT_BRANCH;
-};
-/** Format a drift list as a printable diff block. */
-const formatDriftReport = (drift) => {
-	if (drift.length === 0) return "No drift detected.";
-	const lines = ["Drift detected:"];
-	for (const entry of drift) {
-		lines.push(`  ${entry.field}:`);
-		lines.push(`    - ${entry.current}`);
-		lines.push(`    + ${entry.proposed}`);
-	}
-	return lines.join("\n");
-};
-/** Print the post-init setup checklist to stdout. */
-const printChecklist = (stdout, slug, branch, createdProject) => {
-	stdout("");
-	stdout("Cloudflare Pages deploy — setup checklist");
-	stdout("");
-	stdout("1. Find your account ID:");
-	stdout("   https://dash.cloudflare.com  → string after dash.cloudflare.com/ in the URL.");
-	stdout("");
-	if (createdProject) stdout(`2. Pages project '${slug}' already exists (created by --create-project).`);
-	else {
-		stdout("2. Create the Pages project (skip if already created):");
-		stdout(`   wrangler pages project create ${slug}`);
-	}
-	stdout("");
-	stdout("3. Mint a Cloudflare API token:");
-	stdout("   https://dash.cloudflare.com/profile/api-tokens");
-	stdout("     → Create Token → Custom Token →");
-	stdout("     → Permissions: Account → Cloudflare Pages → Edit  (NOT \"Read\" — Read causes silent 403)");
-	stdout("   Click \"Create Token\", copy the value (shown only once).");
-	stdout("");
-	stdout("4. Add GitHub Actions secrets:");
-	stdout("   Settings → Secrets and variables → Actions → New repository secret");
-	stdout("   CLOUDFLARE_API_TOKEN  = (the token from step 3)");
-	stdout("   CLOUDFLARE_ACCOUNT_ID = (the ID from step 1)");
-	stdout("");
-	stdout("5. (Optional) Place _headers and _redirects in `public/` to control Cloudflare response headers and redirects.");
-	stdout("");
-	stdout(`6. Push to ${branch} — the generated workflow fires automatically.`);
-	stdout("");
-	stdout("Tip: run `moku deploy init --check` in release CI to assert config freshness.");
-	stdout("Note: Cloudflare dashboard git-push auto-build does NOT recognize wrangler.jsonc — use this workflow.");
-};
-const defaultPromptYesNo = async (_message, defaultYes) => Promise.resolve(defaultYes);
-/** Warn-and-overwrite branch of the slug drift decision (interactive "n" or `--force`). */
-const warnSlugChanged = (ctx, existingName, slug) => {
-	ctx.log.warn("deploy:init:slug-changed", {
-		existing: existingName,
-		computed: slug,
-		note: `Project rename: run \`wrangler pages project create ${slug}\`. The old project remains deployed under ${existingName}.pages.dev.`
-	});
-};
-const promptKeepExisting = async (ctx, existingName, slug) => {
-	return (ctx.promptYesNo ?? defaultPromptYesNo)(`${`wrangler.jsonc#name = "${existingName}" (existing) vs slug("${ctx.siteName}") = "${slug}" (computed).`}\nKeep existing? [Y/n]`, true);
-};
-/** Internal "should we write wrangler.jsonc?" decision around the diff-on-rename gate. */
-const resolveSlugWriteDecision = async (ctx, options, existing, slug, interactive) => {
-	if (existing === null || existing.name === slug) return true;
-	if (options.force === true) {
-		warnSlugChanged(ctx, existing.name, slug);
-		return true;
-	}
-	if (!interactive) {
-		ctx.log.info("deploy:init:slug-keep-existing", {
-			existing: existing.name,
-			computed: slug
-		});
-		return false;
-	}
-	if (await promptKeepExisting(ctx, existing.name, slug)) return false;
-	warnSlugChanged(ctx, existing.name, slug);
-	return true;
-};
-/** Run `wrangler pages project create` for the `--create-project` flag. Treats "already exists" as success. */
-const tryCreateCloudflareProject = async (ctx, slug) => {
-	const env = ctx.env ?? sanitizedProcessEnv();
-	try {
-		await require_wrangler.runWrangler([
-			"pages",
-			"project",
-			"create",
-			slug
-		], env, ctx.spawn);
-		return true;
-	} catch (error) {
-		const wranglerError = error instanceof Error ? error : new Error(String(error));
-		if (/already exists/i.test(wranglerError.message)) return true;
-		throw wranglerError;
-	}
-};
-/** Maybe write the GitHub Actions workflow file. */
-const maybeWriteWorkflow = async (ctx, options, cwd, branch) => {
-	if (options.ci !== true) return;
-	if (githubWorkflowExists(cwd) && options.force !== true) {
-		ctx.log.info("deploy:init:workflow-skipped", { reason: "exists; pass --force to overwrite" });
-		return;
-	}
-	await writeGitHubWorkflow(cwd, generateGitHubWorkflow({
-		target: ctx.config.target,
-		outdir: ctx.config.outdir,
-		branch
-	}));
-};
-/** Emit the "no build plugin registered" informational warning when appropriate. */
-const maybeWarnMissingBuild = (ctx) => {
-	if (!ctx.buildPluginRegistered && ctx.config.outdir === "dist") ctx.log.warn("deploy:init:no-build-plugin", { note: "No 'build' plugin registered and no explicit outdir set — using default 'dist'. Configure pluginConfigs.deploy.outdir if your build output lives elsewhere." });
-};
-/** Handle the `--check` short-circuit. */
-const handleCheckMode = (ctx, cwd, slug, outdir, branch) => {
-	const drift = require_wrangler.diffWranglerConfig(require_wrangler.readWranglerConfig(cwd), {
-		slug,
-		outdir
-	});
-	ctx.stdout(formatDriftReport(drift));
-	return {
-		slug,
-		outdir,
-		branch,
-		drift,
-		wroteFiles: false
-	};
-};
-const resolveInitInputs = async (ctx, options) => {
-	const detectBranch = ctx.detectDefaultBranch ?? defaultDetectDefaultBranch;
-	const branch = options.branch ?? await detectBranch();
-	const slug = ctx.config.projectName ?? slugify(ctx.siteName);
-	assertValidProjectName(slug);
-	const interactive = options.interactive ?? Boolean(process.stdout.isTTY);
-	return {
-		branch,
-		slug,
-		outdir: ctx.config.outdir,
-		interactive
-	};
-};
-/** Compose the writable artifacts step — wrangler.jsonc + workflow + warnings. */
-const writeArtifacts = async (ctx, options, cwd, inputs, writeJsonc) => {
-	if (writeJsonc) await require_wrangler.writeWranglerConfig(cwd, require_wrangler.generateWranglerConfig({
-		slug: inputs.slug,
-		outdir: inputs.outdir
-	}));
-	await maybeWriteWorkflow(ctx, options, cwd, inputs.branch);
-	maybeWarnMissingBuild(ctx);
-};
-/**
-* Run `moku deploy init`.
-*
-* @param ctx - {@link InitContext} carrying logger, stdout, and injectable spawn/git deps.
-* @param options - {@link InitOptions} flag set.
-* @returns A {@link InitResult} summarizing what happened.
-*/
-const runInit = async (ctx, options = {}) => {
-	const cwd = options.cwd ?? process.cwd();
-	const inputs = await resolveInitInputs(ctx, options);
-	if (options.check === true) return handleCheckMode(ctx, cwd, inputs.slug, inputs.outdir, inputs.branch);
-	const writeJsonc = await resolveSlugWriteDecision(ctx, options, require_wrangler.readWranglerConfig(cwd), inputs.slug, inputs.interactive);
-	const projectCreated = options.createProject === true ? await tryCreateCloudflareProject(ctx, inputs.slug) : void 0;
-	await writeArtifacts(ctx, options, cwd, inputs, writeJsonc);
-	const wroteFiles = writeJsonc || options.ci === true;
-	if (wroteFiles) printChecklist(ctx.stdout, inputs.slug, inputs.branch, projectCreated === true);
-	return {
-		slug: inputs.slug,
-		outdir: inputs.outdir,
-		branch: inputs.branch,
-		wroteFiles,
-		...projectCreated === void 0 ? {} : { projectCreated }
-	};
-};
-
-//#endregion
-//#region src/bin/commands/deploy.ts
-/** @file `moku deploy` command — load app, run app.deploy.run() or runInit(). */
-/**
-* Top-level dispatcher for `moku deploy` and `moku deploy init`.
-*
-* @param argv - Argv after the `deploy` keyword.
-* @param deps - Injected IO + loader dependencies.
-* @returns Exit code: 0 ok, 1 load error, 2 deploy error, 3 arg error.
-*/
-const deployCommand = async (argv, deps) => {
-	const [first, ...rest] = argv;
-	if (first === "init") return runInitCommand(rest, deps);
-	return runDeployCommand(argv, deps);
-};
-const runDeployCommand = async (argv, deps) => {
-	const prepared = await prepareApp({
-		argv,
-		parse: parseDeploy,
-		loadApp: deps.loadApp,
-		cwd: deps.cwd
-	});
-	if (prepared.kind === "help") {
-		deps.stdout(formatDeployHelp());
-		return { code: 0 };
-	}
-	if (prepared.kind === "bad-args") {
-		deps.stderr(prepared.message);
-		deps.stdout(formatDeployHelp());
-		return { code: 3 };
-	}
-	if (prepared.kind === "load-failed") {
-		deps.stderr(prepared.message);
-		return { code: 1 };
-	}
-	if (prepared.app.deploy === void 0) {
-		deps.stderr("deploy: this app does not register the deploy plugin.");
-		return { code: 1 };
-	}
-	try {
-		const result = await prepared.app.deploy.run({
-			...prepared.args.branch === void 0 ? {} : { branch: prepared.args.branch },
-			build: prepared.args.build
-		});
-		deps.stdout(`Deployed to ${result.url} (branch=${result.branch}, ${result.durationMs}ms)`);
-		return { code: 0 };
-	} catch (error) {
-		deps.stderr(`Deploy failed: ${error.message}`);
-		return { code: 2 };
-	}
-};
-const resolveDeployConfig = (app) => {
-	const fromAppConfig = app.config?.deploy;
-	if (fromAppConfig !== void 0) return fromAppConfig;
-	return {
-		target: "pages",
-		outdir: "dist",
-		productionBranch: "main"
-	};
-};
-const makeInitLogger = (deps) => ({
-	info: (event, data) => deps.stdout(`[info] ${event} ${data ? JSON.stringify(data) : ""}`),
-	warn: (event, data) => deps.stderr(`[warn] ${event} ${data ? JSON.stringify(data) : ""}`),
-	error: (event, data) => deps.stderr(`[error] ${event} ${data ? JSON.stringify(data) : ""}`)
-});
-const runInitForPreparedApp = async (deps, app, args) => {
-	const siteName = app.site?.name() ?? "";
-	if (siteName === "") {
-		deps.stderr("deploy init: site.name is empty — set it in your app config.");
-		return { code: 1 };
-	}
-	try {
-		const result = await runInit({
-			siteName,
-			config: resolveDeployConfig(app),
-			buildPluginRegistered: app.build !== void 0,
-			log: makeInitLogger(deps),
-			stdout: deps.stdout
-		}, {
-			cwd: deps.cwd,
-			ci: args.ci,
-			force: args.force,
-			createProject: args.createProject,
-			check: args.check,
-			...args.branch === void 0 ? {} : { branch: args.branch }
-		});
-		if (args.check && result.drift !== void 0 && result.drift.length > 0) return { code: 2 };
-		return { code: 0 };
-	} catch (error) {
-		deps.stderr(`Deploy init failed: ${error.message}`);
-		return { code: 2 };
-	}
-};
-const runInitCommand = async (argv, deps) => {
-	const prepared = await prepareApp({
-		argv,
-		parse: parseDeployInit,
-		loadApp: deps.loadApp,
-		cwd: deps.cwd
-	});
-	if (prepared.kind === "help") {
-		deps.stdout(formatDeployHelp());
-		return { code: 0 };
-	}
-	if (prepared.kind === "bad-args") {
-		deps.stderr(prepared.message);
-		deps.stdout(formatDeployHelp());
-		return { code: 3 };
-	}
-	if (prepared.kind === "load-failed") {
-		deps.stderr(prepared.message);
-		return { code: 1 };
-	}
-	return runInitForPreparedApp(deps, prepared.app, prepared.args);
-};
-
-//#endregion
-//#region src/bin/commands/dev.ts
-/** @file `moku dev` command — watch + invalidate + rebuild + serve loop. */
-const makeRebuildHandler = (app, deps) => async (paths) => {
-	if (app.content !== void 0) app.content.invalidate(paths);
-	try {
-		await app.build.run();
-		deps.stdout(`[dev] Rebuilt (${paths.length} change${paths.length === 1 ? "" : "s"})`);
-	} catch (error) {
-		deps.stderr(`[dev] Rebuild failed: ${error.message}`);
-	}
-};
-const startDevServer = (app, deps, port) => {
-	const outdir = app.config?.build?.outdir ?? "dist";
-	const defaultLocale = app.config?.i18n?.defaultLocale ?? "en";
-	return deps.serve({
-		rootDir: (0, node_path.resolve)(deps.cwd, outdir),
-		port,
-		defaultLocale
-	});
-};
-/**
-* Run the dev subcommand.
-*
-* Builds once, then watches `contentDir` and on each batch invalidates
-* content paths BEFORE calling `app.build.run()` (hard rule from CLAUDE.md).
-*
-* @param argv - Argv after the `dev` keyword.
-* @param deps - Injected IO / loader / watch / serve dependencies.
-* @returns Exit code: 0 ok, 1 config error, 2 build error, 3 arg error.
-*/
-const devCommand = async (argv, deps) => {
-	const prepared = await prepareApp({
-		argv,
-		parse: parseDev,
-		loadApp: deps.loadApp,
-		cwd: deps.cwd
-	});
-	if (prepared.kind === "help") {
-		deps.stdout(formatDevHelp());
-		return { code: 0 };
-	}
-	if (prepared.kind === "bad-args") {
-		deps.stderr(prepared.message);
-		deps.stdout(formatDevHelp());
-		return { code: 3 };
-	}
-	if (prepared.kind === "load-failed") {
-		deps.stderr(prepared.message);
-		return { code: 1 };
-	}
-	try {
-		await prepared.app.build.run();
-	} catch (error) {
-		deps.stderr(`Initial build failed: ${error.message}`);
-		return { code: 2 };
-	}
-	const handle = startDevServer(prepared.app, deps, prepared.args.port);
-	deps.stdout(`[dev] Serving at http://localhost:${handle.port}`);
-	deps.watch({
-		rootDir: deps.cwd,
-		contentDir: (0, node_path.resolve)(deps.cwd, "content"),
-		onChange: makeRebuildHandler(prepared.app, deps)
-	});
-	return { code: 0 };
-};
-
-//#endregion
-//#region src/bin/commands/preview.ts
-/** @file `moku preview` command — build once, then serve the outdir. */
-const startPreviewServer = (app, cwd, port, serve) => {
-	const outdir = app.config?.build?.outdir ?? "dist";
-	const defaultLocale = app.config?.i18n?.defaultLocale ?? "en";
-	return serve({
-		rootDir: (0, node_path.resolve)(cwd, outdir),
-		port,
-		defaultLocale
-	});
-};
-/**
-* Run the preview subcommand.
-*
-* @param argv - Argv after the `preview` keyword.
-* @param deps - Injected IO / loader / serve dependencies.
-* @returns Exit code: 0 ok, 1 config error, 2 build error, 3 arg error.
-*/
-const previewCommand = async (argv, deps) => {
-	const prepared = await prepareApp({
-		argv,
-		parse: parsePreview,
-		loadApp: deps.loadApp,
-		cwd: deps.cwd
-	});
-	if (prepared.kind === "help") {
-		deps.stdout(formatPreviewHelp());
-		return { code: 0 };
-	}
-	if (prepared.kind === "bad-args") {
-		deps.stderr(prepared.message);
-		deps.stdout(formatPreviewHelp());
-		return { code: 3 };
-	}
-	if (prepared.kind === "load-failed") {
-		deps.stderr(prepared.message);
-		return { code: 1 };
-	}
-	const build = await runBuildOnce(prepared.app, deps.stdout, deps.stderr);
-	if (build.code !== 0) return build;
-	const handle = startPreviewServer(prepared.app, deps.cwd, prepared.args.port, deps.serve);
-	deps.stdout(`[preview] Serving at http://localhost:${handle.port}`);
-	return { code: 0 };
-};
-
-//#endregion
-//#region src/bin/load-app.ts
-/** @file Discovers and dynamically imports the consumer's main.ts entry. */
-/**
-* Dynamically import `{cwd}/{folder}/main.ts` and return its default export.
-*
-* Returns a structured result rather than throwing; the CLI maps errors to
-* exit codes.
-*
-* @param options - The cwd and folder to look in.
-* @returns A {@link LoadResult}.
-*/
-const loadApp = async (options) => {
-	const mainPath = (0, node_path.resolve)(options.cwd, options.folder, "main.ts");
-	if (!(0, node_fs.existsSync)(mainPath)) return {
-		ok: false,
-		message: `main.ts not found at ${mainPath}. Run \`moku <command> <folder>\` with the correct path.`,
-		path: mainPath
-	};
-	try {
-		const mod = await import(mainPath);
-		if (mod.default === void 0) return {
-			ok: false,
-			message: `${mainPath} has no default export. Export your createApp() result as default.`,
-			path: mainPath
-		};
-		return {
-			ok: true,
-			value: mod.default,
-			path: mainPath
-		};
-	} catch (error) {
-		return {
-			ok: false,
-			message: `Failed to import ${mainPath}: ${error.message}`,
-			path: mainPath
-		};
-	}
-};
-
-//#endregion
-//#region src/bin/serve.ts
-/** @file Static file handler used by `moku preview` and `moku dev`. */
-const MIME_TYPES = new Map([
-	[".html", "text/html; charset=utf-8"],
-	[".css", "text/css; charset=utf-8"],
-	[".js", "application/javascript; charset=utf-8"],
-	[".mjs", "application/javascript; charset=utf-8"],
-	[".json", "application/json; charset=utf-8"],
-	[".svg", "image/svg+xml"],
-	[".png", "image/png"],
-	[".jpg", "image/jpeg"],
-	[".jpeg", "image/jpeg"],
-	[".gif", "image/gif"],
-	[".webp", "image/webp"],
-	[".ico", "image/x-icon"],
-	[".txt", "text/plain; charset=utf-8"],
-	[".xml", "application/xml; charset=utf-8"],
-	[".woff", "font/woff"],
-	[".woff2", "font/woff2"]
-]);
-const mimeFor = (path) => MIME_TYPES.get((0, node_path.extname)(path).toLowerCase()) ?? "application/octet-stream";
-const isPathInside = (parent, child) => `${child}${node_path.sep}`.startsWith(`${parent}${node_path.sep}`);
-const resolveTarget = (rootDir, urlPath) => {
-	const target = (0, node_path.resolve)(rootDir, (0, node_path.normalize)(`./${decodeURIComponent(urlPath).replaceAll("\\", "/").replace(/\/+/g, "/")}`));
-	if (!isPathInside(rootDir, target) && target !== rootDir) return null;
-	return target;
-};
-const resolveFilePath = (target, urlPath) => {
-	const candidate = urlPath.endsWith("/") ? (0, node_path.resolve)(target, "index.html") : target;
-	if (!(0, node_fs.existsSync)(candidate)) return null;
-	if (!(0, node_fs.statSync)(candidate).isDirectory()) return candidate;
-	const indexed = (0, node_path.resolve)(candidate, "index.html");
-	return (0, node_fs.existsSync)(indexed) ? indexed : null;
-};
-const fileResponse = (path) => new Response((0, node_fs.readFileSync)(path), { headers: { "content-type": mimeFor(path) } });
-/**
-* Build a fetch-style handler that serves files from `rootDir`.
-*
-* Behavior:
-* - Bare `/` redirects (307) to `/{defaultLocale}/`.
-* - Paths ending in `/` look for `index.html`.
-* - Path traversal attempts return 403.
-* - Missing files return 404.
-*
-* @param options - The root directory and default locale.
-* @returns A `(request: Request) => Promise<Response>` handler.
-*/
-const createStaticHandler = (options) => {
-	const root = (0, node_path.resolve)(options.rootDir);
-	return async (request) => {
-		const url = new URL(request.url);
-		if (url.pathname === "/") return new Response(null, {
-			status: 307,
-			headers: { location: `/${options.defaultLocale}/` }
-		});
-		const target = resolveTarget(root, url.pathname);
-		if (target === null) return new Response("Forbidden", { status: 403 });
-		const filePath = resolveFilePath(target, url.pathname);
-		if (filePath === null) return new Response("Not Found", { status: 404 });
-		return fileResponse(filePath);
-	};
-};
-
-//#endregion
-//#region src/bin/watch.ts
-/**
-* Create a trailing-edge debounced change batcher.
-*
-* Each `push(path)` (re)starts the debounce timer. When the timer fires the
-* collected unique paths are passed to `onFlush` and a new batch begins.
-* `flush()` drains immediately; `dispose()` cancels any pending flush without
-* invoking the callback.
-*
-* @param options - Debounce window + flush callback.
-* @returns The {@link ChangeBatcher} handle.
-*/
-const createChangeBatcher = (options) => {
-	let pending = /* @__PURE__ */ new Set();
-	let timer = null;
-	const clearTimer = () => {
-		if (timer !== null) {
-			clearTimeout(timer);
-			timer = null;
-		}
-	};
-	const drain = () => {
-		clearTimer();
-		if (pending.size === 0) return;
-		const batch = [...pending];
-		pending = /* @__PURE__ */ new Set();
-		options.onFlush(batch);
-	};
-	return {
-		push: (path) => {
-			pending.add(path);
-			clearTimer();
-			timer = setTimeout(drain, options.debounceMs);
-		},
-		flush: drain,
-		dispose: () => {
-			clearTimer();
-			pending = /* @__PURE__ */ new Set();
-		}
-	};
-};
-
-//#endregion
-//#region src/bin/moku.ts
-/** @file moku CLI entry — wires runtime IO to runCli. NOT a plugin. */
-const findPackageJson = () => {
-	const candidates = [
-		(0, node_path.resolve)({}.dir, "..", "..", "package.json"),
-		(0, node_path.resolve)({}.dir, "..", "package.json"),
-		(0, node_path.resolve)(process.cwd(), "package.json")
-	];
-	for (const candidate of candidates) if ((0, node_fs.existsSync)(candidate)) return JSON.parse((0, node_fs.readFileSync)(candidate, "utf8"));
-	return {};
-};
-const pkg = findPackageJson();
-const stdout = (line) => {
-	process.stdout.write(`${line}\n`);
-};
-const stderr = (line) => {
-	process.stderr.write(`${line}\n`);
-};
-const serveStatic = (options) => {
-	const handler = createStaticHandler({
-		rootDir: options.rootDir,
-		defaultLocale: options.defaultLocale
-	});
-	const server = Bun.serve({
-		port: options.port,
-		fetch: handler
-	});
-	return {
-		port: server.port ?? options.port,
-		stop: () => server.stop()
-	};
-};
-const startWatcher = (options) => {
-	const batcher = createChangeBatcher({
-		debounceMs: 50,
-		onFlush: (paths) => options.onChange(paths)
-	});
-	if (!(0, node_fs.existsSync)(options.contentDir)) return { stop: () => batcher.dispose() };
-	const watcher = (0, node_fs.watch)(options.contentDir, { recursive: true }, (_event, filename) => {
-		if (filename !== null) batcher.push(filename.toString());
-	});
-	return { stop: () => {
-		watcher.close();
-		batcher.dispose();
-	} };
-};
-const main = async () => {
-	const result = await runCli(process.argv.slice(2), {
-		cwd: process.cwd(),
-		version: pkg.version ?? "0.0.0",
-		bunVersion: Bun.version,
-		bunEngine: pkg.engines?.bun,
-		stdout,
-		stderr,
-		buildCommand: (argv) => buildCommand(argv, {
-			cwd: process.cwd(),
-			stdout,
-			stderr,
-			loadApp
-		}),
-		devCommand: (argv) => devCommand(argv, {
-			cwd: process.cwd(),
-			stdout,
-			stderr,
-			loadApp,
-			watch: startWatcher,
-			serve: serveStatic
-		}),
-		previewCommand: (argv) => previewCommand(argv, {
-			cwd: process.cwd(),
-			stdout,
-			stderr,
-			loadApp,
-			serve: serveStatic
-		}),
-		deployCommand: (argv) => deployCommand(argv, {
-			cwd: process.cwd(),
-			stdout,
-			stderr,
-			loadApp
-		})
-	});
-	process.exit(result.code);
-};
-main();
-
-//#endregion