lighthouse 9.5.0-dev.20230118 → 9.5.0-dev.20230120

package/report/renderer/features-util.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license Copyright 2021 The Lighthouse Authors. All Rights Reserved.
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+ */
+/** @typedef {import('./dom.js').DOM} DOM */
+/**
+ * @param {DOM} dom
+ * @param {boolean} [force]
+ */
+export function toggleDarkTheme(dom: DOM, force?: boolean | undefined): void;
+export type DOM = import('./dom.js').DOM;
+//# sourceMappingURL=features-util.d.ts.map

package/report/renderer/i18n.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @template T
+ */
+export class I18n<T> {
+    /**
+     * @param {LH.Locale} locale
+     * @param {T} strings
+     */
+    constructor(locale: LH.Locale, strings: T);
+    _locale: "en-US" | "en" | "en-AU" | "en-GB" | "en-IE" | "en-SG" | "en-ZA" | "en-IN" | "ar-XB" | "ar" | "bg" | "ca" | "cs" | "da" | "de" | "el" | "en-XL" | "es" | "es-419" | "es-AR" | "es-BO" | "es-BR" | "es-BZ" | "es-CL" | "es-CO" | "es-CR" | "es-CU" | "es-DO" | "es-EC" | "es-GT" | "es-HN" | "es-MX" | "es-NI" | "es-PA" | "es-PE" | "es-PR" | "es-PY" | "es-SV" | "es-US" | "es-UY" | "es-VE" | "fi" | "fil" | "fr" | "he" | "hi" | "hr" | "hu" | "gsw" | "id" | "in" | "it" | "iw" | "ja" | "ko" | "lt" | "lv" | "mo" | "nl" | "nb" | "no" | "pl" | "pt" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sr-Latn" | "sv" | "ta" | "te" | "th" | "tl" | "tr" | "uk" | "vi" | "zh" | "zh-HK" | "zh-TW";
+    _strings: T;
+    _cachedNumberFormatters: Map<any, any>;
+    get strings(): T;
+    /**
+     * @param {number} number
+     * @param {number|undefined} granularity
+     * @param {Intl.NumberFormatOptions=} opts
+     * @return {string}
+     */
+    _formatNumberWithGranularity(number: number, granularity: number | undefined, opts?: Intl.NumberFormatOptions | undefined): string;
+    /**
+     * Format number.
+     * @param {number} number
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed as described
+     *                              by the Intl defaults: tinyurl.com/7s67w5x7
+     * @return {string}
+     */
+    formatNumber(number: number, granularity?: number | undefined): string;
+    /**
+     * Format integer.
+     * Just like {@link formatNumber} but uses a granularity of 1, rounding to the nearest
+     * whole number.
+     * @param {number} number
+     * @return {string}
+     */
+    formatInteger(number: number): string;
+    /**
+     * Format percent.
+     * @param {number} number 0–1
+     * @return {string}
+     */
+    formatPercent(number: number): string;
+    /**
+     * @param {number} size
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatBytesToKiB(size: number, granularity?: number | undefined): string;
+    /**
+     * @param {number} size
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatBytesToMiB(size: number, granularity?: number | undefined): string;
+    /**
+     * @param {number} size
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatBytes(size: number, granularity?: number | undefined): string;
+    /**
+     * @param {number} size
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatBytesWithBestUnit(size: number, granularity?: number | undefined): string;
+    /**
+     * @param {number} size
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatKbps(size: number, granularity?: number | undefined): string;
+    /**
+     * @param {number} ms
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatMilliseconds(ms: number, granularity?: number | undefined): string;
+    /**
+     * @param {number} ms
+     * @param {number=} granularity Controls how coarse the displayed value is.
+     *                              If undefined, the number will be displayed in full.
+     * @return {string}
+     */
+    formatSeconds(ms: number, granularity?: number | undefined): string;
+    /**
+     * Format time.
+     * @param {string} date
+     * @return {string}
+     */
+    formatDateTime(date: string): string;
+    /**
+     * Converts a time in milliseconds into a duration string, i.e. `1d 2h 13m 52s`
+     * @param {number} timeInMilliseconds
+     * @return {string}
+     */
+    formatDuration(timeInMilliseconds: number): string;
+}
+//# sourceMappingURL=i18n.d.ts.map

