dockview-core 6.6.1 → 7.0.3

package/dist/esm/api/component.api.d.ts

@@ -1,8 +1,8 @@
-import { DockviewMaximizedGroupChanged, FloatingGroupOptions, IDockviewComponent, MovePanelEvent, PopoutGroupChangePositionEvent, PopoutGroupChangeSizeEvent, SerializedDockview } from '../dockview/dockviewComponent';
+import { DockviewActivePanelChangeEvent, DockviewLayoutMutationEvent, DockviewMaximizedGroupChangeEvent, DockviewPopoutGroupOptions, FloatingGroupOptions, GroupNavigationDirection, IDockviewComponent, MovePanelEvent, PopoutGroup, PopoutGroupChangePositionEvent, PopoutGroupChangeSizeEvent, SerializedDockview } from '../dockview/dockviewComponent';
 import { AddGroupOptions, AddPanelOptions, DockviewComponentOptions, DockviewDndOverlayEvent, MovementOptions } from '../dockview/options';
 import { Parameters } from '../panel/types';
 import { Direction } from '../gridview/baseComponentGridview';
-import { AddComponentOptions, IGridviewComponent, SerializedGridviewComponent } from '../gridview/gridviewComponent';
+import { AddGridviewComponentOptions, IGridviewComponent, SerializedGridviewComponent } from '../gridview/gridviewComponent';
 import { IGridviewPanel } from '../gridview/gridviewPanel';
 import { AddPaneviewComponentOptions, SerializedPaneview, IPaneviewComponent } from '../paneview/paneviewComponent';
 import { IPaneviewPanel } from '../paneview/paneviewPanel';
@@ -14,7 +14,6 @@ import { Event } from '../events';
 import { IDockviewPanel } from '../dockview/dockviewPanel';
 import { PaneviewDidDropEvent } from '../paneview/draggablePaneviewPanel';
 import { GroupDragEvent, TabDragEvent } from '../dockview/components/titlebar/tabsContainer';
-import { Box } from '../types';
 import { DockviewDidDropEvent, DockviewWillDropEvent } from '../dockview/dockviewGroupPanelModel';
 import { DockviewWillShowOverlayLocationEvent, DockviewTabGroupChangeEvent, DockviewTabGroupCollapsedChangeEvent, DockviewTabGroupPanelChangeEvent } from '../dockview/events';
 import { ITabGroup } from '../dockview/tabGroup';
