chore(release): publish v4.2.5

883 tab overflow dropdown doesnt collide with edge of screen

.codesandbox/ci.json

@@ -1,6 +1,8 @@
 {
   "packages": [
     "packages/dockview-core",
+    "packages/dockview-vue",
+    "packages/dockview-react",
     "packages/dockview"
   ],
   "sandboxes": [
@@ -28,6 +30,7 @@
     "/packages/docs/sandboxes/rendermode-dockview",
     "/packages/docs/sandboxes/resize-dockview",
     "/packages/docs/sandboxes/resizecontainer-dockview",
+    "/packages/docs/sandboxes/scrollbars-dockview",
     "/packages/docs/sandboxes/simple-dockview",
     "/packages/docs/sandboxes/simple-gridview",
     "/packages/docs/sandboxes/simple-paneview",

.github/workflows/codeql-analysis.yml

@@ -30,11 +30,11 @@ jobs:
 
         steps:
             - name: Checkout repository
-              uses: actions/checkout@v3
+              uses: actions/checkout@v4
 
             # Initializes the CodeQL tools for scanning.
             - name: Initialize CodeQL
-              uses: github/codeql-action/init@v1
+              uses: github/codeql-action/init@v3
               with:
                   languages: ${{ matrix.language }}
                   # If you wish to specify custom queries, you can do so here or in a config file.
@@ -45,7 +45,7 @@ jobs:
             # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
             # If this step fails, then you should remove it and run the build manually (see below)
             - name: Autobuild
-              uses: github/codeql-action/autobuild@v1
+              uses: github/codeql-action/autobuild@v3
 
             # ℹ️ Command-line programs to run using the OS shell.
             # 📚 https://git.io/JvXDl
@@ -59,4 +59,4 @@ jobs:
             #   make release
 
             - name: Perform CodeQL Analysis
-              uses: github/codeql-action/analyze@v1
+              uses: github/codeql-action/analyze@v3

.github/workflows/deploy-docs.yml

@@ -2,21 +2,19 @@ name: Deploy Docs
 
 on:
     workflow_dispatch:
-    schedule:
-        - cron: '0 3 * * *' # every day at 3 am UTC
 
 jobs:
     deploy-nightly-demo-app:
         runs-on: ubuntu-latest
         steps:
             - name: Checkout 🛎️
-              uses: actions/checkout@v3
+              uses: actions/checkout@v4
             - name: Use Node.js
-              uses: actions/setup-node@v3
+              uses: actions/setup-node@v4
               with:
-                  node-version: '18.x'
+                  node-version: '20.x'
 
-            - uses: actions/cache@v3
+            - uses: actions/cache@v4
               with:
                   path: ~/.npm
                   key: ${{ runner.os }}-node-${{ hashFiles('**/yarn.lock') }}
@@ -28,6 +26,10 @@ jobs:
               working-directory: packages/dockview-core
             - run: npm run build
               working-directory: packages/dockview
+            - run: npm run build
+              working-directory: packages/dockview-vue
+            - run: npm run build
+              working-directory: packages/dockview-react
             - run: npm run build
               working-directory: packages/docs
             - run: npm run docs

.github/workflows/main.yml

@@ -7,16 +7,16 @@ jobs:
         runs-on: ubuntu-latest
 
         steps:
-            - uses: actions/checkout@v3
+            - uses: actions/checkout@v4
               # might be required for sonar to work correctly
               with:
                   fetch-depth: 0 # Shallow clones should be disabled for a better relevancy of analysis
             - name: Use Node.js
-              uses: actions/setup-node@v3
+              uses: actions/setup-node@v4
               with:
-                  node-version: '18.x'
+                  node-version: '20.x'
 
-            - uses: actions/cache@v3
+            - uses: actions/cache@v4
               with:
                   path: ~/.npm
                   key: ${{ runner.os }}-node-${{ hashFiles('**/yarn.lock') }}
@@ -27,7 +27,7 @@ jobs:
             - run: npm run build
             - run: npm run test:cov
             - name: SonarCloud Scan
-              uses: SonarSource/sonarcloud-github-action@master
+              uses: sonarsource/sonarqube-scan-action@v5
               env:
                   GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Needed to get PR information, if any
                   SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}

.github/workflows/publish.yml

@@ -16,12 +16,12 @@ jobs:
             id-token: write
         steps:
             - uses: actions/checkout@v4
-            - uses: actions/setup-node@v3
+            - uses: actions/setup-node@v4
               with:
-                  node-version: '18.x'
+                  node-version: '20.x'
                   registry-url: 'https://registry.npmjs.org'
 
-            - uses: actions/cache@v3
+            - uses: actions/cache@v4
               with:
                   path: ~/.npm
                   key: ${{ runner.os }}-node-${{ hashFiles('**/yarn.lock') }}
@@ -35,6 +35,12 @@ jobs:
             - name: Publish dockview
               run: npm publish --provenance
               working-directory: packages/dockview
+            - name: Publish dockview-vue
+              run: npm publish --provenance
+              working-directory: packages/dockview-vue
+            - name: Publish dockview-react
+              run: npm publish --provenance
+              working-directory: packages/dockview-react
     publish-experimental:
         if: github.event_name == 'workflow_dispatch'
         runs-on: ubuntu-latest
@@ -44,12 +50,12 @@ jobs:
             id-token: write
         steps:
             - uses: actions/checkout@v4
-            - uses: actions/setup-node@v3
+            - uses: actions/setup-node@v4
               with:
-                  node-version: '18.x'
+                  node-version: '20.x'
                   registry-url: 'https://registry.npmjs.org'
 
-            - uses: actions/cache@v3
+            - uses: actions/cache@v4
               with:
                   path: ~/.npm
                   key: ${{ runner.os }}-node-${{ hashFiles('**/yarn.lock') }}
@@ -64,3 +70,9 @@ jobs:
             - name: Publish dockview
               run: npm publish --provenance --tag experimental
               working-directory: packages/dockview
+            - name: Publish dockview-vue
+              run: npm publish --provenance --tag experimental
+              working-directory: packages/dockview-vue
+            - name: Publish dockview-react
+              run: npm publish --provenance --tag experimental
+              working-directory: packages/dockview-react

.vscode/extensions.json

@@ -7,7 +7,8 @@
         "esbenp.prettier-vscode",
         "redhat.vscode-yaml",
         "dbaeumer.vscode-eslint",
-        "editorconfig.editorconfig"
+        "editorconfig.editorconfig",
+        "vue.volar"
     ],
     // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
     "unwantedRecommendations": []

README.md

@@ -1,18 +1,18 @@
 <div align="center">
 <h1>dockview</h1>
 
-<p>Zero dependency layout manager supporting tabs, groups, grids and splitviews with ReactJS support written in TypeScript</p>
+<p>Zero dependency layout manager supporting tabs, groups, grids and splitviews. Supports React, Vue and Vanilla TypeScript</p>
 
 </div>
 
 ---
 
-[![npm version](https://badge.fury.io/js/dockview.svg)](https://www.npmjs.com/package/dockview)
-[![npm](https://img.shields.io/npm/dm/dockview)](https://www.npmjs.com/package/dockview)
+[![npm version](https://badge.fury.io/js/dockview-core.svg)](https://www.npmjs.com/package/dockview-core)
+[![npm](https://img.shields.io/npm/dm/dockview-core)](https://www.npmjs.com/package/dockview-core)
 [![CI Build](https://github.com/mathuo/dockview/workflows/CI/badge.svg)](https://github.com/mathuo/dockview/actions?query=workflow%3ACI)
 [![Coverage](https://sonarcloud.io/api/project_badges/measure?project=mathuo_dockview&metric=coverage)](https://sonarcloud.io/summary/overall?id=mathuo_dockview)
 [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=mathuo_dockview&metric=alert_status)](https://sonarcloud.io/summary/overall?id=mathuo_dockview)
-[![Bundle Phobia](https://badgen.net/bundlephobia/minzip/dockview)](https://bundlephobia.com/result?p=dockview)
+[![Bundle Phobia](https://badgen.net/bundlephobia/minzip/dockview-core)](https://bundlephobia.com/result?p=dockview-core)
 
 ##
 
@@ -35,24 +35,4 @@ Please see the website: https://dockview.dev
 -   Transparent builds and Code Analysis
 -   Security at mind - verifed publishing and builds through GitHub Actions
 
-Want to verify our builds? Go [here](https://www.npmjs.com/package/dockview#Provenance).
-
-## Quick start
-
-Dockview has a peer dependency on `react >= 16.8.0` and `react-dom >= 16.8.0`. You can install dockview from [npm](https://www.npmjs.com/package/dockview).
-
-```
-npm install --save dockview
-```
-
-Within your project you must import or reference the stylesheet at `dockview/dist/styles/dockview.css` and attach a theme.
-
-```css
-@import '~dockview/dist/styles/dockview.css';
-```
-
-You should also attach a dockview theme to an element containing your components. For example:
-
-```html
-<body classname="dockview-theme-dark"></body>
-```
+Want to verify our builds? Go [here](https://www.npmjs.com/package/dockview#user-content-provenance).

SECURITY.md

@@ -0,0 +1,8 @@
+# Reporting a Vulnerability
+
+- Dockview is an entirely open source project.
+- All build and publication scripts use public Github Action files found [here](https://github.com/mathuo/dockview/tree/master/.github/workflows).
+- All npm publications are verified through the use of [provenance statements](https://docs.npmjs.com/generating-provenance-statements/).
+- All builds are scanned with SonarCube and outputs can be found [here](https://sonarcloud.io/summary/overall?id=mathuo_dockview).
+
+If you believe you have found a security or vulnerability issue please send a complete example to github.mathuo@gmail.com where it will be investigated.

lerna.json

@@ -2,11 +2,11 @@
   "packages": [
     "packages/*"
   ],
-  "version": "1.9.0",
+  "version": "4.2.5",
   "npmClient": "yarn",
   "command": {
     "publish": {
       "message": "chore(release): publish %s"
     }
   }
-}
+}

package.json

@@ -16,7 +16,7 @@
     "packages/*"
   ],
   "scripts": {
-    "build": "lerna run build --scope '{dockview-core,dockview}'",
+    "build": "lerna run build --scope '{dockview-core,dockview,dockview-vue,dockview-react}'",
     "clean": "lerna run clean",
     "docs": "typedoc",
     "generate-docs": "node scripts/docs.mjs",
@@ -45,6 +45,9 @@
     "@types/react-dom": "^18.2.18",
     "@typescript-eslint/eslint-plugin": "^6.17.0",
     "@typescript-eslint/parser": "^6.17.0",
+    "@vitejs/plugin-vue": "^5.0.4",
+    "@vue/tsconfig": "^0.5.1",
+    "concurrently": "^8.2.2",
     "cross-env": "^7.0.3",
     "eslint": "^8.56.0",
     "fs-extra": "^11.2.0",
@@ -55,7 +58,7 @@
     "jest-environment-jsdom": "^29.7.0",
     "jest-sonar-reporter": "^2.0.0",
     "jsdom": "^23.0.1",
-    "lerna": "^8.0.1",
+    "lerna": "^8.2.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "rimraf": "^5.0.5",
@@ -66,7 +69,11 @@
     "ts-node": "^10.9.2",
     "tslib": "^2.6.2",
     "typedoc": "^0.25.6",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vite": "^5.1.5",
+    "vue": "^3.4.21",
+    "vue-sfc-loader": "^0.1.0",
+    "vue-tsc": "^2.0.5"
   },
   "engines": {
     "node": ">=18.0"

packages/dockview-angular/README.md

@@ -0,0 +1,56 @@
+<div align="center">
+<h1>dockview</h1>
+
+<p>Zero dependency layout manager supporting tabs, groups, grids and splitviews with ReactJS support written in TypeScript</p>
+
+</div>
+
+---
+
+[![npm version](https://badge.fury.io/js/dockview.svg)](https://www.npmjs.com/package/dockview)
+[![npm](https://img.shields.io/npm/dm/dockview)](https://www.npmjs.com/package/dockview)
+[![CI Build](https://github.com/mathuo/dockview/workflows/CI/badge.svg)](https://github.com/mathuo/dockview/actions?query=workflow%3ACI)
+[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=mathuo_dockview&metric=coverage)](https://sonarcloud.io/summary/overall?id=mathuo_dockview)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=mathuo_dockview&metric=alert_status)](https://sonarcloud.io/summary/overall?id=mathuo_dockview)
+[![Bundle Phobia](https://badgen.net/bundlephobia/minzip/dockview)](https://bundlephobia.com/result?p=dockview)
+
+##
+
+Please see the website: https://dockview.dev
+
+## Features
+
+-   Serialization / deserialization with full layout management
+-   Support for split-views, grid-views and 'dockable' views
+-   Themeable and customizable
+-   Tab and Group docking / Drag n' Drop
+-   Popout Windows
+-   Floating Groups
+-   Extensive API
+-   Supports Shadow DOMs
+-   High test coverage
+-   Documentation website with live examples
+-   Transparent builds and Code Analysis
+-   Security at mind - verifed publishing and builds through GitHub Actions
+
+Want to verify our builds? Go [here](https://www.npmjs.com/package/dockview#Provenance).
+
+## Quick start
+
+Dockview has a peer dependency on `react >= 16.8.0` and `react-dom >= 16.8.0`. You can install dockview from [npm](https://www.npmjs.com/package/dockview).
+
+```
+npm install --save dockview
+```
+
+Within your project you must import or reference the stylesheet at `dockview/dist/styles/dockview.css` and attach a theme.
+
+```css
+@import '~dockview/dist/styles/dockview.css';
+```
+
+You should also attach a dockview theme to an element containing your components. For example:
+
+```html
+<body classname="dockview-theme-dark"></body>
+```

packages/dockview-angular/jest.config.ts

@@ -0,0 +1,34 @@
+import { JestConfigWithTsJest } from 'ts-jest';
+
+const config: JestConfigWithTsJest = {
+    preset: 'ts-jest',
+    roots: ['<rootDir>/packages/dockview-angular'],
+    modulePaths: ['<rootDir>/packages/dockview-angular/src'],
+    displayName: { name: 'dockview-angular', color: 'blue' },
+    rootDir: '../../',
+    collectCoverageFrom: [
+        '<rootDir>/packages/dockview-angular/src/**/*.{js,jsx,ts,tsx}',
+    ],
+    setupFiles: [
+        // '<rootDir>/packages/dockview-angular/src/__tests__/__mocks__/resizeObserver.js',
+    ],
+    setupFilesAfterEnv: ['<rootDir>/jest-setup.ts'],
+    coveragePathIgnorePatterns: ['/node_modules/'],
+    modulePathIgnorePatterns: [
+        // '<rootDir>/packages/dockview-angular/src/__tests__/__mocks__',
+        // '<rootDir>/packages/dockview-angular/src/__tests__/__test_utils__',
+    ],
+    coverageDirectory: '<rootDir>/packages/dockview-angular/coverage/',
+    testResultsProcessor: 'jest-sonar-reporter',
+    testEnvironment: 'jsdom',
+    transform: {
+        '^.+\\.tsx?$': [
+            'ts-jest',
+            {
+                tsconfig: '<rootDir>/tsconfig.test.json',
+            },
+        ],
+    },
+};
+
+export default config;

packages/dockview-angular/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "dockview-angular",
+  "version": "4.2.5",
+  "description": "Zero dependency layout manager supporting tabs, grids and splitviews",
+  "keywords": [
+    "splitview",
+    "split-view",
+    "gridview",
+    "grid-view",
+    "dockview",
+    "dock-view",
+    "grid",
+    "tabs",
+    "layout",
+    "layout manager",
+    "dock layout",
+    "dock",
+    "docking",
+    "splitter",
+    "drag-and-drop",
+    "drag",
+    "drop",
+    "react",
+    "react-component"
+  ],
+  "homepage": "https://github.com/mathuo/dockview",
+  "bugs": {
+    "url": "https://github.com/mathuo/dockview/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mathuo/dockview.git"
+  },
+  "license": "MIT",
+  "author": "https://github.com/mathuo",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/cjs/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "npm run build:package && npm run build:bundles",
+    "build:bundles": "rollup -c",
+    "build:cjs": "cross-env ../../node_modules/.bin/tsc --build ./tsconfig.json --verbose --extendedDiagnostics",
+    "build:css": "gulp sass",
+    "build:esm": "cross-env ../../node_modules/.bin/tsc --build ./tsconfig.esm.json --verbose --extendedDiagnostics",
+    "build:package": "npm run build:cjs && npm run build:esm && npm run build:css",
+    "clean": "rimraf dist/ .build/ .rollup.cache/",
+    "prepublishOnly": "npm run rebuild && npm run test",
+    "rebuild": "npm run clean && npm run build",
+    "test": "cross-env ../../node_modules/.bin/jest --selectProjects dockview",
+    "test:cov": "cross-env ../../node_modules/.bin/jest --selectProjects dockview --coverage"
+  },
+  "dependencies": {
+    "dockview-core": "^4.2.5"
+  }
+}

packages/dockview-angular/rollup.config.js

@@ -0,0 +1,113 @@
+/* eslint-disable */
+
+const { join } = require('path');
+const typescript = require('@rollup/plugin-typescript');
+const terser = require('@rollup/plugin-terser');
+const postcss = require('rollup-plugin-postcss');
+const nodeResolve = require('@rollup/plugin-node-resolve');
+
+const { name, version, homepage, license } = require('./package.json');
+const main = join(__dirname, './scripts/rollupEntryTarget.ts');
+const mainNoStyles = join(__dirname, './src/index.ts');
+const outputDir = join(__dirname, 'dist');
+
+function outputFile(format, isMinified, withStyles) {
+    let filename = join(outputDir, name);
+
+    if (format !== 'umd') {
+        filename += `.${format}`;
+    }
+    if (isMinified) {
+        filename += '.min';
+    }
+    if (!withStyles) {
+        filename += '.noStyle';
+    }
+
+    return `${filename}.js`;
+}
+
+function getInput(options) {
+    const { withStyles } = options;
+
+    if (withStyles) {
+        return main;
+    }
+
+    return mainNoStyles;
+}
+
+function createBundle(format, options) {
+    const { withStyles, isMinified } = options;
+    const input = getInput(options);
+    const file = outputFile(format, isMinified, withStyles);
+
+    const external = [];
+
+    const output = {
+        file,
+        format,
+        sourcemap: true,
+        globals: {},
+        banner: [
+            `/**`,
+            ` * ${name}`,
+            ` * @version ${version}`,
+            ` * @link ${homepage}`,
+            ` * @license ${license}`,
+            ` */`,
+        ].join('\n'),
+    };
+
+    const plugins = [
+        nodeResolve({
+            include: ['node_modules/dockview-core/**'],
+        }),
+        typescript({
+            tsconfig: 'tsconfig.esm.json',
+        }),
+    ];
+
+    if (isMinified) {
+        plugins.push(terser());
+    }
+    if (withStyles) {
+        plugins.push(postcss());
+    }
+
+    if (format === 'umd') {
+        output['name'] = name;
+    }
+
+    external.push('react', 'react-dom');
+
+    if (format === 'umd') {
+        output.globals['react'] = 'React';
+        output.globals['react-dom'] = 'ReactDOM';
+    }
+
+    return {
+        input,
+        output,
+        plugins,
+        external,
+    };
+}
+
+module.exports = [
+    // amd
+    createBundle('amd', { withStyles: false, isMinified: false }),
+    createBundle('amd', { withStyles: true, isMinified: false }),
+    createBundle('amd', { withStyles: false, isMinified: true }),
+    createBundle('amd', { withStyles: true, isMinified: true }),
+    // umd
+    createBundle('umd', { withStyles: false, isMinified: false }),
+    createBundle('umd', { withStyles: true, isMinified: false }),
+    createBundle('umd', { withStyles: false, isMinified: true }),
+    createBundle('umd', { withStyles: true, isMinified: true }),
+    // cjs
+    createBundle('cjs', { withStyles: true, isMinified: false }),
+    // esm
+    createBundle('esm', { withStyles: true, isMinified: false }),
+    createBundle('esm', { withStyles: true, isMinified: true }),
+];

packages/dockview-angular/scripts/rollupEntryTarget.ts

@@ -0,0 +1,2 @@
+import '../dist/styles/dockview.css';
+export * from '../src/index';

packages/dockview-angular/src/__tests__/empty.spec.ts

@@ -0,0 +1,5 @@
+describe('empty', () => {
+    test('that passes', () => {
+        expect(true).toBeTruthy();
+    });
+});

packages/dockview-angular/src/index.ts

@@ -0,0 +1 @@
+export * from 'dockview-core';

packages/dockview-angular/tsconfig.esm.json

@@ -0,0 +1,14 @@
+{
+    "extends": "../../tsconfig.base.json",
+    "compilerOptions": {
+        "module": "ES2020",
+        "moduleResolution": "node",
+        "target": "es6",
+        "outDir": "dist/esm",
+        "tsBuildInfoFile": ".build/tsconfig.tsbuildinfo.esm",
+        "jsx": "react",
+        "rootDir": "src"
+    },
+    "include": ["src"],
+    "exclude": ["**/node_modules", "src/__tests__"]
+}

packages/dockview-angular/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "extends": "../../tsconfig.base.json",
+    "compilerOptions": {
+        "outDir": "dist/cjs",
+        "tsBuildInfoFile": ".build/tsconfig.tsbuildinfo.cjs",
+        "jsx": "react",
+        "rootDir": "src"
+    },
+    "include": ["src"],
+    "exclude": ["**/node_modules", "src/__tests__"]
+}

packages/dockview-angular/typedoc.json

@@ -0,0 +1,5 @@
+{
+    "extends": ["../../typedoc.base.json"],
+    "entryPoints": ["src/index.ts"],
+    "exclude": ["**/dist/**"]
+}

packages/dockview-core/README.md

@@ -1,7 +1,7 @@
 <div align="center">
 <h1>dockview</h1>
 
-<p>Zero dependency layout manager supporting tabs, groups, grids and splitviews written in TypeScript</p>
+<p>Zero dependency layout manager supporting tabs, groups, grids and splitviews. Supports React, Vue and Vanilla TypeScript</p>
 
 </div>
 
@@ -36,23 +36,3 @@ Please see the website: https://dockview.dev
 -   Security at mind - verifed publishing and builds through GitHub Actions
 
 Want to verify our builds? Go [here](https://www.npmjs.com/package/dockview#Provenance).
-
-## Quick start
-
-Dockview has a peer dependency on `react >= 16.8.0` and `react-dom >= 16.8.0`. You can install dockview from [npm](https://www.npmjs.com/package/dockview-core).
-
-```
-npm install --save dockview-core
-```
-
-Within your project you must import or reference the stylesheet at `dockview-core/dist/styles/dockview.css` and attach a theme.
-
-```css
-@import '~dockview-core/dist/styles/dockview.css';
-```
-
-You should also attach a dockview theme to an element containing your components. For example:
-
-```html
-<body classname="dockview-theme-dark"></body>
-```

packages/dockview-core/gulpfile.js

@@ -1,6 +1,13 @@
 const gulp = require('gulp');
-const buildfile = require('../../scripts/build');
+const gulpSass = require('gulp-dart-sass');
+const concat = require('gulp-concat');
 
-buildfile.init();
+gulp.task('sass', () => {
+    return gulp
+        .src('./src/**/*.scss')
+        .pipe(gulpSass().on('error', gulpSass.logError))
+        .pipe(concat('dockview.css'))
+        .pipe(gulp.dest('./dist/styles/'));
+});
 
 gulp.task('run', gulp.series(['sass']));

packages/dockview-core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dockview-core",
-  "version": "1.9.0",
-  "description": "Zero dependency layout manager supporting tabs, grids and splitviews with ReactJS support",
+  "version": "4.2.5",
+  "description": "Zero dependency layout manager supporting tabs, grids and splitviews",
   "keywords": [
     "splitview",
     "split-view",
@@ -43,9 +43,9 @@
   "scripts": {
     "build": "npm run build:package && npm run build:bundles",
     "build:bundles": "rollup -c",
-    "build:cjs": "cross-env ../../node_modules/.bin/tsc --project ./tsconfig.json --extendedDiagnostics",
+    "build:cjs": "cross-env ../../node_modules/.bin/tsc --build ./tsconfig.json --verbose --extendedDiagnostics",
     "build:css": "gulp sass",
-    "build:esm": "cross-env ../../node_modules/.bin/tsc --project ./tsconfig.esm.json --extendedDiagnostics",
+    "build:esm": "cross-env ../../node_modules/.bin/tsc --build ./tsconfig.esm.json --verbose --extendedDiagnostics",
     "build:package": "npm run build:cjs && npm run build:esm && npm run build:css",
     "clean": "rimraf dist/ .build/ .rollup.cache/",
     "prepublishOnly": "npm run rebuild && npm run test",

packages/dockview-core/src/__tests__/__mocks__/mockDockviewPanelModel.ts

@@ -1,23 +1,28 @@
 import { IDockviewPanelModel } from '../../dockview/dockviewPanelModel';
 import { DockviewGroupPanel } from '../../dockview/dockviewGroupPanel';
 import {
-    GroupPanelPartInitParameters,
+    TabPartInitParameters,
     IContentRenderer,
     ITabRenderer,
 } from '../../dockview/types';
 import { PanelUpdateEvent } from '../../panel/types';
+import { TabLocation } from '../../dockview/framework';
 
 export class DockviewPanelModelMock implements IDockviewPanelModel {
     constructor(
         readonly contentComponent: string,
         readonly content: IContentRenderer,
-        readonly tabComponent?: string,
-        readonly tab?: ITabRenderer
+        readonly tabComponent: string,
+        readonly tab: ITabRenderer
     ) {
         //
     }
 
-    init(params: GroupPanelPartInitParameters): void {
+    createTabRenderer(tabLocation: TabLocation): ITabRenderer {
+        return this.tab;
+    }
+
+    init(params: TabPartInitParameters): void {
         //
     }
 

packages/dockview-core/src/__tests__/__mocks__/mockWindow.ts

@@ -0,0 +1,45 @@
+import { fromPartial } from '@total-typescript/shoehorn';
+
+export function setupMockWindow() {
+    const listeners: Record<string, (() => void)[]> = {};
+
+    let width = 1000;
+    let height = 2000;
+
+    return fromPartial<Window>({
+        addEventListener: (type: string, listener: () => void) => {
+            if (!listeners[type]) {
+                listeners[type] = [];
+            }
+            listeners[type].push(listener);
+            if (type === 'load') {
+                listener();
+            }
+        },
+        removeEventListener: (type: string, listener: () => void) => {
+            if (listeners[type]) {
+                const index = listeners[type].indexOf(listener);
+                if (index > -1) {
+                    listeners[type].splice(index, 1);
+                }
+            }
+        },
+        dispatchEvent: (event: Event) => {
+            const items = listeners[event.type];
+            if (!items) {
+                return;
+            }
+            items.forEach((item) => item());
+        },
+        document: document,
+        close: () => {
+            listeners['beforeunload']?.forEach((f) => f());
+        },
+        get innerWidth() {
+            return width++;
+        },
+        get innerHeight() {
+            return height++;
+        },
+    });
+}

packages/dockview-core/src/__tests__/__test_utils__/utils.ts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import React from 'react';
 
 /**
  * useful utility type to erase readonly signatures for testing purposes
@@ -44,3 +44,30 @@ export function createOffsetDragOverEvent(params: {
 export function exhaustMicrotaskQueue(): Promise<void> {
     return new Promise<void>((resolve) => resolve());
 }
+
+export const mockGetBoundingClientRect = ({
+    left,
+    top,
+    height,
+    width,
+}: {
+    left: number;
+    top: number;
+    height: number;
+    width: number;
+}) => {
+    const result = {
+        left,
+        top,
+        height,
+        width,
+        right: left + width,
+        bottom: top + height,
+        x: left,
+        y: top,
+    };
+    return {
+        ...result,
+        toJSON: () => result,
+    };
+};

packages/dockview-core/src/__tests__/api/api.spec.ts

@@ -5,7 +5,7 @@ describe('api', () => {
     let api: PanelApiImpl;
 
     beforeEach(() => {
-        api = new PanelApiImpl('dummy_id');
+        api = new PanelApiImpl('dummy_id', 'fake-component');
     });
 
     test('updateParameters', () => {

packages/dockview-core/src/__tests__/api/dockviewPanelApi.spec.ts

@@ -1,15 +1,17 @@
 import { DockviewPanelApiImpl } from '../../api/dockviewPanelApi';
 import { DockviewComponent } from '../../dockview/dockviewComponent';
-import { DockviewPanel, IDockviewPanel } from '../../dockview/dockviewPanel';
+import { DockviewPanel } from '../../dockview/dockviewPanel';
 import { DockviewGroupPanel } from '../../dockview/dockviewGroupPanel';
+import { fromPartial } from '@total-typescript/shoehorn';
 
 describe('groupPanelApi', () => {
     test('title', () => {
-        const accessor: Partial<DockviewComponent> = {
+        const accessor = fromPartial<DockviewComponent>({
             onDidAddPanel: jest.fn(),
             onDidRemovePanel: jest.fn(),
             options: {},
-        };
+            onDidOptionsChange: jest.fn(),
+        });
 
         const panelMock = jest.fn<DockviewPanel, []>(() => {
             return {
@@ -17,17 +19,21 @@ describe('groupPanelApi', () => {
                 setTitle: jest.fn(),
             } as any;
         });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {} as any;
-        });
 
         const panel = new panelMock();
-        const group = new groupMock();
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest.fn(),
+                onDidLocationChange: jest.fn(),
+                onDidActiveChange: jest.fn(),
+            },
+        });
 
         const cut = new DockviewPanelApiImpl(
             panel,
             group,
-            <DockviewComponent>accessor
+            <DockviewComponent>accessor,
+            'fake-component'
         );
 
         cut.setTitle('test_title');
@@ -41,11 +47,13 @@ describe('groupPanelApi', () => {
             update: jest.fn(),
         };
 
-        const accessor: Partial<DockviewComponent> = {
+        const accessor = fromPartial<DockviewComponent>({
             onDidAddPanel: jest.fn(),
             onDidRemovePanel: jest.fn(),
             options: {},
-        };
+            onDidOptionsChange: jest.fn(),
+        });
+
         const groupViewPanel = new DockviewGroupPanel(
             <DockviewComponent>accessor,
             '',
@@ -55,7 +63,8 @@ describe('groupPanelApi', () => {
         const cut = new DockviewPanelApiImpl(
             <DockviewPanel>groupPanel,
             <DockviewGroupPanel>groupViewPanel,
-            <DockviewComponent>accessor
+            <DockviewComponent>accessor,
+            'fake-component'
         );
 
         cut.updateParameters({ keyA: 'valueA' });
@@ -71,11 +80,13 @@ describe('groupPanelApi', () => {
             id: 'test_id',
         };
 
-        const accessor: Partial<DockviewComponent> = {
+        const accessor = fromPartial<DockviewComponent>({
             onDidAddPanel: jest.fn(),
             onDidRemovePanel: jest.fn(),
             options: {},
-        };
+            onDidOptionsChange: jest.fn(),
+        });
+
         const groupViewPanel = new DockviewGroupPanel(
             <DockviewComponent>accessor,
             '',
@@ -85,7 +96,8 @@ describe('groupPanelApi', () => {
         const cut = new DockviewPanelApiImpl(
             <DockviewPanel>groupPanel,
             <DockviewGroupPanel>groupViewPanel,
-            <DockviewComponent>accessor
+            <DockviewComponent>accessor,
+            'fake-component'
         );
 
         let events = 0;

packages/dockview-core/src/__tests__/dnd/abstractDragHandler.spec.ts

@@ -70,8 +70,8 @@ describe('abstractDragHandler', () => {
         expect(span.style.pointerEvents).toBeFalsy();
 
         fireEvent.dragEnd(element);
-        expect(iframe.style.pointerEvents).toBe('auto');
-        expect(webview.style.pointerEvents).toBe('auto');
+        expect(iframe.style.pointerEvents).toBe('');
+        expect(webview.style.pointerEvents).toBe('');
         expect(span.style.pointerEvents).toBeFalsy();
 
         handler.dispose();
@@ -114,8 +114,8 @@ describe('abstractDragHandler', () => {
         expect(span.style.pointerEvents).toBeFalsy();
 
         handler.dispose();
-        expect(iframe.style.pointerEvents).toBe('auto');
-        expect(webview.style.pointerEvents).toBe('auto');
+        expect(iframe.style.pointerEvents).toBe('');
+        expect(webview.style.pointerEvents).toBe('');
         expect(span.style.pointerEvents).toBeFalsy();
     });
 
@@ -172,7 +172,7 @@ describe('abstractDragHandler', () => {
         const event = new Event('dragstart');
         const spy = jest.spyOn(event, 'preventDefault');
         fireEvent(element, event);
-        expect(spy).toBeCalledTimes(0);
+        expect(spy).toHaveBeenCalledTimes(0);
 
         handler.dispose();
     });

packages/dockview-core/src/__tests__/dnd/droptarget.spec.ts

@@ -16,10 +16,10 @@ describe('droptarget', () => {
     beforeEach(() => {
         element = document.createElement('div');
 
-        jest.spyOn(element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(element, 'clientWidth', 'get').mockImplementation(() => 200);
+        jest.spyOn(element, 'offsetWidth', 'get').mockImplementation(() => 200);
     });
 
     test('that dragover events are marked', () => {
@@ -53,7 +53,7 @@ describe('droptarget', () => {
         fireEvent.dragOver(element);
 
         const target = element.querySelector(
-            '.drop-target-dropzone'
+            '.dv-drop-target-dropzone'
         ) as HTMLElement;
         fireEvent.drop(target);
         expect(position).toBe('center');
@@ -61,7 +61,7 @@ describe('droptarget', () => {
         const event = new Event('dragover');
         (event as any)['__dockview_droptarget_event_is_used__'] = true;
         fireEvent(element, event);
-        expect(element.querySelector('.drop-target-dropzone')).toBeNull();
+        expect(element.querySelector('.dv-drop-target-dropzone')).toBeNull();
     });
 
     test('directionToPosition', () => {
@@ -102,7 +102,7 @@ describe('droptarget', () => {
         fireEvent.dragOver(element);
 
         const target = element.querySelector(
-            '.drop-target-dropzone'
+            '.dv-drop-target-dropzone'
         ) as HTMLElement;
         fireEvent.drop(target);
         expect(position).toBe('center');
@@ -124,7 +124,7 @@ describe('droptarget', () => {
         fireEvent.dragOver(element);
 
         const target = element.querySelector(
-            '.drop-target-dropzone'
+            '.dv-drop-target-dropzone'
         ) as HTMLElement;
 
         jest.spyOn(target, 'clientHeight', 'get').mockImplementation(() => 100);
@@ -155,12 +155,12 @@ describe('droptarget', () => {
         fireEvent.dragOver(element);
 
         let viewQuery = element.querySelectorAll(
-            '.drop-target > .drop-target-dropzone > .drop-target-selection'
+            '.dv-drop-target > .dv-drop-target-dropzone > .dv-drop-target-selection'
         );
         expect(viewQuery.length).toBe(1);
 
         const target = element.querySelector(
-            '.drop-target-dropzone'
+            '.dv-drop-target-dropzone'
         ) as HTMLElement;
 
         jest.spyOn(target, 'clientHeight', 'get').mockImplementation(() => 100);
@@ -171,18 +171,37 @@ describe('droptarget', () => {
             createOffsetDragOverEvent({ clientX: 19, clientY: 0 })
         );
 
+        function check(
+            element: HTMLElement,
+            box: {
+                left: string;
+                top: string;
+                width: string;
+                height: string;
+            }
+        ) {
+            expect(element.style.top).toBe(box.top);
+            expect(element.style.left).toBe(box.left);
+            expect(element.style.width).toBe(box.width);
+            expect(element.style.height).toBe(box.height);
+        }
+
         viewQuery = element.querySelectorAll(
-            '.drop-target > .drop-target-dropzone > .drop-target-selection'
+            '.dv-drop-target > .dv-drop-target-dropzone > .dv-drop-target-selection'
         );
         expect(viewQuery.length).toBe(1);
         expect(droptarget.state).toBe('left');
-        expect(
-            (
-                element
-                    .getElementsByClassName('drop-target-selection')
-                    .item(0) as HTMLDivElement
-            ).style.transform
-        ).toBe('translateX(-25%) scaleX(0.5)');
+        check(
+            element
+                .getElementsByClassName('dv-drop-target-selection')
+                .item(0) as HTMLDivElement,
+            {
+                top: '0px',
+                left: '0px',
+                width: '50%',
+                height: '100%',
+            }
+        );
 
         fireEvent(
             target,
@@ -190,17 +209,21 @@ describe('droptarget', () => {
         );
 
         viewQuery = element.querySelectorAll(
-            '.drop-target > .drop-target-dropzone > .drop-target-selection'
+            '.dv-drop-target > .dv-drop-target-dropzone > .dv-drop-target-selection'
         );
         expect(viewQuery.length).toBe(1);
         expect(droptarget.state).toBe('top');
-        expect(
-            (
-                element
-                    .getElementsByClassName('drop-target-selection')
-                    .item(0) as HTMLDivElement
-            ).style.transform
-        ).toBe('translateY(-25%) scaleY(0.5)');
+        check(
+            element
+                .getElementsByClassName('dv-drop-target-selection')
+                .item(0) as HTMLDivElement,
+            {
+                top: '0px',
+                left: '0px',
+                width: '100%',
+                height: '50%',
+            }
+        );
 
         fireEvent(
             target,
@@ -208,17 +231,21 @@ describe('droptarget', () => {
         );
 
         viewQuery = element.querySelectorAll(
-            '.drop-target > .drop-target-dropzone > .drop-target-selection'
+            '.dv-drop-target > .dv-drop-target-dropzone > .dv-drop-target-selection'
         );
         expect(viewQuery.length).toBe(1);
         expect(droptarget.state).toBe('bottom');
-        expect(
-            (
-                element
-                    .getElementsByClassName('drop-target-selection')
-                    .item(0) as HTMLDivElement
-            ).style.transform
-        ).toBe('translateY(25%) scaleY(0.5)');
+        check(
+            element
+                .getElementsByClassName('dv-drop-target-selection')
+                .item(0) as HTMLDivElement,
+            {
+                top: '50%',
+                left: '0px',
+                width: '100%',
+                height: '50%',
+            }
+        );
 
         fireEvent(
             target,
@@ -226,18 +253,21 @@ describe('droptarget', () => {
         );
 
         viewQuery = element.querySelectorAll(
-            '.drop-target > .drop-target-dropzone > .drop-target-selection'
+            '.dv-drop-target > .dv-drop-target-dropzone > .dv-drop-target-selection'
         );
         expect(viewQuery.length).toBe(1);
         expect(droptarget.state).toBe('right');
-        expect(
-            (
-                element
-                    .getElementsByClassName('drop-target-selection')
-                    .item(0) as HTMLDivElement
-            ).style.transform
-        ).toBe('translateX(25%) scaleX(0.5)');
-
+        check(
+            element
+                .getElementsByClassName('dv-drop-target-selection')
+                .item(0) as HTMLDivElement,
+            {
+                top: '0px',
+                left: '50%',
+                width: '50%',
+                height: '100%',
+            }
+        );
         fireEvent(
             target,
             createOffsetDragOverEvent({ clientX: 100, clientY: 50 })
@@ -246,14 +276,14 @@ describe('droptarget', () => {
         expect(
             (
                 element
-                    .getElementsByClassName('drop-target-selection')
+                    .getElementsByClassName('dv-drop-target-selection')
                     .item(0) as HTMLDivElement
             ).style.transform
         ).toBe('');
 
         fireEvent.dragLeave(target);
         expect(droptarget.state).toBe('center');
-        viewQuery = element.querySelectorAll('.drop-target');
+        viewQuery = element.querySelectorAll('.dv-drop-target');
         expect(viewQuery.length).toBe(0);
     });
 

packages/dockview-core/src/__tests__/dnd/groupDragHandler.spec.ts

@@ -11,7 +11,7 @@ describe('groupDragHandler', () => {
         const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
             const partial: Partial<DockviewGroupPanel> = {
                 id: 'test_group_id',
-                api: { location: 'grid' } as any,
+                api: { location: { type: 'grid' } } as any,
             };
             return partial as DockviewGroupPanel;
         });
@@ -53,7 +53,7 @@ describe('groupDragHandler', () => {
 
         const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
             const partial: Partial<DockviewGroupPanel> = {
-                api: { location: 'floating' } as any,
+                api: { location: { type: 'floating' } } as any,
             };
             return partial as DockviewGroupPanel;
         });
@@ -85,7 +85,7 @@ describe('groupDragHandler', () => {
 
         const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
             const partial: Partial<DockviewGroupPanel> = {
-                api: { location: 'grid' } as any,
+                api: { location: { type: 'grid' } } as any,
             };
             return partial as DockviewGroupPanel;
         });

packages/dockview-core/src/__tests__/dnd/overlay.spec.ts

@@ -1,156 +0,0 @@
-import { Overlay } from '../../dnd/overlay';
-
-describe('overlay', () => {
-    test('toJSON', () => {
-        const container = document.createElement('div');
-        const content = document.createElement('div');
-
-        document.body.appendChild(container);
-        container.appendChild(content);
-
-        const cut = new Overlay({
-            height: 200,
-            width: 100,
-            left: 10,
-            top: 20,
-            minimumInViewportWidth: 0,
-            minimumInViewportHeight: 0,
-            container,
-            content,
-        });
-
-        jest.spyOn(
-            container.childNodes.item(0) as HTMLElement,
-            'getBoundingClientRect'
-        ).mockImplementation(() => {
-            return { left: 80, top: 100, width: 40, height: 50 } as any;
-        });
-        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
-            () => {
-                return { left: 20, top: 30, width: 100, height: 100 } as any;
-            }
-        );
-
-        expect(cut.toJSON()).toEqual({
-            top: 70,
-            left: 60,
-            width: 40,
-            height: 50,
-        });
-    });
-
-    test('that out-of-bounds dimensions are fixed', () => {
-        const container = document.createElement('div');
-        const content = document.createElement('div');
-
-        document.body.appendChild(container);
-        container.appendChild(content);
-
-        const cut = new Overlay({
-            height: 200,
-            width: 100,
-            left: -1000,
-            top: -1000,
-            minimumInViewportWidth: 0,
-            minimumInViewportHeight: 0,
-            container,
-            content,
-        });
-
-        jest.spyOn(
-            container.childNodes.item(0) as HTMLElement,
-            'getBoundingClientRect'
-        ).mockImplementation(() => {
-            return { left: 80, top: 100, width: 40, height: 50 } as any;
-        });
-        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
-            () => {
-                return { left: 20, top: 30, width: 100, height: 100 } as any;
-            }
-        );
-
-        expect(cut.toJSON()).toEqual({
-            top: 70,
-            left: 60,
-            width: 40,
-            height: 50,
-        });
-    });
-
-    test('setBounds', () => {
-        const container = document.createElement('div');
-        const content = document.createElement('div');
-
-        document.body.appendChild(container);
-        container.appendChild(content);
-
-        const cut = new Overlay({
-            height: 1000,
-            width: 1000,
-            left: 0,
-            top: 0,
-            minimumInViewportWidth: 0,
-            minimumInViewportHeight: 0,
-            container,
-            content,
-        });
-
-        const element: HTMLElement = container.querySelector(
-            '.dv-resize-container'
-        )!;
-        expect(element).toBeTruthy();
-
-        jest.spyOn(element, 'getBoundingClientRect').mockImplementation(() => {
-            return { left: 300, top: 400, width: 1000, height: 1000 } as any;
-        });
-        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
-            () => {
-                return { left: 0, top: 0, width: 1000, height: 1000 } as any;
-            }
-        );
-
-        cut.setBounds({ height: 100, width: 200, left: 300, top: 400 });
-
-        expect(element.style.height).toBe('100px');
-        expect(element.style.width).toBe('200px');
-        expect(element.style.left).toBe('300px');
-        expect(element.style.top).toBe('400px');
-    });
-
-    test('that the resize handles are added', () => {
-        const container = document.createElement('div');
-        const content = document.createElement('div');
-
-        const cut = new Overlay({
-            height: 500,
-            width: 500,
-            left: 100,
-            top: 200,
-            minimumInViewportWidth: 0,
-            minimumInViewportHeight: 0,
-            container,
-            content,
-        });
-
-        expect(container.querySelector('.dv-resize-handle-top')).toBeTruthy();
-        expect(
-            container.querySelector('.dv-resize-handle-bottom')
-        ).toBeTruthy();
-        expect(container.querySelector('.dv-resize-handle-left')).toBeTruthy();
-        expect(container.querySelector('.dv-resize-handle-right')).toBeTruthy();
-        expect(
-            container.querySelector('.dv-resize-handle-topleft')
-        ).toBeTruthy();
-        expect(
-            container.querySelector('.dv-resize-handle-topright')
-        ).toBeTruthy();
-        expect(
-            container.querySelector('.dv-resize-handle-bottomleft')
-        ).toBeTruthy();
-        expect(
-            container.querySelector('.dv-resize-handle-bottomright')
-        ).toBeTruthy();
-
-        cut.dispose();
-    });
-});

packages/dockview-core/src/__tests__/dockview/components/panel/content.spec.ts

@@ -1,8 +1,7 @@
 import { fireEvent } from '@testing-library/dom';
-import { Emitter, Event } from '../../../../events';
 import { ContentContainer } from '../../../../dockview/components/panel/content';
 import {
-    GroupPanelContentPartInitParameters,
+    GroupPanelPartInitParameters,
     IContentRenderer,
 } from '../../../../dockview/types';
 import { CompositeDisposable } from '../../../../lifecycle';
@@ -10,7 +9,9 @@ import { PanelUpdateEvent } from '../../../../panel/types';
 import { IDockviewPanel } from '../../../../dockview/dockviewPanel';
 import { IDockviewPanelModel } from '../../../../dockview/dockviewPanelModel';
 import { DockviewComponent } from '../../../../dockview/dockviewComponent';
-import { OverlayRenderContainer } from '../../../../overlayRenderContainer';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { DockviewGroupPanelModel } from '../../../../dockview/dockviewGroupPanelModel';
+import { OverlayRenderContainer } from '../../../../overlay/overlayRenderContainer';
 
 class TestContentRenderer
     extends CompositeDisposable
@@ -18,17 +19,13 @@ class TestContentRenderer
 {
     readonly element: HTMLElement;
 
-    readonly _onDidFocus = new Emitter<void>();
-    readonly _onDidBlur = new Emitter<void>();
-    readonly onDidFocus: Event<void> = this._onDidFocus.event;
-    readonly onDidBlur: Event<void> = this._onDidBlur.event;
-
     constructor(public id: string) {
         super();
         this.element = document.createElement('div');
+        this.element.id = id;
     }
 
-    init(parameters: GroupPanelContentPartInitParameters): void {
+    init(parameters: GroupPanelPartInitParameters): void {
         //
     }
 
@@ -59,16 +56,20 @@ describe('contentContainer', () => {
 
         const disposable = new CompositeDisposable();
 
-        const dockviewComponent = jest.fn<DockviewComponent, []>(() => {
-            return {
-                renderer: 'onlyWhenVisibile',
-                overlayRenderContainer: new OverlayRenderContainer(
-                    document.createElement('div')
-                ),
-            } as DockviewComponent;
-        });
+        const overlayRenderContainer = new OverlayRenderContainer(
+            document.createElement('div'),
+            fromPartial<DockviewComponent>({})
+        );
 
-        const cut = new ContentContainer(dockviewComponent(), jest.fn() as any);
+        const cut = new ContentContainer(
+            fromPartial<DockviewComponent>({
+                renderer: 'onlyWhenVisible',
+                overlayRenderContainer,
+            }),
+            fromPartial<DockviewGroupPanelModel>({
+                renderContainer: overlayRenderContainer,
+            })
+        );
 
         disposable.addDisposables(
             cut.onDidFocus(() => {
@@ -81,12 +82,12 @@ describe('contentContainer', () => {
 
         const contentRenderer = new TestContentRenderer('id-1');
 
-        const panel = {
+        const panel = fromPartial<IDockviewPanel>({
             view: {
                 content: contentRenderer,
-            } as Partial<IDockviewPanelModel>,
-            api: { renderer: 'onlyWhenVisibile' },
-        } as Partial<IDockviewPanel>;
+            },
+            api: { renderer: 'onlyWhenVisible' },
+        });
 
         cut.openPanel(panel as IDockviewPanel);
 
@@ -104,46 +105,70 @@ describe('contentContainer', () => {
         expect(focus).toBe(1);
         expect(blur).toBe(1);
 
-        // renderer explicitly asks for focus
-        contentRenderer._onDidFocus.fire();
-        expect(focus).toBe(2);
-        expect(blur).toBe(1);
-
-        // renderer explicitly looses focus
-        contentRenderer._onDidBlur.fire();
-        expect(focus).toBe(2);
-        expect(blur).toBe(2);
-
         const contentRenderer2 = new TestContentRenderer('id-2');
 
         const panel2 = {
             view: {
                 content: contentRenderer2,
             } as Partial<IDockviewPanelModel>,
-            api: { renderer: 'onlyWhenVisibile' },
+            api: { renderer: 'onlyWhenVisible' },
         } as Partial<IDockviewPanel>;
 
         cut.openPanel(panel2 as IDockviewPanel);
-        expect(focus).toBe(2);
-        expect(blur).toBe(2);
-
-        // previous renderer events should no longer be attached to container
-        contentRenderer._onDidFocus.fire();
-        contentRenderer._onDidBlur.fire();
-        expect(focus).toBe(2);
-        expect(blur).toBe(2);
+        // expect(focus).toBe(2);
+        // expect(blur).toBe(1);
 
         // new panel recieves focus
         fireEvent.focus(contentRenderer2.element);
-        expect(focus).toBe(3);
-        expect(blur).toBe(2);
+        expect(focus).toBe(2);
+        expect(blur).toBe(1);
 
         // new panel looses focus
         fireEvent.blur(contentRenderer2.element);
         jest.runAllTimers();
-        expect(focus).toBe(3);
-        expect(blur).toBe(3);
+        expect(focus).toBe(2);
+        expect(blur).toBe(2);
 
         disposable.dispose();
     });
+
+    test("that panels renderered as 'onlyWhenVisible' are removed when closed", () => {
+        const overlayRenderContainer = fromPartial<OverlayRenderContainer>({
+            detatch: jest.fn(),
+        });
+
+        const cut = new ContentContainer(
+            fromPartial<DockviewComponent>({
+                overlayRenderContainer,
+            }),
+            fromPartial<DockviewGroupPanelModel>({
+                renderContainer: overlayRenderContainer,
+            })
+        );
+
+        const panel1 = fromPartial<IDockviewPanel>({
+            api: {
+                renderer: 'onlyWhenVisible',
+            },
+            view: { content: new TestContentRenderer('panel_1') },
+        });
+
+        const panel2 = fromPartial<IDockviewPanel>({
+            api: {
+                renderer: 'onlyWhenVisible',
+            },
+            view: { content: new TestContentRenderer('panel_2') },
+        });
+
+        cut.openPanel(panel1);
+
+        expect(panel1.view.content.element.parentElement).toBe(cut.element);
+        expect(cut.element.childNodes.length).toBe(1);
+
+        cut.openPanel(panel2);
+
+        expect(panel1.view.content.element.parentElement).toBeNull();
+        expect(panel2.view.content.element.parentElement).toBe(cut.element);
+        expect(cut.element.childNodes.length).toBe(1);
+    });
 });

packages/dockview-core/src/__tests__/dockview/components/tab.spec.ts

@@ -8,6 +8,7 @@ import { DockviewGroupPanel } from '../../../dockview/dockviewGroupPanel';
 import { DockviewGroupPanelModel } from '../../../dockview/dockviewGroupPanelModel';
 import { Tab } from '../../../dockview/components/tab/tab';
 import { IDockviewPanel } from '../../../dockview/dockviewPanel';
+import { fromPartial } from '@total-typescript/shoehorn';
 
 describe('tab', () => {
     test('that empty tab has inactive-tab class', () => {
@@ -20,7 +21,7 @@ describe('tab', () => {
             new groupMock()
         );
 
-        expect(cut.element.className).toBe('tab inactive-tab');
+        expect(cut.element.className).toBe('dv-tab dv-inactive-tab');
     });
 
     test('that active tab has active-tab class', () => {
@@ -34,10 +35,10 @@ describe('tab', () => {
         );
 
         cut.setActive(true);
-        expect(cut.element.className).toBe('tab active-tab');
+        expect(cut.element.className).toBe('dv-tab dv-active-tab');
 
         cut.setActive(false);
-        expect(cut.element.className).toBe('tab inactive-tab');
+        expect(cut.element.className).toBe('dv-tab dv-inactive-tab');
     });
 
     test('that an external event does not render a drop target and calls through to the group model', () => {
@@ -46,15 +47,10 @@ describe('tab', () => {
                 id: 'testcomponentid',
             };
         });
-        const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
-            () => {
-                return {
-                    canDisplayOverlay: jest.fn(),
-                };
-            }
-        );
 
-        const groupView = new groupviewMock() as DockviewGroupPanelModel;
+        const groupView = fromPartial<DockviewGroupPanelModel>({
+            canDisplayOverlay: jest.fn(),
+        });
 
         const groupPanelMock = jest.fn<Partial<DockviewGroupPanel>, []>(() => {
             return {
@@ -72,38 +68,33 @@ describe('tab', () => {
             groupPanel
         );
 
-        jest.spyOn(cut.element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(cut.element, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
         fireEvent.dragEnter(cut.element);
         fireEvent.dragOver(cut.element);
 
-        expect(groupView.canDisplayOverlay).toBeCalled();
+        expect(groupView.canDisplayOverlay).toHaveBeenCalled();
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 
-    test('that if you drag over yourself no drop target is shown', () => {
+    test('that if you drag over yourself a drop target is shown', () => {
         const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
             return {
                 id: 'testcomponentid',
             };
         });
-        const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
-            () => {
-                return {
-                    canDisplayOverlay: jest.fn(),
-                };
-            }
-        );
 
-        const groupView = new groupviewMock() as DockviewGroupPanelModel;
+        const groupView = fromPartial<DockviewGroupPanelModel>({
+            canDisplayOverlay: jest.fn(),
+        });
 
         const groupPanelMock = jest.fn<Partial<DockviewGroupPanel>, []>(() => {
             return {
@@ -121,10 +112,10 @@ describe('tab', () => {
             groupPanel
         );
 
-        jest.spyOn(cut.element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(cut.element, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -136,11 +127,11 @@ describe('tab', () => {
         fireEvent.dragEnter(cut.element);
         fireEvent.dragOver(cut.element);
 
-        expect(groupView.canDisplayOverlay).toBeCalledTimes(0);
+        expect(groupView.canDisplayOverlay).toHaveBeenCalledTimes(0);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
-        ).toBe(0);
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
+        ).toBe(1);
     });
 
     test('that if you drag over another tab a drop target is shown', () => {
@@ -175,10 +166,10 @@ describe('tab', () => {
             groupPanel
         );
 
-        jest.spyOn(cut.element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(cut.element, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -193,7 +184,7 @@ describe('tab', () => {
         expect(groupView.canDisplayOverlay).toBeCalledTimes(0);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(1);
     });
 
@@ -229,10 +220,10 @@ describe('tab', () => {
             groupPanel
         );
 
-        jest.spyOn(cut.element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(cut.element, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -253,7 +244,7 @@ describe('tab', () => {
         expect(groupView.canDisplayOverlay).toBeCalledTimes(1);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 
@@ -289,10 +280,10 @@ describe('tab', () => {
             groupPanel
         );
 
-        jest.spyOn(cut.element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(cut.element, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(cut.element, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -313,7 +304,7 @@ describe('tab', () => {
         expect(groupView.canDisplayOverlay).toBeCalledTimes(1);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 });

packages/dockview-core/src/__tests__/dockview/components/tab/defaultTab.spec.ts

@@ -0,0 +1,63 @@
+import { DockviewApi } from '../../../../api/component.api';
+import { DockviewPanelApi, TitleEvent } from '../../../../api/dockviewPanelApi';
+import { DefaultTab } from '../../../../dockview/components/tab/defaultTab';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { Emitter } from '../../../../events';
+import { fireEvent } from '@testing-library/dom';
+
+describe('defaultTab', () => {
+    test('that title updates', () => {
+        const cut = new DefaultTab();
+
+        let el = cut.element.querySelector('.dv-default-tab-content');
+        expect(el).toBeTruthy();
+        expect(el!.textContent).toBe('');
+
+        const onDidTitleChange = new Emitter<TitleEvent>();
+
+        const api = fromPartial<DockviewPanelApi>({
+            onDidTitleChange: onDidTitleChange.event,
+        });
+        const containerApi = fromPartial<DockviewApi>({});
+
+        cut.init({
+            api,
+            containerApi,
+            params: {},
+            title: 'title_abc',
+        });
+
+        el = cut.element.querySelector('.dv-default-tab-content');
+        expect(el).toBeTruthy();
+        expect(el!.textContent).toBe('title_abc');
+
+        onDidTitleChange.fire({ title: 'title_def' });
+
+        expect(el!.textContent).toBe('title_def');
+    });
+
+    test('that click closes tab', () => {
+        const cut = new DefaultTab();
+
+        const api = fromPartial<DockviewPanelApi>({
+            onDidTitleChange: jest.fn(),
+            close: jest.fn(),
+        });
+        const containerApi = fromPartial<DockviewApi>({});
+
+        cut.init({
+            api,
+            containerApi,
+            params: {},
+            title: 'title_abc',
+        });
+
+        let el = cut.element.querySelector('.dv-default-tab-action');
+
+        fireEvent.pointerDown(el!);
+        expect(api.close).toHaveBeenCalledTimes(0);
+
+        fireEvent.click(el!);
+        expect(api.close).toHaveBeenCalledTimes(1);
+    });
+});

packages/dockview-core/src/__tests__/dockview/components/titlebar/tabs.spec.ts

@@ -0,0 +1,66 @@
+import { Tabs } from '../../../../dockview/components/titlebar/tabs';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { DockviewGroupPanel } from '../../../../dockview/dockviewGroupPanel';
+import { DockviewComponent } from '../../../../dockview/dockviewComponent';
+
+describe('tabs', () => {
+    describe('disableCustomScrollbars', () => {
+        test('enabled by default', () => {
+            const cut = new Tabs(
+                fromPartial<DockviewGroupPanel>({}),
+                fromPartial<DockviewComponent>({
+                    options: {},
+                }),
+                {
+                    showTabsOverflowControl: true,
+                }
+            );
+
+            expect(
+                cut.element.querySelectorAll(
+                    '.dv-scrollable > .dv-tabs-container'
+                ).length
+            ).toBe(1);
+        });
+
+        test('enabled when disabled flag is false', () => {
+            const cut = new Tabs(
+                fromPartial<DockviewGroupPanel>({}),
+                fromPartial<DockviewComponent>({
+                    options: {
+                        scrollbars: 'custom',
+                    },
+                }),
+                {
+                    showTabsOverflowControl: true,
+                }
+            );
+
+            expect(
+                cut.element.querySelectorAll(
+                    '.dv-scrollable > .dv-tabs-container'
+                ).length
+            ).toBe(1);
+        });
+
+        test('disabled when disabled flag is true', () => {
+            const cut = new Tabs(
+                fromPartial<DockviewGroupPanel>({}),
+                fromPartial<DockviewComponent>({
+                    options: {
+                        scrollbars: 'native',
+                    },
+                }),
+                {
+                    showTabsOverflowControl: true,
+                }
+            );
+
+            expect(
+                cut.element.querySelectorAll(
+                    '.dv-scrollable > .dv-tabs-container'
+                ).length
+            ).toBe(0);
+        });
+    });
+});

packages/dockview-core/src/__tests__/dockview/components/titlebar/tabsContainer.spec.ts

@@ -9,16 +9,18 @@ import { DockviewGroupPanelModel } from '../../../../dockview/dockviewGroupPanel
 import { fireEvent } from '@testing-library/dom';
 import { TestPanel } from '../../dockviewGroupPanelModel.spec';
 import { IDockviewPanel } from '../../../../dockview/dockviewPanel';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { DockviewPanelApi } from '../../../../api/dockviewPanelApi';
 
 describe('tabsContainer', () => {
     test('that an external event does not render a drop target and calls through to the group mode', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                options: {},
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -35,54 +37,52 @@ describe('tabsContainer', () => {
             };
         });
 
-        const accessor = new accessorMock() as DockviewComponent;
         const groupPanel = new groupPanelMock() as DockviewGroupPanel;
 
         const cut = new TabsContainer(accessor, groupPanel);
 
         const emptySpace = cut.element
-            .getElementsByClassName('void-container')
-            .item(0);
+            .getElementsByClassName('dv-void-container')
+            .item(0) as HTMLElement;
 
-        if (!emptySpace) {
+        if (!emptySpace!) {
             fail('element not found');
         }
 
-        jest.spyOn(emptySpace, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(emptySpace, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
-        fireEvent.dragEnter(emptySpace);
-        fireEvent.dragOver(emptySpace);
+        fireEvent.dragEnter(emptySpace!);
+        fireEvent.dragOver(emptySpace!);
 
-        expect(groupView.canDisplayOverlay).toBeCalled();
+        expect(groupView.canDisplayOverlay).toHaveBeenCalled();
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 
     test('that a drag over event from another tab should render a drop target', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                options: {},
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
-        const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
-            () => {
-                return {
-                    canDisplayOverlay: jest.fn(),
-                };
-            }
-        );
 
-        const groupView = new groupviewMock() as DockviewGroupPanelModel;
+        const dropTargetContainer = document.createElement('div');
+
+        const groupView = fromPartial<DockviewGroupPanelModel>({
+            canDisplayOverlay: jest.fn(),
+            // dropTargetContainer: new DropTargetAnchorContainer(
+            //     dropTargetContainer
+            // ),
+        });
 
         const groupPanelMock = jest.fn<Partial<DockviewGroupPanel>, []>(() => {
             return {
@@ -92,23 +92,22 @@ describe('tabsContainer', () => {
             };
         });
 
-        const accessor = new accessorMock() as DockviewComponent;
         const groupPanel = new groupPanelMock() as DockviewGroupPanel;
 
         const cut = new TabsContainer(accessor, groupPanel);
 
         const emptySpace = cut.element
-            .getElementsByClassName('void-container')
-            .item(0);
+            .getElementsByClassName('dv-void-container')
+            .item(0) as HTMLElement;
 
-        if (!emptySpace) {
+        if (!emptySpace!) {
             fail('element not found');
         }
 
-        jest.spyOn(emptySpace, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(emptySpace, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -123,25 +122,29 @@ describe('tabsContainer', () => {
             PanelTransfer.prototype
         );
 
-        fireEvent.dragEnter(emptySpace);
-        fireEvent.dragOver(emptySpace);
+        fireEvent.dragEnter(emptySpace!);
+        fireEvent.dragOver(emptySpace!);
 
-        expect(groupView.canDisplayOverlay).toBeCalledTimes(0);
+        expect(groupView.canDisplayOverlay).toHaveBeenCalledTimes(0);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(1);
+        // expect(
+        //     dropTargetContainer.getElementsByClassName('dv-drop-target-anchor')
+        //         .length
+        // ).toBe(1);
     });
 
     test('that dropping over the empty space should render a drop target', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                options: {},
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -160,7 +163,6 @@ describe('tabsContainer', () => {
             };
         });
 
-        const accessor = new accessorMock() as DockviewComponent;
         const groupPanel = new groupPanelMock() as DockviewGroupPanel;
 
         const cut = new TabsContainer(accessor, groupPanel);
@@ -169,17 +171,17 @@ describe('tabsContainer', () => {
         cut.openPanel(new TestPanel('panel2', jest.fn() as any));
 
         const emptySpace = cut.element
-            .getElementsByClassName('void-container')
-            .item(0);
+            .getElementsByClassName('dv-void-container')
+            .item(0) as HTMLElement;
 
-        if (!emptySpace) {
+        if (!emptySpace!) {
             fail('element not found');
         }
 
-        jest.spyOn(emptySpace, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(emptySpace, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -188,25 +190,25 @@ describe('tabsContainer', () => {
             PanelTransfer.prototype
         );
 
-        fireEvent.dragEnter(emptySpace);
-        fireEvent.dragOver(emptySpace);
+        fireEvent.dragEnter(emptySpace!);
+        fireEvent.dragOver(emptySpace!);
 
-        expect(groupView.canDisplayOverlay).toBeCalledTimes(0);
+        expect(groupView.canDisplayOverlay).toHaveBeenCalledTimes(0);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(1);
     });
 
     test('that dropping the first tab should render a drop target', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                options: {},
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -225,7 +227,6 @@ describe('tabsContainer', () => {
             };
         });
 
-        const accessor = new accessorMock() as DockviewComponent;
         const groupPanel = new groupPanelMock() as DockviewGroupPanel;
 
         const cut = new TabsContainer(accessor, groupPanel);
@@ -234,17 +235,17 @@ describe('tabsContainer', () => {
         cut.openPanel(new TestPanel('panel2', jest.fn() as any));
 
         const emptySpace = cut.element
-            .getElementsByClassName('void-container')
-            .item(0);
+            .getElementsByClassName('dv-void-container')
+            .item(0) as HTMLElement;
 
-        if (!emptySpace) {
+        if (!emptySpace!) {
             fail('element not found');
         }
 
-        jest.spyOn(emptySpace, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(emptySpace, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -253,25 +254,25 @@ describe('tabsContainer', () => {
             PanelTransfer.prototype
         );
 
-        fireEvent.dragEnter(emptySpace);
-        fireEvent.dragOver(emptySpace);
+        fireEvent.dragEnter(emptySpace!);
+        fireEvent.dragOver(emptySpace!);
 
-        expect(groupView.canDisplayOverlay).toBeCalledTimes(0);
+        expect(groupView.canDisplayOverlay).toHaveBeenCalledTimes(0);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(1);
     });
 
     test('that dropping a tab from another component should not render a drop target', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                options: {},
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -289,7 +290,6 @@ describe('tabsContainer', () => {
             };
         });
 
-        const accessor = new accessorMock() as DockviewComponent;
         const groupPanel = new groupPanelMock() as DockviewGroupPanel;
 
         const cut = new TabsContainer(accessor, groupPanel);
@@ -298,17 +298,17 @@ describe('tabsContainer', () => {
         cut.openPanel(new TestPanel('panel2', jest.fn() as any));
 
         const emptySpace = cut.element
-            .getElementsByClassName('void-container')
-            .item(0);
+            .getElementsByClassName('dv-void-container')
+            .item(0) as HTMLElement;
 
-        if (!emptySpace) {
+        if (!emptySpace!) {
             fail('element not found');
         }
 
-        jest.spyOn(emptySpace, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(emptySpace, 'clientWidth', 'get').mockImplementation(
+        jest.spyOn(emptySpace!, 'offsetWidth', 'get').mockImplementation(
             () => 100
         );
 
@@ -323,36 +323,35 @@ describe('tabsContainer', () => {
             PanelTransfer.prototype
         );
 
-        fireEvent.dragEnter(emptySpace);
-        fireEvent.dragOver(emptySpace);
+        fireEvent.dragEnter(emptySpace!);
+        fireEvent.dragOver(emptySpace!);
 
-        expect(groupView.canDisplayOverlay).toBeCalledTimes(1);
+        expect(groupView.canDisplayOverlay).toHaveBeenCalledTimes(1);
 
         expect(
-            cut.element.getElementsByClassName('drop-target-dropzone').length
+            cut.element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 
     test('left actions', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{}) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
 
         let query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .left-actions-container'
+            '.dv-tabs-and-actions-container > .dv-left-actions-container'
         );
 
         expect(query.length).toBe(1);
@@ -365,7 +364,7 @@ describe('tabsContainer', () => {
         cut.setLeftActionsElement(left);
 
         query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .left-actions-container'
+            '.dv-tabs-and-actions-container > .dv-left-actions-container'
         );
         expect(query.length).toBe(1);
         expect(query[0].children.item(0)?.className).toBe(
@@ -380,7 +379,7 @@ describe('tabsContainer', () => {
         cut.setLeftActionsElement(left2);
 
         query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .left-actions-container'
+            '.dv-tabs-and-actions-container > .dv-left-actions-container'
         );
         expect(query.length).toBe(1);
         expect(query[0].children.item(0)?.className).toBe(
@@ -392,7 +391,7 @@ describe('tabsContainer', () => {
 
         cut.setLeftActionsElement(undefined);
         query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .left-actions-container'
+            '.dv-tabs-and-actions-container > .dv-left-actions-container'
         );
 
         expect(query.length).toBe(1);
@@ -400,25 +399,24 @@ describe('tabsContainer', () => {
     });
 
     test('right actions', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{}) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
 
         let query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .right-actions-container'
+            '.dv-tabs-and-actions-container > .dv-right-actions-container'
         );
 
         expect(query.length).toBe(1);
@@ -431,7 +429,7 @@ describe('tabsContainer', () => {
         cut.setRightActionsElement(right);
 
         query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .right-actions-container'
+            '.dv-tabs-and-actions-container > .dv-right-actions-container'
         );
         expect(query.length).toBe(1);
         expect(query[0].children.item(0)?.className).toBe(
@@ -446,7 +444,7 @@ describe('tabsContainer', () => {
         cut.setRightActionsElement(right2);
 
         query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .right-actions-container'
+            '.dv-tabs-and-actions-container > .dv-right-actions-container'
         );
         expect(query.length).toBe(1);
         expect(query[0].children.item(0)?.className).toBe(
@@ -458,7 +456,7 @@ describe('tabsContainer', () => {
 
         cut.setRightActionsElement(undefined);
         query = cut.element.querySelectorAll(
-            '.tabs-and-actions-container > .right-actions-container'
+            '.dv-tabs-and-actions-container > .dv-right-actions-container'
         );
 
         expect(query.length).toBe(1);
@@ -466,28 +464,27 @@ describe('tabsContainer', () => {
     });
 
     test('that a tab will become floating when clicked if not floating and shift is selected', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                element: document.createElement('div'),
-                addFloatingGroup: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            options: {},
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            element: document.createElement('div'),
+            addFloatingGroup: jest.fn(),
+            doSetGroupActive: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{
-                api: { location: 'grid' } as any,
+                api: { location: { type: 'grid' } } as any,
             }) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
 
-        const container = cut.element.querySelector('.void-container')!;
+        const container = cut.element.querySelector('.dv-void-container')!;
         expect(container).toBeTruthy();
 
         jest.spyOn(cut.element, 'getBoundingClientRect').mockImplementation(
@@ -502,52 +499,49 @@ describe('tabsContainer', () => {
             return { top: 10, left: 20, width: 0, height: 0 } as any;
         });
 
-        const event = new KeyboardEvent('mousedown', { shiftKey: true });
+        const event = new KeyboardEvent('pointerdown', { shiftKey: true });
         const eventPreventDefaultSpy = jest.spyOn(event, 'preventDefault');
         fireEvent(container, event);
 
-        expect(accessor.addFloatingGroup).toBeCalledWith(
-            groupPanel,
-            {
-                x: 100,
-                y: 60,
-            },
-            { inDragMode: true }
-        );
-        expect(accessor.addFloatingGroup).toBeCalledTimes(1);
-        expect(eventPreventDefaultSpy).toBeCalledTimes(1);
+        expect(accessor.doSetGroupActive).toHaveBeenCalledWith(groupPanel);
+        expect(accessor.addFloatingGroup).toHaveBeenCalledWith(groupPanel, {
+            x: 100,
+            y: 60,
+            inDragMode: true,
+        });
+        expect(accessor.addFloatingGroup).toHaveBeenCalledTimes(1);
+        expect(eventPreventDefaultSpy).toHaveBeenCalledTimes(1);
 
-        const event2 = new KeyboardEvent('mousedown', { shiftKey: false });
+        const event2 = new KeyboardEvent('pointerdown', { shiftKey: false });
         const eventPreventDefaultSpy2 = jest.spyOn(event2, 'preventDefault');
         fireEvent(container, event2);
 
-        expect(accessor.addFloatingGroup).toBeCalledTimes(1);
-        expect(eventPreventDefaultSpy2).toBeCalledTimes(0);
+        expect(accessor.addFloatingGroup).toHaveBeenCalledTimes(1);
+        expect(eventPreventDefaultSpy2).toHaveBeenCalledTimes(0);
     });
 
     test('that a tab that is already floating cannot be floated again', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                element: document.createElement('div'),
-                addFloatingGroup: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            options: {},
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            element: document.createElement('div'),
+            addFloatingGroup: jest.fn(),
+            doSetGroupActive: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{
-                api: { location: 'floating' } as any,
+                api: { location: { type: 'floating' } } as any,
             }) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
 
-        const container = cut.element.querySelector('.void-container')!;
+        const container = cut.element.querySelector('.dv-void-container')!;
         expect(container).toBeTruthy();
 
         jest.spyOn(cut.element, 'getBoundingClientRect').mockImplementation(
@@ -562,103 +556,97 @@ describe('tabsContainer', () => {
             return { top: 10, left: 20, width: 0, height: 0 } as any;
         });
 
-        const event = new KeyboardEvent('mousedown', { shiftKey: true });
+        const event = new KeyboardEvent('pointerdown', { shiftKey: true });
         const eventPreventDefaultSpy = jest.spyOn(event, 'preventDefault');
         fireEvent(container, event);
 
-        expect(accessor.addFloatingGroup).toBeCalledTimes(0);
-        expect(eventPreventDefaultSpy).toBeCalledTimes(0);
+        expect(accessor.doSetGroupActive).toHaveBeenCalledWith(groupPanel);
+        expect(accessor.addFloatingGroup).toHaveBeenCalledTimes(0);
+        expect(eventPreventDefaultSpy).toHaveBeenCalledTimes(0);
 
-        const event2 = new KeyboardEvent('mousedown', { shiftKey: false });
+        const event2 = new KeyboardEvent('pointerdown', { shiftKey: false });
         const eventPreventDefaultSpy2 = jest.spyOn(event2, 'preventDefault');
         fireEvent(container, event2);
 
-        expect(accessor.addFloatingGroup).toBeCalledTimes(0);
-        expect(eventPreventDefaultSpy2).toBeCalledTimes(0);
+        expect(accessor.addFloatingGroup).toHaveBeenCalledTimes(0);
+        expect(eventPreventDefaultSpy2).toHaveBeenCalledTimes(0);
     });
 
     test('that selecting a tab with shift down will move that tab into a new floating group', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                element: document.createElement('div'),
-                addFloatingGroup: jest.fn(),
-                getGroupPanel: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            options: {},
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            element: document.createElement('div'),
+            addFloatingGroup: jest.fn(),
+            getGroupPanel: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{
-                api: { location: 'floating' } as any,
+                api: { location: { type: 'floating' } } as any,
                 model: {} as any,
             }) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
 
-        const panelMock = jest.fn<IDockviewPanel, [string]>((id: string) => {
-            const partial: Partial<IDockviewPanel> = {
+        const createPanel = (id: string) =>
+            fromPartial<IDockviewPanel>({
                 id,
-
                 view: {
                     tab: {
                         element: document.createElement('div'),
-                    } as any,
+                    },
                     content: {
                         element: document.createElement('div'),
-                    } as any,
-                } as any,
-            };
-            return partial as IDockviewPanel;
-        });
+                    },
+                },
+            });
 
-        const panel = new panelMock('test_id');
+        const panel = createPanel('test_id');
         cut.openPanel(panel);
 
-        const el = cut.element.querySelector('.tab')!;
+        const el = cut.element.querySelector('.dv-tab')!;
         expect(el).toBeTruthy();
 
-        const event = new KeyboardEvent('mousedown', { shiftKey: true });
+        const event = new KeyboardEvent('pointerdown', { shiftKey: true });
         const preventDefaultSpy = jest.spyOn(event, 'preventDefault');
         fireEvent(el, event);
 
         // a floating group with a single tab shouldn't be eligible
-        expect(preventDefaultSpy).toBeCalledTimes(0);
-        expect(accessor.addFloatingGroup).toBeCalledTimes(0);
+        expect(preventDefaultSpy).toHaveBeenCalledTimes(0);
+        expect(accessor.addFloatingGroup).toHaveBeenCalledTimes(0);
 
-        const panel2 = new panelMock('test_id_2');
+        const panel2 = createPanel('test_id_2');
         cut.openPanel(panel2);
         fireEvent(el, event);
 
-        expect(preventDefaultSpy).toBeCalledTimes(1);
-        expect(accessor.addFloatingGroup).toBeCalledTimes(1);
+        expect(preventDefaultSpy).toHaveBeenCalledTimes(1);
+        expect(accessor.addFloatingGroup).toHaveBeenCalledTimes(1);
     });
 
     test('pre header actions', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                element: document.createElement('div'),
-                addFloatingGroup: jest.fn(),
-                getGroupPanel: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            options: {},
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            element: document.createElement('div'),
+            addFloatingGroup: jest.fn(),
+            getGroupPanel: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{
-                api: { location: 'grid' } as any,
+                api: { location: { type: 'grid' } } as any,
                 model: {} as any,
             }) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
@@ -682,14 +670,14 @@ describe('tabsContainer', () => {
         const panel = new panelMock('test_id');
         cut.openPanel(panel);
 
-        let result = cut.element.querySelector('.pre-actions-container');
+        let result = cut.element.querySelector('.dv-pre-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(0);
 
         const actions = document.createElement('div');
         cut.setPrefixActionsElement(actions);
 
-        result = cut.element.querySelector('.pre-actions-container');
+        result = cut.element.querySelector('.dv-pre-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(1);
         expect(result!.childNodes.item(0)).toBe(actions);
@@ -697,38 +685,36 @@ describe('tabsContainer', () => {
         const updatedActions = document.createElement('div');
         cut.setPrefixActionsElement(updatedActions);
 
-        result = cut.element.querySelector('.pre-actions-container');
+        result = cut.element.querySelector('.dv-pre-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(1);
         expect(result!.childNodes.item(0)).toBe(updatedActions);
 
         cut.setPrefixActionsElement(undefined);
 
-        result = cut.element.querySelector('.pre-actions-container');
+        result = cut.element.querySelector('.dv-pre-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(0);
     });
 
     test('left header actions', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                element: document.createElement('div'),
-                addFloatingGroup: jest.fn(),
-                getGroupPanel: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            options: {},
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            element: document.createElement('div'),
+            addFloatingGroup: jest.fn(),
+            getGroupPanel: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{
-                api: { location: 'grid' } as any,
+                api: { location: { type: 'grid' } } as any,
                 model: {} as any,
             }) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
@@ -752,14 +738,14 @@ describe('tabsContainer', () => {
         const panel = new panelMock('test_id');
         cut.openPanel(panel);
 
-        let result = cut.element.querySelector('.left-actions-container');
+        let result = cut.element.querySelector('.dv-left-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(0);
 
         const actions = document.createElement('div');
         cut.setLeftActionsElement(actions);
 
-        result = cut.element.querySelector('.left-actions-container');
+        result = cut.element.querySelector('.dv-left-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(1);
         expect(result!.childNodes.item(0)).toBe(actions);
@@ -767,38 +753,36 @@ describe('tabsContainer', () => {
         const updatedActions = document.createElement('div');
         cut.setLeftActionsElement(updatedActions);
 
-        result = cut.element.querySelector('.left-actions-container');
+        result = cut.element.querySelector('.dv-left-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(1);
         expect(result!.childNodes.item(0)).toBe(updatedActions);
 
         cut.setLeftActionsElement(undefined);
 
-        result = cut.element.querySelector('.left-actions-container');
+        result = cut.element.querySelector('.dv-left-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(0);
     });
 
     test('right header actions', () => {
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return (<Partial<DockviewComponent>>{
-                options: {},
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                element: document.createElement('div'),
-                addFloatingGroup: jest.fn(),
-                getGroupPanel: jest.fn(),
-            }) as DockviewComponent;
+        const accessor = fromPartial<DockviewComponent>({
+            options: {},
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            element: document.createElement('div'),
+            addFloatingGroup: jest.fn(),
+            getGroupPanel: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
 
         const groupPanelMock = jest.fn<DockviewGroupPanel, []>(() => {
             return (<Partial<DockviewGroupPanel>>{
-                api: { location: 'grid' } as any,
+                api: { location: { type: 'grid' } } as any,
                 model: {} as any,
             }) as DockviewGroupPanel;
         });
 
-        const accessor = new accessorMock();
         const groupPanel = new groupPanelMock();
 
         const cut = new TabsContainer(accessor, groupPanel);
@@ -822,14 +806,14 @@ describe('tabsContainer', () => {
         const panel = new panelMock('test_id');
         cut.openPanel(panel);
 
-        let result = cut.element.querySelector('.right-actions-container');
+        let result = cut.element.querySelector('.dv-right-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(0);
 
         const actions = document.createElement('div');
         cut.setRightActionsElement(actions);
 
-        result = cut.element.querySelector('.right-actions-container');
+        result = cut.element.querySelector('.dv-right-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(1);
         expect(result!.childNodes.item(0)).toBe(actions);
@@ -837,15 +821,47 @@ describe('tabsContainer', () => {
         const updatedActions = document.createElement('div');
         cut.setRightActionsElement(updatedActions);
 
-        result = cut.element.querySelector('.right-actions-container');
+        result = cut.element.querySelector('.dv-right-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(1);
         expect(result!.childNodes.item(0)).toBe(updatedActions);
 
         cut.setRightActionsElement(undefined);
 
-        result = cut.element.querySelector('.right-actions-container');
+        result = cut.element.querySelector('.dv-right-actions-container');
         expect(result).toBeTruthy();
         expect(result!.childNodes.length).toBe(0);
     });
+
+    test('class dv-single-tab is present when only one tab exists`', () => {
+        const cut = new TabsContainer(
+            fromPartial<DockviewComponent>({
+                options: {},
+                onDidOptionsChange: jest.fn(),
+            }),
+            fromPartial<DockviewGroupPanel>({})
+        );
+
+        expect(cut.element.classList.contains('dv-single-tab')).toBeFalsy();
+
+        const panel1 = new TestPanel(
+            'panel_1',
+            fromPartial<DockviewPanelApi>({})
+        );
+        cut.openPanel(panel1);
+        expect(cut.element.classList.contains('dv-single-tab')).toBeTruthy();
+
+        const panel2 = new TestPanel(
+            'panel_2',
+            fromPartial<DockviewPanelApi>({})
+        );
+        cut.openPanel(panel2);
+        expect(cut.element.classList.contains('dv-single-tab')).toBeFalsy();
+
+        cut.closePanel(panel1);
+        expect(cut.element.classList.contains('dv-single-tab')).toBeTruthy();
+
+        cut.closePanel(panel2);
+        expect(cut.element.classList.contains('dv-single-tab')).toBeFalsy();
+    });
 });

packages/dockview-core/src/__tests__/dockview/components/titlebar/voidContainer.spec.ts

@@ -0,0 +1,20 @@
+import { VoidContainer } from '../../../../dockview/components/titlebar/voidContainer';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { DockviewComponent } from '../../../../dockview/dockviewComponent';
+import { DockviewGroupPanel } from '../../../../dockview/dockviewGroupPanel';
+import { fireEvent } from '@testing-library/dom';
+
+describe('voidContainer', () => {
+    test('that `pointerDown` triggers activation', () => {
+        const accessor = fromPartial<DockviewComponent>({
+            doSetGroupActive: jest.fn(),
+        });
+        const group = fromPartial<DockviewGroupPanel>({});
+        const cut = new VoidContainer(accessor, group);
+
+        expect(accessor.doSetGroupActive).not.toHaveBeenCalled();
+
+        fireEvent.pointerDown(cut.element);
+        expect(accessor.doSetGroupActive).toHaveBeenCalledWith(group);
+    });
+});

packages/dockview-core/src/__tests__/dockview/components/watermark/watermark.spec.ts

@@ -1,27 +0,0 @@
-import { DockviewApi } from '../../../../api/component.api';
-import { Watermark } from '../../../../dockview/components/watermark/watermark';
-
-describe('watermark', () => {
-    test('that the group is closed when the close button is clicked', () => {
-        const cut = new Watermark();
-
-        const mockApi = jest.fn<Partial<DockviewApi>, any[]>(() => {
-            return {
-                removeGroup: jest.fn(),
-            };
-        });
-        const api = <DockviewApi>new mockApi();
-        const group = jest.fn() as any;
-
-        cut.init({ containerApi: api });
-        cut.updateParentGroup(group, true);
-
-        const closeEl = cut.element.querySelector('.close-action')!;
-
-        expect(closeEl).toBeTruthy();
-
-        closeEl.dispatchEvent(new Event('click'));
-
-        expect(api.removeGroup).toHaveBeenCalledWith(group);
-    });
-});

packages/dockview-core/src/__tests__/dockview/dockviewGroupPanel.spec.ts

@@ -0,0 +1,190 @@
+import { DockviewComponent } from '../../dockview/dockviewComponent';
+import { DockviewGroupPanel } from '../../dockview/dockviewGroupPanel';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { GroupOptions } from '../../dockview/dockviewGroupPanelModel';
+import { DockviewPanel, IDockviewPanel } from '../../dockview/dockviewPanel';
+import { DockviewPanelModelMock } from '../__mocks__/mockDockviewPanelModel';
+import { IContentRenderer, ITabRenderer } from '../../dockview/types';
+import { OverlayRenderContainer } from '../../overlay/overlayRenderContainer';
+import { IDockviewPanelModel } from '../../dockview/dockviewPanelModel';
+import { ContentContainer } from '../../dockview/components/panel/content';
+
+describe('dockviewGroupPanel', () => {
+    test('default minimum/maximium width/height', () => {
+        const accessor = fromPartial<DockviewComponent>({
+            onDidActivePanelChange: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            onDidOptionsChange: jest.fn(),
+        });
+        const options = fromPartial<GroupOptions>({});
+        const cut = new DockviewGroupPanel(accessor, 'test_id', options);
+
+        expect(cut.minimumWidth).toBe(100);
+        expect(cut.minimumHeight).toBe(100);
+        expect(cut.maximumHeight).toBe(Number.MAX_SAFE_INTEGER);
+        expect(cut.maximumWidth).toBe(Number.MAX_SAFE_INTEGER);
+    });
+
+    test('that onDidActivePanelChange is configured at inline', () => {
+        const accessor = fromPartial<DockviewComponent>({
+            onDidActivePanelChange: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            options: {},
+            api: {},
+            renderer: 'always',
+            overlayRenderContainer: {
+                attach: jest.fn(),
+                detatch: jest.fn(),
+            },
+            doSetGroupActive: jest.fn(),
+            onDidOptionsChange: jest.fn(),
+        });
+        const options = fromPartial<GroupOptions>({});
+
+        const cut = new DockviewGroupPanel(accessor, 'test_id', options);
+
+        let counter = 0;
+
+        cut.api.onDidActivePanelChange((event) => {
+            counter++;
+        });
+
+        cut.model.openPanel(
+            fromPartial<IDockviewPanel>({
+                updateParentGroup: jest.fn(),
+                view: {
+                    tab: { element: document.createElement('div') },
+                    content: new ContentContainer(accessor, cut.model),
+                },
+                api: {
+                    renderer: 'onlyWhenVisible',
+                    onDidTitleChange: jest.fn(),
+                    onDidParametersChange: jest.fn(),
+                },
+                layout: jest.fn(),
+                runEvents: jest.fn(),
+            })
+        );
+
+        expect(counter).toBe(1);
+    });
+
+    test('group constraints', () => {
+        const accessor = fromPartial<DockviewComponent>({
+            onDidActivePanelChange: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            doSetGroupActive: jest.fn(),
+            overlayRenderContainer: fromPartial<OverlayRenderContainer>({
+                attach: jest.fn(),
+                detatch: jest.fn(),
+            }),
+            options: {},
+            onDidOptionsChange: jest.fn(),
+        });
+        const options = fromPartial<GroupOptions>({});
+        const cut = new DockviewGroupPanel(accessor, 'test_id', options);
+
+        cut.api.setConstraints({
+            minimumHeight: 10,
+            maximumHeight: 100,
+            minimumWidth: 20,
+            maximumWidth: 200,
+        });
+
+        // initial constraints
+
+        expect(cut.minimumWidth).toBe(20);
+        expect(cut.minimumHeight).toBe(10);
+        expect(cut.maximumHeight).toBe(100);
+        expect(cut.maximumWidth).toBe(200);
+
+        const panelModel = new DockviewPanelModelMock(
+            'content_component',
+            fromPartial<IContentRenderer>({
+                element: document.createElement('div'),
+            }),
+            'tab_component',
+            fromPartial<ITabRenderer>({
+                element: document.createElement('div'),
+            })
+        );
+
+        const panel = new DockviewPanel(
+            'panel_id',
+            'component_id',
+            undefined,
+            accessor,
+            accessor.api,
+            cut,
+            panelModel,
+            {
+                renderer: 'onlyWhenVisible',
+                minimumWidth: 21,
+                minimumHeight: 11,
+                maximumHeight: 101,
+                maximumWidth: 201,
+            }
+        );
+
+        cut.model.openPanel(panel);
+
+        // active panel constraints
+
+        expect(cut.minimumWidth).toBe(21);
+        expect(cut.minimumHeight).toBe(11);
+        expect(cut.maximumHeight).toBe(101);
+        expect(cut.maximumWidth).toBe(201);
+
+        const panel2 = new DockviewPanel(
+            'panel_id',
+            'component_id',
+            undefined,
+            accessor,
+            accessor.api,
+            cut,
+            panelModel,
+            {
+                renderer: 'onlyWhenVisible',
+                minimumWidth: 22,
+                minimumHeight: 12,
+                maximumHeight: 102,
+                maximumWidth: 202,
+            }
+        );
+
+        cut.model.openPanel(panel2);
+
+        // active panel constraints
+
+        expect(cut.minimumWidth).toBe(22);
+        expect(cut.minimumHeight).toBe(12);
+        expect(cut.maximumHeight).toBe(102);
+        expect(cut.maximumWidth).toBe(202);
+
+        const panel3 = new DockviewPanel(
+            'panel_id',
+            'component_id',
+            undefined,
+            accessor,
+            accessor.api,
+            cut,
+            panelModel,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
+
+        cut.model.openPanel(panel3);
+
+        // active panel without specified constraints so falls back to group constraints
+
+        expect(cut.minimumWidth).toBe(20);
+        expect(cut.minimumHeight).toBe(10);
+        expect(cut.maximumHeight).toBe(100);
+        expect(cut.maximumWidth).toBe(200);
+    });
+});

packages/dockview-core/src/__tests__/dockview/dockviewGroupPanelModel.spec.ts

@@ -21,7 +21,10 @@ import { IDockviewPanelModel } from '../../dockview/dockviewPanelModel';
 import { DockviewGroupPanel } from '../../dockview/dockviewGroupPanel';
 import { WatermarkRendererInitParameters } from '../../dockview/types';
 import { createOffsetDragOverEvent } from '../__test_utils__/utils';
-import { OverlayRenderContainer } from '../../overlayRenderContainer';
+import { OverlayRenderContainer } from '../../overlay/overlayRenderContainer';
+import { Emitter } from '../../events';
+import { fromPartial } from '@total-typescript/shoehorn';
+import { TabLocation } from '../../dockview/framework';
 
 enum GroupChangeKind2 {
     ADD_PANEL,
@@ -34,12 +37,16 @@ class TestModel implements IDockviewPanelModel {
     readonly contentComponent: string;
     readonly tab: ITabRenderer;
 
-    constructor(id: string) {
+    constructor(readonly id: string) {
         this.content = new TestHeaderPart(id);
         this.contentComponent = id;
         this.tab = new TestContentPart(id);
     }
 
+    createTabRenderer(tabLocation: TabLocation): ITabRenderer {
+        return new TestHeaderPart(this.id);
+    }
+
     update(event: PanelUpdateEvent): void {
         //
     }
@@ -95,10 +102,6 @@ class Watermark implements IWatermarkRenderer {
         return {};
     }
 
-    updateParentGroup() {
-        //
-    }
-
     dispose() {
         //
     }
@@ -196,7 +199,11 @@ export class TestPanel implements IDockviewPanel {
         this._params = params;
     }
 
-    updateParentGroup(group: DockviewGroupPanel, isGroupActive: boolean): void {
+    updateParentGroup(group: DockviewGroupPanel): void {
+        //
+    }
+
+    runEvents(): void {
         //
     }
 
@@ -236,13 +243,21 @@ describe('dockviewGroupPanelModel', () => {
     let removePanelMock: jest.Mock;
     let removeGroupMock: jest.Mock;
 
+    let panelApi: DockviewPanelApi;
+
     beforeEach(() => {
         removePanelMock = jest.fn();
         removeGroupMock = jest.fn();
 
         options = {};
 
-        dockview = (<Partial<DockviewComponent>>{
+        panelApi = fromPartial<DockviewPanelApi>({
+            renderer: 'onlyWhenVisible',
+            onDidTitleChange: new Emitter().event,
+            onDidParametersChange: new Emitter().event,
+        });
+
+        dockview = fromPartial<DockviewComponent>({
             options: {},
             createWatermarkComponent: () => new Watermark(),
             doSetGroupActive: jest.fn(),
@@ -252,24 +267,20 @@ describe('dockviewGroupPanelModel', () => {
             onDidAddPanel: () => ({ dispose: jest.fn() }),
             onDidRemovePanel: () => ({ dispose: jest.fn() }),
             overlayRenderContainer: new OverlayRenderContainer(
-                document.createElement('div')
+                document.createElement('div'),
+                fromPartial<DockviewComponent>({})
             ),
-        }) as DockviewComponent;
+            onDidOptionsChange: () => ({ dispose: jest.fn() }),
+        });
 
         groupview = new DockviewGroupPanel(dockview, 'groupview-1', options);
         groupview.initialize();
     });
 
     test('panel events are captured during de-serialization', () => {
-        const panel1 = new TestPanel('panel1', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel2 = new TestPanel('panel2', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel3 = new TestPanel('panel3', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel1 = new TestPanel('panel1', panelApi);
+        const panel2 = new TestPanel('panel2', panelApi);
+        const panel3 = new TestPanel('panel3', panelApi);
 
         const groupview2 = new DockviewGroupPanel(dockview, 'groupview-2', {
             panels: [panel1, panel2, panel3],
@@ -353,15 +364,9 @@ describe('dockviewGroupPanelModel', () => {
             })
         );
 
-        const panel1 = new TestPanel('panel1', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel2 = new TestPanel('panel2', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel3 = new TestPanel('panel3', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel1 = new TestPanel('panel1', panelApi);
+        const panel2 = new TestPanel('panel2', panelApi);
+        const panel3 = new TestPanel('panel3', panelApi);
 
         expect(events.length).toBe(0);
 
@@ -439,15 +444,9 @@ describe('dockviewGroupPanelModel', () => {
     });
 
     test('moveToPrevious and moveToNext', () => {
-        const panel1 = new TestPanel('panel1', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel2 = new TestPanel('panel2', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel3 = new TestPanel('panel3', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel1 = new TestPanel('panel1', panelApi);
+        const panel2 = new TestPanel('panel2', panelApi);
+        const panel3 = new TestPanel('panel3', panelApi);
 
         groupview.model.openPanel(panel1);
         groupview.model.openPanel(panel2);
@@ -480,26 +479,20 @@ describe('dockviewGroupPanelModel', () => {
 
     test('default', () => {
         let viewQuery = groupview.element.querySelectorAll(
-            '.groupview > .tabs-and-actions-container'
+            '.dv-groupview > .dv-tabs-and-actions-container'
         );
         expect(viewQuery).toBeTruthy();
 
         viewQuery = groupview.element.querySelectorAll(
-            '.groupview > .content-container'
+            '.dv-groupview > .dv-content-container'
         );
         expect(viewQuery).toBeTruthy();
     });
 
     test('closeAllPanels with panels', () => {
-        const panel1 = new TestPanel('panel1', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel2 = new TestPanel('panel2', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
-        const panel3 = new TestPanel('panel3', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel1 = new TestPanel('panel1', panelApi);
+        const panel2 = new TestPanel('panel2', panelApi);
+        const panel3 = new TestPanel('panel3', panelApi);
 
         groupview.model.openPanel(panel1);
         groupview.model.openPanel(panel2);
@@ -507,21 +500,25 @@ describe('dockviewGroupPanelModel', () => {
 
         groupview.model.closeAllPanels();
 
-        expect(removePanelMock).toBeCalledWith(panel1);
-        expect(removePanelMock).toBeCalledWith(panel2);
-        expect(removePanelMock).toBeCalledWith(panel3);
+        expect(removePanelMock).toHaveBeenCalledWith(panel1, undefined);
+        expect(removePanelMock).toHaveBeenCalledWith(panel2, undefined);
+        expect(removePanelMock).toHaveBeenCalledWith(panel3, undefined);
     });
 
     test('closeAllPanels with no panels', () => {
         groupview.model.closeAllPanels();
-        expect(removeGroupMock).toBeCalledWith(groupview);
+        expect(removeGroupMock).toHaveBeenCalledWith(groupview);
     });
 
     test('that group is set on panel during onDidAddPanel event', () => {
-        const cut = new DockviewComponent({
-            parentElement: document.createElement('div'),
-            components: {
-                component: TestContentPart,
+        const cut = new DockviewComponent(document.createElement('div'), {
+            createComponent(options) {
+                switch (options.name) {
+                    case 'component':
+                        return new TestContentPart(options.id);
+                    default:
+                        throw new Error(`unsupported`);
+                }
             },
         });
 
@@ -534,12 +531,19 @@ describe('dockviewGroupPanelModel', () => {
     });
 
     test('toJSON() default', () => {
-        const dockviewComponent = new DockviewComponent({
-            parentElement: document.createElement('div'),
-            components: {
-                component: TestContentPart,
-            },
-        });
+        const dockviewComponent = new DockviewComponent(
+            document.createElement('div'),
+            {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'component':
+                            return new TestContentPart(options.id);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            }
+        );
 
         const cut = new DockviewGroupPanelModel(
             document.createElement('div'),
@@ -557,12 +561,19 @@ describe('dockviewGroupPanelModel', () => {
     });
 
     test('toJSON() locked and hideHeader', () => {
-        const dockviewComponent = new DockviewComponent({
-            parentElement: document.createElement('div'),
-            components: {
-                component: TestContentPart,
-            },
-        });
+        const dockviewComponent = new DockviewComponent(
+            document.createElement('div'),
+            {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'component':
+                            return new TestContentPart(options.id);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            }
+        );
 
         const cut = new DockviewGroupPanelModel(
             document.createElement('div'),
@@ -585,12 +596,19 @@ describe('dockviewGroupPanelModel', () => {
     });
 
     test("that openPanel with skipSetActive doesn't set panel to active", () => {
-        const dockviewComponent = new DockviewComponent({
-            parentElement: document.createElement('div'),
-            components: {
-                component: TestContentPart,
-            },
-        });
+        const dockviewComponent = new DockviewComponent(
+            document.createElement('div'),
+            {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'component':
+                            return new TestContentPart(options.id);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            }
+        );
 
         const groupviewContainer = document.createElement('div');
         const cut = new DockviewGroupPanelModel(
@@ -601,30 +619,24 @@ describe('dockviewGroupPanelModel', () => {
             null as any
         );
         const contentContainer = groupviewContainer
-            .getElementsByClassName('content-container')
+            .getElementsByClassName('dv-content-container')
             .item(0)!.childNodes;
 
-        const panel1 = new TestPanel('id_1', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel1 = new TestPanel('id_1', panelApi);
 
         cut.openPanel(panel1);
         expect(contentContainer.length).toBe(1);
         expect(contentContainer.item(0)).toBe(panel1.view.content.element);
 
-        const panel2 = new TestPanel('id_2', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel2 = new TestPanel('id_2', panelApi);
 
         cut.openPanel(panel2);
         expect(contentContainer.length).toBe(1);
         expect(contentContainer.item(0)).toBe(panel2.view.content.element);
 
-        const panel3 = new TestPanel('id_2', {
-            renderer: 'onlyWhenVisibile',
-        } as any);
+        const panel3 = new TestPanel('id_2', panelApi);
 
-        cut.openPanel(panel3, { skipSetPanelActive: true });
+        cut.openPanel(panel3, { skipSetActive: true });
         expect(contentContainer.length).toBe(1);
         expect(contentContainer.item(0)).toBe(panel2.view.content.element);
 
@@ -634,18 +646,15 @@ describe('dockviewGroupPanelModel', () => {
     });
 
     test('that should not show drop target is external event', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                options: {
-                    showDndOverlay: jest.fn(),
-                },
-                getPanel: jest.fn(),
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            options: {},
+            getPanel: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
-        const accessor = new accessorMock() as DockviewComponent;
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -674,38 +683,41 @@ describe('dockviewGroupPanelModel', () => {
             new groupPanelMock() as DockviewGroupPanel
         );
 
-        const element = container
-            .getElementsByClassName('content-container')
-            .item(0)!;
+        let counter = 0;
 
-        jest.spyOn(element, 'clientHeight', 'get').mockImplementation(
+        cut.onUnhandledDragOverEvent(() => {
+            counter++;
+        });
+
+        const element = container
+            .getElementsByClassName('dv-content-container')
+            .item(0)! as HTMLElement;
+
+        jest.spyOn(element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(element, 'clientWidth', 'get').mockImplementation(() => 100);
+        jest.spyOn(element, 'offsetWidth', 'get').mockImplementation(() => 100);
 
         fireEvent.dragEnter(element);
         fireEvent.dragOver(element);
 
-        expect(accessor.options.showDndOverlay).toBeCalledTimes(1);
+        expect(counter).toBe(1);
 
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
+            element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 
     test('that the .locked behaviour is as', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                options: {
-                    showDndOverlay: () => true,
-                },
-                getPanel: jest.fn(),
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            options: {},
+            getPanel: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            onDidOptionsChange: jest.fn(),
         });
-        const accessor = new accessorMock() as DockviewComponent;
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -734,14 +746,18 @@ describe('dockviewGroupPanelModel', () => {
             new groupPanelMock() as DockviewGroupPanel
         );
 
-        const element = container
-            .getElementsByClassName('content-container')
-            .item(0)!;
+        cut.onUnhandledDragOverEvent((e) => {
+            e.accept();
+        });
 
-        jest.spyOn(element, 'clientHeight', 'get').mockImplementation(
+        const element = container
+            .getElementsByClassName('dv-content-container')
+            .item(0)! as HTMLElement;
+
+        jest.spyOn(element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(element, 'clientWidth', 'get').mockImplementation(() => 100);
+        jest.spyOn(element, 'offsetWidth', 'get').mockImplementation(() => 100);
 
         function run(value: number) {
             fireEvent.dragEnter(element);
@@ -755,7 +771,7 @@ describe('dockviewGroupPanelModel', () => {
         cut.locked = false;
         run(10);
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
+            element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(1);
         fireEvent.dragEnd(element);
 
@@ -763,7 +779,7 @@ describe('dockviewGroupPanelModel', () => {
         cut.locked = 'no-drop-target';
         run(10);
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
+            element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
         fireEvent.dragEnd(element);
 
@@ -771,7 +787,7 @@ describe('dockviewGroupPanelModel', () => {
         cut.locked = true;
         run(10);
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
+            element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(1);
         fireEvent.dragEnd(element);
 
@@ -779,37 +795,29 @@ describe('dockviewGroupPanelModel', () => {
         cut.locked = true;
         run(25);
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
+            element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
         fireEvent.dragEnd(element);
     });
 
-    test('that should not show drop target if dropping on self', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                options: {
-                    showDndOverlay: jest.fn(),
-                },
-                getPanel: jest.fn(),
-                doSetGroupActive: jest.fn(),
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                overlayRenderContainer: new OverlayRenderContainer(
-                    document.createElement('div')
-                ),
-            };
+    test('that should show drop target if dropping on self', () => {
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            options: {},
+            getPanel: jest.fn(),
+            doSetGroupActive: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            overlayRenderContainer: new OverlayRenderContainer(
+                document.createElement('div'),
+                fromPartial<DockviewComponent>({})
+            ),
+            onDidOptionsChange: jest.fn(),
         });
-        const accessor = new accessorMock() as DockviewComponent;
-        const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
-            () => {
-                return {
-                    canDisplayOverlay: jest.fn(),
-                };
-            }
-        );
 
-        const groupView = new groupviewMock() as DockviewGroupPanelModel;
+        const groupView = fromPartial<DockviewGroupPanelModel>({
+            canDisplayOverlay: jest.fn(),
+        });
 
         const groupPanelMock = jest.fn<Partial<DockviewGroupPanel>, []>(() => {
             return {
@@ -827,20 +835,22 @@ describe('dockviewGroupPanelModel', () => {
             new groupPanelMock() as DockviewGroupPanel
         );
 
-        cut.openPanel(
-            new TestPanel('panel1', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
+        let counter = 0;
+
+        cut.onUnhandledDragOverEvent(() => {
+            counter++;
+        });
+
+        cut.openPanel(new TestPanel('panel1', panelApi));
 
         const element = container
-            .getElementsByClassName('content-container')
-            .item(0)!;
+            .getElementsByClassName('dv-content-container')
+            .item(0)! as HTMLElement;
 
-        jest.spyOn(element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(element, 'clientWidth', 'get').mockImplementation(() => 100);
+        jest.spyOn(element, 'offsetWidth', 'get').mockImplementation(() => 100);
 
         LocalSelectionTransfer.getInstance().setData(
             [new PanelTransfer('testcomponentid', 'groupviewid', 'panel1')],
@@ -850,30 +860,28 @@ describe('dockviewGroupPanelModel', () => {
         fireEvent.dragEnter(element);
         fireEvent.dragOver(element);
 
-        expect(accessor.options.showDndOverlay).toBeCalledTimes(0);
+        expect(counter).toBe(0);
 
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
-        ).toBe(0);
+            element.getElementsByClassName('dv-drop-target-dropzone').length
+        ).toBe(1);
     });
 
-    test('that should not allow drop when dropping on self for same component id', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                options: {
-                    showDndOverlay: jest.fn(),
-                },
-                getPanel: jest.fn(),
-                doSetGroupActive: jest.fn(),
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                overlayRenderContainer: new OverlayRenderContainer(
-                    document.createElement('div')
-                ),
-            };
+    test('that should allow drop when dropping on self for same component id', () => {
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            options: {},
+            getPanel: jest.fn(),
+            doSetGroupActive: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            overlayRenderContainer: new OverlayRenderContainer(
+                document.createElement('div'),
+                fromPartial<DockviewComponent>({})
+            ),
+            onDidOptionsChange: jest.fn(),
         });
-        const accessor = new accessorMock() as DockviewComponent;
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -900,25 +908,23 @@ describe('dockviewGroupPanelModel', () => {
             new groupPanelMock() as DockviewGroupPanel
         );
 
-        cut.openPanel(
-            new TestPanel('panel1', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
-        cut.openPanel(
-            new TestPanel('panel2', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
+        let counter = 0;
+
+        cut.onUnhandledDragOverEvent(() => {
+            counter++;
+        });
+
+        cut.openPanel(new TestPanel('panel1', panelApi));
+        cut.openPanel(new TestPanel('panel2', panelApi));
 
         const element = container
-            .getElementsByClassName('content-container')
-            .item(0)!;
+            .getElementsByClassName('dv-content-container')
+            .item(0) as HTMLElement;
 
-        jest.spyOn(element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(element, 'clientWidth', 'get').mockImplementation(() => 100);
+        jest.spyOn(element, 'offsetWidth', 'get').mockImplementation(() => 100);
 
         LocalSelectionTransfer.getInstance().setData(
             [new PanelTransfer('testcomponentid', 'groupviewid', 'panel1')],
@@ -928,30 +934,28 @@ describe('dockviewGroupPanelModel', () => {
         fireEvent.dragEnter(element);
         fireEvent.dragOver(element);
 
-        expect(accessor.options.showDndOverlay).toBeCalledTimes(0);
+        expect(counter).toBe(0);
 
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
-        ).toBe(0);
+            element.getElementsByClassName('dv-drop-target-dropzone').length
+        ).toBe(1);
     });
 
     test('that should not allow drop when not dropping for different component id', () => {
-        const accessorMock = jest.fn<Partial<DockviewComponent>, []>(() => {
-            return {
-                id: 'testcomponentid',
-                options: {
-                    showDndOverlay: jest.fn(),
-                },
-                getPanel: jest.fn(),
-                doSetGroupActive: jest.fn(),
-                onDidAddPanel: jest.fn(),
-                onDidRemovePanel: jest.fn(),
-                overlayRenderContainer: new OverlayRenderContainer(
-                    document.createElement('div')
-                ),
-            };
+        const accessor = fromPartial<DockviewComponent>({
+            id: 'testcomponentid',
+            options: {},
+            getPanel: jest.fn(),
+            doSetGroupActive: jest.fn(),
+            onDidAddPanel: jest.fn(),
+            onDidRemovePanel: jest.fn(),
+            overlayRenderContainer: new OverlayRenderContainer(
+                document.createElement('div'),
+                fromPartial<DockviewComponent>({})
+            ),
+            onDidOptionsChange: jest.fn(),
         });
-        const accessor = new accessorMock() as DockviewComponent;
+
         const groupviewMock = jest.fn<Partial<DockviewGroupPanelModel>, []>(
             () => {
                 return {
@@ -978,25 +982,23 @@ describe('dockviewGroupPanelModel', () => {
             new groupPanelMock() as DockviewGroupPanel
         );
 
-        cut.openPanel(
-            new TestPanel('panel1', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
-        cut.openPanel(
-            new TestPanel('panel2', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
+        let counter = 0;
+
+        cut.onUnhandledDragOverEvent(() => {
+            counter++;
+        });
+
+        cut.openPanel(new TestPanel('panel1', panelApi));
+        cut.openPanel(new TestPanel('panel2', panelApi));
 
         const element = container
-            .getElementsByClassName('content-container')
-            .item(0)!;
+            .getElementsByClassName('dv-content-container')
+            .item(0) as HTMLElement;
 
-        jest.spyOn(element, 'clientHeight', 'get').mockImplementation(
+        jest.spyOn(element, 'offsetHeight', 'get').mockImplementation(
             () => 100
         );
-        jest.spyOn(element, 'clientWidth', 'get').mockImplementation(() => 100);
+        jest.spyOn(element, 'offsetWidth', 'get').mockImplementation(() => 100);
 
         LocalSelectionTransfer.getInstance().setData(
             [new PanelTransfer('anothercomponentid', 'groupviewid', 'panel1')],
@@ -1006,10 +1008,10 @@ describe('dockviewGroupPanelModel', () => {
         fireEvent.dragEnter(element);
         fireEvent.dragOver(element);
 
-        expect(accessor.options.showDndOverlay).toBeCalledTimes(1);
+        expect(counter).toBe(1);
 
         expect(
-            element.getElementsByClassName('drop-target-dropzone').length
+            element.getElementsByClassName('dv-drop-target-dropzone').length
         ).toBe(0);
     });
 
@@ -1088,25 +1090,17 @@ describe('dockviewGroupPanelModel', () => {
             container.getElementsByClassName('watermark-test-container').length
         ).toBe(1);
 
-        cut.openPanel(
-            new TestPanel('panel1', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
+        cut.openPanel(new TestPanel('panel1', panelApi));
 
         expect(
             container.getElementsByClassName('watermark-test-container').length
         ).toBe(0);
         expect(
-            container.getElementsByClassName('tabs-and-actions-container')
+            container.getElementsByClassName('dv-tabs-and-actions-container')
                 .length
         ).toBe(1);
 
-        cut.openPanel(
-            new TestPanel('panel2', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
+        cut.openPanel(new TestPanel('panel2', panelApi));
 
         expect(
             container.getElementsByClassName('watermark-test-container').length
@@ -1124,11 +1118,7 @@ describe('dockviewGroupPanelModel', () => {
             container.getElementsByClassName('watermark-test-container').length
         ).toBe(1);
 
-        cut.openPanel(
-            new TestPanel('panel1', {
-                renderer: 'onlyWhenVisibile',
-            } as any)
-        );
+        cut.openPanel(new TestPanel('panel1', panelApi));
 
         expect(
             container.getElementsByClassName('watermark-test-container').length

packages/dockview-core/src/__tests__/dockview/dockviewPanel.spec.ts

@@ -3,35 +3,37 @@ import { DockviewApi } from '../../api/component.api';
 import { DockviewPanel } from '../../dockview/dockviewPanel';
 import { IDockviewPanelModel } from '../../dockview/dockviewPanelModel';
 import { DockviewGroupPanel } from '../../dockview/dockviewGroupPanel';
+import { fromPartial } from '@total-typescript/shoehorn';
 
 describe('dockviewPanel', () => {
     test('update title', () => {
-        const dockviewApiMock = jest.fn<DockviewApi, []>(() => {
-            return {
+        const api = fromPartial<DockviewApi>({});
+        const accessor = fromPartial<DockviewComponent>({});
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest.fn(),
+                onDidLocationChange: jest.fn(),
                 onDidActiveChange: jest.fn(),
-            } as any;
+            },
         });
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return {} as any;
-        });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {} as any;
-        });
-        const panelModelMock = jest.fn<Partial<IDockviewPanelModel>, []>(() => {
-            return {
-                update: jest.fn(),
-                init: jest.fn(),
-            };
+        const model = fromPartial<IDockviewPanelModel>({
+            update: jest.fn(),
+            init: jest.fn(),
+            dispose: jest.fn(),
         });
 
-        const api = new dockviewApiMock();
-        const accessor = new accessorMock();
-        const group = new groupMock();
-        const model = <IDockviewPanelModel>new panelModelMock();
-
-        const cut = new DockviewPanel('fake-id', accessor, api, group, model, {
-            renderer: 'onlyWhenVisibile',
-        });
+        const cut = new DockviewPanel(
+            'fake-id',
+            'fake-component',
+            undefined,
+            accessor,
+            api,
+            group,
+            model,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
 
         let latestTitle: string | undefined = undefined;
 
@@ -53,32 +55,32 @@ describe('dockviewPanel', () => {
     });
 
     test('that .setTitle updates the title', () => {
-        const dockviewApiMock = jest.fn<DockviewApi, []>(() => {
-            return {
+        const api = fromPartial<DockviewApi>({});
+        const accessor = fromPartial<DockviewComponent>({});
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest.fn(),
+                onDidLocationChange: jest.fn(),
                 onDidActiveChange: jest.fn(),
-            } as any;
+            },
         });
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return {} as any;
-        });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {} as any;
-        });
-        const panelModelMock = jest.fn<Partial<IDockviewPanelModel>, []>(() => {
-            return {
-                update: jest.fn(),
-                init: jest.fn(),
-            };
+        const model = fromPartial<IDockviewPanelModel>({
+            update: jest.fn(),
+            init: jest.fn(),
         });
 
-        const api = new dockviewApiMock();
-        const accessor = new accessorMock();
-        const group = new groupMock();
-        const model = <IDockviewPanelModel>new panelModelMock();
-
-        const cut = new DockviewPanel('fake-id', accessor, api, group, model, {
-            renderer: 'onlyWhenVisibile',
-        });
+        const cut = new DockviewPanel(
+            'fake-id',
+            'fake-component',
+            undefined,
+            accessor,
+            api,
+            group,
+            model,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
 
         cut.init({ title: 'myTitle', params: {} });
         expect(cut.title).toBe('myTitle');
@@ -91,31 +93,39 @@ describe('dockviewPanel', () => {
     });
 
     test('dispose cleanup', () => {
-        const dockviewApiMock = jest.fn<DockviewApi, []>(() => {
-            return {} as any;
+        const api = fromPartial<DockviewApi>({});
+        const accessor = fromPartial<DockviewComponent>({});
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest
+                    .fn()
+                    .mockReturnValue({ dispose: jest.fn() }),
+                onDidLocationChange: jest
+                    .fn()
+                    .mockReturnValue({ dispose: jest.fn() }),
+                onDidActiveChange: jest
+                    .fn()
+                    .mockReturnValue({ dispose: jest.fn() }),
+            },
         });
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return {} as any;
-        });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {} as any;
-        });
-        const panelModelMock = jest.fn<Partial<IDockviewPanelModel>, []>(() => {
-            return {
-                update: jest.fn(),
-                init: jest.fn(),
-                dispose: jest.fn(),
-            };
+        const model = fromPartial<IDockviewPanelModel>({
+            update: jest.fn(),
+            init: jest.fn(),
+            dispose: jest.fn(),
         });
 
-        const api = new dockviewApiMock();
-        const accessor = new accessorMock();
-        const group = new groupMock();
-        const model = <IDockviewPanelModel>new panelModelMock();
-
-        const cut = new DockviewPanel('fake-id', accessor, api, group, model, {
-            renderer: 'onlyWhenVisibile',
-        });
+        const cut = new DockviewPanel(
+            'fake-id',
+            'fake-component',
+            undefined,
+            accessor,
+            api,
+            group,
+            model,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
 
         cut.init({ params: {}, title: 'title' });
 
@@ -125,31 +135,33 @@ describe('dockviewPanel', () => {
     });
 
     test('get params', () => {
-        const dockviewApiMock = jest.fn<DockviewApi, []>(() => {
-            return {} as any;
+        const api = fromPartial<DockviewApi>({});
+        const accessor = fromPartial<DockviewComponent>({});
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest.fn(),
+                onDidLocationChange: jest.fn(),
+                onDidActiveChange: jest.fn(),
+            },
         });
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return {} as any;
-        });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {} as any;
-        });
-        const panelModelMock = jest.fn<Partial<IDockviewPanelModel>, []>(() => {
-            return {
-                update: jest.fn(),
-                init: jest.fn(),
-                dispose: jest.fn(),
-            };
+        const model = fromPartial<IDockviewPanelModel>({
+            update: jest.fn(),
+            init: jest.fn(),
+            dispose: jest.fn(),
         });
 
-        const api = new dockviewApiMock();
-        const accessor = new accessorMock();
-        const group = new groupMock();
-        const model = <IDockviewPanelModel>new panelModelMock();
-
-        const cut = new DockviewPanel('fake-id', accessor, api, group, model, {
-            renderer: 'onlyWhenVisibile',
-        });
+        const cut = new DockviewPanel(
+            'fake-id',
+            'fake-component',
+            undefined,
+            accessor,
+            api,
+            group,
+            model,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
 
         expect(cut.params).toEqual(undefined);
 
@@ -159,68 +171,72 @@ describe('dockviewPanel', () => {
     });
 
     test('setSize propagates to underlying group', () => {
-        const dockviewApiMock = jest.fn<DockviewApi, []>(() => {
-            return {} as any;
+        const api = fromPartial<DockviewApi>({});
+        const accessor = fromPartial<DockviewComponent>({});
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest.fn(),
+                onDidLocationChange: jest.fn(),
+                onDidActiveChange: jest.fn(),
+                setSize: jest.fn(),
+            },
         });
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return {} as any;
-        });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {
-                api: {
-                    setSize: jest.fn(),
-                },
-            } as any;
-        });
-        const panelModelMock = jest.fn<Partial<IDockviewPanelModel>, []>(() => {
-            return {
-                update: jest.fn(),
-                init: jest.fn(),
-                dispose: jest.fn(),
-            };
+        const model = fromPartial<IDockviewPanelModel>({
+            update: jest.fn(),
+            init: jest.fn(),
+            dispose: jest.fn(),
         });
 
-        const api = new dockviewApiMock();
-        const accessor = new accessorMock();
-        const group = new groupMock();
-        const model = <IDockviewPanelModel>new panelModelMock();
-
-        const cut = new DockviewPanel('fake-id', accessor, api, group, model, {
-            renderer: 'onlyWhenVisibile',
-        });
+        const cut = new DockviewPanel(
+            'fake-id',
+            'fake-component',
+            undefined,
+            accessor,
+            api,
+            group,
+            model,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
 
         cut.api.setSize({ height: 123, width: 456 });
 
-        expect(group.api.setSize).toBeCalledWith({ height: 123, width: 456 });
-        expect(group.api.setSize).toBeCalledTimes(1);
+        expect(group.api.setSize).toHaveBeenCalledWith({
+            height: 123,
+            width: 456,
+        });
+        expect(group.api.setSize).toHaveBeenCalledTimes(1);
     });
 
     test('updateParameter', () => {
-        const dockviewApiMock = jest.fn<DockviewApi, []>(() => {
-            return {} as any;
+        const api = fromPartial<DockviewApi>({});
+        const accessor = fromPartial<DockviewComponent>({});
+        const group = fromPartial<DockviewGroupPanel>({
+            api: {
+                onDidVisibilityChange: jest.fn(),
+                onDidLocationChange: jest.fn(),
+                onDidActiveChange: jest.fn(),
+            },
         });
-        const accessorMock = jest.fn<DockviewComponent, []>(() => {
-            return {} as any;
-        });
-        const groupMock = jest.fn<DockviewGroupPanel, []>(() => {
-            return {} as any;
-        });
-        const panelModelMock = jest.fn<Partial<IDockviewPanelModel>, []>(() => {
-            return {
-                update: jest.fn(),
-                init: jest.fn(),
-                dispose: jest.fn(),
-            };
+        const model = fromPartial<IDockviewPanelModel>({
+            update: jest.fn(),
+            init: jest.fn(),
+            dispose: jest.fn(),
         });
 
-        const api = new dockviewApiMock();
-        const accessor = new accessorMock();
-        const group = new groupMock();
-        const model = <IDockviewPanelModel>new panelModelMock();
-
-        const cut = new DockviewPanel('fake-id', accessor, api, group, model, {
-            renderer: 'onlyWhenVisibile',
-        });
+        const cut = new DockviewPanel(
+            'fake-id',
+            'fake-component',
+            undefined,
+            accessor,
+            api,
+            group,
+            model,
+            {
+                renderer: 'onlyWhenVisible',
+            }
+        );
 
         cut.init({ params: { a: '1', b: '2' }, title: 'A title' });
         expect(cut.params).toEqual({ a: '1', b: '2' });
@@ -228,6 +244,9 @@ describe('dockviewPanel', () => {
         // update 'a' and add 'c'
         cut.update({ params: { a: '-1', c: '3' } });
         expect(cut.params).toEqual({ a: '-1', b: '2', c: '3' });
+        expect(model.update).toHaveBeenCalledWith({
+            params: { a: '-1', b: '2', c: '3' },
+        });
 
         cut.update({ params: { d: '4', e: '5', f: '6' } });
         expect(cut.params).toEqual({
@@ -238,6 +257,9 @@ describe('dockviewPanel', () => {
             e: '5',
             f: '6',
         });
+        expect(model.update).toHaveBeenCalledWith({
+            params: { a: '-1', b: '2', c: '3', d: '4', e: '5', f: '6' },
+        });
 
         cut.update({
             params: {
@@ -258,5 +280,8 @@ describe('dockviewPanel', () => {
             g: '',
             h: null,
         });
+        expect(model.update).toHaveBeenCalledWith({
+            params: { a: '-1', b: '2', c: '3', d: '', e: null, g: '', h: null },
+        });
     });
 });

packages/dockview-core/src/__tests__/dockview/dockviewPanelModel.spec.ts

@@ -1,16 +1,13 @@
-import {
-    DockviewComponent,
-    IDockviewComponent,
-} from '../../dockview/dockviewComponent';
+import { DockviewComponent } from '../../dockview/dockviewComponent';
 import { DockviewPanelModel } from '../../dockview/dockviewPanelModel';
 import { IContentRenderer, ITabRenderer } from '../../dockview/types';
-import { GroupPanelFrameworkComponentFactory } from '../../dockview/options';
 import { DefaultTab } from '../../dockview/components/tab/defaultTab';
+import { fromPartial } from '@total-typescript/shoehorn';
 
 describe('dockviewGroupPanel', () => {
     let contentMock: jest.Mock<IContentRenderer>;
     let tabMock: jest.Mock<ITabRenderer>;
-    let accessorMock: jest.Mock<IDockviewComponent>;
+    let accessorMock: DockviewComponent;
 
     beforeEach(() => {
         contentMock = jest.fn<IContentRenderer, []>(() => {
@@ -18,8 +15,6 @@ describe('dockviewGroupPanel', () => {
                 element: document.createElement('div'),
                 dispose: jest.fn(),
                 update: jest.fn(),
-                onGroupChange: jest.fn(),
-                onPanelVisibleChange: jest.fn(),
             };
             return partial as IContentRenderer;
         });
@@ -29,31 +24,35 @@ describe('dockviewGroupPanel', () => {
                 element: document.createElement('div'),
                 dispose: jest.fn(),
                 update: jest.fn(),
-                onGroupChange: jest.fn(),
-                onPanelVisibleChange: jest.fn(),
             };
             return partial as IContentRenderer;
         });
 
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    components: {
-                        contentComponent: contentMock,
-                    },
-                    tabComponents: {
-                        tabComponent: tabMock,
-                    },
+        accessorMock = fromPartial<DockviewComponent>({
+            options: {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'contentComponent':
+                            return new contentMock(options.id, options.name);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
                 },
-            };
-
-            return partial as DockviewComponent;
+                createTabComponent(options) {
+                    switch (options.name) {
+                        case 'tabComponent':
+                            return new tabMock(options.id, options.name);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            },
         });
     });
 
     test('that dispose is called on content and tab renderers when present', () => {
         const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
+            accessorMock,
             'id',
             'contentComponent',
             'tabComponent'
@@ -67,7 +66,7 @@ describe('dockviewGroupPanel', () => {
 
     test('that update is called on content and tab renderers when present', () => {
         const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
+            accessorMock,
             'id',
             'contentComponent',
             'tabComponent'
@@ -81,72 +80,30 @@ describe('dockviewGroupPanel', () => {
         expect(cut.tab.update).toHaveBeenCalled();
     });
 
-    test('that events are fired', () => {
-        const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
-            'id',
-            'contentComponent',
-            'tabComponent'
-        );
-
-        const group1 = jest.fn() as any;
-        const group2 = jest.fn() as any;
-        cut.updateParentGroup(group1, false);
-
-        expect(cut.content.onGroupChange).toHaveBeenNthCalledWith(1, group1);
-        expect(cut.tab.onGroupChange).toHaveBeenNthCalledWith(1, group1);
-        expect(cut.content.onPanelVisibleChange).toHaveBeenNthCalledWith(
-            1,
-            false
-        );
-        expect(cut.tab.onPanelVisibleChange).toHaveBeenNthCalledWith(1, false);
-        expect(cut.content.onGroupChange).toHaveBeenCalledTimes(1);
-        expect(cut.tab.onGroupChange).toHaveBeenCalledTimes(1);
-        expect(cut.content.onPanelVisibleChange).toHaveBeenCalledTimes(1);
-        expect(cut.tab.onPanelVisibleChange).toHaveBeenCalledTimes(1);
-
-        cut.updateParentGroup(group1, true);
-
-        expect(cut.content.onPanelVisibleChange).toHaveBeenNthCalledWith(
-            2,
-            true
-        );
-        expect(cut.tab.onPanelVisibleChange).toHaveBeenNthCalledWith(2, true);
-        expect(cut.content.onGroupChange).toHaveBeenCalledTimes(1);
-        expect(cut.tab.onGroupChange).toHaveBeenCalledTimes(1);
-        expect(cut.content.onPanelVisibleChange).toHaveBeenCalledTimes(2);
-        expect(cut.tab.onPanelVisibleChange).toHaveBeenCalledTimes(2);
-
-        cut.updateParentGroup(group2, true);
-
-        expect(cut.content.onGroupChange).toHaveBeenNthCalledWith(2, group2);
-        expect(cut.tab.onGroupChange).toHaveBeenNthCalledWith(2, group2);
-        expect(cut.content.onGroupChange).toHaveBeenCalledTimes(2);
-        expect(cut.tab.onGroupChange).toHaveBeenCalledTimes(2);
-        expect(cut.content.onPanelVisibleChange).toHaveBeenCalledTimes(2);
-        expect(cut.tab.onPanelVisibleChange).toHaveBeenCalledTimes(2);
-    });
-
     test('that the default tab is created', () => {
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    components: {
-                        contentComponent: contentMock,
-                    },
-                    tabComponents: {
-                        tabComponent: jest
-                            .fn()
-                            .mockImplementation(() => tabMock),
-                    },
+        accessorMock = fromPartial<DockviewComponent>({
+            options: {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'contentComponent':
+                            return new contentMock(options.id, options.name);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
                 },
-            };
-
-            return partial as DockviewComponent;
+                createTabComponent(options) {
+                    switch (options.name) {
+                        case 'tabComponent':
+                            return tabMock;
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            },
         });
 
         const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
+            accessorMock,
             'id',
             'contentComponent',
             'tabComponent'
@@ -156,26 +113,30 @@ describe('dockviewGroupPanel', () => {
     });
 
     test('that the provided default tab is chosen when no implementation is provided', () => {
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    components: {
-                        contentComponent: contentMock,
-                    },
-                    tabComponents: {
-                        tabComponent: jest
-                            .fn()
-                            .mockImplementation(() => tabMock),
-                    },
-                    defaultTabComponent: 'tabComponent',
+        accessorMock = fromPartial<DockviewComponent>({
+            options: {
+                defaultTabComponent: 'tabComponent',
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'contentComponent':
+                            return new contentMock(options.id, options.name);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
                 },
-            };
-
-            return partial as DockviewComponent;
+                createTabComponent(options) {
+                    switch (options.name) {
+                        case 'tabComponent':
+                            return tabMock;
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            },
         });
 
         const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
+            accessorMock,
             'id',
             'contentComponent'
         );
@@ -183,56 +144,22 @@ describe('dockviewGroupPanel', () => {
         expect(cut.tab).toEqual(tabMock);
     });
 
-    test('that the framework tab is created when provided tab is a framework tab', () => {
-        const tab = jest.fn();
-        const tabFactory = jest.fn().mockImplementation(() => tab);
-
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    components: {
-                        contentComponent: contentMock,
-                    },
-                    frameworkTabComponents: {
-                        tabComponent: tabMock,
-                    },
-                    frameworkComponentFactory: (<
-                        Partial<GroupPanelFrameworkComponentFactory>
-                    >{
-                        tab: { createComponent: tabFactory },
-                    }) as GroupPanelFrameworkComponentFactory,
-                },
-            };
-
-            return partial as DockviewComponent;
-        });
-
-        const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
-            'id',
-            'contentComponent',
-            'tabComponent'
-        );
-
-        expect(tabFactory).toHaveBeenCalledWith('id', 'tabComponent', tabMock);
-        expect(cut.tab).toEqual(tab);
-    });
-
     test('that is library default tab instance is created when no alternative exists', () => {
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    components: {
-                        contentComponent: contentMock,
-                    },
+        accessorMock = fromPartial<DockviewComponent>({
+            options: {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'contentComponent':
+                            return new contentMock(options.id, options.name);
+                        default:
+                            throw new Error(`unsupported`);
+                    }
                 },
-            };
-
-            return partial as DockviewComponent;
+            },
         });
 
         const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
+            accessorMock,
             'id',
             'contentComponent'
         );
@@ -241,61 +168,33 @@ describe('dockviewGroupPanel', () => {
     });
 
     test('that the default content is created', () => {
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    components: {
-                        contentComponent: jest.fn().mockImplementation(() => {
+        accessorMock = fromPartial<DockviewComponent>({
+            options: {
+                createComponent(options) {
+                    switch (options.name) {
+                        case 'contentComponent':
                             return contentMock;
-                        }),
-                    },
+                        default:
+                            throw new Error(`unsupported`);
+                    }
                 },
-            };
-
-            return partial as DockviewComponent;
+                createTabComponent(options) {
+                    switch (options.name) {
+                        case 'tabComponent':
+                            return tabMock;
+                        default:
+                            throw new Error(`unsupported`);
+                    }
+                },
+            },
         });
 
         const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
+            accessorMock,
             'id',
             'contentComponent'
         );
 
         expect(cut.content).toEqual(contentMock);
     });
-
-    test('that the framework content is created', () => {
-        const content = jest.fn();
-        const contentFactory = jest.fn().mockImplementation(() => content);
-
-        accessorMock = jest.fn<DockviewComponent, []>(() => {
-            const partial: Partial<DockviewComponent> = {
-                options: {
-                    frameworkComponents: {
-                        contentComponent: contentMock,
-                    },
-                    frameworkComponentFactory: (<
-                        Partial<GroupPanelFrameworkComponentFactory>
-                    >{
-                        content: { createComponent: contentFactory },
-                    }) as GroupPanelFrameworkComponentFactory,
-                },
-            };
-
-            return partial as DockviewComponent;
-        });
-
-        const cut = new DockviewPanelModel(
-            <IDockviewComponent>new accessorMock(),
-            'id',
-            'contentComponent'
-        );
-
-        expect(contentFactory).toHaveBeenCalledWith(
-            'id',
-            'contentComponent',
-            contentMock
-        );
-        expect(cut.content).toEqual(content);
-    });
 });

packages/dockview-core/src/__tests__/dom.spec.ts

@@ -1,4 +1,5 @@
 import {
+    disableIframePointEvents,
     isInDocument,
     quasiDefaultPrevented,
     quasiPreventDefault,
@@ -45,4 +46,38 @@ describe('dom', () => {
 
         expect(isInDocument(el2)).toBeTruthy();
     });
+
+    test('disableIframePointEvents', () => {
+        const el1 = document.createElement('iframe');
+        const el2 = document.createElement('iframe');
+        const el3 = document.createElement('webview');
+        const el4 = document.createElement('webview');
+
+        document.body.appendChild(el1);
+        document.body.appendChild(el2);
+        document.body.appendChild(el3);
+        document.body.appendChild(el4);
+
+        el1.style.pointerEvents = 'inherit';
+        el3.style.pointerEvents = 'inherit';
+
+        expect(el1.style.pointerEvents).toBe('inherit');
+        expect(el2.style.pointerEvents).toBe('');
+        expect(el3.style.pointerEvents).toBe('inherit');
+        expect(el4.style.pointerEvents).toBe('');
+
+        const f = disableIframePointEvents();
+
+        expect(el1.style.pointerEvents).toBe('none');
+        expect(el2.style.pointerEvents).toBe('none');
+        expect(el3.style.pointerEvents).toBe('none');
+        expect(el4.style.pointerEvents).toBe('none');
+
+        f.release();
+
+        expect(el1.style.pointerEvents).toBe('inherit');
+        expect(el2.style.pointerEvents).toBe('');
+        expect(el3.style.pointerEvents).toBe('inherit');
+        expect(el4.style.pointerEvents).toBe('');
+    });
 });

packages/dockview-core/src/__tests__/events.spec.ts

@@ -1,8 +1,8 @@
 import {
+    AsapEvent,
     Emitter,
     Event,
     addDisposableListener,
-    addDisposableWindowListener,
 } from '../events';
 
 describe('events', () => {
@@ -82,6 +82,41 @@ describe('events', () => {
         });
     });
 
+    describe('asapEvent', () => {
+        test('that asapEvents fire once per event-loop-cycle', () => {
+            jest.useFakeTimers();
+
+            const event = new AsapEvent();
+
+            let preFireCount = 0;
+            let postFireCount = 0;
+
+            event.onEvent(() => {
+                preFireCount++;
+            });
+
+            for (let i = 0; i < 100; i++) {
+                event.fire();
+            }
+
+            /**
+             * check that subscribing after the events have fired but before the event-loop cycle completes
+             * results in no event fires.
+             */
+            event.onEvent((e) => {
+                postFireCount++;
+            });
+
+            expect(preFireCount).toBe(0);
+            expect(postFireCount).toBe(0);
+
+            jest.runAllTimers();
+
+            expect(preFireCount).toBe(1);
+            expect(postFireCount).toBe(0);
+        });
+    });
+
     it('should emit a value when any event fires', () => {
         const emitter1 = new Emitter<number>();
         const emitter2 = new Emitter<number>();
@@ -107,73 +142,6 @@ describe('events', () => {
         expect(value).toBe(3);
     });
 
-    it('addDisposableWindowListener with capture options', () => {
-        const element = {
-            addEventListener: jest.fn(),
-            removeEventListener: jest.fn(),
-        };
-
-        const handler = jest.fn();
-
-        const disposable = addDisposableWindowListener(
-            element as any,
-            'mousedown',
-            handler,
-            true
-        );
-
-        expect(element.addEventListener).toBeCalledTimes(1);
-        expect(element.addEventListener).toHaveBeenCalledWith(
-            'mousedown',
-            handler,
-            true
-        );
-        expect(element.removeEventListener).toBeCalledTimes(0);
-
-        disposable.dispose();
-
-        expect(element.addEventListener).toBeCalledTimes(1);
-        expect(element.removeEventListener).toBeCalledTimes(1);
-        expect(element.removeEventListener).toBeCalledWith(
-            'mousedown',
-            handler,
-            true
-        );
-    });
-
-    it('addDisposableWindowListener without capture options', () => {
-        const element = {
-            addEventListener: jest.fn(),
-            removeEventListener: jest.fn(),
-        };
-
-        const handler = jest.fn();
-
-        const disposable = addDisposableWindowListener(
-            element as any,
-            'mousedown',
-            handler
-        );
-
-        expect(element.addEventListener).toBeCalledTimes(1);
-        expect(element.addEventListener).toHaveBeenCalledWith(
-            'mousedown',
-            handler,
-            undefined
-        );
-        expect(element.removeEventListener).toBeCalledTimes(0);
-
-        disposable.dispose();
-
-        expect(element.addEventListener).toBeCalledTimes(1);
-        expect(element.removeEventListener).toBeCalledTimes(1);
-        expect(element.removeEventListener).toBeCalledWith(
-            'mousedown',
-            handler,
-            undefined
-        );
-    });
-
     it('addDisposableListener with capture options', () => {
         const element = {
             addEventListener: jest.fn(),
@@ -184,14 +152,14 @@ describe('events', () => {
 
         const disposable = addDisposableListener(
             element as any,
-            'mousedown',
+            'pointerdown',
             handler,
             true
         );
 
         expect(element.addEventListener).toBeCalledTimes(1);
         expect(element.addEventListener).toHaveBeenCalledWith(
-            'mousedown',
+            'pointerdown',
             handler,
             true
         );
@@ -202,7 +170,7 @@ describe('events', () => {
         expect(element.addEventListener).toBeCalledTimes(1);
         expect(element.removeEventListener).toBeCalledTimes(1);
         expect(element.removeEventListener).toBeCalledWith(
-            'mousedown',
+            'pointerdown',
             handler,
             true
         );
@@ -218,13 +186,13 @@ describe('events', () => {
 
         const disposable = addDisposableListener(
             element as any,
-            'mousedown',
+            'pointerdown',
             handler
         );
 
         expect(element.addEventListener).toBeCalledTimes(1);
         expect(element.addEventListener).toHaveBeenCalledWith(
-            'mousedown',
+            'pointerdown',
             handler,
             undefined
         );
@@ -235,7 +203,74 @@ describe('events', () => {
         expect(element.addEventListener).toBeCalledTimes(1);
         expect(element.removeEventListener).toBeCalledTimes(1);
         expect(element.removeEventListener).toBeCalledWith(
-            'mousedown',
+            'pointerdown',
+            handler,
+            undefined
+        );
+    });
+
+    it('addDisposableListener with capture options', () => {
+        const element = {
+            addEventListener: jest.fn(),
+            removeEventListener: jest.fn(),
+        };
+
+        const handler = jest.fn();
+
+        const disposable = addDisposableListener(
+            element as any,
+            'pointerdown',
+            handler,
+            true
+        );
+
+        expect(element.addEventListener).toBeCalledTimes(1);
+        expect(element.addEventListener).toHaveBeenCalledWith(
+            'pointerdown',
+            handler,
+            true
+        );
+        expect(element.removeEventListener).toBeCalledTimes(0);
+
+        disposable.dispose();
+
+        expect(element.addEventListener).toBeCalledTimes(1);
+        expect(element.removeEventListener).toBeCalledTimes(1);
+        expect(element.removeEventListener).toBeCalledWith(
+            'pointerdown',
+            handler,
+            true
+        );
+    });
+
+    it('addDisposableListener without capture options', () => {
+        const element = {
+            addEventListener: jest.fn(),
+            removeEventListener: jest.fn(),
+        };
+
+        const handler = jest.fn();
+
+        const disposable = addDisposableListener(
+            element as any,
+            'pointerdown',
+            handler
+        );
+
+        expect(element.addEventListener).toBeCalledTimes(1);
+        expect(element.addEventListener).toHaveBeenCalledWith(
+            'pointerdown',
+            handler,
+            undefined
+        );
+        expect(element.removeEventListener).toBeCalledTimes(0);
+
+        disposable.dispose();
+
+        expect(element.addEventListener).toBeCalledTimes(1);
+        expect(element.removeEventListener).toBeCalledTimes(1);
+        expect(element.removeEventListener).toBeCalledWith(
+            'pointerdown',
             handler,
             undefined
         );

packages/dockview-core/src/__tests__/gridview/baseComponentGridview.spec.ts

@@ -17,13 +17,9 @@ class TestPanel implements IGridPanelView {
     _onDidChange = new Emitter<IViewSize | undefined>();
     readonly onDidChange = this._onDidChange.event;
 
-    get isActive(): boolean {
-        return true;
-    }
-
-    get params(): Parameters {
-        return {};
-    }
+    isVisible: boolean = true;
+    isActive: boolean = true;
+    params: Parameters = {};
 
     constructor(
         public readonly id: string,
@@ -70,8 +66,10 @@ class TestPanel implements IGridPanelView {
 }
 
 class ClassUnderTest extends BaseGrid<TestPanel> {
-    constructor(options: BaseGridOptions) {
-        super(options);
+    readonly gridview = this.gridview;
+
+    constructor(parentElement: HTMLElement, options: BaseGridOptions) {
+        super(parentElement, options);
     }
 
     doRemoveGroup(
@@ -107,24 +105,62 @@ class ClassUnderTest extends BaseGrid<TestPanel> {
 }
 
 describe('baseComponentGridview', () => {
-    test('can add group', () => {
-        const cut = new ClassUnderTest({
-            parentElement: document.createElement('div'),
+    test('that the container is not removed when grid is disposed', () => {
+        const root = document.createElement('div');
+        const container = document.createElement('div');
+        root.appendChild(container);
+
+        const cut = new ClassUnderTest(container, {
             orientation: Orientation.HORIZONTAL,
             proportionalLayout: true,
         });
 
-        const events: (TestPanel | undefined)[] = [];
+        cut.dispose();
+
+        expect(container.parentElement).toBe(root);
+    });
+
+    test('that .layout(...) force flag works', () => {
+        const cut = new ClassUnderTest(document.createElement('div'), {
+            orientation: Orientation.HORIZONTAL,
+            proportionalLayout: true,
+        });
+
+        const spy = jest.spyOn(cut.gridview, 'layout');
+
+        cut.layout(100, 100);
+        expect(spy).toHaveBeenCalledTimes(1);
+
+        cut.layout(100, 100, false);
+        expect(spy).toHaveBeenCalledTimes(1);
+
+        cut.layout(100, 100, true);
+        expect(spy).toHaveBeenCalledTimes(2);
+
+        cut.layout(150, 150, false);
+        expect(spy).toHaveBeenCalledTimes(3);
+
+        cut.layout(150, 150, true);
+        expect(spy).toHaveBeenCalledTimes(4);
+    });
+
+    test('can add group', () => {
+        const cut = new ClassUnderTest(document.createElement('div'), {
+            orientation: Orientation.HORIZONTAL,
+            proportionalLayout: true,
+        });
+
+        const events: { type: string; panel: TestPanel | undefined }[] = [];
 
         const disposable = new CompositeDisposable(
-            cut.onDidAddGroup((event) => {
-                events.push(event);
+            cut.onDidAdd((event) => {
+                events.push({ type: 'add', panel: event });
             }),
-            cut.onDidRemoveGroup((event) => {
-                events.push(event);
+            cut.onDidRemove((event) => {
+                events.push({ type: 'remove', panel: event });
             }),
-            cut.onDidActiveGroupChange((event) => {
-                events.push(event);
+            cut.onDidActiveChange((event) => {
+                events.push({ type: 'active', panel: event });
             })
         );
 
@@ -141,9 +177,8 @@ describe('baseComponentGridview', () => {
 
         cut.doAddGroup(panel1);
 
-        expect(events.length).toBe(2);
-        expect(events[0]).toBe(panel1);
-        expect(events[1]).toBe(panel1);
+        expect(events.length).toBe(1);
+        expect(events[0]).toEqual({ type: 'add', panel: panel1 });
 
         const panel2 = new TestPanel(
             'id',
@@ -158,12 +193,12 @@ describe('baseComponentGridview', () => {
 
         cut.doAddGroup(panel2);
 
-        expect(events.length).toBe(4);
-        expect(events[2]).toBe(panel2);
+        expect(events.length).toBe(2);
+        expect(events[1]).toEqual({ type: 'add', panel: panel2 });
 
         cut.doRemoveGroup(panel1);
-        expect(events.length).toBe(5);
-        expect(events[4]).toBe(panel1);
+        expect(events.length).toBe(3);
+        expect(events[2]).toEqual({ type: 'remove', panel: panel1 });
 
         disposable.dispose();
         cut.dispose();

packages/dockview-core/src/__tests__/gridview/gridview.spec.ts

@@ -5,6 +5,7 @@ import {
     IGridView,
     IViewSize,
     SerializedGridview,
+    getGridLocation,
     orthogonal,
 } from '../../gridview/gridview';
 import { Orientation, Sizing } from '../../splitview/splitview';
@@ -18,7 +19,7 @@ class MockGridview implements IGridView {
         IViewSize | undefined
     >().event;
     element: HTMLElement = document.createElement('div');
-
+    isVisible: boolean = true;
     width: number = 0;
     height: number = 0;
 
@@ -843,7 +844,7 @@ describe('gridview', () => {
         gridview.layout(1000, 1000);
 
         let counter = 0;
-        const subscription = gridview.onDidMaxmizedNodeChange(() => {
+        const subscription = gridview.onDidMaximizedNodeChange(() => {
             counter++;
         });
 
@@ -1105,4 +1106,102 @@ describe('gridview', () => {
 
         expect(gridview.hasMaximizedView()).toBeFalsy();
     });
+
+    test('visibility check', () => {
+        const gridview = new Gridview(
+            true,
+            { separatorBorder: '' },
+            Orientation.HORIZONTAL
+        );
+        gridview.layout(1000, 1000);
+
+        const view1 = new MockGridview('1');
+        const view2 = new MockGridview('2');
+        const view3 = new MockGridview('3');
+        const view4 = new MockGridview('4');
+        const view5 = new MockGridview('5');
+        const view6 = new MockGridview('6');
+
+        gridview.addView(view1, Sizing.Distribute, [0]);
+        gridview.addView(view2, Sizing.Distribute, [1]);
+        gridview.addView(view3, Sizing.Distribute, [1, 1]);
+        gridview.addView(view4, Sizing.Distribute, [1, 1, 0]);
+        gridview.addView(view5, Sizing.Distribute, [1, 1, 0, 0]);
+        gridview.addView(view6, Sizing.Distribute, [1, 1, 0, 0, 0]);
+
+        /**
+         *   _____________________________________________
+         *  |                     |                       |
+         *  |                     |           2           |
+         *  |                     |                       |
+         *  |          1          |_______________________|
+         *  |                     |         |      4      |
+         *  |                     |    3    |_____________|
+         *  |                     |         |   5  |   6  |
+         *  |_____________________|_________|______|______|
+         */
+
+        function assertVisibility(visibility: boolean[]) {
+            expect(gridview.isViewVisible(getGridLocation(view1.element))).toBe(
+                visibility[0]
+            );
+            expect(gridview.isViewVisible(getGridLocation(view2.element))).toBe(
+                visibility[1]
+            );
+            expect(gridview.isViewVisible(getGridLocation(view3.element))).toBe(
+                visibility[2]
+            );
+            expect(gridview.isViewVisible(getGridLocation(view4.element))).toBe(
+                visibility[3]
+            );
+            expect(gridview.isViewVisible(getGridLocation(view5.element))).toBe(
+                visibility[4]
+            );
+            expect(gridview.isViewVisible(getGridLocation(view6.element))).toBe(
+                visibility[5]
+            );
+        }
+
+        // hide each view one by one
+
+        assertVisibility([true, true, true, true, true, true]);
+
+        gridview.setViewVisible(getGridLocation(view5.element), false);
+        assertVisibility([true, true, true, true, false, true]);
+
+        gridview.setViewVisible(getGridLocation(view4.element), false);
+        assertVisibility([true, true, true, false, false, true]);
+
+        gridview.setViewVisible(getGridLocation(view1.element), false);
+        assertVisibility([false, true, true, false, false, true]);
+
+        gridview.setViewVisible(getGridLocation(view2.element), false);
+        assertVisibility([false, false, true, false, false, true]);
+
+        gridview.setViewVisible(getGridLocation(view3.element), false);
+        assertVisibility([false, false, false, false, false, true]);
+
+        gridview.setViewVisible(getGridLocation(view6.element), false);
+        assertVisibility([false, false, false, false, false, false]);
+
+        // un-hide each view one by one
+
+        gridview.setViewVisible(getGridLocation(view1.element), true);
+        assertVisibility([true, false, false, false, false, false]);
+
+        gridview.setViewVisible(getGridLocation(view5.element), true);
+        assertVisibility([true, false, false, false, true, false]);
+
+        gridview.setViewVisible(getGridLocation(view6.element), true);
+        assertVisibility([true, false, false, false, true, true]);
+
+        gridview.setViewVisible(getGridLocation(view2.element), true);
+        assertVisibility([true, true, false, false, true, true]);
+
+        gridview.setViewVisible(getGridLocation(view3.element), true);
+        assertVisibility([true, true, true, false, true, true]);
+
+        gridview.setViewVisible(getGridLocation(view4.element), true);
+        assertVisibility([true, true, true, true, true, true]);
+    });
 });

packages/dockview-core/src/__tests__/gridview/gridviewComponent.spec.ts

@@ -32,12 +32,40 @@ describe('gridview', () => {
         container = document.createElement('div');
     });
 
-    test('added views are visible by default', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+    test('update className', () => {
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+            className: 'test-a test-b',
+        });
+
+        expect(gridview.element.className).toBe('test-a test-b');
+
+        gridview.updateOptions({ className: 'test-b test-c' });
+
+        expect(gridview.element.className).toBe('test-b test-c');
+    });
+
+    test('added views are visible by default', () => {
+        const gridview = new GridviewComponent(container, {
+            proportionalLayout: false,
+            orientation: Orientation.VERTICAL,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -53,11 +81,17 @@ describe('gridview', () => {
     });
 
     test('remove panel', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -84,11 +118,17 @@ describe('gridview', () => {
     });
 
     test('active panel', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -145,13 +185,21 @@ describe('gridview', () => {
     });
 
     test('deserialize and serialize a layout', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
+        expect(container.querySelectorAll('.dv-grid-view').length).toBe(1);
+
         gridview.layout(800, 400);
         gridview.fromJSON({
             grid: {
@@ -196,6 +244,9 @@ describe('gridview', () => {
             },
             activePanel: 'panel_1',
         });
+
+        expect(container.querySelectorAll('.dv-grid-view').length).toBe(1);
+
         gridview.layout(800, 400, true);
 
         const panel1 = gridview.getPanel('panel_1')!;
@@ -268,16 +319,22 @@ describe('gridview', () => {
                     ],
                 },
             },
-            activePanel: 'panel_1',
+            activePanel: 'panel_2',
         });
     });
 
     test('toJSON shouldnt fire any layout events', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(1000, 1000);
@@ -310,11 +367,17 @@ describe('gridview', () => {
     });
 
     test('gridview events', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -434,11 +497,17 @@ describe('gridview', () => {
     test('dispose of gridviewComponent', () => {
         expect(container.childNodes.length).toBe(0);
 
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -460,15 +529,21 @@ describe('gridview', () => {
 
         gridview.dispose();
 
-        expect(container.childNodes.length).toBe(0);
+        expect(container.children.length).toBe(0);
     });
 
     test('#1/VERTICAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -523,11 +598,17 @@ describe('gridview', () => {
     });
 
     test('#2/HORIZONTAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -582,11 +663,17 @@ describe('gridview', () => {
     });
 
     test('#3/HORIZONTAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -659,11 +746,17 @@ describe('gridview', () => {
     });
 
     test('#4/HORIZONTAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -754,11 +847,17 @@ describe('gridview', () => {
     });
 
     test('#5/VERTICAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -849,11 +948,17 @@ describe('gridview', () => {
     });
 
     test('#5/VERTICAL/proportional/false', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -944,11 +1049,17 @@ describe('gridview', () => {
     });
 
     test('#6/VERTICAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -1069,11 +1180,17 @@ describe('gridview', () => {
     });
 
     test('#7/VERTICAL layout first', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -1194,11 +1311,17 @@ describe('gridview', () => {
     });
 
     test('#8/VERTICAL layout after', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -1321,11 +1444,17 @@ describe('gridview', () => {
     });
 
     test('#9/HORIZONTAL', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -1446,11 +1575,17 @@ describe('gridview', () => {
     });
 
     test('#9/HORIZONTAL/proportional/false', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(800, 400);
@@ -1571,11 +1706,17 @@ describe('gridview', () => {
     });
 
     test('#10/HORIZONTAL scale x:1.5 y:2', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.fromJSON({
@@ -1699,11 +1840,17 @@ describe('gridview', () => {
     });
 
     test('panel is disposed of when component is disposed', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(1000, 1000);
@@ -1730,11 +1877,17 @@ describe('gridview', () => {
     });
 
     test('panel is disposed of when removed', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
         gridview.layout(1000, 1000);
 
@@ -1760,11 +1913,17 @@ describe('gridview', () => {
     });
 
     test('panel is disposed of when fromJSON is called', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: false,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
         gridview.layout(1000, 1000);
 
@@ -1799,11 +1958,17 @@ describe('gridview', () => {
     test('fromJSON  events should still fire', () => {
         jest.useFakeTimers();
 
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         let addGroup: GridviewPanel[] = [];
@@ -1922,11 +2087,17 @@ describe('gridview', () => {
     test('that fromJSON layouts are resized to the current dimensions', async () => {
         const container = document.createElement('div');
 
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(1600, 800);
@@ -2049,11 +2220,17 @@ describe('gridview', () => {
     test('that a deep HORIZONTAL layout with fromJSON dimensions identical to the current dimensions loads', async () => {
         const container = document.createElement('div');
 
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(6000, 5000);
@@ -2325,11 +2502,17 @@ describe('gridview', () => {
     test('that a deep VERTICAL layout with fromJSON dimensions identical to the current dimensions loads', async () => {
         const container = document.createElement('div');
 
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.VERTICAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         gridview.layout(5000, 6000);
@@ -2599,14 +2782,20 @@ describe('gridview', () => {
     });
 
     test('that loading a corrupt layout throws an error and leaves a clean gridview behind', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error(`unsupported panel '${options.name}'`);
+                }
+            },
         });
 
-        let el = gridview.element.querySelector('.view-container');
+        let el = gridview.element.querySelector('.dv-view-container');
         expect(el).toBeTruthy();
         expect(el!.childNodes.length).toBe(0);
 
@@ -2667,37 +2856,84 @@ describe('gridview', () => {
                 },
                 activePanel: 'panel_1',
             });
-        }).toThrow(
-            "Cannot create 'panel_1', no component 'somethingBad' provided"
-        );
+        }).toThrow("unsupported panel 'somethingBad'");
 
         expect(gridview.groups.length).toBe(0);
 
-        el = gridview.element.querySelector('.view-container');
+        el = gridview.element.querySelector('.dv-view-container');
         expect(el).toBeTruthy();
         expect(el!.childNodes.length).toBe(0);
     });
 
     test('that disableAutoResizing is false by default', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
         });
 
         expect(gridview.disableResizing).toBeFalsy();
     });
 
     test('that disableAutoResizing can be enabled', () => {
-        const gridview = new GridviewComponent({
-            parentElement: container,
+        const gridview = new GridviewComponent(container, {
             proportionalLayout: true,
             orientation: Orientation.HORIZONTAL,
-            components: { default: TestGridview },
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
             disableAutoResizing: true,
         });
 
         expect(gridview.disableResizing).toBeTruthy();
     });
+
+    test('that setVisible toggles visiblity', () => {
+        const gridview = new GridviewComponent(container, {
+            proportionalLayout: true,
+            orientation: Orientation.HORIZONTAL,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestGridview(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+            disableAutoResizing: true,
+        });
+        gridview.layout(1000, 1000);
+
+        const panel1 = gridview.addPanel({
+            id: 'panel1',
+            component: 'default',
+        });
+        const panel2 = gridview.addPanel({
+            id: 'panel2',
+            component: 'default',
+        });
+
+        expect(panel1.api.isVisible).toBeTruthy();
+        expect(panel2.api.isVisible).toBeTruthy();
+
+        panel1.api.setVisible(false);
+        expect(panel1.api.isVisible).toBeFalsy();
+        expect(panel2.api.isVisible).toBeTruthy();
+
+        panel1.api.setVisible(true);
+        expect(panel1.api.isVisible).toBeTruthy();
+        expect(panel2.api.isVisible).toBeTruthy();
+    });
 });

packages/dockview-core/src/__tests__/gridview/gridviewPanel.spec.ts

@@ -8,6 +8,7 @@ describe('gridviewPanel', () => {
                 onDidAddPanel: jest.fn(),
                 onDidRemovePanel: jest.fn(),
                 options: {},
+                onDidOptionsChange: jest.fn(),
             } as any;
         });
 

packages/dockview-core/src/__tests__/math.spec.ts

@@ -8,10 +8,8 @@ describe('math', () => {
             expect(clamp(55, 40, 50)).toBe(50);
         });
 
-        it('should throw an error if min > max', () => {
-            expect(() => clamp(55, 50, 40)).toThrow(
-                '50 > 40 is an invalid condition'
-            );
+        it('if min > max return min', () => {
+            expect(clamp(55, 50, 40)).toBe(50);
         });
     });
 

packages/dockview-core/src/__tests__/overlay/overlay.spec.ts

@@ -0,0 +1,418 @@
+import { Overlay } from '../../overlay/overlay';
+import { mockGetBoundingClientRect } from '../__test_utils__/utils';
+
+describe('overlay', () => {
+    test('toJSON, top left', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        document.body.appendChild(container);
+        container.appendChild(content);
+
+        const cut = new Overlay({
+            height: 200,
+            width: 100,
+            left: 10,
+            top: 20,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        jest.spyOn(
+            container.childNodes.item(0) as HTMLElement,
+            'getBoundingClientRect'
+        ).mockImplementation(() => {
+            return mockGetBoundingClientRect({
+                left: 80,
+                top: 100,
+                width: 40,
+                height: 50,
+            });
+        });
+        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
+            () => {
+                return mockGetBoundingClientRect({
+                    left: 20,
+                    top: 30,
+                    width: 100,
+                    height: 100,
+                });
+            }
+        );
+
+        cut.setBounds();
+
+        expect(cut.toJSON()).toEqual({
+            top: 70,
+            left: 60,
+            width: 40,
+            height: 50,
+        });
+
+        cut.dispose();
+    });
+
+    test('toJSON, bottom right', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        document.body.appendChild(container);
+        container.appendChild(content);
+
+        const cut = new Overlay({
+            height: 200,
+            width: 100,
+            right: 10,
+            bottom: 20,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        jest.spyOn(
+            container.childNodes.item(0) as HTMLElement,
+            'getBoundingClientRect'
+        ).mockImplementation(() => {
+            return mockGetBoundingClientRect({
+                left: 80,
+                top: 100,
+                width: 40,
+                height: 50,
+            });
+        });
+        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
+            () => {
+                return mockGetBoundingClientRect({
+                    left: 20,
+                    top: 30,
+                    width: 100,
+                    height: 100,
+                });
+            }
+        );
+
+        cut.setBounds();
+
+        expect(cut.toJSON()).toEqual({
+            bottom: -20,
+            right: 0,
+            width: 40,
+            height: 50,
+        });
+
+        cut.dispose();
+    });
+
+    test('that out-of-bounds dimensions are fixed, top left', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        document.body.appendChild(container);
+        container.appendChild(content);
+
+        const cut = new Overlay({
+            height: 200,
+            width: 100,
+            left: -1000,
+            top: -1000,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        jest.spyOn(
+            container.childNodes.item(0) as HTMLElement,
+            'getBoundingClientRect'
+        ).mockImplementation(() => {
+            return mockGetBoundingClientRect({
+                left: 80,
+                top: 100,
+                width: 40,
+                height: 50,
+            });
+        });
+        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
+            () => {
+                return mockGetBoundingClientRect({
+                    left: 20,
+                    top: 30,
+                    width: 100,
+                    height: 100,
+                });
+            }
+        );
+
+        cut.setBounds();
+
+        expect(cut.toJSON()).toEqual({
+            top: 70,
+            left: 60,
+            width: 40,
+            height: 50,
+        });
+
+        cut.dispose();
+    });
+
+    test('that out-of-bounds dimensions are fixed, bottom right', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        document.body.appendChild(container);
+        container.appendChild(content);
+
+        const cut = new Overlay({
+            height: 200,
+            width: 100,
+            bottom: -1000,
+            right: -1000,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        jest.spyOn(
+            container.childNodes.item(0) as HTMLElement,
+            'getBoundingClientRect'
+        ).mockImplementation(() => {
+            return mockGetBoundingClientRect({
+                left: 80,
+                top: 100,
+                width: 40,
+                height: 50,
+            });
+        });
+        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
+            () => {
+                return mockGetBoundingClientRect({
+                    left: 20,
+                    top: 30,
+                    width: 100,
+                    height: 100,
+                });
+            }
+        );
+
+        cut.setBounds();
+
+        expect(cut.toJSON()).toEqual({
+            bottom: -20,
+            right: 0,
+            width: 40,
+            height: 50,
+        });
+
+        cut.dispose();
+    });
+
+    test('setBounds, top left', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        document.body.appendChild(container);
+        container.appendChild(content);
+
+        const cut = new Overlay({
+            height: 1000,
+            width: 1000,
+            left: 0,
+            top: 0,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        const element: HTMLElement = container.querySelector(
+            '.dv-resize-container'
+        )!;
+        expect(element).toBeTruthy();
+
+        jest.spyOn(element, 'getBoundingClientRect').mockImplementation(() => {
+            return mockGetBoundingClientRect({
+                left: 300,
+                top: 400,
+                width: 200,
+                height: 100,
+            });
+        });
+        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
+            () => {
+                return mockGetBoundingClientRect({
+                    left: 0,
+                    top: 0,
+                    width: 1000,
+                    height: 1000,
+                });
+            }
+        );
+
+        cut.setBounds({ height: 100, width: 200, left: 300, top: 400 });
+
+        expect(element.style.height).toBe('100px');
+        expect(element.style.width).toBe('200px');
+        expect(element.style.left).toBe('300px');
+        expect(element.style.top).toBe('400px');
+
+        cut.dispose();
+    });
+
+    test('setBounds, bottom right', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        document.body.appendChild(container);
+        container.appendChild(content);
+
+        const cut = new Overlay({
+            height: 1000,
+            width: 1000,
+            right: 0,
+            bottom: 0,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        const element: HTMLElement = container.querySelector(
+            '.dv-resize-container'
+        )!;
+        expect(element).toBeTruthy();
+
+        jest.spyOn(element, 'getBoundingClientRect').mockImplementation(() => {
+            return mockGetBoundingClientRect({
+                left: 500,
+                top: 500,
+                width: 200,
+                height: 100,
+            });
+        });
+        jest.spyOn(container, 'getBoundingClientRect').mockImplementation(
+            () => {
+                return mockGetBoundingClientRect({
+                    left: 0,
+                    top: 0,
+                    width: 1000,
+                    height: 1000,
+                });
+            }
+        );
+
+        cut.setBounds({ height: 100, width: 200, right: 300, bottom: 400 });
+
+        expect(element.style.height).toBe('100px');
+        expect(element.style.width).toBe('200px');
+        expect(element.style.right).toBe('300px');
+        expect(element.style.bottom).toBe('400px');
+
+        cut.dispose();
+    });
+
+    test('that the resize handles are added', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        const cut = new Overlay({
+            height: 500,
+            width: 500,
+            left: 100,
+            top: 200,
+            minimumInViewportWidth: 0,
+            minimumInViewportHeight: 0,
+            container,
+            content,
+        });
+
+        expect(container.querySelector('.dv-resize-handle-top')).toBeTruthy();
+        expect(
+            container.querySelector('.dv-resize-handle-bottom')
+        ).toBeTruthy();
+        expect(container.querySelector('.dv-resize-handle-left')).toBeTruthy();
+        expect(container.querySelector('.dv-resize-handle-right')).toBeTruthy();
+        expect(
+            container.querySelector('.dv-resize-handle-topleft')
+        ).toBeTruthy();
+        expect(
+            container.querySelector('.dv-resize-handle-topright')
+        ).toBeTruthy();
+        expect(
+            container.querySelector('.dv-resize-handle-bottomleft')
+        ).toBeTruthy();
+        expect(
+            container.querySelector('.dv-resize-handle-bottomright')
+        ).toBeTruthy();
+
+        cut.dispose();
+    });
+
+    test('aria-level attributes and corresponding z-index', () => {
+        const container = document.createElement('div');
+        const content = document.createElement('div');
+
+        const createOverlay = () =>
+            new Overlay({
+                height: 500,
+                width: 500,
+                left: 100,
+                top: 200,
+                minimumInViewportWidth: 0,
+                minimumInViewportHeight: 0,
+                container,
+                content,
+            });
+
+        const overlay1 = createOverlay();
+
+        const zIndexValue = (delta: number) =>
+            `calc(var(--dv-overlay-z-index, 999) + ${delta})`;
+
+        expect(overlay1.element.getAttribute('aria-level')).toBe('0');
+        expect(overlay1.element.style.zIndex).toBe(zIndexValue(0));
+
+        const overlay2 = createOverlay();
+        const overlay3 = createOverlay();
+
+        expect(overlay1.element.getAttribute('aria-level')).toBe('0');
+        expect(overlay2.element.getAttribute('aria-level')).toBe('1');
+        expect(overlay3.element.getAttribute('aria-level')).toBe('2');
+        expect(overlay1.element.style.zIndex).toBe(zIndexValue(0));
+        expect(overlay2.element.style.zIndex).toBe(zIndexValue(2));
+        expect(overlay3.element.style.zIndex).toBe(zIndexValue(4));
+
+        overlay2.bringToFront();
+
+        expect(overlay1.element.getAttribute('aria-level')).toBe('0');
+        expect(overlay2.element.getAttribute('aria-level')).toBe('2');
+        expect(overlay3.element.getAttribute('aria-level')).toBe('1');
+        expect(overlay1.element.style.zIndex).toBe(zIndexValue(0));
+        expect(overlay2.element.style.zIndex).toBe(zIndexValue(4));
+        expect(overlay3.element.style.zIndex).toBe(zIndexValue(2));
+
+        overlay1.bringToFront();
+
+        expect(overlay1.element.getAttribute('aria-level')).toBe('2');
+        expect(overlay2.element.getAttribute('aria-level')).toBe('1');
+        expect(overlay3.element.getAttribute('aria-level')).toBe('0');
+        expect(overlay1.element.style.zIndex).toBe(zIndexValue(4));
+        expect(overlay2.element.style.zIndex).toBe(zIndexValue(2));
+        expect(overlay3.element.style.zIndex).toBe(zIndexValue(0));
+
+        overlay2.dispose();
+
+        expect(overlay1.element.getAttribute('aria-level')).toBe('1');
+        expect(overlay3.element.getAttribute('aria-level')).toBe('0');
+        expect(overlay1.element.style.zIndex).toBe(zIndexValue(2));
+        expect(overlay3.element.style.zIndex).toBe(zIndexValue(0));
+
+        overlay1.dispose();
+
+        expect(overlay3.element.getAttribute('aria-level')).toBe('0');
+        expect(overlay3.element.style.zIndex).toBe(zIndexValue(0));
+    });
+});

packages/dockview-core/src/__tests__/overlay/overlayRenderContainer.spec.ts

@@ -1,14 +1,18 @@
-import { Droptarget } from '../dnd/droptarget';
-import { IDockviewPanel } from '../dockview/dockviewPanel';
-import { Emitter } from '../events';
-import { IRenderable, OverlayRenderContainer } from '../overlayRenderContainer';
+import { Droptarget } from '../../dnd/droptarget';
+import { IDockviewPanel } from '../../dockview/dockviewPanel';
+import { Emitter } from '../../events';
+import {
+    IRenderable,
+    OverlayRenderContainer,
+} from '../../overlay/overlayRenderContainer';
 import { fromPartial } from '@total-typescript/shoehorn';
-import { Writable, exhaustMicrotaskQueue } from './__test_utils__/utils';
+import { Writable, exhaustMicrotaskQueue } from '../__test_utils__/utils';
+import { DockviewComponent } from '../../dockview/dockviewComponent';
+import { DockviewGroupPanel } from '../../dockview/dockviewGroupPanel';
 
 describe('overlayRenderContainer', () => {
     let referenceContainer: IRenderable;
     let parentContainer: HTMLElement;
-    let cut: OverlayRenderContainer;
 
     beforeEach(() => {
         parentContainer = document.createElement('div');
@@ -17,22 +21,28 @@ describe('overlayRenderContainer', () => {
             element: document.createElement('div'),
             dropTarget: fromPartial<Droptarget>({}),
         };
-
-        cut = new OverlayRenderContainer(parentContainer);
     });
 
     test('that attach(...) and detach(...) mutate the DOM as expected', () => {
+        const cut = new OverlayRenderContainer(
+            parentContainer,
+            fromPartial<DockviewComponent>({})
+        );
+
         const panelContentEl = document.createElement('div');
 
         const onDidVisibilityChange = new Emitter<any>();
         const onDidDimensionsChange = new Emitter<any>();
+        const onDidLocationChange = new Emitter<any>();
 
         const panel = fromPartial<IDockviewPanel>({
             api: {
                 id: 'test_panel_id',
                 onDidVisibilityChange: onDidVisibilityChange.event,
                 onDidDimensionsChange: onDidDimensionsChange.event,
+                onDidLocationChange: onDidLocationChange.event,
                 isVisible: true,
+                location: { type: 'grid' },
             },
             view: {
                 content: {
@@ -41,7 +51,7 @@ describe('overlayRenderContainer', () => {
             },
             group: {
                 api: {
-                    location: 'grid',
+                    location: { type: 'grid' },
                 },
             },
         });
@@ -58,17 +68,25 @@ describe('overlayRenderContainer', () => {
     });
 
     test('add a view that is not currently in the DOM', async () => {
+        const cut = new OverlayRenderContainer(
+            parentContainer,
+            fromPartial<DockviewComponent>({})
+        );
+
         const panelContentEl = document.createElement('div');
 
         const onDidVisibilityChange = new Emitter<any>();
         const onDidDimensionsChange = new Emitter<any>();
+        const onDidLocationChange = new Emitter<any>();
 
         const panel = fromPartial<IDockviewPanel>({
             api: {
                 id: 'test_panel_id',
                 onDidVisibilityChange: onDidVisibilityChange.event,
                 onDidDimensionsChange: onDidDimensionsChange.event,
+                onDidLocationChange: onDidLocationChange.event,
                 isVisible: true,
+                location: { type: 'grid' },
             },
             view: {
                 content: {
@@ -77,7 +95,7 @@ describe('overlayRenderContainer', () => {
             },
             group: {
                 api: {
-                    location: 'grid',
+                    location: { type: 'grid' },
                 },
             },
         });
@@ -186,4 +204,62 @@ describe('overlayRenderContainer', () => {
             referenceContainer.element.getBoundingClientRect
         ).toHaveBeenCalledTimes(3);
     });
+
+    test('related z-index from `aria-level` set on floating panels', async () => {
+        const group = fromPartial<DockviewGroupPanel>({});
+
+        const element = document.createElement('div');
+        element.setAttribute('aria-level', '2');
+        const spy = jest.spyOn(element, 'getAttribute');
+
+        const accessor = fromPartial<DockviewComponent>({
+            floatingGroups: [
+                {
+                    group,
+                    overlay: {
+                        element,
+                    },
+                },
+            ],
+        });
+
+        const cut = new OverlayRenderContainer(parentContainer, accessor);
+
+        const panelContentEl = document.createElement('div');
+
+        const onDidVisibilityChange = new Emitter<any>();
+        const onDidDimensionsChange = new Emitter<any>();
+        const onDidLocationChange = new Emitter<any>();
+
+        const panel = fromPartial<IDockviewPanel>({
+            api: {
+                id: 'test_panel_id',
+                onDidVisibilityChange: onDidVisibilityChange.event,
+                onDidDimensionsChange: onDidDimensionsChange.event,
+                onDidLocationChange: onDidLocationChange.event,
+                isVisible: true,
+                group,
+                location: { type: 'floating' },
+            },
+            view: {
+                content: {
+                    element: panelContentEl,
+                },
+            },
+            group: {
+                api: {
+                    location: { type: 'floating' },
+                },
+            },
+        });
+
+        cut.attach({ panel, referenceContainer });
+
+        await exhaustMicrotaskQueue();
+
+        expect(spy).toHaveBeenCalledWith('aria-level');
+        expect(panelContentEl.parentElement!.style.zIndex).toBe(
+            'calc(var(--dv-overlay-z-index, 999) + 5)'
+        );
+    });
 });

packages/dockview-core/src/__tests__/panel/componentFactory.spec.ts

@@ -1,102 +0,0 @@
-import { createComponent } from '../../panel/componentFactory';
-
-describe('componentFactory', () => {
-    describe('createComponent', () => {
-        test('valid component and framework component', () => {
-            const mock = jest.fn();
-            const mock2 = jest.fn();
-
-            expect(() =>
-                createComponent(
-                    'id-1',
-                    'component-1',
-                    { 'component-1': mock },
-                    { 'component-1': mock2 }
-                )
-            ).toThrow(
-                "Cannot create 'id-1'. component 'component-1' registered as both a component and frameworkComponent"
-            );
-        });
-
-        test('valid framework component but no factory', () => {
-            const mock = jest.fn();
-
-            expect(() =>
-                createComponent(
-                    'id-1',
-                    'component-1',
-                    {},
-                    { 'component-1': mock }
-                )
-            ).toThrow(
-                "Cannot create 'id-1' for framework component 'component-1'. you must register a frameworkPanelWrapper to use framework components"
-            );
-        });
-
-        test('valid framework component', () => {
-            const component = jest.fn();
-            const createComponentFn = jest
-                .fn()
-                .mockImplementation(() => component);
-            const frameworkComponent = jest.fn();
-
-            expect(
-                createComponent(
-                    'id-1',
-                    'component-1',
-                    {},
-                    { 'component-1': frameworkComponent },
-                    {
-                        createComponent: createComponentFn,
-                    }
-                )
-            ).toBe(component);
-
-            expect(createComponentFn).toHaveBeenCalledWith(
-                'id-1',
-                'component-1',
-                frameworkComponent
-            );
-        });
-
-        test('no valid component with fallback', () => {
-            const mock = jest.fn();
-
-            expect(
-                createComponent(
-                    'id-1',
-                    'component-1',
-                    {},
-                    {},
-                    {
-                        createComponent: () => null,
-                    },
-                    () => mock
-                )
-            ).toBe(mock);
-        });
-
-        test('no valid component', () => {
-            expect(() =>
-                createComponent('id-1', 'component-1', {}, {})
-            ).toThrow(
-                "Cannot create 'id-1', no component 'component-1' provided"
-            );
-        });
-
-        test('valid component', () => {
-            const component = jest.fn();
-
-            const componentResult = createComponent(
-                'id-1',
-                'component-1',
-                { 'component-1': component },
-                {}
-            );
-
-            expect(component).toHaveBeenCalled();
-
-            expect(componentResult instanceof component).toBeTruthy();
-        });
-    });
-});

packages/dockview-core/src/__tests__/paneview/paneview.spec.ts

@@ -1,14 +1,10 @@
 import { CompositeDisposable } from '../../lifecycle';
 import { Paneview } from '../../paneview/paneview';
-import {
-    IPaneBodyPart,
-    IPaneHeaderPart,
-    PaneviewPanel,
-} from '../../paneview/paneviewPanel';
+import { IPanePart, PaneviewPanel } from '../../paneview/paneviewPanel';
 import { Orientation } from '../../splitview/splitview';
 
 class TestPanel extends PaneviewPanel {
-    protected getBodyComponent(): IPaneBodyPart {
+    protected getBodyComponent(): IPanePart {
         return {
             element: document.createElement('div'),
             update: () => {
@@ -23,7 +19,7 @@ class TestPanel extends PaneviewPanel {
         };
     }
 
-    protected getHeaderComponent(): IPaneHeaderPart {
+    protected getHeaderComponent(): IPanePart {
         return {
             element: document.createElement('div'),
             update: () => {
@@ -60,22 +56,28 @@ describe('paneview', () => {
             paneview.onDidRemoveView((view) => removed.push(view))
         );
 
-        const view1 = new TestPanel(
-            'id',
-            'component',
-            'headerComponent',
-            Orientation.VERTICAL,
-            true,
-            true
-        );
-        const view2 = new TestPanel(
-            'id2',
-            'component',
-            'headerComponent',
-            Orientation.VERTICAL,
-            true,
-            true
-        );
+        const view1 = new TestPanel({
+            id: 'id',
+            component: 'component',
+            headerComponent: 'headerComponent',
+            orientation: Orientation.VERTICAL,
+            isExpanded: true,
+            isHeaderVisible: true,
+            headerSize: 22,
+            minimumBodySize: 0,
+            maximumBodySize: Number.MAX_SAFE_INTEGER,
+        });
+        const view2 = new TestPanel({
+            id: 'id2',
+            component: 'component',
+            headerComponent: 'headerComponent',
+            orientation: Orientation.VERTICAL,
+            isExpanded: true,
+            isHeaderVisible: true,
+            headerSize: 22,
+            minimumBodySize: 0,
+            maximumBodySize: Number.MAX_SAFE_INTEGER,
+        });
 
         expect(added.length).toBe(0);
         expect(removed.length).toBe(0);
@@ -110,22 +112,28 @@ describe('paneview', () => {
             orientation: Orientation.HORIZONTAL,
         });
 
-        const view1 = new TestPanel(
-            'id',
-            'component',
-            'headerComponent',
-            Orientation.VERTICAL,
-            true,
-            true
-        );
-        const view2 = new TestPanel(
-            'id2',
-            'component',
-            'headerComponent',
-            Orientation.VERTICAL,
-            true,
-            true
-        );
+        const view1 = new TestPanel({
+            id: 'id',
+            component: 'component',
+            headerComponent: 'headerComponent',
+            orientation: Orientation.VERTICAL,
+            isExpanded: true,
+            isHeaderVisible: true,
+            headerSize: 22,
+            minimumBodySize: 0,
+            maximumBodySize: Number.MAX_SAFE_INTEGER,
+        });
+        const view2 = new TestPanel({
+            id: 'id2',
+            component: 'component',
+            headerComponent: 'headerComponent',
+            orientation: Orientation.VERTICAL,
+            isExpanded: true,
+            isHeaderVisible: true,
+            headerSize: 22,
+            minimumBodySize: 0,
+            maximumBodySize: Number.MAX_SAFE_INTEGER,
+        });
 
         paneview.addPane(view1);
         paneview.addPane(view2);

packages/dockview-core/src/__tests__/paneview/paneviewComponent.spec.ts

@@ -4,19 +4,28 @@ import { PanelUpdateEvent } from '../../panel/types';
 import { PaneviewComponent } from '../../paneview/paneviewComponent';
 import {
     PaneviewPanel,
-    IPaneBodyPart,
-    IPaneHeaderPart,
+    IPanePart,
     PanePanelComponentInitParameter,
 } from '../../paneview/paneviewPanel';
 import { Orientation } from '../../splitview/splitview';
 
 class TestPanel extends PaneviewPanel {
     constructor(id: string, component: string) {
-        super(id, component, 'header', Orientation.VERTICAL, false, true);
+        super({
+            id,
+            component,
+            headerComponent: 'header',
+            orientation: Orientation.VERTICAL,
+            isExpanded: false,
+            isHeaderVisible: true,
+            headerSize: 22,
+            minimumBodySize: 0,
+            maximumBodySize: Number.MAX_SAFE_INTEGER,
+        });
     }
 
     getHeaderComponent() {
-        return new (class Header implements IPaneHeaderPart {
+        return new (class Header implements IPanePart {
             private _element: HTMLElement = document.createElement('div');
 
             get element() {
@@ -38,7 +47,7 @@ class TestPanel extends PaneviewPanel {
     }
 
     getBodyComponent() {
-        return new (class Header implements IPaneBodyPart {
+        return new (class Header implements IPanePart {
             private _element: HTMLElement = document.createElement('div');
 
             get element() {
@@ -60,7 +69,7 @@ class TestPanel extends PaneviewPanel {
     }
 }
 
-describe('componentPaneview', () => {
+describe('paneviewComponent', () => {
     let container: HTMLElement;
 
     beforeEach(() => {
@@ -68,26 +77,52 @@ describe('componentPaneview', () => {
         container.className = 'container';
     });
 
-    test('vertical panels', () => {
-        const disposables = new CompositeDisposable();
+    test('that the container is not removed when grid is disposed', () => {
+        const root = document.createElement('div');
+        const container = document.createElement('div');
+        root.appendChild(container);
 
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
-        paneview.layout(600, 400);
+        paneview.dispose();
+
+        expect(container.parentElement).toBe(root);
+        expect(container.children.length).toBe(0);
+    });
+
+    test('vertical panels', () => {
+        const disposables = new CompositeDisposable();
+
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+        });
+
+        paneview.layout(300, 200);
 
         paneview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 1',
         });
         paneview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel2',
         });
 
@@ -108,6 +143,8 @@ describe('componentPaneview', () => {
             })
         );
 
+        paneview.layout(600, 400);
+
         expect(panel1Dimensions).toEqual({ width: 600, height: 22 });
         expect(panel2Dimensions).toEqual({ width: 600, height: 22 });
 
@@ -142,13 +179,19 @@ describe('componentPaneview', () => {
     });
 
     test('serialization', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
+        expect(container.querySelectorAll('.dv-pane-container').length).toBe(1);
+
         paneview.fromJSON({
             size: 6,
             views: [
@@ -156,7 +199,7 @@ describe('componentPaneview', () => {
                     size: 1,
                     data: {
                         id: 'panel1',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 1',
                     },
                     expanded: true,
@@ -165,7 +208,7 @@ describe('componentPaneview', () => {
                     size: 2,
                     data: {
                         id: 'panel2',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 2',
                     },
                     expanded: false,
@@ -174,13 +217,15 @@ describe('componentPaneview', () => {
                     size: 3,
                     data: {
                         id: 'panel3',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 3',
                     },
                 },
             ],
         });
 
+        expect(container.querySelectorAll('.dv-pane-container').length).toBe(1);
+
         paneview.layout(400, 800);
 
         const panel1 = paneview.getPanel('panel1');
@@ -220,53 +265,57 @@ describe('componentPaneview', () => {
                     size: 756,
                     data: {
                         id: 'panel1',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 1',
                     },
                     expanded: true,
-                    minimumSize: 100,
+                    headerSize: 22,
                 },
                 {
                     size: 22,
                     data: {
                         id: 'panel2',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 2',
                     },
                     expanded: false,
-                    minimumSize: 100,
+                    headerSize: 22,
                 },
                 {
                     size: 22,
                     data: {
                         id: 'panel3',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 3',
                     },
                     expanded: false,
-                    minimumSize: 100,
+                    headerSize: 22,
                 },
             ],
         });
     });
 
     test('toJSON shouldnt fire any layout events', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         paneview.layout(1000, 1000);
 
         paneview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 1',
         });
         paneview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 2',
         });
 
@@ -280,41 +329,15 @@ describe('componentPaneview', () => {
         disposable.dispose();
     });
 
-    test('dispose of paneviewComponent', () => {
-        expect(container.childNodes.length).toBe(0);
-
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
-            },
-        });
-
-        paneview.layout(1000, 1000);
-
-        paneview.addPanel({
-            id: 'panel1',
-            component: 'testPanel',
-            title: 'Panel 1',
-        });
-        paneview.addPanel({
-            id: 'panel2',
-            component: 'testPanel',
-            title: 'Panel 2',
-        });
-
-        expect(container.childNodes.length).toBeGreaterThan(0);
-
-        paneview.dispose();
-
-        expect(container.childNodes.length).toBe(0);
-    });
-
     test('panel is disposed of when component is disposed', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -322,12 +345,12 @@ describe('componentPaneview', () => {
 
         paneview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 1',
         });
         paneview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 2',
         });
 
@@ -344,10 +367,14 @@ describe('componentPaneview', () => {
     });
 
     test('panel is disposed of when removed', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -355,12 +382,12 @@ describe('componentPaneview', () => {
 
         paneview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 1',
         });
         paneview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 2',
         });
 
@@ -377,10 +404,14 @@ describe('componentPaneview', () => {
     });
 
     test('panel is disposed of when fromJSON is called', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -388,12 +419,12 @@ describe('componentPaneview', () => {
 
         paneview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 1',
         });
         paneview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
             title: 'Panel 2',
         });
 
@@ -410,10 +441,14 @@ describe('componentPaneview', () => {
     });
 
     test('that fromJSON layouts are resized to the current dimensions', async () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -426,16 +461,17 @@ describe('componentPaneview', () => {
                     size: 1,
                     data: {
                         id: 'panel1',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 1',
                     },
+                    minimumSize: 100,
                     expanded: true,
                 },
                 {
                     size: 2,
                     data: {
                         id: 'panel2',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 2',
                     },
                     expanded: true,
@@ -444,7 +480,7 @@ describe('componentPaneview', () => {
                     size: 3,
                     data: {
                         id: 'panel3',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 3',
                     },
                     expanded: true,
@@ -460,41 +496,46 @@ describe('componentPaneview', () => {
                     size: 122,
                     data: {
                         id: 'panel1',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 1',
                     },
                     expanded: true,
                     minimumSize: 100,
+                    headerSize: 22,
                 },
                 {
-                    size: 122,
+                    size: 22,
                     data: {
                         id: 'panel2',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 2',
                     },
                     expanded: true,
-                    minimumSize: 100,
+                    headerSize: 22,
                 },
                 {
-                    size: 356,
+                    size: 456,
                     data: {
                         id: 'panel3',
-                        component: 'testPanel',
+                        component: 'default',
                         title: 'Panel 3',
                     },
                     expanded: true,
-                    minimumSize: 100,
+                    headerSize: 22,
                 },
             ],
         });
     });
 
     test('that disableAutoResizing is false by default', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -502,14 +543,77 @@ describe('componentPaneview', () => {
     });
 
     test('that disableAutoResizing can be enabled', () => {
-        const paneview = new PaneviewComponent({
-            parentElement: container,
-            components: {
-                testPanel: TestPanel,
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
             disableAutoResizing: true,
         });
 
         expect(paneview.disableResizing).toBeTruthy();
     });
+
+    test('that setVisible toggles visiblity', () => {
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+            disableAutoResizing: true,
+        });
+
+        paneview.layout(1000, 1000);
+
+        const panel1 = paneview.addPanel({
+            id: 'panel1',
+            component: 'default',
+            title: 'panel1',
+        });
+        const panel2 = paneview.addPanel({
+            id: 'panel2',
+            component: 'default',
+            title: 'panel2',
+        });
+
+        expect(panel1.api.isVisible).toBeTruthy();
+        expect(panel2.api.isVisible).toBeTruthy();
+
+        panel1.api.setVisible(false);
+        expect(panel1.api.isVisible).toBeFalsy();
+        expect(panel2.api.isVisible).toBeTruthy();
+
+        panel1.api.setVisible(true);
+        expect(panel1.api.isVisible).toBeTruthy();
+        expect(panel2.api.isVisible).toBeTruthy();
+    });
+
+    test('update className', () => {
+        const paneview = new PaneviewComponent(container, {
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+            disableAutoResizing: true,
+            className: 'test-a test-b',
+        });
+
+        expect(paneview.element.className).toBe('test-a test-b');
+
+        paneview.updateOptions({ className: 'test-b test-c' });
+
+        expect(paneview.element.className).toBe('test-b test-c');
+    });
 });

packages/dockview-core/src/__tests__/splitview/splitview.spec.ts

@@ -96,7 +96,7 @@ describe('splitview', () => {
         expect(splitview.orientation).toBe(Orientation.HORIZONTAL);
 
         const viewQuery = container.querySelectorAll(
-            '.split-view-container horizontal'
+            '.dv-split-view-container dv-horizontal'
         );
         expect(viewQuery).toBeTruthy();
 
@@ -111,7 +111,7 @@ describe('splitview', () => {
         expect(splitview.orientation).toBe(Orientation.VERTICAL);
 
         const viewQuery = container.querySelectorAll(
-            '.split-view-container vertical'
+            '.dv-split-view-container dv-vertical'
         );
         expect(viewQuery).toBeTruthy();
 
@@ -128,48 +128,48 @@ describe('splitview', () => {
         splitview.addView(new Testview(50, 50));
 
         let viewQuery = container.querySelectorAll(
-            '.split-view-container > .view-container > .view'
+            '.dv-split-view-container > .dv-view-container > .dv-view'
         );
         expect(viewQuery.length).toBe(3);
 
         let sashQuery = container.querySelectorAll(
-            '.split-view-container > .sash-container > .sash'
+            '.dv-split-view-container > .dv-sash-container > .dv-sash'
         );
         expect(sashQuery.length).toBe(2);
 
         splitview.removeView(2);
 
         viewQuery = container.querySelectorAll(
-            '.split-view-container > .view-container > .view'
+            '.dv-split-view-container > .dv-view-container > .dv-view'
         );
         expect(viewQuery.length).toBe(2);
 
         sashQuery = container.querySelectorAll(
-            '.split-view-container > .sash-container > .sash'
+            '.dv-split-view-container > .dv-sash-container > .dv-sash'
         );
         expect(sashQuery.length).toBe(1);
 
         splitview.removeView(0);
 
         viewQuery = container.querySelectorAll(
-            '.split-view-container > .view-container > .view'
+            '.dv-split-view-container > .dv-view-container > .dv-view'
         );
         expect(viewQuery.length).toBe(1);
 
         sashQuery = container.querySelectorAll(
-            '.split-view-container > .sash-container > .sash'
+            '.dv-split-view-container > .dv-sash-container > .dv-sash'
         );
         expect(sashQuery.length).toBe(0);
 
         splitview.removeView(0);
 
         viewQuery = container.querySelectorAll(
-            '.split-view-container > .view-container > .view'
+            '.dv-split-view-container > .dv-view-container > .dv-view'
         );
         expect(viewQuery.length).toBe(0);
 
         sashQuery = container.querySelectorAll(
-            '.split-view-container > .sash-container > .sash'
+            '.dv-split-view-container > .dv-sash-container > .dv-sash'
         );
         expect(sashQuery.length).toBe(0);
 
@@ -188,14 +188,14 @@ describe('splitview', () => {
         splitview.addView(view2);
 
         let viewQuery = container.querySelectorAll(
-            '.split-view-container > .view-container > .view.visible'
+            '.dv-split-view-container > .dv-view-container > .dv-view.visible'
         );
         expect(viewQuery.length).toBe(2);
 
         splitview.setViewVisible(1, false);
 
         viewQuery = container.querySelectorAll(
-            '.split-view-container > .view-container > .view.visible'
+            '.dv-split-view-container > .dv-view-container > .dv-view.visible'
         );
         expect(viewQuery.length).toBe(1);
 
@@ -619,7 +619,7 @@ describe('splitview', () => {
         );
 
         const sashElement = container
-            .getElementsByClassName('sash')
+            .getElementsByClassName('dv-sash')
             .item(0) as HTMLElement;
 
         // validate the expected state before drag
@@ -772,4 +772,130 @@ describe('splitview', () => {
         view1.fireChangeEvent({ size: 300 });
         expect([view1.size, view2.size, view3.size]).toEqual([300, 300, 300]);
     });
+
+    test('that margins are applied to view sizing', () => {
+        const splitview = new Splitview(container, {
+            orientation: Orientation.HORIZONTAL,
+            proportionalLayout: false,
+            margin: 24,
+        });
+        splitview.layout(924, 500);
+
+        const view1 = new Testview(0, 1000);
+        const view2 = new Testview(0, 1000);
+        const view3 = new Testview(0, 1000);
+        const view4 = new Testview(0, 1000);
+
+        splitview.addView(view1);
+        expect([view1.size]).toEqual([924]);
+
+        splitview.addView(view2);
+        expect([view1.size, view2.size]).toEqual([450, 450]); // 450 + 24 + 450  = 924
+
+        splitview.addView(view3);
+        expect([view1.size, view2.size, view3.size]).toEqual([292, 292, 292]); // 292 + 24 + 292 + 24 + 292 = 924
+
+        splitview.addView(view4);
+        expect([view1.size, view2.size, view3.size, view4.size]).toEqual([
+            213, 213, 213, 213,
+        ]); // 213 + 24 + 213 + 24 + 213 + 24 + 213 = 924
+
+        let viewQuery = Array.from(
+            container
+                .querySelectorAll(
+                    '.dv-split-view-container > .dv-view-container > .dv-view'
+                )
+                .entries()
+        )
+            .map(([i, e]) => e as HTMLElement)
+            .map((e) => ({
+                left: e.style.left,
+                top: e.style.top,
+                height: e.style.height,
+                width: e.style.width,
+            }));
+
+        let sashQuery = Array.from(
+            container
+                .querySelectorAll(
+                    '.dv-split-view-container > .dv-sash-container > .dv-sash'
+                )
+                .entries()
+        )
+            .map(([i, e]) => e as HTMLElement)
+            .map((e) => ({
+                left: e.style.left,
+                top: e.style.top,
+            }));
+
+        // check HTMLElement positions since these are the ones that really matter
+
+        expect(viewQuery).toEqual([
+            { left: '0px', top: '', width: '213px', height: '' },
+            // 213 + 24 = 237
+            { left: '237px', top: '', width: '213px', height: '' },
+            // 237 + 213 + 24 = 474
+            { left: '474px', top: '', width: '213px', height: '' },
+            // 474 + 213 + 24 = 474
+            { left: '711px', top: '', width: '213px', height: '' },
+            // 711 + 213 = 924
+        ]);
+
+        // 924 / 4 = 231 view size
+        // 231 - (24*3/4) = 213 margin adjusted view size
+        // 213 - 4/2 + 24/2 = 223
+        expect(sashQuery).toEqual([
+            // 213 - 4/2 + 24/2 = 223
+            { left: '223px', top: '0px' },
+            // 213 + 24 + 213 = 450
+            // 450 - 4/2 + 24/2 = 460
+            { left: '460px', top: '0px' },
+            // 213 + 24 + 213 + 24 + 213 = 687
+            // 687 - 4/2 + 24/2 = 697
+            { left: '697px', top: '0px' },
+        ]);
+
+        splitview.setViewVisible(0, false);
+
+        viewQuery = Array.from(
+            container
+                .querySelectorAll(
+                    '.dv-split-view-container > .dv-view-container > .dv-view'
+                )
+                .entries()
+        )
+            .map(([i, e]) => e as HTMLElement)
+            .map((e) => ({
+                left: e.style.left,
+                top: e.style.top,
+                height: e.style.height,
+                width: e.style.width,
+            }));
+
+        sashQuery = Array.from(
+            container
+                .querySelectorAll(
+                    '.dv-split-view-container > .dv-sash-container > .dv-sash'
+                )
+                .entries()
+        )
+            .map(([i, e]) => e as HTMLElement)
+            .map((e) => ({
+                left: e.style.left,
+                top: e.style.top,
+            }));
+
+        expect(viewQuery).toEqual([
+            { left: '0px', top: '', width: '0px', height: '' },
+            { left: '0px', top: '', width: '215px', height: '' },
+            { left: '239px', top: '', width: '215px', height: '' },
+            { left: '478px', top: '', width: '446px', height: '' },
+        ]);
+
+        expect(sashQuery).toEqual([
+            { left: '0px', top: '0px' },
+            { left: '225px', top: '0px' },
+            { left: '464px', top: '0px' },
+        ]);
+    });
 });

packages/dockview-core/src/__tests__/splitview/splitviewComponent.spec.ts

@@ -26,25 +26,52 @@ describe('componentSplitview', () => {
         container.className = 'container';
     });
 
+    test('that the container is not removed when grid is disposed', () => {
+        const root = document.createElement('div');
+        const container = document.createElement('div');
+        root.appendChild(container);
+
+        const splitview = new SplitviewComponent(container, {
+            orientation: Orientation.VERTICAL,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+        });
+
+        splitview.dispose();
+
+        expect(container.parentElement).toBe(root);
+        expect(container.children.length).toBe(0);
+    });
+
     test('event leakage', () => {
         Emitter.setLeakageMonitorEnabled(true);
 
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         splitview.layout(600, 400);
 
         const panel1 = splitview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
         });
         const panel2 = splitview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
         });
 
         splitview.movePanel(0, 1);
@@ -66,18 +93,22 @@ describe('componentSplitview', () => {
     });
 
     test('remove panel', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         splitview.layout(600, 400);
 
-        splitview.addPanel({ id: 'panel1', component: 'testPanel' });
-        splitview.addPanel({ id: 'panel2', component: 'testPanel' });
-        splitview.addPanel({ id: 'panel3', component: 'testPanel' });
+        splitview.addPanel({ id: 'panel1', component: 'default' });
+        splitview.addPanel({ id: 'panel2', component: 'default' });
+        splitview.addPanel({ id: 'panel3', component: 'default' });
 
         const panel1 = splitview.getPanel('panel1')!;
         const panel2 = splitview.getPanel('panel2')!;
@@ -102,11 +133,15 @@ describe('componentSplitview', () => {
     });
 
     test('horizontal dimensions', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         splitview.layout(600, 400);
@@ -116,11 +151,15 @@ describe('componentSplitview', () => {
     });
 
     test('vertical dimensions', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         splitview.layout(600, 400);
@@ -130,18 +169,22 @@ describe('componentSplitview', () => {
     });
 
     test('api resize', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
         splitview.layout(400, 600);
-        splitview.addPanel({ id: 'panel1', component: 'testPanel' });
-        splitview.addPanel({ id: 'panel2', component: 'testPanel' });
-        splitview.addPanel({ id: 'panel3', component: 'testPanel' });
+        splitview.addPanel({ id: 'panel1', component: 'default' });
+        splitview.addPanel({ id: 'panel2', component: 'default' });
+        splitview.addPanel({ id: 'panel3', component: 'default' });
 
         const panel1 = splitview.getPanel('panel1')!;
         const panel2 = splitview.getPanel('panel2')!;
@@ -183,16 +226,20 @@ describe('componentSplitview', () => {
     });
 
     test('api', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
         splitview.layout(600, 400);
-        splitview.addPanel({ id: 'panel1', component: 'testPanel' });
+        splitview.addPanel({ id: 'panel1', component: 'default' });
 
         const panel1 = splitview.getPanel('panel1');
 
@@ -203,7 +250,7 @@ describe('componentSplitview', () => {
         // expect(panel1?.api.isFocused).toBeFalsy();
         expect(panel1!.api.isVisible).toBeTruthy();
 
-        splitview.addPanel({ id: 'panel2', component: 'testPanel' });
+        splitview.addPanel({ id: 'panel2', component: 'default' });
 
         const panel2 = splitview.getPanel('panel2');
 
@@ -225,18 +272,22 @@ describe('componentSplitview', () => {
     test('vertical panels', () => {
         const disposables = new CompositeDisposable();
 
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
-        splitview.layout(600, 400);
+        splitview.layout(300, 200);
 
-        splitview.addPanel({ id: 'panel1', component: 'testPanel' });
-        splitview.addPanel({ id: 'panel2', component: 'testPanel' });
+        splitview.addPanel({ id: 'panel1', component: 'default' });
+        splitview.addPanel({ id: 'panel2', component: 'default' });
 
         const panel1 = splitview.getPanel('panel1') as SplitviewPanel;
         const panel2 = splitview.getPanel('panel2') as SplitviewPanel;
@@ -255,6 +306,8 @@ describe('componentSplitview', () => {
             })
         );
 
+        splitview.layout(600, 400);
+
         expect(panel1Dimensions).toEqual({ width: 600, height: 200 });
         expect(panel2Dimensions).toEqual({ width: 600, height: 200 });
 
@@ -275,18 +328,22 @@ describe('componentSplitview', () => {
     test('horizontal panels', () => {
         const disposables = new CompositeDisposable();
 
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
-        splitview.layout(600, 400);
+        splitview.layout(300, 200);
 
-        splitview.addPanel({ id: 'panel1', component: 'testPanel' });
-        splitview.addPanel({ id: 'panel2', component: 'testPanel' });
+        splitview.addPanel({ id: 'panel1', component: 'default' });
+        splitview.addPanel({ id: 'panel2', component: 'default' });
 
         const panel1 = splitview.getPanel('panel1') as SplitviewPanel;
         const panel2 = splitview.getPanel('panel2') as SplitviewPanel;
@@ -305,6 +362,8 @@ describe('componentSplitview', () => {
             })
         );
 
+        splitview.layout(600, 400);
+
         expect(panel1Dimensions).toEqual({ width: 300, height: 400 });
         expect(panel2Dimensions).toEqual({ width: 300, height: 400 });
 
@@ -323,51 +382,63 @@ describe('componentSplitview', () => {
     });
 
     test('serialization', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         splitview.layout(400, 6);
 
+        expect(
+            container.querySelectorAll('.dv-split-view-container').length
+        ).toBe(1);
+
         splitview.fromJSON({
             views: [
                 {
                     size: 1,
-                    data: { id: 'panel1', component: 'testPanel' },
+                    data: { id: 'panel1', component: 'default' },
                     snap: false,
                 },
                 {
                     size: 2,
-                    data: { id: 'panel2', component: 'testPanel' },
+                    data: { id: 'panel2', component: 'default' },
                     snap: true,
                 },
-                { size: 3, data: { id: 'panel3', component: 'testPanel' } },
+                { size: 3, data: { id: 'panel3', component: 'default' } },
             ],
             size: 6,
             orientation: Orientation.VERTICAL,
             activeView: 'panel1',
         });
 
+        expect(
+            container.querySelectorAll('.dv-split-view-container').length
+        ).toBe(1);
+
         expect(splitview.length).toBe(3);
 
         expect(JSON.parse(JSON.stringify(splitview.toJSON()))).toEqual({
             views: [
                 {
                     size: 1,
-                    data: { id: 'panel1', component: 'testPanel' },
+                    data: { id: 'panel1', component: 'default' },
                     snap: false,
                 },
                 {
                     size: 2,
-                    data: { id: 'panel2', component: 'testPanel' },
+                    data: { id: 'panel2', component: 'default' },
                     snap: true,
                 },
                 {
                     size: 3,
-                    data: { id: 'panel3', component: 'testPanel' },
+                    data: { id: 'panel3', component: 'default' },
                     snap: false,
                 },
             ],
@@ -378,11 +449,15 @@ describe('componentSplitview', () => {
     });
 
     test('toJSON shouldnt fire any layout events', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -390,11 +465,11 @@ describe('componentSplitview', () => {
 
         splitview.addPanel({
             id: 'panel1',
-            component: 'testPanel',
+            component: 'default',
         });
         splitview.addPanel({
             id: 'panel2',
-            component: 'testPanel',
+            component: 'default',
         });
 
         const disposable = splitview.onDidLayoutChange(() => {
@@ -407,41 +482,16 @@ describe('componentSplitview', () => {
         disposable.dispose();
     });
 
-    test('dispose of splitviewComponent', () => {
-        expect(container.childNodes.length).toBe(0);
-
-        const splitview = new SplitviewComponent({
-            parentElement: container,
-            orientation: Orientation.HORIZONTAL,
-            components: {
-                testPanel: TestPanel,
-            },
-        });
-
-        splitview.layout(1000, 1000);
-
-        splitview.addPanel({
-            id: 'panel1',
-            component: 'testPanel',
-        });
-        splitview.addPanel({
-            id: 'panel2',
-            component: 'testPanel',
-        });
-
-        expect(container.childNodes.length).toBeGreaterThan(0);
-
-        splitview.dispose();
-
-        expect(container.childNodes.length).toBe(0);
-    });
-
     test('panel is disposed of when component is disposed', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                default: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -469,11 +519,15 @@ describe('componentSplitview', () => {
     });
 
     test('panel is disposed of when removed', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                default: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -501,11 +555,15 @@ describe('componentSplitview', () => {
     });
 
     test('panel is disposed of when fromJSON is called', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.HORIZONTAL,
-            components: {
-                default: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -537,11 +595,15 @@ describe('componentSplitview', () => {
     });
 
     test('that fromJSON layouts are resized to the current dimensions', async () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
         splitview.layout(400, 600);
@@ -550,15 +612,15 @@ describe('componentSplitview', () => {
             views: [
                 {
                     size: 1,
-                    data: { id: 'panel1', component: 'testPanel' },
+                    data: { id: 'panel1', component: 'default' },
                     snap: false,
                 },
                 {
                     size: 2,
-                    data: { id: 'panel2', component: 'testPanel' },
+                    data: { id: 'panel2', component: 'default' },
                     snap: true,
                 },
-                { size: 3, data: { id: 'panel3', component: 'testPanel' } },
+                { size: 3, data: { id: 'panel3', component: 'default' } },
             ],
             size: 6,
             orientation: Orientation.VERTICAL,
@@ -569,17 +631,17 @@ describe('componentSplitview', () => {
             views: [
                 {
                     size: 100,
-                    data: { id: 'panel1', component: 'testPanel' },
+                    data: { id: 'panel1', component: 'default' },
                     snap: false,
                 },
                 {
                     size: 200,
-                    data: { id: 'panel2', component: 'testPanel' },
+                    data: { id: 'panel2', component: 'default' },
                     snap: true,
                 },
                 {
                     size: 300,
-                    data: { id: 'panel3', component: 'testPanel' },
+                    data: { id: 'panel3', component: 'default' },
                     snap: false,
                 },
             ],
@@ -590,11 +652,15 @@ describe('componentSplitview', () => {
     });
 
     test('that disableAutoResizing is false by default', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
         });
 
@@ -602,15 +668,76 @@ describe('componentSplitview', () => {
     });
 
     test('that disableAutoResizing can be enabled', () => {
-        const splitview = new SplitviewComponent({
-            parentElement: container,
+        const splitview = new SplitviewComponent(container, {
             orientation: Orientation.VERTICAL,
-            components: {
-                testPanel: TestPanel,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
             },
             disableAutoResizing: true,
         });
 
         expect(splitview.disableResizing).toBeTruthy();
     });
+
+    test('that setVisible toggles visiblity', () => {
+        const splitview = new SplitviewComponent(container, {
+            orientation: Orientation.HORIZONTAL,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+        });
+
+        splitview.layout(1000, 1000);
+
+        const panel1 = splitview.addPanel({
+            id: 'panel1',
+            component: 'default',
+        });
+        const panel2 = splitview.addPanel({
+            id: 'panel2',
+            component: 'default',
+        });
+
+        expect(panel1.api.isVisible).toBeTruthy();
+        expect(panel2.api.isVisible).toBeTruthy();
+
+        panel1.api.setVisible(false);
+        expect(panel1.api.isVisible).toBeFalsy();
+        expect(panel2.api.isVisible).toBeTruthy();
+
+        panel1.api.setVisible(true);
+        expect(panel1.api.isVisible).toBeTruthy();
+        expect(panel2.api.isVisible).toBeTruthy();
+    });
+
+    test('update className', () => {
+        const splitview = new SplitviewComponent(container, {
+            orientation: Orientation.HORIZONTAL,
+            createComponent: (options) => {
+                switch (options.name) {
+                    case 'default':
+                        return new TestPanel(options.id, options.name);
+                    default:
+                        throw new Error('unsupported');
+                }
+            },
+            className: 'test-a test-b',
+        });
+
+        expect(splitview.element.className).toBe('test-a test-b');
+
+        splitview.updateOptions({ className: 'test-b test-c' });
+
+        expect(splitview.element.className).toBe('test-b test-c');
+    });
 });

packages/dockview-core/src/api/component.api.ts

@@ -1,11 +1,17 @@
 import {
-    DockviewDropEvent,
+    DockviewMaximizedGroupChanged,
+    FloatingGroupOptions,
     IDockviewComponent,
+    MovePanelEvent,
+    PopoutGroupChangePositionEvent,
+    PopoutGroupChangeSizeEvent,
     SerializedDockview,
 } from '../dockview/dockviewComponent';
 import {
     AddGroupOptions,
     AddPanelOptions,
+    DockviewComponentOptions,
+    DockviewDndOverlayEvent,
     MovementOptions,
 } from '../dockview/options';
 import { Parameters } from '../panel/types';
@@ -27,7 +33,6 @@ import {
     AddSplitviewComponentOptions,
     ISplitviewComponent,
     SerializedSplitview,
-    SplitviewComponentUpdateOptions,
 } from '../splitview/splitviewComponent';
 import { IView, Orientation, Sizing } from '../splitview/splitview';
 import { ISplitviewPanel } from '../splitview/splitviewPanel';
@@ -35,14 +40,25 @@ import {
     DockviewGroupPanel,
     IDockviewGroupPanel,
 } from '../dockview/dockviewGroupPanel';
-import { Emitter, Event } from '../events';
+import { Event } from '../events';
 import { IDockviewPanel } from '../dockview/dockviewPanel';
-import { PaneviewDropEvent } from '../paneview/draggablePaneviewPanel';
+import { PaneviewDidDropEvent } from '../paneview/draggablePaneviewPanel';
 import {
     GroupDragEvent,
     TabDragEvent,
 } from '../dockview/components/titlebar/tabsContainer';
 import { Box } from '../types';
+import {
+    DockviewDidDropEvent,
+    DockviewWillDropEvent,
+    WillShowOverlayLocationEvent,
+} from '../dockview/dockviewGroupPanelModel';
+import {
+    PaneviewComponentOptions,
+    PaneviewDndOverlayEvent,
+} from '../paneview/options';
+import { SplitviewComponentOptions } from '../splitview/options';
+import { GridviewComponentOptions } from '../gridview/options';
 
 export interface CommonApi<T = any> {
     readonly height: number;
@@ -54,6 +70,7 @@ export interface CommonApi<T = any> {
     fromJSON(data: T): void;
     toJSON(): T;
     clear(): void;
+    dispose(): void;
 }
 
 export class SplitviewApi implements CommonApi<SerializedSplitview> {
@@ -136,13 +153,6 @@ export class SplitviewApi implements CommonApi<SerializedSplitview> {
 
     constructor(private readonly component: ISplitviewComponent) {}
 
-    /**
-     * Update configuratable options.
-     */
-    updateOptions(options: SplitviewComponentUpdateOptions): void {
-        this.component.updateOptions(options);
-    }
-
     /**
      * Removes an existing panel and optionally provide a `Sizing` method
      * for the subsequent resize.
@@ -206,6 +216,20 @@ export class SplitviewApi implements CommonApi<SerializedSplitview> {
     clear(): void {
         this.component.clear();
     }
+
+    /**
+     * Update configuratable options.
+     */
+    updateOptions(options: Partial<SplitviewComponentOptions>): void {
+        this.component.updateOptions(options);
+    }
+
+    /**
+     * Release resources and teardown component. Do not call when using framework versions of dockview.
+     */
+    dispose(): void {
+        this.component.dispose();
+    }
 }
 
 export class PaneviewApi implements CommonApi<SerializedPaneview> {
@@ -275,19 +299,12 @@ export class PaneviewApi implements CommonApi<SerializedPaneview> {
     /**
      * Invoked when a Drag'n'Drop event occurs that the component was unable to handle. Exposed for custom Drag'n'Drop functionality.
      */
-    get onDidDrop(): Event<PaneviewDropEvent> {
-        const emitter = new Emitter<PaneviewDropEvent>();
+    get onDidDrop(): Event<PaneviewDidDropEvent> {
+        return this.component.onDidDrop;
+    }
 
-        const disposable = this.component.onDidDrop((e) => {
-            emitter.fire({ ...e, api: this });
-        });
-
-        emitter.dispose = () => {
-            disposable.dispose();
-            emitter.dispose();
-        };
-
-        return emitter.event;
+    get onUnhandledDragOverEvent(): Event<PaneviewDndOverlayEvent> {
+        return this.component.onUnhandledDragOverEvent;
     }
 
     constructor(private readonly component: IPaneviewComponent) {}
@@ -356,6 +373,20 @@ export class PaneviewApi implements CommonApi<SerializedPaneview> {
     clear(): void {
         this.component.clear();
     }
+
+    /**
+     * Update configuratable options.
+     */
+    updateOptions(options: Partial<PaneviewComponentOptions>): void {
+        this.component.updateOptions(options);
+    }
+
+    /**
+     * Release resources and teardown component. Do not call when using framework versions of dockview.
+     */
+    dispose(): void {
+        this.component.dispose();
+    }
 }
 
 export class GridviewApi implements CommonApi<SerializedGridviewComponent> {
@@ -523,6 +554,17 @@ export class GridviewApi implements CommonApi<SerializedGridviewComponent> {
     clear(): void {
         this.component.clear();
     }
+
+    updateOptions(options: Partial<GridviewComponentOptions>) {
+        this.component.updateOptions(options);
+    }
+
+    /**
+     * Release resources and teardown component. Do not call when using framework versions of dockview.
+     */
+    dispose(): void {
+        this.component.dispose();
+    }
 }
 
 export class DockviewApi implements CommonApi<SerializedDockview> {
@@ -631,6 +673,10 @@ export class DockviewApi implements CommonApi<SerializedDockview> {
         return this.component.onDidRemovePanel;
     }
 
+    get onDidMovePanel(): Event<MovePanelEvent> {
+        return this.component.onDidMovePanel;
+    }
+
     /**
      * Invoked after a layout is deserialzied using the `fromJSON` method.
      */
@@ -648,24 +694,61 @@ export class DockviewApi implements CommonApi<SerializedDockview> {
     /**
      * Invoked when a Drag'n'Drop event occurs that the component was unable to handle. Exposed for custom Drag'n'Drop functionality.
      */
-    get onDidDrop(): Event<DockviewDropEvent> {
+    get onDidDrop(): Event<DockviewDidDropEvent> {
         return this.component.onDidDrop;
     }
 
     /**
-     * Invoked before a group is dragged. Exposed for custom Drag'n'Drop functionality.
+     * Invoked when a Drag'n'Drop event occurs but before dockview handles it giving the user an opportunity to intecept and
+     * prevent the event from occuring using the standard `preventDefault()` syntax.
+     *
+     * Preventing certain events may causes unexpected behaviours, use carefully.
+     */
+    get onWillDrop(): Event<DockviewWillDropEvent> {
+        return this.component.onWillDrop;
+    }
+
+    /**
+     * Invoked before an overlay is shown indicating a drop target.
+     *
+     * Calling `event.preventDefault()` will prevent the overlay being shown and prevent
+     * the any subsequent drop event.
+     */
+    get onWillShowOverlay(): Event<WillShowOverlayLocationEvent> {
+        return this.component.onWillShowOverlay;
+    }
+
+    /**
+     * Invoked before a group is dragged.
+     *
+     * Calling `event.nativeEvent.preventDefault()` will prevent the group drag starting.
+     *
      */
     get onWillDragGroup(): Event<GroupDragEvent> {
         return this.component.onWillDragGroup;
     }
 
     /**
-     * Invoked before a panel is dragged. Exposed for custom Drag'n'Drop functionality.
+     * Invoked before a panel is dragged.
+     *
+     * Calling `event.nativeEvent.preventDefault()` will prevent the panel drag starting.
      */
     get onWillDragPanel(): Event<TabDragEvent> {
         return this.component.onWillDragPanel;
     }
 
+    get onUnhandledDragOverEvent(): Event<DockviewDndOverlayEvent> {
+        return this.component.onUnhandledDragOverEvent;
+    }
+
+    get onDidPopoutGroupSizeChange(): Event<PopoutGroupChangeSizeEvent> {
+        return this.component.onDidPopoutGroupSizeChange;
+    }
+
+    get onDidPopoutGroupPositionChange(): Event<PopoutGroupChangePositionEvent> {
+        return this.component.onDidPopoutGroupPositionChange;
+    }
+
     /**
      * All panel objects.
      */
@@ -766,9 +849,9 @@ export class DockviewApi implements CommonApi<SerializedDockview> {
      */
     addFloatingGroup(
         item: IDockviewPanel | DockviewGroupPanel,
-        coord?: { x: number; y: number }
+        options?: FloatingGroupOptions
     ): void {
-        return this.component.addFloatingGroup(item, coord);
+        return this.component.addFloatingGroup(item, options);
     }
 
     /**
@@ -814,12 +897,12 @@ export class DockviewApi implements CommonApi<SerializedDockview> {
         return this.component.hasMaximizedGroup();
     }
 
-    exitMaxmizedGroup(): void {
+    exitMaximizedGroup(): void {
         this.component.exitMaximizedGroup();
     }
 
-    get onDidMaxmizedGroupChange(): Event<void> {
-        return this.component.onDidMaxmizedGroupChange;
+    get onDidMaximizedGroupChange(): Event<DockviewMaximizedGroupChanged> {
+        return this.component.onDidMaximizedGroupChange;
     }
 
     /**
@@ -830,8 +913,21 @@ export class DockviewApi implements CommonApi<SerializedDockview> {
         options?: {
             position?: Box;
             popoutUrl?: string;
+            onDidOpen?: (event: { id: string; window: Window }) => void;
+            onWillClose?: (event: { id: string; window: Window }) => void;
         }
-    ): void {
-        this.component.addPopoutGroup(item, options);
+    ): Promise<boolean> {
+        return this.component.addPopoutGroup(item, options);
+    }
+
+    updateOptions(options: Partial<DockviewComponentOptions>) {
+        this.component.updateOptions(options);
+    }
+
+    /**
+     * Release resources and teardown component. Do not call when using framework versions of dockview.
+     */
+    dispose(): void {
+        this.component.dispose();
     }
 }

packages/dockview-core/src/api/dockviewGroupPanelApi.ts

@@ -1,25 +1,43 @@
 import { Position, positionToDirection } from '../dnd/droptarget';
 import { DockviewComponent } from '../dockview/dockviewComponent';
 import { DockviewGroupPanel } from '../dockview/dockviewGroupPanel';
-import { DockviewGroupLocation } from '../dockview/dockviewGroupPanelModel';
+import {
+    DockviewGroupChangeEvent,
+    DockviewGroupLocation,
+} from '../dockview/dockviewGroupPanelModel';
 import { Emitter, Event } from '../events';
 import { GridviewPanelApi, GridviewPanelApiImpl } from './gridviewPanelApi';
 
+export interface DockviewGroupMoveParams {
+    group?: DockviewGroupPanel;
+    position?: Position;
+    /**
+     * The index to place the panel within a group, only applicable if the placement is within an existing group
+     */
+    index?: number;
+}
+
 export interface DockviewGroupPanelApi extends GridviewPanelApi {
     readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent>;
+    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent>;
     readonly location: DockviewGroupLocation;
-    moveTo(options: { group?: DockviewGroupPanel; position?: Position }): void;
+    /**
+     * If you require the Window object
+     */
+    getWindow(): Window;
+    moveTo(options: DockviewGroupMoveParams): void;
     maximize(): void;
     isMaximized(): boolean;
     exitMaximized(): void;
+    close(): void;
 }
 
 export interface DockviewGroupPanelFloatingChangeEvent {
     readonly location: DockviewGroupLocation;
 }
 
-// TODO find a better way to initialize and avoid needing null checks
-const NOT_INITIALIZED_MESSAGE = 'DockviewGroupPanelApiImpl not initialized';
+const NOT_INITIALIZED_MESSAGE =
+    'dockview: DockviewGroupPanelApiImpl not initialized';
 
 export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
     private _group: DockviewGroupPanel | undefined;
@@ -29,6 +47,9 @@ export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
     readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent> =
         this._onDidLocationChange.event;
 
+    readonly _onDidActivePanelChange = new Emitter<DockviewGroupChangeEvent>();
+    readonly onDidActivePanelChange = this._onDidActivePanelChange.event;
+
     get location(): DockviewGroupLocation {
         if (!this._group) {
             throw new Error(NOT_INITIALIZED_MESSAGE);
@@ -37,12 +58,28 @@ export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
     }
 
     constructor(id: string, private readonly accessor: DockviewComponent) {
-        super(id);
+        super(id, '__dockviewgroup__');
 
-        this.addDisposables(this._onDidLocationChange);
+        this.addDisposables(
+            this._onDidLocationChange,
+            this._onDidActivePanelChange
+        );
     }
 
-    moveTo(options: { group?: DockviewGroupPanel; position?: Position }): void {
+    close(): void {
+        if (!this._group) {
+            return;
+        }
+        return this.accessor.removeGroup(this._group);
+    }
+
+    getWindow(): Window {
+        return this.location.type === 'popout'
+            ? this.location.getWindow()
+            : window;
+    }
+
+    moveTo(options: DockviewGroupMoveParams): void {
         if (!this._group) {
             throw new Error(NOT_INITIALIZED_MESSAGE);
         }
@@ -51,14 +88,19 @@ export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
             options.group ??
             this.accessor.addGroup({
                 direction: positionToDirection(options.position ?? 'right'),
+                skipSetActive: true,
             });
 
-        this.accessor.moveGroupOrPanel(
-            group,
-            this._group.id,
-            undefined,
-            options.group ? options.position ?? 'center' : 'center'
-        );
+        this.accessor.moveGroupOrPanel({
+            from: { groupId: this._group.id },
+            to: {
+                group,
+                position: options.group
+                    ? options.position ?? 'center'
+                    : 'center',
+                index: options.index,
+            },
+        });
     }
 
     maximize(): void {
@@ -66,7 +108,7 @@ export class DockviewGroupPanelApiImpl extends GridviewPanelApiImpl {
             throw new Error(NOT_INITIALIZED_MESSAGE);
         }
 
-        if (this.location !== 'grid') {
+        if (this.location.type !== 'grid') {
             // only grid groups can be maximized
             return;
         }

packages/dockview-core/src/api/dockviewPanelApi.ts

@@ -1,44 +1,67 @@
 import { Emitter, Event } from '../events';
 import { GridviewPanelApiImpl, GridviewPanelApi } from './gridviewPanelApi';
 import { DockviewGroupPanel } from '../dockview/dockviewGroupPanel';
-import { MutableDisposable } from '../lifecycle';
+import { CompositeDisposable, MutableDisposable } from '../lifecycle';
 import { DockviewPanel } from '../dockview/dockviewPanel';
 import { DockviewComponent } from '../dockview/dockviewComponent';
-import { Position } from '../dnd/droptarget';
-import { DockviewPanelRenderer } from '../overlayRenderContainer';
+import { DockviewPanelRenderer } from '../overlay/overlayRenderContainer';
+import {
+    DockviewGroupMoveParams,
+    DockviewGroupPanelFloatingChangeEvent,
+} from './dockviewGroupPanelApi';
+import { DockviewGroupLocation } from '../dockview/dockviewGroupPanelModel';
 
 export interface TitleEvent {
     readonly title: string;
 }
 
 export interface RendererChangedEvent {
-    renderer: DockviewPanelRenderer;
+    readonly renderer: DockviewPanelRenderer;
 }
 
+export interface ActiveGroupEvent {
+    readonly isActive: boolean;
+}
+
+export interface GroupChangedEvent {
+    // empty
+}
+
+export type DockviewPanelMoveParams = DockviewGroupMoveParams;
+
 export interface DockviewPanelApi
     extends Omit<
         GridviewPanelApi,
         // omit properties that do not make sense here
         'setVisible' | 'onDidConstraintsChange' | 'setConstraints'
     > {
+    /**
+     * The id of the tab component renderer
+     *
+     * Undefined if no custom tab renderer is provided
+     */
+    readonly tabComponent: string | undefined;
     readonly group: DockviewGroupPanel;
     readonly isGroupActive: boolean;
     readonly renderer: DockviewPanelRenderer;
     readonly title: string | undefined;
-    readonly onDidActiveGroupChange: Event<void>;
-    readonly onDidGroupChange: Event<void>;
+    readonly onDidActiveGroupChange: Event<ActiveGroupEvent>;
+    readonly onDidGroupChange: Event<GroupChangedEvent>;
+    readonly onDidTitleChange: Event<TitleEvent>;
     readonly onDidRendererChange: Event<RendererChangedEvent>;
+    readonly location: DockviewGroupLocation;
+    readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent>;
     close(): void;
     setTitle(title: string): void;
     setRenderer(renderer: DockviewPanelRenderer): void;
-    moveTo(options: {
-        group: DockviewGroupPanel;
-        position?: Position;
-        index?: number;
-    }): void;
+    moveTo(options: DockviewPanelMoveParams): void;
     maximize(): void;
     isMaximized(): boolean;
     exitMaximized(): void;
+    /**
+     * If you require the Window object
+     */
+    getWindow(): Window;
 }
 
 export class DockviewPanelApiImpl
@@ -46,20 +69,30 @@ export class DockviewPanelApiImpl
     implements DockviewPanelApi
 {
     private _group: DockviewGroupPanel;
+    private readonly _tabComponent: string | undefined;
 
     readonly _onDidTitleChange = new Emitter<TitleEvent>();
     readonly onDidTitleChange = this._onDidTitleChange.event;
 
-    private readonly _onDidActiveGroupChange = new Emitter<void>();
+    private readonly _onDidActiveGroupChange = new Emitter<ActiveGroupEvent>();
     readonly onDidActiveGroupChange = this._onDidActiveGroupChange.event;
 
-    private readonly _onDidGroupChange = new Emitter<void>();
+    private readonly _onDidGroupChange = new Emitter<GroupChangedEvent>();
     readonly onDidGroupChange = this._onDidGroupChange.event;
 
     readonly _onDidRendererChange = new Emitter<RendererChangedEvent>();
     readonly onDidRendererChange = this._onDidRendererChange.event;
 
-    private readonly disposable = new MutableDisposable();
+    private readonly _onDidLocationChange =
+        new Emitter<DockviewGroupPanelFloatingChangeEvent>();
+    readonly onDidLocationChange: Event<DockviewGroupPanelFloatingChangeEvent> =
+        this._onDidLocationChange.event;
+
+    private readonly groupEventsDisposable = new MutableDisposable();
+
+    get location(): DockviewGroupLocation {
+        return this.group.api.location;
+    }
 
     get title(): string | undefined {
         return this.panel.title;
@@ -74,20 +107,18 @@ export class DockviewPanelApiImpl
     }
 
     set group(value: DockviewGroupPanel) {
-        const isOldGroupActive = this.isGroupActive;
+        const oldGroup = this._group;
 
-        this._group = value;
+        if (this._group !== value) {
+            this._group = value;
 
-        this._onDidGroupChange.fire();
+            this._onDidGroupChange.fire({});
 
-        if (this._group) {
-            this.disposable.value = this._group.api.onDidActiveChange(() => {
-                this._onDidActiveGroupChange.fire();
+            this.setupGroupEventListeners(oldGroup);
+
+            this._onDidLocationChange.fire({
+                location: this.group.api.location,
             });
-
-            if (this.isGroupActive !== isOldGroupActive) {
-                this._onDidActiveGroupChange.fire();
-            }
         }
     }
 
@@ -95,38 +126,51 @@ export class DockviewPanelApiImpl
         return this._group;
     }
 
+    get tabComponent(): string | undefined {
+        return this._tabComponent;
+    }
+
     constructor(
-        private panel: DockviewPanel,
+        private readonly panel: DockviewPanel,
         group: DockviewGroupPanel,
-        private readonly accessor: DockviewComponent
+        private readonly accessor: DockviewComponent,
+        component: string,
+        tabComponent?: string
     ) {
-        super(panel.id);
+        super(panel.id, component);
+
+        this._tabComponent = tabComponent;
 
         this.initialize(panel);
 
         this._group = group;
+        this.setupGroupEventListeners();
 
         this.addDisposables(
-            this.disposable,
+            this.groupEventsDisposable,
             this._onDidRendererChange,
             this._onDidTitleChange,
             this._onDidGroupChange,
-            this._onDidActiveGroupChange
+            this._onDidActiveGroupChange,
+            this._onDidLocationChange
         );
     }
 
-    moveTo(options: {
-        group: DockviewGroupPanel;
-        position?: Position;
-        index?: number;
-    }): void {
-        this.accessor.moveGroupOrPanel(
-            options.group,
-            this._group.id,
-            this.panel.id,
-            options.position ?? 'center',
-            options.index
-        );
+    getWindow(): Window {
+        return this.group.api.getWindow();
+    }
+
+    moveTo(options: DockviewPanelMoveParams): void {
+        this.accessor.moveGroupOrPanel({
+            from: { groupId: this._group.id, panelId: this.panel.id },
+            to: {
+                group: options.group ?? this._group,
+                position: options.group
+                    ? options.position ?? 'center'
+                    : 'center',
+                index: options.index,
+            },
+        });
     }
 
     setTitle(title: string): void {
@@ -152,4 +196,41 @@ export class DockviewPanelApiImpl
     exitMaximized(): void {
         this.group.api.exitMaximized();
     }
+
+    private setupGroupEventListeners(previousGroup?: DockviewGroupPanel) {
+        let _trackGroupActive = previousGroup?.isActive ?? false; // prevent duplicate events with same state
+
+        this.groupEventsDisposable.value = new CompositeDisposable(
+            this.group.api.onDidVisibilityChange((event) => {
+                const hasBecomeHidden = !event.isVisible && this.isVisible;
+                const hasBecomeVisible = event.isVisible && !this.isVisible;
+
+                const isActivePanel = this.group.model.isPanelActive(
+                    this.panel
+                );
+
+                if (hasBecomeHidden || (hasBecomeVisible && isActivePanel)) {
+                    this._onDidVisibilityChange.fire(event);
+                }
+            }),
+            this.group.api.onDidLocationChange((event) => {
+                if (this.group !== this.panel.group) {
+                    return;
+                }
+                this._onDidLocationChange.fire(event);
+            }),
+            this.group.api.onDidActiveChange(() => {
+                if (this.group !== this.panel.group) {
+                    return;
+                }
+
+                if (_trackGroupActive !== this.isGroupActive) {
+                    _trackGroupActive = this.isGroupActive;
+                    this._onDidActiveGroupChange.fire({
+                        isActive: this.isGroupActive,
+                    });
+                }
+            })
+        );
+    }
 }

packages/dockview-core/src/api/entryPoints.ts

@@ -0,0 +1,46 @@
+import {
+    DockviewApi,
+    GridviewApi,
+    PaneviewApi,
+    SplitviewApi,
+} from '../api/component.api';
+import { DockviewComponent } from '../dockview/dockviewComponent';
+import { DockviewComponentOptions } from '../dockview/options';
+import { GridviewComponent } from '../gridview/gridviewComponent';
+import { GridviewComponentOptions } from '../gridview/options';
+import { PaneviewComponentOptions } from '../paneview/options';
+import { PaneviewComponent } from '../paneview/paneviewComponent';
+import { SplitviewComponentOptions } from '../splitview/options';
+import { SplitviewComponent } from '../splitview/splitviewComponent';
+
+export function createDockview(
+    element: HTMLElement,
+    options: DockviewComponentOptions
+): DockviewApi {
+    const component = new DockviewComponent(element, options);
+    return component.api;
+}
+
+export function createSplitview(
+    element: HTMLElement,
+    options: SplitviewComponentOptions
+): SplitviewApi {
+    const component = new SplitviewComponent(element, options);
+    return new SplitviewApi(component);
+}
+
+export function createGridview(
+    element: HTMLElement,
+    options: GridviewComponentOptions
+): GridviewApi {
+    const component = new GridviewComponent(element, options);
+    return new GridviewApi(component);
+}
+
+export function createPaneview(
+    element: HTMLElement,
+    options: PaneviewComponentOptions
+): PaneviewApi {
+    const component = new PaneviewComponent(element, options);
+    return new PaneviewApi(component);
+}

packages/dockview-core/src/api/gridviewPanelApi.ts

@@ -37,17 +37,15 @@ export class GridviewPanelApiImpl
     readonly onDidConstraintsChangeInternal: Event<GridConstraintChangeEvent2> =
         this._onDidConstraintsChangeInternal.event;
 
-    readonly _onDidConstraintsChange = new Emitter<GridConstraintChangeEvent>({
-        replay: true,
-    });
+    readonly _onDidConstraintsChange = new Emitter<GridConstraintChangeEvent>();
     readonly onDidConstraintsChange: Event<GridConstraintChangeEvent> =
         this._onDidConstraintsChange.event;
 
     private readonly _onDidSizeChange = new Emitter<SizeEvent>();
     readonly onDidSizeChange: Event<SizeEvent> = this._onDidSizeChange.event;
 
-    constructor(id: string, panel?: IPanel) {
-        super(id);
+    constructor(id: string, component: string, panel?: IPanel) {
+        super(id, component);
 
         this.addDisposables(
             this._onDidConstraintsChangeInternal,

packages/dockview-core/src/api/panelApi.ts

@@ -1,4 +1,4 @@
-import { Emitter, Event } from '../events';
+import { DockviewEvent, Emitter, Event } from '../events';
 import { CompositeDisposable, MutableDisposable } from '../lifecycle';
 import { IPanel, Parameters } from '../panel/types';
 
@@ -24,9 +24,14 @@ export interface PanelApi {
     readonly onDidFocusChange: Event<FocusEvent>;
     readonly onDidVisibilityChange: Event<VisibilityEvent>;
     readonly onDidActiveChange: Event<ActiveEvent>;
-    setVisible(isVisible: boolean): void;
+    readonly onDidParametersChange: Event<Parameters>;
     setActive(): void;
+    setVisible(isVisible: boolean): void;
     updateParameters(parameters: Parameters): void;
+    /**
+     * The id of the component renderer
+     */
+    readonly component: string;
     /**
      * The id of the panel that would have been assigned when the panel was created
      */
@@ -51,6 +56,16 @@ export interface PanelApi {
      * The panel height in pixels
      */
     readonly height: number;
+
+    readonly onWillFocus: Event<WillFocusEvent>;
+
+    getParameters<T extends Parameters = Parameters>(): T;
+}
+
+export class WillFocusEvent extends DockviewEvent {
+    constructor() {
+        super();
+    }
 }
 
 /**
@@ -62,67 +77,59 @@ export class PanelApiImpl extends CompositeDisposable implements PanelApi {
     private _isVisible = true;
     private _width = 0;
     private _height = 0;
+    private _parameters: Parameters = {};
 
     private readonly panelUpdatesDisposable = new MutableDisposable();
 
-    readonly _onDidDimensionChange = new Emitter<PanelDimensionChangeEvent>({
-        replay: true,
-    });
+    readonly _onDidDimensionChange = new Emitter<PanelDimensionChangeEvent>();
     readonly onDidDimensionsChange = this._onDidDimensionChange.event;
-    //
-    readonly _onDidChangeFocus = new Emitter<FocusEvent>({
-        replay: true,
-    });
+
+    readonly _onDidChangeFocus = new Emitter<FocusEvent>();
     readonly onDidFocusChange: Event<FocusEvent> = this._onDidChangeFocus.event;
     //
-    readonly _onFocusEvent = new Emitter<void>();
-    readonly onFocusEvent: Event<void> = this._onFocusEvent.event;
+    readonly _onWillFocus = new Emitter<WillFocusEvent>();
+    readonly onWillFocus: Event<WillFocusEvent> = this._onWillFocus.event;
     //
-    readonly _onDidVisibilityChange = new Emitter<VisibilityEvent>({
-        replay: true,
-    });
+    readonly _onDidVisibilityChange = new Emitter<VisibilityEvent>();
     readonly onDidVisibilityChange: Event<VisibilityEvent> =
         this._onDidVisibilityChange.event;
-    //
 
-    readonly _onVisibilityChange = new Emitter<VisibilityEvent>();
-    readonly onVisibilityChange: Event<VisibilityEvent> =
-        this._onVisibilityChange.event;
-    //
-    readonly _onDidActiveChange = new Emitter<ActiveEvent>({
-        replay: true,
-    });
+    readonly _onWillVisibilityChange = new Emitter<VisibilityEvent>();
+    readonly onWillVisibilityChange: Event<VisibilityEvent> =
+        this._onWillVisibilityChange.event;
+
+    readonly _onDidActiveChange = new Emitter<ActiveEvent>();
     readonly onDidActiveChange: Event<ActiveEvent> =
         this._onDidActiveChange.event;
-    //
+
     readonly _onActiveChange = new Emitter<void>();
     readonly onActiveChange: Event<void> = this._onActiveChange.event;
-    //
-    readonly _onUpdateParameters = new Emitter<Parameters>();
-    readonly onUpdateParameters: Event<Parameters> =
-        this._onUpdateParameters.event;
-    //
 
-    get isFocused() {
+    readonly _onDidParametersChange = new Emitter<Parameters>();
+    readonly onDidParametersChange: Event<Parameters> =
+        this._onDidParametersChange.event;
+
+    get isFocused(): boolean {
         return this._isFocused;
     }
 
-    get isActive() {
+    get isActive(): boolean {
         return this._isActive;
     }
-    get isVisible() {
+
+    get isVisible(): boolean {
         return this._isVisible;
     }
 
-    get width() {
+    get width(): number {
         return this._width;
     }
 
-    get height() {
+    get height(): number {
         return this._height;
     }
 
-    constructor(readonly id: string) {
+    constructor(readonly id: string, readonly component: string) {
         super();
 
         this.addDisposables(
@@ -144,16 +151,22 @@ export class PanelApiImpl extends CompositeDisposable implements PanelApi {
             this._onDidChangeFocus,
             this._onDidVisibilityChange,
             this._onDidActiveChange,
-            this._onFocusEvent,
+            this._onWillFocus,
             this._onActiveChange,
-            this._onVisibilityChange,
-            this._onUpdateParameters
+            this._onWillFocus,
+            this._onWillVisibilityChange,
+            this._onDidParametersChange
         );
     }
 
+    getParameters<T extends Parameters = Parameters>(): T {
+        return this._parameters as T;
+    }
+
     public initialize(panel: IPanel): void {
-        this.panelUpdatesDisposable.value = this._onUpdateParameters.event(
+        this.panelUpdatesDisposable.value = this._onDidParametersChange.event(
             (parameters) => {
+                this._parameters = parameters;
                 panel.update({
                     params: parameters,
                 });
@@ -161,8 +174,8 @@ export class PanelApiImpl extends CompositeDisposable implements PanelApi {
         );
     }
 
-    setVisible(isVisible: boolean) {
-        this._onVisibilityChange.fire({ isVisible });
+    setVisible(isVisible: boolean): void {
+        this._onWillVisibilityChange.fire({ isVisible });
     }
 
     setActive(): void {
@@ -170,10 +183,6 @@ export class PanelApiImpl extends CompositeDisposable implements PanelApi {
     }
 
     updateParameters(parameters: Parameters): void {
-        this._onUpdateParameters.fire(parameters);
-    }
-
-    dispose() {
-        super.dispose();
+        this._onDidParametersChange.fire(parameters);
     }
 }

packages/dockview-core/src/api/paneviewPanelApi.ts

@@ -35,8 +35,8 @@ export class PaneviewPanelApiImpl
         this._pane = pane;
     }
 
-    constructor(id: string) {
-        super(id);
+    constructor(id: string, component: string) {
+        super(id, component);
 
         this.addDisposables(
             this._onDidExpansionChange,

packages/dockview-core/src/api/splitviewPanelApi.ts

@@ -45,8 +45,8 @@ export class SplitviewPanelApiImpl
         this._onDidSizeChange.event;
     //
 
-    constructor(id: string) {
-        super(id);
+    constructor(id: string, component: string) {
+        super(id, component);
 
         this.addDisposables(
             this._onDidConstraintsChangeInternal,

packages/dockview-core/src/constants.ts

@@ -1,3 +1,3 @@
 export const DEFAULT_FLOATING_GROUP_OVERFLOW_SIZE = 100;
 
-export const DEFAULT_FLOATING_GROUP_POSITION = { left: 100, top: 100 };
+export const DEFAULT_FLOATING_GROUP_POSITION = { left: 100, top: 100, width: 300, height: 300 };

packages/dockview-core/src/dnd/abstractDragHandler.ts

@@ -1,4 +1,4 @@
-import { getElementsByTagName } from '../dom';
+import { disableIframePointEvents } from '../dom';
 import { addDisposableListener, Emitter } from '../events';
 import {
     CompositeDisposable,
@@ -40,23 +40,14 @@ export abstract class DragHandler extends CompositeDisposable {
                     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);
 
@@ -76,18 +67,17 @@ export abstract class DragHandler extends CompositeDisposable {
                          * For example: in react-dnd if dataTransfer.types is not set then the dragStart event will be cancelled
                          * through .preventDefault(). Since this is applied globally to all drag events this would break dockviews
                          * dnd logic. You can see the code at
-                         * https://github.com/react-dnd/react-dnd/blob/main/packages/backend-html5/src/HTML5BackendImpl.ts#L542
+                     P    * 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', () => {
                 this.pointerEventsDisposable.dispose();
-                this.dataDisposable.dispose();
+                setTimeout(() => {
+                    this.dataDisposable.dispose(); // allow the data to be read by other handlers before disposing
+                }, 0);
             })
         );
     }

packages/dockview-core/src/dnd/dataTransfer.ts

@@ -1,4 +1,6 @@
-class TransferObject {}
+class TransferObject {
+    // intentionally empty class
+}
 
 export class PanelTransfer extends TransferObject {
     constructor(

packages/dockview-core/src/dnd/dnd.ts

@@ -13,8 +13,8 @@ export class DragAndDropObserver extends CompositeDisposable {
     private target: EventTarget | null = null;
 
     constructor(
-        private element: HTMLElement,
-        private callbacks: IDragAndDropObserverCallbacks
+        private readonly element: HTMLElement,
+        private readonly callbacks: IDragAndDropObserverCallbacks
     ) {
         super();
 

packages/dockview-core/src/dnd/dropTargetAnchorContainer.scss

@@ -0,0 +1,23 @@
+.dv-drop-target-container {
+    position: absolute;
+    z-index: 9999;
+    top: 0px;
+    left: 0px;
+    height: 100%;
+    width: 100%;
+    pointer-events: none;
+    overflow: hidden;
+    --dv-transition-duration: 300ms;
+
+    .dv-drop-target-anchor {
+        position: relative;
+        border: var(--dv-drag-over-border);
+        transition: opacity var(--dv-transition-duration) ease-in,
+            top var(--dv-transition-duration) ease-out,
+            left var(--dv-transition-duration) ease-out,
+            width var(--dv-transition-duration) ease-out,
+            height var(--dv-transition-duration) ease-out;
+        background-color: var(--dv-drag-over-background-color);
+        opacity: 1;
+    }
+}

packages/dockview-core/src/dnd/dropTargetAnchorContainer.ts

@@ -0,0 +1,102 @@
+import { CompositeDisposable, Disposable } from '../lifecycle';
+import { DropTargetTargetModel } from './droptarget';
+
+export class DropTargetAnchorContainer extends CompositeDisposable {
+    private _model:
+        | { root: HTMLElement; overlay: HTMLElement; changed: boolean }
+        | undefined;
+
+    private _outline: HTMLElement | undefined;
+
+    private _disabled = false;
+
+    get disabled(): boolean {
+        return this._disabled;
+    }
+
+    set disabled(value: boolean) {
+        if (this.disabled === value) {
+            return;
+        }
+
+        this._disabled = value;
+
+        if (value) {
+            this.model?.clear();
+        }
+    }
+
+    get model(): DropTargetTargetModel | undefined {
+        if (this.disabled) {
+            return undefined;
+        }
+
+        return {
+            clear: () => {
+                if (this._model) {
+                    this._model.root.parentElement?.removeChild(
+                        this._model.root
+                    );
+                }
+                this._model = undefined;
+            },
+            exists: () => {
+                return !!this._model;
+            },
+            getElements: (event?: DragEvent, outline?: HTMLElement) => {
+                const changed = this._outline !== outline;
+                this._outline = outline;
+
+                if (this._model) {
+                    this._model.changed = changed;
+                    return this._model;
+                }
+
+                const container = this.createContainer();
+                const anchor = this.createAnchor();
+
+                this._model = { root: container, overlay: anchor, changed };
+
+                container.appendChild(anchor);
+                this.element.appendChild(container);
+
+                if (event?.target instanceof HTMLElement) {
+                    const targetBox = event.target.getBoundingClientRect();
+                    const box = this.element.getBoundingClientRect();
+
+                    anchor.style.left = `${targetBox.left - box.left}px`;
+                    anchor.style.top = `${targetBox.top - box.top}px`;
+                }
+
+                return this._model;
+            },
+        };
+    }
+
+    constructor(readonly element: HTMLElement, options: { disabled: boolean }) {
+        super();
+
+        this._disabled = options.disabled;
+
+        this.addDisposables(
+            Disposable.from(() => {
+                this.model?.clear();
+            })
+        );
+    }
+
+    private createContainer(): HTMLElement {
+        const el = document.createElement('div');
+        el.className = 'dv-drop-target-container';
+
+        return el;
+    }
+
+    private createAnchor(): HTMLElement {
+        const el = document.createElement('div');
+        el.className = 'dv-drop-target-anchor';
+        el.style.visibility = 'hidden';
+
+        return el;
+    }
+}

packages/dockview-core/src/dnd/droptarget.scss

@@ -1,7 +1,8 @@
-.drop-target {
+.dv-drop-target {
     position: relative;
+    --dv-transition-duration: 70ms;
 
-    > .drop-target-dropzone {
+    > .dv-drop-target-dropzone {
         position: absolute;
         left: 0px;
         top: 0px;
@@ -10,32 +11,43 @@
         z-index: 1000;
         pointer-events: none;
 
-        > .drop-target-selection {
+        > .dv-drop-target-selection {
             position: relative;
             box-sizing: border-box;
             height: 100%;
             width: 100%;
+            border: var(--dv-drag-over-border);
             background-color: var(--dv-drag-over-background-color);
-            transition: top 70ms ease-out, left 70ms ease-out,
-                width 70ms ease-out, height 70ms ease-out,
-                opacity 0.15s ease-out;
+            transition: top var(--dv-transition-duration) ease-out,
+                left var(--dv-transition-duration) ease-out,
+                width var(--dv-transition-duration) ease-out,
+                height var(--dv-transition-duration) ease-out,
+                opacity var(--dv-transition-duration) ease-out;
             will-change: transform;
             pointer-events: none;
 
-            &.small-top {
-                border-top: 1px solid var(--dv-drag-over-border-color);
+            &.dv-drop-target-top {
+                &.dv-drop-target-small-vertical {
+                    border-top: 1px solid var(--dv-drag-over-border-color);
+                }
             }
 
-            &.small-bottom {
-                border-bottom: 1px solid var(--dv-drag-over-border-color);
+            &.dv-drop-target-bottom {
+                &.dv-drop-target-small-vertical {
+                    border-bottom: 1px solid var(--dv-drag-over-border-color);
+                }
             }
 
-            &.small-left {
-                border-left: 1px solid var(--dv-drag-over-border-color);
+            &.dv-drop-target-left {
+                &.dv-drop-target-small-horizontal {
+                    border-left: 1px solid var(--dv-drag-over-border-color);
+                }
             }
 
-            &.small-right {
-                border-right: 1px solid var(--dv-drag-over-border-color);
+            &.dv-drop-target-right {
+                &.dv-drop-target-small-horizontal {
+                    border-right: 1px solid var(--dv-drag-over-border-color);
+                }
             }
         }
     }

packages/dockview-core/src/dnd/droptarget.ts

@@ -1,12 +1,35 @@
 import { toggleClass } from '../dom';
-import { Emitter, Event } from '../events';
+import { DockviewEvent, Emitter, Event } from '../events';
 import { CompositeDisposable } from '../lifecycle';
 import { DragAndDropObserver } from './dnd';
 import { clamp } from '../math';
 import { Direction } from '../gridview/baseComponentGridview';
 
-function numberOrFallback(maybeNumber: any, fallback: number): number {
-    return typeof maybeNumber === 'number' ? maybeNumber : fallback;
+export interface DroptargetEvent {
+    readonly position: Position;
+    readonly nativeEvent: DragEvent;
+}
+
+export class WillShowOverlayEvent
+    extends DockviewEvent
+    implements DroptargetEvent
+{
+    get nativeEvent(): DragEvent {
+        return this.options.nativeEvent;
+    }
+
+    get position(): Position {
+        return this.options.position;
+    }
+
+    constructor(
+        private readonly options: {
+            nativeEvent: DragEvent;
+            position: Position;
+        }
+    ) {
+        super();
+    }
 }
 
 export function directionToPosition(direction: Direction): Position {
@@ -43,16 +66,54 @@ export function positionToDirection(position: Position): Direction {
     }
 }
 
-export interface DroptargetEvent {
-    readonly position: Position;
-    readonly nativeEvent: DragEvent;
-}
-
 export type Position = 'top' | 'bottom' | 'left' | 'right' | 'center';
 
-export type CanDisplayOverlay =
-    | boolean
-    | ((dragEvent: DragEvent, state: Position) => boolean);
+export type CanDisplayOverlay = (
+    dragEvent: DragEvent,
+    state: Position
+) => boolean;
+
+export type MeasuredValue = { value: number; type: 'pixels' | 'percentage' };
+
+export type DroptargetOverlayModel = {
+    size?: MeasuredValue;
+    activationSize?: MeasuredValue;
+};
+
+const DEFAULT_ACTIVATION_SIZE: MeasuredValue = {
+    value: 20,
+    type: 'percentage',
+};
+
+const DEFAULT_SIZE: MeasuredValue = {
+    value: 50,
+    type: 'percentage',
+};
+
+const SMALL_WIDTH_BOUNDARY = 100;
+const SMALL_HEIGHT_BOUNDARY = 100;
+
+export interface DropTargetTargetModel {
+    getElements(
+        event?: DragEvent,
+        outline?: HTMLElement
+    ): {
+        root: HTMLElement;
+        overlay: HTMLElement;
+        changed: boolean;
+    };
+    exists(): boolean;
+    clear(): void;
+}
+
+export interface DroptargetOptions {
+    canDisplayOverlay: CanDisplayOverlay;
+    acceptedTargetZones: Position[];
+    overlayModel?: DroptargetOverlayModel;
+    getOverrideTarget?: () => DropTargetTargetModel | undefined;
+    className?: string;
+    getOverlayOutline?: () => HTMLElement | null;
+}
 
 export class Droptarget extends CompositeDisposable {
     private targetElement: HTMLElement | undefined;
@@ -63,45 +124,65 @@ export class Droptarget extends CompositeDisposable {
     private readonly _onDrop = new Emitter<DroptargetEvent>();
     readonly onDrop: Event<DroptargetEvent> = this._onDrop.event;
 
+    private readonly _onWillShowOverlay = new Emitter<WillShowOverlayEvent>();
+    readonly onWillShowOverlay: Event<WillShowOverlayEvent> =
+        this._onWillShowOverlay.event;
+
     readonly dnd: DragAndDropObserver;
 
     private static USED_EVENT_ID = '__dockview_droptarget_event_is_used__';
 
+    private static ACTUAL_TARGET: Droptarget | undefined;
+
+    private _disabled: boolean;
+
+    get disabled(): boolean {
+        return this._disabled;
+    }
+
+    set disabled(value: boolean) {
+        this._disabled = value;
+    }
+
     get state(): Position | undefined {
         return this._state;
     }
 
     constructor(
         private readonly element: HTMLElement,
-        private readonly options: {
-            canDisplayOverlay: CanDisplayOverlay;
-            acceptedTargetZones: Position[];
-            overlayModel?: {
-                size?: { value: number; type: 'pixels' | 'percentage' };
-                activationSize?: {
-                    value: number;
-                    type: 'pixels' | 'percentage';
-                };
-            };
-        }
+        private readonly options: DroptargetOptions
     ) {
         super();
 
+        this._disabled = false;
+
         // use a set to take advantage of #<set>.has
         this._acceptedTargetZonesSet = new Set(
             this.options.acceptedTargetZones
         );
 
         this.dnd = new DragAndDropObserver(this.element, {
-            onDragEnter: () => undefined,
+            onDragEnter: () => {
+                this.options.getOverrideTarget?.()?.getElements();
+            },
             onDragOver: (e) => {
+                Droptarget.ACTUAL_TARGET = this;
+
+                const overrideTraget = this.options.getOverrideTarget?.();
+
                 if (this._acceptedTargetZonesSet.size === 0) {
+                    if (overrideTraget) {
+                        return;
+                    }
                     this.removeDropTarget();
                     return;
                 }
 
-                const width = this.element.clientWidth;
-                const height = this.element.clientHeight;
+                const target =
+                    this.options.getOverlayOutline?.() ?? this.element;
+
+                const width = target.offsetWidth;
+                const height = target.offsetHeight;
 
                 if (width === 0 || height === 0) {
                     return; // avoid div!0
@@ -110,8 +191,8 @@ export class Droptarget extends CompositeDisposable {
                 const rect = (
                     e.currentTarget as HTMLElement
                 ).getBoundingClientRect();
-                const x = e.clientX - rect.left;
-                const y = e.clientY - rect.top;
+                const x = (e.clientX ?? 0) - rect.left;
+                const y = (e.clientY ?? 0) - rect.top;
 
                 const quadrant = this.calculateQuadrant(
                     this._acceptedTargetZonesSet,
@@ -132,39 +213,85 @@ export class Droptarget extends CompositeDisposable {
                     return;
                 }
 
-                if (typeof this.options.canDisplayOverlay === 'boolean') {
-                    if (!this.options.canDisplayOverlay) {
-                        this.removeDropTarget();
+                if (!this.options.canDisplayOverlay(e, quadrant)) {
+                    if (overrideTraget) {
                         return;
                     }
-                } else if (!this.options.canDisplayOverlay(e, quadrant)) {
+                    this.removeDropTarget();
+                    return;
+                }
+
+                const willShowOverlayEvent = new WillShowOverlayEvent({
+                    nativeEvent: e,
+                    position: quadrant,
+                });
+
+                /**
+                 * Provide an opportunity to prevent the overlay appearing and in turn
+                 * any dnd behaviours
+                 */
+                this._onWillShowOverlay.fire(willShowOverlayEvent);
+
+                if (willShowOverlayEvent.defaultPrevented) {
                     this.removeDropTarget();
                     return;
                 }
 
                 this.markAsUsed(e);
 
-                if (!this.targetElement) {
+                if (overrideTraget) {
+                    //
+                } else 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.append(this.targetElement);
+                    target.classList.add('dv-drop-target');
+                    target.append(this.targetElement);
+
+                    // this.overlayElement.style.opacity = '0';
+
+                    // requestAnimationFrame(() => {
+                    //     if (this.overlayElement) {
+                    //         this.overlayElement.style.opacity = '';
+                    //     }
+                    // });
                 }
 
                 this.toggleClasses(quadrant, width, height);
 
-                this.setState(quadrant);
+                this._state = quadrant;
             },
             onDragLeave: () => {
+                const target = this.options.getOverrideTarget?.();
+
+                if (target) {
+                    return;
+                }
+
                 this.removeDropTarget();
             },
-            onDragEnd: () => {
+            onDragEnd: (e) => {
+                const target = this.options.getOverrideTarget?.();
+
+                if (target && Droptarget.ACTUAL_TARGET === this) {
+                    if (this._state) {
+                        // only stop the propagation of the event if we are dealing with it
+                        // which is only when the target has state
+                        e.stopPropagation();
+                        this._onDrop.fire({
+                            position: this._state,
+                            nativeEvent: e,
+                        });
+                    }
+                }
+
                 this.removeDropTarget();
+
+                target?.clear();
             },
             onDrop: (e) => {
                 e.preventDefault();
@@ -173,6 +300,8 @@ export class Droptarget extends CompositeDisposable {
 
                 this.removeDropTarget();
 
+                this.options.getOverrideTarget?.()?.clear();
+
                 if (state) {
                     // only stop the propagation of the event if we are dealing with it
                     // which is only when the target has state
@@ -182,13 +311,17 @@ export class Droptarget extends CompositeDisposable {
             },
         });
 
-        this.addDisposables(this._onDrop, this.dnd);
+        this.addDisposables(this._onDrop, this._onWillShowOverlay, this.dnd);
     }
 
     setTargetZones(acceptedTargetZones: Position[]): void {
         this._acceptedTargetZonesSet = new Set(acceptedTargetZones);
     }
 
+    setOverlayModel(model: DroptargetOverlayModel): void {
+        this.options.overlayModel = model;
+    }
+
     dispose(): void {
         this.removeDropTarget();
         super.dispose();
@@ -202,7 +335,7 @@ export class Droptarget extends CompositeDisposable {
     }
 
     /**
-     * Check is the event has already been used by another instance od DropTarget
+     * Check is the event has already been used by another instance of DropTarget
      */
     private isAlreadyUsed(event: DragEvent): boolean {
         const value = (event as any)[Droptarget.USED_EVENT_ID];
@@ -214,12 +347,14 @@ export class Droptarget extends CompositeDisposable {
         width: number,
         height: number
     ): void {
-        if (!this.overlayElement) {
+        const target = this.options.getOverrideTarget?.();
+
+        if (!target && !this.overlayElement) {
             return;
         }
 
-        const isSmallX = width < 100;
-        const isSmallY = height < 100;
+        const isSmallX = width < SMALL_WIDTH_BOUNDARY;
+        const isSmallY = height < SMALL_HEIGHT_BOUNDARY;
 
         const isLeft = quadrant === 'left';
         const isRight = quadrant === 'right';
@@ -231,68 +366,175 @@ export class Droptarget extends CompositeDisposable {
         const topClass = !isSmallY && isTop;
         const bottomClass = !isSmallY && isBottom;
 
-        let size = 0.5;
+        let size = 1;
 
-        if (this.options.overlayModel?.size?.type === 'percentage') {
-            size = clamp(this.options.overlayModel.size.value, 0, 100) / 100;
-        }
+        const sizeOptions = this.options.overlayModel?.size ?? DEFAULT_SIZE;
 
-        if (this.options.overlayModel?.size?.type === 'pixels') {
+        if (sizeOptions.type === 'percentage') {
+            size = clamp(sizeOptions.value, 0, 100) / 100;
+        } else {
             if (rightClass || leftClass) {
-                size =
-                    clamp(0, this.options.overlayModel.size.value, width) /
-                    width;
+                size = clamp(0, sizeOptions.value, width) / width;
             }
             if (topClass || bottomClass) {
-                size =
-                    clamp(0, this.options.overlayModel.size.value, height) /
-                    height;
+                size = clamp(0, sizeOptions.value, height) / height;
             }
         }
 
-        const translate = (1 - size) / 2;
-        const scale = size;
+        if (target) {
+            const outlineEl =
+                this.options.getOverlayOutline?.() ?? this.element;
+            const elBox = outlineEl.getBoundingClientRect();
 
-        let transform: string;
+            const ta = target.getElements(undefined, outlineEl);
+            const el = ta.root;
+            const overlay = ta.overlay;
 
+            const bigbox = el.getBoundingClientRect();
+
+            const rootTop = elBox.top - bigbox.top;
+            const rootLeft = elBox.left - bigbox.left;
+
+            const box = {
+                top: rootTop,
+                left: rootLeft,
+                width: width,
+                height: height,
+            };
+
+            if (rightClass) {
+                box.left = rootLeft + width * (1 - size);
+                box.width = width * size;
+            } else if (leftClass) {
+                box.width = width * size;
+            } else if (topClass) {
+                box.height = height * size;
+            } else if (bottomClass) {
+                box.top = rootTop + height * (1 - size);
+                box.height = height * size;
+            }
+
+            if (isSmallX && isLeft) {
+                box.width = 4;
+            }
+            if (isSmallX && isRight) {
+                box.left = rootLeft + width - 4;
+                box.width = 4;
+            }
+
+            const topPx = `${Math.round(box.top)}px`;
+            const leftPx = `${Math.round(box.left)}px`;
+            const widthPx = `${Math.round(box.width)}px`;
+            const heightPx = `${Math.round(box.height)}px`;
+
+            if (
+                overlay.style.top === topPx &&
+                overlay.style.left === leftPx &&
+                overlay.style.width === widthPx &&
+                overlay.style.height === heightPx
+            ) {
+                return;
+            }
+
+            overlay.style.top = topPx;
+            overlay.style.left = leftPx;
+            overlay.style.width = widthPx;
+            overlay.style.height = heightPx;
+            overlay.style.visibility = 'visible';
+
+            overlay.className = `dv-drop-target-anchor${
+                this.options.className ? ` ${this.options.className}` : ''
+            }`;
+
+            toggleClass(overlay, 'dv-drop-target-left', isLeft);
+            toggleClass(overlay, 'dv-drop-target-right', isRight);
+            toggleClass(overlay, 'dv-drop-target-top', isTop);
+            toggleClass(overlay, 'dv-drop-target-bottom', isBottom);
+            toggleClass(
+                overlay,
+                'dv-drop-target-center',
+                quadrant === 'center'
+            );
+
+            if (ta.changed) {
+                toggleClass(
+                    overlay,
+                    'dv-drop-target-anchor-container-changed',
+                    true
+                );
+                setTimeout(() => {
+                    toggleClass(
+                        overlay,
+                        'dv-drop-target-anchor-container-changed',
+                        false
+                    );
+                }, 10);
+            }
+
+            return;
+        }
+
+        if (!this.overlayElement) {
+            return;
+        }
+
+        const box = { top: '0px', left: '0px', width: '100%', height: '100%' };
+
+        /**
+         * You can also achieve the overlay placement using the transform CSS property
+         * to translate and scale the element however this has the undesired effect of
+         * 'skewing' the element. Comment left here for anybody that ever revisits this.
+         *
+         * @see https://developer.mozilla.org/en-US/docs/Web/CSS/transform
+         *
+         * right
+         * translateX(${100 * (1 - size) / 2}%) scaleX(${scale})
+         *
+         * left
+         * translateX(-${100 * (1 - size) / 2}%) scaleX(${scale})
+         *
+         * top
+         * translateY(-${100 * (1 - size) / 2}%) scaleY(${scale})
+         *
+         * bottom
+         * translateY(${100 * (1 - size) / 2}%) scaleY(${scale})
+         */
         if (rightClass) {
-            transform = `translateX(${100 * translate}%) scaleX(${scale})`;
+            box.left = `${100 * (1 - size)}%`;
+            box.width = `${100 * size}%`;
         } else if (leftClass) {
-            transform = `translateX(-${100 * translate}%) scaleX(${scale})`;
+            box.width = `${100 * size}%`;
         } else if (topClass) {
-            transform = `translateY(-${100 * translate}%) scaleY(${scale})`;
+            box.height = `${100 * size}%`;
         } else if (bottomClass) {
-            transform = `translateY(${100 * translate}%) scaleY(${scale})`;
-        } else {
-            transform = '';
+            box.top = `${100 * (1 - size)}%`;
+            box.height = `${100 * size}%`;
         }
 
-        this.overlayElement.style.transform = transform;
+        this.overlayElement.style.top = box.top;
+        this.overlayElement.style.left = box.left;
+        this.overlayElement.style.width = box.width;
+        this.overlayElement.style.height = box.height;
 
-        toggleClass(this.overlayElement, 'small-right', isSmallX && isRight);
-        toggleClass(this.overlayElement, 'small-left', isSmallX && isLeft);
-        toggleClass(this.overlayElement, 'small-top', isSmallY && isTop);
-        toggleClass(this.overlayElement, 'small-bottom', isSmallY && isBottom);
-    }
-
-    private setState(quadrant: Position): void {
-        switch (quadrant) {
-            case 'top':
-                this._state = 'top';
-                break;
-            case 'left':
-                this._state = 'left';
-                break;
-            case 'bottom':
-                this._state = 'bottom';
-                break;
-            case 'right':
-                this._state = 'right';
-                break;
-            case 'center':
-                this._state = 'center';
-                break;
-        }
+        toggleClass(
+            this.overlayElement,
+            'dv-drop-target-small-vertical',
+            isSmallY
+        );
+        toggleClass(
+            this.overlayElement,
+            'dv-drop-target-small-horizontal',
+            isSmallX
+        );
+        toggleClass(this.overlayElement, 'dv-drop-target-left', isLeft);
+        toggleClass(this.overlayElement, 'dv-drop-target-right', isRight);
+        toggleClass(this.overlayElement, 'dv-drop-target-top', isTop);
+        toggleClass(this.overlayElement, 'dv-drop-target-bottom', isBottom);
+        toggleClass(
+            this.overlayElement,
+            'dv-drop-target-center',
+            quadrant === 'center'
+        );
     }
 
     private calculateQuadrant(
@@ -302,14 +544,11 @@ export class Droptarget extends CompositeDisposable {
         width: number,
         height: number
     ): Position | null {
-        const isPercentage =
-            this.options.overlayModel?.activationSize === undefined ||
-            this.options.overlayModel?.activationSize?.type === 'percentage';
+        const activationSizeOptions =
+            this.options.overlayModel?.activationSize ??
+            DEFAULT_ACTIVATION_SIZE;
 
-        const value = numberOrFallback(
-            this.options?.overlayModel?.activationSize?.value,
-            20
-        );
+        const isPercentage = activationSizeOptions.type === 'percentage';
 
         if (isPercentage) {
             return calculateQuadrantAsPercentage(
@@ -318,7 +557,7 @@ export class Droptarget extends CompositeDisposable {
                 y,
                 width,
                 height,
-                value
+                activationSizeOptions.value
             );
         }
 
@@ -328,17 +567,19 @@ export class Droptarget extends CompositeDisposable {
             y,
             width,
             height,
-            value
+            activationSizeOptions.value
         );
     }
 
     private removeDropTarget(): void {
         if (this.targetElement) {
             this._state = undefined;
-            this.element.removeChild(this.targetElement);
+            this.targetElement.parentElement?.classList.remove(
+                'dv-drop-target'
+            );
+            this.targetElement.remove();
             this.targetElement = undefined;
             this.overlayElement = undefined;
-            this.element.classList.remove('drop-target');
         }
     }
 }

packages/dockview-core/src/dnd/ghost.ts

@@ -2,13 +2,17 @@ import { addClasses, removeClasses } from '../dom';
 
 export function addGhostImage(
     dataTransfer: DataTransfer,
-    ghostElement: HTMLElement
+    ghostElement: HTMLElement,
+    options?: { x?: number; y?: number }
 ): void {
     // class dockview provides to force ghost image to be drawn on a different layer and prevent weird rendering issues
     addClasses(ghostElement, 'dv-dragged');
 
+    // move the element off-screen initially otherwise it may in some cases be rendered at (0,0) momentarily
+    ghostElement.style.top = '-9999px';
+
     document.body.appendChild(ghostElement);
-    dataTransfer.setDragImage(ghostElement, 0, 0);
+    dataTransfer.setDragImage(ghostElement, options?.x ?? 0, options?.y ?? 0);
 
     setTimeout(() => {
         removeClasses(ghostElement, 'dv-dragged');

packages/dockview-core/src/dnd/groupDragHandler.ts

@@ -21,7 +21,7 @@ export class GroupDragHandler extends DragHandler {
         this.addDisposables(
             addDisposableListener(
                 element,
-                'mousedown',
+                'pointerdown',
                 (e) => {
                     if (e.shiftKey) {
                         /**
@@ -38,7 +38,7 @@ export class GroupDragHandler extends DragHandler {
     }
 
     override isCancelled(_event: DragEvent): boolean {
-        if (this.group.api.location === 'floating' && !_event.shiftKey) {
+        if (this.group.api.location.type === 'floating' && !_event.shiftKey) {
             return true;
         }
         return false;
@@ -72,9 +72,11 @@ export class GroupDragHandler extends DragHandler {
             ghostElement.style.lineHeight = '20px';
             ghostElement.style.borderRadius = '12px';
             ghostElement.style.position = 'absolute';
+            ghostElement.style.pointerEvents = 'none';
+            ghostElement.style.top = '-9999px';
             ghostElement.textContent = `Multiple Panels (${this.group.size})`;
 
-            addGhostImage(dataTransfer, ghostElement);
+            addGhostImage(dataTransfer, ghostElement, { y: -10, x: 30 });
         }
 
         return {

packages/dockview-core/src/dockview/components/panel/content.ts

@@ -10,7 +10,6 @@ import { DockviewComponent } from '../../dockviewComponent';
 import { Droptarget } from '../../../dnd/droptarget';
 import { DockviewGroupPanelModel } from '../../dockviewGroupPanelModel';
 import { getPanelData } from '../../../dnd/dataTransfer';
-import { DockviewDropTargets } from '../../types';
 
 export interface IContentContainer extends IDisposable {
     readonly dropTarget: Droptarget;
@@ -29,9 +28,9 @@ export class ContentContainer
     extends CompositeDisposable
     implements IContentContainer
 {
-    private _element: HTMLElement;
+    private readonly _element: HTMLElement;
     private panel: IDockviewPanel | undefined;
-    private disposable = new MutableDisposable();
+    private readonly disposable = new MutableDisposable();
 
     private readonly _onDidFocus = new Emitter<void>();
     readonly onDidFocus: Event<void> = this._onDidFocus.event;
@@ -51,12 +50,20 @@ export class ContentContainer
     ) {
         super();
         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);
 
+        const target = group.dropTargetContainer;
+
         this.dropTarget = new Droptarget(this.element, {
+            getOverlayOutline: () => {
+                return accessor.options.theme?.dndPanelOverlay === 'group'
+                    ? this.element.parentElement
+                    : null;
+            },
+            className: 'dv-drop-target-content',
             acceptedTargetZones: ['top', 'bottom', 'left', 'right', 'center'],
             canDisplayOverlay: (event, position) => {
                 if (
@@ -71,36 +78,18 @@ export class ContentContainer
                 if (
                     !data &&
                     event.shiftKey &&
-                    this.group.location !== 'floating'
+                    this.group.location.type !== 'floating'
                 ) {
                     return false;
                 }
 
                 if (data && data.viewId === this.accessor.id) {
-                    if (data.groupId === this.group.id) {
-                        if (position === 'center') {
-                            // don't allow to drop on self for center position
-                            return false;
-                        }
-                        if (data.panelId === null) {
-                            // don't allow group move to drop anywhere on self
-                            return false;
-                        }
-                    }
-
-                    const groupHasOnePanelAndIsActiveDragElement =
-                        this.group.panels.length === 1 &&
-                        data.groupId === this.group.id;
-
-                    return !groupHasOnePanelAndIsActiveDragElement;
+                    return true;
                 }
 
-                return this.group.canDisplayOverlay(
-                    event,
-                    position,
-                    DockviewDropTargets.Panel
-                );
+                return this.group.canDisplayOverlay(event, position, 'content');
             },
+            getOverrideTarget: target ? () => target.model : undefined,
         });
 
         this.addDisposables(this.dropTarget);
@@ -137,8 +126,8 @@ export class ContentContainer
         let container: HTMLElement;
 
         switch (panel.api.renderer) {
-            case 'onlyWhenVisibile':
-                this.accessor.overlayRenderContainer.detatch(panel);
+            case 'onlyWhenVisible':
+                this.group.renderContainer.detatch(panel);
                 if (this.panel) {
                     if (doRender) {
                         this._element.appendChild(
@@ -154,17 +143,18 @@ export class ContentContainer
                 ) {
                     this._element.removeChild(panel.view.content.element);
                 }
-                container = this.accessor.overlayRenderContainer.attach({
+                container = this.group.renderContainer.attach({
                     panel,
                     referenceContainer: this,
                 });
                 break;
+            default:
+                throw new Error(
+                    `dockview: invalid renderer type '${panel.api.renderer}'`
+                );
         }
 
         if (doRender) {
-            const _onDidFocus = panel.view.content.onDidFocus;
-            const _onDidBlur = panel.view.content.onDidBlur;
-
             const focusTracker = trackFocus(container);
             const disposable = new CompositeDisposable();
 
@@ -174,17 +164,6 @@ export class ContentContainer
                 focusTracker.onDidBlur(() => this._onDidBlur.fire())
             );
 
-            if (_onDidFocus) {
-                disposable.addDisposables(
-                    _onDidFocus(() => this._onDidFocus.fire())
-                );
-            }
-            if (_onDidBlur) {
-                disposable.addDisposables(
-                    _onDidBlur(() => this._onDidBlur.fire())
-                );
-            }
-
             this.disposable.value = disposable;
         }
     }
@@ -203,11 +182,13 @@ export class ContentContainer
 
     public closePanel(): void {
         if (this.panel) {
-            if (this.accessor.options.defaultRenderer === 'onlyWhenVisibile') {
-                this._element.removeChild(this.panel.view.content.element);
+            if (this.panel.api.renderer === 'onlyWhenVisible') {
+                this.panel.view.content.element.parentElement?.removeChild(
+                    this.panel.view.content.element
+                );
             }
-            this.panel = undefined;
         }
+        this.panel = undefined;
     }
 
     public dispose(): void {

packages/dockview-core/src/dockview/components/popupService.ts

@@ -0,0 +1,87 @@
+import { shiftAbsoluteElementIntoView } from '../../dom';
+import { addDisposableListener } from '../../events';
+import {
+    CompositeDisposable,
+    Disposable,
+    MutableDisposable,
+} from '../../lifecycle';
+
+export class PopupService extends CompositeDisposable {
+    private readonly _element: HTMLElement;
+    private _active: HTMLElement | null = null;
+    private readonly _activeDisposable = new MutableDisposable();
+
+    constructor(private readonly root: HTMLElement) {
+        super();
+
+        this._element = document.createElement('div');
+        this._element.className = 'dv-popover-anchor';
+        this._element.style.position = 'relative';
+
+        this.root.prepend(this._element);
+
+        this.addDisposables(
+            Disposable.from(() => {
+                this.close();
+            }),
+            this._activeDisposable
+        );
+    }
+
+    openPopover(
+        element: HTMLElement,
+        position: { x: number; y: number; zIndex?: string }
+    ): void {
+        this.close();
+
+        const wrapper = document.createElement('div');
+        wrapper.style.position = 'absolute';
+        wrapper.style.zIndex = position.zIndex ?? 'var(--dv-overlay-z-index)';
+        wrapper.appendChild(element);
+
+        const anchorBox = this._element.getBoundingClientRect();
+        const offsetX = anchorBox.left;
+        const offsetY = anchorBox.top;
+
+        wrapper.style.top = `${position.y - offsetY}px`;
+        wrapper.style.left = `${position.x - offsetX}px`;
+
+        this._element.appendChild(wrapper);
+
+        this._active = wrapper;
+
+        this._activeDisposable.value = new CompositeDisposable(
+            addDisposableListener(window, 'pointerdown', (event) => {
+                const target = event.target;
+
+                if (!(target instanceof HTMLElement)) {
+                    return;
+                }
+
+                let el: HTMLElement | null = target;
+
+                while (el && el !== wrapper) {
+                    el = el?.parentElement ?? null;
+                }
+
+                if (el) {
+                    return; // clicked within popover
+                }
+
+                this.close();
+            })
+        );
+
+        requestAnimationFrame(() => {
+            shiftAbsoluteElementIntoView(wrapper, this.root);
+        });
+    }
+
+    close(): void {
+        if (this._active) {
+            this._active.remove();
+            this._activeDisposable.dispose();
+            this._active = null;
+        }
+    }
+}

packages/dockview-core/src/dockview/components/tab/defaultTab.scss

@@ -6,7 +6,7 @@
     ); /* forces tab to be drawn on a separate layer (see https://github.com/microsoft/vscode/issues/18733) */
 }
 
-.tab {
+.dv-tab {
     flex-shrink: 0;
 
     &:focus-within,
@@ -28,66 +28,56 @@
     }
 
     &.dv-tab-dragging {
-        .tab-action {
+        .dv-default-tab-action {
             background-color: var(--dv-activegroup-visiblepanel-tab-color);
         }
     }
 
-    &.active-tab > .default-tab {
-        .tab-action {
-            visibility: visible;
-        }
-    }
-
-    &.inactive-tab > .default-tab {
-        .tab-action {
-            visibility: hidden;
-        }
-        &:hover {
-            .tab-action {
+    &.dv-active-tab {
+        .dv-default-tab {
+            .dv-default-tab-action {
                 visibility: visible;
             }
         }
     }
 
-    .default-tab {
-        position: relative;
-        height: 100%;
-        display: flex;
-        min-width: 80px;
-        align-items: center;
-        padding: 0px 8px;
-        white-space: nowrap;
-        text-overflow: elipsis;
-
-        .tab-content {
-            padding: 0px 8px;
-            flex-grow: 1;
-        }
-
-        .action-container {
-            text-align: right;
-            display: flex;
-
-            .tab-list {
-                display: flex;
-                padding: 0px;
-                margin: 0px;
-                justify-content: flex-end;
-
-                .tab-action {
-                    padding: 4px;
-                    display: flex;
-                    align-items: center;
-                    justify-content: center;
-                    box-sizing: border-box;
-
-                    &:hover {
-                        border-radius: 2px;
-                        background-color: var(--dv-icon-hover-background-color);
-                    }
+    &.dv-inactive-tab {
+        .dv-default-tab {
+            .dv-default-tab-action {
+                visibility: hidden;
+            }
+            &:hover {
+                .dv-default-tab-action {
+                    visibility: visible;
                 }
             }
         }
     }
+
+    .dv-default-tab {
+        position: relative;
+        height: 100%;
+        display: flex;
+        align-items: center;
+        white-space: nowrap;
+        text-overflow: ellipsis;
+
+        .dv-default-tab-content {
+            flex-grow: 1;
+            margin-right: 4px;
+        }
+
+        .dv-default-tab-action {
+            padding: 4px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            box-sizing: border-box;
+
+            &:hover {
+                border-radius: 2px;
+                background-color: var(--dv-icon-hover-background-color);
+            }
+        }
+    }
 }

packages/dockview-core/src/dockview/components/tab/defaultTab.ts

@@ -1,18 +1,13 @@
 import { CompositeDisposable } from '../../../lifecycle';
 import { ITabRenderer, GroupPanelPartInitParameters } from '../../types';
 import { addDisposableListener } from '../../../events';
-import { PanelUpdateEvent } from '../../../panel/types';
-import { DockviewGroupPanel } from '../../dockviewGroupPanel';
 import { createCloseButton } from '../../../svg';
 
 export class DefaultTab extends CompositeDisposable implements ITabRenderer {
-    private _element: HTMLElement;
-    private _content: HTMLElement;
-    private _actionContainer: HTMLElement;
-    private _list: HTMLElement;
-    private action: HTMLElement;
-    //
-    private params: GroupPanelPartInitParameters = {} as any;
+    private readonly _element: HTMLElement;
+    private readonly _content: HTMLElement;
+    private readonly action: HTMLElement;
+    private _title: string | undefined;
 
     get element(): HTMLElement {
         return this._element;
@@ -22,70 +17,48 @@ export class DefaultTab extends CompositeDisposable implements ITabRenderer {
         super();
 
         this._element = document.createElement('div');
-        this._element.className = 'default-tab';
-        //
+        this._element.className = 'dv-default-tab';
+
         this._content = document.createElement('div');
-        this._content.className = 'tab-content';
-        //
-        this._actionContainer = document.createElement('div');
-        this._actionContainer.className = 'action-container';
-        //
-        this._list = document.createElement('ul');
-        this._list.className = 'tab-list';
-        //
+        this._content.className = 'dv-default-tab-content';
+
         this.action = document.createElement('div');
-        this.action.className = 'tab-action';
+        this.action.className = 'dv-default-tab-action';
         this.action.appendChild(createCloseButton());
 
-        //
         this._element.appendChild(this._content);
-        this._element.appendChild(this._actionContainer);
-        this._actionContainer.appendChild(this._list);
-        this._list.appendChild(this.action);
-        //
+        this._element.appendChild(this.action);
+
+        this.render();
+    }
+
+    init(params: GroupPanelPartInitParameters): void {
+        this._title = params.title;
+
         this.addDisposables(
-            addDisposableListener(this._actionContainer, 'mousedown', (ev) => {
+            params.api.onDidTitleChange((event) => {
+                this._title = event.title;
+                this.render();
+            }),
+            addDisposableListener(this.action, 'pointerdown', (ev) => {
                 ev.preventDefault();
+            }),
+            addDisposableListener(this.action, 'click', (ev) => {
+                if (ev.defaultPrevented) {
+                    return;
+                }
+
+                ev.preventDefault();
+                params.api.close();
             })
         );
 
         this.render();
     }
 
-    public update(event: PanelUpdateEvent): void {
-        this.params = { ...this.params, ...event.params };
-        this.render();
-    }
-
-    focus(): void {
-        //noop
-    }
-
-    public init(params: GroupPanelPartInitParameters): void {
-        this.params = params;
-        this._content.textContent = params.title;
-
-        addDisposableListener(this.action, 'click', (ev) => {
-            ev.preventDefault(); //
-            this.params.api.close();
-        });
-    }
-
-    onGroupChange(_group: DockviewGroupPanel): void {
-        this.render();
-    }
-
-    onPanelVisibleChange(_isPanelVisible: boolean): void {
-        this.render();
-    }
-
-    public layout(_width: number, _height: number): void {
-        // noop
-    }
-
     private render(): void {
-        if (this._content.textContent !== this.params.title) {
-            this._content.textContent = this.params.title;
+        if (this._content.textContent !== this._title) {
+            this._content.textContent = this._title ?? '';
         }
     }
 }

packages/dockview-core/src/dockview/components/tab/tab.ts

@@ -7,11 +7,16 @@ import {
 } from '../../../dnd/dataTransfer';
 import { toggleClass } from '../../../dom';
 import { DockviewComponent } from '../../dockviewComponent';
-import { DockviewDropTargets, ITabRenderer } from '../../types';
+import { ITabRenderer } from '../../types';
 import { DockviewGroupPanel } from '../../dockviewGroupPanel';
-import { DroptargetEvent, Droptarget } from '../../../dnd/droptarget';
+import {
+    DroptargetEvent,
+    Droptarget,
+    WillShowOverlayEvent,
+} from '../../../dnd/droptarget';
 import { DragHandler } from '../../../dnd/abstractDragHandler';
 import { IDockviewPanel } from '../../dockviewPanel';
+import { addGhostImage } from '../../../dnd/ghost';
 
 class TabDragHandler extends DragHandler {
     private readonly panelTransfer =
@@ -40,22 +45,13 @@ class TabDragHandler extends DragHandler {
     }
 }
 
-export interface ITab extends IDisposable {
-    readonly panel: IDockviewPanel;
-    readonly element: HTMLElement;
-    setContent: (element: ITabRenderer) => void;
-    onChanged: Event<MouseEvent>;
-    onDrop: Event<DroptargetEvent>;
-    setActive(isActive: boolean): void;
-}
-
-export class Tab extends CompositeDisposable implements ITab {
+export class Tab extends CompositeDisposable {
     private readonly _element: HTMLElement;
-    private readonly droptarget: Droptarget;
+    private readonly dropTarget: Droptarget;
     private content: ITabRenderer | undefined = undefined;
 
-    private readonly _onChanged = new Emitter<MouseEvent>();
-    readonly onChanged: Event<MouseEvent> = this._onChanged.event;
+    private readonly _onPointDown = new Emitter<MouseEvent>();
+    readonly onPointerDown: Event<MouseEvent> = this._onPointDown.event;
 
     private readonly _onDropped = new Emitter<DroptargetEvent>();
     readonly onDrop: Event<DroptargetEvent> = this._onDropped.event;
@@ -63,6 +59,8 @@ export class Tab extends CompositeDisposable implements ITab {
     private readonly _onDragStart = new Emitter<DragEvent>();
     readonly onDragStart = this._onDragStart.event;
 
+    readonly onWillShowOverlay: Event<WillShowOverlayEvent>;
+
     public get element(): HTMLElement {
         return this._element;
     }
@@ -75,11 +73,11 @@ export class Tab extends CompositeDisposable implements ITab {
         super();
 
         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,
@@ -88,8 +86,9 @@ export class Tab extends CompositeDisposable implements ITab {
             this.panel
         );
 
-        this.droptarget = new Droptarget(this._element, {
-            acceptedTargetZones: ['center'],
+        this.dropTarget = new Droptarget(this._element, {
+            acceptedTargetZones: ['left', 'right'],
+            overlayModel: { activationSize: { value: 50, type: 'percentage' } },
             canDisplayOverlay: (event, position) => {
                 if (this.group.locked) {
                     return false;
@@ -98,50 +97,58 @@ export class Tab extends CompositeDisposable implements ITab {
                 const data = getPanelData();
 
                 if (data && this.accessor.id === data.viewId) {
-                    if (
-                        data.panelId === null &&
-                        data.groupId === this.group.id
-                    ) {
-                        // don't allow group move to drop on self
-                        return false;
-                    }
-
-                    return this.panel.id !== data.panelId;
+                    return true;
                 }
 
                 return this.group.model.canDisplayOverlay(
                     event,
                     position,
-                    DockviewDropTargets.Tab
+                    'tab'
                 );
             },
+            getOverrideTarget: () => group.model.dropTargetContainer?.model,
         });
 
+        this.onWillShowOverlay = this.dropTarget.onWillShowOverlay;
+
         this.addDisposables(
-            this._onChanged,
+            this._onPointDown,
             this._onDropped,
             this._onDragStart,
             dragHandler.onDragStart((event) => {
+                if (event.dataTransfer) {
+                    const style = getComputedStyle(this.element);
+                    const newNode = this.element.cloneNode(true) as HTMLElement;
+                    Array.from(style).forEach((key) =>
+                        newNode.style.setProperty(
+                            key,
+                            style.getPropertyValue(key),
+                            style.getPropertyPriority(key)
+                        )
+                    );
+                    newNode.style.position = 'absolute';
+
+                    addGhostImage(event.dataTransfer, newNode, {
+                        y: -10,
+                        x: 30,
+                    });
+                }
                 this._onDragStart.fire(event);
             }),
             dragHandler,
-            addDisposableListener(this._element, 'mousedown', (event) => {
-                if (event.defaultPrevented) {
-                    return;
-                }
-
-                this._onChanged.fire(event);
+            addDisposableListener(this._element, 'pointerdown', (event) => {
+                this._onPointDown.fire(event);
             }),
-            this.droptarget.onDrop((event) => {
+            this.dropTarget.onDrop((event) => {
                 this._onDropped.fire(event);
             }),
-            this.droptarget
+            this.dropTarget
         );
     }
 
     public setActive(isActive: boolean): void {
-        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);
     }
 
     public setContent(part: ITabRenderer): void {

packages/dockview-core/src/dockview/components/titlebar/tabOverflowControl.scss

@@ -0,0 +1,19 @@
+.dv-tabs-overflow-dropdown-default {
+    height: 100%;
+    color: var(--dv-activegroup-hiddenpanel-tab-color);
+
+    margin: var(--dv-tab-margin);
+    display: flex;
+    align-items: center;
+    flex-shrink: 0;
+    padding: 0.25rem 0.5rem;
+    cursor: pointer;
+
+    > span {
+        padding-left: 0.25rem;
+    }
+
+    > svg {
+        transform: rotate(90deg);
+    }
+}

packages/dockview-core/src/dockview/components/titlebar/tabOverflowControl.ts

@@ -0,0 +1,25 @@
+import { createChevronRightButton } from '../../../svg';
+
+export type DropdownElement = {
+    element: HTMLElement;
+    update: (params: { tabs: number }) => void;
+    dispose?: () => void;
+};
+
+export function createDropdownElementHandle(): DropdownElement {
+    const el = document.createElement('div');
+    el.className = 'dv-tabs-overflow-dropdown-default';
+
+    const text = document.createElement('span');
+    text.textContent = ``;
+    const icon = createChevronRightButton();
+    el.appendChild(icon);
+    el.appendChild(text);
+
+    return {
+        element: el,
+        update: (params: { tabs: number }) => {
+            text.textContent = `${params.tabs}`;
+        },
+    };
+}

packages/dockview-core/src/dockview/components/titlebar/tabs.scss

@@ -0,0 +1,79 @@
+.dv-tabs-container {
+    display: flex;
+    height: 100%;
+    overflow: auto;
+    scrollbar-width: thin; // firefox
+
+    &.dv-horizontal {
+        .dv-tab {
+            &:not(:first-child)::before {
+                content: ' ';
+                position: absolute;
+                top: 0;
+                left: 0;
+                z-index: 5;
+                pointer-events: none;
+                background-color: var(--dv-tab-divider-color);
+                width: 1px;
+                height: 100%;
+            }
+        }
+    }
+
+    &::-webkit-scrollbar {
+        height: 3px;
+    }
+
+    /* Track */
+    &::-webkit-scrollbar-track {
+        background: transparent;
+    }
+
+    /* Handle */
+    &::-webkit-scrollbar-thumb {
+        background: var(--dv-tabs-container-scrollbar-color);
+    }
+}
+
+.dv-scrollable {
+    > .dv-tabs-container {
+        overflow: hidden;
+    }
+}
+
+.dv-tab {
+    -webkit-user-drag: element;
+    outline: none;
+    padding: 0.25rem 0.5rem;
+    cursor: pointer;
+    position: relative;
+    box-sizing: border-box;
+    font-size: var(--dv-tab-font-size);
+    margin: var(--dv-tab-margin);
+}
+
+.dv-tabs-overflow-container {
+    flex-direction: column;
+    height: unset;
+    border: 1px solid var(--dv-tab-divider-color);
+    background-color: var(--dv-group-view-background-color);
+
+    .dv-tab {
+        &:not(:last-child) {
+            border-bottom: 1px solid var(--dv-tab-divider-color);
+        }
+    }
+
+    .dv-active-tab {
+        background-color: var(
+            --dv-activegroup-visiblepanel-tab-background-color
+        );
+        color: var(--dv-activegroup-visiblepanel-tab-color);
+    }
+    .dv-inactive-tab {
+        background-color: var(
+            --dv-activegroup-hiddenpanel-tab-background-color
+        );
+        color: var(--dv-activegroup-hiddenpanel-tab-color);
+    }
+}

packages/dockview-core/src/dockview/components/titlebar/tabs.ts

@@ -0,0 +1,301 @@
+import { getPanelData } from '../../../dnd/dataTransfer';
+import {
+    isChildEntirelyVisibleWithinParent,
+    OverflowObserver,
+} from '../../../dom';
+import { addDisposableListener, Emitter, Event } from '../../../events';
+import {
+    CompositeDisposable,
+    Disposable,
+    IValueDisposable,
+    MutableDisposable,
+} from '../../../lifecycle';
+import { Scrollbar } from '../../../scrollbar';
+import { DockviewComponent } from '../../dockviewComponent';
+import { DockviewGroupPanel } from '../../dockviewGroupPanel';
+import { WillShowOverlayLocationEvent } from '../../dockviewGroupPanelModel';
+import { DockviewPanel, IDockviewPanel } from '../../dockviewPanel';
+import { Tab } from '../tab/tab';
+import { TabDragEvent, TabDropIndexEvent } from './tabsContainer';
+
+export class Tabs extends CompositeDisposable {
+    private readonly _element: HTMLElement;
+    private readonly _tabsList: HTMLElement;
+    private readonly _observerDisposable = new MutableDisposable();
+
+    private _tabs: IValueDisposable<Tab>[] = [];
+    private selectedIndex = -1;
+    private _showTabsOverflowControl = false;
+
+    private readonly _onTabDragStart = new Emitter<TabDragEvent>();
+    readonly onTabDragStart: Event<TabDragEvent> = this._onTabDragStart.event;
+
+    private readonly _onDrop = new Emitter<TabDropIndexEvent>();
+    readonly onDrop: Event<TabDropIndexEvent> = this._onDrop.event;
+
+    private readonly _onWillShowOverlay =
+        new Emitter<WillShowOverlayLocationEvent>();
+    readonly onWillShowOverlay: Event<WillShowOverlayLocationEvent> =
+        this._onWillShowOverlay.event;
+
+    private readonly _onOverflowTabsChange = new Emitter<{
+        tabs: string[];
+        reset: boolean;
+    }>();
+    readonly onOverflowTabsChange = this._onOverflowTabsChange.event;
+
+    get showTabsOverflowControl(): boolean {
+        return this._showTabsOverflowControl;
+    }
+
+    set showTabsOverflowControl(value: boolean) {
+        if (this._showTabsOverflowControl == value) {
+            return;
+        }
+
+        this._showTabsOverflowControl = value;
+
+        if (value) {
+            const observer = new OverflowObserver(this._tabsList);
+
+            this._observerDisposable.value = new CompositeDisposable(
+                observer,
+                observer.onDidChange((event) => {
+                    const hasOverflow = event.hasScrollX || event.hasScrollY;
+                    this.toggleDropdown({ reset: !hasOverflow });
+                }),
+                addDisposableListener(this._tabsList, 'scroll', () => {
+                    this.toggleDropdown({ reset: false });
+                })
+            );
+        }
+    }
+
+    get element(): HTMLElement {
+        return this._element;
+    }
+
+    get panels(): string[] {
+        return this._tabs.map((_) => _.value.panel.id);
+    }
+
+    get size(): number {
+        return this._tabs.length;
+    }
+
+    get tabs(): Tab[] {
+        return this._tabs.map((_) => _.value);
+    }
+
+    constructor(
+        private readonly group: DockviewGroupPanel,
+        private readonly accessor: DockviewComponent,
+        options: {
+            showTabsOverflowControl: boolean;
+        }
+    ) {
+        super();
+
+        this._tabsList = document.createElement('div');
+        this._tabsList.className = 'dv-tabs-container dv-horizontal';
+
+        this.showTabsOverflowControl = options.showTabsOverflowControl;
+
+        if (accessor.options.scrollbars === 'native') {
+            this._element = this._tabsList;
+        } else {
+            const scrollbar = new Scrollbar(this._tabsList);
+            this._element = scrollbar.element;
+            this.addDisposables(scrollbar);
+        }
+
+        this.addDisposables(
+            this._onOverflowTabsChange,
+            this._observerDisposable,
+            this._onWillShowOverlay,
+            this._onDrop,
+            this._onTabDragStart,
+            addDisposableListener(this.element, 'pointerdown', (event) => {
+                if (event.defaultPrevented) {
+                    return;
+                }
+
+                const isLeftClick = event.button === 0;
+
+                if (isLeftClick) {
+                    this.accessor.doSetGroupActive(this.group);
+                }
+            }),
+            Disposable.from(() => {
+                for (const { value, disposable } of this._tabs) {
+                    disposable.dispose();
+                    value.dispose();
+                }
+
+                this._tabs = [];
+            })
+        );
+    }
+
+    indexOf(id: string): number {
+        return this._tabs.findIndex((tab) => tab.value.panel.id === id);
+    }
+
+    isActive(tab: Tab): boolean {
+        return (
+            this.selectedIndex > -1 &&
+            this._tabs[this.selectedIndex].value === tab
+        );
+    }
+
+    setActivePanel(panel: IDockviewPanel): void {
+        let runningWidth = 0;
+
+        for (const tab of this._tabs) {
+            const isActivePanel = panel.id === tab.value.panel.id;
+            tab.value.setActive(isActivePanel);
+
+            if (isActivePanel) {
+                const element = tab.value.element;
+                const parentElement = element.parentElement!;
+
+                if (
+                    runningWidth < parentElement.scrollLeft ||
+                    runningWidth + element.clientWidth >
+                        parentElement.scrollLeft + parentElement.clientWidth
+                ) {
+                    parentElement.scrollLeft = runningWidth;
+                }
+            }
+
+            runningWidth += tab.value.element.clientWidth;
+        }
+    }
+
+    openPanel(panel: IDockviewPanel, index: number = this._tabs.length): void {
+        if (this._tabs.find((tab) => tab.value.panel.id === panel.id)) {
+            return;
+        }
+        const tab = new Tab(panel, this.accessor, this.group);
+        tab.setContent(panel.view.tab);
+
+        const disposable = new CompositeDisposable(
+            tab.onDragStart((event) => {
+                this._onTabDragStart.fire({ nativeEvent: event, panel });
+            }),
+            tab.onPointerDown((event) => {
+                if (event.defaultPrevented) {
+                    return;
+                }
+
+                const isFloatingGroupsEnabled =
+                    !this.accessor.options.disableFloatingGroups;
+
+                const isFloatingWithOnePanel =
+                    this.group.api.location.type === 'floating' &&
+                    this.size === 1;
+
+                if (
+                    isFloatingGroupsEnabled &&
+                    !isFloatingWithOnePanel &&
+                    event.shiftKey
+                ) {
+                    event.preventDefault();
+
+                    const panel = this.accessor.getGroupPanel(tab.panel.id);
+
+                    const { top, left } = tab.element.getBoundingClientRect();
+                    const { top: rootTop, left: rootLeft } =
+                        this.accessor.element.getBoundingClientRect();
+
+                    this.accessor.addFloatingGroup(panel as DockviewPanel, {
+                        x: left - rootLeft,
+                        y: top - rootTop,
+                        inDragMode: true,
+                    });
+                    return;
+                }
+
+                switch (event.button) {
+                    case 0: // left click or touch
+                        if (this.group.activePanel !== panel) {
+                            this.group.model.openPanel(panel);
+                        }
+                        break;
+                }
+            }),
+            tab.onDrop((event) => {
+                this._onDrop.fire({
+                    event: event.nativeEvent,
+                    index: this._tabs.findIndex((x) => x.value === tab),
+                });
+            }),
+            tab.onWillShowOverlay((event) => {
+                this._onWillShowOverlay.fire(
+                    new WillShowOverlayLocationEvent(event, {
+                        kind: 'tab',
+                        panel: this.group.activePanel,
+                        api: this.accessor.api,
+                        group: this.group,
+                        getData: getPanelData,
+                    })
+                );
+            })
+        );
+
+        const value: IValueDisposable<Tab> = { value: tab, disposable };
+
+        this.addTab(value, index);
+    }
+
+    delete(id: string): void {
+        const index = this.indexOf(id);
+        const tabToRemove = this._tabs.splice(index, 1)[0];
+
+        const { value, disposable } = tabToRemove;
+
+        disposable.dispose();
+        value.dispose();
+        value.element.remove();
+    }
+
+    private addTab(
+        tab: IValueDisposable<Tab>,
+        index: number = this._tabs.length
+    ): void {
+        if (index < 0 || index > this._tabs.length) {
+            throw new Error('invalid location');
+        }
+
+        this._tabsList.insertBefore(
+            tab.value.element,
+            this._tabsList.children[index]
+        );
+
+        this._tabs = [
+            ...this._tabs.slice(0, index),
+            tab,
+            ...this._tabs.slice(index),
+        ];
+
+        if (this.selectedIndex < 0) {
+            this.selectedIndex = index;
+        }
+    }
+
+    private toggleDropdown(options: { reset: boolean }): void {
+        const tabs = options.reset
+            ? []
+            : this._tabs
+                  .filter(
+                      (tab) =>
+                          !isChildEntirelyVisibleWithinParent(
+                              tab.value.element,
+                              this._tabsList
+                          )
+                  )
+                  .map((x) => x.value.panel.id);
+
+        this._onOverflowTabsChange.fire({ tabs, reset: options.reset });
+    }
+}

packages/dockview-core/src/dockview/components/titlebar/tabsContainer.scss

@@ -1,4 +1,4 @@
-.tabs-and-actions-container {
+.dv-tabs-and-actions-container {
     display: flex;
     background-color: var(--dv-tabs-and-actions-container-background-color);
     flex-shrink: 0;
@@ -6,70 +6,32 @@
     height: var(--dv-tabs-and-actions-container-height);
     font-size: var(--dv-tabs-and-actions-container-font-size);
 
-    &.hidden {
-        display: none;
-    }
-
     &.dv-single-tab.dv-full-width-single-tab {
-      .tabs-container {
-          flex-grow: 1;
-
-          .tab {
+        .dv-scrollable {
             flex-grow: 1;
-          }
-      }
+        }
 
-      .void-container {
-        flex-grow: 0;
-      }
+        .dv-tabs-container {
+            flex-grow: 1;
+
+            .dv-tab {
+                flex-grow: 1;
+                padding: 0px;
+            }
+        }
+
+        .dv-void-container {
+            flex-grow: 0;
+        }
     }
 
-    .void-container {
+    .dv-void-container {
         display: flex;
         flex-grow: 1;
         cursor: grab;
     }
 
-    .tabs-container {
+    .dv-right-actions-container {
         display: flex;
-        overflow-x: overlay;
-        overflow-y: hidden;
-
-        scrollbar-width: thin; // firefox
-
-        &::-webkit-scrollbar {
-            height: 3px;
-        }
-
-        /* Track */
-        &::-webkit-scrollbar-track {
-            background: transparent;
-        }
-
-        /* Handle */
-        &::-webkit-scrollbar-thumb {
-            background: var(--dv-tabs-container-scrollbar-color);
-        }
-
-        .tab {
-            -webkit-user-drag: element;
-            outline: none;
-            min-width: 75px;
-            cursor: pointer;
-            position: relative;
-            box-sizing: border-box;
-
-            &:not(:first-child)::before {
-                content: ' ';
-                position: absolute;
-                top: 0;
-                left: 0;
-                z-index: 5;
-                pointer-events: none;
-                background-color: var(--dv-tab-divider-color);
-                width: 1px;
-                height: 100%;
-            }
-        }
     }
 }

packages/dockview-core/src/dockview/components/titlebar/tabsContainer.ts

@@ -1,15 +1,23 @@
 import {
     IDisposable,
     CompositeDisposable,
-    IValueDisposable,
+    Disposable,
+    MutableDisposable,
 } from '../../../lifecycle';
 import { addDisposableListener, Emitter, Event } from '../../../events';
-import { ITab, Tab } from '../tab/tab';
-import { DockviewComponent } from '../../dockviewComponent';
+import { Tab } from '../tab/tab';
 import { DockviewGroupPanel } from '../../dockviewGroupPanel';
 import { VoidContainer } from './voidContainer';
-import { toggleClass } from '../../../dom';
-import { DockviewPanel, IDockviewPanel } from '../../dockviewPanel';
+import { findRelativeZIndexParent, toggleClass } from '../../../dom';
+import { IDockviewPanel } from '../../dockviewPanel';
+import { DockviewComponent } from '../../dockviewComponent';
+import { WillShowOverlayLocationEvent } from '../../dockviewGroupPanelModel';
+import { getPanelData } from '../../../dnd/dataTransfer';
+import { Tabs } from './tabs';
+import {
+    createDropdownElementHandle,
+    DropdownElement,
+} from './tabOverflowControl';
 
 export interface TabDropIndexEvent {
     readonly event: DragEvent;
@@ -30,17 +38,18 @@ export interface ITabsContainer extends IDisposable {
     readonly element: HTMLElement;
     readonly panels: string[];
     readonly size: number;
+    readonly onDrop: Event<TabDropIndexEvent>;
+    readonly onTabDragStart: Event<TabDragEvent>;
+    readonly onGroupDragStart: Event<GroupDragEvent>;
+    readonly onWillShowOverlay: Event<WillShowOverlayLocationEvent>;
     hidden: boolean;
-    delete: (id: string) => void;
-    indexOf: (id: string) => number;
-    onDrop: Event<TabDropIndexEvent>;
-    onTabDragStart: Event<TabDragEvent>;
-    onGroupDragStart: Event<GroupDragEvent>;
-    setActive: (isGroupActive: boolean) => void;
-    setActivePanel: (panel: IDockviewPanel) => void;
-    isActive: (tab: ITab) => boolean;
-    closePanel: (panel: IDockviewPanel) => void;
-    openPanel: (panel: IDockviewPanel, index?: number) => void;
+    delete(id: string): void;
+    indexOf(id: string): number;
+    setActive(isGroupActive: boolean): void;
+    setActivePanel(panel: IDockviewPanel): void;
+    isActive(tab: Tab): boolean;
+    closePanel(panel: IDockviewPanel): void;
+    openPanel(panel: IDockviewPanel, index?: number): void;
     setRightActionsElement(element: HTMLElement | undefined): void;
     setLeftActionsElement(element: HTMLElement | undefined): void;
     setPrefixActionsElement(element: HTMLElement | undefined): void;
@@ -53,36 +62,44 @@ export class TabsContainer
     implements ITabsContainer
 {
     private readonly _element: HTMLElement;
-    private readonly tabContainer: HTMLElement;
+    private readonly tabs: Tabs;
     private readonly rightActionsContainer: HTMLElement;
     private readonly leftActionsContainer: HTMLElement;
     private readonly preActionsContainer: HTMLElement;
     private readonly voidContainer: VoidContainer;
 
-    private tabs: IValueDisposable<ITab>[] = [];
-    private selectedIndex = -1;
     private rightActions: HTMLElement | undefined;
     private leftActions: HTMLElement | undefined;
     private preActions: HTMLElement | undefined;
 
     private _hidden = false;
 
+    private dropdownPart: DropdownElement | null = null;
+    private _overflowTabs: string[] = [];
+    private readonly _dropdownDisposable = new MutableDisposable();
+
     private readonly _onDrop = new Emitter<TabDropIndexEvent>();
     readonly onDrop: Event<TabDropIndexEvent> = this._onDrop.event;
 
-    private readonly _onTabDragStart = new Emitter<TabDragEvent>();
-    readonly onTabDragStart: Event<TabDragEvent> = this._onTabDragStart.event;
+    get onTabDragStart(): Event<TabDragEvent> {
+        return this.tabs.onTabDragStart;
+    }
 
     private readonly _onGroupDragStart = new Emitter<GroupDragEvent>();
     readonly onGroupDragStart: Event<GroupDragEvent> =
         this._onGroupDragStart.event;
 
+    private readonly _onWillShowOverlay =
+        new Emitter<WillShowOverlayLocationEvent>();
+    readonly onWillShowOverlay: Event<WillShowOverlayLocationEvent> =
+        this._onWillShowOverlay.event;
+
     get panels(): string[] {
-        return this.tabs.map((_) => _.value.panel.id);
+        return this.tabs.panels;
     }
 
     get size(): number {
-        return this.tabs.length;
+        return this.tabs.size;
     }
 
     get hidden(): boolean {
@@ -94,6 +111,118 @@ export class TabsContainer
         this.element.style.display = value ? 'none' : '';
     }
 
+    get element(): HTMLElement {
+        return this._element;
+    }
+
+    constructor(
+        private readonly accessor: DockviewComponent,
+        private readonly group: DockviewGroupPanel
+    ) {
+        super();
+
+        this._element = document.createElement('div');
+        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 = 'dv-right-actions-container';
+
+        this.leftActionsContainer = document.createElement('div');
+        this.leftActionsContainer.className = 'dv-left-actions-container';
+
+        this.preActionsContainer = document.createElement('div');
+        this.preActionsContainer.className = 'dv-pre-actions-container';
+
+        this.tabs = new Tabs(group, accessor, {
+            showTabsOverflowControl: !accessor.options.disableTabsOverflowList,
+        });
+
+        this.voidContainer = new VoidContainer(this.accessor, this.group);
+
+        this._element.appendChild(this.preActionsContainer);
+        this._element.appendChild(this.tabs.element);
+        this._element.appendChild(this.leftActionsContainer);
+        this._element.appendChild(this.voidContainer.element);
+        this._element.appendChild(this.rightActionsContainer);
+
+        this.addDisposables(
+            this.tabs.onDrop((e) => this._onDrop.fire(e)),
+            this.tabs.onWillShowOverlay((e) => this._onWillShowOverlay.fire(e)),
+            accessor.onDidOptionsChange(() => {
+                this.tabs.showTabsOverflowControl =
+                    !accessor.options.disableTabsOverflowList;
+            }),
+            this.tabs.onOverflowTabsChange((event) => {
+                this.toggleDropdown(event);
+            }),
+            this.tabs,
+            this._onWillShowOverlay,
+            this._onDrop,
+            this._onGroupDragStart,
+            this.voidContainer,
+            this.voidContainer.onDragStart((event) => {
+                this._onGroupDragStart.fire({
+                    nativeEvent: event,
+                    group: this.group,
+                });
+            }),
+            this.voidContainer.onDrop((event) => {
+                this._onDrop.fire({
+                    event: event.nativeEvent,
+                    index: this.tabs.size,
+                });
+            }),
+            this.voidContainer.onWillShowOverlay((event) => {
+                this._onWillShowOverlay.fire(
+                    new WillShowOverlayLocationEvent(event, {
+                        kind: 'header_space',
+                        panel: this.group.activePanel,
+                        api: this.accessor.api,
+                        group: this.group,
+                        getData: getPanelData,
+                    })
+                );
+            }),
+            addDisposableListener(
+                this.voidContainer.element,
+                'pointerdown',
+                (event) => {
+                    if (event.defaultPrevented) {
+                        return;
+                    }
+
+                    const isFloatingGroupsEnabled =
+                        !this.accessor.options.disableFloatingGroups;
+
+                    if (
+                        isFloatingGroupsEnabled &&
+                        event.shiftKey &&
+                        this.group.api.location.type !== 'floating'
+                    ) {
+                        event.preventDefault();
+
+                        const { top, left } =
+                            this.element.getBoundingClientRect();
+                        const { top: rootTop, left: rootLeft } =
+                            this.accessor.element.getBoundingClientRect();
+
+                        this.accessor.addFloatingGroup(this.group, {
+                            x: left - rootLeft + 20,
+                            y: top - rootTop + 20,
+                            inDragMode: true,
+                        });
+                    }
+                }
+            )
+        );
+    }
+
     show(): void {
         if (!this.hidden) {
             this.element.style.display = '';
@@ -146,275 +275,129 @@ export class TabsContainer
         }
     }
 
-    get element(): HTMLElement {
-        return this._element;
+    isActive(tab: Tab): boolean {
+        return this.tabs.isActive(tab);
     }
 
-    public isActive(tab: ITab): boolean {
-        return (
-            this.selectedIndex > -1 &&
-            this.tabs[this.selectedIndex].value === tab
-        );
+    indexOf(id: string): number {
+        return this.tabs.indexOf(id);
     }
 
-    public indexOf(id: string): number {
-        return this.tabs.findIndex((tab) => tab.value.panel.id === id);
-    }
-
-    constructor(
-        private readonly accessor: DockviewComponent,
-        private readonly group: DockviewGroupPanel
-    ) {
-        super();
-
-        this.addDisposables(
-            this._onDrop,
-            this._onTabDragStart,
-            this._onGroupDragStart
-        );
-
-        this._element = document.createElement('div');
-        this._element.className = 'tabs-and-actions-container';
-
-        toggleClass(
-            this._element,
-            'dv-full-width-single-tab',
-            this.accessor.options.singleTabMode === 'fullwidth'
-        );
-
-        this.addDisposables(
-            this.accessor.onDidAddPanel((e) => {
-                if (e.api.group === this.group) {
-                    toggleClass(
-                        this._element,
-                        'dv-single-tab',
-                        this.size === 1
-                    );
-                }
-            }),
-            this.accessor.onDidRemovePanel((e) => {
-                if (e.api.group === this.group) {
-                    toggleClass(
-                        this._element,
-                        'dv-single-tab',
-                        this.size === 1
-                    );
-                }
-            })
-        );
-
-        this.rightActionsContainer = document.createElement('div');
-        this.rightActionsContainer.className = 'right-actions-container';
-
-        this.leftActionsContainer = document.createElement('div');
-        this.leftActionsContainer.className = 'left-actions-container';
-
-        this.preActionsContainer = document.createElement('div');
-        this.preActionsContainer.className = 'pre-actions-container';
-
-        this.tabContainer = document.createElement('div');
-        this.tabContainer.className = 'tabs-container';
-
-        this.voidContainer = new VoidContainer(this.accessor, this.group);
-
-        this._element.appendChild(this.preActionsContainer);
-        this._element.appendChild(this.tabContainer);
-        this._element.appendChild(this.leftActionsContainer);
-        this._element.appendChild(this.voidContainer.element);
-        this._element.appendChild(this.rightActionsContainer);
-
-        this.addDisposables(
-            this.voidContainer,
-            this.voidContainer.onDragStart((event) => {
-                this._onGroupDragStart.fire({
-                    nativeEvent: event,
-                    group: this.group,
-                });
-            }),
-            this.voidContainer.onDrop((event) => {
-                this._onDrop.fire({
-                    event: event.nativeEvent,
-                    index: this.tabs.length,
-                });
-            }),
-            addDisposableListener(
-                this.voidContainer.element,
-                'mousedown',
-                (event) => {
-                    const isFloatingGroupsEnabled =
-                        !this.accessor.options.disableFloatingGroups;
-
-                    if (
-                        isFloatingGroupsEnabled &&
-                        event.shiftKey &&
-                        this.group.api.location !== 'floating'
-                    ) {
-                        event.preventDefault();
-
-                        const { top, left } =
-                            this.element.getBoundingClientRect();
-                        const { top: rootTop, left: rootLeft } =
-                            this.accessor.element.getBoundingClientRect();
-
-                        this.accessor.addFloatingGroup(
-                            this.group,
-                            {
-                                x: left - rootLeft + 20,
-                                y: top - rootTop + 20,
-                            },
-                            { inDragMode: true }
-                        );
-                    }
-                }
-            ),
-            addDisposableListener(this.tabContainer, 'mousedown', (event) => {
-                if (event.defaultPrevented) {
-                    return;
-                }
-
-                const isLeftClick = event.button === 0;
-
-                if (isLeftClick) {
-                    this.accessor.doSetGroupActive(this.group);
-                }
-            })
-        );
-    }
-
-    public setActive(_isGroupActive: boolean) {
+    setActive(_isGroupActive: boolean) {
         // noop
     }
 
-    private addTab(
-        tab: IValueDisposable<ITab>,
-        index: number = this.tabs.length
-    ): void {
-        if (index < 0 || index > this.tabs.length) {
-            throw new Error('invalid location');
-        }
-
-        this.tabContainer.insertBefore(
-            tab.value.element,
-            this.tabContainer.children[index]
-        );
-
-        this.tabs = [
-            ...this.tabs.slice(0, index),
-            tab,
-            ...this.tabs.slice(index),
-        ];
-
-        if (this.selectedIndex < 0) {
-            this.selectedIndex = index;
-        }
+    delete(id: string): void {
+        this.tabs.delete(id);
+        this.updateClassnames();
     }
 
-    public delete(id: string): void {
-        const index = this.tabs.findIndex((tab) => tab.value.panel.id === id);
-
-        const tabToRemove = this.tabs.splice(index, 1)[0];
-
-        const { value, disposable } = tabToRemove;
-
-        disposable.dispose();
-        value.dispose();
-        value.element.remove();
+    setActivePanel(panel: IDockviewPanel): void {
+        this.tabs.setActivePanel(panel);
     }
 
-    public setActivePanel(panel: IDockviewPanel): void {
-        this.tabs.forEach((tab) => {
-            const isActivePanel = panel.id === tab.value.panel.id;
-            tab.value.setActive(isActivePanel);
-        });
+    openPanel(panel: IDockviewPanel, index: number = this.tabs.size): void {
+        this.tabs.openPanel(panel, index);
+        this.updateClassnames();
     }
 
-    public openPanel(
-        panel: IDockviewPanel,
-        index: number = this.tabs.length
-    ): void {
-        if (this.tabs.find((tab) => tab.value.panel.id === panel.id)) {
-            return;
-        }
-        const tab = new Tab(panel, this.accessor, this.group);
-        if (!panel.view?.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 });
-            }),
-            tab.onChanged((event) => {
-                const isFloatingGroupsEnabled =
-                    !this.accessor.options.disableFloatingGroups;
-
-                const isFloatingWithOnePanel =
-                    this.group.api.location === 'floating' && this.size === 1;
-
-                if (
-                    isFloatingGroupsEnabled &&
-                    !isFloatingWithOnePanel &&
-                    event.shiftKey
-                ) {
-                    event.preventDefault();
-
-                    const panel = this.accessor.getGroupPanel(tab.panel.id);
-
-                    const { top, left } = tab.element.getBoundingClientRect();
-                    const { top: rootTop, left: rootLeft } =
-                        this.accessor.element.getBoundingClientRect();
-
-                    this.accessor.addFloatingGroup(
-                        panel as DockviewPanel,
-                        {
-                            x: left - rootLeft,
-                            y: top - rootTop,
-                        },
-                        { inDragMode: true }
-                    );
-                    return;
-                }
-
-                const alreadyFocused =
-                    panel.id === this.group.model.activePanel?.id &&
-                    this.group.model.isContentFocused;
-
-                const isLeftClick = event.button === 0;
-
-                if (!isLeftClick || event.defaultPrevented) {
-                    return;
-                }
-
-                this.group.model.openPanel(panel, {
-                    skipFocus: alreadyFocused,
-                });
-            }),
-            tab.onDrop((event) => {
-                this._onDrop.fire({
-                    event: event.nativeEvent,
-                    index: this.tabs.findIndex((x) => x.value === tab),
-                });
-            })
-        );
-
-        const value: IValueDisposable<ITab> = { value: tab, disposable };
-
-        this.addTab(value, index);
-    }
-
-    public closePanel(panel: IDockviewPanel): void {
+    closePanel(panel: IDockviewPanel): void {
         this.delete(panel.id);
     }
 
-    public dispose(): void {
-        super.dispose();
+    private updateClassnames(): void {
+        toggleClass(this._element, 'dv-single-tab', this.size === 1);
+    }
 
-        for (const { value, disposable } of this.tabs) {
-            disposable.dispose();
-            value.dispose();
+    private toggleDropdown(options: { tabs: string[]; reset: boolean }): void {
+        const tabs = options.reset ? [] : options.tabs;
+        this._overflowTabs = tabs;
+
+        if (this._overflowTabs.length > 0 && this.dropdownPart) {
+            this.dropdownPart.update({ tabs: tabs.length });
+            return;
         }
 
-        this.tabs = [];
+        if (this._overflowTabs.length === 0) {
+            this._dropdownDisposable.dispose();
+            return;
+        }
+
+        const root = document.createElement('div');
+        root.className = 'dv-tabs-overflow-dropdown-root';
+
+        const part = createDropdownElementHandle();
+        part.update({ tabs: tabs.length });
+
+        this.dropdownPart = part;
+
+        root.appendChild(part.element);
+        this.rightActionsContainer.prepend(root);
+
+        this._dropdownDisposable.value = new CompositeDisposable(
+            Disposable.from(() => {
+                root.remove();
+                this.dropdownPart?.dispose?.();
+                this.dropdownPart = null;
+            }),
+            addDisposableListener(
+                root,
+                'pointerdown',
+                (event) => {
+                    event.preventDefault();
+                },
+                { capture: true }
+            ),
+            addDisposableListener(root, 'click', (event) => {
+                const el = document.createElement('div');
+                el.style.overflow = 'auto';
+                el.className = 'dv-tabs-overflow-container';
+
+                for (const tab of this.tabs.tabs.filter((tab) =>
+                    this._overflowTabs.includes(tab.panel.id)
+                )) {
+                    const panelObject = this.group.panels.find(
+                        (panel) => panel === tab.panel
+                    )!;
+
+                    const tabComponent =
+                        panelObject.view.createTabRenderer('headerOverflow');
+
+                    const child = tabComponent.element;
+
+                    const wrapper = document.createElement('div');
+                    toggleClass(wrapper, 'dv-tab', true);
+                    toggleClass(
+                        wrapper,
+                        'dv-active-tab',
+                        panelObject.api.isActive
+                    );
+                    toggleClass(
+                        wrapper,
+                        'dv-inactive-tab',
+                        !panelObject.api.isActive
+                    );
+
+                    wrapper.addEventListener('pointerdown', () => {
+                        this.accessor.popupService.close();
+                        tab.element.scrollIntoView();
+                        tab.panel.api.setActive();
+                    });
+                    wrapper.appendChild(child);
+
+                    el.appendChild(wrapper);
+                }
+
+                const relativeParent = findRelativeZIndexParent(root);
+
+                this.accessor.popupService.openPopover(el, {
+                    x: event.clientX,
+                    y: event.clientY,
+                    zIndex: relativeParent?.style.zIndex
+                        ? `calc(${relativeParent.style.zIndex} * 2)`
+                        : undefined,
+                });
+            })
+        );
     }
 }

packages/dockview-core/src/dockview/components/titlebar/voidContainer.ts

@@ -1,16 +1,19 @@
-import { last } from '../../../array';
 import { getPanelData } from '../../../dnd/dataTransfer';
-import { Droptarget, DroptargetEvent } from '../../../dnd/droptarget';
+import {
+    Droptarget,
+    DroptargetEvent,
+    WillShowOverlayEvent,
+} from '../../../dnd/droptarget';
 import { GroupDragHandler } from '../../../dnd/groupDragHandler';
 import { DockviewComponent } from '../../dockviewComponent';
 import { addDisposableListener, Emitter, Event } from '../../../events';
 import { CompositeDisposable } from '../../../lifecycle';
 import { DockviewGroupPanel } from '../../dockviewGroupPanel';
-import { DockviewDropTargets } from '../../types';
+import { DockviewGroupPanelModel } from '../../dockviewGroupPanelModel';
 
 export class VoidContainer extends CompositeDisposable {
     private readonly _element: HTMLElement;
-    private readonly voidDropTarget: Droptarget;
+    private readonly dropTraget: Droptarget;
 
     private readonly _onDrop = new Emitter<DroptargetEvent>();
     readonly onDrop: Event<DroptargetEvent> = this._onDrop.event;
@@ -18,6 +21,8 @@ export class VoidContainer extends CompositeDisposable {
     private readonly _onDragStart = new Emitter<DragEvent>();
     readonly onDragStart = this._onDragStart.event;
 
+    readonly onWillShowOverlay: Event<WillShowOverlayEvent>;
+
     get element(): HTMLElement {
         return this._element;
     }
@@ -30,55 +35,48 @@ export class VoidContainer extends CompositeDisposable {
 
         this._element = document.createElement('div');
 
-        this._element.className = 'void-container';
-        this._element.tabIndex = 0;
+        this._element.className = 'dv-void-container';
         this._element.draggable = true;
 
         this.addDisposables(
             this._onDrop,
             this._onDragStart,
-            addDisposableListener(this._element, 'click', () => {
+            addDisposableListener(this._element, 'pointerdown', () => {
                 this.accessor.doSetGroupActive(this.group);
             })
         );
 
         const handler = new GroupDragHandler(this._element, accessor, group);
 
-        this.voidDropTarget = new Droptarget(this._element, {
+        this.dropTraget = new Droptarget(this._element, {
             acceptedTargetZones: ['center'],
             canDisplayOverlay: (event, position) => {
                 const data = getPanelData();
 
                 if (data && this.accessor.id === data.viewId) {
-                    if (
-                        data.panelId === null &&
-                        data.groupId === this.group.id
-                    ) {
-                        // don't allow group move to drop on self
-                        return false;
-                    }
-
-                    // don't show the overlay if the tab being dragged is the last panel of this group
-                    return last(this.group.panels)?.id !== data.panelId;
+                    return true;
                 }
 
                 return group.model.canDisplayOverlay(
                     event,
                     position,
-                    DockviewDropTargets.Panel
+                    'header_space'
                 );
             },
+            getOverrideTarget: () => group.model.dropTargetContainer?.model,
         });
 
+        this.onWillShowOverlay = this.dropTraget.onWillShowOverlay;
+
         this.addDisposables(
             handler,
             handler.onDragStart((event) => {
                 this._onDragStart.fire(event);
             }),
-            this.voidDropTarget.onDrop((event) => {
+            this.dropTraget.onDrop((event) => {
                 this._onDrop.fire(event);
             }),
-            this.voidDropTarget
+            this.dropTraget
         );
     }
 }

packages/dockview-core/src/dockview/components/watermark/watermark.scss

@@ -1,42 +1,4 @@
-.watermark {
+.dv-watermark {
     display: flex;
-    width: 100%;
-
-    &.has-actions {
-        .watermark-title {
-            .actions-container {
-                display: none;
-            }
-        }
-    }
-
-    .watermark-title {
-        height: 35px;
-        width: 100%;
-        display: flex;
-    }
-    .watermark-content {
-        flex-grow: 1;
-    }
-
-    .actions-container {
-        display: flex;
-        align-items: center;
-        padding: 0px 8px;
-
-        .close-action {
-            padding: 4px;
-            display: flex;
-            align-items: center;
-            justify-content: center;
-            box-sizing: border-box;
-            cursor: pointer;
-            color: var(--dv-activegroup-hiddenpanel-tab-color);
-
-            &:hover {
-                border-radius: 2px;
-                background-color: var(--dv-icon-hover-background-color);
-            }
-        }
-    }
+    height: 100%;
 }

packages/dockview-core/src/dockview/components/watermark/watermark.ts

@@ -2,21 +2,13 @@ import {
     IWatermarkRenderer,
     WatermarkRendererInitParameters,
 } from '../../types';
-import { addDisposableListener } from '../../../events';
-import { toggleClass } from '../../../dom';
 import { CompositeDisposable } from '../../../lifecycle';
-import { DockviewGroupPanel } from '../../dockviewGroupPanel';
-import { PanelUpdateEvent } from '../../../panel/types';
-import { createCloseButton } from '../../../svg';
-import { DockviewApi } from '../../../api/component.api';
 
 export class Watermark
     extends CompositeDisposable
     implements IWatermarkRenderer
 {
-    private _element: HTMLElement;
-    private _group: DockviewGroupPanel | undefined;
-    private _api: DockviewApi | undefined;
+    private readonly _element: HTMLElement;
 
     get element(): HTMLElement {
         return this._element;
@@ -25,70 +17,10 @@ export class Watermark
     constructor() {
         super();
         this._element = document.createElement('div');
-        this._element.className = 'watermark';
-
-        const title = document.createElement('div');
-        title.className = 'watermark-title';
-
-        const emptySpace = document.createElement('span');
-        emptySpace.style.flexGrow = '1';
-
-        const content = document.createElement('div');
-        content.className = 'watermark-content';
-
-        this._element.appendChild(title);
-        this._element.appendChild(content);
-
-        const actionsContainer = document.createElement('div');
-        actionsContainer.className = 'actions-container';
-
-        const closeAnchor = document.createElement('div');
-        closeAnchor.className = 'close-action';
-        closeAnchor.appendChild(createCloseButton());
-
-        actionsContainer.appendChild(closeAnchor);
-
-        title.appendChild(emptySpace);
-        title.appendChild(actionsContainer);
-
-        this.addDisposables(
-            addDisposableListener(closeAnchor, 'click', (ev) => {
-                ev.preventDefault();
-                if (this._group) {
-                    this._api?.removeGroup(this._group);
-                }
-            })
-        );
-    }
-
-    update(_event: PanelUpdateEvent): void {
-        // noop
-    }
-
-    focus(): void {
-        // noop
-    }
-
-    layout(_width: number, _height: number): void {
-        // noop
+        this._element.className = 'dv-watermark';
     }
 
     init(_params: WatermarkRendererInitParameters): void {
-        this._api = _params.containerApi;
-        this.render();
-    }
-
-    updateParentGroup(group: DockviewGroupPanel, _visible: boolean): void {
-        this._group = group;
-        this.render();
-    }
-
-    dispose(): void {
-        super.dispose();
-    }
-
-    private render(): void {
-        const isOneGroup = !!(this._api && this._api.size <= 1);
-        toggleClass(this.element, 'has-actions', isOneGroup);
+        // noop
     }
 }

packages/dockview-core/src/dockview/deserializer.ts

@@ -49,12 +49,18 @@ export class DefaultDockviewDeserialzier implements IPanelDeserializer {
 
         const panel = new DockviewPanel(
             panelId,
+            contentComponent,
+            tabComponent,
             this.accessor,
             new DockviewApi(this.accessor),
             group,
             view,
             {
                 renderer: panelData.renderer,
+                minimumWidth: panelData.minimumWidth,
+                minimumHeight: panelData.minimumHeight,
+                maximumWidth: panelData.maximumWidth,
+                maximumHeight: panelData.maximumHeight,
             }
         );
 

packages/dockview-core/src/dockview/dockviewComponent.scss

@@ -16,36 +16,40 @@
     }
 }
 
-.groupview {
-    &.active-group {
-        > .tabs-and-actions-container > .tabs-container > .tab {
-            &.active-tab {
-                background-color: var(
-                    --dv-activegroup-visiblepanel-tab-background-color
-                );
-                color: var(--dv-activegroup-visiblepanel-tab-color);
-            }
-            &.inactive-tab {
-                background-color: var(
-                    --dv-activegroup-hiddenpanel-tab-background-color
-                );
-                color: var(--dv-activegroup-hiddenpanel-tab-color);
+.dv-groupview {
+    &.dv-active-group {
+        > .dv-tabs-and-actions-container {
+            .dv-tabs-container > .dv-tab {
+                &.dv-active-tab {
+                    background-color: var(
+                        --dv-activegroup-visiblepanel-tab-background-color
+                    );
+                    color: var(--dv-activegroup-visiblepanel-tab-color);
+                }
+                &.dv-inactive-tab {
+                    background-color: var(
+                        --dv-activegroup-hiddenpanel-tab-background-color
+                    );
+                    color: var(--dv-activegroup-hiddenpanel-tab-color);
+                }
             }
         }
     }
-    &.inactive-group {
-        > .tabs-and-actions-container > .tabs-container > .tab {
-            &.active-tab {
-                background-color: var(
-                    --dv-inactivegroup-visiblepanel-tab-background-color
-                );
-                color: var(--dv-inactivegroup-visiblepanel-tab-color);
-            }
-            &.inactive-tab {
-                background-color: var(
-                    --dv-inactivegroup-hiddenpanel-tab-background-color
-                );
-                color: var(--dv-inactivegroup-hiddenpanel-tab-color);
+    &.dv-inactive-group {
+        > .dv-tabs-and-actions-container {
+            .dv-tabs-container > .dv-tab {
+                &.dv-active-tab {
+                    background-color: var(
+                        --dv-inactivegroup-visiblepanel-tab-background-color
+                    );
+                    color: var(--dv-inactivegroup-visiblepanel-tab-color);
+                }
+                &.dv-inactive-tab {
+                    background-color: var(
+                        --dv-inactivegroup-hiddenpanel-tab-background-color
+                    );
+                    color: var(--dv-inactivegroup-hiddenpanel-tab-color);
+                }
             }
         }
     }
@@ -55,7 +59,7 @@
  * when a tab is dragged we lose the above stylings because they are conditional on parent elements
  * therefore we also set some stylings for the dragging event
  **/
-.tab {
+.dv-tab {
     &.dv-tab-dragging {
         background-color: var(
             --dv-activegroup-visiblepanel-tab-background-color

packages/dockview-core/src/dockview/dockviewFloatingGroupPanel.ts

@@ -1,17 +1,11 @@
-import { Overlay } from '../dnd/overlay';
+import { Overlay } from '../overlay/overlay';
 import { CompositeDisposable } from '../lifecycle';
+import { AnchoredBox } from '../types';
 import { DockviewGroupPanel, IDockviewGroupPanel } from './dockviewGroupPanel';
 
 export interface IDockviewFloatingGroupPanel {
     readonly group: IDockviewGroupPanel;
-    position(
-        bounds: Partial<{
-            top: number;
-            left: number;
-            height: number;
-            width: number;
-        }>
-    ): void;
+    position(bounds: Partial<AnchoredBox>): void;
 }
 
 export class DockviewFloatingGroupPanel
@@ -20,18 +14,10 @@ export class DockviewFloatingGroupPanel
 {
     constructor(readonly group: DockviewGroupPanel, readonly overlay: Overlay) {
         super();
-
         this.addDisposables(overlay);
     }
 
-    position(
-        bounds: Partial<{
-            top: number;
-            left: number;
-            height: number;
-            width: number;
-        }>
-    ): void {
+    position(bounds: Partial<AnchoredBox>): void {
         this.overlay.setBounds(bounds);
     }
 }

packages/dockview-core/src/dockview/dockviewGroupPanel.scss

@@ -1,4 +1,4 @@
-.groupview {
+.dv-groupview {
     display: flex;
     flex-direction: column;
     height: 100%;
@@ -9,15 +9,9 @@
         outline: none;
     }
 
-    &.empty {
-        > .tabs-and-actions-container {
-            display: none;
-        }
-    }
-
-    > .content-container {
+    > .dv-content-container {
         flex-grow: 1;
-        overflow: hidden;
+        min-height: 0;
         outline: none;
     }
 }

packages/dockview-core/src/dockview/dockviewGroupPanel.ts

@@ -34,6 +34,38 @@ export class DockviewGroupPanel
 {
     private readonly _model: DockviewGroupPanelModel;
 
+    override get minimumWidth(): number {
+        const activePanelMinimumWidth = this.activePanel?.minimumWidth;
+        if (typeof activePanelMinimumWidth === 'number') {
+            return activePanelMinimumWidth;
+        }
+        return super.__minimumWidth();
+    }
+
+    override get minimumHeight(): number {
+        const activePanelMinimumHeight = this.activePanel?.minimumHeight;
+        if (typeof activePanelMinimumHeight === 'number') {
+            return activePanelMinimumHeight;
+        }
+        return super.__minimumHeight();
+    }
+
+    override get maximumWidth(): number {
+        const activePanelMaximumWidth = this.activePanel?.maximumWidth;
+        if (typeof activePanelMaximumWidth === 'number') {
+            return activePanelMaximumWidth;
+        }
+        return super.__maximumWidth();
+    }
+
+    override get maximumHeight(): number {
+        const activePanelMaximumHeight = this.activePanel?.maximumHeight;
+        if (typeof activePanelMaximumHeight === 'number') {
+            return activePanelMaximumHeight;
+        }
+        return super.__maximumHeight();
+    }
+
     get panels(): IDockviewPanel[] {
         return this._model.panels;
     }
@@ -71,8 +103,14 @@ export class DockviewGroupPanel
             id,
             'groupview_default',
             {
-                minimumHeight: MINIMUM_DOCKVIEW_GROUP_PANEL_HEIGHT,
-                minimumWidth: MINIMUM_DOCKVIEW_GROUP_PANEL_WIDTH,
+                minimumHeight:
+                    options.constraints?.minimumHeight ??
+                    MINIMUM_DOCKVIEW_GROUP_PANEL_HEIGHT,
+                minimumWidth:
+                    options.constraints?.maximumHeight ??
+                    MINIMUM_DOCKVIEW_GROUP_PANEL_WIDTH,
+                maximumHeight: options.constraints?.maximumHeight,
+                maximumWidth: options.constraints?.maximumWidth,
             },
             new DockviewGroupPanelApiImpl(id, accessor)
         );
@@ -86,6 +124,19 @@ export class DockviewGroupPanel
             options,
             this
         );
+
+        this.addDisposables(
+            this.model.onDidActivePanelChange((event) => {
+                this.api._onDidActivePanelChange.fire(event);
+            })
+        );
+    }
+
+    override focus(): void {
+        if (!this.api.isActive) {
+            this.api.setActive();
+        }
+        super.focus();
     }
 
     initialize(): void {

packages/dockview-core/src/dockview/dockviewGroupPanelModel.ts

@@ -1,12 +1,23 @@
 import { DockviewApi } from '../api/component.api';
 import { getPanelData, PanelTransfer } from '../dnd/dataTransfer';
-import { Position } from '../dnd/droptarget';
+import { Position, WillShowOverlayEvent } from '../dnd/droptarget';
 import { DockviewComponent } from './dockviewComponent';
 import { isAncestor, toggleClass } from '../dom';
-import { addDisposableListener, Emitter, Event } from '../events';
+import {
+    addDisposableListener,
+    DockviewEvent,
+    Emitter,
+    Event,
+    IDockviewEvent,
+} from '../events';
 import { IViewSize } from '../gridview/gridview';
-import { CompositeDisposable } from '../lifecycle';
-import { IPanel, PanelInitParameters, PanelUpdateEvent } from '../panel/types';
+import { CompositeDisposable, IDisposable } from '../lifecycle';
+import {
+    IPanel,
+    PanelInitParameters,
+    PanelUpdateEvent,
+    Parameters,
+} from '../panel/types';
 import {
     ContentContainer,
     IContentContainer,
@@ -17,30 +28,18 @@ import {
     TabDragEvent,
     TabsContainer,
 } from './components/titlebar/tabsContainer';
-import { DockviewDropTargets, IWatermarkRenderer } from './types';
+import { IWatermarkRenderer } from './types';
 import { DockviewGroupPanel } from './dockviewGroupPanel';
 import { IDockviewPanel } from './dockviewPanel';
-import { IHeaderActionsRenderer } from './options';
-
-export interface DndService {
-    canDisplayOverlay(
-        group: IDockviewGroupPanelModel,
-        event: DragEvent,
-        target: DockviewDropTargets
-    ): boolean;
-    onDrop(
-        group: IDockviewGroupPanelModel,
-        event: DragEvent,
-        position: Position,
-        index?: number
-    ): void;
-}
-
-export interface IGroupItem {
-    id: string;
-    header: { element: HTMLElement };
-    body: { element: HTMLElement };
-}
+import {
+    DockviewDndOverlayEvent,
+    DockviewUnhandledDragOverEvent,
+    IHeaderActionsRenderer,
+} from './options';
+import { OverlayRenderContainer } from '../overlay/overlayRenderContainer';
+import { TitleEvent } from '../api/dockviewPanelApi';
+import { Contraints } from '../gridview/gridviewPanel';
+import { DropTargetAnchorContainer } from '../dnd/dropTargetAnchorContainer';
 
 interface GroupMoveEvent {
     groupId: string;
@@ -52,6 +51,10 @@ interface GroupMoveEvent {
 interface CoreGroupOptions {
     locked?: DockviewGroupPanelLocked;
     hideHeader?: boolean;
+    skipSetActive?: boolean;
+    constraints?: Partial<Contraints>;
+    initialWidth?: number;
+    initialHeight?: number;
 }
 
 export interface GroupOptions extends CoreGroupOptions {
@@ -66,15 +69,69 @@ export interface GroupPanelViewState extends CoreGroupOptions {
     id: string;
 }
 
-export interface GroupviewChangeEvent {
+export interface DockviewGroupChangeEvent {
     readonly panel: IDockviewPanel;
 }
 
-export interface GroupviewDropEvent {
-    readonly nativeEvent: DragEvent;
-    readonly position: Position;
-    readonly index?: number;
-    getData(): PanelTransfer | undefined;
+export class DockviewDidDropEvent extends DockviewEvent {
+    get nativeEvent(): DragEvent {
+        return this.options.nativeEvent;
+    }
+
+    get position(): Position {
+        return this.options.position;
+    }
+
+    get panel(): IDockviewPanel | undefined {
+        return this.options.panel;
+    }
+
+    get group(): DockviewGroupPanel | undefined {
+        return this.options.group;
+    }
+
+    get api(): DockviewApi {
+        return this.options.api;
+    }
+
+    constructor(
+        private readonly options: {
+            readonly nativeEvent: DragEvent;
+            readonly position: Position;
+            readonly panel?: IDockviewPanel;
+            getData(): PanelTransfer | undefined;
+            group?: DockviewGroupPanel;
+            api: DockviewApi;
+        }
+    ) {
+        super();
+    }
+
+    getData(): PanelTransfer | undefined {
+        return this.options.getData();
+    }
+}
+
+export class DockviewWillDropEvent extends DockviewDidDropEvent {
+    private readonly _kind: DockviewGroupDropLocation;
+
+    get kind(): DockviewGroupDropLocation {
+        return this._kind;
+    }
+
+    constructor(options: {
+        readonly nativeEvent: DragEvent;
+        readonly position: Position;
+        readonly panel?: IDockviewPanel;
+        getData(): PanelTransfer | undefined;
+        kind: DockviewGroupDropLocation;
+        group?: DockviewGroupPanel;
+        api: DockviewApi;
+    }) {
+        super(options);
+
+        this._kind = options.kind;
+    }
 }
 
 export interface IHeader {
@@ -83,6 +140,12 @@ export interface IHeader {
 
 export type DockviewGroupPanelLocked = boolean | 'no-drop-target';
 
+export type DockviewGroupDropLocation =
+    | 'tab'
+    | 'header_space'
+    | 'content'
+    | 'edge';
+
 export interface IDockviewGroupPanelModel extends IPanel {
     readonly isActive: boolean;
     readonly size: number;
@@ -90,10 +153,11 @@ export interface IDockviewGroupPanelModel extends IPanel {
     readonly activePanel: IDockviewPanel | undefined;
     readonly header: IHeader;
     readonly isContentFocused: boolean;
-    readonly onDidDrop: Event<GroupviewDropEvent>;
-    readonly onDidAddPanel: Event<GroupviewChangeEvent>;
-    readonly onDidRemovePanel: Event<GroupviewChangeEvent>;
-    readonly onDidActivePanelChange: Event<GroupviewChangeEvent>;
+    readonly onDidDrop: Event<DockviewDidDropEvent>;
+    readonly onWillDrop: Event<DockviewWillDropEvent>;
+    readonly onDidAddPanel: Event<DockviewGroupChangeEvent>;
+    readonly onDidRemovePanel: Event<DockviewGroupChangeEvent>;
+    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent>;
     readonly onMove: Event<GroupMoveEvent>;
     locked: DockviewGroupPanelLocked;
     setActive(isActive: boolean): void;
@@ -126,11 +190,63 @@ export interface IDockviewGroupPanelModel extends IPanel {
     canDisplayOverlay(
         event: DragEvent,
         position: Position,
-        target: DockviewDropTargets
+        target: DockviewGroupDropLocation
     ): boolean;
 }
 
-export type DockviewGroupLocation = 'grid' | 'floating' | 'popout';
+export type DockviewGroupLocation =
+    | { type: 'grid' }
+    | { type: 'floating' }
+    | { type: 'popout'; getWindow: () => Window; popoutUrl?: string };
+
+export class WillShowOverlayLocationEvent implements IDockviewEvent {
+    get kind(): DockviewGroupDropLocation {
+        return this.options.kind;
+    }
+
+    get nativeEvent(): DragEvent {
+        return this.event.nativeEvent;
+    }
+
+    get position(): Position {
+        return this.event.position;
+    }
+
+    get defaultPrevented(): boolean {
+        return this.event.defaultPrevented;
+    }
+
+    get panel(): IDockviewPanel | undefined {
+        return this.options.panel;
+    }
+
+    get api(): DockviewApi {
+        return this.options.api;
+    }
+
+    get group(): DockviewGroupPanel | undefined {
+        return this.options.group;
+    }
+
+    preventDefault(): void {
+        this.event.preventDefault();
+    }
+
+    getData(): PanelTransfer | undefined {
+        return this.options.getData();
+    }
+
+    constructor(
+        private readonly event: WillShowOverlayEvent,
+        private readonly options: {
+            kind: DockviewGroupDropLocation;
+            panel: IDockviewPanel | undefined;
+            api: DockviewApi;
+            group: DockviewGroupPanel | undefined;
+            getData: () => PanelTransfer | undefined;
+        }
+    ) {}
+}
 
 export class DockviewGroupPanelModel
     extends CompositeDisposable
@@ -138,7 +254,6 @@ export class DockviewGroupPanelModel
 {
     private readonly tabsContainer: ITabsContainer;
     private readonly contentContainer: IContentContainer;
-    // private readonly dropTarget: Droptarget;
     private _activePanel: IDockviewPanel | undefined;
     private watermark?: IWatermarkRenderer;
     private _isGroupActive = false;
@@ -147,9 +262,12 @@ export class DockviewGroupPanelModel
     private _leftHeaderActions: IHeaderActionsRenderer | undefined;
     private _prefixHeaderActions: IHeaderActionsRenderer | undefined;
 
-    private _location: DockviewGroupLocation = 'grid';
+    private _location: DockviewGroupLocation = { type: 'grid' };
 
     private mostRecentlyUsed: IDockviewPanel[] = [];
+    private _overwriteRenderContainer: OverlayRenderContainer | null = null;
+    private _overwriteDropTargetContainer: DropTargetAnchorContainer | null =
+        null;
 
     private readonly _onDidChange = new Emitter<IViewSize | undefined>();
     readonly onDidChange: Event<IViewSize | undefined> =
@@ -158,13 +276,22 @@ export class DockviewGroupPanelModel
     private _width = 0;
     private _height = 0;
 
-    private _panels: IDockviewPanel[] = [];
+    private readonly _panels: IDockviewPanel[] = [];
+    private readonly _panelDisposables = new Map<string, IDisposable>();
 
     private readonly _onMove = new Emitter<GroupMoveEvent>();
     readonly onMove: Event<GroupMoveEvent> = this._onMove.event;
 
-    private readonly _onDidDrop = new Emitter<GroupviewDropEvent>();
-    readonly onDidDrop: Event<GroupviewDropEvent> = this._onDidDrop.event;
+    private readonly _onDidDrop = new Emitter<DockviewDidDropEvent>();
+    readonly onDidDrop: Event<DockviewDidDropEvent> = this._onDidDrop.event;
+
+    private readonly _onWillDrop = new Emitter<DockviewWillDropEvent>();
+    readonly onWillDrop: Event<DockviewWillDropEvent> = this._onWillDrop.event;
+
+    private readonly _onWillShowOverlay =
+        new Emitter<WillShowOverlayLocationEvent>();
+    readonly onWillShowOverlay: Event<WillShowOverlayLocationEvent> =
+        this._onWillShowOverlay.event;
 
     private readonly _onTabDragStart = new Emitter<TabDragEvent>();
     readonly onTabDragStart: Event<TabDragEvent> = this._onTabDragStart.event;
@@ -173,21 +300,37 @@ export class DockviewGroupPanelModel
     readonly onGroupDragStart: Event<GroupDragEvent> =
         this._onGroupDragStart.event;
 
-    private readonly _onDidAddPanel = new Emitter<GroupviewChangeEvent>();
-    readonly onDidAddPanel: Event<GroupviewChangeEvent> =
+    private readonly _onDidAddPanel = new Emitter<DockviewGroupChangeEvent>();
+    readonly onDidAddPanel: Event<DockviewGroupChangeEvent> =
         this._onDidAddPanel.event;
 
-    private readonly _onDidRemovePanel = new Emitter<GroupviewChangeEvent>();
-    readonly onDidRemovePanel: Event<GroupviewChangeEvent> =
+    private readonly _onDidPanelTitleChange = new Emitter<TitleEvent>();
+    readonly onDidPanelTitleChange: Event<TitleEvent> =
+        this._onDidPanelTitleChange.event;
+
+    private readonly _onDidPanelParametersChange = new Emitter<Parameters>();
+    readonly onDidPanelParametersChange: Event<Parameters> =
+        this._onDidPanelParametersChange.event;
+
+    private readonly _onDidRemovePanel =
+        new Emitter<DockviewGroupChangeEvent>();
+    readonly onDidRemovePanel: Event<DockviewGroupChangeEvent> =
         this._onDidRemovePanel.event;
 
     private readonly _onDidActivePanelChange =
-        new Emitter<GroupviewChangeEvent>();
-    readonly onDidActivePanelChange: Event<GroupviewChangeEvent> =
+        new Emitter<DockviewGroupChangeEvent>();
+    readonly onDidActivePanelChange: Event<DockviewGroupChangeEvent> =
         this._onDidActivePanelChange.event;
 
+    private readonly _onUnhandledDragOverEvent =
+        new Emitter<DockviewDndOverlayEvent>();
+    readonly onUnhandledDragOverEvent: Event<DockviewDndOverlayEvent> =
+        this._onUnhandledDragOverEvent.event;
+
+    private readonly _api: DockviewApi;
+
     get element(): HTMLElement {
-        throw new Error('not supported');
+        throw new Error('dockview: not supported');
     }
 
     get activePanel(): IDockviewPanel | undefined {
@@ -203,7 +346,7 @@ export class DockviewGroupPanelModel
 
         toggleClass(
             this.container,
-            'locked-groupview',
+            'dv-locked-groupview',
             value === 'no-drop-target' || value
         );
     }
@@ -254,7 +397,7 @@ export class DockviewGroupPanelModel
         toggleClass(this.container, 'dv-groupview-floating', false);
         toggleClass(this.container, 'dv-groupview-popout', false);
 
-        switch (value) {
+        switch (value.type) {
             case 'grid':
                 this.contentContainer.dropTarget.setTargetZones([
                     'top',
@@ -290,14 +433,16 @@ export class DockviewGroupPanelModel
 
     constructor(
         private readonly container: HTMLElement,
-        private accessor: DockviewComponent,
+        private readonly accessor: DockviewComponent,
         public id: string,
         private readonly options: GroupOptions,
         private readonly groupPanel: DockviewGroupPanel
     ) {
         super();
 
-        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);
 
@@ -314,6 +459,7 @@ export class DockviewGroupPanelModel
         this.addDisposables(
             this._onTabDragStart,
             this._onGroupDragStart,
+            this._onWillShowOverlay,
             this.tabsContainer.onTabDragStart((event) => {
                 this._onTabDragStart.fire(event);
             }),
@@ -321,81 +467,146 @@ export class DockviewGroupPanelModel
                 this._onGroupDragStart.fire(event);
             }),
             this.tabsContainer.onDrop((event) => {
-                this.handleDropEvent(event.event, 'center', event.index);
+                this.handleDropEvent(
+                    'header',
+                    event.event,
+                    'center',
+                    event.index
+                );
             }),
+
             this.contentContainer.onDidFocus(() => {
-                this.accessor.doSetGroupActive(this.groupPanel, true);
+                this.accessor.doSetGroupActive(this.groupPanel);
             }),
             this.contentContainer.onDidBlur(() => {
                 // noop
             }),
             this.contentContainer.dropTarget.onDrop((event) => {
-                this.handleDropEvent(event.nativeEvent, event.position);
+                this.handleDropEvent(
+                    'content',
+                    event.nativeEvent,
+                    event.position
+                );
+            }),
+            this.tabsContainer.onWillShowOverlay((event) => {
+                this._onWillShowOverlay.fire(event);
+            }),
+            this.contentContainer.dropTarget.onWillShowOverlay((event) => {
+                this._onWillShowOverlay.fire(
+                    new WillShowOverlayLocationEvent(event, {
+                        kind: 'content',
+                        panel: this.activePanel,
+                        api: this._api,
+                        group: this.groupPanel,
+                        getData: getPanelData,
+                    })
+                );
             }),
             this._onMove,
             this._onDidChange,
             this._onDidDrop,
+            this._onWillDrop,
             this._onDidAddPanel,
             this._onDidRemovePanel,
-            this._onDidActivePanelChange
+            this._onDidActivePanelChange,
+            this._onUnhandledDragOverEvent,
+            this._onDidPanelTitleChange,
+            this._onDidPanelParametersChange
+        );
+    }
+
+    focusContent(): void {
+        this.contentContainer.element.focus();
+    }
+
+    set renderContainer(value: OverlayRenderContainer | null) {
+        this.panels.forEach((panel) => {
+            this.renderContainer.detatch(panel);
+        });
+
+        this._overwriteRenderContainer = value;
+
+        this.panels.forEach((panel) => {
+            this.rerender(panel);
+        });
+    }
+
+    get renderContainer(): OverlayRenderContainer {
+        return (
+            this._overwriteRenderContainer ??
+            this.accessor.overlayRenderContainer
+        );
+    }
+
+    set dropTargetContainer(value: DropTargetAnchorContainer | null) {
+        this._overwriteDropTargetContainer = value;
+    }
+
+    get dropTargetContainer(): DropTargetAnchorContainer | null {
+        return (
+            this._overwriteDropTargetContainer ??
+            this.accessor.rootDropTargetContainer
         );
     }
 
     initialize(): void {
-        if (this.options?.panels) {
+        if (this.options.panels) {
             this.options.panels.forEach((panel) => {
                 this.doAddPanel(panel);
             });
         }
 
-        if (this.options?.activePanel) {
+        if (this.options.activePanel) {
             this.openPanel(this.options.activePanel);
         }
 
         // must be run after the constructor otherwise this.parent may not be
         // correctly initialized
-        this.setActive(this.isActive, true, true);
+        this.setActive(this.isActive, true);
         this.updateContainer();
 
-        if (this.accessor.options.createRightHeaderActionsElement) {
+        if (this.accessor.options.createRightHeaderActionComponent) {
             this._rightHeaderActions =
-                this.accessor.options.createRightHeaderActionsElement(
+                this.accessor.options.createRightHeaderActionComponent(
                     this.groupPanel
                 );
             this.addDisposables(this._rightHeaderActions);
             this._rightHeaderActions.init({
-                containerApi: new DockviewApi(this.accessor),
+                containerApi: this._api,
                 api: this.groupPanel.api,
+                group: this.groupPanel,
             });
             this.tabsContainer.setRightActionsElement(
                 this._rightHeaderActions.element
             );
         }
 
-        if (this.accessor.options.createLeftHeaderActionsElement) {
+        if (this.accessor.options.createLeftHeaderActionComponent) {
             this._leftHeaderActions =
-                this.accessor.options.createLeftHeaderActionsElement(
+                this.accessor.options.createLeftHeaderActionComponent(
                     this.groupPanel
                 );
             this.addDisposables(this._leftHeaderActions);
             this._leftHeaderActions.init({
-                containerApi: new DockviewApi(this.accessor),
+                containerApi: this._api,
                 api: this.groupPanel.api,
+                group: this.groupPanel,
             });
             this.tabsContainer.setLeftActionsElement(
                 this._leftHeaderActions.element
             );
         }
 
-        if (this.accessor.options.createPrefixHeaderActionsElement) {
+        if (this.accessor.options.createPrefixHeaderActionComponent) {
             this._prefixHeaderActions =
-                this.accessor.options.createPrefixHeaderActionsElement(
+                this.accessor.options.createPrefixHeaderActionComponent(
                     this.groupPanel
                 );
             this.addDisposables(this._prefixHeaderActions);
             this._prefixHeaderActions.init({
-                containerApi: new DockviewApi(this.accessor),
+                containerApi: this._api,
                 api: this.groupPanel.api,
+                group: this.groupPanel,
             });
             this.tabsContainer.setPrefixActionsElement(
                 this._prefixHeaderActions.element
@@ -498,18 +709,24 @@ export class DockviewGroupPanelModel
     }
 
     focus(): void {
-        this._activePanel?.focus?.();
+        this._activePanel?.focus();
     }
 
     public openPanel(
         panel: IDockviewPanel,
         options: {
             index?: number;
-            skipFocus?: boolean;
-            skipSetPanelActive?: boolean;
+            skipSetActive?: boolean;
             skipSetGroupActive?: boolean;
         } = {}
     ): void {
+        /**
+         * set the panel group
+         * add the panel
+         * check if group active
+         * check if panel active
+         */
+
         if (
             typeof options.index !== 'number' ||
             options.index > this.panels.length
@@ -517,36 +734,44 @@ export class DockviewGroupPanelModel
             options.index = this.panels.length;
         }
 
-        const skipSetPanelActive = !!options.skipSetPanelActive;
-        const skipSetGroupActive = !!options.skipSetGroupActive;
+        const skipSetActive = !!options.skipSetActive;
 
         // ensure the group is updated before we fire any events
-        panel.updateParentGroup(this.groupPanel, true);
+        panel.updateParentGroup(this.groupPanel, {
+            skipSetActive: options.skipSetActive,
+        });
+
+        this.doAddPanel(panel, options.index, {
+            skipSetActive: skipSetActive,
+        });
 
         if (this._activePanel === panel) {
-            if (!skipSetGroupActive) {
-                this.accessor.doSetGroupActive(this.groupPanel);
-            }
+            this.contentContainer.renderPanel(panel, { asActive: true });
             return;
         }
 
-        this.doAddPanel(panel, options.index, skipSetPanelActive);
-
-        if (!skipSetPanelActive) {
+        if (!skipSetActive) {
             this.doSetActivePanel(panel);
         }
 
-        if (!skipSetGroupActive) {
-            this.accessor.doSetGroupActive(
-                this.groupPanel,
-                !!options.skipFocus
-            );
+        if (!options.skipSetGroupActive) {
+            this.accessor.doSetGroupActive(this.groupPanel);
         }
 
-        this.updateContainer();
+        if (!options.skipSetActive) {
+            this.updateContainer();
+        }
     }
 
-    public removePanel(groupItemOrId: IDockviewPanel | string): IDockviewPanel {
+    public removePanel(
+        groupItemOrId: IDockviewPanel | string,
+        options: {
+            skipSetActive?: boolean;
+            skipSetActiveGroup?: boolean;
+        } = {
+            skipSetActive: false,
+        }
+    ): IDockviewPanel {
         const id =
             typeof groupItemOrId === 'string'
                 ? groupItemOrId
@@ -558,7 +783,7 @@ export class DockviewGroupPanelModel
             throw new Error('invalid operation');
         }
 
-        return this._removePanel(panelToRemove);
+        return this._removePanel(panelToRemove, options);
     }
 
     public closeAllPanels(): void {
@@ -578,7 +803,15 @@ export class DockviewGroupPanelModel
     }
 
     private doClose(panel: IDockviewPanel): void {
-        this.accessor.removePanel(panel);
+        const isLast =
+            this.panels.length === 1 && this.accessor.groups.length === 1;
+
+        this.accessor.removePanel(
+            panel,
+            isLast && this.accessor.options.noPanelsOverlay === 'emptyGroup'
+                ? { removeEmptyGroup: false }
+                : undefined
+        );
     }
 
     public isPanelActive(panel: IDockviewPanel): boolean {
@@ -589,22 +822,15 @@ export class DockviewGroupPanelModel
         this.tabsContainer.setRightActionsElement(element);
     }
 
-    public setActive(
-        isGroupActive: boolean,
-        skipFocus = false,
-        force = false
-    ): void {
+    public setActive(isGroupActive: boolean, force = false): void {
         if (!force && this.isActive === isGroupActive) {
-            if (!skipFocus) {
-                this._activePanel?.focus?.();
-            }
             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);
 
@@ -613,12 +839,6 @@ export class DockviewGroupPanelModel
         }
 
         this.updateContainer();
-
-        if (isGroupActive) {
-            if (!skipFocus) {
-                this._activePanel?.focus?.();
-            }
-        }
     }
 
     public layout(width: number, height: number): void {
@@ -632,21 +852,33 @@ export class DockviewGroupPanelModel
         }
     }
 
-    private _removePanel(panel: IDockviewPanel): IDockviewPanel {
+    private _removePanel(
+        panel: IDockviewPanel,
+        options: {
+            skipSetActive?: boolean;
+            skipSetActiveGroup?: boolean;
+        }
+    ): IDockviewPanel {
         const isActivePanel = this._activePanel === panel;
 
         this.doRemovePanel(panel);
 
         if (isActivePanel && this.panels.length > 0) {
             const nextPanel = this.mostRecentlyUsed[0];
-            this.openPanel(nextPanel);
+            this.openPanel(nextPanel, {
+                skipSetActive: options.skipSetActive,
+                skipSetGroupActive: options.skipSetActiveGroup,
+            });
         }
 
         if (this._activePanel && this.panels.length === 0) {
             this.doSetActivePanel(undefined);
         }
 
-        this.updateContainer();
+        if (!options.skipSetActive) {
+            this.updateContainer();
+        }
+
         return panel;
     }
 
@@ -661,10 +893,14 @@ export class DockviewGroupPanelModel
         this._panels.splice(index, 1);
 
         if (this.mostRecentlyUsed.includes(panel)) {
-            this.mostRecentlyUsed.splice(
-                this.mostRecentlyUsed.indexOf(panel),
-                1
-            );
+            const index = this.mostRecentlyUsed.indexOf(panel);
+            this.mostRecentlyUsed.splice(index, 1);
+        }
+
+        const disposable = this._panelDisposables.get(panel.id);
+        if (disposable) {
+            disposable.dispose();
+            this._panelDisposables.delete(panel.id);
         }
 
         this._onDidRemovePanel.fire({ panel });
@@ -673,7 +909,9 @@ export class DockviewGroupPanelModel
     private doAddPanel(
         panel: IDockviewPanel,
         index: number = this.panels.length,
-        skipSetActive = false
+        options: {
+            skipSetActive: boolean;
+        } = { skipSetActive: false }
     ): void {
         const existingPanel = this._panels.indexOf(panel);
         const hasExistingPanel = existingPanel > -1;
@@ -683,7 +921,7 @@ export class DockviewGroupPanelModel
 
         this.tabsContainer.openPanel(panel, index);
 
-        if (!skipSetActive) {
+        if (!options.skipSetActive) {
             this.contentContainer.openPanel(panel);
         }
 
@@ -695,10 +933,26 @@ export class DockviewGroupPanelModel
         this.updateMru(panel);
         this.panels.splice(index, 0, panel);
 
+        this._panelDisposables.set(
+            panel.id,
+            new CompositeDisposable(
+                panel.api.onDidTitleChange((event) =>
+                    this._onDidPanelTitleChange.fire(event)
+                ),
+                panel.api.onDidParametersChange((event) =>
+                    this._onDidPanelParametersChange.fire(event)
+                )
+            )
+        );
+
         this._onDidAddPanel.fire({ panel });
     }
 
     private doSetActivePanel(panel: IDockviewPanel | undefined): void {
+        if (this._activePanel === panel) {
+            return;
+        }
+
         this._activePanel = panel;
 
         if (panel) {
@@ -708,7 +962,9 @@ export class DockviewGroupPanelModel
 
             this.updateMru(panel);
 
-            this._onDidActivePanelChange.fire({ panel });
+            this._onDidActivePanelChange.fire({
+                panel,
+            });
         }
     }
 
@@ -723,58 +979,51 @@ export class DockviewGroupPanelModel
     }
 
     private updateContainer(): void {
-        toggleClass(this.container, 'empty', this.isEmpty);
-
-        this.panels.forEach((panel) =>
-            panel.updateParentGroup(this.groupPanel, this.isActive)
-        );
+        this.panels.forEach((panel) => panel.runEvents());
 
         if (this.isEmpty && !this.watermark) {
             const watermark = this.accessor.createWatermarkComponent();
             watermark.init({
-                containerApi: new DockviewApi(this.accessor),
+                containerApi: this._api,
                 group: this.groupPanel,
             });
             this.watermark = watermark;
 
-            addDisposableListener(this.watermark.element, 'click', () => {
+            addDisposableListener(this.watermark.element, 'pointerdown', () => {
                 if (!this.isActive) {
                     this.accessor.doSetGroupActive(this.groupPanel);
                 }
             });
 
-            this.tabsContainer.hide();
             this.contentContainer.element.appendChild(this.watermark.element);
-
-            this.watermark.updateParentGroup(this.groupPanel, true);
         }
         if (!this.isEmpty && this.watermark) {
             this.watermark.element.remove();
             this.watermark.dispose?.();
             this.watermark = undefined;
-            this.tabsContainer.show();
         }
     }
 
     canDisplayOverlay(
         event: DragEvent,
         position: Position,
-        target: DockviewDropTargets
+        target: DockviewGroupDropLocation
     ): boolean {
-        // custom overlay handler
-        if (this.accessor.options.showDndOverlay) {
-            return this.accessor.options.showDndOverlay({
-                nativeEvent: event,
-                target,
-                group: this.accessor.getPanel(this.id)!,
-                position,
-                getData: getPanelData,
-            });
-        }
-        return false;
+        const firedEvent = new DockviewUnhandledDragOverEvent(
+            event,
+            target,
+            position,
+            getPanelData,
+            this.accessor.getPanel(this.id)
+        );
+
+        this._onUnhandledDragOverEvent.fire(firedEvent);
+
+        return firedEvent.isAccepted;
     }
 
     private handleDropEvent(
+        type: 'header' | 'content',
         event: DragEvent,
         position: Position,
         index?: number
@@ -783,9 +1032,60 @@ export class DockviewGroupPanelModel
             return;
         }
 
+        function getKind(): DockviewGroupDropLocation {
+            switch (type) {
+                case 'header':
+                    return typeof index === 'number' ? 'tab' : 'header_space';
+                case 'content':
+                    return 'content';
+            }
+        }
+
+        const panel =
+            typeof index === 'number' ? this.panels[index] : undefined;
+
+        const willDropEvent = new DockviewWillDropEvent({
+            nativeEvent: event,
+            position,
+            panel,
+            getData: () => getPanelData(),
+            kind: getKind(),
+            group: this.groupPanel,
+            api: this._api,
+        });
+
+        this._onWillDrop.fire(willDropEvent);
+
+        if (willDropEvent.defaultPrevented) {
+            return;
+        }
+
         const data = getPanelData();
 
         if (data && data.viewId === this.accessor.id) {
+            if (type === 'content') {
+                if (data.groupId === this.id) {
+                    // don't allow to drop on self for center position
+
+                    if (position === 'center') {
+                        return;
+                    }
+
+                    if (data.panelId === null) {
+                        // don't allow group move to drop anywhere on self
+                        return;
+                    }
+                }
+            }
+
+            if (type === 'header') {
+                if (data.groupId === this.id) {
+                    if (data.panelId === null) {
+                        return;
+                    }
+                }
+            }
+
             if (data.panelId === null) {
                 // this is a group move dnd event
                 const { groupId } = data;
@@ -821,12 +1121,16 @@ export class DockviewGroupPanelModel
                 index,
             });
         } else {
-            this._onDidDrop.fire({
-                nativeEvent: event,
-                position,
-                index,
-                getData: () => getPanelData(),
-            });
+            this._onDidDrop.fire(
+                new DockviewDidDropEvent({
+                    nativeEvent: event,
+                    position,
+                    panel,
+                    getData: () => getPanelData(),
+                    group: this.groupPanel,
+                    api: this._api,
+                })
+            );
         }
     }
 
@@ -835,6 +1139,7 @@ export class DockviewGroupPanelModel
 
         this.watermark?.element.remove();
         this.watermark?.dispose?.();
+        this.watermark = undefined;
 
         for (const panel of this.panels) {
             panel.dispose();

packages/dockview-core/src/dockview/dockviewPanel.ts

@@ -9,7 +9,9 @@ import { CompositeDisposable, IDisposable } from '../lifecycle';
 import { IPanel, PanelUpdateEvent, Parameters } from '../panel/types';
 import { IDockviewPanelModel } from './dockviewPanelModel';
 import { DockviewComponent } from './dockviewComponent';
-import { DockviewPanelRenderer } from '../overlayRenderContainer';
+import { DockviewPanelRenderer } from '../overlay/overlayRenderContainer';
+import { WillFocusEvent } from '../api/panelApi';
+import { Contraints } from '../gridview/gridviewPanel';
 
 export interface IDockviewPanel extends IDisposable, IPanel {
     readonly view: IDockviewPanelModel;
@@ -17,11 +19,19 @@ export interface IDockviewPanel extends IDisposable, IPanel {
     readonly api: DockviewPanelApi;
     readonly title: string | undefined;
     readonly params: Parameters | undefined;
-    updateParentGroup(group: DockviewGroupPanel, isGroupActive: boolean): void;
+    readonly minimumWidth?: number;
+    readonly minimumHeight?: number;
+    readonly maximumWidth?: number;
+    readonly maximumHeight?: number;
+    updateParentGroup(
+        group: DockviewGroupPanel,
+        options?: { skipSetActive?: boolean }
+    ): void;
     init(params: IGroupPanelInitParameters): void;
     toJSON(): GroupviewPanelState;
     setTitle(title: string): void;
     update(event: PanelUpdateEvent): void;
+    runEvents(): void;
 }
 
 export class DockviewPanel
@@ -35,6 +45,11 @@ export class DockviewPanel
     private _title: string | undefined;
     private _renderer: DockviewPanelRenderer | undefined;
 
+    private readonly _minimumWidth: number | undefined;
+    private readonly _minimumHeight: number | undefined;
+    private readonly _maximumWidth: number | undefined;
+    private readonly _maximumHeight: number | undefined;
+
     get params(): Parameters | undefined {
         return this._params;
     }
@@ -51,19 +66,47 @@ export class DockviewPanel
         return this._renderer ?? this.accessor.renderer;
     }
 
+    get minimumWidth(): number | undefined {
+        return this._minimumWidth;
+    }
+
+    get minimumHeight(): number | undefined {
+        return this._minimumHeight;
+    }
+
+    get maximumWidth(): number | undefined {
+        return this._maximumWidth;
+    }
+
+    get maximumHeight(): number | undefined {
+        return this._maximumHeight;
+    }
+
     constructor(
         public readonly id: string,
+        component: string,
+        tabComponent: string | undefined,
         private readonly accessor: DockviewComponent,
         private readonly containerApi: DockviewApi,
         group: DockviewGroupPanel,
         readonly view: IDockviewPanelModel,
-        options: { renderer?: DockviewPanelRenderer }
+        options: { renderer?: DockviewPanelRenderer } & Partial<Contraints>
     ) {
         super();
         this._renderer = options.renderer;
         this._group = group;
+        this._minimumWidth = options.minimumWidth;
+        this._minimumHeight = options.minimumHeight;
+        this._maximumWidth = options.maximumWidth;
+        this._maximumHeight = options.maximumHeight;
 
-        this.api = new DockviewPanelApiImpl(this, this._group, accessor);
+        this.api = new DockviewPanelApiImpl(
+            this,
+            this._group,
+            accessor,
+            component,
+            tabComponent
+        );
 
         this.addDisposables(
             this.api.onActiveChange(() => {
@@ -74,7 +117,7 @@ export class DockviewPanel
                 // 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);
             })
         );
@@ -93,7 +136,16 @@ export class DockviewPanel
     }
 
     focus(): void {
-        this.api._onFocusEvent.fire();
+        const event = new WillFocusEvent();
+        this.api._onWillFocus.fire(event);
+
+        if (event.defaultPrevented) {
+            return;
+        }
+
+        if (!this.api.isActive) {
+            this.api.setActive();
+        }
     }
 
     public toJSON(): GroupviewPanelState {
@@ -107,6 +159,10 @@ export class DockviewPanel
                     : undefined,
             title: this.title,
             renderer: this._renderer,
+            minimumHeight: this._minimumHeight,
+            maximumHeight: this._maximumHeight,
+            minimumWidth: this._minimumWidth,
+            maximumWidth: this._maximumWidth,
         };
     }
 
@@ -115,13 +171,6 @@ export class DockviewPanel
 
         if (didTitleChange) {
             this._title = title;
-
-            this.view.update({
-                params: {
-                    params: this._params,
-                    title: this.title,
-                },
-            });
             this.api._onDidTitleChange.fire({ title });
         }
     }
@@ -156,37 +205,55 @@ export class DockviewPanel
 
         // update the view with the updated props
         this.view.update({
-            params: {
-                params: this._params,
-                title: this.title,
-            },
+            params: this._params,
         });
     }
 
     public updateParentGroup(
         group: DockviewGroupPanel,
-        isGroupActive: boolean
+        options?: { skipSetActive?: boolean }
     ): void {
         this._group = group;
-        this.api.group = group;
+        this.api.group = this._group;
 
         const isPanelVisible = this._group.model.isPanelActive(this);
+        const isActive = this.group.api.isActive && isPanelVisible;
 
-        this.api._onDidActiveChange.fire({
-            isActive: isGroupActive && isPanelVisible,
-        });
-        this.api._onDidVisibilityChange.fire({
-            isVisible: isPanelVisible,
-        });
+        if (!options?.skipSetActive) {
+            if (this.api.isActive !== isActive) {
+                this.api._onDidActiveChange.fire({
+                    isActive: this.group.api.isActive && isPanelVisible,
+                });
+            }
+        }
 
-        this.view.updateParentGroup(
-            this._group,
-            this._group.model.isPanelActive(this)
-        );
+        if (this.api.isVisible !== isPanelVisible) {
+            this.api._onDidVisibilityChange.fire({
+                isVisible: isPanelVisible,
+            });
+        }
+    }
+
+    runEvents(): void {
+        const isPanelVisible = this._group.model.isPanelActive(this);
+
+        const isActive = this.group.api.isActive && isPanelVisible;
+
+        if (this.api.isActive !== isActive) {
+            this.api._onDidActiveChange.fire({
+                isActive: this.group.api.isActive && isPanelVisible,
+            });
+        }
+
+        if (this.api.isVisible !== isPanelVisible) {
+            this.api._onDidVisibilityChange.fire({
+                isVisible: isPanelVisible,
+            });
+        }
     }
 
     public layout(width: number, height: number): void {
-        // the obtain the correct dimensions of the content panel we must deduct the tab height
+        // TODO: Can we somehow do height without header height or indicate what the header height is?
         this.api._onDidDimensionChange.fire({
             width,
             height: height,

packages/dockview-core/src/dockview/dockviewPanelModel.ts

@@ -4,29 +4,28 @@ import {
     IContentRenderer,
     ITabRenderer,
 } from './types';
-import { DockviewGroupPanel } from './dockviewGroupPanel';
 import { IDisposable } from '../lifecycle';
-import { createComponent } from '../panel/componentFactory';
 import { IDockviewComponent } from './dockviewComponent';
 import { PanelUpdateEvent } from '../panel/types';
+import { TabLocation } from './framework';
 
 export interface IDockviewPanelModel extends IDisposable {
     readonly contentComponent: string;
     readonly tabComponent?: string;
     readonly content: IContentRenderer;
-    readonly tab?: ITabRenderer;
+    readonly tab: ITabRenderer;
     update(event: PanelUpdateEvent): void;
     layout(width: number, height: number): void;
     init(params: GroupPanelPartInitParameters): void;
-    updateParentGroup(group: DockviewGroupPanel, isPanelVisible: boolean): void;
+    createTabRenderer(tabLocation: TabLocation): ITabRenderer;
 }
 
 export class DockviewPanelModel implements IDockviewPanelModel {
     private readonly _content: IContentRenderer;
     private readonly _tab: ITabRenderer;
 
-    private _group: DockviewGroupPanel | null = null;
-    private _isPanelVisible: boolean | null = null;
+    private _params: GroupPanelPartInitParameters | undefined;
+    private _updateEvent: PanelUpdateEvent | undefined;
 
     get content(): IContentRenderer {
         return this._content;
@@ -46,34 +45,23 @@ export class DockviewPanelModel implements IDockviewPanelModel {
         this._tab = this.createTabComponent(this.id, tabComponent);
     }
 
-    init(params: GroupPanelPartInitParameters): void {
-        this.content.init({ ...params, tab: this.tab });
-        this.tab.init(params);
+    createTabRenderer(tabLocation: TabLocation): ITabRenderer {
+        const cmp = this.createTabComponent(this.id, this.tabComponent);
+        if (this._params) {
+            cmp.init({ ...this._params, tabLocation });
+        }
+        if (this._updateEvent) {
+            cmp.update?.(this._updateEvent);
+        }
+
+        return cmp;
     }
 
-    updateParentGroup(
-        group: DockviewGroupPanel,
-        isPanelVisible: boolean
-    ): void {
-        if (group !== this._group) {
-            this._group = group;
-            if (this._content.onGroupChange) {
-                this._content.onGroupChange(group);
-            }
-            if (this._tab.onGroupChange) {
-                this._tab.onGroupChange(group);
-            }
-        }
+    init(params: GroupPanelPartInitParameters): void {
+        this._params = params;
 
-        if (isPanelVisible !== this._isPanelVisible) {
-            this._isPanelVisible = isPanelVisible;
-            if (this._content.onPanelVisibleChange) {
-                this._content.onPanelVisibleChange(isPanelVisible);
-            }
-            if (this._tab.onPanelVisibleChange) {
-                this._tab.onPanelVisibleChange(isPanelVisible);
-            }
-        }
+        this.content.init(params);
+        this.tab.init({ ...params, tabLocation: 'header' });
     }
 
     layout(width: number, height: number): void {
@@ -81,6 +69,8 @@ export class DockviewPanelModel implements IDockviewPanelModel {
     }
 
     update(event: PanelUpdateEvent): void {
+        this._updateEvent = event;
+
         this.content.update?.(event);
         this.tab.update?.(event);
     }
@@ -94,39 +84,37 @@ export class DockviewPanelModel implements IDockviewPanelModel {
         id: string,
         componentName: string
     ): IContentRenderer {
-        return createComponent(
+        return this.accessor.options.createComponent({
             id,
-            componentName,
-            this.accessor.options.components ?? {},
-            this.accessor.options.frameworkComponents,
-            this.accessor.options.frameworkComponentFactory?.content
-        );
+            name: componentName,
+        });
     }
 
     private createTabComponent(
         id: string,
         componentName?: string
     ): ITabRenderer {
-        if (componentName) {
-            return createComponent(
-                id,
-                componentName,
-                this.accessor.options.tabComponents,
-                this.accessor.options.frameworkTabComponents,
-                this.accessor.options.frameworkComponentFactory?.tab,
-                () => new DefaultTab()
+        const name = componentName ?? this.accessor.options.defaultTabComponent;
+
+        if (name) {
+            if (this.accessor.options.createTabComponent) {
+                const component = this.accessor.options.createTabComponent({
+                    id,
+                    name,
+                });
+
+                if (component) {
+                    return component;
+                } else {
+                    return new DefaultTab();
+                }
+            }
+
+            console.warn(
+                `dockview: tabComponent '${componentName}' was not found. falling back to the default tab.`
             );
-        } else if (this.accessor.options.defaultTabComponent) {
-            return createComponent(
-                id,
-                this.accessor.options.defaultTabComponent,
-                this.accessor.options.tabComponents,
-                this.accessor.options.frameworkTabComponents,
-                this.accessor.options.frameworkComponentFactory?.tab,
-                () => new DefaultTab()
-            );
-        } else {
-            return new DefaultTab();
         }
+
+        return new DefaultTab();
     }
 }