@salt-ds/core 1.60.0 → 1.62.0

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

@@ -0,0 +1,42 @@
+import { jsx } from 'react/jsx-runtime';
+import { clsx } from 'clsx';
+import { forwardRef } from 'react';
+import { Button } from '../button/Button.js';
+import { useIcon } from '../semantic-icon-provider/SemanticIconProvider.js';
+import { makePrefixer } from '../utils/makePrefixer.js';
+import '../utils/useFloatingUI/useFloatingUI.js';
+import { useId } from '../utils/useId.js';
+import '../salt-provider/SaltProvider.js';
+import '../viewport/ViewportProvider.js';
+import { useSidePanelContext } from './internal/SidePanelContext.js';
+import 'tabbable';
+
+const withBaseName = makePrefixer("saltSidePanelCloseButton");
+const SidePanelCloseButton = forwardRef(
+  function SidePanelCloseButton2({ className, onClick, id: idProp, ...rest }, ref) {
+    const { CollapseLeftIcon, CollapseRightIcon } = useIcon();
+    const { setOpen, titleId, position } = useSidePanelContext();
+    const closeButtonId = useId(idProp);
+    const handleClick = (event) => {
+      onClick == null ? void 0 : onClick(event);
+      setOpen(false);
+    };
+    return /* @__PURE__ */ jsx(
+      Button,
+      {
+        ref,
+        id: closeButtonId,
+        "aria-label": "Close",
+        "aria-labelledby": titleId ? clsx(closeButtonId, titleId) : void 0,
+        appearance: "transparent",
+        className: clsx(withBaseName(), className),
+        onClick: handleClick,
+        ...rest,
+        children: position === "left" ? /* @__PURE__ */ jsx(CollapseLeftIcon, { "aria-hidden": true }) : /* @__PURE__ */ jsx(CollapseRightIcon, { "aria-hidden": true })
+      }
+    );
+  }
+);
+
+export { SidePanelCloseButton };
+//# sourceMappingURL=SidePanelCloseButton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelCloseButton.js","sources":["../src/side-panel/SidePanelCloseButton.tsx"],"sourcesContent":["import { clsx } from \"clsx\";\nimport { forwardRef, type MouseEvent } from \"react\";\nimport { Button, type ButtonProps } from \"../button\";\nimport { useIcon } from \"../semantic-icon-provider\";\nimport { makePrefixer, useId } from \"../utils\";\nimport { useSidePanelContext } from \"./internal\";\n\nconst withBaseName = makePrefixer(\"saltSidePanelCloseButton\");\n\nexport const SidePanelCloseButton = forwardRef<HTMLButtonElement, ButtonProps>(\n  function SidePanelCloseButton(\n    { className, onClick, id: idProp, ...rest },\n    ref,\n  ) {\n    const { CollapseLeftIcon, CollapseRightIcon } = useIcon();\n    const { setOpen, titleId, position } = useSidePanelContext();\n    const closeButtonId = useId(idProp);\n\n    const handleClick = (event: MouseEvent<HTMLButtonElement>) => {\n      onClick?.(event);\n      setOpen(false);\n    };\n\n    return (\n      <Button\n        ref={ref}\n        id={closeButtonId}\n        aria-label=\"Close\"\n        aria-labelledby={titleId ? clsx(closeButtonId, titleId) : undefined}\n        appearance=\"transparent\"\n        className={clsx(withBaseName(), className)}\n        onClick={handleClick}\n        {...rest}\n      >\n        {position === \"left\" ? (\n          <CollapseLeftIcon aria-hidden />\n        ) : (\n          <CollapseRightIcon aria-hidden />\n        )}\n      </Button>\n    );\n  },\n);\n"],"names":["SidePanelCloseButton"],"mappings":";;;;;;;;;;;;;AAOA,MAAM,YAAA,GAAe,aAAa,0BAA0B,CAAA;AAErD,MAAM,oBAAA,GAAuB,UAAA;AAAA,EAClC,SAASA,qBAAAA,CACP,EAAE,SAAA,EAAW,OAAA,EAAS,IAAI,MAAA,EAAQ,GAAG,IAAA,EAAK,EAC1C,GAAA,EACA;AACA,IAAA,MAAM,EAAE,gBAAA,EAAkB,iBAAA,EAAkB,GAAI,OAAA,EAAQ;AACxD,IAAA,MAAM,EAAE,OAAA,EAAS,OAAA,EAAS,QAAA,KAAa,mBAAA,EAAoB;AAC3D,IAAA,MAAM,aAAA,GAAgB,MAAM,MAAM,CAAA;AAElC,IAAA,MAAM,WAAA,GAAc,CAAC,KAAA,KAAyC;AAC5D,MAAA,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAU,KAAA,CAAA;AACV,MAAA,OAAA,CAAQ,KAAK,CAAA;AAAA,IACf,CAAA;AAEA,IAAA,uBACE,GAAA;AAAA,MAAC,MAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,EAAA,EAAI,aAAA;AAAA,QACJ,YAAA,EAAW,OAAA;AAAA,QACX,iBAAA,EAAiB,OAAA,GAAU,IAAA,CAAK,aAAA,EAAe,OAAO,CAAA,GAAI,MAAA;AAAA,QAC1D,UAAA,EAAW,aAAA;AAAA,QACX,SAAA,EAAW,IAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,QACzC,OAAA,EAAS,WAAA;AAAA,QACR,GAAG,IAAA;AAAA,QAEH,QAAA,EAAA,QAAA,KAAa,MAAA,mBACZ,GAAA,CAAC,gBAAA,EAAA,EAAiB,aAAA,EAAW,MAAC,CAAA,mBAE9B,GAAA,CAAC,iBAAA,EAAA,EAAkB,aAAA,EAAW,IAAA,EAAC;AAAA;AAAA,KAEnC;AAAA,EAEJ;AACF;;;;"}

