@depict-ai/ui 1.4.10 → 1.4.11

package/latest/index.js

@@ -5,7 +5,7 @@ import { createSignal as $9HbP8$createSignal, createMemo as $9HbP8$createMemo, u
 /*! Depict.ai search and product listing SDK */
 import { register_es_version } from "../multi_import_deduplicator.mjs";
 register_es_version("ui", "latest");
-const $ec291e0010116877$export$83d89fbfd8236492 = "1.4.10";
+const $ec291e0010116877$export$83d89fbfd8236492 = "1.4.11";
 function $24e27fab9c821b86$export$5bad61ecde080b1f(...params) {
   const {
     collapse: collapse,
@@ -5684,11 +5684,10 @@ function $df5d81d0fe61ff21$export$f7d2f673fc2f091d({
   const crumb_data_ = (0, $9HbP8$createMemo)(() => plp_results_()?.breadcrumb);
   const quicklinks_data_ = (0, $9HbP8$createMemo)(() => plp_results_()?.quick_links);
   const meta_tag_data_ = (0, $9HbP8$createMemo)(() => {
-    meta_title_suffix_();
-    return plp_results_()?.metadata?.replace_meta_tags ? {
+    if (plp_results_()?.metadata?.replace_meta_tags) return {
       title: plp_results_()?.metadata?.title + (meta_title_suffix_() || ""),
       description: plp_results_()?.metadata?.description
-    } : null;
+    };
   });
   (0, $9HbP8$edit_current_page_meta_tags)(meta_tag_data_);
   const [sort_or_filter_open_, set_sort_or_filter_open_] = (0, $9HbP8$createSignal)(false);
@@ -6027,8 +6026,12 @@ function $ccd5db07a3a069c5$export$477caf01aecaeb2a(options) {
   const router_ = options.router_;
   const search_query_url_param_name_ = "search_query_url_param_name_" in options ? options.search_query_url_param_name_ : undefined;
   const search_query_ = search_query_url_param_name_ ? (0, $9HbP8$createSignal)("") : undefined;
+  const override_query_id_query_param_names_ = "override_query_id_query_param_names_" in options ? options.override_query_id_query_param_names_ : undefined;
+  const override_query_id_ = override_query_id_query_param_names_ ? (0, $9HbP8$createSignal)(null) : undefined;
   const get_search_query_ = search_query_?.[0];
   const set_search_query = search_query_?.[1];
+  const get_override_query_id_ = override_query_id_?.[0];
+  const set_override_query_id = override_query_id_?.[1];
   const current_sorting_ = (0, $9HbP8$createSignal)();
   const selected_filters_ = (0, $9HbP8$createSignal)([]);
   const sideways_filter_clearing_flag_ = (0, $9HbP8$createSignal)(false);
@@ -6073,6 +6076,12 @@ function $ccd5db07a3a069c5$export$477caf01aecaeb2a(options) {
         const found_query = searchParams.get(search_query_url_param_name_);
         set_search_query(found_query || "");
       }
+      if (override_query_id_query_param_names_) {
+        const found_override_query_id = override_query_id_query_param_names_.map(n => searchParams.get(n)).find(n => n);
+        set_override_query_id(found_override_query_id || null);
+        if (found_override_query_id) (0, $9HbP8$dlog)("Found override query id:", found_override_query_id); // This stuff might get confusing so better log it
+      }
+
       if (searchParams.get((0, $4147651646da990a$export$cf5feb2102aec7f2)) === "true") set_has_sideways_filter_clearing_flag(true);
       if (!writer_started) {
         // The owner here is the createComputed which gets disposed the next time the computation runs - but we actually just want to delay the start of the href_writer until our signals contain the current value of the URL, therefore the runWithOwner
@@ -6096,7 +6105,10 @@ function $ccd5db07a3a069c5$export$477caf01aecaeb2a(options) {
       search_query_accessor_: get_search_query_
     } : {
       sideways_filter_clearing_flag_: sideways_filter_clearing_flag_
-    })
+    }),
+    ...(typeof override_query_id_query_param_names_ === "object" ? {
+      override_query_id_accessor_: get_override_query_id_
+    } : {})
   };
 }
 /**
@@ -6282,6 +6294,7 @@ class $961b5c64bef4662f$export$f34314aa9505732e {
   #market_signal = (0, $9HbP8$createSignal)();
   #query_id_signal = (0, $9HbP8$createSignal)("");
   #meta_title_suffix_ = (0, $9HbP8$createSignal)();
+  #disable_override_query_id = (0, $9HbP8$createSignal)();
   #listing_type_signal = (0, $9HbP8$createSignal)();
   static #keys_constructed_with = new Set();
   get localization() {
@@ -6321,6 +6334,12 @@ class $961b5c64bef4662f$export$f34314aa9505732e {
   set meta_title_suffix(new_suffix) {
     this.#meta_title_suffix_[1](new_suffix);
   }
+  get disable_override_query_id() {
+    return this.#disable_override_query_id[0]();
+  }
+  set disable_override_query_id(new_value) {
+    this.#disable_override_query_id[1](new_value);
+  }
   get on_navigation() {
     // The only non-reactive public property on the class (I don't see it making sense to have it reactive)
     return this.#router.on_navigation_;
@@ -6346,16 +6365,19 @@ class $961b5c64bef4662f$export$f34314aa9505732e {
       (0, $90980bd87c9960f9$export$5162a71f252e6122)();
       this.#router = new (0, $4fd2ba03703a7d92$export$7e1297a3a19f10d8)("hard_navigation", query_id_state_key);
       if (on_navigation) this.#router.on_navigation_ = on_navigation;
+      const override_query_id_query_param_names_ = ["query_id_" + unique_instance_key_for_state, "query_id"]; // If you're wondering why this is an array https://gitlab.com/depict-ai/depict.ai/-/merge_requests/7958#note_1511700842
       const sorting_query_param_ = "sorting" + unique_instance_key_for_state;
       const filter_query_param_prefix_ = "f" + unique_instance_key_for_state + "_";
       const {
         selected_filters_: selected_filters_,
         current_sorting_: current_sorting_,
-        sideways_filter_clearing_flag_: sideways_filter_clearing_flag_
+        sideways_filter_clearing_flag_: sideways_filter_clearing_flag_,
+        override_query_id_accessor_: override_query_id_accessor_
       } = (0, $ccd5db07a3a069c5$export$477caf01aecaeb2a)({
         router_: this.#router,
         sorting_query_param_: sorting_query_param_,
-        filter_query_param_prefix_: filter_query_param_prefix_
+        filter_query_param_prefix_: filter_query_param_prefix_,
+        override_query_id_query_param_names_: override_query_id_query_param_names_
       });
       const [reset_history_state_, state_] = (0, $a8fa7302d6f93c0b$export$9862539c89138352)({
         get_default_values_: () => ({
@@ -6385,6 +6407,7 @@ class $961b5c64bef4662f$export$f34314aa9505732e {
         router_: this.#router,
         selected_filters_: selected_filters_,
         current_sorting_: current_sorting_,
+        override_query_id_accessor_: override_query_id_accessor_,
         sideways_filter_clearing_flag_: sideways_filter_clearing_flag_,
         sorting_query_param_: sorting_query_param_,
         filter_query_param_prefix_: filter_query_param_prefix_
@@ -6431,6 +6454,7 @@ function $961b5c64bef4662f$export$e2bf8ce7779e827e(props) {
       },
       current_sorting_: current_sorting_,
       selected_filters_: selected_filters_,
+      override_query_id_accessor_: override_query_id_accessor_,
       reset_history_state_: reset_history_state_,
       depict_api_: depict_api_,
       i18n_: i18n_,
@@ -6448,8 +6472,8 @@ function $961b5c64bef4662f$export$e2bf8ce7779e827e(props) {
       depict_api_: depict_api_,
       min_products_to_fetch_: $961b5c64bef4662f$var$min_products_to_fetch_,
       local_filter_cache_: local_filter_cache_,
+      query_id_: (0, $9HbP8$createMemo)(() => !depict_category.disable_override_query_id && override_query_id_accessor_() || depict_category.category_id),
       meta_title_suffix_: () => depict_category.meta_title_suffix,
-      query_id_: () => depict_category.category_id,
       listing_type_: () => depict_category.listing_type,
       i18n_: i18n_,
       show_quicklinks_: (0, $9HbP8$createMemo)(() => props.show_quicklinks ?? true),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@depict-ai/ui",
-  "version": "1.4.10",
+  "version": "1.4.11",
   "description": "Base package containing the actual UI of Depict UI along with translations, with a not-simplified API. We recommend using @depict-ai/js-ui or @depict-ai/react-ui instead.",
   "packageManager": "yarn@3.2.2",
   "sass": "styles.scss",
@@ -237,8 +237,8 @@
     "@babel/runtime": "latest",
     "@babel/runtime-corejs3": "^7.22.6",
     "@depict-ai/plp-styling": "^1.0.33",
-    "@depict-ai/types": "^1.0.34",
-    "@depict-ai/utilishared": "^1.0.32",
+    "@depict-ai/types": "^1.0.35",
+    "@depict-ai/utilishared": "^1.0.33",
     "solid-js": "^1.7.3"
   },
   "type": "module",

package/server/ES10/index.cjs

@@ -60,7 +60,7 @@ $parcel$export(module.exports, "defaultColsAtSize", () => $33eed84f447aa0c0$expo
 $parcel$export(module.exports, "defaultCategoryTitlePlugin", () => $33eed84f447aa0c0$export$7bf543b9d9be2c22);
 $parcel$export(module.exports, "version", () => $aa1938dec50d6c12$export$83d89fbfd8236492);
 /*! Depict.ai search and product listing SDK */
-const $aa1938dec50d6c12$export$83d89fbfd8236492 = "1.4.10";
+const $aa1938dec50d6c12$export$83d89fbfd8236492 = "1.4.11";
 function $d6d51b09cb2116a6$export$5bad61ecde080b1f() {
   const {
     collapse: collapse,
@@ -4941,12 +4941,14 @@ function $ede6c70ecdca46fe$export$f7d2f673fc2f091d(_ref) {
     return (_plp_results_4 = plp_results_()) === null || _plp_results_4 === void 0 ? void 0 : _plp_results_4.quick_links;
   });
   const meta_tag_data_ = (0, $3hooq$solidjs.createMemo)(() => {
-    var _plp_results_5, _plp_results_5$metada, _plp_results_6, _plp_results_6$metada, _plp_results_7, _plp_results_7$metada;
-    meta_title_suffix_();
-    return (_plp_results_5 = plp_results_()) !== null && _plp_results_5 !== void 0 && (_plp_results_5$metada = _plp_results_5.metadata) !== null && _plp_results_5$metada !== void 0 && _plp_results_5$metada.replace_meta_tags ? {
-      title: ((_plp_results_6 = plp_results_()) === null || _plp_results_6 === void 0 ? void 0 : (_plp_results_6$metada = _plp_results_6.metadata) === null || _plp_results_6$metada === void 0 ? void 0 : _plp_results_6$metada.title) + (meta_title_suffix_() || ""),
-      description: (_plp_results_7 = plp_results_()) === null || _plp_results_7 === void 0 ? void 0 : (_plp_results_7$metada = _plp_results_7.metadata) === null || _plp_results_7$metada === void 0 ? void 0 : _plp_results_7$metada.description
-    } : null;
+    var _plp_results_5, _plp_results_5$metada;
+    if ((_plp_results_5 = plp_results_()) !== null && _plp_results_5 !== void 0 && (_plp_results_5$metada = _plp_results_5.metadata) !== null && _plp_results_5$metada !== void 0 && _plp_results_5$metada.replace_meta_tags) {
+      var _plp_results_6, _plp_results_6$metada, _plp_results_7, _plp_results_7$metada;
+      return {
+        title: ((_plp_results_6 = plp_results_()) === null || _plp_results_6 === void 0 ? void 0 : (_plp_results_6$metada = _plp_results_6.metadata) === null || _plp_results_6$metada === void 0 ? void 0 : _plp_results_6$metada.title) + (meta_title_suffix_() || ""),
+        description: (_plp_results_7 = plp_results_()) === null || _plp_results_7 === void 0 ? void 0 : (_plp_results_7$metada = _plp_results_7.metadata) === null || _plp_results_7$metada === void 0 ? void 0 : _plp_results_7$metada.description
+      };
+    }
   });
   (0, $3hooq$depictaiutilishared.edit_current_page_meta_tags)(meta_tag_data_);
   const [sort_or_filter_open_, set_sort_or_filter_open_] = (0, $3hooq$solidjs.createSignal)(false);
@@ -5253,8 +5255,12 @@ function $5dd9d0d3ea82e2dd$export$477caf01aecaeb2a(options) {
   const router_ = options.router_;
   const search_query_url_param_name_ = "search_query_url_param_name_" in options ? options.search_query_url_param_name_ : undefined;
   const search_query_ = search_query_url_param_name_ ? (0, $3hooq$solidjs.createSignal)("") : undefined;
+  const override_query_id_query_param_names_ = "override_query_id_query_param_names_" in options ? options.override_query_id_query_param_names_ : undefined;
+  const override_query_id_ = override_query_id_query_param_names_ ? (0, $3hooq$solidjs.createSignal)(null) : undefined;
   const get_search_query_ = search_query_ === null || search_query_ === void 0 ? void 0 : search_query_[0];
   const set_search_query = search_query_ === null || search_query_ === void 0 ? void 0 : search_query_[1];
+  const get_override_query_id_ = override_query_id_ === null || override_query_id_ === void 0 ? void 0 : override_query_id_[0];
+  const set_override_query_id = override_query_id_ === null || override_query_id_ === void 0 ? void 0 : override_query_id_[1];
   const current_sorting_ = (0, $3hooq$solidjs.createSignal)();
   const selected_filters_ = (0, $3hooq$solidjs.createSignal)([]);
   const sideways_filter_clearing_flag_ = (0, $3hooq$solidjs.createSignal)(false);
@@ -5305,6 +5311,12 @@ function $5dd9d0d3ea82e2dd$export$477caf01aecaeb2a(options) {
         const found_query = searchParams.get(search_query_url_param_name_);
         set_search_query(found_query || "");
       }
+      if (override_query_id_query_param_names_) {
+        const found_override_query_id = override_query_id_query_param_names_.map(n => searchParams.get(n)).find(n => n);
+        set_override_query_id(found_override_query_id || null);
+        if (found_override_query_id) (0, $3hooq$depictaiutilishared.dlog)("Found override query id:", found_override_query_id); // This stuff might get confusing so better log it
+      }
+
       if (searchParams.get((0, $a68b73fd7ba0853f$export$cf5feb2102aec7f2)) === "true") set_has_sideways_filter_clearing_flag(true);
       if (!writer_started) {
         // The owner here is the createComputed which gets disposed the next time the computation runs - but we actually just want to delay the start of the href_writer until our signals contain the current value of the URL, therefore the runWithOwner
@@ -5328,7 +5340,10 @@ function $5dd9d0d3ea82e2dd$export$477caf01aecaeb2a(options) {
       search_query_accessor_: get_search_query_
     } : {
       sideways_filter_clearing_flag_: sideways_filter_clearing_flag_
-    })
+    }),
+    ...(typeof override_query_id_query_param_names_ === "object" ? {
+      override_query_id_accessor_: get_override_query_id_
+    } : {})
   };
 }
 /**
@@ -5558,6 +5573,7 @@ var $9cbefc32b9dab36d$var$_merchant_signal = /*#__PURE__*/new WeakMap();
 var $9cbefc32b9dab36d$var$_market_signal = /*#__PURE__*/new WeakMap();
 var $9cbefc32b9dab36d$var$_query_id_signal = /*#__PURE__*/new WeakMap();
 var $9cbefc32b9dab36d$var$_meta_title_suffix_ = /*#__PURE__*/new WeakMap();
