@seekora-ai/ui-sdk-react 0.0.0-stage-20260517092419

package/dist/components/primitives/withAnalytics.js

@@ -0,0 +1,73 @@
+/**
+ * withAnalytics – HOC that wraps any React component to inject analytics tracking
+ */
+import React, { useRef, useEffect, useCallback } from 'react';
+import { log } from '@seekora-ai/ui-sdk-core';
+export function withAnalytics(Component, config = {}) {
+    const { trackClick = true, trackImpression = false, clickEventName = 'product.click', getProductFromProps = () => null, getPositionFromProps = () => 0, } = config;
+    const displayName = Component.displayName || Component.name || 'Component';
+    const Wrapped = React.forwardRef((props, ref) => {
+        const { seekoraClient, seekoraContext, ...rest } = props;
+        const containerRef = useRef(null);
+        const impressionTrackedRef = useRef(false);
+        const product = getProductFromProps(rest);
+        const position = getPositionFromProps(rest);
+        const sendEvent = useCallback(async (eventName, metadata) => {
+            if (!seekoraClient)
+                return;
+            try {
+                await seekoraClient.trackEvent?.({
+                    event_name: eventName,
+                    metadata: {
+                        product_id: product?.id || product?.objectID,
+                        product_title: product?.title || product?.name,
+                        product_price: product?.price,
+                        position,
+                        timestamp: Date.now(),
+                        source: 'with_analytics_hoc',
+                        ...metadata,
+                    },
+                }, seekoraContext);
+            }
+            catch (error) {
+                log.warn(`withAnalytics: Failed to track ${eventName}`, { error });
+            }
+        }, [seekoraClient, seekoraContext, product, position]);
+        const handleClick = useCallback(() => {
+            if (!trackClick || !product)
+                return;
+            sendEvent(clickEventName, {});
+            if (seekoraClient?.trackClick && product) {
+                Promise.resolve(seekoraClient.trackClick(product.id || product.objectID || '', position + 1, seekoraContext)).catch(() => { });
+            }
+        }, [trackClick, product, sendEvent, seekoraClient, seekoraContext, position]);
+        // Impression tracking
+        useEffect(() => {
+            if (!trackImpression || !seekoraClient || !containerRef.current || impressionTrackedRef.current)
+                return;
+            if (typeof IntersectionObserver === 'undefined')
+                return;
+            const observer = new IntersectionObserver((entries) => {
+                for (const entry of entries) {
+                    if (entry.isIntersecting && !impressionTrackedRef.current) {
+                        impressionTrackedRef.current = true;
+                        sendEvent('product.impression', {});
+                        observer.disconnect();
+                    }
+                }
+            }, { threshold: 0.5 });
+            observer.observe(containerRef.current);
+            return () => observer.disconnect();
+        }, [trackImpression, seekoraClient, sendEvent]);
+        return (React.createElement("div", { ref: (node) => {
+                containerRef.current = node;
+                if (typeof ref === 'function')
+                    ref(node);
+                else if (ref)
+                    ref.current = node;
+            }, onClick: handleClick, style: { display: 'contents' } },
+            React.createElement(Component, { ...rest })));
+    });
+    Wrapped.displayName = `withAnalytics(${displayName})`;
+    return Wrapped;
+}

package/dist/components/product-page/ProductGallery.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ProductGallery – product detail image gallery (primitive)
+ *
+ * Uses ImageDisplay with configurable variant (carousel, thumbStrip, etc.).
+ * For use on individual product page.
+ */
+import React from 'react';
+import { type ImageDisplayVariant } from '../primitives/ImageDisplay';
+import type { ImageZoomMode } from '../primitives/ImageZoom';
+export interface ProductGalleryProps {
+    images: string[];
+    variant?: ImageDisplayVariant;
+    alt?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    carouselAutoplay?: boolean;
+    carouselIntervalMs?: number;
+    /** Enable zoom functionality on product images */
+    enableZoom?: boolean;
+    /** Zoom mode: 'hover' (Amazon-style), 'lens', 'click' (lightbox), 'both' */
+    zoomMode?: ImageZoomMode;
+    /** Zoom magnification level (2 = 200%, 3 = 300%) */
+    zoomLevel?: number;
+}
+export declare function ProductGallery({ images, variant, alt, className, style, carouselAutoplay, carouselIntervalMs, enableZoom, zoomMode, zoomLevel, }: ProductGalleryProps): React.JSX.Element;
+//# sourceMappingURL=ProductGallery.d.ts.map

