lighthouse 11.7.0-dev.20240408 → 11.7.1

package/shared/localization/locales/zh-HK.json

@@ -236,6 +236,15 @@
   "core/audits/accessibility/document-title.js | title": {
     "message": "文件具備 `<title>` 元素"
   },
+  "core/audits/accessibility/duplicate-id-active.js | description": {
+    "message": "所有可聚焦元素都必須有不重複的 `id`，以確保輔助技術可以查看這些元素。[瞭解如何修正 `id` 重複的問題](https://dequeuniversity.com/rules/axe/4.8/duplicate-id-active)。"
+  },
+  "core/audits/accessibility/duplicate-id-active.js | failureTitle": {
+    "message": "已啟用且可聚焦的元素有重複的 `[id]` 屬性"
+  },
+  "core/audits/accessibility/duplicate-id-active.js | title": {
+    "message": "已啟用且可聚焦的元素沒有重複的 `[id]` 屬性"
+  },
   "core/audits/accessibility/duplicate-id-aria.js | description": {
     "message": "ARIA ID 的值不可重複，以免輔助技術忽略其他例項。[瞭解如何修正重複的 ARIA ID](https://dequeuniversity.com/rules/axe/4.8/duplicate-id-aria)。"
   },
@@ -1148,6 +1157,15 @@
   "core/audits/largest-contentful-paint-element.js | title": {
     "message": "「最大內容繪製」元素"
   },
+  "core/audits/layout-shift-elements.js | columnContribution": {
+    "message": "受版面配置轉移影響的元素數量"
+  },
+  "core/audits/layout-shift-elements.js | description": {
+    "message": "版面配置轉移對這些 DOM 元素造成的影響最大。由於[視窗化](https://web.dev/articles/cls#what_is_cls)，部分版面配置轉移可能不會包含在 CLS 數據值中。[瞭解如何改善累計版面配置轉移 (CLS)](https://web.dev/articles/optimize-cls)"
+  },
+  "core/audits/layout-shift-elements.js | title": {
+    "message": "避免大幅度的版面配置轉移"
+  },
   "core/audits/layout-shifts.js | columnScore": {
     "message": "版面配置轉移分數"
   },
@@ -1268,6 +1286,15 @@
   "core/audits/network-server-latency.js | title": {
     "message": "伺服器後端延遲時間"
   },
+  "core/audits/no-unload-listeners.js | description": {
+    "message": "「`unload`」事件無法保證觸發，而偵聽此事件可能會防礙瀏覽器優化項目操作，例如向前/返回快取。請改用「`pagehide`」或「`visibilitychange`」事件。[進一步瞭解卸載事件監聽器](https://web.dev/articles/bfcache#never_use_the_unload_event)"
+  },
+  "core/audits/no-unload-listeners.js | failureTitle": {
+    "message": "發現 `unload` 偵聽器"
+  },
+  "core/audits/no-unload-listeners.js | title": {
+    "message": "避免 `unload` 事件偵聽器"
+  },
   "core/audits/non-composited-animations.js | description": {
     "message": "未合成的動畫可能無法順暢播放，而且會增加累計版面配置轉移 (CLS)。[瞭解如何避免使用非合成動畫](https://developer.chrome.com/docs/lighthouse/performance/non-composited-animations/)"
   },
@@ -1454,6 +1481,15 @@
   "core/audits/seo/meta-description.js | title": {
     "message": "文件具有中繼說明"
   },
+  "core/audits/seo/plugins.js | description": {
+    "message": "搜尋引擎無法為外掛程式內容加入索引，而且很多裝置對外掛程式都設有限制甚至不提供支援。[進一步瞭解如何避免使用外掛程式](https://developer.chrome.com/docs/lighthouse/seo/plugins/)。"
+  },
+  "core/audits/seo/plugins.js | failureTitle": {
+    "message": "文件使用外掛程式"
+  },
+  "core/audits/seo/plugins.js | title": {
+    "message": "文件避免使用外掛程式"
+  },
   "core/audits/seo/robots-txt.js | description": {
     "message": "如果您的 robots.txt 檔案格式錯誤，檢索器可能無法瞭解您偏好的網站檢索或加入索引方式。[進一步瞭解 robots.txt](https://developer.chrome.com/docs/lighthouse/seo/invalid-robots-txt/)。"
   },
