From 52516ee6e6b6f69040c3d4e06cf672c3cf6d233b Mon Sep 17 00:00:00 2001
From: Gaurav Kochar <gauravrkochar@gmail.com>
Date: Fri, 28 Feb 2025 23:30:04 +0530
Subject: [PATCH] docs(engine-core): add comment in patchDynamicEventListeners
 regarding freezing assumption

---
 .../@lwc/engine-core/src/framework/modules/dynamic-events.ts   | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/@lwc/engine-core/src/framework/modules/dynamic-events.ts b/packages/@lwc/engine-core/src/framework/modules/dynamic-events.ts
index 2bbe5ae5dd..9cdcaaeb20 100644
--- a/packages/@lwc/engine-core/src/framework/modules/dynamic-events.ts
+++ b/packages/@lwc/engine-core/src/framework/modules/dynamic-events.ts
@@ -22,6 +22,9 @@ export function patchDynamicEventListeners(
         data: { dynamicOn },
     } = vnode;
 
+    // The argument passed to lwc:on is frozen.
+    // Because of this, `oldVnode.data.dynamicOn` is deeply equal
+    // to its value from the previous render cycle.
     const oldDynamicOn =
         isNull(oldVnode) || isUndefined(oldVnode.data.dynamicOn)
             ? EmptyObject