@axi-engine/fields 0.3.4 → 0.3.6

package/dist/policies/index.js

@@ -1,6 +0,0 @@
-export * from './policy';
-export * from './clamp-policy';
-export * from './clamp-max-policy';
-export * from './clamp-min-policy';
-export * from './policies';
-//# sourceMappingURL=index.js.map

package/dist/policies/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/policies/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AAEzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,YAAY,CAAC"}

package/dist/policies/policies.d.ts

@@ -1,38 +0,0 @@
-import { Policy } from './policy';
-export declare class Policies<T> {
-    private readonly policies;
-    get items(): Map<string, Policy<T>>;
-    /**
-     * Retrieves a specific policy instance by its ID.
-     * Useful for accessing a policy's internal state or methods.
-     * @template P The expected type of the policy.
-     * @param id The unique ID of the policy to retrieve.
-     * @returns The policy instance, or `undefined` if not found.
-     */
-    get<P extends Policy<T>>(id: string): P | undefined;
-    /**
-     * Adds a new policy to the field or replaces an existing one with the same ID.
-     * The new policy will be applied on the next `set()` operation.
-     * If a policy with the same ID already exists, its `destroy` method will be called before it is replaced.
-     * @param policy The policy instance to add.
-     */
-    add(policy: Policy<T>): this;
-    /**
-     * Removes a policy from the field by its ID and call `destroy` method.
-     * @param policyId The unique ID of the policy to remove.
-     * @returns `true` if the policy was found and removed, otherwise `false`.
-     */
-    remove(policyId: string): boolean;
-    isEmpty(): boolean;
-    /**
-     * Removes all policies from the field.
-     * After this, `set()` will no longer apply any transformations to the value until new policies are added.
-     */
-    clear(): void;
-    /**
-     * Forces the current value to be re-processed by all policies.
-     * Useful if a policy's logic has changed and you need to re-evaluate the current state.
-     */
-    apply(val: T): T;
-}
-//# sourceMappingURL=policies.d.ts.map

package/dist/policies/policies.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../src/policies/policies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAGhC,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD,IAAI,KAAK,2BAER;IAED;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAInD;;;;;OAKG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAQrB;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASjC,OAAO;IAIP;;;OAGG;IACH,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,CAAC;CAKb"}

package/dist/policies/policies.js

@@ -1,62 +0,0 @@
-export class Policies {
-    policies = new Map();
-    get items() {
-        return this.policies;
-    }
-    /**
-     * Retrieves a specific policy instance by its ID.
-     * Useful for accessing a policy's internal state or methods.
-     * @template P The expected type of the policy.
-     * @param id The unique ID of the policy to retrieve.
-     * @returns The policy instance, or `undefined` if not found.
-     */
-    get(id) {
-        return this.policies.get(id);
-    }
-    /**
-     * Adds a new policy to the field or replaces an existing one with the same ID.
-     * The new policy will be applied on the next `set()` operation.
-     * If a policy with the same ID already exists, its `destroy` method will be called before it is replaced.
-     * @param policy The policy instance to add.
-     */
-    add(policy) {
-        const existed = this.policies.get(policy.id);
-        existed?.destroy?.();
-        this.policies.set(policy.id, policy);
-        return this;
-    }
-    /**
-     * Removes a policy from the field by its ID and call `destroy` method.
-     * @param policyId The unique ID of the policy to remove.
-     * @returns `true` if the policy was found and removed, otherwise `false`.
-     */
-    remove(policyId) {
-        const policyToRemove = this.policies.get(policyId);
-        if (!policyToRemove) {
-            return false;
-        }
-        policyToRemove.destroy?.();
-        return this.policies.delete(policyId);
-    }
-    isEmpty() {
-        return this.policies.size === 0;
-    }
-    /**
-     * Removes all policies from the field.
-     * After this, `set()` will no longer apply any transformations to the value until new policies are added.
-     */
-    clear() {
-        this.policies.forEach(policy => policy.destroy?.());
-        this.policies.clear();
-    }
-    /**
-     * Forces the current value to be re-processed by all policies.
-     * Useful if a policy's logic has changed and you need to re-evaluate the current state.
-     */
-    apply(val) {
-        let finalVal = val;
-        this.policies.forEach(policy => finalVal = policy.apply(finalVal));
-        return finalVal;
-    }
-}
-//# sourceMappingURL=policies.js.map

