@genesislcap/grid-pro 15.71.1-alpha-71cb16e4d3.0 → 15.73.0

package/dist/dts/context-menu/context-menu.d.ts

@@ -0,0 +1,69 @@
+import type { CellContextMenuEvent } from 'ag-grid-community';
+/**
+ * One entry in grid-pro's right-click menu.
+ *
+ * @public
+ */
+export interface GridProContextMenuItem {
+    name: string;
+    /** Drawn to the right of the name, for example a key combination. */
+    shortcut?: string;
+    /** Shown on hover, including while the item is disabled — say why it cannot be chosen. */
+    tooltip?: string;
+    disabled?: boolean;
+    /** Set to `true` or `false` to make the item a checkbox; leave unset for a plain item. */
+    checked?: boolean;
+    action?: () => void;
+    subMenu?: GridProContextMenuEntry[];
+}
+/**
+ * An item, or `'separator'` for a dividing line between groups of items.
+ *
+ * @public
+ */
+export type GridProContextMenuEntry = GridProContextMenuItem | 'separator';
+/**
+ * Builds the right-click menu for one cell. Return an empty list to show the browser's menu.
+ *
+ * @public
+ */
+export type GridProContextMenuItems = (event: CellContextMenuEvent) => GridProContextMenuEntry[];
+/**
+ * A CSV Export item, using AG Grid's community CSV export. Assign it to `contextMenuItems` as the
+ * whole menu, or spread its result into a menu of your own. Empty when the grid sets
+ * `suppressCsvExport`.
+ *
+ * @public
+ */
+export declare function defaultGridContextMenuItems(event: CellContextMenuEvent): GridProContextMenuItem[];
+/**
+ * Where and how {@link openGridContextMenu} draws the menu.
+ *
+ * @internal
+ */
+export interface GridContextMenuOptions {
+    /** Design-system prefix: the menu is built from `${prefix}-menu` and `${prefix}-menu-item`. */
+    prefix: string;
+    /** Viewport coordinates of the pointer. */
+    x: number;
+    y: number;
+    items: readonly GridProContextMenuEntry[];
+    /**
+     * Node the menu is attached to. Use one inside the grid's own tree, so a grid in a modal dialog
+     * does not render its menu inert. Defaults to `document.body`.
+     */
+    container?: Node;
+    /** Element the theme variables are read from, and focus returns to on keyboard close. */
+    themeSource?: Element | null;
+}
+/**
+ * Opens a design-system menu at the pointer and returns a function that removes it, or
+ * `undefined` when the design system has not registered the menu components.
+ *
+ * A pointer press outside, a scroll outside, a window resize, Escape or Tab closes it. Choosing an item runs its
+ * action and closes it; an item with a submenu opens the submenu instead.
+ *
+ * @internal
+ */
+export declare function openGridContextMenu(options: GridContextMenuOptions): (() => void) | undefined;
+//# sourceMappingURL=context-menu.d.ts.map

package/dist/dts/context-menu/context-menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-menu.d.ts","sourceRoot":"","sources":["../../../src/context-menu/context-menu.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AA2L9D;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,WAAW,CAAC;AAE3E;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,oBAAoB,KAAK,uBAAuB,EAAE,CAAC;AAEjG;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,oBAAoB,GAAG,sBAAsB,EAAE,CAUjG;AAmBD;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,yFAAyF;IACzF,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CA4E7F"}

package/dist/dts/context-menu/index.d.ts

@@ -0,0 +1,2 @@
+export { defaultGridContextMenuItems, type GridProContextMenuEntry, type GridProContextMenuItem, type GridProContextMenuItems, } from './context-menu';
+//# sourceMappingURL=index.d.ts.map

package/dist/dts/context-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/context-menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,gBAAgB,CAAC"}

package/dist/dts/grid-pro.d.ts

@@ -1,7 +1,8 @@
 import { ViewTemplate } from '@microsoft/fast-element';
 import { FoundationElement } from '@microsoft/fast-foundation';
-import type { ColDef, ColumnState, GridApi, GridOptions, GridParams, IStatusPanelComp } from 'ag-grid-community';
+import type { CellContextMenuEvent, ColDef, ColumnState, GridApi, GridOptions, GridParams, IStatusPanelComp } from 'ag-grid-community';
 import { type GridProColumnDragBridge } from './column-selection/grid-pro-column-drag-bridge';