@@ -170,7 +169,7 @@ export declare class PaneviewApi implements CommonApi<SerializedPaneview> {
      * Invoked when a Drag'n'Drop event occurs that the component was unable to handle. Exposed for custom Drag'n'Drop functionality.
      */
     get onDidDrop(): Event<PaneviewDidDropEvent>;
-    get onUnhandledDragOverEvent(): Event<PaneviewDndOverlayEvent>;
+    get onUnhandledDragOver(): Event<PaneviewDndOverlayEvent>;
     constructor(component: IPaneviewComponent);
     /**
      * Remove a panel given the panel object.
@@ -284,7 +283,7 @@ export declare class GridviewApi implements CommonApi<SerializedGridviewComponen
     /**
      * Add a panel and return the created object.
      */
-    addPanel<T extends object = Parameters>(options: AddComponentOptions<T>): IGridviewPanel;
+    addPanel<T extends object = Parameters>(options: AddGridviewComponentOptions<T>): IGridviewPanel;
     /**
      * Remove a panel given the panel object.
      */
@@ -380,9 +379,11 @@ export declare class DockviewApi implements CommonApi<SerializedDockview> {
      */
     get onDidRemoveGroup(): Event<DockviewGroupPanel>;
     /**
-     * Invoked when the active panel changes. May be undefined if no panel is active.
+     * Invoked when the active panel changes. The event carries the active
+     * `panel` (may be undefined if no panel is active) and the
+     * {@link DockviewOrigin} (`'user'` vs `'api'`) of the change.
      */
-    get onDidActivePanelChange(): Event<IDockviewPanel | undefined>;
+    get onDidActivePanelChange(): Event<DockviewActivePanelChangeEvent>;
     /**
      * Invoked when a panel is added. May be called multiple times when moving panels.
      */
@@ -411,6 +412,15 @@ export declare class DockviewApi implements CommonApi<SerializedDockview> {
      * Preventing certain events may causes unexpected behaviours, use carefully.
      */
     get onWillDrop(): Event<DockviewWillDropEvent>;
+    /**
+     * Fires before each top-level structural layout mutation (add / remove /
+     * move / float / popout / maximize / load / clear). Compound operations
+     * (e.g. a drag) fire once. Pair with `onDidMutateLayout` to bracket a
+     * change — useful for undo/redo, autosave and dirty-tracking.
+     */
+    get onWillMutateLayout(): Event<DockviewLayoutMutationEvent>;
+    /** Fires after each top-level structural layout mutation. See `onWillMutateLayout`. */
+    get onDidMutateLayout(): Event<DockviewLayoutMutationEvent>;
     /**
      * Invoked before an overlay is shown indicating a drop target.
      *
@@ -431,10 +441,24 @@ export declare class DockviewApi implements CommonApi<SerializedDockview> {
      * Calling `event.nativeEvent.preventDefault()` will prevent the panel drag starting.
      */
     get onWillDragPanel(): Event<TabDragEvent>;
-    get onUnhandledDragOverEvent(): Event<DockviewDndOverlayEvent>;
+    get onUnhandledDragOver(): Event<DockviewDndOverlayEvent>;
     get onDidPopoutGroupSizeChange(): Event<PopoutGroupChangeSizeEvent>;
     get onDidPopoutGroupPositionChange(): Event<PopoutGroupChangePositionEvent>;
+    /**
+     * Fires when a popout group successfully opens in its own window, carrying
+     * the live `Window` handle. Use it to route focus or attach per-document
+     * listeners. Enumerate the current popouts at any time with `getPopouts()`.
+     */
+    get onDidAddPopoutGroup(): Event<PopoutGroup>;
+    /**
+     * Fires when a popout group is removed — whether the user closed its window
+     * or it was docked back programmatically. Symmetric with
+     * {@link onDidAddPopoutGroup}; not fired during component disposal.
+     */
+    get onDidRemovePopoutGroup(): Event<PopoutGroup>;
     get onDidOpenPopoutWindowFail(): Event<void>;
+    /** Enumerate the popout groups currently open in their own windows. */
+    getPopouts(): PopoutGroup[];
     /**
      * Invoked when a tab group is created in any group.
      */
@@ -467,6 +491,14 @@ export declare class DockviewApi implements CommonApi<SerializedDockview> {
      * All group objects.
      */
     get groups(): DockviewGroupPanel[];
+    /**
+     * The nearest grid group in a spatial direction from `group`, comparing
+     * group centre points — e.g. the group visually to the left. Floating and
+     * popout groups are ignored. Returns `undefined` when there is no group in
+     * that direction. Pair with `group.api.boundingBox` to build your own
+     * spatial navigation.
+     */
+    adjacentGroupInDirection(group: IDockviewGroupPanel, direction: GroupNavigationDirection): IDockviewGroupPanel | undefined;
     /**
      *  Active panel object.
      */
@@ -541,22 +573,11 @@ export declare class DockviewApi implements CommonApi<SerializedDockview> {
     maximizeGroup(panel: IDockviewPanel): void;
     hasMaximizedGroup(): boolean;
     exitMaximizedGroup(): void;
-    get onDidMaximizedGroupChange(): Event<DockviewMaximizedGroupChanged>;
+    get onDidMaximizedGroupChange(): Event<DockviewMaximizedGroupChangeEvent>;
     /**
      * Add a popout group in a new Window
      */
-    addPopoutGroup(item: IDockviewPanel | DockviewGroupPanel, options?: {
-        position?: Box;
-        popoutUrl?: string;
-        onDidOpen?: (event: {
-            id: string;
-            window: Window;
-        }) => void;
-        onWillClose?: (event: {
-            id: string;
-            window: Window;
-        }) => void;
-    }): Promise<boolean>;
+    addPopoutGroup(item: IDockviewPanel | DockviewGroupPanel, options?: DockviewPopoutGroupOptions): Promise<boolean>;
     /**
      * Add an edge group at the given position. Returns the group panel API
      * for the newly created group. Throws if a group already exists there.

package/dist/esm/api/component.api.js

@@ -196,8 +196,8 @@ export class PaneviewApi {
     get onDidDrop() {
         return this.component.onDidDrop;
     }
-    get onUnhandledDragOverEvent() {
-        return this.component.onUnhandledDragOverEvent;
+    get onUnhandledDragOver() {
+        return this.component.onUnhandledDragOver;
     }
     constructor(component) {
         this.component = component;
@@ -501,7 +501,9 @@ export class DockviewApi {
         return this.component.onDidRemoveGroup;
     }
     /**
-     * Invoked when the active panel changes. May be undefined if no panel is active.
+     * Invoked when the active panel changes. The event carries the active
+     * `panel` (may be undefined if no panel is active) and the
+     * {@link DockviewOrigin} (`'user'` vs `'api'`) of the change.
      */
     get onDidActivePanelChange() {
         return this.component.onDidActivePanelChange;
@@ -548,6 +550,19 @@ export class DockviewApi {
     get onWillDrop() {
         return this.component.onWillDrop;
     }
+    /**
+     * Fires before each top-level structural layout mutation (add / remove /
+     * move / float / popout / maximize / load / clear). Compound operations
+     * (e.g. a drag) fire once. Pair with `onDidMutateLayout` to bracket a
+     * change — useful for undo/redo, autosave and dirty-tracking.
+     */
+    get onWillMutateLayout() {
+        return this.component.onWillMutateLayout;
+    }
+    /** Fires after each top-level structural layout mutation. See `onWillMutateLayout`. */
+    get onDidMutateLayout() {
+        return this.component.onDidMutateLayout;
+    }
     /**
      * Invoked before an overlay is shown indicating a drop target.
      *
@@ -574,8 +589,8 @@ export class DockviewApi {
     get onWillDragPanel() {
         return this.component.onWillDragPanel;
     }
-    get onUnhandledDragOverEvent() {
-        return this.component.onUnhandledDragOverEvent;
+    get onUnhandledDragOver() {
+        return this.component.onUnhandledDragOver;
     }
     get onDidPopoutGroupSizeChange() {
         return this.component.onDidPopoutGroupSizeChange;
@@ -583,9 +598,29 @@ export class DockviewApi {
     get onDidPopoutGroupPositionChange() {
         return this.component.onDidPopoutGroupPositionChange;
     }
+    /**
+     * Fires when a popout group successfully opens in its own window, carrying
+     * the live `Window` handle. Use it to route focus or attach per-document
+     * listeners. Enumerate the current popouts at any time with `getPopouts()`.
+     */
+    get onDidAddPopoutGroup() {
+        return this.component.onDidAddPopoutGroup;
+    }
+    /**
+     * Fires when a popout group is removed — whether the user closed its window
+     * or it was docked back programmatically. Symmetric with
+     * {@link onDidAddPopoutGroup}; not fired during component disposal.
+     */
+    get onDidRemovePopoutGroup() {
+        return this.component.onDidRemovePopoutGroup;
+    }
     get onDidOpenPopoutWindowFail() {
         return this.component.onDidOpenPopoutWindowFail;
     }
+    /** Enumerate the popout groups currently open in their own windows. */
+    getPopouts() {
+        return this.component.getPopouts();
+    }
     /**
      * Invoked when a tab group is created in any group.
      */
@@ -634,6 +669,16 @@ export class DockviewApi {
     get groups() {
         return this.component.groups;
     }
+    /**
+     * The nearest grid group in a spatial direction from `group`, comparing
+     * group centre points — e.g. the group visually to the left. Floating and
+     * popout groups are ignored. Returns `undefined` when there is no group in
+     * that direction. Pair with `group.api.boundingBox` to build your own
+     * spatial navigation.
+     */
+    adjacentGroupInDirection(group, direction) {
+        return this.component.adjacentGroupInDirection(group, direction);
+    }
     /**
      *  Active panel object.
      */
@@ -671,13 +716,13 @@ export class DockviewApi {
      * Add a panel and return the created object.
      */
     addPanel(options) {
-        return this.component.addPanel(options);
+        return this.component.withOrigin('api', () => this.component.addPanel(options));
     }
     /**
      * Remove a panel given the panel object.
      */
     removePanel(panel) {
-        this.component.removePanel(panel);
+        this.component.withOrigin('api', () => this.component.removePanel(panel));
     }
     /**
      * Add a group and return the created object.
@@ -689,13 +734,13 @@ export class DockviewApi {
      * Close all groups and panels.
      */
     closeAllGroups() {
-        return this.component.closeAllGroups();
+        return this.component.withOrigin('api', () => this.component.closeAllGroups());
     }
     /**
      * Remove a group and any panels within the group.
      */
     removeGroup(group) {
-        this.component.removeGroup(group);
+        this.component.withOrigin('api', () => this.component.removeGroup(group));
     }
     /**
      * Get a group object given a `string` id. May return undefined.
@@ -707,13 +752,13 @@ export class DockviewApi {
      * Add a floating group
      */
     addFloatingGroup(item, options) {
-        return this.component.addFloatingGroup(item, options);
+        return this.component.withOrigin('api', () => this.component.addFloatingGroup(item, options));
     }
     /**
      * Create a component from a serialized object.
      */
     fromJSON(data, options) {
-        this.component.fromJSON(data, options);
+        this.component.withOrigin('api', () => this.component.fromJSON(data, options));
     }
     /**
      * Create a serialized object of the current component.
@@ -725,7 +770,7 @@ export class DockviewApi {
      * Reset the component back to an empty and default state.
      */
     clear() {
-        this.component.clear();
+        this.component.withOrigin('api', () => this.component.clear());
     }
     /**
      * Move the focus progmatically to the next panel or group.
@@ -755,7 +800,7 @@ export class DockviewApi {
      * Add a popout group in a new Window
      */
     addPopoutGroup(item, options) {
-        return this.component.addPopoutGroup(item, options);
+        return this.component.withOrigin('api', () => this.component.addPopoutGroup(item, options));
     }
     /**
      * Add an edge group at the given position. Returns the group panel API
@@ -803,23 +848,23 @@ export class DockviewApi {
     }
     createTabGroup(options) {
         const model = this._getGroupModel(options.groupId);
-        return model.createTabGroup({
+        return this.component.withOrigin('api', () => model.createTabGroup({
             label: options.label,
             color: options.color,
             componentParams: options.componentParams,
-        });
+        }));
     }
     dissolveTabGroup(options) {
         const model = this._getGroupModel(options.groupId);
-        model.dissolveTabGroup(options.tabGroupId);
+        this.component.withOrigin('api', () => model.dissolveTabGroup(options.tabGroupId));
     }
     addPanelToTabGroup(options) {
         const model = this._getGroupModel(options.groupId);
-        model.addPanelToTabGroup(options.tabGroupId, options.panelId, options.index);
+        this.component.withOrigin('api', () => model.addPanelToTabGroup(options.tabGroupId, options.panelId, options.index));
     }
     removePanelFromTabGroup(options) {
         const model = this._getGroupModel(options.groupId);
-        model.removePanelFromTabGroup(options.panelId);
+        this.component.withOrigin('api', () => model.removePanelFromTabGroup(options.panelId));
     }
     getTabGroups(options) {
         const model = this._getGroupModel(options.groupId);

package/dist/esm/api/dockviewGroupPanelApi.d.ts

@@ -1,7 +1,8 @@
 import { Position } from '../dnd/droptarget';
 import { DockviewComponent } from '../dockview/dockviewComponent';
+import { Box } from '../types';
 import { DockviewGroupPanel } from '../dockview/dockviewGroupPanel';
-import { DockviewGroupChangeEvent, DockviewGroupLocation, DockviewGroupPanelLocked } from '../dockview/dockviewGroupPanelModel';
+import { DockviewGroupActivePanelChangeEvent, DockviewGroupLocation, DockviewGroupPanelLocked } from '../dockview/dockviewGroupPanelModel';
 import { DockviewHeaderPosition } from '../dockview/options';
 import { Emitter, Event } from '../events';
 import { GridviewPanelApi, GridviewPanelApiImpl, SizeEvent } from './gridviewPanelApi';
@@ -21,8 +22,15 @@ export interface DockviewGroupPanelCollapsedChangeEvent {
     readonly isCollapsed: boolean;
 }
 export interface DockviewGroupPanelApi extends GridviewPanelApi {
-    readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent>;
-    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent>;
+    readonly onDidLocationChange: Event<DockviewGroupPanelLocationChangeEvent>;
+    /**
+     * Fires when the active panel *within this group* changes. Scoped to the
+     * group, in contrast to the component-level
+     * `DockviewApi.onDidActivePanelChange` (which tracks the active panel across
+     * the whole dockview). Both carry an {@link DockviewOrigin} reporting
+     * whether the change came from a user gesture or an API call.
+     */
+    readonly onDidActivePanelChange: Event<DockviewGroupActivePanelChangeEvent>;
     /**
      * Fired when an edge group's collapsed state changes.
      * Never fires for non-edge groups.
@@ -61,20 +69,27 @@ export interface DockviewGroupPanelApi extends GridviewPanelApi {
      */
     isCollapsed(): boolean;
 }
-export interface DockviewGroupPanelFloatingChangeEvent {
+export interface DockviewGroupPanelLocationChangeEvent {
     readonly location: DockviewGroupLocation;
 }
 export declare class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
     private readonly accessor;
     private _group;
     private _pendingSize;
-    readonly _onDidLocationChange: Emitter<DockviewGroupPanelFloatingChangeEvent>;
-    readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent>;
-    readonly _onDidActivePanelChange: Emitter<DockviewGroupChangeEvent>;
-    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent>;
+    readonly _onDidLocationChange: Emitter<DockviewGroupPanelLocationChangeEvent>;
+    readonly onDidLocationChange: Event<DockviewGroupPanelLocationChangeEvent>;
+    readonly _onDidActivePanelChange: Emitter<DockviewGroupActivePanelChangeEvent>;
+    readonly onDidActivePanelChange: Event<DockviewGroupActivePanelChangeEvent>;
     readonly _onDidCollapsedChange: Emitter<DockviewGroupPanelCollapsedChangeEvent>;
     readonly onDidCollapsedChange: Event<DockviewGroupPanelCollapsedChangeEvent>;
     get location(): DockviewGroupLocation;
+    /**
+     * The group's bounding box relative to the top-left of the dockview root,
+     * in pixels. Covers grid and floating groups; returns `undefined` for a
+     * popout group (it lives in a separate window). Reflects the live rendered
+     * geometry, so it is only meaningful once the layout has been sized.
+     */
+    get boundingBox(): Box | undefined;
     get locked(): DockviewGroupPanelLocked;
     set locked(value: DockviewGroupPanelLocked);
     constructor(id: string, accessor: DockviewComponent);

package/dist/esm/api/dockviewGroupPanelApi.js

@@ -9,6 +9,25 @@ export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
         }
         return this._group.model.location;
     }
+    /**
+     * The group's bounding box relative to the top-left of the dockview root,
+     * in pixels. Covers grid and floating groups; returns `undefined` for a
+     * popout group (it lives in a separate window). Reflects the live rendered
+     * geometry, so it is only meaningful once the layout has been sized.
+     */
+    get boundingBox() {
+        if (!this._group || this._group.model.location.type === 'popout') {
+            return undefined;
+        }
+        const root = this.accessor.element.getBoundingClientRect();
+        const rect = this._group.element.getBoundingClientRect();
+        return {
+            left: rect.left - root.left,
+            top: rect.top - root.top,
+            width: rect.width,
+            height: rect.height,
+        };
+    }
     get locked() {
         if (!this._group) {
             throw new Error(NOT_INITIALIZED_MESSAGE);
@@ -53,7 +72,7 @@ export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
     getWindow() {
         return this.location.type === 'popout'
             ? this.location.getWindow()
-            : window;
+            : globalThis.window;
     }
     setHeaderPosition(position) {
         if (!this._group) {

package/dist/esm/api/dockviewPanelApi.d.ts

@@ -4,7 +4,7 @@ import { DockviewGroupPanel } from '../dockview/dockviewGroupPanel';
 import { DockviewPanel } from '../dockview/dockviewPanel';
 import { DockviewComponent } from '../dockview/dockviewComponent';
 import { DockviewPanelRenderer } from '../overlay/overlayRenderContainer';
-import { DockviewGroupMoveParams, DockviewGroupPanelFloatingChangeEvent } from './dockviewGroupPanelApi';
+import { DockviewGroupMoveParams, DockviewGroupPanelLocationChangeEvent } from './dockviewGroupPanelApi';
 import { DockviewGroupLocation } from '../dockview/dockviewGroupPanelModel';
 export interface TitleEvent {
     readonly title: string;
@@ -34,7 +34,7 @@ export interface DockviewPanelApi extends Omit<GridviewPanelApi, 'setVisible' |
     readonly onDidTitleChange: Event<TitleEvent>;
     readonly onDidRendererChange: Event<RendererChangedEvent>;
     readonly location: DockviewGroupLocation;
-    readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent>;
+    readonly onDidLocationChange: Event<DockviewGroupPanelLocationChangeEvent>;
     close(): void;
     setTitle(title: string): void;
     setRenderer(renderer: DockviewPanelRenderer): void;
@@ -61,7 +61,7 @@ export declare class DockviewPanelApiImpl extends GridviewPanelApiImpl implement
     readonly _onDidRendererChange: Emitter<RendererChangedEvent>;
     readonly onDidRendererChange: Event<RendererChangedEvent>;
     private readonly _onDidLocationChange;
-    readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent>;
+    readonly onDidLocationChange: Event<DockviewGroupPanelLocationChangeEvent>;
     private readonly groupEventsDisposable;
     get location(): DockviewGroupLocation;
     get title(): string | undefined;
@@ -72,6 +72,7 @@ export declare class DockviewPanelApiImpl extends GridviewPanelApiImpl implement
     get tabComponent(): string | undefined;
     constructor(panel: DockviewPanel, group: DockviewGroupPanel, accessor: DockviewComponent, component: string, tabComponent?: string);
     getWindow(): Window;
+    setActive(): void;
     moveTo(options: DockviewPanelMoveParams): void;
     setTitle(title: string): void;
     setRenderer(renderer: DockviewPanelRenderer): void;

package/dist/esm/api/dockviewPanelApi.js

@@ -55,6 +55,13 @@ export class DockviewPanelApiImpl extends GridviewPanelApiImpl {
     getWindow() {
         return this.group.api.getWindow();
     }
+    setActive() {
+        // A bare `panel.api.setActive()` from application code is a
+        // programmatic activation. Tag it `'api'` so `onDidActivePanelChange`
+        // reports the correct origin; user-gesture call sites that route
+        // through here wrap the call in `withOrigin('user')` first, which wins.
+        this.accessor.withOrigin('api', () => super.setActive());
+    }
     moveTo(options) {
         var _a, _b;
         this.accessor.moveGroupOrPanel({

package/dist/esm/dnd/dropTargetAnchorContainer.js

@@ -19,9 +19,8 @@ export class DropTargetAnchorContainer extends CompositeDisposable {
         }
         return {
             clear: () => {
-                var _a;
                 if (this._model) {
-                    (_a = this._model.root.parentElement) === null || _a === void 0 ? void 0 : _a.removeChild(this._model.root);
+                    this._model.root.remove();
                 }
                 this._model = undefined;
             },

package/dist/esm/dnd/droptarget.d.ts

@@ -103,6 +103,14 @@ export declare class Droptarget extends CompositeDisposable implements IDropTarg
     private toggleClasses;
     private calculateQuadrant;
     private removeDropTarget;
+    /**
+     * Render the drop overlay at `position` without a live drag, so keyboard
+     * docking shows the exact same preview as a mouse drag. Mirrors the
+     * `onDragOver` render path (in-place or anchored). Pair with `clearOverlay`.
+     */
+    showOverlay(position: Position): void;
+    /** Clear an overlay shown via {@link showOverlay} (in-place or anchored). */
+    clearOverlay(): void;
 }
 export declare function calculateQuadrantAsPercentage(overlayType: Set<Position>, x: number, y: number, width: number, height: number, threshold: number): Position | null;
 export declare function calculateQuadrantAsPixels(overlayType: Set<Position>, x: number, y: number, width: number, height: number, threshold: number): Position | null;

package/dist/esm/dnd/droptarget.js

@@ -246,6 +246,34 @@ export class Droptarget extends CompositeDisposable {
             this.overlayElement = undefined;
         }
     }
+    /**
+     * Render the drop overlay at `position` without a live drag, so keyboard
+     * docking shows the exact same preview as a mouse drag. Mirrors the
+     * `onDragOver` render path (in-place or anchored). Pair with `clearOverlay`.
+     */
+    showOverlay(position) {
+        var _a, _b, _c, _d, _e;
+        const overrideTarget = (_b = (_a = this.options).getOverrideTarget) === null || _b === void 0 ? void 0 : _b.call(_a);
+        const target = (_e = (_d = (_c = this.options).getOverlayOutline) === null || _d === void 0 ? void 0 : _d.call(_c)) !== null && _e !== void 0 ? _e : this.element;
+        const width = target.offsetWidth;
+        const height = target.offsetHeight;
+        if (!overrideTarget && !this.targetElement) {
+            const els = createOverlayElements();
+            this.targetElement = els.dropzone;
+            this.overlayElement = els.selection;
+            target.classList.add('dv-drop-target');
+            target.append(this.targetElement);
+        }
+        this.toggleClasses(position, width, height);
+        this._state = position;
+    }
+    /** Clear an overlay shown via {@link showOverlay} (in-place or anchored). */
+    clearOverlay() {
+        var _a, _b, _c;
+        this.removeDropTarget();
+        (_c = (_b = (_a = this.options).getOverrideTarget) === null || _b === void 0 ? void 0 : _b.call(_a)) === null || _c === void 0 ? void 0 : _c.clear();
+        this._state = undefined;
+    }
 }
 Droptarget.USED_EVENT_ID = '__dockview_droptarget_event_is_used__';
 export function calculateQuadrantAsPercentage(overlayType, x, y, width, height, threshold) {

package/dist/esm/dnd/pointer/longPress.js

@@ -33,7 +33,7 @@ export class LongPressDetector extends CompositeDisposable {
         const delay = (_b = this.options.delay) !== null && _b !== void 0 ? _b : DEFAULT_DELAY;
         const tolerance = (_c = this.options.tolerance) !== null && _c !== void 0 ? _c : DEFAULT_TOLERANCE;
         // Source's owning window — popout drags fire on their own window.
-        const targetWindow = (_e = (_d = this.element.ownerDocument) === null || _d === void 0 ? void 0 : _d.defaultView) !== null && _e !== void 0 ? _e : window;
+        const targetWindow = (_e = (_d = this.element.ownerDocument) === null || _d === void 0 ? void 0 : _d.defaultView) !== null && _e !== void 0 ? _e : globalThis.window;
         this._timer = setTimeout(() => {
             this._timer = undefined;
             this._cancelPending();

package/dist/esm/dnd/pointer/pointerDragController.js

@@ -14,9 +14,8 @@ import { CompositeDisposable } from '../../lifecycle';
  */
 export class PointerDragController extends CompositeDisposable {
     static getInstance() {
-        if (!PointerDragController._instance) {
-            PointerDragController._instance = new PointerDragController();
-        }
+        var _a;
+        (_a = PointerDragController._instance) !== null && _a !== void 0 ? _a : (PointerDragController._instance = new PointerDragController());
         return PointerDragController._instance;
     }
     constructor() {
@@ -81,21 +80,24 @@ export class PointerDragController extends CompositeDisposable {
         this._onDragStart.fire(startEvent);
         // Source's owning window — popout drags fire on their own window,
         // not the main one.
-        const targetWindow = (_c = (_b = source.ownerDocument) === null || _b === void 0 ? void 0 : _b.defaultView) !== null && _c !== void 0 ? _c : window;
+        const targetWindow = (_c = (_b = source.ownerDocument) === null || _b === void 0 ? void 0 : _b.defaultView) !== null && _c !== void 0 ? _c : globalThis.window;
         this._moveListener = addDisposableListener(targetWindow, 'pointermove', (e) => {
-            if (!this._active || e.pointerId !== this._active.pointerId) {
+            var _a;
+            if (e.pointerId !== ((_a = this._active) === null || _a === void 0 ? void 0 : _a.pointerId)) {
                 return;
             }
             this._handleMove(e);
         });
         this._upListener = addDisposableListener(targetWindow, 'pointerup', (e) => {
-            if (!this._active || e.pointerId !== this._active.pointerId) {
+            var _a;
+            if (e.pointerId !== ((_a = this._active) === null || _a === void 0 ? void 0 : _a.pointerId)) {
                 return;
             }
             this._handleEnd(e, true);
         });
         this._cancelListener = addDisposableListener(targetWindow, 'pointercancel', (e) => {
-            if (!this._active || e.pointerId !== this._active.pointerId) {
+            var _a;
+            if (e.pointerId !== ((_a = this._active) === null || _a === void 0 ? void 0 : _a.pointerId)) {
                 return;
             }
             this._handleEnd(e, false);

package/dist/esm/dnd/pointer/pointerDragSource.js

@@ -82,7 +82,9 @@ export class PointerDragSource extends CompositeDisposable {
             ? initiationDelayOpt()
             : initiationDelayOpt)) !== null && _a !== void 0 ? _a : DEFAULT_TOUCH_INITIATION_DELAY;
         this._armed = !isTouch || initiationDelay <= 0;
-        if (isTouch && initiationDelay > 0 && isFinite(initiationDelay)) {
+        if (isTouch &&
+            initiationDelay > 0 &&
+            Number.isFinite(initiationDelay)) {
             this._armTimer = setTimeout(() => {
                 this._armTimer = undefined;
                 this._armed = true;
@@ -94,7 +96,7 @@ export class PointerDragSource extends CompositeDisposable {
             ? pressToleranceOpt()
             : pressToleranceOpt)) !== null && _c !== void 0 ? _c : DEFAULT_PRESS_TOLERANCE;
         // Source's owning window — popout drags fire on their own window.
-        const targetWindow = (_e = (_d = this.element.ownerDocument) === null || _d === void 0 ? void 0 : _d.defaultView) !== null && _e !== void 0 ? _e : window;
+        const targetWindow = (_e = (_d = this.element.ownerDocument) === null || _d === void 0 ? void 0 : _d.defaultView) !== null && _e !== void 0 ? _e : globalThis.window;
         this._pendingMoveListener = addDisposableListener(targetWindow, 'pointermove', (moveEvent) => {
             if (moveEvent.pointerId !== this._pendingPointerId) {
                 return;

package/dist/esm/dockview/accessibilityMessages.d.ts

@@ -0,0 +1,32 @@
+import { Position } from '../dnd/droptarget';
+/**
+ * The full set of localisable strings dockview speaks to assistive technology:
+ * the LiveRegion announcements and the keyboard-docking narration. Each entry
+ * returns the complete sentence so a translator owns wording *and* word order.
+ *
+ * Override any subset via the `messages` option; unset entries keep the
+ * English defaults below. For fine-grained, per-event announcement overrides
+ * (with access to the panel) use `getAnnouncement`, which takes precedence.
+ */
+export interface DockviewMessages {
+    panelOpened(title: string): string;
+    panelClosed(title: string): string;
+    groupMaximized(title: string): string;
+    groupRestored(title: string): string;
+    groupFloated(title: string): string;
+    groupDocked(title: string): string;
+    groupPoppedOut(title: string): string;
+    /** Target phase: which group is highlighted, and how to proceed. */
+    movePickTarget(source: string, target: string, current: number, total: number): string;
+    /** Edge phase: which drop position is selected, and how to proceed. */
+    movePickEdge(position: Position, target: string): string;
+    /** A move committed. */
+    moveCommitted(source: string, target: string, position: Position): string;
+    /** A move cancelled with Escape. */
+    moveCancelled(): string;
+    /** A move the layout rejected. */
+    moveNotAllowed(): string;
+}
+export declare const DEFAULT_MESSAGES: DockviewMessages;
+/** Merge an app's partial overrides over the English defaults. */
+export declare function resolveMessages(overrides?: Partial<DockviewMessages>): DockviewMessages;