@dereekb/dbx-form 13.9.0 → 13.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/fesm2022/dereekb-dbx-form-calendar.mjs +60 -60
  2. package/fesm2022/dereekb-dbx-form-calendar.mjs.map +1 -1
  3. package/fesm2022/{dereekb-dbx-form-expand.field.component-Bp5_uO1A.mjs → dereekb-dbx-form-expand.field.component-C-U67kCE.mjs} +4 -4
  4. package/fesm2022/{dereekb-dbx-form-expand.field.component-Bp5_uO1A.mjs.map → dereekb-dbx-form-expand.field.component-C-U67kCE.mjs.map} +1 -1
  5. package/fesm2022/{dereekb-dbx-form-flex.wrapper.component-CpOHCk87.mjs → dereekb-dbx-form-flex.wrapper.component-DIDKGVO5.mjs} +4 -4
  6. package/fesm2022/{dereekb-dbx-form-flex.wrapper.component-CpOHCk87.mjs.map → dereekb-dbx-form-flex.wrapper.component-DIDKGVO5.mjs.map} +1 -1
  7. package/fesm2022/{dereekb-dbx-form-info.field.component-B0cFprvc.mjs → dereekb-dbx-form-info.field.component-CfUse-zd.mjs} +4 -4
  8. package/fesm2022/{dereekb-dbx-form-info.field.component-B0cFprvc.mjs.map → dereekb-dbx-form-info.field.component-CfUse-zd.mjs.map} +1 -1
  9. package/fesm2022/{dereekb-dbx-form-info.wrapper.component-18n632L-.mjs → dereekb-dbx-form-info.wrapper.component-BdtiodXl.mjs} +4 -4
  10. package/fesm2022/{dereekb-dbx-form-info.wrapper.component-18n632L-.mjs.map → dereekb-dbx-form-info.wrapper.component-BdtiodXl.mjs.map} +1 -1
  11. package/fesm2022/dereekb-dbx-form-mapbox.mjs +30 -30
  12. package/fesm2022/dereekb-dbx-form-mapbox.mjs.map +1 -1
  13. package/fesm2022/dereekb-dbx-form-quiz.mjs +28 -28
  14. package/fesm2022/dereekb-dbx-form-quiz.mjs.map +1 -1
  15. package/fesm2022/{dereekb-dbx-form-section.wrapper.component-vq21oG6v.mjs → dereekb-dbx-form-section.wrapper.component-6BCFOu3o.mjs} +4 -4
  16. package/fesm2022/{dereekb-dbx-form-section.wrapper.component-vq21oG6v.mjs.map → dereekb-dbx-form-section.wrapper.component-6BCFOu3o.mjs.map} +1 -1
  17. package/fesm2022/{dereekb-dbx-form-style.wrapper.component-BbKj-IHD.mjs → dereekb-dbx-form-style.wrapper.component-BJs4BnH0.mjs} +4 -4
  18. package/fesm2022/{dereekb-dbx-form-style.wrapper.component-BbKj-IHD.mjs.map → dereekb-dbx-form-style.wrapper.component-BJs4BnH0.mjs.map} +1 -1
  19. package/fesm2022/dereekb-dbx-form.mjs +1297 -748
  20. package/fesm2022/dereekb-dbx-form.mjs.map +1 -1
  21. package/lib/forge/field/wrapper/_wrapper.scss +51 -4
  22. package/lib/forge/preset/_preset.scss +30 -16
  23. package/lib/form/_form.scss +1 -57
  24. package/package.json +26 -25
  25. package/types/dereekb-dbx-form.d.ts +788 -367
@@ -19,7 +19,7 @@ import * as _ngx_formly_core from '@ngx-formly/core';
19
19
  import { FormlyFieldConfig, FormlyFieldProps, FieldTypeConfig, ConfigOption, FieldType as FieldType$1, FieldWrapper, FieldArrayType, FieldArrayTypeConfig, FormlyForm, FormlyFormOptions } from '@ngx-formly/core';
20
20
  import { MatDialogConfig, MatDialog, MatDialogRef } from '@angular/material/dialog';
21
21
  import * as _ng_forge_dynamic_forms from '@ng-forge/dynamic-forms';
22
- import { FormConfig, FieldWithValidation, FieldDef, EvaluationContext, WrapperConfig, ValidatorConfig, CustomValidator, AsyncCustomValidator, FieldMeta, BaseValueField, DynamicText, GroupField, ValidationMessages, RowField, ArrayItemDefinitionTemplate, ArrayField, ContainerField, ConditionalExpression, FieldWrapperContract, WrapperFieldInputs, ArrayContext, DynamicForm, FormOptions, FieldTypeDefinition, WrapperTypeDefinition } from '@ng-forge/dynamic-forms';
22
+ import { FormConfig, FieldWithValidation, FieldDef, EvaluationContext, WrapperConfig, ValidatorConfig, CustomValidator, AsyncCustomValidator, FieldMeta, BaseValueField, DynamicText, GroupAllowedChildren, GroupField, ValidationMessages, RowField, ArrayItemDefinitionTemplate, ArrayField, ContainerField, ConditionalExpression, FieldWrapperContract, WrapperFieldInputs, ArrayContext, DynamicForm, FormOptions, FieldTypeDefinition, WrapperTypeDefinition } from '@ng-forge/dynamic-forms';
23
23
  import { FieldTree } from '@angular/forms/signals';
24
24
  import * as _ng_forge_dynamic_forms_material from '@ng-forge/dynamic-forms-material';
25
25
  import { MatInputProps, MatInputField, MatTextareaField, MatSliderField, MatCheckboxField, MatToggleField, MatDatepickerField, MatSelectProps, MatMultiCheckboxField } from '@ng-forge/dynamic-forms-material';
@@ -101,9 +101,21 @@ interface DbxFormEvent extends DbxFormStateRef {
101
101
  declare abstract class DbxForm<T = unknown> {
102
102
  abstract readonly stream$: Observable<DbxFormEvent>;
103
103
  /**
104
- * Returns an observable that returns the current state of the form.
104
+ * Returns an observable that emits the form's current value, optionally gated by the
105
+ * implementation's validity rules (e.g. {@link DbxForgeFormContext.requireValid}).
106
+ *
107
+ * Consumers that only want a value once the form passes validation should use this method.
105
108
  */
106
109
  abstract getValue(): Observable<T>;
110
+ /**
111
+ * Returns an observable that emits the form's current value, regardless of validity gates.
112
+ *
113
+ * Used by infrastructure (e.g. {@link DbxActionFormDirective}) that needs the underlying
114
+ * value to feed user-supplied isValid/isModified functions even while the form is invalid.
115
+ * Defaults to {@link getValue}; implementations that gate {@link getValue} on validity
116
+ * should override this to bypass that gate.
117
+ */
118
+ currentValue(): Observable<T>;
107
119
  /**
108
120
  * Returns an observable that returns the current disabled keys.
109
121
  */
@@ -331,6 +343,7 @@ declare class DbxFormlyContext<T = unknown> implements DbxForm<T>, Destroyable,
331
343
  get fields(): Maybe<FormlyFieldConfig[]>;
332
344
  set fields(fields: Maybe<FormlyFieldConfig[]>);
333
345
  getValue(): Observable<T>;
346
+ currentValue(): Observable<T>;
334
347
  setValue(value: Partial<T>): void;
335
348
  isDisabled(): boolean;
336
349
  get disabled(): BooleanStringKeyArray;
@@ -582,6 +595,12 @@ declare class DbxForgeFormContext<T = unknown> implements DbxMutableForm<T>, OnD
582
595
  updateValue(value: T): void;
583
596
  updateIsValid(valid: boolean): void;
584
597
  getValue(): Observable<T>;
598
+ /**
599
+ * Emits the current form value regardless of {@link requireValid}. Used by infrastructure
600
+ * that needs the underlying value while the form is invalid (e.g. {@link DbxActionFormDirective}
601
+ * feeding the value into user-supplied isModified functions to drive the action's disabled state).
602
+ */
603
+ currentValue(): Observable<T>;
585
604
  getDisabled(): Observable<BooleanStringKeyArray>;
586
605
  setValue(value: Maybe<Partial<T>>): void;
587
606
  resetForm(): void;
@@ -1090,9 +1109,15 @@ interface DbxForgeFinalizeFormConfigResult {
1090
1109
  * values up to the form level and appending any `_hiddenFields` so they participate in
1091
1110
  * validation and value wiring without being rendered.
1092
1111
  *
1112
+ * The walk is recursive: `_formConfig` declared on a field nested inside a container,
1113
+ * group, row, page, or array (full or simplified) is pulled up alongside top-level
1114
+ * `_formConfig` so derivations and validators registered by a child field factory
1115
+ * (e.g. an idempotent transform on a state field inside an address flex layout) are
1116
+ * preserved when the field is composed into a parent layout.
1117
+ *
1093
1118
  * Layering order (lowest to highest priority): `globalDefaults`, the input form's own config,
1094
- * then each field's `_formConfig` in field order — so a later field can override an earlier
1095
- * field's default validation message.
1119
+ * then each field's `_formConfig` in pre-order traversal — so a later field can override an
1120
+ * earlier field's default validation message.
1096
1121
  *
1097
1122
  * @param input - the FormConfig authored by the caller
1098
1123
  * @param globalDefaults - seed values for workspace-wide defaults (e.g. validation messages)
@@ -1100,6 +1125,7 @@ interface DbxForgeFinalizeFormConfigResult {
1100
1125
  */
1101
1126
  declare function dbxForgeFinalizeFormConfig(input: FormConfig, globalDefaults?: DbxForgeGlobalFormConfigDefaults): DbxForgeFinalizeFormConfigResult;
1102
1127
 
1128
+ declare const SELF_DEPENDENCY_TOKEN: "$self";
1103
1129
  /**
1104
1130
  * Contains a reference to a hint value of some type.
1105
1131
  */
@@ -1709,21 +1735,27 @@ interface DbxForgeTextFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeStrin
1709
1735
  readonly idempotentTransform?: TransformStringFunctionConfig;
1710
1736
  }
1711
1737
  /**
1712
- * Creates a forge field definition for a single-line text input.
1738
+ * Single-line text input. Supports text/email/password input types, autocomplete attribute, regex pattern validation, and idempotent string transforms (trim, case changes, etc.).
1713
1739
  *
1714
1740
  * @param config - Text field configuration including key, label, validation, and transform options
1715
1741
  * @returns A text input field with type `'input'`
1716
1742
  *
1743
+ * @dbxFormField
1744
+ * @dbxFormSlug text
1745
+ * @dbxFormTier field-factory
1746
+ * @dbxFormProduces string
1747
+ * @dbxFormArrayOutput no
1748
+ * @dbxFormNgFormType input
1749
+ * @dbxFormWrapperPattern unwrapped
1750
+ * @dbxFormConfigInterface DbxForgeTextFieldConfig
1717
1751
  * @example
1718
1752
  * ```typescript
1719
- * const field = dbxForgeTextField({
1753
+ * const emailField = dbxForgeTextField({
1720
1754
  * key: 'email',
1721
1755
  * label: 'Email',
1722
1756
  * required: true,
1723
- * props: {
1724
- * type: 'email',
1725
- * placeholder: 'user@example.com'
1726
- * }
1757
+ * inputType: 'email',
1758
+ * props: { placeholder: 'user@example.com' }
1727
1759
  * });
1728
1760
  * ```
1729
1761
  */
@@ -1743,27 +1775,46 @@ interface DbxForgeTextAreaFieldConfig extends DbxForgeFieldFunctionDef<MatTextar
1743
1775
  readonly defaultValue?: string;
1744
1776
  }
1745
1777
  /**
1746
- * Creates a forge field definition for a multi-line textarea input.
1778
+ * Multi-line textarea input. Supports row count, autocomplete attribute, pattern validation (RegExp → string conversion), and default value.
1747
1779
  *
1748
1780
  * @param config - Textarea field configuration including key, label, rows, and validation options
1749
1781
  * @returns A textarea field with type `'textarea'`
1750
1782
  *
1783
+ * @dbxFormField
1784
+ * @dbxFormSlug text-area
1785
+ * @dbxFormTier field-factory
1786
+ * @dbxFormProduces string
1787
+ * @dbxFormArrayOutput no
1788
+ * @dbxFormNgFormType textarea
1789
+ * @dbxFormWrapperPattern unwrapped
1790
+ * @dbxFormConfigInterface DbxForgeTextAreaFieldConfig
1751
1791
  * @example
1752
1792
  * ```typescript
1753
- * const field = dbxForgeTextAreaField({ key: 'bio', label: 'Biography', rows: 5, maxLength: 500 });
1793
+ * const bioField = dbxForgeTextAreaField({
1794
+ * key: 'bio',
1795
+ * label: 'Biography',
1796
+ * rows: 5,
1797
+ * maxLength: 500
1798
+ * });
1754
1799
  * ```
1755
1800
  */
1756
1801
  declare const dbxForgeTextAreaField: _dereekb_dbx_form.DbxForgeFieldFunction<DbxForgeTextAreaFieldConfig, MatTextareaField>;
1757
1802
 
1758
1803
  /**
1759
- * Creates a forge text field pre-configured for a person's full name.
1804
+ * Pre-configured text field for capturing a full name with sensible min/max length defaults.
1760
1805
  *
1761
1806
  * @param config - Optional overrides; defaults to key `'name'`, label `'Name'`
1762
1807
  * @returns A {@link MatInputField} for name input
1763
1808
  *
1809
+ * @dbxFormField
1810
+ * @dbxFormSlug name
1811
+ * @dbxFormProduces string
1812
+ * @dbxFormArrayOutput no
1813
+ * @dbxFormFieldDerivative text
1814
+ * @dbxFormConfigInterface DbxForgeNameFieldConfig
1764
1815
  * @example
1765
1816
  * ```typescript
1766
- * const field = dbxForgeNameField({ required: true });
1817
+ * dbxForgeNameField({ key: 'fullName', label: 'Full Name', required: true })
1767
1818
  * ```
1768
1819
  */
1769
1820
  declare function dbxForgeNameField(config?: Partial<DbxForgeTextFieldConfig>): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1783,16 +1834,22 @@ interface DbxForgeEmailFieldConfig {
1783
1834
  readonly autocomplete?: FieldAutocompleteAttributeOption;
1784
1835
  }
1785
1836
  /**
1786
- * Creates a forge text field pre-configured for email address input.
1837
+ * Text field pre-configured with email input type and email validator. Prefer this over configuring `dbxForgeTextField` with `inputType: "email"` directly.
1787
1838
  *
1788
1839
  * Uses the `'email'` input type for built-in browser validation.
1789
1840
  *
1790
1841
  * @param config - Optional overrides; defaults to key `'email'`, label `'Email Address'`
1791
1842
  * @returns A {@link MatInputField} with email input type
1792
1843
  *
1844
+ * @dbxFormField
1845
+ * @dbxFormSlug email
1846
+ * @dbxFormProduces string
1847
+ * @dbxFormArrayOutput no
1848
+ * @dbxFormFieldDerivative text
1849
+ * @dbxFormConfigInterface DbxForgeEmailFieldConfig
1793
1850
  * @example
1794
1851
  * ```typescript
1795
- * const field = dbxForgeEmailField({ required: true });
1852
+ * dbxForgeEmailField({ key: 'email', label: 'Email', required: true })
1796
1853
  * ```
1797
1854
  */
1798
1855
  declare function dbxForgeEmailField(config?: DbxForgeEmailFieldConfig): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1801,14 +1858,20 @@ declare function dbxForgeEmailField(config?: DbxForgeEmailFieldConfig): _dereekb
1801
1858
  */
1802
1859
  type DbxForgeCityFieldConfig = Partial<DbxForgeTextFieldConfig>;
1803
1860
  /**
1804
- * Creates a forge text field pre-configured for city name input.
1861
+ * City name input enforcing `ADDRESS_CITY_MAX_LENGTH`. Typically used inside the address composite set.
1805
1862
  *
1806
1863
  * @param config - Optional overrides; defaults to key `'city'`, label `'City'`
1807
1864
  * @returns A {@link MatInputField} for city input
1808
1865
  *
1866
+ * @dbxFormField
1867
+ * @dbxFormSlug city
1868
+ * @dbxFormProduces string
1869
+ * @dbxFormArrayOutput no
1870
+ * @dbxFormFieldDerivative text
1871
+ * @dbxFormConfigInterface DbxForgeCityFieldConfig
1809
1872
  * @example
1810
1873
  * ```typescript
1811
- * const field = dbxForgeCityField({ required: true });
1874
+ * dbxForgeCityField({ required: true })
1812
1875
  * ```
1813
1876
  */
1814
1877
  declare function dbxForgeCityField(config?: DbxForgeCityFieldConfig): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1822,16 +1885,20 @@ interface DbxForgeStateFieldConfig extends Partial<DbxForgeTextFieldConfig> {
1822
1885
  readonly asCode?: boolean;
1823
1886
  }
1824
1887
  /**
1825
- * Creates a forge text field pre-configured for US state input with optional state code validation.
1826
- *
1827
- * When `asCode` is true, enforces the 2-letter state code pattern and auto-uppercases input.
1888
+ * US state input. When `asCode: true`, validates two-letter codes and auto-uppercases input via an idempotent transform.
1828
1889
  *
1829
1890
  * @param config - Optional overrides; defaults to key `'state'`, label `'State'`
1830
1891
  * @returns A {@link MatInputField} for state input
1831
1892
  *
1893
+ * @dbxFormField
1894
+ * @dbxFormSlug state
1895
+ * @dbxFormProduces string
1896
+ * @dbxFormArrayOutput no
1897
+ * @dbxFormFieldDerivative text
1898
+ * @dbxFormConfigInterface DbxForgeStateFieldConfig
1832
1899
  * @example
1833
1900
  * ```typescript
1834
- * const field = dbxForgeStateField({ asCode: true, required: true });
1901
+ * dbxForgeStateField({ asCode: true, required: true })
1835
1902
  * ```
1836
1903
  */
1837
1904
  declare function dbxForgeStateField(config?: DbxForgeStateFieldConfig): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1840,14 +1907,20 @@ declare function dbxForgeStateField(config?: DbxForgeStateFieldConfig): _dereekb
1840
1907
  */
1841
1908
  type DbxForgeCountryFieldConfig = Partial<DbxForgeTextFieldConfig>;
1842
1909
  /**
1843
- * Creates a forge text field pre-configured for country name input.
1910
+ * Country name input enforcing `ADDRESS_COUNTRY_MAX_LENGTH`. Typically used inside the address composite set.
1844
1911
  *
1845
1912
  * @param config - Optional overrides; defaults to key `'country'`, label `'Country'`
1846
1913
  * @returns A {@link MatInputField} for country input
1847
1914
  *
1915
+ * @dbxFormField
1916
+ * @dbxFormSlug country
1917
+ * @dbxFormProduces string
1918
+ * @dbxFormArrayOutput no
1919
+ * @dbxFormFieldDerivative text
1920
+ * @dbxFormConfigInterface DbxForgeCountryFieldConfig
1848
1921
  * @example
1849
1922
  * ```typescript
1850
- * const field = dbxForgeCountryField({ required: true });
1923
+ * dbxForgeCountryField({ required: true })
1851
1924
  * ```
1852
1925
  */
1853
1926
  declare function dbxForgeCountryField(config?: DbxForgeCountryFieldConfig): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1856,14 +1929,20 @@ declare function dbxForgeCountryField(config?: DbxForgeCountryFieldConfig): _der
1856
1929
  */
1857
1930
  type DbxForgeZipCodeFieldConfig = Partial<DbxForgeTextFieldConfig>;
1858
1931
  /**
1859
- * Creates a forge text field pre-configured for US zip code input with pattern validation.
1932
+ * US zip code input with pattern validation and max-length enforcement.
1860
1933
  *
1861
1934
  * @param config - Optional overrides; defaults to key `'zip'`, label `'Zip Code'`
1862
1935
  * @returns A {@link MatInputField} for zip code input
1863
1936
  *
1937
+ * @dbxFormField
1938
+ * @dbxFormSlug zip-code
1939
+ * @dbxFormProduces string
1940
+ * @dbxFormArrayOutput no
1941
+ * @dbxFormFieldDerivative text
1942
+ * @dbxFormConfigInterface DbxForgeZipCodeFieldConfig
1864
1943
  * @example
1865
1944
  * ```typescript
1866
- * const field = dbxForgeZipCodeField({ required: true });
1945
+ * dbxForgeZipCodeField({ required: true })
1867
1946
  * ```
1868
1947
  */
1869
1948
  declare function dbxForgeZipCodeField(config?: DbxForgeZipCodeFieldConfig): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1872,14 +1951,20 @@ declare function dbxForgeZipCodeField(config?: DbxForgeZipCodeFieldConfig): _der
1872
1951
  */
1873
1952
  declare const DEFAULT_FORGE_LAT_LNG_TEXT_FIELD_PLACEHOLDER = "12.345,-67.8910";
1874
1953
  /**
1875
- * Creates a forge text field pre-configured for latitude/longitude coordinate input with pattern validation.
1954
+ * Latitude/longitude coordinate input with decimal-degree pattern validation.
1876
1955
  *
1877
1956
  * @param config - Optional overrides; defaults to key `'latLng'`
1878
1957
  * @returns A {@link MatInputField} for coordinate input
1879
1958
  *
1959
+ * @dbxFormField
1960
+ * @dbxFormSlug lat-lng
1961
+ * @dbxFormProduces string
1962
+ * @dbxFormArrayOutput no
1963
+ * @dbxFormFieldDerivative text
1964
+ * @dbxFormConfigInterface DbxForgeLatLngTextFieldConfig
1880
1965
  * @example
1881
1966
  * ```typescript
1882
- * const field = dbxForgeLatLngTextField();
1967
+ * dbxForgeLatLngTextField({ key: 'coords', label: 'Coordinates' })
1883
1968
  * ```
1884
1969
  */
1885
1970
  declare function dbxForgeLatLngTextField(config?: Partial<DbxForgeTextFieldConfig>): _dereekb_dbx_form.DbxForgeField<_ng_forge_dynamic_forms_material.MatInputField>;
@@ -1923,31 +2008,41 @@ interface DbxForgeAddressLineFieldConfig extends Partial<DbxForgeTextFieldConfig
1923
2008
  readonly line?: 0 | 1 | 2;
1924
2009
  }
1925
2010
  /**
1926
- * Creates a forge text field for a single address line.
2011
+ * Street address line input. The `line` prop controls which line (1 or 2) — it affects key and label generation.
1927
2012
  *
1928
2013
  * @param config - Optional overrides; line number determines key and label
1929
2014
  * @returns A {@link MatInputField} for address line input
1930
2015
  *
2016
+ * @dbxFormField
2017
+ * @dbxFormSlug address-line
2018
+ * @dbxFormProduces string
2019
+ * @dbxFormArrayOutput no
2020
+ * @dbxFormFieldDerivative text
2021
+ * @dbxFormConfigInterface DbxForgeAddressLineFieldConfig
1931
2022
  * @example
1932
2023
  * ```typescript
1933
- * const line1 = dbxForgeAddressLineField({ line: 1, required: true });
1934
- * const line2 = dbxForgeAddressLineField({ line: 2 });
2024
+ * dbxForgeAddressLineField({ line: 2 })
1935
2025
  * ```
1936
2026
  */
1937
2027
  declare function dbxForgeAddressLineField(config?: DbxForgeAddressLineFieldConfig): DbxForgeField<MatInputField>;
1938
2028
  /**
1939
- * Creates the full set of address form fields (lines, city, state, zip, and optionally country)
1940
- * arranged in a flex row layout.
2029
+ * Flat array of address fields (line(s), city, state, zip, optional country) with a sensible flex layout. Drop directly into a parent `fields: []`.
1941
2030
  *
1942
2031
  * @param config - Address fields configuration
1943
2032
  * @returns Array of forge field definitions for a complete address form section
1944
2033
  *
2034
+ * @dbxFormField
2035
+ * @dbxFormSlug address-fields
2036
+ * @dbxFormProduces FieldDef[]
2037
+ * @dbxFormArrayOutput no
2038
+ * @dbxFormFieldTemplate address-line, city, state, zip-code, country
2039
+ * @dbxFormConfigInterface DbxForgeAddressFieldsConfig
1945
2040
  * @example
1946
2041
  * ```typescript
1947
- * const fields = dbxForgeAddressFields({ required: true, includeCountry: false });
2042
+ * dbxForgeAddressFields({ required: true, includeCountry: false })
1948
2043
  * ```
1949
2044
  */
1950
- declare function dbxForgeAddressFields(config?: DbxForgeAddressFieldsConfig): (_ng_forge_dynamic_forms.RowField<readonly _ng_forge_dynamic_forms.RowAllowedChildren[]> | DbxForgeField<MatInputField>)[];
2045
+ declare function dbxForgeAddressFields(config?: DbxForgeAddressFieldsConfig): GroupAllowedChildren[];
1951
2046
  /**
1952
2047
  * Configuration for a complete address group composite.
1953
2048
  */
@@ -1955,14 +2050,22 @@ interface DbxForgeAddressGroupConfig extends DbxForgeAddressFieldsConfig {
1955
2050
  readonly key?: string;
1956
2051
  }
1957
2052
  /**
1958
- * Composite builder that wraps the full set of address sub-fields in a group.
2053
+ * 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.
1959
2054
  *
1960
2055
  * @param config - Optional overrides; defaults to key `'address'`
1961
2056
  * @returns A {@link GroupField} containing address fields
1962
2057
  *
2058
+ * @dbxFormField
2059
+ * @dbxFormSlug address-group
2060
+ * @dbxFormTier composite-builder
2061
+ * @dbxFormSuffix Group
2062
+ * @dbxFormProduces GroupField
2063
+ * @dbxFormArrayOutput no
2064
+ * @dbxFormConfigInterface DbxForgeAddressGroupConfig
2065
+ * @dbxFormComposesFrom address-fields, group
1963
2066
  * @example
1964
2067
  * ```typescript
1965
- * const group = dbxForgeAddressGroup({ required: true, includeCountry: true });
2068
+ * dbxForgeAddressGroup({ key: 'billingAddress' })
1966
2069
  * ```
1967
2070
  */
1968
2071
  declare function dbxForgeAddressGroup(config?: Partial<DbxForgeAddressGroupConfig>): GroupField;
@@ -1977,15 +2080,22 @@ interface DbxForgeAddressListFieldConfig extends DbxForgeAddressFieldsConfig {
1977
2080
  readonly maxAddresses?: number;
1978
2081
  }
1979
2082
  /**
1980
- * Creates a draggable repeat-array field that allows the user to add, remove,
1981
- * and reorder multiple addresses.
2083
+ * 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.
1982
2084
  *
1983
2085
  * @param config - Optional overrides; defaults to key `'addresses'`, max 6 entries
1984
2086
  * @returns A {@link DbxForgeArrayFieldDef} for multiple addresses
1985
2087
  *
2088
+ * @dbxFormField
2089
+ * @dbxFormSlug address-list
2090
+ * @dbxFormTier composite-builder
2091
+ * @dbxFormSuffix Field
2092
+ * @dbxFormProduces ArrayField
2093
+ * @dbxFormArrayOutput yes
2094
+ * @dbxFormConfigInterface DbxForgeAddressListFieldConfig
2095
+ * @dbxFormComposesFrom address-group, array-field
1986
2096
  * @example
1987
2097
  * ```typescript
1988
- * const field = dbxForgeAddressListField({ maxAddresses: 3, required: true });
2098
+ * dbxForgeAddressListField({ maxAddresses: 3 })
1989
2099
  * ```
1990
2100
  */
1991
2101
  declare function dbxForgeAddressListField(config?: Partial<DbxForgeAddressListFieldConfig>): DbxForgeField<_ng_forge_dynamic_forms.ArrayField<readonly (_ng_forge_dynamic_forms.ArrayAllowedChildren | _ng_forge_dynamic_forms.ArrayItemTemplate)[]>>;
@@ -2032,7 +2142,7 @@ interface DbxForgeNumberFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeNum
2032
2142
  readonly idempotentTransform?: TransformNumberFunctionConfig;
2033
2143
  }
