@openrewrite/rewrite 8.69.0 → 8.69.1

package/dist/javascript/format/prettier-config-loader.js

@@ -0,0 +1,419 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrettierConfigLoader = void 0;
+exports.clearPrettierModuleCache = clearPrettierModuleCache;
+exports.loadPrettierVersion = loadPrettierVersion;
+/*
+ * Copyright 2025 the original author or authors.
+ * <p>
+ * Licensed under the Moderne Source Available License (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * <p>
+ * https://docs.moderne.io/licensing/moderne-source-available-license
+ * <p>
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const fsp = __importStar(require("fs/promises"));
+const os = __importStar(require("os"));
+const child_process_1 = require("child_process");
+const style_1 = require("../style");
+const uuid_1 = require("../../uuid");
+/**
+ * Cache of loaded Prettier modules by version.
+ * This ensures we don't reload the same version multiple times.
+ *
+ * Use `clearPrettierModuleCache()` to clear this cache if needed
+ * (e.g., in long-running processes to free memory).
+ */
+const prettierModuleCache = new Map();
+/**
+ * Cache of pending Prettier load operations.
+ * Prevents concurrent requests for the same version from duplicating work.
+ */
+const pendingLoads = new Map();
+/**
+ * Clears the in-memory Prettier module cache.
+ * Call this in long-running processes to free memory when Prettier
+ * versions are no longer needed.
+ */
+function clearPrettierModuleCache() {
+    prettierModuleCache.clear();
+    pendingLoads.clear();
+}
+/**
+ * Gets the cache directory for a specific Prettier version.
+ * Uses ~/.cache/openrewrite/prettier/<version>/
+ */
+function getPrettierCacheDir(version) {
+    const cacheBase = path.join(os.homedir(), '.cache', 'openrewrite', 'prettier');
+    return path.join(cacheBase, version);
+}
+/**
+ * Checks if a Prettier version is installed in the cache.
+ */
+function isPrettierCached(version) {
+    const cacheDir = getPrettierCacheDir(version);
+    const prettierPath = path.join(cacheDir, 'node_modules', 'prettier', 'package.json');
+    if (!fs.existsSync(prettierPath)) {
+        return false;
+    }
+    // Verify the installed version matches
+    try {
+        const pkg = JSON.parse(fs.readFileSync(prettierPath, 'utf8'));
+        return pkg.version === version;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Installs a specific Prettier version to the cache directory.
+ */
+function installPrettierToCache(version) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const cacheDir = getPrettierCacheDir(version);
+        // Create directory structure
+        yield fsp.mkdir(cacheDir, { recursive: true });
+        // Create minimal package.json
+        const packageJson = {
+            name: `prettier-cache-${version}`,
+            version: '1.0.0',
+            private: true,
+            dependencies: {
+                prettier: version
+            }
+        };
+        yield fsp.writeFile(path.join(cacheDir, 'package.json'), JSON.stringify(packageJson, null, 2));
+        // Run npm install
+        const result = (0, child_process_1.spawnSync)('npm', ['install', '--silent'], {
+            cwd: cacheDir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 120000 // 2 minutes
+        });
+        if (result.error) {
+            throw new Error(`Failed to install Prettier ${version}: ${result.error.message}`);
+        }
+        if (result.status !== 0) {
+            const stderr = ((_a = result.stderr) === null || _a === void 0 ? void 0 : _a.trim()) || '';
+            throw new Error(`Failed to install Prettier ${version}: npm exited with code ${result.status}${stderr ? '\n' + stderr : ''}`);
+        }
+        // Verify installation
+        if (!isPrettierCached(version)) {
+            throw new Error(`Prettier ${version} installation verification failed`);
+        }
+    });
+}
+/**
+ * Loads Prettier from the cache directory for a specific version.
+ */
+function loadPrettierFromCache(version) {
+    const cacheDir = getPrettierCacheDir(version);
+    const prettierPath = path.join(cacheDir, 'node_modules', 'prettier');
+    // Clear require cache for this path to ensure fresh load
+    // (in case the version was reinstalled)
+    const resolvedPath = require.resolve(prettierPath);
+    delete require.cache[resolvedPath];
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    return require(prettierPath);
+}
+/**
+ * Manages Prettier configuration detection and loading for a parse session.
+ *
+ * This class:
+ * 1. Detects if Prettier is installed in the project
+ * 2. Resolves Prettier config per-file (with overrides)
+ * 3. Caches resolved configs for marker deduplication
+ * 4. Creates PrettierStyle markers for source files
+ *
+ * The marker only stores the version and resolved config - at formatting time,
+ * the correct version of Prettier will be loaded dynamically (like npx).
+ */
+class PrettierConfigLoader {
+    /**
+     * Creates a new PrettierConfigLoader for a project.
+     *
+     * @param projectRoot The root directory of the project (where package.json is)
+     */
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.configCache = new Map();
+    }
+    /**
+     * Detects Prettier in the project and loads our bundled version for config resolution.
+     * Call this once at the start of parsing.
+     */
+    detectPrettier() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.detection) {
+                return this.detection;
+            }
+            this.detection = { available: false };
+            try {
+                // Get the project's Prettier version from package.json or node_modules
+                const version = this.getPrettierVersionFromProject();
+                if (!version) {
+                    return this.detection;
+                }
+                // Load our bundled Prettier for config resolution
+                // We use dynamic require to handle cases where Prettier isn't installed
+                let bundledPrettier;
+                try {
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports
+                    bundledPrettier = require('prettier');
+                }
+                catch (e) {
+                    // Our bundled Prettier isn't available
+                    console.warn('PrettierConfigLoader: Failed to load bundled Prettier:', e);
+                    return this.detection;
+                }
+                this.detection = {
+                    available: true,
+                    version,
+                    bundledPrettier
+                };
+            }
+            catch (_a) {
+                // Any error means Prettier isn't properly set up
+                this.detection = { available: false };
+            }
+            return this.detection;
+        });
+    }
+    /**
+     * Gets the Prettier version from the project's package.json or node_modules.
+     * Scans upward from projectRoot to support monorepo structures where Prettier
+     * is installed at the repository root.
+     */
+    getPrettierVersionFromProject() {
+        // Scan upward from projectRoot to find Prettier
+        // This handles monorepos where Prettier is at the root but files are in subdirectories
+        let dir = this.projectRoot;
+        while (true) {
+            // First, check for prettier in node_modules (actual installation)
+            const prettierPackageJson = path.join(dir, 'node_modules', 'prettier', 'package.json');
+            if (fs.existsSync(prettierPackageJson)) {
+                try {
+                    const pkg = JSON.parse(fs.readFileSync(prettierPackageJson, 'utf8'));
+                    return pkg.version;
+                }
+                catch (_a) {
+                    // Corrupted package.json, continue scanning
+                }
+            }
+            // Check package.json for prettier dependency (might be a range like ^3.0.0)
+            const packageJsonPath = path.join(dir, 'package.json');
+            if (fs.existsSync(packageJsonPath)) {
+                try {
+                    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+                    const deps = Object.assign(Object.assign({}, packageJson.dependencies), packageJson.devDependencies);
+                    if (deps.prettier) {
+                        // Found prettier as a dependency, but node_modules wasn't found
+                        // This might mean dependencies aren't installed yet
+                        // Continue scanning upward in case there's a parent with node_modules
+                    }
+                }
+                catch (_b) {
+                    // package.json parse error, continue
+                }
+            }
+            // Move up to parent directory
+            const parent = path.dirname(dir);
+            if (parent === dir) {
+                // Reached filesystem root
+                break;
+            }
+            dir = parent;
+        }
+        return undefined;
+    }
+    /**
+     * Finds the .prettierignore file by scanning upward from projectRoot.
+     * Returns undefined if no .prettierignore file is found.
+     */
+    findPrettierIgnore() {
+        let dir = this.projectRoot;
+        while (true) {
+            const ignorePath = path.join(dir, '.prettierignore');
+            if (fs.existsSync(ignorePath)) {
+                return ignorePath;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir) {
+                // Reached filesystem root
+                break;
+            }
+            dir = parent;
+        }
+        return undefined;
+    }
+    /**
+     * Gets or creates a PrettierStyle marker for the given source file.
+     * Returns undefined if Prettier is not available or no config applies to this file.
+     *
+     * @param filePath Absolute path to the source file
+     */
+    getConfigMarker(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            if (!((_a = this.detection) === null || _a === void 0 ? void 0 : _a.available) || !this.detection.bundledPrettier) {
+                return undefined;
+            }
+            try {
+                // Resolve path against projectRoot if not absolute
+                const absolutePath = path.isAbsolute(filePath)
+                    ? filePath
+                    : path.join(this.projectRoot, filePath);
+                // Check if file is ignored by .prettierignore
+                const ignorePath = this.findPrettierIgnore();
+                let ignored = false;
+                if (ignorePath) {
+                    const fileInfo = yield this.detection.bundledPrettier.getFileInfo(absolutePath, { ignorePath });
+                    ignored = fileInfo.ignored;
+                }
+                // Resolve config for this specific file (applies overrides)
+                // If no config file exists, use empty config (Prettier defaults)
+                const config = (_b = yield this.detection.bundledPrettier.resolveConfig(absolutePath)) !== null && _b !== void 0 ? _b : {};
+                // Create a cache key from the resolved config + version + ignored status
+                const configKey = JSON.stringify({ config, version: this.detection.version, ignored });
+                // Check cache for existing marker with same config
+                let marker = this.configCache.get(configKey);
+                if (marker) {
+                    return marker;
+                }
+                // Create new PrettierStyle instance
+                marker = new style_1.PrettierStyle((0, uuid_1.randomId)(), config, this.detection.version, ignored);
+                // Cache and return
+                this.configCache.set(configKey, marker);
+                return marker;
+            }
+            catch (e) {
+                // Config resolution failed for this file
+                console.warn(`PrettierConfigLoader: Failed to resolve config for ${filePath}:`, e);
+                return undefined;
+            }
+        });
+    }
+    /**
+     * Clears the config cache. Call this between parse batches if needed.
+     */
+    clearCache() {
+        this.configCache.clear();
+    }
+}
+exports.PrettierConfigLoader = PrettierConfigLoader;
+/**
+ * Dynamically loads a specific version of Prettier for formatting.
+ *
+ * This function will attempt to load Prettier in this order:
+ * 1. From the in-memory cache (if already loaded)
+ * 2. From the current working directory's node_modules (if version matches)
+ * 3. From the cached npm project at ~/.cache/openrewrite/prettier/<version>/
+ * 4. Install to cache and load from there
+ *
+ * Concurrent requests for the same version are deduplicated.
+ *
+ * @param version The Prettier version to load (e.g., "3.4.2")
+ * @returns The loaded Prettier module
+ */
+function loadPrettierVersion(version) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Check in-memory cache first
+        const cached = prettierModuleCache.get(version);
+        if (cached) {
+            return cached;
+        }
+        // Check if there's already a pending load for this version
+        const pending = pendingLoads.get(version);
+        if (pending) {
+            return pending;
+        }
+        // Create and cache the load promise to prevent concurrent duplicate loads
+        const loadPromise = loadPrettierVersionInternal(version);
+        pendingLoads.set(version, loadPromise);
+        try {
+            const prettier = yield loadPromise;
+            prettierModuleCache.set(version, prettier);
+            return prettier;
+        }
+        finally {
+            pendingLoads.delete(version);
+        }
+    });
+}
+/**
+ * Internal implementation of Prettier version loading.
+ */
+function loadPrettierVersionInternal(version) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Try to load from local node_modules if version matches
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const localPrettier = require('prettier');
+            if (localPrettier.version === version) {
+                return localPrettier;
+            }
+        }
+        catch (_a) {
+            // Local prettier not available
+        }
+        // Check if version is cached on disk
+        if (isPrettierCached(version)) {
+            return loadPrettierFromCache(version);
+        }
+        // Install to cache and load
+        yield installPrettierToCache(version);
+        return loadPrettierFromCache(version);
+    });
+}
+//# sourceMappingURL=prettier-config-loader.js.map

