@searchcraft/javascript-sdk 0.9.7 → 0.10.1

package/dist/components/index.d.ts

@@ -1,78 +1,2642 @@
-/* SearchcraftJavascriptSdk custom elements */
-export { SearchcraftPopoverListItemAd as SearchcraftAd } from '../types/components/searchcraft-ad/searchcraft-ad';
-export { defineCustomElement as defineCustomElementSearchcraftAd } from './searchcraft-ad';
-export { SearchcraftBaseSearchResult as SearchcraftBaseSearchResult } from '../types/components/searchcraft-base-search-result/searchcraft-base-search-result';
-export { defineCustomElement as defineCustomElementSearchcraftBaseSearchResult } from './searchcraft-base-search-result';
-export { SearchcraftBaseSearchResults as SearchcraftBaseSearchResults } from '../types/components/searchcraft-base-search-results/searchcraft-base-search-results';
-export { defineCustomElement as defineCustomElementSearchcraftBaseSearchResults } from './searchcraft-base-search-results';
-export { SearchcraftButton as SearchcraftButton } from '../types/components/searchcraft-button/searchcraft-button';
-export { defineCustomElement as defineCustomElementSearchcraftButton } from './searchcraft-button';
-export { SearchcraftErrorMessage as SearchcraftErrorMessage } from '../types/components/searchcraft-error-message/searchcraft-error-message';
-export { defineCustomElement as defineCustomElementSearchcraftErrorMessage } from './searchcraft-error-message';
-export { SearchcraftFacetList as SearchcraftFacetList } from '../types/components/searchcraft-facet-list/searchcraft-facet-list';
-export { defineCustomElement as defineCustomElementSearchcraftFacetList } from './searchcraft-facet-list';
-export { SearchcraftFilterPanel as SearchcraftFilterPanel } from '../types/components/searchcraft-filter-panel/searchcraft-filter-panel';
-export { defineCustomElement as defineCustomElementSearchcraftFilterPanel } from './searchcraft-filter-panel';
-export { SearchcraftInput as SearchcraftInputForm } from '../types/components/searchcraft-input-form/searchcraft-input-form';
-export { defineCustomElement as defineCustomElementSearchcraftInputForm } from './searchcraft-input-form';
-export { SearchcraftInputLabel as SearchcraftInputLabel } from '../types/components/searchcraft-input-label/searchcraft-input-label';
-export { defineCustomElement as defineCustomElementSearchcraftInputLabel } from './searchcraft-input-label';
-export { SearchcraftPagination as SearchcraftPagination } from '../types/components/searchcraft-pagination/searchcraft-pagination';
-export { defineCustomElement as defineCustomElementSearchcraftPagination } from './searchcraft-pagination';
-export { SearchcraftPopoverButton as SearchcraftPopoverButton } from '../types/components/searchcraft-popover-button/searchcraft-popover-button';
-export { defineCustomElement as defineCustomElementSearchcraftPopoverButton } from './searchcraft-popover-button';
-export { SearchcraftPopoverForm as SearchcraftPopoverForm } from '../types/components/searchcraft-popover-form/searchcraft-popover-form';
-export { defineCustomElement as defineCustomElementSearchcraftPopoverForm } from './searchcraft-popover-form';
-export { SearchcraftPopoverListItem as SearchcraftPopoverListItem } from '../types/components/searchcraft-popover-list-item/searchcraft-popover-list-item';
-export { defineCustomElement as defineCustomElementSearchcraftPopoverListItem } from './searchcraft-popover-list-item';
-export { SearchcraftPopoverListView as SearchcraftPopoverListView } from '../types/components/searchcraft-popover-list-view/searchcraft-popover-list-view';
-export { defineCustomElement as defineCustomElementSearchcraftPopoverListView } from './searchcraft-popover-list-view';
-export { SearchcraftResultsInfo as SearchcraftResultsInfo } from '../types/components/searchcraft-results-info/searchcraft-results-info';
-export { defineCustomElement as defineCustomElementSearchcraftResultsInfo } from './searchcraft-results-info';
-export { SearchcraftSearchResultsPerPage as SearchcraftSearchResultsPerPage } from '../types/components/searchcraft-search-results-per-page/searchcraft-search-results-per-page';
-export { defineCustomElement as defineCustomElementSearchcraftSearchResultsPerPage } from './searchcraft-search-results-per-page';
-export { SearchcraftSelect as SearchcraftSelect } from '../types/components/searchcraft-select/searchcraft-select';
-export { defineCustomElement as defineCustomElementSearchcraftSelect } from './searchcraft-select';
-export { SearchcraftSlider as SearchcraftSlider } from '../types/components/searchcraft-slider/searchcraft-slider';
-export { defineCustomElement as defineCustomElementSearchcraftSlider } from './searchcraft-slider';
-export { SearchcraftTheme as SearchcraftTheme } from '../types/components/searchcraft-theme/searchcraft-theme';
-export { defineCustomElement as defineCustomElementSearchcraftTheme } from './searchcraft-theme';
-export { SearchcraftToggleButton as SearchcraftToggleButton } from '../types/components/searchcraft-toggle-button/searchcraft-toggle-button';
-export { defineCustomElement as defineCustomElementSearchcraftToggleButton } from './searchcraft-toggle-button';
+// Generated by dts-bundle-generator v9.5.1
 
+import { HTMLStencilElement, JSXBase } from '@stencil/core/internal';
+
+declare enum LogLevel {
+	DEBUG = 0,
+	INFO = 1,
+	WARN = 2,
+	ERROR = 3
+}
+export interface SDKDebuggerOptions {
+	logLevel: LogLevel;
+	logFormatter?: (level: LogLevel, message: string) => string;
+}
+declare class Logger {
+	private logLevel;
+	private logFormatter;
+	constructor(options: SDKDebuggerOptions);
+	private defaultFormatter;
+	debug(message: string): void;
+	info(message: string): void;
+	warn(message: string): void;
+	error(message: string): void;
+	log(level: LogLevel, message: string): void;
+}
 /**
- * Get the base path to where the assets can be found. Use "setAssetPath(path)"
- * if the path needs to be customized.
+ * A data type representing an index field value, along with properties
+ * describing how to format and display the index field value.
  */
-export declare const getAssetPath: (path: string) => string;
-
+export type SearchResultFieldName = {
+	/**
+	 * The index field name.
+	 */
+	fieldName: string;
+	/**
+	 * The data type to treat this index field as.
+	 */
+	dataType: "text" | "date" | "number";
+	/**
+	 * The locale to use when formatting dataType: `number`
+	 */
+	numberFormatLocale?: string;
+	/**
+	 * If it's a number, the number format to apply.
+	 * reference: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat
+	 */
+	numberFormatOptions?: Intl.NumberFormatOptions;
+	/**
+	 * A scale factor to apply to a `number` value.
+	 */
+	numberScale?: number;
+	/**
+	 * TODO: Implement DateFormatOptions, for date formatting
+	 */
+	dateFormatOptions?: unknown;
+};
 /**
- * Used to manually set the base path where assets can be found.
- * If the script is used as "module", it's recommended to use "import.meta.url",
- * such as "setAssetPath(import.meta.url)". Other options include
- * "setAssetPath(document.currentScript.src)", or using a bundler's replace plugin to
- * dynamically set the path at build time, such as "setAssetPath(process.env.ASSET_PATH)".
- * But do note that this configuration depends on how your script is bundled, or lack of
- * bundling, and where your assets can be loaded from. Additionally custom bundling
- * will have to ensure the static assets are copied to its build directory.
+ * A data type representing the mapping of index fields, for the purpose of rendering them
+ * in search result item.
  */
-export declare const setAssetPath: (path: string) => void;
-
+export type SearchResultMapping = {
+	/**
+	 * The fields to map to.
+	 */
+	fieldNames: SearchResultFieldName[];
+	/**
+	 * The delimiter used to join them.
+	 */
+	delimiter?: string;
+};
+export type PopoverResultMappings = {
+	title?: SearchResultMapping;
+	subtitle?: SearchResultMapping;
+	imageSource?: SearchResultMapping;
+	imageAlt?: SearchResultMapping;
+	href?: SearchResultMapping;
+};
+export interface FilterItem {
+	type: "facets" | "dateRange" | "numericRange" | "exactMatchToggle" | "mostRecentToggle";
+	label: string;
+	options: object | null;
+}
+export interface FacetsFilterItem extends FilterItem {
+	fieldName: string;
+	type: "facets";
+	options: {
+		showSublevel: boolean;
+	};
+}
+export interface NumericFilterItem extends FilterItem {
+	fieldName: string;
+	type: "numericRange";
+	options: {
+		min: number;
+		max: number;
+		granularity: number;
+	};
+}
+export interface DateRangeFilterItem extends FilterItem {
+	fieldName: string;
+	type: "dateRange";
+	options: {
+		minDate: Date;
+		maxDate: Date;
+		granularity: "year" | "month" | "day" | "hour";
+	};
+}
+export interface ExactMatchToggleFilterItem extends FilterItem {
+	type: "exactMatchToggle";
+	options: {
+		subLabel?: string;
+	};
+}
+export interface MostRecentToggleFilterItem extends FilterItem {
+	type: "mostRecentToggle";
+	options: {
+		subLabel?: string;
+	};
+}
+export type TemplateHtml = (strings: TemplateStringsArray, ...values: (string | number | undefined)[]) => string;
+export type SearchResultTemplate<T> = (data: T, index: number, utils: {
+	html: TemplateHtml;
+}) => string;
+export type SearchResultTemplateData = any;
+export type ResultsInfoTemplate = (data: {
+	range: [
+		number,
+		number
+	];
+	count: number;
+	responseTime: string;
+}, utils: {
+	html: TemplateHtml;
+}) => string;
+export type CustomAdTemplate = (data: {
+	adContainerId: string;
+	searchTerm: string;
+}, utils: {
+	html: TemplateHtml;
+}) => string;
+export type PopoverButtonTemplate = (data: boolean, utils: {
+	html: TemplateHtml;
+}) => string;
 /**
- * Used to specify a nonce value that corresponds with an application's CSP.
- * When set, the nonce will be added to all dynamically created script and style tags at runtime.
- * Alternatively, the nonce value can be set on a meta tag in the DOM head
- * (<meta name="csp-nonce" content="{ nonce value here }" />) which
- * will result in the same behavior.
+ * The SearchcraftConfig object is used to initialize Searchcraft in your application.
  */
