@xyo-network/react-form-group 7.5.8 → 7.5.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/browser/FormGroup.d.ts +2 -2
- package/dist/browser/FormGroup.d.ts.map +1 -1
- package/dist/browser/InputError.d.ts +2 -2
- package/dist/browser/InputError.d.ts.map +1 -1
- package/dist/browser/control/FormControl.d.ts +2 -2
- package/dist/browser/control/FormControl.d.ts.map +1 -1
- package/dist/browser/control/FormControlBase.d.ts.map +1 -1
- package/dist/browser/control/accessor/ControlValueAccessorBase.d.ts +4 -3
- package/dist/browser/control/accessor/ControlValueAccessorBase.d.ts.map +1 -1
- package/dist/browser/index.mjs +116 -152
- package/dist/browser/index.mjs.map +1 -1
- package/package.json +55 -31
- package/src/FormGroup.ts +0 -227
- package/src/InputError.ts +0 -4
- package/src/context/Context.ts +0 -5
- package/src/context/Provider.tsx +0 -36
- package/src/context/State.ts +0 -8
- package/src/context/index.ts +0 -4
- package/src/context/use.ts +0 -5
- package/src/control/AbstractControl.ts +0 -127
- package/src/control/FormControl.ts +0 -31
- package/src/control/FormControlBase.ts +0 -84
- package/src/control/accessor/ControlValueAccessor.ts +0 -23
- package/src/control/accessor/ControlValueAccessorBase.ts +0 -191
- package/src/control/accessor/FormControlStatus.ts +0 -36
- package/src/control/accessor/ValidControlValue.ts +0 -1
- package/src/control/accessor/index.ts +0 -4
- package/src/control/index.ts +0 -4
- package/src/index.ts +0 -5
- package/src/storage/ArchivistFormGroupStorage.ts +0 -25
- package/src/storage/FormGroupStorage.ts +0 -8
- package/src/storage/index.ts +0 -2
- package/src/stories/test.stories.tsx +0 -17
- package/src/types/images.d.ts +0 -5
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/context/Context.ts","../../src/context/Provider.tsx","../../src/FormGroup.ts","../../src/control/AbstractControl.ts","../../src/control/accessor/ControlValueAccessorBase.ts","../../src/control/accessor/FormControlStatus.ts","../../src/control/FormControlBase.ts","../../src/context/use.ts","../../src/storage/ArchivistFormGroupStorage.ts"],"sourcesContent":["import { createContextEx } from '@xylabs/react-shared'\n\nimport type { FormGroupContextWithPayloadState } from './State.ts'\n\nexport const FormGroupBaseContext = createContextEx<FormGroupContextWithPayloadState>()\n","import type { Payload } from '@xyo-network/payload-model'\nimport type { PropsWithChildren } from 'react'\nimport React, { useMemo } from 'react'\n\nimport type { FormGroupParams } from '../FormGroup.ts'\nimport { FormGroup } from '../FormGroup.ts'\nimport { FormGroupBaseContext } from './Context.ts'\nimport type { FormGroupContextWithPayloadState } from './State.ts'\n\nexport interface FormGroupPayloadProviderProps<TStorage extends Payload = Payload> extends PropsWithChildren {\n params?: FormGroupParams<TStorage>\n}\n\n/**\n * Provides a FormGroup to child components.\n */\nexport const FormGroupPayloadProvider = ({\n children, params, ...props\n}: FormGroupPayloadProviderProps) => {\n const formGroup = useMemo(() => {\n const formGroup = new FormGroup<Payload, Payload>(params)\n return formGroup\n }, [params])\n\n const value: FormGroupContextWithPayloadState = useMemo(() => ({ formGroup, provided: true }), [formGroup])\n\n return (\n\n <FormGroupBaseContext\n value={value}\n {...props}\n >\n {children}\n </FormGroupBaseContext>\n )\n}\n","import type { EventListener } from '@xylabs/events'\nimport { forget } from '@xylabs/sdk-js'\nimport type { Payload } from '@xyo-network/payload-model'\n\nimport type { ControlValueAccessorBaseEvents } from './control/index.ts'\nimport { AbstractControl } from './control/index.ts'\nimport type { ErrorSummary } from './InputError.ts'\nimport type { FormGroupStorage } from './storage/index.ts'\n\nexport type PayloadWithTimestamp = Payload<{ timestamp?: number }>\n\nexport type KeyOfString<T> = keyof T extends string ? keyof T : never\n\ntype FormGroupErrors<TValue> = Record<KeyOfString<TValue>, string>\n\nexport type FormGroupParams<TStorageValue extends Payload = Payload> = {\n serialize?: boolean\n storage?: {\n sensitive?: FormGroupStorage<TStorageValue>\n storage?: FormGroupStorage<TStorageValue>\n }\n ttlStorage?: number\n}\n\ntype ValueChangeEventListener = EventListener<ControlValueAccessorBaseEvents['valueChanged']>\n\n/**\n * Organize form controls in a group.\n *\n * NOTE: This is a work in progress and only supports top level controls. Nested controls are not supported.\n */\nexport class FormGroup<\n TValue extends PayloadWithTimestamp = PayloadWithTimestamp,\n TStorageValue extends PayloadWithTimestamp = PayloadWithTimestamp,\n> extends AbstractControl {\n private _controls = {} as Record<KeyOfString<TValue>, AbstractControl>\n\n private fgParams?: FormGroupParams<TStorageValue>\n\n private serializeListeners: Record<string, ValueChangeEventListener> = {}\n\n private serializedSensitiveState = {} as Record<KeyOfString<TStorageValue>, string>\n private serializedState = {} as Record<KeyOfString<TStorageValue>, string>\n\n constructor(fgParams?: FormGroupParams<TStorageValue>) {\n super()\n this.fgParams = fgParams\n }\n\n get errorSummary() {\n const errorSummary: ErrorSummary = {\n errorMessage: '',\n invalidFields: [],\n }\n for (const [key, value] of Object.entries(this.errors)) {\n if (value) {\n errorSummary.errorMessage = `${errorSummary.errorMessage}, ${value}`\n errorSummary.invalidFields.push(key)\n }\n }\n\n return errorSummary\n }\n\n get errors(): FormGroupErrors<TValue> {\n const value = {} as FormGroupErrors<TValue>\n for (const key in this._controls) {\n const castKey = key as KeyOfString<TValue>\n value[castKey] = this._controls[castKey].error\n }\n return value\n }\n\n get nonSensitiveStorage() {\n return this.fgParams?.storage?.storage\n }\n\n get sensitiveStorage() {\n return this.fgParams?.storage?.sensitive\n }\n\n override get touched() {\n return Object.values<AbstractControl>(this._controls).some(control => control.touched)\n }\n\n override get valid() {\n return Object.values<AbstractControl>(this._controls).every(control => control.valid)\n }\n\n get values(): TValue {\n const value = {} as TValue\n for (const key in this._controls) {\n const castKey = key as KeyOfString<TValue>\n value[castKey] = this._controls[castKey].rawValue as TValue[KeyOfString<TValue>]\n }\n return value\n }\n\n getControl(name: string) {\n return this._controls[name as KeyOfString<TValue>]\n }\n\n async getSerializedValue(name: string, sensitive = false): Promise<string | undefined> {\n const storage = sensitive ? this.sensitiveStorage : this.nonSensitiveStorage\n if (storage) {\n const savedState = await storage.get()\n if (savedState && name in savedState) {\n const savedValue = savedState[name as keyof typeof savedState] as string\n\n // casting to PayloadWithTimestamp to check for timestamp\n const savedStateWithTimestamp = savedState as unknown as PayloadWithTimestamp\n if (savedStateWithTimestamp.timestamp && this.fgParams?.ttlStorage) {\n const expirationDate = savedStateWithTimestamp.timestamp + (this.fgParams?.ttlStorage ?? 0)\n const now = Date.now()\n return now > expirationDate ? undefined : savedValue\n }\n return savedValue\n }\n } else {\n console.warn(`Cannot return value for ${name}. No storage set`)\n }\n }\n\n registerControl(name: string, control: AbstractControl) {\n if (this._controls[name as KeyOfString<TValue>]) console.error(`Replacing Control with name ${name} since it already exists!`)\n this._controls[name as KeyOfString<TValue>] = control\n this.serializeControlValue(name, control)\n }\n\n resetControls() {\n for (const key in this._controls) {\n this.unregisterControl(key)\n }\n }\n\n resetValues() {\n for (const control of Object.values<AbstractControl>(this._controls)) {\n control.setValue('')\n }\n }\n\n unregisterControl(name: string) {\n const control = this._controls[name as KeyOfString<TValue>]\n\n if (control) {\n const listener = this.serializeListeners[name]\n control.on('valueChanged', listener)\n delete this.serializeListeners[name]\n delete this._controls[name as KeyOfString<TValue>]\n }\n }\n\n validateFields(requiredFields?: string[] | undefined) {\n const castRequiredFields = requiredFields as KeyOfString<TValue>[]\n for (const key in this._controls) {\n const castKey = key as KeyOfString<TValue>\n if (castRequiredFields === undefined || castRequiredFields.includes(castKey)) {\n const control = this._controls[castKey]\n control.validate()\n }\n }\n }\n\n private serializeControlValue(name: string, control: AbstractControl) {\n const shouldSerialize = this.fgParams?.serialize\n const sensitiveStorage = this.sensitiveStorage\n const storage = this.nonSensitiveStorage\n\n if (!shouldSerialize && (storage || sensitiveStorage)) console.warn('storage medium set but serialize is not enabled')\n\n if (shouldSerialize && control.serializeSettings.serializable) {\n this.setStateValueFromStorage(name, control)\n\n const listener: ValueChangeEventListener = ({ value }) => {\n // detect if control wants to be serialized\n if (control.serializeSettings.serializable) {\n // detect control's preferred storage\n const targetStorage = control.serializeSettings.sensitive ? sensitiveStorage : storage\n\n // detect control's preferred state\n const targetState = control.serializeSettings.sensitive ? this.serializedSensitiveState : this.serializedState\n\n // set the value\n targetState[name as KeyOfString<TStorageValue>] = value ?? ''\n\n // add a timestamp\n const payloadWithTimestamp = targetState as PayloadWithTimestamp\n payloadWithTimestamp.timestamp = Date.now()\n\n // serialize the value\n this.serializeValues(targetStorage, targetState as TStorageValue)\n }\n }\n\n // listen for value changes\n control.on('valueChanged', listener)\n\n // store the listener for later removal\n this.serializeListeners[name] = listener\n }\n }\n\n private serializeValues(storage?: FormGroupStorage<TStorageValue>, values?: TStorageValue) {\n if (storage && values) {\n const write = async () => await storage.insert(values)\n const clear = async () => await storage.clear()\n\n forget(clear())\n forget(write())\n }\n }\n\n private setStateValueFromStorage(name: string, control: AbstractControl) {\n const read = async () => {\n const savedValue = await this.getSerializedValue(name, control.serializeSettings.sensitive)\n\n if (savedValue) {\n const targetState = control.serializeSettings.sensitive ? this.serializedSensitiveState : this.serializedState\n targetState[name as KeyOfString<TStorageValue>] = savedValue\n\n control.setValue(savedValue, { disableEmit: true })\n }\n }\n\n forget(read())\n }\n}\n","import { forget } from '@xylabs/sdk-js'\n\nimport type {\n ControlValueAccessorBaseEvents,\n FormControlStatus,\n ValidControlValue,\n} from './accessor/index.ts'\nimport {\n ControlValueAccessorBase,\n DISABLED,\n INVALID,\n PENDING,\n VALID,\n} from './accessor/index.ts'\n\nexport type AbstractControlEvents<TValue> = ControlValueAccessorBaseEvents<TValue> & {\n statusChanged: { status: FormControlStatus }\n}\n\n/**\n * This is the base class for `Control` classes (i.e. FormControl),\n *\n * It provides some of the shared behavior that all controls and groups of controls have, like\n * running validators, calculating status, and resetting state. It also defines the properties\n * that are shared between all sub-classes, like `value`, `valid`, and `dirty`. It shouldn't be\n * instantiated directly.\n *\n * NOTE: Heavily borrowed from Angular's AbstractControl:\n * https://github.com/angular/angular/blob/5dcdbfcba934a930468aec140a7183b034466bdf/packages/forms/src/model/abstract_model.ts\n */\nexport class AbstractControl<TValue extends ValidControlValue = ValidControlValue> extends ControlValueAccessorBase<\n TValue,\n AbstractControlEvents<TValue>\n> {\n private _status: FormControlStatus | undefined = undefined\n\n constructor() {\n super({})\n }\n\n /**\n * A control is `disabled` when its `status` is `DISABLED`.\n *\n * Disabled controls are exempt from validation checks and\n * are not included in the aggregate value of their ancestor\n * controls.\n *\n * @returns True if the control is disabled, false otherwise.\n */\n /** @deprecated - disabled functionality not implemented */\n get disabled(): boolean {\n return this.status === DISABLED\n }\n\n /**\n * A control is `enabled` as long as its `status` is not `DISABLED`.\n *\n * @returns True if the control has any status other than 'DISABLED',\n * false if the status is 'DISABLED'.\n */\n get enabled(): boolean {\n return this.status !== DISABLED\n }\n\n /**\n * A control is `invalid` when its `status` is `INVALID`.\n\n *\n * @returns True if this control has failed one or more of its validation checks,\n * false otherwise.\n */\n get invalid(): boolean {\n return this.status === INVALID\n }\n\n /**\n * A control is `pending` when its `status` is `PENDING`.\n *\n * @returns True if this control is in the process of conducting a validation check,\n * false otherwise.\n */\n get pending(): boolean {\n return this.status == PENDING\n }\n\n /**\n * The raw value of the control.\n */\n get rawValue(): TValue {\n return this.value\n }\n\n /**\n * The current status of the control.\n */\n get status() {\n return this._status\n }\n\n /**\n * A control is `valid` when its `status` is `VALID`.\n *\n * @returns True if the control has passed all of its validation tests,\n * false otherwise.\n */\n get valid(): boolean {\n return this.status === VALID\n }\n\n setErrorAndValidity(error: string, status: FormControlStatus) {\n this.setError(error)\n this.setStatus(status)\n }\n\n setStatus(status: FormControlStatus) {\n if (this._status === status) return\n\n this._status = status\n\n const emit = async () => await this.emit('statusChanged', { status })\n forget(emit())\n }\n\n validate(): boolean {\n return true\n }\n}\n","import type { BaseParams } from '@xylabs/base'\nimport { forget } from '@xylabs/sdk-js'\nimport { ModuleBaseEmitter } from '@xyo-network/module-event-emitter'\n\nimport type {\n ControlSerializeSettings, ControlValueAccessor, SetOptions,\n} from './ControlValueAccessor.ts'\nimport type { ValidControlValue } from './ValidControlValue.ts'\n\nexport type ControlValueAccessorBaseConfig = {\n disableEvents?: boolean\n}\n\nexport const DefaultSetOptions: SetOptions = { disableEmit: false }\n\nexport type ControlValueAccessorBaseEvents<TValue = ValidControlValue> = {\n errorChanged: { error: string }\n touchChanged: { touched: boolean }\n valueChanged: { value: TValue }\n}\n\n/**\n * The base class for control value accessors interface\n */\nexport class ControlValueAccessorBase<\n TValue = ValidControlValue,\n TEventData extends ControlValueAccessorBaseEvents<TValue> = ControlValueAccessorBaseEvents<TValue>,\n>\n extends ModuleBaseEmitter<BaseParams, TEventData>\n implements ControlValueAccessor<TValue> {\n private _error: string = ''\n\n private _previousValue = undefined as TValue\n\n private _serializeSettings: ControlSerializeSettings = { sensitive: false, serializable: false }\n\n private _touched: boolean = false\n\n private _value = undefined as TValue\n\n private config: ControlValueAccessorBaseConfig\n\n constructor(config: ControlValueAccessorBaseConfig) {\n super({})\n this.config = config\n }\n\n /**\n * The error message for the control.\n */\n get error() {\n return this._error\n }\n\n /**\n * The \"previous value\" of the input element.\n */\n get previousValue() {\n return this._previousValue\n }\n\n /**\n * The serialize settings of the input element.\n */\n get serializeSettings() {\n return this._serializeSettings\n }\n\n /**\n * The \"touched\" state of the input element.\n */\n get touched() {\n return this._touched\n }\n\n /**\n * The current value of the input element.\n */\n get value() {\n return this._value\n }\n\n /**\n * The registered callback function called when a change or input event occurs on the input\n * element.\n */\n onChange = (_: TValue) => {}\n\n /**\n * Registers a function called when the control error changes.\n */\n onErrorChange: (error: string) => void = () => {}\n\n /**\n * The registered callback function called when a blur event occurs on the input element.\n */\n onTouched = (_isTouched: boolean) => {}\n\n /**\n * Registers a function called when the control value changes.\n * @param {(_value:ValidControlValue)=>void} fn\n * @returns void\n */\n registerOnChange(fn: (_value: TValue) => void): void {\n this.onChange = fn\n }\n\n /**\n * Registers a function called when the control error changes.\n * @param {(error:string)=>void} fn\n */\n registerOnErrorChange(fn: (error: string) => void) {\n this.onErrorChange = fn\n }\n\n /**\n * Registers a function called when the control is touched.\n * @param {(isTouched:boolean)=>void} fn\n * @returns void\n */\n registerOnTouched(fn: (isTouched: boolean) => void): void {\n this.onTouched = fn\n }\n\n /**\n * Sets the \"touched\" state of the input element.\n * @param {boolean} isTouched\n */\n setTouched(isTouched: boolean) {\n if (this.touched !== isTouched) {\n this._touched = isTouched\n this.onTouched(isTouched)\n\n if (this.config.disableEvents) return\n const emit = async () => await this.emit('touchChanged', { touched: isTouched })\n forget(emit())\n }\n }\n\n /**\n * Sets the \"value\" property on the input element.\n * @param {ValidControlValue} value\n * @returns void\n */\n setValue(value: TValue, options = DefaultSetOptions): void {\n this._previousValue = this._value\n\n const normalizedValue = value == null ? ('' as TValue) : value\n\n if (this.value !== normalizedValue) {\n this._value = normalizedValue\n this.onChange(normalizedValue)\n\n if (this.config.disableEvents || options.disableEmit) return\n const emit = async () => await this.emit('valueChanged', { value: normalizedValue })\n forget(emit())\n }\n }\n\n /**\n * Set the error message for the control.\n * @param {string} error\n */\n protected setError(error: string) {\n if (this.error !== error) {\n this._error = error\n this.onErrorChange(error)\n\n if (this.config.disableEvents) return\n const emit = async () => await this.emit('errorChanged', { error })\n forget(emit())\n }\n }\n\n /**\n * Sets the \"previous value\" of the input element.\n * @param {ValidControlValue} value\n * @returns void\n */\n protected setPreviousValue(value: TValue): void {\n this._previousValue = value\n }\n\n /**\n * Sets the serialize settings of the input element.\n * @param {ControlSerializeSettings} settings\n */\n protected setSerializeSettings(settings: ControlSerializeSettings) {\n this._serializeSettings = settings\n }\n}\n","/**\n * Reports that a control is valid, meaning that no errors exist in the input value.\n */\nexport const VALID = 'VALID' as const\n\n/**\n * Reports that a control is invalid, meaning that an error exists in the input value.\n */\nexport const INVALID = 'INVALID' as const\n\n/**\n * Reports that a control is pending, meaning that async validation is occurring and\n * errors are not yet available for the input value.\n */\nexport const PENDING = 'PENDING' as const\n\n/**\n * Reports that a control is disabled, meaning that the control is exempt from ancestor\n * calculations of validity or value.\n */\nexport const DISABLED = 'DISABLED' as const\n\n/**\n * A control can have several different statuses. Each\n * possible status is returned as a string literal.\n *\n * * **VALID**: Reports that a control is valid, meaning that no errors exist in the input\n * value.\n * * **INVALID**: Reports that a control is invalid, meaning that an error exists in the input\n * value.\n * * **PENDING**: Reports that a control is pending, meaning that async validation is\n * occurring and errors are not yet available for the input value.\n * * **DISABLED**: Reports that a control is\n * disabled, meaning that the control is exempt from ancestor calculations of validity or value.\n */\nexport type FormControlStatus = typeof VALID | typeof INVALID | typeof PENDING | typeof DISABLED\n","import type { EmptyObject } from '@xylabs/sdk-js'\n\nimport { AbstractControl } from './AbstractControl.ts'\nimport type { SetOptions } from './accessor/index.ts'\nimport type { CursorPosition, FormControl } from './FormControl.ts'\n\nconst AllowAllRegex = /^.*$/s\n\n/**\n * A base class for form controls and their validation.\n */\nexport abstract class FormControlBase<TProps extends EmptyObject = EmptyObject> extends AbstractControl implements FormControl {\n /**\n * The current and previous cursor position of the input element.\n */\n cursorPosition: CursorPosition = { current: undefined, previous: undefined }\n\n invalidMessage = 'Invalid input'\n pattern = AllowAllRegex\n patternStrict = AllowAllRegex\n props = {} as TProps\n required = false\n\n private _name: string | undefined = undefined\n\n constructor() {\n super()\n }\n\n get name() {\n return this._name\n }\n\n override get rawValue() {\n return this.unmask && this.value ? this.unmask(this.value) : this.value\n }\n\n blurError?(value: string): void | undefined\n changeError?(value: string): void\n getCursorPosition?(): number | undefined\n mask?(value: string): string\n onCursorChange: (cursor: number | undefined) => void = () => {}\n\n override setValue(value: string = '', setOptions: SetOptions) {\n // check for pattern validation\n if (this.unmask && this.pattern) {\n const unmasked = this.unmask(value)\n const match = RegExp(this.pattern).exec(unmasked)\n // set the new value before checking for errors\n super.setValue(this.mask ? this.mask(unmasked) : unmasked, setOptions)\n if (match) {\n // if the value matches the pattern, update the cursor position\n if (this.getCursorPosition) {\n const newCursor = this.getCursorPosition()\n this.onCursorChange(newCursor)\n }\n } else {\n // if no match, set the error and return to the previous value\n this.setValue(this.previousValue, setOptions)\n this.onCursorChange?.(this.cursorPosition.previous)\n }\n } else {\n // if no mask or pattern, just set the value\n super.setValue(value, setOptions)\n }\n // check for changeError validation after pattern validation\n this.changeError?.(value)\n }\n\n unmask?(value: string): string\n\n // For FormControls, validate is the same as running one of the error checking functions\n override validate(): boolean {\n const normalizedValue = this.value ?? ''\n // prefer the blurError function since validation assumes the user is done typing\n // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n this.blurError ? this.blurError(normalizedValue) : this.changeError?.(normalizedValue)\n return !this.error\n }\n\n protected setName(name: string | undefined) {\n this._name = name\n }\n}\n","import { useContextEx } from '@xylabs/react-shared'\n\nimport { FormGroupBaseContext } from './Context.ts'\n\nexport const useFormGroup = (required = false) => useContextEx(FormGroupBaseContext, 'FormGroup', required)\n","import type { ArchivistInstance } from '@xyo-network/archivist-model'\nimport type { Payload } from '@xyo-network/payload-model'\n\nimport type { FormGroupStorage } from './FormGroupStorage.ts'\n\nexport class ArchivistFormGroupStorage implements FormGroupStorage {\n private archivist: ArchivistInstance\n\n constructor(archivist: ArchivistInstance) {\n this.archivist = archivist\n }\n\n async clear() {\n await this.archivist.clear?.()\n }\n\n async get() {\n const all = await this.archivist.all?.()\n return all.at(-1)\n }\n\n async insert(value: Payload) {\n await this.archivist.insert?.([value])\n }\n}\n"],"mappings":"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","names":["createContextEx","FormGroupBaseContext","React","useMemo","forget","forget","forget","ModuleBaseEmitter","DefaultSetOptions","disableEmit","ControlValueAccessorBase","ModuleBaseEmitter","_error","_previousValue","undefined","_serializeSettings","sensitive","serializable","_touched","_value","config","error","previousValue","serializeSettings","touched","value","onChange","_","onErrorChange","onTouched","_isTouched","registerOnChange","fn","registerOnErrorChange","registerOnTouched","setTouched","isTouched","disableEvents","emit","forget","setValue","options","normalizedValue","setError","setPreviousValue","setSerializeSettings","settings","VALID","INVALID","PENDING","DISABLED","AbstractControl","ControlValueAccessorBase","_status","undefined","disabled","status","DISABLED","enabled","invalid","INVALID","pending","PENDING","rawValue","value","valid","VALID","setErrorAndValidity","error","setError","setStatus","emit","forget","validate","AllowAllRegex","FormControlBase","AbstractControl","cursorPosition","current","undefined","previous","invalidMessage","pattern","patternStrict","props","required","_name","name","rawValue","unmask","value","onCursorChange","setValue","setOptions","unmasked","match","RegExp","exec","mask","getCursorPosition","newCursor","previousValue","changeError","validate","normalizedValue","blurError","error","setName","FormGroup","AbstractControl","_controls","fgParams","serializeListeners","serializedSensitiveState","serializedState","errorSummary","errorMessage","invalidFields","key","value","Object","entries","errors","push","castKey","error","nonSensitiveStorage","storage","sensitiveStorage","sensitive","touched","values","some","control","valid","every","rawValue","getControl","name","getSerializedValue","savedState","get","savedValue","savedStateWithTimestamp","timestamp","ttlStorage","expirationDate","now","Date","undefined","console","warn","registerControl","serializeControlValue","resetControls","unregisterControl","resetValues","setValue","listener","on","validateFields","requiredFields","castRequiredFields","includes","validate","shouldSerialize","serialize","serializeSettings","serializable","setStateValueFromStorage","targetStorage","targetState","payloadWithTimestamp","serializeValues","write","insert","clear","forget","read","disableEmit","FormGroupPayloadProvider","children","params","props","formGroup","useMemo","FormGroup","value","provided","FormGroupBaseContext","useContextEx","useFormGroup","required","useContextEx","FormGroupBaseContext","ArchivistFormGroupStorage","archivist","clear","get","all","at","insert","value"]}
|
|
1
|
+
{"version":3,"sources":["../../src/context/Context.ts","../../src/context/Provider.tsx","../../src/FormGroup.ts","../../src/control/AbstractControl.ts","../../src/control/accessor/ControlValueAccessorBase.ts","../../src/control/accessor/FormControlStatus.ts","../../src/control/FormControlBase.ts","../../src/context/use.ts","../../src/storage/ArchivistFormGroupStorage.ts"],"sourcesContent":["import { createContextEx } from '@xylabs/react-shared'\n\nimport type { FormGroupContextWithPayloadState } from './State.ts'\n\nexport const FormGroupBaseContext = createContextEx<FormGroupContextWithPayloadState>()\n","import type { Payload } from '@xyo-network/payload-model'\nimport type { PropsWithChildren } from 'react'\nimport React, { useMemo } from 'react'\n\nimport type { FormGroupParams } from '../FormGroup.ts'\nimport { FormGroup } from '../FormGroup.ts'\nimport { FormGroupBaseContext } from './Context.ts'\nimport type { FormGroupContextWithPayloadState } from './State.ts'\n\nexport interface FormGroupPayloadProviderProps<TStorage extends Payload = Payload> extends PropsWithChildren {\n params?: FormGroupParams<TStorage>\n}\n\n/**\n * Provides a FormGroup to child components.\n */\nexport const FormGroupPayloadProvider = ({\n children, params, ...props\n}: FormGroupPayloadProviderProps) => {\n const formGroup = useMemo(() => {\n const formGroup = new FormGroup<Payload, Payload>(params)\n return formGroup\n }, [params])\n\n const value: FormGroupContextWithPayloadState = useMemo(() => ({ formGroup, provided: true }), [formGroup])\n\n return (\n\n <FormGroupBaseContext\n value={value}\n {...props}\n >\n {children}\n </FormGroupBaseContext>\n )\n}\n","import type { EventListener } from '@xylabs/sdk-js'\nimport { forget } from '@xylabs/sdk-js'\nimport type { Payload } from '@xyo-network/payload-model'\n\nimport type { ControlValueAccessorBaseEvents } from './control/index.ts'\nimport { AbstractControl } from './control/index.ts'\nimport type { ErrorSummary } from './InputError.ts'\nimport type { FormGroupStorage } from './storage/index.ts'\n\nexport type PayloadWithTimestamp = Payload<{ timestamp?: number }>\n\nexport type KeyOfString<T> = keyof T extends string ? keyof T : never\n\ntype FormGroupErrors<TValue> = Record<KeyOfString<TValue>, string>\n\nexport interface FormGroupParams<TStorageValue extends Payload = Payload> {\n serialize?: boolean\n storage?: {\n sensitive?: FormGroupStorage<TStorageValue>\n storage?: FormGroupStorage<TStorageValue>\n }\n ttlStorage?: number\n}\n\ntype ValueChangeEventListener = EventListener<ControlValueAccessorBaseEvents['valueChanged']>\n\n/**\n * Organize form controls in a group.\n *\n * NOTE: This is a work in progress and only supports top level controls. Nested controls are not supported.\n */\nexport class FormGroup<\n TValue extends PayloadWithTimestamp = PayloadWithTimestamp,\n TStorageValue extends PayloadWithTimestamp = PayloadWithTimestamp,\n> extends AbstractControl {\n private _controls = {} as Record<KeyOfString<TValue>, AbstractControl>\n\n private fgParams?: FormGroupParams<TStorageValue>\n\n private serializeListeners: Record<string, ValueChangeEventListener> = {}\n\n private serializedSensitiveState = {} as Record<KeyOfString<TStorageValue>, string>\n private serializedState = {} as Record<KeyOfString<TStorageValue>, string>\n\n constructor(fgParams?: FormGroupParams<TStorageValue>) {\n super()\n this.fgParams = fgParams\n }\n\n get errorSummary() {\n const errorSummary: ErrorSummary = {\n errorMessage: '',\n invalidFields: [],\n }\n for (const [key, value] of Object.entries(this.errors)) {\n if (value) {\n errorSummary.errorMessage = `${errorSummary.errorMessage}, ${value}`\n errorSummary.invalidFields.push(key)\n }\n }\n\n return errorSummary\n }\n\n get errors(): FormGroupErrors<TValue> {\n const value = {} as FormGroupErrors<TValue>\n for (const key in this._controls) {\n const castKey = key as KeyOfString<TValue>\n value[castKey] = this._controls[castKey].error\n }\n return value\n }\n\n get nonSensitiveStorage() {\n return this.fgParams?.storage?.storage\n }\n\n get sensitiveStorage() {\n return this.fgParams?.storage?.sensitive\n }\n\n override get touched() {\n return Object.values<AbstractControl>(this._controls).some(control => control.touched)\n }\n\n override get valid() {\n return Object.values<AbstractControl>(this._controls).every(control => control.valid)\n }\n\n get values(): TValue {\n const value = {} as TValue\n for (const key in this._controls) {\n const castKey = key as KeyOfString<TValue>\n value[castKey] = this._controls[castKey].rawValue as TValue[KeyOfString<TValue>]\n }\n return value\n }\n\n getControl(name: string) {\n return this._controls[name as KeyOfString<TValue>]\n }\n\n async getSerializedValue(name: string, sensitive = false): Promise<string | undefined> {\n const storage = sensitive ? this.sensitiveStorage : this.nonSensitiveStorage\n if (storage) {\n const savedState = await storage.get()\n if (savedState && name in savedState) {\n const savedValue = savedState[name as keyof typeof savedState] as string\n\n // casting to PayloadWithTimestamp to check for timestamp\n const savedStateWithTimestamp = savedState as unknown as PayloadWithTimestamp\n if (savedStateWithTimestamp.timestamp && this.fgParams?.ttlStorage) {\n const expirationDate = savedStateWithTimestamp.timestamp + (this.fgParams?.ttlStorage ?? 0)\n const now = Date.now()\n return now > expirationDate ? undefined : savedValue\n }\n return savedValue\n }\n } else {\n console.warn(`Cannot return value for ${name}. No storage set`)\n }\n }\n\n registerControl(name: string, control: AbstractControl) {\n if (this._controls[name as KeyOfString<TValue>]) console.error(`Replacing Control with name ${name} since it already exists!`)\n this._controls[name as KeyOfString<TValue>] = control\n this.serializeControlValue(name, control)\n }\n\n resetControls() {\n for (const key in this._controls) {\n this.unregisterControl(key)\n }\n }\n\n resetValues() {\n for (const control of Object.values<AbstractControl>(this._controls)) {\n control.setValue('')\n }\n }\n\n unregisterControl(name: string) {\n const control = this._controls[name as KeyOfString<TValue>]\n\n if (control) {\n const listener = this.serializeListeners[name]\n control.on('valueChanged', listener)\n delete this.serializeListeners[name]\n delete this._controls[name as KeyOfString<TValue>]\n }\n }\n\n validateFields(requiredFields?: string[] | undefined) {\n const castRequiredFields = requiredFields as KeyOfString<TValue>[]\n for (const key in this._controls) {\n const castKey = key as KeyOfString<TValue>\n if (castRequiredFields === undefined || castRequiredFields.includes(castKey)) {\n const control = this._controls[castKey]\n control.validate()\n }\n }\n }\n\n private serializeControlValue(name: string, control: AbstractControl) {\n const shouldSerialize = this.fgParams?.serialize\n const sensitiveStorage = this.sensitiveStorage\n const storage = this.nonSensitiveStorage\n\n if (!shouldSerialize && (storage || sensitiveStorage)) console.warn('storage medium set but serialize is not enabled')\n\n if (shouldSerialize && control.serializeSettings.serializable) {\n this.setStateValueFromStorage(name, control)\n\n const listener: ValueChangeEventListener = ({ value }) => {\n // detect if control wants to be serialized\n if (control.serializeSettings.serializable) {\n // detect control's preferred storage\n const targetStorage = control.serializeSettings.sensitive ? sensitiveStorage : storage\n\n // detect control's preferred state\n const targetState = control.serializeSettings.sensitive ? this.serializedSensitiveState : this.serializedState\n\n // set the value\n targetState[name as KeyOfString<TStorageValue>] = value ?? ''\n\n // add a timestamp\n const payloadWithTimestamp = targetState as PayloadWithTimestamp\n payloadWithTimestamp.timestamp = Date.now()\n\n // serialize the value\n this.serializeValues(targetStorage, targetState as TStorageValue)\n }\n }\n\n // listen for value changes\n control.on('valueChanged', listener)\n\n // store the listener for later removal\n this.serializeListeners[name] = listener\n }\n }\n\n private serializeValues(storage?: FormGroupStorage<TStorageValue>, values?: TStorageValue) {\n if (storage && values) {\n const write = async () => await storage.insert(values)\n const clear = async () => await storage.clear()\n\n forget(clear())\n forget(write())\n }\n }\n\n private setStateValueFromStorage(name: string, control: AbstractControl) {\n const read = async () => {\n const savedValue = await this.getSerializedValue(name, control.serializeSettings.sensitive)\n\n if (savedValue) {\n const targetState = control.serializeSettings.sensitive ? this.serializedSensitiveState : this.serializedState\n targetState[name as KeyOfString<TStorageValue>] = savedValue\n\n control.setValue(savedValue, { disableEmit: true })\n }\n }\n\n forget(read())\n }\n}\n","import { forget } from '@xylabs/sdk-js'\n\nimport type {\n ControlValueAccessorBaseEvents,\n FormControlStatus,\n ValidControlValue,\n} from './accessor/index.ts'\nimport {\n ControlValueAccessorBase,\n DISABLED,\n INVALID,\n PENDING,\n VALID,\n} from './accessor/index.ts'\n\nexport type AbstractControlEvents<TValue> = ControlValueAccessorBaseEvents<TValue> & {\n statusChanged: { status: FormControlStatus }\n}\n\n/**\n * This is the base class for `Control` classes (i.e. FormControl),\n *\n * It provides some of the shared behavior that all controls and groups of controls have, like\n * running validators, calculating status, and resetting state. It also defines the properties\n * that are shared between all sub-classes, like `value`, `valid`, and `dirty`. It shouldn't be\n * instantiated directly.\n *\n * NOTE: Heavily borrowed from Angular's AbstractControl:\n * https://github.com/angular/angular/blob/5dcdbfcba934a930468aec140a7183b034466bdf/packages/forms/src/model/abstract_model.ts\n */\nexport class AbstractControl<TValue extends ValidControlValue = ValidControlValue> extends ControlValueAccessorBase<\n TValue,\n AbstractControlEvents<TValue>\n> {\n private _status: FormControlStatus | undefined = undefined\n\n constructor() {\n super({})\n }\n\n /**\n * A control is `disabled` when its `status` is `DISABLED`.\n *\n * Disabled controls are exempt from validation checks and\n * are not included in the aggregate value of their ancestor\n * controls.\n *\n * @returns True if the control is disabled, false otherwise.\n */\n /** @deprecated - disabled functionality not implemented */\n get disabled(): boolean {\n return this.status === DISABLED\n }\n\n /**\n * A control is `enabled` as long as its `status` is not `DISABLED`.\n *\n * @returns True if the control has any status other than 'DISABLED',\n * false if the status is 'DISABLED'.\n */\n get enabled(): boolean {\n return this.status !== DISABLED\n }\n\n /**\n * A control is `invalid` when its `status` is `INVALID`.\n\n *\n * @returns True if this control has failed one or more of its validation checks,\n * false otherwise.\n */\n get invalid(): boolean {\n return this.status === INVALID\n }\n\n /**\n * A control is `pending` when its `status` is `PENDING`.\n *\n * @returns True if this control is in the process of conducting a validation check,\n * false otherwise.\n */\n get pending(): boolean {\n return this.status == PENDING\n }\n\n /**\n * The raw value of the control.\n */\n get rawValue(): TValue {\n return this.value\n }\n\n /**\n * The current status of the control.\n */\n get status() {\n return this._status\n }\n\n /**\n * A control is `valid` when its `status` is `VALID`.\n *\n * @returns True if the control has passed all of its validation tests,\n * false otherwise.\n */\n get valid(): boolean {\n return this.status === VALID\n }\n\n setErrorAndValidity(error: string, status: FormControlStatus) {\n this.setError(error)\n this.setStatus(status)\n }\n\n setStatus(status: FormControlStatus) {\n if (this._status === status) return\n\n this._status = status\n\n const emit = async () => await this.emit('statusChanged', { status })\n forget(emit())\n }\n\n validate(): boolean {\n return true\n }\n}\n","import type { BaseParams } from '@xylabs/sdk-js'\nimport { forget } from '@xylabs/sdk-js'\nimport { ModuleBaseEmitter } from '@xyo-network/module-event-emitter'\n\nimport type {\n ControlSerializeSettings, ControlValueAccessor, SetOptions,\n} from './ControlValueAccessor.ts'\nimport type { ValidControlValue } from './ValidControlValue.ts'\n\nexport interface ControlValueAccessorBaseConfig {\n disableEvents?: boolean\n}\n\nexport const DefaultSetOptions: SetOptions = { disableEmit: false }\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\nexport type ControlValueAccessorBaseEvents<TValue = ValidControlValue> = {\n [key: PropertyKey]: string | number | object\n errorChanged: { error: string }\n touchChanged: { touched: boolean }\n valueChanged: { value: TValue }\n}\n\n/**\n * The base class for control value accessors interface\n */\nexport class ControlValueAccessorBase<\n TValue = ValidControlValue,\n TEventData extends ControlValueAccessorBaseEvents<TValue> = ControlValueAccessorBaseEvents<TValue>,\n>\n extends ModuleBaseEmitter<BaseParams, TEventData>\n implements ControlValueAccessor<TValue> {\n private _error = ''\n\n private _previousValue = undefined as TValue\n\n private _serializeSettings: ControlSerializeSettings = { sensitive: false, serializable: false }\n\n private _touched = false\n\n private _value = undefined as TValue\n\n private config: ControlValueAccessorBaseConfig\n\n constructor(config: ControlValueAccessorBaseConfig) {\n super({})\n this.config = config\n }\n\n /**\n * The error message for the control.\n */\n get error() {\n return this._error\n }\n\n /**\n * The \"previous value\" of the input element.\n */\n get previousValue() {\n return this._previousValue\n }\n\n /**\n * The serialize settings of the input element.\n */\n get serializeSettings() {\n return this._serializeSettings\n }\n\n /**\n * The \"touched\" state of the input element.\n */\n get touched() {\n return this._touched\n }\n\n /**\n * The current value of the input element.\n */\n get value() {\n return this._value\n }\n\n /**\n * The registered callback function called when a change or input event occurs on the input\n * element.\n */\n onChange = (_: TValue) => { /* noop default */ }\n\n /**\n * Registers a function called when the control error changes.\n */\n onErrorChange: (error: string) => void = () => { /* noop default */ }\n\n /**\n * The registered callback function called when a blur event occurs on the input element.\n */\n onTouched = (_isTouched: boolean) => { /* noop default */ }\n\n /**\n * Registers a function called when the control value changes.\n * @param {(_value:ValidControlValue)=>void} fn\n * @returns void\n */\n registerOnChange(fn: (_value: TValue) => void): void {\n this.onChange = fn\n }\n\n /**\n * Registers a function called when the control error changes.\n * @param {(error:string)=>void} fn\n */\n registerOnErrorChange(fn: (error: string) => void) {\n this.onErrorChange = fn\n }\n\n /**\n * Registers a function called when the control is touched.\n * @param {(isTouched:boolean)=>void} fn\n * @returns void\n */\n registerOnTouched(fn: (isTouched: boolean) => void): void {\n this.onTouched = fn\n }\n\n /**\n * Sets the \"touched\" state of the input element.\n * @param {boolean} isTouched\n */\n setTouched(isTouched: boolean) {\n if (this.touched !== isTouched) {\n this._touched = isTouched\n this.onTouched(isTouched)\n\n if (this.config.disableEvents) return\n const emit = async () => await this.emit('touchChanged', { touched: isTouched })\n forget(emit())\n }\n }\n\n /**\n * Sets the \"value\" property on the input element.\n * @param {ValidControlValue} value\n * @returns void\n */\n setValue(value: TValue, options = DefaultSetOptions): void {\n this._previousValue = this._value\n\n const normalizedValue = value == null ? ('' as TValue) : value\n\n if (this.value !== normalizedValue) {\n this._value = normalizedValue\n this.onChange(normalizedValue)\n\n if (this.config.disableEvents || options.disableEmit) return\n const emit = async () => await this.emit('valueChanged', { value: normalizedValue })\n forget(emit())\n }\n }\n\n /**\n * Set the error message for the control.\n * @param {string} error\n */\n protected setError(error: string) {\n if (this.error !== error) {\n this._error = error\n this.onErrorChange(error)\n\n if (this.config.disableEvents) return\n const emit = async () => await this.emit('errorChanged', { error })\n forget(emit())\n }\n }\n\n /**\n * Sets the \"previous value\" of the input element.\n * @param {ValidControlValue} value\n * @returns void\n */\n protected setPreviousValue(value: TValue): void {\n this._previousValue = value\n }\n\n /**\n * Sets the serialize settings of the input element.\n * @param {ControlSerializeSettings} settings\n */\n protected setSerializeSettings(settings: ControlSerializeSettings) {\n this._serializeSettings = settings\n }\n}\n","/**\n * Reports that a control is valid, meaning that no errors exist in the input value.\n */\nexport const VALID = 'VALID' as const\n\n/**\n * Reports that a control is invalid, meaning that an error exists in the input value.\n */\nexport const INVALID = 'INVALID' as const\n\n/**\n * Reports that a control is pending, meaning that async validation is occurring and\n * errors are not yet available for the input value.\n */\nexport const PENDING = 'PENDING' as const\n\n/**\n * Reports that a control is disabled, meaning that the control is exempt from ancestor\n * calculations of validity or value.\n */\nexport const DISABLED = 'DISABLED' as const\n\n/**\n * A control can have several different statuses. Each\n * possible status is returned as a string literal.\n *\n * * **VALID**: Reports that a control is valid, meaning that no errors exist in the input\n * value.\n * * **INVALID**: Reports that a control is invalid, meaning that an error exists in the input\n * value.\n * * **PENDING**: Reports that a control is pending, meaning that async validation is\n * occurring and errors are not yet available for the input value.\n * * **DISABLED**: Reports that a control is\n * disabled, meaning that the control is exempt from ancestor calculations of validity or value.\n */\nexport type FormControlStatus = typeof VALID | typeof INVALID | typeof PENDING | typeof DISABLED\n","import type { EmptyObject } from '@xylabs/sdk-js'\n\nimport { AbstractControl } from './AbstractControl.ts'\nimport type { SetOptions } from './accessor/index.ts'\nimport type { CursorPosition, FormControl } from './FormControl.ts'\n\nconst AllowAllRegex = /^.*$/s\n\n/**\n * A base class for form controls and their validation.\n */\nexport abstract class FormControlBase<TProps extends EmptyObject = EmptyObject> extends AbstractControl implements FormControl {\n /**\n * The current and previous cursor position of the input element.\n */\n cursorPosition: CursorPosition = { current: undefined, previous: undefined }\n\n invalidMessage = 'Invalid input'\n pattern = AllowAllRegex\n patternStrict = AllowAllRegex\n props = {} as TProps\n required = false\n\n private _name: string | undefined = undefined\n\n constructor() {\n super()\n }\n\n get name() {\n return this._name\n }\n\n override get rawValue() {\n return this.unmask && this.value ? this.unmask(this.value) : this.value\n }\n\n blurError?(value: string): void | undefined\n changeError?(value: string): void\n getCursorPosition?(): number | undefined\n mask?(value: string): string\n onCursorChange: (cursor: number | undefined) => void = () => { /* noop default */ }\n\n override setValue(value = '', setOptions: SetOptions) {\n // check for pattern validation\n if (this.unmask && this.pattern) {\n const unmasked = this.unmask(value)\n const match = RegExp(this.pattern).exec(unmasked)\n // set the new value before checking for errors\n super.setValue(this.mask ? this.mask(unmasked) : unmasked, setOptions)\n if (match) {\n // if the value matches the pattern, update the cursor position\n if (this.getCursorPosition) {\n const newCursor = this.getCursorPosition()\n this.onCursorChange(newCursor)\n }\n } else {\n // if no match, set the error and return to the previous value\n this.setValue(this.previousValue, setOptions)\n this.onCursorChange?.(this.cursorPosition.previous)\n }\n } else {\n // if no mask or pattern, just set the value\n super.setValue(value, setOptions)\n }\n // check for changeError validation after pattern validation\n this.changeError?.(value)\n }\n\n unmask?(value: string): string\n\n // For FormControls, validate is the same as running one of the error checking functions\n override validate(): boolean {\n const normalizedValue = this.value ?? ''\n // prefer the blurError function since validation assumes the user is done typing\n // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n this.blurError ? this.blurError(normalizedValue) : this.changeError?.(normalizedValue)\n return !this.error\n }\n\n protected setName(name: string | undefined) {\n this._name = name\n }\n}\n","import { useContextEx } from '@xylabs/react-shared'\n\nimport { FormGroupBaseContext } from './Context.ts'\n\nexport const useFormGroup = (required = false) => useContextEx(FormGroupBaseContext, 'FormGroup', required)\n","import type { ArchivistInstance } from '@xyo-network/archivist-model'\nimport type { Payload } from '@xyo-network/payload-model'\n\nimport type { FormGroupStorage } from './FormGroupStorage.ts'\n\nexport class ArchivistFormGroupStorage implements FormGroupStorage {\n private archivist: ArchivistInstance\n\n constructor(archivist: ArchivistInstance) {\n this.archivist = archivist\n }\n\n async clear() {\n await this.archivist.clear?.()\n }\n\n async get() {\n const all = await this.archivist.all?.()\n return all.at(-1)\n }\n\n async insert(value: Payload) {\n await this.archivist.insert?.([value])\n }\n}\n"],"mappings":"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","names":["forget","forget","forget","forget","formGroup"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xyo-network/react-form-group",
|
|
3
|
-
"version": "7.5.
|
|
3
|
+
"version": "7.5.11",
|
|
4
4
|
"description": "Common React library for all XYO projects that use React",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"xyo",
|
|
@@ -36,47 +36,71 @@
|
|
|
36
36
|
},
|
|
37
37
|
"./package.json": "./package.json"
|
|
38
38
|
},
|
|
39
|
-
"module": "dist/browser/index.mjs",
|
|
40
|
-
"types": "dist/browser/index.d.ts",
|
|
41
39
|
"files": [
|
|
42
40
|
"dist",
|
|
43
|
-
"
|
|
41
|
+
"README.md"
|
|
44
42
|
],
|
|
45
|
-
"dependencies": {
|
|
46
|
-
"@xylabs/base": "~5.0.90",
|
|
47
|
-
"@xylabs/react-shared": "~7.1.17",
|
|
48
|
-
"@xylabs/sdk-js": "~5.0.90",
|
|
49
|
-
"@xyo-network/archivist-model": "~5.3.17",
|
|
50
|
-
"@xyo-network/module-event-emitter": "~5.3.17",
|
|
51
|
-
"@xyo-network/payload-model": "~5.3.17"
|
|
52
|
-
},
|
|
53
43
|
"devDependencies": {
|
|
54
|
-
"@
|
|
55
|
-
"@
|
|
56
|
-
"@
|
|
44
|
+
"@opentelemetry/api": "^1.9.1",
|
|
45
|
+
"@opentelemetry/sdk-trace-base": "^2.7.0",
|
|
46
|
+
"@scure/base": "~2.2.0",
|
|
47
|
+
"@storybook/react-vite": "~10.3.5",
|
|
48
|
+
"@types/node": "~25.6.0",
|
|
57
49
|
"@types/react": "^19.2.14",
|
|
58
|
-
"@xylabs/
|
|
59
|
-
"@xylabs/
|
|
60
|
-
"@xylabs/
|
|
61
|
-
"@xylabs/
|
|
62
|
-
"@xylabs/
|
|
63
|
-
"@xylabs/tsconfig
|
|
64
|
-
"
|
|
65
|
-
"react
|
|
66
|
-
"
|
|
50
|
+
"@xylabs/react-async-effect": "~7.1.20",
|
|
51
|
+
"@xylabs/react-promise": "~7.1.20",
|
|
52
|
+
"@xylabs/react-shared": "~7.1.20",
|
|
53
|
+
"@xylabs/sdk-js": "^5.0.100",
|
|
54
|
+
"@xylabs/toolchain": "~7.11.9",
|
|
55
|
+
"@xylabs/tsconfig": "^7.11.9",
|
|
56
|
+
"@xylabs/tsconfig-dom": "^7.11.9",
|
|
57
|
+
"@xylabs/tsconfig-react": "~7.11.9",
|
|
58
|
+
"@xyo-network/account-model": "^5.5.1",
|
|
59
|
+
"@xyo-network/archivist-model": "^5.5.5",
|
|
60
|
+
"@xyo-network/boundwitness-model": "^5.5.1",
|
|
61
|
+
"@xyo-network/manifest-model": "~5.5.1",
|
|
62
|
+
"@xyo-network/module-event-emitter": "~5.5.5",
|
|
63
|
+
"@xyo-network/payload-model": "^5.5.1",
|
|
64
|
+
"async-mutex": "^0.5.0",
|
|
65
|
+
"axios": "^1.15.2",
|
|
66
|
+
"bn.js": "^5.2.3",
|
|
67
|
+
"buffer": "^6.0.3",
|
|
68
|
+
"chalk": "^5.6.2",
|
|
69
|
+
"esbuild": "~0.28.0",
|
|
70
|
+
"eslint": "^10.2.1",
|
|
71
|
+
"ethers": "^6.16.0",
|
|
72
|
+
"pako": "^2.1.0",
|
|
73
|
+
"react": "^19.2.5",
|
|
74
|
+
"react-dom": "^19.2.5",
|
|
75
|
+
"storybook": "^10.3.5",
|
|
67
76
|
"typescript": "^5.9.3",
|
|
68
|
-
"vite": "
|
|
77
|
+
"vite": "^8.0.10",
|
|
69
78
|
"zod": "^4.3.6"
|
|
70
79
|
},
|
|
71
80
|
"peerDependencies": {
|
|
72
|
-
"@
|
|
73
|
-
"@
|
|
74
|
-
"react": "
|
|
75
|
-
"react-
|
|
76
|
-
"
|
|
81
|
+
"@opentelemetry/api": "^1.9.1",
|
|
82
|
+
"@opentelemetry/sdk-trace-base": "^2.7.0",
|
|
83
|
+
"@xylabs/react-async-effect": "~7.1.20",
|
|
84
|
+
"@xylabs/react-shared": "~7.1.20",
|
|
85
|
+
"@xylabs/sdk-js": "^5.0.100",
|
|
86
|
+
"@xyo-network/account-model": "^5.5.1",
|
|
87
|
+
"@xyo-network/archivist-model": "^5.5.5",
|
|
88
|
+
"@xyo-network/boundwitness-model": "^5.5.1",
|
|
89
|
+
"@xyo-network/manifest-model": "~5.5.1",
|
|
90
|
+
"@xyo-network/module-event-emitter": "~5.5.5",
|
|
91
|
+
"@xyo-network/payload-model": "^5.5.1",
|
|
92
|
+
"async-mutex": "^0.5.0",
|
|
93
|
+
"bn.js": "^5.2.3",
|
|
94
|
+
"buffer": "^6.0.3",
|
|
95
|
+
"chalk": "^5.6.2",
|
|
96
|
+
"ethers": "^6.16.0",
|
|
97
|
+
"pako": "^2.1.0",
|
|
98
|
+
"react": "^19.2.5",
|
|
99
|
+
"react-dom": "^19.2.5",
|
|
100
|
+
"zod": "^4.3.6"
|
|
77
101
|
},
|
|
78
102
|
"publishConfig": {
|
|
79
103
|
"access": "public"
|
|
80
104
|
},
|
|
81
105
|
"docs": "dist/docs.json"
|
|
82
|
-
}
|
|
106
|
+
}
|
package/src/FormGroup.ts
DELETED
|
@@ -1,227 +0,0 @@
|
|
|
1
|
-
import type { EventListener } from '@xylabs/events'
|
|
2
|
-
import { forget } from '@xylabs/sdk-js'
|
|
3
|
-
import type { Payload } from '@xyo-network/payload-model'
|
|
4
|
-
|
|
5
|
-
import type { ControlValueAccessorBaseEvents } from './control/index.ts'
|
|
6
|
-
import { AbstractControl } from './control/index.ts'
|
|
7
|
-
import type { ErrorSummary } from './InputError.ts'
|
|
8
|
-
import type { FormGroupStorage } from './storage/index.ts'
|
|
9
|
-
|
|
10
|
-
export type PayloadWithTimestamp = Payload<{ timestamp?: number }>
|
|
11
|
-
|
|
12
|
-
export type KeyOfString<T> = keyof T extends string ? keyof T : never
|
|
13
|
-
|
|
14
|
-
type FormGroupErrors<TValue> = Record<KeyOfString<TValue>, string>
|
|
15
|
-
|
|
16
|
-
export type FormGroupParams<TStorageValue extends Payload = Payload> = {
|
|
17
|
-
serialize?: boolean
|
|
18
|
-
storage?: {
|
|
19
|
-
sensitive?: FormGroupStorage<TStorageValue>
|
|
20
|
-
storage?: FormGroupStorage<TStorageValue>
|
|
21
|
-
}
|
|
22
|
-
ttlStorage?: number
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
type ValueChangeEventListener = EventListener<ControlValueAccessorBaseEvents['valueChanged']>
|
|
26
|
-
|
|
27
|
-
/**
|
|
28
|
-
* Organize form controls in a group.
|
|
29
|
-
*
|
|
30
|
-
* NOTE: This is a work in progress and only supports top level controls. Nested controls are not supported.
|
|
31
|
-
*/
|
|
32
|
-
export class FormGroup<
|
|
33
|
-
TValue extends PayloadWithTimestamp = PayloadWithTimestamp,
|
|
34
|
-
TStorageValue extends PayloadWithTimestamp = PayloadWithTimestamp,
|
|
35
|
-
> extends AbstractControl {
|
|
36
|
-
private _controls = {} as Record<KeyOfString<TValue>, AbstractControl>
|
|
37
|
-
|
|
38
|
-
private fgParams?: FormGroupParams<TStorageValue>
|
|
39
|
-
|
|
40
|
-
private serializeListeners: Record<string, ValueChangeEventListener> = {}
|
|
41
|
-
|
|
42
|
-
private serializedSensitiveState = {} as Record<KeyOfString<TStorageValue>, string>
|
|
43
|
-
private serializedState = {} as Record<KeyOfString<TStorageValue>, string>
|
|
44
|
-
|
|
45
|
-
constructor(fgParams?: FormGroupParams<TStorageValue>) {
|
|
46
|
-
super()
|
|
47
|
-
this.fgParams = fgParams
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
get errorSummary() {
|
|
51
|
-
const errorSummary: ErrorSummary = {
|
|
52
|
-
errorMessage: '',
|
|
53
|
-
invalidFields: [],
|
|
54
|
-
}
|
|
55
|
-
for (const [key, value] of Object.entries(this.errors)) {
|
|
56
|
-
if (value) {
|
|
57
|
-
errorSummary.errorMessage = `${errorSummary.errorMessage}, ${value}`
|
|
58
|
-
errorSummary.invalidFields.push(key)
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
return errorSummary
|
|
63
|
-
}
|
|
64
|
-
|
|
65
|
-
get errors(): FormGroupErrors<TValue> {
|
|
66
|
-
const value = {} as FormGroupErrors<TValue>
|
|
67
|
-
for (const key in this._controls) {
|
|
68
|
-
const castKey = key as KeyOfString<TValue>
|
|
69
|
-
value[castKey] = this._controls[castKey].error
|
|
70
|
-
}
|
|
71
|
-
return value
|
|
72
|
-
}
|
|
73
|
-
|
|
74
|
-
get nonSensitiveStorage() {
|
|
75
|
-
return this.fgParams?.storage?.storage
|
|
76
|
-
}
|
|
77
|
-
|
|
78
|
-
get sensitiveStorage() {
|
|
79
|
-
return this.fgParams?.storage?.sensitive
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
override get touched() {
|
|
83
|
-
return Object.values<AbstractControl>(this._controls).some(control => control.touched)
|
|
84
|
-
}
|
|
85
|
-
|
|
86
|
-
override get valid() {
|
|
87
|
-
return Object.values<AbstractControl>(this._controls).every(control => control.valid)
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
get values(): TValue {
|
|
91
|
-
const value = {} as TValue
|
|
92
|
-
for (const key in this._controls) {
|
|
93
|
-
const castKey = key as KeyOfString<TValue>
|
|
94
|
-
value[castKey] = this._controls[castKey].rawValue as TValue[KeyOfString<TValue>]
|
|
95
|
-
}
|
|
96
|
-
return value
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
getControl(name: string) {
|
|
100
|
-
return this._controls[name as KeyOfString<TValue>]
|
|
101
|
-
}
|
|
102
|
-
|
|
103
|
-
async getSerializedValue(name: string, sensitive = false): Promise<string | undefined> {
|
|
104
|
-
const storage = sensitive ? this.sensitiveStorage : this.nonSensitiveStorage
|
|
105
|
-
if (storage) {
|
|
106
|
-
const savedState = await storage.get()
|
|
107
|
-
if (savedState && name in savedState) {
|
|
108
|
-
const savedValue = savedState[name as keyof typeof savedState] as string
|
|
109
|
-
|
|
110
|
-
// casting to PayloadWithTimestamp to check for timestamp
|
|
111
|
-
const savedStateWithTimestamp = savedState as unknown as PayloadWithTimestamp
|
|
112
|
-
if (savedStateWithTimestamp.timestamp && this.fgParams?.ttlStorage) {
|
|
113
|
-
const expirationDate = savedStateWithTimestamp.timestamp + (this.fgParams?.ttlStorage ?? 0)
|
|
114
|
-
const now = Date.now()
|
|
115
|
-
return now > expirationDate ? undefined : savedValue
|
|
116
|
-
}
|
|
117
|
-
return savedValue
|
|
118
|
-
}
|
|
119
|
-
} else {
|
|
120
|
-
console.warn(`Cannot return value for ${name}. No storage set`)
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
|
|
124
|
-
registerControl(name: string, control: AbstractControl) {
|
|
125
|
-
if (this._controls[name as KeyOfString<TValue>]) console.error(`Replacing Control with name ${name} since it already exists!`)
|
|
126
|
-
this._controls[name as KeyOfString<TValue>] = control
|
|
127
|
-
this.serializeControlValue(name, control)
|
|
128
|
-
}
|
|
129
|
-
|
|
130
|
-
resetControls() {
|
|
131
|
-
for (const key in this._controls) {
|
|
132
|
-
this.unregisterControl(key)
|
|
133
|
-
}
|
|
134
|
-
}
|
|
135
|
-
|
|
136
|
-
resetValues() {
|
|
137
|
-
for (const control of Object.values<AbstractControl>(this._controls)) {
|
|
138
|
-
control.setValue('')
|
|
139
|
-
}
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
unregisterControl(name: string) {
|
|
143
|
-
const control = this._controls[name as KeyOfString<TValue>]
|
|
144
|
-
|
|
145
|
-
if (control) {
|
|
146
|
-
const listener = this.serializeListeners[name]
|
|
147
|
-
control.on('valueChanged', listener)
|
|
148
|
-
delete this.serializeListeners[name]
|
|
149
|
-
delete this._controls[name as KeyOfString<TValue>]
|
|
150
|
-
}
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
validateFields(requiredFields?: string[] | undefined) {
|
|
154
|
-
const castRequiredFields = requiredFields as KeyOfString<TValue>[]
|
|
155
|
-
for (const key in this._controls) {
|
|
156
|
-
const castKey = key as KeyOfString<TValue>
|
|
157
|
-
if (castRequiredFields === undefined || castRequiredFields.includes(castKey)) {
|
|
158
|
-
const control = this._controls[castKey]
|
|
159
|
-
control.validate()
|
|
160
|
-
}
|
|
161
|
-
}
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
private serializeControlValue(name: string, control: AbstractControl) {
|
|
165
|
-
const shouldSerialize = this.fgParams?.serialize
|
|
166
|
-
const sensitiveStorage = this.sensitiveStorage
|
|
167
|
-
const storage = this.nonSensitiveStorage
|
|
168
|
-
|
|
169
|
-
if (!shouldSerialize && (storage || sensitiveStorage)) console.warn('storage medium set but serialize is not enabled')
|
|
170
|
-
|
|
171
|
-
if (shouldSerialize && control.serializeSettings.serializable) {
|
|
172
|
-
this.setStateValueFromStorage(name, control)
|
|
173
|
-
|
|
174
|
-
const listener: ValueChangeEventListener = ({ value }) => {
|
|
175
|
-
// detect if control wants to be serialized
|
|
176
|
-
if (control.serializeSettings.serializable) {
|
|
177
|
-
// detect control's preferred storage
|
|
178
|
-
const targetStorage = control.serializeSettings.sensitive ? sensitiveStorage : storage
|
|
179
|
-
|
|
180
|
-
// detect control's preferred state
|
|
181
|
-
const targetState = control.serializeSettings.sensitive ? this.serializedSensitiveState : this.serializedState
|
|
182
|
-
|
|
183
|
-
// set the value
|
|
184
|
-
targetState[name as KeyOfString<TStorageValue>] = value ?? ''
|
|
185
|
-
|
|
186
|
-
// add a timestamp
|
|
187
|
-
const payloadWithTimestamp = targetState as PayloadWithTimestamp
|
|
188
|
-
payloadWithTimestamp.timestamp = Date.now()
|
|
189
|
-
|
|
190
|
-
// serialize the value
|
|
191
|
-
this.serializeValues(targetStorage, targetState as TStorageValue)
|
|
192
|
-
}
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
// listen for value changes
|
|
196
|
-
control.on('valueChanged', listener)
|
|
197
|
-
|
|
198
|
-
// store the listener for later removal
|
|
199
|
-
this.serializeListeners[name] = listener
|
|
200
|
-
}
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
private serializeValues(storage?: FormGroupStorage<TStorageValue>, values?: TStorageValue) {
|
|
204
|
-
if (storage && values) {
|
|
205
|
-
const write = async () => await storage.insert(values)
|
|
206
|
-
const clear = async () => await storage.clear()
|
|
207
|
-
|
|
208
|
-
forget(clear())
|
|
209
|
-
forget(write())
|
|
210
|
-
}
|
|
211
|
-
}
|
|
212
|
-
|
|
213
|
-
private setStateValueFromStorage(name: string, control: AbstractControl) {
|
|
214
|
-
const read = async () => {
|
|
215
|
-
const savedValue = await this.getSerializedValue(name, control.serializeSettings.sensitive)
|
|
216
|
-
|
|
217
|
-
if (savedValue) {
|
|
218
|
-
const targetState = control.serializeSettings.sensitive ? this.serializedSensitiveState : this.serializedState
|
|
219
|
-
targetState[name as KeyOfString<TStorageValue>] = savedValue
|
|
220
|
-
|
|
221
|
-
control.setValue(savedValue, { disableEmit: true })
|
|
222
|
-
}
|
|
223
|
-
}
|
|
224
|
-
|
|
225
|
-
forget(read())
|
|
226
|
-
}
|
|
227
|
-
}
|
package/src/InputError.ts
DELETED
package/src/context/Context.ts
DELETED
package/src/context/Provider.tsx
DELETED
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
import type { Payload } from '@xyo-network/payload-model'
|
|
2
|
-
import type { PropsWithChildren } from 'react'
|
|
3
|
-
import React, { useMemo } from 'react'
|
|
4
|
-
|
|
5
|
-
import type { FormGroupParams } from '../FormGroup.ts'
|
|
6
|
-
import { FormGroup } from '../FormGroup.ts'
|
|
7
|
-
import { FormGroupBaseContext } from './Context.ts'
|
|
8
|
-
import type { FormGroupContextWithPayloadState } from './State.ts'
|
|
9
|
-
|
|
10
|
-
export interface FormGroupPayloadProviderProps<TStorage extends Payload = Payload> extends PropsWithChildren {
|
|
11
|
-
params?: FormGroupParams<TStorage>
|
|
12
|
-
}
|
|
13
|
-
|
|
14
|
-
/**
|
|
15
|
-
* Provides a FormGroup to child components.
|
|
16
|
-
*/
|
|
17
|
-
export const FormGroupPayloadProvider = ({
|
|
18
|
-
children, params, ...props
|
|
19
|
-
}: FormGroupPayloadProviderProps) => {
|
|
20
|
-
const formGroup = useMemo(() => {
|
|
21
|
-
const formGroup = new FormGroup<Payload, Payload>(params)
|
|
22
|
-
return formGroup
|
|
23
|
-
}, [params])
|
|
24
|
-
|
|
25
|
-
const value: FormGroupContextWithPayloadState = useMemo(() => ({ formGroup, provided: true }), [formGroup])
|
|
26
|
-
|
|
27
|
-
return (
|
|
28
|
-
|
|
29
|
-
<FormGroupBaseContext
|
|
30
|
-
value={value}
|
|
31
|
-
{...props}
|
|
32
|
-
>
|
|
33
|
-
{children}
|
|
34
|
-
</FormGroupBaseContext>
|
|
35
|
-
)
|
|
36
|
-
}
|
package/src/context/State.ts
DELETED
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
import type { ContextExState } from '@xylabs/react-shared'
|
|
2
|
-
import type { Payload } from '@xyo-network/payload-model'
|
|
3
|
-
|
|
4
|
-
import type { FormGroup } from '../FormGroup.ts'
|
|
5
|
-
|
|
6
|
-
export type FormGroupContextWithPayloadState<TValue extends Payload = Payload, TStorageValue extends Payload = Payload> = ContextExState<{
|
|
7
|
-
formGroup?: FormGroup<TValue, TStorageValue>
|
|
8
|
-
}>
|
package/src/context/index.ts
DELETED