import type { DocHeadingType, DocLayout, DocSort, DocTableColumn, DocTableRequired } from '@amritk/generate-markdown';
/** The flags and positional the `markdown` subcommand understands. */
export type MarkdownArgs = {
    /** Path to the JSON Schema to document (the sole positional). */
    schema?: string;
    /** Directory the prose reference pages are written to (`--out-dir`). */
    outDir?: string;
    /** Output path of the index page (`--file`). */
    file?: string;
    /** Page title override (`--title`). */
    title?: string;
    /** Fence language for derived examples (`--language`). */
    language?: string;
    /** Default layout for nested properties (`--layout`). */
    layout?: DocLayout;
    /** Property order (`--sort`). */
    sort?: DocSort;
    /** Heading level of the page title (`--heading-level`). */
    headingLevel?: number;
    /** Whether a property heading gets its **Type:** line (`--type-label`). */
    typeLabel?: DocHeadingType;
    /** When property tables render their Type column (`--type-column`). */
    typeColumn?: DocTableColumn;
    /** When property tables render their Default column (`--default-column`). */
    defaultColumn?: DocTableColumn;
    /**
     * How property tables say which properties are required (`--required-style`):
     * `column`, or any other text as a suffix after a required name.
     */
    requiredStyle?: DocTableRequired;
    /** True when `--required-first` was passed: required properties head every table. */
    requiredFirst?: boolean;
    /** True when `--table` was passed: render the HTML table instead of the pages. */
    table?: boolean;
    /** Markdown file the table is spliced into (`--readme`). */
    readme?: string;
    /** True when `--help`/`-h` was passed. */
    help?: boolean;
};
/**
 * Parses the `markdown` argv into a typed args object. Mirrors the other
 * subcommand parsers: kebab-case and camelCase flag spellings, both
 * `--flag value` and `--flag=value`, and a loud error on unknown flags so a
 * typo cannot silently drop an option. Throws on usage errors; the caller turns
 * that into the exit-code-2 path.
 */
export declare const parseMarkdownArgs: (argv: readonly string[]) => MarkdownArgs;