@depict-ai/ui 4.10.13 → 4.10.15

package/latest/index.cjs

@@ -109,7 +109,7 @@ $parcel$export(module.exports, "BreadCrumbs", () => $1f4925833f07df29$export$5b7
 $parcel$export(module.exports, "QuickLinks", () => $1f4925833f07df29$export$de035477d6fef996);
 $parcel$export(module.exports, "CategoryPage", () => $14f289047713d67a$export$e2bf8ce7779e827e);
 /*! Depict.ai search and product listing SDK */
-const $b757f75811f3261f$export$83d89fbfd8236492 = "4.10.13";
+const $b757f75811f3261f$export$83d89fbfd8236492 = "4.10.15";
 function $b54e6192d0caa293$export$d9f36cf74e24d595(media_query) {
   const signal = $gVhhF$solidjs.createSignal(false);
   $gVhhF$solidjs.onCleanup($gVhhF$depictaiutilishared.javascript_media_query(media_query, ({
@@ -2698,17 +2698,49 @@ function $cc43b6428000c4bf$export$f21ab0717a89c77f(props) {
     return _el$;
   })();
 }
+
+/**
+ * Whether a click came from the keyboard (Enter/Space) rather than a pointer. Browsers report `detail === 0` for
+ * keyboard-activated clicks and `>= 1` for real pointer clicks, so we use it to only move focus on keyboard opens.
+ */
+function $fb96fea58c4a45dd$export$c5c485c196a19ec1(event) {
+  return event.detail === 0;
+}
 var $0fe1e7efdf4200d6$var$_tmpl$ = /*#__PURE__*/$gVhhF$solidjsweb.template(`<button type=button class=expand-filter><!$><!/><span>`);
 function $0fe1e7efdf4200d6$export$ca21a16d65b3dd8({
   show_extras_: [get_show_extras, set_show_extras],
-  i18n_: i18n_
+  i18n_: i18n_,
+  expanding_container_element_: expanding_container_element_
 }) {
+  let button;
   return (() => {
     var _el$ = $gVhhF$solidjsweb.getNextElement($0fe1e7efdf4200d6$var$_tmpl$),
       _el$3 = _el$.firstChild,
       [_el$4, _co$] = $gVhhF$solidjsweb.getNextMarker(_el$3.nextSibling),
       _el$2 = _el$4.nextSibling;
-    $gVhhF$solidjsweb.addEventListener(_el$, "click", $gVhhF$depictaiutilishared.catchify(() => set_show_extras(p => !p)), true);
+    $gVhhF$solidjsweb.addEventListener(_el$, "click", $gVhhF$depictaiutilishared.catchify(event => {
+      const container = expanding_container_element_;
+      const will_expand = !get_show_extras();
+      // Only move focus for keyboard activation; mouse users see the revealed options and don't need a focus jump.
+      const keyboard_activated = $fb96fea58c4a45dd$export$c5c485c196a19ec1(event);
+      const had_focus_inside = !!container && container.contains(document.activeElement);
+      set_show_extras(will_expand);
+      if (will_expand) {
+        if (!keyboard_activated) return;
+        // `expand()` (consumer's effect, runs after this) clears `inert`/`visibility`; focus the first revealed
+        // option next frame so Tab continues through them. `preventScroll` so it doesn't yank the viewport down.
+        requestAnimationFrame($gVhhF$depictaiutilishared.catchify(() => container?.querySelector("input:not(:disabled)")?.focus({
+          preventScroll: true
+        })));
+      } else if (had_focus_inside)
+        // Keep focus on the toggle when collapsing, otherwise making the container `inert` dumps focus to <body>
+        // (Safari doesn't focus buttons on mouse click, so focus can still be inside the container here).
+        button.focus({
+          preventScroll: true
+        });
+    }), true);
+    var _ref$ = button;
+    typeof _ref$ === "function" ? $gVhhF$solidjsweb.use(_ref$, _el$) : button = _el$;
     $gVhhF$solidjsweb.insert(_el$, $gVhhF$solidjsweb.createComponent((0, $cc43b6428000c4bf$export$f21ab0717a89c77f), {}), _el$4, _co$);
     $gVhhF$solidjsweb.insert(_el$2, (() => {
       var _c$ = $gVhhF$solidjsweb.memo(() => !!get_show_extras());
@@ -2898,7 +2930,8 @@ function $d94869c80e337a3d$export$dd948f91abc3a1c4({
   $gVhhF$solidjs.createRenderEffect(() => {
     set_view_more_button_below_group_(togglable_rest() ? $gVhhF$solidjsweb.createComponent((0, $0fe1e7efdf4200d6$export$ca21a16d65b3dd8), {
       show_extras_: show_extras_signal,
-      i18n_: i18n_
+      i18n_: i18n_,
+      expanding_container_element_: expanding_container_els
     }) : []);
   });
   $gVhhF$solidjs.onCleanup(() => set_view_more_button_below_group_());
@@ -3827,7 +3860,8 @@ function $3bdc00a1353c1150$export$a32086fa6616eafd({
   $gVhhF$solidjs.createRenderEffect(() => {
     set_view_more_button_below_group(some_top_level_are_hidden() ? $gVhhF$solidjsweb.createComponent((0, $0fe1e7efdf4200d6$export$ca21a16d65b3dd8), {
       show_extras_: show_extras,
-      i18n_: i18n_
+      i18n_: i18n_,
+      expanding_container_element_: expanding_container_els
     }) : []);
   });
   $gVhhF$solidjs.onCleanup(() => set_view_more_button_below_group());
@@ -4568,7 +4602,8 @@ function $b51a2b8b9355e66c$export$82ed4b28ecb67608({
   $gVhhF$solidjs.createRenderEffect(() => {
     set_view_more_button_below_group_(togglable_rest() ? $gVhhF$solidjsweb.createComponent((0, $0fe1e7efdf4200d6$export$ca21a16d65b3dd8), {
       show_extras_: show_extras_signal,
-      i18n_: i18n_
+      i18n_: i18n_,
+      expanding_container_element_: expanding_container_els
     }) : []);
   });
   $gVhhF$solidjs.onCleanup(() => set_view_more_button_below_group_());
@@ -5961,8 +5996,8 @@ var $f49857214f7675b1$var$_tmpl$ = /*#__PURE__*/$gVhhF$solidjsweb.template(`<svg
 function $f49857214f7675b1$export$cb808a3c41736d8e() {
   return $gVhhF$solidjsweb.getNextElement($f49857214f7675b1$var$_tmpl$);
 }
-var $f8f64d05c525825b$var$_tmpl$ = /*#__PURE__*/$gVhhF$solidjsweb.template(`<div class=filters><div class=body>`),
-  $f8f64d05c525825b$var$_tmpl$2 = /*#__PURE__*/$gVhhF$solidjsweb.template(`<div class=sorting><div class=body>`),
+var $f8f64d05c525825b$var$_tmpl$ = /*#__PURE__*/$gVhhF$solidjsweb.template(`<section class=filters tabindex=-1><div class=body>`),
+  $f8f64d05c525825b$var$_tmpl$2 = /*#__PURE__*/$gVhhF$solidjsweb.template(`<section class=sorting tabindex=-1><div class=body>`),
   $f8f64d05c525825b$var$_tmpl$3 = /*#__PURE__*/$gVhhF$solidjsweb.template(`<div class=sort-and-filter-buttons><div class=outer><div class=inner><!$><!/><!$><!/><!$><!/>`),
   $f8f64d05c525825b$var$_tmpl$4 = /*#__PURE__*/$gVhhF$solidjsweb.template(`<span class=num-filters>`),
   $f8f64d05c525825b$var$_tmpl$5 = /*#__PURE__*/$gVhhF$solidjsweb.template(`<div class=open-filters-button-container><!$><!/><button type=button><!$><!/><span>`),
@@ -6031,6 +6066,39 @@ function $f8f64d05c525825b$export$d7841e452f2e59a8({
       available_sortings_: available_sortings_,
       meta_of_currently_selected_sorting_: meta_of_currently_selected_sorting_
     };
+    // Keyboard a11y for desktop panels (DOM order: after the grid). Keyboard opens move focus into the panel and
+    // restore it to the toggle on close; mouse opens skip the focus move (already visible, and it'd jump the viewport).
+    // `user_opened_panel` is set only on keyboard activation - `filters_open`/`sorting_open` also change
+    // programmatically (undo toast, history restore, SDK consumers), which must not steal focus.
+    let user_opened_panel = false;
+    let filter_toggle_button;
+    let sort_toggle_button;
+    let current_panel;
+    let current_panel_toggle_button;
+    const focus_panel_when_in_dom = panel => $gVhhF$depictaiutilishared.catchify(async () => {
+      // Bounded wait: if the panel never lands in the DOM (e.g. it's superseded by a rapid re-render before
+      // insertion), the timeout lets this promise resolve instead of keeping `panel` - and the observer
+      // listener it registers - referenced forever.
+      await (0, $gVhhF$depictaiutilishared.observer).wait_for_element(panel, 4000);
+      if (panel.isConnected) {
+        // Focus the first interactive control (often a group's <summary>), not the <section>: the section has no
+        // visible focus ring and is flex-stretched to full grid height (scrolling it mis-aligns). The first
+        // control keeps focus visible and lets Tab walk through the panel. `summary` is focusable but not matched
+        // by the input/button/etc. selectors, so it must be listed explicitly.
+        const focus_target = panel.querySelector("summary, input:not([type='hidden']):not(:disabled), button:not(:disabled), a[href], select:not(:disabled), [tabindex]:not([tabindex='-1'])") ?? panel;
+        focus_target.focus({
+          preventScroll: true
+        });
+        focus_target.scrollIntoView({
+          block: "nearest"
+        });
+      }
+    })();
+    const register_desktop_panel = (el, toggle_button, should_focus) => {
+      current_panel = el;
+      current_panel_toggle_button = toggle_button;
+      if (should_focus) focus_panel_when_in_dom(el);
+    };
     const make_open_filters_button = (adhere_to_width = false, is_tabbable = false) => $gVhhF$solidjsweb.createComponent($f8f64d05c525825b$var$OpenFiltersButton, {
       tabindex_: is_tabbable ? 0 : -1,
       i18n_: i18n_,
@@ -6038,7 +6106,11 @@ function $f8f64d05c525825b$export$d7841e452f2e59a8({
       search_sorting_open_: search_sorting_open_,
       number_of_rendered_selected_filters_items_: number_of_rendered_selected_filters_items_,
       filter_button_width_: adhere_to_width ? filter_button_width_ : undefined,
-      hide_button_: hide_filters
+      hide_button_: hide_filters,
+      on_user_open_: keyboard_activated => {
+        if (keyboard_activated) user_opened_panel = true;
+      },
+      button_ref_: is_tabbable ? el => filter_toggle_button = el : undefined
     });
     const make_open_sorting_button = (adhere_to_width = false, is_tabbable = false) => $gVhhF$solidjsweb.createComponent($f8f64d05c525825b$var$OpenSortingButton, {
       tabindex_: is_tabbable ? 0 : -1,
@@ -6048,7 +6120,11 @@ function $f8f64d05c525825b$export$d7841e452f2e59a8({
       search_sorting_open_: search_sorting_open_,
       available_sortings_: available_sortings_,
       sort_button_width_: adhere_to_width ? sort_button_width_ : undefined,
-      meta_of_currently_selected_sorting_: meta_of_currently_selected_sorting_
+      meta_of_currently_selected_sorting_: meta_of_currently_selected_sorting_,
+      on_user_open_: keyboard_activated => {
+        if (keyboard_activated) user_opened_panel = true;
+      },
+      button_ref_: is_tabbable ? el => sort_toggle_button = el : undefined
     });
     let open_modal_;
     let close_modal_;
@@ -6067,9 +6143,48 @@ function $f8f64d05c525825b$export$d7841e452f2e59a8({
         grid_is_in_original_state = true;
       }
     });
+    // Restore focus to the relevant toggle button when a desktop panel is torn down while focus is still inside it.
+    const restore_focus_to_toggle_on_close = () => {
+      const button_to_restore = current_panel_toggle_button;
+      const focus_was_in_panel = !!current_panel && current_panel.contains(document.activeElement);
+      current_panel = undefined;
+      current_panel_toggle_button = undefined;
+      if (focus_was_in_panel && button_to_restore) button_to_restore.focus({
+        preventScroll: true
+      });
+    };
+    // `<section>` + `aria-label` so the panel announces itself ("Filters"/"Sort") when we move focus to it; the bare
+    // tabindex=-1 container would otherwise give screen readers nothing to read on focus. A semantic <section> avoids
+    // an ARIA role and the UA styling pitfalls of <fieldset>; the existing CSS targets the `.filters`/`.sorting` class.
+    const FiltersPanel = should_focus => $gVhhF$solidjsweb.createComponent((0, $gVhhF$solidjs.Show), {
+      get when() {
+        return !hide_filters();
+      },
+      get children() {
+        var _el$ = $gVhhF$solidjsweb.getNextElement($f8f64d05c525825b$var$_tmpl$),
+          _el$2 = _el$.firstChild;
+        $gVhhF$solidjsweb.use(el => register_desktop_panel(el, filter_toggle_button, should_focus), _el$);
+        $gVhhF$solidjsweb.insert(_el$2, $gVhhF$solidjsweb.createComponent((0, $aff9a96d30ed3563$export$3f1a388cc0d8fed7), filter_options));
+        $gVhhF$solidjsweb.effect(() => $gVhhF$solidjsweb.setAttribute(_el$, "aria-label", i18n_.filters_()));
+        return _el$;
+      }
+    });
+    const SortingPanel = should_focus => (() => {
+      var _el$3 = $gVhhF$solidjsweb.getNextElement($f8f64d05c525825b$var$_tmpl$2),
+        _el$4 = _el$3.firstChild;
+      $gVhhF$solidjsweb.use(el => register_desktop_panel(el, sort_toggle_button, should_focus), _el$3);
+      $gVhhF$solidjsweb.insert(_el$4, $gVhhF$solidjsweb.createComponent((0, $be89be42ce9ea60f$export$1f1775a58da589b5), sorting_options));
+      $gVhhF$solidjsweb.effect(() => $gVhhF$solidjsweb.setAttribute(_el$3, "aria-label", i18n_.sorting_text_()));
+      return _el$3;
+    })();
     $gVhhF$solidjs.createEffect(() => {
+      // Consume the user-intent flag once per run, in every branch, so a stale flag can't leak into a later
+      // resize-triggered re-render and steal focus.
+      const should_focus_panel = user_opened_panel;
+      user_opened_panel = false;
       if (!filters_open() && !sorting_open()) {
         close_modal_?.();
+        restore_focus_to_toggle_on_close();
         set_extra_els_in_results_container_("");
       } else if (isSmall()()) {
         if ($gVhhF$solidjs.untrack(() => input_modal_open_?.())) {
@@ -6078,26 +6193,14 @@ function $f8f64d05c525825b$export$d7841e452f2e59a8({
           set_sorting_open(false);
           return;
         }
+        // The modal manages its own focus; just drop the desktop panel reference.
+        current_panel = undefined;
+        current_panel_toggle_button = undefined;
         open_modal_?.();
         set_extra_els_in_results_container_("");
       } else {
         close_modal_?.();
-        if (filters_open()) set_extra_els_in_results_container_(() => $gVhhF$solidjsweb.createComponent((0, $gVhhF$solidjs.Show), {
-          get when() {
-            return !hide_filters();
-          },
-          get children() {
-            var _el$ = $gVhhF$solidjsweb.getNextElement($f8f64d05c525825b$var$_tmpl$),
-              _el$2 = _el$.firstChild;
-            $gVhhF$solidjsweb.insert(_el$2, $gVhhF$solidjsweb.createComponent((0, $aff9a96d30ed3563$export$3f1a388cc0d8fed7), filter_options));
-            return _el$;
-          }
-        }));else set_extra_els_in_results_container_((() => {
-          var _el$3 = $gVhhF$solidjsweb.getNextElement($f8f64d05c525825b$var$_tmpl$2),
-            _el$4 = _el$3.firstChild;
-          $gVhhF$solidjsweb.insert(_el$4, $gVhhF$solidjsweb.createComponent((0, $be89be42ce9ea60f$export$1f1775a58da589b5), sorting_options));
-          return _el$3;
-        })());
+        if (filters_open()) set_extra_els_in_results_container_(() => FiltersPanel(should_focus_panel));else set_extra_els_in_results_container_(SortingPanel(should_focus_panel));
       }
     });
     $gVhhF$depictaiutilishared.catchify(async () => {
@@ -6161,7 +6264,9 @@ function $f8f64d05c525825b$var$OpenFiltersButton({
   filter_button_width_: filter_button_width_,
   tabindex_: tabindex_,
   number_of_rendered_selected_filters_items_: [num_selected_filters],
-  hide_button_: hide_button_
+  hide_button_: hide_button_,
+  on_user_open_: on_user_open_,
+  button_ref_: button_ref_
 }) {
   const filters_closed = $gVhhF$solidjs.createMemo(() => !search_filters_open_[0]());
   // We assume in embedded_num_products that this is a single HTMLElement so pls change there if you change it here
@@ -6184,14 +6289,18 @@ function $f8f64d05c525825b$var$OpenFiltersButton({
         return _el$15;
       }
     }), _el$21, _co$5);
-    $gVhhF$solidjsweb.addEventListener(_el$16, "click", $gVhhF$depictaiutilishared.catchify(() => $gVhhF$solidjs.batch(() => {
+    $gVhhF$solidjsweb.addEventListener(_el$16, "click", $gVhhF$depictaiutilishared.catchify(event => $gVhhF$solidjs.batch(() => {
       if (search_filters_open_[0]()) {
         search_filters_open_[1](false);
         return;
       }
+      // Only keyboard opens move focus into the panel; mouse opens leave the viewport put.
+      on_user_open_?.($fb96fea58c4a45dd$export$c5c485c196a19ec1(event));
       search_filters_open_[1](true);
       search_sorting_open_[1](false);
     })), true);
+    var _ref$2 = button_ref_;
+    typeof _ref$2 === "function" ? $gVhhF$solidjsweb.use(_ref$2, _el$16) : button_ref_ = _el$16;
     $gVhhF$solidjsweb.setAttribute(_el$16, "tabindex", tabindex_);
     $gVhhF$solidjsweb.className(_el$16, "filter toggle-button major-minor-transition" + ((0, $gVhhF$solidjsweb.isServer) ? " minor" : ""));
     $gVhhF$solidjsweb.insert(_el$16, $gVhhF$solidjsweb.createComponent((0, $gVhhF$solidjs.Show), {
@@ -6213,21 +6322,24 @@ function $f8f64d05c525825b$var$OpenFiltersButton({
         _v$2 = !filters_closed(),
         _v$3 = !!filters_closed(),
         _v$4 = (filters_closed() ? i18n_.open_filters_ : i18n_.close_filters_)(),
-        _v$5 = filter_button_width_?.() ? {
+        _v$5 = !filters_closed(),
+        _v$6 = filter_button_width_?.() ? {
           width: filter_button_width_() + "px"
         } : {};
       _p$.e = $gVhhF$solidjsweb.style(_el$14, _v$, _p$.e);
       _v$2 !== _p$.t && _el$16.classList.toggle("major", _p$.t = _v$2);
       _v$3 !== _p$.a && _el$16.classList.toggle("minor", _p$.a = _v$3);
       _v$4 !== _p$.o && $gVhhF$solidjsweb.setAttribute(_el$16, "aria-label", _p$.o = _v$4);
-      _p$.i = $gVhhF$solidjsweb.style(_el$16, _v$5, _p$.i);
+      _v$5 !== _p$.i && $gVhhF$solidjsweb.setAttribute(_el$16, "aria-expanded", _p$.i = _v$5);
+      _p$.n = $gVhhF$solidjsweb.style(_el$16, _v$6, _p$.n);
       return _p$;
     }, {
       e: undefined,
       t: undefined,
       a: undefined,
       o: undefined,
-      i: undefined
+      i: undefined,
+      n: undefined
     });
     $gVhhF$solidjsweb.runHydrationEvents();
     return _el$14;
@@ -6241,7 +6353,9 @@ function $f8f64d05c525825b$var$OpenSortingButton({
   search_sorting_open_: search_sorting_open_,
   sort_button_width_: sort_button_width_,
   tabindex_: tabindex_,
-  meta_of_currently_selected_sorting_: meta_of_currently_selected_sorting_
+  meta_of_currently_selected_sorting_: meta_of_currently_selected_sorting_,
+  on_user_open_: on_user_open_,
+  button_ref_: button_ref_
 }) {
   const sorting_closed = $gVhhF$solidjs.createMemo(() => !search_sorting_open_[0]());
   // We assume in embedded_num_products that this is a single HTMLElement so pls change there if you change it here
@@ -6250,14 +6364,18 @@ function $f8f64d05c525825b$var$OpenSortingButton({
       _el$23 = _el$22.firstChild,
       _el$24 = _el$23.nextSibling,
       [_el$25, _co$6] = $gVhhF$solidjsweb.getNextMarker(_el$24.nextSibling);
-    $gVhhF$solidjsweb.addEventListener(_el$22, "click", $gVhhF$depictaiutilishared.catchify(() => $gVhhF$solidjs.batch(() => {
+    $gVhhF$solidjsweb.addEventListener(_el$22, "click", $gVhhF$depictaiutilishared.catchify(event => $gVhhF$solidjs.batch(() => {
       if (search_sorting_open_[0]()) {
         search_sorting_open_[1](false);
         return;
       }
+      // Only keyboard opens move focus into the panel; mouse opens leave the viewport put.
+      on_user_open_?.($fb96fea58c4a45dd$export$c5c485c196a19ec1(event));
       search_filters_open_[1](false);
       search_sorting_open_[1](true);
     })), true);
+    var _ref$3 = button_ref_;
+    typeof _ref$3 === "function" ? $gVhhF$solidjsweb.use(_ref$3, _el$22) : button_ref_ = _el$22;
     $gVhhF$solidjsweb.setAttribute(_el$22, "tabindex", tabindex_);
     $gVhhF$solidjsweb.insert(_el$23, (() => {
       var _c$ = $gVhhF$solidjsweb.memo(() => !!sorting_closed());
@@ -6279,22 +6397,25 @@ function $f8f64d05c525825b$var$OpenSortingButton({
       }
     }), _el$25, _co$6);
     $gVhhF$solidjsweb.effect(_p$ => {
-      var _v$6 = !sorting_closed(),
-        _v$7 = !!sorting_closed(),
-        _v$8 = (sorting_closed() ? i18n_.open_sorting_ : i18n_.close_sorting_)(),
-        _v$9 = sort_button_width_?.() ? {
+      var _v$7 = !sorting_closed(),
+        _v$8 = !!sorting_closed(),
+        _v$9 = (sorting_closed() ? i18n_.open_sorting_ : i18n_.close_sorting_)(),
+        _v$10 = !sorting_closed(),
+        _v$11 = sort_button_width_?.() ? {
           width: sort_button_width_() + "px"
         } : {};
-      _v$6 !== _p$.e && _el$22.classList.toggle("major", _p$.e = _v$6);
-      _v$7 !== _p$.t && _el$22.classList.toggle("minor", _p$.t = _v$7);
-      _v$8 !== _p$.a && $gVhhF$solidjsweb.setAttribute(_el$22, "aria-label", _p$.a = _v$8);
-      _p$.o = $gVhhF$solidjsweb.style(_el$22, _v$9, _p$.o);
+      _v$7 !== _p$.e && _el$22.classList.toggle("major", _p$.e = _v$7);
+      _v$8 !== _p$.t && _el$22.classList.toggle("minor", _p$.t = _v$8);
+      _v$9 !== _p$.a && $gVhhF$solidjsweb.setAttribute(_el$22, "aria-label", _p$.a = _v$9);
+      _v$10 !== _p$.o && $gVhhF$solidjsweb.setAttribute(_el$22, "aria-expanded", _p$.o = _v$10);
+      _p$.i = $gVhhF$solidjsweb.style(_el$22, _v$11, _p$.i);
       return _p$;
     }, {
       e: undefined,
       t: undefined,
       a: undefined,
-      o: undefined
+      o: undefined,
+      i: undefined
     });
     $gVhhF$solidjsweb.runHydrationEvents();
     return _el$22;

package/latest/index.d.ts

@@ -11,7 +11,7 @@ import { GetListingRequest } from "@depict-ai/types/api/GetListingRequest";
 import { BaseSearchRequestV3 } from "@depict-ai/types/api/BaseSearchRequestV3";
 import { FeaturedInDisplay } from "@depict-ai/types/api/FeaturedInResponseV3";
 import { SearchFilter as _SearchFilter3 } from "@depict-ai/types/api/SearchRequestV2";
-export const version = "4.10.13";
+export const version = "4.10.15";
 /**
  * Use `javascript_media_query` but return a reactive accessor instead of taking a callback function
  */