/**
 * Shared lexer utilities for HCL parsing.
 * Provides common functions for tokenization and string handling.
 */
/**
 * Result of reading a quoted string from source.
 */
export interface QuotedStringResult {
    /** The unquoted string content */
    text: string;
    /** The index after the closing quote */
    end: number;
}
/**
 * Result of reading a raw value from source.
 */
export interface ValueReadResult {
    /** The raw value text (trimmed) */
    raw: string;
    /** The index after the value */
    end: number;
}
/**
 * Checks if a character is a quote character (single or double).
 * @param char - The character to check
 * @returns True if the character is a quote
 */
export declare function isQuote(char: string | undefined): boolean;
/**
 * Checks if a character at a given position is escaped by counting preceding backslashes.
 * Handles consecutive backslashes correctly (e.g., \\\\ is two escaped backslashes).
 * @param text - The source text
 * @param index - The index of the character to check
 * @returns True if the character is escaped
 */
export declare function isEscaped(text: string, index: number): boolean;
/**
 * Skips whitespace and comments (line and block comments).
 * Handles "//", block comments, and "#" style comments.
 * @param text - The source text
 * @param start - The starting index
 * @returns The index of the next non-whitespace, non-comment character
 */
export declare function skipWhitespaceAndComments(text: string, start: number): number;
/**
 * Skips a quoted string, handling escape sequences correctly.
 * @param text - The source text
 * @param start - The index of the opening quote
 * @returns The index after the closing quote
 */
export declare function skipString(text: string, start: number): number;
/**
 * Skips a heredoc string (<<EOF or <<-EOF style).
 * @param text - The source text
 * @param start - The index of the first '<'
 * @returns The index after the heredoc terminator
 */
export declare function skipHeredoc(text: string, start: number): number;
/**
 * Finds the matching closing brace for an opening brace.
 * Handles nested braces, strings, comments, and heredocs.
 * @param content - The source text
 * @param startIndex - The index of the opening brace
 * @returns The index of the matching closing brace, or -1 if not found
 */
export declare function findMatchingBrace(content: string, startIndex: number): number;
/**
 * Finds the matching closing bracket for an opening bracket.
 * Handles nested brackets of all types [], {}, ().
 * @param content - The source text
 * @param startIndex - The index of the opening bracket
 * @param openChar - The opening bracket character
 * @param closeChar - The closing bracket character
 * @returns The index of the matching closing bracket, or -1 if not found
 */
export declare function findMatchingBracket(content: string, startIndex: number, openChar: string, closeChar: string): number;
/**
 * Reads an identifier from the source text.
 * Identifiers start with a letter or underscore, followed by letters, digits, underscores, or hyphens.
 * @param text - The source text
 * @param start - The starting index
 * @returns The identifier string, or empty string if no identifier found
 */
export declare function readIdentifier(text: string, start: number): string;
/**
 * Reads an identifier that may contain dots (for attribute access).
 * @param text - The source text
 * @param start - The starting index
 * @returns The identifier string, or empty string if no identifier found
 */
export declare function readDottedIdentifier(text: string, start: number): string;
/**
 * Reads a quoted string and returns its unescaped content.
 * @param text - The source text
 * @param start - The index of the opening quote
 * @returns The unquoted string and the index after the closing quote
 */
export declare function readQuotedString(text: string, start: number): QuotedStringResult;
/**
 * Reads a value from HCL source (handles multiline values in brackets).
 * @param text - The source text
 * @param start - The starting index (after the '=' sign)
 * @returns The raw value text and the index after the value
 */
export declare function readValue(text: string, start: number): ValueReadResult;
/**
 * Splits an array literal into its elements.
 * Handles nested arrays, objects, and strings correctly.
 * @param raw - The raw array string including brackets
 * @returns Array of raw element strings
 */
export declare function splitArrayElements(raw: string): string[];
/**
 * Splits an object literal into key-value pairs.
 * Handles nested objects, arrays, and strings correctly.
 * @param raw - The raw object string including braces
 * @returns Array of [key, value] tuples
 */
export declare function splitObjectEntries(raw: string): Array<[string, string]>;