@axi-engine/fields 0.3.6 → 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 } 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.
  *
@@ -789,7 +791,7 @@ interface StoreCreateFieldOptions {
  * It acts as a facade, simplifying access to the underlying FieldTree and providing
  * both type-safe and dynamic methods for manipulating data.
  */
-interface Store {
+interface Store extends DataStorage {
     /**
      * Retrieves the raw value of a Field at a specific path.
      * @template T The expected type of the value.
@@ -955,8 +957,55 @@ declare class DataStore implements Store {
     remove(path: PathType): void;
     private isPathToRootFields;
     private getDestinationFields;
+    has(path: PathType): boolean;
+    /** implementation of the DataStore from utils */
+    get(path: PathType): unknown;
+    set(path: PathType, value: unknown): void;
+    create(path: PathType, value: unknown): void;
+    upset(path: PathType, value: unknown): void;
+    delete(path: PathType): void;
 }
 
+/**
+ * Type guard that checks if a value is an instance of the `Fields` class.
+ * It verifies this by checking the static `typeName` property on the instance.
+ *
+ * @param value The value to check.
+ * @returns {boolean} `true` if the value is a `Fields` instance, otherwise `false`.
+ */
+declare function isFields(value: unknown): value is Fields;
+/**
+ * Type guard that checks if a value is an instance of the `FieldTree` class.
+ * It verifies this by checking the static `typeName` property on the instance.
+ *
+ * @param value The value to check.
+ * @returns {boolean} `true` if the value is a `FieldTree` instance, otherwise `false`.
+ */
+declare function isFieldTree(value: unknown): value is FieldTree<any>;
+/**
+ * Type guard that checks if an unknown value conforms to the `Store` interface.
+ *
+ * It performs a structural check (duck typing) by verifying the presence of methods
+ * that are unique to the `Store` interface and are not part of the simpler `DataSource`
+ * or `DataStorage` contracts, such as `createFields` and `createTree`.
+ *
+ * @param value The `unknown` value to check.
+ * @returns {boolean} `true` if the value is a `Store`-like object, `false` otherwise.
+ *
+ * @example
+ * function processData(source: DataSource) {
+ *   if (isStore(source)) {
+ *     // Inside this block, TypeScript now knows `source` is a full `Store`.
+ *     // We can safely call Store-specific methods like `createFields`.
+ *     source.createFields('new.data.group');
+ *   } else {
+ *     // Fallback logic for simpler data sources that are not a `Store`.
+ *     console.warn('Cannot create new groups with a simple data source.');
+ *   }
+ * }
+ */
+declare function isStore(value: unknown): value is Store;
+
 /**
  * Creates and configures a FieldRegistry with all the core field types.
  * @returns {FieldRegistry} A pre-configured FieldRegistry instance.
@@ -994,4 +1043,4 @@ declare function createCoreFieldSystem(config?: CoreFieldSystemConfig): {
     serializer: FieldTreeSerializer<CoreFields>;
 };
 
-export { type BooleanField, ClampMaxPolicy, ClampMaxPolicySerializerHandler, ClampMinPolicy, ClampMinPolicySerializerHandler, ClampPolicy, ClampPolicySerializerHandler, CoreBooleanField, type CoreBooleanFieldOptions, CoreField, type CoreFieldSystemConfig, CoreFieldTree, CoreFields, CoreFieldsFactory, CoreNumericField, type CoreNumericFieldOptions, CoreStringField, type CoreStringFieldOptions, CoreTreeNodeFactory, DataStore, type Field, type FieldOptions, FieldRegistry, FieldSerializer, type FieldSnapshot, FieldTree, type FieldTreeFactory, FieldTreeSerializer, type FieldTreeSnapshot, Fields, type FieldsFactory, FieldsSerializer, type FieldsSnapshot, type NumericField, Policies, type Policy, PolicySerializer, type PolicySerializerHandler, type Store, type StoreCreateFieldOptions, type StringField, type TreeNode, clampMaxPolicy, clampMinPolicy, clampPolicy, createCoreFieldRegistry, createCoreFieldSystem, createCorePolicySerializer, createCoreTreeNodeFactory, createCoreTreeSerializer, createTypedMethodsMixin };
+export { type BooleanField, ClampMaxPolicy, ClampMaxPolicySerializerHandler, ClampMinPolicy, ClampMinPolicySerializerHandler, ClampPolicy, ClampPolicySerializerHandler, CoreBooleanField, type CoreBooleanFieldOptions, CoreField, type CoreFieldSystemConfig, CoreFieldTree, CoreFields, CoreFieldsFactory, CoreNumericField, type CoreNumericFieldOptions, CoreStringField, type CoreStringFieldOptions, CoreTreeNodeFactory, DataStore, type Field, type FieldOptions, FieldRegistry, FieldSerializer, type FieldSnapshot, FieldTree, type FieldTreeFactory, FieldTreeSerializer, type FieldTreeSnapshot, Fields, type FieldsFactory, FieldsSerializer, type FieldsSnapshot, type NumericField, Policies, type Policy, PolicySerializer, type PolicySerializerHandler, type Store, type StoreCreateFieldOptions, type StringField, type TreeNode, clampMaxPolicy, clampMinPolicy, clampPolicy, createCoreFieldRegistry, createCoreFieldSystem, createCorePolicySerializer, createCoreTreeNodeFactory, createCoreTreeSerializer, createTypedMethodsMixin, isFieldTree, isFields, isStore };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _axi_engine_utils from '@axi-engine/utils';
-import { Subscribable, ConstructorRegistry, Emitter, Constructor, PathType } 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.
  *
@@ -789,7 +791,7 @@ interface StoreCreateFieldOptions {
  * It acts as a facade, simplifying access to the underlying FieldTree and providing
  * both type-safe and dynamic methods for manipulating data.
  */
-interface Store {
+interface Store extends DataStorage {
     /**
      * Retrieves the raw value of a Field at a specific path.
      * @template T The expected type of the value.
@@ -955,8 +957,55 @@ declare class DataStore implements Store {
     remove(path: PathType): void;
     private isPathToRootFields;
     private getDestinationFields;
+    has(path: PathType): boolean;
+    /** implementation of the DataStore from utils */
+    get(path: PathType): unknown;
+    set(path: PathType, value: unknown): void;
+    create(path: PathType, value: unknown): void;
+    upset(path: PathType, value: unknown): void;
+    delete(path: PathType): void;
 }
 
+/**
+ * Type guard that checks if a value is an instance of the `Fields` class.
+ * It verifies this by checking the static `typeName` property on the instance.
+ *
+ * @param value The value to check.
+ * @returns {boolean} `true` if the value is a `Fields` instance, otherwise `false`.
+ */
+declare function isFields(value: unknown): value is Fields;
+/**
+ * Type guard that checks if a value is an instance of the `FieldTree` class.
+ * It verifies this by checking the static `typeName` property on the instance.
+ *
+ * @param value The value to check.
+ * @returns {boolean} `true` if the value is a `FieldTree` instance, otherwise `false`.
+ */
+declare function isFieldTree(value: unknown): value is FieldTree<any>;
+/**
+ * Type guard that checks if an unknown value conforms to the `Store` interface.
+ *
+ * It performs a structural check (duck typing) by verifying the presence of methods
+ * that are unique to the `Store` interface and are not part of the simpler `DataSource`
+ * or `DataStorage` contracts, such as `createFields` and `createTree`.
+ *
+ * @param value The `unknown` value to check.
+ * @returns {boolean} `true` if the value is a `Store`-like object, `false` otherwise.
+ *
+ * @example
+ * function processData(source: DataSource) {
+ *   if (isStore(source)) {
+ *     // Inside this block, TypeScript now knows `source` is a full `Store`.
+ *     // We can safely call Store-specific methods like `createFields`.
+ *     source.createFields('new.data.group');
+ *   } else {
+ *     // Fallback logic for simpler data sources that are not a `Store`.
+ *     console.warn('Cannot create new groups with a simple data source.');
+ *   }
+ * }
+ */
+declare function isStore(value: unknown): value is Store;
+
 /**
  * Creates and configures a FieldRegistry with all the core field types.
  * @returns {FieldRegistry} A pre-configured FieldRegistry instance.
@@ -994,4 +1043,4 @@ declare function createCoreFieldSystem(config?: CoreFieldSystemConfig): {
     serializer: FieldTreeSerializer<CoreFields>;
 };
 
-export { type BooleanField, ClampMaxPolicy, ClampMaxPolicySerializerHandler, ClampMinPolicy, ClampMinPolicySerializerHandler, ClampPolicy, ClampPolicySerializerHandler, CoreBooleanField, type CoreBooleanFieldOptions, CoreField, type CoreFieldSystemConfig, CoreFieldTree, CoreFields, CoreFieldsFactory, CoreNumericField, type CoreNumericFieldOptions, CoreStringField, type CoreStringFieldOptions, CoreTreeNodeFactory, DataStore, type Field, type FieldOptions, FieldRegistry, FieldSerializer, type FieldSnapshot, FieldTree, type FieldTreeFactory, FieldTreeSerializer, type FieldTreeSnapshot, Fields, type FieldsFactory, FieldsSerializer, type FieldsSnapshot, type NumericField, Policies, type Policy, PolicySerializer, type PolicySerializerHandler, type Store, type StoreCreateFieldOptions, type StringField, type TreeNode, clampMaxPolicy, clampMinPolicy, clampPolicy, createCoreFieldRegistry, createCoreFieldSystem, createCorePolicySerializer, createCoreTreeNodeFactory, createCoreTreeSerializer, createTypedMethodsMixin };
+export { type BooleanField, ClampMaxPolicy, ClampMaxPolicySerializerHandler, ClampMinPolicy, ClampMinPolicySerializerHandler, ClampPolicy, ClampPolicySerializerHandler, CoreBooleanField, type CoreBooleanFieldOptions, CoreField, type CoreFieldSystemConfig, CoreFieldTree, CoreFields, CoreFieldsFactory, CoreNumericField, type CoreNumericFieldOptions, CoreStringField, type CoreStringFieldOptions, CoreTreeNodeFactory, DataStore, type Field, type FieldOptions, FieldRegistry, FieldSerializer, type FieldSnapshot, FieldTree, type FieldTreeFactory, FieldTreeSerializer, type FieldTreeSnapshot, Fields, type FieldsFactory, FieldsSerializer, type FieldsSnapshot, type NumericField, Policies, type Policy, PolicySerializer, type PolicySerializerHandler, type Store, type StoreCreateFieldOptions, type StringField, type TreeNode, clampMaxPolicy, clampMinPolicy, clampPolicy, createCoreFieldRegistry, createCoreFieldSystem, createCorePolicySerializer, createCoreTreeNodeFactory, createCoreTreeSerializer, createTypedMethodsMixin, isFieldTree, isFields, isStore };

package/dist/index.js

@@ -51,7 +51,10 @@ __export(index_exports, {
   createCorePolicySerializer: () => createCorePolicySerializer,
   createCoreTreeNodeFactory: () => createCoreTreeNodeFactory,
   createCoreTreeSerializer: () => createCoreTreeSerializer,
-  createTypedMethodsMixin: () => createTypedMethodsMixin
+  createTypedMethodsMixin: () => createTypedMethodsMixin,
+  isFieldTree: () => isFieldTree,
+  isFields: () => isFields,
+  isStore: () => isStore
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -348,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
@@ -422,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;
@@ -817,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.
@@ -834,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,
@@ -851,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);
   }
@@ -900,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 = [];
@@ -1002,6 +998,9 @@ var FieldTreeSerializer = class {
   }
 };
 
+// src/data-store.ts
+var import_utils10 = require("@axi-engine/utils");
+
 // src/data-store-field-resolver.ts
 var import_utils9 = require("@axi-engine/utils");
 var NumericFieldResolver = class {
@@ -1024,7 +1023,6 @@ var StringFieldResolver = class {
 };
 
 // src/data-store.ts
-var import_utils10 = require("@axi-engine/utils");
 var DataStore = class {
   constructor(tree) {
     this.tree = tree;
@@ -1155,8 +1153,43 @@ var DataStore = class {
     const leafName = pathArr.pop();
     return { fields: this.tree.getOrCreateFields(path), leafName };
   }
+  has(path) {
+    const pathArr = (0, import_utils10.ensurePathArray)(path);
+    if (this.isPathToRootFields(pathArr)) {
+      return this.rootFields.has(pathArr[0]);
+    }
+    return this.tree.hasPath(pathArr);
+  }
+  /** implementation of the DataStore from utils */
+  get(path) {
+    return this.getField(path).value;
+  }
+  set(path, value) {
+    this.setValue(path, value);
+  }
+  create(path, value) {
+    this.createValue(path, value);
+  }
+  upset(path, value) {
+    this.upsetValue(path, value);
+  }
+  delete(path) {
+    this.remove(path);
+  }
 };
 
+// src/guards.ts
+var import_utils11 = require("@axi-engine/utils");
+function isFields(value) {
+  return value != null && value.typeName === Fields.typeName;
+}
+function isFieldTree(value) {
+  return value != null && value.typeName === FieldTree.typeName;
+}
+function isStore(value) {
+  return !(0, import_utils11.isNullOrUndefined)(value) && typeof value.createFields === "function" && typeof value.createTree === "function";
+}
+
 // src/setup.ts
 function createCoreFieldRegistry() {
   const fieldRegistry = new FieldRegistry();
@@ -1224,5 +1257,8 @@ function createCoreFieldSystem(config) {
   createCorePolicySerializer,
   createCoreTreeNodeFactory,
   createCoreTreeSerializer,
-  createTypedMethodsMixin
+  createTypedMethodsMixin,
+  isFieldTree,
+  isFields,
+  isStore
 });

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 = [];
@@ -945,6 +938,9 @@ var FieldTreeSerializer = class {
   }
 };
 
+// src/data-store.ts
+import { ensurePathArray as ensurePathArray2, ensurePathString as ensurePathString2, throwIfEmpty as throwIfEmpty4 } from "@axi-engine/utils";
+
 // src/data-store-field-resolver.ts
 import { isBoolean, isNumber, isString as isString2 } from "@axi-engine/utils";
 var NumericFieldResolver = class {
@@ -967,7 +963,6 @@ var StringFieldResolver = class {
 };
 
 // src/data-store.ts
-import { ensurePathArray as ensurePathArray2, ensurePathString as ensurePathString2, throwIfEmpty as throwIfEmpty4 } from "@axi-engine/utils";
 var DataStore = class {
   constructor(tree) {
     this.tree = tree;
@@ -1098,8 +1093,43 @@ var DataStore = class {
     const leafName = pathArr.pop();
     return { fields: this.tree.getOrCreateFields(path), leafName };
   }
+  has(path) {
+    const pathArr = ensurePathArray2(path);
+    if (this.isPathToRootFields(pathArr)) {
+      return this.rootFields.has(pathArr[0]);
+    }
+    return this.tree.hasPath(pathArr);
+  }
+  /** implementation of the DataStore from utils */
+  get(path) {
+    return this.getField(path).value;
+  }
+  set(path, value) {
+    this.setValue(path, value);
+  }
+  create(path, value) {
+    this.createValue(path, value);
+  }
+  upset(path, value) {
+    this.upsetValue(path, value);
+  }
+  delete(path) {
+    this.remove(path);
+  }
 };
 
+// src/guards.ts
+import { isNullOrUndefined as isNullOrUndefined3 } from "@axi-engine/utils";
+function isFields(value) {
+  return value != null && value.typeName === Fields.typeName;
+}
+function isFieldTree(value) {
+  return value != null && value.typeName === FieldTree.typeName;
+}
+function isStore(value) {
+  return !isNullOrUndefined3(value) && typeof value.createFields === "function" && typeof value.createTree === "function";
+}
+
 // src/setup.ts
 function createCoreFieldRegistry() {
   const fieldRegistry = new FieldRegistry();
@@ -1166,5 +1196,8 @@ export {
   createCorePolicySerializer,
   createCoreTreeNodeFactory,
   createCoreTreeSerializer,
-  createTypedMethodsMixin
+  createTypedMethodsMixin,
+  isFieldTree,
+  isFields,
+  isStore
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axi-engine/fields",
-  "version": "0.3.6",
+  "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.0"
+    "@axi-engine/utils": "^0.2.6"
   },
   "peerDependencies": {
-    "@axi-engine/utils": "^0.2.0"
+    "@axi-engine/utils": "^0.2.6"
   }
 }