@ng-forge/dynamic-forms 1.1.0-next.3 → 1.1.0-next.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ng-forge/dynamic-forms",
-  "version": "1.1.0-next.3",
+  "version": "1.1.0-next.4",
   "description": "Type-safe, signal-powered dynamic forms for Angular. Build complex forms from configuration with full TypeScript inference.",
   "type": "module",
   "license": "MIT",

package/types/ng-forge-dynamic-forms-internal.d.ts

@@ -2661,8 +2661,13 @@ declare class FieldContextRegistryService {
     /**
      * Resolves external data signals to their current values.
      *
-     * @param reactive - If true, reads signals reactively (creates dependencies).
-     *                   If false, reads signals with untracked() (no dependencies).
+     * Always reads reactively. Unlike the field value and form value (which are
+     * read untracked to break the validator -> state -> valid -> validator cycle),
+     * externalData is one-directional external input that validation output can
+     * never feed back into, so tracking it cannot cause a cycle. Reading it
+     * reactively is what lets dynamic values and validators bound to externalData
+     * update when it changes.
+     *
      * @returns Record of resolved external data values, or undefined if no external data.
      */
     private resolveExternalData;
@@ -3509,9 +3514,13 @@ declare function interpolateParams(message: string, error: ValidationError): str
 /**
  * Performs a deep equality comparison between two values.
  *
+ * Symbol-keyed properties are intentionally ignored: form values carry
+ * enumerable symbol metadata stamped by Angular Signal Forms, and comparing it
+ * would make structurally equal values compare unequal. Only string keys count.
+ *
  * @param a - First value
  * @param b - Second value
- * @returns true if values are deeply equal
+ * @returns true if values are deeply equal by their string-keyed properties
  */
 declare function isEqual(a: unknown, b: unknown): boolean;
 /**