package/dist-es/side-panel/SidePanelContent.css.js

@@ -0,0 +1,4 @@
+var css_248z = ".saltSidePanelContent {\n  display: flex;\n  flex-direction: column;\n  flex: 1;\n  min-height: 0;\n}\n\n.saltSidePanelContent-body {\n  flex: 1;\n  min-height: 0;\n  overflow: auto;\n}\n";
+
+export { css_248z as default };
+//# sourceMappingURL=SidePanelContent.css.js.map

package/dist-es/side-panel/SidePanelContent.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelContent.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

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

@@ -0,0 +1,68 @@
+import { jsxs, jsx } from 'react/jsx-runtime';
+import { useComponentCssInjection } from '@salt-ds/styles';
+import { useWindow } from '@salt-ds/window';
+import { clsx } from 'clsx';
+import { forwardRef, useRef } from 'react';
+import { makePrefixer } from '../utils/makePrefixer.js';
+import '../utils/useFloatingUI/useFloatingUI.js';
+import { useId } from '../utils/useId.js';
+import '../salt-provider/SaltProvider.js';
+import '../viewport/ViewportProvider.js';
+import { useSidePanelContext } from './internal/SidePanelContext.js';
+import { useIsScrollable } from './internal/useIsScrollable.js';
+import 'tabbable';
+import css_248z from './SidePanelContent.css.js';
+
+const withBaseName = makePrefixer("saltSidePanelContent");
+const SidePanelContent = forwardRef(function SidePanelContent2(props, ref) {
+  const {
+    children,
+    className,
+    "aria-labelledby": ariaLabelledBy,
+    "aria-label": ariaLabel,
+    ...rest
+  } = props;
+  const { titleId } = useSidePanelContext();
+  const targetWindow = useWindow();
+  const contentSuffixId = useId();
+  const bodyRef = useRef(null);
+  const isScrollable = useIsScrollable(bodyRef);
+  useComponentCssInjection({
+    testId: "salt-side-panel-content",
+    css: css_248z,
+    window: targetWindow
+  });
+  const explicitLabelledBy = ariaLabelledBy;
+  const explicitLabel = ariaLabel;
+  let bodyAriaLabelledBy;
+  let bodyAriaLabel;
+  if (isScrollable) {
+    if (explicitLabelledBy) {
+      bodyAriaLabelledBy = explicitLabelledBy;
+    } else if (titleId) {
+      bodyAriaLabelledBy = clsx(titleId, contentSuffixId) || void 0;
+    } else {
+      bodyAriaLabel = explicitLabel ?? "Content";
+    }
+  }
+  return /* @__PURE__ */ jsxs("div", { ref, className: clsx(withBaseName(), className), ...rest, children: [
+    isScrollable ? /* @__PURE__ */ jsx("span", { id: contentSuffixId, hidden: true, children: "content" }) : null,
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref: bodyRef,
+        className: withBaseName("body"),
+        ...isScrollable && {
+          role: "region",
+          tabIndex: 0,
+          "aria-labelledby": bodyAriaLabelledBy,
+          "aria-label": bodyAriaLabel
+        },
+        children
+      }
+    )
+  ] });
+});
+
+export { SidePanelContent };
+//# sourceMappingURL=SidePanelContent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelContent.js","sources":["../src/side-panel/SidePanelContent.tsx"],"sourcesContent":["import { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport { type ComponentPropsWithRef, forwardRef, useRef } from \"react\";\nimport { makePrefixer, useId } from \"../utils\";\nimport { useIsScrollable, useSidePanelContext } from \"./internal\";\nimport sidePanelContentCss from \"./SidePanelContent.css\";\n\nconst withBaseName = makePrefixer(\"saltSidePanelContent\");\n\nexport type SidePanelContentProps = ComponentPropsWithRef<\"div\">;\n\nexport const SidePanelContent = forwardRef<\n  HTMLDivElement,\n  SidePanelContentProps\n>(function SidePanelContent(props, ref) {\n  const {\n    children,\n    className,\n    \"aria-labelledby\": ariaLabelledBy,\n    \"aria-label\": ariaLabel,\n    ...rest\n  } = props;\n\n  const { titleId } = useSidePanelContext();\n  const targetWindow = useWindow();\n  const contentSuffixId = useId();\n  const bodyRef = useRef<HTMLDivElement>(null);\n  const isScrollable = useIsScrollable(bodyRef);\n\n  useComponentCssInjection({\n    testId: \"salt-side-panel-content\",\n    css: sidePanelContentCss,\n    window: targetWindow,\n  });\n\n  const explicitLabelledBy = ariaLabelledBy;\n  const explicitLabel = ariaLabel;\n\n  let bodyAriaLabelledBy: string | undefined;\n  let bodyAriaLabel: string | undefined;\n\n  if (isScrollable) {\n    if (explicitLabelledBy) {\n      bodyAriaLabelledBy = explicitLabelledBy;\n    } else if (titleId) {\n      bodyAriaLabelledBy = clsx(titleId, contentSuffixId) || undefined;\n    } else {\n      bodyAriaLabel = explicitLabel ?? \"Content\";\n    }\n  }\n\n  return (\n    <div ref={ref} className={clsx(withBaseName(), className)} {...rest}>\n      {isScrollable ? (\n        <span id={contentSuffixId} hidden>\n          content\n        </span>\n      ) : null}\n      <div\n        ref={bodyRef}\n        className={withBaseName(\"body\")}\n        {...(isScrollable && {\n          role: \"region\",\n          tabIndex: 0,\n          \"aria-labelledby\": bodyAriaLabelledBy,\n          \"aria-label\": bodyAriaLabel,\n        })}\n      >\n        {children}\n      </div>\n    </div>\n  );\n});\n"],"names":["SidePanelContent","sidePanelContentCss"],"mappings":";;;;;;;;;;;;;;;AAQA,MAAM,YAAA,GAAe,aAAa,sBAAsB,CAAA;AAIjD,MAAM,gBAAA,GAAmB,UAAA,CAG9B,SAASA,iBAAAA,CAAiB,OAAO,GAAA,EAAK;AACtC,EAAA,MAAM;AAAA,IACJ,QAAA;AAAA,IACA,SAAA;AAAA,IACA,iBAAA,EAAmB,cAAA;AAAA,IACnB,YAAA,EAAc,SAAA;AAAA,IACd,GAAG;AAAA,GACL,GAAI,KAAA;AAEJ,EAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,mBAAA,EAAoB;AACxC,EAAA,MAAM,eAAe,SAAA,EAAU;AAC/B,EAAA,MAAM,kBAAkB,KAAA,EAAM;AAC9B,EAAA,MAAM,OAAA,GAAU,OAAuB,IAAI,CAAA;AAC3C,EAAA,MAAM,YAAA,GAAe,gBAAgB,OAAO,CAAA;AAE5C,EAAA,wBAAA,CAAyB;AAAA,IACvB,MAAA,EAAQ,yBAAA;AAAA,IACR,GAAA,EAAKC,QAAA;AAAA,IACL,MAAA,EAAQ;AAAA,GACT,CAAA;AAED,EAAA,MAAM,kBAAA,GAAqB,cAAA;AAC3B,EAAA,MAAM,aAAA,GAAgB,SAAA;AAEtB,EAAA,IAAI,kBAAA;AACJ,EAAA,IAAI,aAAA;AAEJ,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,IAAI,kBAAA,EAAoB;AACtB,MAAA,kBAAA,GAAqB,kBAAA;AAAA,IACvB,WAAW,OAAA,EAAS;AAClB,MAAA,kBAAA,GAAqB,IAAA,CAAK,OAAA,EAAS,eAAe,CAAA,IAAK,MAAA;AAAA,IACzD,CAAA,MAAO;AACL,MAAA,aAAA,GAAgB,aAAA,IAAiB,SAAA;AAAA,IACnC;AAAA,EACF;AAEA,EAAA,uBACE,IAAA,CAAC,KAAA,EAAA,EAAI,GAAA,EAAU,SAAA,EAAW,IAAA,CAAK,cAAa,EAAG,SAAS,CAAA,EAAI,GAAG,IAAA,EAC5D,QAAA,EAAA;AAAA,IAAA,YAAA,uBACE,MAAA,EAAA,EAAK,EAAA,EAAI,iBAAiB,MAAA,EAAM,IAAA,EAAC,qBAElC,CAAA,GACE,IAAA;AAAA,oBACJ,GAAA;AAAA,MAAC,KAAA;AAAA,MAAA;AAAA,QACC,GAAA,EAAK,OAAA;AAAA,QACL,SAAA,EAAW,aAAa,MAAM,CAAA;AAAA,QAC7B,GAAI,YAAA,IAAgB;AAAA,UACnB,IAAA,EAAM,QAAA;AAAA,UACN,QAAA,EAAU,CAAA;AAAA,UACV,iBAAA,EAAmB,kBAAA;AAAA,UACnB,YAAA,EAAc;AAAA,SAChB;AAAA,QAEC;AAAA;AAAA;AACH,GAAA,EACF,CAAA;AAEJ,CAAC;;;;"}

