@salt-ds/lab 1.0.0-alpha.92 → 1.0.0-alpha.93

package/dist-es/side-panel/internal/useIsScrollable.js

@@ -1,48 +0,0 @@
-import { useState, useEffect } from 'react';
-
-const observedAttributes = ["class", "hidden", "style"];
-function useIsScrollable(ref) {
-  const [isScrollable, setIsScrollable] = useState(false);
-  useEffect(() => {
-    const element = ref.current;
-    const win = element == null ? void 0 : element.ownerDocument.defaultView;
-    if (!element || !win) {
-      return;
-    }
-    let animationFrame;
-    const checkScrollable = () => {
-      animationFrame = void 0;
-      const nextIsScrollable = element.scrollHeight > element.clientHeight || element.scrollWidth > element.clientWidth;
-      setIsScrollable(
-        (currentIsScrollable) => currentIsScrollable === nextIsScrollable ? currentIsScrollable : nextIsScrollable
-      );
-    };
-    const scheduleCheck = () => {
-      if (animationFrame === void 0) {
-        animationFrame = win.requestAnimationFrame(checkScrollable);
-      }
-    };
-    scheduleCheck();
-    const resizeObserver = win.ResizeObserver ? new win.ResizeObserver(scheduleCheck) : void 0;
-    resizeObserver == null ? void 0 : resizeObserver.observe(element);
-    const mutationObserver = win.MutationObserver ? new win.MutationObserver(scheduleCheck) : void 0;
-    mutationObserver == null ? void 0 : mutationObserver.observe(element, {
-      attributeFilter: observedAttributes,
-      attributes: true,
-      characterData: true,
-      childList: true,
-      subtree: true
-    });
-    return () => {
-      if (animationFrame !== void 0) {
-        win.cancelAnimationFrame(animationFrame);
-      }
-      resizeObserver == null ? void 0 : resizeObserver.disconnect();
-      mutationObserver == null ? void 0 : mutationObserver.disconnect();
-    };
-  }, [ref]);
-  return isScrollable;
-}
-
-export { useIsScrollable };
-//# sourceMappingURL=useIsScrollable.js.map

package/dist-es/side-panel/internal/useIsScrollable.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useIsScrollable.js","sources":["../src/side-panel/internal/useIsScrollable.ts"],"sourcesContent":["import { type RefObject, useEffect, useState } from \"react\";\n\nconst observedAttributes = [\"class\", \"hidden\", \"style\"];\n\nexport function useIsScrollable(ref: RefObject<HTMLElement>) {\n  const [isScrollable, setIsScrollable] = useState(false);\n\n  useEffect(() => {\n    const element = ref.current;\n    const win = element?.ownerDocument.defaultView;\n    if (!element || !win) {\n      return;\n    }\n\n    let animationFrame: number | undefined;\n\n    const checkScrollable = () => {\n      animationFrame = undefined;\n      const nextIsScrollable =\n        element.scrollHeight > element.clientHeight ||\n        element.scrollWidth > element.clientWidth;\n\n      setIsScrollable((currentIsScrollable) =>\n        currentIsScrollable === nextIsScrollable\n          ? currentIsScrollable\n          : nextIsScrollable,\n      );\n    };\n\n    const scheduleCheck = () => {\n      if (animationFrame === undefined) {\n        animationFrame = win.requestAnimationFrame(checkScrollable);\n      }\n    };\n\n    scheduleCheck();\n\n    const resizeObserver = win.ResizeObserver\n      ? new win.ResizeObserver(scheduleCheck)\n      : undefined;\n    resizeObserver?.observe(element);\n\n    const mutationObserver = win.MutationObserver\n      ? new win.MutationObserver(scheduleCheck)\n      : undefined;\n    mutationObserver?.observe(element, {\n      attributeFilter: observedAttributes,\n      attributes: true,\n      characterData: true,\n      childList: true,\n      subtree: true,\n    });\n\n    return () => {\n      if (animationFrame !== undefined) {\n        win.cancelAnimationFrame(animationFrame);\n      }\n      resizeObserver?.disconnect();\n      mutationObserver?.disconnect();\n    };\n  }, [ref]);\n\n  return isScrollable;\n}\n"],"names":[],"mappings":";;AAEA,MAAM,kBAAA,GAAqB,CAAC,OAAA,EAAS,QAAA,EAAU,OAAO,CAAA;AAE/C,SAAS,gBAAgB,GAAA,EAA6B;AAC3D,EAAA,MAAM,CAAC,YAAA,EAAc,eAAe,CAAA,GAAI,SAAS,KAAK,CAAA;AAEtD,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,UAAU,GAAA,CAAI,OAAA;AACpB,IAAA,MAAM,GAAA,GAAM,mCAAS,aAAA,CAAc,WAAA;AACnC,IAAA,IAAI,CAAC,OAAA,IAAW,CAAC,GAAA,EAAK;AACpB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,cAAA;AAEJ,IAAA,MAAM,kBAAkB,MAAM;AAC5B,MAAA,cAAA,GAAiB,MAAA;AACjB,MAAA,MAAM,mBACJ,OAAA,CAAQ,YAAA,GAAe,QAAQ,YAAA,IAC/B,OAAA,CAAQ,cAAc,OAAA,CAAQ,WAAA;AAEhC,MAAA,eAAA;AAAA,QAAgB,CAAC,mBAAA,KACf,mBAAA,KAAwB,gBAAA,GACpB,mBAAA,GACA;AAAA,OACN;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,gBAAgB,MAAM;AAC1B,MAAA,IAAI,mBAAmB,MAAA,EAAW;AAChC,QAAA,cAAA,GAAiB,GAAA,CAAI,sBAAsB,eAAe,CAAA;AAAA,MAC5D;AAAA,IACF,CAAA;AAEA,IAAA,aAAA,EAAc;AAEd,IAAA,MAAM,iBAAiB,GAAA,CAAI,cAAA,GACvB,IAAI,GAAA,CAAI,cAAA,CAAe,aAAa,CAAA,GACpC,MAAA;AACJ,IAAA,cAAA,IAAA,IAAA,GAAA,MAAA,GAAA,cAAA,CAAgB,OAAA,CAAQ,OAAA,CAAA;AAExB,IAAA,MAAM,mBAAmB,GAAA,CAAI,gBAAA,GACzB,IAAI,GAAA,CAAI,gBAAA,CAAiB,aAAa,CAAA,GACtC,MAAA;AACJ,IAAA,gBAAA,IAAA,IAAA,GAAA,MAAA,GAAA,gBAAA,CAAkB,QAAQ,OAAA,EAAS;AAAA,MACjC,eAAA,EAAiB,kBAAA;AAAA,MACjB,UAAA,EAAY,IAAA;AAAA,MACZ,aAAA,EAAe,IAAA;AAAA,MACf,SAAA,EAAW,IAAA;AAAA,MACX,OAAA,EAAS;AAAA,KACX,CAAA;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,mBAAmB,MAAA,EAAW;AAChC,QAAA,GAAA,CAAI,qBAAqB,cAAc,CAAA;AAAA,MACzC;AACA,MAAA,cAAA,IAAA,IAAA,GAAA,MAAA,GAAA,cAAA,CAAgB,UAAA,EAAA;AAChB,MAAA,gBAAA,IAAA,IAAA,GAAA,MAAA,GAAA,gBAAA,CAAkB,UAAA,EAAA;AAAA,IACpB,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,GAAG,CAAC,CAAA;AAER,EAAA,OAAO,YAAA;AACT;;;;"}

