@internetarchive/collection-browser 0.4.2 → 0.4.3-alpha.2

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

@@ -1,315 +1,315 @@
-import { LitElement, PropertyValues, TemplateResult } from 'lit';
-import type { InfiniteScrollerCellProviderInterface } from '@internetarchive/infinite-scroller';
-import { 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 './tiles/tile-dispatcher';
-import './tiles/collection-browser-loading-tile';
-import './sort-filter-bar/sort-filter-bar';
-import './collection-facets';
-import './circular-activity-indicator';
-import './sort-filter-bar/sort-filter-bar';
-import { SelectedFacets, SortField, CollectionBrowserContext, TileModel, CollectionDisplayMode, FacetOption } 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;
-    baseQuery?: string;
-    displayMode?: CollectionDisplayMode;
-    sortParam: SortParam | null;
-    selectedSort: SortField;
-    selectedTitleFilter: string | null;
-    selectedCreatorFilter: string | null;
-    sortDirection: SortDirection | null;
-    pageSize: number;
-    resizeObserver?: SharedResizeObserverInterface;
-    titleQuery?: string;
-    creatorQuery?: string;
-    currentPage?: number;
-    minSelectedDate?: string;
-    maxSelectedDate?: string;
-    selectedFacets?: SelectedFacets;
-    showHistogramDatePicker: boolean;
-    /** describes where this component is being used */
-    searchContext: string;
-    collectionNameCache?: CollectionNameCacheInterface;
-    pageContext: CollectionBrowserContext;
-    restorationStateHandler: RestorationStateHandlerInterface;
-    mobileBreakpoint: number;
-    loggedIn: boolean;
-    modalManager?: ModalManagerInterface;
-    /**
-     * 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;
-    private searchResultsLoading;
-    private facetsLoading;
-    private fullYearAggregationLoading;
-    private aggregations?;
-    private fullYearsHistogramAggregation;
-    /**
-     * The search type of the previous search (i.e., the currently displayed
-     * search results), which may differ from the one that is currently selected
-     * to be used for the next search.
-     */
-    private previousSearchType?;
-    private totalResults?;
-    private mobileView;
-    private mobileFacetsVisible;
-    private placeholderType;
-    private prefixFilterCountMap;
-    private contentContainer;
-    private languageCodeHandler;
-    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 placeholderCellTemplate;
-    private tileModelAtCellIndex;
-    private get sortFilterQueries();
-    private get estimatedTileCount();
-    private get actualTileCount();
-    /**
-     * 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;
-    private infiniteScroller;
-    /**
-     * Go to the given page of results
-     *
-     * @param pageNumber
-     */
-    goToPage(pageNumber: number): void;
-    clearFilters(): void;
-    /**
-     * Manually requests to perform a search, which will only be executed if one of
-     * the query, the search type, or the sort has changed.
-     */
-    requestSearch(): void;
-    render(): TemplateResult<1>;
-    private setPlaceholderType;
-    private get emptyPlaceholderTemplate();
-    private get collectionBrowserTemplate();
-    private get infiniteScrollerTemplate();
-    private get sortFilterBarTemplate();
-    private userChangedSort;
-    private sendSortByAnalytics;
-    private selectedSortChanged;
-    private displayModeChanged;
-    /** Send Analytics when sorting by title's first letter
-     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
-     * */
-    private sendFilterByTitleAnalytics;
-    private selectedTitleLetterChanged;
-    /** Send Analytics when filtering by creator's first letter
-     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
-     * */
-    private sendFilterByCreatorAnalytics;
-    private selectedCreatorLetterChanged;
-    private titleLetterSelected;
-    private creatorLetterSelected;
-    private get facetDataLoading();
-    private get mobileFacetsTemplate();
-    private get facetsTemplate();
-    private get loadingTemplate();
-    private get listHeaderTemplate();
-    private histogramDateRangeUpdated;
-    private get dateRangeQueryClause();
-    firstUpdated(): void;
-    updated(changed: PropertyValues): void;
-    disconnectedCallback(): void;
-    handleResize(entry: ResizeObserverEntry): void;
-    private emitBaseQueryChanged;
-    private emitSearchTypeChanged;
-    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?;
-    private handleQueryChange;
-    private setupStateRestorationObserver;
-    private boundNavigationHandler?;
-    private historyNavigationHandler;
-    private restoreState;
-    private persistState;
-    private doInitialPageFetch;
-    private get filterMap();
-    /** The base query joined with any title/creator letter filters */
-    private get filteredQuery();
-    /** The full query, including year facets and date range clauses */
-    private get fullQuery();
-    /** The full query without any title/creator letter filters */
-    private get fullQueryWithoutAlphaFilters();
-    /** The full query without any year facets or date range clauses */
-    private get fullQueryWithoutDates();
-    /**
-     * Generates a query string for the given facets
-     *
-     * Example: `mediatype:("collection" OR "audio" OR -"etree") AND year:("2000" OR "2001")`
-     */
-    private get facetQuery();
-    /**
-     * Generates a query string for the currently selected facets, excluding 'year' facets.
-     *
-     * Example: `mediatype:("collection" OR "audio" OR -"etree") AND subject:("foo" OR -"bar")`
-     */
-    private get facetQueryWithoutYear();
-    /**
-     * 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(name: FacetOption, facetSelected: boolean, negative: boolean): void;
-    private fetchFacets;
-    /**
-     * If we haven't changed the query, we don't need to fetch the full year histogram
-     *
-     * @private
-     * @type {string}
-     * @memberof CollectionBrowser
-     */
-    private previousFullQueryNoDate?;
-    /**
-     * The query key is a string that uniquely identifies the current query
-     * without the date range.
-     *
-     * If this doesn't change, we don't need to re-fetch the histogram date range
-     */
-    private get fullQueryNoDateKey();
-    /**
-     * This method is similar to fetching the facets above,
-     * but only fetching the year histogram. There is a subtle difference
-     * in how you have to fetch the year histogram where you can't use the
-     * advanced JSON syntax like the other aggregations. It's a special
-     * case that @ximm put it place.
-     */
-    private fetchFullYearHistogram;
-    /**
-     * We only want to send a separate request for the year_histogram data
-     * if (a) the date picker component is enabled and (b) there is a year facet or date-range filter applied.
-     *
-     * Otherwise, we should just be using the histogram data supplied by the "normal" facet request.
-     */
-    private get shouldRequestYearHistogram();
-    private scrollToPage;
-    /**
-     * The query key is a string that uniquely identifies the current search.
-     * It consists of:
-     *  - The current base query
-     *  - 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();
-    private pageFetchesInProgress;
-    fetchPage(pageNumber: number): Promise<void>;
-    private preloadCollectionNames;
-    /**
-     * 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;
-    /** 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;
-    private etreeTitle;
-    /**
-     * 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 styles: import("lit").CSSResult;
-}
+import { LitElement, PropertyValues, TemplateResult } from 'lit';
+import type { InfiniteScrollerCellProviderInterface } from '@internetarchive/infinite-scroller';
+import { 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 './tiles/tile-dispatcher';
+import './tiles/collection-browser-loading-tile';
+import './sort-filter-bar/sort-filter-bar';
+import './collection-facets';
+import './circular-activity-indicator';
+import './sort-filter-bar/sort-filter-bar';
+import { SelectedFacets, SortField, CollectionBrowserContext, TileModel, CollectionDisplayMode, FacetOption } 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;
+    baseQuery?: string;
+    displayMode?: CollectionDisplayMode;
+    sortParam?: SortParam;
+    sortDirection?: SortDirection;
+    selectedSort: SortField;
+    selectedTitleFilter?: string;
+    selectedCreatorFilter?: string;
+    pageSize: number;
+    resizeObserver?: SharedResizeObserverInterface;
+    titleQuery?: string;
+    creatorQuery?: string;
+    currentPage?: number;
+    minSelectedDate?: string;
+    maxSelectedDate?: string;
+    selectedFacets?: SelectedFacets;
+    showHistogramDatePicker: boolean;
+    /** describes where this component is being used */
+    searchContext: string;
+    collectionNameCache?: CollectionNameCacheInterface;
+    pageContext: CollectionBrowserContext;
+    restorationStateHandler: RestorationStateHandlerInterface;
+    mobileBreakpoint: number;
+    loggedIn: boolean;
+    modalManager?: ModalManagerInterface;
+    /**
+     * 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;
+    private searchResultsLoading;
+    private facetsLoading;
+    private fullYearAggregationLoading;
+    private aggregations?;
+    private fullYearsHistogramAggregation;
+    /**
+     * The search type of the previous search (i.e., the currently displayed
+     * search results), which may differ from the one that is currently selected
+     * to be used for the next search.
+     */
+    private previousSearchType?;
+    private totalResults?;
+    private mobileView;
+    private mobileFacetsVisible;
+    private placeholderType;
+    private prefixFilterCountMap;
+    private contentContainer;
+    private languageCodeHandler;
+    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 placeholderCellTemplate;
+    private tileModelAtCellIndex;
+    private get sortFilterQueries();
+    private get estimatedTileCount();
+    private get actualTileCount();
+    /**
+     * 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;
+    private infiniteScroller;
+    /**
+     * Go to the given page of results
+     *
+     * @param pageNumber
+     */
+    goToPage(pageNumber: number): void;
+    clearFilters(): void;
+    /**
+     * Manually requests to perform a search, which will only be executed if one of
+     * the query, the search type, or the sort has changed.
+     */
+    requestSearch(): void;
+    render(): TemplateResult<1>;
+    private setPlaceholderType;
+    private get emptyPlaceholderTemplate();
+    private get collectionBrowserTemplate();
+    private get infiniteScrollerTemplate();
+    private get sortFilterBarTemplate();
+    private userChangedSort;
+    private sendSortByAnalytics;
+    private selectedSortChanged;
+    private displayModeChanged;
+    /** Send Analytics when sorting by title's first letter
+     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
+     * */
+    private sendFilterByTitleAnalytics;
+    private selectedTitleLetterChanged;
+    /** Send Analytics when filtering by creator's first letter
+     * labels: 'start-<ToLetter>' | 'clear-<FromLetter>' | '<FromLetter>-<ToLetter>'
+     * */
+    private sendFilterByCreatorAnalytics;
+    private selectedCreatorLetterChanged;
+    private titleLetterSelected;
+    private creatorLetterSelected;
+    private get facetDataLoading();
+    private get mobileFacetsTemplate();
+    private get facetsTemplate();
+    private get loadingTemplate();
+    private get listHeaderTemplate();
+    private histogramDateRangeUpdated;
+    private get dateRangeQueryClause();
+    firstUpdated(): void;
+    updated(changed: PropertyValues): void;
+    disconnectedCallback(): void;
+    handleResize(entry: ResizeObserverEntry): void;
+    private emitBaseQueryChanged;
+    private emitSearchTypeChanged;
+    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?;
+    private handleQueryChange;
+    private setupStateRestorationObserver;
+    private boundNavigationHandler?;
+    private historyNavigationHandler;
+    private restoreState;
+    private persistState;
+    private doInitialPageFetch;
+    private get filterMap();
+    /** The base query joined with any title/creator letter filters */
+    private get filteredQuery();
+    /** The full query, including year facets and date range clauses */
+    private get fullQuery();
+    /** The full query without any title/creator letter filters */
+    private get fullQueryWithoutAlphaFilters();
+    /** The full query without any year facets or date range clauses */
+    private get fullQueryWithoutDates();
+    /**
+     * Generates a query string for the given facets
+     *
+     * Example: `mediatype:("collection" OR "audio" OR -"etree") AND year:("2000" OR "2001")`
+     */
+    private get facetQuery();
+    /**
+     * Generates a query string for the currently selected facets, excluding 'year' facets.
+     *
+     * Example: `mediatype:("collection" OR "audio" OR -"etree") AND subject:("foo" OR -"bar")`
+     */
+    private get facetQueryWithoutYear();
+    /**
+     * 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(name: FacetOption, facetSelected: boolean, negative: boolean): void;
+    private fetchFacets;
+    /**
+     * If we haven't changed the query, we don't need to fetch the full year histogram
+     *
+     * @private
+     * @type {string}
+     * @memberof CollectionBrowser
+     */
+    private previousFullQueryNoDate?;
+    /**
+     * The query key is a string that uniquely identifies the current query
+     * without the date range.
+     *
+     * If this doesn't change, we don't need to re-fetch the histogram date range
+     */
+    private get fullQueryNoDateKey();
+    /**
+     * This method is similar to fetching the facets above,
+     * but only fetching the year histogram. There is a subtle difference
+     * in how you have to fetch the year histogram where you can't use the
+     * advanced JSON syntax like the other aggregations. It's a special
+     * case that @ximm put it place.
+     */
+    private fetchFullYearHistogram;
+    /**
+     * We only want to send a separate request for the year_histogram data
+     * if (a) the date picker component is enabled and (b) there is a year facet or date-range filter applied.
+     *
+     * Otherwise, we should just be using the histogram data supplied by the "normal" facet request.
+     */
+    private get shouldRequestYearHistogram();
+    private scrollToPage;
+    /**
+     * The query key is a string that uniquely identifies the current search.
+     * It consists of:
+     *  - The current base query
+     *  - 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();
+    private pageFetchesInProgress;
+    fetchPage(pageNumber: number): Promise<void>;
+    private preloadCollectionNames;
+    /**
+     * 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;
+    /** 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;
+    private etreeTitle;
+    /**
+     * 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 styles: import("lit").CSSResult;
+}