@dereekb/dbx-form 13.4.1 → 13.4.2

package/types/dereekb-dbx-form.d.ts

@@ -243,9 +243,13 @@ declare class DbxActionFormDirective<T = object, O = T> implements OnInit {
  * used by {@link DbxActionFormDirective.checkIsValidAndIsModified}.
  */
 interface CheckValidAndModifiedOverrides<T> {
-    /** Override function for the modification check. */
+    /**
+     * Override function for the modification check.
+     */
     isModifiedFunction?: Maybe<IsModifiedFunction<T>>;
-    /** Override function for the validity check. */
+    /**
+     * Override function for the validity check.
+     */
     isValidFunction?: Maybe<IsValidFunction<T>>;
 }
 
@@ -291,6 +295,8 @@ interface DbxFormlyContextDelegate<T = unknown> extends Omit<DbxMutableForm<T>,
 }
 /**
  * Allows a directive to provide a formly context and form.
+ *
+ * @returns An array of Angular providers that register DbxFormlyContext and its mutable form delegate
  */
 declare function provideFormlyContext(): Provider[];
 /**
@@ -395,6 +401,9 @@ declare class DbxFormActionDialogComponent<O> extends AbstractDialogDirective<O,
     ngOnInit(): void;
     /**
      * Action handler that marks the action as successful and closes the dialog with the submitted value.
+     *
+     * @param value - The submitted form value
+     * @param context - The action context used to signal success
      */
     readonly handleSubmitValue: WorkUsingContext<O>;
     /**
@@ -785,7 +794,9 @@ declare class DbxFormSubsectionWrapperComponent extends FieldWrapper<FieldTypeCo
  * Configuration for the info wrapper that adds an info icon button beside the field.
  */
 interface DbxFormInfoConfig extends FormlyFieldProps {
-    /** Callback invoked when the info button is clicked. */
+    /**
+     * Callback invoked when the info button is clicked.
+     */
     readonly onInfoClick: () => void;
 }
 /**
@@ -808,7 +819,9 @@ declare class DbxFormInfoWrapperComponent extends FieldWrapper<FormlyFieldConfig
  * function to determine whether the field's value is "populated" (which auto-expands the section).
  */
 interface AbstractFormExpandSectionConfig<T extends object = object> extends Pick<FormlyFieldProps, 'label'> {
-    /** Label shown on the expand trigger. Falls back to the field label or first child field label. */
+    /**
+     * Label shown on the expand trigger. Falls back to the field label or first child field label.
+     */
     expandLabel?: string;
     /**
      * Optional function to use for checking value existence.
@@ -817,6 +830,11 @@ interface AbstractFormExpandSectionConfig<T extends object = object> extends Pic
 }
 /**
  * Default value existence check that returns `true` if the object is non-empty.
+ *
+ * @param x - The object to check for non-emptiness
+ * @returns True if the object has at least one own property
+ *
+ * @param x - The object to check for non-emptiness
  */
 declare const DEFAULT_HAS_VALUE_FN: (x: object) => boolean;
 /**
@@ -844,14 +862,18 @@ declare class AbstractFormExpandSectionWrapperDirective<T extends object = objec
     static ɵdir: i0.ɵɵDirectiveDeclaration<AbstractFormExpandSectionWrapperDirective<any, any>, never, never, {}, {}, never, never, true, never>;
 }
 
-/** The visual style of the expand button: a styled button or plain text link. */
+/**
+ * The visual style of the expand button: a styled button or plain text link.
+ */
 type DbxFormExpandWrapperButtonType = 'button' | 'text';
 /**
  * Configuration for the expand wrapper, extending the base expand section config
  * with an optional button type.
  */
 interface DbxFormExpandWrapperConfig<T extends object = object> extends AbstractFormExpandSectionConfig<T> {
-    /** Visual style of the expand trigger. Defaults to `'button'`. */
+    /**
+     * Visual style of the expand trigger. Defaults to `'button'`.
+     */
     readonly buttonType?: DbxFormExpandWrapperButtonType;
 }
 /**
@@ -869,7 +891,9 @@ declare class DbxFormExpandWrapperComponent<T extends object = object> extends A
  * reactive label function.
  */
 interface DbxFormToggleWrapperConfig<T extends object = object> extends AbstractFormExpandSectionConfig<T> {
-    /** Optional function that returns an observable of the toggle label based on open state. */
+    /**
+     * Optional function that returns an observable of the toggle label based on open state.
+     */
     toggleLabelObs?: (open: Maybe<boolean>) => Observable<string>;
 }
 /**
@@ -916,7 +940,9 @@ declare class DbxFormFlexWrapperComponent extends FieldWrapper<FormlyFieldConfig
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxFormFlexWrapperComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** A map of CSS style properties to their values, used with `[ngStyle]`. */
+/**
+ * A map of CSS style properties to their values, used with `[ngStyle]`.
+ */
 type DbxFormStyleObject = {
     [styleClass: string]: any;
 };
@@ -924,9 +950,13 @@ type DbxFormStyleObject = {
  * Configuration for the style wrapper that applies dynamic CSS classes and inline styles.
  */
 interface DbxFormStyleWrapperConfig {
-    /** Observable or static value providing inline styles via `[ngStyle]`. */
+    /**
+     * Observable or static value providing inline styles via `[ngStyle]`.
+     */
     styleGetter?: Maybe<ObservableOrValue<DbxFormStyleObject>>;
-    /** Observable or static value providing CSS class names via `[ngClass]`. */
+    /**
+     * Observable or static value providing CSS class names via `[ngClass]`.
+     */
     classGetter?: Maybe<ObservableOrValue<string>>;
 }
 /**
@@ -969,14 +999,18 @@ declare class DbxFormWorkingWrapperComponent extends FieldWrapper<FormlyFieldCon
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxFormWorkingWrapperComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Registers all Formly field wrapper types (section, flex, expand, toggle, style, info, working, autotouch, subsection). */
+/**
+ * Registers all Formly field wrapper types (section, flex, expand, toggle, style, info, working, autotouch, subsection).
+ */
 declare class DbxFormFormlyWrapperModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyWrapperModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyWrapperModule, never, [typeof AutoTouchFieldWrapperComponent, typeof DbxFormSectionWrapperComponent, typeof DbxFormSubsectionWrapperComponent, typeof DbxFormInfoWrapperComponent, typeof DbxFormExpandWrapperComponent, typeof DbxFormToggleWrapperComponent, typeof DbxFormFlexWrapperComponent, typeof DbxFormStyleWrapperComponent, typeof DbxFormWorkingWrapperComponent, typeof _ngx_formly_core.FormlyModule, typeof i1.FormlyMaterialModule, typeof _ngx_formly_core.FormlyModule], [typeof AutoTouchFieldWrapperComponent, typeof DbxFormSectionWrapperComponent, typeof DbxFormSubsectionWrapperComponent, typeof DbxFormInfoWrapperComponent, typeof DbxFormExpandWrapperComponent, typeof DbxFormToggleWrapperComponent, typeof DbxFormFlexWrapperComponent, typeof DbxFormStyleWrapperComponent, typeof DbxFormWorkingWrapperComponent, typeof _ngx_formly_core.FormlyModule, typeof i1.FormlyMaterialModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<DbxFormFormlyWrapperModule>;
 }
 
-/** Registers the `checklistitem` Formly field type with wrapper support. */
+/**
+ * Registers the `checklistitem` Formly field type with wrapper support.
+ */
 declare class DbxFormFormlyChecklistItemFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyChecklistItemFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyChecklistItemFieldModule, never, [typeof DbxChecklistItemFieldComponent, typeof DbxChecklistItemContentComponent, typeof DbxDefaultChecklistItemFieldDisplayComponent, typeof DbxFormFormlyWrapperModule, typeof _ngx_formly_core.FormlyModule], [typeof DbxChecklistItemFieldComponent, typeof DbxChecklistItemContentComponent, typeof DbxDefaultChecklistItemFieldDisplayComponent]>;
@@ -1050,6 +1084,11 @@ interface DescriptionFieldConfig {
 type PartialPotentialFieldConfig = Partial<FieldConfig> & Partial<LabeledFieldConfig> & Partial<AttributesFieldConfig> & Partial<DescriptionFieldConfig>;
 /**
  * Validates the configuration on the input field.
+ *
+ * @param fieldConfig - The Formly field configuration to validate
+ * @returns The validated field configuration
+ *
+ * @param fieldConfig - The Formly field configuration to validate
  */
 declare function formlyField<T extends FormlyFieldConfig = FormlyFieldConfig>(fieldConfig: T): T;
 /**
@@ -1071,13 +1110,21 @@ declare function propsAndConfigForFieldConfig<O extends object = object>(fieldCo
     }) | undefined;
     parsers: ((value: any) => any)[] | undefined;
 };
-/** Keys from {@link PartialPotentialFieldConfig} that are merged into Formly props. */
+/**
+ * Keys from {@link PartialPotentialFieldConfig} that are merged into Formly props.
+ */
 declare const partialPotentialFieldConfigKeys: (keyof PartialPotentialFieldConfig)[];
-/** Filter configuration for extracting field config keys from objects. */
+/**
+ * Filter configuration for extracting field config keys from objects.
+ */
 declare const partialPotentialFieldConfigKeysFilter: FilterKeyValueTuplesInput<PartialPotentialFieldConfig>;
-/** Merge function that combines multiple partial field configs, picking only the recognized keys. */
+/**
+ * Merge function that combines multiple partial field configs, picking only the recognized keys.
+ */
 declare const mergePropsValueObjects: _dereekb_util.MergeObjectsFunction<PartialPotentialFieldConfig>;
-/** Filter function that extracts only the recognized field config keys from an object. */
+/**
+ * Filter function that extracts only the recognized field config keys from an object.
+ */
 declare const filterPartialPotentialFieldConfigValuesFromObject: GeneralFilterFromPOJOFunction<PartialPotentialFieldConfig>;
 /**
  * Builds a Formly props object from a field config and optional overrides.
@@ -1092,6 +1139,8 @@ declare const filterPartialPotentialFieldConfigValuesFromObject: GeneralFilterFr
 declare function propsValueForFieldConfig<T extends FormlyFieldProps, O extends object = object>(fieldConfig: PartialPotentialFieldConfig, override?: PartialPotentialFieldConfig & O): Partial<T> & O;
 /**
  * Returns configuration for a formlyField that will disable autofill/autocomplete for a field.
+ *
+ * @returns An attributes object that disables browser autofill
  */
 declare function disableFormlyFieldAutofillAttributes(): {
     name: string;
@@ -1177,13 +1226,21 @@ type ChecklistItemFieldBuilderInput<T = unknown> = Partial<ChecklistItemFieldCon
  */
 declare function checklistItemField<T = unknown>(config: ChecklistItemFieldBuilderInput<T>): FormlyFieldConfig<DbxChecklistItemFieldProps<T>>;
 
-/** A field key from the data set type, constrained to string keys. */
+/**
+ * A field key from the data set type, constrained to string keys.
+ */
 type ChecklistItemFieldDataSetFieldKey<D> = keyof D & string;
-/** The value type for a specific key in the data set. */
+/**
+ * The value type for a specific key in the data set.
+ */
 type ChecklistItemFieldDataSetFieldValueForKey<D, K extends keyof D = keyof D> = D[K];
-/** Maps all keys of a data type to boolean values, representing a checklist. */
+/**
+ * Maps all keys of a data type to boolean values, representing a checklist.
+ */
 type ChecklistType<D> = KeyValueTransformMap<D, boolean>;
-/** Input for adding a checklist item to the data set builder, combining a key with field builder input. */
+/**
+ * Input for adding a checklist item to the data set builder, combining a key with field builder input.
+ */
 type ChecklistItemFieldDataSetBuilderInput<D, T> = {
     key: ChecklistItemFieldDataSetFieldKey<D>;
 } & ChecklistItemFieldBuilderInput<T>;
@@ -1211,6 +1268,12 @@ declare class ChecklistItemFieldDataSetBuilder<D extends object, C extends Check
      * Merges the input config with existing configuration.
      *
      * The displayContentObs, if provided, will merge with the existing observable and the two objects merged.
+     *
+     * @param key - The key identifying which checklist field to merge into
+     * @param config - Partial configuration to merge with the existing field config
+     *
+     * @param key - The key identifying which checklist field to merge into
+     * @param config - Partial configuration to merge with the existing field config
      */
     merge<T>(key: ChecklistItemFieldDataSetFieldKey<D>, config: Partial<ChecklistItemFieldBuilderInput<T>>): void;
     override<T>(key: ChecklistItemFieldDataSetFieldKey<D>, config: Partial<ChecklistItemFieldBuilderInput<T>>): void;
@@ -1224,9 +1287,13 @@ declare class ChecklistItemFieldDataSetBuilder<D extends object, C extends Check
     contentWithDisplayValueFromData<T extends ChecklistItemFieldDataSetFieldValueForKey<D> = ChecklistItemFieldDataSetFieldValueForKey<D>>(key: ChecklistItemFieldDataSetFieldKey<D>, labelFn?: (value: T) => Maybe<string>): Observable<ChecklistItemDisplayContent<T>>;
 }
 
-/** Configuration for the custom component to inject into the form field. Alias for {@link DbxInjectionComponentConfig}. */
+/**
+ * Configuration for the custom component to inject into the form field. Alias for {@link DbxInjectionComponentConfig}.
+ */
 type DbxFormComponentFieldConfig<T> = DbxInjectionComponentConfig<T>;
-/** Formly field config extended with a {@link DbxFormComponentFieldConfig} for custom component rendering. */
+/**
+ * Formly field config extended with a {@link DbxFormComponentFieldConfig} for custom component rendering.
+ */
 interface DbxFormComponentFormlyFieldConfig<T = unknown> extends FormlyFieldConfig {
     componentField: DbxFormComponentFieldConfig<T>;
 }
@@ -1242,14 +1309,18 @@ declare class DbxFormComponentFieldComponent<T = unknown> extends FieldType<DbxF
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxFormComponentFieldComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Registers the `component` Formly field type for custom Angular component injection. */
+/**
+ * Registers the `component` Formly field type for custom Angular component injection.
+ */
 declare class DbxFormFormlyComponentFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyComponentFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyComponentFieldModule, never, [typeof DbxFormComponentFieldComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxFormComponentFieldComponent]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<DbxFormFormlyComponentFieldModule>;
 }
 
-/** Configuration for a custom Angular component embedded as a Formly field. */
+/**
+ * Configuration for a custom Angular component embedded as a Formly field.
+ */
 type ComponentFieldConfig<T = unknown> = DbxFormComponentFieldConfig<T>;
 /**
  * Creates a Formly field configuration that renders a custom Angular component.
@@ -1341,7 +1412,9 @@ interface DbxListFieldConfig<T = unknown, C extends AbstractDbxSelectionListWrap
  */
 declare function dbxListField<T = unknown, C extends AbstractDbxSelectionListWrapperDirective<T> = AbstractDbxSelectionListWrapperDirective<T>, K extends PrimativeKey = PrimativeKey>(config: DbxListFieldConfig<T, C, K>): FormlyFieldConfig;
 
-/** Registers the `dbxlistfield` Formly field type for item list selection. */
+/**
+ * Registers the `dbxlistfield` Formly field type for item list selection.
+ */
 declare class DbxFormFormlyDbxListFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyDbxListFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyDbxListFieldModule, never, [typeof DbxItemListFieldComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxItemListFieldComponent]>;
@@ -1380,9 +1453,13 @@ interface SelectionDisplayValue<T, M = unknown> extends SelectionValue<T, M>, La
  */
 type SelectionValueHashFunction<T, H extends PrimativeKey = PrimativeKey> = MapFunction<T, H>;
 
-/** A pickable field value wrapping a {@link SelectionValue}. */
+/**
+ * A pickable field value wrapping a {@link SelectionValue}.
+ */
 type PickableValueFieldValue<T, M = unknown> = SelectionValue<T, M>;
-/** A pickable field display value wrapping a {@link SelectionDisplayValue}. */
+/**
+ * A pickable field display value wrapping a {@link SelectionDisplayValue}.
+ */
 type PickableValueFieldDisplayValue<T, M = unknown> = SelectionDisplayValue<T, M>;
 /**
  * PickableValueField function for retrieving all values.
@@ -1410,7 +1487,9 @@ type PickableValueFieldHashFunction<T, H extends PrimativeKey = PrimativeKey> =
  * A list item wrapping a {@link PickableValueFieldDisplayValue} with selection state.
  */
 type PickableItemFieldItem<T, M = unknown> = DbxValueListItem<PickableValueFieldDisplayValue<T, M>>;
-/** Sort function for ordering pickable items before display. */
+/**
+ * Sort function for ordering pickable items before display.
+ */
 type PickableItemFieldItemSortFn<T, M = unknown> = (items: PickableItemFieldItem<T, M>[]) => PickableItemFieldItem<T, M>[];
 /**
  * Formly field properties for configuring a pickable value selection field.
@@ -1649,7 +1728,9 @@ declare class DbxPickableListFieldComponent<T> extends AbstractDbxPickableItemFi
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxPickableListFieldComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Registers the `pickablechipfield` and `pickablelistfield` Formly field types. */
+/**
+ * Registers the `pickablechipfield` and `pickablelistfield` Formly field types.
+ */
 declare class DbxFormFormlyPickableFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyPickableFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyPickableFieldModule, never, [typeof DbxPickableChipListFieldComponent, typeof DbxPickableListFieldComponent, typeof DbxPickableListFieldItemListComponent, typeof DbxPickableListFieldItemListViewComponent, typeof DbxPickableListFieldItemListViewItemComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxPickableChipListFieldComponent, typeof DbxPickableListFieldComponent, typeof DbxPickableListFieldItemListComponent, typeof DbxPickableListFieldItemListViewComponent, typeof DbxPickableListFieldItemListViewItemComponent]>;
@@ -1698,7 +1779,9 @@ declare function pickableItemChipField<T = unknown, M = unknown>(config: Pickabl
  */
 declare function pickableItemListField<T = unknown, M = unknown>(config: PickableItemFieldConfig<T, M>): FormlyFieldConfig;
 
-/** Case-insensitive filter function that matches pickable display values by their label using indexOf. */
+/**
+ * Case-insensitive filter function that matches pickable display values by their label using indexOf.
+ */
 declare const filterPickableItemFieldValuesByLabelFilterFunction: SearchStringFilterFunction<PickableValueFieldDisplayValue<any>>;
 /**
  * Filters pickable display values by label text, returning their underlying values.
@@ -1710,7 +1793,9 @@ declare const filterPickableItemFieldValuesByLabelFilterFunction: SearchStringFi
  * @returns Observable emitting the filtered value array
  */
 declare function filterPickableItemFieldValuesByLabel<T>(filterText: Maybe<string>, values: PickableValueFieldDisplayValue<T>[]): Observable<T[]>;
-/** String sort comparator that orders pickable items alphabetically by label. */
+/**
+ * String sort comparator that orders pickable items alphabetically by label.
+ */
 declare const sortPickableItemsByLabelStringFunction: _dereekb_util.SortByStringFunction<PickableItemFieldItem<any>>;
 /**
  * Sorts pickable items alphabetically by their label.
@@ -1719,9 +1804,13 @@ declare const sortPickableItemsByLabelStringFunction: _dereekb_util.SortByString
  * @returns The sorted array (mutated in place)
  */
 declare function sortPickableItemsByLabel<T>(chips: PickableItemFieldItem<T>[]): PickableItemFieldItem<T>[];
-/** Subset of {@link PickableValueFieldsFieldProps} needed for static labeled value configuration. */
+/**
+ * Subset of {@link PickableValueFieldsFieldProps} needed for static labeled value configuration.
+ */
 type PickableValueFieldValuesConfigForStaticLabeledValues<T, M extends LabeledValue<T>> = Pick<PickableValueFieldsFieldProps<T, M>, 'loadValues' | 'displayForValue' | 'filterValues'>;
-/** Configuration for creating a pickable field from a static set of labeled values. */
+/**
+ * Configuration for creating a pickable field from a static set of labeled values.
+ */
 interface PickableValueFieldValuesConfigForStaticLabeledValuesConfig<T, M extends LabeledValue<T>> {
     readonly allOptions: M[];
     readonly unknownOptionLabel?: string;
@@ -1784,10 +1873,14 @@ type SearchableValueFieldDisplayFn<T, M = unknown> = MapFunction<SearchableValue
  * SearchableValueField function for setting anchor values on a field value.
  */
 type SearchableValueFieldAnchorFn<T, M = unknown> = MapFunction<SearchableValueFieldValue<T, M>, ClickableAnchor>;
-/** Hash function for searchable field values, used to identify and deduplicate selections. */
+/**
+ * Hash function for searchable field values, used to identify and deduplicate selections.
+ */
 type SearchableValueFieldHashFn<T, H extends PrimativeKey = PrimativeKey> = SelectionValueHashFunction<T, H>;
 
-/** Formly field properties for text input with optional custom validators. */
+/**
+ * Formly field properties for text input with optional custom validators.
+ */
 interface StringValueFieldsFieldProps extends FormlyFieldProps {
     /**
      * Custom input validators.
@@ -1932,11 +2025,17 @@ declare abstract class AbstractDbxSearchableValueFieldDirective<T, M = unknown,
      * Used to sync the input control with the selected value.
      *
      * Only used when multiSelect is false.
+     *
+     * @param value - The display value to synchronize the input control with
+     *
+     * @param value - The display value to synchronize the input control with
      */
     protected _syncSingleValue(value: SearchableValueFieldDisplayValue<T>): void;
     protected _addWithTextValue(text: string): void;
     /**
      * Returns the first validation error message from the input control, if any.
+     *
+     * @returns The first error message string, or undefined if there are no errors
      */
     get inputErrorMessage(): string | undefined;
     addWithDisplayValue(displayValue: SearchableValueFieldDisplayValue<T>): void;
@@ -1978,7 +2077,7 @@ declare class DbxSearchableChipFieldComponent<T, M = unknown, H extends Primativ
     selected(event: MatAutocompleteSelectedEvent): void;
     tabPressedOnInput(event: KeyboardEvent): boolean;
     addChip(event: MatChipInputEvent): void;
-    protected _syncSingleValue(value: SearchableValueFieldDisplayValue<T>): void;
+    protected _syncSingleValue(_value: SearchableValueFieldDisplayValue<T>): void;
     ngOnInit(): void;
     ngOnDestroy(): void;
     onBlur(): void;
@@ -1986,7 +2085,9 @@ declare class DbxSearchableChipFieldComponent<T, M = unknown, H extends Primativ
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxSearchableChipFieldComponent<any, any, any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Injection token providing the {@link ConfiguredSearchableValueFieldDisplayValue} to autocomplete item display components. */
+/**
+ * Injection token providing the {@link ConfiguredSearchableValueFieldDisplayValue} to autocomplete item display components.
+ */
 declare const DBX_SEARCHABLE_FIELD_COMPONENT_DATA_TOKEN: InjectionToken<unknown>;
 /**
  * Renders a single autocomplete suggestion item using dynamic component injection.
@@ -2053,14 +2154,18 @@ declare class DbxSearchableTextFieldComponent<T, M = unknown, H extends Primativ
 /**
  * Used to create a SearchableValueFieldDisplayFn function that will retrieve the metadata for items that are missing their metadata so they can be displayed properly.
  *
- * @param param0
- * @returns
+ * @param param0 - Configuration object
+ * @param param0.loadMetaForValues - Function to load metadata for values that are missing it
+ * @param param0.makeDisplayForValues - Function to convert values with metadata into display values
+ * @returns A display function that lazily loads metadata before generating display values
  */
 declare function makeMetaFilterSearchableFieldValueDisplayFn<T extends string | number = string | number, M = unknown>({ loadMetaForValues, makeDisplayForValues }: {
     loadMetaForValues: (values: SearchableValueFieldValue<T, M>[]) => Observable<SearchableValueFieldValue<T, M>[]>;
     makeDisplayForValues: (values: SearchableValueFieldValue<T, M>[]) => Observable<SearchableValueFieldDisplayValue<T, M>[]>;
 }): SearchableValueFieldDisplayFn<T, M>;
-/** Configuration for a searchable chip field that uses string values directly. */
+/**
+ * Configuration for a searchable chip field that uses string values directly.
+ */
 type StringSearchableChipFieldConfig<M = unknown> = Omit<SearchableChipFieldConfig<string, M>, 'allowStringValues'>;
 /**
  * Creates a searchable chip field pre-configured for string values.
@@ -2112,7 +2217,9 @@ interface SearchableTextFieldConfig<T = unknown, M = unknown, H extends Primativ
  */
 declare function searchableTextField<T, M = unknown, H extends PrimativeKey = PrimativeKey>(config: SearchableTextFieldConfig<T, M, H>): FormlyFieldConfig;
 
-/** Registers the `searchablechipfield` and `searchabletextfield` Formly field types. */
+/**
+ * Registers the `searchablechipfield` and `searchabletextfield` Formly field types.
+ */
 declare class DbxFormFormlySearchableFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlySearchableFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlySearchableFieldModule, never, [typeof DbxSearchableChipFieldComponent, typeof DbxSearchableTextFieldComponent, typeof DbxSearchableFieldAutocompleteItemComponent, typeof DbxDefaultSearchableFieldDisplayComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxSearchableChipFieldComponent, typeof DbxSearchableTextFieldComponent, typeof DbxSearchableFieldAutocompleteItemComponent, typeof DbxDefaultSearchableFieldDisplayComponent]>;
@@ -2123,7 +2230,9 @@ declare class DbxFormFormlySearchableFieldModule {
  * Configuration for a plain text chip field that allows freeform string entry.
  */
 interface ChipTextFieldConfig extends LabeledFieldConfig, StringValueFieldsFieldProps {
-    /** Whether text values are case-sensitive. Defaults to false (lowercased). */
+    /**
+     * Whether text values are case-sensitive. Defaults to false (lowercased).
+     */
     caseSensitive?: boolean;
 }
 /**
@@ -2381,7 +2490,9 @@ interface SourceSelectFieldConfig<T extends PrimativeKey = PrimativeKey, M = unk
  */
 declare function sourceSelectField<T extends PrimativeKey = PrimativeKey, M = unknown>(config: SourceSelectFieldConfig<T, M>): FormlyFieldConfig;
 
-/** Registers the `sourceselectfield` Formly field type. */
+/**
+ * Registers the `sourceselectfield` Formly field type.
+ */
 declare class DbxFormFormlySourceSelectModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlySourceSelectModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlySourceSelectModule, never, [typeof DbxFormSourceSelectFieldComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxFormSourceSelectFieldComponent]>;
@@ -2455,7 +2566,9 @@ declare function valueSelectionField<T>(config: ValueSelectionFieldConfig<T>): F
  */
 declare function addValueSelectionOptionFunction<T>(label?: string | undefined): (options: ValueSelectionOption<T>[]) => ValueSelectionOption<T>[];
 
-/** Formly field properties for the text editor component. */
+/**
+ * Formly field properties for the text editor component.
+ */
 type TextEditorComponentFieldProps = FormlyFieldProps;
 /**
  * Formly field component providing a rich text editor powered by ngx-editor.
@@ -2480,7 +2593,9 @@ declare class DbxTextEditorFieldComponent<T extends TextEditorComponentFieldProp
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxTextEditorFieldComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Registers the `texteditor` Formly field type for rich text editing. */
+/**
+ * Registers the `texteditor` Formly field type for rich text editing.
+ */
 declare class DbxFormFormlyTextEditorFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyTextEditorFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyTextEditorFieldModule, never, [typeof DbxTextEditorFieldComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxTextEditorFieldComponent]>;
@@ -2511,9 +2626,13 @@ type TextFieldInputType = 'text' | 'password' | 'email';
  * and Material form field styling into one config object.
  */
 interface TextFieldConfig extends LabeledFieldConfig, DescriptionFieldConfig, TextFieldPatternConfig, TextFieldLengthConfig, AttributesFieldConfig, Partial<TransformStringFunctionConfigRef>, MaterialFormFieldConfig {
-    /** HTML input type. Defaults to `'text'`. */
+    /**
+     * HTML input type. Defaults to `'text'`.
+     */
     inputType?: TextFieldInputType;
-    /** String transformation applied as a value parser (e.g., trim, uppercase). */
+    /**
+     * String transformation applied as a value parser (e.g., trim, uppercase).
+     */
     transform?: TransformStringFunctionConfig;
 }
 /**
@@ -2545,7 +2664,9 @@ declare function textField(config: TextFieldConfig): FormlyFieldConfig;
  * Configuration for a multi-line textarea input field.
  */
 interface TextAreaFieldConfig extends LabeledFieldConfig, DescriptionFieldConfig, TextFieldPatternConfig, TextFieldLengthConfig, AttributesFieldConfig, Partial<TransformStringFunctionConfigRef>, MaterialFormFieldConfig {
-    /** Number of visible text rows. Defaults to 3. */
+    /**
+     * Number of visible text rows. Defaults to 3.
+     */
     rows?: number;
 }
 /**
@@ -2689,7 +2810,9 @@ declare class DbxFormRepeatArrayTypeComponent<T = unknown> extends FieldArrayTyp
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxFormRepeatArrayTypeComponent<any>, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Registers the `repeatarray` Formly field type for dynamic array fields. */
+/**
+ * Registers the `repeatarray` Formly field type for dynamic array fields.
+ */
 declare class DbxFormFormlyArrayFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyArrayFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyArrayFieldModule, never, [typeof DbxFormRepeatArrayTypeComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxFormRepeatArrayTypeComponent]>;
@@ -2701,7 +2824,9 @@ declare class DbxFormFormlyArrayFieldModule {
  * groups of fields (e.g., multiple addresses, phone numbers).
  */
 interface RepeatArrayFieldConfig<T = unknown> extends DbxFormRepeatArrayConfig<T>, FieldConfig {
-    /** Field group template that is repeated for each array entry. */
+    /**
+     * Field group template that is repeated for each array entry.
+     */
     repeatFieldGroup: ArrayOrValue<FormlyFieldConfig>;
 }
 /**
@@ -2757,7 +2882,9 @@ declare function repeatArrayField<T = unknown>(config: RepeatArrayFieldConfig<T>
     type: string;
 };
 
-/** Provides Formly Material checkbox and toggle field support. */
+/**
+ * Provides Formly Material checkbox and toggle field support.
+ */
 declare class DbxFormFormlyBooleanFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyBooleanFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyBooleanFieldModule, never, [typeof i1.FormlyMaterialModule, typeof i2.FormlyMatCheckboxModule, typeof i3.FormlyMatToggleModule], [typeof i1.FormlyMaterialModule, typeof i2.FormlyMatCheckboxModule, typeof i3.FormlyMatToggleModule]>;
@@ -2855,7 +2982,8 @@ interface DateTimePreset {
 /**
  * Creates a DateTimePreset from a DateTimePresetConfiguration
  *
- * @param config
+ * @param config - The preset configuration with label and value getter
+ * @returns A DateTimePreset with a lazy value getter
  */
 declare function dateTimePreset(config: DateTimePresetConfiguration): DateTimePreset;
 
@@ -2982,6 +3110,11 @@ interface DbxDateTimeFieldTimeDateConfig<I = unknown> {
 }
 /**
  * Type guard that checks whether the input is a {@link DbxDateTimeFieldTimeDateConfig}.
+ *
+ * @param input - The value to check
+ * @returns True if the input is a DbxDateTimeFieldTimeDateConfig with a string path property
+ *
+ * @param input - The value to check
  */
 declare function isDbxDateTimeFieldTimeDateConfig(input: unknown): input is DbxDateTimeFieldTimeDateConfig;
 interface DbxDateTimeFieldProps extends FormlyFieldProps {
@@ -3281,7 +3414,9 @@ type DbxFixedDateRangePickerConfiguration = Omit<DateTimeMinuteConfig, 'date'>;
  * - `'arbitrary_quick'` — Like arbitrary, but immediately sets the value on first click.
  */
 type DbxFixedDateRangeSelectionMode = 'single' | 'normal' | 'arbitrary' | 'arbitrary_quick';
-/** Whether the user is currently picking the start or end of a range. */
+/**
+ * Whether the user is currently picking the start or end of a range.
+ */
 type DbxFixedDateRangePicking = 'start' | 'end';
 interface DbxFixedDateRangeFieldProps extends FormlyFieldProps {
     /**
@@ -3325,7 +3460,9 @@ interface DbxFixedDateRangeFieldProps extends FormlyFieldProps {
      */
     readonly showRangeInput?: boolean;
 }
-/** Type of the most recent date range pick action. */
+/**
+ * Type of the most recent date range pick action.
+ */
 type FixedDateRangeScanType = 'start' | 'end' | 'startRepeat';
 /**
  * Internal scan state used to track the progressive date range selection process.
@@ -3439,8 +3576,8 @@ declare class DbxFixedDateRangeFieldComponent extends FieldType$1<FieldTypeConfi
 declare class DbxFixedDateRangeFieldSelectionStrategy<D> implements MatDateRangeSelectionStrategy<D> {
     private readonly _dateAdapter;
     readonly dbxFixedDateRangeFieldComponent: DbxFixedDateRangeFieldComponent;
-    selectionFinished(date: D | null, currentRange: DateRange$1<D>, event: Event): DateRange$1<D>;
-    createPreview(activeDate: D | null, currentRange: DateRange$1<D>, event: Event): DateRange$1<D>;
+    selectionFinished(date: D | null, currentRange: DateRange$1<D>, _event: Event): DateRange$1<D>;
+    createPreview(activeDate: D | null, _currentRange: DateRange$1<D>, _event: Event): DateRange$1<D>;
     private _createDateRangeWithDate;
     private _createDateRange;
     dateFromAdapterDate(input: D): Date;
@@ -3449,7 +3586,9 @@ declare class DbxFixedDateRangeFieldSelectionStrategy<D> implements MatDateRange
     static ɵprov: i0.ɵɵInjectableDeclaration<DbxFixedDateRangeFieldSelectionStrategy<any>>;
 }
 
-/** Registers the `datetime` and `fixeddaterange` Formly field types with style and form-field wrappers. */
+/**
+ * Registers the `datetime` and `fixeddaterange` Formly field types with style and form-field wrappers.
+ */
 declare class DbxFormFormlyDateFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyDateFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyDateFieldModule, never, [typeof DbxDateTimeFieldComponent, typeof DbxFixedDateRangeFieldComponent, typeof DbxFormFormlyWrapperModule, typeof _ngx_formly_core.FormlyModule], [typeof DbxDateTimeFieldComponent, typeof DbxFixedDateRangeFieldComponent, typeof DbxFormFormlyWrapperModule]>;
@@ -3468,10 +3607,17 @@ type TimeFieldConfig = Omit<DateTimeFieldConfig, 'showDate' | 'timeOnly'>;
 /**
  * Factory that returns an observable of a date-time picker configuration
  * that automatically selects the next upcoming time, rounded down to the nearest minute.
+ *
+ * @returns An observable emitting a picker configuration with takeNextUpcomingTime and roundDownToMinute enabled
  */
 declare const TAKE_NEXT_UPCOMING_TIME_CONFIG_OBS: () => Observable<DbxDateTimePickerConfiguration>;
 /**
  * Same as DateTime field but with the Date input hidden by default.
+ *
+ * @param config - Optional time field configuration overrides
+ * @returns A {@link FormlyFieldConfig} configured as a time-only input
+ *
+ * @param config - Optional time field configuration overrides
  */
 declare function timeOnlyField(config?: Partial<TimeFieldConfig>): FormlyFieldConfig;
 /**
@@ -3487,7 +3633,9 @@ declare function timeOnlyField(config?: Partial<TimeFieldConfig>): FormlyFieldCo
  * ```
  */
 declare function dateTimeField(config?: Partial<DateTimeFieldConfig>): FormlyFieldConfig<DbxDateTimeFieldProps>;
-/** Configuration for a single date within a date range (no time mode or sync). */
+/**
+ * Configuration for a single date within a date range (no time mode or sync).
+ */
 type DateDateRangeFieldDateConfig = Omit<DateTimeFieldConfig, 'dateLabel' | 'timeOnly' | 'timeMode' | 'getSyncFieldsObs'>;
 /**
  * Configuration for a date range field with separate start and end date pickers.
@@ -3510,7 +3658,9 @@ interface DateDateRangeFieldConfig extends Pick<DateTimeFieldConfig, 'timeDate'
  * ```
  */
 declare function dateRangeField(config?: DateDateRangeFieldConfig): FormlyFieldConfig;
-/** Configuration for a single time within a date-time range (no full-day options). */
+/**
+ * Configuration for a single time within a date-time range (no full-day options).
+ */
 type DateTimeRangeFieldTimeConfig = Omit<DateDateRangeFieldDateConfig, 'allDayLabel' | 'fullDayFieldName' | 'fullDayInUTC'>;
 /**
  * Configuration for a date-time range field with separate start and end time pickers.
@@ -3581,12 +3731,18 @@ declare const DEFAULT_DATE_TIME_FIELD_MENU_PRESETS_PRESETS: DateTimePresetConfig
 interface NumberFieldNumberConfig {
     readonly min?: number;
     readonly max?: number;
-    /** Step increment for the input. */
+    /**
+     * Step increment for the input.
+     */
     readonly step?: number;
-    /** When true, adds a validator that enforces the value is divisible by `step`. */
+    /**
+     * When true, adds a validator that enforces the value is divisible by `step`.
+     */
     readonly enforceStep?: boolean;
 }
-/** HTML input type for number fields. */
+/**
+ * HTML input type for number fields.
+ */
 type NumberFieldInputType = 'number';
 /**
  * Full configuration for a numeric input field.
@@ -3666,7 +3822,9 @@ interface NumberSliderFieldConfig extends NumberFieldConfig {
  * ```
  */
 declare function numberSliderField(config: NumberSliderFieldConfig): FormlyFieldConfig;
-/** Configuration for a dollar amount field, which enforces cent-level precision. */
+/**
+ * Configuration for a dollar amount field, which enforces cent-level precision.
+ */
 type DollarAmountFieldConfig = Omit<NumberFieldConfig, 'roundToStep' | 'precision'>;
 /**
  * Creates a number field pre-configured for dollar amount input with cent-level precision.
@@ -3683,7 +3841,9 @@ declare function dollarAmountField(config: DollarAmountFieldConfig): FormlyField
     [additionalProperties: string]: any;
 }>;
 
-/** Provides Formly Material number input and slider support. */
+/**
+ * Provides Formly Material number input and slider support.
+ */
 declare class DbxFormFormlyNumberFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyNumberFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyNumberFieldModule, never, [typeof i1.FormlyMaterialModule, typeof i2$1.FormlyMatSliderModule], [typeof i1.FormlyMaterialModule, typeof i2$1.FormlyMatSliderModule]>;
@@ -3694,9 +3854,13 @@ declare class DbxFormFormlyNumberFieldModule {
  * Formly field props for the international phone number component.
  */
 interface InternationalPhoneFormlyFieldProps extends FormlyFieldProps {
-    /** ISO country codes for countries shown first in the dropdown. */
+    /**
+     * ISO country codes for countries shown first in the dropdown.
+     */
     readonly preferredCountries?: Maybe<string[]>;
-    /** ISO country codes to restrict the dropdown to. */
+    /**
+     * ISO country codes to restrict the dropdown to.
+     */
     readonly onlyCountries?: Maybe<string[]>;
     /**
      * Whether or not to enable the search feature. True by default.
@@ -3707,7 +3871,9 @@ interface InternationalPhoneFormlyFieldProps extends FormlyFieldProps {
      */
     readonly allowExtension?: boolean;
 }
-/** Default preferred countries shown at the top of the phone country dropdown. */
+/**
+ * Default preferred countries shown at the top of the phone country dropdown.
+ */
 declare const DEFAULT_PREFERRED_COUNTRIES: string[];
 /**
  * Formly custom field type for international phone number input with optional extension support.
@@ -3738,7 +3904,9 @@ declare class DbxPhoneFieldComponent extends FieldType$1<FieldTypeConfig<Interna
     static ɵcmp: i0.ɵɵComponentDeclaration<DbxPhoneFieldComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-/** Registers the `intphone` Formly field type for international phone number input. */
+/**
+ * Registers the `intphone` Formly field type for international phone number input.
+ */
 declare class DbxFormFormlyPhoneFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyPhoneFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyPhoneFieldModule, never, [typeof DbxPhoneFieldComponent, typeof _ngx_formly_core.FormlyModule], [typeof DbxPhoneFieldComponent]>;
@@ -3775,6 +3943,8 @@ interface WrappedPhoneAndLabelFieldConfig {
  * useful for collecting named phone numbers (e.g., "Work", "Home").
  *
  * @param config - Optional phone and label field configurations
+ * @param config.phoneField - Optional configuration overrides for the phone number input
+ * @param config.labelField - Optional configuration overrides for the label text input
  * @returns A flex-layout-wrapped {@link FormlyFieldConfig}
  *
  * @example
@@ -3793,6 +3963,11 @@ interface PhoneAndLabelFieldSectionConfig extends DbxFormSectionConfig, WrappedP
  * Creates a section-wrapped phone + label field pair with a configurable header.
  *
  * @param config - Optional overrides; defaults to header `'Phone Number'`
+ * @param config.key - Optional form model key for the section group
+ * @param config.header - Section header text; defaults to `'Phone Number'`
+ * @param config.hint - Optional hint text displayed below the section header
+ * @param config.phoneField - Optional phone field configuration overrides
+ * @param config.labelField - Optional label field configuration overrides
  * @returns A section-wrapped {@link FormlyFieldConfig}
  *
  * @example
@@ -3821,11 +3996,17 @@ interface PhoneListFieldConfig extends Omit<RepeatArrayFieldConfig, 'repeatField
  */
 declare function phoneListField(repeatConfig?: Partial<PhoneListFieldConfig>): FormlyFieldConfig;
 
-/** Maximum character length for a phone label field. */
+/**
+ * Maximum character length for a phone label field.
+ */
 declare const PHONE_LABEL_MAX_LENGTH = 100;
-/** Maximum character length for a generic label string field. */
+/**
+ * Maximum character length for a generic label string field.
+ */
 declare const LABEL_STRING_MAX_LENGTH = 100;
-/** Maximum character length for a search string field. */
+/**
+ * Maximum character length for a search string field.
+ */
 declare const SEARCH_STRING_MAX_LENGTH = 100;
 /**
  * Creates a text field pre-configured for a person's full name.
@@ -3857,7 +4038,9 @@ interface EmailFieldConfig extends Partial<LabeledFieldConfig>, DescriptionField
  * ```
  */
 declare function emailField(config?: EmailFieldConfig): FormlyFieldConfig;
-/** Configuration for a city input field. */
+/**
+ * Configuration for a city input field.
+ */
 type CityFieldConfig = Partial<TextFieldConfig>;
 /**
  * Creates a text field pre-configured for city name input with autocomplete support.
@@ -3875,7 +4058,9 @@ declare function cityField(config?: CityFieldConfig): FormlyFieldConfig;
  * Configuration for a US state input field.
  */
 interface StateFieldConfig extends Partial<TextFieldConfig> {
-    /** When true, validates and formats as a 2-letter state code (e.g., `'CA'`). */
+    /**
+     * When true, validates and formats as a 2-letter state code (e.g., `'CA'`).
+     */
     readonly asCode?: boolean;
 }
 /**
@@ -3892,7 +4077,9 @@ interface StateFieldConfig extends Partial<TextFieldConfig> {
  * ```
  */
 declare function stateField(config?: StateFieldConfig): FormlyFieldConfig;
-/** Configuration for a country input field. */
+/**
+ * Configuration for a country input field.
+ */
 type CountryFieldConfig = Partial<TextFieldConfig>;
 /**
  * Creates a text field pre-configured for country name input with autocomplete support.
@@ -3906,7 +4093,9 @@ type CountryFieldConfig = Partial<TextFieldConfig>;
  * ```
  */
 declare function countryField(config?: CountryFieldConfig): FormlyFieldConfig;
-/** Configuration for a zip/postal code input field. */
+/**
+ * Configuration for a zip/postal code input field.
+ */
 type ZipCodeFieldConfig = Partial<TextFieldConfig>;
 /**
  * Creates a text field pre-configured for US zip code input with pattern validation.
@@ -3920,14 +4109,19 @@ type ZipCodeFieldConfig = Partial<TextFieldConfig>;
  * ```
  */
 declare function zipCodeField(config?: ZipCodeFieldConfig): FormlyFieldConfig;
-/** Default placeholder text for a latitude/longitude text field. */
+/**
+ * Default placeholder text for a latitude/longitude text field.
+ */
 declare const DEFAULT_LAT_LNG_TEXT_FIELD_PLACEHOLDER = "12.345,-67.8910";
-/** Default validation error message for invalid coordinate input. */
+/**
+ * Default validation error message for invalid coordinate input.
+ */
 declare const DEFAULT_LAT_LNG_TEXT_FIELD_PATTERN_MESSAGE = "Invalid/unknown coordinates";
 /**
  * Creates a text field pre-configured for latitude/longitude coordinate input with pattern validation.
  *
  * @param config - Optional overrides; defaults to key `'latLng'`
+ * @param config.key - The form model key; defaults to `'latLng'`
  * @returns A {@link FormlyFieldConfig} for coordinate input
  *
  * @example
@@ -3970,7 +4164,9 @@ interface AddressFormlyFieldsConfig {
  * Configuration for a single address line field.
  */
 interface AddressLineFieldConfig extends Partial<TextFieldConfig> {
-    /** Address line number: 0 for single "Street" line, 1 for "Line 1", 2 for "Line 2". */
+    /**
+     * Address line number: 0 for single "Street" line, 1 for "Line 1", 2 for "Line 2".
+     */
     readonly line?: 0 | 1 | 2;
 }
 /**
@@ -4020,7 +4216,9 @@ declare function addressField(config?: Partial<AddressFieldConfig>): FormlyField
  * Configuration for a repeatable list of address field groups.
  */
 interface AddressListFieldConfig extends Readonly<FieldConfig>, AddressFormlyFieldsConfig {
-    /** Maximum number of addresses allowed. Defaults to 6. */
+    /**
+     * Maximum number of addresses allowed. Defaults to 6.
+     */
     readonly maxAddresses?: number;
 }
 /**
@@ -4036,7 +4234,9 @@ interface AddressListFieldConfig extends Readonly<FieldConfig>, AddressFormlyFie
  */
 declare function addressListField(config?: Partial<AddressListFieldConfig>): FormlyFieldConfig;
 
-/** Aggregates Formly Material input, array field, and wrapper modules for text field support. */
+/**
+ * Aggregates Formly Material input, array field, and wrapper modules for text field support.
+ */
 declare class DbxFormFormlyTextFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyTextFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyTextFieldModule, never, [typeof DbxFormFormlyArrayFieldModule, typeof i1.FormlyMaterialModule, typeof i3$1.FormlyMatInputModule, typeof DbxFormFormlyWrapperModule], [typeof DbxFormFormlyArrayFieldModule, typeof i1.FormlyMaterialModule, typeof i3$1.FormlyMatInputModule, typeof DbxFormFormlyWrapperModule]>;
@@ -4053,6 +4253,8 @@ type HiddenFieldConfig = Pick<LabeledFieldConfig, 'key' | 'required'>;
  * Useful for passing programmatic values through the form model without user interaction.
  *
  * @param config - Key and optional required flag
+ * @param config.key - The form model key for this hidden field
+ * @param config.required - Whether the hidden field must have a value; defaults to `false`
  * @returns A validated {@link FormlyFieldConfig} with no visible type
  *
  * @example
@@ -4089,34 +4291,90 @@ type WrapperFormlyFieldConfig<P, C extends FormlyFieldConfig> = FormlyFieldConfi
 declare function addWrapperToFormlyFieldConfig<C extends FormlyFieldConfig, P extends object>(fieldConfig: C, wrapperKey: string, wrapperProps: P): WrapperFormlyFieldConfig<P, C>;
 /**
  * Wraps a field with the auto-touch wrapper that marks the control as touched on value change.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param autoTouchWrapper - Optional expand wrapper configuration
+ * @returns A wrapped field configuration with auto-touch behavior
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param autoTouchWrapper - Optional expand wrapper configuration
  */
 declare function autoTouchWrapper<T extends object, C extends FormlyFieldConfig>(fieldConfig: C, autoTouchWrapper?: DbxFormExpandWrapperConfig<T>): WrapperFormlyFieldConfig<DbxFormExpandWrapperConfig<T>, C>;
 /**
  * Wraps a field with the expand wrapper that shows/hides the field based on value or user click.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param expandWrapper - Optional expand wrapper configuration
+ * @returns A wrapped field configuration with expand/collapse behavior
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param expandWrapper - Optional expand wrapper configuration
  */
 declare function expandWrapper<T extends object, C extends FormlyFieldConfig>(fieldConfig: C, expandWrapper?: DbxFormExpandWrapperConfig<T>): WrapperFormlyFieldConfig<DbxFormExpandWrapperConfig<T>, C>;
 /**
  * Wraps a field with the toggle wrapper that uses a slide toggle to show/hide content.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param toggleWrapper - Optional toggle wrapper configuration
+ * @returns A wrapped field configuration with toggle show/hide behavior
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param toggleWrapper - Optional toggle wrapper configuration
  */
 declare function toggleWrapper<C extends FormlyFieldConfig>(fieldConfig: C, toggleWrapper?: DbxFormToggleWrapperConfig): WrapperFormlyFieldConfig<DbxFormToggleWrapperConfig<object>, C>;
 /**
  * Wraps a field group in a section layout with an optional header and hint.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param sectionWrapper - Optional section configuration with header and hint
+ * @returns A wrapped field configuration with section layout
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param sectionWrapper - Optional section configuration with header and hint
  */
 declare function sectionWrapper<C extends FormlyFieldConfig>(fieldConfig: C, sectionWrapper?: DbxFormSectionConfig): WrapperFormlyFieldConfig<_dereekb_dbx_web.DbxSectionHeaderConfig, C>;
 /**
  * Wraps a field group in a subsection layout with an optional header and hint.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param subsectionWrapper - Optional subsection configuration with header and hint
+ * @returns A wrapped field configuration with subsection layout
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param subsectionWrapper - Optional subsection configuration with header and hint
  */
 declare function subsectionWrapper<C extends FormlyFieldConfig>(fieldConfig: C, subsectionWrapper?: DbxFormSubsectionConfig): WrapperFormlyFieldConfig<_dereekb_dbx_web.DbxSectionHeaderConfig, C>;
 /**
  * Wraps a field with an info button that triggers a callback when clicked.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param infoWrapper - Info wrapper configuration with callback
+ * @returns A wrapped field configuration with info button
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param infoWrapper - Info wrapper configuration with callback
  */
 declare function infoWrapper<C extends FormlyFieldConfig>(fieldConfig: C, infoWrapper: DbxFormInfoConfig): WrapperFormlyFieldConfig<DbxFormInfoConfig, C>;
 /**
  * Wraps a field with dynamic CSS class and style bindings.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param styleWrapper - Style wrapper configuration with CSS classes and styles
+ * @returns A wrapped field configuration with dynamic styling
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param styleWrapper - Style wrapper configuration with CSS classes and styles
  */
 declare function styleWrapper<C extends FormlyFieldConfig>(fieldConfig: C, styleWrapper: DbxFormStyleWrapperConfig): WrapperFormlyFieldConfig<DbxFormStyleWrapperConfig, C>;
 /**
  * Wraps a field with a loading indicator that shows during async validation.
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param workingWrapper - Optional working wrapper configuration
+ * @returns A wrapped field configuration with loading indicator
+ *
+ * @param fieldConfig - The field configuration to wrap
+ * @param workingWrapper - Optional working wrapper configuration
  */
 declare function workingWrapper<C extends FormlyFieldConfig>(fieldConfig: C, workingWrapper?: DbxFormWorkingWrapperConfig): WrapperFormlyFieldConfig<object, C>;
 /**
@@ -4139,6 +4397,11 @@ interface DbxFlexLayoutWrapperGroupFieldConfigDefaults extends DbxFlexWrapperCon
 /**
  * Type guard that checks if the input is a {@link DbxFlexLayoutWrapperGroupFieldConfig}
  * (has a `field` property) rather than a plain {@link FormlyFieldConfig}.
+ *
+ * @param input - The field config or wrapper group config to check
+ * @returns True if the input has a `field` property identifying it as a wrapper group config
+ *
+ * @param input - The field config or wrapper group config to check
  */
 declare function checkIsFieldFlexLayoutGroupFieldConfig(input: FormlyFieldConfig | DbxFlexLayoutWrapperGroupFieldConfig): input is DbxFlexLayoutWrapperGroupFieldConfig;
 /**
@@ -4147,6 +4410,10 @@ declare function checkIsFieldFlexLayoutGroupFieldConfig(input: FormlyFieldConfig
  *
  * @param fieldConfigs - Array of field configs or field config pairs with size overrides
  * @param options - Flex layout defaults including breakpoint, relative sizing, and default size
+ * @param options.relative - Whether sizes are relative to the container
+ * @param options.breakpoint - Responsive breakpoint at which to stack fields vertically
+ * @param options.breakToColumn - Whether to break to column layout at the breakpoint
+ * @param options.size - Default flex size for fields without an explicit size; defaults to 2
  * @returns A {@link FormlyFieldConfig} with flex wrapper applied
  *
  * @example
@@ -4159,7 +4426,9 @@ declare function checkIsFieldFlexLayoutGroupFieldConfig(input: FormlyFieldConfig
  */
 declare function flexLayoutWrapper(fieldConfigs: (FormlyFieldConfig | DbxFlexLayoutWrapperGroupFieldConfig)[], { relative, breakpoint, breakToColumn, size: defaultSize }?: DbxFlexLayoutWrapperGroupFieldConfigDefaults): FormlyFieldConfig<DbxFlexWrapperConfig>;
 
-/** Aggregates all custom Formly field type modules (checklist, component, texteditor) and wrappers. */
+/**
+ * Aggregates all custom Formly field type modules (checklist, component, texteditor) and wrappers.
+ */
 declare class DbxFormFormlyFieldModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<DbxFormFormlyFieldModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<DbxFormFormlyFieldModule, never, [typeof DbxFormFormlyChecklistItemFieldModule, typeof DbxFormFormlyComponentFieldModule, typeof DbxFormFormlyTextEditorFieldModule, typeof DbxFormFormlyWrapperModule], [typeof DbxFormFormlyChecklistItemFieldModule, typeof DbxFormFormlyComponentFieldModule, typeof DbxFormFormlyTextEditorFieldModule, typeof DbxFormFormlyWrapperModule]>;
@@ -4173,6 +4442,12 @@ interface DbxFormSearchFormFieldsConfig extends MaterialFormFieldConfig {
     readonly label?: string;
     readonly placeholder?: string;
 }
+/**
+ * Creates a Formly field array for a simple search form with a single text input.
+ *
+ * @param config - Optional search field configuration with label and placeholder
+ * @returns An array of Formly field configs for the search form
+ */
 declare function dbxFormSearchFormFields(config: Maybe<DbxFormSearchFormFieldsConfig>): FormlyFieldConfig[];
 
 /**
@@ -4397,8 +4672,11 @@ interface DefaultUsernameLoginFieldsValue extends DefaultUsernameLoginFieldValue
 /**
  * Template for login field that takes in a username and password.
  *
- * @param param0
- * @returns
+ * @param param0 - Login fields configuration
+ * @param param0.username - Optional username field configuration
+ * @param param0.password - Optional password field configuration
+ * @param param0.verifyPassword - Optional verify-password field configuration, or `true` to use defaults
+ * @returns An array of Formly field configs for the login form
  */
 declare function usernamePasswordLoginFields({ username, password, verifyPassword }: UsernameLoginFieldsConfig): FormlyFieldConfig[];
 /**
@@ -4444,6 +4722,11 @@ declare function timezoneStringSearchFunction(): SearchableValueFieldStringSearc
  *
  * Maps each timezone value to a display object with the timezone name as the label
  * and its abbreviation as the sublabel.
+ *
+ * @param values - The timezone values to convert to display values
+ * @returns An observable emitting display values with label and sublabel
+ *
+ * @param values - The timezone values to convert to display values
  */
 declare const DISPLAY_FOR_TIMEZONE_STRING_VALUE: SearchableValueFieldDisplayFn<string, TimezoneInfo>;
 /**
@@ -4504,10 +4787,11 @@ interface IsWebsiteUrlValidatorConfig {
     readonly validDomains?: Maybe<ArrayOrValue<WebsiteDomain>>;
 }
 /**
- * Angular Form ValidationFn for checking isDivisibleBy the input divisor.
+ * Angular form validator that checks whether the control value is a valid website URL,
+ * optionally requiring an http/https prefix, allowing port numbers, and restricting to specific domains.
  *
- * @param divisor
- * @returns
+ * @param config - Optional validation configuration for prefix, port, and domain requirements
+ * @returns A ValidatorFn that validates website URLs
  */
 declare function isWebsiteUrlValidator(config?: IsWebsiteUrlValidatorConfig): ValidatorFn;
 
@@ -4603,6 +4887,11 @@ declare class DbxFormlyFormComponentImportsModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<DbxFormlyFormComponentImportsModule>;
 }
 
+/**
+ * Registers all dbx-form Formly field types, wrappers, and the core Formly + Material modules as providers.
+ *
+ * @returns Environment providers for all Formly field declarations
+ */
 declare function provideDbxFormFormlyFieldDeclarations(): i0.EnvironmentProviders;
 
 /**
@@ -4617,8 +4906,18 @@ declare class DbxFormSpacerDirective {
     static ɵdir: i0.ɵɵDirectiveDeclaration<DbxFormSpacerDirective, "dbx-form-spacer,[dbxFormSpacer],.dbx-form-spacer", never, {}, {}, never, never, true, never>;
 }
 
+/**
+ * Angular form validator that requires the control value to be truthy.
+ *
+ * @returns A ValidatorFn that fails when the value is falsy
+ */
 declare function isTruthy(): ValidatorFn;
 
+/**
+ * Angular form validator that checks whether the control value matches a website domain name pattern.
+ *
+ * @returns A ValidatorFn that validates against the domain name regex
+ */
 declare function isDomain(): ValidatorFn;
 
 declare const FIELD_VALUES_ARE_EQUAL_VALIDATION_KEY = "fieldValuesAreEqual";
@@ -4676,19 +4975,23 @@ interface IsDivisibleByError {
 declare function isDivisibleBy(divisor: number): ValidatorFn;
 
 /**
- * Angular Form ValidationFn for checking isE164PhoneNumber the input divisor.
+ * Angular form validator that checks whether the control value is a valid E.164 phone number.
  *
- * @param divisor
- * @returns
+ * @param allowExtension - Whether to allow phone number extensions in the value
+ * @returns A ValidatorFn that validates E.164 phone numbers
  */
 declare function isE164PhoneNumber(allowExtension: boolean): ValidatorFn;
 /**
  * Angular Form ValidationFn for checking the input is a valid phone extension. Empty values return true.
  *
- * @param divisor
- * @returns
+ * @returns A ValidatorFn that validates phone extension numbers
  */
 declare function isPhoneExtension(): ValidatorFn;
+/**
+ * Angular form validator that checks the value is a valid E.164 phone number with a valid extension (if present).
+ *
+ * @returns A ValidatorFn that validates E.164 phone numbers with optional extensions
+ */
 declare function isE164PhoneNumberWithValidExtension(): ValidatorFn;
 
 declare class DbxFormExtensionModule {
@@ -4701,6 +5004,13 @@ interface ProvideDbxFormConfigurationConfig {
     readonly provideDateAdapter?: boolean;
     readonly defaultDateTimePresets?: Maybe<DateTimePresetConfiguration[]>;
 }
+/**
+ * Provides the core dbx-form configuration including Material form field defaults,
+ * date adapter, and optional date-time presets.
+ *
+ * @param config - Optional configuration for the date adapter and default date-time presets
+ * @returns Environment providers for dbx-form
+ */
 declare function provideDbxFormConfiguration(config?: ProvideDbxFormConfigurationConfig): EnvironmentProviders;
 
 export { APP_ACTION_FORM_DISABLED_KEY, AbstractAsyncFormlyFormDirective, AbstractConfigAsyncFormlyFormDirective, AbstractDbxPickableItemFieldDirective, AbstractDbxSearchableFieldDisplayDirective, AbstractDbxSearchableValueFieldDirective, AbstractFormExpandSectionWrapperDirective, AbstractFormlyFormDirective, AbstractSyncFormlyFormDirective, AutoTouchFieldWrapperComponent, ChecklistItemFieldDataSetBuilder, DBX_DATE_TIME_FIELD_DATE_NOT_IN_SCHEDULE_ERROR, DBX_DATE_TIME_FIELD_MENU_PRESETS_TOKEN, DBX_DATE_TIME_FIELD_TIME_NOT_IN_RANGE_ERROR, DBX_FORMLY_FORM_COMPONENT_TEMPLATE, DBX_SEARCHABLE_FIELD_COMPONENT_DATA_TOKEN, DEFAULT_DATE_TIME_FIELD_MENU_PRESETS_PRESETS, DEFAULT_FORM_DISABLED_KEY, DEFAULT_HAS_VALUE_FN, DEFAULT_LAT_LNG_TEXT_FIELD_PATTERN_MESSAGE, DEFAULT_LAT_LNG_TEXT_FIELD_PLACEHOLDER, DEFAULT_PREFERRED_COUNTRIES, DISPLAY_FOR_TIMEZONE_STRING_VALUE, DbxActionFormDirective, DbxActionFormSafetyDirective, DbxChecklistItemContentComponent, DbxChecklistItemFieldComponent, DbxDateTimeFieldComponent, DbxDateTimeFieldMenuPresetsService, DbxDateTimeFieldTimeMode, DbxDateTimeValueMode, DbxDefaultChecklistItemFieldDisplayComponent, DbxDefaultSearchableFieldDisplayComponent, DbxFixedDateRangeFieldComponent, DbxFixedDateRangeFieldSelectionStrategy, DbxForm, DbxFormActionDialogComponent, DbxFormComponentFieldComponent, DbxFormExpandWrapperComponent, DbxFormExtensionModule, DbxFormFlexWrapperComponent, DbxFormFormlyArrayFieldModule, DbxFormFormlyBooleanFieldModule, DbxFormFormlyChecklistItemFieldModule, DbxFormFormlyComponentFieldModule, DbxFormFormlyDateFieldModule, DbxFormFormlyDbxListFieldModule, DbxFormFormlyFieldModule, DbxFormFormlyNumberFieldModule, DbxFormFormlyPhoneFieldModule, DbxFormFormlyPickableFieldModule, DbxFormFormlySearchableFieldModule, DbxFormFormlySourceSelectModule, DbxFormFormlyTextEditorFieldModule, DbxFormFormlyTextFieldModule, DbxFormFormlyWrapperModule, DbxFormInfoWrapperComponent, DbxFormLoadingSourceDirective, DbxFormLoginFieldModule, DbxFormModule, DbxFormRepeatArrayTypeComponent, DbxFormSearchFormComponent, DbxFormSectionWrapperComponent, DbxFormSourceDirective, DbxFormSourceSelectFieldComponent, DbxFormSpacerDirective, DbxFormState, DbxFormStyleWrapperComponent, DbxFormSubsectionWrapperComponent, DbxFormTextAvailableFieldModule, DbxFormTimezoneStringFieldModule, DbxFormToggleWrapperComponent, DbxFormValueChangeDirective, DbxFormWorkingWrapperComponent, DbxFormlyComponent, DbxFormlyContext, DbxFormlyFieldsContextDirective, DbxFormlyFormComponentImportsModule, DbxItemListFieldComponent, DbxMutableForm, DbxPhoneFieldComponent, DbxPickableChipListFieldComponent, DbxPickableListFieldComponent, DbxPickableListFieldItemListComponent, DbxPickableListFieldItemListViewComponent, DbxPickableListFieldItemListViewItemComponent, DbxSearchableChipFieldComponent, DbxSearchableFieldAutocompleteItemComponent, DbxSearchableTextFieldComponent, DbxTextEditorFieldComponent, FIELD_VALUES_ARE_EQUAL_VALIDATION_KEY, FIELD_VALUE_IS_AVAILABLE_ERROR_VALIDATION_KEY, FIELD_VALUE_IS_AVAILABLE_VALIDATION_KEY, INVALID_PHONE_NUMBER_EXTENSION_MESSAGE, INVALID_PHONE_NUMBER_MESSAGE, IS_DIVISIBLE_BY_VALIDATION_KEY, IS_NOT_WEBSITE_URL_VALIDATION_KEY, IS_NOT_WEBSITE_URL_WITH_EXPECTED_DOMAIN_VALIDATION_KEY, IS_NOT_WEBSITE_URL_WITH_PREFIX_VALIDATION_KEY, LABEL_STRING_MAX_LENGTH, MAX_LENGTH_VALIDATION_MESSAGE, MAX_VALIDATION_MESSAGE, MIN_LENGTH_VALIDATION_MESSAGE, MIN_VALIDATION_MESSAGE, PHONE_LABEL_MAX_LENGTH, REQUIRED_VALIDATION_MESSAGE, SEARCH_STRING_MAX_LENGTH, TAKE_NEXT_UPCOMING_TIME_CONFIG_OBS, addValueSelectionOptionFunction, addWrapperToFormlyFieldConfig, addressField, addressFormlyFields, addressLineField, addressListField, autoTouchWrapper, checkIsFieldFlexLayoutGroupFieldConfig, checkboxField, checklistItemField, chipTextField, cityField, componentField, countryField, dateRangeField, dateTimeField, dateTimePreset, dateTimeRangeField, dbxDateRangeIsSameDateRangeFieldValue, dbxDateTimeInputValueParseFactory, dbxDateTimeIsSameDateTimeFieldValue, dbxDateTimeOutputValueFactory, dbxFormSearchFormFields, dbxFormSourceObservable, dbxFormSourceObservableFromStream, dbxFormlyFormComponentProviders, dbxListField, defaultValidationMessages, disableFormlyFieldAutofillAttributes, dollarAmountField, emailField, expandWrapper, fieldValueIsAvailableValidator, fieldValuesAreEqualValidator, filterPartialPotentialFieldConfigValuesFromObject, filterPickableItemFieldValuesByLabel, filterPickableItemFieldValuesByLabelFilterFunction, fixedDateRangeField, flexLayoutWrapper, formlyField, hiddenField, infoWrapper, isDbxDateTimeFieldTimeDateConfig, isDivisibleBy, isDomain, isE164PhoneNumber, isE164PhoneNumberWithValidExtension, isInRange, isPhoneExtension, isTruthy, isWebsiteUrlValidator, latLngTextField, makeMetaFilterSearchableFieldValueDisplayFn, maxLengthValidationMessage, maxValidationMessage, mergePropsValueObjects, minLengthValidationMessage, minValidationMessage, nameField, numberField, numberFieldTransformParser, numberSliderField, partialPotentialFieldConfigKeys, partialPotentialFieldConfigKeysFilter, phoneAndLabelSectionField, phoneField, phoneListField, pickableItemChipField, pickableItemListField, pickableValueFieldValuesConfigForStaticLabeledValues, propsAndConfigForFieldConfig, propsValueForFieldConfig, provideDbxForm, provideDbxFormConfiguration, provideDbxFormFormlyFieldDeclarations, provideDbxMutableForm, provideFormlyContext, repeatArrayField, searchableChipField, searchableStringChipField, searchableTextField, sectionWrapper, sortPickableItemsByLabel, sortPickableItemsByLabelStringFunction, sourceSelectField, stateField, streamValueFromControl, styleWrapper, subsectionWrapper, syncConfigValueObs, textAreaField, textEditorField, textField, textFieldTransformParser, textIsAvailableField, textPasswordField, textPasswordWithVerifyFieldGroup, textVerifyPasswordField, timeOnlyField, timezoneStringField, timezoneStringSearchFunction, toggleDisableFormControl, toggleField, toggleWrapper, usernameLoginField, usernamePasswordLoginFields, validatorsForFieldConfig, valueSelectionField, websiteUrlField, workingWrapper, wrappedPhoneAndLabelField, zipCodeField };