@smartsoft001-mobilems/objects-shell-angular 2.125.0 → 2.126.0

package/fesm2022/smartsoft001-mobilems-objects-shell-angular.mjs

@@ -1,11 +1,12 @@
 import * as i0 from '@angular/core';
-import { Injectable, inject, contentChild, ChangeDetectionStrategy, Component, NgModule, Directive, signal, effect, PLATFORM_ID, viewChild, computed, untracked } from '@angular/core';
+import { Injectable, inject, contentChild, ChangeDetectionStrategy, Component, NgModule, PLATFORM_ID, isDevMode, Directive, signal, effect, viewChild, computed, untracked } from '@angular/core';
 import { FILE_SERVICE_CONFIG, PaginationMode, ListMode } from '@smartsoft001/angular';
 import { CrudFacade, initialState as initialState$1, getReducer as getReducer$1, CrudService, CrudConfig, CrudFullConfig, CrudCoreModule, CrudModule, CrudListPageBaseComponent, CrudItemPageBaseComponent } from '@smartsoft001/crud-shell-angular';
-import { CrudBaseService, FiltersBaseComponent, provideInheritedSharedConfig, SharedModule, SeoService, TranslationService, MuseumSeoService, WcagChangesService, createSafeTimeouts, MasonryGridComponent, createCatalog, createCatalogLoadMore } from '@smartsoft001-mobilems/angular';
-import { NgTemplateOutlet, CommonModule, isPlatformBrowser } from '@angular/common';
+import { CrudBaseService, FiltersBaseComponent, DICTIONARY_PAGE_SIZE, FileUrlService, provideInheritedSharedConfig, SharedModule, SeoService, TranslationService, MuseumSeoService, WcagChangesService, createSafeTimeouts, MasonryGridComponent, createCatalog, createCatalogLoadMore, toPlainText, namedEntryParts } from '@smartsoft001-mobilems/angular';
+import { NgTemplateOutlet, CommonModule, isPlatformServer, isPlatformBrowser, DOCUMENT } from '@angular/common';
+import { firstValueFrom, retry, timer, throwError, map, tap, catchError, of, expand, reduce, switchMap, from, mergeMap, toArray, filter, takeUntil } from 'rxjs';
 import { createFeatureSelector } from '@ngrx/store';
-import { toSignal } from '@angular/core/rxjs-interop';
+import { toSignal, toObservable, rxResource } from '@angular/core/rxjs-interop';
 import { ActivatedRoute } from '@angular/router';
 import { TranslateService } from '@ngx-translate/core';
 import { capitalize } from '@smartsoft001/utils';
@@ -100,8 +101,262 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
                 }]
         }] });
 
