/**
 * Browser-safe option primitives shared across dbx-tools packages.
 *
 * @module
 */
import { z } from "zod";
export declare const DatabricksEnvironmentNamesSchema: z.ZodObject<{
    profile: z.ZodDefault<z.ZodLiteral<"DATABRICKS_CONFIG_PROFILE">>;
    host: z.ZodDefault<z.ZodLiteral<"DATABRICKS_HOST">>;
    accountId: z.ZodDefault<z.ZodLiteral<"DATABRICKS_ACCOUNT_ID">>;
    workspaceId: z.ZodDefault<z.ZodLiteral<"DATABRICKS_WORKSPACE_ID">>;
    configFile: z.ZodDefault<z.ZodLiteral<"DATABRICKS_CONFIG_FILE">>;
    clientId: z.ZodDefault<z.ZodLiteral<"DATABRICKS_CLIENT_ID">>;
    clientSecret: z.ZodDefault<z.ZodLiteral<"DATABRICKS_CLIENT_SECRET">>;
    accessToken: z.ZodDefault<z.ZodLiteral<"DATABRICKS_TOKEN">>;
    groupId: z.ZodDefault<z.ZodLiteral<"DATABRICKS_GROUP_ID">>;
    authType: z.ZodDefault<z.ZodLiteral<"DATABRICKS_AUTH_TYPE">>;
    appName: z.ZodDefault<z.ZodLiteral<"DATABRICKS_APP_NAME">>;
    appPort: z.ZodDefault<z.ZodLiteral<"DATABRICKS_APP_PORT">>;
    lakebaseEndpoint: z.ZodDefault<z.ZodLiteral<"LAKEBASE_ENDPOINT">>;
}, z.core.$strict>;
export type DatabricksEnvironmentNames = z.output<typeof DatabricksEnvironmentNamesSchema>;
/** Canonical Databricks environment names derived from the owning schema. */
export declare const databricksEnvironmentNames: Readonly<{
    profile: "DATABRICKS_CONFIG_PROFILE";
    host: "DATABRICKS_HOST";
    accountId: "DATABRICKS_ACCOUNT_ID";
    workspaceId: "DATABRICKS_WORKSPACE_ID";
    configFile: "DATABRICKS_CONFIG_FILE";
    clientId: "DATABRICKS_CLIENT_ID";
    clientSecret: "DATABRICKS_CLIENT_SECRET";
    accessToken: "DATABRICKS_TOKEN";
    groupId: "DATABRICKS_GROUP_ID";
    authType: "DATABRICKS_AUTH_TYPE";
    appName: "DATABRICKS_APP_NAME";
    appPort: "DATABRICKS_APP_PORT";
    lakebaseEndpoint: "LAKEBASE_ENDPOINT";
}>;
export declare const PostgresEnvironmentNamesSchema: z.ZodObject<{
    postgresRole: z.ZodDefault<z.ZodLiteral<"DBX_TOOLS_POSTGRES_ROLE">>;
}, z.core.$strict>;
export type PostgresEnvironmentNames = z.output<typeof PostgresEnvironmentNamesSchema>;
/** Canonical PostgreSQL environment names derived from the owning schema. */
export declare const postgresEnvironmentNames: Readonly<{
    postgresRole: "DBX_TOOLS_POSTGRES_ROLE";
}>;
export declare const postgresRoleSchema: z.ZodString;
export declare const PostgresOptionsSchema: z.ZodObject<{
    postgresRole: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
export declare const PostgresConfigOptionsSchema: z.ZodObject<{
    postgresRole: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
export type PostgresOptions = z.input<typeof PostgresOptionsSchema>;
export declare const tcpPortSchema: z.ZodCoercedNumber<number>;
export declare const tcpPortOrZeroSchema: z.ZodCoercedNumber<number>;
export declare const normalizedUrlSchema: z.ZodString;
export declare const DatabricksOptionsSchema: z.ZodObject<{
    profile: z.ZodOptional<z.ZodString>;
    host: z.ZodOptional<z.ZodString>;
    accountId: z.ZodOptional<z.ZodString>;
    workspaceId: z.ZodOptional<z.ZodString>;
    configFile: z.ZodOptional<z.ZodString>;
    clientId: z.ZodOptional<z.ZodString>;
    clientSecret: z.ZodOptional<z.ZodString>;
    accessToken: z.ZodOptional<z.ZodString>;
    groupId: z.ZodOptional<z.ZodString>;
    authType: z.ZodOptional<z.ZodString>;
    appName: z.ZodOptional<z.ZodString>;
    appPort: z.ZodOptional<z.ZodCoercedNumber<number>>;
    lakebaseEndpoint: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
export type DatabricksOptions = z.input<typeof DatabricksOptionsSchema>;
/** Key format used when serializing parsed options. */
export type OptionSerializationFormat = "flag" | "env";
/** Serialize complete parsed options as a process environment map. */
export declare function serializeOptsEnvironment<T extends z.ZodRawShape>(schema: z.ZodObject<T>, values: z.input<z.ZodObject<T>>): Readonly<Record<string, string>>;
export declare const LakebaseOptionsSchema: z.ZodObject<{
    lakebaseEndpoint: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
export type LakebaseOptions = z.input<typeof LakebaseOptionsSchema>;
/** Explicit option values or environment entries consumed by option parsing helpers. */
export type OptionValueMap = Readonly<Record<string, unknown>> | null;
/** Parse only supplied flag and environment values through an owning Zod object schema. */
export declare function parseOpts<T extends z.ZodRawShape>(schema: z.ZodObject<T>, flags?: OptionValueMap, environment?: OptionValueMap): Partial<z.output<z.ZodObject<T>>>;
/** Supported listener transport schemes. */
export type ListenScheme = "tcp" | "unix";
export declare const TcpListenAddressSchema: z.ZodObject<{
    scheme: z.ZodLiteral<"tcp">;
    host: z.ZodString;
    port: z.ZodCoercedNumber<number>;
}, z.core.$strict>;
export declare const UnixListenAddressSchema: z.ZodObject<{
    scheme: z.ZodLiteral<"unix">;
    path: z.ZodString;
}, z.core.$strict>;
/** TCP listener returned by {@link listenAddressSchema}. */
export type TcpListenAddress = z.output<typeof TcpListenAddressSchema>;
/** Unix-domain listener returned by {@link listenAddressSchema}. */
export type UnixListenAddress = z.output<typeof UnixListenAddressSchema>;
/** Transport-aware listener address. */
export type ListenAddress = TcpListenAddress | UnixListenAddress;
/** Defaults and validation policy for {@link listenAddressSchema}. */
export interface ListenAddressOptions {
    readonly port: number;
    readonly host?: string;
    readonly loopback?: boolean;
    readonly scheme?: ListenScheme;
    readonly schemes?: readonly ListenScheme[];
    readonly withDefault?: boolean;
}
/** Raw listener input accepted before transport-aware normalization. */
export type ListenAddressInput = ListenAddress | string | number | undefined;
export declare function listenAddressSchema(options: ListenAddressOptions & {
    readonly schemes: readonly ["tcp", "unix"];
    readonly withDefault: false;
}): z.ZodType<ListenAddress, unknown>;
export declare function listenAddressSchema(options: ListenAddressOptions & {
    readonly schemes: readonly ["tcp", "unix"];
}): z.ZodDefault<z.ZodType<ListenAddress, unknown>>;
export declare function listenAddressSchema(options: ListenAddressOptions & {
    readonly withDefault: false;
}): z.ZodType<TcpListenAddress, unknown>;
export declare function listenAddressSchema(options: ListenAddressOptions): z.ZodDefault<z.ZodType<TcpListenAddress, unknown>>;
/** Render a listener address as a `tcp://` or `unix://` URL. */
export declare function formatListenAddress(address: ListenAddress): string;