@cloudflare/cli-shared-helpers 0.0.1

package/README.md

@@ -0,0 +1,5 @@
+# Cloudflare CLI
+
+> Internal utility package for workers-sdk. Not intended for external use — APIs may change without notice.
+
+All things related to rendering the CLI for workers-sdk.

package/dist/args.d.mts

@@ -0,0 +1,7 @@
+import { Arg, PromptConfig } from "./interactive.mjs";
+
+//#region args.d.ts
+declare const processArgument: <T>(args: Record<string, Arg>, name: string, promptConfig: PromptConfig) => Promise<T>;
+//#endregion
+export { processArgument };
+//# sourceMappingURL=args.d.mts.map

package/dist/args.mjs

@@ -0,0 +1,17 @@
+import { inputPrompt } from "./interactive.mjs";
+
+//#region args.ts
+const processArgument = async (args, name, promptConfig) => {
+	const value = args[name];
+	const result = await inputPrompt({
+		...promptConfig,
+		acceptDefault: promptConfig.acceptDefault ?? value !== void 0,
+		defaultValue: value ?? promptConfig.defaultValue
+	});
+	args[name] = result;
+	return result;
+};
+
+//#endregion
+export { processArgument };
+//# sourceMappingURL=args.mjs.map

package/dist/args.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.mjs","names":[],"sources":["../args.ts"],"sourcesContent":["import { inputPrompt } from \"./interactive\";\nimport type { Arg, PromptConfig } from \"./interactive\";\n\nexport const processArgument = async <T>(\n\targs: Record<string, Arg>,\n\tname: string,\n\tpromptConfig: PromptConfig\n) => {\n\tconst value = args[name];\n\tconst result = await inputPrompt<T>({\n\t\t...promptConfig,\n\t\t// Accept the default value if the arg is already set\n\t\tacceptDefault: promptConfig.acceptDefault ?? value !== undefined,\n\t\tdefaultValue: value ?? promptConfig.defaultValue,\n\t});\n\n\t// Update value in args before returning the result\n\targs[name] = result as Arg;\n\n\treturn result;\n};\n"],"mappings":";;;AAGA,MAAa,kBAAkB,OAC9B,MACA,MACA,iBACI;CACJ,MAAM,QAAQ,KAAK;CACnB,MAAM,SAAS,MAAM,YAAe;EACnC,GAAG;EAEH,eAAe,aAAa,iBAAiB,UAAU;EACvD,cAAc,SAAS,aAAa;EACpC,CAAC;AAGF,MAAK,QAAQ;AAEb,QAAO"}

package/dist/check-macos-version.d.mts

@@ -0,0 +1,15 @@
+//#region check-macos-version.d.ts
+/**
+ * Checks the current macOS version for workerd compatibility.
+ *
+ * This function is a no-op on non-Darwin platforms and in CI environments.
+ *
+ * @param options - Configuration object
+ * @param options.shouldThrow - If true, throws an error on unsupported versions. If false, logs a warning.
+ */
+declare function checkMacOSVersion(options: {
+  shouldThrow: boolean;
+}): void;
+//#endregion
+export { checkMacOSVersion };
+//# sourceMappingURL=check-macos-version.d.mts.map

package/dist/check-macos-version.mjs

@@ -0,0 +1,65 @@
+import os from "node:os";
+import { UserError } from "@cloudflare/workers-utils";
+import ci from "ci-info";
+
+//#region check-macos-version.ts
+/**
+* Minimum macOS version required for workerd compatibility.
+*/
+const MINIMUM_MACOS_VERSION = "13.5.0";
+/**
+* Checks the current macOS version for workerd compatibility.
+*
+* This function is a no-op on non-Darwin platforms and in CI environments.
+*
+* @param options - Configuration object
+* @param options.shouldThrow - If true, throws an error on unsupported versions. If false, logs a warning.
+*/
+function checkMacOSVersion(options) {
+	if (process.platform !== "darwin") return;
+	if (ci.isCI) return;
+	const macOSVersion = darwinVersionToMacOSVersion(os.release());
+	if (macOSVersion && isVersionLessThan(macOSVersion, MINIMUM_MACOS_VERSION)) if (options.shouldThrow) throw new UserError(`Unsupported macOS version: The Cloudflare Workers runtime cannot run on the current version of macOS (${macOSVersion}). The minimum requirement is macOS ${MINIMUM_MACOS_VERSION}+. See https://github.com/cloudflare/workerd?tab=readme-ov-file#running-workerd If you cannot upgrade your version of macOS, you could try running in a DevContainer setup with a supported version of Linux (glibc 2.35+ required).`);
+	else console.warn(`⚠️  Warning: Unsupported macOS version detected (${macOSVersion}). The Cloudflare Workers runtime may not work correctly on macOS versions below ${MINIMUM_MACOS_VERSION}. Consider upgrading to macOS ${MINIMUM_MACOS_VERSION}+ or using a DevContainer setup with a supported version of Linux (glibc 2.35+ required).`);
+}
+/**
+* Converts Darwin kernel version to macOS version.
+* Darwin 21.x.x = macOS 12.x (Monterey)
+* Darwin 22.x.x = macOS 13.x (Ventura)
+* Darwin 23.x.x = macOS 14.x (Sonoma)
+* etc.
+*/
+function darwinVersionToMacOSVersion(darwinVersion) {
+	const match = darwinVersion.match(/^(\d+)\.(\d+)\.(\d+)/);
+	if (!match) return null;
+	const major = parseInt(match[1], 10);
+	if (major >= 20) return `${major - 9}.${parseInt(match[2], 10)}.${parseInt(match[3], 10)}`;
+	return null;
+}
+/**
+* Simple semver comparison for major.minor.patch versions.
+* Validates that both versions follow the M.m.p format before comparison.
+*/
+function isVersionLessThan(version1, version2) {
+	const versionRegex = /^(\d+)\.(\d+)\.(\d+)$/;
+	const match1 = version1.match(versionRegex);
+	const match2 = version2.match(versionRegex);
+	if (!match1 || !match2) throw new Error(`Invalid version format. Expected M.m.p format, got: ${version1}, ${version2}`);
+	const [major1, minor1, patch1] = [
+		parseInt(match1[1], 10),
+		parseInt(match1[2], 10),
+		parseInt(match1[3], 10)
+	];
+	const [major2, minor2, patch2] = [
+		parseInt(match2[1], 10),
+		parseInt(match2[2], 10),
+		parseInt(match2[3], 10)
+	];
+	if (major1 !== major2) return major1 < major2;
+	if (minor1 !== minor2) return minor1 < minor2;
+	return patch1 < patch2;
+}
+
+//#endregion
+export { checkMacOSVersion };
+//# sourceMappingURL=check-macos-version.mjs.map

