@dynatrace/strato-components 3.0.1 → 3.1.1

package/esm/layouts/split-layout/SplitLayout.js

@@ -0,0 +1,216 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useGesture } from "@use-gesture/react";
+import { clsx } from "clsx";
+import {
+  createContext,
+  forwardRef,
+  memo,
+  useContext,
+  useRef
+} from "react";
+import {
+  ContentSlot,
+  extractSlotsProps,
+  PanelSlot,
+  ResizeHandleSlot
+} from "./slots.js";
+import * as styles from "./SplitLayout.sty.js";
+import { useSplitSizing } from "./useSplitSizing.js";
+import { useId } from "../../core/hooks/useId.js";
+import { useMergeRefs } from "../../core/hooks/useMergeRefs.js";
+import { useFocusRing } from "../../core/styles/useFocusRing.js";
+const PanelShell = memo(({ children }) => {
+  return children;
+});
+const ContentShell = memo(({ children }) => {
+  return children;
+});
+const ResizeHandleShell = memo(({ children }) => {
+  return children;
+});
+const PanelColumn = forwardRef(
+  (props, forwardedRef) => {
+    const { children, className, style, ...rest } = props;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ...rest,
+        ref: forwardedRef,
+        className: clsx(styles.column, className),
+        style,
+        children
+      }
+    );
+  }
+);
+const ContentColumn = forwardRef(
+  (props, forwardedRef) => {
+    const { children, className, style, ...rest } = props;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ...rest,
+        ref: forwardedRef,
+        className: clsx(styles.column, className),
+        style,
+        children
+      }
+    );
+  }
+);
+const ResizeHandle = forwardRef((props, forwardedRef) => {
+  const { onDrag, onDragStart, onDragEnd, panelId, ariaLabel, ariaLabelledBy } = useContext(ActionsContext);
+  const ref = useRef(null);
+  const mergedRefs = useMergeRefs([ref, forwardedRef]);
+  const { focusProps, focusClassName } = useFocusRing({ focusWithin: true });
+  useGesture(
+    {
+      onDragStart,
+      onDragEnd,
+      onDrag: (state) => {
+        onDrag(state.movement[0]);
+      }
+    },
+    { target: ref }
+  );
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ...props,
+      ...focusProps,
+      role: "separator",
+      ref: mergedRefs,
+      className: clsx(styles.handle, focusClassName),
+      tabIndex: 0,
+      "aria-controls": panelId,
+      "aria-label": ariaLabelledBy ? void 0 : ariaLabel,
+      "aria-labelledby": ariaLabelledBy
+    }
+  );
+});
+const ActionsContext = createContext({
+  onDragStart: () => void 0,
+  onDrag: () => void 0,
+  onDragEnd: () => void 0,
+  panelId: "",
+  ariaLabel: void 0,
+  ariaLabelledBy: void 0
+});
+const SplitLayoutRoot = memo(
+  forwardRef((props, forwardedRef) => {
+    const { children, className: rootClassname, ...rootProps } = props;
+    const slots = extractSlotsProps(children);
+    const rootRef = useRef(null);
+    const rootMergedRef = useMergeRefs([forwardedRef, rootRef]);
+    const generatedPanelId = useId();
+    const panelId = slots.panel.domProps.id ?? generatedPanelId;
+    const panelRef = useRef(null);
+    const contentRef = useRef(null);
+    const panelMergedRef = useMergeRefs([panelRef, slots.panel.ref]);
+    const contentMergedRef = useMergeRefs([contentRef, slots.content?.ref]);
+    const sizing = useSplitSizing({
+      panel: {
+        min: slots.panel.config.minWidth,
+        max: slots.panel.config.maxWidth,
+        default: slots.panel.config.defaultWidth,
+        position: slots.panel.config.position,
+        resizable: slots.panel.config.resizable,
+        onResize: slots.panel.config.onResize
+      },
+      content: {
+        min: slots.content?.config.minWidth ?? 0
+      },
+      refs: {
+        root: rootRef,
+        panel: panelRef,
+        content: contentRef
+      }
+    });
+    const isDefaultPosition = slots.panel.config.position === "start";
+    const activeSizing = isDefaultPosition ? sizing.panel : sizing.content;
+    const panelColumn = /* @__PURE__ */ jsx(
+      PanelColumn,
+      {
+        ...slots.panel.domProps,
+        id: panelId,
+        style: { ...slots.panel.domProps.style, width: sizing.panel.width },
+        ref: panelMergedRef,
+        children: /* @__PURE__ */ jsx(PanelShell, { children: slots.panel.children })
+      }
+    );
+    const contentColumn = slots.content ? /* @__PURE__ */ jsx(
+      ContentColumn,
+      {
+        ...slots.content.domProps,
+        style: {
+          ...slots.content.domProps.style,
+          width: sizing.content.widthCss,
+          // content needs an explicit minWidth when it is the leading column
+          // (end position) to prevent it from collapsing before the resize handle
+          minWidth: isDefaultPosition ? void 0 : slots.content.config.minWidth
+        },
+        ref: contentMergedRef,
+        children: /* @__PURE__ */ jsx(ContentShell, { children: slots.content.children })
+      }
+    ) : null;
+    const resizeHandleDecorations = slots.resizeHandle?.children ? /* @__PURE__ */ jsx("div", { className: styles.handleDecorations, children: /* @__PURE__ */ jsx(ResizeHandleShell, { children: slots.resizeHandle.children }) }) : null;
+    const resizeHandle = slots.panel.config.resizable ? /* @__PURE__ */ jsxs(
+      "div",
+      {
+        ...slots.resizeHandle?.domProps,
+        className: clsx(
+          styles.handleColumn,
+          slots.resizeHandle?.domProps?.className
+        ),
+        ref: slots.resizeHandle?.ref,
+        children: [
+          /* @__PURE__ */ jsx(
+            ResizeHandle,
+            {
+              "aria-valuemin": activeSizing.minPx,
+              "aria-valuemax": isFinite(activeSizing.maxPx) ? activeSizing.maxPx : void 0,
+              "aria-valuenow": activeSizing.width,
+              "aria-valuetext": `${activeSizing.width}px`,
+              "aria-orientation": "vertical"
+            }
+          ),
+          resizeHandleDecorations
+        ]
+      }
+    ) : null;
+    return /* @__PURE__ */ jsx(
+      "div",
+      {
+        ...rootProps,
+        className: clsx(styles.layout, rootClassname),
+        ref: rootMergedRef,
+        children: /* @__PURE__ */ jsxs(
+          ActionsContext.Provider,
+          {
+            value: {
+              ...sizing.dragActions,
+              panelId,
+              ariaLabel: slots.resizeHandle?.domProps["aria-label"] ?? slots.panel.config.label,
+              ariaLabelledBy: slots.resizeHandle?.domProps["aria-labelledby"]
+            },
+            children: [
+              isDefaultPosition ? panelColumn : contentColumn,
+              resizeHandle,
+              isDefaultPosition ? contentColumn : panelColumn
+            ]
+          }
+        )
+      }
+    );
+  })
+);
+SplitLayoutRoot.displayName = "SplitLayout.Root";
+const SplitLayout = Object.assign(SplitLayoutRoot, {
+  Panel: PanelSlot,
+  Content: ContentSlot,
+  ResizeHandle: ResizeHandleSlot
+});
+export {
+  SplitLayout
+};
+//# sourceMappingURL=SplitLayout.js.map

