padrone 1.4.0 → 1.6.0

package/dist/args-Cnq0nwSM.mjs

@@ -0,0 +1,272 @@
+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
+//#region src/core/args.ts
+/** Extract the JSON schema from a Standard Schema, returning it as a plain record. */
+function getJsonSchema(schema) {
+	return schema["~standard"].jsonSchema.input({
+		target: "draft-2020-12",
+		libraryOptions: { unrepresentable: "any" }
+	});
+}
+function getFieldJsonSchema(schema, field) {
+	if (!schema) return void 0;
+	try {
+		const jsonSchema = getJsonSchema(schema);
+		if (jsonSchema.type === "object" && jsonSchema.properties) return jsonSchema.properties[field];
+	} catch {}
+}
+/**
+* Checks if a field in the schema is an array type (e.g. `z.string().array()`).
+*/
+function isArrayField(schema, field) {
+	return getFieldJsonSchema(schema, field)?.type === "array";
+}
+/**
+* Checks if a field is an async stream (marked with `asyncStream()` metadata).
+* Returns the item schema if provided, or `true` if it's a plain string stream.
+*/
+function isAsyncStreamField(schema, field) {
+	const asyncStreamId = getFieldJsonSchema(schema, field)?.asyncStream;
+	if (asyncStreamId && asyncStreamRegistry.has(asyncStreamId)) return { itemSchema: asyncStreamRegistry.get(asyncStreamId)?.itemSchema };
+	return false;
+}
+/**
+* Parse positional configuration to extract names and variadic info.
+*/
+function parsePositionalConfig(positional) {
+	return positional.map((p) => {
+		const variadic = p.startsWith("...");
+		return {
+			name: variadic ? p.slice(3) : p,
+			variadic
+		};
+	});
+}
+function addEntries(target, key, items, filter) {
+	const list = typeof items === "string" ? [items] : items;
+	for (const item of list) if (typeof item === "string" && item && item !== key && !(item in target) && (!filter || filter(item))) target[item] = key;
+}
+/**
+* Extract all arg metadata from schema and meta in a single pass.
+* Returns flags (single-char, stackable) and aliases (multi-char, long names) separately.
+* When `autoAlias` is true (default), camelCase property names automatically get kebab-case aliases.
+*/
+function extractSchemaMetadata(schema, meta, autoAlias) {
+	const flags = {};
+	const aliases = {};
+	if (meta) for (const [key, value] of Object.entries(meta)) {
+		if (!value) continue;
+		if (value.flags) addEntries(flags, key, value.flags, (item) => item.length === 1);
+		if (value.alias) addEntries(aliases, key, value.alias, (item) => item.length > 1);
+	}
+	try {
+		const jsonSchema = getJsonSchema(schema);
+		if (jsonSchema.type === "object" && jsonSchema.properties) for (const [propertyName, propertySchema] of Object.entries(jsonSchema.properties)) {
+			if (!propertySchema) continue;
+			const propFlags = propertySchema.flags;
+			if (propFlags) addEntries(flags, propertyName, propFlags, (item) => item.length === 1);
+			const propAlias = propertySchema.alias;
+			if (propAlias) {
+				const list = typeof propAlias === "string" ? [propAlias] : propAlias;
+				if (Array.isArray(list)) addEntries(aliases, propertyName, list, (item) => item.length > 1);
+			}
+			if (autoAlias !== false) {
+				const kebab = camelToKebab(propertyName);
+				if (kebab && !(kebab in aliases)) aliases[kebab] = propertyName;
+			}
+		}
+	} catch {}
+	return {
+		flags,
+		aliases
+	};
+}
+function preprocessMappings(data, mappings) {
+	const result = { ...data };
+	for (const [mappedKey, fullArgName] of Object.entries(mappings)) if (mappedKey in data && mappedKey !== fullArgName) {
+		const mappedValue = data[mappedKey];
+		if (!(fullArgName in result)) result[fullArgName] = mappedValue;
+		delete result[mappedKey];
+	}
+	return result;
+}
+/**
+* Apply values to arguments using "set if not present" semantics.
+* Existing values take precedence — only fills in undefined or missing keys.
+*/
+function applyValues(data, values) {
+	const result = { ...data };
+	for (const [key, value] of Object.entries(values)) {
+		if (key in result && result[key] !== void 0) continue;
+		if (value !== void 0) result[key] = value;
+	}
+	return result;
+}
+/** Applies flag and alias mappings to raw arguments. */
+function preprocessArgs(data, ctx) {
+	let result = { ...data };
+	if (ctx.flags && Object.keys(ctx.flags).length > 0) result = preprocessMappings(result, ctx.flags);
+	if (ctx.aliases && Object.keys(ctx.aliases).length > 0) result = preprocessMappings(result, ctx.aliases);
+	return result;
+}
+/**
+* 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.
+*/
+function coerceArgs(data, schema) {
+	let properties;
+	try {
+		const jsonSchema = getJsonSchema(schema);
+		if (jsonSchema.type !== "object" || !jsonSchema.properties) return data;
+		properties = jsonSchema.properties;
+	} catch {
+		return data;
+	}
+	const result = { ...data };
+	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;
+		}
+	}
+	return result;
+}
+/**
+* Detect unknown keys in the args that don't match any schema property.
+* Returns an array of { key } for each unknown key.
+* Framework-reserved keys (--config, -c) are always allowed.
+*/
+function detectUnknownArgs(data, schema, flags, aliases) {
+	let properties;
+	let isLoose = false;
+	try {
+		const jsonSchema = getJsonSchema(schema);
+		if (jsonSchema.type !== "object" || !jsonSchema.properties) return [];
+		properties = jsonSchema.properties;
+		if (jsonSchema.additionalProperties !== void 0 && jsonSchema.additionalProperties !== false) isLoose = true;
+	} catch {
+		return [];
+	}
+	if (isLoose) return [];
+	const knownKeys = new Set([
+		...Object.keys(properties),
+		...Object.keys(flags),
+		...Object.values(flags),
+		...Object.keys(aliases),
+		...Object.values(aliases)
+	]);
+	const unknowns = [];
+	for (const key of Object.keys(data)) if (!knownKeys.has(key)) unknowns.push({ key });
+	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 };
+
+//# sourceMappingURL=args-Cnq0nwSM.mjs.map

