@spec attach_comments(Lua.AST.Meta.t() | nil, [comment()], comment() | nil) ::
  Lua.AST.Meta.t()

Attaches collected comments to an AST node's meta.

Adds leading comments and optionally a trailing comment.

@spec check_trailing_comment([token()], Lua.AST.Meta.position() | nil) ::
  {comment() | nil, [token()]}

Checks if there's a trailing comment on the same line as the given position.

Returns {maybe_comment, remaining_tokens}. Only captures a comment if it's on the same line as the statement.

@spec collect_leading_comments([token()]) :: {[comment()], [token()]}

Collects leading comments from a token stream.

Returns {collected_comments, remaining_tokens}. Stops collecting when it encounters a non-comment token.

@spec skip_insignificant([token()]) :: [token()]

Skips any whitespace-like tokens (currently just EOF checks). Comments are not skipped here as they need to be processed.