@axi-engine/utils 0.2.7 → 0.2.8

package/dist/index.d.mts

@@ -263,6 +263,21 @@ declare class Emitter<T extends any[]> implements Subscribable<T> {
      */
     clear(): void;
 }
+/**
+ * An Emitter that stores the last emitted value.
+ * New subscribers immediately receive the last value upon subscription.
+ */
+declare class StateEmitter<T extends any[]> extends Emitter<T> {
+    private _lastValue;
+    constructor(initialValue?: T);
+    /**
+     * Gets the current value synchronously without subscribing.
+     */
+    get value(): T | undefined;
+    emit(...args: T): void;
+    subscribe(listener: (...args: T) => void): () => void;
+    clear(): void;
+}
 
 /**
  * Type guard that checks if a value is a valid ScalarType.
@@ -424,4 +439,4 @@ declare class Registry<K extends PropertyKey, V> {
     clear(): void;
 }
 
-export { type AxiEngineConfig, type Constructor, type DataSink, type DataSource, type DataStorage, Emitter, type PathType, Registry, type ScalarType, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isPercentageString, isPromise, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwError, throwIf, throwIfEmpty, unique };
+export { type AxiEngineConfig, type Constructor, type DataSink, type DataSource, type DataStorage, Emitter, type PathType, Registry, type ScalarType, StateEmitter, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isPercentageString, isPromise, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwError, throwIf, throwIfEmpty, unique };

package/dist/index.d.ts

@@ -263,6 +263,21 @@ declare class Emitter<T extends any[]> implements Subscribable<T> {
      */
     clear(): void;
 }
+/**
+ * An Emitter that stores the last emitted value.
+ * New subscribers immediately receive the last value upon subscription.
+ */
+declare class StateEmitter<T extends any[]> extends Emitter<T> {
+    private _lastValue;
+    constructor(initialValue?: T);
+    /**
+     * Gets the current value synchronously without subscribing.
+     */
+    get value(): T | undefined;
+    emit(...args: T): void;
+    subscribe(listener: (...args: T) => void): () => void;
+    clear(): void;
+}
 
 /**
  * Type guard that checks if a value is a valid ScalarType.
@@ -424,4 +439,4 @@ declare class Registry<K extends PropertyKey, V> {
     clear(): void;
 }
 
-export { type AxiEngineConfig, type Constructor, type DataSink, type DataSource, type DataStorage, Emitter, type PathType, Registry, type ScalarType, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isPercentageString, isPromise, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwError, throwIf, throwIfEmpty, unique };
+export { type AxiEngineConfig, type Constructor, type DataSink, type DataSource, type DataStorage, Emitter, type PathType, Registry, type ScalarType, StateEmitter, type Subscribable, areArraysEqual, axiSettings, clampNumber, configure, ensurePathArray, ensurePathString, firstKeyOf, genArray, getPercentOf, getRandomElement, haveSameElements, isBoolean, isFunction, isNull, isNullOrUndefined, isNumber, isObject, isPercentageString, isPromise, isScalar, isSequentialStart, isString, isUndefined, last, randId, randInt, shuffleArray, throwError, throwIf, throwIfEmpty, unique };

package/dist/index.js

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   Emitter: () => Emitter,
   Registry: () => Registry,
+  StateEmitter: () => StateEmitter,
   areArraysEqual: () => areArraysEqual,
   axiSettings: () => axiSettings,
   clampNumber: () => clampNumber,
@@ -200,6 +201,34 @@ var Emitter = class {
     this.listeners.clear();
   }
 };
+var StateEmitter = class extends Emitter {
+  _lastValue;
+  constructor(initialValue) {
+    super();
+    this._lastValue = initialValue ?? void 0;
+  }
+  /**
+   * Gets the current value synchronously without subscribing.
+   */
+  get value() {
+    return this._lastValue;
+  }
+  emit(...args) {
+    this._lastValue = args;
+    super.emit(...args);
+  }
+  subscribe(listener) {
+    const unsubscribe = super.subscribe(listener);
+    if (!isUndefined(this._lastValue)) {
+      listener(...this._lastValue);
+    }
+    return unsubscribe;
+  }
+  clear() {
+    super.clear();
+    this._lastValue = void 0;
+  }
+};
 
 // src/math.ts
 function clampNumber(val, min, max) {
@@ -288,6 +317,7 @@ var Registry = class {
 0 && (module.exports = {
   Emitter,
   Registry,
+  StateEmitter,
   areArraysEqual,
   axiSettings,
   clampNumber,

package/dist/index.mjs

@@ -142,6 +142,34 @@ var Emitter = class {
     this.listeners.clear();
   }
 };
+var StateEmitter = class extends Emitter {
+  _lastValue;
+  constructor(initialValue) {
+    super();
+    this._lastValue = initialValue ?? void 0;
+  }
+  /**
+   * Gets the current value synchronously without subscribing.
+   */
+  get value() {
+    return this._lastValue;
+  }
+  emit(...args) {
+    this._lastValue = args;
+    super.emit(...args);
+  }
+  subscribe(listener) {
+    const unsubscribe = super.subscribe(listener);
+    if (!isUndefined(this._lastValue)) {
+      listener(...this._lastValue);
+    }
+    return unsubscribe;
+  }
+  clear() {
+    super.clear();
+    this._lastValue = void 0;
+  }
+};
 
 // src/math.ts
 function clampNumber(val, min, max) {
@@ -229,6 +257,7 @@ var Registry = class {
 export {
   Emitter,
   Registry,
+  StateEmitter,
   areArraysEqual,
   axiSettings,
   clampNumber,

package/package.json

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