@smwb/ui-solid 0.12.1 → 0.14.0

package/dist/components/dataDisplay/thumbCard/thumbCard.js

@@ -1,60 +1,88 @@
-import { use as w, spread as T, mergeProps as L, memo as y, insert as n, createComponent as l, Portal as x, effect as $, setAttribute as F, style as K, isServer as M, template as o } from "solid-js/web";
+import { use as v, spread as P, mergeProps as C, memo as k, insert as o, createComponent as l, Portal as A, effect as D, setAttribute as H, style as I, isServer as j, template as s } from "solid-js/web";
 import '../../../assets/styles/less/components/thumbCard/thumbCard.entry.css';import '../../../assets/styles/less/tokens.entry.css';/* empty css                                     */
 /* empty css                                                             */
-import { mergeProps as O, splitProps as R, children as p, createSignal as A, onCleanup as I, Show as c } from "solid-js";
-import j from "clsx";
-import { createFloating as q } from "../../../primitives/createFloating.js";
-import { mergeRefs as B } from "../../../primitives/mergeRefs.js";
-import { LazyImage as G } from "../lazyImage/lazyImage.js";
-var H = /* @__PURE__ */ o('<div class="smwb-thumb-card__slot smwb-thumb-card__slot--start">'), J = /* @__PURE__ */ o('<div class="smwb-thumb-card__slot smwb-thumb-card__slot--end">'), N = /* @__PURE__ */ o("<div class=smwb-thumb-card__caption>"), Q = /* @__PURE__ */ o("<div class=smwb-thumb-card__preview>"), U = /* @__PURE__ */ o("<div><div class=smwb-thumb-card__media>"), V = /* @__PURE__ */ o("<img alt>");
-function le(S) {
-  const P = O({
+import { mergeProps as q, splitProps as B, children as f, createSignal as G, onCleanup as J, Show as c } from "solid-js";
+import N from "clsx";
+import { createFloating as Q } from "../../../primitives/createFloating.js";
+import { mergeRefs as U } from "../../../primitives/mergeRefs.js";
+import { callHandler as m } from "../../../primitives/callHandler.js";
+import { isOwnClick as V } from "../../../utils/ownClick.js";
+import { splitControlProps as W } from "../../../utils/controlProps.js";
+import { LazyImage as X } from "../lazyImage/lazyImage.js";
+var Y = /* @__PURE__ */ s("<div class=smwb-thumb-card__caption>"), Z = /* @__PURE__ */ s('<div class="smwb-thumb-card__slot smwb-thumb-card__slot--start">'), ee = /* @__PURE__ */ s('<div class="smwb-thumb-card__slot smwb-thumb-card__slot--end">'), te = /* @__PURE__ */ s("<div class=smwb-thumb-card__preview>"), re = /* @__PURE__ */ s("<div><div><div class=smwb-thumb-card__media>"), oe = /* @__PURE__ */ s("<img alt>");
+function ve(E) {
+  const M = q({
     lazy: !0,
     hoverDelay: 350
-  }, S), [e, k] = R(P, ["src", "caption", "selected", "onSelect", "fallback", "hoverPreview", "topStart", "topEnd", "lazy", "disabled", "hoverDelay", "class", "ref"]), v = p(() => e.topStart), b = p(() => e.topEnd), h = p(() => e.caption), m = q({
+  }, E), [e, z] = B(M, [
+    "src",
+    "caption",
+    "selected",
+    "onSelect",
+    "fallback",
+    "hoverPreview",
+    "topStart",
+    "topEnd",
+    "lazy",
+    "disabled",
+    "hoverDelay",
+    "class",
+    "ref",
+    // The card sets these on its root too; its own handlers call the caller's.
+    "onClick",
+    "onKeyDown",
+    "onMouseEnter",
+    "onMouseLeave"
+  ]), [h, L] = W(z);
+  let d;
+  const g = f(() => e.topStart), _ = f(() => e.topEnd), w = f(() => e.caption), u = Q({
     placement: () => "right"
-  }), [D, g] = A(!1);
+  }), [T, y] = G(!1);
   let i;
-  const d = () => {
+  const p = () => {
     i && (clearTimeout(i), i = void 0);
-  }, E = () => {
-    e.hoverPreview == null || e.disabled || (d(), i = setTimeout(() => g(!0), e.hoverDelay));
-  }, z = () => {
-    d(), g(!1);
+  }, x = (t) => {
+    m(e.onMouseEnter, t), !(e.hoverPreview == null || e.disabled) && (p(), i = setTimeout(() => y(!0), e.hoverDelay));
+  }, K = (t) => {
+    m(e.onMouseLeave, t), p(), y(!1);
   };
-  I(d);
-  const a = () => !!e.onSelect && !e.disabled, C = (r) => {
-    a() && (r.key === "Enter" || r.key === " ") && (r.preventDefault(), e.onSelect?.());
+  J(p);
+  const b = () => !!e.onSelect && !e.disabled, O = (t) => {
+    if (e.disabled) return;
+    const n = V(t, d ?? null);
+    m(e.onClick, t), n && e.onSelect?.();
+  }, F = (t) => {
+    m(e.onKeyDown, t), !(!b() || t.target !== d) && (t.key === "Enter" || t.key === " ") && (t.preventDefault(), e.onSelect?.());
   };
   return (() => {
-    var r = U(), u = r.firstChild, f = B(e.ref, (t) => m.setReference(t));
-    return typeof f == "function" && w(f, r), T(r, L(k, {
+    var t = re(), n = t.firstChild, R = n.firstChild, $ = U(e.ref, (r) => u.setReference(r));
+    return typeof $ == "function" && v($, t), P(t, C(L, {
       get class() {
-        return j("smwb-thumb-card", e.class, {
+        return N("smwb-thumb-card", e.class, {
           "smwb-thumb-card--selected": e.selected,
           "smwb-thumb-card--disabled": e.disabled,
-          "smwb-thumb-card--interactive": a()
+          "smwb-thumb-card--interactive": b()
         });
       },
+      onClick: O,
+      onKeyDown: F,
+      onMouseEnter: x,
+      onMouseLeave: K
+    }), !1, !0), v((r) => d = r, n), P(n, C(h, {
+      class: "smwb-thumb-card__content",
       get role() {
-        return a() ? "button" : void 0;
+        return e.onSelect ? "button" : void 0;
       },
       get tabindex() {
-        return a() ? 0 : void 0;
+        return h.tabindex ?? (b() ? 0 : void 0);
       },
       get "aria-pressed"() {
-        return y(() => !!e.onSelect)() ? e.selected ?? !1 : void 0;
+        return k(() => !!e.onSelect)() ? e.selected ?? !1 : void 0;
       },
       get "aria-disabled"() {
         return e.disabled || void 0;
-      },
-      get onClick() {
-        return a() ? () => e.onSelect?.() : void 0;
-      },
-      onKeyDown: C,
-      onMouseEnter: E,
-      onMouseLeave: z
-    }), !1, !0), n(u, l(G, {
+      }
+    }), !1, !0), o(R, l(X, {
       get src() {
         return e.src;
       },
@@ -64,52 +92,52 @@ function le(S) {
       get fallback() {
         return e.fallback;
       }
-    }), null), n(u, l(c, {
+    })), o(n, l(c, {
       get when() {
-        return v();
+        return w();
       },
       get children() {
-        var t = H();
-        return n(t, v), t;
+        var r = Y();
+        return o(r, w), r;
       }
-    }), null), n(u, l(c, {
+    }), null), o(t, l(c, {
       get when() {
-        return b();
+        return g();
       },
       get children() {
-        var t = J();
-        return n(t, b), t;
+        var r = Z();
+        return o(r, g), r;
       }
-    }), null), n(r, l(c, {
+    }), null), o(t, l(c, {
       get when() {
-        return h();
+        return _();
       },
       get children() {
-        var t = N();
-        return n(t, h), t;
+        var r = ee();
+        return o(r, _), r;
       }
-    }), null), n(r, l(c, {
+    }), null), o(t, l(c, {
       get when() {
-        return D() && !M;
+        return T() && !j;
       },
       get children() {
-        return l(x, {
+        return l(A, {
           get children() {
-            var t = Q();
-            return w((s) => m.setFloating(s), t), n(t, (() => {
-              var s = y(() => typeof e.hoverPreview == "string");
-              return () => s() ? (() => {
-                var _ = V();
-                return $(() => F(_, "src", e.hoverPreview)), _;
+            var r = te();
+            return v((a) => u.setFloating(a), r), o(r, (() => {
+              var a = k(() => typeof e.hoverPreview == "string");
+              return () => a() ? (() => {
+                var S = oe();
+                return D(() => H(S, "src", e.hoverPreview)), S;
               })() : e.hoverPreview;
-            })()), $((s) => K(t, m.floatingStyles(), s)), t;
+            })()), D((a) => I(r, u.floatingStyles(), a)), r;
           }
         });
       }
-    }), null), r;
+    }), null), t;
   })();
 }
 export {
-  le as ThumbCard
+  ve as ThumbCard
 };
 //# sourceMappingURL=thumbCard.js.map

package/dist/components/dataDisplay/thumbCard/thumbCard.js.map

@@ -1 +1 @@
-{"version":3,"file":"thumbCard.js","sources":["../../../../src/components/dataDisplay/thumbCard/thumbCard.tsx"],"sourcesContent":["import { type JSX, Show, children, createSignal, mergeProps, onCleanup, splitProps } from \"solid-js\";\nimport { Portal, isServer } from \"solid-js/web\";\nimport cn from \"clsx\";\nimport { createFloating } from \"../../../primitives/createFloating\";\nimport { LazyImage } from \"../lazyImage\";\nimport { mergeRefs, type Ref } from \"../../../primitives/mergeRefs\";\n\nexport interface ThumbCardProps extends Omit<JSX.HTMLAttributes<HTMLDivElement>, \"onSelect\"> {\n  /** Thumbnail URL; falls back to `fallback` when missing / failed. */\n  src?: string;\n  caption?: JSX.Element;\n  selected?: boolean;\n  /** Makes the card a selectable button (keyboard + `aria-pressed`). */\n  onSelect?: () => void;\n  /** Shown in place of the image when `src` is missing / fails. */\n  fallback?: JSX.Element;\n  /** A larger preview shown in a floating popup after a hover delay. */\n  hoverPreview?: JSX.Element | string;\n  /** Top-left overlay slot (e.g. a favourite star). */\n  topStart?: JSX.Element;\n  /** Top-right overlay slot (e.g. a kebab menu). */\n  topEnd?: JSX.Element;\n  lazy?: boolean;\n  disabled?: boolean;\n  /** Delay (ms) before the hover preview appears. Default 350. */\n  hoverDelay?: number;\n  ref?: Ref<HTMLDivElement>;\n}\n\n/**\n * A selectable gallery card: image with an `onError` fallback + optional lazy\n * load, keyboard/`aria-pressed` selection, corner action slots, and a delayed\n * floating hover-preview. The generic gallery-card behaviour every app rebuilds\n * on top of the primitives. SSR-safe — the hover preview is client-only.\n */\nexport function ThumbCard(props: ThumbCardProps): JSX.Element {\n  const merged = mergeProps({ lazy: true, hoverDelay: 350 }, props);\n  const [local, rest] = splitProps(merged, [\n    \"src\",\n    \"caption\",\n    \"selected\",\n    \"onSelect\",\n    \"fallback\",\n    \"hoverPreview\",\n    \"topStart\",\n    \"topEnd\",\n    \"lazy\",\n    \"disabled\",\n    \"hoverDelay\",\n    \"class\",\n    \"ref\",\n  ]);\n\n  // Read each slot once: markup passed as a prop is created anew on every read,\n  // and during hydration a copy the server never rendered has no DOM node.\n  // (The hover preview is read on hover only, after hydration.)\n  const topStart = children(() => local.topStart);\n  const topEnd = children(() => local.topEnd);\n  const caption = children(() => local.caption);\n\n  const floating = createFloating({ placement: () => \"right\" });\n  const [previewOpen, setPreviewOpen] = createSignal(false);\n  let hoverTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const clearTimer = (): void => {\n    if (hoverTimer) {\n      clearTimeout(hoverTimer);\n      hoverTimer = undefined;\n    }\n  };\n  const onEnter = (): void => {\n    if (local.hoverPreview == null || local.disabled) return;\n    clearTimer();\n    hoverTimer = setTimeout(() => setPreviewOpen(true), local.hoverDelay);\n  };\n  const onLeave = (): void => {\n    clearTimer();\n    setPreviewOpen(false);\n  };\n  onCleanup(clearTimer);\n\n  const interactive = (): boolean => !!local.onSelect && !local.disabled;\n  const onKeyDown: JSX.EventHandler<HTMLDivElement, KeyboardEvent> = (event) => {\n    if (interactive() && (event.key === \"Enter\" || event.key === \" \")) {\n      event.preventDefault();\n      local.onSelect?.();\n    }\n  };\n\n  return (\n    <div\n      {...rest}\n      ref={mergeRefs(local.ref, (el) => floating.setReference(el))}\n      class={cn(\"smwb-thumb-card\", local.class, {\n        \"smwb-thumb-card--selected\": local.selected,\n        \"smwb-thumb-card--disabled\": local.disabled,\n        \"smwb-thumb-card--interactive\": interactive(),\n      })}\n      role={interactive() ? \"button\" : undefined}\n      tabindex={interactive() ? 0 : undefined}\n      aria-pressed={local.onSelect ? (local.selected ?? false) : undefined}\n      aria-disabled={local.disabled || undefined}\n      onClick={interactive() ? () => local.onSelect?.() : undefined}\n      onKeyDown={onKeyDown}\n      onMouseEnter={onEnter}\n      onMouseLeave={onLeave}\n    >\n      <div class=\"smwb-thumb-card__media\">\n        <LazyImage src={local.src} lazy={local.lazy} fallback={local.fallback} />\n        <Show when={topStart()}>\n          <div class=\"smwb-thumb-card__slot smwb-thumb-card__slot--start\">{topStart()}</div>\n        </Show>\n        <Show when={topEnd()}>\n          <div class=\"smwb-thumb-card__slot smwb-thumb-card__slot--end\">{topEnd()}</div>\n        </Show>\n      </div>\n      <Show when={caption()}>\n        <div class=\"smwb-thumb-card__caption\">{caption()}</div>\n      </Show>\n      <Show when={previewOpen() && !isServer}>\n        <Portal>\n          <div class=\"smwb-thumb-card__preview\" ref={(el) => floating.setFloating(el)} style={floating.floatingStyles()}>\n            {typeof local.hoverPreview === \"string\" ? (\n              <img src={local.hoverPreview} alt=\"\" />\n            ) : (\n              (local.hoverPreview as JSX.Element)\n            )}\n          </div>\n        </Portal>\n      </Show>\n    </div>\n  );\n}\n\nexport default ThumbCard;\n"],"names":["ThumbCard","props","merged","mergeProps","lazy","hoverDelay","local","rest","splitProps","topStart","children","topEnd","caption","floating","createFloating","placement","previewOpen","setPreviewOpen","createSignal","hoverTimer","clearTimer","clearTimeout","undefined","onEnter","hoverPreview","disabled","setTimeout","onLeave","onCleanup","interactive","onSelect","onKeyDown","event","key","preventDefault","_el$","_tmpl$5","_el$2","firstChild","_ref$","mergeRefs","ref","el","setReference","_$use","_$spread","_$mergeProps","cn","class","selected","role","tabindex","_$memo","onClick","_$insert","_$createComponent","LazyImage","src","fallback","Show","when","_el$3","_tmpl$","_el$4","_tmpl$2","_el$5","_tmpl$3","isServer","Portal","_el$6","_tmpl$4","setFloating","_c$","_el$7","_tmpl$6","_$effect","_$setAttribute","_$p","_$style","floatingStyles"],"mappings":"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"}
+{"version":3,"file":"thumbCard.js","sources":["../../../../src/components/dataDisplay/thumbCard/thumbCard.tsx"],"sourcesContent":["import { type JSX, Show, children, createSignal, mergeProps, onCleanup, splitProps } from \"solid-js\";\nimport { Portal, isServer } from \"solid-js/web\";\nimport cn from \"clsx\";\nimport { createFloating } from \"../../../primitives/createFloating\";\nimport { LazyImage } from \"../lazyImage\";\nimport { mergeRefs, type Ref } from \"../../../primitives/mergeRefs\";\nimport { callHandler } from \"../../../primitives/callHandler\";\nimport { isOwnClick } from \"../../../utils/ownClick\";\nimport { splitControlProps } from \"../../../utils/controlProps\";\n\nexport interface ThumbCardProps extends Omit<JSX.HTMLAttributes<HTMLDivElement>, \"onSelect\"> {\n  /**\n   * Class name(s) for the root `<div>`, the card's box. `style`, `id`, `data-*`, `aria-hidden`, `ref` and event\n   * handlers go to the root too, but `role`, `tabindex`, `onFocus`, `onBlur` and the other `aria-*` attributes go to\n   * the card's content, `.smwb-thumb-card__content` (the image and the caption): that is the card's button when it has\n   * `onSelect`, and the element to focus.\n   */\n  class?: string | undefined;\n  /** Thumbnail URL; falls back to `fallback` when missing / failed. */\n  src?: string;\n  /**\n   * Text under the image. With `onSelect` it is part of the card's button and names it, so keep controls out of it:\n   * they go in `topStart` / `topEnd`.\n   */\n  caption?: JSX.Element;\n  /** Outlines the image; with `onSelect`, the card's button is also `aria-pressed=\"true\"`. */\n  selected?: boolean;\n  /**\n   * Makes the card selectable: its content (the image and the caption) becomes a toggle button with `aria-pressed`,\n   * selected by a click and by Enter / Space. The corner slots are not part of that button but its siblings, laid over\n   * the image, so their controls keep their own names, clicks and keys.\n   *\n   * A click selects the card unless it lands in a control in a slot (button, link, input, anything focusable) or in a\n   * portal opened from the card. Slot content that is not a control keeps its click from selecting the card by calling\n   * `preventDefault()` on it.\n   */\n  onSelect?: () => void;\n  /**\n   * Runs on each click on the card, before `onSelect`, but not while the card is `disabled`.\n   * A click on a control in a slot runs it too, without selecting the card.\n   * Enter / Space select the card without a click, so they call only `onSelect`.\n   */\n  onClick?: JSX.EventHandlerUnion<HTMLDivElement, MouseEvent> | undefined;\n  /** Shown in place of the image when `src` is missing / fails. */\n  fallback?: JSX.Element;\n  /** A larger preview shown in a floating popup after a hover delay. */\n  hoverPreview?: JSX.Element | string;\n  /**\n   * Top-left overlay slot (e.g. a favourite star). It sits over the image, outside the card's button, so controls here\n   * keep their own names, clicks and keys; see `onSelect`.\n   */\n  topStart?: JSX.Element;\n  /**\n   * Top-right overlay slot (e.g. a kebab menu). It sits over the image, outside the card's button, so controls here\n   * keep their own names, clicks and keys; see `onSelect`.\n   */\n  topEnd?: JSX.Element;\n  lazy?: boolean;\n  /**\n   * Dims the card and ignores clicks on it: neither `onClick` nor `onSelect` runs.\n   * Keys do not select it either, and there is no hover preview. With `onSelect`\n   * the card is still a button, `aria-disabled` and out of the tab order.\n   */\n  disabled?: boolean;\n  /** Delay (ms) before the hover preview appears. Default 350. */\n  hoverDelay?: number;\n  ref?: Ref<HTMLDivElement>;\n}\n\n/**\n * A selectable gallery card: image with an `onError` fallback + optional lazy\n * load, keyboard/`aria-pressed` selection, corner action slots, and a delayed\n * floating hover-preview. The generic gallery-card behaviour every app rebuilds\n * on top of the primitives. SSR-safe — the hover preview is client-only.\n *\n * The root is a box around the card's content (the image and the caption, the\n * card's button when it is selectable) and the corner slots, which are laid\n * over the image beside that button rather than inside it.\n */\nexport function ThumbCard(props: ThumbCardProps): JSX.Element {\n  const merged = mergeProps({ lazy: true, hoverDelay: 350 }, props);\n  const [local, rest] = splitProps(merged, [\n    \"src\",\n    \"caption\",\n    \"selected\",\n    \"onSelect\",\n    \"fallback\",\n    \"hoverPreview\",\n    \"topStart\",\n    \"topEnd\",\n    \"lazy\",\n    \"disabled\",\n    \"hoverDelay\",\n    \"class\",\n    \"ref\",\n    // The card sets these on its root too; its own handlers call the caller's.\n    \"onClick\",\n    \"onKeyDown\",\n    \"onMouseEnter\",\n    \"onMouseLeave\",\n  ]);\n  // What the card is to the keyboard and to assistive tech goes to its\n  // content, the element that is its button; the rest stays on the root.\n  const [control, box] = splitControlProps(rest);\n  let content: HTMLDivElement | undefined;\n\n  // Read each slot once: markup passed as a prop is created anew on every read,\n  // and during hydration a copy the server never rendered has no DOM node.\n  // (The hover preview is read on hover only, after hydration.)\n  const topStart = children(() => local.topStart);\n  const topEnd = children(() => local.topEnd);\n  const caption = children(() => local.caption);\n\n  const floating = createFloating({ placement: () => \"right\" });\n  const [previewOpen, setPreviewOpen] = createSignal(false);\n  let hoverTimer: ReturnType<typeof setTimeout> | undefined;\n\n  const clearTimer = (): void => {\n    if (hoverTimer) {\n      clearTimeout(hoverTimer);\n      hoverTimer = undefined;\n    }\n  };\n  const onEnter: JSX.EventHandler<HTMLDivElement, MouseEvent> = (event) => {\n    callHandler(local.onMouseEnter, event);\n    if (local.hoverPreview == null || local.disabled) return;\n    clearTimer();\n    hoverTimer = setTimeout(() => setPreviewOpen(true), local.hoverDelay);\n  };\n  const onLeave: JSX.EventHandler<HTMLDivElement, MouseEvent> = (event) => {\n    callHandler(local.onMouseLeave, event);\n    clearTimer();\n    setPreviewOpen(false);\n  };\n  onCleanup(clearTimer);\n\n  const interactive = (): boolean => !!local.onSelect && !local.disabled;\n  // A disabled card ignores clicks, the caller's onClick included: it says\n  // aria-disabled, and its styles turn pointer events off. The caller's onClick\n  // sees every other click, those in the slots too, but only clicks on the\n  // card's content and on what is not a control in a slot select it: not one\n  // on a control in a slot, nor one in a Portal opened from the card. That is\n  // settled before onClick runs, so what onClick does to the event or the DOM\n  // does not change it.\n  const onClick: JSX.EventHandler<HTMLDivElement, MouseEvent> = (event) => {\n    if (local.disabled) return;\n    const selects = isOwnClick(event, content ?? null);\n    callHandler(local.onClick, event);\n    if (selects) local.onSelect?.();\n  };\n  // Keys pressed on a control in a slot bubble up here too; only the keys of\n  // the card's button select it.\n  const onKeyDown: JSX.EventHandler<HTMLDivElement, KeyboardEvent> = (event) => {\n    callHandler(local.onKeyDown, event);\n    if (!interactive() || event.target !== content) return;\n    if (event.key === \"Enter\" || event.key === \" \") {\n      event.preventDefault();\n      local.onSelect?.();\n    }\n  };\n\n  return (\n    <div\n      {...box}\n      ref={mergeRefs(local.ref, (el) => floating.setReference(el))}\n      class={cn(\"smwb-thumb-card\", local.class, {\n        \"smwb-thumb-card--selected\": local.selected,\n        \"smwb-thumb-card--disabled\": local.disabled,\n        \"smwb-thumb-card--interactive\": interactive(),\n      })}\n      onClick={onClick}\n      onKeyDown={onKeyDown}\n      onMouseEnter={onEnter}\n      onMouseLeave={onLeave}\n    >\n      <div\n        {...control}\n        ref={(el) => (content = el)}\n        class=\"smwb-thumb-card__content\"\n        // With onSelect the content is the card's button and says whether it is\n        // pressed, and a disabled card says so: these win over the caller's, and\n        // where the card sets none (undefined), the caller's stay. Its tabindex\n        // is a default: the caller's wins, e.g. for roving focus.\n        role={local.onSelect ? \"button\" : undefined}\n        tabindex={control.tabindex ?? (interactive() ? 0 : undefined)}\n        aria-pressed={local.onSelect ? (local.selected ?? false) : undefined}\n        aria-disabled={local.disabled || undefined}\n      >\n        <div class=\"smwb-thumb-card__media\">\n          <LazyImage src={local.src} lazy={local.lazy} fallback={local.fallback} />\n        </div>\n        <Show when={caption()}>\n          <div class=\"smwb-thumb-card__caption\">{caption()}</div>\n        </Show>\n      </div>\n      {/* Beside the button, not in it: controls here keep their names and input. */}\n      <Show when={topStart()}>\n        <div class=\"smwb-thumb-card__slot smwb-thumb-card__slot--start\">{topStart()}</div>\n      </Show>\n      <Show when={topEnd()}>\n        <div class=\"smwb-thumb-card__slot smwb-thumb-card__slot--end\">{topEnd()}</div>\n      </Show>\n      <Show when={previewOpen() && !isServer}>\n        <Portal>\n          <div class=\"smwb-thumb-card__preview\" ref={(el) => floating.setFloating(el)} style={floating.floatingStyles()}>\n            {typeof local.hoverPreview === \"string\" ? (\n              <img src={local.hoverPreview} alt=\"\" />\n            ) : (\n              (local.hoverPreview as JSX.Element)\n            )}\n          </div>\n        </Portal>\n      </Show>\n    </div>\n  );\n}\n\nexport default ThumbCard;\n"],"names":["ThumbCard","props","merged","mergeProps","lazy","hoverDelay","local","rest","splitProps","control","box","splitControlProps","content","topStart","children","topEnd","caption","floating","createFloating","placement","previewOpen","setPreviewOpen","createSignal","hoverTimer","clearTimer","clearTimeout","undefined","onEnter","event","callHandler","onMouseEnter","hoverPreview","disabled","setTimeout","onLeave","onMouseLeave","onCleanup","interactive","onSelect","onClick","selects","isOwnClick","onKeyDown","target","key","preventDefault","_el$","_tmpl$5","_el$2","firstChild","_el$3","_ref$","mergeRefs","ref","el","setReference","_$use","_$spread","_$mergeProps","cn","class","selected","role","tabindex","_$memo","_$insert","_$createComponent","LazyImage","src","fallback","Show","when","_el$4","_tmpl$","_el$5","_tmpl$2","_el$6","_tmpl$3","isServer","Portal","_el$7","_tmpl$4","setFloating","_c$","_el$8","_tmpl$6","_$effect","_$setAttribute","_$p","_$style","floatingStyles"],"mappings":"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"}

package/dist/components/dataDisplay/treeView/treeView.d.ts

@@ -25,10 +25,32 @@ export interface TreeViewProps extends Omit<JSX.HTMLAttributes<HTMLDivElement>,
         id: string;
         selected: boolean;
     }) => void;
+    /**
+     * Enables row selection: a click, Enter or Space on a row toggles its selection. The chevron and the
+     * Left/Right keys never change it.
+     */
     selectable?: boolean;
+    /** Renders a checkbox per node bound to selection. */
     checkboxes?: boolean;
+    /**
+     * Whether a click, Enter or Space on a row also expands or collapses its children. The chevron and the
+     * Right/Left keys always do. Defaults to `true` while the tree is not `selectable` (a row has nothing else to
+     * do) and to `false` otherwise, so that selecting a row leaves it open or closed.
+     */
+    toggleOnRowClick?: boolean;
+    /** Custom node renderer. */
     renderLabel?: (item: ITreeNodeItem, nodeId: string) => JSX.Element;
+    /**
+     * Per-node actions (buttons, a menu trigger), drawn at the end of the row. They sit beside the row's
+     * button, not inside it, so they take their own clicks, Enter and Space, focus and accessible names.
+     */
+    renderActions?: (item: ITreeNodeItem, nodeId: string) => JSX.Element;
+    /** Text shown while `loadChildren` is pending; "Loading…" unless given. */
+    loadingText?: string;
+    /** Lazily resolves children the first time a node is expanded. */
     loadChildren?: (item: ITreeNodeItem, nodeId: string) => Promise<ITreeNodeItem[]>;
+    /** Test id of the root `<div>`; `tree-view` unless given. */
+    "data-testid"?: string | undefined;
     ref?: Ref<HTMLDivElement>;
 }
 export declare function TreeView(props: TreeViewProps): JSX.Element;