cross-state 1.1.2 → 1.2.0

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.
@@ -2,7 +2,7 @@ const require_path = require('../path-B-Rq5q6m.cjs');
2
2
  const require_store = require('../store-C1NYHLgR.cjs');
3
3
  const require_propAccess = require('../propAccess-C2AIn9RC.cjs');
4
4
  const require_extendedJson = require('../extendedJson-ursQ8DbQ.cjs');
5
- const require_storeMethods = require('../storeMethods-CPGR8OPN.cjs');
5
+ const require_storeMethods = require('../storeMethods-XSKXj4TX.cjs');
6
6
  let react = require("react");
7
7
  react = require_path.__toESM(react);
8
8
  let react_jsx_runtime = require("react/jsx-runtime");
@@ -181,6 +181,7 @@ function useFormAutosave(form) {
181
181
  function FormContainer({ form,...formProps }) {
182
182
  const formInstance = form.useForm();
183
183
  const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);
184
+ const hasErrors = form.useFormState((state) => hasTriggeredValidations && state.errors.size > 0);
184
185
  const formRef = (0, react.useRef)(null);
185
186
  const updateValidity = require_storeMethods.useLatestFunction((errors, buttonElement) => {
186
187
  const formElement = formRef.current;
@@ -193,6 +194,7 @@ function FormContainer({ form,...formProps }) {
193
194
  }
194
195
  });
195
196
  (0, react.useEffect)(() => {
197
+ if (!formInstance.options.reportValidity) return;
196
198
  return formInstance.formState.map(() => formInstance.getErrors()).subscribe((errors) => updateValidity(errors));
197
199
  }, [formInstance, updateValidity]);
198
200
  return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("form", {
@@ -200,15 +202,19 @@ function FormContainer({ form,...formProps }) {
200
202
  noValidate: true,
201
203
  ...formProps,
202
204
  className: [formProps.className, hasTriggeredValidations ? formInstance.options.validatedClass ?? "validated" : void 0].filter(Boolean).join(" "),
205
+ "data-validated": hasTriggeredValidations || void 0,
206
+ "data-valid": hasErrors ? "false" : hasTriggeredValidations ? "true" : void 0,
203
207
  onSubmit: async (event) => {
204
208
  if (formInstance.saveInProgress()) return;
205
209
  try {
206
210
  formInstance.formState.set("saveInProgress", true);
207
211
  event.preventDefault();
208
- const formElement = event.currentTarget;
209
- const buttonElement = event.nativeEvent instanceof SubmitEvent && event.nativeEvent.submitter instanceof HTMLButtonElement ? event.nativeEvent.submitter : void 0;
210
- updateValidity(formInstance.getErrors(), buttonElement);
211
- formElement.reportValidity();
212
+ if (formInstance.options.reportValidity) {
213
+ const formElement = event.currentTarget;
214
+ const buttonElement = event.nativeEvent instanceof SubmitEvent && event.nativeEvent.submitter instanceof HTMLButtonElement ? event.nativeEvent.submitter : void 0;
215
+ updateValidity(formInstance.getErrors(), buttonElement);
216
+ formElement.reportValidity();
217
+ }
212
218
  if (formInstance.validate()) await formProps.onSubmit?.(event, {
213
219
  ...formInstance,
214
220
  ...getDerivedState(formInstance)
@@ -333,7 +339,7 @@ var Form = class Form {
333
339
  this.useFormState((form$1) => [form$1.getField(path).value, form$1.original], useStoreOptions);
334
340
  return form.getField(path);
335
341
  }
336
- Form({ original, defaultValue, validations, localizeError, autoSave, transform, validatedClass,...formProps }) {
342
+ Form({ defaultValue, validations, localizeError, autoSave, transform, validatedClass, original, onSubmit, reportValidity,...formProps }) {
337
343
  const options = {
338
344
  defaultValue: {
339
345
  ...this.options.defaultValue,
@@ -346,7 +352,10 @@ var Form = class Form {
346
352
  localizeError: localizeError ?? this.options.localizeError,
347
353
  autoSave: autoSave ?? this.options.autoSave,
348
354
  transform: transform ?? this.options.transform,
349
- validatedClass: validatedClass ?? this.options.validatedClass
355
+ validatedClass: validatedClass ?? this.options.validatedClass,
356
+ original: original ?? this.options.original,
357
+ onSubmit: onSubmit ?? this.options.onSubmit,
358
+ reportValidity: reportValidity ?? this.options.reportValidity ?? true
350
359
  };
351
360
  const formState = (0, react.useMemo)(() => {
352
361
  return require_store.createStore({
@@ -373,12 +382,12 @@ var Form = class Form {
373
382
  const context = {
374
383
  formState,
375
384
  options,
376
- original,
385
+ original: options.original,
377
386
  getField() {
378
387
  throw new Error("Not implemented");
379
388
  },
380
389
  getDraft() {
381
- return formState.get().draft ?? original ?? options.defaultValue;
390
+ return formState.get().draft ?? options.original ?? options.defaultValue;
382
391
  },
383
392
  hasTriggeredValidations() {
384
393
  return formState.get().hasTriggeredValidations;
@@ -390,10 +399,10 @@ var Form = class Form {
390
399
  return formState.get().saveInProgress;
391
400
  },
392
401
  hasChanges() {
393
- return lazy("hasChanges", () => !require_propAccess.deepEqual(this.getDraft(), original ?? options.defaultValue, { undefinedEqualsAbsent: true }));
402
+ return lazy("hasChanges", () => !require_propAccess.deepEqual(this.getDraft(), options.original ?? options.defaultValue, { undefinedEqualsAbsent: true }));
394
403
  },
395
404
  getErrors() {
396
- return lazy("getErrors", () => getErrors(this.getDraft(), original, options.validations));
405
+ return lazy("getErrors", () => getErrors(this.getDraft(), options.original, options.validations));
397
406
  },
398
407
  isValid() {
399
408
  return lazy("isValid", () => this.getErrors().size === 0);
@@ -411,7 +420,7 @@ var Form = class Form {
411
420
  (0, react.useEffect)(() => {
412
421
  const transform$1 = options.transform;
413
422
  if (!transform$1) return;
414
- const store = formState.map((state) => state.draft ?? original ?? options.defaultValue, (draft) => (state) => ({
423
+ const store = formState.map((state) => state.draft ?? options.original ?? options.defaultValue, (draft) => (state) => ({
415
424
  ...state,
416
425
  draft
417
426
  }));
@@ -420,8 +429,8 @@ var Form = class Form {
420
429
  if (result !== void 0 && !require_propAccess.deepEqual(result, value)) store.set(result);
421
430
  });
422
431
  }, [
423
- original,
424
432
  options.defaultValue,
433
+ options.original,
425
434
  options.transform,
426
435
  formState
427
436
  ]);
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["matches: Record<KeyType, any>","castArrayPath","isObject","value","form","useLatestFunction","name","Fragment","calcDuration","useLatestRef","queue","debounce","deepEqual","useLatestFunction","errors","get","set","deepEqual","join","isObject","options: FormOptions<TDraft, TOriginal>","useStore","form","createStore","lastDraft: TDraft | undefined","context: FormContext<TDraft, TOriginal>","transform","Form","fromExtendedJsonString","toExtendedJsonString","urlStore: Store<string>","createStore","Store","urlOptions: Required<UrlOptions<T>>","path: any","update: Update<any>","get","set","useLatestFunction","useMemoEquals","update","value","delayedUpdate: (value: T) => void","debounce","throttle"],"sources":["../../src/react/form/customInput.tsx","../../src/lib/wildcardMatch.ts","../../src/react/form/formField.tsx","../../src/react/form/formForEach.tsx","../../src/react/form/useFormAutosave.ts","../../src/react/form/form.tsx","../../src/lib/castArray.ts","../../src/react/url/urlHelpers.ts","../../src/react/url/urlOptions.ts","../../src/react/url/urlParamStore.ts","../../src/react/useDecoupledState.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nexport interface CustomInputProps extends React.HTMLAttributes<HTMLDivElement> {\n name: string;\n children?: ReactNode;\n}\n\nexport function CustomInput({ name, children, ...props }: CustomInputProps): React.JSX.Element {\n return (\n <div\n {...props}\n style={{\n position: 'relative',\n ...props.style,\n }}\n >\n {children}\n\n <input\n name={name}\n style={{\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n pointerEvents: 'none',\n }}\n />\n </div>\n );\n}\n","import { isObject } from '@lib/helpers';\nimport { type KeyType } from './path';\nimport { castArrayPath } from './propAccess';\n\nexport function wildcardMatch(s: KeyType[] | string, w: KeyType[] | string): boolean {\n if (typeof s === 'string') {\n s = castArrayPath(s);\n }\n\n if (typeof w === 'string') {\n w = castArrayPath(w);\n }\n\n return s.length === w.length && s.every((s, i) => w[i] === '*' || s === w[i]);\n}\n\nexport function getWildCardMatches(\n object: any,\n path: [KeyType, ...KeyType[]] | string,\n): Record<KeyType, any> {\n const matches: Record<KeyType, any> = {};\n const [first, second, ...rest] = castArrayPath(path);\n\n if (first === undefined) {\n throw new Error('Path is empty');\n }\n\n if (!Array.isArray(object) && !isObject(object)) {\n object = {};\n }\n\n for (const [key, value] of first !== '*' ? [[first, object[first]]] : Object.entries(object)) {\n if (first !== '*' && first !== key) {\n continue;\n }\n\n if (second === undefined) {\n matches[key] = value;\n continue;\n }\n\n for (const [subKey, subValue] of Object.entries(getWildCardMatches(value, [second, ...rest]))) {\n matches[`${key}.${subKey}`] = subValue;\n }\n }\n\n return matches;\n}\n","import { type PathAsString, type Value } from '@lib/path';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport {\n createElement,\n useEffect,\n useState,\n type Component,\n type ComponentPropsWithoutRef,\n type ReactNode,\n} from 'react';\nimport {\n getDerivedState,\n type Field,\n type Form,\n type FormContext,\n type FormInstance,\n} from './form';\n\nexport interface FormFieldComponentProps<TValue, TPath> {\n name: TPath;\n value: TValue;\n onChange: (event: { target: { value: TValue } } | TValue | undefined, ...args: any[]) => void;\n onBlur: (...args: any[]) => void;\n}\n\nexport type FormFieldInfos<TDraft, TOriginal, TPath extends string> = Field<\n TDraft,\n TOriginal,\n TPath\n> & {\n hasTriggeredValidations: boolean;\n};\n\ntype NativeInputType = 'input' | 'select' | 'textarea';\n\ntype PartialComponentType<P> =\n | (new (props: P, context?: any) => Component<P, any>)\n | ((props: P, context?: any) => ReactNode);\n\nexport type FormFieldComponent = NativeInputType | PartialComponentType<any>;\n\ntype FieldValue<T extends FormFieldComponent> = ComponentPropsWithoutRef<T>['value'];\n\ntype FieldChangeValue<T extends FormFieldComponent> =\n ComponentPropsWithoutRef<T> extends {\n onChange?: (update: infer U) => void;\n }\n ? U extends { target: { value: infer V } }\n ? V\n : U\n : never;\n\ntype MakeOptional<T, Keys extends string> = Omit<T, Keys> & Partial<Pick<T, Keys & keyof T>>;\n\nexport type FormFieldProps<TPath, TDraft> = {\n name: TPath & PathAsString<TDraft>;\n commitOnBlur?: boolean;\n commitDebounce?: number;\n};\n\nexport type FormFieldPropsWithRender<TDraft, TOriginal, TPath extends string> = FormFieldProps<\n TPath,\n TDraft\n> &\n NoInfer<{\n component?: undefined;\n render: (\n props: FormFieldComponentProps<Value<TDraft, TPath>, TPath>,\n info: FormFieldInfos<TDraft, TOriginal, TPath>,\n form: FormContext<TDraft, TOriginal>,\n ) => ReactNode;\n inputFilter?: undefined;\n defaultValue?: undefined;\n serialize?: undefined;\n deserialize?: undefined;\n onChange?: undefined;\n onBlur?: undefined;\n }>;\n\ntype Serialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: Value<TDraft, TPath>,\n formState: FormInstance<TDraft, TOriginal>,\n) => FieldValue<TComponent>;\n\ntype Deserialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: FieldChangeValue<TComponent>,\n formState: FormInstance<TDraft, TOriginal>,\n) => Value<TDraft, TPath>;\n\nexport type FormFieldPropsWithComponent<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n> = FormFieldProps<TPath, TDraft> & {\n component?: TComponent;\n render?: undefined;\n} & NoInfer<\n {\n inputFilter?: (value: FieldChangeValue<TComponent>) => boolean;\n } & MakeOptional<\n Omit<ComponentPropsWithoutRef<TComponent>, 'id' | 'name' | 'value' | 'defaultValue'>,\n 'onChange' | 'onBlur'\n > &\n (Value<TDraft, TPath> extends Exclude<FieldValue<TComponent>, undefined>\n ? {\n defaultValue?: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : Value<TDraft, TPath> extends FieldValue<TComponent>\n ?\n | {\n defaultValue: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n | {\n defaultValue?: FieldValue<TComponent>;\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }) &\n (FieldChangeValue<TComponent> extends Value<TDraft, TPath>\n ? {\n deserialize?: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n deserialize: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n })\n >;\n\nexport function FormField<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n>(\n this: Form<TDraft, any>,\n {\n // id,\n name = '' as any,\n component,\n commitOnBlur,\n commitDebounce,\n render,\n inputFilter,\n defaultValue,\n serialize,\n deserialize = (x) => x as Value<TDraft, TPath>,\n onChange,\n onBlur,\n ...restProps\n }:\n | FormFieldPropsWithRender<TDraft, TOriginal, TPath>\n | FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n): React.JSX.Element | null {\n type T = FieldChangeValue<TComponent>;\n\n const form = this.useForm();\n const getFormState = () => ({ ...form, ...getDerivedState(form) });\n const [localValue, setLocalValue] = useState<T>();\n\n const value = this.useFormState((form) => {\n const value = form.getField(name as any).value;\n if (serialize) {\n return serialize(value as any, getFormState());\n }\n if (value !== undefined) {\n return value;\n }\n return defaultValue;\n });\n\n const setValue = useLatestFunction((x: FieldChangeValue<TComponent>) =>\n form.getField(name as any).setValue(deserialize(x, getFormState())),\n );\n\n const hasTriggeredValidations = this.useFormState((form) => form.hasTriggeredValidations);\n\n useEffect(() => {\n if (localValue === undefined || !commitDebounce) {\n return;\n }\n\n const timeout = setTimeout(() => {\n setValue(localValue);\n setLocalValue(undefined);\n }, commitDebounce);\n\n return () => clearTimeout(timeout);\n }, [localValue, commitDebounce, setValue]);\n\n const props = {\n name,\n value: localValue ?? value,\n onChange: (event: { target: { value: T } } | T, ...moreArgs: any[]) => {\n const value =\n typeof event === 'object' && event !== null && 'target' in event\n ? event.target.value\n : event;\n\n if (inputFilter && !inputFilter(value)) {\n return;\n }\n\n if (commitOnBlur || commitDebounce) {\n setLocalValue(value);\n } else {\n setValue(value);\n }\n\n onChange?.(event, ...moreArgs);\n },\n onBlur(...args: any[]) {\n if (localValue !== undefined) {\n setValue(localValue);\n setLocalValue(undefined);\n }\n\n onBlur?.(...args);\n },\n } as FormFieldComponentProps<Value<TDraft, TPath>, TPath>;\n\n if (render) {\n return (\n <>\n {render(props, { ...form.getField(name as any), hasTriggeredValidations } as any, form) ??\n null}\n </>\n );\n }\n\n if (component) {\n return createElement(component, { ...restProps, ...props });\n }\n\n return null;\n}\n","import { type GetKeys, type Join, type PathAsString, type Value } from '@lib/path';\nimport { Fragment, useCallback, type ReactNode } from 'react';\nimport { type FieldHelperMethods, type Form } from './form';\n\nexport type ElementName<TDraft, TPath extends string> = keyof {\n [Path in TPath as Join<Path, GetKeys<NonNullable<Value<TDraft, Path>>> & (string | number)>]: 1;\n};\n\nexport interface FormForEachProps<TDraft, TPath extends string> {\n name: TPath & PathAsString<TDraft>;\n renderElement?: (props: {\n name: ElementName<TDraft, TPath>;\n key: `${GetKeys<NonNullable<Value<TDraft, TPath>>> & (string | number)}`;\n index: number;\n remove: () => void;\n }) => ReactNode;\n children?: (\n props: {\n setValue: (\n value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>),\n ) => void;\n } & FieldHelperMethods<TDraft, TPath>,\n ) => ReactNode;\n}\n\nexport function FormForEach<TDraft, TPath extends string>(\n this: Form<TDraft, any>,\n { name, renderElement, children }: FormForEachProps<TDraft, TPath>,\n): React.JSX.Element {\n const form = this.useForm();\n\n const names = this.useFormState(() => {\n const field = form.getField(name as any) as any;\n return field.names as any[];\n });\n\n const add = useCallback(\n (...args: any[]) => {\n const field = form.getField(name as any) as any;\n field.add(...args);\n },\n [form, name],\n );\n\n const remove = useCallback(\n (key: any) => {\n const field = form.getField(name as any) as any;\n field.remove(key);\n },\n [form, name],\n );\n\n const setValue = useCallback(\n (value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>)) => {\n const field = form.getField(name as any) as any;\n field.setValue(value);\n },\n [form, name],\n );\n\n return (\n <>\n {renderElement &&\n names.map((name, index) => {\n const key = name.split('.').pop();\n\n return (\n <Fragment key={key}>\n {renderElement({\n name,\n key,\n index,\n remove: () => remove(key),\n })}\n </Fragment>\n );\n })}\n\n {children?.({\n names,\n add,\n remove,\n setValue,\n } as any)}\n </>\n );\n}\n","import type { Duration } from '@core';\nimport { calcDuration } from '@lib/calcDuration';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport type { MaybePromise } from '@lib/maybePromise';\nimport { queue } from '@lib/queue';\nimport useLatestRef from '@react/lib/useLatestRef';\nimport { useEffect, useMemo, useRef } from 'react';\nimport type { FormContext } from './form';\n\nexport interface FormAutosaveOptions<TDraft, TOriginal> {\n save: (draft: TDraft, form: FormContext<TDraft, TOriginal>) => MaybePromise<void>;\n debounce?: Duration;\n resetAfterSave?: boolean;\n}\n\nexport function useFormAutosave<TDraft, TOriginal extends TDraft>(\n form: FormContext<TDraft, TOriginal>,\n): void {\n const debounceTime = calcDuration(form.options.autoSave?.debounce ?? 2_000);\n const latestRef = useLatestRef(form);\n const lastValue = useRef<TDraft | undefined>(undefined);\n const q = useMemo(() => queue(), []);\n\n const run = useMemo(\n () =>\n debounce(async () => {\n const save = latestRef.current.options.autoSave?.save;\n const draft = latestRef.current.getDraft();\n\n lastValue.current = draft;\n\n q.clear();\n\n q(async () => {\n try {\n latestRef.current.formState.set('saveInProgress', true);\n await save?.(draft, latestRef.current);\n\n if (q.size === 0 && latestRef.current.options.autoSave?.resetAfterSave) {\n latestRef.current.reset();\n }\n } finally {\n latestRef.current.formState.set('saveInProgress', false);\n\n if (q.size === 0) {\n latestRef.current.formState.set('saveScheduled', false);\n }\n }\n });\n }, debounceTime),\n [latestRef, debounceTime, q],\n );\n\n useEffect(() => {\n if (!latestRef.current.options.autoSave?.save) {\n return;\n }\n\n return latestRef.current.formState\n .map((state) => state.draft)\n .subscribe(\n () => {\n if (deepEqual(latestRef.current.getDraft(), lastValue.current)) {\n return;\n }\n\n run();\n latestRef.current.formState.set('saveScheduled', true);\n },\n { runNow: false },\n );\n }, [latestRef, run]);\n}\n","import { createStore, type Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { deepEqual } from '@lib/equals';\nimport { isObject } from '@lib/helpers';\nimport {\n type PathAsString,\n type Value,\n type WildcardPathAsString,\n type WildcardValue,\n} from '@lib/path';\nimport { get, join, set } from '@lib/propAccess';\nimport type { Object_ } from '@lib/typeHelpers';\nimport { getWildCardMatches } from '@lib/wildcardMatch';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n type Context,\n type FormEvent,\n type FunctionComponent,\n type HTMLProps,\n type ReactNode,\n} from 'react';\nimport { useStore, type UseStoreOptions } from '../useStore';\nimport {\n FormField,\n type FormFieldComponent,\n type FormFieldPropsWithComponent,\n type FormFieldPropsWithRender,\n} from './formField';\nimport { FormForEach, type ElementName, type FormForEachProps } from './formForEach';\nimport { useFormAutosave, type FormAutosaveOptions } from './useFormAutosave';\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Form types\n/// /////////////////////////////////////////////////////////////////////////////\n\nexport interface Transform<TDraft> {\n (value: TDraft, store: Store<TDraft>): void | TDraft;\n}\n\nexport interface FormOptions<TDraft, TOriginal> {\n defaultValue: TDraft;\n validations?: Validations<TDraft, TOriginal>;\n localizeError?: (error: string, field: string) => string | undefined;\n autoSave?: FormAutosaveOptions<TDraft, TOriginal>;\n transform?: Transform<TDraft>;\n validatedClass?: string;\n}\n\nexport type Validations<TDraft, TOriginal> = {\n [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>>;\n} & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;\n\nexport type Validation<TDraft, TOriginal, TPath> = (\n value: WildcardValue<TDraft, TPath>,\n context: {\n draft: TDraft;\n original: TOriginal;\n field: PathAsString<TDraft> | '';\n },\n) => boolean;\n\nexport type Field<TDraft, TOriginal, TPath extends string> = {\n originalValue: Value<TOriginal, TPath> | undefined;\n value: Value<TDraft, TPath>;\n setValue: (value: Update<Value<TDraft, TPath>>) => void;\n removeValue: () => void;\n hasChange: boolean;\n errors: string[];\n} & (Value<TDraft, TPath> extends Object_ ? FieldHelperMethods<TDraft, TPath> : {});\n\nexport type FieldHelperMethods<TDraft, TPath extends string> = {\n names: ElementName<TDraft, TPath>[];\n add: NonNullable<Value<TDraft, TPath>> extends readonly (infer T)[]\n ? (element: T) => void\n : NonNullable<Value<TDraft, TPath>> extends Record<infer K, infer V>\n ? (key: K, value: V) => void\n : never;\n remove: Value<TDraft, TPath> extends readonly any[]\n ? (index: number) => void\n : (key: string) => void;\n};\n\nexport interface FormState<TDraft> {\n draft: TDraft | undefined;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n}\n\nexport interface FormDerivedState<TDraft> {\n draft: TDraft;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n hasChanges: boolean;\n errors: Map<string, string[]>;\n isValid: boolean;\n}\n\nexport interface FormContext<TDraft, TOriginal> {\n formState: Store<FormState<TDraft>>;\n options: FormOptions<TDraft, TOriginal>;\n original: TOriginal | undefined;\n getField: <TPath extends string>(path: TPath) => Field<TDraft, TOriginal, TPath>;\n getDraft: () => TDraft;\n hasTriggeredValidations: () => boolean;\n saveScheduled: () => boolean;\n saveInProgress: () => boolean;\n hasChanges: () => boolean;\n getErrors: () => Map<string, string[]>;\n isValid: () => boolean;\n validate: () => boolean;\n reset: () => void;\n}\n\nexport interface FormInstance<TDraft, TOriginal>\n extends FormDerivedState<TDraft>,\n Pick<\n FormContext<TDraft, TOriginal>,\n 'options' | 'original' | 'getField' | 'validate' | 'reset'\n > {}\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Implementation\n/// /////////////////////////////////////////////////////////////////////////////\n\nfunction FormContainer({\n form,\n ...formProps\n}: {\n form: Form<any, any>;\n onSubmit?: (\n event: FormEvent<HTMLFormElement>,\n form: FormInstance<any, any>,\n ) => void | Promise<void>;\n} & Omit<HTMLProps<HTMLFormElement>, 'form' | 'onSubmit'>) {\n const formInstance = form.useForm();\n const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);\n\n const formRef = useRef<HTMLFormElement>(null);\n\n const updateValidity = useLatestFunction(\n (errors: Map<string, string[]>, buttonElement?: HTMLButtonElement) => {\n const formElement = formRef.current;\n if (!formElement) {\n return;\n }\n\n const localizedErrors = new Map(\n [...errors.entries()].map(\n ([field, errors]) =>\n [\n field,\n errors.map((error) => formInstance.options.localizeError?.(error, field) ?? error),\n ] as const,\n ),\n );\n\n for (const element of Array.from(formElement.elements)) {\n if ('name' in element && 'setCustomValidity' in element) {\n (element as HTMLObjectElement).setCustomValidity(\n localizedErrors.get((element as HTMLObjectElement).name)?.join('\\n') ?? '',\n );\n }\n }\n\n if (buttonElement && 'setCustomValidity' in buttonElement) {\n const errorString = [...errors.values()].flat().join('\\n');\n\n buttonElement.setCustomValidity(errorString);\n }\n },\n );\n\n useEffect(() => {\n return formInstance.formState\n .map(() => formInstance.getErrors())\n .subscribe((errors) => updateValidity(errors));\n }, [formInstance, updateValidity]);\n\n return (\n <form\n ref={formRef}\n noValidate\n {...formProps}\n className={[\n formProps.className,\n hasTriggeredValidations ? (formInstance.options.validatedClass ?? 'validated') : undefined,\n ]\n .filter(Boolean)\n .join(' ')}\n onSubmit={async (event) => {\n if (formInstance.saveInProgress()) {\n return;\n }\n\n try {\n formInstance.formState.set('saveInProgress', true);\n event.preventDefault();\n\n const formElement = event.currentTarget;\n const buttonElement =\n event.nativeEvent instanceof SubmitEvent &&\n event.nativeEvent.submitter instanceof HTMLButtonElement\n ? event.nativeEvent.submitter\n : undefined;\n\n updateValidity(formInstance.getErrors(), buttonElement);\n\n formElement.reportValidity();\n\n const isValid = formInstance.validate();\n if (isValid) {\n await formProps.onSubmit?.(event, {\n ...formInstance,\n ...getDerivedState(formInstance),\n });\n }\n } finally {\n formInstance.formState.set('saveInProgress', false);\n }\n }}\n />\n );\n}\n\nfunction getField<TDraft, TOriginal extends TDraft, TPath extends string>(\n form: FormContext<TDraft, TOriginal>,\n path: TPath,\n): Field<TDraft, TOriginal, TPath> {\n const field = {\n get originalValue() {\n return form.original !== undefined ? get(form.original as any, path as any) : undefined;\n },\n\n get value() {\n const draft = form.getDraft();\n return get(draft ?? form.original ?? form.options.defaultValue, path as any);\n },\n\n setValue(update: Update<Value<TDraft, TPath>>) {\n form.formState.set('draft', (draft = form.original ?? form.options.defaultValue) => {\n if (update instanceof Function) {\n update = update(get(draft, path as any) as Value<TDraft, TPath>);\n }\n\n return set(draft, path as any, update as any);\n });\n },\n\n get hasChange() {\n return !deepEqual(this.originalValue, this.value, { undefinedEqualsAbsent: true });\n },\n\n get errors() {\n const errors = form.getErrors();\n return errors.get(path) ?? [];\n },\n\n get names(): any {\n const { value } = this;\n\n if (Array.isArray(value)) {\n return value.map((_, index) => join(path, String(index)));\n }\n\n if (isObject(value)) {\n return Object.keys(value).map((key) => join(path, key));\n }\n\n return [];\n },\n\n add(...args: any[]) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return [...(value ?? []), args[0]];\n }\n\n if (isObject(value)) {\n return {\n ...value,\n [args[0]]: args[1],\n };\n }\n\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n });\n },\n\n remove(key: string | number) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return value.filter((_, index) => index !== Number(key));\n }\n\n if (isObject(value)) {\n const { [key]: _, ...rest } = value as Record<string | number, unknown>;\n return rest;\n }\n\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n });\n },\n };\n\n return field as any;\n}\n\nfunction getErrors<TDraft, TOriginal>(\n draft: TDraft,\n original: TOriginal | undefined,\n validations: FormOptions<TDraft, TOriginal>['validations'],\n) {\n const errors = new Map<string, string[]>();\n\n for (const [path, block] of Object.entries(validations ?? {})) {\n for (const [validationName, validate] of Object.entries(\n block as Record<string, Validation<any, any, any>>,\n )) {\n let matched = false;\n\n for (const [field, value] of Object.entries(getWildCardMatches(draft, path))) {\n matched = true;\n if (!validate(value, { draft, original, field })) {\n const fieldErrors = errors.get(field) ?? [];\n fieldErrors.push(validationName);\n errors.set(field, fieldErrors);\n }\n }\n\n if (!matched && !path.includes('*')) {\n if (!validate(undefined, { draft, original, field: path })) {\n const fieldErrors = errors.get(path) ?? [];\n fieldErrors.push(validationName);\n errors.set(path, fieldErrors);\n }\n }\n }\n }\n\n return errors;\n}\n\nexport function getDerivedState<TDraft>(\n instance: FormContext<TDraft, any>,\n): FormDerivedState<TDraft> {\n return {\n draft: instance.getDraft(),\n hasTriggeredValidations: instance.hasTriggeredValidations(),\n saveScheduled: instance.saveScheduled(),\n saveInProgress: instance.saveInProgress(),\n hasChanges: instance.hasChanges(),\n errors: instance.getErrors(),\n isValid: instance.isValid(),\n };\n}\n\nexport class Form<TDraft, TOriginal extends TDraft = TDraft> {\n context: Context<FormContext<TDraft, TOriginal> | null> = createContext<FormContext<\n TDraft,\n TOriginal\n > | null>(null);\n\n constructor(public readonly options: FormOptions<TDraft, TOriginal>) {\n autobind(Form);\n }\n\n useForm(): FormContext<TDraft, TOriginal> {\n const context = useContext(this.context);\n\n if (!context) {\n throw new Error('Form context not found');\n }\n\n return context;\n }\n\n useFormState<S>(\n selector: (state: FormInstance<TDraft, TOriginal>) => S,\n useStoreOptions?: UseStoreOptions<S>,\n ): S {\n const form = this.useForm();\n\n return useStore(\n form.formState,\n () =>\n selector({\n ...form,\n ...getDerivedState(form),\n }),\n\n useStoreOptions,\n );\n }\n\n useField<TPath extends string>(\n path: TPath,\n useStoreOptions?: UseStoreOptions<any>,\n ): Field<TDraft, TOriginal, TPath> {\n const form = this.useForm();\n this.useFormState((form) => [form.getField(path).value, form.original], useStoreOptions);\n return form.getField(path);\n }\n\n // ///////////////////////////////////////////////////////////////////////////\n // React Components\n // ///////////////////////////////////////////////////////////////////////////\n\n Form({\n original,\n defaultValue,\n validations,\n localizeError,\n autoSave,\n transform,\n validatedClass,\n ...formProps\n }: {\n original?: TOriginal;\n onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;\n } & Partial<FormOptions<TDraft, TOriginal>> &\n Omit<HTMLProps<HTMLFormElement>, 'defaultValue' | 'autoSave' | 'onSubmit'>): React.JSX.Element {\n const options: FormOptions<TDraft, TOriginal> = {\n defaultValue: { ...this.options.defaultValue, ...defaultValue },\n validations: { ...this.options.validations, ...validations } as Validations<\n TDraft,\n TOriginal\n >,\n localizeError: localizeError ?? this.options.localizeError,\n autoSave: autoSave ?? this.options.autoSave,\n transform: transform ?? this.options.transform,\n validatedClass: validatedClass ?? this.options.validatedClass,\n };\n\n const formState = useMemo(() => {\n return createStore<FormState<TDraft>>({\n draft: undefined,\n hasTriggeredValidations: false,\n saveScheduled: false,\n saveInProgress: false,\n });\n }, []);\n\n let lastDraft: TDraft | undefined;\n const cache = new Map<string, unknown>();\n function lazy<T>(key: string, fn: () => T): T {\n if (lastDraft !== formState.get().draft) {\n cache.clear();\n lastDraft = formState.get().draft;\n }\n\n let value = cache.get(key);\n if (!cache.has(key)) {\n value = fn();\n cache.set(key, value);\n }\n\n return value as T;\n }\n\n const context: FormContext<TDraft, TOriginal> = {\n formState,\n options,\n original,\n\n getField() {\n throw new Error('Not implemented');\n },\n\n getDraft() {\n return formState.get().draft ?? original ?? options.defaultValue;\n },\n\n hasTriggeredValidations() {\n return formState.get().hasTriggeredValidations;\n },\n\n saveScheduled() {\n return formState.get().saveScheduled;\n },\n\n saveInProgress() {\n return formState.get().saveInProgress;\n },\n\n hasChanges() {\n return lazy(\n 'hasChanges',\n () =>\n !deepEqual(this.getDraft(), original ?? options.defaultValue, {\n undefinedEqualsAbsent: true,\n }),\n );\n },\n\n getErrors() {\n return lazy('getErrors', () => getErrors(this.getDraft(), original, options.validations));\n },\n\n isValid() {\n return lazy('isValid', () => this.getErrors().size === 0);\n },\n\n validate() {\n formState.set('hasTriggeredValidations', true);\n return this.isValid();\n },\n\n reset() {\n formState.set('draft', undefined);\n formState.set('hasTriggeredValidations', false);\n },\n };\n\n context.getField = (path) => lazy(path, () => getField(context, path));\n\n useEffect(() => {\n const transform = options.transform;\n if (!transform) {\n return;\n }\n\n const store = formState.map(\n (state) => state.draft ?? original ?? options.defaultValue,\n (draft) => (state) => ({ ...state, draft }),\n );\n\n return store.subscribe((value) => {\n const result = transform(value, store);\n\n if (result !== undefined && !deepEqual(result, value)) {\n store.set(result);\n }\n });\n }, [original, options.defaultValue, options.transform, formState]);\n\n useFormAutosave(context);\n\n return (\n <this.context.Provider value={context}>\n <FormContainer {...formProps} form={this} />\n </this.context.Provider>\n );\n }\n\n FormState<S>({\n selector,\n children,\n }: {\n selector: (form: FormInstance<TDraft, TOriginal>) => S;\n children: (selectedState: S) => ReactNode;\n }): React.JSX.Element {\n const selectedState = this.useFormState(selector);\n return <>{children(selectedState)}</>;\n }\n\n Field<const TPath extends string>(\n props: FormFieldPropsWithRender<TDraft, TOriginal, TPath>,\n ): React.JSX.Element;\n\n Field<const TPath extends string, const TComponent extends FormFieldComponent = 'input'>(\n props: FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n ): React.JSX.Element;\n\n Field(props: any): React.JSX.Element {\n return Reflect.apply(FormField, this, [{ component: 'input', ...props }]);\n }\n\n ForEach<const TPath extends string>(props: FormForEachProps<TDraft, TPath>): React.JSX.Element {\n return Reflect.apply(FormForEach, this, [props]);\n }\n\n withForm<TProps extends Record<string, unknown>>(\n Component: React.ComponentType<TProps>,\n formProps?: Parameters<this['Form']>[0],\n ): FunctionComponent<TProps> {\n const { Form } = this;\n return function FormWrapper(props: TProps) {\n return (\n <Form {...formProps}>\n <Component {...props} />\n </Form>\n );\n };\n }\n}\n\nexport function createForm<TDraft, TOriginal extends TDraft = TDraft>(\n options: FormOptions<TDraft, TOriginal>,\n): Form<TDraft, TOriginal> {\n return new Form(options);\n}\n","export function castArray<T>(value: T | T[]): T[] {\n return Array.isArray(value) ? value : [value];\n}\n","import { fromExtendedJsonString, toExtendedJsonString } from '@lib/extendedJson';\n\nexport function defaultDeserializer<T>(value: string): T {\n if (value === undefined) {\n return undefined as T;\n }\n\n try {\n return fromExtendedJsonString(value) as T;\n } catch {\n return undefined as T;\n }\n}\n\nexport function defaultSerializer<T>(value: T): string {\n return toExtendedJsonString(value);\n}\n\nexport function normalizePath<T>(path: string | T): string | T {\n if (typeof path === 'string') {\n return path.replace(/^\\//g, '').replace(/\\/$/g, '');\n }\n return path;\n}\n","import { castArray } from '@lib/castArray';\nimport { defaultDeserializer, defaultSerializer, normalizePath } from '@react/url/urlHelpers';\n\nexport interface UrlOptions<T> {\n key: string;\n type?: 'search' | 'hash';\n serialize?: (value: T) => string;\n deserialize?: (value: string) => T;\n defaultValue: T;\n writeDefaultValue?: boolean;\n onCommit?: (value: T) => void;\n persist?: { id: string } | null;\n path?: string | RegExp | (string | RegExp)[] | null;\n}\n\nexport interface UrlOptionsWithoutDefaults<T>\n extends Omit<UrlOptions<T | undefined>, 'defaultValue'> {\n defaultValue?: T | undefined;\n}\n\nexport function createUrlOptions<T>(options: UrlOptions<T>): Required<UrlOptions<T>>;\nexport function createUrlOptions<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): Required<UrlOptions<T | undefined>>;\nexport function createUrlOptions<T>({\n key,\n type = 'hash',\n serialize = defaultSerializer,\n deserialize = defaultDeserializer,\n defaultValue = undefined as T,\n writeDefaultValue = false,\n onCommit = () => undefined,\n persist = null,\n path = null,\n}: UrlOptionsWithoutDefaults<T>): Required<UrlOptionsWithoutDefaults<T>> {\n return {\n key,\n type,\n serialize,\n deserialize,\n defaultValue,\n writeDefaultValue,\n onCommit,\n persist,\n path: path === null ? null : castArray(path).map(normalizePath),\n };\n}\n","import { createStore, Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { castArray } from '@lib/castArray';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport { get, set } from '@lib/propAccess';\nimport { normalizePath } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\n\nexport const urlStore: Store<string> = createStore(() => window.location.href, {\n cacheValue: false,\n effect() {\n const update = () => {\n if (window.location.href !== this.calculatedValue?.value) {\n this.invalidate();\n }\n };\n\n const interval = setInterval(update, 1);\n window.addEventListener('popstate', update);\n\n return () => {\n clearInterval(interval);\n window.removeEventListener('popstate', update);\n };\n },\n});\n\nexport class UrlParamStore<T> extends Store<T> {\n readonly storageKey: string | null;\n private lastHref?: string;\n private lastStorageValue?: string | null;\n private lastValue?: T;\n\n constructor(public readonly urlOptions: Required<UrlOptions<T>>) {\n super(() => this.calc(), { cacheValue: false });\n autobind(UrlParamStore);\n\n this.storageKey =\n urlOptions.persist && `cross-state:url:${urlOptions.persist.id}:${urlOptions.key}`;\n this.addEffect(this.watch);\n }\n\n private watch() {\n let isActive = false;\n let urlValue = this.getUrlValue();\n let storageValue = this.getStorageValue();\n\n const update = () => {\n const oldIsActive = isActive;\n isActive = this.isPathActive();\n const oldUrlValue = urlValue;\n urlValue = this.getUrlValue();\n const oldStorageValue = storageValue;\n storageValue = this.getStorageValue();\n\n // If inactive => ignore changes\n if (!isActive) {\n return;\n }\n\n // No changes => ignore\n if (\n isActive === oldIsActive &&\n urlValue === oldUrlValue &&\n storageValue === oldStorageValue\n ) {\n return;\n }\n\n if (!oldIsActive) {\n // Became active =>\n // - if url has value => update storage\n // - else if storage has value or writeDefaultValue => update url\n if (urlValue !== null) {\n this.updateStorage(this.urlOptions.deserialize(urlValue));\n } else if (storageValue !== null) {\n this.updateUrl(this.urlOptions.deserialize(storageValue));\n } else if (this.urlOptions.writeDefaultValue) {\n this.updateUrl(this.urlOptions.defaultValue);\n }\n } else if (urlValue !== oldUrlValue) {\n // Url change while active =>\n // - if url has no value and writeDefaultValue => update url\n // - update storage\n if (urlValue === null && this.urlOptions.writeDefaultValue) {\n this.updateUrl(this.urlOptions.defaultValue);\n }\n\n this.updateStorage(\n urlValue !== null ? this.urlOptions.deserialize(urlValue) : this.urlOptions.defaultValue,\n );\n }\n\n this.invalidate();\n };\n\n const cancel = urlStore.subscribe(update);\n window.addEventListener('storage', update);\n\n return () => {\n cancel();\n window.removeEventListener('storage', update);\n };\n }\n\n private getUrlValue() {\n const href = urlStore.get();\n const url = new URL(href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1) || '');\n return params.get(this.urlOptions.key);\n }\n\n private getStorageValue() {\n return this.storageKey !== null ? localStorage.getItem(this.storageKey) : null;\n }\n\n private isPathActive() {\n if (this.urlOptions.path === null) {\n return true;\n }\n\n const path = normalizePath(window.location.pathname);\n\n return castArray(this.urlOptions.path).some((p) => {\n if (typeof p === 'string') {\n return !p || p === path || path.startsWith(p + '/');\n }\n\n return p.test(path);\n });\n }\n\n private calc() {\n let href = window.location.href;\n const storageValue = this.storageKey !== null ? localStorage.getItem(this.storageKey) : null;\n\n if (!this.isPathActive() && this.lastHref !== undefined) {\n href = this.lastHref;\n }\n\n if (this.lastHref === href && this.lastStorageValue === storageValue) {\n return this.lastValue as T;\n }\n\n const url = new URL(href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1));\n const urlValue = params.get(this.urlOptions.key);\n\n const value =\n urlValue !== null\n ? this.urlOptions.deserialize(urlValue)\n : this.storageKey !== null && storageValue !== null\n ? this.urlOptions.deserialize(storageValue)\n : this.urlOptions.defaultValue;\n\n this.lastHref = href;\n this.lastStorageValue = storageValue;\n this.lastValue = value;\n return value;\n }\n\n private updateUrl(value: T) {\n const serializedValue = this.urlOptions.serialize(value);\n\n const url = new URL(window.location.href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1));\n\n if (\n !this.urlOptions.writeDefaultValue &&\n serializedValue === this.urlOptions.serialize(this.urlOptions.defaultValue)\n ) {\n params.delete(this.urlOptions.key);\n } else {\n params.set(this.urlOptions.key, serializedValue);\n }\n\n url[this.urlOptions.type] = params.toString();\n window.history.replaceState(window.history.state, '', url.toString());\n window.dispatchEvent(new PopStateEvent('popstate'));\n }\n\n private updateStorage(value: T) {\n if (this.storageKey === null) {\n return;\n }\n\n const serializedValue = this.urlOptions.serialize(value);\n localStorage.setItem(this.storageKey, serializedValue);\n }\n\n set(update: Update<T>): void;\n set<const P>(path: Constrain<P, Path<T>>, update: Update<Value<T, P>>): void;\n set(...args: any[]): void {\n const path: any = args.length > 1 ? args[0] : [];\n let update: Update<any> = args.length > 1 ? args[1] : args[0];\n\n if (update instanceof Function) {\n const before = this.get();\n const valueBefore = get(before, path);\n const valueAfter = update(valueBefore);\n update = set(before, path, valueAfter);\n } else if (path.length > 0) {\n update = set(this.get(), path, update);\n }\n\n if (this.isPathActive()) {\n this.updateUrl(update);\n } else {\n this.updateStorage(update);\n }\n }\n\n parse(path: string): T {\n const url = new URL(path, window.location.href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1) || '');\n const urlValue = params.get(this.urlOptions.key);\n return urlValue !== null ? this.urlOptions.deserialize(urlValue) : this.urlOptions.defaultValue;\n }\n}\n\nexport function createUrlParam<T>(options: UrlOptions<T>): UrlParamStore<T>;\nexport function createUrlParam<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): UrlParamStore<T | undefined>;\nexport function createUrlParam<T>(options: UrlOptionsWithoutDefaults<T>) {\n return new UrlParamStore(createUrlOptions(options));\n}\n","import { type Duration } from '@core';\nimport { debounce } from '@lib/debounce';\nimport { throttle } from '@lib/throttle';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport useMemoEquals from '@react/lib/useMemoEquals';\nimport { startTransition, useMemo, useState } from 'react';\n\nexport interface UseDecoupledStateOptions<T> {\n debounce?: Duration;\n throttle?: Duration;\n onCommit?: (value: T) => void;\n}\n\nexport function useDecoupledState<T>(\n value: T,\n onChange: (value: T) => void,\n options: UseDecoupledStateOptions<T> = {},\n): [state: T, setState: (value: T) => void] {\n const [dirty, setDirty] = useState<{ v: T }>();\n const latestOnChange = useLatestFunction(onChange);\n const latestOnCommit = useLatestFunction(options.onCommit ?? (() => {}));\n\n const debounceOptions = useMemoEquals(options.debounce);\n const throttleOptions = useMemoEquals(options.throttle);\n\n const update = useMemo(() => {\n const update = (value: T) => {\n latestOnChange(value);\n setDirty(undefined);\n latestOnCommit(value);\n };\n\n let delayedUpdate: (value: T) => void;\n\n if (debounceOptions) {\n delayedUpdate = debounce(update, debounceOptions);\n } else if (throttleOptions) {\n delayedUpdate = throttle(update, throttleOptions);\n } else {\n delayedUpdate = (value) => startTransition(() => update(value));\n }\n\n return (value: T) => {\n setDirty({ v: value });\n delayedUpdate(value);\n };\n }, [latestOnChange, latestOnCommit, debounceOptions, throttleOptions]);\n\n return [dirty ? dirty.v : value, update];\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["matches: Record<KeyType, any>","castArrayPath","isObject","value","form","useLatestFunction","name","Fragment","calcDuration","useLatestRef","queue","debounce","deepEqual","useLatestFunction","errors","get","set","deepEqual","join","isObject","options: FormOptions<TDraft, TOriginal>","useStore","form","createStore","lastDraft: TDraft | undefined","context: FormContext<TDraft, TOriginal>","transform","Form","fromExtendedJsonString","toExtendedJsonString","urlStore: Store<string>","createStore","Store","urlOptions: Required<UrlOptions<T>>","path: any","update: Update<any>","get","set","useLatestFunction","useMemoEquals","update","value","delayedUpdate: (value: T) => void","debounce","throttle"],"sources":["../../src/react/form/customInput.tsx","../../src/lib/wildcardMatch.ts","../../src/react/form/formField.tsx","../../src/react/form/formForEach.tsx","../../src/react/form/useFormAutosave.ts","../../src/react/form/form.tsx","../../src/lib/castArray.ts","../../src/react/url/urlHelpers.ts","../../src/react/url/urlOptions.ts","../../src/react/url/urlParamStore.ts","../../src/react/useDecoupledState.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nexport interface CustomInputProps extends React.HTMLAttributes<HTMLDivElement> {\n name: string;\n children?: ReactNode;\n}\n\nexport function CustomInput({ name, children, ...props }: CustomInputProps): React.JSX.Element {\n return (\n <div\n {...props}\n style={{\n position: 'relative',\n ...props.style,\n }}\n >\n {children}\n\n <input\n name={name}\n style={{\n position: 'absolute',\n top: 0,\n left: 0,\n opacity: 0,\n width: '100%',\n height: '100%',\n pointerEvents: 'none',\n }}\n />\n </div>\n );\n}\n","import { isObject } from '@lib/helpers';\nimport { type KeyType } from './path';\nimport { castArrayPath } from './propAccess';\n\nexport function wildcardMatch(s: KeyType[] | string, w: KeyType[] | string): boolean {\n if (typeof s === 'string') {\n s = castArrayPath(s);\n }\n\n if (typeof w === 'string') {\n w = castArrayPath(w);\n }\n\n return s.length === w.length && s.every((s, i) => w[i] === '*' || s === w[i]);\n}\n\nexport function getWildCardMatches(\n object: any,\n path: [KeyType, ...KeyType[]] | string,\n): Record<KeyType, any> {\n const matches: Record<KeyType, any> = {};\n const [first, second, ...rest] = castArrayPath(path);\n\n if (first === undefined) {\n throw new Error('Path is empty');\n }\n\n if (!Array.isArray(object) && !isObject(object)) {\n object = {};\n }\n\n for (const [key, value] of first !== '*' ? [[first, object[first]]] : Object.entries(object)) {\n if (first !== '*' && first !== key) {\n continue;\n }\n\n if (second === undefined) {\n matches[key] = value;\n continue;\n }\n\n for (const [subKey, subValue] of Object.entries(getWildCardMatches(value, [second, ...rest]))) {\n matches[`${key}.${subKey}`] = subValue;\n }\n }\n\n return matches;\n}\n","import { type PathAsString, type Value } from '@lib/path';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport {\n createElement,\n useEffect,\n useState,\n type Component,\n type ComponentPropsWithoutRef,\n type ReactNode,\n} from 'react';\nimport {\n getDerivedState,\n type Field,\n type Form,\n type FormContext,\n type FormInstance,\n} from './form';\n\nexport interface FormFieldComponentProps<TValue, TPath> {\n name: TPath;\n value: TValue;\n onChange: (event: { target: { value: TValue } } | TValue | undefined, ...args: any[]) => void;\n onBlur: (...args: any[]) => void;\n}\n\nexport type FormFieldInfos<TDraft, TOriginal, TPath extends string> = Field<\n TDraft,\n TOriginal,\n TPath\n> & {\n hasTriggeredValidations: boolean;\n};\n\ntype NativeInputType = 'input' | 'select' | 'textarea';\n\ntype PartialComponentType<P> =\n | (new (props: P, context?: any) => Component<P, any>)\n | ((props: P, context?: any) => ReactNode);\n\nexport type FormFieldComponent = NativeInputType | PartialComponentType<any>;\n\ntype FieldValue<T extends FormFieldComponent> = ComponentPropsWithoutRef<T>['value'];\n\ntype FieldChangeValue<T extends FormFieldComponent> =\n ComponentPropsWithoutRef<T> extends {\n onChange?: (update: infer U) => void;\n }\n ? U extends { target: { value: infer V } }\n ? V\n : U\n : never;\n\ntype MakeOptional<T, Keys extends string> = Omit<T, Keys> & Partial<Pick<T, Keys & keyof T>>;\n\nexport type FormFieldProps<TPath, TDraft> = {\n name: TPath & PathAsString<TDraft>;\n commitOnBlur?: boolean;\n commitDebounce?: number;\n};\n\nexport type FormFieldPropsWithRender<TDraft, TOriginal, TPath extends string> = FormFieldProps<\n TPath,\n TDraft\n> &\n NoInfer<{\n component?: undefined;\n render: (\n props: FormFieldComponentProps<Value<TDraft, TPath>, TPath>,\n info: FormFieldInfos<TDraft, TOriginal, TPath>,\n form: FormContext<TDraft, TOriginal>,\n ) => ReactNode;\n inputFilter?: undefined;\n defaultValue?: undefined;\n serialize?: undefined;\n deserialize?: undefined;\n onChange?: undefined;\n onBlur?: undefined;\n }>;\n\ntype Serialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: Value<TDraft, TPath>,\n formState: FormInstance<TDraft, TOriginal>,\n) => FieldValue<TComponent>;\n\ntype Deserialize<TDraft, TOriginal, TPath, TComponent extends FormFieldComponent> = (\n value: FieldChangeValue<TComponent>,\n formState: FormInstance<TDraft, TOriginal>,\n) => Value<TDraft, TPath>;\n\nexport type FormFieldPropsWithComponent<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n> = FormFieldProps<TPath, TDraft> & {\n component?: TComponent;\n render?: undefined;\n} & NoInfer<\n {\n inputFilter?: (value: FieldChangeValue<TComponent>) => boolean;\n } & MakeOptional<\n Omit<ComponentPropsWithoutRef<TComponent>, 'id' | 'name' | 'value' | 'defaultValue'>,\n 'onChange' | 'onBlur'\n > &\n (Value<TDraft, TPath> extends Exclude<FieldValue<TComponent>, undefined>\n ? {\n defaultValue?: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : Value<TDraft, TPath> extends FieldValue<TComponent>\n ?\n | {\n defaultValue: FieldValue<TComponent>;\n serialize?: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n | {\n defaultValue?: FieldValue<TComponent>;\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n serialize: Serialize<TDraft, TOriginal, TPath, TComponent>;\n }) &\n (FieldChangeValue<TComponent> extends Value<TDraft, TPath>\n ? {\n deserialize?: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n }\n : {\n deserialize: Deserialize<TDraft, TOriginal, TPath, TComponent>;\n })\n >;\n\nexport function FormField<\n TDraft,\n TOriginal,\n TPath extends string,\n TComponent extends FormFieldComponent,\n>(\n this: Form<TDraft, any>,\n {\n // id,\n name = '' as any,\n component,\n commitOnBlur,\n commitDebounce,\n render,\n inputFilter,\n defaultValue,\n serialize,\n deserialize = (x) => x as Value<TDraft, TPath>,\n onChange,\n onBlur,\n ...restProps\n }:\n | FormFieldPropsWithRender<TDraft, TOriginal, TPath>\n | FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n): React.JSX.Element | null {\n type T = FieldChangeValue<TComponent>;\n\n const form = this.useForm();\n const getFormState = () => ({ ...form, ...getDerivedState(form) });\n const [localValue, setLocalValue] = useState<T>();\n\n const value = this.useFormState((form) => {\n const value = form.getField(name as any).value;\n if (serialize) {\n return serialize(value as any, getFormState());\n }\n if (value !== undefined) {\n return value;\n }\n return defaultValue;\n });\n\n const setValue = useLatestFunction((x: FieldChangeValue<TComponent>) =>\n form.getField(name as any).setValue(deserialize(x, getFormState())),\n );\n\n const hasTriggeredValidations = this.useFormState((form) => form.hasTriggeredValidations);\n\n useEffect(() => {\n if (localValue === undefined || !commitDebounce) {\n return;\n }\n\n const timeout = setTimeout(() => {\n setValue(localValue);\n setLocalValue(undefined);\n }, commitDebounce);\n\n return () => clearTimeout(timeout);\n }, [localValue, commitDebounce, setValue]);\n\n const props = {\n name,\n value: localValue ?? value,\n onChange: (event: { target: { value: T } } | T, ...moreArgs: any[]) => {\n const value =\n typeof event === 'object' && event !== null && 'target' in event\n ? event.target.value\n : event;\n\n if (inputFilter && !inputFilter(value)) {\n return;\n }\n\n if (commitOnBlur || commitDebounce) {\n setLocalValue(value);\n } else {\n setValue(value);\n }\n\n onChange?.(event, ...moreArgs);\n },\n onBlur(...args: any[]) {\n if (localValue !== undefined) {\n setValue(localValue);\n setLocalValue(undefined);\n }\n\n onBlur?.(...args);\n },\n } as FormFieldComponentProps<Value<TDraft, TPath>, TPath>;\n\n if (render) {\n return (\n <>\n {render(props, { ...form.getField(name as any), hasTriggeredValidations } as any, form) ??\n null}\n </>\n );\n }\n\n if (component) {\n return createElement(component, { ...restProps, ...props });\n }\n\n return null;\n}\n","import { type GetKeys, type Join, type PathAsString, type Value } from '@lib/path';\nimport { Fragment, useCallback, type ReactNode } from 'react';\nimport { type FieldHelperMethods, type Form } from './form';\n\nexport type ElementName<TDraft, TPath extends string> = keyof {\n [Path in TPath as Join<Path, GetKeys<NonNullable<Value<TDraft, Path>>> & (string | number)>]: 1;\n};\n\nexport interface FormForEachProps<TDraft, TPath extends string> {\n name: TPath & PathAsString<TDraft>;\n renderElement?: (props: {\n name: ElementName<TDraft, TPath>;\n key: `${GetKeys<NonNullable<Value<TDraft, TPath>>> & (string | number)}`;\n index: number;\n remove: () => void;\n }) => ReactNode;\n children?: (\n props: {\n setValue: (\n value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>),\n ) => void;\n } & FieldHelperMethods<TDraft, TPath>,\n ) => ReactNode;\n}\n\nexport function FormForEach<TDraft, TPath extends string>(\n this: Form<TDraft, any>,\n { name, renderElement, children }: FormForEachProps<TDraft, TPath>,\n): React.JSX.Element {\n const form = this.useForm();\n\n const names = this.useFormState(() => {\n const field = form.getField(name as any) as any;\n return field.names as any[];\n });\n\n const add = useCallback(\n (...args: any[]) => {\n const field = form.getField(name as any) as any;\n field.add(...args);\n },\n [form, name],\n );\n\n const remove = useCallback(\n (key: any) => {\n const field = form.getField(name as any) as any;\n field.remove(key);\n },\n [form, name],\n );\n\n const setValue = useCallback(\n (value: Value<TDraft, TPath> | ((value: Value<TDraft, TPath>) => Value<TDraft, TPath>)) => {\n const field = form.getField(name as any) as any;\n field.setValue(value);\n },\n [form, name],\n );\n\n return (\n <>\n {renderElement &&\n names.map((name, index) => {\n const key = name.split('.').pop();\n\n return (\n <Fragment key={key}>\n {renderElement({\n name,\n key,\n index,\n remove: () => remove(key),\n })}\n </Fragment>\n );\n })}\n\n {children?.({\n names,\n add,\n remove,\n setValue,\n } as any)}\n </>\n );\n}\n","import type { Duration } from '@core';\nimport { calcDuration } from '@lib/calcDuration';\nimport { debounce } from '@lib/debounce';\nimport { deepEqual } from '@lib/equals';\nimport type { MaybePromise } from '@lib/maybePromise';\nimport { queue } from '@lib/queue';\nimport useLatestRef from '@react/lib/useLatestRef';\nimport { useEffect, useMemo, useRef } from 'react';\nimport type { FormContext } from './form';\n\nexport interface FormAutosaveOptions<TDraft, TOriginal> {\n save: (draft: TDraft, form: FormContext<TDraft, TOriginal>) => MaybePromise<void>;\n debounce?: Duration;\n resetAfterSave?: boolean;\n}\n\nexport function useFormAutosave<TDraft, TOriginal extends TDraft>(\n form: FormContext<TDraft, TOriginal>,\n): void {\n const debounceTime = calcDuration(form.options.autoSave?.debounce ?? 2_000);\n const latestRef = useLatestRef(form);\n const lastValue = useRef<TDraft | undefined>(undefined);\n const q = useMemo(() => queue(), []);\n\n const run = useMemo(\n () =>\n debounce(async () => {\n const save = latestRef.current.options.autoSave?.save;\n const draft = latestRef.current.getDraft();\n\n lastValue.current = draft;\n\n q.clear();\n\n q(async () => {\n try {\n latestRef.current.formState.set('saveInProgress', true);\n await save?.(draft, latestRef.current);\n\n if (q.size === 0 && latestRef.current.options.autoSave?.resetAfterSave) {\n latestRef.current.reset();\n }\n } finally {\n latestRef.current.formState.set('saveInProgress', false);\n\n if (q.size === 0) {\n latestRef.current.formState.set('saveScheduled', false);\n }\n }\n });\n }, debounceTime),\n [latestRef, debounceTime, q],\n );\n\n useEffect(() => {\n if (!latestRef.current.options.autoSave?.save) {\n return;\n }\n\n return latestRef.current.formState\n .map((state) => state.draft)\n .subscribe(\n () => {\n if (deepEqual(latestRef.current.getDraft(), lastValue.current)) {\n return;\n }\n\n run();\n latestRef.current.formState.set('saveScheduled', true);\n },\n { runNow: false },\n );\n }, [latestRef, run]);\n}\n","import { createStore, type Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { deepEqual } from '@lib/equals';\nimport { isObject } from '@lib/helpers';\nimport {\n type PathAsString,\n type Value,\n type WildcardPathAsString,\n type WildcardValue,\n} from '@lib/path';\nimport { get, join, set } from '@lib/propAccess';\nimport type { Object_ } from '@lib/typeHelpers';\nimport { getWildCardMatches } from '@lib/wildcardMatch';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport {\n createContext,\n useContext,\n useEffect,\n useMemo,\n useRef,\n type Context,\n type FormEvent,\n type FunctionComponent,\n type HTMLProps,\n type ReactNode,\n} from 'react';\nimport { useStore, type UseStoreOptions } from '../useStore';\nimport {\n FormField,\n type FormFieldComponent,\n type FormFieldPropsWithComponent,\n type FormFieldPropsWithRender,\n} from './formField';\nimport { FormForEach, type ElementName, type FormForEachProps } from './formForEach';\nimport { useFormAutosave, type FormAutosaveOptions } from './useFormAutosave';\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Form types\n/// /////////////////////////////////////////////////////////////////////////////\n\nexport interface Transform<TDraft> {\n (value: TDraft, store: Store<TDraft>): void | TDraft;\n}\n\nexport interface FormOptions<TDraft, TOriginal> {\n defaultValue: TDraft;\n validations?: Validations<TDraft, TOriginal>;\n localizeError?: (error: string, field: string) => string | undefined;\n autoSave?: FormAutosaveOptions<TDraft, TOriginal>;\n transform?: Transform<TDraft>;\n validatedClass?: string;\n original?: TOriginal;\n onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;\n reportValidity?: boolean;\n}\n\nexport type Validations<TDraft, TOriginal> = {\n [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>>;\n} & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;\n\nexport type Validation<TDraft, TOriginal, TPath> = (\n value: WildcardValue<TDraft, TPath>,\n context: {\n draft: TDraft;\n original: TOriginal;\n field: PathAsString<TDraft> | '';\n },\n) => boolean;\n\nexport type Field<TDraft, TOriginal, TPath extends string> = {\n originalValue: Value<TOriginal, TPath> | undefined;\n value: Value<TDraft, TPath>;\n setValue: (value: Update<Value<TDraft, TPath>>) => void;\n removeValue: () => void;\n hasChange: boolean;\n errors: string[];\n} & (Value<TDraft, TPath> extends Object_ ? FieldHelperMethods<TDraft, TPath> : {});\n\nexport type FieldHelperMethods<TDraft, TPath extends string> = {\n names: ElementName<TDraft, TPath>[];\n add: NonNullable<Value<TDraft, TPath>> extends readonly (infer T)[]\n ? (element: T) => void\n : NonNullable<Value<TDraft, TPath>> extends Record<infer K, infer V>\n ? (key: K, value: V) => void\n : never;\n remove: Value<TDraft, TPath> extends readonly any[]\n ? (index: number) => void\n : (key: string) => void;\n};\n\nexport interface FormState<TDraft> {\n draft: TDraft | undefined;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n}\n\nexport interface FormDerivedState<TDraft> {\n draft: TDraft;\n hasTriggeredValidations: boolean;\n saveScheduled: boolean;\n saveInProgress: boolean;\n hasChanges: boolean;\n errors: Map<string, string[]>;\n isValid: boolean;\n}\n\nexport interface FormContext<TDraft, TOriginal> {\n formState: Store<FormState<TDraft>>;\n options: FormOptions<TDraft, TOriginal>;\n original: TOriginal | undefined;\n getField: <TPath extends string>(path: TPath) => Field<TDraft, TOriginal, TPath>;\n getDraft: () => TDraft;\n hasTriggeredValidations: () => boolean;\n saveScheduled: () => boolean;\n saveInProgress: () => boolean;\n hasChanges: () => boolean;\n getErrors: () => Map<string, string[]>;\n isValid: () => boolean;\n validate: () => boolean;\n reset: () => void;\n}\n\nexport interface FormInstance<TDraft, TOriginal>\n extends FormDerivedState<TDraft>,\n Pick<\n FormContext<TDraft, TOriginal>,\n 'options' | 'original' | 'getField' | 'validate' | 'reset'\n > {}\n\n/// /////////////////////////////////////////////////////////////////////////////\n// Implementation\n/// /////////////////////////////////////////////////////////////////////////////\n\nfunction FormContainer({\n form,\n ...formProps\n}: {\n form: Form<any, any>;\n onSubmit?: (\n event: FormEvent<HTMLFormElement>,\n form: FormInstance<any, any>,\n ) => void | Promise<void>;\n} & Omit<HTMLProps<HTMLFormElement>, 'form' | 'onSubmit'>) {\n const formInstance = form.useForm();\n const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);\n const hasErrors = form.useFormState((state) => hasTriggeredValidations && state.errors.size > 0);\n\n const formRef = useRef<HTMLFormElement>(null);\n\n const updateValidity = useLatestFunction(\n (errors: Map<string, string[]>, buttonElement?: HTMLButtonElement) => {\n const formElement = formRef.current;\n if (!formElement) {\n return;\n }\n\n const localizedErrors = new Map(\n [...errors.entries()].map(\n ([field, errors]) =>\n [\n field,\n errors.map((error) => formInstance.options.localizeError?.(error, field) ?? error),\n ] as const,\n ),\n );\n\n for (const element of Array.from(formElement.elements)) {\n if ('name' in element && 'setCustomValidity' in element) {\n (element as HTMLObjectElement).setCustomValidity(\n localizedErrors.get((element as HTMLObjectElement).name)?.join('\\n') ?? '',\n );\n }\n }\n\n if (buttonElement && 'setCustomValidity' in buttonElement) {\n const errorString = [...errors.values()].flat().join('\\n');\n\n buttonElement.setCustomValidity(errorString);\n }\n },\n );\n\n useEffect(() => {\n if (!formInstance.options.reportValidity) {\n return;\n }\n\n return formInstance.formState\n .map(() => formInstance.getErrors())\n .subscribe((errors) => updateValidity(errors));\n }, [formInstance, updateValidity]);\n\n return (\n <form\n ref={formRef}\n noValidate\n {...formProps}\n className={[\n formProps.className,\n hasTriggeredValidations ? (formInstance.options.validatedClass ?? 'validated') : undefined,\n ]\n .filter(Boolean)\n .join(' ')}\n data-validated={hasTriggeredValidations || undefined}\n data-valid={hasErrors ? 'false' : hasTriggeredValidations ? 'true' : undefined}\n onSubmit={async (event) => {\n if (formInstance.saveInProgress()) {\n return;\n }\n\n try {\n formInstance.formState.set('saveInProgress', true);\n event.preventDefault();\n\n if (formInstance.options.reportValidity) {\n const formElement = event.currentTarget;\n const buttonElement =\n event.nativeEvent instanceof SubmitEvent &&\n event.nativeEvent.submitter instanceof HTMLButtonElement\n ? event.nativeEvent.submitter\n : undefined;\n\n updateValidity(formInstance.getErrors(), buttonElement);\n formElement.reportValidity();\n }\n\n const isValid = formInstance.validate();\n if (isValid) {\n await formProps.onSubmit?.(event, {\n ...formInstance,\n ...getDerivedState(formInstance),\n });\n }\n } finally {\n formInstance.formState.set('saveInProgress', false);\n }\n }}\n />\n );\n}\n\nfunction getField<TDraft, TOriginal extends TDraft, TPath extends string>(\n form: FormContext<TDraft, TOriginal>,\n path: TPath,\n): Field<TDraft, TOriginal, TPath> {\n const field = {\n get originalValue() {\n return form.original !== undefined ? get(form.original as any, path as any) : undefined;\n },\n\n get value() {\n const draft = form.getDraft();\n return get(draft ?? form.original ?? form.options.defaultValue, path as any);\n },\n\n setValue(update: Update<Value<TDraft, TPath>>) {\n form.formState.set('draft', (draft = form.original ?? form.options.defaultValue) => {\n if (update instanceof Function) {\n update = update(get(draft, path as any) as Value<TDraft, TPath>);\n }\n\n return set(draft, path as any, update as any);\n });\n },\n\n get hasChange() {\n return !deepEqual(this.originalValue, this.value, { undefinedEqualsAbsent: true });\n },\n\n get errors() {\n const errors = form.getErrors();\n return errors.get(path) ?? [];\n },\n\n get names(): any {\n const { value } = this;\n\n if (Array.isArray(value)) {\n return value.map((_, index) => join(path, String(index)));\n }\n\n if (isObject(value)) {\n return Object.keys(value).map((key) => join(path, key));\n }\n\n return [];\n },\n\n add(...args: any[]) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return [...(value ?? []), args[0]];\n }\n\n if (isObject(value)) {\n return {\n ...value,\n [args[0]]: args[1],\n };\n }\n\n throw new Error(`Cannot add element to ${JSON.stringify(value)}`);\n });\n },\n\n remove(key: string | number) {\n this.setValue((value): any => {\n if (!value) {\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n }\n\n if (Array.isArray(value)) {\n return value.filter((_, index) => index !== Number(key));\n }\n\n if (isObject(value)) {\n const { [key]: _, ...rest } = value as Record<string | number, unknown>;\n return rest;\n }\n\n throw new Error(`Cannot remove element from ${JSON.stringify(value)}`);\n });\n },\n };\n\n return field as any;\n}\n\nfunction getErrors<TDraft, TOriginal>(\n draft: TDraft,\n original: TOriginal | undefined,\n validations: FormOptions<TDraft, TOriginal>['validations'],\n) {\n const errors = new Map<string, string[]>();\n\n for (const [path, block] of Object.entries(validations ?? {})) {\n for (const [validationName, validate] of Object.entries(\n block as Record<string, Validation<any, any, any>>,\n )) {\n let matched = false;\n\n for (const [field, value] of Object.entries(getWildCardMatches(draft, path))) {\n matched = true;\n if (!validate(value, { draft, original, field })) {\n const fieldErrors = errors.get(field) ?? [];\n fieldErrors.push(validationName);\n errors.set(field, fieldErrors);\n }\n }\n\n if (!matched && !path.includes('*')) {\n if (!validate(undefined, { draft, original, field: path })) {\n const fieldErrors = errors.get(path) ?? [];\n fieldErrors.push(validationName);\n errors.set(path, fieldErrors);\n }\n }\n }\n }\n\n return errors;\n}\n\nexport function getDerivedState<TDraft>(\n instance: FormContext<TDraft, any>,\n): FormDerivedState<TDraft> {\n return {\n draft: instance.getDraft(),\n hasTriggeredValidations: instance.hasTriggeredValidations(),\n saveScheduled: instance.saveScheduled(),\n saveInProgress: instance.saveInProgress(),\n hasChanges: instance.hasChanges(),\n errors: instance.getErrors(),\n isValid: instance.isValid(),\n };\n}\n\nexport class Form<TDraft, TOriginal extends TDraft = TDraft> {\n context: Context<FormContext<TDraft, TOriginal> | null> = createContext<FormContext<\n TDraft,\n TOriginal\n > | null>(null);\n\n constructor(public readonly options: FormOptions<TDraft, TOriginal>) {\n autobind(Form);\n }\n\n useForm(): FormContext<TDraft, TOriginal> {\n const context = useContext(this.context);\n\n if (!context) {\n throw new Error('Form context not found');\n }\n\n return context;\n }\n\n useFormState<S>(\n selector: (state: FormInstance<TDraft, TOriginal>) => S,\n useStoreOptions?: UseStoreOptions<S>,\n ): S {\n const form = this.useForm();\n\n return useStore(\n form.formState,\n () =>\n selector({\n ...form,\n ...getDerivedState(form),\n }),\n\n useStoreOptions,\n );\n }\n\n useField<TPath extends string>(\n path: TPath,\n useStoreOptions?: UseStoreOptions<any>,\n ): Field<TDraft, TOriginal, TPath> {\n const form = this.useForm();\n this.useFormState((form) => [form.getField(path).value, form.original], useStoreOptions);\n return form.getField(path);\n }\n\n // ///////////////////////////////////////////////////////////////////////////\n // React Components\n // ///////////////////////////////////////////////////////////////////////////\n\n Form({\n defaultValue,\n validations,\n localizeError,\n autoSave,\n transform,\n validatedClass,\n original,\n onSubmit,\n reportValidity,\n ...formProps\n }: Partial<FormOptions<TDraft, TOriginal>> &\n Omit<HTMLProps<HTMLFormElement>, 'defaultValue' | 'autoSave' | 'onSubmit'>): React.JSX.Element {\n const options: FormOptions<TDraft, TOriginal> = {\n defaultValue: { ...this.options.defaultValue, ...defaultValue },\n validations: { ...this.options.validations, ...validations } as Validations<\n TDraft,\n TOriginal\n >,\n localizeError: localizeError ?? this.options.localizeError,\n autoSave: autoSave ?? this.options.autoSave,\n transform: transform ?? this.options.transform,\n validatedClass: validatedClass ?? this.options.validatedClass,\n original: original ?? this.options.original,\n onSubmit: onSubmit ?? this.options.onSubmit,\n reportValidity: reportValidity ?? this.options.reportValidity ?? true,\n };\n\n const formState = useMemo(() => {\n return createStore<FormState<TDraft>>({\n draft: undefined,\n hasTriggeredValidations: false,\n saveScheduled: false,\n saveInProgress: false,\n });\n }, []);\n\n let lastDraft: TDraft | undefined;\n const cache = new Map<string, unknown>();\n function lazy<T>(key: string, fn: () => T): T {\n if (lastDraft !== formState.get().draft) {\n cache.clear();\n lastDraft = formState.get().draft;\n }\n\n let value = cache.get(key);\n if (!cache.has(key)) {\n value = fn();\n cache.set(key, value);\n }\n\n return value as T;\n }\n\n const context: FormContext<TDraft, TOriginal> = {\n formState,\n options,\n original: options.original,\n\n getField() {\n throw new Error('Not implemented');\n },\n\n getDraft() {\n return formState.get().draft ?? options.original ?? options.defaultValue;\n },\n\n hasTriggeredValidations() {\n return formState.get().hasTriggeredValidations;\n },\n\n saveScheduled() {\n return formState.get().saveScheduled;\n },\n\n saveInProgress() {\n return formState.get().saveInProgress;\n },\n\n hasChanges() {\n return lazy(\n 'hasChanges',\n () =>\n !deepEqual(this.getDraft(), options.original ?? options.defaultValue, {\n undefinedEqualsAbsent: true,\n }),\n );\n },\n\n getErrors() {\n return lazy('getErrors', () =>\n getErrors(this.getDraft(), options.original, options.validations),\n );\n },\n\n isValid() {\n return lazy('isValid', () => this.getErrors().size === 0);\n },\n\n validate() {\n formState.set('hasTriggeredValidations', true);\n return this.isValid();\n },\n\n reset() {\n formState.set('draft', undefined);\n formState.set('hasTriggeredValidations', false);\n },\n };\n\n context.getField = (path) => lazy(path, () => getField(context, path));\n\n useEffect(() => {\n const transform = options.transform;\n if (!transform) {\n return;\n }\n\n const store = formState.map(\n (state) => state.draft ?? options.original ?? options.defaultValue,\n (draft) => (state) => ({ ...state, draft }),\n );\n\n return store.subscribe((value) => {\n const result = transform(value, store);\n\n if (result !== undefined && !deepEqual(result, value)) {\n store.set(result);\n }\n });\n }, [options.defaultValue, options.original, options.transform, formState]);\n\n useFormAutosave(context);\n\n return (\n <this.context.Provider value={context}>\n <FormContainer {...formProps} form={this} />\n </this.context.Provider>\n );\n }\n\n FormState<S>({\n selector,\n children,\n }: {\n selector: (form: FormInstance<TDraft, TOriginal>) => S;\n children: (selectedState: S) => ReactNode;\n }): React.JSX.Element {\n const selectedState = this.useFormState(selector);\n return <>{children(selectedState)}</>;\n }\n\n Field<const TPath extends string>(\n props: FormFieldPropsWithRender<TDraft, TOriginal, TPath>,\n ): React.JSX.Element;\n\n Field<const TPath extends string, const TComponent extends FormFieldComponent = 'input'>(\n props: FormFieldPropsWithComponent<TDraft, TOriginal, TPath, TComponent>,\n ): React.JSX.Element;\n\n Field(props: any): React.JSX.Element {\n return Reflect.apply(FormField, this, [{ component: 'input', ...props }]);\n }\n\n ForEach<const TPath extends string>(props: FormForEachProps<TDraft, TPath>): React.JSX.Element {\n return Reflect.apply(FormForEach, this, [props]);\n }\n\n withForm<TProps extends Record<string, unknown>>(\n Component: React.ComponentType<TProps>,\n formProps?: Parameters<this['Form']>[0],\n ): FunctionComponent<TProps> {\n const { Form } = this;\n return function FormWrapper(props: TProps) {\n return (\n <Form {...formProps}>\n <Component {...props} />\n </Form>\n );\n };\n }\n}\n\nexport function createForm<TDraft, TOriginal extends TDraft = TDraft>(\n options: FormOptions<TDraft, TOriginal>,\n): Form<TDraft, TOriginal> {\n return new Form(options);\n}\n","export function castArray<T>(value: T | T[]): T[] {\n return Array.isArray(value) ? value : [value];\n}\n","import { fromExtendedJsonString, toExtendedJsonString } from '@lib/extendedJson';\n\nexport function defaultDeserializer<T>(value: string): T {\n if (value === undefined) {\n return undefined as T;\n }\n\n try {\n return fromExtendedJsonString(value) as T;\n } catch {\n return undefined as T;\n }\n}\n\nexport function defaultSerializer<T>(value: T): string {\n return toExtendedJsonString(value);\n}\n\nexport function normalizePath<T>(path: string | T): string | T {\n if (typeof path === 'string') {\n return path.replace(/^\\//g, '').replace(/\\/$/g, '');\n }\n return path;\n}\n","import { castArray } from '@lib/castArray';\nimport { defaultDeserializer, defaultSerializer, normalizePath } from '@react/url/urlHelpers';\n\nexport interface UrlOptions<T> {\n key: string;\n type?: 'search' | 'hash';\n serialize?: (value: T) => string;\n deserialize?: (value: string) => T;\n defaultValue: T;\n writeDefaultValue?: boolean;\n onCommit?: (value: T) => void;\n persist?: { id: string } | null;\n path?: string | RegExp | (string | RegExp)[] | null;\n}\n\nexport interface UrlOptionsWithoutDefaults<T>\n extends Omit<UrlOptions<T | undefined>, 'defaultValue'> {\n defaultValue?: T | undefined;\n}\n\nexport function createUrlOptions<T>(options: UrlOptions<T>): Required<UrlOptions<T>>;\nexport function createUrlOptions<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): Required<UrlOptions<T | undefined>>;\nexport function createUrlOptions<T>({\n key,\n type = 'hash',\n serialize = defaultSerializer,\n deserialize = defaultDeserializer,\n defaultValue = undefined as T,\n writeDefaultValue = false,\n onCommit = () => undefined,\n persist = null,\n path = null,\n}: UrlOptionsWithoutDefaults<T>): Required<UrlOptionsWithoutDefaults<T>> {\n return {\n key,\n type,\n serialize,\n deserialize,\n defaultValue,\n writeDefaultValue,\n onCommit,\n persist,\n path: path === null ? null : castArray(path).map(normalizePath),\n };\n}\n","import { createStore, Store, type Update } from '@core';\nimport { autobind } from '@lib/autobind';\nimport { castArray } from '@lib/castArray';\nimport type { Constrain } from '@lib/constrain';\nimport type { Path, Value } from '@lib/path';\nimport { get, set } from '@lib/propAccess';\nimport { normalizePath } from '@react/url/urlHelpers';\nimport {\n createUrlOptions,\n type UrlOptions,\n type UrlOptionsWithoutDefaults,\n} from '@react/url/urlOptions';\n\nexport const urlStore: Store<string> = createStore(() => window.location.href, {\n cacheValue: false,\n effect() {\n const update = () => {\n if (window.location.href !== this.calculatedValue?.value) {\n this.invalidate();\n }\n };\n\n const interval = setInterval(update, 1);\n window.addEventListener('popstate', update);\n\n return () => {\n clearInterval(interval);\n window.removeEventListener('popstate', update);\n };\n },\n});\n\nexport class UrlParamStore<T> extends Store<T> {\n readonly storageKey: string | null;\n private lastHref?: string;\n private lastStorageValue?: string | null;\n private lastValue?: T;\n\n constructor(public readonly urlOptions: Required<UrlOptions<T>>) {\n super(() => this.calc(), { cacheValue: false });\n autobind(UrlParamStore);\n\n this.storageKey =\n urlOptions.persist && `cross-state:url:${urlOptions.persist.id}:${urlOptions.key}`;\n this.addEffect(this.watch);\n }\n\n private watch() {\n let isActive = false;\n let urlValue = this.getUrlValue();\n let storageValue = this.getStorageValue();\n\n const update = () => {\n const oldIsActive = isActive;\n isActive = this.isPathActive();\n const oldUrlValue = urlValue;\n urlValue = this.getUrlValue();\n const oldStorageValue = storageValue;\n storageValue = this.getStorageValue();\n\n // If inactive => ignore changes\n if (!isActive) {\n return;\n }\n\n // No changes => ignore\n if (\n isActive === oldIsActive &&\n urlValue === oldUrlValue &&\n storageValue === oldStorageValue\n ) {\n return;\n }\n\n if (!oldIsActive) {\n // Became active =>\n // - if url has value => update storage\n // - else if storage has value or writeDefaultValue => update url\n if (urlValue !== null) {\n this.updateStorage(this.urlOptions.deserialize(urlValue));\n } else if (storageValue !== null) {\n this.updateUrl(this.urlOptions.deserialize(storageValue));\n } else if (this.urlOptions.writeDefaultValue) {\n this.updateUrl(this.urlOptions.defaultValue);\n }\n } else if (urlValue !== oldUrlValue) {\n // Url change while active =>\n // - if url has no value and writeDefaultValue => update url\n // - update storage\n if (urlValue === null && this.urlOptions.writeDefaultValue) {\n this.updateUrl(this.urlOptions.defaultValue);\n }\n\n this.updateStorage(\n urlValue !== null ? this.urlOptions.deserialize(urlValue) : this.urlOptions.defaultValue,\n );\n }\n\n this.invalidate();\n };\n\n const cancel = urlStore.subscribe(update);\n window.addEventListener('storage', update);\n\n return () => {\n cancel();\n window.removeEventListener('storage', update);\n };\n }\n\n private getUrlValue() {\n const href = urlStore.get();\n const url = new URL(href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1) || '');\n return params.get(this.urlOptions.key);\n }\n\n private getStorageValue() {\n return this.storageKey !== null ? localStorage.getItem(this.storageKey) : null;\n }\n\n private isPathActive() {\n if (this.urlOptions.path === null) {\n return true;\n }\n\n const path = normalizePath(window.location.pathname);\n\n return castArray(this.urlOptions.path).some((p) => {\n if (typeof p === 'string') {\n return !p || p === path || path.startsWith(p + '/');\n }\n\n return p.test(path);\n });\n }\n\n private calc() {\n let href = window.location.href;\n const storageValue = this.storageKey !== null ? localStorage.getItem(this.storageKey) : null;\n\n if (!this.isPathActive() && this.lastHref !== undefined) {\n href = this.lastHref;\n }\n\n if (this.lastHref === href && this.lastStorageValue === storageValue) {\n return this.lastValue as T;\n }\n\n const url = new URL(href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1));\n const urlValue = params.get(this.urlOptions.key);\n\n const value =\n urlValue !== null\n ? this.urlOptions.deserialize(urlValue)\n : this.storageKey !== null && storageValue !== null\n ? this.urlOptions.deserialize(storageValue)\n : this.urlOptions.defaultValue;\n\n this.lastHref = href;\n this.lastStorageValue = storageValue;\n this.lastValue = value;\n return value;\n }\n\n private updateUrl(value: T) {\n const serializedValue = this.urlOptions.serialize(value);\n\n const url = new URL(window.location.href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1));\n\n if (\n !this.urlOptions.writeDefaultValue &&\n serializedValue === this.urlOptions.serialize(this.urlOptions.defaultValue)\n ) {\n params.delete(this.urlOptions.key);\n } else {\n params.set(this.urlOptions.key, serializedValue);\n }\n\n url[this.urlOptions.type] = params.toString();\n window.history.replaceState(window.history.state, '', url.toString());\n window.dispatchEvent(new PopStateEvent('popstate'));\n }\n\n private updateStorage(value: T) {\n if (this.storageKey === null) {\n return;\n }\n\n const serializedValue = this.urlOptions.serialize(value);\n localStorage.setItem(this.storageKey, serializedValue);\n }\n\n set(update: Update<T>): void;\n set<const P>(path: Constrain<P, Path<T>>, update: Update<Value<T, P>>): void;\n set(...args: any[]): void {\n const path: any = args.length > 1 ? args[0] : [];\n let update: Update<any> = args.length > 1 ? args[1] : args[0];\n\n if (update instanceof Function) {\n const before = this.get();\n const valueBefore = get(before, path);\n const valueAfter = update(valueBefore);\n update = set(before, path, valueAfter);\n } else if (path.length > 0) {\n update = set(this.get(), path, update);\n }\n\n if (this.isPathActive()) {\n this.updateUrl(update);\n } else {\n this.updateStorage(update);\n }\n }\n\n parse(path: string): T {\n const url = new URL(path, window.location.href);\n const params = new URLSearchParams(url[this.urlOptions.type].slice(1) || '');\n const urlValue = params.get(this.urlOptions.key);\n return urlValue !== null ? this.urlOptions.deserialize(urlValue) : this.urlOptions.defaultValue;\n }\n}\n\nexport function createUrlParam<T>(options: UrlOptions<T>): UrlParamStore<T>;\nexport function createUrlParam<T>(\n options: UrlOptionsWithoutDefaults<T>,\n): UrlParamStore<T | undefined>;\nexport function createUrlParam<T>(options: UrlOptionsWithoutDefaults<T>) {\n return new UrlParamStore(createUrlOptions(options));\n}\n","import { type Duration } from '@core';\nimport { debounce } from '@lib/debounce';\nimport { throttle } from '@lib/throttle';\nimport useLatestFunction from '@react/lib/useLatestFunction';\nimport useMemoEquals from '@react/lib/useMemoEquals';\nimport { startTransition, useMemo, useState } from 'react';\n\nexport interface UseDecoupledStateOptions<T> {\n debounce?: Duration;\n throttle?: Duration;\n onCommit?: (value: T) => void;\n}\n\nexport function useDecoupledState<T>(\n value: T,\n onChange: (value: T) => void,\n options: UseDecoupledStateOptions<T> = {},\n): [state: T, setState: (value: T) => void] {\n const [dirty, setDirty] = useState<{ v: T }>();\n const latestOnChange = useLatestFunction(onChange);\n const latestOnCommit = useLatestFunction(options.onCommit ?? (() => {}));\n\n const debounceOptions = useMemoEquals(options.debounce);\n const throttleOptions = useMemoEquals(options.throttle);\n\n const update = useMemo(() => {\n const update = (value: T) => {\n latestOnChange(value);\n setDirty(undefined);\n latestOnCommit(value);\n };\n\n let delayedUpdate: (value: T) => void;\n\n if (debounceOptions) {\n delayedUpdate = debounce(update, debounceOptions);\n } else if (throttleOptions) {\n delayedUpdate = throttle(update, throttleOptions);\n } else {\n delayedUpdate = (value) => startTransition(() => update(value));\n }\n\n return (value: T) => {\n setDirty({ v: value });\n delayedUpdate(value);\n };\n }, [latestOnChange, latestOnCommit, debounceOptions, throttleOptions]);\n\n return [dirty ? dirty.v : value, update];\n}\n"],"mappings":";;;;;;;;;;;AAOA,SAAgB,YAAY,EAAE,MAAM,SAAU,GAAG,SAA8C;AAC7F,QACE,4CAAC;EACC,GAAI;EACJ,OAAO;GACL,UAAU;GACV,GAAG,MAAM;GACV;aAEA,UAED,2CAAC;GACO;GACN,OAAO;IACL,UAAU;IACV,KAAK;IACL,MAAM;IACN,SAAS;IACT,OAAO;IACP,QAAQ;IACR,eAAe;IAChB;IACD;GACE;;;;;ACdV,SAAgB,mBACd,QACA,MACsB;CACtB,MAAMA,UAAgC,EAAE;CACxC,MAAM,CAAC,OAAO,QAAQ,GAAG,QAAQC,iCAAc,KAAK;AAEpD,KAAI,UAAU,OACZ,OAAM,IAAI,MAAM,gBAAgB;AAGlC,KAAI,CAAC,MAAM,QAAQ,OAAO,IAAI,CAACC,4BAAS,OAAO,CAC7C,UAAS,EAAE;AAGb,MAAK,MAAM,CAAC,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC,OAAO,OAAO,OAAO,CAAC,GAAG,OAAO,QAAQ,OAAO,EAAE;AAC5F,MAAI,UAAU,OAAO,UAAU,IAC7B;AAGF,MAAI,WAAW,QAAW;AACxB,WAAQ,OAAO;AACf;;AAGF,OAAK,MAAM,CAAC,QAAQ,aAAa,OAAO,QAAQ,mBAAmB,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAC3F,SAAQ,GAAG,IAAI,GAAG,YAAY;;AAIlC,QAAO;;;;;ACqFT,SAAgB,UAOd,EAEE,OAAO,IACP,WACA,cACA,gBACA,QACA,aACA,cACA,WACA,eAAe,MAAM,GACrB,UACA,OACA,GAAG,aAIqB;CAG1B,MAAM,OAAO,KAAK,SAAS;CAC3B,MAAM,sBAAsB;EAAE,GAAG;EAAM,GAAG,gBAAgB,KAAK;EAAE;CACjE,MAAM,CAAC,YAAY,sCAA8B;CAEjD,MAAM,QAAQ,KAAK,cAAc,WAAS;EACxC,MAAMC,UAAQC,OAAK,SAAS,KAAY,CAAC;AACzC,MAAI,UACF,QAAO,UAAUD,SAAc,cAAc,CAAC;AAEhD,MAAIA,YAAU,OACZ,QAAOA;AAET,SAAO;GACP;CAEF,MAAM,WAAWE,wCAAmB,MAClC,KAAK,SAAS,KAAY,CAAC,SAAS,YAAY,GAAG,cAAc,CAAC,CAAC,CACpE;CAED,MAAM,0BAA0B,KAAK,cAAc,WAASD,OAAK,wBAAwB;AAEzF,4BAAgB;AACd,MAAI,eAAe,UAAa,CAAC,eAC/B;EAGF,MAAM,UAAU,iBAAiB;AAC/B,YAAS,WAAW;AACpB,iBAAc,OAAU;KACvB,eAAe;AAElB,eAAa,aAAa,QAAQ;IACjC;EAAC;EAAY;EAAgB;EAAS,CAAC;CAE1C,MAAM,QAAQ;EACZ;EACA,OAAO,cAAc;EACrB,WAAW,OAAqC,GAAG,aAAoB;GACrE,MAAMD,UACJ,OAAO,UAAU,YAAY,UAAU,QAAQ,YAAY,QACvD,MAAM,OAAO,QACb;AAEN,OAAI,eAAe,CAAC,YAAYA,QAAM,CACpC;AAGF,OAAI,gBAAgB,eAClB,eAAcA,QAAM;OAEpB,UAASA,QAAM;AAGjB,cAAW,OAAO,GAAG,SAAS;;EAEhC,OAAO,GAAG,MAAa;AACrB,OAAI,eAAe,QAAW;AAC5B,aAAS,WAAW;AACpB,kBAAc,OAAU;;AAG1B,YAAS,GAAG,KAAK;;EAEpB;AAED,KAAI,OACF,QACE,mFACG,OAAO,OAAO;EAAE,GAAG,KAAK,SAAS,KAAY;EAAE;EAAyB,EAAS,KAAK,IACrF,OACD;AAIP,KAAI,UACF,iCAAqB,WAAW;EAAE,GAAG;EAAW,GAAG;EAAO,CAAC;AAG7D,QAAO;;;;;ACnNT,SAAgB,YAEd,EAAE,MAAM,eAAe,YACJ;CACnB,MAAM,OAAO,KAAK,SAAS;CAE3B,MAAM,QAAQ,KAAK,mBAAmB;AAEpC,SADc,KAAK,SAAS,KAAY,CAC3B;GACb;CAEF,MAAM,8BACH,GAAG,SAAgB;AAElB,EADc,KAAK,SAAS,KAAY,CAClC,IAAI,GAAG,KAAK;IAEpB,CAAC,MAAM,KAAK,CACb;CAED,MAAM,iCACH,QAAa;AAEZ,EADc,KAAK,SAAS,KAAY,CAClC,OAAO,IAAI;IAEnB,CAAC,MAAM,KAAK,CACb;CAED,MAAM,mCACH,UAA0F;AAEzF,EADc,KAAK,SAAS,KAAY,CAClC,SAAS,MAAM;IAEvB,CAAC,MAAM,KAAK,CACb;AAED,QACE,qFACG,iBACC,MAAM,KAAK,QAAM,UAAU;EACzB,MAAM,MAAMG,OAAK,MAAM,IAAI,CAAC,KAAK;AAEjC,SACE,2CAACC,4BACE,cAAc;GACb;GACA;GACA;GACA,cAAc,OAAO,IAAI;GAC1B,CAAC,IANW,IAOJ;GAEb,EAEH,WAAW;EACV;EACA;EACA;EACA;EACD,CAAQ,IACR;;;;;ACpEP,SAAgB,gBACd,MACM;CACN,MAAM,eAAeC,2BAAa,KAAK,QAAQ,UAAU,YAAY,IAAM;CAC3E,MAAM,YAAYC,kCAAa,KAAK;CACpC,MAAM,8BAAuC,OAAU;CACvD,MAAM,6BAAkBC,qBAAO,EAAE,EAAE,CAAC;CAEpC,MAAM,+BAEFC,uBAAS,YAAY;EACnB,MAAM,OAAO,UAAU,QAAQ,QAAQ,UAAU;EACjD,MAAM,QAAQ,UAAU,QAAQ,UAAU;AAE1C,YAAU,UAAU;AAEpB,IAAE,OAAO;AAET,IAAE,YAAY;AACZ,OAAI;AACF,cAAU,QAAQ,UAAU,IAAI,kBAAkB,KAAK;AACvD,UAAM,OAAO,OAAO,UAAU,QAAQ;AAEtC,QAAI,EAAE,SAAS,KAAK,UAAU,QAAQ,QAAQ,UAAU,eACtD,WAAU,QAAQ,OAAO;aAEnB;AACR,cAAU,QAAQ,UAAU,IAAI,kBAAkB,MAAM;AAExD,QAAI,EAAE,SAAS,EACb,WAAU,QAAQ,UAAU,IAAI,iBAAiB,MAAM;;IAG3D;IACD,aAAa,EAClB;EAAC;EAAW;EAAc;EAAE,CAC7B;AAED,4BAAgB;AACd,MAAI,CAAC,UAAU,QAAQ,QAAQ,UAAU,KACvC;AAGF,SAAO,UAAU,QAAQ,UACtB,KAAK,UAAU,MAAM,MAAM,CAC3B,gBACO;AACJ,OAAIC,6BAAU,UAAU,QAAQ,UAAU,EAAE,UAAU,QAAQ,CAC5D;AAGF,QAAK;AACL,aAAU,QAAQ,UAAU,IAAI,iBAAiB,KAAK;KAExD,EAAE,QAAQ,OAAO,CAClB;IACF,CAAC,WAAW,IAAI,CAAC;;;;;AC8DtB,SAAS,cAAc,EACrB,KACA,GAAG,aAOsD;CACzD,MAAM,eAAe,KAAK,SAAS;CACnC,MAAM,0BAA0B,KAAK,cAAc,UAAU,MAAM,wBAAwB;CAC3F,MAAM,YAAY,KAAK,cAAc,UAAU,2BAA2B,MAAM,OAAO,OAAO,EAAE;CAEhG,MAAM,4BAAkC,KAAK;CAE7C,MAAM,iBAAiBC,wCACpB,QAA+B,kBAAsC;EACpE,MAAM,cAAc,QAAQ;AAC5B,MAAI,CAAC,YACH;EAGF,MAAM,kBAAkB,IAAI,IAC1B,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC,KACnB,CAAC,OAAOC,cACP,CACE,OACAA,SAAO,KAAK,UAAU,aAAa,QAAQ,gBAAgB,OAAO,MAAM,IAAI,MAAM,CACnF,CACJ,CACF;AAED,OAAK,MAAM,WAAW,MAAM,KAAK,YAAY,SAAS,CACpD,KAAI,UAAU,WAAW,uBAAuB,QAC9C,CAAC,QAA8B,kBAC7B,gBAAgB,IAAK,QAA8B,KAAK,EAAE,KAAK,KAAK,IAAI,GACzE;AAIL,MAAI,iBAAiB,uBAAuB,eAAe;GACzD,MAAM,cAAc,CAAC,GAAG,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK;AAE1D,iBAAc,kBAAkB,YAAY;;GAGjD;AAED,4BAAgB;AACd,MAAI,CAAC,aAAa,QAAQ,eACxB;AAGF,SAAO,aAAa,UACjB,UAAU,aAAa,WAAW,CAAC,CACnC,WAAW,WAAW,eAAe,OAAO,CAAC;IAC/C,CAAC,cAAc,eAAe,CAAC;AAElC,QACE,2CAAC;EACC,KAAK;EACL;EACA,GAAI;EACJ,WAAW,CACT,UAAU,WACV,0BAA2B,aAAa,QAAQ,kBAAkB,cAAe,OAClF,CACE,OAAO,QAAQ,CACf,KAAK,IAAI;EACZ,kBAAgB,2BAA2B;EAC3C,cAAY,YAAY,UAAU,0BAA0B,SAAS;EACrE,UAAU,OAAO,UAAU;AACzB,OAAI,aAAa,gBAAgB,CAC/B;AAGF,OAAI;AACF,iBAAa,UAAU,IAAI,kBAAkB,KAAK;AAClD,UAAM,gBAAgB;AAEtB,QAAI,aAAa,QAAQ,gBAAgB;KACvC,MAAM,cAAc,MAAM;KAC1B,MAAM,gBACJ,MAAM,uBAAuB,eAC7B,MAAM,YAAY,qBAAqB,oBACnC,MAAM,YAAY,YAClB;AAEN,oBAAe,aAAa,WAAW,EAAE,cAAc;AACvD,iBAAY,gBAAgB;;AAI9B,QADgB,aAAa,UAAU,CAErC,OAAM,UAAU,WAAW,OAAO;KAChC,GAAG;KACH,GAAG,gBAAgB,aAAa;KACjC,CAAC;aAEI;AACR,iBAAa,UAAU,IAAI,kBAAkB,MAAM;;;GAGvD;;AAIN,SAAS,SACP,MACA,MACiC;AAqFjC,QApFc;EACZ,IAAI,gBAAgB;AAClB,UAAO,KAAK,aAAa,SAAYC,uBAAI,KAAK,UAAiB,KAAY,GAAG;;EAGhF,IAAI,QAAQ;AAEV,UAAOA,uBADO,KAAK,UAAU,IACT,KAAK,YAAY,KAAK,QAAQ,cAAc,KAAY;;EAG9E,SAAS,QAAsC;AAC7C,QAAK,UAAU,IAAI,UAAU,QAAQ,KAAK,YAAY,KAAK,QAAQ,iBAAiB;AAClF,QAAI,kBAAkB,SACpB,UAAS,OAAOA,uBAAI,OAAO,KAAY,CAAyB;AAGlE,WAAOC,uBAAI,OAAO,MAAa,OAAc;KAC7C;;EAGJ,IAAI,YAAY;AACd,UAAO,CAACC,6BAAU,KAAK,eAAe,KAAK,OAAO,EAAE,uBAAuB,MAAM,CAAC;;EAGpF,IAAI,SAAS;AAEX,UADe,KAAK,WAAW,CACjB,IAAI,KAAK,IAAI,EAAE;;EAG/B,IAAI,QAAa;GACf,MAAM,EAAE,UAAU;AAElB,OAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,KAAK,GAAG,UAAUC,wBAAK,MAAM,OAAO,MAAM,CAAC,CAAC;AAG3D,OAAIC,4BAAS,MAAM,CACjB,QAAO,OAAO,KAAK,MAAM,CAAC,KAAK,QAAQD,wBAAK,MAAM,IAAI,CAAC;AAGzD,UAAO,EAAE;;EAGX,IAAI,GAAG,MAAa;AAClB,QAAK,UAAU,UAAe;AAC5B,QAAI,CAAC,MACH,OAAM,IAAI,MAAM,yBAAyB,KAAK,UAAU,MAAM,GAAG;AAGnE,QAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,CAAC,GAAI,SAAS,EAAE,EAAG,KAAK,GAAG;AAGpC,QAAIC,4BAAS,MAAM,CACjB,QAAO;KACL,GAAG;MACF,KAAK,KAAK,KAAK;KACjB;AAGH,UAAM,IAAI,MAAM,yBAAyB,KAAK,UAAU,MAAM,GAAG;KACjE;;EAGJ,OAAO,KAAsB;AAC3B,QAAK,UAAU,UAAe;AAC5B,QAAI,CAAC,MACH,OAAM,IAAI,MAAM,8BAA8B,KAAK,UAAU,MAAM,GAAG;AAGxE,QAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,QAAQ,GAAG,UAAU,UAAU,OAAO,IAAI,CAAC;AAG1D,QAAIA,4BAAS,MAAM,EAAE;KACnB,MAAM,GAAG,MAAM,EAAG,GAAG,SAAS;AAC9B,YAAO;;AAGT,UAAM,IAAI,MAAM,8BAA8B,KAAK,UAAU,MAAM,GAAG;KACtE;;EAEL;;AAKH,SAAS,UACP,OACA,UACA,aACA;CACA,MAAM,yBAAS,IAAI,KAAuB;AAE1C,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,eAAe,EAAE,CAAC,CAC3D,MAAK,MAAM,CAAC,gBAAgB,aAAa,OAAO,QAC9C,MACD,EAAE;EACD,IAAI,UAAU;AAEd,OAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,mBAAmB,OAAO,KAAK,CAAC,EAAE;AAC5E,aAAU;AACV,OAAI,CAAC,SAAS,OAAO;IAAE;IAAO;IAAU;IAAO,CAAC,EAAE;IAChD,MAAM,cAAc,OAAO,IAAI,MAAM,IAAI,EAAE;AAC3C,gBAAY,KAAK,eAAe;AAChC,WAAO,IAAI,OAAO,YAAY;;;AAIlC,MAAI,CAAC,WAAW,CAAC,KAAK,SAAS,IAAI,EACjC;OAAI,CAAC,SAAS,QAAW;IAAE;IAAO;IAAU,OAAO;IAAM,CAAC,EAAE;IAC1D,MAAM,cAAc,OAAO,IAAI,KAAK,IAAI,EAAE;AAC1C,gBAAY,KAAK,eAAe;AAChC,WAAO,IAAI,MAAM,YAAY;;;;AAMrC,QAAO;;AAGT,SAAgB,gBACd,UAC0B;AAC1B,QAAO;EACL,OAAO,SAAS,UAAU;EAC1B,yBAAyB,SAAS,yBAAyB;EAC3D,eAAe,SAAS,eAAe;EACvC,gBAAgB,SAAS,gBAAgB;EACzC,YAAY,SAAS,YAAY;EACjC,QAAQ,SAAS,WAAW;EAC5B,SAAS,SAAS,SAAS;EAC5B;;AAGH,IAAa,OAAb,MAAa,KAAgD;CAM3D,YAAY,AAAgBC,SAAyC;EAAzC;0CAFlB,KAAK;AAGb,yBAAS,KAAK;;CAGhB,UAA0C;EACxC,MAAM,gCAAqB,KAAK,QAAQ;AAExC,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,yBAAyB;AAG3C,SAAO;;CAGT,aACE,UACA,iBACG;EACH,MAAM,OAAO,KAAK,SAAS;AAE3B,SAAOC,8BACL,KAAK,iBAEH,SAAS;GACP,GAAG;GACH,GAAG,gBAAgB,KAAK;GACzB,CAAC,EAEJ,gBACD;;CAGH,SACE,MACA,iBACiC;EACjC,MAAM,OAAO,KAAK,SAAS;AAC3B,OAAK,cAAc,WAAS,CAACC,OAAK,SAAS,KAAK,CAAC,OAAOA,OAAK,SAAS,EAAE,gBAAgB;AACxF,SAAO,KAAK,SAAS,KAAK;;CAO5B,KAAK,EACH,cACA,aACA,eACA,UACA,WACA,gBACA,UACA,UACA,eACA,GAAG,aAE4F;EAC/F,MAAMF,UAA0C;GAC9C,cAAc;IAAE,GAAG,KAAK,QAAQ;IAAc,GAAG;IAAc;GAC/D,aAAa;IAAE,GAAG,KAAK,QAAQ;IAAa,GAAG;IAAa;GAI5D,eAAe,iBAAiB,KAAK,QAAQ;GAC7C,UAAU,YAAY,KAAK,QAAQ;GACnC,WAAW,aAAa,KAAK,QAAQ;GACrC,gBAAgB,kBAAkB,KAAK,QAAQ;GAC/C,UAAU,YAAY,KAAK,QAAQ;GACnC,UAAU,YAAY,KAAK,QAAQ;GACnC,gBAAgB,kBAAkB,KAAK,QAAQ,kBAAkB;GAClE;EAED,MAAM,qCAA0B;AAC9B,UAAOG,0BAA+B;IACpC,OAAO;IACP,yBAAyB;IACzB,eAAe;IACf,gBAAgB;IACjB,CAAC;KACD,EAAE,CAAC;EAEN,IAAIC;EACJ,MAAM,wBAAQ,IAAI,KAAsB;EACxC,SAAS,KAAQ,KAAa,IAAgB;AAC5C,OAAI,cAAc,UAAU,KAAK,CAAC,OAAO;AACvC,UAAM,OAAO;AACb,gBAAY,UAAU,KAAK,CAAC;;GAG9B,IAAI,QAAQ,MAAM,IAAI,IAAI;AAC1B,OAAI,CAAC,MAAM,IAAI,IAAI,EAAE;AACnB,YAAQ,IAAI;AACZ,UAAM,IAAI,KAAK,MAAM;;AAGvB,UAAO;;EAGT,MAAMC,UAA0C;GAC9C;GACA;GACA,UAAU,QAAQ;GAElB,WAAW;AACT,UAAM,IAAI,MAAM,kBAAkB;;GAGpC,WAAW;AACT,WAAO,UAAU,KAAK,CAAC,SAAS,QAAQ,YAAY,QAAQ;;GAG9D,0BAA0B;AACxB,WAAO,UAAU,KAAK,CAAC;;GAGzB,gBAAgB;AACd,WAAO,UAAU,KAAK,CAAC;;GAGzB,iBAAiB;AACf,WAAO,UAAU,KAAK,CAAC;;GAGzB,aAAa;AACX,WAAO,KACL,oBAEE,CAACR,6BAAU,KAAK,UAAU,EAAE,QAAQ,YAAY,QAAQ,cAAc,EACpE,uBAAuB,MACxB,CAAC,CACL;;GAGH,YAAY;AACV,WAAO,KAAK,mBACV,UAAU,KAAK,UAAU,EAAE,QAAQ,UAAU,QAAQ,YAAY,CAClE;;GAGH,UAAU;AACR,WAAO,KAAK,iBAAiB,KAAK,WAAW,CAAC,SAAS,EAAE;;GAG3D,WAAW;AACT,cAAU,IAAI,2BAA2B,KAAK;AAC9C,WAAO,KAAK,SAAS;;GAGvB,QAAQ;AACN,cAAU,IAAI,SAAS,OAAU;AACjC,cAAU,IAAI,2BAA2B,MAAM;;GAElD;AAED,UAAQ,YAAY,SAAS,KAAK,YAAY,SAAS,SAAS,KAAK,CAAC;AAEtE,6BAAgB;GACd,MAAMS,cAAY,QAAQ;AAC1B,OAAI,CAACA,YACH;GAGF,MAAM,QAAQ,UAAU,KACrB,UAAU,MAAM,SAAS,QAAQ,YAAY,QAAQ,eACrD,WAAW,WAAW;IAAE,GAAG;IAAO;IAAO,EAC3C;AAED,UAAO,MAAM,WAAW,UAAU;IAChC,MAAM,SAASA,YAAU,OAAO,MAAM;AAEtC,QAAI,WAAW,UAAa,CAACT,6BAAU,QAAQ,MAAM,CACnD,OAAM,IAAI,OAAO;KAEnB;KACD;GAAC,QAAQ;GAAc,QAAQ;GAAU,QAAQ;GAAW;GAAU,CAAC;AAE1E,kBAAgB,QAAQ;AAExB,SACE,2CAAC,KAAK,QAAQ;GAAS,OAAO;aAC5B,2CAAC;IAAc,GAAI;IAAW,MAAM;KAAQ;IACtB;;CAI5B,UAAa,EACX,UACA,YAIoB;AAEpB,SAAO,mFAAG,SADY,KAAK,aAAa,SAAS,CAChB,GAAI;;CAWvC,MAAM,OAA+B;AACnC,SAAO,QAAQ,MAAM,WAAW,MAAM,CAAC;GAAE,WAAW;GAAS,GAAG;GAAO,CAAC,CAAC;;CAG3E,QAAoC,OAA2D;AAC7F,SAAO,QAAQ,MAAM,aAAa,MAAM,CAAC,MAAM,CAAC;;CAGlD,SACE,WACA,WAC2B;EAC3B,MAAM,EAAE,iBAAS;AACjB,SAAO,SAAS,YAAY,OAAe;AACzC,UACE,2CAACU;IAAK,GAAI;cACR,2CAAC,aAAU,GAAI,QAAS;KACnB;;;;AAMf,SAAgB,WACd,SACyB;AACzB,QAAO,IAAI,KAAK,QAAQ;;;;;AC3mB1B,SAAgB,UAAa,OAAqB;AAChD,QAAO,MAAM,QAAQ,MAAM,GAAG,QAAQ,CAAC,MAAM;;;;;ACC/C,SAAgB,oBAAuB,OAAkB;AACvD,KAAI,UAAU,OACZ;AAGF,KAAI;AACF,SAAOC,4CAAuB,MAAM;SAC9B;AACN;;;AAIJ,SAAgB,kBAAqB,OAAkB;AACrD,QAAOC,0CAAqB,MAAM;;AAGpC,SAAgB,cAAiB,MAA8B;AAC7D,KAAI,OAAO,SAAS,SAClB,QAAO,KAAK,QAAQ,QAAQ,GAAG,CAAC,QAAQ,QAAQ,GAAG;AAErD,QAAO;;;;;ACET,SAAgB,iBAAoB,EAClC,KACA,OAAO,QACP,YAAY,mBACZ,cAAc,qBACd,eAAe,QACf,oBAAoB,OACpB,iBAAiB,QACjB,UAAU,MACV,OAAO,QACgE;AACvE,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,MAAM,SAAS,OAAO,OAAO,UAAU,KAAK,CAAC,IAAI,cAAc;EAChE;;;;;AChCH,MAAaC,WAA0BC,gCAAkB,OAAO,SAAS,MAAM;CAC7E,YAAY;CACZ,SAAS;EACP,MAAM,eAAe;AACnB,OAAI,OAAO,SAAS,SAAS,KAAK,iBAAiB,MACjD,MAAK,YAAY;;EAIrB,MAAM,WAAW,YAAY,QAAQ,EAAE;AACvC,SAAO,iBAAiB,YAAY,OAAO;AAE3C,eAAa;AACX,iBAAc,SAAS;AACvB,UAAO,oBAAoB,YAAY,OAAO;;;CAGnD,CAAC;AAEF,IAAa,gBAAb,MAAa,sBAAyBC,oBAAS;CAM7C,YAAY,AAAgBC,YAAqC;AAC/D,cAAY,KAAK,MAAM,EAAE,EAAE,YAAY,OAAO,CAAC;EADrB;AAE1B,yBAAS,cAAc;AAEvB,OAAK,aACH,WAAW,WAAW,mBAAmB,WAAW,QAAQ,GAAG,GAAG,WAAW;AAC/E,OAAK,UAAU,KAAK,MAAM;;CAG5B,AAAQ,QAAQ;EACd,IAAI,WAAW;EACf,IAAI,WAAW,KAAK,aAAa;EACjC,IAAI,eAAe,KAAK,iBAAiB;EAEzC,MAAM,eAAe;GACnB,MAAM,cAAc;AACpB,cAAW,KAAK,cAAc;GAC9B,MAAM,cAAc;AACpB,cAAW,KAAK,aAAa;GAC7B,MAAM,kBAAkB;AACxB,kBAAe,KAAK,iBAAiB;AAGrC,OAAI,CAAC,SACH;AAIF,OACE,aAAa,eACb,aAAa,eACb,iBAAiB,gBAEjB;AAGF,OAAI,CAAC,aAIH;QAAI,aAAa,KACf,MAAK,cAAc,KAAK,WAAW,YAAY,SAAS,CAAC;aAChD,iBAAiB,KAC1B,MAAK,UAAU,KAAK,WAAW,YAAY,aAAa,CAAC;aAChD,KAAK,WAAW,kBACzB,MAAK,UAAU,KAAK,WAAW,aAAa;cAErC,aAAa,aAAa;AAInC,QAAI,aAAa,QAAQ,KAAK,WAAW,kBACvC,MAAK,UAAU,KAAK,WAAW,aAAa;AAG9C,SAAK,cACH,aAAa,OAAO,KAAK,WAAW,YAAY,SAAS,GAAG,KAAK,WAAW,aAC7E;;AAGH,QAAK,YAAY;;EAGnB,MAAM,SAAS,SAAS,UAAU,OAAO;AACzC,SAAO,iBAAiB,WAAW,OAAO;AAE1C,eAAa;AACX,WAAQ;AACR,UAAO,oBAAoB,WAAW,OAAO;;;CAIjD,AAAQ,cAAc;EACpB,MAAM,OAAO,SAAS,KAAK;EAC3B,MAAM,MAAM,IAAI,IAAI,KAAK;AAEzB,SADe,IAAI,gBAAgB,IAAI,KAAK,WAAW,MAAM,MAAM,EAAE,IAAI,GAAG,CAC9D,IAAI,KAAK,WAAW,IAAI;;CAGxC,AAAQ,kBAAkB;AACxB,SAAO,KAAK,eAAe,OAAO,aAAa,QAAQ,KAAK,WAAW,GAAG;;CAG5E,AAAQ,eAAe;AACrB,MAAI,KAAK,WAAW,SAAS,KAC3B,QAAO;EAGT,MAAM,OAAO,cAAc,OAAO,SAAS,SAAS;AAEpD,SAAO,UAAU,KAAK,WAAW,KAAK,CAAC,MAAM,MAAM;AACjD,OAAI,OAAO,MAAM,SACf,QAAO,CAAC,KAAK,MAAM,QAAQ,KAAK,WAAW,IAAI,IAAI;AAGrD,UAAO,EAAE,KAAK,KAAK;IACnB;;CAGJ,AAAQ,OAAO;EACb,IAAI,OAAO,OAAO,SAAS;EAC3B,MAAM,eAAe,KAAK,eAAe,OAAO,aAAa,QAAQ,KAAK,WAAW,GAAG;AAExF,MAAI,CAAC,KAAK,cAAc,IAAI,KAAK,aAAa,OAC5C,QAAO,KAAK;AAGd,MAAI,KAAK,aAAa,QAAQ,KAAK,qBAAqB,aACtD,QAAO,KAAK;EAGd,MAAM,MAAM,IAAI,IAAI,KAAK;EAEzB,MAAM,WADS,IAAI,gBAAgB,IAAI,KAAK,WAAW,MAAM,MAAM,EAAE,CAAC,CAC9C,IAAI,KAAK,WAAW,IAAI;EAEhD,MAAM,QACJ,aAAa,OACT,KAAK,WAAW,YAAY,SAAS,GACrC,KAAK,eAAe,QAAQ,iBAAiB,OAC3C,KAAK,WAAW,YAAY,aAAa,GACzC,KAAK,WAAW;AAExB,OAAK,WAAW;AAChB,OAAK,mBAAmB;AACxB,OAAK,YAAY;AACjB,SAAO;;CAGT,AAAQ,UAAU,OAAU;EAC1B,MAAM,kBAAkB,KAAK,WAAW,UAAU,MAAM;EAExD,MAAM,MAAM,IAAI,IAAI,OAAO,SAAS,KAAK;EACzC,MAAM,SAAS,IAAI,gBAAgB,IAAI,KAAK,WAAW,MAAM,MAAM,EAAE,CAAC;AAEtE,MACE,CAAC,KAAK,WAAW,qBACjB,oBAAoB,KAAK,WAAW,UAAU,KAAK,WAAW,aAAa,CAE3E,QAAO,OAAO,KAAK,WAAW,IAAI;MAElC,QAAO,IAAI,KAAK,WAAW,KAAK,gBAAgB;AAGlD,MAAI,KAAK,WAAW,QAAQ,OAAO,UAAU;AAC7C,SAAO,QAAQ,aAAa,OAAO,QAAQ,OAAO,IAAI,IAAI,UAAU,CAAC;AACrE,SAAO,cAAc,IAAI,cAAc,WAAW,CAAC;;CAGrD,AAAQ,cAAc,OAAU;AAC9B,MAAI,KAAK,eAAe,KACtB;EAGF,MAAM,kBAAkB,KAAK,WAAW,UAAU,MAAM;AACxD,eAAa,QAAQ,KAAK,YAAY,gBAAgB;;CAKxD,IAAI,GAAG,MAAmB;EACxB,MAAMC,OAAY,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;EAChD,IAAIC,SAAsB,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK;AAE3D,MAAI,kBAAkB,UAAU;GAC9B,MAAM,SAAS,KAAK,KAAK;GACzB,MAAM,cAAcC,uBAAI,QAAQ,KAAK;AAErC,YAASC,uBAAI,QAAQ,MADF,OAAO,YAAY,CACA;aAC7B,KAAK,SAAS,EACvB,UAASA,uBAAI,KAAK,KAAK,EAAE,MAAM,OAAO;AAGxC,MAAI,KAAK,cAAc,CACrB,MAAK,UAAU,OAAO;MAEtB,MAAK,cAAc,OAAO;;CAI9B,MAAM,MAAiB;EACrB,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO,SAAS,KAAK;EAE/C,MAAM,WADS,IAAI,gBAAgB,IAAI,KAAK,WAAW,MAAM,MAAM,EAAE,IAAI,GAAG,CACpD,IAAI,KAAK,WAAW,IAAI;AAChD,SAAO,aAAa,OAAO,KAAK,WAAW,YAAY,SAAS,GAAG,KAAK,WAAW;;;AAQvF,SAAgB,eAAkB,SAAuC;AACvE,QAAO,IAAI,cAAc,iBAAiB,QAAQ,CAAC;;;;;ACzNrD,SAAgB,kBACd,OACA,UACA,UAAuC,EAAE,EACC;CAC1C,MAAM,CAAC,OAAO,iCAAgC;CAC9C,MAAM,iBAAiBC,uCAAkB,SAAS;CAClD,MAAM,iBAAiBA,uCAAkB,QAAQ,mBAAmB,IAAI;CAExE,MAAM,kBAAkBC,mCAAc,QAAQ,SAAS;CACvD,MAAM,kBAAkBA,mCAAc,QAAQ,SAAS;CAEvD,MAAM,kCAAuB;EAC3B,MAAMC,YAAU,YAAa;AAC3B,kBAAeC,QAAM;AACrB,YAAS,OAAU;AACnB,kBAAeA,QAAM;;EAGvB,IAAIC;AAEJ,MAAI,gBACF,iBAAgBC,uBAASH,UAAQ,gBAAgB;WACxC,gBACT,iBAAgBI,uBAASJ,UAAQ,gBAAgB;MAEjD,kBAAiB,6CAAgCA,SAAOC,QAAM,CAAC;AAGjE,UAAQ,YAAa;AACnB,YAAS,EAAE,GAAGA,SAAO,CAAC;AACtB,iBAAcA,QAAM;;IAErB;EAAC;EAAgB;EAAgB;EAAiB;EAAgB,CAAC;AAEtE,QAAO,CAAC,QAAQ,MAAM,IAAI,OAAO,OAAO"}
@@ -112,6 +112,9 @@ interface FormOptions<TDraft, TOriginal> {
112
112
  autoSave?: FormAutosaveOptions<TDraft, TOriginal>;
113
113
  transform?: Transform<TDraft>;
114
114
  validatedClass?: string;
115
+ original?: TOriginal;
116
+ onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;
117
+ reportValidity?: boolean;
115
118
  }
116
119
  type Validations<TDraft, TOriginal> = { [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>> } & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;
117
120
  type Validation<TDraft, TOriginal, TPath$1> = (value: WildcardValue<TDraft, TPath$1>, context: {
@@ -171,18 +174,17 @@ declare class Form<TDraft, TOriginal extends TDraft = TDraft> {
171
174
  useFormState<S>(selector: (state: FormInstance<TDraft, TOriginal>) => S, useStoreOptions?: UseStoreOptions<S>): S;
172
175
  useField<TPath$1 extends string>(path: TPath$1, useStoreOptions?: UseStoreOptions<any>): Field<TDraft, TOriginal, TPath$1>;
173
176
  Form({
174
- original,
175
177
  defaultValue,
176
178
  validations,
177
179
  localizeError,
178
180
  autoSave,
179
181
  transform,
180
182
  validatedClass,
183
+ original,
184
+ onSubmit,
185
+ reportValidity,
181
186
  ...formProps
182
- }: {
183
- original?: TOriginal;
184
- onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;
185
- } & Partial<FormOptions<TDraft, TOriginal>> & Omit<HTMLProps<HTMLFormElement>, "defaultValue" | "autoSave" | "onSubmit">): React.JSX.Element;
187
+ }: Partial<FormOptions<TDraft, TOriginal>> & Omit<HTMLProps<HTMLFormElement>, "defaultValue" | "autoSave" | "onSubmit">): React.JSX.Element;
186
188
  FormState<S>({
187
189
  selector,
188
190
  children
@@ -112,6 +112,9 @@ interface FormOptions<TDraft, TOriginal> {
112
112
  autoSave?: FormAutosaveOptions<TDraft, TOriginal>;
113
113
  transform?: Transform<TDraft>;
114
114
  validatedClass?: string;
115
+ original?: TOriginal;
116
+ onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;
117
+ reportValidity?: boolean;
115
118
  }
116
119
  type Validations<TDraft, TOriginal> = { [TPath in WildcardPathAsString<TDraft>]?: Record<string, Validation<TDraft, TOriginal, TPath>> } & Record<string, Record<string, Validation<TDraft, TOriginal, any>>>;
117
120
  type Validation<TDraft, TOriginal, TPath$1> = (value: WildcardValue<TDraft, TPath$1>, context: {
@@ -171,18 +174,17 @@ declare class Form<TDraft, TOriginal extends TDraft = TDraft> {
171
174
  useFormState<S>(selector: (state: FormInstance<TDraft, TOriginal>) => S, useStoreOptions?: UseStoreOptions<S>): S;
172
175
  useField<TPath$1 extends string>(path: TPath$1, useStoreOptions?: UseStoreOptions<any>): Field<TDraft, TOriginal, TPath$1>;
173
176
  Form({
174
- original,
175
177
  defaultValue,
176
178
  validations,
177
179
  localizeError,
178
180
  autoSave,
179
181
  transform,
180
182
  validatedClass,
183
+ original,
184
+ onSubmit,
185
+ reportValidity,
181
186
  ...formProps
182
- }: {
183
- original?: TOriginal;
184
- onSubmit?: (event: FormEvent<HTMLFormElement>, form: FormInstance<TDraft, TOriginal>) => void;
185
- } & Partial<FormOptions<TDraft, TOriginal>> & Omit<HTMLProps<HTMLFormElement>, "defaultValue" | "autoSave" | "onSubmit">): React.JSX.Element;
187
+ }: Partial<FormOptions<TDraft, TOriginal>> & Omit<HTMLProps<HTMLFormElement>, "defaultValue" | "autoSave" | "onSubmit">): React.JSX.Element;
186
188
  FormState<S>({
187
189
  selector,
188
190
  children
@@ -2,7 +2,7 @@ import { c as debounce, d as queue, h as autobind, m as calcDuration, n as creat
2
2
  import { a as set, c as deepEqual, n as get, o as isObject, r as join, t as castArrayPath } from "../propAccess-DvWFpYoj.js";
3
3
  import { i as toExtendedJsonString, n as fromExtendedJsonString } from "../extendedJson-Dv9q6rps.js";
4
4
  import "../path-CyYq74W8.js";
5
- import { a as useProp, c as cacheMethods, d as useLoadingBoundary, f as useStore, i as useScope, l as useCache, n as scopeMethods, o as useLatestFunction, p as useMemoEquals, r as ScopeProvider, s as useLatestRef, t as storeMethods, u as LoadingBoundary } from "../storeMethods-Dt0Cxsn3.js";
5
+ import { a as useProp, c as cacheMethods, d as useLoadingBoundary, f as useStore, i as useScope, l as useCache, n as scopeMethods, o as useLatestFunction, p as useMemoEquals, r as ScopeProvider, s as useLatestRef, t as storeMethods, u as LoadingBoundary } from "../storeMethods-BBq6PMbA.js";
6
6
  import { Fragment, createContext, createElement, startTransition, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
7
7
  import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
8
8
 
@@ -179,6 +179,7 @@ function useFormAutosave(form) {
179
179
  function FormContainer({ form,...formProps }) {
180
180
  const formInstance = form.useForm();
181
181
  const hasTriggeredValidations = form.useFormState((state) => state.hasTriggeredValidations);
182
+ const hasErrors = form.useFormState((state) => hasTriggeredValidations && state.errors.size > 0);
182
183
  const formRef = useRef(null);
183
184
  const updateValidity = useLatestFunction((errors, buttonElement) => {
184
185
  const formElement = formRef.current;
@@ -191,6 +192,7 @@ function FormContainer({ form,...formProps }) {
191
192
  }
192
193
  });
193
194
  useEffect(() => {
195
+ if (!formInstance.options.reportValidity) return;
194
196
  return formInstance.formState.map(() => formInstance.getErrors()).subscribe((errors) => updateValidity(errors));
195
197
  }, [formInstance, updateValidity]);
196
198
  return /* @__PURE__ */ jsx("form", {
@@ -198,15 +200,19 @@ function FormContainer({ form,...formProps }) {
198
200
  noValidate: true,
199
201
  ...formProps,
200
202
  className: [formProps.className, hasTriggeredValidations ? formInstance.options.validatedClass ?? "validated" : void 0].filter(Boolean).join(" "),
203
+ "data-validated": hasTriggeredValidations || void 0,
204
+ "data-valid": hasErrors ? "false" : hasTriggeredValidations ? "true" : void 0,
201
205
  onSubmit: async (event) => {
202
206
  if (formInstance.saveInProgress()) return;
203
207
  try {
204
208
  formInstance.formState.set("saveInProgress", true);
205
209
  event.preventDefault();
206
- const formElement = event.currentTarget;
207
- const buttonElement = event.nativeEvent instanceof SubmitEvent && event.nativeEvent.submitter instanceof HTMLButtonElement ? event.nativeEvent.submitter : void 0;
208
- updateValidity(formInstance.getErrors(), buttonElement);
209
- formElement.reportValidity();
210
+ if (formInstance.options.reportValidity) {
211
+ const formElement = event.currentTarget;
212
+ const buttonElement = event.nativeEvent instanceof SubmitEvent && event.nativeEvent.submitter instanceof HTMLButtonElement ? event.nativeEvent.submitter : void 0;
213
+ updateValidity(formInstance.getErrors(), buttonElement);
214
+ formElement.reportValidity();
215
+ }
210
216
  if (formInstance.validate()) await formProps.onSubmit?.(event, {
211
217
  ...formInstance,
212
218
  ...getDerivedState(formInstance)
@@ -331,7 +337,7 @@ var Form = class Form {
331
337
  this.useFormState((form$1) => [form$1.getField(path).value, form$1.original], useStoreOptions);
332
338
  return form.getField(path);
333
339
  }
334
- Form({ original, defaultValue, validations, localizeError, autoSave, transform, validatedClass,...formProps }) {
340
+ Form({ defaultValue, validations, localizeError, autoSave, transform, validatedClass, original, onSubmit, reportValidity,...formProps }) {
335
341
  const options = {
336
342
  defaultValue: {
337
343
  ...this.options.defaultValue,
@@ -344,7 +350,10 @@ var Form = class Form {
344
350
  localizeError: localizeError ?? this.options.localizeError,
345
351
  autoSave: autoSave ?? this.options.autoSave,
346
352
  transform: transform ?? this.options.transform,
347
- validatedClass: validatedClass ?? this.options.validatedClass
353
+ validatedClass: validatedClass ?? this.options.validatedClass,
354
+ original: original ?? this.options.original,
355
+ onSubmit: onSubmit ?? this.options.onSubmit,
356
+ reportValidity: reportValidity ?? this.options.reportValidity ?? true
348
357
  };
349
358
  const formState = useMemo(() => {
350
359
  return createStore({
@@ -371,12 +380,12 @@ var Form = class Form {
371
380
  const context = {
372
381
  formState,
373
382
  options,
374
- original,
383
+ original: options.original,
375
384
  getField() {
376
385
  throw new Error("Not implemented");
377
386
  },
378
387
  getDraft() {
379
- return formState.get().draft ?? original ?? options.defaultValue;
388
+ return formState.get().draft ?? options.original ?? options.defaultValue;
380
389
  },
381
390
  hasTriggeredValidations() {
382
391
  return formState.get().hasTriggeredValidations;
@@ -388,10 +397,10 @@ var Form = class Form {
388
397
  return formState.get().saveInProgress;
389
398
  },
390
399
  hasChanges() {
391
- return lazy("hasChanges", () => !deepEqual(this.getDraft(), original ?? options.defaultValue, { undefinedEqualsAbsent: true }));
400
+ return lazy("hasChanges", () => !deepEqual(this.getDraft(), options.original ?? options.defaultValue, { undefinedEqualsAbsent: true }));
392
401
  },
393
402
  getErrors() {
394
- return lazy("getErrors", () => getErrors(this.getDraft(), original, options.validations));
403
+ return lazy("getErrors", () => getErrors(this.getDraft(), options.original, options.validations));
395
404
  },
396
405
  isValid() {
397
406
  return lazy("isValid", () => this.getErrors().size === 0);
@@ -409,7 +418,7 @@ var Form = class Form {
409
418
  useEffect(() => {
410
419
  const transform$1 = options.transform;
411
420
  if (!transform$1) return;
412
- const store = formState.map((state) => state.draft ?? original ?? options.defaultValue, (draft) => (state) => ({
421
+ const store = formState.map((state) => state.draft ?? options.original ?? options.defaultValue, (draft) => (state) => ({
413
422
  ...state,
414
423
  draft
415
424
  }));
@@ -418,8 +427,8 @@ var Form = class Form {
418
427
  if (result !== void 0 && !deepEqual(result, value)) store.set(result);
419
428
  });
420
429
  }, [
421
- original,
422
430
  options.defaultValue,
431
+ options.original,
423
432
  options.transform,
424
433
  formState
425
434
  ]);