package/esm/layouts/split-layout/SplitLayout.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/layouts/split-layout/SplitLayout.tsx"],
+  "sourcesContent": ["import { useGesture } from '@use-gesture/react';\nimport { clsx } from 'clsx';\nimport {\n  createContext,\n  forwardRef,\n  memo,\n  useContext,\n  useRef,\n  type ComponentPropsWithoutRef,\n  type PropsWithChildren,\n} from 'react';\n\nimport {\n  ContentSlot,\n  extractSlotsProps,\n  PanelSlot,\n  ResizeHandleSlot,\n} from './slots.js';\nimport * as styles from './SplitLayout.sty.js';\nimport { useSplitSizing } from './useSplitSizing.js';\nimport { useId } from '../../core/hooks/useId.js';\nimport { useMergeRefs } from '../../core/hooks/useMergeRefs.js';\nimport { useFocusRing } from '../../core/styles/useFocusRing.js';\n\nexport type { PanelProps, ContentProps, ResizeHandleProps } from './slots.js';\n\n/** shell component for referencial stability - must not use any context or props */\nconst PanelShell = memo(({ children }: PropsWithChildren) => {\n  return children;\n});\n\n/** shell component for referencial stability - must not use any context or props */\nconst ContentShell = memo(({ children }: PropsWithChildren) => {\n  return children;\n});\n\n/** shell component for referencial stability - must not use any context or props */\nconst ResizeHandleShell = memo(({ children }: PropsWithChildren) => {\n  return children;\n});\n\ninterface PanelColumnProps\n  extends PropsWithChildren,\n    ComponentPropsWithoutRef<'div'> {}\n\nconst PanelColumn = forwardRef<HTMLDivElement, PanelColumnProps>(\n  (props, forwardedRef) => {\n    const { children, className, style, ...rest } = props;\n\n    return (\n      <div\n        {...rest}\n        ref={forwardedRef}\n        className={clsx(styles.column, className)}\n        style={style}\n      >\n        {children}\n      </div>\n    );\n  },\n);\n\ninterface ContentColumnProps\n  extends PropsWithChildren,\n    ComponentPropsWithoutRef<'div'> {}\n\nconst ContentColumn = forwardRef<HTMLDivElement, ContentColumnProps>(\n  (props, forwardedRef) => {\n    const { children, className, style, ...rest } = props;\n\n    return (\n      <div\n        {...rest}\n        ref={forwardedRef}\n        className={clsx(styles.column, className)}\n        style={style}\n      >\n        {children}\n      </div>\n    );\n  },\n);\n\nconst ResizeHandle = forwardRef<\n  HTMLDivElement,\n  ComponentPropsWithoutRef<'div'>\n>((props, forwardedRef) => {\n  const { onDrag, onDragStart, onDragEnd, panelId, ariaLabel, ariaLabelledBy } =\n    useContext(ActionsContext);\n  const ref = useRef<HTMLDivElement>(null);\n  const mergedRefs = useMergeRefs([ref, forwardedRef]);\n\n  const { focusProps, focusClassName } = useFocusRing({ focusWithin: true });\n\n  useGesture(\n    {\n      onDragStart,\n      onDragEnd,\n      onDrag: (state) => {\n        onDrag(state.movement[0]);\n      },\n    },\n    { target: ref },\n  );\n\n  return (\n    <div\n      {...props}\n      {...focusProps}\n      role=\"separator\"\n      ref={mergedRefs}\n      className={clsx(styles.handle, focusClassName)}\n      tabIndex={0}\n      aria-controls={panelId}\n      aria-label={ariaLabelledBy ? undefined : ariaLabel}\n      aria-labelledby={ariaLabelledBy}\n    />\n  );\n});\n\nconst ActionsContext = createContext<{\n  onDragStart: () => void;\n  onDrag: (v: number) => void;\n  onDragEnd: () => void;\n  panelId: string;\n  ariaLabel: string | undefined;\n  ariaLabelledBy: string | undefined;\n}>({\n  onDragStart: () => undefined,\n  onDrag: () => undefined,\n  onDragEnd: () => undefined,\n  panelId: '',\n  ariaLabel: undefined,\n  ariaLabelledBy: undefined,\n});\n\n/** @internal */\nexport interface RootProps\n  extends PropsWithChildren,\n    ComponentPropsWithoutRef<'div'> {}\n\nconst SplitLayoutRoot = memo(\n  forwardRef<HTMLDivElement, RootProps>((props, forwardedRef) => {\n    const { children, className: rootClassname, ...rootProps } = props;\n\n    const slots = extractSlotsProps(children);\n\n    const rootRef = useRef<HTMLDivElement>(null);\n    const rootMergedRef = useMergeRefs([forwardedRef, rootRef]);\n\n    const generatedPanelId = useId();\n    const panelId = slots.panel.domProps.id ?? generatedPanelId;\n\n    const panelRef = useRef<HTMLDivElement>(null);\n    const contentRef = useRef<HTMLDivElement>(null);\n    const panelMergedRef = useMergeRefs([panelRef, slots.panel.ref]);\n    const contentMergedRef = useMergeRefs([contentRef, slots.content?.ref]);\n\n    const sizing = useSplitSizing({\n      panel: {\n        min: slots.panel.config.minWidth,\n        max: slots.panel.config.maxWidth,\n        default: slots.panel.config.defaultWidth,\n        position: slots.panel.config.position,\n        resizable: slots.panel.config.resizable,\n        onResize: slots.panel.config.onResize,\n      },\n      content: {\n        min: slots.content?.config.minWidth ?? 0,\n      },\n      refs: {\n        root: rootRef,\n        panel: panelRef,\n        content: contentRef,\n      },\n    });\n\n    const isDefaultPosition = slots.panel.config.position === 'start';\n    const activeSizing = isDefaultPosition ? sizing.panel : sizing.content;\n\n    const panelColumn = (\n      <PanelColumn\n        {...slots.panel.domProps}\n        id={panelId}\n        style={{ ...slots.panel.domProps.style, width: sizing.panel.width }}\n        ref={panelMergedRef}\n      >\n        <PanelShell>{slots.panel.children}</PanelShell>\n      </PanelColumn>\n    );\n\n    const contentColumn = slots.content ? (\n      <ContentColumn\n        {...slots.content.domProps}\n        style={{\n          ...slots.content.domProps.style,\n          width: sizing.content.widthCss,\n          // content needs an explicit minWidth when it is the leading column\n          // (end position) to prevent it from collapsing before the resize handle\n          minWidth: isDefaultPosition\n            ? undefined\n            : slots.content.config.minWidth,\n        }}\n        ref={contentMergedRef}\n      >\n        <ContentShell>{slots.content.children}</ContentShell>\n      </ContentColumn>\n    ) : null;\n\n    const resizeHandleDecorations = slots.resizeHandle?.children ? (\n      <div className={styles.handleDecorations}>\n        <ResizeHandleShell>{slots.resizeHandle.children}</ResizeHandleShell>\n      </div>\n    ) : null;\n\n    const resizeHandle = slots.panel.config.resizable ? (\n      <div\n        {...slots.resizeHandle?.domProps}\n        className={clsx(\n          styles.handleColumn,\n          slots.resizeHandle?.domProps?.className,\n        )}\n        ref={slots.resizeHandle?.ref}\n      >\n        <ResizeHandle\n          aria-valuemin={activeSizing.minPx}\n          aria-valuemax={\n            isFinite(activeSizing.maxPx) ? activeSizing.maxPx : undefined\n          }\n          aria-valuenow={activeSizing.width}\n          aria-valuetext={`${activeSizing.width}px`}\n          aria-orientation=\"vertical\"\n        />\n        {resizeHandleDecorations}\n      </div>\n    ) : null;\n\n    return (\n      <div\n        {...rootProps}\n        className={clsx(styles.layout, rootClassname)}\n        ref={rootMergedRef}\n      >\n        <ActionsContext.Provider\n          value={{\n            ...sizing.dragActions,\n            panelId,\n            ariaLabel:\n              slots.resizeHandle?.domProps['aria-label'] ??\n              slots.panel.config.label,\n            ariaLabelledBy: slots.resizeHandle?.domProps['aria-labelledby'],\n          }}\n        >\n          {isDefaultPosition ? panelColumn : contentColumn}\n          {resizeHandle}\n          {isDefaultPosition ? contentColumn : panelColumn}\n        </ActionsContext.Provider>\n      </div>\n    );\n  }),\n);\nSplitLayoutRoot.displayName = 'SplitLayout.Root';\n\n/**\n * Internal: The accessibility approach to SplitLayout is inspired by the Window Splitter ARIA pattern.\n * While we dont follow it 100%, most aria attributes and intraction should adhere to this pattern.\n * https://www.w3.org/WAI/ARIA/apg/patterns/windowsplitter/\n */\n\n/** @internal */\nexport const SplitLayout = Object.assign(SplitLayoutRoot, {\n  Panel: PanelSlot,\n  Content: ContentSlot,\n  ResizeHandle: ResizeHandleSlot,\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/esm/layouts/split-layout/SplitLayout.sty.js

@@ -0,0 +1,18 @@
+import "./SplitLayout.css";
+var column = "_6q8dk21-3-1-1";
+var contentShellContainer = "_6q8dk23-3-1-1 _6q8dk21-3-1-1";
+var handle = "_6q8dk26-3-1-1";
+var handleColumn = "_6q8dk24-3-1-1 _6q8dk21-3-1-1";
+var handleDecorations = "_6q8dk25-3-1-1";
+var layout = "_6q8dk20-3-1-1";
+var panelShellContainer = "_6q8dk22-3-1-1 _6q8dk21-3-1-1";
+export {
+  column,
+  contentShellContainer,
+  handle,
+  handleColumn,
+  handleDecorations,
+  layout,
+  panelShellContainer
+};
+//# sourceMappingURL=SplitLayout.sty.js.map

package/esm/layouts/split-layout/SplitLayout.sty.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/layouts/split-layout/SplitLayout.css.ts"],
+  "sourcesContent": ["import './SplitLayout.css';\nexport var column = '_6q8dk21-3-1-1';\nexport var contentShellContainer = '_6q8dk23-3-1-1 _6q8dk21-3-1-1';\nexport var handle = '_6q8dk26-3-1-1';\nexport var handleColumn = '_6q8dk24-3-1-1 _6q8dk21-3-1-1';\nexport var handleDecorations = '_6q8dk25-3-1-1';\nexport var layout = '_6q8dk20-3-1-1';\nexport var panelShellContainer = '_6q8dk22-3-1-1 _6q8dk21-3-1-1';"],
+  "mappings": "AAAA,OAAO;AACA,IAAI,SAAS;AACb,IAAI,wBAAwB;AAC5B,IAAI,SAAS;AACb,IAAI,eAAe;AACnB,IAAI,oBAAoB;AACxB,IAAI,SAAS;AACb,IAAI,sBAAsB;",
+  "names": []
+}

