@mnaoumov/typescript-dev-toolkit 3.0.0 → 3.2.0

package/dist/lib/cjs/formatters/auto.d.cts

@@ -0,0 +1,51 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Formats the source code with whichever formatter the project configures: dprint, Prettier or Biome.
+ */
+/**
+ * A formatter the toolkit runs.
+ */
+export type Formatter = 'biome' | 'dprint' | 'prettier';
+/**
+ * Parameters for the {@link format} function.
+ */
+export interface FormatOptions {
+    /**
+     * The configuration file used when the project has none of its own, as the chosen formatter's own `format` takes
+     * it.
+     */
+    readonly defaultConfigFilePath?: string | undefined;
+    /**
+     * The formatter to run. Omitted, {@link detectFormatter} chooses it.
+     */
+    readonly formatter?: Formatter | undefined;
+    /**
+     * Optional file paths to format. If omitted, formats the entire project.
+     */
+    readonly paths?: string[] | undefined;
+    /**
+     * Whether to rewrite the source code.
+     *
+     * @default `true`
+     */
+    readonly rewrite?: boolean | undefined;
+}
+/**
+ * Chooses the formatter from the configuration files at the project root.
+ *
+ * The order is `dprint.json`, then a Prettier configuration, then `biome.json` / `biome.jsonc`, so a project that
+ * lints with Biome and lays out with Prettier gets Prettier. A project with none of them gets dprint, as before
+ * Prettier and Biome were supported.
+ *
+ * @returns The formatter to run.
+ */
+export declare function detectFormatter(): Promise<Formatter>;
+/**
+ * Formats the source code with the project's formatter.
+ *
+ * @param options - The {@link FormatOptions}.
+ * @returns A {@link Promise} that resolves when the source code has been formatted.
+ */
+export declare function format(options?: FormatOptions): Promise<void>;

package/dist/lib/cjs/formatters/biome.cjs

