@internetarchive/collection-browser 0.3.1 → 0.3.2-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (200) hide show
  1. package/.editorconfig +29 -29
  2. package/.github/workflows/ci.yml +26 -26
  3. package/.github/workflows/gh-pages-main.yml +39 -39
  4. package/.github/workflows/npm-publish.yml +39 -39
  5. package/.github/workflows/pr-preview.yml +38 -38
  6. package/.husky/pre-commit +4 -4
  7. package/LICENSE +661 -661
  8. package/README.md +83 -83
  9. package/dist/index.d.ts +9 -9
  10. package/dist/index.js +9 -9
  11. package/dist/src/app-root.d.ts +43 -43
  12. package/dist/src/app-root.js +233 -233
  13. package/dist/src/assets/img/icons/arrow-left.d.ts +2 -2
  14. package/dist/src/assets/img/icons/arrow-left.js +2 -2
  15. package/dist/src/assets/img/icons/arrow-right.d.ts +2 -2
  16. package/dist/src/assets/img/icons/arrow-right.js +2 -2
  17. package/dist/src/assets/img/icons/chevron.d.ts +2 -2
  18. package/dist/src/assets/img/icons/chevron.js +2 -2
  19. package/dist/src/assets/img/icons/empty-query.d.ts +2 -2
  20. package/dist/src/assets/img/icons/empty-query.js +2 -2
  21. package/dist/src/assets/img/icons/eye-closed.d.ts +2 -2
  22. package/dist/src/assets/img/icons/eye-closed.js +2 -2
  23. package/dist/src/assets/img/icons/eye.d.ts +2 -2
  24. package/dist/src/assets/img/icons/eye.js +2 -2
  25. package/dist/src/assets/img/icons/favorite-filled.d.ts +1 -1
  26. package/dist/src/assets/img/icons/favorite-filled.js +2 -2
  27. package/dist/src/assets/img/icons/login-required.d.ts +1 -1
  28. package/dist/src/assets/img/icons/login-required.js +2 -2
  29. package/dist/src/assets/img/icons/mediatype/account.d.ts +1 -1
  30. package/dist/src/assets/img/icons/mediatype/account.js +2 -2
  31. package/dist/src/assets/img/icons/mediatype/audio.d.ts +1 -1
  32. package/dist/src/assets/img/icons/mediatype/audio.js +2 -2
  33. package/dist/src/assets/img/icons/mediatype/collection.d.ts +1 -1
  34. package/dist/src/assets/img/icons/mediatype/collection.js +2 -2
  35. package/dist/src/assets/img/icons/mediatype/data.d.ts +1 -1
  36. package/dist/src/assets/img/icons/mediatype/data.js +2 -2
  37. package/dist/src/assets/img/icons/mediatype/etree.d.ts +1 -1
  38. package/dist/src/assets/img/icons/mediatype/etree.js +2 -2
  39. package/dist/src/assets/img/icons/mediatype/film.d.ts +1 -1
  40. package/dist/src/assets/img/icons/mediatype/film.js +2 -2
  41. package/dist/src/assets/img/icons/mediatype/images.d.ts +1 -1
  42. package/dist/src/assets/img/icons/mediatype/images.js +2 -2
  43. package/dist/src/assets/img/icons/mediatype/radio.d.ts +1 -1
  44. package/dist/src/assets/img/icons/mediatype/radio.js +2 -2
  45. package/dist/src/assets/img/icons/mediatype/software.d.ts +1 -1
  46. package/dist/src/assets/img/icons/mediatype/software.js +2 -2
  47. package/dist/src/assets/img/icons/mediatype/texts.d.ts +1 -1
  48. package/dist/src/assets/img/icons/mediatype/texts.js +2 -2
  49. package/dist/src/assets/img/icons/mediatype/tv.d.ts +1 -1
  50. package/dist/src/assets/img/icons/mediatype/tv.js +2 -2
  51. package/dist/src/assets/img/icons/mediatype/video.d.ts +1 -1
  52. package/dist/src/assets/img/icons/mediatype/video.js +2 -2
  53. package/dist/src/assets/img/icons/mediatype/web.d.ts +1 -1
  54. package/dist/src/assets/img/icons/mediatype/web.js +2 -2
  55. package/dist/src/assets/img/icons/null-result.d.ts +2 -2
  56. package/dist/src/assets/img/icons/null-result.js +2 -2
  57. package/dist/src/assets/img/icons/restricted.d.ts +1 -1
  58. package/dist/src/assets/img/icons/restricted.js +2 -2
  59. package/dist/src/assets/img/icons/reviews.d.ts +1 -1
  60. package/dist/src/assets/img/icons/reviews.js +2 -2
  61. package/dist/src/assets/img/icons/upload.d.ts +1 -1
  62. package/dist/src/assets/img/icons/upload.js +2 -2
  63. package/dist/src/assets/img/icons/views.d.ts +1 -1
  64. package/dist/src/assets/img/icons/views.js +2 -2
  65. package/dist/src/circular-activity-indicator.d.ts +5 -5
  66. package/dist/src/circular-activity-indicator.js +17 -17
  67. package/dist/src/collection-browser.d.ts +242 -236
  68. package/dist/src/collection-browser.js +1411 -1406
  69. package/dist/src/collection-browser.js.map +1 -1
  70. package/dist/src/collection-facets/facets-template.d.ts +16 -16
  71. package/dist/src/collection-facets/facets-template.js +125 -125
  72. package/dist/src/collection-facets/more-facets-content.d.ts +74 -74
  73. package/dist/src/collection-facets/more-facets-content.js +330 -330
  74. package/dist/src/collection-facets/more-facets-pagination.d.ts +36 -36
  75. package/dist/src/collection-facets/more-facets-pagination.js +192 -192
  76. package/dist/src/collection-facets.d.ts +73 -71
  77. package/dist/src/collection-facets.js +507 -496
  78. package/dist/src/collection-facets.js.map +1 -1
  79. package/dist/src/empty-placeholder.d.ts +11 -11
  80. package/dist/src/empty-placeholder.js +42 -42
  81. package/dist/src/language-code-handler/language-code-handler.d.ts +37 -37
  82. package/dist/src/language-code-handler/language-code-handler.js +26 -26
  83. package/dist/src/language-code-handler/language-code-mapping.d.ts +1 -1
  84. package/dist/src/language-code-handler/language-code-mapping.js +562 -562
  85. package/dist/src/mediatype/mediatype-config.d.ts +3 -3
  86. package/dist/src/mediatype/mediatype-config.js +85 -85
  87. package/dist/src/models.d.ts +97 -97
  88. package/dist/src/models.js +100 -100
  89. package/dist/src/restoration-state-handler.d.ts +45 -45
  90. package/dist/src/restoration-state-handler.js +220 -220
  91. package/dist/src/sort-filter-bar/alpha-bar.d.ts +9 -9
  92. package/dist/src/sort-filter-bar/alpha-bar.js +41 -41
  93. package/dist/src/sort-filter-bar/img/compact.d.ts +1 -1
  94. package/dist/src/sort-filter-bar/img/compact.js +2 -2
  95. package/dist/src/sort-filter-bar/img/list.d.ts +1 -1
  96. package/dist/src/sort-filter-bar/img/list.js +2 -2
  97. package/dist/src/sort-filter-bar/img/sort-triangle.d.ts +1 -1
  98. package/dist/src/sort-filter-bar/img/sort-triangle.js +2 -2
  99. package/dist/src/sort-filter-bar/img/tile.d.ts +1 -1
  100. package/dist/src/sort-filter-bar/img/tile.js +2 -2
  101. package/dist/src/sort-filter-bar/sort-filter-bar.d.ts +107 -107
  102. package/dist/src/sort-filter-bar/sort-filter-bar.js +423 -423
  103. package/dist/src/styles/item-image-styles.d.ts +8 -8
  104. package/dist/src/styles/item-image-styles.js +9 -9
  105. package/dist/src/tiles/collection-browser-loading-tile.d.ts +5 -5
  106. package/dist/src/tiles/collection-browser-loading-tile.js +15 -15
  107. package/dist/src/tiles/grid/account-tile.d.ts +8 -8
  108. package/dist/src/tiles/grid/account-tile.js +20 -20
  109. package/dist/src/tiles/grid/collection-tile.d.ts +7 -7
  110. package/dist/src/tiles/grid/collection-tile.js +23 -23
  111. package/dist/src/tiles/grid/item-tile.d.ts +24 -24
  112. package/dist/src/tiles/grid/item-tile.js +87 -87
  113. package/dist/src/tiles/grid/tile-stats.d.ts +10 -10
  114. package/dist/src/tiles/grid/tile-stats.js +35 -35
  115. package/dist/src/tiles/image-block.d.ts +17 -17
  116. package/dist/src/tiles/image-block.js +73 -73
  117. package/dist/src/tiles/item-image.d.ts +31 -31
  118. package/dist/src/tiles/item-image.js +103 -103
  119. package/dist/src/tiles/list/account-label.d.ts +1 -1
  120. package/dist/src/tiles/list/account-label.js +6 -6
  121. package/dist/src/tiles/list/date-label.d.ts +1 -1
  122. package/dist/src/tiles/list/date-label.js +12 -12
  123. package/dist/src/tiles/list/tile-list-compact-header.d.ts +12 -12
  124. package/dist/src/tiles/list/tile-list-compact-header.js +41 -41
  125. package/dist/src/tiles/list/tile-list-compact.d.ts +20 -20
  126. package/dist/src/tiles/list/tile-list-compact.js +87 -87
  127. package/dist/src/tiles/list/tile-list.d.ts +50 -50
  128. package/dist/src/tiles/list/tile-list.js +264 -264
  129. package/dist/src/tiles/mediatype-icon.d.ts +9 -9
  130. package/dist/src/tiles/mediatype-icon.js +47 -47
  131. package/dist/src/tiles/overlay/icon-overlay.d.ts +7 -7
  132. package/dist/src/tiles/overlay/icon-overlay.js +31 -31
  133. package/dist/src/tiles/overlay/text-overlay.d.ts +8 -8
  134. package/dist/src/tiles/overlay/text-overlay.js +31 -31
  135. package/dist/src/tiles/text-snippet-block.d.ts +29 -29
  136. package/dist/src/tiles/text-snippet-block.js +81 -81
  137. package/dist/src/tiles/tile-dispatcher.d.ts +36 -36
  138. package/dist/src/tiles/tile-dispatcher.js +128 -128
  139. package/dist/src/utils/analytics-events.d.ts +18 -18
  140. package/dist/src/utils/analytics-events.js +20 -20
  141. package/dist/src/utils/format-count.d.ts +7 -7
  142. package/dist/src/utils/format-count.js +76 -76
  143. package/dist/src/utils/format-date.d.ts +2 -2
  144. package/dist/src/utils/format-date.js +23 -23
  145. package/dist/test/collection-browser.test.d.ts +1 -1
  146. package/dist/test/collection-browser.test.js +318 -318
  147. package/dist/test/collection-facets/facets-template.test.d.ts +1 -1
  148. package/dist/test/collection-facets/facets-template.test.js +62 -62
  149. package/dist/test/collection-facets/more-facets-content.test.d.ts +1 -1
  150. package/dist/test/collection-facets/more-facets-content.test.js +91 -91
  151. package/dist/test/collection-facets/more-facets-pagination.test.d.ts +1 -1
  152. package/dist/test/collection-facets/more-facets-pagination.test.js +117 -117
  153. package/dist/test/collection-facets.test.d.ts +2 -2
  154. package/dist/test/collection-facets.test.js +423 -387
  155. package/dist/test/collection-facets.test.js.map +1 -1
  156. package/dist/test/empty-placeholder.test.d.ts +1 -1
  157. package/dist/test/empty-placeholder.test.js +33 -33
  158. package/dist/test/icon-overlay.test.d.ts +1 -1
  159. package/dist/test/icon-overlay.test.js +24 -24
  160. package/dist/test/item-image.test.d.ts +1 -1
  161. package/dist/test/item-image.test.js +56 -56
  162. package/dist/test/mediatype-config.test.d.ts +1 -1
  163. package/dist/test/mediatype-config.test.js +16 -16
  164. package/dist/test/mocks/mock-analytics-handler.d.ts +10 -10
  165. package/dist/test/mocks/mock-analytics-handler.js +15 -15
  166. package/dist/test/mocks/mock-collection-name-cache.d.ts +7 -7
  167. package/dist/test/mocks/mock-collection-name-cache.js +13 -13
  168. package/dist/test/mocks/mock-search-responses.d.ts +5 -5
  169. package/dist/test/mocks/mock-search-responses.js +103 -103
  170. package/dist/test/mocks/mock-search-service.d.ts +13 -13
  171. package/dist/test/mocks/mock-search-service.js +25 -25
  172. package/dist/test/restoration-state-handler.test.d.ts +1 -1
  173. package/dist/test/restoration-state-handler.test.js +117 -117
  174. package/dist/test/sort-filter-bar/sort-filter-bar.test.d.ts +1 -1
  175. package/dist/test/sort-filter-bar/sort-filter-bar.test.js +113 -113
  176. package/dist/test/text-overlay.test.d.ts +1 -1
  177. package/dist/test/text-overlay.test.js +41 -41
  178. package/dist/test/text-snippet-block.test.d.ts +1 -1
  179. package/dist/test/text-snippet-block.test.js +57 -57
  180. package/dist/test/tile-stats.test.d.ts +1 -1
  181. package/dist/test/tile-stats.test.js +33 -33
  182. package/dist/test/tiles/grid/item-tile.test.d.ts +1 -1
  183. package/dist/test/tiles/grid/item-tile.test.js +107 -107
  184. package/dist/test/tiles/list/tile-list.test.d.ts +1 -1
  185. package/dist/test/tiles/list/tile-list.test.js +36 -36
  186. package/dist/test/utils/format-count.test.d.ts +1 -1
  187. package/dist/test/utils/format-count.test.js +23 -23
  188. package/dist/test/utils/format-date.test.d.ts +1 -1
  189. package/dist/test/utils/format-date.test.js +17 -17
  190. package/index.html +24 -24
  191. package/local.archive.org.cert +86 -86
  192. package/local.archive.org.key +27 -27
  193. package/package.json +115 -115
  194. package/renovate.json +6 -6
  195. package/src/collection-browser.ts +1539 -1530
  196. package/src/collection-facets.ts +582 -569
  197. package/test/collection-facets.test.ts +556 -510
  198. package/tsconfig.json +21 -21
  199. package/web-dev-server.config.mjs +30 -30
  200. package/web-test-runner.config.mjs +41 -41
