padrone 1.8.2 → 2.0.0

package/dist/codegen/types.d.mts

@@ -0,0 +1,144 @@
+//#region src/codegen/types.d.ts
+/**
+ * Metadata for a single field/option/flag parsed from CLI help or completion data.
+ */
+interface FieldMeta {
+  name: string;
+  type: 'string' | 'number' | 'boolean' | 'array' | 'enum' | 'unknown';
+  /** For arrays: the item type */
+  items?: string;
+  /** For enums: the allowed values */
+  enumValues?: string[];
+  description?: string;
+  default?: unknown;
+  required?: boolean;
+  aliases?: string[];
+  positional?: boolean;
+  /** Mark fields the parser wasn't confident about */
+  ambiguous?: boolean;
+}
+/**
+ * Intermediate representation for a CLI command.
+ * All parsers produce these, all generators consume them.
+ */
+interface CommandMeta {
+  name: string;
+  description?: string;
+  aliases?: string[];
+  /** Named options/flags */
+  arguments?: FieldMeta[];
+  /** Positional arguments */
+  positionals?: FieldMeta[];
+  /** Recursive subcommands */
+  subcommands?: CommandMeta[];
+  examples?: string[];
+  deprecated?: boolean | string;
+}
+/**
+ * Logger interface for generators to report progress.
+ */
+interface GeneratorLogger {
+  info(message: string): void;
+  warn(message: string): void;
+  error(message: string): void;
+  success(message: string): void;
+}
+/**
+ * Shared context passed to all generators.
+ */
+interface GeneratorContext {
+  /** Target output directory */
+  outDir: string;
+  /** Code builder factory */
+  createCodeBuilder: () => CodeBuilder;
+  /** File emitter for writing output */
+  emitter: FileEmitter;
+  /** Template engine */
+  template: TemplateFunction;
+  /** User-facing logger */
+  log: GeneratorLogger;
+}
+/**
+ * Result from CodeBuilder.build()
+ */
+interface CodeBuildResult {
+  /** The formatted source string */
+  text: string;
+  /** Resolved import map for deduplication across files */
+  imports: Map<string, {
+    specifiers: Set<string>;
+    typeOnly: boolean;
+  }>;
+}
+/**
+ * Fluent builder for constructing TypeScript source files.
+ */
+interface CodeBuilder {
+  /** Add a named import: import { specifier } from source */
+  import(specifier: string | string[], source: string): CodeBuilder;
+  /** Add a default import: import name from source */
+  importDefault(name: string, source: string): CodeBuilder;
+  /** Add a type-only import: import type { specifier } from source */
+  importType(specifier: string | string[], source: string): CodeBuilder;
+  /** Add a line of code (empty string or no argument for blank line) */
+  line(code?: string): CodeBuilder;
+  /** Add a nested block with automatic indentation */
+  block(builder: (b: CodeBuilder) => CodeBuilder): CodeBuilder;
+  /** Add a nested block with open/close strings */
+  block(open: string, builder: (b: CodeBuilder) => CodeBuilder, close?: string): CodeBuilder;
+  /** Add a nested block with open string, close string override, and builder */
+  block(open: string, close: string, builder: (b: CodeBuilder) => CodeBuilder): CodeBuilder;
+  /** Add a single-line comment */
+  comment(text: string): CodeBuilder;
+  /** Add a JSDoc comment */
+  docComment(text: string): CodeBuilder;
+  /** Add a TODO comment */
+  todoComment(text: string): CodeBuilder;
+  /** Add raw pre-formatted code (no indentation adjustment) */
+  raw(code: string): CodeBuilder;
+  /** Build the final source string */
+  build(): CodeBuildResult;
+}
+/**
+ * Result from FileEmitter.emit()
+ */
+interface EmitResult {
+  /** Files that were written */
+  written: string[];
+  /** Files that were skipped (already exist, no overwrite) */
+  skipped: string[];
+  /** Files that failed to write */
+  errors: {
+    file: string;
+    error: Error;
+  }[];
+}
+/**
+ * Options for creating a FileEmitter.
+ */
+interface FileEmitterOptions {
+  /** Target output directory */
+  outDir: string;
+  /** Header comment prepended to every file */
+  header?: string;
+  /** How to handle existing files: true = overwrite, false = skip */
+  overwrite?: boolean;
+  /** Print what would be written without writing */
+  dryRun?: boolean;
+}
+/**
+ * Manages writing multiple generated files to disk.
+ */
+interface FileEmitter {
+  /** Queue a file for writing */
+  addFile(path: string, content: string | CodeBuildResult): void;
+  /** Write all queued files to disk */
+  emit(): Promise<EmitResult>;
+}
+/**
+ * Template function returned by template().
+ */
+type TemplateFunction = (text: string) => (data: Record<string, unknown>) => string;
+//#endregion
+export { CodeBuildResult, CodeBuilder, CommandMeta, EmitResult, FieldMeta, FileEmitter, FileEmitterOptions, GeneratorContext, GeneratorLogger, TemplateFunction };
+//# sourceMappingURL=types.d.mts.map

