@smartsoft001-mobilems/objects-shell-angular 2.129.0 → 2.130.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/objects-shell-angular",
-  "version": "2.129.0",
+  "version": "2.130.0",
   "description": "This library was generated with [Nx](https://nx.dev).",
   "repository": {
     "type": "git",

package/types/smartsoft001-mobilems-objects-shell-angular.d.ts

@@ -1,10 +1,10 @@
 import * as _angular_core from '@angular/core';
-import { TemplateRef, ModuleWithProviders, Signal, AfterViewInit, WritableSignal, OnInit, ResourceRef } from '@angular/core';
+import { TemplateRef, ModuleWithProviders, Signal, AfterViewInit, WritableSignal, OnInit, ResourceRef, ElementRef } from '@angular/core';
 import * as _smartsoft001_crud_shell_angular from '@smartsoft001/crud-shell-angular';
 import { ICrudModuleOptionsWithoutRoutng, CrudFacade, State as State$1, CrudListPageBaseComponent, CrudItemPageBaseComponent, CrudService, ICrudFilter, ICrudFilterQueryItem } from '@smartsoft001/crud-shell-angular';
 import { IEntity } from '@smartsoft001/domain-core';
 import * as _smartsoft001_mobilems_angular from '@smartsoft001-mobilems/angular';
-import { FiltersBaseComponent, CrudBaseService, SeoService, TranslationService, IDictionaryPage, ICatalogOptions, ICatalog, ISeoMetadata, INamedEntrySource, INamedEntryParts, FilterType, IDictionaryEntry, FiltersContext, ThemeTag, ShareLinkBaseComponent } from '@smartsoft001-mobilems/angular';
+import { FiltersBaseComponent, CrudBaseService, SeoService, TranslationService, IDictionaryPage, ICatalogOptions, ICatalog, ISeoMetadata, INamedEntrySource, INamedEntryParts, FilterType, IDictionaryEntry, FiltersContext, ThemeTag, ShareLinkBaseComponent, FileUrlService, WidgetAudioItem } from '@smartsoft001-mobilems/angular';
 import * as i1 from '@angular/common';
 import { MsObject } from '@smartsoft001-mobilems/objects-domain';
 import * as dist_packages_objects_domain_src from 'dist/packages/objects/domain/src';
@@ -16,6 +16,9 @@ import { MsFile } from '@smartsoft001-mobilems/models';
 import { ListMode } from '@smartsoft001/angular';
 import * as rxjs from 'rxjs';
 import { Observable } from 'rxjs';
+import { TranslateService } from '@ngx-translate/core';
+import { SafeResourceUrl } from '@angular/platform-browser';
+import * as _smartsoft001_mobilems_objects_shell_angular from '@smartsoft001-mobilems/objects-shell-angular';
 
 declare class FiltersComponent extends FiltersBaseComponent<MsObject> {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FiltersComponent, never>;
@@ -1080,5 +1083,540 @@ declare abstract class ObjectsShareResultsBaseComponent extends ShareLinkBaseCom
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectsShareResultsBaseComponent, never, never, { "filter": { "alias": "filter"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { ASK_ABOUT_OBJECT_KEYS, AdvancedFilterType, ComponentsModule, FiltersComponent, FormFeatureType, ListComponent, MULTIMEDIA_DICTIONARY, OBJECTS_CATALOG_DEFAULTS, OBJECTS_CATALOG_SEO, OBJECTS_FILTER_SINGLE_VALUE_LABELS, OBJECTS_LIMIT_OPTIONS, OBJECTS_NEW_TYPE_SORT_OPTIONS, OBJECTS_SHARE_COPIED_TIMEOUT, OBJECTS_SORT_OPTIONS, OBJECTS_THEME_TAGS_FILTER_KEY, ObjectDetailsBaseComponent, ObjectMediaService, ObjectsAdvancedFiltersBaseComponent, ObjectsCatalogBaseComponent, ObjectsDataService, ObjectsFacade, ObjectsFiltersBarBaseComponent, ObjectsItemComponent, ObjectsListComponent, ObjectsModule, ObjectsSearchPanelBaseComponent, ObjectsService, ObjectsShareResultsBaseComponent, ObjectsSharedModule, SERVICES, askAboutObjectHref, bibliography, buildObjectsResultsUrl, descriptionHtml, getObjectsState, getReducer, initialState, inventoryValues, objectTitle, objectsSortFromKey, objectsSortKey, relatedArticles, tagValues };
-export type { ArchaeologicalSegregation, AskTranslate, FileType, IAnimationObject, IAskAboutObject, IKeyValue, IModel3DObject, IMultimediaDictionaryItem, IObjectBibliographyEntry, IObjectCollectionSummary, IObjectDetailLink, IObjectDetailSource, IObjectDetailsOptions, IObjectGalleryItem, IObjectRelated, IObjectsAdvancedFilterField, IObjectsAdvancedFilterWrite, IObjectsAdvancedFiltersOptions, IObjectsCatalogLoadMore, IObjectsCatalogOptions, IObjectsCatalogSeo, IObjectsDateRange, IObjectsFilterWrite, IObjectsFiltersBarOptions, ISpecificObject, ObjectDetailValue, ObjectsAdvancedFilterBoolean, ObjectsAdvancedFilterMode, SortType, State };
+/**
+ * Logic-only base of an object media tab (MOB-1801), from Muzeum Podlasia's
+ * `components/tabs`: the `item` and `formFeatureTypes` inputs and `models` —
+ * the object's `additionalImages` of the given form feature types, sorted by
+ * `position`. The tab keeps its template, styles and `host`.
+ *
+ * `mediaTabFilterModels(models)` is a hook (identity by default) that a tab
+ * overrides to narrow the list further.
+ *
+ * ```ts
+ * export class OtherFilesTabComponent extends ObjectMediaTabBaseComponent<IAnimationObject> {}
+ * ```
+ */
+declare abstract class ObjectMediaTabBaseComponent<TMedia extends {
+    id: number | string;
+}> {
+    protected readonly mediaTabFileUrl: FileUrlService;
+    protected readonly mediaTabTranslate: TranslateService;
+    /** The object whose media the tab shows. */
+    readonly item: _angular_core.InputSignal<MsObject>;
+    /** The form feature types (`FormFeatureType`) the tab shows. */
+    readonly formFeatureTypes: _angular_core.InputSignal<FormFeatureType[]>;
+    /** The object's media of `formFeatureTypes`, sorted by `position`, then through `mediaTabFilterModels`. */
+    readonly models: Signal<TMedia[]>;
+    /** Narrows the sorted list. Identity by default. */
+    protected mediaTabFilterModels(models: TMedia[]): TMedia[];
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectMediaTabBaseComponent<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectMediaTabBaseComponent<any>, never, never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "formFeatureTypes": { "alias": "formFeatureTypes"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the media tabs' download button, from Muzeum Podlasia's
+ * `download-button`: `download()` fetches `url`, saves the blob as `filename`
+ * through a temporary `<a download>` and revokes the object URL. It runs only
+ * from a click, so never on the server. The button keeps its template.
+ *
+ * ```ts
+ * export class DownloadButtonComponent extends ObjectDownloadButtonBaseComponent {}
+ * ```
+ */
+declare abstract class ObjectDownloadButtonBaseComponent {
+    private readonly downloadButtonDocument;
+    /** The file URL. An empty URL does nothing. */
+    readonly url: _angular_core.InputSignal<string>;
+    /** The name the file is saved under. */
+    readonly filename: _angular_core.InputSignal<string>;
+    /** `true` while the file is being fetched. */
+    readonly isDownloading: _angular_core.WritableSignal<boolean>;
+    download(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectDownloadButtonBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectDownloadButtonBaseComponent, never, never, { "url": { "alias": "url"; "required": true; "isSignal": true; }; "filename": { "alias": "filename"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/** The `archeoMap` field of an object card (coordinates as strings). */
+interface IObjectArcheoMap {
+    latitude: string;
+    longitude: string;
+}
+/**
+ * Logic-only base of the object map tab, from Muzeum Podlasia's `map-tab`:
+ * the object's `archeoMap` coordinates. The tab keeps its template (the map
+ * component and its zoom).
+ *
+ * ```ts
+ * export class MapTabComponent extends ObjectMapTabBaseComponent {}
+ * ```
+ */
+declare abstract class ObjectMapTabBaseComponent {
+    /** The object whose `archeoMap` the tab shows. */
+    readonly item: _angular_core.InputSignal<MsObject>;
+    private readonly mapTabArcheoMap;
+    /** Truthy (the longitude string) when both coordinates are set. */
+    readonly hasCoordinates: _angular_core.Signal<string>;
+    /** `parseFloat(latitude)`, `0` when missing. */
+    readonly latitude: _angular_core.Signal<number>;
+    /** `parseFloat(longitude)`, `0` when missing. */
+    readonly longitude: _angular_core.Signal<number>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectMapTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectMapTabBaseComponent, never, never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of an object tab with native `<audio>` players (MOB-1801):
+ * the file URL, title, aria label and download file name of each recording,
+ * shared by `ObjectAudioTabBaseComponent` and
+ * `ObjectAudioDescriptionTabBaseComponent`. The fallback label comes from
+ * `audioMediaTabLabelKey`, read lazily, so a subclass overrides it with a
+ * field.
+ *
+ * ```ts
+ * protected override readonly audioMediaTabLabelKey = 'DETAILS_PAGE.tabs.audio';
+ * ```
+ */
+declare abstract class ObjectAudioMediaTabBaseComponent<TMedia extends IAnimationObject = IAnimationObject> extends ObjectMediaTabBaseComponent<TMedia> {
+    /** Translation key of the player label; read lazily, so a subclass can override it. */
+    protected readonly audioMediaTabLabelKey: string;
+    /** The recording's file URL (`noCache`). */
+    getAudioUrl(audio: TMedia): string;
+    /** Alt text in the current language, then the description, then the label key. */
+    getAudioTitle(audio: TMedia): string;
+    /** `<label>: <title>`. */
+    getAudioAriaLabel(audio: TMedia): string;
+    /** The object title, alt text, description or `audio`, plus the extension (`mp3` by default). */
+    getDownloadFilename(audio: TMedia): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectAudioMediaTabBaseComponent<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectAudioMediaTabBaseComponent<any>, never, never, {}, {}, never, never, true, never>;
+}
+
+/** Options of `ObjectAudioTabBaseComponent`, passed to `super(options)`. */
+interface IObjectAudioTabOptions {
+    /**
+     * Keep only recordings with a file (`filePath`), so the "Audio 1, 2…"
+     * numbering counts what is shown (MOB-1872 review). Default `true`
+     * (Muzeum Podlasia); `false` keeps the unfiltered list (sztuki-2, template).
+     */
+    playableOnly?: boolean;
+}
+/**
+ * Logic-only base of the object audio tab (MOB-1801). Muzeum Podlasia renders
+ * the article player (`app-widget-audio` on `WidgetAudioBaseComponent`,
+ * MOB-1805 / MOB-1872) through `widgetItem` and `trackName`; sztuki-2 and the
+ * template render a native `<audio>` with a download button through
+ * `getAudioUrl`, `getAudioTitle`, `getAudioAriaLabel` and
+ * `getDownloadFilename` (`ObjectAudioMediaTabBaseComponent`, label
+ * `DETAILS_PAGE.tabs.audio`), with `playableOnly: false`. The tab keeps its
+ * template, styles and `host`.
+ *
+ * ```ts
+ * export class AudioTabComponent extends ObjectAudioTabBaseComponent {
+ *   constructor() {
+ *     super(); // sztuki-2 / template: super({ playableOnly: false })
+ *   }
+ * }
+ * ```
+ */
+declare abstract class ObjectAudioTabBaseComponent extends ObjectAudioMediaTabBaseComponent {
+    protected readonly audioMediaTabLabelKey: string;
+    private readonly audioTabOptions;
+    protected constructor(options?: IObjectAudioTabOptions);
+    /** With `playableOnly` (default) only recordings with a file. */
+    protected mediaTabFilterModels(models: IAnimationObject[]): IAnimationObject[];
+    /**
+     * The recording in the audio widget's shape: the file in `file`, the
+     * heading from the description (without one — a player without a heading,
+     * as in the mock-up).
+     */
+    widgetItem(audio: IAnimationObject): WidgetAudioItem;
+    /**
+     * The recording's name for screen readers (the player's button and
+     * slider): the alt text in the current language or the description;
+     * several recordings without names — "Audio 1", "Audio 2"… (MOB-1872
+     * review); a single one — `null`.
+     */
+    trackName(audio: IAnimationObject, index: number): string | null;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectAudioTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectAudioTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the object audio description tab (MOB-1801), from Muzeum
+ * Podlasia's `audio-description-tab.component.ts` (sztuki-2 and the template
+ * differ by one template class only): the main image above the players and
+ * the names of each recording (`ObjectAudioMediaTabBaseComponent`, label
+ * `OBJECTS.filters.multimedia.audio`). The tab keeps its template, styles and `host`.
+ *
+ * ```ts
+ * export class AudioDescriptionTabComponent extends ObjectAudioDescriptionTabBaseComponent {}
+ * ```
+ */
+declare abstract class ObjectAudioDescriptionTabBaseComponent extends ObjectAudioMediaTabBaseComponent {
+    /** The object's main image (`big` = full resolution without cache); `null` without one or for the no-image placeholder. */
+    readonly mainImageUrl: Signal<string | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectAudioDescriptionTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectAudioDescriptionTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the object documents tab (MOB-1801), from Muzeum
+ * Podlasia's `documents-tab.component.ts` (sztuki-2 and the template differ by
+ * one template class only): each document's URL, display name and download
+ * file name. The tab keeps its template, styles and `host`.
+ *
+ * ```ts
+ * export class DocumentsTabComponent extends ObjectDocumentsTabBaseComponent {}
+ * ```
+ */
+declare abstract class ObjectDocumentsTabBaseComponent extends ObjectMediaTabBaseComponent<IAnimationObject> {
+    /** The document's file URL (`noCache`). */
+    getDocumentUrl(doc: IAnimationObject): string;
+    /** Alt text in the current language, then the description, then the upper-case extension (`PDF` by default). */
+    getDocumentDisplayName(doc: IAnimationObject): string;
+    /** Alt text in the current language, description or `document`, plus the extension (`pdf` by default). */
+    getDocumentFileName(doc: IAnimationObject): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectDocumentsTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectDocumentsTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of an object tab with one video at a time and a dropdown
+ * (MOB-1801), shared by `ObjectAnimationTabBaseComponent` and
+ * `ObjectVideoTabBaseComponent`, 1:1 from Muzeum Podlasia's animation and
+ * video tabs: the selector state, the player reset on a change and the
+ * player helpers. The translation keys and the download fallback name are
+ * abstract fields, read lazily.
+ */
+declare abstract class ObjectVideoMediaTabBaseComponent<TMedia extends IAnimationObject = IAnimationObject> extends ObjectMediaTabBaseComponent<TMedia> {
+    /** Translation key of a dropdown option without a name (`<label> <n>`). */
+    protected abstract readonly videoMediaTabOptionLabelKey: string;
+    /** Translation key of the player title and aria label. */
+    protected abstract readonly videoMediaTabTitleKey: string;
+    /** Download file name without the object title, alt text and description. */
+    protected abstract readonly videoMediaTabDownloadName: string;
+    /** The template's native `<video #videoPlayer>`, if it has one. */
+    readonly videoPlayer: Signal<ElementRef<HTMLVideoElement>>;
+    private readonly videoMediaTabPicker;
+    /** The chosen video's key; the first video of each new object. */
+    readonly selectedVideoKey: WritableSignal<string | null>;
+    /** Dropdown options: alt text, description or `<label> <n>`. */
+    readonly videoOptions: Signal<IKeyValue[]>;
+    /** The chosen video, the first one by default. */
+    readonly selectedVideo: Signal<TMedia | null>;
+    /** The dropdown option of `selectedVideo`. */
+    readonly selectedVideoOption: Signal<IKeyValue>;
+    /** Selects a video; a native `#videoPlayer` is paused and rewound. */
+    videoChange(key: string): void;
+    /** The video's file URL (`noCache`). */
+    getVideoUrl(video: TMedia): string;
+    /** Alt text in the current language, then the description, then the title key. */
+    getVideoTitle(video: TMedia): string;
+    /** `<title key>: <title>`. */
+    getVideoAriaLabel(video: TMedia): string;
+    /** The object title, alt text, description or the fallback name, plus the extension (`mp4` by default). */
+    getDownloadFilename(video: TMedia): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectVideoMediaTabBaseComponent<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectVideoMediaTabBaseComponent<any>, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the object animation tab (MOB-1801), 1:1 from Muzeum
+ * Podlasia (sztuki-2 and the template are identical): options without a name
+ * are `OBJECTS.filters.multimedia.animation <n>`, the player is titled with
+ * `OBJECTS.filters.multimedia.video`, the download falls back to
+ * `animation.mp4`, and `videoChange` pauses and rewinds `#videoPlayer`. The
+ * tab keeps its template, styles and `host`.
+ *
+ * ```ts
+ * export class AnimationTabComponent extends ObjectAnimationTabBaseComponent {}
+ * ```
+ */
+declare abstract class ObjectAnimationTabBaseComponent extends ObjectVideoMediaTabBaseComponent {
+    protected readonly videoMediaTabOptionLabelKey: string;
+    protected readonly videoMediaTabTitleKey: string;
+    protected readonly videoMediaTabDownloadName: string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectAnimationTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectAnimationTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the object video tab (MOB-1801). Options, title and
+ * aria label use `DETAILS_PAGE.tabs.video`. Muzeum Podlasia renders the app's
+ * video player (a new source resets it — a still frame with a play button,
+ * no playback), so its template has no `#videoPlayer` and `videoChange` only
+ * selects the video. Sztuki-2 and the template render a native
+ * `<video #videoPlayer>`, which `videoChange` pauses and rewinds, and a
+ * download button named by `getDownloadFilename` (fallback `video.mp4`). The
+ * tab keeps its template, styles and `host`.
+ *
+ * ```ts
+ * export class VideoTabComponent extends ObjectVideoTabBaseComponent {}
+ * ```
+ */
+declare abstract class ObjectVideoTabBaseComponent extends ObjectVideoMediaTabBaseComponent {
+    protected readonly videoMediaTabOptionLabelKey: string;
+    protected readonly videoMediaTabTitleKey: string;
+    protected readonly videoMediaTabDownloadName: string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectVideoTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectVideoTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the object virtual walk tab (MOB-1801), 1:1 from Muzeum
+ * Podlasia (sztuki-2 and the template are identical): the walk dropdown, the
+ * trusted iframe source and the fullscreen toggle of `#walkContainer`. The
+ * `fullscreenchange` listener is registered in the browser only, through the
+ * injected `DOCUMENT`, and removed on destroy. The tab keeps its template,
+ * styles and `host`.
+ *
+ * ```ts
+ * export class VirtualWalkTabComponent extends ObjectVirtualWalkTabBaseComponent {
+ *   constructor() {
+ *     super();
+ *   }
+ * }
+ * ```
+ */
+declare abstract class ObjectVirtualWalkTabBaseComponent extends ObjectMediaTabBaseComponent<IModel3DObject> {
+    private readonly virtualWalkTabSanitizer;
+    private readonly virtualWalkTabDocument;
+    /** The template's `#iframeContainer`. */
+    readonly iframeContainer: Signal<ElementRef<any>>;
+    /** The template's `#walkContainer`, the element shown fullscreen. */
+    readonly walkContainer: Signal<ElementRef<any>>;
+    private readonly virtualWalkTabPicker;
+    /** The chosen walk's key; the first walk of each new object. */
+    readonly selectedWalkKey: WritableSignal<string | null>;
+    /** Dropdown options: alt text, description or `OBJECTS.filters.multimedia.virtualWalk <n>`. */
+    readonly walkOptions: Signal<IKeyValue[]>;
+    /** The chosen walk, the first one by default. */
+    readonly selectedWalk: Signal<IModel3DObject | null>;
+    /** The dropdown option of `selectedWalk`. */
+    readonly selectedWalkOption: Signal<IKeyValue>;
+    /** The selected walk's `iframeSource`, trusted; `null` without one. */
+    readonly safeIframeUrl: Signal<SafeResourceUrl | null>;
+    /** Whether the document is in fullscreen (follows `fullscreenchange`, e.g. Escape). */
+    readonly isFullscreen: WritableSignal<boolean>;
+    protected constructor();
+    /** Selects a walk. */
+    walkChange(key: string): void;
+    /** Alt text in the current language, then the description, then `OBJECTS.filters.multimedia.virtualWalk`. */
+    getWalkTitle(walk: IModel3DObject): string;
+    /** Shows `#walkContainer` fullscreen, or leaves fullscreen. */
+    toggleFullscreen(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectVirtualWalkTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectVirtualWalkTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/** The `online-3d-viewer` `Viewer` calls the 3D tab makes. */
+interface IObjectModel3dViewer {
+    SetUpVector(direction: unknown, animate: boolean): void;
+    GetBoundingSphere(filter: (meshUserData: unknown) => boolean): unknown;
+    AdjustClippingPlanesToSphere(sphere: unknown): void;
+    FitSphereToWindow(sphere: unknown, animate: boolean): void;
+    SetEdgeSettings(settings: unknown): void;
+}
+/** The `online-3d-viewer` `EmbeddedViewer` calls the 3D tab makes. */
+interface IObjectModel3dEmbeddedViewer {
+    LoadModelFromUrlList(urls: string[]): void;
+    Destroy(): void;
+    GetViewer(): IObjectModel3dViewer;
+}
+/**
+ * The part of the `online-3d-viewer` module the 3D tab uses. The framework
+ * does not depend on the library: the museum returns its own
+ * `import('online-3d-viewer')` from `loadModel3dLibrary()`, which is
+ * assignable without a cast.
+ *
+ * The colour and edge slots of the `EmbeddedViewer` parameters and the
+ * `EdgeSettings` colour are `any`: constructor parameters are checked
+ * contravariantly (`strictFunctionTypes`), so anything narrower would have to
+ * restate the library's `RGBAColor`, `RGBColor` and `EdgeSettings` classes
+ * member by member. The values come from the same module's constructors.
+ */
+interface IObjectModel3dViewerLibrary {
+    EmbeddedViewer: new (parentElement: HTMLElement, parameters: {
+        backgroundColor: any;
+        defaultColor: any;
+        edgeSettings: any;
+        onModelLoaded: () => void;
+    }) => IObjectModel3dEmbeddedViewer;
+    RGBAColor: new (r: number, g: number, b: number, a: number) => unknown;
+    RGBColor: new (r: number, g: number, b: number) => unknown;
+    EdgeSettings: new (showEdges: boolean, edgeColor: any, edgeThreshold: number) => unknown;
+    Direction: {
+        Y: unknown;
+    };
+}
+/** Options of `ObjectModel3dTabBaseComponent`, passed to `super(options)`. */
+interface IObjectModel3dTabOptions {
+    /**
+     * Keep only models with at least one file to load (`files[].filePath`) —
+     * the same condition as the tab counter, so the default model does not end
+     * in "No files found" (MOB-1872 review). Default `true` (Muzeum Podlasia);
+     * `false` keeps the unfiltered list (sztuki-2, template).
+     */
+    loadableOnly?: boolean;
+}
+/**
+ * Logic-only base of the object 3D model tab (MOB-1801), 1:1 from Muzeum
+ * Podlasia: the model list, the lazily loaded `online-3d-viewer`, the model
+ * switch, the camera reset, the wireframe and the fullscreen toggle. The tab
+ * keeps its template, styles and `host`, and returns its own
+ * `import('online-3d-viewer')` from `loadModel3dLibrary()` — the framework does
+ * not depend on the library, and the viewer is never loaded on the server.
+ * Podlasie's model file URI panel (MOB-981) stays in Podlasie and follows
+ * `selectedModel`.
+ *
+ * ```ts
+ * export class Model3dTabComponent extends ObjectModel3dTabBaseComponent {
+ *   constructor() {
+ *     super(); // sztuki-2 / template: super({ loadableOnly: false })
+ *   }
+ *
+ *   protected loadModel3dLibrary() {
+ *     return import('online-3d-viewer');
+ *   }
+ * }
+ * ```
+ */
+declare abstract class ObjectModel3dTabBaseComponent extends ObjectMediaTabBaseComponent<IModel3DObject> {
+    /** The template's `#viewer3d`, the viewer's canvas container. */
+    readonly viewer3d: _angular_core.Signal<ElementRef<any>>;
+    /** The chosen model's index, bound with `ngModel` (may arrive as a string). */
+    selectedModelIndex: number;
+    /** The chosen model's index as a signal, next to `selectedModelIndex` (`onModelChange`). */
+    readonly selectedModel: WritableSignal<number>;
+    /** A model is loading. */
+    readonly isLoading: WritableSignal<boolean>;
+    /** The load error, `null` without one. */
+    readonly error: WritableSignal<string | null>;
+    /** The edges are shown. */
+    readonly isWireframe: WritableSignal<boolean>;
+    /** Whether the document is in fullscreen (follows `fullscreenchange`, e.g. Escape). */
+    readonly isFullscreen: WritableSignal<boolean>;
+    private readonly model3dTabOptions;
+    private readonly model3dTabDocument;
+    private readonly model3dTabPlatformId;
+    private readonly model3dTabTimeouts;
+    /**
+     * `online-3d-viewer` (+ `three`, ~1.1 MB) is loaded only on the first
+     * init — a static import put the library in the chunk of the whole objects
+     * module, loaded on the `/obiekty` list and every card, also without a 3D
+     * model (Lighthouse, MOB-1850, MOB-1895). One load is shared between
+     * concurrent calls. Created on first use.
+     */
+    private model3dTabLibraryLoader;
+    /** The number of the latest init — an older call after `await` does not overwrite a newer one. */
+    private model3dTabInitToken;
+    private model3dTabViewer;
+    protected constructor(options?: IObjectModel3dTabOptions);
+    /** The museum's `import('online-3d-viewer')`. Called once, in the browser, on the first init. */
+    protected abstract loadModel3dLibrary(): Promise<IObjectModel3dViewerLibrary>;
+    /** With `loadableOnly` (default) only models with a file to load. */
+    protected mediaTabFilterModels(models: IModel3DObject[]): IModel3DObject[];
+    /** Follows the `selectedModelIndex` dropdown: sets `selectedModel` and loads that model. */
+    onModelChange(): void;
+    /** Fits the model to the window with the Y axis up. A no-op before the library is loaded. */
+    resetCamera(): void;
+    /** Shows or hides the edges. A no-op before the library is loaded. */
+    toggleWireframe(): void;
+    /** Shows the parent of `#viewer3d` fullscreen, or leaves fullscreen. */
+    toggleFullscreen(): void;
+    private model3dTabLibrary;
+    private model3dTabInitViewer;
+    private model3dTabLoadModel;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectModel3dTabBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectModel3dTabBaseComponent, never, never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Logic-only base of the sztuki-2 / template `media-sections`: an object's
+ * multimedia as landing-page sections (Figma), each with a heading like
+ * „Galeria zdjęć”; a section without data is not rendered. Order: HD photos →
+ * 3D model → animation → video → audio → virtual walk → audio description →
+ * map → other files. The component keeps its template, heading class and
+ * tab imports.
+ *
+ * ```ts
+ * export class MediaSectionsComponent extends ObjectMediaSectionsBaseComponent {
+ *   readonly sectionHeadingClass = '…';
+ * }
+ * ```
+ */
+declare abstract class ObjectMediaSectionsBaseComponent {
+    private readonly mediaSectionsFileUrl;
+    private readonly mediaSectionsMedia;
+    /** The object whose multimedia the sections show. */
+    readonly item: _angular_core.InputSignal<MsObject>;
+    /**
+     * Multimedia already shown in the object card's gallery frame (the video /
+     * 3D tabs, MOB-1961) — not repeated in the sections. Default `[]`.
+     */
+    readonly exclude: _angular_core.InputSignal<readonly ("video" | "model3d")[]>;
+    /** `[IMAGES_HD]` */
+    readonly imagesHDTypes: FormFeatureType[];
+    /** `[MODEL_3D]` */
+    readonly model3DTypes: FormFeatureType[];
+    /** `[ANIMATION]` */
+    readonly animationTypes: FormFeatureType[];
+    /** `[AUDIO_DESKRYPCJA]` */
+    readonly adTypes: FormFeatureType[];
+    /** `[VIRTUAL_WALK]` */
+    readonly virtualWalkTypes: FormFeatureType[];
+    /** `[VIDEO]` */
+    readonly videoTypes: FormFeatureType[];
+    /** `[AUDIO]` */
+    readonly audioTypes: FormFeatureType[];
+    /** `[OTHER]` */
+    readonly otherTypes: FormFeatureType[];
+    /** HD photo thumbnails (without the main image) — fullscreen on click. */
+    readonly hdThumbnailUrls: _angular_core.Signal<string[]>;
+    /** HD photo gallery items (without the main image) for the fullscreen. */
+    readonly hdGalleryItems: _angular_core.Signal<_smartsoft001_mobilems_objects_shell_angular.IObjectGalleryItem[]>;
+    /** Whether the HD fullscreen gallery is open. */
+    readonly hdFullscreenOpen: _angular_core.WritableSignal<boolean>;
+    /** The photo the HD fullscreen gallery shows. */
+    readonly hdFullscreenIndex: _angular_core.WritableSignal<number>;
+    /** Opens the HD fullscreen gallery at the clicked thumbnail. */
+    openHdFullscreen(index: number): void;
+    /** The object title without HTML tags (alt text). */
+    readonly altTitle: _angular_core.Signal<string>;
+    /** HD photos section: any HD thumbnail. */
+    readonly showPhotosHD: _angular_core.Signal<boolean>;
+    /** 3D model section: a real file URL, unless excluded. */
+    readonly showModel3D: _angular_core.Signal<boolean>;
+    /** Animation section: a real file URL. */
+    readonly showAnimation: _angular_core.Signal<boolean>;
+    /**
+     * Video section: a file with a `filePath` (`FileUrlService` gives a
+     * placeholder for non-image extensions), unless excluded.
+     */
+    readonly showVideo: _angular_core.Signal<boolean>;
+    /** Audio section: a file with a `filePath`. */
+    readonly showAudio: _angular_core.Signal<boolean>;
+    /** Virtual walk section: a walk with an `iframeSource` (not a file URL). */
+    readonly showVirtualWalk: _angular_core.Signal<boolean>;
+    /** The number of audio description files with a real URL. */
+    readonly audioDescriptionCount: _angular_core.Signal<number>;
+    /** Audio description section: any audio description. */
+    readonly showAudioDescription: _angular_core.Signal<boolean>;
+    /** Map section: both `archeoMap` coordinates set. */
+    readonly showMap: _angular_core.Signal<boolean>;
+    /** Other files section (PDF, etc.): a real file URL. */
+    readonly showOther: _angular_core.Signal<boolean>;
+    /** Whether any section is visible. */
+    readonly hasVisibleSections: _angular_core.Signal<boolean>;
+    /**
+     * Whether an additional file of the types has a URL from `FileUrlService`
+     * that is not the no-image placeholder. Reads `item()`, so the calling
+     * `computed` tracks it.
+     */
+    private mediaSectionsHasContent;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ObjectMediaSectionsBaseComponent, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<ObjectMediaSectionsBaseComponent, never, never, { "item": { "alias": "item"; "required": true; "isSignal": true; }; "exclude": { "alias": "exclude"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+export { ASK_ABOUT_OBJECT_KEYS, AdvancedFilterType, ComponentsModule, FiltersComponent, FormFeatureType, ListComponent, MULTIMEDIA_DICTIONARY, OBJECTS_CATALOG_DEFAULTS, OBJECTS_CATALOG_SEO, OBJECTS_FILTER_SINGLE_VALUE_LABELS, OBJECTS_LIMIT_OPTIONS, OBJECTS_NEW_TYPE_SORT_OPTIONS, OBJECTS_SHARE_COPIED_TIMEOUT, OBJECTS_SORT_OPTIONS, OBJECTS_THEME_TAGS_FILTER_KEY, ObjectAnimationTabBaseComponent, ObjectAudioDescriptionTabBaseComponent, ObjectAudioMediaTabBaseComponent, ObjectAudioTabBaseComponent, ObjectDetailsBaseComponent, ObjectDocumentsTabBaseComponent, ObjectDownloadButtonBaseComponent, ObjectMapTabBaseComponent, ObjectMediaSectionsBaseComponent, ObjectMediaService, ObjectMediaTabBaseComponent, ObjectModel3dTabBaseComponent, ObjectVideoMediaTabBaseComponent, ObjectVideoTabBaseComponent, ObjectVirtualWalkTabBaseComponent, ObjectsAdvancedFiltersBaseComponent, ObjectsCatalogBaseComponent, ObjectsDataService, ObjectsFacade, ObjectsFiltersBarBaseComponent, ObjectsItemComponent, ObjectsListComponent, ObjectsModule, ObjectsSearchPanelBaseComponent, ObjectsService, ObjectsShareResultsBaseComponent, ObjectsSharedModule, SERVICES, askAboutObjectHref, bibliography, buildObjectsResultsUrl, descriptionHtml, getObjectsState, getReducer, initialState, inventoryValues, objectTitle, objectsSortFromKey, objectsSortKey, relatedArticles, tagValues };
+export type { ArchaeologicalSegregation, AskTranslate, FileType, IAnimationObject, IAskAboutObject, IKeyValue, IModel3DObject, IMultimediaDictionaryItem, IObjectArcheoMap, IObjectAudioTabOptions, IObjectBibliographyEntry, IObjectCollectionSummary, IObjectDetailLink, IObjectDetailSource, IObjectDetailsOptions, IObjectGalleryItem, IObjectModel3dEmbeddedViewer, IObjectModel3dTabOptions, IObjectModel3dViewer, IObjectModel3dViewerLibrary, IObjectRelated, IObjectsAdvancedFilterField, IObjectsAdvancedFilterWrite, IObjectsAdvancedFiltersOptions, IObjectsCatalogLoadMore, IObjectsCatalogOptions, IObjectsCatalogSeo, IObjectsDateRange, IObjectsFilterWrite, IObjectsFiltersBarOptions, ISpecificObject, ObjectDetailValue, ObjectsAdvancedFilterBoolean, ObjectsAdvancedFilterMode, SortType, State };