@herb-tools/formatter 0.4.2 → 0.5.0

package/dist/types/printer.d.ts

@@ -13,11 +13,52 @@ export declare class Printer extends Visitor {
     private indentLevel;
     private inlineMode;
     private isInComplexNesting;
+    private currentTagName;
+    private static readonly INLINE_ELEMENTS;
     constructor(source: string, options: Required<FormatOptions>);
     print(object: Node | Token, indentLevel?: number): string;
     private push;
     private withIndent;
     private indent;
+    /**
+     * Format ERB content with proper spacing around the inner content.
+     * Returns empty string if content is empty, otherwise wraps content with single spaces.
+     */
+    private formatERBContent;
+    /**
+     * Check if a node is an ERB control flow node (if, unless, block, case, while, for)
+     */
+    private isERBControlFlow;
+    /**
+     * Count total attributes including those inside ERB conditionals
+     */
+    private getTotalAttributeCount;
+    /**
+     * Extract HTML attributes from a list of nodes
+     */
+    private extractAttributes;
+    /**
+     * Extract inline nodes (non-attribute, non-whitespace) from a list of nodes
+     */
+    private extractInlineNodes;
+    /**
+     * Render attributes as a space-separated string
+     */
+    private renderAttributesString;
+    /**
+     * Determine if a tag should be rendered inline based on attribute count and other factors
+     */
+    private shouldRenderInline;
+    private hasMultilineAttributes;
+    private formatClassAttribute;
+    private isFormattableAttribute;
+    private formatMultilineAttribute;
+    private formatMultilineAttributeValue;
+    private breakTokensIntoLines;
+    /**
+     * Render multiline attributes for a tag
+     */
+    private renderMultilineAttributes;
     /**
      * Print an ERB tag (<% %> or <%= %>) with single spaces around inner content.
      */
@@ -52,13 +93,36 @@ export declare class Printer extends Visitor {
     visitERBEnsureNode(node: ERBEnsureNode): void;
     visitERBUnlessNode(node: ERBUnlessNode): void;
     private visitERBGeneric;
+    private isNonWhitespaceNode;
+    /**
+     * Check if an element should be treated as inline based on its tag name
+     */
+    private isInlineElement;
+    /**
+     * Check if we're in a text flow context (parent contains mixed text and inline elements)
+     */
+    private visitTextFlowChildren;
+    private visitTextFlowChildrenMultiline;
+    private isInTextFlowContext;
     private renderInlineOpen;
     renderAttribute(attribute: HTMLAttributeNode): string;
+    /**
+     * Try to render a complete element inline including opening tag, children, and closing tag
+     */
+    private tryRenderInlineFull;
+    /**
+     * Try to render just the children inline (without tags)
+     */
+    private tryRenderChildrenInline;
     /**
      * Try to render children inline if they are simple enough.
      * Returns the inline string if possible, null otherwise.
      */
     private tryRenderInline;
+    /**
+     * Estimate the total content length of children nodes for decision making.
+     */
+    private estimateContentLength;
     /**
      * Calculate the maximum nesting depth in a subtree of nodes.
      */

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@herb-tools/formatter",
-  "version": "0.4.2",
+  "version": "0.5.0",
+  "description": "Auto-formatter for HTML+ERB templates with intelligent indentation, line wrapping, and ERB-aware pretty-printing.",
   "license": "MIT",
   "homepage": "https://herb-tools.dev",
   "bugs": "https://github.com/marcoroth/herb/issues/new?title=Package%20%60@herb-tools/formatter%60:%20",
@@ -34,7 +35,7 @@
     }
   },
   "dependencies": {
-    "@herb-tools/core": "0.4.2",
+    "@herb-tools/core": "0.5.0",
     "glob": "^11.0.3"
   },
   "files": [

package/src/cli.ts

@@ -27,11 +27,11 @@ export class CLI {
 
     Examples:
       herb-format                            # Format all **/*.html.erb files in current directory
-      herb-format --check                    # Check if all **/*.html.erb files are formatted
+      herb-format templates/                 # Format and **/*.html.erb within the given directory
       herb-format templates/index.html.erb   # Format and write single file
+      herb-format --check                    # Check if all **/*.html.erb files are formatted
       herb-format --check templates/         # Check if all **/*.html.erb files in templates/ are formatted
       cat template.html.erb | herb-format    # Format from stdin to stdout
-      herb-format - < template.html.erb      # Format from stdin to stdout
   `
 
   async run() {