Merge branch 'main' into soft-navs

Author: tunetheweb

.github/workflows/lint.yml

@@ -1,4 +1,6 @@
 name: Lint Code Base
+permissions:
+  contents: read
 on:
   pull_request:
   push:

.github/workflows/tests.yml

@@ -1,4 +1,6 @@
 name: Run tests
+permissions:
+  contents: read
 on:
   pull_request:
   push:

CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+### v5.2.0 (2026-03-25)
+
+- Replace `filter()[0]` with `find()` for better performance ([#658](https://github.com/GoogleChrome/web-vitals/pull/658))
+- Use `queueMicrotask` for microtask scheduling ([#660](https://github.com/GoogleChrome/web-vitals/pull/660))
+- Simplify the event and LoAF entry clean up logic ([#662](https://github.com/GoogleChrome/web-vitals/pull/662))
+- Remove obsolete FID polyfill types ([#675](https://github.com/GoogleChrome/web-vitals/pull/675))
+- Use `LargestContentfulPaint.id` as fallback when element is removed from DOM ([#676](https://github.com/GoogleChrome/web-vitals/pull/676))
+- Fix bug for `onLCP` when attached late ([#697](https://github.com/GoogleChrome/web-vitals/pull/697))
+- FHandle initially hidden pages and onLCP registered on visibility change ([#698](https://github.com/GoogleChrome/web-vitals/pull/698))
+- Ensure we clear idle callbacks in `whenIdleOrHidden` ([#707](https://github.com/GoogleChrome/web-vitals/pull/707))
+- Limit pending events to conserve memory ([#710](https://github.com/GoogleChrome/web-vitals/pull/710))
+- Add `includeProcessedEventEntries` option ([#714](https://github.com/GoogleChrome/web-vitals/pull/714))
+- Reduce bundle size by refactoring ([#713](https://github.com/GoogleChrome/web-vitals/pull/713))
+
 ### v5.1.0 (2025-07-31)
 
 - Register `visibility-change` early ([#637](https://github.com/GoogleChrome/web-vitals/pull/637))

README.md

@@ -727,6 +727,7 @@ Metric-specific subclasses:
 ```ts
 interface INPAttributionReportOpts extends AttributionReportOpts {
   durationThreshold?: number;
+  includeProcessedEventEntries?: boolean;
   reportSoftNavs?: boolean;
 }
 ```
@@ -883,6 +884,15 @@ In the [attribution build](#attribution-build) each of the metric functions has
    onLCP(sendToAnalytics, {generateTarget: customGenerateTarget});
    ```
 
+3. The `onINP` `AttributionReportOpts` supports an additional, optional, `includeProcessedEventEntries` configuration option. When set to `false`, the `event` performance entries will not be included in the `attribution` object to conserve memory if these entries are not needed. The default value is `true`.
+
+```ts
+interface INPAttributionReportOpts extends AttributionReportOpts {
+  durationThreshold?: number;
+  includeProcessedEventEntries?: boolean;
+}
+```
+
 The next sections document the shape of the `attribution` object for each of the metrics:
 
 #### `CLSAttribution`
@@ -999,6 +1009,9 @@ interface INPAttribution {
   /**
    * An array of Event Timing entries that were processed within the same
    * animation frame as the INP candidate interaction.
+   * This array can be quite large so it will be empty if the
+   * `includeProcessedEventEntries` configuration option is set to `false` to
+   * conserve memory if these entries are not required.
    */
   processedEventEntries: PerformanceEventTiming[];
   /**