@docsearch/js 5.0.0-beta.2 → 5.0.0-beta.4

package/dist/esm/index.d.ts

@@ -1,6 +1,7 @@
-/*! @docsearch/js 5.0.0-beta.2 (UNRELEASED c7e1a88) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
-import { DocSearchAIProps as DocSearchAIProps$1 } from "@docsearch/react/docsearchAi";
+/*! @docsearch/js 5.0.0-beta.4 (UNRELEASED 11d6ed4) | MIT License | © Algolia, Inc. and contributors | https://docsearch.algolia.com */
 import { InitialAskAiMessage } from "@docsearch/core";
+import { HitComponentProps, ResultsFooterComponentProps } from "@docsearch/react";
+import { DocSearchAIProps as DocSearchAIProps$1 } from "@docsearch/react/docsearchAi";
 //#region ../../node_modules/.bun/preact@11.0.0-beta.0/node_modules/preact/src/index.d.ts
 import JSX = JSXInternal;
 //#endregion
@@ -19,18 +20,49 @@ interface DocSearchCallbacks {
   onClose?: () => void;
   interceptAskAiEvent?: (initialMessage: InitialAskAiMessage) => boolean | void;
 }
-type DocSearchProps<TProps> = DocSearchCallbacks & Omit<TProps, 'onSidepanelClose' | 'onSidepanelOpen'> & {
+type TemplateHelpers = {
+  html: typeof html;
+};
+type TemplateFnReturnType = JSX.Element | string | (() => JSX.Element) | null;
+type HitComponentFn = (props: HitComponentProps, helpers: TemplateHelpers) => TemplateFnReturnType;
+type ResultsFooterComponentFn = (props: ResultsFooterComponentProps, helpers: TemplateHelpers) => TemplateFnReturnType;
+type FooterActionFn = (props: never, helpers: TemplateHelpers) => TemplateFnReturnType;
+type DocSearchProps<TProps> = DocSearchCallbacks & Omit<TProps, 'onSidepanelClose' | 'onSidepanelOpen' | 'hitComponent' | 'resultsFooterComponent' | 'footerAction'> & {
   container: HTMLElement | string;
   environment?: typeof window;
+  /**
+   * Custom component to render an individual hit. Supports template patterns:
+   *
+   * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
+   * - JSX templates: (props) => <div>...</div>
+   * - Function-based templates: (props) => string | JSX.Element | Function.
+   */
+  hitComponent?: HitComponentFn;
+  /**
+   * Custom component rendered at the bottom of the results panel. Supports
+   * template patterns:
+   *
+   * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
+   * - JSX templates: (props) => <div>...</div>
+   * - Function-based templates: (props) => string | JSX.Element | Function.
+   */
+  resultsFooterComponent?: ResultsFooterComponentFn;
+  /**
+   * A custom action that can be rendered in the Modal's footer before the
+   * Algolia logo. The component will be rendered as a child of `<div
+   * className="DocSearch-Footer-Action" />`. Supports template patterns:
+   *
+   * - HTML strings with html helper: (props, { html }) => html`<div>...</div>`
+   * - JSX templates: (props) => <div>...</div>
+   * - Function-based templates: (props) => string | JSX.Element | Function.
+   */
+  footerAction?: FooterActionFn;
 };
 declare const html: (strings: TemplateStringsArray, ...values: unknown[]) => JSX.Element;
-type TemplateHelpers = Record<string, unknown> & {
-  html: typeof html;
-};
 //#endregion
 //#region src/docsearchAi.d.ts
 type DocSearchAIProps = DocSearchProps<DocSearchAIProps$1>;
 declare const docsearchAi: (allProps: DocSearchAIProps) => DocSearchInstance;
 //#endregion
-export { type DocSearchCallbacks, type DocSearchInstance, type DocSearchAIProps as DocSearchProps, type TemplateHelpers, docsearchAi as default };
+export { type DocSearchCallbacks, type DocSearchInstance, type DocSearchAIProps as DocSearchProps, type FooterActionFn, type HitComponentFn, type ResultsFooterComponentFn, type TemplateHelpers, docsearchAi as default };
 //# sourceMappingURL=index.d.ts.map