/**
 * Field builder functions for creating form field definitions.
 *
 * Each function creates a field descriptor that captures both schema information
 * (name, type) and UI hints (label, placeholder, etc.).
 */
import type { ArrayField, BooleanField, DynamicEnumField, DynamicSchemaField, EnumOptionValue, FormElement, MetadataPolicyInput, NumberField, ObjectField, StaticEnumField, TextField } from "@formspec/core";
declare const FIELD_POLICY_BRAND: unique symbol;
/**
 * Branded field element produced by a policy-scoped builder namespace.
 *
 * @public
 */
export type FieldBuilderElement<Policy, Element extends FormElement = FormElement> = Element & {
    readonly [FIELD_POLICY_BRAND]: Policy extends undefined ? {
        readonly __formspecDefaultFieldPolicy: true;
    } : Policy;
};
/**
 * Input element accepted by policy-scoped composite field builders.
 *
 * @public
 */
export type FieldBuilderInputElement<Policy> = Policy extends undefined ? FormElement : FieldBuilderElement<Policy>;
/**
 * Field-specific metadata policy extracted from a broader metadata policy input.
 *
 * @public
 */
export type FieldMetadataPolicy<Policy> = Policy extends {
    readonly field?: infer FieldPolicy;
} ? FieldPolicy : undefined;
/**
 * Whether a specific metadata key is required by the active policy.
 *
 * @public
 */
export type IsRequiredMetadata<Policy, Key extends "apiName" | "displayName"> = FieldMetadataPolicy<Policy> extends Record<string, unknown> ? FieldMetadataPolicy<Policy>[Key] extends {
    readonly mode: "require-explicit";
} ? true : false : false;
/**
 * Label/displayName config shape under a required-or-optional policy.
 *
 * @public
 */
export type LabelDisplayNameConfig<Required extends boolean> = Required extends true ? {
    readonly label: string;
    readonly displayName?: never;
} | {
    readonly label?: never;
    readonly displayName: string;
} : {
    readonly label?: string;
    readonly displayName?: never;
} | {
    readonly label?: never;
    readonly displayName?: string;
} | {
    readonly label?: undefined;
    readonly displayName?: undefined;
};
/**
 * apiName config shape under a required-or-optional policy.
 *
 * @public
 */
export type ApiNameConfig<Required extends boolean> = Required extends true ? {
    readonly apiName: string;
} : {
    readonly apiName?: string;
};
/**
 * Whether the active policy requires any explicit field metadata.
 *
 * @public
 */
export type HasRequiredMetadata<Policy> = IsRequiredMetadata<Policy, "apiName"> extends true ? true : IsRequiredMetadata<Policy, "displayName"> extends true ? true : false;
/**
 * Base field config augmented with metadata requirements from the active policy.
 *
 * @public
 */
export type MetadataAwareFieldConfig<BaseConfig, Policy> = Omit<BaseConfig, "label" | "displayName" | "apiName"> & ApiNameConfig<IsRequiredMetadata<Policy, "apiName">> & LabelDisplayNameConfig<IsRequiredMetadata<Policy, "displayName">>;
/**
 * Optional-or-required config tuple driven by the active metadata policy.
 *
 * @public
 */
export type MaybeRequiredConfigArg<Config, Policy> = HasRequiredMetadata<Policy> extends true ? readonly [config: Config] : readonly [config?: Config];
/**
 * Argument tuple for policy-scoped array field builders.
 *
 * @public
 */
export type ArrayBuilderArgs<N extends string, Items extends readonly FieldBuilderInputElement<Policy>[], Policy> = HasRequiredMetadata<Policy> extends true ? readonly [config: ArrayFieldConfig<N, Items, Policy>, ...items: Items] : readonly [...items: Items] | readonly [config: ArrayFieldConfig<N, Items, Policy>, ...items: Items];
/**
 * Argument tuple for policy-scoped object field builders.
 *
 * @public
 */
export type ObjectBuilderArgs<N extends string, Properties extends readonly FieldBuilderInputElement<Policy>[], Policy> = HasRequiredMetadata<Policy> extends true ? readonly [config: ObjectFieldConfig<N, Properties, Policy>, ...properties: Properties] : readonly [...properties: Properties] | readonly [config: ObjectFieldConfig<N, Properties, Policy>, ...properties: Properties];
/**
 * Config accepted by policy-scoped text field builders.
 *
 * @public
 */
export type TextFieldConfig<N extends string, Policy> = MetadataAwareFieldConfig<Omit<TextField<N>, "_type" | "_field" | "name">, Policy>;
/**
 * Config accepted by policy-scoped number field builders.
 *
 * @public
 */
export type NumberFieldConfig<N extends string, Policy> = MetadataAwareFieldConfig<Omit<NumberField<N>, "_type" | "_field" | "name">, Policy>;
/**
 * Config accepted by policy-scoped boolean field builders.
 *
 * @public
 */
export type BooleanFieldConfig<N extends string, Policy> = MetadataAwareFieldConfig<Omit<BooleanField<N>, "_type" | "_field" | "name">, Policy>;
/**
 * Config accepted by policy-scoped static enum field builders.
 *
 * @public
 */