@@ -1472,6 +1508,27 @@
   "core/audits/seo/robots-txt.js | title": {
     "message": "robots.txt 有效"
   },
+  "core/audits/seo/tap-targets.js | description": {
+    "message": "按鈕和連結等互動元素的大小應至少有 48x48 像素，或周圍應保留足夠空間以便使用者輕按，同時避免與其他元素重疊的情況。[進一步瞭解輕按目標](https://developer.chrome.com/docs/lighthouse/seo/tap-targets/)。"
+  },
+  "core/audits/seo/tap-targets.js | displayValue": {
+    "message": "{decimalProportion, number, percent} 的輕按目標大小適中"
+  },
+  "core/audits/seo/tap-targets.js | explanationViewportMetaNotOptimized": {
+    "message": "由於網頁沒有為流動裝置螢幕設定合適的檢視區中繼標記，因此輕按目標太小"
+  },
+  "core/audits/seo/tap-targets.js | failureTitle": {
+    "message": "輕按目標未設定成適當大小"
+  },
+  "core/audits/seo/tap-targets.js | overlappingTargetHeader": {
+    "message": "重疊的目標"
+  },
+  "core/audits/seo/tap-targets.js | tapTargetHeader": {
+    "message": "輕按目標"
+  },
+  "core/audits/seo/tap-targets.js | title": {
+    "message": "輕按目標已設定成適當大小"
+  },
   "core/audits/server-response-time.js | description": {
     "message": "請確保主要文件的伺服器回應時間不會太長，因為這會影響所有其他要求。[進一步瞭解「首個字節時間」數據](https://developer.chrome.com/docs/lighthouse/performance/time-to-first-byte/)。"
   },
@@ -1661,7 +1718,7 @@
   "core/audits/work-during-interaction.js | presentationDelay": {
     "message": "螢幕畫面分享延遲"
   },
