Method extractClass

src/extraction/tree-sitter.ts:1679–1732

* Extract a class

(node: SyntaxNode, kind: NodeKind = 'class')

   * Extract a class
   */
  private extractClass(node: SyntaxNode, kind: NodeKind = 'class'): void {
    if (!this.extractor) return;

    // Skip forward declarations / elaborated type references (`class Foo;`) in
    // languages that opt in — bodiless there means "not a definition", so it
    // would otherwise mint a phantom node competing with the real definition
    // (#1093). Languages where a bodiless class is complete (Kotlin, Scala)
    // leave the flag unset. Resolved once here and reused for the body walk.
    const resolvedBody = this.extractor.resolveBody?.(node, this.extractor.bodyField)
      ?? getChildByField(node, this.extractor.bodyField);
    if (this.extractor.skipBodilessClass && !resolvedBody) return;

    const name = extractName(node, this.source, this.extractor);
    const docstring = getPrecedingDocstring(node, this.source);
    const visibility = this.extractor.getVisibility?.(node);
    const isExported = this.extractor.isExported?.(node, this.source);

    const classNode = this.createNode(kind, name, node, {
      docstring,
      visibility,
      isExported,
    });
    if (!classNode) return;

    // Extract extends/implements
    this.extractInheritance(node, classNode.id);

    // C# primary-constructor parameter dependencies (`class Svc(IRepo r, …)`).
    this.extractCsharpPrimaryCtorParamRefs(node, classNode.id);

    // Extract decorators applied to the class (`@Foo class X {}`).
    this.extractDecoratorsFor(node, classNode.id);

    // Push to stack and visit body
    this.nodeStack.push(classNode.id);
    const body = resolvedBody ?? node;

    // Visit all children for methods and properties
    for (let i = 0; i < body.namedChildCount; i++) {
      const child = body.namedChild(i);
      if (child) {
        this.visitNode(child);
      }
    }

    // Synthesize compile-time-generated members (Lombok accessors, #912). Runs
    // after the body so the hook can dedup against hand-written members, and
    // while the class is still on the stack so containment/QNs attach.
    if (this.extractor.synthesizeMembers) {
      this.extractor.synthesizeMembers(node, this.makeExtractorContext());
    }

    this.nodeStack.pop();
  }

  /**
   * Extract a method