@constructor-io/constructorio-ui-autocomplete 1.28.2 → 1.29.0

package/lib/types/types.d.ts

@@ -247,4 +247,6 @@ export interface PodData {
     podId: string;
     displayName: string;
     request: Partial<AutocompleteRequestType>;
+    resultId?: string;
+    numResults?: number;
 }

package/lib/types/utils/dataAttributeHelpers.d.ts

@@ -0,0 +1,75 @@
+import { Item, Section } from '../types';
+export declare const cnstrcDataAttrs: {
+    common: {
+        itemId: string;
+        itemName: string;
+        itemPrice: string;
+        variationId: string;
+        numResults: string;
+        conversionBtn: string;
+        resultId: string;
+        itemSection: string;
+        itemGroup: string;
+        slCampaignId: string;
+        slCampaignOwner: string;
+        section: string;
+    };
+    autocomplete: {
+        input: string;
+        inputForm: string;
+        searchSubmitButton: string;
+        autocompleteContainer: string;
+    };
+    recommendations: {
+        recommendationsContainer: string;
+        recommendationsPodId: string;
+        item: string;
+        strategyId: string;
+        seedItems: string;
+    };
+    custom: {
+        customSection: string;
+        customSectionName: string;
+    };
+};
+export interface CnstrcDataAttrs {
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * Normalize itemIds to array format for seed items
+ */
+export declare function normalizeSeedItems(itemIds?: string | string[]): string[] | undefined;
+/**
+ * Get data attributes for autocomplete/recommendation items
+ *
+ * @param item - The item to generate data attributes for
+ * @returns An object containing data attributes to be spread onto the element
+ *
+ * @example
+ * ```tsx
+ * // For autocomplete items
+ * const itemProps = getItemCnstrcDataAttributes(searchSuggestionItem);
+ * <li {...itemProps}>Search Suggestion</li>
+ *
+ * // For recommendation items
+ * const recItemProps = getItemCnstrcDataAttributes(recommendationItem);
+ * <div {...recItemProps}>Recommended Product</div>
+ * ```
+ */
+export declare function getItemCnstrcDataAttributes(item: Item): CnstrcDataAttrs;
+/**
+ * Get data attributes for recommendation sections
+ */
+export declare function getRecommendationsSectionCnstrcDataAttributes(section: Section, resultId?: string, numResults?: number, seedItems?: string[]): CnstrcDataAttrs;
+export type ConversionType = 'add_to_cart' | 'add_to_wishlist' | 'like' | 'message' | 'make_offer' | 'read' | string;
+/**
+ * Get data attributes for conversion buttons
+ *
+ * @example
+ * ```tsx
+ * <button {...getConversionButtonCnstrcDataAttributes('add_to_cart')}>
+ *   Add to Cart
+ * </button>
+ * ```
+ */
+export declare function getConversionButtonCnstrcDataAttributes(conversionType: ConversionType): CnstrcDataAttrs;

package/lib/types/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "1.28.2";
+declare const _default: "1.29.0";
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-ui-autocomplete",
-  "version": "1.28.2",
+  "version": "1.29.0",
   "description": "Constructor.io Autocomplete UI library for web applications",
   "main": "lib/cjs/index.js",
   "module": "lib/mjs/index.js",