@xyo-network/react-form-group 4.4.10 → 5.0.0-rc.1

package/dist/browser/index.mjs

@@ -483,7 +483,7 @@ var FormGroupPayloadProvider = /* @__PURE__ */ __name(({ children, params, ...pr
   }), [
     formGroup
   ]);
-  return /* @__PURE__ */ React.createElement(FormGroupBaseContext.Provider, {
+  return /* @__PURE__ */ React.createElement(FormGroupBaseContext, {
     value,
     ...props
   }, children);

package/dist/browser/index.mjs.map

@@ -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 '@xyo-network/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'\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 = useMemo(() => ({ formGroup, provided: true }), [formGroup])\n\n  return (\n\n    <FormGroupBaseContext.Provider\n      value={value}\n      {...props}\n    >\n      {children}\n    </FormGroupBaseContext.Provider>\n  )\n}\n","import { forget } from '@xylabs/forget'\nimport type { EventListener } from '@xyo-network/module-events'\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 serializeListeners: Record<string, ValueChangeEventListener> = {}\n\n  private serializedSensitiveState = {} as Record<KeyOfString<TStorageValue>, string>\n  private serializedState = {} as Record<KeyOfString<TStorageValue>, string>\n\n  constructor(private fgParams?: FormGroupParams<TStorageValue>) {\n    super()\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      if (!storage) {\n        console.warn(`Cannot return value for ${name}. No storage set`)\n        return\n      }\n\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    }\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/forget'\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 { forget } from '@xylabs/forget'\nimport type { BaseParams } from '@xylabs/object'\nimport { BaseEmitter } 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 BaseEmitter<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  constructor(private config: ControlValueAccessorBaseConfig) {\n    super({})\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/object'\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 = unmasked.match(this.pattern)\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 '@xyo-network/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  constructor(private archivist: ArchivistInstance) {}\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","BaseEmitter","DefaultSetOptions","disableEmit","ControlValueAccessorBase","BaseEmitter","_error","_previousValue","_serializeSettings","_touched","_value","constructor","config","undefined","sensitive","serializable","onChange","_","onErrorChange","onTouched","_isTouched","error","previousValue","serializeSettings","touched","value","registerOnChange","fn","registerOnErrorChange","registerOnTouched","setTouched","isTouched","disableEvents","emit","forget","setValue","options","normalizedValue","setError","setPreviousValue","setSerializeSettings","settings","VALID","INVALID","PENDING","DISABLED","AbstractControl","ControlValueAccessorBase","_status","undefined","constructor","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","constructor","name","rawValue","unmask","value","onCursorChange","setValue","setOptions","unmasked","match","mask","getCursorPosition","newCursor","previousValue","changeError","validate","normalizedValue","blurError","error","setName","FormGroup","AbstractControl","_controls","serializeListeners","serializedSensitiveState","serializedState","constructor","fgParams","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","console","warn","savedState","get","savedValue","savedStateWithTimestamp","timestamp","ttlStorage","expirationDate","now","Date","undefined","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","Provider","useContextEx","useFormGroup","required","useContextEx","FormGroupBaseContext","ArchivistFormGroupStorage","constructor","archivist","clear","get","all","at","insert","value"]}
+{"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 '@xyo-network/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'\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 = 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 { forget } from '@xylabs/forget'\nimport type { EventListener } from '@xyo-network/module-events'\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 serializeListeners: Record<string, ValueChangeEventListener> = {}\n\n  private serializedSensitiveState = {} as Record<KeyOfString<TStorageValue>, string>\n  private serializedState = {} as Record<KeyOfString<TStorageValue>, string>\n\n  constructor(private fgParams?: FormGroupParams<TStorageValue>) {\n    super()\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      if (!storage) {\n        console.warn(`Cannot return value for ${name}. No storage set`)\n        return\n      }\n\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    }\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/forget'\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 { forget } from '@xylabs/forget'\nimport type { BaseParams } from '@xylabs/object'\nimport { BaseEmitter } 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 BaseEmitter<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  constructor(private config: ControlValueAccessorBaseConfig) {\n    super({})\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/object'\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 = unmasked.match(this.pattern)\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 '@xyo-network/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  constructor(private archivist: ArchivistInstance) {}\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","BaseEmitter","DefaultSetOptions","disableEmit","ControlValueAccessorBase","BaseEmitter","_error","_previousValue","_serializeSettings","_touched","_value","constructor","config","undefined","sensitive","serializable","onChange","_","onErrorChange","onTouched","_isTouched","error","previousValue","serializeSettings","touched","value","registerOnChange","fn","registerOnErrorChange","registerOnTouched","setTouched","isTouched","disableEvents","emit","forget","setValue","options","normalizedValue","setError","setPreviousValue","setSerializeSettings","settings","VALID","INVALID","PENDING","DISABLED","AbstractControl","ControlValueAccessorBase","_status","undefined","constructor","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","constructor","name","rawValue","unmask","value","onCursorChange","setValue","setOptions","unmasked","match","mask","getCursorPosition","newCursor","previousValue","changeError","validate","normalizedValue","blurError","error","setName","FormGroup","AbstractControl","_controls","serializeListeners","serializedSensitiveState","serializedState","constructor","fgParams","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","console","warn","savedState","get","savedValue","savedStateWithTimestamp","timestamp","ttlStorage","expirationDate","now","Date","undefined","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","constructor","archivist","clear","get","all","at","insert","value"]}

package/dist/types/FormGroup.d.ts

