@tanstack/form-core 0.2.0 → 0.3.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 (55) hide show
  1. package/package.json +1 -1
  2. package/src/FieldApi.ts +53 -29
  3. package/src/FormApi.ts +14 -7
  4. package/src/tests/FieldApi.spec.ts +84 -17
  5. package/src/utils.ts +4 -0
  6. package/build/legacy/FieldApi.cjs +0 -256
  7. package/build/legacy/FieldApi.cjs.map +0 -1
  8. package/build/legacy/FieldApi.d.cts +0 -3
  9. package/build/legacy/FieldApi.d.ts +0 -3
  10. package/build/legacy/FieldApi.js +0 -223
  11. package/build/legacy/FieldApi.js.map +0 -1
  12. package/build/legacy/FormApi.cjs +0 -255
  13. package/build/legacy/FormApi.cjs.map +0 -1
  14. package/build/legacy/FormApi.d.cts +0 -3
  15. package/build/legacy/FormApi.d.ts +0 -3
  16. package/build/legacy/FormApi.js +0 -232
  17. package/build/legacy/FormApi.js.map +0 -1
  18. package/build/legacy/chunk-4QZDOMDG.js +0 -19
  19. package/build/legacy/chunk-4QZDOMDG.js.map +0 -1
  20. package/build/legacy/index.cjs +0 -29
  21. package/build/legacy/index.cjs.map +0 -1
  22. package/build/legacy/index.d.cts +0 -171
  23. package/build/legacy/index.d.ts +0 -171
  24. package/build/legacy/index.js +0 -5
  25. package/build/legacy/index.js.map +0 -1
  26. package/build/legacy/utils.cjs +0 -98
  27. package/build/legacy/utils.cjs.map +0 -1
  28. package/build/legacy/utils.d.cts +0 -32
  29. package/build/legacy/utils.d.ts +0 -32
  30. package/build/legacy/utils.js +0 -73
  31. package/build/legacy/utils.js.map +0 -1
  32. package/build/modern/FieldApi.cjs +0 -238
  33. package/build/modern/FieldApi.cjs.map +0 -1
  34. package/build/modern/FieldApi.d.cts +0 -3
  35. package/build/modern/FieldApi.d.ts +0 -3
  36. package/build/modern/FieldApi.js +0 -213
  37. package/build/modern/FieldApi.js.map +0 -1
  38. package/build/modern/FormApi.cjs +0 -249
  39. package/build/modern/FormApi.cjs.map +0 -1
  40. package/build/modern/FormApi.d.cts +0 -3
  41. package/build/modern/FormApi.d.ts +0 -3
  42. package/build/modern/FormApi.js +0 -224
  43. package/build/modern/FormApi.js.map +0 -1
  44. package/build/modern/index.cjs +0 -29
  45. package/build/modern/index.cjs.map +0 -1
  46. package/build/modern/index.d.cts +0 -171
  47. package/build/modern/index.d.ts +0 -171
  48. package/build/modern/index.js +0 -5
  49. package/build/modern/index.js.map +0 -1
  50. package/build/modern/utils.cjs +0 -98
  51. package/build/modern/utils.cjs.map +0 -1
  52. package/build/modern/utils.d.cts +0 -32
  53. package/build/modern/utils.d.ts +0 -32
  54. package/build/modern/utils.js +0 -71
  55. package/build/modern/utils.js.map +0 -1
