@openrewrite/rewrite 8.69.0-20251212-132620 → 8.69.0-20251212-152027

package/dist/javascript/index.d.ts

@@ -13,6 +13,7 @@ export * from "./templating/index";
 export * from "./method-matcher";
 export * from "./format";
 export * from "./autodetect";
+export * from "./tree-debug";
 export * from "./add-import";
 export * from "./remove-import";
 export * from "./recipes/index";

package/dist/javascript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/javascript/index.ts"],"names":[],"mappings":"AAeA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,SAAS,CAAC;AACjB,OAAO,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/javascript/index.ts"],"names":[],"mappings":"AAeA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAE7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,OAAO,SAAS,CAAC;AACjB,OAAO,OAAO,CAAC"}

package/dist/javascript/index.js

@@ -44,6 +44,7 @@ __exportStar(require("./templating/index"), exports);
 __exportStar(require("./method-matcher"), exports);
 __exportStar(require("./format"), exports);
 __exportStar(require("./autodetect"), exports);
+__exportStar(require("./tree-debug"), exports);
 __exportStar(require("./add-import"), exports);
 __exportStar(require("./remove-import"), exports);
 __exportStar(require("./recipes/index"), exports);

package/dist/javascript/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/javascript/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B;AAC7B,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,2DAAyC;AACzC,wDAAsC;AACtC,oDAAkC;AAClC,uDAAqC;AACrC,kDAAgC;AAChC,qDAAmC;AACnC,mDAAiC;AACjC,2CAAyB;AACzB,+CAA6B;AAE7B,+CAA6B;AAC7B,kDAAgC;AAChC,kDAAgC;AAChC,iDAA+B;AAE/B,mBAAiB;AACjB,iBAAe"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/javascript/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,yCAAuB;AACvB,4CAA0B;AAC1B,+CAA6B;AAC7B,2CAAyB;AACzB,0CAAwB;AACxB,4CAA0B;AAC1B,2DAAyC;AACzC,wDAAsC;AACtC,oDAAkC;AAClC,uDAAqC;AACrC,kDAAgC;AAChC,qDAAmC;AACnC,mDAAiC;AACjC,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAE7B,+CAA6B;AAC7B,kDAAgC;AAChC,kDAAgC;AAChC,iDAA+B;AAE/B,mBAAiB;AACjB,iBAAe"}

package/dist/javascript/tree-debug.d.ts