-  "core/audits/work-during-interaction.js | processingDuration": {
+  "core/audits/work-during-interaction.js | processingTime": {
     "message": "處理時間"
   },
   "core/audits/work-during-interaction.js | title": {
@@ -1757,6 +1814,12 @@
   "core/config/default-config.js | firstPaintImprovementsGroupTitle": {
     "message": "首次繪製改進"
   },
+  "core/config/default-config.js | loadOpportunitiesGroupDescription": {
+    "message": "這些建議可加快網頁載入速度，但不會[直接影響](https://developer.chrome.com/docs/lighthouse/performance/performance-scoring/)「效能」分數。"
+  },
+  "core/config/default-config.js | loadOpportunitiesGroupTitle": {
+    "message": "優化建議"
+  },
   "core/config/default-config.js | metricGroupTitle": {
     "message": "數據"
   },

package/shared/localization/locales/zh-TW.json

@@ -236,6 +236,15 @@
   "core/audits/accessibility/document-title.js | title": {
     "message": "文件具有 `<title>` 元素"
   },
+  "core/audits/accessibility/duplicate-id-active.js | description": {
+    "message": "所有可聚焦的元素都必須擁有專屬的 `id`，以確保輔助技術可查看這些元素。[瞭解如何修正 `id` 重複的問題](https://dequeuniversity.com/rules/axe/4.8/duplicate-id-active)。"
+  },
+  "core/audits/accessibility/duplicate-id-active.js | failureTitle": {
+    "message": "已啟用的可聚焦元素有重複的 `[id]` 屬性"
+  },
+  "core/audits/accessibility/duplicate-id-active.js | title": {
+    "message": "已啟用的可聚焦元素沒有重複的 `[id]` 屬性"
+  },
   "core/audits/accessibility/duplicate-id-aria.js | description": {
     "message": "ARIA ID 的值不得重複，以免輔助技術忽略其他重複的執行個體。[瞭解如何修正重複的 ARIA ID](https://dequeuniversity.com/rules/axe/4.8/duplicate-id-aria)。"
   },
@@ -1148,6 +1157,15 @@
   "core/audits/largest-contentful-paint-element.js | title": {
     "message": "最大內容繪製元素"
   },
+  "core/audits/layout-shift-elements.js | columnContribution": {
+    "message": "受版面配置位移影響的元素數量"
+  },
+  "core/audits/layout-shift-elements.js | description": {
+    "message": "版面配置位移對這些 DOM 元素造成的影響最大。由於[執行時間較短](https://web.dev/articles/cls#what_is_cls)，部分版面配置位移可能不會包含在 CLS 指標值中。[瞭解如何改善 CLS](https://web.dev/articles/optimize-cls)"
+  },
+  "core/audits/layout-shift-elements.js | title": {
+    "message": "避免大量版面配置轉移"
+  },
   "core/audits/layout-shifts.js | columnScore": {
     "message": "版面配置位移分數"
   },
@@ -1268,6 +1286,15 @@
   "core/audits/network-server-latency.js | title": {
     "message": "伺服器後端延遲時間"
   },
+  "core/audits/no-unload-listeners.js | description": {
+    "message": "`unload` 事件無法穩定觸發，監聽該活動可能會妨礙系統進行某些瀏覽器最佳化作業 (例如往返快取)。請改用 `pagehide` 或 `visibilitychange` 事件。[進一步瞭解卸載事件監聽器](https://web.dev/articles/bfcache#never_use_the_unload_event)"
+  },
+  "core/audits/no-unload-listeners.js | failureTitle": {
+    "message": "註冊 `unload` 事件監聽器"
+  },
+  "core/audits/no-unload-listeners.js | title": {
+    "message": "避免使用 `unload` 事件監聽器"
+  },
   "core/audits/non-composited-animations.js | description": {
     "message": "未合成的動畫可能無法順暢播放，而且會增加 CLS。[瞭解如何避免使用非合成動畫](https://developer.chrome.com/docs/lighthouse/performance/non-composited-animations/)"
   },
@@ -1454,6 +1481,15 @@
   "core/audits/seo/meta-description.js | title": {
     "message": "文件具有中繼說明"
   },
+  "core/audits/seo/plugins.js | description": {
+    "message": "搜尋引擎無法為外掛程式內容建立索引，而且許多裝置對外掛程式設有限制或不提供支援。[進一步瞭解如何避免使用外掛程式](https://developer.chrome.com/docs/lighthouse/seo/plugins/)。"
+  },
+  "core/audits/seo/plugins.js | failureTitle": {
+    "message": "文件使用外掛程式"
+  },
+  "core/audits/seo/plugins.js | title": {
+    "message": "文件盡量不使用外掛程式"
+  },
   "core/audits/seo/robots-txt.js | description": {
     "message": "如果 robots.txt 檔案格式錯誤，檢索器可能無法瞭解你偏好的網站檢索方式或索引建立方式。[進一步瞭解 robots.txt](https://developer.chrome.com/docs/lighthouse/seo/invalid-robots-txt/)。"
   },
@@ -1472,6 +1508,27 @@
   "core/audits/seo/robots-txt.js | title": {
     "message": "robots.txt 有效"
   },
+  "core/audits/seo/tap-targets.js | description": {
+    "message": "按鈕和連結等互動元素的大小應至少有 48x48 像素，或周圍保有足夠空間，方便使用者輕觸，同時避免與其他元素重疊的情況。[進一步瞭解輕觸目標](https://developer.chrome.com/docs/lighthouse/seo/tap-targets/)。"
+  },
+  "core/audits/seo/tap-targets.js | displayValue": {
+    "message": "{decimalProportion, number, percent} 的輕觸目標大小適中"
+  },
+  "core/audits/seo/tap-targets.js | explanationViewportMetaNotOptimized": {
+    "message": "輕觸目標太小，這是因為網頁沒有針對行動裝置螢幕設定合適的可視區域中繼標記"
+  },
+  "core/audits/seo/tap-targets.js | failureTitle": {
+    "message": "輕觸目標未設定成適當大小"
+  },
+  "core/audits/seo/tap-targets.js | overlappingTargetHeader": {
+    "message": "重疊的目標"
+  },
+  "core/audits/seo/tap-targets.js | tapTargetHeader": {
+    "message": "輕觸目標"
+  },
+  "core/audits/seo/tap-targets.js | title": {
+    "message": "輕觸目標已設定成適當大小"
+  },
   "core/audits/server-response-time.js | description": {
     "message": "請確保伺服器能快速回應主要文件，因為這會影響到所有其他要求的回應時間。[進一步瞭解「第一個位元組時間」指標](https://developer.chrome.com/docs/lighthouse/performance/time-to-first-byte/)。"
   },
@@ -1661,7 +1718,7 @@
   "core/audits/work-during-interaction.js | presentationDelay": {
     "message": "回應顯示延遲"
   },
-  "core/audits/work-during-interaction.js | processingDuration": {
+  "core/audits/work-during-interaction.js | processingTime": {
     "message": "處理時間"
   },
   "core/audits/work-during-interaction.js | title": {
@@ -1757,6 +1814,12 @@
   "core/config/default-config.js | firstPaintImprovementsGroupTitle": {
     "message": "改進首次繪製程序"
   },
+  "core/config/default-config.js | loadOpportunitiesGroupDescription": {
+    "message": "這些建議有助於提升網頁載入速度，但不會[直接影響](https://developer.chrome.com/docs/lighthouse/performance/performance-scoring/)「效能」分數。"
+  },
+  "core/config/default-config.js | loadOpportunitiesGroupTitle": {
+    "message": "最佳化建議"
+  },
   "core/config/default-config.js | metricGroupTitle": {
     "message": "指標"
   },

package/shared/localization/locales/zh.json

@@ -236,6 +236,15 @@
   "core/audits/accessibility/document-title.js | title": {
     "message": "文档包含 `<title>` 元素"
   },
+  "core/audits/accessibility/duplicate-id-active.js | description": {
+    "message": "所有可聚焦的元素都必须具有独一无二的 `id`，以确保能被辅助技术识别。[了解如何修正重复的 `id`](https://dequeuniversity.com/rules/axe/4.8/duplicate-id-active)。"
+  },
+  "core/audits/accessibility/duplicate-id-active.js | failureTitle": {
+    "message": "处于活动状态的可聚焦元素的 `[id]` 属性不是独一无二的"
+  },
+  "core/audits/accessibility/duplicate-id-active.js | title": {
+    "message": "处于活动状态的可聚焦元素的 `[id]` 属性都是独一无二的"
+  },
   "core/audits/accessibility/duplicate-id-aria.js | description": {
     "message": "ARIA ID 的值必须独一无二，才能防止其他实例被辅助技术忽略。[了解如何修正重复的 ARIA ID](https://dequeuniversity.com/rules/axe/4.8/duplicate-id-aria)。"
   },
@@ -1148,6 +1157,15 @@
   "core/audits/largest-contentful-paint-element.js | title": {
     "message": "最大内容渲染时间元素"
   },
+  "core/audits/layout-shift-elements.js | columnContribution": {
+    "message": "布局偏移的影响"
+  },
+  "core/audits/layout-shift-elements.js | description": {
+    "message": "这些 DOM 元素受布局偏移的影响最大。由于[窗口化](https://web.dev/articles/cls#what_is_cls)的原因，某些布局偏移可能未包含在 CLS 指标值中。[了解如何改善 CLS](https://web.dev/articles/optimize-cls)"
+  },
+  "core/audits/layout-shift-elements.js | title": {
+    "message": "请避免出现大幅度的布局偏移"
+  },
   "core/audits/layout-shifts.js | columnScore": {
     "message": "布局偏移分数"
   },
@@ -1268,6 +1286,15 @@
   "core/audits/network-server-latency.js | title": {
     "message": "服务器后端延迟"
   },
+  "core/audits/no-unload-listeners.js | description": {
+    "message": "“`unload`”事件不会可靠地触发，而且监听该事件可能会妨碍系统实施“往返缓存”之类的浏览器优化策略。请改用“`pagehide`”或“`visibilitychange`”事件。[详细了解如何卸载事件监听器](https://web.dev/articles/bfcache#never_use_the_unload_event)"
+  },
+  "core/audits/no-unload-listeners.js | failureTitle": {
+    "message": "注册“`unload`”事件监听器"
+  },
+  "core/audits/no-unload-listeners.js | title": {
+    "message": "避免使用“`unload`”事件监听器"
+  },
   "core/audits/non-composited-animations.js | description": {
     "message": "未合成的动画可能会卡顿并增加 CLS。[了解如何避免使用未合成的动画](https://developer.chrome.com/docs/lighthouse/performance/non-composited-animations/)"
   },
@@ -1454,6 +1481,15 @@
   "core/audits/seo/meta-description.js | title": {
     "message": "文档有 meta 描述"
   },
+  "core/audits/seo/plugins.js | description": {
+    "message": "搜索引擎无法将插件内容编入索引，而且许多设备都限制或不支持使用插件。[详细了解如何避免使用插件](https://developer.chrome.com/docs/lighthouse/seo/plugins/)。"
+  },
+  "core/audits/seo/plugins.js | failureTitle": {
+    "message": "文档使用了插件"
+  },
+  "core/audits/seo/plugins.js | title": {
+    "message": "文档中没有插件"
+  },
   "core/audits/seo/robots-txt.js | description": {
     "message": "如果 robots.txt 文件的格式不正确，抓取工具可能无法理解您希望以何种方式抓取网站内容或将其编入索引。[详细了解 robots.txt](https://developer.chrome.com/docs/lighthouse/seo/invalid-robots-txt/)。"
   },
@@ -1472,6 +1508,27 @@
   "core/audits/seo/robots-txt.js | title": {
     "message": "robots.txt 有效"
   },
+  "core/audits/seo/tap-targets.js | description": {
+    "message": "交互式元素（例如按钮和链接）应足够大 (48x48px)，或者周围有足够的空间以便用户轻松点按，且不遮挡其他元素。[详细了解点按目标](https://developer.chrome.com/docs/lighthouse/seo/tap-targets/)。"
+  },
+  "core/audits/seo/tap-targets.js | displayValue": {
+    "message": "{decimalProportion, number, percent} 的点按目标大小合适"
+  },
+  "core/audits/seo/tap-targets.js | explanationViewportMetaNotOptimized": {
+    "message": "点按目标过小，因为缺少已针对移动设备屏幕进行优化的 viewport meta 标记"
+  },
+  "core/audits/seo/tap-targets.js | failureTitle": {
+    "message": "点按目标的大小不合适"
+  },
+  "core/audits/seo/tap-targets.js | overlappingTargetHeader": {
+    "message": "点按目标重叠"
+  },
+  "core/audits/seo/tap-targets.js | tapTargetHeader": {
+    "message": "点按目标"
+  },
+  "core/audits/seo/tap-targets.js | title": {
+    "message": "点按目标的大小合适"
+  },
   "core/audits/server-response-time.js | description": {
     "message": "请确保服务器响应主文档的用时较短，因为这会影响到所有其他请求的响应时长。[详细了解 Time to First Byte 指标](https://developer.chrome.com/docs/lighthouse/performance/time-to-first-byte/)。"
   },
@@ -1661,7 +1718,7 @@
   "core/audits/work-during-interaction.js | presentationDelay": {
     "message": "展示延迟时间"
   },
-  "core/audits/work-during-interaction.js | processingDuration": {
+  "core/audits/work-during-interaction.js | processingTime": {
     "message": "处理时间"
   },
   "core/audits/work-during-interaction.js | title": {
@@ -1757,6 +1814,12 @@
   "core/config/default-config.js | firstPaintImprovementsGroupTitle": {
     "message": "改进首次绘制"
   },
+  "core/config/default-config.js | loadOpportunitiesGroupDescription": {
+    "message": "这些建议可以帮助您提高网页加载速度。它们不会[直接影响](https://developer.chrome.com/docs/lighthouse/performance/performance-scoring/)性能得分。"
+  },
+  "core/config/default-config.js | loadOpportunitiesGroupTitle": {
+    "message": "优化建议"
+  },
   "core/config/default-config.js | metricGroupTitle": {
     "message": "指标"
   },

package/tsconfig.json

@@ -70,7 +70,6 @@
     "core/test/lib/i18n/i18n-test.js",
     "core/test/lib/icons-test.js",
     "core/test/lib/lantern/base-node-test.js",
-    "core/test/lib/lantern/metrics/*",
     "core/test/lib/lantern/page-dependency-graph-test.js",
     "core/test/lib/lantern/simulator/connection-pool-test.js",
     "core/test/lib/lantern/simulator/dns-cache-test.js",

package/types/artifacts.d.ts

@@ -89,8 +89,8 @@ interface PublicGathererArtifacts {
   LinkElements: Artifacts.LinkElement[];
   /** The values of the <meta> elements in the head. */
   MetaElements: Array<{name?: string, content?: string, property?: string, httpEquiv?: string, charset?: string, node: Artifacts.NodeDetails}>;
-  /** Information on all scripts in the page. */
-  Scripts: Artifacts.Script[];
+  /** Information on all script elements in the page. Also contains the content of all requested scripts and the networkRecord requestId that contained their content. Note, HTML documents will have one entry per script tag, all with the same requestId. */
+  ScriptElements: Array<Artifacts.ScriptElement>;
   /** The dimensions and devicePixelRatio of the loaded viewport. */
   ViewportDimensions: Artifacts.ViewportDimensions;
 }
@@ -119,6 +119,8 @@ export interface GathererArtifacts extends PublicGathererArtifacts {
   Doctype: Artifacts.Doctype | null;
   /** Information on the size of all DOM nodes in the page and the most extreme members. */
   DOMStats: Artifacts.DOMStats;
+  /** Relevant attributes and child properties of all <object>s, <embed>s and <applet>s in the page. */
+  EmbeddedContent: Artifacts.EmbeddedContentInfo[];
   /** Information on poorly sized font usage and the text affected by it. */
   FontSize: Artifacts.FontSize;
   /** All the input elements, including associated form and label elements. */
@@ -144,6 +146,8 @@ export interface GathererArtifacts extends PublicGathererArtifacts {
   RobotsTxt: {status: number|null, content: string|null, errorMessage?: string};
   /** The result of calling the shared trace engine root cause analysis. */
   RootCauses: Artifacts.TraceEngineRootCauses;
+  /** Information on all scripts in the page. */
+  Scripts: Artifacts.Script[];
   /** Version information for all ServiceWorkers active after the first page load. */
   ServiceWorker: {versions: Crdp.ServiceWorker.ServiceWorkerVersion[], registrations: Crdp.ServiceWorker.ServiceWorkerRegistration[]};
   /** Source maps of scripts executed in the page. */
@@ -247,6 +251,16 @@ declare module Artifacts {
     depth: NodeDetails & {max: number;};
   }
 
+  interface EmbeddedContentInfo {
+    tagName: string;
+    type: string | null;
+    src: string | null;
+    data: string | null;
+    code: string | null;
+    params: Array<{name: string; value: string}>;
+    node: Artifacts.NodeDetails;
+  }
+
   interface IFrameElement {
     /** The `id` attribute of the iframe. */
     id: string,
@@ -549,7 +563,7 @@ declare module Artifacts {
   }
 
   interface TraceElement {
-    traceEventType: 'largest-contentful-paint'|'layout-shift'|'animation'|'responsiveness';
+    traceEventType: 'largest-contentful-paint'|'layout-shift'|'layout-shift-element'|'animation'|'responsiveness';
     node: NodeDetails;
     nodeId: number;
     animations?: {name?: string, failureReasonsMask?: number, unsupportedProperties?: string[]}[];

package/types/config.d.ts

@@ -83,6 +83,7 @@ declare module Config {
     weight: number;
     group?: string;
     acronym?: string;
+    relevantAudits?: string[];
   }
 
   type Settings = ConfigSettings;

package/types/lhr/audit-details.d.ts

@@ -9,6 +9,10 @@ import Treemap from './treemap.js';
 
 /** Common properties for all details types. */
 interface BaseDetails {
+  /** If present and audit is part of the performance category, audit is treated as an Opportunity. */
+  overallSavingsMs?: number;
+  /** Optional additional Opportunity information. */
+  overallSavingsBytes?: number;
   /** Additional information, usually used for including debug or meta information in the LHR */
   debugData?: Details.DebugData;
 }
@@ -81,15 +85,6 @@ declare module Details {
     isEntityGrouped?: boolean;
     /** Column keys to skip summing. If omitted, all column types supported are summed. */
     skipSumming?: Array<string>;
-    /**
-     * @deprecated
-     * Historically this represents the time saved on the entire page load. It's mostly used as an
-     * alias for `metricSavings.LCP` now. We recommend using `metricSavings` directly for more
-     * metric-specific savings estimates.
-     */
-    overallSavingsMs?: number;
-    /** Total byte savings covered by this audit. */
-    overallSavingsBytes?: number;
   }
 
   interface Screenshot extends BaseDetails {

package/types/lhr/lhr.d.ts

@@ -116,6 +116,8 @@ declare module Result {
     group?: string;
     /** The conventional acronym for the audit/metric. */
     acronym?: string;
+    /** Any audit IDs closely relevant to this one. */
+    relevantAudits?: string[];
   }
 
   interface ReportGroup {

package/core/lib/lantern/metrics/first-contentful-paint.d.ts

@@ -1,79 +0,0 @@
-export type Node = import('../base-node.js').Node;
-export type NetworkNode<T> = import('../network-node.js').NetworkNode<T>;
-export type CpuNode = import('../cpu-node.js').CPUNode;
-/** @typedef {import('../base-node.js').Node} Node */
-/** @template T @typedef {import('../network-node.js').NetworkNode<T>} NetworkNode */
-/** @typedef {import('../cpu-node.js').CPUNode} CpuNode */
-export class FirstContentfulPaint extends Metric {
-    /**
-     * @template T
-     * @typedef FirstPaintBasedGraphOpts
-     * @property {number} cutoffTimestamp The timestamp used to filter out tasks that occured after
-     *    our paint of interest. Typically this is First Contentful Paint or First Meaningful Paint.
-     * @property {function(NetworkNode<T>):boolean} treatNodeAsRenderBlocking The function that determines
-     *    which resources should be considered *possibly* render-blocking.
-     * @property {(function(CpuNode):boolean)=} additionalCpuNodesToTreatAsRenderBlocking The function that
-     *    determines which CPU nodes should also be included in our blocking node IDs set,
-     *    beyond what getRenderBlockingNodeData() already includes.
-     */
-    /**
-     * This function computes the set of URLs that *appeared* to be render-blocking based on our filter,
-     * *but definitely were not* render-blocking based on the timing of their EvaluateScript task.
-     * It also computes the set of corresponding CPU node ids that were needed for the paint at the
-     * given timestamp.
-     *
-     * @template [T=unknown]
-     * @param {Node} graph
-     * @param {FirstPaintBasedGraphOpts<T>} opts
-     * @return {{definitelyNotRenderBlockingScriptUrls: Set<string>, renderBlockingCpuNodeIds: Set<string>}}
-     */
-    static getRenderBlockingNodeData<T = unknown>(graph: Node, { cutoffTimestamp, treatNodeAsRenderBlocking, additionalCpuNodesToTreatAsRenderBlocking }: {
-        /**
-         * The timestamp used to filter out tasks that occured after
-         * our paint of interest. Typically this is First Contentful Paint or First Meaningful Paint.
-         */
-        cutoffTimestamp: number;
-        /**
-         * The function that determines
-         * which resources should be considered *possibly* render-blocking.
-         */
-        treatNodeAsRenderBlocking: (arg0: import("../network-node.js").NetworkNode<T>) => boolean;
-        /**
-         * The function that
-         * determines which CPU nodes should also be included in our blocking node IDs set,
-         * beyond what getRenderBlockingNodeData() already includes.
-         */
-        additionalCpuNodesToTreatAsRenderBlocking?: ((arg0: CpuNode) => boolean) | undefined;
-    }): {
-        definitelyNotRenderBlockingScriptUrls: Set<string>;
-        renderBlockingCpuNodeIds: Set<string>;
-    };
-    /**
-     * This function computes the graph required for the first paint of interest.
-     *
-     * @template [T=unknown]
-     * @param {Node} dependencyGraph
-     * @param {FirstPaintBasedGraphOpts<T>} opts
-     * @return {Node}
-     */
-    static getFirstPaintBasedGraph<T_1 = unknown>(dependencyGraph: Node, { cutoffTimestamp, treatNodeAsRenderBlocking, additionalCpuNodesToTreatAsRenderBlocking }: {
-        /**
-         * The timestamp used to filter out tasks that occured after
-         * our paint of interest. Typically this is First Contentful Paint or First Meaningful Paint.
-         */
-        cutoffTimestamp: number;
-        /**
-         * The function that determines
-         * which resources should be considered *possibly* render-blocking.
-         */
-        treatNodeAsRenderBlocking: (arg0: import("../network-node.js").NetworkNode<T_1>) => boolean;
-        /**
-         * The function that
-         * determines which CPU nodes should also be included in our blocking node IDs set,
-         * beyond what getRenderBlockingNodeData() already includes.
-         */
-        additionalCpuNodesToTreatAsRenderBlocking?: ((arg0: CpuNode) => boolean) | undefined;
-    }): Node;
-}
-import { Metric } from '../metric.js';
-//# sourceMappingURL=first-contentful-paint.d.ts.map