import { type Example } from "./example.js";
import { Maybe } from "./maybe.js";
import { Schema } from "./schema.js";
export type VariableSpec<T> = {
    readonly name: string;
    readonly description: string;
    readonly default: Maybe<T | undefined>;
    readonly isSensitive: boolean;
    readonly schema: Schema<T>;
    readonly examples: Example<T>[];
};
export type Variable<T> = {
    readonly spec: VariableSpec<T>;
    readonly value: () => Maybe<Value<T>>;
    readonly nativeValue: () => Maybe<T>;
    readonly marshal: (value: T) => string;
    readonly unmarshal: (value: string) => T;
};
export type Value<T> = {
    readonly verbatim: string;
    readonly canonical: string;
    readonly native: T;
    readonly isDefault: boolean;
};
export type ValueOfVariable<V extends Variable<unknown>> = V extends Variable<infer T> ? T : never;
export declare function createVariable<T>(spec: VariableSpec<T>): Variable<T>;