/**
 * Copyright 2025 Sushanth (https://github.com/sushanthpy)
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
/**
 * Unified Output Format Semantics
 *
 * Provides format enums for query results and LLM context packaging.
 * This mirrors the Rust toondb-client format module for consistency.
 */
/**
 * Error when format conversion fails.
 */
export declare class FormatConversionError extends Error {
    fromFormat: string;
    toFormat: string;
    reason: string;
    constructor(fromFormat: string, toFormat: string, reason: string);
}
/**
 * Output format for query results sent to clients.
 *
 * These formats are optimized for transmission efficiency and
 * client-side processing.
 */
export declare enum WireFormat {
    /**
     * TOON format (default, 40-66% fewer tokens than JSON).
     * Optimized for LLM consumption.
     */
    TOON = "toon",
    /**
     * Standard JSON for compatibility.
     */
    JSON = "json",
    /**
     * Raw columnar format for analytics.
     * More efficient for large result sets with projection pushdown.
     */
    COLUMNAR = "columnar"
}
export declare namespace WireFormat {
    /**
     * Parse format from string.
     */
    function fromString(s: string): WireFormat;
}
/**
 * Output format for LLM context packaging.
 *
 * These formats are optimized for readability and token efficiency
 * when constructing prompts for language models.
 */
export declare enum ContextFormat {
    /**
     * TOON format (default, token-efficient).
     * Structured data with minimal syntax overhead.
     */
    TOON = "toon",
    /**
     * JSON format.
     * Widely understood by LLMs, good for structured data.
     */
    JSON = "json",
    /**
     * Markdown format.
     * Best for human-readable context with formatting.
     */
    MARKDOWN = "markdown"
}
export declare namespace ContextFormat {
    /**
     * Parse format from string.
     */
    function fromString(s: string): ContextFormat;
}
/**
 * Canonical storage format (server-side only).
 *
 * This is the format used for internal storage and is optimized
 * for storage efficiency and query performance.
 */
export declare enum CanonicalFormat {
    /**
     * TOON canonical format.
     */
    TOON = "toon"
}
/**
 * Helper to check format capabilities and conversions.
 */
export declare class FormatCapabilities {
    /**
     * Convert WireFormat to ContextFormat if compatible.
     */
    static wireToContext(wire: WireFormat): ContextFormat | null;
    /**
     * Convert ContextFormat to WireFormat if compatible.
     */
    static contextToWire(ctx: ContextFormat): WireFormat | null;
    /**
     * Check if format supports round-trip: decode(encode(x)) = x.
     */
    static supportsRoundTrip(fmt: WireFormat): boolean;
}
//# sourceMappingURL=format.d.ts.map