@@ -0,0 +1,49 @@
+import type { Payload } from '@xyo-network/payload-model';
+import { AbstractControl } from './control/index.ts';
+import type { ErrorSummary } from './InputError.ts';
+import type { FormGroupStorage } from './storage/index.ts';
+export type PayloadWithTimestamp = Payload<{
+    timestamp?: number;
+}>;
+export type KeyOfString<T> = keyof T extends string ? keyof T : never;
+type FormGroupErrors<TValue> = Record<KeyOfString<TValue>, string>;
+export type FormGroupParams<TStorageValue extends Payload = Payload> = {
+    serialize?: boolean;
+    storage?: {
+        sensitive?: FormGroupStorage<TStorageValue>;
+        storage?: FormGroupStorage<TStorageValue>;
+    };
+    ttlStorage?: number;
+};
+/**
+ * Organize form controls in a group.
+ *
+ * NOTE: This is a work in progress and only supports top level controls.  Nested controls are not supported.
+ */
+export declare class FormGroup<TValue extends PayloadWithTimestamp = PayloadWithTimestamp, TStorageValue extends PayloadWithTimestamp = PayloadWithTimestamp> extends AbstractControl {
+    private fgParams?;
+    private _controls;
+    private serializeListeners;
+    private serializedSensitiveState;
+    private serializedState;
+    constructor(fgParams?: FormGroupParams<TStorageValue> | undefined);
+    get errorSummary(): ErrorSummary;
+    get errors(): FormGroupErrors<TValue>;
+    get nonSensitiveStorage(): FormGroupStorage<TStorageValue> | undefined;
+    get sensitiveStorage(): FormGroupStorage<TStorageValue> | undefined;
+    get touched(): boolean;
+    get valid(): boolean;
+    get values(): TValue;
+    getControl(name: string): Record<KeyOfString<TValue>, AbstractControl<import("./control/index.ts").ValidControlValue>>[KeyOfString<TValue>];
+    getSerializedValue(name: string, sensitive?: boolean): Promise<string | undefined>;
+    registerControl(name: string, control: AbstractControl): void;
+    resetControls(): void;
+    resetValues(): void;
+    unregisterControl(name: string): void;
+    validateFields(requiredFields?: string[] | undefined): void;
+    private serializeControlValue;
+    private serializeValues;
+    private setStateValueFromStorage;
+}
+export {};
+//# sourceMappingURL=FormGroup.d.ts.map

package/dist/types/FormGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormGroup.d.ts","sourceRoot":"","sources":["../../src/FormGroup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAGzD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAElE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,GAAG,KAAK,CAAA;AAErE,KAAK,eAAe,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAA;AAElE,MAAM,MAAM,eAAe,CAAC,aAAa,SAAS,OAAO,GAAG,OAAO,IAAI;IACrE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;QAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAA;KAC1C,CAAA;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAID;;;;GAIG;AACH,qBAAa,SAAS,CACpB,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,aAAa,SAAS,oBAAoB,GAAG,oBAAoB,CACjE,SAAQ,eAAe;IAQX,OAAO,CAAC,QAAQ,CAAC;IAP7B,OAAO,CAAC,SAAS,CAAqD;IAEtE,OAAO,CAAC,kBAAkB,CAA+C;IAEzE,OAAO,CAAC,wBAAwB,CAAmD;IACnF,OAAO,CAAC,eAAe,CAAmD;gBAEtD,QAAQ,CAAC,EAAE,eAAe,CAAC,aAAa,CAAC,YAAA;IAI7D,IAAI,YAAY,iBAaf;IAED,IAAI,MAAM,IAAI,eAAe,CAAC,MAAM,CAAC,CAOpC;IAED,IAAI,mBAAmB,gDAEtB;IAED,IAAI,gBAAgB,gDAEnB;IAED,IAAa,OAAO,YAEnB;IAED,IAAa,KAAK,YAEjB;IAED,IAAI,MAAM,IAAI,MAAM,CAOnB;IAED,UAAU,CAAC,IAAI,EAAE,MAAM;IAIjB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAwBtF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;IAMtD,aAAa;IAMb,WAAW;IAMX,iBAAiB,CAAC,IAAI,EAAE,MAAM;IAW9B,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS;IAWpD,OAAO,CAAC,qBAAqB;IAuC7B,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,wBAAwB;CAcjC"}

package/dist/types/InputError.d.ts

@@ -0,0 +1,5 @@
+export type ErrorSummary = {
+    errorMessage: string;
+    invalidFields: string[];
+};
+//# sourceMappingURL=InputError.d.ts.map

package/dist/types/InputError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputError.d.ts","sourceRoot":"","sources":["../../src/InputError.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB,CAAA"}

package/dist/types/context/Context.d.ts

@@ -0,0 +1,3 @@
+import type { FormGroupContextWithPayloadState } from './State.ts';
+export declare const FormGroupBaseContext: import("react").Context<FormGroupContextWithPayloadState<import("@xyo-network/payload-model").Payload, import("@xyo-network/payload-model").Payload> & import("@xyo-network/react-shared").ContextExState>;
+//# sourceMappingURL=Context.d.ts.map

package/dist/types/context/Context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/context/Context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,YAAY,CAAA;AAElE,eAAO,MAAM,oBAAoB,4MAAsD,CAAA"}

package/dist/types/context/Provider.d.ts

