@willbooster/tree-sitter-c-sharp 5.0.2 → 6.0.0

package/README.md

@@ -29,12 +29,22 @@ Known gaps:
 
 - `var` and `await` cannot be used as identifiers everywhere they are valid
 
+## Upgrading to version 6
+
+Type tests use `is_pattern_expression`; `is_expression` is no longer emitted. The `lvalue_expression` and
+`non_lvalue_expression` supertypes have been replaced by the shared expression grammar. Update queries to use
+`expression` and the concrete expression nodes. Constant patterns can contain a direct `conditional_access_expression`
+child. Conditional access includes its complete dependent chain and, for conditional assignment, the assignment in its
+`consequence` field. Tuple-shaped patterns such as `x is (1, 2)` use `recursive_pattern` with a
+`positional_pattern_clause` instead of `constant_pattern` with a `tuple_expression`.
+The contextual type names `nint` and `nuint` use `identifier` nodes instead of `predefined_type`.
+
 ## Usage
 
 The npm package ships `tree-sitter-c_sharp.wasm` for
 [@willbooster/web-tree-sitter](https://www.npmjs.com/package/@willbooster/web-tree-sitter), which runs in Node.js, Bun,
 browsers, and Cloudflare Workers. The parser carries the ABI number of WillBooster/tree-sitter, so it loads only with
-that runtime, version 2.0.0 or later; upstream's runtime rejects it. Install the runtime alongside the grammar when using
+that runtime. Use version 2.0.24 or later; upstream's runtime rejects it. Install the runtime alongside the grammar when using
 the Wasm parser; it remains an optional peer for consumers that only use the grammar source or queries.
 
 In Node.js and Bun, load it from the package:
@@ -77,17 +87,17 @@ parser.setLanguage(await Language.load(cSharp));
 ```
 
 The package also ships the queries in `queries/` and the node types in `src/node-types.json`.
-When extending the source grammar, use `grammar.js` and `src/scanner.c` from the same repository release tag.
-Their external directive tokens and serialized scanner state must match.
+When extending the source grammar, use `grammar.js` and the files under `src/` from the same repository release tag.
+Their external tokens and serialized scanner state must match.
 
 In Rust, depend on the [crate](https://crates.io/crates/willbooster-tree-sitter-c-sharp) and on
 [willbooster-tree-sitter](https://crates.io/crates/willbooster-tree-sitter), the runtime this package is tested and
-fuzzed with. The parser requires runtime 2.0.0 or later:
+fuzzed with. Use runtime 2.0.24 or later:
 
 ```toml
 [dependencies]
-tree-sitter = { package = "willbooster-tree-sitter", version = "2.0.0" }
-tree-sitter-c-sharp = { package = "willbooster-tree-sitter-c-sharp", version = "5" }
+tree-sitter = { package = "willbooster-tree-sitter", version = "2.0.24" }
+tree-sitter-c-sharp = { package = "willbooster-tree-sitter-c-sharp", version = "6" }
 ```
 
 ```rust
@@ -112,7 +122,7 @@ runtime this package ships. The first run downloads that CLI from its GitHub Rel
 `cargo` (with the `cmake` that `mise.toml` pins) when the download fails or the release has no binary that runs here.
 
 `bun run generate` records a fresh generation profile from the applicable `test/corpus` cases and Git-tracked
-files in `examples/`, then generates compact parser tables. The parser also embeds metadata from `tree-sitter.json`. After changing a grammar,
+files in `examples/`, then generates compact parser tables. The parser also embeds metadata from `tree-sitter.json`. After changing a grammar, scanner source,
 `tree-sitter.json`, a corpus case, or a tracked example,
 regenerate and commit `src/`. Stage added or removed examples with `git add -A examples` before generation so the profile uses the intended file list.
 Profiles in `.tmp/generation-profiles/` are temporary and must not be committed. `bun run build-wasm`, `bun run build/ci`,