package/dist/check-macos-version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-macos-version.mjs","names":[],"sources":["../check-macos-version.ts"],"sourcesContent":["import os from \"node:os\";\nimport { UserError } from \"@cloudflare/workers-utils\";\nimport ci from \"ci-info\";\n\n/**\n * Minimum macOS version required for workerd compatibility.\n */\nconst MINIMUM_MACOS_VERSION = \"13.5.0\";\n\n/**\n * Checks the current macOS version for workerd compatibility.\n *\n * This function is a no-op on non-Darwin platforms and in CI environments.\n *\n * @param options - Configuration object\n * @param options.shouldThrow - If true, throws an error on unsupported versions. If false, logs a warning.\n */\nexport function checkMacOSVersion(options: { shouldThrow: boolean }): void {\n\tif (process.platform !== \"darwin\") {\n\t\treturn;\n\t}\n\n\tif (ci.isCI) {\n\t\treturn;\n\t}\n\n\tconst release = os.release();\n\tconst macOSVersion = darwinVersionToMacOSVersion(release);\n\n\tif (macOSVersion && isVersionLessThan(macOSVersion, MINIMUM_MACOS_VERSION)) {\n\t\tif (options.shouldThrow) {\n\t\t\tthrow new UserError(\n\t\t\t\t`Unsupported macOS version: The Cloudflare Workers runtime cannot run on the current version of macOS (${macOSVersion}). ` +\n\t\t\t\t\t`The minimum requirement is macOS ${MINIMUM_MACOS_VERSION}+. See https://github.com/cloudflare/workerd?tab=readme-ov-file#running-workerd ` +\n\t\t\t\t\t`If you cannot upgrade your version of macOS, you could try running in a DevContainer setup with a supported version of Linux (glibc 2.35+ required).`\n\t\t\t);\n\t\t} else {\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.warn(\n\t\t\t\t`⚠️  Warning: Unsupported macOS version detected (${macOSVersion}). ` +\n\t\t\t\t\t`The Cloudflare Workers runtime may not work correctly on macOS versions below ${MINIMUM_MACOS_VERSION}. ` +\n\t\t\t\t\t`Consider upgrading to macOS ${MINIMUM_MACOS_VERSION}+ or using a DevContainer setup with a supported version of Linux (glibc 2.35+ required).`\n\t\t\t);\n\t\t}\n\t}\n}\n\n/**\n * Converts Darwin kernel version to macOS version.\n * Darwin 21.x.x = macOS 12.x (Monterey)\n * Darwin 22.x.x = macOS 13.x (Ventura)\n * Darwin 23.x.x = macOS 14.x (Sonoma)\n * etc.\n */\nfunction darwinVersionToMacOSVersion(darwinVersion: string): string | null {\n\tconst match = darwinVersion.match(/^(\\d+)\\.(\\d+)\\.(\\d+)/);\n\tif (!match) {\n\t\treturn null;\n\t}\n\n\tconst major = parseInt(match[1], 10);\n\n\tif (major >= 20) {\n\t\tconst macOSMajor = major - 9;\n\t\tconst minor = parseInt(match[2], 10);\n\t\tconst patch = parseInt(match[3], 10);\n\t\treturn `${macOSMajor}.${minor}.${patch}`;\n\t}\n\n\treturn null;\n}\n\n/**\n * Simple semver comparison for major.minor.patch versions.\n * Validates that both versions follow the M.m.p format before comparison.\n */\nfunction isVersionLessThan(version1: string, version2: string): boolean {\n\tconst versionRegex = /^(\\d+)\\.(\\d+)\\.(\\d+)$/;\n\n\tconst match1 = version1.match(versionRegex);\n\tconst match2 = version2.match(versionRegex);\n\n\tif (!match1 || !match2) {\n\t\tthrow new Error(\n\t\t\t`Invalid version format. Expected M.m.p format, got: ${version1}, ${version2}`\n\t\t);\n\t}\n\n\tconst [major1, minor1, patch1] = [\n\t\tparseInt(match1[1], 10),\n\t\tparseInt(match1[2], 10),\n\t\tparseInt(match1[3], 10),\n\t];\n\tconst [major2, minor2, patch2] = [\n\t\tparseInt(match2[1], 10),\n\t\tparseInt(match2[2], 10),\n\t\tparseInt(match2[3], 10),\n\t];\n\n\tif (major1 !== major2) {\n\t\treturn major1 < major2;\n\t}\n\tif (minor1 !== minor2) {\n\t\treturn minor1 < minor2;\n\t}\n\treturn patch1 < patch2;\n}\n"],"mappings":";;;;;;;;AAOA,MAAM,wBAAwB;;;;;;;;;AAU9B,SAAgB,kBAAkB,SAAyC;AAC1E,KAAI,QAAQ,aAAa,SACxB;AAGD,KAAI,GAAG,KACN;CAID,MAAM,eAAe,4BADL,GAAG,SAAS,CAC6B;AAEzD,KAAI,gBAAgB,kBAAkB,cAAc,sBAAsB,CACzE,KAAI,QAAQ,YACX,OAAM,IAAI,UACT,yGAAyG,aAAa,sCACjF,sBAAsB,sOAE3D;KAGD,SAAQ,KACP,oDAAoD,aAAa,mFACiB,sBAAsB,gCACxE,sBAAsB,2FACtD;;;;;;;;;AAYJ,SAAS,4BAA4B,eAAsC;CAC1E,MAAM,QAAQ,cAAc,MAAM,uBAAuB;AACzD,KAAI,CAAC,MACJ,QAAO;CAGR,MAAM,QAAQ,SAAS,MAAM,IAAI,GAAG;AAEpC,KAAI,SAAS,GAIZ,QAAO,GAHY,QAAQ,EAGN,GAFP,SAAS,MAAM,IAAI,GAAG,CAEN,GADhB,SAAS,MAAM,IAAI,GAAG;AAIrC,QAAO;;;;;;AAOR,SAAS,kBAAkB,UAAkB,UAA2B;CACvE,MAAM,eAAe;CAErB,MAAM,SAAS,SAAS,MAAM,aAAa;CAC3C,MAAM,SAAS,SAAS,MAAM,aAAa;AAE3C,KAAI,CAAC,UAAU,CAAC,OACf,OAAM,IAAI,MACT,uDAAuD,SAAS,IAAI,WACpE;CAGF,MAAM,CAAC,QAAQ,QAAQ,UAAU;EAChC,SAAS,OAAO,IAAI,GAAG;EACvB,SAAS,OAAO,IAAI,GAAG;EACvB,SAAS,OAAO,IAAI,GAAG;EACvB;CACD,MAAM,CAAC,QAAQ,QAAQ,UAAU;EAChC,SAAS,OAAO,IAAI,GAAG;EACvB,SAAS,OAAO,IAAI,GAAG;EACvB,SAAS,OAAO,IAAI,GAAG;EACvB;AAED,KAAI,WAAW,OACd,QAAO,SAAS;AAEjB,KAAI,WAAW,OACd,QAAO,SAAS;AAEjB,QAAO,SAAS"}

package/dist/colors.d.mts