export type StaticEnumFieldConfig<N extends string, O extends readonly EnumOptionValue[], Policy> = MetadataAwareFieldConfig<Omit<StaticEnumField<N, O>, "_type" | "_field" | "name" | "options">, Policy>;
/**
 * Config accepted by policy-scoped dynamic enum field builders.
 *
 * @public
 */
export type DynamicEnumFieldConfig<N extends string, Source extends string, Policy> = MetadataAwareFieldConfig<Omit<DynamicEnumField<N, Source>, "_type" | "_field" | "name" | "source">, Policy>;
/**
 * Config accepted by policy-scoped dynamic schema field builders.
 *
 * @public
 */
export type DynamicSchemaFieldConfig<N extends string, Policy> = MetadataAwareFieldConfig<Omit<DynamicSchemaField<N>, "_type" | "_field" | "name" | "schemaSource">, Policy>;
/**
 * Config accepted by policy-scoped array field builders.
 *
 * @public
 */
export type ArrayFieldConfig<N extends string, Items extends readonly FormElement[], Policy> = MetadataAwareFieldConfig<Omit<ArrayField<N, Items>, "_type" | "_field" | "name" | "items">, Policy>;
/**
 * Config accepted by policy-scoped object field builders.
 *
 * @public
 */
export type ObjectFieldConfig<N extends string, Properties extends readonly FormElement[], Policy> = MetadataAwareFieldConfig<Omit<ObjectField<N, Properties>, "_type" | "_field" | "name" | "properties">, Policy>;
/**
 * Namespace of field builder functions produced by the DSL.
 *
 * @public
 */
export interface FieldBuilderNamespace<Policy extends MetadataPolicyInput | undefined = undefined> {
    /** Builds a text field. */
    readonly text: <const N extends string>(name: N, ...args: MaybeRequiredConfigArg<TextFieldConfig<N, Policy>, Policy>) => FieldBuilderElement<Policy, TextField<N>>;
    /** Builds a number field. */
    readonly number: <const N extends string>(name: N, ...args: MaybeRequiredConfigArg<NumberFieldConfig<N, Policy>, Policy>) => FieldBuilderElement<Policy, NumberField<N>>;
    /** Builds a boolean field. */
    readonly boolean: <const N extends string>(name: N, ...args: MaybeRequiredConfigArg<BooleanFieldConfig<N, Policy>, Policy>) => FieldBuilderElement<Policy, BooleanField<N>>;
    /** Builds a static enum field. */
    readonly enum: <const N extends string, const O extends readonly EnumOptionValue[]>(name: N, options: O, ...args: MaybeRequiredConfigArg<StaticEnumFieldConfig<N, O, Policy>, Policy>) => FieldBuilderElement<Policy, StaticEnumField<N, O>>;
    /** Builds a dynamic enum field. */
    readonly dynamicEnum: <const N extends string, const Source extends string>(name: N, source: Source, ...args: MaybeRequiredConfigArg<DynamicEnumFieldConfig<N, Source, Policy>, Policy>) => FieldBuilderElement<Policy, DynamicEnumField<N, Source>>;
    /** Builds a dynamic schema field. */
    readonly dynamicSchema: <const N extends string>(name: N, schemaSource: string, ...args: MaybeRequiredConfigArg<DynamicSchemaFieldConfig<N, Policy>, Policy>) => FieldBuilderElement<Policy, DynamicSchemaField<N>>;
    /** Builds an array field, optionally with config as the second argument. */
    readonly array: <const N extends string, const Items extends readonly FieldBuilderInputElement<Policy>[]>(name: N, ...args: ArrayBuilderArgs<N, Items, Policy>) => FieldBuilderElement<Policy, ArrayField<N, Items>>;
    /** Builds an array field with an explicit config object. */
    readonly arrayWithConfig: <const N extends string, const Items extends readonly FieldBuilderInputElement<Policy>[]>(name: N, config: ArrayFieldConfig<N, Items, Policy>, ...items: Items) => FieldBuilderElement<Policy, ArrayField<N, Items>>;
    /** Builds an object field, optionally with config as the second argument. */
    readonly object: <const N extends string, const Properties extends readonly FieldBuilderInputElement<Policy>[]>(name: N, ...args: ObjectBuilderArgs<N, Properties, Policy>) => FieldBuilderElement<Policy, ObjectField<N, Properties>>;
    /** Builds an object field with an explicit config object. */
    readonly objectWithConfig: <const N extends string, const Properties extends readonly FieldBuilderInputElement<Policy>[]>(name: N, config: ObjectFieldConfig<N, Properties, Policy>, ...properties: Properties) => FieldBuilderElement<Policy, ObjectField<N, Properties>>;
}
/**
 * Field builder namespace containing functions to create each field type.
 *
 * @example
 * ```typescript
 * import { field } from "@formspec/dsl";
 *
 * field.text("name", { label: "Full Name" });
 * field.number("age", { min: 0, max: 150 });
 * field.enum("status", ["draft", "sent", "paid"]);
 * field.dynamicEnum("country", "countries", { label: "Country" });
 * ```
 *
 * @public
 */
export declare function createFieldBuilders<const Policy extends MetadataPolicyInput | undefined = undefined>(): FieldBuilderNamespace<Policy>;
/**
 * Field builder namespace containing functions to create each field type.
 *
 * @public
 */
export declare const field: FieldBuilderNamespace<undefined>;
export {};
//# sourceMappingURL=field.d.ts.map