instantsearch-ui-components 0.17.0 → 0.17.1

package/dist/cjs/components/autocomplete/AutocompleteIndex.js

@@ -18,6 +18,9 @@ function createAutocompleteIndexComponent(_ref) {
       getItemProps = userProps.getItemProps,
       _userProps$classNames = userProps.classNames,
       classNames = _userProps$classNames === void 0 ? {} : _userProps$classNames;
+    if (items.length === 0) {
+      return null;
+    }
     return createElement("div", {
       className: (0, _cx.cx)('ais-AutocompleteIndex', classNames.root)
     }, HeaderComponent && createElement("div", {

package/dist/cjs/components/index.js

@@ -113,6 +113,17 @@ Object.keys(_ChatPrompt).forEach(function (key) {
     }
   });
 });
+var _ChatPromptSuggestions = require("./chat/ChatPromptSuggestions");
+Object.keys(_ChatPromptSuggestions).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _ChatPromptSuggestions[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _ChatPromptSuggestions[key];
+    }
+  });
+});
 var _ChatToggleButton = require("./chat/ChatToggleButton");
 Object.keys(_ChatToggleButton).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;

package/dist/cjs/version.js

@@ -4,4 +4,4 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.default = void 0;
-var _default = exports.default = '0.17.0';
+var _default = exports.default = '0.17.1';

package/dist/es/components/autocomplete/AutocompleteIndex.d.ts

@@ -37,4 +37,4 @@ export type AutocompleteIndexClassNames = {
      */
     item: string | string[];
 };
-export declare function createAutocompleteIndexComponent({ createElement }: Renderer): (userProps: AutocompleteIndexProps) => JSX.Element;
+export declare function createAutocompleteIndexComponent({ createElement }: Renderer): (userProps: AutocompleteIndexProps) => JSX.Element | null;

package/dist/es/components/autocomplete/AutocompleteIndex.js