@@ -0,0 +1,16 @@
+import * as chalk0 from "chalk";
+
+//#region colors.d.ts
+declare const white: chalk0.ChalkInstance, gray: chalk0.ChalkInstance, dim: chalk0.ChalkInstance, hidden: chalk0.ChalkInstance, bold: chalk0.ChalkInstance, cyanBright: chalk0.ChalkInstance, bgCyan: chalk0.ChalkInstance;
+declare const brandColor: chalk0.ChalkInstance;
+declare const blue: chalk0.ChalkInstance;
+declare const bgBlue: chalk0.ChalkInstance;
+declare const red: chalk0.ChalkInstance;
+declare const bgRed: chalk0.ChalkInstance;
+declare const green: chalk0.ChalkInstance;
+declare const bgGreen: chalk0.ChalkInstance;
+declare const yellow: chalk0.ChalkInstance;
+declare const bgYellow: chalk0.ChalkInstance;
+//#endregion
+export { bgBlue, bgCyan, bgGreen, bgRed, bgYellow, blue, bold, brandColor, cyanBright, dim, gray, green, hidden, red, white, yellow };
+//# sourceMappingURL=colors.d.mts.map

package/dist/colors.mjs

@@ -0,0 +1,18 @@
+import chalk from "chalk";
+
+//#region colors.ts
+const { white, gray, dim, hidden, bold, cyanBright, bgCyan } = chalk;
+const brandColor = chalk.hex("#BD5B08");
+const black = chalk.hex("#111");
+const blue = chalk.hex("#0E838F");
+const bgBlue = black.bgHex("#0E838F");
+const red = chalk.hex("#AB2526");
+const bgRed = black.bgHex("#AB2526");
+const green = chalk.hex("#218529");
+const bgGreen = black.bgHex("#218529");
+const yellow = chalk.hex("#7F7322");
+const bgYellow = black.bgHex("#7F7322");
+
+//#endregion
+export { bgBlue, bgCyan, bgGreen, bgRed, bgYellow, blue, bold, brandColor, cyanBright, dim, gray, green, hidden, red, white, yellow };
+//# sourceMappingURL=colors.mjs.map

package/dist/colors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.mjs","names":[],"sources":["../colors.ts"],"sourcesContent":["import chalk from \"chalk\";\n\nconst { white, gray, dim, hidden, bold, cyanBright, bgCyan } = chalk;\n\nconst brandColor = chalk.hex(\"#BD5B08\");\n\nconst black = chalk.hex(\"#111\");\nconst blue = chalk.hex(\"#0E838F\");\nconst bgBlue = black.bgHex(\"#0E838F\");\nconst red = chalk.hex(\"#AB2526\");\nconst bgRed = black.bgHex(\"#AB2526\");\nconst green = chalk.hex(\"#218529\");\nconst bgGreen = black.bgHex(\"#218529\");\nconst yellow = chalk.hex(\"#7F7322\");\nconst bgYellow = black.bgHex(\"#7F7322\");\n\nexport {\n\tblue,\n\tbgBlue,\n\tgreen,\n\tbgGreen,\n\tred,\n\tbgRed,\n\tyellow,\n\tbgYellow,\n\tcyanBright,\n\tbgCyan,\n\tbrandColor,\n\tdim,\n\twhite,\n\tgray,\n\thidden,\n\tbold,\n};\n"],"mappings":";;;AAEA,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,MAAM,YAAY,WAAW;AAE/D,MAAM,aAAa,MAAM,IAAI,UAAU;AAEvC,MAAM,QAAQ,MAAM,IAAI,OAAO;AAC/B,MAAM,OAAO,MAAM,IAAI,UAAU;AACjC,MAAM,SAAS,MAAM,MAAM,UAAU;AACrC,MAAM,MAAM,MAAM,IAAI,UAAU;AAChC,MAAM,QAAQ,MAAM,MAAM,UAAU;AACpC,MAAM,QAAQ,MAAM,IAAI,UAAU;AAClC,MAAM,UAAU,MAAM,MAAM,UAAU;AACtC,MAAM,SAAS,MAAM,IAAI,UAAU;AACnC,MAAM,WAAW,MAAM,MAAM,UAAU"}

package/dist/command.d.mts

@@ -0,0 +1,46 @@
+//#region command.d.ts
+/**
+ * Command is a string array, like ['git', 'commit', '-m', '"Initial commit"']
+ */
+type Command = string[];
+type RunOptions = {
+  startText?: string;
+  doneText?: string | ((output: string) => string);
+  silent?: boolean;
+  captureOutput?: boolean;
+  useSpinner?: boolean;
+  env?: NodeJS.ProcessEnv;
+  cwd?: string;
+  /** If defined this function is called to all you to transform the output from the command into a new string. */
+  transformOutput?: (output: string) => string;
+};
+/**
+ * An awaitable wrapper around `spawn` that optionally displays progress to user and processes/captures the command's output
+ *
+ * @param command - The command to run as an array of strings
+ * @param opts.silent - Should the command's stdout and stderr be dispalyed to the user
+ * @param opts.captureOutput - Should the output of the command the returned as a string.
+ * @param opts.env - An object of environment variables to be injected when running the command
+ * @param opts.cwd - The directory in which the command should be run
+ * @param opts.useSpinner - Should a spinner be shown when running the command
+ * @param opts.startText - Spinner start text
+ * @param opts.endText - Spinner end text
+ * @param opts.transformOutput - A transformer to be run on command output before returning
+ *
+ * @returns Output collected from the stdout of the command, if `captureOutput` was set to true. Otherwise `null`.
+ */
+declare const runCommand: (command: Command, opts?: RunOptions) => Promise<string>;
+/**
+ * Formats an array of command line arguments to be displayed to the user
+ * in a platform safe way. Args used in conjunction with `runCommand` are safe
+ * since we use `cross-spawn` to handle multi-platform support.
+ *
+ * However, when we output commands to the user, we have to make sure that they
+ * are compatible with the platform they are using.
+ *
+ * @param args - The arguments to format to the user
+ */
+declare function quoteShellArgs(args: string[]): string;
+//#endregion
+export { RunOptions, quoteShellArgs, runCommand };
+//# sourceMappingURL=command.d.mts.map

package/dist/command.mjs

