dockview-core 7.0.4 → 8.0.0

package/dist/cjs/dockview/liveRegionService.js

@@ -1,185 +0,0 @@
-"use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LiveRegionModule = exports.LiveRegionService = void 0;
-var lifecycle_1 = require("../lifecycle");
-var accessibilityMessages_1 = require("./accessibilityMessages");
-var modules_1 = require("./modules");
-/** Bulk transactions whose per-panel events should not each be announced. */
-var isBulk = function (kind) {
-    return kind === 'load' || kind === 'clear';
-};
-function createLiveRegion(politeness) {
-    var el = document.createElement('div');
-    el.className =
-        politeness === 'assertive'
-            ? 'dv-live-region-assertive'
-            : 'dv-live-region';
-    // assertive interrupts the SR (errors / cancellations); polite waits for a
-    // pause (routine status). `alert` implies assertive, `status` implies polite.
-    el.setAttribute('role', politeness === 'assertive' ? 'alert' : 'status');
-    el.setAttribute('aria-live', politeness);
-    el.setAttribute('aria-atomic', 'true');
-    // Visually hidden but kept in the accessibility tree (never display:none /
-    // visibility:hidden, which would drop it from AT). Standard clip pattern.
-    Object.assign(el.style, {
-        position: 'absolute',
-        width: '1px',
-        height: '1px',
-        margin: '-1px',
-        padding: '0',
-        overflow: 'hidden',
-        clip: 'rect(0 0 0 0)',
-        clipPath: 'inset(50%)',
-        whiteSpace: 'nowrap',
-        border: '0',
-    });
-    return el;
-}
-/**
- * Narrates layout state changes to screen readers via visually-hidden
- * `aria-live` regions. Free / core (WCAG 4.1.3). Announces panel open/close +
- * the shared `announce()` sink (the accessibility module narrates docking here too).
- * Two regions: a **polite** one for routine status and an **assertive** one
- * for errors/cancellations. The bulk load/clear burst is suppressed via the
- * mutation-transaction events, and an app can take over delivery entirely with
- * the `announcer` option.
- */
-var LiveRegionService = /** @class */ (function (_super) {
-    __extends(LiveRegionService, _super);
-    function LiveRegionService(host) {
-        var _this = _super.call(this) || this;
-        _this._suppressDepth = 0;
-        _this._locationSubs = new Map();
-        _this._host = host;
-        _this._polite = createLiveRegion('polite');
-        _this._assertive = createLiveRegion('assertive');
-        host.element.appendChild(_this._polite);
-        host.element.appendChild(_this._assertive);
-        _this.addDisposables({ dispose: function () { return _this._polite.remove(); } }, { dispose: function () { return _this._assertive.remove(); } }, host.onDidAddPanel(function (panel) { return _this._announce(panel, 'open'); }), host.onDidRemovePanel(function (panel) { return _this._announce(panel, 'close'); }), 
-        // Bracket bulk transactions so a fromJSON / clear doesn't announce
-        // every nested add/remove.
-        host.onWillMutateLayout(function (e) {
-            if (isBulk(e.kind)) {
-                _this._suppressDepth++;
-            }
-        }), host.onDidMutateLayout(function (e) {
-            if (isBulk(e.kind)) {
-                _this._suppressDepth = Math.max(0, _this._suppressDepth - 1);
-            }
-        }), host.onDidMaximizedGroupChange(function (e) {
-            var panel = e.group.activePanel;
-            if (panel) {
-                _this._announce(panel, e.isMaximized ? 'maximize' : 'restore');
-            }
-        }), 
-        // Narrate a group floating / docking back / popping out. A group is
-        // born in the grid then transitions, so track each group's previous
-        // location and ignore the no-op initial `-> grid`.
-        host.onDidAddGroup(function (group) { return _this._trackLocation(group); }), host.onDidRemoveGroup(function (group) {
-            var _a;
-            (_a = _this._locationSubs.get(group.id)) === null || _a === void 0 ? void 0 : _a.dispose();
-            _this._locationSubs.delete(group.id);
-        }), {
-            dispose: function () {
-                _this._locationSubs.forEach(function (sub) { return sub.dispose(); });
-                _this._locationSubs.clear();
-            },
-        });
-        return _this;
-    }
-    LiveRegionService.prototype._trackLocation = function (group) {
-        var _this = this;
-        var prev = group.api.location.type;
-        var sub = group.api.onDidLocationChange(function (e) {
-            var next = e.location.type;
-            if (next === prev) {
-                return;
-            }
-            prev = next;
-            var panel = group.activePanel;
-            if (!panel) {
-                return;
-            }
-            var kind = next === 'floating'
-                ? 'float'
-                : next === 'popout'
-                    ? 'popout'
-                    : 'dock';
-            _this._announce(panel, kind);
-        });
-        this._locationSubs.set(group.id, sub);
-    };
-    LiveRegionService.prototype.announce = function (message, politeness) {
-        if (politeness === void 0) { politeness = 'polite'; }
-        // Opt-out (read live so `updateOptions({ announcements })` applies).
-        if (this._host.options.announcements === false ||
-            this._suppressDepth > 0 ||
-            !message) {
-            return;
-        }
-        // Apps can route announcements into their own SR system instead of the
-        // built-in regions (e.g. a shared app-wide live region).
-        var announcer = this._host.options.announcer;
-        if (announcer) {
-            announcer({ message: message, politeness: politeness });
-            return;
-        }
-        // Clearing first forces SRs to re-announce an identical message.
-        var region = politeness === 'assertive' ? this._assertive : this._polite;
-        region.textContent = '';
-        region.textContent = message;
-    };
-    LiveRegionService.prototype._announce = function (panel, kind) {
-        var _a, _b;
-        // The app may localise/override the message, suppress it (null / ''),
-        // or fall through to the default (undefined).
-        var custom = (_b = (_a = this._host.options).getAnnouncement) === null || _b === void 0 ? void 0 : _b.call(_a, { kind: kind, panel: panel });
-        if (custom === null || custom === '') {
-            return;
-        }
-        this.announce(custom !== null && custom !== void 0 ? custom : this._defaultMessage(panel, kind));
-    };
-    LiveRegionService.prototype._defaultMessage = function (panel, kind) {
-        var _a;
-        var m = (0, accessibilityMessages_1.resolveMessages)(this._host.options.messages);
-        var name = (_a = panel.title) !== null && _a !== void 0 ? _a : panel.id;
-        switch (kind) {
-            case 'open':
-                return m.panelOpened(name);
-            case 'close':
-                return m.panelClosed(name);
-            case 'maximize':
-                return m.groupMaximized(name);
-            case 'restore':
-                return m.groupRestored(name);
-            case 'float':
-                return m.groupFloated(name);
-            case 'dock':
-                return m.groupDocked(name);
-            case 'popout':
-                return m.groupPoppedOut(name);
-        }
-    };
-    return LiveRegionService;
-}(lifecycle_1.CompositeDisposable));
-exports.LiveRegionService = LiveRegionService;
-exports.LiveRegionModule = (0, modules_1.defineModule)({
-    name: 'LiveRegion',
-    serviceKey: 'liveRegionService',
-    create: function (host) { return new LiveRegionService(host); },
-});

