parsers: add phpdoc parser (experimental)

lua/nvim-treesitter/parsers.lua

@@ -245,6 +245,17 @@ list.php = {
   maintainers = { "@tk-shirasaka" },
 }
 
+list.phpdoc = {
+  install_info = {
+    url = "https://github.com/claytonrcarter/tree-sitter-phpdoc",
+    files = { "src/parser.c" },
+    -- parser.c in the repo still based on TS 0.17 due to other dependencies
+    requires_generate_from_grammar = true,
+    generate_requires_npm = true,
+  },
+  experimental = true,
+}
+
 list.java = {
   install_info = {
     url = "https://github.com/tree-sitter/tree-sitter-java",

queries/php/injections.scm

@@ -1,3 +1,3 @@
 (text) @html
 
-(comment) @comment
+(comment) @phpdoc

queries/phpdoc/highlights.scm

@@ -0,0 +1,42 @@
+(tag_name) @attribute
+(tag
+  (tag_name) @_tag (#eq? @_tag "@param")
+  (variable_name) @parameter
+)
+(tag
+  (tag_name) @_tag (#eq? @_tag "@property")
+  (variable_name) @property
+)
+(tag
+  (tag_name) @_tag (#eq? @_tag "@var")
+  (variable_name) @variable
+)
+(tag
+  (tag_name) @_tag (#eq? @_tag "@method")
+  (name) @method
+)
+(parameter
+  (variable_name) @parameter)
+(type_list
+  [
+    (array_type)
+    (primitive_type)
+    (named_type)
+  ] @type)
+(tag
+  (description (text) @text))
+(tag
+  [
+    (author_name)
+    (version)
+  ] @text)
+(tag
+  (email_address) @text.uri
+)
+
+[
+  "$"
+  ">"
+  "<"
+  "|"
+]@keyword