@@ -0,0 +1,114 @@
+import { CancelError } from "./error.mjs";
+import { stripAnsi } from "./index.mjs";
+import { isInteractive, spinner } from "./interactive.mjs";
+import { spawn } from "cross-spawn";
+
+//#region command.ts
+/**
+* An awaitable wrapper around `spawn` that optionally displays progress to user and processes/captures the command's output
+*
+* @param command - The command to run as an array of strings
+* @param opts.silent - Should the command's stdout and stderr be dispalyed to the user
+* @param opts.captureOutput - Should the output of the command the returned as a string.
+* @param opts.env - An object of environment variables to be injected when running the command
+* @param opts.cwd - The directory in which the command should be run
+* @param opts.useSpinner - Should a spinner be shown when running the command
+* @param opts.startText - Spinner start text
+* @param opts.endText - Spinner end text
+* @param opts.transformOutput - A transformer to be run on command output before returning
+*
+* @returns Output collected from the stdout of the command, if `captureOutput` was set to true. Otherwise `null`.
+*/
+const runCommand = async (command, opts = {}) => {
+	return printAsyncStatus({
+		useSpinner: opts.useSpinner ?? opts.silent,
+		startText: opts.startText || quoteShellArgs(command),
+		doneText: opts.doneText,
+		promise() {
+			const [executable, ...args] = command;
+			const abortController = new AbortController();
+			const cmd = spawn(executable, [...args], {
+				stdio: opts.silent ? "pipe" : "inherit",
+				env: {
+					...process.env,
+					...opts.env
+				},
+				cwd: opts.cwd,
+				signal: abortController.signal
+			});
+			let output = ``;
+			if (opts.captureOutput ?? opts.silent) {
+				cmd.stdout?.on("data", (data) => {
+					output += data;
+				});
+				cmd.stderr?.on("data", (data) => {
+					output += data;
+				});
+			}
+			let cleanup = null;
+			return new Promise((resolvePromise, reject) => {
+				const cancel = (signal) => {
+					reject(new CancelError(`Command cancelled`, signal));
+					abortController.abort(signal ? `${signal} received` : null);
+				};
+				process.on("SIGTERM", cancel).on("SIGINT", cancel);
+				cleanup = () => {
+					process.off("SIGTERM", cancel).off("SIGINT", cancel);
+				};
+				cmd.on("close", (code) => {
+					try {
+						if (code !== 0) throw new Error(output, { cause: code });
+						resolvePromise((opts.transformOutput ?? ((result) => result))(stripAnsi(output)));
+					} catch (e) {
+						reject(new Error(output, { cause: e }));
+					}
+				});
+				cmd.on("error", (error) => {
+					reject(error);
+				});
+			}).finally(() => {
+				cleanup?.();
+			});
+		}
+	});
+};
+const printAsyncStatus = async ({ promise,...opts }) => {
+	let s;
+	if (opts.useSpinner && isInteractive()) s = spinner();
+	s?.start(opts?.startText);
+	if (typeof promise === "function") promise = promise();
+	try {
+		const output = await promise;
+		const doneText = typeof opts.doneText === "function" ? opts.doneText(output) : opts.doneText;
+		s?.stop(doneText);
+	} catch (err) {
+		s?.stop(err.message);
+	} finally {
+		s?.stop();
+	}
+	return promise;
+};
+/**
+* Formats an array of command line arguments to be displayed to the user
+* in a platform safe way. Args used in conjunction with `runCommand` are safe
+* since we use `cross-spawn` to handle multi-platform support.
+*
+* However, when we output commands to the user, we have to make sure that they
+* are compatible with the platform they are using.
+*
+* @param args - The arguments to format to the user
+*/
+function quoteShellArgs(args) {
+	if (process.platform === "win32") {
+		const specialCharsMatcher = /[&<>[\]|{}^=;!'+,`~\s]/;
+		return args.map((arg) => arg.match(specialCharsMatcher) ? `"${arg.replaceAll(`"`, `""`)}"` : arg).join(" ");
+	} else return args.map((s) => {
+		if (/["\s]/.test(s) && !/'/.test(s)) return "'" + s.replace(/(['\\])/g, "\\$1") + "'";
+		if (/["'\s]/.test(s)) return "\"" + s.replace(/(["\\$`!])/g, "\\$1") + "\"";
+		return s;
+	}).join(" ");
+}
+
+//#endregion
+export { quoteShellArgs, runCommand };
+//# sourceMappingURL=command.mjs.map

