lighthouse 12.7.0 → 12.7.1-dev.20250702

package/core/computed/trace-engine-result.d.ts

@@ -11,12 +11,12 @@ declare const TraceEngineResultComputed: typeof TraceEngineResult & {
  */
 declare class TraceEngineResult {
     /**
-     * @param {LH.TraceEvent[]} traceEvents
+     * @param {LH.TraceEvent[]} _traceEvents
      * @param {LH.Audit.Context['settings']} settings
      * @param {LH.Artifacts['SourceMaps']} SourceMaps
      * @return {Promise<LH.Artifacts.TraceEngineResult>}
      */
-    static runTraceEngine(traceEvents: LH.TraceEvent[], settings: LH.Audit.Context["settings"], SourceMaps: LH.Artifacts["SourceMaps"]): Promise<LH.Artifacts.TraceEngineResult>;
+    static runTraceEngine(_traceEvents: LH.TraceEvent[], settings: LH.Audit.Context["settings"], SourceMaps: LH.Artifacts["SourceMaps"]): Promise<LH.Artifacts.TraceEngineResult>;
     /**
      * Adapts the given DevTools function that returns a localized string to one
      * that returns a LH.IcuMessage.

package/core/computed/trace-engine-result.js

@@ -19,13 +19,15 @@ import * as LH from '../../types/lh.js';
  */
 class TraceEngineResult {
   /**
-   * @param {LH.TraceEvent[]} traceEvents
+   * @param {LH.TraceEvent[]} _traceEvents
    * @param {LH.Audit.Context['settings']} settings
    * @param {LH.Artifacts['SourceMaps']} SourceMaps
    * @return {Promise<LH.Artifacts.TraceEngineResult>}
    */
-  static async runTraceEngine(traceEvents, settings, SourceMaps) {
+  static async runTraceEngine(_traceEvents, settings, SourceMaps) {
     const processor = new TraceEngine.TraceProcessor(TraceEngine.TraceHandlers);
+    const traceEvents =
+      /** @type {import('@paulirish/trace_engine').Types.Events.Event[]} */ (_traceEvents);
 
     const lanternSettings = {};
     if (settings.throttlingMethod) lanternSettings.throttlingMethod = settings.throttlingMethod;
@@ -34,9 +36,10 @@ class TraceEngineResult {
       lanternSettings.precomputedLanternData = settings.precomputedLanternData;
     }
 
-    await processor.parse(/** @type {import('@paulirish/trace_engine').Types.Events.Event[]} */ (
-      traceEvents
-    ), {
+    // SyntheticEventsManager must be initialized prior to processor.parse().
+    TraceEngine.Helpers.SyntheticEvents.SyntheticEventsManager.createAndActivate(traceEvents);
+
+    await processor.parse(traceEvents, {
       logger: {
         start(id) {
           const logId = `lh:computed:TraceEngineResult:${id}`;

package/core/lib/trace-engine.d.ts

@@ -15,5 +15,6 @@ export type DevToolsIcuMessage = {
 export const TraceProcessor: typeof TraceEngine.Processor.TraceProcessor;
 export const TraceHandlers: typeof TraceEngine.Handlers.ModelHandlers;
 export const Insights: typeof TraceEngine.Insights;
+export const Helpers: typeof TraceEngine.Helpers;
 import * as TraceEngine from '@paulirish/trace_engine';
 //# sourceMappingURL=trace-engine.d.ts.map

package/core/lib/trace-engine.js

@@ -11,9 +11,11 @@ polyfillDOMRect();
 const TraceProcessor = TraceEngine.Processor.TraceProcessor;
 const TraceHandlers = TraceEngine.Handlers.ModelHandlers;
 const Insights = TraceEngine.Insights;
+const Helpers = TraceEngine.Helpers;
 
 export {
   TraceProcessor,
   TraceHandlers,
   Insights,
+  Helpers,
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lighthouse",
   "type": "module",
-  "version": "12.7.0",
+  "version": "12.7.1-dev.20250702",
   "description": "Automated auditing, performance metrics, and best practices for the web.",
   "main": "./core/index.js",
   "bin": {