assign-gingerly 0.0.84 → 0.0.86

package/DX/emojis.js

@@ -7,7 +7,7 @@
  * import { builtInEmoji } from 'assign-gingerly/builtInEmoji.js';
  *
  * assignFrom(target, {
- *     '?.el =>': { do: '🔗', get: { value: ['?.first', ' ', '?.last'] } }
+ *     '?.el =>': { do: '🏷️', get: { template: [...] } }
  * }, { from: vm, handlers: builtInEmoji });
  */
 /**
@@ -17,14 +17,16 @@
  * |-------|---------|
  * | 📦 | builtIns.lazyLoad |
  * | 🎚️ | builtIns.lazyLoadSwitch |
- * | 🔗 | builtIns.join |
  * | 🏷️ | builtIns.microDataJoin |
  * | 📋 | builtIns.manageTemplateList |
+ *
+ * `join` is no longer a `do:` handler — it moved to the synchronous ` =&` operator
+ * (see syncOps/join.ts) and isn't looked up through options.handlers, so it has no
+ * emoji alias here.
  */
 export const builtInEmoji = {
     '📦': 'builtIns.lazyLoad',
     '🎚️': 'builtIns.lazyLoadSwitch',
-    '🔗': 'builtIns.join',
     '🏷️': 'builtIns.microDataJoin',
     '📋': 'builtIns.manageTemplateList',
     '📊': 'builtIns.rangeSelector',

package/DX/emojis.ts

@@ -7,7 +7,7 @@
  * import { builtInEmoji } from 'assign-gingerly/builtInEmoji.js';
  * 
  * assignFrom(target, {
- *     '?.el =>': { do: '🔗', get: { value: ['?.first', ' ', '?.last'] } }
+ *     '?.el =>': { do: '🏷️', get: { template: [...] } }
  * }, { from: vm, handlers: builtInEmoji });
  */
 
@@ -18,14 +18,16 @@
  * |-------|---------|
  * | 📦 | builtIns.lazyLoad |
  * | 🎚️ | builtIns.lazyLoadSwitch |
- * | 🔗 | builtIns.join |
  * | 🏷️ | builtIns.microDataJoin |
  * | 📋 | builtIns.manageTemplateList |
+ *
+ * `join` is no longer a `do:` handler — it moved to the synchronous ` =&` operator
+ * (see syncOps/join.ts) and isn't looked up through options.handlers, so it has no
+ * emoji alias here.
  */
 export const builtInEmoji= {
     '📦': 'builtIns.lazyLoad',
     '🎚️': 'builtIns.lazyLoadSwitch',
-    '🔗': 'builtIns.join',
     '🏷️': 'builtIns.microDataJoin',
     '📋': 'builtIns.manageTemplateList',
     '📊': 'builtIns.rangeSelector',

package/DX/paths.js

@@ -15,7 +15,7 @@
  *
  * const $ = paths<Person>();
  *
- * // Use sp (split into parts) to create arrays for builtIns.join:
+ * // Use sp (split into parts) to create arrays for the ' =&' join op:
  * const value = sp`${$.lastName}, ${$.firstName}`;
  * // ['?.lastName', ', ', '?.firstName']
  *
@@ -321,7 +321,7 @@ export function forEachKeyIn(keys, factory, options) {
  * string representation — no `.Path` call needed inside sp template literals.
  *
  * Arrays passed as interpolations are preserved as nested arrays (for
- * all-or-nothing optional segments in builtIns.join).
+ * all-or-nothing optional segments in the ' =&' join op).
  *
  * @example
  * const $ = paths<Person>();

package/DX/paths.ts

@@ -15,12 +15,12 @@
  * 
  * const $ = paths<Person>();
  * 
- * // Use sp (split into parts) to create arrays for builtIns.join:
+ * // Use sp (split into parts) to create arrays for the ' =&' join op:
  * const value = sp`${$.lastName}, ${$.firstName}`;
  * // ['?.lastName', ', ', '?.firstName']
  * 
- * // Use .Path for raw string contexts (object keys, plain arrays):
- * const key = $.textContent.Path;  // '?.textContent'
+ * // Use .Path for raw string contexts (object keys, plain arrays):
+ * const key = $.textContent.Path;  // '?.textContent'
  */
 
 /**
@@ -102,25 +102,25 @@ export interface PathsOptions {
 /**
  * Create a proxy for id-ref paths (#[varName]).
  * After the initial #[varName], further property access chains with ?. from the resolved element.
- * .Path returns the #[varName] prefix (optionally with further ?. path).
+ * .Path returns the #[varName] prefix (optionally with further ?. path).
  */
 function createIdRefProxy(idRef: string, options?: PathsOptions): any {
     function handler() {}
     Object.defineProperty(handler, PATH_SYMBOL, { value: idRef });
     return new Proxy(handler, {
         get(_, prop: string | symbol) {
-            if (prop === 'Path' || prop === PATH_SYMBOL) {
-                return idRef;
-            }
+            if (prop === 'Path' || prop === PATH_SYMBOL) {
+                return idRef;
+            }
             if (typeof prop === 'symbol') return undefined;
 
             const reservedToken = getReservedToken(prop);
             if (reservedToken === 'Each') {
                 return createIdRefProxy(appendPathSegment(idRef, '@each'), options);
             }
-            if (reservedToken && reservedToken !== 'Path') {
-                return createIdRefProxy(appendCommandSuffix(idRef, reservedToken), options);
-            }
+            if (reservedToken && reservedToken !== 'Path') {
+                return createIdRefProxy(appendCommandSuffix(idRef, reservedToken), options);
+            }
 
             // Chain further path segments after the id ref
             const chained = appendPathSegment(idRef, String(prop));
@@ -162,16 +162,16 @@ function createPathProxy(prefix: string, options?: PathsOptions): any {
 
     return new Proxy(handler, {
         get(_, prop: string | symbol) {
-            if (prop === 'Path' || prop === PATH_SYMBOL) {
-                return serializePath(prefix);
-            }
+            if (prop === 'Path' || prop === PATH_SYMBOL) {
+                return serializePath(prefix);
+            }
             // Ignore symbol access (Symbol.iterator, Symbol.toPrimitive, etc.)
             if (typeof prop === 'symbol') return undefined;
 
             const reservedToken = getReservedToken(String(prop));
-            if (reservedToken === 'Path') {
-                return serializePath(prefix);
-            }
+            if (reservedToken === 'Path') {
+                return serializePath(prefix);
+            }
             if (reservedToken === 'Each') {
                 return createPathProxy(appendPathSegment(prefix, '@each'), options);
             }
@@ -231,14 +231,14 @@ function createPathProxy(prefix: string, options?: PathsOptions): any {
  * 
  * @example
  * const $ = paths<Person>();
- * $.lastName.Path          // '?.lastName'
- * $.address.city.Path      // '?.address?.city'
+ * $.lastName.Path          // '?.lastName'
+ * $.address.city.Path      // '?.address?.city'
  * 
  * // With aka (reverse alias applied):
  * const $ = paths<MyEl>({ aka: { q: 'querySelector' } });
- * $.querySelector('.user').textContent.Path  // '?.q?..user?.textContent'
+ * $.querySelector('.user').textContent.Path  // '?.q?..user?.textContent'
  * 
- * // Inside sp template literals, .Path is not needed:
+ * // Inside sp template literals, .Path is not needed:
  * sp`${$.lastName}, ${$.firstName}`  // ['?.lastName', ', ', '?.firstName']
  */
 export function paths<T>(options?: PathsOptions): PathProxy<T> {
@@ -246,7 +246,7 @@ export function paths<T>(options?: PathsOptions): PathProxy<T> {
 }
 
 /**
- * Create an assignment pair: { [lhs.Path]: rhs.Path }.
+ * Create an assignment pair: { [lhs.Path]: rhs.Path }.
  * Used to express "set this target to this source value" in a spreadable form.
  * 
  * @example
@@ -373,10 +373,10 @@ export function forEachKeyIn<T>(
  * Interleaves static string segments with interpolated values.
  * 
  * Path proxy objects are auto-detected and converted to their `?.`-prefixed
- * string representation — no `.Path` call needed inside sp template literals.
+ * string representation — no `.Path` call needed inside sp template literals.
  * 
  * Arrays passed as interpolations are preserved as nested arrays (for
- * all-or-nothing optional segments in builtIns.join).
+ * all-or-nothing optional segments in the ' =&' join op).
  * 
  * @example
  * const $ = paths<Person>();