npm - @pyreon/form - Versions diffs - 0.11.5 → 0.11.7 - Mend

@pyreon/form 0.11.5 → 0.11.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +89 -89
package/lib/devtools.js.map +1 -1
package/lib/index.js.map +1 -1
package/lib/types/index.d.ts +3 -3
package/package.json +16 -16
package/src/context.ts +5 -5
package/src/devtools.ts +6 -6
package/src/index.ts +10 -13
package/src/tests/devtools.test.ts +53 -53
package/src/tests/form-additional.test.tsx +117 -117
package/src/tests/form.test.tsx +374 -374
package/src/types.ts +3 -3
package/src/use-field-array.ts +2 -2
package/src/use-field.ts +4 -4
package/src/use-form-state.ts +3 -3
package/src/use-form.ts +16 -16
package/src/use-watch.ts +3 -3

package/README.md CHANGED Viewed

@@ -11,25 +11,25 @@ bun add @pyreon/form
 ## Quick Start
 ```tsx
-import { useForm } from "@pyreon/form"
+import { useForm } from '@pyreon/form'
 function LoginForm() {
   const form = useForm({
-    initialValues: { email: "", password: "" },
+    initialValues: { email: '', password: '' },
     validators: {
-      email: (v) => (!v.includes("@") ? "Invalid email" : undefined),
-      password: (v) => (v.length < 8 ? "Too short" : undefined),
+      email: (v) => (!v.includes('@') ? 'Invalid email' : undefined),
+      password: (v) => (v.length < 8 ? 'Too short' : undefined),
     },
-    validateOn: "blur",
+    validateOn: 'blur',
     onSubmit: async (values) => {
-      await fetch("/api/login", { method: "POST", body: JSON.stringify(values) })
+      await fetch('/api/login', { method: 'POST', body: JSON.stringify(values) })
     },
   })
   return () => (
     <form onSubmit={form.handleSubmit}>
-      <input type="email" {...form.register("email")} />
-      <input type="password" {...form.register("password")} />
+      <input type="email" {...form.register('email')} />
+      <input type="password" {...form.register('password')} />
       <button type="submit">Login</button>
     </form>
   )
@@ -42,37 +42,37 @@ function LoginForm() {
 Create a reactive form instance with field states, validation, and submission handling.
-| Parameter | Type | Description |
-| --- | --- | --- |
-| `options.initialValues` | `TValues` | Initial values for each field |
-| `options.onSubmit` | `(values: TValues) => void \| Promise<void>` | Called with validated values on submit |
-| `options.validators` | `Partial<Record<keyof TValues, ValidateFn>>` | Per-field validators (receives value + all values) |
-| `options.schema` | `SchemaValidateFn<TValues>` | Schema-level validator (runs after field validators) |
-| `options.validateOn` | `"blur" \| "change" \| "submit"` | When to trigger validation (default: `"blur"`) |
-| `options.debounceMs` | `number` | Debounce delay for validators in ms |
+| Parameter               | Type                                         | Description                                          |
+| ----------------------- | -------------------------------------------- | ---------------------------------------------------- |
+| `options.initialValues` | `TValues`                                    | Initial values for each field                        |
+| `options.onSubmit`      | `(values: TValues) => void \| Promise<void>` | Called with validated values on submit               |
+| `options.validators`    | `Partial<Record<keyof TValues, ValidateFn>>` | Per-field validators (receives value + all values)   |
+| `options.schema`        | `SchemaValidateFn<TValues>`                  | Schema-level validator (runs after field validators) |
+| `options.validateOn`    | `"blur" \| "change" \| "submit"`             | When to trigger validation (default: `"blur"`)       |
+| `options.debounceMs`    | `number`                                     | Debounce delay for validators in ms                  |
 **Returns:** `FormState<TValues>` with these properties:
-| Property | Type | Description |
-| --- | --- | --- |
-| `fields` | `Record<keyof TValues, FieldState>` | Individual field states |
-| `isSubmitting` | `Signal<boolean>` | Whether the form is being submitted |
-| `isValidating` | `Signal<boolean>` | Whether async validation is running |
-| `isValid` | `Accessor<boolean>` | Whether all fields pass validation |
-| `isDirty` | `Accessor<boolean>` | Whether any field differs from initial |
-| `submitCount` | `Signal<number>` | Number of submission attempts |
-| `submitError` | `Signal<unknown>` | Error thrown by `onSubmit` |
-| `values()` | `() => TValues` | Get all current values |
-| `errors()` | `() => Record<keyof TValues, string>` | Get all current errors |
-| `register(field, opts?)` | `Function` | Bind an input to a field |
-| `handleSubmit(e?)` | `(e?: Event) => Promise<void>` | Submit handler |
-| `validate()` | `() => Promise<boolean>` | Validate all fields |
-| `reset()` | `() => void` | Reset all fields to initial values |
-| `setFieldValue(field, value)` | `Function` | Set a single field's value |
-| `setFieldError(field, error)` | `Function` | Set a single field's error |
-| `setErrors(errors)` | `Function` | Set multiple field errors |
-| `clearErrors()` | `() => void` | Clear all errors |
-| `resetField(field)` | `Function` | Reset a single field |
+| Property                      | Type                                  | Description                            |
+| ----------------------------- | ------------------------------------- | -------------------------------------- |
+| `fields`                      | `Record<keyof TValues, FieldState>`   | Individual field states                |
+| `isSubmitting`                | `Signal<boolean>`                     | Whether the form is being submitted    |
+| `isValidating`                | `Signal<boolean>`                     | Whether async validation is running    |
+| `isValid`                     | `Accessor<boolean>`                   | Whether all fields pass validation     |
+| `isDirty`                     | `Accessor<boolean>`                   | Whether any field differs from initial |
+| `submitCount`                 | `Signal<number>`                      | Number of submission attempts          |
+| `submitError`                 | `Signal<unknown>`                     | Error thrown by `onSubmit`             |
+| `values()`                    | `() => TValues`                       | Get all current values                 |
+| `errors()`                    | `() => Record<keyof TValues, string>` | Get all current errors                 |
+| `register(field, opts?)`      | `Function`                            | Bind an input to a field               |
+| `handleSubmit(e?)`            | `(e?: Event) => Promise<void>`        | Submit handler                         |
+| `validate()`                  | `() => Promise<boolean>`              | Validate all fields                    |
+| `reset()`                     | `() => void`                          | Reset all fields to initial values     |
+| `setFieldValue(field, value)` | `Function`                            | Set a single field's value             |
+| `setFieldError(field, error)` | `Function`                            | Set a single field's error             |
+| `setErrors(errors)`           | `Function`                            | Set multiple field errors              |
+| `clearErrors()`               | `() => void`                          | Clear all errors                       |
+| `resetField(field)`           | `Function`                            | Reset a single field                   |
 ```tsx
 const form = useForm({
@@ -94,20 +94,20 @@ const form = useForm({
 Extract a single field's state with computed helpers. Useful for building isolated field components.
-| Parameter | Type | Description |
-| --- | --- | --- |
-| `form` | `FormState<TValues>` | Form instance from `useForm` |
-| `name` | `keyof TValues & string` | Field name |
+| Parameter | Type                     | Description                  |
+| --------- | ------------------------ | ---------------------------- |
+| `form`    | `FormState<TValues>`     | Form instance from `useForm` |
+| `name`    | `keyof TValues & string` | Field name                   |
 **Returns:** `UseFieldResult<T>` with `value`, `error`, `touched`, `dirty`, `setValue`, `setTouched`, `reset`, `register`, `hasError` (Computed), `showError` (Computed: touched AND has error).
 ```tsx
 function EmailField({ form }) {
-  const field = useField(form, "email")
+  const field = useField(form, 'email')
   return () => (
     <div>
       <input {...field.register()} />
-      {() => field.showError() ? <span>{field.error()}</span> : null}
+      {() => (field.showError() ? <span>{field.error()}</span> : null)}
     </div>
   )
 }
@@ -117,44 +117,44 @@ function EmailField({ form }) {
 Manage a dynamic array of form fields with stable keys for keyed rendering.
-| Parameter | Type | Description |
-| --- | --- | --- |
+| Parameter | Type  | Description                          |
+| --------- | ----- | ------------------------------------ |
 | `initial` | `T[]` | Initial array values (default: `[]`) |
 **Returns:** `UseFieldArrayResult<T>` with:
-| Property | Type | Description |
-| --- | --- | --- |
-| `items` | `Signal<FieldArrayItem<T>[]>` | Reactive list with `{ key, value }` items |
-| `length` | `Computed<number>` | Number of items |
-| `append(value)` | `(value: T) => void` | Add to end |
-| `prepend(value)` | `(value: T) => void` | Add to start |
-| `insert(index, value)` | `Function` | Insert at index |
-| `remove(index)` | `(index: number) => void` | Remove at index |
-| `update(index, value)` | `Function` | Update item at index |
-| `move(from, to)` | `Function` | Move item between indices |
-| `swap(a, b)` | `Function` | Swap two items |
-| `replace(values)` | `(values: T[]) => void` | Replace all items |
-| `values()` | `() => T[]` | Get current values as plain array |
+| Property               | Type                          | Description                               |
+| ---------------------- | ----------------------------- | ----------------------------------------- |
+| `items`                | `Signal<FieldArrayItem<T>[]>` | Reactive list with `{ key, value }` items |
+| `length`               | `Computed<number>`            | Number of items                           |
+| `append(value)`        | `(value: T) => void`          | Add to end                                |
+| `prepend(value)`       | `(value: T) => void`          | Add to start                              |
+| `insert(index, value)` | `Function`                    | Insert at index                           |
+| `remove(index)`        | `(index: number) => void`     | Remove at index                           |
+| `update(index, value)` | `Function`                    | Update item at index                      |
+| `move(from, to)`       | `Function`                    | Move item between indices                 |
+| `swap(a, b)`           | `Function`                    | Swap two items                            |
+| `replace(values)`      | `(values: T[]) => void`       | Replace all items                         |
+| `values()`             | `() => T[]`                   | Get current values as plain array         |
 ```ts
-const tags = useFieldArray<string>(["typescript"])
-tags.append("pyreon")
-tags.items()  // [{ key: 0, value: Signal("typescript") }, { key: 1, value: Signal("pyreon") }]
+const tags = useFieldArray<string>(['typescript'])
+tags.append('pyreon')
+tags.items() // [{ key: 0, value: Signal("typescript") }, { key: 1, value: Signal("pyreon") }]
 ```
 ### `useWatch(form, name?)`
 Watch specific field values reactively.
-| Signature | Returns |
-| --- | --- |
-| `useWatch(form, "email")` | `Signal<string>` — single field value |
+| Signature                           | Returns                                     |
+| ----------------------------------- | ------------------------------------------- |
+| `useWatch(form, "email")`           | `Signal<string>` — single field value       |
 | `useWatch(form, ["first", "last"])` | `[Signal, Signal]` — tuple of field signals |
-| `useWatch(form)` | `Computed<TValues>` — all fields as object |
+| `useWatch(form)`                    | `Computed<TValues>` — all fields as object  |
 ```ts
-const email = useWatch(form, "email")
+const email = useWatch(form, 'email')
 // email() re-evaluates reactively when the email field changes
 const all = useWatch(form)
@@ -165,9 +165,9 @@ const all = useWatch(form)
 Subscribe to the full form state as a computed signal. Optionally pass a selector for fine-grained reactivity.
-| Parameter | Type | Description |
-| --- | --- | --- |
-| `form` | `FormState<TValues>` | Form instance |
+| Parameter  | Type                             | Description                  |
+| ---------- | -------------------------------- | ---------------------------- |
+| `form`     | `FormState<TValues>`             | Form instance                |
 | `selector` | `(state: FormStateSummary) => R` | Optional projection function |
 **Returns:** `Computed<FormStateSummary>` or `Computed<R>` when using a selector.
@@ -176,10 +176,10 @@ Subscribe to the full form state as a computed signal. Optionally pass a selecto
 ```ts
 const state = useFormState(form)
-state().isValid  // boolean
+state().isValid // boolean
 const canSubmit = useFormState(form, (s) => s.isValid && !s.isSubmitting)
-canSubmit()  // boolean
+canSubmit() // boolean
 ```
 ### `FormProvider` / `useFormContext()`
@@ -188,14 +188,14 @@ Context pattern for sharing a form instance with nested components.
 ```tsx
 // Parent:
-<FormProvider form={form}>
+;<FormProvider form={form}>
   <EmailField />
 </FormProvider>
 // Child:
 function EmailField() {
   const form = useFormContext<{ email: string }>()
-  return () => <input {...form.register("email")} />
+  return () => <input {...form.register('email')} />
 }
 ```
@@ -207,12 +207,12 @@ Use `setErrors()` to apply errors returned from your API.
 ```ts
 const form = useForm({
-  initialValues: { email: "" },
+  initialValues: { email: '' },
   onSubmit: async (values) => {
-    const res = await fetch("/api/register", { method: "POST", body: JSON.stringify(values) })
+    const res = await fetch('/api/register', { method: 'POST', body: JSON.stringify(values) })
     if (!res.ok) {
       const errors = await res.json()
-      form.setErrors(errors)  // { email: "Already taken" }
+      form.setErrors(errors) // { email: "Already taken" }
     }
   },
 })
@@ -235,20 +235,20 @@ const form = useForm({
 ## Types
-| Type | Description |
-| --- | --- |
-| `Accessor<T>` | `Signal<T> \| Computed<T>` — a readable reactive value |
-| `FormState<TValues>` | Full form instance returned by `useForm` |
-| `FieldState<T>` | Per-field state: `value`, `error`, `touched`, `dirty`, `setValue`, `setTouched`, `reset` |
-| `FieldRegisterProps<T>` | Props returned by `register()`: `value`, `onInput`, `onBlur`, `checked?` |
-| `UseFormOptions<TValues>` | Options for `useForm` |
-| `ValidateFn<T, TValues>` | `(value: T, allValues: TValues) => ValidationError \| Promise<ValidationError>` |
-| `SchemaValidateFn<TValues>` | `(values: TValues) => Record<keyof TValues, string>` |
-| `ValidationError` | `string \| undefined` |
-| `FieldArrayItem<T>` | `{ key: number, value: Signal<T> }` |
-| `UseFieldArrayResult<T>` | Return type of `useFieldArray` |
-| `UseFieldResult<T>` | Return type of `useField` |
-| `FormStateSummary<TValues>` | Snapshot object returned by `useFormState` |
+| Type                        | Description                                                                              |
+| --------------------------- | ---------------------------------------------------------------------------------------- |
+| `Accessor<T>`               | `Signal<T> \| Computed<T>` — a readable reactive value                                   |
+| `FormState<TValues>`        | Full form instance returned by `useForm`                                                 |
+| `FieldState<T>`             | Per-field state: `value`, `error`, `touched`, `dirty`, `setValue`, `setTouched`, `reset` |
+| `FieldRegisterProps<T>`     | Props returned by `register()`: `value`, `onInput`, `onBlur`, `checked?`                 |
+| `UseFormOptions<TValues>`   | Options for `useForm`                                                                    |
+| `ValidateFn<T, TValues>`    | `(value: T, allValues: TValues) => ValidationError \| Promise<ValidationError>`          |
+| `SchemaValidateFn<TValues>` | `(values: TValues) => Record<keyof TValues, string>`                                     |
+| `ValidationError`           | `string \| undefined`                                                                    |
+| `FieldArrayItem<T>`         | `{ key: number, value: Signal<T> }`                                                      |
+| `UseFieldArrayResult<T>`    | Return type of `useFieldArray`                                                           |
+| `UseFieldResult<T>`         | Return type of `useField`                                                                |
+| `FormStateSummary<TValues>` | Snapshot object returned by `useFormState`                                               |
 ## Gotchas

package/lib/devtools.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/*\n @pyreon/form devtools introspection API.\n * Import: `import { ... } from \"@pyreon/form/devtools\"`\n /\n\nconst _activeForms = new Map<string, WeakRef<object>>()\nconst _listeners = new Set<() => void>()\n\nfunction _notify(): void {\n for (const listener of _listeners) listener()\n}\n\n/\n Register a form instance for devtools inspection.\n \n @example\n * const form = useForm({ ... })\n * registerForm(\"login-form\", form)\n /\nexport function registerForm(name: string, form: object): void {\n _activeForms.set(name, new WeakRef(form))\n _notify()\n}\n\n/* Unregister a form instance. /\nexport function unregisterForm(name: string): void {\n _activeForms.delete(name)\n _notify()\n}\n\n/* Get all registered form names. Cleans up garbage-collected instances. /\nexport function getActiveForms(): string[] {\n for (const [name, ref] of _activeForms) {\n if (ref.deref() === undefined) _activeForms.delete(name)\n }\n return [..._activeForms.keys()]\n}\n\n/* Get a form instance by name (or undefined if GC'd or not registered). /\nexport function getFormInstance(name: string): object \| undefined {\n const ref = _activeForms.get(name)\n if (!ref) return undefined\n const instance = ref.deref()\n if (!instance) {\n _activeForms.delete(name)\n return undefined\n }\n return instance\n}\n\n/\n Get a snapshot of a registered form's current state.\n * Returns values, errors, and form-level status signals.\n /\nexport function getFormSnapshot(name: string): Record<string, unknown> \| undefined {\n const form = getFormInstance(name) as Record<string, unknown> \| undefined\n if (!form) return undefined\n return {\n values: typeof form.values === \"function\" ? (form.values as () => unknown)() : undefined,\n errors: typeof form.errors === \"function\" ? (form.errors as () => unknown)() : undefined,\n isSubmitting:\n typeof form.isSubmitting === \"function\" ? (form.isSubmitting as () => unknown)() : undefined,\n isValid: typeof form.isValid === \"function\" ? (form.isValid as () => unknown)() : undefined,\n isDirty: typeof form.isDirty === \"function\" ? (form.isDirty as () => unknown)() : undefined,\n submitCount:\n typeof form.submitCount === \"function\" ? (form.submitCount as () => unknown)() : undefined,\n }\n}\n\n/* Subscribe to form registry changes. Returns unsubscribe function. /\nexport function onFormChange(listener: () => void): () => void {\n _listeners.add(listener)\n return () => {\n _listeners.delete(listener)\n }\n}\n\n/* @internal — reset devtools registry (for tests). */\nexport function _resetDevtools(): void {\n _activeForms.clear()\n _listeners.clear()\n}\n"],"mappings":";;;;;AAKA,MAAM,+BAAe,IAAI,KAA8B;AACvD,MAAM,6BAAa,IAAI,KAAiB;AAExC,SAAS,UAAgB;AACvB,MAAK,MAAM,YAAY,WAAY,WAAU;;;;;;;;;AAU/C,SAAgB,aAAa,MAAc,MAAoB;AAC7D,cAAa,IAAI,MAAM,IAAI,QAAQ,KAAK,CAAC;AACzC,UAAS;;;AAIX,SAAgB,eAAe,MAAoB;AACjD,cAAa,OAAO,KAAK;AACzB,UAAS;;;AAIX,SAAgB,iBAA2B;AACzC,MAAK,MAAM,CAAC,MAAM,QAAQ,aACxB,KAAI,IAAI,OAAO,KAAK,OAAW,cAAa,OAAO,KAAK;AAE1D,QAAO,CAAC,GAAG,aAAa,MAAM,CAAC;;;AAIjC,SAAgB,gBAAgB,MAAkC;CAChE,MAAM,MAAM,aAAa,IAAI,KAAK;AAClC,KAAI,CAAC,IAAK,QAAO;CACjB,MAAM,WAAW,IAAI,OAAO;AAC5B,KAAI,CAAC,UAAU;AACb,eAAa,OAAO,KAAK;AACzB;;AAEF,QAAO;;;;;;AAOT,SAAgB,gBAAgB,MAAmD;CACjF,MAAM,OAAO,gBAAgB,KAAK;AAClC,KAAI,CAAC,KAAM,QAAO;AAClB,QAAO;EACL,QAAQ,OAAO,KAAK,WAAW,aAAc,KAAK,QAA0B,GAAG;EAC/E,QAAQ,OAAO,KAAK,WAAW,aAAc,KAAK,QAA0B,GAAG;EAC/E,cACE,OAAO,KAAK,iBAAiB,aAAc,KAAK,cAAgC,GAAG;EACrF,SAAS,OAAO,KAAK,YAAY,aAAc,KAAK,SAA2B,GAAG;EAClF,SAAS,OAAO,KAAK,YAAY,aAAc,KAAK,SAA2B,GAAG;EAClF,aACE,OAAO,KAAK,gBAAgB,aAAc,KAAK,aAA+B,GAAG;EACpF;;;AAIH,SAAgB,aAAa,UAAkC;AAC7D,YAAW,IAAI,SAAS;AACxB,cAAa;AACX,aAAW,OAAO,SAAS;;;;AAK/B,SAAgB,iBAAuB;AACrC,cAAa,OAAO;AACpB,YAAW,OAAO"}
1	+ {"version":3,"file":"devtools.js","names":[],"sources":["../src/devtools.ts"],"sourcesContent":["/*\n @pyreon/form devtools introspection API.\n * Import: `import { ... } from \"@pyreon/form/devtools\"`\n /\n\nconst _activeForms = new Map<string, WeakRef<object>>()\nconst _listeners = new Set<() => void>()\n\nfunction _notify(): void {\n for (const listener of _listeners) listener()\n}\n\n/\n Register a form instance for devtools inspection.\n \n @example\n * const form = useForm({ ... })\n * registerForm(\"login-form\", form)\n /\nexport function registerForm(name: string, form: object): void {\n _activeForms.set(name, new WeakRef(form))\n _notify()\n}\n\n/* Unregister a form instance. /\nexport function unregisterForm(name: string): void {\n _activeForms.delete(name)\n _notify()\n}\n\n/* Get all registered form names. Cleans up garbage-collected instances. /\nexport function getActiveForms(): string[] {\n for (const [name, ref] of _activeForms) {\n if (ref.deref() === undefined) _activeForms.delete(name)\n }\n return [..._activeForms.keys()]\n}\n\n/* Get a form instance by name (or undefined if GC'd or not registered). /\nexport function getFormInstance(name: string): object \| undefined {\n const ref = _activeForms.get(name)\n if (!ref) return undefined\n const instance = ref.deref()\n if (!instance) {\n _activeForms.delete(name)\n return undefined\n }\n return instance\n}\n\n/\n Get a snapshot of a registered form's current state.\n * Returns values, errors, and form-level status signals.\n /\nexport function getFormSnapshot(name: string): Record<string, unknown> \| undefined {\n const form = getFormInstance(name) as Record<string, unknown> \| undefined\n if (!form) return undefined\n return {\n values: typeof form.values === 'function' ? (form.values as () => unknown)() : undefined,\n errors: typeof form.errors === 'function' ? (form.errors as () => unknown)() : undefined,\n isSubmitting:\n typeof form.isSubmitting === 'function' ? (form.isSubmitting as () => unknown)() : undefined,\n isValid: typeof form.isValid === 'function' ? (form.isValid as () => unknown)() : undefined,\n isDirty: typeof form.isDirty === 'function' ? (form.isDirty as () => unknown)() : undefined,\n submitCount:\n typeof form.submitCount === 'function' ? (form.submitCount as () => unknown)() : undefined,\n }\n}\n\n/* Subscribe to form registry changes. Returns unsubscribe function. /\nexport function onFormChange(listener: () => void): () => void {\n _listeners.add(listener)\n return () => {\n _listeners.delete(listener)\n }\n}\n\n/* @internal — reset devtools registry (for tests). */\nexport function _resetDevtools(): void {\n _activeForms.clear()\n _listeners.clear()\n}\n"],"mappings":";;;;;AAKA,MAAM,+BAAe,IAAI,KAA8B;AACvD,MAAM,6BAAa,IAAI,KAAiB;AAExC,SAAS,UAAgB;AACvB,MAAK,MAAM,YAAY,WAAY,WAAU;;;;;;;;;AAU/C,SAAgB,aAAa,MAAc,MAAoB;AAC7D,cAAa,IAAI,MAAM,IAAI,QAAQ,KAAK,CAAC;AACzC,UAAS;;;AAIX,SAAgB,eAAe,MAAoB;AACjD,cAAa,OAAO,KAAK;AACzB,UAAS;;;AAIX,SAAgB,iBAA2B;AACzC,MAAK,MAAM,CAAC,MAAM,QAAQ,aACxB,KAAI,IAAI,OAAO,KAAK,OAAW,cAAa,OAAO,KAAK;AAE1D,QAAO,CAAC,GAAG,aAAa,MAAM,CAAC;;;AAIjC,SAAgB,gBAAgB,MAAkC;CAChE,MAAM,MAAM,aAAa,IAAI,KAAK;AAClC,KAAI,CAAC,IAAK,QAAO;CACjB,MAAM,WAAW,IAAI,OAAO;AAC5B,KAAI,CAAC,UAAU;AACb,eAAa,OAAO,KAAK;AACzB;;AAEF,QAAO;;;;;;AAOT,SAAgB,gBAAgB,MAAmD;CACjF,MAAM,OAAO,gBAAgB,KAAK;AAClC,KAAI,CAAC,KAAM,QAAO;AAClB,QAAO;EACL,QAAQ,OAAO,KAAK,WAAW,aAAc,KAAK,QAA0B,GAAG;EAC/E,QAAQ,OAAO,KAAK,WAAW,aAAc,KAAK,QAA0B,GAAG;EAC/E,cACE,OAAO,KAAK,iBAAiB,aAAc,KAAK,cAAgC,GAAG;EACrF,SAAS,OAAO,KAAK,YAAY,aAAc,KAAK,SAA2B,GAAG;EAClF,SAAS,OAAO,KAAK,YAAY,aAAc,KAAK,SAA2B,GAAG;EAClF,aACE,OAAO,KAAK,gBAAgB,aAAc,KAAK,aAA+B,GAAG;EACpF;;;AAIH,SAAgB,aAAa,UAAkC;AAC7D,YAAW,IAAI,SAAS;AACxB,cAAa;AACX,aAAW,OAAO,SAAS;;;;AAK/B,SAAgB,iBAAuB;AACrC,cAAa,OAAO;AACpB,YAAW,OAAO"}

package/lib/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","names":[],"sources":["../src/context.ts","../src/use-field.ts","../src/use-field-array.ts","../src/use-form.ts","../src/use-form-state.ts","../src/use-watch.ts"],"sourcesContent":["import type { Props, VNode, VNodeChild } from \"@pyreon/core\"\nimport { createContext, provide, useContext } from \"@pyreon/core\"\nimport type { FormState } from \"./types\"\n\nconst FormContext = createContext<FormState<Record<string, unknown>> \| null>(null)\n\nexport interface FormProviderProps<TValues extends Record<string, unknown>> extends Props {\n form: FormState<TValues>\n children?: VNodeChild\n}\n\n/*\n Provide a form instance to the component tree so nested components\n * can access it via `useFormContext()`.\n \n @example\n * const form = useForm({ initialValues: { email: '' }, onSubmit: ... })\n \n <FormProvider form={form}>\n * <EmailField />\n * <SubmitButton />\n * </FormProvider>\n /\nexport function FormProvider<TValues extends Record<string, unknown>>(\n props: FormProviderProps<TValues>,\n): VNode {\n provide(FormContext, props.form as FormState<Record<string, unknown>>)\n\n const ch = props.children\n return (typeof ch === \"function\" ? (ch as () => VNodeChild)() : ch) as VNode\n}\n\n/\n Access the form instance from the nearest `FormProvider`.\n * Must be called within a component tree wrapped by `FormProvider`.\n \n @example\n * function EmailField() {\n * const form = useFormContext<{ email: string }>()\n * return <input {...form.register('email')} />\n * }\n /\nexport function useFormContext<\n TValues extends Record<string, unknown> = Record<string, unknown>,\n>(): FormState<TValues> {\n const form = useContext(FormContext)\n if (!form) {\n throw new Error(\"[@pyreon/form] useFormContext() must be used within a <FormProvider>.\")\n }\n // Generic narrowing: context stores FormState<Record<string, unknown>>\n // but callers narrow to their specific TValues at the call site.\n return form as FormState<TValues>\n}\n","import type { Computed, Signal } from \"@pyreon/reactivity\"\nimport { computed } from \"@pyreon/reactivity\"\nimport type { FieldRegisterProps, FieldState, FormState, ValidationError } from \"./types\"\n\nexport interface UseFieldResult<T> {\n /* Current field value (reactive signal). /\n value: Signal<T>\n /* Field error message (reactive signal). /\n error: Signal<ValidationError>\n /* Whether the field has been touched (reactive signal). /\n touched: Signal<boolean>\n /* Whether the field value differs from initial (reactive signal). /\n dirty: Signal<boolean>\n /* Set the field value. /\n setValue: (value: T) => void\n /* Mark the field as touched. /\n setTouched: () => void\n /* Reset the field to its initial value. /\n reset: () => void\n /* Register props for input binding. /\n register: (opts?: { type?: \"checkbox\" }) => FieldRegisterProps<T>\n /* Whether the field has an error (computed). /\n hasError: Computed<boolean>\n /* Whether the field should show its error (touched + has error). /\n showError: Computed<boolean>\n}\n\n/\n Extract a single field's state and helpers from a form instance.\n * Useful for building isolated field components.\n \n @example\n * function EmailField({ form }: { form: FormState<{ email: string }> }) {\n * const field = useField(form, 'email')\n * return (\n * <>\n * <input {...field.register()} />\n * {field.showError() && <span>{field.error()}</span>}\n * </>\n * )\n * }\n /\nexport function useField<TValues extends Record<string, unknown>, K extends keyof TValues & string>(\n form: FormState<TValues>,\n name: K,\n): UseFieldResult<TValues[K]> {\n const fieldState: FieldState<TValues[K]> = form.fields[name]\n\n const hasError = computed(() => fieldState.error() !== undefined)\n const showError = computed(() => fieldState.touched() && hasError())\n\n return {\n value: fieldState.value,\n error: fieldState.error,\n touched: fieldState.touched,\n dirty: fieldState.dirty,\n setValue: fieldState.setValue,\n setTouched: fieldState.setTouched,\n reset: fieldState.reset,\n register: (opts?) => form.register(name, opts),\n hasError,\n showError,\n }\n}\n","import type { Computed, Signal } from \"@pyreon/reactivity\"\nimport { computed, signal } from \"@pyreon/reactivity\"\n\nexport interface FieldArrayItem<T> {\n /* Stable key for keyed rendering. /\n key: number\n /* Reactive value for this item. /\n value: Signal<T>\n}\n\nexport interface UseFieldArrayResult<T> {\n /* Reactive list of items with stable keys. /\n items: Signal<FieldArrayItem<T>[]>\n /* Number of items. /\n length: Computed<number>\n /* Append a new item to the end. /\n append: (value: T) => void\n /* Prepend a new item to the start. /\n prepend: (value: T) => void\n /* Insert an item at the given index. /\n insert: (index: number, value: T) => void\n /* Remove the item at the given index. /\n remove: (index: number) => void\n /* Update the value of an item at the given index. /\n update: (index: number, value: T) => void\n /* Move an item from one index to another. /\n move: (from: number, to: number) => void\n /* Swap two items by index. /\n swap: (indexA: number, indexB: number) => void\n /* Replace all items. /\n replace: (values: T[]) => void\n /* Get all current values as a plain array. /\n values: () => T[]\n}\n\n/\n Manage a dynamic array of form fields with stable keys.\n \n @example\n * const tags = useFieldArray<string>([])\n * tags.append('typescript')\n * tags.append('pyreon')\n * // tags.items() — array of { key, value } for keyed rendering\n /\nexport function useFieldArray<T>(initial: T[] = []): UseFieldArrayResult<T> {\n let nextKey = 0\n const makeItem = (value: T): FieldArrayItem<T> => ({\n key: nextKey++,\n value: signal(value),\n })\n\n const items = signal<FieldArrayItem<T>[]>(initial.map(makeItem))\n const length = computed(() => items().length)\n\n return {\n items,\n length,\n\n append(value: T) {\n items.update((arr) => [...arr, makeItem(value)])\n },\n\n prepend(value: T) {\n items.update((arr) => [makeItem(value), ...arr])\n },\n\n insert(index: number, value: T) {\n items.update((arr) => {\n const next = [...arr]\n next.splice(index, 0, makeItem(value))\n return next\n })\n },\n\n remove(index: number) {\n items.update((arr) => arr.filter((_, i) => i !== index))\n },\n\n update(index: number, value: T) {\n const current = items.peek()\n const item = current[index]\n if (item) {\n item.value.set(value)\n }\n },\n\n move(from: number, to: number) {\n items.update((arr) => {\n const next = [...arr]\n const [item] = next.splice(from, 1)\n if (item) next.splice(to, 0, item)\n return next\n })\n },\n\n swap(indexA: number, indexB: number) {\n items.update((arr) => {\n const next = [...arr]\n const a = next[indexA]\n const b = next[indexB]\n if (a && b) {\n next[indexA] = b\n next[indexB] = a\n }\n return next\n })\n },\n\n replace(values: T[]) {\n items.set(values.map(makeItem))\n },\n\n values() {\n return items.peek().map((item) => item.value.peek())\n },\n }\n}\n","import { onUnmount } from \"@pyreon/core\"\nimport type { Signal } from \"@pyreon/reactivity\"\nimport { computed, effect, signal } from \"@pyreon/reactivity\"\nimport type {\n FieldRegisterProps,\n FieldState,\n FormState,\n UseFormOptions,\n ValidationError,\n} from \"./types\"\n\n/\n Create a signal-based form. Returns reactive field states, form-level\n * signals, and handlers for submit/reset/validate.\n \n @example\n * const form = useForm({\n * initialValues: { email: '', password: '', remember: false },\n * validators: {\n * email: (v) => (!v ? 'Required' : undefined),\n * password: (v, all) => (v.length < 8 ? 'Too short' : undefined),\n * },\n * onSubmit: async (values) => { await login(values) },\n * })\n \n // Bind with register():\n * // h('input', form.register('email'))\n * // h('input', { type: 'checkbox', ...form.register('remember', { type: 'checkbox' }) })\n /\nexport function useForm<TValues extends Record<string, unknown>>(\n options: UseFormOptions<TValues>,\n): FormState<TValues> {\n const { initialValues, onSubmit, validators, schema, validateOn = \"blur\", debounceMs } = options\n\n // Build field states\n const fieldEntries = Object.entries(initialValues) as [\n keyof TValues & string,\n TValues[keyof TValues],\n ][]\n\n const fields = {} as { [K in keyof TValues]: FieldState<TValues[K]> }\n\n // Debounce timers per field (only allocated when debounceMs is set)\n const debounceTimers: Partial<Record<keyof TValues, ReturnType<typeof setTimeout>>> = {}\n\n // Validation version per field — used to discard stale async results\n const validationVersions: Partial<Record<keyof TValues, number>> = {}\n\n // Helper to get all current values (used by cross-field validators)\n const getValues = (): TValues => {\n const values = {} as TValues\n for (const [name] of fieldEntries) {\n ;(values as Record<string, unknown>)[name] =\n fields[name]?.value.peek() ?? (initialValues as Record<string, unknown>)[name]\n }\n return values\n }\n\n // Clear all pending debounce timers\n const clearAllTimers = () => {\n for (const key of Object.keys(debounceTimers)) {\n clearTimeout(debounceTimers[key as keyof TValues])\n delete debounceTimers[key as keyof TValues]\n }\n }\n\n const isValidating = signal(false)\n const submitError = signal<unknown>(undefined)\n\n // Track whether the form has been disposed (unmounted)\n let disposed = false\n\n for (const [name, initial] of fieldEntries) {\n const valueSig = signal(initial) as Signal<TValues[typeof name]>\n const errorSig = signal<ValidationError>(undefined)\n const touchedSig = signal(false)\n const dirtySig = signal(false)\n\n // Initialize validation version\n validationVersions[name] = 0\n\n const runValidation = async (value: TValues[typeof name]) => {\n const fieldValidator = validators?.[name]\n if (fieldValidator) {\n // Bump version to track this validation run\n validationVersions[name] = (validationVersions[name] ?? 0) + 1\n const currentVersion = validationVersions[name]\n try {\n const result = await fieldValidator(value, getValues())\n // Only apply result if this is still the latest validation and not disposed\n if (!disposed && validationVersions[name] === currentVersion) {\n errorSig.set(result)\n }\n return result\n } catch (err) {\n // Validator threw — treat as error string if possible\n if (!disposed && validationVersions[name] === currentVersion) {\n const message = err instanceof Error ? err.message : String(err)\n errorSig.set(message)\n }\n return err instanceof Error ? err.message : String(err)\n }\n }\n errorSig.set(undefined)\n return undefined\n }\n\n const validateField = debounceMs\n ? (value: TValues[typeof name]) => {\n clearTimeout(debounceTimers[name])\n return new Promise<ValidationError>((resolve) => {\n debounceTimers[name] = setTimeout(async () => {\n resolve(await runValidation(value))\n }, debounceMs)\n })\n }\n : runValidation\n\n // Auto-validate on change if configured\n if (validateOn === \"change\") {\n effect(() => {\n const v = valueSig()\n validateField(v)\n })\n }\n\n fields[name] = {\n value: valueSig,\n error: errorSig,\n touched: touchedSig,\n dirty: dirtySig,\n setValue: (value: TValues[typeof name]) => {\n valueSig.set(value)\n // Deep comparison for objects/arrays, reference for primitives\n dirtySig.set(!structuredEqual(value, initial))\n },\n setTouched: () => {\n touchedSig.set(true)\n if (validateOn === \"blur\") {\n validateField(valueSig.peek())\n }\n },\n reset: () => {\n valueSig.set(initial as TValues[typeof name])\n errorSig.set(undefined)\n touchedSig.set(false)\n dirtySig.set(false)\n clearTimeout(debounceTimers[name])\n },\n } as FieldState<TValues[typeof name]>\n }\n\n // Clean up debounce timers and cancel in-flight validators on unmount\n onUnmount(() => {\n disposed = true\n clearAllTimers()\n })\n\n const isSubmitting = signal(false)\n const submitCount = signal(0)\n\n // Form-level computed signals\n const isValid = computed(() => {\n for (const name of fieldEntries.map(([n]) => n)) {\n if (fields[name].error() !== undefined) return false\n }\n return true\n })\n\n const isDirty = computed(() => {\n for (const name of fieldEntries.map(([n]) => n)) {\n if (fields[name].dirty()) return true\n }\n return false\n })\n\n const getErrors = (): Partial<Record<keyof TValues, ValidationError>> => {\n const errors = {} as Partial<Record<keyof TValues, ValidationError>>\n for (const [name] of fieldEntries) {\n const err = fields[name].error.peek()\n if (err !== undefined) errors[name] = err\n }\n return errors\n }\n\n const validate = async (): Promise<boolean> => {\n // Cancel any pending debounced validations\n clearAllTimers()\n\n isValidating.set(true)\n\n try {\n const allValues = getValues()\n\n // Clear all errors before re-validating\n for (const [name] of fieldEntries) {\n fields[name].error.set(undefined)\n }\n\n // Run field-level validators with all values for cross-field support\n await Promise.all(\n fieldEntries.map(async ([name]) => {\n const fieldValidator = validators?.[name]\n if (fieldValidator) {\n // Bump version so any in-flight debounced validation is discarded\n validationVersions[name] = (validationVersions[name] ?? 0) + 1\n const currentVersion = validationVersions[name]\n try {\n const error = await fieldValidator(fields[name].value.peek(), allValues)\n if (validationVersions[name] === currentVersion) {\n fields[name].error.set(error)\n }\n } catch (err) {\n if (validationVersions[name] === currentVersion) {\n fields[name].error.set(err instanceof Error ? err.message : String(err))\n }\n }\n }\n }),\n )\n\n // Run schema-level validator — only set schema errors for fields\n // that don't already have a field-level error (field-level wins)\n if (schema) {\n try {\n const schemaErrors = await schema(allValues)\n for (const [name] of fieldEntries) {\n const schemaError = schemaErrors[name]\n if (schemaError !== undefined && fields[name].error.peek() === undefined) {\n fields[name].error.set(schemaError)\n }\n }\n } catch (err) {\n // Schema validator threw — set as submitError rather than losing it\n submitError.set(err)\n return false\n }\n }\n\n // Re-check: any field with an error means invalid\n for (const [name] of fieldEntries) {\n if (fields[name].error.peek() !== undefined) return false\n }\n return true\n } finally {\n isValidating.set(false)\n }\n }\n\n const handleSubmit = async (e?: Event) => {\n if (e && typeof e.preventDefault === \"function\") {\n e.preventDefault()\n }\n\n submitError.set(undefined)\n submitCount.update((n) => n + 1)\n\n // Mark all fields as touched\n for (const [name] of fieldEntries) {\n fields[name].touched.set(true)\n }\n\n const valid = await validate()\n if (!valid) return\n\n isSubmitting.set(true)\n try {\n await onSubmit(getValues())\n } catch (err) {\n submitError.set(err)\n throw err\n } finally {\n isSubmitting.set(false)\n }\n }\n\n const reset = () => {\n clearAllTimers()\n for (const [name] of fieldEntries) {\n fields[name].reset()\n }\n submitCount.set(0)\n submitError.set(undefined)\n }\n\n const setFieldValue = <K extends keyof TValues>(field: K, value: TValues[K]) => {\n if (!fields[field]) {\n throw new Error(\n `[@pyreon/form] Field \"${String(field)}\" does not exist. Available fields: ${fieldEntries.map(([n]) => n).join(\", \")}`,\n )\n }\n fields[field].setValue(value)\n }\n\n const setFieldError = (field: keyof TValues, error: ValidationError) => {\n if (!fields[field]) {\n throw new Error(\n `[@pyreon/form] Field \"${String(field)}\" does not exist. Available fields: ${fieldEntries.map(([n]) => n).join(\", \")}`,\n )\n }\n fields[field].error.set(error)\n }\n\n const setErrors = (errors: Partial<Record<keyof TValues, ValidationError>>) => {\n for (const [name, error] of Object.entries(errors)) {\n setFieldError(name as keyof TValues, error as ValidationError)\n }\n }\n\n const clearErrors = () => {\n for (const [name] of fieldEntries) {\n fields[name].error.set(undefined)\n }\n }\n\n const resetField = (field: keyof TValues) => {\n if (fields[field]) {\n fields[field].reset()\n }\n }\n\n // Memoized register props per field+type combo\n const registerCache = new Map<string, FieldRegisterProps<unknown>>()\n\n const register = <K extends keyof TValues & string>(\n field: K,\n opts?: { type?: \"checkbox\" \| \"number\" },\n ): FieldRegisterProps<TValues[K]> => {\n const cacheKey = `${field}:${opts?.type ?? \"text\"}`\n const cached = registerCache.get(cacheKey)\n if (cached) return cached as FieldRegisterProps<TValues[K]>\n\n const fieldState = fields[field]\n const props: FieldRegisterProps<TValues[K]> = {\n value: fieldState.value,\n onInput: (e: Event) => {\n const target = e.target as HTMLInputElement\n if (opts?.type === \"checkbox\") {\n fieldState.setValue(target.checked as TValues[K])\n } else if (opts?.type === \"number\") {\n const num = target.valueAsNumber\n fieldState.setValue((Number.isNaN(num) ? target.value : num) as TValues[K])\n } else {\n fieldState.setValue(target.value as TValues[K])\n }\n },\n onBlur: () => {\n fieldState.setTouched()\n },\n }\n\n if (opts?.type === \"checkbox\") {\n props.checked = computed(() => Boolean(fieldState.value()))\n }\n\n registerCache.set(cacheKey, props as FieldRegisterProps<unknown>)\n return props\n }\n\n return {\n fields,\n isSubmitting,\n isValidating,\n isValid,\n isDirty,\n submitCount,\n submitError,\n values: getValues,\n errors: getErrors,\n setFieldValue,\n setFieldError,\n setErrors,\n clearErrors,\n resetField,\n register,\n handleSubmit,\n reset,\n validate,\n }\n}\n\n/* Deep structural equality with depth limit to guard against circular references. /\nfunction structuredEqual(a: unknown, b: unknown, depth = 0): boolean {\n if (Object.is(a, b)) return true\n if (a == null \|\| b == null) return false\n if (typeof a !== typeof b) return false\n // Bail at depth 10 — treat as not equal to avoid infinite recursion\n if (depth > 10) return false\n\n if (Array.isArray(a) && Array.isArray(b)) {\n if (a.length !== b.length) return false\n for (let i = 0; i < a.length; i++) {\n if (!structuredEqual(a[i], b[i], depth + 1)) return false\n }\n return true\n }\n\n if (typeof a === \"object\" && typeof b === \"object\") {\n const aObj = a as Record<string, unknown>\n const bObj = b as Record<string, unknown>\n const aKeys = Object.keys(aObj)\n const bKeys = Object.keys(bObj)\n if (aKeys.length !== bKeys.length) return false\n for (const key of aKeys) {\n if (!structuredEqual(aObj[key], bObj[key], depth + 1)) return false\n }\n return true\n }\n\n return false\n}\n","import type { Computed } from \"@pyreon/reactivity\"\nimport { computed } from \"@pyreon/reactivity\"\nimport type { FormState, ValidationError } from \"./types\"\n\nexport interface FormStateSummary<TValues extends Record<string, unknown>> {\n isSubmitting: boolean\n isValidating: boolean\n isValid: boolean\n isDirty: boolean\n submitCount: number\n submitError: unknown\n touchedFields: Partial<Record<keyof TValues, boolean>>\n dirtyFields: Partial<Record<keyof TValues, boolean>>\n errors: Partial<Record<keyof TValues, ValidationError>>\n}\n\n/\n Subscribe to the full form state as a single computed signal.\n * Useful for rendering form-level UI (submit button disabled state,\n * error summaries, progress indicators).\n \n @example\n * const state = useFormState(form)\n * // state() => { isSubmitting, isValid, isDirty, errors, ... }\n \n @example\n * // Use a selector for fine-grained reactivity\n * const canSubmit = useFormState(form, (s) => s.isValid && !s.isSubmitting)\n /\nexport function useFormState<TValues extends Record<string, unknown>>(\n form: FormState<TValues>,\n): Computed<FormStateSummary<TValues>>\n\nexport function useFormState<TValues extends Record<string, unknown>, R>(\n form: FormState<TValues>,\n selector: (state: FormStateSummary<TValues>) => R,\n): Computed<R>\n\nexport function useFormState<TValues extends Record<string, unknown>, R>(\n form: FormState<TValues>,\n selector?: (state: FormStateSummary<TValues>) => R,\n): Computed<FormStateSummary<TValues>> \| Computed<R> {\n const buildSummary = (): FormStateSummary<TValues> => {\n const touchedFields = {} as Partial<Record<keyof TValues, boolean>>\n const dirtyFields = {} as Partial<Record<keyof TValues, boolean>>\n const errors = {} as Partial<Record<keyof TValues, ValidationError>>\n\n for (const key of Object.keys(form.fields) as (keyof TValues & string)[]) {\n const field = form.fields[key]\n if (field.touched()) touchedFields[key] = true\n if (field.dirty()) dirtyFields[key] = true\n const err = field.error()\n if (err !== undefined) errors[key] = err\n }\n\n return {\n isSubmitting: form.isSubmitting(),\n isValidating: form.isValidating(),\n isValid: form.isValid(),\n isDirty: form.isDirty(),\n submitCount: form.submitCount(),\n submitError: form.submitError(),\n touchedFields,\n dirtyFields,\n errors,\n }\n }\n\n if (selector) {\n return computed(() => selector(buildSummary()))\n }\n\n return computed(buildSummary)\n}\n","import type { Computed, Signal } from \"@pyreon/reactivity\"\nimport { computed } from \"@pyreon/reactivity\"\nimport type { FormState } from \"./types\"\n\n/\n Watch specific field values reactively. Returns a computed signal\n * that re-evaluates when any of the watched fields change.\n \n @example\n * // Watch a single field\n * const email = useWatch(form, 'email')\n * // email() => current email value\n \n @example\n * // Watch multiple fields\n * const [first, last] = useWatch(form, ['firstName', 'lastName'])\n * // first() => firstName value, last() => lastName value\n \n @example\n * // Watch all fields\n * const all = useWatch(form)\n * // all() => { email: '...', password: '...' }\n */\nexport function useWatch<TValues extends Record<string, unknown>, K extends keyof TValues & string>(\n form: FormState<TValues>,\n name: K,\n): Signal<TValues[K]>\n\nexport function useWatch<\n TValues extends Record<string, unknown>,\n K extends (keyof TValues & string)[],\n>(form: FormState<TValues>, names: K): { [I in keyof K]: Signal<TValues[K[I] & keyof TValues]> }\n\nexport function useWatch<TValues extends Record<string, unknown>>(\n form: FormState<TValues>,\n): Computed<TValues>\n\nexport function useWatch<TValues extends Record<string, unknown>, K extends keyof TValues & string>(\n form: FormState<TValues>,\n nameOrNames?: K \| K[],\n): Signal<TValues[K]> \| Signal<TValues[K]>[] \| Computed<TValues> {\n // Watch all fields\n if (nameOrNames === undefined) {\n return computed(() => {\n const result = {} as TValues\n for (const key of Object.keys(form.fields) as (keyof TValues & string)[]) {\n ;(result as Record<string, unknown>)[key] = form.fields[key].value()\n }\n return result\n })\n }\n\n // Watch multiple fields\n if (Array.isArray(nameOrNames)) {\n return nameOrNames.map((name) => form.fields[name].value) as Signal<TValues[K]>[]\n }\n\n // Watch single field\n return form.fields[nameOrNames].value\n}\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.js","names":[],"sources":["../src/context.ts","../src/use-field.ts","../src/use-field-array.ts","../src/use-form.ts","../src/use-form-state.ts","../src/use-watch.ts"],"sourcesContent":["import type { Props, VNode, VNodeChild } from '@pyreon/core'\nimport { createContext, provide, useContext } from '@pyreon/core'\nimport type { FormState } from './types'\n\nconst FormContext = createContext<FormState<Record<string, unknown>> \| null>(null)\n\nexport interface FormProviderProps<TValues extends Record<string, unknown>> extends Props {\n form: FormState<TValues>\n children?: VNodeChild\n}\n\n/*\n Provide a form instance to the component tree so nested components\n * can access it via `useFormContext()`.\n \n @example\n * const form = useForm({ initialValues: { email: '' }, onSubmit: ... })\n \n <FormProvider form={form}>\n * <EmailField />\n * <SubmitButton />\n * </FormProvider>\n /\nexport function FormProvider<TValues extends Record<string, unknown>>(\n props: FormProviderProps<TValues>,\n): VNode {\n provide(FormContext, props.form as FormState<Record<string, unknown>>)\n\n const ch = props.children\n return (typeof ch === 'function' ? (ch as () => VNodeChild)() : ch) as VNode\n}\n\n/\n Access the form instance from the nearest `FormProvider`.\n * Must be called within a component tree wrapped by `FormProvider`.\n \n @example\n * function EmailField() {\n * const form = useFormContext<{ email: string }>()\n * return <input {...form.register('email')} />\n * }\n /\nexport function useFormContext<\n TValues extends Record<string, unknown> = Record<string, unknown>,\n>(): FormState<TValues> {\n const form = useContext(FormContext)\n if (!form) {\n throw new Error('[@pyreon/form] useFormContext() must be used within a <FormProvider>.')\n }\n // Generic narrowing: context stores FormState<Record<string, unknown>>\n // but callers narrow to their specific TValues at the call site.\n return form as FormState<TValues>\n}\n","import type { Computed, Signal } from '@pyreon/reactivity'\nimport { computed } from '@pyreon/reactivity'\nimport type { FieldRegisterProps, FieldState, FormState, ValidationError } from './types'\n\nexport interface UseFieldResult<T> {\n /* Current field value (reactive signal). /\n value: Signal<T>\n /* Field error message (reactive signal). /\n error: Signal<ValidationError>\n /* Whether the field has been touched (reactive signal). /\n touched: Signal<boolean>\n /* Whether the field value differs from initial (reactive signal). /\n dirty: Signal<boolean>\n /* Set the field value. /\n setValue: (value: T) => void\n /* Mark the field as touched. /\n setTouched: () => void\n /* Reset the field to its initial value. /\n reset: () => void\n /* Register props for input binding. /\n register: (opts?: { type?: 'checkbox' }) => FieldRegisterProps<T>\n /* Whether the field has an error (computed). /\n hasError: Computed<boolean>\n /* Whether the field should show its error (touched + has error). /\n showError: Computed<boolean>\n}\n\n/\n Extract a single field's state and helpers from a form instance.\n * Useful for building isolated field components.\n \n @example\n * function EmailField({ form }: { form: FormState<{ email: string }> }) {\n * const field = useField(form, 'email')\n * return (\n * <>\n * <input {...field.register()} />\n * {field.showError() && <span>{field.error()}</span>}\n * </>\n * )\n * }\n /\nexport function useField<TValues extends Record<string, unknown>, K extends keyof TValues & string>(\n form: FormState<TValues>,\n name: K,\n): UseFieldResult<TValues[K]> {\n const fieldState: FieldState<TValues[K]> = form.fields[name]\n\n const hasError = computed(() => fieldState.error() !== undefined)\n const showError = computed(() => fieldState.touched() && hasError())\n\n return {\n value: fieldState.value,\n error: fieldState.error,\n touched: fieldState.touched,\n dirty: fieldState.dirty,\n setValue: fieldState.setValue,\n setTouched: fieldState.setTouched,\n reset: fieldState.reset,\n register: (opts?) => form.register(name, opts),\n hasError,\n showError,\n }\n}\n","import type { Computed, Signal } from '@pyreon/reactivity'\nimport { computed, signal } from '@pyreon/reactivity'\n\nexport interface FieldArrayItem<T> {\n /* Stable key for keyed rendering. /\n key: number\n /* Reactive value for this item. /\n value: Signal<T>\n}\n\nexport interface UseFieldArrayResult<T> {\n /* Reactive list of items with stable keys. /\n items: Signal<FieldArrayItem<T>[]>\n /* Number of items. /\n length: Computed<number>\n /* Append a new item to the end. /\n append: (value: T) => void\n /* Prepend a new item to the start. /\n prepend: (value: T) => void\n /* Insert an item at the given index. /\n insert: (index: number, value: T) => void\n /* Remove the item at the given index. /\n remove: (index: number) => void\n /* Update the value of an item at the given index. /\n update: (index: number, value: T) => void\n /* Move an item from one index to another. /\n move: (from: number, to: number) => void\n /* Swap two items by index. /\n swap: (indexA: number, indexB: number) => void\n /* Replace all items. /\n replace: (values: T[]) => void\n /* Get all current values as a plain array. /\n values: () => T[]\n}\n\n/\n Manage a dynamic array of form fields with stable keys.\n \n @example\n * const tags = useFieldArray<string>([])\n * tags.append('typescript')\n * tags.append('pyreon')\n * // tags.items() — array of { key, value } for keyed rendering\n /\nexport function useFieldArray<T>(initial: T[] = []): UseFieldArrayResult<T> {\n let nextKey = 0\n const makeItem = (value: T): FieldArrayItem<T> => ({\n key: nextKey++,\n value: signal(value),\n })\n\n const items = signal<FieldArrayItem<T>[]>(initial.map(makeItem))\n const length = computed(() => items().length)\n\n return {\n items,\n length,\n\n append(value: T) {\n items.update((arr) => [...arr, makeItem(value)])\n },\n\n prepend(value: T) {\n items.update((arr) => [makeItem(value), ...arr])\n },\n\n insert(index: number, value: T) {\n items.update((arr) => {\n const next = [...arr]\n next.splice(index, 0, makeItem(value))\n return next\n })\n },\n\n remove(index: number) {\n items.update((arr) => arr.filter((_, i) => i !== index))\n },\n\n update(index: number, value: T) {\n const current = items.peek()\n const item = current[index]\n if (item) {\n item.value.set(value)\n }\n },\n\n move(from: number, to: number) {\n items.update((arr) => {\n const next = [...arr]\n const [item] = next.splice(from, 1)\n if (item) next.splice(to, 0, item)\n return next\n })\n },\n\n swap(indexA: number, indexB: number) {\n items.update((arr) => {\n const next = [...arr]\n const a = next[indexA]\n const b = next[indexB]\n if (a && b) {\n next[indexA] = b\n next[indexB] = a\n }\n return next\n })\n },\n\n replace(values: T[]) {\n items.set(values.map(makeItem))\n },\n\n values() {\n return items.peek().map((item) => item.value.peek())\n },\n }\n}\n","import { onUnmount } from '@pyreon/core'\nimport type { Signal } from '@pyreon/reactivity'\nimport { computed, effect, signal } from '@pyreon/reactivity'\nimport type {\n FieldRegisterProps,\n FieldState,\n FormState,\n UseFormOptions,\n ValidationError,\n} from './types'\n\n/\n Create a signal-based form. Returns reactive field states, form-level\n * signals, and handlers for submit/reset/validate.\n \n @example\n * const form = useForm({\n * initialValues: { email: '', password: '', remember: false },\n * validators: {\n * email: (v) => (!v ? 'Required' : undefined),\n * password: (v, all) => (v.length < 8 ? 'Too short' : undefined),\n * },\n * onSubmit: async (values) => { await login(values) },\n * })\n \n // Bind with register():\n * // h('input', form.register('email'))\n * // h('input', { type: 'checkbox', ...form.register('remember', { type: 'checkbox' }) })\n /\nexport function useForm<TValues extends Record<string, unknown>>(\n options: UseFormOptions<TValues>,\n): FormState<TValues> {\n const { initialValues, onSubmit, validators, schema, validateOn = 'blur', debounceMs } = options\n\n // Build field states\n const fieldEntries = Object.entries(initialValues) as [\n keyof TValues & string,\n TValues[keyof TValues],\n ][]\n\n const fields = {} as { [K in keyof TValues]: FieldState<TValues[K]> }\n\n // Debounce timers per field (only allocated when debounceMs is set)\n const debounceTimers: Partial<Record<keyof TValues, ReturnType<typeof setTimeout>>> = {}\n\n // Validation version per field — used to discard stale async results\n const validationVersions: Partial<Record<keyof TValues, number>> = {}\n\n // Helper to get all current values (used by cross-field validators)\n const getValues = (): TValues => {\n const values = {} as TValues\n for (const [name] of fieldEntries) {\n ;(values as Record<string, unknown>)[name] =\n fields[name]?.value.peek() ?? (initialValues as Record<string, unknown>)[name]\n }\n return values\n }\n\n // Clear all pending debounce timers\n const clearAllTimers = () => {\n for (const key of Object.keys(debounceTimers)) {\n clearTimeout(debounceTimers[key as keyof TValues])\n delete debounceTimers[key as keyof TValues]\n }\n }\n\n const isValidating = signal(false)\n const submitError = signal<unknown>(undefined)\n\n // Track whether the form has been disposed (unmounted)\n let disposed = false\n\n for (const [name, initial] of fieldEntries) {\n const valueSig = signal(initial) as Signal<TValues[typeof name]>\n const errorSig = signal<ValidationError>(undefined)\n const touchedSig = signal(false)\n const dirtySig = signal(false)\n\n // Initialize validation version\n validationVersions[name] = 0\n\n const runValidation = async (value: TValues[typeof name]) => {\n const fieldValidator = validators?.[name]\n if (fieldValidator) {\n // Bump version to track this validation run\n validationVersions[name] = (validationVersions[name] ?? 0) + 1\n const currentVersion = validationVersions[name]\n try {\n const result = await fieldValidator(value, getValues())\n // Only apply result if this is still the latest validation and not disposed\n if (!disposed && validationVersions[name] === currentVersion) {\n errorSig.set(result)\n }\n return result\n } catch (err) {\n // Validator threw — treat as error string if possible\n if (!disposed && validationVersions[name] === currentVersion) {\n const message = err instanceof Error ? err.message : String(err)\n errorSig.set(message)\n }\n return err instanceof Error ? err.message : String(err)\n }\n }\n errorSig.set(undefined)\n return undefined\n }\n\n const validateField = debounceMs\n ? (value: TValues[typeof name]) => {\n clearTimeout(debounceTimers[name])\n return new Promise<ValidationError>((resolve) => {\n debounceTimers[name] = setTimeout(async () => {\n resolve(await runValidation(value))\n }, debounceMs)\n })\n }\n : runValidation\n\n // Auto-validate on change if configured\n if (validateOn === 'change') {\n effect(() => {\n const v = valueSig()\n validateField(v)\n })\n }\n\n fields[name] = {\n value: valueSig,\n error: errorSig,\n touched: touchedSig,\n dirty: dirtySig,\n setValue: (value: TValues[typeof name]) => {\n valueSig.set(value)\n // Deep comparison for objects/arrays, reference for primitives\n dirtySig.set(!structuredEqual(value, initial))\n },\n setTouched: () => {\n touchedSig.set(true)\n if (validateOn === 'blur') {\n validateField(valueSig.peek())\n }\n },\n reset: () => {\n valueSig.set(initial as TValues[typeof name])\n errorSig.set(undefined)\n touchedSig.set(false)\n dirtySig.set(false)\n clearTimeout(debounceTimers[name])\n },\n } as FieldState<TValues[typeof name]>\n }\n\n // Clean up debounce timers and cancel in-flight validators on unmount\n onUnmount(() => {\n disposed = true\n clearAllTimers()\n })\n\n const isSubmitting = signal(false)\n const submitCount = signal(0)\n\n // Form-level computed signals\n const isValid = computed(() => {\n for (const name of fieldEntries.map(([n]) => n)) {\n if (fields[name].error() !== undefined) return false\n }\n return true\n })\n\n const isDirty = computed(() => {\n for (const name of fieldEntries.map(([n]) => n)) {\n if (fields[name].dirty()) return true\n }\n return false\n })\n\n const getErrors = (): Partial<Record<keyof TValues, ValidationError>> => {\n const errors = {} as Partial<Record<keyof TValues, ValidationError>>\n for (const [name] of fieldEntries) {\n const err = fields[name].error.peek()\n if (err !== undefined) errors[name] = err\n }\n return errors\n }\n\n const validate = async (): Promise<boolean> => {\n // Cancel any pending debounced validations\n clearAllTimers()\n\n isValidating.set(true)\n\n try {\n const allValues = getValues()\n\n // Clear all errors before re-validating\n for (const [name] of fieldEntries) {\n fields[name].error.set(undefined)\n }\n\n // Run field-level validators with all values for cross-field support\n await Promise.all(\n fieldEntries.map(async ([name]) => {\n const fieldValidator = validators?.[name]\n if (fieldValidator) {\n // Bump version so any in-flight debounced validation is discarded\n validationVersions[name] = (validationVersions[name] ?? 0) + 1\n const currentVersion = validationVersions[name]\n try {\n const error = await fieldValidator(fields[name].value.peek(), allValues)\n if (validationVersions[name] === currentVersion) {\n fields[name].error.set(error)\n }\n } catch (err) {\n if (validationVersions[name] === currentVersion) {\n fields[name].error.set(err instanceof Error ? err.message : String(err))\n }\n }\n }\n }),\n )\n\n // Run schema-level validator — only set schema errors for fields\n // that don't already have a field-level error (field-level wins)\n if (schema) {\n try {\n const schemaErrors = await schema(allValues)\n for (const [name] of fieldEntries) {\n const schemaError = schemaErrors[name]\n if (schemaError !== undefined && fields[name].error.peek() === undefined) {\n fields[name].error.set(schemaError)\n }\n }\n } catch (err) {\n // Schema validator threw — set as submitError rather than losing it\n submitError.set(err)\n return false\n }\n }\n\n // Re-check: any field with an error means invalid\n for (const [name] of fieldEntries) {\n if (fields[name].error.peek() !== undefined) return false\n }\n return true\n } finally {\n isValidating.set(false)\n }\n }\n\n const handleSubmit = async (e?: Event) => {\n if (e && typeof e.preventDefault === 'function') {\n e.preventDefault()\n }\n\n submitError.set(undefined)\n submitCount.update((n) => n + 1)\n\n // Mark all fields as touched\n for (const [name] of fieldEntries) {\n fields[name].touched.set(true)\n }\n\n const valid = await validate()\n if (!valid) return\n\n isSubmitting.set(true)\n try {\n await onSubmit(getValues())\n } catch (err) {\n submitError.set(err)\n throw err\n } finally {\n isSubmitting.set(false)\n }\n }\n\n const reset = () => {\n clearAllTimers()\n for (const [name] of fieldEntries) {\n fields[name].reset()\n }\n submitCount.set(0)\n submitError.set(undefined)\n }\n\n const setFieldValue = <K extends keyof TValues>(field: K, value: TValues[K]) => {\n if (!fields[field]) {\n throw new Error(\n `[@pyreon/form] Field \"${String(field)}\" does not exist. Available fields: ${fieldEntries.map(([n]) => n).join(', ')}`,\n )\n }\n fields[field].setValue(value)\n }\n\n const setFieldError = (field: keyof TValues, error: ValidationError) => {\n if (!fields[field]) {\n throw new Error(\n `[@pyreon/form] Field \"${String(field)}\" does not exist. Available fields: ${fieldEntries.map(([n]) => n).join(', ')}`,\n )\n }\n fields[field].error.set(error)\n }\n\n const setErrors = (errors: Partial<Record<keyof TValues, ValidationError>>) => {\n for (const [name, error] of Object.entries(errors)) {\n setFieldError(name as keyof TValues, error as ValidationError)\n }\n }\n\n const clearErrors = () => {\n for (const [name] of fieldEntries) {\n fields[name].error.set(undefined)\n }\n }\n\n const resetField = (field: keyof TValues) => {\n if (fields[field]) {\n fields[field].reset()\n }\n }\n\n // Memoized register props per field+type combo\n const registerCache = new Map<string, FieldRegisterProps<unknown>>()\n\n const register = <K extends keyof TValues & string>(\n field: K,\n opts?: { type?: 'checkbox' \| 'number' },\n ): FieldRegisterProps<TValues[K]> => {\n const cacheKey = `${field}:${opts?.type ?? 'text'}`\n const cached = registerCache.get(cacheKey)\n if (cached) return cached as FieldRegisterProps<TValues[K]>\n\n const fieldState = fields[field]\n const props: FieldRegisterProps<TValues[K]> = {\n value: fieldState.value,\n onInput: (e: Event) => {\n const target = e.target as HTMLInputElement\n if (opts?.type === 'checkbox') {\n fieldState.setValue(target.checked as TValues[K])\n } else if (opts?.type === 'number') {\n const num = target.valueAsNumber\n fieldState.setValue((Number.isNaN(num) ? target.value : num) as TValues[K])\n } else {\n fieldState.setValue(target.value as TValues[K])\n }\n },\n onBlur: () => {\n fieldState.setTouched()\n },\n }\n\n if (opts?.type === 'checkbox') {\n props.checked = computed(() => Boolean(fieldState.value()))\n }\n\n registerCache.set(cacheKey, props as FieldRegisterProps<unknown>)\n return props\n }\n\n return {\n fields,\n isSubmitting,\n isValidating,\n isValid,\n isDirty,\n submitCount,\n submitError,\n values: getValues,\n errors: getErrors,\n setFieldValue,\n setFieldError,\n setErrors,\n clearErrors,\n resetField,\n register,\n handleSubmit,\n reset,\n validate,\n }\n}\n\n/* Deep structural equality with depth limit to guard against circular references. /\nfunction structuredEqual(a: unknown, b: unknown, depth = 0): boolean {\n if (Object.is(a, b)) return true\n if (a == null \|\| b == null) return false\n if (typeof a !== typeof b) return false\n // Bail at depth 10 — treat as not equal to avoid infinite recursion\n if (depth > 10) return false\n\n if (Array.isArray(a) && Array.isArray(b)) {\n if (a.length !== b.length) return false\n for (let i = 0; i < a.length; i++) {\n if (!structuredEqual(a[i], b[i], depth + 1)) return false\n }\n return true\n }\n\n if (typeof a === 'object' && typeof b === 'object') {\n const aObj = a as Record<string, unknown>\n const bObj = b as Record<string, unknown>\n const aKeys = Object.keys(aObj)\n const bKeys = Object.keys(bObj)\n if (aKeys.length !== bKeys.length) return false\n for (const key of aKeys) {\n if (!structuredEqual(aObj[key], bObj[key], depth + 1)) return false\n }\n return true\n }\n\n return false\n}\n","import type { Computed } from '@pyreon/reactivity'\nimport { computed } from '@pyreon/reactivity'\nimport type { FormState, ValidationError } from './types'\n\nexport interface FormStateSummary<TValues extends Record<string, unknown>> {\n isSubmitting: boolean\n isValidating: boolean\n isValid: boolean\n isDirty: boolean\n submitCount: number\n submitError: unknown\n touchedFields: Partial<Record<keyof TValues, boolean>>\n dirtyFields: Partial<Record<keyof TValues, boolean>>\n errors: Partial<Record<keyof TValues, ValidationError>>\n}\n\n/\n Subscribe to the full form state as a single computed signal.\n * Useful for rendering form-level UI (submit button disabled state,\n * error summaries, progress indicators).\n \n @example\n * const state = useFormState(form)\n * // state() => { isSubmitting, isValid, isDirty, errors, ... }\n \n @example\n * // Use a selector for fine-grained reactivity\n * const canSubmit = useFormState(form, (s) => s.isValid && !s.isSubmitting)\n /\nexport function useFormState<TValues extends Record<string, unknown>>(\n form: FormState<TValues>,\n): Computed<FormStateSummary<TValues>>\n\nexport function useFormState<TValues extends Record<string, unknown>, R>(\n form: FormState<TValues>,\n selector: (state: FormStateSummary<TValues>) => R,\n): Computed<R>\n\nexport function useFormState<TValues extends Record<string, unknown>, R>(\n form: FormState<TValues>,\n selector?: (state: FormStateSummary<TValues>) => R,\n): Computed<FormStateSummary<TValues>> \| Computed<R> {\n const buildSummary = (): FormStateSummary<TValues> => {\n const touchedFields = {} as Partial<Record<keyof TValues, boolean>>\n const dirtyFields = {} as Partial<Record<keyof TValues, boolean>>\n const errors = {} as Partial<Record<keyof TValues, ValidationError>>\n\n for (const key of Object.keys(form.fields) as (keyof TValues & string)[]) {\n const field = form.fields[key]\n if (field.touched()) touchedFields[key] = true\n if (field.dirty()) dirtyFields[key] = true\n const err = field.error()\n if (err !== undefined) errors[key] = err\n }\n\n return {\n isSubmitting: form.isSubmitting(),\n isValidating: form.isValidating(),\n isValid: form.isValid(),\n isDirty: form.isDirty(),\n submitCount: form.submitCount(),\n submitError: form.submitError(),\n touchedFields,\n dirtyFields,\n errors,\n }\n }\n\n if (selector) {\n return computed(() => selector(buildSummary()))\n }\n\n return computed(buildSummary)\n}\n","import type { Computed, Signal } from '@pyreon/reactivity'\nimport { computed } from '@pyreon/reactivity'\nimport type { FormState } from './types'\n\n/\n Watch specific field values reactively. Returns a computed signal\n * that re-evaluates when any of the watched fields change.\n \n @example\n * // Watch a single field\n * const email = useWatch(form, 'email')\n * // email() => current email value\n \n @example\n * // Watch multiple fields\n * const [first, last] = useWatch(form, ['firstName', 'lastName'])\n * // first() => firstName value, last() => lastName value\n \n @example\n * // Watch all fields\n * const all = useWatch(form)\n * // all() => { email: '...', password: '...' }\n */\nexport function useWatch<TValues extends Record<string, unknown>, K extends keyof TValues & string>(\n form: FormState<TValues>,\n name: K,\n): Signal<TValues[K]>\n\nexport function useWatch<\n TValues extends Record<string, unknown>,\n K extends (keyof TValues & string)[],\n>(form: FormState<TValues>, names: K): { [I in keyof K]: Signal<TValues[K[I] & keyof TValues]> }\n\nexport function useWatch<TValues extends Record<string, unknown>>(\n form: FormState<TValues>,\n): Computed<TValues>\n\nexport function useWatch<TValues extends Record<string, unknown>, K extends keyof TValues & string>(\n form: FormState<TValues>,\n nameOrNames?: K \| K[],\n): Signal<TValues[K]> \| Signal<TValues[K]>[] \| Computed<TValues> {\n // Watch all fields\n if (nameOrNames === undefined) {\n return computed(() => {\n const result = {} as TValues\n for (const key of Object.keys(form.fields) as (keyof TValues & string)[]) {\n ;(result as Record<string, unknown>)[key] = form.fields[key].value()\n }\n return result\n })\n }\n\n // Watch multiple fields\n if (Array.isArray(nameOrNames)) {\n return nameOrNames.map((name) => form.fields[name].value) as Signal<TValues[K]>[]\n }\n\n // Watch single field\n return form.fields[nameOrNames].value\n}\n"],"mappings":"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"}

package/lib/types/index.d.ts CHANGED Viewed

@@ -73,7 +73,7 @@ interface FormState<TValues extends Record<string, unknown>> {
    * For numbers: pass `{ type: 'number' }` to use `valueAsNumber` on input.
    */
   register: <K extends keyof TValues & string>(field: K, options?: {
-    type?: "checkbox" | "number";
+    type?: 'checkbox' | 'number';
   }) => FieldRegisterProps<TValues[K]>;
   /**
    * Submit handler — runs validation, then calls onSubmit if valid.
@@ -95,7 +95,7 @@ interface UseFormOptions<TValues extends Record<string, unknown>> {
   /** Schema-level validator (runs after field validators). */
   schema?: SchemaValidateFn<TValues>;
   /** When to validate: 'blur' (default), 'change', or 'submit'. */
-  validateOn?: "blur" | "change" | "submit";
+  validateOn?: 'blur' | 'change' | 'submit';
   /** Debounce delay in ms for validators (useful for async validators). */
   debounceMs?: number;
 }
@@ -148,7 +148,7 @@ interface UseFieldResult<T> {
   reset: () => void;
   /** Register props for input binding. */
   register: (opts?: {
-    type?: "checkbox";
+    type?: 'checkbox';
   }) => FieldRegisterProps<T>;
   /** Whether the field has an error (computed). */
   hasError: Computed<boolean>;

package/package.json CHANGED Viewed

@@ -1,20 +1,17 @@
 {
   "name": "@pyreon/form",
-  "version": "0.11.5",
+  "version": "0.11.7",
   "description": "Signal-based form management for Pyreon",
+  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/form#readme",
+  "bugs": {
+    "url": "https://github.com/pyreon/pyreon/issues"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/pyreon/pyreon.git",
     "directory": "packages/fundamentals/form"
   },
-  "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/form#readme",
-  "bugs": {
-    "url": "https://github.com/pyreon/pyreon/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "files": [
     "lib",
     "src",
@@ -38,21 +35,24 @@
       "types": "./lib/types/devtools.d.ts"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "vl_rolldown_build",
     "dev": "vl_rolldown_build-watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "lint": "biome check ."
-  },
-  "peerDependencies": {
-    "@pyreon/core": "^0.11.5",
-    "@pyreon/reactivity": "^0.11.5"
+    "lint": "oxlint ."
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.3",
-    "@pyreon/core": "^0.11.5",
-    "@pyreon/reactivity": "^0.11.5",
-    "@pyreon/runtime-dom": "^0.11.5"
+    "@pyreon/core": "^0.11.7",
+    "@pyreon/reactivity": "^0.11.7",
+    "@pyreon/runtime-dom": "^0.11.7"
+  },
+  "peerDependencies": {
+    "@pyreon/core": "^0.11.7",
+    "@pyreon/reactivity": "^0.11.7"
   }
 }

package/src/context.ts CHANGED Viewed

@@ -1,6 +1,6 @@
-import type { Props, VNode, VNodeChild } from "@pyreon/core"
-import { createContext, provide, useContext } from "@pyreon/core"
-import type { FormState } from "./types"
+import type { Props, VNode, VNodeChild } from '@pyreon/core'
+import { createContext, provide, useContext } from '@pyreon/core'
+import type { FormState } from './types'
 const FormContext = createContext<FormState<Record<string, unknown>> | null>(null)
@@ -27,7 +27,7 @@ export function FormProvider<TValues extends Record<string, unknown>>(
   provide(FormContext, props.form as FormState<Record<string, unknown>>)
   const ch = props.children
-  return (typeof ch === "function" ? (ch as () => VNodeChild)() : ch) as VNode
+  return (typeof ch === 'function' ? (ch as () => VNodeChild)() : ch) as VNode
 }
 /**
@@ -45,7 +45,7 @@ export function useFormContext<
 >(): FormState<TValues> {
   const form = useContext(FormContext)
   if (!form) {
-    throw new Error("[@pyreon/form] useFormContext() must be used within a <FormProvider>.")
+    throw new Error('[@pyreon/form] useFormContext() must be used within a <FormProvider>.')
   }
   // Generic narrowing: context stores FormState<Record<string, unknown>>
   // but callers narrow to their specific TValues at the call site.

package/src/devtools.ts CHANGED Viewed

@@ -56,14 +56,14 @@ export function getFormSnapshot(name: string): Record<string, unknown> | undefin
   const form = getFormInstance(name) as Record<string, unknown> | undefined
   if (!form) return undefined
   return {
-    values: typeof form.values === "function" ? (form.values as () => unknown)() : undefined,
-    errors: typeof form.errors === "function" ? (form.errors as () => unknown)() : undefined,
+    values: typeof form.values === 'function' ? (form.values as () => unknown)() : undefined,
+    errors: typeof form.errors === 'function' ? (form.errors as () => unknown)() : undefined,
     isSubmitting:
-      typeof form.isSubmitting === "function" ? (form.isSubmitting as () => unknown)() : undefined,
-    isValid: typeof form.isValid === "function" ? (form.isValid as () => unknown)() : undefined,
-    isDirty: typeof form.isDirty === "function" ? (form.isDirty as () => unknown)() : undefined,
+      typeof form.isSubmitting === 'function' ? (form.isSubmitting as () => unknown)() : undefined,
+    isValid: typeof form.isValid === 'function' ? (form.isValid as () => unknown)() : undefined,
+    isDirty: typeof form.isDirty === 'function' ? (form.isDirty as () => unknown)() : undefined,
     submitCount:
-      typeof form.submitCount === "function" ? (form.submitCount as () => unknown)() : undefined,
+      typeof form.submitCount === 'function' ? (form.submitCount as () => unknown)() : undefined,
   }
 }