@smartsoft001-mobilems/creators-shell-angular 2.123.0 → 2.125.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/creators-shell-angular",
-  "version": "2.123.0",
+  "version": "2.125.0",
   "description": "This library was generated with [Nx](https://nx.dev).",
   "repository": {
     "type": "git",
@@ -16,10 +16,10 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@smartsoft001-mobilems/angular": "^2.123.0",
-    "@smartsoft001-mobilems/creators-domain": "^2.123.0",
-    "@smartsoft001-mobilems/creators-shell-dtos": "^2.123.0",
-    "@smartsoft001-mobilems/objects-domain": "^2.123.0"
+    "@smartsoft001-mobilems/angular": "^2.125.0",
+    "@smartsoft001-mobilems/creators-domain": "^2.125.0",
+    "@smartsoft001-mobilems/creators-shell-dtos": "^2.125.0",
+    "@smartsoft001-mobilems/objects-domain": "^2.125.0"
   },
   "module": "fesm2022/smartsoft001-mobilems-creators-shell-angular.mjs",
   "typings": "types/smartsoft001-mobilems-creators-shell-angular.d.ts",

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

@@ -46,6 +46,13 @@ declare function creatorsIndexPrefixOf(name: string): string;
  * ignored. Diacritics count: the API keeps `Be` and `Bé` apart.
  */
 declare function creatorsFindPrefix(raw: string | null, prefixes: readonly string[]): string | null;
