/**
 * Cell address encoding/decoding utilities (0-indexed)
 *
 * These functions use 0-indexed coordinates (column A = 0, row 1 = 0),
 * matching the convention used by SheetJS and most spreadsheet APIs.
 *
 * @module
 */
/**
 * Cell address object (0-indexed)
 */
export interface CellAddress {
    /** 0-indexed column number */
    c: number;
    /** 0-indexed row number */
    r: number;
}
/**
 * Range object with start and end addresses (0-indexed)
 */
export interface SheetRange {
    /** Start cell (top-left) */
    s: CellAddress;
    /** End cell (bottom-right) */
    e: CellAddress;
}
/** Origin can be cell address string, cell object, row number, or -1 to append */
export type Origin = string | CellAddress | number;
/**
 * Decode column string to 0-indexed number
 * @example decodeCol("A") // => 0
 * @example decodeCol("Z") // => 25
 * @example decodeCol("AA") // => 26
 */
export declare function decodeCol(colstr: string): number;
/**
 * Encode 0-indexed column number to string
 * @example encodeCol(0) // => "A"
 * @example encodeCol(25) // => "Z"
 * @example encodeCol(26) // => "AA"
 */
export declare function encodeCol(col: number): string;
/**
 * Decode row string to 0-indexed number
 * @example decodeRow("1") // => 0
 * @example decodeRow("10") // => 9
 */
export declare function decodeRow(rowstr: string): number;
/**
 * Encode 0-indexed row number to string
 * @example encodeRow(0) // => "1"
 * @example encodeRow(9) // => "10"
 */
export declare function encodeRow(row: number): string;
/**
 * Decode cell address string to CellAddress object (0-indexed)
 * @example decodeCell("A1") // => { c: 0, r: 0 }
 * @example decodeCell("B2") // => { c: 1, r: 1 }
 */
export declare function decodeCell(cstr: string): CellAddress;
/**
 * Encode CellAddress object (0-indexed) to cell address string
 * @example encodeCell({ c: 0, r: 0 }) // => "A1"
 * @example encodeCell({ c: 1, r: 1 }) // => "B2"
 */
export declare function encodeCell(cell: CellAddress): string;
/**
 * Decode range string to SheetRange object (0-indexed)
 * @example decodeRange("A1:B2") // => { s: { c: 0, r: 0 }, e: { c: 1, r: 1 } }
 */
export declare function decodeRange(range: string): SheetRange;
/**
 * Encode SheetRange object (0-indexed) to range string
 */
export declare function encodeRange(range: SheetRange): string;
export declare function encodeRange(start: CellAddress, end: CellAddress): string;
/**
 * Excel allows unquoted sheet names only when they consist entirely of
 * ASCII letters, digits, and underscores *and* do not start with a digit.
 * Any sheet name with a space, dot, comma, bracket, `&`, CJK character,
 * or any other non-trivial symbol must be wrapped in single quotes, with
 * existing single quotes doubled.
 *
 * Shared helper so chart-api, pivot-chart, cache-populator, and the XForm
 * layer all agree on the rule — before this was unified, three callers
 * in the chart module used three different regexes, producing divergent
 * formula strings for sheet names with punctuation.
 *
 * @example quoteSheetName("Sheet1") // "Sheet1"
 * @example quoteSheetName("My Sheet") // "'My Sheet'"
 * @example quoteSheetName("It's Fine") // "'It''s Fine'"
 * @example quoteSheetName("2023 Data") // "'2023 Data'" (leading digit → quoted)
 */
export declare function quoteSheetName(sheetName: string): string;