@searchcraft/javascript-sdk 0.13.2 → 0.13.3

package/README.md

@@ -123,6 +123,11 @@ export const filterPanelItems = [
     type: 'facets',
     fieldName: 'section',
     label: 'Filter by Section',
+    options: {
+      showSublevel: false,
+      initialCollapseState: 'open', // 'open' or 'closed' - controls if section starts expanded or collapsed
+      viewMoreThreshold: 8, // Number of facets to show before "view more" link appears (0 = show all)
+    },
   },
 ];
 ```

package/dist/components/defineCustomElements.js

@@ -1,26 +1,26 @@
-import { defineCustomElement as define_searchcraft_ad } from './searchcraft-ad.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_button } from './searchcraft-button.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_error_message } from './searchcraft-error-message.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_facet_list } from './searchcraft-facet-list.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_filter_panel } from './searchcraft-filter-panel.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_input_form } from './searchcraft-input-form.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_input_label } from './searchcraft-input-label.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_loading } from './searchcraft-loading.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_pagination } from './searchcraft-pagination.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_popover_button } from './searchcraft-popover-button.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_popover_footer } from './searchcraft-popover-footer.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_popover_form } from './searchcraft-popover-form.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_popover_list_item } from './searchcraft-popover-list-item.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_popover_list_view } from './searchcraft-popover-list-view.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_results_info } from './searchcraft-results-info.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_search_result } from './searchcraft-search-result.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_search_results_per_page } from './searchcraft-search-results-per-page.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_search_results } from './searchcraft-search-results.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_select } from './searchcraft-select.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_slider } from './searchcraft-slider.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_summary_box } from './searchcraft-summary-box.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_theme } from './searchcraft-theme.js?v=0.13.2';
-import { defineCustomElement as define_searchcraft_toggle_button } from './searchcraft-toggle-button.js?v=0.13.2';
+import { defineCustomElement as define_searchcraft_ad } from './searchcraft-ad.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_button } from './searchcraft-button.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_error_message } from './searchcraft-error-message.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_facet_list } from './searchcraft-facet-list.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_filter_panel } from './searchcraft-filter-panel.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_input_form } from './searchcraft-input-form.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_input_label } from './searchcraft-input-label.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_loading } from './searchcraft-loading.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_pagination } from './searchcraft-pagination.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_popover_button } from './searchcraft-popover-button.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_popover_footer } from './searchcraft-popover-footer.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_popover_form } from './searchcraft-popover-form.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_popover_list_item } from './searchcraft-popover-list-item.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_popover_list_view } from './searchcraft-popover-list-view.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_results_info } from './searchcraft-results-info.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_search_result } from './searchcraft-search-result.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_search_results_per_page } from './searchcraft-search-results-per-page.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_search_results } from './searchcraft-search-results.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_select } from './searchcraft-select.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_slider } from './searchcraft-slider.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_summary_box } from './searchcraft-summary-box.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_theme } from './searchcraft-theme.js?v=0.13.3';
+import { defineCustomElement as define_searchcraft_toggle_button } from './searchcraft-toggle-button.js?v=0.13.3';
 
 export const defineCustomElements = () => {
   define_searchcraft_ad();

package/dist/components/html.js

@@ -1,4 +1,4 @@
-import { p as purify } from './purify.es.js?v=0.13.2';
+import { p as purify } from './purify.es.js?v=0.13.3';
 
 /**
  * This allows you to parse a template string with a function.

package/dist/components/index.d.ts

@@ -184,6 +184,19 @@ export interface FacetsFilterItem extends FilterItem {
 	options: {
 		showSublevel: boolean;
 		exclude?: string[];
+		/**
+		 * Initial collapse state of the facet section.
+		 * - 'open': Section is expanded by default
+		 * - 'closed': Section is collapsed by default
+		 * @default 'open'
+		 */
+		initialCollapseState?: "open" | "closed";
+		/**
+		 * The number of facets to show before displaying a "view more" link.
+		 * Set to 0 to show all facets without a "view more" link.
+		 * @default 8
+		 */
+		viewMoreThreshold?: number;
 	};
 }
 export interface NumericFilterItem extends FilterItem {
@@ -837,7 +850,19 @@ export namespace Components {
 	 * It is consumed within the `searchcraft-filter-panel`.
 	 * @js-example ```html
 	 * <!-- index.html -->
+	 * <!-- Basic usage -->
 	 * <searchcraft-facet-list field-name="title" />
