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

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

@@ -103,6 +103,28 @@ function creatorsFindPrefix(raw, prefixes) {
     const upper = raw.toLocaleUpperCase('pl');
     return (prefixes.find((prefix) => prefix.toLocaleUpperCase('pl') === upper) ?? 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).
+ */
+function groupCreatorsByIndexPrefixes(items, prefixes) {
+    const groups = new Map(prefixes.map((prefix) => [prefix, []]));
+    for (const item of items) {
+        const own = creatorsIndexPrefixOf(item.name ?? '');
+        const prefix = creatorsFindPrefix(own, prefixes) ?? own;
+        const group = groups.get(prefix);
+        if (group)
+            group.push(item);
+        else
+            groups.set(prefix, [item]);
+    }
+    return Array.from(groups, ([prefix, groupItems]) => ({
+        prefix,
+        items: groupItems,
+    })).filter((group) => group.items.length > 0);
+}
 /** `?litera=` query param to index letter; invalid or missing falls back to `A`. */
 function parseCreatorsLetter(raw) {
     const upper = (raw ?? '').toLocaleUpperCase('pl');
@@ -915,6 +937,15 @@ function createCreatorsCatalog(options) {
 const CREATORS_INDEX_LETTER_PARAM = 'litera';
 /** `?prefiks=`: the two-letter group of the letter the index shows (MOB-1959). */
 const CREATORS_INDEX_PREFIX_PARAM = 'prefiks';
+/** A `#fragment` as written, decoded when it is a valid escape. */
+function creatorsIndexDecode(fragment) {
+    try {
+        return decodeURIComponent(fragment);
+    }
+    catch {
+        return fragment;
+    }
+}
 /** `?filter=` belongs to the catalog results view; the index stays idle while it is there. */
 const CREATORS_INDEX_FILTER_PARAM = 'filter';
 const CREATORS_INDEX_LOADING = {
@@ -1006,7 +1037,26 @@ class CreatorsIndexBaseComponent {
         this.groups = computed(() => {
             const { prefixes, prefix: shown, items } = this.state();
             const base = this.creatorsIndexAnchorBase;
-            return prefixes.map((prefix) => ({
+            if (this.creatorsIndexWholeLetter() && !shown) {
+                // The API groups first (also the empty ones: the jump bar lists them), then a shown group the
+                // API did not list.
+                const filled = new Map(groupCreatorsByIndexPrefixes(items, prefixes).map((group) => [
+                    group.prefix,
+                    group.items,
+                ]));
+                return [
+                    ...prefixes,
+                    ...[...filled.keys()].filter((prefix) => !prefixes.includes(prefix)),
+                ].map((prefix) => ({
+                    prefix,
+                    anchor: creatorsPrefixAnchor(prefix, base),
+                    items: filled.get(prefix) ?? [],
+                }));
+            }
+            const listed = this.creatorsIndexWholeLetter() && shown && !prefixes.includes(shown)
+                ? [...prefixes, shown]
+                : prefixes;
+            return listed.map((prefix) => ({
                 prefix,
                 anchor: creatorsPrefixAnchor(prefix, base),
                 items: prefix === shown ? items : [],
@@ -1061,16 +1111,12 @@ class CreatorsIndexBaseComponent {
                 this.creatorsIndexHandledFragment = null;
                 return;
             }
-            if (state.status === 'loading' && !state.prefixes.length)
-                return;
             if (fragment === this.creatorsIndexHandledFragment)
                 return;
             const groups = this.groups();
             const target = resolveCreatorsFragment(fragment, this.letter(), groups);
-            if (!target)
-                return;
-            // A letter switch does not need this letter's list (it may have failed).
-            if ('letter' in target) {
+            // A letter switch does not need this letter's list (it may still load, or have failed).
+            if (target && 'letter' in target) {
                 this.creatorsIndexRouter.navigate([], {
                     relativeTo: this.creatorsIndexRoute,
                     queryParams: { [CREATORS_INDEX_LETTER_PARAM]: target.letter },
@@ -1079,9 +1125,42 @@ class CreatorsIndexBaseComponent {
                 });
                 return;
             }
-            // Another group of this letter is loaded first (`?prefiks=`).
+            if (state.status === 'loading' && !state.prefixes.length)
+                return;
+            if (!target) {
+                // Narrowed, a group the API did not list is only known from the whole letter: load it first.
+                if (this.creatorsIndexWholeLetter() &&
+                    state.prefix &&
+                    this.creatorsIndexUnlistedPrefix(this.letter(), this.creatorsIndexFragmentPrefix(fragment))) {
+                    this.creatorsIndexRouter.navigate([], {
+                        relativeTo: this.creatorsIndexRoute,
+                        queryParams: { [CREATORS_INDEX_LETTER_PARAM]: this.letter() },
+                        fragment,
+                        replaceUrl: true,
+                    });
+                }
+                return;
+            }
+            if ('letter' in target)
+                return; // switched above; narrows the type
             const group = groups.find((g) => g.anchor === target.anchor);
-            if (group && group.prefix !== state.prefix) {
+            // The whole letter shows every group: another one than the picked group drops `?prefiks=`.
+            if (this.creatorsIndexWholeLetter() &&
+                group &&
+                state.prefix &&
+                group.prefix !== state.prefix) {
+                this.creatorsIndexRouter.navigate([], {
+                    relativeTo: this.creatorsIndexRoute,
+                    queryParams: { [CREATORS_INDEX_LETTER_PARAM]: this.letter() },
+                    fragment,
+                    replaceUrl: true,
+                });
+                return;
+            }
+            // Another group of this letter is loaded first (`?prefiks=`).
+            if (!this.creatorsIndexWholeLetter() &&
+                group &&
+                group.prefix !== state.prefix) {
                 this.creatorsIndexRouter.navigate([], {
                     relativeTo: this.creatorsIndexRoute,
                     queryParams: {
@@ -1184,17 +1263,73 @@ class CreatorsIndexBaseComponent {
     creatorsIndexApplySeo() {
         this.creatorsIndexSeoService.apply(creatorsListSeoMetadata(this.creatorsIndexSeo, (key) => String(this.creatorsIndexTranslate.instant(key) ?? '')));
     }
+    /**
+     * `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.
+     */
+    creatorsIndexWholeLetter() {
+        return false;
+    }
+    /**
+     * 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`). */
+    creatorsIndexFragmentPrefix(fragment) {
+        const raw = creatorsIndexDecode(fragment);
+        const head = `${this.creatorsIndexAnchorBase}-`;
+        if (!raw.startsWith(head))
+            return raw;
+        const codePoints = raw
+            .slice(head.length)
+            .split('-')
+            .map((hex) => (/^[\da-f]{1,6}$/.test(hex) ? parseInt(hex, 16) : NaN));
+        return codePoints.every((point) => point <= 0x10ffff)
+            ? String.fromCodePoint(...codePoints)
+            : raw;
+    }
+    creatorsIndexUnlistedPrefix(letter, raw) {
+        const chars = Array.from(raw?.trim() ?? '');
+        if (letter === '#' || chars.length !== 2)
+            return null;
+        const prefix = creatorsDisplayPrefix(chars.join('').toLocaleUpperCase('pl'));
+        return creatorsLetterOf(prefix) === letter ? prefix : null;
+    }
     creatorsIndexLoad(letter, prefixes, raw) {
-        const prefix = creatorsFindPrefix(raw, prefixes) ?? prefixes[0] ?? null;
+        const whole = this.creatorsIndexWholeLetter();
+        const prefix = whole
+            ? (creatorsFindPrefix(raw, prefixes) ??
+                this.creatorsIndexUnlistedPrefix(letter, raw))
+            : (creatorsFindPrefix(raw, prefixes) ?? prefixes[0] ?? null);
         const base = { prefixes, prefix };
-        if (!prefix)
+        // The whole letter is still searched when the API lists no group (data drift); `#` has no search.
+        const nothing = whole
+            ? !prefix && letter === '#' && !prefixes.length
+            : !prefix;
+        if (nothing)
             return of({ ...base, status: 'success', items: [] });
-        return this.creatorsIndexService.getByIndexPrefix(letter, prefix).pipe(map((items) => ({
+        const items$ = prefix
+            ? this.creatorsIndexService.getByIndexPrefix(letter, prefix)
+            : this.creatorsIndexLetter(letter, prefixes);
+        return items$.pipe(map((items) => ({
             ...base,
             status: 'success',
             items,
         })), catchError(() => of({ ...base, status: 'error', items: [] })), startWith({ ...base, status: 'loading', items: [] }));
     }
+    /**
+     * 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.
+     */
+    creatorsIndexLetter(letter, prefixes) {
+        if (letter !== '#')
+            return this.creatorsIndexService.getByIndexPrefix(letter, letter);
+        return forkJoin(prefixes.map((prefix) => this.creatorsIndexService.getByIndexPrefix(letter, prefix))).pipe(map((lists) => lists.flat()));
+    }
     /** @nocollapse */ static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.1.3", ngImport: i0, type: CreatorsIndexBaseComponent, deps: [], target: i0.ɵɵFactoryTarget.Directive }); }
     /** @nocollapse */ static { this.ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.2.0", version: "22.1.3", type: CreatorsIndexBaseComponent, isStandalone: true, viewQueries: [{ propertyName: "creatorsIndexFiltersButton", first: true, predicate: ["filtersButton"], descendants: true, isSignal: true }], ngImport: i0 }); }
 }
@@ -1206,7 +1341,8 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
  * 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.
@@ -1248,6 +1384,10 @@ class CreatorsJumpToBaseComponent {
         this.selectedLetter.set(letter);
         this.selectedPrefix.set(null);
     }
+    /** Presses a prefix; the pressed one again goes back to no prefix (the whole letter). */
+    togglePrefix(prefix) {
+        this.selectedPrefix.update((current) => current === prefix ? null : prefix);
+    }
     apply() {
         const letter = this.selectedLetter();
         const prefix = this.selectedPrefix();
@@ -1255,8 +1395,17 @@ class CreatorsJumpToBaseComponent {
             this.letterChange.emit(letter);
         else if (prefix)
             this.prefixSelect.emit(prefix);
+        else if (this.creatorsJumpToWholeLetter() && this.activePrefix())
+            this.letterChange.emit(letter);
         this.closed.emit();
     }
+    /**
+     * `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.
+     */
+    creatorsJumpToWholeLetter() {
+        return false;
+    }
     close() {
         this.closed.emit();
     }
@@ -2142,5 +2291,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.1.3", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-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 };
 //# sourceMappingURL=smartsoft001-mobilems-creators-shell-angular.mjs.map