@aquera/nile-elements 1.7.9 → 1.8.1

package/dist/src/nile-context-menu/nile-context-menu.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Copyright Aquera Inc 2026
+ *
+ * This source code is licensed under the BSD-3-Clause license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { CSSResultArray, TemplateResult } from 'lit';
+import type { PropertyValues } from 'lit';
+import NileElement from '../internal/nile-element';
+import type { NileContextMenuItem } from '../nile-context-menu-item';
+import '../nile-floating-panel';
+import '../nile-context-menu-group';
+import '../nile-context-menu-item';
+import '../nile-context-submenu';
+export interface NileContextMenuItemData {
+    type: 'item';
+    id: string;
+    label: string;
+    value?: string;
+    disabled?: boolean;
+    icon?: string;
+    iconSet?: string;
+    iconSize?: string;
+    iconMethod?: 'fill' | 'stroke' | string;
+    iconColor?: string;
+    submenu?: NileContextMenuData[];
+    open?: boolean;
+}
+export interface NileContextMenuGroupData {
+    type: 'group';
+    name?: string;
+    data: NileContextMenuItemData[];
+}
+export type NileContextMenuData = NileContextMenuGroupData;
+export type NileContextMenuTrigger = 'right' | 'left' | 'both' | 'manual' | 'global';
+export interface NileContextMenuOpenOptions {
+    x: number;
+    y: number;
+    target?: Element;
+    originalEvent?: Event;
+}
+export type NileContextMenuCloseReason = 'select' | 'outside-click' | 'escape' | 'programmatic';
+interface NileContextMenuOpenContext {
+    x: number;
+    y: number;
+    target: Element | null;
+    originalEvent: Event | null;
+}
+/**
+ * Nile context-menu component.
+ *
+ * @tag nile-context-menu
+ *
+ * @slot Default menu content.
+ *
+ * @event nile-change Fired on menu lifecycle and selection. `detail.type` is one of
+ *   `'open'`, `'click'`, or `'close'`; remaining fields depend on the type.
+ */
+export declare class NileContextMenu extends NileElement {
+    static get styles(): CSSResultArray;
+    for: string;
+    trigger: NileContextMenuTrigger;
+    skipOn: string;
+    zIndex: number;
+    open: boolean;
+    items: NileContextMenuData[];
+    private get _isDataMode();
+    private _floatingPanel?;
+    private _items;
+    private _open;
+    private _pinned;
+    protected _openContext: NileContextMenuOpenContext | null;
+    protected _targetEl: Element | null;
+    private _previouslyFocused;
+    private static _openInstances;
+    private _detachTriggers?;
+    private _lightObserver?;
+    private _menuObserver?;
+    private _proxyEl?;
+    private readonly _proxyId;
+    private _wasDataMode;
+    connectedCallback(): void;
+    protected updated(changed: PropertyValues): void;
+    /** Open anchored to the `for` target (used when the `open` property is set). */
+    private _openAtTarget;
+    /** Re-anchor a pinned menu to its target after layout changes. */
+    private _onPinnedReposition;
+    private _resolveTarget;
+    get targetElement(): Element | null;
+    private _attachTriggers;
+    disconnectedCallback(): void;
+    private _menuContainerRef;
+    protected firstUpdated(): void;
+    private _ensureProxy;
+    private _positionProxyAt;
+    private _relocateLightChildren;
+    private _renderDataItems;
+    private _createDataNode;
+    private _createItemNode;
+    private _parseChildren;
+    private _isInsideDescendantSubmenu;
+    get menuItems(): readonly NileContextMenuItem[];
+    getItemByValue(value: string): NileContextMenuItem | undefined;
+    get isOpen(): boolean;
+    openAt(options: NileContextMenuOpenOptions): void;
+    close(reason?: NileContextMenuCloseReason): void;
+    private _enabledItems;
+    private _getFocusedItem;
+    private _getFocusedItemAnyLevel;
+    private _enabledItemsIn;
+    private _focusFirstEnabled;
+    private _moveFocus;
+    private _onKeydown;
+    private _findSubmenuOwning;
+    private _onScroll;
+    private _onOutsidePointer;
+    private _onDescendantSelect;
+    private _stop;
+    private _onPanelShown;
+    /** Open the submenu of every top-level item carrying the `open` attribute. */
+    private _openPinnedSubmenus;
+    private _onMenuMouseOver;
+    private _onMenuClick;
+    private _selectItem;
+    render(): TemplateResult;
+}
+export default NileContextMenu;
+declare global {
+    interface HTMLElementTagNameMap {
+        'nile-context-menu': NileContextMenu;
+    }
+}