package/dist/command.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.mjs","names":["cleanup: (() => void) | null","s: ReturnType<typeof spinner> | undefined"],"sources":["../command.ts"],"sourcesContent":["import { spawn } from \"cross-spawn\";\nimport { CancelError } from \"./error\";\nimport { isInteractive, spinner } from \"./interactive\";\nimport { stripAnsi } from \".\";\n\n/**\n * Command is a string array, like ['git', 'commit', '-m', '\"Initial commit\"']\n */\ntype Command = string[];\n\nexport type RunOptions = {\n\tstartText?: string;\n\tdoneText?: string | ((output: string) => string);\n\tsilent?: boolean;\n\tcaptureOutput?: boolean;\n\tuseSpinner?: boolean;\n\tenv?: NodeJS.ProcessEnv;\n\tcwd?: string;\n\t/** If defined this function is called to all you to transform the output from the command into a new string. */\n\ttransformOutput?: (output: string) => string;\n};\n\ntype PrintOptions<T> = {\n\tpromise: Promise<T> | (() => Promise<T>);\n\tuseSpinner?: boolean;\n\tstartText: string;\n\tdoneText?: string | ((output: T) => string);\n};\n\n/**\n * An awaitable wrapper around `spawn` that optionally displays progress to user and processes/captures the command's output\n *\n * @param command - The command to run as an array of strings\n * @param opts.silent - Should the command's stdout and stderr be dispalyed to the user\n * @param opts.captureOutput - Should the output of the command the returned as a string.\n * @param opts.env - An object of environment variables to be injected when running the command\n * @param opts.cwd - The directory in which the command should be run\n * @param opts.useSpinner - Should a spinner be shown when running the command\n * @param opts.startText - Spinner start text\n * @param opts.endText - Spinner end text\n * @param opts.transformOutput - A transformer to be run on command output before returning\n *\n * @returns Output collected from the stdout of the command, if `captureOutput` was set to true. Otherwise `null`.\n */\nexport const runCommand = async (\n\tcommand: Command,\n\topts: RunOptions = {}\n): Promise<string> => {\n\treturn printAsyncStatus({\n\t\tuseSpinner: opts.useSpinner ?? opts.silent,\n\t\tstartText: opts.startText || quoteShellArgs(command),\n\t\tdoneText: opts.doneText,\n\t\tpromise() {\n\t\t\tconst [executable, ...args] = command;\n\t\t\tconst abortController = new AbortController();\n\t\t\tconst cmd = spawn(executable, [...args], {\n\t\t\t\t// TODO: ideally inherit stderr, but npm install uses this for warnings\n\t\t\t\t// stdio: [ioMode, ioMode, \"inherit\"],\n\t\t\t\tstdio: opts.silent ? \"pipe\" : \"inherit\",\n\t\t\t\tenv: {\n\t\t\t\t\t...process.env,\n\t\t\t\t\t...opts.env,\n\t\t\t\t},\n\t\t\t\tcwd: opts.cwd,\n\t\t\t\tsignal: abortController.signal,\n\t\t\t});\n\n\t\t\tlet output = ``;\n\n\t\t\tif (opts.captureOutput ?? opts.silent) {\n\t\t\t\tcmd.stdout?.on(\"data\", (data) => {\n\t\t\t\t\toutput += data;\n\t\t\t\t});\n\t\t\t\tcmd.stderr?.on(\"data\", (data) => {\n\t\t\t\t\toutput += data;\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tlet cleanup: (() => void) | null = null;\n\n\t\t\treturn new Promise<string>((resolvePromise, reject) => {\n\t\t\t\tconst cancel = (signal?: NodeJS.Signals) => {\n\t\t\t\t\treject(new CancelError(`Command cancelled`, signal));\n\t\t\t\t\tabortController.abort(signal ? `${signal} received` : null);\n\t\t\t\t};\n\n\t\t\t\tprocess.on(\"SIGTERM\", cancel).on(\"SIGINT\", cancel);\n\n\t\t\t\t// To cleanup the signal listeners when the promise settles\n\t\t\t\tcleanup = () => {\n\t\t\t\t\tprocess.off(\"SIGTERM\", cancel).off(\"SIGINT\", cancel);\n\t\t\t\t};\n\n\t\t\t\tcmd.on(\"close\", (code) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tif (code !== 0) {\n\t\t\t\t\t\t\tthrow new Error(output, { cause: code });\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Process any captured output\n\t\t\t\t\t\tconst transformOutput =\n\t\t\t\t\t\t\topts.transformOutput ?? ((result: string) => result);\n\t\t\t\t\t\tconst processedOutput = transformOutput(stripAnsi(output));\n\n\t\t\t\t\t\t// Send the captured (and processed) output back to the caller\n\t\t\t\t\t\tresolvePromise(processedOutput);\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\t// Something went wrong.\n\t\t\t\t\t\t// Perhaps the command or the transform failed.\n\t\t\t\t\t\treject(new Error(output, { cause: e }));\n\t\t\t\t\t}\n\t\t\t\t});\n\n\t\t\t\tcmd.on(\"error\", (error) => {\n\t\t\t\t\treject(error);\n\t\t\t\t});\n\t\t\t}).finally(() => {\n\t\t\t\tcleanup?.();\n\t\t\t});\n\t\t},\n\t});\n};\n\nconst printAsyncStatus = async <T>({\n\tpromise,\n\t...opts\n}: PrintOptions<T>): Promise<T> => {\n\tlet s: ReturnType<typeof spinner> | undefined;\n\n\tif (opts.useSpinner && isInteractive()) {\n\t\ts = spinner();\n\t}\n\n\ts?.start(opts?.startText);\n\n\tif (typeof promise === \"function\") {\n\t\tpromise = promise();\n\t}\n\n\ttry {\n\t\tconst output = await promise;\n\n\t\tconst doneText =\n\t\t\ttypeof opts.doneText === \"function\"\n\t\t\t\t? opts.doneText(output)\n\t\t\t\t: opts.doneText;\n\t\ts?.stop(doneText);\n\t} catch (err) {\n\t\ts?.stop((err as Error).message);\n\t} finally {\n\t\ts?.stop();\n\t}\n\n\treturn promise;\n};\n\n/**\n * Formats an array of command line arguments to be displayed to the user\n * in a platform safe way. Args used in conjunction with `runCommand` are safe\n * since we use `cross-spawn` to handle multi-platform support.\n *\n * However, when we output commands to the user, we have to make sure that they\n * are compatible with the platform they are using.\n *\n * @param args - The arguments to format to the user\n */\nexport function quoteShellArgs(args: string[]): string {\n\tif (process.platform === \"win32\") {\n\t\t// Simple Windows command prompt quoting if there are special characters.\n\t\tconst specialCharsMatcher = /[&<>[\\]|{}^=;!'+,`~\\s]/;\n\t\treturn args\n\t\t\t.map((arg) =>\n\t\t\t\targ.match(specialCharsMatcher) ? `\"${arg.replaceAll(`\"`, `\"\"`)}\"` : arg\n\t\t\t)\n\t\t\t.join(\" \");\n\t} else {\n\t\treturn args\n\t\t\t.map((s) => {\n\t\t\t\tif (/[\"\\s]/.test(s) && !/'/.test(s)) {\n\t\t\t\t\treturn \"'\" + s.replace(/(['\\\\])/g, \"\\\\$1\") + \"'\";\n\t\t\t\t}\n\t\t\t\tif (/[\"'\\s]/.test(s)) {\n\t\t\t\t\treturn '\"' + s.replace(/([\"\\\\$`!])/g, \"\\\\$1\") + '\"';\n\t\t\t\t}\n\t\t\t\treturn s;\n\t\t\t})\n\t\t\t.join(\" \");\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA4CA,MAAa,aAAa,OACzB,SACA,OAAmB,EAAE,KACA;AACrB,QAAO,iBAAiB;EACvB,YAAY,KAAK,cAAc,KAAK;EACpC,WAAW,KAAK,aAAa,eAAe,QAAQ;EACpD,UAAU,KAAK;EACf,UAAU;GACT,MAAM,CAAC,YAAY,GAAG,QAAQ;GAC9B,MAAM,kBAAkB,IAAI,iBAAiB;GAC7C,MAAM,MAAM,MAAM,YAAY,CAAC,GAAG,KAAK,EAAE;IAGxC,OAAO,KAAK,SAAS,SAAS;IAC9B,KAAK;KACJ,GAAG,QAAQ;KACX,GAAG,KAAK;KACR;IACD,KAAK,KAAK;IACV,QAAQ,gBAAgB;IACxB,CAAC;GAEF,IAAI,SAAS;AAEb,OAAI,KAAK,iBAAiB,KAAK,QAAQ;AACtC,QAAI,QAAQ,GAAG,SAAS,SAAS;AAChC,eAAU;MACT;AACF,QAAI,QAAQ,GAAG,SAAS,SAAS;AAChC,eAAU;MACT;;GAGH,IAAIA,UAA+B;AAEnC,UAAO,IAAI,SAAiB,gBAAgB,WAAW;IACtD,MAAM,UAAU,WAA4B;AAC3C,YAAO,IAAI,YAAY,qBAAqB,OAAO,CAAC;AACpD,qBAAgB,MAAM,SAAS,GAAG,OAAO,aAAa,KAAK;;AAG5D,YAAQ,GAAG,WAAW,OAAO,CAAC,GAAG,UAAU,OAAO;AAGlD,oBAAgB;AACf,aAAQ,IAAI,WAAW,OAAO,CAAC,IAAI,UAAU,OAAO;;AAGrD,QAAI,GAAG,UAAU,SAAS;AACzB,SAAI;AACH,UAAI,SAAS,EACZ,OAAM,IAAI,MAAM,QAAQ,EAAE,OAAO,MAAM,CAAC;AASzC,sBAJC,KAAK,qBAAqB,WAAmB,SACN,UAAU,OAAO,CAAC,CAG3B;cACvB,GAAG;AAGX,aAAO,IAAI,MAAM,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC;;MAEvC;AAEF,QAAI,GAAG,UAAU,UAAU;AAC1B,YAAO,MAAM;MACZ;KACD,CAAC,cAAc;AAChB,eAAW;KACV;;EAEH,CAAC;;AAGH,MAAM,mBAAmB,OAAU,EAClC,QACA,GAAG,WAC+B;CAClC,IAAIC;AAEJ,KAAI,KAAK,cAAc,eAAe,CACrC,KAAI,SAAS;AAGd,IAAG,MAAM,MAAM,UAAU;AAEzB,KAAI,OAAO,YAAY,WACtB,WAAU,SAAS;AAGpB,KAAI;EACH,MAAM,SAAS,MAAM;EAErB,MAAM,WACL,OAAO,KAAK,aAAa,aACtB,KAAK,SAAS,OAAO,GACrB,KAAK;AACT,KAAG,KAAK,SAAS;UACT,KAAK;AACb,KAAG,KAAM,IAAc,QAAQ;WACtB;AACT,KAAG,MAAM;;AAGV,QAAO;;;;;;;;;;;;AAaR,SAAgB,eAAe,MAAwB;AACtD,KAAI,QAAQ,aAAa,SAAS;EAEjC,MAAM,sBAAsB;AAC5B,SAAO,KACL,KAAK,QACL,IAAI,MAAM,oBAAoB,GAAG,IAAI,IAAI,WAAW,KAAK,KAAK,CAAC,KAAK,IACpE,CACA,KAAK,IAAI;OAEX,QAAO,KACL,KAAK,MAAM;AACX,MAAI,QAAQ,KAAK,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAClC,QAAO,MAAM,EAAE,QAAQ,YAAY,OAAO,GAAG;AAE9C,MAAI,SAAS,KAAK,EAAE,CACnB,QAAO,OAAM,EAAE,QAAQ,eAAe,OAAO,GAAG;AAEjD,SAAO;GACN,CACD,KAAK,IAAI"}