2034
2144
  /**
2035
- * Creates a forge field definition for a numeric input.
2145
+ * Numeric input (HTML `type="number"`). Supports min/max/step constraints, optional step enforcement (divisibility validator), and idempotent number transforms.
2036
2146
  *
2037
2147
  * When `step` is provided, sets the HTML `step` attribute on the input via `meta`.
2038
2148
  * When both `step` and `enforceStep` are set, adds a custom divisibility validator.
@@ -2040,9 +2150,17 @@ interface DbxForgeNumberFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeNum
2040
2150
  * @param config - Number field configuration
2041
2151
  * @returns A validated {@link MatInputField} with input type `'number'`
2042
2152
  *
2153
+ * @dbxFormField
2154
+ * @dbxFormSlug number
2155
+ * @dbxFormTier field-factory
2156
+ * @dbxFormProduces number
2157
+ * @dbxFormArrayOutput no
2158
+ * @dbxFormNgFormType input
2159
+ * @dbxFormWrapperPattern unwrapped
2160
+ * @dbxFormConfigInterface DbxForgeNumberFieldConfig
2043
2161
  * @example
2044
2162
  * ```typescript
2045
- * const field = dbxForgeNumberField({ key: 'quantity', label: 'Quantity', min: 1, max: 100, step: 1 });
2163
+ * dbxForgeNumberField({ key: 'quantity', label: 'Quantity', min: 1, max: 100, step: 1, enforceStep: true })
2046
2164
  * ```
2047
2165
  */
2048
2166
  declare const dbxForgeNumberField: DbxForgeFieldFunction<DbxForgeNumberFieldConfig, MatInputField>;
@@ -2051,11 +2169,17 @@ declare const dbxForgeNumberField: DbxForgeFieldFunction<DbxForgeNumberFieldConf
2051
2169
  */
2052
2170
  type DbxForgeDollarAmountFieldConfig = Omit<DbxForgeNumberFieldConfig, 'roundToStep' | 'precision'>;
2053
2171
  /**
2054
- * Creates a forge number field pre-configured for dollar amount input with cent-level precision.
2172
+ * 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.
2055
2173
  *
2056
2174
  * @param config - Number field configuration (precision is overridden to dollar amount precision)
2057
2175
  * @returns A {@link MatInputField} for dollar amount input
2058
2176
  *
2177
+ * @dbxFormField
2178
+ * @dbxFormSlug dollar-amount
2179
+ * @dbxFormProduces number
2180
+ * @dbxFormArrayOutput no
2181
+ * @dbxFormFieldDerivative number
2182
+ * @dbxFormConfigInterface DbxForgeDollarAmountFieldConfig
2059
2183
  * @example
2060
2184
  * ```typescript
2061
2185
  * const field = dbxForgeDollarAmountField({ key: 'price', label: 'Price', min: 0, required: true });
@@ -2080,19 +2204,26 @@ interface DbxForgeNumberSliderFieldConfig extends DbxForgeFieldFunctionDef<MatSl
2080
2204
  readonly tickInterval?: false | number;
2081
2205
  }
2082
2206
  /**
2083
- * Creates a forge field definition for a Material slider wrapped in a form-field wrapper.
2207
+ * Material slider wrapped in a form-field container. Supports thumb label, tick interval, and step-derived tick spacing.
2084
2208
  *
2085
2209
  * The wrapper provides the Material outlined form-field appearance (notched outline with
2086
2210
  * floating label, hint/error subscript). The inner slider uses the ng-forge built-in
2087
- * `slider` type. The wrapper key uses `_` prefix so `stripForgeInternalKeys` flattens
2088
- * the child slider's value into the parent form.
2211
+ * `slider` type.
2089
2212
  *
2090
2213
  * @param config - Slider field configuration including max (required), thumb label, and tick interval
2091
2214
  * @returns A {@link DbxForgeFormFieldWrapperDef} wrapping a slider field
2092
2215
  *
2216
+ * @dbxFormField
2217
+ * @dbxFormSlug number-slider
2218
+ * @dbxFormTier field-factory
2219
+ * @dbxFormProduces number
2220
+ * @dbxFormArrayOutput no
2221
+ * @dbxFormNgFormType slider
2222
+ * @dbxFormWrapperPattern material-form-field-wrapped
2223
+ * @dbxFormConfigInterface DbxForgeNumberSliderFieldConfig
2093
2224
  * @example
2094
2225
  * ```typescript
2095
- * const field = dbxForgeNumberSliderField({ key: 'rating', label: 'Rating', min: 0, max: 10, step: 1 });
2226
+ * dbxForgeNumberSliderField({ key: 'rating', label: 'Rating', min: 0, max: 10, step: 1 })
2096
2227
  * ```
2097
2228
  */
2098
2229
  declare const dbxForgeNumberSliderField: DbxForgeFieldFunction<DbxForgeNumberSliderFieldConfig, MatSliderField>;
@@ -2100,29 +2231,57 @@ declare const dbxForgeNumberSliderField: DbxForgeFieldFunction<DbxForgeNumberSli
2100
2231
  /**
2101
2232
  * CSS class applied to forge fields when `styledBox` is enabled.
2102
2233
  *
2103
- * Mirrors the Material outlined form-field appearance for fields that don't use `<mat-form-field>` (checkbox, toggle, slider).
2234
+ * @deprecated Boolean fields now use the Material-style form-field wrapper to render the
2235
+ * outlined chrome and standard label/hint/error subscript. Retained as an export for any
2236
+ * consumers still referencing the class name directly.
2104
2237
  */
2105
2238
  declare const FORGE_STYLED_BOX_CLASS = "dbx-forge-styled-box";
2239
+ /**
2240
+ * Where the field's primary label is rendered when wrapped by the form-field wrapper.
2241
+ */
2242
+ type DbxForgeBooleanShowLabelAt = 'wrapper' | 'content' | 'both';
2106
2243
  /**
2107
2244
  * Configuration for a forge Material toggle (slide toggle) field.
2108
2245
  */
2109
2246
  interface DbxForgeToggleFieldConfig extends DbxForgeFieldFunctionDef<MatToggleField> {
2110
2247
  /**
2111
- * Whether to render the toggle inside a styled outline box.
2248
+ * Whether to render the toggle inside the shared Material-style form-field wrapper
2249
+ * so it picks up the outlined chrome and properly styled error/hint subscript.
2112
2250
  *
2113
2251
  * Defaults to `true`.
2114
2252
  */
2115
2253
  readonly styledBox?: boolean;
2254
+ /**
2255
+ * Where to render the field's primary label. Defaults to `'content'`.
2256
+ *
2257
+ * Ignored if `styledBox` is false.
2258
+ */
2259
+ readonly showLabelAt?: DbxForgeBooleanShowLabelAt;
2260
+ /**
2261
+ * Optional secondary label rendered inside the wrapper's content area, regardless
2262
+ * of {@link showLabelAt}. Useful for adding helper text inside the box.
2263
+ */
2264
+ readonly contentLabel?: DynamicText;
2116
2265
  }
2117
2266
  /**
2118
- * Creates a forge field definition for a Material slide toggle.
2267
+ * Material slide toggle. Renders inside the shared form-field wrapper by default so
2268
+ * it visually matches surrounding outlined form fields and uses the standard error
2269
+ * subscript chrome; pass `styledBox: false` to opt out.
2119
2270
  *
2120
2271
  * @param config - Toggle field configuration
2121
2272
  * @returns A validated {@link MatToggleField} with type `'toggle'`
2122
2273
  *
2274
+ * @dbxFormField
2275
+ * @dbxFormSlug toggle
2276
+ * @dbxFormTier field-factory
2277
+ * @dbxFormProduces boolean
2278
+ * @dbxFormArrayOutput no
2279
+ * @dbxFormNgFormType toggle
2280
+ * @dbxFormWrapperPattern material-form-field-wrapped
2281
+ * @dbxFormConfigInterface DbxForgeToggleFieldConfig
2123
2282
  * @example
2124
2283
  * ```typescript
2125
- * const field = dbxForgeToggleField({ key: 'active', label: 'Active', value: true });
2284
+ * dbxForgeToggleField({ key: 'active', label: 'Active', value: true })
2126
2285
  * ```
2127
2286
  */
2128
2287
  declare const dbxForgeToggleField: DbxForgeFieldFunction<DbxForgeToggleFieldConfig, MatToggleField>;
@@ -2131,21 +2290,42 @@ declare const dbxForgeToggleField: DbxForgeFieldFunction<DbxForgeToggleFieldConf
2131
2290
  */
2132
2291
  interface DbxForgeCheckboxFieldConfig extends DbxForgeFieldFunctionDef<MatCheckboxField> {
2133
2292
  /**
2134
- * Whether to render the checkbox inside a styled outline box.
2293
+ * Whether to render the checkbox inside the shared Material-style form-field wrapper
2294
+ * so it picks up the outlined chrome and properly styled error/hint subscript.
2135
2295
  *
2136
2296
  * Defaults to `true`.
2137
2297
  */
2138
2298
  readonly styledBox?: boolean;
2299
+ /**
2300
+ * Where to render the field's primary label. Defaults to `'content'`.
2301
+ *
2302
+ * Ignored if `styledBox` is false.
2303
+ */
2304
+ readonly showLabelAt?: DbxForgeBooleanShowLabelAt;
2305
+ /**
2306
+ * Optional secondary label rendered inside the wrapper's content area, regardless
2307
+ * of {@link showLabelAt}. Useful for adding helper text inside the box.
2308
+ */
2309
+ readonly contentLabel?: DynamicText;
2139
2310
  }
2140
2311
  /**
2141
- * Creates a forge field definition for a Material checkbox.
2312
+ * Material checkbox. Shares the form-field-wrapper opt-out with toggle.
2142
2313
  *
2143
2314
  * @param config - Checkbox field configuration
2144
2315
  * @returns A validated {@link MatCheckboxField} with type `'checkbox'`
2145
2316
  *
2317
+ * @dbxFormField
2318
+ * @dbxFormSlug checkbox
2319
+ * @dbxFormTier field-factory
2320
+ * @dbxFormProduces boolean
2321
+ * @dbxFormArrayOutput no
2322
+ * @dbxFormNgFormType checkbox
2323
+ * @dbxFormWrapperPattern material-form-field-wrapped
2324
+ * @dbxFormConfigInterface DbxForgeCheckboxFieldConfig
2325
+ *
2146
2326
  * @example
2147
2327
  * ```typescript
2148
- * const field = dbxForgeCheckboxField({ key: 'agree', label: 'I agree to the terms' });
2328
+ * dbxForgeCheckboxField({ key: 'agree', label: 'I agree to the terms' })
2149
2329
  * ```
2150
2330
  */
2151
2331
  declare const dbxForgeCheckboxField: DbxForgeFieldFunction<DbxForgeCheckboxFieldConfig, MatCheckboxField>;
