import type { Conditional, FormSpec, Group, MetadataPolicyInput, Predicate } from "@formspec/core";
import { type FieldBuilderElement, type FieldBuilderNamespace } from "./field.js";
import type { FormSpecOptions } from "./structure.js";
import { is } from "./predicate.js";
/**
 * A configured DSL surface with policy-aware field builders and structure helpers.
 *
 * @public
 */
export interface FormSpecFactory<Policy extends MetadataPolicyInput | undefined = undefined> {
    /** Field builders scoped to the factory metadata policy. */
    readonly field: FieldBuilderNamespace<Policy>;
    /** Creates a `FormSpec` carrying the factory metadata policy. */
    readonly formspec: <const Elements extends readonly FieldBuilderElement<Policy>[]>(...elements: Elements) => FormSpec<Elements>;
    /** Creates a validating `FormSpec` carrying the factory metadata policy. */
    readonly formspecWithValidation: <const Elements extends readonly FieldBuilderElement<Policy>[]>(options: FormSpecOptions, ...elements: Elements) => FormSpec<Elements>;
    /** Policy-scoped re-export of `group()`. */
    readonly group: <const Elements extends readonly FieldBuilderElement<Policy>[]>(label: string, ...elements: Elements) => FieldBuilderElement<Policy, Group<Elements>>;
    /** Policy-scoped re-export of `when()`. */
    readonly when: <const K extends string, const V, const Elements extends readonly FieldBuilderElement<Policy>[]>(predicate: Predicate<K, V>, ...elements: Elements) => FieldBuilderElement<Policy, Conditional<K, V, Elements>>;
    /** Re-export of `is()`. */
    readonly is: typeof is;
}
/**
 * Creates a DSL factory whose field builders and generated forms share a metadata policy.
 *
 * @public
 */
export declare function createFormSpecFactory<const Policy extends MetadataPolicyInput | undefined = undefined>(options?: {
    readonly metadata?: Policy;
}): FormSpecFactory<Policy>;
//# sourceMappingURL=factory.d.ts.map