@@ -1,8 +1,8 @@
1
- import { __decorate } from "tslib";
2
- import { css, html, LitElement } from 'lit';
3
- import { customElement } from 'lit/decorators.js';
4
- let CircularActivityIndicator = class CircularActivityIndicator extends LitElement {
5
- render() {
1
+ import { __decorate } from "tslib";
2
+ import { css, html, LitElement } from 'lit';
3
+ import { customElement } from 'lit/decorators.js';
4
+ let CircularActivityIndicator = class CircularActivityIndicator extends LitElement {
5
+ render() {
6
6
  return html `
7
7
  <div class="lds-ring">
8
8
  <div></div>
@@ -10,11 +10,11 @@ let CircularActivityIndicator = class CircularActivityIndicator extends LitEleme
10
10
  <div></div>
11
11
  <div></div>
12
12
  </div>
13
- `;
14
- }
15
- static get styles() {
16
- const color = css `var(--circularActivityIndicatorColor, dodgerblue)`;
17
- const thickness = css `var(--circularActivityIndicatorThickness, 4px)`;
13
+ `;
14
+ }
15
+ static get styles() {
16
+ const color = css `var(--circularActivityIndicatorColor, dodgerblue)`;
17
+ const thickness = css `var(--circularActivityIndicatorThickness, 4px)`;
18
18
  return css `
19
19
  :host {
20
20
  display: block;
@@ -56,11 +56,11 @@ let CircularActivityIndicator = class CircularActivityIndicator extends LitEleme
56
56
  transform: rotate(360deg);
57
57
  }
58
58
  }
59
- `;
60
- }
61
- };
62
- CircularActivityIndicator = __decorate([
63
- customElement('circular-activity-indicator')
64
- ], CircularActivityIndicator);
65
- export { CircularActivityIndicator };
59
+ `;
60
+ }
61
+ };
62
+ CircularActivityIndicator = __decorate([
63
+ customElement('circular-activity-indicator')
64
+ ], CircularActivityIndicator);
65
+ export { CircularActivityIndicator };
66
66
  //# sourceMappingURL=circular-activity-indicator.js.map
@@ -1,236 +1,242 @@
1
- import { LitElement, PropertyValues, TemplateResult } from 'lit';
2
- import type { InfiniteScrollerCellProviderInterface } from '@internetarchive/infinite-scroller';
3
- import { SearchServiceInterface, SearchType, SortDirection, SortParam } from '@internetarchive/search-service';
4
- import type { SharedResizeObserverInterface, SharedResizeObserverResizeHandlerInterface } from '@internetarchive/shared-resize-observer';
5
- import '@internetarchive/infinite-scroller';
6
- import type { CollectionNameCacheInterface } from '@internetarchive/collection-name-cache';
7
- import type { ModalManagerInterface } from '@internetarchive/modal-manager';
8
- import './tiles/tile-dispatcher';
9
- import './tiles/collection-browser-loading-tile';
10
- import './sort-filter-bar/sort-filter-bar';
11
- import './collection-facets';
12
- import './circular-activity-indicator';
13
- import './sort-filter-bar/sort-filter-bar';
14
- import { SelectedFacets, SortField, CollectionBrowserContext, TileModel, CollectionDisplayMode, FacetOption } from './models';
15
- import { RestorationStateHandlerInterface } from './restoration-state-handler';
16
- import './empty-placeholder';
17
- export declare class CollectionBrowser extends LitElement implements InfiniteScrollerCellProviderInterface, SharedResizeObserverResizeHandlerInterface {
18
- baseNavigationUrl?: string;
19
- baseImageUrl: string;
20
- searchService?: SearchServiceInterface;
21
- searchType: SearchType;
22
- baseQuery?: string;
23
- displayMode?: CollectionDisplayMode;
24
- sortParam: SortParam | null;
25
- selectedSort: SortField;
26
- selectedTitleFilter: string | null;
27
- selectedCreatorFilter: string | null;
28
- sortDirection: SortDirection | null;
29
- dateRangeQueryClause?: string;
30
- pageSize: number;
31
- resizeObserver?: SharedResizeObserverInterface;
32
- titleQuery?: string;
33
- creatorQuery?: string;
34
- currentPage?: number;
35
- minSelectedDate?: string;
36
- maxSelectedDate?: string;
37
- selectedFacets?: SelectedFacets;
38
- showHistogramDatePicker: boolean;
39
- /** describes where this component is being used */
40
- searchContext: string;
41
- collectionNameCache?: CollectionNameCacheInterface;
42
- pageContext: CollectionBrowserContext;
43
- restorationStateHandler: RestorationStateHandlerInterface;
44
- mobileBreakpoint: number;
45
- loggedIn: boolean;
46
- modalManager?: ModalManagerInterface;
47
- /**
48
- * If item management UI active
49
- */
50
- isManageView: boolean;
51
- /**
52
- * The page that the consumer wants to load.
53
- */
54
- private initialPageNumber;
55
- /**
56
- * This the the number of pages that we want to show.
57
- *
58
- * The data isn't necessarily loaded for all of the pages, but this lets us
59
- * know how many cells we should render.
60
- */
61
- private pagesToRender;
62
- private searchResultsLoading;
63
- private facetsLoading;
64
- private lendingFacetLoading;
65
- private fullYearAggregationLoading;
66
- private aggregations?;
67
- private fullYearsHistogramAggregation;
68
- private totalResults?;
69
- private mobileView;
70
- private mobileFacetsVisible;
71
- private placeholderType;
72
- private contentContainer;
73
- private languageCodeHandler;
74
- private analyticsHandler?;
75
- /**
76
- * When we're animated scrolling to the page, we don't want to fetch
77
- * all of the pages as it scrolls so this lets us know if we're scrolling
78
- */
79
- private isScrollingToCell;
80
- /**
81
- * When we've reached the end of the data, stop trying to fetch more
82
- */
83
- private endOfDataReached;
84
- /**
85
- * When page width resizes from desktop to mobile, set true to
86
- * disable expand/collapse transition when loading.
87
- */
88
- private isResizeToMobile;
89
- private placeholderCellTemplate;
90
- private tileModelAtCellIndex;
91
- private get sortFilterQueries();
92
- private get estimatedTileCount();
93
- private get actualTileCount();
94
- /**
95
- * The results per page so we can paginate.
96
- *
97
- * This allows us to start in the middle of the search results and
98
- * fetch data before or after the current page. If we don't have a key
99
- * for the previous/next page, we'll fetch the next/previous page to populate it
100
- */
101
- private dataSource;
102
- private infiniteScroller;
103
- /**
104
- * Go to the given page of results
105
- *
106
- * @param pageNumber
107
- */
108
- goToPage(pageNumber: number): void;
109
- clearFilters(): void;
110
- render(): TemplateResult<1>;
111
- private setPlaceholderType;
112
- private get emptyPlaceholderTemplate();
113
- private get collectionBrowserTemplate();
114
- private get infiniteScrollerTemplate();
115
- private get sortFilterBarTemplate();
116
- private userChangedSort;
117
- private sendSortByAnalytics;
118
- private selectedSortChanged;
119
- private displayModeChanged;
120
- /** Send Analytics when sorting by title's first letter
121
- * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
122
- * */
123
- private sendFilterByTitleAnalytics;
124
- private selectedTitleLetterChanged;
125
- /** Send Analytics when filtering by creator's first letter
126
- * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
127
- * */
128
- private sendFilterByCreatorAnalytics;
129
- private selectedCreatorLetterChanged;
130
- private titleLetterSelected;
131
- private creatorLetterSelected;
132
- private get facetDataLoading();
133
- private get mobileFacetsTemplate();
134
- private get facetsTemplate();
135
- private get loadingTemplate();
136
- private get listHeaderTemplate();
137
- private get queryDebuggingTemplate();
138
- private histogramDateRangeUpdated;
139
- firstUpdated(): void;
140
- updated(changed: PropertyValues): void;
141
- disconnectedCallback(): void;
142
- handleResize(entry: ResizeObserverEntry): void;
143
- private emitBaseQueryChanged;
144
- private disconnectResizeObserver;
145
- private setupResizeObserver;
146
- /**
147
- * When the visible cells change from the infinite scroller, we want to emit
148
- * which page is currently visible so the consumer can update its UI or the URL
149
- *
150
- * @param e
151
- * @returns
152
- */
153
- private visibleCellsChanged;
154
- private initialQueryChangeHappened;
155
- private historyPopOccurred;
156
- private previousQueryKey?;
157
- private handleQueryChange;
158
- private setupStateRestorationObserver;
159
- private boundNavigationHandler?;
160
- private historyNavigationHandler;
161
- private restoreState;
162
- private persistState;
163
- private doInitialPageFetch;
164
- private get fullQuery();
165
- private get fullQueryWithoutDate();
166
- /**
167
- * Generates a query string for the given facets
168
- *
169
- * Example: `mediatype:("collection" OR "audio" OR -"etree") AND year:("2000" OR "2001")`
170
- */
171
- private get facetQuery();
172
- facetsChanged(e: CustomEvent<SelectedFacets>): void;
173
- facetClickHandler(name: FacetOption, facetSelected: boolean, negative: boolean): void;
174
- private fetchFacets;
175
- private fetchLendingFacet;
176
- /**
177
- * If we haven't changed the query, we don't need to fetch the full year histogram
178
- *
179
- * @private
180
- * @type {string}
181
- * @memberof CollectionBrowser
182
- */
183
- private previousFullQueryNoDate?;
184
- /**
185
- * The query key is a string that uniquely identifies the current query
186
- * without the date range.
187
- *
188
- * If this doesn't change, we don't need to re-fetch the histogram date range
189
- */
190
- private get fullQueryNoDateKey();
191
- /**
192
- * This method is similar to fetching the facets above,
193
- * but only fetching the year histogram. There is a subtle difference
194
- * in how you have to fetch the year histogram where you can't use the
195
- * advanced JSON syntax like the other aggregations. It's a special
196
- * case that @ximm put it place.
197
- */
198
- private fetchFullYearHistogram;
199
- private scrollToPage;
200
- /**
201
- * The query key is a string that uniquely identifies the current query
202
- *
203
- * This lets us keep track of queries so we don't persist data that's
204
- * no longer relevant.
205
- */
206
- private get pageFetchQueryKey();
207
- private pageFetchesInProgress;
208
- fetchPage(pageNumber: number): Promise<void>;
209
- private preloadCollectionNames;
210
- /**
211
- * This is useful for determining whether we need to reload the scroller.
212
- *
213
- * When the fetch completes, we need to reload the scroller if the cells for that
214
- * page are visible, but if the page is not currenlty visible, we don't need to reload
215
- */
216
- private get currentVisiblePageNumbers();
217
- /**
218
- * Update the datasource from the fetch response
219
- *
220
- * @param pageNumber
221
- * @param results
222
- */
223
- private updateDataSource;
224
- private etreeTitle;
225
- /**
226
- * Callback when a result is selected
227
- */
228
- resultSelected(event: CustomEvent<TileModel>): void;
229
- cellForIndex(index: number): TemplateResult | undefined;
230
- /**
231
- * When the user scrolls near to the bottom of the page, fetch the next page
232
- * increase the number of pages to render and start fetching data for the new page
233
- */
234
- private scrollThresholdReached;
235
- static styles: import("lit").CSSResult;
236
- }
1
+ import { LitElement, PropertyValues, TemplateResult } from 'lit';
2
+ import type { InfiniteScrollerCellProviderInterface } from '@internetarchive/infinite-scroller';
3
+ import { SearchServiceInterface, SearchType, SortDirection, SortParam } from '@internetarchive/search-service';
4
+ import type { SharedResizeObserverInterface, SharedResizeObserverResizeHandlerInterface } from '@internetarchive/shared-resize-observer';
5
+ import '@internetarchive/infinite-scroller';
6
+ import type { CollectionNameCacheInterface } from '@internetarchive/collection-name-cache';
7
+ import type { ModalManagerInterface } from '@internetarchive/modal-manager';
8
+ import './tiles/tile-dispatcher';
9
+ import './tiles/collection-browser-loading-tile';
10
+ import './sort-filter-bar/sort-filter-bar';
11
+ import './collection-facets';
12
+ import './circular-activity-indicator';
13
+ import './sort-filter-bar/sort-filter-bar';
14
+ import { SelectedFacets, SortField, CollectionBrowserContext, TileModel, CollectionDisplayMode, FacetOption } from './models';
15
+ import { RestorationStateHandlerInterface } from './restoration-state-handler';
16
+ import './empty-placeholder';
17
+ export declare class CollectionBrowser extends LitElement implements InfiniteScrollerCellProviderInterface, SharedResizeObserverResizeHandlerInterface {
18
+ baseNavigationUrl?: string;
19
+ baseImageUrl: string;
20
+ searchService?: SearchServiceInterface;
21
+ searchType: SearchType;
22
+ baseQuery?: string;
23
+ displayMode?: CollectionDisplayMode;
24
+ sortParam: SortParam | null;
25
+ selectedSort: SortField;
26
+ selectedTitleFilter: string | null;
27
+ selectedCreatorFilter: string | null;
28
+ sortDirection: SortDirection | null;
29
+ dateRangeQueryClause?: string;
30
+ pageSize: number;
31
+ resizeObserver?: SharedResizeObserverInterface;
32
+ titleQuery?: string;
33
+ creatorQuery?: string;
34
+ currentPage?: number;
35
+ minSelectedDate?: string;
36
+ maxSelectedDate?: string;
37
+ selectedFacets?: SelectedFacets;
38
+ showHistogramDatePicker: boolean;
39
+ /** describes where this component is being used */
40
+ searchContext: string;
41
+ collectionNameCache?: CollectionNameCacheInterface;
42
+ pageContext: CollectionBrowserContext;
43
+ restorationStateHandler: RestorationStateHandlerInterface;
44
+ mobileBreakpoint: number;
45
+ loggedIn: boolean;
46
+ modalManager?: ModalManagerInterface;
47
+ /**
48
+ * If item management UI active
49
+ */
50
+ isManageView: boolean;
51
+ /**
52
+ * The page that the consumer wants to load.
53
+ */
54
+ private initialPageNumber;
55
+ /**
56
+ * This the the number of pages that we want to show.
57
+ *
58
+ * The data isn't necessarily loaded for all of the pages, but this lets us
59
+ * know how many cells we should render.
60
+ */
61
+ private pagesToRender;
62
+ private searchResultsLoading;
63
+ private facetsLoading;
64
+ private lendingFacetLoading;
65
+ private fullYearAggregationLoading;
66
+ private aggregations?;
67
+ private fullYearsHistogramAggregation;
68
+ /**
69
+ * The search type of the previous search (i.e., the currently displayed
70
+ * search results), which may differ from the one that is currently selected
71
+ * to be used for the next search.
72
+ */
73
+ private previousSearchType?;
74
+ private totalResults?;
75
+ private mobileView;
76
+ private mobileFacetsVisible;
77
+ private placeholderType;
78
+ private contentContainer;
79
+ private languageCodeHandler;
80
+ private analyticsHandler?;
81
+ /**
82
+ * When we're animated scrolling to the page, we don't want to fetch
83
+ * all of the pages as it scrolls so this lets us know if we're scrolling
84
+ */
85
+ private isScrollingToCell;
86
+ /**
87
+ * When we've reached the end of the data, stop trying to fetch more
88
+ */
89
+ private endOfDataReached;
90
+ /**
91
+ * When page width resizes from desktop to mobile, set true to
92
+ * disable expand/collapse transition when loading.
93
+ */
94
+ private isResizeToMobile;
95
+ private placeholderCellTemplate;
96
+ private tileModelAtCellIndex;
97
+ private get sortFilterQueries();
98
+ private get estimatedTileCount();
99
+ private get actualTileCount();
100
+ /**
101
+ * The results per page so we can paginate.
102
+ *
103
+ * This allows us to start in the middle of the search results and
104
+ * fetch data before or after the current page. If we don't have a key
105
+ * for the previous/next page, we'll fetch the next/previous page to populate it
106
+ */
107
+ private dataSource;
108
+ private infiniteScroller;
109
+ /**
110
+ * Go to the given page of results
111
+ *
112
+ * @param pageNumber
113
+ */
114
+ goToPage(pageNumber: number): void;
115
+ clearFilters(): void;
116
+ render(): TemplateResult<1>;
117
+ private setPlaceholderType;
118
+ private get emptyPlaceholderTemplate();
119
+ private get collectionBrowserTemplate();
120
+ private get infiniteScrollerTemplate();
121
+ private get sortFilterBarTemplate();
122
+ private userChangedSort;
123
+ private sendSortByAnalytics;
124
+ private selectedSortChanged;
125
+ private displayModeChanged;
126
+ /** Send Analytics when sorting by title's first letter
127
+ * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
128
+ * */
129
+ private sendFilterByTitleAnalytics;
130
+ private selectedTitleLetterChanged;
131
+ /** Send Analytics when filtering by creator's first letter
132
+ * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
133
+ * */
134
+ private sendFilterByCreatorAnalytics;
135
+ private selectedCreatorLetterChanged;
136
+ private titleLetterSelected;
137
+ private creatorLetterSelected;
138
+ private get facetDataLoading();
139
+ private get mobileFacetsTemplate();
140
+ private get facetsTemplate();
141
+ private get loadingTemplate();
142
+ private get listHeaderTemplate();
143
+ private get queryDebuggingTemplate();
144
+ private histogramDateRangeUpdated;
145
+ firstUpdated(): void;
146
+ updated(changed: PropertyValues): void;
147
+ disconnectedCallback(): void;
148
+ handleResize(entry: ResizeObserverEntry): void;
149
+ private emitBaseQueryChanged;
150
+ private disconnectResizeObserver;
151
+ private setupResizeObserver;
152
+ /**
153
+ * When the visible cells change from the infinite scroller, we want to emit
154
+ * which page is currently visible so the consumer can update its UI or the URL
155
+ *
156
+ * @param e
157
+ * @returns
158
+ */
159
+ private visibleCellsChanged;
160
+ private initialQueryChangeHappened;
161
+ private historyPopOccurred;
162
+ private previousQueryKey?;
163
+ private handleQueryChange;
164
+ private setupStateRestorationObserver;
165
+ private boundNavigationHandler?;
166
+ private historyNavigationHandler;
167
+ private restoreState;
168
+ private persistState;
169
+ private doInitialPageFetch;
170
+ private get fullQuery();
171
+ private get fullQueryWithoutDate();
172
+ /**
173
+ * Generates a query string for the given facets
174
+ *
175
+ * Example: `mediatype:("collection" OR "audio" OR -"etree") AND year:("2000" OR "2001")`
176
+ */
177
+ private get facetQuery();
178
+ facetsChanged(e: CustomEvent<SelectedFacets>): void;
179
+ facetClickHandler(name: FacetOption, facetSelected: boolean, negative: boolean): void;
180
+ private fetchFacets;
181
+ private fetchLendingFacet;
182
+ /**
183
+ * If we haven't changed the query, we don't need to fetch the full year histogram
184
+ *
185
+ * @private
186
+ * @type {string}
187
+ * @memberof CollectionBrowser
188
+ */
189
+ private previousFullQueryNoDate?;
190
+ /**
191
+ * The query key is a string that uniquely identifies the current query
192
+ * without the date range.
193
+ *
194
+ * If this doesn't change, we don't need to re-fetch the histogram date range
195
+ */
196
+ private get fullQueryNoDateKey();
197
+ /**
198
+ * This method is similar to fetching the facets above,
199
+ * but only fetching the year histogram. There is a subtle difference
200
+ * in how you have to fetch the year histogram where you can't use the
201
+ * advanced JSON syntax like the other aggregations. It's a special
202
+ * case that @ximm put it place.
203
+ */
204
+ private fetchFullYearHistogram;
205
+ private scrollToPage;
206
+ /**
207
+ * The query key is a string that uniquely identifies the current query
208
+ *
209
+ * This lets us keep track of queries so we don't persist data that's
210
+ * no longer relevant.
211
+ */
212
+ private get pageFetchQueryKey();
213
+ private pageFetchesInProgress;
214
+ fetchPage(pageNumber: number): Promise<void>;
215
+ private preloadCollectionNames;
216
+ /**
217
+ * This is useful for determining whether we need to reload the scroller.
218
+ *
219
+ * When the fetch completes, we need to reload the scroller if the cells for that
220
+ * page are visible, but if the page is not currenlty visible, we don't need to reload
221
+ */
222
+ private get currentVisiblePageNumbers();
223
+ /**
224
+ * Update the datasource from the fetch response
225
+ *
226
+ * @param pageNumber
227
+ * @param results
228
+ */
229
+ private updateDataSource;
230
+ private etreeTitle;
231
+ /**
232
+ * Callback when a result is selected
233
+ */
234
+ resultSelected(event: CustomEvent<TileModel>): void;
235
+ cellForIndex(index: number): TemplateResult | undefined;
236
+ /**
237
+ * When the user scrolls near to the bottom of the page, fetch the next page
238
+ * increase the number of pages to render and start fetching data for the new page
239
+ */
240
+ private scrollThresholdReached;
241
+ static styles: import("lit").CSSResult;
242
+ }