lighthouse 13.2.0 → 13.4.0

package/core/audits/accessibility/html-lang-valid.js

@@ -21,7 +21,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
       'helps screen readers announce text properly. ' +
-      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/html-lang-valid).',
+      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/html-lang-valid).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/html-xml-lang-mismatch.js

@@ -23,7 +23,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'If the webpage does not specify a consistent language, then the screen ' +
       'reader might not announce the page\'s text correctly. ' +
-      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/html-xml-lang-mismatch).',
+      '[Learn more about the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/html-xml-lang-mismatch).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/identical-links-same-purpose.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Links with the same destination should have the same description, to help users ' +
       'understand the link\'s purpose and decide whether to follow it. ' +
-      '[Learn more about identical links](https://dequeuniversity.com/rules/axe/4.11/identical-links-same-purpose).',
+      '[Learn more about identical links](https://dequeuniversity.com/rules/axe/4.12/identical-links-same-purpose).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/image-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Informative elements should aim for short, descriptive alternate text. ' +
       'Decorative elements can be ignored with an empty alt attribute. ' +
-      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.11/image-alt).',
+      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.12/image-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/image-redundant-alt.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Informative elements should aim for short, descriptive alternative text. ' +
       'Alternative text that is exactly the same as the text adjacent to the link or image is ' +
       'potentially confusing for screen reader users, because the text will be read twice. ' +
-      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.11/image-redundant-alt).',
+      '[Learn more about the `alt` attribute](https://dequeuniversity.com/rules/axe/4.12/image-redundant-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/input-button-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Adding discernable and accessible text to input buttons may help screen reader ' +
       'users understand the purpose of the input button. ' +
-      '[Learn more about input buttons](https://dequeuniversity.com/rules/axe/4.11/input-button-name).',
+      '[Learn more about input buttons](https://dequeuniversity.com/rules/axe/4.12/input-button-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/input-image-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'When an image is being used as an `<input>` button, providing alternative ' +
       'text can help screen reader users understand the purpose of the button. ' +
-      '[Learn about input image alt text](https://dequeuniversity.com/rules/axe/4.11/input-image-alt).',
+      '[Learn about input image alt text](https://dequeuniversity.com/rules/axe/4.12/input-image-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/label-content-name-mismatch.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Visible text labels that do not match the accessible name can result in a ' +
       'confusing experience for screen reader users. ' +
-      '[Learn more about accessible names](https://dequeuniversity.com/rules/axe/4.11/label-content-name-mismatch).',
+      '[Learn more about accessible names](https://dequeuniversity.com/rules/axe/4.12/label-content-name-mismatch).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/label.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Labels ensure that form controls are announced properly by assistive ' +
       'technologies, like screen readers. [Learn ' +
-      'more about form element labels](https://dequeuniversity.com/rules/axe/4.11/label).',
+      'more about form element labels](https://dequeuniversity.com/rules/axe/4.12/label).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/landmark-one-main.js

@@ -19,7 +19,7 @@ const UIStrings = {
   failureTitle: 'Document does not have a main landmark.',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'One main landmark helps screen reader users navigate a web page. ' +
-      '[Learn more about landmarks](https://dequeuniversity.com/rules/axe/4.11/landmark-one-main).',
+      '[Learn more about landmarks](https://dequeuniversity.com/rules/axe/4.12/landmark-one-main).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/link-in-text-block.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Low-contrast text is difficult or impossible for many users to read. Link text ' +
       'that is discernible improves the experience for users with low vision. ' +
-      '[Learn how to make links distinguishable](https://dequeuniversity.com/rules/axe/4.11/link-in-text-block).',
+      '[Learn how to make links distinguishable](https://dequeuniversity.com/rules/axe/4.12/link-in-text-block).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/link-name.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Link text (and alternate text for images, when used as links) that is ' +
       'discernible, unique, and focusable improves the navigation experience for ' +
       'screen reader users. ' +
-      '[Learn how to make links accessible](https://dequeuniversity.com/rules/axe/4.11/link-name).',
+      '[Learn how to make links accessible](https://dequeuniversity.com/rules/axe/4.12/link-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/list.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Screen readers have a specific way of announcing lists. Ensuring proper list ' +
       'structure aids screen reader output. ' +
-      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.11/list).',
+      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.12/list).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/listitem.js

@@ -21,7 +21,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Screen readers require list items (`<li>`) to be contained within a ' +
       'parent `<ul>`, `<ol>` or `<menu>` to be announced properly. ' +
