@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.
- package/README.md +21 -53
- package/dist/_utils.cjs +1 -2
- package/dist/_utils.d.ts +1 -10
- package/dist/_utils.d.ts.map +1 -1
- package/dist/_utils.js +2 -33
- package/dist/adapters/form-data.cjs +1 -1
- package/dist/adapters/form-data.cjs.map +1 -1
- package/dist/adapters/form-data.d.ts.map +1 -1
- package/dist/adapters/form-data.js +5 -5
- package/dist/adapters/form-data.js.map +1 -1
- package/dist/core/path.cjs +2 -0
- package/dist/core/path.cjs.map +1 -0
- package/dist/core/path.d.ts +22 -0
- package/dist/core/path.d.ts.map +1 -0
- package/dist/core/path.js +125 -0
- package/dist/core/path.js.map +1 -0
- package/dist/devtools.cjs +1 -1
- package/dist/devtools.cjs.map +1 -1
- package/dist/devtools.d.ts +3 -36
- package/dist/devtools.d.ts.map +1 -1
- package/dist/devtools.js +6 -24
- package/dist/devtools.js.map +1 -1
- package/dist/dom.cjs +2 -0
- package/dist/dom.cjs.map +1 -0
- package/dist/dom.d.ts +9 -0
- package/dist/dom.d.ts.map +1 -0
- package/dist/dom.js +24 -0
- package/dist/dom.js.map +1 -0
- package/dist/errors.cjs +1 -1
- package/dist/errors.cjs.map +1 -1
- package/dist/errors.d.ts +1 -3
- package/dist/errors.d.ts.map +1 -1
- package/dist/errors.js +1 -6
- package/dist/errors.js.map +1 -1
- package/dist/forge.cjs +1 -1
- package/dist/forge.cjs.map +1 -1
- package/dist/forge.iife.js +1 -1
- package/dist/forge.iife.js.map +1 -1
- package/dist/forge.js +1 -1
- package/dist/forge.js.map +1 -1
- package/dist/form.cjs +1 -1
- package/dist/form.cjs.map +1 -1
- package/dist/form.d.ts +3 -5
- package/dist/form.d.ts.map +1 -1
- package/dist/form.js +223 -58
- package/dist/form.js.map +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.js +3 -4
- package/dist/spell.cjs +2 -0
- package/dist/spell.cjs.map +1 -0
- package/dist/spell.d.ts +5 -0
- package/dist/spell.d.ts.map +1 -0
- package/dist/spell.js +57 -0
- package/dist/spell.js.map +1 -0
- package/dist/types.d.ts +70 -392
- package/dist/types.d.ts.map +1 -1
- package/dist/vault.cjs +2 -0
- package/dist/vault.cjs.map +1 -0
- package/dist/vault.d.ts +10 -0
- package/dist/vault.d.ts.map +1 -0
- package/dist/vault.js +14 -0
- package/dist/vault.js.map +1 -0
- package/package.json +49 -13
- package/dist/_dev.cjs +0 -2
- package/dist/_dev.cjs.map +0 -1
- package/dist/_dev.js +0 -12
- package/dist/_dev.js.map +0 -1
- package/dist/_utils.cjs.map +0 -1
- package/dist/_utils.js.map +0 -1
- package/dist/adapters/validators.cjs +0 -2
- package/dist/adapters/validators.cjs.map +0 -1
- package/dist/adapters/validators.d.ts +0 -44
- package/dist/adapters/validators.d.ts.map +0 -1
- package/dist/adapters/validators.js +0 -20
- package/dist/adapters/validators.js.map +0 -1
- package/dist/core/array.cjs +0 -2
- package/dist/core/array.cjs.map +0 -1
- package/dist/core/array.d.ts +0 -10
- package/dist/core/array.d.ts.map +0 -1
- package/dist/core/array.js +0 -77
- package/dist/core/array.js.map +0 -1
- package/dist/core/asyncQueue.cjs +0 -2
- package/dist/core/asyncQueue.cjs.map +0 -1
- package/dist/core/asyncQueue.d.ts +0 -22
- package/dist/core/asyncQueue.d.ts.map +0 -1
- package/dist/core/asyncQueue.js +0 -67
- package/dist/core/asyncQueue.js.map +0 -1
- package/dist/core/context.cjs +0 -2
- package/dist/core/context.cjs.map +0 -1
- package/dist/core/context.d.ts +0 -7
- package/dist/core/context.d.ts.map +0 -1
- package/dist/core/context.js +0 -139
- package/dist/core/context.js.map +0 -1
- package/dist/core/fields.cjs +0 -2
- package/dist/core/fields.cjs.map +0 -1
- package/dist/core/fields.d.ts +0 -52
- package/dist/core/fields.d.ts.map +0 -1
- package/dist/core/fields.js +0 -310
- package/dist/core/fields.js.map +0 -1
- package/dist/core/lifecycle.cjs +0 -2
- package/dist/core/lifecycle.cjs.map +0 -1
- package/dist/core/lifecycle.d.ts +0 -15
- package/dist/core/lifecycle.d.ts.map +0 -1
- package/dist/core/lifecycle.js +0 -38
- package/dist/core/lifecycle.js.map +0 -1
- package/dist/core/notifier.cjs +0 -2
- package/dist/core/notifier.cjs.map +0 -1
- package/dist/core/notifier.d.ts +0 -33
- package/dist/core/notifier.d.ts.map +0 -1
- package/dist/core/notifier.js +0 -78
- package/dist/core/notifier.js.map +0 -1
- package/dist/core/observe.cjs +0 -2
- package/dist/core/observe.cjs.map +0 -1
- package/dist/core/observe.d.ts +0 -20
- package/dist/core/observe.d.ts.map +0 -1
- package/dist/core/observe.js +0 -79
- package/dist/core/observe.js.map +0 -1
- package/dist/core/scope.cjs +0 -2
- package/dist/core/scope.cjs.map +0 -1
- package/dist/core/scope.d.ts +0 -11
- package/dist/core/scope.d.ts.map +0 -1
- package/dist/core/scope.js +0 -235
- package/dist/core/scope.js.map +0 -1
- package/dist/types.cjs +0 -2
- package/dist/types.cjs.map +0 -1
- package/dist/types.js +0 -21
- 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
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
};
|
|
10
|
-
export type
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
52
|
-
|
|
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
|
-
|
|
116
|
-
|
|
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
|
-
|
|
121
|
-
|
|
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
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
readonly
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
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
|
package/dist/types.d.ts.map
CHANGED
|
@@ -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"}
|
package/dist/vault.d.ts
ADDED
|
@@ -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"}
|