@lwc/synthetic-shadow 9.3.6 → 9.4.0

package/dist/index.cjs

@@ -194,7 +194,7 @@ const KEY__SHADOW_TOKEN_PRIVATE = '$$ShadowTokenKey$$';
 const KEY__SYNTHETIC_MODE = '$$lwc-synthetic-mode';
 const KEY__NATIVE_GET_ELEMENT_BY_ID = '$nativeGetElementById$';
 const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
-/** version: 9.3.6 */
+/** version: 9.4.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -202,7 +202,7 @@ const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
 if (!globalThis.lwcRuntimeFlags) {
     Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
 }
-/** version: 9.3.6 */
+/** version: 9.4.0 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -852,6 +852,9 @@ StaticNodeList.prototype = create(NodeList.prototype, {
         enumerable: true,
         configurable: true,
         value(index) {
+            if (!Items$1.has(this) && !lwcRuntimeFlags.ENABLE_LEGACY_ITEM_POLYFILL) {
+                throw new TypeError('Cannot call "item" on object that is not a NodeList.');
+            }
             return this[index];
         },
     },
@@ -1032,6 +1035,9 @@ StaticHTMLCollection.prototype = create(HTMLCollection.prototype, {
         enumerable: true,
         configurable: true,
         value(index) {
+            if (!Items.has(this) && !lwcRuntimeFlags.ENABLE_LEGACY_ITEM_POLYFILL) {
+                throw new TypeError('Cannot call "item" on object that is not an HTMLCollection.');
+            }
             return this[index];
         },
     },
@@ -1053,7 +1059,7 @@ StaticHTMLCollection.prototype = create(HTMLCollection.prototype, {
             }
             const items = Items.get(this);
             for (let i = 0, len = items.length; i < len; i++) {
-                const item = items[len];
+                const item = items[lwcRuntimeFlags.ENABLE_BROKEN_HTML_COLLECTION_NAMED_ITEM ? len : i];
                 if (name === getAttribute.call(item, 'id') ||
                     name === getAttribute.call(item, 'name')) {
                     return item;
@@ -1805,6 +1811,9 @@ function containsPatched(otherNode) {
     return ((compareDocumentPosition.call(host, otherNode) & DOCUMENT_POSITION_CONTAINED_BY) !== 0 &&
         isNodeOwnedBy(host, otherNode));
 }
+function disallowedGetElementById() {
+    throw new Error(`Disallowed method "getElementById" on ShadowRoot.`);
+}
 const SyntheticShadowRootDescriptors = {
     constructor: {
         writable: true,
@@ -2196,12 +2205,24 @@ const ParentNodePatchDescriptors = {
             return children.item(children.length - 1) || null;
         },
     },
+    // An accessor, unlike the other stubs, so the flag is read at call time (not at import) and the
+    // setter preserves `root.getElementById = fn`. The flag exposes it as `undefined` so callers
+    // that value-detect it fall back to `querySelector`; default OFF keeps the throwing stub.
     getElementById: {
-        writable: true,
         enumerable: true,
         configurable: true,
-        value() {
-            throw new Error('Disallowed method "getElementById" on ShadowRoot.');
+        get() {
+            return lwcRuntimeFlags.ENABLE_SHADOW_ROOT_UNDEFINED_GET_ELEMENT_BY_ID
+                ? undefined
+                : disallowedGetElementById;
+        },
+        set(value) {
+            defineProperty(this, 'getElementById', {
+                writable: true,
+                enumerable: true,
+                configurable: true,
+                value,
+            });
         },
     },
     querySelector: {
@@ -4338,6 +4359,6 @@ defineProperty(Element.prototype, '$domManual$', {
     },
     configurable: true,
 });
-/** version: 9.3.6 */
+/** version: 9.4.0 */
 }
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -192,7 +192,7 @@ const KEY__SHADOW_TOKEN_PRIVATE = '$$ShadowTokenKey$$';
 const KEY__SYNTHETIC_MODE = '$$lwc-synthetic-mode';
 const KEY__NATIVE_GET_ELEMENT_BY_ID = '$nativeGetElementById$';
 const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
