Function zodToYargsOption

src/cli/schema-to-yargs.ts:172–240

(
  t: z.ZodType,
  opts: ZodToYargsOptionOptions = {},
)

 * Returns null for types that can't be represented as CLI flags.
 */
export function zodToYargsOption(
  t: z.ZodType,
  opts: ZodToYargsOptionOptions = {},
): YargsOptionConfig | null {
  const unwrapped = unwrap(t);
  const description = getDescription(t);
  const demandOption = !isOptional(t) && !opts.hasHydratedDefault;
  const typeName = getZodTypeName(unwrapped);

  if (typeName === 'string') {
    return { type: 'string', describe: description, demandOption };
  }

  if (typeName === 'number' || typeName === 'int' || typeName === 'bigint') {
    return { type: 'number', describe: description, demandOption };
  }

  if (typeName === 'boolean') {
    return { type: 'boolean', describe: description, demandOption: false };
  }

  if (typeName === 'enum' || typeName === 'nativeEnum') {
    const values = getEnumValues(unwrapped);
    if (values) {
      return {
        type: 'string',
        choices: values,
        describe: description,
        demandOption,
      };
    }
  }

  if (typeName === 'array') {
    const element = getArrayElement(unwrapped);
    if (element) {
      const elemTypeName = getZodTypeName(unwrap(element));
      if (elemTypeName === 'string') {
        return { type: 'array', describe: description, demandOption: false };
      }
      if (elemTypeName === 'number') {
        return {
          type: 'array',
          describe: description,
          demandOption: false,
          coerce: coerceNumberArray,
        };
      }
    }
    // Complex array types - use --json fallback
    return null;
  }

  if (typeName === 'literal') {
    const value = getLiteralValue(unwrapped);
    if (typeof value === 'string') {
      return { type: 'string', default: value, describe: description, demandOption: false };
    }