Add formatting support for optional liquidDoc params

Author: jamesmengo

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

@@ -519,8 +519,10 @@ export function printLiquidDocParam(
     parts.push(' ', `{${node.paramType.value}}`);
   }
 
-  if (node.paramName.value) {
+  if (node.required) {
     parts.push(' ', node.paramName.value);
+  } else {
+    parts.push(' ', `[${node.paramName.value}]`);
   }
 
   if (node.paramDescription?.value) {

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

@@ -27,3 +27,16 @@ It should normalize the param description
 {% doc %}
   @param paramName - param with description
 {% enddoc %}
+
+It should strip whitespace between optional param delimiters
+{% doc %}
+  @param [paramName] - param with description
+{% enddoc %}
+
+It should not break params with malformed optional delimiters
+{% doc %}
+  @param [missingTail - param with description
+  @param missingHead] - param with description
+  @param [too many words no desc]
+  @param [too many words] - param with description
+{% enddoc %}

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

@@ -27,3 +27,16 @@ It should normalize the param description
 {% doc %}
   @param paramName - param           with                    description
 {% enddoc %}
+
+It should strip whitespace between optional param delimiters
+{% doc %}
+  @param [    paramName         ] - param with description
+{% enddoc %}
+
+It should handle params with malformed optional delimiters
+{% doc %}
+  @param [missingTail - param with description
+  @param missingHead] - param with description
+  @param [too many words no desc]
+  @param [too many words] - param with description
+{% enddoc %}