nx 23.2.0-beta.7 → 23.2.0-beta.9

package/dist/src/project-graph/utils/project-configuration/target-normalization.js

@@ -5,6 +5,8 @@ exports.normalizeTarget = normalizeTarget;
 exports.validateAndNormalizeProjectRootMap = validateAndNormalizeProjectRootMap;
 const executor_utils_1 = require("../../../command-line/run/executor-utils");
 const fileutils_1 = require("../../../utils/fileutils");
+const long_running_target_1 = require("../../../utils/long-running-target");
+const output_1 = require("../../../utils/output");
 const to_project_name_1 = require("../../../config/to-project-name");
 const error_types_1 = require("../../error-types");
 const target_merging_1 = require("./target-merging");
@@ -65,15 +67,137 @@ function normalizeTarget(target, project, workspaceRoot, projectsMap, errorMsgKe
     }
     return target;
 }
+// TODO(v24): remove the legacy target-name cache fallback and its warning.
+// Removal needs a second mechanism for plugin-inferred targets, which the
+// accompanying migration cannot reach.
+/**
+ * Whether `target` is cacheable only by way of the legacy name-based fallback:
+ * the exact target-name key of `targetDefaults` declares `cache: true`, but an
+ * executor key won target-default resolution instead, so the merged target never
+ * received it.
+ *
+ * A `true` result means the user's `cache: true` silently lost, so this doubles
+ * as the condition for warning them that the name key is being shadowed.
+ */
+function isLegacyCachedTarget(targetName, targetDefaults, target) {
+    // Resolution already decided `cache`, so the name key isn't shadowed.
+    if (target.cache !== undefined) {
+        return false;
+    }
+    if (isLongRunningTarget(targetName, target)) {
+        return false;
+    }
+    // Restricted to shadowing, which is narrower than what pre-23 restored: that
+    // derivation matched on target name alone, so a name key dropped as
+    // incompatible (its entry declared a foreign executor) was cacheable too.
+    // Restoring that as well would mean writing `cache` with no key to name in
+    // the warning, and no migration able to retire it. Deliberately not covered.
+    if (!findShadowingTargetDefaultKey(targetDefaults, target)) {
+        return false;
+    }
+    return declaresCacheTrue(targetDefaults?.[targetName]);
+}
+/**
+ * Whether the name key declares `cache: true` on an entry that always applies.
+ *
+ * Filters are deliberately not evaluated. They cannot express a pre-23 config
+ * (the filtered array shape postdates the behavior being restored), and a
+ * filtered entry declaring `cache` may or may not apply to this project — so
+ * rather than guess, a filtered `cache` declares the value unknowable and
+ * nothing is restored. Among unfiltered entries the last wins, matching the
+ * in-key merge order.
+ */
+function declaresCacheTrue(value) {
+    if (!value) {
+        return false;
+    }
+    const entries = Array.isArray(value) ? value : [value];
+    let declared;
+    for (const entry of entries) {
+        // `nx.json` is hand-edited; a null or scalar entry would throw here.
+        if (!entry || typeof entry !== 'object')
+            continue;
+        if (entry.cache === undefined)
+            continue;
+        if (entry.filter)
+            return false;
+        declared = entry.cache;
+    }
+    return declared === true;
+}
+/**
+ * The normalization-time half of the pre-23 `longRunningTask` guard, which kept
+ * `cacheableOperations` from ever making these cacheable. Its remaining clause
+ * — `task.overrides['watch']` — is a runtime invocation override with no target
+ * equivalent, so it has no counterpart here.
+ */
+function isLongRunningTarget(targetName, target) {
+    return !!target.continuous || (0, long_running_target_1.isLongRunningTargetName)(targetName);
+}
+/**
+ * The `targetDefaults` key that beat the target-name key for `target`. Only an
+ * executor key can: key precedence puts the exact target name ahead of every
+ * glob, so nothing else outranks it. Undefined when the name key lost for
+ * another reason (e.g. its entry declared a foreign executor and was dropped as
+ * incompatible) — see {@link isLegacyCachedTarget} for why that case is left
+ * alone even though pre-23 restored it.
+ *
+ * `hasOwnProperty` rather than a lookup: an executor named `__proto__` resolves
+ * through the prototype chain to a truthy object, which would report a key the
+ * user never wrote.
+ */
+function findShadowingTargetDefaultKey(targetDefaults, target) {
+    return target.executor &&
+        targetDefaults &&
+        Object.prototype.hasOwnProperty.call(targetDefaults, target.executor)
+        ? target.executor
+        : undefined;
+}
+/**
+ * Emits a single grouped warning for every (shadowing key, target-name key)
+ * pair that relied on the deprecated fallback. Grouping matters because the
+ * same pair recurs in every affected project — a per-target warning would
+ * print hundreds of identical lines in a large workspace.
+ */
+function warnAboutLegacyCachedTargets(legacyCacheReads) {
+    if (legacyCacheReads.size === 0) {
+        return;
+    }
+    const bodyLines = [];
+    for (const [shadowingKey, targetKeys] of legacyCacheReads) {
+        for (const targetKey of targetKeys) {
+            bodyLines.push(`  - "${shadowingKey}" does not set "cache", so it was read from "${targetKey}"`);
+        }
+    }
+    bodyLines.push('', 'An executor key applies to every target that resolves through it, so exclude any continuous target before setting "cache" on one — a target that is both cacheable and continuous is rejected.', 'Target defaults resolve to a single key rather than merging, so an executor key hides the target name key entirely.', 'Set "cache" on the executor key to keep these targets cacheable — reading it from the target name key is deprecated and will be removed in Nx 24.');
+    output_1.output.warn({
+        title: 'Some targets are only cacheable through a deprecated fallback.',
+        bodyLines,
+    });
+}
 function normalizeTargets(project, sourceMaps, nxJsonConfiguration, workspaceRoot, 
 /**
  * Project configurations keyed by project name
  */
-projects) {
+projects, 
+/**
+ * Shadowing `targetDefaults` key -> target name keys its `cache` was read
+ * from. Accumulated across projects so the deprecation warns once per pair.
+ */
+legacyCacheReads) {
     const targetErrorMessage = [];
     for (const targetName in project.targets) {
         project.targets[targetName] = normalizeTarget(project.targets[targetName], project, workspaceRoot, projects, [project.root, targetName].join(':'));
         const target = project.targets[targetName];
+        const targetDefaults = nxJsonConfiguration.targetDefaults;
+        if (isLegacyCachedTarget(targetName, targetDefaults, target)) {
+            target.cache = true;
+            // Always defined: `isLegacyCachedTarget` returns false without it.
+            const shadowingKey = findShadowingTargetDefaultKey(targetDefaults, target);
+            const targetKeys = legacyCacheReads.get(shadowingKey) ?? new Set();
+            targetKeys.add(targetName);
+            legacyCacheReads.set(shadowingKey, targetKeys);
+        }
         if (
         // If the target has no executor or command, it doesn't do anything
         !target.executor &&
@@ -106,6 +230,7 @@ function validateAndNormalizeProjectRootMap(workspaceRoot, projectRootMap, nxJso
     const conflicts = new Map();
     const projectRootsWithNoName = [];
     const validityErrors = [];
+    const legacyCacheReads = new Map();
     for (const root in projectRootMap) {
         const project = projectRootMap[root];
         // We're setting `// targets` as a comment `targets` is empty due to Project Crystal.
@@ -155,7 +280,7 @@ function validateAndNormalizeProjectRootMap(workspaceRoot, projectRootMap, nxJso
     for (const root in projectRootMap) {
         const project = projectRootMap[root];
         try {
-            normalizeTargets(project, sourceMaps, nxJsonConfiguration, workspaceRoot, projects);
+            normalizeTargets(project, sourceMaps, nxJsonConfiguration, workspaceRoot, projects, legacyCacheReads);
         }
         catch (e) {
             if (e instanceof error_types_1.WorkspaceValidityError) {
@@ -166,6 +291,7 @@ function validateAndNormalizeProjectRootMap(workspaceRoot, projectRootMap, nxJso
             }
         }
     }
+    warnAboutLegacyCachedTargets(legacyCacheReads);
     const errors = [];
     if (conflicts.size > 0) {
         errors.push(new error_types_1.MultipleProjectsWithSameNameError(conflicts, projects));

package/dist/src/tasks-runner/run-command.js

@@ -8,7 +8,7 @@ exports.constructLifeCycles = constructLifeCycles;
 exports.getRunner = getRunner;
 exports.getRunnerOptions = getRunnerOptions;
 const tslib_1 = require("tslib");
-const enquirer_1 = require("enquirer");
+const prompt_helpers_1 = require("../utils/prompt-helpers");
 const node_util_1 = require("node:util");
 const nx_json_1 = require("../config/nx-json");
 const client_1 = require("../daemon/client/client");
@@ -599,23 +599,19 @@ async function ensureWorkspaceIsInSyncAndGetGraphs(projectGraph, nxJson, project
 }
 async function promptForApplyingSyncGeneratorChanges() {
     try {
-        const promptConfig = {
-            name: 'applyChanges',
-            type: 'autocomplete',
-            message: 'Would you like to sync the identified changes to get your workspace up to date?',
+        // No footer slot, so the opt-out note is part of the message.
+        const applyChanges = await (0, prompt_helpers_1.selectPrompt)({
+            message: `Would you like to sync the identified changes to get your workspace up to date?${pc.dim('\nYou can skip this prompt by setting the `sync.applyChanges` option to `true` in your `nx.json`.\nFor more information, refer to the docs: https://nx.dev/concepts/sync-generators.')}`,
             choices: [
+                { value: 'yes', label: 'Yes, sync the changes and run the tasks' },
                 {
-                    name: 'yes',
-                    message: 'Yes, sync the changes and run the tasks',
-                },
-                {
-                    name: 'no',
-                    message: 'No, run the tasks without syncing the changes',
+                    value: 'no',
+                    label: 'No, run the tasks without syncing the changes',
                 },
             ],
-            footer: () => pc.dim('\nYou can skip this prompt by setting the `sync.applyChanges` option to `true` in your `nx.json`.\nFor more information, refer to the docs: https://nx.dev/concepts/sync-generators.'),
-        };
-        return await (0, enquirer_1.prompt)([promptConfig]).then(({ applyChanges }) => applyChanges === 'yes');
+            onCancel: () => process.exit(1),
+        });
+        return applyChanges === 'yes';
     }
     catch {
         process.exit(1);
@@ -623,26 +619,15 @@ async function promptForApplyingSyncGeneratorChanges() {
 }
 async function confirmRunningTasksWithSyncFailures() {
     try {
-        const promptConfig = {
-            name: 'runTasks',
-            type: 'autocomplete',
-            message: 'Would you like to ignore the sync failures and continue running the tasks?',
+        const runTasks = await (0, prompt_helpers_1.selectPrompt)({
+            message: `Would you like to ignore the sync failures and continue running the tasks?${pc.dim(`\nWhen running in CI and there are sync failures, the tasks won't run. Addressing the errors above is highly recommended to prevent failures in CI.`)}`,
             choices: [
-                {
-                    name: 'yes',
-                    message: 'Yes, ignore the failures and run the tasks',
-                },
-                {
-                    name: 'no',
-                    message: `No, don't run the tasks`,
-                },
+                { value: 'yes', label: 'Yes, ignore the failures and run the tasks' },
+                { value: 'no', label: `No, don't run the tasks` },
             ],
-            footer: () => pc.dim(`\nWhen running in CI and there are sync failures, the tasks won't run. Addressing the errors above is highly recommended to prevent failures in CI.`),
-        };
-        const runTasks = await (0, enquirer_1.prompt)([
-            promptConfig,
-        ]).then(({ runTasks }) => runTasks === 'yes');
-        if (!runTasks) {
+            onCancel: () => process.exit(1),
+        });
+        if (runTasks !== 'yes') {
             process.exit(1);
         }
     }

package/dist/src/tasks-runner/task-env.js

@@ -166,10 +166,13 @@ function getOwnerTargetForTask(task, graph) {
         for (const targets of Object.values(project.data.metadata.targetGroups)) {
             if (targets.includes(task.target.target)) {
                 for (const target of targets) {
-                    if (project.data.targets[target].metadata?.nonAtomizedTarget) {
+                    // a target group can name a target the project does not define —
+                    // inference plugins build the group and the targets separately, so
+                    // the two can disagree. skip the phantom rather than dereferencing it.
+                    if (project.data.targets[target]?.metadata?.nonAtomizedTarget) {
                         return [
                             target,
-                            project.data.targets[target].metadata?.nonAtomizedTarget,
+                            project.data.targets[target]?.metadata?.nonAtomizedTarget,
                         ];
                     }
                 }

package/dist/src/tasks-runner/utils.js

@@ -36,6 +36,7 @@ const fileutils_1 = require("../utils/fileutils");
 const find_matching_projects_1 = require("../utils/find-matching-projects");
 const legacy_depends_on_warning_1 = require("./legacy-depends-on-warning");
 const globs_1 = require("../utils/globs");
+const long_running_target_1 = require("../utils/long-running-target");
 const path_1 = require("../utils/path");
 const serialize_overrides_into_command_line_1 = require("../utils/serialize-overrides-into-command-line");
 const split_target_1 = require("../utils/split-target");
@@ -429,14 +430,9 @@ function isCacheableTask(task) {
     return task.cache;
 }
 function longRunningTask(task) {
-    const t = task.target.target;
     return (task.continuous ||
         (!!task.overrides['watch'] && task.overrides['watch'] !== 'false') ||
-        t.endsWith(':watch') ||
-        t.endsWith('-watch') ||
-        t === 'serve' ||
-        t === 'dev' ||
-        t === 'start');
+        (0, long_running_target_1.isLongRunningTargetName)(task.target.target));
 }
 // TODO: vsavkin remove when nx-cloud doesn't depend on it
 function unparse(options) {

package/dist/src/utils/analytics-prompt.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ensureAnalyticsPreferenceSet = ensureAnalyticsPreferenceSet;
 exports.promptForAnalyticsPreference = promptForAnalyticsPreference;
 const fs_1 = require("fs");
-const enquirer_1 = require("enquirer");
+const prompt_helpers_1 = require("./prompt-helpers");
 const path_1 = require("path");
 const output_1 = require("./output");
 const is_ci_1 = require("./is-ci");
@@ -47,16 +47,13 @@ async function promptForAnalyticsPreference() {
                 'Learn more: https://cloud.nx.app/privacy',
             ],
         });
-        const { enableAnalytics } = await (0, enquirer_1.prompt)({
-            type: 'confirm',
-            name: 'enableAnalytics',
+        return await (0, prompt_helpers_1.confirmationPrompt)({
             message: 'Share usage data with the Nx team?',
-            initial: true,
+            // Cancelling is a decline, not a failure.
+            onCancel: () => false,
         });
-        return enableAnalytics;
     }
     catch {
-        // User cancelled - default to false
         return false;
     }
 }

package/dist/src/utils/chunkify.d.ts

@@ -1,4 +1,10 @@
-export declare function chunkify(target: string[], maxChunkLength?: number): string[][];
+export declare function chunkify(target: string[], maxChunkLength?: number, 
+/**
+ * How long each entry will be once it reaches the command line. Callers that
+ * quote or escape afterwards pass that transformation's length here, so the
+ * chunk is sized against what is actually spawned rather than the raw string.
+ */
+measure?: (item: string) => number): string[][];
 /**
  * Get the maximum length of a command-line argument string based on current platform
  *

package/dist/src/utils/chunkify.js

@@ -3,22 +3,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.chunkify = chunkify;
 exports.getMaxArgLength = getMaxArgLength;
 const TERMINAL_SIZE = getMaxArgLength();
-function chunkify(target, maxChunkLength = TERMINAL_SIZE - 500) {
+function chunkify(target, maxChunkLength = TERMINAL_SIZE - 500, 
+/**
+ * How long each entry will be once it reaches the command line. Callers that
+ * quote or escape afterwards pass that transformation's length here, so the
+ * chunk is sized against what is actually spawned rather than the raw string.
+ */
+measure = (item) => item.length) {
     const chunks = [];
     let currentChunk = [];
     let currentChunkLength = 0;
     for (const file of target) {
+        const length = measure(file);
         if (
         // Prevent empty chunk if first file path is longer than maxChunkLength
         currentChunk.length &&
             // +1 accounts for the space between file names
-            currentChunkLength + file.length + 1 >= maxChunkLength) {
+            currentChunkLength + length + 1 >= maxChunkLength) {
             chunks.push(currentChunk);
             currentChunk = [];
             currentChunkLength = 0;
         }
         currentChunk.push(file);
-        currentChunkLength += file.length + 1;
+        currentChunkLength += length + 1;
     }
     chunks.push(currentChunk);
     return chunks;

package/dist/src/utils/exit-codes.d.ts

@@ -13,3 +13,12 @@ export declare const EXPECTED_TERMINATION_SIGNALS: Set<number>;
  * Handles both Linux exact-match and macOS strsignal formats (e.g. "Terminated by Hangup: 1").
  */
 export declare function messageToCode(message: string): number;
+/**
+ * Ends the process the way an interrupted process ends: by SIGINT, not by
+ * exiting with its conventional code.
+ *
+ * A shell reports 130 either way, but a parent using waitpid sees
+ * `signal: 'SIGINT'` rather than `code: 130`, which is what tools wrapping nx
+ * check to tell "the user pressed Ctrl+C" from "the command failed".
+ */
+export declare function exitAsInterrupted(): never;

package/dist/src/utils/exit-codes.js

@@ -4,6 +4,7 @@ exports.EXPECTED_TERMINATION_SIGNALS = void 0;
 exports.signalToCode = signalToCode;
 exports.codeToSignal = codeToSignal;
 exports.messageToCode = messageToCode;
+exports.exitAsInterrupted = exitAsInterrupted;
 /**
  * Translates NodeJS signals to numeric exit code
  * @param signal
@@ -73,3 +74,21 @@ function messageToCode(message) {
         return 1;
     }
 }
+/**
+ * Ends the process the way an interrupted process ends: by SIGINT, not by
+ * exiting with its conventional code.
+ *
+ * A shell reports 130 either way, but a parent using waitpid sees
+ * `signal: 'SIGINT'` rather than `code: 130`, which is what tools wrapping nx
+ * check to tell "the user pressed Ctrl+C" from "the command failed".
+ */
+function exitAsInterrupted() {
+    // Windows has no signal disposition to inherit - `process.kill` there
+    // terminates with an arbitrary code - so keep the 128+SIGINT convention.
+    if (process.platform !== 'win32') {
+        // Any listener would swallow this; the default action is what terminates.
+        process.removeAllListeners('SIGINT');
+        process.kill(process.pid, 'SIGINT');
+    }
+    process.exit(130);
+}

package/dist/src/utils/fileutils.d.ts

@@ -27,6 +27,11 @@ interface YamlReadOptions {
      * Compatibility with JSON.parse behaviour. If true, then duplicate keys in a mapping will override values rather than throwing an error.
      */
     json?: boolean;
+    /**
+     * Resolves only the tags every YAML parser must support, so every scalar stays
+     * a string instead of `true` or `12`.
+     */
+    failsafe?: boolean;
 }
 /**
  * Reads a YAML file and returns the object the YAML content represents.

package/dist/src/utils/fileutils.js

@@ -41,8 +41,13 @@ function readJsonFile(path, options) {
  */
 function readYamlFile(path, options) {
     const content = (0, node_fs_1.readFileSync)(path, 'utf-8');
-    const { load } = require('@zkochan/js-yaml');
-    return load(content, { ...options, filename: path });
+    const { load, FAILSAFE_SCHEMA } = require('@zkochan/js-yaml');
+    const { failsafe, ...loadOptions } = options ?? {};
+    return load(content, {
+        ...loadOptions,
+        ...(failsafe ? { schema: FAILSAFE_SCHEMA } : {}),
+        filename: path,
+    });
 }
 /**
  * Serializes the given data to JSON and writes it to a file.

package/dist/src/utils/formatters/index.d.ts

@@ -0,0 +1,13 @@
+import type { Tree } from '../../generators/tree';
+/**
+ * Adding a member here does NOT reliably break compilation: the repo builds
+ * with `strict: false`, so a `switch` that omits one is not an error. The
+ * `never` assertions and type-keyed tables that do catch it fail immediately
+ * inside `packages/nx`, but the ones in devkit and `@nx/js` read the type from
+ * its emitted declarations, so those only fail once it has been rebuilt.
+ */
+export type FormatterType = 'prettier' | 'oxfmt';
+/** Test-only: the warn-once flag is module state and would leak between cases. */
+export declare function resetFormatterWarningsForTesting(): void;
+export declare function detectFormatter(root: string): FormatterType | null;
+export declare function detectFormatterInTree(tree: Tree): FormatterType | null;

package/dist/src/utils/formatters/index.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetFormatterWarningsForTesting = resetFormatterWarningsForTesting;
+exports.detectFormatter = detectFormatter;
+exports.detectFormatterInTree = detectFormatterInTree;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const json_1 = require("../../generators/utils/json");
+const fileutils_1 = require("../fileutils");
+const oxfmt_1 = require("./oxfmt");
+const prettier_1 = require("./prettier");
+const logger_1 = require("../logger");
+// Once per process: detection runs on every one of 200+ `formatFiles` call sites.
+let warnedBothConfigured = false;
+function warnBothConfigured() {
+    warnedBothConfigured = true;
+    logger_1.logger.warn('Both an oxfmt and a prettier config were found. Nx is formatting with ' +
+        'oxfmt. Delete the config you are not using to make the choice ' +
+        'explicit: https://nx.dev/docs/reference/code-formatting');
+}
+/** Test-only: the warn-once flag is module state and would leak between cases. */
+function resetFormatterWarningsForTesting() {
+    warnedBothConfigured = false;
+}
+function detectFormatter(root) {
+    if ((0, oxfmt_1.isUsingOxfmt)(root)) {
+        // Flag first, so the lookup stops repeating once we have warned.
+        if (!warnedBothConfigured && (0, prettier_1.isUsingPrettier)(root)) {
+            warnBothConfigured();
+        }
+        return 'oxfmt';
+    }
+    if ((0, prettier_1.isUsingPrettier)(root)) {
+        return 'prettier';
+    }
+    // Neither is configured. Both formatters run on their defaults, so a
+    // dependency declared in the root package.json is the only statement of
+    // intent an unconfigured workspace gives. #30426 ruled out treating prettier
+    // as *resolvable in node_modules*, which a declared dependency is not.
+    const packageJsonPath = (0, node_path_1.join)(root, 'package.json');
+    if ((0, node_fs_1.existsSync)(packageJsonPath)) {
+        return detectFormatterFromDependencies((0, fileutils_1.readJsonFile)(packageJsonPath));
+    }
+    return null;
+}
+function detectFormatterInTree(tree) {
+    if ((0, oxfmt_1.isUsingOxfmtInTree)(tree)) {
+        if (!warnedBothConfigured && (0, prettier_1.isUsingPrettierInTree)(tree)) {
+            warnBothConfigured();
+        }
+        return 'oxfmt';
+    }
+    if ((0, prettier_1.isUsingPrettierInTree)(tree)) {
+        return 'prettier';
+    }
+    // See detectFormatter: a declared dependency is the fallback for both.
+    if (tree.exists('package.json')) {
+        return detectFormatterFromDependencies((0, json_1.readJson)(tree, 'package.json'));
+    }
+    return null;
+}
+/** oxfmt first, matching the precedence the config files already have. */
+function detectFormatterFromDependencies(packageJson) {
+    if (hasDependency(packageJson, 'oxfmt')) {
+        return 'oxfmt';
+    }
+    if (hasDependency(packageJson, 'prettier')) {
+        return 'prettier';
+    }
+    return null;
+}
+function hasDependency(packageJson, name) {
+    return Boolean(packageJson.dependencies?.[name] ?? packageJson.devDependencies?.[name]);
+}

package/dist/src/utils/formatters/oxfmt.d.ts

@@ -0,0 +1,32 @@
+import type { Tree } from '../../generators/tree';
+/**
+ * Config filenames oxfmt *discovers* - narrower than the set `-c` accepts.
+ * Measured against 0.60.0: `oxfmt.config.{js,cjs,mjs,cts}` load when named
+ * but are never searched for, so treating one as config would format on
+ * options oxfmt ignores. No precedence order - oxfmt fails with
+ * "Both '<a>' and '<b>' found in <dir>" when a directory holds two.
+ */
+export declare const oxfmtConfigFiles: string[];
+export declare function isUsingOxfmt(root: string): boolean;
+export declare function isUsingOxfmtInTree(tree: Tree): boolean;
+export declare function getOxfmtBinPath(): string;
+export declare function writeWithOxfmt(patterns: string[], cwd?: string): void;
+export declare function checkWithOxfmt(patterns: string[]): Promise<string[]>;
+/**
+ * Nothing is written to disk: staging files inside the workspace would race the
+ * daemon's watcher and the project graph mid-generator.
+ *
+ * A path is absent from the result when oxfmt has no parser for it, an ignore
+ * file covers it, or it is already formatted. One unparseable file fails only
+ * itself; the rest of the batch still applies.
+ */
+export declare function formatFilesWithOxfmt(files: {
+    path: string;
+    content: string;
+}[], workspaceRoot: string, seedConfig?: {
+    name: string;
+    content: string;
+}, rootConfigNames?: readonly string[], read?: (relativePath: string) => string | null | undefined): Promise<{
+    formatted: Map<string, string>;
+    errors?: string[];
+}>;