@dereekb/dbx-form 13.11.1 → 13.11.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-form",
-  "version": "13.11.1",
+  "version": "13.11.3",
   "sideEffects": [
     "*.scss",
     "*.css"
@@ -14,13 +14,13 @@
     "@angular/material-date-fns-adapter": "21.2.9",
     "@angular/platform-browser": "21.2.11",
     "@bobbyquantum/ngx-editor": "21.0.0",
-    "@dereekb/date": "13.11.1",
-    "@dereekb/dbx-core": "13.11.1",
-    "@dereekb/dbx-web": "13.11.1",
-    "@dereekb/model": "13.11.1",
-    "@dereekb/rxjs": "13.11.1",
-    "@dereekb/util": "13.11.1",
-    "@dereekb/vitest": "13.11.1",
+    "@dereekb/date": "13.11.3",
+    "@dereekb/dbx-core": "13.11.3",
+    "@dereekb/dbx-web": "13.11.3",
+    "@dereekb/model": "13.11.3",
+    "@dereekb/rxjs": "13.11.3",
+    "@dereekb/util": "13.11.3",
+    "@dereekb/vitest": "13.11.3",
     "@ng-forge/dynamic-forms": "0.9.0-next.6",
     "@ng-forge/dynamic-forms-material": "0.9.0-next.6",
     "@ng-web-apis/geolocation": "^5.2.0",

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

@@ -468,6 +468,11 @@ declare function stripForgeInternalKeys<T>(value: T): T;
  * from a form value object. Also removes keys whose values become empty objects
  * `{}` after recursive stripping.
  *
+ * Arrays are recursed into so that empties inside nested objects are stripped,
+ * but array length and item indices are preserved — primitive empty values
+ * (e.g. `NaN`, `''`) inside an array stay in place, since shifting indices would
+ * change the semantics of chip/list-style array fields.
+ *
  * This normalizes ng-forge output to match ngx-formly behavior, where the model
  * only includes keys that have been explicitly set by the user.
  *
@@ -478,6 +483,9 @@ declare function stripForgeInternalKeys<T>(value: T): T;
  *
  * stripEmptyForgeValues({ section: { a: "", b: "" } })
  * // → {}
+ *
+ * stripEmptyForgeValues({ items: [{ amount: NaN, name: 'a' }, { amount: 5 }] })
+ * // → { items: [{ name: 'a' }, { amount: 5 }] }
  * ```
  *
  * @param value - The form value object to clean
@@ -510,7 +518,7 @@ declare class DbxForgeFormContext<T = unknown> implements DbxMutableForm<T>, OnD
      */
     stripInternalKeys: boolean;
     /**
-     * When true (default), keys whose values are empty (`null`, `undefined`, or `""`)
+     * When true (default), keys whose values are empty (`null`, `undefined`, `""`, or `NaN`)
      * are stripped from the form value before emission. This normalizes ng-forge output
      * to match ngx-formly behavior, where the model only includes keys that have been
      * explicitly set by the user.
@@ -1285,6 +1293,7 @@ interface DbxForgeFieldFunctionConfig<C extends DbxForgeFieldFunctionDef<any>> {
  *   })
  * });
  * ```
+ * @__NO_SIDE_EFFECTS__
  */
 declare function dbxForgeFieldFunction<C extends DbxForgeFieldFunctionDef<F>, F extends FieldDef<any> = ExtractDbxForgeFieldDef<C>>(config: DbxForgeFieldFunctionConfig<C>): DbxForgeFieldFunction<C, F>;
 /**
@@ -2462,6 +2471,7 @@ declare enum DbxDateTimeValueMode {
  * const parser = dbxDateTimeInputValueParseFactory(DbxDateTimeValueMode.DATE_STRING, timezoneInstance);
  * const date = parser('2024-01-15T10:00:00Z');
  * ```
+ * @__NO_SIDE_EFFECTS__
  */
 declare function dbxDateTimeInputValueParseFactory(mode: DbxDateTimeValueMode, timezoneInstance: Maybe<DateTimezoneUtcNormalInstance>): (date: Maybe<Date | string | number>) => Maybe<Date>;
 /**
@@ -2479,6 +2489,7 @@ declare function dbxDateTimeInputValueParseFactory(mode: DbxDateTimeValueMode, t
  * const formatter = dbxDateTimeOutputValueFactory(DbxDateTimeValueMode.DAY_STRING, null);
  * const dayString = formatter(new Date()); // e.g., '2024-01-15'
  * ```
+ * @__NO_SIDE_EFFECTS__
  */
 declare function dbxDateTimeOutputValueFactory(mode: DbxDateTimeValueMode, timezoneInstance: Maybe<DateTimezoneUtcNormalInstance>): (date: Maybe<Date>) => Maybe<Date | string | number>;
 /**
@@ -2907,6 +2918,7 @@ declare function dateTimeFieldCalc(): DateTimeFieldCalc;
  *
  * @param input - The datetime calculation input containing date, time, and mode information
  * @returns The combined Date value, or undefined if the input is cleared or incomplete
+ * @__NO_SIDE_EFFECTS__
  */
 declare function buildCombinedDateTime(input: DateTimeCalcInput): Maybe<Date>;
 /**
@@ -9877,6 +9889,7 @@ declare function formlyValueSelectionField<T>(config: ValueSelectionFieldConfig<
  *
  * @param label - Optional label for the clear option
  * @returns A function that transforms selection options by prepending a clear option
+ * @__NO_SIDE_EFFECTS__
  */
 declare function formlyAddValueSelectionOptionFunction<T>(label?: string | undefined): (options: ValueSelectionOption<T>[]) => ValueSelectionOption<T>[];
 /**