@herb-tools/formatter 0.8.1 → 0.8.3

package/dist/types/format-helpers.d.ts

@@ -29,9 +29,6 @@ export declare const FORMATTABLE_ATTRIBUTES: Record<string, string[]>;
 export declare const INLINE_ELEMENTS: Set<string>;
 export declare const CONTENT_PRESERVING_ELEMENTS: Set<string>;
 export declare const SPACEABLE_CONTAINERS: Set<string>;
-export declare const TIGHT_GROUP_PARENTS: Set<string>;
-export declare const TIGHT_GROUP_CHILDREN: Set<string>;
-export declare const SPACING_THRESHOLD = 3;
 /**
  * Token list attributes that contain space-separated values and benefit from
  * spacing around ERB content for readability

package/dist/types/format-ignore.d.ts

@@ -0,0 +1,9 @@
+import type { Node } from "@herb-tools/core";
+/**
+ * Check if an ERB content node is a herb:formatter ignore comment
+ */
+export declare function isHerbFormatterIgnoreComment(node: Node): boolean;
+/**
+ * Check if the document contains a herb:formatter ignore directive anywhere.
+ */
+export declare function hasFormatterIgnoreDirective(node: Node): boolean;

package/dist/types/format-printer.d.ts

@@ -24,6 +24,10 @@ export declare class FormatPrinter extends Printer {
     private currentAttributeName;
     private elementStack;
     private elementFormattingAnalysis;
+    private nodeIsMultiline;
+    private stringLineCount;
+    private tagGroupsCache;
+    private allSingleLineCache;
     source: string;
     constructor(source: string, options: Required<FormatOptions>);
     print(input: Node | ParseResult | Token): string;
@@ -44,6 +48,10 @@ export declare class FormatPrinter extends Printer {
      * Useful for testing what output would be generated without affecting the main output
      */
     private capture;
+    /**
+     * Track a boundary node's multiline status by comparing line count before/after rendering.
+     */
+    private trackBoundary;
     /**
      * Capture all nodes that would be visited during a callback
      * Returns a flat list of all nodes without generating any output
@@ -72,6 +80,19 @@ export declare class FormatPrinter extends Printer {
      * Extract inline nodes (non-attribute, non-whitespace) from a list of nodes
      */
     private extractInlineNodes;
+    /**
+     * Check if a node will render as multiple lines when formatted.
+     */
+    private isMultilineElement;
+    /**
+     * Get a grouping key for a node (tag name for HTML, ERB type for ERB)
+     */
+    private getGroupingKey;
+    /**
+     * Detect groups of consecutive same-tag/same-type single-line elements
+     * Returns a map of index -> group info for efficient lookup
+     */
+    private detectTagGroups;
     /**
      * Determine if spacing should be added between sibling elements
      *
@@ -127,6 +148,8 @@ export declare class FormatPrinter extends Printer {
     visitHTMLElementBody(body: Node[], element: HTMLElementNode): void;
     /**
      * Visit element children with intelligent spacing logic
+     *
+     * Tracks line positions and immediately splices blank lines after rendering each child.
      */
     private visitElementChildren;
     visitHTMLOpenTagNode(node: HTMLOpenTagNode): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@herb-tools/formatter",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Auto-formatter for HTML+ERB templates with intelligent indentation, line wrapping, and ERB-aware pretty-printing.",
   "license": "MIT",
   "homepage": "https://herb-tools.dev",
@@ -35,10 +35,10 @@
     }
   },
   "dependencies": {
-    "@herb-tools/config": "0.8.1",
-    "@herb-tools/core": "0.8.1",
-    "@herb-tools/printer": "0.8.1",
-    "@herb-tools/rewriter": "0.8.1"
+    "@herb-tools/config": "0.8.3",
+    "@herb-tools/core": "0.8.3",
+    "@herb-tools/printer": "0.8.3",
+    "@herb-tools/rewriter": "0.8.3"
   },
   "files": [
     "package.json",

package/src/format-helpers.ts

@@ -56,17 +56,6 @@ export const SPACEABLE_CONTAINERS = new Set([
   'figure', 'details', 'summary', 'dialog', 'fieldset'
 ])
 
-export const TIGHT_GROUP_PARENTS = new Set([
-  'ul', 'ol', 'nav', 'select', 'datalist', 'optgroup', 'tr', 'thead',
-  'tbody', 'tfoot'
-])
-
-export const TIGHT_GROUP_CHILDREN = new Set([
-  'li', 'option', 'td', 'th', 'dt', 'dd'
-])
-
-export const SPACING_THRESHOLD = 3
-
 /**
  * Token list attributes that contain space-separated values and benefit from
  * spacing around ERB content for readability

package/src/format-ignore.ts

@@ -0,0 +1,45 @@
+import { isERBCommentNode } from "@herb-tools/core"
+import { Visitor } from "@herb-tools/core"
+
+import type { Node, ERBContentNode } from "@herb-tools/core"
+
+const HERB_FORMATTER_PREFIX = "herb:formatter"
+const HERB_FORMATTER_IGNORE_PREFIX = `${HERB_FORMATTER_PREFIX} ignore`
+
+/**
+ * Check if an ERB content node is a herb:formatter ignore comment
+ */
+export function isHerbFormatterIgnoreComment(node: Node): boolean {
+  if (!isERBCommentNode(node)) return false
+
+  const content = node?.content?.value || ""
+
+  return content.trim() === HERB_FORMATTER_IGNORE_PREFIX
+}
+
+/**
+ * Check if the document contains a herb:formatter ignore directive anywhere.
+ */
+export function hasFormatterIgnoreDirective(node: Node): boolean {
+  const detector = new FormatterIgnoreDetector()
+  detector.visit(node)
+  return detector.hasIgnoreDirective
+}
+
+/**
+* Visitor that detects if the AST contains a herb:formatter ignore directive.
+*/
+class FormatterIgnoreDetector extends Visitor {
+  public hasIgnoreDirective = false
+
+  visitERBContentNode(node: ERBContentNode): void {
+    if (isHerbFormatterIgnoreComment(node)) {
+      this.hasIgnoreDirective = true
+      return
+    }
+
+    if (this.hasIgnoreDirective) return
+
+    this.visitChildNodes(node)
+  }
+}