@@ -0,0 +1,11 @@
+import type { Payload } from '@xyo-network/payload-model';
+import type { PropsWithChildren } from 'react';
+import type { FormGroupParams } from '../FormGroup.ts';
+export interface FormGroupPayloadProviderProps<TStorage extends Payload = Payload> extends PropsWithChildren {
+    params?: FormGroupParams<TStorage>;
+}
+/**
+ * Provides a FormGroup to child components.
+ */
+export declare const FormGroupPayloadProvider: ({ children, params, ...props }: FormGroupPayloadProviderProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Provider.d.ts.map

package/dist/types/context/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../src/context/Provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAG9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAItD,MAAM,WAAW,6BAA6B,CAAC,QAAQ,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,iBAAiB;IAC1G,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,gCAEtC,6BAA6B,4CAiB/B,CAAA"}

package/dist/types/context/State.d.ts

@@ -0,0 +1,7 @@
+import type { Payload } from '@xyo-network/payload-model';
+import type { ContextExState } from '@xyo-network/react-shared';
+import type { FormGroup } from '../FormGroup.ts';
+export interface FormGroupContextWithPayloadState<TValue extends Payload = Payload, TStorageValue extends Payload = Payload> extends ContextExState {
+    formGroup?: FormGroup<TValue, TStorageValue>;
+}
+//# sourceMappingURL=State.d.ts.map

package/dist/types/context/State.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"State.d.ts","sourceRoot":"","sources":["../../../src/context/State.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,MAAM,WAAW,gCAAgC,CAAC,MAAM,SAAS,OAAO,GAAG,OAAO,EAAE,aAAa,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,cAAc;IACjJ,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;CAC7C"}

package/dist/types/context/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Context.ts';
+export * from './Provider.tsx';
+export * from './State.ts';
+export * from './use.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA"}

package/dist/types/context/use.d.ts

@@ -0,0 +1,2 @@
+export declare const useFormGroup: (required?: boolean) => Omit<import("./State.ts").FormGroupContextWithPayloadState<import("@xyo-network/payload-model").Payload, import("@xyo-network/payload-model").Payload> & import("@xyo-network/react-shared").ContextExState, "provided">;
+//# sourceMappingURL=use.d.ts.map

package/dist/types/context/use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.d.ts","sourceRoot":"","sources":["../../../src/context/use.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,GAAI,kBAAgB,6NAA8D,CAAA"}

package/dist/types/control/AbstractControl.d.ts

@@ -0,0 +1,74 @@
+import type { ControlValueAccessorBaseEvents, FormControlStatus, ValidControlValue } from './accessor/index.ts';
+import { ControlValueAccessorBase } from './accessor/index.ts';
+export type AbstractControlEvents<TValue> = ControlValueAccessorBaseEvents<TValue> & {
+    statusChanged: {
+        status: FormControlStatus;
+    };
+};
+/**
+ * This is the base class for `Control` classes (i.e. FormControl),
+ *
+ * It provides some of the shared behavior that all controls and groups of controls have, like
+ * running validators, calculating status, and resetting state. It also defines the properties
+ * that are shared between all sub-classes, like `value`, `valid`, and `dirty`. It shouldn't be
+ * instantiated directly.
+ *
+ * NOTE: Heavily borrowed from Angular's AbstractControl:
+ * https://github.com/angular/angular/blob/5dcdbfcba934a930468aec140a7183b034466bdf/packages/forms/src/model/abstract_model.ts
+ */
+export declare class AbstractControl<TValue extends ValidControlValue = ValidControlValue> extends ControlValueAccessorBase<TValue, AbstractControlEvents<TValue>> {
+    private _status;
+    constructor();
+    /**
+     * A control is `disabled` when its `status` is `DISABLED`.
+     *
+     * Disabled controls are exempt from validation checks and
+     * are not included in the aggregate value of their ancestor
+     * controls.
+     *
+     * @returns True if the control is disabled, false otherwise.
+     */
+    /** @deprecated - disabled functionality not implemented */
+    get disabled(): boolean;
+    /**
+     * A control is `enabled` as long as its `status` is not `DISABLED`.
+     *
+     * @returns True if the control has any status other than 'DISABLED',
+     * false if the status is 'DISABLED'.
+     */
+    get enabled(): boolean;
+    /**
+     * A control is `invalid` when its `status` is `INVALID`.
+  
+     *
+     * @returns True if this control has failed one or more of its validation checks,
+     * false otherwise.
+     */
+    get invalid(): boolean;
+    /**
+     * A control is `pending` when its `status` is `PENDING`.
+     *
+     * @returns True if this control is in the process of conducting a validation check,
+     * false otherwise.
+     */
+    get pending(): boolean;
+    /**
+     * The raw value of the control.
+     */
+    get rawValue(): TValue;
+    /**
+     * The current status of the control.
+     */
+    get status(): FormControlStatus | undefined;
+    /**
+     * A control is `valid` when its `status` is `VALID`.
+     *
+     * @returns True if the control has passed all of its validation tests,
+     * false otherwise.
+     */
+    get valid(): boolean;
+    setErrorAndValidity(error: string, status: FormControlStatus): void;
+    setStatus(status: FormControlStatus): void;
+    validate(): boolean;
+}
+//# sourceMappingURL=AbstractControl.d.ts.map

package/dist/types/control/AbstractControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractControl.d.ts","sourceRoot":"","sources":["../../../src/control/AbstractControl.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,8BAA8B,EAC9B,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,wBAAwB,EAKzB,MAAM,qBAAqB,CAAA;AAE5B,MAAM,MAAM,qBAAqB,CAAC,MAAM,IAAI,8BAA8B,CAAC,MAAM,CAAC,GAAG;IACnF,aAAa,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAA;KAAE,CAAA;CAC7C,CAAA;AAED;;;;;;;;;;GAUG;AACH,qBAAa,eAAe,CAAC,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,SAAQ,wBAAwB,CACjH,MAAM,EACN,qBAAqB,CAAC,MAAM,CAAC,CAC9B;IACC,OAAO,CAAC,OAAO,CAA2C;;IAM1D;;;;;;;;OAQG;IACH,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;OAKG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;OAMG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,MAAM,kCAET;IAED;;;;;OAKG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB;IAK5D,SAAS,CAAC,MAAM,EAAE,iBAAiB;IASnC,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/types/control/FormControl.d.ts

@@ -0,0 +1,25 @@
+import type { EmptyObject } from '@xylabs/object';
+import type { AbstractControl } from './AbstractControl.ts';
+export type CursorPosition = {
+    current: number | undefined;
+    previous: number | undefined;
+};
+export interface FormControlValidator {
+    blurError?: (value: string) => void;
+    changeError?: (value: string) => void;
+    pattern?: RegExp;
+    patternStrict?: RegExp;
+    required?: boolean;
+}
+export interface FormControlMask {
+    cursorPosition: CursorPosition;
+    getCursorPosition?: () => number | undefined;
+    mask?: (value: string) => string;
+    onCursorChange?: (cursor: number | undefined) => void;
+    unmask?: (value: string) => string;
+}
+export interface FormControl<TProps extends EmptyObject = EmptyObject> extends FormControlValidator, FormControlMask, AbstractControl {
+    readonly name?: string;
+    props: TProps;
+}
+//# sourceMappingURL=FormControl.d.ts.map

package/dist/types/control/FormControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormControl.d.ts","sourceRoot":"","sources":["../../../src/control/FormControl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAC7B,CAAA;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAErC,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,cAAc,CAAA;IAC9B,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAC5C,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAChC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACrD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,WAAW,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,oBAAoB,EAAE,eAAe,EAAE,eAAe;IACnI,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;CACd"}

package/dist/types/control/FormControlBase.d.ts

@@ -0,0 +1,32 @@
+import type { EmptyObject } from '@xylabs/object';
+import { AbstractControl } from './AbstractControl.ts';
+import type { SetOptions } from './accessor/index.ts';
+import type { CursorPosition, FormControl } from './FormControl.ts';
+/**
+ * A base class for form controls and their validation.
+ */
+export declare abstract class FormControlBase<TProps extends EmptyObject = EmptyObject> extends AbstractControl implements FormControl {
+    /**
+     * The current and previous cursor position of the input element.
+     */
+    cursorPosition: CursorPosition;
+    invalidMessage: string;
+    pattern: RegExp;
+    patternStrict: RegExp;
+    props: TProps;
+    required: boolean;
+    private _name;
+    constructor();
+    get name(): string | undefined;
+    get rawValue(): import("./accessor/ValidControlValue.ts").ValidControlValue;
+    blurError?(value: string): void | undefined;
+    changeError?(value: string): void;
+    getCursorPosition?(): number | undefined;
+    mask?(value: string): string;
+    onCursorChange: (cursor: number | undefined) => void;
+    setValue(value: string | undefined, setOptions: SetOptions): void;
+    unmask?(value: string): string;
+    validate(): boolean;
+    protected setName(name: string | undefined): void;
+}
+//# sourceMappingURL=FormControlBase.d.ts.map

package/dist/types/control/FormControlBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormControlBase.d.ts","sourceRoot":"","sources":["../../../src/control/FormControlBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAInE;;GAEG;AACH,8BAAsB,eAAe,CAAC,MAAM,SAAS,WAAW,GAAG,WAAW,CAAE,SAAQ,eAAgB,YAAW,WAAW;IAC5H;;OAEG;IACH,cAAc,EAAE,cAAc,CAA8C;IAE5E,cAAc,SAAkB;IAChC,OAAO,SAAgB;IACvB,aAAa,SAAgB;IAC7B,KAAK,EAAS,MAAM,CAAA;IACpB,QAAQ,UAAQ;IAEhB,OAAO,CAAC,KAAK,CAAgC;;IAM7C,IAAI,IAAI,uBAEP;IAED,IAAa,QAAQ,gEAEpB;IAED,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAC3C,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IACjC,iBAAiB,CAAC,IAAI,MAAM,GAAG,SAAS;IACxC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAW;IAEtD,QAAQ,CAAC,KAAK,EAAE,MAAM,YAAK,EAAE,UAAU,EAAE,UAAU;IA0B5D,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAGrB,QAAQ,IAAI,OAAO;IAQ5B,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;CAG3C"}

package/dist/types/control/accessor/ControlValueAccessor.d.ts

@@ -0,0 +1,21 @@
+import type { ValidControlValue } from './ValidControlValue.ts';
+export interface SetOptions {
+    disableEmit?: boolean;
+}
+export interface ControlSerializeSettings {
+    sensitive?: boolean;
+    serializable?: boolean;
+}
+export interface ControlValueAccessor<T = ValidControlValue> {
+    readonly error: string;
+    readonly previousValue: T;
+    readonly serializeSettings: ControlSerializeSettings;
+    readonly touched: boolean;
+    readonly value: T;
+    registerOnChange(fn: (value: T) => void): void;
+    registerOnErrorChange(fn: (error: string) => void): void;
+    registerOnTouched(fn: (isTouched: boolean) => void): void;
+    setTouched(isTouched: boolean): void;
+    setValue(fieldValue: T, options?: SetOptions): void;
+}
+//# sourceMappingURL=ControlValueAccessor.d.ts.map

package/dist/types/control/accessor/ControlValueAccessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlValueAccessor.d.ts","sourceRoot":"","sources":["../../../../src/control/accessor/ControlValueAccessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE/D,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,iBAAiB;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAA;IACzB,QAAQ,CAAC,iBAAiB,EAAE,wBAAwB,CAAA;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,gBAAgB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAA;IAC9C,qBAAqB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IACxD,iBAAiB,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IACzD,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAA;CACpD"}

package/dist/types/control/accessor/ControlValueAccessorBase.d.ts

@@ -0,0 +1,109 @@
+import type { BaseParams } from '@xylabs/object';
+import { BaseEmitter } from '@xyo-network/module-event-emitter';
+import type { ControlSerializeSettings, ControlValueAccessor, SetOptions } from './ControlValueAccessor.ts';
+import type { ValidControlValue } from './ValidControlValue.ts';
+export type ControlValueAccessorBaseConfig = {
+    disableEvents?: boolean;
+};
+export declare const DefaultSetOptions: SetOptions;
+export type ControlValueAccessorBaseEvents<TValue = ValidControlValue> = {
+    errorChanged: {
+        error: string;
+    };
+    touchChanged: {
+        touched: boolean;
+    };
+    valueChanged: {
+        value: TValue;
+    };
+};
+/**
+ * The base class for control value accessors interface
+ */
+export declare class ControlValueAccessorBase<TValue = ValidControlValue, TEventData extends ControlValueAccessorBaseEvents<TValue> = ControlValueAccessorBaseEvents<TValue>> extends BaseEmitter<BaseParams, TEventData> implements ControlValueAccessor<TValue> {
+    private config;
+    private _error;
+    private _previousValue;
+    private _serializeSettings;
+    private _touched;
+    private _value;
+    constructor(config: ControlValueAccessorBaseConfig);
+    /**
+     * The error message for the control.
+     */
+    get error(): string;
+    /**
+     * The "previous value" of the input element.
+     */
+    get previousValue(): TValue;
+    /**
+     * The serialize settings of the input element.
+     */
+    get serializeSettings(): ControlSerializeSettings;
+    /**
+     * The "touched" state of the input element.
+     */
+    get touched(): boolean;
+    /**
+     * The current value of the input element.
+     */
+    get value(): TValue;
+    /**
+     * The registered callback function called when a change or input event occurs on the input
+     * element.
+     */
+    onChange: (_: TValue) => void;
+    /**
+     * Registers a function called when the control error changes.
+     */
+    onErrorChange: (error: string) => void;
+    /**
+     * The registered callback function called when a blur event occurs on the input element.
+     */
+    onTouched: (_isTouched: boolean) => void;
+    /**
+     * Registers a function called when the control value changes.
+     * @param  {(_value:ValidControlValue)=>void} fn
+     * @returns void
+     */
+    registerOnChange(fn: (_value: TValue) => void): void;
+    /**
+     * Registers a function called when the control error changes.
+     * @param  {(error:string)=>void} fn
+     */
+    registerOnErrorChange(fn: (error: string) => void): void;
+    /**
+     * Registers a function called when the control is touched.
+     * @param  {(isTouched:boolean)=>void} fn
+     * @returns void
+     */
+    registerOnTouched(fn: (isTouched: boolean) => void): void;
+    /**
+     * Sets the "touched" state of the input element.
+     * @param  {boolean} isTouched
+     */
+    setTouched(isTouched: boolean): void;
+    /**
+     * Sets the "value" property on the input element.
+     * @param  {ValidControlValue} value
+     * @returns void
+     */
+    setValue(value: TValue, options?: SetOptions): void;
+    /**
+     * Set the error message for the control.
+     * @param  {string} error
+     */
+    protected setError(error: string): void;
+    /**
+     * Sets the "previous value" of the input element.
+     * @param  {ValidControlValue} value
+     * @returns void
+     */
+    protected setPreviousValue(value: TValue): void;
+    /**
+     * Sets the serialize settings  of the input element.
+     * @param  {ControlSerializeSettings} settings
+     */
+    protected setSerializeSettings(settings: ControlSerializeSettings): void;
+}
+//# sourceMappingURL=ControlValueAccessorBase.d.ts.map

package/dist/types/control/accessor/ControlValueAccessorBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ControlValueAccessorBase.d.ts","sourceRoot":"","sources":["../../../../src/control/accessor/ControlValueAccessorBase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAE/D,OAAO,KAAK,EACV,wBAAwB,EAAE,oBAAoB,EAAE,UAAU,EAC3D,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE/D,MAAM,MAAM,8BAA8B,GAAG;IAC3C,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,iBAAiB,EAAE,UAAmC,CAAA;AAEnE,MAAM,MAAM,8BAA8B,CAAC,MAAM,GAAG,iBAAiB,IAAI;IACvE,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/B,YAAY,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAClC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAChC,CAAA;AAED;;GAEG;AACH,qBAAa,wBAAwB,CACnC,MAAM,GAAG,iBAAiB,EAC1B,UAAU,SAAS,8BAA8B,CAAC,MAAM,CAAC,GAAG,8BAA8B,CAAC,MAAM,CAAC,CAElG,SAAQ,WAAW,CAAC,UAAU,EAAE,UAAU,CAC1C,YAAW,oBAAoB,CAAC,MAAM,CAAC;IAW3B,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,MAAM,CAAa;IAE3B,OAAO,CAAC,cAAc,CAAsB;IAE5C,OAAO,CAAC,kBAAkB,CAAsE;IAEhG,OAAO,CAAC,QAAQ,CAAiB;IAEjC,OAAO,CAAC,MAAM,CAAsB;gBAEhB,MAAM,EAAE,8BAA8B;IAI1D;;OAEG;IACH,IAAI,KAAK,WAER;IAED;;OAEG;IACH,IAAI,aAAa,WAEhB;IAED;;OAEG;IACH,IAAI,iBAAiB,6BAEpB;IAED;;OAEG;IACH,IAAI,OAAO,YAEV;IAED;;OAEG;IACH,IAAI,KAAK,WAER;IAED;;;OAGG;IACH,QAAQ,GAAI,GAAG,MAAM,UAAO;IAE5B;;OAEG;IACH,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAW;IAEjD;;OAEG;IACH,SAAS,GAAI,YAAY,OAAO,UAAO;IAEvC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIpD;;;OAGG;IACH,qBAAqB,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI;IAIjD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIzD;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,OAAO;IAW7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,aAAoB,GAAG,IAAI;IAe1D;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM;IAWhC;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI/C;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB;CAGlE"}

package/dist/types/control/accessor/FormControlStatus.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Reports that a control is valid, meaning that no errors exist in the input value.
+ */
+export declare const VALID: "VALID";
+/**
+ * Reports that a control is invalid, meaning that an error exists in the input value.
+ */
+export declare const INVALID: "INVALID";
+/**
+ * Reports that a control is pending, meaning that async validation is occurring and
+ * errors are not yet available for the input value.
+ */
+export declare const PENDING: "PENDING";
+/**
+ * Reports that a control is disabled, meaning that the control is exempt from ancestor
+ * calculations of validity or value.
+ */
+export declare const DISABLED: "DISABLED";
+/**
+ * A control can have several different statuses. Each
+ * possible status is returned as a string literal.
+ *
+ * * **VALID**: Reports that a control is valid, meaning that no errors exist in the input
+ * value.
+ * * **INVALID**: Reports that a control is invalid, meaning that an error exists in the input
+ * value.
+ * * **PENDING**: Reports that a control is pending, meaning that async validation is
+ * occurring and errors are not yet available for the input value.
+ * * **DISABLED**: Reports that a control is
+ * disabled, meaning that the control is exempt from ancestor calculations of validity or value.
+ */
+export type FormControlStatus = typeof VALID | typeof INVALID | typeof PENDING | typeof DISABLED;
+//# sourceMappingURL=FormControlStatus.d.ts.map

package/dist/types/control/accessor/FormControlStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormControlStatus.d.ts","sourceRoot":"","sources":["../../../../src/control/accessor/FormControlStatus.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,KAAK,EAAG,OAAgB,CAAA;AAErC;;GAEG;AACH,eAAO,MAAM,OAAO,EAAG,SAAkB,CAAA;AAEzC;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAG,SAAkB,CAAA;AAEzC;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAG,UAAmB,CAAA;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,KAAK,GAAG,OAAO,OAAO,GAAG,OAAO,OAAO,GAAG,OAAO,QAAQ,CAAA"}

package/dist/types/control/accessor/ValidControlValue.d.ts

@@ -0,0 +1,2 @@
+export type ValidControlValue = string | undefined;
+//# sourceMappingURL=ValidControlValue.d.ts.map

package/dist/types/control/accessor/ValidControlValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ValidControlValue.d.ts","sourceRoot":"","sources":["../../../../src/control/accessor/ValidControlValue.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAA"}

package/dist/types/control/accessor/index.d.ts

@@ -0,0 +1,5 @@
+export * from './ControlValueAccessor.ts';
+export * from './ControlValueAccessorBase.ts';
+export * from './FormControlStatus.ts';
+export * from './ValidControlValue.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/control/accessor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/control/accessor/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wBAAwB,CAAA;AACtC,cAAc,wBAAwB,CAAA"}

package/dist/types/control/index.d.ts

@@ -0,0 +1,5 @@
+export * from './AbstractControl.ts';
+export * from './accessor/index.ts';
+export * from './FormControl.ts';
+export * from './FormControlBase.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/control/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/control/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+export * from './context/index.ts';
+export * from './control/index.ts';
+export * from './FormGroup.ts';
+export * from './InputError.ts';
+export * from './storage/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA"}

package/dist/types/storage/ArchivistFormGroupStorage.d.ts

@@ -0,0 +1,11 @@
+import type { ArchivistInstance } from '@xyo-network/archivist-model';
+import type { Payload } from '@xyo-network/payload-model';
+import type { FormGroupStorage } from './FormGroupStorage.ts';
+export declare class ArchivistFormGroupStorage implements FormGroupStorage {
+    private archivist;
+    constructor(archivist: ArchivistInstance);
+    clear(): Promise<void>;
+    get(): Promise<import("@xyo-network/payload-model").WithStorageMeta<import("@xyo-network/payload-model").WithStorageMeta<Payload>> | undefined>;
+    insert(value: Payload): Promise<void>;
+}
+//# sourceMappingURL=ArchivistFormGroupStorage.d.ts.map

package/dist/types/storage/ArchivistFormGroupStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchivistFormGroupStorage.d.ts","sourceRoot":"","sources":["../../../src/storage/ArchivistFormGroupStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,qBAAa,yBAA0B,YAAW,gBAAgB;IACpD,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,iBAAiB;IAE1C,KAAK;IAIL,GAAG;IAKH,MAAM,CAAC,KAAK,EAAE,OAAO;CAG5B"}

package/dist/types/storage/FormGroupStorage.d.ts

@@ -0,0 +1,8 @@
+import type { Promisable } from '@xylabs/promise';
+import type { Payload } from '@xyo-network/payload-model';
+export interface FormGroupStorage<TValue extends Payload = Payload> {
+    clear: () => Promisable<void>;
+    get: () => Promisable<TValue | undefined>;
+    insert: (state: TValue) => Promisable<void>;
+}
+//# sourceMappingURL=FormGroupStorage.d.ts.map

package/dist/types/storage/FormGroupStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormGroupStorage.d.ts","sourceRoot":"","sources":["../../../src/storage/FormGroupStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEzD,MAAM,WAAW,gBAAgB,CAAC,MAAM,SAAS,OAAO,GAAG,OAAO;IAChE,KAAK,EAAE,MAAM,UAAU,CAAC,IAAI,CAAC,CAAA;IAC7B,GAAG,EAAE,MAAM,UAAU,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC,IAAI,CAAC,CAAA;CAC5C"}

package/dist/types/storage/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ArchivistFormGroupStorage.ts';
+export * from './FormGroupStorage.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,uBAAuB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/react-form-group",
-  "version": "4.4.10",
+  "version": "5.0.0-rc.1",
   "description": "Common React library for all XYO projects that use React",
   "keywords": [
     "xyo",
@@ -28,10 +28,10 @@
   "exports": {
     ".": {
       "browser": {
-        "types": "./dist/browser/index.d.ts",
+        "types": "./dist/types/index.d.ts",
         "default": "./dist/browser/index.mjs"
       },
-      "types": "./dist/browser/index.d.ts",
+      "types": "./dist/types/index.d.ts",
       "default": "./dist/browser/index.mjs"
     },
     "./package.json": "./package.json"
@@ -43,35 +43,37 @@
     "lint-pkg": "npmPkgJsonLint ."
   },
   "dependencies": {
-    "@mui/icons-material": "^6.4.6",
-    "@xylabs/forget": "^4.5.1",
-    "@xylabs/object": "^4.5.1",
-    "@xylabs/promise": "^4.5.1",
-    "@xyo-network/archivist-model": "^3.9.17",
-    "@xyo-network/module-event-emitter": "^3.9.17",
-    "@xyo-network/module-events": "^3.9.17",
-    "@xyo-network/payload-model": "^3.9.17",
-    "@xyo-network/react-shared": "^4.4.10"
+    "@mui/icons-material": "^6.4.7",
+    "@xylabs/forget": "^4.5.10",
+    "@xylabs/object": "^4.5.10",
+    "@xylabs/promise": "^4.5.10",
+    "@xyo-network/archivist-model": "^3.9.35",
+    "@xyo-network/module-event-emitter": "^3.9.35",
+    "@xyo-network/module-events": "^3.9.35",
+    "@xyo-network/payload-model": "^3.9.35",
+    "@xyo-network/react-shared": "^5.0.0-rc.1"
   },
   "devDependencies": {
-    "@mui/material": "^6.4.6",
-    "@mui/styles": "^6.4.6",
-    "@storybook/react": "^8.6.2",
-    "@xylabs/ts-scripts-yarn3": "^5.0.25",
-    "@xylabs/tsconfig-react": "^5.0.25",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
-    "storybook": "^8.6.2",
-    "typescript": "^5.7.3"
+    "@mui/material": "^6.4.7",
+    "@mui/styles": "^6.4.7",
+    "@storybook/react": "^8.6.4",
+    "@types/react": "^19.0.10",
+    "@xylabs/ts-scripts-yarn3": "^6.0.3",
+    "@xylabs/tsconfig-react": "^6.0.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "storybook": "^8.6.4",
+    "typescript": "^5.8.2"
   },
   "peerDependencies": {
     "@mui/material": "^6",
     "@mui/styles": "^6",
-    "react": "^18",
-    "react-dom": "^18"
+    "react": "^19",
+    "react-dom": "^19"
   },
   "publishConfig": {
     "access": "public"
   },
-  "docs": "dist/docs.json"
+  "docs": "dist/docs.json",
+  "stableVersion": "4.4.11"
 }

package/src/context/Provider.tsx

@@ -25,11 +25,11 @@ export const FormGroupPayloadProvider = ({
 
   return (
 
-    <FormGroupBaseContext.Provider
+    <FormGroupBaseContext
       value={value}
       {...props}
     >
       {children}
-    </FormGroupBaseContext.Provider>
+    </FormGroupBaseContext>
   )
 }

package/dist/browser/index.d.ts

@@ -1,218 +0,0 @@
-import * as react from 'react';
-import { PropsWithChildren } from 'react';
-import * as _xyo_network_react_shared from '@xyo-network/react-shared';
-import { ContextExState } from '@xyo-network/react-shared';
-import * as _xyo_network_payload_model from '@xyo-network/payload-model';
-import { Payload } from '@xyo-network/payload-model';
-import { BaseParams, EmptyObject } from '@xylabs/object';
-import { BaseEmitter } from '@xyo-network/module-event-emitter';
-import { Promisable } from '@xylabs/promise';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ArchivistInstance } from '@xyo-network/archivist-model';
-
-type ValidControlValue = string | undefined;
-
-interface SetOptions {
-    disableEmit?: boolean;
-}
-interface ControlSerializeSettings {
-    sensitive?: boolean;
-    serializable?: boolean;
-}
-interface ControlValueAccessor<T = ValidControlValue> {
-    readonly error: string;
-    readonly previousValue: T;
-    readonly serializeSettings: ControlSerializeSettings;
-    readonly touched: boolean;
-    readonly value: T;
-    registerOnChange(fn: (value: T) => void): void;
-    registerOnErrorChange(fn: (error: string) => void): void;
-    registerOnTouched(fn: (isTouched: boolean) => void): void;
-    setTouched(isTouched: boolean): void;
-    setValue(fieldValue: T, options?: SetOptions): void;
-}
-
-type ControlValueAccessorBaseConfig = {
-    disableEvents?: boolean;
-};
-declare const DefaultSetOptions: SetOptions;
-type ControlValueAccessorBaseEvents<TValue = ValidControlValue> = {
-    errorChanged: {
-        error: string;
-    };
-    touchChanged: {
-        touched: boolean;
-    };
-    valueChanged: {
-        value: TValue;
-    };
-};
-declare class ControlValueAccessorBase<TValue = ValidControlValue, TEventData extends ControlValueAccessorBaseEvents<TValue> = ControlValueAccessorBaseEvents<TValue>> extends BaseEmitter<BaseParams, TEventData> implements ControlValueAccessor<TValue> {
-    private config;
-    private _error;
-    private _previousValue;
-    private _serializeSettings;
-    private _touched;
-    private _value;
-    constructor(config: ControlValueAccessorBaseConfig);
-    get error(): string;
-    get previousValue(): TValue;
-    get serializeSettings(): ControlSerializeSettings;
-    get touched(): boolean;
-    get value(): TValue;
-    onChange: (_: TValue) => void;
-    onErrorChange: (error: string) => void;
-    onTouched: (_isTouched: boolean) => void;
-    registerOnChange(fn: (_value: TValue) => void): void;
-    registerOnErrorChange(fn: (error: string) => void): void;
-    registerOnTouched(fn: (isTouched: boolean) => void): void;
-    setTouched(isTouched: boolean): void;
-    setValue(value: TValue, options?: SetOptions): void;
-    protected setError(error: string): void;
-    protected setPreviousValue(value: TValue): void;
-    protected setSerializeSettings(settings: ControlSerializeSettings): void;
-}
-
-declare const VALID: "VALID";
-declare const INVALID: "INVALID";
-declare const PENDING: "PENDING";
-declare const DISABLED: "DISABLED";
-type FormControlStatus = typeof VALID | typeof INVALID | typeof PENDING | typeof DISABLED;
-
-type AbstractControlEvents<TValue> = ControlValueAccessorBaseEvents<TValue> & {
-    statusChanged: {
-        status: FormControlStatus;
-    };
-};
-declare class AbstractControl<TValue extends ValidControlValue = ValidControlValue> extends ControlValueAccessorBase<TValue, AbstractControlEvents<TValue>> {
-    private _status;
-    constructor();
-    get disabled(): boolean;
-    get enabled(): boolean;
-    get invalid(): boolean;
-    get pending(): boolean;
-    get rawValue(): TValue;
-    get status(): FormControlStatus | undefined;
-    get valid(): boolean;
-    setErrorAndValidity(error: string, status: FormControlStatus): void;
-    setStatus(status: FormControlStatus): void;
-    validate(): boolean;
-}
-
-type CursorPosition = {
-    current: number | undefined;
-    previous: number | undefined;
-};
-interface FormControlValidator {
-    blurError?: (value: string) => void;
-    changeError?: (value: string) => void;
-    pattern?: RegExp;
-    patternStrict?: RegExp;
-    required?: boolean;
-}
-interface FormControlMask {
-    cursorPosition: CursorPosition;
-    getCursorPosition?: () => number | undefined;
-    mask?: (value: string) => string;
-    onCursorChange?: (cursor: number | undefined) => void;
-    unmask?: (value: string) => string;
-}
-interface FormControl<TProps extends EmptyObject = EmptyObject> extends FormControlValidator, FormControlMask, AbstractControl {
-    readonly name?: string;
-    props: TProps;
-}
-
-declare abstract class FormControlBase<TProps extends EmptyObject = EmptyObject> extends AbstractControl implements FormControl {
-    cursorPosition: CursorPosition;
-    invalidMessage: string;
-    pattern: RegExp;
-    patternStrict: RegExp;
-    props: TProps;
-    required: boolean;
-    private _name;
-    constructor();
-    get name(): string | undefined;
-    get rawValue(): ValidControlValue;
-    blurError?(value: string): void | undefined;
-    changeError?(value: string): void;
-    getCursorPosition?(): number | undefined;
-    mask?(value: string): string;
-    onCursorChange: (cursor: number | undefined) => void;
-    setValue(value: string | undefined, setOptions: SetOptions): void;
-    unmask?(value: string): string;
-    validate(): boolean;
-    protected setName(name: string | undefined): void;
-}
-
-type ErrorSummary = {
-    errorMessage: string;
-    invalidFields: string[];
-};
-
-interface FormGroupStorage<TValue extends Payload = Payload> {
-    clear: () => Promisable<void>;
-    get: () => Promisable<TValue | undefined>;
-    insert: (state: TValue) => Promisable<void>;
-}
-
-declare class ArchivistFormGroupStorage implements FormGroupStorage {
-    private archivist;
-    constructor(archivist: ArchivistInstance);
-    clear(): Promise<void>;
-    get(): Promise<_xyo_network_payload_model.WithStorageMeta<_xyo_network_payload_model.WithStorageMeta<Payload>> | undefined>;
-    insert(value: Payload): Promise<void>;
-}
-
-type PayloadWithTimestamp = Payload<{
-    timestamp?: number;
-}>;
-type KeyOfString<T> = keyof T extends string ? keyof T : never;
-type FormGroupErrors<TValue> = Record<KeyOfString<TValue>, string>;
-type FormGroupParams<TStorageValue extends Payload = Payload> = {
-    serialize?: boolean;
-    storage?: {
-        sensitive?: FormGroupStorage<TStorageValue>;
-        storage?: FormGroupStorage<TStorageValue>;
-    };
-    ttlStorage?: number;
-};
-declare class FormGroup<TValue extends PayloadWithTimestamp = PayloadWithTimestamp, TStorageValue extends PayloadWithTimestamp = PayloadWithTimestamp> extends AbstractControl {
-    private fgParams?;
-    private _controls;
-    private serializeListeners;
-    private serializedSensitiveState;
-    private serializedState;
-    constructor(fgParams?: FormGroupParams<TStorageValue> | undefined);
-    get errorSummary(): ErrorSummary;
-    get errors(): FormGroupErrors<TValue>;
-    get nonSensitiveStorage(): FormGroupStorage<TStorageValue> | undefined;
-    get sensitiveStorage(): FormGroupStorage<TStorageValue> | undefined;
-    get touched(): boolean;
-    get valid(): boolean;
-    get values(): TValue;
-    getControl(name: string): Record<KeyOfString<TValue>, AbstractControl<ValidControlValue>>[KeyOfString<TValue>];
-    getSerializedValue(name: string, sensitive?: boolean): Promise<string | undefined>;
-    registerControl(name: string, control: AbstractControl): void;
-    resetControls(): void;
-    resetValues(): void;
-    unregisterControl(name: string): void;
-    validateFields(requiredFields?: string[] | undefined): void;
-    private serializeControlValue;
-    private serializeValues;
-    private setStateValueFromStorage;
-}
-
-interface FormGroupContextWithPayloadState<TValue extends Payload = Payload, TStorageValue extends Payload = Payload> extends ContextExState {
-    formGroup?: FormGroup<TValue, TStorageValue>;
-}
-
-declare const FormGroupBaseContext: react.Context<FormGroupContextWithPayloadState<_xyo_network_payload_model.Payload, _xyo_network_payload_model.Payload> & _xyo_network_react_shared.ContextExState>;
-
-interface FormGroupPayloadProviderProps<TStorage extends Payload = Payload> extends PropsWithChildren {
-    params?: FormGroupParams<TStorage>;
-}
-declare const FormGroupPayloadProvider: ({ children, params, ...props }: FormGroupPayloadProviderProps) => react_jsx_runtime.JSX.Element;
-
-declare const useFormGroup: (required?: boolean) => Omit<FormGroupContextWithPayloadState<_xyo_network_payload_model.Payload, _xyo_network_payload_model.Payload> & _xyo_network_react_shared.ContextExState, "provided">;
-
-export { AbstractControl, type AbstractControlEvents, ArchivistFormGroupStorage, type ControlSerializeSettings, type ControlValueAccessor, ControlValueAccessorBase, type ControlValueAccessorBaseConfig, type ControlValueAccessorBaseEvents, type CursorPosition, DISABLED, DefaultSetOptions, type ErrorSummary, type FormControl, FormControlBase, type FormControlMask, type FormControlStatus, type FormControlValidator, FormGroup, FormGroupBaseContext, type FormGroupContextWithPayloadState, type FormGroupParams, FormGroupPayloadProvider, type FormGroupPayloadProviderProps, type FormGroupStorage, INVALID, type KeyOfString, PENDING, type PayloadWithTimestamp, type SetOptions, VALID, type ValidControlValue, useFormGroup };