@internetarchive/collection-browser 2.3.0 → 2.4.0-e2e-test-0

package/dist/src/tiles/tile-display-value-provider.js

@@ -1,95 +1,95 @@
-import { html, nothing } from 'lit';
-import { msg, str } from '@lit/localize';
-import { formatDate } from '../utils/format-date';
-/**
- * A class encapsulating shared logic for converting model values into display values
- * across different types of tiles.
- */
-export class TileDisplayValueProvider {
-    constructor(options = {}) {
-        var _a;
-        this.model = options.model;
-        this.baseNavigationUrl = options.baseNavigationUrl;
-        this.collectionPagePath = (_a = options.collectionPagePath) !== null && _a !== void 0 ? _a : '/details/';
-        this.sortParam = options.sortParam;
-        this.creatorFilter = options.creatorFilter;
-    }
-    /**
-     * Examines the creator(s) for the given tile model, returning
-     * the first creator whose name matches the provided filter
-     * (or simply the first creator overall if no filter is provided).
-     */
-    get firstCreatorMatchingFilter() {
-        var _a, _b;
-        let matchingCreator;
-        // If we're filtering by creator initial and have multiple creators, we want
-        // to surface the first creator who matches the filter.
-        if (this.creatorFilter && ((_a = this.model) === null || _a === void 0 ? void 0 : _a.creators.length)) {
-            const firstLetter = this.creatorFilter; // This is just to satisfy tsc
-            matchingCreator = this.model.creators.find(creator => 
-            // Decompose combining characters first, so that e.g., filtering on E matches É too.
-            // Then remove anything that isn't strictly alphabetic, since our filters currently
-            // only handle A-Z. The first such letter (if one exists) is what needs to match.
-            creator
-                .normalize('NFD')
-                .replace(/[^A-Z]+/gi, '')
-                .toUpperCase()
-                .startsWith(firstLetter));
-        }
-        return matchingCreator !== null && matchingCreator !== void 0 ? matchingCreator : (_b = this.model) === null || _b === void 0 ? void 0 : _b.creator;
-    }
-    /**
-     * The label indicating what year an account item was created.
-     * E.g., "Archivist since 2015"
-     */
-    get accountLabel() {
-        var _a;
-        return ((_a = this.model) === null || _a === void 0 ? void 0 : _a.dateAdded)
-            ? msg(str `Archivist since ${this.model.dateAdded.getFullYear()}`)
-            : '';
-    }
-    /**
-     * The readable label for the current sort if it is a type of date sort,
-     * or the empty string otherwise.
-     */
-    get dateLabel() {
-        var _a;
-        switch ((_a = this.sortParam) === null || _a === void 0 ? void 0 : _a.field) {
-            case 'publicdate':
-                return msg('Archived');
-            case 'reviewdate':
-                return msg('Reviewed');
-            case 'addeddate':
-                return msg('Added');
-            case 'date':
-                return msg('Published');
-            default:
-                return '';
-        }
-    }
-    /**
-     * Produces a URL pointing at the item page for the given identifier,
-     * using the current base URL and the correct path based on whether the
-     * item is specified to be a collection (default false).
-     */
-    itemPageUrl(identifier, isCollection = false) {
-        if (!identifier || this.baseNavigationUrl == null)
-            return nothing;
-        const basePath = isCollection ? this.collectionPagePath : '/details/';
-        return `${this.baseNavigationUrl}${basePath}${identifier}`;
-    }
-    /**
-     * Produces a template for a link to a single web capture of the given URL and date
-     */
-    webArchivesCaptureLink(url, date) {
-        // Convert the date into the format used to identify wayback captures (e.g., '20150102124550')
-        const captureDateStr = date
-            .toISOString()
-            .replace(/[TZ:-]/g, '')
-            .replace(/\..*/, '');
-        const captureHref = `https://web.archive.org/web/${captureDateStr}/${encodeURIComponent(url)}`;
-        const captureText = formatDate(date, 'long');
-        return html ` <a href=${captureHref}> ${captureText} </a> `;
-    }
-}
+import { html, nothing } from 'lit';
+import { msg, str } from '@lit/localize';
+import { formatDate } from '../utils/format-date';
+/**
+ * A class encapsulating shared logic for converting model values into display values
+ * across different types of tiles.
+ */
+export class TileDisplayValueProvider {
+    constructor(options = {}) {
+        var _a;
+        this.model = options.model;
+        this.baseNavigationUrl = options.baseNavigationUrl;
+        this.collectionPagePath = (_a = options.collectionPagePath) !== null && _a !== void 0 ? _a : '/details/';
+        this.sortParam = options.sortParam;
+        this.creatorFilter = options.creatorFilter;
+    }
+    /**
+     * Examines the creator(s) for the given tile model, returning
+     * the first creator whose name matches the provided filter
+     * (or simply the first creator overall if no filter is provided).
+     */
+    get firstCreatorMatchingFilter() {
+        var _a, _b;
+        let matchingCreator;
+        // If we're filtering by creator initial and have multiple creators, we want
+        // to surface the first creator who matches the filter.
+        if (this.creatorFilter && ((_a = this.model) === null || _a === void 0 ? void 0 : _a.creators.length)) {
+            const firstLetter = this.creatorFilter; // This is just to satisfy tsc
+            matchingCreator = this.model.creators.find(creator => 
+            // Decompose combining characters first, so that e.g., filtering on E matches É too.
+            // Then remove anything that isn't strictly alphabetic, since our filters currently
+            // only handle A-Z. The first such letter (if one exists) is what needs to match.
+            creator
+                .normalize('NFD')
+                .replace(/[^A-Z]+/gi, '')
+                .toUpperCase()
+                .startsWith(firstLetter));
+        }
+        return matchingCreator !== null && matchingCreator !== void 0 ? matchingCreator : (_b = this.model) === null || _b === void 0 ? void 0 : _b.creator;
+    }
+    /**
+     * The label indicating what year an account item was created.
+     * E.g., "Archivist since 2015"
+     */
+    get accountLabel() {
+        var _a;
+        return ((_a = this.model) === null || _a === void 0 ? void 0 : _a.dateAdded)
+            ? msg(str `Archivist since ${this.model.dateAdded.getFullYear()}`)
+            : '';
+    }
+    /**
+     * The readable label for the current sort if it is a type of date sort,
+     * or the empty string otherwise.
+     */
+    get dateLabel() {
+        var _a;
+        switch ((_a = this.sortParam) === null || _a === void 0 ? void 0 : _a.field) {
+            case 'publicdate':
+                return msg('Archived');
+            case 'reviewdate':
+                return msg('Reviewed');
+            case 'addeddate':
+                return msg('Added');
+            case 'date':
+                return msg('Published');
+            default:
+                return '';
+        }
+    }
+    /**
+     * Produces a URL pointing at the item page for the given identifier,
+     * using the current base URL and the correct path based on whether the
+     * item is specified to be a collection (default false).
+     */
+    itemPageUrl(identifier, isCollection = false) {
+        if (!identifier || this.baseNavigationUrl == null)
+            return nothing;
+        const basePath = isCollection ? this.collectionPagePath : '/details/';
+        return `${this.baseNavigationUrl}${basePath}${identifier}`;
+    }
+    /**
+     * Produces a template for a link to a single web capture of the given URL and date
+     */
+    webArchivesCaptureLink(url, date) {
+        // Convert the date into the format used to identify wayback captures (e.g., '20150102124550')
+        const captureDateStr = date
+            .toISOString()
+            .replace(/[TZ:-]/g, '')
+            .replace(/\..*/, '');
+        const captureHref = `https://web.archive.org/web/${captureDateStr}/${encodeURIComponent(url)}`;
+        const captureText = formatDate(date, 'long');
+        return html ` <a href=${captureHref}> ${captureText} </a> `;
+    }
+}
 //# sourceMappingURL=tile-display-value-provider.js.map

