markform 0.1.0 → 0.1.2

package/dist/shared-N_s1M-_K.mjs

@@ -0,0 +1,176 @@
+import YAML from "yaml";
+import { relative } from "node:path";
+import pc from "picocolors";
+import { mkdir } from "node:fs/promises";
+
+//#region src/cli/lib/naming.ts
+/**
+* Naming convention utilities for JSON/YAML output.
+*
+* Converts between camelCase (TypeScript internal) and snake_case (JSON/YAML output).
+*/
+/**
+* Convert a camelCase string to snake_case.
+*
+* @example
+* toSnakeCase("fieldCount") // "field_count"
+* toSnakeCase("parentFieldId") // "parent_field_id"
+* toSnakeCase("already_snake") // "already_snake"
+*/
+function toSnakeCase(str) {
+	return str.replace(/([A-Z])/g, "_$1").toLowerCase();
+}
+/**
+* Recursively convert all object keys from camelCase to snake_case.
+*
+* Handles nested objects and arrays. Primitives are returned unchanged.
+*/
+function convertKeysToSnakeCase(obj) {
+	if (obj === null || obj === void 0) return obj;
+	if (Array.isArray(obj)) return obj.map(convertKeysToSnakeCase);
+	if (typeof obj === "object") {
+		const result = {};
+		for (const [key, value] of Object.entries(obj)) {
+			const snakeKey = toSnakeCase(key);
+			result[snakeKey] = convertKeysToSnakeCase(value);
+		}
+		return result;
+	}
+	return obj;
+}
+
+//#endregion
+//#region src/cli/lib/shared.ts
+/**
+* Valid format options for Commander choice validation.
+*/
+const OUTPUT_FORMATS = [
+	"console",
+	"plaintext",
+	"yaml",
+	"json",
+	"markform",
+	"markdown"
+];
+/**
+* Extract command context from Commander options.
+*/
+function getCommandContext(command) {
+	const opts = command.optsWithGlobals();
+	return {
+		dryRun: opts.dryRun ?? false,
+		verbose: opts.verbose ?? false,
+		quiet: opts.quiet ?? false,
+		format: opts.format ?? "console",
+		formsDir: opts.formsDir
+	};
+}
+/**
+* Check if output should use colors.
+* Returns true for console format when stdout is a TTY.
+*/
+function shouldUseColors(ctx) {
+	if (ctx.format === "plaintext" || ctx.format === "yaml" || ctx.format === "json") return false;
+	return process.stdout.isTTY && !process.env.NO_COLOR;
+}
+/**
+* Format structured data according to output format.
+*
+* JSON and YAML outputs are converted to snake_case keys for consistency.
+*/
+function formatOutput(ctx, data, consoleFormatter) {
+	switch (ctx.format) {
+		case "json": return JSON.stringify(convertKeysToSnakeCase(data), null, 2);
+		case "yaml": return YAML.stringify(convertKeysToSnakeCase(data));
+		case "plaintext":
+		case "console":
+		default:
+			if (consoleFormatter) return consoleFormatter(data, shouldUseColors(ctx));
+			return YAML.stringify(convertKeysToSnakeCase(data));
+	}
+}
+/**
+* Log a dry-run message.
+*/
+function logDryRun(message, details) {
+	console.log(pc.yellow(`[DRY RUN] ${message}`));
+	if (details) console.log(pc.dim(JSON.stringify(details, null, 2)));
+}
+/**
+* Log a verbose message (only shown if --verbose is set).
+*/
+function logVerbose(ctx, message) {
+	if (ctx.verbose) console.log(pc.dim(message));
+}
+/**
+* Log an info message (hidden if --quiet is set).
+*/
+function logInfo(ctx, message) {
+	if (!ctx.quiet) console.log(message);
+}
+/**
+* Log an error message (always shown).
+*/
+function logError(message) {
+	console.error(pc.red(`Error: ${message}`));
+}
+/**
+* Log a success message (hidden if --quiet is set).
+*/
+function logSuccess(ctx, message) {
+	if (!ctx.quiet) console.log(pc.green(message));
+}
+/**
+* Log a timing message (hidden if --quiet is set).
+*/
+function logTiming(ctx, label, durationMs) {
+	if (!ctx.quiet) {
+		const seconds = (durationMs / 1e3).toFixed(1);
+		console.log(pc.cyan(`⏰ ${label}: ${seconds}s`));
+	}
+}
+/**
+* Log a warning message (hidden if --quiet is set).
+*/
+function logWarn(ctx, message) {
+	if (!ctx.quiet) console.log(pc.yellow(`⚠️  ${message}`));
+}
+/**
+* Format a file path for display: relative to cwd, colored green.
+* If the path is within the cwd, shows as relative (e.g., "./simple-filled1.form.md")
+* If outside cwd, shows the absolute path.
+*/
+function formatPath(absolutePath, cwd = process.cwd()) {
+	const relativePath = relative(cwd, absolutePath);
+	const displayPath = relativePath.startsWith("..") ? absolutePath : `./${relativePath}`;
+	return pc.green(displayPath);
+}
+/**
+* Read a file and return its contents.
+*/
+async function readFile$1(filePath) {
+	const { readFile: fsReadFile } = await import("node:fs/promises");
+	return fsReadFile(filePath, "utf-8");
+}
+/**
+* Write contents to a file atomically.
+*
+* Uses the atomically library to prevent partial or corrupted files
+* if the process crashes mid-write.
+*/
+async function writeFile(filePath, contents) {
+	const { writeFile: atomicWriteFile } = await import("atomically");
+	await atomicWriteFile(filePath, contents);
+}
+/**
+* Ensure the forms directory exists, creating it if necessary.
+* Uses recursive mkdir so parent directories are created as needed.
+*
+* @param formsDir Absolute path to the forms directory
+*/
+async function ensureFormsDir(formsDir) {
+	await mkdir(formsDir, { recursive: true });
+}
+
+//#endregion
+export { getCommandContext as a, logInfo as c, logVerbose as d, logWarn as f, writeFile as h, formatPath as i, logSuccess as l, shouldUseColors as m, ensureFormsDir as n, logDryRun as o, readFile$1 as p, formatOutput as r, logError as s, OUTPUT_FORMATS as t, logTiming as u };