@openrewrite/rewrite 8.63.2 → 8.63.4

package/dist/javascript/preconditions.js

@@ -27,13 +27,13 @@ function hasSourcePath(filePattern) {
     }) : new search_2.IsSourceFile(filePattern);
 }
 function usesMethod(methodPattern, matchOverrides = false) {
-    return rpc_1.RewriteRpc.get() ? rpc_1.RewriteRpc.get().prepareRecipe("org.openrewrite.java.search.FindMethods", {
+    return rpc_1.RewriteRpc.get() ? rpc_1.RewriteRpc.get().prepareRecipe("org.openrewrite.java.search.HasMethod", {
         methodPattern,
         matchOverrides
     }) : new search_1.UsesMethod(methodPattern);
 }
 function usesType(fullyQualifiedType) {
-    return rpc_1.RewriteRpc.get() ? rpc_1.RewriteRpc.get().prepareRecipe("org.openrewrite.java.search.FindTypes", {
+    return rpc_1.RewriteRpc.get() ? rpc_1.RewriteRpc.get().prepareRecipe("org.openrewrite.java.search.HasType", {
         fullyQualifiedType,
         checkAssignability: false
     }) : new search_1.UsesType(fullyQualifiedType);

package/dist/javascript/preconditions.js.map

@@ -1 +1 @@
-{"version":3,"file":"preconditions.js","sourceRoot":"","sources":["../../src/javascript/preconditions.ts"],"names":[],"mappings":";;AAsBA,sCAIC;AAED,gCAKC;AAED,4BAKC;AAxCD;;;;;;;;;;;;;;GAcG;AACH,gCAAkC;AAClC,qCAA8C;AAG9C,sCAAuC;AAGvC,SAAgB,aAAa,CAAC,WAAmB;IAC7C,OAAO,gBAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAU,CAAC,GAAG,EAAG,CAAC,aAAa,CAAC,iCAAiC,EAAE;QACzF,WAAW;KACd,CAAC,CAAC,CAAC,CAAC,IAAI,qBAAY,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,UAAU,CAAC,aAAqB,EAAE,iBAA0B,KAAK;IAC7E,OAAO,gBAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAU,CAAC,GAAG,EAAG,CAAC,aAAa,CAAC,yCAAyC,EAAE;QACjG,aAAa;QACb,cAAc;KACjB,CAAC,CAAC,CAAC,CAAC,IAAI,mBAAU,CAAC,aAAa,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,QAAQ,CAAC,kBAA0B;IAC/C,OAAO,gBAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAU,CAAC,GAAG,EAAG,CAAC,aAAa,CAAC,uCAAuC,EAAE;QAC/F,kBAAkB;QAClB,kBAAkB,EAAE,KAAK;KAC5B,CAAC,CAAC,CAAC,CAAC,IAAI,iBAAQ,CAAC,kBAAkB,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"preconditions.js","sourceRoot":"","sources":["../../src/javascript/preconditions.ts"],"names":[],"mappings":";;AAsBA,sCAIC;AAED,gCAKC;AAED,4BAKC;AAxCD;;;;;;;;;;;;;;GAcG;AACH,gCAAkC;AAClC,qCAA8C;AAG9C,sCAAuC;AAGvC,SAAgB,aAAa,CAAC,WAAmB;IAC7C,OAAO,gBAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAU,CAAC,GAAG,EAAG,CAAC,aAAa,CAAC,iCAAiC,EAAE;QACzF,WAAW;KACd,CAAC,CAAC,CAAC,CAAC,IAAI,qBAAY,CAAC,WAAW,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,UAAU,CAAC,aAAqB,EAAE,iBAA0B,KAAK;IAC7E,OAAO,gBAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAU,CAAC,GAAG,EAAG,CAAC,aAAa,CAAC,uCAAuC,EAAE;QAC/F,aAAa;QACb,cAAc;KACjB,CAAC,CAAC,CAAC,CAAC,IAAI,mBAAU,CAAC,aAAa,CAAC,CAAC;AACvC,CAAC;AAED,SAAgB,QAAQ,CAAC,kBAA0B;IAC/C,OAAO,gBAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAU,CAAC,GAAG,EAAG,CAAC,aAAa,CAAC,qCAAqC,EAAE;QAC7F,kBAAkB;QAClB,kBAAkB,EAAE,KAAK;KAC5B,CAAC,CAAC,CAAC,CAAC,IAAI,iBAAQ,CAAC,kBAAkB,CAAC,CAAC;AAC1C,CAAC"}

package/dist/javascript/templating.d.ts

@@ -13,27 +13,65 @@ export interface Capture {
 /**
  * Creates a capture specification for use in template patterns.
  *
+ * @param name Optional name for the capture. If not provided, an auto-generated name is used.
  * @returns A Capture object
  *
  * @example
- * // Multiple captures
+ * // Named inline captures
+ * const pattern = pattern`${capture('left')} + ${capture('right')}`;
+ *
+ * // Unnamed captures
  * const {left, right} = {left: capture(), right: capture()};
  * const pattern = pattern`${left} + ${right}`;
  *
  * // Repeated patterns using the same capture
- * const expr = capture();
+ * const expr = capture('expr');
  * const redundantOr = pattern`${expr} || ${expr}`;
  */
-export declare function capture(): Capture;
+export declare function capture(name?: string): Capture;
 export declare namespace capture {
     var nextUnnamedId: number;
 }
+/**
+ * Concise alias for `capture`. Works well for inline captures in patterns and templates.
+ *
+ * @param name Optional name for the capture. If not provided, an auto-generated name is used.
+ * @returns A Capture object
+ *
+ * @example
+ * // Inline captures with _ alias
+ * pattern`isDate(${_('dateArg')})`
+ * template`${_('dateArg')} instanceof Date`
+ */
+export declare const _: typeof capture;
+/**
+ * Configuration options for patterns.
+ */
+export interface PatternOptions {
+    /**
+     * Import statements to provide type attribution context.
+     * These are prepended to the pattern when parsing to ensure proper type information.
+     */
+    imports?: string[];
+    /**
+     * NPM dependencies required for import resolution and type attribution.
+     * Maps package names to version specifiers (e.g., { 'util': '^1.0.0' }).
+     * The template engine will create a package.json with these dependencies.
+     */
+    dependencies?: Record<string, string>;
+}
 /**
  * Represents a pattern that can be matched against AST nodes.
  */
 export declare class Pattern {
     readonly templateParts: TemplateStringsArray;
     readonly captures: Capture[];
+    private _options;
+    /**
+     * Gets the configuration options for this pattern.
+     * @readonly
+     */
+    get options(): Readonly<PatternOptions>;
     /**
      * Creates a new pattern from template parts and captures.
      *
@@ -41,6 +79,20 @@ export declare class Pattern {
      * @param captures The captures between the string parts
      */
     constructor(templateParts: TemplateStringsArray, captures: Capture[]);
+    /**
+     * Configures this pattern with additional options.
+     *
+     * @param options Configuration options
+     * @returns This pattern for method chaining
+     *
+     * @example
+     * pattern`isDate(${capture('date')})`
+     *     .configure({
+     *         imports: ['import { isDate } from "util"'],
+     *         dependencies: { 'util': '^1.0.0' }
+     *     })
+     */
+    configure(options: PatternOptions): Pattern;
     /**
      * Creates a matcher for this pattern against a specific AST node.
      *
@@ -74,6 +126,22 @@ export declare function pattern(strings: TemplateStringsArray, ...captures: (Cap
  * - Primitives: Values to be converted to literals
  */
 export type TemplateParameter = Capture | Tree | string | number | boolean;
+/**
+ * Configuration options for templates.
+ */
+export interface TemplateOptions {
+    /**
+     * Import statements to provide type attribution context.
+     * These are prepended to the template when parsing to ensure proper type information.
+     */
+    imports?: string[];
+    /**
+     * NPM dependencies required for import resolution and type attribution.
+     * Maps package names to version specifiers (e.g., { 'util': '^1.0.0' }).
+     * The template engine will create a package.json with these dependencies.
+     */
+    dependencies?: Record<string, string>;
+}
 /**
  * Template for creating AST nodes.
  *
@@ -91,6 +159,7 @@ export type TemplateParameter = Capture | Tree | string | number | boolean;
 export declare class Template {
     private readonly templateParts;
     private readonly parameters;
+    private options;
     /**
      * Creates a new template.
      *
@@ -98,6 +167,20 @@ export declare class Template {
      * @param parameters The parameters between the string parts
      */
     constructor(templateParts: TemplateStringsArray, parameters: Parameter[]);
+    /**
+     * Configures this template with additional options.
+     *
+     * @param options Configuration options
+     * @returns This template for method chaining
+     *
+     * @example
+     * template`isDate(${capture('date')})`
+     *     .configure({
+     *         imports: ['import { isDate } from "util"'],
+     *         dependencies: { 'util': '^1.0.0' }
+     *     })
+     */
+    configure(options: TemplateOptions): Template;
     /**
      * Applies this template and returns the resulting tree.
      *
@@ -123,6 +206,15 @@ interface Parameter {
  * Represents a replacement rule that can match a pattern and apply a template.
  */
 export interface RewriteRule {
+    /**
+     * Attempts to apply this rewrite rule to the given AST node.
+     *
+     * @param cursor The cursor context at the current position in the AST
+     * @param node The AST node to try matching and transforming
+     * @returns The transformed node if a pattern matched, or `undefined` if no pattern matched.
+     *          When using in a visitor, always use the `|| node` pattern to return the original
+     *          node when there's no match: `return await rule.tryOn(this.cursor, node) || node;`
+     */
     tryOn(cursor: Cursor, node: J): Promise<J | undefined>;
 }
 /**
@@ -140,20 +232,33 @@ export interface RewriteConfig {
  *
  * @example
  * // Single pattern
- * const swapOperands = replace<J.Binary>(() => ({
+ * const swapOperands = rewrite(() => ({
  *     before: pattern`${"left"} + ${"right"}`,
  *     after: template`${"right"} + ${"left"}`
  * }));
  *
  * @example
  * // Multiple patterns
- * const normalizeComparisons = replace<J.Binary>(() => ({
+ * const normalizeComparisons = rewrite(() => ({
  *     before: [
  *         pattern`${"left"} == ${"right"}`,
  *         pattern`${"left"} === ${"right"}`
  *     ],
  *     after: template`${"left"} === ${"right"}`
  * }));
+ *
+ * @example
+ * // Using in a visitor - IMPORTANT: use `|| node` to handle undefined when no match
+ * class MyVisitor extends JavaScriptVisitor<any> {
+ *     override async visitBinary(binary: J.Binary, p: any): Promise<J | undefined> {
+ *         const rule = rewrite(() => ({
+ *             before: pattern`${capture('a')} + ${capture('b')}`,
+ *             after: template`${capture('b')} + ${capture('a')}`
+ *         }));
+ *         // tryOn() returns undefined if no pattern matches, so always use || node
+ *         return await rule.tryOn(this.cursor, binary) || binary;
+ *     }
+ * }
  */
 export declare function rewrite(builderFn: () => RewriteConfig): RewriteRule;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"templating.d.ts","sourceRoot":"","sources":["../../src/javascript/templating.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAC,MAAM,EAAU,IAAI,EAAC,MAAM,IAAI,CAAC;AACxC,OAAO,EAAC,CAAC,EAAC,MAAM,SAAS,CAAC;AAI1B;;;GAGG;AACH,MAAM,WAAW,OAAO;IACpB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;CAChB;AASD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,IAAI,OAAO,CAEjC;yBAFe,OAAO;;;AAOvB;;GAEG;AACH,qBAAa,OAAO;aAQI,aAAa,EAAE,oBAAoB;aACnC,QAAQ,EAAE,OAAO,EAAE;IARvC;;;;;OAKG;gBAEiB,aAAa,EAAE,oBAAoB,EACnC,QAAQ,EAAE,OAAO,EAAE;IAIvC;;;;;OAKG;IACG,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;CAKxD;AAED,qBAAa,WAAY,YAAW,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC;IAEvD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,GAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAa;IAIzD,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,CAAC,GAAG,SAAS;CAIhD;AAqGD;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,QAAQ,EAAE,CAAC,OAAO,GAAG,MAAM,CAAC,EAAE,GAAG,OAAO,CAMjG;AAmBD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IAQb,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR/B;;;;;OAKG;gBAEkB,aAAa,EAAE,oBAAoB,EACnC,UAAU,EAAE,SAAS,EAAE;IAI5C;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;CAMrG;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,UAAU,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CAQpG;AAED;;;GAGG;AACH,UAAU,SAAS;IACf;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC;CACd;AAgZD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;IAC5B,KAAK,EAAE,QAAQ,CAAC;CACnB;AA6BD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACnB,SAAS,EAAE,MAAM,aAAa,GAC/B,WAAW,CASb"}
+{"version":3,"file":"templating.d.ts","sourceRoot":"","sources":["../../src/javascript/templating.ts"],"names":[],"mappings":"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"}