@walkeros/web-source-browser 3.1.1 → 3.2.0

package/dist/index.d.mts

@@ -130,13 +130,18 @@ declare namespace step {
 /**
  * Browser source createTrigger.
  *
- * Injects HTML into the DOM, lazily starts the flow, then dispatches
- * native browser events. Mirrors real-world behavior: HTML exists on
- * the page, walker.js loads, source scans DOM and sets up listeners.
+ * Injects HTML into the DOM, lazily starts the flow, then calls
+ * handleTrigger directly — the same convergence point as production.
+ * For load triggers, the source's DOM scan during startFlow handles
+ * event capture automatically.
  *
  * @example
  * const { trigger } = await createTrigger(config);
- * await trigger('click', 'button')('<button data-elb="cta">Click</button>');
+ * await trigger('click', 'button')('<button data-elb="cta" data-elbaction="click:cta click">Click</button>');
+ *
+ * @example
+ * // Impression trigger — handleTrigger reads data-elbaction directly
+ * await trigger('impression', '[data-elb="promo"]')('<div data-elb="promo" data-elbaction="visible:promo seen">Ad</div>');
  */
 declare const createTrigger: Trigger$1.CreateFn<string, void>;
 /**
@@ -155,7 +160,7 @@ declare namespace index {
 
 declare function getElbAttributeName(prefix: string, name?: string, isProperty?: boolean): string;
 declare function getElbValues(prefix: string, element: Element, name: string, isProperty?: boolean): WalkerOS.Properties;
-declare function getAllEvents(scope?: Scope, prefix?: string): Walker.Events;
+declare function getAllEvents(scope: Scope, prefix?: string): Walker.Events;
 declare function getEvents(target: Element, trigger: string, prefix?: string): Walker.Events;
 declare function getGlobals(prefix?: string, scope?: Scope): WalkerOS.Properties;
 

package/dist/index.d.ts

@@ -130,13 +130,18 @@ declare namespace step {
 /**
  * Browser source createTrigger.
  *
- * Injects HTML into the DOM, lazily starts the flow, then dispatches
- * native browser events. Mirrors real-world behavior: HTML exists on
- * the page, walker.js loads, source scans DOM and sets up listeners.
+ * Injects HTML into the DOM, lazily starts the flow, then calls
+ * handleTrigger directly — the same convergence point as production.
+ * For load triggers, the source's DOM scan during startFlow handles
+ * event capture automatically.
  *
  * @example
  * const { trigger } = await createTrigger(config);
- * await trigger('click', 'button')('<button data-elb="cta">Click</button>');
+ * await trigger('click', 'button')('<button data-elb="cta" data-elbaction="click:cta click">Click</button>');
+ *
+ * @example
+ * // Impression trigger — handleTrigger reads data-elbaction directly
+ * await trigger('impression', '[data-elb="promo"]')('<div data-elb="promo" data-elbaction="visible:promo seen">Ad</div>');
  */
 declare const createTrigger: Trigger$1.CreateFn<string, void>;
 /**
@@ -155,7 +160,7 @@ declare namespace index {
 
 declare function getElbAttributeName(prefix: string, name?: string, isProperty?: boolean): string;
 declare function getElbValues(prefix: string, element: Element, name: string, isProperty?: boolean): WalkerOS.Properties;
-declare function getAllEvents(scope?: Scope, prefix?: string): Walker.Events;
+declare function getAllEvents(scope: Scope, prefix?: string): Walker.Events;
 declare function getEvents(target: Element, trigger: string, prefix?: string): Walker.Events;
 declare function getGlobals(prefix?: string, scope?: Scope): WalkerOS.Properties;