From 388168a2b8ff0019f5bcbf272cba6f1958975306 Mon Sep 17 00:00:00 2001
From: LuShadowX <supyallukshyadl1@gmail.com>
Date: Thu, 23 Jul 2026 19:31:33 +0530
Subject: [PATCH] Document the preserve and dependencyLists params for
 recordOperation

---
 src/display/canvas_dependency_tracker.js | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/display/canvas_dependency_tracker.js b/src/display/canvas_dependency_tracker.js
index 1cdefc715f489..7929c63590e14 100644
--- a/src/display/canvas_dependency_tracker.js
+++ b/src/display/canvas_dependency_tracker.js
@@ -303,6 +303,10 @@ class CanvasBBoxTracker {
 
   /**
    * @param {number} idx
+   * @param {boolean} [preserve=false] - When false, the pending bounding box is
+   *   cleared once recorded; pass true to keep it for subsequent operations.
+   * @param {Iterable<Iterable<number>>} [dependencyLists] - Groups of operation
+   *   indices whose bounding boxes are also expanded to cover this operation.
    */
   recordOperation(idx, preserve = false, dependencyLists) {
     if (this._pendingBBoxIdx !== idx) {
@@ -735,6 +739,8 @@ class CanvasDependencyTracker {
 
   /**
    * @param {number} idx
+   * @param {boolean} [preserve=false] - When false, the pending dependencies
+   *   are cleared once recorded; pass true to keep them for later operations.
    */
   recordOperation(idx, preserve = false) {
     this.recordDependencies(idx, [FORCED_DEPENDENCY_LABEL]);