fix(compiler): don't allow shadowRoot getter to avoid hydration issues

Author: christian-bromann

src/compiler/transformers/static-to-meta/component.ts

@@ -148,6 +148,8 @@ export const parseStaticComponentMeta = (
   };
 
   const visitComponentChildNode = (node: ts.Node) => {
+    validateComponentMembers(node);
+
     if (ts.isCallExpression(node)) {
       parseCallExpression(cmp, node);
     } else if (ts.isStringLiteral(node)) {
@@ -176,6 +178,42 @@ export const parseStaticComponentMeta = (
   return cmpNode;
 };
 
+const validateComponentMembers = (node: ts.Node) => {
+  /**
+   * validate if:
+   */
+  if (
+    /**
+     * the component has a getter called "shadowRoot"
+     */
+    ts.isGetAccessorDeclaration(node) &&
+    ts.isIdentifier(node.name) &&
+    node.name.escapedText === 'shadowRoot' &&
+    /**
+     * the parent node is a class declaration
+     */
+    ts.isClassDeclaration(node.parent)
+  ) {
+    const decorator = ts.getDecorators(node.parent)[0];
+    /**
+     * the class is actually a Stencil component, has a decorator with a property named "tag"
+     */
+    if (
+      ts.isCallExpression(decorator.expression) &&
+      decorator.expression.arguments.length === 1 &&
+      ts.isObjectLiteralExpression(decorator.expression.arguments[0]) &&
+      decorator.expression.arguments[0].properties.some(
+        (prop) => ts.isPropertyAssignment(prop) && prop.name.getText() === 'tag',
+      )
+    ) {
+      const componentName = node.parent.name.getText();
+      throw new Error(
+        `The component "${componentName}" has a getter called "shadowRoot". This getter is reserved for use by Stencil components and should not be defined by the user.`,
+      );
+    }
+  }
+};
+
 const parseVirtualProps = (docs: d.CompilerJsDoc) => {
   return docs.tags
     .filter(({ name }) => name === 'virtualProp')

src/compiler/transformers/test/parse-component.spec.ts

@@ -23,4 +23,48 @@ describe('parse component', () => {
 
     expect(t.componentClassName).toBe('CmpA');
   });
+
+  it('can not have shadowRoot getter', () => {
+    let error: Error | undefined;
+    try {
+      transpileModule(`
+        @Component({
+          tag: 'cmp-a'
+        })
+        export class CmpA {
+          get shadowRoot() {
+            return this;
+          }
+        }
+      `);
+    } catch (err: unknown) {
+      error = err as Error;
+    }
+
+    expect(error.message).toContain(
+      `The component "CmpA" has a getter called "shadowRoot". This getter is reserved for use by Stencil components and should not be defined by the user.`,
+    );
+  });
+
+  it('ignores shadowRoot getter in unrelated class', () => {
+    const t = transpileModule(`
+      @Component({
+        tag: 'cmp-a'
+      })
+      export class CmpA {
+        // use a better name for the getter
+        get elementShadowRoot() {
+          return this;
+        }
+      }
+
+      export class Unrelated {
+        get shadowRoot() {
+          return this;
+        }
+      }
+    `);
+
+    expect(t.componentClassName).toBe('CmpA');
+  });
 });