package/esm/layouts/split-layout/slots.js

@@ -0,0 +1,97 @@
+import {
+  Children,
+  forwardRef,
+  isValidElement
+} from "react";
+const PanelSlot = forwardRef(
+  (_props, _ref) => null
+);
+const ContentSlot = forwardRef(
+  (_props, _ref) => null
+);
+const ResizeHandleSlot = forwardRef(
+  (_props, _ref) => null
+);
+function isPanelSlot(element) {
+  return element.type === PanelSlot;
+}
+function isContentSlot(element) {
+  return element.type === ContentSlot;
+}
+function isResizeHandleSlot(element) {
+  return element.type === ResizeHandleSlot;
+}
+function extractSlotsProps(children) {
+  let panel = null;
+  let content = null;
+  let resizeHandle = null;
+  Children.forEach(children, (child) => {
+    if (!isValidElement(child)) {
+      return;
+    }
+    if (isPanelSlot(child)) {
+      if (panel) {
+        throw new Error("SplitLayout: only one Panel slot is allowed");
+      }
+      const {
+        minWidth,
+        maxWidth,
+        defaultWidth,
+        position,
+        resizable,
+        children: children2,
+        onResize,
+        label,
+        ...rest
+      } = child.props;
+      panel = {
+        children: children2,
+        config: {
+          minWidth: minWidth ?? 200,
+          maxWidth: maxWidth ?? Infinity,
+          defaultWidth: defaultWidth ?? 200,
+          position: position ?? "start",
+          resizable: resizable ?? true,
+          onResize,
+          label
+        },
+        domProps: rest,
+        ref: "ref" in child ? child.ref : void 0
+      };
+    } else if (isContentSlot(child)) {
+      if (content) {
+        throw new Error("SplitLayout: only one Content slot is allowed");
+      }
+      const { children: children2, minWidth, ...rest } = child.props;
+      content = {
+        children: children2,
+        config: {
+          minWidth: minWidth ?? 250
+        },
+        domProps: rest,
+        ref: "ref" in child ? child.ref : void 0
+      };
+    } else if (isResizeHandleSlot(child)) {
+      if (resizeHandle) {
+        throw new Error("SplitLayout: only one ResizeHandle slot is allowed");
+      }
+      const { children: children2, ...rest } = child.props;
+      resizeHandle = {
+        children: children2,
+        domProps: rest,
+        ref: "ref" in child ? child.ref : void 0
+      };
+    }
+  });
+  if (!panel) {
+    throw new Error("Panel slot is required");
+  }
+  return { panel, content, resizeHandle };
+}
+export {
+  ContentSlot,
+  PanelSlot,
+  ResizeHandleSlot,
+  extractSlotsProps
+};
+//# sourceMappingURL=slots.js.map