package/dist-es/side-panel/internal/useSidePanelTabOrder.js

@@ -1,212 +0,0 @@
-import { useEffect } from 'react';
-import { tabbable } from 'tabbable';
-
-const ORIGINAL_TABINDEX_ATTR = "data-salt-original-tabindex";
-function isPlainTabKey(event) {
-  return event.key === "Tab" && !event.altKey && !event.ctrlKey && !event.metaKey;
-}
-function getPanelTabbableElements(panel) {
-  const win = panel.ownerDocument.defaultView;
-  const managed = Array.from(
-    panel.querySelectorAll(`[${ORIGINAL_TABINDEX_ATTR}]`)
-  ).filter((element) => {
-    if (element.hasAttribute("disabled")) return false;
-    if (element.getAttribute("aria-hidden") === "true") return false;
-    return !(element.offsetParent === null && (win == null ? void 0 : win.getComputedStyle(element).display) === "none");
-  });
-  if (managed.length > 0) {
-    return managed;
-  }
-  return tabbable(panel, { displayCheck: "none" });
-}
-function focusFirstPanelElement(panel) {
-  const [firstTabbableElement] = getPanelTabbableElements(panel);
-  (firstTabbableElement ?? panel).focus();
-}
-function focusLastPanelElement(panel) {
-  const tabbableElements = getPanelTabbableElements(panel);
-  (tabbableElements[tabbableElements.length - 1] ?? panel).focus();
-}
-function containsTarget(container, target) {
-  const targetWindow = container.ownerDocument.defaultView;
-  return Boolean(
-    (targetWindow == null ? void 0 : targetWindow.Node) && target instanceof targetWindow.Node && container.contains(target)
-  );
-}
-function getNextTabbableAfterReference(reference, panel) {
-  const { body } = reference.ownerDocument;
-  if (!body) return void 0;
-  const tabbableElements = tabbable(body).filter(
-    (element) => !panel.contains(element)
-  );
-  const referenceIndex = tabbableElements.findIndex(
-    (element) => element === reference || reference.contains(element)
-  );
-  if (referenceIndex === -1) {
-    return void 0;
-  }
-  return tabbableElements[referenceIndex + 1];
-}
-function detachElement(element) {
-  if (!element.hasAttribute(ORIGINAL_TABINDEX_ATTR)) {
-    const original = element.getAttribute("tabindex");
-    element.setAttribute(ORIGINAL_TABINDEX_ATTR, original ?? "");
-  }
-  if (element.getAttribute("tabindex") !== "-1") {
-    element.setAttribute("tabindex", "-1");
-  }
-}
-function reattachElement(element) {
-  if (!element.hasAttribute(ORIGINAL_TABINDEX_ATTR)) return;
-  const original = element.getAttribute(ORIGINAL_TABINDEX_ATTR);
-  element.removeAttribute(ORIGINAL_TABINDEX_ATTR);
-  if (original === null || original === "") {
-    element.removeAttribute("tabindex");
-  } else {
-    element.setAttribute("tabindex", original);
-  }
-}
-function detachPanelFromTabOrder(panel) {
-  const win = panel.ownerDocument.defaultView ?? window;
-  const detach = () => {
-    for (const element of tabbable(panel, { displayCheck: "none" })) {
-      detachElement(element);
-    }
-    const managed = panel.querySelectorAll(
-      `[${ORIGINAL_TABINDEX_ATTR}]`
-    );
-    for (const element of Array.from(managed)) {
-      if (element.getAttribute("tabindex") !== "-1") {
-        element.setAttribute("tabindex", "-1");
-      }
-    }
-  };
-  detach();
-  let scheduled = 0;
-  const scheduleDetach = () => {
-    if (scheduled) return;
-    scheduled = win.requestAnimationFrame(() => {
-      scheduled = 0;
-      detach();
-    });
-  };
-  const observer = new MutationObserver(scheduleDetach);
-  observer.observe(panel, {
-    subtree: true,
-    childList: true,
-    attributes: true,
-    attributeFilter: ["tabindex", "disabled", "contenteditable", "hidden"]
-  });
-  return () => {
-    if (scheduled) {
-      win.cancelAnimationFrame(scheduled);
-    }
-    observer.disconnect();
-    const managed = panel.querySelectorAll(
-      `[${ORIGINAL_TABINDEX_ATTR}]`
-    );
-    for (const element of Array.from(managed)) {
-      reattachElement(element);
-    }
-  };
-}
-function useSidePanelTabOrder(props) {
-  const { floating, open, reference } = props;
-  useEffect(() => {
-    if (!open || !reference || !floating) {
-      return;
-    }
-    const { ownerDocument } = reference;
-    let redirectTriggerTab = true;
-    let programmaticReferenceFocus = false;
-    const releaseDetachment = detachPanelFromTabOrder(floating);
-    const onReferenceFocus = (event) => {
-      if (programmaticReferenceFocus) {
-        programmaticReferenceFocus = false;
-        return;
-      }
-      const relatedTarget = event.relatedTarget;
-      if (relatedTarget && relatedTarget instanceof Node && !(reference.compareDocumentPosition(relatedTarget) & Node.DOCUMENT_POSITION_PRECEDING)) {
-        redirectTriggerTab = false;
-        return;
-      }
-      redirectTriggerTab = true;
-    };
-    const onReferenceKeyDown = (event) => {
-      if (event.defaultPrevented || !isPlainTabKey(event) || event.shiftKey) {
-        return;
-      }
-      if (!redirectTriggerTab) {
-        return;
-      }
-      event.preventDefault();
-      redirectTriggerTab = false;
-      focusFirstPanelElement(floating);
-    };
-    const onFloatingKeyDown = (event) => {
-      if (event.defaultPrevented || !isPlainTabKey(event)) {
-        return;
-      }
-      const panelTabbableElements = getPanelTabbableElements(floating);
-      const activeElement = floating.ownerDocument.activeElement;
-      const currentIndex = activeElement ? panelTabbableElements.indexOf(activeElement) : -1;
-      if (event.shiftKey) {
-        if (currentIndex <= 0) {
-          event.preventDefault();
-          redirectTriggerTab = true;
-          programmaticReferenceFocus = true;
-          reference.focus();
-          return;
-        }
-        event.preventDefault();
-        panelTabbableElements[currentIndex - 1].focus();
-        return;
-      }
-      const atLast = currentIndex === panelTabbableElements.length - 1 || currentIndex === -1 && panelTabbableElements.length === 0;
-      if (atLast) {
-        event.preventDefault();
-        const nextElement = getNextTabbableAfterReference(reference, floating);
-        if (nextElement) {
-          nextElement.focus();
-        } else {
-          redirectTriggerTab = false;
-          programmaticReferenceFocus = true;
-          reference.focus();
-        }
-        return;
-      }
-      if (currentIndex === -1) {
-        event.preventDefault();
-        panelTabbableElements[0].focus();
-        return;
-      }
-      event.preventDefault();
-      panelTabbableElements[currentIndex + 1].focus();
-    };
-    const onDocumentKeyDown = (event) => {
-      if (event.defaultPrevented || !isPlainTabKey(event) || !event.shiftKey) {
-        return;
-      }
-      const nextElement = getNextTabbableAfterReference(reference, floating);
-      if (!nextElement || !containsTarget(nextElement, event.target)) {
-        return;
-      }
-      event.preventDefault();
-      focusLastPanelElement(floating);
-    };
-    reference.addEventListener("focus", onReferenceFocus);
-    reference.addEventListener("keydown", onReferenceKeyDown);
-    floating.addEventListener("keydown", onFloatingKeyDown);
-    ownerDocument.addEventListener("keydown", onDocumentKeyDown);
-    return () => {
-      reference.removeEventListener("focus", onReferenceFocus);
-      reference.removeEventListener("keydown", onReferenceKeyDown);
-      floating.removeEventListener("keydown", onFloatingKeyDown);
-      ownerDocument.removeEventListener("keydown", onDocumentKeyDown);
-      releaseDetachment();
-    };
-  }, [floating, open, reference]);
-}
-
-export { useSidePanelTabOrder };
-//# sourceMappingURL=useSidePanelTabOrder.js.map