package/dist/javascript/format/prettier-config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettier-config-loader.js","sourceRoot":"","sources":["../../../src/javascript/format/prettier-config-loader.ts"],"names":[],"mappings":"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"}

package/dist/javascript/format/prettier-format.d.ts

@@ -0,0 +1,111 @@
+import { JS } from '../tree';
+import { J } from '../../java';
+import { Cursor, Tree } from '../../tree';
+import { PrettierStyle } from '../style';
+import { NamedStyles } from '../../style';
+/**
+ * Options for Prettier formatting.
+ */
+export interface PrettierFormatOptions {
+    /**
+     * Tab width for indentation. Defaults to 2.
+     */
+    tabWidth?: number;
+    /**
+     * Use tabs instead of spaces. Defaults to false.
+     */
+    useTabs?: boolean;
+    /**
+     * Print semicolons at the ends of statements. Defaults to true.
+     */
+    semi?: boolean;
+    /**
+     * Use single quotes instead of double quotes. Defaults to false.
+     */
+    singleQuote?: boolean;
+    /**
+     * Print trailing commas wherever possible. Defaults to 'all'.
+     */
+    trailingComma?: 'all' | 'es5' | 'none';
+    /**
+     * Print width for line wrapping. Defaults to 80.
+     */
+    printWidth?: number;
+    /**
+     * Change when properties in objects are quoted.
+     * - "as-needed" - Only add quotes around object properties where required.
+     * - "consistent" - If at least one property in an object requires quotes, quote all properties.
+     * - "preserve" - Respect the input use of quotes in object properties.
+     * Defaults to "as-needed".
+     */
+    quoteProps?: 'as-needed' | 'consistent' | 'preserve';
+    /**
+     * The Prettier version to use (e.g., "3.4.2").
+     * If specified, loads that version from cache or installs it.
+     * If not specified, uses the bundled Prettier.
+     */
+    prettierVersion?: string;
+}
+/**
+ * Formats a JavaScript/TypeScript AST using Prettier.
+ *
+ * This function:
+ * 1. Prints the AST to a string
+ * 2. Formats the string using Prettier
+ * 3. Parses the formatted string back to an AST (without type attribution for performance)
+ * 4. Reconciles the whitespace from the formatted AST back into the original AST
+ *
+ * The result preserves the original AST's structure, types, and markers while
+ * applying Prettier's formatting rules for whitespace.
+ *
+ * @param sourceFile The source file to format
+ * @param options Prettier formatting options
+ * @param stopAfter Optional node to stop formatting after. Once this node is exited,
+ *                  no more whitespace changes are applied to subsequent nodes.
+ * @returns The formatted source file with reconciled whitespace
+ */
+export declare function prettierFormat(sourceFile: JS.CompilationUnit, options?: PrettierFormatOptions, stopAfter?: J): Promise<JS.CompilationUnit>;
+/**
+ * Formats a subtree of a JavaScript/TypeScript AST using Prettier.
+ *
+ * This function is optimized for formatting a small part of a larger tree:
+ * 1. Extracts the path from compilation unit to target
+ * 2. Prunes the tree (replaces siblings with placeholders)
+ * 3. Formats the pruned tree with Prettier
+ * 4. Finds the target in the formatted tree
+ * 5. Reconciles only the target subtree's whitespace
+ *
+ * @param target The subtree to format
+ * @param cursor The cursor pointing to or near the target
+ * @param options Prettier formatting options
+ * @param stopAfter Optional node to stop formatting after
+ * @returns The formatted subtree, or undefined if formatting failed
+ */
+export declare function prettierFormatSubtree<T extends J>(target: T, cursor: Cursor, options?: PrettierFormatOptions, stopAfter?: J): Promise<T | undefined>;
+/**
+ * Gets the PrettierStyle from the styles array or source file markers.
+ *
+ * @param tree The tree being formatted
+ * @param cursor Optional cursor for walking up to find source file
+ * @param styles Optional styles array to check first
+ * @returns PrettierStyle if found, undefined otherwise
+ */
+export declare function getPrettierStyle(tree: Tree, cursor?: Cursor, styles?: NamedStyles<string>[]): PrettierStyle | undefined;
+/**
+ * Applies Prettier formatting to a tree.
+ *
+ * Configuration is resolved from the PrettierStyle marker on the source file.
+ *
+ * For compilation units, formats and reconciles the entire tree.
+ * For subtrees, uses prettierFormatSubtree which prunes the tree for efficiency,
+ * formats the pruned tree, and reconciles only the target subtree.
+ *
+ * @param tree The tree to format
+ * @param prettierStyle The PrettierStyle containing config
+ * @param p The visitor parameter
+ * @param cursor Optional cursor for subtree formatting
+ * @param stopAfter Optional tree to stop after
+ * @returns The formatted tree
+ */
+export declare function applyPrettierFormatting<R extends J, P>(tree: R, prettierStyle: PrettierStyle, p: P, cursor?: Cursor, stopAfter?: Tree): Promise<R | undefined>;
+//# sourceMappingURL=prettier-format.d.ts.map