package/dist/codegen/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/codegen/types.ts"],"mappings":";;AAGA;;UAAiB,SAAA;EACf,IAAA;EACA,IAAA;EAAA;EAEA,KAAA;EAEA;EAAA,UAAA;EACA,WAAA;EACA,OAAA;EACA,QAAA;EACA,OAAA;EACA,UAAA;EAES;EAAT,SAAA;AAAA;;;;;UAOe,WAAA;EACf,IAAA;EACA,WAAA;EACA,OAAA;EADA;EAGA,SAAA,GAAY,SAAA;EAAZ;EAEA,WAAA,GAAc,SAAA;EAAd;EAEA,WAAA,GAAc,WAAA;EACd,QAAA;EACA,UAAA;AAAA;;;AAAU;UAMK,eAAA;EACf,IAAA,CAAK,OAAA;EACL,IAAA,CAAK,OAAA;EACL,KAAA,CAAM,OAAA;EACN,OAAA,CAAQ,OAAA;AAAA;;;;UAMO,gBAAA;EANf;EAQA,MAAA;EARuB;EAUvB,iBAAA,QAAyB,WAAA;EAJV;EAMf,OAAA,EAAS,WAAA;;EAET,QAAA,EAAU,gBAAA;EAFD;EAIT,GAAA,EAAK,eAAA;AAAA;;;;UAMU,eAAA;EAZU;EAczB,IAAA;EAZS;EAcT,OAAA,EAAS,GAAG;IAAW,UAAA,EAAY,GAAA;IAAa,QAAA;EAAA;AAAA;AAV5B;AAMtB;;AANsB,UAgBL,WAAA;EANH;EAQZ,MAAA,CAAO,SAAA,qBAA8B,MAAA,WAAiB,WAAA;EARtD;EAUA,aAAA,CAAc,IAAA,UAAc,MAAA,WAAiB,WAAA;EAVtB;EAYvB,UAAA,CAAW,SAAA,qBAA8B,MAAA,WAAiB,WAAA;EAZV;EAchD,IAAA,CAAK,IAAA,YAAgB,WAAA;EAdmC;EAgBxD,KAAA,CAAM,OAAA,GAAU,CAAA,EAAG,WAAA,KAAgB,WAAA,GAAc,WAAA;EAVvB;EAY1B,KAAA,CAAM,IAAA,UAAc,OAAA,GAAU,CAAA,EAAG,WAAA,KAAgB,WAAA,EAAa,KAAA,YAAiB,WAAA;EAVzB;EAYtD,KAAA,CAAM,IAAA,UAAc,KAAA,UAAe,OAAA,GAAU,CAAA,EAAG,WAAA,KAAgB,WAAA,GAAc,WAAA;EARpB;EAU1D,OAAA,CAAQ,IAAA,WAAe,WAAA;EANJ;EAQnB,UAAA,CAAW,IAAA,WAAe,WAAA;EARuB;EAUjD,WAAA,CAAY,IAAA,WAAe,WAAA;EARsB;EAUjD,GAAA,CAAI,IAAA,WAAe,WAAA;EAR6B;EAUhD,KAAA,IAAS,eAAA;AAAA;;;;UAMM,UAAA;EANN;EAQT,OAAA;EARwB;EAUxB,OAAA;EAhCO;EAkCP,MAAA;IAAU,IAAA;IAAc,KAAA,EAAO,KAAK;EAAA;AAAA;;;;UAMrB,kBAAA;EApC2C;EAsC1D,MAAA;EApCK;EAsCL,MAAA;EApCA;EAsCA,SAAA;EAtCgB;EAwChB,MAAA;AAAA;;;;UAMe,WAAA;EA5Ce;EA8C9B,OAAA,CAAQ,IAAA,UAAc,OAAA,WAAkB,eAAA;EA9CpB;EAgDpB,IAAA,IAAQ,OAAA,CAAQ,UAAA;AAAA;;;;KAMN,gBAAA,IAAoB,IAAA,cAAkB,IAAA,EAAM,MAAM"}

package/dist/completion.d.mts

@@ -0,0 +1,2 @@
+import { WithCompletion, padroneCompletion } from "./extension/completion.mjs";
+export { type WithCompletion, padroneCompletion };

package/dist/completion.mjs

@@ -0,0 +1,2 @@
+import { padroneCompletion } from "./extension/completion.mjs";
+export { padroneCompletion };

package/dist/core/args.d.mts

@@ -0,0 +1,3 @@
+import { PadroneArgsSchemaMeta, PadroneFieldMeta, SingleChar, StdinConfig } from "../types/args-meta.mjs";
+import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
+export type { PadroneFieldMeta };

package/dist/{args-DrCXxXeP.mjs → core/args.mjs}

