@yuuvis/client-framework 3.11.1 → 3.12.0

package/lib/assets/i18n/de.json

@@ -1,9 +1,9 @@
 {
   "yuv.pwa.update.cancel": "Später",
   "yuv.pwa.update.confirm": "Neu laden",
-  "yuv.pwa.update.message": "Eine neue Version der Anwendung ist verfügbar. Jetzt neu laden, um zu aktualisieren?",
+  "yuv.pwa.update.message": "Eine neue Version der Anwendung ist verfügbar. Möchten Sie jetzt neu laden, um zu aktualisieren?",
   "yuv.pwa.update.title": "Update verfügbar",
-  "yuv.pwa.update.unrecoverable.message": "Die Anwendung muss neu geladen werden, um fortzufahren.",
+  "yuv.pwa.update.unrecoverable.message": "Bitte laden Sie die Anwendung neu, um fortzufahren.",
   "yuv.session.expires.message": "Ihre Sitzung läuft in {{seconds}} Sekunden ab.",
   "yuv.session.expires.title": "Sitzung läuft ab",
   "yuv.session.extend.action": "Sitzung verlängern",
@@ -49,10 +49,12 @@
   "yuv.form.element.data.grid.row.button.actions.tooltip": "Aktionsmenü öffnen",
   "yuv.form.element.datetime.calendar.cancel": "Abbrechen",
   "yuv.form.element.datetime.calendar.select": "Auswählen",
-  "yuv.form.element.catalog.option.none": "Keine Auswahl",
+  "yuv.form.element.catalog.option.none": "Nichts ausgewählt",
   "yuv.form.element.datetime.calendar.today": "Heute",
   "yuv.form.element.organization-set.classify.icon.title": "Gruppe",
   "yuv.form.element.organization.classify.icon.title": "Benutzer",
+  "yuv.form.element.reference.classify.icon.title": "Referenz",
+  "yuv.form.element.reference.open.title": "Referenziertes Objekt öffnen",
   "yuv.form.element.range-select-date.custom.overlay.button.apply": "Anwenden",
   "yuv.form.element.range-select-date.custom.overlay.title": "Benutzerdefinierter Zeitraum",
   "yuv.form.element.range-select-date.option.any": "Beliebiges Datum",
@@ -172,10 +174,10 @@
   "yuv.smart-search.condition.mark-dynamic": "Als auszufüllendes Feld festlegen",
   "yuv.smart-search.condition.remove": "Bedingung entfernen",
   "yuv.smart-search.condition.unmark-dynamic": "Aus auszufüllenden Feldern entfernen",
-  "yuv.smart-search.condition.unset-value": "Wert fehlt",
+  "yuv.smart-search.condition.unset-value": "Kein Wert gesetzt",
   "yuv.smart-search.confirm": "Bestätigen",
-  "yuv.smart-search.mode.empty": "Keine auszufüllenden Felder. Markiere Bedingungen mit dem Blitz-Symbol, um sie hier hinzuzufügen.",
-  "yuv.smart-search.mode.essentials": "Wesentliches",
+  "yuv.smart-search.mode.empty": "Keine auszufüllenden Felder. Markieren Sie Bedingungen mit dem Blitz-Symbol, um sie hier hinzuzufügen.",
+  "yuv.smart-search.mode.essentials": "Kompakt",
   "yuv.smart-search.mode.full": "Vollständige Suche",
   "yuv.smart-search.mode.label": "Suchmodus",
   "yuv.smart-search.date-preset.this-month": "Dieser Monat",
@@ -185,7 +187,7 @@
   "yuv.smart-search.field.change": "Feld ändern",
   "yuv.smart-search.field.pick": "Feld auswählen…",
   "yuv.smart-search.fulltext.placeholder": "In Metadaten und/oder Inhalt suchen…",
-  "yuv.smart-search.fulltext.scope.all": "In Metadaten & Inhalt",
+  "yuv.smart-search.fulltext.scope.all": "Metadaten & Inhalt",
   "yuv.smart-search.fulltext.scope.content": "Nur Inhalt",
   "yuv.smart-search.fulltext.scope.label": "Wo soll gesucht werden",
   "yuv.smart-search.fulltext.scope.metadata": "Nur Metadaten",

package/lib/assets/i18n/en.json

@@ -1,11 +1,11 @@
 {
   "yuv.pwa.update.cancel": "Later",
   "yuv.pwa.update.confirm": "Reload",
-  "yuv.pwa.update.message": "A new version of the application is available. Reload now to update?",
+  "yuv.pwa.update.message": "A new version of the application is available. Do you want to reload now to update the application?",
   "yuv.pwa.update.title": "Update available",
-  "yuv.pwa.update.unrecoverable.message": "The application needs to be reloaded to continue.",
-  "yuv.session.expires.message": "Your session will expire in {{seconds}} seconds.",
-  "yuv.session.expires.title": "Session expiring",
+  "yuv.pwa.update.unrecoverable.message": "Please reload the application to continue.",
+  "yuv.session.expires.message": "Your session will expire in {{seconds}} second(s).",
+  "yuv.session.expires.title": "Session is about to expire",
   "yuv.session.extend.action": "Extend session",
   "yuv.action-menu.action.copy.dms.object.description": "",
   "yuv.action-menu.action.copy.dms.object.label": "Copy",
@@ -53,6 +53,8 @@
   "yuv.form.element.datetime.calendar.today": "Today",
   "yuv.form.element.organization-set.classify.icon.title": "Group",
   "yuv.form.element.organization.classify.icon.title": "User",
+  "yuv.form.element.reference.classify.icon.title": "Reference",
+  "yuv.form.element.reference.open.title": "Open referenced object",
   "yuv.form.element.range-select-date.custom.overlay.button.apply": "Apply",
   "yuv.form.element.range-select-date.custom.overlay.title": "User-defined time period",
   "yuv.form.element.range-select-date.option.any": "Any date",
@@ -72,7 +74,7 @@
   "yuv.form.element.range-select-filesize.option.verylarge": "Very large (>100 MB)",
   "yuv.object-metadata.button.save": "Save",
   "yuv.audit.fetch.error": "Unable to load history entries",
-  "yuv.audit.label.paging": "Pagination",
+  "yuv.audit.label.paging": "Page navigation",
   "yuv.audit.label.paging.current": "Page {{page}}",
   "yuv.audit.label.paging.next": "jump to next page",
   "yuv.audit.label.paging.prev": "jump to previous page",
@@ -146,7 +148,7 @@
   "yuv.audit.label.get.metadata": "Metadata was read",
   "yuv.audit.label.get.rendition.pdf": "PDF rendition was requested",
   "yuv.audit.label.get.rendition.text": "Text rendition was requested",
-  "yuv.audit.label.get.rendition.thumbnail": "Thumbnail view was requested",
+  "yuv.audit.label.get.rendition.thumbnail": "Thumbnail was requested",
   "yuv.audit.label.update.content": "Document file was changed",
   "yuv.audit.label.update.metadata": "Metadata was changed",
   "yuv.audit.label.update.metadata.withcontent": "Metadata and document file were changed",
@@ -163,46 +165,46 @@
   "yuv.simple-search.submit": "Start search",
   "yuv.smart-search.add-condition": "Add condition",
   "yuv.smart-search.add-group": "Add group",
-  "yuv.smart-search.add-type": "Find…",
+  "yuv.smart-search.add-type": "Search...",
   "yuv.smart-search.cancel": "Cancel",
   "yuv.smart-search.combinator.and": "AND",
   "yuv.smart-search.combinator.or": "OR",
   "yuv.smart-search.combinator.as-well-as": "as well as",
   "yuv.smart-search.condition.edit-aria": "Edit condition: {{label}}",
-  "yuv.smart-search.condition.mark-dynamic": "Make this a fill-out field",
+  "yuv.smart-search.condition.mark-dynamic": "Make this an input field",
   "yuv.smart-search.condition.remove": "Remove condition",
-  "yuv.smart-search.condition.unmark-dynamic": "Remove from fill-out fields",
-  "yuv.smart-search.condition.unset-value": "value missing",
+  "yuv.smart-search.condition.unmark-dynamic": "Remove from input fields",
+  "yuv.smart-search.condition.unset-value": "Value not set",
   "yuv.smart-search.confirm": "Confirm",
-  "yuv.smart-search.mode.empty": "No fill-out fields. Mark conditions with the bolt icon to add them here.",
+  "yuv.smart-search.mode.empty": "No input fields available. Mark conditions with the lightning icon to add them here.",
   "yuv.smart-search.mode.essentials": "Essentials",
-  "yuv.smart-search.mode.full": "Full Form",
+  "yuv.smart-search.mode.full": "Full search",
   "yuv.smart-search.mode.label": "Search mode",
   "yuv.smart-search.date-preset.this-month": "This month",
   "yuv.smart-search.date-preset.this-week": "This week",
   "yuv.smart-search.date-preset.this-year": "This year",
   "yuv.smart-search.date-preset.today": "Today",
   "yuv.smart-search.field.change": "Change field",
-  "yuv.smart-search.field.pick": "Pick a field…",
-  "yuv.smart-search.fulltext.placeholder": "Search across metadata and/or content…",
-  "yuv.smart-search.fulltext.scope.all": "In metadata & content",
+  "yuv.smart-search.field.pick": "Select field...",
+  "yuv.smart-search.fulltext.placeholder": "Search in metadata and/or content...",
+  "yuv.smart-search.fulltext.scope.all": "Metadata & content",
   "yuv.smart-search.fulltext.scope.content": "Content only",
   "yuv.smart-search.fulltext.scope.label": "Where to search",
   "yuv.smart-search.fulltext.scope.metadata": "Metadata only",
   "yuv.smart-search.fulltext.types.all": "All types",
   "yuv.smart-search.fulltext.types.label": "Limit to types",
-  "yuv.smart-search.operator.change": "Change operator",
+  "yuv.smart-search.operator.change": "Modify operator",
   "yuv.smart-search.operator.empty": "is empty",
   "yuv.smart-search.operator.eq-false": "= false",
   "yuv.smart-search.operator.eq-true": "= true",
   "yuv.smart-search.operator.has": "has",
-  "yuv.smart-search.operator.like": "like",
+  "yuv.smart-search.operator.like": "similar",
   "yuv.smart-search.operator.not-empty": "is not empty",
-  "yuv.smart-search.operator.select": "Select operator…",
+  "yuv.smart-search.operator.select": "Select operator...",
   "yuv.smart-search.type.confirm": "Confirm types",
   "yuv.smart-search.type.remove": "Remove type",
   "yuv.smart-search.type.remove-draft": "Remove selected type",
-  "yuv.smart-search.value.enter": "Enter value…",
+  "yuv.smart-search.value.enter": "Enter value...",
   "yuv.sort.ascending": "Ascending",
   "yuv.sort.descending": "Descending",
   "yuv.sort.tooltip": "Sort",
@@ -215,7 +217,7 @@
   "yuv.tile-config.slot.action.headline": "Actions",
   "yuv.tile-config.slot.badges.headline": "Badges",
   "yuv.tile-config.slot.icon.headline": "Icon",
-  "yuv.tile-config.slot.property.headline": "Attribute",
+  "yuv.tile-config.slot.property.headline": "Attributes",
   "yuv.tile-config.title": "Hit list configuration for {{bucket}}",
   "yuv.tile-config.trigger.tooltip": "Hit list configuration",
   "yuv.tile-list.item.actions-menu.button.tooltip": "Open actions menu",

package/package.json

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

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

@@ -1,5 +1,5 @@
 import * as _angular_forms from '@angular/forms';
-import { ControlValueAccessor, FormControl, Validator, FormGroup, ValidationErrors, AbstractControl } from '@angular/forms';
+import { ControlValueAccessor, FormControl, Validator, FormGroup, AbstractControl } from '@angular/forms';
 import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, ElementRef, WritableSignal, AfterViewInit } from '@angular/core';
 import { AbstractMatFormField } from '@yuuvis/client-framework/common';
@@ -320,7 +320,6 @@ declare class NumberRangeComponent extends AbstractMatFormField<RangeValue> impl
 declare class NumberComponent extends AbstractMatFormField<number> implements ControlValueAccessor, OnInit, OnDestroy {
     #private;
     readonly translate: TranslateService;
-    validationErrors: ValidationErrors[];
     transformPipe: LocaleNumberPipe | FileSizePipe;
     innerCtrl: FormControl<string | null>;
     ngControl: _angular_forms.NgControl | null;
@@ -560,6 +559,114 @@ declare class RangeSelectFilesizeComponent extends AbstractMatFormField<RangeSel
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RangeSelectFilesizeComponent, "yuv-range-select-filesize", never, { "ranges": { "alias": "ranges"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * A resolved reference to a dms object, used internally by the
+ * {@link ReferenceComponent} to render chips and suggestions.
+ */
+interface ReferenceEntry {
+    /** object id of the referenced dms object (the value that gets stored) */
+    id: string;
+    /** object type id of the referenced object (used to resolve the owning app) */
+    objectTypeId: string;
+    /** resolved display title (falls back to the id) */
+    title: string;
+    /** raw field data of the referenced object (passed to the open handler) */
+    data: Record<string, unknown>;
+    /** set when the id could not be resolved (deleted or no permission) */
+    notFound?: boolean;
+}
+
+/**
+ * Form input for references to other dms objects. As the user types, a CMIS
+ * fulltext search (narrowed to the allowed target types from the field's
+ * `id:reference[...]` classification) provides suggestions. The selected object
+ * id(s) are stored; on load they are resolved back to display chips.
+ *
+ * ## Label retrieval
+ *
+ * The chip label shown for a referenced object is its resolved object-config
+ * title, not a raw property. Both search hits and objects resolved on load are
+ * turned into a {@link ReferenceEntry} by `#toEntryFromDms`, which asks
+ * {@link ObjectConfigService.getResolvedObjectConfig} for the title of the
+ * object's data. The tricky part is picking the right config: reference targets
+ * are usually secondary object types (SOTs) applied to a generic primary type,
+ * and the title-defining config is keyed by the SOT's virtual config id (colons
+ * replaced by dots, e.g. `appCasem.caseDocument`) inside the owning app's
+ * bucket — not under the primary object type id. `#resolveConfigType` therefore
+ * probes each allowed target type the hit actually carries (as primary type or
+ * SOT), trying the dotted and raw config ids, and uses the first bucket that
+ * defines one; it falls back to the primary object type's default config, and
+ * ultimately to the raw object id when no title can be resolved. Objects that
+ * cannot be fetched at all (e.g. deleted or access-denied) become `notFound`
+ * entries labelled with their id.
+ *
+ * ## Opening a reference entry
+ *
+ * A chip can be opened only when a loaded feature app claims responsibility for
+ * the referenced object's type. `#openAppId` maps the entry's `objectTypeId` to
+ * an owning app id via {@link ObjectConfigService.getAppIdForType}, and
+ * `canOpen` gates the action on {@link ShellService.canOpenObjectFor} (and on the
+ * entry not being `notFound`) — this drives whether the chip is rendered as an
+ * openable link. Invoking `open` delegates to {@link ShellService.openObject},
+ * passing the app id and the entry's cached `data` so the app can route to /
+ * display the object without an extra fetch.
+ *
+ * @example
+ * <yuv-reference [multiselect]="true" [classifications]="['id:reference[appCasem:correctionDocument]']" />
+ */
+declare class ReferenceComponent extends AbstractMatFormField<string | string[] | undefined> implements ControlValueAccessor, OnInit, OnDestroy {
+    #private;
+    busy: _angular_core.WritableSignal<boolean>;
+    acFormControl: FormControl<AutocompleteItem<unknown> | AutocompleteItem<unknown>[] | null | undefined>;
+    ngControl: _angular_forms.NgControl | null;
+    _innerValue: ReferenceEntry[];
+    set innerValue(iv: ReferenceEntry[]);
+    get innerValue(): ReferenceEntry[];
+    autocompleteRes: AutocompleteItem[];
+    /**
+     * Possibles values are `EDIT` (default),`SEARCH`,`CREATE`. In search situation validation of the form element will be turned off, so you are able to enter search terms that do not meet the elements validators.
+     */
+    situation: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Indicator that multiple references could be selected, they will be rendered as chips (default: false).
+     */
+    multiselect: _angular_core.InputSignal<boolean>;
+    /**
+     * Additional semantics for the form element. The `id:reference[...]` classification
+     * restricts the suggestions to the target types listed in the brackets.
+     */
+    classifications: _angular_core.InputSignal<string[] | undefined>;
+    /**
+     * Will prevent the input from being changed (default: false)
+     */
+    readonly: _angular_core.InputSignal<boolean>;
+    /**
+     * Minimal number of characters to trigger the search (default: 2)
+     */
+    minChars: _angular_core.InputSignal<number>;
+    /**
+     * Maximal number of suggestions for the given search term (default: 10)
+     */
+    maxSuggestions: _angular_core.InputSignal<number>;
+    propagateChange: (_: any) => void;
+    writeValue(value: string | string[]): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState?(isDisabled: boolean): void;
+    private propagate;
+    /** Resolve stored object ids back to display entries. */
+    resolveFn(ids: string[]): void;
+    autocompleteFn(query: string): void;
+    /** Whether the referenced object can be opened by a loaded app. */
+    canOpen(entry: ReferenceEntry): boolean;
+    /** Open the referenced object via the owning app's registered open handler. */
+    open(entry: ReferenceEntry): void;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ReferenceComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ReferenceComponent, "yuv-reference", never, { "situation": { "alias": "situation"; "required": false; "isSignal": true; }; "multiselect": { "alias": "multiselect"; "required": false; "isSignal": true; }; "classifications": { "alias": "classifications"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "minChars": { "alias": "minChars"; "required": false; "isSignal": true; }; "maxSuggestions": { "alias": "maxSuggestions"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /**
  * Creates form input for strings. Based on the input values different kinds of inputs will be generated.
  *
@@ -668,5 +775,5 @@ declare class FormUtils {
     static getErrorState(control: AbstractControl): boolean;
 }
 
-export { CatalogComponent, DataGridComponent, DatetimeComponent, DatetimeRangeComponent, DynamicCatalogComponent, FormUtils, I18nCatalogComponent, NumberComponent, NumberRangeComponent, OrganizationComponent, OrganizationSetComponent, RangeSelectDateComponent, RangeSelectFilesizeComponent, StringComponent, YuvFormsModule };
+export { CatalogComponent, DataGridComponent, DatetimeComponent, DatetimeRangeComponent, DynamicCatalogComponent, FormUtils, I18nCatalogComponent, NumberComponent, NumberRangeComponent, OrganizationComponent, OrganizationSetComponent, RangeSelectDateComponent, RangeSelectFilesizeComponent, ReferenceComponent, StringComponent, YuvFormsModule };
 export type { RangeSelectDateValue, RangeSelectFilesizeValue };

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

@@ -713,6 +713,11 @@ declare class PropertySelectComponent {
     objectTypeFields: TypeProperty[];
     query: _angular_core.WritableSignal<string | null>;
     objectType: _angular_core.InputSignal<VirtualObjectType | undefined>;
+    /**
+     * Property IDs that should not be offered for selection. These are added on
+     * top of the always-excluded system/base fields (see `#excludeFields`).
+     */
+    excludeProperties: _angular_core.InputSignal<string[]>;
     filteredObjectTypeFields: _angular_core.Signal<TypeProperty[]>;
     objectTypesEffect: _angular_core.EffectRef;
     selectedProperty: _angular_core.InputSignal<ObjectConfigProperty | undefined>;
@@ -724,7 +729,7 @@ declare class PropertySelectComponent {
     private getObjectTypeFields;
     private _getLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PropertySelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PropertySelectComponent, "yuv-tile-property-select", never, { "objectType": { "alias": "objectType"; "required": false; "isSignal": true; }; "selectedProperty": { "alias": "selectedProperty"; "required": false; "isSignal": true; }; }, { "propertySelect": "propertySelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PropertySelectComponent, "yuv-tile-property-select", never, { "objectType": { "alias": "objectType"; "required": false; "isSignal": true; }; "excludeProperties": { "alias": "excludeProperties"; "required": false; "isSignal": true; }; "selectedProperty": { "alias": "selectedProperty"; "required": false; "isSignal": true; }; }, { "propertySelect": "propertySelect"; }, never, never, true, never>;
 }
 
 declare class TileConfigTriggerComponent {
@@ -760,6 +765,11 @@ declare class TileConfigComponent {
     bucketLabel: _angular_core.InputSignal<string | undefined>;
     configTypes: _angular_core.InputSignal<VirtualObjectType[] | undefined>;
     configFlavors: _angular_core.InputSignal<ObjectFlavor[]>;
+    /**
+     * Property IDs that should not be offered for selection in the property
+     * slots. Added on top of the always-excluded system/base fields.
+     */
+    excludeProperties: _angular_core.InputSignal<string[]>;
     get configChanged(): boolean;
     types: Signal<InnerType[]>;
     save: _angular_core.OutputEmitterRef<void>;
@@ -785,7 +795,7 @@ declare class TileConfigComponent {
     cancelConfig(): void;
     getTypeLabel(typeId: string): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TileConfigComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TileConfigComponent, "yuv-tile-config", never, { "bucket": { "alias": "bucket"; "required": false; "isSignal": true; }; "bucketLabel": { "alias": "bucketLabel"; "required": false; "isSignal": true; }; "configTypes": { "alias": "configTypes"; "required": false; "isSignal": true; }; "configFlavors": { "alias": "configFlavors"; "required": false; "isSignal": true; }; }, { "save": "save"; "canceled": "canceled"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TileConfigComponent, "yuv-tile-config", never, { "bucket": { "alias": "bucket"; "required": false; "isSignal": true; }; "bucketLabel": { "alias": "bucketLabel"; "required": false; "isSignal": true; }; "configTypes": { "alias": "configTypes"; "required": false; "isSignal": true; }; "configFlavors": { "alias": "configFlavors"; "required": false; "isSignal": true; }; "excludeProperties": { "alias": "excludeProperties"; "required": false; "isSignal": true; }; }, { "save": "save"; "canceled": "canceled"; }, never, never, true, never>;
 }
 
 /**