import type { ColumnSpec, ColumnStorageType, EmbeddingSource, TableSpec, IndexSpec, ForeignKeySpec, UniqueSpec, CheckSpec } from './types.js';
import type { DefaultValue } from './defaults.js';
export type ColumnOptions = {
    id?: number;
    nullable?: boolean;
    primaryKey?: boolean;
    default?: DefaultValue;
    generated?: 'uuid' | 'now';
    enumValues?: string[];
    check?: (value: unknown) => boolean | string;
    min?: number;
    max?: number;
    minLength?: number;
    maxLength?: number;
    regex?: RegExp;
    /** Embedding generation source (only for `embedding` columns). */
    embeddingSource?: EmbeddingSource;
    /** Encrypt this column's payload at rest (requires an encrypted database). */
    encrypted?: boolean;
    /** Encrypt but keep queryable via deterministic tokens (encrypted database). */
    encryptedIndexable?: boolean;
};
type OptsNull<TOpts extends ColumnOptions> = TOpts extends {
    nullable: true;
} ? true : false;
type OptsDefault<TOpts extends ColumnOptions> = TOpts extends {
    default: infer D;
} ? Exclude<D, undefined> : null;
type OptsGenerated<TOpts extends ColumnOptions> = TOpts extends {
    generated: infer G;
} ? Exclude<G, undefined> : null;
export declare function column<const TName extends string, TApp extends ColumnStorageType, const TOpts extends ColumnOptions = {}>(name: TName, storageType: TApp, opts?: TOpts): ColumnSpec<TName, TApp, OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function int<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'int64', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function text<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'text', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function real<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'float64', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function bool<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'bool', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function json<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'json', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function timestamp<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'timestamp', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function date<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'date', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export declare function blob<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'bytes', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** Millisecond-precision date (days since epoch × 86400000). */
export declare function date64<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'date64', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** Nanosecond-precision time-of-day (no date component). */
export declare function time64<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'time64', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** SQL INTERVAL (months + days + nanoseconds). */
export declare function intervalCol<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'interval', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** Fixed-point decimal (i128 unscaled value, precision, scale). */
export declare function decimal128<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'decimal128', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** RFC 4122 UUID (16 bytes, big-endian for sort order). */
export declare function uuid<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'uuid', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** Native JSON value (parsed, validated, typed as JSON at the storage level). */
export declare function jsonNative<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'json_native', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** Variable-length array of homogeneous values (e.g. int[], text[]). */
export declare function arrayCol<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'array', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** A dense float-vector column of dimension `dim` for ANN (`annSearch`).
 *
 * Optional `embeddingSource` records how vectors are produced.
 * Default / omit = application-supplied. `generated_column_spec` materializes
 * transactionally when the runtime has the named provider.
 */
export declare function embedding<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, dim: number, opts?: TOpts): ColumnSpec<TName, 'embedding', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
/** Serialize kit `EmbeddingSource` to the snake_case JSON shape used by kit-core. */
export declare function embeddingSourceToJson(source: EmbeddingSource): Record<string, unknown>;
/** A learned-sparse (SPLADE) token-vector column for `sparseMatch`. */
export declare function sparse<const TName extends string, const TOpts extends ColumnOptions = {}>(name: TName, opts?: TOpts): ColumnSpec<TName, 'sparse', OptsNull<TOpts>, OptsDefault<TOpts>, OptsGenerated<TOpts>>;
export interface IndexOptions {
    name?: string;
    unique?: boolean;
    /** Create an FM substring index so `contains()` pushes down to the engine. */
    fm?: boolean;
    /** Create an ANN index on an embedding column for `annSearch()`. */
    ann?: boolean;
    /** ANN representation. `dense` preserves f32 vectors and ranks by cosine
     * distance. `product` selects product quantization (requires
     * `annPqNumSubvectors`). */
    annQuantization?: 'binary_sign' | 'dense' | 'product';
    /** ANN graph/structure algorithm. Defaults to `hnsw`. Orthogonal to
     * `annQuantization`. */
    annAlgorithm?: 'hnsw' | 'diskann' | 'ivf';
    /** Optional SQL predicate for a partial index. */
    predicate?: string;
    /** HNSW graph degree. */
    annM?: number;
    /** HNSW construction search width. */
    annEfConstruction?: number;
    /** HNSW query search width. */
    annEfSearch?: number;
    /** DiskANN max graph degree R. */
    annDiskannR?: number;
    /** DiskANN build search-list size L. */
    annDiskannL?: number;
    /** DiskANN query beam width. */
    annDiskannBeamWidth?: number;
    /** DiskANN robust-prune alpha × 100 (120 = 1.2). */
    annDiskannAlpha?: number;
    /** IVF inverted-list (centroid) count. */
    annIvfNlist?: number;
    /** IVF probe count at query time. */
    annIvfNprobe?: number;
    /** IVF k-means training sample cap. */
    annIvfTrainingSamples?: number;
    /** Product-quantizer training sample cap. */
    annPqTrainingSamples?: number;
    /** Product-quantizer deterministic training seed. */
    annPqSeed?: number;
    /** Product-quantizer exact-rerank factor (0 disables). */
    annPqRerankFactor?: number;
    /** Product-quantization sub-vector count (required when
     * `annQuantization: 'product'`). */
    annPqNumSubvectors?: number;
    /** Product-quantization codebook bit width (default 8). */
    annPqBits?: number;
    /** Create a sparse (SPLADE) index on a sparse column for `sparseMatch()`. */
    sparse?: boolean;
    /** Create a MinHash/LSH set-similarity index to accelerate `setSimilarity()`. */
    minhash?: boolean;
    minhashPermutations?: number;
    minhashBands?: number;
    /** Create a learned-range (PGM zonemap) index to accelerate range predicates
     * (`gt`/`gte`/`lt`/`lte`) on numeric/timestamp columns. */
    learnedRange?: boolean;
    learnedRangeEpsilon?: number;
}
export interface UniqueOptions {
    name?: string;
}
export interface ForeignKeyOptions {
    name?: string;
    onDelete?: ForeignKeySpec['onDelete'];
}
export interface ForeignKeyReference {
    table: string;
    columns: string[];
}
export declare function index(columns: string[], opts?: IndexOptions): IndexSpec;
export declare function unique(columns: string[], opts?: UniqueOptions): UniqueSpec;
export declare function foreignKey(columns: string[], references: ForeignKeyReference, opts?: ForeignKeyOptions): ForeignKeySpec;
export declare function check(name: string, expr: CheckSpec['expr']): CheckSpec;
export interface TableOptions<TColumns extends readonly ColumnSpec[]> {
    id?: number;
    columns: TColumns;
    primaryKey: string | string[];
    indexes?: IndexSpec[];
    foreignKeys?: ForeignKeySpec[];
    unique?: UniqueSpec[];
    checks?: CheckSpec[];
}
type ColumnMap<TColumns extends readonly ColumnSpec[]> = {
    [K in TColumns[number] as K['name'] extends keyof TableSpec<TColumns> ? never : K['name']]: K;
};
export declare function table<const TColumns extends readonly ColumnSpec[]>(name: string, options: TableOptions<TColumns>): TableSpec<TColumns> & ColumnMap<TColumns>;
export declare class Schema {
    private readonly byName;
    private readonly byId;
    constructor(tables: TableSpec[]);
    tablesList(): TableSpec[];
    table(name: string): TableSpec;
    hasTable(name: string): boolean;
}
export {};
//# sourceMappingURL=schema.d.ts.map