@@ -1,256 +0,0 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __export = (target, all) => {
7
- for (var name in all)
8
- __defProp(target, name, { get: all[name], enumerable: true });
9
- };
10
- var __copyProps = (to, from, except, desc) => {
11
- if (from && typeof from === "object" || typeof from === "function") {
12
- for (let key of __getOwnPropNames(from))
13
- if (!__hasOwnProp.call(to, key) && key !== except)
14
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
- }
16
- return to;
17
- };
18
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
- var __accessCheck = (obj, member, msg) => {
20
- if (!member.has(obj))
21
- throw TypeError("Cannot " + msg);
22
- };
23
- var __privateGet = (obj, member, getter) => {
24
- __accessCheck(obj, member, "read from private field");
25
- return getter ? getter.call(obj) : member.get(obj);
26
- };
27
- var __privateAdd = (obj, member, value) => {
28
- if (member.has(obj))
29
- throw TypeError("Cannot add the same private member more than once");
30
- member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
31
- };
32
-
33
- // src/FieldApi.ts
34
- var FieldApi_exports = {};
35
- __export(FieldApi_exports, {
36
- FieldApi: () => FieldApi
37
- });
38
- module.exports = __toCommonJS(FieldApi_exports);
39
- var import_store = require("@tanstack/store");
40
- var uid = 0;
41
- var _leaseValidateAsync;
42
- var _FieldApi = class _FieldApi {
43
- constructor(opts) {
44
- this.options = {};
45
- this.mount = () => {
46
- var _a, _b;
47
- const info = this.getInfo();
48
- info.instances[this.uid] = this;
49
- const unsubscribe = this.form.store.subscribe(() => {
50
- this.store.batch(() => {
51
- const nextValue = this.getValue();
52
- const nextMeta = this.getMeta();
53
- if (nextValue !== this.state.value) {
54
- this.store.setState((prev) => ({ ...prev, value: nextValue }));
55
- }
56
- if (nextMeta !== this.state.meta) {
57
- this.store.setState((prev) => ({ ...prev, meta: nextMeta }));
58
- }
59
- });
60
- });
61
- this.update(this.options);
62
- (_b = (_a = this.options).onMount) == null ? void 0 : _b.call(_a, this);
63
- return () => {
64
- unsubscribe();
65
- delete info.instances[this.uid];
66
- if (!Object.keys(info.instances).length) {
67
- delete this.form.fieldInfo[this.name];
68
- }
69
- };
70
- };
71
- this.update = (opts) => {
72
- var _a;
73
- if (this.state.value === void 0) {
74
- const formDefault = (_a = opts.form.options.defaultValues) == null ? void 0 : _a[opts.name];
75
- if (opts.defaultValue !== void 0) {
76
- this.setValue(opts.defaultValue);
77
- } else if (formDefault !== void 0) {
78
- this.setValue(formDefault);
79
- }
80
- }
81
- if (this._getMeta() === void 0) {
82
- this.setMeta(this.state.meta);
83
- }
84
- this.options = opts;
85
- };
86
- this.getValue = () => {
87
- return this.form.getFieldValue(this.name);
88
- };
89
- this.setValue = (updater, options) => {
90
- this.form.setFieldValue(this.name, updater, options);
91
- this.validate("change", this.state.value);
92
- };
93
- this._getMeta = () => this.form.getFieldMeta(this.name);
94
- this.getMeta = () => this._getMeta() ?? {
95
- isValidating: false,
96
- isTouched: false,
97
- ...this.options.defaultMeta
98
- };
99
- this.setMeta = (updater) => this.form.setFieldMeta(this.name, updater);
100
- this.getInfo = () => this.form.getFieldInfo(this.name);
101
- this.pushValue = (value) => this.form.pushFieldValue(this.name, value);
102
- this.insertValue = (index, value) => this.form.insertFieldValue(this.name, index, value);
103
- this.removeValue = (index) => this.form.removeFieldValue(this.name, index);
104
- this.swapValues = (aIndex, bIndex) => this.form.swapFieldValues(this.name, aIndex, bIndex);
105
- this.getSubField = (name) => new _FieldApi({
106
- name: `${this.name}.${name}`,
107
- form: this.form
108
- });
109
- this.validateSync = (value = this.state.value, cause) => {
110
- const { onChange, onBlur } = this.options;
111
- const validate = cause === "submit" ? void 0 : cause === "change" ? onChange : onBlur;
112
- if (!validate)
113
- return;
114
- const validationCount = (this.getInfo().validationCount || 0) + 1;
115
- this.getInfo().validationCount = validationCount;
116
- const error = normalizeError(validate(value, this));
117
- if (this.state.meta.error !== error) {
118
- this.setMeta((prev) => ({
119
- ...prev,
120
- error
121
- }));
122
- }
123
- if (this.state.meta.error) {
124
- this.cancelValidateAsync();
125
- }
126
- };
127
- __privateAdd(this, _leaseValidateAsync, () => {
128
- const count = (this.getInfo().validationAsyncCount || 0) + 1;
129
- this.getInfo().validationAsyncCount = count;
130
- return count;
131
- });
132
- this.cancelValidateAsync = () => {
133
- __privateGet(this, _leaseValidateAsync).call(this);
134
- this.setMeta((prev) => ({
135
- ...prev,
136
- isValidating: false
137
- }));
138
- };
139
- this.validateAsync = async (value = this.state.value, cause) => {
140
- var _a, _b, _c, _d;
141
- const {
142
- onChangeAsync,
143
- onBlurAsync,
144
- onSubmitAsync,
145
- asyncDebounceMs,
146
- onBlurAsyncDebounceMs,
147
- onChangeAsyncDebounceMs
148
- } = this.options;
149
- const validate = cause === "change" ? onChangeAsync : cause === "submit" ? onSubmitAsync : onBlurAsync;
150
- if (!validate)
151
- return;
152
- const debounceMs = cause === "submit" ? 0 : (cause === "change" ? onChangeAsyncDebounceMs : onBlurAsyncDebounceMs) ?? asyncDebounceMs ?? 0;
153
- if (this.state.meta.isValidating !== true)
154
- this.setMeta((prev) => ({ ...prev, isValidating: true }));
155
- const validationAsyncCount = __privateGet(this, _leaseValidateAsync).call(this);
156
- const checkLatest = () => validationAsyncCount === this.getInfo().validationAsyncCount;
157
- if (!this.getInfo().validationPromise) {
158
- this.getInfo().validationPromise = new Promise((resolve, reject) => {
159
- this.getInfo().validationResolve = resolve;
160
- this.getInfo().validationReject = reject;
161
- });
162
- }
163
- if (debounceMs > 0) {
164
- await new Promise((r) => setTimeout(r, debounceMs));
165
- }
166
- if (checkLatest()) {
167
- try {
168
- const rawError = await validate(value, this);
169
- if (checkLatest()) {
170
- const error = normalizeError(rawError);
171
- this.setMeta((prev) => ({
172
- ...prev,
173
- isValidating: false,
174
- error
175
- }));
176
- (_b = (_a = this.getInfo()).validationResolve) == null ? void 0 : _b.call(_a, error);
177
- }
178
- } catch (error) {
179
- if (checkLatest()) {
180
- (_d = (_c = this.getInfo()).validationReject) == null ? void 0 : _d.call(_c, error);
181
- throw error;
182
- }
183
- } finally {
184
- if (checkLatest()) {
185
- this.setMeta((prev) => ({ ...prev, isValidating: false }));
186
- delete this.getInfo().validationPromise;
187
- }
188
- }
189
- }
190
- return this.getInfo().validationPromise;
191
- };
192
- this.validate = (cause, value) => {
193
- if (!this.state.meta.isTouched)
194
- return;
195
- this.validateSync(value, cause);
196
- if (this.state.meta.error) {
197
- if (!this.options.asyncAlways) {
198
- return this.state.meta.error;
199
- }
200
- }
201
- return this.validateAsync(value, cause);
202
- };
203
- this.handleChange = (updater) => {
204
- this.setValue(updater, { touch: true });
205
- };
206
- this.handleBlur = () => {
207
- const prevTouched = this.state.meta.isTouched;
208
- if (!prevTouched) {
209
- this.setMeta((prev) => ({ ...prev, isTouched: true }));
210
- this.validate("change");
211
- }
212
- this.validate("blur");
213
- };
214
- this.form = opts.form;
215
- this.uid = uid++;
216
- this.name = opts.name;
217
- this.store = new import_store.Store(
218
- {
219
- value: this.getValue(),
220
- // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
221
- meta: this._getMeta() ?? {
222
- isValidating: false,
223
- isTouched: false,
224
- ...opts.defaultMeta
225
- }
226
- },
227
- {
228
- onUpdate: () => {
229
- const state = this.store.state;
230
- state.meta.touchedError = state.meta.isTouched ? state.meta.error : void 0;
231
- this.prevState = state;
232
- this.state = state;
233
- }
234
- }
235
- );
236
- this.state = this.store.state;
237
- this.prevState = this.state;
238
- this.options = opts;
239
- }
240
- };
241
- _leaseValidateAsync = new WeakMap();
242
- var FieldApi = _FieldApi;
243
- function normalizeError(rawError) {
244
- if (rawError) {
245
- if (typeof rawError !== "string") {
246
- return "Invalid Form Values";
247
- }
248
- return rawError;
249
- }
250
- return void 0;
251
- }
252
- // Annotate the CommonJS export names for ESM import in node:
253
- 0 && (module.exports = {
254
- FieldApi
255
- });
256
- //# sourceMappingURL=FieldApi.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, Updater } from './utils'\nimport type { FormApi, ValidationError } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit'\n\ntype ValidateFn<TData, TFormData> = (\n value: TData,\n fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n value: TData,\n fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n _TData,\n TFormData,\n /**\n * This allows us to restrict the name to only be a valid field name while\n * also assigning it to a generic\n */\n TName = unknown extends TFormData ? string : DeepKeys<TFormData>,\n /**\n * If TData is unknown, we can use the TName generic to determine the type\n */\n TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n name: TName\n index?: TData extends any[] ? number : never\n defaultValue?: TData\n asyncDebounceMs?: number\n asyncAlways?: boolean\n onMount?: (formApi: FieldApi<TData, TFormData>) => void\n onChange?: ValidateFn<TData, TFormData>\n onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n onChangeAsyncDebounceMs?: number\n onBlur?: ValidateFn<TData, TFormData>\n onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n onBlurAsyncDebounceMs?: number\n onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n defaultMeta?: Partial<FieldMeta>\n}\n\nexport type FieldApiOptions<TData, TFormData> = FieldOptions<\n TData,\n TFormData\n> & {\n form: FormApi<TFormData>\n}\n\nexport type FieldMeta = {\n isTouched: boolean\n touchedError?: ValidationError\n error?: ValidationError\n isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n value: TData\n meta: FieldMeta\n}\n\n/**\n * TData may not be known at the time of FieldApi construction, so we need to\n * use a conditional type to determine if TData is known or not.\n *\n * If TData is not known, we use the TFormData type to determine the type of\n * the field value based on the field name.\n */\ntype GetTData<Name, TData, TFormData> = unknown extends TData\n ? DeepValue<TFormData, Name>\n : TData\n\nexport class FieldApi<TData, TFormData> {\n uid: number\n form: FormApi<TFormData>\n name!: DeepKeys<TFormData>\n /**\n * This is a hack that allows us to use `GetTData` without calling it everywhere\n *\n * Unfortunately this hack appears to be needed alongside the `TName` hack\n * further up in this file. This properly types all of the internal methods,\n * while the `TName` hack types the options properly\n */\n _tdata!: GetTData<typeof this.name, TData, TFormData>\n store!: Store<FieldState<typeof this._tdata>>\n state!: FieldState<typeof this._tdata>\n prevState!: FieldState<typeof this._tdata>\n options: FieldOptions<typeof this._tdata, TFormData> = {} as any\n\n constructor(opts: FieldApiOptions<TData, TFormData>) {\n this.form = opts.form\n this.uid = uid++\n // Support field prefixing from FieldScope\n // let fieldPrefix = ''\n // if (this.form.fieldName) {\n // fieldPrefix = `${this.form.fieldName}.`\n // }\n\n this.name = opts.name as any\n\n this.store = new Store<FieldState<typeof this._tdata>>(\n {\n value: this.getValue(),\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n meta: this._getMeta() ?? {\n isValidating: false,\n isTouched: false,\n ...opts.defaultMeta,\n },\n },\n {\n onUpdate: () => {\n const state = this.store.state\n\n state.meta.touchedError = state.meta.isTouched\n ? state.meta.error\n : undefined\n\n this.prevState = state\n this.state = state\n },\n },\n )\n\n this.state = this.store.state\n this.prevState = this.state\n this.options = opts as never\n }\n\n mount = () => {\n const info = this.getInfo()\n info.instances[this.uid] = this\n\n const unsubscribe = this.form.store.subscribe(() => {\n this.store.batch(() => {\n const nextValue = this.getValue()\n const nextMeta = this.getMeta()\n\n if (nextValue !== this.state.value) {\n this.store.setState((prev) => ({ ...prev, value: nextValue }))\n }\n\n if (nextMeta !== this.state.meta) {\n this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n }\n })\n })\n\n this.update(this.options as never)\n this.options.onMount?.(this as never)\n\n return () => {\n unsubscribe()\n delete info.instances[this.uid]\n if (!Object.keys(info.instances).length) {\n delete this.form.fieldInfo[this.name]\n }\n }\n }\n\n update = (opts: FieldApiOptions<typeof this._tdata, TFormData>) => {\n // Default Value\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (this.state.value === undefined) {\n const formDefault =\n opts.form.options.defaultValues?.[opts.name as keyof TFormData]\n\n if (opts.defaultValue !== undefined) {\n this.setValue(opts.defaultValue as never)\n } else if (formDefault !== undefined) {\n this.setValue(formDefault as never)\n }\n }\n\n // Default Meta\n if (this._getMeta() === undefined) {\n this.setMeta(this.state.meta)\n }\n\n this.options = opts as never\n }\n\n getValue = (): typeof this._tdata => {\n return this.form.getFieldValue(this.name)\n }\n\n setValue = (\n updater: Updater<typeof this._tdata>,\n options?: { touch?: boolean; notify?: boolean },\n ) => {\n this.form.setFieldValue(this.name, updater as never, options)\n this.validate('change', this.state.value)\n }\n\n _getMeta = () => this.form.getFieldMeta(this.name)\n getMeta = () =>\n this._getMeta() ??\n ({\n isValidating: false,\n isTouched: false,\n ...this.options.defaultMeta,\n } as FieldMeta)\n\n setMeta = (updater: Updater<FieldMeta>) =>\n this.form.setFieldMeta(this.name, updater)\n\n getInfo = () => this.form.getFieldInfo(this.name)\n\n pushValue = (\n value: typeof this._tdata extends any[]\n ? (typeof this._tdata)[number]\n : never,\n ) => this.form.pushFieldValue(this.name, value as any)\n\n insertValue = (\n index: number,\n value: typeof this._tdata extends any[]\n ? (typeof this._tdata)[number]\n : never,\n ) => this.form.insertFieldValue(this.name, index, value as any)\n\n removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n swapValues = (aIndex: number, bIndex: number) =>\n this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n getSubField = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>\n new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({\n name: `${this.name}.${name}` as never,\n form: this.form,\n })\n\n validateSync = (value = this.state.value, cause: ValidationCause) => {\n const { onChange, onBlur } = this.options\n const validate =\n cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n\n if (!validate) return\n\n // Use the validationCount for all field instances to\n // track freshness of the validation\n const validationCount = (this.getInfo().validationCount || 0) + 1\n this.getInfo().validationCount = validationCount\n const error = normalizeError(validate(value as never, this as never))\n\n if (this.state.meta.error !== error) {\n this.setMeta((prev) => ({\n ...prev,\n error,\n }))\n }\n\n // If a sync error is encountered, cancel any async validation\n if (this.state.meta.error) {\n this.cancelValidateAsync()\n }\n }\n\n #leaseValidateAsync = () => {\n const count = (this.getInfo().validationAsyncCount || 0) + 1\n this.getInfo().validationAsyncCount = count\n return count\n }\n\n cancelValidateAsync = () => {\n // Lease a new validation count to ignore any pending validations\n this.#leaseValidateAsync()\n // Cancel any pending validation state\n this.setMeta((prev) => ({\n ...prev,\n isValidating: false,\n }))\n }\n\n validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n const {\n onChangeAsync,\n onBlurAsync,\n onSubmitAsync,\n asyncDebounceMs,\n onBlurAsyncDebounceMs,\n onChangeAsyncDebounceMs,\n } = this.options\n\n const validate =\n cause === 'change'\n ? onChangeAsync\n : cause === 'submit'\n ? onSubmitAsync\n : onBlurAsync\n\n if (!validate) return\n\n const debounceMs =\n cause === 'submit'\n ? 0\n : (cause === 'change'\n ? onChangeAsyncDebounceMs\n : onBlurAsyncDebounceMs) ??\n asyncDebounceMs ??\n 0\n\n if (this.state.meta.isValidating !== true)\n this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n // Use the validationCount for all field instances to\n // track freshness of the validation\n const validationAsyncCount = this.#leaseValidateAsync()\n\n const checkLatest = () =>\n validationAsyncCount === this.getInfo().validationAsyncCount\n\n if (!this.getInfo().validationPromise) {\n this.getInfo().validationPromise = new Promise((resolve, reject) => {\n this.getInfo().validationResolve = resolve\n this.getInfo().validationReject = reject\n })\n }\n\n if (debounceMs > 0) {\n await new Promise((r) => setTimeout(r, debounceMs))\n }\n\n // Only kick off validation if this validation is the latest attempt\n if (checkLatest()) {\n try {\n const rawError = await validate(value as never, this as never)\n\n if (checkLatest()) {\n const error = normalizeError(rawError)\n this.setMeta((prev) => ({\n ...prev,\n isValidating: false,\n error,\n }))\n this.getInfo().validationResolve?.(error)\n }\n } catch (error) {\n if (checkLatest()) {\n this.getInfo().validationReject?.(error)\n throw error\n }\n } finally {\n if (checkLatest()) {\n this.setMeta((prev) => ({ ...prev, isValidating: false }))\n delete this.getInfo().validationPromise\n }\n }\n }\n\n // Always return the latest validation promise to the caller\n return this.getInfo().validationPromise\n }\n\n validate = (\n cause: ValidationCause,\n value?: typeof this._tdata,\n ): ValidationError | Promise<ValidationError> => {\n // If the field is pristine and validatePristine is false, do not validate\n if (!this.state.meta.isTouched) return\n\n // Attempt to sync validate first\n this.validateSync(value, cause)\n\n // If there is an error, return it, do not attempt async validation\n if (this.state.meta.error) {\n if (!this.options.asyncAlways) {\n return this.state.meta.error\n }\n }\n\n // No error? Attempt async validation\n return this.validateAsync(value, cause)\n }\n\n handleChange = (updater: Updater<typeof this._tdata>) => {\n this.setValue(updater, { touch: true })\n }\n\n handleBlur = () => {\n const prevTouched = this.state.meta.isTouched\n if (!prevTouched) {\n this.setMeta((prev) => ({ ...prev, isTouched: true }))\n this.validate('change')\n }\n this.validate('blur')\n }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n if (rawError) {\n if (typeof rawError !== 'string') {\n return 'Invalid Form Values'\n }\n\n return rawError\n }\n\n return undefined\n}\n"],"mappings":"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","names":[]}
@@ -1,3 +0,0 @@
1
- export { FieldApi, FieldApiOptions, FieldMeta, FieldOptions, FieldState, ValidationCause } from './index.cjs';
2
- import './utils.cjs';
3
- import '@tanstack/store';
@@ -1,3 +0,0 @@
1
- export { FieldApi, FieldApiOptions, FieldMeta, FieldOptions, FieldState, ValidationCause } from './index.js';
2
- import './utils.js';
3
- import '@tanstack/store';
@@ -1,223 +0,0 @@
1
- import {
2
- __privateAdd,
3
- __privateGet
4
- } from "./chunk-4QZDOMDG.js";
5
-
6
- // src/FieldApi.ts
7
- import { Store } from "@tanstack/store";
8
- var uid = 0;
9
- var _leaseValidateAsync;
10
- var _FieldApi = class _FieldApi {
11
- constructor(opts) {
12
- this.options = {};
13
- this.mount = () => {
14
- var _a, _b;
15
- const info = this.getInfo();
16
- info.instances[this.uid] = this;
17
- const unsubscribe = this.form.store.subscribe(() => {
18
- this.store.batch(() => {
19
- const nextValue = this.getValue();
20
- const nextMeta = this.getMeta();
21
- if (nextValue !== this.state.value) {
22
- this.store.setState((prev) => ({ ...prev, value: nextValue }));
23
- }
24
- if (nextMeta !== this.state.meta) {
25
- this.store.setState((prev) => ({ ...prev, meta: nextMeta }));
26
- }
27
- });
28
- });
29
- this.update(this.options);
30
- (_b = (_a = this.options).onMount) == null ? void 0 : _b.call(_a, this);
31
- return () => {
32
- unsubscribe();
33
- delete info.instances[this.uid];
34
- if (!Object.keys(info.instances).length) {
35
- delete this.form.fieldInfo[this.name];
36
- }
37
- };
38
- };
39
- this.update = (opts) => {
40
- var _a;
41
- if (this.state.value === void 0) {
42
- const formDefault = (_a = opts.form.options.defaultValues) == null ? void 0 : _a[opts.name];
43
- if (opts.defaultValue !== void 0) {
44
- this.setValue(opts.defaultValue);
45
- } else if (formDefault !== void 0) {
46
- this.setValue(formDefault);
47
- }
48
- }
49
- if (this._getMeta() === void 0) {
50
- this.setMeta(this.state.meta);
51
- }
52
- this.options = opts;
53
- };
54
- this.getValue = () => {
55
- return this.form.getFieldValue(this.name);
56
- };
57
- this.setValue = (updater, options) => {
58
- this.form.setFieldValue(this.name, updater, options);
59
- this.validate("change", this.state.value);
60
- };
61
- this._getMeta = () => this.form.getFieldMeta(this.name);
62
- this.getMeta = () => this._getMeta() ?? {
63
- isValidating: false,
64
- isTouched: false,
65
- ...this.options.defaultMeta
66
- };
67
- this.setMeta = (updater) => this.form.setFieldMeta(this.name, updater);
68
- this.getInfo = () => this.form.getFieldInfo(this.name);
69
- this.pushValue = (value) => this.form.pushFieldValue(this.name, value);
70
- this.insertValue = (index, value) => this.form.insertFieldValue(this.name, index, value);
71
- this.removeValue = (index) => this.form.removeFieldValue(this.name, index);
72
- this.swapValues = (aIndex, bIndex) => this.form.swapFieldValues(this.name, aIndex, bIndex);
73
- this.getSubField = (name) => new _FieldApi({
74
- name: `${this.name}.${name}`,
75
- form: this.form
76
- });
77
- this.validateSync = (value = this.state.value, cause) => {
78
- const { onChange, onBlur } = this.options;
79
- const validate = cause === "submit" ? void 0 : cause === "change" ? onChange : onBlur;
80
- if (!validate)
81
- return;
82
- const validationCount = (this.getInfo().validationCount || 0) + 1;
83
- this.getInfo().validationCount = validationCount;
84
- const error = normalizeError(validate(value, this));
85
- if (this.state.meta.error !== error) {
86
- this.setMeta((prev) => ({
87
- ...prev,
88
- error
89
- }));
90
- }
91
- if (this.state.meta.error) {
92
- this.cancelValidateAsync();
93
- }
94
- };
95
- __privateAdd(this, _leaseValidateAsync, () => {
96
- const count = (this.getInfo().validationAsyncCount || 0) + 1;
97
- this.getInfo().validationAsyncCount = count;
98
- return count;
99
- });
100
- this.cancelValidateAsync = () => {
101
- __privateGet(this, _leaseValidateAsync).call(this);
102
- this.setMeta((prev) => ({
103
- ...prev,
104
- isValidating: false
105
- }));
106
- };
107
- this.validateAsync = async (value = this.state.value, cause) => {
108
- var _a, _b, _c, _d;
109
- const {
110
- onChangeAsync,
111
- onBlurAsync,
112
- onSubmitAsync,
113
- asyncDebounceMs,
114
- onBlurAsyncDebounceMs,
115
- onChangeAsyncDebounceMs
116
- } = this.options;
117
- const validate = cause === "change" ? onChangeAsync : cause === "submit" ? onSubmitAsync : onBlurAsync;
118
- if (!validate)
119
- return;
120
- const debounceMs = cause === "submit" ? 0 : (cause === "change" ? onChangeAsyncDebounceMs : onBlurAsyncDebounceMs) ?? asyncDebounceMs ?? 0;
121
- if (this.state.meta.isValidating !== true)
122
- this.setMeta((prev) => ({ ...prev, isValidating: true }));
123
- const validationAsyncCount = __privateGet(this, _leaseValidateAsync).call(this);
124
- const checkLatest = () => validationAsyncCount === this.getInfo().validationAsyncCount;
125
- if (!this.getInfo().validationPromise) {
126
- this.getInfo().validationPromise = new Promise((resolve, reject) => {
127
- this.getInfo().validationResolve = resolve;
128
- this.getInfo().validationReject = reject;
129
- });
130
- }
131
- if (debounceMs > 0) {
132
- await new Promise((r) => setTimeout(r, debounceMs));
133
- }
134
- if (checkLatest()) {
135
- try {
136
- const rawError = await validate(value, this);
137
- if (checkLatest()) {
138
- const error = normalizeError(rawError);
139
- this.setMeta((prev) => ({
140
- ...prev,
141
- isValidating: false,
142
- error
143
- }));
144
- (_b = (_a = this.getInfo()).validationResolve) == null ? void 0 : _b.call(_a, error);
145
- }
146
- } catch (error) {
147
- if (checkLatest()) {
148
- (_d = (_c = this.getInfo()).validationReject) == null ? void 0 : _d.call(_c, error);
149
- throw error;
150
- }
151
- } finally {
152
- if (checkLatest()) {
153
- this.setMeta((prev) => ({ ...prev, isValidating: false }));
154
- delete this.getInfo().validationPromise;
155
- }
156
- }
157
- }
158
- return this.getInfo().validationPromise;
159
- };
160
- this.validate = (cause, value) => {
161
- if (!this.state.meta.isTouched)
162
- return;
163
- this.validateSync(value, cause);
164
- if (this.state.meta.error) {
165
- if (!this.options.asyncAlways) {
166
- return this.state.meta.error;
167
- }
168
- }
169
- return this.validateAsync(value, cause);
170
- };
171
- this.handleChange = (updater) => {
172
- this.setValue(updater, { touch: true });
173
- };
174
- this.handleBlur = () => {
175
- const prevTouched = this.state.meta.isTouched;
176
- if (!prevTouched) {
177
- this.setMeta((prev) => ({ ...prev, isTouched: true }));
178
- this.validate("change");
179
- }
180
- this.validate("blur");
181
- };
182
- this.form = opts.form;
183
- this.uid = uid++;
184
- this.name = opts.name;
185
- this.store = new Store(
186
- {
187
- value: this.getValue(),
188
- // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
189
- meta: this._getMeta() ?? {
190
- isValidating: false,
191
- isTouched: false,
192
- ...opts.defaultMeta
193
- }
194
- },
195
- {
196
- onUpdate: () => {
197
- const state = this.store.state;
198
- state.meta.touchedError = state.meta.isTouched ? state.meta.error : void 0;
199
- this.prevState = state;
200
- this.state = state;
201
- }
202
- }
203
- );
204
- this.state = this.store.state;
205
- this.prevState = this.state;
206
- this.options = opts;
207
- }
208
- };
209
- _leaseValidateAsync = new WeakMap();
210
- var FieldApi = _FieldApi;
211
- function normalizeError(rawError) {
212
- if (rawError) {
213
- if (typeof rawError !== "string") {
214
- return "Invalid Form Values";
215
- }
216
- return rawError;
217
- }
218
- return void 0;
219
- }
220
- export {
221
- FieldApi
222
- };
223
- //# sourceMappingURL=FieldApi.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/FieldApi.ts"],"sourcesContent":["import type { DeepKeys, DeepValue, Updater } from './utils'\nimport type { FormApi, ValidationError } from './FormApi'\nimport { Store } from '@tanstack/store'\n\nexport type ValidationCause = 'change' | 'blur' | 'submit'\n\ntype ValidateFn<TData, TFormData> = (\n value: TData,\n fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError\n\ntype ValidateAsyncFn<TData, TFormData> = (\n value: TData,\n fieldApi: FieldApi<TData, TFormData>,\n) => ValidationError | Promise<ValidationError>\n\nexport interface FieldOptions<\n _TData,\n TFormData,\n /**\n * This allows us to restrict the name to only be a valid field name while\n * also assigning it to a generic\n */\n TName = unknown extends TFormData ? string : DeepKeys<TFormData>,\n /**\n * If TData is unknown, we can use the TName generic to determine the type\n */\n TData = unknown extends _TData ? DeepValue<TFormData, TName> : _TData,\n> {\n name: TName\n index?: TData extends any[] ? number : never\n defaultValue?: TData\n asyncDebounceMs?: number\n asyncAlways?: boolean\n onMount?: (formApi: FieldApi<TData, TFormData>) => void\n onChange?: ValidateFn<TData, TFormData>\n onChangeAsync?: ValidateAsyncFn<TData, TFormData>\n onChangeAsyncDebounceMs?: number\n onBlur?: ValidateFn<TData, TFormData>\n onBlurAsync?: ValidateAsyncFn<TData, TFormData>\n onBlurAsyncDebounceMs?: number\n onSubmitAsync?: ValidateAsyncFn<TData, TFormData>\n defaultMeta?: Partial<FieldMeta>\n}\n\nexport type FieldApiOptions<TData, TFormData> = FieldOptions<\n TData,\n TFormData\n> & {\n form: FormApi<TFormData>\n}\n\nexport type FieldMeta = {\n isTouched: boolean\n touchedError?: ValidationError\n error?: ValidationError\n isValidating: boolean\n}\n\nlet uid = 0\n\nexport type FieldState<TData> = {\n value: TData\n meta: FieldMeta\n}\n\n/**\n * TData may not be known at the time of FieldApi construction, so we need to\n * use a conditional type to determine if TData is known or not.\n *\n * If TData is not known, we use the TFormData type to determine the type of\n * the field value based on the field name.\n */\ntype GetTData<Name, TData, TFormData> = unknown extends TData\n ? DeepValue<TFormData, Name>\n : TData\n\nexport class FieldApi<TData, TFormData> {\n uid: number\n form: FormApi<TFormData>\n name!: DeepKeys<TFormData>\n /**\n * This is a hack that allows us to use `GetTData` without calling it everywhere\n *\n * Unfortunately this hack appears to be needed alongside the `TName` hack\n * further up in this file. This properly types all of the internal methods,\n * while the `TName` hack types the options properly\n */\n _tdata!: GetTData<typeof this.name, TData, TFormData>\n store!: Store<FieldState<typeof this._tdata>>\n state!: FieldState<typeof this._tdata>\n prevState!: FieldState<typeof this._tdata>\n options: FieldOptions<typeof this._tdata, TFormData> = {} as any\n\n constructor(opts: FieldApiOptions<TData, TFormData>) {\n this.form = opts.form\n this.uid = uid++\n // Support field prefixing from FieldScope\n // let fieldPrefix = ''\n // if (this.form.fieldName) {\n // fieldPrefix = `${this.form.fieldName}.`\n // }\n\n this.name = opts.name as any\n\n this.store = new Store<FieldState<typeof this._tdata>>(\n {\n value: this.getValue(),\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n meta: this._getMeta() ?? {\n isValidating: false,\n isTouched: false,\n ...opts.defaultMeta,\n },\n },\n {\n onUpdate: () => {\n const state = this.store.state\n\n state.meta.touchedError = state.meta.isTouched\n ? state.meta.error\n : undefined\n\n this.prevState = state\n this.state = state\n },\n },\n )\n\n this.state = this.store.state\n this.prevState = this.state\n this.options = opts as never\n }\n\n mount = () => {\n const info = this.getInfo()\n info.instances[this.uid] = this\n\n const unsubscribe = this.form.store.subscribe(() => {\n this.store.batch(() => {\n const nextValue = this.getValue()\n const nextMeta = this.getMeta()\n\n if (nextValue !== this.state.value) {\n this.store.setState((prev) => ({ ...prev, value: nextValue }))\n }\n\n if (nextMeta !== this.state.meta) {\n this.store.setState((prev) => ({ ...prev, meta: nextMeta }))\n }\n })\n })\n\n this.update(this.options as never)\n this.options.onMount?.(this as never)\n\n return () => {\n unsubscribe()\n delete info.instances[this.uid]\n if (!Object.keys(info.instances).length) {\n delete this.form.fieldInfo[this.name]\n }\n }\n }\n\n update = (opts: FieldApiOptions<typeof this._tdata, TFormData>) => {\n // Default Value\n // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n if (this.state.value === undefined) {\n const formDefault =\n opts.form.options.defaultValues?.[opts.name as keyof TFormData]\n\n if (opts.defaultValue !== undefined) {\n this.setValue(opts.defaultValue as never)\n } else if (formDefault !== undefined) {\n this.setValue(formDefault as never)\n }\n }\n\n // Default Meta\n if (this._getMeta() === undefined) {\n this.setMeta(this.state.meta)\n }\n\n this.options = opts as never\n }\n\n getValue = (): typeof this._tdata => {\n return this.form.getFieldValue(this.name)\n }\n\n setValue = (\n updater: Updater<typeof this._tdata>,\n options?: { touch?: boolean; notify?: boolean },\n ) => {\n this.form.setFieldValue(this.name, updater as never, options)\n this.validate('change', this.state.value)\n }\n\n _getMeta = () => this.form.getFieldMeta(this.name)\n getMeta = () =>\n this._getMeta() ??\n ({\n isValidating: false,\n isTouched: false,\n ...this.options.defaultMeta,\n } as FieldMeta)\n\n setMeta = (updater: Updater<FieldMeta>) =>\n this.form.setFieldMeta(this.name, updater)\n\n getInfo = () => this.form.getFieldInfo(this.name)\n\n pushValue = (\n value: typeof this._tdata extends any[]\n ? (typeof this._tdata)[number]\n : never,\n ) => this.form.pushFieldValue(this.name, value as any)\n\n insertValue = (\n index: number,\n value: typeof this._tdata extends any[]\n ? (typeof this._tdata)[number]\n : never,\n ) => this.form.insertFieldValue(this.name, index, value as any)\n\n removeValue = (index: number) => this.form.removeFieldValue(this.name, index)\n\n swapValues = (aIndex: number, bIndex: number) =>\n this.form.swapFieldValues(this.name, aIndex, bIndex)\n\n getSubField = <TName extends DeepKeys<typeof this._tdata>>(name: TName) =>\n new FieldApi<DeepValue<typeof this._tdata, TName>, TFormData>({\n name: `${this.name}.${name}` as never,\n form: this.form,\n })\n\n validateSync = (value = this.state.value, cause: ValidationCause) => {\n const { onChange, onBlur } = this.options\n const validate =\n cause === 'submit' ? undefined : cause === 'change' ? onChange : onBlur\n\n if (!validate) return\n\n // Use the validationCount for all field instances to\n // track freshness of the validation\n const validationCount = (this.getInfo().validationCount || 0) + 1\n this.getInfo().validationCount = validationCount\n const error = normalizeError(validate(value as never, this as never))\n\n if (this.state.meta.error !== error) {\n this.setMeta((prev) => ({\n ...prev,\n error,\n }))\n }\n\n // If a sync error is encountered, cancel any async validation\n if (this.state.meta.error) {\n this.cancelValidateAsync()\n }\n }\n\n #leaseValidateAsync = () => {\n const count = (this.getInfo().validationAsyncCount || 0) + 1\n this.getInfo().validationAsyncCount = count\n return count\n }\n\n cancelValidateAsync = () => {\n // Lease a new validation count to ignore any pending validations\n this.#leaseValidateAsync()\n // Cancel any pending validation state\n this.setMeta((prev) => ({\n ...prev,\n isValidating: false,\n }))\n }\n\n validateAsync = async (value = this.state.value, cause: ValidationCause) => {\n const {\n onChangeAsync,\n onBlurAsync,\n onSubmitAsync,\n asyncDebounceMs,\n onBlurAsyncDebounceMs,\n onChangeAsyncDebounceMs,\n } = this.options\n\n const validate =\n cause === 'change'\n ? onChangeAsync\n : cause === 'submit'\n ? onSubmitAsync\n : onBlurAsync\n\n if (!validate) return\n\n const debounceMs =\n cause === 'submit'\n ? 0\n : (cause === 'change'\n ? onChangeAsyncDebounceMs\n : onBlurAsyncDebounceMs) ??\n asyncDebounceMs ??\n 0\n\n if (this.state.meta.isValidating !== true)\n this.setMeta((prev) => ({ ...prev, isValidating: true }))\n\n // Use the validationCount for all field instances to\n // track freshness of the validation\n const validationAsyncCount = this.#leaseValidateAsync()\n\n const checkLatest = () =>\n validationAsyncCount === this.getInfo().validationAsyncCount\n\n if (!this.getInfo().validationPromise) {\n this.getInfo().validationPromise = new Promise((resolve, reject) => {\n this.getInfo().validationResolve = resolve\n this.getInfo().validationReject = reject\n })\n }\n\n if (debounceMs > 0) {\n await new Promise((r) => setTimeout(r, debounceMs))\n }\n\n // Only kick off validation if this validation is the latest attempt\n if (checkLatest()) {\n try {\n const rawError = await validate(value as never, this as never)\n\n if (checkLatest()) {\n const error = normalizeError(rawError)\n this.setMeta((prev) => ({\n ...prev,\n isValidating: false,\n error,\n }))\n this.getInfo().validationResolve?.(error)\n }\n } catch (error) {\n if (checkLatest()) {\n this.getInfo().validationReject?.(error)\n throw error\n }\n } finally {\n if (checkLatest()) {\n this.setMeta((prev) => ({ ...prev, isValidating: false }))\n delete this.getInfo().validationPromise\n }\n }\n }\n\n // Always return the latest validation promise to the caller\n return this.getInfo().validationPromise\n }\n\n validate = (\n cause: ValidationCause,\n value?: typeof this._tdata,\n ): ValidationError | Promise<ValidationError> => {\n // If the field is pristine and validatePristine is false, do not validate\n if (!this.state.meta.isTouched) return\n\n // Attempt to sync validate first\n this.validateSync(value, cause)\n\n // If there is an error, return it, do not attempt async validation\n if (this.state.meta.error) {\n if (!this.options.asyncAlways) {\n return this.state.meta.error\n }\n }\n\n // No error? Attempt async validation\n return this.validateAsync(value, cause)\n }\n\n handleChange = (updater: Updater<typeof this._tdata>) => {\n this.setValue(updater, { touch: true })\n }\n\n handleBlur = () => {\n const prevTouched = this.state.meta.isTouched\n if (!prevTouched) {\n this.setMeta((prev) => ({ ...prev, isTouched: true }))\n this.validate('change')\n }\n this.validate('blur')\n }\n}\n\nfunction normalizeError(rawError?: ValidationError) {\n if (rawError) {\n if (typeof rawError !== 'string') {\n return 'Invalid Form Values'\n }\n\n return rawError\n }\n\n return undefined\n}\n"],"mappings":";;;;;;AAEA,SAAS,aAAa;AAyDtB,IAAI,MAAM;AA3DV;AA6EO,IAAM,YAAN,MAAM,UAA2B;AAAA,EAiBtC,YAAY,MAAyC;AAFrD,mBAAuD,CAAC;AA0CxD,iBAAQ,MAAM;AAtIhB;AAuII,YAAM,OAAO,KAAK,QAAQ;AAC1B,WAAK,UAAU,KAAK,GAAG,IAAI;AAE3B,YAAM,cAAc,KAAK,KAAK,MAAM,UAAU,MAAM;AAClD,aAAK,MAAM,MAAM,MAAM;AACrB,gBAAM,YAAY,KAAK,SAAS;AAChC,gBAAM,WAAW,KAAK,QAAQ;AAE9B,cAAI,cAAc,KAAK,MAAM,OAAO;AAClC,iBAAK,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,OAAO,UAAU,EAAE;AAAA,UAC/D;AAEA,cAAI,aAAa,KAAK,MAAM,MAAM;AAChC,iBAAK,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,MAAM,SAAS,EAAE;AAAA,UAC7D;AAAA,QACF,CAAC;AAAA,MACH,CAAC;AAED,WAAK,OAAO,KAAK,OAAgB;AACjC,uBAAK,SAAQ,YAAb,4BAAuB;AAEvB,aAAO,MAAM;AACX,oBAAY;AACZ,eAAO,KAAK,UAAU,KAAK,GAAG;AAC9B,YAAI,CAAC,OAAO,KAAK,KAAK,SAAS,EAAE,QAAQ;AACvC,iBAAO,KAAK,KAAK,UAAU,KAAK,IAAI;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,kBAAS,CAAC,SAAyD;AArKrE;AAwKI,UAAI,KAAK,MAAM,UAAU,QAAW;AAClC,cAAM,eACJ,UAAK,KAAK,QAAQ,kBAAlB,mBAAkC,KAAK;AAEzC,YAAI,KAAK,iBAAiB,QAAW;AACnC,eAAK,SAAS,KAAK,YAAqB;AAAA,QAC1C,WAAW,gBAAgB,QAAW;AACpC,eAAK,SAAS,WAAoB;AAAA,QACpC;AAAA,MACF;AAGA,UAAI,KAAK,SAAS,MAAM,QAAW;AACjC,aAAK,QAAQ,KAAK,MAAM,IAAI;AAAA,MAC9B;AAEA,WAAK,UAAU;AAAA,IACjB;AAEA,oBAAW,MAA0B;AACnC,aAAO,KAAK,KAAK,cAAc,KAAK,IAAI;AAAA,IAC1C;AAEA,oBAAW,CACT,SACA,YACG;AACH,WAAK,KAAK,cAAc,KAAK,MAAM,SAAkB,OAAO;AAC5D,WAAK,SAAS,UAAU,KAAK,MAAM,KAAK;AAAA,IAC1C;AAEA,oBAAW,MAAM,KAAK,KAAK,aAAa,KAAK,IAAI;AACjD,mBAAU,MACR,KAAK,SAAS,KACb;AAAA,MACC,cAAc;AAAA,MACd,WAAW;AAAA,MACX,GAAG,KAAK,QAAQ;AAAA,IAClB;AAEF,mBAAU,CAAC,YACT,KAAK,KAAK,aAAa,KAAK,MAAM,OAAO;AAE3C,mBAAU,MAAM,KAAK,KAAK,aAAa,KAAK,IAAI;AAEhD,qBAAY,CACV,UAGG,KAAK,KAAK,eAAe,KAAK,MAAM,KAAY;AAErD,uBAAc,CACZ,OACA,UAGG,KAAK,KAAK,iBAAiB,KAAK,MAAM,OAAO,KAAY;AAE9D,uBAAc,CAAC,UAAkB,KAAK,KAAK,iBAAiB,KAAK,MAAM,KAAK;AAE5E,sBAAa,CAAC,QAAgB,WAC5B,KAAK,KAAK,gBAAgB,KAAK,MAAM,QAAQ,MAAM;AAErD,uBAAc,CAA6C,SACzD,IAAI,UAA0D;AAAA,MAC5D,MAAM,GAAG,KAAK,IAAI,IAAI,IAAI;AAAA,MAC1B,MAAM,KAAK;AAAA,IACb,CAAC;AAEH,wBAAe,CAAC,QAAQ,KAAK,MAAM,OAAO,UAA2B;AACnE,YAAM,EAAE,UAAU,OAAO,IAAI,KAAK;AAClC,YAAM,WACJ,UAAU,WAAW,SAAY,UAAU,WAAW,WAAW;AAEnE,UAAI,CAAC;AAAU;AAIf,YAAM,mBAAmB,KAAK,QAAQ,EAAE,mBAAmB,KAAK;AAChE,WAAK,QAAQ,EAAE,kBAAkB;AACjC,YAAM,QAAQ,eAAe,SAAS,OAAgB,IAAa,CAAC;AAEpE,UAAI,KAAK,MAAM,KAAK,UAAU,OAAO;AACnC,aAAK,QAAQ,CAAC,UAAU;AAAA,UACtB,GAAG;AAAA,UACH;AAAA,QACF,EAAE;AAAA,MACJ;AAGA,UAAI,KAAK,MAAM,KAAK,OAAO;AACzB,aAAK,oBAAoB;AAAA,MAC3B;AAAA,IACF;AAEA,4CAAsB,MAAM;AAC1B,YAAM,SAAS,KAAK,QAAQ,EAAE,wBAAwB,KAAK;AAC3D,WAAK,QAAQ,EAAE,uBAAuB;AACtC,aAAO;AAAA,IACT;AAEA,+BAAsB,MAAM;AAE1B,yBAAK,qBAAL;AAEA,WAAK,QAAQ,CAAC,UAAU;AAAA,QACtB,GAAG;AAAA,QACH,cAAc;AAAA,MAChB,EAAE;AAAA,IACJ;AAEA,yBAAgB,OAAO,QAAQ,KAAK,MAAM,OAAO,UAA2B;AAvR9E;AAwRI,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF,IAAI,KAAK;AAET,YAAM,WACJ,UAAU,WACN,gBACA,UAAU,WACV,gBACA;AAEN,UAAI,CAAC;AAAU;AAEf,YAAM,aACJ,UAAU,WACN,KACC,UAAU,WACP,0BACA,0BACJ,mBACA;AAEN,UAAI,KAAK,MAAM,KAAK,iBAAiB;AACnC,aAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,cAAc,KAAK,EAAE;AAI1D,YAAM,uBAAuB,mBAAK,qBAAL;AAE7B,YAAM,cAAc,MAClB,yBAAyB,KAAK,QAAQ,EAAE;AAE1C,UAAI,CAAC,KAAK,QAAQ,EAAE,mBAAmB;AACrC,aAAK,QAAQ,EAAE,oBAAoB,IAAI,QAAQ,CAAC,SAAS,WAAW;AAClE,eAAK,QAAQ,EAAE,oBAAoB;AACnC,eAAK,QAAQ,EAAE,mBAAmB;AAAA,QACpC,CAAC;AAAA,MACH;AAEA,UAAI,aAAa,GAAG;AAClB,cAAM,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAAA,MACpD;AAGA,UAAI,YAAY,GAAG;AACjB,YAAI;AACF,gBAAM,WAAW,MAAM,SAAS,OAAgB,IAAa;AAE7D,cAAI,YAAY,GAAG;AACjB,kBAAM,QAAQ,eAAe,QAAQ;AACrC,iBAAK,QAAQ,CAAC,UAAU;AAAA,cACtB,GAAG;AAAA,cACH,cAAc;AAAA,cACd;AAAA,YACF,EAAE;AACF,6BAAK,QAAQ,GAAE,sBAAf,4BAAmC;AAAA,UACrC;AAAA,QACF,SAAS,OAAO;AACd,cAAI,YAAY,GAAG;AACjB,6BAAK,QAAQ,GAAE,qBAAf,4BAAkC;AAClC,kBAAM;AAAA,UACR;AAAA,QACF,UAAE;AACA,cAAI,YAAY,GAAG;AACjB,iBAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,cAAc,MAAM,EAAE;AACzD,mBAAO,KAAK,QAAQ,EAAE;AAAA,UACxB;AAAA,QACF;AAAA,MACF;AAGA,aAAO,KAAK,QAAQ,EAAE;AAAA,IACxB;AAEA,oBAAW,CACT,OACA,UAC+C;AAE/C,UAAI,CAAC,KAAK,MAAM,KAAK;AAAW;AAGhC,WAAK,aAAa,OAAO,KAAK;AAG9B,UAAI,KAAK,MAAM,KAAK,OAAO;AACzB,YAAI,CAAC,KAAK,QAAQ,aAAa;AAC7B,iBAAO,KAAK,MAAM,KAAK;AAAA,QACzB;AAAA,MACF;AAGA,aAAO,KAAK,cAAc,OAAO,KAAK;AAAA,IACxC;AAEA,wBAAe,CAAC,YAAyC;AACvD,WAAK,SAAS,SAAS,EAAE,OAAO,KAAK,CAAC;AAAA,IACxC;AAEA,sBAAa,MAAM;AACjB,YAAM,cAAc,KAAK,MAAM,KAAK;AACpC,UAAI,CAAC,aAAa;AAChB,aAAK,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,WAAW,KAAK,EAAE;AACrD,aAAK,SAAS,QAAQ;AAAA,MACxB;AACA,WAAK,SAAS,MAAM;AAAA,IACtB;AAxSE,SAAK,OAAO,KAAK;AACjB,SAAK,MAAM;AAOX,SAAK,OAAO,KAAK;AAEjB,SAAK,QAAQ,IAAI;AAAA,MACf;AAAA,QACE,OAAO,KAAK,SAAS;AAAA;AAAA,QAErB,MAAM,KAAK,SAAS,KAAK;AAAA,UACvB,cAAc;AAAA,UACd,WAAW;AAAA,UACX,GAAG,KAAK;AAAA,QACV;AAAA,MACF;AAAA,MACA;AAAA,QACE,UAAU,MAAM;AACd,gBAAM,QAAQ,KAAK,MAAM;AAEzB,gBAAM,KAAK,eAAe,MAAM,KAAK,YACjC,MAAM,KAAK,QACX;AAEJ,eAAK,YAAY;AACjB,eAAK,QAAQ;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAEA,SAAK,QAAQ,KAAK,MAAM;AACxB,SAAK,YAAY,KAAK;AACtB,SAAK,UAAU;AAAA,EACjB;AAoQF;AAjIE;AA1LK,IAAM,WAAN;AA6TP,SAAS,eAAe,UAA4B;AAClD,MAAI,UAAU;AACZ,QAAI,OAAO,aAAa,UAAU;AAChC,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;","names":[]}