@yuuvis/client-framework 3.20.1 → 3.22.0

package/lib/assets/i18n/de.json

@@ -24,7 +24,7 @@
   "yuv.action-menu.action.unlock.description-locked-by-other": "Das Objekt ist von {{ user }} gesperrt.",
   "yuv.action-menu.action.unlock.description-locked-by-unknown-user": " Das Objekt ist von einem Benutzer gesperrt.",
   "yuv.badge.empty.selection": "Derzeit gibt es keine Badges zur Auswahl.",
-  "yuv.badge.lock.description": "Dieses Objekt ist gegen Änderungen gesperrt.",
+  "yuv.badge.lock.description": "Dieses Objekt ist von {{ user }} gesperrt.",
   "yuv.badge.lock.label": "Gesperrt",
   "yuv.badge.lock.self.description": "Dieses Objekt ist von Ihnen gesperrt.",
   "yuv.badge.lock.self.label": "Von Ihnen gesperrt",

package/lib/assets/i18n/en.json

@@ -24,7 +24,7 @@
   "yuv.action-menu.action.unlock.description-locked-by-other": "The object is locked by {{ user }}.",
   "yuv.action-menu.action.unlock.description-locked-by-unknown-user": " The object is locked by a user.",
   "yuv.badge.empty.selection": "No badges currently available for selection.",
-  "yuv.badge.lock.description": "This object is locked and cannot be modified.",
+  "yuv.badge.lock.description": "This object is locked by {{ user }}.",
   "yuv.badge.lock.label": "Locked",
   "yuv.badge.lock.self.description": "This object is locked by you.",
   "yuv.badge.lock.self.label": "Locked by you",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yuuvis/client-framework",
-  "version": "3.20.1",
+  "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.20.1",
-    "@yuuvis/client-shell-core": "^3.20.1",
-    "@yuuvis/client-components": "^3.20.1",
+    "@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.20.1",
+    "@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-badges.d.ts

@@ -1,6 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { Signal } from '@angular/core';
 import { DmsObject, YuvUser, LockState, VirtualObjectType } from '@yuuvis/client-core';
+import { Observable } from 'rxjs';
 import { Severity } from '@yuuvis/material/badge';
 
 type BadgeSeverity = Severity;
@@ -8,7 +9,14 @@ type BadgeSeverity = Severity;
 interface BadgeContext {
     currentUser?: YuvUser;
     lockState?: LockState;
+    /**
+     * Resolves a user id to a user (cached IDM lookup). Emits `null` when the
+     * user is unknown or the lookup fails.
+     */
+    resolveUser: (userId: string) => Observable<YuvUser | null>;
 }