@@ -11,6 +11,9 @@ export function createAutocompleteIndexComponent(_ref) {
       getItemProps = userProps.getItemProps,
       _userProps$classNames = userProps.classNames,
       classNames = _userProps$classNames === void 0 ? {} : _userProps$classNames;
+    if (items.length === 0) {
+      return null;
+    }
     return createElement("div", {
       className: cx('ais-AutocompleteIndex', classNames.root)
     }, HeaderComponent && createElement("div", {

package/dist/es/components/chat/types.d.ts

@@ -1,12 +1,352 @@
-import type { AbstractChat, ChatInit, UIMessage } from 'ai';
 export type ChatStatus = 'ready' | 'submitted' | 'streaming' | 'error';
 export type ChatRole = 'data' | 'user' | 'assistant' | 'system';
+/**
+ * Provider metadata type for UI message parts.
+ */
+export type ProviderMetadata = Record<string, Record<string, unknown>>;
+/**
+ * A record of data types for data parts in UI messages.
+ */
+export type UIDataTypes = Record<string, unknown>;
+/**
+ * Tool input/output type definition.
+ */
+export type UITool = {
+    input: unknown;
+    output: unknown | undefined;
+};
+/**
+ * A record of UI tools.
+ */
+export type UITools = Record<string, UITool>;
+/**
+ * Helper type to get values of an object.
+ */
+type ValueOf<T> = T[keyof T];
+/**
+ * Deep partial type.
+ */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
+/**
+ * A text part of a message.
+ */
+export type TextUIPart = {
+    type: 'text';
+    text: string;
+    state?: 'streaming' | 'done';
+    providerMetadata?: ProviderMetadata;
+};
+/**
+ * A reasoning part of a message.
+ */
+export type ReasoningUIPart = {
+    type: 'reasoning';
+    text: string;
+    state?: 'streaming' | 'done';
+    providerMetadata?: ProviderMetadata;
+};
+/**
+ * A source URL part of a message.
+ */
+export type SourceUrlUIPart = {
+    type: 'source-url';
+    sourceId: string;
+    url: string;
+    title?: string;
+    providerMetadata?: ProviderMetadata;
+};
+/**
+ * A document source part of a message.
+ */
+export type SourceDocumentUIPart = {
+    type: 'source-document';
+    sourceId: string;
+    mediaType: string;
+    title: string;
+    filename?: string;
+    providerMetadata?: ProviderMetadata;
+};
+/**
+ * A file part of a message.
+ */
+export type FileUIPart = {
+    type: 'file';
+    mediaType: string;
+    filename?: string;
+    url: string;
+    providerMetadata?: ProviderMetadata;
+};
+/**
+ * A step boundary part of a message.
+ */
+export type StepStartUIPart = {
+    type: 'step-start';
+};
+/**
+ * A data part of a message.
+ */
+export type DataUIPart<TDataTypes extends UIDataTypes> = ValueOf<{
+    [NAME in keyof TDataTypes & string]: {
+        type: `data-${NAME}`;
+        id?: string;
+        data: TDataTypes[NAME];
+    };
+}>;
+/**
+ * A tool invocation part of a message.
+ */
+export type ToolUIPart<TTools extends UITools = UITools> = ValueOf<{
+    [NAME in keyof TTools & string]: {
+        type: `tool-${NAME}`;
+        toolCallId: string;
+    } & ({
+        state: 'input-streaming';
+        input: DeepPartial<TTools[NAME]['input']> | undefined;
+        providerExecuted?: boolean;
+        output?: never;
+        errorText?: never;
+    } | {
+        state: 'input-available';
+        input: TTools[NAME]['input'];
+        providerExecuted?: boolean;
+        output?: never;
+        errorText?: never;
+        callProviderMetadata?: ProviderMetadata;
+    } | {
+        state: 'output-available';
+        input: TTools[NAME]['input'];
+        output: TTools[NAME]['output'];
+        errorText?: never;
+        providerExecuted?: boolean;
+        callProviderMetadata?: ProviderMetadata;
+        preliminary?: boolean;
+    } | {
+        state: 'output-error';
+        input: TTools[NAME]['input'] | undefined;
+        rawInput?: unknown;
+        output?: never;
+        errorText: string;
+        providerExecuted?: boolean;
+        callProviderMetadata?: ProviderMetadata;
+    });
+}>;
+/**
+ * A dynamic tool invocation part of a message.
+ */
+export type DynamicToolUIPart = {
+    type: 'dynamic-tool';
+    toolName: string;
+    toolCallId: string;
+} & ({
+    state: 'input-streaming';
+    input: unknown | undefined;
+    output?: never;
+    errorText?: never;
+} | {
+    state: 'input-available';
+    input: unknown;
+    output?: never;
+    errorText?: never;
+    callProviderMetadata?: ProviderMetadata;
+} | {
+    state: 'output-available';
+    input: unknown;
+    output: unknown;
+    errorText?: never;
+    callProviderMetadata?: ProviderMetadata;
+    preliminary?: boolean;
+} | {
+    state: 'output-error';
+    input: unknown;
+    output?: never;
+    errorText: string;
+    callProviderMetadata?: ProviderMetadata;
+});
+/**
+ * All possible message part types.
+ */
+export type UIMessagePart<TDataTypes extends UIDataTypes = UIDataTypes, TTools extends UITools = UITools> = TextUIPart | ReasoningUIPart | ToolUIPart<TTools> | DynamicToolUIPart | SourceUrlUIPart | SourceDocumentUIPart | FileUIPart | DataUIPart<TDataTypes> | StepStartUIPart;
+/**
+ * AI SDK UI Messages. They are used in the client and to communicate between the frontend and the API routes.
+ */
+export interface UIMessage<TMetadata = unknown, TDataParts extends UIDataTypes = UIDataTypes, TTools extends UITools = UITools> {
+    /** A unique identifier for the message. */
+    id: string;
+    /** The role of the message. */
+    role: 'system' | 'user' | 'assistant';
+    /** The metadata of the message. */
+    metadata?: TMetadata;
+    /** The parts of the message. Use this for rendering the message in the UI. */
+    parts: Array<UIMessagePart<TDataParts, TTools>>;
+}
 export type ChatMessageBase = UIMessage;
 export type ChatToolMessage = Extract<ChatMessageBase['parts'][number], {
     type: `tool-${string}`;
 }>;
 export type ChatToolType = ChatToolMessage['type'];
-export type { ChatInit } from 'ai';
+/**
+ * Infer metadata type from UIMessage.
+ */
+export type InferUIMessageMetadata<T extends UIMessage> = T extends UIMessage<infer TMetadata> ? TMetadata : unknown;
+/**
+ * Infer data types from UIMessage.
+ */
+export type InferUIMessageData<T extends UIMessage> = T extends UIMessage<unknown, infer TDataTypes> ? TDataTypes : UIDataTypes;
+/**
+ * Infer tools from UIMessage.
+ */
+export type InferUIMessageTools<T extends UIMessage> = T extends UIMessage<unknown, UIDataTypes, infer TTools> ? TTools : UITools;
+/**
+ * Chat state interface.
+ */
+export interface ChatState<TUIMessage extends UIMessage> {
+    status: ChatStatus;
+    error: Error | undefined;
+    messages: TUIMessage[];
+    pushMessage: (message: TUIMessage) => void;
+    popMessage: () => void;
+    replaceMessage: (index: number, message: TUIMessage) => void;
+    snapshot: <T>(thing: T) => T;
+}
+/**
+ * ID generator function type.
+ */
+export type IdGenerator = () => string;
+/**
+ * Callback function to be called when an error is encountered.
+ */
+export type ChatOnErrorCallback = (error: Error) => void;
+/**
+ * Infer tool call type from UIMessage.
+ */
+export type InferUIMessageToolCall<TUIMessage extends UIMessage> = ValueOf<{
+    [NAME in keyof InferUIMessageTools<TUIMessage>]: {
+        toolName: NAME & string;
+        toolCallId: string;
+        input: InferUIMessageTools<TUIMessage>[NAME] extends {
+            input: infer INPUT;
+        } ? INPUT : never;
+        dynamic?: false;
+    };
+}> | {
+    toolName: string;
+    toolCallId: string;
+    input: unknown;
+    dynamic: true;
+};
+/**
+ * Optional callback function that is invoked when a tool call is received.
+ */
+export type ChatOnToolCallCallback<TUIMessage extends UIMessage = UIMessage> = (options: {
+    toolCall: InferUIMessageToolCall<TUIMessage>;
+}) => void | PromiseLike<void>;
+/**
+ * Function that is called when the assistant response has finished streaming.
+ */
+export type ChatOnFinishCallback<TUIMessage extends UIMessage> = (options: {
+    message: TUIMessage;
+    messages: TUIMessage[];
+    isAbort: boolean;
+    isDisconnect: boolean;
+    isError: boolean;
+}) => void;
+/**
+ * Optional callback function that is called when a data part is received.
+ */
+export type ChatOnDataCallback<TUIMessage extends UIMessage> = (dataPart: DataUIPart<InferUIMessageData<TUIMessage>>) => void;
+/**
+ * Transport interface for sending and receiving chat messages.
+ */
+export interface ChatTransport<TUIMessage extends UIMessage> {
+    sendMessages: (options: {
+        chatId: string;
+        messages: TUIMessage[];
+        abortSignal: AbortSignal;
+        requestMetadata?: unknown;
+        trigger: 'submit-message' | 'regenerate-message';
+        messageId?: string;
+    }) => Promise<ReadableStream<unknown>>;
+    reconnectToStream: (options: {
+        chatId: string;
+    }) => Promise<ReadableStream<unknown> | null>;
+}
+/**
+ * Chat initialization options.
+ */
+export interface ChatInit<TUIMessage extends UIMessage> {
+    /** A unique identifier for the chat. If not provided, a random one will be generated. */
+    id?: string;
+    messages?: TUIMessage[];
+    /** A way to provide a function for generating message and chat IDs. */
+    generateId?: IdGenerator;
+    transport?: ChatTransport<TUIMessage>;
+    /** Callback function to be called when an error is encountered. */
+    onError?: ChatOnErrorCallback;
+    /** Optional callback function that is invoked when a tool call is received. */
+    onToolCall?: ChatOnToolCallCallback<TUIMessage>;
+    /** Function that is called when the assistant response has finished streaming. */
+    onFinish?: ChatOnFinishCallback<TUIMessage>;
+    /** Optional callback function that is called when a data part is received. */
+    onData?: ChatOnDataCallback<TUIMessage>;
+    /**
+     * When provided, this function will be called when the stream is finished or a tool call is added
+     * to determine if the current messages should be resubmitted.
+     */
+    sendAutomaticallyWhen?: (options: {
+        messages: TUIMessage[];
+    }) => boolean | PromiseLike<boolean>;
+}
+/**
+ * Abstract base class for chat implementations.
+ */
+export interface AbstractChat<TUIMessage extends UIMessage> {
+    readonly id: string;
+    readonly generateId: IdGenerator;
+    status: ChatStatus;
+    error: Error | undefined;
+    messages: TUIMessage[];
+    lastMessage: TUIMessage | undefined;
+    sendMessage: (message?: (Omit<TUIMessage, 'id' | 'role'> & {
+        id?: TUIMessage['id'];
+        role?: TUIMessage['role'];
+        text?: never;
+        files?: never;
+        messageId?: string;
+    }) | {
+        text: string;
+        files?: FileList | FileUIPart[];
+        metadata?: InferUIMessageMetadata<TUIMessage>;
+        parts?: never;
+        messageId?: string;
+    } | {
+        files: FileList | FileUIPart[];
+        metadata?: InferUIMessageMetadata<TUIMessage>;
+        parts?: never;
+        messageId?: string;
+    }, options?: {
+        headers?: Record<string, string> | Headers;
+        body?: object;
+    }) => Promise<void>;
+    regenerate: (options?: {
+        messageId?: string;
+    } & {
+        headers?: Record<string, string> | Headers;
+        body?: object;
+    }) => Promise<void>;
+    resumeStream: (options?: {
+        headers?: Record<string, string> | Headers;
+        body?: object;
+    }) => Promise<void>;
+    clearError: () => void;
+    addToolResult: <TTool extends keyof InferUIMessageTools<TUIMessage>>(params: {
+        tool: TTool;
+        toolCallId: string;
+        output: InferUIMessageTools<TUIMessage>[TTool]['output'];
+    }) => Promise<void>;
+    stop: () => Promise<void>;
+}
 export type AddToolResult = AbstractChat<UIMessage>['addToolResult'];
 export type AddToolResultWithOutput = (params: Pick<Parameters<AddToolResult>[0], 'output'>) => ReturnType<AddToolResult>;
 export type ClientSideToolComponentProps = {
@@ -27,3 +367,4 @@ export type ClientSideTool = {
 export type ClientSideTools = Record<string, ClientSideTool>;
 export type UserClientSideTool = Omit<ClientSideTool, 'addToolResult'>;
 export type UserClientSideTools = Record<string, UserClientSideTool>;
+export {};

package/dist/es/components/index.d.ts

@@ -8,6 +8,7 @@ export * from './chat/ChatMessages';
 export * from './chat/ChatMessageLoader';
 export * from './chat/ChatMessageError';
 export * from './chat/ChatPrompt';
+export * from './chat/ChatPromptSuggestions';
 export * from './chat/ChatToggleButton';
 export * from './chat/icons';
 export * from './chat/types';

package/dist/es/components/index.js

@@ -8,6 +8,7 @@ export * from "./chat/ChatMessages.js";
 export * from "./chat/ChatMessageLoader.js";
 export * from "./chat/ChatMessageError.js";
 export * from "./chat/ChatPrompt.js";
+export * from "./chat/ChatPromptSuggestions.js";
 export * from "./chat/ChatToggleButton.js";
 export * from "./chat/icons.js";
 export * from "./chat/types.js";

package/dist/es/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "0.17.0";
+declare const _default: "0.17.1";
 export default _default;

package/dist/es/version.js

@@ -1 +1 @@
-export default '0.17.0';
+export default '0.17.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instantsearch-ui-components",
-  "version": "0.17.0",
+  "version": "0.17.1",
   "description": "Common UI components for InstantSearch.",
   "types": "dist/es/index.d.ts",
   "main": "dist/cjs/index.js",
@@ -48,10 +48,9 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.27.6",
-    "ai": "^5.0.18",
     "markdown-to-jsx": "^7.7.15",
     "zod": "^3.25.76 || ^4",
     "zod-to-json-schema": "3.24.6"
   },
-  "gitHead": "c796f45db6153fb5fa627b90e334a572bbf31e33"
+  "gitHead": "d40d81bc9232c88f0dba1fdaada8471237f31847"
 }