package/dist/components/product-page/ProductGallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductGallery.d.ts","sourceRoot":"","sources":["../../../src/components/product-page/ProductGallery.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EACN,OAAsB,EACtB,GAAe,EACf,SAAS,EACT,KAAK,EACL,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,SAAS,GACV,EAAE,mBAAmB,qBAerB"}

package/dist/components/product-page/ProductGallery.js

@@ -0,0 +1,13 @@
+/**
+ * ProductGallery – product detail image gallery (primitive)
+ *
+ * Uses ImageDisplay with configurable variant (carousel, thumbStrip, etc.).
+ * For use on individual product page.
+ */
+import React from 'react';
+import { clsx } from 'clsx';
+import { ImageDisplay } from '../primitives/ImageDisplay';
+export function ProductGallery({ images, variant = 'thumbStrip', alt = 'Product', className, style, carouselAutoplay, carouselIntervalMs, enableZoom, zoomMode, zoomLevel, }) {
+    return (React.createElement("div", { className: clsx('seekora-product-gallery', className), style: style },
+        React.createElement(ImageDisplay, { images: images, variant: variant, alt: alt, carouselAutoplay: carouselAutoplay, carouselIntervalMs: carouselIntervalMs, enableZoom: enableZoom, zoomMode: zoomMode, zoomLevel: zoomLevel })));
+}

package/dist/components/product-page/ProductInfo.d.ts

