lighthouse 13.1.0 → 13.2.0

package/cli/bin.js

@@ -107,6 +107,11 @@ async function begin() {
     cliFlags.precomputedLanternData = data;
   }
 
+  if (!Array.isArray(cliFlags.chromeFlags)) {
+    cliFlags.chromeFlags = [cliFlags.chromeFlags];
+  }
+  cliFlags.chromeFlags.push('--enable-features=DevToolsWebMCPSupport');
+
   // By default, cliFlags.enableErrorReporting is undefined so the user is
   // prompted. This can be overridden with an explicit flag or by the cached
   // answer returned by askPermission().

package/core/audits/accessibility/autocomplete-valid.d.ts

@@ -0,0 +1,10 @@
+export default AutocompleteValid;
+declare class AutocompleteValid extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=autocomplete-valid.d.ts.map

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

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures the autocomplete attribute is correct and suitable for the form field.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if all form fields have valid autocomplete attributes. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: '`autocomplete` attributes are used correctly',
+  /** Title of an accessibility audit that evaluates if all form fields have valid autocomplete attributes. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: '`autocomplete` attributes are not used correctly',
+  /** 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 `autocomplete` attribute values must be valid and correctly applied for ' +
+      'screen readers to function correctly. ' +
+      '[Learn more about valid autocomplete values](https://dequeuniversity.com/rules/axe/4.11/autocomplete-valid).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class AutocompleteValid extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'autocomplete-valid',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default AutocompleteValid;
+export {UIStrings};

package/core/audits/accessibility/presentation-role-conflict.d.ts

@@ -0,0 +1,10 @@
+export default PresentationRoleConflict;
+declare class PresentationRoleConflict extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=presentation-role-conflict.d.ts.map

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

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures elements which are marked to be removed from the accessibility tree are in fact removed.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if elements with presentation role have conflicts. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: 'Elements with `role="none"` or `role="presentation"` do not have conflicts',
+  /** Title of an accessibility audit that evaluates if elements with presentation role have conflicts. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: 'Elements with `role="none"` or `role="presentation"` have conflicts',
+  /** 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: 'There are certain cases where the semantic role of an element with `role="none"` ' +
+      '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).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class PresentationRoleConflict extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'presentation-role-conflict',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default PresentationRoleConflict;
+export {UIStrings};

package/core/audits/accessibility/svg-img-alt.d.ts

@@ -0,0 +1,10 @@
+export default SvgImgAlt;
+declare class SvgImgAlt extends AxeAudit {
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+}
+import AxeAudit from './axe-audit.js';
+//# sourceMappingURL=svg-img-alt.d.ts.map

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

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+/**
+ * @fileoverview Ensures SVG elements with an img role have an accessible text alternative.
+ * See base class in axe-audit.js for audit() implementation.
+ */
+
+import AxeAudit from './axe-audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title of an accessibility audit that evaluates if SVG elements with an img role have an accessible text alternative. This title is descriptive of the successful state and is shown to users when no user action is required. */
+  title: 'SVG elements with an `img` role have an accessible text alternative',
+  /** Title of an accessibility audit that evaluates if SVG elements with an img role have an accessible text alternative. This title is descriptive of the failing state and is shown to users when there is a failure that needs to be addressed. */
+  failureTitle: 'SVG elements with an `img` role do not have an accessible text alternative',
+  /** 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).',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class SvgImgAlt extends AxeAudit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'svg-img-alt',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+}
+
+export default SvgImgAlt;
+export {UIStrings};

package/core/audits/agentic/agent-accessibility-tree.d.ts

@@ -0,0 +1,19 @@
+export default AgentAccessibilityTree;
+declare class AgentAccessibilityTree extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+    let columnRule: string;
+    let columnElement: string;
+    let failedSectionTitle: string;
+    let displayValuePassed: string;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=agent-accessibility-tree.d.ts.map

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

@@ -0,0 +1,115 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {Audit} from '../audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+const UIStrings = {
+  /** Title shown when all agent accessibility checks pass. */
+  title: 'Accessibility tree is well-formed',
+  /** 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 ' +
+    'navigate and interact with the page.',
+  /** Label of a table column that identifies the accessibility rule that failed. */
+  columnRule: 'Failing Rule',
+  /** Label of a table column that identifies the HTML element that failed the rule. */
+  columnElement: 'Failing Element',
+  /** Title of the section containing failed accessibility checks. */
+  failedSectionTitle: 'Failed Audits',
+  /** Message shown when all accessibility checks pass. */
+  displayValuePassed: 'All audits passed',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+const TARGET_RULES = new Set([
+  'button-name',
+  'input-button-name',
+  'input-image-alt',
+  'label',
+  'link-name',
+  'select-name',
+  'document-title',
+  'aria-allowed-attr',
+  'aria-allowed-role',
+  'aria-command-name',
+  'aria-conditional-attr',
+  'aria-dialog-name',
+  'aria-hidden-body',
+  'aria-hidden-focus',
+  'aria-input-field-name',
+  'aria-prohibited-attr',
+  'aria-required-attr',
+  'aria-required-children',
+  'aria-required-parent',
+  'aria-roles',
+  'aria-text',
+  'aria-toggle-field-name',
+  'aria-tooltip-name',
+  'aria-treeitem-name',
+  'aria-valid-attr',
+  'aria-valid-attr-value',
+  'duplicate-id-aria',
+  'definition-list',
+  'table-duplicate-name',
+  'tabindex',
+  'autocomplete-valid',
+  'presentation-role-conflict',
+  'svg-img-alt',
+]);
+
+class AgentAccessibilityTree extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'agent-accessibility-tree',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Accessibility'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @return {LH.Audit.Product}
+   */
+  static audit(artifacts) {
+    const violations = (artifacts.Accessibility && artifacts.Accessibility.violations) || [];
+    const failedRules = violations.filter(v => TARGET_RULES.has(v.id));
+
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'description', valueType: 'text', label: str_(i18n.UIStrings.columnDescription)},
+      {key: 'node', valueType: 'node', label: str_(UIStrings.columnElement)},
+    ];
+
+    const items = failedRules.map(rule => ({
+      description: rule.help || rule.description,
+      node: rule.nodes?.[0] ? Audit.makeNodeItem(rule.nodes[0].node) : undefined,
+    }));
+
+    const listItems = [];
+
+    if (items.length > 0) {
+      const table = Audit.makeTableDetails(headings, items);
+      listItems.push(Audit.makeListDetailSectionItem(table, str_(UIStrings.failedSectionTitle)));
+    }
+
+    return {
+      score: Number(items.length === 0),
+      details: listItems.length > 0 ? Audit.makeListDetails(listItems) : undefined,
+      displayValue: items.length === 0 ? str_(UIStrings.displayValuePassed) : undefined,
+    };
+  }
+}
+
+export default AgentAccessibilityTree;
+export {UIStrings};

