/**
 * SSR / hydration helpers for forms.
 *
 * @module bquery/forms
 */
import type { Form, FormSnapshot } from './types';
/**
 * Serialize a form snapshot to an inline `<script>` tag suitable for embedding
 * in SSR-rendered HTML. The snapshot is embedded in a
 * `<script type="application/json" data-bq-form="<id>">` tag and can be read
 * on the client by {@link readSerializedFormState} and applied via
 * {@link Form.restore}.
 *
 * **Serialization boundary (guaranteed):** values that cannot cross the
 * server→HTML→client boundary as JSON are deterministically dropped — functions,
 * `File` / `Blob` / `FileList` handles, `bigint`, and `symbol`. This is a stable
 * contract, not an incidental `JSON.stringify` side effect: re-attach file
 * inputs and other non-serializable state on the client after hydration.
 *
 * @param id - Stable identifier for this form. Must contain only letters,
 * numbers, underscores, or hyphens.
 * @param snapshot - Snapshot returned by {@link Form.snapshot}
 * @returns A complete `<script>` tag string
 *
 * @example
 * ```ts
 * import { serializeFormState } from '@bquery/bquery/forms';
 *
 * const html = `
 *   <form id="register">...</form>
 *   ${serializeFormState('register', form.snapshot())}
 * `;
 * ```
 */
export declare const serializeFormState: <T extends Record<string, unknown>>(id: string, snapshot: FormSnapshot<T>) => string;
/**
 * Read a previously-serialized form snapshot from the DOM. Returns `undefined`
 * if no matching `<script data-bq-form="...">` is found.
 *
 * @param id - The id used when calling {@link serializeFormState}. Must contain
 * only letters, numbers, underscores, or hyphens.
 * @returns The decoded snapshot or `undefined`
 */
export declare const readSerializedFormState: <T extends Record<string, unknown>>(id: string) => FormSnapshot<T> | undefined;
/**
 * Convenience: hydrate a {@link Form} from a previously-serialized snapshot.
 * Returns `true` when state was applied.
 */
export declare const hydrateForm: <T extends Record<string, unknown>>(form: Form<T>, id: string) => boolean;
//# sourceMappingURL=ssr.d.ts.map