@dereekb/dbx-form 13.9.0 → 13.10.0

package/fesm2022/dereekb-dbx-form.mjs

@@ -2886,21 +2886,27 @@ function dbxForgeWebsiteUrlValidator(config) {
 }
 
 /**
- * Creates a forge field definition for a single-line text input.
+ * Single-line text input. Supports text/email/password input types, autocomplete attribute, regex pattern validation, and idempotent string transforms (trim, case changes, etc.).
  *
  * @param config - Text field configuration including key, label, validation, and transform options
  * @returns A text input field with type `'input'`
  *
+ * @dbxFormField
+ * @dbxFormSlug text
+ * @dbxFormTier field-factory
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType input
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeTextFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeTextField({
+ * const emailField = dbxForgeTextField({
  *   key: 'email',
  *   label: 'Email',
  *   required: true,
- *   props: {
- *     type: 'email',
- *     placeholder: 'user@example.com'
- *   }
+ *   inputType: 'email',
+ *   props: { placeholder: 'user@example.com' }
  * });
  * ```
  */
@@ -2933,14 +2939,27 @@ const dbxForgeTextField = dbxForgeFieldFunction({
 });
 
 /**
- * Creates a forge field definition for a multi-line textarea input.
+ * Multi-line textarea input. Supports row count, autocomplete attribute, pattern validation (RegExp → string conversion), and default value.
  *
  * @param config - Textarea field configuration including key, label, rows, and validation options
  * @returns A textarea field with type `'textarea'`
  *
+ * @dbxFormField
+ * @dbxFormSlug text-area
+ * @dbxFormTier field-factory
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType textarea
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeTextAreaFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeTextAreaField({ key: 'bio', label: 'Biography', rows: 5, maxLength: 500 });
+ * const bioField = dbxForgeTextAreaField({
+ *   key: 'bio',
+ *   label: 'Biography',
+ *   rows: 5,
+ *   maxLength: 500
+ * });
  * ```
  */
 const dbxForgeTextAreaField = dbxForgeFieldFunction({
@@ -2971,14 +2990,20 @@ const dbxForgeTextAreaField = dbxForgeFieldFunction({
 
 // MARK: Name Field
 /**
- * Creates a forge text field pre-configured for a person's full name.
+ * Pre-configured text field for capturing a full name with sensible min/max length defaults.
  *
  * @param config - Optional overrides; defaults to key `'name'`, label `'Name'`
  * @returns A {@link MatInputField} for name input
  *
+ * @dbxFormField
+ * @dbxFormSlug name
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeNameFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeNameField({ required: true });
+ * dbxForgeNameField({ key: 'fullName', label: 'Full Name', required: true })
  * ```
  */
 function dbxForgeNameField(config = {}) {
@@ -2994,16 +3019,22 @@ function dbxForgeNameField(config = {}) {
     });
 }
 /**
- * Creates a forge text field pre-configured for email address input.
+ * Text field pre-configured with email input type and email validator. Prefer this over configuring `dbxForgeTextField` with `inputType: "email"` directly.
  *
  * Uses the `'email'` input type for built-in browser validation.
  *
  * @param config - Optional overrides; defaults to key `'email'`, label `'Email Address'`
  * @returns A {@link MatInputField} with email input type
  *
+ * @dbxFormField
+ * @dbxFormSlug email
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeEmailFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeEmailField({ required: true });
+ * dbxForgeEmailField({ key: 'email', label: 'Email', required: true })
  * ```
  */
 function dbxForgeEmailField(config = {}) {
@@ -3020,14 +3051,20 @@ function dbxForgeEmailField(config = {}) {
     });
 }
 /**
- * Creates a forge text field pre-configured for city name input.
+ * City name input enforcing `ADDRESS_CITY_MAX_LENGTH`. Typically used inside the address composite set.
  *
  * @param config - Optional overrides; defaults to key `'city'`, label `'City'`
  * @returns A {@link MatInputField} for city input
  *
+ * @dbxFormField
+ * @dbxFormSlug city
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeCityFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeCityField({ required: true });
+ * dbxForgeCityField({ required: true })
  * ```
  */
 function dbxForgeCityField(config = {}) {
@@ -3042,16 +3079,20 @@ function dbxForgeCityField(config = {}) {
     });
 }
 /**
- * Creates a forge text field pre-configured for US state input with optional state code validation.
- *
- * When `asCode` is true, enforces the 2-letter state code pattern and auto-uppercases input.
+ * US state input. When `asCode: true`, validates two-letter codes and auto-uppercases input via an idempotent transform.
  *
  * @param config - Optional overrides; defaults to key `'state'`, label `'State'`
  * @returns A {@link MatInputField} for state input
  *
+ * @dbxFormField
+ * @dbxFormSlug state
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeStateFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeStateField({ asCode: true, required: true });
+ * dbxForgeStateField({ asCode: true, required: true })
  * ```
  */
 function dbxForgeStateField(config = {}) {
@@ -3071,14 +3112,20 @@ function dbxForgeStateField(config = {}) {
     });
 }
 /**
- * Creates a forge text field pre-configured for country name input.
+ * Country name input enforcing `ADDRESS_COUNTRY_MAX_LENGTH`. Typically used inside the address composite set.
  *
  * @param config - Optional overrides; defaults to key `'country'`, label `'Country'`
  * @returns A {@link MatInputField} for country input
  *
+ * @dbxFormField
+ * @dbxFormSlug country
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeCountryFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeCountryField({ required: true });
+ * dbxForgeCountryField({ required: true })
  * ```
  */
 function dbxForgeCountryField(config = {}) {
@@ -3093,14 +3140,20 @@ function dbxForgeCountryField(config = {}) {
     });
 }
 /**
- * Creates a forge text field pre-configured for US zip code input with pattern validation.
+ * US zip code input with pattern validation and max-length enforcement.
  *
  * @param config - Optional overrides; defaults to key `'zip'`, label `'Zip Code'`
  * @returns A {@link MatInputField} for zip code input
  *
+ * @dbxFormField
+ * @dbxFormSlug zip-code
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeZipCodeFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeZipCodeField({ required: true });
+ * dbxForgeZipCodeField({ required: true })
  * ```
  */
 function dbxForgeZipCodeField(config = {}) {
@@ -3121,14 +3174,20 @@ function dbxForgeZipCodeField(config = {}) {
  */
 const DEFAULT_FORGE_LAT_LNG_TEXT_FIELD_PLACEHOLDER = '12.345,-67.8910';
 /**
- * Creates a forge text field pre-configured for latitude/longitude coordinate input with pattern validation.
+ * Latitude/longitude coordinate input with decimal-degree pattern validation.
  *
  * @param config - Optional overrides; defaults to key `'latLng'`
  * @returns A {@link MatInputField} for coordinate input
  *
+ * @dbxFormField
+ * @dbxFormSlug lat-lng
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeLatLngTextFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeLatLngTextField();
+ * dbxForgeLatLngTextField({ key: 'coords', label: 'Coordinates' })
  * ```
  */
 function dbxForgeLatLngTextField(config = {}) {
@@ -3145,11 +3204,11 @@ function dbxForgeLatLngTextField(config = {}) {
 const FORGE_EXPAND_FIELD_TYPE_NAME = 'dbx-forge-expand';
 
 let _dbxForgeRowCounter = 0;
-let _dbxForgeGroupCounter = 0;
+let _dbxForgeContainerCounter = 0;
 let _dbxForgeToggleCounter = 0;
 let _dbxForgeExpandCounter = 0;
 /**
- * Creates a forge row layout field that arranges child fields horizontally.
+ * Flex row that lays child fields out in columns. Child fields typically carry a `col` property (1–12) for grid placement.
  *
  * Uses the `@ng-forge/dynamic-forms` `RowField` type with a 12-column grid system.
  * Each child field can specify a `col` value (1-12) for responsive sizing.
@@ -3157,14 +3216,17 @@ let _dbxForgeExpandCounter = 0;
  * @param config - Row layout configuration with fields and optional className
  * @returns A {@link RowField} with type `'row'`
  *
+ * @dbxFormField
+ * @dbxFormSlug row
+ * @dbxFormTier primitive
+ * @dbxFormProduces RowField
+ * @dbxFormReturns RowField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeRowConfig
+ *
  * @example
  * ```typescript
- * const row = dbxForgeRow({
- *   fields: [
- *     { ...dbxForgeTextField({ key: 'first', label: 'First' }), col: 6 },
- *     { ...dbxForgeTextField({ key: 'last', label: 'Last' }), col: 6 }
- *   ]
- * });
+ * dbxForgeRow({ fields: [ { ...dbxForgeTextField({ key: 'first' }), col: 6 }, { ...dbxForgeTextField({ key: 'last' }), col: 6 } ] })
  * ```
  */
 function dbxForgeRow(config) {
@@ -3176,52 +3238,156 @@ function dbxForgeRow(config) {
     };
 }
 /**
- * Creates a plain forge group layout field.
+ * Creates a plain ng-forge `group` field. A group produces a nested object in
+ * the form value under its `key`, so the key is semantically significant and
+ * must be chosen deliberately.
  *
- * Groups collect child field values into a nested object when a `key` is provided.
- * When used without a key, the group serves as a visual/logical grouping only.
+ * For visual-only grouping (conditional visibility, layout wrappers, shared
+ * CSS class) that should NOT introduce a nested object in the form value, use
+ * {@link dbxForgeContainer} instead — that is what ng-forge's `container`
+ * field type is for.
  *
  * For sections with headers, use the section wrapper type instead.
  *
- * @param config - Group configuration with fields and optional key/className
+ * @param config - Group configuration with fields and required key
  * @returns A {@link GroupField} with type `'group'`
+ *
+ * @dbxFormField
+ * @dbxFormSlug group
+ * @dbxFormTier primitive
+ * @dbxFormProduces GroupField
+ * @dbxFormReturns GroupField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeGroupConfig
+ *
+ * @example
+ * ```typescript
+ * // Groups the address sub-fields under an `address` property in the form value.
+ * const group = dbxForgeGroup({
+ *   key: 'address',
+ *   fields: [
+ *     dbxForgeTextField({ key: 'city', label: 'City' }),
+ *     dbxForgeTextField({ key: 'state', label: 'State' })
+ *   ]
+ * });
+ *
+ * // Resulting form value shape:
+ * // { address: { city: '...', state: '...' } }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Wrong: if the intent is purely visual (e.g. conditional visibility) and
+ * // the fields should remain at the parent level in the form value, do NOT
+ * // use a group — use dbxForgeContainer instead. Otherwise you end up with a
+ * // spurious nested object:
+ * //   { _group_0: { city: '...', state: '...' } }   // ← unwanted wrapper
+ * ```
  */
 function dbxForgeGroup(config) {
-    const { key: inputKey, ...rest } = config;
+    return {
+        ...config,
+        type: 'group'
+    };
+}
+/**
+ * Creates an ng-forge `container` field. Containers group child fields for
+ * layout, conditional visibility, or wrapper application WITHOUT introducing
+ * a nested object in the form value — child values remain at the same level
+ * as the container itself.
+ *
+ * Use this (not {@link dbxForgeGroup}) whenever the grouping is purely visual
+ * or structural. Use {@link dbxForgeGroup} when the intent is to nest the
+ * child values under a named key in the form value.
+ *
+ * @param config - Container configuration with fields and optional key/wrappers
+ * @returns A {@link ContainerField} with type `'container'`
+ *
+ * @example
+ * ```typescript
+ * // Visual-only grouping (e.g. to apply a CSS class or a wrapper). Children
+ * // remain at the parent level in the form value — the container itself
+ * // does not add a property.
+ * const container = dbxForgeContainer({
+ *   className: 'dbx-highlight-group',
+ *   fields: [
+ *     dbxForgeTextField({ key: 'city', label: 'City' }),
+ *     dbxForgeTextField({ key: 'state', label: 'State' })
+ *   ]
+ * });
+ *
+ * // Resulting form value shape (flat):
+ * // { city: '...', state: '...' }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Conditional visibility without altering the value shape — a common use
+ * // case that should NOT use dbxForgeGroup.
+ * const container = dbxForgeContainer({
+ *   fields: [dbxForgeTextField({ key: 'jwks_uri', label: 'JWKS URI' })],
+ *   logic: [{
+ *     type: 'hidden',
+ *     condition: { type: 'fieldValue', fieldPath: 'authMethod', operator: 'notEquals', value: 'private_key_jwt' }
+ *   }]
+ * });
+ *
+ * // Resulting form value shape (jwks_uri stays flat, not nested):
+ * // { authMethod: '...', jwks_uri: '...' }
+ * ```
+ */
+function dbxForgeContainer(config) {
+    const { key: inputKey, wrappers, ...rest } = config;
     return {
         ...rest,
-        type: 'group',
-        key: inputKey ?? `_group_${_dbxForgeGroupCounter++}`
+        type: 'container',
+        key: inputKey ?? `_container_${_dbxForgeContainerCounter++}`,
+        wrappers: wrappers ?? []
     };
 }
 /**
- * Creates a forge toggle wrapper that shows/hides content via a Material slide toggle.
+ * Wraps content fields in a Material slide toggle — the toggle state controls conditional visibility of the inner fields.
  *
  * Uses ng-forge's built-in `toggle` field type (MatSlideToggle) and
  * `FieldValueCondition` for conditional visibility. The toggle boolean value
- * IS part of the form model (standard ng-forge pattern).
+ * IS part of the form model. The hidden content is wrapped in a `container`
+ * (not a `group`), so the wrapped fields sit at the same level as the toggle
+ * in the form value — they are NOT nested under an extra object.
  *
  * Structure produced:
  * ```
  * Row (outer)
  *   ├── toggle field (type: 'toggle', boolean value)
- *   └── Group (content, hidden when toggle === false)
+ *   └── Container (content, hidden when toggle === false)
  * ```
  *
  * This is the forge equivalent of the formly `formlyToggleWrapper`.
  *
  * @param config - Toggle wrapper configuration
- * @returns A {@link RowField} containing the toggle and content group
+ * @returns A {@link RowField} containing the toggle and content container
+ *
+ * @dbxFormField
+ * @dbxFormSlug toggle-wrapper
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Wrapper
+ * @dbxFormProduces RowField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeToggleWrapperConfig
+ * @dbxFormComposesFrom toggle, group
  *
  * @example
  * ```typescript
  * const toggle = dbxForgeToggleWrapper({
+ *   key: 'showAdvanced',
  *   label: 'Show advanced options',
  *   fields: [
  *     dbxForgeTextField({ key: 'advanced1', label: 'Option 1' }),
  *     dbxForgeTextField({ key: 'advanced2', label: 'Option 2' })
  *   ]
  * });
+ *
+ * // Resulting form value (flat — no nesting under the container):
+ * // { showAdvanced: true, advanced1: '...', advanced2: '...' }
  * ```
  */
 function dbxForgeToggleWrapper(config) {
@@ -3233,7 +3399,9 @@ function dbxForgeToggleWrapper(config) {
         label: config.label ?? '',
         value: config.defaultOpen ?? false
     };
-    // Content group with conditional visibility based on toggle value
+    // Content container with conditional visibility based on toggle value.
+    // A container is used (not a group) so the wrapped fields stay at the same
+    // level in the form value as the toggle itself.
     const hiddenCondition = {
         type: 'hidden',
         condition: {
@@ -3243,38 +3411,51 @@ function dbxForgeToggleWrapper(config) {
             value: false
         }
     };
-    const contentGroup = dbxForgeGroup({
-        key: config.contentKey,
+    const contentContainer = dbxForgeContainer({
+        ...(config.contentKey != null && { key: config.contentKey }),
         fields: config.fields,
         logic: [hiddenCondition]
     });
     return dbxForgeRow({
-        fields: [toggleField, contentGroup],
+        fields: [toggleField, contentContainer],
         className: config.className ?? 'dbx-forge-toggle-wrapper'
     });
 }
 /**
- * Creates a forge expand wrapper that shows/hides content via a button or text link.
+ * Wraps content fields behind a button or text "expand" control. Use for optional sections like "Show advanced options".
  *
  * Uses a custom `dbx-forge-expand` field type for the expand trigger and
- * `FieldValueCondition` for conditional visibility on the content group.
- * The expand boolean value IS part of the form model.
+ * `FieldValueCondition` for conditional visibility on the content. The
+ * expand boolean value IS part of the form model. The hidden content is
+ * wrapped in a `container` (not a `group`), so the wrapped fields sit at the
+ * same level as the expand control in the form value — they are NOT nested
+ * under an extra object.
  *
  * Structure produced:
  * ```
  * Row (outer)
  *   ├── expand field (type: 'dbx-forge-expand', boolean value)
- *   └── Group (content, hidden when expand field === false)
+ *   └── Container (content, hidden when expand field === false)
  * ```
  *
  * This is the forge equivalent of the formly `formlyExpandWrapper`.
  *
  * @param config - Expand wrapper configuration
- * @returns A {@link RowField} containing the expand control and content group
+ * @returns A {@link RowField} containing the expand control and content container
+ *
+ * @dbxFormField
+ * @dbxFormSlug expand-wrapper
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Wrapper
+ * @dbxFormProduces RowField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeExpandWrapperConfig
+ * @dbxFormComposesFrom group
  *
  * @example
  * ```typescript
  * const expand = dbxForgeExpandWrapper({
+ *   key: 'showMore',
  *   label: 'Show more options',
  *   buttonType: 'button',
  *   fields: [
@@ -3282,6 +3463,9 @@ function dbxForgeToggleWrapper(config) {
  *     dbxForgeTextField({ key: 'extra2', label: 'Extra 2' })
  *   ]
  * });
+ *
+ * // Resulting form value (flat — no nesting under the container):
+ * // { showMore: true, extra1: '...', extra2: '...' }
  * ```
  */
 function dbxForgeExpandWrapper(config) {
@@ -3305,13 +3489,13 @@ function dbxForgeExpandWrapper(config) {
             value: false
         }
     };
-    const contentGroup = dbxForgeGroup({
-        key: config.contentKey,
+    const contentContainer = dbxForgeContainer({
+        ...(config.contentKey != null && { key: config.contentKey }),
         fields: config.fields,
         logic: [hiddenCondition]
     });
     return dbxForgeRow({
-        fields: [expandField, contentGroup],
+        fields: [expandField, contentContainer],
         className: config.className ?? 'dbx-forge-expand-wrapper'
     });
 }
@@ -3322,7 +3506,7 @@ const DBX_FORGE_ARRAY_FIELD_ELEMENT_WRAPPER_NAME = 'dbx-forge-array-field-elemen
 
 // MARK: Internal
 /**
- * Creates a forge array field with add/remove controls and per-item rendering.
+ * Repeatable array wrapper with add/remove/drag-to-reorder controls. Template fields are cloned per item. Internally built with `dbxForgeFieldFunction` but categorized as a primitive because composites wrap it.
  *
  * Wraps the array with {@link DbxForgeArrayFieldWrapperComponent} for label/hint,
  * and wraps each template item in a ContainerField with
@@ -3332,17 +3516,17 @@ const DBX_FORGE_ARRAY_FIELD_ELEMENT_WRAPPER_NAME = 'dbx-forge-array-field-elemen
  * @param config - Array field configuration
  * @returns A {@link DbxForgeField}
  *
+ * @dbxFormField
+ * @dbxFormSlug array-field
+ * @dbxFormTier primitive
+ * @dbxFormProduces ArrayField
+ * @dbxFormReturns ArrayField
+ * @dbxFormArrayOutput yes
+ * @dbxFormConfigInterface DbxForgeArrayFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeArrayField({
- *   key: 'phones',
- *   label: 'Phone Numbers',
- *   addText: 'Add Phone',
- *   template: [
- *     dbxForgeTextField({ key: 'number', label: 'Number' }),
- *     dbxForgeTextField({ key: 'label', label: 'Label' })
- *   ]
- * });
+ * dbxForgeArrayField({ key: 'tags', template: [dbxForgeTextField({ key: 'value' })] })
  * ```
  */
 const dbxForgeArrayField = dbxForgeFieldFunction({
@@ -3392,15 +3576,20 @@ const dbxForgeArrayField = dbxForgeFieldFunction({
 });
 
 /**
- * Creates a forge text field for a single address line.
+ * Street address line input. The `line` prop controls which line (1 or 2) — it affects key and label generation.
  *
  * @param config - Optional overrides; line number determines key and label
  * @returns A {@link MatInputField} for address line input
  *
+ * @dbxFormField
+ * @dbxFormSlug address-line
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeAddressLineFieldConfig
  * @example
  * ```typescript
- * const line1 = dbxForgeAddressLineField({ line: 1, required: true });
- * const line2 = dbxForgeAddressLineField({ line: 2 });
+ * dbxForgeAddressLineField({ line: 2 })
  * ```
  */
 function dbxForgeAddressLineField(config = {}) {
@@ -3417,15 +3606,20 @@ function dbxForgeAddressLineField(config = {}) {
     });
 }
 /**
- * Creates the full set of address form fields (lines, city, state, zip, and optionally country)
- * arranged in a flex row layout.
+ * Flat array of address fields (line(s), city, state, zip, optional country) with a sensible flex layout. Drop directly into a parent `fields: []`.
  *
  * @param config - Address fields configuration
  * @returns Array of forge field definitions for a complete address form section
  *
+ * @dbxFormField
+ * @dbxFormSlug address-fields
+ * @dbxFormProduces FieldDef[]
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldTemplate address-line, city, state, zip-code, country
+ * @dbxFormConfigInterface DbxForgeAddressFieldsConfig
  * @example
  * ```typescript
- * const fields = dbxForgeAddressFields({ required: true, includeCountry: false });
+ * dbxForgeAddressFields({ required: true, includeCountry: false })
  * ```
  */
 function dbxForgeAddressFields(config = {}) {
@@ -3453,14 +3647,22 @@ function dbxForgeAddressFields(config = {}) {
     return fields;
 }
 /**
- * Composite builder that wraps the full set of address sub-fields in a group.
+ * Wraps `address-fields` in a `GroupField` so the address is stored as a nested object under one key. Prefer this when the rest of the form doesn't want address fields flattened.
  *
  * @param config - Optional overrides; defaults to key `'address'`
  * @returns A {@link GroupField} containing address fields
  *
+ * @dbxFormField
+ * @dbxFormSlug address-group
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Group
+ * @dbxFormProduces GroupField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeAddressGroupConfig
+ * @dbxFormComposesFrom address-fields, group
  * @example
  * ```typescript
- * const group = dbxForgeAddressGroup({ required: true, includeCountry: true });
+ * dbxForgeAddressGroup({ key: 'billingAddress' })
  * ```
  */
 function dbxForgeAddressGroup(config = {}) {
@@ -3471,15 +3673,22 @@ function dbxForgeAddressGroup(config = {}) {
     });
 }
 /**
- * Creates a draggable repeat-array field that allows the user to add, remove,
- * and reorder multiple addresses.
+ * Repeatable array of addresses built on top of `array-field` + `address-group`. Keeps the `Field` suffix because it returns a single composite field whose value is an array of addresses.
  *
  * @param config - Optional overrides; defaults to key `'addresses'`, max 6 entries
  * @returns A {@link DbxForgeArrayFieldDef} for multiple addresses
  *
+ * @dbxFormField
+ * @dbxFormSlug address-list
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Field
+ * @dbxFormProduces ArrayField
+ * @dbxFormArrayOutput yes
+ * @dbxFormConfigInterface DbxForgeAddressListFieldConfig
+ * @dbxFormComposesFrom address-group, array-field
  * @example
  * ```typescript
- * const field = dbxForgeAddressListField({ maxAddresses: 3, required: true });
+ * dbxForgeAddressListField({ maxAddresses: 3 })
  * ```
  */
 function dbxForgeAddressListField(config = {}) {
@@ -3502,7 +3711,7 @@ function dbxForgeAddressListField(config = {}) {
  */
 const FORGE_IS_DIVISIBLE_BY_VALIDATION_KEY = 'isDivisibleBy';
 /**
- * Creates a forge field definition for a numeric input.
+ * Numeric input (HTML `type="number"`). Supports min/max/step constraints, optional step enforcement (divisibility validator), and idempotent number transforms.
  *
  * When `step` is provided, sets the HTML `step` attribute on the input via `meta`.
  * When both `step` and `enforceStep` are set, adds a custom divisibility validator.
@@ -3510,9 +3719,17 @@ const FORGE_IS_DIVISIBLE_BY_VALIDATION_KEY = 'isDivisibleBy';
  * @param config - Number field configuration
  * @returns A validated {@link MatInputField} with input type `'number'`
  *
+ * @dbxFormField
+ * @dbxFormSlug number
+ * @dbxFormTier field-factory
+ * @dbxFormProduces number
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType input
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeNumberFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeNumberField({ key: 'quantity', label: 'Quantity', min: 1, max: 100, step: 1 });
+ * dbxForgeNumberField({ key: 'quantity', label: 'Quantity', min: 1, max: 100, step: 1, enforceStep: true })
  * ```
  */
 const dbxForgeNumberField = dbxForgeFieldFunction({
@@ -3557,11 +3774,17 @@ const dbxForgeNumberField = dbxForgeFieldFunction({
     })
 });
 /**
- * Creates a forge number field pre-configured for dollar amount input with cent-level precision.
+ * Forge number field pre-configured for dollar amount input with cent-level precision. Pre-sets `transform.precision` to `DOLLAR_AMOUNT_PRECISION` so values round to whole cents.
  *
  * @param config - Number field configuration (precision is overridden to dollar amount precision)
  * @returns A {@link MatInputField} for dollar amount input
  *
+ * @dbxFormField
+ * @dbxFormSlug dollar-amount
+ * @dbxFormProduces number
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative number
+ * @dbxFormConfigInterface DbxForgeDollarAmountFieldConfig
  * @example
  * ```typescript
  * const field = dbxForgeDollarAmountField({ key: 'price', label: 'Price', min: 0, required: true });
@@ -3599,19 +3822,26 @@ function configureDbxForgeFormFieldWrapper(instance) {
 }
 
 /**
- * Creates a forge field definition for a Material slider wrapped in a form-field wrapper.
+ * Material slider wrapped in a form-field container. Supports thumb label, tick interval, and step-derived tick spacing.
  *
  * The wrapper provides the Material outlined form-field appearance (notched outline with
  * floating label, hint/error subscript). The inner slider uses the ng-forge built-in
- * `slider` type. The wrapper key uses `_` prefix so `stripForgeInternalKeys` flattens
- * the child slider's value into the parent form.
+ * `slider` type.
  *
  * @param config - Slider field configuration including max (required), thumb label, and tick interval
  * @returns A {@link DbxForgeFormFieldWrapperDef} wrapping a slider field
  *
+ * @dbxFormField
+ * @dbxFormSlug number-slider
+ * @dbxFormTier field-factory
+ * @dbxFormProduces number
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType slider
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeNumberSliderFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeNumberSliderField({ key: 'rating', label: 'Rating', min: 0, max: 10, step: 1 });
+ * dbxForgeNumberSliderField({ key: 'rating', label: 'Rating', min: 0, max: 10, step: 1 })
  * ```
  */
 const dbxForgeNumberSliderField = dbxForgeFieldFunction({
@@ -3645,14 +3875,22 @@ const dbxForgeNumberSliderField = dbxForgeFieldFunction({
  */
 const FORGE_STYLED_BOX_CLASS = 'dbx-forge-styled-box';
 /**
- * Creates a forge field definition for a Material slide toggle.
+ * Material slide toggle. Renders inside a styled outline box by default so it visually matches surrounding outlined form fields; pass `styledBox: false` to opt out.
  *
  * @param config - Toggle field configuration
  * @returns A validated {@link MatToggleField} with type `'toggle'`
  *
+ * @dbxFormField
+ * @dbxFormSlug toggle
+ * @dbxFormTier field-factory
+ * @dbxFormProduces boolean
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType toggle
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeToggleFieldConfig
  * @example
  * ```typescript
- * const field = dbxForgeToggleField({ key: 'active', label: 'Active', value: true });
+ * dbxForgeToggleField({ key: 'active', label: 'Active', value: true })
  * ```
  */
 const dbxForgeToggleField = dbxForgeFieldFunction({
@@ -3665,14 +3903,23 @@ const dbxForgeToggleField = dbxForgeFieldFunction({
     })
 });
 /**
- * Creates a forge field definition for a Material checkbox.
+ * Material checkbox. Shares the styled-outline-box opt-out with toggle.
  *
  * @param config - Checkbox field configuration
  * @returns A validated {@link MatCheckboxField} with type `'checkbox'`
  *
+ * @dbxFormField
+ * @dbxFormSlug checkbox
+ * @dbxFormTier field-factory
+ * @dbxFormProduces boolean
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType checkbox
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeCheckboxFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeCheckboxField({ key: 'agree', label: 'I agree to the terms' });
+ * dbxForgeCheckboxField({ key: 'agree', label: 'I agree to the terms' })
  * ```
  */
 const dbxForgeCheckboxField = dbxForgeFieldFunction({
@@ -4895,16 +5142,25 @@ function navigateDate(currentDate, step, config) {
 }
 
 /**
- * Creates a forge field definition for a date picker input.
+ * Material datepicker (date-only, no time). For time-of-day picking use the `date-time` field; for ranges use `date-range-row` or `date-time-range-row`.
  *
  * Uses the native ng-forge MatDatepickerField.
  *
  * @param config - Date field configuration including key, label, and date constraints
  * @returns A validated {@link MatDatepickerField}
  *
+ * @dbxFormField
+ * @dbxFormSlug date
+ * @dbxFormTier field-factory
+ * @dbxFormProduces Date
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType datepicker
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeDateFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeDateField({ key: 'startDate', label: 'Start Date', required: true });
+ * dbxForgeDateField({ key: 'startDate', label: 'Start Date', required: true })
  * ```
  */
 const dbxForgeDateField = dbxForgeFieldFunction({
@@ -4918,7 +5174,7 @@ const dbxForgeDateField = dbxForgeFieldFunction({
  */
 const FORGE_DATETIME_FIELD_TYPE = 'datetime';
 /**
- * Creates a forge field definition for a combined date-time picker.
+ * Combined date-time picker with timezone, value mode (DATE_STRING / TIMESTAMP / Date), and time mode (REQUIRED / OPTIONAL / NONE). Powers `date-range-row` and `date-time-range-row`.
  *
  * Full parity with formly `dateTimeField()` — supports timezone, valueMode, timeMode,
  * pickerConfig, presets, and all other features via the `props` slot.
@@ -4926,18 +5182,19 @@ const FORGE_DATETIME_FIELD_TYPE = 'datetime';
  * @param config - Date-time field configuration
  * @returns A {@link DbxForgeDateTimeFieldDef}
  *
+ * @dbxFormField
+ * @dbxFormSlug date-time
+ * @dbxFormTier field-factory
+ * @dbxFormProduces DateTimeValue
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType datetime
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeDateTimeFieldConfig
+ * @dbxFormPropsInterface DbxForgeDateTimeFieldComponentProps
+ *
  * @example
  * ```typescript
- * const field = dbxForgeDateTimeField({
- *   key: 'eventStart',
- *   label: 'Start',
- *   required: true,
- *   props: {
- *     timezone: 'America/New_York',
- *     valueMode: DbxDateTimeValueMode.DATE_STRING,
- *     timeMode: DbxDateTimeFieldTimeMode.OPTIONAL
- *   }
- * });
+ * dbxForgeDateTimeField({ key: 'when', label: 'When', timezone: 'America/New_York' })
  * ```
  */
 const dbxForgeDateTimeField = dbxForgeFieldFunction({
@@ -4946,6 +5203,8 @@ const dbxForgeDateTimeField = dbxForgeFieldFunction({
 });
 
 /**
+ * Two-column row of start/end date-time fields configured for date-only picking. Use when you need a paired start/end date range laid out horizontally.
+ *
  * Composite builder that creates a pair of date pickers for selecting a date range (start and end dates)
  * arranged in a flex row. The pickers are synchronized so the start date stays before the end date.
  *
@@ -4954,14 +5213,18 @@ const dbxForgeDateTimeField = dbxForgeFieldFunction({
  * @param config - Date range configuration with optional shared props and start/end overrides
  * @returns A {@link RowField} containing the start and end date field pair
  *
+ * @dbxFormField
+ * @dbxFormSlug date-range-row
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Row
+ * @dbxFormProduces RowField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeDateRangeRowConfig
+ * @dbxFormComposesFrom date-time, row
+ *
  * @example
  * ```typescript
- * const row = dbxForgeDateRangeRow({
- *   required: true,
- *   props: { timezone: 'America/New_York' },
- *   start: { key: 'from' },
- *   end: { key: 'to' }
- * });
+ * dbxForgeDateRangeRow({ required: true, start: { key: 'from', label: 'From' }, end: { key: 'to', label: 'To' } })
  * ```
  */
 function dbxForgeDateRangeRow(config = {}) {
@@ -5004,17 +5267,25 @@ function dbxForgeDateRangeRow(config = {}) {
 }
 
 /**
- * Composite builder that creates a pair of time-only pickers for selecting a time range (start and end times)
- * arranged in a flex row.
+ * Two-column row of time-only pickers for selecting a time range within a single day.
  *
  * This is the forge equivalent of formly's `formlyDateTimeRangeField()`.
  *
  * @param inputConfig - Time range configuration with optional shared props and start/end overrides
  * @returns A {@link RowField} containing the start and end time field pair
  *
+ * @dbxFormField
+ * @dbxFormSlug date-time-range-row
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Row
+ * @dbxFormProduces RowField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeDateTimeRangeRowConfig
+ * @dbxFormComposesFrom date-time, row
+ *
  * @example
  * ```typescript
- * const row = dbxForgeDateTimeRangeRow({ required: true });
+ * dbxForgeDateTimeRangeRow({ start: { label: 'From' }, end: { label: 'Until' } })
  * ```
  */
 function dbxForgeDateTimeRangeRow(inputConfig = {}) {
@@ -5063,31 +5334,28 @@ function dbxForgeDateTimeRangeRow(inputConfig = {}) {
  */
 const FORGE_FIXEDDATERANGE_FIELD_TYPE = 'fixeddaterange';
 /**
- * Creates a forge field definition for a fixed date range picker wrapped in a Material-style
- * outlined container with a notched outline and floating label.
+ * Inline calendar-style date-range picker with fixed range length (e.g. "7 days from start"). Wrapped in a Material form-field container with a custom selection strategy.
  *
  * Uses an inline `<mat-calendar>` with a custom selection strategy, matching the formly
  * `fixedDateRangeField()` behavior. Supports multiple selection modes, timezone conversion,
  * date range input configuration, and optional text inputs.
  *
- * The field is wrapped by `configureDbxForgeFormFieldWrapper` which provides the Material outlined
- * container, equivalent to formly's `['style', 'form-field']` wrappers.
- *
  * @param config - Fixed date range field configuration
  * @returns A {@link DbxForgeFixedDateRangeFieldDef}
  *
+ * @dbxFormField
+ * @dbxFormSlug fixed-date-range
+ * @dbxFormTier field-factory
+ * @dbxFormProduces DbxForgeFixedDateRangeValue
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType fixeddaterange
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeFixedDateRangeFieldConfig
+ * @dbxFormPropsInterface DbxForgeFixedDateRangeFieldComponentProps
+ *
  * @example
  * ```typescript
- * const field = dbxForgeFixedDateRangeField({
- *   key: 'dateRange',
- *   label: 'Fixed Date Range',
- *   required: true,
- *   props: {
- *     dateRangeInput: { type: DateRangeType.WEEKS_RANGE, distance: 1 },
- *     pickerConfig: { limits: { min: 'today_start', max: addMonths(endOfMonth(new Date()), 1) } },
- *     valueMode: DbxDateTimeValueMode.DATE_STRING
- *   }
- * });
+ * dbxForgeFixedDateRangeField({ key: 'range', label: 'Date Range' })
  * ```
  */
 const dbxForgeFixedDateRangeField = dbxForgeFieldFunction({
@@ -6555,7 +6823,7 @@ var fixeddaterange_field_component = /*#__PURE__*/Object.freeze({
  */
 const FORGE_TIMEDURATION_FIELD_TYPE = 'timeduration';
 /**
- * Creates a forge field definition for a time duration input.
+ * Duration input with popover picker. Output shape varies by `valueMode` — number (ms/s/…), string, or structured object.
  *
  * Uses a custom ng-forge ValueFieldComponent that provides a text input
  * accepting duration strings (e.g. "2h30m") and a popover picker.
@@ -6563,15 +6831,18 @@ const FORGE_TIMEDURATION_FIELD_TYPE = 'timeduration';
  * @param config - Time duration field configuration
  * @returns A {@link DbxForgeTimeDurationFieldDef}
  *
+ * @dbxFormField
+ * @dbxFormSlug time-duration
+ * @dbxFormTier field-factory
+ * @dbxFormProduces TimeDurationValue
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType timeduration
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeTimeDurationFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeTimeDurationField({
- *   key: 'timeout',
- *   label: 'Timeout',
- *   outputUnit: 'min',
- *   min: 0,
- *   max: 480
- * });
+ * dbxForgeTimeDurationField({ key: 'duration', label: 'Duration', outputUnit: 'm' })
  * ```
  */
 const dbxForgeTimeDurationField = dbxForgeFieldFunction({
@@ -7109,7 +7380,7 @@ var duration_field_component = /*#__PURE__*/Object.freeze({
  */
 const FORGE_PHONE_FIELD_TYPE = 'phone';
 /**
- * Creates a forge field definition for an international phone number input.
+ * International phone number input backed by ngx-mat-input-tel. Supports preferred-country lists, search, and optional extension input.
  *
  * Uses the custom 'phone' field type which renders the ngx-mat-input-tel component
  * bridged to Signal Forms.
@@ -7117,9 +7388,18 @@ const FORGE_PHONE_FIELD_TYPE = 'phone';
  * @param config - Phone field configuration
  * @returns A forge field definition for the phone input
  *
+ * @dbxFormField
+ * @dbxFormSlug phone
+ * @dbxFormTier field-factory
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType phone
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgePhoneFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgePhoneField({ key: 'phone', label: 'Phone Number', required: true });
+ * dbxForgePhoneField({ key: 'phone', label: 'Phone', preferredCountries: ['US', 'CA'] })
  * ```
  */
 const dbxForgePhoneField = dbxForgeFieldFunction({
@@ -7592,7 +7872,7 @@ var selection_field_component = /*#__PURE__*/Object.freeze({
 
 // MARK: Factory
 /**
- * Creates a forge field definition for a Material select (dropdown) field.
+ * Single-select dropdown over a static or async value list. Simpler than `source-select` when metadata lookup is unnecessary.
  *
  * The component uses `<mat-form-field>` with `[formField]` for native ng-forge value binding,
  * proper Material rendering, and built-in logic (hidden/disabled/readonly) support.
@@ -7602,26 +7882,19 @@ var selection_field_component = /*#__PURE__*/Object.freeze({
  * @param config - Selection field configuration
  * @returns A forge field definition for the value selection component
  *
+ * @dbxFormField
+ * @dbxFormSlug value-selection
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType dbx-value-selection
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeValueSelectionFieldConfig<T>
+ * @dbxFormGeneric <T = unknown>
+ *
  * @example
  * ```typescript
- * // Static options
- * const field = dbxForgeValueSelectionField({
- *   key: 'color',
- *   label: 'Color',
- *   props: {
- *     options: [{ label: 'Red', value: 'red' }, { label: 'Blue', value: 'blue' }]
- *   }
- * });
- *
- * // Observable options
- * const field = dbxForgeValueSelectionField({
- *   key: 'status',
- *   label: 'Status',
- *   props: {
- *     options: status$.pipe(map(statuses => statuses.map(s => ({ label: s.name, value: s.id })))),
- *     addClearOption: 'No Selection'
- *   }
- * });
+ * dbxForgeValueSelectionField<string>({ key: 'status', props: { options: [{ value: 'active', label: 'Active' }] } })
  * ```
  */
 const dbxForgeValueSelectionField = dbxForgeFieldFunction({
@@ -7872,21 +8145,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
  */
 const DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME = 'dbx-searchable-text';
 /**
- * Creates a forge field definition for a searchable text field with autocomplete.
+ * Single-value autocomplete field with search-as-you-type. Optionally allows free-form typed strings as values.
  *
  * @param config - Searchable text field configuration
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a searchable text field
  *
+ * @dbxFormField
+ * @dbxFormSlug searchable-text
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType dbx-searchable-text
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeSearchableTextFieldConfig<T, M, H>
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
+ *
  * @example
  * ```typescript
- * const field = dbxForgeSearchableTextField({
- *   key: 'assignee',
- *   label: 'Assignee',
- *   props: {
- *     search: (text) => mySearchService.search(text),
- *     displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.name ?? '' })))
- *   }
- * });
+ * dbxForgeSearchableTextField<User>({ key: 'user', props: { search, displayForValue } })
  * ```
  */
 const dbxForgeSearchableTextField = dbxForgeFieldFunction({
@@ -7904,22 +8180,24 @@ const dbxForgeSearchableTextField = dbxForgeFieldFunction({
  */
 const DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME = 'dbx-searchable-chip';
 /**
- * Creates a forge field definition for a searchable chip field with autocomplete and chips.
+ * Multi-value autocomplete with chips. Defaults to multi-select; supports free-form text entry when `allowStringValues` is set.
  *
  * @param config - Searchable chip field configuration
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a searchable chip field
  *
+ * @dbxFormField
+ * @dbxFormSlug searchable-chip
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T | T[]
+ * @dbxFormArrayOutput optional
+ * @dbxFormNgFormType dbx-searchable-chip
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeSearchableChipFieldConfig<T, M, H>
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
+ *
  * @example
  * ```typescript
- * const field = dbxForgeSearchableChipField({
- *   key: 'tags',
- *   label: 'Tags',
- *   props: {
- *     search: (text) => tagService.search(text),
- *     displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.name ?? '' }))),
- *     allowStringValues: true
- *   }
- * });
+ * dbxForgeSearchableChipField<Tag>({ key: 'tags', props: { search, displayForValue } })
  * ```
  */
 const dbxForgeSearchableChipField = dbxForgeFieldFunction({
@@ -7931,13 +8209,27 @@ const dbxForgeSearchableChipField = dbxForgeFieldFunction({
     })
 });
 /**
- * Creates a forge searchable chip field pre-configured for string values.
+ * String-value specialization of `searchable-chip`. `allowStringValues` is forced true — use for free-form tag entry.
  *
  * Always sets `allowStringValues: true` on the inner field props so pressing Enter
  * (or typing a separator key) commits the typed value as a chip.
  *
  * @param config - String-specific searchable chip field configuration (omits allowStringValues)
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a searchable chip field
+ *
+ * @dbxFormField
+ * @dbxFormSlug searchable-string-chip
+ * @dbxFormTier field-factory
+ * @dbxFormProduces string | string[]
+ * @dbxFormArrayOutput optional
+ * @dbxFormNgFormType dbx-searchable-chip
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeSearchableStringChipFieldConfig
+ *
+ * @example
+ * ```typescript
+ * dbxForgeSearchableStringChipField({ key: 'tags', props: { search, displayForValue } })
+ * ```
  */
 function dbxForgeSearchableStringChipField(config) {
     return dbxForgeSearchableChipField({
@@ -8495,20 +8787,25 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.4", ngImpor
         }], propDecorators: { field: [{ type: i0.Input, args: [{ isSignal: true, alias: "field", required: true }] }], key: [{ type: i0.Input, args: [{ isSignal: true, alias: "key", required: true }] }], label: [{ type: i0.Input, args: [{ isSignal: true, alias: "label", required: false }] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], className: [{ type: i0.Input, args: [{ isSignal: true, alias: "className", required: false }] }], tabIndex: [{ type: i0.Input, args: [{ isSignal: true, alias: "tabIndex", required: false }] }], props: [{ type: i0.Input, args: [{ isSignal: true, alias: "props", required: false }] }], meta: [{ type: i0.Input, args: [{ isSignal: true, alias: "meta", required: false }] }], validationMessages: [{ type: i0.Input, args: [{ isSignal: true, alias: "validationMessages", required: false }] }], defaultValidationMessages: [{ type: i0.Input, args: [{ isSignal: true, alias: "defaultValidationMessages", required: false }] }] } });
 
 /**
- * Creates a forge field definition for a pickable chip field.
+ * Selection field rendering selected values as Material chips. Defaults to multi-select; flip to single-select via the underlying props.
  *
  * @param config - Pickable chip field configuration
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a pickable chip field
  *
+ * @dbxFormField
+ * @dbxFormSlug pickable-chip
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T | T[]
+ * @dbxFormArrayOutput optional
+ * @dbxFormNgFormType dbx-pickable-chip
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgePickableChipFieldConfig<T, M, H>
+ * @dbxFormPropsInterface DbxForgePickableFieldProps
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
+ *
  * @example
  * ```typescript
- * const field = dbxForgePickableChipField({
- *   key: 'tags',
- *   label: 'Tags',
- *   loadValues: () => tags$,
- *   displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.label ?? '' }))),
- *   hashForValue: (tag) => tag.id
- * });
+ * dbxForgePickableChipField<Tag>({ key: 'tags', label: 'Tags', props: { loadValues: () => loadTags$, displayForValue: displayTag } })
  * ```
  */
 const dbxForgePickableChipField = dbxForgeFieldFunction({
@@ -8521,20 +8818,25 @@ const dbxForgePickableChipField = dbxForgeFieldFunction({
 });
 
 /**
- * Creates a forge field definition for a pickable list field.
+ * Scrollable-list variant of `pickable-chip` — same API, different presentation. Prefer this when the option set is large.
  *
  * @param config - Pickable list field configuration
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a pickable list field
  *
+ * @dbxFormField
+ * @dbxFormSlug pickable-list
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T | T[]
+ * @dbxFormArrayOutput optional
+ * @dbxFormNgFormType dbx-pickable-list
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgePickableListFieldConfig<T, M, H>
+ * @dbxFormPropsInterface DbxForgePickableFieldProps
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
+ *
  * @example
  * ```typescript
- * const field = dbxForgePickableListField({
- *   key: 'categories',
- *   label: 'Categories',
- *   loadValues: () => categories$,
- *   displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.label ?? '' }))),
- *   hashForValue: (cat) => cat.id
- * });
+ * dbxForgePickableListField<Item>({ key: 'items', props: { loadValues, displayForValue } })
  * ```
  */
 const dbxForgePickableListField = dbxForgeFieldFunction({
@@ -8628,7 +8930,7 @@ var pickableList_field_component = /*#__PURE__*/Object.freeze({
  */
 const FORGE_SOURCE_SELECT_FIELD_TYPE = 'dbx-source-select';
 /**
- * Creates a forge field definition for a source select field.
+ * Selection field that stores just the value key (`T`) but resolves full metadata (`M`) async for display. Use for reference fields where the form should store only the id.
  *
  * The component uses `<mat-form-field>` with `[formField]` for native ng-forge value binding,
  * proper Material rendering, and built-in logic (hidden/disabled/readonly) support.
@@ -8636,17 +8938,19 @@ const FORGE_SOURCE_SELECT_FIELD_TYPE = 'dbx-source-select';
  * @param config - Source select field configuration
  * @returns A {@link DbxForgeSourceSelectFieldDef}
  *
+ * @dbxFormField
+ * @dbxFormSlug source-select
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T | T[]
+ * @dbxFormArrayOutput optional
+ * @dbxFormNgFormType dbx-source-select
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeSourceSelectFieldConfig<T, M>
+ * @dbxFormGeneric <T extends PrimativeKey = PrimativeKey, M = unknown>
+ *
  * @example
  * ```typescript
- * const field = dbxForgeSourceSelectField({
- *   key: 'source',
- *   label: 'Source',
- *   props: {
- *     valueReader: (meta) => meta.id,
- *     metaLoader: (values) => myService.loadMeta(values),
- *     displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta.name })))
- *   }
- * });
+ * dbxForgeSourceSelectField<string, User>({ key: 'userId', props: { valueReader: (u) => u.id, metaLoader, displayForValue } })
  * ```
  */
 const dbxForgeSourceSelectField = dbxForgeFieldFunction({
@@ -9023,22 +9327,24 @@ var sourceselect_field_component = /*#__PURE__*/Object.freeze({
  */
 const FORGE_LIST_SELECTION_FIELD_TYPE = 'dbx-list-selection';
 /**
- * Creates a forge field definition for a list selection field.
+ * Multi-select backed by a lazy-loadable custom list component. Use when you need complete control over item layout and pagination.
  *
  * @param config - List selection field configuration
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a list selection field
  *
+ * @dbxFormField
+ * @dbxFormSlug list-selection
+ * @dbxFormTier field-factory
+ * @dbxFormProduces K[]
+ * @dbxFormArrayOutput yes
+ * @dbxFormNgFormType dbx-list-selection
+ * @dbxFormWrapperPattern material-form-field-wrapped
+ * @dbxFormConfigInterface DbxForgeListSelectionFieldConfig<T, C, K>
+ * @dbxFormGeneric <T = unknown, C extends AbstractDbxSelectionListWrapperDirective<T> = AbstractDbxSelectionListWrapperDirective<T>, K extends PrimativeKey = PrimativeKey>
+ *
  * @example
  * ```typescript
- * const field = dbxForgeListSelectionField({
- *   key: 'selectedItems',
- *   label: 'Items',
- *   props: {
- *     listComponentClass: of(MyListComponent),
- *     readKey: (item) => item.id,
- *     state$: items$
- *   }
- * });
+ * dbxForgeListSelectionField<Item, MyListComponent, string>({ key: 'items', props: { listComponentClass, readKey: (i) => i.id, state$ } })
  * ```
  */
 const dbxForgeListSelectionField = dbxForgeFieldFunction({
@@ -9197,21 +9503,24 @@ var list_field_component = /*#__PURE__*/Object.freeze({
 });
 
 /**
- * Creates a forge field definition for a Material multi-checkbox (checklist) field.
+ * Multi-checkbox group. Use for small static option sets where every option is visible at once.
  *
  * @param config - Checklist field configuration
  * @returns A validated {@link MatMultiCheckboxField} with type `'multi-checkbox'`
  *
+ * @dbxFormField
+ * @dbxFormSlug checklist
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T[]
+ * @dbxFormArrayOutput yes
+ * @dbxFormNgFormType multi-checkbox
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeChecklistFieldConfig<T>
+ * @dbxFormGeneric <T = unknown>
+ *
  * @example
  * ```typescript
- * const field = dbxForgeChecklistField({
- *   key: 'tags',
- *   label: 'Tags',
- *   options: [
- *     { label: 'Frontend', value: 'frontend' },
- *     { label: 'Backend', value: 'backend' }
- *   ]
- * });
+ * dbxForgeChecklistField<string>({ key: 'flags', props: { options: [{ value: 'a', label: 'A' }, { value: 'b', label: 'B' }] } })
  * ```
  */
 const dbxForgeChecklistField = dbxForgeFieldFunction({
@@ -9293,7 +9602,7 @@ const _dbxForgeComponentField = dbxForgeFieldFunction({
     type: FORGE_COMPONENT_FIELD_TYPE
 });
 /**
- * Creates a forge field definition that renders a custom Angular component.
+ * Escape hatch — injects any Angular component as the field renderer via DbxInjection. Use when no existing form field fits.
  *
  * Uses {@link DbxInjectionComponent} to dynamically inject any Angular component
  * into the form. Generates a unique key when none is provided so that ng-forge's
@@ -9302,12 +9611,19 @@ const _dbxForgeComponentField = dbxForgeFieldFunction({
  * @param config - Component field configuration
  * @returns A validated {@link DbxForgeComponentFieldDef}
  *
+ * @dbxFormField
+ * @dbxFormSlug component-field
+ * @dbxFormTier field-factory
+ * @dbxFormProduces T
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType component
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeComponentFieldConfig<T>
+ * @dbxFormGeneric <T = unknown>
+ *
  * @example
  * ```typescript
- * const field = dbxForgeComponentField({
- *   key: 'custom',
- *   props: { componentField: { componentClass: MyCustomFormComponent, data: { someInput: 'value' } } }
- * });
+ * dbxForgeComponentField<MyValue>({ key: 'custom', props: { component: MyCustomComp } })
  * ```
  */
 const dbxForgeComponentField = (config) => {
@@ -9436,7 +9752,7 @@ var texteditor_field_component = /*#__PURE__*/Object.freeze({
 });
 
 /**
- * Creates a forge field definition for a rich text editor.
+ * Rich HTML text editor (ngx-editor). Output is the serialized HTML string.
  *
  * Uses ngx-editor under the hood, outputting HTML format.
  * The field defaults to an empty string.
@@ -9444,9 +9760,18 @@ var texteditor_field_component = /*#__PURE__*/Object.freeze({
  * @param config - Text editor field configuration
  * @returns A validated {@link DbxForgeTextEditorFieldDef}
  *
+ * @dbxFormField
+ * @dbxFormSlug text-editor
+ * @dbxFormTier field-factory
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormNgFormType texteditor
+ * @dbxFormWrapperPattern unwrapped
+ * @dbxFormConfigInterface DbxForgeTextEditorFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeTextEditorField({ key: 'bio', label: 'Biography', maxLength: 2000 });
+ * dbxForgeTextEditorField({ key: 'content', label: 'Body', maxLength: 10000 })
  * ```
  */
 const dbxForgeTextEditorField = dbxForgeFieldFunction({
@@ -9867,24 +10192,40 @@ function isFlexFieldConfig(input) {
     return input.field != null;
 }
 /**
- * Creates a responsive flex layout group that arranges child fields horizontally
+ * Creates a responsive flex layout container that arranges child fields horizontally
  * with configurable sizing, breakpoints, and responsive behavior.
  *
  * Each child field gets a `dbx-flex-N` CSS class applied (merged with any existing className).
- * The group is wrapped with the `dbx-forge-flex` wrapper that renders the `dbxFlexGroup` directive
- * for responsive breakpoint handling.
+ * The container hosts the `dbx-forge-flex` wrapper, which renders the `dbxFlexGroup`
+ * directive for responsive breakpoint handling.
+ *
+ * A `container` is used (not a `group`) because flex layout is purely visual —
+ * the wrapped fields should remain at the same level in the form value, not be
+ * nested under an extra object.
  *
  * This is the forge equivalent of {@link formlyFlexLayoutWrapper}.
  *
  * @param fieldConfigs - Array of field definitions or `{ field, size }` pairs with size overrides
  * @param config - Flex layout defaults including breakpoint, relative sizing, and default size
- * @returns A {@link GroupField} with flex wrapper applied and sized children
+ * @returns A {@link ContainerField} with the flex wrapper applied and sized children
+ *
+ * @dbxFormField
+ * @dbxFormSlug flex-layout
+ * @dbxFormTier composite-builder
+ * @dbxFormSuffix Layout
+ * @dbxFormProduces GroupField
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeFlexLayoutConfig
+ * @dbxFormComposesFrom group
  *
  * @example
  * ```typescript
  * // Simple: all fields get default size (2)
  * dbxForgeFlexLayout([dbxForgeCityField({}), dbxForgeStateField({}), dbxForgeZipCodeField({})])
  *
+ * // Resulting form value shape (flat — no wrapper property):
+ * // { city: '...', state: '...', zip: '...' }
+ *
  * // With per-field sizing and breakpoint
  * dbxForgeFlexLayout([
  *   { field: dbxForgeCityField({}), size: 4 },
@@ -9910,7 +10251,7 @@ function dbxForgeFlexLayout(fieldConfigs, config = {}) {
         ...(relative != null && { relative }),
         ...(breakToColumn != null && { breakToColumn })
     };
-    return dbxForgeGroup({
+    return dbxForgeContainer({
         fields: mappedFields,
         className: 'dbx-flex-group',
         wrappers: [flexWrapper]
@@ -10002,33 +10343,44 @@ var formfield_wrapper_component = /*#__PURE__*/Object.freeze({
  */
 const DBX_FORGE_SECTION_WRAPPER_TYPE_NAME = 'dbx-forge-section';
 /**
- * Creates a section wrapper config for use in a field's `wrappers` array.
+ * Section wrapper config — attach via a field's `wrappers: []` array for a semantic section with header and optional card elevation.
  *
  * @param config - the section wrapper configuration without the `type` property
  * @returns a complete {@link DbxForgeSectionWrapper} config with the type set
  *
+ * @dbxFormField
+ * @dbxFormSlug section-wrapper
+ * @dbxFormTier primitive
+ * @dbxFormProduces WrapperConfig
+ * @dbxFormReturns WrapperConfig
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeSectionWrapper
+ *
  * @example
  * ```typescript
- * dbxForgeNameField({
- *   wrappers: [dbxForgeSectionWrapper({ headerConfig: { header: 'Contact' } })]
- * })
+ * dbxForgeSectionWrapper({ headerConfig: { text: 'Contact Details' } })
  * ```
  */
 function dbxForgeSectionWrapper(config) {
     return { type: DBX_FORGE_SECTION_WRAPPER_TYPE_NAME, ...config };
 }
 /**
- * Creates a subsection wrapper config for use in a field's `wrappers` array.
- * Sets `subsection: true` and defaults heading level to 4.
+ * Subsection variant of `section-wrapper` — defaults to heading level 4 and `subsection: true`.
  *
  * @param config - the subsection wrapper configuration without the `type` and `subsection` properties
  * @returns a complete {@link DbxForgeSectionWrapper} config with `type` and `subsection: true` set
  *
+ * @dbxFormField
+ * @dbxFormSlug subsection-wrapper
+ * @dbxFormTier primitive
+ * @dbxFormProduces WrapperConfig
+ * @dbxFormReturns WrapperConfig
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeSectionWrapper
+ *
  * @example
  * ```typescript
- * dbxForgeNameField({
- *   wrappers: [dbxForgeSubsectionWrapper({ headerConfig: { header: 'Name' } })]
- * })
+ * dbxForgeSubsectionWrapper({ headerConfig: { text: 'Options' } })
  * ```
  */
 function dbxForgeSubsectionWrapper(config) {
@@ -10072,16 +10424,22 @@ function dbxForgeInfoWrapper(config) {
  */
 const DBX_FORGE_STYLE_WRAPPER_TYPE_NAME = 'dbx-forge-style';
 /**
- * Creates a style wrapper config for use in a field's `wrappers` array.
+ * Style wrapper config — applies dynamic CSS classes (`ngClass`) and/or inline styles (`ngStyle`) to any field via its `wrappers: []`.
  *
  * @param config - the style wrapper configuration without the `type` property
  * @returns a complete {@link DbxForgeStyleWrapper} config with the type set
  *
+ * @dbxFormField
+ * @dbxFormSlug style-wrapper
+ * @dbxFormTier primitive
+ * @dbxFormProduces WrapperConfig
+ * @dbxFormReturns WrapperConfig
+ * @dbxFormArrayOutput no
+ * @dbxFormConfigInterface DbxForgeStyleWrapper
+ *
  * @example
  * ```typescript
- * dbxForgeNameField({
- *   wrappers: [dbxForgeStyleWrapper({ classGetter: 'highlight', styleGetter: { color: 'red' } })]
- * })
+ * dbxForgeStyleWrapper({ classGetter: 'highlighted' })
  * ```
  */
 function dbxForgeStyleWrapper(config) {
@@ -10509,16 +10867,23 @@ const DBX_FORGE_TEXT_PASSWORD_DEFAULT_AUTOCOMPLETE = 'current-password';
  */
 const DBX_FORGE_TEXT_VERIFY_PASSWORD_DEFAULT_AUTOCOMPLETE = 'new-password';
 /**
- * Creates a forge text password field with the input type set to `'password'`.
+ * Password input (HTML `type="password"`) with secure autocomplete defaults.
  *
  * Defaults to the key `'password'` and label `'Password'` unless overridden.
  *
  * @param config - Optional configuration for the password field
  * @returns A {@link MatInputField} with password input type
  *
+ * @dbxFormField
+ * @dbxFormSlug password-field
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeTextPasswordFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeTextPasswordField();
+ * dbxForgeTextPasswordField({ key: 'password', required: true })
  * ```
  */
 function dbxForgeTextPasswordField(config) {
@@ -10532,16 +10897,23 @@ function dbxForgeTextPasswordField(config) {
     });
 }
 /**
- * Creates a forge verify/confirm password field, typically used alongside a primary password field.
+ * Companion to `password-field` for sign-up flows. Defaults `autocomplete` to `new-password`. Pair with `password-with-verify-fields` for cross-field equality validation.
  *
  * Defaults to the key `'verifyPassword'` and label `'Verify Password'` unless overridden.
  *
  * @param config - Optional configuration for the verify password field
  * @returns A {@link MatInputField} with password input type
  *
+ * @dbxFormField
+ * @dbxFormSlug verify-password-field
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative password-field
+ * @dbxFormConfigInterface DbxForgeTextPasswordFieldConfig
+ *
  * @example
  * ```typescript
- * const field = dbxForgeTextVerifyPasswordField();
+ * dbxForgeTextVerifyPasswordField({ key: 'verifyPassword' })
  * ```
  */
 function dbxForgeTextVerifyPasswordField(config) {
@@ -10554,8 +10926,7 @@ function dbxForgeTextVerifyPasswordField(config) {
     });
 }
 /**
- * Creates a forge password and verify password pair with a custom validator on the verify field
- * that ensures both values match.
+ * Password + verify-password pair with cross-field equality validation wired up. Drop-in for sign-up flows.
  *
  * The verify password field uses an expression-based custom validator that compares the
  * verify field value against the primary password field's value via `formValue`.
@@ -10563,9 +10934,16 @@ function dbxForgeTextVerifyPasswordField(config) {
  * @param config - Configuration for the password and verify password fields
  * @returns A tuple of `[passwordField, verifyPasswordField]`
  *
+ * @dbxFormField
+ * @dbxFormSlug password-with-verify-fields
+ * @dbxFormProduces FieldDef[]
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldTemplate password-field, verify-password-field
+ * @dbxFormConfigInterface DbxForgeTextPasswordWithVerifyFieldConfig
+ *
  * @example
  * ```typescript
- * const [passwordField, verifyPasswordField] = dbxForgeTextPasswordWithVerifyField();
+ * dbxForgeTextPasswordWithVerifyField({ password: { required: true } })
  * ```
  */
 function dbxForgeTextPasswordWithVerifyField(config) {
@@ -10598,7 +10976,7 @@ function dbxForgeTextPasswordWithVerifyField(config) {
     return [passwordField, verifyPasswordField];
 }
 /**
- * Creates an array of forge field definitions for a username/password login form.
+ * Complete login/signup field set: username, password, and optional verify-password. Drop into the top-level `fields: []`.
  *
  * When `verifyPassword` is provided, a second password field is added with a custom
  * validator that ensures both password values match.
@@ -10606,9 +10984,16 @@ function dbxForgeTextPasswordWithVerifyField(config) {
  * @param config - Login fields configuration
  * @returns An array of forge field definitions for the login form
  *
+ * @dbxFormField
+ * @dbxFormSlug username-password-login-fields
+ * @dbxFormProduces FieldDef[]
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldTemplate username-login-field, password-field, verify-password-field
+ * @dbxFormConfigInterface DbxForgeUsernameLoginFieldsConfig
+ *
  * @example
  * ```typescript
- * const fields = dbxForgeUsernamePasswordLoginFields({ username: 'email' });
+ * dbxForgeUsernamePasswordLoginFields({ username: 'email', verifyPassword: true })
  * ```
  */
 function dbxForgeUsernamePasswordLoginFields(config) {
@@ -10629,16 +11014,23 @@ function dbxForgeUsernamePasswordLoginFields(config) {
     return result;
 }
 /**
- * Creates a single forge username field for a login form.
+ * Username field for login forms. Accepts `"email"` or `"username"` as shorthand presets, or a full config object.
  *
  * Supports email or plain text input based on the provided configuration.
  *
  * @param username - Either `'email'`, `'username'`, or a full config object
  * @returns A forge field definition for the username input
  *
+ * @dbxFormField
+ * @dbxFormSlug username-login-field
+ * @dbxFormProduces string
+ * @dbxFormArrayOutput no
+ * @dbxFormFieldDerivative text
+ * @dbxFormConfigInterface DbxForgeUsernameLoginFieldUsernameConfigInput
+ *
  * @example
  * ```typescript
- * const field = dbxForgeUsernameLoginField('email');
+ * dbxForgeUsernameLoginField({ username: 'email' })
  * ```
  */
 function dbxForgeUsernameLoginField(username) {
@@ -17152,5 +17544,5 @@ function provideDbxFormConfiguration(config) {
  * Generated bundle index. Do not edit.
  */
 
-export { APP_ACTION_FORM_DISABLED_KEY, AbstractAsyncForgeFormDirective, AbstractAsyncFormlyFormDirective, AbstractConfigAsyncForgeFormDirective, AbstractConfigAsyncFormlyFormDirective, AbstractDbxPickableItemFieldDirective, AbstractDbxSearchableFieldDisplayDirective, AbstractDbxSearchableValueFieldDirective, AbstractForgeFormDirective, AbstractForgePickableItemFieldDirective, AbstractForgeSearchableFieldDirective, AbstractFormExpandSectionWrapperDirective, AbstractFormlyFormDirective, AbstractSyncForgeFormDirective, 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_FORGE_ARRAY_FIELD_ELEMENT_WRAPPER_NAME, DBX_FORGE_ARRAY_FIELD_WRAPPER_NAME, DBX_FORGE_DEFAULT_PASSWORDS_MATCH_VALIDATION_MESSAGE, DBX_FORGE_FIELD_TYPES, DBX_FORGE_FIELD_WRAPPER_TYPES, DBX_FORGE_FLEX_WRAPPER_TYPE_NAME, DBX_FORGE_FORM_COMPONENT_TEMPLATE, DBX_FORGE_FORM_FIELD_WRAPPER_NAME, DBX_FORGE_INFO_WRAPPER_TYPE_NAME, DBX_FORGE_PASSWORDS_MATCH_VALIDATION_KIND, DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME, DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME, DBX_FORGE_SECTION_WRAPPER_TYPE_NAME, DBX_FORGE_STYLE_WRAPPER_TYPE_NAME, DBX_FORGE_TEXT_PASSWORD_DEFAULT_AUTOCOMPLETE, DBX_FORGE_TEXT_VERIFY_PASSWORD_DEFAULT_AUTOCOMPLETE, DBX_FORGE_WORKING_WRAPPER_TYPE_NAME, DBX_FORMLY_FORM_COMPONENT_TEMPLATE, DBX_SEARCHABLE_FIELD_COMPONENT_DATA_TOKEN, DEFAULT_DATE_TIME_FIELD_MENU_PRESETS_PRESETS, DEFAULT_DURATION_PICKER_POPOVER_KEY, DEFAULT_FORGE_LAT_LNG_TEXT_FIELD_PLACEHOLDER, DEFAULT_FORM_DISABLED_KEY, DEFAULT_HAS_VALUE_FN, DEFAULT_LAT_LNG_TEXT_FIELD_PATTERN_MESSAGE, DEFAULT_LAT_LNG_TEXT_FIELD_PLACEHOLDER, DEFAULT_PREFERRED_COUNTRIES, DEFAULT_TRANSFORM_DEBOUNCE_TIME, DURATION_MAX_VALIDATION_MESSAGE, DURATION_MIN_VALIDATION_MESSAGE, DbxActionFormDirective, DbxActionFormSafetyDirective, DbxChecklistItemContentComponent, DbxChecklistItemFieldComponent, DbxDateTimeFieldComponent, DbxDateTimeFieldMenuPresetsService, DbxDateTimeFieldTimeMode, DbxDateTimeValueMode, DbxDefaultChecklistItemFieldDisplayComponent, DbxDefaultSearchableFieldDisplayComponent, DbxDurationPickerPopoverComponent, DbxFixedDateRangeFieldComponent, DbxFixedDateRangeFieldSelectionStrategy, DbxForgeActionDialogComponent, DbxForgeArrayFieldElementWrapperComponent, DbxForgeArrayFieldWrapperComponent, DbxForgeAsyncConfigFormComponent, DbxForgeComponentFieldComponent, DbxForgeDateRangeFieldComponent, DbxForgeDateTimeFieldComponent, DbxForgeDynamicFormSignalRef, DbxForgeFixedDateRangeFieldComponent, DbxForgeFixedDateRangeFieldSelectionStrategy, DbxForgeFormComponent, DbxForgeFormComponentImportsModule, DbxForgeFormContext, DbxForgeFormContextService, DbxForgeFormFieldWrapperComponent, DbxForgeGlobalDefaultConfigService, DbxForgeListSelectionFieldComponent, DbxForgePhoneFieldComponent, DbxForgePickableChipFieldComponent, DbxForgePickableListFieldComponent, DbxForgeSearchableChipFieldComponent, DbxForgeSearchableTextFieldComponent, DbxForgeSourceSelectFieldComponent, DbxForgeTextEditorFieldComponent, DbxForgeTimeDurationFieldComponent, DbxForgeWorkingWrapperComponent, DbxForm, DbxFormActionDialogComponent, DbxFormComponentFieldComponent, DbxFormExpandWrapperComponent, DbxFormExtensionModule, DbxFormFlexWrapperComponent, DbxFormFormlyArrayFieldModule, DbxFormFormlyBooleanFieldModule, DbxFormFormlyChecklistItemFieldModule, DbxFormFormlyComponentFieldModule, DbxFormFormlyDateFieldModule, DbxFormFormlyDbxListFieldModule, DbxFormFormlyDurationFieldModule, 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, DbxTimeDurationFieldComponent, FIELD_VALUES_ARE_EQUAL_VALIDATION_KEY, FIELD_VALUE_IS_AVAILABLE_ERROR_VALIDATION_KEY, FIELD_VALUE_IS_AVAILABLE_VALIDATION_KEY, FORGE_COMPONENT_FIELD_TYPE, FORGE_DATERANGE_FIELD_TYPE, FORGE_DATETIME_FIELD_TYPE, FORGE_EXPAND_FIELD_TYPE_NAME, FORGE_FIELD_VALUE_IS_AVAILABLE_VALIDATOR_NAME, FORGE_FIXEDDATERANGE_FIELD_TYPE, FORGE_INFO_BUTTON_FIELD_TYPE_NAME, FORGE_IS_DIVISIBLE_BY_VALIDATION_KEY, FORGE_LIST_SELECTION_FIELD_TYPE, FORGE_PHONE_FIELD_TYPE, FORGE_PICKABLE_CHIP_FIELD_TYPE, FORGE_PICKABLE_LIST_FIELD_TYPE, FORGE_SOURCE_SELECT_FIELD_TYPE, FORGE_STYLED_BOX_CLASS, FORGE_TEXT_EDITOR_FIELD_TYPE, FORGE_TIMEDURATION_FIELD_TYPE, FORGE_VALUE_SELECTION_FIELD_TYPE, 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, applyTimeOffset, autoTouchWrapper, buildCombinedDateTime, checkIsFieldFlexLayoutGroupFieldConfig, checkboxField, checklistItemField, chipTextField, cityField, componentField, computeDateKeyboardStep, computeErrorMessage, computeTimeKeyboardStep, configureDbxForgeFormFieldWrapper, configureForgeAutocompleteFieldMeta, copyFormConfigCustomFnConfig, countryField, dateRangeField, dateRangeFieldMapper, dateTimeField, dateTimeFieldCalc, dateTimeFieldMapper, dateTimePreset, dateTimeRangeField, dbxDateRangeIsSameDateRangeFieldValue, dbxDateTimeInputValueParseFactory, dbxDateTimeIsSameDateTimeFieldValue, dbxDateTimeOutputValueFactory, dbxForgeAddressFields, dbxForgeAddressGroup, dbxForgeAddressLineField, dbxForgeAddressListField, dbxForgeArrayField, dbxForgeBuildFieldDef, dbxForgeCheckboxField, dbxForgeChecklistField, dbxForgeCityField, dbxForgeComponentField, dbxForgeCountryField, dbxForgeDateField, dbxForgeDateRangeRow, dbxForgeDateTimeField, dbxForgeDateTimeRangeRow, dbxForgeDefaultValidationMessages, dbxForgeDollarAmountField, dbxForgeEmailField, dbxForgeExpandWrapper, dbxForgeFieldDisabled, dbxForgeFieldFunction, dbxForgeFieldFunctionConfigPropsWithHintBuilder, dbxForgeFieldFunctionConfigure, dbxForgeFinalizeFormConfig, dbxForgeFixedDateRangeField, dbxForgeFlexLayout, dbxForgeFormComponentProviders, dbxForgeGroup, dbxForgeInfoWrapper, dbxForgeLatLngTextField, dbxForgeListSelectionField, dbxForgeNameField, dbxForgeNumberField, dbxForgeNumberSliderField, dbxForgePhoneField, dbxForgePickableChipField, dbxForgePickableListField, dbxForgeRow, dbxForgeSearchableChipField, dbxForgeSearchableStringChipField, dbxForgeSearchableTextField, dbxForgeSectionWrapper, dbxForgeSourceSelectField, dbxForgeStateField, dbxForgeStyleWrapper, dbxForgeSubsectionWrapper, dbxForgeTextAreaField, dbxForgeTextEditorField, dbxForgeTextField, dbxForgeTextIsAvailableField, dbxForgeTextPasswordField, dbxForgeTextPasswordWithVerifyField, dbxForgeTextVerifyPasswordField, dbxForgeTimeDurationField, dbxForgeTimezoneStringField, dbxForgeToggleField, dbxForgeToggleWrapper, dbxForgeUsernameLoginField, dbxForgeUsernamePasswordLoginFields, dbxForgeValueSelectionField, dbxForgeWebsiteUrlField, dbxForgeZipCodeField, dbxFormSearchFormFields, dbxFormSourceObservable, dbxFormSourceObservableFromStream, dbxFormlyFormComponentProviders, dbxListField, defaultValidationMessages, disableAutofillAttributes, disableFormlyFieldAutofillAttributes, dollarAmountField, durationMaxValidationMessage, durationMinValidationMessage, emailField, expandWrapper, fieldAutocompleteAttributeValue, fieldValueIsAvailableValidator, fieldValuesAreEqualValidator, filterPartialPotentialFieldConfigValuesFromObject, filterPickableItemFieldValuesByLabel, filterPickableItemFieldValuesByLabelFilterFunction, filterPresets, fixedDateRangeField, fixedDateRangeFieldMapper, flexLayoutWrapper, formlyAddValueSelectionOptionFunction, formlyAddWrapperToFormlyFieldConfig, formlyAddressField, formlyAddressFormlyFields, formlyAddressLineField, formlyAddressListField, formlyAutoTouchWrapper, formlyCheckIsFieldFlexLayoutGroupFieldConfig, formlyCheckboxField, formlyChecklistItemField, formlyChipTextField, formlyCityField, formlyComponentField, formlyCountryField, formlyDateRangeField, formlyDateTimeField, formlyDateTimeRangeField, formlyDbxListField, formlyDollarAmountField, formlyEmailField, formlyExpandWrapper, formlyField, formlyFixedDateRangeField, formlyFlexLayoutWrapper, formlyHiddenField, formlyInfoWrapper, formlyLatLngTextField, formlyMakeMetaFilterSearchableFieldValueDisplayFn, formlyNameField, formlyNumberField, formlyNumberFieldTransformParser, formlyNumberSliderField, formlyPhoneAndLabelSectionField, formlyPhoneField, formlyPhoneListField, formlyPickableItemChipField, formlyPickableItemListField, formlyRepeatArrayField, formlySearchableChipField, formlySearchableStringChipField, formlySearchableTextField, formlySectionWrapper, formlySourceSelectField, formlyStateField, formlyStyleWrapper, formlySubsectionWrapper, formlyTextAreaField, formlyTextEditorField, formlyTextField, formlyTextFieldTransformParser, formlyTextIsAvailableField, formlyTextPasswordField, formlyTextPasswordWithVerifyFieldGroup, formlyTextVerifyPasswordField, formlyTimeDurationField, formlyTimeOnlyField, formlyTimezoneStringField, formlyToggleField, formlyToggleWrapper, formlyUsernameLoginField, formlyUsernamePasswordLoginFields, formlyValueSelectionField, formlyWebsiteUrlField, formlyWorkingWrapper, formlyWrappedPhoneAndLabelField, formlyZipCodeField, hiddenField, infoWrapper, isDbxDateTimeFieldTimeDateConfig, isDivisibleBy, isDomain, isE164PhoneNumber, isE164PhoneNumberWithValidExtension, isInRange, isPhoneExtension, isTruthy, isWebsiteUrlValidator, latLngTextField, makeMetaFilterSearchableFieldValueDisplayFn, maxLengthValidationMessage, maxValidationMessage, mergeDbxForgeFieldFormConfig, mergePickerConfig, mergePropsValueObjects, minLengthValidationMessage, minValidationMessage, nameField, navigateDate, numberField, numberFieldTransformParser, numberSliderField, partialPotentialFieldConfigKeys, partialPotentialFieldConfigKeysFilter, phoneAndLabelSectionField, phoneField, phoneFieldMapper, phoneListField, pickableItemChipField, pickableItemListField, pickableValueFieldValuesConfigForStaticLabeledValues, propsAndConfigForFieldConfig, propsValueForFieldConfig, provideDbxForgeFormContext, provideDbxForgeFormFieldDeclarations, provideDbxForm, provideDbxFormConfiguration, provideDbxFormFormlyFieldDeclarations, provideDbxMutableForm, provideFormlyContext, repeatArrayField, resolveForgeSelectionOptions, searchableChipField, searchableStringChipField, searchableTextField, sectionWrapper, sortPickableItemsByLabel, sortPickableItemsByLabelStringFunction, sourceSelectField, stateField, streamValueFromControl, stripEmptyForgeValues, stripForgeInternalKeys, styleWrapper, subsectionWrapper, syncConfigValueObs, textAreaField, textEditorField, textField, textFieldTransformParser, textIsAvailableField, textPasswordField, textPasswordWithVerifyFieldGroup, textVerifyPasswordField, timeDurationField, timeDurationFieldMapper, timeOnlyField, timezoneStringField, toggleDisableFormControl, toggleField, toggleWrapper, usernameLoginField, usernamePasswordLoginFields, validatorsForFieldConfig, valueSelectionField, websiteUrlField, workingWrapper, wrappedPhoneAndLabelField, zipCodeField };
+export { APP_ACTION_FORM_DISABLED_KEY, AbstractAsyncForgeFormDirective, AbstractAsyncFormlyFormDirective, AbstractConfigAsyncForgeFormDirective, AbstractConfigAsyncFormlyFormDirective, AbstractDbxPickableItemFieldDirective, AbstractDbxSearchableFieldDisplayDirective, AbstractDbxSearchableValueFieldDirective, AbstractForgeFormDirective, AbstractForgePickableItemFieldDirective, AbstractForgeSearchableFieldDirective, AbstractFormExpandSectionWrapperDirective, AbstractFormlyFormDirective, AbstractSyncForgeFormDirective, 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_FORGE_ARRAY_FIELD_ELEMENT_WRAPPER_NAME, DBX_FORGE_ARRAY_FIELD_WRAPPER_NAME, DBX_FORGE_DEFAULT_PASSWORDS_MATCH_VALIDATION_MESSAGE, DBX_FORGE_FIELD_TYPES, DBX_FORGE_FIELD_WRAPPER_TYPES, DBX_FORGE_FLEX_WRAPPER_TYPE_NAME, DBX_FORGE_FORM_COMPONENT_TEMPLATE, DBX_FORGE_FORM_FIELD_WRAPPER_NAME, DBX_FORGE_INFO_WRAPPER_TYPE_NAME, DBX_FORGE_PASSWORDS_MATCH_VALIDATION_KIND, DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME, DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME, DBX_FORGE_SECTION_WRAPPER_TYPE_NAME, DBX_FORGE_STYLE_WRAPPER_TYPE_NAME, DBX_FORGE_TEXT_PASSWORD_DEFAULT_AUTOCOMPLETE, DBX_FORGE_TEXT_VERIFY_PASSWORD_DEFAULT_AUTOCOMPLETE, DBX_FORGE_WORKING_WRAPPER_TYPE_NAME, DBX_FORMLY_FORM_COMPONENT_TEMPLATE, DBX_SEARCHABLE_FIELD_COMPONENT_DATA_TOKEN, DEFAULT_DATE_TIME_FIELD_MENU_PRESETS_PRESETS, DEFAULT_DURATION_PICKER_POPOVER_KEY, DEFAULT_FORGE_LAT_LNG_TEXT_FIELD_PLACEHOLDER, DEFAULT_FORM_DISABLED_KEY, DEFAULT_HAS_VALUE_FN, DEFAULT_LAT_LNG_TEXT_FIELD_PATTERN_MESSAGE, DEFAULT_LAT_LNG_TEXT_FIELD_PLACEHOLDER, DEFAULT_PREFERRED_COUNTRIES, DEFAULT_TRANSFORM_DEBOUNCE_TIME, DURATION_MAX_VALIDATION_MESSAGE, DURATION_MIN_VALIDATION_MESSAGE, DbxActionFormDirective, DbxActionFormSafetyDirective, DbxChecklistItemContentComponent, DbxChecklistItemFieldComponent, DbxDateTimeFieldComponent, DbxDateTimeFieldMenuPresetsService, DbxDateTimeFieldTimeMode, DbxDateTimeValueMode, DbxDefaultChecklistItemFieldDisplayComponent, DbxDefaultSearchableFieldDisplayComponent, DbxDurationPickerPopoverComponent, DbxFixedDateRangeFieldComponent, DbxFixedDateRangeFieldSelectionStrategy, DbxForgeActionDialogComponent, DbxForgeArrayFieldElementWrapperComponent, DbxForgeArrayFieldWrapperComponent, DbxForgeAsyncConfigFormComponent, DbxForgeComponentFieldComponent, DbxForgeDateRangeFieldComponent, DbxForgeDateTimeFieldComponent, DbxForgeDynamicFormSignalRef, DbxForgeFixedDateRangeFieldComponent, DbxForgeFixedDateRangeFieldSelectionStrategy, DbxForgeFormComponent, DbxForgeFormComponentImportsModule, DbxForgeFormContext, DbxForgeFormContextService, DbxForgeFormFieldWrapperComponent, DbxForgeGlobalDefaultConfigService, DbxForgeListSelectionFieldComponent, DbxForgePhoneFieldComponent, DbxForgePickableChipFieldComponent, DbxForgePickableListFieldComponent, DbxForgeSearchableChipFieldComponent, DbxForgeSearchableTextFieldComponent, DbxForgeSourceSelectFieldComponent, DbxForgeTextEditorFieldComponent, DbxForgeTimeDurationFieldComponent, DbxForgeWorkingWrapperComponent, DbxForm, DbxFormActionDialogComponent, DbxFormComponentFieldComponent, DbxFormExpandWrapperComponent, DbxFormExtensionModule, DbxFormFlexWrapperComponent, DbxFormFormlyArrayFieldModule, DbxFormFormlyBooleanFieldModule, DbxFormFormlyChecklistItemFieldModule, DbxFormFormlyComponentFieldModule, DbxFormFormlyDateFieldModule, DbxFormFormlyDbxListFieldModule, DbxFormFormlyDurationFieldModule, 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, DbxTimeDurationFieldComponent, FIELD_VALUES_ARE_EQUAL_VALIDATION_KEY, FIELD_VALUE_IS_AVAILABLE_ERROR_VALIDATION_KEY, FIELD_VALUE_IS_AVAILABLE_VALIDATION_KEY, FORGE_COMPONENT_FIELD_TYPE, FORGE_DATERANGE_FIELD_TYPE, FORGE_DATETIME_FIELD_TYPE, FORGE_EXPAND_FIELD_TYPE_NAME, FORGE_FIELD_VALUE_IS_AVAILABLE_VALIDATOR_NAME, FORGE_FIXEDDATERANGE_FIELD_TYPE, FORGE_INFO_BUTTON_FIELD_TYPE_NAME, FORGE_IS_DIVISIBLE_BY_VALIDATION_KEY, FORGE_LIST_SELECTION_FIELD_TYPE, FORGE_PHONE_FIELD_TYPE, FORGE_PICKABLE_CHIP_FIELD_TYPE, FORGE_PICKABLE_LIST_FIELD_TYPE, FORGE_SOURCE_SELECT_FIELD_TYPE, FORGE_STYLED_BOX_CLASS, FORGE_TEXT_EDITOR_FIELD_TYPE, FORGE_TIMEDURATION_FIELD_TYPE, FORGE_VALUE_SELECTION_FIELD_TYPE, 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, applyTimeOffset, autoTouchWrapper, buildCombinedDateTime, checkIsFieldFlexLayoutGroupFieldConfig, checkboxField, checklistItemField, chipTextField, cityField, componentField, computeDateKeyboardStep, computeErrorMessage, computeTimeKeyboardStep, configureDbxForgeFormFieldWrapper, configureForgeAutocompleteFieldMeta, copyFormConfigCustomFnConfig, countryField, dateRangeField, dateRangeFieldMapper, dateTimeField, dateTimeFieldCalc, dateTimeFieldMapper, dateTimePreset, dateTimeRangeField, dbxDateRangeIsSameDateRangeFieldValue, dbxDateTimeInputValueParseFactory, dbxDateTimeIsSameDateTimeFieldValue, dbxDateTimeOutputValueFactory, dbxForgeAddressFields, dbxForgeAddressGroup, dbxForgeAddressLineField, dbxForgeAddressListField, dbxForgeArrayField, dbxForgeBuildFieldDef, dbxForgeCheckboxField, dbxForgeChecklistField, dbxForgeCityField, dbxForgeComponentField, dbxForgeContainer, dbxForgeCountryField, dbxForgeDateField, dbxForgeDateRangeRow, dbxForgeDateTimeField, dbxForgeDateTimeRangeRow, dbxForgeDefaultValidationMessages, dbxForgeDollarAmountField, dbxForgeEmailField, dbxForgeExpandWrapper, dbxForgeFieldDisabled, dbxForgeFieldFunction, dbxForgeFieldFunctionConfigPropsWithHintBuilder, dbxForgeFieldFunctionConfigure, dbxForgeFinalizeFormConfig, dbxForgeFixedDateRangeField, dbxForgeFlexLayout, dbxForgeFormComponentProviders, dbxForgeGroup, dbxForgeInfoWrapper, dbxForgeLatLngTextField, dbxForgeListSelectionField, dbxForgeNameField, dbxForgeNumberField, dbxForgeNumberSliderField, dbxForgePhoneField, dbxForgePickableChipField, dbxForgePickableListField, dbxForgeRow, dbxForgeSearchableChipField, dbxForgeSearchableStringChipField, dbxForgeSearchableTextField, dbxForgeSectionWrapper, dbxForgeSourceSelectField, dbxForgeStateField, dbxForgeStyleWrapper, dbxForgeSubsectionWrapper, dbxForgeTextAreaField, dbxForgeTextEditorField, dbxForgeTextField, dbxForgeTextIsAvailableField, dbxForgeTextPasswordField, dbxForgeTextPasswordWithVerifyField, dbxForgeTextVerifyPasswordField, dbxForgeTimeDurationField, dbxForgeTimezoneStringField, dbxForgeToggleField, dbxForgeToggleWrapper, dbxForgeUsernameLoginField, dbxForgeUsernamePasswordLoginFields, dbxForgeValueSelectionField, dbxForgeWebsiteUrlField, dbxForgeZipCodeField, dbxFormSearchFormFields, dbxFormSourceObservable, dbxFormSourceObservableFromStream, dbxFormlyFormComponentProviders, dbxListField, defaultValidationMessages, disableAutofillAttributes, disableFormlyFieldAutofillAttributes, dollarAmountField, durationMaxValidationMessage, durationMinValidationMessage, emailField, expandWrapper, fieldAutocompleteAttributeValue, fieldValueIsAvailableValidator, fieldValuesAreEqualValidator, filterPartialPotentialFieldConfigValuesFromObject, filterPickableItemFieldValuesByLabel, filterPickableItemFieldValuesByLabelFilterFunction, filterPresets, fixedDateRangeField, fixedDateRangeFieldMapper, flexLayoutWrapper, formlyAddValueSelectionOptionFunction, formlyAddWrapperToFormlyFieldConfig, formlyAddressField, formlyAddressFormlyFields, formlyAddressLineField, formlyAddressListField, formlyAutoTouchWrapper, formlyCheckIsFieldFlexLayoutGroupFieldConfig, formlyCheckboxField, formlyChecklistItemField, formlyChipTextField, formlyCityField, formlyComponentField, formlyCountryField, formlyDateRangeField, formlyDateTimeField, formlyDateTimeRangeField, formlyDbxListField, formlyDollarAmountField, formlyEmailField, formlyExpandWrapper, formlyField, formlyFixedDateRangeField, formlyFlexLayoutWrapper, formlyHiddenField, formlyInfoWrapper, formlyLatLngTextField, formlyMakeMetaFilterSearchableFieldValueDisplayFn, formlyNameField, formlyNumberField, formlyNumberFieldTransformParser, formlyNumberSliderField, formlyPhoneAndLabelSectionField, formlyPhoneField, formlyPhoneListField, formlyPickableItemChipField, formlyPickableItemListField, formlyRepeatArrayField, formlySearchableChipField, formlySearchableStringChipField, formlySearchableTextField, formlySectionWrapper, formlySourceSelectField, formlyStateField, formlyStyleWrapper, formlySubsectionWrapper, formlyTextAreaField, formlyTextEditorField, formlyTextField, formlyTextFieldTransformParser, formlyTextIsAvailableField, formlyTextPasswordField, formlyTextPasswordWithVerifyFieldGroup, formlyTextVerifyPasswordField, formlyTimeDurationField, formlyTimeOnlyField, formlyTimezoneStringField, formlyToggleField, formlyToggleWrapper, formlyUsernameLoginField, formlyUsernamePasswordLoginFields, formlyValueSelectionField, formlyWebsiteUrlField, formlyWorkingWrapper, formlyWrappedPhoneAndLabelField, formlyZipCodeField, hiddenField, infoWrapper, isDbxDateTimeFieldTimeDateConfig, isDivisibleBy, isDomain, isE164PhoneNumber, isE164PhoneNumberWithValidExtension, isInRange, isPhoneExtension, isTruthy, isWebsiteUrlValidator, latLngTextField, makeMetaFilterSearchableFieldValueDisplayFn, maxLengthValidationMessage, maxValidationMessage, mergeDbxForgeFieldFormConfig, mergePickerConfig, mergePropsValueObjects, minLengthValidationMessage, minValidationMessage, nameField, navigateDate, numberField, numberFieldTransformParser, numberSliderField, partialPotentialFieldConfigKeys, partialPotentialFieldConfigKeysFilter, phoneAndLabelSectionField, phoneField, phoneFieldMapper, phoneListField, pickableItemChipField, pickableItemListField, pickableValueFieldValuesConfigForStaticLabeledValues, propsAndConfigForFieldConfig, propsValueForFieldConfig, provideDbxForgeFormContext, provideDbxForgeFormFieldDeclarations, provideDbxForm, provideDbxFormConfiguration, provideDbxFormFormlyFieldDeclarations, provideDbxMutableForm, provideFormlyContext, repeatArrayField, resolveForgeSelectionOptions, searchableChipField, searchableStringChipField, searchableTextField, sectionWrapper, sortPickableItemsByLabel, sortPickableItemsByLabelStringFunction, sourceSelectField, stateField, streamValueFromControl, stripEmptyForgeValues, stripForgeInternalKeys, styleWrapper, subsectionWrapper, syncConfigValueObs, textAreaField, textEditorField, textField, textFieldTransformParser, textIsAvailableField, textPasswordField, textPasswordWithVerifyFieldGroup, textVerifyPasswordField, timeDurationField, timeDurationFieldMapper, timeOnlyField, timezoneStringField, toggleDisableFormControl, toggleField, toggleWrapper, usernameLoginField, usernamePasswordLoginFields, validatorsForFieldConfig, valueSelectionField, websiteUrlField, workingWrapper, wrappedPhoneAndLabelField, zipCodeField };
 //# sourceMappingURL=dereekb-dbx-form.mjs.map