lighthouse 9.5.0-dev.20230118 → 9.5.0-dev.20230119

package/flow-report/src/i18n/ui-strings.d.ts

@@ -0,0 +1,48 @@
+export namespace UIStrings {
+    const navigationDescription: string;
+    const timespanDescription: string;
+    const snapshotDescription: string;
+    const navigationLongDescription: string;
+    const timespanLongDescription: string;
+    const snapshotLongDescription: string;
+    const navigationReport: string;
+    const timespanReport: string;
+    const snapshotReport: string;
+    const summary: string;
+    const allReports: string;
+    const title: string;
+    const categories: string;
+    const categoryPerformance: string;
+    const categoryAccessibility: string;
+    const categoryBestPractices: string;
+    const categorySeo: string;
+    const categoryProgressiveWebApp: string;
+    const desktop: string;
+    const mobile: string;
+    const ratingPass: string;
+    const ratingAverage: string;
+    const ratingFail: string;
+    const ratingError: string;
+    const navigationReportCount: string;
+    const timespanReportCount: string;
+    const snapshotReportCount: string;
+    const save: string;
+    const helpLabel: string;
+    const helpDialogTitle: string;
+    const helpUseCaseInstructionNavigation: string;
+    const helpUseCaseInstructionTimespan: string;
+    const helpUseCaseInstructionSnapshot: string;
+    const helpUseCaseNavigation1: string;
+    const helpUseCaseNavigation2: string;
+    const helpUseCaseNavigation3: string;
+    const helpUseCaseTimespan1: string;
+    const helpUseCaseTimespan2: string;
+    const helpUseCaseSnapshot1: string;
+    const helpUseCaseSnapshot2: string;
+    const passedAuditCount: string;
+    const passableAuditCount: string;
+    const informativeAuditCount: string;
+    const highestImpact: string;
+}
+export type UIStringsType = typeof UIStrings;
+//# sourceMappingURL=ui-strings.d.ts.map

package/flow-report/src/icons.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+declare const SummaryIcon: FunctionComponent;
+declare const NavigationIcon: FunctionComponent;
+declare const TimespanIcon: FunctionComponent;
+declare const SnapshotIcon: FunctionComponent;
+declare const CloseIcon: FunctionComponent;
+declare const EnvIcon: FunctionComponent;
+declare const NetworkIcon: FunctionComponent;
+declare const CpuIcon: FunctionComponent;
+declare const HamburgerIcon: FunctionComponent;
+declare const InfoIcon: FunctionComponent;
+export { SummaryIcon, NavigationIcon, TimespanIcon, SnapshotIcon, CloseIcon, EnvIcon, NetworkIcon, CpuIcon, HamburgerIcon, InfoIcon, };
+//# sourceMappingURL=icons.d.ts.map

package/flow-report/src/sidebar/flow.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+export declare const SidebarFlow: FunctionComponent;
+//# sourceMappingURL=flow.d.ts.map

package/flow-report/src/sidebar/sidebar.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+declare const SidebarSummary: FunctionComponent;
+declare const SidebarRuntimeSettings: FunctionComponent<{
+    settings: LH.ConfigSettings;
+}>;
+declare const SidebarHeader: FunctionComponent<{
+    title: string;
+    date: string;
+}>;
+declare const Sidebar: FunctionComponent;
+export { SidebarSummary, SidebarRuntimeSettings, SidebarHeader, Sidebar, };
+//# sourceMappingURL=sidebar.d.ts.map

package/flow-report/src/summary/category.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+declare const SummaryTooltip: FunctionComponent<{
+    category: LH.ReportResult.Category;
+    gatherMode: LH.Result.GatherMode;
+    url: string;
+}>;
+declare const SummaryCategory: FunctionComponent<{
+    category: LH.ReportResult.Category | undefined;
+    href: string;
+    gatherMode: LH.Result.GatherMode;
+    finalDisplayedUrl: string;
+}>;
+export { SummaryTooltip, SummaryCategory, };
+//# sourceMappingURL=category.d.ts.map

package/flow-report/src/summary/summary.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+/**
+ * The div should behave like a JSX <>...</>. This still allows us to identify "rows" with CSS selectors.
+ */
+declare const SummaryFlowStep: FunctionComponent<{
+    lhr: LH.Result;
+    label: string;
+    hashIndex: number;
+}>;
+declare const SummaryHeader: FunctionComponent;
+declare const Summary: FunctionComponent;
+export { SummaryFlowStep, SummaryHeader, Summary, };
+//# sourceMappingURL=summary.d.ts.map