@@ -2798,16 +2978,25 @@ declare function navigateDate(currentDate: Date, step: KeyboardStepResult, confi
2798
2978
  interface DbxForgeDateFieldConfig extends DbxForgeFieldFunctionDef<MatDatepickerField> {
2799
2979
  }
2800
2980
  /**
2801
- * Creates a forge field definition for a date picker input.
2981
+ * 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`.
2802
2982
  *
2803
2983
  * Uses the native ng-forge MatDatepickerField.
2804
2984
  *
2805
2985
  * @param config - Date field configuration including key, label, and date constraints
2806
2986
  * @returns A validated {@link MatDatepickerField}
2807
2987
  *
2988
+ * @dbxFormField
2989
+ * @dbxFormSlug date
2990
+ * @dbxFormTier field-factory
2991
+ * @dbxFormProduces Date
2992
+ * @dbxFormArrayOutput no
2993
+ * @dbxFormNgFormType datepicker
2994
+ * @dbxFormWrapperPattern unwrapped
2995
+ * @dbxFormConfigInterface DbxForgeDateFieldConfig
2996
+ *
2808
2997
  * @example
2809
2998
  * ```typescript
2810
- * const field = dbxForgeDateField({ key: 'startDate', label: 'Start Date', required: true });
2999
+ * dbxForgeDateField({ key: 'startDate', label: 'Start Date', required: true })
2811
3000
  * ```
2812
3001
  */
2813
3002
  declare const dbxForgeDateField: DbxForgeFieldFunction<DbxForgeDateFieldConfig, MatDatepickerField>;
@@ -3066,7 +3255,7 @@ type DbxForgeDateTimeFieldDef = BaseValueField<DbxForgeDateTimeFieldComponentPro
3066
3255
  interface DbxForgeDateTimeFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeDateTimeFieldDef> {
3067
3256
  }
3068
3257
  /**
3069
- * Creates a forge field definition for a combined date-time picker.
3258
+ * 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`.
3070
3259
  *
3071
3260
  * Full parity with formly `dateTimeField()` — supports timezone, valueMode, timeMode,
3072
3261
  * pickerConfig, presets, and all other features via the `props` slot.
@@ -3074,18 +3263,19 @@ interface DbxForgeDateTimeFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeD
3074
3263
  * @param config - Date-time field configuration
3075
3264
  * @returns A {@link DbxForgeDateTimeFieldDef}
3076
3265
  *
3266
+ * @dbxFormField
3267
+ * @dbxFormSlug date-time
3268
+ * @dbxFormTier field-factory
3269
+ * @dbxFormProduces DateTimeValue
3270
+ * @dbxFormArrayOutput no
3271
+ * @dbxFormNgFormType datetime
3272
+ * @dbxFormWrapperPattern unwrapped
3273
+ * @dbxFormConfigInterface DbxForgeDateTimeFieldConfig
3274
+ * @dbxFormPropsInterface DbxForgeDateTimeFieldComponentProps
3275
+ *
3077
3276
  * @example
3078
3277
  * ```typescript
3079
- * const field = dbxForgeDateTimeField({
3080
- * key: 'eventStart',
3081
- * label: 'Start',
3082
- * required: true,
3083
- * props: {
3084
- * timezone: 'America/New_York',
3085
- * valueMode: DbxDateTimeValueMode.DATE_STRING,
3086
- * timeMode: DbxDateTimeFieldTimeMode.OPTIONAL
3087
- * }
3088
- * });
3278
+ * dbxForgeDateTimeField({ key: 'when', label: 'When', timezone: 'America/New_York' })
3089
3279
  * ```
3090
3280
  */
3091
3281
  declare const dbxForgeDateTimeField: DbxForgeFieldFunction<DbxForgeDateTimeFieldConfig, DbxForgeDateTimeFieldDef>;
@@ -3114,6 +3304,8 @@ interface DbxForgeDateRangeRowConfig {
3114
3304
  readonly end?: Partial<DbxForgeDateRangeFieldDateConfig>;
3115
3305
  }
3116
3306
  /**
3307
+ * 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.
3308
+ *
3117
3309
  * Composite builder that creates a pair of date pickers for selecting a date range (start and end dates)
3118
3310
  * arranged in a flex row. The pickers are synchronized so the start date stays before the end date.
3119
3311
  *
@@ -3122,14 +3314,18 @@ interface DbxForgeDateRangeRowConfig {
3122
3314
  * @param config - Date range configuration with optional shared props and start/end overrides
3123
3315
  * @returns A {@link RowField} containing the start and end date field pair
3124
3316
  *
3317
+ * @dbxFormField
3318
+ * @dbxFormSlug date-range-row
3319
+ * @dbxFormTier composite-builder
3320
+ * @dbxFormSuffix Row
3321
+ * @dbxFormProduces RowField
3322
+ * @dbxFormArrayOutput no
3323
+ * @dbxFormConfigInterface DbxForgeDateRangeRowConfig
3324
+ * @dbxFormComposesFrom date-time, row
3325
+ *
3125
3326
  * @example
3126
3327
  * ```typescript
3127
- * const row = dbxForgeDateRangeRow({
3128
- * required: true,
3129
- * props: { timezone: 'America/New_York' },
3130
- * start: { key: 'from' },
3131
- * end: { key: 'to' }
3132
- * });
3328
+ * dbxForgeDateRangeRow({ required: true, start: { key: 'from', label: 'From' }, end: { key: 'to', label: 'To' } })
3133
3329
  * ```
3134
3330
  */
3135
3331
  declare function dbxForgeDateRangeRow(config?: DbxForgeDateRangeRowConfig): RowField;
@@ -3156,17 +3352,25 @@ interface DbxForgeDateTimeRangeRowConfig {
3156
3352
  readonly end?: Partial<DbxForgeDateTimeRangeFieldTimeConfig>;
3157
3353
  }
3158
3354
  /**
3159
- * Composite builder that creates a pair of time-only pickers for selecting a time range (start and end times)
3160
- * arranged in a flex row.
3355
+ * Two-column row of time-only pickers for selecting a time range within a single day.
3161
3356
  *
3162
3357
  * This is the forge equivalent of formly's `formlyDateTimeRangeField()`.
3163
3358
  *
3164
3359
  * @param inputConfig - Time range configuration with optional shared props and start/end overrides
3165
3360
  * @returns A {@link RowField} containing the start and end time field pair
3166
3361
  *
3362
+ * @dbxFormField
3363
+ * @dbxFormSlug date-time-range-row
3364
+ * @dbxFormTier composite-builder
3365
+ * @dbxFormSuffix Row
3366
+ * @dbxFormProduces RowField
3367
+ * @dbxFormArrayOutput no
3368
+ * @dbxFormConfigInterface DbxForgeDateTimeRangeRowConfig
3369
+ * @dbxFormComposesFrom date-time, row
3370
+ *
3167
3371
  * @example
3168
3372
  * ```typescript
3169
- * const row = dbxForgeDateTimeRangeRow({ required: true });
3373
+ * dbxForgeDateTimeRangeRow({ start: { label: 'From' }, end: { label: 'Until' } })
3170
3374
  * ```
3171
3375
  */
3172
3376
  declare function dbxForgeDateTimeRangeRow(inputConfig?: DbxForgeDateTimeRangeRowConfig): RowField;
@@ -3575,31 +3779,28 @@ type DbxForgeFixedDateRangeFieldDef = BaseValueField<DbxForgeFixedDateRangeField
3575
3779
  interface DbxForgeFixedDateRangeFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeFixedDateRangeFieldDef> {
3576
3780
  }
3577
3781
  /**
3578
- * Creates a forge field definition for a fixed date range picker wrapped in a Material-style
3579
- * outlined container with a notched outline and floating label.
3782
+ * 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.
3580
3783
  *
3581
3784
  * Uses an inline `<mat-calendar>` with a custom selection strategy, matching the formly
3582
3785
  * `fixedDateRangeField()` behavior. Supports multiple selection modes, timezone conversion,
3583
3786
  * date range input configuration, and optional text inputs.
3584
3787
  *
3585
- * The field is wrapped by `configureDbxForgeFormFieldWrapper` which provides the Material outlined
3586
- * container, equivalent to formly's `['style', 'form-field']` wrappers.
3587
- *
3588
3788
  * @param config - Fixed date range field configuration
3589
3789
  * @returns A {@link DbxForgeFixedDateRangeFieldDef}
3590
3790
  *
3791
+ * @dbxFormField
3792
+ * @dbxFormSlug fixed-date-range
3793
+ * @dbxFormTier field-factory
3794
+ * @dbxFormProduces DbxForgeFixedDateRangeValue
3795
+ * @dbxFormArrayOutput no
3796
+ * @dbxFormNgFormType fixeddaterange
3797
+ * @dbxFormWrapperPattern material-form-field-wrapped
3798
+ * @dbxFormConfigInterface DbxForgeFixedDateRangeFieldConfig
3799
+ * @dbxFormPropsInterface DbxForgeFixedDateRangeFieldComponentProps
3800
+ *
3591
3801
  * @example
3592
3802
  * ```typescript
3593
- * const field = dbxForgeFixedDateRangeField({
3594
- * key: 'dateRange',
3595
- * label: 'Fixed Date Range',
3596
- * required: true,
3597
- * props: {
3598
- * dateRangeInput: { type: DateRangeType.WEEKS_RANGE, distance: 1 },
3599
- * pickerConfig: { limits: { min: 'today_start', max: addMonths(endOfMonth(new Date()), 1) } },
3600
- * valueMode: DbxDateTimeValueMode.DATE_STRING
3601
- * }
3602
- * });
3803
+ * dbxForgeFixedDateRangeField({ key: 'range', label: 'Date Range' })
3603
3804
  * ```
3604
3805
  */
3605
3806
  declare const dbxForgeFixedDateRangeField: DbxForgeFieldFunction<DbxForgeFixedDateRangeFieldConfig, DbxForgeFixedDateRangeFieldDef>;
@@ -4307,7 +4508,7 @@ interface DbxForgeTimeDurationFieldConfig extends DbxForgeFieldFunctionDef<DbxFo
4307
4508
  readonly carryOver?: boolean;
4308
4509
  }
4309
4510
  /**
4310
- * Creates a forge field definition for a time duration input.
4511
+ * Duration input with popover picker. Output shape varies by `valueMode` — number (ms/s/…), string, or structured object.
4311
4512
  *
4312
4513
  * Uses a custom ng-forge ValueFieldComponent that provides a text input
4313
4514
  * accepting duration strings (e.g. "2h30m") and a popover picker.
@@ -4315,15 +4516,18 @@ interface DbxForgeTimeDurationFieldConfig extends DbxForgeFieldFunctionDef<DbxFo
4315
4516
  * @param config - Time duration field configuration
4316
4517
  * @returns A {@link DbxForgeTimeDurationFieldDef}
4317
4518
  *
4519
+ * @dbxFormField
4520
+ * @dbxFormSlug time-duration
4521
+ * @dbxFormTier field-factory
4522
+ * @dbxFormProduces TimeDurationValue
4523
+ * @dbxFormArrayOutput no
4524
+ * @dbxFormNgFormType timeduration
4525
+ * @dbxFormWrapperPattern unwrapped
4526
+ * @dbxFormConfigInterface DbxForgeTimeDurationFieldConfig
4527
+ *
4318
4528
  * @example
4319
4529
  * ```typescript
4320
- * const field = dbxForgeTimeDurationField({
4321
- * key: 'timeout',
4322
- * label: 'Timeout',
4323
- * outputUnit: 'min',
4324
- * min: 0,
4325
- * max: 480
4326
- * });
4530
+ * dbxForgeTimeDurationField({ key: 'duration', label: 'Duration', outputUnit: 'm' })
4327
4531
  * ```
4328
4532
  */
4329
4533
  declare const dbxForgeTimeDurationField: DbxForgeFieldFunction<DbxForgeTimeDurationFieldConfig, DbxForgeTimeDurationFieldDef>;
@@ -4474,7 +4678,7 @@ interface DbxForgePhoneFieldConfig extends DbxForgeFieldFunctionDef<DbxForgePhon
4474
4678
  readonly autocomplete?: DbxForgePhoneFieldAutocomplete;
4475
4679
  }
4476
4680
  /**
4477
- * Creates a forge field definition for an international phone number input.
4681
+ * International phone number input backed by ngx-mat-input-tel. Supports preferred-country lists, search, and optional extension input.
4478
4682
  *
4479
4683
  * Uses the custom 'phone' field type which renders the ngx-mat-input-tel component
4480
4684
  * bridged to Signal Forms.
@@ -4482,9 +4686,18 @@ interface DbxForgePhoneFieldConfig extends DbxForgeFieldFunctionDef<DbxForgePhon
4482
4686
  * @param config - Phone field configuration
4483
4687
  * @returns A forge field definition for the phone input
4484
4688
  *
4689
+ * @dbxFormField
4690
+ * @dbxFormSlug phone
4691
+ * @dbxFormTier field-factory
4692
+ * @dbxFormProduces string
4693
+ * @dbxFormArrayOutput no
4694
+ * @dbxFormNgFormType phone
4695
+ * @dbxFormWrapperPattern unwrapped
4696
+ * @dbxFormConfigInterface DbxForgePhoneFieldConfig
4697
+ *
4485
4698
  * @example
4486
4699
  * ```typescript
4487
- * const field = dbxForgePhoneField({ key: 'phone', label: 'Phone Number', required: true });
4700
+ * dbxForgePhoneField({ key: 'phone', label: 'Phone', preferredCountries: ['US', 'CA'] })
4488
4701
  * ```
4489
4702
  */
4490
4703
  declare const dbxForgePhoneField: DbxForgeFieldFunction<DbxForgePhoneFieldConfig, DbxForgePhoneFieldDef>;
@@ -4642,7 +4855,7 @@ interface DbxForgeArrayFieldConfig extends DbxForgeFieldFunctionDef<Omit<ArrayFi
4642
4855
  }
4643
4856
  type DbxForgeArrayFieldFunction = (config: DbxForgeArrayFieldConfig) => DbxForgeField<ArrayField>;
4644
4857
  /**
4645
- * Creates a forge array field with add/remove controls and per-item rendering.
4858
+ * 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.
4646
4859
  *
4647
4860
  * Wraps the array with {@link DbxForgeArrayFieldWrapperComponent} for label/hint,
4648
4861
  * and wraps each template item in a ContainerField with
@@ -4652,17 +4865,17 @@ type DbxForgeArrayFieldFunction = (config: DbxForgeArrayFieldConfig) => DbxForge
4652
4865
  * @param config - Array field configuration
4653
4866
  * @returns A {@link DbxForgeField}
4654
4867
  *
4868
+ * @dbxFormField
4869
+ * @dbxFormSlug array-field
4870
+ * @dbxFormTier primitive
4871
+ * @dbxFormProduces ArrayField
4872
+ * @dbxFormReturns ArrayField
4873
+ * @dbxFormArrayOutput yes
4874
+ * @dbxFormConfigInterface DbxForgeArrayFieldConfig
4875
+ *
4655
4876
  * @example
4656
4877
  * ```typescript
4657
- * const field = dbxForgeArrayField({
4658
- * key: 'phones',
4659
- * label: 'Phone Numbers',
4660
- * addText: 'Add Phone',
4661
- * template: [
4662
- * dbxForgeTextField({ key: 'number', label: 'Number' }),
4663
- * dbxForgeTextField({ key: 'label', label: 'Label' })
4664
- * ]
4665
- * });
4878
+ * dbxForgeArrayField({ key: 'tags', template: [dbxForgeTextField({ key: 'value' })] })
4666
4879
  * ```
4667
4880
  */
4668
4881
  declare const dbxForgeArrayField: DbxForgeArrayFieldFunction;
