refactor(core): rename ExperimentalIsolatedShadowDom to IsolatedShadowDom

JeanMeche · AndrewKushnir · commit 6213cbf1a881 · 2025-11-11T08:46:10.000-08:00
This API is still experimental (cherry picked from commit 21ca49c)
diff --git a/goldens/public-api/core/index.api.md b/goldens/public-api/core/index.api.md
@@ -2014,7 +2014,7 @@ export abstract class ViewContainerRef {
 // @public
 export enum ViewEncapsulation {
     Emulated = 0,
-    IsolatedShadowDom = 4,
+    ExperimentalIsolatedShadowDom = 4,
     None = 2,
     ShadowDom = 3
 }
diff --git a/packages/compiler-cli/src/ngtsc/annotations/component/src/handler.ts b/packages/compiler-cli/src/ngtsc/annotations/component/src/handler.ts
@@ -890,7 +890,7 @@ export class ComponentDecoratorHandler
 
     if (
       (encapsulation === ViewEncapsulation.ShadowDom ||
-        encapsulation === ViewEncapsulation.IsolatedShadowDom) &&
+        encapsulation === ViewEncapsulation.ExperimentalIsolatedShadowDom) &&
       metadata.selector !== null
     ) {
       const selectorError = checkCustomElementSelectorForErrors(metadata.selector);
diff --git a/packages/compiler/src/compiler_facade_interface.ts b/packages/compiler/src/compiler_facade_interface.ts
@@ -346,7 +346,7 @@ export enum ViewEncapsulation {
   // Historically the 1 value was for `Native` encapsulation which has been removed as of v11.
   None = 2,
   ShadowDom = 3,
-  IsolatedShadowDom = 4,
+  ExperimentalIsolatedShadowDom = 4,
 }
 
 export type ChangeDetectionStrategy = number;
diff --git a/packages/compiler/src/core.ts b/packages/compiler/src/core.ts
@@ -23,7 +23,7 @@ export enum ViewEncapsulation {
   // Historically the 1 value was for `Native` encapsulation which has been removed as of v11.
   None = 2,
   ShadowDom = 3,
-  IsolatedShadowDom = 4,
+  ExperimentalIsolatedShadowDom = 4,
 }
 
 export enum ChangeDetectionStrategy {
diff --git a/packages/core/src/compiler/compiler_facade_interface.ts b/packages/core/src/compiler/compiler_facade_interface.ts
@@ -346,7 +346,7 @@ export enum ViewEncapsulation {
   // Historically the 1 value was for `Native` encapsulation which has been removed as of v11.
   None = 2,
   ShadowDom = 3,
-  IsolatedShadowDom = 4,
+  ExperimentalIsolatedShadowDom = 4,
 }
 
 export type ChangeDetectionStrategy = number;
diff --git a/packages/core/src/hydration/annotate.ts b/packages/core/src/hydration/annotate.ts
@@ -798,7 +798,7 @@ function componentUsesShadowDomEncapsulation(lView: LView): boolean {
   const def = getComponentDef(instance.constructor);
   return (
     def?.encapsulation === ViewEncapsulation.ShadowDom ||
-    def?.encapsulation === ViewEncapsulation.IsolatedShadowDom
+    def?.encapsulation === ViewEncapsulation.ExperimentalIsolatedShadowDom
   );
 }
 
diff --git a/packages/core/src/metadata/view.ts b/packages/core/src/metadata/view.ts
@@ -20,9 +20,6 @@
  * @publicApi
  */
 export enum ViewEncapsulation {
-  // TODO: consider making `ViewEncapsulation` a `const enum` instead. See
-  // https://github.com/angular/angular/issues/44119 for additional information.
-
   /**
    * Emulates a native Shadow DOM encapsulation behavior by adding a specific attribute to the
    * component's host element and applying the same attribute to all the CSS selectors provided
@@ -54,5 +51,5 @@ export enum ViewEncapsulation {
    *
    * @experimental 21.0
    */
-  IsolatedShadowDom = 4,
+  ExperimentalIsolatedShadowDom = 4,
 }
diff --git a/packages/core/src/render3/hmr.ts b/packages/core/src/render3/hmr.ts
@@ -247,7 +247,7 @@ function recreateLView(
     // with the clone and use it for the newly-created LView.
     if (
       oldDef.encapsulation === ViewEncapsulation.ShadowDom ||
-      oldDef.encapsulation === ViewEncapsulation.IsolatedShadowDom
+      oldDef.encapsulation === ViewEncapsulation.ExperimentalIsolatedShadowDom
     ) {
       const newHost = host.cloneNode(false) as HTMLElement;
       host.replaceWith(newHost);
diff --git a/packages/core/src/render3/instructions/shared.ts b/packages/core/src/render3/instructions/shared.ts
@@ -180,7 +180,7 @@ export function locateHostElement(
   const preserveContent =
     preserveHostContent ||
     encapsulation === ViewEncapsulation.ShadowDom ||
-    encapsulation === ViewEncapsulation.IsolatedShadowDom;
+    encapsulation === ViewEncapsulation.ExperimentalIsolatedShadowDom;
   const rootElement = renderer.selectRootElement(elementOrSelector, preserveContent);
   applyRootElementTransform(rootElement as HTMLElement);
   return rootElement;
diff --git a/packages/platform-browser/src/dom/dom_renderer.ts b/packages/platform-browser/src/dom/dom_renderer.ts
@@ -167,7 +167,7 @@ export class DomRendererFactory2 implements RendererFactory2, OnDestroy {
       typeof ngServerMode !== 'undefined' &&
       ngServerMode &&
       (type.encapsulation === ViewEncapsulation.ShadowDom ||
-        type.encapsulation === ViewEncapsulation.IsolatedShadowDom)
+        type.encapsulation === ViewEncapsulation.ExperimentalIsolatedShadowDom)
     ) {
       // Domino does not support shadow DOM.
       type = {...type, encapsulation: ViewEncapsulation.Emulated};
@@ -224,7 +224,7 @@ export class DomRendererFactory2 implements RendererFactory2, OnDestroy {
             tracingService,
             sharedStylesHost,
           );
-        case ViewEncapsulation.IsolatedShadowDom:
+        case ViewEncapsulation.ExperimentalIsolatedShadowDom:
           return new ShadowDomRenderer(
             eventManager,
             element,
diff --git a/packages/platform-browser/test/dom/dom_renderer_spec.ts b/packages/platform-browser/test/dom/dom_renderer_spec.ts
@@ -502,7 +502,7 @@ class CmpEncapsulationShadow {}
       color: red;
     }`,
   ],
-  encapsulation: ViewEncapsulation.IsolatedShadowDom,
+  encapsulation: ViewEncapsulation.ExperimentalIsolatedShadowDom,
   standalone: false,
 })
 class CmpEncapsulationIsolatedShadowWithChildren {}

Original file line number	Diff line number	Diff line change
`@@ -2014,7 +2014,7 @@ export abstract class ViewContainerRef {`
`2014`	`2014`	`// @public`
`2015`	`2015`	`export enum ViewEncapsulation {`
`2016`	`2016`	`Emulated = 0,`
`2017`		`- IsolatedShadowDom = 4,`
	`2017`	`+ ExperimentalIsolatedShadowDom = 4,`
`2018`	`2018`	`None = 2,`
`2019`	`2019`	`ShadowDom = 3`
`2020`	`2020`	`}`
Original file line number	Diff line number	Diff line change
`@@ -346,7 +346,7 @@ export enum ViewEncapsulation {`
`346`	`346`	// Historically the 1 value was for `Native` encapsulation which has been removed as of v11.
`347`	`347`	`None = 2,`
`348`	`348`	`ShadowDom = 3,`
`349`		`- IsolatedShadowDom = 4,`
	`349`	`+ ExperimentalIsolatedShadowDom = 4,`
`350`	`350`	`}`
`351`	`351`
`352`	`352`	`export type ChangeDetectionStrategy = number;`
Original file line number	Diff line number	Diff line change
`@@ -23,7 +23,7 @@ export enum ViewEncapsulation {`
`23`	`23`	// Historically the 1 value was for `Native` encapsulation which has been removed as of v11.
`24`	`24`	`None = 2,`
`25`	`25`	`ShadowDom = 3,`
`26`		`- IsolatedShadowDom = 4,`
	`26`	`+ ExperimentalIsolatedShadowDom = 4,`
`27`	`27`	`}`
`28`	`28`
`29`	`29`	`export enum ChangeDetectionStrategy {`
Original file line number	Diff line number	Diff line change
`@@ -798,7 +798,7 @@ function componentUsesShadowDomEncapsulation(lView: LView): boolean {`
`798`	`798`	`const def = getComponentDef(instance.constructor);`
`799`	`799`	`return (`
`800`	`800`	`def?.encapsulation === ViewEncapsulation.ShadowDom \|\|`
`801`		`- def?.encapsulation === ViewEncapsulation.IsolatedShadowDom`
	`801`	`+ def?.encapsulation === ViewEncapsulation.ExperimentalIsolatedShadowDom`
`802`	`802`	`);`
`803`	`803`	`}`
`804`	`804`