@internetarchive/collection-browser 3.0.5 → 3.0.7-alpha-webdev7989.0

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 (37) hide show
  1. package/.editorconfig +29 -29
  2. package/.github/workflows/ci.yml +27 -27
  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/.prettierignore +1 -1
  8. package/LICENSE +661 -661
  9. package/README.md +83 -83
  10. package/dist/src/collection-browser.d.ts +5 -0
  11. package/dist/src/collection-browser.js +9 -0
  12. package/dist/src/collection-browser.js.map +1 -1
  13. package/dist/src/collection-facets/facet-row.js +144 -132
  14. package/dist/src/collection-facets/facet-row.js.map +1 -1
  15. package/dist/src/data-source/collection-browser-data-source.js +1 -0
  16. package/dist/src/data-source/collection-browser-data-source.js.map +1 -1
  17. package/dist/src/data-source/collection-browser-query-state.d.ts +1 -0
  18. package/dist/src/data-source/collection-browser-query-state.js.map +1 -1
  19. package/dist/test/collection-facets/facet-row.test.js +47 -24
  20. package/dist/test/collection-facets/facet-row.test.js.map +1 -1
  21. package/dist/test/collection-facets.test.js +21 -22
  22. package/dist/test/collection-facets.test.js.map +1 -1
  23. package/eslint.config.mjs +53 -53
  24. package/index.html +24 -24
  25. package/local.archive.org.cert +86 -86
  26. package/local.archive.org.key +27 -27
  27. package/package.json +117 -117
  28. package/renovate.json +6 -6
  29. package/src/collection-browser.ts +12 -0
  30. package/src/collection-facets/facet-row.ts +296 -283
  31. package/src/data-source/collection-browser-data-source.ts +1 -0
  32. package/src/data-source/collection-browser-query-state.ts +1 -0
  33. package/test/collection-facets/facet-row.test.ts +375 -342
  34. package/test/collection-facets.test.ts +928 -932
  35. package/tsconfig.json +20 -20
  36. package/web-dev-server.config.mjs +30 -30
  37. package/web-test-runner.config.mjs +41 -41
