@herb-tools/rewriter 0.9.3 → 0.9.4

package/dist/index.cjs

@@ -205,7 +205,7 @@ class Token {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.3/templates/javascript/packages/core/src/errors.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.4/templates/javascript/packages/core/src/errors.ts.erb
 class HerbError {
     type;
     message;
@@ -20384,7 +20384,7 @@ function deserializePrismNode(bytes, source) {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.3/templates/javascript/packages/core/src/nodes.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.4/templates/javascript/packages/core/src/nodes.ts.erb
 class Node {
     type;
     location;
@@ -23653,7 +23653,7 @@ class ParseResult extends Result {
 }
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.3/templates/javascript/packages/core/src/node-type-guards.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.4/templates/javascript/packages/core/src/node-type-guards.ts.erb
 /**
  * Type guard functions for AST nodes.
  * These functions provide type checking by combining both instanceof
@@ -23996,6 +23996,31 @@ function isERBInNode(node) {
         return false;
     return node instanceof ERBInNode || node.type === "AST_ERB_IN_NODE" || node.constructor.type === "AST_ERB_IN_NODE";
 }
+/**
+ * Checks if a node is any ERB node type
+ */
+function isERBNode(node) {
+    return isERBOpenTagNode(node) ||
+        isERBContentNode(node) ||
+        isERBEndNode(node) ||
+        isERBElseNode(node) ||
+        isERBIfNode(node) ||
+        isERBBlockNode(node) ||
+        isERBWhenNode(node) ||
+        isERBCaseNode(node) ||
+        isERBCaseMatchNode(node) ||
+        isERBWhileNode(node) ||
+        isERBUntilNode(node) ||
+        isERBForNode(node) ||
+        isERBRescueNode(node) ||
+        isERBEnsureNode(node) ||
+        isERBBeginNode(node) ||
+        isERBUnlessNode(node) ||
+        isERBRenderNode(node) ||
+        isERBStrictLocalsNode(node) ||
+        isERBYieldNode(node) ||
+        isERBInNode(node);
+}
 /**
  * Map of node classes to their corresponding type guard functions
  *
@@ -24158,6 +24183,17 @@ function isToken(object) {
 function isParseResult(object) {
     return (object instanceof ParseResult) || (object?.constructor?.name === "ParseResult" && "value" in object);
 }
+
+/**
+ * Checks if a node is an ERB output node (generates content: <%= %> or <%== %>)
+ */
+function isERBOutputNode(node) {
+    if (!isERBNode(node))
+        return false;
+    if (!node.tag_opening?.value)
+        return false;
+    return ["<%=", "<%=="].includes(node.tag_opening?.value);
+}
 /**
  * Extracts a static string from an array of literal nodes
  * Returns null if any node is not a literal node
@@ -24217,12 +24253,88 @@ function getNodesBeforePosition(nodes, position, inclusive = false) {
 function getNodesAfterPosition(nodes, position, inclusive = true) {
     return nodes.filter(node => node.location && isPositionAfter(node.location.start, position, inclusive));
 }
+// --- AST Mutation Utilities ---
+const CHILD_ARRAY_PROPS = ["children", "body", "statements", "conditions"];
+const LINKED_NODE_PROPS = ["subsequent", "else_clause"];
+/**
+ * Finds the array containing a target node in the AST, along with its index.
+ * Traverses child arrays and linked node properties (e.g., `subsequent`, `else_clause`).
+ *
+ * Useful for autofix operations that need to splice nodes in/out of their parent array.
+ *
+ * @param root - The root node to search from
+ * @param target - The node to find
+ * @returns The containing array and the target's index, or null if not found
+ */
+function findParentArray(root, target) {
+    const search = (node) => {
+        const record = node;
+        for (const prop of CHILD_ARRAY_PROPS) {
+            const array = record[prop];
+            if (Array.isArray(array)) {
+                const index = array.indexOf(target);
+                if (index !== -1) {
+                    return { array, index };
+                }
+            }
+        }
+        for (const prop of CHILD_ARRAY_PROPS) {
+            const array = record[prop];
+            if (Array.isArray(array)) {
+                for (const child of array) {
+                    if (child && typeof child === 'object' && 'type' in child) {
+                        const result = search(child);
+                        if (result) {
+                            return result;
+                        }
+                    }
+                }
+            }
+        }
+        for (const prop of LINKED_NODE_PROPS) {
+            const value = record[prop];
+            if (value && typeof value === 'object' && 'type' in value) {
+                const result = search(value);
+                if (result) {
+                    return result;
+                }
+            }
+        }
+        return null;
+    };
+    return search(root);
+}
+/**
+ * Creates a synthetic LiteralNode with the given content and zero location.
+ * Useful for inserting whitespace or newlines during AST mutations.
+ */
+function createLiteral(content) {
+    return new LiteralNode({
+        type: "AST_LITERAL_NODE",
+        content,
+        location: Location.zero,
+        errors: [],
+    });
+}
 function createSyntheticToken(value, type = "TOKEN_SYNTHETIC") {
     return new Token(value, Range.zero, Location.zero, type);
 }
+function createERBOutputNode(expression, tagOpening = "<%=", tagClosing = "%>") {
+    return new ERBContentNode({
+        type: "AST_ERB_CONTENT_NODE",
+        tag_opening: createSyntheticToken(tagOpening),
+        content: createSyntheticToken(expression),
+        tag_closing: createSyntheticToken(tagClosing),
+        parsed: false,
+        valid: true,
+        prism_node: null,
+        location: Location.zero,
+        errors: [],
+    });
+}
 
 // NOTE: This file is generated by the templates/template.rb script and should not
-// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.3/templates/javascript/packages/core/src/visitor.ts.erb
+// be modified manually. See /Users/marcoroth/Development/herb-release-0.9.4/templates/javascript/packages/core/src/visitor.ts.erb
 class Visitor {
     visit(node) {
         if (!node)
@@ -24617,6 +24729,127 @@ class ActionViewTagHelperToHTMLRewriter extends ASTRewriter {
     }
 }
 
+const STRING_NODE_TYPE = "StringNode";
+const INTERPOLATED_STRING_NODE_TYPE = "InterpolatedStringNode";
+const EMBEDDED_STATEMENTS_NODE_TYPE = "EmbeddedStatementsNode";
+class ERBStringToDirectOutputVisitor extends Visitor {
+    root;
+    constructor(root) {
+        super();
+        this.root = root;
+    }
+    visitERBContentNode(node) {
+        if (!isERBOutputNode(node)) {
+            this.visitChildNodes(node);
+            return;
+        }
+        const prismNode = node.prismNode;
+        if (!prismNode) {
+            this.visitChildNodes(node);
+            return;
+        }
+        const source = node.source;
+        if (!source) {
+            this.visitChildNodes(node);
+            return;
+        }
+        if (!ERBStringToDirectOutputRewriter.isStringOutputNode(prismNode)) {
+            this.visitChildNodes(node);
+            return;
+        }
+        const replacementParts = ERBStringToDirectOutputRewriter.extractReplacementParts(prismNode, source);
+        if (!replacementParts) {
+            this.visitChildNodes(node);
+            return;
+        }
+        const tagOpening = node.tag_opening?.value ?? "<%=";
+        const tagClosing = node.tag_closing?.value ?? "%>";
+        const parentInfo = findParentArray(this.root, node);
+        if (!parentInfo) {
+            this.visitChildNodes(node);
+            return;
+        }
+        const { array: parentArray, index: nodeIndex } = parentInfo;
+        const replacementNodes = [];
+        for (const part of replacementParts) {
+            if (part.type === "text") {
+                replacementNodes.push(createLiteral(part.content));
+            }
+            else {
+                replacementNodes.push(createERBOutputNode(` ${part.expression.trim()} `, tagOpening, tagClosing));
+            }
+        }
+        parentArray.splice(nodeIndex, 1, ...replacementNodes);
+    }
+}
+class ERBStringToDirectOutputRewriter extends ASTRewriter {
+    get name() {
+        return "erb-string-to-direct-output";
+    }
+    get description() {
+        return "Replaces ERB string output with direct text and expression tags";
+    }
+    rewrite(node, _context) {
+        const visitor = new ERBStringToDirectOutputVisitor(node);
+        visitor.visit(node);
+        return node;
+    }
+    static isStringOutputNode(prismNode) {
+        const nodeType = prismNode.constructor.name;
+        return nodeType === STRING_NODE_TYPE || nodeType === INTERPOLATED_STRING_NODE_TYPE;
+    }
+    static extractStringContent(stringNode, source) {
+        const unescapedValue = stringNode.unescaped?.value;
+        if (typeof unescapedValue === "string") {
+            return unescapedValue;
+        }
+        const location = stringNode.contentLoc;
+        if (location) {
+            return source.substring(location.startOffset, location.startOffset + location.length);
+        }
+        return "";
+    }
+    static extractExpressionSource(embeddedNode, source) {
+        const openingLocation = embeddedNode.openingLoc;
+        const closingLocation = embeddedNode.closingLoc;
+        if (!openingLocation || !closingLocation)
+            return null;
+        const expressionStart = openingLocation.startOffset + openingLocation.length;
+        const expressionEnd = closingLocation.startOffset;
+        return source.substring(expressionStart, expressionEnd);
+    }
+    static extractReplacementParts(prismNode, source) {
+        const nodeType = prismNode.constructor.name;
+        if (nodeType === STRING_NODE_TYPE) {
+            const textContent = this.extractStringContent(prismNode, source);
+            return [{ type: "text", content: textContent }];
+        }
+        if (nodeType === INTERPOLATED_STRING_NODE_TYPE) {
+            const parts = prismNode.parts;
+            if (!parts || parts.length === 0)
+                return null;
+            const replacementParts = [];
+            for (const part of parts) {
+                const partType = part.constructor.name;
+                if (partType === STRING_NODE_TYPE) {
+                    const textContent = this.extractStringContent(part, source);
+                    if (textContent) {
+                        replacementParts.push({ type: "text", content: textContent });
+                    }
+                }
+                else if (partType === EMBEDDED_STATEMENTS_NODE_TYPE) {
+                    const expression = this.extractExpressionSource(part, source);
+                    if (expression) {
+                        replacementParts.push({ type: "expression", expression });
+                    }
+                }
+            }
+            return replacementParts.length > 0 ? replacementParts : null;
+        }
+        return null;
+    }
+}
+
 function serializeAttributeValue(value) {
     const hasERB = value.children.some(child => isERBContentNode(child));
     if (hasERB && value.children.length === 1 && isERBContentNode(value.children[0])) {
@@ -25540,6 +25773,7 @@ function rewriteString(herb, template, rewriters, options = {}) {
 
 exports.ASTRewriter = ASTRewriter;
 exports.ActionViewTagHelperToHTMLRewriter = ActionViewTagHelperToHTMLRewriter;
+exports.ERBStringToDirectOutputRewriter = ERBStringToDirectOutputRewriter;
 exports.HTMLToActionViewTagHelperRewriter = HTMLToActionViewTagHelperRewriter;
 exports.StringRewriter = StringRewriter;
 exports.asMutable = asMutable;