react-resizable-panels 3.0.6 → 4.0.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 Brian Vaughn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,260 +1,263 @@
 # react-resizable-panels
 
-React components for resizable panel groups/layouts
-
-```jsx
-import { Panel, PanelGroup, PanelResizeHandle } from "react-resizable-panels";
-
-<PanelGroup autoSaveId="example" direction="horizontal">
-  <Panel defaultSize={25}>
-    <SourcesExplorer />
-  </Panel>
-  <PanelResizeHandle />
-  <Panel>
-    <SourceViewer />
-  </Panel>
-  <PanelResizeHandle />
-  <Panel defaultSize={25}>
-    <Console />
-  </Panel>
-</PanelGroup>;
-```
-
-## If you like this project, 🎉 [become a sponsor](https://github.com/sponsors/bvaughn/) or ☕ [buy me a coffee](http://givebrian.coffee/)
-
-## Props
-
-### `PanelGroup`
-
-| prop         | type                         | description                                                      |
-| :----------- | :--------------------------- | :--------------------------------------------------------------- |
-| `autoSaveId` | `?string`                    | Unique id used to auto-save group arrangement via `localStorage` |
-| `children`   | `ReactNode`                  | Arbitrary React element(s)                                       |
-| `className`  | `?string`                    | Class name to attach to root element                             |
-| `direction`  | `"horizontal" \| "vertical"` | Group orientation                                                |
-| `id`         | `?string`                    | Group id; falls back to `useId` when not provided                |
-| `onLayout`   | `?(sizes: number[]) => void` | Called when group layout changes                                 |
-| `storage`    | `?PanelGroupStorage`         | Custom storage API; defaults to `localStorage` <sup>1</sup>      |
-| `style`      | `?CSSProperties`             | CSS style to attach to root element                              |
-| `tagName`    | `?string = "div"`            | HTML element tag name for root element                           |
-
-<sup>1</sup>: Storage API must define the following _synchronous_ methods:
-
-- `getItem: (name:string) => string`
-- `setItem: (name: string, value: string) => void`
-
-`PanelGroup` components also expose an imperative API for manual resizing:
-| method                        | description                                                      |
-| :---------------------------- | :--------------------------------------------------------------- |
-| `getId(): string`             | Gets the panel group's ID.                                       |
-| `getLayout(): number[]`       | Gets the panel group's current _layout_ (`[1 - 100, ...]`).      |
-| `setLayout(layout: number[])` | Resize panel group to the specified _layout_ (`[1 - 100, ...]`). |
-
-### `Panel`
-
-| prop            | type                      | description                                                                                   |
-| :-------------- | :------------------------ | :-------------------------------------------------------------------------------------------- |
-| `children`      | `ReactNode`               | Arbitrary React element(s)                                                                    |
-| `className`     | `?string`                 | Class name to attach to root element                                                          |
-| `collapsedSize` | `?number=0`               | Panel should collapse to this size                                                            |
-| `collapsible`   | `?boolean=false`          | Panel should collapse when resized beyond its `minSize`                                       |
-| `defaultSize`   | `?number`                 | Initial size of panel (numeric value between 1-100)                                           |
-| `id`            | `?string`                 | Panel id (unique within group); falls back to `useId` when not provided                       |
-| `maxSize`       | `?number = 100`           | Maximum allowable size of panel (numeric value between 1-100); defaults to `100`              |
-| `minSize`       | `?number = 10`            | Minimum allowable size of panel (numeric value between 1-100); defaults to `10`               |
-| `onCollapse`    | `?() => void`             | Called when panel is collapsed                                                                |
-| `onExpand`      | `?() => void`             | Called when panel is expanded                                                                 |
-| `onResize`      | `?(size: number) => void` | Called when panel is resized; `size` parameter is a numeric value between 1-100. <sup>1</sup> |
-| `order`         | `?number`                 | Order of panel within group; required for groups with conditionally rendered panels           |
-| `style`         | `?CSSProperties`          | CSS style to attach to root element                                                           |
-| `tagName`       | `?string = "div"`         | HTML element tag name for root element                                                        |
-
-<sup>1</sup>: If any `Panel` has an `onResize` callback, the `order` prop should be provided for all `Panel`s.
-
-`Panel` components also expose an imperative API for manual resizing:
-| method                   | description                                                                        |
-| :----------------------- | :--------------------------------------------------------------------------------- |
-| `collapse()`             | If panel is `collapsible`, collapse it fully.                                      |
-| `expand()`               | If panel is currently _collapsed_, expand it to its most recent size.              |
-| `getId(): string`        | Gets the ID of the panel.                                                          |
-| `getSize(): number`      | Gets the current size of the panel as a percentage (`1 - 100`).                    |
-| `isCollapsed(): boolean` | Returns `true` if the panel is currently _collapsed_ (`size === 0`).               |
-| `isExpanded(): boolean`  | Returns `true` if the panel is currently _not collapsed_ (`!isCollapsed()`).       |
-| `resize(size: number)`   | Resize panel to the specified _percentage_ (`1 - 100`).                            |
-
-### `PanelResizeHandle`
-
-| prop             | type                                          | description                                                                     |
-| :--------------- | :-------------------------------------------- | :------------------------------------------------------------------------------ |
-| `children`       | `?ReactNode`                                  | Custom drag UI; can be any arbitrary React element(s)                           |
-| `className`      | `?string`                                     | Class name to attach to root element                                            |
-| `hitAreaMargins` | `?{ coarse: number = 15; fine: number = 5; }` | Allow this much margin when determining resizable handle hit detection          |
-| `disabled`       | `?boolean`                                    | Disable drag handle                                                             |
-| `id`             | `?string`                                     | Resize handle id (unique within group); falls back to `useId` when not provided |
-| `onDragging`     | `?(isDragging: boolean) => void`              | Called when group layout changes                                                |
-| `style`          | `?CSSProperties`                              | CSS style to attach to root element                                             |
-| `tagName`        | `?string = "div"`                             | HTML element tag name for root element                                          |
-
----
-
-## FAQ
-
-### Can panel sizes be specified in pixels?
-
-No. Pixel-based constraints [added significant complexity](https://github.com/bvaughn/react-resizable-panels/pull/176) to the initialization and validation logic and so I've decided not to support them. You may be able to implement a version of this yourself following [a pattern like this](https://github.com/bvaughn/react-resizable-panels/issues/46#issuecomment-1368108416) but it is not officially supported by this library.
-
-### How can I fix layout/sizing problems with conditionally rendered panels?
-
-The `Panel` API doesn't _require_ `id` and `order` props because they aren't necessary for static layouts. When panels are conditionally rendered though, it's best to supply these values.
-
-```tsx
-<PanelGroup direction="horizontal">
-  {renderSideBar && (
-    <>
-      <Panel id="sidebar" minSize={25} order={1}>
-        <Sidebar />
-      </Panel>
-      <PanelResizeHandle />
-    </>
-  )}
-  <Panel minSize={25} order={2}>
-    <Main />
-  </Panel>
-</PanelGroup>
-```
-
-### Can I attach a ref to the DOM elements?
-
-No. I think exposing two refs (one for the component's imperative API and one for a DOM element) would be awkward. This library does export several utility methods for accessing the underlying DOM elements though. For example:
-
-```tsx
-import {
-  getPanelElement,
-  getPanelGroupElement,
-  getResizeHandleElement,
-  Panel,
-  PanelGroup,
-  PanelResizeHandle,
-} from "react-resizable-panels";
-
-export function Example() {
-  const refs = useRef();
-
-  useEffect(() => {
-    const groupElement = getPanelGroupElement("group");
-    const leftPanelElement = getPanelElement("left-panel");
-    const rightPanelElement = getPanelElement("right-panel");
-    const resizeHandleElement = getResizeHandleElement("resize-handle");
-
-    // If you want to, you can store them in a ref to pass around
-    refs.current = {
-      groupElement,
-      leftPanelElement,
-      rightPanelElement,
-      resizeHandleElement,
-    };
-  }, []);
-
-  return (
-    <PanelGroup direction="horizontal" id="group">
-      <Panel id="left-panel">{/* ... */}</Panel>
-      <PanelResizeHandle id="resize-handle" />
-      <Panel id="right-panel">{/* ... */}</Panel>
-    </PanelGroup>
-  );
-}
-```
-
-### Why don't I see any resize UI?
-
-This likely means that you haven't applied any CSS to style the resize handles. By default, a resize handle is just an empty DOM element. To add styling, use the `className` or `style` props:
-
-```tsx
-// Tailwind example
-<PanelResizeHandle className="w-2 bg-blue-800" />
-```
-
-### Can panel sizes be persistent?
-
-Yes. Panel groups with an `autoSaveId` prop will automatically save and restore their layouts on mount.
-
-### How can I use persistent layouts with SSR?
-
-By default, this library uses `localStorage` to persist layouts. With server rendering, this can cause a flicker when the default layout (rendered on the server) is replaced with the persisted layout (in `localStorage`). The way to avoid this flicker is to also persist the layout with a cookie like so:
-
-#### Server component
+React components for resizable panel groups/layouts.
 
-```tsx
-import ResizablePanels from "@/app/ResizablePanels";
-import { cookies } from "next/headers";
+## Support
 
-export function ServerComponent() {
-  const layout = cookies().get("react-resizable-panels:layout");
+If you like this project there are several ways to support it:
 
-  let defaultLayout;
-  if (layout) {
-    defaultLayout = JSON.parse(layout.value);
-  }
+- [Become a GitHub sponsor](https://github.com/sponsors/bvaughn/)
+- or [buy me a coffee](http://givebrian.coffee/)
 
-  return <ClientComponent defaultLayout={defaultLayout} />;
-}
-```
-
-#### Client component
-
-```tsx
-"use client";
-
-import { Panel, PanelGroup, PanelResizeHandle } from "react-resizable-panels";
-
-export function ClientComponent({
-  defaultLayout = [33, 67],
-}: {
-  defaultLayout: number[] | undefined;
-}) {
-  const onLayout = (sizes: number[]) => {
-    document.cookie = `react-resizable-panels:layout=${JSON.stringify(sizes)}`;
-  };
-
-  return (
-    <PanelGroup direction="horizontal" onLayout={onLayout}>
-      <Panel defaultSize={defaultLayout[0]}>{/* ... */}</Panel>
-      <PanelResizeHandle className="w-2 bg-blue-800" />
-      <Panel defaultSize={defaultLayout[1]}>{/* ... */}</Panel>
-    </PanelGroup>
-  );
-}
-```
-
-> [!NOTE]
-> Be sure to specify a `defaultSize` prop for **every** `Panel` component to avoid layout flicker.
-
-A demo of this is available [here](https://github.com/bvaughn/react-resizable-panels-demo-ssr).
-
-#### How can I set the [CSP `"nonce"`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/nonce) attribute?
-
-```js
-import { setNonce } from "react-resizable-panels";
+## Installation
 
-setNonce("your-nonce-value-here");
-```
-
-#### How can I disable global cursor styles?
+Begin by installing the library from NPM:
 
-```js
-import { disableGlobalCursorStyles } from "react-resizable-panels";
-
-disableGlobalCursorStyles();
+```sh
+npm install react-resizable-panels
 ```
 
-#### How can I override the global cursor styles?
-
-```js
-import { customizeGlobalCursorStyles, type CustomCursorStyleConfig } from "react-resizable-panels";
-
-function customCursor({ isPointerDown }: CustomCursorStyleConfig) {
-  return isPointerDown ? "grabbing" : "grab";
-}
-
-customizeGlobalCursorStyles(customCursor);
-```
+## TypeScript types
+
+TypeScript definitions are included within the published `dist` folder
+
+## Documentation
+
+Documentation for this project is available at [react-resizable-panels.vercel.app](https://react-resizable-panels.vercel.app/).
+
+### Group
+
+#### Required props
+
+<!-- Group:required:begin -->
+
+<!-- Group:required:end -->
+
+#### Optional props
+
+<!-- Group:optional:begin -->
+
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>children</td>
+      <td><p>Panel and Separator components that comprise this group.</p>
+</td>
+    </tr>
+    <tr>
+      <td>className</td>
+      <td><p>CSS class name.</p>
+</td>
+    </tr>
+    <tr>
+      <td>defaultLayout</td>
+      <td><p>Default layout for the Group.</p>
+<p>ℹ️ This value allows layouts to be remembered between page reloads.</p>
+<p>⚠️ Refer to the documentation for how to avoid layout shift when using server components.</p>
+</td>
+    </tr>
+    <tr>
+      <td>direction</td>
+      <td><p>Specifies the resizable direction (&quot;horizontal&quot; or &quot;vertical&quot;); defaults to &quot;horizontal&quot;</p>
+</td>
+    </tr>
+    <tr>
+      <td>disableCursor</td>
+      <td><p>This library sets custom mouse cursor styles to indicate drag state.
+Use this prop to disable that behavior for Panels and Separators in this group.</p>
+</td>
+    </tr>
+    <tr>
+      <td>disabled</td>
+      <td><p>Disable resize functionality.</p>
+</td>
+    </tr>
+    <tr>
+      <td>elementRef</td>
+      <td><p>Ref attached to the root <code>HTMLDivElement</code>.</p>
+</td>
+    </tr>
+    <tr>
+      <td>groupRef</td>
+      <td><p>Exposes the following imperative API:</p>
+<ul>
+<li><code>getLayout(): Layout</code></li>
+<li><code>setLayout(layout: Layout): void</code></li>
+</ul>
+<p>ℹ️ The <code>useGroupRef</code> and <code>useGroupCallbackRef</code> hooks are exported for convenience use in TypeScript projects.</p>
+</td>
+    </tr>
+    <tr>
+      <td>id</td>
+      <td><p>Uniquely identifies this group within an application.
+Falls back to <code>useId</code> when not provided.</p>
+<p>ℹ️ This value will also be assigned to the <code>data-group-id</code> attribute.</p>
+</td>
+    </tr>
+    <tr>
+      <td>onLayoutChange</td>
+      <td><p>Called when panel sizes change; receives a map of Panel id to size.</p>
+</td>
+    </tr>
+    <tr>
+      <td>style</td>
+      <td><p>CSS properties.</p>
+<p>⚠️ The following styles cannot be overridden: <code>display</code>, <code>flex-direction</code>, <code>flex-wrap</code>, and <code>overflow</code>.</p>
+</td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- Group:optional:end -->
+
+### Panel
+
+#### Required props
+
+<!-- Panel:required:begin -->
+
+<!-- Panel:required:end -->
+
+#### Optional props
+
+<!-- Panel:optional:begin -->
+
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>className</td>
+      <td><p>CSS class name.</p>
+<p>⚠️ Class is applied to nested <code>HTMLDivElement</code> to avoid styles that interfere with Flex layout.</p>
+</td>
+    </tr>
+    <tr>
+      <td>collapsedSize</td>
+      <td><p>Panel size when collapsed; defaults to 0.</p>
+</td>
+    </tr>
+    <tr>
+      <td>collapsible</td>
+      <td><p>This panel can be collapsed.</p>
+<p>ℹ️ A collapsible panel will collapse when it&#39;s size is less than of the specified <code>minSize</code></p>
+</td>
+    </tr>
+    <tr>
+      <td>defaultSize</td>
+      <td><p>Default size of Panel within its parent group; default is auto-assigned based on the total number of Panels.</p>
+</td>
+    </tr>
+    <tr>
+      <td>elementRef</td>
+      <td><p>Ref attached to the root <code>HTMLDivElement</code>.</p>
+</td>
+    </tr>
+    <tr>
+      <td>id</td>
+      <td><p>Uniquely identifies this panel within the parent group.
+Falls back to <code>useId</code> when not provided.</p>
+<p>ℹ️ This prop is used to associate persisted group layouts with the original panel.</p>
+<p>ℹ️ This value will also be assigned to the <code>data-panel-id</code> attribute.</p>
+</td>
+    </tr>
+    <tr>
+      <td>maxSize</td>
+      <td><p>Maximum size of Panel within its parent group; defaults to 100%.</p>
+</td>
+    </tr>
+    <tr>
+      <td>minSize</td>
+      <td><p>Minimum size of Panel within its parent group; defaults to 0%.</p>
+</td>
+    </tr>
+    <tr>
+      <td>onResize</td>
+      <td><p>Called when panel sizes change; receives a map of Panel id to size.</p>
+</td>
+    </tr>
+    <tr>
+      <td>panelRef</td>
+      <td><p>Exposes the following imperative API:</p>
+<ul>
+<li><code>collapse(): void</code></li>
+<li><code>expand(): void</code></li>
+<li><code>getSize(): number</code></li>
+<li><code>isCollapsed(): boolean</code></li>
+<li><code>isExpanded(): boolean</code></li>
+<li><code>resize(size: number): void</code></li>
+</ul>
+<p>ℹ️ The <code>usePanelRef</code> and <code>usePanelCallbackRef</code> hooks are exported for convenience use in TypeScript projects.</p>
+</td>
+    </tr>
+    <tr>
+      <td>style</td>
+      <td><p>CSS properties.</p>
+<p>⚠️ Style is applied to nested <code>HTMLDivElement</code> to avoid styles that interfere with Flex layout.</p>
+</td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- Panel:optional:end -->
+
+### Separator
+
+#### Required props
+
+<!-- Separator:required:begin -->
+
+<!-- Separator:required:end -->
+
+#### Optional props
+
+<!-- Separator:optional:begin -->
+
+<table>
+  <thead>
+    <tr>
+      <th>Name</th>
+      <th>Description</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>className</td>
+      <td><p>CSS class name.</p>
+<p>ℹ️ Use the <code>data-separator-state</code> attribute for custom <em>hover</em> and <em>active</em> styles</p>
+<p>⚠️ The following properties cannot be overridden: <code>flex-grow</code>, <code>flex-shrink</code></p>
+</td>
+    </tr>
+    <tr>
+      <td>elementRef</td>
+      <td><p>Ref attached to the root <code>HTMLDivElement</code>.</p>
+</td>
+    </tr>
+    <tr>
+      <td>id</td>
+      <td><p>Uniquely identifies the separator within the parent group.
+Falls back to <code>useId</code> when not provided.</p>
+<p>ℹ️ This value will also be assigned to the <code>data-separator-id</code> attribute.</p>
+</td>
+    </tr>
+    <tr>
+      <td>style</td>
+      <td><p>CSS properties.</p>
+<p>ℹ️ Use the <code>data-separator-state</code> attribute for custom <em>hover</em> and <em>active</em> styles</p>
+<p>⚠️ The following properties cannot be overridden: <code>flex-grow</code>, <code>flex-shrink</code></p>
+</td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- Separator:optional:end -->

package/dist/react-resizable-panels.cjs

@@ -0,0 +1,2 @@
+"use client";"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const $=require("react/jsx-runtime"),h=require("react");function be(e,t){const n=getComputedStyle(e),o=parseFloat(n.fontSize);return t*o}function we(e,t){const n=getComputedStyle(e.ownerDocument.body),o=parseFloat(n.fontSize);return t*o}function Re(e){return e/100*window.innerHeight}function Le(e){return e/100*window.innerWidth}function Pe(e){switch(typeof e){case"number":return[e,"px"];case"string":{const t=parseFloat(e);return e.endsWith("%")?[t,"%"]:e.endsWith("px")?[t,"px"]:e.endsWith("rem")?[t,"rem"]:e.endsWith("em")?[t,"em"]:e.endsWith("vh")?[t,"vh"]:e.endsWith("vw")?[t,"vw"]:[t,"%"]}}}function F({groupSize:e,panelElement:t,styleProp:n}){let o;const[r,i]=Pe(n);switch(i){case"%":{o=r/100*e;break}case"px":{o=r;break}case"rem":{o=we(t,r);break}case"em":{o=be(t,r);break}case"vh":{o=Re(r);break}case"vw":{o=Le(r);break}}return o}function L(e){return parseFloat(e.toFixed(3))}function X({group:e}){const{direction:t,panels:n}=e;return n.reduce((o,r)=>(o+=t==="horizontal"?r.element.offsetWidth:r.element.offsetHeight,o),0)}function oe(e){const{panels:t}=e,n=X({group:e});return t.map(o=>{const{element:r,panelConstraints:i}=o;let a=0;if(i.collapsedSize){const u=F({groupSize:n,panelElement:r,styleProp:i.collapsedSize});a=L(u/n*100)}let s;if(i.defaultSize){const u=F({groupSize:n,panelElement:r,styleProp:i.defaultSize});s=L(u/n*100)}let l=0;if(i.minSize){const u=F({groupSize:n,panelElement:r,styleProp:i.minSize});l=L(u/n*100)}let c=100;if(i.maxSize){const u=F({groupSize:n,panelElement:r,styleProp:i.maxSize});c=L(u/n*100)}return{collapsedSize:a,collapsible:i.collapsible===!0,defaultSize:s,minSize:l,maxSize:c,panelId:o.id}})}class Ce{#e={};addListener(t,n){const o=this.#e[t];return o===void 0?this.#e[t]=[n]:o.includes(n)||o.push(n),()=>{this.removeListener(t,n)}}emit(t,n){const o=this.#e[t];if(o!==void 0)if(o.length===1)o[0].call(null,n);else{let r=!1,i=null;const a=Array.from(o);for(let s=0;s<a.length;s++){const l=a[s];try{l.call(null,n)}catch(c){i===null&&(r=!0,i=c)}}if(r)throw i}}removeAllListeners(){this.#e={}}removeListener(t,n){const o=this.#e[t];if(o!==void 0){const r=o.indexOf(n);r>=0&&o.splice(r,1)}}}let E={cursorFlags:0,interactionState:{state:"inactive"},mountedGroups:new Map};const D=new Ce;function I(){return E}function M(e){const t=typeof e=="function"?e(E):e;return E===t||(E={...E,...t},t.cursorFlags!==void 0&&D.emit("cursorFlagsChange",E.cursorFlags),t.interactionState!==void 0&&D.emit("interactionStateChange",E.interactionState),t.mountedGroups!==void 0&&D.emit("mountedGroupsChange",E.mountedGroups)),E}const Ee=e=>e,U=()=>{},le=1,ce=2,ue=4,fe=8,ie={coarse:10,precise:5};function Ge(e){const{direction:t,element:n,panels:o,separators:r}=e,i=Array.from(n.children).filter(c=>c instanceof HTMLElement).sort((c,u)=>{const f=c.getBoundingClientRect(),p=u.getBoundingClientRect();return t==="horizontal"?f.left-p.left:f.top-p.top}),a=[];let s,l;for(const c of i){const u=o.find(f=>f.element===c);if(u){if(s){const f=s.element.getBoundingClientRect(),p=c.getBoundingClientRect();a.push({group:e,panels:[s,u],separator:l,rect:t==="horizontal"?new DOMRect(f.right,p.top,p.left-f.right,p.height):new DOMRect(p.left,f.bottom,p.width,p.top-f.bottom)})}s=u}else{const f=r.find(p=>p.element===c);f?l=f:(s=void 0,l=void 0)}}return a}function Me(e,t){return{x:e.x>=t.left&&e.x<=t.right?0:Math.min(Math.abs(e.x-t.left),Math.abs(e.x-t.right)),y:e.y>=t.top&&e.y<=t.bottom?0:Math.min(Math.abs(e.y-t.top),Math.abs(e.y-t.bottom))}}function Ie(e,t,n){let o,r={x:1/0,y:1/0};for(const i of t){const a=Me(n,i.rect);switch(e){case"horizontal":{a.x<=r.x&&(o=i,r=a);break}case"vertical":{a.y<=r.y&&(o=i,r=a);break}}}return o?{distance:r,hitRegion:o}:void 0}let H;function ke(){return H===void 0&&(typeof matchMedia=="function"?H=!!matchMedia("(pointer:coarse)").matches:H=!1),H}function de(e,t){const n=[];return t.forEach((o,r)=>{if(r.disabled)return;const i=ke()?ie.coarse:ie.precise,a=Ge(r),s=Ie(r.direction,a,{x:e.clientX,y:e.clientY});s&&s.distance.x<=i&&s.distance.y<=i&&n.push(s.hitRegion)}),n}function se(e){if(e.defaultPrevented)return;const{mountedGroups:t}=I(),n=de(e,t),o=new Set,r=new Set,i=new Set,a=new Map;n.forEach(s=>{o.add(s.group),s.panels.forEach(c=>{r.add(c)}),s.separator&&i.add(s.separator);const l=t.get(s.group);l&&a.set(s.group,l.layout)}),M({interactionState:{hitRegions:n,initialLayoutMap:a,pointerDownAtPoint:{x:e.clientX,y:e.clientY},state:"active"}}),n.length&&e.preventDefault()}function Oe({cursorFlags:e,groups:t,state:n}){let o=0,r=0;switch(n){case"active":case"hover":t.forEach(i=>{if(!i.disableCursor)switch(i.direction){case"horizontal":{o++;break}case"vertical":{r++;break}}})}if(o===0&&r===0)return null;switch(n){case"active":{const i=(e&le)!==0,a=(e&ce)!==0,s=(e&ue)!==0,l=(e&fe)!==0;if(e){if(i)return s?"se-resize":l?"ne-resize":"e-resize";if(a)return s?"sw-resize":l?"nw-resize":"w-resize";if(s)return"s-resize";if(l)return"n-resize"}break}}return o>0&&r>0?"move":o>0?"ew-resize":"ns-resize"}let K=null,C;function V(){C===void 0&&(C=new CSSStyleSheet,document.adoptedStyleSheets=[C]);const{cursorFlags:e,interactionState:t}=I();switch(t.state){case"active":case"hover":{const n=Oe({cursorFlags:e,groups:t.hitRegions.map(o=>o.group),state:t.state});if(K===n)return;K=n,n?C.cssRules.length===0?C.insertRule(`*{cursor: ${n} !important;}`):C.replaceSync(`*{cursor: ${n} !important;}`):C.cssRules.length===1&&C.deleteRule(0);break}case"inactive":{K=null,C.cssRules.length===1&&C.deleteRule(0);break}}}function G(e,t="Assertion error"){if(!e)throw console.error(t),Error(t)}function Ae(e,t){if(e.length!==t.length)return!1;for(let n=0;n<e.length;n++)if(e[n]!=t[n])return!1;return!0}function R(e,t,n=0){return Math.abs(L(e)-L(t))<=n}function q(e,t){return R(e,t)?0:e>t?1:-1}function T({panelConstraints:e,size:t}){const{collapsedSize:n=0,collapsible:o,maxSize:r=100,minSize:i=0}=e;if(q(t,i)<0)if(o){const a=(n+i)/2;q(t,a)<0?t=n:t=i}else t=i;return t=Math.min(r,t),t=L(t),t}function Ne({delta:e,initialLayout:t,panelConstraints:n,pivotIndices:o,prevLayout:r,trigger:i}){if(R(e,0))return t;const a=Object.values(t),s=Object.values(r),l=[...a],[c,u]=o;G(c!=null,"Invalid first pivot index"),G(u!=null,"Invalid second pivot index");let f=0;{const v=e<0?1:-1;let d=e<0?u:c,g=0;for(;;){const z=a[d];G(z!=null,`Previous layout not found for panel index ${d}`);const S=T({panelConstraints:n[d],size:100})-z;if(g+=S,d+=v,d<0||d>=n.length)break}const x=Math.min(Math.abs(e),Math.abs(g));e=e<0?0-x:x}{let d=e<0?c:u;for(;d>=0&&d<n.length;){const g=Math.abs(e)-Math.abs(f),x=a[d];G(x!=null,`Previous layout not found for panel index ${d}`);const z=x-g,b=T({panelConstraints:n[d],size:z});if(!R(x,b)&&(f+=x-b,l[d]=b,f.toFixed(3).localeCompare(Math.abs(e).toFixed(3),void 0,{numeric:!0})>=0))break;e<0?d--:d++}}if(Ae(s,l))return r;{const v=e<0?u:c,d=a[v];G(d!=null,`Previous layout not found for panel index ${v}`);const g=d+f,x=T({panelConstraints:n[v],size:g});if(l[v]=x,!R(x,g)){let z=g-x,S=e<0?u:c;for(;S>=0&&S<n.length;){const P=l[S];G(P!=null,`Previous layout not found for panel index ${S}`);const k=P+z,O=T({panelConstraints:n[S],size:k});if(R(P,O)||(z-=O-P,l[S]=O),R(z,0))break;e>0?S--:S++}}}const p=Object.values(l).reduce((v,d)=>d+v,0);if(!R(p,100,.1))return r;const m=Object.keys(r);return l.reduce((v,d,g)=>(v[m[g]]=d,v),{})}function Y(e,t){if(Object.keys(e).length!==Object.keys(t).length)return!1;for(const n in e)if(q(e[n],t[n])!==0)return!1;return!0}function B(e){if(e.defaultPrevented)return;const{interactionState:t,mountedGroups:n}=I();switch(t.state){case"active":{if(e.type!=="pointerleave"&&e.buttons===0){M(i=>i.interactionState.state==="inactive"?i:{cursorFlags:0,interactionState:{state:"inactive"}});return}let o=0;const r=new Map(n);t.hitRegions.forEach(i=>{const{direction:a,disableCursor:s,element:l,panels:c}=i.group;let u=0;t.state==="active"&&(a==="horizontal"?u=(e.clientX-t.pointerDownAtPoint.x)/l.offsetWidth*100:u=(e.clientY-t.pointerDownAtPoint.y)/l.offsetHeight*100);const f=t.initialLayoutMap.get(i.group),{derivedPanelConstraints:p,layout:m}=n.get(i.group)??{};if(p&&f&&m){const v=Ne({delta:u,initialLayout:f,panelConstraints:p,pivotIndices:i.panels.map(d=>c.indexOf(d)),prevLayout:m,trigger:"mouse-or-touch"});if(Y(v,m)){if(u!==0&&!s)switch(a){case"horizontal":{o|=u<0?le:ce;break}case"vertical":{o|=u<0?ue:fe;break}}}else{r.set(i.group,{derivedPanelConstraints:p,layout:v});const d=i.group.panels.map(({id:g})=>g).join(",");i.group.inMemoryLayouts[d]=v}}}),M({cursorFlags:o,mountedGroups:r}),V();break}default:{const o=de(e,n);o.length===0?t.state!=="inactive"&&M({interactionState:{state:"inactive"}}):M({interactionState:{hitRegions:o,state:"hover"}}),V();break}}}function re(e){if(e.defaultPrevented)return;e.preventDefault();const{interactionState:t}=I();switch(t.state){case"active":M({cursorFlags:0,interactionState:{state:"inactive"}}),V()}}function Te(e){let t=0,n=0;const o={};for(const i of e)if(i.defaultSize!==void 0){t++;const a=L(i.defaultSize);n+=a,o[i.panelId]=a}else o[i.panelId]=void 0;const r=e.length-t;if(r!==0){const i=L((100-n)/r);for(const a of e)a.defaultSize===void 0&&(o[a.panelId]=i)}return o}function De(e,t,n){const o=n[0];if(!o)return;const r=e.panels.find(a=>a.element===t);if(!r||!r.onResize)return;const i=X({group:e});r.onResize({asPercentage:L(o.inlineSize/i*100),inPixels:o.inlineSize})}function pe({layout:e,panelConstraints:t}){const o=[...Object.values(e)],r=o.reduce((s,l)=>s+l,0);if(o.length!==t.length)throw Error(`Invalid ${t.length} panel layout: ${o.map(s=>`${s}%`).join(", ")}`);if(!R(r,100)&&o.length>0)for(let s=0;s<t.length;s++){const l=o[s];G(l!=null,`No layout data found for index ${s}`);const c=100/r*l;o[s]=c}let i=0;for(let s=0;s<t.length;s++){const l=o[s];G(l!=null,`No layout data found for index ${s}`);const c=T({panelConstraints:t[s],size:l});l!=c&&(i+=l-c,o[s]=c)}if(!R(i,0))for(let s=0;s<t.length;s++){const l=o[s];G(l!=null,`No layout data found for index ${s}`);const c=l+i,u=T({panelConstraints:t[s],size:c});if(l!==u&&(i-=u-l,o[s]=u,R(i,0)))break}const a=Object.keys(e);return o.reduce((s,l,c)=>(s[a[c]]=l,s),{})}function _e(e){let t=!1;const n=new ResizeObserver(l=>{for(const c of l){const{borderBoxSize:u,target:f}=c;f===e.element?t&&M(p=>{const m=p.mountedGroups.get(e);return m?{mountedGroups:new Map(p.mountedGroups).set(e,{derivedPanelConstraints:oe(e),layout:m.layout})}:p}):De(e,f,u)}});n.observe(e.element),e.panels.forEach(l=>{l.onResize&&n.observe(l.element)});const o=oe(e),r=e.panels.map(({id:l})=>l).join(","),i=e.inMemoryLayouts[r]??e.defaultLayout??Te(o),a=pe({layout:i,panelConstraints:o}),s=M(l=>({mountedGroups:new Map(l.mountedGroups).set(e,{derivedPanelConstraints:o,layout:a})}));return t=!0,s.mountedGroups.size===1&&(window.addEventListener("pointerdown",se),window.addEventListener("pointerleave",B),window.addEventListener("pointermove",B),window.addEventListener("pointerup",re)),function(){const c=M(u=>{const f=new Map(u.mountedGroups);return f.delete(e),{mountedGroups:f}});t=!1,c.mountedGroups.size===0&&(window.removeEventListener("pointerdown",se),window.removeEventListener("pointerleave",B),window.removeEventListener("pointermove",B),window.removeEventListener("pointerup",re)),n.disconnect()}}function Z(e){const t=h.useId();return`${e??t}`}const _=typeof window<"u"?h.useLayoutEffect:h.useEffect;function J(e){const t=h.useRef(e);return _(()=>{t.current=e},[e]),h.useCallback(n=>t.current?.(n),[t])}function Q(...e){return J(t=>{e.forEach(n=>{if(n)switch(typeof n){case"function":{n(t);break}case"object":{n.current=t;break}}})})}const he="--react-resizable-panels--panel--pointer-events";function me(e,t){const n=e.replace(/[^a-zA-Z0-9\-_]/g,""),o=t.replace(/[^a-zA-Z0-9\-_]/g,"");return`--react-resizable-panels--${n}--${o}`}const ve=h.createContext(null);function ae(e,t){return t.sort(e==="horizontal"?(n,o)=>n.element.offsetLeft-o.element.offsetLeft:(n,o)=>n.element.offsetTop-o.element.offsetTop)}function $e({groupId:e}){const t=()=>{const{mountedGroups:n}=I();for(const[o,{derivedPanelConstraints:r,layout:i}]of n)if(o.id===e)return{derivedPanelConstraints:r,group:o,layout:i};throw Error(`Group ${e} not found`)};return{getLayout(){const{layout:n}=t();return n},setLayout(n){const{derivedPanelConstraints:o,group:r,layout:i}=t(),a=pe({layout:n,panelConstraints:o});return Y(i,a)||M(s=>({mountedGroups:new Map(s.mountedGroups).set(r,{derivedPanelConstraints:o,layout:a})})),a}}}function je(e,t){const n=h.useRef({getLayout:()=>({}),setLayout:Ee});h.useImperativeHandle(t,()=>n.current,[]),_(()=>{Object.assign(n.current,$e({groupId:e}))})}function Fe({children:e,className:t,defaultLayout:n,direction:o="horizontal",disableCursor:r,disabled:i,elementRef:a,groupRef:s,id:l,onLayoutChange:c,style:u}){const f=h.useRef({}),p=J(y=>{Y(f.current,y)||(f.current=y,c?.(y))}),m=Z(l),[v,d]=h.useState(!1),[g,x]=h.useState(null),z=h.useRef({}),[b,S]=h.useState(n??{}),[P,k]=h.useState([]),[O,te]=h.useState([]),ye=Q(x,a);je(m,s);const Se=h.useMemo(()=>({direction:o,id:m,registerPanel:y=>(k(w=>ae(o,[...w,y])),()=>{k(w=>w.filter(A=>A!==y))}),registerSeparator:y=>(te(w=>ae(o,[...w,y])),()=>{te(w=>w.filter(A=>A!==y))})}),[o,m]);_(()=>{if(g!==null&&P.length>0){const y={defaultLayout:n,direction:o,disableCursor:!!r,disabled:!!i,element:g,id:m,inMemoryLayouts:z.current,panels:P,separators:O},w=_e(y),W=I().mountedGroups.get(y);W&&(S(W.layout),p?.(W.layout));const xe=D.addListener("interactionStateChange",j=>{switch(j.state){case"active":case"hover":{d(j.hitRegions.some(N=>N.group===y));break}}}),ze=D.addListener("mountedGroupsChange",j=>{const N=j.get(y);N&&N.derivedPanelConstraints.length>0&&(S(N.layout),p?.(N.layout))});return()=>{w(),xe(),ze()}}},[n,o,r,i,g,m,p,P,O]);const ne={[he]:v?"none":void 0};for(const y in b){const w=me(m,y),A=b[y];ne[w]=A}return $.jsx(ve.Provider,{value:Se,children:$.jsx("div",{className:t,"data-group":!0,"data-group-id":m,"data-group-direction":o,ref:ye,style:{...u,...ne,display:"flex",flexDirection:o==="horizontal"?"row":"column",flexWrap:"nowrap",overflow:"hidden"},children:e})})}function ge(e){return`react-resizable-panels:${e}`}function He({id:e,storage:t}){try{const n=ge(e),o=t.getItem(n);if(o)return JSON.parse(o)}catch(n){console.error(n)}}function Be({id:e,layout:t,storage:n}){try{const o=ge(e);n.setItem(o,JSON.stringify(t))}catch(o){console.error(o)}}function We({groupId:e,storage:t=localStorage}){const n=h.useRef(null);n.current===null&&(n.current=He({id:e,storage:t}));const o=h.useCallback(r=>Be({id:e,layout:r,storage:t}),[e,t]);return{defaultLayout:n.current,onLayoutChange:o}}function Ue(){return h.useState(null)}function Ke(){return h.useRef(null)}function ee(){const e=h.useContext(ve);return G(e,"Unexpected"),e}function Ve({groupId:e,panelId:t}){const n=()=>{const{mountedGroups:a}=I();for(const[s,{derivedPanelConstraints:l,layout:c}]of a)if(s.id===e)return{derivedPanelConstraints:l,group:s,layout:c};throw Error(`Group ${e} not found`)},o=()=>{const a=n().derivedPanelConstraints.find(s=>s.panelId===t);if(a!==void 0)return a;throw Error(`Panel constraints not found for Panel ${t}`)},r=()=>{const a=n().group.panels.find(s=>s.id===t);if(a!==void 0)return a;throw Error(`Layout not found for Panel ${t}`)},i=()=>{const a=n().layout[t];if(a!==void 0)return a;throw Error(`Layout not found for Panel ${t}`)};return{collapse:()=>{const{collapsible:a,collapsedSize:s}=o();i()},expand:()=>{const{collapsible:a,collapsedSize:s,minSize:l}=o();i()},getSize:()=>{const{group:a}=n(),s=i(),{element:l}=r(),c=a.direction==="horizontal"?l.offsetWidth:l.offsetHeight;return{asPercentage:s,inPixels:c}},isCollapsed:()=>{const{collapsible:a,collapsedSize:s}=o(),l=i();return a&&R(s,l)},resize:a=>{if(i()!==a)switch(typeof a){case"number":{const{group:l}=n(),c=X({group:l});L(a/c*100);break}}}}}function qe(e,t){const{id:n}=ee(),o=h.useRef({collapse:U,expand:U,getSize:()=>({asPercentage:0,inPixels:0}),isCollapsed:()=>!1,resize:U});h.useImperativeHandle(t,()=>o.current,[]),_(()=>{Object.assign(o.current,Ve({groupId:n,panelId:e}))})}function Xe({children:e,className:t,collapsedSize:n=0,collapsible:o=!1,defaultSize:r,elementRef:i,id:a,maxSize:s="100",minSize:l="0",onResize:c,panelRef:u,style:f}){const p=!!a,m=Z(a),[v,d]=h.useState(null),g=Q(d,i),{id:x,registerPanel:z}=ee(),b=c!==null,S=J(k=>{c?.(k)});_(()=>{if(v!==null)return z({element:v,id:m,idIsStable:p,onResize:b?S:void 0,panelConstraints:{collapsedSize:n,collapsible:o,defaultSize:r,maxSize:s,minSize:l}})},[n,o,r,v,b,m,p,s,l,S,z]),qe(m,u);const P=me(x,m);return $.jsx("div",{"data-panel":!0,"data-panel-id":m,ref:g,style:{flexBasis:0,flexGrow:`var(${P}, 1)`,flexShrink:1,overflow:"hidden",pointerEvents:`var(${he})`},children:$.jsx("div",{className:t,style:{width:"100%",height:"100%",...f},children:e})})}function Ye(){return h.useState(null)}function Ze(){return h.useRef(null)}function Je({children:e,className:t,elementRef:n,id:o,style:r}){const i=Z(o),[a,s]=h.useState(null),[l,c]=h.useState("inactive"),u=Q(s,n),{registerSeparator:f}=ee();return _(()=>{if(a!==null){const p={element:a,id:i},m=f(p),v=D.addListener("interactionStateChange",d=>{c(d.state!=="inactive"&&d.hitRegions.some(g=>g.separator===p)?d.state:"inactive")});return()=>{m(),v()}}},[a,i,f]),$.jsx("div",{children:e,className:t,"data-separator":!0,"data-separator-id":i,"data-separator-state":l,ref:u,style:{flexBasis:"auto",...r,flexGrow:0,flexShrink:0}})}exports.Group=Fe;exports.Panel=Xe;exports.Separator=Je;exports.useDefaultLayout=We;exports.useGroupCallbackRef=Ue;exports.useGroupRef=Ke;exports.usePanelCallbackRef=Ye;exports.usePanelRef=Ze;
+//# sourceMappingURL=react-resizable-panels.cjs.map