dockview-core 1.17.1 → 2.0.0

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

@@ -1,6 +1,6 @@
 /**
  * dockview-core
- * @version 1.17.1
+ * @version 2.0.0
  * @link https://github.com/mathuo/dockview
  * @license MIT
  */
@@ -324,31 +324,6 @@ define(['exports'], (function (exports) { 'use strict';
         }
     }
 
-    function createComponent(id, componentName, components = {}, frameworkComponents = {}, createFrameworkComponent, fallback) {
-        const Component = typeof componentName === 'string'
-            ? components[componentName]
-            : undefined;
-        const FrameworkComponent = typeof componentName === 'string'
-            ? frameworkComponents[componentName]
-            : undefined;
-        if (Component && FrameworkComponent) {
-            throw new Error(`Cannot create '${id}'. component '${componentName}' registered as both a component and frameworkComponent`);
-        }
-        if (FrameworkComponent) {
-            if (!createFrameworkComponent) {
-                throw new Error(`Cannot create '${id}' for framework component '${componentName}'. you must register a frameworkPanelWrapper to use framework components`);
-            }
-            return createFrameworkComponent.createComponent(id, componentName, FrameworkComponent);
-        }
-        if (!Component) {
-            if (fallback) {
-                return fallback();
-            }
-            throw new Error(`Cannot create '${id}', no component '${componentName}' provided`);
-        }
-        return new Component(id, componentName);
-    }
-
     function watchElementResize(element, cb) {
         const observer = new ResizeObserver((entires) => {
             /**
@@ -817,10 +792,10 @@ define(['exports'], (function (exports) { 'use strict';
             const tmp = this.size;
             this.size = this.orthogonalSize;
             this.orthogonalSize = tmp;
-            removeClasses(this.element, 'horizontal', 'vertical');
+            removeClasses(this.element, 'dv-horizontal', 'dv-vertical');
             this.element.classList.add(this.orientation == exports.Orientation.HORIZONTAL
-                ? 'horizontal'
-                : 'vertical');
+                ? 'dv-horizontal'
+                : 'dv-vertical');
         }
         get minimumSize() {
             return this.viewItems.reduce((r, item) => r + item.minimumSize, 0);
@@ -998,11 +973,11 @@ define(['exports'], (function (exports) { 'use strict';
         }
         style(styles) {
             if ((styles === null || styles === void 0 ? void 0 : styles.separatorBorder) === 'transparent') {
-                removeClasses(this.element, 'separator-border');
+                removeClasses(this.element, 'dv-separator-border');
                 this.element.style.removeProperty('--dv-separator-border');
             }
             else {
-                addClasses(this.element, 'separator-border');
+                addClasses(this.element, 'dv-separator-border');
                 if (styles === null || styles === void 0 ? void 0 : styles.separatorBorder) {
                     this.element.style.setProperty('--dv-separator-border', styles.separatorBorder);
                 }
@@ -1072,7 +1047,7 @@ define(['exports'], (function (exports) { 'use strict';
         }
         addView(view, size = { type: 'distribute' }, index = this.viewItems.length, skipLayout) {
             const container = document.createElement('div');
-            container.className = 'view';
+            container.className = 'dv-view';
             container.appendChild(view.element);
             let viewSize;
             if (typeof size === 'number') {
@@ -1104,7 +1079,7 @@ define(['exports'], (function (exports) { 'use strict';
             if (this.viewItems.length > 1) {
                 //add sash
                 const sash = document.createElement('div');
-                sash.className = 'sash';
+                sash.className = 'dv-sash';
                 const onPointerStart = (event) => {
                     for (const item of this.viewItems) {
                         item.enabled = false;
@@ -1363,7 +1338,8 @@ define(['exports'], (function (exports) { 'use strict';
                 const offset = i === 0 || visiblePanelsBeforeThisView === 0
                     ? 0
                     : viewLeftOffsets[i - 1] +
-                        (visiblePanelsBeforeThisView / sashCount) * marginReducedSize;
+                        (visiblePanelsBeforeThisView / sashCount) *
+                            marginReducedSize;
                 if (i < this.viewItems.length - 1) {
                     // calculate sash position
                     const newSize = view.visible
@@ -1474,27 +1450,27 @@ define(['exports'], (function (exports) { 'use strict';
             }
         }
         updateSash(sash, state) {
-            toggleClass(sash.container, 'disabled', state === exports.SashState.DISABLED);
-            toggleClass(sash.container, 'enabled', state === exports.SashState.ENABLED);
-            toggleClass(sash.container, 'maximum', state === exports.SashState.MAXIMUM);
-            toggleClass(sash.container, 'minimum', state === exports.SashState.MINIMUM);
+            toggleClass(sash.container, 'dv-disabled', state === exports.SashState.DISABLED);
+            toggleClass(sash.container, 'dv-enabled', state === exports.SashState.ENABLED);
+            toggleClass(sash.container, 'dv-maximum', state === exports.SashState.MAXIMUM);
+            toggleClass(sash.container, 'dv-minimum', state === exports.SashState.MINIMUM);
         }
         createViewContainer() {
             const element = document.createElement('div');
-            element.className = 'view-container';
+            element.className = 'dv-view-container';
             return element;
         }
         createSashContainer() {
             const element = document.createElement('div');
-            element.className = 'sash-container';
+            element.className = 'dv-sash-container';
             return element;
         }
         createContainer() {
             const element = document.createElement('div');
             const orientationClassname = this._orientation === exports.Orientation.HORIZONTAL
-                ? 'horizontal'
-                : 'vertical';
-            element.className = `split-view-container ${orientationClassname}`;
+                ? 'dv-horizontal'
+                : 'dv-vertical';
+            element.className = `dv-split-view-container ${orientationClassname}`;
             return element;
         }
         dispose() {
@@ -1545,7 +1521,7 @@ define(['exports'], (function (exports) { 'use strict';
             this.onDidChange = this._onDidChange.event;
             this._orientation = (_a = options.orientation) !== null && _a !== void 0 ? _a : exports.Orientation.VERTICAL;
             this.element = document.createElement('div');
-            this.element.className = 'pane-container';
+            this.element.className = 'dv-pane-container';
             container.appendChild(this.element);
             this.splitview = new Splitview(this.element, {
                 orientation: this._orientation,
@@ -1637,10 +1613,10 @@ define(['exports'], (function (exports) { 'use strict';
                 clearTimeout(this.animationTimer);
                 this.animationTimer = undefined;
             }
-            addClasses(this.element, 'animated');
+            addClasses(this.element, 'dv-animated');
             this.animationTimer = setTimeout(() => {
                 this.animationTimer = undefined;
-                removeClasses(this.element, 'animated');
+                removeClasses(this.element, 'dv-animated');
             }, 200);
         }
         dispose() {
@@ -1865,7 +1841,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._orthogonalSize = orthogonalSize;
             this._size = size;
             this.element = document.createElement('div');
-            this.element.className = 'branch-node';
+            this.element.className = 'dv-branch-node';
             if (!childDescriptors) {
                 this.splitview = new Splitview(this.element, {
                     orientation: this.orientation,
@@ -2076,7 +2052,7 @@ define(['exports'], (function (exports) { 'use strict';
         if (!parentElement) {
             throw new Error('Invalid grid element');
         }
-        if (/\bgrid-view\b/.test(parentElement.className)) {
+        if (/\bdv-grid-view\b/.test(parentElement.className)) {
             return [];
         }
         const index = indexInParent(parentElement);
@@ -2424,7 +2400,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._onDidMaximizedNodeChange = new Emitter();
             this.onDidMaximizedNodeChange = this._onDidMaximizedNodeChange.event;
             this.element = document.createElement('div');
-            this.element.className = 'grid-view';
+            this.element.className = 'dv-grid-view';
             this._locked = locked !== null && locked !== void 0 ? locked : false;
             this._margin = margin !== null && margin !== void 0 ? margin : 0;
             this.root = new BranchNode(orientation, proportionalLayout, styles, 0, 0, this.locked, this.margin);
@@ -3646,7 +3622,7 @@ define(['exports'], (function (exports) { 'use strict';
                          * dnd logic. You can see the code at
                          * https://github.com/react-dnd/react-dnd/blob/main/packages/backend-html5/src/HTML5BackendImpl.ts#L542
                          */
-                        event.dataTransfer.setData('text/plain', '__dockview_internal_drag_event__');
+                        event.dataTransfer.setData('text/plain', '');
                     }
                 }
             }), addDisposableListener(this.el, 'dragend', () => {
@@ -3820,12 +3796,12 @@ define(['exports'], (function (exports) { 'use strict';
                     this.markAsUsed(e);
                     if (!this.targetElement) {
                         this.targetElement = document.createElement('div');
-                        this.targetElement.className = 'drop-target-dropzone';
+                        this.targetElement.className = 'dv-drop-target-dropzone';
                         this.overlayElement = document.createElement('div');
-                        this.overlayElement.className = 'drop-target-selection';
+                        this.overlayElement.className = 'dv-drop-target-selection';
                         this._state = 'center';
                         this.targetElement.appendChild(this.overlayElement);
-                        this.element.classList.add('drop-target');
+                        this.element.classList.add('dv-drop-target');
                         this.element.append(this.targetElement);
                     }
                     this.toggleClasses(quadrant, width, height);
@@ -3963,7 +3939,7 @@ define(['exports'], (function (exports) { 'use strict';
                 this.element.removeChild(this.targetElement);
                 this.targetElement = undefined;
                 this.overlayElement = undefined;
-                this.element.classList.remove('drop-target');
+                this.element.classList.remove('dv-drop-target');
             }
         }
     }
@@ -4300,7 +4276,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._headerVisible = isHeaderVisible;
             this._onDidChangeExpansionState.fire(this.isExpanded()); // initialize value
             this._orientation = orientation;
-            this.element.classList.add('pane');
+            this.element.classList.add('dv-pane');
             this.addDisposables(this.api.onWillVisibilityChange((event) => {
                 const { isVisible } = event;
                 const { accessor } = this._params;
@@ -4397,14 +4373,14 @@ define(['exports'], (function (exports) { 'use strict';
         renderOnce() {
             this.header = document.createElement('div');
             this.header.tabIndex = 0;
-            this.header.className = 'pane-header';
+            this.header.className = 'dv-pane-header';
             this.header.style.height = `${this.headerSize}px`;
             this.header.style.lineHeight = `${this.headerSize}px`;
             this.header.style.minHeight = `${this.headerSize}px`;
             this.header.style.maxHeight = `${this.headerSize}px`;
             this.element.appendChild(this.header);
             this.body = document.createElement('div');
-            this.body.className = 'pane-body';
+            this.body.className = 'dv-pane-body';
             this.element.appendChild(this.body);
         }
         // TODO slightly hacky by-pass of the component to create a body and header component
@@ -4525,7 +4501,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._onDidBlur = new Emitter();
             this.onDidBlur = this._onDidBlur.event;
             this._element = document.createElement('div');
-            this._element.className = 'content-container';
+            this._element.className = 'dv-content-container';
             this._element.tabIndex = -1;
             this.addDisposables(this._onDidFocus, this._onDidBlur);
             this.dropTarget = new Droptarget(this.element, {
@@ -4598,6 +4574,8 @@ define(['exports'], (function (exports) { 'use strict';
                         referenceContainer: this,
                     });
                     break;
+                default:
+                    throw new Error(`dockview: invalid renderer type '${panel.api.renderer}'`);
             }
             if (doRender) {
                 const focusTracker = trackFocus(container);
@@ -4664,10 +4642,10 @@ define(['exports'], (function (exports) { 'use strict';
             this._onDragStart = new Emitter();
             this.onDragStart = this._onDragStart.event;
             this._element = document.createElement('div');
-            this._element.className = 'tab';
+            this._element.className = 'dv-tab';
             this._element.tabIndex = 0;
             this._element.draggable = true;
-            toggleClass(this.element, 'inactive-tab', true);
+            toggleClass(this.element, 'dv-inactive-tab', true);
             const dragHandler = new TabDragHandler(this._element, this.accessor, this.group, this.panel);
             this.dropTarget = new Droptarget(this._element, {
                 acceptedTargetZones: ['center'],
@@ -4700,8 +4678,8 @@ define(['exports'], (function (exports) { 'use strict';
             }), this.dropTarget);
         }
         setActive(isActive) {
-            toggleClass(this.element, 'active-tab', isActive);
-            toggleClass(this.element, 'inactive-tab', !isActive);
+            toggleClass(this.element, 'dv-active-tab', isActive);
+            toggleClass(this.element, 'dv-inactive-tab', !isActive);
         }
         setContent(part) {
             if (this.content) {
@@ -4789,7 +4767,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._onDragStart = new Emitter();
             this.onDragStart = this._onDragStart.event;
             this._element = document.createElement('div');
-            this._element.className = 'void-container';
+            this._element.className = 'dv-void-container';
             this._element.tabIndex = 0;
             this._element.draggable = true;
             this.addDisposables(this._onDrop, this._onDragStart, addDisposableListener(this._element, 'pointerdown', () => {
@@ -4909,16 +4887,16 @@ define(['exports'], (function (exports) { 'use strict';
             this._onWillShowOverlay = new Emitter();
             this.onWillShowOverlay = this._onWillShowOverlay.event;
             this._element = document.createElement('div');
-            this._element.className = 'tabs-and-actions-container';
+            this._element.className = 'dv-tabs-and-actions-container';
             toggleClass(this._element, 'dv-full-width-single-tab', this.accessor.options.singleTabMode === 'fullwidth');
             this.rightActionsContainer = document.createElement('div');
-            this.rightActionsContainer.className = 'right-actions-container';
+            this.rightActionsContainer.className = 'dv-right-actions-container';
             this.leftActionsContainer = document.createElement('div');
-            this.leftActionsContainer.className = 'left-actions-container';
+            this.leftActionsContainer.className = 'dv-left-actions-container';
             this.preActionsContainer = document.createElement('div');
-            this.preActionsContainer.className = 'pre-actions-container';
+            this.preActionsContainer.className = 'dv-pre-actions-container';
             this.tabContainer = document.createElement('div');
-            this.tabContainer.className = 'tabs-container';
+            this.tabContainer.className = 'dv-tabs-container';
             this.voidContainer = new VoidContainer(this.accessor, this.group);
             this._element.appendChild(this.preActionsContainer);
             this._element.appendChild(this.tabContainer);
@@ -5007,14 +4985,10 @@ define(['exports'], (function (exports) { 'use strict';
             });
         }
         openPanel(panel, index = this.tabs.length) {
-            var _a;
             if (this.tabs.find((tab) => tab.value.panel.id === panel.id)) {
                 return;
             }
             const tab = new Tab(panel, this.accessor, this.group);
-            if (!((_a = panel.view) === null || _a === void 0 ? void 0 : _a.tab)) {
-                throw new Error('invalid header component');
-            }
             tab.setContent(panel.view.tab);
             const disposable = new CompositeDisposable(tab.onDragStart((event) => {
                 this._onTabDragStart.fire({ nativeEvent: event, panel });
@@ -5204,7 +5178,7 @@ define(['exports'], (function (exports) { 'use strict';
     }
     class DockviewGroupPanelModel extends CompositeDisposable {
         get element() {
-            throw new Error('not supported');
+            throw new Error('dockview: not supported');
         }
         get activePanel() {
             return this._activePanel;
@@ -5214,7 +5188,7 @@ define(['exports'], (function (exports) { 'use strict';
         }
         set locked(value) {
             this._locked = value;
-            toggleClass(this.container, 'locked-groupview', value === 'no-drop-target' || value);
+            toggleClass(this.container, 'dv-locked-groupview', value === 'no-drop-target' || value);
         }
         get isActive() {
             return this._isGroupActive;
@@ -5285,6 +5259,7 @@ define(['exports'], (function (exports) { 'use strict';
             this._locked = false;
             this._location = { type: 'grid' };
             this.mostRecentlyUsed = [];
+            this._overwriteRenderContainer = null;
             this._onDidChange = new Emitter();
             this.onDidChange = this._onDidChange.event;
             this._width = 0;
@@ -5315,8 +5290,7 @@ define(['exports'], (function (exports) { 'use strict';
             this.onDidActivePanelChange = this._onDidActivePanelChange.event;
             this._onUnhandledDragOverEvent = new Emitter();
             this.onUnhandledDragOverEvent = this._onUnhandledDragOverEvent.event;
-            this._overwriteRenderContainer = null;
-            toggleClass(this.container, 'groupview', true);
+            toggleClass(this.container, 'dv-groupview', true);
             this._api = new DockviewApi(this.accessor);
             this.tabsContainer = new TabsContainer(this.accessor, this.groupPanel);
             this.contentContainer = new ContentContainer(this.accessor, this);
@@ -5561,8 +5535,8 @@ define(['exports'], (function (exports) { 'use strict';
                 return;
             }
             this._isGroupActive = isGroupActive;
-            toggleClass(this.container, 'active-group', isGroupActive);
-            toggleClass(this.container, 'inactive-group', !isGroupActive);
+            toggleClass(this.container, 'dv-active-group', isGroupActive);
+            toggleClass(this.container, 'dv-inactive-group', !isGroupActive);
             this.tabsContainer.setActive(this.isActive);
             if (!this._activePanel && this.panels.length > 0) {
                 this.doSetActivePanel(this.panels[0]);
@@ -5654,7 +5628,7 @@ define(['exports'], (function (exports) { 'use strict';
         }
         updateContainer() {
             var _a, _b;
-            toggleClass(this.container, 'empty', this.isEmpty);
+            toggleClass(this.container, 'dv-empty', this.isEmpty);
             this.panels.forEach((panel) => panel.runEvents());
             if (this.isEmpty && !this.watermark) {
                 const watermark = this.accessor.createWatermarkComponent();
@@ -5795,6 +5769,34 @@ define(['exports'], (function (exports) { 'use strict';
             return this._snap;
         }
         get minimumWidth() {
+            /**
+             * defer to protected function to allow subclasses to override easily.
+             * see https://github.com/microsoft/TypeScript/issues/338
+             */
+            return this.__minimumWidth();
+        }
+        get minimumHeight() {
+            /**
+             * defer to protected function to allow subclasses to override easily.
+             * see https://github.com/microsoft/TypeScript/issues/338
+             */
+            return this.__minimumHeight();
+        }
+        get maximumHeight() {
+            /**
+             * defer to protected function to allow subclasses to override easily.
+             * see https://github.com/microsoft/TypeScript/issues/338
+             */
+            return this.__maximumHeight();
+        }
+        get maximumWidth() {
+            /**
+             * defer to protected function to allow subclasses to override easily.
+             * see https://github.com/microsoft/TypeScript/issues/338
+             */
+            return this.__maximumWidth();
+        }
+        __minimumWidth() {
             const width = typeof this._minimumWidth === 'function'
                 ? this._minimumWidth()
                 : this._minimumWidth;
@@ -5804,7 +5806,17 @@ define(['exports'], (function (exports) { 'use strict';
             }
             return width;
         }
-        get minimumHeight() {
+        __maximumWidth() {
+            const width = typeof this._maximumWidth === 'function'
+                ? this._maximumWidth()
+                : this._maximumWidth;
+            if (width !== this._evaluatedMaximumWidth) {
+                this._evaluatedMaximumWidth = width;
+                this.updateConstraints();
+            }
+            return width;
+        }
+        __minimumHeight() {
             const height = typeof this._minimumHeight === 'function'
                 ? this._minimumHeight()
                 : this._minimumHeight;
@@ -5814,7 +5826,7 @@ define(['exports'], (function (exports) { 'use strict';
             }
             return height;
         }
-        get maximumHeight() {
+        __maximumHeight() {
             const height = typeof this._maximumHeight === 'function'
                 ? this._maximumHeight()
                 : this._maximumHeight;
@@ -5824,16 +5836,6 @@ define(['exports'], (function (exports) { 'use strict';
             }
             return height;
         }
-        get maximumWidth() {
-            const width = typeof this._maximumWidth === 'function'
-                ? this._maximumWidth()
-                : this._maximumWidth;
-            if (width !== this._evaluatedMaximumWidth) {
-                this._evaluatedMaximumWidth = width;
-                this.updateConstraints();
-            }
-            return width;
-        }
         get isActive() {
             return this.api.isActive;
         }
@@ -5984,6 +5986,7 @@ define(['exports'], (function (exports) { 'use strict';
                     position: options.group
                         ? (_c = options.position) !== null && _c !== void 0 ? _c : 'center'
                         : 'center',
+                    index: options.index,
                 },
             });
         }
@@ -6035,30 +6038,34 @@ define(['exports'], (function (exports) { 'use strict';
         get minimumWidth() {
             var _a;
             const activePanelMinimumWidth = (_a = this.activePanel) === null || _a === void 0 ? void 0 : _a.minimumWidth;
-            return typeof activePanelMinimumWidth === 'number'
-                ? activePanelMinimumWidth
-                : MINIMUM_DOCKVIEW_GROUP_PANEL_WIDTH;
+            if (typeof activePanelMinimumWidth === 'number') {
+                return activePanelMinimumWidth;
+            }
+            return super.__minimumWidth();
         }
         get minimumHeight() {
             var _a;
             const activePanelMinimumHeight = (_a = this.activePanel) === null || _a === void 0 ? void 0 : _a.minimumHeight;
-            return typeof activePanelMinimumHeight === 'number'
-                ? activePanelMinimumHeight
-                : MINIMUM_DOCKVIEW_GROUP_PANEL_HEIGHT;
+            if (typeof activePanelMinimumHeight === 'number') {
+                return activePanelMinimumHeight;
+            }
+            return super.__minimumHeight();
         }
         get maximumWidth() {
             var _a;
             const activePanelMaximumWidth = (_a = this.activePanel) === null || _a === void 0 ? void 0 : _a.maximumWidth;
-            return typeof activePanelMaximumWidth === 'number'
-                ? activePanelMaximumWidth
-                : Number.MAX_SAFE_INTEGER;
+            if (typeof activePanelMaximumWidth === 'number') {
+                return activePanelMaximumWidth;
+            }
+            return super.__maximumWidth();
         }
         get maximumHeight() {
             var _a;
             const activePanelMaximumHeight = (_a = this.activePanel) === null || _a === void 0 ? void 0 : _a.maximumHeight;
-            return typeof activePanelMaximumHeight === 'number'
-                ? activePanelMaximumHeight
-                : Number.MAX_SAFE_INTEGER;
+            if (typeof activePanelMaximumHeight === 'number') {
+                return activePanelMaximumHeight;
+            }
+            return super.__maximumHeight();
         }
         get panels() {
             return this._model.panels;
@@ -6172,12 +6179,14 @@ define(['exports'], (function (exports) { 'use strict';
             return this.group.api.getWindow();
         }
         moveTo(options) {
-            var _a;
+            var _a, _b;
             this.accessor.moveGroupOrPanel({
                 from: { groupId: this._group.id, panelId: this.panel.id },
                 to: {
-                    group: options.group,
-                    position: (_a = options.position) !== null && _a !== void 0 ? _a : 'center',
+                    group: (_a = options.group) !== null && _a !== void 0 ? _a : this._group,
+                    position: options.group
+                        ? (_b = options.position) !== null && _b !== void 0 ? _b : 'center'
+                        : 'center',
                     index: options.index,
                 },
             });
@@ -6396,7 +6405,7 @@ define(['exports'], (function (exports) { 'use strict';
         svg.setAttributeNS(null, 'viewBox', params.viewbox);
         svg.setAttributeNS(null, 'aria-hidden', 'false');
         svg.setAttributeNS(null, 'focusable', 'false');
-        svg.classList.add('dockview-svg');
+        svg.classList.add('dv-svg');
         const path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
         path.setAttributeNS(null, 'd', params.path);
         svg.appendChild(path);
@@ -6567,19 +6576,19 @@ define(['exports'], (function (exports) { 'use strict';
         constructor() {
             super();
             this._element = document.createElement('div');
-            this._element.className = 'watermark';
+            this._element.className = 'dv-watermark';
             const title = document.createElement('div');
-            title.className = 'watermark-title';
+            title.className = 'dv-watermark-title';
             const emptySpace = document.createElement('span');
             emptySpace.style.flexGrow = '1';
             const content = document.createElement('div');
-            content.className = 'watermark-content';
+            content.className = 'dv-watermark-content';
             this._element.appendChild(title);
             this._element.appendChild(content);
             const actionsContainer = document.createElement('div');
-            actionsContainer.className = 'actions-container';
+            actionsContainer.className = 'dv-actions-container';
             const closeAnchor = document.createElement('div');
-            closeAnchor.className = 'close-action';
+            closeAnchor.className = 'dv-close-action';
             closeAnchor.appendChild(createCloseButton());
             actionsContainer.appendChild(closeAnchor);
             title.appendChild(emptySpace);
@@ -6599,11 +6608,10 @@ define(['exports'], (function (exports) { 'use strict';
         }
         render() {
             const isOneGroup = !!(this._api && this._api.size <= 1);
-            toggleClass(this.element, 'has-actions', isOneGroup);
+            toggleClass(this.element, 'dv-has-actions', isOneGroup);
         }
     }
 
-    const DEFAULT_OVERLAY_Z_INDEX = 999;
     class AriaLevelTracker {
         constructor() {
             this._orderedList = [];
@@ -6622,7 +6630,7 @@ define(['exports'], (function (exports) { 'use strict';
         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}`;
+                this._orderedList[i].style.zIndex = `calc(var(--dv-overlay-z-index, 999) + ${i * 2})`;
             }
         }
     }
@@ -7079,7 +7087,7 @@ define(['exports'], (function (exports) { 'use strict';
                         const element = floatingGroup.overlay.element;
                         const update = () => {
                             const level = Number(element.getAttribute('aria-level'));
-                            focusContainer.style.zIndex = `${DEFAULT_OVERLAY_Z_INDEX + level * 2 + 1}`;
+                            focusContainer.style.zIndex = `calc(var(--dv-overlay-z-index, 999) + ${level * 2 + 1})`;
                         };
                         const observer = new MutationObserver(() => {
                             update();
@@ -7234,7 +7242,6 @@ define(['exports'], (function (exports) { 'use strict';
                     window: this._window.value,
                 });
                 this._window.disposable.dispose();
-                this._window.value.close();
                 this._window = null;
                 this._onDidClose.fire();
             }
@@ -7266,7 +7273,9 @@ define(['exports'], (function (exports) { 'use strict';
                 }
                 const disposable = new CompositeDisposable();
                 this._window = { value: externalWindow, disposable };
-                disposable.addDisposables(addDisposableWindowListener(window, 'beforeunload', () => {
+                disposable.addDisposables(exports.DockviewDisposable.from(() => {
+                    externalWindow.close();
+                }), addDisposableWindowListener(window, 'beforeunload', () => {
                     /**
                      * before the main window closes we should close this popup too
                      * to be good citizens
@@ -7283,7 +7292,7 @@ define(['exports'], (function (exports) { 'use strict';
                     id: this.target,
                     window: externalWindow,
                 });
-                return new Promise((resolve) => {
+                return new Promise((resolve, reject) => {
                     externalWindow.addEventListener('unload', (e) => {
                         // if page fails to load before unloading
                         // this.close();
@@ -7292,21 +7301,27 @@ define(['exports'], (function (exports) { 'use strict';
                         /**
                          * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/load_event
                          */
-                        const externalDocument = externalWindow.document;
-                        externalDocument.title = document.title;
-                        externalDocument.body.appendChild(container);
-                        addStyles(externalDocument, window.document.styleSheets);
-                        /**
-                         * beforeunload must be registered after load for reasons I could not determine
-                         * otherwise the beforeunload event will not fire when the window is closed
-                         */
-                        addDisposableWindowListener(externalWindow, 'beforeunload', () => {
+                        try {
+                            const externalDocument = externalWindow.document;
+                            externalDocument.title = document.title;
+                            externalDocument.body.appendChild(container);
+                            addStyles(externalDocument, window.document.styleSheets);
                             /**
-                             * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/beforeunload_event
+                             * beforeunload must be registered after load for reasons I could not determine
+                             * otherwise the beforeunload event will not fire when the window is closed
                              */
-                            this.close();
-                        });
-                        resolve(container);
+                            addDisposableWindowListener(externalWindow, 'beforeunload', () => {
+                                /**
+                                 * @see https://developer.mozilla.org/en-US/docs/Web/API/Window/beforeunload_event
+                                 */
+                                this.close();
+                            });
+                            resolve(container);
+                        }
+                        catch (err) {
+                            // only except this is the DOM isn't setup. e.g. in a in correctly configured test
+                            reject(err);
+                        }
                     });
                 });
             });
@@ -7559,9 +7574,6 @@ define(['exports'], (function (exports) { 'use strict';
             }
             const box = getBox();
             const groupId = (_b = (_a = options === null || options === void 0 ? void 0 : options.overridePopoutGroup) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : this.getNextGroupId();
-            if (itemToPopout.api.location.type === 'grid') {
-                itemToPopout.api.setVisible(false);
-            }
             const _window = new PopoutWindow(`${this.id}-${groupId}`, // unique id
             theme !== null && theme !== void 0 ? theme : '', {
                 url: (_c = options === null || options === void 0 ? void 0 : options.popoutUrl) !== null && _c !== void 0 ? _c : '/popout.html',
@@ -7580,11 +7592,11 @@ define(['exports'], (function (exports) { 'use strict';
                 .then((popoutContainer) => {
                 var _a;
                 if (_window.isDisposed) {
-                    return;
+                    return false;
                 }
                 if (popoutContainer === null) {
                     popoutWindowDisposable.dispose();
-                    return;
+                    return false;
                 }
                 const gready = document.createElement('div');
                 gready.className = 'dv-overlay-render-container';
@@ -7593,30 +7605,40 @@ define(['exports'], (function (exports) { 'use strict';
                     ? itemToPopout.group
                     : itemToPopout;
                 const referenceLocation = itemToPopout.api.location.type;
-                const group = (_a = options === null || options === void 0 ? void 0 : options.overridePopoutGroup) !== null && _a !== void 0 ? _a : this.createGroup({ id: groupId });
+                /**
+                 * The group that is being added doesn't already exist within the DOM, the most likely occurance
+                 * of this case is when being called from the `fromJSON(...)` method
+                 */
+                const isGroupAddedToDom = referenceGroup.element.parentElement !== null;
+                const group = !isGroupAddedToDom
+                    ? referenceGroup
+                    : (_a = options === null || options === void 0 ? void 0 : options.overridePopoutGroup) !== null && _a !== void 0 ? _a : this.createGroup({ id: groupId });
                 group.model.renderContainer = overlayRenderContainer;
-                if (!(options === null || options === void 0 ? void 0 : options.overridePopoutGroup)) {
+                group.layout(_window.window.innerWidth, _window.window.innerHeight);
+                if (!this._groups.has(group.api.id)) {
                     this._onDidAddGroup.fire(group);
                 }
-                if (itemToPopout instanceof DockviewPanel) {
-                    this.movingLock(() => {
-                        const panel = referenceGroup.model.removePanel(itemToPopout);
-                        group.model.openPanel(panel);
-                    });
-                }
-                else {
-                    this.movingLock(() => moveGroupWithoutDestroying({
-                        from: referenceGroup,
-                        to: group,
-                    }));
-                    switch (referenceLocation) {
-                        case 'grid':
-                            referenceGroup.api.setVisible(false);
-                            break;
-                        case 'floating':
-                        case 'popout':
-                            this.removeGroup(referenceGroup);
-                            break;
+                if (!(options === null || options === void 0 ? void 0 : options.overridePopoutGroup) && isGroupAddedToDom) {
+                    if (itemToPopout instanceof DockviewPanel) {
+                        this.movingLock(() => {
+                            const panel = referenceGroup.model.removePanel(itemToPopout);
+                            group.model.openPanel(panel);
+                        });
+                    }
+                    else {
+                        this.movingLock(() => moveGroupWithoutDestroying({
+                            from: referenceGroup,
+                            to: group,
+                        }));
+                        switch (referenceLocation) {
+                            case 'grid':
+                                referenceGroup.api.setVisible(false);
+                                break;
+                            case 'floating':
+                            case 'popout':
+                                this.removeGroup(referenceGroup);
+                                break;
+                        }
                     }
                 }
                 popoutContainer.classList.add('dv-dockview');
@@ -7627,6 +7649,10 @@ define(['exports'], (function (exports) { 'use strict';
                     type: 'popout',
                     getWindow: () => _window.window,
                 };
+                if (isGroupAddedToDom &&
+                    itemToPopout.api.location.type === 'grid') {
+                    itemToPopout.api.setVisible(false);
+                }
                 this.doSetGroupAndPanelActive(group);
                 popoutWindowDisposable.addDisposables(group.api.onDidActiveChange((event) => {
                     var _a;
@@ -7641,9 +7667,13 @@ define(['exports'], (function (exports) { 'use strict';
                 const value = {
                     window: _window,
                     popoutGroup: group,
-                    referenceGroup: this.getPanel(referenceGroup.id)
-                        ? referenceGroup.id
-                        : undefined,
+                    referenceGroup: !isGroupAddedToDom
+                        ? undefined
+                        : referenceGroup
+                            ? this.getPanel(referenceGroup.id)
+                                ? referenceGroup.id
+                                : undefined
+                            : undefined,
                     disposable: {
                         dispose: () => {
                             popoutWindowDisposable.dispose();
@@ -7658,9 +7688,10 @@ define(['exports'], (function (exports) { 'use strict';
                  * window dimensions
                  */
                 addDisposableWindowListener(_window.window, 'resize', () => {
-                    group.layout(window.innerWidth, window.innerHeight);
+                    group.layout(_window.window.innerWidth, _window.window.innerHeight);
                 }), overlayRenderContainer, exports.DockviewDisposable.from(() => {
-                    if (this.getPanel(referenceGroup.id)) {
+                    if (isGroupAddedToDom &&
+                        this.getPanel(referenceGroup.id)) {
                         this.movingLock(() => moveGroupWithoutDestroying({
                             from: group,
                             to: referenceGroup,
@@ -7675,21 +7706,27 @@ define(['exports'], (function (exports) { 'use strict';
                         }
                     }
                     else if (this.getPanel(group.id)) {
-                        const removedGroup = this.doRemoveGroup(group, {
+                        this.doRemoveGroup(group, {
                             skipDispose: true,
                             skipActive: true,
+                            skipPopoutReturn: true,
                         });
+                        const removedGroup = group;
                         removedGroup.model.renderContainer =
                             this.overlayRenderContainer;
                         removedGroup.model.location = { type: 'grid' };
                         returnedGroup = removedGroup;
+                        this.doAddGroup(removedGroup, [0]);
+                        this.doSetGroupAndPanelActive(removedGroup);
                     }
                 }));
                 this._popoutGroups.push(value);
                 this.updateWatermark();
+                return true;
             })
                 .catch((err) => {
                 console.error('dockview: failed to create popout window', err);
+                return false;
             });
         }
         addFloatingGroup(item, options) {
@@ -7793,7 +7830,7 @@ define(['exports'], (function (exports) { 'use strict';
                     : (_c = (_b = this.options.floatingGroupBounds) === null || _b === void 0 ? void 0 : _b.minimumWidthWithinViewport) !== null && _c !== void 0 ? _c : DEFAULT_FLOATING_GROUP_OVERFLOW_SIZE, minimumInViewportHeight: this.options.floatingGroupBounds === 'boundedWithinViewport'
                     ? undefined
                     : (_e = (_d = this.options.floatingGroupBounds) === null || _d === void 0 ? void 0 : _d.minimumHeightWithinViewport) !== null && _e !== void 0 ? _e : DEFAULT_FLOATING_GROUP_OVERFLOW_SIZE }));
-            const el = group.element.querySelector('.void-container');
+            const el = group.element.querySelector('.dv-void-container');
             if (!el) {
                 throw new Error('failed to find drag handle');
             }
@@ -8076,7 +8113,6 @@ define(['exports'], (function (exports) { 'use strict';
                     this.addPopoutGroup((_c = (gridReferenceGroup
                         ? this.getPanel(gridReferenceGroup)
                         : undefined)) !== null && _c !== void 0 ? _c : group, {
-                        skipRemoveGroup: true,
                         position: position !== null && position !== void 0 ? position : undefined,
                         overridePopoutGroup: gridReferenceGroup
                             ? group
@@ -8094,6 +8130,7 @@ define(['exports'], (function (exports) { 'use strict';
                 }
             }
             catch (err) {
+                console.error('dockview: failed to deserialize layout. Reverting changes', err);
                 /**
                  * Takes all the successfully created groups and remove all of their panels.
                  */
@@ -8161,11 +8198,13 @@ define(['exports'], (function (exports) { 'use strict';
                 width: options.initialWidth,
                 height: options.initialHeight,
             };
+            let index;
             if (options.position) {
                 if (isPanelOptionsWithPanel(options.position)) {
                     const referencePanel = typeof options.position.referencePanel === 'string'
                         ? this.getGroupPanel(options.position.referencePanel)
                         : options.position.referencePanel;
+                    index = options.position.index;
                     if (!referencePanel) {
                         throw new Error(`referencePanel '${options.position.referencePanel}' does not exist`);
                     }
@@ -8176,6 +8215,7 @@ define(['exports'], (function (exports) { 'use strict';
                         typeof options.position.referenceGroup === 'string'
                             ? (_a = this._groups.get(options.position.referenceGroup)) === null || _a === void 0 ? void 0 : _a.value
                             : options.position.referenceGroup;
+                    index = options.position.index;
                     if (!referenceGroup) {
                         throw new Error(`referenceGroup '${options.position.referenceGroup}' does not exist`);
                     }
@@ -8186,6 +8226,7 @@ define(['exports'], (function (exports) { 'use strict';
                     group.model.openPanel(panel, {
                         skipSetActive: options.inactive,
                         skipSetGroupActive: options.inactive,
+                        index,
                     });
                     if (!options.inactive) {
                         this.doSetGroupAndPanelActive(group);
@@ -8215,6 +8256,7 @@ define(['exports'], (function (exports) { 'use strict';
                     group.model.openPanel(panel, {
                         skipSetActive: options.inactive,
                         skipSetGroupActive: options.inactive,
+                        index,
                     });
                 }
                 else if (referenceGroup.api.location.type === 'floating' ||
@@ -8223,6 +8265,7 @@ define(['exports'], (function (exports) { 'use strict';
                     referenceGroup.model.openPanel(panel, {
                         skipSetActive: options.inactive,
                         skipSetGroupActive: options.inactive,
+                        index,
                     });
                     referenceGroup.api.setSize({
                         width: initial === null || initial === void 0 ? void 0 : initial.width,
@@ -8243,6 +8286,7 @@ define(['exports'], (function (exports) { 'use strict';
                     group.model.openPanel(panel, {
                         skipSetActive: options.inactive,
                         skipSetGroupActive: options.inactive,
+                        index,
                     });
                     if (!options.inactive) {
                         this.doSetGroupAndPanelActive(group);
@@ -8261,6 +8305,7 @@ define(['exports'], (function (exports) { 'use strict';
                 group.model.openPanel(panel, {
                     skipSetActive: options.inactive,
                     skipSetGroupActive: options.inactive,
+                    index,
                 });
             }
             else {
@@ -8271,6 +8316,7 @@ define(['exports'], (function (exports) { 'use strict';
                 group.model.openPanel(panel, {
                     skipSetActive: options.inactive,
                     skipSetGroupActive: options.inactive,
+                    index,
                 });
                 if (!options.inactive) {
                     this.doSetGroupAndPanelActive(group);
@@ -8811,6 +8857,31 @@ define(['exports'], (function (exports) { 'use strict';
         }
     }
 
+    function createComponent(id, componentName, components = {}, frameworkComponents = {}, createFrameworkComponent, fallback) {
+        const Component = typeof componentName === 'string'
+            ? components[componentName]
+            : undefined;
+        const FrameworkComponent = typeof componentName === 'string'
+            ? frameworkComponents[componentName]
+            : undefined;
+        if (Component && FrameworkComponent) {
+            throw new Error(`Cannot create '${id}'. component '${componentName}' registered as both a component and frameworkComponent`);
+        }
+        if (FrameworkComponent) {
+            if (!createFrameworkComponent) {
+                throw new Error(`Cannot create '${id}' for framework component '${componentName}'. you must register a frameworkPanelWrapper to use framework components`);
+            }
+            return createFrameworkComponent.createComponent(id, componentName, FrameworkComponent);
+        }
+        if (!Component) {
+            if (fallback) {
+                return fallback();
+            }
+            throw new Error(`Cannot create '${id}', no component '${componentName}' provided`);
+        }
+        return new Component(id, componentName);
+    }
+
     class GridviewComponent extends BaseGrid {
         get orientation() {
             return this.gridview.orientation;
@@ -9359,12 +9430,14 @@ define(['exports'], (function (exports) { 'use strict';
             this._expandedIcon = createExpandMoreButton();
             this._collapsedIcon = createChevronRightButton();
             this.disposable = new MutableDisposable();
-            this.apiRef = { api: null };
+            this.apiRef = {
+                api: null,
+            };
             this._element = document.createElement('div');
-            this.element.className = 'default-header';
+            this.element.className = 'dv-default-header';
             this._content = document.createElement('span');
             this._expander = document.createElement('div');
-            this._expander.className = 'dockview-pane-header-icon';
+            this._expander.className = 'dv-pane-header-icon';
             this.element.appendChild(this._expander);
             this.element.appendChild(this._content);
             this.addDisposables(addDisposableListener(this._element, 'click', () => {
@@ -9835,7 +9908,6 @@ define(['exports'], (function (exports) { 'use strict';
     exports.GridviewApi = GridviewApi;
     exports.GridviewComponent = GridviewComponent;
     exports.GridviewPanel = GridviewPanel;
-    exports.LocalSelectionTransfer = LocalSelectionTransfer;
     exports.PROPERTY_KEYS = PROPERTY_KEYS;
     exports.PaneFramework = PaneFramework;
     exports.PaneTransfer = PaneTransfer;
@@ -9850,7 +9922,6 @@ define(['exports'], (function (exports) { 'use strict';
     exports.SplitviewPanel = SplitviewPanel;
     exports.Tab = Tab;
     exports.WillShowOverlayLocationEvent = WillShowOverlayLocationEvent;
-    exports.createComponent = createComponent;
     exports.createDockview = createDockview;
     exports.createGridview = createGridview;
     exports.createPaneview = createPaneview;