dockview-core 6.6.1 → 7.0.3

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

@@ -1,14 +1,45 @@
 import { Overlay } from '../overlay/overlay';
 import { CompositeDisposable } from '../lifecycle';
+import { Gridview } from '../gridview/gridview';
 import { AnchoredBox } from '../types';
 import { DockviewGroupPanel, IDockviewGroupPanel } from './dockviewGroupPanel';
 export interface IDockviewFloatingGroupPanel {
     readonly group: IDockviewGroupPanel;
     position(bounds: Partial<AnchoredBox>): void;
 }
+/**
+ * The subset of the dedicated floating title bar this panel needs to keep in
+ * sync. Declared structurally to avoid a circular import on `FloatingTitleBar`.
+ */
+export interface IAnchorTrackingTitleBar {
+    setGroup(group: DockviewGroupPanel): void;
+}
 export declare class DockviewFloatingGroupPanel extends CompositeDisposable implements IDockviewFloatingGroupPanel {
-    readonly group: DockviewGroupPanel;
     readonly overlay: Overlay;
-    constructor(group: DockviewGroupPanel, overlay: Overlay);
+    /**
+     * The floating window hosts its own gridview so it can hold a nested
+     * splitview layout of groups, not just a single group.
+     */
+    readonly gridview: Gridview;
+    private _group;
+    private _titleBar;
+    /**
+     * The window's representative/anchor group. A floating window can host a
+     * nested layout of several groups; the anchor is used for back-compat
+     * single-group APIs and is reassigned if it leaves the window.
+     */
+    get group(): DockviewGroupPanel;
+    /**
+     * Register the dedicated title bar (if any) so anchor reassignment keeps
+     * its drag handle pointed at a group that still lives in this window.
+     */
+    setTitleBar(titleBar: IAnchorTrackingTitleBar | undefined): void;
+    setAnchorGroup(group: DockviewGroupPanel): void;
+    constructor(group: DockviewGroupPanel, overlay: Overlay, 
+    /**
+     * The floating window hosts its own gridview so it can hold a nested
+     * splitview layout of groups, not just a single group.
+     */
+    gridview: Gridview);
     position(bounds: Partial<AnchoredBox>): void;
 }

package/dist/esm/dockview/dockviewFloatingGroupPanel.js