+/** Pause before the only retry of `related` after a network error (ms). */
+const RELATED_RETRY_DELAY = 500;
+/** Page size of the public collections list (the API accepts up to 500). */
+const PUBLIC_COLLECTIONS_PAGE_SIZE = 100;
+/** Page size of `search/Object` when checking an object's membership. */
+const COLLECTION_OBJECTS_PAGE_SIZE = 500;
+/** How many collections are checked at once (API 429 limit). */
+const COLLECTION_LOOKUP_CONCURRENCY = 4;
+/**
+ * The API answers 404 `NO_RESULTS_FOR_GIVEN_QUERY` instead of an empty list —
+ * only that 404 means "no results"; any other 404 (wrong address, proxy) is an error.
+ */
+const isNoResults = (error) => error?.status === 404 &&
+    error.error?.message ===
+        'NO_RESULTS_FOR_GIVEN_QUERY';
+/**
+ * `ObjectsService` plus the reads of the object details page and the filter
+ * dictionaries. A subclass, so `ObjectsService` (the `CrudService` of the
+ * objects module) stays unchanged. Request URLs, parameter order included,
+ * are transfer cache keys: keep them as they are.
+ */
+class ObjectsDataService extends ObjectsService {
+    constructor() {
+        super(...arguments);
+        this.objectsDataIsServer = isPlatformServer(inject(PLATFORM_ID));
+    }
+    /**
+     * Counts a visit of the object card: `POST api/object/:id/visit`. Browser
+     * only — the caller runs it under `isPlatformBrowser` and catches its errors.
+     */
+    logVisit(id) {
+        const cardUrl = this.config.apiUrl + 'api/object/' + id + '/visit';
+        return firstValueFrom(this.http.post(cardUrl, {}));
+    }
+    /**
+     * "You may also be interested in" — `GET object/:id/related` (objects,
+     * collections, articles). A network error (status 0) is retried once; any
+     * other error, or a second failed request, goes on to the `rxResource`
+     * (error state — the section stays hidden, `reload()` retries). In dev mode
+     * the error is logged, except a 404 on the server: there `related` starts
+     * next to the card (MOB-1850), so a missing object gives two 404s and the
+     * card view shows the error. In the browser `related` follows the card — a
+     * 404 is unexpected there and stays in the console.
+     */
+    getRelated(id) {
+        return this.http
+            .get(`${this.config.apiUrl}object/${id}/related`)
+            .pipe(retry({
+            count: 1,
+            delay: (error) => error?.status === 0
+                ? timer(RELATED_RETRY_DELAY)
+                : throwError(() => error),
+        }), map((response) => ({
+            objects: response?.data?.objects ?? [],
+            collections: response?.data?.collections ?? [],
+            articles: response?.data?.articles ?? [],
+        })), tap({
+            error: (error) => {
+                if (isDevMode() &&
+                    !(this.objectsDataIsServer && error?.status === 404)) {
+                    console.error(`object/${id}/related`, error);
+                }
+            },
+        }));
+    }
+    /**
+     * One page of the public collections list, newest publication first
+     * (`sort=publicationDate-desc`), with the phrase in `filter[phrase]` (the
+     * "Field description" document: "Search in collections: filter:phrase").
+     * 404 `NO_RESULTS_FOR_GIVEN_QUERY` is an empty page, any other error propagates.
+     */
+    loadPublicCollectionsPage(page = 1, query) {
+        const phrase = query?.trim();
+        const url = `${this.config.apiUrl}public-collections/page/${page}` +
+            `?maxPerPage=${PUBLIC_COLLECTIONS_PAGE_SIZE}&sort=publicationDate-desc` +
+            (phrase ? `&filter[phrase]=${encodeURIComponent(phrase)}` : '');
+        return this.http.get(url).pipe(map((response) => ({
+            items: (response?.data?.items ?? [])
+                .filter((item) => item && item.id !== null && item.id !== undefined)
+                .map((item) => ({
+                id: item.id,
+                title: item.title?.trim() ?? '',
+                publicationDate: item.publicationDate ?? null,
+                itemCount: typeof item.itemCount === 'number' ? item.itemCount : null,
+            })),
+            totalPagesCount: Math.max(1, response?.data?.paginatorDetails?.totalPagesCount ?? 1),
+        })), catchError((error) => isNoResults(error)
+            ? of({ items: [], totalPagesCount: 1 })
+            : throwError(() => error)));
+    }
+    /**
+     * Public collections as the dictionary of the "Thematic collection" field in
+     * the advanced filters (MOB-1844): `filter[entryCollections]` in
+     * `search/Object` takes ids from `public-collections`, not from the
+     * `ECollection` dictionary.
+     */
+    loadCollectionsDictionary(page = 1, query) {
+        return this.loadPublicCollectionsPage(page, query).pipe(map((result) => ({
+            items: result.items.map((item) => ({
+                id: Number(item.id),
+                name: item.title,
+            })),
+            totalPagesCount: result.totalPagesCount,
+        })));
+    }
+    /**
+     * Dictionary of the "Archaeological filters" fields (MOB-1844). In Muza it is
+     * `ArchaeologicalData` segregated into `ArcheoTown|ArcheoPeriod|ArcheoCulture`
+     * (Kanbanize 50040), but MobileMS exposed each segregation as its own
+     * dictionary type: `dictionary/ArcheoTown/search/page/{n}` (develop
+     * 2026-10-21 — the type is recognised, `ArchaeologicalData` still 409). Same
+     * path and shape as the framework's `DataService.loadFilterDictionary`. Until
+     * production has these types the API answers 409 and the field shows a load error.
+     */
+    loadArchaeologicalDictionary(segregation, page = 1, query) {
+        const phrase = query?.trim();
+        // No phrase, no `q` — the API treats an empty `q=` as a query with no results.
+        const url = `${this.config.apiUrl}api/dictionary/${segregation}/search/page/${page}` +
+            `?maxPerPage=${DICTIONARY_PAGE_SIZE}&_type=query` +
+            (phrase ? `&q=${encodeURIComponent(phrase)}` : '');
+        return this.http.get(url).pipe(map((response) => ({
+            items: response?.data?.items ?? [],
+            totalPagesCount: response?.data?.paginatorDetails?.totalPagesCount ?? 1,
+        })));
+    }
+    /** All public collections (consecutive pages of the list). */
+    loadAllPublicCollections() {
+        return this.loadPublicCollectionsPage(1).pipe(expand((result, index) => index + 2 <= result.totalPagesCount
+            ? this.loadPublicCollectionsPage(index + 2)
+            : []), reduce((all, result) => [...all, ...result.items], []));
+    }
+    /**
+     * "Related collections" of the object card per the "Field description"
+     * document: `search/Object` with `filter[entryCollections]`, sorted by
+     * publication date. The API gives no reverse direction (`portalCollections`
+     * and `related.collections` are empty also for objects in a collection), so
+     * for each public collection we check whether its objects contain this
+     * object — a few collections at a time, in list order. A collection that
+     * could not be checked is skipped; a failed list means no section (an empty
+     * list), not a page error.
+     */
+    loadRelatedCollections(objectId) {
+        return this.loadAllPublicCollections().pipe(switchMap((collections) => from(collections).pipe(mergeMap((collection) => this.objectsDataCollectionContains(collection, objectId).pipe(map((contains) => (contains ? collection : null))), COLLECTION_LOOKUP_CONCURRENCY), toArray(), map((matches) => collections.filter((collection) => matches.includes(collection))))), catchError(() => of([])));
+    }
+    /** Whether `search/Object` with the collection's `filter[entryCollections]` contains the object; an error → unknown → `false`. */
+    objectsDataCollectionContains(collection, objectId) {
+        const wanted = String(objectId);
+        const pageSize = Math.min(COLLECTION_OBJECTS_PAGE_SIZE, Math.max(1, collection.itemCount ?? COLLECTION_OBJECTS_PAGE_SIZE));
+        const load = (page) => this.http
+            .get(`${this.config.apiUrl}search/Object/page/${page}` +
+            `?maxPerPage=${pageSize}` +
+            `&filter[entryCollections][]=${encodeURIComponent(String(collection.id))}`)
+            .pipe(map((response) => ({
+            found: (response?.data?.items ?? []).some((item) => String(item?.id) === wanted),
+            totalPagesCount: Math.max(1, response?.data?.paginatorDetails?.totalPagesCount ?? 1),
+        })), 
+        // A collection without objects → 404 `NO_RESULTS_FOR_GIVEN_QUERY`.
+        catchError((error) => isNoResults(error)
+            ? of({ found: false, totalPagesCount: 1 })
+            : throwError(() => error)));
+        return load(1).pipe(expand((result, index) => !result.found && index + 2 <= result.totalPagesCount
+            ? load(index + 2)
+            : []), reduce((found, result) => found || result.found, false), catchError(() => of(false)));
+    }
+    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectsDataService, deps: null, target: i0.ɵɵFactoryTarget.Injectable }); }
+    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectsDataService }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectsDataService, decorators: [{
+            type: Injectable
+        }] });
+
+/**
+ * Shared listing of an object's media (the main image + `additionalImages`
+ * filtered by `formFeature`) — used by the details page image viewer
+ * (MOB-1801), the hero gallery, the thumbnails and the HD images section.
+ */
+class ObjectMediaService {
+    constructor() {
+        this.objectMediaFileUrl = inject(FileUrlService);
+    }
+    /** Gallery items (full size, for fullscreen). */
+    galleryItems(obj, types, includeMainImage = true) {
+        if (!obj)
+            return [];
+        const out = [];
+        if (obj.image && includeMainImage) {
+            const url = this.objectMediaFileUrl.get(obj.image);
+            if (!url?.includes('assets/no-image.svg')) {
+                out.push({ title: obj.title, image: obj.image });
+            }
+        }
+        for (const img of this.objectMediaAdditional(obj, types)) {
+            const url = this.objectMediaFileUrl.get(img);
+            if (!url?.includes('assets/no-image.svg')) {
+                out.push({ title: obj.title, image: img });
+            }
+        }
+        return out;
+    }
+    /** Thumbnail URLs (`cache` mode + a forced `.jpg` for the CDN). */
+    thumbnailUrls(obj, types, includeMainImage = true) {
+        if (!obj)
+            return [];
+        const urls = [];
+        if (obj.image && includeMainImage) {
+            const url = this.objectMediaJpg(this.objectMediaFileUrl.get(obj.image, 'cache'));
+            if (url && !url.includes('assets/no-image.svg')) {
+                urls.push(url);
+            }
+        }
+        for (const img of this.objectMediaAdditional(obj, types)) {
+            const url = this.objectMediaJpg(this.objectMediaFileUrl.get(img, 'cache'));
+            if (url && !url.includes('assets/no-image.svg')) {
+                urls.push(url);
+            }
+        }
+        return urls;
+    }
+    /**
+     * Whether the object has files of the types (video, 3D model) — by
+     * `filePath`, because `FileUrlService` returns a placeholder for
+     * non-image extensions.
+     */
+    hasFiles(obj, types) {
+        if (!obj)
+            return false;
+        return this.objectMediaAdditional(obj, types).some((file) => !!file?.filePath);
+    }
+    objectMediaAdditional(obj, types) {
+        const additional = obj
+            .additionalImages;
+        if (!Array.isArray(additional))
+            return [];
+        return additional
+            .filter((img) => types.includes(img?.formFeature))
+            .sort((a, b) => (a?.position ?? 0) - (b?.position ?? 0));
+    }
+    /** Replaces the extension with `.jpg` — CDN cache compatibility. */
+    objectMediaJpg(path) {
+        const lastDotIndex = path.lastIndexOf('.');
+        if (lastDotIndex > -1) {
+            return path.substring(0, lastDotIndex) + '.jpg';
+        }
+        return path + '.jpg';
+    }
+    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectMediaService, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); }
+    /** @nocollapse */ static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectMediaService, providedIn: 'root' }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectMediaService, decorators: [{
+            type: Injectable,
+            args: [{ providedIn: 'root' }]
+        }] });
+
 const SERVICES = [
     ObjectsService,
+    ObjectsDataService,
     {
         provide: CrudService,
         useClass: ObjectsService,
@@ -201,6 +456,7 @@ class ObjectsItemComponent extends CrudItemPageBaseComponent {
         this.facade = inject(ObjectsFacade);
         this.loading = this.facade.loading;
         this.item = this.facade.selected;
+        /** @deprecated No museum uses it; download the card through the app's own download service. */
         this.isPdfDownloading = signal(false, /* @ts-ignore */
         ...(ngDevMode ? [{ debugName: "isPdfDownloading" }] : /* istanbul ignore next */ []));
         effect(() => {
@@ -211,6 +467,7 @@ class ObjectsItemComponent extends CrudItemPageBaseComponent {
             }
         });
     }
+    /** @deprecated No museum uses it; download the card through the app's own download service. */
     async onDownload() {
         this.isPdfDownloading.set(true);
         try {
@@ -564,9 +821,288 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
             type: Directive
         }], ctorParameters: () => [{ type: undefined }], propDecorators: { objectsCatalogMasonry: [{ type: i0.ViewChild, args: [i0.forwardRef(() => MasonryGridComponent), { isSignal: true }] }], objectsCatalogListContainer: [{ type: i0.ViewChild, args: ['listContainer', { isSignal: true }] }] } });
 
