formspec 0.1.0-alpha.24 → 0.1.0-alpha.27

package/dist/formspec-alpha.d.ts

@@ -59,13 +59,6 @@
  */
 export declare type AnyField = TextField<string> | NumberField<string> | BooleanField<string> | StaticEnumField<string, readonly EnumOptionValue[]> | DynamicEnumField<string, string> | DynamicSchemaField<string> | ArrayField<string, readonly FormElement[]> | ObjectField<string, readonly FormElement[]>;
 
-/**
- * Union of all field types.
- *
- * @public
- */
-declare type AnyField_2 = TextField_2<string> | NumberField_2<string> | BooleanField_2<string> | StaticEnumField_2<string, readonly EnumOptionValue_2[]> | DynamicEnumField_2<string, string> | DynamicSchemaField_2<string> | ArrayField_2<string, readonly FormElement_2[]> | ObjectField_2<string, readonly FormElement_2[]>;
-
 /**
  * An array field containing repeating items.
  *
@@ -95,35 +88,6 @@ export declare interface ArrayField<N extends string, Items extends readonly For
     readonly maxItems?: number;
 }
 
-/**
- * An array field containing repeating items.
- *
- * Use this for lists of values (e.g., multiple addresses, line items).
- *
- * @typeParam N - The field name (string literal type)
- * @typeParam Items - The form elements that define each array item
- *
- * @public
- */
-declare interface ArrayField_2<N extends string, Items extends readonly FormElement_2[]> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as an array field */
-    readonly _field: "array";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Form elements that define the schema for each array item */
-    readonly items: Items;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-    /** Minimum number of items required */
-    readonly minItems?: number;
-    /** Maximum number of items allowed */
-    readonly maxItems?: number;
-}
-
 /**
  * A boolean checkbox field.
  *
@@ -144,26 +108,6 @@ export declare interface BooleanField<N extends string> {
     readonly required?: boolean;
 }
 
-/**
- * A boolean checkbox field.
- *
- * @typeParam N - The field name (string literal type)
- *
- * @public
- */
-declare interface BooleanField_2<N extends string> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as a boolean field */
-    readonly _field: "boolean";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-}
-
 /**
  * Builds both JSON Schema and UI Schema from a FormSpec.
  *
@@ -206,11 +150,17 @@ export declare type BuildSchema<Fields> = { [N in Fields extends { name: infer K
  * @public
  */
 export declare interface Categorization {
+    /** Discriminator identifying a categorization layout. */
     readonly type: "Categorization";
+    /** Categories rendered as tabs or steps. */
     readonly elements: Category[];
+    /** Optional label for the overall categorization container. */
     readonly label?: string | undefined;
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific categorization options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }
 
@@ -220,11 +170,17 @@ export declare interface Categorization {
  * @public
  */
 export declare interface Category {
+    /** Discriminator identifying a category inside a categorization layout. */
     readonly type: "Category";
+    /** Category label shown in tabs or step navigation. */
     readonly label: string;
+    /** Child elements rendered inside the category. */
     readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific category options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }
 
@@ -248,37 +204,23 @@ export declare interface Conditional<FieldName extends string, Value, Elements e
     readonly elements: Elements;
 }
 
-/**
- * A conditional wrapper that shows/hides elements based on another field's value.
- *
- * @typeParam FieldName - The field to check
- * @typeParam Value - The value that triggers the condition
- * @typeParam Elements - Tuple of contained form elements
- *
- * @public
- */
-declare interface Conditional_2<FieldName extends string, Value, Elements extends readonly FormElement_2[]> {
-    /** Type discriminator - identifies this as a conditional element */
-    readonly _type: "conditional";
-    /** Name of the field whose value determines visibility */
-    readonly field: FieldName;
-    /** Value that triggers the condition (shows nested elements) */
-    readonly value: Value;
-    /** Form elements shown when condition is met */
-    readonly elements: Elements;
-}
-
 /**
  * A Control element that binds to a JSON Schema property.
  *
  * @public
  */
 export declare interface ControlElement {
+    /** Discriminator identifying a JSON Forms control element. */
     readonly type: "Control";
+    /** JSON Pointer scope that this control binds to. */
     readonly scope: string;
+    /** Optional label override, or `false` to suppress the label. */
     readonly label?: string | false | undefined;
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific control options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }
 
