feat: add PhpDocNode.getSealedTagValues() (v2.2 sync)

Add getSealedTagValues() method to PhpDocNode for retrieving
@phpstan-sealed and @psalm-inheritors tag values, matching
upstream v2.2.0 API.

Author: rainx

src/phpdoc-parser/ast/php-doc/php-doc-node.ts

@@ -9,6 +9,7 @@ import { PhpDocTagNode } from './php-doc-tag-node';
 import type { PhpDocTagValueNode } from './php-doc-tag-value-node';
 import { PropertyTagValueNode } from './property-tag-value-node';
 import { ReturnTagValueNode } from './return-tag-value-node';
+import { SealedTagValueNode } from './sealed-tag-value-node';
 import { TemplateTagValueNode } from './template-tag-value-node';
 import { ThrowsTagValueNode } from './throws-tag-value-node';
 import { TypelessParamTagValueNode } from './typeless-param-tag-value-node';
@@ -135,6 +136,17 @@ export class PhpDocNode extends BaseNode {
       );
   }
 
+  public getSealedTagValues(
+    tagName = '@phpstan-sealed',
+  ): SealedTagValueNode[] {
+    return this.getTagsByName(tagName)
+      .map((tag) => tag.value)
+      .filter(
+        (value: PhpDocTagValueNode): value is SealedTagValueNode =>
+          value instanceof SealedTagValueNode,
+      );
+  }
+
   public getDeprecatedTagValues(): DeprecatedTagValueNode[] {
     return this.getTagsByName('@deprecated')
       .map((tag) => tag.value)

tests/parser/upstream-2024-features.test.ts

@@ -11,6 +11,7 @@ import {
   ParamClosureThisTagValueNode,
   ParamImmediatelyInvokedCallableTagValueNode,
   ParamLaterInvokedCallableTagValueNode,
+  PhpDocNode,
   PhpDocParser,
   PureUnlessCallableIsImpureTagValueNode,
   RequireExtendsTagValueNode,
@@ -112,6 +113,41 @@ describe('Upstream 2024 Features', () => {
     });
   });
 
+  describe('PhpDocNode.getSealedTagValues()', () => {
+    it('should return sealed tag values', () => {
+      const lexer = new Lexer();
+      const constExprParser = new ConstExprParser();
+      const typeParser = new TypeParser(constExprParser);
+      const phpDocParser = new PhpDocParser(typeParser, constExprParser);
+
+      const tokens = new TokenIterator(
+        lexer.tokenize('/** @phpstan-sealed ChildA|ChildB */'),
+      );
+
+      const phpDoc = phpDocParser.parse(tokens);
+      const sealedValues = phpDoc.getSealedTagValues();
+      expect(sealedValues).toHaveLength(1);
+      expect(sealedValues[0]).toBeInstanceOf(SealedTagValueNode);
+      expect(sealedValues[0].type).toBeInstanceOf(UnionTypeNode);
+    });
+
+    it('should return sealed tag values for @psalm-inheritors', () => {
+      const lexer = new Lexer();
+      const constExprParser = new ConstExprParser();
+      const typeParser = new TypeParser(constExprParser);
+      const phpDocParser = new PhpDocParser(typeParser, constExprParser);
+
+      const tokens = new TokenIterator(
+        lexer.tokenize('/** @psalm-inheritors ChildA|ChildB */'),
+      );
+
+      const phpDoc = phpDocParser.parse(tokens);
+      const sealedValues = phpDoc.getSealedTagValues('@psalm-inheritors');
+      expect(sealedValues).toHaveLength(1);
+      expect(sealedValues[0]).toBeInstanceOf(SealedTagValueNode);
+    });
+  });
+
   describe('@psalm-inheritors tag', () => {
     it('should parse @psalm-inheritors tag with type', () => {
       const lexer = new Lexer();