//#region src/utilities/form-object.d.ts
/** Leaf value a single control contributes to the extracted object. */
type FormObjectValue = string | number | boolean | File | null;
/** A nested plain object built from a form's dot-notation field names. */
type FormValues = {
  [key: string]: unknown;
};
/** Named controls FormObject reads from and writes to. */
type NamedControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
/**
 * One control's contribution, as seen by transforms before the nested object
 * is assembled. `value` is the raw extracted value; `checked` is present only
 * for checkbox / radio controls.
 */
interface Field {
  control: NamedControl;
  /** Dot-notation path. Transforms may rewrite it to remap the output key. */
  name: string;
  /** `string | string[] | File | File[] | boolean` depending on control type. */
  value: unknown;
  /** Whether the control is checked — checkbox / radio only. */
  checked?: boolean;
}
/**
 * Per-field transform. Return the (possibly modified) field to keep it, or
 * `null` to drop it from the output. Run in order during {@link FormObject.toObject}.
 */
type FormFieldTransform = (field: Field) => Field | null;
interface FormObjectOptions {
  /**
   * Pipeline applied to each field during `toObject()`. Defaults to
   * {@link defaultTransforms}. Providing this **replaces** the defaults —
   * spread `...defaultTransforms` to extend them.
   */
  transforms?: FormFieldTransform[];
}
/** Drop disabled controls (mirrors native `FormData`). */
declare const skipDisabled: FormFieldTransform;
/** Drop submit / reset / button / image controls and `<button>` elements. */
declare const skipButtons: FormFieldTransform;
/** Drop fields whose control is an unchecked checkbox / radio. */
declare const dropUnchecked: FormFieldTransform;
/**
 * Include unchecked **checkboxes** with the given `value` instead of dropping
 * them. Unchecked **radios** are still dropped (only the selected radio is
 * meaningful). Use this **in place of** {@link dropUnchecked}.
 *
 * @example transforms: [skipDisabled, skipButtons, uncheckedAs(false)]
 */
declare function uncheckedAs(value: unknown): FormFieldTransform;
/** Drop fields whose value is empty: `""`, `null`, or an empty array. */
declare const skipEmpty: FormFieldTransform;
/** Default pipeline: skip disabled controls, buttons, and unchecked checkboxes/radios. */
declare const defaultTransforms: FormFieldTransform[];
/**
 * Extracts an {@link HTMLFormElement} into a nested plain object (and writes one
 * back) using dot-notation field names — `name="user.address.city"` nests into
 * objects, numeric segments like `name="tags.0"` build arrays. A static snapshot:
 * values are read/written at call time, no reactivity.
 *
 * Extraction runs each field through a composable {@link FormFieldTransform}
 * pipeline ({@link defaultTransforms} by default), which decides inclusion and
 * may rewrite names/values. Mirrors the ergonomics of the native `FormData`
 * constructor.
 *
 * @example
 * ```ts
 * import { FormObject, defaultTransforms, uncheckedAs }
 *   from "elements-kit/utilities/form-object";
 *
 * // <input name="user.name"> <input name="tags.0"> <input name="tags.1">
 * const data = new FormObject(form).toObject();
 * // => { user: { name: "..." }, tags: ["...", "..."] }
 *
 * // Replace the pipeline — include unchecked checkboxes as false
 * new FormObject(form, {
 *   transforms: [...defaultTransforms.slice(0, 2), uncheckedAs(false)],
 * }).toObject();
 *
 * new FormObject(form).fromObject({ user: { name: "Wael" }, tags: ["a", "b"] });
 * ```
 */
declare class FormObject {
  #private;
  constructor(form: HTMLFormElement, options?: FormObjectOptions);
  /** Snapshot the form into a nested object built from dot-notation names. */
  toObject(): FormValues;
  /** Alias for {@link toObject} — lets `JSON.stringify(instance)` work. */
  toJSON(): FormValues;
  /** Write values from a nested object back onto the form's named controls. */
  fromObject(data: FormValues): this;
  /** Reset every named control to its empty/default state. */
  clear(): this;
}
//#endregion
export { Field, FormFieldTransform, FormObject, FormObjectOptions, FormObjectValue, FormValues, NamedControl, defaultTransforms, dropUnchecked, skipButtons, skipDisabled, skipEmpty, uncheckedAs };