@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/esm/linters/cspell-content.d.mts

@@ -0,0 +1,46 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * Spellchecks markdown that is still in memory, with the repository's own `spellcheck` configuration.
+ *
+ * The sibling of `markdownlint-content.ts`, for the other half of the same gap: `spellcheck` can only answer
+ * for what is already on disk, so a document composed during a run — the release's changelog being the one
+ * that costs a red `main` — is checked by nothing until the next gate. A coined word in a release note lands
+ * on the default branch inside the release commit, and the NEXT release aborts in its second preflight step,
+ * in a repository nobody was working on.
+ *
+ * It SHELLS OUT where the markdownlint half calls a library, and the difference has a reason rather than
+ * being an oversight. `cspell` does export a CLI-layer `lint(fileGlobs, options, reporter)` that would be the
+ * exact analogue of `markdownlint-cli2`'s `main`, but the only way to hand it content that is not on disk is
+ * a `stdin://` glob, and its reader is `streamConsumers.text(process.stdin)` — the HOST process's own stdin,
+ * which the release's interactive review also uses. Reaching for it in-process would mean monkey-patching
+ * `process.stdin` for the whole process, so the content goes to a child's stdin instead.
+ *
+ * The `stdin://<path>` form is what makes the check the repository's own rather than a generic one: the
+ * virtual document is attributed to a REAL path, so `cspell.json` beside it — its `words`, its dictionaries,
+ * its `ignorePaths` — resolves exactly as it would for the written file. A temp file outside the repository
+ * would lose all of that, which is why it is not used.
+ */
+/**
+ * Parameters for {@link spellcheckContent}.
+ */
+export interface SpellcheckContentParams {
+    /**
+     * The content to spellcheck.
+     */
+    readonly content: string;
+    /**
+     * The path the content is checked AS — normally the path it is about to be written to. It decides which
+     * `cspell` configuration applies, and it is what every reported finding is named after.
+     */
+    readonly filePath: string;
+}
+/**
+ * Spellchecks content that is not on disk, with the configuration `spellcheck` would have used for it.
+ *
+ * @param params - The {@link SpellcheckContentParams}.
+ * @returns A {@link Promise} that resolves to the findings, each one the line the `spellcheck` output would
+ * have carried — `<path>:<line>:<column> - Unknown word (<word>)` — or an empty array when there are none.
+ */
+export declare function spellcheckContent(params: SpellcheckContentParams): Promise<string[]>;

package/dist/lib/esm/linters/cspell-content.mjs

