dockview-core 1.12.0 → 1.13.0

package/dist/cjs/dockview/dockviewPanelModel.js

@@ -1,19 +1,7 @@
 "use strict";
-var __assign = (this && this.__assign) || function () {
-    __assign = Object.assign || function(t) {
-        for (var s, i = 1, n = arguments.length; i < n; i++) {
-            s = arguments[i];
-            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
-                t[p] = s[p];
-        }
-        return t;
-    };
-    return __assign.apply(this, arguments);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DockviewPanelModel = void 0;
 var defaultTab_1 = require("./components/tab/defaultTab");
-var componentFactory_1 = require("../panel/componentFactory");
 var DockviewPanelModel = /** @class */ (function () {
     function DockviewPanelModel(accessor, id, contentComponent, tabComponent) {
         this.accessor = accessor;
@@ -38,7 +26,7 @@ var DockviewPanelModel = /** @class */ (function () {
         configurable: true
     });
     DockviewPanelModel.prototype.init = function (params) {
-        this.content.init(__assign(__assign({}, params), { tab: this.tab }));
+        this.content.init(params);
         this.tab.init(params);
     };
     DockviewPanelModel.prototype.updateParentGroup = function (_group, _isPanelVisible) {
@@ -59,20 +47,29 @@ var DockviewPanelModel = /** @class */ (function () {
         (_d = (_c = this.tab).dispose) === null || _d === void 0 ? void 0 : _d.call(_c);
     };
     DockviewPanelModel.prototype.createContentComponent = function (id, componentName) {
-        var _a, _b;
-        return (0, componentFactory_1.createComponent)(id, componentName, (_a = this.accessor.options.components) !== null && _a !== void 0 ? _a : {}, this.accessor.options.frameworkComponents, (_b = this.accessor.options.frameworkComponentFactory) === null || _b === void 0 ? void 0 : _b.content);
+        return this.accessor.options.createComponent({
+            id: id,
+            name: componentName,
+        });
     };
     DockviewPanelModel.prototype.createTabComponent = function (id, componentName) {
-        var _a, _b;
-        if (componentName) {
-            return (0, componentFactory_1.createComponent)(id, componentName, this.accessor.options.tabComponents, this.accessor.options.frameworkTabComponents, (_a = this.accessor.options.frameworkComponentFactory) === null || _a === void 0 ? void 0 : _a.tab, function () { return new defaultTab_1.DefaultTab(); });
-        }
-        else if (this.accessor.options.defaultTabComponent) {
-            return (0, componentFactory_1.createComponent)(id, this.accessor.options.defaultTabComponent, this.accessor.options.tabComponents, this.accessor.options.frameworkTabComponents, (_b = this.accessor.options.frameworkComponentFactory) === null || _b === void 0 ? void 0 : _b.tab, function () { return new defaultTab_1.DefaultTab(); });
-        }
-        else {
-            return new defaultTab_1.DefaultTab();
+        var name = componentName !== null && componentName !== void 0 ? componentName : this.accessor.options.defaultTabComponent;
+        if (name) {
+            if (this.accessor.options.createTabComponent) {
+                var component = this.accessor.options.createTabComponent({
+                    id: id,
+                    name: name,
+                });
+                if (component) {
+                    return component;
+                }
+                else {
+                    return new defaultTab_1.DefaultTab();
+                }
+            }
+            console.warn("dockview: tabComponent '".concat(componentName, "' was not found. falling back to the default tab."));
         }
+        return new defaultTab_1.DefaultTab();
     };
     return DockviewPanelModel;
 }());

package/dist/cjs/dockview/framework.d.ts

@@ -0,0 +1,38 @@
+import { DockviewApi } from '../api/component.api';
+import { DockviewGroupPanelApi } from '../api/dockviewGroupPanelApi';
+import { DockviewPanelApi } from '../api/dockviewPanelApi';
+import { PanelParameters } from '../framwork';
+import { DockviewGroupPanel, IDockviewGroupPanel } from './dockviewGroupPanel';
+import { IDockviewPanel } from './dockviewPanel';
+export interface IGroupPanelBaseProps<T extends {
+    [index: string]: any;
+} = any> extends PanelParameters<T> {
+    api: DockviewPanelApi;
+    containerApi: DockviewApi;
+}
+export type IDockviewPanelHeaderProps<T extends {
+    [index: string]: any;
+} = any> = IGroupPanelBaseProps<T>;
+export type IDockviewPanelProps<T extends {
+    [index: string]: any;
+} = any> = IGroupPanelBaseProps<T>;
+export interface IDockviewHeaderActionsProps {
+    api: DockviewGroupPanelApi;
+    containerApi: DockviewApi;
+    panels: IDockviewPanel[];
+    activePanel: IDockviewPanel | undefined;
+    isGroupActive: boolean;
+    group: DockviewGroupPanel;
+}
+export interface IGroupHeaderProps {
+    api: DockviewGroupPanelApi;
+    containerApi: DockviewApi;
+    group: IDockviewGroupPanel;
+}
+export interface IWatermarkPanelProps {
+    containerApi: DockviewApi;
+    group?: IDockviewGroupPanel;
+}
+export interface DockviewReadyEvent {
+    api: DockviewApi;
+}

package/dist/cjs/dockview/framework.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/dockview/options.d.ts

@@ -1,74 +1,33 @@
 import { DockviewApi } from '../api/component.api';
 import { Direction } from '../gridview/baseComponentGridview';
 import { IGridView } from '../gridview/gridview';
-import { IContentRenderer, ITabRenderer, WatermarkConstructor, IWatermarkRenderer } from './types';
+import { IContentRenderer, ITabRenderer, IWatermarkRenderer } from './types';
 import { Parameters } from '../panel/types';
 import { DockviewGroupPanel } from './dockviewGroupPanel';
-import { ISplitviewStyles, Orientation } from '../splitview/splitview';
 import { PanelTransfer } from '../dnd/dataTransfer';
 import { IDisposable } from '../lifecycle';
 import { DroptargetOverlayModel, Position } from '../dnd/droptarget';
 import { DockviewGroupDropLocation, GroupOptions } from './dockviewGroupPanelModel';
 import { IDockviewPanel } from './dockviewPanel';
-import { ComponentConstructor, FrameworkFactory } from '../panel/componentFactory';
-import { DockviewGroupPanelApi } from '../api/dockviewGroupPanelApi';
 import { DockviewPanelRenderer } from '../overlayRenderContainer';
+import { IGroupHeaderProps } from './framework';
 export interface IHeaderActionsRenderer extends IDisposable {
     readonly element: HTMLElement;
-    init(params: {
-        containerApi: DockviewApi;
-        api: DockviewGroupPanelApi;
-    }): void;
-}
-export interface GroupPanelFrameworkComponentFactory {
-    content: FrameworkFactory<IContentRenderer>;
-    tab: FrameworkFactory<ITabRenderer>;
-    watermark: FrameworkFactory<IWatermarkRenderer>;
+    init(params: IGroupHeaderProps): void;
 }
 export interface TabContextMenuEvent {
     event: MouseEvent;
     api: DockviewApi;
     panel: IDockviewPanel;
 }
-export interface DockviewRenderFunctions {
-    tabComponents?: {
-        [componentName: string]: ComponentConstructor<ITabRenderer>;
-    };
-    components?: {
-        [componentName: string]: ComponentConstructor<IContentRenderer>;
-    };
-    frameworkTabComponents?: {
-        [componentName: string]: any;
-    };
-    frameworkComponents?: {
-        [componentName: string]: any;
-    };
-}
 export interface ViewFactoryData {
     content: string;
     tab?: string;
 }
-export interface DockviewDndOverlayEvent {
-    nativeEvent: DragEvent;
-    target: DockviewGroupDropLocation;
-    position: Position;
-    group?: DockviewGroupPanel;
-    getData: () => PanelTransfer | undefined;
-}
-export interface DockviewComponentOptions extends DockviewRenderFunctions {
+export interface DockviewOptions {
     disableAutoResizing?: boolean;
-    watermarkComponent?: WatermarkConstructor;
-    watermarkFrameworkComponent?: any;
-    frameworkComponentFactory?: GroupPanelFrameworkComponentFactory;
-    orientation?: Orientation;
-    styles?: ISplitviewStyles;
-    defaultTabComponent?: string;
-    showDndOverlay?: (event: DockviewDndOverlayEvent) => boolean;
-    createRightHeaderActionsElement?: (group: DockviewGroupPanel) => IHeaderActionsRenderer;
-    createLeftHeaderActionsElement?: (group: DockviewGroupPanel) => IHeaderActionsRenderer;
-    createPrefixHeaderActionsElement?: (group: DockviewGroupPanel) => IHeaderActionsRenderer;
+    hideBorders?: boolean;
     singleTabMode?: 'fullwidth' | 'default';
-    parentElement: HTMLElement;
     disableFloatingGroups?: boolean;
     floatingGroupBounds?: 'boundedWithinViewport' | {
         minimumHeightWithinViewport?: number;
@@ -81,6 +40,44 @@ export interface DockviewComponentOptions extends DockviewRenderFunctions {
     locked?: boolean;
     disableDnd?: boolean;
 }
+export interface DockviewDndOverlayEvent {
+    nativeEvent: DragEvent;
+    target: DockviewGroupDropLocation;
+    position: Position;
+    group?: DockviewGroupPanel;
+    getData: () => PanelTransfer | undefined;
+    isAccepted: boolean;
+    accept(): void;
+}
+export declare class DockviewUnhandledDragOverEvent implements DockviewDndOverlayEvent {
+    readonly nativeEvent: DragEvent;
+    readonly target: DockviewGroupDropLocation;
+    readonly position: Position;
+    readonly getData: () => PanelTransfer | undefined;
+    readonly group?: DockviewGroupPanel | undefined;
+    private _isAccepted;
+    get isAccepted(): boolean;
+    constructor(nativeEvent: DragEvent, target: DockviewGroupDropLocation, position: Position, getData: () => PanelTransfer | undefined, group?: DockviewGroupPanel | undefined);
+    accept(): void;
+}
+export declare const PROPERTY_KEYS: (keyof DockviewOptions)[];
+export interface DockviewFrameworkOptions {
+    parentElement: HTMLElement;
+    defaultTabComponent?: string;
+    createRightHeaderActionComponent?: (group: DockviewGroupPanel) => IHeaderActionsRenderer;
+    createLeftHeaderActionComponent?: (group: DockviewGroupPanel) => IHeaderActionsRenderer;
+    createPrefixHeaderActionComponent?: (group: DockviewGroupPanel) => IHeaderActionsRenderer;
+    createTabComponent?: (options: {
+        id: string;
+        name: string;
+    }) => ITabRenderer | undefined;
+    createComponent: (options: {
+        id: string;
+        name: string;
+    }) => IContentRenderer;
+    createWatermarkComponent?: () => IWatermarkRenderer;
+}
+export type DockviewComponentOptions = DockviewOptions & DockviewFrameworkOptions;
 export interface PanelOptions<P extends object = Parameters> {
     component: string;
     tabComponent?: string;
@@ -118,11 +115,36 @@ type AddPanelPositionUnion = {
 type AddPanelOptionsUnion = AddPanelFloatingGroupUnion | AddPanelPositionUnion;
 export type AddPanelOptions<P extends object = Parameters> = {
     params?: P;
+    /**
+     * The unique id for the panel
+     */
     id: string;
+    /**
+     * The title for the panel which can be accessed within both the tab and component.
+     *
+     * If using the default tab renderer this title will be displayed in the tab.
+     */
     title?: string;
+    /**
+     * The id of the component renderer
+     */
     component: string;
+    /**
+     * The id of the tab componnet renderer
+     */
     tabComponent?: string;
+    /**
+     * The rendering mode of the panel.
+     *
+     * This dictates what happens to the HTML of the panel when it is hidden.
+     */
     renderer?: DockviewPanelRenderer;
+    /**
+     * If true then add the panel without setting it as the active panel.
+     *
+     * Defaults to `false` which forces newly added panels to become active.
+     */
+    inactive?: boolean;
 } & Partial<AddPanelOptionsUnion>;
 type AddGroupOptionsWithPanel = {
     referencePanel: string | IDockviewPanel;

package/dist/cjs/dockview/options.js

@@ -1,6 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isGroupOptionsWithGroup = exports.isGroupOptionsWithPanel = exports.isPanelOptionsWithGroup = exports.isPanelOptionsWithPanel = void 0;
+exports.isGroupOptionsWithGroup = exports.isGroupOptionsWithPanel = exports.isPanelOptionsWithGroup = exports.isPanelOptionsWithPanel = exports.PROPERTY_KEYS = exports.DockviewUnhandledDragOverEvent = void 0;
+var DockviewUnhandledDragOverEvent = /** @class */ (function () {
+    function DockviewUnhandledDragOverEvent(nativeEvent, target, position, getData, group) {
+        this.nativeEvent = nativeEvent;
+        this.target = target;
+        this.position = position;
+        this.getData = getData;
+        this.group = group;
+        this._isAccepted = false;
+    }
+    Object.defineProperty(DockviewUnhandledDragOverEvent.prototype, "isAccepted", {
+        get: function () {
+            return this._isAccepted;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    DockviewUnhandledDragOverEvent.prototype.accept = function () {
+        this._isAccepted = true;
+    };
+    return DockviewUnhandledDragOverEvent;
+}());
+exports.DockviewUnhandledDragOverEvent = DockviewUnhandledDragOverEvent;
+exports.PROPERTY_KEYS = (function () {
+    /**
+     * by readong the keys from an empty value object TypeScript will error
+     * when we add or remove new properties to `DockviewOptions`
+     */
+    var properties = {
+        disableAutoResizing: undefined,
+        hideBorders: undefined,
+        singleTabMode: undefined,
+        disableFloatingGroups: undefined,
+        floatingGroupBounds: undefined,
+        popoutUrl: undefined,
+        defaultRenderer: undefined,
+        debug: undefined,
+        rootOverlayModel: undefined,
+        locked: undefined,
+        disableDnd: undefined,
+    };
+    return Object.keys(properties);
+})();
 function isPanelOptionsWithPanel(data) {
     if (data.referencePanel) {
         return true;

package/dist/cjs/dockview/types.d.ts

@@ -2,7 +2,6 @@ import { IDockviewComponent } from './dockviewComponent';
 import { DockviewPanelApi } from '../api/dockviewPanelApi';
 import { PanelInitParameters, IPanel } from '../panel/types';
 import { DockviewApi } from '../api/component.api';
-import { Event } from '../events';
 import { Optional } from '../types';
 import { DockviewGroupPanel, IDockviewGroupPanel } from './dockviewGroupPanel';
 import { DockviewPanelRenderer } from '../overlayRenderContainer';
@@ -13,27 +12,22 @@ export interface GroupPanelPartInitParameters extends PanelInitParameters, Heade
     api: DockviewPanelApi;
     containerApi: DockviewApi;
 }
-export interface GroupPanelContentPartInitParameters extends GroupPanelPartInitParameters {
-    tab: ITabRenderer;
-}
 export interface WatermarkRendererInitParameters {
     containerApi: DockviewApi;
     group?: IDockviewGroupPanel;
 }
-export interface IWatermarkRenderer extends Optional<Omit<IPanel, 'id' | 'init'>, 'dispose' | 'update' | 'layout' | 'toJSON'> {
+export interface IWatermarkRenderer extends Optional<Omit<IPanel, 'id' | 'init'>, 'dispose' | 'update' | 'layout' | 'toJSON' | 'focus'> {
     readonly element: HTMLElement;
     init: (params: WatermarkRendererInitParameters) => void;
     updateParentGroup(group: DockviewGroupPanel, visible: boolean): void;
 }
-export interface ITabRenderer extends Optional<Omit<IPanel, 'id'>, 'dispose' | 'update' | 'layout' | 'toJSON'> {
+export interface ITabRenderer extends Optional<Omit<IPanel, 'id'>, 'dispose' | 'update' | 'layout' | 'toJSON' | 'focus'> {
     readonly element: HTMLElement;
     init(parameters: GroupPanelPartInitParameters): void;
 }
-export interface IContentRenderer extends Optional<Omit<IPanel, 'id'>, 'dispose' | 'update' | 'layout' | 'toJSON'> {
+export interface IContentRenderer extends Optional<Omit<IPanel, 'id'>, 'dispose' | 'update' | 'layout' | 'toJSON' | 'focus'> {
     readonly element: HTMLElement;
-    readonly onDidFocus?: Event<void>;
-    readonly onDidBlur?: Event<void>;
-    init(parameters: GroupPanelContentPartInitParameters): void;
+    init(parameters: GroupPanelPartInitParameters): void;
 }
 export interface WatermarkPartInitParameters {
     accessor: IDockviewComponent;

package/dist/cjs/framwork.d.ts

@@ -0,0 +1,4 @@
+import { Parameters } from "./panel/types";
+export interface PanelParameters<T extends {} = Parameters> {
+    params: T;
+}

package/dist/cjs/framwork.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/index.d.ts

@@ -12,14 +12,15 @@ export { SplitviewComponentOptions, PanelViewInitParameters, } from './splitview
 export * from './paneview/paneview';
 export * from './gridview/gridview';
 export { GridviewComponentOptions } from './gridview/options';
-export * from './dockview/dockviewGroupPanelModel';
 export * from './gridview/baseComponentGridview';
 export * from './paneview/draggablePaneviewPanel';
 export * from './dockview/components/panel/content';
 export * from './dockview/components/tab/tab';
+export * from './dockview/dockviewGroupPanelModel';
 export { TabDragEvent, GroupDragEvent, } from './dockview/components/titlebar/tabsContainer';
 export * from './dockview/types';
 export * from './dockview/dockviewGroupPanel';
+export { IGroupPanelBaseProps, IDockviewPanelHeaderProps, IDockviewPanelProps, IDockviewHeaderActionsProps, IGroupHeaderProps, IWatermarkPanelProps, DockviewReadyEvent, } from './dockview/framework';
 export * from './dockview/options';
 export * from './dockview/dockviewPanel';
 export * from './dockview/components/tab/defaultTab';

package/dist/cjs/index.js

@@ -31,11 +31,11 @@ __exportStar(require("./panel/componentFactory"), exports);
 __exportStar(require("./splitview/splitview"), exports);
 __exportStar(require("./paneview/paneview"), exports);
 __exportStar(require("./gridview/gridview"), exports);
-__exportStar(require("./dockview/dockviewGroupPanelModel"), exports);
 __exportStar(require("./gridview/baseComponentGridview"), exports);
 __exportStar(require("./paneview/draggablePaneviewPanel"), exports);
 __exportStar(require("./dockview/components/panel/content"), exports);
 __exportStar(require("./dockview/components/tab/tab"), exports);
+__exportStar(require("./dockview/dockviewGroupPanelModel"), exports);
 __exportStar(require("./dockview/types"), exports);
 __exportStar(require("./dockview/dockviewGroupPanel"), exports);
 __exportStar(require("./dockview/options"), exports);