package/dist-es/side-panel/SidePanelHeader.css.js

@@ -0,0 +1,4 @@
+var css_248z = ".saltSidePanelHeader {\n  display: flex;\n  align-items: flex-start;\n  flex-shrink: 0;\n  gap: var(--salt-spacing-100);\n  padding: 0 0 var(--salt-spacing-300);\n}\n";
+
+export { css_248z as default };
+//# sourceMappingURL=SidePanelHeader.css.js.map

package/dist-es/side-panel/SidePanelHeader.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelHeader.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

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

@@ -0,0 +1,28 @@
+import { jsx } from 'react/jsx-runtime';
+import { useComponentCssInjection } from '@salt-ds/styles';
+import { useWindow } from '@salt-ds/window';
+import { clsx } from 'clsx';
+import { forwardRef } from 'react';
+import { makePrefixer } from '../utils/makePrefixer.js';
+import '../utils/useFloatingUI/useFloatingUI.js';
+import '../utils/useId.js';
+import '../salt-provider/SaltProvider.js';
+import '../viewport/ViewportProvider.js';
+import css_248z from './SidePanelHeader.css.js';
+
+const withBaseName = makePrefixer("saltSidePanelHeader");
+const SidePanelHeader = forwardRef(
+  function SidePanelHeader2(props, ref) {
+    const { children, className, ...rest } = props;
+    const targetWindow = useWindow();
+    useComponentCssInjection({
+      testId: "salt-side-panel-header",
+      css: css_248z,
+      window: targetWindow
+    });
+    return /* @__PURE__ */ jsx("div", { ref, className: clsx(withBaseName(), className), ...rest, children });
+  }
+);
+
+export { SidePanelHeader };
+//# sourceMappingURL=SidePanelHeader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelHeader.js","sources":["../src/side-panel/SidePanelHeader.tsx"],"sourcesContent":["import { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport { type ComponentPropsWithRef, forwardRef } from \"react\";\nimport { makePrefixer } from \"../utils\";\nimport sidePanelHeaderCss from \"./SidePanelHeader.css\";\n\nconst withBaseName = makePrefixer(\"saltSidePanelHeader\");\n\nexport type SidePanelHeaderProps = ComponentPropsWithRef<\"div\">;\n\nexport const SidePanelHeader = forwardRef<HTMLDivElement, SidePanelHeaderProps>(\n  function SidePanelHeader(props, ref) {\n    const { children, className, ...rest } = props;\n\n    const targetWindow = useWindow();\n\n    useComponentCssInjection({\n      testId: \"salt-side-panel-header\",\n      css: sidePanelHeaderCss,\n      window: targetWindow,\n    });\n\n    return (\n      <div ref={ref} className={clsx(withBaseName(), className)} {...rest}>\n        {children}\n      </div>\n    );\n  },\n);\n"],"names":["SidePanelHeader","sidePanelHeaderCss"],"mappings":";;;;;;;;;;;;AAOA,MAAM,YAAA,GAAe,aAAa,qBAAqB,CAAA;AAIhD,MAAM,eAAA,GAAkB,UAAA;AAAA,EAC7B,SAASA,gBAAAA,CAAgB,KAAA,EAAO,GAAA,EAAK;AACnC,IAAA,MAAM,EAAE,QAAA,EAAU,SAAA,EAAW,GAAG,MAAK,GAAI,KAAA;AAEzC,IAAA,MAAM,eAAe,SAAA,EAAU;AAE/B,IAAA,wBAAA,CAAyB;AAAA,MACvB,MAAA,EAAQ,wBAAA;AAAA,MACR,GAAA,EAAKC,QAAA;AAAA,MACL,MAAA,EAAQ;AAAA,KACT,CAAA;AAED,IAAA,uBACE,GAAA,CAAC,KAAA,EAAA,EAAI,GAAA,EAAU,SAAA,EAAW,IAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA,EAAI,GAAG,IAAA,EAC5D,QAAA,EACH,CAAA;AAAA,EAEJ;AACF;;;;"}

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

