assign-gingerly 0.0.65 → 0.0.66

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

@@ -250,8 +250,21 @@ export type IEnhancementRegistryItem<T = any> = EnhancementConfig<T>;
 export interface IAssignGingerlyOptions {
   registry?: typeof EnhancementRegistry | EnhancementRegistry;
   bypassChecks?: boolean;
+  /**
+   * Method names to call during path evaluation (e.g., for `?.method()` calls)
+   */
   withMethods?: string[] | Set<string>;
+  /**
+   * Alias mappings for property and method names.
+   */
   aka?: Record<string, string>;
+
+  /**
+   * Shorthand for binding method aliases from the source object.
+   * Each entry maps an alias to a method name and is normalized into
+   * the existing withMethods + aka behavior.
+   */
+  akaMethods?: Record<string, string>;
   
   /**
    * AbortSignal for cleaning up reactive subscriptions (@eachTime)
@@ -838,3 +851,48 @@ export declare class LazyLoadHandler implements AssignFromHandler {
     assign(lhsTarget: any, resolvedParams: Record<string, any>, options?: any): Promise<void>;
     protected onCloneInserted(nodes: Node[], lhsTarget: Element, resolvedParams: Record<string, any>): Promise<void>;
 }
+
+//#region Event Handler
+
+export interface AssignDispatchVector {
+    toTarget?: Record<string, any>,
+    toHost?: Record<string, any>,
+    toLHS?: Record<string, any>,
+    withOptions?: AssignFromOptions,
+    toTargetOptions?: AssignFromOptions,
+    toHostOptions?: AssignFromOptions,
+    toLHSOptions?: AssignFromOptions,
+    dispatch?: DispatchEventConfig
+}
+
+export interface DispatchEventConfig{
+    type?: string,
+    eventCtr?: string | typeof Event | typeof CustomEvent,
+    detail?: any,
+    bubbles?: boolean,
+    cancelable?: boolean,
+    composed?: boolean
+}
+
+
+export interface AddEventListenerConfig extends AssignDispatchVector  {
+  on: string, 
+  get?: {
+      abortController?: string | AbortController,
+      
+      nudge?: boolean,
+      options?: AddEventListenerOptions,
+      //make this part of dispatch?
+      stopPropagation?: boolean,
+      preventDefault?: boolean
+      dispatch?: DispatchEventConfig
+   },
+   
+   fromLHS?: AssignDispatchVector,
+   fromHost?: AssignDispatchVector,
+   fromEvent?: AssignDispatchVector,
+   fromTarget?: AssignDispatchVector,
+   
+   
+}
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "assign-gingerly",
-  "version": "0.0.65",
+  "version": "0.0.66",
   "description": "This package provides a utility function for carefully merging one object into another.",
   "homepage": "https://github.com/bahrus/assign-gingerly#readme",
   "bugs": {
@@ -158,9 +158,9 @@
       "default": "./assignFromAsync-extension.js",
       "types": "./assignFromAsync-extension.ts"
     },
-    "./builtInEmoji.js": {
-      "default": "./builtInEmoji.js",
-      "types": "./builtInEmoji.ts"
+    "./emojis.js": {
+      "default": "./emojis.js",
+      "types": "./emojis.ts"
     },
     "./assignFeatures.js": {
       "default": "./assignFeatures.js",

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

@@ -745,11 +745,11 @@ export interface LazyLoadResolvedParams {
      *  Used for SSR placeholder content (e.g., "Loading..." text) that disappears once real content loads. */
     placeholder?: string;
     /** Assignment config applied to cloned content before insertion.
-     *  Same shape as manageTemplateList's fromEachItem: { assignToFragment, withOptions } or { configs: [...] } */
+     *  Same shape as manageTemplateList's fromEachItem: { toClone, withOptions } or { configs: [...] } */
     assign?: {
-        assignToFragment?: Record<string, any>;
+        toClone?: Record<string, any>;
         withOptions?: Record<string, any>;
-        configs?: Array<{ assignToFragment?: Record<string, any>; withOptions?: Record<string, any> }>;
+        configs?: Array<{ toClone?: Record<string, any>; withOptions?: Record<string, any> }>;
     };
 }
 
@@ -795,7 +795,7 @@ export interface LazyLoadSwitchResolvedParams extends Omit<LazyLoadResolvedParam
 }
 
 export interface FromEachItemConfig {
-    assignToFragment?: Record<string, any>;
+    toClone?: Record<string, any>;
     withOptions?: AssignFromOptions;
     resolve?: {
       key?: string;
@@ -854,28 +854,44 @@ export declare class LazyLoadHandler implements AssignFromHandler {
 
 //#region Event Handler
 
-export interface AssignVector {
-    assignToTarget?: Record<string, any>,
-    assignToSource?: Record<string, any>,
-    assignToLHS?: Record<string, any>,
+export interface AssignDispatchVector {
+    toTarget?: Record<string, any>,
+    toHost?: Record<string, any>,
+    toLHS?: Record<string, any>,
     withOptions?: AssignFromOptions,
-    withAssignToTargetOptions?: AssignFromOptions,
-    withAssignToSourceOptions?: AssignFromOptions,
-    withAssignToLHSOptions?: AssignFromOptions,
-}
-
-
-export interface AddEventListenerConfig extends AssignVector  {
-   get?: {
-     abortController?: string | AbortController,
-     on?: string,
-     nudge?: boolean,
-     options?: AddEventListenerOptions,
+    toTargetOptions?: AssignFromOptions,
+    toHostOptions?: AssignFromOptions,
+    toLHSOptions?: AssignFromOptions,
+    dispatch?: DispatchEventConfig
+}
+
+export interface DispatchEventConfig{
+    type?: string,
+    eventCtr?: string | typeof Event | typeof CustomEvent,
+    detail?: any,
+    bubbles?: boolean,
+    cancelable?: boolean,
+    composed?: boolean
+}
+
+
+export interface AddEventListenerConfig extends AssignDispatchVector  {
+  on: string, 
+  get?: {
+      abortController?: string | AbortController,
+      
+      nudge?: boolean,
+      options?: AddEventListenerOptions,
+      //make this part of dispatch?
+      stopPropagation?: boolean,
+      preventDefault?: boolean
+      dispatch?: DispatchEventConfig
    },
    
-   fromLHS?: AssignVector,
-   fromSource?: AssignVector,
-   fromEvent?: AssignVector,
+   fromLHS?: AssignDispatchVector,
+   fromHost?: AssignDispatchVector,
+   fromEvent?: AssignDispatchVector,
+   fromTarget?: AssignDispatchVector,
    
    
 }

package/builtInEmoji.js

@@ -1,26 +0,0 @@
-/**
- * builtInEmoji.js — Predefined emoji aliases for built-in handlers.
- * 
- * Import and spread into the `handlers` option for concise handler configs:
- * 
- * @example
- * import { builtInEmoji } from 'assign-gingerly/builtInEmoji.js';
- * 
- * assignFrom(target, {
- *     '?.el =>': { do: '🔗', get: { value: ['?.first', ' ', '?.last'] } }
- * }, { from: vm, handlers: builtInEmoji });
- */
-
-/**
- * Emoji → built-in handler name mapping.
- */
-export const builtInEmoji = {
-    '📦': 'builtIns.lazyLoad',
-    '🎚️': 'builtIns.lazyLoadSwitch',
-    '🔗': 'builtIns.join',
-    '🏷️': 'builtIns.microDataJoin',
-    '📋': 'builtIns.manageTemplateList',
-    '📊': 'builtIns.rangeSelector',
-};
-
-export default builtInEmoji;