+	 * <!-- With collapsible section (initially closed) and view more threshold -->
+	 * <searchcraft-facet-list
+	 *   field-name="category"
+	 *   initial-collapse-state="closed"
+	 *   view-more-threshold="5"
+	 * />
+	 * <!-- Show all facets without "view more" link -->
+	 * <searchcraft-facet-list
+	 *   field-name="brand"
+	 *   view-more-threshold="0"
+	 * />
 	 * ```
 	 * ```js
 	 * // index.js
@@ -845,6 +870,8 @@ export namespace Components {
 	 * facetList.addEventListener('facetSelectionUpdated', () => {
 	 *   console.log('Facet selection updated');
 	 * });
+	 * // Programmatically toggle collapse state
+	 * await facetList.handleCollapseToggle();
 	 * ```
 	 */
 	interface SearchcraftFacetList {
@@ -857,10 +884,30 @@ export namespace Components {
 		  * @default ''
 		 */
 		"fieldName": string;
+		/**
+		  * Returns whether the facet section is currently collapsed.
+		  * @returns A promise that resolves to true if collapsed, false if expanded.
+		 */
+		"getIsCollapsed": () => Promise<boolean>;
+		/**
+		  * Toggles the collapsed state of the facet section.
+		  * @returns A promise that resolves when the toggle is complete.
+		 */
+		"handleCollapseToggle": () => Promise<void>;
+		/**
+		  * Initial collapse state of the facet section.
+		  * @default 'open'
+		 */
+		"initialCollapseState"?: "open" | "closed";
 		/**
 		  * The id of the Searchcraft instance that this component should use.
 		 */
 		"searchcraftId"?: string;
+		/**
+		  * The number of facets to show before displaying a "view more" link. Set to 0 to show all facets without a "view more" link.
+		  * @default 8
+		 */
+		"viewMoreThreshold"?: number;
 	}
 	/**
 	 * This web component represents a series of filters that allows users to refine and control their search queries by applying various filter criteria.
@@ -1007,6 +1054,11 @@ export namespace Components {
 	 * ```
 	 */
 	interface SearchcraftPagination {
+		/**
+		  * Whether to scroll to the top of the search results when pagination buttons are clicked.
+		  * @default true
+		 */
+		"scrollToTop"?: boolean;
 		/**
 		  * The id of the Searchcraft instance that this component should use.
 		 */
@@ -1542,7 +1594,19 @@ declare global {
 	 * It is consumed within the `searchcraft-filter-panel`.
 	 * @js-example ```html
 	 * <!-- index.html -->
+	 * <!-- Basic usage -->
 	 * <searchcraft-facet-list field-name="title" />
+	 * <!-- With collapsible section (initially closed) and view more threshold -->
+	 * <searchcraft-facet-list
+	 *   field-name="category"
+	 *   initial-collapse-state="closed"
+	 *   view-more-threshold="5"
+	 * />
+	 * <!-- Show all facets without "view more" link -->
+	 * <searchcraft-facet-list
+	 *   field-name="brand"
+	 *   view-more-threshold="0"
+	 * />
 	 * ```
 	 * ```js
 	 * // index.js
@@ -1550,6 +1614,8 @@ declare global {
 	 * facetList.addEventListener('facetSelectionUpdated', () => {
 	 *   console.log('Facet selection updated');
 	 * });
+	 * // Programmatically toggle collapse state
+	 * await facetList.handleCollapseToggle();
 	 * ```
 	 */
 	interface HTMLSearchcraftFacetListElement extends Components.SearchcraftFacetList, HTMLStencilElement {
@@ -2133,7 +2199,19 @@ declare namespace LocalJSX {
 	 * It is consumed within the `searchcraft-filter-panel`.
 	 * @js-example ```html
 	 * <!-- index.html -->
+	 * <!-- Basic usage -->
 	 * <searchcraft-facet-list field-name="title" />
+	 * <!-- With collapsible section (initially closed) and view more threshold -->
+	 * <searchcraft-facet-list
+	 *   field-name="category"
+	 *   initial-collapse-state="closed"
+	 *   view-more-threshold="5"
+	 * />
+	 * <!-- Show all facets without "view more" link -->
+	 * <searchcraft-facet-list
+	 *   field-name="brand"
+	 *   view-more-threshold="0"
+	 * />
 	 * ```
 	 * ```js
 	 * // index.js
@@ -2141,6 +2219,8 @@ declare namespace LocalJSX {
 	 * facetList.addEventListener('facetSelectionUpdated', () => {
 	 *   console.log('Facet selection updated');
 	 * });
+	 * // Programmatically toggle collapse state
+	 * await facetList.handleCollapseToggle();
 	 * ```
 	 */
 	interface SearchcraftFacetList {
@@ -2153,6 +2233,11 @@ declare namespace LocalJSX {
 		  * @default ''
 		 */
 		"fieldName"?: string;
+		/**
+		  * Initial collapse state of the facet section.
+		  * @default 'open'
+		 */
+		"initialCollapseState"?: "open" | "closed";
 		/**
 		  * Emitted when the facets are updated.
 		 */
@@ -2163,6 +2248,11 @@ declare namespace LocalJSX {
 		  * The id of the Searchcraft instance that this component should use.
 		 */
 		"searchcraftId"?: string;
+		/**
+		  * The number of facets to show before displaying a "view more" link. Set to 0 to show all facets without a "view more" link.
+		  * @default 8
+		 */
+		"viewMoreThreshold"?: number;
 	}
 	/**
 	 * This web component represents a series of filters that allows users to refine and control their search queries by applying various filter criteria.
@@ -2321,6 +2411,11 @@ declare namespace LocalJSX {
 	 * ```
 	 */
 	interface SearchcraftPagination {
+		/**
+		  * Whether to scroll to the top of the search results when pagination buttons are clicked.
+		  * @default true
+		 */
+		"scrollToTop"?: boolean;
 		/**
 		  * The id of the Searchcraft instance that this component should use.
 		 */
@@ -2840,7 +2935,19 @@ declare module "@stencil/core" {
 			 * It is consumed within the `searchcraft-filter-panel`.
 			 * @js-example ```html
 			 * <!-- index.html -->
+			 * <!-- Basic usage -->
 			 * <searchcraft-facet-list field-name="title" />
+			 * <!-- With collapsible section (initially closed) and view more threshold -->
+			 * <searchcraft-facet-list
+			 *   field-name="category"
+			 *   initial-collapse-state="closed"
+			 *   view-more-threshold="5"
+			 * />
+			 * <!-- Show all facets without "view more" link -->
+			 * <searchcraft-facet-list
+			 *   field-name="brand"
+			 *   view-more-threshold="0"
+			 * />
 			 * ```
 			 * ```js
 			 * // index.js
@@ -2848,6 +2955,8 @@ declare module "@stencil/core" {
 			 * facetList.addEventListener('facetSelectionUpdated', () => {
 			 *   console.log('Facet selection updated');
 			 * });
+			 * // Programmatically toggle collapse state
+			 * await facetList.handleCollapseToggle();
 			 * ```
 			 */
 			"searchcraft-facet-list": LocalJSX.SearchcraftFacetList & JSXBase.HTMLAttributes<HTMLSearchcraftFacetListElement>;

package/dist/components/index.js

@@ -1,29 +1,29 @@
-export { g as getAssetPath, r as render, s as setAssetPath, a as setNonce, b as setPlatformOptions } from './index2.js?v=0.13.2';
-import { n as nanoid } from './searchcraft-ad2.js?v=0.13.2';
-import { D as DEFAULT_CORE_INSTANCE_ID, r as registry } from './CoreInstanceRegistry.js?v=0.13.2';
-export { SearchcraftAd, defineCustomElement as defineCustomElementSearchcraftAd } from './searchcraft-ad.js?v=0.13.2';
-export { SearchcraftButton, defineCustomElement as defineCustomElementSearchcraftButton } from './searchcraft-button.js?v=0.13.2';
-export { SearchcraftErrorMessage, defineCustomElement as defineCustomElementSearchcraftErrorMessage } from './searchcraft-error-message.js?v=0.13.2';
-export { SearchcraftFacetList, defineCustomElement as defineCustomElementSearchcraftFacetList } from './searchcraft-facet-list.js?v=0.13.2';
-export { SearchcraftFilterPanel, defineCustomElement as defineCustomElementSearchcraftFilterPanel } from './searchcraft-filter-panel.js?v=0.13.2';
-export { SearchcraftInputForm, defineCustomElement as defineCustomElementSearchcraftInputForm } from './searchcraft-input-form.js?v=0.13.2';
-export { SearchcraftInputLabel, defineCustomElement as defineCustomElementSearchcraftInputLabel } from './searchcraft-input-label.js?v=0.13.2';
-export { SearchcraftLoading, defineCustomElement as defineCustomElementSearchcraftLoading } from './searchcraft-loading.js?v=0.13.2';
-export { SearchcraftPagination, defineCustomElement as defineCustomElementSearchcraftPagination } from './searchcraft-pagination.js?v=0.13.2';
-export { SearchcraftPopoverButton, defineCustomElement as defineCustomElementSearchcraftPopoverButton } from './searchcraft-popover-button.js?v=0.13.2';
-export { SearchcraftPopoverFooter, defineCustomElement as defineCustomElementSearchcraftPopoverFooter } from './searchcraft-popover-footer.js?v=0.13.2';
-export { SearchcraftPopoverForm, defineCustomElement as defineCustomElementSearchcraftPopoverForm } from './searchcraft-popover-form.js?v=0.13.2';
-export { SearchcraftPopoverListItem, defineCustomElement as defineCustomElementSearchcraftPopoverListItem } from './searchcraft-popover-list-item.js?v=0.13.2';
-export { SearchcraftPopoverListView, defineCustomElement as defineCustomElementSearchcraftPopoverListView } from './searchcraft-popover-list-view.js?v=0.13.2';
-export { SearchcraftResultsInfo, defineCustomElement as defineCustomElementSearchcraftResultsInfo } from './searchcraft-results-info.js?v=0.13.2';
-export { SearchcraftSearchResult, defineCustomElement as defineCustomElementSearchcraftSearchResult } from './searchcraft-search-result.js?v=0.13.2';
-export { SearchcraftSearchResults, defineCustomElement as defineCustomElementSearchcraftSearchResults } from './searchcraft-search-results.js?v=0.13.2';
-export { SearchcraftSearchResultsPerPage, defineCustomElement as defineCustomElementSearchcraftSearchResultsPerPage } from './searchcraft-search-results-per-page.js?v=0.13.2';
-export { SearchcraftSelect, defineCustomElement as defineCustomElementSearchcraftSelect } from './searchcraft-select.js?v=0.13.2';
-export { SearchcraftSlider, defineCustomElement as defineCustomElementSearchcraftSlider } from './searchcraft-slider.js?v=0.13.2';
-export { SearchcraftSummaryBox, defineCustomElement as defineCustomElementSearchcraftSummaryBox } from './searchcraft-summary-box.js?v=0.13.2';
-export { SearchcraftTheme, defineCustomElement as defineCustomElementSearchcraftTheme } from './searchcraft-theme.js?v=0.13.2';
-export { SearchcraftToggleButton, defineCustomElement as defineCustomElementSearchcraftToggleButton } from './searchcraft-toggle-button.js?v=0.13.2';
+export { g as getAssetPath, r as render, s as setAssetPath, a as setNonce, b as setPlatformOptions } from './index2.js?v=0.13.3';
+import { n as nanoid } from './searchcraft-ad2.js?v=0.13.3';
+import { D as DEFAULT_CORE_INSTANCE_ID, r as registry } from './CoreInstanceRegistry.js?v=0.13.3';
+export { SearchcraftAd, defineCustomElement as defineCustomElementSearchcraftAd } from './searchcraft-ad.js?v=0.13.3';
+export { SearchcraftButton, defineCustomElement as defineCustomElementSearchcraftButton } from './searchcraft-button.js?v=0.13.3';
+export { SearchcraftErrorMessage, defineCustomElement as defineCustomElementSearchcraftErrorMessage } from './searchcraft-error-message.js?v=0.13.3';
+export { SearchcraftFacetList, defineCustomElement as defineCustomElementSearchcraftFacetList } from './searchcraft-facet-list.js?v=0.13.3';
+export { SearchcraftFilterPanel, defineCustomElement as defineCustomElementSearchcraftFilterPanel } from './searchcraft-filter-panel.js?v=0.13.3';
+export { SearchcraftInputForm, defineCustomElement as defineCustomElementSearchcraftInputForm } from './searchcraft-input-form.js?v=0.13.3';
+export { SearchcraftInputLabel, defineCustomElement as defineCustomElementSearchcraftInputLabel } from './searchcraft-input-label.js?v=0.13.3';
+export { SearchcraftLoading, defineCustomElement as defineCustomElementSearchcraftLoading } from './searchcraft-loading.js?v=0.13.3';
+export { SearchcraftPagination, defineCustomElement as defineCustomElementSearchcraftPagination } from './searchcraft-pagination.js?v=0.13.3';
+export { SearchcraftPopoverButton, defineCustomElement as defineCustomElementSearchcraftPopoverButton } from './searchcraft-popover-button.js?v=0.13.3';
+export { SearchcraftPopoverFooter, defineCustomElement as defineCustomElementSearchcraftPopoverFooter } from './searchcraft-popover-footer.js?v=0.13.3';
+export { SearchcraftPopoverForm, defineCustomElement as defineCustomElementSearchcraftPopoverForm } from './searchcraft-popover-form.js?v=0.13.3';
+export { SearchcraftPopoverListItem, defineCustomElement as defineCustomElementSearchcraftPopoverListItem } from './searchcraft-popover-list-item.js?v=0.13.3';
+export { SearchcraftPopoverListView, defineCustomElement as defineCustomElementSearchcraftPopoverListView } from './searchcraft-popover-list-view.js?v=0.13.3';
+export { SearchcraftResultsInfo, defineCustomElement as defineCustomElementSearchcraftResultsInfo } from './searchcraft-results-info.js?v=0.13.3';
+export { SearchcraftSearchResult, defineCustomElement as defineCustomElementSearchcraftSearchResult } from './searchcraft-search-result.js?v=0.13.3';
+export { SearchcraftSearchResults, defineCustomElement as defineCustomElementSearchcraftSearchResults } from './searchcraft-search-results.js?v=0.13.3';
+export { SearchcraftSearchResultsPerPage, defineCustomElement as defineCustomElementSearchcraftSearchResultsPerPage } from './searchcraft-search-results-per-page.js?v=0.13.3';
+export { SearchcraftSelect, defineCustomElement as defineCustomElementSearchcraftSelect } from './searchcraft-select.js?v=0.13.3';
+export { SearchcraftSlider, defineCustomElement as defineCustomElementSearchcraftSlider } from './searchcraft-slider.js?v=0.13.3';
+export { SearchcraftSummaryBox, defineCustomElement as defineCustomElementSearchcraftSummaryBox } from './searchcraft-summary-box.js?v=0.13.3';
+export { SearchcraftTheme, defineCustomElement as defineCustomElementSearchcraftTheme } from './searchcraft-theme.js?v=0.13.3';
+export { SearchcraftToggleButton, defineCustomElement as defineCustomElementSearchcraftToggleButton } from './searchcraft-toggle-button.js?v=0.13.3';
 
 var LogLevel;
 (function (LogLevel) {
@@ -1237,7 +1237,7 @@ class SearchcraftCore {
 }
 
 const name = "@searchcraft/javascript-sdk";
-const version = "0.13.2";
+const version = "0.13.3";
 
 /**
  * @fileoverview entry point for your component library
@@ -1264,4 +1264,4 @@ export { Searchcraft, SearchcraftCore };
 //# sourceMappingURL=index.js.map
 
 //# sourceMappingURL=index.js.map
-export { defineCustomElements } from './defineCustomElements.js?v=0.13.2';
+export { defineCustomElements } from './defineCustomElements.js?v=0.13.3';

package/dist/components/index2.js

@@ -1030,7 +1030,11 @@ var setAccessor = (elm, memberName, oldValue, newValue, isSvg, flags, initialRen
         }
       }
     }
-  } else if (memberName === "key") ; else if ((!elm.__lookupSetter__(memberName)) && memberName[0] === "o" && memberName[1] === "n") {
+  } else if (memberName === "key") ; else if (memberName === "ref") {
+    if (newValue) {
+      newValue(elm);
+    }
+  } else if ((!elm.__lookupSetter__(memberName)) && memberName[0] === "o" && memberName[1] === "n") {
     if (memberName[2] === "-") {
       memberName = memberName.slice(3);
     } else if (isMemberInElement(win, ln)) {
@@ -1261,6 +1265,7 @@ var removeVnodes = (vnodes, startIdx, endIdx) => {
     const vnode = vnodes[index];
     if (vnode) {
       const elm = vnode.$elm$;
+      nullifyVNodeRefs(vnode);
       if (elm) {
         {
           checkSlotFallbackVisibility = true;
@@ -1473,6 +1478,12 @@ var markSlotContentForRelocation = (elm) => {
     }
   }
 };
+var nullifyVNodeRefs = (vNode) => {
+  {
+    vNode.$attrs$ && vNode.$attrs$.ref && vNode.$attrs$.ref(null);
+    vNode.$children$ && vNode.$children$.map(nullifyVNodeRefs);
+  }
+};
 var insertBefore = (parent, newNode, reference) => {
   {
     return parent == null ? void 0 : parent.insertBefore(newNode, reference);