+/**
+ * A whole index letter split into the API groups (`prefixes`, as `getPrefixes`
+ * gives them), in their order; empty groups are left out. A creator whose group
+ * the API did not list (data drift) still shows, in a group of its own after the
+ * listed ones. Items keep their order (`getByIndexPrefix` sorts them).
+ */
+declare function groupCreatorsByIndexPrefixes(items: readonly Creator[], prefixes: readonly string[]): ICreatorsPrefixGroup[];
 /** `?litera=` query param to index letter; invalid or missing falls back to `A`. */
 declare function parseCreatorsLetter(raw: string | null): CreatorsLetter;
 /**
@@ -329,6 +336,7 @@ declare const CREATORS_INDEX_PREFIX_PARAM = "prefiks";
 /**
  * The index view (museum-artists MOB-1959): the letter's two-letter groups
  * (`prefixes`), the group shown (`prefix`, `?prefiks=` or the first one) and its creators.
+ * With `creatorsIndexWholeLetter()` and no `?prefiks=`, `prefix` is `null` and `items` is the whole letter.
  */
 interface ICreatorsIndexState {
     status: 'loading' | 'error' | 'success';
@@ -336,7 +344,10 @@ interface ICreatorsIndexState {
     prefix: string | null;
     items: Creator[];
 }
-/** A group of the letter with its DOM anchor; only the shown group carries items. */
+/**
+ * A group of the letter with its DOM anchor; only the shown group carries items — every group of the
+ * whole letter does (`creatorsIndexWholeLetter()`).
+ */
 interface ICreatorsIndexGroup extends ICreatorsPrefixGroup {
     anchor: string;
 }
@@ -405,7 +416,28 @@ declare abstract class CreatorsIndexBaseComponent {
     retry(): void;
     private creatorsIndexFocusFiltersButton;
     private creatorsIndexApplySeo;
+    /**
+     * `true`: a letter shows its whole list split into the API groups, and `?prefiks=` only narrows it
+     * (MobileMS, Łukasz 22.10: „kliknięcie A powinno całą listę zwrócić”). `false` (the default, kept
+     * for the museums built on it) opens the first group. A method, not a field: a cached letter can
+     * load while the base initialisers still run, before a subclass field would be set.
+     */
+    protected creatorsIndexWholeLetter(): boolean;
+    /**
+     * A `?prefiks=` of this letter the API did not list (a group shown from the whole letter's data),
+     * in the index form (`cv` → `Cv`); `null` for anything else. Not for `#`, whose groups are local.
+     * Two characters only: a one-character group is the letter itself (a creator named `X`), and
+     * `lastNameSw` on it is the whole letter, so it cannot narrow.
+     */
+    /** The prefix a `#fragment` names: a group anchor (`tworcy-43-76`) read back, or the fragment itself (`#Cv`). */
+    private creatorsIndexFragmentPrefix;
+    private creatorsIndexUnlistedPrefix;
     private creatorsIndexLoad;
+    /**
+     * Every creator of a letter: one `lastNameSw` search on the letter, or for `#` (no API filter)
+     * its groups, read from the service's cached bucket.
+     */
+    private creatorsIndexLetter;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CreatorsIndexBaseComponent, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CreatorsIndexBaseComponent, never, never, {}, {}, never, never, true, never>;
 }
@@ -414,7 +446,8 @@ declare abstract class CreatorsIndexBaseComponent {
  * Logic of the mobile "go to" panel of the creators index (museum-artists'
  * `index-filters-mobile`, MOB-1949/1959). The choice is a draft until `apply()`:
  * another letter emits `letterChange`, a prefix of the current letter emits
- * `prefixSelect`. Every way out (close, backdrop, Escape, apply) emits `closed`;
+ * `prefixSelect`, and — with `creatorsJumpToWholeLetter()` — unpressing the shown prefix
+ * (`togglePrefix`) emits the current letter, its whole list. Every way out (close, backdrop, Escape, apply) emits `closed`;
  * the host removes the panel and moves the focus on.
  *
  * Escape is bound here (`host`), so a subclass must not bind it again.
@@ -441,7 +474,14 @@ declare abstract class CreatorsJumpToBaseComponent {
     readonly topOffset: _angular_core.WritableSignal<number>;
     constructor();
     selectLetter(letter: CreatorsLetter): void;
+    /** Presses a prefix; the pressed one again goes back to no prefix (the whole letter). */
+    togglePrefix(prefix: string): void;
     apply(): void;
+    /**
+     * `true` beside an index with `creatorsIndexWholeLetter()`: unpressing the shown prefix goes back to
+     * the whole letter. `false` (the default) keeps the panel's apply a no-op then.
+     */
+    protected creatorsJumpToWholeLetter(): boolean;
     close(): void;
     private creatorsJumpToMeasureHeader;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CreatorsJumpToBaseComponent, never>;
@@ -816,13 +856,17 @@ declare abstract class CreatorDetailsBaseComponent<TRelatedItem = MsObject> {
     /** `creator/{id}` gives a ready `url`; a MUZA file (`filePath`) goes through `FileUrlService`. */
     private creatorDetailsImageOf;
     private creatorDetailsGalleryOf;
-    /** `creatorDetailsSeoTitle`, the plain biography (`creatorBiography`), the first image, the canonical. */
-    private creatorDetailsSeoOf;
+    /**
+     * `creatorDetailsSeoTitle`, the plain biography (`creatorBiography`), the first image, the canonical
+     * with the slug (`resolveRelativeUrl`, so `MuseumSeoService` does not fall back to the request URL).
+     * Override to change the metadata; used on the page and on the server.
+     */
+    protected creatorDetailsSeoMetadata(creator: Creator): ISeoMetadata;
     private creatorDetailsFetchSsrSeo;
     private creatorDetailsT;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CreatorDetailsBaseComponent<any>, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<CreatorDetailsBaseComponent<any>, never, never, {}, {}, never, never, true, never>;
 }
 
-export { CREATORS_ALPHABET, CREATORS_CATALOG_DEFAULTS, CREATORS_HASH_PREFIXES, CREATORS_INDEX_LETTER_PARAM, CREATORS_INDEX_PREFIX_PARAM, CREATORS_SEARCH_LIMIT, CREATORS_SEARCH_PAGE_SIZES, CREATOR_DETAILS_KEYS, CREATOR_RELATED_STRIPS, CreatorCardBaseComponent, CreatorDetailsBaseComponent, CreatorsCatalogBaseComponent, CreatorsFiltersBaseComponent, CreatorsIndexBaseComponent, CreatorsJumpToBaseComponent, CreatorsListContext, CreatorsSearchListBaseComponent, CreatorsService, EMPTY_CREATORS_FILTER, createCreatorsCatalog, createCreatorsFacade, creatorBiography, creatorBiographyExcerpt, creatorDetailsCommands, creatorDictLabel, creatorDictionaryUrl, creatorDisplayName, creatorIsLongBiography, creatorLifeYears, creatorNfdLetter, creatorPlainName, creatorPlainText, creatorProfileUrl, creatorRelatedUrl, creatorRoles, creatorSlug, creatorWorksUrl, creatorYears, creatorsDisplayPrefix, creatorsFilterQueryParams, creatorsFilterToQuery, creatorsFilterValueOf, creatorsFindPrefix, creatorsIndexPrefixOf, creatorsLetterOf, creatorsListSeoMetadata, creatorsListUrl, creatorsPrefixAnchor, creatorsPrefixOf, creatorsPrefixesUrl, groupCreatorsByLetter, groupCreatorsByPrefix, hasCreatorsFilter, isCreatorsBirthRangeValid, isCreatorsBirthYear, parseCreatorsLetter, resolveCreatorsFragment };
+export { CREATORS_ALPHABET, CREATORS_CATALOG_DEFAULTS, CREATORS_HASH_PREFIXES, CREATORS_INDEX_LETTER_PARAM, CREATORS_INDEX_PREFIX_PARAM, CREATORS_SEARCH_LIMIT, CREATORS_SEARCH_PAGE_SIZES, CREATOR_DETAILS_KEYS, CREATOR_RELATED_STRIPS, CreatorCardBaseComponent, CreatorDetailsBaseComponent, CreatorsCatalogBaseComponent, CreatorsFiltersBaseComponent, CreatorsIndexBaseComponent, CreatorsJumpToBaseComponent, CreatorsListContext, CreatorsSearchListBaseComponent, CreatorsService, EMPTY_CREATORS_FILTER, createCreatorsCatalog, createCreatorsFacade, creatorBiography, creatorBiographyExcerpt, creatorDetailsCommands, creatorDictLabel, creatorDictionaryUrl, creatorDisplayName, creatorIsLongBiography, creatorLifeYears, creatorNfdLetter, creatorPlainName, creatorPlainText, creatorProfileUrl, creatorRelatedUrl, creatorRoles, creatorSlug, creatorWorksUrl, creatorYears, creatorsDisplayPrefix, creatorsFilterQueryParams, creatorsFilterToQuery, creatorsFilterValueOf, creatorsFindPrefix, creatorsIndexPrefixOf, creatorsLetterOf, creatorsListSeoMetadata, creatorsListUrl, creatorsPrefixAnchor, creatorsPrefixOf, creatorsPrefixesUrl, groupCreatorsByIndexPrefixes, groupCreatorsByLetter, groupCreatorsByPrefix, hasCreatorsFilter, isCreatorsBirthRangeValid, isCreatorsBirthYear, parseCreatorsLetter, resolveCreatorsFragment };
 export type { CreatorRelatedKey, CreatorsFragmentTarget, CreatorsLetter, ICreatorActivityPlace, ICreatorAuthorityLink, ICreatorDetailRow, ICreatorDetailsKeys, ICreatorDetailsState, ICreatorGalleryImage, ICreatorNeighbours, ICreatorRef, ICreatorRelatedStrip, ICreatorRelatedStripConfig, ICreatorRelatedStripLink, ICreatorTocEntry, ICreatorWorksPage, ICreatorsCatalog, ICreatorsCatalogOptions, ICreatorsCatalogPageOptions, ICreatorsFacade, ICreatorsFilterValue, ICreatorsIndexGroup, ICreatorsIndexState, ICreatorsLetterGroup, ICreatorsListSeo, ICreatorsPage, ICreatorsPrefixGroup, ICreatorsSearchState };