nvim-treesitter/nvim-treesitterArchived
Nvim Treesitter
This project provides an integration of Tree-sitter into the Neovim editor to enable structural code analysis. It serves as a framework for structural code navigation, context-aware syntax highlighting, and the management of language-specific parsers.
The system distinguishes itself through a multi-language injection handler that identifies and parses embedded languages within a single document. It uses a dedicated parser manager to install, update, and remove grammar definitions and their associated query files.
The tool covers several capability areas including incremental text selection, automated structural indentation, and semantic code folding. These features are driven by mapping syntax tree nodes to semantic categories using custom query definitions.
Features
- Neovim Plugins - Integrates Tree-sitter syntax trees into the Neovim editor for structural code analysis, navigation and highlighting.
- Syntax Highlighting - Provides context-aware, structural code colorization by mapping syntax tree nodes to semantic capture groups.
- Code Highlighting - Provides context-aware coloring of source code based on the actual grammar of the language.
- Syntax-to-Semantic Mappings - Maps syntax tree nodes to functional categories using external query files to drive highlighting and structural analysis.
- Dynamic Grammar Compilation - Downloads and compiles external grammar definitions into binary modules for the editor to execute.
- Syntax Highlighting Engines - Applies precise, context-aware colorization to code by mapping Tree-sitter syntax tree nodes to semantic categories.
- Text Selection Utilities - Implements structural text selection that expands or shrinks based on named nodes in the language grammar.
- Language Parsing Rules - Identifies and parses embedded languages within a single file to apply different syntax rules to different sections.
- Parser Lifecycle Management - Installs and updates Tree-sitter parsers to enable structural analysis for different programming languages.
- Syntax Query Definitions - Implements declarative queries to traverse and extract structural information from syntax trees for highlighting and text objects.
- Syntax Tree Analysis - Analyzes code syntax by mapping syntax tree nodes to semantic categories to enable precise highlighting and structural analysis.
- Syntax Traversal - Traverses the hierarchical structure of parsed source code to derive structural boundaries for indentation and folding.
- Embedded Language Highlighting - Identifies and parses embedded code blocks within a primary document to apply multiple language grammars simultaneously.
- Language Injection Patterns - Identifies and parses embedded languages within a document to apply appropriate syntax rules to different sections.
- Buffer Attachment Modules - Creates custom modules that dynamically attach to editor buffers based on language detection and available support.
- Parser Asset Management - Manages the installation, updating, and removal of language-specific grammar parsers from remote or local sources.
- Text Object Selection - Expands or shrinks code selections based on the structural hierarchy of a language grammar.
- Structural Folding - Calculates fold boundaries and collapses code sections using fold expressions derived from the concrete syntax tree.
- Indentation Engines - Determines the correct indentation level for code by analyzing the structural hierarchy and state of the syntax tree.
- Filetype Mappings - Maps language parsers to specific filetypes to enable structural analysis for unconventional file extensions.
- Structural Navigation - Implements incremental selection, logical code folding and automated indentation based on concrete syntax trees.
- Syntax Highlighting - Core configuration and abstraction layer for Tree-sitter.
