assign-gingerly 0.0.34 → 0.0.35

package/README.md

@@ -3303,6 +3303,28 @@ console.log(result);
 
 -->
 
+## Resolving and Assigning with `assignFrom`
+
+The `assignFrom` function combines RHS path resolution with `assignGingerly` in a single call. It resolves `?.`-prefixed RHS values against a source object, then assigns the results into a target. Use `?.` alone as a RHS value to reference the entire source object itself.
+
+```TypeScript
+import { assignFrom } from 'assign-gingerly/assignFrom.js';
+
+const viewModel = { username: 'Alice', clone: someDocumentFragment };
+
+assignFrom(target, {
+  '?.appendChild': '?..clone',                              // source.clone
+  '?.clone?.q?..username?.textContent': '?.username',       // source.username
+  ref: '?.'                                                  // the source object itself
+}, {
+  from: viewModel,
+  withMethods: ['appendChild'],
+  aka: { 'q': 'querySelector' }
+});
+```
+
+For full documentation, see [docs/assignFrom.md](docs/assignFrom.md).
+
 ## Itemscope Managers (Chrome 146+)
 
 Itemscope Managers provide a way to manage DOM fragments and their associated data/view models for elements with the `itemscope` attribute. This feature enables frameworks and libraries to manage light children of web components, DOM fragments from looping constructs, and scenarios where custom element wrapping is not feasible.

package/package.json

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

package/resolveValues.js

@@ -26,8 +26,10 @@ export function resolveValues(pattern, source) {
     const result = {};
     for (const [key, value] of Object.entries(pattern)) {
         if (typeof value === 'string' && value.startsWith('?.')) {
-            // Parse path: split by '.', strip '?', filter empties
-            const parts = value.split('.').map(p => p.replace(/\?/g, '')).filter(p => p.length > 0);
+            // Parse path: split on '?.' delimiter, filter empties
+            // Use '?.' as the sole delimiter to preserve dots in values (e.g., CSS selectors)
+            // Special case: '?.' alone (empty path) resolves to the source object itself
+            const parts = value.split('?.').filter(p => p.length > 0);
             let current = source;
             for (const part of parts) {
                 if (current == null)

package/resolveValues.ts

@@ -29,8 +29,10 @@ export function resolveValues(
   const result: Record<string, any> = {};
   for (const [key, value] of Object.entries(pattern)) {
     if (typeof value === 'string' && value.startsWith('?.')) {
-      // Parse path: split by '.', strip '?', filter empties
-      const parts = value.split('.').map(p => p.replace(/\?/g, '')).filter(p => p.length > 0);
+      // Parse path: split on '?.' delimiter, filter empties
+      // Use '?.' as the sole delimiter to preserve dots in values (e.g., CSS selectors)
+      // Special case: '?.' alone (empty path) resolves to the source object itself
+      const parts = value.split('?.').filter(p => p.length > 0);
       let current = source;
       for (const part of parts) {
         if (current == null) break;