@magicx-eng/ai-autocomplete-vanilla 0.53.0 → 0.54.0

package/README.md

@@ -140,6 +140,7 @@ const ac = new AIAutocomplete(container, {
   onFocus: () => { ... },
   onBlur: () => { ... },
   onProductSelect: (product) => { ... },   // see "Product strip"
+  onProductAddToCart: (product) => { ... },  // see "Add to cart"
 
   // Controlled mode
   value: "initial text",
@@ -166,6 +167,8 @@ ac.destroy();                  // Remove DOM, listeners, timers
 ac.setMode("dark");            // Switch color mode
 ac.update({ animations: false, optionsPosition: "above" });
 ac.selectProduct(product);     // Emit onProductSelect (Tier 3 / custom strips)
+ac.addProductToCart(product);  // Call onProductAddToCart (Tier 3 / custom strips)
+ac.prepareSubmit();            // Prepare the typed word before your own button builds a result
 ac.getResult();                // The AutocompleteResult as it stands right now
 ac.getRequestId();             // The latest applied /suggest request ID, or null
 ```
@@ -277,6 +280,34 @@ without additional SDK options.
 }
 ```
 
+#### Add to cart
+
+Pass `onProductAddToCart` and every card that isn't sold out gets a round
+add-to-cart button in the bottom right corner of its image. Sold-out cards
+(`available: false`) get none. Pressing it calls your handler, not
+`onProductSelect`. The card doesn't open, and the panel stays open. The SDK
+never touches a cart; your handler does the adding:
+
+```ts
+new AIAutocomplete(container, {
+  apiConfig: { apiKey: "..." },
+  onProductAddToCart: async (product) => {
+    const res = await fetch("/cart/add", { method: "POST", body: JSON.stringify({ id: product.id }) });
+    if (!res.ok) throw new Error(`cart ${res.status}`);
+  },
+});
+```
+
+Return a promise to have the button show progress. It carries
+`data-aia-cart-state="adding"` while the promise is pending, then `"added"`
+(the cart glyph turns into a check) for a moment once it resolves. A rejection
+returns it to rest. Style it with
+`--aia-product-cart-size` (28px), `--aia-product-cart-bg` and
+`--aia-product-cart-color`, or `[data-aia-product-cart]`. In the list layout
+the button sits at the row's right end. Headless consumers rendering
+their own cards call `addProductToCart(product)`, which resolves or rejects
+with the handler.
+
 #### The catalog report (`customFields`)
 
 Every response that read the catalog also says what it did with the query, and
@@ -689,6 +720,7 @@ unsub();
 | `removeLastParam()` | Remove the last completed param from state. The text stays in the input as plain text. |
 | `clearNewParamId()` | Clear shimmer animation state. |
 | `reset()` | Clear all state, re-fetch initial suggestions, and start a new session (rotates `session_id`). Call this after handling submit. |
+| `prepareSubmit()` | Call before building a submit result from your own button. A typed word that equals exactly one completion candidate becomes a completed param, the same as Enter. Read the updated state with `getState()` to build the result. |
 | `recordSubmit(result)` | Record a submit from a button you render. Enter and the built-in button are recorded for you; call this once per submit from your own button. |
 | `setValue(text)` | Set text (controlled mode). Text set this way is not reported as the user starting a search. |
 | `prefillText(text)` | Fill the field with text the user did not type — e.g. a query carried over from the previous page — and handle it like typing: suggestions are fetched and the text is recognized. Not reported as the user starting a search. |
@@ -1057,6 +1089,8 @@ Submits from Enter and from the built-in submit button are recorded for you. If
 
 ## Option Overrides
 
+Each suggestion request sends the current `optionOverrides` keys in `data.client_option_parameters` (or `[]` when absent), so the server skips client-supplied parameters that are not listed.
+
 Supply the options for a parameter yourself instead of taking the server's. Each entry is keyed by the suggestion `parameter` and is a function of the phrase the user has typed for that parameter:
 
 ```ts

package/dist/index.d.mts

@@ -88,6 +88,8 @@ interface Suggestion {
     required: boolean;
     options?: SuggestionOption[];
     type?: SuggestionType;
+    /** The server sets this on LLM-written suggestions: true when options complete the typed word, false when they follow the typed text. */
+    completes_word?: boolean;
     /**
      * Asks for the Smart Suggestion look (sparkle and shimmer) on an ordinary
      * question, such as one the server curated for a question query. It changes
@@ -145,6 +147,11 @@ interface AutocompleteRequest {
         recently_suggested?: RecentlySuggested[];
         contact_account_count?: number;
         additional_context?: Record<string, unknown>;
+        /**
+         * Parameters whose options the consumer supplies through `optionOverrides`.
+         * The server skips a client-supplied parameter that is not listed.
+         */
+        client_option_parameters: string[];
         /** Tells the server this client can show option-value completions of the word being typed. */
         accepts_traditional_autocomplete?: boolean;
     };
@@ -1181,6 +1188,18 @@ interface CoreOptions {
      * cmd-click and "copy link address" keep working, and don't fire this.
      */
     onProductSelect?: (product: Product) => void;
+    /**
+     * Adds a product to the cart from its card. When set, every card that isn't
+     * sold out (`available: false`) shows an add-to-cart button in the bottom
+     * right corner of its image. When unset, no card has one. Pressing the button
+     * calls this, not `onProductSelect`, and the panel stays open. The SDK never
+     * touches a cart itself; the integration does the adding.
+     *
+     * Return a promise to have the button show progress. It carries
+     * `data-aia-cart-state="adding"` until the promise settles, then `"added"` for
+     * a moment if it resolved. A rejection puts the button back at rest.
+     */
+    onProductAddToCart?: (product: Product) => void | PromiseLike<unknown>;
     value?: string;
     completedParams?: CompletedParamState[];
     /**
@@ -1204,7 +1223,7 @@ type AIAutocompleteEvents = {
     blur: [];
     productSelect: [product: Product];
 };
-type CoreUpdateOptions = Partial<Omit<CoreOptions, "onSubmit" | "onResult" | "onError" | "onChange" | "onParamsChange" | "onStateChange" | "onFocus" | "onBlur" | "onProductSelect" | "styleRoot">>;
+type CoreUpdateOptions = Partial<Omit<CoreOptions, "onSubmit" | "onResult" | "onError" | "onChange" | "onParamsChange" | "onStateChange" | "onFocus" | "onBlur" | "onProductSelect" | "onProductAddToCart" | "styleRoot">>;
 declare class AIAutocomplete {
     private inputStore;
     private store;
@@ -1375,6 +1394,12 @@ declare class AIAutocomplete {
      * highlight the keyboard has since moved elsewhere is left alone.
      */
     clearHighlight(index: number): void;
+    /**
+     * Call before you build a submit result from your own button.
+     * A typed word that equals exactly one completion candidate becomes a completed param, the same as Enter.
+     * Read the updated state with `getState()` to build the result.
+     */
+    prepareSubmit(): void;
     /**
      * Records a submit in telemetry. The SDK does this itself when it runs the
      * submit (Enter, or Tier 1's button); call it only from a submit path you
@@ -1390,6 +1415,15 @@ declare class AIAutocomplete {
      * means "open the PDP", "add to cart" or "drop the title into the input".
      */
     selectProduct(product: Product): void;
+    /**
+     * Add a product to the cart through `onProductAddToCart`. The rendered
+     * cards' cart buttons call this; headless consumers rendering their own
+     * strip call it themselves. Resolves once the handler's promise settles, and
+     * rejects with its error. Without a handler it does nothing.
+     */
+    addProductToCart(product: Product): Promise<void>;
+    /** Whether cards draw a cart button: an `onProductAddToCart` handler is set. */
+    hasProductAddToCart(): boolean;
     handleTextChange(value: string): void;
     private applyTextChange;
     /** Page the datepicker back one month. No-op unless a date pill is active. */
@@ -2234,6 +2268,7 @@ declare const en: {
     skipLabel: string;
     products: string;
     soldOut: string;
+    addToCart: string;
     submit: string;
     scrollArrow: string;
     keepTyping: string;
@@ -2362,6 +2397,18 @@ declare const PRODUCT_IMAGE_WIDTH = 360;
  * stays relative.
  */
 declare function shopifyImageSrc(url: string, width: number): string;
+/**
+ * How much of a product card's square tile a photo fills, across and down:
+ * the tile shows it whole (`object-fit: contain`), so a tall photo leaves a
+ * margin either side and a wide one a margin above and below. The add-to-cart
+ * button reads these (as `--aia-product-photo-fill-x` / `-y` on the card) to
+ * sit inside the photo's own corner rather than the tile's. Null for a size
+ * that isn't known yet.
+ */
+declare function productPhotoFill(naturalWidth: number, naturalHeight: number): {
+    x: number;
+    y: number;
+} | null;
 /**
  * The URLs a product card tries for `imageUrl`, in order (`imageSources` at
  * the card width): trimmed, sized down when it is a Shopify-hosted PNG or WebP, with
@@ -2687,4 +2734,4 @@ declare const SMART_SUGGESTION_SPARKLE_SVG: string;
 /** True when some pill is a question the shopper can decline. */
 declare function hasSkippablePill(suggestions: Suggestion[]): boolean;
 
-export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type CurrencyOptions, type CustomFieldsReport, DATE_RANGE_META_END, DATE_RANGE_META_START, DEFAULT_OPTION_COUNT_UNIT, type DateMonthView, type DateRange, type DateSelection, type ExpressedFilter, type FilterOp, type FormatType, type IdentifiedParam, type IdentifiedParamState, type InputItem, type LooseDateOptions, type MatchedItem, type MatchedItems, ModeController, OPTIONS_GRID_MOBILE_QUERY, OPTION_ENTER_DELAY_VAR, OPTION_ENTER_FADE_MS, OPTION_ENTER_RISE_MS, OPTION_ENTER_RISE_PX, OPTION_ENTER_STAGGER_MS, OPTION_IMAGE_WIDTH, type OptionOverride, type OptionOverrides, type OptionsGridLayout, type OptionsGridPlan, PLACEHOLDER_FADE_OUT_MS, PLACEHOLDER_LEAVING_ATTR, PLACEHOLDER_SWAP_GAP_MS, PLACEHOLDER_TYPE_MS, PLACEHOLDER_WORD_PAUSE_MS, PRODUCT_IMAGE_WIDTH, PRODUCT_PATH_PREFIX, PRODUCT_ROW_PX_PER_LINE, type PhraseMatch, type Product, type ProductImageFallback, type ProductRowMetrics, type ProductRowWheel, type ProductsConfig, type ProductsLayout, RANGE_SEPARATOR, type RecentlySuggested, type RenderMode, SCHEMA_VERSION, SCROLL_ARROW_ATTR, SCROLL_ARROW_BOTTOM_VAR, SCROLL_ARROW_CLASS, SCROLL_ARROW_FADE_MS, SCROLL_ARROW_LABEL, SCROLL_ARROW_SCROLL_IDLE_MS, SCROLL_ARROW_VISIBLE_ATTR, SKIPPED_PARAM_TEXT, SMART_SUGGESTION_SPARKLE_SVG, type ScrollArrowArgs, type ScrollArrowController, type Segment, type SkippedParamState, type Store, type SubmitResultExtras, type Suggestion, type SuggestionOption, type SuggestionType, type TaskKind, type TextPart, type UIStrings, VIEWPORT_FIT_ATTR, VIEWPORT_FIT_HEIGHT_VAR, type ViewportFitArgs, type ViewportFitController, WEEKDAY_LABELS, addMonths, attachProductRowWheel, attachScrollArrow, attachViewportFit, buildAttributionUrl, buildDateOptions, buildQuery, buildSubmitResult, cellDay, cellIso, chipIdFromTap, computeOptionsGridLayout, containScroll, createStore, cursorIsAtEnd, dateCellMarks, dateSelectionFor, extractPlainText, formatAbsoluteDate, formatDate, formatDateRange, formatOptionCount, getCursorOffset, getFooterHint, hasSkippablePill, highlightParts, identifiedParamLabel, isCalendarFormat, isOptionsGridMobileViewport, isSmartSuggestion, isTraditionalAutocompleteSuggestion, isoDate, keepCaretOnChip, labelTraditionalAutocomplete, matchTypedPhrase, measureOptionsGrid, monthLabel, needsOptionsGridMeasurement, optionCountLabel, optionEnterDelayMs, optionHasImage, optionImageSources, optionImageSrc, optionLabel, optionsEntranceDurationMs, optionsGridTemplateColumns, optionsShowLeadingVisuals, parseDate, parseLooseDate, parseLooseDateRange, plainTextLength, planOptionsGrid, previousGraphemeBoundary, productFromMatchedItem, productImageSources, productImageSrc, productInitial, productRowWheelTarget, productsFromCustomFields, renderEditableContent, resolveFormatType, resolveIdentifiedDate, sameOptionRows, sanitizeOptionIconSvg, scrollCaretIntoView, selectedIsoFromText, selectedRangeFor, setCursorOffset, shopifyImageSrc, toWireIdentifiedParams, typedFragment, uiStringsFor, visibleDateRange, withSkippedParams, withoutTraditionalAutocomplete };
+export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type CurrencyOptions, type CustomFieldsReport, DATE_RANGE_META_END, DATE_RANGE_META_START, DEFAULT_OPTION_COUNT_UNIT, type DateMonthView, type DateRange, type DateSelection, type ExpressedFilter, type FilterOp, type FormatType, type IdentifiedParam, type IdentifiedParamState, type InputItem, type LooseDateOptions, type MatchedItem, type MatchedItems, ModeController, OPTIONS_GRID_MOBILE_QUERY, OPTION_ENTER_DELAY_VAR, OPTION_ENTER_FADE_MS, OPTION_ENTER_RISE_MS, OPTION_ENTER_RISE_PX, OPTION_ENTER_STAGGER_MS, OPTION_IMAGE_WIDTH, type OptionOverride, type OptionOverrides, type OptionsGridLayout, type OptionsGridPlan, PLACEHOLDER_FADE_OUT_MS, PLACEHOLDER_LEAVING_ATTR, PLACEHOLDER_SWAP_GAP_MS, PLACEHOLDER_TYPE_MS, PLACEHOLDER_WORD_PAUSE_MS, PRODUCT_IMAGE_WIDTH, PRODUCT_PATH_PREFIX, PRODUCT_ROW_PX_PER_LINE, type PhraseMatch, type Product, type ProductImageFallback, type ProductRowMetrics, type ProductRowWheel, type ProductsConfig, type ProductsLayout, RANGE_SEPARATOR, type RecentlySuggested, type RenderMode, SCHEMA_VERSION, SCROLL_ARROW_ATTR, SCROLL_ARROW_BOTTOM_VAR, SCROLL_ARROW_CLASS, SCROLL_ARROW_FADE_MS, SCROLL_ARROW_LABEL, SCROLL_ARROW_SCROLL_IDLE_MS, SCROLL_ARROW_VISIBLE_ATTR, SKIPPED_PARAM_TEXT, SMART_SUGGESTION_SPARKLE_SVG, type ScrollArrowArgs, type ScrollArrowController, type Segment, type SkippedParamState, type Store, type SubmitResultExtras, type Suggestion, type SuggestionOption, type SuggestionType, type TaskKind, type TextPart, type UIStrings, VIEWPORT_FIT_ATTR, VIEWPORT_FIT_HEIGHT_VAR, type ViewportFitArgs, type ViewportFitController, WEEKDAY_LABELS, addMonths, attachProductRowWheel, attachScrollArrow, attachViewportFit, buildAttributionUrl, buildDateOptions, buildQuery, buildSubmitResult, cellDay, cellIso, chipIdFromTap, computeOptionsGridLayout, containScroll, createStore, cursorIsAtEnd, dateCellMarks, dateSelectionFor, extractPlainText, formatAbsoluteDate, formatDate, formatDateRange, formatOptionCount, getCursorOffset, getFooterHint, hasSkippablePill, highlightParts, identifiedParamLabel, isCalendarFormat, isOptionsGridMobileViewport, isSmartSuggestion, isTraditionalAutocompleteSuggestion, isoDate, keepCaretOnChip, labelTraditionalAutocomplete, matchTypedPhrase, measureOptionsGrid, monthLabel, needsOptionsGridMeasurement, optionCountLabel, optionEnterDelayMs, optionHasImage, optionImageSources, optionImageSrc, optionLabel, optionsEntranceDurationMs, optionsGridTemplateColumns, optionsShowLeadingVisuals, parseDate, parseLooseDate, parseLooseDateRange, plainTextLength, planOptionsGrid, previousGraphemeBoundary, productFromMatchedItem, productImageSources, productImageSrc, productInitial, productPhotoFill, productRowWheelTarget, productsFromCustomFields, renderEditableContent, resolveFormatType, resolveIdentifiedDate, sameOptionRows, sanitizeOptionIconSvg, scrollCaretIntoView, selectedIsoFromText, selectedRangeFor, setCursorOffset, shopifyImageSrc, toWireIdentifiedParams, typedFragment, uiStringsFor, visibleDateRange, withSkippedParams, withoutTraditionalAutocomplete };

package/dist/index.d.ts

@@ -88,6 +88,8 @@ interface Suggestion {
     required: boolean;
     options?: SuggestionOption[];
     type?: SuggestionType;
+    /** The server sets this on LLM-written suggestions: true when options complete the typed word, false when they follow the typed text. */
+    completes_word?: boolean;
     /**
      * Asks for the Smart Suggestion look (sparkle and shimmer) on an ordinary
      * question, such as one the server curated for a question query. It changes
@@ -145,6 +147,11 @@ interface AutocompleteRequest {
         recently_suggested?: RecentlySuggested[];
         contact_account_count?: number;
         additional_context?: Record<string, unknown>;
+        /**
+         * Parameters whose options the consumer supplies through `optionOverrides`.
+         * The server skips a client-supplied parameter that is not listed.
+         */
+        client_option_parameters: string[];
         /** Tells the server this client can show option-value completions of the word being typed. */
         accepts_traditional_autocomplete?: boolean;
     };
@@ -1181,6 +1188,18 @@ interface CoreOptions {
      * cmd-click and "copy link address" keep working, and don't fire this.
      */
     onProductSelect?: (product: Product) => void;
+    /**
+     * Adds a product to the cart from its card. When set, every card that isn't
+     * sold out (`available: false`) shows an add-to-cart button in the bottom
+     * right corner of its image. When unset, no card has one. Pressing the button
+     * calls this, not `onProductSelect`, and the panel stays open. The SDK never
+     * touches a cart itself; the integration does the adding.
+     *
+     * Return a promise to have the button show progress. It carries
+     * `data-aia-cart-state="adding"` until the promise settles, then `"added"` for
+     * a moment if it resolved. A rejection puts the button back at rest.
+     */
+    onProductAddToCart?: (product: Product) => void | PromiseLike<unknown>;
     value?: string;
     completedParams?: CompletedParamState[];
     /**
@@ -1204,7 +1223,7 @@ type AIAutocompleteEvents = {
     blur: [];
     productSelect: [product: Product];
 };
-type CoreUpdateOptions = Partial<Omit<CoreOptions, "onSubmit" | "onResult" | "onError" | "onChange" | "onParamsChange" | "onStateChange" | "onFocus" | "onBlur" | "onProductSelect" | "styleRoot">>;
+type CoreUpdateOptions = Partial<Omit<CoreOptions, "onSubmit" | "onResult" | "onError" | "onChange" | "onParamsChange" | "onStateChange" | "onFocus" | "onBlur" | "onProductSelect" | "onProductAddToCart" | "styleRoot">>;
 declare class AIAutocomplete {
     private inputStore;
     private store;
@@ -1375,6 +1394,12 @@ declare class AIAutocomplete {
      * highlight the keyboard has since moved elsewhere is left alone.
      */
     clearHighlight(index: number): void;
+    /**
+     * Call before you build a submit result from your own button.
+     * A typed word that equals exactly one completion candidate becomes a completed param, the same as Enter.
+     * Read the updated state with `getState()` to build the result.
+     */
+    prepareSubmit(): void;
     /**
      * Records a submit in telemetry. The SDK does this itself when it runs the
      * submit (Enter, or Tier 1's button); call it only from a submit path you
@@ -1390,6 +1415,15 @@ declare class AIAutocomplete {
      * means "open the PDP", "add to cart" or "drop the title into the input".
      */
     selectProduct(product: Product): void;
+    /**
+     * Add a product to the cart through `onProductAddToCart`. The rendered
+     * cards' cart buttons call this; headless consumers rendering their own
+     * strip call it themselves. Resolves once the handler's promise settles, and
+     * rejects with its error. Without a handler it does nothing.
+     */
+    addProductToCart(product: Product): Promise<void>;
+    /** Whether cards draw a cart button: an `onProductAddToCart` handler is set. */
+    hasProductAddToCart(): boolean;
     handleTextChange(value: string): void;
     private applyTextChange;
     /** Page the datepicker back one month. No-op unless a date pill is active. */
@@ -2234,6 +2268,7 @@ declare const en: {
     skipLabel: string;
     products: string;
     soldOut: string;
+    addToCart: string;
     submit: string;
     scrollArrow: string;
     keepTyping: string;
@@ -2362,6 +2397,18 @@ declare const PRODUCT_IMAGE_WIDTH = 360;
  * stays relative.
  */
 declare function shopifyImageSrc(url: string, width: number): string;
+/**
+ * How much of a product card's square tile a photo fills, across and down:
+ * the tile shows it whole (`object-fit: contain`), so a tall photo leaves a
+ * margin either side and a wide one a margin above and below. The add-to-cart
+ * button reads these (as `--aia-product-photo-fill-x` / `-y` on the card) to
+ * sit inside the photo's own corner rather than the tile's. Null for a size
+ * that isn't known yet.
+ */
+declare function productPhotoFill(naturalWidth: number, naturalHeight: number): {
+    x: number;
+    y: number;
+} | null;
 /**
  * The URLs a product card tries for `imageUrl`, in order (`imageSources` at
  * the card width): trimmed, sized down when it is a Shopify-hosted PNG or WebP, with
@@ -2687,4 +2734,4 @@ declare const SMART_SUGGESTION_SPARKLE_SVG: string;
 /** True when some pill is a question the shopper can decline. */
 declare function hasSkippablePill(suggestions: Suggestion[]): boolean;
 
-export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type CurrencyOptions, type CustomFieldsReport, DATE_RANGE_META_END, DATE_RANGE_META_START, DEFAULT_OPTION_COUNT_UNIT, type DateMonthView, type DateRange, type DateSelection, type ExpressedFilter, type FilterOp, type FormatType, type IdentifiedParam, type IdentifiedParamState, type InputItem, type LooseDateOptions, type MatchedItem, type MatchedItems, ModeController, OPTIONS_GRID_MOBILE_QUERY, OPTION_ENTER_DELAY_VAR, OPTION_ENTER_FADE_MS, OPTION_ENTER_RISE_MS, OPTION_ENTER_RISE_PX, OPTION_ENTER_STAGGER_MS, OPTION_IMAGE_WIDTH, type OptionOverride, type OptionOverrides, type OptionsGridLayout, type OptionsGridPlan, PLACEHOLDER_FADE_OUT_MS, PLACEHOLDER_LEAVING_ATTR, PLACEHOLDER_SWAP_GAP_MS, PLACEHOLDER_TYPE_MS, PLACEHOLDER_WORD_PAUSE_MS, PRODUCT_IMAGE_WIDTH, PRODUCT_PATH_PREFIX, PRODUCT_ROW_PX_PER_LINE, type PhraseMatch, type Product, type ProductImageFallback, type ProductRowMetrics, type ProductRowWheel, type ProductsConfig, type ProductsLayout, RANGE_SEPARATOR, type RecentlySuggested, type RenderMode, SCHEMA_VERSION, SCROLL_ARROW_ATTR, SCROLL_ARROW_BOTTOM_VAR, SCROLL_ARROW_CLASS, SCROLL_ARROW_FADE_MS, SCROLL_ARROW_LABEL, SCROLL_ARROW_SCROLL_IDLE_MS, SCROLL_ARROW_VISIBLE_ATTR, SKIPPED_PARAM_TEXT, SMART_SUGGESTION_SPARKLE_SVG, type ScrollArrowArgs, type ScrollArrowController, type Segment, type SkippedParamState, type Store, type SubmitResultExtras, type Suggestion, type SuggestionOption, type SuggestionType, type TaskKind, type TextPart, type UIStrings, VIEWPORT_FIT_ATTR, VIEWPORT_FIT_HEIGHT_VAR, type ViewportFitArgs, type ViewportFitController, WEEKDAY_LABELS, addMonths, attachProductRowWheel, attachScrollArrow, attachViewportFit, buildAttributionUrl, buildDateOptions, buildQuery, buildSubmitResult, cellDay, cellIso, chipIdFromTap, computeOptionsGridLayout, containScroll, createStore, cursorIsAtEnd, dateCellMarks, dateSelectionFor, extractPlainText, formatAbsoluteDate, formatDate, formatDateRange, formatOptionCount, getCursorOffset, getFooterHint, hasSkippablePill, highlightParts, identifiedParamLabel, isCalendarFormat, isOptionsGridMobileViewport, isSmartSuggestion, isTraditionalAutocompleteSuggestion, isoDate, keepCaretOnChip, labelTraditionalAutocomplete, matchTypedPhrase, measureOptionsGrid, monthLabel, needsOptionsGridMeasurement, optionCountLabel, optionEnterDelayMs, optionHasImage, optionImageSources, optionImageSrc, optionLabel, optionsEntranceDurationMs, optionsGridTemplateColumns, optionsShowLeadingVisuals, parseDate, parseLooseDate, parseLooseDateRange, plainTextLength, planOptionsGrid, previousGraphemeBoundary, productFromMatchedItem, productImageSources, productImageSrc, productInitial, productRowWheelTarget, productsFromCustomFields, renderEditableContent, resolveFormatType, resolveIdentifiedDate, sameOptionRows, sanitizeOptionIconSvg, scrollCaretIntoView, selectedIsoFromText, selectedRangeFor, setCursorOffset, shopifyImageSrc, toWireIdentifiedParams, typedFragment, uiStringsFor, visibleDateRange, withSkippedParams, withoutTraditionalAutocomplete };
+export { AIAutocomplete, type APIConfig, type APIKeyConfig, ATTRIBUTION_URL, type AccessTokenConfig, type AccessTokenResult, type AppearanceMode, type AutocompleteRequest, type AutocompleteResponse, type AutocompleteResult, type CompletedParam, type CompletedParamState, type CoreOptions, type CoreState, type CurrencyOptions, type CustomFieldsReport, DATE_RANGE_META_END, DATE_RANGE_META_START, DEFAULT_OPTION_COUNT_UNIT, type DateMonthView, type DateRange, type DateSelection, type ExpressedFilter, type FilterOp, type FormatType, type IdentifiedParam, type IdentifiedParamState, type InputItem, type LooseDateOptions, type MatchedItem, type MatchedItems, ModeController, OPTIONS_GRID_MOBILE_QUERY, OPTION_ENTER_DELAY_VAR, OPTION_ENTER_FADE_MS, OPTION_ENTER_RISE_MS, OPTION_ENTER_RISE_PX, OPTION_ENTER_STAGGER_MS, OPTION_IMAGE_WIDTH, type OptionOverride, type OptionOverrides, type OptionsGridLayout, type OptionsGridPlan, PLACEHOLDER_FADE_OUT_MS, PLACEHOLDER_LEAVING_ATTR, PLACEHOLDER_SWAP_GAP_MS, PLACEHOLDER_TYPE_MS, PLACEHOLDER_WORD_PAUSE_MS, PRODUCT_IMAGE_WIDTH, PRODUCT_PATH_PREFIX, PRODUCT_ROW_PX_PER_LINE, type PhraseMatch, type Product, type ProductImageFallback, type ProductRowMetrics, type ProductRowWheel, type ProductsConfig, type ProductsLayout, RANGE_SEPARATOR, type RecentlySuggested, type RenderMode, SCHEMA_VERSION, SCROLL_ARROW_ATTR, SCROLL_ARROW_BOTTOM_VAR, SCROLL_ARROW_CLASS, SCROLL_ARROW_FADE_MS, SCROLL_ARROW_LABEL, SCROLL_ARROW_SCROLL_IDLE_MS, SCROLL_ARROW_VISIBLE_ATTR, SKIPPED_PARAM_TEXT, SMART_SUGGESTION_SPARKLE_SVG, type ScrollArrowArgs, type ScrollArrowController, type Segment, type SkippedParamState, type Store, type SubmitResultExtras, type Suggestion, type SuggestionOption, type SuggestionType, type TaskKind, type TextPart, type UIStrings, VIEWPORT_FIT_ATTR, VIEWPORT_FIT_HEIGHT_VAR, type ViewportFitArgs, type ViewportFitController, WEEKDAY_LABELS, addMonths, attachProductRowWheel, attachScrollArrow, attachViewportFit, buildAttributionUrl, buildDateOptions, buildQuery, buildSubmitResult, cellDay, cellIso, chipIdFromTap, computeOptionsGridLayout, containScroll, createStore, cursorIsAtEnd, dateCellMarks, dateSelectionFor, extractPlainText, formatAbsoluteDate, formatDate, formatDateRange, formatOptionCount, getCursorOffset, getFooterHint, hasSkippablePill, highlightParts, identifiedParamLabel, isCalendarFormat, isOptionsGridMobileViewport, isSmartSuggestion, isTraditionalAutocompleteSuggestion, isoDate, keepCaretOnChip, labelTraditionalAutocomplete, matchTypedPhrase, measureOptionsGrid, monthLabel, needsOptionsGridMeasurement, optionCountLabel, optionEnterDelayMs, optionHasImage, optionImageSources, optionImageSrc, optionLabel, optionsEntranceDurationMs, optionsGridTemplateColumns, optionsShowLeadingVisuals, parseDate, parseLooseDate, parseLooseDateRange, plainTextLength, planOptionsGrid, previousGraphemeBoundary, productFromMatchedItem, productImageSources, productImageSrc, productInitial, productPhotoFill, productRowWheelTarget, productsFromCustomFields, renderEditableContent, resolveFormatType, resolveIdentifiedDate, sameOptionRows, sanitizeOptionIconSvg, scrollCaretIntoView, selectedIsoFromText, selectedRangeFor, setCursorOffset, shopifyImageSrc, toWireIdentifiedParams, typedFragment, uiStringsFor, visibleDateRange, withSkippedParams, withoutTraditionalAutocomplete };