package/dist/cjs/dockview/moduleContracts.js

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

package/dist/cjs/dockview/modules.js

@@ -1,304 +0,0 @@
-"use strict";
-/**
- * Internal module system for dockview.
- *
- * Modules are feature bundles that register services into the dockview
- * component. `registerModules(...)` is the one public entry point — it lets a
- * sibling package contribute modules that `DockviewComponent` picks up at
- * construction. The richer opt-in surface (a per-component `modules` option,
- * framework wrappers) is still reserved for a future version; the module
- * authoring API (`defineModule`, the service contracts) remains internal.
- */
-var __values = (this && this.__values) || function(o) {
-    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
-    if (m) return m.call(o);
-    if (o && typeof o.length === "number") return {
-        next: function () {
-            if (o && i >= o.length) o = void 0;
-            return { value: o && o[i++], done: !o };
-        }
-    };
-    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
-};
-var __read = (this && this.__read) || function (o, n) {
-    var m = typeof Symbol === "function" && o[Symbol.iterator];
-    if (!m) return o;
-    var i = m.call(o), r, ar = [], e;
-    try {
-        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
-    }
-    catch (error) { e = { error: error }; }
-    finally {
-        try {
-            if (r && !r.done && (m = i["return"])) m.call(i);
-        }
-        finally { if (e) throw e.error; }
-    }
-    return ar;
-};
-var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
-    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
-        if (ar || !(i in from)) {
-            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
-            ar[i] = from[i];
-        }
-    }
-    return to.concat(ar || Array.prototype.slice.call(from));
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ModuleRegistry = void 0;
-exports.defineModule = defineModule;
-exports._resetMissingModuleWarnings = _resetMissingModuleWarnings;
-exports.assertModule = assertModule;
-exports.registerModules = registerModules;
-exports.getRegisteredModules = getRegisteredModules;
-exports.clearRegisteredModules = clearRegisteredModules;
-exports.markDockviewPackageLoaded = markDockviewPackageLoaded;
-exports.isDockviewPackageLoaded = isDockviewPackageLoaded;
-/**
- * Typed helper for defining a module. Enforces that the factory's return
- * type matches the slot in ServiceCollection at compile time, replacing
- * the manual cast each module file would otherwise need.
- */
-function defineModule(config) {
-    var _a;
-    return {
-        moduleName: config.name,
-        services: (_a = {},
-            _a[config.serviceKey] = config.create,
-            _a),
-        init: config.init
-            ? function (host, services) {
-                return config.init(host, services[config.serviceKey]);
-            }
-            : undefined,
-        dependsOn: config.dependsOn,
-    };
-}
-var _warnedMissingModule = new Set();
-/**
- * For tests — clears the once-per-key dedup cache used by `assertModule`.
- */
-function _resetMissingModuleWarnings() {
-    _warnedMissingModule.clear();
-}
-/**
- * Returns the service if its module is registered, otherwise logs a
- * deduplicated console error and returns `undefined`. Modelled on AG Grid's
- * `assertModuleRegistered`: missing modules never throw — they degrade the
- * affected feature to a no-op so consuming applications don't crash in
- * production.
- *
- * Use at public-API entry points where the caller wants to surface which
- * module is missing. For internal/lifecycle paths, plain `?.` chaining on
- * the service slot is preferred — no log, just a silent no-op.
- */
-function assertModule(service, moduleName, context) {
-    if (service !== undefined) {
-        return service;
-    }
-    var key = "".concat(moduleName, "|").concat(context !== null && context !== void 0 ? context : '');
-    if (_warnedMissingModule.has(key)) {
-        return undefined;
-    }
-    _warnedMissingModule.add(key);
-    var where = context ? " for ".concat(context) : '';
-    // eslint-disable-next-line no-console
-    console.error("dockview: module \"".concat(moduleName, "\" is not registered").concat(where, "."));
-    return undefined;
-}
-var ModuleRegistry = /** @class */ (function () {
-    function ModuleRegistry() {
-        this._modules = new Map();
-        this._services = {};
-        this._initDisposables = [];
-    }
-    Object.defineProperty(ModuleRegistry.prototype, "services", {
-        get: function () {
-            return this._services;
-        },
-        enumerable: false,
-        configurable: true
-    });
-    ModuleRegistry.prototype.register = function (module) {
-        var e_1, _a;
-        if (this._modules.has(module.moduleName)) {
-            return;
-        }
-        if (module.dependsOn) {
-            try {
-                for (var _b = __values(module.dependsOn), _c = _b.next(); !_c.done; _c = _b.next()) {
-                    var dep = _c.value;
-                    this.register(dep);
-                }
-            }
-            catch (e_1_1) { e_1 = { error: e_1_1 }; }
-            finally {
-                try {
-                    if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-                }
-                finally { if (e_1) throw e_1.error; }
-            }
-        }
-        this._modules.set(module.moduleName, module);
-    };
-    ModuleRegistry.prototype.initialize = function (host) {
-        var e_2, _a, e_3, _b;
-        try {
-            for (var _c = __values(this._modules.values()), _d = _c.next(); !_d.done; _d = _c.next()) {
-                var module_1 = _d.value;
-                if (!module_1.services) {
-                    continue;
-                }
-                try {
-                    for (var _e = (e_3 = void 0, __values(Object.entries(module_1.services))), _f = _e.next(); !_f.done; _f = _e.next()) {
-                        var _g = __read(_f.value, 2), name_1 = _g[0], factory = _g[1];
-                        this._services[name_1] = factory(host);
-                    }
-                }
-                catch (e_3_1) { e_3 = { error: e_3_1 }; }
-                finally {
-                    try {
-                        if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
-                    }
-                    finally { if (e_3) throw e_3.error; }
-                }
-            }
-        }
-        catch (e_2_1) { e_2 = { error: e_2_1 }; }
-        finally {
-            try {
-                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
-            }
-            finally { if (e_2) throw e_2.error; }
-        }
-    };
-    ModuleRegistry.prototype.postConstruct = function (host) {
-        var e_4, _a;
-        try {
-            for (var _b = __values(this._modules.values()), _c = _b.next(); !_c.done; _c = _b.next()) {
-                var module_2 = _c.value;
-                if (module_2.init) {
-                    this._initDisposables.push(module_2.init(host, this._services));
-                }
-            }
-        }
-        catch (e_4_1) { e_4 = { error: e_4_1 }; }
-        finally {
-            try {
-                if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
-            }
-            finally { if (e_4) throw e_4.error; }
-        }
-    };
-    ModuleRegistry.prototype.has = function (moduleName) {
-        return this._modules.has(moduleName);
-    };
-    ModuleRegistry.prototype.dispose = function () {
-        var e_5, _a, e_6, _b;
-        try {
-            // Tear down init() subscriptions first so they stop firing into
-            // services that are about to be disposed.
-            for (var _c = __values(this._initDisposables), _d = _c.next(); !_d.done; _d = _c.next()) {
-                var disposable = _d.value;
-                disposable.dispose();
-            }
-        }
-        catch (e_5_1) { e_5 = { error: e_5_1 }; }
-        finally {
-            try {
-                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
-            }
-            finally { if (e_5) throw e_5.error; }
-        }
-        this._initDisposables.length = 0;
-        try {
-            for (var _e = __values(Object.values(this._services)), _f = _e.next(); !_f.done; _f = _e.next()) {
-                var service = _f.value;
-                if (service !== undefined &&
-                    typeof service.dispose === 'function') {
-                    service.dispose();
-                }
-            }
-        }
-        catch (e_6_1) { e_6 = { error: e_6_1 }; }
-        finally {
-            try {
-                if (_f && !_f.done && (_b = _e.return)) _b.call(_e);
-            }
-            finally { if (e_6) throw e_6.error; }
-        }
-    };
-    return ModuleRegistry;
-}());
-exports.ModuleRegistry = ModuleRegistry;
-/**
- * Process-global list of modules registered via {@link registerModules}.
- * `DockviewComponent` appends these to its built-in set at construction, so
- * importing a package that calls `registerModules(...)` (e.g. `dockview`)
- * makes those modules available to every component in the process —
- * modelled on AG Grid's `ModuleRegistry.registerModules`.
- */
-var _globalModules = [];
-/**
- * Register modules globally. Idempotent per `moduleName` — registering the
- * same module twice is a no-op. Intended to be called once at import time by
- * the package that bundles a given set of modules.
- */
-function registerModules(modules) {
-    var e_7, _a;
-    var _loop_1 = function (module_3) {
-        if (_globalModules.some(function (m) { return m.moduleName === module_3.moduleName; })) {
-            return "continue";
-        }
-        _globalModules.push(module_3);
-    };
-    try {
-        for (var modules_1 = __values(modules), modules_1_1 = modules_1.next(); !modules_1_1.done; modules_1_1 = modules_1.next()) {
-            var module_3 = modules_1_1.value;
-            _loop_1(module_3);
-        }
-    }
-    catch (e_7_1) { e_7 = { error: e_7_1 }; }
-    finally {
-        try {
-            if (modules_1_1 && !modules_1_1.done && (_a = modules_1.return)) _a.call(modules_1);
-        }
-        finally { if (e_7) throw e_7.error; }
-    }
-}
-/**
- * Returns the globally-registered modules (a copy). `DockviewComponent` reads
- * this to extend its built-in module set.
- */
-function getRegisteredModules() {
-    return __spreadArray([], __read(_globalModules), false);
-}
-/**
- * For tests — clears the global module registry.
- */
-function clearRegisteredModules() {
-    _globalModules.length = 0;
-}
-/**
- * This marker exists for ONE purpose: a developer warning about the v7 package
- * renames. It has no functional effect on dockview's behaviour. Following the
- * renames, `dockview-core` is internal and `dockview` is the public JavaScript
- * package; `dockview` calls {@link markDockviewPackageLoaded} on import so that
- * `dockview-core` can detect — and warn about — being used directly.
- */
-var _dockviewPackageLoaded = false;
-/**
- * Called once by the `dockview` package on import, solely so `dockview-core`
- * can warn when it is used directly (see above). Not used for anything else.
- */
-function markDockviewPackageLoaded() {
-    _dockviewPackageLoaded = true;
-}
-/**
- * Whether the `dockview` package has been loaded in this process. Used only to
- * gate the "don't use dockview-core directly" developer warning.
- */
-function isDockviewPackageLoaded() {
-    return _dockviewPackageLoaded;
-}

