Expected enclosing nodes to at least contain the root node.

Error message

Expected enclosing nodes to at least contain the root node.

What it means

Error "Expected enclosing nodes to at least contain the root node." thrown in biomejs/biome.

Solutions

This is an internal formatter invariant violation; report it as a Biome bug with the source file that triggered it.
Ensure the node passed to the comments builder belongs to the root's syntax tree.

Example fix

// Report at https://github.com/biomejs/biome/issues with a minimal repro

When it happens

Trigger: Thrown at crates/biome_formatter/src/comments/builder.rs:246 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of biomejs/biome@17a2560fb5 (2026-08-20). Data as JSON: /api/errors/b767346437fec017. Report an issue: GitHub.

Appendix: source

Thrown at crates/biome_formatter/src/comments/builder.rs:251

                self.flush_comments(Some(&following_node.clone()));
            }
            self.following_node_index = None;

            // The following node is only set after entering a node
            // That means, following node is only set for the first token of a node.
            // Unset preceding node if this is the first token because the preceding node belongs to the parent.
            self.preceding_node = None;
        }
    }

    fn enclosing_node(&self) -> &SyntaxNode<Style::Language> {
        let element = match self.following_node_index {
            None => self.parents.last(),
            Some(0) => Some(&self.parents[0]),
            Some(index) => Some(&self.parents[index - 1]),
        };

        element.expect("Expected enclosing nodes to at least contain the root node.")
    }

    fn following_node(&self) -> Option<&SyntaxNode<Style::Language>> {
        self.following_node_index.map(|index| {
            self.parents
                .get(index)
                .expect("Expected following node index to point to a valid parent node")
        })
    }

    fn queue_comment(&mut self, comment: DecoratedComment<Style::Language>) {
        self.pending_comments.push(comment);
    }

    fn update_comments(
        comments: &mut [DecoratedComment<Style::Language>],
        position: CommentTextPosition,
        lines_before: u32,

View on GitHub (pinned to 17a2560fb5)