package/dist/args-Cnq0nwSM.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"args-Cnq0nwSM.mjs","names":[],"sources":["../src/util/shell-utils.ts","../src/core/args.ts"],"sourcesContent":["/**\n * Convert a camelCase string to kebab-case.\n * Returns null if the string has no uppercase letters (no conversion needed).\n */\nexport function camelToKebab(str: string): string | null {\n  if (!/[A-Z]/.test(str)) return null;\n  return str.replace(/[A-Z]/g, (ch) => `-${ch.toLowerCase()}`);\n}\n\nexport type ShellType = 'bash' | 'zsh' | 'fish' | 'powershell';\n\n/**\n * Detects the current shell from environment variables and process info.\n * @returns The detected shell type, or undefined if unknown\n */\nexport async function detectShell(): Promise<ShellType | undefined> {\n  if (typeof process === 'undefined') return undefined;\n\n  // Method 1: Check SHELL environment variable (most common)\n  const shellEnv = process.env.SHELL || '';\n  if (shellEnv.includes('zsh')) return 'zsh';\n  if (shellEnv.includes('bash')) return 'bash';\n  if (shellEnv.includes('fish')) return 'fish';\n\n  // Method 2: Check Windows-specific shells\n  if (process.env.PSModulePath || process.env.POWERSHELL_DISTRIBUTION_CHANNEL) {\n    return 'powershell';\n  }\n\n  // Method 3: Check parent process on Unix-like systems\n  try {\n    const ppid = process.ppid;\n    if (ppid) {\n      const { execSync } = (await import('node:child_process')) as typeof import('node:child_process');\n      const processName = execSync(`ps -p ${ppid} -o comm=`, {\n        encoding: 'utf-8',\n        stdio: ['pipe', 'pipe', 'ignore'],\n      }).trim();\n\n      if (processName.includes('zsh')) return 'zsh';\n      if (processName.includes('bash')) return 'bash';\n      if (processName.includes('fish')) return 'fish';\n    }\n  } catch {\n    // Ignore errors (e.g., ps not available)\n  }\n\n  return undefined;\n}\n\nexport async function getRcFile(shell: ShellType, home?: string): Promise<string | null> {\n  const { homedir } = await import('node:os');\n  const { join } = await import('node:path');\n  const h = home ?? homedir();\n  switch (shell) {\n    case 'bash':\n      return join(h, '.bashrc');\n    case 'zsh':\n      return join(h, '.zshrc');\n    case 'fish':\n      return join(h, '.config', 'fish', 'config.fish');\n    case 'powershell':\n      return (\n        (typeof process !== 'undefined' ? process.env.PROFILE : undefined) ||\n        join(h, 'Documents', 'PowerShell', 'Microsoft.PowerShell_profile.ps1')\n      );\n    default:\n      return null;\n  }\n}\n\nexport function escapeRegExp(str: string): string {\n  return str.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/**\n * Writes a snippet to a shell config file using begin/end markers for idempotency.\n * If a block with the same begin marker exists, it is replaced. Otherwise the snippet is appended.\n */\nexport async function writeToRcFile(\n  rcFile: string,\n  snippet: string,\n  beginMarker: string,\n  endMarker: string,\n): Promise<{ file: string; updated: boolean }> {\n  const { existsSync, mkdirSync, readFileSync, writeFileSync } = await import('node:fs');\n  const { dirname } = await import('node:path');\n  const existing = existsSync(rcFile) ? readFileSync(rcFile, 'utf-8') : '';\n\n  if (existing.includes(beginMarker)) {\n    const pattern = new RegExp(`${escapeRegExp(beginMarker)}[\\\\s\\\\S]*?${escapeRegExp(endMarker)}`);\n    writeFileSync(rcFile, existing.replace(pattern, snippet));\n    return { file: rcFile, updated: true };\n  }\n\n  mkdirSync(dirname(rcFile), { recursive: true });\n  const separator = existing.length > 0 && !existing.endsWith('\\n') ? '\\n' : '';\n  writeFileSync(rcFile, `${existing}${separator}\\n${snippet}\\n`);\n  return { file: rcFile, updated: false };\n}\n","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}\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\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    }\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        // 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 };\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 * 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 */\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 targetType = prop.type as string | undefined;\n\n    if (targetType === 'number' || targetType === 'integer') {\n      if (typeof value === 'string') {\n        const num = Number(value);\n        if (!Number.isNaN(num)) result[key] = num;\n      }\n    } else if (targetType === 'boolean') {\n      if (typeof value === 'string') {\n        const lower = value.toLowerCase();\n        if (lower === 'true' || lower === '1' || lower === 'yes' || lower === 'on') result[key] = true;\n        else if (lower === 'false' || lower === '0' || lower === 'no' || lower === 'off') result[key] = false;\n      }\n    } else if (targetType === 'array') {\n      // Coerce single items to array\n      const arr = Array.isArray(value) ? value : [value];\n      const itemType = prop.items?.type as string | undefined;\n      if (itemType === 'number' || itemType === 'integer') {\n        result[key] = arr.map((v) => {\n          if (typeof v === 'string') {\n            const num = Number(v);\n            return Number.isNaN(num) ? v : num;\n          }\n          return v;\n        });\n      } else if (itemType === 'boolean') {\n        result[key] = arr.map((v) => {\n          if (typeof v === 'string') {\n            const lower = v.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          return v;\n        });\n      } else if (!Array.isArray(value)) {\n        result[key] = arr;\n      }\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): { 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  ]);\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/codegen/index.d.mts

@@ -149,11 +149,15 @@ type TemplateFunction = (text: string) => (data: Record<string, unknown>) => str
 declare function createCodeBuilder(): CodeBuilder;
 //#endregion
 //#region src/codegen/discovery.d.ts
-type DiscoverySource = 'help' | 'fish' | 'zsh';
+type DiscoverySource = 'help' | 'completion' | 'bash' | 'fish' | 'zsh';
 interface DiscoveryOptions {
   /** The command to discover (e.g. 'gh', 'docker', 'kubectl'). */
   command: string;
-  /** Which parsing sources to use. Default: ['help'] */
+  /**
+   * Which parsing sources to use. Default: ['help'].
+   * Use `'completion'` to auto-detect the best shell completion source
+   * by probing `<cmd> completion <shell>` (bash → fish → zsh).
+   */
   sources?: DiscoverySource[];
   /** Max subcommand depth. 0 = root only, undefined = unlimited. */
   depth?: number;
@@ -177,6 +181,12 @@ interface DiscoveryResult {
  * parsing shell completion scripts.
  */
 declare function discoverCli(options: DiscoveryOptions): Promise<DiscoveryResult>;
+/**
+ * Detect the best shell for completion parsing by probing the command.
+ * Tries `<cmd> completion <shell>` for bash, fish, zsh (in that order).
+ * Returns the shell name if successful, or null if no completion command exists.
+ */
+declare function detectCompletionShell(command: string, timeout?: number): Promise<'bash' | 'fish' | 'zsh' | null>;
 //#endregion
 //#region src/codegen/file-emitter.d.ts
 /**
@@ -224,6 +234,21 @@ interface CommandTreeOptions {
  */
 declare function generateCommandTree(root: CommandMeta, ctx: GeneratorContext, options?: CommandTreeOptions): void;
 //#endregion
+//#region src/codegen/parsers/bash.d.ts
+/**
+ * Parse bash completion scripts into CommandMeta.
+ *
+ * Bash completions typically use `complete -F <func> <command>` and define
+ * a function that sets COMPREPLY. Common patterns:
+ *
+ *   local commands="init build deploy"
+ *   local args="--verbose --output --format"
+ *   case "$prev" in --format) COMPREPLY=($(compgen -W "json yaml toml" ...)) ;;
+ *   COMPREPLY=($(compgen -W "$commands" ...))
+ *   COMPREPLY=($(compgen -W "$args" ...))
+ */
+declare function parseBashCompletions(text: string): CommandMeta;
+//#endregion
 //#region src/codegen/parsers/fish.d.ts
 /**
  * Parse fish shell completion scripts into CommandMeta.
@@ -301,5 +326,5 @@ type TemplateRenderer = (data: Record<string, unknown>, partials?: Record<string
  */
 declare function template(text: string): TemplateRenderer;
 //#endregion
-export { type CodeBuildResult, type CodeBuilder, type CommandFileOptions, type CommandMeta, type CommandTreeOptions, type DiscoveryOptions, type DiscoveryResult, type DiscoverySource, type EmitResult, type FieldMeta, type FileEmitter, type FileEmitterOptions, type GeneratorContext, type GeneratorLogger, type TemplateFunction, createCodeBuilder, createFileEmitter, discoverCli, fieldMetaToCode, generateBarrelFile, generateCommandFile, generateCommandTree, mergeCommandMeta, parseFishCompletions, parseHelpOutput, parseZshCompletions, schemaToCode, template };
+export { type CodeBuildResult, type CodeBuilder, type CommandFileOptions, type CommandMeta, type CommandTreeOptions, type DiscoveryOptions, type DiscoveryResult, type DiscoverySource, type EmitResult, type FieldMeta, type FileEmitter, type FileEmitterOptions, type GeneratorContext, type GeneratorLogger, type TemplateFunction, createCodeBuilder, createFileEmitter, detectCompletionShell, discoverCli, fieldMetaToCode, generateBarrelFile, generateCommandFile, generateCommandTree, mergeCommandMeta, parseBashCompletions, parseFishCompletions, parseHelpOutput, parseZshCompletions, schemaToCode, template };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/codegen/types.ts","../../src/codegen/code-builder.ts","../../src/codegen/discovery.ts","../../src/codegen/file-emitter.ts","../../src/codegen/generators/barrel-file.ts","../../src/codegen/generators/command-file.ts","../../src/codegen/generators/command-tree.ts","../../src/codegen/parsers/fish.ts","../../src/codegen/parsers/help.ts","../../src/codegen/parsers/merge.ts","../../src/codegen/parsers/zsh.ts","../../src/codegen/schema-to-code.ts","../../src/codegen/template.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/codegen/types.ts","../../src/codegen/code-builder.ts","../../src/codegen/discovery.ts","../../src/codegen/file-emitter.ts","../../src/codegen/generators/barrel-file.ts","../../src/codegen/generators/command-file.ts","../../src/codegen/generators/command-tree.ts","../../src/codegen/parsers/bash.ts","../../src/codegen/parsers/fish.ts","../../src/codegen/parsers/help.ts","../../src/codegen/parsers/merge.ts","../../src/codegen/parsers/zsh.ts","../../src/codegen/schema-to-code.ts","../../src/codegen/template.ts"],"mappings":"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"}

package/dist/codegen/index.mjs

@@ -1,3 +1,6 @@
+import { a as getJsonSchema } from "../args-Cnq0nwSM.mjs";
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
 import { existsSync, mkdirSync, writeFileSync } from "node:fs";
 import { dirname, join, resolve } from "node:path";
 //#region src/codegen/code-builder.ts
@@ -182,6 +185,115 @@ function createCodeBuilder() {
 	return new CodeBuilderImpl();
 }
 //#endregion
+//#region src/codegen/parsers/bash.ts
+/**
+* Parse bash completion scripts into CommandMeta.
+*
+* Bash completions typically use `complete -F <func> <command>` and define
+* a function that sets COMPREPLY. Common patterns:
+*
+*   local commands="init build deploy"
+*   local args="--verbose --output --format"
+*   case "$prev" in --format) COMPREPLY=($(compgen -W "json yaml toml" ...)) ;;
+*   COMPREPLY=($(compgen -W "$commands" ...))
+*   COMPREPLY=($(compgen -W "$args" ...))
+*/
+function parseBashCompletions(text) {
+	const result = {
+		name: "",
+		arguments: [],
+		subcommands: []
+	};
+	const completeMatch = text.match(/complete\s+(?:[^-]|-[^F])*-F\s+\S+\s+(\S+)/);
+	if (completeMatch) result.name = completeMatch[1];
+	if (!result.name) {
+		const markerMatch = text.match(/###-begin-(\S+)-completion-###/);
+		if (markerMatch) result.name = markerMatch[1];
+	}
+	const joined = text.replace(/\\\n\s*/g, " ");
+	const variables = extractVariables(joined);
+	const commandWords = variables.get("commands") ?? variables.get("cmds") ?? variables.get("subcommands");
+	if (commandWords) for (const name of splitWords(commandWords)) result.subcommands.push({ name });
+	const argWords = variables.get("args") ?? variables.get("opts") ?? variables.get("options") ?? variables.get("flags");
+	const optionNames = /* @__PURE__ */ new Set();
+	if (argWords) {
+		for (const word of splitWords(argWords)) if (word.startsWith("-")) optionNames.add(word);
+	}
+	const compgenRegex = /compgen\s+-W\s+["']([^"']+)["']/g;
+	let compgenMatch;
+	while ((compgenMatch = compgenRegex.exec(joined)) !== null) {
+		if (compgenMatch[1].startsWith("$")) continue;
+		for (const word of splitWords(compgenMatch[1])) if (word.startsWith("-")) optionNames.add(word);
+	}
+	const enumMap = parseCaseStatement(joined);
+	const seenArgs = /* @__PURE__ */ new Set();
+	for (const rawName of optionNames) {
+		if (rawName === "--help" || rawName === "-h" || rawName === "--version" || rawName === "-V") continue;
+		const name = rawName.replace(/^-+/, "").replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+		if (!name || seenArgs.has(name)) continue;
+		seenArgs.add(name);
+		const enumValues = enumMap.get(rawName);
+		const isShort = rawName.startsWith("-") && !rawName.startsWith("--") && rawName.length === 2;
+		const field = {
+			name,
+			type: enumValues ? "enum" : "string",
+			enumValues,
+			ambiguous: !enumValues
+		};
+		if (isShort) field.aliases = [rawName];
+		result.arguments.push(field);
+	}
+	if (result.arguments.length === 0) delete result.arguments;
+	if (result.subcommands.length === 0) delete result.subcommands;
+	return result;
+}
+/**
+* Extract variable assignments: `local VAR="value"`, `VAR="value"`, `local VAR='value'`
+*/
+function extractVariables(text) {
+	const vars = /* @__PURE__ */ new Map();
+	const regex = /(?:local\s+)?(\w+)=["']([^"']+)["']/g;
+	let match;
+	while ((match = regex.exec(text)) !== null) vars.set(match[1], match[2]);
+	return vars;
+}
+/**
+* Parse case statements to find option → enum value mappings.
+*
+* Matches patterns like:
+*   case "$prev" in
+*     --format) COMPREPLY=($(compgen -W "json yaml toml" ...)) ;;
+*     --env|--environment) COMPREPLY=($(compgen -W "dev staging prod" ...)) ;;
+*/
+function parseCaseStatement(text) {
+	const result = /* @__PURE__ */ new Map();
+	const caseRegex = /case\s+[^i]*\bin\b\s*([\s\S]*?)esac/g;
+	let caseMatch;
+	while ((caseMatch = caseRegex.exec(text)) !== null) {
+		const branches = caseMatch[1].split(";;");
+		for (const branch of branches) {
+			const patternMatch = branch.match(/^\s*([-\w|]+)\)/);
+			if (!patternMatch) continue;
+			const compgenMatch = branch.match(/compgen\s+-W\s+["']([^"']+)["']/);
+			if (!compgenMatch) continue;
+			const values = compgenMatch[1];
+			const words = splitWords(values).filter((w) => !w.startsWith("$"));
+			if (words.length === 0) continue;
+			for (const pattern of patternMatch[1].split("|")) {
+				const trimmed = pattern.trim();
+				if (trimmed.startsWith("-")) result.set(trimmed, words);
+			}
+		}
+	}
+	return result;
+}
+/**
+* Split a space-separated word list, filtering empty strings.
+*/
+function splitWords(text) {
+	return text.split(/\s+/).filter(Boolean);
+}
+//#endregion
 //#region src/codegen/parsers/fish.ts
 /**
 * Parse fish shell completion scripts into CommandMeta.
@@ -792,7 +904,8 @@ function findSubcommands(text) {
 * parsing shell completion scripts.
 */
 async function discoverCli(options) {
-	const { command, sources = ["help"], depth, delay = 50, log, timeout = 1e4 } = options;
+	const { command, sources: rawSources = ["help"], depth, delay = 50, log, timeout = 1e4 } = options;
+	const sources = await resolveSources(rawSources, command, timeout, log);
 	const warnings = [];
 	let invocations = 0;
 	const results = [];
@@ -812,6 +925,12 @@ async function discoverCli(options) {
 		});
 		results.push(helpResult);
 	}
+	if (sources.includes("bash")) {
+		log?.info(`Parsing bash completions for ${command}...`);
+		const bashText = await getCompletionScript(command, "bash", timeout);
+		if (bashText) results.push(parseBashCompletions(bashText));
+		else warnings.push("Could not obtain bash completion script");
+	}
 	if (sources.includes("fish")) {
 		log?.info(`Parsing fish completions for ${command}...`);
 		const fishText = await getCompletionScript(command, "fish", timeout);
@@ -875,20 +994,17 @@ async function runHelp(command, args, timeout) {
 */
 async function runCommand(command, args, timeout) {
 	try {
-		const proc = Bun.spawn([command, ...args], {
-			stdout: "pipe",
-			stderr: "pipe",
-			stdin: "ignore"
+		const { stdout, stderr } = await new Promise((resolve) => {
+			execFile(command, args, {
+				timeout,
+				maxBuffer: 10 * 1024 * 1024
+			}, (_error, stdout, stderr) => {
+				resolve({
+					stdout: (stdout ?? "").trim(),
+					stderr: (stderr ?? "").trim()
+				});
+			});
 		});
-		const timer = setTimeout(() => proc.kill(), timeout);
-		const [_exitCode, stdoutBuf, stderrBuf] = await Promise.all([
-			proc.exited,
-			new Response(proc.stdout).arrayBuffer(),
-			new Response(proc.stderr).arrayBuffer()
-		]);
-		clearTimeout(timer);
-		const stdout = new TextDecoder().decode(stdoutBuf).trim();
-		const stderr = new TextDecoder().decode(stderrBuf).trim();
 		const combined = stdout || stderr;
 		if (!combined) return null;
 		if (combined.length < 10) return null;
@@ -906,13 +1022,47 @@ async function getCompletionScript(command, shell, timeout) {
 	if (result) return result;
 	result = await runCommand(command, ["completions", shell], timeout);
 	if (result) return result;
-	const paths = shell === "fish" ? [`/usr/share/fish/vendor_completions.d/${command}.fish`, `/usr/local/share/fish/vendor_completions.d/${command}.fish`] : [`/usr/share/zsh/site-functions/_${command}`, `/usr/local/share/zsh/site-functions/_${command}`];
+	const paths = shell === "fish" ? [`/usr/share/fish/vendor_completions.d/${command}.fish`, `/usr/local/share/fish/vendor_completions.d/${command}.fish`] : shell === "bash" ? [
+		`/usr/share/bash-completion/completions/${command}`,
+		`/usr/local/share/bash-completion/completions/${command}`,
+		`/etc/bash_completion.d/${command}`
+	] : [`/usr/share/zsh/site-functions/_${command}`, `/usr/local/share/zsh/site-functions/_${command}`];
 	for (const path of paths) try {
-		const file = Bun.file(path);
-		if (await file.exists()) return await file.text();
+		return await readFile(path, "utf-8");
 	} catch {}
 	return null;
 }
+/**
+* Detect the best shell for completion parsing by probing the command.
+* Tries `<cmd> completion <shell>` for bash, fish, zsh (in that order).
+* Returns the shell name if successful, or null if no completion command exists.
+*/
+async function detectCompletionShell(command, timeout = 5e3) {
+	for (const shell of [
+		"bash",
+		"fish",
+		"zsh"
+	]) if (await getCompletionScript(command, shell, timeout)) return shell;
+	return null;
+}
+/**
+* Resolve 'completion' entries in the sources array by probing for the best available shell.
+* Other sources are passed through unchanged.
+*/
+async function resolveSources(sources, command, timeout, log) {
+	if (!sources.includes("completion")) return sources;
+	log?.info(`Probing ${command} for completion command...`);
+	const shell = await detectCompletionShell(command, timeout);
+	return sources.flatMap((s) => {
+		if (s !== "completion") return s;
+		if (shell) {
+			log?.info(`  Found ${shell} completion support`);
+			return shell;
+		}
+		log?.info("  No completion command found, skipping");
+		return [];
+	});
+}
 function sleep(ms) {
 	return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -1011,7 +1161,7 @@ function jsonSchemaPropertyToZod(prop, required, ambiguous) {
 */
 function schemaToCode(schema) {
 	try {
-		return jsonSchemaToCode(schema["~standard"].jsonSchema.input({ target: "draft-2020-12" }));
+		return jsonSchemaToCode(getJsonSchema(schema));
 	} catch {
 		return {
 			code: "z.unknown()",
@@ -1353,6 +1503,6 @@ function render(text, data, partials) {
 	return result;
 }
 //#endregion
-export { createCodeBuilder, createFileEmitter, discoverCli, fieldMetaToCode, generateBarrelFile, generateCommandFile, generateCommandTree, mergeCommandMeta, parseFishCompletions, parseHelpOutput, parseZshCompletions, schemaToCode, template };
+export { createCodeBuilder, createFileEmitter, detectCompletionShell, discoverCli, fieldMetaToCode, generateBarrelFile, generateCommandFile, generateCommandTree, mergeCommandMeta, parseBashCompletions, parseFishCompletions, parseHelpOutput, parseZshCompletions, schemaToCode, template };
 
 //# sourceMappingURL=index.mjs.map