UFAL/ROR identifiers on CLARIN display surfaces + ROR authority i18n labels (#1339, #1337) (#1400)

ADAPT port of the dtq-dev ROR display cluster (FE side of the ROR feature):
- a9fc7f5 (#1339): authority-based publisher search links + ROR icon on the
  CLARIN item page untyped field and the search-result card.
- 0ac3e53 (#1337): form.other-information.ror-id / .location i18n labels.

Runtime:
- clarin-shared-util.ts: new buildAuthoritySearchFilter(searchType, mdValue) centralises
  the authority-vs-equals operator logic; loadItemAuthors refactored onto it
  (behaviour-preserving). isEmpty added to the empty.util import.
- clarin-generic-item-field: getLinkToSearch rewritten to resolve the full MetadataValue
  via allMetadata()[index] (so a ROR authority is used); getMetadataValue removed. HTML:
  ROR <img> added inside the type==='search' anchor, guarded by
  mdValue.authority && fields includes dc.publisher/creativework.publisher.
- clarin-item-box-view: publisherMd via allMetadata(['dc.publisher','creativework.publisher']);
  hasPublisherRorAuthority flag; publisherRedirectLink via the helper. HTML: [href]->[attr.href]
  (no transient broken link before assignBaseUrl resolves) + @if(hasPublisherRorAuthority) ROR icon.

v9 adaptations:
- Templates rewritten to @if (v9 is @if-migrated; fork used *ngIf); BS4 ml-1 -> BS5 ms-1.
- item-box-view: did NOT drag in the fork pre-image's metadataLangToBcp47 line (that comes
  from the not-yet-ported a11y commit d154682).
- ror-icon.svg: kept the existing vanilla blob (24735df), NOT the fork blob (add/add).
- i18n: location BEFORE orcid, ror-id AFTER orcid (en) / AFTER other-names (cs), commented-
  English + Czech pair convention. Hand-merged into the CLARIN-modified json5.
- Specs (all 3 dropped by the v9 squash) restored & adapted to standalone TestBed:
  clarin-shared-util.spec.ts (7 tests), clarin-generic-item-field.component.spec.ts
  (7 tests incl. the AC5 negative-icon rendering test: no ROR icon on dc.subject),
  clarin-item-box-view.component.spec.ts (10 tests, +provideRouter for the standalone
  routerLink). Karma: 24/24 green. lint:nobuild: 0 errors.

Cluster: BE 00501a2db0 (SimpleRORAuthority) is already deployed (merged BE-3 #1381), so the
feature is live-verifiable. Without an authority the FE degrades to the equals fallback.

Fulfils CLARIN_V9_POST_SNAPSHOT_SYNC_ACCEPTANCE.md §5 / a9fc7f5 + 0ac3e53 (FE-3, Vlna 3).

Author: milanmajchrak

src/app/item-page/simple/field-components/clarin-generic-item-field/clarin-generic-item-field.component.html

@@ -42,7 +42,7 @@
             }
             @if (type === 'search') {
               <span class="d-inline-flex pe-1">
-                <a [href]="getLinkToSearch(i)">{{mdValue.value | dsReplace: this.replaceCharacter}}</a>
+                <a [href]="getLinkToSearch(i)">{{mdValue.value | dsReplace: this.replaceCharacter}} @if (mdValue.authority && (fields?.includes('dc.publisher') || fields?.includes('creativework.publisher'))) {<img src="assets/images/ror-icon.svg" alt="ROR ID" height="16" class="ror-icon ms-1 align-middle">}</a>
                 @if (!last) {
                   <span [innerHTML]="separator"></span>
                 }

src/app/item-page/simple/field-components/clarin-generic-item-field/clarin-generic-item-field.component.spec.ts

@@ -0,0 +1,125 @@
+import { NO_ERRORS_SCHEMA } from '@angular/core';
+import {
+  ComponentFixture,
+  TestBed,
+} from '@angular/core/testing';
+import { By } from '@angular/platform-browser';
+import { TranslateModule } from '@ngx-translate/core';
+import { of } from 'rxjs';
+
+import { DSONameService } from '../../../../core/breadcrumbs/dso-name.service';
+import { ConfigurationDataService } from '../../../../core/data/configuration-data.service';
+import { Item } from '../../../../core/shared/item.model';
+import { ClarinGenericItemFieldComponent } from './clarin-generic-item-field.component';
+
+describe('ClarinGenericItemFieldComponent', () => {
+  let component: ClarinGenericItemFieldComponent;
+  let fixture: ComponentFixture<ClarinGenericItemFieldComponent>;
+
+  const configurationServiceSpy = jasmine.createSpyObj('configurationService', {
+    findByPropertyName: of(true),
+  });
+  const dsoNameServiceSpy = jasmine.createSpyObj('dsoNameService', ['getName']);
+
+  /** Build an Item carrying a single metadata value (dc.publisher by default) with the given authority. */
+  function itemWith(authority: string | null, field = 'dc.publisher', value = 'ACME Press'): Item {
+    const item = new Item();
+    item.metadata = {
+      [field]: [
+        {
+          value,
+          authority,
+          confidence: authority ? 600 : -1,
+          place: 0,
+          language: null,
+          uuid: 'mock-uuid',
+          isVirtual: false,
+          virtualValue: null,
+        } as any,
+      ],
+    };
+    return item;
+  }
+
+  beforeEach(async () => {
+    await TestBed.configureTestingModule({
+      imports: [
+        TranslateModule.forRoot(),
+        ClarinGenericItemFieldComponent,
+      ],
+      providers: [
+        { provide: ConfigurationDataService, useValue: configurationServiceSpy },
+        { provide: DSONameService, useValue: dsoNameServiceSpy },
+      ],
+      schemas: [NO_ERRORS_SCHEMA],
+    }).compileComponents();
+  });
+
+  beforeEach(() => {
+    fixture = TestBed.createComponent(ClarinGenericItemFieldComponent);
+    component = fixture.componentInstance;
+    // Avoid ngOnInit (detectChanges) for the isolation tests so we can exercise getLinkToSearch directly.
+    component.baseUrl = 'http://localhost:4000';
+  });
+
+  it('should create', () => {
+    expect(component).toBeTruthy();
+  });
+
+  describe('getLinkToSearch', () => {
+    it('uses the authority operator and key when the metadata value has an authority', () => {
+      component.item = itemWith('02mhbdp94');
+      component.fields = ['dc.publisher'];
+      expect(component.getLinkToSearch(0))
+        .toBe('http://localhost:4000/search?f.publisher=02mhbdp94,authority');
+    });
+
+    it('uses the equals operator and plain value when the metadata value has no authority', () => {
+      component.item = itemWith(null);
+      component.fields = ['dc.publisher'];
+      expect(component.getLinkToSearch(0))
+        .toBe('http://localhost:4000/search?f.publisher=ACME%20Press,equals');
+    });
+
+    it('uses the explicitly provided value (e.g. a split subject) with the equals operator', () => {
+      const item = new Item();
+      item.metadata = {
+        'dc.subject': [
+          { value: 'history;art', authority: null, confidence: -1, place: 0, language: null } as any,
+        ],
+      };
+      component.item = item;
+      component.fields = ['dc.subject'];
+      expect(component.getLinkToSearch(-1, 'history'))
+        .toBe('http://localhost:4000/search?f.subject=history,equals');
+    });
+
+    it('falls back to the bare search endpoint when the index is out of range', () => {
+      component.item = itemWith(null);
+      component.fields = ['dc.publisher'];
+      expect(component.getLinkToSearch(5)).toBe('http://localhost:4000/search');
+    });
+  });
+
+  describe('ROR icon rendering (guard scope)', () => {
+    it('renders the ROR icon for an authority-bearing dc.publisher search field', () => {
+      component.item = itemWith('02mhbdp94', 'dc.publisher');
+      component.fields = ['dc.publisher'];
+      component.type = 'search';
+      fixture.detectChanges();
+      const img = fixture.debugElement.query(By.css('img.ror-icon'));
+      expect(img).not.toBeNull();
+      expect(img.nativeElement.getAttribute('src')).toContain('ror-icon.svg');
+    });
+
+    it('does NOT render the ROR icon for an authority-bearing NON-publisher field (dc.subject)', () => {
+      component.item = itemWith('some-authority', 'dc.subject', 'History');
+      component.fields = ['dc.subject'];
+      component.type = 'search';
+      fixture.detectChanges();
+      const imgs = fixture.debugElement.queryAll(By.css('img'))
+        .filter((de) => (de.nativeElement.getAttribute('src') || '').includes('ror-icon.svg'));
+      expect(imgs.length).toBe(0);
+    });
+  });
+});

src/app/item-page/simple/field-components/clarin-generic-item-field/clarin-generic-item-field.component.ts

@@ -18,6 +18,7 @@ import { Item } from '../../../../core/shared/item.model';
 import { getFirstSucceededRemoteDataPayload } from '../../../../core/shared/operators';
 import { ClarinItemAuthorPreviewComponent } from '../../../../shared/clarin-item-author-preview/clarin-item-author-preview.component';
 import {
+  buildAuthoritySearchFilter,
   convertMetadataFieldIntoSearchType,
   getBaseUrl,
 } from '../../../../shared/clarin-shared-util';
@@ -172,38 +173,17 @@ export class ClarinGenericItemFieldComponent implements OnInit {
    * @param index
    */
   public getLinkToSearch(index, value = '') {
-    let metadataValue = 'Error: value is empty';
-    if (isEmpty(value)) {
-      // Get metadata value from the Item's metadata field
-      metadataValue = this.getMetadataValue(index);
-    } else {
-      // The metadata value is passed from the parameter.
-      metadataValue = value;
-    }
-
     const searchType = convertMetadataFieldIntoSearchType(this.fields);
-    return this.baseUrl + '/search?f.' + encodeURIComponent(searchType) + '=' +
-      encodeURIComponent(metadataValue) + ',equals';
-  }
 
-  /**
-   * If the metadata field has more than 1 value return the value based on the index.
-   * @param index of the metadata value
-   */
-  public getMetadataValue(index) {
-    let metadataValue = '';
-    if (index === 0) {
-      // Return first metadata value.
-      return this.item.firstMetadataValue(this.fields);
+    // If a value is explicitly provided (e.g. a single subject from a split list), search by that plain value.
+    // Otherwise resolve the full MetadataValue for this index so an authority (e.g. ROR) can be used.
+    const mdValue = !isEmpty(value) ? { value } : this.item.allMetadata(this.fields)?.[index];
+    if (!mdValue) {
+      // ultimate fallback (should not happen)
+      return this.baseUrl + '/search';
     }
-    // The metadata field has more metadata values - get the actual one
-    this.item.allMetadataValues(this.fields)?.forEach((metadataValueArray, arrayIndex) => {
-      if (index !== arrayIndex) {
-        return metadataValue;
-      }
-      metadataValue = metadataValueArray;
-    });
-    return metadataValue;
+
+    return this.baseUrl + '/search?' + buildAuthoritySearchFilter(searchType, mdValue);
   }
 
   /**

src/app/shared/clarin-item-box-view/clarin-item-box-view.component.html

@@ -22,7 +22,7 @@
                   <!-- truthiness check: a missing dc.publisher is undefined, and an empty <a>
                        has no accessible name (axe link-name) -->
                   <span>(@if (itemPublisher) {
-                    <span><a [href]="publisherRedirectLink">{{itemPublisher}}</a> / </span>
+                    <span><a [attr.href]="publisherRedirectLink">{{itemPublisher}} @if (hasPublisherRorAuthority) {<img src="assets/images/ror-icon.svg" alt="ROR ID" height="16" class="ror-icon ms-1 align-middle">}</a> / </span>
                   }{{itemDate}})</span>
                 </div>
               }