package/dist/javascript/format/prettier-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prettier-format.d.ts","sourceRoot":"","sources":["../../../src/javascript/format/prettier-format.ts"],"names":[],"mappings":"AAeA,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAC,CAAC,EAAY,MAAM,YAAY,CAAC;AACxC,OAAO,EAAC,MAAM,EAAE,IAAI,EAAC,MAAM,YAAY,CAAC;AAMxC,OAAO,EAAC,aAAa,EAAY,MAAM,UAAU,CAAC;AAClD,OAAO,EAAC,WAAW,EAAC,MAAM,aAAa,CAAC;AAyBxC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAEvC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;IAErD;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,cAAc,CAChC,UAAU,EAAE,EAAE,CAAC,eAAe,EAC9B,OAAO,GAAE,qBAA0B,EACnC,SAAS,CAAC,EAAE,CAAC,GACd,OAAO,CAAC,EAAE,CAAC,eAAe,CAAC,CA0D7B;AA8QD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,CAAC,EACnD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,EACnC,SAAS,CAAC,EAAE,CAAC,GACd,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CA2BxB;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC5B,IAAI,EAAE,IAAI,EACV,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,GAC/B,aAAa,GAAG,SAAS,CA+B3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,EACxD,IAAI,EAAE,CAAC,EACP,aAAa,EAAE,aAAa,EAC5B,CAAC,EAAE,CAAC,EACJ,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,IAAI,GACjB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAsDxB"}