react-resizable-panels 0.0.53 → 0.0.55

package/dist/react-resizable-panels.development.esm.js

@@ -1,5 +1,7 @@
 import * as React from 'react';
 
+const isBrowser = typeof window !== "undefined";
+
 // This module exists to work around Webpack issue https://github.com/webpack/webpack/issues/14814
 
 // eslint-disable-next-line no-restricted-imports
@@ -21,8 +23,7 @@ const {
 // `toString()` prevents bundlers from trying to `import { useId } from 'react'`
 const useId = React["useId".toString()];
 
-const canUseEffectHooks = !!(typeof window !== "undefined" && typeof window.document !== "undefined" && typeof window.document.createElement !== "undefined");
-const useIsomorphicLayoutEffect = canUseEffectHooks ? useLayoutEffect : () => {};
+const useIsomorphicLayoutEffect = isBrowser ? useLayoutEffect : () => {};
 
 const wrappedUseId = typeof useId === "function" ? useId : () => null;
 let counter = 0;
@@ -36,10 +37,6 @@ function useUniqueId(idFromParams = null) {
 }
 
 const PanelGroupContext = createContext(null);
-
-// Workaround for Parcel scope hoisting (which renames objects/functions).
-// Casting to :any is required to avoid corrupting the generated TypeScript types.
-// See github.com/parcel-bundler/parcel/issues/8724
 PanelGroupContext.displayName = "PanelGroupContext";
 
 function PanelWithForwardedRef({
@@ -50,8 +47,8 @@ function PanelWithForwardedRef({
   defaultSize = null,
   forwardedRef,
   id: idFromProps = null,
-  maxSize = 100,
-  minSize = 10,
+  maxSize = null,
+  minSize,
   onCollapse = null,
   onResize = null,
   order = null,
@@ -66,11 +63,22 @@ function PanelWithForwardedRef({
   const {
     collapsePanel,
     expandPanel,
+    getPanelSize,
     getPanelStyle,
     registerPanel,
     resizePanel,
+    units,
     unregisterPanel
   } = context;
+  if (minSize == null) {
+    if (units === "percentages") {
+      // Mimics legacy default value for percentage based panel groups
+      minSize = 10;
+    } else {
+      // There is no meaningful minimum pixel default we can provide
+      minSize = 0;
+    }
+  }
 
   // Use a ref to guard against users passing inline props
   const callbacksRef = useRef({
@@ -81,22 +89,6 @@ function PanelWithForwardedRef({
     callbacksRef.current.onCollapse = onCollapse;
     callbacksRef.current.onResize = onResize;
   });
-
-  // Basic props validation
-  if (minSize < 0 || minSize > 100) {
-    throw Error(`Panel minSize must be between 0 and 100, but was ${minSize}`);
-  } else if (maxSize < 0 || maxSize > 100) {
-    throw Error(`Panel maxSize must be between 0 and 100, but was ${maxSize}`);
-  } else {
-    if (defaultSize !== null) {
-      if (defaultSize < 0 || defaultSize > 100) {
-        throw Error(`Panel defaultSize must be between 0 and 100, but was ${defaultSize}`);
-      } else if (minSize > defaultSize && !collapsible) {
-        console.error(`Panel minSize ${minSize} cannot be greater than defaultSize ${defaultSize}`);
-        defaultSize = minSize;
-      }
-    }
-  }
   const style = getPanelStyle(panelId, defaultSize);
   const committedValuesRef = useRef({
     size: parseSizeFromStyle(style)
@@ -107,6 +99,7 @@ function PanelWithForwardedRef({
     collapsible,
     defaultSize,
     id: panelId,
+    idWasAutoGenerated: idFromProps == null,
     maxSize,
     minSize,
     order
@@ -118,6 +111,7 @@ function PanelWithForwardedRef({
     panelDataRef.current.collapsible = collapsible;
     panelDataRef.current.defaultSize = defaultSize;
     panelDataRef.current.id = panelId;
+    panelDataRef.current.idWasAutoGenerated = idFromProps == null;
     panelDataRef.current.maxSize = maxSize;
     panelDataRef.current.minSize = minSize;
     panelDataRef.current.order = order;
@@ -134,11 +128,14 @@ function PanelWithForwardedRef({
     getCollapsed() {
       return committedValuesRef.current.size === 0;
     },
-    getSize() {
-      return committedValuesRef.current.size;
+    getId() {
+      return panelId;
     },
-    resize: percentage => resizePanel(panelId, percentage)
-  }), [collapsePanel, expandPanel, panelId, resizePanel]);
+    getSize(units) {
+      return getPanelSize(panelId, units);
+    },
+    resize: (percentage, units) => resizePanel(panelId, percentage, units)
+  }), [collapsePanel, expandPanel, getPanelSize, panelId, resizePanel]);
   return createElement(Type, {
     children,
     className: classNameFromProps,
@@ -157,10 +154,6 @@ const Panel = forwardRef((props, ref) => createElement(PanelWithForwardedRef, {
   ...props,
   forwardedRef: ref
 }));
-
-// Workaround for Parcel scope hoisting (which renames objects/functions).
-// Casting to :any is required to avoid corrupting the generated TypeScript types.
-// See github.com/parcel-bundler/parcel/issues/8724
 PanelWithForwardedRef.displayName = "Panel";
 Panel.displayName = "forwardRef(Panel)";
 
@@ -178,7 +171,13 @@ function parseSizeFromStyle(style) {
 
 const PRECISION = 10;
 
-function adjustByDelta(event, panels, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse, initialDragState) {
+function adjustByDelta(event, committedValues, idBefore, idAfter, deltaPixels, prevSizes, panelSizeBeforeCollapse, initialDragState) {
+  const {
+    id: groupId,
+    panels,
+    units
+  } = committedValues;
+  const groupSizePixels = units === "pixels" ? getAvailableGroupSizePixels(groupId) : NaN;
   const {
     sizes: initialSizes
   } = initialDragState || {};
@@ -186,9 +185,6 @@ function adjustByDelta(event, panels, idBefore, idAfter, delta, prevSizes, panel
   // If we're resizing by mouse or touch, use the initial sizes as a base.
   // This has the benefit of causing force-collapsed panels to spring back open if drag is reversed.
   const baseSizes = initialSizes || prevSizes;
-  if (delta === 0) {
-    return baseSizes;
-  }
   const panelsArray = panelsMapToSortedArray(panels);
   const nextSizes = baseSizes.concat();
   let deltaApplied = 0;
@@ -203,11 +199,11 @@ function adjustByDelta(event, panels, idBefore, idAfter, delta, prevSizes, panel
 
   // Max-bounds check the panel being expanded first.
   {
-    const pivotId = delta < 0 ? idAfter : idBefore;
+    const pivotId = deltaPixels < 0 ? idAfter : idBefore;
     const index = panelsArray.findIndex(panel => panel.current.id === pivotId);
     const panel = panelsArray[index];
     const baseSize = baseSizes[index];
-    const nextSize = safeResizePanel(panel, Math.abs(delta), baseSize, event);
+    const nextSize = safeResizePanel(units, groupSizePixels, panel, baseSize, baseSize + Math.abs(deltaPixels), event);
     if (baseSize === nextSize) {
       // If there's no room for the pivot panel to grow, we can ignore this drag update.
       return baseSizes;
@@ -215,29 +211,29 @@ function adjustByDelta(event, panels, idBefore, idAfter, delta, prevSizes, panel
       if (nextSize === 0 && baseSize > 0) {
         panelSizeBeforeCollapse.set(pivotId, baseSize);
       }
-      delta = delta < 0 ? baseSize - nextSize : nextSize - baseSize;
+      deltaPixels = deltaPixels < 0 ? baseSize - nextSize : nextSize - baseSize;
     }
   }
-  let pivotId = delta < 0 ? idBefore : idAfter;
+  let pivotId = deltaPixels < 0 ? idBefore : idAfter;
   let index = panelsArray.findIndex(panel => panel.current.id === pivotId);
   while (true) {
     const panel = panelsArray[index];
     const baseSize = baseSizes[index];
-    const deltaRemaining = Math.abs(delta) - Math.abs(deltaApplied);
-    const nextSize = safeResizePanel(panel, 0 - deltaRemaining, baseSize, event);
+    const deltaRemaining = Math.abs(deltaPixels) - Math.abs(deltaApplied);
+    const nextSize = safeResizePanel(units, groupSizePixels, panel, baseSize, baseSize - deltaRemaining, event);
     if (baseSize !== nextSize) {
       if (nextSize === 0 && baseSize > 0) {
         panelSizeBeforeCollapse.set(panel.current.id, baseSize);
       }
       deltaApplied += baseSize - nextSize;
       nextSizes[index] = nextSize;
-      if (deltaApplied.toPrecision(PRECISION).localeCompare(Math.abs(delta).toPrecision(PRECISION), undefined, {
+      if (deltaApplied.toPrecision(PRECISION).localeCompare(Math.abs(deltaPixels).toPrecision(PRECISION), undefined, {
         numeric: true
       }) >= 0) {
         break;
       }
     }
-    if (delta < 0) {
+    if (deltaPixels < 0) {
       if (--index < 0) {
         break;
       }
@@ -255,7 +251,7 @@ function adjustByDelta(event, panels, idBefore, idAfter, delta, prevSizes, panel
   }
 
   // Adjust the pivot panel before, but only by the amount that surrounding panels were able to shrink/contract.
-  pivotId = delta < 0 ? idAfter : idBefore;
+  pivotId = deltaPixels < 0 ? idAfter : idBefore;
   index = panelsArray.findIndex(panel => panel.current.id === pivotId);
   nextSizes[index] = baseSizes[index] + deltaApplied;
   return nextSizes;
@@ -294,6 +290,93 @@ function callPanelCallbacks(panelsArray, sizes, panelIdToLastNotifiedSizeMap) {
     }
   });
 }
+function calculateDefaultLayout({
+  groupId,
+  panels,
+  units
+}) {
+  const groupSizePixels = units === "pixels" ? getAvailableGroupSizePixels(groupId) : NaN;
+  const panelsArray = panelsMapToSortedArray(panels);
+  const sizes = Array(panelsArray.length);
+  let numPanelsWithSizes = 0;
+  let remainingSize = 100;
+
+  // Assigning default sizes requires a couple of passes:
+  // First, all panels with defaultSize should be set as-is
+  for (let index = 0; index < panelsArray.length; index++) {
+    const panel = panelsArray[index];
+    const {
+      defaultSize
+    } = panel.current;
+    if (defaultSize != null) {
+      numPanelsWithSizes++;
+      sizes[index] = units === "pixels" ? defaultSize / groupSizePixels * 100 : defaultSize;
+      remainingSize -= sizes[index];
+    }
+  }
+
+  // Remaining total size should be distributed evenly between panels
+  // This may require two passes, depending on min/max constraints
+  for (let index = 0; index < panelsArray.length; index++) {
+    const panel = panelsArray[index];
+    let {
+      defaultSize,
+      id,
+      maxSize,
+      minSize
+    } = panel.current;
+    if (defaultSize != null) {
+      continue;
+    }
+    if (units === "pixels") {
+      minSize = minSize / groupSizePixels * 100;
+      if (maxSize != null) {
+        maxSize = maxSize / groupSizePixels * 100;
+      }
+    }
+    const remainingPanels = panelsArray.length - numPanelsWithSizes;
+    const size = Math.min(maxSize != null ? maxSize : 100, Math.max(minSize, remainingSize / remainingPanels));
+    sizes[index] = size;
+    numPanelsWithSizes++;
+    remainingSize -= size;
+  }
+
+  // If there is additional, left over space, assign it to any panel(s) that permits it
+  // (It's not worth taking multiple additional passes to evenly distribute)
+  if (remainingSize !== 0) {
+    for (let index = 0; index < panelsArray.length; index++) {
+      const panel = panelsArray[index];
+      let {
+        maxSize,
+        minSize
+      } = panel.current;
+      if (units === "pixels") {
+        minSize = minSize / groupSizePixels * 100;
+        if (maxSize != null) {
+          maxSize = maxSize / groupSizePixels * 100;
+        }
+      }
+      const size = Math.min(maxSize != null ? maxSize : 100, Math.max(minSize, sizes[index] + remainingSize));
+      if (size !== sizes[index]) {
+        remainingSize -= size - sizes[index];
+        sizes[index] = size;
+
+        // Fuzzy comparison to account for imprecise floating point math
+        if (Math.abs(remainingSize).toFixed(3) === "0.000") {
+          break;
+        }
+      }
+    }
+  }
+
+  // Finally, if there is still left-over size, log an error
+  if (Math.abs(remainingSize).toFixed(3) !== "0.000") {
+    {
+      console.error(`Invalid panel group configuration; default panel sizes should total 100% but was ${(100 - remainingSize).toFixed(1)}%. This can cause the cursor to become misaligned while dragging.`);
+    }
+  }
+  return sizes;
+}
 function getBeforeAndAfterIds(id, panelsArray) {
   if (panelsArray.length < 2) {
     return [null, null];
@@ -307,6 +390,23 @@ function getBeforeAndAfterIds(id, panelsArray) {
   const idAfter = isLastPanel ? id : panelsArray[index + 1].current.id;
   return [idBefore, idAfter];
 }
+function getAvailableGroupSizePixels(groupId) {
+  const panelGroupElement = getPanelGroup(groupId);
+  if (panelGroupElement == null) {
+    return NaN;
+  }
+  const direction = panelGroupElement.getAttribute("data-panel-group-direction");
+  const resizeHandles = getResizeHandlesForGroup(groupId);
+  if (direction === "horizontal") {
+    return panelGroupElement.offsetWidth - resizeHandles.reduce((accumulated, handle) => {
+      return accumulated + handle.offsetWidth;
+    }, 0);
+  } else {
+    return panelGroupElement.offsetHeight - resizeHandles.reduce((accumulated, handle) => {
+      return accumulated + handle.offsetHeight;
+    }, 0);
+  }
+}
 
 // This method returns a number between 1 and 100 representing
 // the % of the group's overall space this panel should occupy.
@@ -377,18 +477,24 @@ function panelsMapToSortedArray(panels) {
     }
   });
 }
-function safeResizePanel(panel, delta, prevSize, event) {
-  const nextSizeUnsafe = prevSize + delta;
-  const {
+function safeResizePanel(units, groupSizePixels, panel, prevSize, nextSize, event = null) {
+  let {
     collapsedSize,
     collapsible,
     maxSize,
     minSize
   } = panel.current;
+  if (units === "pixels") {
+    collapsedSize = collapsedSize / groupSizePixels * 100;
+    if (maxSize != null) {
+      maxSize = maxSize / groupSizePixels * 100;
+    }
+    minSize = minSize / groupSizePixels * 100;
+  }
   if (collapsible) {
     if (prevSize > collapsedSize) {
       // Mimic VS COde behavior; collapse a panel if it's smaller than half of its min-size
-      if (nextSizeUnsafe <= minSize / 2 + collapsedSize) {
+      if (nextSize <= minSize / 2 + collapsedSize) {
         return collapsedSize;
       }
     } else {
@@ -397,14 +503,119 @@ function safeResizePanel(panel, delta, prevSize, event) {
         // Keyboard events should expand a collapsed panel to the min size,
         // but mouse events should wait until the panel has reached its min size
         // to avoid a visual flickering when dragging between collapsed and min size.
-        if (nextSizeUnsafe < minSize) {
+        if (nextSize < minSize) {
           return collapsedSize;
         }
       }
     }
   }
-  const nextSize = Math.min(maxSize, Math.max(minSize, nextSizeUnsafe));
-  return nextSize;
+  return Math.min(maxSize != null ? maxSize : 100, Math.max(minSize, nextSize));
+}
+function validatePanelProps(units, panelData) {
+  const {
+    collapsible,
+    defaultSize,
+    maxSize,
+    minSize
+  } = panelData.current;
+
+  // Basic props validation
+  if (minSize < 0 || units === "percentages" && minSize > 100) {
+    {
+      console.error(`Invalid Panel minSize provided, ${minSize}`);
+    }
+    panelData.current.minSize = 0;
+  }
+  if (maxSize != null) {
+    if (maxSize < 0 || units === "percentages" && maxSize > 100) {
+      {
+        console.error(`Invalid Panel maxSize provided, ${maxSize}`);
+      }
+      panelData.current.maxSize = null;
+    }
+  }
+  if (defaultSize !== null) {
+    if (defaultSize < 0 || units === "percentages" && defaultSize > 100) {
+      {
+        console.error(`Invalid Panel defaultSize provided, ${defaultSize}`);
+      }
+      panelData.current.defaultSize = null;
+    } else if (defaultSize < minSize && !collapsible) {
+      {
+        console.error(`Panel minSize (${minSize}) cannot be greater than defaultSize (${defaultSize})`);
+      }
+      panelData.current.defaultSize = minSize;
+    } else if (maxSize != null && defaultSize > maxSize) {
+      {
+        console.error(`Panel maxSize (${maxSize}) cannot be less than defaultSize (${defaultSize})`);
+      }
+      panelData.current.defaultSize = maxSize;
+    }
+  }
+}
+function validatePanelGroupLayout({
+  groupId,
+  panels,
+  nextSizes,
+  prevSizes,
+  units
+}) {
+  // Clone because this method modifies
+  nextSizes = [...nextSizes];
+  const panelsArray = panelsMapToSortedArray(panels);
+  const groupSizePixels = units === "pixels" ? getAvailableGroupSizePixels(groupId) : NaN;
+  let remainingSize = 0;
+
+  // First, check all of the proposed sizes against the min/max constraints
+  for (let index = 0; index < panelsArray.length; index++) {
+    const panel = panelsArray[index];
+    const prevSize = prevSizes[index];
+    const nextSize = nextSizes[index];
+    const safeNextSize = safeResizePanel(units, groupSizePixels, panel, prevSize, nextSize);
+    if (nextSize != safeNextSize) {
+      remainingSize += nextSize - safeNextSize;
+      nextSizes[index] = safeNextSize;
+      {
+        console.error(`Invalid size (${nextSize}) specified for Panel "${panel.current.id}" given the panel's min/max size constraints`);
+      }
+    }
+  }
+
+  // If there is additional, left over space, assign it to any panel(s) that permits it
+  // (It's not worth taking multiple additional passes to evenly distribute)
+  if (remainingSize.toFixed(3) !== "0.000") {
+    for (let index = 0; index < panelsArray.length; index++) {
+      const panel = panelsArray[index];
+      let {
+        maxSize,
+        minSize
+      } = panel.current;
+      if (units === "pixels") {
+        minSize = minSize / groupSizePixels * 100;
+        if (maxSize != null) {
+          maxSize = maxSize / groupSizePixels * 100;
+        }
+      }
+      const size = Math.min(maxSize != null ? maxSize : 100, Math.max(minSize, nextSizes[index] + remainingSize));
+      if (size !== nextSizes[index]) {
+        remainingSize -= size - nextSizes[index];
+        nextSizes[index] = size;
+
+        // Fuzzy comparison to account for imprecise floating point math
+        if (Math.abs(remainingSize).toFixed(3) === "0.000") {
+          break;
+        }
+      }
+    }
+  }
+
+  // If we still have remainder, the requested layout wasn't valid and we should warn about it
+  if (remainingSize.toFixed(3) !== "0.000") {
+    {
+      console.error(`"Invalid panel group configuration; default panel sizes should total 100% but was ${100 - remainingSize}%`);
+    }
+  }
+  return nextSizes;
 }
 
 function assert(expectedCondition, message = "Assertion failed!") {
@@ -430,6 +641,7 @@ function useWindowSplitterPanelGroupBehavior({
       panels
     } = committedValuesRef.current;
     const groupElement = getPanelGroup(groupId);
+    assert(groupElement != null, `No group found for id "${groupId}"`);
     const {
       height,
       width
@@ -442,23 +654,28 @@ function useWindowSplitterPanelGroupBehavior({
       if (idBefore == null || idAfter == null) {
         return () => {};
       }
-      let minSize = 0;
-      let maxSize = 100;
+      let currentMinSize = 0;
+      let currentMaxSize = 100;
       let totalMinSize = 0;
       let totalMaxSize = 0;
 
       // A panel's effective min/max sizes also need to account for other panel's sizes.
       panelsArray.forEach(panelData => {
-        if (panelData.current.id === idBefore) {
-          maxSize = panelData.current.maxSize;
-          minSize = panelData.current.minSize;
+        const {
+          id,
+          maxSize,
+          minSize
+        } = panelData.current;
+        if (id === idBefore) {
+          currentMinSize = minSize;
+          currentMaxSize = maxSize != null ? maxSize : 100;
         } else {
-          totalMinSize += panelData.current.minSize;
-          totalMaxSize += panelData.current.maxSize;
+          totalMinSize += minSize;
+          totalMaxSize += maxSize != null ? maxSize : 100;
         }
       });
-      const ariaValueMax = Math.min(maxSize, 100 - totalMinSize);
-      const ariaValueMin = Math.max(minSize, (panelsArray.length - 1) * 100 - totalMaxSize);
+      const ariaValueMax = Math.min(currentMaxSize, 100 - totalMinSize);
+      const ariaValueMin = Math.max(currentMinSize, (panelsArray.length - 1) * 100 - totalMaxSize);
       const flexGrow = getFlexGrow(panels, idBefore, sizes);
       handle.setAttribute("aria-valuemax", "" + Math.round(ariaValueMax));
       handle.setAttribute("aria-valuemin", "" + Math.round(ariaValueMin));
@@ -482,7 +699,7 @@ function useWindowSplitterPanelGroupBehavior({
                   } else {
                     delta = -(direction === "horizontal" ? width : height);
                   }
-                  const nextSizes = adjustByDelta(event, panels, idBefore, idAfter, delta, sizes, panelSizeBeforeCollapse.current, null);
+                  const nextSizes = adjustByDelta(event, committedValuesRef.current, idBefore, idAfter, delta, sizes, panelSizeBeforeCollapse.current, null);
                   if (sizes !== nextSizes) {
                     setSizes(nextSizes);
                   }
@@ -754,13 +971,6 @@ function savePanelGroupLayout(autoSaveId, panels, sizes, storage) {
   }
 }
 
-function isServerRendering() {
-  try {
-    return typeof window === undefined;
-  } catch (error) {}
-  return true;
-}
-
 const debounceMap = {};
 
 // PanelGroup might be rendering in a server-side environment where localStorage is not available
@@ -804,9 +1014,6 @@ const defaultStorage = {
 // * dragHandleRect, sizes:
 //   When resizing is done via mouse/touch event– some initial state is stored
 //   so that any panels that contract will also expand if drag direction is reversed.
-// TODO
-// Within an active drag, remember original positions to refine more easily on expand.
-// Look at what the Chrome devtools Sources does.
 function PanelGroupWithForwardedRef({
   autoSaveId,
   children = null,
@@ -818,7 +1025,8 @@ function PanelGroupWithForwardedRef({
   onLayout,
   storage = defaultStorage,
   style: styleFromProps = {},
-  tagName: Type = "div"
+  tagName: Type = "div",
+  units = "percentages"
 }) {
   const groupId = useUniqueId(idFromProps);
   const [activeHandleId, setActiveHandleId] = useState(null);
@@ -828,6 +1036,12 @@ function PanelGroupWithForwardedRef({
   // We store the initial Panel sizes in this ref, and apply move deltas to them instead of to the current sizes.
   // This has the benefit of causing force-collapsed panels to spring back open if drag is reversed.
   const initialDragStateRef = useRef(null);
+  const devWarningsRef = useRef({
+    didLogDefaultSizeWarning: false,
+    didLogIdAndOrderWarning: false,
+    didLogInvalidLayoutWarning: false,
+    prevPanelIds: []
+  });
 
   // Use a ref to guard against users passing inline props
   const callbacksRef = useRef({
@@ -848,32 +1062,58 @@ function PanelGroupWithForwardedRef({
   // Store committed values to avoid unnecessarily re-running memoization/effects functions.
   const committedValuesRef = useRef({
     direction,
+    id: groupId,
     panels,
-    sizes
+    sizes,
+    units
   });
   useImperativeHandle(forwardedRef, () => ({
-    getLayout: () => {
+    getId: () => groupId,
+    getLayout: unitsFromParams => {
       const {
-        sizes
+        sizes,
+        units: unitsFromProps
       } = committedValuesRef.current;
-      return sizes;
+      const units = unitsFromParams ?? unitsFromProps;
+      if (units === "pixels") {
+        const groupSizePixels = getAvailableGroupSizePixels(groupId);
+        return sizes.map(size => size / 100 * groupSizePixels);
+      } else {
+        return sizes;
+      }
     },
-    setLayout: sizes => {
-      const total = sizes.reduce((accumulated, current) => accumulated + current, 0);
-      assert(total === 100, "Panel sizes must add up to 100%");
+    setLayout: (sizes, unitsFromParams) => {
       const {
-        panels
+        id: groupId,
+        panels,
+        sizes: prevSizes,
+        units
       } = committedValuesRef.current;
+      if ((unitsFromParams || units) === "pixels") {
+        const groupSizePixels = getAvailableGroupSizePixels(groupId);
+        sizes = sizes.map(size => size / groupSizePixels * 100);
+      }
       const panelIdToLastNotifiedSizeMap = panelIdToLastNotifiedSizeMapRef.current;
       const panelsArray = panelsMapToSortedArray(panels);
-      setSizes(sizes);
-      callPanelCallbacks(panelsArray, sizes, panelIdToLastNotifiedSizeMap);
+      const nextSizes = validatePanelGroupLayout({
+        groupId,
+        panels,
+        nextSizes: sizes,
+        prevSizes,
+        units
+      });
+      if (!areEqual(prevSizes, nextSizes)) {
+        setSizes(nextSizes);
+        callPanelCallbacks(panelsArray, nextSizes, panelIdToLastNotifiedSizeMap);
+      }
     }
-  }), []);
+  }), [groupId]);
   useIsomorphicLayoutEffect(() => {
     committedValuesRef.current.direction = direction;
+    committedValuesRef.current.id = groupId;
     committedValuesRef.current.panels = panels;
     committedValuesRef.current.sizes = sizes;
+    committedValuesRef.current.units = units;
   });
   useWindowSplitterPanelGroupBehavior({
     committedValuesRef,
@@ -915,7 +1155,11 @@ function PanelGroupWithForwardedRef({
   // Compute the initial sizes based on default weights.
   // This assumes that panels register during initial mount (no conditional rendering)!
   useIsomorphicLayoutEffect(() => {
-    const sizes = committedValuesRef.current.sizes;
+    const {
+      id: groupId,
+      sizes,
+      units
+    } = committedValuesRef.current;
     if (sizes.length === panels.size) {
       // Only compute (or restore) default sizes once per panel configuration.
       return;
@@ -929,39 +1173,23 @@ function PanelGroupWithForwardedRef({
       defaultSizes = loadPanelLayout(autoSaveId, panelsArray, storage);
     }
     if (defaultSizes != null) {
-      setSizes(defaultSizes);
+      // Validate saved sizes in case something has changed since last render
+      // e.g. for pixel groups, this could be the size of the window
+      const validatedSizes = validatePanelGroupLayout({
+        groupId,
+        panels,
+        nextSizes: defaultSizes,
+        prevSizes: defaultSizes,
+        units
+      });
+      setSizes(validatedSizes);
     } else {
-      const panelsArray = panelsMapToSortedArray(panels);
-      let panelsWithNullDefaultSize = 0;
-      let totalDefaultSize = 0;
-      let totalMinSize = 0;
-
-      // TODO
-      // Implicit default size calculations below do not account for inferred min/max size values.
-      // e.g. if Panel A has a maxSize of 40 then Panels A and B can't both have an implicit default size of 50.
-      // For now, these logic edge cases are left to the user to handle via props.
-
-      panelsArray.forEach(panel => {
-        totalMinSize += panel.current.minSize;
-        if (panel.current.defaultSize === null) {
-          panelsWithNullDefaultSize++;
-        } else {
-          totalDefaultSize += panel.current.defaultSize;
-        }
+      const sizes = calculateDefaultLayout({
+        groupId,
+        panels,
+        units
       });
-      if (totalDefaultSize > 100) {
-        throw new Error(`Default panel sizes cannot exceed 100%`);
-      } else if (panelsArray.length > 1 && panelsWithNullDefaultSize === 0 && totalDefaultSize !== 100) {
-        throw new Error(`Invalid default sizes specified for panels`);
-      } else if (totalMinSize > 100) {
-        throw new Error(`Minimum panel sizes cannot exceed 100%`);
-      }
-      setSizes(panelsArray.map(panel => {
-        if (panel.current.defaultSize === null) {
-          return (100 - totalDefaultSize) / panelsWithNullDefaultSize;
-        }
-        return panel.current.defaultSize;
-      }));
+      setSizes(sizes);
     }
   }, [autoSaveId, panels, storage]);
   useEffect(() => {
@@ -978,7 +1206,69 @@ function PanelGroupWithForwardedRef({
       }
       debounceMap[autoSaveId](autoSaveId, panelsArray, sizes, storage);
     }
+    {
+      const {
+        didLogIdAndOrderWarning,
+        prevPanelIds
+      } = devWarningsRef.current;
+      if (!didLogIdAndOrderWarning) {
+        const {
+          panels
+        } = committedValuesRef.current;
+        const panelIds = Array.from(panels.keys());
+        devWarningsRef.current.prevPanelIds = panelIds;
+        const panelsHaveChanged = prevPanelIds.length > 0 && !areEqual(prevPanelIds, panelIds);
+        if (panelsHaveChanged) {
+          if (Array.from(panels.values()).find(panel => panel.current.idWasAutoGenerated || panel.current.order == null)) {
+            devWarningsRef.current.didLogIdAndOrderWarning = true;
+            console.warn(`WARNING: Panel id and order props recommended when panels are dynamically rendered`);
+          }
+        }
+      }
+    }
   }, [autoSaveId, panels, sizes, storage]);
+  useIsomorphicLayoutEffect(() => {
+    // Pixel panel constraints need to be reassessed after a group resize
+    // We can avoid the ResizeObserver overhead for relative layouts
+    if (units === "pixels") {
+      const resizeObserver = new ResizeObserver(() => {
+        const {
+          panels,
+          sizes: prevSizes
+        } = committedValuesRef.current;
+        const nextSizes = validatePanelGroupLayout({
+          groupId,
+          panels,
+          nextSizes: prevSizes,
+          prevSizes,
+          units
+        });
+        if (!areEqual(prevSizes, nextSizes)) {
+          setSizes(nextSizes);
+        }
+      });
+      resizeObserver.observe(getPanelGroup(groupId));
+      return () => {
+        resizeObserver.disconnect();
+      };
+    }
+  }, [groupId, units]);
+  const getPanelSize = useCallback((id, unitsFromParams) => {
+    const {
+      panels,
+      units: unitsFromProps
+    } = committedValuesRef.current;
+    const panelsArray = panelsMapToSortedArray(panels);
+    const index = panelsArray.findIndex(panel => panel.current.id === id);
+    const size = sizes[index];
+    const units = unitsFromParams ?? unitsFromProps;
+    if (units === "pixels") {
+      const groupSizePixels = getAvailableGroupSizePixels(groupId);
+      return size / 100 * groupSizePixels;
+    } else {
+      return size;
+    }
+  }, [groupId, sizes]);
   const getPanelStyle = useCallback((id, defaultSize) => {
     const {
       panels
@@ -989,8 +1279,11 @@ function PanelGroupWithForwardedRef({
     // At this point the best we can do is render everything with the same size.
     if (panels.size === 0) {
       {
-        if (isServerRendering() && defaultSize == null) {
-          console.warn(`WARNING: Panel defaultSize prop recommended to avoid layout shift after server rendering`);
+        if (!devWarningsRef.current.didLogDefaultSizeWarning) {
+          if (!isBrowser && defaultSize == null) {
+            devWarningsRef.current.didLogDefaultSizeWarning = true;
+            console.warn(`WARNING: Panel defaultSize prop recommended to avoid layout shift after server rendering`);
+          }
         }
       }
       return {
@@ -1014,6 +1307,10 @@ function PanelGroupWithForwardedRef({
     };
   }, [activeHandleId, disablePointerEventsDuringResize, sizes]);
   const registerPanel = useCallback((id, panelRef) => {
+    const {
+      units
+    } = committedValuesRef.current;
+    validatePanelProps(units, panelRef);
     setPanels(prevPanels => {
       if (prevPanels.has(id)) {
         return prevPanels;
@@ -1050,7 +1347,10 @@ function PanelGroupWithForwardedRef({
       }
       const size = isHorizontal ? rect.width : rect.height;
       const delta = movement / size * 100;
-      const nextSizes = adjustByDelta(event, panels, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, initialDragStateRef.current);
+
+      // If a validateLayout method has been provided
+      // it's important to use it before updating the mouse cursor
+      const nextSizes = adjustByDelta(event, committedValuesRef.current, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, initialDragStateRef.current);
       const sizesChanged = !areEqual(prevSizes, nextSizes);
 
       // Don't update cursor for resizes triggered by keyboard interactions.
@@ -1077,6 +1377,8 @@ function PanelGroupWithForwardedRef({
       }
       if (sizesChanged) {
         const panelIdToLastNotifiedSizeMap = panelIdToLastNotifiedSizeMapRef.current;
+
+        // It's okay to bypass in this case because we already validated above
         setSizes(nextSizes);
 
         // If resize change handlers have been declared, this is the time to call them.
@@ -1130,7 +1432,7 @@ function PanelGroupWithForwardedRef({
     }
     const isLastPanel = index === panelsArray.length - 1;
     const delta = isLastPanel ? currentSize : collapsedSize - currentSize;
-    const nextSizes = adjustByDelta(null, panels, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, null);
+    const nextSizes = adjustByDelta(null, committedValuesRef.current, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, null);
     if (prevSizes !== nextSizes) {
       const panelIdToLastNotifiedSizeMap = panelIdToLastNotifiedSizeMapRef.current;
       setSizes(nextSizes);
@@ -1173,7 +1475,7 @@ function PanelGroupWithForwardedRef({
     }
     const isLastPanel = index === panelsArray.length - 1;
     const delta = isLastPanel ? collapsedSize - sizeBeforeCollapse : sizeBeforeCollapse;
-    const nextSizes = adjustByDelta(null, panels, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, null);
+    const nextSizes = adjustByDelta(null, committedValuesRef.current, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, null);
     if (prevSizes !== nextSizes) {
       const panelIdToLastNotifiedSizeMap = panelIdToLastNotifiedSizeMapRef.current;
       setSizes(nextSizes);
@@ -1183,21 +1485,34 @@ function PanelGroupWithForwardedRef({
       callPanelCallbacks(panelsArray, nextSizes, panelIdToLastNotifiedSizeMap);
     }
   }, []);
-  const resizePanel = useCallback((id, nextSize) => {
+  const resizePanel = useCallback((id, nextSize, unitsFromParams) => {
     const {
+      id: groupId,
       panels,
-      sizes: prevSizes
+      sizes: prevSizes,
+      units
     } = committedValuesRef.current;
+    if ((unitsFromParams || units) === "pixels") {
+      const groupSizePixels = getAvailableGroupSizePixels(groupId);
+      nextSize = nextSize / groupSizePixels * 100;
+    }
     const panel = panels.get(id);
     if (panel == null) {
       return;
     }
-    const {
+    let {
       collapsedSize,
       collapsible,
       maxSize,
       minSize
     } = panel.current;
+    if (units === "pixels") {
+      const groupSizePixels = getAvailableGroupSizePixels(groupId);
+      minSize = minSize / groupSizePixels * 100;
+      if (maxSize != null) {
+        maxSize = maxSize / groupSizePixels * 100;
+      }
+    }
     const panelsArray = panelsMapToSortedArray(panels);
     const index = panelsArray.indexOf(panel);
     if (index < 0) {
@@ -1208,7 +1523,13 @@ function PanelGroupWithForwardedRef({
       return;
     }
     if (collapsible && nextSize === collapsedSize) ; else {
-      nextSize = Math.min(maxSize, Math.max(minSize, nextSize));
+      const unsafeNextSize = nextSize;
+      nextSize = Math.min(maxSize != null ? maxSize : 100, Math.max(minSize, nextSize));
+      {
+        if (unsafeNextSize !== nextSize) {
+          console.error(`Invalid size (${unsafeNextSize}) specified for Panel "${panel.current.id}" given the panel's min/max size constraints`);
+        }
+      }
     }
     const [idBefore, idAfter] = getBeforeAndAfterIds(id, panelsArray);
     if (idBefore == null || idAfter == null) {
@@ -1216,7 +1537,7 @@ function PanelGroupWithForwardedRef({
     }
     const isLastPanel = index === panelsArray.length - 1;
     const delta = isLastPanel ? currentSize - nextSize : nextSize - currentSize;
-    const nextSizes = adjustByDelta(null, panels, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, null);
+    const nextSizes = adjustByDelta(null, committedValuesRef.current, idBefore, idAfter, delta, prevSizes, panelSizeBeforeCollapse.current, null);
     if (prevSizes !== nextSizes) {
       const panelIdToLastNotifiedSizeMap = panelIdToLastNotifiedSizeMapRef.current;
       setSizes(nextSizes);
@@ -1231,6 +1552,7 @@ function PanelGroupWithForwardedRef({
     collapsePanel,
     direction,
     expandPanel,
+    getPanelSize,
     getPanelStyle,
     groupId,
     registerPanel,
@@ -1252,8 +1574,9 @@ function PanelGroupWithForwardedRef({
       setActiveHandleId(null);
       initialDragStateRef.current = null;
     },
+    units,
     unregisterPanel
-  }), [activeHandleId, collapsePanel, direction, expandPanel, getPanelStyle, groupId, registerPanel, registerResizeHandle, resizePanel, unregisterPanel]);
+  }), [activeHandleId, collapsePanel, direction, expandPanel, getPanelSize, getPanelStyle, groupId, registerPanel, registerResizeHandle, resizePanel, units, unregisterPanel]);
   const style = {
     display: "flex",
     flexDirection: direction === "horizontal" ? "row" : "column",
@@ -1268,6 +1591,7 @@ function PanelGroupWithForwardedRef({
       "data-panel-group": "",
       "data-panel-group-direction": direction,
       "data-panel-group-id": groupId,
+      "data-panel-group-units": units,
       style: {
         ...style,
         ...styleFromProps
@@ -1280,10 +1604,6 @@ const PanelGroup = forwardRef((props, ref) => createElement(PanelGroupWithForwar
   ...props,
   forwardedRef: ref
 }));
-
-// Workaround for Parcel scope hoisting (which renames objects/functions).
-// Casting to :any is required to avoid corrupting the generated TypeScript types.
-// See github.com/parcel-bundler/parcel/issues/8724
 PanelGroupWithForwardedRef.displayName = "PanelGroup";
 PanelGroup.displayName = "forwardRef(PanelGroup)";
 
@@ -1419,10 +1739,6 @@ function PanelResizeHandle({
     tabIndex: 0
   });
 }
-
-// Workaround for Parcel scope hoisting (which renames objects/functions).
-// Casting to :any is required to avoid corrupting the generated TypeScript types.
-// See github.com/parcel-bundler/parcel/issues/8724
 PanelResizeHandle.displayName = "PanelResizeHandle";
 
-export { Panel, PanelGroup, PanelResizeHandle };
+export { Panel, PanelGroup, PanelResizeHandle, getAvailableGroupSizePixels };