package/dist/src/utils/analytics-events.d.ts

@@ -1,28 +1,28 @@
-/**
- * Analytics categories and events. Used when building actions in
- */
-export declare enum analyticsCategories {
-    default = "collection-browser"
-}
-export declare enum analyticsActions {
-    sortBy = "sortBy",
-    filterByCreator = "filterByCreator",
-    filterByTitle = "filterByTitle",
-    displayMode = "displayMode",
-    loadDesktopView = "loadDesktopView",
-    loadMobileView = "loadMobileView",
-    facetSelected = "facetSelected",
-    facetDeselected = "facetDeselected",
-    facetNegativeSelected = "facetNegativeSelected",
-    facetNegativeDeselected = "facetNegativeDeselected",
-    mobileFacetsToggled = "mobileFacetsToggled",
-    partOfCollectionClicked = "partOfCollectionClicked",
-    histogramChanged = "histogramChanged",
-    histogramChangedFromModal = "histogramChangedFromModal",
-    histogramExpanded = "histogramExpanded",
-    resultSelected = "resultSelected",
-    moreFacetsPageChange = "moreFacetsPageChange",
-    showMoreFacetsModal = "showMoreFacetsModal",
-    closeMoreFacetsModal = "closeMoreFacetsModal",
-    applyMoreFacetsModal = "applyMoreFacetsModal"
-}
+/**
+ * Analytics categories and events. Used when building actions in
+ */
+export declare enum analyticsCategories {
+    default = "collection-browser"
+}
+export declare enum analyticsActions {
+    sortBy = "sortBy",
+    filterByCreator = "filterByCreator",
+    filterByTitle = "filterByTitle",
+    displayMode = "displayMode",
+    loadDesktopView = "loadDesktopView",
+    loadMobileView = "loadMobileView",
+    facetSelected = "facetSelected",
+    facetDeselected = "facetDeselected",
+    facetNegativeSelected = "facetNegativeSelected",
+    facetNegativeDeselected = "facetNegativeDeselected",
+    mobileFacetsToggled = "mobileFacetsToggled",
+    partOfCollectionClicked = "partOfCollectionClicked",
+    histogramChanged = "histogramChanged",
+    histogramChangedFromModal = "histogramChangedFromModal",
+    histogramExpanded = "histogramExpanded",
+    resultSelected = "resultSelected",
+    moreFacetsPageChange = "moreFacetsPageChange",
+    showMoreFacetsModal = "showMoreFacetsModal",
+    closeMoreFacetsModal = "closeMoreFacetsModal",
+    applyMoreFacetsModal = "applyMoreFacetsModal"
+}