@@ -373,31 +315,6 @@ export declare interface DynamicEnumField<N extends string, Source extends strin
     readonly params?: readonly string[];
 }
 
-/**
- * A field with dynamic enum options (fetched from a data source at runtime).
- *
- * @typeParam N - The field name (string literal type)
- * @typeParam Source - The data source key (from DataSourceRegistry)
- *
- * @public
- */
-declare interface DynamicEnumField_2<N extends string, Source extends string> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as a dynamic enum field */
-    readonly _field: "dynamic_enum";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Data source key for fetching options at runtime */
-    readonly source: Source;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-    /** Field names whose values are needed to fetch options */
-    readonly params?: readonly string[];
-}
-
 /**
  * A field that loads its schema dynamically (e.g., from an extension).
  *
@@ -422,30 +339,6 @@ export declare interface DynamicSchemaField<N extends string> {
     readonly params?: readonly string[];
 }
 
-/**
- * A field that loads its schema dynamically (e.g., from an extension).
- *
- * @typeParam N - The field name (string literal type)
- *
- * @public
- */
-declare interface DynamicSchemaField_2<N extends string> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as a dynamic schema field */
-    readonly _field: "dynamic_schema";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Identifier for the schema source */
-    readonly schemaSource: string;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-    /** Field names whose values are needed to configure the schema */
-    readonly params?: readonly string[];
-}
-
 /**
  * An enum option with a separate ID and display label.
  *
@@ -454,19 +347,9 @@ declare interface DynamicSchemaField_2<N extends string> {
  * @public
  */
 export declare interface EnumOption {
+    /** Stored enum value written into submitted data. */
     readonly id: string;
-    readonly label: string;
-}
-
-/**
- * An enum option with a separate ID and display label.
- *
- * Use this when the stored value (id) should differ from the display text (label).
- *
- * @public
- */
-declare interface EnumOption_2 {
-    readonly id: string;
+    /** Human-readable label shown to end users. */
     readonly label: string;
 }
 