@@ -0,0 +1,121 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function () {
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+ensureBrowserProcess();
+})();
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var biome_exports = {};
+__export(biome_exports, {
+  BIOME_CONFIG_FILE_NAMES: () => BIOME_CONFIG_FILE_NAMES,
+  BIOME_EXPLICIT_PATHS_ARGUMENTS: () => BIOME_EXPLICIT_PATHS_ARGUMENTS,
+  ensureBiomeConfig: () => ensureBiomeConfig,
+  format: () => format,
+  hasBiomeConfig: () => hasBiomeConfig
+});
+module.exports = __toCommonJS(biome_exports);
+var import_debug = require('@mnaoumov/typescript-lib/debug');
+var import_path = require('@mnaoumov/typescript-lib/path');
+var import_type_guards = require('@mnaoumov/typescript-lib/type-guards');
+var import_node_fs = require('node:fs');
+var import_promises = require('node:fs/promises');
+var import_package_manager = require('../package-manager.cjs');
+var import_repo_paths = require('../repo-paths.cjs');
+var import_root = require('../root.cjs');
+var import_shared_config_files = require('../shared-config-files.cjs');
+const BIOME_CONFIG_FILE_NAMES = [import_repo_paths.RepoPaths.BiomeJson, import_repo_paths.RepoPaths.BiomeJsonc];
+const BIOME_EXPLICIT_PATHS_ARGUMENTS = ["--files-ignore-unknown=true", "--no-errors-on-unmatched"];
+async function ensureBiomeConfig(options) {
+  if (hasBiomeConfig()) {
+    return;
+  }
+  const debug = (0, import_debug.getLibDebugger)("Biome:ensureBiomeConfig");
+  const defaultConfigFilePath = options?.defaultConfigFilePath;
+  if (defaultConfigFilePath) {
+    debug("Biome configuration file not found. Copying the default config...");
+    await (0, import_promises.cp)(defaultConfigFilePath, (0, import_root.resolvePathFromRootSafe)({ path: (0, import_path.basename)(defaultConfigFilePath) }));
+    return;
+  }
+  debug("Biome configuration file not found. Writing one that extends the shared config...");
+  const rootFolder = (0, import_root.getRootFolder)();
+  (0, import_type_guards.assertNonNullable)(rootFolder, "Root folder not found");
+  const sharedConfigPath = (0, import_path.toPosixPath)((0, import_path.relative)(rootFolder, (0, import_shared_config_files.getSharedConfigFilePath)(import_shared_config_files.SharedConfigFile.Biome)));
+  const extendsPath = JSON.stringify(sharedConfigPath.startsWith(".") ? sharedConfigPath : `./${sharedConfigPath}`);
+  await (0, import_promises.writeFile)((0, import_root.resolvePathFromRootSafe)({ path: import_repo_paths.RepoPaths.BiomeJson }), `{
+  "extends": [${extendsPath}]
+}
+`);
+}
+async function format(options) {
+  const { defaultConfigFilePath, paths, rewrite = true } = options ?? {};
+  await ensureBiomeConfig({ defaultConfigFilePath });
+  const hasPaths = paths !== void 0 && paths.length > 0;
+  await (0, import_root.execFromRoot)([
+    ...(0, import_package_manager.resolveToolCommand)({ tool: "biome" }),
+    "format",
+    ...rewrite ? ["--write"] : [],
+    ...hasPaths ? BIOME_EXPLICIT_PATHS_ARGUMENTS : [],
+    { batchedArguments: hasPaths ? paths : [import_repo_paths.RepoPaths.CurrentFolder] }
+  ]);
+}
+function hasBiomeConfig() {
+  return BIOME_CONFIG_FILE_NAMES.some((fileName) => (0, import_node_fs.existsSync)((0, import_root.resolvePathFromRootSafe)({ path: fileName })));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BIOME_CONFIG_FILE_NAMES,
+  BIOME_EXPLICIT_PATHS_ARGUMENTS,
+  ensureBiomeConfig,
+  format,
+  hasBiomeConfig
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9mb3JtYXR0ZXJzL2Jpb21lLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBGb3JtYXQgdGhlIHNvdXJjZSBjb2RlIHdpdGggQmlvbWUuXG4gKi9cblxuaW1wb3J0IHsgZ2V0TGliRGVidWdnZXIgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZGVidWcnO1xuaW1wb3J0IHtcbiAgYmFzZW5hbWUsXG4gIHJlbGF0aXZlLFxuICB0b1Bvc2l4UGF0aFxufSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcGF0aCc7XG5pbXBvcnQgeyBhc3NlcnROb25OdWxsYWJsZSB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi90eXBlLWd1YXJkcyc7XG5pbXBvcnQgeyBleGlzdHNTeW5jIH0gZnJvbSAnbm9kZTpmcyc7XG5pbXBvcnQge1xuICBjcCxcbiAgd3JpdGVGaWxlXG59IGZyb20gJ25vZGU6ZnMvcHJvbWlzZXMnO1xuXG5pbXBvcnQgeyByZXNvbHZlVG9vbENvbW1hbmQgfSBmcm9tICcuLi9wYWNrYWdlLW1hbmFnZXIudHMnO1xuaW1wb3J0IHsgUmVwb1BhdGhzIH0gZnJvbSAnLi4vcmVwby1wYXRocy50cyc7XG5pbXBvcnQge1xuICBleGVjRnJvbVJvb3QsXG4gIGdldFJvb3RGb2xkZXIsXG4gIHJlc29sdmVQYXRoRnJvbVJvb3RTYWZlXG59IGZyb20gJy4uL3Jvb3QudHMnO1xuaW1wb3J0IHtcbiAgZ2V0U2hhcmVkQ29uZmlnRmlsZVBhdGgsXG4gIFNoYXJlZENvbmZpZ0ZpbGVcbn0gZnJvbSAnLi4vc2hhcmVkLWNvbmZpZy1maWxlcy50cyc7XG5cbi8qKlxuICogVGhlIGZpbGVzIEJpb21lIHJlYWRzIGl0cyBjb25maWd1cmF0aW9uIGZyb20uXG4gKi9cbmV4cG9ydCBjb25zdCBCSU9NRV9DT05GSUdfRklMRV9OQU1FUzogcmVhZG9ubHkgc3RyaW5nW10gPSBbUmVwb1BhdGhzLkJpb21lSnNvbiwgUmVwb1BhdGhzLkJpb21lSnNvbmNdO1xuXG4vKipcbiAqIFRoZSBmbGFncyB0aGF0IG1ha2UgQmlvbWUgc2tpcCwgcmF0aGVyIHRoYW4gZmFpbCBvbiwgYSBwYXRoIGl0IGlzIGhhbmRlZCBidXQgZG9lcyBub3QgaGFuZGxlOiBhIHByZS1jb21taXQgaG9va1xuICogaGFuZHMgZXZlcnkgdG9vbCBleHBsaWNpdCBmaWxlIGxpc3RzLCB3aGljaCBjYW4gbmFtZSBhIGZpbGUgQmlvbWUgZG9lcyBub3Qga25vdyBvciBhIGZpbGUgdGhlIHByb2plY3QgaWdub3Jlcy5cbiAqL1xuZXhwb3J0IGNvbnN0IEJJT01FX0VYUExJQ0lUX1BBVEhTX0FSR1VNRU5UUzogcmVhZG9ubHkgc3RyaW5nW10gPSBbJy0tZmlsZXMtaWdub3JlLXVua25vd249dHJ1ZScsICctLW5vLWVycm9ycy1vbi11bm1hdGNoZWQnXTtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB0aGUge0BsaW5rIGVuc3VyZUJpb21lQ29uZmlnfSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBFbnN1cmVCaW9tZUNvbmZpZ09wdGlvbnMge1xuICAvKipcbiAgICogVGhlIGNvbmZpZ3VyYXRpb24gZmlsZSBjb3BpZWQgdG8gdGhlIHByb2plY3Qgcm9vdCB3aGVuIHRoZSBwcm9qZWN0IGhhcyBub25lLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoPzogc3RyaW5nIHwgdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgZm9ybWF0fSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBGb3JtYXRPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSBjb25maWd1cmF0aW9uIGZpbGUgY29waWVkIHRvIHRoZSBwcm9qZWN0IHJvb3Qgd2hlbiB0aGUgcHJvamVjdCBoYXMgbm9uZS4gT21pdHRlZCwgYSBgYmlvbWUuanNvbmAgZXh0ZW5kaW5nXG4gICAqIHRoZSBzaGFyZWQgb25lIHRoaXMgcGFja2FnZSBzaGlwcyAoYGFzc2V0cy9iaW9tZS5qc29uYCkgaXMgd3JpdHRlbiBpbnN0ZWFkLlxuICAgKi9cbiAgcmVhZG9ubHkgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoPzogc3RyaW5nIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBPcHRpb25hbCBmaWxlIHBhdGhzIHRvIGZvcm1hdC4gSWYgb21pdHRlZCwgZm9ybWF0cyB0aGUgZW50aXJlIHByb2plY3QuXG4gICAqL1xuICByZWFkb25seSBwYXRocz86IHN0cmluZ1tdIHwgdW5kZWZpbmVkO1xuXG4gIC8qKlxuICAgKiBXaGV0aGVyIHRvIHJld3JpdGUgdGhlIHNvdXJjZSBjb2RlLlxuICAgKlxuICAgKiBAZGVmYXVsdCBgdHJ1ZWBcbiAgICovXG4gIHJlYWRvbmx5IHJld3JpdGU/OiBib29sZWFuIHwgdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIE1ha2VzIHN1cmUgdGhlIHByb2plY3QgaGFzIGEgQmlvbWUgY29uZmlndXJhdGlvbiBvZiBpdHMgb3duLlxuICpcbiAqIEJpb21lIHJlc29sdmVzIGEgY29uZmlndXJhdGlvbidzIFZDUyByb290IGFuZCBnbG9icyBhZ2FpbnN0IHRoZSBjb25maWd1cmF0aW9uIGZpbGUncyBvd24gZm9sZGVyLCBzbyBhIHNoYXJlZFxuICogY29uZmlndXJhdGlvbiBjYW5ub3QgYmUgcGFzc2VkIHdpdGggYC0tY29uZmlnLXBhdGhgIGZyb20gaW5zaWRlIGBub2RlX21vZHVsZXNgOiBpdCBsb29rcyBmb3IgYC5naXRpZ25vcmVgIHRoZXJlLlxuICogVGhlIHByb2plY3QncyBvd24gYGJpb21lLmpzb25gIGV4dGVuZHMgaXQgaW5zdGVhZC4gV2hlbiB0aGVyZSBpcyBub25lLCB0aGUgZGVmYXVsdCBvbmUgaXMgY29waWVkIGluLCBvciBhXG4gKiBgYmlvbWUuanNvbmAgZXh0ZW5kaW5nIHRoZSBzaGFyZWQgY29uZmlndXJhdGlvbiBpcyB3cml0dGVuLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIHtAbGluayBFbnN1cmVCaW9tZUNvbmZpZ09wdGlvbnN9LlxuICogQHJldHVybnMgQSB7QGxpbmsgUHJvbWlzZX0gdGhhdCByZXNvbHZlcyB3aGVuIHRoZSBwcm9qZWN0IGhhcyBhIEJpb21lIGNvbmZpZ3VyYXRpb24uXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBlbnN1cmVCaW9tZUNvbmZpZyhvcHRpb25zPzogRW5zdXJlQmlvbWVDb25maWdPcHRpb25zKTogUHJvbWlzZTx2b2lkPiB7XG4gIGlmIChoYXNCaW9tZUNvbmZpZygpKSB7XG4gICAgcmV0dXJuO1xuICB9XG5cbiAgY29uc3QgZGVidWcgPSBnZXRMaWJEZWJ1Z2dlcignQmlvbWU6ZW5zdXJlQmlvbWVDb25maWcnKTtcbiAgY29uc3QgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoID0gb3B0aW9ucz8uZGVmYXVsdENvbmZpZ0ZpbGVQYXRoO1xuICBpZiAoZGVmYXVsdENvbmZpZ0ZpbGVQYXRoKSB7XG4gICAgZGVidWcoJ0Jpb21lIGNvbmZpZ3VyYXRpb24gZmlsZSBub3QgZm91bmQuIENvcHlpbmcgdGhlIGRlZmF1bHQgY29uZmlnLi4uJyk7XG4gICAgYXdhaXQgY3AoZGVmYXVsdENvbmZpZ0ZpbGVQYXRoLCByZXNvbHZlUGF0aEZyb21Sb290U2FmZSh7IHBhdGg6IGJhc2VuYW1lKGRlZmF1bHRDb25maWdGaWxlUGF0aCkgfSkpO1xuICAgIHJldHVybjtcbiAgfVxuXG4gIGRlYnVnKCdCaW9tZSBjb25maWd1cmF0aW9uIGZpbGUgbm90IGZvdW5kLiBXcml0aW5nIG9uZSB0aGF0IGV4dGVuZHMgdGhlIHNoYXJlZCBjb25maWcuLi4nKTtcbiAgY29uc3Qgcm9vdEZvbGRlciA9IGdldFJvb3RGb2xkZXIoKTtcbiAgYXNzZXJ0Tm9uTnVsbGFibGUocm9vdEZvbGRlciwgJ1Jvb3QgZm9sZGVyIG5vdCBmb3VuZCcpO1xuICBjb25zdCBzaGFyZWRDb25maWdQYXRoID0gdG9Qb3NpeFBhdGgocmVsYXRpdmUocm9vdEZvbGRlciwgZ2V0U2hhcmVkQ29uZmlnRmlsZVBhdGgoU2hhcmVkQ29uZmlnRmlsZS5CaW9tZSkpKTtcbiAgY29uc3QgZXh0ZW5kc1BhdGggPSBKU09OLnN0cmluZ2lmeShzaGFyZWRDb25maWdQYXRoLnN0YXJ0c1dpdGgoJy4nKSA/IHNoYXJlZENvbmZpZ1BhdGggOiBgLi8ke3NoYXJlZENvbmZpZ1BhdGh9YCk7XG4gIC8vIFdyaXR0ZW4gdGhlIHdheSBgYmlvbWUgZm9ybWF0YCBwcmludHMgaXQsIHNvIHRoZSBmaXJzdCBmb3JtYXQgbGVhdmVzIHRoZSBmaWxlIGFsb25lLlxuICBhd2FpdCB3cml0ZUZpbGUocmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmUoeyBwYXRoOiBSZXBvUGF0aHMuQmlvbWVKc29uIH0pLCBge1xcbiAgXCJleHRlbmRzXCI6IFske2V4dGVuZHNQYXRofV1cXG59XFxuYCk7XG59XG5cbi8qKlxuICogRm9ybWF0IHRoZSBzb3VyY2UgY29kZSB3aXRoIEJpb21lLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIHtAbGluayBGb3JtYXRPcHRpb25zfS5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgc291cmNlIGNvZGUgaGFzIGJlZW4gZm9ybWF0dGVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZm9ybWF0KG9wdGlvbnM/OiBGb3JtYXRPcHRpb25zKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHsgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoLCBwYXRocywgcmV3cml0ZSA9IHRydWUgfSA9IG9wdGlvbnMgPz8ge307XG4gIGF3YWl0IGVuc3VyZUJpb21lQ29uZmlnKHsgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoIH0pO1xuICBjb25zdCBoYXNQYXRocyA9IHBhdGhzICE9PSB1bmRlZmluZWQgJiYgcGF0aHMubGVuZ3RoID4gMDtcblxuICBhd2FpdCBleGVjRnJvbVJvb3QoW1xuICAgIC4uLnJlc29sdmVUb29sQ29tbWFuZCh7IHRvb2w6ICdiaW9tZScgfSksXG4gICAgJ2Zvcm1hdCcsXG4gICAgLi4ucmV3cml0ZSA/IFsnLS13cml0ZSddIDogW10sXG4gICAgLi4uaGFzUGF0aHMgPyBCSU9NRV9FWFBMSUNJVF9QQVRIU19BUkdVTUVOVFMgOiBbXSxcbiAgICB7IGJhdGNoZWRBcmd1bWVudHM6IGhhc1BhdGhzID8gcGF0aHMgOiBbUmVwb1BhdGhzLkN1cnJlbnRGb2xkZXJdIH1cbiAgXSk7XG59XG5cbi8qKlxuICogU2F5cyB3aGV0aGVyIHRoZSBwcm9qZWN0IGNvbmZpZ3VyZXMgQmlvbWUgaXRzZWxmLlxuICpcbiAqIEByZXR1cm5zIFdoZXRoZXIgYSBgYmlvbWUuanNvbmAgb3IgYGJpb21lLmpzb25jYCBleGlzdHMgYXQgdGhlIHByb2plY3Qgcm9vdC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGhhc0Jpb21lQ29uZmlnKCk6IGJvb2xlYW4ge1xuICByZXR1cm4gQklPTUVfQ09ORklHX0ZJTEVfTkFNRVMuc29tZSgoZmlsZU5hbWUpID0+IGV4aXN0c1N5bmMocmVzb2x2ZVBhdGhGcm9tUm9vdFNhZmUoeyBwYXRoOiBmaWxlTmFtZSB9KSkpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQU1BLG1CQUErQjtBQUMvQixrQkFJTztBQUNQLHlCQUFrQztBQUNsQyxxQkFBMkI7QUFDM0Isc0JBR087QUFFUCw2QkFBbUM7QUFDbkMsd0JBQTBCO0FBQzFCLGtCQUlPO0FBQ1AsaUNBR087QUFLQSxNQUFNLDBCQUE2QyxDQUFDLDRCQUFVLFdBQVcsNEJBQVUsVUFBVTtBQU03RixNQUFNLGlDQUFvRCxDQUFDLCtCQUErQiwwQkFBMEI7QUE4QzNILGVBQXNCLGtCQUFrQixTQUFtRDtBQUN6RixNQUFJLGVBQWUsR0FBRztBQUNwQjtBQUFBLEVBQ0Y7QUFFQSxRQUFNLFlBQVEsNkJBQWUseUJBQXlCO0FBQ3RELFFBQU0sd0JBQXdCLFNBQVM7QUFDdkMsTUFBSSx1QkFBdUI7QUFDekIsVUFBTSxtRUFBbUU7QUFDekUsY0FBTSxvQkFBRywyQkFBdUIscUNBQXdCLEVBQUUsVUFBTSxzQkFBUyxxQkFBcUIsRUFBRSxDQUFDLENBQUM7QUFDbEc7QUFBQSxFQUNGO0FBRUEsUUFBTSxtRkFBbUY7QUFDekYsUUFBTSxpQkFBYSwyQkFBYztBQUNqQyw0Q0FBa0IsWUFBWSx1QkFBdUI7QUFDckQsUUFBTSx1QkFBbUIsNkJBQVksc0JBQVMsZ0JBQVksb0RBQXdCLDRDQUFpQixLQUFLLENBQUMsQ0FBQztBQUMxRyxRQUFNLGNBQWMsS0FBSyxVQUFVLGlCQUFpQixXQUFXLEdBQUcsSUFBSSxtQkFBbUIsS0FBSyxnQkFBZ0IsRUFBRTtBQUVoSCxZQUFNLCtCQUFVLHFDQUF3QixFQUFFLE1BQU0sNEJBQVUsVUFBVSxDQUFDLEdBQUc7QUFBQSxnQkFBb0IsV0FBVztBQUFBO0FBQUEsQ0FBUTtBQUNqSDtBQVFBLGVBQXNCLE9BQU8sU0FBd0M7QUFDbkUsUUFBTSxFQUFFLHVCQUF1QixPQUFPLFVBQVUsS0FBSyxJQUFJLFdBQVcsQ0FBQztBQUNyRSxRQUFNLGtCQUFrQixFQUFFLHNCQUFzQixDQUFDO0FBQ2pELFFBQU0sV0FBVyxVQUFVLFVBQWEsTUFBTSxTQUFTO0FBRXZELFlBQU0sMEJBQWE7QUFBQSxJQUNqQixPQUFHLDJDQUFtQixFQUFFLE1BQU0sUUFBUSxDQUFDO0FBQUEsSUFDdkM7QUFBQSxJQUNBLEdBQUcsVUFBVSxDQUFDLFNBQVMsSUFBSSxDQUFDO0FBQUEsSUFDNUIsR0FBRyxXQUFXLGlDQUFpQyxDQUFDO0FBQUEsSUFDaEQsRUFBRSxrQkFBa0IsV0FBVyxRQUFRLENBQUMsNEJBQVUsYUFBYSxFQUFFO0FBQUEsRUFDbkUsQ0FBQztBQUNIO0FBT08sU0FBUyxpQkFBMEI7QUFDeEMsU0FBTyx3QkFBd0IsS0FBSyxDQUFDLGlCQUFhLCtCQUFXLHFDQUF3QixFQUFFLE1BQU0sU0FBUyxDQUFDLENBQUMsQ0FBQztBQUMzRzsiLCJuYW1lcyI6W119

package/dist/lib/cjs/formatters/biome.d.cts

@@ -0,0 +1,69 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Format the source code with Biome.
+ */
+/**
+ * The files Biome reads its configuration from.
+ */
+export declare const BIOME_CONFIG_FILE_NAMES: readonly string[];
+/**
+ * The flags that make Biome skip, rather than fail on, a path it is handed but does not handle: a pre-commit hook
+ * hands every tool explicit file lists, which can name a file Biome does not know or a file the project ignores.
+ */
+export declare const BIOME_EXPLICIT_PATHS_ARGUMENTS: readonly string[];
+/**
+ * Parameters for the {@link ensureBiomeConfig} function.
+ */
+export interface EnsureBiomeConfigOptions {
+    /**
+     * The configuration file copied to the project root when the project has none.
+     */
+    readonly defaultConfigFilePath?: string | undefined;
+}
+/**
+ * Parameters for the {@link format} function.
+ */
+export interface FormatOptions {
+    /**
+     * The configuration file copied to the project root when the project has none. Omitted, a `biome.json` extending
+     * the shared one this package ships (`assets/biome.json`) is written instead.
+     */
+    readonly defaultConfigFilePath?: string | undefined;
+    /**
+     * Optional file paths to format. If omitted, formats the entire project.
+     */
+    readonly paths?: string[] | undefined;
+    /**
+     * Whether to rewrite the source code.
+     *
+     * @default `true`
+     */
+    readonly rewrite?: boolean | undefined;
+}
+/**
+ * Makes sure the project has a Biome configuration of its own.
+ *
+ * Biome resolves a configuration's VCS root and globs against the configuration file's own folder, so a shared
+ * configuration cannot be passed with `--config-path` from inside `node_modules`: it looks for `.gitignore` there.
+ * The project's own `biome.json` extends it instead. When there is none, the default one is copied in, or a
+ * `biome.json` extending the shared configuration is written.
+ *
+ * @param options - The {@link EnsureBiomeConfigOptions}.
+ * @returns A {@link Promise} that resolves when the project has a Biome configuration.
+ */
+export declare function ensureBiomeConfig(options?: EnsureBiomeConfigOptions): Promise<void>;
+/**
+ * Format the source code with Biome.
+ *
+ * @param options - The {@link FormatOptions}.
+ * @returns A {@link Promise} that resolves when the source code has been formatted.
+ */
+export declare function format(options?: FormatOptions): Promise<void>;
+/**
+ * Says whether the project configures Biome itself.
+ *
+ * @returns Whether a `biome.json` or `biome.jsonc` exists at the project root.
+ */
+export declare function hasBiomeConfig(): boolean;

package/dist/lib/cjs/formatters/index.cjs

@@ -33,12 +33,21 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var formatters_exports = {};
 __export(formatters_exports, {
-  dprint: () => dprint
+  auto: () => auto,
+  biome: () => biome,
+  dprint: () => dprint,
+  prettier: () => prettier
 });
 module.exports = __toCommonJS(formatters_exports);
+var auto = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./auto.cjs')), 1);
+var biome = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./biome.cjs')), 1);
 var dprint = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./dprint.cjs')), 1);
+var prettier = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./prettier.cjs')), 1);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  dprint
+  auto,
+  biome,
+  dprint,
+  prettier
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnZHByaW50JyBmcm9tICcuL2RwcmludC50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBRUEsYUFBMEI7IiwKICAibmFtZXMiOiBbXQp9Cg==
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvaW5kZXgudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qIFRISVMgSVMgQSBHRU5FUkFURUQvQlVORExFRCBGSUxFIEJZIEJVSUxEIFNDUklQVCAqL1xuXG5leHBvcnQgKiBhcyAnYXV0bycgZnJvbSAnLi9hdXRvLnRzJztcbmV4cG9ydCAqIGFzICdiaW9tZScgZnJvbSAnLi9iaW9tZS50cyc7XG5leHBvcnQgKiBhcyAnZHByaW50JyBmcm9tICcuL2RwcmludC50cyc7XG5leHBvcnQgKiBhcyAncHJldHRpZXInIGZyb20gJy4vcHJldHRpZXIudHMnO1xuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUVBLFdBQXdCO0FBQ3hCLFlBQXlCO0FBQ3pCLGFBQTBCO0FBQzFCLGVBQTRCOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/formatters/index.d.cts

@@ -1,2 +1,5 @@
 /// <reference path="../library-references.d.cts" />
+export * as 'auto' from './auto.cjs';
+export * as 'biome' from './biome.cjs';
 export * as 'dprint' from './dprint.cjs';
+export * as 'prettier' from './prettier.cjs';

package/dist/lib/cjs/formatters/prettier.cjs

@@ -0,0 +1,93 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var prettier_exports = {};
+__export(prettier_exports, {
+  PRETTIER_CONFIG_FILE_NAMES: () => PRETTIER_CONFIG_FILE_NAMES,
+  format: () => format,
+  getPrettierConfig: () => getPrettierConfig,
+  hasPrettierConfig: () => hasPrettierConfig
+});
+module.exports = __toCommonJS(prettier_exports);
+var import_node_fs = require('node:fs');
+var import_npm = require('../npm.cjs');
+var import_package_manager = require('../package-manager.cjs');
+var import_repo_paths = require('../repo-paths.cjs');
+var import_root = require('../root.cjs');
+var import_shared_config_files = require('../shared-config-files.cjs');
+const PRETTIER_CONFIG_FILE_NAMES = [
+  ".prettierrc",
+  ".prettierrc.cjs",
+  ".prettierrc.cts",
+  ".prettierrc.js",
+  ".prettierrc.json",
+  ".prettierrc.json5",
+  ".prettierrc.mjs",
+  ".prettierrc.mts",
+  ".prettierrc.toml",
+  ".prettierrc.ts",
+  ".prettierrc.yaml",
+  ".prettierrc.yml",
+  "prettier.config.cjs",
+  "prettier.config.cts",
+  "prettier.config.js",
+  "prettier.config.mjs",
+  "prettier.config.mts",
+  "prettier.config.ts"
+];
+const EXCLUDED_PATTERNS = ["!**/*.md", "!**/*-lock.json"];
+async function format(options) {
+  const { defaultConfigFilePath, paths, rewrite = true } = options ?? {};
+  const configArguments = await hasPrettierConfig() ? [] : ["--config", defaultConfigFilePath ?? (0, import_shared_config_files.getSharedConfigFilePath)(import_shared_config_files.SharedConfigFile.Prettier)];
+  const hasPaths = paths !== void 0 && paths.length > 0;
+  await (0, import_root.execFromRoot)([
+    ...(0, import_package_manager.resolveToolCommand)({ tool: "prettier" }),
+    rewrite ? "--write" : "--check",
+    "--ignore-unknown",
+    ...hasPaths ? ["--no-error-on-unmatched-pattern"] : [],
+    ...configArguments,
+    ...EXCLUDED_PATTERNS,
+    { batchedArguments: hasPaths ? paths : [import_repo_paths.RepoPaths.CurrentFolder] }
+  ]);
+}
+function getPrettierConfig() {
+  return JSON.parse((0, import_node_fs.readFileSync)((0, import_shared_config_files.getSharedConfigFilePath)(import_shared_config_files.SharedConfigFile.Prettier), "utf-8"));
+}
+async function hasPrettierConfig() {
+  if (PRETTIER_CONFIG_FILE_NAMES.some((fileName) => (0, import_node_fs.existsSync)((0, import_root.resolvePathFromRootSafe)({ path: fileName })))) {
+    return true;
+  }
+  if (!(0, import_node_fs.existsSync)((0, import_root.resolvePathFromRootSafe)({ path: import_repo_paths.RepoPaths.PackageJson }))) {
+    return false;
+  }
+  const packageJson = await (0, import_npm.readPackageJson)();
+  return Object.hasOwn(packageJson, "prettier");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PRETTIER_CONFIG_FILE_NAMES,
+  format,
+  getPrettierConfig,
+  hasPrettierConfig
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2Zvcm1hdHRlcnMvcHJldHRpZXIudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBGb3JtYXQgdGhlIHNvdXJjZSBjb2RlIHdpdGggUHJldHRpZXIuXG4gKi9cblxuaW1wb3J0IHtcbiAgZXhpc3RzU3luYyxcbiAgcmVhZEZpbGVTeW5jXG59IGZyb20gJ25vZGU6ZnMnO1xuXG5pbXBvcnQgeyByZWFkUGFja2FnZUpzb24gfSBmcm9tICcuLi9ucG0udHMnO1xuaW1wb3J0IHsgcmVzb2x2ZVRvb2xDb21tYW5kIH0gZnJvbSAnLi4vcGFja2FnZS1tYW5hZ2VyLnRzJztcbmltcG9ydCB7IFJlcG9QYXRocyB9IGZyb20gJy4uL3JlcG8tcGF0aHMudHMnO1xuaW1wb3J0IHtcbiAgZXhlY0Zyb21Sb290LFxuICByZXNvbHZlUGF0aEZyb21Sb290U2FmZVxufSBmcm9tICcuLi9yb290LnRzJztcbmltcG9ydCB7XG4gIGdldFNoYXJlZENvbmZpZ0ZpbGVQYXRoLFxuICBTaGFyZWRDb25maWdGaWxlXG59IGZyb20gJy4uL3NoYXJlZC1jb25maWctZmlsZXMudHMnO1xuXG4vKipcbiAqIEV2ZXJ5IGZpbGUgUHJldHRpZXIgcmVhZHMgaXRzIGNvbmZpZ3VyYXRpb24gZnJvbSwgYmVzaWRlcyB0aGUgYHByZXR0aWVyYCBrZXkgb2YgYHBhY2thZ2UuanNvbmAuXG4gKlxuICogQHNlZSB7QGxpbmsgaHR0cHM6Ly9wcmV0dGllci5pby9kb2NzL2NvbmZpZ3VyYXRpb259XG4gKi9cbmV4cG9ydCBjb25zdCBQUkVUVElFUl9DT05GSUdfRklMRV9OQU1FUzogcmVhZG9ubHkgc3RyaW5nW10gPSBbXG4gICcucHJldHRpZXJyYycsXG4gICcucHJldHRpZXJyYy5janMnLFxuICAnLnByZXR0aWVycmMuY3RzJyxcbiAgJy5wcmV0dGllcnJjLmpzJyxcbiAgJy5wcmV0dGllcnJjLmpzb24nLFxuICAnLnByZXR0aWVycmMuanNvbjUnLFxuICAnLnByZXR0aWVycmMubWpzJyxcbiAgJy5wcmV0dGllcnJjLm10cycsXG4gICcucHJldHRpZXJyYy50b21sJyxcbiAgJy5wcmV0dGllcnJjLnRzJyxcbiAgJy5wcmV0dGllcnJjLnlhbWwnLFxuICAnLnByZXR0aWVycmMueW1sJyxcbiAgJ3ByZXR0aWVyLmNvbmZpZy5janMnLFxuICAncHJldHRpZXIuY29uZmlnLmN0cycsXG4gICdwcmV0dGllci5jb25maWcuanMnLFxuICAncHJldHRpZXIuY29uZmlnLm1qcycsXG4gICdwcmV0dGllci5jb25maWcubXRzJyxcbiAgJ3ByZXR0aWVyLmNvbmZpZy50cydcbl07XG5cbi8qKlxuICogVGhlIGZpbGVzIFByZXR0aWVyIGxlYXZlcyBhbG9uZSwgYXMgdGhlIHNoYXJlZCBgZHByaW50Lmpzb25gIGRvZXM6IE1hcmtkb3duIGJlbG9uZ3MgdG8gbWFya2Rvd25saW50LCBhbmQgYSBsb2NrZmlsZVxuICogYmVsb25ncyB0byBpdHMgcGFja2FnZSBtYW5hZ2VyLiBUaGV5IGFyZSBwYXNzZWQgYXMgbmVnYXRlZCBwYXR0ZXJucywgd2hpY2ggUHJldHRpZXIgYXBwbGllcyB0byB0aGUgcGF0aHMgaXQgaXMgZ2l2ZW5cbiAqIGFzIHdlbGwgYXMgdG8gdGhlIG9uZXMgaXQgZmluZHMuXG4gKi9cbmNvbnN0IEVYQ0xVREVEX1BBVFRFUk5TOiByZWFkb25seSBzdHJpbmdbXSA9IFsnISoqLyoubWQnLCAnISoqLyotbG9jay5qc29uJ107XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgdGhlIHtAbGluayBmb3JtYXR9IGZ1bmN0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEZvcm1hdE9wdGlvbnMge1xuICAvKipcbiAgICogVGhlIFByZXR0aWVyIGNvbmZpZ3VyYXRpb24gdXNlZCB3aGVuIHRoZSBwcm9qZWN0IGhhcyBub25lIG9mIGl0cyBvd24uIE9taXR0ZWQsIHRoZSBzaGFyZWQgb25lIHRoaXMgcGFja2FnZSBzaGlwc1xuICAgKiAoYGFzc2V0cy9wcmV0dGllci5qc29uYCkgaXMgdXNlZC5cbiAgICovXG4gIHJlYWRvbmx5IGRlZmF1bHRDb25maWdGaWxlUGF0aD86IHN0cmluZyB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogT3B0aW9uYWwgZmlsZSBwYXRocyB0byBmb3JtYXQuIElmIG9taXR0ZWQsIGZvcm1hdHMgdGhlIGVudGlyZSBwcm9qZWN0LlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aHM/OiBzdHJpbmdbXSB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogV2hldGhlciB0byByZXdyaXRlIHRoZSBzb3VyY2UgY29kZS5cbiAgICpcbiAgICogQGRlZmF1bHQgYHRydWVgXG4gICAqL1xuICByZWFkb25seSByZXdyaXRlPzogYm9vbGVhbiB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBGb3JtYXQgdGhlIHNvdXJjZSBjb2RlIHdpdGggUHJldHRpZXIuXG4gKlxuICogUHJldHRpZXIgZmluZHMgdGhlIHByb2plY3QncyBvd24gY29uZmlndXJhdGlvbiBpdHNlbGYuIE9ubHkgYSBwcm9qZWN0IHdpdGggbm9uZSBnZXRzIGAtLWNvbmZpZ2AsIHBvaW50aW5nIGF0XG4gKiB7QGxpbmsgRm9ybWF0T3B0aW9ucy5kZWZhdWx0Q29uZmlnRmlsZVBhdGh9IG9yIGF0IHRoZSBzaGFyZWQgY29uZmlndXJhdGlvbi4gYC5naXRpZ25vcmVgIGFuZCBgLnByZXR0aWVyaWdub3JlYCBhcmVcbiAqIGhvbm9yZWQsIGFzIFByZXR0aWVyIGFsd2F5cyBkb2VzLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIHtAbGluayBGb3JtYXRPcHRpb25zfS5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgc291cmNlIGNvZGUgaGFzIGJlZW4gZm9ybWF0dGVkLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZm9ybWF0KG9wdGlvbnM/OiBGb3JtYXRPcHRpb25zKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHsgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoLCBwYXRocywgcmV3cml0ZSA9IHRydWUgfSA9IG9wdGlvbnMgPz8ge307XG4gIGNvbnN0IGNvbmZpZ0FyZ3VtZW50cyA9IGF3YWl0IGhhc1ByZXR0aWVyQ29uZmlnKClcbiAgICA/IFtdXG4gICAgOiBbJy0tY29uZmlnJywgZGVmYXVsdENvbmZpZ0ZpbGVQYXRoID8/IGdldFNoYXJlZENvbmZpZ0ZpbGVQYXRoKFNoYXJlZENvbmZpZ0ZpbGUuUHJldHRpZXIpXTtcbiAgY29uc3QgaGFzUGF0aHMgPSBwYXRocyAhPT0gdW5kZWZpbmVkICYmIHBhdGhzLmxlbmd0aCA+IDA7XG5cbiAgYXdhaXQgZXhlY0Zyb21Sb290KFtcbiAgICAuLi5yZXNvbHZlVG9vbENvbW1hbmQoeyB0b29sOiAncHJldHRpZXInIH0pLFxuICAgIHJld3JpdGUgPyAnLS13cml0ZScgOiAnLS1jaGVjaycsXG4gICAgJy0taWdub3JlLXVua25vd24nLFxuICAgIC4uLmhhc1BhdGhzID8gWyctLW5vLWVycm9yLW9uLXVubWF0Y2hlZC1wYXR0ZXJuJ10gOiBbXSxcbiAgICAuLi5jb25maWdBcmd1bWVudHMsXG4gICAgLi4uRVhDTFVERURfUEFUVEVSTlMsXG4gICAgeyBiYXRjaGVkQXJndW1lbnRzOiBoYXNQYXRocyA/IHBhdGhzIDogW1JlcG9QYXRocy5DdXJyZW50Rm9sZGVyXSB9XG4gIF0pO1xufVxuXG4vKipcbiAqIFJlYWRzIHRoZSBzaGFyZWQgUHJldHRpZXIgY29uZmlndXJhdGlvbiB0aGlzIHBhY2thZ2Ugc2hpcHMsIGZvciBhIHByb2plY3QncyBvd24gYHByZXR0aWVyLmNvbmZpZy5tanNgIHRvIGV4cG9ydCBvclxuICogYnVpbGQgb24uXG4gKlxuICogQHJldHVybnMgVGhlIHNoYXJlZCBjb25maWd1cmF0aW9uLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0UHJldHRpZXJDb25maWcoKTogUmVhZG9ubHk8UmVjb3JkPHN0cmluZywgdW5rbm93bj4+IHtcbiAgcmV0dXJuIEpTT04ucGFyc2UocmVhZEZpbGVTeW5jKGdldFNoYXJlZENvbmZpZ0ZpbGVQYXRoKFNoYXJlZENvbmZpZ0ZpbGUuUHJldHRpZXIpLCAndXRmLTgnKSkgYXMgUmVjb3JkPHN0cmluZywgdW5rbm93bj47XG59XG5cbi8qKlxuICogU2F5cyB3aGV0aGVyIHRoZSBwcm9qZWN0IGNvbmZpZ3VyZXMgUHJldHRpZXIgaXRzZWxmLlxuICpcbiAqIEByZXR1cm5zIFdoZXRoZXIgYSBQcmV0dGllciBjb25maWd1cmF0aW9uIGZpbGUsIG9yIGEgYHByZXR0aWVyYCBrZXkgaW4gYHBhY2thZ2UuanNvbmAsIGV4aXN0cyBhdCB0aGUgcHJvamVjdCByb290LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gaGFzUHJldHRpZXJDb25maWcoKTogUHJvbWlzZTxib29sZWFuPiB7XG4gIGlmIChQUkVUVElFUl9DT05GSUdfRklMRV9OQU1FUy5zb21lKChmaWxlTmFtZSkgPT4gZXhpc3RzU3luYyhyZXNvbHZlUGF0aEZyb21Sb290U2FmZSh7IHBhdGg6IGZpbGVOYW1lIH0pKSkpIHtcbiAgICByZXR1cm4gdHJ1ZTtcbiAgfVxuXG4gIGlmICghZXhpc3RzU3luYyhyZXNvbHZlUGF0aEZyb21Sb290U2FmZSh7IHBhdGg6IFJlcG9QYXRocy5QYWNrYWdlSnNvbiB9KSkpIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cblxuICBjb25zdCBwYWNrYWdlSnNvbiA9IGF3YWl0IHJlYWRQYWNrYWdlSnNvbigpO1xuICByZXR1cm4gT2JqZWN0Lmhhc093bihwYWNrYWdlSnNvbiwgJ3ByZXR0aWVyJyk7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSxxQkFHTztBQUVQLGlCQUFnQztBQUNoQyw2QkFBbUM7QUFDbkMsd0JBQTBCO0FBQzFCLGtCQUdPO0FBQ1AsaUNBR087QUFPQSxNQUFNLDZCQUFnRDtBQUFBLEVBQzNEO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFBQSxFQUNBO0FBQUEsRUFDQTtBQUFBLEVBQ0E7QUFDRjtBQU9BLE1BQU0sb0JBQXVDLENBQUMsWUFBWSxpQkFBaUI7QUFtQzNFLGVBQXNCLE9BQU8sU0FBd0M7QUFDbkUsUUFBTSxFQUFFLHVCQUF1QixPQUFPLFVBQVUsS0FBSyxJQUFJLFdBQVcsQ0FBQztBQUNyRSxRQUFNLGtCQUFrQixNQUFNLGtCQUFrQixJQUM1QyxDQUFDLElBQ0QsQ0FBQyxZQUFZLDZCQUF5QixvREFBd0IsNENBQWlCLFFBQVEsQ0FBQztBQUM1RixRQUFNLFdBQVcsVUFBVSxVQUFhLE1BQU0sU0FBUztBQUV2RCxZQUFNLDBCQUFhO0FBQUEsSUFDakIsT0FBRywyQ0FBbUIsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUFBLElBQzFDLFVBQVUsWUFBWTtBQUFBLElBQ3RCO0FBQUEsSUFDQSxHQUFHLFdBQVcsQ0FBQyxpQ0FBaUMsSUFBSSxDQUFDO0FBQUEsSUFDckQsR0FBRztBQUFBLElBQ0gsR0FBRztBQUFBLElBQ0gsRUFBRSxrQkFBa0IsV0FBVyxRQUFRLENBQUMsNEJBQVUsYUFBYSxFQUFFO0FBQUEsRUFDbkUsQ0FBQztBQUNIO0FBUU8sU0FBUyxvQkFBdUQ7QUFDckUsU0FBTyxLQUFLLFVBQU0saUNBQWEsb0RBQXdCLDRDQUFpQixRQUFRLEdBQUcsT0FBTyxDQUFDO0FBQzdGO0FBT0EsZUFBc0Isb0JBQXNDO0FBQzFELE1BQUksMkJBQTJCLEtBQUssQ0FBQyxpQkFBYSwrQkFBVyxxQ0FBd0IsRUFBRSxNQUFNLFNBQVMsQ0FBQyxDQUFDLENBQUMsR0FBRztBQUMxRyxXQUFPO0FBQUEsRUFDVDtBQUVBLE1BQUksS0FBQywrQkFBVyxxQ0FBd0IsRUFBRSxNQUFNLDRCQUFVLFlBQVksQ0FBQyxDQUFDLEdBQUc7QUFDekUsV0FBTztBQUFBLEVBQ1Q7QUFFQSxRQUFNLGNBQWMsVUFBTSw0QkFBZ0I7QUFDMUMsU0FBTyxPQUFPLE9BQU8sYUFBYSxVQUFVO0FBQzlDOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/cjs/formatters/prettier.d.cts

@@ -0,0 +1,56 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Format the source code with Prettier.
+ */
+/**
+ * Every file Prettier reads its configuration from, besides the `prettier` key of `package.json`.
+ *
+ * @see {@link https://prettier.io/docs/configuration}
+ */
+export declare const PRETTIER_CONFIG_FILE_NAMES: readonly string[];
+/**
+ * Parameters for the {@link format} function.
+ */
+export interface FormatOptions {
+    /**
+     * The Prettier configuration used when the project has none of its own. Omitted, the shared one this package ships
+     * (`assets/prettier.json`) is used.
+     */
+    readonly defaultConfigFilePath?: string | undefined;
+    /**
+     * Optional file paths to format. If omitted, formats the entire project.
+     */
+    readonly paths?: string[] | undefined;
+    /**
+     * Whether to rewrite the source code.
+     *
+     * @default `true`
+     */
+    readonly rewrite?: boolean | undefined;
+}
+/**
+ * Format the source code with Prettier.
+ *
+ * Prettier finds the project's own configuration itself. Only a project with none gets `--config`, pointing at
+ * {@link FormatOptions.defaultConfigFilePath} or at the shared configuration. `.gitignore` and `.prettierignore` are
+ * honored, as Prettier always does.
+ *
+ * @param options - The {@link FormatOptions}.
+ * @returns A {@link Promise} that resolves when the source code has been formatted.
+ */
+export declare function format(options?: FormatOptions): Promise<void>;
+/**
+ * Reads the shared Prettier configuration this package ships, for a project's own `prettier.config.mjs` to export or
+ * build on.
+ *
+ * @returns The shared configuration.
+ */
+export declare function getPrettierConfig(): Readonly<Record<string, unknown>>;
+/**
+ * Says whether the project configures Prettier itself.
+ *
+ * @returns Whether a Prettier configuration file, or a `prettier` key in `package.json`, exists at the project root.
+ */
+export declare function hasPrettierConfig(): Promise<boolean>;

package/dist/lib/cjs/index.cjs

@@ -61,6 +61,7 @@ __export(index_exports, {
   "released-issues": () => released_issues,
   "repo-paths": () => repo_paths,
   root: () => root,
+  "shared-config-files": () => shared_config_files,
   "test-runners": () => test_runners,
   "validate-declarations": () => validate_declarations,
   version: () => version
@@ -94,6 +95,7 @@ var package_manager = __toESM(((module) => module && module.__esModule && 'defau
 var released_issues = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./released-issues.cjs')), 1);
 var repo_paths = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./repo-paths.cjs')), 1);
 var root = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./root.cjs')), 1);
+var shared_config_files = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./shared-config-files.cjs')), 1);
 var test_runners = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./test-runners/index.cjs')), 1);
 var validate_declarations = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./validate-declarations.cjs')), 1);
 var version = __toESM(((module) => module && module.__esModule && 'default' in module ? module.default : module)(require('./version.cjs')), 1);
@@ -127,8 +129,9 @@ var version = __toESM(((module) => module && module.__esModule && 'default' in m
   "released-issues": null,
   "repo-paths": null,
   root,
+  "shared-config-files": null,
   "test-runners": null,
   "validate-declarations": null,
   version
 });
-//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgJ2J1aWxkJyBmcm9tICcuL2J1aWxkLnRzJztcbmV4cG9ydCAqIGFzICdidW5kbGVycycgZnJvbSAnLi9idW5kbGVycy9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAnY2hlY2stcHJvamVjdC10eXBlcycgZnJvbSAnLi9jaGVjay1wcm9qZWN0LXR5cGVzLnRzJztcbmV4cG9ydCAqIGFzICdjbGktdXRpbHMnIGZyb20gJy4vY2xpLXV0aWxzLnRzJztcbmV4cG9ydCAqIGFzICdjb2RlLWdlbmVyYXRvcicgZnJvbSAnLi9jb2RlLWdlbmVyYXRvci50cyc7XG5leHBvcnQgKiBhcyAnY29tbWl0bGludC1jb25maWcnIGZyb20gJy4vY29tbWl0bGludC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ2NvbW1pdGxpbnQtZm9yYmlkZGVuLXBhdHRlcm5zJyBmcm9tICcuL2NvbW1pdGxpbnQtZm9yYmlkZGVuLXBhdHRlcm5zLnRzJztcbmV4cG9ydCAqIGFzICdjb21taXRsaW50LXNwZWxsY2hlY2staGVhZGVyJyBmcm9tICcuL2NvbW1pdGxpbnQtc3BlbGxjaGVjay1oZWFkZXIudHMnO1xuZXhwb3J0ICogYXMgJ2RvY3Mtc2l0ZScgZnJvbSAnLi9kb2NzLXNpdGUvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ2Vudi10b2dnbGUnIGZyb20gJy4vZW52LXRvZ2dsZS50cyc7XG5leHBvcnQgKiBhcyAnZXhlYycgZnJvbSAnLi9leGVjLnRzJztcbmV4cG9ydCAqIGFzICdmb3JiaWRkZW4tcGF0dGVybnMnIGZyb20gJy4vZm9yYmlkZGVuLXBhdHRlcm5zLnRzJztcbmV4cG9ydCAqIGFzICdmb3JtYXR0ZXJzJyBmcm9tICcuL2Zvcm1hdHRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ2ZzJyBmcm9tICcuL2ZzLnRzJztcbmV4cG9ydCAqIGFzICdnYXRlJyBmcm9tICcuL2dhdGUudHMnO1xuZXhwb3J0ICogYXMgJ2dpdCcgZnJvbSAnLi9naXQudHMnO1xuZXhwb3J0ICogYXMgJ2pzb24nIGZyb20gJy4vanNvbi50cyc7XG5leHBvcnQgKiBhcyAnbGlicmFyeS1idWlsZCcgZnJvbSAnLi9saWJyYXJ5LWJ1aWxkLnRzJztcbmV4cG9ydCAqIGFzICdsaW50ZXJzJyBmcm9tICcuL2xpbnRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ25hbm8tc3RhZ2VkLWNvbmZpZycgZnJvbSAnLi9uYW5vLXN0YWdlZC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ25wbS1wdWJsaXNoJyBmcm9tICcuL25wbS1wdWJsaXNoLnRzJztcbmV4cG9ydCAqIGFzICducG0tcnVuJyBmcm9tICcuL25wbS1ydW4udHMnO1xuZXhwb3J0ICogYXMgJ25wbScgZnJvbSAnLi9ucG0udHMnO1xuZXhwb3J0ICogYXMgJ3BhY2thZ2UtbG9jay1pbnRlZ3JpdHknIGZyb20gJy4vcGFja2FnZS1sb2NrLWludGVncml0eS50cyc7XG5leHBvcnQgKiBhcyAncGFja2FnZS1tYW5hZ2VyJyBmcm9tICcuL3BhY2thZ2UtbWFuYWdlci50cyc7XG5leHBvcnQgKiBhcyAncmVsZWFzZWQtaXNzdWVzJyBmcm9tICcuL3JlbGVhc2VkLWlzc3Vlcy50cyc7XG5leHBvcnQgKiBhcyAncmVwby1wYXRocycgZnJvbSAnLi9yZXBvLXBhdGhzLnRzJztcbmV4cG9ydCAqIGFzICdyb290JyBmcm9tICcuL3Jvb3QudHMnO1xuZXhwb3J0ICogYXMgJ3Rlc3QtcnVubmVycycgZnJvbSAnLi90ZXN0LXJ1bm5lcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ3ZhbGlkYXRlLWRlY2xhcmF0aW9ucycgZnJvbSAnLi92YWxpZGF0ZS1kZWNsYXJhdGlvbnMudHMnO1xuZXhwb3J0ICogYXMgJ3ZlcnNpb24nIGZyb20gJy4vdmVyc2lvbi50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLCtCQUFBQTtBQUFBLEVBQUEsbUJBQUFDO0FBQUEsRUFBQSx3QkFBQUM7QUFBQSxFQUFBLDJCQUFBQztBQUFBLEVBQUEsdUNBQUFDO0FBQUEsRUFBQSxzQ0FBQUM7QUFBQSxFQUFBLG1CQUFBQztBQUFBLEVBQUEsb0JBQUFDO0FBQUEsRUFBQTtBQUFBLDhCQUFBQztBQUFBLEVBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBLHlCQUFBQztBQUFBLEVBQUE7QUFBQSw4QkFBQUM7QUFBQSxFQUFBO0FBQUEsdUJBQUFDO0FBQUEsRUFBQSxpQkFBQUM7QUFBQSxFQUFBLGdDQUFBQztBQUFBLEVBQUEseUJBQUFDO0FBQUEsRUFBQSx5QkFBQUM7QUFBQSxFQUFBLG9CQUFBQztBQUFBLEVBQUE7QUFBQSx3QkFBQUM7QUFBQSxFQUFBLCtCQUFBQztBQUFBLEVBQUE7QUFBQTtBQUFBO0FBRUEsWUFBeUI7QUFDekIsZUFBNEI7QUFDNUIsSUFBQWxCLHNCQUF1QztBQUN2QyxJQUFBQyxZQUE2QjtBQUM3QixJQUFBQyxpQkFBa0M7QUFDbEMsSUFBQUMsb0JBQXFDO0FBQ3JDLElBQUFDLGdDQUFpRDtBQUNqRCxJQUFBQywrQkFBZ0Q7QUFDaEQsSUFBQUMsWUFBNkI7QUFDN0IsSUFBQUMsYUFBOEI7QUFDOUIsV0FBd0I7QUFDeEIsSUFBQUMscUJBQXNDO0FBQ3RDLGlCQUE4QjtBQUM5QixTQUFzQjtBQUN0QixXQUF3QjtBQUN4QixVQUF1QjtBQUN2QixXQUF3QjtBQUN4QixJQUFBQyxnQkFBaUM7QUFDakMsY0FBMkI7QUFDM0IsSUFBQUMscUJBQXNDO0FBQ3RDLElBQUFDLGNBQStCO0FBQy9CLElBQUFDLFVBQTJCO0FBQzNCLFVBQXVCO0FBQ3ZCLElBQUFDLHlCQUEwQztBQUMxQyxJQUFBQyxrQkFBbUM7QUFDbkMsSUFBQUMsa0JBQW1DO0FBQ25DLElBQUFDLGFBQThCO0FBQzlCLFdBQXdCO0FBQ3hCLElBQUFDLGVBQWdDO0FBQ2hDLElBQUFDLHdCQUF5QztBQUN6QyxjQUEyQjsiLAogICJuYW1lcyI6IFsiY2hlY2stcHJvamVjdC10eXBlcyIsICJjbGktdXRpbHMiLCAiY29kZS1nZW5lcmF0b3IiLCAiY29tbWl0bGludC1jb25maWciLCAiY29tbWl0bGludC1mb3JiaWRkZW4tcGF0dGVybnMiLCAiY29tbWl0bGludC1zcGVsbGNoZWNrLWhlYWRlciIsICJkb2NzLXNpdGUiLCAiZW52LXRvZ2dsZSIsICJmb3JiaWRkZW4tcGF0dGVybnMiLCAibGlicmFyeS1idWlsZCIsICJuYW5vLXN0YWdlZC1jb25maWciLCAibnBtLXB1Ymxpc2giLCAibnBtLXJ1biIsICJwYWNrYWdlLWxvY2staW50ZWdyaXR5IiwgInBhY2thZ2UtbWFuYWdlciIsICJyZWxlYXNlZC1pc3N1ZXMiLCAicmVwby1wYXRocyIsICJ0ZXN0LXJ1bm5lcnMiLCAidmFsaWRhdGUtZGVjbGFyYXRpb25zIl0KfQo=
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgJ2J1aWxkJyBmcm9tICcuL2J1aWxkLnRzJztcbmV4cG9ydCAqIGFzICdidW5kbGVycycgZnJvbSAnLi9idW5kbGVycy9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAnY2hlY2stcHJvamVjdC10eXBlcycgZnJvbSAnLi9jaGVjay1wcm9qZWN0LXR5cGVzLnRzJztcbmV4cG9ydCAqIGFzICdjbGktdXRpbHMnIGZyb20gJy4vY2xpLXV0aWxzLnRzJztcbmV4cG9ydCAqIGFzICdjb2RlLWdlbmVyYXRvcicgZnJvbSAnLi9jb2RlLWdlbmVyYXRvci50cyc7XG5leHBvcnQgKiBhcyAnY29tbWl0bGludC1jb25maWcnIGZyb20gJy4vY29tbWl0bGludC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ2NvbW1pdGxpbnQtZm9yYmlkZGVuLXBhdHRlcm5zJyBmcm9tICcuL2NvbW1pdGxpbnQtZm9yYmlkZGVuLXBhdHRlcm5zLnRzJztcbmV4cG9ydCAqIGFzICdjb21taXRsaW50LXNwZWxsY2hlY2staGVhZGVyJyBmcm9tICcuL2NvbW1pdGxpbnQtc3BlbGxjaGVjay1oZWFkZXIudHMnO1xuZXhwb3J0ICogYXMgJ2RvY3Mtc2l0ZScgZnJvbSAnLi9kb2NzLXNpdGUvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ2Vudi10b2dnbGUnIGZyb20gJy4vZW52LXRvZ2dsZS50cyc7XG5leHBvcnQgKiBhcyAnZXhlYycgZnJvbSAnLi9leGVjLnRzJztcbmV4cG9ydCAqIGFzICdmb3JiaWRkZW4tcGF0dGVybnMnIGZyb20gJy4vZm9yYmlkZGVuLXBhdHRlcm5zLnRzJztcbmV4cG9ydCAqIGFzICdmb3JtYXR0ZXJzJyBmcm9tICcuL2Zvcm1hdHRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ2ZzJyBmcm9tICcuL2ZzLnRzJztcbmV4cG9ydCAqIGFzICdnYXRlJyBmcm9tICcuL2dhdGUudHMnO1xuZXhwb3J0ICogYXMgJ2dpdCcgZnJvbSAnLi9naXQudHMnO1xuZXhwb3J0ICogYXMgJ2pzb24nIGZyb20gJy4vanNvbi50cyc7XG5leHBvcnQgKiBhcyAnbGlicmFyeS1idWlsZCcgZnJvbSAnLi9saWJyYXJ5LWJ1aWxkLnRzJztcbmV4cG9ydCAqIGFzICdsaW50ZXJzJyBmcm9tICcuL2xpbnRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ25hbm8tc3RhZ2VkLWNvbmZpZycgZnJvbSAnLi9uYW5vLXN0YWdlZC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ25wbS1wdWJsaXNoJyBmcm9tICcuL25wbS1wdWJsaXNoLnRzJztcbmV4cG9ydCAqIGFzICducG0tcnVuJyBmcm9tICcuL25wbS1ydW4udHMnO1xuZXhwb3J0ICogYXMgJ25wbScgZnJvbSAnLi9ucG0udHMnO1xuZXhwb3J0ICogYXMgJ3BhY2thZ2UtbG9jay1pbnRlZ3JpdHknIGZyb20gJy4vcGFja2FnZS1sb2NrLWludGVncml0eS50cyc7XG5leHBvcnQgKiBhcyAncGFja2FnZS1tYW5hZ2VyJyBmcm9tICcuL3BhY2thZ2UtbWFuYWdlci50cyc7XG5leHBvcnQgKiBhcyAncmVsZWFzZWQtaXNzdWVzJyBmcm9tICcuL3JlbGVhc2VkLWlzc3Vlcy50cyc7XG5leHBvcnQgKiBhcyAncmVwby1wYXRocycgZnJvbSAnLi9yZXBvLXBhdGhzLnRzJztcbmV4cG9ydCAqIGFzICdyb290JyBmcm9tICcuL3Jvb3QudHMnO1xuZXhwb3J0ICogYXMgJ3NoYXJlZC1jb25maWctZmlsZXMnIGZyb20gJy4vc2hhcmVkLWNvbmZpZy1maWxlcy50cyc7XG5leHBvcnQgKiBhcyAndGVzdC1ydW5uZXJzJyBmcm9tICcuL3Rlc3QtcnVubmVycy9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAndmFsaWRhdGUtZGVjbGFyYXRpb25zJyBmcm9tICcuL3ZhbGlkYXRlLWRlY2xhcmF0aW9ucy50cyc7XG5leHBvcnQgKiBhcyAndmVyc2lvbicgZnJvbSAnLi92ZXJzaW9uLnRzJztcbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEsK0JBQUFBO0FBQUEsRUFBQSxtQkFBQUM7QUFBQSxFQUFBLHdCQUFBQztBQUFBLEVBQUEsMkJBQUFDO0FBQUEsRUFBQSx1Q0FBQUM7QUFBQSxFQUFBLHNDQUFBQztBQUFBLEVBQUEsbUJBQUFDO0FBQUEsRUFBQSxvQkFBQUM7QUFBQSxFQUFBO0FBQUEsOEJBQUFDO0FBQUEsRUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEseUJBQUFDO0FBQUEsRUFBQTtBQUFBLDhCQUFBQztBQUFBLEVBQUE7QUFBQSx1QkFBQUM7QUFBQSxFQUFBLGlCQUFBQztBQUFBLEVBQUEsZ0NBQUFDO0FBQUEsRUFBQSx5QkFBQUM7QUFBQSxFQUFBLHlCQUFBQztBQUFBLEVBQUEsb0JBQUFDO0FBQUEsRUFBQTtBQUFBLCtCQUFBQztBQUFBLEVBQUEsc0JBQUFDO0FBQUEsRUFBQSwrQkFBQUM7QUFBQSxFQUFBO0FBQUE7QUFBQTtBQUVBLFlBQXlCO0FBQ3pCLGVBQTRCO0FBQzVCLElBQUFuQixzQkFBdUM7QUFDdkMsSUFBQUMsWUFBNkI7QUFDN0IsSUFBQUMsaUJBQWtDO0FBQ2xDLElBQUFDLG9CQUFxQztBQUNyQyxJQUFBQyxnQ0FBaUQ7QUFDakQsSUFBQUMsK0JBQWdEO0FBQ2hELElBQUFDLFlBQTZCO0FBQzdCLElBQUFDLGFBQThCO0FBQzlCLFdBQXdCO0FBQ3hCLElBQUFDLHFCQUFzQztBQUN0QyxpQkFBOEI7QUFDOUIsU0FBc0I7QUFDdEIsV0FBd0I7QUFDeEIsVUFBdUI7QUFDdkIsV0FBd0I7QUFDeEIsSUFBQUMsZ0JBQWlDO0FBQ2pDLGNBQTJCO0FBQzNCLElBQUFDLHFCQUFzQztBQUN0QyxJQUFBQyxjQUErQjtBQUMvQixJQUFBQyxVQUEyQjtBQUMzQixVQUF1QjtBQUN2QixJQUFBQyx5QkFBMEM7QUFDMUMsSUFBQUMsa0JBQW1DO0FBQ25DLElBQUFDLGtCQUFtQztBQUNuQyxJQUFBQyxhQUE4QjtBQUM5QixXQUF3QjtBQUN4QixJQUFBQyxzQkFBdUM7QUFDdkMsSUFBQUMsZUFBZ0M7QUFDaEMsSUFBQUMsd0JBQXlDO0FBQ3pDLGNBQTJCOyIsCiAgIm5hbWVzIjogWyJjaGVjay1wcm9qZWN0LXR5cGVzIiwgImNsaS11dGlscyIsICJjb2RlLWdlbmVyYXRvciIsICJjb21taXRsaW50LWNvbmZpZyIsICJjb21taXRsaW50LWZvcmJpZGRlbi1wYXR0ZXJucyIsICJjb21taXRsaW50LXNwZWxsY2hlY2staGVhZGVyIiwgImRvY3Mtc2l0ZSIsICJlbnYtdG9nZ2xlIiwgImZvcmJpZGRlbi1wYXR0ZXJucyIsICJsaWJyYXJ5LWJ1aWxkIiwgIm5hbm8tc3RhZ2VkLWNvbmZpZyIsICJucG0tcHVibGlzaCIsICJucG0tcnVuIiwgInBhY2thZ2UtbG9jay1pbnRlZ3JpdHkiLCAicGFja2FnZS1tYW5hZ2VyIiwgInJlbGVhc2VkLWlzc3VlcyIsICJyZXBvLXBhdGhzIiwgInNoYXJlZC1jb25maWctZmlsZXMiLCAidGVzdC1ydW5uZXJzIiwgInZhbGlkYXRlLWRlY2xhcmF0aW9ucyJdCn0K

package/dist/lib/cjs/index.d.cts

@@ -31,6 +31,7 @@ export * as 'package-manager' from './package-manager.cjs';
 export * as 'released-issues' from './released-issues.cjs';
 export * as 'repo-paths' from './repo-paths.cjs';
 export * as 'root' from './root.cjs';
+export * as 'shared-config-files' from './shared-config-files.cjs';
 export * as 'test-runners' from './test-runners/index.cjs';
 export * as 'validate-declarations' from './validate-declarations.cjs';
 export * as 'version' from './version.cjs';

package/dist/lib/cjs/linters/auto.cjs

@@ -0,0 +1,52 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var auto_exports = {};
+__export(auto_exports, {
+  detectLinter: () => detectLinter,
+  lint: () => lint
+});
+module.exports = __toCommonJS(auto_exports);
+var import_biome = require('../formatters/biome.cjs');
+var import_biome2 = require('./biome.cjs');
+var import_eslint = require('./eslint.cjs');
+const LINTERS = {
+  biome: import_biome2.lint,
+  eslint: import_eslint.lint
+};
+function detectLinter() {
+  if ((0, import_eslint.hasEslintConfig)()) {
+    return "eslint";
+  }
+  return (0, import_biome.hasBiomeConfig)() ? "biome" : "eslint";
+}
+async function lint(options) {
+  const { linter = detectLinter(), ...lintOptions } = options ?? {};
+  await LINTERS[linter](lintOptions);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  detectLinter,
+  lint
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2xpbnRlcnMvYXV0by50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIExpbnRzIHRoZSBwcm9qZWN0IHdpdGggd2hpY2hldmVyIGxpbnRlciB0aGUgcHJvamVjdCBjb25maWd1cmVzOiBFU0xpbnQgb3IgQmlvbWUuXG4gKi9cblxuaW1wb3J0IHsgaGFzQmlvbWVDb25maWcgfSBmcm9tICcuLi9mb3JtYXR0ZXJzL2Jpb21lLnRzJztcbmltcG9ydCB7IGxpbnQgYXMgbGludFdpdGhCaW9tZSB9IGZyb20gJy4vYmlvbWUudHMnO1xuaW1wb3J0IHtcbiAgaGFzRXNsaW50Q29uZmlnLFxuICBsaW50IGFzIGxpbnRXaXRoRXNsaW50XG59IGZyb20gJy4vZXNsaW50LnRzJztcblxuLyoqXG4gKiBBIGxpbnRlciB0aGUgdG9vbGtpdCBydW5zLlxuICovXG5leHBvcnQgdHlwZSBMaW50ZXIgPSAnYmlvbWUnIHwgJ2VzbGludCc7XG5cbmNvbnN0IExJTlRFUlM6IFJlYWRvbmx5PFJlY29yZDxMaW50ZXIsIChvcHRpb25zOiBMaW50T3B0aW9ucykgPT4gUHJvbWlzZTx2b2lkPj4+ID0ge1xuICBiaW9tZTogbGludFdpdGhCaW9tZSxcbiAgZXNsaW50OiBsaW50V2l0aEVzbGludFxufTtcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB0aGUge0BsaW5rIGxpbnR9IGZ1bmN0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIExpbnRPcHRpb25zIHtcbiAgLyoqXG4gICAqIFRoZSBjb25maWd1cmF0aW9uIGZpbGUgdXNlZCB3aGVuIHRoZSBwcm9qZWN0IGhhcyBub25lIG9mIGl0cyBvd24sIGFzIHRoZSBjaG9zZW4gbGludGVyJ3Mgb3duIGBsaW50YCB0YWtlcyBpdC5cbiAgICovXG4gIHJlYWRvbmx5IGRlZmF1bHRDb25maWdGaWxlUGF0aD86IHN0cmluZyB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogVGhlIGxpbnRlciB0byBydW4uIE9taXR0ZWQsIHtAbGluayBkZXRlY3RMaW50ZXJ9IGNob29zZXMgaXQuXG4gICAqL1xuICByZWFkb25seSBsaW50ZXI/OiBMaW50ZXIgfCB1bmRlZmluZWQ7XG5cbiAgLyoqXG4gICAqIE9wdGlvbmFsIGZpbGUgcGF0aHMgdG8gbGludC4gSWYgb21pdHRlZCwgbGludHMgdGhlIGVudGlyZSBwcm9qZWN0LlxuICAgKi9cbiAgcmVhZG9ubHkgcGF0aHM/OiBzdHJpbmdbXSB8IHVuZGVmaW5lZDtcblxuICAvKipcbiAgICogV2hldGhlciB0byBmaXggbGludGluZyBpc3N1ZXMgYXV0b21hdGljYWxseS5cbiAgICpcbiAgICogQGRlZmF1bHQgYGZhbHNlYFxuICAgKi9cbiAgcmVhZG9ubHkgc2hvdWxkRml4PzogYm9vbGVhbiB8IHVuZGVmaW5lZDtcbn1cblxuLyoqXG4gKiBDaG9vc2VzIHRoZSBsaW50ZXIgZnJvbSB0aGUgY29uZmlndXJhdGlvbiBmaWxlcyBhdCB0aGUgcHJvamVjdCByb290LlxuICpcbiAqIEFuIGBlc2xpbnQuY29uZmlnLipgIGZpbGUgd2lucywgc28gYSBwcm9qZWN0IHRoYXQgZm9ybWF0cyB3aXRoIEJpb21lIGFuZCBsaW50cyB3aXRoIEVTTGludCBnZXRzIEVTTGludC4gT3RoZXJ3aXNlIGFcbiAqIGBiaW9tZS5qc29uYCAvIGBiaW9tZS5qc29uY2AgcGlja3MgQmlvbWUsIGFuZCBhIHByb2plY3Qgd2l0aCBuZWl0aGVyIGdldHMgRVNMaW50LCBhcyBiZWZvcmUgQmlvbWUgd2FzIHN1cHBvcnRlZC5cbiAqXG4gKiBAcmV0dXJucyBUaGUgbGludGVyIHRvIHJ1bi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGRldGVjdExpbnRlcigpOiBMaW50ZXIge1xuICBpZiAoaGFzRXNsaW50Q29uZmlnKCkpIHtcbiAgICByZXR1cm4gJ2VzbGludCc7XG4gIH1cblxuICByZXR1cm4gaGFzQmlvbWVDb25maWcoKSA/ICdiaW9tZScgOiAnZXNsaW50Jztcbn1cblxuLyoqXG4gKiBMaW50cyB0aGUgcHJvamVjdCB3aXRoIGl0cyBsaW50ZXIuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUge0BsaW5rIExpbnRPcHRpb25zfS5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgcHJvamVjdCBsaW50cyBjbGVhbi5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGxpbnQob3B0aW9ucz86IExpbnRPcHRpb25zKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHsgbGludGVyID0gZGV0ZWN0TGludGVyKCksIC4uLmxpbnRPcHRpb25zIH0gPSBvcHRpb25zID8/IHt9O1xuICBhd2FpdCBMSU5URVJTW2xpbnRlcl0obGludE9wdGlvbnMpO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFNQSxtQkFBK0I7QUFDL0IsSUFBQUEsZ0JBQXNDO0FBQ3RDLG9CQUdPO0FBT1AsTUFBTSxVQUE2RTtBQUFBLEVBQ2pGLE9BQU8sY0FBQUM7QUFBQSxFQUNQLFFBQVEsY0FBQUM7QUFDVjtBQXFDTyxTQUFTLGVBQXVCO0FBQ3JDLFVBQUksK0JBQWdCLEdBQUc7QUFDckIsV0FBTztBQUFBLEVBQ1Q7QUFFQSxhQUFPLDZCQUFlLElBQUksVUFBVTtBQUN0QztBQVFBLGVBQXNCLEtBQUssU0FBc0M7QUFDL0QsUUFBTSxFQUFFLFNBQVMsYUFBYSxHQUFHLEdBQUcsWUFBWSxJQUFJLFdBQVcsQ0FBQztBQUNoRSxRQUFNLFFBQVEsTUFBTSxFQUFFLFdBQVc7QUFDbkM7IiwKICAibmFtZXMiOiBbImltcG9ydF9iaW9tZSIsICJsaW50V2l0aEJpb21lIiwgImxpbnRXaXRoRXNsaW50Il0KfQo=

package/dist/lib/cjs/linters/auto.d.cts

@@ -0,0 +1,49 @@
+/// <reference path="../library-references.d.cts" />
+/**
+ * @file
+ *
+ * Lints the project with whichever linter the project configures: ESLint or Biome.
+ */
+/**
+ * A linter the toolkit runs.
+ */
+export type Linter = 'biome' | 'eslint';
+/**
+ * Parameters for the {@link lint} function.
+ */
+export interface LintOptions {
+    /**
+     * The configuration file used when the project has none of its own, as the chosen linter's own `lint` takes it.
+     */
+    readonly defaultConfigFilePath?: string | undefined;
+    /**
+     * The linter to run. Omitted, {@link detectLinter} chooses it.
+     */
+    readonly linter?: Linter | undefined;
+    /**
+     * Optional file paths to lint. If omitted, lints the entire project.
+     */
+    readonly paths?: string[] | undefined;
+    /**
+     * Whether to fix linting issues automatically.
+     *
+     * @default `false`
+     */
+    readonly shouldFix?: boolean | undefined;
+}
+/**
+ * Chooses the linter from the configuration files at the project root.
+ *
+ * An `eslint.config.*` file wins, so a project that formats with Biome and lints with ESLint gets ESLint. Otherwise a
+ * `biome.json` / `biome.jsonc` picks Biome, and a project with neither gets ESLint, as before Biome was supported.
+ *
+ * @returns The linter to run.
+ */
+export declare function detectLinter(): Linter;
+/**
+ * Lints the project with its linter.
+ *
+ * @param options - The {@link LintOptions}.
+ * @returns A {@link Promise} that resolves when the project lints clean.
+ */
+export declare function lint(options?: LintOptions): Promise<void>;