@vielzeug/forge 1.4.0 → 2.0.1

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 (127) hide show
  1. package/README.md +21 -53
  2. package/dist/_utils.cjs +1 -2
  3. package/dist/_utils.d.ts +1 -10
  4. package/dist/_utils.d.ts.map +1 -1
  5. package/dist/_utils.js +2 -33
  6. package/dist/adapters/form-data.cjs +1 -1
  7. package/dist/adapters/form-data.cjs.map +1 -1
  8. package/dist/adapters/form-data.d.ts.map +1 -1
  9. package/dist/adapters/form-data.js +5 -5
  10. package/dist/adapters/form-data.js.map +1 -1
  11. package/dist/core/path.cjs +2 -0
  12. package/dist/core/path.cjs.map +1 -0
  13. package/dist/core/path.d.ts +22 -0
  14. package/dist/core/path.d.ts.map +1 -0
  15. package/dist/core/path.js +125 -0
  16. package/dist/core/path.js.map +1 -0
  17. package/dist/devtools.cjs +1 -1
  18. package/dist/devtools.cjs.map +1 -1
  19. package/dist/devtools.d.ts +3 -36
  20. package/dist/devtools.d.ts.map +1 -1
  21. package/dist/devtools.js +6 -24
  22. package/dist/devtools.js.map +1 -1
  23. package/dist/dom.cjs +2 -0
  24. package/dist/dom.cjs.map +1 -0
  25. package/dist/dom.d.ts +9 -0
  26. package/dist/dom.d.ts.map +1 -0
  27. package/dist/dom.js +24 -0
  28. package/dist/dom.js.map +1 -0
  29. package/dist/errors.cjs +1 -1
  30. package/dist/errors.cjs.map +1 -1
  31. package/dist/errors.d.ts +1 -3
  32. package/dist/errors.d.ts.map +1 -1
  33. package/dist/errors.js +1 -6
  34. package/dist/errors.js.map +1 -1
  35. package/dist/forge.cjs +1 -1
  36. package/dist/forge.cjs.map +1 -1
  37. package/dist/forge.iife.js +1 -1
  38. package/dist/forge.iife.js.map +1 -1
  39. package/dist/forge.js +1 -1
  40. package/dist/forge.js.map +1 -1
  41. package/dist/form.cjs +1 -1
  42. package/dist/form.cjs.map +1 -1
  43. package/dist/form.d.ts +3 -5
  44. package/dist/form.d.ts.map +1 -1
  45. package/dist/form.js +223 -58
  46. package/dist/form.js.map +1 -1
  47. package/dist/index.cjs +1 -1
  48. package/dist/index.js +3 -4
  49. package/dist/spell.cjs +2 -0
  50. package/dist/spell.cjs.map +1 -0
  51. package/dist/spell.d.ts +5 -0
  52. package/dist/spell.d.ts.map +1 -0
  53. package/dist/spell.js +57 -0
  54. package/dist/spell.js.map +1 -0
  55. package/dist/types.d.ts +70 -392
  56. package/dist/types.d.ts.map +1 -1
  57. package/dist/vault.cjs +2 -0
  58. package/dist/vault.cjs.map +1 -0
  59. package/dist/vault.d.ts +10 -0
  60. package/dist/vault.d.ts.map +1 -0
  61. package/dist/vault.js +14 -0
  62. package/dist/vault.js.map +1 -0
  63. package/package.json +49 -13
  64. package/dist/_dev.cjs +0 -2
  65. package/dist/_dev.cjs.map +0 -1
  66. package/dist/_dev.js +0 -12
  67. package/dist/_dev.js.map +0 -1
  68. package/dist/_utils.cjs.map +0 -1
  69. package/dist/_utils.js.map +0 -1
  70. package/dist/adapters/validators.cjs +0 -2
  71. package/dist/adapters/validators.cjs.map +0 -1
  72. package/dist/adapters/validators.d.ts +0 -44
  73. package/dist/adapters/validators.d.ts.map +0 -1
  74. package/dist/adapters/validators.js +0 -20
  75. package/dist/adapters/validators.js.map +0 -1
  76. package/dist/core/array.cjs +0 -2
  77. package/dist/core/array.cjs.map +0 -1
  78. package/dist/core/array.d.ts +0 -10
  79. package/dist/core/array.d.ts.map +0 -1
  80. package/dist/core/array.js +0 -77
  81. package/dist/core/array.js.map +0 -1
  82. package/dist/core/asyncQueue.cjs +0 -2
  83. package/dist/core/asyncQueue.cjs.map +0 -1
  84. package/dist/core/asyncQueue.d.ts +0 -22
  85. package/dist/core/asyncQueue.d.ts.map +0 -1
  86. package/dist/core/asyncQueue.js +0 -67
  87. package/dist/core/asyncQueue.js.map +0 -1
  88. package/dist/core/context.cjs +0 -2
  89. package/dist/core/context.cjs.map +0 -1
  90. package/dist/core/context.d.ts +0 -7
  91. package/dist/core/context.d.ts.map +0 -1
  92. package/dist/core/context.js +0 -139
  93. package/dist/core/context.js.map +0 -1
  94. package/dist/core/fields.cjs +0 -2
  95. package/dist/core/fields.cjs.map +0 -1
  96. package/dist/core/fields.d.ts +0 -52
  97. package/dist/core/fields.d.ts.map +0 -1
  98. package/dist/core/fields.js +0 -310
  99. package/dist/core/fields.js.map +0 -1
  100. package/dist/core/lifecycle.cjs +0 -2
  101. package/dist/core/lifecycle.cjs.map +0 -1
  102. package/dist/core/lifecycle.d.ts +0 -15
  103. package/dist/core/lifecycle.d.ts.map +0 -1
  104. package/dist/core/lifecycle.js +0 -38
  105. package/dist/core/lifecycle.js.map +0 -1
  106. package/dist/core/notifier.cjs +0 -2
  107. package/dist/core/notifier.cjs.map +0 -1
  108. package/dist/core/notifier.d.ts +0 -33
  109. package/dist/core/notifier.d.ts.map +0 -1
  110. package/dist/core/notifier.js +0 -78
  111. package/dist/core/notifier.js.map +0 -1
  112. package/dist/core/observe.cjs +0 -2
  113. package/dist/core/observe.cjs.map +0 -1
  114. package/dist/core/observe.d.ts +0 -20
  115. package/dist/core/observe.d.ts.map +0 -1
  116. package/dist/core/observe.js +0 -79
  117. package/dist/core/observe.js.map +0 -1
  118. package/dist/core/scope.cjs +0 -2
  119. package/dist/core/scope.cjs.map +0 -1
  120. package/dist/core/scope.d.ts +0 -11
  121. package/dist/core/scope.d.ts.map +0 -1
  122. package/dist/core/scope.js +0 -235
  123. package/dist/core/scope.js.map +0 -1
  124. package/dist/types.cjs +0 -2
  125. package/dist/types.cjs.map +0 -1
  126. package/dist/types.js +0 -21
  127. package/dist/types.js.map +0 -1
