@adbl/cells 0.0.2 → 0.0.3

package/index.js

@@ -1,3 +1,3 @@
-/// <reference types="./types/index.d.ts" />
+// <reference types="./types/index.d.ts" />
 
 export * from './library/index.js';

package/library/classes.js

@@ -686,6 +686,9 @@ export class SourceCell extends Cell {
   /** @type {Partial<CellOptions<T>>} */
   options;
 
+  /** @type {object | undefined} */
+  #originalObject;
+
   /**
    * Creates a new Cell with the provided value.
    * @param {T} value
@@ -696,6 +699,32 @@ export class SourceCell extends Cell {
 
     this.setValue(options?.shallowProxied ? value : this.proxy(value));
     this.options = options ?? {};
+
+    if (typeof value === 'object' && value !== null) {
+      this.#originalObject = value;
+    }
+  }
+
+  /**
+   * For cells containing objects, returns the object itself.
+   * This can be useful in scenarios where unfettered access to the original object is needed,
+   * such as when using the object as a cache.
+   *
+   * @example
+   * const cell = new SourceCell({ a: 1, b: 2 });
+   * console.log(cell.originalObject); // { a: 1, b: 2 }
+   *
+   * cell.value = { a: 3, b: 4 };
+   * console.log(cell.originalObject); // { a: 3, b: 4 }
+   *
+   * @returns {T extends object ? T : never} The original object if T is an object, otherwise never.
+   */
+  deproxy() {
+    const originalObject = this.#originalObject;
+    if (typeof originalObject === 'object' && originalObject !== null) {
+      return /** @type {T extends object ? T : never} */ (originalObject);
+    }
+    throw new Error('Cannot deproxy a non-object cell.');
   }
 
   get value() {
@@ -731,6 +760,9 @@ export class SourceCell extends Cell {
     }
 
     this.setValue(this.options?.shallowProxied ? value : this.proxy(value));
+    if (typeof value === 'object' && value !== null) {
+      this.#originalObject = value;
+    }
     this.update();
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adbl/cells",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "A simple implementation of reactive updates for JavaScript",
   "main": "index.js",
   "private": false,

package/types/library/classes.d.ts

@@ -264,6 +264,21 @@ export class SourceCell<T> extends Cell<T> {
     constructor(value: T, options?: Partial<CellOptions<T>> | undefined);
     /** @type {Partial<CellOptions<T>>} */
     options: Partial<CellOptions<T>>;
+    /**
+     * For cells containing objects, returns the object itself.
+     * This can be useful in scenarios where unfettered access to the original object is needed,
+     * such as when using the object as a cache.
+     *
+     * @example
+     * const cell = new SourceCell({ a: 1, b: 2 });
+     * console.log(cell.originalObject); // { a: 1, b: 2 }
+     *
+     * cell.value = { a: 3, b: 4 };
+     * console.log(cell.originalObject); // { a: 3, b: 4 }
+     *
+     * @returns {T extends object ? T : never} The original object if T is an object, otherwise never.
+     */
+    deproxy(): T extends object ? T : never;
     /**
      * Sets the value stored in the Cell and triggers an update.
      * @param {T} value
@@ -278,6 +293,7 @@ export class SourceCell<T> extends Cell<T> {
      * @private
      */
     private proxy;
+    #private;
 }
 export type AsyncRequestAtoms<Input, Output> = {
     /**