formspec 0.1.0-alpha.26 → 0.1.0-alpha.28

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mike North
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -65,7 +65,6 @@ const resolvers = defineResolvers(OrderForm, {});
 - `generateJsonSchema`
 - `generateUiSchema`
 - `writeSchemas`
-- `buildMixedAuthoringSchemas`
 
 ### Runtime
 
@@ -76,14 +75,21 @@ const resolvers = defineResolvers(OrderForm, {});
 - `InferSchema`
 - `InferFormSchema`
 - core field, layout, and state types
+- resolver and validation helper types
+
+### Utilities
+
+- `createInitialFieldState`
+- `validateForm`
+- `logValidationIssues`
 
 ## When To Use Individual Packages
 
-- Use `@formspec/build` directly for `generateSchemas()` and static TypeScript analysis.
+- Use `@formspec/build` directly for `generateSchemas()`, `generateSchemasFromClass()`, `generateSchemasFromProgram()`, `buildMixedAuthoringSchemas()`, and static TypeScript analysis.
 - Use `@formspec/eslint-plugin` for lint rules.
 - Use `@formspec/cli` for build-time artifact generation from files.
 - Use `@formspec/validator` for runtime JSON Schema validation.
 
 ## License
 
-UNLICENSED
+This package is part of the FormSpec monorepo and is released under the MIT License. See [LICENSE](./LICENSE) for details.

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.
  *
@@ -260,26 +204,6 @@ 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.
  *
@@ -391,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).
  *
@@ -440,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.
  *
@@ -478,20 +353,6 @@ export declare interface EnumOption {
     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 {
-    /** Stored enum value written into submitted data. */
-    readonly id: string;
-    /** Human-readable label shown to end users. */
-    readonly label: string;
-}
-
 /**
  * Valid enum option types: either plain strings or objects with id/label.
  *
@@ -499,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.
  *
@@ -604,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.
@@ -811,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.
  *
@@ -837,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.
  *
@@ -937,24 +645,6 @@ 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.
  *
@@ -1223,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.
  *
@@ -1274,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.
  *
@@ -1453,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.
  *
@@ -1512,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).
  *
@@ -1561,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.