+const OBJECT_DETAILS_SITE_NAME_KEY = 'MODEL.mainTitle';
+/** Muzeum Podlasia's tag strip — an unclosed trailing tag (`<br`) goes too. */
+function objectDetailsStripHtml(html) {
+    if (!html)
+        return '';
+    return html.replace(/<\/?[^>]+(>|$)/g, '');
+}
+/**
+ * Base of an object details page (`/obiekty/:id`, MOB-1801), from Muzeum
+ * Podlasia's item page: the SEO (also in SSR), the item effect with the
+ * `onObjectShown` hook (default: scroll to the top in the browser), the
+ * browser-only visit counter, `hasError`, `retryLoad`, `altTitle` and two
+ * opt-in resources — `related` and `relatedCollections`. The page keeps its
+ * template.
+ *
+ * ```ts
+ * // Muzeum Podlasia
+ * export class ItemComponent extends ObjectDetailsBaseComponent {
+ *   constructor() {
+ *     super({ related: true, relatedCollections: true });
+ *   }
+ * }
+ * ```
+ */
+class ObjectDetailsBaseComponent extends ObjectsItemComponent {
+    constructor(options = {}) {
+        super();
+        this.objectDetailsService = inject(ObjectsDataService);
+        this.objectDetailsSeoService = inject(MuseumSeoService);
+        this.objectDetailsFileUrl = inject(FileUrlService);
+        this.objectDetailsDocument = inject(DOCUMENT);
+        this.objectDetailsBrowser = isPlatformBrowser(inject(PLATFORM_ID));
+        this.objectDetailsServer = !this.objectDetailsBrowser;
+        /** Object id from the route (`/obiekty/:id` and `/obiekty/:id/:slug`). */
+        this.objectDetailsRouteId = computed(() => this.params()?.['id'], /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "objectDetailsRouteId" }] : /* istanbul ignore next */ []));
+        /**
+         * Id for „related” (MOB-1850). On the server from the route:
+         * `GET object/:id/related` starts together with `GET object/:id`, so SSR
+         * waits for the longer of the two requests, not their sum (card 5233:
+         * ~400 → ~290 ms locally). In the browser unchanged — after the card (no
+         * extra 404 for a missing object, „Try again” works as before). A
+         * non-numeric id waits for the card. `computed`, because `rxResource`
+         * does not compare the `params` result — every change of a read signal
+         * would repeat the request.
+         */
+        this.objectDetailsRelatedId = computed(() => {
+            const id = this.objectDetailsRouteId();
+            return this.objectDetailsServer && id && /^\d+$/.test(id)
+                ? id
+                : this.item()?.id;
+        }, /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "objectDetailsRelatedId" }] : /* istanbul ignore next */ []));
+        /** The card failed — „related” started on the server has nothing to wait for. */
+        this.objectDetailsCardFailed$ = toObservable(this.facade.error).pipe(filter(Boolean));
+        this.hasError = this.facade.error;
+        /** The object title without markup — image `alt`s. `''` without an object. */
+        this.altTitle = computed(() => objectDetailsStripHtml(this.item()?.title ?? ''), /* @ts-ignore */
+        ...(ngDevMode ? [{ debugName: "altTitle" }] : /* istanbul ignore next */ []));
+        this.objectDetailsOptions = options;
+        this.related = rxResource({
+            params: () => this.objectDetailsOptions.related
+                ? this.objectDetailsRelatedId()
+                : undefined,
+            stream: ({ params }) => this.objectDetailsService
+                .getRelated(params)
+                .pipe(takeUntil(this.objectDetailsCardFailed$)),
+        });
+        this.relatedCollections = rxResource({
+            params: () => this.objectDetailsOptions.relatedCollections &&
+                this.objectDetailsBrowser
+                ? this.item()?.id
+                : undefined,
+            stream: ({ params }) => this.objectDetailsService.loadRelatedCollections(params),
+            defaultValue: [],
+        });
+        this.objectDetailsSeoService.applyForSsr(() => this.objectDetailsFetchSsrSeo());
+        effect(() => {
+            const item = this.item();
+            if (item) {
+                untracked(() => {
+                    this.objectDetailsSeoService.apply(this.objectDetailsSeo(item));
+                    this.onObjectShown(item);
+                });
+            }
+        });
+    }
+    /**
+     * Visit counter — browser only (SSR would count the visit a second time),
+     * and its error (e.g. a 429 of the API limit) must neither reach the
+     * console as an unhandled `HttpErrorResponse` nor break the view. Once per
+     * page instance: in-page navigation to another object sends no new visit.
+     */
+    ngOnInit() {
+        if (!this.objectDetailsBrowser)
+            return;
+        this.objectDetailsService
+            .logVisit(Number(this.route.snapshot.paramMap.get('id')))
+            .catch(() => undefined);
+    }
+    retryLoad() {
+        const id = this.route.snapshot.paramMap.get('id');
+        if (id)
+            this.facade.select(id);
+    }
+    /** SEO of the object: `<title> - <site>`, description, image and its alt. */
+    objectDetailsSeo(item) {
+        const strippedTitle = objectDetailsStripHtml(item.title);
+        const siteName = this.translationService.get(this.objectDetailsOptions.siteNameKey ?? OBJECT_DETAILS_SITE_NAME_KEY);
+        return {
+            title: `${strippedTitle} - ${siteName}`,
+            description: item.description
+                ? objectDetailsStripHtml(item.description)
+                : undefined,
+            image: item.image ? this.objectDetailsFileUrl.get(item.image) : undefined,
+            imageAlt: strippedTitle,
+            type: 'article',
+        };
+    }
+    /**
+     * Called (untracked) after the SEO for every object the facade selects.
+     * Default: scroll to the top in the browser. Override to keep the scroll
+     * on a re-read of the same card (MOB-1961) or to reset a gallery.
+     */
+    onObjectShown(item) {
+        void item;
+        if (this.objectDetailsBrowser) {
+            this.objectDetailsDocument.defaultView?.scrollTo({
+                top: 0,
+                behavior: 'instant',
+            });
+        }
+    }
+    async objectDetailsFetchSsrSeo() {
+        const id = this.route.snapshot.paramMap.get('id');
+        if (!id)
+            return null;
+        try {
+            const item = await this.objectDetailsService.getById(id);
+            return item ? this.objectDetailsSeo(item) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectDetailsBaseComponent, deps: "invalid", target: i0.ɵɵFactoryTarget.Directive }); }
+    /** @nocollapse */ static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "22.1.3", type: ObjectDetailsBaseComponent, isStandalone: true, usesInheritance: true, ngImport: i0 }); }
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: ObjectDetailsBaseComponent, decorators: [{
+            type: Directive
+        }], ctorParameters: () => [{ type: undefined }] });
+
+const objectDetailHasText = (value) => !!value?.trim();
+const objectDetailBare = (entries) => entries.map((entry) => ({ ...entry, role: null, comment: null }));
+const objectDetailTextValue = (value) => objectDetailHasText(value)
+    ? [{ name: value.trim(), role: null, comment: null }]
+    : [];
+/**
+ * A link title without HTML (the articles API sends `<p>…</p>` with entities,
+ * MOB-1845) — the framework's `toPlainText` strips tags also after decoding
+ * entities (`&lt;p&gt;`), like `PlainTextPipe` on the article cards.
+ */
+const objectDetailPlainTitle = (title) => toPlainText(title);
+/** The object title — the document says `name`, the details API returns `title`. */
+function objectTitle(obj) {
+    return (obj.title ?? obj.name ?? '').trim();
+}
+/** Header tags: `seriesTitles` (the `Cycle` dictionary) → a list with the `cycles` filter. */
+function tagValues(obj) {
+    return objectDetailBare(namedEntryParts(obj.seriesTitles));
+}
+/** Inventory number: `noEvidence`. */
+function inventoryValues(obj) {
+    return objectDetailTextValue(obj.noEvidence);
+}
+/**
+ * Bibliography as in OSSO (`museum-objects` item/main-tab): every
+ * `bibliographyMNK[]` entry is a separate item, and its `text` (HTML from the
+ * API) goes whole — OSSO does not split the text on full stops. An entry
+ * without text is dropped; `permalink` makes the item a link.
+ */
+function bibliography(obj) {
+    const source = obj.bibliographyMNK;
+    const entries = typeof source === 'string' ? [source] : (source ?? []);
+    // A loop instead of `flatMap` — the library's TS `lib` predates ES2019.
+    const out = [];
+    for (const entry of entries) {
+        const text = typeof entry === 'string' ? entry : (entry?.text ?? '');
+        if (!objectDetailHasText(text))
+            continue;
+        const permalink = typeof entry === 'string' || !objectDetailHasText(entry?.permalink)
+            ? null
+            : entry.permalink.trim();
+        out.push({ text: text.trim(), permalink });
+    }
+    return out;
+}
+/**
+ * Description (HTML from the API): `publicDescriptions[].text` (the
+ * popular-science description), and without it `description` (the physical
+ * description) — the „Opis pól” rule of MOB-1563 („popular-science
+ * description, and if there is none — the physical one”); object 5233 has
+ * only `description` (MOB-1801). The description does not depend on media.
+ */
+function descriptionHtml(obj) {
+    // An empty editor paragraph (`<p></p>`, `<p>&nbsp;</p>`) is not a description.
+    const visible = (text) => toPlainText(text).length > 0;
+    const popular = (obj.publicDescriptions ?? [])
+        .map((entry) => entry?.text ?? '')
+        .filter(visible);
+    if (popular.length)
+        return popular;
+    const physical = obj.description ?? '';
+    return visible(physical) ? [physical.trim()] : [];
+}
+/**
+ * „Powiązane artykuły” — the card's `articles` field; the title without HTML
+ * (MOB-1845). `routePrefix` is the articles list route of the museum.
+ */
+function relatedArticles(obj, routePrefix = '/artykuly') {
+    return (obj.articles ?? [])
+        .map((article) => ({
+        id: article.id,
+        title: objectDetailPlainTitle(article?.title),
+        route: `${routePrefix}/${article.id}`,
+    }))
+        .filter((article) => article.title.length > 0);
+}
+
+/**
+ * „Zapytaj o obiekt” keys (MOB-1869) — the mail address and text live in the
+ * CMS translations, so a museum changes them without a deployment.
+ */
+const ASK_ABOUT_OBJECT_KEYS = {
+    email: 'DETAILS_PAGE.detail.askEmail',
+    subject: 'DETAILS_PAGE.detail.askSubject',
+    body: 'DETAILS_PAGE.detail.askBody',
+    objectWithInventory: 'DETAILS_PAGE.detail.askObjectWithInventory',
+    portal: 'MODEL.mainTitle',
+};
+const ASK_ABOUT_OBJECT_EMAIL = /^[^\s@?&#]+@[^\s@?&#]+\.[^\s@?&#]+$/;
+function askAboutObjectTranslated(translate, key, params) {
+    const value = translate(key, params);
+    return value && value !== key ? value : null;
+}
+/**
+ * The `mailto:` of the „Zapytaj o obiekt” button: the address from
+ * `askEmail`, the subject with the title (and the inventory number), the body
+ * with a greeting, the object, a link and room for the question. Without a
+ * valid address — `null` (no button); a missing subject or body is simply
+ * skipped. Body lines break as CRLF, as RFC 6068 requires.
+ */
+function askAboutObjectHref(translate, object) {
+    const email = askAboutObjectTranslated(translate, ASK_ABOUT_OBJECT_KEYS.email)?.trim();
+    if (!email || !ASK_ABOUT_OBJECT_EMAIL.test(email))
+        return null;
+    const title = object.title.trim();
+    const inventory = object.inventory?.trim();
+    const label = (inventory &&
+        askAboutObjectTranslated(translate, ASK_ABOUT_OBJECT_KEYS.objectWithInventory, {
+            title,
+            inventory,
+        })) ||
+        title;
+    const subject = askAboutObjectTranslated(translate, ASK_ABOUT_OBJECT_KEYS.subject, {
+        object: label,
+    });
+    const body = askAboutObjectTranslated(translate, ASK_ABOUT_OBJECT_KEYS.body, {
+        object: label,
+        url: object.url ?? '',
+        portal: askAboutObjectTranslated(translate, ASK_ABOUT_OBJECT_KEYS.portal) ?? '',
+    });
+    const query = [
+        subject ? `subject=${encodeURIComponent(subject)}` : null,
+        body ? `body=${encodeURIComponent(body.replace(/\r?\n/g, '\r\n'))}` : null,
+    ].filter(Boolean);
+    return `mailto:${email}${query.length ? `?${query.join('&')}` : ''}`;
+}
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { AdvancedFilterType, ComponentsModule, FiltersComponent, FormFeatureType, ListComponent, MULTIMEDIA_DICTIONARY, OBJECTS_CATALOG_DEFAULTS, OBJECTS_CATALOG_SEO, ObjectsCatalogBaseComponent, ObjectsFacade, ObjectsItemComponent, ObjectsListComponent, ObjectsModule, ObjectsService, ObjectsSharedModule, SERVICES, getObjectsState, getReducer, initialState };
+export { ASK_ABOUT_OBJECT_KEYS, AdvancedFilterType, ComponentsModule, FiltersComponent, FormFeatureType, ListComponent, MULTIMEDIA_DICTIONARY, OBJECTS_CATALOG_DEFAULTS, OBJECTS_CATALOG_SEO, ObjectDetailsBaseComponent, ObjectMediaService, ObjectsCatalogBaseComponent, ObjectsDataService, ObjectsFacade, ObjectsItemComponent, ObjectsListComponent, ObjectsModule, ObjectsService, ObjectsSharedModule, SERVICES, askAboutObjectHref, bibliography, descriptionHtml, getObjectsState, getReducer, initialState, inventoryValues, objectTitle, relatedArticles, tagValues };
 //# sourceMappingURL=smartsoft001-mobilems-objects-shell-angular.mjs.map