package/dist/src/utils/analytics-events.js

@@ -1,31 +1,31 @@
-/**
- * Analytics categories and events. Used when building actions in
- */
-export var analyticsCategories;
-(function (analyticsCategories) {
-    analyticsCategories["default"] = "collection-browser";
-})(analyticsCategories || (analyticsCategories = {}));
-export var analyticsActions;
-(function (analyticsActions) {
-    analyticsActions["sortBy"] = "sortBy";
-    analyticsActions["filterByCreator"] = "filterByCreator";
-    analyticsActions["filterByTitle"] = "filterByTitle";
-    analyticsActions["displayMode"] = "displayMode";
-    analyticsActions["loadDesktopView"] = "loadDesktopView";
-    analyticsActions["loadMobileView"] = "loadMobileView";
-    analyticsActions["facetSelected"] = "facetSelected";
-    analyticsActions["facetDeselected"] = "facetDeselected";
-    analyticsActions["facetNegativeSelected"] = "facetNegativeSelected";
-    analyticsActions["facetNegativeDeselected"] = "facetNegativeDeselected";
-    analyticsActions["mobileFacetsToggled"] = "mobileFacetsToggled";
-    analyticsActions["partOfCollectionClicked"] = "partOfCollectionClicked";
-    analyticsActions["histogramChanged"] = "histogramChanged";
-    analyticsActions["histogramChangedFromModal"] = "histogramChangedFromModal";
-    analyticsActions["histogramExpanded"] = "histogramExpanded";
-    analyticsActions["resultSelected"] = "resultSelected";
-    analyticsActions["moreFacetsPageChange"] = "moreFacetsPageChange";
-    analyticsActions["showMoreFacetsModal"] = "showMoreFacetsModal";
-    analyticsActions["closeMoreFacetsModal"] = "closeMoreFacetsModal";
-    analyticsActions["applyMoreFacetsModal"] = "applyMoreFacetsModal";
-})(analyticsActions || (analyticsActions = {}));
+/**
+ * Analytics categories and events. Used when building actions in
+ */
+export var analyticsCategories;
+(function (analyticsCategories) {
+    analyticsCategories["default"] = "collection-browser";
+})(analyticsCategories || (analyticsCategories = {}));
+export var analyticsActions;
+(function (analyticsActions) {
+    analyticsActions["sortBy"] = "sortBy";
+    analyticsActions["filterByCreator"] = "filterByCreator";
+    analyticsActions["filterByTitle"] = "filterByTitle";
+    analyticsActions["displayMode"] = "displayMode";
+    analyticsActions["loadDesktopView"] = "loadDesktopView";
+    analyticsActions["loadMobileView"] = "loadMobileView";
+    analyticsActions["facetSelected"] = "facetSelected";
+    analyticsActions["facetDeselected"] = "facetDeselected";
+    analyticsActions["facetNegativeSelected"] = "facetNegativeSelected";
+    analyticsActions["facetNegativeDeselected"] = "facetNegativeDeselected";
+    analyticsActions["mobileFacetsToggled"] = "mobileFacetsToggled";
+    analyticsActions["partOfCollectionClicked"] = "partOfCollectionClicked";
+    analyticsActions["histogramChanged"] = "histogramChanged";
+    analyticsActions["histogramChangedFromModal"] = "histogramChangedFromModal";
+    analyticsActions["histogramExpanded"] = "histogramExpanded";
+    analyticsActions["resultSelected"] = "resultSelected";
+    analyticsActions["moreFacetsPageChange"] = "moreFacetsPageChange";
+    analyticsActions["showMoreFacetsModal"] = "showMoreFacetsModal";
+    analyticsActions["closeMoreFacetsModal"] = "closeMoreFacetsModal";
+    analyticsActions["applyMoreFacetsModal"] = "applyMoreFacetsModal";
+})(analyticsActions || (analyticsActions = {}));
 //# sourceMappingURL=analytics-events.js.map

