regular-layout 0.2.2 → 0.4.0

package/dist/layout/calculate_edge.d.ts

@@ -1,8 +1,8 @@
-import { type Physics } from "./constants";
-import type { Layout, LayoutPath } from "./types";
+import { type Physics } from "../core/constants";
+import type { Layout, LayoutPath } from "../core/types";
 /**
  * Calculates an insertion point (which may involve splitting a single
- * `"child-panel"` into a new `"split-panel"`), based on the  cursor position.
+ * `"tab-layout"` into a new `"split-layout"`), based on the  cursor position.
  * *
  * @param col - The cursor column.
  * @param row - The cursor row.
@@ -10,7 +10,7 @@ import type { Layout, LayoutPath } from "./types";
  * @param slot - The slot identifier where the insert should occur
  * @param drop_target - The `LayoutPath` (from `calculateIntersect`) of the
  * panel to either insert next to, or split by.
- * @returns A new `LayoutPath` reflecting the updated (maybe) `"split-panel"`,
+ * @returns A new `LayoutPath` reflecting the updated (maybe) `"split-layout"`,
  * which is enough to draw the overlay.
  */
 export declare function calculate_edge(col: number, row: number, panel: Layout, slot: string, drop_target: LayoutPath, box?: DOMRect, physics?: Physics): LayoutPath;

package/dist/layout/calculate_intersect.d.ts

@@ -1,4 +1,4 @@
-import type { LayoutPath, LayoutDivider, Layout } from "./types.ts";
+import type { LayoutPath, LayoutDivider, Layout } from "../core/types.ts";
 /**
  * Determines which panel or divider is located at a given position in the
  * layout.

package/dist/layout/calculate_path.d.ts

@@ -0,0 +1,12 @@
+import type { Layout } from "../core/types.ts";
+/**
+ * Calculates the index path for a panel with the given name.
+ *
+ * Traverses the layout tree to find the named panel and returns the
+ * index path describing its position in the tree.
+ *
+ * @param name - The name of the panel to find.
+ * @param layout - The layout tree to search.
+ * @returns The panel's index path if found, `null` otherwise.
+ */
+export declare function calculate_path(name: string, layout: Layout): number[] | null;

package/dist/layout/calculate_presize_paths.d.ts

@@ -0,0 +1,10 @@
+import type { Layout, LayoutPath } from "../core/types.ts";
+/**
+ * Walks a layout tree and returns a {@link LayoutPath} for every visible
+ * panel, keyed by panel name. Each path's `column`/`row` are set to the
+ * center of the panel's view window, with offsets of 0.5.
+ *
+ * @param layout - The layout tree to walk.
+ * @returns A record mapping panel names to their layout paths.
+ */
+export declare function calculate_presize_paths(layout: Layout): Record<string, LayoutPath>;

package/dist/layout/flatten.d.ts