@@ -0,0 +1,81 @@
+import { jsx } from 'react/jsx-runtime';
+import { useFloatingRootContext } from '@floating-ui/react';
+import { useCallback, useState, useMemo, useEffect } from 'react';
+import 'clsx';
+import { useControlled } from '../utils/useControlled.js';
+import '../utils/useFloatingUI/useFloatingUI.js';
+import '../utils/useId.js';
+import '../salt-provider/SaltProvider.js';
+import '../viewport/ViewportProvider.js';
+import { SidePanelContext } from './internal/SidePanelContext.js';
+import { useSidePanelTabOrder } from './internal/useSidePanelTabOrder.js';
+
+function SidePanelProvider(props) {
+  const { children, open: openProp, defaultOpen, onOpenChange } = props;
+  const [openState, setOpenState] = useControlled({
+    default: Boolean(defaultOpen),
+    controlled: openProp,
+    name: "SidePanelProvider",
+    state: "open"
+  });
+  const handleOpenChange = useCallback(
+    (newOpen) => {
+      setOpenState(newOpen);
+      onOpenChange == null ? void 0 : onOpenChange(newOpen);
+    },
+    [onOpenChange]
+  );
+  const [reference, setReference] = useState(null);
+  const [floating, setFloating] = useState(null);
+  const [panelId, setPanelId] = useState(void 0);
+  const [titleId, setTitleId] = useState(void 0);
+  const elements = useMemo(
+    () => ({ reference, floating }),
+    [reference, floating]
+  );
+  const floatingRootContext = useFloatingRootContext({
+    open: openState,
+    onOpenChange: handleOpenChange,
+    elements
+  });
+  useEffect(() => {
+    if (!openState || !floating) {
+      return;
+    }
+    const onKeyDown = (event) => {
+      if (event.key !== "Escape") {
+        return;
+      }
+      event.preventDefault();
+      event.stopPropagation();
+      handleOpenChange(false);
+    };
+    floating.addEventListener("keydown", onKeyDown);
+    return () => {
+      floating.removeEventListener("keydown", onKeyDown);
+    };
+  }, [floating, openState, handleOpenChange]);
+  useSidePanelTabOrder({
+    floating,
+    open: openState,
+    reference
+  });
+  const context = useMemo(
+    () => ({
+      openState,
+      floatingRootContext,
+      setFloating,
+      setReference,
+      setOpen: handleOpenChange,
+      panelId,
+      setPanelId,
+      titleId,
+      setTitleId
+    }),
+    [openState, floatingRootContext, handleOpenChange, panelId, titleId]
+  );
+  return /* @__PURE__ */ jsx(SidePanelContext.Provider, { value: context, children });
+}
+
+export { SidePanelProvider };
+//# sourceMappingURL=SidePanelProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelProvider.js","sources":["../src/side-panel/SidePanelProvider.tsx"],"sourcesContent":["import { useFloatingRootContext } from \"@floating-ui/react\";\nimport {\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useState,\n} from \"react\";\nimport { useControlled } from \"../utils\";\nimport { SidePanelContext, useSidePanelTabOrder } from \"./internal\";\n\nexport interface SidePanelProviderProps {\n  /**\n   * Whether the panel is open.\n   */\n  open?: boolean;\n  /**\n   * Default open state when initially rendered.\n   */\n  defaultOpen?: boolean;\n  /**\n   * Callback when open state changes.\n   */\n  onOpenChange?: (open: boolean) => void;\n  /**\n   * SidePanelProvider children, should include SidePanel and SidePanelTrigger.\n   */\n  children: ReactNode;\n}\n\nexport function SidePanelProvider(props: SidePanelProviderProps) {\n  const { children, open: openProp, defaultOpen, onOpenChange } = props;\n\n  const [openState, setOpenState] = useControlled({\n    default: Boolean(defaultOpen),\n    controlled: openProp,\n    name: \"SidePanelProvider\",\n    state: \"open\",\n  });\n\n  const handleOpenChange = useCallback(\n    (newOpen: boolean) => {\n      setOpenState(newOpen);\n      onOpenChange?.(newOpen);\n    },\n    [onOpenChange],\n  );\n\n  const [reference, setReference] = useState<HTMLElement | null>(null);\n  const [floating, setFloating] = useState<HTMLDivElement | null>(null);\n  const [panelId, setPanelId] = useState<string | undefined>(undefined);\n  const [titleId, setTitleId] = useState<string | undefined>(undefined);\n\n  // Memoise so floating-ui's root context isn't recreated every render.\n  const elements = useMemo(\n    () => ({ reference, floating }),\n    [reference, floating],\n  );\n\n  const floatingRootContext = useFloatingRootContext({\n    open: openState,\n    onOpenChange: handleOpenChange,\n    elements,\n  });\n\n  useEffect(() => {\n    if (!openState || !floating) {\n      return;\n    }\n\n    const onKeyDown = (event: KeyboardEvent) => {\n      if (event.key !== \"Escape\") {\n        return;\n      }\n\n      event.preventDefault();\n      event.stopPropagation();\n      handleOpenChange(false);\n    };\n\n    floating.addEventListener(\"keydown\", onKeyDown);\n    return () => {\n      floating.removeEventListener(\"keydown\", onKeyDown);\n    };\n  }, [floating, openState, handleOpenChange]);\n\n  useSidePanelTabOrder({\n    floating,\n    open: openState,\n    reference,\n  });\n\n  const context = useMemo(\n    () => ({\n      openState,\n      floatingRootContext,\n      setFloating,\n      setReference,\n      setOpen: handleOpenChange,\n      panelId,\n      setPanelId,\n      titleId,\n      setTitleId,\n    }),\n    [openState, floatingRootContext, handleOpenChange, panelId, titleId],\n  );\n\n  return (\n    <SidePanelContext.Provider value={context}>\n      {children}\n    </SidePanelContext.Provider>\n  );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AA8BO,SAAS,kBAAkB,KAAA,EAA+B;AAC/D,EAAA,MAAM,EAAE,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,WAAA,EAAa,cAAa,GAAI,KAAA;AAEhE,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAI,aAAA,CAAc;AAAA,IAC9C,OAAA,EAAS,QAAQ,WAAW,CAAA;AAAA,IAC5B,UAAA,EAAY,QAAA;AAAA,IACZ,IAAA,EAAM,mBAAA;AAAA,IACN,KAAA,EAAO;AAAA,GACR,CAAA;AAED,EAAA,MAAM,gBAAA,GAAmB,WAAA;AAAA,IACvB,CAAC,OAAA,KAAqB;AACpB,MAAA,YAAA,CAAa,OAAO,CAAA;AACpB,MAAA,YAAA,IAAA,IAAA,GAAA,MAAA,GAAA,YAAA,CAAe,OAAA,CAAA;AAAA,IACjB,CAAA;AAAA,IACA,CAAC,YAAY;AAAA,GACf;AAEA,EAAA,MAAM,CAAC,SAAA,EAAW,YAAY,CAAA,GAAI,SAA6B,IAAI,CAAA;AACnE,EAAA,MAAM,CAAC,QAAA,EAAU,WAAW,CAAA,GAAI,SAAgC,IAAI,CAAA;AACpE,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAA6B,MAAS,CAAA;AACpE,EAAA,MAAM,CAAC,OAAA,EAAS,UAAU,CAAA,GAAI,SAA6B,MAAS,CAAA;AAGpE,EAAA,MAAM,QAAA,GAAW,OAAA;AAAA,IACf,OAAO,EAAE,SAAA,EAAW,QAAA,EAAS,CAAA;AAAA,IAC7B,CAAC,WAAW,QAAQ;AAAA,GACtB;AAEA,EAAA,MAAM,sBAAsB,sBAAA,CAAuB;AAAA,IACjD,IAAA,EAAM,SAAA;AAAA,IACN,YAAA,EAAc,gBAAA;AAAA,IACd;AAAA,GACD,CAAA;AAED,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,SAAA,IAAa,CAAC,QAAA,EAAU;AAC3B,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,SAAA,GAAY,CAAC,KAAA,KAAyB;AAC1C,MAAA,IAAI,KAAA,CAAM,QAAQ,QAAA,EAAU;AAC1B,QAAA;AAAA,MACF;AAEA,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,KAAA,CAAM,eAAA,EAAgB;AACtB,MAAA,gBAAA,CAAiB,KAAK,CAAA;AAAA,IACxB,CAAA;AAEA,IAAA,QAAA,CAAS,gBAAA,CAAiB,WAAW,SAAS,CAAA;AAC9C,IAAA,OAAO,MAAM;AACX,MAAA,QAAA,CAAS,mBAAA,CAAoB,WAAW,SAAS,CAAA;AAAA,IACnD,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,QAAA,EAAU,SAAA,EAAW,gBAAgB,CAAC,CAAA;AAE1C,EAAA,oBAAA,CAAqB;AAAA,IACnB,QAAA;AAAA,IACA,IAAA,EAAM,SAAA;AAAA,IACN;AAAA,GACD,CAAA;AAED,EAAA,MAAM,OAAA,GAAU,OAAA;AAAA,IACd,OAAO;AAAA,MACL,SAAA;AAAA,MACA,mBAAA;AAAA,MACA,WAAA;AAAA,MACA,YAAA;AAAA,MACA,OAAA,EAAS,gBAAA;AAAA,MACT,OAAA;AAAA,MACA,UAAA;AAAA,MACA,OAAA;AAAA,MACA;AAAA,KACF,CAAA;AAAA,IACA,CAAC,SAAA,EAAW,mBAAA,EAAqB,gBAAA,EAAkB,SAAS,OAAO;AAAA,GACrE;AAEA,EAAA,2BACG,gBAAA,CAAiB,QAAA,EAAjB,EAA0B,KAAA,EAAO,SAC/B,QAAA,EACH,CAAA;AAEJ;;;;"}

