@internetarchive/collection-browser 1.14.4 → 1.14.5-alpha2

package/dist/src/collection-browser.d.ts

@@ -1,524 +1,525 @@
-import { LitElement, PropertyValues, TemplateResult } from 'lit';
-import type { InfiniteScrollerCellProviderInterface } from '@internetarchive/infinite-scroller';
-import { CollectionExtraInfo, SearchServiceInterface, SearchType, SortDirection, SortParam } from '@internetarchive/search-service';
-import type { SharedResizeObserverInterface, SharedResizeObserverResizeHandlerInterface } from '@internetarchive/shared-resize-observer';
-import '@internetarchive/infinite-scroller';
-import type { CollectionNameCacheInterface } from '@internetarchive/collection-name-cache';
-import type { ModalManagerInterface } from '@internetarchive/modal-manager';
-import type { FeatureFeedbackServiceInterface } from '@internetarchive/feature-feedback';
-import type { RecaptchaManagerInterface } from '@internetarchive/recaptcha-manager';
-import './tiles/tile-dispatcher';
-import './tiles/collection-browser-loading-tile';
-import './sort-filter-bar/sort-filter-bar';
-import './manage/manage-bar';
-import './collection-facets';
-import './circular-activity-indicator';
-import { SelectedFacets, SortField, CollectionBrowserContext, TileModel, CollectionDisplayMode, FacetEventDetails } from './models';
-import { RestorationStateHandlerInterface } from './restoration-state-handler';
-import './empty-placeholder';
-export declare class CollectionBrowser extends LitElement implements InfiniteScrollerCellProviderInterface, SharedResizeObserverResizeHandlerInterface {
-    baseNavigationUrl?: string;
-    baseImageUrl: string;
-    searchService?: SearchServiceInterface;
-    searchType: SearchType;
-    withinCollection?: string;
-    baseQuery?: string;
-    displayMode?: CollectionDisplayMode;
-    sortParam: SortParam | null;
-    selectedSort: SortField;
-    selectedTitleFilter: string | null;
-    selectedCreatorFilter: string | null;
-    sortDirection: SortDirection | null;
-    pageSize: number;
-    resizeObserver?: SharedResizeObserverInterface;
-    currentPage?: number;
-    minSelectedDate?: string;
-    maxSelectedDate?: string;
-    selectedFacets?: SelectedFacets;
-    showHistogramDatePicker: boolean;
-    collectionPagePath: string;
-    collectionInfo?: CollectionExtraInfo;
-    parentCollections: string[];
-    /** describes where this component is being used */
-    searchContext: string;
-    collectionNameCache?: CollectionNameCacheInterface;
-    pageContext: CollectionBrowserContext;
-    restorationStateHandler: RestorationStateHandlerInterface;
-    mobileBreakpoint: number;
-    loggedIn: boolean;
-    modalManager?: ModalManagerInterface;
-    featureFeedbackService?: FeatureFeedbackServiceInterface;
-    recaptchaManager?: RecaptchaManagerInterface;
-    /**
-     * If item management UI active
-     */
-    isManageView: boolean;
-    /**
-     * The page that the consumer wants to load.
-     */
-    private initialPageNumber;
-    /**
-     * This the the number of pages that we want to show.
-     *
-     * The data isn't necessarily loaded for all of the pages, but this lets us
-     * know how many cells we should render.
-     */
-    private pagesToRender;
-    /**
-     * Whether the initial page fetch for a new query is currently in progress.
-     */
-    private searchResultsLoading;
-    private facetsLoading;
-    private fullYearAggregationLoading;
-    private aggregations?;
-    private fullYearsHistogramAggregation;
-    private totalResults?;
-    private queryErrorMessage?;
-    private mobileView;
-    private mobileFacetsVisible;
-    private contentWidth?;
-    private defaultSortField;
-    private defaultSortDirection;
-    private placeholderType;
-    private prefixFilterCountMap;
-    private contentContainer;
-    private leftColumn?;
-    private collectionFacets?;
-    private analyticsHandler?;
-    /**
-     * When we're animated scrolling to the page, we don't want to fetch
-     * all of the pages as it scrolls so this lets us know if we're scrolling
-     */
-    private isScrollingToCell;
-    /**
-     * When we've reached the end of the data, stop trying to fetch more
-     */
-    private endOfDataReached;
-    /**
-     * When page width resizes from desktop to mobile, set true to
-     * disable expand/collapse transition when loading.
-     */
-    private isResizeToMobile;
-    private leftColIntersectionObserver?;
-    private facetsIntersectionObserver?;
-    private placeholderCellTemplate;
-    private tileModelAtCellIndex;
-    private get sortFilterQueries();
-    private get estimatedTileCount();
-    /**
-     * The results per page so we can paginate.
-     *
-     * This allows us to start in the middle of the search results and
-     * fetch data before or after the current page. If we don't have a key
-     * for the previous/next page, we'll fetch the next/previous page to populate it
-     */
-    private dataSource;
-    /**
-     * How many tiles to offset the data source by, to account for any removed tiles.
-     */
-    private tileModelOffset;
-    private infiniteScroller;
-    private sessionIdGenPromise?;
-    /**
-     * Returns a promise resolving to a unique string that persists for the current browser session.
-     * Used in generating unique IDs for search requests, so that multiple requests coming from the
-     * same browser session can be identified.
-     */
-    private getSessionId;
-    /**
-     * Go to the given page of results
-     *
-     * @param pageNumber
-     */
-    goToPage(pageNumber: number): Promise<void>;
-    /**
-     * Clears all selected/negated facets, date ranges, and letter filters.
-     *
-     * By default, the current sort field/direction are not cleared,
-     * but this can be overridden by setting the `sort` option to `true`.
-     *
-     * Similarly, it is possible to finely control what is cleared by
-     * setting any of the `facets`, `dateRange`, or `letterFilters` flags
-     * in the options object.
-     */
-    clearFilters({ facets, dateRange, letterFilters, sort, }?: {
-        facets?: boolean | undefined;
-        dateRange?: boolean | undefined;
-        letterFilters?: boolean | undefined;
-        sort?: boolean | undefined;
-    }): void;
-    /**
-     * Returns true if the current value of `this.selectedFacets` contains
-     * any facet buckets than have been selected or negated, or false otherwise.
-     */
-    private get hasCheckedFacets();
-    /**
-     * Returns true if there are any currently selected/negated facet buckets,
-     * any selected date range, or any selected letter filters. False otherwise.
-     *
-     * Ignores sorting options.
-     */
-    private get hasActiveFilters();
-    render(): TemplateResult<1>;
-    private setPlaceholderType;
-    private get emptyPlaceholderTemplate();
-    /**
-     * Top-level template for rendering the left (facets) and right (results) columns.
-     */
-    private get collectionBrowserTemplate();
-    /**
-     * Template for either the mobile or desktop version of the left column, depending
-     * on current component state.
-     */
-    private get leftColumnTemplate();
-    /**
-     * Template for the mobile version of the "left column" (which in this case, appears
-     * *above* the search results rather than beside them), for rendering the
-     * accordion-style facets.
-     */
-    private get mobileLeftColumnTemplate();
-    /**
-     * Template for the desktop version of the left column, displaying the facets sidebar.
-     */
-    private get desktopLeftColumnTemplate();
-    /**
-     * Template for the "X Results" count at the top of the search results.
-     * Changes to the "Searching..." label if the search results are still loading.
-     */
-    private get resultsCountTemplate();
-    /**
-     * Template for the right column of the collection browser, where the result
-     * tiles and sort/filter bar are shown.
-     */
-    private get rightColumnTemplate();
-    private get infiniteScrollerTemplate();
-    private get infiniteScrollerClasses();
-    private get sortFilterBarTemplate();
-    private get manageBarTemplate();
-    /**
-     * Handler for when the user requests to remove all checked items via the manage bar.
-     * Emits an `itemRemovalRequested` event with all checked tile models.
-     */
-    private handleRemoveItems;
-    /**
-     * Removes all tile models that are currently checked & adjusts the paging
-     * of the data source to account for any new gaps in the data.
-     */
-    removeCheckedTiles(): void;
-    /**
-     * Checks every tile's management checkbox
-     */
-    checkAllTiles(): void;
-    /**
-     * Unchecks every tile's management checkbox
-     */
-    uncheckAllTiles(): void;
-    /**
-     * Applies the given map function to all of the tile models in every page of the data
-     * source. This method updates the data source object in immutable fashion.
-     *
-     * @param mapFn A callback function to apply on each tile model, as with Array.map
-     */
-    private mapDataSource;
-    /**
-     * An array of all the tile models whose management checkboxes are checked
-     */
-    get checkedTileModels(): TileModel[];
-    /**
-     * An array of all the tile models whose management checkboxes are unchecked
-     */
-    get uncheckedTileModels(): TileModel[];
-    /**
-     * Returns a flattened, filtered array of all the tile models in the data source
-     * for which the given predicate returns a truthy value.
-     *
-     * @param predicate A callback function to apply on each tile model, as with Array.filter
-     * @returns A filtered array of tile models satisfying the predicate
-     */
-    private getFilteredTileModels;
-    private userChangedSort;
-    private sendSortByAnalytics;
-    private selectedSortChanged;
-    private displayModeChanged;
-    /**
-     * Returns a query clause identifying the currently selected title filter,
-     * e.g., `firstTitle:X`.
-     */
-    private get titleQuery();
-    /**
-     * Returns a query clause identifying the currently selected creator filter,
-     * e.g., `firstCreator:X`.
-     */
-    private get creatorQuery();
-    /**
-     * Send Analytics when sorting by title's first letter
-     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
-     */
-    private sendFilterByTitleAnalytics;
-    /**
-     * Send Analytics when filtering by creator's first letter
-     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
-     */
-    private sendFilterByCreatorAnalytics;
-    /**
-     * Handler for changes to which letter is selected in the title alphabet bar.
-     */
-    private titleLetterSelected;
-    /**
-     * Handler for changes to which letter is selected in the creator alphabet bar.
-     */
-    private creatorLetterSelected;
-    /**
-     * The full template for how the facets should be structured in mobile view,
-     * including the collapsible container (with header) and the facets themselves.
-     */
-    private get mobileFacetsTemplate();
-    /**
-     * The template for the facets component alone, without any surrounding wrappers.
-     */
-    private get facetsTemplate();
-    /**
-     * The HTML template for the "Clear all filters" button, or `nothing` if no
-     * filters are currently active.
-     *
-     * @param mobile Whether to style/shorten the button for mobile view
-     */
-    private clearFiltersBtnTemplate;
-    private get loadingTemplate();
-    private get listHeaderTemplate();
-    private histogramDateRangeUpdated;
-    private get dateRangeQueryClause();
-    /**
-     * Emits an event indicating a change in whether the manage mode is shown.
-     */
-    private emitManageModeChangedEvent;
-    firstUpdated(): void;
-    updated(changed: PropertyValues): void;
-    disconnectedCallback(): void;
-    handleResize(entry: ResizeObserverEntry): void;
-    /**
-     * Sets up listeners for events that may require updating the left column height.
-     */
-    private setupLeftColumnScrollListeners;
-    /**
-     * Sets up listeners to control whether the facet sidebar shows its bottom fade-out.
-     * Note this uses a separate IntersectionObserver from the left column, because we
-     * don't need granular intersection thresholds for this.
-     */
-    private setupFacetsScrollListeners;
-    /**
-     * Updates the height of the left column according to its position on the page.
-     * Arrow function ensures proper `this` binding.
-     */
-    private updateLeftColumnHeight;
-    /**
-     * Toggles whether the fade-out is visible at the bottom of the facets.
-     * It should only be visible if the facets are not scrolled to the bottom.
-     * Arrow function ensures proper `this` binding.
-     */
-    private updateFacetFadeOut;
-    private emitBaseQueryChanged;
-    private emitSearchTypeChanged;
-    private emitEmptyResults;
-    private disconnectResizeObserver;
-    private setupResizeObserver;
-    /**
-     * When the visible cells change from the infinite scroller, we want to emit
-     * which page is currently visible so the consumer can update its UI or the URL
-     *
-     * @param e
-     * @returns
-     */
-    private visibleCellsChanged;
-    private initialQueryChangeHappened;
-    private historyPopOccurred;
-    private previousQueryKey?;
-    /**
-     * Internal property to store the `resolve` function for the most recent
-     * `initialSearchComplete` promise, allowing us to resolve it at the appropriate time.
-     */
-    private _initialSearchCompleteResolver;
-    /**
-     * Internal property to store the private value backing the `initialSearchComplete` getter.
-     */
-    private _initialSearchCompletePromise;
-    /**
-     * A Promise which, after each query change, resolves once the fetches for the initial
-     * search have completed. Waits for *both* the hits and aggregations fetches to finish.
-     *
-     * Ensure you await this component's `updateComplete` promise before awaiting this
-     * one, to ensure you do not await an obsolete promise from the previous update.
-     */
-    get initialSearchComplete(): Promise<boolean>;
-    private handleQueryChange;
-    private setupStateRestorationObserver;
-    private boundNavigationHandler?;
-    private historyNavigationHandler;
-    private restoreState;
-    private persistState;
-    private doInitialPageFetch;
-    private emitSearchResultsLoadingChanged;
-    /**
-     * Produces a compact unique ID for a search request that can help with debugging
-     * on the backend by making related requests easier to trace through different services.
-     * (e.g., tying the hits/aggregations requests for the same page back to a single hash).
-     *
-     * @param params The search service parameters for the request
-     * @param kind The kind of request (hits-only, aggregations-only, or both)
-     * @returns A Promise resolving to the uid to apply to the request
-     */
-    private requestUID;
-    /**
-     * Constructs a search service FilterMap object from the combination of
-     * all the currently-applied filters. This includes any facets, letter
-     * filters, and date range.
-     */
-    private get filterMap();
-    /** The full query, including year facets and date range clauses */
-    private get fullQuery();
-    /**
-     * Generates a query string for the given facets
-     *
-     * Example: `mediatype:("collection" OR "audio" OR -"etree") AND year:("2000" OR "2001")`
-     */
-    private get facetQuery();
-    /**
-     * Builds an OR-joined facet clause for the given facet name and values.
-     *
-     * E.g., for name `subject` and values
-     * `{ foo: { state: 'selected' }, bar: { state: 'hidden' } }`
-     * this will produce the clause
-     * `subject:("foo" OR -"bar")`.
-     *
-     * @param facetName The facet type (e.g., 'collection')
-     * @param facetValues The facet buckets, mapped by their keys
-     */
-    private buildFacetClause;
-    /**
-     * Handles some special pre-request normalization steps for certain facet types
-     * that require them.
-     *
-     * @param facetName The name of the facet type (e.g., 'language')
-     * @param facetValues An array of values for that facet type
-     */
-    private prepareFacetForFetch;
-    /**
-     * Takes an array of facet clauses, and combines them into a
-     * full AND-joined facet query string. Empty clauses are ignored.
-     */
-    private joinFacetClauses;
-    facetsChanged(e: CustomEvent<SelectedFacets>): void;
-    facetClickHandler({ detail: { key, state: facetState, negative }, }: CustomEvent<FacetEventDetails>): void;
-    private fetchFacets;
-    private scrollToPage;
-    /**
-     * Whether sorting by relevance makes sense for the current state.
-     * Currently equivalent to having a non-empty query.
-     */
-    private get isRelevanceSortAvailable();
-    /**
-     * Whether a search may be performed in the current state of the component.
-     * This is only true if the search service is defined, and either
-     *   (a) a non-empty query is set, or
-     *   (b) we are on a collection page in metadata search mode.
-     */
-    private get canPerformSearch();
-    /**
-     * Additional params to pass to the search service if targeting a collection page,
-     * or null otherwise.
-     */
-    private get collectionParams();
-    /**
-     * The query key is a string that uniquely identifies the current search.
-     * It consists of:
-     *  - The current base query
-     *  - The current collection
-     *  - The current search type
-     *  - Any currently-applied facets
-     *  - Any currently-applied date range
-     *  - Any currently-applied prefix filters
-     *  - The current sort options
-     *
-     * This lets us keep track of queries so we don't persist data that's
-     * no longer relevant.
-     */
-    private get pageFetchQueryKey();
-    /**
-     * Similar to `pageFetchQueryKey` above, but excludes sort fields since they
-     * are not relevant in determining aggregation queries.
-     */
-    private get facetFetchQueryKey();
-    private pageFetchesInProgress;
-    /**
-     * Fetches one or more pages of results and updates the data source.
-     *
-     * @param pageNumber The page number to fetch
-     * @param numInitialPages If this is an initial page fetch (`pageNumber = 1`),
-     *  specifies how many pages to batch together in one request. Ignored
-     *  if `pageNumber != 1`, defaulting to a single page.
-     */
-    fetchPage(pageNumber: number, numInitialPages?: number): Promise<void>;
-    private preloadCollectionNames;
-    /**
-     * Applies any default sort option for the current collection, by checking
-     * for one in the collection's metadata. If none is found, defaults to sorting
-     * descending by:
-     *  - Date Favorited for fav-* collections
-     *  - Weekly views for all other collections
-     */
-    private applyDefaultCollectionSort;
-    /**
-     * This is useful for determining whether we need to reload the scroller.
-     *
-     * When the fetch completes, we need to reload the scroller if the cells for that
-     * page are visible, but if the page is not currenlty visible, we don't need to reload
-     */
-    private get currentVisiblePageNumbers();
-    /**
-     * Update the datasource from the fetch response
-     *
-     * @param pageNumber
-     * @param results
-     */
-    private updateDataSource;
-    private getMediatype;
-    /**
-     * Returns the input string, but removing one set of quotes from all instances of
-     * ""clauses wrapped in two sets of quotes"". This assumes the quotes are already
-     * URL-encoded.
-     *
-     * This should be a temporary measure to address the fact that the __href__ field
-     * sometimes acquires extra quotation marks during query rewriting. Once there is a
-     * full Lucene parser in place that handles quoted queries correctly, this can likely
-     * be removed.
-     */
-    private collapseRepeatedQuotes;
-    /** Fetches the aggregation buckets for the given prefix filter type. */
-    private fetchPrefixFilterBuckets;
-    /** Fetches and caches the prefix filter counts for the given filter type. */
-    private updatePrefixFilterCounts;
-    /**
-     * Fetches and caches the prefix filter counts for the current sort type,
-     * provided it is one that permits prefix filtering. (If not, this does nothing).
-     */
-    private updatePrefixFiltersForCurrentSort;
-    /**
-     * Clears the cached letter counts for both title and creator, and
-     * fetches a new set of counts for whichever of them is the currently
-     * selected sort option (which may be neither).
-     *
-     * Call this whenever the counts are invalidated (e.g., by a query change).
-     */
-    private refreshLetterCounts;
-    /**
-     * Callback when a result is selected
-     */
-    resultSelected(event: CustomEvent<TileModel>): void;
-    cellForIndex(index: number): TemplateResult | undefined;
-    /**
-     * When the user scrolls near to the bottom of the page, fetch the next page
-     * increase the number of pages to render and start fetching data for the new page
-     */
-    private scrollThresholdReached;
-    static get styles(): import("lit").CSSResult[];
-}
+import { LitElement, PropertyValues, TemplateResult } from 'lit';
+import type { InfiniteScrollerCellProviderInterface } from '@internetarchive/infinite-scroller';
+import { CollectionExtraInfo, SearchServiceInterface, SearchType, SortDirection, SortParam } from '@internetarchive/search-service';
+import type { SharedResizeObserverInterface, SharedResizeObserverResizeHandlerInterface } from '@internetarchive/shared-resize-observer';
+import '@internetarchive/infinite-scroller';
+import type { CollectionNameCacheInterface } from '@internetarchive/collection-name-cache';
+import type { ModalManagerInterface } from '@internetarchive/modal-manager';
+import type { FeatureFeedbackServiceInterface } from '@internetarchive/feature-feedback';
+import type { RecaptchaManagerInterface } from '@internetarchive/recaptcha-manager';
+import './tiles/tile-dispatcher';
+import './tiles/collection-browser-loading-tile';
+import './sort-filter-bar/sort-filter-bar';
+import './manage/manage-bar';
+import './collection-facets';
+import './circular-activity-indicator';
+import { SelectedFacets, SortField, CollectionBrowserContext, TileModel, CollectionDisplayMode, FacetEventDetails } from './models';
+import { RestorationStateHandlerInterface } from './restoration-state-handler';
+import './empty-placeholder';
+export declare class CollectionBrowser extends LitElement implements InfiniteScrollerCellProviderInterface, SharedResizeObserverResizeHandlerInterface {
+    baseNavigationUrl?: string;
+    baseImageUrl: string;
+    searchService?: SearchServiceInterface;
+    searchType: SearchType;
+    withinCollection?: string;
+    baseQuery?: string;
+    displayMode?: CollectionDisplayMode;
+    sortParam: SortParam | null;
+    defaultSortParam: SortParam | null;
+    selectedSort: SortField;
+    selectedTitleFilter: string | null;
+    selectedCreatorFilter: string | null;
+    sortDirection: SortDirection | null;
+    pageSize: number;
+    resizeObserver?: SharedResizeObserverInterface;
+    currentPage?: number;
+    minSelectedDate?: string;
+    maxSelectedDate?: string;
+    selectedFacets?: SelectedFacets;
+    showHistogramDatePicker: boolean;
+    collectionPagePath: string;
+    collectionInfo?: CollectionExtraInfo;
+    parentCollections: string[];
+    /** describes where this component is being used */
+    searchContext: string;
+    collectionNameCache?: CollectionNameCacheInterface;
+    pageContext: CollectionBrowserContext;
+    restorationStateHandler: RestorationStateHandlerInterface;
+    mobileBreakpoint: number;
+    loggedIn: boolean;
+    modalManager?: ModalManagerInterface;
+    featureFeedbackService?: FeatureFeedbackServiceInterface;
+    recaptchaManager?: RecaptchaManagerInterface;
+    /**
+     * If item management UI active
+     */
+    isManageView: boolean;
+    /**
+     * The page that the consumer wants to load.
+     */
+    private initialPageNumber;
+    /**
+     * This the the number of pages that we want to show.
+     *
+     * The data isn't necessarily loaded for all of the pages, but this lets us
+     * know how many cells we should render.
+     */
+    private pagesToRender;
+    /**
+     * Whether the initial page fetch for a new query is currently in progress.
+     */
+    private searchResultsLoading;
+    private facetsLoading;
+    private fullYearAggregationLoading;
+    private aggregations?;
+    private fullYearsHistogramAggregation;
+    private totalResults?;
+    private queryErrorMessage?;
+    private mobileView;
+    private mobileFacetsVisible;
+    private contentWidth?;
+    private defaultSortField;
+    private defaultSortDirection;
+    private placeholderType;
+    private prefixFilterCountMap;
+    private contentContainer;
+    private leftColumn?;
+    private collectionFacets?;
+    private analyticsHandler?;
+    /**
+     * When we're animated scrolling to the page, we don't want to fetch
+     * all of the pages as it scrolls so this lets us know if we're scrolling
+     */
+    private isScrollingToCell;
+    /**
+     * When we've reached the end of the data, stop trying to fetch more
+     */
+    private endOfDataReached;
+    /**
+     * When page width resizes from desktop to mobile, set true to
+     * disable expand/collapse transition when loading.
+     */
+    private isResizeToMobile;
+    private leftColIntersectionObserver?;
+    private facetsIntersectionObserver?;
+    private placeholderCellTemplate;
+    private tileModelAtCellIndex;
+    private get sortFilterQueries();
+    private get estimatedTileCount();
+    /**
+     * The results per page so we can paginate.
+     *
+     * This allows us to start in the middle of the search results and
+     * fetch data before or after the current page. If we don't have a key
+     * for the previous/next page, we'll fetch the next/previous page to populate it
+     */
+    private dataSource;
+    /**
+     * How many tiles to offset the data source by, to account for any removed tiles.
+     */
+    private tileModelOffset;
+    private infiniteScroller;
+    private sessionIdGenPromise?;
+    /**
+     * Returns a promise resolving to a unique string that persists for the current browser session.
+     * Used in generating unique IDs for search requests, so that multiple requests coming from the
+     * same browser session can be identified.
+     */
+    private getSessionId;
+    /**
+     * Go to the given page of results
+     *
+     * @param pageNumber
+     */
+    goToPage(pageNumber: number): Promise<void>;
+    /**
+     * Clears all selected/negated facets, date ranges, and letter filters.
+     *
+     * By default, the current sort field/direction are not cleared,
+     * but this can be overridden by setting the `sort` option to `true`.
+     *
+     * Similarly, it is possible to finely control what is cleared by
+     * setting any of the `facets`, `dateRange`, or `letterFilters` flags
+     * in the options object.
+     */
+    clearFilters({ facets, dateRange, letterFilters, sort, }?: {
+        facets?: boolean | undefined;
+        dateRange?: boolean | undefined;
+        letterFilters?: boolean | undefined;
+        sort?: boolean | undefined;
+    }): void;
+    /**
+     * Returns true if the current value of `this.selectedFacets` contains
+     * any facet buckets than have been selected or negated, or false otherwise.
+     */
+    private get hasCheckedFacets();
+    /**
+     * Returns true if there are any currently selected/negated facet buckets,
+     * any selected date range, or any selected letter filters. False otherwise.
+     *
+     * Ignores sorting options.
+     */
+    private get hasActiveFilters();
+    render(): TemplateResult<1>;
+    private setPlaceholderType;
+    private get emptyPlaceholderTemplate();
+    /**
+     * Top-level template for rendering the left (facets) and right (results) columns.
+     */
+    private get collectionBrowserTemplate();
+    /**
+     * Template for either the mobile or desktop version of the left column, depending
+     * on current component state.
+     */
+    private get leftColumnTemplate();
+    /**
+     * Template for the mobile version of the "left column" (which in this case, appears
+     * *above* the search results rather than beside them), for rendering the
+     * accordion-style facets.
+     */
+    private get mobileLeftColumnTemplate();
+    /**
+     * Template for the desktop version of the left column, displaying the facets sidebar.
+     */
+    private get desktopLeftColumnTemplate();
+    /**
+     * Template for the "X Results" count at the top of the search results.
+     * Changes to the "Searching..." label if the search results are still loading.
+     */
+    private get resultsCountTemplate();
+    /**
+     * Template for the right column of the collection browser, where the result
+     * tiles and sort/filter bar are shown.
+     */
+    private get rightColumnTemplate();
+    private get infiniteScrollerTemplate();
+    private get infiniteScrollerClasses();
+    private get sortFilterBarTemplate();
+    private get manageBarTemplate();
+    /**
+     * Handler for when the user requests to remove all checked items via the manage bar.
+     * Emits an `itemRemovalRequested` event with all checked tile models.
+     */
+    private handleRemoveItems;
+    /**
+     * Removes all tile models that are currently checked & adjusts the paging
+     * of the data source to account for any new gaps in the data.
+     */
+    removeCheckedTiles(): void;
+    /**
+     * Checks every tile's management checkbox
+     */
+    checkAllTiles(): void;
+    /**
+     * Unchecks every tile's management checkbox
+     */
+    uncheckAllTiles(): void;
+    /**
+     * Applies the given map function to all of the tile models in every page of the data
+     * source. This method updates the data source object in immutable fashion.
+     *
+     * @param mapFn A callback function to apply on each tile model, as with Array.map
+     */
+    private mapDataSource;
+    /**
+     * An array of all the tile models whose management checkboxes are checked
+     */
+    get checkedTileModels(): TileModel[];
+    /**
+     * An array of all the tile models whose management checkboxes are unchecked
+     */
+    get uncheckedTileModels(): TileModel[];
+    /**
+     * Returns a flattened, filtered array of all the tile models in the data source
+     * for which the given predicate returns a truthy value.
+     *
+     * @param predicate A callback function to apply on each tile model, as with Array.filter
+     * @returns A filtered array of tile models satisfying the predicate
+     */
+    private getFilteredTileModels;
+    private userChangedSort;
+    private sendSortByAnalytics;
+    private selectedSortChanged;
+    private displayModeChanged;
+    /**
+     * Returns a query clause identifying the currently selected title filter,
+     * e.g., `firstTitle:X`.
+     */
+    private get titleQuery();
+    /**
+     * Returns a query clause identifying the currently selected creator filter,
+     * e.g., `firstCreator:X`.
+     */
+    private get creatorQuery();
+    /**
+     * Send Analytics when sorting by title's first letter
+     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
+     */
+    private sendFilterByTitleAnalytics;
+    /**
+     * Send Analytics when filtering by creator's first letter
+     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
+     */
+    private sendFilterByCreatorAnalytics;
+    /**
+     * Handler for changes to which letter is selected in the title alphabet bar.
+     */
+    private titleLetterSelected;
+    /**
+     * Handler for changes to which letter is selected in the creator alphabet bar.
+     */
+    private creatorLetterSelected;
+    /**
+     * The full template for how the facets should be structured in mobile view,
+     * including the collapsible container (with header) and the facets themselves.
+     */
+    private get mobileFacetsTemplate();
+    /**
+     * The template for the facets component alone, without any surrounding wrappers.
+     */
+    private get facetsTemplate();
+    /**
+     * The HTML template for the "Clear all filters" button, or `nothing` if no
+     * filters are currently active.
+     *
+     * @param mobile Whether to style/shorten the button for mobile view
+     */
+    private clearFiltersBtnTemplate;
+    private get loadingTemplate();
+    private get listHeaderTemplate();
+    private histogramDateRangeUpdated;
+    private get dateRangeQueryClause();
+    /**
+     * Emits an event indicating a change in whether the manage mode is shown.
+     */
+    private emitManageModeChangedEvent;
+    firstUpdated(): void;
+    updated(changed: PropertyValues): void;
+    disconnectedCallback(): void;
+    handleResize(entry: ResizeObserverEntry): void;
+    /**
+     * Sets up listeners for events that may require updating the left column height.
+     */
+    private setupLeftColumnScrollListeners;
+    /**
+     * Sets up listeners to control whether the facet sidebar shows its bottom fade-out.
+     * Note this uses a separate IntersectionObserver from the left column, because we
+     * don't need granular intersection thresholds for this.
+     */
+    private setupFacetsScrollListeners;
+    /**
+     * Updates the height of the left column according to its position on the page.
+     * Arrow function ensures proper `this` binding.
+     */
+    private updateLeftColumnHeight;
+    /**
+     * Toggles whether the fade-out is visible at the bottom of the facets.
+     * It should only be visible if the facets are not scrolled to the bottom.
+     * Arrow function ensures proper `this` binding.
+     */
+    private updateFacetFadeOut;
+    private emitBaseQueryChanged;
+    private emitSearchTypeChanged;
+    private emitEmptyResults;
+    private disconnectResizeObserver;
+    private setupResizeObserver;
+    /**
+     * When the visible cells change from the infinite scroller, we want to emit
+     * which page is currently visible so the consumer can update its UI or the URL
+     *
+     * @param e
+     * @returns
+     */
+    private visibleCellsChanged;
+    private initialQueryChangeHappened;
+    private historyPopOccurred;
+    private previousQueryKey?;
+    /**
+     * Internal property to store the `resolve` function for the most recent
+     * `initialSearchComplete` promise, allowing us to resolve it at the appropriate time.
+     */
+    private _initialSearchCompleteResolver;
+    /**
+     * Internal property to store the private value backing the `initialSearchComplete` getter.
+     */
+    private _initialSearchCompletePromise;
+    /**
+     * A Promise which, after each query change, resolves once the fetches for the initial
+     * search have completed. Waits for *both* the hits and aggregations fetches to finish.
+     *
+     * Ensure you await this component's `updateComplete` promise before awaiting this
+     * one, to ensure you do not await an obsolete promise from the previous update.
+     */
+    get initialSearchComplete(): Promise<boolean>;
+    private handleQueryChange;
+    private setupStateRestorationObserver;
+    private boundNavigationHandler?;
+    private historyNavigationHandler;
+    private restoreState;
+    private persistState;
+    private doInitialPageFetch;
+    private emitSearchResultsLoadingChanged;
+    /**
+     * Produces a compact unique ID for a search request that can help with debugging
+     * on the backend by making related requests easier to trace through different services.
+     * (e.g., tying the hits/aggregations requests for the same page back to a single hash).
+     *
+     * @param params The search service parameters for the request
+     * @param kind The kind of request (hits-only, aggregations-only, or both)
+     * @returns A Promise resolving to the uid to apply to the request
+     */
+    private requestUID;
+    /**
+     * Constructs a search service FilterMap object from the combination of
+     * all the currently-applied filters. This includes any facets, letter
+     * filters, and date range.
+     */
+    private get filterMap();
+    /** The full query, including year facets and date range clauses */
+    private get fullQuery();
+    /**
+     * Generates a query string for the given facets
+     *
+     * Example: `mediatype:("collection" OR "audio" OR -"etree") AND year:("2000" OR "2001")`
+     */
+    private get facetQuery();
+    /**
+     * Builds an OR-joined facet clause for the given facet name and values.
+     *
+     * E.g., for name `subject` and values
+     * `{ foo: { state: 'selected' }, bar: { state: 'hidden' } }`
+     * this will produce the clause
+     * `subject:("foo" OR -"bar")`.
+     *
+     * @param facetName The facet type (e.g., 'collection')
+     * @param facetValues The facet buckets, mapped by their keys
+     */
+    private buildFacetClause;
+    /**
+     * Handles some special pre-request normalization steps for certain facet types
+     * that require them.
+     *
+     * @param facetName The name of the facet type (e.g., 'language')
+     * @param facetValues An array of values for that facet type
+     */
+    private prepareFacetForFetch;
+    /**
+     * Takes an array of facet clauses, and combines them into a
+     * full AND-joined facet query string. Empty clauses are ignored.
+     */
+    private joinFacetClauses;
+    facetsChanged(e: CustomEvent<SelectedFacets>): void;
+    facetClickHandler({ detail: { key, state: facetState, negative }, }: CustomEvent<FacetEventDetails>): void;
+    private fetchFacets;
+    private scrollToPage;
+    /**
+     * Whether sorting by relevance makes sense for the current state.
+     * Currently equivalent to having a non-empty query.
+     */
+    private get isRelevanceSortAvailable();
+    /**
+     * Whether a search may be performed in the current state of the component.
+     * This is only true if the search service is defined, and either
+     *   (a) a non-empty query is set, or
+     *   (b) we are on a collection page in metadata search mode.
+     */
+    private get canPerformSearch();
+    /**
+     * Additional params to pass to the search service if targeting a collection page,
+     * or null otherwise.
+     */
+    private get collectionParams();
+    /**
+     * The query key is a string that uniquely identifies the current search.
+     * It consists of:
+     *  - The current base query
+     *  - The current collection
+     *  - The current search type
+     *  - Any currently-applied facets
+     *  - Any currently-applied date range
+     *  - Any currently-applied prefix filters
+     *  - The current sort options
+     *
+     * This lets us keep track of queries so we don't persist data that's
+     * no longer relevant.
+     */
+    private get pageFetchQueryKey();
+    /**
+     * Similar to `pageFetchQueryKey` above, but excludes sort fields since they
+     * are not relevant in determining aggregation queries.
+     */
+    private get facetFetchQueryKey();
+    private pageFetchesInProgress;
+    /**
+     * Fetches one or more pages of results and updates the data source.
+     *
+     * @param pageNumber The page number to fetch
+     * @param numInitialPages If this is an initial page fetch (`pageNumber = 1`),
+     *  specifies how many pages to batch together in one request. Ignored
+     *  if `pageNumber != 1`, defaulting to a single page.
+     */
+    fetchPage(pageNumber: number, numInitialPages?: number): Promise<void>;
+    private preloadCollectionNames;
+    /**
+     * Applies any default sort option for the current collection, by checking
+     * for one in the collection's metadata. If none is found, defaults to sorting
+     * descending by:
+     *  - Date Favorited for fav-* collections
+     *  - Weekly views for all other collections
+     */
+    private applyDefaultCollectionSort;
+    /**
+     * This is useful for determining whether we need to reload the scroller.
+     *
+     * When the fetch completes, we need to reload the scroller if the cells for that
+     * page are visible, but if the page is not currenlty visible, we don't need to reload
+     */
+    private get currentVisiblePageNumbers();
+    /**
+     * Update the datasource from the fetch response
+     *
+     * @param pageNumber
+     * @param results
+     */
+    private updateDataSource;
+    private getMediatype;
+    /**
+     * Returns the input string, but removing one set of quotes from all instances of
+     * ""clauses wrapped in two sets of quotes"". This assumes the quotes are already
+     * URL-encoded.
+     *
+     * This should be a temporary measure to address the fact that the __href__ field
+     * sometimes acquires extra quotation marks during query rewriting. Once there is a
+     * full Lucene parser in place that handles quoted queries correctly, this can likely
+     * be removed.
+     */
+    private collapseRepeatedQuotes;
+    /** Fetches the aggregation buckets for the given prefix filter type. */
+    private fetchPrefixFilterBuckets;
+    /** Fetches and caches the prefix filter counts for the given filter type. */
+    private updatePrefixFilterCounts;
+    /**
+     * Fetches and caches the prefix filter counts for the current sort type,
+     * provided it is one that permits prefix filtering. (If not, this does nothing).
+     */
+    private updatePrefixFiltersForCurrentSort;
+    /**
+     * Clears the cached letter counts for both title and creator, and
+     * fetches a new set of counts for whichever of them is the currently
+     * selected sort option (which may be neither).
+     *
+     * Call this whenever the counts are invalidated (e.g., by a query change).
+     */
+    private refreshLetterCounts;
+    /**
+     * Callback when a result is selected
+     */
+    resultSelected(event: CustomEvent<TileModel>): void;
+    cellForIndex(index: number): TemplateResult | undefined;
+    /**
+     * When the user scrolls near to the bottom of the page, fetch the next page
+     * increase the number of pages to render and start fetching data for the new page
+     */
+    private scrollThresholdReached;
+    static get styles(): import("lit").CSSResult[];
+}