package/dist-es/side-panel/internal/useSidePanelTabOrder.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useSidePanelTabOrder.js","sources":["../src/side-panel/internal/useSidePanelTabOrder.ts"],"sourcesContent":["import { useEffect } from \"react\";\nimport { tabbable } from \"tabbable\";\n\ninterface UseSidePanelTabOrderProps {\n  floating: HTMLElement | null;\n  open: boolean;\n  reference: HTMLElement | null;\n}\n\nconst ORIGINAL_TABINDEX_ATTR = \"data-salt-original-tabindex\";\n\nfunction isPlainTabKey(event: KeyboardEvent) {\n  return (\n    event.key === \"Tab\" && !event.altKey && !event.ctrlKey && !event.metaKey\n  );\n}\n\n/**\n * Returns the panel's logical tab sequence. While the panel is open we\n * strip tabindex on descendants, so the sequence is discovered via the\n * data-salt-original-tabindex markers; falls back to a fresh tabbable()\n * scan before detachment runs.\n */\nfunction getPanelTabbableElements(panel: HTMLElement): HTMLElement[] {\n  const win = panel.ownerDocument.defaultView;\n  const managed = Array.from(\n    panel.querySelectorAll<HTMLElement>(`[${ORIGINAL_TABINDEX_ATTR}]`),\n  ).filter((element) => {\n    if (element.hasAttribute(\"disabled\")) return false;\n    if (element.getAttribute(\"aria-hidden\") === \"true\") return false;\n    // null offsetParent is also true for fixed/SVG; the display check\n    // disambiguates.\n    return !(\n      element.offsetParent === null &&\n      win?.getComputedStyle(element).display === \"none\"\n    );\n  });\n\n  if (managed.length > 0) {\n    return managed;\n  }\n\n  return tabbable(panel, { displayCheck: \"none\" }) as HTMLElement[];\n}\n\nfunction focusFirstPanelElement(panel: HTMLElement) {\n  const [firstTabbableElement] = getPanelTabbableElements(panel);\n  (firstTabbableElement ?? panel).focus();\n}\n\nfunction focusLastPanelElement(panel: HTMLElement) {\n  const tabbableElements = getPanelTabbableElements(panel);\n  (tabbableElements[tabbableElements.length - 1] ?? panel).focus();\n}\n\nfunction containsTarget(container: Element, target: EventTarget | null) {\n  const targetWindow = container.ownerDocument.defaultView;\n\n  return Boolean(\n    targetWindow?.Node &&\n      target instanceof targetWindow.Node &&\n      container.contains(target),\n  );\n}\n\n/**\n * Returns the first tabbable element after `reference` in document order,\n * skipping anything inside `panel`.\n */\nfunction getNextTabbableAfterReference(\n  reference: HTMLElement,\n  panel: HTMLElement,\n) {\n  const { body } = reference.ownerDocument;\n  if (!body) return undefined;\n  const tabbableElements = tabbable(body).filter(\n    (element) => !panel.contains(element),\n  );\n  const referenceIndex = tabbableElements.findIndex(\n    (element) => element === reference || reference.contains(element),\n  );\n\n  if (referenceIndex === -1) {\n    return undefined;\n  }\n\n  return tabbableElements[referenceIndex + 1];\n}\n\n/**\n * Detaches an element from the natural tab sequence, remembering its\n * original tabindex (or its absence) on a data attribute for restoration.\n */\nfunction detachElement(element: HTMLElement) {\n  if (!element.hasAttribute(ORIGINAL_TABINDEX_ATTR)) {\n    const original = element.getAttribute(\"tabindex\");\n    element.setAttribute(ORIGINAL_TABINDEX_ATTR, original ?? \"\");\n  }\n  // Force re-apply: React may have rewritten the attribute on re-render.\n  if (element.getAttribute(\"tabindex\") !== \"-1\") {\n    element.setAttribute(\"tabindex\", \"-1\");\n  }\n}\n\nfunction reattachElement(element: HTMLElement) {\n  if (!element.hasAttribute(ORIGINAL_TABINDEX_ATTR)) return;\n  const original = element.getAttribute(ORIGINAL_TABINDEX_ATTR);\n  element.removeAttribute(ORIGINAL_TABINDEX_ATTR);\n  if (original === null || original === \"\") {\n    element.removeAttribute(\"tabindex\");\n  } else {\n    element.setAttribute(\"tabindex\", original);\n  }\n}\n\n/**\n * Removes every tabbable descendant of `panel` from the natural tab order.\n * Returns a cleanup function that restores original tabindex values and\n * disconnects the observer used to track dynamically-added focusables.\n */\nfunction detachPanelFromTabOrder(panel: HTMLElement) {\n  const win = panel.ownerDocument.defaultView ?? window;\n\n  const detach = () => {\n    for (const element of tabbable(panel, { displayCheck: \"none\" })) {\n      detachElement(element as HTMLElement);\n    }\n    // Re-assert tabindex=\"-1\" on already-managed elements (React may\n    // have written its prop value back).\n    const managed = panel.querySelectorAll<HTMLElement>(\n      `[${ORIGINAL_TABINDEX_ATTR}]`,\n    );\n    for (const element of Array.from(managed)) {\n      if (element.getAttribute(\"tabindex\") !== \"-1\") {\n        element.setAttribute(\"tabindex\", \"-1\");\n      }\n    }\n  };\n\n  detach();\n\n  // Coalesce mutation bursts into one frame to avoid a feedback loop\n  // between detach()'s tabindex writes and the observer's tabindex filter.\n  let scheduled = 0;\n  const scheduleDetach = () => {\n    if (scheduled) return;\n    scheduled = win.requestAnimationFrame(() => {\n      scheduled = 0;\n      detach();\n    });\n  };\n\n  const observer = new MutationObserver(scheduleDetach);\n\n  observer.observe(panel, {\n    subtree: true,\n    childList: true,\n    attributes: true,\n    attributeFilter: [\"tabindex\", \"disabled\", \"contenteditable\", \"hidden\"],\n  });\n\n  return () => {\n    if (scheduled) {\n      win.cancelAnimationFrame(scheduled);\n    }\n    observer.disconnect();\n    const managed = panel.querySelectorAll<HTMLElement>(\n      `[${ORIGINAL_TABINDEX_ATTR}]`,\n    );\n    for (const element of Array.from(managed)) {\n      reattachElement(element);\n    }\n  };\n}\n\nexport function useSidePanelTabOrder(props: UseSidePanelTabOrderProps) {\n  const { floating, open, reference } = props;\n\n  useEffect(() => {\n    if (!open || !reference || !floating) {\n      return;\n    }\n\n    const { ownerDocument } = reference;\n\n    // True when Tab on the trigger should walk into the panel (a \"fresh\n    // entry\": focus arrived from before the trigger, or from nowhere).\n    // Set false when focus arrives from inside / after the panel, so the\n    // user can keep tabbing forward without getting trapped.\n    let redirectTriggerTab = true;\n\n    // Set true just before we programmatically focus the trigger, so the\n    // focusin handler can preserve our explicit redirect intent instead\n    // of overwriting it from the relatedTarget heuristic.\n    let programmaticReferenceFocus = false;\n\n    // Make panel content unreachable via natural Tab — only the trigger\n    // flow below can enter.\n    const releaseDetachment = detachPanelFromTabOrder(floating);\n\n    const onReferenceFocus = (event: FocusEvent) => {\n      if (programmaticReferenceFocus) {\n        programmaticReferenceFocus = false;\n        return;\n      }\n\n      const relatedTarget = event.relatedTarget as Node | null;\n\n      // Focus arrived from inside / after the panel — disable redirect\n      // so Tab moves forward naturally and doesn't trap the user.\n      if (\n        relatedTarget &&\n        relatedTarget instanceof Node &&\n        !(\n          reference.compareDocumentPosition(relatedTarget) &\n          Node.DOCUMENT_POSITION_PRECEDING\n        )\n      ) {\n        redirectTriggerTab = false;\n        return;\n      }\n\n      redirectTriggerTab = true;\n    };\n\n    const onReferenceKeyDown = (event: KeyboardEvent) => {\n      if (event.defaultPrevented || !isPlainTabKey(event) || event.shiftKey) {\n        return;\n      }\n\n      // Only redirect on a fresh entry; otherwise let the browser advance\n      // to the next focusable element naturally.\n      if (!redirectTriggerTab) {\n        return;\n      }\n\n      event.preventDefault();\n      redirectTriggerTab = false;\n      focusFirstPanelElement(floating);\n    };\n\n    const onFloatingKeyDown = (event: KeyboardEvent) => {\n      if (event.defaultPrevented || !isPlainTabKey(event)) {\n        return;\n      }\n\n      const panelTabbableElements = getPanelTabbableElements(floating);\n      const activeElement = floating.ownerDocument\n        .activeElement as HTMLElement | null;\n      const currentIndex = activeElement\n        ? panelTabbableElements.indexOf(activeElement)\n        : -1;\n\n      if (event.shiftKey) {\n        // At the start of the panel (or on the panel container itself):\n        // exit backwards to the trigger and arm the redirect so the next\n        // forward Tab walks back in.\n        if (currentIndex <= 0) {\n          event.preventDefault();\n          redirectTriggerTab = true;\n          programmaticReferenceFocus = true;\n          reference.focus();\n          return;\n        }\n\n        event.preventDefault();\n        panelTabbableElements[currentIndex - 1].focus();\n        return;\n      }\n\n      // At the end of the panel: exit forwards to the element after the\n      // trigger. Also handles focus on the panel container itself when\n      // the panel has no tabbable items.\n      const atLast =\n        currentIndex === panelTabbableElements.length - 1 ||\n        (currentIndex === -1 && panelTabbableElements.length === 0);\n\n      if (atLast) {\n        event.preventDefault();\n        const nextElement = getNextTabbableAfterReference(reference, floating);\n        if (nextElement) {\n          nextElement.focus();\n        } else {\n          // Nothing after the trigger — hand focus back to the trigger\n          // but disable redirect so the next Tab moves naturally.\n          redirectTriggerTab = false;\n          programmaticReferenceFocus = true;\n          reference.focus();\n        }\n        return;\n      }\n\n      // Focus on the panel container or an unmanaged ancestor — route\n      // forward into the first managed element.\n      if (currentIndex === -1) {\n        event.preventDefault();\n        panelTabbableElements[0].focus();\n        return;\n      }\n\n      event.preventDefault();\n      panelTabbableElements[currentIndex + 1].focus();\n    };\n\n    const onDocumentKeyDown = (event: KeyboardEvent) => {\n      if (event.defaultPrevented || !isPlainTabKey(event) || !event.shiftKey) {\n        return;\n      }\n\n      const nextElement = getNextTabbableAfterReference(reference, floating);\n      if (!nextElement || !containsTarget(nextElement, event.target)) {\n        return;\n      }\n\n      event.preventDefault();\n      focusLastPanelElement(floating);\n    };\n\n    reference.addEventListener(\"focus\", onReferenceFocus);\n    reference.addEventListener(\"keydown\", onReferenceKeyDown);\n    floating.addEventListener(\"keydown\", onFloatingKeyDown);\n    ownerDocument.addEventListener(\"keydown\", onDocumentKeyDown);\n\n    return () => {\n      reference.removeEventListener(\"focus\", onReferenceFocus);\n      reference.removeEventListener(\"keydown\", onReferenceKeyDown);\n      floating.removeEventListener(\"keydown\", onFloatingKeyDown);\n      ownerDocument.removeEventListener(\"keydown\", onDocumentKeyDown);\n      releaseDetachment();\n    };\n  }, [floating, open, reference]);\n}\n"],"names":[],"mappings":"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"}

