@axi-engine/fields 0.3.7 → 0.3.8

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _axi_engine_utils from '@axi-engine/utils';
-import { Subscribable, ConstructorRegistry, Emitter, Constructor, PathType, DataStorage } from '@axi-engine/utils';
+import { Subscribable, Registry, Constructor, Emitter, PathType, DataStorage } from '@axi-engine/utils';
 
 interface Policy<T> {
     readonly id: string;
@@ -107,7 +107,7 @@ interface StringField extends Field<string> {
     clear(): void;
 }
 
-declare class FieldRegistry extends ConstructorRegistry<Field<any>> {
+declare class FieldRegistry extends Registry<string, Constructor<Field<any>>> {
 }
 
 /**
@@ -583,9 +583,8 @@ interface PolicySerializerHandler<T extends Policy<any>, S extends object> {
     hydrate(snapshotData: S): T;
 }
 declare class PolicySerializer {
-    private readonly handlers;
-    register(policyId: string, handler: PolicySerializerHandler<any, any>): this;
-    clearHandlers(): void;
+    handlers: Registry<string, PolicySerializerHandler<any, any>>;
+    register(policyId: string, handler: PolicySerializerHandler<any, any>): void;
     /**
      * Creates a serializable snapshot of a policy instance.
      * The snapshot includes the policy's state and a `__type` identifier.
@@ -648,6 +647,7 @@ interface FieldSnapshot {
     value: any;
     policies?: object[];
 }
+
 /**
  * Orchestrates the serialization and deserialization of Field instances.
  *
@@ -695,6 +695,7 @@ interface FieldsSnapshot {
     __type: string;
     [fieldName: string]: FieldSnapshot | string;
 }
+
 /**
  * Orchestrates the serialization and deserialization of `Fields` container instances.
  *
@@ -747,6 +748,7 @@ interface FieldTreeSnapshot {
     __type: string;
     [fieldName: string]: FieldsSnapshot | FieldTreeSnapshot | string;
 }
+
 /**
  * Orchestrates the recursive serialization and deserialization of `FieldTree` instances.
  *

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _axi_engine_utils from '@axi-engine/utils';
-import { Subscribable, ConstructorRegistry, Emitter, Constructor, PathType, DataStorage } from '@axi-engine/utils';
+import { Subscribable, Registry, Constructor, Emitter, PathType, DataStorage } from '@axi-engine/utils';
 
 interface Policy<T> {
     readonly id: string;
@@ -107,7 +107,7 @@ interface StringField extends Field<string> {
     clear(): void;
 }
 
-declare class FieldRegistry extends ConstructorRegistry<Field<any>> {
+declare class FieldRegistry extends Registry<string, Constructor<Field<any>>> {
 }
 
 /**
@@ -583,9 +583,8 @@ interface PolicySerializerHandler<T extends Policy<any>, S extends object> {
     hydrate(snapshotData: S): T;
 }
 declare class PolicySerializer {
-    private readonly handlers;
-    register(policyId: string, handler: PolicySerializerHandler<any, any>): this;
-    clearHandlers(): void;
+    handlers: Registry<string, PolicySerializerHandler<any, any>>;
+    register(policyId: string, handler: PolicySerializerHandler<any, any>): void;
     /**
      * Creates a serializable snapshot of a policy instance.
      * The snapshot includes the policy's state and a `__type` identifier.
@@ -648,6 +647,7 @@ interface FieldSnapshot {
     value: any;
     policies?: object[];
 }
+
 /**
  * Orchestrates the serialization and deserialization of Field instances.
  *
@@ -695,6 +695,7 @@ interface FieldsSnapshot {
     __type: string;
     [fieldName: string]: FieldSnapshot | string;
 }
+
 /**
  * Orchestrates the serialization and deserialization of `Fields` container instances.
  *
@@ -747,6 +748,7 @@ interface FieldTreeSnapshot {
     __type: string;
     [fieldName: string]: FieldsSnapshot | FieldTreeSnapshot | string;
 }
+
 /**
  * Orchestrates the recursive serialization and deserialization of `FieldTree` instances.
  *

package/dist/index.js

@@ -351,7 +351,7 @@ var CoreNumericField = class _CoreNumericField extends CoreField {
 
 // src/field-registry.ts
 var import_utils3 = require("@axi-engine/utils");
-var FieldRegistry = class extends import_utils3.ConstructorRegistry {
+var FieldRegistry = class extends import_utils3.Registry {
 };
 
 // src/fields.ts
@@ -425,7 +425,7 @@ var Fields = class _Fields {
    * @returns {T} The newly created `Field` instance.
    */
   create(typeName, name, initialValue, options) {
-    const Ctor = this._fieldRegistry.get(typeName);
+    const Ctor = this._fieldRegistry.getOrThrow(typeName);
     const field = new Ctor(name, initialValue, options);
     this.add(field);
     return field;
@@ -820,14 +820,9 @@ var ClampMinPolicySerializerHandler = class {
 // src/serializer/policy-serializer.ts
 var import_utils6 = require("@axi-engine/utils");
 var PolicySerializer = class {
-  handlers = /* @__PURE__ */ new Map();
+  handlers = new import_utils6.Registry();
   register(policyId, handler) {
-    (0, import_utils6.throwIf)(this.handlers.has(policyId), `A handler for policy ID '${policyId}' is already registered.`);
-    this.handlers.set(policyId, handler);
-    return this;
-  }
-  clearHandlers() {
-    this.handlers.clear();
+    this.handlers.register(policyId, handler);
   }
   /**
    * Creates a serializable snapshot of a policy instance.
@@ -837,8 +832,7 @@ var PolicySerializer = class {
    * @throws If no handler is registered for the policy's ID.
    */
   snapshot(policy) {
-    const handler = this.handlers.get(policy.id);
-    (0, import_utils6.throwIfEmpty)(handler, `No serializer handler registered for policy ID: '${policy.id}'`);
+    const handler = this.handlers.getOrThrow(policy.id);
     const data = handler.snapshot(policy);
     return {
       __type: policy.id,
@@ -854,8 +848,7 @@ var PolicySerializer = class {
   hydrate(snapshot) {
     const typeId = snapshot?.__type;
     (0, import_utils6.throwIfEmpty)(typeId, 'Invalid policy snapshot: missing "__type" identifier.');
-    const handler = this.handlers.get(typeId);
-    (0, import_utils6.throwIfEmpty)(handler, `No serializer handler registered for policy ID: '${typeId}'`);
+    const handler = this.handlers.getOrThrow(typeId);
     const { __type, ...data } = snapshot;
     return handler.hydrate(data);
   }
@@ -903,7 +896,7 @@ var FieldSerializer = class {
   hydrate(snapshot) {
     const fieldType = snapshot.__type;
     (0, import_utils7.throwIfEmpty)(fieldType, 'Invalid field snapshot: missing "__type" identifier.');
-    const Ctor = this.fieldRegistry.get(fieldType);
+    const Ctor = this.fieldRegistry.getOrThrow(fieldType);
     let policies;
     if (!(0, import_utils7.isNullOrUndefined)(snapshot.policies)) {
       policies = [];

package/dist/index.mjs

@@ -290,8 +290,8 @@ var CoreNumericField = class _CoreNumericField extends CoreField {
 };
 
 // src/field-registry.ts
-import { ConstructorRegistry } from "@axi-engine/utils";
-var FieldRegistry = class extends ConstructorRegistry {
+import { Registry } from "@axi-engine/utils";
+var FieldRegistry = class extends Registry {
 };
 
 // src/fields.ts
@@ -365,7 +365,7 @@ var Fields = class _Fields {
    * @returns {T} The newly created `Field` instance.
    */
   create(typeName, name, initialValue, options) {
-    const Ctor = this._fieldRegistry.get(typeName);
+    const Ctor = this._fieldRegistry.getOrThrow(typeName);
     const field = new Ctor(name, initialValue, options);
     this.add(field);
     return field;
@@ -758,16 +758,11 @@ var ClampMinPolicySerializerHandler = class {
 };
 
 // src/serializer/policy-serializer.ts
-import { throwIf as throwIf3, throwIfEmpty as throwIfEmpty2 } from "@axi-engine/utils";
+import { Registry as Registry2, throwIfEmpty as throwIfEmpty2 } from "@axi-engine/utils";
 var PolicySerializer = class {
-  handlers = /* @__PURE__ */ new Map();
+  handlers = new Registry2();
   register(policyId, handler) {
-    throwIf3(this.handlers.has(policyId), `A handler for policy ID '${policyId}' is already registered.`);
-    this.handlers.set(policyId, handler);
-    return this;
-  }
-  clearHandlers() {
-    this.handlers.clear();
+    this.handlers.register(policyId, handler);
   }
   /**
    * Creates a serializable snapshot of a policy instance.
@@ -777,8 +772,7 @@ var PolicySerializer = class {
    * @throws If no handler is registered for the policy's ID.
    */
   snapshot(policy) {
-    const handler = this.handlers.get(policy.id);
-    throwIfEmpty2(handler, `No serializer handler registered for policy ID: '${policy.id}'`);
+    const handler = this.handlers.getOrThrow(policy.id);
     const data = handler.snapshot(policy);
     return {
       __type: policy.id,
@@ -794,8 +788,7 @@ var PolicySerializer = class {
   hydrate(snapshot) {
     const typeId = snapshot?.__type;
     throwIfEmpty2(typeId, 'Invalid policy snapshot: missing "__type" identifier.');
-    const handler = this.handlers.get(typeId);
-    throwIfEmpty2(handler, `No serializer handler registered for policy ID: '${typeId}'`);
+    const handler = this.handlers.getOrThrow(typeId);
     const { __type, ...data } = snapshot;
     return handler.hydrate(data);
   }
@@ -843,7 +836,7 @@ var FieldSerializer = class {
   hydrate(snapshot) {
     const fieldType = snapshot.__type;
     throwIfEmpty3(fieldType, 'Invalid field snapshot: missing "__type" identifier.');
-    const Ctor = this.fieldRegistry.get(fieldType);
+    const Ctor = this.fieldRegistry.getOrThrow(fieldType);
     let policies;
     if (!isNullOrUndefined2(snapshot.policies)) {
       policies = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axi-engine/fields",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "A compact, reactive state management library based on a tree of observable fields.",
   "license": "MIT",
   "repository": {
@@ -36,9 +36,9 @@
     "dequal": "^2.0.3"
   },
   "devDependencies": {
-    "@axi-engine/utils": "^0.2.4"
+    "@axi-engine/utils": "^0.2.6"
   },
   "peerDependencies": {
-    "@axi-engine/utils": "^0.2.4"
+    "@axi-engine/utils": "^0.2.6"
   }
 }