Add basic prettier support for doc tag

Author: jamesmengo

packages/liquid-html-parser/src/stage-1-cst.ts

@@ -110,6 +110,7 @@ export interface ConcreteBasicNode<T> {
 export interface ConcreteLiquidDocParamNode
   extends ConcreteBasicNode<ConcreteNodeTypes.LiquidDocParamNode> {
   name: string;
+  value: string;
 }
 
 export interface ConcreteHtmlNodeBase<T> extends ConcreteBasicNode<T> {
@@ -1328,6 +1329,7 @@ function toLiquidDocAST(source: string, matchingSource: string, offset: number)
     paramNode: {
       type: ConcreteNodeTypes.LiquidDocParamNode,
       name: 0,
+      value: 2,
       locStart,
       locEnd,
       source,

packages/liquid-html-parser/src/stage-2-ast.ts

@@ -757,6 +757,7 @@ export interface TextNode extends ASTNode<NodeTypes.TextNode> {
 
 export interface LiquidDocParamNode extends ASTNode<NodeTypes.LiquidDocParamNode> {
   name: string;
+  value: string;
 }
 
 export interface ASTNode<T> {
@@ -1279,6 +1280,7 @@ function buildAst(
           name: node.name,
           position: position(node),
           source: node.source,
+          value: node.value,
         });
         break;
       }

packages/prettier-plugin-liquid/src/printer/printer-liquid-html.ts

@@ -210,6 +210,11 @@ function printNode(
     }
 
     case NodeTypes.RawMarkup: {
+      if (node.parentNode?.name === 'doc') {
+        const liquidDocBody = path.map((p: any) => print(p), 'nodes');
+        return [indent([hardline, liquidDocBody]), hardline];
+      }
+
       const isRawMarkupIdentationSensitive = () => {
         switch (node.kind) {
           case RawMarkupKinds.typescript:
@@ -548,7 +553,7 @@ function printNode(
     }
 
     case NodeTypes.LiquidDocParamNode: {
-      return node.name;
+      return [node.name, ' ', node.value];
     }
 
     default: {

packages/prettier-plugin-liquid/src/test/liquid-doc/fixed.liquid

@@ -0,0 +1,9 @@
+It should indent the body
+{% doc %}
+  @param body
+{% enddoc %}
+
+It should not dedent to root
+{% doc %}
+  @param body
+{% enddoc %}

packages/prettier-plugin-liquid/src/test/liquid-doc/index.liquid

@@ -0,0 +1,9 @@
+It should indent the body
+{% doc %}
+@param body
+{% enddoc %}
+
+It should not dedent to root
+{% doc %}
+    @param body
+{% enddoc %}

packages/prettier-plugin-liquid/src/test/liquid-doc/index.spec.ts

@@ -0,0 +1,7 @@
+import { test } from 'vitest';
+import { assertFormattedEqualsFixed } from '../test-helpers';
+import * as path from 'path';
+
+test('Unit: liquid-doc', async () => {
+  await assertFormattedEqualsFixed(__dirname);
+});