feat(forms, component): expand into batteries-included tier (1.13.0) - #95

Turns @bquery/bquery/forms and @bquery/bquery/component from solid building blocks into a true batteries-included tier — covering everything users typically reach for — while preserving zero deps, tree-shakeability, and the core → reactive → view/forms/component dependency rule.

Forms (src/forms/*)

• Validators: integer, numeric, between, length, oneOf, notOneOf, arrayOf, requiredIf, requiredUnless, dateAfter, dateBefore, validDate, fileSize, fileType (validDate renamed from the planned isDate to avoid collision with the existing core type guard), plus combinators compose, all, not, withMessage.
• Field state: lifted isValidating/isFocused/dirtySince onto every FormField; added focus/blur, setValue(v, { touch, validate, silent }), setError/clearError, a disabled signal that excludes the field from validation, per-field validateOn/debounceMs, and parse/format on FieldConfig.
• Form state: submitCount, lastSubmittedAt, submitError, aggregated isValidating/isPristine, touchAll/untouchAll, resetField, resetErrors, getDirtyValues, subscribe, plus onSubmitError/onSubmitSuccess/validationStrategy/mode: 'all' | 'first' on FormConfig.
• Field arrays: createFieldArray({ initial, factory, validators }) with add/remove/move/insert/clear.
• DOM bindings: bindField and bindForm (auto-discovers [name], wires submit, marks aria-invalid, configurable errorSlot mapper); both return cleanup.
• Composables: scope-aware useForm/useField/useFieldArray that auto-dispose with the owning component.
• Schema: fluent schema({ name: field<string>().required().min(2), … }) over the existing validator factories.
• Serialization & SSR: form.toJSON/toFormData/snapshot/restore, plus serializeFormState/readSerializedFormState/hydrateForm built on src/ssr/escape.ts.

Component (src/component/*)

• Refs & slots: useRef<T>() (auto-cleared on disconnect), useSlot (reactive Signal<Element[]>), hasSlot, slotText.
• Delegated events: on/onClick/onInput/onChange/onSubmit + bindDelegatedEvents(host). Handlers live in a module map keyed by opaque IDs; templates only carry data-bq-on-<event>="<id>", so no eval, no inline on*, and the existing sanitizer accepts the markup unchanged. One delegated listener per event type per host.
• DI: provide/inject/injectionKey<T>() over the composed event path; ships a built-in formContextKey.
• Lifecycle: additive beforeUnmount, errorBoundary(error, info) returning fallback markup, scope-tracked whenIdle(fn).
• Async: useAsync(fn) → { data, error, loading, refresh } with AbortController cancellation on disconnect or re-invocation.
• Reactive props: instance setProp(name, value)/getProp(name) for objects/arrays/callbacks that bypass attribute serialization and trigger a re-render.
• Styles: css tagged template returning a ComponentStyles payload, shared across instances via document.adoptedStyleSheets when constructable stylesheets are available (falls back to <style>); interpolations are CSS-escaped.
• Keyed lists: keyedList(items, key, renderItem) injects data-bq-key into the first opening tag of each item; reconcileKeyed(container) reorders existing children to match key order.

Example

import { component, html, css, useRef, useAsync, onClick, provide, injectionKey } from '@bquery/bquery/component';
import { useForm, required, email, between, schema, field, bindForm } from '@bquery/bquery/forms';

const ThemeKey = injectionKey<{ dark: boolean }>('theme');

component('signup-form', {
  styles: css`:host { display: block; } .err { color: crimson; }`,
  connected() {
    provide(this, ThemeKey, { dark: true });

    const form = useForm({
      fields: schema({
        name:  field<string>().required().min(2),
        email: field<string>().required().email(),
        age:   field<number>().required().integer().between(18, 120),
      }),
      validationStrategy: 'onBlur',
      mode: 'all',
      onSubmit: async (values) => fetch('/api/signup', { method: 'POST', body: JSON.stringify(values) }),
      onSubmitError: (err) => console.error(err),
    });

    queueMicrotask(() => bindForm(form, this.shadowRoot!.querySelector('form')!));
  },
  render: () => html`
    <form>
      <input name="name"  /> <span data-bq-error-for="name"  class="err"></span>
      <input name="email" /> <span data-bq-error-for="email" class="err"></span>
      <input name="age" type="number" /> <span data-bq-error-for="age" class="err"></span>
      <button type="submit">Sign up</button>
    </form>
  `,
});

Wiring & docs

• src/full.ts and both module barrels re-export every new runtime + type surface; bun run check:full-bundle continues to enforce drift detection.
• New test files: tests/forms-extensions.test.ts, tests/component-extensions.test.ts.
• docs/guide/forms.md and docs/guide/components.md extended with “What's new in 1.13.0” sections.
• Bumped to 1.13.0; AGENT.md, llms.txt, copilot-instructions, .cursorrules, .clinerules, README, and CHANGELOG synced (bun run check:ai-guidance passes).

Notes for reviewers

• All additions are backwards-compatible; existing forms and components keep working unchanged. The single behavioral touch outside new files is restoring the pre-existing component hasMounted semantics after adding beforeUnmount — covered by the existing reconnect tests.
• The forms validator helpers compose/all/not/withMessage/arrayOf cast their return to Validator<T> because the type is a SyncValidator | AsyncValidator union and a single function value cannot inhabit both members of the union purely structurally; runtime behavior is correct in both modes.
• Delegated events rely on data-bq-* data attributes that the default sanitizer already permits; no sanitizer changes were needed.