package/dist-es/side-panel/SidePanelTitle.css.js

@@ -0,0 +1,4 @@
+var css_248z = ".saltSidePanelTitle {\n  flex: 1;\n  min-width: 0;\n  min-height: var(--salt-size-base);\n  display: flex;\n  align-items: center;\n}\n";
+
+export { css_248z as default };
+//# sourceMappingURL=SidePanelTitle.css.js.map

package/dist-es/side-panel/SidePanelTitle.css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelTitle.css.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

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

@@ -0,0 +1,58 @@
+import { jsx } from 'react/jsx-runtime';
+import { useComponentCssInjection } from '@salt-ds/styles';
+import { useWindow } from '@salt-ds/window';
+import { clsx } from 'clsx';
+import { forwardRef } from 'react';
+import '../text/Code.js';
+import '../text/Display.js';
+import '../text/Headings.js';
+import '../text/Label.js';
+import { Text } from '../text/Text.js';
+import '../text/TextAction.js';
+import '../text/TextNotation.js';
+import { makePrefixer } from '../utils/makePrefixer.js';
+import { useIsomorphicLayoutEffect } from '../utils/useIsomorphicLayoutEffect.js';
+import '../utils/useFloatingUI/useFloatingUI.js';
+import { useId } from '../utils/useId.js';
+import '../salt-provider/SaltProvider.js';
+import '../viewport/ViewportProvider.js';
+import { useSidePanelContext } from './internal/SidePanelContext.js';
+import 'tabbable';
+import css_248z from './SidePanelTitle.css.js';
+
+const withBaseName = makePrefixer("saltSidePanelTitle");
+const SidePanelTitle = forwardRef(
+  function SidePanelTitle2(props, ref) {
+    const { children, className, id, styleAs = "h2", ...rest } = props;
+    const { setTitleId } = useSidePanelContext();
+    const targetWindow = useWindow();
+    useComponentCssInjection({
+      testId: "salt-side-panel-title",
+      css: css_248z,
+      window: targetWindow
+    });
+    const titleId = useId(id);
+    useIsomorphicLayoutEffect(() => {
+      if (titleId) {
+        setTitleId(titleId);
+      }
+      return () => {
+        setTitleId(void 0);
+      };
+    }, [titleId, setTitleId]);
+    return /* @__PURE__ */ jsx(
+      Text,
+      {
+        ref,
+        id: titleId,
+        styleAs,
+        className: clsx(withBaseName(), className),
+        ...rest,
+        children
+      }
+    );
+  }
+);
+
+export { SidePanelTitle };
+//# sourceMappingURL=SidePanelTitle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelTitle.js","sources":["../src/side-panel/SidePanelTitle.tsx"],"sourcesContent":["import { useComponentCssInjection } from \"@salt-ds/styles\";\nimport { useWindow } from \"@salt-ds/window\";\nimport { clsx } from \"clsx\";\nimport { forwardRef } from \"react\";\nimport { Text, type TextProps } from \"../text\";\nimport { makePrefixer, useId, useIsomorphicLayoutEffect } from \"../utils\";\nimport { useSidePanelContext } from \"./internal\";\nimport sidePanelTitleCss from \"./SidePanelTitle.css\";\n\nconst withBaseName = makePrefixer(\"saltSidePanelTitle\");\n\nexport type SidePanelTitleProps = TextProps<\"div\">;\n\nexport const SidePanelTitle = forwardRef<HTMLDivElement, SidePanelTitleProps>(\n  function SidePanelTitle(props, ref) {\n    const { children, className, id, styleAs = \"h2\", ...rest } = props;\n\n    const { setTitleId } = useSidePanelContext();\n    const targetWindow = useWindow();\n\n    useComponentCssInjection({\n      testId: \"salt-side-panel-title\",\n      css: sidePanelTitleCss,\n      window: targetWindow,\n    });\n\n    const titleId = useId(id);\n\n    useIsomorphicLayoutEffect(() => {\n      if (titleId) {\n        setTitleId(titleId);\n      }\n\n      return () => {\n        setTitleId(undefined);\n      };\n    }, [titleId, setTitleId]);\n\n    return (\n      <Text\n        ref={ref}\n        id={titleId}\n        styleAs={styleAs}\n        className={clsx(withBaseName(), className)}\n        {...rest}\n      >\n        {children}\n      </Text>\n    );\n  },\n);\n"],"names":["SidePanelTitle","sidePanelTitleCss"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AASA,MAAM,YAAA,GAAe,aAAa,oBAAoB,CAAA;AAI/C,MAAM,cAAA,GAAiB,UAAA;AAAA,EAC5B,SAASA,eAAAA,CAAe,KAAA,EAAO,GAAA,EAAK;AAClC,IAAA,MAAM,EAAE,UAAU,SAAA,EAAW,EAAA,EAAI,UAAU,IAAA,EAAM,GAAG,MAAK,GAAI,KAAA;AAE7D,IAAA,MAAM,EAAE,UAAA,EAAW,GAAI,mBAAA,EAAoB;AAC3C,IAAA,MAAM,eAAe,SAAA,EAAU;AAE/B,IAAA,wBAAA,CAAyB;AAAA,MACvB,MAAA,EAAQ,uBAAA;AAAA,MACR,GAAA,EAAKC,QAAA;AAAA,MACL,MAAA,EAAQ;AAAA,KACT,CAAA;AAED,IAAA,MAAM,OAAA,GAAU,MAAM,EAAE,CAAA;AAExB,IAAA,yBAAA,CAA0B,MAAM;AAC9B,MAAA,IAAI,OAAA,EAAS;AACX,QAAA,UAAA,CAAW,OAAO,CAAA;AAAA,MACpB;AAEA,MAAA,OAAO,MAAM;AACX,QAAA,UAAA,CAAW,MAAS,CAAA;AAAA,MACtB,CAAA;AAAA,IACF,CAAA,EAAG,CAAC,OAAA,EAAS,UAAU,CAAC,CAAA;AAExB,IAAA,uBACE,GAAA;AAAA,MAAC,IAAA;AAAA,MAAA;AAAA,QACC,GAAA;AAAA,QACA,EAAA,EAAI,OAAA;AAAA,QACJ,OAAA;AAAA,QACA,SAAA,EAAW,IAAA,CAAK,YAAA,EAAa,EAAG,SAAS,CAAA;AAAA,QACxC,GAAG,IAAA;AAAA,QAEH;AAAA;AAAA,KACH;AAAA,EAEJ;AACF;;;;"}

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