package/dist/cursor.d.mts

@@ -0,0 +1,7 @@
+//#region cursor.d.ts
+declare function showCursor(show: boolean, stream?: NodeJS.WriteStream & {
+  fd: 2;
+}): void;
+//#endregion
+export { showCursor };
+//# sourceMappingURL=cursor.d.mts.map

package/dist/cursor.mjs

@@ -0,0 +1,12 @@
+import process from "node:process";
+
+//#region cursor.ts
+function showCursor(show, stream = process.stderr) {
+	if (!stream.isTTY) return;
+	if (show) stream.write("\x1B[?25h");
+	else stream.write("\x1B[?25l");
+}
+
+//#endregion
+export { showCursor };
+//# sourceMappingURL=cursor.mjs.map

package/dist/cursor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.mjs","names":[],"sources":["../cursor.ts"],"sourcesContent":["import process from \"node:process\";\n\nexport function showCursor(show: boolean, stream = process.stderr) {\n\tif (!stream.isTTY) {\n\t\treturn;\n\t}\n\n\tif (show) {\n\t\tstream.write(\"\\x1b[?25h\");\n\t} else {\n\t\tstream.write(\"\\x1b[?25l\");\n\t}\n}\n"],"mappings":";;;AAEA,SAAgB,WAAW,MAAe,SAAS,QAAQ,QAAQ;AAClE,KAAI,CAAC,OAAO,MACX;AAGD,KAAI,KACH,QAAO,MAAM,YAAY;KAEzB,QAAO,MAAM,YAAY"}

package/dist/error.d.mts

@@ -0,0 +1,11 @@
+//#region error.d.ts
+/**
+ * Error thrown when an operation is cancelled
+ */
+declare class CancelError extends Error {
+  readonly signal?: NodeJS.Signals | undefined;
+  constructor(message?: string, signal?: NodeJS.Signals | undefined);
+}
+//#endregion
+export { CancelError };
+//# sourceMappingURL=error.d.mts.map

package/dist/error.mjs

@@ -0,0 +1,14 @@
+//#region error.ts
+/**
+* Error thrown when an operation is cancelled
+*/
+var CancelError = class extends Error {
+	constructor(message, signal) {
+		super(message);
+		this.signal = signal;
+	}
+};
+
+//#endregion
+export { CancelError };
+//# sourceMappingURL=error.mjs.map

package/dist/error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.mjs","names":["signal?: NodeJS.Signals"],"sources":["../error.ts"],"sourcesContent":["/**\n * Error thrown when an operation is cancelled\n */\nexport class CancelError extends Error {\n\tconstructor(\n\t\tmessage?: string,\n\t\treadonly signal?: NodeJS.Signals\n\t) {\n\t\tsuper(message);\n\t}\n}\n"],"mappings":";;;;AAGA,IAAa,cAAb,cAAiC,MAAM;CACtC,YACC,SACA,AAASA,QACR;AACD,QAAM,QAAQ;EAFL"}

package/dist/gitignore.d.mts

@@ -0,0 +1,24 @@
+//#region gitignore.d.ts
+/**
+ * Appends to a file that follows a .gitignore-like structure any missing
+ * Wrangler-related entries (`.wrangler`, `.dev.vars*`, `.env*`, and their
+ * negated example patterns).
+ *
+ * Creates the file if it does not already exist.
+ *
+ * @param filePath Absolute or relative path to the ignore file to update.
+ */
+declare function maybeAppendWranglerToGitIgnoreLikeFile(filePath: string): void;
+/**
+ * Appends any missing Wrangler-related entries to the project's `.gitignore` file.
+ *
+ * Bails out only when *neither* a `.gitignore` file nor a `.git` directory exists,
+ * which indicates the project is likely not targeting/using git. If either one is
+ * present the entries are appended (creating `.gitignore` if needed).
+ *
+ * @param projectPath Root directory of the project.
+ */
+declare function maybeAppendWranglerToGitIgnore(projectPath: string): void;
+//#endregion
+export { maybeAppendWranglerToGitIgnore, maybeAppendWranglerToGitIgnoreLikeFile };
+//# sourceMappingURL=gitignore.d.mts.map

package/dist/gitignore.mjs

@@ -0,0 +1,75 @@
+import { brandColor, dim } from "./colors.mjs";
+import { spinner } from "./interactive.mjs";
+import { readFileSync } from "@cloudflare/workers-utils";
+import { appendFileSync, existsSync, statSync, writeFileSync } from "node:fs";
+import { basename } from "node:path";
+
+//#region gitignore.ts
+/**
+* Appends to a file that follows a .gitignore-like structure any missing
+* Wrangler-related entries (`.wrangler`, `.dev.vars*`, `.env*`, and their
+* negated example patterns).
+*
+* Creates the file if it does not already exist.
+*
+* @param filePath Absolute or relative path to the ignore file to update.
+*/
+function maybeAppendWranglerToGitIgnoreLikeFile(filePath) {
+	const filePreExisted = existsSync(filePath);
+	if (!filePreExisted) writeFileSync(filePath, "");
+	const existingGitIgnoreContent = readFileSync(filePath);
+	const wranglerGitIgnoreFilesToAdd = [];
+	const hasDotWrangler = existingGitIgnoreContent.match(/^\/?\.wrangler(\/|\s|$)/m);
+	if (!hasDotWrangler) wranglerGitIgnoreFilesToAdd.push(".wrangler");
+	if (!existingGitIgnoreContent.match(/^\/?\.dev\.vars\*(\s|$)/m)) wranglerGitIgnoreFilesToAdd.push(".dev.vars*");
+	if (!existingGitIgnoreContent.match(/^!\/?\.dev\.vars\.example(\s|$)/m)) wranglerGitIgnoreFilesToAdd.push("!.dev.vars.example");
+	if (!existingGitIgnoreContent.match(/^\/?\.env\*?(\..*?)?(\s|$)/m)) wranglerGitIgnoreFilesToAdd.push(".env*");
+	if (!existingGitIgnoreContent.match(/^!\/?\.env\.example(\s|$)/m)) wranglerGitIgnoreFilesToAdd.push("!.env.example");
+	if (wranglerGitIgnoreFilesToAdd.length === 0) return;
+	const s = spinner();
+	s.start(`Adding Wrangler files to the ${basename(filePath)} file`);
+	const linesToAppend = [...filePreExisted ? ["", ...!existingGitIgnoreContent.match(/\n\s*$/) ? [""] : []] : []];
+	if (!hasDotWrangler && wranglerGitIgnoreFilesToAdd.length > 1) linesToAppend.push("# wrangler files");
+	wranglerGitIgnoreFilesToAdd.forEach((line) => linesToAppend.push(line));
+	linesToAppend.push("");
+	appendFileSync(filePath, linesToAppend.join("\n"));
+	const fileName = basename(filePath);
+	s.stop(`${brandColor(filePreExisted ? "updated" : "created")} ${dim(`${fileName} file`)}`);
+}
+/**
+* Appends any missing Wrangler-related entries to the project's `.gitignore` file.
+*
+* Bails out only when *neither* a `.gitignore` file nor a `.git` directory exists,
+* which indicates the project is likely not targeting/using git. If either one is
+* present the entries are appended (creating `.gitignore` if needed).
+*
+* @param projectPath Root directory of the project.
+*/
+function maybeAppendWranglerToGitIgnore(projectPath) {
+	const gitIgnorePath = `${projectPath}/.gitignore`;
+	const gitIgnorePreExisted = existsSync(gitIgnorePath);
+	const gitDirExists = directoryExists(`${projectPath}/.git`);
+	if (!gitIgnorePreExisted && !gitDirExists) return;
+	maybeAppendWranglerToGitIgnoreLikeFile(gitIgnorePath);
+}
+/**
+* Checks whether a directory exists at the given path.
+*
+* Returns `false` when the path does not exist (`ENOENT`). Re-throws any
+* other filesystem error.
+*
+* @param path Path to check
+* @returns `true` if a directory exists at `path`, `false` otherwise
+*/
+function directoryExists(path$1) {
+	try {
+		return statSync(path$1).isDirectory();
+	} catch (error) {
+		if (error.code === "ENOENT") return false;
+		throw new Error(error);
+	}
+}
+
+//#endregion
+export { maybeAppendWranglerToGitIgnore, maybeAppendWranglerToGitIgnoreLikeFile };
+//# sourceMappingURL=gitignore.mjs.map

