@khanacademy/perseus-linter 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @khanacademy/perseus-linter
 
+## 0.3.4
+
+### Patch Changes
+
+-   388b6506: Convert runLinter doc comment to /\*\* \*/ format so editors pick it up better (VSCode).
+-   Updated dependencies [388b6506]
+    -   @khanacademy/perseus-error@0.2.3
+
 ## 0.3.3
 
 ### Patch Changes

package/dist/es/index.js

@@ -1765,30 +1765,30 @@ const linterContextDefault = {
 
 const allLintRules = AllRules.filter(r => r.severity < Rule.Severity.BULK_WARNING);
 
-//
-// Run the Perseus linter over the specified markdown parse tree,
-// with the specified context object, and
-// return a (possibly empty) array of lint warning objects.  If the
-// highlight argument is true, this function also modifies the parse
-// tree to add "lint" nodes that can be visually rendered,
-// highlighting the problems for the user. The optional rules argument
-// is an array of Rule objects specifying which lint rules should be
-// applied to this parse tree. When omitted, a default set of rules is used.
-//
-// The context object may have additional properties that some lint
-// rules require:
-//
-//   context.content is the source content string that was parsed to create
-//   the parse tree.
-//
-//   context.widgets is the widgets object associated
-//   with the content string
-//
-// TODO: to make this even more general, allow the first argument to be
-// a string and run the parser over it in that case? (but ignore highlight
-// in that case). This would allow the one function to be used for both
-// online linting and batch linting.
-//
+/**
+ * Run the Perseus linter over the specified markdown parse tree,
+ * with the specified context object, and
+ * return a (possibly empty) array of lint warning objects.  If the
+ * highlight argument is true, this function also modifies the parse
+ * tree to add "lint" nodes that can be visually rendered,
+ * highlighting the problems for the user. The optional rules argument
+ * is an array of Rule objects specifying which lint rules should be
+ * applied to this parse tree. When omitted, a default set of rules is used.
+ *
+ * The context object may have additional properties that some lint
+ * rules require:
+ *
+ *   context.content is the source content string that was parsed to create
+ *   the parse tree.
+ *
+ *   context.widgets is the widgets object associated
+ *   with the content string
+ *
+ * TODO: to make this even more general, allow the first argument to be
+ * a string and run the parser over it in that case? (but ignore highlight
+ * in that case). This would allow the one function to be used for both
+ * online linting and batch linting.
+ */
 function runLinter(tree, context, highlight, rules = allLintRules) {
   const warnings = [];
   const tt = new TreeTransformer(tree);