package/core/audits/agentic/llms-txt.d.ts

@@ -0,0 +1,20 @@
+export default LlmsTxt;
+declare class LlmsTxt extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let failureTitle: string;
+    let description: string;
+    let displayValueHttpBadCode: string;
+    let explanation: string;
+    let missingH1: string;
+    let tooShort: string;
+    let missingLinks: string;
+}
+import { Audit } from '../audit.js';
+//# sourceMappingURL=llms-txt.d.ts.map

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

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {Audit} from '../audit.js';
+import * as i18n from '../../lib/i18n/i18n.js';
+
+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/).',
+  /**
+   * @description Label for the audit identifying that the request failed with a specific HTTP status code.
+   * @example {500} statusCode
+   * */
+  displayValueHttpBadCode: 'Failed with HTTP status {statusCode}',
+  /** Explanatory message stating that there was a failure in an audit caused by Lighthouse not being able to download the llms.txt file for the site.  Note: "llms.txt" is a canonical filename and should not be translated. */
+  explanation: 'Fetch of llms.txt failed',
+  /** Message indicating that the file is missing a required H1 header. */
+  missingH1: 'File is missing a required H1 header (e.g., "# Title").',
+  /** Message indicating that the file is suspiciously short. */
+  tooShort: 'File is suspiciously short.',
+  /** Message indicating that the file is missing links. */
+  missingLinks: 'File does not appear to contain any links.',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class LlmsTxt extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'llms-txt',
+      title: str_(UIStrings.title),
+      failureTitle: str_(UIStrings.failureTitle),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['LlmsTxt'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @return {LH.Audit.Product}
+   */
+  static audit(artifacts) {
+    const {
+      status,
+      content,
+    } = artifacts.LlmsTxt;
+
+    if (!status) {
+      return {
+        score: 0,
+        explanation: str_(UIStrings.explanation),
+      };
+    }
+
+    if (status >= HTTP_SERVER_ERROR_CODE_LOW) {
+      return {
+        score: 0,
+        displayValue: str_(UIStrings.displayValueHttpBadCode, {statusCode: status}),
+      };
+    } else if (status >= HTTP_CLIENT_ERROR_CODE_LOW) {
+      return {
+        score: 1,
+        notApplicable: true,
+      };
+    }
+
+    if (content === null) {
+      throw new Error(`Status ${status} was valid, but content was null`);
+    }
+
+    const hasH1 = /^#\s+.+/m.test(content);
+    const hasLink = /\[.+\]\(.+\)/.test(content);
+    const isTooShort = content.length < 50;
+
+    const errors = [];
+    if (!hasH1) errors.push(str_(UIStrings.missingH1));
+    if (!hasLink) errors.push(str_(UIStrings.missingLinks));
+    if (isTooShort) errors.push(str_(UIStrings.tooShort));
+
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'message', valueType: 'text', label: 'Error'},
+    ];
+
+    const details = Audit.makeTableDetails(headings, errors.map(m => ({message: m})));
+
+    return {
+      score: Number(errors.length === 0),
+      details: errors.length ? details : undefined,
+    };
+  }
+}
+
+export default LlmsTxt;
+export {UIStrings};