package/esm/layouts/split-layout/slots.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/layouts/split-layout/slots.ts"],
+  "sourcesContent": ["import {\n  Children,\n  forwardRef,\n  isValidElement,\n  type ComponentPropsWithoutRef,\n  type PropsWithChildren,\n  type ReactElement,\n  type ReactNode,\n  type Ref,\n} from 'react';\n\nimport { type PanelWidth } from './width-utils.js';\nimport type { MaskingProps } from '../../core/types/masking-props.js';\n\n/** @public */\nexport interface PanelProps\n  extends PropsWithChildren,\n    MaskingProps,\n    ComponentPropsWithoutRef<'div'> {\n  /** The minimum width of the panel. Accepts a pixel value or a percentage string. */\n  minWidth?: PanelWidth;\n  /** The maximum width of the panel. Accepts a pixel value or a percentage string. */\n  maxWidth?: PanelWidth;\n  /** The initial width of the panel. Accepts a pixel value or a percentage string. */\n  defaultWidth?: PanelWidth;\n  /**\n   * Whether the panel width can be resized by dragging.\n   * @defaultValue true\n   */\n  resizable?: boolean;\n  /**\n   * The position of the panel relative to the content.\n   * @defaultValue 'start'\n   */\n  position?: 'start' | 'end';\n  /** Callback triggered when the panel is resized, with the new width in pixels. */\n  onResize?: (width: number) => void;\n  /** Accessible name for the resize separator. Referenced by aria-label on the separator element. */\n  label?: string;\n}\n/** @public */\nexport const PanelSlot = forwardRef<HTMLDivElement, PanelProps>(\n  (_props, _ref) => null,\n);\n\n/** @public */\nexport interface ContentProps\n  extends PropsWithChildren,\n    ComponentPropsWithoutRef<'div'> {\n  /** The minimum width of the content area. Accepts a pixel value or a percentage string. */\n  minWidth?: PanelWidth;\n}\n\nexport const ContentSlot = forwardRef<HTMLDivElement, ContentProps>(\n  (_props, _ref) => null,\n);\n\n/** @internal */\nexport interface ResizeHandleProps\n  extends PropsWithChildren,\n    ComponentPropsWithoutRef<'div'> {}\n/**\n * Optional slot to render custom decorations inside the resize handle area.\n *\n * Note: The resize handle column is fixed to 8px to keep layout stable.\n * Content rendered here does not affect layout width; it may visually overflow.\n *\n * @internal\n */\nexport const ResizeHandleSlot = forwardRef<HTMLDivElement, ResizeHandleProps>(\n  (_props, _ref) => null,\n);\n\nexport interface ExtractedPanelSlot {\n  children?: ReactNode;\n  config: {\n    minWidth: PanelWidth;\n    maxWidth: PanelWidth;\n    defaultWidth: PanelWidth;\n    position: 'start' | 'end';\n    resizable: boolean;\n    onResize?: (width: number) => void;\n    label?: string;\n  };\n  domProps: ComponentPropsWithoutRef<'div'>;\n  ref?: Ref<HTMLDivElement>;\n}\n\nexport interface ExtractedContentSlot {\n  children?: ReactNode;\n  config: {\n    minWidth: PanelWidth;\n  };\n  domProps: ComponentPropsWithoutRef<'div'>;\n  ref?: Ref<HTMLDivElement>;\n}\n\nexport interface ExtractedResizeHandleSlot {\n  children?: ReactNode;\n  domProps: ComponentPropsWithoutRef<'div'>;\n  ref?: Ref<HTMLDivElement>;\n}\n\nfunction isPanelSlot(\n  element: ReactElement,\n): element is ReactElement<PanelProps> {\n  return element.type === PanelSlot;\n}\n\nfunction isContentSlot(\n  element: ReactElement,\n): element is ReactElement<ContentProps> {\n  return element.type === ContentSlot;\n}\n\nfunction isResizeHandleSlot(\n  element: ReactElement,\n): element is ReactElement<ResizeHandleProps> {\n  return element.type === ResizeHandleSlot;\n}\n\n/**\n * Extracts only props and children from the slots, to ensure a stable slot component to render in the root\n */\nexport function extractSlotsProps(children: ReactNode): {\n  panel: ExtractedPanelSlot;\n  content: ExtractedContentSlot | null;\n  resizeHandle: ExtractedResizeHandleSlot | null;\n} {\n  let panel: ExtractedPanelSlot | null = null;\n  let content: ExtractedContentSlot | null = null;\n  let resizeHandle: ExtractedResizeHandleSlot | null = null;\n\n  Children.forEach(children, (child) => {\n    if (!isValidElement(child)) {\n      return;\n    }\n\n    if (isPanelSlot(child)) {\n      if (panel) {\n        throw new Error('SplitLayout: only one Panel slot is allowed');\n      }\n\n      const {\n        minWidth,\n        maxWidth,\n        defaultWidth,\n        position,\n        resizable,\n        children,\n        onResize,\n        label,\n        ...rest\n      } = child.props;\n\n      panel = {\n        children,\n        config: {\n          minWidth: minWidth ?? 200,\n          maxWidth: maxWidth ?? Infinity,\n          defaultWidth: defaultWidth ?? 200,\n          position: position ?? 'start',\n          resizable: resizable ?? true,\n          onResize,\n          label,\n        },\n        domProps: rest,\n        ref: 'ref' in child ? (child.ref as Ref<HTMLDivElement>) : undefined,\n      };\n    } else if (isContentSlot(child)) {\n      if (content) {\n        throw new Error('SplitLayout: only one Content slot is allowed');\n      }\n\n      const { children, minWidth, ...rest } = child.props;\n\n      content = {\n        children,\n        config: {\n          minWidth: minWidth ?? 250,\n        },\n        domProps: rest,\n        ref: 'ref' in child ? (child.ref as Ref<HTMLDivElement>) : undefined,\n      };\n    } else if (isResizeHandleSlot(child)) {\n      if (resizeHandle) {\n        throw new Error('SplitLayout: only one ResizeHandle slot is allowed');\n      }\n\n      const { children, ...rest } = child.props;\n\n      resizeHandle = {\n        children,\n        domProps: rest,\n        ref: 'ref' in child ? (child.ref as Ref<HTMLDivElement>) : undefined,\n      };\n    }\n  });\n\n  if (!panel) {\n    throw new Error('Panel slot is required');\n  }\n\n  return { panel, content, resizeHandle };\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AAgCA,MAAM,YAAY;AAAA,EACvB,CAAC,QAAQ,SAAS;AACpB;AAUO,MAAM,cAAc;AAAA,EACzB,CAAC,QAAQ,SAAS;AACpB;AAcO,MAAM,mBAAmB;AAAA,EAC9B,CAAC,QAAQ,SAAS;AACpB;AAgCA,SAAS,YACP,SACqC;AACrC,SAAO,QAAQ,SAAS;AAC1B;AAEA,SAAS,cACP,SACuC;AACvC,SAAO,QAAQ,SAAS;AAC1B;AAEA,SAAS,mBACP,SAC4C;AAC5C,SAAO,QAAQ,SAAS;AAC1B;AAKO,SAAS,kBAAkB,UAIhC;AACA,MAAI,QAAmC;AACvC,MAAI,UAAuC;AAC3C,MAAI,eAAiD;AAErD,WAAS,QAAQ,UAAU,CAAC,UAAU;AACpC,QAAI,CAAC,eAAe,KAAK,GAAG;AAC1B;AAAA,IACF;AAEA,QAAI,YAAY,KAAK,GAAG;AACtB,UAAI,OAAO;AACT,cAAM,IAAI,MAAM,6CAA6C;AAAA,MAC/D;AAEA,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,UAAAA;AAAA,QACA;AAAA,QACA;AAAA,QACA,GAAG;AAAA,MACL,IAAI,MAAM;AAEV,cAAQ;AAAA,QACN,UAAAA;AAAA,QACA,QAAQ;AAAA,UACN,UAAU,YAAY;AAAA,UACtB,UAAU,YAAY;AAAA,UACtB,cAAc,gBAAgB;AAAA,UAC9B,UAAU,YAAY;AAAA,UACtB,WAAW,aAAa;AAAA,UACxB;AAAA,UACA;AAAA,QACF;AAAA,QACA,UAAU;AAAA,QACV,KAAK,SAAS,QAAS,MAAM,MAA8B;AAAA,MAC7D;AAAA,IACF,WAAW,cAAc,KAAK,GAAG;AAC/B,UAAI,SAAS;AACX,cAAM,IAAI,MAAM,+CAA+C;AAAA,MACjE;AAEA,YAAM,EAAE,UAAAA,WAAU,UAAU,GAAG,KAAK,IAAI,MAAM;AAE9C,gBAAU;AAAA,QACR,UAAAA;AAAA,QACA,QAAQ;AAAA,UACN,UAAU,YAAY;AAAA,QACxB;AAAA,QACA,UAAU;AAAA,QACV,KAAK,SAAS,QAAS,MAAM,MAA8B;AAAA,MAC7D;AAAA,IACF,WAAW,mBAAmB,KAAK,GAAG;AACpC,UAAI,cAAc;AAChB,cAAM,IAAI,MAAM,oDAAoD;AAAA,MACtE;AAEA,YAAM,EAAE,UAAAA,WAAU,GAAG,KAAK,IAAI,MAAM;AAEpC,qBAAe;AAAA,QACb,UAAAA;AAAA,QACA,UAAU;AAAA,QACV,KAAK,SAAS,QAAS,MAAM,MAA8B;AAAA,MAC7D;AAAA,IACF;AAAA,EACF,CAAC;AAED,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AAEA,SAAO,EAAE,OAAO,SAAS,aAAa;AACxC;",
+  "names": ["children"]
+}