package/dist/types.d.ts CHANGED
@@ -1,408 +1,86 @@
1
- /** A callback to remove a subscription. */
2
1
  export type Unsubscribe = () => void;
3
2
  export type MaybePromise<T> = T | PromiseLike<T>;
4
- export type FieldValidator<V = unknown> = (value: V, signal?: AbortSignal) => MaybePromise<string | undefined>;
5
- export type FormValidator<TValues extends Record<string, unknown> = Record<string, unknown>> = (values: TValues, signal?: AbortSignal) => MaybePromise<Partial<Record<ErrorKeyOf<TValues>, string>> | undefined>;
6
- export type SetOptions = {
7
- /** Whether to mark the field as touched. Default: false. */
8
- touched?: boolean;
9
- };
10
- export type FormState = {
11
- errors: Readonly<Record<string, string> & {
12
- [FORM_ERROR]?: string;
13
- }>;
14
- isDirty: boolean;
15
- /** `true` while an async `defaultValues` factory is resolving. */
16
- isLoading: boolean;
17
- isSubmitting: boolean;
18
- isTouched: boolean;
19
- isValid: boolean;
20
- isValidating: boolean;
3
+ export type ReadonlyDeep<T> = T extends (...args: never[]) => unknown ? T : T extends readonly (infer Item)[] ? readonly ReadonlyDeep<Item>[] : T extends Record<string, unknown> ? {
4
+ readonly [K in keyof T]: ReadonlyDeep<T[K]>;
5
+ } : T;
6
+ export type FormErrors<T> = T extends readonly unknown[] ? string : T extends Record<string, unknown> ? string | {
7
+ readonly [K in keyof T]?: FormErrors<T[K]>;
8
+ } : string;
9
+ export type ValidationErrors<TValues extends Record<string, unknown>> = Readonly<{
10
+ fields?: FormErrors<TValues>;
11
+ formError?: string;
12
+ }>;
13
+ export type FormValidator<TValues extends Record<string, unknown>> = (values: ReadonlyDeep<TValues>, signal: AbortSignal) => MaybePromise<ValidationErrors<TValues> | undefined>;
14
+ export type FormOptions<TValues extends Record<string, unknown>> = Readonly<{
15
+ initialValues: TValues;
16
+ onSubscriberError?: (error: unknown) => void;
17
+ validate?: FormValidator<NoInfer<TValues>>;
18
+ }>;
19
+ export type SubscribeOptions = Readonly<{
20
+ immediate?: boolean;
21
+ }>;
22
+ export type FieldState<V> = Readonly<{
23
+ dirty: boolean;
24
+ error: string | undefined;
25
+ touched: boolean;
26
+ value: ReadonlyDeep<V>;
27
+ }>;
28
+ export type FormState<TValues extends Record<string, unknown>> = Readonly<{
29
+ error: string | undefined;
30
+ errors: FormErrors<TValues> | undefined;
21
31
  submitCount: number;
22
- /**
23
- * Field names that are currently touched, as full dot-notation paths.
24
- * On a scoped form these are still full paths (e.g. `"address.city"`, not `"city"`).
25
- * Prefer calling `scopedForm.validate()` to run scoped validation rather than
26
- * passing `state.touchedFields` directly — scoped `validate(fields[])` expects relative paths.
27
- */
28
- touchedFields: readonly string[];
29
- /** Field names that currently have an active async validation run. Useful for per-field loading indicators. */
30
- validatingFields: readonly string[];
31
- };
32
- export type SubscribeOptions = {
33
- /** Call the listener immediately with the current state on subscription. Default: false. */
34
- sync?: boolean;
35
- };
36
- /** Shared field key for root-level / form-level validation errors. */
37
- export declare const FORM_ERROR: "_form";
38
- export type ValidateResult = {
39
- errors: Readonly<Record<string, string>>;
32
+ submitting: boolean;
33
+ touched: boolean;
40
34
  valid: boolean;
41
- };
42
- export type SubmitResult<TResult = void> = {
35
+ validating: boolean;
36
+ }>;
37
+ export type ValidationResult<TValues extends Record<string, unknown>> = Readonly<{
38
+ status: 'aborted';
39
+ }> | Readonly<{
40
+ status: 'valid';
41
+ }> | Readonly<{
42
+ errors: FormErrors<TValues> | undefined;
43
+ formError: string | undefined;
44
+ status: 'invalid';
45
+ }>;
46
+ export type SubmitResult<TResult = void, TValues extends Record<string, unknown> = Record<string, unknown>> = Readonly<{
43
47
  ok: true;
44
48
  value: TResult;
45
- } | {
46
- errors: Record<string, string>;
49
+ }> | Readonly<{
50
+ ok: false;
51
+ type: 'aborted';
52
+ }> | Readonly<{
53
+ errors: FormErrors<TValues> | undefined;
54
+ formError: string | undefined;
47
55
  ok: false;
48
56
  type: 'validation';
49
- };
50
- /**
51
- * Recursively makes all properties optional.
52
- * Used by `form.patch()` to accept partial nested updates.
53
- */
54
- export type DeepPartial<T> = T extends Record<string, unknown> ? {
55
- [K in keyof T]?: DeepPartial<T[K]>;
56
- } : T;
57
- /**
58
- * Single source of truth for the typed-path depth ceiling, shared by `FlatKeyOf`'s
59
- * type-level cutoff below and `_utils.ts`'s matching runtime dev-warning threshold —
60
- * one named constant instead of two hardcoded `5`s that could silently drift apart.
61
- *
62
- * Deliberately not a per-form generic parameter (e.g. `Form<TValues, MaxDepth>`): the
63
- * whole point of this cutoff is protecting TypeScript compile time, which is a
64
- * repo-wide concern, not a per-form preference. Making it user-configurable would let
65
- * one form's type param silently regress compile performance for everyone who imports
66
- * it. If a real shape needs deeper typed paths, flatten it or accept `string` typing
67
- * for those leaves — `FlatKeyOf` already falls back to `string` gracefully past this
68
- * depth, so nothing is a hard error either way.
69
- */
70
- export declare const MAX_TYPED_PATH_DEPTH: 5;
71
- /**
72
- * Recursively extracts all dot-notation leaf keys from a values shape.
73
- * Depth-limited to {@link MAX_TYPED_PATH_DEPTH}: TypeScript compilation time grows
74
- * non-linearly beyond this point.
75
- */
76
- export type FlatKeyOf<T extends Record<string, unknown>, P extends string = '', D extends readonly 0[] = []> = D['length'] extends typeof MAX_TYPED_PATH_DEPTH ? string : {
77
- [K in keyof T & string]: T[K] extends unknown[] | File | Blob | Date ? P extends '' ? K : `${P}.${K}` : T[K] extends Record<string, unknown> ? FlatKeyOf<T[K] & Record<string, unknown>, P extends '' ? K : `${P}.${K}`, [...D, 0]> : P extends '' ? K : `${P}.${K}`;
78
- }[keyof T & string];
79
- /** Resolves the value type at a dot-notation path within a values shape. */
80
- export type TypeAtPath<T, K extends string> = K extends `${infer Head}.${infer Tail}` ? Head extends keyof T ? T[Head] extends Record<string, unknown> ? TypeAtPath<T[Head], Tail> : unknown : unknown : K extends keyof T ? T[K] : unknown;
81
- /** Field error keys include field paths plus the reserved `_form` key for root-level issues. */
82
- export type ErrorKeyOf<TValues extends Record<string, unknown>> = FlatKeyOf<TValues> | typeof FORM_ERROR;
83
- /**
84
- * Structural interface for safeParse-compatible schemas.
85
- * Works with `@vielzeug/spell`, Zod, Valibot, and any Standard Schema compliant library.
86
- */
87
- export type SafeParseSchema = {
88
- safeParse(data: unknown): {
89
- success: true;
90
- } | {
91
- error: {
92
- issues: {
93
- message: string;
94
- path: (string | number)[];
95
- }[];
96
- };
97
- success: false;
98
- };
99
- };
100
- /** The type of values accessible at a scoped sub-form prefix. */
101
- export type ScopedValues<TValues, P extends string> = TypeAtPath<TValues, P> extends Record<string, unknown> ? TypeAtPath<TValues, P> & Record<string, unknown> : Record<string, unknown>;
102
- /**
103
- * The live connection object returned by `form.connect()`.
104
- * Getters re-evaluate on every property access — store the object once per field, do not destructure.
105
- * Call `dispose()` to cancel any pending debounce timers when the field unmounts.
106
- */
107
- export type ConnectionResult<V = unknown> = {
108
- [Symbol.dispose](): void;
57
+ }>;
58
+ type ChildField<V> = NonNullable<V> extends readonly unknown[] ? Record<never, never> : NonNullable<V> extends Record<string, unknown> ? {
59
+ field<K extends keyof NonNullable<V> & string>(key: K): Field<NonNullable<V>[K]>;
60
+ } : Record<never, never>;
61
+ export type Field<V> = ChildField<V> & {
109
62
  readonly dirty: boolean;
110
- /** Cancels the debounce timer owned by this specific binding. Safe to call multiple times. */
111
- dispose(): void;
112
- /** `true` after `dispose()` has been called on this binding. */
113
- readonly disposed: boolean;
114
63
  readonly error: string | undefined;
115
- onBlur(): void;
116
- onChange(value: V): void;
64
+ reset(): void;
65
+ set(next: V | ((previous: ReadonlyDeep<V>) => V)): void;
66
+ subscribe(listener: (state: FieldState<V>) => void, options?: SubscribeOptions): Unsubscribe;
67
+ touch(): void;
117
68
  readonly touched: boolean;
118
- readonly value: V;
69
+ readonly value: ReadonlyDeep<V>;
119
70
  };
120
- /** Per-field or global validation trigger configuration. */
121
- export type ConnectOptions = {
122
- /**
123
- * Debounce auto-triggered validation by this many milliseconds.
124
- * Each `connect()` call owns its own timer — cancelling one binding does not affect others.
125
- * Default: 0.
126
- */
127
- debounce?: number;
128
- /** Auto-mark the field as touched when it loses focus. Default: false. */
129
- touchOnBlur?: boolean;
130
- /** Validate the field automatically when it loses focus. Default: false. */
131
- validateOnBlur?: boolean;
132
- /** Validate the field automatically after each value change. Default: false. */
133
- validateOnChange?: boolean;
134
- /** Validate on change only after the field has been touched at least once. */
135
- validateOnTouch?: boolean;
136
- };
137
- type ElementOf<T> = T extends readonly (infer E)[] ? E : unknown;
138
- export type ArrayField<T = unknown> = {
139
- append(value: T): void;
140
- insert(index: number, value: T): void;
141
- move(from: number, to: number): void;
142
- prepend(value: T): void;
143
- remove(index: number): void;
144
- replace(index: number, value: T): void;
145
- swap(a: number, b: number): void;
146
- };
147
- export type FieldState<V = unknown> = {
148
- dirty: boolean;
149
- error: string | undefined;
150
- /** `true` when `error` is not `undefined`. Convenience alias for `error !== undefined`. */
151
- hasError: boolean;
152
- touched: boolean;
153
- value: V;
154
- };
155
- /**
156
- * Options for registering a dynamic field. Both properties are optional;
157
- * omitting `defaultValue` leaves the field uninitialized and omitting `validator`
158
- * skips field-level validation.
159
- */
160
- export type RegisterFieldOptions<V = unknown> = {
161
- /** Initial value. Also becomes the baseline, so the field starts clean. */
162
- defaultValue?: V;
163
- /** Field-level validator to attach. */
164
- validator?: FieldValidator<V>;
165
- };
166
- /**
167
- * A complete snapshot of form state that can be restored via `form.history.restore()`.
168
- * `store` and `baseline` keys are the flattened dot-notation paths used internally.
169
- * Typed with `TValues` for nominal clarity — structurally both are `Record<string, unknown>`.
170
- */
171
- export type FormSnapshot<TValues extends Record<string, unknown> = Record<string, unknown>> = {
172
- readonly baseline: Partial<Record<FlatKeyOf<TValues>, unknown>>;
173
- readonly dirty: readonly string[];
174
- readonly errors: Readonly<Record<string, string>>;
175
- readonly store: Partial<Record<FlatKeyOf<TValues>, unknown>>;
176
- readonly submitCount: number;
177
- readonly touched: readonly string[];
178
- };
179
- /**
180
- * Undo/redo-style snapshotting, namespaced off the main `Form<T>` surface since it's a
181
- * distinctly less common operation than reading/writing values — grouped the same way
182
- * `fields` already groups dynamic-field-lifecycle operations.
183
- */
184
- export type FormHistory<TValues extends Record<string, unknown> = Record<string, unknown>> = {
185
- /**
186
- * Restore the form to a previously captured snapshot. Replaces all state:
187
- * values, baseline, errors, touched, dirty, and submitCount.
188
- * Aborts any in-flight validation.
189
- */
190
- restore(snapshot: FormSnapshot<TValues>): void;
191
- /**
192
- * Capture the complete form state into a snapshot that can be passed to `restore()`.
193
- * Useful for undo/redo, draft saving, and "discard changes" flows.
194
- */
195
- snapshot(): FormSnapshot<TValues>;
196
- };
197
- export type FormOptions<TValues extends Record<string, unknown> = Record<string, unknown>> = {
198
- /**
199
- * Default connect behavior applied when `connect(name, config)` omits specific options.
200
- * Use `ValidationModes` presets for common strategies:
201
- * - `ValidationModes.onSubmit` (default) — validates only on submit, no touch-on-blur
202
- * - `ValidationModes.onBlur` — validates each field on blur
203
- * - `ValidationModes.onChange` — validates each field on every change
204
- * - `ValidationModes.onTouched` — validates on blur first, then on every change once touched
205
- */
206
- connect?: ConnectOptions;
207
- /**
208
- * Initial form values. May be a static object or an async factory function.
209
- * While a factory is pending, `form.isLoading` is `true` and the form is read-only.
210
- */
211
- defaultValues?: {
212
- [K in keyof TValues]: TValues[K];
213
- } | (() => Promise<{
214
- [K in keyof TValues]: TValues[K];
215
- }>);
216
- /**
217
- * Called when an async `defaultValues` factory rejects.
218
- * Use to show an error UI or retry logic. In development, a warning is also emitted via `console.warn`.
219
- */
220
- onLoadError?: (error: unknown) => void;
221
- /**
222
- * Form-level validator. Accepts either:
223
- * - A `FormValidator` function
224
- * - Any `safeParse`-compatible schema (auto-detected, works with `@vielzeug/spell`, Zod, Valibot)
225
- */
226
- validator?: FormValidator<TValues> | SafeParseSchema;
227
- /** Field-level validators keyed by field name or dot-notation path. */
228
- validators?: Partial<Record<FlatKeyOf<TValues>, FieldValidator>>;
229
- };
230
- /**
231
- * Named presets for common validation trigger strategies.
232
- * Pass to `createForm({ connect: ValidationModes.onBlur })`.
233
- *
234
- * - `onSubmit` — no automatic validation or touch. Clean until the user submits.
235
- * - `onBlur` — validates and marks touched on blur.
236
- * - `onChange` — validates on every keystroke (marks touched on blur).
237
- * - `onTouched` — validates on blur first, then on every change once touched.
238
- */
239
- export declare const ValidationModes: {
240
- readonly onBlur: {
241
- readonly touchOnBlur: true;
242
- readonly validateOnBlur: true;
243
- };
244
- readonly onChange: {
245
- readonly touchOnBlur: true;
246
- readonly validateOnChange: true;
247
- };
248
- readonly onSubmit: {};
249
- readonly onTouched: {
250
- readonly touchOnBlur: true;
251
- readonly validateOnBlur: true;
252
- readonly validateOnTouch: true;
253
- };
254
- };
255
- export interface Form<TValues extends Record<string, unknown> = Record<string, unknown>> {
256
- /** Returns a cached typed `ArrayField` helper for mutating array-valued fields. */
257
- array<K extends FlatKeyOf<TValues>>(name: K): ArrayField<ElementOf<TypeAtPath<TValues, K>>>;
258
- batch(fn: () => void): void;
259
- /** Clear a single field error. No-op if the field has no error. */
260
- clearError(name: ErrorKeyOf<TValues>): void;
261
- /**
262
- * Returns a live connection object for a field (DOM event handlers + live getters).
263
- * Each call to `connect()` creates a new object with its own debounce timer.
264
- * Call `binding.dispose()` on unmount to cancel any pending debounce timer.
265
- * Do not destructure: getters re-evaluate on every property access.
266
- */
267
- connect<K extends FlatKeyOf<TValues>>(name: K, config?: ConnectOptions): ConnectionResult<TypeAtPath<TValues, K>>;
268
- dispose(): void;
269
- /** Aborted when `dispose()` is called. Use to cancel async work tied to this form's lifetime. */
71
+ export type Form<TValues extends Record<string, unknown>> = {
72
+ [Symbol.dispose](): void;
270
73
  readonly disposalSignal: AbortSignal;
74
+ dispose(): void;
271
75
  readonly disposed: boolean;
272
- field<K extends FlatKeyOf<TValues>>(name: K): FieldState<TypeAtPath<TValues, K>>;
273
- get<K extends FlatKeyOf<TValues>>(name: K): TypeAtPath<TValues, K>;
274
- /** `true` while an async `defaultValues` factory is resolving. Mirrors `state.isLoading`. */
275
- readonly isLoading: boolean;
276
- /** `true` while a `submit()` call is in progress. Mirrors `state.isSubmitting`. */
277
- readonly isSubmitting: boolean;
278
- /**
279
- * Merge a partial server response into the form: updates both the store and the baseline
280
- * for each provided field, marking them clean. Fields not included in `partial` are untouched.
281
- */
282
- patch(partial: DeepPartial<TValues>): void;
283
- /**
284
- * Field-lifecycle namespace — use to dynamically register/remove fields and manage validators.
285
- *
286
- * @example
287
- * const unsub = form.fields.register('email', { defaultValue: '', validator: required });
288
- * form.fields.setValidator('email', (v) => v ? undefined : 'Required');
289
- * form.fields.remove('email');
290
- */
291
- fields: {
292
- /**
293
- * Enumerate all currently-known field paths: the deduplicated union of populated store
294
- * keys and keys with a registered validator (the same definition `touchAll()` uses).
295
- * On a scoped form, paths are relative to the scope's prefix — matching `scope.state`'s
296
- * relative-path convention, not `state.touchedFields`'s absolute-path convention.
297
- */
298
- list(): readonly string[];
299
- /**
300
- * Declare a dynamic field with an optional default value and validator.
301
- * If the field does not yet exist in the store, `defaultValue` is written to both the
302
- * store and the baseline so the field starts clean (not dirty).
303
- * Returns an **unregister** callback that calls `fields.remove()` on the same field.
304
- */
305
- register<K extends FlatKeyOf<TValues>>(name: K, options?: RegisterFieldOptions<TypeAtPath<TValues, K>>): Unsubscribe;
306
- /** Remove a field entirely: drops value, dirty, touched, error, and any registered validator. */
307
- remove(name: FlatKeyOf<TValues>): void;
308
- /**
309
- * Add, replace, or remove a field validator.
310
- * Removing a validator (passing `undefined`) also immediately clears any existing error for that field.
311
- */
312
- setValidator(name: FlatKeyOf<TValues>, validator?: FieldValidator): void;
313
- };
314
- /**
315
- * Undo/redo-style snapshotting — see {@link FormHistory}. Namespaced off the main surface
316
- * since it's a distinctly less common operation than reading/writing values.
317
- *
318
- * @example
319
- * const before = form.history.snapshot();
320
- * form.patch({ status: 'archived' });
321
- * form.history.restore(before); // undo
322
- */
323
- history: FormHistory<TValues>;
324
- /** Replace values and baseline in one operation. Aborts any in-flight validation. */
325
- replace(newValues: TValues): void;
326
- /** Restore values from the current baseline and clear errors/touched/dirty. Aborts any in-flight validation. */
327
- reset(): void;
328
- resetField(name: FlatKeyOf<TValues>): void;
329
- /** Replace the entire error map. Use `undefined` values to omit entries. */
330
- resetErrors(errors?: Partial<Record<ErrorKeyOf<TValues>, string | undefined>>): void;
331
- /**
332
- * Returns a scoped sub-form whose field paths are relative to `prefix`.
333
- * `scopedForm.get('city')` is equivalent to `form.get('${prefix}.city')`.
334
- * The scoped form shares state and lifecycle with the parent — `dispose()` on a scoped
335
- * form is a no-op; call `parentForm.dispose()` to tear down the whole form.
336
- *
337
- * Results are memoized — calling `scope(prefix)` multiple times with the same prefix
338
- * returns the same object. Safe to call on every render.
339
- *
340
- * **`state`** returns a scoped projection: `errors`, `touchedFields`, `validatingFields`,
341
- * `isValid`, `isDirty`, and `isTouched` reflect only fields within this prefix.
342
- * `isSubmitting`, `isLoading`, `isValidating`, and `submitCount` reflect the full form.
343
- */
344
- scope<P extends FlatKeyOf<TValues>>(prefix: P): Form<ScopedValues<TValues, P>>;
345
- set<K extends FlatKeyOf<TValues>>(name: K, value: TypeAtPath<TValues, K>, options?: SetOptions): void;
346
- /** Set a field error. */
347
- setError(name: ErrorKeyOf<TValues>, message: string): void;
348
- readonly state: FormState;
349
- submit<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<SubmitResult<TResult>>;
350
- /**
351
- * Like `submit()` but throws a `ForgeValidationError` when validation fails instead of returning
352
- * `{ ok: false, ... }`. Use when you prefer a throw-based control flow.
353
- *
354
- * @throws {ForgeValidationError} when validation fails.
355
- * @throws {ForgeSubmitError} when `submit()` is already in progress.
356
- */
357
- submitOrThrow<TResult = void>(handler: (values: TValues) => MaybePromise<TResult>): Promise<TResult>;
358
- /**
359
- * Subscribe to form state changes.
360
- * On a scoped form (`form.scope(prefix)`), `errors`, `touchedFields`, and `validatingFields`
361
- * are remapped to relative paths, and the listener fires only when the scoped projection
362
- * changes — mutations outside the scope's prefix are suppressed. On a root form, no
363
- * filtering is applied.
364
- */
365
- subscribe(listener: (state: FormState) => void, options?: SubscribeOptions): Unsubscribe;
366
- subscribeField<K extends FlatKeyOf<TValues>>(name: K, listener: (state: FieldState<TypeAtPath<TValues, K>>) => void, options?: SubscribeOptions): Unsubscribe;
367
- /**
368
- * Iterate over form state changes via `for await`.
369
- * Yields the current state immediately, then once per mutation until the iterator
370
- * is returned or the form is disposed.
371
- *
372
- * @example
373
- * for await (const state of form) {
374
- * if (state.isSubmitting) showSpinner();
375
- * }
376
- */
377
- [Symbol.asyncIterator](): AsyncIterableIterator<FormState>;
378
- /** Delegates to `dispose()`. Enables `using` declarations. */
379
- [Symbol.dispose](): void;
380
- /** Mark a field as touched. */
381
- touch(name: FlatKeyOf<TValues>): void;
382
- /** Mark all known fields (store + validators) as touched. */
383
- touchAll(): void;
384
- /** Mark a field as untouched. No-op if the field is not currently touched. */
385
- untouch(name: FlatKeyOf<TValues>): void;
386
- /** Mark all fields as untouched. */
387
- untouchAll(): void;
388
- /**
389
- * Validate all registered field validators and the optional form validator.
390
- *
391
- * On a scoped form: validates only the fields within the scope and does not run the
392
- * form-level validator. Errors and `valid` reflect only scoped fields.
393
- */
394
- validate(signal?: AbortSignal): Promise<ValidateResult>;
395
- /**
396
- * Validate a single named field. Preserves other fields' errors. Does not run the form-level validator.
397
- * Returns a `ValidateResult` scoped to that field — `errors` contains at most one entry.
398
- */
399
- validate(name: FlatKeyOf<TValues>, signal?: AbortSignal): Promise<ValidateResult>;
400
- /**
401
- * Validate a specific set of fields. Preserves other fields' errors. Does not run the form-level validator.
402
- * Returns a `ValidateResult` scoped to the requested fields.
403
- */
404
- validate(fields: FlatKeyOf<TValues>[], signal?: AbortSignal): Promise<ValidateResult>;
405
- values(): TValues;
406
- }
76
+ field<K extends keyof TValues & string>(key: K): Field<TValues[K]>;
77
+ reset(next?: TValues): void;
78
+ set(next: TValues | ((previous: ReadonlyDeep<TValues>) => TValues)): void;
79
+ readonly state: FormState<TValues>;
80
+ submit<TResult = void>(handler: (values: ReadonlyDeep<TValues>) => MaybePromise<TResult>): Promise<SubmitResult<TResult, TValues>>;
81
+ subscribe(listener: (state: FormState<TValues>) => void, options?: SubscribeOptions): Unsubscribe;
82
+ validate(signal?: AbortSignal): Promise<ValidationResult<TValues>>;
83
+ readonly value: ReadonlyDeep<TValues>;
84
+ };
407
85
  export {};
408
86
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/vault.cjs ADDED
@@ -0,0 +1,2 @@
1
+ Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});async function e(e,t,n,r,i){let a=await t.get(n,r);if(!a)return!1;let o=i.fromRecord(a);return o?(e.reset(o),!0):!1}async function t(e,t,n,r){await t.put(n,r.toRecord(e.value))}exports.loadForm=e,exports.saveForm=t;
2
+ //# sourceMappingURL=vault.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault.cjs","names":[],"sources":["../src/vault.ts"],"sourcesContent":["import type { AnySchema, KeyOf, RecordOf, VaultStore } from '@vielzeug/vault';\n\nimport type { Form, ReadonlyDeep } from './types';\n\nexport type FormDraftCodec<\n TValues extends Record<string, unknown>,\n S extends AnySchema,\n K extends keyof S & string,\n> = Readonly<{\n fromRecord(record: RecordOf<S, K>): TValues | undefined;\n toRecord(values: ReadonlyDeep<TValues>): RecordOf<S, K>;\n}>;\n\n/** Explicit save/load avoids hidden autosave, migration, and persistence-policy side effects. */\nexport async function loadForm<\n TValues extends Record<string, unknown>,\n S extends AnySchema,\n K extends keyof S & string,\n>(\n form: Form<TValues>,\n adapter: VaultStore<S>,\n table: K,\n key: KeyOf<S, K>,\n codec: FormDraftCodec<TValues, S, K>,\n): Promise<boolean> {\n const record = await adapter.get(table, key);\n\n if (!record) return false;\n\n const values = codec.fromRecord(record);\n\n if (!values) return false;\n\n form.reset(values);\n\n return true;\n}\n\nexport async function saveForm<\n TValues extends Record<string, unknown>,\n S extends AnySchema,\n K extends keyof S & string,\n>(form: Form<TValues>, adapter: VaultStore<S>, table: K, codec: FormDraftCodec<TValues, S, K>): Promise<void> {\n await adapter.put(table, codec.toRecord(form.value));\n}\n"],"mappings":"mEAcA,eAAsB,EAKpB,EACA,EACA,EACA,EACA,EACkB,CAClB,IAAM,EAAS,MAAM,EAAQ,IAAI,EAAO,CAAG,EAE3C,GAAI,CAAC,EAAQ,MAAO,GAEpB,IAAM,EAAS,EAAM,WAAW,CAAM,EAMtC,OAJK,GAEL,EAAK,MAAM,CAAM,EAEV,IAJa,EAKtB,CAEA,eAAsB,EAIpB,EAAqB,EAAwB,EAAU,EAAqD,CAC5G,MAAM,EAAQ,IAAI,EAAO,EAAM,SAAS,EAAK,KAAK,CAAC,CACrD"}
@@ -0,0 +1,10 @@
1
+ import type { AnySchema, KeyOf, RecordOf, VaultStore } from '@vielzeug/vault';
2
+ import type { Form, ReadonlyDeep } from './types';
3
+ export type FormDraftCodec<TValues extends Record<string, unknown>, S extends AnySchema, K extends keyof S & string> = Readonly<{
4
+ fromRecord(record: RecordOf<S, K>): TValues | undefined;
5
+ toRecord(values: ReadonlyDeep<TValues>): RecordOf<S, K>;
6
+ }>;
7
+ /** Explicit save/load avoids hidden autosave, migration, and persistence-policy side effects. */
8
+ export declare function loadForm<TValues extends Record<string, unknown>, S extends AnySchema, K extends keyof S & string>(form: Form<TValues>, adapter: VaultStore<S>, table: K, key: KeyOf<S, K>, codec: FormDraftCodec<TValues, S, K>): Promise<boolean>;
9
+ export declare function saveForm<TValues extends Record<string, unknown>, S extends AnySchema, K extends keyof S & string>(form: Form<TValues>, adapter: VaultStore<S>, table: K, codec: FormDraftCodec<TValues, S, K>): Promise<void>;
10
+ //# sourceMappingURL=vault.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,MAAM,cAAc,CACxB,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,IACxB,QAAQ,CAAC;IACX,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACzD,CAAC,CAAC;AAEH,iGAAiG;AACjG,wBAAsB,QAAQ,CAC5B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAE1B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EACnB,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,KAAK,EAAE,CAAC,EACR,GAAG,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAChB,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,GACnC,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAsB,QAAQ,CAC5B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,CAAC,SAAS,SAAS,EACnB,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAC1B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5G"}
package/dist/vault.js ADDED
@@ -0,0 +1,14 @@
1
+ //#region src/vault.ts
2
+ async function e(e, t, n, r, i) {
3
+ let a = await t.get(n, r);
4
+ if (!a) return !1;
5
+ let o = i.fromRecord(a);
6
+ return o ? (e.reset(o), !0) : !1;
7
+ }
8
+ async function t(e, t, n, r) {
9
+ await t.put(n, r.toRecord(e.value));
10
+ }
11
+ //#endregion
12
+ export { e as loadForm, t as saveForm };
13
+
14
+ //# sourceMappingURL=vault.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vault.js","names":[],"sources":["../src/vault.ts"],"sourcesContent":["import type { AnySchema, KeyOf, RecordOf, VaultStore } from '@vielzeug/vault';\n\nimport type { Form, ReadonlyDeep } from './types';\n\nexport type FormDraftCodec<\n TValues extends Record<string, unknown>,\n S extends AnySchema,\n K extends keyof S & string,\n> = Readonly<{\n fromRecord(record: RecordOf<S, K>): TValues | undefined;\n toRecord(values: ReadonlyDeep<TValues>): RecordOf<S, K>;\n}>;\n\n/** Explicit save/load avoids hidden autosave, migration, and persistence-policy side effects. */\nexport async function loadForm<\n TValues extends Record<string, unknown>,\n S extends AnySchema,\n K extends keyof S & string,\n>(\n form: Form<TValues>,\n adapter: VaultStore<S>,\n table: K,\n key: KeyOf<S, K>,\n codec: FormDraftCodec<TValues, S, K>,\n): Promise<boolean> {\n const record = await adapter.get(table, key);\n\n if (!record) return false;\n\n const values = codec.fromRecord(record);\n\n if (!values) return false;\n\n form.reset(values);\n\n return true;\n}\n\nexport async function saveForm<\n TValues extends Record<string, unknown>,\n S extends AnySchema,\n K extends keyof S & string,\n>(form: Form<TValues>, adapter: VaultStore<S>, table: K, codec: FormDraftCodec<TValues, S, K>): Promise<void> {\n await adapter.put(table, codec.toRecord(form.value));\n}\n"],"mappings":";AAcA,eAAsB,EAKpB,GACA,GACA,GACA,GACA,GACkB;CAClB,IAAM,IAAS,MAAM,EAAQ,IAAI,GAAO,CAAG;CAE3C,IAAI,CAAC,GAAQ,OAAO;CAEpB,IAAM,IAAS,EAAM,WAAW,CAAM;CAMtC,OAJK,KAEL,EAAK,MAAM,CAAM,GAEV,MAJa;AAKtB;AAEA,eAAsB,EAIpB,GAAqB,GAAwB,GAAU,GAAqD;CAC5G,MAAM,EAAQ,IAAI,GAAO,EAAM,SAAS,EAAK,KAAK,CAAC;AACrD"}