package/dist-es/side-panel/useSidePanel.js

@@ -1,41 +0,0 @@
-import { useEventCallback } from '@salt-ds/core';
-import { useSidePanelContext } from './internal/SidePanelContext.js';
-import 'react';
-import 'tabbable';
-
-function useSidePanel() {
-  const { openState, setOpen, setReference, panelId } = useSidePanelContext();
-  const getTriggerProps = useEventCallback(
-    (userProps) => {
-      const userOnClick = userProps == null ? void 0 : userProps.onClick;
-      const userRef = userProps == null ? void 0 : userProps.ref;
-      return {
-        "aria-expanded": openState,
-        "aria-controls": openState ? panelId : void 0,
-        ...userProps,
-        onClick: (event) => {
-          userOnClick == null ? void 0 : userOnClick(event);
-          setOpen(!openState);
-        },
-        ref: (node) => {
-          setReference(node);
-          if (typeof userRef === "function") {
-            userRef(node);
-          } else if (userRef && typeof userRef === "object" && "current" in userRef) {
-            userRef.current = node;
-          }
-        }
-      };
-    }
-  );
-  return {
-    openState,
-    setOpen,
-    getTriggerProps,
-    setTriggerRef: setReference,
-    panelId
-  };
-}
-
-export { useSidePanel };
-//# sourceMappingURL=useSidePanel.js.map