package/report/renderer/logger.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2017 The Lighthouse Authors. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS-IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Logs messages via a UI butter.
+ */
+export class Logger {
+    /**
+     * @param {HTMLElement} element - expected to have id #lh-log
+     */
+    constructor(element: HTMLElement);
+    el: HTMLElement;
+    _id: number | undefined;
+    /**
+     * Shows a butter bar.
+     * @param {string} msg The message to show.
+     * @param {boolean=} autoHide True to hide the message after a duration.
+     *     Default is true.
+     */
+    log(msg: string, autoHide?: boolean | undefined): void;
+    /**
+     * @param {string} msg
+     */
+    warn(msg: string): void;
+    /**
+     * @param {string} msg
+     */
+    error(msg: string): void;
+    /**
+     * Explicitly hides the butter bar.
+     */
+    hide(): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/report/renderer/open-tab.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Opens a new tab to the online viewer and sends the local page's JSON results
+ * to the online viewer using URL.fragment
+ * @param {LH.Result} lhr
+ * @protected
+ */
+export function openViewer(lhr: LH.Result): Promise<void>;
+/**
+ * Same as openViewer, but uses postMessage.
+ * @param {LH.Result} lhr
+ * @protected
+ */
+export function openViewerAndSendData(lhr: LH.Result): Promise<void>;
+/**
+ * Opens a new tab to the treemap app and sends the JSON results using URL.fragment
+ * @param {LH.Result} json
+ */
+export function openTreemap(json: LH.Result): void;
+//# sourceMappingURL=open-tab.d.ts.map

package/report/renderer/performance-category-renderer.d.ts

@@ -0,0 +1,56 @@
+export class PerformanceCategoryRenderer extends CategoryRenderer {
+    /**
+     * @param {LH.ReportResult.AuditRef} audit
+     * @return {!Element}
+     */
+    _renderMetric(audit: LH.ReportResult.AuditRef): Element;
+    /**
+     * @param {LH.ReportResult.AuditRef} audit
+     * @param {number} scale
+     * @return {!Element}
+     */
+    _renderOpportunity(audit: LH.ReportResult.AuditRef, scale: number): Element;
+    /**
+     * Get an audit's wastedMs to sort the opportunity by, and scale the sparkline width
+     * Opportunities with an error won't have a details object, so MIN_VALUE is returned to keep any
+     * erroring opportunities last in sort order.
+     * @param {LH.ReportResult.AuditRef} audit
+     * @return {number}
+     */
+    _getWastedMs(audit: LH.ReportResult.AuditRef): number;
+    /**
+     * Get a link to the interactive scoring calculator with the metric values.
+     * @param {LH.ReportResult.AuditRef[]} auditRefs
+     * @return {string}
+     */
+    _getScoringCalculatorHref(auditRefs: LH.ReportResult.AuditRef[]): string;
+    /**
+     * For performance, audits with no group should be a diagnostic or opportunity.
+     * The audit details type will determine which of the two groups an audit is in.
+     *
+     * @param {LH.ReportResult.AuditRef} audit
+     * @return {'load-opportunity'|'diagnostic'|null}
+     */
+    _classifyPerformanceAudit(audit: LH.ReportResult.AuditRef): 'load-opportunity' | 'diagnostic' | null;
+    /**
+     * @param {LH.ReportResult.Category} category
+     * @param {Object<string, LH.Result.ReportGroup>} groups
+     * @param {{gatherMode: LH.Result.GatherMode}=} options
+     * @return {Element}
+     * @override
+     */
+    override render(category: LH.ReportResult.Category, groups: {
+        [x: string]: LH.Result.ReportGroup;
+    }, options?: {
+        gatherMode: LH.Result.GatherMode;
+    } | undefined): Element;
+    /**
+     * Render the control to filter the audits by metric. The filtering is done at runtime by CSS only
+     * @param {LH.ReportResult.AuditRef[]} filterableMetrics
+     * @param {HTMLDivElement} categoryEl
+     */
+    renderMetricAuditFilter(filterableMetrics: LH.ReportResult.AuditRef[], categoryEl: HTMLDivElement): void;
+}
+export type DOM = import('./dom.js').DOM;
+import { CategoryRenderer } from "./category-renderer.js";
+//# sourceMappingURL=performance-category-renderer.d.ts.map

package/report/renderer/pwa-category-renderer.d.ts

@@ -0,0 +1,55 @@
+export class PwaCategoryRenderer extends CategoryRenderer {
+    /**
+     * Alters SVG id references so multiple instances of an SVG element can coexist
+     * in a single page. If `svgRoot` has a `<defs>` block, gives all elements defined
+     * in it unique ids, then updates id references (`<use xlink:href="...">`,
+     * `fill="url(#...)"`) to the altered ids in all descendents of `svgRoot`.
+     * @param {SVGElement} svgRoot
+     */
+    static _makeSvgReferencesUnique(svgRoot: SVGElement): void;
+    /**
+     * @param {LH.ReportResult.Category} category
+     * @param {Object<string, LH.Result.ReportGroup>} [groupDefinitions]
+     * @return {Element}
+     */
+    render(category: LH.ReportResult.Category, groupDefinitions?: {
+        [x: string]: import("../../types/lhr/lhr.js").default.ReportGroup;
+    } | undefined): Element;
+    /**
+     * @param {LH.ReportResult.Category} category
+     * @param {Record<string, LH.Result.ReportGroup>} groupDefinitions
+     * @return {DocumentFragment}
+     */
+    renderCategoryScore(category: LH.ReportResult.Category, groupDefinitions: Record<string, LH.Result.ReportGroup>): DocumentFragment;
+    /**
+     * Returns the group IDs found in auditRefs.
+     * @param {Array<LH.ReportResult.AuditRef>} auditRefs
+     * @return {!Set<string>}
+     */
+    _getGroupIds(auditRefs: Array<LH.ReportResult.AuditRef>): Set<string>;
+    /**
+     * Returns the group IDs whose audits are all considered passing.
+     * @param {Array<LH.ReportResult.AuditRef>} auditRefs
+     * @return {Set<string>}
+     */
+    _getPassingGroupIds(auditRefs: Array<LH.ReportResult.AuditRef>): Set<string>;
+    /**
+     * Returns a tooltip string summarizing group pass rates.
+     * @param {Array<LH.ReportResult.AuditRef>} auditRefs
+     * @param {Record<string, LH.Result.ReportGroup>} groupDefinitions
+     * @return {string}
+     */
+    _getGaugeTooltip(auditRefs: Array<LH.ReportResult.AuditRef>, groupDefinitions: Record<string, LH.Result.ReportGroup>): string;
+    /**
+     * Render non-manual audits in groups, giving a badge to any group that has
+     * all passing audits.
+     * @param {Array<LH.ReportResult.AuditRef>} auditRefs
+     * @param {Object<string, LH.Result.ReportGroup>} groupDefinitions
+     * @return {Element}
+     */
+    _renderAudits(auditRefs: Array<LH.ReportResult.AuditRef>, groupDefinitions: {
+        [x: string]: LH.Result.ReportGroup;
+    }): Element;
+}
+import { CategoryRenderer } from "./category-renderer.js";
+//# sourceMappingURL=pwa-category-renderer.d.ts.map

package/report/renderer/report-renderer.d.ts

@@ -0,0 +1,57 @@
+export class ReportRenderer {
+    /**
+     * @param {DOM} dom
+     */
+    constructor(dom: DOM);
+    /** @type {DOM} */
+    _dom: DOM;
+    /** @type {LH.Renderer.Options} */
+    _opts: LH.Renderer.Options;
+    /**
+     * @param {LH.Result} lhr
+     * @param {HTMLElement?} rootEl Report root element containing the report
+     * @param {LH.Renderer.Options=} opts
+     * @return {!Element}
+     */
+    renderReport(lhr: LH.Result, rootEl: HTMLElement | null, opts?: LH.Renderer.Options | undefined): Element;
+    /**
+     * @param {LH.ReportResult} report
+     * @return {DocumentFragment}
+     */
+    _renderReportTopbar(report: LH.ReportResult): DocumentFragment;
+    /**
+     * @return {DocumentFragment}
+     */
+    _renderReportHeader(): DocumentFragment;
+    /**
+     * @param {LH.ReportResult} report
+     * @return {DocumentFragment}
+     */
+    _renderReportFooter(report: LH.ReportResult): DocumentFragment;
+    /**
+     * @param {LH.ReportResult} report
+     * @param {DocumentFragment} footer
+     */
+    _renderMetaBlock(report: LH.ReportResult, footer: DocumentFragment): void;
+    /**
+     * Returns a div with a list of top-level warnings, or an empty div if no warnings.
+     * @param {LH.ReportResult} report
+     * @return {Node}
+     */
+    _renderReportWarnings(report: LH.ReportResult): Node;
+    /**
+     * @param {LH.ReportResult} report
+     * @param {CategoryRenderer} categoryRenderer
+     * @param {Record<string, CategoryRenderer>} specificCategoryRenderers
+     * @return {!DocumentFragment[]}
+     */
+    _renderScoreGauges(report: LH.ReportResult, categoryRenderer: CategoryRenderer, specificCategoryRenderers: Record<string, CategoryRenderer>): DocumentFragment[];
+    /**
+     * @param {LH.ReportResult} report
+     * @return {!DocumentFragment}
+     */
+    _renderReport(report: LH.ReportResult): DocumentFragment;
+}
+export type DOM = import('./dom.js').DOM;
+import { CategoryRenderer } from "./category-renderer.js";
+//# sourceMappingURL=report-renderer.d.ts.map

package/report/renderer/report-ui-features.d.ts

@@ -0,0 +1,71 @@
+export class ReportUIFeatures {
+    /**
+     * @param {DOM} dom
+     * @param {LH.Renderer.Options} opts
+     */
+    constructor(dom: DOM, opts?: LH.Renderer.Options);
+    /** @type {LH.Result} */
+    json: LH.Result;
+    /** @type {DOM} */
+    _dom: DOM;
+    _opts: import("../types/report-renderer.js").default.Options;
+    _topbar: TopbarFeatures | null;
+    /**
+     * Handle media query change events.
+     * @param {MediaQueryList|MediaQueryListEvent} mql
+     */
+    onMediaQueryChange(mql: MediaQueryList | MediaQueryListEvent): void;
+    /**
+     * Adds tools button, print, and other functionality to the report. The method
+     * should be called whenever the report needs to be re-rendered.
+     * @param {LH.Result} lhr
+     */
+    initFeatures(lhr: LH.Result): void;
+    _fullPageScreenshot: import("../../types/lhr/lhr.js").default.FullPageScreenshot | undefined;
+    /**
+     * @param {{text: string, icon?: string, onClick: () => void}} opts
+     */
+    addButton(opts: {
+        text: string;
+        icon?: string;
+        onClick: () => void;
+    }): HTMLButtonElement | undefined;
+    resetUIState(): void;
+    /**
+     * Returns the html that recreates this report.
+     * @return {string}
+     */
+    getReportHtml(): string;
+    /**
+     * Save json as a gist. Unimplemented in base UI features.
+     */
+    saveAsGist(): void;
+    _enableFireworks(): void;
+    _setupMediaQueryListeners(): void;
+    /**
+     * Resets the state of page before capturing the page for export.
+     * When the user opens the exported HTML page, certain UI elements should
+     * be in their closed state (not opened) and the templates should be unstamped.
+     */
+    _resetUIState(): void;
+    _setupThirdPartyFilter(): void;
+    /**
+     * @param {Element} rootEl
+     */
+    _setupElementScreenshotOverlay(rootEl: Element): void;
+    /**
+     * From a table with URL entries, finds the rows containing third-party URLs
+     * and returns them.
+     * @param {HTMLElement[]} rowEls
+     * @param {string} finalDisplayedUrl
+     * @return {Array<HTMLElement>}
+     */
+    _getThirdPartyRows(rowEls: HTMLElement[], finalDisplayedUrl: string): Array<HTMLElement>;
+    /**
+     * @param {Blob|File} blob
+     */
+    _saveFile(blob: Blob | File): void;
+}
+export type DOM = import('./dom').DOM;
+import { TopbarFeatures } from "./topbar-features.js";
+//# sourceMappingURL=report-ui-features.d.ts.map

package/report/renderer/snippet-renderer.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Render snippet of text with line numbers and annotations.
+ * By default we only show a few lines around each annotation and the user
+ * can click "Expand snippet" to show more.
+ * Content lines with annotations are highlighted.
+ */
+export class SnippetRenderer {
+    /**
+     * @param {DOM} dom
+     * @param {LH.Audit.Details.SnippetValue} details
+     * @param {DetailsRenderer} detailsRenderer
+     * @param {function} toggleExpandedFn
+     * @return {DocumentFragment}
+     */
+    static renderHeader(dom: DOM, details: LH.Audit.Details.SnippetValue, detailsRenderer: DetailsRenderer, toggleExpandedFn: Function): DocumentFragment;
+    /**
+     * Renders a line (text content, message, or placeholder) as a DOM element.
+     * @param {DOM} dom
+     * @param {DocumentFragment} tmpl
+     * @param {LineDetails} lineDetails
+     * @return {Element}
+     */
+    static renderSnippetLine(dom: DOM, tmpl: DocumentFragment, { content, lineNumber, truncated, contentType, visibility }: LineDetails): Element;
+    /**
+     * @param {DOM} dom
+     * @param {DocumentFragment} tmpl
+     * @param {{message: string}} message
+     * @return {Element}
+     */
+    static renderMessage(dom: DOM, tmpl: DocumentFragment, message: {
+        message: string;
+    }): Element;
+    /**
+     * @param {DOM} dom
+     * @param {DocumentFragment} tmpl
+     * @param {LineVisibility} visibility
+     * @return {Element}
+     */
+    static renderOmittedLinesPlaceholder(dom: DOM, tmpl: DocumentFragment, visibility: LineVisibility): Element;
+    /**
+     * @param {DOM} dom
+     * @param {DocumentFragment} tmpl
+     * @param {LH.Audit.Details.SnippetValue} details
+     * @return {DocumentFragment}
+     */
+    static renderSnippetContent(dom: DOM, tmpl: DocumentFragment, details: LH.Audit.Details.SnippetValue): DocumentFragment;
+    /**
+     * @param {DOM} dom
+     * @param {DocumentFragment} tmpl
+     * @param {LH.Audit.Details.SnippetValue} details
+     * @return {DocumentFragment}
+     */
+    static renderSnippetLines(dom: DOM, tmpl: DocumentFragment, details: LH.Audit.Details.SnippetValue): DocumentFragment;
+    /**
+     * @param {DOM} dom
+     * @param {LH.Audit.Details.SnippetValue} details
+     * @param {DetailsRenderer} detailsRenderer
+     * @return {!Element}
+     */
+    static render(dom: DOM, details: LH.Audit.Details.SnippetValue, detailsRenderer: DetailsRenderer): Element;
+}
+export type DetailsRenderer = import('./details-renderer').DetailsRenderer;
+export type DOM = import('./dom').DOM;
+export type LineDetails = {
+    content: string;
+    lineNumber: string | number;
+    contentType: LineContentType;
+    truncated?: boolean;
+    visibility?: LineVisibility;
+};
+type LineVisibility = number;
+declare namespace LineVisibility {
+    const ALWAYS: number;
+    const WHEN_COLLAPSED: number;
+    const WHEN_EXPANDED: number;
+}
+type LineContentType = number;
+declare namespace LineContentType {
+    const CONTENT_NORMAL: number;
+    const CONTENT_HIGHLIGHTED: number;
+    const PLACEHOLDER: number;
+    const MESSAGE: number;
+}
+export {};
+//# sourceMappingURL=snippet-renderer.d.ts.map

package/report/renderer/swap-locale-feature.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license Copyright 2021 The Lighthouse Authors. All Rights Reserved.
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+ */
+/**
+ * @fileoverview Creates a <select> element, filled with all supported locales
+ */
+/** @typedef {import('./dom.js').DOM} DOM */
+/** @typedef {import('./report-ui-features').ReportUIFeatures} ReportUIFeatures */
+export class SwapLocaleFeature {
+    /**
+     * @param {ReportUIFeatures} reportUIFeatures
+     * @param {DOM} dom
+     * @param {{onLocaleSelected: (localeModuleName: LH.Locale) => Promise<void>}} callbacks
+     *        Specifiy the URL where the i18n module script can be found, and the URLS for the locale JSON files.
+     */
+    constructor(reportUIFeatures: ReportUIFeatures, dom: DOM, callbacks: {
+        onLocaleSelected: (localeModuleName: LH.Locale) => Promise<void>;
+    });
+    _reportUIFeatures: import("./report-ui-features").ReportUIFeatures;
+    _dom: import("./dom.js").DOM;
+    _localeSelectedCallback: (localeModuleName: LH.Locale) => Promise<void>;
+    /**
+     * @param {Array<LH.Locale>} locales
+     */
+    enable(locales: Array<LH.Locale>): void;
+}
+export type DOM = import('./dom.js').DOM;
+export type ReportUIFeatures = import('./report-ui-features').ReportUIFeatures;
+//# sourceMappingURL=swap-locale-feature.d.ts.map

package/report/renderer/text-encoding.d.ts

@@ -0,0 +1,26 @@
+export namespace TextEncoding {
+    export { toBase64 };
+    export { fromBase64 };
+}
+/**
+ * Takes an UTF-8 string and returns a base64 encoded string.
+ * If gzip is true, the UTF-8 bytes are gzipped before base64'd, using
+ * CompressionStream (currently only in Chrome), falling back to pako
+ * (which is only used to encode in our Node tests).
+ * @param {string} string
+ * @param {{gzip: boolean}} options
+ * @return {Promise<string>}
+ */
+declare function toBase64(string: string, options: {
+    gzip: boolean;
+}): Promise<string>;
+/**
+ * @param {string} encoded
+ * @param {{gzip: boolean}} options
+ * @return {string}
+ */
+declare function fromBase64(encoded: string, options: {
+    gzip: boolean;
+}): string;
+export {};
+//# sourceMappingURL=text-encoding.d.ts.map

package/report/renderer/topbar-features.d.ts

@@ -0,0 +1,82 @@
+export class TopbarFeatures {
+    /**
+     * @param {ReportUIFeatures} reportUIFeatures
+     * @param {DOM} dom
+     */
+    constructor(reportUIFeatures: ReportUIFeatures, dom: DOM);
+    /** @type {LH.Result} */
+    lhr: LH.Result;
+    _reportUIFeatures: import("./report-ui-features").ReportUIFeatures;
+    _dom: import("./dom.js").DOM;
+    _dropDownMenu: DropDownMenu;
+    _copyAttempt: boolean;
+    /** @type {HTMLElement} */
+    topbarEl: HTMLElement;
+    /** @type {HTMLElement} */
+    categoriesEl: HTMLElement;
+    /** @type {HTMLElement?} */
+    stickyHeaderEl: HTMLElement | null;
+    /** @type {HTMLElement} */
+    highlightEl: HTMLElement;
+    /**
+     * Handler for tool button.
+     * @param {Event} e
+     */
+    onDropDownMenuClick(e: Event): void;
+    /**
+     * Keyup handler for the document.
+     * @param {KeyboardEvent} e
+     */
+    onKeyUp(e: KeyboardEvent): void;
+    /**
+     * Handle copy events.
+     * @param {ClipboardEvent} e
+     */
+    onCopy(e: ClipboardEvent): void;
+    /**
+     * Collapses all audit `<details>`.
+     * open a `<details>` element.
+     */
+    collapseAllDetails(): void;
+    /**
+     * @param {LH.Result} lhr
+     */
+    enable(lhr: LH.Result): void;
+    /**
+     * Copies the report JSON to the clipboard (if supported by the browser).
+     */
+    onCopyButtonClick(): void;
+    /**
+     * Expands all audit `<details>`.
+     * Ideally, a print stylesheet could take care of this, but CSS has no way to
+     * open a `<details>` element.
+     */
+    expandAllDetails(): void;
+    _print(): void;
+    /**
+     * Resets the state of page before capturing the page for export.
+     * When the user opens the exported HTML page, certain UI elements should
+     * be in their closed state (not opened) and the templates should be unstamped.
+     */
+    resetUIState(): void;
+    /**
+     * Finds the first scrollable ancestor of `element`. Falls back to the document.
+     * @param {Element} element
+     * @return {Element | Document}
+     */
+    _getScrollParent(element: Element): Element | Document;
+    /**
+     * Sets up listeners to collapse audit `<details>` when the user closes the
+     * print dialog, all `<details>` are collapsed.
+     */
+    _setUpCollapseDetailsAfterPrinting(): void;
+    _setupStickyHeader(): void;
+    /**
+     * Toggle visibility and update highlighter position
+     */
+    _updateStickyHeader(): void;
+}
+export type DOM = import('./dom.js').DOM;
+export type ReportUIFeatures = import('./report-ui-features').ReportUIFeatures;
+import { DropDownMenu } from "./drop-down-menu.js";
+//# sourceMappingURL=topbar-features.d.ts.map