@@ -0,0 +1,140 @@
+import { Cursor, Tree } from "../tree";
+import { J } from "../java";
+import { JavaScriptVisitor } from "./visitor";
+/**
+ * Options for controlling LST debug output.
+ */
+export interface LstDebugOptions {
+    /** Include cursor messages in output. Default: true */
+    includeCursorMessages?: boolean;
+    /** Include markers in output. Default: false */
+    includeMarkers?: boolean;
+    /** Include IDs in output. Default: false */
+    includeIds?: boolean;
+    /** Maximum depth to traverse. Default: unlimited (-1) */
+    maxDepth?: number;
+    /** Properties to always exclude (in addition to defaults). */
+    excludeProperties?: string[];
+    /** Output destination: 'console' or a file path. Default: 'console' */
+    output?: 'console' | string;
+    /** Indent string for nested output. Default: '  ' */
+    indent?: string;
+}
+/**
+ * Format whitespace string for readable debug output.
+ * Uses compact notation with subscript counts:
+ * - '\n' = 1 newline (implicit ₁)
+ * - '\n₂' = 2 newlines
+ * - '·₄' = 4 spaces
+ * - '-₂' = 2 tabs
+ * - '\n·₄' = newline + 4 spaces
+ * - '\n·₄-₂' = newline + 4 spaces + 2 tabs
+ */
+export declare function formatWhitespace(whitespace: string | undefined): string;
+/**
+ * Format a J.Space for debug output.
+ *
+ * Compact format:
+ * - Empty space: `''`
+ * - Whitespace only: `'\n·₄'`
+ * - Comment only: `//comment`
+ * - Comment with suffix: `//comment'\n'`
+ * - Multiple comments: `//c1'\n' + //c2'\n·₄'`
+ */
+export declare function formatSpace(space: J.Space | undefined): string;
+/**
+ * Format cursor messages for debug output.
+ * Returns '<no messages>' if no messages, otherwise returns '⟨key=value, ...⟩'
+ */
+export declare function formatCursorMessages(cursor: Cursor | undefined): string;
+/**
+ * Find which property of the parent contains the given child element.
+ * Returns the property name, or property name with array index if in an array.
+ * Returns undefined if the relationship cannot be determined.
+ *
+ * @param cursor - The cursor at the current position
+ * @param child - Optional: the actual child node being visited (for RightPadded/LeftPadded/Container visits where cursor.value is the parent)
+ */
+export declare function findPropertyPath(cursor: Cursor | undefined, child?: any): string | undefined;
+/**
+ * LST Debug Printer - prints LST nodes in a readable format.
+ *
+ * Usage from within a visitor:
+ * ```typescript
+ * class MyVisitor extends JavaScriptVisitor<P> {
+ *     private debug = new LstDebugPrinter({ includeCursorMessages: true });
+ *
+ *     async visitMethodInvocation(mi: J.MethodInvocation, p: P) {
+ *         this.debug.print(mi, this.cursor);
+ *         return super.visitMethodInvocation(mi, p);
+ *     }
+ * }
+ * ```
+ */
+export declare class LstDebugPrinter {
+    private readonly options;
+    private outputLines;
+    constructor(options?: LstDebugOptions);
+    /**
+     * Print a tree node with optional cursor context.
+     * @param tree The tree node to print
+     * @param cursor Optional cursor for context
+     * @param label Optional label to identify this debug output (shown as comment before output)
+     */
+    print(tree: Tree | J.Container<any> | J.LeftPadded<any> | J.RightPadded<any>, cursor?: Cursor, label?: string): void;
+    /**
+     * Print the cursor path from root to current position.
+     */
+    printCursorPath(cursor: Cursor): void;
+    private printNode;
+    private printJavaNode;
+    private printNodeProperties;
+    private printContainer;
+    private printLeftPadded;
+    private printRightPadded;
+    private printGenericObject;
+    private isSpace;
+    private isContainer;
+    private isLeftPadded;
+    private isRightPadded;
+    private indent;
+    private flush;
+}
+/**
+ * A visitor that prints the LST structure as it traverses.
+ * Useful for debugging the entire tree or a subtree.
+ *
+ * Usage:
+ * ```typescript
+ * const debugVisitor = new LstDebugVisitor({ maxDepth: 3 });
+ * await debugVisitor.visit(tree, ctx);
+ * ```
+ */
+export declare class LstDebugVisitor<P> extends JavaScriptVisitor<P> {
+    private readonly printer;
+    private readonly printPreVisit;
+    private readonly printPostVisit;
+    private depth;
+    constructor(options?: LstDebugOptions, config?: {
+        printPreVisit?: boolean;
+        printPostVisit?: boolean;
+    });
+    protected preVisit(tree: J, _p: P): Promise<J | undefined>;
+    protected postVisit(tree: J, _p: P): Promise<J | undefined>;
+    visitContainer<T extends J>(container: J.Container<T>, p: P): Promise<J.Container<T>>;
+    visitLeftPadded<T extends J | J.Space | number | string | boolean>(left: J.LeftPadded<T>, p: P): Promise<J.LeftPadded<T> | undefined>;
+    visitRightPadded<T extends J | boolean>(right: J.RightPadded<T>, p: P): Promise<J.RightPadded<T> | undefined>;
+}
+/**
+ * Convenience function to print a tree node.
+ * @param tree The tree node to print
+ * @param cursor Optional cursor for context
+ * @param label Optional label to identify this debug output
+ * @param options Optional debug options
+ */
+export declare function debugPrint(tree: Tree, cursor?: Cursor, label?: string, options?: LstDebugOptions): void;
+/**
+ * Convenience function to print cursor path.
+ */
+export declare function debugPrintCursorPath(cursor: Cursor, options?: LstDebugOptions): void;
+//# sourceMappingURL=tree-debug.d.ts.map

package/dist/javascript/tree-debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-debug.d.ts","sourceRoot":"","sources":["../../src/javascript/tree-debug.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,MAAM,EAAE,IAAI,EAAC,MAAM,SAAS,CAAC;AACrC,OAAO,EAA2C,CAAC,EAAc,MAAM,SAAS,CAAC;AAEjF,OAAO,EAAC,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,uDAAuD;IACvD,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,uEAAuE;IACvE,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoEvE;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,GAAG,SAAS,GAAG,MAAM,CAmC9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAoBvE;AAYD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAqG5F;AA+CD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,WAAW,CAAgB;gBAEvB,OAAO,GAAE,eAAoB;IAIzC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IASpH;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBrC,OAAO,CAAC,SAAS;IAmDjB,OAAO,CAAC,aAAa;IAuCrB,OAAO,CAAC,mBAAmB;IAuD3B,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,eAAe;IAyBvB,OAAO,CAAC,gBAAgB;IAwBxB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,OAAO;IAQf,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,KAAK;CAWhB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,KAAK,CAAK;gBAGd,OAAO,GAAE,eAAoB,EAC7B,MAAM,GAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO;cAQtD,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;cA8BhD,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAUpD,cAAc,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IA0BrF,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAC1E,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EACrB,CAAC,EAAE,CAAC,GACL,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAmC1B,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,OAAO,EAC/C,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EACvB,CAAC,EAAE,CAAC,GACL,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAkC3C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAEvG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAEpF"}