@@ -1,10 +1,42 @@
 import { CompositeDisposable } from '../lifecycle';
 export class DockviewFloatingGroupPanel extends CompositeDisposable {
-    constructor(group, overlay) {
+    /**
+     * The window's representative/anchor group. A floating window can host a
+     * nested layout of several groups; the anchor is used for back-compat
+     * single-group APIs and is reassigned if it leaves the window.
+     */
+    get group() {
+        return this._group;
+    }
+    /**
+     * Register the dedicated title bar (if any) so anchor reassignment keeps
+     * its drag handle pointed at a group that still lives in this window.
+     */
+    setTitleBar(titleBar) {
+        this._titleBar = titleBar;
+    }
+    setAnchorGroup(group) {
+        var _a;
+        this._group = group;
+        (_a = this._titleBar) === null || _a === void 0 ? void 0 : _a.setGroup(group);
+    }
+    constructor(group, overlay, 
+    /**
+     * The floating window hosts its own gridview so it can hold a nested
+     * splitview layout of groups, not just a single group.
+     */
+    gridview) {
         super();
-        this.group = group;
         this.overlay = overlay;
-        this.addDisposables(overlay);
+        this.gridview = gridview;
+        this._group = group;
+        this.addDisposables(overlay, {
+            // The gridview owns the floating window's DOM subtree (mounted as
+            // the overlay's content). Disposing it tears down the splitview;
+            // it does NOT dispose the leaf views (groups) — their lifecycle is
+            // owned by the component's `_groups` map.
+            dispose: () => this.gridview.dispose(),
+        });
     }
     position(bounds) {
         this.overlay.setBounds(bounds);

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

@@ -11,10 +11,9 @@ export interface IDockviewGroupPanel extends IGridviewPanel<DockviewGroupPanelAp
     readonly panels: IDockviewPanel[];
     readonly activePanel: IDockviewPanel | undefined;
 }
-export type IDockviewGroupPanelPublic = IDockviewGroupPanel;
 export declare class DockviewGroupPanel extends GridviewPanel<DockviewGroupPanelApiImpl> implements IDockviewGroupPanel {
     private readonly _model;
-    private _explicitConstraints;
+    private readonly _explicitConstraints;
     get minimumWidth(): number;
     get minimumHeight(): number;
     get maximumWidth(): number;

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

@@ -1,7 +1,7 @@
 import { DockviewApi } from '../api/component.api';
 import { PanelTransfer } from '../dnd/dataTransfer';
-import { Position } from '../dnd/droptarget';
-import { DockviewComponent } from './dockviewComponent';
+import { Droptarget, Position } from '../dnd/droptarget';
+import { DockviewComponent, DockviewOrigin } from './dockviewComponent';
 import { DockviewEvent, Event } from '../events';
 import { DockviewGroupDropLocation, DockviewWillShowOverlayLocationEvent } from './events';
 import { IViewSize } from '../gridview/gridview';
@@ -13,7 +13,7 @@ import { IDockviewPanel } from './dockviewPanel';
 import { DockviewDndOverlayEvent, DockviewHeaderDirection, DockviewHeaderPosition } from './options';
 import { OverlayRenderContainer } from '../overlay/overlayRenderContainer';
 import { TitleEvent } from '../api/dockviewPanelApi';
-import { Contraints } from '../gridview/gridviewPanel';
+import { Constraints } from '../gridview/gridviewPanel';
 import { DropTargetAnchorContainer } from '../dnd/dropTargetAnchorContainer';
 import { ITabGroup, SerializedTabGroup, TabGroupOptions } from './tabGroup';
 import { EdgeGroupPosition } from './dockviewShell';
@@ -29,7 +29,7 @@ interface CoreGroupOptions {
     hideHeader?: boolean;
     headerPosition?: 'top' | 'bottom' | 'left' | 'right';
     skipSetActive?: boolean;
-    constraints?: Partial<Contraints>;
+    constraints?: Partial<Constraints>;
     initialWidth?: number;
     initialHeight?: number;
 }
@@ -47,6 +47,15 @@ export interface GroupPanelViewState extends CoreGroupOptions {
 export interface DockviewGroupChangeEvent {
     readonly panel: IDockviewPanel;
 }
+/**
+ * Payload for the group-level `onDidActivePanelChange`. Extends
+ * {@link DockviewGroupChangeEvent} with the {@link DockviewOrigin} so it mirrors
+ * the component-level `DockviewActivePanelChangeEvent` — both report whether the
+ * change came from a user gesture or an API call.
+ */
+export interface DockviewGroupActivePanelChangeEvent extends DockviewGroupChangeEvent {
+    readonly origin: DockviewOrigin;
+}
 export interface CreateTabGroupOptions extends TabGroupOptions {
     id?: string;
 }
@@ -100,7 +109,7 @@ export interface IDockviewGroupPanelModel extends IPanel {
     readonly onWillDrop: Event<DockviewWillDropEvent>;
     readonly onDidAddPanel: Event<DockviewGroupChangeEvent>;
     readonly onDidRemovePanel: Event<DockviewGroupChangeEvent>;
-    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent>;
+    readonly onDidActivePanelChange: Event<DockviewGroupActivePanelChangeEvent>;
     readonly onMove: Event<GroupMoveEvent>;
     locked: DockviewGroupPanelLocked;
     headerPosition: DockviewHeaderPosition;
@@ -127,6 +136,8 @@ export interface IDockviewGroupPanelModel extends IPanel {
         suppressRoll?: boolean;
     }): void;
     canDisplayOverlay(event: DragEvent | PointerEvent, position: Position, target: DockviewGroupDropLocation): boolean;
+    updateHeaderActions(): void;
+    attachHeaderAction(slot: 'left' | 'right' | 'prefix', element: HTMLElement | undefined): void;
 }
 export type DockviewGroupLocation = {
     type: 'grid';
@@ -152,12 +163,6 @@ export declare class DockviewGroupPanelModel extends CompositeDisposable impleme
     private watermark?;
     private _isGroupActive;
     private _locked;
-    private _rightHeaderActions;
-    private _leftHeaderActions;
-    private _prefixHeaderActions;
-    private readonly _rightHeaderActionsDisposable;
-    private readonly _leftHeaderActionsDisposable;
-    private readonly _prefixHeaderActionsDisposable;
     private _headerPosition;
     private _location;
     private mostRecentlyUsed;
@@ -192,9 +197,9 @@ export declare class DockviewGroupPanelModel extends CompositeDisposable impleme
     private readonly _onDidRemovePanel;
     readonly onDidRemovePanel: Event<DockviewGroupChangeEvent>;
     private readonly _onDidActivePanelChange;
-    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent>;
-    private readonly _onUnhandledDragOverEvent;
-    readonly onUnhandledDragOverEvent: Event<DockviewDndOverlayEvent>;
+    readonly onDidActivePanelChange: Event<DockviewGroupActivePanelChangeEvent>;
+    private readonly _onUnhandledDragOver;
+    readonly onUnhandledDragOver: Event<DockviewDndOverlayEvent>;
     private readonly _tabGroups;
     private readonly _tabGroupMap;
     private readonly _panelToTabGroup;
@@ -230,6 +235,10 @@ export declare class DockviewGroupPanelModel extends CompositeDisposable impleme
     get tabGroups(): readonly ITabGroup[];
     get element(): HTMLElement;
     get activePanel(): IDockviewPanel | undefined;
+    /** DOM id of the content container (the group's tabpanel), referenced by each tab's `aria-controls`. */
+    get contentContainerId(): string;
+    /** The group's content drop target — lets keyboard docking preview a drop here. */
+    get contentDropTarget(): Droptarget;
     get locked(): DockviewGroupPanelLocked;
     set locked(value: DockviewGroupPanelLocked);
     get isActive(): boolean;
@@ -245,7 +254,16 @@ export declare class DockviewGroupPanelModel extends CompositeDisposable impleme
     set location(value: DockviewGroupLocation);
     constructor(container: HTMLElement, accessor: DockviewComponent, id: string, options: GroupOptions, groupPanel: DockviewGroupPanel);
     private _scheduleTabGroupUpdate;
+    /**
+     * Bracket a tab-group mutation as a layout transaction. `accessor` is
+     * always a full {@link DockviewComponent} in production; the optional-call
+     * fallback keeps partial test doubles (which omit `mutation`) working.
+     * When nested inside a larger operation (a drag-driven move, fromJSON
+     * restore) the component's depth counter folds it into the outer one.
+     */
+    private _bracketTabGroupMutation;
     createTabGroup(options?: CreateTabGroupOptions): ITabGroup;
+    private _doCreateTabGroup;
     dissolveTabGroup(tabGroupId: string): void;
     addPanelToTabGroup(tabGroupId: string, panelId: string, index?: number): void;
     /**
@@ -285,12 +303,14 @@ export declare class DockviewGroupPanelModel extends CompositeDisposable impleme
     /** Restore tab groups from serialized data (used by fromJSON) */
     restoreTabGroups(serializedGroups: SerializedTabGroup[]): void;
     focusContent(): void;
+    focusActiveTab(): void;
     set renderContainer(value: OverlayRenderContainer | null);
     get renderContainer(): OverlayRenderContainer;
     set dropTargetContainer(value: DropTargetAnchorContainer | null);
     get dropTargetContainer(): DropTargetAnchorContainer | null;
     initialize(): void;
     updateHeaderActions(): void;
+    attachHeaderAction(slot: 'left' | 'right' | 'prefix', element: HTMLElement | undefined): void;
     rerender(panel: IDockviewPanel): void;
     indexOf(panel: IDockviewPanel): number;
     toJSON(): GroupPanelViewState;
@@ -326,6 +346,8 @@ export declare class DockviewGroupPanelModel extends CompositeDisposable impleme
     private doRemovePanel;
     private doAddPanel;
     private doSetActivePanel;
+    /** Label the group region with its active panel's title (the WAI-ARIA region name). */
+    private updateAccessibleLabel;
     private updateMru;
     private updateContainer;
     canDisplayOverlay(event: DragEvent | PointerEvent, position: Position, target: DockviewGroupDropLocation): boolean;