package/esm/layouts/split-layout/split-sizing-utils.js

@@ -0,0 +1,45 @@
+import {
+  clamp,
+  resolveWidthPx,
+  toCssLength
+} from "./width-utils.js";
+function clampPanelWidth(split, containerWidth, config) {
+  const { panelMin, panelMax, contentMin, handleWidth } = config;
+  const minPx = resolveWidthPx(panelMin, containerWidth, 0);
+  const maxPx = resolveWidthPx(panelMax, containerWidth, Infinity);
+  const contentMinPx = resolveWidthPx(contentMin, containerWidth, 0);
+  let extrinsicMax = Infinity;
+  if (containerWidth !== 0) {
+    extrinsicMax = containerWidth - contentMinPx - handleWidth;
+  }
+  const finalMax = Math.max(minPx, Math.min(maxPx, extrinsicMax));
+  return clamp(minPx, split, finalMax);
+}
+function computeLayout(splitPx, containerWidth, config) {
+  const { panelMin, panelMax, contentMin, handleWidth } = config;
+  const panelWidth = clampPanelWidth(splitPx, containerWidth, config);
+  const panelMinPx = resolveWidthPx(panelMin, containerWidth, 0);
+  const panelMaxPx = resolveWidthPx(panelMax, containerWidth, Infinity);
+  const contentMinPx = resolveWidthPx(contentMin, containerWidth, 0);
+  const contentMaxPx = Math.max(0, containerWidth - contentMinPx - handleWidth);
+  const contentWidth = clamp(
+    contentMinPx,
+    containerWidth - handleWidth - panelWidth,
+    contentMaxPx
+  );
+  const contentWidthCss = `max(${toCssLength(contentMin)}, 100% - ${panelWidth ? panelWidth + handleWidth : 0}px)`;
+  return {
+    panel: { width: panelWidth, minPx: panelMinPx, maxPx: panelMaxPx },
+    content: {
+      width: contentWidth,
+      widthCss: contentWidthCss,
+      minPx: contentMinPx,
+      maxPx: contentMaxPx
+    }
+  };
+}
+export {
+  clampPanelWidth,
+  computeLayout
+};
+//# sourceMappingURL=split-sizing-utils.js.map

