@axi-engine/fields 0.3.6 → 0.3.7

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, ConstructorRegistry, Emitter, Constructor, PathType, DataStorage } from '@axi-engine/utils';
 
 interface Policy<T> {
     readonly id: string;
@@ -789,7 +789,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 +955,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 +1041,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, ConstructorRegistry, Emitter, Constructor, PathType, DataStorage } from '@axi-engine/utils';
 
 interface Policy<T> {
     readonly id: string;
@@ -789,7 +789,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 +955,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 +1041,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);
 
@@ -1002,6 +1005,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 +1030,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 +1160,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 +1264,8 @@ function createCoreFieldSystem(config) {
   createCorePolicySerializer,
   createCoreTreeNodeFactory,
   createCoreTreeSerializer,
-  createTypedMethodsMixin
+  createTypedMethodsMixin,
+  isFieldTree,
+  isFields,
+  isStore
 });

package/dist/index.mjs

@@ -945,6 +945,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 +970,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 +1100,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 +1203,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.7",
   "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.4"
   },
   "peerDependencies": {
-    "@axi-engine/utils": "^0.2.0"
+    "@axi-engine/utils": "^0.2.4"
   }
 }