package-management 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -17,6 +17,7 @@ const gitignoreParser = require('parse-gitignore');
 const utils = require('pathe/utils');
 const os = require('node:os');
 const jsoncParser = require('jsonc-parser');
+const confbox = require('confbox');
 const unstorage = require('unstorage');
 const defineMemoryDriver = require('unstorage/drivers/memory');
 const defineFsLiteDriver = require('unstorage/drivers/fs-lite');
@@ -101,6 +102,13 @@ function createFile(filePath, data, options) {
   node_fs.writeFileSync(filePath, data, writeFileOptions);
 }
 
+function readFile(filePath, options) {
+  return node_fs.readFileSync(filePath, options?.encoding ?? "utf-8");
+}
+function readFileSafely(filePath, options) {
+  return node_fs.existsSync(filePath) ? readFile(filePath, options) : void 0;
+}
+
 function isWritable(filename) {
   try {
     node_fs.accessSync(filename, node_fs.constants.W_OK);
@@ -1122,15 +1130,15 @@ function resolveJsonSource(source, as) {
   return resolved;
 }
 
-const toPathSegment = (segment) => /^\d+$/.test(segment) ? Number(segment) : segment;
-function resolveEditPath(path, options) {
+const toPathSegment$1 = (segment) => /^\d+$/.test(segment) ? Number(segment) : segment;
+function resolveEditPath$1(path, options) {
   const { pathSeparator = "." } = options || {};
   if (Array.isArray(path)) return path;
   if (typeof path === "number" || pathSeparator === false) return [path];
-  return path.split(pathSeparator).map(toPathSegment);
+  return path.split(pathSeparator).map(toPathSegment$1);
 }
 function parseJSONCEdits(edits, defaultEditOptions) {
-  const resolve = (path, options) => resolveEditPath(path, { ...defaultEditOptions, ...options });
+  const resolve = (path, options) => resolveEditPath$1(path, { ...defaultEditOptions, ...options });
   if (Array.isArray(edits)) {
     return edits.map(({ path, ...edit }) => ({
       path: resolve(path, edit.options),
@@ -1188,6 +1196,154 @@ function modifyJSONFile(filepath, edits, options) {
   });
 }
 
+const configLanguages = {
+  json: { parse: confbox.parseJSONC, stringify: confbox.stringifyJSONC, surgical: true },
+  jsonc: { parse: confbox.parseJSONC, stringify: confbox.stringifyJSONC, surgical: true },
+  json5: { parse: confbox.parseJSON5, stringify: confbox.stringifyJSON5, surgical: false },
+  yaml: { parse: confbox.parseYAML, stringify: confbox.stringifyYAML, surgical: false },
+  toml: { parse: confbox.parseTOML, stringify: confbox.stringifyTOML, surgical: false }
+};
+const extensionFormats = {
+  ".json": "json",
+  ".jsonc": "jsonc",
+  ".json5": "json5",
+  ".yaml": "yaml",
+  ".yml": "yaml",
+  ".toml": "toml"
+};
+function isConfigFormat(value) {
+  return value in configLanguages;
+}
+function getConfigFormat(filepath) {
+  const extension = path.extname(filepath).toLowerCase();
+  return extension in extensionFormats ? extensionFormats[extension] : void 0;
+}
+
+function resolveFormat(source) {
+  if (source.format) return source.format;
+  const inferred = source.filepath ? getConfigFormat(source.filepath) : void 0;
+  if (!inferred) {
+    throw new Error(
+      source.filepath ? `Unsupported config format: ${source.filepath}` : "A `format` is required for a text or data source"
+    );
+  }
+  return inferred;
+}
+function resolveConfigSource(source, as) {
+  const format = resolveFormat(source);
+  const language = configLanguages[format];
+  const { text: sourceText, data: sourceData, filepath } = source;
+  const resolvers = {
+    data: () => ({
+      text: () => language.stringify(sourceData),
+      data: () => sourceData
+    }),
+    text: () => ({
+      text: () => sourceText,
+      data: () => language.parse(sourceText)
+    }),
+    filepath: () => {
+      const text = node_fs.readFileSync(filepath, "utf-8");
+      return {
+        text: () => text,
+        data: () => language.parse(text)
+      };
+    }
+  };
+  const selected = ["data", "text", "filepath"].find(
+    (key) => source[key] !== void 0
+  );
+  if (!selected) {
+    throw new Error("Invalid source data");
+  }
+  const sourceResolvers = resolvers[selected]();
+  const resolved = fromEntries(
+    entriesOf(sourceResolvers).flatMap(([key, value]) => {
+      if (as && key !== as) return [];
+      try {
+        return [[key, value()]];
+      } catch (error) {
+        throw new Error(`Failed to resolve ${key} from ${selected}`, {
+          cause: error
+        });
+      }
+    })
+  );
+  if (as) {
+    return resolved[as];
+  }
+  return resolved;
+}
+
+const toPathSegment = (segment) => /^\d+$/.test(segment) ? Number(segment) : segment;
+function resolveEditPath(path, options) {
+  const { pathSeparator = "." } = options || {};
+  if (Array.isArray(path)) return path;
+  if (typeof path === "number" || pathSeparator === false) return [path];
+  return path.split(pathSeparator).map(toPathSegment);
+}
+function toEditList(edits, defaultEditOptions) {
+  const entries = Array.isArray(edits) ? edits : Object.entries(edits).map(([path, edit]) => ({ path, ...edit }));
+  return entries.map(({ path, value, options }) => ({
+    path: resolveEditPath(path, { ...defaultEditOptions, ...options }),
+    value
+  }));
+}
+function setPath(target, path, value) {
+  const [head, ...rest] = path;
+  if (head === void 0) return value;
+  const container = Array.isArray(target) ? [...target] : { ...target ?? {} };
+  container[head] = setPath(container[head], rest, value);
+  return container;
+}
+function modifyConfig({
+  config,
+  edits,
+  defaultEditOptions
+}) {
+  return checkResult(() => {
+    const format = config.format ?? (config.filepath ? getConfigFormat(config.filepath) : void 0) ?? "json";
+    const language = configLanguages[format];
+    if (language.surgical) {
+      const { data, error } = modifyJSON({
+        json: config.filepath ? { filepath: config.filepath } : config.text !== void 0 ? { text: config.text } : { data: config.data },
+        edits,
+        defaultEditOptions
+      });
+      if (error) throw error;
+      return data;
+    }
+    const current = resolveConfigSource(config, "data");
+    const updated = toEditList(edits, defaultEditOptions).reduce(
+      (result, edit) => setPath(result, edit.path, edit.value),
+      current
+    );
+    return resolveConfigSource({ text: language.stringify(updated), format });
+  });
+}
+function modifyConfigFile(filepath, edits, options) {
+  return checkResult(() => {
+    const { autoCommit = true, defaultEditOptions, format } = options || {};
+    const { data: config, error } = modifyConfig({
+      config: format ? { filepath, format } : { filepath },
+      edits,
+      defaultEditOptions
+    });
+    if (error) {
+      throw error;
+    }
+    const commit = () => node_fs.writeFileSync(filepath, config.text);
+    if (autoCommit) {
+      commit();
+      return config;
+    }
+    return {
+      config,
+      commit
+    };
+  });
+}
+
 function isStorageValue(input) {
   return input === null || typeof input === "string" || typeof input === "number" || typeof input === "boolean" || typeof input === "object";
 }
@@ -1276,6 +1432,7 @@ function defineFileSystemStorage(options) {
 
 exports._dirname = _dirname;
 exports._filename = _filename;
+exports.configLanguages = configLanguages;
 exports.createFile = createFile;
 exports.defineFileSystemEntries = defineFileSystemEntries;
 exports.defineFileSystemStorage = defineFileSystemStorage;
@@ -1292,6 +1449,7 @@ exports.findPackageManager = findPackageManager;
 exports.findPackageManagerSafely = findPackageManagerSafely;
 exports.findResolvedModulePath = findResolvedModulePath;
 exports.getAliasMap = getAliasMap;
+exports.getConfigFormat = getConfigFormat;
 exports.getFolderByPackageName = getFolderByPackageName;
 exports.getGitRootFolder = getGitRootFolder;
 exports.getGlobalVersions = getGlobalVersions;
@@ -1300,16 +1458,22 @@ exports.getPath = getPath;
 exports.getWorkspaceFolder = getWorkspaceFolder;
 exports.importMap = importMap;
 exports.importer = importer;
+exports.isConfigFormat = isConfigFormat;
 exports.isDependencyInPackageJson = isDependencyInPackageJson;
 exports.isPackageDependency = isPackageDependency;
 exports.isPackageModuleFound = isPackageModuleFound;
 exports.isWritable = isWritable;
 exports.mapPackageManagers = mapPackageManagers;
+exports.modifyConfig = modifyConfig;
+exports.modifyConfigFile = modifyConfigFile;
 exports.modifyJSON = modifyJSON;
 exports.modifyJSONFile = modifyJSONFile;
 exports.packageManagerConfigs = packageManagerConfigs;
 exports.predefinedPathAliases = predefinedPathAliases;
 exports.project = project;
+exports.readFile = readFile;
+exports.readFileSafely = readFileSafely;
+exports.resolveConfigSource = resolveConfigSource;
 exports.resolveModule = resolveModule;
 exports.resolveModulePath = resolveModulePath;
 exports.resolvePackageModulePath = resolvePackageModulePath;

package/dist/index.d.cts

@@ -5,6 +5,7 @@ import { Options } from 'execa';
 import { ResolveOptions } from 'mlly';
 import * as parse_gitignore from 'parse-gitignore';
 import { ModificationOptions } from 'jsonc-parser';
+import { parseJSONC, stringifyJSONC, parseJSON5, stringifyJSON5, parseYAML, stringifyYAML, parseTOML, stringifyTOML } from 'confbox';
 import { StorageValue, TransactionOptions, Snapshot, Storage } from 'unstorage';
 import { FSStorageOptions } from 'unstorage/drivers/fs-lite';
 
@@ -121,6 +122,18 @@ declare const _dirname: (options?: CallerLocationOptions) => string | undefined;
 
 declare function createFile(filePath: string, data: string, options?: WriteFileOptions): void;
 
+interface ReadFileOptions {
+    /** @default "utf-8" */
+    encoding?: BufferEncoding;
+}
+declare function readFile(filePath: string, options?: ReadFileOptions): string;
+/**
+ * `undefined` is a real answer: a config a tool has never written yet is
+ * absent rather than empty, and callers seeding one say so themselves
+ * instead of catching a throw to find out.
+ */
+declare function readFileSafely(filePath: string, options?: ReadFileOptions): string | undefined;
+
 declare function isWritable(filename: string): boolean;
 
 interface PackageManagerConfig<ID extends string = string> {
@@ -895,6 +908,95 @@ type ModifyJSONFileResult<$auto_commit extends boolean = true> = $auto_commit ex
 }>;
 declare function modifyJSONFile<$auto_commit extends boolean = true>(filepath: string, edits: JSONEdits, options?: MoodifyJSONFileOptions<$auto_commit>): ModifyJSONFileResult<$auto_commit>;
 
+/**
+ * The configuration languages a project actually ships: `package.json` and
+ * `tsconfig.json`, `.prettierrc.json5`, CI and Compose YAML, and the TOML
+ * that Cargo, Codex, and Ruff read.
+ */
+type ConfigFormat = "json" | "jsonc" | "json5" | "yaml" | "toml";
+type ConfigSourceInputType = keyof ConfigSourceInput;
+interface ConfigSourceData<$config extends object = object> {
+    text: string;
+    data: $config;
+}
+type ConfigSourceInput<data extends object = object> = Prettify<RequireExactlyOne<{
+    data?: data;
+    filepath?: string;
+    text?: string;
+}> & {
+    /**
+     * Inferred from a `filepath`'s extension. Required for `text` and `data`,
+     * which carry no extension to read it from.
+     */
+    format?: ConfigFormat;
+}>;
+
+/**
+ * One edit vocabulary across every language. A dot path addresses nesting,
+ * an array spells segments out literally, and both are what `modifyJSON`
+ * already accepts — so an edit written for `package.json` reads the same
+ * written for `config.toml`.
+ */
+type ConfigEdits = JSONEdits;
+type ConfigEditData = JSONEditData;
+type ConfigEditOptions = JSONEditOptions;
+interface ModifyConfigOptions<$config extends object = object> {
+    config: ConfigSourceInput<$config>;
+    edits: ConfigEdits;
+    defaultEditOptions?: ConfigEditOptions;
+}
+declare function modifyConfig({ config, edits, defaultEditOptions, }: ModifyConfigOptions): CheckResult<ConfigSourceData>;
+interface ModifyConfigFileOptions<$auto_commit extends boolean = boolean> {
+    autoCommit?: $auto_commit;
+    defaultEditOptions?: ConfigEditOptions;
+    /** Overrides the format the file's extension implies. */
+    format?: ConfigFormat;
+}
+type ModifyConfigFileResult<$auto_commit extends boolean = true> = $auto_commit extends true ? CheckResult<ConfigSourceData> : CheckResult<{
+    config: ConfigSourceData;
+    commit: () => void;
+}>;
+declare function modifyConfigFile<$auto_commit extends boolean = true>(filepath: string, edits: ConfigEdits, options?: ModifyConfigFileOptions<$auto_commit>): ModifyConfigFileResult<$auto_commit>;
+
+declare const configLanguages: {
+    readonly json: {
+        readonly parse: typeof parseJSONC;
+        readonly stringify: typeof stringifyJSONC;
+        readonly surgical: true;
+    };
+    readonly jsonc: {
+        readonly parse: typeof parseJSONC;
+        readonly stringify: typeof stringifyJSONC;
+        readonly surgical: true;
+    };
+    readonly json5: {
+        readonly parse: typeof parseJSON5;
+        readonly stringify: typeof stringifyJSON5;
+        readonly surgical: false;
+    };
+    readonly yaml: {
+        readonly parse: typeof parseYAML;
+        readonly stringify: typeof stringifyYAML;
+        readonly surgical: false;
+    };
+    readonly toml: {
+        readonly parse: typeof parseTOML;
+        readonly stringify: typeof stringifyTOML;
+        readonly surgical: false;
+    };
+};
+declare function isConfigFormat(value: string): value is ConfigFormat;
+/**
+ * `undefined` is a real answer: a path can name an extension this module has
+ * no language for, and callers say what to do about it rather than receiving
+ * a format picked at random.
+ */
+declare function getConfigFormat(filepath: string): ConfigFormat | undefined;
+
+type InferConfig<$source extends ConfigSourceInput> = $source extends ConfigSourceInput<infer $config> ? $config : object;
+type ResolvedConfigSourceData<$as extends "data" | "text" = never, $config extends object = object> = IsNever<$as> extends false ? $as extends string ? ConfigSourceData<$config>[$as] : ConfigSourceData<$config> : ConfigSourceData<$config>;
+declare function resolveConfigSource<$source extends ConfigSourceInput, $as extends "data" | "text" = never>(source: $source, as?: $as): ResolvedConfigSourceData<$as, InferConfig<$source>>;
+
 declare const storage: Storage<StorageValue>;
 declare const tempFileSystem: FileSystemStorage<FileSystemEntriesDefinition<string>, FileSystemPathCompletion<FileSystemEntriesDefinition<string>>>;
 type FileSystemEntriesDefinition<$filepath extends string = string> = {
@@ -957,5 +1059,5 @@ type ExtractFsEntriesDef<$fs_def> = Cast<$fs_def, FileSystemEntriesDefinition>;
 declare function defineFileSystemStorage<const $fs_storage_def extends DefineFileSystemOptions = DefineFileSystemOptions, // prettier-ignore
 $fs_def extends $fs_storage_def['initial'] = $fs_storage_def['initial']>(options: $fs_storage_def): FileSystemStorage<ExtractFsEntriesDef<$fs_def>>;
 
-export { _dirname, _filename, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, dependencyTypeMap, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
-export type { AliasDefinition, AliasDefinitionMap, AliasMap, AnyFunction, AsyncCacheFn, Awaitable, CallerLocationOptions, Cast, CheckResult, DefinePackageFn, DetectPackageManagerOptions, Entry, EntryOf, EnumToLiteral, Equals, ExtractImportOptionModule, FileSystemEntriesDefinition, FindDependencyInPackageJsonOptions, FromEntries, GetGitRootFolderOptions, GetPathOptions, GetWorkspaceFolderOptions, ImportCallback, ImportList, ImportMap, ImportMapFn, ImportMapOptions, ImportModuleData, ImportModuleFn, ImportOption, ImportOptionData, ImportPackageData, ImporterOptions, InstallPackageOptions, InstallerFn, IsExactBoolean, IsNever, IsUnion, IsUnknown, JSONEditData, JSONEditMap, JSONEditOptions, JSONEdits, KeyOf, KnownPackageJson, MergeObject, ModifyJSONCDataOptions, Module, MoodifyJSONFileOptions, NoInfer, OmitByValue, OmitIndexSignature, OmitNever, PackageDependencyItem, PackageDependencyType, PackageInfo, PackageInfoList, PackageInfoMap, PackageJson, PackageJsonPerson, PackageManager, PackageManagerCommandName, PackageManagerCommandSpec, PackageManagerCommands, PackageManagerConfig, PackageManagerId, PackageManagerScriptOptions, PackageManagers, PackageName, PathAlias, PathAliasResolveOptions, PathOptions, PathTo, PickByValue, PickKeyOf, PickPathAlias, PredefinedPathAliases, Prettify, ProjectParams, RequireExactlyOne, ResolveModulePathOptions, ResolvedImportList, ResolvedImportListPromise, ResolvedImportMap, ResolvedImportMapPromise, ResolvedImportOption, ResolvedPromise, Select, SelectionMap, SingleProp, StringLiteral, UninstallPackageOptions, ValueAtPath, ValueKeyOf, ValueKeyOfDeep, ValueOf, __ };
+export { _dirname, _filename, configLanguages, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, dependencyTypeMap, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getConfigFormat, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isConfigFormat, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyConfig, modifyConfigFile, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, readFile, readFileSafely, resolveConfigSource, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
+export type { AliasDefinition, AliasDefinitionMap, AliasMap, AnyFunction, AsyncCacheFn, Awaitable, CallerLocationOptions, Cast, CheckResult, ConfigEditData, ConfigEditOptions, ConfigEdits, ConfigFormat, ConfigSourceData, ConfigSourceInput, ConfigSourceInputType, DefinePackageFn, DetectPackageManagerOptions, Entry, EntryOf, EnumToLiteral, Equals, ExtractImportOptionModule, FileSystemEntriesDefinition, FindDependencyInPackageJsonOptions, FromEntries, GetGitRootFolderOptions, GetPathOptions, GetWorkspaceFolderOptions, ImportCallback, ImportList, ImportMap, ImportMapFn, ImportMapOptions, ImportModuleData, ImportModuleFn, ImportOption, ImportOptionData, ImportPackageData, ImporterOptions, InstallPackageOptions, InstallerFn, IsExactBoolean, IsNever, IsUnion, IsUnknown, JSONEditData, JSONEditMap, JSONEditOptions, JSONEdits, KeyOf, KnownPackageJson, MergeObject, ModifyConfigFileOptions, ModifyConfigOptions, ModifyJSONCDataOptions, Module, MoodifyJSONFileOptions, NoInfer, OmitByValue, OmitIndexSignature, OmitNever, PackageDependencyItem, PackageDependencyType, PackageInfo, PackageInfoList, PackageInfoMap, PackageJson, PackageJsonPerson, PackageManager, PackageManagerCommandName, PackageManagerCommandSpec, PackageManagerCommands, PackageManagerConfig, PackageManagerId, PackageManagerScriptOptions, PackageManagers, PackageName, PathAlias, PathAliasResolveOptions, PathOptions, PathTo, PickByValue, PickKeyOf, PickPathAlias, PredefinedPathAliases, Prettify, ProjectParams, ReadFileOptions, RequireExactlyOne, ResolveModulePathOptions, ResolvedImportList, ResolvedImportListPromise, ResolvedImportMap, ResolvedImportMapPromise, ResolvedImportOption, ResolvedPromise, Select, SelectionMap, SingleProp, StringLiteral, UninstallPackageOptions, ValueAtPath, ValueKeyOf, ValueKeyOfDeep, ValueOf, __ };

package/dist/index.d.mts

@@ -5,6 +5,7 @@ import { Options } from 'execa';
 import { ResolveOptions } from 'mlly';
 import * as parse_gitignore from 'parse-gitignore';
 import { ModificationOptions } from 'jsonc-parser';
+import { parseJSONC, stringifyJSONC, parseJSON5, stringifyJSON5, parseYAML, stringifyYAML, parseTOML, stringifyTOML } from 'confbox';
 import { StorageValue, TransactionOptions, Snapshot, Storage } from 'unstorage';
 import { FSStorageOptions } from 'unstorage/drivers/fs-lite';
 
@@ -121,6 +122,18 @@ declare const _dirname: (options?: CallerLocationOptions) => string | undefined;
 
 declare function createFile(filePath: string, data: string, options?: WriteFileOptions): void;
 
+interface ReadFileOptions {
+    /** @default "utf-8" */
+    encoding?: BufferEncoding;
+}
+declare function readFile(filePath: string, options?: ReadFileOptions): string;
+/**
+ * `undefined` is a real answer: a config a tool has never written yet is
+ * absent rather than empty, and callers seeding one say so themselves
+ * instead of catching a throw to find out.
+ */
+declare function readFileSafely(filePath: string, options?: ReadFileOptions): string | undefined;
+
 declare function isWritable(filename: string): boolean;
 
 interface PackageManagerConfig<ID extends string = string> {
@@ -895,6 +908,95 @@ type ModifyJSONFileResult<$auto_commit extends boolean = true> = $auto_commit ex
 }>;
 declare function modifyJSONFile<$auto_commit extends boolean = true>(filepath: string, edits: JSONEdits, options?: MoodifyJSONFileOptions<$auto_commit>): ModifyJSONFileResult<$auto_commit>;
 
+/**
+ * The configuration languages a project actually ships: `package.json` and
+ * `tsconfig.json`, `.prettierrc.json5`, CI and Compose YAML, and the TOML
+ * that Cargo, Codex, and Ruff read.
+ */
+type ConfigFormat = "json" | "jsonc" | "json5" | "yaml" | "toml";
+type ConfigSourceInputType = keyof ConfigSourceInput;
+interface ConfigSourceData<$config extends object = object> {
+    text: string;
+    data: $config;
+}
+type ConfigSourceInput<data extends object = object> = Prettify<RequireExactlyOne<{
+    data?: data;
+    filepath?: string;
+    text?: string;
+}> & {
+    /**
+     * Inferred from a `filepath`'s extension. Required for `text` and `data`,
+     * which carry no extension to read it from.
+     */
+    format?: ConfigFormat;
+}>;
+
+/**
+ * One edit vocabulary across every language. A dot path addresses nesting,
+ * an array spells segments out literally, and both are what `modifyJSON`
+ * already accepts — so an edit written for `package.json` reads the same
+ * written for `config.toml`.
+ */
+type ConfigEdits = JSONEdits;
+type ConfigEditData = JSONEditData;
+type ConfigEditOptions = JSONEditOptions;
+interface ModifyConfigOptions<$config extends object = object> {
+    config: ConfigSourceInput<$config>;
+    edits: ConfigEdits;
+    defaultEditOptions?: ConfigEditOptions;
+}
+declare function modifyConfig({ config, edits, defaultEditOptions, }: ModifyConfigOptions): CheckResult<ConfigSourceData>;
+interface ModifyConfigFileOptions<$auto_commit extends boolean = boolean> {
+    autoCommit?: $auto_commit;
+    defaultEditOptions?: ConfigEditOptions;
+    /** Overrides the format the file's extension implies. */
+    format?: ConfigFormat;
+}
+type ModifyConfigFileResult<$auto_commit extends boolean = true> = $auto_commit extends true ? CheckResult<ConfigSourceData> : CheckResult<{
+    config: ConfigSourceData;
+    commit: () => void;
+}>;
+declare function modifyConfigFile<$auto_commit extends boolean = true>(filepath: string, edits: ConfigEdits, options?: ModifyConfigFileOptions<$auto_commit>): ModifyConfigFileResult<$auto_commit>;
+
+declare const configLanguages: {
+    readonly json: {
+        readonly parse: typeof parseJSONC;
+        readonly stringify: typeof stringifyJSONC;
+        readonly surgical: true;
+    };
+    readonly jsonc: {
+        readonly parse: typeof parseJSONC;
+        readonly stringify: typeof stringifyJSONC;
+        readonly surgical: true;
+    };
+    readonly json5: {
+        readonly parse: typeof parseJSON5;
+        readonly stringify: typeof stringifyJSON5;
+        readonly surgical: false;
+    };
+    readonly yaml: {
+        readonly parse: typeof parseYAML;
+        readonly stringify: typeof stringifyYAML;
+        readonly surgical: false;
+    };
+    readonly toml: {
+        readonly parse: typeof parseTOML;
+        readonly stringify: typeof stringifyTOML;
+        readonly surgical: false;
+    };
+};
+declare function isConfigFormat(value: string): value is ConfigFormat;
+/**
+ * `undefined` is a real answer: a path can name an extension this module has
+ * no language for, and callers say what to do about it rather than receiving
+ * a format picked at random.
+ */
+declare function getConfigFormat(filepath: string): ConfigFormat | undefined;
+
+type InferConfig<$source extends ConfigSourceInput> = $source extends ConfigSourceInput<infer $config> ? $config : object;
+type ResolvedConfigSourceData<$as extends "data" | "text" = never, $config extends object = object> = IsNever<$as> extends false ? $as extends string ? ConfigSourceData<$config>[$as] : ConfigSourceData<$config> : ConfigSourceData<$config>;
+declare function resolveConfigSource<$source extends ConfigSourceInput, $as extends "data" | "text" = never>(source: $source, as?: $as): ResolvedConfigSourceData<$as, InferConfig<$source>>;
+
 declare const storage: Storage<StorageValue>;
 declare const tempFileSystem: FileSystemStorage<FileSystemEntriesDefinition<string>, FileSystemPathCompletion<FileSystemEntriesDefinition<string>>>;
 type FileSystemEntriesDefinition<$filepath extends string = string> = {
@@ -957,5 +1059,5 @@ type ExtractFsEntriesDef<$fs_def> = Cast<$fs_def, FileSystemEntriesDefinition>;
 declare function defineFileSystemStorage<const $fs_storage_def extends DefineFileSystemOptions = DefineFileSystemOptions, // prettier-ignore
 $fs_def extends $fs_storage_def['initial'] = $fs_storage_def['initial']>(options: $fs_storage_def): FileSystemStorage<ExtractFsEntriesDef<$fs_def>>;
 
-export { _dirname, _filename, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, dependencyTypeMap, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
-export type { AliasDefinition, AliasDefinitionMap, AliasMap, AnyFunction, AsyncCacheFn, Awaitable, CallerLocationOptions, Cast, CheckResult, DefinePackageFn, DetectPackageManagerOptions, Entry, EntryOf, EnumToLiteral, Equals, ExtractImportOptionModule, FileSystemEntriesDefinition, FindDependencyInPackageJsonOptions, FromEntries, GetGitRootFolderOptions, GetPathOptions, GetWorkspaceFolderOptions, ImportCallback, ImportList, ImportMap, ImportMapFn, ImportMapOptions, ImportModuleData, ImportModuleFn, ImportOption, ImportOptionData, ImportPackageData, ImporterOptions, InstallPackageOptions, InstallerFn, IsExactBoolean, IsNever, IsUnion, IsUnknown, JSONEditData, JSONEditMap, JSONEditOptions, JSONEdits, KeyOf, KnownPackageJson, MergeObject, ModifyJSONCDataOptions, Module, MoodifyJSONFileOptions, NoInfer, OmitByValue, OmitIndexSignature, OmitNever, PackageDependencyItem, PackageDependencyType, PackageInfo, PackageInfoList, PackageInfoMap, PackageJson, PackageJsonPerson, PackageManager, PackageManagerCommandName, PackageManagerCommandSpec, PackageManagerCommands, PackageManagerConfig, PackageManagerId, PackageManagerScriptOptions, PackageManagers, PackageName, PathAlias, PathAliasResolveOptions, PathOptions, PathTo, PickByValue, PickKeyOf, PickPathAlias, PredefinedPathAliases, Prettify, ProjectParams, RequireExactlyOne, ResolveModulePathOptions, ResolvedImportList, ResolvedImportListPromise, ResolvedImportMap, ResolvedImportMapPromise, ResolvedImportOption, ResolvedPromise, Select, SelectionMap, SingleProp, StringLiteral, UninstallPackageOptions, ValueAtPath, ValueKeyOf, ValueKeyOfDeep, ValueOf, __ };
+export { _dirname, _filename, configLanguages, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, dependencyTypeMap, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getConfigFormat, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isConfigFormat, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyConfig, modifyConfigFile, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, readFile, readFileSafely, resolveConfigSource, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
+export type { AliasDefinition, AliasDefinitionMap, AliasMap, AnyFunction, AsyncCacheFn, Awaitable, CallerLocationOptions, Cast, CheckResult, ConfigEditData, ConfigEditOptions, ConfigEdits, ConfigFormat, ConfigSourceData, ConfigSourceInput, ConfigSourceInputType, DefinePackageFn, DetectPackageManagerOptions, Entry, EntryOf, EnumToLiteral, Equals, ExtractImportOptionModule, FileSystemEntriesDefinition, FindDependencyInPackageJsonOptions, FromEntries, GetGitRootFolderOptions, GetPathOptions, GetWorkspaceFolderOptions, ImportCallback, ImportList, ImportMap, ImportMapFn, ImportMapOptions, ImportModuleData, ImportModuleFn, ImportOption, ImportOptionData, ImportPackageData, ImporterOptions, InstallPackageOptions, InstallerFn, IsExactBoolean, IsNever, IsUnion, IsUnknown, JSONEditData, JSONEditMap, JSONEditOptions, JSONEdits, KeyOf, KnownPackageJson, MergeObject, ModifyConfigFileOptions, ModifyConfigOptions, ModifyJSONCDataOptions, Module, MoodifyJSONFileOptions, NoInfer, OmitByValue, OmitIndexSignature, OmitNever, PackageDependencyItem, PackageDependencyType, PackageInfo, PackageInfoList, PackageInfoMap, PackageJson, PackageJsonPerson, PackageManager, PackageManagerCommandName, PackageManagerCommandSpec, PackageManagerCommands, PackageManagerConfig, PackageManagerId, PackageManagerScriptOptions, PackageManagers, PackageName, PathAlias, PathAliasResolveOptions, PathOptions, PathTo, PickByValue, PickKeyOf, PickPathAlias, PredefinedPathAliases, Prettify, ProjectParams, ReadFileOptions, RequireExactlyOne, ResolveModulePathOptions, ResolvedImportList, ResolvedImportListPromise, ResolvedImportMap, ResolvedImportMapPromise, ResolvedImportOption, ResolvedPromise, Select, SelectionMap, SingleProp, StringLiteral, UninstallPackageOptions, ValueAtPath, ValueKeyOf, ValueKeyOfDeep, ValueOf, __ };

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { Options } from 'execa';
 import { ResolveOptions } from 'mlly';
 import * as parse_gitignore from 'parse-gitignore';
 import { ModificationOptions } from 'jsonc-parser';
+import { parseJSONC, stringifyJSONC, parseJSON5, stringifyJSON5, parseYAML, stringifyYAML, parseTOML, stringifyTOML } from 'confbox';
 import { StorageValue, TransactionOptions, Snapshot, Storage } from 'unstorage';
 import { FSStorageOptions } from 'unstorage/drivers/fs-lite';
 
@@ -121,6 +122,18 @@ declare const _dirname: (options?: CallerLocationOptions) => string | undefined;
 
 declare function createFile(filePath: string, data: string, options?: WriteFileOptions): void;
 
+interface ReadFileOptions {
+    /** @default "utf-8" */
+    encoding?: BufferEncoding;
+}
+declare function readFile(filePath: string, options?: ReadFileOptions): string;
+/**
+ * `undefined` is a real answer: a config a tool has never written yet is
+ * absent rather than empty, and callers seeding one say so themselves
+ * instead of catching a throw to find out.
+ */
+declare function readFileSafely(filePath: string, options?: ReadFileOptions): string | undefined;
+
 declare function isWritable(filename: string): boolean;
 
 interface PackageManagerConfig<ID extends string = string> {
@@ -895,6 +908,95 @@ type ModifyJSONFileResult<$auto_commit extends boolean = true> = $auto_commit ex
 }>;
 declare function modifyJSONFile<$auto_commit extends boolean = true>(filepath: string, edits: JSONEdits, options?: MoodifyJSONFileOptions<$auto_commit>): ModifyJSONFileResult<$auto_commit>;
 
+/**
+ * The configuration languages a project actually ships: `package.json` and
+ * `tsconfig.json`, `.prettierrc.json5`, CI and Compose YAML, and the TOML
+ * that Cargo, Codex, and Ruff read.
+ */
+type ConfigFormat = "json" | "jsonc" | "json5" | "yaml" | "toml";
+type ConfigSourceInputType = keyof ConfigSourceInput;
+interface ConfigSourceData<$config extends object = object> {
+    text: string;
+    data: $config;
+}
+type ConfigSourceInput<data extends object = object> = Prettify<RequireExactlyOne<{
+    data?: data;
+    filepath?: string;
+    text?: string;
+}> & {
+    /**
+     * Inferred from a `filepath`'s extension. Required for `text` and `data`,
+     * which carry no extension to read it from.
+     */
+    format?: ConfigFormat;
+}>;
+
+/**
+ * One edit vocabulary across every language. A dot path addresses nesting,
+ * an array spells segments out literally, and both are what `modifyJSON`
+ * already accepts — so an edit written for `package.json` reads the same
+ * written for `config.toml`.
+ */
+type ConfigEdits = JSONEdits;
+type ConfigEditData = JSONEditData;
+type ConfigEditOptions = JSONEditOptions;
+interface ModifyConfigOptions<$config extends object = object> {
+    config: ConfigSourceInput<$config>;
+    edits: ConfigEdits;
+    defaultEditOptions?: ConfigEditOptions;
+}
+declare function modifyConfig({ config, edits, defaultEditOptions, }: ModifyConfigOptions): CheckResult<ConfigSourceData>;
+interface ModifyConfigFileOptions<$auto_commit extends boolean = boolean> {
+    autoCommit?: $auto_commit;
+    defaultEditOptions?: ConfigEditOptions;
+    /** Overrides the format the file's extension implies. */
+    format?: ConfigFormat;
+}
+type ModifyConfigFileResult<$auto_commit extends boolean = true> = $auto_commit extends true ? CheckResult<ConfigSourceData> : CheckResult<{
+    config: ConfigSourceData;
+    commit: () => void;
+}>;
+declare function modifyConfigFile<$auto_commit extends boolean = true>(filepath: string, edits: ConfigEdits, options?: ModifyConfigFileOptions<$auto_commit>): ModifyConfigFileResult<$auto_commit>;
+
+declare const configLanguages: {
+    readonly json: {
+        readonly parse: typeof parseJSONC;
+        readonly stringify: typeof stringifyJSONC;
+        readonly surgical: true;
+    };
+    readonly jsonc: {
+        readonly parse: typeof parseJSONC;
+        readonly stringify: typeof stringifyJSONC;
+        readonly surgical: true;
+    };
+    readonly json5: {
+        readonly parse: typeof parseJSON5;
+        readonly stringify: typeof stringifyJSON5;
+        readonly surgical: false;
+    };
+    readonly yaml: {
+        readonly parse: typeof parseYAML;
+        readonly stringify: typeof stringifyYAML;
+        readonly surgical: false;
+    };
+    readonly toml: {
+        readonly parse: typeof parseTOML;
+        readonly stringify: typeof stringifyTOML;
+        readonly surgical: false;
+    };
+};
+declare function isConfigFormat(value: string): value is ConfigFormat;
+/**
+ * `undefined` is a real answer: a path can name an extension this module has
+ * no language for, and callers say what to do about it rather than receiving
+ * a format picked at random.
+ */
+declare function getConfigFormat(filepath: string): ConfigFormat | undefined;
+
+type InferConfig<$source extends ConfigSourceInput> = $source extends ConfigSourceInput<infer $config> ? $config : object;
+type ResolvedConfigSourceData<$as extends "data" | "text" = never, $config extends object = object> = IsNever<$as> extends false ? $as extends string ? ConfigSourceData<$config>[$as] : ConfigSourceData<$config> : ConfigSourceData<$config>;
+declare function resolveConfigSource<$source extends ConfigSourceInput, $as extends "data" | "text" = never>(source: $source, as?: $as): ResolvedConfigSourceData<$as, InferConfig<$source>>;
+
 declare const storage: Storage<StorageValue>;
 declare const tempFileSystem: FileSystemStorage<FileSystemEntriesDefinition<string>, FileSystemPathCompletion<FileSystemEntriesDefinition<string>>>;
 type FileSystemEntriesDefinition<$filepath extends string = string> = {
@@ -957,5 +1059,5 @@ type ExtractFsEntriesDef<$fs_def> = Cast<$fs_def, FileSystemEntriesDefinition>;
 declare function defineFileSystemStorage<const $fs_storage_def extends DefineFileSystemOptions = DefineFileSystemOptions, // prettier-ignore
 $fs_def extends $fs_storage_def['initial'] = $fs_storage_def['initial']>(options: $fs_storage_def): FileSystemStorage<ExtractFsEntriesDef<$fs_def>>;
 
-export { _dirname, _filename, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, dependencyTypeMap, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
-export type { AliasDefinition, AliasDefinitionMap, AliasMap, AnyFunction, AsyncCacheFn, Awaitable, CallerLocationOptions, Cast, CheckResult, DefinePackageFn, DetectPackageManagerOptions, Entry, EntryOf, EnumToLiteral, Equals, ExtractImportOptionModule, FileSystemEntriesDefinition, FindDependencyInPackageJsonOptions, FromEntries, GetGitRootFolderOptions, GetPathOptions, GetWorkspaceFolderOptions, ImportCallback, ImportList, ImportMap, ImportMapFn, ImportMapOptions, ImportModuleData, ImportModuleFn, ImportOption, ImportOptionData, ImportPackageData, ImporterOptions, InstallPackageOptions, InstallerFn, IsExactBoolean, IsNever, IsUnion, IsUnknown, JSONEditData, JSONEditMap, JSONEditOptions, JSONEdits, KeyOf, KnownPackageJson, MergeObject, ModifyJSONCDataOptions, Module, MoodifyJSONFileOptions, NoInfer, OmitByValue, OmitIndexSignature, OmitNever, PackageDependencyItem, PackageDependencyType, PackageInfo, PackageInfoList, PackageInfoMap, PackageJson, PackageJsonPerson, PackageManager, PackageManagerCommandName, PackageManagerCommandSpec, PackageManagerCommands, PackageManagerConfig, PackageManagerId, PackageManagerScriptOptions, PackageManagers, PackageName, PathAlias, PathAliasResolveOptions, PathOptions, PathTo, PickByValue, PickKeyOf, PickPathAlias, PredefinedPathAliases, Prettify, ProjectParams, RequireExactlyOne, ResolveModulePathOptions, ResolvedImportList, ResolvedImportListPromise, ResolvedImportMap, ResolvedImportMapPromise, ResolvedImportOption, ResolvedPromise, Select, SelectionMap, SingleProp, StringLiteral, UninstallPackageOptions, ValueAtPath, ValueKeyOf, ValueKeyOfDeep, ValueOf, __ };
+export { _dirname, _filename, configLanguages, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, dependencyTypeMap, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getConfigFormat, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isConfigFormat, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyConfig, modifyConfigFile, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, readFile, readFileSafely, resolveConfigSource, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
+export type { AliasDefinition, AliasDefinitionMap, AliasMap, AnyFunction, AsyncCacheFn, Awaitable, CallerLocationOptions, Cast, CheckResult, ConfigEditData, ConfigEditOptions, ConfigEdits, ConfigFormat, ConfigSourceData, ConfigSourceInput, ConfigSourceInputType, DefinePackageFn, DetectPackageManagerOptions, Entry, EntryOf, EnumToLiteral, Equals, ExtractImportOptionModule, FileSystemEntriesDefinition, FindDependencyInPackageJsonOptions, FromEntries, GetGitRootFolderOptions, GetPathOptions, GetWorkspaceFolderOptions, ImportCallback, ImportList, ImportMap, ImportMapFn, ImportMapOptions, ImportModuleData, ImportModuleFn, ImportOption, ImportOptionData, ImportPackageData, ImporterOptions, InstallPackageOptions, InstallerFn, IsExactBoolean, IsNever, IsUnion, IsUnknown, JSONEditData, JSONEditMap, JSONEditOptions, JSONEdits, KeyOf, KnownPackageJson, MergeObject, ModifyConfigFileOptions, ModifyConfigOptions, ModifyJSONCDataOptions, Module, MoodifyJSONFileOptions, NoInfer, OmitByValue, OmitIndexSignature, OmitNever, PackageDependencyItem, PackageDependencyType, PackageInfo, PackageInfoList, PackageInfoMap, PackageJson, PackageJsonPerson, PackageManager, PackageManagerCommandName, PackageManagerCommandSpec, PackageManagerCommands, PackageManagerConfig, PackageManagerId, PackageManagerScriptOptions, PackageManagers, PackageName, PathAlias, PathAliasResolveOptions, PathOptions, PathTo, PickByValue, PickKeyOf, PickPathAlias, PredefinedPathAliases, Prettify, ProjectParams, ReadFileOptions, RequireExactlyOne, ResolveModulePathOptions, ResolvedImportList, ResolvedImportListPromise, ResolvedImportMap, ResolvedImportMapPromise, ResolvedImportOption, ResolvedPromise, Select, SelectionMap, SingleProp, StringLiteral, UninstallPackageOptions, ValueAtPath, ValueKeyOf, ValueKeyOfDeep, ValueOf, __ };

package/dist/index.mjs

@@ -1,11 +1,11 @@
-import path, { isAbsolute, dirname, normalize, join } from 'pathe';
+import path, { isAbsolute, dirname, normalize, join, extname } from 'pathe';
 import util from 'node:util';
 import { fileURLToPath } from 'node:url';
-import { existsSync, mkdirSync, writeFileSync, accessSync, constants, statSync, readFileSync } from 'node:fs';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, accessSync, constants, statSync } from 'node:fs';
 import { asyncCacheFn } from 'async-cache-fn';
 import { execaSync, execa } from 'execa';
 import { findUp } from 'find-up';
-import { readFile, rm } from 'node:fs/promises';
+import { readFile as readFile$1, rm } from 'node:fs/promises';
 import { resolvePathSync } from 'mlly';
 import * as WST from 'workspace-tools';
 import process from 'node:process';
@@ -15,6 +15,7 @@ import gitignoreParser from 'parse-gitignore';
 import { resolveAlias } from 'pathe/utils';
 import os from 'node:os';
 import { parse, applyEdits, modify } from 'jsonc-parser';
+import { stringifyTOML, parseTOML, stringifyYAML, parseYAML, stringifyJSON5, parseJSON5, stringifyJSONC, parseJSONC } from 'confbox';
 import { createStorage, restoreSnapshot, snapshot } from 'unstorage';
 import defineMemoryDriver from 'unstorage/drivers/memory';
 import defineFsLiteDriver from 'unstorage/drivers/fs-lite';
@@ -74,6 +75,13 @@ function createFile(filePath, data, options) {
   writeFileSync(filePath, data, writeFileOptions);
 }
 
+function readFile(filePath, options) {
+  return readFileSync(filePath, options?.encoding ?? "utf-8");
+}
+function readFileSafely(filePath, options) {
+  return existsSync(filePath) ? readFile(filePath, options) : void 0;
+}
+
 function isWritable(filename) {
   try {
     accessSync(filename, constants.W_OK);
@@ -576,7 +584,7 @@ function definePackageManager(config, options) {
     readLockfile: asyncCacheFn(async (...args) => {
       const lockfilePath = await findLockfilePath.noCache(...args);
       if (!lockfilePath) return void 0;
-      return readFile(lockfilePath, "utf8");
+      return readFile$1(lockfilePath, "utf8");
     }),
     globalVersion,
     matchesVersion: asyncCacheFn(async (...args) => {
@@ -1095,15 +1103,15 @@ function resolveJsonSource(source, as) {
   return resolved;
 }
 
-const toPathSegment = (segment) => /^\d+$/.test(segment) ? Number(segment) : segment;
-function resolveEditPath(path, options) {
+const toPathSegment$1 = (segment) => /^\d+$/.test(segment) ? Number(segment) : segment;
+function resolveEditPath$1(path, options) {
   const { pathSeparator = "." } = options || {};
   if (Array.isArray(path)) return path;
   if (typeof path === "number" || pathSeparator === false) return [path];
-  return path.split(pathSeparator).map(toPathSegment);
+  return path.split(pathSeparator).map(toPathSegment$1);
 }
 function parseJSONCEdits(edits, defaultEditOptions) {
-  const resolve = (path, options) => resolveEditPath(path, { ...defaultEditOptions, ...options });
+  const resolve = (path, options) => resolveEditPath$1(path, { ...defaultEditOptions, ...options });
   if (Array.isArray(edits)) {
     return edits.map(({ path, ...edit }) => ({
       path: resolve(path, edit.options),
@@ -1161,6 +1169,154 @@ function modifyJSONFile(filepath, edits, options) {
   });
 }
 
+const configLanguages = {
+  json: { parse: parseJSONC, stringify: stringifyJSONC, surgical: true },
+  jsonc: { parse: parseJSONC, stringify: stringifyJSONC, surgical: true },
+  json5: { parse: parseJSON5, stringify: stringifyJSON5, surgical: false },
+  yaml: { parse: parseYAML, stringify: stringifyYAML, surgical: false },
+  toml: { parse: parseTOML, stringify: stringifyTOML, surgical: false }
+};
+const extensionFormats = {
+  ".json": "json",
+  ".jsonc": "jsonc",
+  ".json5": "json5",
+  ".yaml": "yaml",
+  ".yml": "yaml",
+  ".toml": "toml"
+};
+function isConfigFormat(value) {
+  return value in configLanguages;
+}
+function getConfigFormat(filepath) {
+  const extension = extname(filepath).toLowerCase();
+  return extension in extensionFormats ? extensionFormats[extension] : void 0;
+}
+
+function resolveFormat(source) {
+  if (source.format) return source.format;
+  const inferred = source.filepath ? getConfigFormat(source.filepath) : void 0;
+  if (!inferred) {
+    throw new Error(
+      source.filepath ? `Unsupported config format: ${source.filepath}` : "A `format` is required for a text or data source"
+    );
+  }
+  return inferred;
+}
+function resolveConfigSource(source, as) {
+  const format = resolveFormat(source);
+  const language = configLanguages[format];
+  const { text: sourceText, data: sourceData, filepath } = source;
+  const resolvers = {
+    data: () => ({
+      text: () => language.stringify(sourceData),
+      data: () => sourceData
+    }),
+    text: () => ({
+      text: () => sourceText,
+      data: () => language.parse(sourceText)
+    }),
+    filepath: () => {
+      const text = readFileSync(filepath, "utf-8");
+      return {
+        text: () => text,
+        data: () => language.parse(text)
+      };
+    }
+  };
+  const selected = ["data", "text", "filepath"].find(
+    (key) => source[key] !== void 0
+  );
+  if (!selected) {
+    throw new Error("Invalid source data");
+  }
+  const sourceResolvers = resolvers[selected]();
+  const resolved = fromEntries(
+    entriesOf(sourceResolvers).flatMap(([key, value]) => {
+      if (as && key !== as) return [];
+      try {
+        return [[key, value()]];
+      } catch (error) {
+        throw new Error(`Failed to resolve ${key} from ${selected}`, {
+          cause: error
+        });
+      }
+    })
+  );
+  if (as) {
+    return resolved[as];
+  }
+  return resolved;
+}
+
+const toPathSegment = (segment) => /^\d+$/.test(segment) ? Number(segment) : segment;
+function resolveEditPath(path, options) {
+  const { pathSeparator = "." } = options || {};
+  if (Array.isArray(path)) return path;
+  if (typeof path === "number" || pathSeparator === false) return [path];
+  return path.split(pathSeparator).map(toPathSegment);
+}
+function toEditList(edits, defaultEditOptions) {
+  const entries = Array.isArray(edits) ? edits : Object.entries(edits).map(([path, edit]) => ({ path, ...edit }));
+  return entries.map(({ path, value, options }) => ({
+    path: resolveEditPath(path, { ...defaultEditOptions, ...options }),
+    value
+  }));
+}
+function setPath(target, path, value) {
+  const [head, ...rest] = path;
+  if (head === void 0) return value;
+  const container = Array.isArray(target) ? [...target] : { ...target ?? {} };
+  container[head] = setPath(container[head], rest, value);
+  return container;
+}
+function modifyConfig({
+  config,
+  edits,
+  defaultEditOptions
+}) {
+  return checkResult(() => {
+    const format = config.format ?? (config.filepath ? getConfigFormat(config.filepath) : void 0) ?? "json";
+    const language = configLanguages[format];
+    if (language.surgical) {
+      const { data, error } = modifyJSON({
+        json: config.filepath ? { filepath: config.filepath } : config.text !== void 0 ? { text: config.text } : { data: config.data },
+        edits,
+        defaultEditOptions
+      });
+      if (error) throw error;
+      return data;
+    }
+    const current = resolveConfigSource(config, "data");
+    const updated = toEditList(edits, defaultEditOptions).reduce(
+      (result, edit) => setPath(result, edit.path, edit.value),
+      current
+    );
+    return resolveConfigSource({ text: language.stringify(updated), format });
+  });
+}
+function modifyConfigFile(filepath, edits, options) {
+  return checkResult(() => {
+    const { autoCommit = true, defaultEditOptions, format } = options || {};
+    const { data: config, error } = modifyConfig({
+      config: format ? { filepath, format } : { filepath },
+      edits,
+      defaultEditOptions
+    });
+    if (error) {
+      throw error;
+    }
+    const commit = () => writeFileSync(filepath, config.text);
+    if (autoCommit) {
+      commit();
+      return config;
+    }
+    return {
+      config,
+      commit
+    };
+  });
+}
+
 function isStorageValue(input) {
   return input === null || typeof input === "string" || typeof input === "number" || typeof input === "boolean" || typeof input === "object";
 }
@@ -1247,4 +1403,4 @@ function defineFileSystemStorage(options) {
   return fileStorage;
 }
 
-export { _dirname, _filename, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };
+export { _dirname, _filename, configLanguages, createFile, defineFileSystemEntries, defineFileSystemStorage, definePackage, definePackageManager, definePackageManagerClient, definePathAliases, detectGlobalPackageManagers, detectLockfilePackageManagers, detectPackageManagers, filterPackageManagers, findDependencyInPackageJson, findPackageManager, findPackageManagerSafely, findResolvedModulePath, getAliasMap, getConfigFormat, getFolderByPackageName, getGitRootFolder, getGlobalVersions, getPackageFolder, getPath, getWorkspaceFolder, importMap, importer, isConfigFormat, isDependencyInPackageJson, isPackageDependency, isPackageModuleFound, isWritable, mapPackageManagers, modifyConfig, modifyConfigFile, modifyJSON, modifyJSONFile, packageManagerConfigs, predefinedPathAliases, project, readFile, readFileSafely, resolveConfigSource, resolveModule, resolveModulePath, resolvePackageModulePath, storage, tempFileSystem, workspace };

package/package.json

@@ -5,7 +5,7 @@
     "package-management",
     "package-manager"
   ],
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -48,6 +48,7 @@
   },
   "dependencies": {
     "async-cache-fn": "^0.0.3",
+    "confbox": "^0.2.4",
     "execa": "^10.0.1",
     "find-up": "^8.0.0",
     "globby": "^16.2.4",