package/dist/gitignore.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.mjs","names":["wranglerGitIgnoreFilesToAdd: string[]","path"],"sources":["../gitignore.ts"],"sourcesContent":["import { appendFileSync, existsSync, statSync, writeFileSync } from \"node:fs\";\nimport { basename } from \"node:path\";\nimport { readFileSync } from \"@cloudflare/workers-utils\";\nimport { brandColor, dim } from \"./colors\";\nimport { spinner } from \"./interactive\";\n\n/**\n * Appends to a file that follows a .gitignore-like structure any missing\n * Wrangler-related entries (`.wrangler`, `.dev.vars*`, `.env*`, and their\n * negated example patterns).\n *\n * Creates the file if it does not already exist.\n *\n * @param filePath Absolute or relative path to the ignore file to update.\n */\nexport function maybeAppendWranglerToGitIgnoreLikeFile(filePath: string): void {\n\tconst filePreExisted = existsSync(filePath);\n\n\tif (!filePreExisted) {\n\t\twriteFileSync(filePath, \"\");\n\t}\n\n\tconst existingGitIgnoreContent = readFileSync(filePath);\n\tconst wranglerGitIgnoreFilesToAdd: string[] = [];\n\n\tconst hasDotWrangler = existingGitIgnoreContent.match(\n\t\t/^\\/?\\.wrangler(\\/|\\s|$)/m\n\t);\n\tif (!hasDotWrangler) {\n\t\twranglerGitIgnoreFilesToAdd.push(\".wrangler\");\n\t}\n\n\tconst hasDotDevDotVars = existingGitIgnoreContent.match(\n\t\t/^\\/?\\.dev\\.vars\\*(\\s|$)/m\n\t);\n\tif (!hasDotDevDotVars) {\n\t\twranglerGitIgnoreFilesToAdd.push(\".dev.vars*\");\n\t}\n\n\tconst hasDotDevVarsExample = existingGitIgnoreContent.match(\n\t\t/^!\\/?\\.dev\\.vars\\.example(\\s|$)/m\n\t);\n\tif (!hasDotDevVarsExample) {\n\t\twranglerGitIgnoreFilesToAdd.push(\"!.dev.vars.example\");\n\t}\n\n\t/**\n\t * We check for the following type of occurrences:\n\t *\n\t * ```\n\t * .env\n\t * .env*\n\t * .env.<local|production|staging|...>\n\t * .env*.<local|production|staging|...>\n\t * ```\n\t *\n\t * Any of these may alone on a line or be followed by a space and a trailing comment:\n\t *\n\t * ```\n\t * .env.<local|production|staging> # some trailing comment\n\t * ```\n\t */\n\tconst hasDotEnv = existingGitIgnoreContent.match(\n\t\t/^\\/?\\.env\\*?(\\..*?)?(\\s|$)/m\n\t);\n\tif (!hasDotEnv) {\n\t\twranglerGitIgnoreFilesToAdd.push(\".env*\");\n\t}\n\n\tconst hasDotEnvExample = existingGitIgnoreContent.match(\n\t\t/^!\\/?\\.env\\.example(\\s|$)/m\n\t);\n\tif (!hasDotEnvExample) {\n\t\twranglerGitIgnoreFilesToAdd.push(\"!.env.example\");\n\t}\n\n\tif (wranglerGitIgnoreFilesToAdd.length === 0) {\n\t\treturn;\n\t}\n\n\tconst s = spinner();\n\ts.start(`Adding Wrangler files to the ${basename(filePath)} file`);\n\n\tconst linesToAppend = [\n\t\t...(filePreExisted\n\t\t\t? [\"\", ...(!existingGitIgnoreContent.match(/\\n\\s*$/) ? [\"\"] : [])]\n\t\t\t: []),\n\t];\n\n\tif (!hasDotWrangler && wranglerGitIgnoreFilesToAdd.length > 1) {\n\t\tlinesToAppend.push(\"# wrangler files\");\n\t}\n\n\twranglerGitIgnoreFilesToAdd.forEach((line) => linesToAppend.push(line));\n\n\tlinesToAppend.push(\"\");\n\n\tappendFileSync(filePath, linesToAppend.join(\"\\n\"));\n\n\tconst fileName = basename(filePath);\n\n\ts.stop(\n\t\t`${brandColor(filePreExisted ? \"updated\" : \"created\")} ${dim(\n\t\t\t`${fileName} file`\n\t\t)}`\n\t);\n}\n\n/**\n * Appends any missing Wrangler-related entries to the project's `.gitignore` file.\n *\n * Bails out only when *neither* a `.gitignore` file nor a `.git` directory exists,\n * which indicates the project is likely not targeting/using git. If either one is\n * present the entries are appended (creating `.gitignore` if needed).\n *\n * @param projectPath Root directory of the project.\n */\nexport function maybeAppendWranglerToGitIgnore(projectPath: string): void {\n\tconst gitIgnorePath = `${projectPath}/.gitignore`;\n\tconst gitIgnorePreExisted = existsSync(gitIgnorePath);\n\tconst gitDirExists = directoryExists(`${projectPath}/.git`);\n\n\tif (!gitIgnorePreExisted && !gitDirExists) {\n\t\t// if there is no .gitignore file and neither a .git directory\n\t\t// then bail as the project is likely not targeting/using git\n\t\treturn;\n\t}\n\n\tmaybeAppendWranglerToGitIgnoreLikeFile(gitIgnorePath);\n}\n\n/**\n * Checks whether a directory exists at the given path.\n *\n * Returns `false` when the path does not exist (`ENOENT`). Re-throws any\n * other filesystem error.\n *\n * @param path Path to check\n * @returns `true` if a directory exists at `path`, `false` otherwise\n */\nfunction directoryExists(path: string): boolean {\n\ttry {\n\t\tconst stat = statSync(path);\n\t\treturn stat.isDirectory();\n\t} catch (error) {\n\t\tif ((error as { code: string }).code === \"ENOENT\") {\n\t\t\treturn false;\n\t\t}\n\t\tthrow new Error(error as string);\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,SAAgB,uCAAuC,UAAwB;CAC9E,MAAM,iBAAiB,WAAW,SAAS;AAE3C,KAAI,CAAC,eACJ,eAAc,UAAU,GAAG;CAG5B,MAAM,2BAA2B,aAAa,SAAS;CACvD,MAAMA,8BAAwC,EAAE;CAEhD,MAAM,iBAAiB,yBAAyB,MAC/C,2BACA;AACD,KAAI,CAAC,eACJ,6BAA4B,KAAK,YAAY;AAM9C,KAAI,CAHqB,yBAAyB,MACjD,2BACA,CAEA,6BAA4B,KAAK,aAAa;AAM/C,KAAI,CAHyB,yBAAyB,MACrD,mCACA,CAEA,6BAA4B,KAAK,qBAAqB;AAsBvD,KAAI,CAHc,yBAAyB,MAC1C,8BACA,CAEA,6BAA4B,KAAK,QAAQ;AAM1C,KAAI,CAHqB,yBAAyB,MACjD,6BACA,CAEA,6BAA4B,KAAK,gBAAgB;AAGlD,KAAI,4BAA4B,WAAW,EAC1C;CAGD,MAAM,IAAI,SAAS;AACnB,GAAE,MAAM,gCAAgC,SAAS,SAAS,CAAC,OAAO;CAElE,MAAM,gBAAgB,CACrB,GAAI,iBACD,CAAC,IAAI,GAAI,CAAC,yBAAyB,MAAM,SAAS,GAAG,CAAC,GAAG,GAAG,EAAE,CAAE,GAChE,EAAE,CACL;AAED,KAAI,CAAC,kBAAkB,4BAA4B,SAAS,EAC3D,eAAc,KAAK,mBAAmB;AAGvC,6BAA4B,SAAS,SAAS,cAAc,KAAK,KAAK,CAAC;AAEvE,eAAc,KAAK,GAAG;AAEtB,gBAAe,UAAU,cAAc,KAAK,KAAK,CAAC;CAElD,MAAM,WAAW,SAAS,SAAS;AAEnC,GAAE,KACD,GAAG,WAAW,iBAAiB,YAAY,UAAU,CAAC,GAAG,IACxD,GAAG,SAAS,OACZ,GACD;;;;;;;;;;;AAYF,SAAgB,+BAA+B,aAA2B;CACzE,MAAM,gBAAgB,GAAG,YAAY;CACrC,MAAM,sBAAsB,WAAW,cAAc;CACrD,MAAM,eAAe,gBAAgB,GAAG,YAAY,OAAO;AAE3D,KAAI,CAAC,uBAAuB,CAAC,aAG5B;AAGD,wCAAuC,cAAc;;;;;;;;;;;AAYtD,SAAS,gBAAgB,QAAuB;AAC/C,KAAI;AAEH,SADa,SAASC,OAAK,CACf,aAAa;UACjB,OAAO;AACf,MAAK,MAA2B,SAAS,SACxC,QAAO;AAER,QAAM,IAAI,MAAM,MAAgB"}

