@bquery/bquery 1.5.0 → 1.7.0

package/dist/forms/create-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-form.d.ts","sourceRoot":"","sources":["../../src/forms/create-form.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAGV,IAAI,EACJ,UAAU,EAMX,MAAM,SAAS,CAAC;AA4EjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,UAAU,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CA8I3F,CAAC"}

package/dist/forms/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Form handling module for bQuery.js.
+ *
+ * Provides a reactive, TypeScript-first form API with field-level
+ * and cross-field validation, dirty/touched tracking, and submission
+ * handling — all backed by bQuery's signal-based reactivity system.
+ *
+ * @module bquery/forms
+ *
+ * @example
+ * ```ts
+ * import { createForm, required, email, min } from '@bquery/bquery/forms';
+ *
+ * const form = createForm({
+ *   fields: {
+ *     name:  { initialValue: '', validators: [required()] },
+ *     email: { initialValue: '', validators: [required(), email()] },
+ *     age:   { initialValue: 0,  validators: [min(18, 'Must be 18+')] },
+ *   },
+ *   onSubmit: async (values) => {
+ *     await fetch('/api/register', {
+ *       method: 'POST',
+ *       body: JSON.stringify(values),
+ *     });
+ *   },
+ * });
+ *
+ * // Reactive access
+ * console.log(form.isValid.value);          // boolean
+ * console.log(form.fields.name.error.value); // '' or error message
+ *
+ * // Submit
+ * await form.handleSubmit();
+ * ```
+ */
+export { createForm } from './create-form';
+export { custom, customAsync, email, max, maxLength, min, minLength, pattern, required, url, } from './validators';
+export type { AsyncValidator, CrossFieldValidator, FieldConfig, Form, FormConfig, FormErrors, FormField, FormFields, SubmitHandler, SyncValidator, ValidationResult, Validator, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/forms/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EACL,MAAM,EACN,WAAW,EACX,KAAK,EACL,GAAG,EACH,SAAS,EACT,GAAG,EACH,SAAS,EACT,OAAO,EACP,QAAQ,EACR,GAAG,GACJ,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,IAAI,EACJ,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/forms/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Form module types and interfaces.
+ *
+ * @module bquery/forms
+ */
+import type { Computed, Signal } from '../reactive/index';
+/**
+ * Result of a single validation rule.
+ * A string indicates an error message; `true` or `undefined` means valid.
+ */
+export type ValidationResult = string | true | undefined;
+/**
+ * Synchronous validator function.
+ *
+ * @param value - The current field value
+ * @returns A validation result — `true` / `undefined` for valid, or an error string
+ */
+export type SyncValidator<T = unknown> = (value: T) => ValidationResult;
+/**
+ * Asynchronous validator function.
+ *
+ * @param value - The current field value
+ * @returns A promise resolving to a validation result
+ */
+export type AsyncValidator<T = unknown> = (value: T) => Promise<ValidationResult>;
+/**
+ * Either a sync or async validator.
+ */
+export type Validator<T = unknown> = SyncValidator<T> | AsyncValidator<T>;
+/**
+ * Configuration for a single form field.
+ *
+ * @template T - The type of the field value
+ */
+export type FieldConfig<T = unknown> = {
+    /** Initial value for this field */
+    initialValue: T;
+    /** Validation rules applied in order; stops at first failure */
+    validators?: Validator<T>[];
+};
+/**
+ * Reactive state for a single form field.
+ *
+ * @template T - The type of the field value
+ */
+export type FormField<T = unknown> = {
+    /** Reactive signal holding the current value */
+    value: Signal<T>;
+    /** Reactive signal for the first validation error (empty string when valid) */
+    error: Signal<string>;
+    /** Whether the field value differs from its initial value */
+    isDirty: Computed<boolean>;
+    /** Whether the field has been interacted with (blur / explicit touch) */
+    isTouched: Signal<boolean>;
+    /** Whether the field has never been modified */
+    isPristine: Computed<boolean>;
+    /** Mark the field as touched */
+    touch: () => void;
+    /** Reset the field to its initial value and clear errors */
+    reset: () => void;
+};
+/**
+ * Map of field names to their reactive field state.
+ */
+export type FormFields<T extends Record<string, unknown>> = {
+    [K in keyof T]: FormField<T[K]>;
+};
+/**
+ * Map of field names to their error strings (reactive signals).
+ */
+export type FormErrors<T extends Record<string, unknown>> = {
+    [K in keyof T]: Signal<string>;
+};
+/**
+ * Cross-field validation function.
+ * Receives all current field values and returns a map of field name → error message,
+ * or an empty object / undefined if all fields are valid.
+ */
+export type CrossFieldValidator<T extends Record<string, unknown>> = (values: T) => Partial<Record<keyof T, string>> | undefined | Promise<Partial<Record<keyof T, string>> | undefined>;
+/**
+ * Submit handler function.
+ *
+ * @template T - Shape of the form values
+ */
+export type SubmitHandler<T extends Record<string, unknown>> = (values: T) => void | Promise<void>;
+/**
+ * Configuration for `createForm()`.
+ *
+ * @template T - Shape of the form values
+ *
+ * @example
+ * ```ts
+ * const config: FormConfig<{ name: string; age: number }> = {
+ *   fields: {
+ *     name: { initialValue: '', validators: [required('Name is required')] },
+ *     age: { initialValue: 0, validators: [min(1, 'Must be positive')] },
+ *   },
+ *   onSubmit: (values) => console.log(values),
+ * };
+ * ```
+ */
+export type FormConfig<T extends Record<string, unknown>> = {
+    /** Per-field configuration with initial values and validators */
+    fields: {
+        [K in keyof T]: FieldConfig<T[K]>;
+    };
+    /** Optional cross-field validators run after per-field validation */
+    crossValidators?: CrossFieldValidator<T>[];
+    /** Callback invoked on successful form submission */
+    onSubmit?: SubmitHandler<T>;
+};
+/**
+ * Return value of `createForm()`.
+ *
+ * @template T - Shape of the form values
+ */
+export type Form<T extends Record<string, unknown>> = {
+    /** Reactive field objects keyed by field name */
+    fields: FormFields<T>;
+    /** Shorthand error signals keyed by field name */
+    errors: FormErrors<T>;
+    /** Computed signal: `true` when all fields pass validation */
+    isValid: Computed<boolean>;
+    /** Computed signal: `true` when any field value differs from initial */
+    isDirty: Computed<boolean>;
+    /** Reactive signal: `true` while the submit handler is executing */
+    isSubmitting: Signal<boolean>;
+    /** Validate all fields and, if valid, call the `onSubmit` handler */
+    handleSubmit: () => Promise<void>;
+    /** Validate a single field by name */
+    validateField: (name: keyof T & string) => Promise<void>;
+    /** Validate all fields without submitting */
+    validate: () => Promise<boolean>;
+    /** Reset the entire form to initial values */
+    reset: () => void;
+    /** Get a snapshot of all current field values */
+    getValues: () => T;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/forms/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":"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"}

package/dist/forms/validators.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Built-in validation functions for form fields.
+ *
+ * Each factory returns a {@link SyncValidator} that can be passed
+ * to a field's `validators` array in {@link FormConfig}.
+ *
+ * @module bquery/forms
+ */
+import type { AsyncValidator, SyncValidator } from './types';
+/**
+ * Requires a non-empty value.
+ *
+ * Fails for `undefined`, `null`, empty strings (after trim), and empty arrays.
+ *
+ * @param message - Custom error message (default: `'This field is required'`)
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { required } from '@bquery/bquery/forms';
+ * const validate = required('Name is required');
+ * validate('');    // 'Name is required'
+ * validate('Ada'); // true
+ * ```
+ */
+export declare const required: (message?: string) => SyncValidator;
+/**
+ * Requires a string to have at least `len` characters.
+ *
+ * Non-string values are coerced via `String()` before checking length.
+ *
+ * @param len - Minimum length
+ * @param message - Custom error message
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { minLength } from '@bquery/bquery/forms';
+ * const validate = minLength(3);
+ * validate('ab');  // 'Must be at least 3 characters'
+ * validate('abc'); // true
+ * ```
+ */
+export declare const minLength: (len: number, message?: string) => SyncValidator<unknown>;
+/**
+ * Requires a string to have at most `len` characters.
+ *
+ * Non-string values are coerced via `String()` before checking length.
+ *
+ * @param len - Maximum length
+ * @param message - Custom error message
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { maxLength } from '@bquery/bquery/forms';
+ * const validate = maxLength(10);
+ * validate('hello world!!'); // 'Must be at most 10 characters'
+ * validate('hello');         // true
+ * ```
+ */
+export declare const maxLength: (len: number, message?: string) => SyncValidator<unknown>;
+/**
+ * Requires a string to match a regular expression pattern.
+ *
+ * Non-string values are coerced via `String()` before testing.
+ *
+ * @param regex - Pattern to test against
+ * @param message - Custom error message (default: `'Invalid format'`)
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { pattern } from '@bquery/bquery/forms';
+ * const validate = pattern(/^\d+$/, 'Numbers only');
+ * validate('abc'); // 'Numbers only'
+ * validate('123'); // true
+ * ```
+ */
+export declare const pattern: (regex: RegExp, message?: string) => SyncValidator<unknown>;
+/**
+ * RFC 5322–simplified email validation.
+ *
+ * @param message - Custom error message (default: `'Invalid email address'`)
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { email } from '@bquery/bquery/forms';
+ * const validate = email();
+ * validate('nope');          // 'Invalid email address'
+ * validate('ada@lovelace'); // 'Invalid email address'
+ * validate('ada@love.co');  // true
+ * ```
+ */
+export declare const email: (message?: string) => SyncValidator<unknown>;
+/**
+ * Requires a string to be a valid URL.
+ *
+ * Uses the native `URL` constructor for validation.
+ *
+ * @param message - Custom error message (default: `'Invalid URL'`)
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { url } from '@bquery/bquery/forms';
+ * const validate = url();
+ * validate('not-a-url');                // 'Invalid URL'
+ * validate('https://example.com');      // true
+ * ```
+ */
+export declare const url: (message?: string) => SyncValidator<unknown>;
+/**
+ * Requires a numeric value to be at least `limit`.
+ *
+ * @param limit - Minimum allowed value (inclusive)
+ * @param message - Custom error message
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { min } from '@bquery/bquery/forms';
+ * const validate = min(1, 'Must be positive');
+ * validate(0); // 'Must be positive'
+ * validate(1); // true
+ * ```
+ */
+export declare const min: (limit: number, message?: string) => SyncValidator<unknown>;
+/**
+ * Requires a numeric value to be at most `limit`.
+ *
+ * @param limit - Maximum allowed value (inclusive)
+ * @param message - Custom error message
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { max } from '@bquery/bquery/forms';
+ * const validate = max(100, 'Too high');
+ * validate(101); // 'Too high'
+ * validate(100); // true
+ * ```
+ */
+export declare const max: (limit: number, message?: string) => SyncValidator<unknown>;
+/**
+ * Creates a custom synchronous validator from any predicate function.
+ *
+ * @param fn - Predicate that returns `true` when the value is valid
+ * @param message - Error message when the predicate returns `false`
+ * @returns A sync validator function
+ *
+ * @example
+ * ```ts
+ * import { custom } from '@bquery/bquery/forms';
+ * const isEven = custom((v: number) => v % 2 === 0, 'Must be even');
+ * isEven(3); // 'Must be even'
+ * isEven(4); // true
+ * ```
+ */
+export declare const custom: <T = unknown>(fn: (value: T) => boolean, message: string) => SyncValidator<T>;
+/**
+ * Creates a custom asynchronous validator.
+ *
+ * @param fn - Async predicate that resolves to `true` when valid
+ * @param message - Error message when the predicate resolves to `false`
+ * @returns An async validator function
+ *
+ * @example
+ * ```ts
+ * import { customAsync } from '@bquery/bquery/forms';
+ * const isUnique = customAsync(
+ *   async (name: string) => !(await checkExists(name)),
+ *   'Already taken',
+ * );
+ * ```
+ */
+export declare const customAsync: <T = unknown>(fn: (value: T) => Promise<boolean>, message: string) => AsyncValidator<T>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/forms/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/forms/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,GAAI,gBAAkC,KAAG,aAO7D,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,KAAG,aAAa,CAAC,OAAO,CAM9E,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,KAAG,aAAa,CAAC,OAAO,CAM9E,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,MAAM,EAAE,gBAA0B,KAAG,aAAa,CAAC,OAAO,CAWxF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,GAAI,gBAAiC,KAAG,aAAa,CAAC,OAAO,CAS9E,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,GAAG,GAAI,gBAAuB,KAAG,aAAa,CAAC,OAAO,CAWlE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,GAAG,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,aAAa,CAAC,OAAO,CAQ1E,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,GAAG,GAAI,OAAO,MAAM,EAAE,UAAU,MAAM,KAAG,aAAa,CAAC,OAAO,CAQ1E,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,GAAG,OAAO,EAChC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EACzB,SAAS,MAAM,KACd,aAAa,CAAC,CAAC,CAEjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,GAAG,OAAO,EACrC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,EAClC,SAAS,MAAM,KACd,cAAc,CAAC,CAAC,CAElB,CAAC"}

package/dist/forms-C3yovgH9.js

@@ -0,0 +1,141 @@
+import { l as V } from "./type-guards-Do9DWgNp.js";
+import { n as f } from "./core-DnlyjbF2.js";
+import { r as l } from "./untrack-DJVQQ2WM.js";
+var j = (r) => r === !0 || r === void 0, O = async (r, s) => {
+  const t = r(s), e = V(t) ? await t : t;
+  return j(e) ? void 0 : e;
+}, F = (r) => {
+  const s = r.initialValue, t = f(s), e = f(""), o = f(!1), u = l(() => !Object.is(t.value, s));
+  return {
+    value: t,
+    error: e,
+    isDirty: u,
+    isTouched: o,
+    isPristine: l(() => !u.value),
+    touch: () => {
+      o.value = !0;
+    },
+    reset: () => {
+      t.value = s, e.value = "", o.value = !1;
+    }
+  };
+}, v = async (r, s) => {
+  if (!s || s.length === 0)
+    return r.error.value = "", "";
+  for (const t of s) {
+    const e = await O(t, r.value.value);
+    if (e)
+      return r.error.value = e, e;
+  }
+  return r.error.value = "", "";
+}, D = (r) => {
+  const s = Object.entries(r.fields), t = {}, e = {};
+  for (const [n, a] of s) {
+    const i = F(a);
+    t[n] = i, e[n] = i.error;
+  }
+  const o = f(!1), u = l(() => {
+    for (const n of Object.keys(t)) if (t[n].error.value !== "") return !1;
+    return !0;
+  }), b = l(() => {
+    for (const n of Object.keys(t)) if (t[n].isDirty.value) return !0;
+    return !1;
+  }), p = async (n) => {
+    const a = t[n], i = r.fields[n];
+    !a || !i || await v(a, i.validators);
+  }, y = async () => {
+    let n = !1;
+    for (const [a, i] of s) {
+      const c = t[a];
+      await v(c, i.validators) && (n = !0);
+    }
+    if (r.crossValidators && r.crossValidators.length > 0) {
+      const a = d();
+      for (const i of r.crossValidators) {
+        const c = await i(a);
+        if (c) {
+          for (const [S, g] of Object.entries(c)) if (g) {
+            const m = t[S];
+            m && (m.error.value === "" && (m.error.value = g), n = !0);
+          }
+        }
+      }
+    }
+    return !n;
+  }, h = async () => {
+    if (!o.value) {
+      o.value = !0;
+      try {
+        if (!await y()) return;
+        r.onSubmit && await r.onSubmit(d());
+      } finally {
+        o.value = !1;
+      }
+    }
+  }, w = () => {
+    for (const n of Object.keys(t)) t[n].reset();
+  }, d = () => {
+    const n = {};
+    for (const a of Object.keys(t)) n[a] = t[a].value.value;
+    return n;
+  };
+  return {
+    fields: t,
+    errors: e,
+    isValid: u,
+    isDirty: b,
+    isSubmitting: o,
+    handleSubmit: h,
+    validateField: p,
+    validate: y,
+    reset: w,
+    getValues: d
+  };
+}, E = (r = "This field is required") => (s) => s == null || typeof s == "string" && s.trim() === "" || Array.isArray(s) && s.length === 0 ? r : !0, I = (r, s) => {
+  const t = s ?? `Must be at least ${r} characters`;
+  return (e) => (typeof e == "string" ? e : String(e ?? "")).length >= r ? !0 : t;
+}, L = (r, s) => {
+  const t = s ?? `Must be at most ${r} characters`;
+  return (e) => (typeof e == "string" ? e : String(e ?? "")).length <= r ? !0 : t;
+}, R = (r, s = "Invalid format") => {
+  const t = r.global || r.sticky ? new RegExp(r.source, r.flags.replace(/[gy]/g, "")) : r;
+  return (e) => {
+    const o = typeof e == "string" ? e : String(e ?? "");
+    return t.lastIndex = 0, t.test(o) ? !0 : s;
+  };
+}, A = (r = "Invalid email address") => {
+  const s = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+  return (t) => {
+    const e = typeof t == "string" ? t : String(t ?? "");
+    return e === "" || s.test(e) ? !0 : r;
+  };
+}, C = (r = "Invalid URL") => (s) => {
+  const t = typeof s == "string" ? s : String(s ?? "");
+  if (t === "") return !0;
+  try {
+    return new URL(t), !0;
+  } catch {
+    return r;
+  }
+}, N = (r, s) => {
+  const t = s ?? `Must be at least ${r}`;
+  return (e) => e == null || typeof e == "string" && e.trim() === "" || (typeof e == "number" ? e : Number(e)) >= r ? !0 : t;
+}, q = (r, s) => {
+  const t = s ?? `Must be at most ${r}`;
+  return (e) => e == null || typeof e == "string" && e.trim() === "" || (typeof e == "number" ? e : Number(e)) <= r ? !0 : t;
+}, x = (r, s) => (t) => r(t) ? !0 : s, P = (r, s) => async (t) => await r(t) ? !0 : s;
+export {
+  L as a,
+  R as c,
+  D as d,
+  q as i,
+  E as l,
+  P as n,
+  N as o,
+  A as r,
+  I as s,
+  x as t,
+  C as u
+};
+
+//# sourceMappingURL=forms-C3yovgH9.js.map

package/dist/forms-C3yovgH9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-C3yovgH9.js","names":[],"sources":["../src/forms/create-form.ts","../src/forms/validators.ts"],"sourcesContent":["/**\r\n * Reactive form creation and management.\r\n *\r\n * @module bquery/forms\r\n */\r\n\r\nimport { computed, signal } from '../reactive/index';\r\nimport { isPromise } from '../core/utils/type-guards';\r\nimport type {\r\n  CrossFieldValidator,\r\n  FieldConfig,\r\n  Form,\r\n  FormConfig,\r\n  FormErrors,\r\n  FormField,\r\n  FormFields,\r\n  ValidationResult,\r\n  Validator,\r\n} from './types';\r\n\r\n/**\r\n * Determines whether a validator returned a valid result.\r\n * @internal\r\n */\r\nconst isValid = (result: ValidationResult): boolean => result === true || result === undefined;\r\n\r\n/**\r\n * Runs a single validator, normalising sync and async results.\r\n * @internal\r\n */\r\nconst runValidator = async <T>(validator: Validator<T>, value: T): Promise<string | undefined> => {\r\n  const result = validator(value);\r\n  const resolved = isPromise(result) ? await result : result;\r\n  return isValid(resolved) ? undefined : (resolved as string);\r\n};\r\n\r\n/**\r\n * Creates a reactive form field from its configuration.\r\n * @internal\r\n */\r\nconst createField = <T>(config: FieldConfig<T>): FormField<T> => {\r\n  const initial = config.initialValue;\r\n  const value = signal<T>(initial);\r\n  const error = signal('');\r\n  const isTouched = signal(false);\r\n\r\n  const isDirty = computed(() => !Object.is(value.value, initial));\r\n  const isPristine = computed(() => !isDirty.value);\r\n\r\n  return {\r\n    value,\r\n    error,\r\n    isDirty,\r\n    isTouched,\r\n    isPristine,\r\n    touch: () => {\r\n      isTouched.value = true;\r\n    },\r\n    reset: () => {\r\n      value.value = initial;\r\n      error.value = '';\r\n      isTouched.value = false;\r\n    },\r\n  };\r\n};\r\n\r\n/**\r\n * Validates a single field against its validators.\r\n * Sets the field's error signal.\r\n *\r\n * @returns The first error message, or an empty string if valid.\r\n * @internal\r\n */\r\nconst validateSingleField = async <T>(\r\n  field: FormField<T>,\r\n  validators: Validator<T>[] | undefined\r\n): Promise<string> => {\r\n  if (!validators || validators.length === 0) {\r\n    field.error.value = '';\r\n    return '';\r\n  }\r\n\r\n  for (const validator of validators) {\r\n    const errorMsg = await runValidator(validator, field.value.value);\r\n    if (errorMsg) {\r\n      field.error.value = errorMsg;\r\n      return errorMsg;\r\n    }\r\n  }\r\n\r\n  field.error.value = '';\r\n  return '';\r\n};\r\n\r\n/**\r\n * Creates a fully reactive form with field-level validation,\r\n * dirty/touched tracking, cross-field validation, and submission handling.\r\n *\r\n * Each field's `value`, `error`, `isDirty`, `isTouched`, and `isPristine`\r\n * are reactive signals/computed values that can be used in effects, computed\r\n * values, or directly read/written.\r\n *\r\n * @template T - Shape of the form values (e.g. `{ name: string; age: number }`)\r\n * @param config - Form configuration with field definitions, validators, and submit handler\r\n * @returns A reactive {@link Form} instance\r\n *\r\n * @example\r\n * ```ts\r\n * import { createForm, required, email, min } from '@bquery/bquery/forms';\r\n *\r\n * const form = createForm({\r\n *   fields: {\r\n *     name:  { initialValue: '', validators: [required()] },\r\n *     email: { initialValue: '', validators: [required(), email()] },\r\n *     age:   { initialValue: 0,  validators: [min(18, 'Must be 18+')] },\r\n *   },\r\n *   onSubmit: async (values) => {\r\n *     await fetch('/api/register', {\r\n *       method: 'POST',\r\n *       body: JSON.stringify(values),\r\n *     });\r\n *   },\r\n * });\r\n *\r\n * // Read reactive state\r\n * console.log(form.isValid.value);          // true (initially, before validation runs)\r\n * console.log(form.fields.name.value.value); // ''\r\n *\r\n * // Update a field\r\n * form.fields.name.value.value = 'Ada';\r\n *\r\n * // Validate and submit\r\n * await form.handleSubmit();\r\n * ```\r\n */\r\nexport const createForm = <T extends Record<string, unknown>>(config: FormConfig<T>): Form<T> => {\r\n  // Build reactive field objects\r\n  const fieldEntries = Object.entries(config.fields) as [\r\n    keyof T & string,\r\n    FieldConfig<T[keyof T]>,\r\n  ][];\r\n\r\n  const fields = {} as FormFields<T>;\r\n  const errors = {} as FormErrors<T>;\r\n\r\n  for (const [name, fieldConfig] of fieldEntries) {\r\n    const field = createField(fieldConfig as FieldConfig<T[typeof name]>);\r\n    (fields as Record<string, FormField>)[name] = field;\r\n    (errors as Record<string, typeof field.error>)[name] = field.error;\r\n  }\r\n\r\n  const isSubmitting = signal(false);\r\n\r\n  // Computed: form is valid when all error signals are empty\r\n  const isFormValid = computed(() => {\r\n    for (const name of Object.keys(fields)) {\r\n      if ((fields as Record<string, FormField>)[name].error.value !== '') {\r\n        return false;\r\n      }\r\n    }\r\n    return true;\r\n  });\r\n\r\n  // Computed: form is dirty when any field is dirty\r\n  const isFormDirty = computed(() => {\r\n    for (const name of Object.keys(fields)) {\r\n      if ((fields as Record<string, FormField>)[name].isDirty.value) {\r\n        return true;\r\n      }\r\n    }\r\n    return false;\r\n  });\r\n\r\n  /**\r\n   * Validate a single field by name.\r\n   */\r\n  const validateField = async (name: keyof T & string): Promise<void> => {\r\n    const field = (fields as Record<string, FormField>)[name];\r\n    const fieldConfig = (config.fields as Record<string, FieldConfig>)[name];\r\n    if (!field || !fieldConfig) return;\r\n    await validateSingleField(field, fieldConfig.validators);\r\n  };\r\n\r\n  /**\r\n   * Validate all fields (per-field + cross-field).\r\n   * Returns `true` if the entire form is valid.\r\n   */\r\n  const validate = async (): Promise<boolean> => {\r\n    let hasError = false;\r\n\r\n    // Per-field validation\r\n    for (const [name, fieldConfig] of fieldEntries) {\r\n      const field = (fields as Record<string, FormField>)[name];\r\n      const error = await validateSingleField(field, (fieldConfig as FieldConfig).validators);\r\n      if (error) hasError = true;\r\n    }\r\n\r\n    // Cross-field validation\r\n    if (config.crossValidators && config.crossValidators.length > 0) {\r\n      const values = getValues();\r\n      for (const crossValidator of config.crossValidators as CrossFieldValidator<T>[]) {\r\n        const crossErrors = await crossValidator(values);\r\n        if (crossErrors) {\r\n          for (const [fieldName, errorMsg] of Object.entries(crossErrors) as [\r\n            string,\r\n            string | undefined,\r\n          ][]) {\r\n            if (errorMsg) {\r\n              const field = (fields as Record<string, FormField>)[fieldName];\r\n              if (field) {\r\n                // Only set cross-field error if no per-field error exists\r\n                if (field.error.value === '') {\r\n                  field.error.value = errorMsg;\r\n                }\r\n                hasError = true;\r\n              }\r\n            }\r\n          }\r\n        }\r\n      }\r\n    }\r\n\r\n    return !hasError;\r\n  };\r\n\r\n  /**\r\n   * Validate all fields and, if valid, invoke the onSubmit handler.\r\n   * Prevents concurrent submissions by setting isSubmitting before validation.\r\n   */\r\n  const handleSubmit = async (): Promise<void> => {\r\n    if (isSubmitting.value) return;\r\n    isSubmitting.value = true;\r\n\r\n    try {\r\n      const valid = await validate();\r\n      if (!valid) return;\r\n\r\n      if (config.onSubmit) {\r\n        await config.onSubmit(getValues());\r\n      }\r\n    } finally {\r\n      isSubmitting.value = false;\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Reset every field to its initial value and clear all errors.\r\n   */\r\n  const reset = (): void => {\r\n    for (const name of Object.keys(fields)) {\r\n      (fields as Record<string, FormField>)[name].reset();\r\n    }\r\n  };\r\n\r\n  /**\r\n   * Return a plain object snapshot of all current field values.\r\n   */\r\n  const getValues = (): T => {\r\n    const values = {} as Record<string, unknown>;\r\n    for (const name of Object.keys(fields)) {\r\n      values[name] = (fields as Record<string, FormField>)[name].value.value;\r\n    }\r\n    return values as T;\r\n  };\r\n\r\n  return {\r\n    fields,\r\n    errors,\r\n    isValid: isFormValid,\r\n    isDirty: isFormDirty,\r\n    isSubmitting,\r\n    handleSubmit,\r\n    validateField,\r\n    validate,\r\n    reset,\r\n    getValues,\r\n  };\r\n};\r\n","/**\r\n * Built-in validation functions for form fields.\r\n *\r\n * Each factory returns a {@link SyncValidator} that can be passed\r\n * to a field's `validators` array in {@link FormConfig}.\r\n *\r\n * @module bquery/forms\r\n */\r\n\r\nimport type { AsyncValidator, SyncValidator } from './types';\r\n\r\n/**\r\n * Requires a non-empty value.\r\n *\r\n * Fails for `undefined`, `null`, empty strings (after trim), and empty arrays.\r\n *\r\n * @param message - Custom error message (default: `'This field is required'`)\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { required } from '@bquery/bquery/forms';\r\n * const validate = required('Name is required');\r\n * validate('');    // 'Name is required'\r\n * validate('Ada'); // true\r\n * ```\r\n */\r\nexport const required = (message = 'This field is required'): SyncValidator => {\r\n  return (value: unknown) => {\r\n    if (value == null) return message;\r\n    if (typeof value === 'string' && value.trim() === '') return message;\r\n    if (Array.isArray(value) && value.length === 0) return message;\r\n    return true;\r\n  };\r\n};\r\n\r\n/**\r\n * Requires a string to have at least `len` characters.\r\n *\r\n * Non-string values are coerced via `String()` before checking length.\r\n *\r\n * @param len - Minimum length\r\n * @param message - Custom error message\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { minLength } from '@bquery/bquery/forms';\r\n * const validate = minLength(3);\r\n * validate('ab');  // 'Must be at least 3 characters'\r\n * validate('abc'); // true\r\n * ```\r\n */\r\nexport const minLength = (len: number, message?: string): SyncValidator<unknown> => {\r\n  const msg = message ?? `Must be at least ${len} characters`;\r\n  return (value: unknown) => {\r\n    const str = typeof value === 'string' ? value : String(value ?? '');\r\n    return str.length >= len ? true : msg;\r\n  };\r\n};\r\n\r\n/**\r\n * Requires a string to have at most `len` characters.\r\n *\r\n * Non-string values are coerced via `String()` before checking length.\r\n *\r\n * @param len - Maximum length\r\n * @param message - Custom error message\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { maxLength } from '@bquery/bquery/forms';\r\n * const validate = maxLength(10);\r\n * validate('hello world!!'); // 'Must be at most 10 characters'\r\n * validate('hello');         // true\r\n * ```\r\n */\r\nexport const maxLength = (len: number, message?: string): SyncValidator<unknown> => {\r\n  const msg = message ?? `Must be at most ${len} characters`;\r\n  return (value: unknown) => {\r\n    const str = typeof value === 'string' ? value : String(value ?? '');\r\n    return str.length <= len ? true : msg;\r\n  };\r\n};\r\n\r\n/**\r\n * Requires a string to match a regular expression pattern.\r\n *\r\n * Non-string values are coerced via `String()` before testing.\r\n *\r\n * @param regex - Pattern to test against\r\n * @param message - Custom error message (default: `'Invalid format'`)\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { pattern } from '@bquery/bquery/forms';\r\n * const validate = pattern(/^\\d+$/, 'Numbers only');\r\n * validate('abc'); // 'Numbers only'\r\n * validate('123'); // true\r\n * ```\r\n */\r\nexport const pattern = (regex: RegExp, message = 'Invalid format'): SyncValidator<unknown> => {\r\n  const safeRegex =\r\n    regex.global || regex.sticky\r\n      ? new RegExp(regex.source, regex.flags.replace(/[gy]/g, ''))\r\n      : regex;\r\n\r\n  return (value: unknown) => {\r\n    const str = typeof value === 'string' ? value : String(value ?? '');\r\n    safeRegex.lastIndex = 0;\r\n    return safeRegex.test(str) ? true : message;\r\n  };\r\n};\r\n\r\n/**\r\n * RFC 5322–simplified email validation.\r\n *\r\n * @param message - Custom error message (default: `'Invalid email address'`)\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { email } from '@bquery/bquery/forms';\r\n * const validate = email();\r\n * validate('nope');          // 'Invalid email address'\r\n * validate('ada@lovelace'); // 'Invalid email address'\r\n * validate('ada@love.co');  // true\r\n * ```\r\n */\r\nexport const email = (message = 'Invalid email address'): SyncValidator<unknown> => {\r\n  // Intentionally simple — covers the vast majority of valid addresses\r\n  // without re-implementing the full RFC 5322 grammar.\r\n  const re = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\r\n  return (value: unknown) => {\r\n    const str = typeof value === 'string' ? value : String(value ?? '');\r\n    if (str === '') return true; // empty is handled by `required`\r\n    return re.test(str) ? true : message;\r\n  };\r\n};\r\n\r\n/**\r\n * Requires a string to be a valid URL.\r\n *\r\n * Uses the native `URL` constructor for validation.\r\n *\r\n * @param message - Custom error message (default: `'Invalid URL'`)\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { url } from '@bquery/bquery/forms';\r\n * const validate = url();\r\n * validate('not-a-url');                // 'Invalid URL'\r\n * validate('https://example.com');      // true\r\n * ```\r\n */\r\nexport const url = (message = 'Invalid URL'): SyncValidator<unknown> => {\r\n  return (value: unknown) => {\r\n    const str = typeof value === 'string' ? value : String(value ?? '');\r\n    if (str === '') return true; // empty is handled by `required`\r\n    try {\r\n      new URL(str);\r\n      return true;\r\n    } catch {\r\n      return message;\r\n    }\r\n  };\r\n};\r\n\r\n/**\r\n * Requires a numeric value to be at least `limit`.\r\n *\r\n * @param limit - Minimum allowed value (inclusive)\r\n * @param message - Custom error message\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { min } from '@bquery/bquery/forms';\r\n * const validate = min(1, 'Must be positive');\r\n * validate(0); // 'Must be positive'\r\n * validate(1); // true\r\n * ```\r\n */\r\nexport const min = (limit: number, message?: string): SyncValidator<unknown> => {\r\n  const msg = message ?? `Must be at least ${limit}`;\r\n  return (value: unknown) => {\r\n    if (value == null) return true;\r\n    if (typeof value === 'string' && value.trim() === '') return true;\r\n    const num = typeof value === 'number' ? value : Number(value);\r\n    return num >= limit ? true : msg;\r\n  };\r\n};\r\n\r\n/**\r\n * Requires a numeric value to be at most `limit`.\r\n *\r\n * @param limit - Maximum allowed value (inclusive)\r\n * @param message - Custom error message\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { max } from '@bquery/bquery/forms';\r\n * const validate = max(100, 'Too high');\r\n * validate(101); // 'Too high'\r\n * validate(100); // true\r\n * ```\r\n */\r\nexport const max = (limit: number, message?: string): SyncValidator<unknown> => {\r\n  const msg = message ?? `Must be at most ${limit}`;\r\n  return (value: unknown) => {\r\n    if (value == null) return true;\r\n    if (typeof value === 'string' && value.trim() === '') return true;\r\n    const num = typeof value === 'number' ? value : Number(value);\r\n    return num <= limit ? true : msg;\r\n  };\r\n};\r\n\r\n/**\r\n * Creates a custom synchronous validator from any predicate function.\r\n *\r\n * @param fn - Predicate that returns `true` when the value is valid\r\n * @param message - Error message when the predicate returns `false`\r\n * @returns A sync validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { custom } from '@bquery/bquery/forms';\r\n * const isEven = custom((v: number) => v % 2 === 0, 'Must be even');\r\n * isEven(3); // 'Must be even'\r\n * isEven(4); // true\r\n * ```\r\n */\r\nexport const custom = <T = unknown>(\r\n  fn: (value: T) => boolean,\r\n  message: string\r\n): SyncValidator<T> => {\r\n  return (value: T) => (fn(value) ? true : message);\r\n};\r\n\r\n/**\r\n * Creates a custom asynchronous validator.\r\n *\r\n * @param fn - Async predicate that resolves to `true` when valid\r\n * @param message - Error message when the predicate resolves to `false`\r\n * @returns An async validator function\r\n *\r\n * @example\r\n * ```ts\r\n * import { customAsync } from '@bquery/bquery/forms';\r\n * const isUnique = customAsync(\r\n *   async (name: string) => !(await checkExists(name)),\r\n *   'Already taken',\r\n * );\r\n * ```\r\n */\r\nexport const customAsync = <T = unknown>(\r\n  fn: (value: T) => Promise<boolean>,\r\n  message: string\r\n): AsyncValidator<T> => {\r\n  return async (value: T) => ((await fn(value)) ? true : message);\r\n};\r\n"],"mappings":"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"}

package/dist/forms.es.mjs

@@ -0,0 +1,14 @@
+import { a as s, c as m, d as r, i as t, l as e, n, o, r as i, s as c, t as u, u as l } from "./forms-C3yovgH9.js";
+export {
+  r as createForm,
+  u as custom,
+  n as customAsync,
+  i as email,
+  t as max,
+  s as maxLength,
+  o as min,
+  c as minLength,
+  m as pattern,
+  e as required,
+  l as url
+};

package/dist/full.d.ts

@@ -35,20 +35,48 @@
  * ```
  */
 export { $, $$, BQueryCollection, BQueryElement, utils } from './core/index';
+export type { BQueryUtils } from './core/index';
 export { Computed, Signal, batch, computed, createUseFetch, effect, isComputed, isSignal, linkedSignal, persistedSignal, readonly, signal, useAsyncData, useFetch, untrack, watch, } from './reactive/index';
 export type { AsyncDataState, AsyncDataStatus, AsyncWatchSource, CleanupFn, FetchInput, LinkedSignal, Observer, ReadonlySignal, UseAsyncDataOptions, UseFetchOptions, } from './reactive/index';
-export { component, html, registerDefaultComponents, safeHtml } from './component/index';
-export type { ComponentDefinition, DefaultComponentLibraryOptions, PropDefinition, RegisteredDefaultComponents, } from './component/index';
-export { animate, capturePosition, easeInCubic, easeInOutCubic, easeInOutQuad, easeInQuad, easeOutBack, easeOutCubic, easeOutExpo, easeOutQuad, easingPresets, flip, flipElements, flipList, keyframePresets, linear, prefersReducedMotion, scrollAnimate, sequence, spring, springPresets, stagger, timeline, transition, } from './motion/index';
-export type { AnimateOptions, EasingFunction, ElementBounds, FlipGroupOptions, FlipOptions, ScrollAnimateCleanup, ScrollAnimateOptions, SequenceOptions, SequenceStep, Spring, SpringConfig, StaggerFunction, StaggerOptions, TimelineConfig, TimelineControls, TimelineStep, TransitionOptions, } from './motion/index';
-export { createTrustedHtml, escapeHtml, generateNonce, getTrustedTypesPolicy, hasCSPDirective, isTrustedTypesSupported, sanitize, sanitizeHtml, stripTags, } from './security/index';
-export type { SanitizeOptions } from './security/index';
+export { bool, component, defineComponent, html, registerDefaultComponents, safeHtml, useComputed, useEffect, useSignal, } from './component/index';
+export type { AttributeChange, ComponentDefinition, ComponentRenderContext, ComponentStateKey, ComponentSignalLike, ComponentSignals, DefaultComponentLibraryOptions, PropDefinition, RegisteredDefaultComponents, ShadowMode, } from './component/index';
+export { animate, capturePosition, easeInCubic, easeInOutCubic, easeInOutQuad, easeInQuad, easeOutBack, easeOutCubic, easeOutExpo, easeOutQuad, easingPresets, flip, flipElements, flipList, keyframePresets, linear, morphElement, parallax, prefersReducedMotion, scrollAnimate, sequence, setReducedMotion, spring, springPresets, stagger, timeline, transition, typewriter, } from './motion/index';
+export type { AnimateOptions, EasingFunction, ElementBounds, FlipGroupOptions, FlipOptions, MorphOptions, ParallaxCleanup, ParallaxOptions, ScrollAnimateCleanup, ScrollAnimateOptions, SequenceOptions, SequenceStep, Spring, SpringConfig, StaggerFunction, StaggerOptions, TimelineConfig, TimelineControls, TimelineStep, TransitionOptions, TypewriterControls, TypewriterOptions, } from './motion/index';
+export { createTrustedHtml, escapeHtml, generateNonce, getTrustedTypesPolicy, hasCSPDirective, isTrustedTypesSupported, sanitize, sanitizeHtml, stripTags, trusted, } from './security/index';
+export type { SanitizedHtml, SanitizeOptions, TrustedHtml } from './security/index';
 export { buckets, cache, defineBqueryConfig, definePageMeta, getBqueryConfig, notifications, storage, useAnnouncer, useCookie, } from './platform/index';
 export type { AnnounceOptions, AnnouncerHandle, Bucket, BqueryConfig, CacheHandle, IndexedDBOptions, NotificationOptions, PageMetaDefinition, StorageAdapter, UseAnnouncerOptions, UseCookieOptions, } from './platform/index';
-export { back, createRouter, currentRoute, forward, interceptLinks, isActive, isActiveSignal, link, navigate, resolve, } from './router/index';
-export type { NavigationGuard, Route, RouteDefinition, Router, RouterOptions, } from './router/index';
+export { back, BqLinkElement, createRouter, currentRoute, forward, interceptLinks, isActive, isActiveSignal, link, navigate, registerBqLink, resolve, useRoute, } from './router/index';
+export type { NavigationGuard, Route, RouteDefinition, Router, RouterOptions, UseRouteReturn, } from './router/index';
 export { createPersistedStore, createStore, destroyStore, getStore, listStores, mapActions, mapState, registerPlugin, } from './store/index';
-export type { StateFactory, Store, StoreDefinition, StorePlugin } from './store/index';
+export type { ActionContext, OnActionCallback, PersistedStoreOptions, StateFactory, StorageBackend, Store, StoreDefinition, StorePlugin, StoreSerializer, } from './store/index';
 export { createTemplate, mount } from './view/index';
 export type { BindingContext, MountOptions, View } from './view/index';
+export { createForm, custom, customAsync, email, max, maxLength, min, minLength, pattern, required, url, } from './forms/index';
+export type { AsyncValidator, CrossFieldValidator, FieldConfig, Form, FormConfig, FormErrors, FormField, FormFields, SubmitHandler, SyncValidator, ValidationResult, Validator, } from './forms/index';
+export { createI18n, formatDate, formatNumber } from './i18n/index';
+export type { DateFormatOptions, I18nConfig, I18nInstance, LocaleLoader, LocaleMessages, Messages, NumberFormatOptions, TranslateParams, } from './i18n/index';
+export { announceToScreenReader, auditA11y, clearAnnouncements, getFocusableElements, prefersColorScheme, prefersContrast, releaseFocus, rovingTabIndex, skipLink, trapFocus, } from './a11y/index';
+export type { AnnouncePriority, AuditFinding, AuditResult, AuditSeverity, ColorScheme, ContrastPreference, FocusTrapHandle, RovingTabIndexHandle, RovingTabIndexOptions, SkipLinkHandle, SkipLinkOptions, TrapFocusOptions, } from './a11y/index';
+export { draggable } from './dnd/index';
+export { droppable } from './dnd/index';
+export { sortable } from './dnd/index';
+export type { BoundsRect, DragAxis, DragBounds, DragEventData, DragPosition, DraggableHandle, DraggableOptions, DropEventData, DroppableHandle, DroppableOptions, SortEventData, SortableHandle, SortableOptions, } from './dnd/index';
+export { mediaQuery } from './media/index';
+export { breakpoints } from './media/index';
+export { useViewport } from './media/index';
+export { useNetworkStatus } from './media/index';
+export { useBattery } from './media/index';
+export { useGeolocation } from './media/index';
+export { useDeviceMotion, useDeviceOrientation } from './media/index';
+export { clipboard } from './media/index';
+export type { BatteryState, BreakpointMap, ClipboardAPI, DeviceMotionState, DeviceOrientationState, GeolocationOptions, GeolocationState, NetworkState, ViewportState, } from './media/index';
+export { use, isInstalled, getInstalledPlugins, getCustomDirective, getCustomDirectives, resetPlugins, } from './plugin/index';
+export type { BQueryPlugin, CustomDirective, CustomDirectiveHandler, PluginInstallContext, } from './plugin/index';
+export { enableDevtools, isDevtoolsEnabled, trackSignal, untrackSignal, generateSignalLabel, inspectSignals, inspectStores, inspectComponents, recordEvent, getTimeline, clearTimeline, getDevtoolsState, logSignals, logStores, logComponents, logTimeline, } from './devtools/index';
+export type { ComponentSnapshot, DevtoolsOptions, DevtoolsState, SignalSnapshot, StoreSnapshot, TimelineEntry, TimelineEventType, } from './devtools/index';
+export { renderComponent, flushEffects, mockSignal, mockRouter, fireEvent, waitFor, } from './testing/index';
+export type { FireEventOptions, MockRouter, MockRouterOptions, MockSignal, RenderComponentOptions, RenderResult, TestRoute, WaitForOptions, } from './testing/index';
+export { renderToString, hydrateMount, serializeStoreState, deserializeStoreState, hydrateStore, hydrateStores, } from './ssr/index';
+export type { DeserializedStoreState, HydrateMountOptions, HydrationOptions, RenderOptions, SSRResult, SerializeOptions, SerializeResult, } from './ssr/index';
 //# sourceMappingURL=full.d.ts.map