@@ -0,0 +1,41 @@
+import { jsx, Fragment } from 'react/jsx-runtime';
+import { forwardRef, isValidElement, cloneElement } from 'react';
+import { getRefFromChildren } from '../utils/getRefFromChildren.js';
+import { mergeProps } from '../utils/mergeProps.js';
+import '../utils/useFloatingUI/useFloatingUI.js';
+import { useForkRef } from '../utils/useForkRef.js';
+import '../utils/useId.js';
+import '../salt-provider/SaltProvider.js';
+import '../viewport/ViewportProvider.js';
+import { useSidePanelContext } from './internal/SidePanelContext.js';
+import 'tabbable';
+
+const SidePanelTrigger = forwardRef(function SidePanelTrigger2(props, ref) {
+  const { children, onClick, ...rest } = props;
+  const { setReference, openState, setOpen, panelId } = useSidePanelContext();
+  const combinedRef = useForkRef(setReference, ref);
+  const handleRef = useForkRef(combinedRef, getRefFromChildren(children));
+  const handleClick = (event) => {
+    onClick == null ? void 0 : onClick(event);
+    setOpen(!openState);
+  };
+  if (!children || !isValidElement(children)) {
+    return /* @__PURE__ */ jsx(Fragment, { children });
+  }
+  const mergedProps = mergeProps(
+    {
+      "aria-expanded": openState,
+      "aria-controls": openState ? panelId : void 0,
+      onClick: handleClick,
+      ...rest
+    },
+    children.props
+  );
+  return cloneElement(children, {
+    ...mergedProps,
+    ref: handleRef
+  });
+});
+
+export { SidePanelTrigger };
+//# sourceMappingURL=SidePanelTrigger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelTrigger.js","sources":["../src/side-panel/SidePanelTrigger.tsx"],"sourcesContent":["import {\n  type ComponentPropsWithoutRef,\n  cloneElement,\n  forwardRef,\n  isValidElement,\n  type MouseEvent,\n} from \"react\";\nimport { getRefFromChildren, mergeProps, useForkRef } from \"../utils\";\nimport { useSidePanelContext } from \"./internal\";\n\nexport type SidePanelTriggerProps = ComponentPropsWithoutRef<\"button\">;\n\nexport const SidePanelTrigger = forwardRef<\n  HTMLButtonElement,\n  SidePanelTriggerProps\n>(function SidePanelTrigger(props, ref) {\n  const { children, onClick, ...rest } = props;\n  const { setReference, openState, setOpen, panelId } = useSidePanelContext();\n\n  const combinedRef = useForkRef(setReference, ref);\n  const handleRef = useForkRef(combinedRef, getRefFromChildren(children));\n\n  const handleClick = (event: MouseEvent<HTMLButtonElement>) => {\n    onClick?.(event);\n    setOpen(!openState);\n  };\n\n  if (!children || !isValidElement(children)) {\n    return <>{children}</>;\n  }\n\n  const mergedProps = mergeProps(\n    {\n      \"aria-expanded\": openState,\n      \"aria-controls\": openState ? panelId : undefined,\n      onClick: handleClick,\n      ...rest,\n    },\n    children.props,\n  );\n\n  return cloneElement(children, {\n    ...mergedProps,\n    ref: handleRef,\n  });\n});\n"],"names":["SidePanelTrigger"],"mappings":";;;;;;;;;;;;AAYO,MAAM,gBAAA,GAAmB,UAAA,CAG9B,SAASA,iBAAAA,CAAiB,OAAO,GAAA,EAAK;AACtC,EAAA,MAAM,EAAE,QAAA,EAAU,OAAA,EAAS,GAAG,MAAK,GAAI,KAAA;AACvC,EAAA,MAAM,EAAE,YAAA,EAAc,SAAA,EAAW,OAAA,EAAS,OAAA,KAAY,mBAAA,EAAoB;AAE1E,EAAA,MAAM,WAAA,GAAc,UAAA,CAAW,YAAA,EAAc,GAAG,CAAA;AAChD,EAAA,MAAM,SAAA,GAAY,UAAA,CAAW,WAAA,EAAa,kBAAA,CAAmB,QAAQ,CAAC,CAAA;AAEtE,EAAA,MAAM,WAAA,GAAc,CAAC,KAAA,KAAyC;AAC5D,IAAA,OAAA,IAAA,IAAA,GAAA,MAAA,GAAA,OAAA,CAAU,KAAA,CAAA;AACV,IAAA,OAAA,CAAQ,CAAC,SAAS,CAAA;AAAA,EACpB,CAAA;AAEA,EAAA,IAAI,CAAC,QAAA,IAAY,CAAC,cAAA,CAAe,QAAQ,CAAA,EAAG;AAC1C,IAAA,uCAAU,QAAA,EAAS,CAAA;AAAA,EACrB;AAEA,EAAA,MAAM,WAAA,GAAc,UAAA;AAAA,IAClB;AAAA,MACE,eAAA,EAAiB,SAAA;AAAA,MACjB,eAAA,EAAiB,YAAY,OAAA,GAAU,MAAA;AAAA,MACvC,OAAA,EAAS,WAAA;AAAA,MACT,GAAG;AAAA,KACL;AAAA,IACA,QAAA,CAAS;AAAA,GACX;AAEA,EAAA,OAAO,aAAa,QAAA,EAAU;AAAA,IAC5B,GAAG,WAAA;AAAA,IACH,GAAA,EAAK;AAAA,GACN,CAAA;AACH,CAAC;;;;"}

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