-      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.11/listitem).',
+      '[Learn more about proper list structure](https://dequeuniversity.com/rules/axe/4.12/listitem).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/meta-refresh.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Users do not expect a page to refresh automatically, and doing so will move ' +
       'focus back to the top of the page. This may create a frustrating or ' +
       'confusing experience. ' +
-      '[Learn more about the refresh meta tag](https://dequeuniversity.com/rules/axe/4.11/meta-refresh).',
+      '[Learn more about the refresh meta tag](https://dequeuniversity.com/rules/axe/4.12/meta-refresh).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/meta-viewport.js

@@ -22,7 +22,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Disabling zooming is problematic for users with low vision who rely on ' +
       'screen magnification to properly see the contents of a web page. ' +
-      '[Learn more about the viewport meta tag](https://dequeuniversity.com/rules/axe/4.11/meta-viewport).',
+      '[Learn more about the viewport meta tag](https://dequeuniversity.com/rules/axe/4.12/meta-viewport).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/object-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Screen readers cannot translate non-text content. Adding alternate text to ' +
       '`<object>` elements helps screen readers convey meaning to users. ' +
-      '[Learn more about alt text for `object` elements](https://dequeuniversity.com/rules/axe/4.11/object-alt).',
+      '[Learn more about alt text for `object` elements](https://dequeuniversity.com/rules/axe/4.12/object-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/presentation-role-conflict.js

@@ -22,7 +22,7 @@ const UIStrings = {
       'or `role="presentation"` does not resolve to none or presentation. To ensure the ' +
       'element remains removed from the accessibility tree, you should not add any global ' +
       'ARIA attributes to the element or make it focusable. ' +
-      '[Learn more about presentation role conflict](https://dequeuniversity.com/rules/axe/4.11/presentation-role-conflict).',
+      '[Learn more about presentation role conflict](https://dequeuniversity.com/rules/axe/4.12/presentation-role-conflict).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/select-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Form elements without effective labels can create frustrating experiences ' +
       'for screen reader users. ' +
-      '[Learn more about the `select` element](https://dequeuniversity.com/rules/axe/4.11/select-name).',
+      '[Learn more about the `select` element](https://dequeuniversity.com/rules/axe/4.12/select-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/skip-link.js

@@ -19,7 +19,7 @@ const UIStrings = {
   failureTitle: 'Skip links are not focusable.',
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Including a skip link can help users skip to the main content to save time. ' +
-      '[Learn more about skip links](https://dequeuniversity.com/rules/axe/4.11/skip-link).',
+      '[Learn more about skip links](https://dequeuniversity.com/rules/axe/4.12/skip-link).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/svg-img-alt.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with \'Learn\' becomes link text to additional documentation. */
   description: 'Ensures SVG elements with an `img`, `graphics-document` or `graphics-symbol` ' +
       'role have an accessible text alternative. ' +
-      '[Learn more about SVG alt text](https://dequeuniversity.com/rules/axe/4.11/svg-img-alt).',
+      '[Learn more about SVG alt text](https://dequeuniversity.com/rules/axe/4.12/svg-img-alt).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/tabindex.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'A value greater than 0 implies an explicit navigation ordering. ' +
       'Although technically valid, this often creates frustrating experiences ' +
-      'for users who rely on assistive technologies. [Learn more about the `tabindex` attribute](https://dequeuniversity.com/rules/axe/4.11/tabindex).',
+      'for users who rely on assistive technologies. [Learn more about the `tabindex` attribute](https://dequeuniversity.com/rules/axe/4.12/tabindex).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/table-duplicate-name.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'The summary attribute should describe the table structure, while `<caption>` ' +
       'should have the onscreen title. Accurate table mark-up helps users of screen readers. ' +
-      '[Learn more about summary and caption](https://dequeuniversity.com/rules/axe/4.11/table-duplicate-name).',
+      '[Learn more about summary and caption](https://dequeuniversity.com/rules/axe/4.12/table-duplicate-name).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/table-fake-caption.js

@@ -23,7 +23,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'that tables use the actual caption element instead of cells with the `[colspan]` ' +
       'attribute may improve the experience for screen reader users. ' +
-      '[Learn more about captions](https://dequeuniversity.com/rules/axe/4.11/table-fake-caption).',
+      '[Learn more about captions](https://dequeuniversity.com/rules/axe/4.12/table-fake-caption).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/target-size.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Touch targets with sufficient size and spacing help users who may have ' +
       'difficulty targeting small controls to activate the targets. ' +
-      '[Learn more about touch targets](https://dequeuniversity.com/rules/axe/4.11/target-size).',
+      '[Learn more about touch targets](https://dequeuniversity.com/rules/axe/4.12/target-size).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/td-has-header.js

@@ -21,7 +21,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'that `<td>` elements in a large table (3 or more cells in width and height) have an ' +
       'associated table header may improve the experience for screen reader users. ' +
-      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.11/td-has-header).',
+      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.12/td-has-header).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/td-headers-attr.js

