@magicx-eng/ai-autocomplete-vanilla 0.26.0 → 0.26.2

package/dist/index.d.mts

@@ -7,6 +7,16 @@ interface CompletedParam {
 }
 interface SuggestionOption {
     text: string;
+    /**
+     * The option's real, matchable value — present when the option has a
+     * separate matchable value from its display `text` (e.g. a hierarchical
+     * option's `text` is its last path segment, "Probiotics", while `value` is
+     * the full path `text` was shortened from). Sent to the server on tap
+     * instead of `text` (see `toWireParam`), so grounding still matches the
+     * full, collision-safe value while the row shows a short label. Falls
+     * back to `text` when absent.
+     */
+    value?: string;
     /**
      * The icon's name — an identifier such as `"apple"`, exposed on the row as
      * `data-aia-icon` when its `icon_svg` draws. Never rendered as text: a row
@@ -65,6 +75,7 @@ interface AutocompleteRequest {
         language: string;
         client_version: string;
         session_id: string;
+        source?: "full-sdk" | "headless-sdk";
     };
 }
 interface AutocompleteResponse {
@@ -170,6 +181,8 @@ interface CustomFieldsReport {
 interface CompletedParamState extends CompletedParam {
     id: string;
     text: string;
+    /** The originating option's `value` (see {@link SuggestionOption.value}), carried over so `toWireParam` can send it instead of the shortened `text`. */
+    value?: string;
     /** Source suggestion's `type` — used by re-edit mode to render the dropdown pill. */
     suggestionType: string;
     /** Source suggestion's `text` — used by re-edit mode to render the dropdown pill. */
@@ -832,9 +845,10 @@ interface CoreOptions {
      */
     styleRoot?: Document | ShadowRoot;
     /**
-     * Identifies which SDK surface is in use, for telemetry only. The hook can't
-     * distinguish on its own — the Tier 1 component sets "full-sdk" when wiring
-     * it up. Default: "headless-sdk".
+     * Identifies which SDK surface is in use — sent as meta.source on both
+     * /api/suggest and telemetry events. The hook can't distinguish on its own
+     * — the Tier 1 component sets "full-sdk" when wiring it up. Default:
+     * "headless-sdk".
      * @internal
      */
     source?: "full-sdk" | "headless-sdk";
@@ -1134,6 +1148,7 @@ declare class AIAutocomplete {
     update(opts: CoreUpdateOptions): void;
     selectOption(option: SuggestionOption): void;
     private startSelectionAnimationTimer;
+    private resolveSource;
     private fireTelemetry;
     private setupContainer;
     private buildAndRenderFull;

package/dist/index.d.ts

@@ -7,6 +7,16 @@ interface CompletedParam {
 }
 interface SuggestionOption {
     text: string;
+    /**
+     * The option's real, matchable value — present when the option has a
+     * separate matchable value from its display `text` (e.g. a hierarchical
+     * option's `text` is its last path segment, "Probiotics", while `value` is
+     * the full path `text` was shortened from). Sent to the server on tap
+     * instead of `text` (see `toWireParam`), so grounding still matches the
+     * full, collision-safe value while the row shows a short label. Falls
+     * back to `text` when absent.
+     */
+    value?: string;
     /**
      * The icon's name — an identifier such as `"apple"`, exposed on the row as
      * `data-aia-icon` when its `icon_svg` draws. Never rendered as text: a row
@@ -65,6 +75,7 @@ interface AutocompleteRequest {
         language: string;
         client_version: string;
         session_id: string;
+        source?: "full-sdk" | "headless-sdk";
     };
 }
 interface AutocompleteResponse {
@@ -170,6 +181,8 @@ interface CustomFieldsReport {
 interface CompletedParamState extends CompletedParam {
     id: string;
     text: string;
+    /** The originating option's `value` (see {@link SuggestionOption.value}), carried over so `toWireParam` can send it instead of the shortened `text`. */
+    value?: string;
     /** Source suggestion's `type` — used by re-edit mode to render the dropdown pill. */
     suggestionType: string;
     /** Source suggestion's `text` — used by re-edit mode to render the dropdown pill. */
@@ -832,9 +845,10 @@ interface CoreOptions {
      */
     styleRoot?: Document | ShadowRoot;
     /**
-     * Identifies which SDK surface is in use, for telemetry only. The hook can't
-     * distinguish on its own — the Tier 1 component sets "full-sdk" when wiring
-     * it up. Default: "headless-sdk".
+     * Identifies which SDK surface is in use — sent as meta.source on both
+     * /api/suggest and telemetry events. The hook can't distinguish on its own
+     * — the Tier 1 component sets "full-sdk" when wiring it up. Default:
+     * "headless-sdk".
      * @internal
      */
     source?: "full-sdk" | "headless-sdk";
@@ -1134,6 +1148,7 @@ declare class AIAutocomplete {
     update(opts: CoreUpdateOptions): void;
     selectOption(option: SuggestionOption): void;
     private startSelectionAnimationTimer;
+    private resolveSource;
     private fireTelemetry;
     private setupContainer;
     private buildAndRenderFull;