package/esm/layouts/split-layout/split-sizing-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/layouts/split-layout/split-sizing-utils.ts"],
+  "sourcesContent": ["import {\n  clamp,\n  resolveWidthPx,\n  toCssLength,\n  type PanelWidth,\n} from './width-utils.js';\n\ninterface SizingConfig {\n  panelMin: PanelWidth;\n  panelMax: PanelWidth;\n  contentMin: PanelWidth;\n  handleWidth: number;\n}\n\ninterface LayoutValues {\n  panel: { width: number; minPx: number; maxPx: number };\n  content: { width: number; widthCss: string; minPx: number; maxPx: number };\n}\n\n/** @internal */\nexport function clampPanelWidth(\n  split: number,\n  containerWidth: number,\n  config: SizingConfig,\n): number {\n  const { panelMin, panelMax, contentMin, handleWidth } = config;\n\n  const minPx = resolveWidthPx(panelMin, containerWidth, 0);\n  const maxPx = resolveWidthPx(panelMax, containerWidth, Infinity);\n  const contentMinPx = resolveWidthPx(contentMin, containerWidth, 0);\n\n  let extrinsicMax = Infinity;\n  if (containerWidth !== 0) {\n    extrinsicMax = containerWidth - contentMinPx - handleWidth;\n  }\n\n  const finalMax = Math.max(minPx, Math.min(maxPx, extrinsicMax));\n  return clamp(minPx, split, finalMax);\n}\n\n/** @internal */\nexport function computeLayout(\n  splitPx: number,\n  containerWidth: number,\n  config: SizingConfig,\n): LayoutValues {\n  const { panelMin, panelMax, contentMin, handleWidth } = config;\n\n  const panelWidth = clampPanelWidth(splitPx, containerWidth, config);\n\n  const panelMinPx = resolveWidthPx(panelMin, containerWidth, 0);\n  const panelMaxPx = resolveWidthPx(panelMax, containerWidth, Infinity);\n\n  const contentMinPx = resolveWidthPx(contentMin, containerWidth, 0);\n  const contentMaxPx = Math.max(0, containerWidth - contentMinPx - handleWidth);\n  const contentWidth = clamp(\n    contentMinPx,\n    containerWidth - handleWidth - panelWidth,\n    contentMaxPx,\n  );\n\n  const contentWidthCss = `max(${toCssLength(contentMin)}, 100% - ${\n    panelWidth ? panelWidth + handleWidth : 0\n  }px)`;\n\n  return {\n    panel: { width: panelWidth, minPx: panelMinPx, maxPx: panelMaxPx },\n    content: {\n      width: contentWidth,\n      widthCss: contentWidthCss,\n      minPx: contentMinPx,\n      maxPx: contentMaxPx,\n    },\n  };\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAeA,SAAS,gBACd,OACA,gBACA,QACQ;AACR,QAAM,EAAE,UAAU,UAAU,YAAY,YAAY,IAAI;AAExD,QAAM,QAAQ,eAAe,UAAU,gBAAgB,CAAC;AACxD,QAAM,QAAQ,eAAe,UAAU,gBAAgB,QAAQ;AAC/D,QAAM,eAAe,eAAe,YAAY,gBAAgB,CAAC;AAEjE,MAAI,eAAe;AACnB,MAAI,mBAAmB,GAAG;AACxB,mBAAe,iBAAiB,eAAe;AAAA,EACjD;AAEA,QAAM,WAAW,KAAK,IAAI,OAAO,KAAK,IAAI,OAAO,YAAY,CAAC;AAC9D,SAAO,MAAM,OAAO,OAAO,QAAQ;AACrC;AAGO,SAAS,cACd,SACA,gBACA,QACc;AACd,QAAM,EAAE,UAAU,UAAU,YAAY,YAAY,IAAI;AAExD,QAAM,aAAa,gBAAgB,SAAS,gBAAgB,MAAM;AAElE,QAAM,aAAa,eAAe,UAAU,gBAAgB,CAAC;AAC7D,QAAM,aAAa,eAAe,UAAU,gBAAgB,QAAQ;AAEpE,QAAM,eAAe,eAAe,YAAY,gBAAgB,CAAC;AACjE,QAAM,eAAe,KAAK,IAAI,GAAG,iBAAiB,eAAe,WAAW;AAC5E,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,iBAAiB,cAAc;AAAA,IAC/B;AAAA,EACF;AAEA,QAAM,kBAAkB,OAAO,YAAY,UAAU,CAAC,YACpD,aAAa,aAAa,cAAc,CAC1C;AAEA,SAAO;AAAA,IACL,OAAO,EAAE,OAAO,YAAY,OAAO,YAAY,OAAO,WAAW;AAAA,IACjE,SAAS;AAAA,MACP,OAAO;AAAA,MACP,UAAU;AAAA,MACV,OAAO;AAAA,MACP,OAAO;AAAA,IACT;AAAA,EACF;AACF;",
+  "names": []
+}