@@ -1,81 +1,5 @@
-import { n as asyncStreamRegistry } from "./stream-DC4H8YTx.mjs";
-//#region src/util/shell-utils.ts
-/**
-* Convert a camelCase string to kebab-case.
-* Returns null if the string has no uppercase letters (no conversion needed).
-*/
-function camelToKebab(str) {
-	if (!/[A-Z]/.test(str)) return null;
-	return str.replace(/[A-Z]/g, (ch) => `-${ch.toLowerCase()}`);
-}
-/**
-* Detects the current shell from environment variables and process info.
-* @returns The detected shell type, or undefined if unknown
-*/
-async function detectShell() {
-	if (typeof process === "undefined") return void 0;
-	const shellEnv = process.env.SHELL || "";
-	if (shellEnv.includes("zsh")) return "zsh";
-	if (shellEnv.includes("bash")) return "bash";
-	if (shellEnv.includes("fish")) return "fish";
-	if (process.env.PSModulePath || process.env.POWERSHELL_DISTRIBUTION_CHANNEL) return "powershell";
-	try {
-		const ppid = process.ppid;
-		if (ppid) {
-			const { execSync } = await import("node:child_process");
-			const processName = execSync(`ps -p ${ppid} -o comm=`, {
-				encoding: "utf-8",
-				stdio: [
-					"pipe",
-					"pipe",
-					"ignore"
-				]
-			}).trim();
-			if (processName.includes("zsh")) return "zsh";
-			if (processName.includes("bash")) return "bash";
-			if (processName.includes("fish")) return "fish";
-		}
-	} catch {}
-}
-async function getRcFile(shell, home) {
-	const { homedir } = await import("node:os");
-	const { join } = await import("node:path");
-	const h = home ?? homedir();
-	switch (shell) {
-		case "bash": return join(h, ".bashrc");
-		case "zsh": return join(h, ".zshrc");
-		case "fish": return join(h, ".config", "fish", "config.fish");
-		case "powershell": return (typeof process !== "undefined" ? process.env.PROFILE : void 0) || join(h, "Documents", "PowerShell", "Microsoft.PowerShell_profile.ps1");
-		default: return null;
-	}
-}
-function escapeRegExp(str) {
-	return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-/**
-* Writes a snippet to a shell config file using begin/end markers for idempotency.
-* If a block with the same begin marker exists, it is replaced. Otherwise the snippet is appended.
-*/
-async function writeToRcFile(rcFile, snippet, beginMarker, endMarker) {
-	const { existsSync, mkdirSync, readFileSync, writeFileSync } = await import("node:fs");
-	const { dirname } = await import("node:path");
-	const existing = existsSync(rcFile) ? readFileSync(rcFile, "utf-8") : "";
-	if (existing.includes(beginMarker)) {
-		const pattern = new RegExp(`${escapeRegExp(beginMarker)}[\\s\\S]*?${escapeRegExp(endMarker)}`);
-		writeFileSync(rcFile, existing.replace(pattern, snippet));
-		return {
-			file: rcFile,
-			updated: true
-		};
-	}
-	mkdirSync(dirname(rcFile), { recursive: true });
-	writeFileSync(rcFile, `${existing}${existing.length > 0 && !existing.endsWith("\n") ? "\n" : ""}\n${snippet}\n`);
-	return {
-		file: rcFile,
-		updated: false
-	};
-}
-//#endregion
+import { camelToKebab } from "../util/shell-utils.mjs";
+import { asyncStreamRegistry } from "../util/stream.mjs";
 //#region src/core/args.ts
 /** Extract the JSON schema from a Standard Schema, returning it as a plain record. */
 function getJsonSchema(schema) {
@@ -200,9 +124,44 @@ function preprocessArgs(data, ctx) {
 	return result;
 }
 /**
+* Walk a JSON schema fragment and collect the set of allowed primitive types,
+* descending into `anyOf` / `oneOf` (used for unions). For variants whose type
+* is `array`, item types are collected separately into `itemTypes`.
+*/
+function collectAllowedTypes(prop, types, itemTypes) {
+	if (!prop) return;
+	if (prop.type !== void 0) {
+		const list = Array.isArray(prop.type) ? prop.type : [prop.type];
+		for (const t of list) if (typeof t === "string") types.add(t);
+		if (list.includes("array") && prop.items) collectAllowedTypes(prop.items, itemTypes, /* @__PURE__ */ new Set());
+	}
+	const variants = prop.anyOf ?? prop.oneOf;
+	if (Array.isArray(variants)) for (const variant of variants) collectAllowedTypes(variant, types, itemTypes);
+}
+/** Coerce a single CLI string to a primitive based on the set of allowed types. */
+function coerceScalar(value, allowedTypes) {
+	if (typeof value !== "string") return value;
+	if (allowedTypes.has("boolean")) {
+		const lower = value.toLowerCase();
+		if (lower === "true" || lower === "1" || lower === "yes" || lower === "on") return true;
+		if (lower === "false" || lower === "0" || lower === "no" || lower === "off") return false;
+	}
+	if (allowedTypes.has("number") || allowedTypes.has("integer")) {
+		const trimmed = value.trim();
+		if (trimmed !== "") {
+			const num = Number(trimmed);
+			if (!Number.isNaN(num)) return num;
+		}
+	}
+	return value;
+}
+/**
 * Auto-coerce CLI string values to match the expected schema types.
 * Handles: string → number, string → boolean for primitive schema fields.
 * Arrays of primitives are also coerced element-wise.
+* Union types (`anyOf` / `oneOf`) are coerced to the most specific matching
+* primitive — e.g. `--test true` for `z.union([z.boolean(), z.string()])`
+* becomes the boolean `true` rather than the string "true".
 */
 function coerceArgs(data, schema) {
 	let properties;
@@ -217,38 +176,15 @@ function coerceArgs(data, schema) {
 	for (const [key, value] of Object.entries(result)) {
 		const prop = properties[key];
 		if (!prop) continue;
-		const targetType = prop.type;
-		if (targetType === "number" || targetType === "integer") {
-			if (typeof value === "string") {
-				const num = Number(value);
-				if (!Number.isNaN(num)) result[key] = num;
-			}
-		} else if (targetType === "boolean") {
-			if (typeof value === "string") {
-				const lower = value.toLowerCase();
-				if (lower === "true" || lower === "1" || lower === "yes" || lower === "on") result[key] = true;
-				else if (lower === "false" || lower === "0" || lower === "no" || lower === "off") result[key] = false;
-			}
-		} else if (targetType === "array") {
-			const arr = Array.isArray(value) ? value : [value];
-			const itemType = prop.items?.type;
-			if (itemType === "number" || itemType === "integer") result[key] = arr.map((v) => {
-				if (typeof v === "string") {
-					const num = Number(v);
-					return Number.isNaN(num) ? v : num;
-				}
-				return v;
-			});
-			else if (itemType === "boolean") result[key] = arr.map((v) => {
-				if (typeof v === "string") {
-					const lower = v.toLowerCase();
-					if (lower === "true" || lower === "1" || lower === "yes" || lower === "on") return true;
-					if (lower === "false" || lower === "0" || lower === "no" || lower === "off") return false;
-				}
-				return v;
-			});
-			else if (!Array.isArray(value)) result[key] = arr;
-		}
+		const types = /* @__PURE__ */ new Set();
+		const itemTypes = /* @__PURE__ */ new Set();
+		collectAllowedTypes(prop, types, itemTypes);
+		const isArrayValue = Array.isArray(value);
+		const allowsArray = types.has("array");
+		const allowsScalar = types.has("string") || types.has("boolean") || types.has("number") || types.has("integer");
+		if (isArrayValue && allowsArray) result[key] = value.map((v) => coerceScalar(v, itemTypes));
+		else if (!isArrayValue && allowsArray && !allowsScalar) result[key] = [coerceScalar(value, itemTypes)];
+		else if (!isArrayValue) result[key] = coerceScalar(value, types);
 	}
 	return result;
 }
@@ -269,7 +205,7 @@ function detectUnknownArgs(data, schema, flags, aliases, negatives) {
 		return [];
 	}
 	if (isLoose) return [];
-	const knownKeys = new Set([
+	const knownKeys = /* @__PURE__ */ new Set([
 		...Object.keys(properties),
 		...Object.keys(flags),
 		...Object.values(flags),
@@ -283,6 +219,6 @@ function detectUnknownArgs(data, schema, flags, aliases, negatives) {
 	return unknowns;
 }
 //#endregion
-export { getJsonSchema as a, parsePositionalConfig as c, detectShell as d, escapeRegExp as f, extractSchemaMetadata as i, preprocessArgs as l, writeToRcFile as m, coerceArgs as n, isArrayField as o, getRcFile as p, detectUnknownArgs as r, isAsyncStreamField as s, applyValues as t, camelToKebab as u };
+export { applyValues, coerceArgs, detectUnknownArgs, extractSchemaMetadata, getJsonSchema, isArrayField, isAsyncStreamField, parsePositionalConfig, preprocessArgs };
 
-//# sourceMappingURL=args-DrCXxXeP.mjs.map
+//# sourceMappingURL=args.mjs.map

package/dist/core/args.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.mjs","names":[],"sources":["../../src/core/args.ts"],"sourcesContent":["import type { StandardJSONSchemaV1, StandardSchemaV1 } from '@standard-schema/spec';\nimport type { PadroneFieldMeta } from '../types/args-meta.ts';\nimport { camelToKebab } from '../util/shell-utils.ts';\nimport { asyncStreamRegistry } from '../util/stream.ts';\n\nexport type { PadroneArgsSchemaMeta, PadroneFieldMeta, SingleChar, StdinConfig } from '../types/args-meta.ts';\n\n/** Extract the JSON schema from a Standard Schema, returning it as a plain record. */\nexport function getJsonSchema(schema: StandardJSONSchemaV1): Record<string, any> {\n  return schema['~standard'].jsonSchema.input({\n    target: 'draft-2020-12',\n    libraryOptions: { unrepresentable: 'any' },\n  }) as Record<string, any>;\n}\n\nfunction getFieldJsonSchema(schema: StandardJSONSchemaV1 | undefined, field: string): Record<string, any> | undefined {\n  if (!schema) return undefined;\n  try {\n    const jsonSchema = getJsonSchema(schema);\n    if (jsonSchema.type === 'object' && jsonSchema.properties) return jsonSchema.properties[field];\n  } catch {}\n  return undefined;\n}\n\n/**\n * Checks if a field in the schema is an array type (e.g. `z.string().array()`).\n */\nexport function isArrayField(schema: StandardJSONSchemaV1 | undefined, field: string): boolean {\n  return getFieldJsonSchema(schema, field)?.type === 'array';\n}\n\n/**\n * Checks if a field is an async stream (marked with `asyncStream()` metadata).\n * Returns the item schema if provided, or `true` if it's a plain string stream.\n */\nexport function isAsyncStreamField(schema: StandardJSONSchemaV1 | undefined, field: string): { itemSchema?: StandardSchemaV1 } | false {\n  const prop = getFieldJsonSchema(schema, field);\n  const asyncStreamId = prop?.asyncStream;\n  if (asyncStreamId && asyncStreamRegistry.has(asyncStreamId)) {\n    const meta = asyncStreamRegistry.get(asyncStreamId);\n    return { itemSchema: meta?.itemSchema };\n  }\n\n  return false;\n}\n\n/**\n * Parse positional configuration to extract names and variadic info.\n */\nexport function parsePositionalConfig(positional: readonly string[]): { name: string; variadic: boolean }[] {\n  return positional.map((p) => {\n    const variadic = p.startsWith('...');\n    const name = variadic ? p.slice(3) : p;\n    return { name, variadic };\n  });\n}\n\n/**\n * Result type for extractSchemaMetadata function.\n */\ninterface SchemaMetadataResult {\n  /** Single-char flags: maps flag char → full arg name (e.g. `{ v: 'verbose' }`) */\n  flags: Record<string, string>;\n  /** Multi-char aliases: maps alias → full arg name (e.g. `{ 'dry-run': 'dryRun' }`) */\n  aliases: Record<string, string>;\n  /** Negative keywords: maps keyword → target arg name (e.g. `{ remote: 'local' }`) */\n  negatives: Record<string, string>;\n  /** Args that have custom negation set (even if empty), disabling the `--no-` prefix */\n  customNegation: Set<string>;\n}\n\nfunction addEntries(target: Record<string, string>, key: string, items: string | readonly string[], filter?: (item: string) => boolean) {\n  const list = typeof items === 'string' ? [items] : items;\n  for (const item of list) {\n    if (typeof item === 'string' && item && item !== key && !(item in target) && (!filter || filter(item))) {\n      target[item] = key;\n    }\n  }\n}\n\n/**\n * Extract all arg metadata from schema and meta in a single pass.\n * Returns flags (single-char, stackable) and aliases (multi-char, long names) separately.\n * When `autoAlias` is true (default), camelCase property names automatically get kebab-case aliases.\n */\nexport function extractSchemaMetadata(\n  schema: StandardJSONSchemaV1,\n  meta?: Record<string, PadroneFieldMeta | undefined>,\n  autoAlias?: boolean,\n): SchemaMetadataResult {\n  const flags: Record<string, string> = {};\n  const aliases: Record<string, string> = {};\n  const negatives: Record<string, string> = {};\n  const customNegation = new Set<string>();\n\n  // Extract from meta object\n  if (meta) {\n    for (const [key, value] of Object.entries(meta)) {\n      if (!value) continue;\n\n      if (value.flags) {\n        addEntries(flags, key, value.flags, (item) => item.length === 1);\n      }\n      if (value.alias) {\n        addEntries(aliases, key, value.alias, (item) => item.length > 1);\n      }\n      if (value.negative !== undefined) {\n        customNegation.add(key);\n        addEntries(negatives, key, value.negative);\n      }\n    }\n  }\n\n  // Extract from JSON schema properties\n  try {\n    const jsonSchema = getJsonSchema(schema) as Record<string, any>;\n    if (jsonSchema.type === 'object' && jsonSchema.properties) {\n      for (const [propertyName, propertySchema] of Object.entries(jsonSchema.properties as Record<string, any>)) {\n        if (!propertySchema) continue;\n\n        // Extract flags from schema `.meta({ flags: ... })`\n        const propFlags = propertySchema.flags;\n        if (propFlags) {\n          addEntries(flags, propertyName, propFlags, (item) => item.length === 1);\n        }\n\n        // Extract aliases from schema `.meta({ alias: ... })`\n        const propAlias = propertySchema.alias;\n        if (propAlias) {\n          const list = typeof propAlias === 'string' ? [propAlias] : propAlias;\n          if (Array.isArray(list)) {\n            addEntries(aliases, propertyName, list, (item) => item.length > 1);\n          }\n        }\n\n        // Extract negative keywords from schema `.meta({ negative: ... })`\n        const propNegative = propertySchema.negative;\n        if (propNegative !== undefined && !customNegation.has(propertyName)) {\n          customNegation.add(propertyName);\n          const list = typeof propNegative === 'string' ? [propNegative] : propNegative;\n          if (Array.isArray(list)) {\n            addEntries(negatives, propertyName, list);\n          }\n        }\n\n        // Auto-generate kebab-case alias for camelCase property names\n        if (autoAlias !== false) {\n          const kebab = camelToKebab(propertyName);\n          if (kebab && !(kebab in aliases)) {\n            aliases[kebab] = propertyName;\n          }\n        }\n      }\n    }\n  } catch {\n    // Ignore errors from JSON schema generation\n  }\n\n  return { flags, aliases, negatives, customNegation };\n}\n\nfunction preprocessMappings(data: Record<string, unknown>, mappings: Record<string, string>): Record<string, unknown> {\n  const result = { ...data };\n\n  for (const [mappedKey, fullArgName] of Object.entries(mappings)) {\n    if (mappedKey in data && mappedKey !== fullArgName) {\n      const mappedValue = data[mappedKey];\n      // Prefer full arg name if it exists\n      if (!(fullArgName in result)) result[fullArgName] = mappedValue;\n      delete result[mappedKey];\n    }\n  }\n\n  return result;\n}\n\n/**\n * Apply values to arguments using \"set if not present\" semantics.\n * Existing values take precedence — only fills in undefined or missing keys.\n */\nexport function applyValues(data: Record<string, unknown>, values: Record<string, unknown>): Record<string, unknown> {\n  const result = { ...data };\n\n  for (const [key, value] of Object.entries(values)) {\n    if (key in result && result[key] !== undefined) continue;\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/** Applies flag and alias mappings to raw arguments. */\nexport function preprocessArgs(\n  data: Record<string, unknown>,\n  ctx: { flags?: Record<string, string>; aliases?: Record<string, string> },\n): Record<string, unknown> {\n  let result = { ...data };\n\n  if (ctx.flags && Object.keys(ctx.flags).length > 0) {\n    result = preprocessMappings(result, ctx.flags);\n  }\n  if (ctx.aliases && Object.keys(ctx.aliases).length > 0) {\n    result = preprocessMappings(result, ctx.aliases);\n  }\n\n  return result;\n}\n\n/**\n * Walk a JSON schema fragment and collect the set of allowed primitive types,\n * descending into `anyOf` / `oneOf` (used for unions). For variants whose type\n * is `array`, item types are collected separately into `itemTypes`.\n */\nfunction collectAllowedTypes(prop: Record<string, any> | undefined, types: Set<string>, itemTypes: Set<string>): void {\n  if (!prop) return;\n\n  if (prop.type !== undefined) {\n    const list = Array.isArray(prop.type) ? prop.type : [prop.type];\n    for (const t of list) {\n      if (typeof t === 'string') types.add(t);\n    }\n    if (list.includes('array') && prop.items) {\n      collectAllowedTypes(prop.items, itemTypes, new Set());\n    }\n  }\n\n  const variants = prop.anyOf ?? prop.oneOf;\n  if (Array.isArray(variants)) {\n    for (const variant of variants) collectAllowedTypes(variant, types, itemTypes);\n  }\n}\n\n/** Coerce a single CLI string to a primitive based on the set of allowed types. */\nfunction coerceScalar(value: unknown, allowedTypes: Set<string>): unknown {\n  if (typeof value !== 'string') return value;\n\n  if (allowedTypes.has('boolean')) {\n    const lower = value.toLowerCase();\n    if (lower === 'true' || lower === '1' || lower === 'yes' || lower === 'on') return true;\n    if (lower === 'false' || lower === '0' || lower === 'no' || lower === 'off') return false;\n  }\n\n  if (allowedTypes.has('number') || allowedTypes.has('integer')) {\n    const trimmed = value.trim();\n    if (trimmed !== '') {\n      const num = Number(trimmed);\n      if (!Number.isNaN(num)) return num;\n    }\n  }\n\n  return value;\n}\n\n/**\n * Auto-coerce CLI string values to match the expected schema types.\n * Handles: string → number, string → boolean for primitive schema fields.\n * Arrays of primitives are also coerced element-wise.\n * Union types (`anyOf` / `oneOf`) are coerced to the most specific matching\n * primitive — e.g. `--test true` for `z.union([z.boolean(), z.string()])`\n * becomes the boolean `true` rather than the string \"true\".\n */\nexport function coerceArgs(data: Record<string, unknown>, schema: StandardJSONSchemaV1): Record<string, unknown> {\n  let properties: Record<string, any>;\n  try {\n    const jsonSchema = getJsonSchema(schema) as Record<string, any>;\n    if (jsonSchema.type !== 'object' || !jsonSchema.properties) return data;\n    properties = jsonSchema.properties;\n  } catch {\n    return data;\n  }\n\n  const result = { ...data };\n\n  for (const [key, value] of Object.entries(result)) {\n    const prop = properties[key];\n    if (!prop) continue;\n\n    const types = new Set<string>();\n    const itemTypes = new Set<string>();\n    collectAllowedTypes(prop, types, itemTypes);\n\n    const isArrayValue = Array.isArray(value);\n    const allowsArray = types.has('array');\n    const allowsScalar = types.has('string') || types.has('boolean') || types.has('number') || types.has('integer');\n\n    if (isArrayValue && allowsArray) {\n      result[key] = value.map((v) => coerceScalar(v, itemTypes));\n    } else if (!isArrayValue && allowsArray && !allowsScalar) {\n      // Wrap single value into an array when only array shapes are allowed\n      result[key] = [coerceScalar(value, itemTypes)];\n    } else if (!isArrayValue) {\n      result[key] = coerceScalar(value, types);\n    }\n  }\n\n  return result;\n}\n\n/**\n * Detect unknown keys in the args that don't match any schema property.\n * Returns an array of { key } for each unknown key.\n * Framework-reserved keys (--config, -c) are always allowed.\n */\nexport function detectUnknownArgs(\n  data: Record<string, unknown>,\n  schema: StandardJSONSchemaV1,\n  flags: Record<string, string>,\n  aliases: Record<string, string>,\n  negatives?: Record<string, string>,\n): { key: string }[] {\n  let properties: Record<string, any>;\n  let isLoose = false;\n  try {\n    const jsonSchema = getJsonSchema(schema) as Record<string, any>;\n    if (jsonSchema.type !== 'object' || !jsonSchema.properties) return [];\n    properties = jsonSchema.properties;\n    // If additionalProperties is set (true, {}, or a schema), the schema allows extra keys\n    if (jsonSchema.additionalProperties !== undefined && jsonSchema.additionalProperties !== false) isLoose = true;\n  } catch {\n    return [];\n  }\n\n  if (isLoose) return [];\n\n  const knownKeys = new Set<string>([\n    ...Object.keys(properties),\n    ...Object.keys(flags),\n    ...Object.values(flags),\n    ...Object.keys(aliases),\n    ...Object.values(aliases),\n    ...(negatives ? Object.keys(negatives) : []),\n    ...(negatives ? Object.values(negatives) : []),\n  ]);\n  const unknowns: { key: string }[] = [];\n\n  for (const key of Object.keys(data)) {\n    if (!knownKeys.has(key)) {\n      unknowns.push({ key });\n    }\n  }\n\n  return unknowns;\n}\n"],"mappings":"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"}

package/dist/core/commands.d.mts

@@ -0,0 +1,13 @@
+import { AnyPadroneCommand } from "../types/command.mjs";
+//#region src/core/commands.d.ts
+/**
+ * Builds a completer function for the REPL from the command tree.
+ * Completes command names, subcommand names, option names (--foo), and aliases (-f).
+ * Also includes dot-prefixed built-in REPL commands (.exit, .clear, .scope, .help, .history).
+ */
+declare function buildReplCompleter(rootCommand: AnyPadroneCommand, builtins: {
+  inScope?: boolean;
+}): (line: string) => [string[], string];
+//#endregion
+export { buildReplCompleter };
+//# sourceMappingURL=commands.d.mts.map

package/dist/core/commands.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.mts","names":[],"sources":["../../src/core/commands.ts"],"mappings":";;;;;;;iBAmIgB,kBAAA,CACd,WAAA,EAAa,iBAAiB,EAC9B,QAAA;EACE,OAAA;AAAA,KAEA,IAAA"}

package/dist/{commands-DLR0rFgq.mjs → core/commands.mjs}

@@ -1,234 +1,6 @@
-import { a as getJsonSchema, i as extractSchemaMetadata } from "./args-DrCXxXeP.mjs";
-import { a as readStreamAsText } from "./stream-DC4H8YTx.mjs";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
-//#region src/core/runtime.ts
-/**
-* Sentinel value returned by the terminal REPL session when Ctrl+C is pressed.
-* Distinguished from empty string (user pressed enter) and null (EOF/Ctrl+D).
-*/
-const REPL_SIGINT = Symbol("REPL_SIGINT");
-//#endregion
-//#region src/core/default-runtime.ts
-/**
-* Default terminal prompt implementation powered by Enquirer.
-* Lazily imported to avoid loading Enquirer when not needed.
-*/
-async function defaultTerminalPrompt(config) {
-	const Enquirer = (await import("enquirer")).default;
-	const question = {
-		type: config.type,
-		name: config.name,
-		message: config.message
-	};
-	if (config.default !== void 0) question.initial = config.default;
-	if (config.choices) question.choices = config.choices.map((c) => ({
-		name: String(c.value),
-		message: c.label
-	}));
-	return (await Enquirer.prompt(question))[config.name];
-}
-function createTerminalReplSession(config) {
-	let history = config.history ? [...config.history] : [];
-	let currentCompleter = config.completer;
-	return {
-		set completer(fn) {
-			currentCompleter = fn;
-		},
-		async question(prompt) {
-			const { createInterface } = await import("node:readline");
-			const opts = {
-				input: process.stdin,
-				output: process.stdout,
-				terminal: true,
-				history: [...history],
-				historySize: Math.max(history.length, 1e3)
-			};
-			if (currentCompleter) opts.completer = currentCompleter;
-			const rl = createInterface(opts);
-			return new Promise((resolve) => {
-				let resolved = false;
-				const settle = (value) => {
-					if (resolved) return;
-					resolved = true;
-					rl.close();
-					resolve(value);
-				};
-				rl.question(prompt, (answer) => {
-					if (Array.isArray(rl.history)) history = [...rl.history];
-					settle(answer);
-				});
-				rl.once("SIGINT", () => {
-					process.stdout.write("\n");
-					settle(REPL_SIGINT);
-				});
-				rl.once("close", () => {
-					process.stdout.write("\n");
-					settle(null);
-				});
-			});
-		},
-		close() {}
-	};
-}
-/**
-* Auto-detect interactive mode when not explicitly set.
-* Returns 'disabled' in CI environments or non-TTY contexts, 'supported' otherwise.
-*/
-function detectInteractiveMode() {
-	if (typeof process === "undefined") return "disabled";
-	if (process.env.CI || process.env.CONTINUOUS_INTEGRATION) return "disabled";
-	if (!process.stdout?.isTTY) return "disabled";
-	return "supported";
-}
-/**
-* Creates a default stdin reader from `process.stdin`.
-* Only created when a command actually declares a `stdin` meta field.
-*/
-function createDefaultStdin() {
-	return {
-		get isTTY() {
-			if (typeof process === "undefined") return true;
-			return process.stdin?.isTTY === true;
-		},
-		async text() {
-			if (typeof process === "undefined") return "";
-			return readStreamAsText(process.stdin);
-		},
-		async *lines() {
-			if (typeof process === "undefined") return;
-			const { createInterface } = await import("node:readline");
-			const rl = createInterface({ input: process.stdin });
-			try {
-				for await (const line of rl) yield line;
-			} finally {
-				rl.close();
-			}
-		}
-	};
-}
-/**
-* Default signal listener that wires to `process.on(signal)`.
-* Returns an unsubscribe function that removes all listeners.
-*/
-function defaultOnSignal(callback) {
-	if (typeof process === "undefined") return () => {};
-	const signals = [
-		"SIGINT",
-		"SIGTERM",
-		"SIGHUP"
-	];
-	const handlers = /* @__PURE__ */ new Map();
-	for (const sig of signals) {
-		const handler = () => callback(sig);
-		handlers.set(sig, handler);
-		process.on(sig, handler);
-	}
-	return () => {
-		for (const [sig, handler] of handlers) process.removeListener(sig, handler);
-	};
-}
-/**
-* Creates the default Node.js/Bun runtime.
-*/
-function defaultExit(code) {
-	if (typeof process !== "undefined") process.exit(code);
-	throw new Error(`Exit with code ${code}`);
-}
-function getTerminalInfo() {
-	if (typeof process === "undefined") return void 0;
-	return {
-		get columns() {
-			return process.stdout?.columns;
-		},
-		get isTTY() {
-			return process.stdout?.isTTY === true;
-		}
-	};
-}
-function createDefaultRuntime() {
-	return {
-		output: (...args) => console.log(...args),
-		error: (text) => console.error(text),
-		argv: () => typeof process !== "undefined" ? process.argv.slice(2) : [],
-		env: () => typeof process !== "undefined" ? process.env : {},
-		format: "auto",
-		prompt: defaultTerminalPrompt,
-		interactive: detectInteractiveMode(),
-		onSignal: defaultOnSignal,
-		terminal: getTerminalInfo(),
-		exit: defaultExit
-	};
-}
-/**
-* Returns the stdin abstraction: custom runtime stdin > default process.stdin.
-* Returns `undefined` when no custom stdin is provided and process.stdin is not piped.
-*/
-function resolveStdin(partial) {
-	if (partial?.stdin) return partial.stdin;
-	const defaultStdin = createDefaultStdin();
-	if (defaultStdin.isTTY) return void 0;
-	return defaultStdin;
-}
-/**
-* Like `resolveStdin`, but always returns a stdin source even when it's a TTY.
-* Used for async streams which support interactive (non-piped) input.
-*/
-function resolveStdinAlways(partial) {
-	if (partial?.stdin) return partial.stdin;
-	return createDefaultStdin();
-}
-/**
-* Merges a partial runtime with the default runtime.
-*/
-function resolveRuntime(partial) {
-	const defaults = createDefaultRuntime();
-	if (!partial) return defaults;
-	return {
-		output: partial.output ?? defaults.output,
-		error: partial.error ?? defaults.error,
-		argv: partial.argv ?? defaults.argv,
-		env: partial.env ?? defaults.env,
-		format: partial.format ?? defaults.format,
-		interactive: partial.interactive ?? defaults.interactive,
-		prompt: partial.prompt ?? defaults.prompt,
-		readLine: partial.readLine ?? defaults.readLine,
-		stdin: partial.stdin,
-		theme: partial.theme,
-		onSignal: partial.onSignal ?? defaults.onSignal,
-		terminal: partial.terminal ?? defaults.terminal,
-		exit: partial.exit ?? defaults.exit
-	};
-}
-//#endregion
+import { extractSchemaMetadata, getJsonSchema } from "./args.mjs";
+import { resolveRuntime } from "./default-runtime.mjs";
 //#region src/core/commands.ts
-var commands_exports = /* @__PURE__ */ __exportAll({
-	buildInputSchema: () => buildInputSchema,
-	buildReplCompleter: () => buildReplCompleter,
-	collectEndpoints: () => collectEndpoints,
-	commandSymbol: () => commandSymbol,
-	configKeys: () => configKeys,
-	findCommandByName: () => findCommandByName,
-	getCommand: () => getCommand,
-	getCommandRuntime: () => getCommandRuntime,
-	lazyResolver: () => lazyResolver,
-	mergeCommands: () => mergeCommands,
-	repathCommandTree: () => repathCommandTree,
-	resolveAllCommands: () => resolveAllCommands,
-	resolveCommand: () => resolveCommand,
-	serializeArgsToFlags: () => serializeArgsToFlags,
-	suggestSimilar: () => suggestSimilar
-});
 const lazyResolver = Symbol("lazyResolver");
 /** Resolves a lazy command in place by calling its stored resolver. No-op if already resolved. */
 function resolveCommand(cmd) {
@@ -509,6 +281,6 @@ function serializeArgsToFlags(args) {
 	return parts;
 }
 //#endregion
-export { resolveStdin as _, commands_exports as a, getCommandRuntime as c, repathCommandTree as d, resolveAllCommands as f, createTerminalReplSession as g, suggestSimilar as h, commandSymbol as i, lazyResolver as l, serializeArgsToFlags as m, buildReplCompleter as n, findCommandByName as o, resolveCommand as p, collectEndpoints as r, getCommand as s, buildInputSchema as t, mergeCommands as u, resolveStdinAlways as v, REPL_SIGINT as y };
+export { buildInputSchema, buildReplCompleter, collectEndpoints, commandSymbol, configKeys, findCommandByName, getCommand, getCommandRuntime, lazyResolver, mergeCommands, repathCommandTree, resolveAllCommands, resolveCommand, serializeArgsToFlags, suggestSimilar };
 
-//# sourceMappingURL=commands-DLR0rFgq.mjs.map
+//# sourceMappingURL=commands.mjs.map