package/dist/cjs/dockview/options.js

@@ -1,103 +0,0 @@
-"use strict";
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROPERTY_KEYS_DOCKVIEW = exports.DockviewUnhandledDragOverEvent = void 0;
-exports.isPanelOptionsWithPanel = isPanelOptionsWithPanel;
-exports.isPanelOptionsWithGroup = isPanelOptionsWithGroup;
-exports.isGroupOptionsWithPanel = isGroupOptionsWithPanel;
-exports.isGroupOptionsWithGroup = isGroupOptionsWithGroup;
-var events_1 = require("../events");
-var DockviewUnhandledDragOverEvent = /** @class */ (function (_super) {
-    __extends(DockviewUnhandledDragOverEvent, _super);
-    function DockviewUnhandledDragOverEvent(nativeEvent, target, position, getData, group) {
-        var _this = _super.call(this) || this;
-        _this.nativeEvent = nativeEvent;
-        _this.target = target;
-        _this.position = position;
-        _this.getData = getData;
-        _this.group = group;
-        return _this;
-    }
-    return DockviewUnhandledDragOverEvent;
-}(events_1.AcceptableEvent));
-exports.DockviewUnhandledDragOverEvent = DockviewUnhandledDragOverEvent;
-exports.PROPERTY_KEYS_DOCKVIEW = (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,
-        transformFloatingGroupDrag: undefined,
-        floatingGroupDragHandle: undefined,
-        popoutUrl: undefined,
-        nonce: undefined,
-        defaultRenderer: undefined,
-        defaultHeaderPosition: undefined,
-        debug: undefined,
-        locked: undefined,
-        disableDnd: undefined,
-        dndStrategy: undefined,
-        className: undefined,
-        noPanelsOverlay: undefined,
-        dndEdges: undefined,
-        theme: undefined,
-        disableTabsOverflowList: undefined,
-        scrollbars: undefined,
-        getTabContextMenuItems: undefined,
-        getTabGroupChipContextMenuItems: undefined,
-        createTabGroupChipComponent: undefined,
-        createGroupDragGhostComponent: undefined,
-        dropOverlayModel: undefined,
-        announcements: undefined,
-        getAnnouncement: undefined,
-        announcer: undefined,
-        messages: undefined,
-        keyboardNavigation: undefined,
-        tabGroupColors: undefined,
-        tabGroupAccent: undefined,
-    };
-    return Object.keys(properties);
-})();
-function isPanelOptionsWithPanel(data) {
-    if (data.referencePanel) {
-        return true;
-    }
-    return false;
-}
-function isPanelOptionsWithGroup(data) {
-    if (data.referenceGroup) {
-        return true;
-    }
-    return false;
-}
-function isGroupOptionsWithPanel(data) {
-    if (data.referencePanel) {
-        return true;
-    }
-    return false;
-}
-function isGroupOptionsWithGroup(data) {
-    if (data.referenceGroup) {
-        return true;
-    }
-    return false;
-}