@@ -1,4 +1,4 @@
-import type { Layout } from "./types.ts";
+import type { Layout } from "../core/types.ts";
 /**
  * Flattens the layout tree by merging parent and child split panels that have
  * the same orientation and type.

package/dist/layout/generate_grid.d.ts

@@ -1,5 +1,5 @@
-import { type Physics } from "./constants.ts";
-import type { Layout } from "./types.ts";
+import { type Physics } from "../core/constants.ts";
+import type { Layout } from "../core/types.ts";
 /**
  * Generates CSS Grid styles to render a layout tree.
  * Creates grid-template-rows, grid-template-columns, and positioning rules for
@@ -14,11 +14,11 @@ import type { Layout } from "./types.ts";
  * @example
  * ```typescript
  * const layout = {
- *   type: "split-panel",
+ *   type: "split-layout",
  *   orientation: "horizontal",
  *   children: [
- *     { type: "child-panel", tabs: "sidebar" },
- *     { type: "child-panel", tabs: "main" }
+ *     { type: "tab-layout", tabs: "sidebar" },
+ *     { type: "tab-layout", tabs: "main" }
  *   ],
  *   sizes: [0.25, 0.75]
  * };

package/dist/layout/generate_overlay.d.ts

@@ -1,2 +1,18 @@
-import type { LayoutPath } from "./types";
-export declare function updateOverlaySheet(slot: string, box: DOMRect, style: CSSStyleDeclaration, drag_target: LayoutPath | null, physics?: import("./constants").Physics): string;
+import type { LayoutPath, ViewWindow } from "../core/types";
+/**
+ * Converts a {@link ViewWindow} to element-relative pixel coordinates,
+ * accounting for padding and optionally CSS `gap` and child `margin`.
+ *
+ * @param window - The view window in normalized 0–1 coordinates.
+ * @param box - The element's bounding client rect.
+ * @param style - The element's computed style (for padding).
+ * @param margin - Optional child element's computed style (for margin inset).
+ * @returns Pixel coordinates relative to the element's border-box origin.
+ */
+export declare function viewWindowToLocalRect(window: ViewWindow, box: DOMRect, style: CSSStyleDeclaration, margin?: CSSStyleDeclaration): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export declare function updateOverlaySheet(slot: string, box: DOMRect, style: CSSStyleDeclaration, drag_target: LayoutPath | null, physics?: import("../core/constants").Physics, margin?: CSSStyleDeclaration): string;

package/dist/layout/insert_child.d.ts

@@ -1,4 +1,4 @@
-import type { Layout } from "./types.ts";
+import type { Layout, LayoutPathTraversal } from "../core/types.ts";
 /**
  * Inserts a new child panel into the layout tree at a specified location.
  * Creates a split panel if necessary and redistributes sizes equally among all
@@ -13,4 +13,4 @@ import type { Layout } from "./types.ts";
  * @param is_edge - If true, create the split at the parent level.
  * @returns A new layout tree with the child inserted (original is not mutated).
  */
-export declare function insert_child(panel: Layout, child: string, path: number[], orientation?: "horizontal" | "vertical"): Layout;
+export declare function insert_child(panel: Layout, child: string, path: LayoutPathTraversal, orientation?: "horizontal" | "vertical"): Layout;

package/dist/layout/redistribute_panel_sizes.d.ts

@@ -1,4 +1,4 @@
-import type { Layout } from "./types.ts";
+import type { Layout, LayoutPathTraversal } from "../core/types.ts";
 /**
  * Adjusts panel sizes during a drag operation on a divider.
  *
@@ -16,4 +16,4 @@ import type { Layout } from "./types.ts";
  * @returns A new layout tree with updated sizes (original is not mutated).
  * ```
  */
-export declare function redistribute_panel_sizes(panel: Layout, path: number[], delta: number | undefined, physics?: import("./constants.ts").Physics): Layout;
+export declare function redistribute_panel_sizes(panel: Layout, path: LayoutPathTraversal, delta: number | undefined, physics?: import("../core/constants.ts").Physics): Layout;

package/dist/layout/remove_child.d.ts

@@ -1,4 +1,4 @@
-import type { Layout } from "./types.ts";
+import type { Layout } from "../core/types.ts";
 /**
  * Removes a child panel from the layout tree by its name.
  *

package/dist/model/overlay_controller.d.ts

@@ -0,0 +1,34 @@
+import type { Layout, LayoutPath, OverlayMode } from "../core/types.ts";
+import type { Physics } from "../core/constants.ts";
+import type { PresizeQueue } from "./presize_queue.ts";
+export interface OverlayHost {
+    readonly panel: Layout;
+    readonly physics: Physics;
+    readonly stylesheet: CSSStyleSheet;
+    readonly presizeQueue: PresizeQueue;
+    relativeCoordinates(event: {
+        clientX: number;
+        clientY: number;
+    }, recalculate: boolean): [number, number, DOMRect, CSSStyleDeclaration];
+    restore(layout: Layout, isFlattened?: boolean): Promise<void>;
+    querySelector(selectors: string): Element | null;
+    dispatchEvent(event: Event): boolean;
+}
+/**
+ * Manages overlay state during drag-and-drop panel rearrangement.
+ *
+ * Handles rendering a preview of where a dragged panel would land,
+ * and committing or cancelling the placement when the drag ends.
+ */
+export declare class OverlayController {
+    private _host;
+    constructor(_host: OverlayHost);
+    set(event: {
+        clientX: number;
+        clientY: number;
+    }, { slot }: LayoutPath, className?: string, mode?: OverlayMode): Promise<void>;
+    clear(event: {
+        clientX: number;
+        clientY: number;
+    } | null, { slot, layout }: LayoutPath, className?: string): Promise<void>;
+}

