scriptoriumadmin/GitNexus
1
0
Fork 0
mirror of https://github.com/abhigyanpatwari/GitNexus.git synced 2026-10-18 04:43:36 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10
GitNexus/gitnexus/vendor
History
taoxin 8e7da9d844 feat(languages): add Lua language support 
Add Lua as a supported language with symbol extraction and scope-resolution
at parity with existing languages.

Vendored grammar:
- Vendor tree-sitter-lua (v2.1.3, MIT). Upstream ships nan-based node
  bindings incompatible with the pinned tree-sitter@0.21.1 runtime
  (setLanguage rejects with "Invalid language object"), so the grammar C
  sources are rebuilt against a Napi binding adapted from tree-sitter-c.

Symbol extraction (legacy tree-sitter queries):
- Function, Method, and Class definitions; call sites.

Scope-resolution (CALLS + IMPORTS edges):
- emitScopeCaptures, interpretImport, and a Lua ScopeResolver registered
  in the scope-resolution pipeline.
- Import resolution via a SuffixIndex so root-level modules (e.g.
  require("middleclass")) resolve, not just dotted paths.

Class structure (EXTENDS + HAS_METHOD + METHOD_OVERRIDES):
- middleclass class("Name", Parent) and function Class:method() handled
  via a heritage edge hook (emitHeritageEdges), since middleclass has no
  syntactic class body for the standard heritage/ownership walk.

Registered in all dispatch tables (SupportedLanguages enum, language
detection, parser-loader, parse-worker languageMap, language
classification, scope-resolver registry, vendored-grammar manifest).

Verified: tsc --noEmit clean; analyze on a Lua sample produces Class,
Method, EXTENDS, HAS_METHOD, METHOD_OVERRIDES, IMPORTS, and CALLS.

Co-Authored-By: Claude Sonnet 4 <noreply@anthropic.com>
2026-10-12 17:56:37 +08:00
..
lbug-fts fix(index): guard graph integrity and fail closed on incomplete risk (#3442) 2026-10-02 15:34:26 +01:00
leiden perf(communities): fix the O(communities x N) copy in vendored Leiden, wire Icebug to its real API (#2337) (#2692) 2026-07-25 13:23:17 +01:00
tree-sitter-c fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
tree-sitter-dart fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
tree-sitter-kotlin fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
tree-sitter-lua feat(languages): add Lua language support 2026-10-12 17:56:37 +08:00
tree-sitter-objc fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
tree-sitter-proto fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
tree-sitter-swift fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
tree-sitter-zig fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00
README.md fix(deps): upgrade native tree-sitter to 0.25.1 (#3531) 2026-10-10 13:07:59 +03:00

README.md

Vendored Tree-sitter grammars

These grammars use the bundled Tree-sitter 0.25.1 runtime (ABI 13–15). Generated C sources and scanners must be copied from upstream; never patch them by hand. JavaScript/TypeScript compatibility adapters belong in GitNexus.

Grammar Version / snapshot Upstream source commit
c 0.24.2-gb780e47 b780e47fc780
dart 1.0.0-gbe07cf7 be07cf7118d3
proto 0.6.0-gd7d1542 d7d15427321d
kotlin 0.4.0-g1852ea1 1852ea17b7f6
objc 3.0.2-g181a81b 181a81b8f23a
zig 1.1.2-g6479aa1 6479aa13f32f
swift 0.7.2 7b7909f2f6b9

Swift 0.7.2 is the newest release that passes our declaration-ownership tests. Both 0.7.3 and 0.7.4 move a later top-level struct inside an earlier class after a conditional group splits a function header. That input is invalid Swift, but preserving recovery for partial source is an existing GitNexus contract. The hold in .github/vendored-grammars.json remains until the real-parser and worker-pipeline tests in tree-sitter-languages.test.ts and swift-conditional-directive.test.ts pass with a newer upstream grammar. No generated source was patched to preserve this behavior.

To refresh a grammar:

  1. Resolve an immutable upstream commit (Swift publishes generated sources on *-with-generated-files tags). Copy src/ runtime/build inputs and bindings/node/binding.cc byte-for-byte. Keep the GitNexus CommonJS loader and binding.gyp; upstream C's ESM loader uses top-level await and cannot be substituted into the synchronous worker import path.
  2. Update the vendor package version, _upstreamCommit, _vendoredBy, this table and any hold in .github/vendored-grammars.json. GitHub snapshots use <upstream-version>-g<sha7> so the monitor recognizes the installed commit.
  3. Run semantic tests, including CFG and call/reference resolution. Successful loading, parsing or definition captures alone do not prove compatibility.
  4. Let build-tree-sitter-prebuilds.yml rebuild and execute the grammar on all six {linux,darwin,win32}-{x64,arm64} hosts. Check the installed tarball too; it must include the regenerated binaries and runtime metadata. Source builds use the repository checkout, which also contains the build inputs.

Protobuf's upstream syntax node collides with node-tree-sitter 0.25.1's JavaScript SyntaxNode subclass generator. Its gRPC plugin uses a private metadata wrapper to retain the native node and field/query APIs without changing upstream sources. Native loading and comment/string-safe fallback extraction are covered in test/unit/group/grpc-extractor.test.ts.