@@ -24,7 +24,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       '`<td>` cells using the `[headers]` attribute only refer to other cells in the same ' +
       'table may improve the experience for screen reader users. ' +
-      '[Learn more about the `headers` attribute](https://dequeuniversity.com/rules/axe/4.11/td-headers-attr).',
+      '[Learn more about the `headers` attribute](https://dequeuniversity.com/rules/axe/4.12/td-headers-attr).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/th-has-data-cells.js

@@ -23,7 +23,7 @@ const UIStrings = {
   description: 'Screen readers have features to make navigating tables easier. Ensuring ' +
       'table headers always refer to some set of cells may improve the experience for screen ' +
       'reader users. ' +
-      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.11/th-has-data-cells).',
+      '[Learn more about table headers](https://dequeuniversity.com/rules/axe/4.12/th-has-data-cells).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/valid-lang.js

@@ -20,7 +20,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Specifying a valid [BCP 47 language](https://www.w3.org/International/questions/qa-choosing-language-tags#question) ' +
       'on elements helps ensure that text is pronounced correctly by a screen reader. ' +
-      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.11/valid-lang).',
+      '[Learn how to use the `lang` attribute](https://dequeuniversity.com/rules/axe/4.12/valid-lang).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/accessibility/video-caption.js

@@ -21,7 +21,7 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user *why* they should try to pass. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'When a video provides a caption it is easier for deaf and hearing impaired ' +
       'users to access its information. ' +
-      '[Learn more about video captions](https://dequeuniversity.com/rules/axe/4.11/video-caption).',
+      '[Learn more about video captions](https://dequeuniversity.com/rules/axe/4.12/video-caption).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/agentic/agent-accessibility-tree.js