package/dist/model/presize_queue.d.ts

@@ -0,0 +1,17 @@
+import type { Layout } from "../core/types.ts";
+/**
+ * Manages cancelable pre-resize gating for layout updates.
+ *
+ * Before each layout change, a cancelable `resize-before` event is dispatched
+ * on the target. If the event is cancelled via `preventDefault()`, the update
+ * is suspended until {@link resume} is called. Concurrent updates are queued
+ * and processed sequentially.
+ */
+export declare class PresizeQueue {
+    #private;
+    private _target;
+    private _eventName;
+    constructor(_target: EventTarget, _eventName: string);
+    run(layout: Layout, fn: () => void): Promise<void>;
+    resume(): void;
+}

package/dist/regular-layout-tab.d.ts

@@ -1,4 +1,4 @@
-import type { TabLayout } from "./layout/types.ts";
+import type { TabLayout } from "./core/types.ts";
 import type { RegularLayout } from "./regular-layout.ts";
 /**
  * A custom HTML element representing an individual tab in a tab panel.

package/dist/regular-layout.d.ts

@@ -1,5 +1,5 @@
-import type { LayoutPath, Layout, TabLayout, OverlayMode, Orientation } from "./layout/types.ts";
-import { type PhysicsUpdate, type Physics } from "./layout/constants.ts";
+import type { LayoutPath, Layout, TabLayout, OverlayMode, Orientation, LayoutPathTraversal, ViewWindow } from "./core/types.ts";
+import { type PhysicsUpdate, type Physics } from "./core/constants.ts";
 /**
  * An interface which models the fields of `PointerEvent` that
  * `<regular-layour>` actually uses, making it easier to sub out with an
@@ -67,6 +67,8 @@ export declare class RegularLayout extends HTMLElement {
     private _cursor_override;
     private _dimensions?;
     private _physics;
+    private _presizeQueue;
+    private _overlayController;
     constructor();
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -78,6 +80,13 @@ export declare class RegularLayout extends HTMLElement {
      * @returns Panel information if a panel is at that position, null otherwise.
      */
     calculateIntersect: (coordinates: PointerEventCoordinates) => LayoutPath | null;
+    /**
+     * Calculates the index path for a panel with the given name.
+     *
+     * @param name - The name of the panel to find.
+     * @returns The panel's index path if found, `null` otherwise.
+     */
+    calculatePath: (name: string) => number[] | null;
     /**
      * Sets the visual overlay state during drag-and-drop operations.
      * Displays a preview of where a panel would be placed at the given coordinates.
@@ -92,7 +101,7 @@ export declare class RegularLayout extends HTMLElement {
      *     the target, "absolute" positions the panel absolutely. Defaults to
      *     "absolute".
      */
-    setOverlayState: (event: PointerEventCoordinates, { slot }: LayoutPath, className?: string, mode?: OverlayMode) => void;
+    setOverlayState: (event: PointerEventCoordinates, target: LayoutPath, className?: string, mode?: OverlayMode) => Promise<void>;
     /**
      * Clears the overlay state and commits the panel placement.
      *
@@ -105,7 +114,7 @@ export declare class RegularLayout extends HTMLElement {
      * @param mode - Overlay rendering mode that was used, must match the mode
      *     passed to `setOverlayState`. Defaults to "absolute".
      */