@@ -0,0 +1,87 @@
+/*
+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 ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+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;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { getLibDebugger } from "@mnaoumov/typescript-lib/debug";
+import { toPosixPath } from "@mnaoumov/typescript-lib/path";
+import { resolveToolCommand } from "../package-manager.mjs";
+import { execFromRoot } from "../root.mjs";
+const SUCCESS_EXIT_CODE = 0;
+async function spellcheckContent(params) {
+  const { content, filePath } = params;
+  const contentDebugger = getLibDebugger("cspell:spellcheckContent");
+  const result = await execFromRoot([
+    ...resolveToolCommand({ tool: "cspell" }),
+    "lint",
+    "--no-progress",
+    "--no-must-find-files",
+    // The `CSpell: Files checked: …` summary and the color codes are both noise in a finding that ends up
+    // quoted in an error message, and both are printed by default when they are not asked away.
+    "--no-summary",
+    "--no-color",
+    // A POSIX path, because this is parsed as a URL: a Windows path's backslashes do not survive that.
+    `stdin://${toPosixPath(filePath)}`
+  ], {
+    isQuiet: true,
+    shouldIgnoreExitCode: true,
+    shouldIncludeDetails: true,
+    stdin: content
+  });
+  contentDebugger(result.stderr);
+  if (result.exitCode === SUCCESS_EXIT_CODE) {
+    return [];
+  }
+  const findings = result.stdout.split("\n").map((line) => line.trim()).filter(Boolean);
+  if (findings.length === 0) {
+    throw new Error(`\`cspell\` exited with ${String(result.exitCode)} without reporting anything:
+${result.stderr}`);
+  }
+  return findings;
+}
+export {
+  spellcheckContent
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2xpbnRlcnMvY3NwZWxsLWNvbnRlbnQudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBTcGVsbGNoZWNrcyBtYXJrZG93biB0aGF0IGlzIHN0aWxsIGluIG1lbW9yeSwgd2l0aCB0aGUgcmVwb3NpdG9yeSdzIG93biBgc3BlbGxjaGVja2AgY29uZmlndXJhdGlvbi5cbiAqXG4gKiBUaGUgc2libGluZyBvZiBgbWFya2Rvd25saW50LWNvbnRlbnQudHNgLCBmb3IgdGhlIG90aGVyIGhhbGYgb2YgdGhlIHNhbWUgZ2FwOiBgc3BlbGxjaGVja2AgY2FuIG9ubHkgYW5zd2VyXG4gKiBmb3Igd2hhdCBpcyBhbHJlYWR5IG9uIGRpc2ssIHNvIGEgZG9jdW1lbnQgY29tcG9zZWQgZHVyaW5nIGEgcnVuIFx1MjAxNCB0aGUgcmVsZWFzZSdzIGNoYW5nZWxvZyBiZWluZyB0aGUgb25lXG4gKiB0aGF0IGNvc3RzIGEgcmVkIGBtYWluYCBcdTIwMTQgaXMgY2hlY2tlZCBieSBub3RoaW5nIHVudGlsIHRoZSBuZXh0IGdhdGUuIEEgY29pbmVkIHdvcmQgaW4gYSByZWxlYXNlIG5vdGUgbGFuZHNcbiAqIG9uIHRoZSBkZWZhdWx0IGJyYW5jaCBpbnNpZGUgdGhlIHJlbGVhc2UgY29tbWl0LCBhbmQgdGhlIE5FWFQgcmVsZWFzZSBhYm9ydHMgaW4gaXRzIHNlY29uZCBwcmVmbGlnaHQgc3RlcCxcbiAqIGluIGEgcmVwb3NpdG9yeSBub2JvZHkgd2FzIHdvcmtpbmcgb24uXG4gKlxuICogSXQgU0hFTExTIE9VVCB3aGVyZSB0aGUgbWFya2Rvd25saW50IGhhbGYgY2FsbHMgYSBsaWJyYXJ5LCBhbmQgdGhlIGRpZmZlcmVuY2UgaGFzIGEgcmVhc29uIHJhdGhlciB0aGFuXG4gKiBiZWluZyBhbiBvdmVyc2lnaHQuIGBjc3BlbGxgIGRvZXMgZXhwb3J0IGEgQ0xJLWxheWVyIGBsaW50KGZpbGVHbG9icywgb3B0aW9ucywgcmVwb3J0ZXIpYCB0aGF0IHdvdWxkIGJlIHRoZVxuICogZXhhY3QgYW5hbG9ndWUgb2YgYG1hcmtkb3dubGludC1jbGkyYCdzIGBtYWluYCwgYnV0IHRoZSBvbmx5IHdheSB0byBoYW5kIGl0IGNvbnRlbnQgdGhhdCBpcyBub3Qgb24gZGlzayBpc1xuICogYSBgc3RkaW46Ly9gIGdsb2IsIGFuZCBpdHMgcmVhZGVyIGlzIGBzdHJlYW1Db25zdW1lcnMudGV4dChwcm9jZXNzLnN0ZGluKWAgXHUyMDE0IHRoZSBIT1NUIHByb2Nlc3MncyBvd24gc3RkaW4sXG4gKiB3aGljaCB0aGUgcmVsZWFzZSdzIGludGVyYWN0aXZlIHJldmlldyBhbHNvIHVzZXMuIFJlYWNoaW5nIGZvciBpdCBpbi1wcm9jZXNzIHdvdWxkIG1lYW4gbW9ua2V5LXBhdGNoaW5nXG4gKiBgcHJvY2Vzcy5zdGRpbmAgZm9yIHRoZSB3aG9sZSBwcm9jZXNzLCBzbyB0aGUgY29udGVudCBnb2VzIHRvIGEgY2hpbGQncyBzdGRpbiBpbnN0ZWFkLlxuICpcbiAqIFRoZSBgc3RkaW46Ly88cGF0aD5gIGZvcm0gaXMgd2hhdCBtYWtlcyB0aGUgY2hlY2sgdGhlIHJlcG9zaXRvcnkncyBvd24gcmF0aGVyIHRoYW4gYSBnZW5lcmljIG9uZTogdGhlXG4gKiB2aXJ0dWFsIGRvY3VtZW50IGlzIGF0dHJpYnV0ZWQgdG8gYSBSRUFMIHBhdGgsIHNvIGBjc3BlbGwuanNvbmAgYmVzaWRlIGl0IFx1MjAxNCBpdHMgYHdvcmRzYCwgaXRzIGRpY3Rpb25hcmllcyxcbiAqIGl0cyBgaWdub3JlUGF0aHNgIFx1MjAxNCByZXNvbHZlcyBleGFjdGx5IGFzIGl0IHdvdWxkIGZvciB0aGUgd3JpdHRlbiBmaWxlLiBBIHRlbXAgZmlsZSBvdXRzaWRlIHRoZSByZXBvc2l0b3J5XG4gKiB3b3VsZCBsb3NlIGFsbCBvZiB0aGF0LCB3aGljaCBpcyB3aHkgaXQgaXMgbm90IHVzZWQuXG4gKi9cblxuaW1wb3J0IHsgZ2V0TGliRGVidWdnZXIgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvZGVidWcnO1xuaW1wb3J0IHsgdG9Qb3NpeFBhdGggfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvcGF0aCc7XG5cbmltcG9ydCB7IHJlc29sdmVUb29sQ29tbWFuZCB9IGZyb20gJy4uL3BhY2thZ2UtbWFuYWdlci50cyc7XG5pbXBvcnQgeyBleGVjRnJvbVJvb3QgfSBmcm9tICcuLi9yb290LnRzJztcblxuLyoqXG4gKiBUaGUgZXhpdCBjb2RlIGBjc3BlbGxgIHJldHVybnMgd2hlbiBpdCByZXBvcnRlZCBub3RoaW5nLlxuICovXG5jb25zdCBTVUNDRVNTX0VYSVRfQ09ERSA9IDA7XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3Ige0BsaW5rIHNwZWxsY2hlY2tDb250ZW50fS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBTcGVsbGNoZWNrQ29udGVudFBhcmFtcyB7XG4gIC8qKlxuICAgKiBUaGUgY29udGVudCB0byBzcGVsbGNoZWNrLlxuICAgKi9cbiAgcmVhZG9ubHkgY29udGVudDogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBUaGUgcGF0aCB0aGUgY29udGVudCBpcyBjaGVja2VkIEFTIFx1MjAxNCBub3JtYWxseSB0aGUgcGF0aCBpdCBpcyBhYm91dCB0byBiZSB3cml0dGVuIHRvLiBJdCBkZWNpZGVzIHdoaWNoXG4gICAqIGBjc3BlbGxgIGNvbmZpZ3VyYXRpb24gYXBwbGllcywgYW5kIGl0IGlzIHdoYXQgZXZlcnkgcmVwb3J0ZWQgZmluZGluZyBpcyBuYW1lZCBhZnRlci5cbiAgICovXG4gIHJlYWRvbmx5IGZpbGVQYXRoOiBzdHJpbmc7XG59XG5cbi8qKlxuICogU3BlbGxjaGVja3MgY29udGVudCB0aGF0IGlzIG5vdCBvbiBkaXNrLCB3aXRoIHRoZSBjb25maWd1cmF0aW9uIGBzcGVsbGNoZWNrYCB3b3VsZCBoYXZlIHVzZWQgZm9yIGl0LlxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBUaGUge0BsaW5rIFNwZWxsY2hlY2tDb250ZW50UGFyYW1zfS5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgdG8gdGhlIGZpbmRpbmdzLCBlYWNoIG9uZSB0aGUgbGluZSB0aGUgYHNwZWxsY2hlY2tgIG91dHB1dCB3b3VsZFxuICogaGF2ZSBjYXJyaWVkIFx1MjAxNCBgPHBhdGg+OjxsaW5lPjo8Y29sdW1uPiAtIFVua25vd24gd29yZCAoPHdvcmQ+KWAgXHUyMDE0IG9yIGFuIGVtcHR5IGFycmF5IHdoZW4gdGhlcmUgYXJlIG5vbmUuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBzcGVsbGNoZWNrQ29udGVudChwYXJhbXM6IFNwZWxsY2hlY2tDb250ZW50UGFyYW1zKTogUHJvbWlzZTxzdHJpbmdbXT4ge1xuICBjb25zdCB7IGNvbnRlbnQsIGZpbGVQYXRoIH0gPSBwYXJhbXM7XG4gIGNvbnN0IGNvbnRlbnREZWJ1Z2dlciA9IGdldExpYkRlYnVnZ2VyKCdjc3BlbGw6c3BlbGxjaGVja0NvbnRlbnQnKTtcblxuICBjb25zdCByZXN1bHQgPSBhd2FpdCBleGVjRnJvbVJvb3QoW1xuICAgIC4uLnJlc29sdmVUb29sQ29tbWFuZCh7IHRvb2w6ICdjc3BlbGwnIH0pLFxuICAgICdsaW50JyxcbiAgICAnLS1uby1wcm9ncmVzcycsXG4gICAgJy0tbm8tbXVzdC1maW5kLWZpbGVzJyxcbiAgICAvLyBUaGUgYENTcGVsbDogRmlsZXMgY2hlY2tlZDogXHUyMDI2YCBzdW1tYXJ5IGFuZCB0aGUgY29sb3IgY29kZXMgYXJlIGJvdGggbm9pc2UgaW4gYSBmaW5kaW5nIHRoYXQgZW5kcyB1cFxuICAgIC8vIHF1b3RlZCBpbiBhbiBlcnJvciBtZXNzYWdlLCBhbmQgYm90aCBhcmUgcHJpbnRlZCBieSBkZWZhdWx0IHdoZW4gdGhleSBhcmUgbm90IGFza2VkIGF3YXkuXG4gICAgJy0tbm8tc3VtbWFyeScsXG4gICAgJy0tbm8tY29sb3InLFxuICAgIC8vIEEgUE9TSVggcGF0aCwgYmVjYXVzZSB0aGlzIGlzIHBhcnNlZCBhcyBhIFVSTDogYSBXaW5kb3dzIHBhdGgncyBiYWNrc2xhc2hlcyBkbyBub3Qgc3Vydml2ZSB0aGF0LlxuICAgIGBzdGRpbjovLyR7dG9Qb3NpeFBhdGgoZmlsZVBhdGgpfWBcbiAgXSwge1xuICAgIGlzUXVpZXQ6IHRydWUsXG4gICAgc2hvdWxkSWdub3JlRXhpdENvZGU6IHRydWUsXG4gICAgc2hvdWxkSW5jbHVkZURldGFpbHM6IHRydWUsXG4gICAgc3RkaW46IGNvbnRlbnRcbiAgfSk7XG5cbiAgY29udGVudERlYnVnZ2VyKHJlc3VsdC5zdGRlcnIpO1xuXG4gIGlmIChyZXN1bHQuZXhpdENvZGUgPT09IFNVQ0NFU1NfRVhJVF9DT0RFKSB7XG4gICAgcmV0dXJuIFtdO1xuICB9XG5cbiAgY29uc3QgZmluZGluZ3MgPSByZXN1bHQuc3Rkb3V0LnNwbGl0KCdcXG4nKS5tYXAoKGxpbmUpID0+IGxpbmUudHJpbSgpKS5maWx0ZXIoQm9vbGVhbik7XG5cbiAgLy8gQSBub24temVybyBleGl0IHdpdGggbm90aGluZyByZXBvcnRlZCBpcyBgY3NwZWxsYCBpdHNlbGYgZmFpbGluZyBcdTIwMTQgYW4gdW5yZWFkYWJsZSBjb25maWd1cmF0aW9uLCBhIG1pc3NpbmdcbiAgLy8gZGljdGlvbmFyeSwgYSBiaW5hcnkgdGhhdCB3b3VsZCBub3Qgc3RhcnQuIFJldHVybmluZyBgW11gIHRoZXJlIHdvdWxkIHJlYWQgYXMgYSBjbGVhbiBkb2N1bWVudCBhbmQgbGV0IHRoZVxuICAvLyB2ZXJ5IHRoaW5nIHRoaXMgbW9kdWxlIGV4aXN0cyB0byBjYXRjaCB0aHJvdWdoLCBzbyBpdCBmYWlscyBsb3VkbHkgYW5kIGhhbmRzIG92ZXIgd2hhdCB0aGUgdG9vbCBzYWlkLlxuICBpZiAoZmluZGluZ3MubGVuZ3RoID09PSAwKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBcXGBjc3BlbGxcXGAgZXhpdGVkIHdpdGggJHtTdHJpbmcocmVzdWx0LmV4aXRDb2RlKX0gd2l0aG91dCByZXBvcnRpbmcgYW55dGhpbmc6XFxuJHtyZXN1bHQuc3RkZXJyfWApO1xuICB9XG5cbiAgcmV0dXJuIGZpbmRpbmdzO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUF3QkEsU0FBUyxzQkFBc0I7QUFDL0IsU0FBUyxtQkFBbUI7QUFFNUIsU0FBUywwQkFBMEI7QUFDbkMsU0FBUyxvQkFBb0I7QUFLN0IsTUFBTSxvQkFBb0I7QUF5QjFCLGVBQXNCLGtCQUFrQixRQUFvRDtBQUMxRixRQUFNLEVBQUUsU0FBUyxTQUFTLElBQUk7QUFDOUIsUUFBTSxrQkFBa0IsZUFBZSwwQkFBMEI7QUFFakUsUUFBTSxTQUFTLE1BQU0sYUFBYTtBQUFBLElBQ2hDLEdBQUcsbUJBQW1CLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFBQSxJQUN4QztBQUFBLElBQ0E7QUFBQSxJQUNBO0FBQUE7QUFBQTtBQUFBLElBR0E7QUFBQSxJQUNBO0FBQUE7QUFBQSxJQUVBLFdBQVcsWUFBWSxRQUFRLENBQUM7QUFBQSxFQUNsQyxHQUFHO0FBQUEsSUFDRCxTQUFTO0FBQUEsSUFDVCxzQkFBc0I7QUFBQSxJQUN0QixzQkFBc0I7QUFBQSxJQUN0QixPQUFPO0FBQUEsRUFDVCxDQUFDO0FBRUQsa0JBQWdCLE9BQU8sTUFBTTtBQUU3QixNQUFJLE9BQU8sYUFBYSxtQkFBbUI7QUFDekMsV0FBTyxDQUFDO0FBQUEsRUFDVjtBQUVBLFFBQU0sV0FBVyxPQUFPLE9BQU8sTUFBTSxJQUFJLEVBQUUsSUFBSSxDQUFDLFNBQVMsS0FBSyxLQUFLLENBQUMsRUFBRSxPQUFPLE9BQU87QUFLcEYsTUFBSSxTQUFTLFdBQVcsR0FBRztBQUN6QixVQUFNLElBQUksTUFBTSwwQkFBMEIsT0FBTyxPQUFPLFFBQVEsQ0FBQztBQUFBLEVBQWlDLE9BQU8sTUFBTSxFQUFFO0FBQUEsRUFDbkg7QUFFQSxTQUFPO0FBQ1Q7IiwKICAibmFtZXMiOiBbXQp9Cg==

package/dist/lib/esm/linters/cspell.d.mts

@@ -0,0 +1,36 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * This module provides a function for running a spellcheck on the codebase using the `cspell` library.
+ * It reports any spelling issues found in the code and returns a {@link CliTaskResult} indicating whether the spellcheck was successful.
+ */
+/**
+ * Parameters for the {@link spellcheck} function.
+ */
+export interface SpellcheckOptions {
+    /**
+     * Optional file paths to check. If omitted, checks the entire project.
+     */
+    readonly paths?: string[] | undefined;
+}
+/**
+ * Runs a spellcheck on the entire codebase using `cspell`.
+ *
+ * Checks all files in the current folder and its subfolders for spelling issues.
+ * If issues are found, they are logged to the console with their file path, line, and column number.
+ *
+ * Uses `--no-must-find-files` so that cspell does not fail when all provided paths
+ * are excluded by built-in ignore rules (e.g., `package-lock.json`).
+ *
+ * Uses `--gitignore` so a path git ignores is a path cspell skips — generated output, build folders and
+ * every `node_modules` are covered without a hand-maintained `ignorePaths` list that drifts from
+ * `.gitignore`. It is passed on the command line rather than set in `cspell.json` so that every project
+ * consuming this function inherits it, rather than each having to edit its own config. `--gitignore-root`
+ * stops the search at the project root, so a `.gitignore` in some parent folder outside the project cannot
+ * silently remove files from the check.
+ *
+ * @param options - The {@link SpellcheckOptions}.
+ * @returns A {@link Promise} that resolves to a {@link CliTaskResult}, indicating the success or failure of the spellcheck.
+ */
+export declare function spellcheck(options?: SpellcheckOptions): Promise<void>;

