--wip-- [skip ci]

Add doc param tag

Author: jamesmengo

packages/liquid-html-parser/grammar/liquid-html.ohm

@@ -384,7 +384,14 @@ LiquidStatement <: Liquid {
 }
 
 LiquidDoc <: Helpers {
-  Node := (TextNode)*
+  Node := (LiquidDocNode | TextNode)*
+  LiquidDocNode =
+    | descriptionNode
+    | paramNode
+
+  descriptionNode = (~("@param") any)+
+  paramNode = "@param" space
+  paramName = letter*
 }
 
 LiquidHTML <: Liquid {

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

@@ -980,7 +980,10 @@ describe('Unit: Stage 1 (CST)', () => {
 
       it('should parse doc tags', () => {
         for (const { toCST, expectPath } of testCases) {
-          const testStr = `{% doc -%} Renders loading-spinner. {%- enddoc %}`;
+          const testStr = `{% doc -%} 
+          Renders loading-spinner.
+          @param 
+          {%- enddoc %}`;
 
           cst = toCST(testStr);
           expectPath(cst, '0.type').to.equal('LiquidRawTag');
@@ -994,15 +997,12 @@ describe('Unit: Stage 1 (CST)', () => {
           expectPath(cst, '0.blockStartLocEnd').to.equal(0 + '{% doc -%}'.length);
           expectPath(cst, '0.blockEndLocStart').to.equal(testStr.length - '{%- enddoc %}'.length);
           expectPath(cst, '0.blockEndLocEnd').to.equal(testStr.length);
-          expectPath(cst, '0.children').to.deep.equal([
-            {
-              locEnd: 25,
-              locStart: 1,
-              source: '{% doc -%} Renders loading-spinner. {%- enddoc %}',
-              type: 'TextNode',
-              value: 'Renders loading-spinner.',
-            },
-          ]);
+          expectPath(cst, '0.children').to.have.lengthOf(2);
+          expectPath(cst, '0.children.0.type').to.equal('TextNode');
+          // this is too permissive rn
+          expectPath(cst, '0.children.0.value').to.equal('Renders loading-spinner.');
+          expectPath(cst, '0.children.1.type').to.equal('ParamNode');
+          expectPath(cst, '0.children.1.value').to.equal('@param');
         }
       });
 

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

@@ -82,6 +82,7 @@ export enum ConcreteNodeTypes {
   RenderMarkup = 'RenderMarkup',
   PaginateMarkup = 'PaginateMarkup',
   RenderVariableExpression = 'RenderVariableExpression',
+  ParamNode = 'ParamNode',
 }
 
 export const LiquidLiteralValues = {
@@ -1304,6 +1305,22 @@ function toLiquidDocAST(source: string, matchingSource: string, offset: number)
       locEnd,
       source,
     },
+    descriptionNode: {
+      type: ConcreteNodeTypes.TextNode,
+      value: function () {
+        return (this as any).sourceString;
+      },
+      locStart,
+      locEnd,
+      source,
+    },
+    paramNode: {
+      type: ConcreteNodeTypes.ParamNode,
+      value: 0,
+      locStart,
+      locEnd,
+      source,
+    },
   };
 
   return toAST(res, LiquidDocMappings);