-    clearOverlayState: (event: PointerEventCoordinates | null, { slot, layout }: LayoutPath, className?: string) => void;
+    clearOverlayState: (event: PointerEventCoordinates | null, target: LayoutPath, className?: string) => Promise<void>;
     /**
      * Inserts a new panel into the layout at a specified path.
      *
@@ -117,13 +126,13 @@ export declare class RegularLayout extends HTMLElement {
      *     the new `SplitPanel` _if_ there is an option of orientation (e.g. if
      *     the layout had no pre-existing `SplitPanel`)
      */
-    insertPanel: (name: string, path?: number[], split?: boolean | Orientation) => void;
+    insertPanel: (name: string, path?: LayoutPathTraversal, split?: boolean | Orientation) => Promise<void>;
     /**
      * Removes a panel from the layout by name.
      *
      * @param name - Name of the panel to remove
      */
-    removePanel: (name: string) => void;
+    removePanel: (name: string) => Promise<void>;
     /**
      * Retrieves a panel by name from the layout tree.
      *
@@ -135,20 +144,36 @@ export declare class RegularLayout extends HTMLElement {
     /**
      * Clears the entire layout, unslotting all panels.
      */
-    clear: () => void;
+    clear: () => Promise<void>;
+    /**
+     * Restores the layout from a saved state synchronously, without
+     * dispatching the `regular-layout-before-resize` event.
+     *
+     * @param layout - The layout tree to restore
+     */
+    restoreSync: (layout: Layout, _is_flattened?: boolean) => void;
     /**
      * Restores the layout from a saved state.
      *
+     * Before applying, dispatches a cancelable `regular-layout-before-resize`
+     * event. If the event is cancelled via `preventDefault()`, the layout
+     * update is suspended until {@link resumeResize} is called.
+     *
      * @param layout - The layout tree to restore
      *
      * @example
      * ```typescript
      * const layout = document.querySelector('regular-layout');
      * const savedState = JSON.parse(localStorage.getItem('layout'));
-     * layout.restore(savedState);
+     * await layout.restore(savedState);
      * ```
      */
-    restore: (layout: Layout, _is_flattened?: boolean) => void;
+    restore: (layout: Layout, _is_flattened?: boolean) => Promise<void>;
+    /**
+     * Resumes a layout update that was suspended by cancelling the
+     * `regular-layout-before-resize` event.
+     */
+    resumeResize: () => void;
     /**
      * Serializes the current layout state, which can be restored via `restore`.
      *
@@ -188,6 +213,15 @@ export declare class RegularLayout extends HTMLElement {
      *   - box: The layout element's bounding rectangle
      */
     relativeCoordinates: (event: PointerEventCoordinates, recalculate_bounds?: boolean) => [number, number, DOMRect, CSSStyleDeclaration];
+    /**
+     * Converts a {@link ViewWindow} (normalized 0–1 coordinates) to a
+     * `DOMRect` in screen pixels, accounting for padding and optionally
+     * CSS `gap` and child `margin`.
+     *
+     * @param window - The view window to convert.
+     * @returns A `DOMRect` representing the window in screen coordinates.
+     */
+    realCoordinates: (window: ViewWindow, child?: HTMLElement) => DOMRect;
     /**
      * Calculates the Euclidean distance in pixels between the current pointer
      * coordinates and a drag target's position within the layout.
@@ -199,6 +233,7 @@ export declare class RegularLayout extends HTMLElement {
      *     target.
      */
     diffCoordinates: (event: PointerEventCoordinates, drag_target: LayoutPath) => number;
+    private create_overlay_host;
     private onDblClick;
     private onPointerDown;
     private onPointerMove;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "regular-layout",
-	"version": "0.2.2",
+	"version": "0.4.0",
 	"description": "A regular CSS `grid` container",
 	"keywords": [],
 	"license": "Apache-2.0",