+/** Interpolation params for a translated badge description (`{{ placeholder }}` syntax). */
+type BadgeDescriptionParams = Record<string, unknown>;
 interface BadgeRule {
     field: string;
     op: 'isSet' | 'equals' | 'tagPresent';
@@ -35,6 +43,13 @@ interface Badge {
     id: string;
     labelKey: string;
     descriptionKey?: string;
+    /**
+     * Optional interpolation params for `descriptionKey`. May resolve asynchronously
+     * (e.g. a user name looked up from an id). Only evaluated by `yuv-badge-chip`
+     * when a `dmsObject` is bound; until the params resolve, the description is
+     * rendered without them.
+     */
+    descriptionParams?: (dmsObject: DmsObject, ctx: BadgeContext) => Observable<BadgeDescriptionParams> | BadgeDescriptionParams;
     icon: string;
     svgIcon?: boolean;
     severity?: BadgeSeverity;
@@ -60,6 +75,16 @@ declare class BadgeChipComponent {
     #private;
     badge: _angular_core.InputSignal<Badge>;
     showLabel: _angular_core.InputSignal<boolean>;
+    /**
+     * The object the badge is shown for. Required to resolve {@link Badge.descriptionParams}
+     * (e.g. the name of the user holding a lock); without it the description renders as-is.
+     */
+    dmsObject: _angular_core.InputSignal<DmsObject | undefined>;
+    /**
+     * Translated tooltip. Uses `descriptionKey` (interpolated with the badge's resolved
+     * `descriptionParams`) and falls back to `labelKey` when no description is available.
+     * While async params are pending, the description is shown without them.
+     */
     readonly tooltip: _angular_core.Signal<string>;
     /**
      * Accessible name for the icon-only variant. Without a label the chip renders nothing
@@ -69,7 +94,7 @@ declare class BadgeChipComponent {
      */
     readonly ariaLabel: _angular_core.Signal<string | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeChipComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeChipComponent, "yuv-badge-chip", never, { "badge": { "alias": "badge"; "required": true; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeChipComponent, "yuv-badge-chip", never, { "badge": { "alias": "badge"; "required": true; "isSignal": true; }; "showLabel": { "alias": "showLabel"; "required": false; "isSignal": true; }; "dmsObject": { "alias": "dmsObject"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class BadgeSelectComponent {
@@ -201,6 +226,11 @@ declare class BadgeRegistryService {
         bucket?: string;
         idFilter?: string[];
     }): Badge[];
+    /**
+     * Builds the evaluation context for a badge against the given object. Used both
+     * for `applies` evaluation and for resolving {@link Badge.descriptionParams}.
+     */
+    createContext(dmsObject: DmsObject): BadgeContext;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BadgeRegistryService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<BadgeRegistryService>;
 }
@@ -245,4 +275,4 @@ declare function evaluateRule(rule: BadgeRule, dmsObject: DmsObject): boolean;
 declare function badgeSupportsType(badge: Badge, objectType?: VirtualObjectType): boolean;
 
 export { BadgeChipComponent, BadgeRegistryService, BadgeSelectComponent, LOCK_BADGE, LOCK_SELF_BADGE, RETENTION_BADGE, TileBadgesComponent, badgeSupportsType, evaluateRule };
-export type { Badge, BadgeContext, BadgeRule, BadgeSeverity, BadgeSupport };
+export type { Badge, BadgeContext, BadgeDescriptionParams, BadgeRule, BadgeSeverity, BadgeSupport };

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-smart-search.d.ts

@@ -165,6 +165,12 @@ declare class SmartSearchEditController {
      * searchable type of the schema is a candidate and nothing is restricted.
      */
     allowedTypes: _angular_core.WritableSignal<string[]>;
+    /**
+     * Whether to bypass the user's object-type read permissions when offering types
+     * (mirrors the host `ignoreTypePermissions` input). Off by default: only types the
+     * user may search are offered.
+     */
+    ignoreTypePermissions: _angular_core.WritableSignal<boolean>;
     /** ObjectTypeField IDs to exclude from the field-step autocomplete suggestions. */
     skipProperties: _angular_core.WritableSignal<string[]>;
     fieldCtrl: FormControl<string | null>;
@@ -516,6 +522,15 @@ declare class SmartSearchComponent {
      * is offered in the picker, so only a full-text search can be built.
      */
     types: _angular_core.InputSignal<string[]>;
+    /**
+     * Offers every object type of the schema in the type picker, not only those the user
+     * has READ permission for. Off by default.
+     *
+     * Meant for surfaces that *author* a query rather than execute it as the current user
+     * (admin/configuration screens, stored-search templates). {@link types} still applies
+     * on top: this widens what the permissions allow, never what the consumer scoped.
+     */
+    ignoreTypePermissions: _angular_core.InputSignal<boolean>;
     /**
      * Field ids to hide from the field-step autocomplete (e.g. internal/system
      * properties that should not be user-queryable). Applies to block fields and
@@ -788,7 +803,7 @@ declare class SmartSearchComponent {
      */
     getObjectTypeField(item: SuggestionItem | null): ObjectTypeField | null;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SmartSearchComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartSearchComponent, "yuv-smart-search", never, { "types": { "alias": "types"; "required": false; "isSignal": true; }; "skipProperties": { "alias": "skipProperties"; "required": false; "isSignal": true; }; "fulltextOnly": { "alias": "fulltextOnly"; "required": false; "isSignal": true; }; "supportDynamicConditions": { "alias": "supportDynamicConditions"; "required": false; "isSignal": true; }; }, { "queryChange": "queryChange"; "querySubmit": "querySubmit"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SmartSearchComponent, "yuv-smart-search", never, { "types": { "alias": "types"; "required": false; "isSignal": true; }; "ignoreTypePermissions": { "alias": "ignoreTypePermissions"; "required": false; "isSignal": true; }; "skipProperties": { "alias": "skipProperties"; "required": false; "isSignal": true; }; "fulltextOnly": { "alias": "fulltextOnly"; "required": false; "isSignal": true; }; "supportDynamicConditions": { "alias": "supportDynamicConditions"; "required": false; "isSignal": true; }; }, { "queryChange": "queryChange"; "querySubmit": "querySubmit"; }, never, never, true, never>;
 }
 
 declare class YuvSmartSearchModule {

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 {