+var $9cbefc32b9dab36d$var$_disable_override_query_id = /*#__PURE__*/new WeakMap();
 var $9cbefc32b9dab36d$var$_listing_type_signal = /*#__PURE__*/new WeakMap();
 class $9cbefc32b9dab36d$export$f34314aa9505732e {
   get localization() {
@@ -5597,6 +5613,12 @@ class $9cbefc32b9dab36d$export$f34314aa9505732e {
   set meta_title_suffix(new_suffix) {
     (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_meta_title_suffix_)[1](new_suffix);
   }
+  get disable_override_query_id() {
+    return (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_disable_override_query_id)[0]();
+  }
+  set disable_override_query_id(new_value) {
+    (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_disable_override_query_id)[1](new_value);
+  }
   get on_navigation() {
     // The only non-reactive public property on the class (I don't see it making sense to have it reactive)
     return (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_router).on_navigation_;
@@ -5638,6 +5660,10 @@ class $9cbefc32b9dab36d$export$f34314aa9505732e {
       writable: true,
       value: (0, $3hooq$solidjs.createSignal)()
     });
+    $9cbefc32b9dab36d$var$_classPrivateFieldInitSpec(this, $9cbefc32b9dab36d$var$_disable_override_query_id, {
+      writable: true,
+      value: (0, $3hooq$solidjs.createSignal)()
+    });
     $9cbefc32b9dab36d$var$_classPrivateFieldInitSpec(this, $9cbefc32b9dab36d$var$_listing_type_signal, {
       writable: true,
       value: (0, $3hooq$solidjs.createSignal)()
@@ -5651,16 +5677,19 @@ class $9cbefc32b9dab36d$export$f34314aa9505732e {
       (0, $cfcd56242923775d$export$5162a71f252e6122)();
       (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldSet))(this, $9cbefc32b9dab36d$var$_router, new (0, $73014ff36186a4dd$export$7e1297a3a19f10d8)("hard_navigation", query_id_state_key));
       if (on_navigation) (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_router).on_navigation_ = on_navigation;
+      const override_query_id_query_param_names_ = ["query_id_" + unique_instance_key_for_state, "query_id"]; // If you're wondering why this is an array https://gitlab.com/depict-ai/depict.ai/-/merge_requests/7958#note_1511700842
       const sorting_query_param_ = "sorting" + unique_instance_key_for_state;
       const filter_query_param_prefix_ = "f" + unique_instance_key_for_state + "_";
       const {
         selected_filters_: selected_filters_,
         current_sorting_: current_sorting_,
-        sideways_filter_clearing_flag_: sideways_filter_clearing_flag_
+        sideways_filter_clearing_flag_: sideways_filter_clearing_flag_,
+        override_query_id_accessor_: override_query_id_accessor_
       } = (0, $5dd9d0d3ea82e2dd$export$477caf01aecaeb2a)({
         router_: (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_router),
         sorting_query_param_: sorting_query_param_,
-        filter_query_param_prefix_: filter_query_param_prefix_
+        filter_query_param_prefix_: filter_query_param_prefix_,
+        override_query_id_query_param_names_: override_query_id_query_param_names_
       });
       const [reset_history_state_, state_] = (0, $2b15291bd38ac551$export$9862539c89138352)({
         get_default_values_: () => ({
@@ -5690,6 +5719,7 @@ class $9cbefc32b9dab36d$export$f34314aa9505732e {
         router_: (0, $parcel$interopDefault($3hooq$babelruntimehelpersclassPrivateFieldGet))(this, $9cbefc32b9dab36d$var$_router),
         selected_filters_: selected_filters_,
         current_sorting_: current_sorting_,
+        override_query_id_accessor_: override_query_id_accessor_,
         sideways_filter_clearing_flag_: sideways_filter_clearing_flag_,
         sorting_query_param_: sorting_query_param_,
         filter_query_param_prefix_: filter_query_param_prefix_
@@ -5699,6 +5729,11 @@ class $9cbefc32b9dab36d$export$f34314aa9505732e {
     });
   }
 }
+/**
+ * This is the CategoryPage component visible outside - exported from @depict-ai/ui.
+ * It wraps the internal, pure CategoryPage component and connects it to the DepictCategory instance and other global state such as the history or page URL.
+ * It is wrapped once again in the js-ui and react-ui packages which exports the final, most simplified interface.
+ */
 var $9cbefc32b9dab36d$var$_keys_constructed_with = {
   writable: true,
   value: new Set()
@@ -5740,6 +5775,7 @@ function $9cbefc32b9dab36d$export$e2bf8ce7779e827e(props) {
       },
       current_sorting_: current_sorting_,
       selected_filters_: selected_filters_,
+      override_query_id_accessor_: override_query_id_accessor_,
       reset_history_state_: reset_history_state_,
       depict_api_: depict_api_,
       i18n_: i18n_,
@@ -5757,8 +5793,8 @@ function $9cbefc32b9dab36d$export$e2bf8ce7779e827e(props) {
       depict_api_: depict_api_,
       min_products_to_fetch_: $9cbefc32b9dab36d$var$min_products_to_fetch_,
       local_filter_cache_: local_filter_cache_,
+      query_id_: (0, $3hooq$solidjs.createMemo)(() => !depict_category.disable_override_query_id && override_query_id_accessor_() || depict_category.category_id),
       meta_title_suffix_: () => depict_category.meta_title_suffix,
-      query_id_: () => depict_category.category_id,
       listing_type_: () => depict_category.listing_type,
       i18n_: i18n_,
       show_quicklinks_: (0, $3hooq$solidjs.createMemo)(() => {

package/server/ES10/index.d.ts

@@ -7,7 +7,7 @@ import { CategorySuggestion, SearchSuggestionsResponse } from "@depict-ai/types/
 import { BaseSearchRequest } from "@depict-ai/types/api/BaseSearchRequest";
 import { SearchSuggestionsRequest } from "@depict-ai/types/api/SearchSuggestionsRequest";
 import { ProductListingRequest } from "@depict-ai/types/api/ProductListingRequest";
-export const version = "1.4.10";
+export const version = "1.4.11";
 export function ExpandingDetails(props: {
   details_: HTMLDetailsElement;
   summary_: HTMLElement;
@@ -550,6 +550,8 @@ export class DepictCategory<InputDisplay extends Display, OutputDisplay extends
   set listing_type(listing_type: ListingType | undefined);
   get meta_title_suffix(): string | undefined;
   set meta_title_suffix(new_suffix: string | undefined);
+  get disable_override_query_id(): boolean | undefined;
+  set disable_override_query_id(new_value: boolean | undefined);
   get on_navigation(): OnNavigation;
   set on_navigation(new_function: OnNavigation);
   constructor({
@@ -562,6 +564,11 @@ export class DepictCategory<InputDisplay extends Display, OutputDisplay extends
     ...props_on_class
   }: DepictCategoryConstructorOptions<InputDisplay, OutputDisplay>);
 }
+/**
+ * This is the CategoryPage component visible outside - exported from @depict-ai/ui.
+ * It wraps the internal, pure CategoryPage component and connects it to the DepictCategory instance and other global state such as the history or page URL.
+ * It is wrapped once again in the js-ui and react-ui packages which exports the final, most simplified interface.
+ */
 export function CategoryPage<OriginalDisplay extends Display, OutputDisplay extends ModernDisplay | never>(props: {
   depict_category: DepictCategory<OriginalDisplay, OutputDisplay>;
   grid_spacing: SDKGridSpacing;
@@ -697,6 +704,11 @@ export class DepictSearch<InputDisplay extends Display, OutputDisplay extends Mo
   set market(market: string);
   fetchSearchResults(query: string, filters?: SearchFilter[], maxResults?: number): Promise<([OutputDisplay] extends [never] ? InputDisplay : ModernDisplayWithPageUrl<OutputDisplay>)[]>;
 }
+/**
+ * This is the SearchPage component visible outside - exported from @depict-ai/ui.
+ * It wraps the internal, pure SearchPage component and connects it to the DepictSearch instance and other global state such as the history or page URL.
+ * It is wrapped once again in the js-ui and react-ui packages which exports the final, most simplified interface.
+ */
 export function SearchPage<OriginalDisplay extends Display, TransformedDisplay extends never | ModernDisplay>(props: {
   depict_search: DepictSearch<OriginalDisplay, TransformedDisplay>;
   include_input_field?: boolean | {
@@ -819,9 +831,18 @@ export type BaseSearchProviderConfig = {
 };
 export type BaseCategoryProviderConfig = {
   /**
-   * Currently used for SEO long tail only. Example: {generatedTitle} + {metaTitleSuffix}
+   * Currently used for SEO long tail only.
+   * Read more about SEO collections here https://docs.depict.ai/other-guides/seo-collections-guide/introduction
+   * @default ""
+   * @example
+   * If the generated SEO title is "Blue Jeans", and you specify metaTitleSuffix to " | My Store", the final SEO title will be "Blue Jeans | My Store".
    */
   metaTitleSuffix?: string;
+  /**
+   * The parameter `query_id=` will override the regular category id that you have configured your SDK to use. You can consider the `query_id` as an escape-hatch if you want to easily set a category id.
+   * However, if your page already sets a query_id, you can disable this behaviour by setting this property to `true` (to avoid a conflict).
+   */
+  disableOverrideQueryId?: boolean;
 };
 export interface BaseProductListingConfig {
   /**

package/server/ES10/index.js

@@ -8,7 +8,7 @@ import $b8hua$babelruntimehelpersdefineProperty from "@babel/runtime/helpers/def
 /*! Depict.ai search and product listing SDK */
 import { register_es_version } from "../../multi_import_deduplicator.mjs";
 register_es_version("ui", "ES10");
-const $8db9a15135765c11$export$83d89fbfd8236492 = "1.4.10";
+const $8db9a15135765c11$export$83d89fbfd8236492 = "1.4.11";
 function $8e8b179489080711$export$5bad61ecde080b1f() {
   const {
     collapse: collapse,
@@ -4889,12 +4889,14 @@ function $4b4b262708b516ee$export$f7d2f673fc2f091d(_ref) {
     return (_plp_results_4 = plp_results_()) === null || _plp_results_4 === void 0 ? void 0 : _plp_results_4.quick_links;
   });
   const meta_tag_data_ = (0, $b8hua$createMemo)(() => {
-    var _plp_results_5, _plp_results_5$metada, _plp_results_6, _plp_results_6$metada, _plp_results_7, _plp_results_7$metada;
-    meta_title_suffix_();
-    return (_plp_results_5 = plp_results_()) !== null && _plp_results_5 !== void 0 && (_plp_results_5$metada = _plp_results_5.metadata) !== null && _plp_results_5$metada !== void 0 && _plp_results_5$metada.replace_meta_tags ? {
-      title: ((_plp_results_6 = plp_results_()) === null || _plp_results_6 === void 0 ? void 0 : (_plp_results_6$metada = _plp_results_6.metadata) === null || _plp_results_6$metada === void 0 ? void 0 : _plp_results_6$metada.title) + (meta_title_suffix_() || ""),
-      description: (_plp_results_7 = plp_results_()) === null || _plp_results_7 === void 0 ? void 0 : (_plp_results_7$metada = _plp_results_7.metadata) === null || _plp_results_7$metada === void 0 ? void 0 : _plp_results_7$metada.description
-    } : null;
+    var _plp_results_5, _plp_results_5$metada;
+    if ((_plp_results_5 = plp_results_()) !== null && _plp_results_5 !== void 0 && (_plp_results_5$metada = _plp_results_5.metadata) !== null && _plp_results_5$metada !== void 0 && _plp_results_5$metada.replace_meta_tags) {
+      var _plp_results_6, _plp_results_6$metada, _plp_results_7, _plp_results_7$metada;
+      return {
+        title: ((_plp_results_6 = plp_results_()) === null || _plp_results_6 === void 0 ? void 0 : (_plp_results_6$metada = _plp_results_6.metadata) === null || _plp_results_6$metada === void 0 ? void 0 : _plp_results_6$metada.title) + (meta_title_suffix_() || ""),
+        description: (_plp_results_7 = plp_results_()) === null || _plp_results_7 === void 0 ? void 0 : (_plp_results_7$metada = _plp_results_7.metadata) === null || _plp_results_7$metada === void 0 ? void 0 : _plp_results_7$metada.description
+      };
+    }
   });
   (0, $b8hua$edit_current_page_meta_tags)(meta_tag_data_);
   const [sort_or_filter_open_, set_sort_or_filter_open_] = (0, $b8hua$createSignal)(false);
@@ -5201,8 +5203,12 @@ function $9d3d794b62318ecc$export$477caf01aecaeb2a(options) {
   const router_ = options.router_;
   const search_query_url_param_name_ = "search_query_url_param_name_" in options ? options.search_query_url_param_name_ : undefined;
   const search_query_ = search_query_url_param_name_ ? (0, $b8hua$createSignal)("") : undefined;
+  const override_query_id_query_param_names_ = "override_query_id_query_param_names_" in options ? options.override_query_id_query_param_names_ : undefined;
+  const override_query_id_ = override_query_id_query_param_names_ ? (0, $b8hua$createSignal)(null) : undefined;
   const get_search_query_ = search_query_ === null || search_query_ === void 0 ? void 0 : search_query_[0];
   const set_search_query = search_query_ === null || search_query_ === void 0 ? void 0 : search_query_[1];
+  const get_override_query_id_ = override_query_id_ === null || override_query_id_ === void 0 ? void 0 : override_query_id_[0];
+  const set_override_query_id = override_query_id_ === null || override_query_id_ === void 0 ? void 0 : override_query_id_[1];
   const current_sorting_ = (0, $b8hua$createSignal)();
   const selected_filters_ = (0, $b8hua$createSignal)([]);
   const sideways_filter_clearing_flag_ = (0, $b8hua$createSignal)(false);
@@ -5253,6 +5259,12 @@ function $9d3d794b62318ecc$export$477caf01aecaeb2a(options) {
         const found_query = searchParams.get(search_query_url_param_name_);
         set_search_query(found_query || "");
       }
+      if (override_query_id_query_param_names_) {
+        const found_override_query_id = override_query_id_query_param_names_.map(n => searchParams.get(n)).find(n => n);
+        set_override_query_id(found_override_query_id || null);
+        if (found_override_query_id) (0, $b8hua$dlog)("Found override query id:", found_override_query_id); // This stuff might get confusing so better log it
+      }
+
       if (searchParams.get((0, $2855bffe06ef7a03$export$cf5feb2102aec7f2)) === "true") set_has_sideways_filter_clearing_flag(true);
       if (!writer_started) {
         // The owner here is the createComputed which gets disposed the next time the computation runs - but we actually just want to delay the start of the href_writer until our signals contain the current value of the URL, therefore the runWithOwner
@@ -5276,7 +5288,10 @@ function $9d3d794b62318ecc$export$477caf01aecaeb2a(options) {
       search_query_accessor_: get_search_query_
     } : {
       sideways_filter_clearing_flag_: sideways_filter_clearing_flag_
-    })
+    }),
+    ...(typeof override_query_id_query_param_names_ === "object" ? {
+      override_query_id_accessor_: get_override_query_id_
+    } : {})
   };
 }
 /**
@@ -5506,6 +5521,7 @@ var $f5f54892fd0c7d9f$var$_merchant_signal = /*#__PURE__*/new WeakMap();
 var $f5f54892fd0c7d9f$var$_market_signal = /*#__PURE__*/new WeakMap();
 var $f5f54892fd0c7d9f$var$_query_id_signal = /*#__PURE__*/new WeakMap();
 var $f5f54892fd0c7d9f$var$_meta_title_suffix_ = /*#__PURE__*/new WeakMap();
+var $f5f54892fd0c7d9f$var$_disable_override_query_id = /*#__PURE__*/new WeakMap();
 var $f5f54892fd0c7d9f$var$_listing_type_signal = /*#__PURE__*/new WeakMap();
 class $f5f54892fd0c7d9f$export$f34314aa9505732e {
   get localization() {
@@ -5545,6 +5561,12 @@ class $f5f54892fd0c7d9f$export$f34314aa9505732e {
   set meta_title_suffix(new_suffix) {
     (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_meta_title_suffix_)[1](new_suffix);
   }
+  get disable_override_query_id() {
+    return (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_disable_override_query_id)[0]();
+  }
+  set disable_override_query_id(new_value) {
+    (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_disable_override_query_id)[1](new_value);
+  }
   get on_navigation() {
     // The only non-reactive public property on the class (I don't see it making sense to have it reactive)
     return (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_router).on_navigation_;
@@ -5586,6 +5608,10 @@ class $f5f54892fd0c7d9f$export$f34314aa9505732e {
       writable: true,
       value: (0, $b8hua$createSignal)()
     });
+    $f5f54892fd0c7d9f$var$_classPrivateFieldInitSpec(this, $f5f54892fd0c7d9f$var$_disable_override_query_id, {
+      writable: true,
+      value: (0, $b8hua$createSignal)()
+    });
     $f5f54892fd0c7d9f$var$_classPrivateFieldInitSpec(this, $f5f54892fd0c7d9f$var$_listing_type_signal, {
       writable: true,
       value: (0, $b8hua$createSignal)()
@@ -5599,16 +5625,19 @@ class $f5f54892fd0c7d9f$export$f34314aa9505732e {
       (0, $68e6625c8d51f847$export$5162a71f252e6122)();
       (0, $b8hua$babelruntimehelpersclassPrivateFieldSet)(this, $f5f54892fd0c7d9f$var$_router, new (0, $ac571292d606f30b$export$7e1297a3a19f10d8)("hard_navigation", query_id_state_key));
       if (on_navigation) (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_router).on_navigation_ = on_navigation;
+      const override_query_id_query_param_names_ = ["query_id_" + unique_instance_key_for_state, "query_id"]; // If you're wondering why this is an array https://gitlab.com/depict-ai/depict.ai/-/merge_requests/7958#note_1511700842
       const sorting_query_param_ = "sorting" + unique_instance_key_for_state;
       const filter_query_param_prefix_ = "f" + unique_instance_key_for_state + "_";
       const {
         selected_filters_: selected_filters_,
         current_sorting_: current_sorting_,
-        sideways_filter_clearing_flag_: sideways_filter_clearing_flag_
+        sideways_filter_clearing_flag_: sideways_filter_clearing_flag_,
+        override_query_id_accessor_: override_query_id_accessor_
       } = (0, $9d3d794b62318ecc$export$477caf01aecaeb2a)({
         router_: (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_router),
         sorting_query_param_: sorting_query_param_,
-        filter_query_param_prefix_: filter_query_param_prefix_
+        filter_query_param_prefix_: filter_query_param_prefix_,
+        override_query_id_query_param_names_: override_query_id_query_param_names_
       });
       const [reset_history_state_, state_] = (0, $bc811d9630f9579b$export$9862539c89138352)({
         get_default_values_: () => ({
@@ -5638,6 +5667,7 @@ class $f5f54892fd0c7d9f$export$f34314aa9505732e {
         router_: (0, $b8hua$babelruntimehelpersclassPrivateFieldGet)(this, $f5f54892fd0c7d9f$var$_router),
         selected_filters_: selected_filters_,
         current_sorting_: current_sorting_,
+        override_query_id_accessor_: override_query_id_accessor_,
         sideways_filter_clearing_flag_: sideways_filter_clearing_flag_,
         sorting_query_param_: sorting_query_param_,
         filter_query_param_prefix_: filter_query_param_prefix_
@@ -5647,6 +5677,11 @@ class $f5f54892fd0c7d9f$export$f34314aa9505732e {
     });
   }
 }
+/**
+ * This is the CategoryPage component visible outside - exported from @depict-ai/ui.
+ * It wraps the internal, pure CategoryPage component and connects it to the DepictCategory instance and other global state such as the history or page URL.
+ * It is wrapped once again in the js-ui and react-ui packages which exports the final, most simplified interface.
+ */
 var $f5f54892fd0c7d9f$var$_keys_constructed_with = {
   writable: true,
   value: new Set()
@@ -5688,6 +5723,7 @@ function $f5f54892fd0c7d9f$export$e2bf8ce7779e827e(props) {
       },
       current_sorting_: current_sorting_,
       selected_filters_: selected_filters_,
+      override_query_id_accessor_: override_query_id_accessor_,
       reset_history_state_: reset_history_state_,
       depict_api_: depict_api_,
       i18n_: i18n_,
@@ -5705,8 +5741,8 @@ function $f5f54892fd0c7d9f$export$e2bf8ce7779e827e(props) {
       depict_api_: depict_api_,
       min_products_to_fetch_: $f5f54892fd0c7d9f$var$min_products_to_fetch_,
       local_filter_cache_: local_filter_cache_,
+      query_id_: (0, $b8hua$createMemo)(() => !depict_category.disable_override_query_id && override_query_id_accessor_() || depict_category.category_id),
       meta_title_suffix_: () => depict_category.meta_title_suffix,
-      query_id_: () => depict_category.category_id,
       listing_type_: () => depict_category.listing_type,
       i18n_: i18n_,
       show_quicklinks_: (0, $b8hua$createMemo)(() => {