package/dist/src/utils/array-equals.d.ts

@@ -1,4 +1,4 @@
-/**
- * Determines whether two arrays have the same (shallow) contents in the same order
- */
-export declare function arrayEquals(arr1: unknown[], arr2: unknown[]): boolean;
+/**
+ * Determines whether two arrays have the same (shallow) contents in the same order
+ */
+export declare function arrayEquals(arr1: unknown[], arr2: unknown[]): boolean;

package/dist/src/utils/array-equals.js

@@ -1,11 +1,11 @@
-/**
- * Determines whether two arrays have the same (shallow) contents in the same order
- */
-export function arrayEquals(arr1, arr2) {
-    if (arr1 === arr2)
-        return true;
-    if (arr1.length !== arr2.length)
-        return false;
-    return arr1.every((val, i) => val === arr2[i]);
-}
+/**
+ * Determines whether two arrays have the same (shallow) contents in the same order
+ */
+export function arrayEquals(arr1, arr2) {
+    if (arr1 === arr2)
+        return true;
+    if (arr1.length !== arr2.length)
+        return false;
+    return arr1.every((val, i) => val === arr2[i]);
+}
 //# sourceMappingURL=array-equals.js.map

package/dist/src/utils/collapse-repeated-quotes.d.ts

@@ -1,11 +1,11 @@
-/**
- * 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.
- */
-export declare function collapseRepeatedQuotes(str?: string): string | undefined;
+/**
+ * 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.
+ */
+export declare function collapseRepeatedQuotes(str?: string): string | undefined;

package/dist/src/utils/collapse-repeated-quotes.js

