Added doc tag support logic inside snippet tag

Author: shoplando

packages/theme-check-common/src/checks/unsupported-doc-tag/index.ts

@@ -1,6 +1,7 @@
 import { isSnippet, isBlock } from '../../to-schema';
 import { LiquidCheckDefinition, Severity, SourceCodeType } from '../../types';
 import { filePathSupportsLiquidDoc } from '../../liquid-doc/utils';
+import { LiquidRawTag, NodeTypes, LiquidHtmlNode } from '@shopify/liquid-html-parser';
 
 export const UnsupportedDocTag: LiquidCheckDefinition = {
   meta: {
@@ -19,18 +20,28 @@ export const UnsupportedDocTag: LiquidCheckDefinition = {
 
   create(context) {
     const docTagName = 'doc';
+    const snippetTagName = 'snippet';
 
     if (filePathSupportsLiquidDoc(context.file.uri)) {
       return {};
     }
 
     return {
-      async LiquidRawTag(node) {
+      async LiquidRawTag(node: LiquidRawTag, ancestors: LiquidHtmlNode[]) {
         if (node.name !== docTagName) {
           return;
         }
+
+        const isInsideSnippetTag = ancestors.some((ancestor) => {
+          return ancestor.type === NodeTypes.LiquidTag && ancestor.name === snippetTagName;
+        });
+
+        if (isInsideSnippetTag) {
+          return;
+        }
+
         context.report({
-          message: `The \`${docTagName}\` tag can only be used within a snippet or block.`,
+          message: `The \`${docTagName}\` tag can only be used within an inline snippet, snippet or block.`,
           startIndex: node.position.start,
           endIndex: node.position.end,
           suggest: [