@lwc/synthetic-shadow 9.3.5 → 9.4.0

package/dist/index.cjs

@@ -191,13 +191,10 @@ const KEY__SHADOW_STATIC = '$shadowStaticNode$';
 const KEY__SHADOW_STATIC_PRIVATE = '$shadowStaticNodeKey$';
 const KEY__SHADOW_TOKEN = '$shadowToken$';
 const KEY__SHADOW_TOKEN_PRIVATE = '$$ShadowTokenKey$$';
-// TODO [#3733]: remove support for legacy scope tokens
-const KEY__LEGACY_SHADOW_TOKEN = '$legacyShadowToken$';
-const KEY__LEGACY_SHADOW_TOKEN_PRIVATE = '$$LegacyShadowTokenKey$$';
 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.5 */
+/** version: 9.4.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -205,7 +202,7 @@ const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
 if (!globalThis.lwcRuntimeFlags) {
     Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
 }
-/** version: 9.3.5 */
+/** version: 9.4.0 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -855,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];
         },
     },
@@ -1035,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];
         },
     },
@@ -1056,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;
@@ -1808,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,
@@ -2199,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: {
@@ -4231,40 +4249,6 @@ defineProperty(Element.prototype, KEY__SHADOW_STATIC, {
     configurable: true,
 });
 
-/*
- * Copyright (c) 2023, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: MIT
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
- */
-// TODO [#3733]: remove this entire file when we can remove legacy scope tokens
-function getLegacyShadowToken(node) {
-    return node[KEY__LEGACY_SHADOW_TOKEN];
-}
-function setLegacyShadowToken(node, shadowToken) {
-    node[KEY__LEGACY_SHADOW_TOKEN] = shadowToken;
-}
-/**
- * Patching Element.prototype.$legacyShadowToken$ to mark elements a portal:
- * Same as $shadowToken$ but for legacy CSS scope tokens.
- */
-defineProperty(Element.prototype, KEY__LEGACY_SHADOW_TOKEN, {
-    set(shadowToken) {
-        const oldShadowToken = this[KEY__LEGACY_SHADOW_TOKEN_PRIVATE];
-        if (!isUndefined(oldShadowToken) && oldShadowToken !== shadowToken) {
-            removeAttribute.call(this, oldShadowToken);
-        }
-        if (!isUndefined(shadowToken)) {
-            setAttribute.call(this, shadowToken, '');
-        }
-        this[KEY__LEGACY_SHADOW_TOKEN_PRIVATE] = shadowToken;
-    },
-    get() {
-        return this[KEY__LEGACY_SHADOW_TOKEN_PRIVATE];
-    },
-    configurable: true,
-});
-
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -4282,8 +4266,7 @@ let portalObserver;
 const portalObserverConfig = {
     childList: true,
 };