package/esm/layouts/split-layout/useSplitSizing.js

@@ -0,0 +1,141 @@
+import { throttle } from "lodash-es";
+import {
+  useCallback,
+  useLayoutEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
+import useResizeObserver from "use-resize-observer";
+import { clampPanelWidth, computeLayout } from "./split-sizing-utils.js";
+import { convertToPx, toCssLength } from "./width-utils.js";
+function useSplitSizing(options) {
+  const { panel, content, refs } = options;
+  const [containerWidth, setContainerWidth] = useState(0);
+  const [splitPx, setSplitPx] = useState(() => {
+    if (typeof panel.default === "number") {
+      return panel.default;
+    }
+    return -1;
+  });
+  const splitPxRef = useRef(splitPx);
+  const isDraggingRef = useRef(false);
+  const hasBeenManuallyResizedRef = useRef(false);
+  const dragStartPx = useRef(null);
+  if (!isDraggingRef.current) {
+    splitPxRef.current = splitPx;
+  }
+  const handleWidth = panel.resizable ? 8 : 0;
+  const contentMinCss = toCssLength(content.min);
+  const sizingConfig = useMemo(
+    () => ({
+      panelMin: panel.min,
+      panelMax: panel.max,
+      contentMin: content.min,
+      handleWidth
+    }),
+    [panel.min, panel.max, content.min, handleWidth]
+  );
+  const getClampedSplit = useCallback(
+    (split, container) => clampPanelWidth(split, container, sizingConfig),
+    [sizingConfig]
+  );
+  useLayoutEffect(
+    function initializeSplit() {
+      if (containerWidth === 0) {
+        return;
+      }
+      if (typeof panel.default === "number") {
+        if (splitPx !== -1) {
+          return;
+        }
+        setSplitPx(panel.default);
+        return;
+      }
+      if (hasBeenManuallyResizedRef.current) {
+        return;
+      }
+      setSplitPx(convertToPx(panel.default, containerWidth));
+    },
+    [containerWidth, panel.default, splitPx]
+  );
+  const KEEP_SQUISHED_SIZES = false;
+  const throttledSync = useMemo(
+    () => throttle((width) => {
+      const expected = getClampedSplit(splitPxRef.current, width);
+      if (splitPxRef.current !== expected) {
+        setSplitPx(expected);
+      }
+    }, 100),
+    [getClampedSplit]
+  );
+  useResizeObserver({
+    ref: refs.root,
+    onResize: (size) => {
+      if (!size.width) {
+        return;
+      }
+      setContainerWidth(size.width);
+      if (KEEP_SQUISHED_SIZES) {
+        throttledSync(size.width);
+      }
+    }
+  });
+  const { position: panelPosition, onResize: onPanelResize } = panel;
+  const dragActions = useMemo(
+    () => ({
+      onDragStart: () => {
+        isDraggingRef.current = true;
+        const containerW = refs.root.current?.offsetWidth ?? 0;
+        const clamped = getClampedSplit(splitPxRef.current, containerW);
+        splitPxRef.current = clamped;
+        setSplitPx(clamped);
+        dragStartPx.current = clamped;
+      },
+      onDrag: (mx) => {
+        const containerW = refs.root.current?.offsetWidth ?? 0;
+        if (dragStartPx.current === null || containerW === 0) {
+          return;
+        }
+        const sign = panelPosition === "start" ? 1 : -1;
+        const next = dragStartPx.current + mx * sign;
+        const clamped = getClampedSplit(next, containerW);
+        splitPxRef.current = clamped;
+        if (refs.panel.current) {
+          refs.panel.current.style.width = `${clamped}px`;
+        }
+        if (refs.content.current) {
+          refs.content.current.style.width = `max(${contentMinCss}, 100% - ${clamped + handleWidth}px)`;
+        }
+      },
+      onDragEnd: () => {
+        isDraggingRef.current = false;
+        hasBeenManuallyResizedRef.current = true;
+        dragStartPx.current = null;
+        const rootWidth = refs.root.current?.offsetWidth ?? 0;
+        const clamped = getClampedSplit(splitPxRef.current, rootWidth);
+        splitPxRef.current = clamped;
+        setSplitPx(clamped);
+        onPanelResize?.(clamped);
+      }
+    }),
+    [
+      getClampedSplit,
+      panelPosition,
+      onPanelResize,
+      handleWidth,
+      contentMinCss,
+      refs
+    ]
+  );
+  const layout = computeLayout(splitPx, containerWidth, sizingConfig);
+  return {
+    ...layout,
+    handleWidth,
+    dragActions
+  };
+}
+export {
+  useSplitSizing
+};
+//# sourceMappingURL=useSplitSizing.js.map

package/esm/layouts/split-layout/useSplitSizing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/layouts/split-layout/useSplitSizing.ts"],
+  "sourcesContent": ["import { throttle } from 'lodash-es';\nimport {\n  useCallback,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useState,\n  type RefObject,\n} from 'react';\nimport useResizeObserver from 'use-resize-observer';\n\nimport { clampPanelWidth, computeLayout } from './split-sizing-utils.js';\nimport { convertToPx, toCssLength, type PanelWidth } from './width-utils.js';\n\ninterface UseSplitSizingOptions {\n  panel: {\n    min: PanelWidth;\n    max: PanelWidth;\n    default: PanelWidth;\n    position: 'start' | 'end';\n    resizable: boolean;\n    onResize?: (width: number) => void;\n  };\n  content: {\n    min: PanelWidth;\n  };\n  refs: {\n    root: RefObject<HTMLDivElement>;\n    panel: RefObject<HTMLDivElement>;\n    content: RefObject<HTMLDivElement>;\n  };\n}\n\ninterface SplitSizing {\n  panel: {\n    width: number;\n    minPx: number;\n    maxPx: number;\n  };\n  content: {\n    width: number;\n    widthCss: string;\n    minPx: number;\n    maxPx: number;\n  };\n  handleWidth: number;\n  dragActions: {\n    onDragStart: () => void;\n    onDrag: (mx: number) => void;\n    onDragEnd: () => void;\n  };\n}\n\nexport function useSplitSizing(options: UseSplitSizingOptions): SplitSizing {\n  const { panel, content, refs } = options;\n\n  const [containerWidth, setContainerWidth] = useState(0);\n\n  const [splitPx, setSplitPx] = useState<number>(() => {\n    if (typeof panel.default === 'number') {\n      return panel.default;\n    }\n    return -1;\n  });\n\n  const splitPxRef = useRef(splitPx);\n  const isDraggingRef = useRef(false);\n  const hasBeenManuallyResizedRef = useRef(false);\n  const dragStartPx = useRef<number | null>(null);\n\n  if (!isDraggingRef.current) {\n    splitPxRef.current = splitPx;\n  }\n\n  const handleWidth = panel.resizable ? 8 : 0;\n  const contentMinCss = toCssLength(content.min);\n\n  const sizingConfig = useMemo(\n    () => ({\n      panelMin: panel.min,\n      panelMax: panel.max,\n      contentMin: content.min,\n      handleWidth,\n    }),\n    [panel.min, panel.max, content.min, handleWidth],\n  );\n\n  const getClampedSplit = useCallback(\n    (split: number, container: number) =>\n      clampPanelWidth(split, container, sizingConfig),\n    [sizingConfig],\n  );\n\n  useLayoutEffect(\n    function initializeSplit() {\n      if (containerWidth === 0) {\n        return;\n      }\n      // For a numeric defaultWidth, initialize once and then let the user drive.\n      if (typeof panel.default === 'number') {\n        if (splitPx !== -1) {\n          return;\n        }\n        setSplitPx(panel.default);\n        return;\n      }\n      // For a percentage defaultWidth, re-derive from the container on every\n      // container resize until the user has manually dragged. This ensures that\n      // when the container itself is sized via %, the inner layout still applies\n      // the percentage against the correct, fully-resolved container width.\n      if (hasBeenManuallyResizedRef.current) {\n        return;\n      }\n      setSplitPx(convertToPx(panel.default, containerWidth));\n    },\n    [containerWidth, panel.default, splitPx],\n  );\n\n  const KEEP_SQUISHED_SIZES = false;\n\n  const throttledSync = useMemo(\n    () =>\n      throttle((width: number) => {\n        const expected = getClampedSplit(splitPxRef.current, width);\n        if (splitPxRef.current !== expected) {\n          setSplitPx(expected);\n        }\n      }, 100),\n    [getClampedSplit],\n  );\n\n  useResizeObserver({\n    ref: refs.root,\n    onResize: (size) => {\n      if (!size.width) {\n        return;\n      }\n      setContainerWidth(size.width);\n\n      if (KEEP_SQUISHED_SIZES) {\n        throttledSync(size.width);\n      }\n    },\n  });\n\n  const { position: panelPosition, onResize: onPanelResize } = panel;\n\n  const dragActions = useMemo(\n    () => ({\n      onDragStart: () => {\n        isDraggingRef.current = true;\n        const containerW = refs.root.current?.offsetWidth ?? 0;\n        const clamped = getClampedSplit(splitPxRef.current, containerW);\n        splitPxRef.current = clamped;\n        setSplitPx(clamped);\n        dragStartPx.current = clamped;\n      },\n      onDrag: (mx: number) => {\n        const containerW = refs.root.current?.offsetWidth ?? 0;\n        if (dragStartPx.current === null || containerW === 0) {\n          return;\n        }\n\n        const sign = panelPosition === 'start' ? 1 : -1;\n\n        const next = dragStartPx.current + mx * sign;\n        const clamped = getClampedSplit(next, containerW);\n        splitPxRef.current = clamped;\n\n        if (refs.panel.current) {\n          refs.panel.current.style.width = `${clamped}px`;\n        }\n        if (refs.content.current) {\n          refs.content.current.style.width = `max(${contentMinCss}, 100% - ${\n            clamped + handleWidth\n          }px)`;\n        }\n      },\n      onDragEnd: () => {\n        isDraggingRef.current = false;\n        hasBeenManuallyResizedRef.current = true;\n        dragStartPx.current = null;\n        const rootWidth = refs.root.current?.offsetWidth ?? 0;\n        const clamped = getClampedSplit(splitPxRef.current, rootWidth);\n        splitPxRef.current = clamped;\n        setSplitPx(clamped);\n        onPanelResize?.(clamped);\n      },\n    }),\n    [\n      getClampedSplit,\n      panelPosition,\n      onPanelResize,\n      handleWidth,\n      contentMinCss,\n      refs,\n    ],\n  );\n\n  const layout = computeLayout(splitPx, containerWidth, sizingConfig);\n\n  return {\n    ...layout,\n    handleWidth,\n    dragActions,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/esm/layouts/split-layout/width-utils.js

@@ -0,0 +1,38 @@
+const clamp = (min, value, max) => {
+  return Math.max(min, Math.min(value, max));
+};
+const isPercentage = (value) => {
+  return typeof value === "string" && value.trim().endsWith("%");
+};
+const convertToPx = (value, containerSize) => {
+  if (typeof value === "number") {
+    return value;
+  }
+  const numeric = Number.parseFloat(value);
+  if (!Number.isFinite(numeric)) {
+    throw Error("`value` must be finite");
+  }
+  if (isPercentage(value)) {
+    return numeric / 100 * containerSize;
+  }
+  return numeric;
+};
+const resolveWidthPx = (widthValue, containerWidth, fallback) => {
+  if (containerWidth <= 0) {
+    return fallback;
+  }
+  return convertToPx(widthValue, containerWidth);
+};
+const toCssLength = (value) => {
+  if (typeof value === "number") {
+    return `${value}px`;
+  }
+  return value;
+};
+export {
+  clamp,
+  convertToPx,
+  resolveWidthPx,
+  toCssLength
+};
+//# sourceMappingURL=width-utils.js.map