package/dist-es/side-panel/useSidePanel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useSidePanel.js","sources":["../src/side-panel/useSidePanel.ts"],"sourcesContent":["import { useEventCallback } from \"@salt-ds/core\";\nimport type {\n  ComponentPropsWithoutRef,\n  MouseEvent,\n  MutableRefObject,\n  RefCallback,\n} from \"react\";\nimport { useSidePanelContext } from \"./internal\";\n\nexport interface SidePanelTriggerExtraProps {\n  /**\n   * Optional ref to forward alongside the focus-return registration.\n   */\n  ref?:\n    | RefCallback<HTMLElement | null>\n    | MutableRefObject<HTMLElement | null>\n    | null;\n  /**\n   * Click handler. Runs before the built-in toggle so consumers can\n   * preventDefault to skip the toggle.\n   */\n  onClick?: (event: MouseEvent<HTMLButtonElement>) => void;\n}\n\nexport type SidePanelTriggerPropsResult = ComponentPropsWithoutRef<\"button\"> & {\n  \"aria-expanded\": boolean;\n  \"aria-controls\": string | undefined;\n  ref: RefCallback<HTMLElement | null>;\n};\n\nexport interface SidePanelValue {\n  /**\n   * Whether the side panel is currently open.\n   */\n  openState: boolean;\n  /**\n   * Sets the open state of the panel.\n   */\n  setOpen: (open: boolean) => void;\n  /**\n   * Props getter for a trigger element outside of `SidePanelTrigger`.\n   * Returns `aria-expanded`, `aria-controls`, a `ref` (for focus-return),\n   * and an `onClick` that toggles the panel.\n   *\n   * Spread the result onto a Button to get full trigger behavior:\n   * ```tsx\n   * <Button {...getTriggerProps()}>Toggle panel</Button>\n   * ```\n   *\n   * You can pass additional props which are merged in. If you provide your\n   * own `onClick`, it runs before the built-in toggle. If you provide your\n   * own `ref`, it is forwarded alongside the internal focus-return ref.\n   *\n   * For multi-trigger scenarios (e.g. table rows), use `setTriggerRef` and\n   * manage ARIA attributes yourself instead.\n   */\n  getTriggerProps: (\n    userProps?: SidePanelTriggerExtraProps,\n  ) => SidePanelTriggerPropsResult;\n  /**\n   * Registers the element that should receive focus when the panel closes.\n   * Use this in multi-trigger scenarios (e.g. table rows) where each trigger\n   * needs explicit control over which element is the reference. Pass `null`\n   * to clear the previously-registered trigger.\n   */\n  setTriggerRef: (element: HTMLElement | null) => void;\n  /**\n   * The panel's DOM id. Use this for `aria-controls` in multi-trigger\n   * scenarios where you manage ARIA attributes yourself.\n   */\n  panelId: string | undefined;\n}\n\nexport function useSidePanel(): SidePanelValue {\n  const { openState, setOpen, setReference, panelId } = useSidePanelContext();\n\n  // useEventCallback gives a stable identity so consumers can memoise\n  // around getTriggerProps without it churning on open/close.\n  const getTriggerProps = useEventCallback(\n    (userProps?: SidePanelTriggerExtraProps): SidePanelTriggerPropsResult => {\n      const userOnClick = userProps?.onClick;\n      const userRef = userProps?.ref;\n\n      return {\n        \"aria-expanded\": openState,\n        \"aria-controls\": openState ? panelId : undefined,\n        ...userProps,\n        onClick: (event: MouseEvent<HTMLButtonElement>) => {\n          userOnClick?.(event);\n          setOpen(!openState);\n        },\n        ref: (node: HTMLElement | null) => {\n          setReference(node);\n          if (typeof userRef === \"function\") {\n            userRef(node);\n          } else if (\n            userRef &&\n            typeof userRef === \"object\" &&\n            \"current\" in userRef\n          ) {\n            userRef.current = node;\n          }\n        },\n      };\n    },\n  );\n\n  return {\n    openState,\n    setOpen,\n    getTriggerProps,\n    setTriggerRef: setReference,\n    panelId,\n  };\n}\n"],"names":[],"mappings":";;;;;AAyEO,SAAS,YAAA,GAA+B;AAC7C,EAAA,MAAM,EAAE,SAAA,EAAW,OAAA,EAAS,YAAA,EAAc,OAAA,KAAY,mBAAA,EAAoB;AAI1E,EAAA,MAAM,eAAA,GAAkB,gBAAA;AAAA,IACtB,CAAC,SAAA,KAAwE;AACvE,MAAA,MAAM,cAAc,SAAA,IAAA,IAAA,GAAA,MAAA,GAAA,SAAA,CAAW,OAAA;AAC/B,MAAA,MAAM,UAAU,SAAA,IAAA,IAAA,GAAA,MAAA,GAAA,SAAA,CAAW,GAAA;AAE3B,MAAA,OAAO;AAAA,QACL,eAAA,EAAiB,SAAA;AAAA,QACjB,eAAA,EAAiB,YAAY,OAAA,GAAU,MAAA;AAAA,QACvC,GAAG,SAAA;AAAA,QACH,OAAA,EAAS,CAAC,KAAA,KAAyC;AACjD,UAAA,WAAA,IAAA,IAAA,GAAA,MAAA,GAAA,WAAA,CAAc,KAAA,CAAA;AACd,UAAA,OAAA,CAAQ,CAAC,SAAS,CAAA;AAAA,QACpB,CAAA;AAAA,QACA,GAAA,EAAK,CAAC,IAAA,KAA6B;AACjC,UAAA,YAAA,CAAa,IAAI,CAAA;AACjB,UAAA,IAAI,OAAO,YAAY,UAAA,EAAY;AACjC,YAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,UACd,WACE,OAAA,IACA,OAAO,OAAA,KAAY,QAAA,IACnB,aAAa,OAAA,EACb;AACA,YAAA,OAAA,CAAQ,OAAA,GAAU,IAAA;AAAA,UACpB;AAAA,QACF;AAAA,OACF;AAAA,IACF;AAAA,GACF;AAEA,EAAA,OAAO;AAAA,IACL,SAAA;AAAA,IACA,OAAA;AAAA,IACA,eAAA;AAAA,IACA,aAAA,EAAe,YAAA;AAAA,IACf;AAAA,GACF;AACF;;;;"}