@@ -1,283 +1,296 @@
1
- import {
2
- css,
3
- html,
4
- LitElement,
5
- TemplateResult,
6
- CSSResultGroup,
7
- nothing,
8
- } from 'lit';
9
- import { customElement, property } from 'lit/decorators.js';
10
- import eyeIcon from '../assets/img/icons/eye';
11
- import eyeClosedIcon from '../assets/img/icons/eye-closed';
12
- import type {
13
- FacetOption,
14
- FacetBucket,
15
- FacetEventDetails,
16
- FacetState,
17
- } from '../models';
18
- import type { CollectionTitles } from '../data-source/models';
19
-
20
- @customElement('facet-row')
21
- export class FacetRow extends LitElement {
22
- //
23
- // UI STATE
24
- //
25
-
26
- /** The name of the facet group to which this facet belongs (e.g., "mediatype") */
27
- @property({ type: String }) facetType?: FacetOption;
28
-
29
- /** The facet bucket containing details about the state, count, and key for this row */
30
- @property({ type: Object }) bucket?: FacetBucket;
31
-
32
- /** The collection name cache for converting collection identifiers to titles */
33
- @property({ type: Object })
34
- collectionTitles?: CollectionTitles;
35
-
36
- //
37
- // COMPONENT LIFECYCLE METHODS
38
- //
39
-
40
- render() {
41
- return html`${this.facetRowTemplate}`;
42
- }
43
-
44
- //
45
- // TEMPLATE GETTERS
46
- //
47
-
48
- /**
49
- * Template for the full facet row, including the positive/negative checks,
50
- * the display name, and the count.
51
- */
52
- private get facetRowTemplate(): TemplateResult | typeof nothing {
53
- const { bucket, facetType } = this;
54
- if (!bucket || !facetType) return nothing;
55
-
56
- const showOnlyCheckboxId = `${facetType}:${bucket.key}-show-only`;
57
- const negativeCheckboxId = `${facetType}:${bucket.key}-negative`;
58
-
59
- const extraNoteSpan = bucket.extraNote
60
- ? html`<span class="facet-note">${bucket.extraNote}</span>`
61
- : nothing;
62
-
63
- // For collections, we render the collection title as a link.
64
- // For other facet types, we just have a static value to use.
65
- const bucketTextDisplay =
66
- facetType !== 'collection'
67
- ? html`${bucket.displayText ?? bucket.key} ${extraNoteSpan}`
68
- : html`<a href="/details/${bucket.key}">
69
- ${this.collectionTitles?.get(bucket.key) ?? bucket.key}
70
- </a> `;
71
-
72
- const facetHidden = bucket.state === 'hidden';
73
- const facetSelected = bucket.state === 'selected';
74
-
75
- const titleText = `${facetType}: ${bucket.displayText ?? bucket.key}`;
76
- const onlyShowText = facetSelected
77
- ? `Show all ${facetType}s`
78
- : `Only show ${titleText}`;
79
- const hideText = `Hide ${titleText}`;
80
- const unhideText = `Unhide ${titleText}`;
81
- const showHideText = facetHidden ? unhideText : hideText;
82
- const ariaLabel = `${titleText}, ${bucket.count} results`;
83
-
84
- // Added data-testid for Playwright testing
85
- return html`
86
- <div class="facet-row-container">
87
- <div class="facet-checkboxes">
88
- <input
89
- type="checkbox"
90
- .name=${facetType}
91
- .value=${bucket.key}
92
- @click=${(e: Event) => {
93
- this.facetClicked(e, false);
94
- }}
95
- .checked=${facetSelected}
96
- class="select-facet-checkbox"
97
- title=${onlyShowText}
98
- id=${showOnlyCheckboxId}
99
- data-testid=${showOnlyCheckboxId}
100
- />
101
- <input
102
- type="checkbox"
103
- id=${negativeCheckboxId}
104
- .name=${facetType}
105
- .value=${bucket.key}
106
- @click=${(e: Event) => {
107
- this.facetClicked(e, true);
108
- }}
109
- .checked=${facetHidden}
110
- class="hide-facet-checkbox"
111
- />
112
- <label
113
- for=${negativeCheckboxId}
114
- class="hide-facet-icon${facetHidden ? ' active' : ''}"
115
- title=${showHideText}
116
- data-testid=${negativeCheckboxId}
117
- >
118
- <span class="eye">${eyeIcon}</span>
119
- <span class="eye-closed">${eyeClosedIcon}</span>
120
- </label>
121
- </div>
122
- <label
123
- for=${showOnlyCheckboxId}
124
- class="facet-info-display"
125
- title=${onlyShowText}
126
- aria-label=${ariaLabel}
127
- >
128
- <div class="facet-title">${bucketTextDisplay}</div>
129
- <div class="facet-count">${bucket.count.toLocaleString()}</div>
130
- </label>
131
- </div>
132
- `;
133
- }
134
-
135
- //
136
- // EVENT HANDLERS & DISPATCHERS
137
- //
138
-
139
- /**
140
- * Handler for whenever this facet is clicked & its state changes
141
- */
142
- private facetClicked(e: Event, negative: boolean) {
143
- const { bucket, facetType } = this;
144
- if (!bucket || !facetType) return;
145
-
146
- const target = e.target as HTMLInputElement;
147
- const { checked } = target;
148
- this.bucket = {
149
- ...bucket,
150
- state: FacetRow.getFacetState(checked, negative),
151
- };
152
-
153
- this.dispatchFacetClickEvent({
154
- facetType,
155
- bucket: this.bucket,
156
- negative,
157
- });
158
- }
159
-
160
- /**
161
- * Emits a `facetClick` event with details about this facet & its current state
162
- */
163
- private dispatchFacetClickEvent(detail: FacetEventDetails) {
164
- const event = new CustomEvent<FacetEventDetails>('facetClick', {
165
- detail,
166
- });
167
- this.dispatchEvent(event);
168
- }
169
-
170
- //
171
- // OTHER METHODS
172
- //
173
-
174
- /**
175
- * Returns the composed facet state corresponding to a positive or negative facet's checked state
176
- */
177
- static getFacetState(checked: boolean, negative: boolean): FacetState {
178
- let state: FacetState;
179
- if (checked) {
180
- state = negative ? 'hidden' : 'selected';
181
- } else {
182
- state = 'none';
183
- }
184
- return state;
185
- }
186
-
187
- //
188
- // STYLES
189
- //
190
-
191
- static get styles(): CSSResultGroup {
192
- const facetRowBorderTop = css`var(--facet-row-border-top, 1px solid transparent)`;
193
- const facetRowBorderBottom = css`var(--facet-row-border-bottom, 1px solid transparent)`;
194
-
195
- return css`
196
- async-collection-name {
197
- display: contents;
198
- }
199
- .facet-checkboxes {
200
- margin: 0 5px 0 0;
201
- display: flex;
202
- height: 15px;
203
- }
204
- .facet-checkboxes input:first-child {
205
- margin-right: 5px;
206
- }
207
- .facet-checkboxes input {
208
- height: 15px;
209
- width: 15px;
210
- margin: 0;
211
- }
212
- .facet-row-container {
213
- display: flex;
214
- font-weight: 500;
215
- font-size: 1.2rem;
216
- margin: 0 auto;
217
- padding: 0.25rem 0;
218
- height: auto;
219
- border-top: ${facetRowBorderTop};
220
- border-bottom: ${facetRowBorderBottom};
221
- overflow: hidden;
222
- }
223
- .facet-info-display {
224
- display: flex;
225
- flex: 1 1 0%;
226
- cursor: pointer;
227
- flex-wrap: wrap;
228
- }
229
- .facet-title {
230
- word-break: break-word;
231
- display: inline-block;
232
- flex: 1 1 0%;
233
- }
234
- .facet-note {
235
- color: #bbb;
236
- }
237
- .facet-count {
238
- text-align: right;
239
- }
240
- .select-facet-checkbox {
241
- cursor: pointer;
242
- display: inline-block;
243
- }
244
- .hide-facet-checkbox {
245
- display: none;
246
- }
247
- .hide-facet-icon {
248
- width: 15px;
249
- height: 15px;
250
- cursor: pointer;
251
- opacity: 0.3;
252
- display: inline-block;
253
- }
254
- .hide-facet-icon:hover,
255
- .active {
256
- opacity: 1;
257
- }
258
- .hide-facet-icon:hover .eye,
259
- .hide-facet-icon .eye-closed {
260
- display: none;
261
- }
262
- .hide-facet-icon:hover .eye-closed,
263
- .hide-facet-icon.active .eye-closed {
264
- display: inline;
265
- }
266
- .hide-facet-icon.active .eye {
267
- display: none;
268
- }
269
- .sorting-icon {
270
- cursor: pointer;
271
- }
272
-
273
- a:link,
274
- a:visited {
275
- text-decoration: none;
276
- color: var(--ia-theme-link-color, #4b64ff);
277
- }
278
- a:hover {
279
- text-decoration: underline;
280
- }
281
- `;
282
- }
283
- }
1
+ import {
2
+ css,
3
+ html,
4
+ LitElement,
5
+ TemplateResult,
6
+ CSSResultGroup,
7
+ nothing,
8
+ } from 'lit';
9
+ import { customElement, property } from 'lit/decorators.js';
10
+ import eyeIcon from '../assets/img/icons/eye';
11
+ import eyeClosedIcon from '../assets/img/icons/eye-closed';
12
+ import type {
13
+ FacetOption,
14
+ FacetBucket,
15
+ FacetEventDetails,
16
+ FacetState,
17
+ } from '../models';
18
+ import type { CollectionTitles } from '../data-source/models';
19
+ import { srOnlyStyle } from '../styles/sr-only';
20
+
21
+ @customElement('facet-row')
22
+ export class FacetRow extends LitElement {
23
+ //
24
+ // UI STATE
25
+ //
26
+
27
+ /** The name of the facet group to which this facet belongs (e.g., "mediatype") */
28
+ @property({ type: String }) facetType?: FacetOption;
29
+
30
+ /** The facet bucket containing details about the state, count, and key for this row */
31
+ @property({ type: Object }) bucket?: FacetBucket;
32
+
33
+ /** The collection name cache for converting collection identifiers to titles */
34
+ @property({ type: Object })
35
+ collectionTitles?: CollectionTitles;
36
+
37
+ //
38
+ // COMPONENT LIFECYCLE METHODS
39
+ //
40
+
41
+ render() {
42
+ return html`${this.facetRowTemplate}`;
43
+ }
44
+
45
+ //
46
+ // TEMPLATE GETTERS
47
+ //
48
+
49
+ /**
50
+ * Template for the full facet row, including the positive/negative checks,
51
+ * the display name, and the count.
52
+ */
53
+ private get facetRowTemplate(): TemplateResult | typeof nothing {
54
+ const { bucket, facetType } = this;
55
+ if (!bucket || !facetType) return nothing;
56
+
57
+ const showOnlyCheckboxId = `${facetType}:${bucket.key}-show-only`;
58
+ const negativeCheckboxId = `${facetType}:${bucket.key}-negative`;
59
+
60
+ const extraNoteSpan = bucket.extraNote
61
+ ? html`<span class="facet-note">${bucket.extraNote}</span>`
62
+ : nothing;
63
+
64
+ // For collections, we render the collection title as a link.
65
+ // For other facet types, we just have a static value to use.
66
+ const bucketTextDisplay =
67
+ facetType !== 'collection'
68
+ ? html`${bucket.displayText ?? bucket.key} ${extraNoteSpan}`
69
+ : html`<a href="/details/${bucket.key}">
70
+ ${this.collectionTitles?.get(bucket.key) ?? bucket.key}
71
+ </a> `;
72
+
73
+ const facetHidden = bucket.state === 'hidden';
74
+ const facetSelected = bucket.state === 'selected';
75
+
76
+ const titleText = `${facetType}: ${bucket.displayText ?? bucket.key}`;
77
+ const onlyShowText = facetSelected
78
+ ? `Show all ${facetType}s`
79
+ : `Only show ${titleText}`;
80
+ const hideText = `Hide ${titleText}`;
81
+ const unhideText = `Unhide ${titleText}`;
82
+ const showHideText = facetHidden ? unhideText : hideText;
83
+ const ariaLabel = `${titleText}, ${bucket.count} results`;
84
+
85
+ // Added data-testid for Playwright testing
86
+ return html`
87
+ <div class="facet-row-container">
88
+ <div class="facet-checkboxes">
89
+ <input
90
+ type="checkbox"
91
+ .name=${facetType}
92
+ .value=${bucket.key}
93
+ @click=${(e: Event) => {
94
+ this.facetClicked(e, false);
95
+ }}
96
+ .checked=${facetSelected}
97
+ class="select-facet-checkbox"
98
+ title=${onlyShowText}
99
+ id=${showOnlyCheckboxId}
100
+ data-testid=${showOnlyCheckboxId}
101
+ />
102
+ <div class="hide-facet-container">
103
+ <input
104
+ type="checkbox"
105
+ id=${negativeCheckboxId}
106
+ .name=${facetType}
107
+ .value=${bucket.key}
108
+ @click=${(e: Event) => {
109
+ this.facetClicked(e, true);
110
+ }}
111
+ .checked=${facetHidden}
112
+ class="hide-facet-checkbox"
113
+ />
114
+ <label
115
+ for=${negativeCheckboxId}
116
+ class="hide-facet-icon${facetHidden ? ' active' : ''}"
117
+ title=${showHideText}
118
+ data-testid=${negativeCheckboxId}
119
+ >
120
+ <span class="sr-only">${showHideText}</span>
121
+ <span class="eye eye-open">${eyeIcon}</span>
122
+ <span class="eye eye-closed">${eyeClosedIcon}</span>
123
+ </label>
124
+ </div>
125
+ </div>
126
+ <label
127
+ for=${showOnlyCheckboxId}
128
+ class="facet-info-display"
129
+ title=${onlyShowText}
130
+ aria-label=${ariaLabel}
131
+ >
132
+ <div class="facet-title">${bucketTextDisplay}</div>
133
+ <div class="facet-count">${bucket.count.toLocaleString()}</div>
134
+ </label>
135
+ </div>
136
+ `;
137
+ }
138
+
139
+ //
140
+ // EVENT HANDLERS & DISPATCHERS
141
+ //
142
+
143
+ /**
144
+ * Handler for whenever this facet is clicked & its state changes
145
+ */
146
+ private facetClicked(e: Event, negative: boolean) {
147
+ const { bucket, facetType } = this;
148
+ if (!bucket || !facetType) return;
149
+
150
+ const target = e.target as HTMLInputElement;
151
+ const { checked } = target;
152
+ this.bucket = {
153
+ ...bucket,
154
+ state: FacetRow.getFacetState(checked, negative),
155
+ };
156
+
157
+ this.dispatchFacetClickEvent({
158
+ facetType,
159
+ bucket: this.bucket,
160
+ negative,
161
+ });
162
+ }
163
+
164
+ /**
165
+ * Emits a `facetClick` event with details about this facet & its current state
166
+ */
167
+ private dispatchFacetClickEvent(detail: FacetEventDetails) {
168
+ const event = new CustomEvent<FacetEventDetails>('facetClick', {
169
+ detail,
170
+ });
171
+ this.dispatchEvent(event);
172
+ }
173
+
174
+ //
175
+ // OTHER METHODS
176
+ //
177
+
178
+ /**
179
+ * Returns the composed facet state corresponding to a positive or negative facet's checked state
180
+ */
181
+ static getFacetState(checked: boolean, negative: boolean): FacetState {
182
+ let state: FacetState;
183
+ if (checked) {
184
+ state = negative ? 'hidden' : 'selected';
185
+ } else {
186
+ state = 'none';
187
+ }
188
+ return state;
189
+ }
190
+
191
+ //
192
+ // STYLES
193
+ //
194
+
195
+ static get styles(): CSSResultGroup {
196
+ const facetRowBorderTop = css`var(--facet-row-border-top, 1px solid transparent)`;
197
+ const facetRowBorderBottom = css`var(--facet-row-border-bottom, 1px solid transparent)`;
198
+ const checkboxHeight = css`15px`;
199
+
200
+ const ownCss = css`
201
+ .facet-checkboxes {
202
+ margin: 0 5px 0 0;
203
+ display: flex;
204
+ height: ${checkboxHeight};
205
+ }
206
+ .facet-checkboxes input:first-child {
207
+ margin-right: 5px;
208
+ }
209
+ .facet-checkboxes input {
210
+ height: ${checkboxHeight};
211
+ width: ${checkboxHeight};
212
+ margin: 0;
213
+ }
214
+ .facet-row-container {
215
+ display: flex;
216
+ font-weight: 500;
217
+ font-size: 1.2rem;
218
+ margin: 0 auto;
219
+ padding: 0.25rem 0;
220
+ height: auto;
221
+ border-top: ${facetRowBorderTop};
222
+ border-bottom: ${facetRowBorderBottom};
223
+ }
224
+ .facet-info-display {
225
+ display: flex;
226
+ flex: 1 1 0%;
227
+ cursor: pointer;
228
+ flex-wrap: wrap;
229
+ }
230
+ .facet-title {
231
+ word-break: break-word;
232
+ display: inline-block;
233
+ flex: 1 1 0%;
234
+ }
235
+ .facet-note {
236
+ color: #bbb;
237
+ }
238
+ .facet-count {
239
+ text-align: right;
240
+ }
241
+ .select-facet-checkbox {
242
+ cursor: pointer;
243
+ display: inline-block;
244
+ }
245
+ .hide-facet-checkbox {
246
+ position: absolute;
247
+ clip: rect(0, 0, 0, 0);
248
+ pointer-events: none;
249
+ }
250
+ .hide-facet-checkbox:focus-visible + .hide-facet-icon {
251
+ outline-style: auto;
252
+ outline-offset: 2px;
253
+ }
254
+ .hide-facet-icon {
255
+ width: ${checkboxHeight};
256
+ height: ${checkboxHeight};
257
+ cursor: pointer;
258
+ display: flex;
259
+ }
260
+ .eye {
261
+ width: ${checkboxHeight};
262
+ height: ${checkboxHeight};
263
+ opacity: 0.3;
264
+ }
265
+ .hide-facet-icon:hover .eye,
266
+ .active .eye {
267
+ opacity: 1;
268
+ }
269
+ .hide-facet-icon:hover .eye-open,
270
+ .hide-facet-icon .eye-closed {
271
+ display: none;
272
+ }
273
+ .hide-facet-icon:hover .eye-closed,
274
+ .hide-facet-icon.active .eye-closed {
275
+ display: inline;
276
+ }
277
+ .hide-facet-icon.active .eye-open {
278
+ display: none;
279
+ }
280
+ .sorting-icon {
281
+ cursor: pointer;
282
+ }
283
+
284
+ a:link,
285
+ a:visited {
286
+ text-decoration: none;
287
+ color: var(--ia-theme-link-color, #4b64ff);
288
+ }
289
+ a:hover {
290
+ text-decoration: underline;
291
+ }
292
+ `;
293
+
294
+ return [srOnlyStyle, ownCss];
295
+ }
296
+ }
@@ -1172,6 +1172,7 @@ export class CollectionBrowserDataSource
1172
1172
 
1173
1173
  this.setSearchResultsLoading(false);
1174
1174
  this.requestHostUpdate();
1175
+ this.host.emitSearchError();
1175
1176
  return;
1176
1177
  }
1177
1178
 
@@ -58,6 +58,7 @@ export interface CollectionBrowserSearchInterface
58
58
  setTileCount(count: number): void;
59
59
  applyDefaultCollectionSort(collectionInfo?: CollectionExtraInfo): void;
60
60
  emitEmptyResults(): void;
61
+ emitSearchError(): void;
61
62
  emitQueryStateChanged(): void;
62
63
  refreshVisibleResults(): void;
63
64
  }