@@ -4740,7 +4953,7 @@ type DbxForgeValueSelectionFieldFunction = <T = unknown>(config: DbxForgeValueSe
4740
4953
  */
4741
4954
  type ForgeValueSelectionFieldFunction = DbxForgeValueSelectionFieldFunction;
4742
4955
  /**
4743
- * Creates a forge field definition for a Material select (dropdown) field.
4956
+ * Single-select dropdown over a static or async value list. Simpler than `source-select` when metadata lookup is unnecessary.
4744
4957
  *
4745
4958
  * The component uses `<mat-form-field>` with `[formField]` for native ng-forge value binding,
4746
4959
  * proper Material rendering, and built-in logic (hidden/disabled/readonly) support.
@@ -4750,26 +4963,19 @@ type ForgeValueSelectionFieldFunction = DbxForgeValueSelectionFieldFunction;
4750
4963
  * @param config - Selection field configuration
4751
4964
  * @returns A forge field definition for the value selection component
4752
4965
  *
4966
+ * @dbxFormField
4967
+ * @dbxFormSlug value-selection
4968
+ * @dbxFormTier field-factory
4969
+ * @dbxFormProduces T
4970
+ * @dbxFormArrayOutput no
4971
+ * @dbxFormNgFormType dbx-value-selection
4972
+ * @dbxFormWrapperPattern material-form-field-wrapped
4973
+ * @dbxFormConfigInterface DbxForgeValueSelectionFieldConfig<T>
4974
+ * @dbxFormGeneric <T = unknown>
4975
+ *
4753
4976
  * @example
4754
4977
  * ```typescript
4755
- * // Static options
4756
- * const field = dbxForgeValueSelectionField({
4757
- * key: 'color',
4758
- * label: 'Color',
4759
- * props: {
4760
- * options: [{ label: 'Red', value: 'red' }, { label: 'Blue', value: 'blue' }]
4761
- * }
4762
- * });
4763
- *
4764
- * // Observable options
4765
- * const field = dbxForgeValueSelectionField({
4766
- * key: 'status',
4767
- * label: 'Status',
4768
- * props: {
4769
- * options: status$.pipe(map(statuses => statuses.map(s => ({ label: s.name, value: s.id })))),
4770
- * addClearOption: 'No Selection'
4771
- * }
4772
- * });
4978
+ * dbxForgeValueSelectionField<string>({ key: 'status', props: { options: [{ value: 'active', label: 'Active' }] } })
4773
4979
  * ```
4774
4980
  */
4775
4981
  declare const dbxForgeValueSelectionField: DbxForgeValueSelectionFieldFunction;
@@ -4854,13 +5060,13 @@ type SearchableValueFieldHashFn<T, H extends PrimativeKey = PrimativeKey> = Sele
4854
5060
  /**
4855
5061
  * The custom forge field type name for the searchable text field.
4856
5062
  */
4857
- declare const DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME$1: "dbx-searchable-text";
5063
+ declare const DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME: "dbx-searchable-text";
4858
5064
  /**
4859
5065
  * Props interface for the forge searchable text field.
4860
5066
  *
4861
5067
  * Passed via the `props` property on the forge field definition.
4862
5068
  */
4863
- interface DbxForgeSearchableTextFieldProps$1<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> {
5069
+ interface DbxForgeSearchableTextFieldProps<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> {
4864
5070
  readonly search: SearchableValueFieldStringSearchFn<T, M>;
4865
5071
  readonly displayForValue: SearchableValueFieldDisplayFn<T, M>;
4866
5072
  readonly hashForValue?: SearchableValueFieldHashFn<T, H>;
@@ -4880,31 +5086,34 @@ interface DbxForgeSearchableTextFieldProps$1<T = unknown, M = unknown, H extends
4880
5086
  /**
4881
5087
  * Forge field definition interface for the searchable text field.
4882
5088
  */
4883
- interface DbxForgeSearchableTextFieldDef$1<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends BaseValueField<DbxForgeSearchableTextFieldProps$1<T, M, H>, T> {
4884
- readonly type: typeof DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME$1;
5089
+ interface DbxForgeSearchableTextFieldDef<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends BaseValueField<DbxForgeSearchableTextFieldProps<T, M, H>, T> {
5090
+ readonly type: typeof DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME;
4885
5091
  }
4886
5092
  /**
4887
5093
  * Configuration for a forge searchable text field (single-value autocomplete).
4888
5094
  */
4889
- interface DbxForgeSearchableTextFieldConfig<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeFieldFunctionDef<DbxForgeSearchableTextFieldDef$1<T, M, H>> {
5095
+ interface DbxForgeSearchableTextFieldConfig<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeFieldFunctionDef<DbxForgeSearchableTextFieldDef<T, M, H>> {
4890
5096
  }
4891
- type DbxForgeSearchableTextFieldFunction = <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>(config: DbxForgeSearchableTextFieldConfig<T, M, H>) => DbxForgeField<DbxForgeSearchableTextFieldDef$1<T, M, H>>;
5097
+ type DbxForgeSearchableTextFieldFunction = <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>(config: DbxForgeSearchableTextFieldConfig<T, M, H>) => DbxForgeField<DbxForgeSearchableTextFieldDef<T, M, H>>;
4892
5098
  /**
4893
- * Creates a forge field definition for a searchable text field with autocomplete.
5099
+ * Single-value autocomplete field with search-as-you-type. Optionally allows free-form typed strings as values.
4894
5100
  *
4895
5101
  * @param config - Searchable text field configuration
4896
5102
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a searchable text field
4897
5103
  *
5104
+ * @dbxFormField
5105
+ * @dbxFormSlug searchable-text
5106
+ * @dbxFormTier field-factory
5107
+ * @dbxFormProduces T
5108
+ * @dbxFormArrayOutput no
5109
+ * @dbxFormNgFormType dbx-searchable-text
5110
+ * @dbxFormWrapperPattern material-form-field-wrapped
5111
+ * @dbxFormConfigInterface DbxForgeSearchableTextFieldConfig<T, M, H>
5112
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
5113
+ *
4898
5114
  * @example
4899
5115
  * ```typescript
4900
- * const field = dbxForgeSearchableTextField({
4901
- * key: 'assignee',
4902
- * label: 'Assignee',
4903
- * props: {
4904
- * search: (text) => mySearchService.search(text),
4905
- * displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.name ?? '' })))
4906
- * }
4907
- * });
5116
+ * dbxForgeSearchableTextField<User>({ key: 'user', props: { search, displayForValue } })
4908
5117
  * ```
4909
5118
  */
4910
5119
  declare const dbxForgeSearchableTextField: DbxForgeSearchableTextFieldFunction;
@@ -4915,7 +5124,7 @@ declare const dbxForgeSearchableTextField: DbxForgeSearchableTextFieldFunction;
4915
5124
  *
4916
5125
  * Subclasses provide the specific value model (single-value text or multi-value chip).
4917
5126
  */
4918
- declare abstract class AbstractForgeSearchableFieldDirective<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey, P extends DbxForgeSearchableTextFieldProps$1<T, M, H> = DbxForgeSearchableTextFieldProps$1<T, M, H>> implements OnInit, OnDestroy {
5127
+ declare abstract class AbstractForgeSearchableFieldDirective<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey, P extends DbxForgeSearchableTextFieldProps<T, M, H> = DbxForgeSearchableTextFieldProps<T, M, H>> implements OnInit, OnDestroy {
4919
5128
  readonly key: _angular_core.InputSignal<string>;
4920
5129
  readonly label: _angular_core.InputSignal<DynamicText | undefined>;
4921
5130
  readonly placeholder: _angular_core.InputSignal<DynamicText | undefined>;
@@ -4960,43 +5169,45 @@ declare abstract class AbstractForgeSearchableFieldDirective<T = unknown, M = un
4960
5169
  /**
4961
5170
  * The custom forge field type name for the searchable chip field.
4962
5171
  */
4963
- declare const DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME$1: "dbx-searchable-chip";
5172
+ declare const DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME: "dbx-searchable-chip";
4964
5173
  /**
4965
5174
  * Props interface for the forge searchable chip field.
4966
5175
  */
4967
- interface DbxForgeSearchableChipFieldProps$1<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeSearchableTextFieldProps$1<T, M, H> {
5176
+ interface DbxForgeSearchableChipFieldProps<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeSearchableTextFieldProps<T, M, H> {
4968
5177
  readonly multiSelect?: boolean;
4969
5178
  readonly asArrayValue?: boolean;
4970
5179
  }
4971
5180
  /**
4972
5181
  * Forge field definition interface for the searchable chip field.
4973
5182
  */
4974
- interface DbxForgeSearchableChipFieldDef$1<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends BaseValueField<DbxForgeSearchableChipFieldProps$1<T, M, H>, T | T[]> {
4975
- readonly type: typeof DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME$1;
5183
+ interface DbxForgeSearchableChipFieldDef<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends BaseValueField<DbxForgeSearchableChipFieldProps<T, M, H>, T | T[]> {
5184
+ readonly type: typeof DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME;
4976
5185
  }
4977
5186
  /**
4978
5187
  * Configuration for a forge searchable chip field (multi-value autocomplete with chips).
4979
5188
  */
4980
- interface DbxForgeSearchableChipFieldConfig<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeFieldFunctionDef<DbxForgeSearchableChipFieldDef$1<T, M, H>> {
5189
+ interface DbxForgeSearchableChipFieldConfig<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeFieldFunctionDef<DbxForgeSearchableChipFieldDef<T, M, H>> {
4981
5190
  }
4982
- type DbxForgeSearchableChipFieldFunction = <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>(config: DbxForgeSearchableChipFieldConfig<T, M, H>) => DbxForgeField<DbxForgeSearchableChipFieldDef$1<T, M, H>>;
5191
+ type DbxForgeSearchableChipFieldFunction = <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>(config: DbxForgeSearchableChipFieldConfig<T, M, H>) => DbxForgeField<DbxForgeSearchableChipFieldDef<T, M, H>>;
4983
5192
  /**
4984
- * Creates a forge field definition for a searchable chip field with autocomplete and chips.
5193
+ * Multi-value autocomplete with chips. Defaults to multi-select; supports free-form text entry when `allowStringValues` is set.
4985
5194
  *
4986
5195
  * @param config - Searchable chip field configuration
4987
5196
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a searchable chip field
4988
5197
  *
5198
+ * @dbxFormField
5199
+ * @dbxFormSlug searchable-chip
5200
+ * @dbxFormTier field-factory
5201
+ * @dbxFormProduces T | T[]
5202
+ * @dbxFormArrayOutput optional
5203
+ * @dbxFormNgFormType dbx-searchable-chip
5204
+ * @dbxFormWrapperPattern material-form-field-wrapped
5205
+ * @dbxFormConfigInterface DbxForgeSearchableChipFieldConfig<T, M, H>
5206
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
5207
+ *
4989
5208
  * @example
4990
5209
  * ```typescript
4991
- * const field = dbxForgeSearchableChipField({
4992
- * key: 'tags',
4993
- * label: 'Tags',
4994
- * props: {
4995
- * search: (text) => tagService.search(text),
4996
- * displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.name ?? '' }))),
4997
- * allowStringValues: true
4998
- * }
4999
- * });
5210
+ * dbxForgeSearchableChipField<Tag>({ key: 'tags', props: { search, displayForValue } })
5000
5211
  * ```
5001
5212
  */
5002
5213
  declare const dbxForgeSearchableChipField: DbxForgeSearchableChipFieldFunction;
@@ -5007,18 +5218,32 @@ declare const dbxForgeSearchableChipField: DbxForgeSearchableChipFieldFunction;
5007
5218
  * so users can type a value and press Enter to add it as a chip.
5008
5219
  */
5009
5220
  type DbxForgeSearchableStringChipFieldConfig<M = unknown> = Omit<DbxForgeSearchableChipFieldConfig<string, M>, 'props'> & {
5010
- readonly props?: Omit<DbxForgeSearchableChipFieldProps$1<string, M>, 'allowStringValues'>;
5221
+ readonly props?: Omit<DbxForgeSearchableChipFieldProps<string, M>, 'allowStringValues'>;
5011
5222
  };
5012
5223
  /**
5013
- * Creates a forge searchable chip field pre-configured for string values.
5224
+ * String-value specialization of `searchable-chip`. `allowStringValues` is forced true — use for free-form tag entry.
5014
5225
  *
5015
5226
  * Always sets `allowStringValues: true` on the inner field props so pressing Enter
5016
5227
  * (or typing a separator key) commits the typed value as a chip.
5017
5228
  *
5018
5229
  * @param config - String-specific searchable chip field configuration (omits allowStringValues)
5019
5230
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a searchable chip field
5231
+ *
5232
+ * @dbxFormField
5233
+ * @dbxFormSlug searchable-string-chip
5234
+ * @dbxFormTier field-factory
5235
+ * @dbxFormProduces string | string[]
5236
+ * @dbxFormArrayOutput optional
5237
+ * @dbxFormNgFormType dbx-searchable-chip
5238
+ * @dbxFormWrapperPattern material-form-field-wrapped
5239
+ * @dbxFormConfigInterface DbxForgeSearchableStringChipFieldConfig
5240
+ *
5241
+ * @example
5242
+ * ```typescript
5243
+ * dbxForgeSearchableStringChipField({ key: 'tags', props: { search, displayForValue } })
5244
+ * ```
5020
5245
  */
5021
- declare function dbxForgeSearchableStringChipField<M = unknown>(config: DbxForgeSearchableStringChipFieldConfig<M>): DbxForgeField<DbxForgeSearchableChipFieldDef$1<string, M, PrimativeKey>>;
5246
+ declare function dbxForgeSearchableStringChipField<M = unknown>(config: DbxForgeSearchableStringChipFieldConfig<M>): DbxForgeField<DbxForgeSearchableChipFieldDef<string, M, PrimativeKey>>;
5022
5247
 
5023
5248
  /**
5024
5249
  * Forge ValueFieldComponent for searchable text selection (single value).
@@ -5026,7 +5251,7 @@ declare function dbxForgeSearchableStringChipField<M = unknown>(config: DbxForge
5026
5251
  * Wraps the existing searchable text autocomplete pattern from formly as a standalone
5027
5252
  * ng-forge dynamic forms component. Receives field config via signal inputs from the mapper.
5028
5253
  */
5029
- declare class DbxForgeSearchableTextFieldComponent<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends AbstractForgeSearchableFieldDirective<T, M, H, DbxForgeSearchableTextFieldProps$1<T, M, H>> {
5254
+ declare class DbxForgeSearchableTextFieldComponent<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends AbstractForgeSearchableFieldDirective<T, M, H, DbxForgeSearchableTextFieldProps<T, M, H>> {
5030
5255
  private readonly elementRef;
5031
5256
  readonly field: _angular_core.InputSignal<FieldTree<T>>;
5032
5257
  readonly textInputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
@@ -5064,7 +5289,7 @@ declare class DbxForgeSearchableTextFieldComponent<T = unknown, M = unknown, H e
5064
5289
  * Wraps the existing searchable chip pattern from formly as a standalone
5065
5290
  * ng-forge dynamic forms component. Supports adding/removing chips with autocomplete search.
5066
5291
  */
5067
- declare class DbxForgeSearchableChipFieldComponent<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends AbstractForgeSearchableFieldDirective<T, M, H, DbxForgeSearchableChipFieldProps$1<T, M, H>> {
5292
+ declare class DbxForgeSearchableChipFieldComponent<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends AbstractForgeSearchableFieldDirective<T, M, H, DbxForgeSearchableChipFieldProps<T, M, H>> {
5068
5293
  private readonly elementRef;
5069
5294
  readonly field: _angular_core.InputSignal<FieldTree<T | T[]>>;
5070
5295
  readonly separatorKeysCodes: number[];
@@ -5451,20 +5676,25 @@ interface DbxForgePickableChipFieldConfig<T = unknown, M = unknown, H extends Pr
5451
5676
  }
5452
5677
  type DbxForgePickableChipFieldFunction = <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>(config: DbxForgePickableChipFieldConfig<T, M, H>) => DbxForgeField<DbxForgePickableChipFieldDef<T, M, H>>;
5453
5678
  /**
5454
- * Creates a forge field definition for a pickable chip field.
5679
+ * Selection field rendering selected values as Material chips. Defaults to multi-select; flip to single-select via the underlying props.
5455
5680
  *
5456
5681
  * @param config - Pickable chip field configuration
5457
5682
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a pickable chip field
5458
5683
  *
5684
+ * @dbxFormField
5685
+ * @dbxFormSlug pickable-chip
5686
+ * @dbxFormTier field-factory
5687
+ * @dbxFormProduces T | T[]
5688
+ * @dbxFormArrayOutput optional
5689
+ * @dbxFormNgFormType dbx-pickable-chip
5690
+ * @dbxFormWrapperPattern material-form-field-wrapped
5691
+ * @dbxFormConfigInterface DbxForgePickableChipFieldConfig<T, M, H>
5692
+ * @dbxFormPropsInterface DbxForgePickableFieldProps
5693
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
5694
+ *
5459
5695
  * @example
5460
5696
  * ```typescript
5461
- * const field = dbxForgePickableChipField({
5462
- * key: 'tags',
5463
- * label: 'Tags',
5464
- * loadValues: () => tags$,
5465
- * displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.label ?? '' }))),
5466
- * hashForValue: (tag) => tag.id
5467
- * });
5697
+ * dbxForgePickableChipField<Tag>({ key: 'tags', label: 'Tags', props: { loadValues: () => loadTags$, displayForValue: displayTag } })
5468
5698
  * ```
5469
5699
  */
5470
5700
  declare const dbxForgePickableChipField: DbxForgePickableChipFieldFunction;
@@ -5476,20 +5706,25 @@ interface DbxForgePickableListFieldConfig<T = unknown, M = unknown, H extends Pr
5476
5706
  }
5477
5707
  type DbxForgePickableListFieldFunction = <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>(config: DbxForgePickableListFieldConfig<T, M, H>) => DbxForgeField<DbxForgePickableListFieldDef<T, M, H>>;
5478
5708
  /**
5479
- * Creates a forge field definition for a pickable list field.
5709
+ * Scrollable-list variant of `pickable-chip` same API, different presentation. Prefer this when the option set is large.
5480
5710
  *
5481
5711
  * @param config - Pickable list field configuration
5482
5712
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a pickable list field
5483
5713
  *
5714
+ * @dbxFormField
5715
+ * @dbxFormSlug pickable-list
5716
+ * @dbxFormTier field-factory
5717
+ * @dbxFormProduces T | T[]
5718
+ * @dbxFormArrayOutput optional
5719
+ * @dbxFormNgFormType dbx-pickable-list
5720
+ * @dbxFormWrapperPattern material-form-field-wrapped
5721
+ * @dbxFormConfigInterface DbxForgePickableListFieldConfig<T, M, H>
5722
+ * @dbxFormPropsInterface DbxForgePickableFieldProps
5723
+ * @dbxFormGeneric <T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey>
5724
+ *
5484
5725
  * @example
5485
5726
  * ```typescript
5486
- * const field = dbxForgePickableListField({
5487
- * key: 'categories',
5488
- * label: 'Categories',
5489
- * loadValues: () => categories$,
5490
- * displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta?.label ?? '' }))),
5491
- * hashForValue: (cat) => cat.id
5492
- * });
5727
+ * dbxForgePickableListField<Item>({ key: 'items', props: { loadValues, displayForValue } })
5493
5728
  * ```
5494
5729
  */
5495
5730
  declare const dbxForgePickableListField: DbxForgePickableListFieldFunction;
@@ -5678,7 +5913,7 @@ interface DbxForgeSourceSelectFieldConfig<T extends PrimativeKey = PrimativeKey,
5678
5913
  }
5679
5914
  type DbxForgeSourceSelectFieldFunction = <T extends PrimativeKey = PrimativeKey, M = unknown>(config: DbxForgeSourceSelectFieldConfig<T, M>) => DbxForgeSourceSelectFieldDef<T, M>;
5680
5915
  /**
5681
- * Creates a forge field definition for a source select field.
5916
+ * 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.
5682
5917
  *
5683
5918
  * The component uses `<mat-form-field>` with `[formField]` for native ng-forge value binding,
5684
5919
  * proper Material rendering, and built-in logic (hidden/disabled/readonly) support.
@@ -5686,17 +5921,19 @@ type DbxForgeSourceSelectFieldFunction = <T extends PrimativeKey = PrimativeKey,
5686
5921
  * @param config - Source select field configuration
5687
5922
  * @returns A {@link DbxForgeSourceSelectFieldDef}
5688
5923
  *
5924
+ * @dbxFormField
5925
+ * @dbxFormSlug source-select
5926
+ * @dbxFormTier field-factory
5927
+ * @dbxFormProduces T | T[]
5928
+ * @dbxFormArrayOutput optional
5929
+ * @dbxFormNgFormType dbx-source-select
5930
+ * @dbxFormWrapperPattern unwrapped
5931
+ * @dbxFormConfigInterface DbxForgeSourceSelectFieldConfig<T, M>
5932
+ * @dbxFormGeneric <T extends PrimativeKey = PrimativeKey, M = unknown>
5933
+ *
5689
5934
  * @example
5690
5935
  * ```typescript
5691
- * const field = dbxForgeSourceSelectField({
5692
- * key: 'source',
5693
- * label: 'Source',
5694
- * props: {
5695
- * valueReader: (meta) => meta.id,
5696
- * metaLoader: (values) => myService.loadMeta(values),
5697
- * displayForValue: (values) => of(values.map(v => ({ ...v, label: v.meta.name })))
5698
- * }
5699
- * });
5936
+ * dbxForgeSourceSelectField<string, User>({ key: 'userId', props: { valueReader: (u) => u.id, metaLoader, displayForValue } })
5700
5937
  * ```
5701
5938
  */
5702
5939
  declare const dbxForgeSourceSelectField: DbxForgeSourceSelectFieldFunction;
@@ -5830,22 +6067,24 @@ interface DbxForgeListSelectionFieldConfig<T = unknown, C extends AbstractDbxSel
5830
6067
  }
5831
6068
  type DbxForgeListSelectionFieldFunction = <T = unknown, C extends AbstractDbxSelectionListWrapperDirective<T> = AbstractDbxSelectionListWrapperDirective<T>, K extends PrimativeKey = PrimativeKey>(config: DbxForgeListSelectionFieldConfig<T, C, K>) => DbxForgeField<DbxForgeListSelectionFieldDef<T, C, K>>;
5832
6069
  /**
5833
- * Creates a forge field definition for a list selection field.
6070
+ * Multi-select backed by a lazy-loadable custom list component. Use when you need complete control over item layout and pagination.
5834
6071
  *
5835
6072
  * @param config - List selection field configuration
5836
6073
  * @returns A {@link DbxForgeFormFieldWrapperFieldDef} wrapping a list selection field
5837
6074
  *
6075
+ * @dbxFormField
6076
+ * @dbxFormSlug list-selection
6077
+ * @dbxFormTier field-factory
6078
+ * @dbxFormProduces K[]
6079
+ * @dbxFormArrayOutput yes
6080
+ * @dbxFormNgFormType dbx-list-selection
6081
+ * @dbxFormWrapperPattern material-form-field-wrapped
6082
+ * @dbxFormConfigInterface DbxForgeListSelectionFieldConfig<T, C, K>
6083
+ * @dbxFormGeneric <T = unknown, C extends AbstractDbxSelectionListWrapperDirective<T> = AbstractDbxSelectionListWrapperDirective<T>, K extends PrimativeKey = PrimativeKey>
6084
+ *
5838
6085
  * @example
5839
6086
  * ```typescript
5840
- * const field = dbxForgeListSelectionField({
5841
- * key: 'selectedItems',
5842
- * label: 'Items',
5843
- * props: {
5844
- * listComponentClass: of(MyListComponent),
5845
- * readKey: (item) => item.id,
5846
- * state$: items$
5847
- * }
5848
- * });
6087
+ * dbxForgeListSelectionField<Item, MyListComponent, string>({ key: 'items', props: { listComponentClass, readKey: (i) => i.id, state$ } })
5849
6088
  * ```
5850
6089
  */
5851
6090
  declare const dbxForgeListSelectionField: DbxForgeListSelectionFieldFunction;
@@ -5914,21 +6153,24 @@ type DbxForgeChecklistFieldFunction = <T = unknown>(config: DbxForgeChecklistFie
5914
6153
  */
5915
6154
  type ForgeChecklistFieldFunction = DbxForgeChecklistFieldFunction;
5916
6155
  /**
5917
- * Creates a forge field definition for a Material multi-checkbox (checklist) field.
6156
+ * Multi-checkbox group. Use for small static option sets where every option is visible at once.
5918
6157
  *
5919
6158
  * @param config - Checklist field configuration
5920
6159
  * @returns A validated {@link MatMultiCheckboxField} with type `'multi-checkbox'`
5921
6160
  *
6161
+ * @dbxFormField
6162
+ * @dbxFormSlug checklist
6163
+ * @dbxFormTier field-factory
6164
+ * @dbxFormProduces T[]
6165
+ * @dbxFormArrayOutput yes
6166
+ * @dbxFormNgFormType multi-checkbox
6167
+ * @dbxFormWrapperPattern unwrapped
6168
+ * @dbxFormConfigInterface DbxForgeChecklistFieldConfig<T>
6169
+ * @dbxFormGeneric <T = unknown>
6170
+ *
5922
6171
  * @example
5923
6172
  * ```typescript
5924
- * const field = dbxForgeChecklistField({
5925
- * key: 'tags',
5926
- * label: 'Tags',
5927
- * options: [
5928
- * { label: 'Frontend', value: 'frontend' },
5929
- * { label: 'Backend', value: 'backend' }
5930
- * ]
5931
- * });
6173
+ * dbxForgeChecklistField<string>({ key: 'flags', props: { options: [{ value: 'a', label: 'A' }, { value: 'b', label: 'B' }] } })
5932
6174
  * ```
5933
6175
  */
5934
6176
  declare const dbxForgeChecklistField: DbxForgeChecklistFieldFunction;
@@ -6013,7 +6255,7 @@ type DbxForgeComponentFieldFunction = <T = unknown>(config: DbxForgeComponentFie
6013
6255
  */
6014
6256
  type ForgeComponentFieldFunction = DbxForgeComponentFieldFunction;
6015
6257
  /**
6016
- * Creates a forge field definition that renders a custom Angular component.
6258
+ * Escape hatch injects any Angular component as the field renderer via DbxInjection. Use when no existing form field fits.
6017
6259
  *
6018
6260
  * Uses {@link DbxInjectionComponent} to dynamically inject any Angular component
6019
6261
  * into the form. Generates a unique key when none is provided so that ng-forge's
@@ -6022,12 +6264,19 @@ type ForgeComponentFieldFunction = DbxForgeComponentFieldFunction;
6022
6264
  * @param config - Component field configuration
6023
6265
  * @returns A validated {@link DbxForgeComponentFieldDef}
6024
6266
  *
6267
+ * @dbxFormField
6268
+ * @dbxFormSlug component-field
6269
+ * @dbxFormTier field-factory
6270
+ * @dbxFormProduces T
6271
+ * @dbxFormArrayOutput no
6272
+ * @dbxFormNgFormType component
6273
+ * @dbxFormWrapperPattern unwrapped
6274
+ * @dbxFormConfigInterface DbxForgeComponentFieldConfig<T>
6275
+ * @dbxFormGeneric <T = unknown>
6276
+ *
6025
6277
  * @example
6026
6278
  * ```typescript
6027
- * const field = dbxForgeComponentField({
6028
- * key: 'custom',
6029
- * props: { componentField: { componentClass: MyCustomFormComponent, data: { someInput: 'value' } } }
6030
- * });
6279
+ * dbxForgeComponentField<MyValue>({ key: 'custom', props: { component: MyCustomComp } })
6031
6280
  * ```
6032
6281
  */
6033
6282
  declare const dbxForgeComponentField: DbxForgeComponentFieldFunction;
@@ -6115,7 +6364,7 @@ declare class DbxForgeTextEditorFieldComponent implements OnInit, OnDestroy {
6115
6364
  interface DbxForgeTextEditorFieldConfig extends DbxForgeFieldFunctionDef<DbxForgeTextEditorFieldDef> {
6116
6365
  }
6117
6366
  /**
6118
- * Creates a forge field definition for a rich text editor.
6367
+ * Rich HTML text editor (ngx-editor). Output is the serialized HTML string.
6119
6368
  *
6120
6369
  * Uses ngx-editor under the hood, outputting HTML format.
6121
6370
  * The field defaults to an empty string.
@@ -6123,9 +6372,18 @@ interface DbxForgeTextEditorFieldConfig extends DbxForgeFieldFunctionDef<DbxForg
6123
6372
  * @param config - Text editor field configuration
6124
6373
  * @returns A validated {@link DbxForgeTextEditorFieldDef}
6125
6374
  *
6375
+ * @dbxFormField
6376
+ * @dbxFormSlug text-editor
6377
+ * @dbxFormTier field-factory
6378
+ * @dbxFormProduces string
6379
+ * @dbxFormArrayOutput no
6380
+ * @dbxFormNgFormType texteditor
6381
+ * @dbxFormWrapperPattern unwrapped
6382
+ * @dbxFormConfigInterface DbxForgeTextEditorFieldConfig
6383
+ *
6126
6384
  * @example
6127
6385
  * ```typescript
6128
- * const field = dbxForgeTextEditorField({ key: 'bio', label: 'Biography', maxLength: 2000 });
6386
+ * dbxForgeTextEditorField({ key: 'content', label: 'Body', maxLength: 10000 })
6129
6387
  * ```
6130
6388
  */
6131
6389
  declare const dbxForgeTextEditorField: DbxForgeFieldFunction<DbxForgeTextEditorFieldConfig, DbxForgeTextEditorFieldDef>;
@@ -6184,7 +6442,7 @@ interface DbxForgeRowConfig extends Omit<RowField, 'type' | 'key'> {
6184
6442
  readonly key?: string;
6185
6443
  }
6186
6444
  /**
6187
- * Creates a forge row layout field that arranges child fields horizontally.
6445
+ * Flex row that lays child fields out in columns. Child fields typically carry a `col` property (1–12) for grid placement.
6188
6446
  *
6189
6447
  * Uses the `@ng-forge/dynamic-forms` `RowField` type with a 12-column grid system.
6190
6448
  * Each child field can specify a `col` value (1-12) for responsive sizing.
@@ -6192,43 +6450,145 @@ interface DbxForgeRowConfig extends Omit<RowField, 'type' | 'key'> {
6192
6450
  * @param config - Row layout configuration with fields and optional className
6193
6451
  * @returns A {@link RowField} with type `'row'`
6194
6452
  *
6453
+ * @dbxFormField
6454
+ * @dbxFormSlug row
6455
+ * @dbxFormTier primitive
6456
+ * @dbxFormProduces RowField
6457
+ * @dbxFormReturns RowField
6458
+ * @dbxFormArrayOutput no
6459
+ * @dbxFormConfigInterface DbxForgeRowConfig
6460
+ *
6195
6461
  * @example
6196
6462
  * ```typescript
6197
- * const row = dbxForgeRow({
6463
+ * dbxForgeRow({ fields: [ { ...dbxForgeTextField({ key: 'first' }), col: 6 }, { ...dbxForgeTextField({ key: 'last' }), col: 6 } ] })
6464
+ * ```
6465
+ */
6466
+ declare function dbxForgeRow(config: DbxForgeRowConfig): RowField;
6467
+ /**
6468
+ * Configuration for a forge group layout.
6469
+ *
6470
+ * Extends {@link GroupField} with `type` omitted (always `'group'`). The `key`
6471
+ * is required because a `group` field creates a nested object in the form value
6472
+ * under that key — it is part of the value shape, not a display-only identifier.
6473
+ */
6474
+ interface DbxForgeGroupConfig extends Omit<GroupField, 'type'> {
6475
+ }
6476
+ /**
6477
+ * Creates a plain ng-forge `group` field. A group produces a nested object in
6478
+ * the form value under its `key`, so the key is semantically significant and
6479
+ * must be chosen deliberately.
6480
+ *
6481
+ * For visual-only grouping (conditional visibility, layout wrappers, shared
6482
+ * CSS class) that should NOT introduce a nested object in the form value, use
6483
+ * {@link dbxForgeContainer} instead — that is what ng-forge's `container`
6484
+ * field type is for.
6485
+ *
6486
+ * For sections with headers, use the section wrapper type instead.
6487
+ *
6488
+ * @param config - Group configuration with fields and required key
6489
+ * @returns A {@link GroupField} with type `'group'`
6490
+ *
6491
+ * @dbxFormField
6492
+ * @dbxFormSlug group
6493
+ * @dbxFormTier primitive
6494
+ * @dbxFormProduces GroupField
6495
+ * @dbxFormReturns GroupField
6496
+ * @dbxFormArrayOutput no
6497
+ * @dbxFormConfigInterface DbxForgeGroupConfig
6498
+ *
6499
+ * @example
6500
+ * ```typescript
6501
+ * // Groups the address sub-fields under an `address` property in the form value.
6502
+ * const group = dbxForgeGroup({
6503
+ * key: 'address',
6198
6504
  * fields: [
6199
- * { ...dbxForgeTextField({ key: 'first', label: 'First' }), col: 6 },
6200
- * { ...dbxForgeTextField({ key: 'last', label: 'Last' }), col: 6 }
6505
+ * dbxForgeTextField({ key: 'city', label: 'City' }),
6506
+ * dbxForgeTextField({ key: 'state', label: 'State' })
6201
6507
  * ]
6202
6508
  * });
6509
+ *
6510
+ * // Resulting form value shape:
6511
+ * // { address: { city: '...', state: '...' } }
6512
+ * ```
6513
+ *
6514
+ * @example
6515
+ * ```typescript
6516
+ * // Wrong: if the intent is purely visual (e.g. conditional visibility) and
6517
+ * // the fields should remain at the parent level in the form value, do NOT
6518
+ * // use a group — use dbxForgeContainer instead. Otherwise you end up with a
6519
+ * // spurious nested object:
6520
+ * // { _group_0: { city: '...', state: '...' } } // ← unwanted wrapper
6203
6521
  * ```
6204
6522
  */
6205
- declare function dbxForgeRow(config: DbxForgeRowConfig): RowField;
6523
+ declare function dbxForgeGroup(config: DbxForgeGroupConfig): GroupField;
6206
6524
  /**
6207
- * Configuration for a forge group layout.
6525
+ * Configuration for a forge container layout.
6208
6526
  *
6209
- * Extends {@link GroupField} with `key` made optional (auto-generated if omitted)
6210
- * and `type` omitted (always `'group'`).
6527
+ * Extends {@link ContainerField} with `type` omitted (always `'container'`),
6528
+ * `key` made optional (auto-generated if omitted), and `wrappers` made optional
6529
+ * (defaults to an empty array).
6211
6530
  */
6212
- interface DbxForgeGroupConfig extends Omit<GroupField, 'type' | 'key'> {
6531
+ interface DbxForgeContainerConfig extends Omit<ContainerField, 'type' | 'key' | 'wrappers'> {
6213
6532
  /**
6214
- * Optional key for the group. Defaults to a unique auto-generated key.
6533
+ * Optional key for the container. Defaults to a unique auto-generated key.
6215
6534
  *
6216
- * Must be unique within the form config to avoid ng-forge duplicate key errors.
6535
+ * Containers do not introduce a nested object in the form value the key is
6536
+ * only an identifier and is not part of the value shape. Must still be unique
6537
+ * within the form config to avoid ng-forge duplicate key errors.
6217
6538
  */
6218
6539
  readonly key?: string;
6540
+ /**
6541
+ * Optional wrapper configs to chain around the children. Defaults to `[]`.
6542
+ */
6543
+ readonly wrappers?: readonly WrapperConfig[];
6219
6544
  }
6220
6545
  /**
6221
- * Creates a plain forge group layout field.
6546
+ * Creates an ng-forge `container` field. Containers group child fields for
6547
+ * layout, conditional visibility, or wrapper application WITHOUT introducing
6548
+ * a nested object in the form value — child values remain at the same level
6549
+ * as the container itself.
6222
6550
  *
6223
- * Groups collect child field values into a nested object when a `key` is provided.
6224
- * When used without a key, the group serves as a visual/logical grouping only.
6551
+ * Use this (not {@link dbxForgeGroup}) whenever the grouping is purely visual
6552
+ * or structural. Use {@link dbxForgeGroup} when the intent is to nest the
6553
+ * child values under a named key in the form value.
6225
6554
  *
6226
- * For sections with headers, use the section wrapper type instead.
6555
+ * @param config - Container configuration with fields and optional key/wrappers
6556
+ * @returns A {@link ContainerField} with type `'container'`
6227
6557
  *
6228
- * @param config - Group configuration with fields and optional key/className
6229
- * @returns A {@link GroupField} with type `'group'`
6558
+ * @example
6559
+ * ```typescript
6560
+ * // Visual-only grouping (e.g. to apply a CSS class or a wrapper). Children
6561
+ * // remain at the parent level in the form value — the container itself
6562
+ * // does not add a property.
6563
+ * const container = dbxForgeContainer({
6564
+ * className: 'dbx-highlight-group',
6565
+ * fields: [
6566
+ * dbxForgeTextField({ key: 'city', label: 'City' }),
6567
+ * dbxForgeTextField({ key: 'state', label: 'State' })
6568
+ * ]
6569
+ * });
6570
+ *
6571
+ * // Resulting form value shape (flat):
6572
+ * // { city: '...', state: '...' }
6573
+ * ```
6574
+ *
6575
+ * @example
6576
+ * ```typescript
6577
+ * // Conditional visibility without altering the value shape — a common use
6578
+ * // case that should NOT use dbxForgeGroup.
6579
+ * const container = dbxForgeContainer({
6580
+ * fields: [dbxForgeTextField({ key: 'jwks_uri', label: 'JWKS URI' })],
6581
+ * logic: [{
6582
+ * type: 'hidden',
6583
+ * condition: { type: 'fieldValue', fieldPath: 'authMethod', operator: 'notEquals', value: 'private_key_jwt' }
6584
+ * }]
6585
+ * });
6586
+ *
6587
+ * // Resulting form value shape (jwks_uri stays flat, not nested):
6588
+ * // { authMethod: '...', jwks_uri: '...' }
6589
+ * ```
6230
6590
  */
6231
- declare function dbxForgeGroup(config: DbxForgeGroupConfig): GroupField;
6591
+ declare function dbxForgeContainer(config: DbxForgeContainerConfig): ContainerField;
6232
6592
  /**
6233
6593
  * Configuration for a forge toggle wrapper that shows/hides content via a slide toggle.
6234
6594
  */
@@ -6254,41 +6614,59 @@ interface DbxForgeToggleWrapperConfig {
6254
6614
  */
6255
6615
  readonly defaultOpen?: boolean;
6256
6616
  /**
6257
- * Optional key for the content group.
6617
+ * Optional key for the content container. Auto-generated if omitted.
6618
+ *
6619
+ * The container does not add a property to the form value; this is only a
6620
+ * stable identifier for the container field.
6258
6621
  */
6259
6622
  readonly contentKey?: string;
6260
6623
  }
6261
6624
  /**
6262
- * Creates a forge toggle wrapper that shows/hides content via a Material slide toggle.
6625
+ * Wraps content fields in a Material slide toggle the toggle state controls conditional visibility of the inner fields.
6263
6626
  *
6264
6627
  * Uses ng-forge's built-in `toggle` field type (MatSlideToggle) and
6265
6628
  * `FieldValueCondition` for conditional visibility. The toggle boolean value
6266
- * IS part of the form model (standard ng-forge pattern).
6629
+ * IS part of the form model. The hidden content is wrapped in a `container`
6630
+ * (not a `group`), so the wrapped fields sit at the same level as the toggle
6631
+ * in the form value — they are NOT nested under an extra object.
6267
6632
  *
6268
6633
  * Structure produced:
6269
6634
  * ```
6270
- * Row (outer)
6635
+ * Container (outer, with flex wrapper)
6271
6636
  * ├── toggle field (type: 'toggle', boolean value)
6272
- * └── Group (content, hidden when toggle === false)
6637
+ * └── Container (content, hidden when toggle === false)
6273
6638
  * ```
6274
6639
  *
6275
6640
  * This is the forge equivalent of the formly `formlyToggleWrapper`.
6276
6641
  *
6277
6642
  * @param config - Toggle wrapper configuration
6278
- * @returns A {@link RowField} containing the toggle and content group
6643
+ * @returns A {@link ContainerField} containing the toggle and content container
6644
+ *
6645
+ * @dbxFormField
6646
+ * @dbxFormSlug toggle-wrapper
6647
+ * @dbxFormTier composite-builder
6648
+ * @dbxFormSuffix Wrapper
6649
+ * @dbxFormProduces ContainerField
6650
+ * @dbxFormArrayOutput no
6651
+ * @dbxFormConfigInterface DbxForgeToggleWrapperConfig
6652
+ * @dbxFormComposesFrom toggle, group
6279
6653
  *
6280
6654
  * @example
6281
6655
  * ```typescript
6282
6656
  * const toggle = dbxForgeToggleWrapper({
6657
+ * key: 'showAdvanced',
6283
6658
  * label: 'Show advanced options',
6284
6659
  * fields: [
6285
6660
  * dbxForgeTextField({ key: 'advanced1', label: 'Option 1' }),
6286
6661
  * dbxForgeTextField({ key: 'advanced2', label: 'Option 2' })
6287
6662
  * ]
6288
6663
  * });
6664
+ *
6665
+ * // Resulting form value (flat — no nesting under the container):
6666
+ * // { showAdvanced: true, advanced1: '...', advanced2: '...' }
6289
6667
  * ```
6290
6668
  */
6291
- declare function dbxForgeToggleWrapper(config: DbxForgeToggleWrapperConfig): RowField;
6669
+ declare function dbxForgeToggleWrapper(config: DbxForgeToggleWrapperConfig): ContainerField;
6292
6670
  /**
6293
6671
  * Configuration for a forge expand wrapper that shows/hides content via a button or text link.
6294
6672
  */
@@ -6318,32 +6696,48 @@ interface DbxForgeExpandWrapperConfig {
6318
6696
  */
6319
6697
  readonly defaultOpen?: boolean;
6320
6698
  /**
6321
- * Optional key for the content group.
6699
+ * Optional key for the content container. Auto-generated if omitted.
6700
+ *
6701
+ * The container does not add a property to the form value; this is only a
6702
+ * stable identifier for the container field.
6322
6703
  */
6323
6704
  readonly contentKey?: string;
6324
6705
  }
6325
6706
  /**
6326
- * Creates a forge expand wrapper that shows/hides content via a button or text link.
6707
+ * Wraps content fields behind a button or text "expand" control. Use for optional sections like "Show advanced options".
6327
6708
  *
6328
6709
  * Uses a custom `dbx-forge-expand` field type for the expand trigger and
6329
- * `FieldValueCondition` for conditional visibility on the content group.
6330
- * The expand boolean value IS part of the form model.
6710
+ * `FieldValueCondition` for conditional visibility on the content. The
6711
+ * expand boolean value IS part of the form model. The hidden content is
6712
+ * wrapped in a `container` (not a `group`), so the wrapped fields sit at the
6713
+ * same level as the expand control in the form value — they are NOT nested
6714
+ * under an extra object.
6331
6715
  *
6332
6716
  * Structure produced:
6333
6717
  * ```
6334
- * Row (outer)
6718
+ * Container (outer, with flex wrapper)
6335
6719
  * ├── expand field (type: 'dbx-forge-expand', boolean value)
6336
- * └── Group (content, hidden when expand field === false)
6720
+ * └── Container (content, hidden when expand field === false)
6337
6721
  * ```
6338
6722
  *
6339
6723
  * This is the forge equivalent of the formly `formlyExpandWrapper`.
6340
6724
  *
6341
6725
  * @param config - Expand wrapper configuration
6342
- * @returns A {@link RowField} containing the expand control and content group
6726
+ * @returns A {@link ContainerField} containing the expand control and content container
6727
+ *
6728
+ * @dbxFormField
6729
+ * @dbxFormSlug expand-wrapper
6730
+ * @dbxFormTier composite-builder
6731
+ * @dbxFormSuffix Wrapper
6732
+ * @dbxFormProduces ContainerField
6733
+ * @dbxFormArrayOutput no
6734
+ * @dbxFormConfigInterface DbxForgeExpandWrapperConfig
6735
+ * @dbxFormComposesFrom group
6343
6736
  *
6344
6737
  * @example
6345
6738
  * ```typescript
6346
6739
  * const expand = dbxForgeExpandWrapper({
6740
+ * key: 'showMore',
6347
6741
  * label: 'Show more options',
6348
6742
  * buttonType: 'button',
6349
6743
  * fields: [
@@ -6351,9 +6745,12 @@ interface DbxForgeExpandWrapperConfig {
6351
6745
  * dbxForgeTextField({ key: 'extra2', label: 'Extra 2' })
6352
6746
  * ]
6353
6747
  * });
6748
+ *
6749
+ * // Resulting form value (flat — no nesting under the container):
6750
+ * // { showMore: true, extra1: '...', extra2: '...' }
6354
6751
  * ```
6355
6752
  */
6356
- declare function dbxForgeExpandWrapper(config: DbxForgeExpandWrapperConfig): RowField;
6753
+ declare function dbxForgeExpandWrapper(config: DbxForgeExpandWrapperConfig): ContainerField;
6357
6754
 
6358
6755
  /**
6359
6756
  * Forge wrapper component that wraps an ng-forge `array` field with
@@ -6538,6 +6935,11 @@ interface DbxForgeFlexLayoutFieldConfig {
6538
6935
  * with a default size for fields that don't specify their own.
6539
6936
  */
6540
6937
  interface DbxForgeFlexLayoutConfig extends Omit<DbxForgeFlexWrapper, 'type'> {
6938
+ /**
6939
+ * Fields to include in the layout. Each entry may be a plain {@link FieldDef}
6940
+ * or a {@link DbxForgeFlexLayoutFieldConfig} with a per-field size override.
6941
+ */
6942
+ readonly fields?: readonly (FieldDef<unknown> | DbxForgeFlexLayoutFieldConfig)[];
6541
6943
  /**
6542
6944
  * Default flex size for fields that don't specify their own.
6543
6945
  *
@@ -6545,37 +6947,13 @@ interface DbxForgeFlexLayoutConfig extends Omit<DbxForgeFlexWrapper, 'type'> {
6545
6947
  */
6546
6948
  readonly size?: DbxFlexSize;
6547
6949
  }
6950
+ declare function dbxForgeFlexLayout(config: DbxForgeFlexLayoutConfig): ContainerField;
6548
6951
  /**
6549
- * Creates a responsive flex layout group that arranges child fields horizontally
6550
- * with configurable sizing, breakpoints, and responsive behavior.
6551
- *
6552
- * Each child field gets a `dbx-flex-N` CSS class applied (merged with any existing className).
6553
- * The group is wrapped with the `dbx-forge-flex` wrapper that renders the `dbxFlexGroup` directive
6554
- * for responsive breakpoint handling.
6555
- *
6556
- * This is the forge equivalent of {@link formlyFlexLayoutWrapper}.
6557
- *
6558
- * @param fieldConfigs - Array of field definitions or `{ field, size }` pairs with size overrides
6559
- * @param config - Flex layout defaults including breakpoint, relative sizing, and default size
6560
- * @returns A {@link GroupField} with flex wrapper applied and sized children
6561
- *
6562
- * @example
6563
- * ```typescript
6564
- * // Simple: all fields get default size (2)
6565
- * dbxForgeFlexLayout([dbxForgeCityField({}), dbxForgeStateField({}), dbxForgeZipCodeField({})])
6566
- *
6567
- * // With per-field sizing and breakpoint
6568
- * dbxForgeFlexLayout([
6569
- * { field: dbxForgeCityField({}), size: 4 },
6570
- * dbxForgeStateField({}),
6571
- * dbxForgeZipCodeField({})
6572
- * ], { breakpoint: 'small', size: 1 })
6573
- *
6574
- * // Full config
6575
- * dbxForgeFlexLayout([...fields], { breakpoint: 'large', breakToColumn: true, relative: true, size: 1 })
6576
- * ```
6952
+ * @deprecated Pass a {@link DbxForgeFlexLayoutConfig} object instead the array form
6953
+ * diverges from how every other forge field factory is configured. Move array entries
6954
+ * into the `fields` property of the config object.
6577
6955
  */
6578
- declare function dbxForgeFlexLayout(fieldConfigs: (FieldDef<unknown> | DbxForgeFlexLayoutFieldConfig)[], config?: DbxForgeFlexLayoutConfig): GroupField;
6956
+ declare function dbxForgeFlexLayout(fields: readonly (FieldDef<unknown> | DbxForgeFlexLayoutFieldConfig)[], config?: Omit<DbxForgeFlexLayoutConfig, 'fields'>): ContainerField;
6579
6957
 
6580
6958
  /**
6581
6959
  * Registered wrapper type name for the Material-style form-field wrapper.
@@ -6584,11 +6962,35 @@ declare function dbxForgeFlexLayout(fieldConfigs: (FieldDef<unknown> | DbxForgeF
6584
6962
  * wrapper chains via {@link dbxForgeMaterialFormFieldWrappedFieldFunction}.
6585
6963
  */
6586
6964
  declare const DBX_FORGE_FORM_FIELD_WRAPPER_NAME: "dbx-forge-form-field-wrapper";
6965
+ /**
6966
+ * Where the form-field wrapper should render the field's primary label.
6967
+ *
6968
+ * - `'wrapper'` — render the label in the notched outline only (default).
6969
+ * - `'content'` — suppress the notch label so the inner field can render its own
6970
+ * label (used by checkbox/toggle, whose Material elements render their label inline).
6971
+ * - `'both'` — render the label in the notch AND let the inner field render its own.
6972
+ * - `'none'` — render no label in the notch and rely solely on `contentLabel`.
6973
+ */
6974
+ type DbxForgeFormFieldWrapperShowLabelAt = 'wrapper' | 'content' | 'both' | 'none';
6975
+ /**
6976
+ * Props for the form-field wrapper. Passed via `addWrappers({ type, props })`
6977
+ * and exposed to the wrapper component as a single `props` input.
6978
+ */
6979
+ interface DbxForgeFormFieldWrapperProps {
6980
+ /**
6981
+ * Optional label override for the notch.
6982
+ *
6983
+ * When set, this replaces the field's primary label inside the notched outline.
6984
+ * Has no effect when {@link showLabelAt} is `'content'` or `'none'`.
6985
+ */
6986
+ readonly label?: DynamicText;
6987
+ }
6587
6988
  /**
6588
6989
  * Marker interface for a wrapper config that targets the form-field wrapper.
6589
6990
  */
6590
6991
  interface DbxForgeFormFieldWrapperDef {
6591
6992
  readonly type: typeof DBX_FORGE_FORM_FIELD_WRAPPER_NAME;
6993
+ readonly props?: DbxForgeFormFieldWrapperProps;
6592
6994
  }
6593
6995
  /**
6594
6996
  * Adds the Material-style form-field wrapper ({@link DBX_FORGE_FORM_FIELD_WRAPPER_NAME}) to
@@ -6598,6 +7000,20 @@ interface DbxForgeFormFieldWrapperDef {
6598
7000
  * @param instance - the field builder instance to mutate
6599
7001
  */
6600
7002
  declare function configureDbxForgeFormFieldWrapper<C extends DbxForgeFieldFunctionDef<any>>(instance: DbxForgeFieldFunctionFieldDefBuilderFunctionInstance<C>): void;
7003
+ /**
7004
+ * Returns a configurator that adds the form-field wrapper with the given props.
7005
+ *
7006
+ * Use this from a field factory's `buildFieldDef` step to attach the wrapper and
7007
+ * pass props (such as `showLabelAt` / `contentLabel`) through to the wrapper component.
7008
+ *
7009
+ * Undefined entries in `props` are dropped, and `props` is omitted from the wrapper
7010
+ * config entirely when no values remain — keeps the wrapper bare in the common case
7011
+ * (e.g. a checkbox/toggle with no label override).
7012
+ *
7013
+ * @param props - wrapper props applied to the inserted wrapper config
7014
+ * @returns a configurator that mutates the builder instance to add the wrapper
7015
+ */
7016
+ declare function configureDbxForgeFormFieldWrapperWith(inputProps?: Maybe<DbxForgeFormFieldWrapperProps>): <C extends DbxForgeFieldFunctionDef<any>>(instance: DbxForgeFieldFunctionFieldDefBuilderFunctionInstance<C>) => void;
6601
7017
 
6602
7018
  /**
6603
7019
  * Forge wrapper field component that renders child fields inside a Material-style
@@ -6609,9 +7025,18 @@ declare function configureDbxForgeFormFieldWrapper<C extends DbxForgeFieldFuncti
6609
7025
  declare class DbxForgeFormFieldWrapperComponent implements FieldWrapperContract {
6610
7026
  readonly fieldComponent: _angular_core.Signal<ViewContainerRef>;
6611
7027
  readonly fieldInputs: _angular_core.InputSignal<WrapperFieldInputs | undefined>;
7028
+ /**
7029
+ * Wrapper config props passed via `addWrappers({ type, props })`.
7030
+ * ng-forge delivers wrapper config properties (with `type` stripped) as individual inputs.
7031
+ */
7032
+ readonly props: _angular_core.InputSignal<DbxForgeFormFieldWrapperProps | undefined>;
6612
7033
  private readonly formState;
6613
7034
  readonly isDisabled: _angular_core.Signal<boolean | undefined>;
6614
- readonly label: _angular_core.Signal<string | undefined>;
7035
+ /**
7036
+ * Resolved notch label. Prefers a wrapper-level `props.label` override and
7037
+ * falls back to the wrapped field's own label.
7038
+ */
7039
+ readonly label: _angular_core.Signal<_ng_forge_dynamic_forms.DynamicText | undefined>;
6615
7040
  readonly hintSignal: _angular_core.Signal<any>;
6616
7041
  readonly classNameSignal: _angular_core.Signal<string>;
6617
7042
  private readonly keySignal;
@@ -6641,7 +7066,7 @@ declare class DbxForgeFormFieldWrapperComponent implements FieldWrapperContract
6641
7066
  protected readonly errorId: _angular_core.Signal<string>;
6642
7067
  protected readonly hintId: _angular_core.Signal<string>;
6643
7068
  static ɵfac: _angular_core.ɵɵFactoryDeclaration<DbxForgeFormFieldWrapperComponent, never>;
6644
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<DbxForgeFormFieldWrapperComponent, "dbx-forge-form-field-wrapper", never, { "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
7069
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<DbxForgeFormFieldWrapperComponent, "dbx-forge-form-field-wrapper", never, { "fieldInputs": { "alias": "fieldInputs"; "required": false; "isSignal": true; }; "props": { "alias": "props"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
6645
7070
  }
6646
7071
 
6647
7072
  /**
@@ -6682,31 +7107,42 @@ interface DbxForgeSectionWrapper {
6682
7107
  readonly subsection?: boolean;
6683
7108
  }
6684
7109
  /**
6685
- * Creates a section wrapper config for use in a field's `wrappers` array.
7110
+ * Section wrapper config attach via a field's `wrappers: []` array for a semantic section with header and optional card elevation.
6686
7111
  *
6687
7112
  * @param config - the section wrapper configuration without the `type` property
6688
7113
  * @returns a complete {@link DbxForgeSectionWrapper} config with the type set
6689
7114
  *
7115
+ * @dbxFormField
7116
+ * @dbxFormSlug section-wrapper
7117
+ * @dbxFormTier primitive
7118
+ * @dbxFormProduces WrapperConfig
7119
+ * @dbxFormReturns WrapperConfig
7120
+ * @dbxFormArrayOutput no
7121
+ * @dbxFormConfigInterface DbxForgeSectionWrapper
7122
+ *
6690
7123
  * @example
6691
7124
  * ```typescript
6692
- * dbxForgeNameField({
6693
- * wrappers: [dbxForgeSectionWrapper({ headerConfig: { header: 'Contact' } })]
6694
- * })
7125
+ * dbxForgeSectionWrapper({ headerConfig: { text: 'Contact Details' } })
6695
7126
  * ```
6696
7127
  */
6697
7128
  declare function dbxForgeSectionWrapper(config: Omit<DbxForgeSectionWrapper, 'type'>): DbxForgeSectionWrapper;
6698
7129
  /**
6699
- * Creates a subsection wrapper config for use in a field's `wrappers` array.
6700
- * Sets `subsection: true` and defaults heading level to 4.
7130
+ * Subsection variant of `section-wrapper` defaults to heading level 4 and `subsection: true`.
6701
7131
  *
6702
7132
  * @param config - the subsection wrapper configuration without the `type` and `subsection` properties
6703
7133
  * @returns a complete {@link DbxForgeSectionWrapper} config with `type` and `subsection: true` set
6704
7134
  *
7135
+ * @dbxFormField
7136
+ * @dbxFormSlug subsection-wrapper
7137
+ * @dbxFormTier primitive
7138
+ * @dbxFormProduces WrapperConfig
7139
+ * @dbxFormReturns WrapperConfig
7140
+ * @dbxFormArrayOutput no
7141
+ * @dbxFormConfigInterface DbxForgeSectionWrapper
7142
+ *
6705
7143
  * @example
6706
7144
  * ```typescript
6707
- * dbxForgeNameField({
6708
- * wrappers: [dbxForgeSubsectionWrapper({ headerConfig: { header: 'Name' } })]
6709
- * })
7145
+ * dbxForgeSubsectionWrapper({ headerConfig: { text: 'Options' } })
6710
7146
  * ```
6711
7147
  */
6712
7148
  declare function dbxForgeSubsectionWrapper(config: Omit<DbxForgeSectionWrapper, 'type' | 'subsection'>): DbxForgeSectionWrapper;
@@ -6819,16 +7255,22 @@ interface DbxForgeStyleWrapper {
6819
7255
  readonly styleGetter?: MaybeObservableOrValue<DbxForgeStyleObject>;
6820
7256
  }
6821
7257
  /**
6822
- * Creates a style wrapper config for use in a field's `wrappers` array.
7258
+ * Style wrapper config applies dynamic CSS classes (`ngClass`) and/or inline styles (`ngStyle`) to any field via its `wrappers: []`.
6823
7259
  *
6824
7260
  * @param config - the style wrapper configuration without the `type` property
6825
7261
  * @returns a complete {@link DbxForgeStyleWrapper} config with the type set
6826
7262
  *
7263
+ * @dbxFormField
7264
+ * @dbxFormSlug style-wrapper
7265
+ * @dbxFormTier primitive
7266
+ * @dbxFormProduces WrapperConfig
7267
+ * @dbxFormReturns WrapperConfig
7268
+ * @dbxFormArrayOutput no
7269
+ * @dbxFormConfigInterface DbxForgeStyleWrapper
7270
+ *
6827
7271
  * @example
6828
7272
  * ```typescript
6829
- * dbxForgeNameField({
6830
- * wrappers: [dbxForgeStyleWrapper({ classGetter: 'highlight', styleGetter: { color: 'red' } })]
6831
- * })
7273
+ * dbxForgeStyleWrapper({ classGetter: 'highlighted' })
6832
7274
  * ```
6833
7275
  */
6834
7276
  declare function dbxForgeStyleWrapper(config: Omit<DbxForgeStyleWrapper, 'type'>): DbxForgeStyleWrapper;
@@ -7255,10 +7697,7 @@ declare class DbxForgeFormComponent<T extends object = object> implements DbxFor
7255
7697
  * Default template for a view that extends AbstractSyncForgeFormDirective or AbstractConfigAsyncForgeFormDirective.
7256
7698
  */
7257
7699
  declare const DBX_FORGE_FORM_COMPONENT_TEMPLATE: "<dbx-forge></dbx-forge>";
7258
- /**
7259
- * Default providers for a view that extends AbstractSyncForgeFormDirective or AbstractConfigAsyncForgeFormDirective.
7260
- */
7261
- declare const dbxForgeFormComponentProviders: typeof provideDbxForgeFormContext;
7700
+
7262
7701
  /**
7263
7702
  * Default imports module for a view that extends AbstractSyncForgeFormDirective or AbstractConfigAsyncForgeFormDirective.
7264
7703
  */
@@ -7420,56 +7859,6 @@ declare function provideDbxForgeFormFieldDeclarations(...additionalFieldTypes: F
7420
7859
  __formValue?: unknown;
7421
7860
  };
7422
7861
 
7423
- /**
7424
- * The custom forge field type name for the searchable text field.
7425
- */
7426
- declare const DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME: "dbx-searchable-text";
7427
- /**
7428
- * The custom forge field type name for the searchable chip field.
7429
- */
7430
- declare const DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME: "dbx-searchable-chip";
7431
- /**
7432
- * Props interface for the forge searchable text field.
7433
- *
7434
- * Passed via the `props` property on the forge field definition.
7435
- */
7436
- interface DbxForgeSearchableTextFieldProps<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> {
7437
- readonly search: SearchableValueFieldStringSearchFn<T, M>;
7438
- readonly displayForValue: SearchableValueFieldDisplayFn<T, M>;
7439
- readonly hashForValue?: SearchableValueFieldHashFn<T, H>;
7440
- readonly allowStringValues?: boolean;
7441
- readonly convertStringValue?: (text: string) => T;
7442
- readonly showSelectedValue?: boolean;
7443
- readonly searchOnEmptyText?: boolean;
7444
- readonly display?: Partial<DbxInjectionComponentConfig>;
7445
- readonly useAnchor?: boolean;
7446
- readonly anchorForValue?: SearchableValueFieldAnchorFn<T, M>;
7447
- readonly showClearValue?: boolean;
7448
- readonly searchLabel?: string;
7449
- readonly refreshDisplayValues$?: Observable<unknown>;
7450
- readonly hint?: string;
7451
- readonly textInputValidator?: ValidatorFn | ValidatorFn[];
7452
- }
7453
- /**
7454
- * Props interface for the forge searchable chip field.
7455
- */
7456
- interface DbxForgeSearchableChipFieldProps<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends DbxForgeSearchableTextFieldProps<T, M, H> {
7457
- readonly multiSelect?: boolean;
7458
- readonly asArrayValue?: boolean;
7459
- }
7460
- /**
7461
- * Forge field definition interface for the searchable text field.
7462
- */
7463
- interface DbxForgeSearchableTextFieldDef<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends BaseValueField<DbxForgeSearchableTextFieldProps<T, M, H>, T> {
7464
- readonly type: typeof DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME;
7465
- }
7466
- /**
7467
- * Forge field definition interface for the searchable chip field.
7468
- */
7469
- interface DbxForgeSearchableChipFieldDef<T = unknown, M = unknown, H extends PrimativeKey = PrimativeKey> extends BaseValueField<DbxForgeSearchableChipFieldProps<T, M, H>, T | T[]> {
7470
- readonly type: typeof DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME;
7471
- }
7472
-
7473
7862
  /**
7474
7863
  * Module augmentation that registers all custom dbx-form forge field types
7475
7864
  * with ng-forge's DynamicFormFieldRegistry.
@@ -7561,30 +7950,44 @@ declare const DBX_FORGE_TEXT_VERIFY_PASSWORD_DEFAULT_AUTOCOMPLETE = "new-passwor
7561
7950
  interface DbxForgeTextPasswordFieldConfig extends Omit<DbxForgeTextFieldConfig, 'inputType' | 'key'>, Partial<Pick<DbxForgeTextFieldConfig, 'key'>> {
7562
7951
  }
7563
7952
  /**
7564
- * Creates a forge text password field with the input type set to `'password'`.
7953
+ * Password input (HTML `type="password"`) with secure autocomplete defaults.
7565
7954
  *
7566
7955
  * Defaults to the key `'password'` and label `'Password'` unless overridden.
7567
7956
  *
7568
7957
  * @param config - Optional configuration for the password field
7569
7958
  * @returns A {@link MatInputField} with password input type
7570
7959
  *
7960
+ * @dbxFormField
7961
+ * @dbxFormSlug password-field
7962
+ * @dbxFormProduces string
7963
+ * @dbxFormArrayOutput no
7964
+ * @dbxFormFieldDerivative text
7965
+ * @dbxFormConfigInterface DbxForgeTextPasswordFieldConfig
7966
+ *
7571
7967
  * @example
7572
7968
  * ```typescript
7573
- * const field = dbxForgeTextPasswordField();
7969
+ * dbxForgeTextPasswordField({ key: 'password', required: true })
7574
7970
  * ```
7575
7971
  */
7576
7972
  declare function dbxForgeTextPasswordField(config?: DbxForgeTextPasswordFieldConfig): DbxForgeField<MatInputField>;
7577
7973
  /**
7578
- * Creates a forge verify/confirm password field, typically used alongside a primary password field.
7974
+ * Companion to `password-field` for sign-up flows. Defaults `autocomplete` to `new-password`. Pair with `password-with-verify-fields` for cross-field equality validation.
7579
7975
  *
7580
7976
  * Defaults to the key `'verifyPassword'` and label `'Verify Password'` unless overridden.
7581
7977
  *
7582
7978
  * @param config - Optional configuration for the verify password field
7583
7979
  * @returns A {@link MatInputField} with password input type
7584
7980
  *
7981
+ * @dbxFormField
7982
+ * @dbxFormSlug verify-password-field
7983
+ * @dbxFormProduces string
7984
+ * @dbxFormArrayOutput no
7985
+ * @dbxFormFieldDerivative password-field
7986
+ * @dbxFormConfigInterface DbxForgeTextPasswordFieldConfig
7987
+ *
7585
7988
  * @example
7586
7989
  * ```typescript
7587
- * const field = dbxForgeTextVerifyPasswordField();
7990
+ * dbxForgeTextVerifyPasswordField({ key: 'verifyPassword' })
7588
7991
  * ```
7589
7992
  */
7590
7993
  declare function dbxForgeTextVerifyPasswordField(config?: DbxForgeTextPasswordFieldConfig): DbxForgeField<MatInputField>;
@@ -7602,8 +8005,7 @@ interface DbxForgeTextPasswordWithVerifyFieldConfig {
7602
8005
  readonly verifyPassword?: DbxForgeTextPasswordFieldConfig;
7603
8006
  }
7604
8007
  /**
7605
- * Creates a forge password and verify password pair with a custom validator on the verify field
7606
- * that ensures both values match.
8008
+ * Password + verify-password pair with cross-field equality validation wired up. Drop-in for sign-up flows.
7607
8009
  *
7608
8010
  * The verify password field uses an expression-based custom validator that compares the
7609
8011
  * verify field value against the primary password field's value via `formValue`.
@@ -7611,9 +8013,16 @@ interface DbxForgeTextPasswordWithVerifyFieldConfig {
7611
8013
  * @param config - Configuration for the password and verify password fields
7612
8014
  * @returns A tuple of `[passwordField, verifyPasswordField]`
7613
8015
  *
8016
+ * @dbxFormField
8017
+ * @dbxFormSlug password-with-verify-fields
8018
+ * @dbxFormProduces FieldDef[]
8019
+ * @dbxFormArrayOutput no
8020
+ * @dbxFormFieldTemplate password-field, verify-password-field
8021
+ * @dbxFormConfigInterface DbxForgeTextPasswordWithVerifyFieldConfig
8022
+ *
7614
8023
  * @example
7615
8024
  * ```typescript
7616
- * const [passwordField, verifyPasswordField] = dbxForgeTextPasswordWithVerifyField();
8025
+ * dbxForgeTextPasswordWithVerifyField({ password: { required: true } })
7617
8026
  * ```
7618
8027
  */
7619
8028
  declare function dbxForgeTextPasswordWithVerifyField(config?: DbxForgeTextPasswordWithVerifyFieldConfig): readonly [DbxForgeField<MatInputField>, DbxForgeField<MatInputField>];
@@ -7657,7 +8066,7 @@ interface DbxForgeUsernameLoginFieldsConfig {
7657
8066
  readonly verifyPassword?: Maybe<boolean | DbxForgeTextPasswordFieldConfig>;
7658
8067
  }
7659
8068
  /**
7660
- * Creates an array of forge field definitions for a username/password login form.
8069
+ * Complete login/signup field set: username, password, and optional verify-password. Drop into the top-level `fields: []`.
7661
8070
  *
7662
8071
  * When `verifyPassword` is provided, a second password field is added with a custom
7663
8072
  * validator that ensures both password values match.
@@ -7665,23 +8074,37 @@ interface DbxForgeUsernameLoginFieldsConfig {
7665
8074
  * @param config - Login fields configuration
7666
8075
  * @returns An array of forge field definitions for the login form
7667
8076
  *
8077
+ * @dbxFormField
8078
+ * @dbxFormSlug username-password-login-fields
8079
+ * @dbxFormProduces FieldDef[]
8080
+ * @dbxFormArrayOutput no
8081
+ * @dbxFormFieldTemplate username-login-field, password-field, verify-password-field
8082
+ * @dbxFormConfigInterface DbxForgeUsernameLoginFieldsConfig
8083
+ *
7668
8084
  * @example
7669
8085
  * ```typescript
7670
- * const fields = dbxForgeUsernamePasswordLoginFields({ username: 'email' });
8086
+ * dbxForgeUsernamePasswordLoginFields({ username: 'email', verifyPassword: true })
7671
8087
  * ```
7672
8088
  */
7673
8089
  declare function dbxForgeUsernamePasswordLoginFields(config: DbxForgeUsernameLoginFieldsConfig): DbxForgeField<MatInputField>[];
7674
8090
  /**
7675
- * Creates a single forge username field for a login form.
8091
+ * Username field for login forms. Accepts `"email"` or `"username"` as shorthand presets, or a full config object.
7676
8092
  *
7677
8093
  * Supports email or plain text input based on the provided configuration.
7678
8094
  *
7679
8095
  * @param username - Either `'email'`, `'username'`, or a full config object
7680
8096
  * @returns A forge field definition for the username input
7681
8097
  *
8098
+ * @dbxFormField
8099
+ * @dbxFormSlug username-login-field
8100
+ * @dbxFormProduces string
8101
+ * @dbxFormArrayOutput no
8102
+ * @dbxFormFieldDerivative text
8103
+ * @dbxFormConfigInterface DbxForgeUsernameLoginFieldUsernameConfigInput
8104
+ *
7682
8105
  * @example
7683
8106
  * ```typescript
7684
- * const field = dbxForgeUsernameLoginField('email');
8107
+ * dbxForgeUsernameLoginField({ username: 'email' })
7685
8108
  * ```
7686
8109
  */
7687
8110
  declare function dbxForgeUsernameLoginField(username: DbxForgeUsernameLoginFieldUsernameConfigInput): DbxForgeField<MatInputField>;
@@ -11429,6 +11852,7 @@ declare class DbxFormlyComponent<T> implements DbxForm, DbxFormlyContextDelegate
11429
11852
  ngOnInit(): void;
11430
11853
  init(initialize: DbxFormlyInitialize<T>): void;
11431
11854
  getValue(): Observable<T>;
11855
+ currentValue(): Observable<T>;
11432
11856
  setValue(value: T): void;
11433
11857
  resetForm(): void;
11434
11858
  get isDisabled(): boolean;
@@ -11444,10 +11868,7 @@ declare class DbxFormlyComponent<T> implements DbxForm, DbxFormlyContextDelegate
11444
11868
  * Default template for a view that extends AbstractFormlyFormDirective.
11445
11869
  */
11446
11870
  declare const DBX_FORMLY_FORM_COMPONENT_TEMPLATE = "<dbx-formly></dbx-formly>";
11447
- /**
11448
- * Default providers for a view that extends AbstractFormlyFormDirective.
11449
- */
11450
- declare const dbxFormlyFormComponentProviders: typeof provideFormlyContext;
11871
+
11451
11872
  /**
11452
11873
  * Default imports module for a view that extends AbstractFormlyFormDirective.
11453
11874
  */
@@ -11583,5 +12004,5 @@ interface ProvideDbxFormConfigurationConfig {
11583
12004
  */
11584
12005
  declare function provideDbxFormConfiguration(config?: ProvideDbxFormConfigurationConfig): EnvironmentProviders;
11585
12006
 
11586
- 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$1 as DBX_FORGE_SEARCHABLE_CHIP_FIELD_TYPE_NAME, DBX_FORGE_SEARCHABLE_TEXT_FIELD_TYPE_NAME$1 as 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 };
11587
- export type { AbstractFormExpandSectionConfig, AddressFieldConfig, AddressFormlyFieldsConfig, AddressLineFieldConfig, AddressListFieldConfig, ApplyTimeOffsetInput, AttributesFieldConfig, BaseFieldConfig, BasePartialPotentialFieldConfig, CheckboxFieldConfig, ChecklistItemDisplayContent, ChecklistItemFieldBuilderInput, ChecklistItemFieldConfig, ChecklistItemFieldDataSetBuilderInput, ChecklistItemFieldDataSetFieldKey, ChecklistItemFieldDataSetFieldValueForKey, ChecklistItemFieldDataSetItem, ChecklistItemFieldDisplayComponent, ChecklistType, ChipTextFieldConfig, CityFieldConfig, ComponentFieldConfig, ConfiguredSearchableValueFieldDisplayValue, CountryFieldConfig, DateDateRangeFieldConfig, DateDateRangeFieldDateConfig, DateDateTimeRangeFieldConfig, DateTimeCalcInput, DateTimeFieldCalc, DateTimeFieldConfig, DateTimePreset, DateTimePresetConfiguration, DateTimePresetValue, DateTimeRangeFieldTimeConfig, DbxActionFormMapValueFunction, DbxChecklistItemFieldProps, DbxDateTimeFieldProps, DbxDateTimeFieldSyncField, DbxDateTimeFieldSyncParsedField, DbxDateTimeFieldSyncType, DbxDateTimeFieldTimeDateConfig, DbxDateTimePickerConfiguration, DbxDurationPickerChangeCallback, DbxDurationPickerPopoverData, DbxFixedDateRangeDateRangeInput, DbxFixedDateRangeFieldProps, DbxFixedDateRangePickerConfiguration, DbxFixedDateRangePicking, DbxFixedDateRangeSelectionMode, DbxFlexLayoutWrapperGroupFieldConfig, DbxFlexLayoutWrapperGroupFieldConfigDefaults, DbxFlexWrapperConfig, DbxForgeActionDialogComponentButtonConfig, DbxForgeActionDialogComponentConfig, DbxForgeAddressFieldsConfig, DbxForgeAddressGroupConfig, DbxForgeAddressLineFieldConfig, DbxForgeAddressListFieldConfig, DbxForgeArrayFieldConfig, DbxForgeArrayFieldElementWrapperDef, DbxForgeArrayFieldElementWrapperProps, DbxForgeArrayFieldFunction, DbxForgeArrayFieldWrapperDef, DbxForgeArrayFieldWrapperProps, DbxForgeArrayItemEvaluationContextInput, DbxForgeArrayItemEvaluationFn, DbxForgeBuildFieldDefConfig, DbxForgeBuildFieldDefFunction, DbxForgeCheckboxFieldConfig, DbxForgeChecklistFieldConfig, DbxForgeChecklistFieldFunction, DbxForgeCityFieldConfig, DbxForgeComponentFieldConfig, DbxForgeComponentFieldDef, DbxForgeComponentFieldFunction, DbxForgeComponentFieldProps, DbxForgeContainerLogicConfig, DbxForgeCountryFieldConfig, DbxForgeDateFieldConfig, DbxForgeDateRangeFieldComponentProps, DbxForgeDateRangeFieldDateConfig, DbxForgeDateRangeFieldDef, DbxForgeDateRangeRowConfig, DbxForgeDateRangeValue, DbxForgeDateTimeFieldComponentProps, DbxForgeDateTimeFieldConfig, DbxForgeDateTimeFieldDef, DbxForgeDateTimeRangeFieldTimeConfig, DbxForgeDateTimeRangeRowConfig, DbxForgeDateTimeSyncField, DbxForgeDollarAmountFieldConfig, DbxForgeEmailFieldConfig, DbxForgeExpandButtonType, DbxForgeExpandFieldDef, DbxForgeExpandFieldProps, DbxForgeExpandWrapperConfig, DbxForgeField, DbxForgeFieldAsyncTransformFunction, DbxForgeFieldAsyncTransformLogic, DbxForgeFieldAsyncTransformLogicWhenAlways, DbxForgeFieldAsyncTransformLogicWhenDefined, DbxForgeFieldAsyncValidatorWithFn, DbxForgeFieldCustomValidatorWithFn, DbxForgeFieldDebouncedTransformLogic, DbxForgeFieldDebouncedTransformLogicWhenAlways, DbxForgeFieldDebouncedTransformLogicWhenDefined, DbxForgeFieldFormConfig, DbxForgeFieldFunction, DbxForgeFieldFunctionConfig, DbxForgeFieldFunctionConfigPropsBuilder, DbxForgeFieldFunctionDef, DbxForgeFieldFunctionDefLogicValue, DbxForgeFieldFunctionFieldDefBuilder, DbxForgeFieldFunctionFieldDefBuilderFunctionInstance, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceAddValidationInput, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceFormConfigBuilder, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceLogicBuilder, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceLogicBuilderLogic, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceWrappersBuilder, DbxForgeFieldFunctionResult, DbxForgeFieldHiddenFieldsRef, DbxForgeFieldHintOrDescriptionValueRef, DbxForgeFieldHintValueRef, DbxForgeFieldIdempotentTransformLogic, DbxForgeFieldIdempotentTransformLogicWhenAlways, DbxForgeFieldIdempotentTransformLogicWhenDefined, DbxForgeFieldLogicAsyncFn, DbxForgeFieldLogicExternalData, DbxForgeFieldLogicFn, DbxForgeFieldLogicValueRef, DbxForgeFieldTransformFunction, DbxForgeFieldTransformLogic, DbxForgeFieldTransformType, DbxForgeFieldTransformWhen, DbxForgeFieldValidation, DbxForgeFieldValidatorInput, DbxForgeFieldValueIsAvailableCheckFn, DbxForgeFieldValueIsAvailableValidatorConfig, DbxForgeFinalizeFormConfigResult, DbxForgeFixedDateRangeFieldComponentProps, DbxForgeFixedDateRangeFieldConfig, DbxForgeFixedDateRangeFieldDef, DbxForgeFixedDateRangeValue, DbxForgeFlexLayoutConfig, DbxForgeFlexLayoutFieldConfig, DbxForgeFlexWrapper, DbxForgeFormFieldWrapperDef, DbxForgeGlobalFormConfigDefaults, DbxForgeGroupConfig, DbxForgeInfoButtonFieldDef, DbxForgeInfoButtonFieldProps, DbxForgeInfoWrapper, DbxForgeListSelectionFieldConfig, DbxForgeListSelectionFieldDef, DbxForgeListSelectionFieldFunction, DbxForgeListSelectionFieldProps, DbxForgeNumberFieldConfig, DbxForgeNumberFieldNumberConfig, DbxForgeNumberSliderFieldConfig, DbxForgePhoneFieldAutocomplete, DbxForgePhoneFieldConfig, DbxForgePhoneFieldDef, DbxForgePhoneFieldProps, DbxForgePickableChipFieldConfig, DbxForgePickableChipFieldDef, DbxForgePickableChipFieldFunction, DbxForgePickableFieldProps, DbxForgePickableListFieldConfig, DbxForgePickableListFieldDef, DbxForgePickableListFieldFunction, DbxForgeResolvedSelectionOption, DbxForgeRowConfig, DbxForgeSearchableChipFieldConfig, DbxForgeSearchableChipFieldDef$1 as DbxForgeSearchableChipFieldDef, DbxForgeSearchableChipFieldFunction, DbxForgeSearchableChipFieldProps$1 as DbxForgeSearchableChipFieldProps, DbxForgeSearchableStringChipFieldConfig, DbxForgeSearchableTextFieldConfig, DbxForgeSearchableTextFieldDef$1 as DbxForgeSearchableTextFieldDef, DbxForgeSearchableTextFieldFunction, DbxForgeSearchableTextFieldProps$1 as DbxForgeSearchableTextFieldProps, DbxForgeSectionWrapper, DbxForgeSourceSelectFieldConfig, DbxForgeSourceSelectFieldDef, DbxForgeSourceSelectFieldFunction, DbxForgeSourceSelectFieldProps, DbxForgeStateFieldConfig, DbxForgeStyleObject, DbxForgeStyleWrapper, DbxForgeTextAreaFieldConfig, DbxForgeTextAvailableFieldConfig, DbxForgeTextEditorFieldConfig, DbxForgeTextEditorFieldDef, DbxForgeTextEditorFieldProps, DbxForgeTextFieldConfig, DbxForgeTextFieldInputType, DbxForgeTextFieldLengthConfig, DbxForgeTextFieldPatternConfig, DbxForgeTextPasswordFieldConfig, DbxForgeTextPasswordWithVerifyFieldConfig, DbxForgeTimeDurationFieldComponentProps, DbxForgeTimeDurationFieldConfig, DbxForgeTimeDurationFieldDef, DbxForgeTimezoneStringFieldConfig, DbxForgeToggleFieldConfig, DbxForgeToggleWrapperConfig, DbxForgeUsernameLoginFieldUsernameConfig, DbxForgeUsernameLoginFieldUsernameConfigInput, DbxForgeUsernameLoginFieldsConfig, DbxForgeValueSelectionFieldConfig, DbxForgeValueSelectionFieldDef, DbxForgeValueSelectionFieldFunction, DbxForgeValueSelectionFieldProps, DbxForgeWebsiteUrlFieldConfig, DbxForgeWorkingWrapper, DbxForgeZipCodeFieldConfig, DbxFormActionDialogComponentButtonConfig, DbxFormActionDialogComponentConfig, DbxFormComponentFieldConfig, DbxFormComponentFormlyFieldConfig, DbxFormDisabledKey, DbxFormEvent, DbxFormExpandWrapperButtonType, DbxFormExpandWrapperConfig, DbxFormInfoConfig, DbxFormRepeatArrayAddTemplateFunction, DbxFormRepeatArrayConfig, DbxFormRepeatArrayFieldConfigPair, DbxFormRepeatArrayPair, DbxFormSearchFormFieldsConfig, DbxFormSearchFormFieldsValue, DbxFormSectionConfig, DbxFormSourceDirectiveMode, DbxFormStateRef, DbxFormStyleObject, DbxFormStyleWrapperConfig, DbxFormSubsectionConfig, DbxFormToggleWrapperConfig, DbxFormWorkingWrapperConfig, DbxFormlyContextDelegate, DbxFormlyFormState, DbxFormlyInitialize, DbxItemListFieldProps, DbxListFieldConfig, DefaultUsernameLoginFieldValue, DefaultUsernameLoginFieldsValue, DefaultValueFieldConfig, DescriptionFieldConfig, DisableAutocompleteForField, DollarAmountFieldConfig, EmailFieldConfig, ExtractDbxForgeFieldDef, FieldAutocompleteAttributeOption, FieldAutocompleteAttributeOptionRef, FieldAutocompleteAttributeValue, FieldAutocompleteAttributes, FieldConfig, FieldConfigParsersRef, FieldConfigWithParsers, FieldValueIsAvailableValidatorConfig, FieldValueIsAvailableValidatorFunction, FieldValueParser, FieldValuesAreEqualValidatorConfig, FilterPresetsInput, FixedDateRangeFieldConfig, FixedDateRangeScan, FixedDateRangeScanType, ForgeChecklistFieldFunction, ForgeComponentFieldFunction, ForgeFieldValidation, ForgeValueSelectionFieldFunction, FormControlPath, FormlyMessageProperties, FormlyValueParser, HiddenFieldConfig, HintFieldConfig, InternationalPhoneFieldConfig, InternationalPhoneFormlyFieldProps, IsDivisibleByError, IsNotWebsiteUrlErrorData, IsWebsiteUrlValidatorConfig, KeyboardStepResult, LabeledBaseFieldConfig, LabeledFieldConfig, MaterialFormFieldConfig, NumberFieldConfig, NumberFieldInputType, NumberFieldNumberConfig, NumberSliderFieldConfig, PartialPotentialFieldConfig, PhoneAndLabelFieldSectionConfig, PhoneListFieldConfig, PickableItemFieldConfig, PickableItemFieldItem, PickableItemFieldItemSortFn, PickableValueFieldDisplayFunction, PickableValueFieldDisplayValue, PickableValueFieldDisplayValueWithHash, PickableValueFieldFilterFunction, PickableValueFieldHashFunction, PickableValueFieldLoadValuesFunction, PickableValueFieldValue, PickableValueFieldValuesConfigForStaticLabeledValues, PickableValueFieldValuesConfigForStaticLabeledValuesConfig, PickableValueFieldsFieldProps, ProvideDbxFormConfigurationConfig, RepeatArrayFieldConfig, SearchableChipFieldConfig, SearchableChipValueFieldsFieldProps, SearchableTextFieldConfig, SearchableTextValueFieldsFieldProps, SearchableValueFieldAnchorFn, SearchableValueFieldDisplayFn, SearchableValueFieldDisplayValue, SearchableValueFieldHashFn, SearchableValueFieldStringSearchFn, SearchableValueFieldValue, SearchableValueFieldsFieldProps, SelectionDisplayValue, SelectionValue, SelectionValueHashFunction, SourceSelectDisplayFunction, SourceSelectDisplayValue, SourceSelectDisplayValueGroup, SourceSelectFieldConfig, SourceSelectFieldProps, SourceSelectLoadSource, SourceSelectLoadSourceLoadingState, SourceSelectLoadSourcesFunction, SourceSelectMetaValueReader, SourceSelectOpenFunction, SourceSelectOpenFunctionParams, SourceSelectOpenSourceResult, SourceSelectOptions, SourceSelectValue, SourceSelectValueGroup, SourceSelectValueMetaLoader, StateFieldConfig, StringSearchableChipFieldConfig, StringValueFieldsFieldProps, TextAreaFieldConfig, TextAvailableFieldConfig, TextEditorComponentFieldProps, TextEditorFieldConfig, TextFieldConfig, TextFieldInputType, TextFieldLengthConfig, TextFieldPatternConfig, TextPasswordFieldConfig, TextPasswordFieldPasswordParameters, TextPasswordWithVerifyFieldConfig, TimeDurationFieldConfig, TimeDurationFieldValueMode, TimeDurationFormlyFieldProps, TimeFieldConfig, TimezoneStringFieldConfig, ToggleFieldConfig, UsernameLoginFieldUsernameConfig, UsernameLoginFieldUsernameConfigInput, UsernameLoginFieldsConfig, ValidatorsForFieldConfig, ValidatorsForFieldConfigInput, ValueSelectionFieldConfig, ValueSelectionOption, ValueSelectionOptionClear, ValueSelectionOptionWithValue, WebsiteUrlFieldConfig, WrappedPhoneAndLabelFieldConfig, WrapperFormlyFieldConfig, ZipCodeFieldConfig };
12007
+ 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, SELF_DEPENDENCY_TOKEN, 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, configureDbxForgeFormFieldWrapperWith, 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, provideDbxForgeFormContext as 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, provideFormlyContext as 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 };
12008
+ export type { AbstractFormExpandSectionConfig, AddressFieldConfig, AddressFormlyFieldsConfig, AddressLineFieldConfig, AddressListFieldConfig, ApplyTimeOffsetInput, AttributesFieldConfig, BaseFieldConfig, BasePartialPotentialFieldConfig, CheckboxFieldConfig, ChecklistItemDisplayContent, ChecklistItemFieldBuilderInput, ChecklistItemFieldConfig, ChecklistItemFieldDataSetBuilderInput, ChecklistItemFieldDataSetFieldKey, ChecklistItemFieldDataSetFieldValueForKey, ChecklistItemFieldDataSetItem, ChecklistItemFieldDisplayComponent, ChecklistType, ChipTextFieldConfig, CityFieldConfig, ComponentFieldConfig, ConfiguredSearchableValueFieldDisplayValue, CountryFieldConfig, DateDateRangeFieldConfig, DateDateRangeFieldDateConfig, DateDateTimeRangeFieldConfig, DateTimeCalcInput, DateTimeFieldCalc, DateTimeFieldConfig, DateTimePreset, DateTimePresetConfiguration, DateTimePresetValue, DateTimeRangeFieldTimeConfig, DbxActionFormMapValueFunction, DbxChecklistItemFieldProps, DbxDateTimeFieldProps, DbxDateTimeFieldSyncField, DbxDateTimeFieldSyncParsedField, DbxDateTimeFieldSyncType, DbxDateTimeFieldTimeDateConfig, DbxDateTimePickerConfiguration, DbxDurationPickerChangeCallback, DbxDurationPickerPopoverData, DbxFixedDateRangeDateRangeInput, DbxFixedDateRangeFieldProps, DbxFixedDateRangePickerConfiguration, DbxFixedDateRangePicking, DbxFixedDateRangeSelectionMode, DbxFlexLayoutWrapperGroupFieldConfig, DbxFlexLayoutWrapperGroupFieldConfigDefaults, DbxFlexWrapperConfig, DbxForgeActionDialogComponentButtonConfig, DbxForgeActionDialogComponentConfig, DbxForgeAddressFieldsConfig, DbxForgeAddressGroupConfig, DbxForgeAddressLineFieldConfig, DbxForgeAddressListFieldConfig, DbxForgeArrayFieldConfig, DbxForgeArrayFieldElementWrapperDef, DbxForgeArrayFieldElementWrapperProps, DbxForgeArrayFieldFunction, DbxForgeArrayFieldWrapperDef, DbxForgeArrayFieldWrapperProps, DbxForgeArrayItemEvaluationContextInput, DbxForgeArrayItemEvaluationFn, DbxForgeBooleanShowLabelAt, DbxForgeBuildFieldDefConfig, DbxForgeBuildFieldDefFunction, DbxForgeCheckboxFieldConfig, DbxForgeChecklistFieldConfig, DbxForgeChecklistFieldFunction, DbxForgeCityFieldConfig, DbxForgeComponentFieldConfig, DbxForgeComponentFieldDef, DbxForgeComponentFieldFunction, DbxForgeComponentFieldProps, DbxForgeContainerConfig, DbxForgeContainerLogicConfig, DbxForgeCountryFieldConfig, DbxForgeDateFieldConfig, DbxForgeDateRangeFieldComponentProps, DbxForgeDateRangeFieldDateConfig, DbxForgeDateRangeFieldDef, DbxForgeDateRangeRowConfig, DbxForgeDateRangeValue, DbxForgeDateTimeFieldComponentProps, DbxForgeDateTimeFieldConfig, DbxForgeDateTimeFieldDef, DbxForgeDateTimeRangeFieldTimeConfig, DbxForgeDateTimeRangeRowConfig, DbxForgeDateTimeSyncField, DbxForgeDollarAmountFieldConfig, DbxForgeEmailFieldConfig, DbxForgeExpandButtonType, DbxForgeExpandFieldDef, DbxForgeExpandFieldProps, DbxForgeExpandWrapperConfig, DbxForgeField, DbxForgeFieldAsyncTransformFunction, DbxForgeFieldAsyncTransformLogic, DbxForgeFieldAsyncTransformLogicWhenAlways, DbxForgeFieldAsyncTransformLogicWhenDefined, DbxForgeFieldAsyncValidatorWithFn, DbxForgeFieldCustomValidatorWithFn, DbxForgeFieldDebouncedTransformLogic, DbxForgeFieldDebouncedTransformLogicWhenAlways, DbxForgeFieldDebouncedTransformLogicWhenDefined, DbxForgeFieldFormConfig, DbxForgeFieldFunction, DbxForgeFieldFunctionConfig, DbxForgeFieldFunctionConfigPropsBuilder, DbxForgeFieldFunctionDef, DbxForgeFieldFunctionDefLogicValue, DbxForgeFieldFunctionFieldDefBuilder, DbxForgeFieldFunctionFieldDefBuilderFunctionInstance, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceAddValidationInput, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceFormConfigBuilder, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceLogicBuilder, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceLogicBuilderLogic, DbxForgeFieldFunctionFieldDefBuilderFunctionInstanceWrappersBuilder, DbxForgeFieldFunctionResult, DbxForgeFieldHiddenFieldsRef, DbxForgeFieldHintOrDescriptionValueRef, DbxForgeFieldHintValueRef, DbxForgeFieldIdempotentTransformLogic, DbxForgeFieldIdempotentTransformLogicWhenAlways, DbxForgeFieldIdempotentTransformLogicWhenDefined, DbxForgeFieldLogicAsyncFn, DbxForgeFieldLogicExternalData, DbxForgeFieldLogicFn, DbxForgeFieldLogicValueRef, DbxForgeFieldTransformFunction, DbxForgeFieldTransformLogic, DbxForgeFieldTransformType, DbxForgeFieldTransformWhen, DbxForgeFieldValidation, DbxForgeFieldValidatorInput, DbxForgeFieldValueIsAvailableCheckFn, DbxForgeFieldValueIsAvailableValidatorConfig, DbxForgeFinalizeFormConfigResult, DbxForgeFixedDateRangeFieldComponentProps, DbxForgeFixedDateRangeFieldConfig, DbxForgeFixedDateRangeFieldDef, DbxForgeFixedDateRangeValue, DbxForgeFlexLayoutConfig, DbxForgeFlexLayoutFieldConfig, DbxForgeFlexWrapper, DbxForgeFormFieldWrapperDef, DbxForgeFormFieldWrapperProps, DbxForgeFormFieldWrapperShowLabelAt, DbxForgeGlobalFormConfigDefaults, DbxForgeGroupConfig, DbxForgeInfoButtonFieldDef, DbxForgeInfoButtonFieldProps, DbxForgeInfoWrapper, DbxForgeListSelectionFieldConfig, DbxForgeListSelectionFieldDef, DbxForgeListSelectionFieldFunction, DbxForgeListSelectionFieldProps, DbxForgeNumberFieldConfig, DbxForgeNumberFieldNumberConfig, DbxForgeNumberSliderFieldConfig, DbxForgePhoneFieldAutocomplete, DbxForgePhoneFieldConfig, DbxForgePhoneFieldDef, DbxForgePhoneFieldProps, DbxForgePickableChipFieldConfig, DbxForgePickableChipFieldDef, DbxForgePickableChipFieldFunction, DbxForgePickableFieldProps, DbxForgePickableListFieldConfig, DbxForgePickableListFieldDef, DbxForgePickableListFieldFunction, DbxForgeResolvedSelectionOption, DbxForgeRowConfig, DbxForgeSearchableChipFieldConfig, DbxForgeSearchableChipFieldDef, DbxForgeSearchableChipFieldFunction, DbxForgeSearchableChipFieldProps, DbxForgeSearchableStringChipFieldConfig, DbxForgeSearchableTextFieldConfig, DbxForgeSearchableTextFieldDef, DbxForgeSearchableTextFieldFunction, DbxForgeSearchableTextFieldProps, DbxForgeSectionWrapper, DbxForgeSourceSelectFieldConfig, DbxForgeSourceSelectFieldDef, DbxForgeSourceSelectFieldFunction, DbxForgeSourceSelectFieldProps, DbxForgeStateFieldConfig, DbxForgeStyleObject, DbxForgeStyleWrapper, DbxForgeTextAreaFieldConfig, DbxForgeTextAvailableFieldConfig, DbxForgeTextEditorFieldConfig, DbxForgeTextEditorFieldDef, DbxForgeTextEditorFieldProps, DbxForgeTextFieldConfig, DbxForgeTextFieldInputType, DbxForgeTextFieldLengthConfig, DbxForgeTextFieldPatternConfig, DbxForgeTextPasswordFieldConfig, DbxForgeTextPasswordWithVerifyFieldConfig, DbxForgeTimeDurationFieldComponentProps, DbxForgeTimeDurationFieldConfig, DbxForgeTimeDurationFieldDef, DbxForgeTimezoneStringFieldConfig, DbxForgeToggleFieldConfig, DbxForgeToggleWrapperConfig, DbxForgeUsernameLoginFieldUsernameConfig, DbxForgeUsernameLoginFieldUsernameConfigInput, DbxForgeUsernameLoginFieldsConfig, DbxForgeValueSelectionFieldConfig, DbxForgeValueSelectionFieldDef, DbxForgeValueSelectionFieldFunction, DbxForgeValueSelectionFieldProps, DbxForgeWebsiteUrlFieldConfig, DbxForgeWorkingWrapper, DbxForgeZipCodeFieldConfig, DbxFormActionDialogComponentButtonConfig, DbxFormActionDialogComponentConfig, DbxFormComponentFieldConfig, DbxFormComponentFormlyFieldConfig, DbxFormDisabledKey, DbxFormEvent, DbxFormExpandWrapperButtonType, DbxFormExpandWrapperConfig, DbxFormInfoConfig, DbxFormRepeatArrayAddTemplateFunction, DbxFormRepeatArrayConfig, DbxFormRepeatArrayFieldConfigPair, DbxFormRepeatArrayPair, DbxFormSearchFormFieldsConfig, DbxFormSearchFormFieldsValue, DbxFormSectionConfig, DbxFormSourceDirectiveMode, DbxFormStateRef, DbxFormStyleObject, DbxFormStyleWrapperConfig, DbxFormSubsectionConfig, DbxFormToggleWrapperConfig, DbxFormWorkingWrapperConfig, DbxFormlyContextDelegate, DbxFormlyFormState, DbxFormlyInitialize, DbxItemListFieldProps, DbxListFieldConfig, DefaultUsernameLoginFieldValue, DefaultUsernameLoginFieldsValue, DefaultValueFieldConfig, DescriptionFieldConfig, DisableAutocompleteForField, DollarAmountFieldConfig, EmailFieldConfig, ExtractDbxForgeFieldDef, FieldAutocompleteAttributeOption, FieldAutocompleteAttributeOptionRef, FieldAutocompleteAttributeValue, FieldAutocompleteAttributes, FieldConfig, FieldConfigParsersRef, FieldConfigWithParsers, FieldValueIsAvailableValidatorConfig, FieldValueIsAvailableValidatorFunction, FieldValueParser, FieldValuesAreEqualValidatorConfig, FilterPresetsInput, FixedDateRangeFieldConfig, FixedDateRangeScan, FixedDateRangeScanType, ForgeChecklistFieldFunction, ForgeComponentFieldFunction, ForgeFieldValidation, ForgeValueSelectionFieldFunction, FormControlPath, FormlyMessageProperties, FormlyValueParser, HiddenFieldConfig, HintFieldConfig, InternationalPhoneFieldConfig, InternationalPhoneFormlyFieldProps, IsDivisibleByError, IsNotWebsiteUrlErrorData, IsWebsiteUrlValidatorConfig, KeyboardStepResult, LabeledBaseFieldConfig, LabeledFieldConfig, MaterialFormFieldConfig, NumberFieldConfig, NumberFieldInputType, NumberFieldNumberConfig, NumberSliderFieldConfig, PartialPotentialFieldConfig, PhoneAndLabelFieldSectionConfig, PhoneListFieldConfig, PickableItemFieldConfig, PickableItemFieldItem, PickableItemFieldItemSortFn, PickableValueFieldDisplayFunction, PickableValueFieldDisplayValue, PickableValueFieldDisplayValueWithHash, PickableValueFieldFilterFunction, PickableValueFieldHashFunction, PickableValueFieldLoadValuesFunction, PickableValueFieldValue, PickableValueFieldValuesConfigForStaticLabeledValues, PickableValueFieldValuesConfigForStaticLabeledValuesConfig, PickableValueFieldsFieldProps, ProvideDbxFormConfigurationConfig, RepeatArrayFieldConfig, SearchableChipFieldConfig, SearchableChipValueFieldsFieldProps, SearchableTextFieldConfig, SearchableTextValueFieldsFieldProps, SearchableValueFieldAnchorFn, SearchableValueFieldDisplayFn, SearchableValueFieldDisplayValue, SearchableValueFieldHashFn, SearchableValueFieldStringSearchFn, SearchableValueFieldValue, SearchableValueFieldsFieldProps, SelectionDisplayValue, SelectionValue, SelectionValueHashFunction, SourceSelectDisplayFunction, SourceSelectDisplayValue, SourceSelectDisplayValueGroup, SourceSelectFieldConfig, SourceSelectFieldProps, SourceSelectLoadSource, SourceSelectLoadSourceLoadingState, SourceSelectLoadSourcesFunction, SourceSelectMetaValueReader, SourceSelectOpenFunction, SourceSelectOpenFunctionParams, SourceSelectOpenSourceResult, SourceSelectOptions, SourceSelectValue, SourceSelectValueGroup, SourceSelectValueMetaLoader, StateFieldConfig, StringSearchableChipFieldConfig, StringValueFieldsFieldProps, TextAreaFieldConfig, TextAvailableFieldConfig, TextEditorComponentFieldProps, TextEditorFieldConfig, TextFieldConfig, TextFieldInputType, TextFieldLengthConfig, TextFieldPatternConfig, TextPasswordFieldConfig, TextPasswordFieldPasswordParameters, TextPasswordWithVerifyFieldConfig, TimeDurationFieldConfig, TimeDurationFieldValueMode, TimeDurationFormlyFieldProps, TimeFieldConfig, TimezoneStringFieldConfig, ToggleFieldConfig, UsernameLoginFieldUsernameConfig, UsernameLoginFieldUsernameConfigInput, UsernameLoginFieldsConfig, ValidatorsForFieldConfig, ValidatorsForFieldConfigInput, ValueSelectionFieldConfig, ValueSelectionOption, ValueSelectionOptionClear, ValueSelectionOptionWithValue, WebsiteUrlFieldConfig, WrappedPhoneAndLabelFieldConfig, WrapperFormlyFieldConfig, ZipCodeFieldConfig };