/**
 * Markdown Types
 *
 * Centralized type definitions for the Markdown module.
 */
/**
 * Column alignment in a Markdown table.
 * Determined by colon placement in the separator row:
 * - `:---`  = left
 * - `:---:` = center
 * - `---:`  = right
 * - `---`   = none (defaults to left in most renderers)
 */
export type MarkdownAlignment = "left" | "center" | "right" | "none";
/**
 * Result of parsing a Markdown table.
 */
export interface MarkdownParseResult {
    /** Parsed header row (column names) */
    headers: string[];
    /** Parsed data rows (each row is an array of cell values) */
    rows: string[][];
    /** Column alignments extracted from the separator row */
    alignments: MarkdownAlignment[];
}
/**
 * Markdown parsing options.
 */
export interface MarkdownParseOptions {
    /**
     * Trim whitespace from cell values.
     * @default true
     */
    trim?: boolean;
    /**
     * Unescape Markdown escape sequences in cell values (e.g. `\|` -> `|`).
     * @default true
     */
    unescape?: boolean;
    /**
     * Skip empty rows in the output.
     * @default true
     */
    skipEmptyRows?: boolean;
    /**
     * Maximum number of data rows to parse (excludes header).
     * Useful for previewing large tables.
     */
    maxRows?: number;
    /**
     * Convert `<br>`, `<br/>`, `<br />` tags in cell content to newline characters.
     * Useful for round-tripping multiline cell content through Markdown.
     * @default false
     */
    convertBr?: boolean;
}
/**
 * Column configuration for Markdown formatting.
 */
export interface MarkdownColumnConfig {
    /** Column header text */
    header: string;
    /**
     * Column alignment.
     * @default "left"
     */
    alignment?: MarkdownAlignment;
    /**
     * Minimum column width (in characters, excluding padding).
     * The actual width will be the maximum of this value and the widest cell content.
     * @default 3 (minimum for separator `---`)
     */
    minWidth?: number;
}
/**
 * Markdown formatting options.
 */
export interface MarkdownFormatOptions {
    /**
     * Column configuration. When provided, overrides auto-detected headers and alignment.
     * Can be an array of strings (header names) or MarkdownColumnConfig objects.
     */
    columns?: (string | MarkdownColumnConfig)[];
    /**
     * Default alignment for columns without explicit alignment.
     * @default "left"
     */
    alignment?: MarkdownAlignment;
    /**
     * Align columns to equal width by padding cell content with spaces.
     * When false, disables width-alignment padding but retains the single space
     * around cell content required by most Markdown renderers (`| value |`).
     * @default true
     */
    padding?: boolean;
    /**
     * Include a trailing newline at the end of the output.
     * @default true
     */
    trailingNewline?: boolean;
    /**
     * Escape pipe characters (`|`) and backslashes (`\`) in cell content.
     * @default true
     */
    escapeContent?: boolean;
    /**
     * Custom value-to-string converter.
     * Called for each cell value before formatting.
     * Return value is used as the cell text.
     */
    stringify?: (value: unknown) => string;
}
/**
 * Unified Markdown options for Workbook integration.
 * Combines parse and format options with worksheet-specific settings.
 */
export interface MarkdownOptions extends MarkdownParseOptions, MarkdownFormatOptions {
    /** Name of the worksheet to read from or write to */
    sheetName?: string;
    /** ID of the worksheet to read from or write to */
    sheetId?: number;
    /** Custom value mapper for parsing (MD string -> cell value) */
    map?: (value: string, column: number) => unknown;
    /** Date format string for formatting Date values */
    dateFormat?: string;
    /** Use UTC for date formatting */
    dateUTC?: boolean;
    /** Include empty rows in output */
    includeEmptyRows?: boolean;
}