package/dist/lib/esm/linters/cspell.mjs

@@ -0,0 +1,69 @@
+/*
+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 ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+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;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+import { resolveToolCommand } from "../package-manager.mjs";
+import {
+  execFromRoot,
+  getRootFolder
+} from "../root.mjs";
+async function spellcheck(options) {
+  const { paths } = options ?? {};
+  const targets = paths?.length ? paths : ["."];
+  const rootFolder = getRootFolder();
+  await execFromRoot([
+    ...resolveToolCommand({ tool: "cspell" }),
+    "--no-progress",
+    "--no-must-find-files",
+    "--gitignore",
+    ...rootFolder === null ? [] : ["--gitignore-root", rootFolder],
+    { batchedArguments: targets }
+  ]);
+}
+export {
+  spellcheck
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2xpbnRlcnMvY3NwZWxsLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogVGhpcyBtb2R1bGUgcHJvdmlkZXMgYSBmdW5jdGlvbiBmb3IgcnVubmluZyBhIHNwZWxsY2hlY2sgb24gdGhlIGNvZGViYXNlIHVzaW5nIHRoZSBgY3NwZWxsYCBsaWJyYXJ5LlxuICogSXQgcmVwb3J0cyBhbnkgc3BlbGxpbmcgaXNzdWVzIGZvdW5kIGluIHRoZSBjb2RlIGFuZCByZXR1cm5zIGEge0BsaW5rIENsaVRhc2tSZXN1bHR9IGluZGljYXRpbmcgd2hldGhlciB0aGUgc3BlbGxjaGVjayB3YXMgc3VjY2Vzc2Z1bC5cbiAqL1xuXG5pbXBvcnQgeyByZXNvbHZlVG9vbENvbW1hbmQgfSBmcm9tICcuLi9wYWNrYWdlLW1hbmFnZXIudHMnO1xuaW1wb3J0IHtcbiAgZXhlY0Zyb21Sb290LFxuICBnZXRSb290Rm9sZGVyXG59IGZyb20gJy4uL3Jvb3QudHMnO1xuXG4vKipcbiAqIFBhcmFtZXRlcnMgZm9yIHRoZSB7QGxpbmsgc3BlbGxjaGVja30gZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU3BlbGxjaGVja09wdGlvbnMge1xuICAvKipcbiAgICogT3B0aW9uYWwgZmlsZSBwYXRocyB0byBjaGVjay4gSWYgb21pdHRlZCwgY2hlY2tzIHRoZSBlbnRpcmUgcHJvamVjdC5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGhzPzogc3RyaW5nW10gfCB1bmRlZmluZWQ7XG59XG5cbi8qKlxuICogUnVucyBhIHNwZWxsY2hlY2sgb24gdGhlIGVudGlyZSBjb2RlYmFzZSB1c2luZyBgY3NwZWxsYC5cbiAqXG4gKiBDaGVja3MgYWxsIGZpbGVzIGluIHRoZSBjdXJyZW50IGZvbGRlciBhbmQgaXRzIHN1YmZvbGRlcnMgZm9yIHNwZWxsaW5nIGlzc3Vlcy5cbiAqIElmIGlzc3VlcyBhcmUgZm91bmQsIHRoZXkgYXJlIGxvZ2dlZCB0byB0aGUgY29uc29sZSB3aXRoIHRoZWlyIGZpbGUgcGF0aCwgbGluZSwgYW5kIGNvbHVtbiBudW1iZXIuXG4gKlxuICogVXNlcyBgLS1uby1tdXN0LWZpbmQtZmlsZXNgIHNvIHRoYXQgY3NwZWxsIGRvZXMgbm90IGZhaWwgd2hlbiBhbGwgcHJvdmlkZWQgcGF0aHNcbiAqIGFyZSBleGNsdWRlZCBieSBidWlsdC1pbiBpZ25vcmUgcnVsZXMgKGUuZy4sIGBwYWNrYWdlLWxvY2suanNvbmApLlxuICpcbiAqIFVzZXMgYC0tZ2l0aWdub3JlYCBzbyBhIHBhdGggZ2l0IGlnbm9yZXMgaXMgYSBwYXRoIGNzcGVsbCBza2lwcyBcdTIwMTQgZ2VuZXJhdGVkIG91dHB1dCwgYnVpbGQgZm9sZGVycyBhbmRcbiAqIGV2ZXJ5IGBub2RlX21vZHVsZXNgIGFyZSBjb3ZlcmVkIHdpdGhvdXQgYSBoYW5kLW1haW50YWluZWQgYGlnbm9yZVBhdGhzYCBsaXN0IHRoYXQgZHJpZnRzIGZyb21cbiAqIGAuZ2l0aWdub3JlYC4gSXQgaXMgcGFzc2VkIG9uIHRoZSBjb21tYW5kIGxpbmUgcmF0aGVyIHRoYW4gc2V0IGluIGBjc3BlbGwuanNvbmAgc28gdGhhdCBldmVyeSBwcm9qZWN0XG4gKiBjb25zdW1pbmcgdGhpcyBmdW5jdGlvbiBpbmhlcml0cyBpdCwgcmF0aGVyIHRoYW4gZWFjaCBoYXZpbmcgdG8gZWRpdCBpdHMgb3duIGNvbmZpZy4gYC0tZ2l0aWdub3JlLXJvb3RgXG4gKiBzdG9wcyB0aGUgc2VhcmNoIGF0IHRoZSBwcm9qZWN0IHJvb3QsIHNvIGEgYC5naXRpZ25vcmVgIGluIHNvbWUgcGFyZW50IGZvbGRlciBvdXRzaWRlIHRoZSBwcm9qZWN0IGNhbm5vdFxuICogc2lsZW50bHkgcmVtb3ZlIGZpbGVzIGZyb20gdGhlIGNoZWNrLlxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGhlIHtAbGluayBTcGVsbGNoZWNrT3B0aW9uc30uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHRvIGEge0BsaW5rIENsaVRhc2tSZXN1bHR9LCBpbmRpY2F0aW5nIHRoZSBzdWNjZXNzIG9yIGZhaWx1cmUgb2YgdGhlIHNwZWxsY2hlY2suXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBzcGVsbGNoZWNrKG9wdGlvbnM/OiBTcGVsbGNoZWNrT3B0aW9ucyk6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCB7IHBhdGhzIH0gPSBvcHRpb25zID8/IHt9O1xuICAvKiB2OCBpZ25vcmUgc3RhcnQgLS0gVGhlIHBhdGhzLXByb3ZpZGVkIGJyYW5jaCBpcyBvbmx5IGV4ZXJjaXNlZCBieSBjb25zdW1lciBwcm9qZWN0cyBwYXNzaW5nIGZpbGUgbGlzdHMuICovXG4gIGNvbnN0IHRhcmdldHMgPSBwYXRocz8ubGVuZ3RoID8gcGF0aHMgOiBbJy4nXTtcbiAgLyogdjggaWdub3JlIHN0b3AgKi9cbiAgY29uc3Qgcm9vdEZvbGRlciA9IGdldFJvb3RGb2xkZXIoKTtcbiAgYXdhaXQgZXhlY0Zyb21Sb290KFtcbiAgICAuLi5yZXNvbHZlVG9vbENvbW1hbmQoeyB0b29sOiAnY3NwZWxsJyB9KSxcbiAgICAnLS1uby1wcm9ncmVzcycsXG4gICAgJy0tbm8tbXVzdC1maW5kLWZpbGVzJyxcbiAgICAnLS1naXRpZ25vcmUnLFxuICAgIC4uLnJvb3RGb2xkZXIgPT09IG51bGwgPyBbXSA6IFsnLS1naXRpZ25vcmUtcm9vdCcsIHJvb3RGb2xkZXJdLFxuICAgIHsgYmF0Y2hlZEFyZ3VtZW50czogdGFyZ2V0cyB9XG4gIF0pO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFPQSxTQUFTLDBCQUEwQjtBQUNuQztBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQStCUCxlQUFzQixXQUFXLFNBQTRDO0FBQzNFLFFBQU0sRUFBRSxNQUFNLElBQUksV0FBVyxDQUFDO0FBRTlCLFFBQU0sVUFBVSxPQUFPLFNBQVMsUUFBUSxDQUFDLEdBQUc7QUFFNUMsUUFBTSxhQUFhLGNBQWM7QUFDakMsUUFBTSxhQUFhO0FBQUEsSUFDakIsR0FBRyxtQkFBbUIsRUFBRSxNQUFNLFNBQVMsQ0FBQztBQUFBLElBQ3hDO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxJQUNBLEdBQUcsZUFBZSxPQUFPLENBQUMsSUFBSSxDQUFDLG9CQUFvQixVQUFVO0FBQUEsSUFDN0QsRUFBRSxrQkFBa0IsUUFBUTtBQUFBLEVBQzlCLENBQUM7QUFDSDsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/linters/eslint-agnostic-core-boundary.d.mts

@@ -0,0 +1,49 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * `no-restricted-imports` pattern entries that enforce the dependency arrows between the packages of a workspace:
+ * which packages a package's code may import, by naming the ones it may not.
+ *
+ * Exported as standalone builders so the patterns can be unit-tested independently of the larger declarative
+ * config, and so the owning project can apply them scoped to each package's source files.
+ *
+ * Workspace `package.json` dependencies enforce the same boundary in the end, because an import of an undeclared
+ * package fails to resolve once the package is installed on its own. Inside the workspace every package is
+ * resolvable from every other, so without this rule a wrong arrow would surface only after publishing.
+ */
+/**
+ * Parameters for {@link getPackageBoundaryNoRestrictedImportPatterns}.
+ */
+export interface GetPackageBoundaryNoRestrictedImportPatternsParams {
+    /**
+     * The packages the package's code must not import, by package name.
+     */
+    readonly forbiddenPackageNames: readonly string[];
+    /**
+     * The name of the package the patterns apply to, named in the message.
+     */
+    readonly packageName: string;
+}
+/**
+ * A single `no-restricted-imports` pattern entry pairing a group of banned import specifiers with a
+ * human-readable message explaining why they are banned.
+ */
+export interface NoRestrictedImportPatternEntry {
+    /**
+     * The glob group of import specifiers to ban.
+     */
+    group: string[];
+    /**
+     * Human-readable message shown when an import matches the group.
+     */
+    message: string;
+}
+/**
+ * Builds the `no-restricted-imports` pattern entries banning a package's code from importing the given packages,
+ * through their root or any subpath.
+ *
+ * @param params - The {@link GetPackageBoundaryNoRestrictedImportPatternsParams}.
+ * @returns One pattern entry per forbidden package; none when nothing is forbidden.
+ */
+export declare function getPackageBoundaryNoRestrictedImportPatterns(params: GetPackageBoundaryNoRestrictedImportPatternsParams): NoRestrictedImportPatternEntry[];

