import type { QuackValue } from "./vector";
/** Scalar value accepted by the client-side SQL literal formatter. */
export type SqlParameterValue = QuackValue | Date | undefined;
/** SQL parameter value, including list literals represented as arrays. */
export type SqlParameter = SqlParameterValue | readonly SqlParameterValue[];
/** Positional SQL parameters used to replace `?` placeholders. */
export type PositionalSqlParameters = readonly SqlParameter[];
/** Named SQL parameters used to replace `:name` placeholders. */
export type NamedSqlParameters = Record<string, SqlParameter>;
/** Positional or named SQL parameters. */
export type SqlParameters = PositionalSqlParameters | NamedSqlParameters;
/**
 * Format SQL by replacing positional or named placeholders with SQL literals.
 *
 * This is a client-side formatter, not a server-side prepared statement bind.
 * Placeholders inside quoted strings and comments are ignored.
 */
export declare function formatSql(sql: string, params?: SqlParameters): string;
/** Convert a JavaScript/Quack value to a DuckDB SQL literal. */
export declare function sqlLiteral(value: SqlParameter): string;