@@ -1,14 +1,14 @@
-/**
- * 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.
- */
-export function collapseRepeatedQuotes(str) {
-    return str === null || str === void 0 ? void 0 : str.replace(/%22%22(?!%22%22)(.+?)%22%22/g, '%22$1%22');
-}
+/**
+ * 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.
+ */
+export function collapseRepeatedQuotes(str) {
+    return str === null || str === void 0 ? void 0 : str.replace(/%22%22(?!%22%22)(.+?)%22%22/g, '%22$1%22');
+}
 //# sourceMappingURL=collapse-repeated-quotes.js.map

package/dist/src/utils/format-count.d.ts

@@ -1,7 +1,7 @@
-export declare type NumberFormat = 'short' | 'long';
-export declare type LabelFormat = 'short' | 'long';
-/**
- * Format a "count" number into short "icon" or longer text string.
- * For positive numbers only.
- */
-export declare function formatCount(count: number | undefined, numberFormat?: NumberFormat, labelFormat?: LabelFormat, locale?: string): string;
+export declare type NumberFormat = 'short' | 'long';
+export declare type LabelFormat = 'short' | 'long';
+/**
+ * Format a "count" number into short "icon" or longer text string.
+ * For positive numbers only.
+ */
+export declare function formatCount(count: number | undefined, numberFormat?: NumberFormat, labelFormat?: LabelFormat, locale?: string): string;

package/dist/src/utils/format-count.js

@@ -1,77 +1,77 @@
-/*
- * Replaces Petabox www/common/Util::number_format()
- * For positive numbers only.
- */
-import { msg, str } from '@lit/localize';
-/**
- * Return the magnitude of a number.
- */
-function magnitude(number, numberFormat) {
-    let divisor = 1;
-    if (number >= 1000000000) {
-        divisor = 1000000000;
-    }
-    else if (number >= 1000000) {
-        divisor = 1000000;
-    }
-    else if (number >= 1000 && numberFormat === 'short') {
-        divisor = 1000;
-    }
-    return divisor;
-}
-/**
- * Round a number given passed magnitude.
- * Significant digits of value less than 10 get a decimal.
- */
-// eslint-disable-next-line default-param-last
-function round(number = 0, divisor) {
-    const result = number / divisor;
-    const roundToOne = result < 10;
-    let rounded = 0;
-    if (roundToOne) {
-        rounded = Math.round((result + Number.EPSILON) * 10) / 10;
-    }
-    else {
-        rounded = Math.round(result);
-    }
-    return rounded;
-}
-/**
- * Return a label for a number and format.
- */
-function labelize(rounded, divisor, format, locale) {
-    switch (divisor) {
-        case 1000000000:
-            if (format === 'short') {
-                return msg(str `${rounded}B`);
-            }
-            return msg(str `${rounded} billion`);
-        case 1000000:
-            if (format === 'short') {
-                return msg(str `${rounded}M`);
-            }
-            return msg(str `${rounded} million`);
-        case 1000:
-            if (format === 'short') {
-                return msg(str `${rounded}K`);
-            }
-            return msg(str `${rounded} thousand`);
-        default:
-            return new Intl.NumberFormat(locale).format(rounded);
-    }
-}
-/**
- * Format a "count" number into short "icon" or longer text string.
- * For positive numbers only.
- */
-export function formatCount(count, numberFormat = 'long', labelFormat = 'short', locale = 'en-US') {
-    // Return blank if undefined
-    const number = count !== null && count !== void 0 ? count : -1;
-    if (number < 0) {
-        return '';
-    }
-    const divisor = magnitude(number, numberFormat);
-    const rounded = round(number, divisor);
-    return labelize(rounded, divisor, labelFormat, locale);
-}
+/*
+ * Replaces Petabox www/common/Util::number_format()
+ * For positive numbers only.
+ */
+import { msg, str } from '@lit/localize';
+/**
+ * Return the magnitude of a number.
+ */
+function magnitude(number, numberFormat) {
+    let divisor = 1;
+    if (number >= 1000000000) {
+        divisor = 1000000000;
+    }
+    else if (number >= 1000000) {
+        divisor = 1000000;
+    }
+    else if (number >= 1000 && numberFormat === 'short') {
+        divisor = 1000;
+    }
+    return divisor;
+}
+/**
+ * Round a number given passed magnitude.
+ * Significant digits of value less than 10 get a decimal.
+ */
+// eslint-disable-next-line default-param-last
+function round(number = 0, divisor) {
+    const result = number / divisor;
+    const roundToOne = result < 10;
+    let rounded = 0;
+    if (roundToOne) {
+        rounded = Math.round((result + Number.EPSILON) * 10) / 10;
+    }
+    else {
+        rounded = Math.round(result);
+    }
+    return rounded;
+}
+/**
+ * Return a label for a number and format.
+ */
+function labelize(rounded, divisor, format, locale) {
+    switch (divisor) {
+        case 1000000000:
+            if (format === 'short') {
+                return msg(str `${rounded}B`);
+            }
+            return msg(str `${rounded} billion`);
+        case 1000000:
+            if (format === 'short') {
+                return msg(str `${rounded}M`);
+            }
+            return msg(str `${rounded} million`);
+        case 1000:
+            if (format === 'short') {
+                return msg(str `${rounded}K`);
+            }
+            return msg(str `${rounded} thousand`);
+        default:
+            return new Intl.NumberFormat(locale).format(rounded);
+    }
+}
+/**
+ * Format a "count" number into short "icon" or longer text string.
+ * For positive numbers only.
+ */
+export function formatCount(count, numberFormat = 'long', labelFormat = 'short', locale = 'en-US') {
+    // Return blank if undefined
+    const number = count !== null && count !== void 0 ? count : -1;
+    if (number < 0) {
+        return '';
+    }
+    const divisor = magnitude(number, numberFormat);
+    const rounded = round(number, divisor);
+    return labelize(rounded, divisor, labelFormat, locale);
+}
 //# sourceMappingURL=format-count.js.map