package/dist-types/side-panel/SidePanel.d.ts

@@ -1,26 +0,0 @@
-import { type ComponentPropsWithRef, type RefObject } from "react";
-export interface SidePanelProps extends ComponentPropsWithRef<"div"> {
-    /**
-     * Disable the panel's own open/close animation.
-     * Set to `true` when the parent controls sizing and animation (e.g. inside a splitter).
-     * @default false
-     */
-    disableAnimation?: boolean;
-    /**
-     * Edge the panel is anchored to; controls animation direction and divider side.
-     * @default "right"
-     */
-    position?: "right" | "left";
-    /**
-     * Which element receives focus when the panel opens.
-     * Pass a number for the tabbable element index (0 = first), or a ref to a specific element.
-     * Defaults to the first tabbable element inside the panel (close button if present).
-     */
-    initialFocus?: number | RefObject<HTMLElement | null>;
-    /**
-     * The background color palette. Options are 'primary', 'secondary', 'tertiary' and 'none'.
-     * @default "primary"
-     */
-    variant?: "primary" | "secondary" | "tertiary" | "none";
-}
-export declare const SidePanel: import("react").ForwardRefExoticComponent<Omit<SidePanelProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/side-panel/SidePanelCloseButton.d.ts

@@ -1,2 +0,0 @@
-import { type ButtonProps } from "@salt-ds/core";
-export declare const SidePanelCloseButton: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;