@@ -13,7 +13,7 @@ const UIStrings = {
   /** Title shown when one or more agent accessibility checks fail. */
   failureTitle: 'Accessibility tree is not well-formed',
   /** Description of a Lighthouse audit that tells the user *why* they need a well-formed accessibility tree. */
-  description: 'A well-formed accessibility tree helps AI agents to ' +
+  description: 'A well-formed [accessibility tree](http://goo.gle/lighthouse-agentic-a11y) helps AI agents to ' +
     'navigate and interact with the page.',
   /** Label of a table column that identifies the accessibility rule that failed. */
   columnRule: 'Failing Rule',

package/core/audits/agentic/llms-txt.js

@@ -11,15 +11,15 @@ const HTTP_CLIENT_ERROR_CODE_LOW = 400;
 const HTTP_SERVER_ERROR_CODE_LOW = 500;
 
 const UIStrings = {
-  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file is present and configured correctly. */
-  title: 'llms.txt is present',
-  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file is misconfigured. */
-  failureTitle: 'llms.txt is missing or incomplete',
-  /** Description of a Lighthouse audit that tells the user *why* they need to have a valid llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This is displayed after a user expands the section to see more. No character length limits. */
-  description: 'If your llms.txt file is malformed, large language models may not be able to ' +
-    'understand how you want your website to be crawled or used for training. A valid ' +
-    'llms.txt should be a Markdown file containing at least one H1 header. ' +
-    '[Learn more about llms.txt](https://llmstxt.org/).',
+  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file follows community recommendations. */
+  title: 'llms.txt follows recommendations',
+  /** Title of a Lighthouse audit that provides detail on the site's llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This descriptive title is shown when the llms.txt file does not follow community recommendations. */
+  failureTitle: 'llms.txt does not follow recommendations',
+  /** Description of a Lighthouse audit that tells the user *why* they should have an llms.txt file. Note: "llms.txt" is a canonical filename and should not be translated. This is displayed after a user expands the section to see more. No character length limits. */
+  description: 'If your llms.txt file does not follow recommendations, ' +
+    'large language models may not be able to ' +
+    'understand how you want your website to be crawled or used for training. The ' +
+    '[llms.txt](https://llmstxt.org/) file should be a Markdown file containing at least one H1 header.',
   /**
    * @description Label for the audit identifying that the request failed with a specific HTTP status code.
    * @example {500} statusCode
@@ -84,7 +84,7 @@ class LlmsTxt extends Audit {
       throw new Error(`Status ${status} was valid, but content was null`);
     }
 
-    const hasH1 = /^#\s+.+/m.test(content);
+    const hasH1 = /^\s*#\s+.+/m.test(content);
     const hasLink = /\[.+\]\(.+\)/.test(content);
     const isTooShort = content.length < 50;
 

package/core/audits/baseline.js

@@ -4,8 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import data from 'web-features/data.json' with {type: 'json'};
-
+import data from '../lib/baseline/web-features-data.json' with {type: 'json'};
 import {Audit} from './audit.js';
 import metadata from '../lib/baseline/web-features-metadata.json' with {type: 'json'};
 import * as i18n from '../lib/i18n/i18n.js';
@@ -27,7 +26,6 @@ const UIStrings = {
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
-const {features} = /** @type {any} */ (data);
 
 
 /** @typedef {LH.TraceEvent & {args: {feature: string, url?: string, lineNumber?: number, columnNumber?: number}}} DXFeatureEvent */
@@ -90,21 +88,21 @@ class Baseline extends Audit {
         continue;
       }
 
-      const featureData = features[feature.featureId];
-
-      if (!featureData || !('status' in featureData)) {
-        continue;
-      }
+      const featureId = feature.featureId;
 
       let displayStatus = 'Limited Availability';
       let baselineTier = 'limited';
 
-      if (featureData.status.baseline === 'high') {
-        displayStatus = `Widely Available (${featureData.status.baseline_low_date})`;
+      if (featureId in data.high) {
+        const highData = /** @type {Record<string, string>} */ (data.high);
+        displayStatus = `Widely Available (${highData[featureId]})`;
         baselineTier = 'high';
-      } else if (featureData.status.baseline === 'low') {
-        displayStatus = `Newly Available (${featureData.status.baseline_low_date})`;
+      } else if (featureId in data.low) {
+        const lowData = /** @type {Record<string, string>} */ (data.low);
+        displayStatus = `Newly Available (${lowData[featureId]})`;
         baselineTier = 'low';
+      } else if (!data.limited.includes(featureId)) {
+        continue;
       }
 
       baselineStatus.push({

package/core/audits/dobetterweb/geolocation-on-start.js

@@ -21,7 +21,8 @@ const UIStrings = {
   /** Description of a Lighthouse audit that tells the user why they should not ask for geolocation permissions on load. This is displayed after a user expands the section to see more. No character length limits. The last sentence starting with 'Learn' becomes link text to additional documentation. */
   description: 'Users are mistrustful of or confused by sites that request their ' +
     'location without context. Consider tying the request to a user action instead. ' +
-    '[Learn more about the geolocation permission](https://developer.chrome.com/docs/lighthouse/best-practices/geolocation-on-start/).',
+    '[Learn more about the geolocation permission](https://developer.chrome.com/docs/lighthouse/best-practices/geolocation-on-start/). ' +
+    'Also consider using the [`<geolocation>` element](https://developer.chrome.com/blog/geolocation-html-element).',
 };
 
 const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);

package/core/audits/network-requests.js

@@ -70,6 +70,8 @@ class NetworkRequests extends Audit {
         url: UrlUtils.elideDataURI(record.url),
         sessionTargetType: record.sessionTargetType,
         protocol: record.protocol,
+        cache: record.fromDiskCache ? 'disk' :
+               record.fromMemoryCache ? 'memory' : record.fromPrefetchCache ? 'prefetch' : 'none',
         rendererStartTime: normalizeTime(record.rendererStartTime),
         networkRequestTime: normalizeTime(record.networkRequestTime),
         networkEndTime: normalizeTime(record.networkEndTime),

package/core/audits/seo/canonical.js

@@ -5,7 +5,6 @@
  */
 
 import {Audit} from '../audit.js';
-import UrlUtils from '../../lib/url-utils.js';
 import {MainResource} from '../../computed/main-resource.js';
 import * as i18n from '../../lib/i18n/i18n.js';
 
@@ -90,12 +89,25 @@ class Canonical extends Audit {
         // Links that don't have an href aren't canonical references for SEO, skip them
         if (!link.hrefRaw) continue;
 
-        // Links that had an hrefRaw but didn't have a valid href were invalid, flag them
-        if (!link.href) invalidCanonicalLink = link;
-        // Links that had a valid href but didn't have a valid hrefRaw must have been relatively resolved, flag them
-        else if (!UrlUtils.isValid(link.hrefRaw)) relativeCanonicallink = link;
-        // Otherwise, it was a valid canonical URL
-        else uniqueCanonicalURLs.add(link.href);
+        // Links that don't have an href are invalid, flag them
+        if (!link.href) {
+          invalidCanonicalLink = link;
+          continue;
+        }
+
+        if (URL.parse(link.hrefRaw, 'https://example.com') === null) {
+          // Links that are syntactically INVALID with a base, flag them
+          invalidCanonicalLink = link;
+        } else {
+          // Links that are syntactically VALID with a base:
+          if (URL.parse(link.hrefRaw) === null) {
+            // Links that are INVALID without a base must be relative, flag them
+            relativeCanonicallink = link;
+          } else {
+            // Links that are valid without a base are absolute
+            uniqueCanonicalURLs.add(link.href);
+          }
+        }
       } else if (link.rel === 'alternate') {
         if (link.href && link.hreflang) hreflangURLs.add(link.href);
       }

package/core/audits/webmcp-form-coverage.js

@@ -11,8 +11,8 @@ const UIStrings = {
   /** Title of a Lighthouse audit that lists forms found in the page for WebMCP coverage. "WebMCP" stands for "Web Model Context Protocol" and should not be translated. */
   title: 'WebMCP form coverage',
   /** Description of a Lighthouse audit that lists forms found in the page and indicates whether they have WebMCP declarative tool annotations. This is displayed after a user expands the section to see more. No character length limits. "WebMCP" stands for "Web Model Context Protocol" and should not be translated. */
-  description: 'Consider adding WebMCP annotations to the forms listed below. This helps AI ' +
-  'agents identify and interact with these forms more reliably.', // TODO: add a learn more link once available
+  description: 'Consider adding [WebMCP](http://goo.gle/webmcp-docs) annotations to the forms listed below. This helps AI ' +
+  'agents identify and interact with these forms more reliably.',
   /** [ICU Syntax] Label for the audit identifying the number of forms missing annotations. "WebMCP" stands for "Web Model Context Protocol" and should not be translated. */
   displayValue: `{itemCount, plural,
     =1 {1 form missing annotations}

package/core/audits/webmcp-registered-tools.js

@@ -15,7 +15,7 @@ const UIStrings = {
   /** Title of a Lighthouse audit that lists registered WebMCP tools. "WebMCP" stands for "Web Model Context Protocol" and should not be translated. */
   title: 'WebMCP tools registered',
   /** Description of a Lighthouse audit that lists registered WebMCP tools. This is displayed after a user expands the section to see more. No character length limits. "WebMCP" stands for "Web Model Context Protocol", neither should be translated. */
-  description: 'Lists the WebMCP tools registered at the time of analysis. ',
+  description: 'Lists the [WebMCP tools](http://goo.gle/webmcp-docs) registered at the time of analysis.',
   /** Label for a column in a data table; entries will be the name of a WebMCP tool. */
   columnTool: 'Tool name',
   /** Label for a column in a data table; entries will be the description of a WebMCP tool. */

package/core/audits/webmcp-schema-validity.js

@@ -13,7 +13,7 @@ const UIStrings = {
   /** Title of a Lighthouse audit that provides detail on WebMCP schema validity. This descriptive title is shown to users when there are schema validity issues. "WebMCP" stands for "Web Model Context Protocol" and should not be translated. */
   failureTitle: 'WebMCP schemas are invalid',
   /** Description of a Lighthouse audit that tells the user why they should ensure WebMCP schemas are valid. This is displayed after a user expands the section to see more. No character length limits. "WebMCP" stands for "Web Model Context Protocol" and should not be translated. */
-  description: 'Valid WebMCP schemas are required for AI agents to ' +
+  description: 'Valid [WebMCP schemas](http://goo.gle/webmcp-docs) are required for AI agents to ' +
   ' understand and interact with tools correctly. ' +
       'Please fix any errors or warnings reported by the browser.',
   /** Header of the table column which displays the element. */

package/core/computed/js-bundles.d.ts

@@ -1,6 +1,6 @@
 export { JSBundlesComputed as JSBundles };
 declare const JSBundlesComputed: typeof JSBundles & {
-    request: (dependencies: Pick<import("../index.js").Artifacts, "Scripts" | "SourceMaps">, context: LH.Artifacts.ComputedContext) => Promise<import("../index.js").Artifacts.Bundle[]>;
+    request: (dependencies: Pick<import("../index.js").Artifacts, "SourceMaps" | "Scripts">, context: LH.Artifacts.ComputedContext) => Promise<import("../index.js").Artifacts.Bundle[]>;
 };
 declare class JSBundles {
     /**

package/core/computed/load-simulator.d.ts

@@ -3,7 +3,7 @@ declare const LoadSimulatorComputed: typeof LoadSimulator & {
     request: (dependencies: {
         devtoolsLog: LH.DevtoolsLog;
         settings: LH.Audit.Context["settings"];
-    }, context: LH.Artifacts.ComputedContext) => Promise<import("../../types/gatherer.js").default.Simulation.Simulator>;
+    }, context: LH.Artifacts.ComputedContext) => Promise<import("../../types.js").Gatherer.Simulation.Simulator>;
 };
 declare class LoadSimulator {
     /**

package/core/computed/metrics/first-contentful-paint-all-frames.d.ts

@@ -1,6 +1,6 @@
 export { FirstContentfulPaintAllFramesComputed as FirstContentfulPaintAllFrames };
 declare const FirstContentfulPaintAllFramesComputed: typeof FirstContentfulPaintAllFrames & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class FirstContentfulPaintAllFrames extends NavigationMetric {
     /**

package/core/computed/metrics/first-contentful-paint.d.ts

@@ -1,6 +1,6 @@
 export { FirstContentfulPaintComputed as FirstContentfulPaint };
 declare const FirstContentfulPaintComputed: typeof FirstContentfulPaint & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 declare class FirstContentfulPaint extends NavigationMetric {
     /**

package/core/computed/metrics/interactive.d.ts

@@ -10,7 +10,7 @@ export type TimePeriod = {
     end: number;
 };
 declare const InteractiveComputed: typeof Interactive & {
-    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.Metric | import("../../index.js").Artifacts.LanternMetric>;
+    request: (dependencies: import("../../index.js").Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext) => Promise<import("../../index.js").Artifacts.LanternMetric | import("../../index.js").Artifacts.Metric>;
 };
 /**
  * @fileoverview Computes "Time To Interactive", the time at which the page has loaded critical

package/core/computed/metrics/lantern-metric.d.ts

@@ -3,8 +3,8 @@
  * @param {LH.Artifacts.ComputedContext} context
  */
 export function getComputationDataParamsFromTrace(data: LH.Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext): Promise<{
-    simulator: import("../../../types/gatherer.js").default.Simulation.Simulator;
-    graph: import("../../../types/gatherer.js").default.Simulation.GraphNode;
+    simulator: import("../../../types.js").Gatherer.Simulation.Simulator;
+    graph: import("../../../types.js").Gatherer.Simulation.GraphNode;
     processedNavigation: Lantern.Types.Simulation.ProcessedNavigation;
 }>;
 /**
@@ -12,8 +12,8 @@ export function getComputationDataParamsFromTrace(data: LH.Artifacts.MetricCompu
  * @param {LH.Artifacts.ComputedContext} context
  */
 export function getComputationDataParamsFromDevtoolsLog(data: LH.Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext): Promise<{
-    simulator: import("../../../types/gatherer.js").default.Simulation.Simulator;
-    graph: import("../../../types/gatherer.js").default.Simulation.GraphNode;
+    simulator: import("../../../types.js").Gatherer.Simulation.Simulator;
+    graph: import("../../../types.js").Gatherer.Simulation.GraphNode;
     processedNavigation: import("../../index.js").Artifacts.ProcessedNavigation;
 }>;
 /**
@@ -21,8 +21,8 @@ export function getComputationDataParamsFromDevtoolsLog(data: LH.Artifacts.Metri
  * @param {LH.Artifacts.ComputedContext} context
  */
 export function getComputationDataParams(data: LH.Artifacts.MetricComputationDataInput, context: LH.Artifacts.ComputedContext): Promise<{
-    simulator: import("../../../types/gatherer.js").default.Simulation.Simulator;
-    graph: import("../../../types/gatherer.js").default.Simulation.GraphNode;
+    simulator: import("../../../types.js").Gatherer.Simulation.Simulator;
+    graph: import("../../../types.js").Gatherer.Simulation.GraphNode;
     processedNavigation: Lantern.Types.Simulation.ProcessedNavigation;
 }>;
 /**