assign-gingerly 0.0.24 → 0.0.25

package/README.md

@@ -108,10 +108,40 @@ console.log(obj);
 // }
 ```
 
-When the right hand side of an expression is an object, assignGingerly is recursively applied (passing the third argument in if applicable, which will be discussed below).
+When the right hand side of an expression is an object, assignGingerly behavior depends on the context:
+- For **nested paths** (starting with `?.`): recursively merges into nested objects, creating them if needed
+- For **plain keys**: performs simple assignment (like `Object.assign`), unless the target property is readonly or a class instance (see Examples 3a and 3b below)
 
 Of course, just as Object.assign led to object spread notation, assignGingerly could lead to some sort of deep structural JavaScript syntax, but that is outside the scope of this polyfill package.
 
+## Example 3-plain - Plain Key Object Assignment
+
+For plain keys (without `?.` prefix), assignGingerly performs simple assignment, just like `Object.assign`:
+
+```TypeScript
+const obj = {};
+const template = document.createElement('template');
+template.innerHTML = '<div>Hello</div>';
+
+assignGingerly(obj, {
+    template: template,
+    config: { theme: 'dark', lang: 'en' }
+});
+
+console.log(obj.template === template); // true - direct assignment
+console.log(obj.config); // { theme: 'dark', lang: 'en' } - direct assignment
+```
+
+This is different from nested paths, which create intermediate objects:
+
+```TypeScript
+const obj = {};
+assignGingerly(obj, {
+    '?.config?.theme': 'dark'
+});
+console.log(obj.config); // { theme: 'dark' } - intermediate object created
+```
+
 ## Example 3a - Automatic Readonly Property Detection
 
 assignGingerly automatically detects readonly properties and merges into them instead of attempting to replace them. This makes working with DOM properties like `style` and `dataset` much more ergonomic:

package/assignGingerly.js

@@ -475,11 +475,8 @@ export function assignGingerly(target, source, options) {
                     assignGingerly(currentValue, value, options);
                 }
                 else {
-                    // Property is writable and not a class instance - normal recursive merge
-                    if (!(key in target) || typeof target[key] !== 'object') {
-                        target[key] = {};
-                    }
-                    assignGingerly(target[key], value, options);
+                    // Property is writable and not a class instance - simple assignment
+                    target[key] = value;
                 }
             }
             else {

package/assignGingerly.ts

@@ -29,22 +29,6 @@ export interface ItemscopeManagerConfig<T = any> {
   };
 }
 
-// Polyfill for WeakMap.prototype.getOrInsert
-
-// if (typeof WeakMap.prototype.getOrInsertComputed !== 'function') {
-//   WeakMap.prototype.getOrInsertComputed = function(key, insert) {
-//     if (this.has(key)) return this.get(key);
-//     const value = insert();
-//     this.set(key, value);
-//     return value;
-//   };
-// }
-
-// /**
-//  * @deprecated Use EnhancementConfig instead
-//  */
-// export type IBaseRegistryItem<T = any> = EnhancementConfig<T>;
-
 /**
  * Interface for the options passed to assignGingerly
  */
@@ -575,11 +559,8 @@ export function assignGingerly(
           // Recursively apply assignGingerly to the readonly object or class instance
           assignGingerly(currentValue, value, options);
         } else {
-          // Property is writable and not a class instance - normal recursive merge
-          if (!(key in target) || typeof target[key] !== 'object') {
-            target[key] = {};
-          }
-          assignGingerly(target[key], value, options);
+          // Property is writable and not a class instance - simple assignment
+          target[key] = value;
         }
       } else {
         target[key] = value;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assign-gingerly",
-  "version": "0.0.24",
+  "version": "0.0.25",
   "description": "This package provides a utility function for carefully merging one object into another.",
   "homepage": "https://github.com/bahrus/assign-gingerly#readme",
   "bugs": {
@@ -63,9 +63,9 @@
     "chrome": "npx playwright cr http://localhost:8000"
   },
   "devDependencies": {
-    "@playwright/test": "1.59.0-alpha-2026-02-28",
+    "@playwright/test": "1.59.1",
     "spa-ssi": "0.0.27",
-    "@types/node": "25.5.0",
+    "@types/node": "25.5.2",
     "typescript": "6.0.2"
   }
 }

package/playwright.config.ts

@@ -34,15 +34,15 @@ export default defineConfig({
       use: { ...devices['Desktop Chrome'] },
     },
 
-    // {
-    //   name: 'firefox',
-    //   use: { ...devices['Desktop Firefox'] },
-    // },
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
 
-    // {
-    //   name: 'webkit',
-    //   use: { ...devices['Desktop Safari'] },
-    // },
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
   ],
 
   /* Run your local dev server before starting the tests */