@constructor-io/constructorio-ui-pia 2.10.3 → 2.11.0

package/lib/mjs/styles.css

@@ -1,5 +1,4 @@
 @import '@constructor-io/constructorio-ui-components/styles.css';
-@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;700&display=swap');
 @import './components/SuggestedQuestion/SuggestedQuestionStyles.css';
 @import './components/SuggestedQuestionsContainer/SuggestedQuestionsContainerStyles.css';
 @import './components/Input/InputStyles.css';
@@ -10,6 +9,7 @@
 @import './components/CioPia/CioPiaStyles.css';
 @import './components/ConversationHistory/ConversationHistoryStyles.css';
 @import './components/PiaConversation/PiaConversationStyles.css';
+@import './components/CioPiaRecs/CioPiaRecsStyles.css';
 
 .cio-pia-container {
   font-family: 'Inter', sans-serif;

package/lib/mjs/utils/classNames.js

@@ -0,0 +1,9 @@
+/**
+ * Joins class names, dropping the falsy ones, so a conditional class can be written inline.
+ *
+ * Deliberately not `clsx` or `classnames`: neither is a dependency of this package, and the copy of
+ * `clsx` in the tree belongs to `@constructor-io/constructorio-ui-components`, which is a peer
+ * dependency - importing it here would work locally and break in a consumer that hoists
+ * differently. Worth revisiting if this ever needs to accept objects or nested arrays.
+ */
+export const cx = (...parts) => parts.filter(Boolean).join(' ');

package/lib/mjs/utils/recs.js

@@ -0,0 +1,9 @@
+import { translate } from './translate';
+import { RECS_REFINEMENT_LABEL } from '../constants';
+/**
+ * The line that introduces the refinement options. Prefers the prompt the API sent, so our
+ * copy and theirs cannot drift.
+ */
+export function resolveRefinementQuestion(refinement, translations) {
+    return refinement?.question || translate(RECS_REFINEMENT_LABEL, translations);
+}

package/lib/mjs/utils/translate.js

@@ -1,4 +1,4 @@
-import { DISCLAIMER_TEXT } from '../constants';
+import { DISCLAIMER_TEXT, RECS_FALLBACK_TITLE, RECS_INPUT_PLACEHOLDER, RECS_LOADING_TITLE, RECS_REFINEMENT_LABEL, RECS_UNSUPPORTED_REQUEST, } from '../constants';
 const defaultTranslations = {
     'Any questions about this product?': 'Any questions about this product?',
     'Ask anything': 'Ask anything',
@@ -8,6 +8,11 @@ const defaultTranslations = {
     'Learn More.': 'Learn More.',
     'Ask about this product': 'Ask about this product',
     'Add to Cart': 'Add to Cart',
+    [RECS_LOADING_TITLE]: RECS_LOADING_TITLE,
+    [RECS_FALLBACK_TITLE]: RECS_FALLBACK_TITLE,
+    [RECS_UNSUPPORTED_REQUEST]: RECS_UNSUPPORTED_REQUEST,
+    [RECS_REFINEMENT_LABEL]: RECS_REFINEMENT_LABEL,
+    [RECS_INPUT_PLACEHOLDER]: RECS_INPUT_PLACEHOLDER,
 };
 /**
  * Translates a word using the provided translations object.

package/lib/mjs/version.js

@@ -1 +1 @@
-export default '2.10.3';
+export default '2.11.0';

package/lib/types/components/CioPia/CioPia.d.ts

@@ -1,38 +1,3 @@
 import React from 'react';
-import { IncludeComponentOverrides, IncludeRenderProps } from '@constructor-io/constructorio-ui-components';
-import MockConstructorIOClient from '../../hooks/mocks/MockConstructorIOClient';
-import { CioPiaRenderProps, CioPiaComponentOverrides, Callbacks, CioPiaDisplayConfigs, Translations, SuggestedQuestionsParameters, Formatters, ProductCardDisplayProps } from '../../types';
-export interface CioPiaProps extends IncludeRenderProps<CioPiaRenderProps>, IncludeComponentOverrides<CioPiaComponentOverrides> {
-    /** Your Constructor.io API key. */
-    apiKey: string;
-    /** The product item ID to fetch insights for. */
-    itemId: string;
-    /** The product display name, sent with tracking events. */
-    itemName: string;
-    /** Thread ID for conversation context. Must be a valid UUID (e.g., "550e8400-e29b-41d4-a716-446655440000"). */
-    threadId?: string;
-    /** Optional variation ID for the product. */
-    variationId?: string;
-    /** Optional Constructor.io client instance. If not provided, one will be created internally. */
-    cioClient?: MockConstructorIOClient;
-    /** Display configuration options (mode, type, showFeedback, etc.). */
-    displayConfigs?: CioPiaDisplayConfigs;
-    /** Callback handlers for user interactions (onQuestionSubmit, onProductCardClick, onFeedback). */
-    callbacks?: Callbacks;
-    /** Custom component overrides via reactNode or render props functions. */
-    componentOverrides?: CioPiaComponentOverrides;
-    /** Formatter functions for transforming data before display. */
-    formatters?: Formatters;
-    /** Props forwarded to the ProductCard rendered inside the carousel. */
-    productCardProps?: ProductCardDisplayProps;
-    /** UI string translations for internationalization. */
-    translations?: Translations;
-    /** Parameters for the suggested questions request. */
-    suggestedQuestionsParameters?: SuggestedQuestionsParameters;
-    /**
-     * Extra query parameters appended to PIA API requests (e.g. `ef-*` test cell params).
-     * Define outside the component or wrap with useMemo to avoid unnecessary re-renders.
-     */
-    parameters?: Record<string, string | number | boolean>;
-}
+import type { CioPiaProps } from './types';
 export default function CioPia(props: CioPiaProps): React.JSX.Element;

package/lib/types/components/CioPia/CioPiaQna.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { CioPiaProps } from './types';
+/** The question-and-answer experience: `mode: 'default'`, `mode: 'conversation'`, and the modal. */
+export default function CioPiaQna(props: CioPiaProps): React.JSX.Element;

package/lib/types/components/CioPia/index.d.ts

@@ -1,3 +1,4 @@
 import CioPia from './CioPia';
 export * from './CioPia';
+export type { CioPiaProps } from './types';
 export default CioPia;

package/lib/types/components/CioPia/types.d.ts

@@ -0,0 +1,40 @@
+import { IncludeComponentOverrides, IncludeRenderProps } from '@constructor-io/constructorio-ui-components';
+import MockConstructorIOClient from '../../hooks/mocks/MockConstructorIOClient';
+import { CioPiaRenderProps, CioPiaComponentOverrides, Callbacks, CioPiaDisplayConfigs, CioPiaTrackingConfigs, Translations, SuggestedQuestionsParameters, RecsPodParameters, Formatters, ProductCardDisplayProps } from '../../types';
+export interface CioPiaProps extends IncludeRenderProps<CioPiaRenderProps>, IncludeComponentOverrides<CioPiaComponentOverrides> {
+    /** Your Constructor.io API key. */
+    apiKey: string;
+    /** The product item ID to fetch insights for. */
+    itemId: string;
+    /** The product display name, sent with tracking events. */
+    itemName: string;
+    /** Thread ID for conversation context. Must be a valid UUID (e.g., "550e8400-e29b-41d4-a716-446655440000"). */
+    threadId?: string;
+    /** Optional variation ID for the product. */
+    variationId?: string;
+    /** Optional Constructor.io client instance. If not provided, one will be created internally. */
+    cioClient?: MockConstructorIOClient;
+    /** Display configuration options (mode, type, showFeedback, etc.). */
+    displayConfigs?: CioPiaDisplayConfigs;
+    /** Tracking configuration options (viewThreshold, etc.). */
+    trackingConfigs?: CioPiaTrackingConfigs;
+    /** Callback handlers for user interactions (onQuestionSubmit, onProductCardClick, onFeedback). */
+    callbacks?: Callbacks;
+    /** Custom component overrides via reactNode or render props functions. */
+    componentOverrides?: CioPiaComponentOverrides;
+    /** Formatter functions for transforming data before display. */
+    formatters?: Formatters;
+    /** Props forwarded to the ProductCard rendered inside the carousel. */
+    productCardProps?: ProductCardDisplayProps;
+    /** UI string translations for internationalization. */
+    translations?: Translations;
+    /** Parameters for the suggested questions request. */
+    suggestedQuestionsParameters?: SuggestedQuestionsParameters;
+    /** Parameters for the recommendations request, used by `mode: 'recommendations'`. */
+    recsPodParameters?: RecsPodParameters;
+    /**
+     * Extra query parameters appended to PIA API requests (e.g. `ef-*` test cell params).
+     * Define outside the component or wrap with useMemo to avoid unnecessary re-renders.
+     */
+    parameters?: Record<string, string | number | boolean>;
+}

package/lib/types/components/CioPiaRecs/CioPiaRecs.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import type { CioPiaProps } from '../CioPia/types';
+/**
+ * A pod of AI-curated product suggestions: a personalized title, a row of products, and short
+ * options for narrowing them down. It asks no questions and makes no Q&A requests, so a retailer
+ * can use it on its own.
+ *
+ * Renders nothing at all once a request has settled with no products, so whatever the retailer
+ * already had in that slot shows through instead of an empty shell. That is the default: a caller
+ * that supplied its own root — `children` or `componentOverrides.reactNode` — still gets it in that
+ * state, with `error` available, and decides what belongs there.
+ */
+export default function CioPiaRecs(props: CioPiaProps): React.JSX.Element | null;

package/lib/types/components/CioPiaRecs/RecsCarouselSkeleton.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import { ComponentOverrideProps } from '@constructor-io/constructorio-ui-components';
+import { LoadingRenderProps } from '../../types';
+interface RecsCarouselSkeletonProps {
+    /** How many cards to draw. Defaults to the widest band the carousel lays out. */
+    count?: number;
+    componentOverride?: ComponentOverrideProps<LoadingRenderProps>;
+}
+/**
+ * The product row, greyed out. It uses the real carousel rather than a set of measurements copied
+ * out of the package, so its padding, its gaps, how many cards it fits at the current width and its
+ * arrows are all right by construction. Matching the real heights is what keeps the page from
+ * jumping when the data lands.
+ */
+export default function RecsCarouselSkeleton({ count, componentOverride, }: RecsCarouselSkeletonProps): React.JSX.Element;
+export {};

package/lib/types/components/CioPiaRecs/RecsOptionsSkeleton.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+interface RecsOptionsSkeletonProps {
+    /** How many pills to draw. Defaults to what the row usually holds. */
+    count?: number;
+}
+/**
+ * The refinement options, greyed out. Matching the real height is what keeps the row from
+ * collapsing and shifting the page when the options land.
+ *
+ * Takes no override, the same way `SuggestedQuestionsSkeleton` takes none: `componentOverrides.
+ * loading` stands in for the band above this one, and a caller who replaced it keeps these pills
+ * underneath, exactly as a caller who replaces the answer skeleton in question-and-answer keeps the
+ * question pills under theirs.
+ */
+export default function RecsOptionsSkeleton({ count }: RecsOptionsSkeletonProps): React.JSX.Element;
+export {};

package/lib/types/components/CioPiaRecs/RecsPodRefinement.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { CioPiaComponentOverrides, RecsRefinement, Translations } from '../../types';
+interface RecsPodRefinementProps {
+    refinement: RecsRefinement | null;
+    isLoading: boolean;
+    /** Message for a value the shopper submitted that came back rejected. */
+    inputError: string | null;
+    showInput: boolean;
+    translations?: Translations;
+    componentOverrides?: CioPiaComponentOverrides;
+    onRefine: (text: string) => void;
+    onSubmit: (value: string) => void;
+    onInputFocus: () => void;
+}
+/**
+ * The row under the products: a prompt line, the short options the API suggested, and a box for
+ * anything it did not think of. The prompt line is held still while the rest reloads, so the row
+ * never changes height under the shopper's cursor.
+ */
+export default function RecsPodRefinement({ refinement, isLoading, inputError, showInput, translations, componentOverrides, onRefine, onSubmit, onInputFocus, }: RecsPodRefinementProps): React.JSX.Element;
+export {};

package/lib/types/components/Input/Input.d.ts

@@ -10,6 +10,14 @@ interface InputProps {
     onFocus?: () => void;
     translations?: Translations;
     componentOverride?: ComponentOverrideProps<InputRenderProps>;
+    error?: string;
+    placeholderKey?: string;
+    /**
+     * Render the Send button after the field.
+     *
+     * @default true
+     */
+    showSendButton?: boolean;
 }
-declare function Input({ value: providedValue, placeholder, disabled, onSubmit, onFocus, translations, componentOverride, }: InputProps): React.JSX.Element;
+declare function Input({ value: providedValue, placeholder, disabled, onSubmit, onFocus, translations, componentOverride, error, placeholderKey, showSendButton, }: InputProps): React.JSX.Element;
 export default Input;

package/lib/types/components/SuggestedQuestion/SuggestedQuestion.d.ts

@@ -1,7 +1,9 @@
-import React from 'react';
+import React, { ReactNode } from 'react';
 interface SuggestedQuestionProps {
     question: string;
     onClick?: () => void;
+    /** Replaces the leading icon. Defaults to a question mark. */
+    icon?: ReactNode;
 }
-declare function SuggestedQuestion({ question, onClick }: SuggestedQuestionProps): React.JSX.Element;
+declare function SuggestedQuestion({ question, onClick, icon }: SuggestedQuestionProps): React.JSX.Element;
 export default SuggestedQuestion;

package/lib/types/constants.d.ts

@@ -7,3 +7,14 @@ export declare const MOCK_QUESTIONS: {
     value: string;
 }[];
 export declare const DISCLAIMER_TEXT = "AI-generated answers aim to help, but they may occasionally miss details or be inaccurate. Double-check important information before purchasing.";
+/**
+ * Recommendations pod strings the API cannot supply, because in these states there is either
+ * no response yet or no usable response at all. Everything else the pod shows comes from the
+ * API. All five are `Translations` keys, so reference the constants instead of retyping the
+ * literals - a mistyped key falls back to itself with no warning.
+ */
+export declare const RECS_LOADING_TITLE = "Adapting recommendations to your preference";
+export declare const RECS_FALLBACK_TITLE = "Best selling products";
+export declare const RECS_UNSUPPORTED_REQUEST = "Unsupported request, try a different feature.";
+export declare const RECS_REFINEMENT_LABEL = "Not what you're looking for? Try:";
+export declare const RECS_INPUT_PLACEHOLDER = "Describe something else...";

package/lib/types/hooks/mocks/agent.d.ts

@@ -1,10 +1,23 @@
 import { ConstructorClientOptions } from '@constructor-io/constructorio-client-javascript';
 import { QuestionResponse, GetSuggestedQuestionsProps, GetAnswerResultsStreamProps, GetAnswerResultsProps, GetAnswerResultsResponse } from './types';
+import { GetRecsProps, RecsResult } from '../../types';
 declare class MockAgent {
     options: ConstructorClientOptions;
     constructor(options: ConstructorClientOptions);
     getSuggestedQuestions({ itemId, variationId, threadId, parameters, requestParameters, }: GetSuggestedQuestionsProps): Promise<QuestionResponse>;
     getAnswerResults({ itemId, variationId, threadId, question, parameters, }: GetAnswerResultsProps): Promise<GetAnswerResultsResponse>;
+    /**
+     * Fetches one set of recommendations, in the shape the pod renders.
+     *
+     * Recommendations are not available yet: there is no endpoint to ask, so nothing is requested and
+     * an empty result is returned. The pod renders nothing in that state, which leaves whatever the
+     * retailer already had in that slot showing through. Supply a `cioClient` with your own
+     * `agent.getRecs` to drive the pod from your own data in the meantime.
+     *
+     * `props` is still declared, because it is the contract a caller's own `getRecs` implements and
+     * `useRecsPod` passes it - there is simply nothing here to send it to yet.
+     */
+    getRecs(props: GetRecsProps): Promise<RecsResult>;
     getAnswerResultsStream({ itemId, threadId, variationId, question, parameters, onStart, onMessage, onEnd, }: GetAnswerResultsStreamProps): Promise<void>;
 }
 export default MockAgent;

package/lib/types/hooks/usePiaClient.d.ts

@@ -0,0 +1,17 @@
+import MockConstructorIOClient from './mocks/MockConstructorIOClient';
+export interface UsePiaClientProps {
+    apiKey: string;
+    /** Thread ID for conversation context. Must be a valid UUID. One is generated when absent. */
+    threadId?: string;
+    cioClient?: MockConstructorIOClient;
+}
+export interface UsePiaClientReturn {
+    cioClient: MockConstructorIOClient;
+    threadId: string;
+}
+/**
+ * Resolves the client and thread ID every mode needs: the caller's client when they supplied
+ * one, otherwise a client built from the API key, plus a generated thread ID that stays stable
+ * for the life of the component.
+ */
+export default function usePiaClient({ apiKey, threadId: providedThreadId, cioClient: providedClient, }: UsePiaClientProps): UsePiaClientReturn;

package/lib/types/hooks/useRecsPod.d.ts

@@ -0,0 +1,52 @@
+import MockConstructorIOClient from './mocks/MockConstructorIOClient';
+import { Formatters, Item, RecsPodParameters, RecsRefinement, Translations } from '../types';
+/**
+ * What the shopper did to ask for this refinement.
+ *
+ * Worth distinguishing because a rejected request is only the shopper's business when the text
+ * came from them. An option is a label the API itself suggested, so a rejection there is ours to
+ * answer for, not something to flag under their input.
+ */
+export type RefinementSource = 'option' | 'input';
+export interface UseRecsPodProps {
+    itemId: string;
+    variationId?: string;
+    threadId?: string;
+    cioClient?: MockConstructorIOClient;
+    parameters?: RecsPodParameters;
+    formatImageUrl?: Formatters['formatImageUrl'];
+    translations?: Translations;
+}
+export interface UseRecsPodReturn {
+    /** The title to show right now, already resolved for the current state. */
+    title: string;
+    /** The products to render, or `null` when there are none. Never an empty array. */
+    items: Array<Item> | null;
+    refinement: RecsRefinement | null;
+    /** True while a request is in flight. */
+    isLoading: boolean;
+    /**
+     * The failure behind the fallback title, for callers rendering their own error handling.
+     * Only set for an outright failure: a degraded response (`status: 'partial'`) shows the fallback
+     * title with `error` still null, because that response arrived and its products are usable.
+     */
+    error: Error | null;
+    /** Message to show under the input when the text the shopper sent was rejected. */
+    inputError: string | null;
+    /** The text behind what is currently on screen. Empty when nothing has been refined. */
+    lastShopperInput: string;
+    /**
+     * Fetches again, narrowed by `text`. Used by both the options and the free-text input, and
+     * `source` is how a rejected request finds the right place to be reported.
+     */
+    refine: (text: string, source: RefinementSource) => void;
+}
+/**
+ * Owns everything a recommendations pod shows: one request on mount, one on every refinement,
+ * and the title that belongs to whichever of those is happening right now.
+ *
+ * The previous items are deliberately kept while a new request is in flight, so a refinement
+ * swaps the products without collapsing the row they sit in. The title is the one thing that does
+ * change, so the shopper can see the pod reacting to what they asked for.
+ */
+export default function useRecsPod({ itemId, variationId, threadId, cioClient, parameters, formatImageUrl, translations, }: UseRecsPodProps): UseRecsPodReturn;

package/lib/types/hooks/useViewportTracking.d.ts

@@ -3,8 +3,9 @@ import { UseTrackingReturn } from './useTracking';
 export interface UseViewportTrackingProps {
     tracking: UseTrackingReturn;
     questions: Question[];
+    viewThreshold?: number;
 }
 export interface UseViewportTrackingReturn {
     containerRef: (node: HTMLDivElement | null) => void;
 }
-export default function useViewportTracking({ tracking, questions, }: UseViewportTrackingProps): UseViewportTrackingReturn;
+export default function useViewportTracking({ tracking, questions, viewThreshold, }: UseViewportTrackingProps): UseViewportTrackingReturn;

package/lib/types/types.d.ts

@@ -25,9 +25,16 @@ export interface CioPiaProviderProps {
     threadId?: string;
     cioClient?: Nullable<MockConstructorIOClient>;
 }
-export type CioPiaMode = 'default' | 'conversation';
+export type CioPiaMode = 'default' | 'conversation' | 'recommendations';
 export type CioPiaType = 'inline' | 'modal';
 export type DisclaimerPosition = 'top' | 'bottom';
+export type CioPiaTrackingConfigs = {
+    /**
+     * Fraction of the container (0–1) that must be visible before the
+     * `product_insights_agent.view` event fires. Defaults to `0.5`.
+     */
+    viewThreshold?: number;
+};
 export type CioPiaDisplayConfigs = {
     learnMoreUrl?: string;
     showFeedback?: boolean;
@@ -60,6 +67,16 @@ export type Translations = {
     'Learn More.'?: string;
     'Ask about this product'?: string;
     'Add to Cart'?: string;
+    /** Recommendations pod title shown while a request is in flight. */
+    'Adapting recommendations to your preference'?: string;
+    /** Recommendations pod title shown when a request fails or comes back degraded. */
+    'Best selling products'?: string;
+    /** Shown under the recommendations pod input when the request was rejected as unsuitable. */
+    'Unsupported request, try a different feature.'?: string;
+    /** Introduces the recommendations pod refinement options when the API sends no prompt of its own. */
+    "Not what you're looking for? Try:"?: string;
+    /** Placeholder for the recommendations pod refinement input. */
+    'Describe something else...'?: string;
 };
 export type QuestionSource = 'user' | 'suggestion';
 export interface PiaCallbackContext {
@@ -115,6 +132,62 @@ export interface ConversationEntry {
     threadId?: string;
     qnaResultId?: string;
 }
+/** Which kind of recommendations to fetch. */
+export type RecsStrategy = 'complementary_items' | 'alternative_items' | 'bestsellers' | 'bundles' | 'buy_it_again' | 'recently_viewed_items' | 'visually_similar_items';
+/** A prompt line plus the short labels the shopper can pick from to narrow the results. */
+export interface RecsRefinement {
+    /** Introduces the options. Falls back to a translatable default when absent. */
+    question?: string;
+    options: string[];
+}
+/** One recommendations response, in the shape the pod renders. */
+export interface RecsResult {
+    title: string;
+    items: Item[] | null;
+    refinement: RecsRefinement | null;
+    resultId?: string;
+    threadId?: string;
+    /** `'partial'` means the response is degraded, but any items it carries are still usable. */
+    status?: 'complete' | 'partial';
+}
+export interface RecsPodParameters {
+    /**
+     * Which kind of recommendations to fetch. Inert until the recommendations endpoint ships: it is
+     * forwarded to `agent.getRecs`, which has nothing to send it to yet, so only a caller's own
+     * `getRecs` acts on it today.
+     *
+     * @default 'complementary_items'
+     */
+    strategy?: RecsStrategy;
+    /** Last-resort title, used when the API returns items but no title of its own. */
+    defaultTitle?: string;
+    /**
+     * Render the free-text refinement input next to the refinement options.
+     *
+     * @default true
+     */
+    showInput?: boolean;
+    /** How many products to request. */
+    numResults?: number;
+}
+/** Arguments for one recommendations request. */
+export interface GetRecsProps {
+    itemId: string;
+    variationId?: string;
+    /** Thread ID for conversation context. Must be a valid UUID. */
+    threadId?: string;
+    /** @default 'complementary_items' */
+    strategy?: RecsStrategy;
+    /** Free text the shopper submitted to narrow the results. Absent on the first request. */
+    shopperInput?: string;
+    numResults?: number;
+    /**
+     * Applied while the raw results are converted to Items. It lives on the request rather than
+     * in the component because the raw response shape is provisional, and keeping the conversion
+     * behind this one call is what makes the endpoint swappable later.
+     */
+    formatImageUrl?: Formatters['formatImageUrl'];
+}
 /**
  * Render props passed to CioPia children function
  */
@@ -155,6 +228,8 @@ export interface InputRenderProps {
     onSubmit: (value: string) => void;
     onFocus?: () => void;
     translations?: Translations;
+    /** Validation message for the value that was just submitted, when there is one. */
+    error?: string;
 }
 /**
  * Component overrides for CioPia.

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

@@ -0,0 +1,9 @@
+/**
+ * Joins class names, dropping the falsy ones, so a conditional class can be written inline.
+ *
+ * Deliberately not `clsx` or `classnames`: neither is a dependency of this package, and the copy of
+ * `clsx` in the tree belongs to `@constructor-io/constructorio-ui-components`, which is a peer
+ * dependency - importing it here would work locally and break in a consumer that hoists
+ * differently. Worth revisiting if this ever needs to accept objects or nested arrays.
+ */
+export declare const cx: (...parts: (string | false | null | undefined)[]) => string;

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

@@ -0,0 +1,6 @@
+import { RecsRefinement, Translations } from '../types';
+/**
+ * The line that introduces the refinement options. Prefers the prompt the API sent, so our
+ * copy and theirs cannot drift.
+ */
+export declare function resolveRefinementQuestion(refinement: RecsRefinement | null, translations?: Translations): string;

package/lib/types/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "2.10.3";
+declare const _default: "2.11.0";
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-ui-pia",
-  "version": "2.10.3",
+  "version": "2.11.0",
   "description": "Constructor.io AI Product Insights Agent UI library for web applications",
   "author": "Constructor.io Corporation",
   "license": "MIT",