@@ -0,0 +1,35 @@
+import { useContext } from 'react';
+import { createContext } from '../../utils/createContext.js';
+import 'clsx';
+import 'react/jsx-runtime';
+import '../../utils/useFloatingUI/useFloatingUI.js';
+import '../../utils/useId.js';
+import '../../salt-provider/SaltProvider.js';
+import '../../viewport/ViewportProvider.js';
+
+const SidePanelContext = createContext(
+  "SidePanelContext",
+  {
+    openState: false,
+    floatingRootContext: {},
+    setFloating: () => {
+    },
+    setReference: () => {
+    },
+    setOpen: () => {
+    },
+    panelId: void 0,
+    setPanelId: () => {
+    },
+    titleId: void 0,
+    setTitleId: () => {
+    },
+    position: void 0
+  }
+);
+function useSidePanelContext() {
+  return useContext(SidePanelContext);
+}
+
+export { SidePanelContext, useSidePanelContext };
+//# sourceMappingURL=SidePanelContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SidePanelContext.js","sources":["../src/side-panel/internal/SidePanelContext.ts"],"sourcesContent":["import type { FloatingRootContext } from \"@floating-ui/react\";\nimport { type Dispatch, type SetStateAction, useContext } from \"react\";\nimport { createContext } from \"../../utils\";\n\nexport interface SidePanelContextValue {\n  /**\n   * Whether the side panel is currently open.\n   */\n  openState: boolean;\n  /**\n   * The floating-ui root context shared between the trigger and the panel.\n   * Coordinates interactions (click, dismiss, role) across both elements.\n   */\n  floatingRootContext: FloatingRootContext;\n  /**\n   * Ref setter for the panel element.\n   * Registers the panel DOM node with floating-ui.\n   */\n  setFloating: Dispatch<SetStateAction<HTMLDivElement | null>>;\n  /**\n   * Ref setter for the reference (trigger) element.\n   * Registers the trigger DOM node with floating-ui for focus return.\n   */\n  setReference: Dispatch<SetStateAction<HTMLElement | null>>;\n  /**\n   * Sets the open state of the panel.\n   * Called by the close button in SidePanelHeader, or any consumer that needs to close the panel.\n   */\n  setOpen: (open: boolean) => void;\n  /**\n   * Side panel id used for aria-controls on the trigger.\n   */\n  panelId?: string;\n  /**\n   * Registers or clears the side panel id used for aria-controls/id linkage.\n   */\n  setPanelId: Dispatch<SetStateAction<string | undefined>>;\n  /**\n   * The auto-generated id placed on SidePanelTitle.\n   * Used for aria-labelledby on the panel region and the scrollable body.\n   */\n  titleId?: string;\n  /**\n   * Registers the title id from SidePanelTitle back to the context\n   * so that SidePanel and SidePanelContent can use it for aria-labelledby.\n   */\n  setTitleId: Dispatch<SetStateAction<string | undefined>>;\n  /**\n   * Edge the panel is anchored to. Set by SidePanel for its own subtree.\n   */\n  position?: \"right\" | \"left\";\n}\n\nexport const SidePanelContext = createContext<SidePanelContextValue>(\n  \"SidePanelContext\",\n  {\n    openState: false,\n    floatingRootContext: {} as FloatingRootContext,\n    setFloating: () => {},\n    setReference: () => {},\n    setOpen: () => {},\n    panelId: undefined,\n    setPanelId: () => {},\n    titleId: undefined,\n    setTitleId: () => {},\n    position: undefined,\n  },\n);\n\nexport function useSidePanelContext() {\n  return useContext(SidePanelContext);\n}\n"],"names":[],"mappings":";;;;;;;;;AAqDO,MAAM,gBAAA,GAAmB,aAAA;AAAA,EAC9B,kBAAA;AAAA,EACA;AAAA,IACE,SAAA,EAAW,KAAA;AAAA,IACX,qBAAqB,EAAC;AAAA,IACtB,aAAa,MAAM;AAAA,IAAC,CAAA;AAAA,IACpB,cAAc,MAAM;AAAA,IAAC,CAAA;AAAA,IACrB,SAAS,MAAM;AAAA,IAAC,CAAA;AAAA,IAChB,OAAA,EAAS,MAAA;AAAA,IACT,YAAY,MAAM;AAAA,IAAC,CAAA;AAAA,IACnB,OAAA,EAAS,MAAA;AAAA,IACT,YAAY,MAAM;AAAA,IAAC,CAAA;AAAA,IACnB,QAAA,EAAU;AAAA;AAEd;AAEO,SAAS,mBAAA,GAAsB;AACpC,EAAA,OAAO,WAAW,gBAAgB,CAAA;AACpC;;;;"}

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

@@ -0,0 +1,48 @@
+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

@@ -0,0 +1 @@
+{"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;;;;"}