package/dist-types/side-panel/SidePanelContent.d.ts

@@ -1,5 +0,0 @@
-import { type ComponentPropsWithRef } from "react";
-export type SidePanelContentProps = ComponentPropsWithRef<"div">;
-export declare const SidePanelContent: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
-}, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/side-panel/SidePanelHeader.d.ts

@@ -1,5 +0,0 @@
-import { type ComponentPropsWithRef } from "react";
-export type SidePanelHeaderProps = ComponentPropsWithRef<"div">;
-export declare const SidePanelHeader: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
-}, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/side-panel/SidePanelProvider.d.ts

@@ -1,20 +0,0 @@
-import { type ReactNode } from "react";
-export interface SidePanelProviderProps {
-    /**
-     * Whether the panel is open.
-     */
-    open?: boolean;
-    /**
-     * Default open state when initially rendered.
-     */
-    defaultOpen?: boolean;
-    /**
-     * Callback when open state changes.
-     */
-    onOpenChange?: (open: boolean) => void;
-    /**
-     * SidePanelProvider children, should include SidePanel and SidePanelTrigger.
-     */
-    children: ReactNode;
-}
-export declare function SidePanelProvider(props: SidePanelProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist-types/side-panel/SidePanelTitle.d.ts

@@ -1,3 +0,0 @@
-import { type TextProps } from "@salt-ds/core";
-export type SidePanelTitleProps = TextProps<"div">;
-export declare const SidePanelTitle: import("react").ForwardRefExoticComponent<Omit<SidePanelTitleProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist-types/side-panel/SidePanelTrigger.d.ts

@@ -1,3 +0,0 @@
-import { type ComponentPropsWithoutRef } from "react";
-export type SidePanelTriggerProps = ComponentPropsWithoutRef<"button">;
-export declare const SidePanelTrigger: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & import("react").RefAttributes<HTMLButtonElement>>;

package/dist-types/side-panel/index.d.ts

@@ -1,8 +0,0 @@
-export * from "./SidePanel";
-export * from "./SidePanelCloseButton";
-export * from "./SidePanelContent";
-export * from "./SidePanelHeader";
-export * from "./SidePanelProvider";
-export * from "./SidePanelTitle";
-export * from "./SidePanelTrigger";
-export * from "./useSidePanel";

package/dist-types/side-panel/internal/SidePanelContext.d.ts

@@ -1,52 +0,0 @@
-import type { FloatingRootContext } from "@floating-ui/react";
-import { type Dispatch, type SetStateAction } from "react";
-export interface SidePanelContextValue {
-    /**
-     * Whether the side panel is currently open.
-     */
-    openState: boolean;
-    /**
-     * The floating-ui root context shared between the trigger and the panel.
-     * Coordinates interactions (click, dismiss, role) across both elements.
-     */
-    floatingRootContext: FloatingRootContext;
-    /**
-     * Ref setter for the panel element.
-     * Registers the panel DOM node with floating-ui.
-     */
-    setFloating: Dispatch<SetStateAction<HTMLDivElement | null>>;
-    /**
-     * Ref setter for the reference (trigger) element.
-     * Registers the trigger DOM node with floating-ui for focus return.
-     */
-    setReference: Dispatch<SetStateAction<HTMLElement | null>>;
-    /**
-     * Sets the open state of the panel.
-     * Called by the close button in SidePanelHeader, or any consumer that needs to close the panel.
-     */
-    setOpen: (open: boolean) => void;
-    /**
-     * Side panel id used for aria-controls on the trigger.
-     */
-    panelId?: string;
-    /**
-     * Registers or clears the side panel id used for aria-controls/id linkage.
-     */
-    setPanelId: Dispatch<SetStateAction<string | undefined>>;
-    /**
-     * The auto-generated id placed on SidePanelTitle.
-     * Used for aria-labelledby on the panel region and the scrollable body.
-     */
-    titleId?: string;
-    /**
-     * Registers the title id from SidePanelTitle back to the context
-     * so that SidePanel and SidePanelContent can use it for aria-labelledby.
-     */
-    setTitleId: Dispatch<SetStateAction<string | undefined>>;
-    /**
-     * Edge the panel is anchored to. Set by SidePanel for its own subtree.
-     */
-    position?: "right" | "left";
-}
-export declare const SidePanelContext: import("react").Context<SidePanelContextValue>;
-export declare function useSidePanelContext(): SidePanelContextValue;

package/dist-types/side-panel/internal/index.d.ts

@@ -1,3 +0,0 @@
-export { SidePanelContext, type SidePanelContextValue, useSidePanelContext, } from "./SidePanelContext";
-export * from "./useIsScrollable";
-export * from "./useSidePanelTabOrder";

package/dist-types/side-panel/internal/useIsScrollable.d.ts

@@ -1,2 +0,0 @@
-import { type RefObject } from "react";
-export declare function useIsScrollable(ref: RefObject<HTMLElement>): boolean;

package/dist-types/side-panel/internal/useSidePanelTabOrder.d.ts

@@ -1,7 +0,0 @@
-interface UseSidePanelTabOrderProps {
-    floating: HTMLElement | null;
-    open: boolean;
-    reference: HTMLElement | null;
-}
-export declare function useSidePanelTabOrder(props: UseSidePanelTabOrderProps): void;
-export {};

package/dist-types/side-panel/useSidePanel.d.ts

@@ -1,58 +0,0 @@
-import type { ComponentPropsWithoutRef, MouseEvent, MutableRefObject, RefCallback } from "react";
-export interface SidePanelTriggerExtraProps {
-    /**
-     * Optional ref to forward alongside the focus-return registration.
-     */
-    ref?: RefCallback<HTMLElement | null> | MutableRefObject<HTMLElement | null> | null;
-    /**
-     * Click handler. Runs before the built-in toggle so consumers can
-     * preventDefault to skip the toggle.
-     */
-    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
-}
-export type SidePanelTriggerPropsResult = ComponentPropsWithoutRef<"button"> & {
-    "aria-expanded": boolean;
-    "aria-controls": string | undefined;
-    ref: RefCallback<HTMLElement | null>;
-};
-export interface SidePanelValue {
-    /**
-     * Whether the side panel is currently open.
-     */
-    openState: boolean;
-    /**
-     * Sets the open state of the panel.
-     */
-    setOpen: (open: boolean) => void;
-    /**
-     * Props getter for a trigger element outside of `SidePanelTrigger`.
-     * Returns `aria-expanded`, `aria-controls`, a `ref` (for focus-return),
-     * and an `onClick` that toggles the panel.
-     *
-     * Spread the result onto a Button to get full trigger behavior:
-     * ```tsx
-     * <Button {...getTriggerProps()}>Toggle panel</Button>
-     * ```
-     *
-     * You can pass additional props which are merged in. If you provide your
-     * own `onClick`, it runs before the built-in toggle. If you provide your
-     * own `ref`, it is forwarded alongside the internal focus-return ref.
-     *
-     * For multi-trigger scenarios (e.g. table rows), use `setTriggerRef` and
-     * manage ARIA attributes yourself instead.
-     */
-    getTriggerProps: (userProps?: SidePanelTriggerExtraProps) => SidePanelTriggerPropsResult;
-    /**
-     * Registers the element that should receive focus when the panel closes.
-     * Use this in multi-trigger scenarios (e.g. table rows) where each trigger
-     * needs explicit control over which element is the reference. Pass `null`
-     * to clear the previously-registered trigger.
-     */
-    setTriggerRef: (element: HTMLElement | null) => void;
-    /**
-     * The panel's DOM id. Use this for `aria-controls` in multi-trigger
-     * scenarios where you manage ARIA attributes yourself.
-     */
-    panelId: string | undefined;
-}
-export declare function useSidePanel(): SidePanelValue;