Add support for LiquidDoc

Fix syntax

Author: nikitaourazbaev

Syntaxes/Liquid.sublime-syntax

@@ -26,6 +26,7 @@ contexts:
 
   liquid-tags:
     - include: jekyll-highlight-tags
+    - include: liquid-doc-tags
     - include: liquid-comment-tags
     - include: liquid-schema-tags
     - include: liquid-javascript-tags
@@ -69,6 +70,26 @@ contexts:
         3: punctuation.section.embedded.end.liquid
       pop: 1
 
+###[ LIQUID DOC TAGS ]####################################################
+
+  liquid-doc-tags:
+    # https://shopify.dev/docs/api/liquid/tags/theme-tags#doc
+    - match: ({%-?)\s*(doc)\s*(-?%})
+      scope: meta.embedded.liquid source.liquid meta.statement.liquid
+      captures:
+        1: punctuation.section.embedded.begin.liquid
+        2: keyword.declaration.raw.liquid
+        3: punctuation.section.embedded.end.liquid
+      embed: scope:source.liquiddoc
+      embed_scope: source.embedded.liquiddoc
+      escape: ({%-?)\s*(enddoc)\s*(-?%})
+      escape_captures:
+        0: meta.embedded.liquid source.liquid meta.statement.liquid
+        1: punctuation.section.embedded.begin.liquid
+        2: keyword.declaration.raw.liquid
+        3: punctuation.section.embedded.end.liquid
+      pop: 1
+
 ###[ LIQUID JAVASCRIPT TAGS ]##################################################
 
   liquid-javascript-tags:

Syntaxes/LiquidDoc.sublime-syntax

@@ -0,0 +1,31 @@
+%YAML 1.2
+---
+# https://shopify.github.io/liquid
+# https://shopify.dev/api/liquid
+# https://shopify.dev/docs/storefronts/themes/tools/liquid-doc
+# http://www.sublimetext.com/docs/syntax.html
+name: LiquidDoc
+scope: source.liquiddoc
+version: 2
+hidden: true
+
+variables:
+  liquid_variables: \b[a-zA-Z_][0-9a-zA-Z_]*\b
+
+
+contexts:
+  main:
+    - match: '@description'
+      scope: keyword.liquiddoc
+
+    - match: '(@param)\s+({[a-z]+})\s+(\[?{{liquid_variables}}\]?)'
+      captures:
+        1: keyword.liquiddoc
+        2: storage.type.liquiddoc
+        3: variable.liquiddoc
+
+    - match: '@example'
+      scope: keyword.liquiddoc
+
+    - match: '.'
+      scope: comment.liquiddoc

tests/syntax_test_liquid.md

@@ -559,6 +559,40 @@ div {
 |               ^^ punctuation.section.embedded.end.liquid
 
 
+{% doc %}
+| <- meta.embedded.liquid source.liquid meta.statement.liquid punctuation.section.embedded.begin.liquid
+|^^^^^^^^ meta.embedded.liquid source.liquid meta.statement.liquid
+|^ punctuation.section.embedded.begin.liquid
+|  ^^^ keyword.declaration.raw.liquid
+|      ^^ punctuation.section.embedded.end.liquid
+  Displays a product title
+| <- text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+|^^^^^^^^^^^^^^^^^^^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+
+  @description This will display a product title
+| <- text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+| ^^^^^^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc keyword.liquiddoc
+|              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^  text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+
+  @param {product} product The product to display the title for
+| <- text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+| ^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc keyword.liquiddoc
+|        ^^^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc storage.type.liquiddoc
+|                  ^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc variable.liquiddoc
+|                          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+
+  @example
+| <- text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+| ^^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc keyword.liquiddoc
+  {% render 'product-title', product: product %}
+| <- text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ text.html.liquid meta.template.liquid source.embedded.liquiddoc comment.liquiddoc
+{% enddoc %}
+| <- text.html.liquid meta.embedded.liquid source.liquid meta.statement.liquid punctuation.section.embedded.begin.liquid
+|^ text.html.liquid meta.template.liquid meta.embedded.liquid source.liquid meta.statement.liquid punctuation.section.embedded.begin.liquid
+|  ^^^^^^ text.html.liquid meta.embedded.liquid source.liquid meta.statement.liquid keyword.declaration.raw.liquid
+|         ^^ text.html.liquid meta.embedded.liquid source.liquid meta.statement.liquid punctuation.section.embedded.end.liquid
+
 <!--
  --- Test Objects
  -->