Merge remote-tracking branch 'origin/main' into copilot/fix-performance-issues-lazy-define

# Conflicts:
#	src/lazy-define.ts

Author: mattcosta7

docs/Gemfile.lock

@@ -1,8 +1,8 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.8.0)
-      public_suffix (>= 2.0.2, < 5.0)
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
     colorator (1.1.0)
     commonmarker (0.23.10)
     concurrent-ruby (1.1.10)
@@ -80,7 +80,7 @@ GEM
       sawyer (~> 0.8.0, >= 0.5.3)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
-    public_suffix (4.0.7)
+    public_suffix (5.1.1)
     rb-fsevent (0.11.1)
     rb-inotify (0.10.1)
       ffi (~> 1.0)

package-lock.json

@@ -68,6 +68,38 @@ describe('lazyDefine', () => {
       expect(onDefine3).to.have.callCount(1)
     })
 
+    it('coalesces multiple added elements into a single rAF callback', async () => {
+      const onDefine = spy()
+      lazyDefine('coalesce-test-element', onDefine)
+
+      const rafSpy = spy(window, 'requestAnimationFrame')
+      const callsBefore = rafSpy.callCount
+
+      await fixture(html`
+        <div>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+          <coalesce-test-element></coalesce-test-element>
+        </div>
+      `)
+
+      await animationFrame()
+
+      const rafCallsFromScan = rafSpy.callCount - callsBefore
+      rafSpy.restore()
+
+      // Should use at most a few rAF calls, not one per element
+      expect(rafCallsFromScan).to.be.lessThan(5)
+      expect(onDefine).to.be.callCount(1)
+    })
+
     it('lazy loads elements in shadow roots', async () => {
       const onDefine = spy()
       lazyDefine('nested-shadow-element', onDefine)