@eagami/ui 5.71.2 → 5.72.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eagami/ui",
-  "version": "5.71.2",
+  "version": "5.72.0",
   "description": "Lightweight, accessible, themeable Angular UI component library and icon set built on CSS custom properties",
   "author": "Michal Wiraszka <michal@eagami.com>",
   "license": "MIT",

package/types/eagami-ui.d.ts

@@ -2967,6 +2967,13 @@ export declare class MenuComponent {
   protected readonly triggerEl: import("@angular/core").WritableSignal<HTMLElement | undefined>;
   protected readonly asContextMenu: import("@angular/core").WritableSignal<boolean>;
   protected readonly anchorPoint: import("@angular/core").WritableSignal<PopoverAnchorPoint | null>;
+  private readonly openedWith;
+  /**
+   * The `contextMenuData` of the `[eaContextMenuTrigger]` host that last opened the
+   * menu, so one menu can act on whichever of many hosts it was opened from. Kept
+   * after the menu closes, and cleared when a trigger button opens it instead.
+   */
+  readonly triggerData: import("@angular/core").Signal<unknown>;
   readonly activeItemId: import("@angular/core").WritableSignal<string | null>;
   constructor();
   /** Toggles the menu open state, anchoring it to the given trigger element. */
@@ -2977,9 +2984,10 @@ export declare class MenuComponent {
    * Opens the menu as the context menu of `anchorEl`: at `point` when given (a
    * pointer position, in viewport coordinates), else at its placement against the
    * anchor. Focuses the first item, closes on any click or context-menu request
-   * outside the menu, and hands focus back to wherever it was on close.
+   * outside the menu, and hands focus back to wherever it was on close. `data`
+   * becomes `triggerData()`.
    */
-  openAsContextMenu(anchorEl: HTMLElement, point?: PopoverAnchorPoint | null): void;
+  openAsContextMenu(anchorEl: HTMLElement, point?: PopoverAnchorPoint | null, data?: unknown): void;
   private show;
   /**
    * Closes the menu if it is open. Pass `restoreFocus: true` to return focus
@@ -3283,20 +3291,31 @@ export type ContextMenuPosition = 'pointer' | 'anchor';
 export type ContextMenuTarget = MenuComponent | PopoverComponent;
 /**
  * Opens an `<ea-menu>` or `<ea-popover>` as the context menu of its host: on a
- * right-click or long press, or from the keyboard with Shift+F10 or the
+ * right-click or a touch long press, or from the keyboard with Shift+F10 or the
  * context-menu key while focus is on the host or inside it. The browser's own
  * menu is suppressed only when the target opens, so a `null` target, a disabled
  * menu, or a request something inside the host has already handled leaves it be.
  *
+ * The long press is recognised here rather than left to the browser, since iOS
+ * Safari never turns one into a `contextmenu` event. While a target is set, the
+ * host also drops the iOS link and image preview a long press would raise.
+ *
  * A menu opens straight away. A popover's parent drives its `[open]` state, so it
  * emits `openRequested` with the point to bind to `[anchorPoint]` instead; give it
  * `[contextMenu]="true"` so it takes focus and dismisses like a context menu.
  *
+ * One menu can serve many hosts: give each its own `contextMenuData`, and the
+ * menu's `triggerData()` holds the data of whichever host opened it.
+ *
  * @example
  * ```html
- * <article [eaContextMenuTrigger]="actions">Right-click me</article>
+ * @for (file of files; track file.id) {
+ *   <article [eaContextMenuTrigger]="actions" [contextMenuData]="file">
+ *     {{ file.name }}
+ *   </article>
+ * }
  * <ea-menu #actions>
- *   <ea-menu-item>Rename</ea-menu-item>
+ *   <ea-menu-item (clicked)="rename(actions.triggerData())">Rename</ea-menu-item>
  * </ea-menu>
  * ```
  */
@@ -3309,9 +3328,14 @@ export declare class ContextMenuTriggerDirective {
    * `anchor` opens at the target's placement against the host instead.
    */
   readonly contextMenuPosition: import("@angular/core").InputSignal<ContextMenuPosition>;
+  /** Handed to an `<ea-menu>` target as it opens, where its `triggerData()` reads it back. */
+  readonly contextMenuData: import("@angular/core").InputSignal<unknown>;
+  constructor();
   onContextMenu(event: MouseEvent): void;
   onKeydown(event: KeyboardEvent): void;
   private request;
+  private canOpen;
+  private open;
   static ɵfac: i0.ɵɵFactoryDeclaration<ContextMenuTriggerDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<ContextMenuTriggerDirective, "[eaContextMenuTrigger]", never, {
     "target": {
@@ -3324,6 +3348,11 @@ export declare class ContextMenuTriggerDirective {
       "required": false;
       "isSignal": true;
     };
+    "contextMenuData": {
+      "alias": "contextMenuData";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 /** Vertical density preset for table rows and header cells. */
@@ -3363,7 +3392,11 @@ export interface DataTableRowContextMenuEvent<T = Record<string, unknown>> {
   readonly rowElement: HTMLElement;
   /** Where to open a menu: the pointer, or below the focused row or cell for a keyboard request. */
   readonly point: PopoverAnchorPoint;
-  /** The originating event; call `preventDefault()` on it to suppress the browser's own menu. */
+  /**
+   * The originating event, or a stand-in `contextmenu` event for a touch long press;
+   * call `preventDefault()` on it to claim the request, which also suppresses the
+   * browser's own menu.
+   */
   readonly event: MouseEvent | KeyboardEvent;
 }
 /** Current sort state: which column is sorted and in which direction. */
@@ -3380,6 +3413,7 @@ export interface DataTableSortState {
 export declare class DataTableComponent<T = Record<string, unknown>> {
   private readonly i18n;
   private readonly host;
+  private readonly rowEls;
   private readonly activeCell;
   private static readonly PAGE_JUMP;
   private keyboardRequestPending;
@@ -3475,6 +3509,7 @@ export declare class DataTableComponent<T = Record<string, unknown>> {
   rowTabindex(row: T): number | null;
   onRowActivate(row: T, event?: Event): void;
   onRowContextMenu(row: T, rowElement: HTMLElement, event: MouseEvent | KeyboardEvent): void;
+  private onRowLongPress;
   clearKeyboardRequest(): void;
   onCellFocus(row: number, col: number): void;
   onGridKeydown(event: KeyboardEvent): void;