package/dist/src/utils/format-date.d.ts

@@ -1,2 +1,2 @@
-export declare type DateFormat = 'year-only' | 'short' | 'long';
-export declare function formatDate(date: Date | undefined, format?: DateFormat, locale?: string): string;
+export declare type DateFormat = 'year-only' | 'short' | 'long';
+export declare function formatDate(date: Date | undefined, format?: DateFormat, locale?: string): string;

package/dist/src/utils/format-date.js

@@ -1,26 +1,26 @@
-export function formatDate(date, format = 'short', locale = 'en-US') {
-    // Return blank if undefined
-    if (!date)
-        return '';
-    // the date is already in UTC timezone so we should not add timeZone here again.
-    const options = {};
-    switch (format) {
-        case 'year-only':
-            options.year = 'numeric';
-            break;
-        case 'short':
-            options.month = 'short';
-            options.year = 'numeric';
-            break;
-        case 'long':
-            options.year = 'numeric';
-            options.month = 'short';
-            options.day = '2-digit';
-            break;
-        default:
-            break;
-    }
-    const dateFormatter = new Intl.DateTimeFormat(locale, options);
-    return dateFormatter.format(date);
-}
+export function formatDate(date, format = 'short', locale = 'en-US') {
+    // Return blank if undefined
+    if (!date)
+        return '';
+    // the date is already in UTC timezone so we should not add timeZone here again.
+    const options = {};
+    switch (format) {
+        case 'year-only':
+            options.year = 'numeric';
+            break;
+        case 'short':
+            options.month = 'short';
+            options.year = 'numeric';
+            break;
+        case 'long':
+            options.year = 'numeric';
+            options.month = 'short';
+            options.day = '2-digit';
+            break;
+        default:
+            break;
+    }
+    const dateFormatter = new Intl.DateTimeFormat(locale, options);
+    return dateFormatter.format(date);
+}
 //# sourceMappingURL=format-date.js.map

package/dist/src/utils/format-unit-size.d.ts

@@ -1,2 +1,2 @@
-import { nothing } from 'lit';
-export declare function formatUnitSize(size: number | undefined, nDecimals: number, separator?: string): string | typeof nothing;
+import { nothing } from 'lit';
+export declare function formatUnitSize(size: number | undefined, nDecimals: number, separator?: string): string | typeof nothing;