From 5a8dbc6347b3541e84fe669b22c17ad3b715e258 Mon Sep 17 00:00:00 2001
From: Mitja Felicijan <mitja.felicijan@gmail.com>
Date: Wed, 21 Jan 2026 20:22:09 +0100
Subject: Engage!

---
 .../mitjafelicijan/go-tree-sitter/README.md        | 162 +++++++++++++++++++++
 1 file changed, 162 insertions(+)
 create mode 100644 vendor/github.com/mitjafelicijan/go-tree-sitter/README.md

(limited to 'vendor/github.com/mitjafelicijan/go-tree-sitter/README.md')

diff --git a/vendor/github.com/mitjafelicijan/go-tree-sitter/README.md b/vendor/github.com/mitjafelicijan/go-tree-sitter/README.md
new file mode 100644
index 0000000..333b92b
--- /dev/null
+++ b/vendor/github.com/mitjafelicijan/go-tree-sitter/README.md
@@ -0,0 +1,162 @@
+# go tree-sitter
+
+[![Build Status](https://github.com/mitjafelicijan/go-tree-sitter/workflows/Test/badge.svg?branch=master)](https://github.com/mitjafelicijan/go-tree-sitter/actions/workflows/test.yml?query=branch%3Amaster)
+[![GoDoc](https://godoc.org/github.com/mitjafelicijan/go-tree-sitter?status.svg)](https://godoc.org/github.com/mitjafelicijan/go-tree-sitter)
+
+Golang bindings for [tree-sitter](https://github.com/tree-sitter/tree-sitter)
+
+## Usage
+
+Create a parser with a grammar:
+
+```go
+import (
+	"context"
+	"fmt"
+
+	sitter "github.com/mitjafelicijan/go-tree-sitter"
+	"github.com/mitjafelicijan/go-tree-sitter/javascript"
+)
+
+parser := sitter.NewParser()
+parser.SetLanguage(javascript.GetLanguage())
+```
+
+Parse some code:
+
+```go
+sourceCode := []byte("let a = 1")
+tree, _ := parser.ParseCtx(context.Background(), nil, sourceCode)
+```
+
+Inspect the syntax tree:
+
+```go
+n := tree.RootNode()
+
+fmt.Println(n) // (program (lexical_declaration (variable_declarator (identifier) (number))))
+
+child := n.NamedChild(0)
+fmt.Println(child.Type()) // lexical_declaration
+fmt.Println(child.StartByte()) // 0
+fmt.Println(child.EndByte()) // 9
+```
+
+### Custom grammars
+
+This repository provides grammars for many common languages out of the box.
+
+But if you need support for any other language you can keep it inside your own project or publish it as a separate repository to share with the community. 
+
+See explanation on how to create a grammar for go-tree-sitter [here](https://github.com/mitjafelicijan/go-tree-sitter/issues/57).
+
+Known external grammars:
+
+- [Salesforce grammars](https://github.com/aheber/tree-sitter-sfapex) - including Apex, SOQL, and SOSL languages.
+- [Ruby](https://github.com/shagabutdinov/go-tree-sitter-ruby) - Deprecated, grammar is provided by main repo instead
+- [Go Template](https://github.com/mrjosh/helm-ls/tree/master/internal/tree-sitter/gotemplate) - Used for helm
+
+### Editing
+
+If your source code changes, you can update the syntax tree. This will take less time than the first parse.
+
+```go
+// change 1 -> true
+newText := []byte("let a = true")
+tree.Edit(sitter.EditInput{
+    StartIndex:  8,
+    OldEndIndex: 9,
+    NewEndIndex: 12,
+    StartPoint: sitter.Point{
+        Row:    0,
+        Column: 8,
+    },
+    OldEndPoint: sitter.Point{
+        Row:    0,
+        Column: 9,
+    },
+    NewEndPoint: sitter.Point{
+        Row:    0,
+        Column: 12,
+    },
+})
+
+// check that it changed tree
+assert.True(n.HasChanges())
+assert.True(n.Child(0).HasChanges())
+assert.False(n.Child(0).Child(0).HasChanges()) // left side of the tree didn't change
+assert.True(n.Child(0).Child(1).HasChanges())
+
+// generate new tree
+newTree := parser.Parse(tree, newText)
+```
+
+### Predicates
+
+You can filter AST by using [predicate](https://tree-sitter.github.io/tree-sitter/using-parsers#predicates) S-expressions.
+
+Similar to [Rust](https://github.com/tree-sitter/tree-sitter/tree/master/lib/binding_rust) or [WebAssembly](https://github.com/tree-sitter/tree-sitter/blob/master/lib/binding_web) bindings we support filtering on a few common predicates:
+- `eq?`, `not-eq?`
+- `match?`, `not-match?`
+
+Usage [example](./_examples/predicates/main.go):
+
+```go
+func main() {
+	// Javascript code
+	sourceCode := []byte(`
+		const camelCaseConst = 1;
+		const SCREAMING_SNAKE_CASE_CONST = 2;
+		const lower_snake_case_const = 3;`)
+	// Query with predicates
+	screamingSnakeCasePattern := `(
+		(identifier) @constant
+		(#match? @constant "^[A-Z][A-Z_]+")
+	)`
+
+	// Parse source code
+	lang := javascript.GetLanguage()
+	n, _ := sitter.ParseCtx(context.Background(), sourceCode, lang)
+	// Execute the query
+	q, _ := sitter.NewQuery([]byte(screamingSnakeCasePattern), lang)
+	qc := sitter.NewQueryCursor()
+	qc.Exec(q, n)
+	// Iterate over query results
+	for {
+		m, ok := qc.NextMatch()
+		if !ok {
+			break
+		}
+		// Apply predicates filtering
+		m = qc.FilterPredicates(m, sourceCode)
+		for _, c := range m.Captures {
+			fmt.Println(c.Node.Content(sourceCode))
+		}
+	}
+}
+
+// Output of this program:
+// SCREAMING_SNAKE_CASE_CONST
+```
+
+## Development
+
+### Updating a grammar
+
+Check if any updates for vendored files are available:
+
+```
+go run _automation/main.go check-updates
+```
+
+Update vendor files:
+
+- open `_automation/grammars.json`
+- modify `reference` (for tagged grammars) or `revision` (for grammars from a branch)
+- run `go run _automation/main.go update <grammar-name>`
+
+It is also possible to update all grammars in one go using
+
+```
+go run _automation/main.go update-all
+```
-- 
cgit v1.2.3