NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #2482 by repository stars
Latest stable
v0.57.0
Last release 12 days ago
09 Nov 2026
Ships on a steady schedule
a new release about every 8 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 months old
1138 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Add a pure-Go command for parsing, queries, highlights, symbols and corpus tests.
grammars.JSONTokenSource, NewJSONTokenSource and NewJSONTokenSourceOrEOF
are removed, and the registry no longer routes json through a token source.
To upgrade, call parser.Parse(src) where you called
ParseWithTokenSource(src, grammars.NewJSONTokenSourceOrEOF(src, lang)), and
parser.ParseIncremental(src, old) for incremental parses. Drop
WithTokenSourceFactory from highlighters and taggers for JSON. Code that
calls entry.TokenSourceFactory(...) without a nil check must check for nil
and fall back to Parse. Trees differ from the old ones on 6 JSON files in the
test corpus, and in each of them only the DFA tree matched C.
Highlight and its incremental and UTF-16 variants no longer return a range
for a spell, nospell, conceal, none, underscore-prefixed or
locals-directive capture. Code that reads a spell, none or underscore
capture from Highlight no longer receives it.
Injected child layers keep their own pattern order on identical spans, as a
standalone file does. Before, a layer lost its pattern indexes and the order of
the matches decided. In a Markdown fence of starlark, { changes from
punctuation.bracket to punctuation.special.
On a span that an injected language and its host both capture, the injected
capture now wins. Before, the host's capture won unless it came from the first
pattern of the host's query.
Queries that set (#set! priority N) now resolve overlaps by priority. Before,
the directive had no effect and the narrower capture won. Sixteen shipped
queries set a priority. In the diff query, the ---, +++, - and +
markers now take diff.minus or diff.plus instead of punctuation.special.
In hare, :outer in break :outer; is one label range where it was a
punctuation.delimiter range and a variable range, and in tablegen, !add is
one function range where it was a punctuation.special range and a
function range.
ExternalVM scanner APIs are removed. Implement a Go
gotreesitter.ExternalScanner instead (#1536).
The grammars facade drops per-language scanner aliases and unused helpers,
including DecodeAndCertifyLanguageBlob. Import grammars/runtime for the
equivalents exported there (#1536).
Replace corpuscheck.RunLanguageLimited with RunLanguageWithOptions and
RunOptions{MaxCases: n} (#1536).
The tsquery command now requires -lang. Supply the registered grammar
name so the query is compiled and validated before code generation
(#1537).
Use gotreesitter test in place of the standalone corpuscheck command.
Corpus mismatches return exit status 1; an empty selection or a requested
language that cannot run returns status 2 (#1524).
Callers can no longer use a nil root to recognize an accepted parse with no
syntax nodes. Check the input itself for an empty byte slice and inspect
HasError() for parse errors (#1543).
Curated and inherited highlight queries change some capture names. Check
themes that map built-in captures to colors (#1539).
Add cmd/scannercert, a report-only tool that replays external scanner calls
from saved state and reports any difference from the live result. It grants no
incremental-reuse approval and changes no scanner capability flag
(#1518).
Add the pure-Go gotreesitter command for parsing, querying, highlighting,
tags, outlines, code patterns and corpus tests. It accepts files or standard
input and supports JSON output (#1524).
Add LangEntry.Parse, NewParser and NewHighlighter helpers that use the
entry's registered token source when one is available (#1537).
Make the highlighter return only captures that name a color. It no longer
returns private captures (a leading underscore), @spell, @nospell,
@conceal, or the directives of a locals query (@local.scope,
@local.reference, @local.definition, @local.definition-value and
@local.definition.*); predicates and directives still read them. @none
clears the colors of its own priority beneath it, including the color of an
enclosing capture of that priority, and is not returned. It does not clear a
capture of a lower priority, so the reset that the Markdown query puts on a
fence leaves the injected language's own colors, such as zig's strings at
priority 95. This follows the convention nvim-treesitter documents for
@none; tree-sitter-highlight and Neovim's own highlighter keep the enclosing
color under an inner @none node. (#set! priority N) sets the priority of a
pattern's captures, with a default of 100. Injected child queries follow the
same rules, and at equal priority an injected capture wins over the host's
capture on the same span. A VHDL comment keeps its @comment color, and a
private capture such as @_key no longer hides the color of its node
(#454).
Remove the BitBake, Corn, DTD, Templ, and Wolfram result-compatibility
arms. None of them rewrote a node on any registered witness, and the trees
on the production, compact, forest, and incremental routes are the same with
the arms removed. ParseRuntime().NormalizationPasses and the
GTS_DISPATCHER_CENSUS output no longer list a dispatch.<language> pass
for these five languages. The five languages are now eligible for
compact-tail elision. The Perl arm stays: it still regroups push @a => ...
arguments the way locked C does.
Reduce YAML parse time and allocation. The YAML scanner caches the current
rune within each request (#1486), prepares its scanner bindings once
(#1491) and keeps indentation type and width in one frame stack (#1514).
The cached-rune change cut legacy YAML parse time by 5.39% (p=.004, 20 pairs);
the prepared bindings cut ordinary YAML parse time by 2.60% (p=.028).
Reduce memory on the compact parse route. Allocated bytes for a fresh 1 MiB
Go parse fall 17.52% (453,602,488 to 374,143,160 B/op, p<.001) because public
subtrees now live in 64K-record blocks (#1504). Graph nodes shrink from 24
to 16 bytes (#1500) and no longer copy the whole arena when it grows
(#1502). Dependency and lexer-history allocations also shrink (#1480);
allocation for a 20 KB query compile falls from 140,563 to 10,512 B. Timing
differences were inconclusive. The compact route is not the default for every
language.
Parse JSON with the grammar's own DFA lexer, and delete its hand-written token
source (grammars/runtime/json_lexer.go). Both paths were compared with the
locked C parser on 303 JSON files: the DFA path matched C on 303 files, and the
token source on 297. No file matched C only through the token source.
LangEntry.TokenSourceFactory is now nil for JSON, so ParseFile,
ParseFilePooled and the other registry helpers use Parser.Parse. The Java
token source stays: it is the only implementation of the end-of-file comment
append proof, and without it typing at the end of a trailing comment in a
Java file runs a hidden fresh parse on every keystroke. C, C++ and authzed
also keep their token sources: C matched C on 4 corpus files where the DFA path
did not, and the C++ token source matches C on a malformed class body that the
DFA path parses without an error.
Compose highlight queries from first-line ; inherits: directives and add
curated query coverage, including Apex, Vue, V, Typst and HLSL. Imported
queries carry source and license attribution (#1539).
Scan YAML comment content in batches (#1567).
Reduce DFA, publication and read-history overhead in certified Go incremental
parsing. Unsupported or unproven reuse retains fresh verification
(#1570).
Publish compact parse results through owned node views and preserve recovery
and scanner-history checks (#1569).
Page compact compatibility snapshots and cap the scrubbed workspace retained
between calls. On the qualified roughly 2 KiB TypeScript fixture, allocated
bytes fell from 167.425 to 3.139 KiB per parse; the separate 1 MiB probe's peak
RSS fell from 294,732 to 165,056 KiB (#1577).
Go: make compact recovery return (source_file (ERROR)) for ,, as the C
parser does. Reuse completed Scala snippet roots, which removes about 17 MB of
allocation for malformed 24-30 byte Scala inputs (#1452).
TypeScript and TSX: parse an async generic arrow such as
async <T>(v: T): Promise<T> => v correctly instead of as a
binary_expression (#1483).
TypeScript and TSX: parse generic tagged template calls such as
tag<string[]>`text` instead of reading them as comparisons or failing
(#1515). This regenerates typescript.bin and tsx.bin.
Generated grammars: keep the span of a consumed hidden newline when a
newline-or-NUL terminator follows (#1513). None of the 206 shipped grammars
takes the changed branch.
32-bit builds: fix a panic when a parser state with the high bit set became a
negative int in a bounds check (#1485).
Compact projection: publish hidden-supertype ancestry and synthetic-root
metadata exactly. The Go supertype query failed before this fix (#1484).
Make: accept builtin names such as $(file) and ${dir} as variable
references, including nested expressions, while preserving function calls
(#1561).
Kotlin: preserve queued reduction alternatives for the certified shipped
grammar, including the generic-call regression cases (#1568).
Accepted parses with no syntax nodes now return a zero-width ERROR root
instead of a nil root, matching locked C on the affected cases (#1543).
Generated C exports for pre-ABI-15 grammars compile against the pinned runtime
headers while retaining the older lexer-mode table layout (#1579).
PowerShell: update the pinned grammar and scanner so native arguments such
as comma lists, bare -- and -, attached option values and trailing &
parse cleanly. The replay preserves the original contributor's work
(#1576, #1574).
Keep trailing comments outside recovered ERROR nodes when an ancestor
recovery path contains a discontinuity (#1580).
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add opt-in Python, JavaScript, TypeScript and TSX declaration, signature and call-argument facts through the existing grammar-owned options. Share sym
Add opt-in Python, JavaScript, TypeScript and TSX declaration, signature and
call-argument facts through the existing grammar-owned options. Share symbol
sets, binding selectors and parameter extraction while preserving Go and
legacy outputs. Include Python unpacking and keyword arguments, JavaScript
named function bindings, TypeScript optional parameters and typed members,
and standalone constructor arguments in JavaScript, TypeScript and TSX.
Type shapes remain types-only; defaults and member modifiers are omitted
(#1435).
Complete opt-in Go declaration facts with embedded fields, interface embeddings
and dotted anonymous-struct containers. Add FactSignatures and
FactCallArguments through parallel grammar-owned rule options, preserving
exact parameter type text and argument order/ranges. Function literals and
function types have no signature facts; other languages remain out of scope
(#1435).
Add opt-in Go declaration facts through NewFactProgramWithOptions,
FactDeclarations, and WithDeclarationRules(grammars.DeclarationRules(entry)).
FactSet.Declarations contains separate package variable and constant names,
named struct fields, explicit interface methods, aliases, type shapes, and
member containers. NewFactProgram, DefinitionSpan, Definitions, and
FactAll retain their existing contracts
(#1435).
Foo[int](Foo[int](a)) matches locked C againERROR roots and children in Node.SExpr even when recovery leavesHasError() when hidden missing tokens are removed from theOn 2026-10-04, the owner authorized the v0.56.0-only tag-creation exception.
The exception permits publication without a workflow-only tag-creation actor rule.
All other gates remain mandatory under
the release process.
This standard minor release still requires full CI and performance evidence for
the exact candidate, a signed receipt, and protected release environment approval.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version