@yuuvis/client-framework 3.21.0 → 3.22.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuuvis/client-framework",
-  "version": "3.21.0",
+  "version": "3.22.0",
   "author": "OPTIMAL SYSTEMS GmbH <npm@optimal-systems.de>",
   "license": "MIT",
   "peerDependencies": {
@@ -8,16 +8,16 @@
     "@angular/common": "^21.2.19",
     "@angular/core": "^21.2.19",
     "angular-gridster2": "^21.0.1",
-    "@yuuvis/client-core": "^3.21.0",
-    "@yuuvis/client-shell-core": "^3.21.0",
-    "@yuuvis/client-components": "^3.21.0",
+    "@yuuvis/client-core": "^3.22.0",
+    "@yuuvis/client-shell-core": "^3.22.0",
+    "@yuuvis/client-components": "^3.22.0",
     "ng-dynamic-component": "^10.8.2",
     "modern-normalize": "^3.0.1"
   },
   "dependencies": {
     "@angular/material": "^21.2.14",
     "@ngrx/signals": "^21.1.0",
-    "@yuuvis/material": "^3.21.0",
+    "@yuuvis/material": "^3.22.0",
     "@yuuvis/media-viewer": "^4.1.0",
     "angular-split": "^20.0.0",
     "vis-network": "^10.0.2",

package/types/yuuvis-client-framework-actions.d.ts

@@ -56,8 +56,14 @@ interface BaseAction {
      */
     group: string;
     /**
-     * number of selected items supported by the action
-     * (SelectionRange.SINGLE_SELECT, SelectionRange.MULTI_SELECT, SelectionRange.MULTI_SELECT_ONLY )
+     * number of selected items supported by the action. Enforced by the actions
+     * service: an action whose range does not match the current selection size is
+     * never offered, no matter what `isExecutable` returns.
+     *
+     * - `SINGLE_SELECT` — exactly one item
+     * - `MULTI_SELECT` — one or more items
+     * - `MULTI_SELECT_ONLY` — more than one item
+     * - `ANY` — any selection, including an empty one
      */
     range: SelectionRange;
     /**
@@ -213,11 +219,23 @@ declare class ActionsService {
     concealActions(actionIDs: string[]): void;
     /**
      * Returns all actions that are executable for the given selection.
+     * An action is only taken into account when its `range` matches the size of
+     * the current selection, so a `SelectionRange.SINGLE_SELECT` action is never
+     * offered for a multi selection.
      * @param selection Array of DmsObjects to check for executable actions
      * @param options options to filter the actions
      * @returns Observable of actions that are executable for the given selection
      */
     getActions(selection: DmsObject[], options?: ActionOptions): Observable<Action[]>;
+    /**
+     * Checks whether an action supports the size of the given selection based on
+     * its `range` property. Actions without a `range` are treated as
+     * `SelectionRange.ANY`.
+     * @param action Action to check
+     * @param selection Array of DmsObjects the action should be applied to
+     * @returns true if the action supports the size of the given selection
+     */
+    matchesSelectionRange(action: Action, selection: DmsObject[]): boolean;
     /**
      * Get all available actions. This includes the default actions and all registered actions but
      * without checking if they are executable.

package/types/yuuvis-client-framework-forms.d.ts

@@ -481,7 +481,9 @@ declare class OrganizationComponent extends AbstractMatFormField<FormControlValu
      */
     readonly: _angular_core.InputSignal<boolean>;
     /**
-     * Whether or not to exclude the current user from autocomplete result
+     * Whether or not to exclude the current user from autocomplete result. Enforced on the
+     * client for both organization and organization set fields, so the signed-in user cannot
+     * be selected even when the backend does not filter itself out.
      */
     excludeMe: _angular_core.InputSignal<boolean>;
     /**

package/types/yuuvis-client-framework-object-details.d.ts

@@ -27,6 +27,12 @@ declare class ObjectAuditComponent {
      * Whether or not to ignore admin and user separation of audit entries
      */
     allActions: _angular_core.InputSignal<boolean>;
+    /**
+     * Restrict the timeline to the given audit codes (like 100, 301, etc.). Use `[10000]` to show
+     * custom audit entries only. This can only narrow down the entries the current user is allowed
+     * to see, never widen them. An empty list means no restriction.
+     */
+    actions: _angular_core.InputSignal<number[]>;
     get objectID(): string | undefined;
     constructor();
     /**
@@ -35,7 +41,7 @@ declare class ObjectAuditComponent {
     query(): void;
     goToPage(page: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectAuditComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ObjectAuditComponent, "yuv-object-audit", never, { "dmsObject": { "alias": "dmsObject"; "required": false; "isSignal": true; }; "skipActions": { "alias": "skipActions"; "required": false; "isSignal": true; }; "allActions": { "alias": "allActions"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ObjectAuditComponent, "yuv-object-audit", never, { "dmsObject": { "alias": "dmsObject"; "required": false; "isSignal": true; }; "skipActions": { "alias": "skipActions"; "required": false; "isSignal": true; }; "allActions": { "alias": "allActions"; "required": false; "isSignal": true; }; "actions": { "alias": "actions"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface HeaderData {

package/types/yuuvis-client-framework-tile-list.d.ts

@@ -263,12 +263,22 @@ declare class TileListComponent implements OnInit {
      * Suppresses the component's built-in context menu handling.
      *
      * When `true`, right-clicking a tile does not call `event.preventDefault()`, does not
-     * auto-select the right-clicked tile, and does not emit `ctxMenu`. Use this when the
-     * parent wants to handle `contextmenu` events itself.
+     * select the right-clicked tile (see `selectOnContextMenu`), and does not emit `ctxMenu`.
+     * Use this when the parent wants to handle `contextmenu` events itself.
      *
      * @default false
      */
     disableCustomContextMenu: _angular_core.InputSignal<boolean>;
+    /**
+     * Selects the right-clicked tile, so a context menu the parent builds from `selection()`
+     * describes the row under the cursor. Off by default, so a menu meant to act on the existing
+     * selection keeps it. A tile already part of the selection never changes it, and selecting
+     * this way emits `selectionChange` but not `itemSelect` (which consumers open/navigate on).
+     * Ignored when `disableCustomContextMenu` is `true`. Accepts a bare HTML attribute.
+     *
+     * @default false
+     */
+    selectOnContextMenu: _angular_core.InputSignalWithTransform<boolean, BooleanInput>;
     /**
      * Emits the `TileData` of the most recently selected tile.
      *
@@ -482,13 +492,14 @@ declare class TileListComponent implements OnInit {
      * `#getObjectConfig()`).
      */
     transformer: (res: SearchResultItem[]) => InnerTileData[];
+    badgeIdsFor(item: TileData): string[] | undefined;
     /**
      * Handles a right-click (contextmenu) event on a tile.
      *
-     * Suppresses the browser's native context menu. If the clicked tile is not already
-     * part of the selection, it is selected first. After a short delay (to allow the
-     * selection state to propagate), `ctxMenu` is emitted with the originating event and
-     * the current selection so the parent can position and populate a custom menu.
+     * Suppresses the browser's native context menu. With `selectOnContextMenu` enabled, a tile
+     * outside the current selection becomes the selection first. After a short delay (to allow the
+     * selection state to propagate), `ctxMenu` is emitted with the originating event and the
+     * current selection so the parent can position and populate a custom menu.
      *
      * The delay is intentional: it gives Angular change detection a tick to apply the
      * selection update before the parent reads `selection()` in the `ctxMenu` handler.
@@ -499,9 +510,8 @@ declare class TileListComponent implements OnInit {
      * external callers.
      *
      * @param event The originating mouse event (used to suppress default and for positioning).
-     * @param _index Zero-based index of the right-clicked tile.
+     * @param index Zero-based index of the right-clicked tile.
      */
-    badgeIdsFor(item: TileData): string[] | undefined;
     contextMenuHandler(event: MouseEvent, index: number): void;
     /**
      * Executes a tile inline action against the appropriate set of DMS objects.
@@ -695,7 +705,7 @@ declare class TileListComponent implements OnInit {
     menuItemClicked(tileData: TileData, event: Event): void;
     private _selectionToTileData;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TileListComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TileListComponent, "yuv-tile-list", never, { "bucket": { "alias": "bucket"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "multiselect": { "alias": "multiselect"; "required": false; "isSignal": true; }; "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "flavor": { "alias": "flavor"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "preselect": { "alias": "preselect"; "required": false; "isSignal": true; }; "highlights": { "alias": "highlights"; "required": false; "isSignal": true; }; "preventChangeUntil": { "alias": "preventChangeUntil"; "required": false; "isSignal": true; }; "autoSelect": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "disableCustomContextMenu": { "alias": "disableCustomContextMenu"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; "tileCopy": "tileCopy"; "tileCut": "tileCut"; "busy": "busy"; "queryResult": "queryResult"; "selectionChange": "selectionChange"; "itemDblClick": "itemDblClick"; "ctxMenu": "ctxMenu"; }, ["menuComponent", "emptyContent"], ["yuv-tile-actions-menu, [yuv-tile-actions-menu]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TileListComponent, "yuv-tile-list", never, { "bucket": { "alias": "bucket"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; "multiselect": { "alias": "multiselect"; "required": false; "isSignal": true; }; "dense": { "alias": "dense"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "flavor": { "alias": "flavor"; "required": false; "isSignal": true; }; "query": { "alias": "query"; "required": false; "isSignal": true; }; "preselect": { "alias": "preselect"; "required": false; "isSignal": true; }; "highlights": { "alias": "highlights"; "required": false; "isSignal": true; }; "preventChangeUntil": { "alias": "preventChangeUntil"; "required": false; "isSignal": true; }; "autoSelect": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "disableCustomContextMenu": { "alias": "disableCustomContextMenu"; "required": false; "isSignal": true; }; "selectOnContextMenu": { "alias": "selectOnContextMenu"; "required": false; "isSignal": true; }; }, { "itemSelect": "itemSelect"; "tileCopy": "tileCopy"; "tileCut": "tileCut"; "busy": "busy"; "queryResult": "queryResult"; "selectionChange": "selectionChange"; "itemDblClick": "itemDblClick"; "ctxMenu": "ctxMenu"; }, ["menuComponent", "emptyContent"], ["yuv-tile-actions-menu, [yuv-tile-actions-menu]", "*"], true, never>;
 }
 
 declare class ActionSelectComponent {