-/** version: 9.3.6 */
+/** version: 9.4.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -200,7 +200,7 @@ const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
 if (!globalThis.lwcRuntimeFlags) {
     Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
 }
-/** version: 9.3.6 */
+/** version: 9.4.0 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -850,6 +850,9 @@ StaticNodeList.prototype = create(NodeList.prototype, {
         enumerable: true,
         configurable: true,
         value(index) {
+            if (!Items$1.has(this) && !lwcRuntimeFlags.ENABLE_LEGACY_ITEM_POLYFILL) {
+                throw new TypeError('Cannot call "item" on object that is not a NodeList.');
+            }
             return this[index];
         },
     },
@@ -1030,6 +1033,9 @@ StaticHTMLCollection.prototype = create(HTMLCollection.prototype, {
         enumerable: true,
         configurable: true,
         value(index) {
+            if (!Items.has(this) && !lwcRuntimeFlags.ENABLE_LEGACY_ITEM_POLYFILL) {
+                throw new TypeError('Cannot call "item" on object that is not an HTMLCollection.');
+            }
             return this[index];
         },
     },
@@ -1051,7 +1057,7 @@ StaticHTMLCollection.prototype = create(HTMLCollection.prototype, {
             }
             const items = Items.get(this);
             for (let i = 0, len = items.length; i < len; i++) {
-                const item = items[len];
+                const item = items[lwcRuntimeFlags.ENABLE_BROKEN_HTML_COLLECTION_NAMED_ITEM ? len : i];
                 if (name === getAttribute.call(item, 'id') ||
                     name === getAttribute.call(item, 'name')) {
                     return item;
@@ -1803,6 +1809,9 @@ function containsPatched(otherNode) {
     return ((compareDocumentPosition.call(host, otherNode) & DOCUMENT_POSITION_CONTAINED_BY) !== 0 &&
         isNodeOwnedBy(host, otherNode));
 }
+function disallowedGetElementById() {
+    throw new Error(`Disallowed method "getElementById" on ShadowRoot.`);
+}
 const SyntheticShadowRootDescriptors = {
     constructor: {
         writable: true,
@@ -2194,12 +2203,24 @@ const ParentNodePatchDescriptors = {
             return children.item(children.length - 1) || null;
         },
     },
+    // An accessor, unlike the other stubs, so the flag is read at call time (not at import) and the
+    // setter preserves `root.getElementById = fn`. The flag exposes it as `undefined` so callers
+    // that value-detect it fall back to `querySelector`; default OFF keeps the throwing stub.
     getElementById: {
-        writable: true,
         enumerable: true,
         configurable: true,
-        value() {
-            throw new Error('Disallowed method "getElementById" on ShadowRoot.');
+        get() {
+            return lwcRuntimeFlags.ENABLE_SHADOW_ROOT_UNDEFINED_GET_ELEMENT_BY_ID
+                ? undefined
+                : disallowedGetElementById;
+        },
+        set(value) {
+            defineProperty(this, 'getElementById', {
+                writable: true,
+                enumerable: true,
+                configurable: true,
+                value,
+            });
         },
     },
     querySelector: {
@@ -4336,6 +4357,6 @@ defineProperty(Element.prototype, '$domManual$', {
     },
     configurable: true,
 });
-/** version: 9.3.6 */
+/** version: 9.4.0 */
 }
 //# sourceMappingURL=index.js.map

package/package.json

@@ -4,7 +4,7 @@
         "You can safely modify dependencies, devDependencies, keywords, etc., but other props will be overwritten."
     ],
     "name": "@lwc/synthetic-shadow",
-    "version": "9.3.6",
+    "version": "9.4.0",
     "description": "Synthetic Shadow Root for LWC",
     "keywords": [
         "lwc"
@@ -51,8 +51,8 @@
         }
     },
     "devDependencies": {
-        "@lwc/features": "9.3.6",
-        "@lwc/shared": "9.3.6"
+        "@lwc/features": "9.4.0",
+        "@lwc/shared": "9.4.0"
     },
     "lwc": {
         "modules": [