dockview-core 1.15.3 → 1.16.1

package/dist/dockview-core.amd.noStyle.js

@@ -1,6 +1,6 @@
 /**
  * dockview-core
- * @version 1.15.3
+ * @version 1.16.1
  * @link https://github.com/mathuo/dockview
  * @license MIT
  */
@@ -531,6 +531,26 @@ define(['exports'], (function (exports) { 'use strict';
     function addTestId(element, id) {
         element.setAttribute('data-testid', id);
     }
+    function disableIframePointEvents() {
+        const iframes = [
+            ...getElementsByTagName('iframe'),
+            ...getElementsByTagName('webview'),
+        ];
+        const original = new WeakMap(); // don't hold onto HTMLElement references longer than required
+        for (const iframe of iframes) {
+            original.set(iframe, iframe.style.pointerEvents);
+            iframe.style.pointerEvents = 'none';
+        }
+        return {
+            release: () => {
+                var _a;
+                for (const iframe of iframes) {
+                    iframe.style.pointerEvents = (_a = original.get(iframe)) !== null && _a !== void 0 ? _a : 'auto';
+                }
+                iframes.splice(0, iframes.length); // don't hold onto HTMLElement references longer than required
+            },
+        };
+    }
 
     function tail(arr) {
         if (arr.length === 0) {
@@ -1053,13 +1073,7 @@ define(['exports'], (function (exports) { 'use strict';
                     for (const item of this.viewItems) {
                         item.enabled = false;
                     }
-                    const iframes = [
-                        ...getElementsByTagName('iframe'),
-                        ...getElementsByTagName('webview'),
-                    ];
-                    for (const iframe of iframes) {
-                        iframe.style.pointerEvents = 'none';
-                    }
+                    const iframes = disableIframePointEvents();
                     const start = this._orientation === exports.Orientation.HORIZONTAL
                         ? event.clientX
                         : event.clientY;
@@ -1121,9 +1135,7 @@ define(['exports'], (function (exports) { 'use strict';
                         for (const item of this.viewItems) {
                             item.enabled = true;
                         }
-                        for (const iframe of iframes) {
-                            iframe.style.pointerEvents = 'auto';
-                        }
+                        iframes.release();
                         this.saveProportions();
                         document.removeEventListener('pointermove', onPointerMove);
                         document.removeEventListener('pointerup', end);
@@ -1290,29 +1302,47 @@ define(['exports'], (function (exports) { 'use strict';
             if (this.viewItems.length === 0) {
                 return;
             }
-            const sashCount = this.viewItems.length - 1;
-            const marginReducedSize = (this.margin * sashCount) / this.viewItems.length;
+            const visibleViewItems = this.viewItems.filter((i) => i.visible);
+            const sashCount = Math.max(0, visibleViewItems.length - 1);
+            const marginReducedSize = (this.margin * sashCount) / Math.max(1, visibleViewItems.length);
             let totalLeftOffset = 0;
             const viewLeftOffsets = [];
-            for (let i = 0; i < this.viewItems.length - 1; i++) {
-                totalLeftOffset += this.viewItems[i].size;
-                viewLeftOffsets.push(totalLeftOffset);
-                const offset = Math.min(Math.max(0, totalLeftOffset - 2), this.size - this.margin);
-                if (this._orientation === exports.Orientation.HORIZONTAL) {
-                    this.sashes[i].container.style.left = `${offset}px`;
-                    this.sashes[i].container.style.top = `0px`;
+            const sashWidth = 4; // hardcoded in css
+            const runningVisiblePanelCount = this.viewItems.reduce((arr, viewItem, i) => {
+                const flag = viewItem.visible ? 1 : 0;
+                if (i === 0) {
+                    arr.push(flag);
                 }
-                if (this._orientation === exports.Orientation.VERTICAL) {
-                    this.sashes[i].container.style.left = `0px`;
-                    this.sashes[i].container.style.top = `${offset}px`;
+                else {
+                    arr.push(arr[i - 1] + flag);
                 }
-            }
+                return arr;
+            }, []);
+            // calculate both view and cash positions
             this.viewItems.forEach((view, i) => {
-                const size = view.size - marginReducedSize;
-                const offset = i === 0
+                totalLeftOffset += this.viewItems[i].size;
+                viewLeftOffsets.push(totalLeftOffset);
+                const size = view.visible ? view.size - marginReducedSize : 0;
+                const visiblePanelsBeforeThisView = Math.max(0, runningVisiblePanelCount[i] - 1);
+                const offset = i === 0 || visiblePanelsBeforeThisView === 0
                     ? 0
                     : viewLeftOffsets[i - 1] +
-                        (i / sashCount) * marginReducedSize;
+                        (visiblePanelsBeforeThisView / sashCount) * marginReducedSize;
+                if (i < this.viewItems.length - 1) {
+                    // calculate sash position
+                    const newSize = view.visible
+                        ? offset + size - sashWidth / 2 + this.margin / 2
+                        : offset;
+                    if (this._orientation === exports.Orientation.HORIZONTAL) {
+                        this.sashes[i].container.style.left = `${newSize}px`;
+                        this.sashes[i].container.style.top = `0px`;
+                    }
+                    if (this._orientation === exports.Orientation.VERTICAL) {
+                        this.sashes[i].container.style.left = `0px`;
+                        this.sashes[i].container.style.top = `${newSize}px`;
+                    }
+                }
+                // calculate view position
                 if (this._orientation === exports.Orientation.HORIZONTAL) {
                     view.container.style.width = `${size}px`;
                     view.container.style.left = `${offset}px`;
@@ -2641,6 +2671,7 @@ define(['exports'], (function (exports) { 'use strict';
             this.gridview.locked = value;
         }
         constructor(options) {
+            var _a, _b;
             super(document.createElement('div'), options.disableAutoResizing);
             this._id = nextLayoutId$1.next();
             this._groups = new Map();
@@ -2654,8 +2685,13 @@ define(['exports'], (function (exports) { 'use strict';
             this.onDidLayoutChange = this._bufferOnDidLayoutChange.onEvent;
             this._onDidViewVisibilityChangeMicroTaskQueue = new AsapEvent();
             this.onDidViewVisibilityChangeMicroTaskQueue = this._onDidViewVisibilityChangeMicroTaskQueue.onEvent;
+            this.classNames = [];
             this.element.style.height = '100%';
             this.element.style.width = '100%';
+            this.classNames = (_b = (_a = options.className) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+            for (const className of this.classNames) {
+                toggleClass(this.element, className, true);
+            }
             options.parentElement.appendChild(this.element);
             this.gridview = new Gridview(!!options.proportionalLayout, options.styles, options.orientation, options.locked, options.margin);
             this.gridview.locked = !!options.locked;
@@ -2679,6 +2715,18 @@ define(['exports'], (function (exports) { 'use strict';
         isVisible(panel) {
             return this.gridview.isViewVisible(getGridLocation(panel.element));
         }
+        updateOptions(options) {
+            var _a, _b;
+            if ('className' in options) {
+                for (const className of this.classNames) {
+                    toggleClass(this.element, className, false);
+                }
+                this.classNames = (_b = (_a = options.className) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+                for (const className of this.classNames) {
+                    toggleClass(this.element, className, true);
+                }
+            }
+        }
         maximizeGroup(panel) {
             this.gridview.maximizeView(panel);
             this.doSetGroupActive(panel);
@@ -2859,12 +2907,6 @@ define(['exports'], (function (exports) { 'use strict';
         constructor(component) {
             this.component = component;
         }
-        /**
-         * Update configuratable options.
-         */
-        updateOptions(options) {
-            this.component.updateOptions(options);
-        }
         /**
          * Removes an existing panel and optionally provide a `Sizing` method
          * for the subsequent resize.
@@ -2918,6 +2960,18 @@ define(['exports'], (function (exports) { 'use strict';
         clear() {
             this.component.clear();
         }
+        /**
+         * Update configuratable options.
+         */
+        updateOptions(options) {
+            this.component.updateOptions(options);
+        }
+        /**
+         * Release resources and teardown component. Do not call when using framework versions of dockview.
+         */
+        dispose() {
+            this.component.dispose();
+        }
     }
     class PaneviewApi {
         /**
@@ -3045,6 +3099,18 @@ define(['exports'], (function (exports) { 'use strict';
         clear() {
             this.component.clear();
         }
+        /**
+         * Update configuratable options.
+         */
+        updateOptions(options) {
+            this.component.updateOptions(options);
+        }
+        /**
+         * Release resources and teardown component. Do not call when using framework versions of dockview.
+         */
+        dispose() {
+            this.component.dispose();
+        }
     }
     class GridviewApi {
         /**
@@ -3185,6 +3251,15 @@ define(['exports'], (function (exports) { 'use strict';
         clear() {
             this.component.clear();
         }
+        updateOptions(options) {
+            this.component.updateOptions(options);
+        }
+        /**
+         * Release resources and teardown component. Do not call when using framework versions of dockview.
+         */
+        dispose() {
+            this.component.dispose();
+        }
     }
     class DockviewApi {
         /**
@@ -3477,6 +3552,15 @@ define(['exports'], (function (exports) { 'use strict';
         setGap(gap) {
             this.component.updateOptions({ gap });
         }
+        updateOptions(options) {
+            this.component.updateOptions(options);
+        }
+        /**
+         * Release resources and teardown component. Do not call when using framework versions of dockview.
+         */
+        dispose() {
+            this.component.dispose();
+        }
     }
 
     class DragHandler extends CompositeDisposable {
@@ -3499,20 +3583,12 @@ define(['exports'], (function (exports) { 'use strict';
                     event.preventDefault();
                     return;
                 }
-                const iframes = [
-                    ...getElementsByTagName('iframe'),
-                    ...getElementsByTagName('webview'),
-                ];
+                const iframes = disableIframePointEvents();
                 this.pointerEventsDisposable.value = {
                     dispose: () => {
-                        for (const iframe of iframes) {
-                            iframe.style.pointerEvents = 'auto';
-                        }
+                        iframes.release();
                     },
                 };
-                for (const iframe of iframes) {
-                    iframe.style.pointerEvents = 'none';
-                }
                 this.el.classList.add('dv-dragged');
                 setTimeout(() => this.el.classList.remove('dv-dragged'), 0);
                 this.dataDisposable.value = this.getData(event);
@@ -4676,7 +4752,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._element.className = 'void-container';
             this._element.tabIndex = 0;
             this._element.draggable = true;
-            this.addDisposables(this._onDrop, this._onDragStart, addDisposableListener(this._element, 'click', () => {
+            this.addDisposables(this._onDrop, this._onDragStart, addDisposableListener(this._element, 'pointerdown', () => {
                 this.accessor.doSetGroupActive(this.group);
             }));
             const handler = new GroupDragHandler(this._element, accessor, group);
@@ -4991,6 +5067,7 @@ define(['exports'], (function (exports) { 'use strict';
             locked: undefined,
             disableDnd: undefined,
             gap: undefined,
+            className: undefined,
         };
         return Object.keys(properties);
     })();
@@ -5546,7 +5623,7 @@ define(['exports'], (function (exports) { 'use strict';
                     group: this.groupPanel,
                 });
                 this.watermark = watermark;
-                addDisposableListener(this.watermark.element, 'click', () => {
+                addDisposableListener(this.watermark.element, 'pointerdown', () => {
                     if (!this.isActive) {
                         this.accessor.doSetGroupActive(this.groupPanel);
                     }
@@ -6111,7 +6188,7 @@ define(['exports'], (function (exports) { 'use strict';
                 // forward the resize event to the group since if you want to resize a panel
                 // you are actually just resizing the panels parent which is the group
                 this.group.api.setSize(event);
-            }), this.api.onDidRendererChange((event) => {
+            }), this.api.onDidRendererChange(() => {
                 this.group.model.rerender(this);
             }));
         }
@@ -6447,17 +6524,30 @@ define(['exports'], (function (exports) { 'use strict';
         }
     }
 
-    const bringElementToFront = (() => {
-        let previous = null;
-        function pushToTop(element) {
-            if (previous !== element && previous !== null) {
-                toggleClass(previous, 'dv-bring-to-front', false);
+    const DEFAULT_OVERLAY_Z_INDEX = 999;
+    class AriaLevelTracker {
+        constructor() {
+            this._orderedList = [];
+        }
+        push(element) {
+            this._orderedList = [
+                ...this._orderedList.filter((item) => item !== element),
+                element,
+            ];
+            this.update();
+        }
+        destroy(element) {
+            this._orderedList = this._orderedList.filter((item) => item !== element);
+            this.update();
+        }
+        update() {
+            for (let i = 0; i < this._orderedList.length; i++) {
+                this._orderedList[i].setAttribute('aria-level', `${i}`);
+                this._orderedList[i].style.zIndex = `${DEFAULT_OVERLAY_Z_INDEX + i * 2}`;
             }
-            toggleClass(element, 'dv-bring-to-front', true);
-            previous = element;
         }
-        return pushToTop;
-    })();
+    }
+    const arialLevelTracker = new AriaLevelTracker();
     class Overlay extends CompositeDisposable {
         set minimumInViewportWidth(value) {
             this.options.minimumInViewportWidth = value;
@@ -6465,6 +6555,9 @@ define(['exports'], (function (exports) { 'use strict';
         set minimumInViewportHeight(value) {
             this.options.minimumInViewportHeight = value;
         }
+        get element() {
+            return this._element;
+        }
         constructor(options) {
             super();
             this.options = options;
@@ -6487,6 +6580,10 @@ define(['exports'], (function (exports) { 'use strict';
             this.options.container.appendChild(this._element);
             // if input bad resize within acceptable boundaries
             this.setBounds(Object.assign(Object.assign(Object.assign(Object.assign({ height: this.options.height, width: this.options.width }, ('top' in this.options && { top: this.options.top })), ('bottom' in this.options && { bottom: this.options.bottom })), ('left' in this.options && { left: this.options.left })), ('right' in this.options && { right: this.options.right })));
+            arialLevelTracker.push(this._element);
+        }
+        bringToFront() {
+            arialLevelTracker.push(this._element);
         }
         setBounds(bounds = {}) {
             if (typeof bounds.height === 'number') {
@@ -6574,18 +6671,10 @@ define(['exports'], (function (exports) { 'use strict';
             const move = new MutableDisposable();
             const track = () => {
                 let offset = null;
-                const iframes = [
-                    ...getElementsByTagName('iframe'),
-                    ...getElementsByTagName('webview'),
-                ];
-                for (const iframe of iframes) {
-                    iframe.style.pointerEvents = 'none';
-                }
+                const iframes = disableIframePointEvents();
                 move.value = new CompositeDisposable({
                     dispose: () => {
-                        for (const iframe of iframes) {
-                            iframe.style.pointerEvents = 'auto';
-                        }
+                        iframes.release();
                     },
                 }, addDisposableWindowListener(window, 'mousemove', (e) => {
                     const containerRect = this.options.container.getBoundingClientRect();
@@ -6654,9 +6743,8 @@ define(['exports'], (function (exports) { 'use strict';
                     track();
                 }
             }), addDisposableListener(this.options.content, 'mousedown', () => {
-                bringElementToFront(this._element);
+                arialLevelTracker.push(this._element);
             }, true));
-            bringElementToFront(this._element);
             if (options.inDragMode) {
                 track();
             }
@@ -6669,13 +6757,7 @@ define(['exports'], (function (exports) { 'use strict';
             this.addDisposables(move, addDisposableListener(resizeHandleElement, 'mousedown', (e) => {
                 e.preventDefault();
                 let startPosition = null;
-                const iframes = [
-                    ...getElementsByTagName('iframe'),
-                    ...getElementsByTagName('webview'),
-                ];
-                for (const iframe of iframes) {
-                    iframe.style.pointerEvents = 'none';
-                }
+                const iframes = disableIframePointEvents();
                 move.value = new CompositeDisposable(addDisposableWindowListener(window, 'mousemove', (e) => {
                     const containerRect = this.options.container.getBoundingClientRect();
                     const overlayRect = this._element.getBoundingClientRect();
@@ -6798,9 +6880,7 @@ define(['exports'], (function (exports) { 'use strict';
                     this.setBounds(bounds);
                 }), {
                     dispose: () => {
-                        for (const iframe of iframes) {
-                            iframe.style.pointerEvents = 'auto';
-                        }
+                        iframes.release();
                     },
                 }, addDisposableWindowListener(window, 'mouseup', () => {
                     move.dispose();
@@ -6821,6 +6901,7 @@ define(['exports'], (function (exports) { 'use strict';
             return 0;
         }
         dispose() {
+            arialLevelTracker.destroy(this._element);
             this._element.remove();
             super.dispose();
         }
@@ -6849,9 +6930,10 @@ define(['exports'], (function (exports) { 'use strict';
         return element;
     }
     class OverlayRenderContainer extends CompositeDisposable {
-        constructor(element) {
+        constructor(element, accessor) {
             super();
             this.element = element;
+            this.accessor = accessor;
             this.map = {};
             this._disposed = false;
             this.addDisposables(exports.DockviewDisposable.from(() => {
@@ -6907,7 +6989,35 @@ define(['exports'], (function (exports) { 'use strict';
                 }
                 focusContainer.style.display = panel.api.isVisible ? '' : 'none';
             };
-            const disposable = new CompositeDisposable(
+            const observerDisposable = new MutableDisposable();
+            const correctLayerPosition = () => {
+                if (panel.api.location.type === 'floating') {
+                    queueMicrotask(() => {
+                        const floatingGroup = this.accessor.floatingGroups.find((group) => group.group === panel.api.group);
+                        if (!floatingGroup) {
+                            return;
+                        }
+                        const element = floatingGroup.overlay.element;
+                        const update = () => {
+                            const level = Number(element.getAttribute('aria-level'));
+                            focusContainer.style.zIndex = `${DEFAULT_OVERLAY_Z_INDEX + level * 2 + 1}`;
+                        };
+                        const observer = new MutationObserver(() => {
+                            update();
+                        });
+                        observerDisposable.value = exports.DockviewDisposable.from(() => observer.disconnect());
+                        observer.observe(element, {
+                            attributeFilter: ['aria-level'],
+                            attributes: true,
+                        });
+                        update();
+                    });
+                }
+                else {
+                    focusContainer.style.zIndex = ''; // reset the z-index, perhaps CSS will take over here
+                }
+            };
+            const disposable = new CompositeDisposable(observerDisposable, 
             /**
              * since container is positioned absoutely we must explicitly forward
              * the dnd events for the expect behaviours to continue to occur in terms of dnd
@@ -6931,7 +7041,7 @@ define(['exports'], (function (exports) { 'use strict';
                 onDragOver: (e) => {
                     referenceContainer.dropTarget.dnd.onDragOver(e);
                 },
-            }), panel.api.onDidVisibilityChange((event) => {
+            }), panel.api.onDidVisibilityChange(() => {
                 /**
                  * Control the visibility of the content, however even when not visible (display: none)
                  * the content is still maintained within the DOM hence DOM specific attributes
@@ -6943,6 +7053,8 @@ define(['exports'], (function (exports) { 'use strict';
                     return;
                 }
                 resize();
+            }), panel.api.onDidLocationChange(() => {
+                correctLayerPosition();
             }));
             this.map[panel.api.id].destroy = exports.DockviewDisposable.from(() => {
                 var _a;
@@ -6951,6 +7063,7 @@ define(['exports'], (function (exports) { 'use strict';
                 }
                 (_a = focusContainer.parentElement) === null || _a === void 0 ? void 0 : _a.removeChild(focusContainer);
             });
+            correctLayerPosition();
             queueMicrotask(() => {
                 if (this.isDisposed) {
                     return;
@@ -7199,7 +7312,10 @@ define(['exports'], (function (exports) { 'use strict';
         get gap() {
             return this.gridview.margin;
         }
-        constructor(options) {
+        get floatingGroups() {
+            return this._floatingGroups;
+        }
+        constructor(parentElement, options) {
             var _a;
             super({
                 proportionalLayout: true,
@@ -7207,10 +7323,11 @@ define(['exports'], (function (exports) { 'use strict';
                 styles: options.hideBorders
                     ? { separatorBorder: 'transparent' }
                     : undefined,
-                parentElement: options.parentElement,
+                parentElement: parentElement,
                 disableAutoResizing: options.disableAutoResizing,
                 locked: options.locked,
                 margin: options.gap,
+                className: options.className,
             });
             this.nextGroupId = sequentialNumberGenerator();
             this._deserializer = new DefaultDockviewDeserialzier(this);
@@ -7246,10 +7363,10 @@ define(['exports'], (function (exports) { 'use strict';
             this._onDidActiveGroupChange = new Emitter();
             this.onDidActiveGroupChange = this._onDidActiveGroupChange.event;
             this._moving = false;
-            const gready = document.createElement('div');
-            gready.className = 'dv-overlay-render-container';
-            this.gridview.element.appendChild(gready);
-            this.overlayRenderContainer = new OverlayRenderContainer(gready);
+            // const gready = document.createElement('div');
+            // gready.className = 'dv-overlay-render-container';
+            // this.gridview.element.appendChild(gready);
+            this.overlayRenderContainer = new OverlayRenderContainer(this.gridview.element, this);
             toggleClass(this.gridview.element, 'dv-dockview', true);
             toggleClass(this.element, 'dv-debug', !!options.debug);
             this.addDisposables(this.overlayRenderContainer, this._onWillDragPanel, this._onWillDragGroup, this._onWillShowOverlay, this._onDidActivePanelChange, this._onDidAddPanel, this._onDidRemovePanel, this._onDidLayoutFromJSON, this._onDidDrop, this._onWillDrop, this._onDidMovePanel, this._onDidAddGroup, this._onDidRemoveGroup, this._onDidActiveGroupChange, this._onUnhandledDragOverEvent, this.onDidViewVisibilityChangeMicroTaskQueue(() => {
@@ -7415,7 +7532,7 @@ define(['exports'], (function (exports) { 'use strict';
                 }
                 const gready = document.createElement('div');
                 gready.className = 'dv-overlay-render-container';
-                const overlayRenderContainer = new OverlayRenderContainer(gready);
+                const overlayRenderContainer = new OverlayRenderContainer(gready, this);
                 const referenceGroup = itemToPopout instanceof DockviewPanel
                     ? itemToPopout.group
                     : itemToPopout;
@@ -7564,7 +7681,6 @@ define(['exports'], (function (exports) { 'use strict';
                     }
                 }
             }
-            group.model.location = { type: 'floating' };
             function getAnchoredBox() {
                 if (options === null || options === void 0 ? void 0 : options.position) {
                     const result = {};
@@ -7631,10 +7747,14 @@ define(['exports'], (function (exports) { 'use strict';
                     : false,
             });
             const floatingGroupPanel = new DockviewFloatingGroupPanel(group, overlay);
-            const disposable = watchElementResize(group.element, (entry) => {
+            const disposable = new CompositeDisposable(group.api.onDidActiveChange((event) => {
+                if (event.isActive) {
+                    overlay.bringToFront();
+                }
+            }), watchElementResize(group.element, (entry) => {
                 const { width, height } = entry.contentRect;
                 group.layout(width, height); // let the group know it's size is changing so it can fire events to the panel
-            });
+            }));
             floatingGroupPanel.addDisposables(overlay.onDidChange(() => {
                 // this is either a resize or a move
                 // to inform the panels .layout(...) the group with it's current size
@@ -7650,12 +7770,13 @@ define(['exports'], (function (exports) { 'use strict';
             }), {
                 dispose: () => {
                     disposable.dispose();
-                    group.model.location = { type: 'grid' };
                     remove(this._floatingGroups, floatingGroupPanel);
+                    group.model.location = { type: 'grid' };
                     this.updateWatermark();
                 },
             });
             this._floatingGroups.push(floatingGroupPanel);
+            group.model.location = { type: 'floating' };
             if (!(options === null || options === void 0 ? void 0 : options.skipActiveGroup)) {
                 this.doSetGroupAndPanelActive(group);
             }
@@ -7694,6 +7815,7 @@ define(['exports'], (function (exports) { 'use strict';
         }
         updateOptions(options) {
             var _a, _b;
+            super.updateOptions(options);
             const changed_floatingGroupBounds = 'floatingGroupBounds' in options &&
                 options.floatingGroupBounds !== this.options.floatingGroupBounds;
             const changed_rootOverlayOptions = 'rootOverlayModel' in options &&
@@ -8237,6 +8359,7 @@ define(['exports'], (function (exports) { 'use strict';
                         this._groups.delete(group.id);
                         this._onDidRemoveGroup.fire(group);
                     }
+                    remove(this._popoutGroups, selectedGroup);
                     const removedGroup = selectedGroup.disposable.dispose();
                     if (!(options === null || options === void 0 ? void 0 : options.skipPopoutReturn) && removedGroup) {
                         this.doAddGroup(removedGroup, [0]);
@@ -8348,6 +8471,31 @@ define(['exports'], (function (exports) { 'use strict';
                             return;
                         }
                     }
+                    if (sourceGroup.api.location.type === 'popout') {
+                        /**
+                         * the source group is a popout group with a single panel
+                         *
+                         * 1. remove the panel from the group without triggering any events
+                         * 2. remove the popout group
+                         * 3. create a new group at the requested location and add that panel
+                         */
+                        const popoutGroup = this._popoutGroups.find((group) => group.popoutGroup === sourceGroup);
+                        const removedPanel = this.movingLock(() => popoutGroup.popoutGroup.model.removePanel(popoutGroup.popoutGroup.panels[0], {
+                            skipSetActive: true,
+                            skipSetActiveGroup: true,
+                        }));
+                        this.doRemoveGroup(sourceGroup, { skipActive: true });
+                        const newGroup = this.createGroupAtLocation(targetLocation);
+                        this.movingLock(() => newGroup.model.openPanel(removedPanel, {
+                            skipSetActive: true,
+                        }));
+                        this.doSetGroupAndPanelActive(newGroup);
+                        this._onDidMovePanel.fire({
+                            panel: this.getGroupPanel(sourceItemId),
+                            from: sourceGroup,
+                        });
+                        return;
+                    }
                     // source group will become empty so delete the group
                     const targetGroup = this.movingLock(() => this.doRemoveGroup(sourceGroup, {
                         skipActive: true,
@@ -8579,13 +8727,14 @@ define(['exports'], (function (exports) { 'use strict';
         set deserializer(value) {
             this._deserializer = value;
         }
-        constructor(options) {
+        constructor(parentElement, options) {
             super({
-                parentElement: options.parentElement,
+                parentElement: parentElement,
                 proportionalLayout: options.proportionalLayout,
                 orientation: options.orientation,
                 styles: options.styles,
                 disableAutoResizing: options.disableAutoResizing,
+                className: options.className,
             });
             this._onDidLayoutfromJSON = new Emitter();
             this.onDidLayoutFromJSON = this._onDidLayoutfromJSON.event;
@@ -8611,6 +8760,7 @@ define(['exports'], (function (exports) { 'use strict';
             }
         }
         updateOptions(options) {
+            super.updateOptions(options);
             const hasOrientationChanged = typeof options.orientation === 'string' &&
                 this.gridview.orientation !== options.orientation;
             this._options = Object.assign(Object.assign({}, this.options), options);
@@ -8877,8 +9027,9 @@ define(['exports'], (function (exports) { 'use strict';
                 ? this.splitview.size
                 : this.splitview.orthogonalSize;
         }
-        constructor(options) {
-            super(options.parentElement, options.disableAutoResizing);
+        constructor(parentElement, options) {
+            var _a, _b;
+            super(parentElement, options.disableAutoResizing);
             this._splitviewChangeDisposable = new MutableDisposable();
             this._panels = new Map();
             this._onDidLayoutfromJSON = new Emitter();
@@ -8889,6 +9040,11 @@ define(['exports'], (function (exports) { 'use strict';
             this.onDidRemoveView = this._onDidRemoveView.event;
             this._onDidLayoutChange = new Emitter();
             this.onDidLayoutChange = this._onDidLayoutChange.event;
+            this.classNames = [];
+            this.classNames = (_b = (_a = options.className) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+            for (const className of this.classNames) {
+                toggleClass(this.element, className, true);
+            }
             this._options = options;
             if (!options.components) {
                 options.components = {};
@@ -8900,6 +9056,16 @@ define(['exports'], (function (exports) { 'use strict';
             this.addDisposables(this._onDidAddView, this._onDidLayoutfromJSON, this._onDidRemoveView, this._onDidLayoutChange);
         }
         updateOptions(options) {
+            var _a, _b;
+            if ('className' in options) {
+                for (const className of this.classNames) {
+                    toggleClass(this.element, className, false);
+                }
+                this.classNames = (_b = (_a = options.className) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+                for (const className of this.classNames) {
+                    toggleClass(this.element, className, true);
+                }
+            }
             const hasOrientationChanged = typeof options.orientation === 'string' &&
                 this.options.orientation !== options.orientation;
             this._options = Object.assign(Object.assign({}, this.options), options);
@@ -9201,8 +9367,9 @@ define(['exports'], (function (exports) { 'use strict';
         get options() {
             return this._options;
         }
-        constructor(options) {
-            super(options.parentElement, options.disableAutoResizing);
+        constructor(parentElement, options) {
+            var _a, _b;
+            super(parentElement, options.disableAutoResizing);
             this._id = nextLayoutId.next();
             this._disposable = new MutableDisposable();
             this._viewDisposables = new Map();
@@ -9216,7 +9383,12 @@ define(['exports'], (function (exports) { 'use strict';
             this.onDidAddView = this._onDidAddView.event;
             this._onDidRemoveView = new Emitter();
             this.onDidRemoveView = this._onDidRemoveView.event;
+            this.classNames = [];
             this.addDisposables(this._onDidLayoutChange, this._onDidLayoutfromJSON, this._onDidDrop, this._onDidAddView, this._onDidRemoveView);
+            this.classNames = (_b = (_a = options.className) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+            for (const className of this.classNames) {
+                toggleClass(this.element, className, true);
+            }
             this._options = options;
             if (!options.components) {
                 options.components = {};
@@ -9238,6 +9410,16 @@ define(['exports'], (function (exports) { 'use strict';
             //noop
         }
         updateOptions(options) {
+            var _a, _b;
+            if ('className' in options) {
+                for (const className of this.classNames) {
+                    toggleClass(this.element, className, false);
+                }
+                this.classNames = (_b = (_a = options.className) === null || _a === void 0 ? void 0 : _a.split(' ')) !== null && _b !== void 0 ? _b : [];
+                for (const className of this.classNames) {
+                    toggleClass(this.element, className, true);
+                }
+            }
             this._options = Object.assign(Object.assign({}, this.options), options);
         }
         addPanel(options) {
@@ -9531,6 +9713,23 @@ define(['exports'], (function (exports) { 'use strict';
         }
     }
 
+    function createDockview(element, options) {
+        const component = new DockviewComponent(element, options);
+        return component.api;
+    }
+    function createSplitview(element, options) {
+        const component = new SplitviewComponent(element, options);
+        return new SplitviewApi(component);
+    }
+    function createGridview(element, options) {
+        const component = new GridviewComponent(element, options);
+        return new GridviewApi(component);
+    }
+    function createPaneview(element, options) {
+        const component = new PaneviewComponent(element, options);
+        return new PaneviewApi(component);
+    }
+
     exports.BaseGrid = BaseGrid;
     exports.ContentContainer = ContentContainer;
     exports.DefaultDockviewDeserialzier = DefaultDockviewDeserialzier;
@@ -9567,6 +9766,10 @@ define(['exports'], (function (exports) { 'use strict';
     exports.Tab = Tab;
     exports.WillShowOverlayLocationEvent = WillShowOverlayLocationEvent;
     exports.createComponent = createComponent;
+    exports.createDockview = createDockview;
+    exports.createGridview = createGridview;
+    exports.createPaneview = createPaneview;
+    exports.createSplitview = createSplitview;
     exports.directionToPosition = directionToPosition;
     exports.getDirectionOrientation = getDirectionOrientation;
     exports.getGridLocation = getGridLocation;