@@ -477,13 +360,6 @@ declare interface EnumOption_2 {
  */
 export declare type EnumOptionValue = string | EnumOption;
 
-/**
- * Valid enum option types: either plain strings or objects with id/label.
- *
- * @public
- */
-declare type EnumOptionValue_2 = string | EnumOption_2;
-
 /**
  * Predicate types for conditional logic.
  *
@@ -582,178 +458,11 @@ export declare interface FetchOptionsResponse<T = unknown> {
 }
 
 /**
- * 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" });
- * ```
+ * Field builder helpers that preserve this package's exported type identities.
  *
  * @public
  */
-export declare const field: {
-    /**
-     * Creates a text input field.
-     *
-     * @param name - The field name (used as the schema key)
-     * @param config - Optional configuration for label, placeholder, etc.
-     * @returns A TextField descriptor
-     */
-    text: <const N extends string>(name: N, config?: Omit<TextField_2<N>, "_type" | "_field" | "name">) => TextField_2<N>;
-    /**
-     * Creates a numeric input field.
-     *
-     * @param name - The field name (used as the schema key)
-     * @param config - Optional configuration for label, min, max, etc.
-     * @returns A NumberField descriptor
-     */
-    number: <const N extends string>(name: N, config?: Omit<NumberField_2<N>, "_type" | "_field" | "name">) => NumberField_2<N>;
-    /**
-     * Creates a boolean checkbox field.
-     *
-     * @param name - The field name (used as the schema key)
-     * @param config - Optional configuration for label, etc.
-     * @returns A BooleanField descriptor
-     */
-    boolean: <const N extends string>(name: N, config?: Omit<BooleanField_2<N>, "_type" | "_field" | "name">) => BooleanField_2<N>;
-    /**
-     * Creates a field with static enum options (known at compile time).
-     *
-     * Literal types are automatically inferred - no `as const` needed:
-     * ```typescript
-     * field.enum("status", ["draft", "sent", "paid"])
-     * // Schema type: "draft" | "sent" | "paid"
-     * ```
-     *
-     * Options can be strings or objects with `id` and `label`:
-     * ```typescript
-     * field.enum("priority", [
-     *   { id: "low", label: "Low Priority" },
-     *   { id: "high", label: "High Priority" },
-     * ])
-     * ```
-     *
-     * **Note:** All options must be of the same type (all strings OR all objects).
-     * Mixing strings and objects will throw a runtime error.
-     *
-     * @param name - The field name (used as the schema key)
-     * @param options - Array of allowed string values or objects with `id` and `label` properties
-     * @param config - Optional configuration for label, etc.
-     * @returns A StaticEnumField descriptor
-     * @throws Error if options array contains mixed types (strings and objects)
-     */
-    enum: <const N extends string, const O extends readonly EnumOptionValue_2[]>(name: N, options: O, config?: Omit<StaticEnumField_2<N, O>, "_type" | "_field" | "name" | "options">) => StaticEnumField_2<N, O>;
-    /**
-     * Creates a field with dynamic enum options (fetched from a data source at runtime).
-     *
-     * The data source must be registered in DataSourceRegistry via module augmentation:
-     * ```typescript
-     * declare module "@formspec/core" {
-     *   interface DataSourceRegistry {
-     *     countries: { id: string; code: string; name: string };
-     *   }
-     * }
-     *
-     * field.dynamicEnum("country", "countries", { label: "Country" })
-     * ```
-     *
-     * @param name - The field name (used as the schema key)
-     * @param source - The data source key (must be in DataSourceRegistry)
-     * @param config - Optional configuration for label, params, etc.
-     * @returns A DynamicEnumField descriptor
-     */
-    dynamicEnum: <const N extends string, const Source extends string>(name: N, source: Source, config?: Omit<DynamicEnumField_2<N, Source>, "_type" | "_field" | "name" | "source">) => DynamicEnumField_2<N, Source>;
-    /**
-     * Creates a field that loads its schema dynamically (e.g., from an extension).
-     *
-     * @param name - The field name (used as the schema key)
-     * @param schemaSource - Identifier for the schema source
-     * @param config - Optional configuration for label, etc.
-     * @returns A DynamicSchemaField descriptor
-     */
-    dynamicSchema: <const N extends string>(name: N, schemaSource: string, config?: Omit<DynamicSchemaField_2<N>, "_type" | "_field" | "name" | "schemaSource">) => DynamicSchemaField_2<N>;
-    /**
-     * Creates an array field containing repeating items.
-     *
-     * Use this for lists of values (e.g., multiple addresses, line items).
-     *
-     * @example
-     * ```typescript
-     * field.array("addresses",
-     *   field.text("street", { label: "Street" }),
-     *   field.text("city", { label: "City" }),
-     *   field.text("zip", { label: "ZIP Code" }),
-     * )
-     * ```
-     *
-     * @param name - The field name (used as the schema key)
-     * @param items - The form elements that define each array item
-     * @returns An ArrayField descriptor
-     */
-    array: <const N extends string, const Items extends readonly FormElement_2[]>(name: N, ...items: Items) => ArrayField_2<N, Items>;
-    /**
-     * Creates an array field with additional configuration options.
-     *
-     * @example
-     * ```typescript
-     * field.arrayWithConfig("lineItems", {
-     *   label: "Line Items",
-     *   minItems: 1,
-     *   maxItems: 10,
-     * },
-     *   field.text("description"),
-     *   field.number("quantity"),
-     * )
-     * ```
-     *
-     * @param name - The field name (used as the schema key)
-     * @param config - Configuration for label, minItems, maxItems, etc.
-     * @param items - The form elements that define each array item
-     * @returns An ArrayField descriptor
-     */
-    arrayWithConfig: <const N extends string, const Items extends readonly FormElement_2[]>(name: N, config: Omit<ArrayField_2<N, Items>, "_type" | "_field" | "name" | "items">, ...items: Items) => ArrayField_2<N, Items>;
-    /**
-     * Creates an object field containing nested properties.
-     *
-     * Use this for grouping related fields under a single key in the schema.
-     *
-     * @example
-     * ```typescript
-     * field.object("address",
-     *   field.text("street", { label: "Street" }),
-     *   field.text("city", { label: "City" }),
-     *   field.text("zip", { label: "ZIP Code" }),
-     * )
-     * ```
-     *
-     * @param name - The field name (used as the schema key)
-     * @param properties - The form elements that define the object's properties
-     * @returns An ObjectField descriptor
-     */
-    object: <const N extends string, const Properties extends readonly FormElement_2[]>(name: N, ...properties: Properties) => ObjectField_2<N, Properties>;
-    /**
-     * Creates an object field with additional configuration options.
-     *
-     * @example
-     * ```typescript
-     * field.objectWithConfig("billingAddress", { label: "Billing Address", required: true },
-     *   field.text("street"),
-     *   field.text("city"),
-     * )
-     * ```
-     *
-     * @param name - The field name (used as the schema key)
-     * @param config - Configuration for label, required, etc.
-     * @param properties - The form elements that define the object's properties
-     * @returns An ObjectField descriptor
-     */
-    objectWithConfig: <const N extends string, const Properties extends readonly FormElement_2[]>(name: N, config: Omit<ObjectField_2<N, Properties>, "_type" | "_field" | "name" | "properties">, ...properties: Properties) => ObjectField_2<N, Properties>;
-};
+export declare const field: FormSpecFieldBuilder;
 
 /**
  * Represents the runtime state of a single form field.
@@ -789,13 +498,6 @@ export declare type FlattenIntersection<T> = { [K in keyof T]: T[K] } & {};
  */
 export declare type FormElement = AnyField | Group<readonly FormElement[]> | Conditional<string, unknown, readonly FormElement[]>;
 
-/**
- * Union of all form element types (fields and structural elements).
- *
- * @public
- */
-declare type FormElement_2 = AnyField_2 | Group_2<readonly FormElement_2[]> | Conditional_2<string, unknown, readonly FormElement_2[]>;
-
 /**
  * A complete form specification.
  *
@@ -815,6 +517,34 @@ export declare interface FormSpec<Elements extends readonly FormElement[]> {
  */
 export declare function formspec<const Elements extends readonly FormElement[]>(...elements: Elements): FormSpec<Elements>;
 
+/**
+ * Field builder helpers re-exported by the top-level `formspec` package.
+ *
+ * @public
+ */
+export declare interface FormSpecFieldBuilder {
+    /** Creates a text field. */
+    text<const N extends string>(name: N, config?: Omit<TextField<N>, "_field" | "_type" | "name">): TextField<N>;
+    /** Creates a number field. */
+    number<const N extends string>(name: N, config?: Omit<NumberField<N>, "_field" | "_type" | "name">): NumberField<N>;
+    /** Creates a boolean field. */
+    boolean<const N extends string>(name: N, config?: Omit<BooleanField<N>, "_field" | "_type" | "name">): BooleanField<N>;
+    /** Creates a static enum field from a fixed options list. */
+    enum<const N extends string, const O extends readonly EnumOptionValue[]>(name: N, options: O, config?: Omit<StaticEnumField<N, O>, "_field" | "_type" | "name" | "options">): StaticEnumField<N, O>;
+    /** Creates a dynamic enum field backed by an external option source. */
+    dynamicEnum<const N extends string, const Source extends string>(name: N, source: Source, config?: Omit<DynamicEnumField<N, Source>, "_field" | "_type" | "name" | "source">): DynamicEnumField<N, Source>;
+    /** Creates a field whose schema is resolved from an external source at runtime. */
+    dynamicSchema<const N extends string>(name: N, schemaSource: string, config?: Omit<DynamicSchemaField<N>, "_field" | "_type" | "name" | "schemaSource">): DynamicSchemaField<N>;
+    /** Creates an array field from a list of item elements. */
+    array<const N extends string, const Items extends readonly FormElement[]>(name: N, ...items: Items): ArrayField<N, Items>;
+    /** Creates an array field with explicit configuration and item elements. */
+    arrayWithConfig<const N extends string, const Items extends readonly FormElement[]>(name: N, config: Omit<ArrayField<N, Items>, "_field" | "_type" | "items" | "name">, ...items: Items): ArrayField<N, Items>;
+    /** Creates an object field from a list of property elements. */
+    object<const N extends string, const Properties extends readonly FormElement[]>(name: N, ...properties: Properties): ObjectField<N, Properties>;
+    /** Creates an object field with explicit configuration and property elements. */
+    objectWithConfig<const N extends string, const Properties extends readonly FormElement[]>(name: N, config: Omit<ObjectField<N, Properties>, "_field" | "_type" | "name" | "properties">, ...properties: Properties): ObjectField<N, Properties>;
+}
+
 /**
  * Options for creating a form specification.
  *
@@ -915,35 +645,23 @@ export declare interface Group<Elements extends readonly FormElement[]> {
  */
 export declare function group<const Elements extends readonly FormElement[]>(label: string, ...elements: Elements): Group<Elements>;
 
-/**
- * A visual grouping of form elements.
- *
- * Groups provide visual organization and can be rendered as fieldsets or sections.
- *
- * @typeParam Elements - Tuple of contained form elements
- *
- * @public
- */
-declare interface Group_2<Elements extends readonly FormElement_2[]> {
-    /** Type discriminator - identifies this as a group element */
-    readonly _type: "group";
-    /** Display label for the group */
-    readonly label: string;
-    /** Form elements contained within this group */
-    readonly elements: Elements;
-}
-
 /**
  * A group element with a label.
  *
  * @public
  */
 export declare interface GroupLayout {
+    /** Discriminator identifying a labeled group container. */
     readonly type: "Group";
+    /** Group label shown by compatible renderers. */
     readonly label: string;
+    /** Child elements rendered inside the group. */
     readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific group options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }
 
@@ -953,10 +671,15 @@ export declare interface GroupLayout {
  * @public
  */
 export declare interface HorizontalLayout {
+    /** Discriminator identifying a horizontal layout container. */
     readonly type: "HorizontalLayout";
+    /** Child elements rendered side by side. */
     readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific layout options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }
 
@@ -1074,35 +797,65 @@ export declare function isTextField(element: FormElement): element is TextField<
  * @public
  */
 export declare interface JsonSchema2020 {
+    /** Declared JSON Schema dialect URI for the document root. */
     $schema?: string;
+    /** Reference to another schema location. */
     $ref?: string;
+    /** Named reusable schema definitions keyed by definition name. */
     $defs?: Record<string, JsonSchema2020>;
+    /** JSON Schema type keyword for the current node. */
     type?: string;
+    /** Object properties keyed by property name. */
     properties?: Record<string, JsonSchema2020>;
+    /** Property names that must be present on object values. */
     required?: string[];
+    /** Item schema applied to array elements. */
     items?: JsonSchema2020;
+    /** Whether, or how, additional object properties are allowed. */
     additionalProperties?: boolean | JsonSchema2020;
+    /** Closed set of allowed scalar values. */
     enum?: readonly (string | number)[];
+    /** Literal value the instance must equal. */
     const?: unknown;
+    /** Schemas that must all validate successfully. */
     allOf?: readonly JsonSchema2020[];
+    /** Schemas of which exactly one should validate successfully. */
     oneOf?: readonly JsonSchema2020[];
+    /** Schemas of which at least one may validate successfully. */
     anyOf?: readonly JsonSchema2020[];
+    /** Inclusive numeric lower bound. */
     minimum?: number;
+    /** Inclusive numeric upper bound. */
     maximum?: number;
+    /** Exclusive numeric lower bound. */
     exclusiveMinimum?: number;
+    /** Exclusive numeric upper bound. */
     exclusiveMaximum?: number;
+    /** Required numeric step interval. */
     multipleOf?: number;
+    /** Inclusive minimum string length. */
     minLength?: number;
+    /** Inclusive maximum string length. */
     maxLength?: number;
+    /** Inclusive minimum array length. */
     minItems?: number;
+    /** Inclusive maximum array length. */
     maxItems?: number;
+    /** Regular expression pattern applied to string values. */
     pattern?: string;
+    /** Whether array elements must be unique. */
     uniqueItems?: boolean;
+    /** Format hint for downstream validators and tooling. */
     format?: string;
+    /** Human-readable title for the schema node. */
     title?: string;
+    /** Human-readable description for the schema node. */
     description?: string;
+    /** Default value suggested for the schema node. */
     default?: unknown;
+    /** Whether the schema node is deprecated. */
     deprecated?: boolean;
+    /** Additional vendor-prefixed extension keywords. */
     [key: `x-${string}`]: unknown;
 }
 
@@ -1112,10 +865,15 @@ export declare interface JsonSchema2020 {
  * @public
  */
 export declare interface LabelElement {
+    /** Discriminator identifying a static text label element. */
     readonly type: "Label";
+    /** Static text content rendered by the label element. */
     readonly text: string;
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific label options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }
 
@@ -1155,32 +913,6 @@ export declare interface NumberField<N extends string> {
     readonly multipleOf?: number;
 }
 
-/**
- * A numeric input field.
- *
- * @typeParam N - The field name (string literal type)
- *
- * @public
- */
-declare interface NumberField_2<N extends string> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as a number field */
-    readonly _field: "number";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Minimum allowed value */
-    readonly min?: number;
-    /** Maximum allowed value */
-    readonly max?: number;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-    /** Value must be a multiple of this number (use 1 for integer semantics) */
-    readonly multipleOf?: number;
-}
-
 /**
  * An object field containing nested properties.
  *
@@ -1206,31 +938,6 @@ export declare interface ObjectField<N extends string, Properties extends readon
     readonly required?: boolean;
 }
 
-/**
- * An object field containing nested properties.
- *
- * Use this for grouping related fields under a single key in the schema.
- *
- * @typeParam N - The field name (string literal type)
- * @typeParam Properties - The form elements that define the object's properties
- *
- * @public
- */
-declare interface ObjectField_2<N extends string, Properties extends readonly FormElement_2[]> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as an object field */
-    readonly _field: "object";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Form elements that define the properties of this object */
-    readonly properties: Properties;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-}
-
 /**
  * Union of all predicate types.
  *
@@ -1295,7 +1002,9 @@ export declare type ResolverSourcesForForm<E extends readonly FormElement[]> = E
  * @public
  */
 export declare interface Rule {
+    /** UI effect to apply when the rule condition matches. */
     readonly effect: RuleEffect;
+    /** Predicate that controls when the UI effect applies. */
     readonly condition: SchemaBasedCondition;
 }
 
@@ -1305,17 +1014,29 @@ export declare interface Rule {
  * @public
  */
 export declare interface RuleConditionSchema {
+    /** Literal value the condition schema must equal. */
     const?: unknown;
+    /** Allowed values for the condition schema. */
     enum?: readonly unknown[];
+    /** JSON Schema type required by the condition schema. */
     type?: string;
+    /** Negated branch of the condition schema. */
     not?: RuleConditionSchema;
+    /** Inclusive numeric lower bound in the condition schema. */
     minimum?: number;
+    /** Inclusive numeric upper bound in the condition schema. */
     maximum?: number;
+    /** Exclusive numeric lower bound in the condition schema. */
     exclusiveMinimum?: number;
+    /** Exclusive numeric upper bound in the condition schema. */
     exclusiveMaximum?: number;
+    /** Inclusive minimum string length in the condition schema. */
     minLength?: number;
+    /** Nested property conditions keyed by property name. */
     properties?: Record<string, RuleConditionSchema>;
+    /** Property names that must be present for the condition to match. */
     required?: string[];
+    /** Schemas that must all match for the condition to succeed. */
     allOf?: RuleConditionSchema[];
 }
 
@@ -1340,7 +1061,9 @@ export declare type RuleEffect = "SHOW" | "HIDE" | "ENABLE" | "DISABLE";
  * @public
  */
 export declare interface SchemaBasedCondition {
+    /** JSON Pointer scope the rule evaluates against. */
     readonly scope: string;
+    /** JSON Schema fragment evaluated at the scoped location. */
     readonly schema: RuleConditionSchema;
 }
 
@@ -1369,31 +1092,6 @@ export declare interface StaticEnumField<N extends string, O extends readonly En
     readonly required?: boolean;
 }
 
-/**
- * A field with static enum options (known at compile time).
- *
- * Options can be plain strings or objects with `id` and `label` properties.
- *
- * @typeParam N - The field name (string literal type)
- * @typeParam O - Tuple of option values (strings or EnumOption objects)
- *
- * @public
- */
-declare interface StaticEnumField_2<N extends string, O extends readonly EnumOptionValue_2[]> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as an enum field */
-    readonly _field: "enum";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Array of allowed option values */
-    readonly options: O;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-}
-
 /**
  * Form element type definitions.
  *
@@ -1428,40 +1126,6 @@ export declare interface TextField<N extends string> {
     readonly pattern?: string;
 }
 
-/**
- * Form element type definitions.
- *
- * These types define the structure of form specifications.
- * The structure IS the definition - nesting implies layout and conditional logic.
- */
-/**
- * A text input field.
- *
- * @typeParam N - The field name (string literal type)
- *
- * @public
- */
-declare interface TextField_2<N extends string> {
-    /** Type discriminator for form elements */
-    readonly _type: "field";
-    /** Field type discriminator - identifies this as a text field */
-    readonly _field: "text";
-    /** Unique field identifier used as the schema key */
-    readonly name: N;
-    /** Display label for the field */
-    readonly label?: string;
-    /** Placeholder text shown when field is empty */
-    readonly placeholder?: string;
-    /** Whether this field is required for form submission */
-    readonly required?: boolean;
-    /** Minimum string length */
-    readonly minLength?: number;
-    /** Maximum string length */
-    readonly maxLength?: number;
-    /** Regular expression pattern the value must match */
-    readonly pattern?: string;
-}
-
 /**
  * Root UI Schema (always a layout — not a Control, Category, or Label).
  *
@@ -1477,40 +1141,11 @@ export declare type UISchema = VerticalLayout | HorizontalLayout | GroupLayout |
 export declare type UISchemaElement = ControlElement | VerticalLayout | HorizontalLayout | GroupLayout | Categorization | Category | LabelElement;
 
 /**
- * UI Schema element types.
- *
- * @public
- */
-export declare type UISchemaElementType = "Control" | "VerticalLayout" | "HorizontalLayout" | "Group" | "Categorization" | "Category" | "Label";
-
-/**
- * Validates a form specification for common issues.
- *
- * Checks for:
- * - Duplicate field names at the root level (warning)
- * - References to non-existent fields in conditionals (error)
- *
- * @example
- * ```typescript
- * const form = formspec(
- *   field.text("name"),
- *   field.text("name"), // Duplicate!
- *   when("nonExistent", "value", // Reference to non-existent field!
- *     field.text("extra"),
- *   ),
- * );
- *
- * const result = validateForm(form.elements);
- * // result.valid === false
- * // result.issues contains duplicate and reference errors
- * ```
- *
- * @param elements - The form elements to validate
- * @returns Validation result with any issues found
+ * Validates a list of form elements for duplicate names and structural issues.
  *
  * @public
  */
-export declare function validateForm(elements: readonly FormElement_2[]): ValidationResult;
+export declare function validateForm(elements: readonly FormElement[]): ValidationResult;
 
 /**
  * A validation issue found in a form specification.
@@ -1562,10 +1197,15 @@ export declare type Validity = "valid" | "invalid" | "unknown";
  * @public
  */
 export declare interface VerticalLayout {
+    /** Discriminator identifying a vertical layout container. */
     readonly type: "VerticalLayout";
+    /** Child elements rendered in vertical order. */
     readonly elements: UISchemaElement[];
+    /** Optional rule controlling visibility or enablement. */
     readonly rule?: Rule | undefined;
+    /** Renderer-specific layout options. */
     readonly options?: Record<string, unknown> | undefined;
+    /** Additional renderer-specific extension properties. */
     readonly [k: string]: unknown;
 }