randmarcomps 1.346.0 → 1.348.0

package/dist/randmarcomps.d.ts

@@ -127,10 +127,10 @@ declare interface AssistantChatProps {
 
 /**
  * A component that displays an animated AI icon and placeholder text while
- * fetching an insight from the Gemini API. It leverages the useGemini hook
- * to manage the entire data fetching and state management lifecycle.
+ * fetching an insight from the Gemini API. It can be displayed with or without
+ * a surrounding card style.
  */
-export declare function AssistantInsight({ prompt, smartAndSlow, thinkingPlaceholderText, }: AssistantInsightProps): JSX.Element;
+export declare function AssistantInsight({ prompt, smartAndSlow, thinkingPlaceholderText, withCard, }: AssistantInsightProps): JSX.Element;
 
 /**
  * Defines the props for the AssistantInsight component.
@@ -142,6 +142,8 @@ declare interface AssistantInsightProps {
     smartAndSlow?: boolean;
     /** Optional placeholder text to display while the AI is generating a response. */
     thinkingPlaceholderText?: string;
+    /** Determines whether the component is wrapped in a styled card. Defaults to true. */
+    withCard?: boolean;
 }
 
 export declare const Avatar: React_2.ForwardRefExoticComponent<Omit<AvatarPrimitive.AvatarProps & React_2.RefAttributes<HTMLSpanElement>, "ref"> & React_2.RefAttributes<HTMLSpanElement>>;
@@ -753,6 +755,17 @@ declare interface ResellerQualificationsCardProps {
     loading?: boolean;
 }
 
+/**
+ * Defines the number of grid columns for responsive breakpoints.
+ */
+declare type ResponsiveCols = {
+    base?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+};
+
 export declare function ReturnsTable({ applicationId, returns, loading }: ReturnsTableProps): JSX.Element;
 
 declare interface ReturnsTableProps {
@@ -806,6 +819,56 @@ export declare interface ScrollAreaProps extends React_2.ComponentPropsWithoutRe
 
 export declare const ScrollBar: React_2.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Manages the layout and states of a search results page. It handles loading,
+ * no results, and a two-column display for search results alongside an AI assistant.
+ */
+export declare const SearchPage: default_2.FC<SearchPageProps>;
+
+/**
+ * A generic, centralized component for displaying grouped search results in a grid.
+ * It display a responsive grid layout and leaves the rendering of individual items
+ * to the consuming application via the `renderItem` prop.
+ */
+export declare const SearchPageGrid: <T>({ results, groupBy, renderItem, }: SearchPageGridProps<T>) => JSX.Element;
+
+declare interface SearchPageGridProps<T> {
+    /**
+     * The raw array of search result items.
+     */
+    results: T[];
+    /**
+     * A function that takes the full results array and returns an object
+     * where keys are group titles and values are objects containing the
+     * items and an optional grid configuration for that group.
+     */
+    groupBy: (results: T[]) => Record<string, SearchPageResultGroup<T>>;
+    /**
+     * A function that receives a single item and its index, and returns
+     * the React component to render for that item.
+     */
+    renderItem: (item: T, index: number) => default_2.ReactNode;
+}
+
+declare interface SearchPageProps {
+    /** The search query string. */
+    query: string;
+    /** The array of search results to display. */
+    results: unknown[];
+    /** A flag to indicate when a search is in progress. */
+    isLoading: boolean;
+    /** The content to render when results are available, typically the results grid. */
+    children: default_2.ReactNode;
+}
+
+/**
+ * The expected structure for each group returned by the `groupBy` function.
+ */
+export declare interface SearchPageResultGroup<T> {
+    items: T[];
+    gridCols?: ResponsiveCols;
+}
+
 export declare const Select: React_2.FC<SelectPrimitive.SelectProps>;
 
 export declare const SelectContent: React_2.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React_2.RefAttributes<HTMLDivElement>, "ref"> & React_2.RefAttributes<HTMLDivElement>>;