package/flow-report/src/topbar.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @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.
+ */
+import { FunctionComponent, JSX } from 'preact';
+declare function saveHtml(flowResult: LH.FlowResult, htmlStr: string): void;
+declare namespace saveHtml {
+    var saveFile: typeof import("../../report/renderer/api").saveFile;
+}
+declare const Topbar: FunctionComponent<{
+    onMenuClick: JSX.MouseEventHandler<HTMLButtonElement>;
+}>;
+export { Topbar, saveHtml, };
+//# sourceMappingURL=topbar.d.ts.map

package/flow-report/src/util.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @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.
+ */
+import type { UIStringsType } from './i18n/ui-strings';
+declare const FlowResultContext: import("preact").Context<import("../../types/lhr/flow-result").default | undefined>;
+declare const OptionsContext: import("preact").Context<LH.FlowReportOptions>;
+declare function classNames(...args: Array<string | undefined | Record<string, boolean>>): string;
+declare function getScreenDimensions(reportResult: LH.Result): {
+    width: number;
+    height: number;
+};
+declare function getFilmstripFrames(reportResult: LH.Result): Array<{
+    data: string;
+}> | undefined;
+declare function getModeDescription(mode: LH.Result.GatherMode, strings: UIStringsType): string;
+declare function useFlowResult(): LH.FlowResult;
+declare function useHashParams(...params: string[]): (string | null)[];
+declare function useHashState(): LH.HashState | null;
+/**
+ * Creates a DOM subtree from non-preact code (e.g. LH report renderer).
+ * @param renderCallback Callback that renders a DOM subtree.
+ * @param inputs Changes to these values will trigger a re-render of the DOM subtree.
+ * @return Reference to the element that will contain the DOM subtree.
+ */
+declare function useExternalRenderer<T extends Element>(renderCallback: () => Node, inputs?: ReadonlyArray<unknown>): import("preact/hooks").Ref<T>;
+declare function useOptions(): LH.FlowReportOptions;
+export { FlowResultContext, OptionsContext, classNames, getScreenDimensions, getFilmstripFrames, getModeDescription, useFlowResult, useHashParams, useHashState, useExternalRenderer, useOptions, };
+//# sourceMappingURL=util.d.ts.map

package/flow-report/src/wrappers/category-score.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+export declare const CategoryScore: FunctionComponent<{
+    category: LH.ReportResult.Category;
+    href: string;
+    gatherMode: LH.Result.GatherMode;
+}>;
+//# sourceMappingURL=category-score.d.ts.map

package/flow-report/src/wrappers/markdown.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+export declare const Markdown: FunctionComponent<{
+    text: string;
+}>;
+//# sourceMappingURL=markdown.d.ts.map

package/flow-report/src/wrappers/report.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+export declare const Report: FunctionComponent<{
+    hashState: LH.HashState;
+}>;
+//# sourceMappingURL=report.d.ts.map

package/flow-report/src/wrappers/styles.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @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.
+ */
+import { FunctionComponent } from 'preact';
+export declare const Styles: FunctionComponent;
+//# sourceMappingURL=styles.d.ts.map

package/flow-report/test/app-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=app-test.d.ts.map

package/flow-report/test/common-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=common-test.d.ts.map

package/flow-report/test/flow-report-pptr-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=flow-report-pptr-test.d.ts.map

package/flow-report/test/header-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=header-test.d.ts.map

package/flow-report/test/sample-flow.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export declare const flowResult: LH.FlowResult;
+//# sourceMappingURL=sample-flow.d.ts.map

package/flow-report/test/setup/env-setup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @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.
+ */
+declare const rootHooks: {
+    beforeAll(): void;
+    beforeEach(): void;
+};
+export { rootHooks, };
+//# sourceMappingURL=env-setup.d.ts.map

package/flow-report/test/sidebar/flow-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=flow-test.d.ts.map

package/flow-report/test/sidebar/sidebar-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=sidebar-test.d.ts.map

package/flow-report/test/summary/category-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=category-test.d.ts.map

package/flow-report/test/summary/summary-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=summary-test.d.ts.map

package/flow-report/test/topbar-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=topbar-test.d.ts.map

package/flow-report/test/util-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=util-test.d.ts.map

package/flow-report/test/wrappers/category-score-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=category-score-test.d.ts.map

package/flow-report/test/wrappers/markdown-test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @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.
+ */
+export {};
+//# sourceMappingURL=markdown-test.d.ts.map

package/flow-report/tsconfig.json

@@ -19,7 +19,7 @@
     "**/*.ts",
     "**/*.tsx",
     "./types",