+import { type GridProContextMenuItems } from './context-menu/context-menu';
 import { GridProBaseDatasource } from './datasource/base.datasource';
 import type { GridComponents, GridProCaseType, GridProErrorEvent, GridProErrorItem, GridProEventsAndCallbacks } from './grid-pro.types';
 import { GridOptionsConfig, GridProStatusBarConfig, GridProStatusBarLabelConfig } from './grid-pro.types';
@@ -503,6 +504,23 @@ export declare class GridPro extends GridPro_base {
      * @internal
      */
     get statusBar(): GridProStatusBar | undefined;
+    /**
+     * Opts the grid into its own right-click menu, built from these items for each cell. It needs no
+     * AG Grid Enterprise module, and replaces AG Grid's context menu while set. Assign
+     * {@link defaultGridContextMenuItems} for a CSV Export menu, or return an empty list to show the
+     * browser's menu for that cell.
+     *
+     * Unset, right-click is left alone: AG Grid's menu when its `ContextMenu` module is registered,
+     * otherwise the browser's.
+     *
+     * @public
+     */
+    contextMenuItems?: GridProContextMenuItems;
+    contextMenuItemsChanged(): void;
+    /** Removes the open right-click menu, if there is one. */
+    private closeContextMenu?;
+    /** Whether the AG grid instance was created with its own context menu suppressed. */
+    private gridCreatedWithMenuSuppressed;
     /**
      * Shows a Columns side panel on the trailing edge of the grid.
      * @public
@@ -536,6 +554,11 @@ export declare class GridPro extends GridPro_base {
     private luminanceSubscription?;
     private visibilityObserverCleanup?;
     private readonly boundGlobalEventListener;
+    /**
+     * `globalListener` runs on a timeout, which is too late to cancel the browser menu.
+     * This one runs inside the right-click event.
+     */
+    private readonly boundContextMenuListener;
     private _filterConfig;
     getfilterModel(): Promise<{
         [key: string]: any;
@@ -878,7 +901,7 @@ export declare class GridPro extends GridPro_base {
         onCellValueChanged?: ((event: import("@ag-grid-community/core").NewValueParams<any>) => void) | ((event: import("ag-grid-community").NewValueParams<any, any, any>) => void);
         onCellClicked?: ((event: import("@ag-grid-community/core").CellClickedEvent<any, any>) => void) | ((event: import("ag-grid-community").CellClickedEvent<any, any, any>) => void);
         onCellDoubleClicked?: ((event: import("@ag-grid-community/core").CellDoubleClickedEvent<any, any>) => void) | ((event: import("ag-grid-community").CellDoubleClickedEvent<any, any, any>) => void);
-        onCellContextMenu?: ((event: import("@ag-grid-community/core").CellContextMenuEvent<any, any>) => void) | ((event: import("ag-grid-community").CellContextMenuEvent<any, any, any>) => void);
+        onCellContextMenu?: ((event: import("@ag-grid-community/core").CellContextMenuEvent<any, any>) => void) | ((event: CellContextMenuEvent<any, any, any>) => void);
         getQuickFilterText?: ((params: import("@ag-grid-community/core").GetQuickFilterTextParams<any, any>) => string) | import("ag-grid-community").GetQuickFilterText<any, any, any>;
         filterValueGetter?: string | import("@ag-grid-community/core").ValueGetterFunc<any> | import("ag-grid-community").ValueGetterFunc<any, any, any>;
         floatingFilter?: boolean;
@@ -1019,6 +1042,20 @@ export declare class GridPro extends GridPro_base {
     protected setupStatusBar(gridOptions: GridOptions): void;
     get observedAttributes(): string[];
     agAttributeChangedCallback(attName: any, oldValue: any, newValue: any): void;
+    /**
+     * AG Grid draws its own menu when `ContextMenu` is registered, so it is suppressed while
+     * `contextMenuItems` is set and the app's own `suppressContextMenu` restored when it is cleared.
+     * The suppression goes to AG Grid only, never into `agGridOptions`: that object is what the
+     * `gridOptions` getter returns, and an app re-applying it would otherwise adopt the setting.
+     * @internal
+     */
+    private syncContextMenuSuppression;
+    /**
+     * Opens the grid's right-click menu for a cell. Called from the synchronous grid listener so
+     * `preventDefault` still cancels the browser menu.
+     * @internal
+     */
+    private showContextMenu;
     globalEventListener(eventType: any, event: any): void;
 }
 /**

package/dist/dts/grid-pro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grid-pro.d.ts","sourceRoot":"","sources":["../../src/grid-pro.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"grid-pro.d.ts","sourceRoot":"","sources":["../../src/grid-pro.ts"],"names":[],"mappings":"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"}

package/dist/dts/index.d.ts

@@ -4,6 +4,7 @@ export * from './cell-editors';
 export * from './column';
 export * from './column-selection';
 export * from './column-filters';
+export * from './context-menu';
 export * from './datasource';
 export * from './external';
 export * from './grid-components';

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/dts/react.d.ts

@@ -83,6 +83,15 @@ export declare const GridPro: React.ForwardRefExoticComponent<
 >;
 export type GridProRef = GridProWC;
 
+export declare const GridProCell: React.ForwardRefExoticComponent<
+  React.PropsWithChildren<
+    Omit<PublicOf<GridProCellWC>, 'children' | 'style'> &
+    HTMLWCProps & {
+    }
+  > & React.RefAttributes<GridProCellWC>
+>;
+export type GridProCellRef = GridProCellWC;
+
 export declare const DateEditor: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<DateEditorWC>, 'children' | 'style'> &
@@ -128,15 +137,6 @@ export declare const StringEditor: React.ForwardRefExoticComponent<
 >;
 export type StringEditorRef = StringEditorWC;
 
-export declare const GridProCell: React.ForwardRefExoticComponent<
-  React.PropsWithChildren<
-    Omit<PublicOf<GridProCellWC>, 'children' | 'style'> &
-    HTMLWCProps & {
-    }
-  > & React.RefAttributes<GridProCellWC>
->;
-export type GridProCellRef = GridProCellWC;
-
 export declare const ActionRenderer: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<ActionRendererWC>, 'children' | 'style'> &

package/dist/esm/context-menu/context-menu.js

@@ -0,0 +1,379 @@
+import { css, DOM } from '@microsoft/fast-element';
+import { logger } from '../utils/logger';
+/**
+ * Same surface as the vertical actions menu: AG Grid's context-menu variables, with design-system
+ * tokens when those variables are not set. The menu is drawn in the top layer, outside the themed
+ * grid element, so the values are copied from the cell that was clicked.
+ */
+const contextMenuStyles = css `
+  :host {
+    display: block;
+  }
+
+  :host > .grid-context-menu,
+  .grid-context-menu-item > .grid-context-menu {
+    display: flex;
+    flex-direction: column;
+    box-sizing: border-box;
+    margin: 0;
+    padding: var(--ag-spacing, 4px) 0;
+    max-width: 368px;
+    min-width: 64px;
+    background-color: var(--ag-menu-background-color, var(--fill-color));
+    border: var(
+      --ag-menu-border,
+      calc(var(--stroke-width, 1) * 1px) solid var(--neutral-stroke-rest, transparent)
+    );
+    border-radius: var(--ag-border-radius, calc(var(--control-corner-radius, 2) * 1px));
+    box-shadow: var(--ag-menu-shadow, var(--ag-popup-shadow, 0 2px 8px rgb(0 0 0 / 30%)));
+    color: var(--ag-menu-text-color, var(--neutral-foreground-rest));
+    font-family: var(--ag-font-family, var(--body-font));
+  }
+
+  .grid-context-menu > .grid-context-menu-item {
+    display: flex;
+    box-sizing: border-box;
+    align-items: center;
+    height: calc(var(--ag-icon-size, 16px) + (var(--ag-spacing, 4px) + 2px) * 2);
+    margin: 0;
+    background: transparent;
+    border: none;
+    border-radius: 0;
+    color: inherit;
+    font-family: inherit;
+    font-size: var(--ag-font-size, var(--type-ramp-base-font-size));
+    font-weight: 500;
+    user-select: none;
+  }
+
+  .grid-context-menu > .grid-context-menu-separator {
+    margin: var(--ag-spacing, 4px) 0;
+    border-top: var(
+      --ag-menu-border,
+      calc(var(--stroke-width, 1) * 1px) solid var(--neutral-stroke-rest, currentColor)
+    );
+    opacity: 50%;
+  }
+
+  .grid-context-menu > .grid-context-menu-item:hover,
+  .grid-context-menu > .grid-context-menu-item:focus {
+    background: var(--ag-row-hover-color, var(--neutral-fill-stealth-hover));
+    border: none;
+  }
+
+  .grid-context-menu > .grid-context-menu-item[disabled] {
+    background: transparent;
+    cursor: default;
+    opacity: 50%;
+  }
+
+  .grid-context-menu > .grid-context-menu-item::part(content) {
+    flex: 1;
+    margin-inline: 0;
+    padding-inline: calc(var(--ag-spacing, 4px) * 2) calc(var(--ag-spacing, 4px) * 4);
+    line-height: var(--ag-icon-size, 16px);
+  }
+
+  /* A plain item in a menu with checkboxes lines its text up with theirs. */
+  .grid-context-menu
+    > .grid-context-menu-item.indent-1:not([role='menuitemcheckbox'])::part(content) {
+    padding-inline-start: calc(var(--ag-spacing, 4px) * 4 + var(--ag-icon-size, 16px));
+  }
+
+  .grid-context-menu > .grid-context-menu-item::part(end) {
+    padding-inline-end: calc(var(--ag-spacing, 4px) * 2);
+  }
+
+  .grid-context-menu > .grid-context-menu-item [slot='end'] {
+    white-space: nowrap;
+  }
+
+  /* The menu item's own boxed, accent-filled checkbox and wide chevron, reduced to AG Grid's
+     icon column: a bare tick and a small arrow at the grid's icon size. */
+  .grid-context-menu > .grid-context-menu-item::part(input-container) {
+    margin: 0;
+    padding-inline-start: calc(var(--ag-spacing, 4px) * 2);
+  }
+
+  .grid-context-menu > .grid-context-menu-item::part(checkbox),
+  .grid-context-menu > .grid-context-menu-item[aria-checked='true']::part(checkbox) {
+    width: var(--ag-icon-size, 16px);
+    height: var(--ag-icon-size, 16px);
+    margin: 0;
+    background: transparent;
+    border: none;
+  }
+
+  .grid-context-menu > .grid-context-menu-item::part(expand-collapse-glyph-container) {
+    margin: 0;
+    padding-inline-end: calc(var(--ag-spacing, 4px) * 2);
+  }
+
+  .grid-context-menu > .grid-context-menu-item::part(expand-collapse) {
+    width: var(--ag-icon-size, 16px);
+    height: var(--ag-icon-size, 16px);
+    margin: 0;
+  }
+
+  .grid-context-menu-icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: var(--ag-icon-size, 16px);
+    height: var(--ag-icon-size, 16px);
+    font-size: var(--ag-icon-size, 16px);
+    color: inherit;
+  }
+
+  /* Font Awesome's chevron fills its box; the check does not, so the arrow is drawn smaller. */
+  .grid-context-menu-icon.chevron {
+    font-size: calc(var(--ag-icon-size, 16px) * 0.75);
+  }
+`;
+/** The design-system icon (`${prefix}-icon`), which draws Font Awesome. */
+function menuIcon(prefix, slot, name, variant) {
+    const icon = document.createElement(`${prefix}-icon`);
+    icon.slot = slot;
+    icon.classList.add('grid-context-menu-icon');
+    if (variant) {
+        icon.classList.add(variant);
+    }
+    icon.setAttribute('name', name);
+    icon.setAttribute('size', '1x');
+    icon.setAttribute('aria-hidden', 'true');
+    return icon;
+}
+/**
+ * Custom properties the menu reads. AG Grid sets its theme on its wrapper element, which is not an
+ * ancestor of the menu, so they are copied from the clicked cell.
+ */
+const MENU_THEME_PROPERTIES = [
+    '--ag-spacing',
+    '--ag-icon-size',
+    '--ag-font-size',
+    '--ag-font-family',
+    '--ag-menu-background-color',
+    '--ag-menu-border',
+    '--ag-menu-text-color',
+    '--ag-menu-shadow',
+    '--ag-popup-shadow',
+    '--ag-border-radius',
+    '--ag-row-hover-color',
+    '--fill-color',
+    '--neutral-stroke-rest',
+    '--neutral-foreground-rest',
+    '--neutral-fill-stealth-hover',
+    '--body-font',
+    '--type-ramp-base-font-size',
+    '--stroke-width',
+    '--control-corner-radius',
+];
+function applyMenuTheme(host, source) {
+    if (!source) {
+        return;
+    }
+    const computed = getComputedStyle(source);
+    for (const name of MENU_THEME_PROPERTIES) {
+        const value = computed.getPropertyValue(name).trim();
+        if (value) {
+            host.style.setProperty(name, value);
+        }
+    }
+}
+/**
+ * A CSV Export item, using AG Grid's community CSV export. Assign it to `contextMenuItems` as the
+ * whole menu, or spread its result into a menu of your own. Empty when the grid sets
+ * `suppressCsvExport`.
+ *
+ * @public
+ */
+export function defaultGridContextMenuItems(event) {
+    var _a;
+    if ((_a = event.api) === null || _a === void 0 ? void 0 : _a.getGridOption('suppressCsvExport')) {
+        return [];
+    }
+    return [
+        {
+            name: 'CSV Export',
+            action: () => { var _a; return (_a = event.api) === null || _a === void 0 ? void 0 : _a.exportDataAsCsv(); },
+        },
+    ];
+}
+/** Each prefix is reported once, not on every right-click. */
+const prefixesReportedMissing = new Set();
+function menuComponentsRegistered(prefix) {
+    if (customElements.get(`${prefix}-menu`) && customElements.get(`${prefix}-menu-item`)) {
+        return true;
+    }
+    if (!prefixesReportedMissing.has(prefix)) {
+        prefixesReportedMissing.add(prefix);
+        logger.warn(`Grid Pro: the right-click menu needs <${prefix}-menu> and <${prefix}-menu-item> registered ` +
+            'in the design system. The browser menu is shown instead.');
+    }
+    return false;
+}
+/**
+ * Opens a design-system menu at the pointer and returns a function that removes it, or
+ * `undefined` when the design system has not registered the menu components.
+ *
+ * A pointer press outside, a scroll outside, a window resize, Escape or Tab closes it. Choosing an item runs its
+ * action and closes it; an item with a submenu opens the submenu instead.
+ *
+ * @internal
+ */
+export function openGridContextMenu(options) {
+    var _a, _b;
+    const { prefix, x, y, items, themeSource } = options;
+    if (!menuComponentsRegistered(prefix)) {
+        return undefined;
+    }
+    const host = document.createElement('div');
+    host.classList.add('grid-context-menu-host');
+    host.style.cssText = MENU_HOST_STYLE;
+    applyMenuTheme(host, themeSource);
+    host.addEventListener('mousedown', (event) => event.stopPropagation());
+    const shadow = host.attachShadow({ mode: 'open' });
+    contextMenuStyles.addStylesTo(shadow);
+    const container = (_a = options.container) !== null && _a !== void 0 ? _a : document.body;
+    const containerRoot = container.getRootNode();
+    const returnFocusTo = (_b = themeSource === null || themeSource === void 0 ? void 0 : themeSource.closest('.ag-cell')) !== null && _b !== void 0 ? _b : null;
+    let closed = false;
+    const close = (restoreFocus = false) => {
+        if (closed) {
+            return;
+        }
+        closed = true;
+        const focusWasInMenu = host.matches(':focus-within');
+        host.remove();
+        window.removeEventListener('mousedown', onPointerDownOutside);
+        window.removeEventListener('resize', onResize);
+        window.removeEventListener('scroll', onScroll, true);
+        if (containerRoot instanceof ShadowRoot) {
+            containerRoot.removeEventListener('scroll', onScroll, true);
+        }
+        window.removeEventListener('keydown', onKeyDown, true);
+        if (restoreFocus && focusWasInMenu) {
+            returnFocusTo === null || returnFocusTo === void 0 ? void 0 : returnFocusTo.focus({ preventScroll: true });
+        }
+    };
+    const onPointerDownOutside = () => close();
+    const onResize = () => close();
+    // Scroll does not cross shadow roots, so a grid in a shadow root is watched there as well.
+    const onScroll = (event) => {
+        if (!event.composedPath().includes(host)) {
+            close();
+        }
+    };
+    const onKeyDown = (event) => {
+        if (event.key === 'Escape' || event.key === 'Tab') {
+            event.preventDefault();
+            event.stopPropagation();
+            close(true);
+        }
+    };
+    const menu = document.createElement(`${prefix}-menu`);
+    menu.classList.add('grid-context-menu');
+    appendMenuItems(prefix, menu, items, () => close(true));
+    shadow.append(menu);
+    container.appendChild(host);
+    showInTopLayer(host);
+    placeWithinViewport(host, x, y);
+    window.addEventListener('mousedown', onPointerDownOutside);
+    window.addEventListener('resize', onResize);
+    window.addEventListener('scroll', onScroll, true);
+    if (containerRoot instanceof ShadowRoot) {
+        containerRoot.addEventListener('scroll', onScroll, true);
+    }
+    window.addEventListener('keydown', onKeyDown, true);
+    // The menu collects its items on the next update; focusing it before then does nothing.
+    DOM.queueUpdate(() => {
+        if (!closed) {
+            menu.focus();
+        }
+    });
+    return () => close();
+}
+/** Overrides the user-agent popover box; `z-index` only matters where popovers are unsupported. */
+const MENU_HOST_STYLE = 'position: fixed; inset: auto; margin: 0; padding: 0; border: 0; overflow: visible; ' +
+    'background: transparent; color: inherit; z-index: 10000;';
+/**
+ * The top layer keeps the menu above dialogs and clear of transformed or clipping ancestors.
+ * Browsers without popovers fall back to the fixed, high z-index of {@link MENU_HOST_STYLE}.
+ */
+function showInTopLayer(host) {
+    if (typeof host.showPopover === 'function') {
+        host.popover = 'manual';
+        host.showPopover();
+    }
+}
+/** Opens at the pointer, flipping left or up where the menu would leave the viewport. */
+function placeWithinViewport(host, x, y) {
+    host.style.left = `${x}px`;
+    host.style.top = `${y}px`;
+    const { width, height } = host.getBoundingClientRect();
+    if (x + width > window.innerWidth) {
+        host.style.left = `${Math.max(0, x - width)}px`;
+    }
+    if (y + height > window.innerHeight) {
+        host.style.top = `${Math.max(0, y - height)}px`;
+    }
+}
+function appendMenuItems(prefix, menu, items, close) {
+    var _a;
+    // Separators only go between items, so an empty spread does not leave a stray line.
+    const entries = items.filter((item, index) => item !== 'separator' || (index > 0 && items[index - 1] !== 'separator'));
+    while (entries[0] === 'separator')
+        entries.shift();
+    while (entries.at(-1) === 'separator')
+        entries.pop();
+    for (const item of entries) {
+        if (item === 'separator') {
+            const separator = document.createElement('div');
+            separator.setAttribute('role', 'separator');
+            separator.classList.add('grid-context-menu-separator');
+            menu.append(separator);
+            continue;
+        }
+        const menuItem = document.createElement(`${prefix}-menu-item`);
+        menuItem.classList.add('grid-context-menu-item');
+        menuItem.textContent = item.name;
+        if (item.tooltip) {
+            menuItem.title = item.tooltip;
+        }
+        if (item.checked !== undefined) {
+            menuItem.setAttribute('role', 'menuitemcheckbox');
+            if (item.checked) {
+                menuItem.setAttribute('checked', '');
+                // Neither design system draws a checkbox glyph of its own.
+                menuItem.append(menuIcon(prefix, 'checkbox-indicator', 'check'));
+            }
+        }
+        if (item.shortcut) {
+            const shortcut = document.createElement('span');
+            shortcut.slot = 'end';
+            shortcut.textContent = item.shortcut;
+            menuItem.append(shortcut);
+        }
+        if (item.disabled) {
+            menuItem.setAttribute('disabled', '');
+        }
+        const hasSubMenu = !!((_a = item.subMenu) === null || _a === void 0 ? void 0 : _a.length);
+        if (hasSubMenu) {
+            const subMenu = document.createElement(`${prefix}-menu`);
+            subMenu.slot = 'submenu';
+            subMenu.classList.add('grid-context-menu');
+            appendMenuItems(prefix, subMenu, item.subMenu, close);
+            menuItem.append(menuIcon(prefix, 'expand-collapse-indicator', 'chevron-right', 'chevron'), subMenu);
+        }
+        // `change` is what the menu item emits for a click, Enter or Space alike.
+        menuItem.addEventListener('change', (event) => {
+            var _a;
+            if (event.target !== menuItem || hasSubMenu || item.disabled) {
+                return;
+            }
+            (_a = item.action) === null || _a === void 0 ? void 0 : _a.call(item);
+            close();
+        });
+        menu.append(menuItem);
+    }
+}

package/dist/esm/context-menu/index.js

@@ -0,0 +1 @@
+export { defaultGridContextMenuItems, } from './context-menu';