@magicx-eng/ai-autocomplete-vanilla 0.49.3 → 0.49.5

package/dist/index.d.mts

@@ -165,6 +165,12 @@ interface AutocompleteResponse {
          * server rather than waiting on the local filter. Absent means off.
          */
         traditional_autocomplete?: boolean;
+        /**
+         * Set when an `impression` should be sent only while the dropdown is
+         * visible: when it opens, and for each response that changes what it
+         * shows. Absent means one for every response that changes it.
+         */
+        visible_impression?: boolean;
         /** The request's `schema_version`, echoed back. */
         schema_version?: string;
     };
@@ -1211,6 +1217,9 @@ declare class AIAutocomplete {
     private heldIdentified;
     /** What the last `impression` showed, so an identical response doesn't resend it. */
     private lastImpressionKey;
+    /** The server's `visible_impression`: send an impression only while the dropdown is visible. */
+    private visibleImpression;
+    private destroyed;
     private readonly emitSubmit;
     private readonly emitError;
     constructor(container: HTMLElement, opts?: CoreOptions);
@@ -1432,9 +1441,18 @@ declare class AIAutocomplete {
     private startSelectionAnimationTimer;
     private resolveVisitorId;
     private resolveSource;
+    /**
+     * With `visible_impression`, the dropdown opening is itself an impression of
+     * what it shows, and closing it lets the next showing count again. The send
+     * waits a microtask: a response that opens the dropdown sets its request id
+     * only after its store write, and its own impression goes out first (the
+     * deferred one then matches it and is dropped).
+     */
+    private subscribeVisibleImpression;
     /**
      * Records what a response put on screen: pills and their options in display
-     * order, and the product cards. Positions are 1-based array order.
+     * order, and the product cards. Positions are 1-based array order. With
+     * `visible_impression`, only while the dropdown is visible.
      */
     private fireImpression;
     private fireTelemetry;

package/dist/index.d.ts

@@ -165,6 +165,12 @@ interface AutocompleteResponse {
          * server rather than waiting on the local filter. Absent means off.
          */
         traditional_autocomplete?: boolean;
+        /**
+         * Set when an `impression` should be sent only while the dropdown is
+         * visible: when it opens, and for each response that changes what it
+         * shows. Absent means one for every response that changes it.
+         */
+        visible_impression?: boolean;
         /** The request's `schema_version`, echoed back. */
         schema_version?: string;
     };
@@ -1211,6 +1217,9 @@ declare class AIAutocomplete {
     private heldIdentified;
     /** What the last `impression` showed, so an identical response doesn't resend it. */
     private lastImpressionKey;
+    /** The server's `visible_impression`: send an impression only while the dropdown is visible. */
+    private visibleImpression;
+    private destroyed;
     private readonly emitSubmit;
     private readonly emitError;
     constructor(container: HTMLElement, opts?: CoreOptions);
@@ -1432,9 +1441,18 @@ declare class AIAutocomplete {
     private startSelectionAnimationTimer;
     private resolveVisitorId;
     private resolveSource;
+    /**
+     * With `visible_impression`, the dropdown opening is itself an impression of
+     * what it shows, and closing it lets the next showing count again. The send
+     * waits a microtask: a response that opens the dropdown sets its request id
+     * only after its store write, and its own impression goes out first (the
+     * deferred one then matches it and is dropped).
+     */
+    private subscribeVisibleImpression;
     /**
      * Records what a response put on screen: pills and their options in display
-     * order, and the product cards. Positions are 1-based array order.
+     * order, and the product cards. Positions are 1-based array order. With
+     * `visible_impression`, only while the dropdown is visible.
      */
     private fireImpression;
     private fireTelemetry;