@@ -19,10 +19,10 @@
 	],
 	"scripts": {
 		"build": "tsx build.ts",
-		"build:watch": "tsx build.ts --watch",
+		"watch": "tsx build.ts --watch",
 		"clean": "rm -rf dist",
-		"test": "playwright test tests/integration tests/unit",
-		"test:perf": "playwright test --workers=1 ./benchmarks",
+		"test": "tsx test.ts",
+		"bench": "playwright test --workers=1 ./benchmarks",
 		"example": "tsx serve.ts",
 		"deploy": "tsx deploy.ts",
 		"lint": "biome lint src tests",
@@ -34,6 +34,7 @@
 		"@playwright/test": "^1.57.0",
 		"@types/node": "^22.10.5",
 		"esbuild": "^0.27.2",
+		"monocart-coverage-reports": "^2.12.2",
 		"tsx": "^4.21.0",
 		"typescript": "^5.9.3"
 	}

package/src/{layout → core}/constants.ts

@@ -110,8 +110,8 @@ export const DEFAULT_PHYSICS: Physics = Object.freeze({
 	SHOULD_ROUND: false,
 	OVERLAY_CLASSNAME: "overlay",
 	MINIMUM_REDISTRIBUTION_SIZE_THRESHOLD: 0.15,
-	SPLIT_EDGE_TOLERANCE: 0.25,
-	SPLIT_ROOT_EDGE_TOLERANCE: 0.01,
+	SPLIT_EDGE_TOLERANCE: 0.33,
+	SPLIT_ROOT_EDGE_TOLERANCE: 0.03,
 	GRID_TRACK_COLLAPSE_TOLERANCE: 0.001,
 	OVERLAY_DEFAULT: "absolute",
 	GRID_DIVIDER_SIZE: 6,

package/src/{layout → core}/types.ts

@@ -47,7 +47,7 @@ export interface ViewWindow {
  * opposite `orientation` as its parent.
  */
 export interface SplitLayout {
-	type: "split-panel";
+	type: "split-layout";
 	children: Layout[];
 	sizes: number[];
 	orientation: Orientation;
@@ -57,18 +57,23 @@ export interface SplitLayout {
  * A leaf panel node that contains a single named child element.
  */
 export interface TabLayout {
-	type: "child-panel";
+	type: "tab-layout";
 	tabs: string[];
 	selected?: number;
 }
 
+/**
+ * Represents a panel location relative to a `Layout` struct.
+ */
+export type LayoutPathTraversal = number[];
+
 /**
  * Represents a draggable divider between two panels in the layout.
  *
  * Used for hit detection.
  */
 export interface LayoutDivider {
-	path: number[];
+	path: LayoutPathTraversal;
 	view_window: ViewWindow;
 	type: Orientation;
 }
@@ -79,7 +84,7 @@ export interface LayoutDivider {
 export interface LayoutPath {
 	type: "layout-path";
 	slot: string;
-	path: number[];
+	path: LayoutPathTraversal;
 	view_window: ViewWindow;
 	column: number;
 	row: number;
@@ -90,11 +95,18 @@ export interface LayoutPath {
 	layout: Layout;
 }
 
+/**
+ * The detail payload of the `regular-layout-before-resize` event.
+ */
+export interface PresizeDetail {
+	calculatePresizePaths(): Record<string, LayoutPath>;
+}
+
 /**
  * An empty `Layout` with no panels.
  */
 export const EMPTY_PANEL: Layout = {
-	type: "split-panel",
+	type: "split-layout",
 	orientation: "horizontal",
 	sizes: [],
 	children: [],

package/src/extensions.ts

@@ -11,7 +11,7 @@
 
 import { RegularLayout } from "./regular-layout.ts";
 import { RegularLayoutFrame } from "./regular-layout-frame.ts";
-import type { Layout } from "./layout/types.ts";
+import type { Layout, PresizeDetail } from "./core/types.ts";
 import { RegularLayoutTab } from "./regular-layout-tab.ts";
 
 customElements.define("regular-layout", RegularLayout);
@@ -59,6 +59,12 @@ declare global {
 			options?: { signal: AbortSignal },
 		): void;
 
+		addEventListener(
+			name: "regular-layout-before-resize",
+			cb: (e: RegularLayoutPresizeEvent) => void,
+			options?: { signal: AbortSignal },
+		): void;
+
 		removeEventListener(
 			name: "regular-layout-update",
 			cb: (e: RegularLayoutEvent) => void,
@@ -68,7 +74,13 @@ declare global {
 			name: "regular-layout-before-update",
 			cb: (e: RegularLayoutEvent) => void,
 		): void;
+
+		removeEventListener(
+			name: "regular-layout-before-resize",
+			cb: (e: RegularLayoutPresizeEvent) => void,
+		): void;
 	}
 }
 
 export type RegularLayoutEvent = CustomEvent<Layout>;
+export type RegularLayoutPresizeEvent = CustomEvent<PresizeDetail>;

package/src/index.ts

@@ -59,10 +59,12 @@
  * @packageDocumentation
  */
 
-export type * from "./layout/types.ts";
+export type * from "./core/types.ts";
 
 export { RegularLayout } from "./regular-layout.ts";
 export { RegularLayoutFrame } from "./regular-layout-frame.ts";
 
+export type * from "./extensions.ts";
+
 // Side effects
 import "./extensions.ts";

package/src/layout/calculate_edge.ts

@@ -9,13 +9,19 @@
 // ┃  *  [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). *  ┃
 // ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
-import { DEFAULT_PHYSICS, type Physics } from "./constants";
+import { DEFAULT_PHYSICS, type Physics } from "../core/constants";
 import { insert_child } from "./insert_child";
-import type { Layout, LayoutPath, Orientation, ViewWindow } from "./types";
+import type {
+	Layout,
+	LayoutPath,
+	LayoutPathTraversal,
+	Orientation,
+	ViewWindow,
+} from "../core/types";
 
 /**
  * Calculates an insertion point (which may involve splitting a single
- * `"child-panel"` into a new `"split-panel"`), based on the  cursor position.
+ * `"tab-layout"` into a new `"split-layout"`), based on the  cursor position.
  * *
  * @param col - The cursor column.
  * @param row - The cursor row.
@@ -23,7 +29,7 @@ import type { Layout, LayoutPath, Orientation, ViewWindow } from "./types";
  * @param slot - The slot identifier where the insert should occur
  * @param drop_target - The `LayoutPath` (from `calculateIntersect`) of the
  * panel to either insert next to, or split by.
- * @returns A new `LayoutPath` reflecting the updated (maybe) `"split-panel"`,
+ * @returns A new `LayoutPath` reflecting the updated (maybe) `"split-layout"`,
  * which is enough to draw the overlay.
  */
 export function calculate_edge(
@@ -133,7 +139,7 @@ function insert_root_edge(
 	panel: Layout,
 	slot: string,
 	drop_target: LayoutPath,
-	path: number[],
+	path: LayoutPathTraversal,
 	is_before: boolean,
 	orientation: Orientation,
 ): LayoutPath {
@@ -153,7 +159,7 @@ function insert_axis(
 	is_before: boolean,
 	axis_orientation: Orientation,
 ): LayoutPath {
-	let result_path: number[];
+	let result_path: LayoutPathTraversal;
 
 	if (drop_target.orientation === axis_orientation) {
 		// Same orientation - insert into existing split
@@ -183,7 +189,10 @@ function insert_axis(
 	};
 }
 
-function calculate_view_window(panel: Layout, path: number[]): ViewWindow {
+function calculate_view_window(
+	panel: Layout,
+	path: LayoutPathTraversal,
+): ViewWindow {
 	let view_window: ViewWindow = {
 		row_start: 0,
 		row_end: 1,
@@ -193,7 +202,7 @@ function calculate_view_window(panel: Layout, path: number[]): ViewWindow {
 
 	let current_panel = panel;
 	for (const step of path) {
-		if (current_panel.type === "child-panel") {
+		if (current_panel.type === "tab-layout") {
 			break;
 		}
 

package/src/layout/calculate_intersect.ts

@@ -9,7 +9,13 @@
 // ┃  *  [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). *  ┃
 // ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
 
-import type { LayoutPath, LayoutDivider, Layout, ViewWindow } from "./types.ts";
+import type {
+	LayoutPath,
+	LayoutDivider,
+	Layout,
+	ViewWindow,
+	LayoutPathTraversal,
+} from "../core/types.ts";
 
 const VIEW_WINDOW = {
 	row_start: 0,
@@ -67,14 +73,14 @@ function calculate_intersection_recursive(
 	check_dividers: { rect: DOMRect; size: number } | null,
 	parent_orientation: "horizontal" | "vertical" | null = null,
 	view_window: ViewWindow = structuredClone(VIEW_WINDOW),
-	path: number[] = [],
+	path: LayoutPathTraversal = [],
 ): LayoutPath | null | LayoutDivider {
 	if (column < 0 || row < 0 || column > 1 || row > 1) {
 		return null;
 	}
 
 	// Base case: if this is a child panel, return its name
-	if (panel.type === "child-panel") {
+	if (panel.type === "tab-layout") {
 		const selected = panel.selected ?? 0;
 		const col_width = view_window.col_end - view_window.col_start;
 		const row_height = view_window.row_end - view_window.row_start;
@@ -124,7 +130,10 @@ function calculate_intersection_recursive(
 		}
 
 		// Check if position falls within this child's bounds
-		if (position >= current_pos && position < next_pos) {
+		if (
+			position >= current_pos &&
+			(position < next_pos || i === panel.children.length - 1)
+		) {
 			return calculate_intersection_recursive(
 				column,
 				row,

package/src/layout/calculate_path.ts

@@ -0,0 +1,53 @@
+// ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+// ░░░░░░░░▄▀░█▀▄░█▀▀░█▀▀░█░█░█░░░█▀█░█▀▄░░░░░█░░░█▀█░█░█░█▀█░█░█░▀█▀░▀▄░░░░░░░░
+// ░░░░░░░▀▄░░█▀▄░█▀▀░█░█░█░█░█░░░█▀█░█▀▄░▀▀▀░█░░░█▀█░░█░░█░█░█░█░░█░░░▄▀░░░░░░░
+// ░░░░░░░░░▀░▀░▀░▀▀▀░▀▀▀░▀▀▀░▀▀▀░▀░▀░▀░▀░░░░░▀▀▀░▀░▀░░▀░░▀▀▀░▀▀▀░░▀░░▀░░░░░░░░░
+// ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
+// ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
+// ┃  *  Copyright (c) 2026, the Regular Layout Authors. This file is part  *  ┃
+// ┃  *  of the Regular Layout library, distributed under the terms of the  *  ┃
+// ┃  *  [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0). *  ┃
+// ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
+
+import type { Layout, LayoutPathTraversal } from "../core/types.ts";
+
+/**
+ * Calculates the index path for a panel with the given name.
+ *
+ * Traverses the layout tree to find the named panel and returns the
+ * index path describing its position in the tree.
+ *
+ * @param name - The name of the panel to find.
+ * @param layout - The layout tree to search.
+ * @returns The panel's index path if found, `null` otherwise.
+ */
+export function calculate_path(name: string, layout: Layout): number[] | null {
+	return calculate_path_recursive(name, layout, []);
+}
+
+function calculate_path_recursive(
+	name: string,
+	panel: Layout,
+	path: LayoutPathTraversal,
+): number[] | null {
+	if (panel.type === "tab-layout") {
+		if (!panel.tabs.includes(name)) {
+			return null;
+		}
+
+		return path;
+	}
+
+	for (let i = 0; i < panel.children.length; i++) {
+		const result = calculate_path_recursive(name, panel.children[i], [
+			...path,
+			i,
+		]);
+
+		if (result) {
+			return result;
+		}
+	}
+
+	return null;
+}