-    "../types/test.d.ts",
+    "../types/internal/test.d.ts",
     "../root.js",
     "../esm-utils.js",
     "../core/test/test-env/fake-timers.js",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lighthouse",
   "type": "module",
-  "version": "9.5.0-dev.20230118",
+  "version": "9.5.0-dev.20230119",
   "description": "Automated auditing, performance metrics, and best practices for the web.",
   "main": "./core/index.js",
   "bin": {
@@ -13,7 +13,8 @@
     "node": ">=16.16"
   },
   "scripts": {
-    "prepack": "yarn build-report --standalone --flow --esm",
+    "prepack": "yarn build-report --standalone --flow --esm && yarn build-types",
+    "postpack": "yarn clean-types",
     "build-all": "npm-run-posix-or-windows build-all:task",
     "build-all:task": "yarn build-report && yarn build-cdt-lib && yarn build-devtools && concurrently 'yarn build-extension' 'yarn build-lr' 'yarn build-viewer' 'yarn build-treemap' 'yarn build-smokehouse-bundle' && yarn build-pack",
     "build-all:task:windows": "yarn build-report && yarn build-cdt-lib && yarn build-extension && yarn build-devtools && yarn build-lr && yarn build-viewer && yarn build-treemap && yarn build-smokehouse-bundle",
@@ -29,9 +30,11 @@
     "build-sample-reports": "yarn build-report && node build/build-sample-reports.js",
     "build-treemap": "node ./build/build-treemap.js",
     "build-viewer": "node ./build/build-viewer.js",
+    "build-types": "yarn type-check && rsync -a .tmp/tsbuildinfo/ ./ --include='*.d.ts' --include='*.d.cts' --exclude='*.map' --exclude='*.tsbuildinfo'",
     "reset-link": "(yarn unlink || true) && yarn link && yarn link lighthouse",
     "c8": "bash core/scripts/c8.sh",
     "clean": "rm -r dist proto/scripts/*.json proto/scripts/*_pb2.* proto/scripts/*_pb.* proto/scripts/__pycache__ proto/scripts/*.pyc *.report.html *.report.dom.html *.report.json *.devtoolslog.json *.trace.json shared/localization/locales/*.ctc.json || true",
+    "clean-types": "git clean -xfq '*.d.ts' '*.d.cts' -e 'node_modules/' -e 'dist/' -e '.tmp/' -e '**/types/'",
     "lint": "[ \"$CI\" = true ] && eslint --quiet -f codeframe . || eslint .",
     "smoke": "node cli/test/smokehouse/frontends/smokehouse-bin.js",
     "debug": "node --inspect-brk ./cli/index.js",

package/report/clients/bundle.d.ts

@@ -0,0 +1,6 @@
+export { DOM } from "../renderer/dom.js";
+export { ReportRenderer } from "../renderer/report-renderer.js";
+export { ReportUIFeatures } from "../renderer/report-ui-features.js";
+export { renderReport } from "../renderer/api.js";
+export { swapLocale, format } from "../../shared/localization/i18n-module.js";
+//# sourceMappingURL=bundle.d.ts.map

package/report/clients/standalone.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=standalone.d.ts.map

package/report/generator/file-namer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Generate a filenamePrefix of hostname_YYYY-MM-DD_HH-MM-SS.
+ * @param {{finalDisplayedUrl: string, fetchTime: string}} lhr
+ * @return {string}
+ */
+export function getLhrFilenamePrefix(lhr: {
+    finalDisplayedUrl: string;
+    fetchTime: string;
+}): string;
+/**
+ * @fileoverview
+ * @suppress {reportUnknownTypes}
+ */
+/**
+ * Generate a filenamePrefix of name_YYYY-MM-DD_HH-MM-SS
+ * Date/time uses the local timezone, however Node has unreliable ICU
+ * support, so we must construct a YYYY-MM-DD date format manually. :/
+ * @param {string} name
+ * @param {string|undefined} fetchTime
+ */
+export function getFilenamePrefix(name: string, fetchTime: string | undefined): string;
+/**
+ * Generate a filenamePrefix of name_YYYY-MM-DD_HH-MM-SS.
+ * @param {{name: string, steps: Array<{lhr: {fetchTime: string}}>}} flowResult
+ * @return {string}
+ */
+export function getFlowResultFilenamePrefix(flowResult: {
+    name: string;
+    steps: {
+        lhr: {
+            fetchTime: string;
+        };
+    }[];
+}): string;
+//# sourceMappingURL=file-namer.d.ts.map

package/report/generator/flow-report-assets.d.ts

@@ -0,0 +1,9 @@
+export namespace flowReportAssets {
+    export { FLOW_REPORT_TEMPLATE };
+    export const FLOW_REPORT_CSS: string;
+    export { FLOW_REPORT_JAVASCRIPT };
+}
+declare const FLOW_REPORT_TEMPLATE: string;
+declare const FLOW_REPORT_JAVASCRIPT: string;
+export {};
+//# sourceMappingURL=flow-report-assets.d.ts.map

package/report/generator/report-assets.d.ts

@@ -0,0 +1,8 @@
+export const reportAssets: {
+    FLOW_REPORT_TEMPLATE: string;
+    FLOW_REPORT_CSS: string;
+    FLOW_REPORT_JAVASCRIPT: string;
+    REPORT_TEMPLATE: string;
+    REPORT_JAVASCRIPT: string;
+};
+//# sourceMappingURL=report-assets.d.ts.map

package/report/generator/report-generator.d.ts

@@ -0,0 +1,59 @@
+export type LHResult = import('../../types/lhr/lhr').default;
+export type FlowResult = import('../../types/lhr/flow-result').default;
+/** @typedef {import('../../types/lhr/lhr').default} LHResult */
+/** @typedef {import('../../types/lhr/flow-result').default} FlowResult */
+export class ReportGenerator {
+    /**
+     * Replaces all the specified strings in source without serial replacements.
+     * @param {string} source
+     * @param {!Array<{search: string, replacement: string}>} replacements
+     * @return {string}
+     */
+    static replaceStrings(source: string, replacements: Array<{
+        search: string;
+        replacement: string;
+    }>): string;
+    /**
+     * @param {unknown} object
+     * @return {string}
+     */
+    static sanitizeJson(object: unknown): string;
+    /**
+     * Returns the standalone report HTML as a string with the report JSON and renderer JS inlined.
+     * @param {LHResult} lhr
+     * @return {string}
+     */
+    static generateReportHtml(lhr: LHResult): string;
+    /**
+     * Returns the standalone flow report HTML as a string with the report JSON and renderer JS inlined.
+     * @param {FlowResult} flow
+     * @return {string}
+     */
+    static generateFlowReportHtml(flow: FlowResult): string;
+    /**
+     * Converts the results to a CSV formatted string
+     * Each row describes the result of 1 audit with
+     *  - the name of the category the audit belongs to
+     *  - the name of the audit
+     *  - a description of the audit
+     *  - the score type that is used for the audit
+     *  - the score value of the audit
+     *
+     * @param {LHResult} lhr
+     * @return {string}
+     */
+    static generateReportCSV(lhr: LHResult): string;
+    /**
+     * @param {LHResult|FlowResult} result
+     * @return {result is FlowResult}
+     */
+    static isFlowResult(result: LHResult | FlowResult): result is import("../../types/lhr/flow-result").default;
+    /**
+     * Creates the results output in a format based on the `mode`.
+     * @param {LHResult|FlowResult} result
+     * @param {LHResult['configSettings']['output']} outputModes
+     * @return {string|string[]}
+     */
+    static generateReport(result: LHResult | FlowResult, outputModes: LHResult['configSettings']['output']): string | string[];
+}
+//# sourceMappingURL=report-generator.d.ts.map

package/report/renderer/api.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @param {LH.Result} lhr
+ * @param {LH.Renderer.Options} opts
+ * @return {HTMLElement}
+ */
+export function renderReport(lhr: LH.Result, opts?: LH.Renderer.Options): HTMLElement;
+/**
+ * @param {LH.ReportResult.Category} category
+ * @param {Parameters<CategoryRenderer['renderCategoryScore']>[2]=} options
+ * @return {DocumentFragment}
+ */
+export function renderCategoryScore(category: LH.ReportResult.Category, options?: [category: import("../types/report-result.js").default.Category, groupDefinitions: Record<string, import("../../types/lhr/lhr.js").default.ReportGroup>, options?: {
+    gatherMode: import("../../types/lhr/lhr.js").default.GatherMode;
+    omitLabel?: boolean | undefined;
+    onPageAnchorRendered?: ((link: HTMLAnchorElement) => void) | undefined;
+} | undefined][2] | undefined): DocumentFragment;
+/**
+ * @param {Blob} blob
+ * @param {string} filename
+ */
+export function saveFile(blob: Blob, filename: string): void;
+/**
+ * @param {string} markdownText
+ * @return {Element}
+ */
+export function convertMarkdownCodeSnippets(markdownText: string): Element;
+/**
+ * @return {DocumentFragment}
+ */
+export function createStylesElement(): DocumentFragment;
+//# sourceMappingURL=api.d.ts.map