Tree Sitter query

Tree-sitter Query Extension for Zed

This extension adds support for Tree-sitter query files (.scm) to the Zed editor.

Using the ts_query_ls language server

This extension is configured to use the ts_query_ls language server, which provides intelligent features for Tree-sitter query files including:

• Syntax checking and diagnostics
• Auto-completion for node types and captures
• Hover information
• Go to definition support

Configuration

The language server is configured with the following settings via .tsqueryrc.json, or via Zed's lsp.ts-query-ls.settings key:

{
  "$schema": "https://raw.githubusercontent.com/ribru17/ts_query_ls/refs/heads/master/schemas/config.json",
  "parser_install_directories": ["./grammars"],
  "language_retrieval_patterns": ["languages/([^/]+)/[^/]+\\.scm"],
  "valid_captures": {
    "highlights": {
      "attribute": "An attribute",
      "boolean": "A boolean value",
      "comment": "A comment",
      "comment.doc": "A documentation comment",
      "constant": "A constant",
      "constructor": "A constructor",
      "embedded": "Embedded content",
      "emphasis": "Emphasized text",
      "emphasis.strong": "Strongly emphasized text",
      "enum": "An enumeration",
      "function": "A function",
      "hint": "A hint",
      "keyword": "A keyword",
      "keyword.exception": "A keyword exception",
      "label": "A label",
      "link_text": "Link text",
      "link_uri": "A link URI",
      "number": "A numeric value",
      "operator": "An operator",
      "predictive": "Predictive text",
      "preproc": "A preprocessor directive",
      "primary": "A primary element",
      "property": "A property",
      "punctuation": "Punctuation",
      "punctuation.bracket": "A bracket",
      "punctuation.delimiter": "A delimiter",
      "punctuation.list_marker": "A list marker",
      "punctuation.special": "Special punctuation",
      "string": "A string literal",
      "string.escape": "An escaped character in a string",
      "string.regex": "A regular expression",
      "string.special": "A special string",
      "string.special.symbol": "A special symbol",
      "tag": "A tag",
      "tag.doctype": "A doctype (e.g., in HTML)",
      "text.literal": "Literal text",
      "title": "A title",
      "type": "A type",
      "variable": "A variable",
      "variable.special": "A special variable",
      "variant": "A variant"
    },
    "textobjects": {
      "function.around": "An entire function definition or equivalent small section of a file.",
      "function.inside": "The function body (the stuff within the braces).",
      "class.around": "An entire class definition or equivalent large section of a file.",
      "class.inside": "The contents of a class definition.",
      "comment.around": "An entire comment (e.g. all adjacent line comments, or a block comment).",
      "comment.inside": "The contents of a comment."
    }
  }
}

This configuration:

• Looks for Tree-sitter parsers in the ./grammars directory - Detects language contexts from file paths matching the pattern languages/([^/]+)/[^/]+\.scm - Validates capture names against Zed's standard highlight and textobjects captures - Check the language server documentation for more information on configuration options.
• You can check the full example in the examples directory.

Zed Highlight Captures Reference

The following captures are officially supported by Zed themes. Additional captures follow a fallback system (e.g., @type.super falls back to @type).

Core Captures

• @attribute, @boolean, @comment, @comment.doc, @constant, @constructor
• @embedded, @emphasis, @emphasis.strong, @enum
• @function, @hint, @keyword, @label, @link_text, @link_uri
• @number, @operator, @predictive, @preproc, @primary, @property
• @punctuation, @punctuation.bracket, @punctuation.delimiter, @punctuation.list_marker, @punctuation.special
• @string, @string.escape, @string.regex, @string.special, @string.special.symbol
• @tag, @tag.doctype, @text.literal, @title, @type
• @variable, @variable.special, @variant

Acknowledgements

• Based on the tree-sitter-query grammar
• Syntax highlighting and injection queries adapted from the official tree-sitter-query repository