@reteps/tree-sitter-htmlmustache 0.5.0 → 0.5.1

package/README.md

@@ -247,6 +247,17 @@ Additionally, the following rules are configurable. Set their severities (`"erro
 
 <!-- RULES_TABLE_END -->
 
+### Disabling Lint Rules
+
+Disable a configurable lint rule for an entire file with an inline comment:
+
+```html
+<!-- htmlmustache-disable preferMustacheComments -->
+{{! htmlmustache-disable selfClosingNonVoidTags }}
+```
+
+The comment can appear anywhere in the file. Only configurable rules (listed above) can be disabled. Use multiple comments to disable multiple rules.
+
 ### EditorConfig
 
 Both the CLI and VS Code extension respect your `.editorconfig` file for indentation settings (`indent_style`, `indent_size`). EditorConfig values override `.htmlmustache.jsonc` for indentation, and CLI flags override everything.

package/cli/out/main.js

@@ -1425,6 +1425,35 @@ function errorMessageForNode(nodeType, node) {
 function resolveRuleSeverity(rules, ruleName) {
   return rules?.[ruleName] ?? RULE_DEFAULTS[ruleName] ?? "off";
 }
+function parseDisableDirective(node) {
+  if (node.type !== "html_comment" && node.type !== "mustache_comment") return null;
+  let inner = null;
+  if (node.type === "html_comment") {
+    const match = node.text.match(/^<!--([\s\S]*)-->$/);
+    if (match) inner = match[1].trim();
+  } else {
+    const match = node.text.match(/^\{\{!([\s\S]*)\}\}$/);
+    if (match) inner = match[1].trim();
+  }
+  if (!inner) return null;
+  const prefix = "htmlmustache-disable ";
+  if (!inner.startsWith(prefix)) return null;
+  const ruleName = inner.slice(prefix.length).trim();
+  return KNOWN_RULE_NAMES.has(ruleName) ? ruleName : null;
+}
+function collectDisabledRules(rootNode) {
+  const disabled = /* @__PURE__ */ new Set();
+  function walk(node) {
+    const rule = parseDisableDirective(node);
+    if (rule) {
+      disabled.add(rule);
+      return;
+    }
+    for (const child of node.children) walk(child);
+  }
+  walk(rootNode);
+  return disabled;
+}
 function collectErrors(tree, rules) {
   const errors = [];
   const cursor = tree.walk();
@@ -1454,6 +1483,11 @@ function collectErrors(tree, rules) {
   for (const error of unclosedErrors) {
     errors.push({ node: error.node, message: error.message });
   }
+  const disabledRules = collectDisabledRules(tree.rootNode);
+  const effectiveRules = { ...rules };
+  for (const rule of disabledRules) {
+    effectiveRules[rule] = "off";
+  }
   const sourceText = tree.rootNode.text;
   const ruleChecks = [
     { rule: "nestedDuplicateSections", errors: () => checkNestedSameNameSections(tree.rootNode) },
@@ -1465,7 +1499,7 @@ function collectErrors(tree, rules) {
     { rule: "preferMustacheComments", errors: () => checkHtmlComments(tree.rootNode) }
   ];
   for (const { rule, errors: getErrors } of ruleChecks) {
-    const severity = resolveRuleSeverity(rules, rule);
+    const severity = resolveRuleSeverity(effectiveRules, rule);
     if (severity === "off") continue;
     for (const error of getErrors()) {
       errors.push({
@@ -1477,7 +1511,9 @@ function collectErrors(tree, rules) {
       });
     }
   }
-  return errors;
+  return errors.filter(
+    (e) => !(e.message.includes("HTML comment found") && parseDisableDirective(e.node) !== null)
+  );
 }
 
 // cli/src/check.ts
@@ -3252,7 +3288,8 @@ function formatBlockChildren(nodes, context) {
       pendingBlankLine = false;
     } else if (node.type === "html_comment" || node.type === "mustache_comment") {
       const isMultiline = node.startPosition.row !== node.endPosition.row;
-      if (isMultiline) {
+      const isOnOwnLine = i > 0 && node.startPosition.row > nodes[i - 1].endPosition.row;
+      if (isMultiline || isOnOwnLine) {
         if (currentLine.length > 0) {
           const lineContent = trimDoc(flushCurrentLine());
           if (hasDocContent(lineContent)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reteps/tree-sitter-htmlmustache",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "HTML with Mustache/Handlebars template syntax grammar for tree-sitter",
   "repository": {
     "type": "git",