package/core/audits/insights/insight-audit.d.ts

@@ -11,11 +11,11 @@ export type CreateDetailsExtras = {
  * @param {LH.Artifacts} artifacts
  * @param {LH.Audit.Context} context
  * @param {T} insightName
- * @param {(insight: import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T], extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
+ * @param {(insight: NonNullable<import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T]>, extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
  * @template {keyof import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModelsType} T
  * @return {Promise<LH.Audit.Product>}
  */
-export function adaptInsightToAuditProduct<T extends keyof import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModelsType>(artifacts: LH.Artifacts, context: LH.Audit.Context, insightName: T, createDetails: (insight: import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModels[T], extras: CreateDetailsExtras) => {
+export function adaptInsightToAuditProduct<T extends keyof import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModelsType>(artifacts: LH.Artifacts, context: LH.Audit.Context, insightName: T, createDetails: (insight: NonNullable<import("@paulirish/trace_engine/models/trace/insights/types.js").InsightModels[T]>, extras: CreateDetailsExtras) => {
     details: LH.Audit.Details;
     warnings?: Array<string | LH.IcuMessage>;
     numericValue?: number;

package/core/audits/insights/insight-audit.js

@@ -27,8 +27,10 @@ async function getInsightSet(artifacts, context) {
     await TraceEngineResult.request({trace, settings, SourceMaps, HostDPR}, context);
 
   const navigationId = processedTrace.timeOriginEvt.args.data?.navigationId;
-  const key = navigationId ?? NO_NAVIGATION;
-  const insights = traceEngineResult.insights.get(key);
+  const insights = navigationId ?
+    [...traceEngineResult.insights.values()]
+      .find(insightSet => insightSet.navigation?.args.data?.navigationId) :
+    traceEngineResult.insights.get(NO_NAVIGATION);
 
   return {insights, data: traceEngineResult.data};
 }
@@ -43,7 +45,7 @@ async function getInsightSet(artifacts, context) {
  * @param {LH.Artifacts} artifacts
  * @param {LH.Audit.Context} context
  * @param {T} insightName
- * @param {(insight: import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T], extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
+ * @param {(insight: NonNullable<import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModels[T]>, extras: CreateDetailsExtras) => {details: LH.Audit.Details, warnings?: Array<string | LH.IcuMessage>, numericValue?: number, numericUnit?: LH.Audit.NumericProduct['numericUnit']}|LH.Audit.Details|undefined} createDetails
  * @template {keyof import('@paulirish/trace_engine/models/trace/insights/types.js').InsightModelsType} T
  * @return {Promise<LH.Audit.Product>}
  */
@@ -56,11 +58,19 @@ async function adaptInsightToAuditProduct(artifacts, context, insightName, creat
     };
   }
 
+  const error = insights.modelErrors[insightName];
+  if (error) {
+    return {
+      errorMessage: error.message,
+      errorStack: error.stack,
+      score: null,
+    };
+  }
+
   const insight = insights.model[insightName];
-  if (insight instanceof Error) {
+  if (!insight) {
     return {
-      errorMessage: insight.message,
-      errorStack: insight.stack,
+      scoreDisplayMode: Audit.SCORING_MODES.NOT_APPLICABLE,
       score: null,
     };
   }

package/core/audits/layout-shifts.js

@@ -73,7 +73,7 @@ class LayoutShifts extends Audit {
       layoutShifts: new Map(),
     };
     for (const insightSet of traceEngineResult.insights.values()) {
-      for (const [shift, reasons] of insightSet.model.CLSCulprits.shifts) {
+      for (const [shift, reasons] of insightSet.model.CLSCulprits?.shifts ?? []) {
         allRootCauses.layoutShifts.set(shift, reasons);
       }
     }

package/core/audits/server-response-time.js

@@ -51,15 +51,15 @@ class ServerResponseTime extends Audit {
     const {SourceMaps, HostDPR} = artifacts;
     const navInsights =
       await NavigationInsights.request({trace, settings, SourceMaps, HostDPR}, context);
-    const responseTime = navInsights.model.DocumentLatency.data?.serverResponseTime;
-    const url = navInsights.model.DocumentLatency.data?.documentRequest?.args.data.url;
+    const responseTime = navInsights.model.DocumentLatency?.data?.serverResponseTime;
+    const url = navInsights.model.DocumentLatency?.data?.documentRequest?.args.data.url;
 
     if (responseTime === undefined || !url) {
       throw new Error('no timing found for main resource');
     }
 
     const passed =
-      Boolean(navInsights.model.DocumentLatency.data?.checklist.serverResponseIsFast.value);
+      Boolean(navInsights.model.DocumentLatency?.data?.checklist.serverResponseIsFast.value);
     const displayValue = str_(UIStrings.displayValue, {timeInMs: responseTime});
 
     /** @type {LH.Audit.Details.Opportunity['headings']} */

package/core/audits/webmcp-form-coverage.d.ts

@@ -0,0 +1,16 @@
+export default WebMcpFormCoverage;
+declare class WebMcpFormCoverage extends Audit {
+    /**
+     * @param {LH.Artifacts} artifacts
+     * @return {LH.Audit.Product}
+     */
+    static audit(artifacts: LH.Artifacts): LH.Audit.Product;
+}
+export namespace UIStrings {
+    let title: string;
+    let description: string;
+    let displayValue: string;
+    let columnForm: string;
+}
+import { Audit } from './audit.js';
+//# sourceMappingURL=webmcp-form-coverage.d.ts.map

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

@@ -0,0 +1,90 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import {Audit} from './audit.js';
+import * as i18n from '../lib/i18n/i18n.js';
+
+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
+  /** [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}
+    other {# forms missing annotations}
+    }`,
+  /** Label for a column in a data table; entries will be the form element found on the page. */
+  columnForm: 'Form',
+};
+
+const str_ = i18n.createIcuMessageFn(import.meta.url, UIStrings);
+
+class WebMcpFormCoverage extends Audit {
+  /**
+   * @return {LH.Audit.Meta}
+   */
+  static get meta() {
+    return {
+      id: 'webmcp-form-coverage',
+      scoreDisplayMode: Audit.SCORING_MODES.INFORMATIVE,
+      title: str_(UIStrings.title),
+      description: str_(UIStrings.description),
+      requiredArtifacts: ['Inputs', 'WebMCP'],
+      supportedModes: ['navigation', 'snapshot'],
+    };
+  }
+
+  /**
+   * @param {LH.Artifacts} artifacts
+   * @return {LH.Audit.Product}
+   */
+  static audit(artifacts) {
+    const forms = artifacts.Inputs.forms;
+    if (forms.length === 0 || !artifacts.WebMCP.isSupported) {
+      return {
+        notApplicable: true,
+        score: 1,
+      };
+    }
+    const withoutTools = [];
+
+    for (const form of forms) {
+      const hasToolName = !!form.webMcpToolname;
+      const hasToolDescription = !!form.webMcpTooldescription;
+
+      if (!hasToolName && !hasToolDescription) {
+        withoutTools.push({
+          node: Audit.makeNodeItem(form.node),
+        });
+      }
+    }
+
+    if (withoutTools.length === 0) {
+      return {
+        notApplicable: true,
+        score: 1,
+      };
+    }
+
+    /** @type {LH.Audit.Details.Table['headings']} */
+    const headings = [
+      {key: 'node', valueType: 'node', label: str_(UIStrings.columnForm)},
+    ];
+
+    const details = Audit.makeTableDetails(headings, withoutTools);
+
+    return {
+      score: 1,
+      displayValue: str_(UIStrings.displayValue, {itemCount: withoutTools.length}),
+      details,
+    };
+  }
+}
+
+export default WebMcpFormCoverage;
+export {UIStrings};