-export declare const setNonce: (nonce: string) => void
-
-export interface SetPlatformOptions {
-  raf?: (c: FrameRequestCallback) => number;
-  ael?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
-  rel?: (el: EventTarget, eventName: string, listener: EventListenerOrEventListenerObject, options: boolean | AddEventListenerOptions) => void;
+export interface SearchcraftConfig {
+	/**
+	 * Host IP Address and port number configured and created using Vektron
+	 */
+	endpointURL: string;
+	/**
+	 * Name or names of search indices configured using Vektron. Given as an array of strings
+	 */
+	index: string[];
+	/**
+	 * A unique user identifier for the end user.
+	 */
+	userId?: string;
+	/**
+	 * The Index read key provided by Vektron.
+	 */
+	readKey: string;
+	/**
+	 * The amount of delay, in milliseconds, to debounce search requests. Defaults to `0`.
+	 */
+	searchDebounceDelay?: number;
+	/**
+	 * The maximum number of results to return per page.
+	 */
+	searchResultsPerPage?: number;
+	/**
+	 * Name of the ad source to use.
+	 */
+	adSource?: "adMarketplace" | "Nativo" | "Custom" | "None";
+	/**
+	 * The maximum number of product ads to show for a single search term.
+	 */
+	admProductAdQuantity?: number;
+	/**
+	 * The maximum number of text ads to show for a single search term.
+	 */
+	admTextAdQuantity?: number;
+	/**
+	 * The adm sub value.
+	 */
+	admSub?: string;
+	/**
+	 * The amount of debounce delay to add before calling the ad_container_rendered event
+	 */
+	adContainerRenderedDebounceDelay?: number;
+	/**
+	 * The number of custom ads to render at the start of the search results page.
+	 */
+	customAdStartQuantity?: number;
+	/**
+	 * The number of custom ads to render at the end of the search results page.
+	 */
+	customAdEndQuantity?: number;
+	/**
+	 * Renders a custom ad in between search results, at the specified interval.
+	 */
+	customAdInterstitialInterval?: number;
+	/**
+	 * Specifies the number of ads to be rendered in each interstitial in between search results.
+	 */
+	customAdInterstitialQuantity?: number;
+	/**
+	 * A callback function responsible for rendering the custom ad containers.
+	 */
+	customAdTemplate?: CustomAdTemplate;
+	/**
+	 * The placement id to use for Nativo ads.
+	 */
+	nativoPlacementId?: number;
+	/**
+	 * The class name for nativo ad containers.
+	 */
+	nativoAdClassName?: string;
+	/**
+	 * The number of custom ads to render at the start of the search results page.
+	 */
+	nativoAdStartQuantity?: number;
+	/**
+	 * The number of custom ads to render at the end of the search results page.
+	 */
+	nativoAdEndQuantity?: number;
+	/**
+	 * Renders a custom ad in between search results, at the specified interval.
+	 */
+	nativoAdInterstitialInterval?: number;
+	/**
+	 * Specify how many normal search results to render before rendering the first interstitial ad grouping.
+	 */
+	nativoAdInterstialStartIndex?: number;
+	/**
+	 * Specifies the number of ads to be rendered in each interstitial in between search results.
+	 */
+	nativoAdInterstitialQuantity?: number;
+}
+export type SearchcraftAdSource = "adMarketplace" | "Nativo" | "Custom" | "None";
+/**
+ * Used internally by consuming packages as part of the core sdk constructor.
+ */
+export interface SearchcraftSDKInfo {
+	sdkName: string;
+	sdkVersion: string;
+}
+export interface AdClientResponseItem {
+	id: string;
+	adSource: SearchcraftAdSource;
+}
+/**
+ * A Facet object returned in a search response.
+ */
+export type FacetRoot = {
+	[key: string]: FacetChild[];
+};
+export type FacetPrime = FacetRoot[];
+/**
+ * Represents the structure of facets, which group search results into categories.
+ */
+export interface FacetChild {
+	count: number;
+	path: string;
+	children?: FacetChild[];
 }
-export declare const setPlatformOptions: (opts: SetPlatformOptions) => void;
-export * from '../types';
+/**
+ * Types of measure requests that can be sent to the /measure/event endpoint.
+ */
+export type MeasureEventName = "sdk_initialized" | "search_requested" | "search_response_received" | "search_completed" | "document_clicked";
+/**
+ * Properties attached to a measure request.
+ */
+export interface MeasureRequestProperties {
+	searchcraft_organization_id?: string;
+	searchcraft_application_id?: string;
+	searchcraft_index_names: string[];
+	search_term?: string;
+	number_of_documents?: number;
+	external_document_id?: string;
+	document_position?: number;
+	session_id?: string;
+}
+/**
+ * User properties attached to a measure request.
+ */
+export interface MeasureRequestUser {
+	user_id: string;
+	country?: string;
+	city?: string;
+	device_id?: string;
+	client_ip?: string;
+	locale?: string;
+	os?: string;
+	platform?: string;
+	region?: string;
+	sdk_name?: string;
+	sdk_version?: string;
+	user_agent?: string;
+	latitude?: number;
+	longitude?: number;
+}
+/**
+ * The structure of a response returned from a Searchcraft operation.
+ */
+export interface SearchcraftResponse {
+	status: number;
+	data: SearchcraftResponseData | SearchcraftResponseError;
+}
+/**
+ * Error returned when a search is unsuccessful.
+ */
+export type SearchcraftResponseError = {
+	status: number;
+	message?: string;
+	code?: number;
+	hits?: [
+	];
+	facets?: null;
+	count?: number;
+	time_taken?: number;
+};
+/**
+ * Top-level result returned when a search is successful.
+ */
+export interface SearchcraftResponseData {
+	count?: number;
+	facets?: FacetPrime;
+	hits?: SearchIndexEntry[];
+	time_taken?: number;
+}
+/**
+ * Represents an entry in the search index returned as part of a search result.
+ */
+export interface SearchIndexEntry {
+	doc?: SearchDocument;
+	document_id?: string;
+	score?: number;
+}
+/**
+ * Data document returned within a SearchResult.
+ */
+export interface SearchDocument extends Record<string, string | number> {
+	id: number;
+	[key: string]: string | number;
+}
+export interface SearchClientResponseItem {
+	id: string;
+	document: SearchDocument;
+}
+export type FacetPathsForIndexField = {
+	fieldName: string;
+	value: string;
+};
+export type RangeValueForIndexField = {
+	fieldName: string;
+	value: string;
+};
+/**
+ * Parameters required to make a successful Search request.
+ */
+export type SearchParams = {
+	/**
+	 * The search mode, which can be either 'fuzzy' or 'exact'.
+	 */
+	mode: "fuzzy" | "exact";
+	/**
+	 * The starting point for the results, used for pagination.
+	 * Optional parameter.
+	 */
+	offset?: number;
+	/**
+	 * The number of results returned.
+	 * Optional parameter.
+	 */
+	limit?: number;
+	/**
+	 * The field to order the results by (e.g., 'date_published', 'title', etc.).
+	 * Optional parameter.
+	 */
+	order_by?: string;
+	/**
+	 * The search term provided by the user.
+	 */
+	searchTerm: string;
+	/**
+	 * The sort order, which can be either 'asc' or 'desc'.
+	 * Optional parameter.
+	 */
+	sort?: "asc" | "desc";
+	facetPathsForIndexFields?: Record<string, FacetPathsForIndexField>;
+	rangeValueForIndexFields?: Record<string, RangeValueForIndexField>;
+};
+export interface SubscriptionEventMap {
+	ad_container_rendered: AdContainerRenderedSubscriptionEvent;
+	ad_container_viewed: AdContainerViewedSubscriptionEvent;
+	query_fetched: QueryFetchedEvent;
+	query_submitted: QuerySubmittedEvent;
+	input_cleared: InputClearedEvent;
+	no_results_returned: NoResultsReturnedEvent;
+}
+export interface AdContainerRenderedSubscriptionEvent extends SubscriptionEvent {
+	name: "ad_container_rendered";
+	data: {
+		adContainerId: string;
+		adSource: SearchcraftAdSource;
+		searchTerm: string;
+	};
+}
+export interface AdContainerViewedSubscriptionEvent extends SubscriptionEvent {
+	name: "ad_container_viewed";
+	data: {
+		adContainerId: string;
+		adSource: SearchcraftAdSource;
+		searchTerm: string;
+	};
+}
+export interface QuerySubmittedEvent extends SubscriptionEvent {
+	name: "query_submitted";
+	data: {
+		searchTerm: string;
+	};
+}
+export interface QueryFetchedEvent extends SubscriptionEvent {
+	name: "query_fetched";
+	data: {
+		searchTerm: string;
+	};
+}
+export interface InputClearedEvent extends SubscriptionEvent {
+	name: "input_cleared";
+}
+export interface NoResultsReturnedEvent extends SubscriptionEvent {
+	name: "no_results_returned";
+}
+export type SubscriptionEventName = keyof SubscriptionEventMap;
+export type SubscriptionEventCallback<T extends SubscriptionEventName> = (event: SubscriptionEventMap[T]) => void;
+export type UnsubscribeFunction = () => void;
+export interface SubscriptionEvent {
+	name: SubscriptionEventName;
+}
+declare class AdClient {
+	config: SearchcraftConfig;
+	constructor(config: SearchcraftConfig);
+	getAdsForSearchParams(_params: SearchParams): Promise<AdClientResponseItem[]>;
+	onQuerySubmitted(_params: SearchParams): Promise<void>;
+	onQueryFetched(_params: SearchParams, _response: SearchcraftResponse): Promise<void>;
+	onInputCleared(): Promise<void>;
+	onAdContainerRendered(_data: {
+		adClientResponseItem?: AdClientResponseItem;
+		adContainerId: string;
+		adSource: SearchcraftAdSource;
+		searchTerm: string;
+	}): Promise<void>;
+	onAdContainerViewed(_data: {
+		adClientResponseItem?: AdClientResponseItem;
+		adContainerId: string;
+		adSource: SearchcraftAdSource;
+		searchTerm: string;
+	}): Promise<void>;
+}
+declare class MeasureClient {
+	private measureRequestTimeout;
+	private measureRequestsBatched;
+	private config;
+	private sdkInfo;
+	private userId;
+	private sessionId;
+	constructor(config: SearchcraftConfig, sdkInfo: SearchcraftSDKInfo, userId: string);
+	/**
+	 * Getter for the base url used by the /measure endpoints.
+	 */
+	private get baseMeasureUrl();
+	/**
+	 * Getter for the measure request user. Uses config values + navigator values.
+	 */
+	private get measureRequestUser();
+	/**
+	 * Sends a measure event to the `/measure/event` endpoint for analytics purposes.
+	 *
+	 * @param {MeasureEventName} eventName - Name of the event.
+	 * @param {Partial<MeasureRequestProperties>} properties - Additional properties to send with the event.
+	 * @param {Partial<MeasureRequestUser>} user - Additional user properites to send with the event.
+	 */
+	sendMeasureEvent: (eventName: MeasureEventName, properties?: Partial<MeasureRequestProperties>, user?: Partial<MeasureRequestUser>) => Promise<void>;
+}
+declare class SearchClient {
+	private config;
+	private userId;
+	private parent;
+	private searchCompletedEventTimeout;
+	constructor(parent: SearchcraftCore, config: SearchcraftConfig, userId: string);
+	/**
+	 * Getter for the base url used by the /search endpoint.
+	 */
+	private get baseSearchUrl();
+	/**
+	 * Performs a search operation.
+	 * @param {SearchParams} searchParams - The parameters for the search.
+	 */
+	getSearchResponse: (searchParams: SearchParams) => Promise<SearchcraftResponse>;
+}
+/**
+ * Javascript Class providing the functionality to interact with the Searchcraft BE
+ */
+export declare class SearchcraftCore {
+	config: SearchcraftConfig;
+	measureClient: MeasureClient | undefined;
+	searchClient: SearchClient | undefined;
+	adClient: AdClient | undefined;
+	userId: string;
+	private requestTimeout;
+	private subscriptionEvents;
+	constructor(config: SearchcraftConfig, sdkInfo: SearchcraftSDKInfo);
+	private initInputForms;
+	/**
+	 * When changes happen in the DOM, we want to link any input forms found to the instance of the core.
+	 */
+	private startObservingMutations;
+	private initClients;
+	emitEvent<T extends SubscriptionEventName>(eventName: T, event: SubscriptionEventMap[T]): void;
+	subscribe<T extends SubscriptionEventName>(eventName: T, callback: SubscriptionEventCallback<T>): UnsubscribeFunction;
+	/**
+	 * Called when a `<searchcraft-ad>` component is rendered
+	 */
+	handleAdContainerRendered(data: {
+		adClientResponseItem?: AdClientResponseItem;
+		adContainerId: string;
+		adSource: SearchcraftAdSource;
+		searchTerm: string;
+	}): void;
+	/**
+	 * Called when a `<searchcraft-ad>` is viewed
+	 */
+	handleAdContainerViewed(data: {
+		adClientResponseItem?: AdClientResponseItem;
+		adContainerId: string;
+		adSource: SearchcraftAdSource;
+		searchTerm: string;
+	}): void;
+	/**
+	 * Perform various actions when the input is cleared
+	 */
+	handleInputCleared(): void;
+	/**
+	 * Gets items from the SearchClient and the AdClient.
+	 */
+	getItems: (searchParams: SearchParams, itemsCallback: (response: SearchcraftResponse, items: SearchClientResponseItem[]) => void, adCallback: (adClientResponseItems: AdClientResponseItem[]) => void) => void;
+}
+/**
+ * Callable functions made available by the SearchcraftStore.
+ */
+export interface SearchcraftStateFunctions {
+	addFacetPathsForIndexField: (data: FacetPathsForIndexField) => void;
+	addRangeValueForIndexField: (data: RangeValueForIndexField) => void;
+	getSearchcraftInstance: () => SearchcraftCore | undefined;
+	initialize: (searchcraft: unknown, debug?: boolean) => void;
+	removeFacetPathsForIndexField: (fieldName: string) => void;
+	removeRangeValueForIndexField: (fieldName: string) => void;
+	resetFacetPaths: () => void;
+	search: () => Promise<void>;
+	setPopoverVisibility: (isVisible: boolean) => void;
+	setSearchClientResponseItems: (results: SearchClientResponseItem[]) => void;
+	setSearchResultsPage: (page: number) => void;
+	setSearchResultsPerPage: (perPage: number) => void;
+	setSearchTerm: (searchTerm: string) => void;
+	setSearchMode: (mode: "fuzzy" | "exact") => void;
+	setSortType: (type: "asc" | "desc") => void;
+	setHotKeyAndHotKeyModifier: (hotkey?: string, hotkeyModifier?: "ctrl" | "meta" | "alt" | "option") => void;
+}
+/**
+ * Values stored in SearchcraftStore.
+ */
+export interface SearchcraftStateValues {
+	adClientResponseItems: AdClientResponseItem[];
+	core: SearchcraftCore | undefined;
+	hotkey: string;
+	hotkeyModifier: "ctrl" | "meta" | "alt" | "option";
+	logger: Logger | undefined;
+	facetPathsForIndexFields: Record<string, FacetPathsForIndexField>;
+	isPopoverVisible: boolean;
+	isSearchInProgress: boolean;
+	rangeValueForIndexFields: Record<string, RangeValueForIndexField>;
+	searchMode: "fuzzy" | "exact";
+	searchClientResponseItems: SearchClientResponseItem[];
+	searchResponseTimeTaken: number | undefined;
+	searchResponseFacetPrime: FacetPrime | undefined;
+	searchResultsCount: number;
+	searchResultsPage: number;
+	searchResultsPerPage: number;
+	searchTerm: string;
+	sortType: "asc" | "desc";
+}
+export interface SearchcraftState extends SearchcraftStateFunctions, SearchcraftStateValues {
+}
+export declare const searchcraftStore: import("zustand").StoreApi<SearchcraftState>;
+export declare function parseCustomStyles(styles: string | Record<string, string>): Record<string, string>;
+export declare function serializeStyles(styles: Record<string, Record<string, string>>): string;
+export type SearchcraftSelectOption = {
+	label: string;
+	value: string | number;
+	selected?: boolean;
+};
+export namespace Components {
+	/**
+	 * An inline ad meant to be rendered in a list of search results.
+	 */
+	interface SearchcraftAd {
+		"adClientResponseItem"?: AdClientResponseItem;
+		"adContainerId": string;
+		"adSource": SearchcraftAdSource;
+	}
+	/**
+	 * This web component represents a button.
+	 * It provides a clear, interactive way for users to submit search queries or trigger actions in a search interface.
+	 */
+	interface SearchcraftButton {
+		/**
+		  * Whether the button is disabled.
+		 */
+		"disabled"?: boolean;
+		/**
+		  * Controls the visual representation of the button.
+		 */
+		"hierarchy"?: "primary" | "tertiary";
+		/**
+		  * The icon element.
+		 */
+		"icon"?: Element;
+		/**
+		  * Should the button only display an icon.
+		 */
+		"iconOnly"?: boolean;
+		/**
+		  * The position of the icon.
+		 */
+		"iconPosition"?: "left" | "right";
+		/**
+		  * The label for the button.
+		 */
+		"label": string;
+		/**
+		  * The type of the button.
+		 */
+		"type"?: "submit" | "reset" | "button";
+	}
+	/**
+	 * This web component is designed to display a user-friendly error message when a search query fails, providing clear feedback to users and enhancing their experience when an issue arises during the search process.
+	 * @js-example ```html
+	 * <searchcraft-error-message>
+	 *   No search results found for query
+	 * </searchcraft-error-message>
+	 * ```
+	 */
+	interface SearchcraftErrorMessage {
+	}
+	/**
+	 * This web component is designed to display facets in a search interface, allowing users to refine their search results by applying filters based on various attributes.
+	 * It is consumed within the `searchcraft-filter-panel`.
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-facet-list field-name="title" />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const facetList = document.querySelector('searchcraft-facet-list');
+	 * facetList.addEventListener('facetSelectionUpdated', () => {
+	 *   console.log('Facet selection updated');
+	 * });
+	 * ```
+	 */
+	interface SearchcraftFacetList {
+		/**
+		  * The name of the field where facets are applied.
+		 */
+		"fieldName": string;
+	}
+	/**
+	 * This web component represents a series of filters that allows users to refine and control their search queries by applying various filter criteria.
+	 * @react-import ```jsx
+	 * import { SearchcraftFilterPanel } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftFilterPanel } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-filter-panel />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const filterPanel = document.querySelector('searchcraft-filter-panel');
+	 * if (filterPanel) {
+	 *   filterPanel.items = [];
+	 * }
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftFilterPanel items={[]} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftFilterPanel :items="[]" />
+	 * ```
+	 */
+	interface SearchcraftFilterPanel {
+		/**
+		  * The items to filter.
+		 */
+		"items": FilterItem[];
+	}
+	/**
+	 * This web component provides a user-friendly interface for querying an indexed dataset, enabling users to easily search large collections of data.
+	 * It abstracts the complexities of index-based searching, making it accessible to users of all technical levels.
+	 * @react-import ```jsx
+	 * import { SearchcraftInputForm } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftInputForm } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-input-form auto-search />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftInputForm autoSearch />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftInputForm autoSearch />
+	 * ```
+	 */
+	interface SearchcraftInputForm {
+		/**
+		  * Whether or not to automatically submit the search term when the input changes.
+		 */
+		"autoSearch"?: boolean;
+		/**
+		  * The label for the submit button.
+		 */
+		"buttonLabel"?: string;
+		/**
+		  * Where to place the search button.
+		 */
+		"buttonPlacement"?: "left" | "right" | "none";
+		"core"?: SearchcraftCore;
+		/**
+		  * The label rendered above the input.
+		 */
+		"inputLabel"?: string;
+		/**
+		  * The input element's placeholder value.
+		 */
+		"placeholderValue"?: string;
+	}
+	/**
+	 * This web component serves as the input label for the searchcraft-input-form component.
+	 * @js-example ```html
+	 * <searchcraft-input-label label="Search" />
+	 * ```
+	 */
+	interface SearchcraftInputLabel {
+		/**
+		  * The classname applied to the label element.
+		 */
+		"inputLabelClassName"?: string | undefined;
+		"label": string;
+	}
+	/**
+	 * This web component is designed to facilitate pagination of search results. Once a query is submitted, calculates the number for pages.
+	 * @react-import ```jsx
+	 * import { SearchcraftPagination } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftPagination } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-pagination />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPagination />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPagination />
+	 * ```
+	 */
+	interface SearchcraftPagination {
+	}
+	/**
+	 * Renders a button which, when clicked, turns on popover visibility.
+	 * @react-import ```jsx
+	 * import { SearchcraftPopoverButton } from "@searchcraft/react-sdk";
+	 * ````
+	 * @vue-import ```jsx
+	 * import { SearchcraftPopoverButton } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-popover-button>
+	 *   Open popover
+	 * </searchcraft-popover-button>
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const popoverButton = document.querySelector('searchcraft-popover-button');
+	 * popoverButton.template = (isPopoverVisible, { html }) => html`
+	 *   <span>Click me</span>
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPopoverButton
+	 *   template={(isPopoverVisible, { html }) => html`
+	 *     <span>Click me</span>
+	 *   `}
+	 * >
+	 *   Open popover
+	 * </SearchcraftPopoverButton>
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPopoverButton
+	 *   :template={(isPopoverVisible, { html }) => html`
+	 *     <span>Click me</span>
+	 *   `}
+	 * >
+	 *   Open popover
+	 * </SearchcraftPopoverButton>
+	 * ```
+	 */
+	interface SearchcraftPopoverButton {
+		/**
+		  * A callback function responsible for rendering the button contents.
+		 */
+		"template"?: PopoverButtonTemplate;
+		/**
+		  * The type of popover button to render.
+		 */
+		"type"?: "skeuomorphic";
+	}
+	/**
+	 * Renders the footer for the searchcraft-popover-form.
+	 */
+	interface SearchcraftPopoverFooter {
+	}
+	/**
+	 * This web component is designed to display search results in a popover container that dynamically appears when the user interacts with a search input field, or when a popover-button is pressed.
+	 * @react-import ```jsx
+	 * import { SearchcraftPopoverForm } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftPopoverForm } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-popover-form type="inline" />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const popoverForm = document.querySelector('searchcraft-popover-form');
+	 * popoverForm.popoverResultMappings = {};
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPopoverForm type="inline" popoverResultMappings={[]} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPopoverForm type="inline" :popoverResultMappings="[]"" />
+	 * ```
+	 */
+	interface SearchcraftPopoverForm {
+		/**
+		  * The hotkey that activates the popover.
+		 */
+		"hotkey"?: string;
+		/**
+		  * The hotkey modifier that activates the popover. Used together with the `hotkey` prop.
+		 */
+		"hotkeyModifier"?: "ctrl" | "meta" | "alt" | "option";
+		/**
+		  * Formats the content rendered for each result.
+		 */
+		"popoverResultMappings"?: PopoverResultMappings;
+		/**
+		  * The type of popover form to render. - `inline` - Renders inline with the rest of the content on the page. The search results pop over the page content. - `fullscreen` - Renders in fullscreen view. Used together with the `searchcraft-popover-button` component. - `modal` - Renders in a modal view. Used together with the `searchcraft-popover-button` component.
+		 */
+		"type"?: "inline" | "fullscreen" | "modal";
+	}
+	/**
+	 * A single list item rendered in a searchcraft-popover-list-view.
+	 */
+	interface SearchcraftPopoverListItem {
+		/**
+		  * The document position relative to the search results (For Measure)
+		 */
+		"documentPosition": number;
+		"item": SearchClientResponseItem | undefined;
+		"popoverResultMappings": PopoverResultMappings | undefined;
+	}
+	/**
+	 * This web component is designed to display a list of results within a popover interface.
+	 * It is consumed within the `searchcraft-popover-form` component.
+	 * @js-example ```html
+	 * <searchcraft-popover-list-view />
+	 * ```
+	 */
+	interface SearchcraftPopoverListView {
+		"adClientResponseItems": AdClientResponseItem[] | undefined;
+		/**
+		  * The mappings that define how the data in the documents are mapped to the list-view-item elements.
+		 */
+		"popoverResultMappings": PopoverResultMappings | undefined;
+		/**
+		  * The items to render in the list view.
+		 */
+		"searchClientResponseItems": SearchClientResponseItem[] | undefined;
+		"searchResultsPage": number;
+		"searchResultsPerPage": number;
+	}
+	/**
+	 * This web component is designed to display the number of results returned from a search query.
+	 * @react-import ```jsx
+	 * import { SearchcraftResultsInfo } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftResultsInfo } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-results-info />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const resultsInfo = document.querySelector('searchcraft-results-info');
+	 * resultsInfo.template = (info, { html }) => html`
+	 *   ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftResultsInfo
+	 *   template={(info, { html }) => html`
+	 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 *   `}
+	 * />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftResultsInfo
+	 *   :template={(info, { html }) => html`
+	 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 *   `}
+	 * />
+	 * ```
+	 */
+	interface SearchcraftResultsInfo {
+		/**
+		  * A callback function responsible for rendering the results info.
+		 */
+		"template"?: ResultsInfoTemplate;
+	}
+	/**
+	 * This web component is designed to display detailed information for a single search result. Once a query is submitted, the component formats and presents the result.
+	 */
+	interface SearchcraftSearchResult {
+		/**
+		  * The position in the document. Used with the "document_clicked" measure event.
+		 */
+		"documentPosition": number;
+		/**
+		  * The index.
+		 */
+		"index": number;
+		"item"?: SearchClientResponseItem;
+		/**
+		  * A callback function responsible for rendering a result.
+		 */
+		"template"?: SearchResultTemplate<SearchResultTemplateData>;
+	}
+	/**
+	 * This web component is responsible for displaying the results of a search query. Once a query is submitted, the component formats and presents an ordered list of the results.
+	 * @react-import ```jsx
+	 * import { SearchcraftSearchResults } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftSearchResults } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-search-results
+	 *   ad-interval="4"
+	 *   place-ad-at-start="true"
+	 * />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const searchResults = document.querySelector('searchcraft-search-results');
+	 * searchResults.template = (item, index, { html }) => html`
+	 *  <h2>${item.title}</h2>
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftSearchResults
+	 *   adInterval={4}
+	 *   placeAdAtState={true}
+	 *   template={(item, index, { html }) => html`
+	 *     <h2>${item.title}</h2>
+	 *   `}
+	 * />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftSearchResults
+	 *   adInterval={4}
+	 *   placeAdAtState={true}
+	 *   :template={(item, index, { html }) => html`
+	 *     <h2>${item.title}</h2>
+	 *   `}
+	 * />
+	 * ```
+	 */
+	interface SearchcraftSearchResults {
+		/**
+		  * A callback function responsible for rendering a result. Passed to `searchcraft-search-result`.
+		 */
+		"template"?: SearchResultTemplate<SearchResultTemplateData>;
+	}
+	/**
+	 * This web component is designed to choose the number of search results displayed.
+	 * @react-import ```jsx
+	 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-search-results-per-page increment="20" />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftSearchResultsPerPage increment={20} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftSearchResultsPerPage increment="20" />
+	 * ```
+	 */
+	interface SearchcraftSearchResultsPerPage {
+		/**
+		  * The amount the options will increase (e.g. 20 = [20, 40, 60, 80, 100]). The base value is defined by the `searchResultsPerPage` option in the configuration.
+		 */
+		"increment": string | number;
+	}
+	/**
+	 * This web component is designed to allow users to select between a group of options.
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-select
+	 *  inputId="searchcraft-select"
+	 *  name="searchcraft-select"
+	 *  options="[{ label: 'label', value: 'value' }]"
+	 * />
+	 * ```
+	 */
+	interface SearchcraftSelect {
+		/**
+		  * The caption displayed below the select input.
+		 */
+		"caption"?: string;
+		/**
+		  * Whether the select input is disabled.
+		 */
+		"disabled"?: boolean;
+		/**
+		  * The ID for the select input.
+		 */
+		"inputId": string;
+		/**
+		  * The label of the select input.
+		 */
+		"label"?: string;
+		/**
+		  * The ID for the label of the select input.
+		 */
+		"labelId"?: string;
+		/**
+		  * The name of the select input.
+		 */
+		"name": string;
+		/**
+		  * The options for the select input.
+		 */
+		"options": SearchcraftSelectOption[] | string;
+	}
+	/**
+	 * This web component is designed to allow users to select a value from a range defined by a minimum and maximum value. The component renders a slider interface, which can be used to visually choose a value between two boundaries.
+	 */
+	interface SearchcraftSlider {
+		/**
+		  * The type of data allowed.
+		 */
+		"dataType": "number" | "date";
+		/**
+		  * The granularity that the value must adhere to.
+		 */
+		"granularity": number;
+		/**
+		  * The maximum value allowed.
+		 */
+		"max": number;
+		/**
+		  * The minimum value allowed.
+		 */
+		"min": number;
+	}
+	/**
+	 * This web component adds Searchcraft's built-in css theme to your page. It does not render anything visible, its only function is to manage the css styles on the page.'
+	 * @react-import ```jsx
+	 * import { SearchcraftTheme } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftTheme } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-theme />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftTheme />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftTheme />
+	 * ```
+	 */
+	interface SearchcraftTheme {
+	}
+	/**
+	 * This web component simulates a light switch functionality, providing a simple and intuitive toggle between two states—on and off.
+	 */
+	interface SearchcraftToggleButton {
+		/**
+		  * The label.
+		 */
+		"label": string;
+		/**
+		  * The secondary label displayed below the main label.
+		 */
+		"subLabel": string | undefined;
+	}
+}
+export interface SearchcraftButtonCustomEvent<T> extends CustomEvent<T> {
+	detail: T;
+	target: HTMLSearchcraftButtonElement;
+}
+export interface SearchcraftFacetListCustomEvent<T> extends CustomEvent<T> {
+	detail: T;
+	target: HTMLSearchcraftFacetListElement;
+}
+export interface SearchcraftInputFormCustomEvent<T> extends CustomEvent<T> {
+	detail: T;
+	target: HTMLSearchcraftInputFormElement;
+}
+export interface SearchcraftSelectCustomEvent<T> extends CustomEvent<T> {
+	detail: T;
+	target: HTMLSearchcraftSelectElement;
+}
+export interface SearchcraftSliderCustomEvent<T> extends CustomEvent<T> {
+	detail: T;
+	target: HTMLSearchcraftSliderElement;
+}
+export interface SearchcraftToggleButtonCustomEvent<T> extends CustomEvent<T> {
+	detail: T;
+	target: HTMLSearchcraftToggleButtonElement;
+}
+declare global {
+	/**
+	 * An inline ad meant to be rendered in a list of search results.
+	 */
+	interface HTMLSearchcraftAdElement extends Components.SearchcraftAd, HTMLStencilElement {
+	}
+	var HTMLSearchcraftAdElement: {
+		prototype: HTMLSearchcraftAdElement;
+		new (): HTMLSearchcraftAdElement;
+	};
+	interface HTMLSearchcraftButtonElementEventMap {
+		"buttonClick": void;
+	}
+	/**
+	 * This web component represents a button.
+	 * It provides a clear, interactive way for users to submit search queries or trigger actions in a search interface.
+	 */
+	interface HTMLSearchcraftButtonElement extends Components.SearchcraftButton, HTMLStencilElement {
+		addEventListener<K extends keyof HTMLSearchcraftButtonElementEventMap>(type: K, listener: (this: HTMLSearchcraftButtonElement, ev: SearchcraftButtonCustomEvent<HTMLSearchcraftButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLSearchcraftButtonElementEventMap>(type: K, listener: (this: HTMLSearchcraftButtonElement, ev: SearchcraftButtonCustomEvent<HTMLSearchcraftButtonElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+	}
+	var HTMLSearchcraftButtonElement: {
+		prototype: HTMLSearchcraftButtonElement;
+		new (): HTMLSearchcraftButtonElement;
+	};
+	/**
+	 * This web component is designed to display a user-friendly error message when a search query fails, providing clear feedback to users and enhancing their experience when an issue arises during the search process.
+	 * @js-example ```html
+	 * <searchcraft-error-message>
+	 *   No search results found for query
+	 * </searchcraft-error-message>
+	 * ```
+	 */
+	interface HTMLSearchcraftErrorMessageElement extends Components.SearchcraftErrorMessage, HTMLStencilElement {
+	}
+	var HTMLSearchcraftErrorMessageElement: {
+		prototype: HTMLSearchcraftErrorMessageElement;
+		new (): HTMLSearchcraftErrorMessageElement;
+	};
+	interface HTMLSearchcraftFacetListElementEventMap {
+		"facetSelectionUpdated": {
+			paths: string[];
+		};
+	}
+	/**
+	 * This web component is designed to display facets in a search interface, allowing users to refine their search results by applying filters based on various attributes.
+	 * It is consumed within the `searchcraft-filter-panel`.
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-facet-list field-name="title" />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const facetList = document.querySelector('searchcraft-facet-list');
+	 * facetList.addEventListener('facetSelectionUpdated', () => {
+	 *   console.log('Facet selection updated');
+	 * });
+	 * ```
+	 */
+	interface HTMLSearchcraftFacetListElement extends Components.SearchcraftFacetList, HTMLStencilElement {
+		addEventListener<K extends keyof HTMLSearchcraftFacetListElementEventMap>(type: K, listener: (this: HTMLSearchcraftFacetListElement, ev: SearchcraftFacetListCustomEvent<HTMLSearchcraftFacetListElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLSearchcraftFacetListElementEventMap>(type: K, listener: (this: HTMLSearchcraftFacetListElement, ev: SearchcraftFacetListCustomEvent<HTMLSearchcraftFacetListElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+	}
+	var HTMLSearchcraftFacetListElement: {
+		prototype: HTMLSearchcraftFacetListElement;
+		new (): HTMLSearchcraftFacetListElement;
+	};
+	/**
+	 * This web component represents a series of filters that allows users to refine and control their search queries by applying various filter criteria.
+	 * @react-import ```jsx
+	 * import { SearchcraftFilterPanel } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftFilterPanel } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-filter-panel />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const filterPanel = document.querySelector('searchcraft-filter-panel');
+	 * if (filterPanel) {
+	 *   filterPanel.items = [];
+	 * }
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftFilterPanel items={[]} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftFilterPanel :items="[]" />
+	 * ```
+	 */
+	interface HTMLSearchcraftFilterPanelElement extends Components.SearchcraftFilterPanel, HTMLStencilElement {
+	}
+	var HTMLSearchcraftFilterPanelElement: {
+		prototype: HTMLSearchcraftFilterPanelElement;
+		new (): HTMLSearchcraftFilterPanelElement;
+	};
+	interface HTMLSearchcraftInputFormElementEventMap {
+		"inputFocus": void;
+		"inputBlur": void;
+		"inputInit": void;
+	}
+	/**
+	 * This web component provides a user-friendly interface for querying an indexed dataset, enabling users to easily search large collections of data.
+	 * It abstracts the complexities of index-based searching, making it accessible to users of all technical levels.
+	 * @react-import ```jsx
+	 * import { SearchcraftInputForm } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftInputForm } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-input-form auto-search />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftInputForm autoSearch />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftInputForm autoSearch />
+	 * ```
+	 */
+	interface HTMLSearchcraftInputFormElement extends Components.SearchcraftInputForm, HTMLStencilElement {
+		addEventListener<K extends keyof HTMLSearchcraftInputFormElementEventMap>(type: K, listener: (this: HTMLSearchcraftInputFormElement, ev: SearchcraftInputFormCustomEvent<HTMLSearchcraftInputFormElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLSearchcraftInputFormElementEventMap>(type: K, listener: (this: HTMLSearchcraftInputFormElement, ev: SearchcraftInputFormCustomEvent<HTMLSearchcraftInputFormElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+	}
+	var HTMLSearchcraftInputFormElement: {
+		prototype: HTMLSearchcraftInputFormElement;
+		new (): HTMLSearchcraftInputFormElement;
+	};
+	/**
+	 * This web component serves as the input label for the searchcraft-input-form component.
+	 * @js-example ```html
+	 * <searchcraft-input-label label="Search" />
+	 * ```
+	 */
+	interface HTMLSearchcraftInputLabelElement extends Components.SearchcraftInputLabel, HTMLStencilElement {
+	}
+	var HTMLSearchcraftInputLabelElement: {
+		prototype: HTMLSearchcraftInputLabelElement;
+		new (): HTMLSearchcraftInputLabelElement;
+	};
+	/**
+	 * This web component is designed to facilitate pagination of search results. Once a query is submitted, calculates the number for pages.
+	 * @react-import ```jsx
+	 * import { SearchcraftPagination } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftPagination } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-pagination />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPagination />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPagination />
+	 * ```
+	 */
+	interface HTMLSearchcraftPaginationElement extends Components.SearchcraftPagination, HTMLStencilElement {
+	}
+	var HTMLSearchcraftPaginationElement: {
+		prototype: HTMLSearchcraftPaginationElement;
+		new (): HTMLSearchcraftPaginationElement;
+	};
+	/**
+	 * Renders a button which, when clicked, turns on popover visibility.
+	 * @react-import ```jsx
+	 * import { SearchcraftPopoverButton } from "@searchcraft/react-sdk";
+	 * ````
+	 * @vue-import ```jsx
+	 * import { SearchcraftPopoverButton } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-popover-button>
+	 *   Open popover
+	 * </searchcraft-popover-button>
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const popoverButton = document.querySelector('searchcraft-popover-button');
+	 * popoverButton.template = (isPopoverVisible, { html }) => html`
+	 *   <span>Click me</span>
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPopoverButton
+	 *   template={(isPopoverVisible, { html }) => html`
+	 *     <span>Click me</span>
+	 *   `}
+	 * >
+	 *   Open popover
+	 * </SearchcraftPopoverButton>
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPopoverButton
+	 *   :template={(isPopoverVisible, { html }) => html`
+	 *     <span>Click me</span>
+	 *   `}
+	 * >
+	 *   Open popover
+	 * </SearchcraftPopoverButton>
+	 * ```
+	 */
+	interface HTMLSearchcraftPopoverButtonElement extends Components.SearchcraftPopoverButton, HTMLStencilElement {
+	}
+	var HTMLSearchcraftPopoverButtonElement: {
+		prototype: HTMLSearchcraftPopoverButtonElement;
+		new (): HTMLSearchcraftPopoverButtonElement;
+	};
+	/**
+	 * Renders the footer for the searchcraft-popover-form.
+	 */
+	interface HTMLSearchcraftPopoverFooterElement extends Components.SearchcraftPopoverFooter, HTMLStencilElement {
+	}
+	var HTMLSearchcraftPopoverFooterElement: {
+		prototype: HTMLSearchcraftPopoverFooterElement;
+		new (): HTMLSearchcraftPopoverFooterElement;
+	};
+	/**
+	 * This web component is designed to display search results in a popover container that dynamically appears when the user interacts with a search input field, or when a popover-button is pressed.
+	 * @react-import ```jsx
+	 * import { SearchcraftPopoverForm } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftPopoverForm } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-popover-form type="inline" />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const popoverForm = document.querySelector('searchcraft-popover-form');
+	 * popoverForm.popoverResultMappings = {};
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPopoverForm type="inline" popoverResultMappings={[]} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPopoverForm type="inline" :popoverResultMappings="[]"" />
+	 * ```
+	 */
+	interface HTMLSearchcraftPopoverFormElement extends Components.SearchcraftPopoverForm, HTMLStencilElement {
+	}
+	var HTMLSearchcraftPopoverFormElement: {
+		prototype: HTMLSearchcraftPopoverFormElement;
+		new (): HTMLSearchcraftPopoverFormElement;
+	};
+	/**
+	 * A single list item rendered in a searchcraft-popover-list-view.
+	 */
+	interface HTMLSearchcraftPopoverListItemElement extends Components.SearchcraftPopoverListItem, HTMLStencilElement {
+	}
+	var HTMLSearchcraftPopoverListItemElement: {
+		prototype: HTMLSearchcraftPopoverListItemElement;
+		new (): HTMLSearchcraftPopoverListItemElement;
+	};
+	/**
+	 * This web component is designed to display a list of results within a popover interface.
+	 * It is consumed within the `searchcraft-popover-form` component.
+	 * @js-example ```html
+	 * <searchcraft-popover-list-view />
+	 * ```
+	 */
+	interface HTMLSearchcraftPopoverListViewElement extends Components.SearchcraftPopoverListView, HTMLStencilElement {
+	}
+	var HTMLSearchcraftPopoverListViewElement: {
+		prototype: HTMLSearchcraftPopoverListViewElement;
+		new (): HTMLSearchcraftPopoverListViewElement;
+	};
+	/**
+	 * This web component is designed to display the number of results returned from a search query.
+	 * @react-import ```jsx
+	 * import { SearchcraftResultsInfo } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftResultsInfo } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-results-info />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const resultsInfo = document.querySelector('searchcraft-results-info');
+	 * resultsInfo.template = (info, { html }) => html`
+	 *   ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftResultsInfo
+	 *   template={(info, { html }) => html`
+	 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 *   `}
+	 * />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftResultsInfo
+	 *   :template={(info, { html }) => html`
+	 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 *   `}
+	 * />
+	 * ```
+	 */
+	interface HTMLSearchcraftResultsInfoElement extends Components.SearchcraftResultsInfo, HTMLStencilElement {
+	}
+	var HTMLSearchcraftResultsInfoElement: {
+		prototype: HTMLSearchcraftResultsInfoElement;
+		new (): HTMLSearchcraftResultsInfoElement;
+	};
+	/**
+	 * This web component is designed to display detailed information for a single search result. Once a query is submitted, the component formats and presents the result.
+	 */
+	interface HTMLSearchcraftSearchResultElement extends Components.SearchcraftSearchResult, HTMLStencilElement {
+	}
+	var HTMLSearchcraftSearchResultElement: {
+		prototype: HTMLSearchcraftSearchResultElement;
+		new (): HTMLSearchcraftSearchResultElement;
+	};
+	/**
+	 * This web component is responsible for displaying the results of a search query. Once a query is submitted, the component formats and presents an ordered list of the results.
+	 * @react-import ```jsx
+	 * import { SearchcraftSearchResults } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftSearchResults } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-search-results
+	 *   ad-interval="4"
+	 *   place-ad-at-start="true"
+	 * />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const searchResults = document.querySelector('searchcraft-search-results');
+	 * searchResults.template = (item, index, { html }) => html`
+	 *  <h2>${item.title}</h2>
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftSearchResults
+	 *   adInterval={4}
+	 *   placeAdAtState={true}
+	 *   template={(item, index, { html }) => html`
+	 *     <h2>${item.title}</h2>
+	 *   `}
+	 * />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftSearchResults
+	 *   adInterval={4}
+	 *   placeAdAtState={true}
+	 *   :template={(item, index, { html }) => html`
+	 *     <h2>${item.title}</h2>
+	 *   `}
+	 * />
+	 * ```
+	 */
+	interface HTMLSearchcraftSearchResultsElement extends Components.SearchcraftSearchResults, HTMLStencilElement {
+	}
+	var HTMLSearchcraftSearchResultsElement: {
+		prototype: HTMLSearchcraftSearchResultsElement;
+		new (): HTMLSearchcraftSearchResultsElement;
+	};
+	/**
+	 * This web component is designed to choose the number of search results displayed.
+	 * @react-import ```jsx
+	 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-search-results-per-page increment="20" />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftSearchResultsPerPage increment={20} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftSearchResultsPerPage increment="20" />
+	 * ```
+	 */
+	interface HTMLSearchcraftSearchResultsPerPageElement extends Components.SearchcraftSearchResultsPerPage, HTMLStencilElement {
+	}
+	var HTMLSearchcraftSearchResultsPerPageElement: {
+		prototype: HTMLSearchcraftSearchResultsPerPageElement;
+		new (): HTMLSearchcraftSearchResultsPerPageElement;
+	};
+	interface HTMLSearchcraftSelectElementEventMap {
+		"selectChange": string;
+	}
+	/**
+	 * This web component is designed to allow users to select between a group of options.
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-select
+	 *  inputId="searchcraft-select"
+	 *  name="searchcraft-select"
+	 *  options="[{ label: 'label', value: 'value' }]"
+	 * />
+	 * ```
+	 */
+	interface HTMLSearchcraftSelectElement extends Components.SearchcraftSelect, HTMLStencilElement {
+		addEventListener<K extends keyof HTMLSearchcraftSelectElementEventMap>(type: K, listener: (this: HTMLSearchcraftSelectElement, ev: SearchcraftSelectCustomEvent<HTMLSearchcraftSelectElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLSearchcraftSelectElementEventMap>(type: K, listener: (this: HTMLSearchcraftSelectElement, ev: SearchcraftSelectCustomEvent<HTMLSearchcraftSelectElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+	}
+	var HTMLSearchcraftSelectElement: {
+		prototype: HTMLSearchcraftSelectElement;
+		new (): HTMLSearchcraftSelectElement;
+	};
+	interface HTMLSearchcraftSliderElementEventMap {
+		"rangeChanged": any;
+	}
+	/**
+	 * This web component is designed to allow users to select a value from a range defined by a minimum and maximum value. The component renders a slider interface, which can be used to visually choose a value between two boundaries.
+	 */
+	interface HTMLSearchcraftSliderElement extends Components.SearchcraftSlider, HTMLStencilElement {
+		addEventListener<K extends keyof HTMLSearchcraftSliderElementEventMap>(type: K, listener: (this: HTMLSearchcraftSliderElement, ev: SearchcraftSliderCustomEvent<HTMLSearchcraftSliderElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLSearchcraftSliderElementEventMap>(type: K, listener: (this: HTMLSearchcraftSliderElement, ev: SearchcraftSliderCustomEvent<HTMLSearchcraftSliderElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+	}
+	var HTMLSearchcraftSliderElement: {
+		prototype: HTMLSearchcraftSliderElement;
+		new (): HTMLSearchcraftSliderElement;
+	};
+	/**
+	 * This web component adds Searchcraft's built-in css theme to your page. It does not render anything visible, its only function is to manage the css styles on the page.'
+	 * @react-import ```jsx
+	 * import { SearchcraftTheme } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftTheme } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-theme />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftTheme />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftTheme />
+	 * ```
+	 */
+	interface HTMLSearchcraftThemeElement extends Components.SearchcraftTheme, HTMLStencilElement {
+	}
+	var HTMLSearchcraftThemeElement: {
+		prototype: HTMLSearchcraftThemeElement;
+		new (): HTMLSearchcraftThemeElement;
+	};
+	interface HTMLSearchcraftToggleButtonElementEventMap {
+		"toggleUpdated": boolean;
+	}
+	/**
+	 * This web component simulates a light switch functionality, providing a simple and intuitive toggle between two states—on and off.
+	 */
+	interface HTMLSearchcraftToggleButtonElement extends Components.SearchcraftToggleButton, HTMLStencilElement {
+		addEventListener<K extends keyof HTMLSearchcraftToggleButtonElementEventMap>(type: K, listener: (this: HTMLSearchcraftToggleButtonElement, ev: SearchcraftToggleButtonCustomEvent<HTMLSearchcraftToggleButtonElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+		addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLSearchcraftToggleButtonElementEventMap>(type: K, listener: (this: HTMLSearchcraftToggleButtonElement, ev: SearchcraftToggleButtonCustomEvent<HTMLSearchcraftToggleButtonElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+		removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+	}
+	var HTMLSearchcraftToggleButtonElement: {
+		prototype: HTMLSearchcraftToggleButtonElement;
+		new (): HTMLSearchcraftToggleButtonElement;
+	};
+	interface HTMLElementTagNameMap {
+		"searchcraft-ad": HTMLSearchcraftAdElement;
+		"searchcraft-button": HTMLSearchcraftButtonElement;
+		"searchcraft-error-message": HTMLSearchcraftErrorMessageElement;
+		"searchcraft-facet-list": HTMLSearchcraftFacetListElement;
+		"searchcraft-filter-panel": HTMLSearchcraftFilterPanelElement;
+		"searchcraft-input-form": HTMLSearchcraftInputFormElement;
+		"searchcraft-input-label": HTMLSearchcraftInputLabelElement;
+		"searchcraft-pagination": HTMLSearchcraftPaginationElement;
+		"searchcraft-popover-button": HTMLSearchcraftPopoverButtonElement;
+		"searchcraft-popover-footer": HTMLSearchcraftPopoverFooterElement;
+		"searchcraft-popover-form": HTMLSearchcraftPopoverFormElement;
+		"searchcraft-popover-list-item": HTMLSearchcraftPopoverListItemElement;
+		"searchcraft-popover-list-view": HTMLSearchcraftPopoverListViewElement;
+		"searchcraft-results-info": HTMLSearchcraftResultsInfoElement;
+		"searchcraft-search-result": HTMLSearchcraftSearchResultElement;
+		"searchcraft-search-results": HTMLSearchcraftSearchResultsElement;
+		"searchcraft-search-results-per-page": HTMLSearchcraftSearchResultsPerPageElement;
+		"searchcraft-select": HTMLSearchcraftSelectElement;
+		"searchcraft-slider": HTMLSearchcraftSliderElement;
+		"searchcraft-theme": HTMLSearchcraftThemeElement;
+		"searchcraft-toggle-button": HTMLSearchcraftToggleButtonElement;
+	}
+}
+declare namespace LocalJSX {
+	/**
+	 * An inline ad meant to be rendered in a list of search results.
+	 */
+	interface SearchcraftAd {
+		"adClientResponseItem"?: AdClientResponseItem;
+		"adContainerId"?: string;
+		"adSource"?: SearchcraftAdSource;
+	}
+	/**
+	 * This web component represents a button.
+	 * It provides a clear, interactive way for users to submit search queries or trigger actions in a search interface.
+	 */
+	interface SearchcraftButton {
+		/**
+		  * Whether the button is disabled.
+		 */
+		"disabled"?: boolean;
+		/**
+		  * Controls the visual representation of the button.
+		 */
+		"hierarchy"?: "primary" | "tertiary";
+		/**
+		  * The icon element.
+		 */
+		"icon"?: Element;
+		/**
+		  * Should the button only display an icon.
+		 */
+		"iconOnly"?: boolean;
+		/**
+		  * The position of the icon.
+		 */
+		"iconPosition"?: "left" | "right";
+		/**
+		  * The label for the button.
+		 */
+		"label"?: string;
+		/**
+		  * The event fired when the button is clicked.
+		 */
+		"onButtonClick"?: (event: SearchcraftButtonCustomEvent<void>) => void;
+		/**
+		  * The type of the button.
+		 */
+		"type"?: "submit" | "reset" | "button";
+	}
+	/**
+	 * This web component is designed to display a user-friendly error message when a search query fails, providing clear feedback to users and enhancing their experience when an issue arises during the search process.
+	 * @js-example ```html
+	 * <searchcraft-error-message>
+	 *   No search results found for query
+	 * </searchcraft-error-message>
+	 * ```
+	 */
+	interface SearchcraftErrorMessage {
+	}
+	/**
+	 * This web component is designed to display facets in a search interface, allowing users to refine their search results by applying filters based on various attributes.
+	 * It is consumed within the `searchcraft-filter-panel`.
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-facet-list field-name="title" />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const facetList = document.querySelector('searchcraft-facet-list');
+	 * facetList.addEventListener('facetSelectionUpdated', () => {
+	 *   console.log('Facet selection updated');
+	 * });
+	 * ```
+	 */
+	interface SearchcraftFacetList {
+		/**
+		  * The name of the field where facets are applied.
+		 */
+		"fieldName"?: string;
+		/**
+		  * When the facets are updated.
+		 */
+		"onFacetSelectionUpdated"?: (event: SearchcraftFacetListCustomEvent<{
+			paths: string[];
+		}>) => void;
+	}
+	/**
+	 * This web component represents a series of filters that allows users to refine and control their search queries by applying various filter criteria.
+	 * @react-import ```jsx
+	 * import { SearchcraftFilterPanel } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftFilterPanel } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-filter-panel />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const filterPanel = document.querySelector('searchcraft-filter-panel');
+	 * if (filterPanel) {
+	 *   filterPanel.items = [];
+	 * }
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftFilterPanel items={[]} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftFilterPanel :items="[]" />
+	 * ```
+	 */
+	interface SearchcraftFilterPanel {
+		/**
+		  * The items to filter.
+		 */
+		"items"?: FilterItem[];
+	}
+	/**
+	 * This web component provides a user-friendly interface for querying an indexed dataset, enabling users to easily search large collections of data.
+	 * It abstracts the complexities of index-based searching, making it accessible to users of all technical levels.
+	 * @react-import ```jsx
+	 * import { SearchcraftInputForm } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftInputForm } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-input-form auto-search />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftInputForm autoSearch />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftInputForm autoSearch />
+	 * ```
+	 */
+	interface SearchcraftInputForm {
+		/**
+		  * Whether or not to automatically submit the search term when the input changes.
+		 */
+		"autoSearch"?: boolean;
+		/**
+		  * The label for the submit button.
+		 */
+		"buttonLabel"?: string;
+		/**
+		  * Where to place the search button.
+		 */
+		"buttonPlacement"?: "left" | "right" | "none";
+		"core"?: SearchcraftCore;
+		/**
+		  * The label rendered above the input.
+		 */
+		"inputLabel"?: string;
+		/**
+		  * When the input becomes unfocused.
+		 */
+		"onInputBlur"?: (event: SearchcraftInputFormCustomEvent<void>) => void;
+		/**
+		  * When the input becomes focused.
+		 */
+		"onInputFocus"?: (event: SearchcraftInputFormCustomEvent<void>) => void;
+		/**
+		  * Event emitted when input initializes.
+		 */
+		"onInputInit"?: (event: SearchcraftInputFormCustomEvent<void>) => void;
+		/**
+		  * The input element's placeholder value.
+		 */
+		"placeholderValue"?: string;
+	}
+	/**
+	 * This web component serves as the input label for the searchcraft-input-form component.
+	 * @js-example ```html
+	 * <searchcraft-input-label label="Search" />
+	 * ```
+	 */
+	interface SearchcraftInputLabel {
+		/**
+		  * The classname applied to the label element.
+		 */
+		"inputLabelClassName"?: string | undefined;
+		"label"?: string;
+	}
+	/**
+	 * This web component is designed to facilitate pagination of search results. Once a query is submitted, calculates the number for pages.
+	 * @react-import ```jsx
+	 * import { SearchcraftPagination } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftPagination } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-pagination />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPagination />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPagination />
+	 * ```
+	 */
+	interface SearchcraftPagination {
+	}
+	/**
+	 * Renders a button which, when clicked, turns on popover visibility.
+	 * @react-import ```jsx
+	 * import { SearchcraftPopoverButton } from "@searchcraft/react-sdk";
+	 * ````
+	 * @vue-import ```jsx
+	 * import { SearchcraftPopoverButton } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-popover-button>
+	 *   Open popover
+	 * </searchcraft-popover-button>
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const popoverButton = document.querySelector('searchcraft-popover-button');
+	 * popoverButton.template = (isPopoverVisible, { html }) => html`
+	 *   <span>Click me</span>
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPopoverButton
+	 *   template={(isPopoverVisible, { html }) => html`
+	 *     <span>Click me</span>
+	 *   `}
+	 * >
+	 *   Open popover
+	 * </SearchcraftPopoverButton>
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPopoverButton
+	 *   :template={(isPopoverVisible, { html }) => html`
+	 *     <span>Click me</span>
+	 *   `}
+	 * >
+	 *   Open popover
+	 * </SearchcraftPopoverButton>
+	 * ```
+	 */
+	interface SearchcraftPopoverButton {
+		/**
+		  * A callback function responsible for rendering the button contents.
+		 */
+		"template"?: PopoverButtonTemplate;
+		/**
+		  * The type of popover button to render.
+		 */
+		"type"?: "skeuomorphic";
+	}
+	/**
+	 * Renders the footer for the searchcraft-popover-form.
+	 */
+	interface SearchcraftPopoverFooter {
+	}
+	/**
+	 * This web component is designed to display search results in a popover container that dynamically appears when the user interacts with a search input field, or when a popover-button is pressed.
+	 * @react-import ```jsx
+	 * import { SearchcraftPopoverForm } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftPopoverForm } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-popover-form type="inline" />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const popoverForm = document.querySelector('searchcraft-popover-form');
+	 * popoverForm.popoverResultMappings = {};
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftPopoverForm type="inline" popoverResultMappings={[]} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftPopoverForm type="inline" :popoverResultMappings="[]"" />
+	 * ```
+	 */
+	interface SearchcraftPopoverForm {
+		/**
+		  * The hotkey that activates the popover.
+		 */
+		"hotkey"?: string;
+		/**
+		  * The hotkey modifier that activates the popover. Used together with the `hotkey` prop.
+		 */
+		"hotkeyModifier"?: "ctrl" | "meta" | "alt" | "option";
+		/**
+		  * Formats the content rendered for each result.
+		 */
+		"popoverResultMappings"?: PopoverResultMappings;
+		/**
+		  * The type of popover form to render. - `inline` - Renders inline with the rest of the content on the page. The search results pop over the page content. - `fullscreen` - Renders in fullscreen view. Used together with the `searchcraft-popover-button` component. - `modal` - Renders in a modal view. Used together with the `searchcraft-popover-button` component.
+		 */
+		"type"?: "inline" | "fullscreen" | "modal";
+	}
+	/**
+	 * A single list item rendered in a searchcraft-popover-list-view.
+	 */
+	interface SearchcraftPopoverListItem {
+		/**
+		  * The document position relative to the search results (For Measure)
+		 */
+		"documentPosition"?: number;
+		"item"?: SearchClientResponseItem | undefined;
+		"popoverResultMappings"?: PopoverResultMappings | undefined;
+	}
+	/**
+	 * This web component is designed to display a list of results within a popover interface.
+	 * It is consumed within the `searchcraft-popover-form` component.
+	 * @js-example ```html
+	 * <searchcraft-popover-list-view />
+	 * ```
+	 */
+	interface SearchcraftPopoverListView {
+		"adClientResponseItems"?: AdClientResponseItem[] | undefined;
+		/**
+		  * The mappings that define how the data in the documents are mapped to the list-view-item elements.
+		 */
+		"popoverResultMappings"?: PopoverResultMappings | undefined;
+		/**
+		  * The items to render in the list view.
+		 */
+		"searchClientResponseItems"?: SearchClientResponseItem[] | undefined;
+		"searchResultsPage": number;
+		"searchResultsPerPage": number;
+	}
+	/**
+	 * This web component is designed to display the number of results returned from a search query.
+	 * @react-import ```jsx
+	 * import { SearchcraftResultsInfo } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftResultsInfo } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-results-info />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const resultsInfo = document.querySelector('searchcraft-results-info');
+	 * resultsInfo.template = (info, { html }) => html`
+	 *   ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftResultsInfo
+	 *   template={(info, { html }) => html`
+	 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 *   `}
+	 * />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftResultsInfo
+	 *   :template={(info, { html }) => html`
+	 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+	 *   `}
+	 * />
+	 * ```
+	 */
+	interface SearchcraftResultsInfo {
+		/**
+		  * A callback function responsible for rendering the results info.
+		 */
+		"template"?: ResultsInfoTemplate;
+	}
+	/**
+	 * This web component is designed to display detailed information for a single search result. Once a query is submitted, the component formats and presents the result.
+	 */
+	interface SearchcraftSearchResult {
+		/**
+		  * The position in the document. Used with the "document_clicked" measure event.
+		 */
+		"documentPosition"?: number;
+		/**
+		  * The index.
+		 */
+		"index": number;
+		"item"?: SearchClientResponseItem;
+		/**
+		  * A callback function responsible for rendering a result.
+		 */
+		"template"?: SearchResultTemplate<SearchResultTemplateData>;
+	}
+	/**
+	 * This web component is responsible for displaying the results of a search query. Once a query is submitted, the component formats and presents an ordered list of the results.
+	 * @react-import ```jsx
+	 * import { SearchcraftSearchResults } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftSearchResults } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-search-results
+	 *   ad-interval="4"
+	 *   place-ad-at-start="true"
+	 * />
+	 * ```
+	 * ```js
+	 * // index.js
+	 * const searchResults = document.querySelector('searchcraft-search-results');
+	 * searchResults.template = (item, index, { html }) => html`
+	 *  <h2>${item.title}</h2>
+	 * `;
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftSearchResults
+	 *   adInterval={4}
+	 *   placeAdAtState={true}
+	 *   template={(item, index, { html }) => html`
+	 *     <h2>${item.title}</h2>
+	 *   `}
+	 * />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftSearchResults
+	 *   adInterval={4}
+	 *   placeAdAtState={true}
+	 *   :template={(item, index, { html }) => html`
+	 *     <h2>${item.title}</h2>
+	 *   `}
+	 * />
+	 * ```
+	 */
+	interface SearchcraftSearchResults {
+		/**
+		  * A callback function responsible for rendering a result. Passed to `searchcraft-search-result`.
+		 */
+		"template"?: SearchResultTemplate<SearchResultTemplateData>;
+	}
+	/**
+	 * This web component is designed to choose the number of search results displayed.
+	 * @react-import ```jsx
+	 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-search-results-per-page increment="20" />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftSearchResultsPerPage increment={20} />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftSearchResultsPerPage increment="20" />
+	 * ```
+	 */
+	interface SearchcraftSearchResultsPerPage {
+		/**
+		  * The amount the options will increase (e.g. 20 = [20, 40, 60, 80, 100]). The base value is defined by the `searchResultsPerPage` option in the configuration.
+		 */
+		"increment"?: string | number;
+	}
+	/**
+	 * This web component is designed to allow users to select between a group of options.
+	 * @js-example ```html
+	 * <!-- index.html -->
+	 * <searchcraft-select
+	 *  inputId="searchcraft-select"
+	 *  name="searchcraft-select"
+	 *  options="[{ label: 'label', value: 'value' }]"
+	 * />
+	 * ```
+	 */
+	interface SearchcraftSelect {
+		/**
+		  * The caption displayed below the select input.
+		 */
+		"caption"?: string;
+		/**
+		  * Whether the select input is disabled.
+		 */
+		"disabled"?: boolean;
+		/**
+		  * The ID for the select input.
+		 */
+		"inputId": string;
+		/**
+		  * The label of the select input.
+		 */
+		"label"?: string;
+		/**
+		  * The ID for the label of the select input.
+		 */
+		"labelId"?: string;
+		/**
+		  * The name of the select input.
+		 */
+		"name": string;
+		/**
+		  * The event fired when the select is changed.
+		 */
+		"onSelectChange"?: (event: SearchcraftSelectCustomEvent<string>) => void;
+		/**
+		  * The options for the select input.
+		 */
+		"options"?: SearchcraftSelectOption[] | string;
+	}
+	/**
+	 * This web component is designed to allow users to select a value from a range defined by a minimum and maximum value. The component renders a slider interface, which can be used to visually choose a value between two boundaries.
+	 */
+	interface SearchcraftSlider {
+		/**
+		  * The type of data allowed.
+		 */
+		"dataType"?: "number" | "date";
+		/**
+		  * The granularity that the value must adhere to.
+		 */
+		"granularity"?: number;
+		/**
+		  * The maximum value allowed.
+		 */
+		"max"?: number;
+		/**
+		  * The minimum value allowed.
+		 */
+		"min"?: number;
+		/**
+		  * When the range has changed.
+		 */
+		"onRangeChanged"?: (event: SearchcraftSliderCustomEvent<any>) => void;
+	}
+	/**
+	 * This web component adds Searchcraft's built-in css theme to your page. It does not render anything visible, its only function is to manage the css styles on the page.'
+	 * @react-import ```jsx
+	 * import { SearchcraftTheme } from "@searchcraft/react-sdk";
+	 * ```
+	 * @vue-import ```jsx
+	 * import { SearchcraftTheme } from "@searchcraft/vue-sdk";
+	 * ```
+	 * @js-example ```html
+	 * <searchcraft-theme />
+	 * ```
+	 * @react-example ```jsx
+	 * <SearchcraftTheme />
+	 * ```
+	 * @vue-example ```jsx
+	 * <SearchcraftTheme />
+	 * ```
+	 */
+	interface SearchcraftTheme {
+	}
+	/**
+	 * This web component simulates a light switch functionality, providing a simple and intuitive toggle between two states—on and off.
+	 */
+	interface SearchcraftToggleButton {
+		/**
+		  * The label.
+		 */
+		"label"?: string;
+		/**
+		  * When the toggle element is changed.
+		 */
+		"onToggleUpdated"?: (event: SearchcraftToggleButtonCustomEvent<boolean>) => void;
+		/**
+		  * The secondary label displayed below the main label.
+		 */
+		"subLabel"?: string | undefined;
+	}
+	interface IntrinsicElements {
+		"searchcraft-ad": SearchcraftAd;
+		"searchcraft-button": SearchcraftButton;
+		"searchcraft-error-message": SearchcraftErrorMessage;
+		"searchcraft-facet-list": SearchcraftFacetList;
+		"searchcraft-filter-panel": SearchcraftFilterPanel;
+		"searchcraft-input-form": SearchcraftInputForm;
+		"searchcraft-input-label": SearchcraftInputLabel;
+		"searchcraft-pagination": SearchcraftPagination;
+		"searchcraft-popover-button": SearchcraftPopoverButton;
+		"searchcraft-popover-footer": SearchcraftPopoverFooter;
+		"searchcraft-popover-form": SearchcraftPopoverForm;
+		"searchcraft-popover-list-item": SearchcraftPopoverListItem;
+		"searchcraft-popover-list-view": SearchcraftPopoverListView;
+		"searchcraft-results-info": SearchcraftResultsInfo;
+		"searchcraft-search-result": SearchcraftSearchResult;
+		"searchcraft-search-results": SearchcraftSearchResults;
+		"searchcraft-search-results-per-page": SearchcraftSearchResultsPerPage;
+		"searchcraft-select": SearchcraftSelect;
+		"searchcraft-slider": SearchcraftSlider;
+		"searchcraft-theme": SearchcraftTheme;
+		"searchcraft-toggle-button": SearchcraftToggleButton;
+	}
+}
+declare module "@stencil/core" {
+	export namespace JSX {
+		interface IntrinsicElements {
+			/**
+			 * An inline ad meant to be rendered in a list of search results.
+			 */
+			"searchcraft-ad": LocalJSX.SearchcraftAd & JSXBase.HTMLAttributes<HTMLSearchcraftAdElement>;
+			/**
+			 * This web component represents a button.
+			 * It provides a clear, interactive way for users to submit search queries or trigger actions in a search interface.
+			 */
+			"searchcraft-button": LocalJSX.SearchcraftButton & JSXBase.HTMLAttributes<HTMLSearchcraftButtonElement>;
+			/**
+			 * This web component is designed to display a user-friendly error message when a search query fails, providing clear feedback to users and enhancing their experience when an issue arises during the search process.
+			 * @js-example ```html
+			 * <searchcraft-error-message>
+			 *   No search results found for query
+			 * </searchcraft-error-message>
+			 * ```
+			 */
+			"searchcraft-error-message": LocalJSX.SearchcraftErrorMessage & JSXBase.HTMLAttributes<HTMLSearchcraftErrorMessageElement>;
+			/**
+			 * This web component is designed to display facets in a search interface, allowing users to refine their search results by applying filters based on various attributes.
+			 * It is consumed within the `searchcraft-filter-panel`.
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-facet-list field-name="title" />
+			 * ```
+			 * ```js
+			 * // index.js
+			 * const facetList = document.querySelector('searchcraft-facet-list');
+			 * facetList.addEventListener('facetSelectionUpdated', () => {
+			 *   console.log('Facet selection updated');
+			 * });
+			 * ```
+			 */
+			"searchcraft-facet-list": LocalJSX.SearchcraftFacetList & JSXBase.HTMLAttributes<HTMLSearchcraftFacetListElement>;
+			/**
+			 * This web component represents a series of filters that allows users to refine and control their search queries by applying various filter criteria.
+			 * @react-import ```jsx
+			 * import { SearchcraftFilterPanel } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftFilterPanel } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-filter-panel />
+			 * ```
+			 * ```js
+			 * // index.js
+			 * const filterPanel = document.querySelector('searchcraft-filter-panel');
+			 * if (filterPanel) {
+			 *   filterPanel.items = [];
+			 * }
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftFilterPanel items={[]} />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftFilterPanel :items="[]" />
+			 * ```
+			 */
+			"searchcraft-filter-panel": LocalJSX.SearchcraftFilterPanel & JSXBase.HTMLAttributes<HTMLSearchcraftFilterPanelElement>;
+			/**
+			 * This web component provides a user-friendly interface for querying an indexed dataset, enabling users to easily search large collections of data.
+			 * It abstracts the complexities of index-based searching, making it accessible to users of all technical levels.
+			 * @react-import ```jsx
+			 * import { SearchcraftInputForm } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftInputForm } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <searchcraft-input-form auto-search />
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftInputForm autoSearch />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftInputForm autoSearch />
+			 * ```
+			 */
+			"searchcraft-input-form": LocalJSX.SearchcraftInputForm & JSXBase.HTMLAttributes<HTMLSearchcraftInputFormElement>;
+			/**
+			 * This web component serves as the input label for the searchcraft-input-form component.
+			 * @js-example ```html
+			 * <searchcraft-input-label label="Search" />
+			 * ```
+			 */
+			"searchcraft-input-label": LocalJSX.SearchcraftInputLabel & JSXBase.HTMLAttributes<HTMLSearchcraftInputLabelElement>;
+			/**
+			 * This web component is designed to facilitate pagination of search results. Once a query is submitted, calculates the number for pages.
+			 * @react-import ```jsx
+			 * import { SearchcraftPagination } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftPagination } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <searchcraft-pagination />
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftPagination />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftPagination />
+			 * ```
+			 */
+			"searchcraft-pagination": LocalJSX.SearchcraftPagination & JSXBase.HTMLAttributes<HTMLSearchcraftPaginationElement>;
+			/**
+			 * Renders a button which, when clicked, turns on popover visibility.
+			 * @react-import ```jsx
+			 * import { SearchcraftPopoverButton } from "@searchcraft/react-sdk";
+			 * ````
+			 * @vue-import ```jsx
+			 * import { SearchcraftPopoverButton } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-popover-button>
+			 *   Open popover
+			 * </searchcraft-popover-button>
+			 * ```
+			 * ```js
+			 * // index.js
+			 * const popoverButton = document.querySelector('searchcraft-popover-button');
+			 * popoverButton.template = (isPopoverVisible, { html }) => html`
+			 *   <span>Click me</span>
+			 * `;
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftPopoverButton
+			 *   template={(isPopoverVisible, { html }) => html`
+			 *     <span>Click me</span>
+			 *   `}
+			 * >
+			 *   Open popover
+			 * </SearchcraftPopoverButton>
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftPopoverButton
+			 *   :template={(isPopoverVisible, { html }) => html`
+			 *     <span>Click me</span>
+			 *   `}
+			 * >
+			 *   Open popover
+			 * </SearchcraftPopoverButton>
+			 * ```
+			 */
+			"searchcraft-popover-button": LocalJSX.SearchcraftPopoverButton & JSXBase.HTMLAttributes<HTMLSearchcraftPopoverButtonElement>;
+			/**
+			 * Renders the footer for the searchcraft-popover-form.
+			 */
+			"searchcraft-popover-footer": LocalJSX.SearchcraftPopoverFooter & JSXBase.HTMLAttributes<HTMLSearchcraftPopoverFooterElement>;
+			/**
+			 * This web component is designed to display search results in a popover container that dynamically appears when the user interacts with a search input field, or when a popover-button is pressed.
+			 * @react-import ```jsx
+			 * import { SearchcraftPopoverForm } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftPopoverForm } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-popover-form type="inline" />
+			 * ```
+			 * ```js
+			 * // index.js
+			 * const popoverForm = document.querySelector('searchcraft-popover-form');
+			 * popoverForm.popoverResultMappings = {};
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftPopoverForm type="inline" popoverResultMappings={[]} />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftPopoverForm type="inline" :popoverResultMappings="[]"" />
+			 * ```
+			 */
+			"searchcraft-popover-form": LocalJSX.SearchcraftPopoverForm & JSXBase.HTMLAttributes<HTMLSearchcraftPopoverFormElement>;
+			/**
+			 * A single list item rendered in a searchcraft-popover-list-view.
+			 */
+			"searchcraft-popover-list-item": LocalJSX.SearchcraftPopoverListItem & JSXBase.HTMLAttributes<HTMLSearchcraftPopoverListItemElement>;
+			/**
+			 * This web component is designed to display a list of results within a popover interface.
+			 * It is consumed within the `searchcraft-popover-form` component.
+			 * @js-example ```html
+			 * <searchcraft-popover-list-view />
+			 * ```
+			 */
+			"searchcraft-popover-list-view": LocalJSX.SearchcraftPopoverListView & JSXBase.HTMLAttributes<HTMLSearchcraftPopoverListViewElement>;
+			/**
+			 * This web component is designed to display the number of results returned from a search query.
+			 * @react-import ```jsx
+			 * import { SearchcraftResultsInfo } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftResultsInfo } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-results-info />
+			 * ```
+			 * ```js
+			 * // index.js
+			 * const resultsInfo = document.querySelector('searchcraft-results-info');
+			 * resultsInfo.template = (info, { html }) => html`
+			 *   ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+			 * `;
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftResultsInfo
+			 *   template={(info, { html }) => html`
+			 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+			 *   `}
+			 * />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftResultsInfo
+			 *   :template={(info, { html }) => html`
+			 *     ${info.range[0]}-${info.range[1]} of ${info.count} results in ${info.responseTime}ms
+			 *   `}
+			 * />
+			 * ```
+			 */
+			"searchcraft-results-info": LocalJSX.SearchcraftResultsInfo & JSXBase.HTMLAttributes<HTMLSearchcraftResultsInfoElement>;
+			/**
+			 * This web component is designed to display detailed information for a single search result. Once a query is submitted, the component formats and presents the result.
+			 */
+			"searchcraft-search-result": LocalJSX.SearchcraftSearchResult & JSXBase.HTMLAttributes<HTMLSearchcraftSearchResultElement>;
+			/**
+			 * This web component is responsible for displaying the results of a search query. Once a query is submitted, the component formats and presents an ordered list of the results.
+			 * @react-import ```jsx
+			 * import { SearchcraftSearchResults } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftSearchResults } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-search-results
+			 *   ad-interval="4"
+			 *   place-ad-at-start="true"
+			 * />
+			 * ```
+			 * ```js
+			 * // index.js
+			 * const searchResults = document.querySelector('searchcraft-search-results');
+			 * searchResults.template = (item, index, { html }) => html`
+			 *  <h2>${item.title}</h2>
+			 * `;
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftSearchResults
+			 *   adInterval={4}
+			 *   placeAdAtState={true}
+			 *   template={(item, index, { html }) => html`
+			 *     <h2>${item.title}</h2>
+			 *   `}
+			 * />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftSearchResults
+			 *   adInterval={4}
+			 *   placeAdAtState={true}
+			 *   :template={(item, index, { html }) => html`
+			 *     <h2>${item.title}</h2>
+			 *   `}
+			 * />
+			 * ```
+			 */
+			"searchcraft-search-results": LocalJSX.SearchcraftSearchResults & JSXBase.HTMLAttributes<HTMLSearchcraftSearchResultsElement>;
+			/**
+			 * This web component is designed to choose the number of search results displayed.
+			 * @react-import ```jsx
+			 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftSearchResultsPerPage } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-search-results-per-page increment="20" />
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftSearchResultsPerPage increment={20} />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftSearchResultsPerPage increment="20" />
+			 * ```
+			 */
+			"searchcraft-search-results-per-page": LocalJSX.SearchcraftSearchResultsPerPage & JSXBase.HTMLAttributes<HTMLSearchcraftSearchResultsPerPageElement>;
+			/**
+			 * This web component is designed to allow users to select between a group of options.
+			 * @js-example ```html
+			 * <!-- index.html -->
+			 * <searchcraft-select
+			 *  inputId="searchcraft-select"
+			 *  name="searchcraft-select"
+			 *  options="[{ label: 'label', value: 'value' }]"
+			 * />
+			 * ```
+			 */
+			"searchcraft-select": LocalJSX.SearchcraftSelect & JSXBase.HTMLAttributes<HTMLSearchcraftSelectElement>;
+			/**
+			 * This web component is designed to allow users to select a value from a range defined by a minimum and maximum value. The component renders a slider interface, which can be used to visually choose a value between two boundaries.
+			 */
+			"searchcraft-slider": LocalJSX.SearchcraftSlider & JSXBase.HTMLAttributes<HTMLSearchcraftSliderElement>;
+			/**
+			 * This web component adds Searchcraft's built-in css theme to your page. It does not render anything visible, its only function is to manage the css styles on the page.'
+			 * @react-import ```jsx
+			 * import { SearchcraftTheme } from "@searchcraft/react-sdk";
+			 * ```
+			 * @vue-import ```jsx
+			 * import { SearchcraftTheme } from "@searchcraft/vue-sdk";
+			 * ```
+			 * @js-example ```html
+			 * <searchcraft-theme />
+			 * ```
+			 * @react-example ```jsx
+			 * <SearchcraftTheme />
+			 * ```
+			 * @vue-example ```jsx
+			 * <SearchcraftTheme />
+			 * ```
+			 */
+			"searchcraft-theme": LocalJSX.SearchcraftTheme & JSXBase.HTMLAttributes<HTMLSearchcraftThemeElement>;
+			/**
+			 * This web component simulates a light switch functionality, providing a simple and intuitive toggle between two states—on and off.
+			 */
+			"searchcraft-toggle-button": LocalJSX.SearchcraftToggleButton & JSXBase.HTMLAttributes<HTMLSearchcraftToggleButtonElement>;
+		}
+	}
+}
+/**
+ * @fileoverview entry point for your component library
+ *
+ * This is the entry point for your component library. Use this file to export utilities,
+ * constants or data structure that accompany your components.
+ *
+ * DO NOT use this file to export your components. Instead, use the recommended approaches
+ * to consume components of this package as outlined in the `README.md`.
+ */
+/**
+ * The consumer-facing `Searchcraft` class.
+ */
+export declare class Searchcraft extends SearchcraftCore {
+	constructor(config: SearchcraftConfig);
+}
+
+export {
+	LocalJSX as JSX,
+};
+
+export {};
 
 export declare const defineCustomElements: () => void;