package/dist/index.d.mts

@@ -0,0 +1,97 @@
+import { checkMacOSVersion } from "./check-macos-version.mjs";
+import { showCursor } from "./cursor.mjs";
+
+//#region index.d.ts
+declare const shapes: {
+  diamond: string;
+  dash: string;
+  radioInactive: string;
+  radioActive: string;
+  backActive: string;
+  backInactive: string;
+  bar: string;
+  leftT: string;
+  rigthT: string;
+  arrows: {
+    left: string;
+    right: string;
+  };
+  corners: {
+    tl: string;
+    bl: string;
+    tr: string;
+    br: string;
+  };
+};
+declare const status: {
+  error: string;
+  warning: string;
+  info: string;
+  success: string;
+  cancel: string;
+};
+declare const space: (n?: number) => string;
+declare const LOGGER_LEVELS: {
+  readonly none: -1;
+  readonly error: 0;
+  readonly warn: 1;
+  readonly info: 2;
+  readonly log: 3;
+  readonly debug: 4;
+};
+type LoggerLevel = keyof typeof LOGGER_LEVELS;
+declare function setLogLevel(level: LoggerLevel): void;
+declare function getLogLevel(): LoggerLevel;
+declare const logRaw: (msg: string) => void;
+declare const log: (msg: string) => void;
+declare const newline: () => void;
+type FormatOptions = {
+  linePrefix?: string;
+  firstLinePrefix?: string;
+  newlineBefore?: boolean;
+  newlineAfter?: boolean;
+  formatLine?: (line: string) => string;
+  multiline?: boolean;
+};
+declare const format: (msg: string, {
+  linePrefix,
+  firstLinePrefix,
+  newlineBefore,
+  newlineAfter,
+  formatLine,
+  multiline
+}?: FormatOptions) => string;
+declare const updateStatus: (msg: string, printNewLine?: boolean) => void;
+declare const startSection: (heading: string, subheading?: string, printNewLine?: boolean) => void;
+declare const endSection: (heading: string, subheading?: string) => void;
+declare const cancel: (msg: string, {
+  shape,
+  multiline
+}?: {
+  shape?: string | undefined;
+  multiline?: boolean | undefined;
+}) => void;
+declare const warn: (msg: string, {
+  shape,
+  multiline,
+  newlineBefore
+}?: {
+  shape?: string | undefined;
+  multiline?: boolean | undefined;
+  newlineBefore?: boolean | undefined;
+}) => void;
+declare const success: (msg: string, {
+  shape,
+  multiline
+}?: {
+  shape?: string | undefined;
+  multiline?: boolean | undefined;
+}) => void;
+declare const stripAnsi: (str: string) => string;
+declare const linkRegex: RegExp;
+declare const hyperlink: (url: string, label?: string) => string;
+declare const crash: (msg?: string, extra?: string) => never;
+declare const error: (msg?: string, extra?: string, corner?: string) => void;
+//#endregion
+export { LoggerLevel, cancel, checkMacOSVersion, crash, endSection, error, format, getLogLevel, hyperlink, linkRegex, log, logRaw, newline, setLogLevel, shapes, showCursor, space, startSection, status, stripAnsi, success, updateStatus, warn };
+//# sourceMappingURL=index.d.mts.map