package/dist/lib/esm/linters/eslint-agnostic-core-boundary.mjs

@@ -0,0 +1,57 @@
+/*
+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 ensureDisposeSymbols(symbolConstructor = Symbol) {
+  symbolConstructor.asyncDispose ??= symbolConstructor.for('Symbol.asyncDispose');
+  symbolConstructor.dispose ??= symbolConstructor.for('Symbol.dispose');
+}
+
+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;
+}
+
+(function initEsm() {
+  ensureDisposeSymbols();
+  ensureBrowserProcess();
+})();
+})();
+
+function getPackageBoundaryNoRestrictedImportPatterns(params) {
+  return params.forbiddenPackageNames.map((forbiddenPackageName) => ({
+    group: [forbiddenPackageName, `${forbiddenPackageName}/*`, `${forbiddenPackageName}/**`],
+    message: `\`${params.packageName}\` must not import \`${forbiddenPackageName}\`: the dependency arrows between the workspace packages point the other way.`
+  }));
+}
+export {
+  getPackageBoundaryNoRestrictedImportPatterns
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vLi4vc3JjL2xpbnRlcnMvZXNsaW50LWFnbm9zdGljLWNvcmUtYm91bmRhcnkudHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBgbm8tcmVzdHJpY3RlZC1pbXBvcnRzYCBwYXR0ZXJuIGVudHJpZXMgdGhhdCBlbmZvcmNlIHRoZSBkZXBlbmRlbmN5IGFycm93cyBiZXR3ZWVuIHRoZSBwYWNrYWdlcyBvZiBhIHdvcmtzcGFjZTpcbiAqIHdoaWNoIHBhY2thZ2VzIGEgcGFja2FnZSdzIGNvZGUgbWF5IGltcG9ydCwgYnkgbmFtaW5nIHRoZSBvbmVzIGl0IG1heSBub3QuXG4gKlxuICogRXhwb3J0ZWQgYXMgc3RhbmRhbG9uZSBidWlsZGVycyBzbyB0aGUgcGF0dGVybnMgY2FuIGJlIHVuaXQtdGVzdGVkIGluZGVwZW5kZW50bHkgb2YgdGhlIGxhcmdlciBkZWNsYXJhdGl2ZVxuICogY29uZmlnLCBhbmQgc28gdGhlIG93bmluZyBwcm9qZWN0IGNhbiBhcHBseSB0aGVtIHNjb3BlZCB0byBlYWNoIHBhY2thZ2UncyBzb3VyY2UgZmlsZXMuXG4gKlxuICogV29ya3NwYWNlIGBwYWNrYWdlLmpzb25gIGRlcGVuZGVuY2llcyBlbmZvcmNlIHRoZSBzYW1lIGJvdW5kYXJ5IGluIHRoZSBlbmQsIGJlY2F1c2UgYW4gaW1wb3J0IG9mIGFuIHVuZGVjbGFyZWRcbiAqIHBhY2thZ2UgZmFpbHMgdG8gcmVzb2x2ZSBvbmNlIHRoZSBwYWNrYWdlIGlzIGluc3RhbGxlZCBvbiBpdHMgb3duLiBJbnNpZGUgdGhlIHdvcmtzcGFjZSBldmVyeSBwYWNrYWdlIGlzXG4gKiByZXNvbHZhYmxlIGZyb20gZXZlcnkgb3RoZXIsIHNvIHdpdGhvdXQgdGhpcyBydWxlIGEgd3JvbmcgYXJyb3cgd291bGQgc3VyZmFjZSBvbmx5IGFmdGVyIHB1Ymxpc2hpbmcuXG4gKi9cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZ2V0UGFja2FnZUJvdW5kYXJ5Tm9SZXN0cmljdGVkSW1wb3J0UGF0dGVybnN9LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIEdldFBhY2thZ2VCb3VuZGFyeU5vUmVzdHJpY3RlZEltcG9ydFBhdHRlcm5zUGFyYW1zIHtcbiAgLyoqXG4gICAqIFRoZSBwYWNrYWdlcyB0aGUgcGFja2FnZSdzIGNvZGUgbXVzdCBub3QgaW1wb3J0LCBieSBwYWNrYWdlIG5hbWUuXG4gICAqL1xuICByZWFkb25seSBmb3JiaWRkZW5QYWNrYWdlTmFtZXM6IHJlYWRvbmx5IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBUaGUgbmFtZSBvZiB0aGUgcGFja2FnZSB0aGUgcGF0dGVybnMgYXBwbHkgdG8sIG5hbWVkIGluIHRoZSBtZXNzYWdlLlxuICAgKi9cbiAgcmVhZG9ubHkgcGFja2FnZU5hbWU6IHN0cmluZztcbn1cblxuLyoqXG4gKiBBIHNpbmdsZSBgbm8tcmVzdHJpY3RlZC1pbXBvcnRzYCBwYXR0ZXJuIGVudHJ5IHBhaXJpbmcgYSBncm91cCBvZiBiYW5uZWQgaW1wb3J0IHNwZWNpZmllcnMgd2l0aCBhXG4gKiBodW1hbi1yZWFkYWJsZSBtZXNzYWdlIGV4cGxhaW5pbmcgd2h5IHRoZXkgYXJlIGJhbm5lZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBOb1Jlc3RyaWN0ZWRJbXBvcnRQYXR0ZXJuRW50cnkge1xuICAvKipcbiAgICogVGhlIGdsb2IgZ3JvdXAgb2YgaW1wb3J0IHNwZWNpZmllcnMgdG8gYmFuLlxuICAgKi9cbiAgZ3JvdXA6IHN0cmluZ1tdO1xuXG4gIC8qKlxuICAgKiBIdW1hbi1yZWFkYWJsZSBtZXNzYWdlIHNob3duIHdoZW4gYW4gaW1wb3J0IG1hdGNoZXMgdGhlIGdyb3VwLlxuICAgKi9cbiAgbWVzc2FnZTogc3RyaW5nO1xufVxuXG4vKipcbiAqIEJ1aWxkcyB0aGUgYG5vLXJlc3RyaWN0ZWQtaW1wb3J0c2AgcGF0dGVybiBlbnRyaWVzIGJhbm5pbmcgYSBwYWNrYWdlJ3MgY29kZSBmcm9tIGltcG9ydGluZyB0aGUgZ2l2ZW4gcGFja2FnZXMsXG4gKiB0aHJvdWdoIHRoZWlyIHJvb3Qgb3IgYW55IHN1YnBhdGguXG4gKlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSB7QGxpbmsgR2V0UGFja2FnZUJvdW5kYXJ5Tm9SZXN0cmljdGVkSW1wb3J0UGF0dGVybnNQYXJhbXN9LlxuICogQHJldHVybnMgT25lIHBhdHRlcm4gZW50cnkgcGVyIGZvcmJpZGRlbiBwYWNrYWdlOyBub25lIHdoZW4gbm90aGluZyBpcyBmb3JiaWRkZW4uXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXRQYWNrYWdlQm91bmRhcnlOb1Jlc3RyaWN0ZWRJbXBvcnRQYXR0ZXJucyhwYXJhbXM6IEdldFBhY2thZ2VCb3VuZGFyeU5vUmVzdHJpY3RlZEltcG9ydFBhdHRlcm5zUGFyYW1zKTogTm9SZXN0cmljdGVkSW1wb3J0UGF0dGVybkVudHJ5W10ge1xuICByZXR1cm4gcGFyYW1zLmZvcmJpZGRlblBhY2thZ2VOYW1lcy5tYXAoKGZvcmJpZGRlblBhY2thZ2VOYW1lKSA9PiAoe1xuICAgIGdyb3VwOiBbZm9yYmlkZGVuUGFja2FnZU5hbWUsIGAke2ZvcmJpZGRlblBhY2thZ2VOYW1lfS8qYCwgYCR7Zm9yYmlkZGVuUGFja2FnZU5hbWV9LyoqYF0sXG4gICAgbWVzc2FnZTogYFxcYCR7cGFyYW1zLnBhY2thZ2VOYW1lfVxcYCBtdXN0IG5vdCBpbXBvcnQgXFxgJHtmb3JiaWRkZW5QYWNrYWdlTmFtZX1cXGA6IHRoZSBkZXBlbmRlbmN5IGFycm93cyBiZXR3ZWVuIHRoZSB3b3Jrc3BhY2UgcGFja2FnZXMgcG9pbnQgdGhlIG90aGVyIHdheS5gXG4gIH0pKTtcbn1cbiJdLAogICJtYXBwaW5ncyI6ICI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBb0RPLFNBQVMsNkNBQTZDLFFBQThGO0FBQ3pKLFNBQU8sT0FBTyxzQkFBc0IsSUFBSSxDQUFDLDBCQUEwQjtBQUFBLElBQ2pFLE9BQU8sQ0FBQyxzQkFBc0IsR0FBRyxvQkFBb0IsTUFBTSxHQUFHLG9CQUFvQixLQUFLO0FBQUEsSUFDdkYsU0FBUyxLQUFLLE9BQU8sV0FBVyx3QkFBd0Isb0JBQW9CO0FBQUEsRUFDOUUsRUFBRTtBQUNKOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/linters/eslint-config.d.mts

@@ -0,0 +1,123 @@
+/// <reference path="../index.d.mts" />
+/**
+ * @file
+ *
+ * The generic half of the shared ESLint configuration, for any TypeScript project.
+ *
+ * It integrates ESLint's own recommended rules, `typescript-eslint`, `@stylistic/eslint-plugin`,
+ * `eslint-plugin-import-x` with its TypeScript resolver, `eslint-plugin-perfectionist`, `eslint-plugin-unicorn`,
+ * `eslint-plugin-n` and the generic in-house rules. A project-type layer (the Obsidian plugin one lives in
+ * `@mnaoumov/obsidian-dev-toolkit`) builds on {@link getTypeScriptEslintConfigs} and adds only what is specific to it.
+ */
+import type { ESLint, Linter } from 'eslint';
+/**
+ * The parameters for defining ESLint configurations.
+ */
+export interface DefineEslintConfigsOptions {
+    /**
+     * A function that builds custom ESLint configurations.
+     *
+     * @param context - The ESLint configuration context.
+     * @returns The custom ESLint configurations.
+     */
+    readonly customConfigs?: (context: EslintConfigContext) => Linter.Config[];
+    /**
+     * A function that edits the ESLint configuration context.
+     *
+     * @param context - The ESLint configuration context.
+     */
+    readonly editContext?: (context: EslintConfigContext) => void;
+    /**
+     * The oldest Node version shipped source has to run on, as a semver range: a library that also runs inside an
+     * older runtime than its own tooling (an Obsidian renderer, say) names that runtime's Node here. When omitted,
+     * `eslint-plugin-n` reads the `engines` field of the project's `package.json`.
+     */
+    readonly minimumNodeVersion?: string;
+}
+/**
+ * The parameters for {@link getTypeScriptEslintConfigs}.
+ */
+export interface GetTypeScriptEslintConfigsParams {
+    /**
+     * The ESLint configuration context.
+     */
+    readonly context: EslintConfigContext;
+    /**
+     * The plugin registered under the in-house namespace. A project-type layer that adds in-house rules of its own
+     * passes ONE plugin carrying the generic rules and its own, because ESLint refuses two plugins under one namespace.
+     * Defaults to the plugin carrying the generic rules alone.
+     */
+    readonly inHousePlugin?: ESLint.Plugin;
+    /**
+     * The oldest Node version shipped source has to run on, as a semver range. When omitted, `eslint-plugin-n` reads
+     * the `engines` field of the project's `package.json`.
+     */
+    readonly minimumNodeVersion?: string;
+}
+/**
+ * The context for defining ESLint configurations.
+ */
+export declare class EslintConfigContext {
+    /**
+     * The root configuration files.
+     */
+    readonly rootConfigFiles: string[];
+    /**
+     * The script files.
+     */
+    readonly scriptFiles: string[];
+    /**
+     * The source files.
+     */
+    readonly sourceFiles: string[];
+    /**
+     * The folders holding the project's sources, by default `src` alone. A workspace whose packages each have their own
+     * `src` adds them here, so the rules keyed on a file's name inside a source folder reach those packages too.
+     */
+    readonly sourceFolders: string[];
+    /**
+     * The test files.
+     */
+    readonly testFiles: string[];
+    /**
+     * The all files.
+     *
+     * @returns The all files.
+     */
+    allFiles(): string[];
+}
+/**
+ * Creates the context of a project laid out the conventional way: sources under `src`, scripts under `scripts`, tests
+ * beside the sources or under `__tests__`, and the commitlint, ESLint and Vitest configurations at the root.
+ *
+ * @returns The context.
+ */
+export declare function createDefaultEslintConfigContext(): EslintConfigContext;
+/**
+ * Builds the ESLint configurations of a generic TypeScript project.
+ *
+ * @param options - The parameters for defining ESLint configurations.
+ * @returns The ESLint configurations.
+ */
+export declare function defineEslintConfigs(options?: DefineEslintConfigsOptions): Linter.Config[];
+/**
+ * The configurations of ESLint's own rules. A project-type layer reads it to learn which core rules this
+ * configuration sets itself.
+ *
+ * @param context - The ESLint configuration context.
+ * @returns The configurations.
+ */
+export declare function getEslintCoreConfigs(context: EslintConfigContext): Linter.Config[];
+/**
+ * The global ignores: everything `.gitignore` names, plus Claude Code's worktree folder.
+ *
+ * @returns The configurations.
+ */
+export declare function getGlobalIgnoreConfigs(): Linter.Config[];
+/**
+ * The generic layers of the shared configuration, without the global ignores.
+ *
+ * @param params - The parameters.
+ * @returns The configurations.
+ */
+export declare function getTypeScriptEslintConfigs(params: GetTypeScriptEslintConfigsParams): Linter.Config[];