@magicx-eng/ai-autocomplete-vanilla 0.40.0 → 0.41.0

package/README.md

@@ -81,6 +81,7 @@ const ac = new AIAutocomplete(container, {
   commitOnWordEnd: false,   // true = a word still being typed never becomes a chip until a space, Enter, or Tab ends it (exact matches and server identified params). Picking an option is unchanged.
   additionalContext: { tier: "gold" }, // optional user context, to personalize suggestions and options
   language: "es",           // BCP 47 tag sent with every suggestion request and telemetry event. Default: navigator.language, else "en-US"
+  productId: "...",         // your product id: what the dropdown offers before anything is typed is read from a cacheable URL with no credential; falls back to a suggestion request
 
   // Appearance
   mode: "auto",               // "light" | "dark" | "auto"

package/dist/index.d.mts

@@ -940,8 +940,16 @@ interface CoreOptions {
     /**
      * BCP 47 language tag (e.g. `"es"`), sent with every suggestion request and telemetry event.
      * Default: the browser language (`navigator.language`), else `"en-US"`.
+     * Only an explicit value selects the SDK's own UI words (Spanish for `es`, English otherwise). The browser language does not.
      */
     language?: string;
+    /**
+     * Your product id. When set, what the dropdown offers before anything is
+     * typed is read from a cacheable URL for your product, with no credential,
+     * instead of a suggestion request; it falls back to a suggestion request
+     * when it cannot be read.
+     */
+    productId?: string;
     /**
      * Stable id for this visitor, kept by the host across page loads (e.g. a
      * first-party cookie). Rides on funnel telemetry so searches can be joined
@@ -1372,6 +1380,7 @@ declare class AIAutocomplete {
      */
     private fireImpression;
     private fireTelemetry;
+    private updateLanguageAttribute;
     private setupContainer;
     private buildAndRenderFull;
     private buildAndRenderDropdown;
@@ -2101,6 +2110,20 @@ interface RenderEditableArgs {
  */
 declare function renderEditableContent(args: RenderEditableArgs): void;
 
+declare const en: {
+    language: string;
+    proceed: string;
+    select: string;
+    skipHint: string;
+    skip: string;
+    skipLabel: string;
+    products: string;
+    soldOut: string;
+    submit: string;
+    scrollArrow: string;
+};
+type UIStrings = typeof en;
+
 /**
  * The "more below" arrow for the options grid.
  *
@@ -2291,7 +2314,7 @@ declare function buildQuery(text: string, completedParams: CompletedParamState[]
  * Pure computation — no DOM access. Shared by the vanilla renderer and the
  * React / Angular footer components so the wording can't drift between them.
  */
-declare function getFooterHint(optionHighlighted: boolean, isInputEmpty: boolean): {
+declare function getFooterHint(optionHighlighted: boolean, isInputEmpty: boolean, strings?: UIStrings): {
     key: string;
     hint: string;
 };

package/dist/index.d.ts

@@ -940,8 +940,16 @@ interface CoreOptions {
     /**
      * BCP 47 language tag (e.g. `"es"`), sent with every suggestion request and telemetry event.
      * Default: the browser language (`navigator.language`), else `"en-US"`.
+     * Only an explicit value selects the SDK's own UI words (Spanish for `es`, English otherwise). The browser language does not.
      */
     language?: string;
+    /**
+     * Your product id. When set, what the dropdown offers before anything is
+     * typed is read from a cacheable URL for your product, with no credential,
+     * instead of a suggestion request; it falls back to a suggestion request
+     * when it cannot be read.
+     */
+    productId?: string;
     /**
      * Stable id for this visitor, kept by the host across page loads (e.g. a
      * first-party cookie). Rides on funnel telemetry so searches can be joined
@@ -1372,6 +1380,7 @@ declare class AIAutocomplete {
      */
     private fireImpression;
     private fireTelemetry;
+    private updateLanguageAttribute;
     private setupContainer;
     private buildAndRenderFull;
     private buildAndRenderDropdown;
@@ -2101,6 +2110,20 @@ interface RenderEditableArgs {
  */
 declare function renderEditableContent(args: RenderEditableArgs): void;
 
+declare const en: {
+    language: string;
+    proceed: string;
+    select: string;
+    skipHint: string;
+    skip: string;
+    skipLabel: string;
+    products: string;
+    soldOut: string;
+    submit: string;
+    scrollArrow: string;
+};
+type UIStrings = typeof en;
+
 /**
  * The "more below" arrow for the options grid.
  *
@@ -2291,7 +2314,7 @@ declare function buildQuery(text: string, completedParams: CompletedParamState[]
  * Pure computation — no DOM access. Shared by the vanilla renderer and the
  * React / Angular footer components so the wording can't drift between them.
  */
-declare function getFooterHint(optionHighlighted: boolean, isInputEmpty: boolean): {
+declare function getFooterHint(optionHighlighted: boolean, isInputEmpty: boolean, strings?: UIStrings): {
     key: string;
     hint: string;
 };