package/dist/policies/policies.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"policies.js","sourceRoot":"","sources":["../../src/policies/policies.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,QAAQ;IACF,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IAEzD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAsB,EAAU;QACjC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAM,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAiB;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAErC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,QAAgB;QACrB,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAM;QACV,IAAI,QAAQ,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnE,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/policies/policy.d.ts

@@ -1,6 +0,0 @@
-export interface Policy<T> {
-    readonly id: string;
-    apply: (val: T) => T;
-    destroy?: () => void;
-}
-//# sourceMappingURL=policy.d.ts.map

package/dist/policies/policy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policies/policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB"}

package/dist/policies/policy.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=policy.js.map

package/dist/policies/policy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/policies/policy.ts"],"names":[],"mappings":""}

package/dist/serializer/field-serializer.d.ts

@@ -1,52 +0,0 @@
-import { PolicySerializer } from './policy-serializer';
-import { FieldRegistry } from '../field-registry';
-import { Field } from '../field';
-/**
- * A plain object representation of a Field's state for serialization.
- */
-export interface FieldSnapshot {
-    __type: string;
-    name: string;
-    value: any;
-    policies?: object[];
-}
-/**
- * Orchestrates the serialization and deserialization of Field instances.
- *
- * This class acts as a central point for converting complex Field objects into
- * plain, storable data (snapshots) and vice-versa. It uses a `FieldRegistry`
- * to resolve class constructors and a `PolicySerializer` to handle the state
- * of any attached policies.
- *
- * @todo Implement a `patch(field, snapshot)` method.
- *       Unlike `hydrate`, which creates a new
- *       instance, `patch` should update the state of an *existing* field instance
- *       without breaking external references to it.
- */
-export declare class FieldSerializer {
-    private readonly fieldRegistry;
-    private readonly policySerializer;
-    /**
-     * Creates an instance of FieldSerializer.
-     * @param {FieldRegistry} fieldRegistry - A registry that maps string type names to Field constructors.
-     * @param {PolicySerializer} policySerializer - A serializer dedicated to handling Policy instances.
-     */
-    constructor(fieldRegistry: FieldRegistry, policySerializer: PolicySerializer);
-    /**
-     * Creates a serializable snapshot of a Field instance.
-     * The snapshot includes the field's type, name, current value, and the state of all its policies.
-     * @param {Field<any>} field - The Field instance to serialize.
-     * @returns {FieldSnapshot} A plain object ready for JSON serialization.
-     */
-    snapshot(field: Field<any>): FieldSnapshot;
-    /**
-     * Restores a Field instance from its snapshot representation.
-     * It uses the `__type` property to find the correct constructor and hydrates
-     * the field with its value and all its policies.
-     * @param {FieldSnapshot} snapshot - The plain object snapshot to deserialize.
-     * @returns {Field<any>} A new, fully functional Field instance.
-     * @throws If the snapshot is invalid, missing a `__type`, or if the type is not registered.
-     */
-    hydrate(snapshot: FieldSnapshot): Field<any>;
-}
-//# sourceMappingURL=field-serializer.d.ts.map

package/dist/serializer/field-serializer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-serializer.d.ts","sourceRoot":"","sources":["../../src/serializer/field-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAC,KAAK,EAAC,MAAM,UAAU,CAAC;AAI/B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAQxB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAPnC;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB;IAIrD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,aAAa;IAgB1C;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,KAAK,CAAC,GAAG,CAAC;CAa7C"}

package/dist/serializer/field-serializer.js

@@ -1,66 +0,0 @@
-import { isNullOrUndefined, throwIfEmpty } from '@axi-engine/utils';
-/**
- * Orchestrates the serialization and deserialization of Field instances.
- *
- * This class acts as a central point for converting complex Field objects into
- * plain, storable data (snapshots) and vice-versa. It uses a `FieldRegistry`
- * to resolve class constructors and a `PolicySerializer` to handle the state
- * of any attached policies.
- *
- * @todo Implement a `patch(field, snapshot)` method.
- *       Unlike `hydrate`, which creates a new
- *       instance, `patch` should update the state of an *existing* field instance
- *       without breaking external references to it.
- */
-export class FieldSerializer {
-    fieldRegistry;
-    policySerializer;
-    /**
-     * Creates an instance of FieldSerializer.
-     * @param {FieldRegistry} fieldRegistry - A registry that maps string type names to Field constructors.
-     * @param {PolicySerializer} policySerializer - A serializer dedicated to handling Policy instances.
-     */
-    constructor(fieldRegistry, policySerializer) {
-        this.fieldRegistry = fieldRegistry;
-        this.policySerializer = policySerializer;
-    }
-    /**
-     * Creates a serializable snapshot of a Field instance.
-     * The snapshot includes the field's type, name, current value, and the state of all its policies.
-     * @param {Field<any>} field - The Field instance to serialize.
-     * @returns {FieldSnapshot} A plain object ready for JSON serialization.
-     */
-    snapshot(field) {
-        let snapshot = {
-            __type: field.typeName,
-            name: field.name,
-            value: field.value,
-        };
-        if (!field.policies.isEmpty()) {
-            const serializedPolicies = [];
-            field.policies.items.forEach(policy => serializedPolicies.push(this.policySerializer.snapshot(policy)));
-            snapshot.policies = serializedPolicies;
-        }
-        return snapshot;
-    }
-    /**
-     * Restores a Field instance from its snapshot representation.
-     * It uses the `__type` property to find the correct constructor and hydrates
-     * the field with its value and all its policies.
-     * @param {FieldSnapshot} snapshot - The plain object snapshot to deserialize.
-     * @returns {Field<any>} A new, fully functional Field instance.
-     * @throws If the snapshot is invalid, missing a `__type`, or if the type is not registered.
-     */
-    hydrate(snapshot) {
-        const fieldType = snapshot.__type;
-        throwIfEmpty(fieldType, 'Invalid field snapshot: missing "__type" identifier.');
-        const Ctor = this.fieldRegistry.get(fieldType);
-        let policies;
-        if (!isNullOrUndefined(snapshot.policies)) {
-            policies = [];
-            snapshot.policies.forEach((p) => policies.push(this.policySerializer.hydrate(p)));
-        }
-        return new Ctor(snapshot.name, snapshot.value, { policies });
-    }
-}
-//# sourceMappingURL=field-serializer.js.map

package/dist/serializer/field-serializer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-serializer.js","sourceRoot":"","sources":["../../src/serializer/field-serializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAgBlE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IAQP;IACA;IAPnB;;;;OAIG;IACH,YACmB,aAA4B,EAC5B,gBAAkC;QADlC,kBAAa,GAAb,aAAa,CAAe;QAC5B,qBAAgB,GAAhB,gBAAgB,CAAkB;IAErD,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAiB;QACxB,IAAI,QAAQ,GAAQ;YAClB,MAAM,EAAE,KAAK,CAAC,QAAQ;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAA;QAED,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9B,MAAM,kBAAkB,GAAa,EAAE,CAAC;YACxC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACxG,QAAQ,CAAC,QAAQ,GAAG,kBAAkB,CAAC;QACzC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,QAAuB;QAC7B,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,YAAY,CAAC,SAAS,EAAE,sDAAsD,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE/C,IAAI,QAAmC,CAAC;QACxC,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1C,QAAQ,GAAG,EAAE,CAAC;YACd,QAAQ,CAAC,QAAS,CAAC,OAAO,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,QAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAC,QAAQ,EAAC,CAAe,CAAC;IAC3E,CAAC;CACF"}

package/dist/serializer/field-tree-serializer.d.ts

@@ -1,50 +0,0 @@
-import { FieldsSerializer, FieldsSnapshot } from './fields-serializer';
-import { Fields } from '../fields';
-import { FieldTreeFactory } from '../field-tree-factory';
-import { FieldTree } from '../field-tree';
-/**
- * Represents the serializable state of a `FieldTree` container.
- *
- * This type describes a plain object that has:
- * 1. A required `__type` property to identify the tree's class.
- * 2. An arbitrary number of other properties, where each key is the `name`
- *    of a child node, and the value is the snapshot of that child node.
- *    The `| string` is included to ensure compatibility with the `__type` property.
- */
-export interface FieldTreeSnapshot {
-    __type: string;
-    [fieldName: string]: FieldsSnapshot | FieldTreeSnapshot | string;
-}
-/**
- * Orchestrates the recursive serialization and deserialization of `FieldTree` instances.
- *
- * This class handles the conversion of an entire `FieldTree` object graph into a
- * plain, storable snapshot and vice-versa. It delegates the processing of `Fields`
- * leaf nodes to a dedicated `FieldsSerializer`.
- * @todo Refactoring: The current implementation uses `if/else` logic in `snapshot` and `hydrate`
- *       to process different node types. A more extensible approach would be to use a
- *       registry of dedicated handlers for each node type.
- *       This would allow new node types to be supported without
- *       modifying this class, adhering to the Open/Closed Principle.
- *
- * @todo Implement a `patch(tree, snapshot)` method for recursive, non-destructive
- *       updates. This method should traverse the existing tree and the snapshot,
- *       patching nodes in place to maintain object references.
- */
-export declare class FieldTreeSerializer<TFields extends Fields> {
-    private readonly fieldTreeNodeFactory;
-    private readonly fieldsSerializer;
-    constructor(fieldTreeNodeFactory: FieldTreeFactory<TFields>, fieldsSerializer: FieldsSerializer<TFields>);
-    /**
-     * Creates a serializable snapshot of the entire tree and its contained fields.
-     * @returns A plain JavaScript object representing the complete state managed by this tree.
-     */
-    snapshot(tree: FieldTree<TFields>): FieldTreeSnapshot;
-    /**
-     * Restores the state of the tree from a snapshot.
-     * It intelligently creates missing nodes based on `__type` metadata and delegates hydration to child nodes.
-     * @param snapshot The snapshot object to load.
-     */
-    hydrate(snapshot: FieldTreeSnapshot): FieldTree<TFields>;
-}
-//# sourceMappingURL=field-tree-serializer.d.ts.map

package/dist/serializer/field-tree-serializer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-tree-serializer.d.ts","sourceRoot":"","sources":["../../src/serializer/field-tree-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAE,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AACjC,OAAO,EAAC,gBAAgB,EAAC,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAC,SAAS,EAAW,MAAM,eAAe,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,iBAAiB,GAAG,MAAM,CAAC;CAClE;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,mBAAmB,CAAC,OAAO,SAAS,MAAM;IAGnD,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,oBAAoB,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAC/C,gBAAgB,EAAE,gBAAgB,CAAC,OAAO,CAAC;IAI9D;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,iBAAiB;IAerD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,SAAS,CAAC,OAAO,CAAC;CAkBzD"}

package/dist/serializer/field-tree-serializer.js

@@ -1,68 +0,0 @@
-import { isString } from '@axi-engine/utils';
-import { Fields } from '../fields';
-import { FieldTree } from '../field-tree';
-/**
- * Orchestrates the recursive serialization and deserialization of `FieldTree` instances.
- *
- * This class handles the conversion of an entire `FieldTree` object graph into a
- * plain, storable snapshot and vice-versa. It delegates the processing of `Fields`
- * leaf nodes to a dedicated `FieldsSerializer`.
- * @todo Refactoring: The current implementation uses `if/else` logic in `snapshot` and `hydrate`
- *       to process different node types. A more extensible approach would be to use a
- *       registry of dedicated handlers for each node type.
- *       This would allow new node types to be supported without
- *       modifying this class, adhering to the Open/Closed Principle.
- *
- * @todo Implement a `patch(tree, snapshot)` method for recursive, non-destructive
- *       updates. This method should traverse the existing tree and the snapshot,
- *       patching nodes in place to maintain object references.
- */
-export class FieldTreeSerializer {
-    fieldTreeNodeFactory;
-    fieldsSerializer;
-    constructor(fieldTreeNodeFactory, fieldsSerializer) {
-        this.fieldTreeNodeFactory = fieldTreeNodeFactory;
-        this.fieldsSerializer = fieldsSerializer;
-    }
-    /**
-     * Creates a serializable snapshot of the entire tree and its contained fields.
-     * @returns A plain JavaScript object representing the complete state managed by this tree.
-     */
-    snapshot(tree) {
-        const res = {
-            __type: tree.typeName
-        };
-        tree.nodes.forEach((node, key) => {
-            if (node.typeName === tree.typeName) {
-                res[key] = this.snapshot(node);
-            }
-            else if (node.typeName === Fields.typeName) {
-                res[key] = this.fieldsSerializer.snapshot(node);
-            }
-        });
-        return res;
-    }
-    /**
-     * Restores the state of the tree from a snapshot.
-     * It intelligently creates missing nodes based on `__type` metadata and delegates hydration to child nodes.
-     * @param snapshot The snapshot object to load.
-     */
-    hydrate(snapshot) {
-        const { __type, ...nodes } = snapshot;
-        const tree = this.fieldTreeNodeFactory.tree();
-        for (const key in nodes) {
-            const nodeData = nodes[key];
-            if (isString(nodeData)) {
-                continue;
-            }
-            if (nodeData.__type === FieldTree.typeName) {
-                tree.addNode(key, this.hydrate(nodeData));
-            }
-            else if (nodeData.__type === Fields.typeName) {
-                tree.addNode(key, this.fieldsSerializer.hydrate(nodeData));
-            }
-        }
-        return tree;
-    }
-}
-//# sourceMappingURL=field-tree-serializer.js.map

package/dist/serializer/field-tree-serializer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"field-tree-serializer.js","sourceRoot":"","sources":["../../src/serializer/field-tree-serializer.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAC,SAAS,EAAW,MAAM,eAAe,CAAC;AAiBlD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,mBAAmB;IAGX;IACA;IAFnB,YACmB,oBAA+C,EAC/C,gBAA2C;QAD3C,yBAAoB,GAApB,oBAAoB,CAA2B;QAC/C,qBAAgB,GAAhB,gBAAgB,CAA2B;IAE9D,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAwB;QAC/B,MAAM,GAAG,GAAwB;YAC/B,MAAM,EAAE,IAAI,CAAC,QAAQ;SACtB,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAuB,EAAE,GAAW,EAAE,EAAE;YAC1D,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC7C,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,GAAwB,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,QAA2B;QACjC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC;QAE9C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvB,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;gBAC3C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,QAA6B,CAAC,CAAC,CAAA;YAChE,CAAC;iBAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC/C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAA0B,CAAC,CAAC,CAAA;YAC9E,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/serializer/fields-serializer.d.ts

@@ -1,49 +0,0 @@
-import { FieldSerializer, FieldSnapshot } from './field-serializer';
-import { Fields } from '../fields';
-import { FieldsFactory } from '../fields-factory';
-/**
- * A plain object representation of a Fields container's state for serialization.
- */
-export interface FieldsSnapshot {
-    __type: string;
-    [fieldName: string]: FieldSnapshot | string;
-}
-/**
- * Orchestrates the serialization and deserialization of `Fields` container instances.
- *
- * This class acts as a high-level composer, responsible for converting an entire `Fields` object
- * into a storable snapshot and back.
- * It delegates the actual serialization of each `Field` and `Policy` to their respective serializers.
- *
- * @todo Implement a `patch(fields, snapshot)` method. It should perform a non-destructive
- *       update, creating new fields, removing missing ones, and patching existing ones
- *       in place, preserving the container instance itself.
- */
-export declare class FieldsSerializer<TFields extends Fields> {
-    private readonly fieldsFactory;
-    private readonly fieldSerializer;
-    /**
-     * Creates an instance of FieldsSerializer.
-     * @param {FieldsFactory} fieldsFactory - A registry that maps string type names to Field constructors.
-     * @param {FieldSerializer} fieldSerializer - A serializer of field instances.
-     */
-    constructor(fieldsFactory: FieldsFactory<TFields>, fieldSerializer: FieldSerializer);
-    /**
-     * Creates a serializable snapshot of a `Fields` container.
-     *
-     * The snapshot includes a `__type` identifier (currently hardcoded) and an array of snapshots
-     * for each `Field` within the container.
-     * @param {Fields} fields - The `Fields` instance to serialize.
-     * @returns {FieldsSnapshot} A plain object ready for JSON serialization.
-     */
-    snapshot(fields: Fields): FieldsSnapshot;
-    /**
-     * Restores a `Fields` container instance from its snapshot representation.
-     *
-     * It iterates through the field snapshots and hydrates them individually, adding them to the new container.
-     * @param {FieldsSnapshot} snapshot - The plain object snapshot to deserialize.
-     * @returns {Fields} A new `DefaultFields` instance populated with the restored fields.
-     */
-    hydrate(snapshot: FieldsSnapshot): TFields;
-}
-//# sourceMappingURL=fields-serializer.d.ts.map

package/dist/serializer/fields-serializer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fields-serializer.d.ts","sourceRoot":"","sources":["../../src/serializer/fields-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AACjC,OAAO,EAAC,aAAa,EAAC,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,CAAC;CAC7C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB,CAAC,OAAO,SAAS,MAAM;IAOhD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAPlC;;;;OAIG;gBAEgB,aAAa,EAAE,aAAa,CAAC,OAAO,CAAC,EACrC,eAAe,EAAE,eAAe;IAInD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;IASxC;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO;CAY3C"}

package/dist/serializer/fields-serializer.js

@@ -1,57 +0,0 @@
-/**
- * Orchestrates the serialization and deserialization of `Fields` container instances.
- *
- * This class acts as a high-level composer, responsible for converting an entire `Fields` object
- * into a storable snapshot and back.
- * It delegates the actual serialization of each `Field` and `Policy` to their respective serializers.
- *
- * @todo Implement a `patch(fields, snapshot)` method. It should perform a non-destructive
- *       update, creating new fields, removing missing ones, and patching existing ones
- *       in place, preserving the container instance itself.
- */
-export class FieldsSerializer {
-    fieldsFactory;
-    fieldSerializer;
-    /**
-     * Creates an instance of FieldsSerializer.
-     * @param {FieldsFactory} fieldsFactory - A registry that maps string type names to Field constructors.
-     * @param {FieldSerializer} fieldSerializer - A serializer of field instances.
-     */
-    constructor(fieldsFactory, fieldSerializer) {
-        this.fieldsFactory = fieldsFactory;
-        this.fieldSerializer = fieldSerializer;
-    }
-    /**
-     * Creates a serializable snapshot of a `Fields` container.
-     *
-     * The snapshot includes a `__type` identifier (currently hardcoded) and an array of snapshots
-     * for each `Field` within the container.
-     * @param {Fields} fields - The `Fields` instance to serialize.
-     * @returns {FieldsSnapshot} A plain object ready for JSON serialization.
-     */
-    snapshot(fields) {
-        const res = {
-            __type: fields.typeName,
-        };
-        fields.fields.forEach(field => res[field.name] = this.fieldSerializer.snapshot(field));
-        return res;
-    }
-    /**
-     * Restores a `Fields` container instance from its snapshot representation.
-     *
-     * It iterates through the field snapshots and hydrates them individually, adding them to the new container.
-     * @param {FieldsSnapshot} snapshot - The plain object snapshot to deserialize.
-     * @returns {Fields} A new `DefaultFields` instance populated with the restored fields.
-     */
-    hydrate(snapshot) {
-        const { __type, ...fieldsData } = snapshot;
-        const fields = this.fieldsFactory.fields();
-        for (const fieldName in fieldsData) {
-            const fieldSnapshot = fieldsData[fieldName];
-            const restoredField = this.fieldSerializer.hydrate(fieldSnapshot);
-            fields.add(restoredField);
-        }
-        return fields;
-    }
-}
-//# sourceMappingURL=fields-serializer.js.map

package/dist/serializer/fields-serializer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fields-serializer.js","sourceRoot":"","sources":["../../src/serializer/fields-serializer.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IAOR;IACA;IAPnB;;;;OAIG;IACH,YACmB,aAAqC,EACrC,eAAgC;QADhC,kBAAa,GAAb,aAAa,CAAwB;QACrC,oBAAe,GAAf,eAAe,CAAiB;IAEnD,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAc;QACrB,MAAM,GAAG,GAAmB;YAC1B,MAAM,EAAE,MAAM,CAAC,QAAQ;SACxB,CAAC;QAEF,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACvF,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,QAAwB;QAC9B,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,GAAG,QAAQ,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC;QAE3C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,aAAa,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,aAA8B,CAAC,CAAC;YACnF,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/serializer/index.d.ts

@@ -1,8 +0,0 @@
-export * from './policies/clamp-policy-serializer-handler';
-export * from './policies/clamp-max-policy-serializer-handler';
-export * from './policies/clamp-min-policy-serializer-handler';
-export * from './policy-serializer';
-export * from './field-serializer';
-export * from './fields-serializer';
-export * from './field-tree-serializer';
-//# sourceMappingURL=index.d.ts.map

package/dist/serializer/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serializer/index.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAA;AAC1D,cAAc,gDAAgD,CAAA;AAC9D,cAAc,gDAAgD,CAAA;AAE9D,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA"}

package/dist/serializer/index.js

@@ -1,8 +0,0 @@
-export * from './policies/clamp-policy-serializer-handler';
-export * from './policies/clamp-max-policy-serializer-handler';
-export * from './policies/clamp-min-policy-serializer-handler';
-export * from './policy-serializer';
-export * from './field-serializer';
-export * from './fields-serializer';
-export * from './field-tree-serializer';
-//# sourceMappingURL=index.js.map

package/dist/serializer/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serializer/index.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAA;AAC1D,cAAc,gDAAgD,CAAA;AAC9D,cAAc,gDAAgD,CAAA;AAE9D,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA"}

package/dist/serializer/policies/clamp-max-policy-serializer-handler.d.ts

@@ -1,13 +0,0 @@
-import { PolicySerializerHandler } from '../policy-serializer';
-import { ClampMaxPolicy } from '../../policies';
-export declare class ClampMaxPolicySerializerHandler implements PolicySerializerHandler<ClampMaxPolicy, {
-    max: number;
-}> {
-    snapshot(policy: ClampMaxPolicy): {
-        max: number;
-    };
-    hydrate(data: {
-        max: number;
-    }): ClampMaxPolicy;
-}
-//# sourceMappingURL=clamp-max-policy-serializer-handler.d.ts.map

package/dist/serializer/policies/clamp-max-policy-serializer-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clamp-max-policy-serializer-handler.d.ts","sourceRoot":"","sources":["../../../src/serializer/policies/clamp-max-policy-serializer-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAE9C,qBAAa,+BAAgC,YAAW,uBAAuB,CAAC,cAAc,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;IAC9G,QAAQ,CAAC,MAAM,EAAE,cAAc;;;IAI/B,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CAG9B"}

package/dist/serializer/policies/clamp-max-policy-serializer-handler.js

@@ -1,10 +0,0 @@
-import { ClampMaxPolicy } from '../../policies';
-export class ClampMaxPolicySerializerHandler {
-    snapshot(policy) {
-        return { max: policy.max };
-    }
-    hydrate(data) {
-        return new ClampMaxPolicy(data.max);
-    }
-}
-//# sourceMappingURL=clamp-max-policy-serializer-handler.js.map

package/dist/serializer/policies/clamp-max-policy-serializer-handler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"clamp-max-policy-serializer-handler.js","sourceRoot":"","sources":["../../../src/serializer/policies/clamp-max-policy-serializer-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAE9C,MAAM,OAAO,+BAA+B;IAC1C,QAAQ,CAAC,MAAsB;QAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,IAAqB;QAC3B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/serializer/policies/clamp-min-policy-serializer-handler.d.ts

@@ -1,13 +0,0 @@
-import { PolicySerializerHandler } from '../policy-serializer';
-import { ClampMinPolicy } from '../../policies';
-export declare class ClampMinPolicySerializerHandler implements PolicySerializerHandler<ClampMinPolicy, {
-    min: number;
-}> {
-    snapshot(policy: ClampMinPolicy): {
-        min: number;
-    };
-    hydrate(data: {
-        min: number;
-    }): ClampMinPolicy;
-}
-//# sourceMappingURL=clamp-min-policy-serializer-handler.d.ts.map

package/dist/serializer/policies/clamp-min-policy-serializer-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clamp-min-policy-serializer-handler.d.ts","sourceRoot":"","sources":["../../../src/serializer/policies/clamp-min-policy-serializer-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAG9C,qBAAa,+BAAgC,YAAW,uBAAuB,CAAC,cAAc,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;IAC9G,QAAQ,CAAC,MAAM,EAAE,cAAc;;;IAI/B,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE;CAG9B"}

package/dist/serializer/policies/clamp-min-policy-serializer-handler.js

@@ -1,10 +0,0 @@
-import { ClampMinPolicy } from '../../policies';
-export class ClampMinPolicySerializerHandler {
-    snapshot(policy) {
-        return { min: policy.min };
-    }
-    hydrate(data) {
-        return new ClampMinPolicy(data.min);
-    }
-}
-//# sourceMappingURL=clamp-min-policy-serializer-handler.js.map

package/dist/serializer/policies/clamp-min-policy-serializer-handler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"clamp-min-policy-serializer-handler.js","sourceRoot":"","sources":["../../../src/serializer/policies/clamp-min-policy-serializer-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAC;AAG9C,MAAM,OAAO,+BAA+B;IAC1C,QAAQ,CAAC,MAAsB;QAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,IAAqB;QAC3B,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/serializer/policies/clamp-policy-serializer-handler.d.ts

@@ -1,16 +0,0 @@
-import { PolicySerializerHandler } from '../policy-serializer';
-import { ClampPolicy } from '../../policies';
-export declare class ClampPolicySerializerHandler implements PolicySerializerHandler<ClampPolicy, {
-    min: number;
-    max: number;
-}> {
-    snapshot(policy: ClampPolicy): {
-        min: number;
-        max: number;
-    };
-    hydrate(data: {
-        min: number;
-        max: number;
-    }): ClampPolicy;
-}
-//# sourceMappingURL=clamp-policy-serializer-handler.d.ts.map

package/dist/serializer/policies/clamp-policy-serializer-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"clamp-policy-serializer-handler.d.ts","sourceRoot":"","sources":["../../../src/serializer/policies/clamp-policy-serializer-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,uBAAuB,EAAC,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAG3C,qBAAa,4BAA6B,YAAW,uBAAuB,CAAC,WAAW,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;IACrH,QAAQ,CAAC,MAAM,EAAE,WAAW;;;;IAI5B,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;CAG3C"}