@axi-engine/utils 0.2.1 → 0.2.2

package/dist/index.d.mts

@@ -205,6 +205,28 @@ declare class ConstructorRegistry<T> {
     clear(): void;
 }
 
+/**
+ * A read-only contract for any system that can provide data by path.
+ */
+interface DataSource {
+    get(path: PathType): unknown;
+    has(path: PathType): boolean;
+}
+/**
+ * A write-only contract for any system that can accept data by path.
+ */
+interface DataSink {
+    set(path: PathType, value: unknown): void;
+    create(path: PathType, value: unknown): void;
+    delete(path: PathType): void;
+}
+/**
+ * A full CRUD contract for systems that provide complete data management.
+ * Combines both reading and writing capabilities.
+ */
+interface DataStorage extends DataSource, DataSink {
+}
+
 /**
  * A minimal, type-safe event emitter for a single event.
  * It does not manage state, it only manages subscribers and event dispatching.
@@ -302,4 +324,4 @@ declare function randInt(min: number, max: number): number;
  */
 declare function randId(): string;
 
-export { type AxiEngineConfig, type Constructor, ConstructorRegistry, Emitter, type PathType, type ScalarType, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isNull, isNullOrUndefined, isNumber, isPercentageString, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwIf, throwIfEmpty, unique };
+export { type AxiEngineConfig, type Constructor, ConstructorRegistry, type DataSink, type DataSource, type DataStorage, Emitter, type PathType, type ScalarType, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isNull, isNullOrUndefined, isNumber, isPercentageString, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwIf, throwIfEmpty, unique };

package/dist/index.d.ts

@@ -205,6 +205,28 @@ declare class ConstructorRegistry<T> {
     clear(): void;
 }
 
+/**
+ * A read-only contract for any system that can provide data by path.
+ */
+interface DataSource {
+    get(path: PathType): unknown;
+    has(path: PathType): boolean;
+}
+/**
+ * A write-only contract for any system that can accept data by path.
+ */
+interface DataSink {
+    set(path: PathType, value: unknown): void;
+    create(path: PathType, value: unknown): void;
+    delete(path: PathType): void;
+}
+/**
+ * A full CRUD contract for systems that provide complete data management.
+ * Combines both reading and writing capabilities.
+ */
+interface DataStorage extends DataSource, DataSink {
+}
+
 /**
  * A minimal, type-safe event emitter for a single event.
  * It does not manage state, it only manages subscribers and event dispatching.
@@ -302,4 +324,4 @@ declare function randInt(min: number, max: number): number;
  */
 declare function randId(): string;
 
-export { type AxiEngineConfig, type Constructor, ConstructorRegistry, Emitter, type PathType, type ScalarType, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isNull, isNullOrUndefined, isNumber, isPercentageString, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwIf, throwIfEmpty, unique };
+export { type AxiEngineConfig, type Constructor, ConstructorRegistry, type DataSink, type DataSource, type DataStorage, Emitter, type PathType, type ScalarType, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isNull, isNullOrUndefined, isNumber, isPercentageString, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwIf, throwIfEmpty, unique };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axi-engine/utils",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Core utility library for Axi Engine, providing common functions for arrays, math, type guards, and more.",
   "license": "MIT",
   "repository": {