-// TODO [#3733]: remove support for legacy scope tokens
-function adoptChildNode(node, fn, shadowToken, legacyShadowToken) {
+function adoptChildNode(node, fn, shadowToken) {
     const previousNodeShadowResolver = getShadowRootResolver(node);
     if (previousNodeShadowResolver === fn) {
         return; // nothing to do here, it is already correctly patched
@@ -4291,9 +4274,6 @@ function adoptChildNode(node, fn, shadowToken, legacyShadowToken) {
     setShadowRootResolver(node, fn);
     if (node instanceof Element) {
         setShadowToken(node, shadowToken);
-        if (lwcRuntimeFlags.ENABLE_LEGACY_SCOPE_TOKENS) {
-            setLegacyShadowToken(node, legacyShadowToken);
-        }
         if (isSyntheticShadowHost(node)) {
             // Root LWC elements can't get content slotted into them, therefore we don't observe their children.
             return;
@@ -4305,7 +4285,7 @@ function adoptChildNode(node, fn, shadowToken, legacyShadowToken) {
         // recursively patching all children as well
         const childNodes = childNodesGetter.call(node);
         for (let i = 0, len = childNodes.length; i < len; i += 1) {
-            adoptChildNode(childNodes[i], fn, shadowToken, legacyShadowToken);
+            adoptChildNode(childNodes[i], fn, shadowToken);
         }
     }
 }
@@ -4326,20 +4306,17 @@ function initPortalObserver() {
             // the target of the mutation should always have a ShadowRootResolver attached to it
             const fn = getShadowRootResolver(elm);
             const shadowToken = getShadowToken(elm);
-            const legacyShadowToken = lwcRuntimeFlags.ENABLE_LEGACY_SCOPE_TOKENS
-                ? getLegacyShadowToken(elm)
-                : undefined;
             // Process removals first to handle the case where an element is removed and reinserted
             for (let i = 0, len = removedNodes.length; i < len; i += 1) {
                 const node = removedNodes[i];
                 if (!(compareDocumentPosition.call(elm, node) & _Node.DOCUMENT_POSITION_CONTAINED_BY)) {
-                    adoptChildNode(node, DocumentResolverFn, undefined, undefined);
+                    adoptChildNode(node, DocumentResolverFn, undefined);
                 }
             }
             for (let i = 0, len = addedNodes.length; i < len; i += 1) {
                 const node = addedNodes[i];
                 if (compareDocumentPosition.call(elm, node) & _Node.DOCUMENT_POSITION_CONTAINED_BY) {
-                    adoptChildNode(node, fn, shadowToken, legacyShadowToken);
+                    adoptChildNode(node, fn, shadowToken);
                 }
             }
         });
@@ -4382,6 +4359,6 @@ defineProperty(Element.prototype, '$domManual$', {
     },
     configurable: true,
 });
-/** version: 9.3.5 */
+/** version: 9.4.0 */
 }
 //# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -189,13 +189,10 @@ const KEY__SHADOW_STATIC = '$shadowStaticNode$';
 const KEY__SHADOW_STATIC_PRIVATE = '$shadowStaticNodeKey$';
 const KEY__SHADOW_TOKEN = '$shadowToken$';
 const KEY__SHADOW_TOKEN_PRIVATE = '$$ShadowTokenKey$$';
-// TODO [#3733]: remove support for legacy scope tokens
-const KEY__LEGACY_SHADOW_TOKEN = '$legacyShadowToken$';
-const KEY__LEGACY_SHADOW_TOKEN_PRIVATE = '$$LegacyShadowTokenKey$$';
 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.5 */
+/** version: 9.4.0 */
 
 /**
  * Copyright (c) 2026 Salesforce, Inc.
@@ -203,7 +200,7 @@ const KEY__NATIVE_QUERY_SELECTOR_ALL = '$nativeQuerySelectorAll$';
 if (!globalThis.lwcRuntimeFlags) {
     Object.defineProperty(globalThis, 'lwcRuntimeFlags', { value: create(null) });
 }
-/** version: 9.3.5 */
+/** version: 9.4.0 */
 
 /*
  * Copyright (c) 2018, salesforce.com, inc.
@@ -853,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];
         },
     },
@@ -1033,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];
         },
     },
@@ -1054,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;
@@ -1806,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,
@@ -2197,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: {
@@ -4229,40 +4247,6 @@ defineProperty(Element.prototype, KEY__SHADOW_STATIC, {
     configurable: true,
 });
 
-/*
- * Copyright (c) 2023, salesforce.com, inc.
- * All rights reserved.
- * SPDX-License-Identifier: MIT
- * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/MIT
- */
-// TODO [#3733]: remove this entire file when we can remove legacy scope tokens
-function getLegacyShadowToken(node) {
-    return node[KEY__LEGACY_SHADOW_TOKEN];
-}
-function setLegacyShadowToken(node, shadowToken) {
-    node[KEY__LEGACY_SHADOW_TOKEN] = shadowToken;
-}
-/**
- * Patching Element.prototype.$legacyShadowToken$ to mark elements a portal:
- * Same as $shadowToken$ but for legacy CSS scope tokens.
- */
-defineProperty(Element.prototype, KEY__LEGACY_SHADOW_TOKEN, {
-    set(shadowToken) {
-        const oldShadowToken = this[KEY__LEGACY_SHADOW_TOKEN_PRIVATE];
-        if (!isUndefined(oldShadowToken) && oldShadowToken !== shadowToken) {
-            removeAttribute.call(this, oldShadowToken);
-        }
-        if (!isUndefined(shadowToken)) {
-            setAttribute.call(this, shadowToken, '');
-        }
-        this[KEY__LEGACY_SHADOW_TOKEN_PRIVATE] = shadowToken;
-    },
-    get() {
-        return this[KEY__LEGACY_SHADOW_TOKEN_PRIVATE];
-    },
-    configurable: true,
-});
-
 /*
  * Copyright (c) 2018, salesforce.com, inc.
  * All rights reserved.
@@ -4280,8 +4264,7 @@ let portalObserver;
 const portalObserverConfig = {
     childList: true,
 };
-// TODO [#3733]: remove support for legacy scope tokens
-function adoptChildNode(node, fn, shadowToken, legacyShadowToken) {
+function adoptChildNode(node, fn, shadowToken) {
     const previousNodeShadowResolver = getShadowRootResolver(node);
     if (previousNodeShadowResolver === fn) {
         return; // nothing to do here, it is already correctly patched
@@ -4289,9 +4272,6 @@ function adoptChildNode(node, fn, shadowToken, legacyShadowToken) {
     setShadowRootResolver(node, fn);
     if (node instanceof Element) {
         setShadowToken(node, shadowToken);
-        if (lwcRuntimeFlags.ENABLE_LEGACY_SCOPE_TOKENS) {
-            setLegacyShadowToken(node, legacyShadowToken);
-        }
         if (isSyntheticShadowHost(node)) {
             // Root LWC elements can't get content slotted into them, therefore we don't observe their children.
             return;
@@ -4303,7 +4283,7 @@ function adoptChildNode(node, fn, shadowToken, legacyShadowToken) {
         // recursively patching all children as well
         const childNodes = childNodesGetter.call(node);
         for (let i = 0, len = childNodes.length; i < len; i += 1) {
-            adoptChildNode(childNodes[i], fn, shadowToken, legacyShadowToken);
+            adoptChildNode(childNodes[i], fn, shadowToken);
         }
     }
 }
@@ -4324,20 +4304,17 @@ function initPortalObserver() {
             // the target of the mutation should always have a ShadowRootResolver attached to it
             const fn = getShadowRootResolver(elm);
             const shadowToken = getShadowToken(elm);
-            const legacyShadowToken = lwcRuntimeFlags.ENABLE_LEGACY_SCOPE_TOKENS
-                ? getLegacyShadowToken(elm)
-                : undefined;
             // Process removals first to handle the case where an element is removed and reinserted
             for (let i = 0, len = removedNodes.length; i < len; i += 1) {
                 const node = removedNodes[i];
                 if (!(compareDocumentPosition.call(elm, node) & _Node.DOCUMENT_POSITION_CONTAINED_BY)) {
-                    adoptChildNode(node, DocumentResolverFn, undefined, undefined);
+                    adoptChildNode(node, DocumentResolverFn, undefined);
                 }
             }
             for (let i = 0, len = addedNodes.length; i < len; i += 1) {
                 const node = addedNodes[i];
                 if (compareDocumentPosition.call(elm, node) & _Node.DOCUMENT_POSITION_CONTAINED_BY) {
-                    adoptChildNode(node, fn, shadowToken, legacyShadowToken);
+                    adoptChildNode(node, fn, shadowToken);
                 }
             }
         });
@@ -4380,6 +4357,6 @@ defineProperty(Element.prototype, '$domManual$', {
     },
     configurable: true,
 });
-/** version: 9.3.5 */
+/** 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.5",
+    "version": "9.4.0",
     "description": "Synthetic Shadow Root for LWC",
     "keywords": [
         "lwc"
@@ -51,8 +51,8 @@
         }
     },
     "devDependencies": {
-        "@lwc/features": "9.3.5",
-        "@lwc/shared": "9.3.5"
+        "@lwc/features": "9.4.0",
+        "@lwc/shared": "9.4.0"
     },
     "lwc": {
         "modules": [

package/dist/faux-shadow/legacy-shadow-token.d.ts

@@ -1,3 +0,0 @@
-export declare function getLegacyShadowToken(node: Node): string | undefined;
-export declare function setLegacyShadowToken(node: Node, shadowToken: string | undefined): void;
-//# sourceMappingURL=legacy-shadow-token.d.ts.map