@@ -0,0 +1,44 @@
+/**
+ * ProductInfo – product detail block (primitive)
+ *
+ * Title, description, price, optional variant selector and CTA. Minimal layout;
+ * override with className/style. For use on individual product page.
+ *
+ * When options/variants/selections/onSelectionChange are provided and
+ * renderVariantSelector is NOT provided, renders the built-in VariantSelector.
+ * renderVariantSelector still takes priority as an override.
+ */
+import React from 'react';
+import type { ProductBadge, ProductOption, ProductVariant } from '@seekora-ai/ui-sdk-types';
+export interface ProductInfoProps {
+    title: string;
+    description?: string;
+    price?: number | string;
+    currency?: string;
+    /** Compare/original price for strikethrough display */
+    comparePrice?: number | string;
+    /** Product brand */
+    brand?: string;
+    /** Whether product is available */
+    available?: boolean;
+    /** Badges to display */
+    badges?: ProductBadge[];
+    /** Product option axes (Color, Size, etc.) */
+    options?: ProductOption[];
+    /** Product variants */
+    variants?: ProductVariant[];
+    /** Currently selected variant */
+    selectedVariant?: ProductVariant | null;
+    /** Current option selections */
+    selections?: Record<string, string>;
+    /** Called when an option value is selected */
+    onSelectionChange?: (optionName: string, value: string) => void;
+    /** Optional variant selector override (takes priority over built-in) */
+    renderVariantSelector?: () => React.ReactNode;
+    /** Optional CTA (e.g. Add to cart) */
+    renderCTA?: () => React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function ProductInfo({ title, description, price, currency, comparePrice, brand, available, badges, options, variants, selectedVariant: _selectedVariant, selections, onSelectionChange, renderVariantSelector, renderCTA, className, style, }: ProductInfoProps): React.JSX.Element;
+//# sourceMappingURL=ProductInfo.d.ts.map

package/dist/components/product-page/ProductInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductInfo.d.ts","sourceRoot":"","sources":["../../../src/components/product-page/ProductInfo.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wBAAwB;IACxB,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,iCAAiC;IACjC,eAAe,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8CAA8C;IAC9C,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,wEAAwE;IACxE,qBAAqB,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAC9C,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,KAAK,CAAC,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAc,EACd,YAAY,EACZ,KAAK,EACL,SAAS,EACT,MAAM,EACN,OAAO,EACP,QAAQ,EACR,eAAe,EAAE,gBAAgB,EACjC,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,SAAS,EACT,SAAS,EACT,KAAK,GACN,EAAE,gBAAgB,qBA2DlB"}

package/dist/components/product-page/ProductInfo.js

@@ -0,0 +1,34 @@
+/**
+ * ProductInfo – product detail block (primitive)
+ *
+ * Title, description, price, optional variant selector and CTA. Minimal layout;
+ * override with className/style. For use on individual product page.
+ *
+ * When options/variants/selections/onSelectionChange are provided and
+ * renderVariantSelector is NOT provided, renders the built-in VariantSelector.
+ * renderVariantSelector still takes priority as an override.
+ */
+import React from 'react';
+import { clsx } from 'clsx';
+import { PriceDisplay } from '../primitives/PriceDisplay';
+import { BadgeList } from '../primitives/BadgeList';
+import { VariantSelector } from '../primitives/VariantSelector';
+export function ProductInfo({ title, description, price, currency = '$', comparePrice, brand, available, badges, options, variants, selectedVariant: _selectedVariant, selections, onSelectionChange, renderVariantSelector, renderCTA, className, style, }) {
+    const priceNum = price != null ? (typeof price === 'number' ? price : parseFloat(String(price))) : null;
+    const comparePriceNum = comparePrice != null ? (typeof comparePrice === 'number' ? comparePrice : parseFloat(String(comparePrice))) : null;
+    const showBuiltInVariantSelector = !renderVariantSelector && options && options.length > 0 && variants && selections && onSelectionChange;
+    return (React.createElement("div", { className: clsx('seekora-product-info', className), style: { display: 'flex', flexDirection: 'column', gap: 12, ...style } },
+        badges && badges.length > 0 && (React.createElement(BadgeList, { badges: badges, position: "inline" })),
+        brand && (React.createElement("span", { className: "seekora-product-info-brand", style: { fontSize: '0.8125rem', color: 'var(--seekora-text-secondary)', textTransform: 'uppercase', letterSpacing: '0.02em' } }, brand)),
+        React.createElement("h1", { className: "seekora-product-info-title", style: { fontSize: '1.25rem', fontWeight: 600, margin: 0 } }, title),
+        (priceNum != null && !Number.isNaN(priceNum)) && (React.createElement("div", { className: "seekora-product-info-price" },
+            React.createElement(PriceDisplay, { price: priceNum, comparePrice: comparePriceNum ?? undefined, currency: currency, style: { fontSize: '1.125rem' } }))),
+        available != null && (React.createElement("span", { className: "seekora-product-info-availability", style: {
+                fontSize: '0.875rem',
+                color: available ? 'var(--seekora-success, #22c55e)' : 'var(--seekora-error, #ef4444)',
+            } }, available ? 'In Stock' : 'Out of Stock')),
+        description ? (React.createElement("p", { className: "seekora-product-info-description", style: { fontSize: '0.875rem', color: 'var(--seekora-text-secondary)', margin: 0, lineHeight: 1.5 } }, description)) : null,
+        renderVariantSelector ? renderVariantSelector() : null,
+        showBuiltInVariantSelector && (React.createElement(VariantSelector, { options: options, variants: variants, selections: selections, onSelectionChange: onSelectionChange, showAvailability: true })),
+        renderCTA?.()));
+}

package/dist/components/product-page/ProductRecommendations.d.ts

@@ -0,0 +1,21 @@
+/**
+ * ProductRecommendations – related / frequently bought (primitive)
+ *
+ * Renders a section of recommended items (generic ItemGrid or product list).
+ * Pass items and onItemClick; or wrap SectionSearchProvider with preset query for "related".
+ * For use on individual product page.
+ */
+import React from 'react';
+import type { GenericItem } from '../suggestions-primitives/ItemCard';
+export interface ProductRecommendationsProps {
+    title?: string;
+    items: GenericItem[] | unknown[];
+    onItemClick?: (item: unknown, index: number) => void;
+    maxItems?: number;
+    columns?: number;
+    className?: string;
+    style?: React.CSSProperties;
+    renderItem?: (item: unknown, index: number) => React.ReactNode;
+}
+export declare function ProductRecommendations({ title, items, onItemClick, maxItems, columns, className, style, renderItem, }: ProductRecommendationsProps): React.JSX.Element | null;
+//# sourceMappingURL=ProductRecommendations.d.ts.map

package/dist/components/product-page/ProductRecommendations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductRecommendations.d.ts","sourceRoot":"","sources":["../../../src/components/product-page/ProductRecommendations.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CAChE;AAED,wBAAgB,sBAAsB,CAAC,EACrC,KAA2B,EAC3B,KAAK,EACL,WAAW,EACX,QAAY,EACZ,OAAW,EACX,SAAS,EACT,KAAK,EACL,UAAU,GACX,EAAE,2BAA2B,4BAiB7B"}

package/dist/components/product-page/ProductRecommendations.js

@@ -0,0 +1,17 @@
+/**
+ * ProductRecommendations – related / frequently bought (primitive)
+ *
+ * Renders a section of recommended items (generic ItemGrid or product list).
+ * Pass items and onItemClick; or wrap SectionSearchProvider with preset query for "related".
+ * For use on individual product page.
+ */
+import React from 'react';
+import { clsx } from 'clsx';
+import { ItemGrid } from '../suggestions-primitives/ItemGrid';
+export function ProductRecommendations({ title = 'You may also like', items, onItemClick, maxItems = 6, columns = 3, className, style, renderItem, }) {
+    if (!items?.length)
+        return null;
+    return (React.createElement("div", { className: clsx('seekora-product-recommendations', className), style: style },
+        React.createElement("h2", { className: "seekora-product-recommendations-title", style: { fontSize: '1rem', fontWeight: 600, marginBottom: 12 } }, title),
+        React.createElement(ItemGrid, { items: items, maxItems: maxItems, columns: columns, onItemClick: onItemClick, renderItem: renderItem })));
+}

package/dist/components/product-page/index.d.ts

@@ -0,0 +1,4 @@
+export { ProductGallery, type ProductGalleryProps } from './ProductGallery';
+export { ProductInfo, type ProductInfoProps } from './ProductInfo';
+export { ProductRecommendations, type ProductRecommendationsProps } from './ProductRecommendations';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/product-page/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/product-page/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,KAAK,2BAA2B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/components/product-page/index.js

@@ -0,0 +1,3 @@
+export { ProductGallery } from './ProductGallery';
+export { ProductInfo } from './ProductInfo';
+export { ProductRecommendations } from './ProductRecommendations';

package/dist/components/section-primitives/SectionError.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SectionError – error state for section (primitive)
+ */
+import React from 'react';
+export interface SectionErrorProps {
+    className?: string;
+    style?: React.CSSProperties;
+    render?: (error: Error) => React.ReactNode;
+}
+export declare function SectionError({ className, style, render }: SectionErrorProps): React.JSX.Element | null;
+//# sourceMappingURL=SectionError.d.ts.map

package/dist/components/section-primitives/SectionError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionError.d.ts","sourceRoot":"","sources":["../../../src/components/section-primitives/SectionError.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;CAC5C;AAED,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,4BAS3E"}

package/dist/components/section-primitives/SectionError.js

@@ -0,0 +1,13 @@
+/**
+ * SectionError – error state for section (primitive)
+ */
+import React from 'react';
+import { useSectionSearchContext } from './SectionSearchContext';
+export function SectionError({ className, style, render }) {
+    const { error } = useSectionSearchContext();
+    if (!error)
+        return null;
+    if (render)
+        return React.createElement(React.Fragment, null, render(error));
+    return (React.createElement("div", { className: className, style: { padding: 16, color: 'var(--seekora-error,#dc2626)', fontSize: '0.875rem', ...style } }, error.message));
+}

package/dist/components/section-primitives/SectionItemGrid.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SectionItemGrid – generic grid of items from SectionSearchProvider (primitive)
+ */
+import React from 'react';
+export interface SectionItemGridProps {
+    columns?: number;
+    maxItems?: number;
+    className?: string;
+    style?: React.CSSProperties;
+    getItemId?: (item: unknown) => string;
+    getItemTitle?: (item: unknown) => string;
+    getItemImage?: (item: unknown) => string | undefined;
+    getItemDescription?: (item: unknown) => string | undefined;
+    getItemUrl?: (item: unknown) => string | undefined;
+    renderItem?: (item: unknown, index: number) => React.ReactNode;
+}
+export declare function SectionItemGrid({ columns, maxItems, className, style, getItemId, getItemTitle, getItemImage, getItemDescription, getItemUrl, renderItem, }: SectionItemGridProps): React.JSX.Element;
+//# sourceMappingURL=SectionItemGrid.d.ts.map

package/dist/components/section-primitives/SectionItemGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionItemGrid.d.ts","sourceRoot":"","sources":["../../../src/components/section-primitives/SectionItemGrid.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,CAAC;IACzC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACrD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;IACnD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;CAChE;AAED,wBAAgB,eAAe,CAAC,EAC9B,OAAW,EACX,QAAa,EACb,SAAS,EACT,KAAK,EACL,SAA8E,EAC9E,YAAyE,EACzE,YAAmE,EACnE,kBAAqF,EACrF,UAA6D,EAC7D,UAAU,GACX,EAAE,oBAAoB,qBAsBtB"}

package/dist/components/section-primitives/SectionItemGrid.js

@@ -0,0 +1,14 @@
+/**
+ * SectionItemGrid – generic grid of items from SectionSearchProvider (primitive)
+ */
+import React from 'react';
+import { useSectionSearchContext } from './SectionSearchContext';
+import { ItemGrid } from '../suggestions-primitives/ItemGrid';
+import { SectionError } from './SectionError';
+export function SectionItemGrid({ columns = 4, maxItems = 12, className, style, getItemId = (i) => i.id ?? String(i?.objectID ?? ''), getItemTitle = (i) => i.title ?? i?.title ?? '', getItemImage = (i) => i.image ?? i?.image, getItemDescription = (i) => i.description ?? i?.description, getItemUrl = (i) => i.url ?? i?.url, renderItem, }) {
+    const { items, loading, error, trackClick } = useSectionSearchContext();
+    if (error)
+        return React.createElement(SectionError, { className: className, style: style });
+    // When loading with previous items, show them (no loading screen)
+    return (React.createElement(ItemGrid, { items: items, maxItems: maxItems, columns: columns, className: className, style: style, getItemId: getItemId, getItemTitle: getItemTitle, getItemImage: getItemImage, getItemDescription: getItemDescription, getItemUrl: getItemUrl, renderItem: renderItem, onItemClick: (item, index) => trackClick(item, index) }));
+}

package/dist/components/section-primitives/SectionLoading.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SectionLoading – loading state for section (primitive)
+ */
+import React from 'react';
+export interface SectionLoadingProps {
+    className?: string;
+    style?: React.CSSProperties;
+    text?: string;
+}
+export declare function SectionLoading({ className, style, text }: SectionLoadingProps): React.JSX.Element | null;
+//# sourceMappingURL=SectionLoading.d.ts.map

package/dist/components/section-primitives/SectionLoading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionLoading.d.ts","sourceRoot":"","sources":["../../../src/components/section-primitives/SectionLoading.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,cAAc,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,IAAmB,EAAE,EAAE,mBAAmB,4BAQ5F"}

package/dist/components/section-primitives/SectionLoading.js

@@ -0,0 +1,11 @@
+/**
+ * SectionLoading – loading state for section (primitive)
+ */
+import React from 'react';
+import { useSectionSearchContext } from './SectionSearchContext';
+export function SectionLoading({ className, style, text = 'Loading...' }) {
+    const { loading } = useSectionSearchContext();
+    if (!loading)
+        return null;
+    return (React.createElement("div", { className: className, style: { padding: 16, color: 'var(--seekora-text-secondary)', fontSize: '0.875rem', ...style } }, text));
+}

package/dist/components/section-primitives/SectionSearchContext.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SectionSearchContext – preset query/filter section state
+ *
+ * For menus, sidebar, front-page blocks. Independent of main search state.
+ */
+import React from 'react';
+export interface SectionSearchContextValue {
+    items: unknown[];
+    loading: boolean;
+    error: Error | null;
+    totalCount: number;
+    sectionId?: string;
+    trackClick: (item: unknown, position: number) => void;
+}
+export declare const SectionSearchContext: React.Context<SectionSearchContextValue | null>;
+export declare function useSectionSearchContext(): SectionSearchContextValue;
+//# sourceMappingURL=SectionSearchContext.d.ts.map

package/dist/components/section-primitives/SectionSearchContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionSearchContext.d.ts","sourceRoot":"","sources":["../../../src/components/section-primitives/SectionSearchContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAoC,MAAM,OAAO,CAAC;AAGzD,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,oBAAoB,iDAAwD,CAAC;AAE1F,wBAAgB,uBAAuB,IAAI,yBAAyB,CAQnE"}

package/dist/components/section-primitives/SectionSearchContext.js

@@ -0,0 +1,17 @@
+/**
+ * SectionSearchContext – preset query/filter section state
+ *
+ * For menus, sidebar, front-page blocks. Independent of main search state.
+ */
+import { createContext, useContext } from 'react';
+import { log } from '@seekora-ai/ui-sdk-core';
+export const SectionSearchContext = createContext(null);
+export function useSectionSearchContext() {
+    const context = useContext(SectionSearchContext);
+    if (!context) {
+        const error = new Error('useSectionSearchContext must be used within a SectionSearchProvider');
+        log.error('SectionSearchContext: not available', { error: error.message });
+        throw error;
+    }
+    return context;
+}

package/dist/components/section-primitives/SectionSearchProvider.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SectionSearchProvider – preset query + filter section
+ *
+ * Runs client.search(query, { refinements, hitsPerPage, sortBy }) on mount and when
+ * query/filters change. Does not use global SearchStateManager. Use for menus,
+ * sidebar, front-page blocks (e.g. "New arrivals", "On sale").
+ */
+import React from 'react';
+export interface RefinementInput {
+    field: string;
+    value: string;
+}
+export interface SectionSearchProviderProps {
+    children: React.ReactNode;
+    query: string;
+    refinements?: RefinementInput[];
+    maxItems?: number;
+    sortBy?: string;
+    enabled?: boolean;
+    sectionId?: string;
+    /** Additional search options merged into the request (e.g. { widget_mode: false }). */
+    searchOptions?: Record<string, unknown>;
+}
+export declare function SectionSearchProvider({ children, query, refinements, maxItems, sortBy, enabled, sectionId, searchOptions, }: SectionSearchProviderProps): React.JSX.Element;
+//# sourceMappingURL=SectionSearchProvider.d.ts.map

package/dist/components/section-primitives/SectionSearchProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SectionSearchProvider.d.ts","sourceRoot":"","sources":["../../../src/components/section-primitives/SectionSearchProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAoD,MAAM,OAAO,CAAC;AAIzE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAsBD,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,KAAK,EACL,WAAgB,EAChB,QAAa,EACb,MAAM,EACN,OAAc,EACd,SAAS,EACT,aAAa,GACd,EAAE,0BAA0B,qBAiF5B"}

package/dist/components/section-primitives/SectionSearchProvider.js

@@ -0,0 +1,106 @@
+/**
+ * SectionSearchProvider – preset query + filter section
+ *
+ * Runs client.search(query, { refinements, hitsPerPage, sortBy }) on mount and when
+ * query/filters change. Does not use global SearchStateManager. Use for menus,
+ * sidebar, front-page blocks (e.g. "New arrivals", "On sale").
+ */
+import React, { useState, useEffect, useCallback, useMemo } from 'react';
+import { useSearchContext } from '../SearchProvider';
+import { SectionSearchContext } from './SectionSearchContext';
+function extractItems(response) {
+    if (!response)
+        return [];
+    if (Array.isArray(response.results))
+        return response.results;
+    if (Array.isArray(response.hits))
+        return response.hits;
+    const data = response.data;
+    if (data && Array.isArray(data.results))
+        return data.results;
+    if (data && Array.isArray(data.data))
+        return data.data;
+    return [];
+}
+function extractTotal(response) {
+    if (!response)
+        return 0;
+    const n = response.totalResults ?? response.total ?? response.total_results;
+    if (typeof n === 'number')
+        return n;
+    const data = response.data;
+    if (data?.total_results != null)
+        return Number(data.total_results);
+    if (data?.data?.total_results != null)
+        return Number(data.data.total_results);
+    return 0;
+}
+export function SectionSearchProvider({ children, query, refinements = [], maxItems = 12, sortBy, enabled = true, sectionId, searchOptions, }) {
+    const { client } = useSearchContext();
+    const [items, setItems] = useState([]);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [totalCount, setTotalCount] = useState(0);
+    useEffect(() => {
+        if (!enabled || !client?.search) {
+            setItems([]);
+            setLoading(false);
+            setError(null);
+            setTotalCount(0);
+            return;
+        }
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        const options = {
+            ...searchOptions,
+            per_page: maxItems,
+            page: 1,
+        };
+        if (sortBy)
+            options.sort_by = sortBy;
+        if (refinements.length > 0) {
+            options.filter_by = refinements.map((r) => `${r.field}:${r.value}`).join(',');
+        }
+        client
+            .search(query, options)
+            .then((response) => {
+            if (cancelled)
+                return;
+            setItems(extractItems(response));
+            setTotalCount(extractTotal(response));
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (cancelled)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setItems([]);
+            setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [client, enabled, query, maxItems, sortBy, refinements, searchOptions]);
+    const trackClick = useCallback((item, position) => {
+        if (!client?.trackEvent)
+            return;
+        const id = item?.id ?? item?.objectID;
+        client.trackEvent({
+            event_name: 'section_result_click',
+            clicked_item_id: id,
+            position,
+            section: sectionId,
+            metadata: { section_id: sectionId },
+        }, undefined);
+    }, [client, sectionId]);
+    const value = useMemo(() => ({
+        items,
+        loading,
+        error,
+        totalCount,
+        sectionId,
+        trackClick,
+    }), [items, loading, error, totalCount, sectionId, trackClick]);
+    return React.createElement(SectionSearchContext.Provider, { value: value }, children);
+}

package/dist/components/section-primitives/index.d.ts

@@ -0,0 +1,5 @@
+export { SectionSearchProvider, type RefinementInput, type SectionSearchProviderProps } from './SectionSearchProvider';
+export { SectionSearchContext, useSectionSearchContext, type SectionSearchContextValue } from './SectionSearchContext';
+export { SectionItemGrid, type SectionItemGridProps } from './SectionItemGrid';
+export { SectionError, type SectionErrorProps } from './SectionError';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/section-primitives/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/section-primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACvH,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACvH,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/components/section-primitives/index.js

@@ -0,0 +1,4 @@
+export { SectionSearchProvider } from './SectionSearchProvider';
+export { SectionSearchContext, useSectionSearchContext } from './SectionSearchContext';
+export { SectionItemGrid } from './SectionItemGrid';
+export { SectionError } from './SectionError';

package/dist/components/suggestions/AmazonDropdown.d.ts

@@ -0,0 +1,30 @@
+/**
+ * AmazonDropdown - Amazon-style Search Suggestions
+ *
+ * Features:
+ * - Department/category scoping in search
+ * - Suggestions with category context
+ * - Product grid with images
+ * - "in Department" suffix for scoped searches
+ * - Clean, functional design
+ */
+import React from 'react';
+import type { BaseDropdownProps, DropdownRef } from './types';
+export interface AmazonDropdownProps extends BaseDropdownProps {
+    /** Show department scoping in suggestions */
+    showDepartments?: boolean;
+    /** Current department filter */
+    currentDepartment?: string;
+    /** Available departments */
+    departments?: Array<{
+        id: string;
+        label: string;
+    }>;
+    /** Show Prime badge */
+    showPrime?: boolean;
+    /** Prime icon URL */
+    primeIconUrl?: string;
+}
+export declare const AmazonDropdown: React.ForwardRefExoticComponent<AmazonDropdownProps & React.RefAttributes<DropdownRef>>;
+export default AmazonDropdown;
+//# sourceMappingURL=AmazonDropdown.d.ts.map

package/dist/components/suggestions/AmazonDropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmazonDropdown.d.ts","sourceRoot":"","sources":["../../../src/components/suggestions/AmazonDropdown.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAQN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAkU9D,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,uBAAuB;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qBAAqB;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,yFAsc1B,CAAC;AAEF,eAAe,cAAc,CAAC"}