assign-gingerly 0.0.63 → 0.0.64

package/assignTentatively.ts

@@ -1,9 +1,8 @@
 /**
- * Interface for assignTentatively options with reversal tracking
+ * assignTentatively — reversible assignment with change tracking.
  */
-export interface IAssignTentativelyOptions {
-  reversal?: Record<string | symbol, any>;
-}
+import type { IAssignTentativelyOptions } from './types/assign-gingerly/types.js';
+export type { IAssignTentativelyOptions };
 
 /**
  * Helper function to check if a string key represents an += command

package/object-extension.ts

@@ -1,5 +1,6 @@
 import assignGingerly, { EnhancementRegistry, ItemscopeRegistry, IAssignGingerlyOptions, getInstanceMap, INSTANCE_MAP_GUID } from './assignGingerly.js';
 import assignTentatively from './assignTentatively.js';
+import type { IAssignTentativelyOptions } from './types/assign-gingerly/types.js';
 import { EnhancementConfig, SpawnContext } from './types/assign-gingerly/types.js';
 import { parseWithAttrs } from './parseWithAttrs.js';
 
@@ -77,7 +78,7 @@ declare global {
      */
     assignTentatively(
       source: Record<string | symbol, any>,
-      options?: { reversal?: Record<string | symbol, any> }
+      options?: IAssignTentativelyOptions
     ): Record<string | symbol, any>;
   }
 }
@@ -576,10 +577,10 @@ Object.defineProperty(Object.prototype, 'assignTentatively', {
   value: function <T extends object>(
     this: T,
     source: Record<string | symbol, any>,
-    options?: { reversal?: Record<string | symbol, any> }
+    options?: IAssignTentativelyOptions
   ): Record<string | symbol, any> {
     const reversal = options?.reversal ?? {};
-    assignTentatively(this, source, { reversal });
+    assignTentatively(this, source, { ...options, reversal });
     return reversal;
   },
   writable: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assign-gingerly",
-  "version": "0.0.63",
+  "version": "0.0.64",
   "description": "This package provides a utility function for carefully merging one object into another.",
   "homepage": "https://github.com/bahrus/assign-gingerly#readme",
   "bugs": {

package/types/assign-gingerly/types.d.ts

@@ -261,6 +261,34 @@ export interface IAssignGingerlyOptions {
   signal?: AbortSignal;
 }
 
+/**
+ * Options for assignTentatively — reversible assignment with change tracking.
+ * 
+ * Supports a subset of assignGingerly's path features (nested paths, +=, =!, -=)
+ * with the addition of reversal tracking.
+ */
+export interface IAssignTentativelyOptions {
+  /**
+   * Object to accumulate reversal entries into.
+   * If omitted, a new object is created internally.
+   * Pass an existing object to accumulate reversals across multiple calls.
+   * 
+   * The reversal object can be passed to assignGingerly to undo all changes:
+   * @example
+   * const reversal = {};
+   * assignTentatively(obj, { name: 'Bob' }, { reversal });
+   * // Later:
+   * assignGingerly(obj, reversal); // restores name to original value
+   */
+  reversal?: Record<string | symbol, any>;
+
+  /**
+   * Alias mappings for property and method names.
+   * Same semantics as IAssignGingerlyOptions.aka — substituted before path evaluation.
+   */
+  aka?: Record<string, string>;
+}
+
 /**
  * Options for synchronous value resolution (getValues / getValue).
  * Extends IAssignGingerlyOptions with synchronous protocol handlers.