@smartsoft001-mobilems/creators-shell-angular 2.122.0 → 2.124.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartsoft001-mobilems/creators-shell-angular",
-  "version": "2.122.0",
+  "version": "2.124.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.122.0",
-    "@smartsoft001-mobilems/creators-domain": "^2.122.0",
-    "@smartsoft001-mobilems/creators-shell-dtos": "^2.122.0",
-    "@smartsoft001-mobilems/objects-domain": "^2.122.0"
+    "@smartsoft001-mobilems/angular": "^2.124.0",
+    "@smartsoft001-mobilems/creators-domain": "^2.124.0",
+    "@smartsoft001-mobilems/creators-shell-dtos": "^2.124.0",
+    "@smartsoft001-mobilems/objects-domain": "^2.124.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

@@ -3,7 +3,7 @@ import { Creator, ICreatorRelated, CreatorDictValue, ICreatorTag } from '@smarts
 import { ICreatorsQueryDto } from '@smartsoft001-mobilems/creators-shell-dtos';
 import { MsObject } from '@smartsoft001-mobilems/objects-domain';
 import * as _angular_core from '@angular/core';
-import { Signal, WritableSignal } from '@angular/core';
+import { Signal, WritableSignal, InputSignal } from '@angular/core';
 import { ICrudFilter } from '@smartsoft001/crud-shell-angular';
 import { ISeoMetadata, ICatalog, ICatalogOptions, ICatalogFacade } from '@smartsoft001-mobilems/angular';
 
@@ -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.
@@ -426,12 +459,12 @@ declare abstract class CreatorsJumpToBaseComponent {
      */
     protected readonly creatorsJumpToHeaderSelectors: readonly string[];
     private readonly creatorsJumpToDocument;
-    readonly letters: _angular_core.InputSignal<readonly ("A" | "Ą" | "B" | "C" | "Ć" | "D" | "E" | "Ę" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "Ł" | "M" | "N" | "Ń" | "O" | "Ó" | "P" | "Q" | "R" | "S" | "Ś" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z" | "Ź" | "Ż" | "#")[]>;
-    readonly activeLetter: _angular_core.InputSignal<"A" | "Ą" | "B" | "C" | "Ć" | "D" | "E" | "Ę" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "Ł" | "M" | "N" | "Ń" | "O" | "Ó" | "P" | "Q" | "R" | "S" | "Ś" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z" | "Ź" | "Ż" | "#">;
+    readonly letters: InputSignal<readonly ("A" | "Ą" | "B" | "C" | "Ć" | "D" | "E" | "Ę" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "Ł" | "M" | "N" | "Ń" | "O" | "Ó" | "P" | "Q" | "R" | "S" | "Ś" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z" | "Ź" | "Ż" | "#")[]>;
+    readonly activeLetter: InputSignal<"A" | "Ą" | "B" | "C" | "Ć" | "D" | "E" | "Ę" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "Ł" | "M" | "N" | "Ń" | "O" | "Ó" | "P" | "Q" | "R" | "S" | "Ś" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z" | "Ź" | "Ż" | "#">;
     /** Prefix groups of the loaded (active) letter. */
-    readonly prefixes: _angular_core.InputSignal<readonly string[]>;
+    readonly prefixes: InputSignal<readonly string[]>;
     /** Prefix the index currently shows, pre-selected. */
-    readonly activePrefix: _angular_core.InputSignal<string>;
+    readonly activePrefix: InputSignal<string | null>;
     readonly letterChange: _angular_core.OutputEmitterRef<"A" | "Ą" | "B" | "C" | "Ć" | "D" | "E" | "Ę" | "F" | "G" | "H" | "I" | "J" | "K" | "L" | "Ł" | "M" | "N" | "Ń" | "O" | "Ó" | "P" | "Q" | "R" | "S" | "Ś" | "T" | "U" | "V" | "W" | "X" | "Y" | "Z" | "Ź" | "Ż" | "#">;
     readonly prefixSelect: _angular_core.OutputEmitterRef<string>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
@@ -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>;
@@ -568,6 +608,8 @@ interface ICreatorsSearchState {
  * the route, the page and the page size, the loaded page and the list context. The view (layout,
  * toolbar, cards, pagination) stays in the museum.
  *
+ * A blank phrase (`/wyszukaj/%20/artysci`) gives an empty result without a request.
+ *
  * The request depends on the phrase, the page and the limit only. A `#results` template ref is
  * scrolled to after a page change from the bottom pagination (`changePage(page, true)`), in the
  * browser only.
@@ -822,5 +864,5 @@ declare abstract class CreatorDetailsBaseComponent<TRelatedItem = MsObject> {
     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 };