@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/esm/nano-staged-config.d.mts

@@ -0,0 +1,54 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Shared nano-staged configuration for pre-commit hooks.
+ */
+/**
+ * Options for {@link getNanoStagedConfig}.
+ */
+export interface GetNanoStagedConfigOptions {
+    /**
+     * Repo-specific file-rewriting tasks, keyed by the nano-staged pattern that claims their files.
+     *
+     * Each gets spellcheck appended and its files removed from the spellcheck-only key, exactly like the shared
+     * writers. A pattern must not contain `/`, and must not repeat a shared writer pattern.
+     */
+    readonly additionalWriterTasks?: Readonly<Record<string, readonly string[]>>;
+}
+/**
+ * Nano-staged configuration that runs file-based lint, format, and spellcheck on staged files.
+ *
+ * Only includes tools that can operate on individual files. Whole-project checks
+ * (TypeScript compilation, unit tests) are left to CI.
+ *
+ * Commands run through the package manager that owns the tree — `npm run ... --`, `bun run ... --`, and
+ * so on — so nano-staged file paths are forwarded as CLI arguments.
+ *
+ * Spellcheck is partitioned across the keys rather than given a catch-all `'*'` key (see
+ * `partitionSpellcheck`). A repo adding a file-rewriting task of its own passes it to
+ * {@link getNanoStagedConfig} as `additionalWriterTasks` rather than spreading this object and adding a key,
+ * which would reintroduce the overlap for that key's files.
+ */
+export declare const obsidianDevUtilsConfig: Record<string, string[]>;
+/**
+ * Resolves the nano-staged configuration to use, honoring a per-developer opt-out.
+ *
+ * Loads a gitignored `.env` if present, then — when `NANO_STAGED` is set to an off value (`0`, `false`,
+ * `off`, or `no`) — prints a notice and exits the process successfully so the pre-commit checks are
+ * skipped. This mirrors husky's own `HUSKY=0` switch, but scoped to the nano-staged step (so the
+ * commit-msg hook still runs). Otherwise it returns {@link obsidianDevUtilsConfig}, or — when
+ * `additionalWriterTasks` are given — the same configuration re-partitioned with those writers added.
+ *
+ * `NANO_STAGED` is not an npm script, so it carries its own switch rather than the script-name-derived one
+ * every npm script gets — but both share the same notion of an off value, via {@link isEnvVariableOff}.
+ *
+ * This is a function rather than module-level code so importing the package barrel never triggers the
+ * `.env` read or the process exit; call it from the thin `scripts/nano-staged-config.ts` entry. Resolving the
+ * package manager is the one thing that does run at module scope, and it does neither of those two
+ * things — it only probes for a lockfile.
+ *
+ * @param options - The optional options.
+ * @returns The nano-staged task configuration. Does not return when the opt-out is active.
+ */
+export declare function getNanoStagedConfig(options?: GetNanoStagedConfigOptions): Record<string, string[]>;

package/dist/lib/esm/nano-staged-config.mjs

@@ -0,0 +1,103 @@
+/*
+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 process from "node:process";
+import {
+  isEnvVariableOff,
+  loadEnvFileIfExists
+} from "./env-toggle.mjs";
+import { getPackageManagerRunCommand } from "./package-manager.mjs";
+const PACKAGE_MANAGER_RUN_COMMAND = getPackageManagerRunCommand().join(" ");
+const SPELLCHECK_COMMAND = `${PACKAGE_MANAGER_RUN_COMMAND} spellcheck --`;
+const WRITER_TASKS = {
+  "*.{ts,tsx,mts}": [
+    `${PACKAGE_MANAGER_RUN_COMMAND} lint:fix --`,
+    `${PACKAGE_MANAGER_RUN_COMMAND} format --`
+  ],
+  "*.md": [
+    `${PACKAGE_MANAGER_RUN_COMMAND} lint:md:fix --`
+  ]
+};
+const obsidianDevUtilsConfig = partitionSpellcheck(WRITER_TASKS);
+const NANO_STAGED_ENV_VARIABLE = "NANO_STAGED";
+function getNanoStagedConfig(options) {
+  loadEnvFileIfExists();
+  if (isEnvVariableOff(NANO_STAGED_ENV_VARIABLE)) {
+    process.stdout.write(`nano-staged: skipped (${NANO_STAGED_ENV_VARIABLE} is off).
+`);
+    process.exit(0);
+  }
+  const additionalWriterTasks = options?.additionalWriterTasks ?? {};
+  if (Object.keys(additionalWriterTasks).length === 0) {
+    return obsidianDevUtilsConfig;
+  }
+  const duplicatePattern = Object.keys(additionalWriterTasks).find((pattern) => Object.hasOwn(WRITER_TASKS, pattern));
+  if (duplicatePattern !== void 0) {
+    throw new Error(`nano-staged writer pattern '${duplicatePattern}' is already a shared writer pattern.`);
+  }
+  return partitionSpellcheck({ ...WRITER_TASKS, ...additionalWriterTasks });
+}
+function partitionSpellcheck(writerTasks) {
+  const patterns = Object.keys(writerTasks);
+  const patternWithSlash = patterns.find((pattern) => pattern.includes("/"));
+  if (patternWithSlash !== void 0) {
+    throw new Error(`nano-staged writer pattern '${patternWithSlash}' contains '/', which the spellcheck partition cannot express.`);
+  }
+  const complementPattern = `!(${patterns.map((pattern) => `${pattern}!(?)`).join("|")})*`;
+  const config = {
+    [complementPattern]: [SPELLCHECK_COMMAND]
+  };
+  for (const [pattern, commands] of Object.entries(writerTasks)) {
+    config[pattern] = [...commands, SPELLCHECK_COMMAND];
+  }
+  return config;
+}
+export {
+  getNanoStagedConfig,
+  obsidianDevUtilsConfig
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25hbm8tc3RhZ2VkLWNvbmZpZy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBAZmlsZVxuICpcbiAqIFNoYXJlZCBuYW5vLXN0YWdlZCBjb25maWd1cmF0aW9uIGZvciBwcmUtY29tbWl0IGhvb2tzLlxuICovXG5cbmltcG9ydCBwcm9jZXNzIGZyb20gJ25vZGU6cHJvY2Vzcyc7XG5cbmltcG9ydCB7XG4gIGlzRW52VmFyaWFibGVPZmYsXG4gIGxvYWRFbnZGaWxlSWZFeGlzdHNcbn0gZnJvbSAnLi9lbnYtdG9nZ2xlLnRzJztcbmltcG9ydCB7IGdldFBhY2thZ2VNYW5hZ2VyUnVuQ29tbWFuZCB9IGZyb20gJy4vcGFja2FnZS1tYW5hZ2VyLnRzJztcblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgZ2V0TmFub1N0YWdlZENvbmZpZ30uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgR2V0TmFub1N0YWdlZENvbmZpZ09wdGlvbnMge1xuICAvKipcbiAgICogUmVwby1zcGVjaWZpYyBmaWxlLXJld3JpdGluZyB0YXNrcywga2V5ZWQgYnkgdGhlIG5hbm8tc3RhZ2VkIHBhdHRlcm4gdGhhdCBjbGFpbXMgdGhlaXIgZmlsZXMuXG4gICAqXG4gICAqIEVhY2ggZ2V0cyBzcGVsbGNoZWNrIGFwcGVuZGVkIGFuZCBpdHMgZmlsZXMgcmVtb3ZlZCBmcm9tIHRoZSBzcGVsbGNoZWNrLW9ubHkga2V5LCBleGFjdGx5IGxpa2UgdGhlIHNoYXJlZFxuICAgKiB3cml0ZXJzLiBBIHBhdHRlcm4gbXVzdCBub3QgY29udGFpbiBgL2AsIGFuZCBtdXN0IG5vdCByZXBlYXQgYSBzaGFyZWQgd3JpdGVyIHBhdHRlcm4uXG4gICAqL1xuICByZWFkb25seSBhZGRpdGlvbmFsV3JpdGVyVGFza3M/OiBSZWFkb25seTxSZWNvcmQ8c3RyaW5nLCByZWFkb25seSBzdHJpbmdbXT4+O1xufVxuXG4vKipcbiAqIFRoZSBgPG1hbmFnZXI+IHJ1bmAgcHJlZml4IGV2ZXJ5IHRhc2sgYmVsb3cgaXMgYnVpbHQgb24sIHJlc29sdmVkIG9uY2UgZm9yIHRoZSBwcm9jZXNzLlxuICpcbiAqIERldGVjdGlvbiBwcm9iZXMgZm9yIGEgbG9ja2ZpbGUgYmVzaWRlIGBwYWNrYWdlLmpzb25gLCBzbyBpdCBpcyBhIGhhbmRmdWwgb2YgYGV4aXN0c1N5bmNgIGNhbGxzIGFuZFxuICogbm90aGluZyBtb3JlIFx1MjAxNCBubyBgLmVudmAgcmVhZCBhbmQgbm8gYHByb2Nlc3MuZXhpdGAsIHdoaWNoIGlzIHdoYXQgbGV0cyBpdCBzaXQgYXQgbW9kdWxlIHNjb3BlLlxuICovXG5jb25zdCBQQUNLQUdFX01BTkFHRVJfUlVOX0NPTU1BTkQgPSBnZXRQYWNrYWdlTWFuYWdlclJ1bkNvbW1hbmQoKS5qb2luKCcgJyk7XG5cbmNvbnN0IFNQRUxMQ0hFQ0tfQ09NTUFORCA9IGAke1BBQ0tBR0VfTUFOQUdFUl9SVU5fQ09NTUFORH0gc3BlbGxjaGVjayAtLWA7XG5cbi8qKlxuICogVGhlIHRhc2tzIHRoYXQgUkVXUklURSBhIHN0YWdlZCBmaWxlLCBrZXllZCBieSB0aGUgbmFuby1zdGFnZWQgcGF0dGVybiB0aGF0IGNsYWltcyBpdC5cbiAqXG4gKiBgbGludDpmaXhgIGFuZCBgZm9ybWF0YCBib3RoIHJld3JpdGUgdGhlIGZpbGUsIHNvIHRoZXkgaGF2ZSB0byBzaGFyZSBvbmUga2V5OiBuYW5vLXN0YWdlZCBydW5zIGl0c1xuICogcGVyLXBhdHRlcm4gZ3JvdXBzIHVuZGVyIGBQcm9taXNlLmFsbGAgKGBydW4oKWAgaW4gYG5hbm8tc3RhZ2VkL2xpYi9jbWQtcnVubmVyLmpzYCksIGFuZCBzZXF1ZW5jZXMgb25seVxuICogdGhlIGNvbW1hbmRzIElOU0lERSBhIHNpbmdsZSBrZXkncyBhcnJheSAoYHJ1blRhc2soKWAsIGEgYGZvciAuLi4gb2YgYXdhaXRgKS4gU3BsaXQgYWNyb3NzIHR3byBrZXlzIHRoZXlcbiAqIHJhY2UsIHdoaWNoZXZlciBmaW5pc2hlcyBsYXN0IHdpbnMsIGFuZCB0aGUgY29tbWl0IHN0YWdlcyBieXRlcyB0aGF0IG5laXRoZXIgdG9vbCB3b3VsZCBoYXZlIHByb2R1Y2VkIG9uXG4gKiBpdHMgb3duLlxuICpcbiAqIFNvIGRvIE5PVCBleHByZXNzIGEgZGlyZWN0b3J5IGV4Y2x1c2lvbiBieSBnaXZpbmcgb25lIG9mIHRoZXNlIHR3byBpdHMgb3duIG5lZ2F0ZWQga2V5IC0tIHRoYXQgc2lsZW50bHlcbiAqIHRha2VzIHRoZSBvcmRlcmluZyBhd2F5LiBBbiBleGNsdXNpb24gYmVsb25ncyBpbiB0aGUgZXhjbHVkZWQgdG9vbCdzIG93biBjb25maWcsIHdoZXJlIEVTTGludCdzXG4gKiBgZ2xvYmFsSWdub3Jlc2AgYWxyZWFkeSBwdXRzIGl0OiBhIHBhdGggRVNMaW50IGlnbm9yZXMgaXMgcmVwb3J0ZWQgYXMgYSB3YXJuaW5nIGFuZCBleGl0cyAwIHdoZW4gaXQgaXNcbiAqIHBhc3NlZCBleHBsaWNpdGx5LCBzbyBpdCBjb3N0cyBhIGNvbnNvbGUgbGluZSByYXRoZXIgdGhhbiBhIGZhaWxlZCBjb21taXQgYW5kIG5lZWRzIG5vIGtleSBoZXJlLlxuICovXG5jb25zdCBXUklURVJfVEFTS1M6IFJlYWRvbmx5PFJlY29yZDxzdHJpbmcsIHJlYWRvbmx5IHN0cmluZ1tdPj4gPSB7XG4gICcqLnt0cyx0c3gsbXRzfSc6IFtcbiAgICBgJHtQQUNLQUdFX01BTkFHRVJfUlVOX0NPTU1BTkR9IGxpbnQ6Zml4IC0tYCxcbiAgICBgJHtQQUNLQUdFX01BTkFHRVJfUlVOX0NPTU1BTkR9IGZvcm1hdCAtLWBcbiAgXSxcbiAgJyoubWQnOiBbXG4gICAgYCR7UEFDS0FHRV9NQU5BR0VSX1JVTl9DT01NQU5EfSBsaW50Om1kOmZpeCAtLWBcbiAgXVxufTtcblxuLyoqXG4gKiBOYW5vLXN0YWdlZCBjb25maWd1cmF0aW9uIHRoYXQgcnVucyBmaWxlLWJhc2VkIGxpbnQsIGZvcm1hdCwgYW5kIHNwZWxsY2hlY2sgb24gc3RhZ2VkIGZpbGVzLlxuICpcbiAqIE9ubHkgaW5jbHVkZXMgdG9vbHMgdGhhdCBjYW4gb3BlcmF0ZSBvbiBpbmRpdmlkdWFsIGZpbGVzLiBXaG9sZS1wcm9qZWN0IGNoZWNrc1xuICogKFR5cGVTY3JpcHQgY29tcGlsYXRpb24sIHVuaXQgdGVzdHMpIGFyZSBsZWZ0IHRvIENJLlxuICpcbiAqIENvbW1hbmRzIHJ1biB0aHJvdWdoIHRoZSBwYWNrYWdlIG1hbmFnZXIgdGhhdCBvd25zIHRoZSB0cmVlIFx1MjAxNCBgbnBtIHJ1biAuLi4gLS1gLCBgYnVuIHJ1biAuLi4gLS1gLCBhbmRcbiAqIHNvIG9uIFx1MjAxNCBzbyBuYW5vLXN0YWdlZCBmaWxlIHBhdGhzIGFyZSBmb3J3YXJkZWQgYXMgQ0xJIGFyZ3VtZW50cy5cbiAqXG4gKiBTcGVsbGNoZWNrIGlzIHBhcnRpdGlvbmVkIGFjcm9zcyB0aGUga2V5cyByYXRoZXIgdGhhbiBnaXZlbiBhIGNhdGNoLWFsbCBgJyonYCBrZXkgKHNlZVxuICogYHBhcnRpdGlvblNwZWxsY2hlY2tgKS4gQSByZXBvIGFkZGluZyBhIGZpbGUtcmV3cml0aW5nIHRhc2sgb2YgaXRzIG93biBwYXNzZXMgaXQgdG9cbiAqIHtAbGluayBnZXROYW5vU3RhZ2VkQ29uZmlnfSBhcyBgYWRkaXRpb25hbFdyaXRlclRhc2tzYCByYXRoZXIgdGhhbiBzcHJlYWRpbmcgdGhpcyBvYmplY3QgYW5kIGFkZGluZyBhIGtleSxcbiAqIHdoaWNoIHdvdWxkIHJlaW50cm9kdWNlIHRoZSBvdmVybGFwIGZvciB0aGF0IGtleSdzIGZpbGVzLlxuICovXG5leHBvcnQgY29uc3Qgb2JzaWRpYW5EZXZVdGlsc0NvbmZpZzogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+ID0gcGFydGl0aW9uU3BlbGxjaGVjayhXUklURVJfVEFTS1MpO1xuXG5jb25zdCBOQU5PX1NUQUdFRF9FTlZfVkFSSUFCTEUgPSAnTkFOT19TVEFHRUQnO1xuXG4vKipcbiAqIFJlc29sdmVzIHRoZSBuYW5vLXN0YWdlZCBjb25maWd1cmF0aW9uIHRvIHVzZSwgaG9ub3JpbmcgYSBwZXItZGV2ZWxvcGVyIG9wdC1vdXQuXG4gKlxuICogTG9hZHMgYSBnaXRpZ25vcmVkIGAuZW52YCBpZiBwcmVzZW50LCB0aGVuIFx1MjAxNCB3aGVuIGBOQU5PX1NUQUdFRGAgaXMgc2V0IHRvIGFuIG9mZiB2YWx1ZSAoYDBgLCBgZmFsc2VgLFxuICogYG9mZmAsIG9yIGBub2ApIFx1MjAxNCBwcmludHMgYSBub3RpY2UgYW5kIGV4aXRzIHRoZSBwcm9jZXNzIHN1Y2Nlc3NmdWxseSBzbyB0aGUgcHJlLWNvbW1pdCBjaGVja3MgYXJlXG4gKiBza2lwcGVkLiBUaGlzIG1pcnJvcnMgaHVza3kncyBvd24gYEhVU0tZPTBgIHN3aXRjaCwgYnV0IHNjb3BlZCB0byB0aGUgbmFuby1zdGFnZWQgc3RlcCAoc28gdGhlXG4gKiBjb21taXQtbXNnIGhvb2sgc3RpbGwgcnVucykuIE90aGVyd2lzZSBpdCByZXR1cm5zIHtAbGluayBvYnNpZGlhbkRldlV0aWxzQ29uZmlnfSwgb3IgXHUyMDE0IHdoZW5cbiAqIGBhZGRpdGlvbmFsV3JpdGVyVGFza3NgIGFyZSBnaXZlbiBcdTIwMTQgdGhlIHNhbWUgY29uZmlndXJhdGlvbiByZS1wYXJ0aXRpb25lZCB3aXRoIHRob3NlIHdyaXRlcnMgYWRkZWQuXG4gKlxuICogYE5BTk9fU1RBR0VEYCBpcyBub3QgYW4gbnBtIHNjcmlwdCwgc28gaXQgY2FycmllcyBpdHMgb3duIHN3aXRjaCByYXRoZXIgdGhhbiB0aGUgc2NyaXB0LW5hbWUtZGVyaXZlZCBvbmVcbiAqIGV2ZXJ5IG5wbSBzY3JpcHQgZ2V0cyBcdTIwMTQgYnV0IGJvdGggc2hhcmUgdGhlIHNhbWUgbm90aW9uIG9mIGFuIG9mZiB2YWx1ZSwgdmlhIHtAbGluayBpc0VudlZhcmlhYmxlT2ZmfS5cbiAqXG4gKiBUaGlzIGlzIGEgZnVuY3Rpb24gcmF0aGVyIHRoYW4gbW9kdWxlLWxldmVsIGNvZGUgc28gaW1wb3J0aW5nIHRoZSBwYWNrYWdlIGJhcnJlbCBuZXZlciB0cmlnZ2VycyB0aGVcbiAqIGAuZW52YCByZWFkIG9yIHRoZSBwcm9jZXNzIGV4aXQ7IGNhbGwgaXQgZnJvbSB0aGUgdGhpbiBgc2NyaXB0cy9uYW5vLXN0YWdlZC1jb25maWcudHNgIGVudHJ5LiBSZXNvbHZpbmcgdGhlXG4gKiBwYWNrYWdlIG1hbmFnZXIgaXMgdGhlIG9uZSB0aGluZyB0aGF0IGRvZXMgcnVuIGF0IG1vZHVsZSBzY29wZSwgYW5kIGl0IGRvZXMgbmVpdGhlciBvZiB0aG9zZSB0d29cbiAqIHRoaW5ncyBcdTIwMTQgaXQgb25seSBwcm9iZXMgZm9yIGEgbG9ja2ZpbGUuXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUaGUgb3B0aW9uYWwgb3B0aW9ucy5cbiAqIEByZXR1cm5zIFRoZSBuYW5vLXN0YWdlZCB0YXNrIGNvbmZpZ3VyYXRpb24uIERvZXMgbm90IHJldHVybiB3aGVuIHRoZSBvcHQtb3V0IGlzIGFjdGl2ZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldE5hbm9TdGFnZWRDb25maWcob3B0aW9ucz86IEdldE5hbm9TdGFnZWRDb25maWdPcHRpb25zKTogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+IHtcbiAgbG9hZEVudkZpbGVJZkV4aXN0cygpO1xuXG4gIGlmIChpc0VudlZhcmlhYmxlT2ZmKE5BTk9fU1RBR0VEX0VOVl9WQVJJQUJMRSkpIHtcbiAgICBwcm9jZXNzLnN0ZG91dC53cml0ZShgbmFuby1zdGFnZWQ6IHNraXBwZWQgKCR7TkFOT19TVEFHRURfRU5WX1ZBUklBQkxFfSBpcyBvZmYpLlxcbmApO1xuICAgIHByb2Nlc3MuZXhpdCgwKTtcbiAgfVxuXG4gIGNvbnN0IGFkZGl0aW9uYWxXcml0ZXJUYXNrcyA9IG9wdGlvbnM/LmFkZGl0aW9uYWxXcml0ZXJUYXNrcyA/PyB7fTtcbiAgaWYgKE9iamVjdC5rZXlzKGFkZGl0aW9uYWxXcml0ZXJUYXNrcykubGVuZ3RoID09PSAwKSB7XG4gICAgcmV0dXJuIG9ic2lkaWFuRGV2VXRpbHNDb25maWc7XG4gIH1cblxuICBjb25zdCBkdXBsaWNhdGVQYXR0ZXJuID0gT2JqZWN0LmtleXMoYWRkaXRpb25hbFdyaXRlclRhc2tzKS5maW5kKChwYXR0ZXJuKSA9PiBPYmplY3QuaGFzT3duKFdSSVRFUl9UQVNLUywgcGF0dGVybikpO1xuICBpZiAoZHVwbGljYXRlUGF0dGVybiAhPT0gdW5kZWZpbmVkKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKGBuYW5vLXN0YWdlZCB3cml0ZXIgcGF0dGVybiAnJHtkdXBsaWNhdGVQYXR0ZXJufScgaXMgYWxyZWFkeSBhIHNoYXJlZCB3cml0ZXIgcGF0dGVybi5gKTtcbiAgfVxuXG4gIHJldHVybiBwYXJ0aXRpb25TcGVsbGNoZWNrKHsgLi4uV1JJVEVSX1RBU0tTLCAuLi5hZGRpdGlvbmFsV3JpdGVyVGFza3MgfSk7XG59XG5cbi8qKlxuICogQnVpbGRzIGEgbmFuby1zdGFnZWQgY29uZmlndXJhdGlvbiBpbiB3aGljaCBzcGVsbGNoZWNrIG5ldmVyIHJlYWRzIGEgZmlsZSB3aGlsZSBhbm90aGVyIHRhc2sgcmV3cml0ZXMgaXQuXG4gKlxuICogVGhlIHNhbWUgYFByb21pc2UuYWxsYCB0aGF0IGZvcmNlcyB0d28gd3JpdGVycyBpbnRvIG9uZSBrZXkgbWFrZXMgYSBjYXRjaC1hbGwgYCcqJ2Agc3BlbGxjaGVjayBrZXkgcnVuXG4gKiBDT05DVVJSRU5UTFkgd2l0aCBldmVyeSB3cml0ZXIga2V5LCBzbyBjc3BlbGwgd291bGQgcmVhZCBhIGZpbGUgdGhhdCBFU0xpbnQgb3IgZHByaW50IGlzIHJld3JpdGluZyBpblxuICogcGxhY2UgLS0gYSBzcHVyaW91cyBmaW5kaW5nIG9uIGEgaGFsZi13cml0dGVuIGZpbGUsIG9yIGEgcGFzcyBvdmVyIGNvbnRlbnQgdGhhdCBpcyBub3Qgd2hhdCBnZXRzXG4gKiBjb21taXR0ZWQuIFNvIHRoZSBzdGFnZWQgZmlsZXMgYXJlIFBBUlRJVElPTkVEIGluc3RlYWQ6XG4gKlxuICogLSBldmVyeSB3cml0ZXIga2V5IGdldHMgc3BlbGxjaGVjayBhcHBlbmRlZCBhcyBpdHMgTEFTVCBjb21tYW5kLCBzbyBpdCByZWFkcyB0aGF0IGtleSdzIGZpbGVzIGFmdGVyIHRoZXlcbiAqICAgaGF2ZSBiZWVuIHJld3JpdHRlbjtcbiAqIC0gb25lIGNvbXBsZW1lbnQga2V5IHNwZWxsY2hlY2tzIGV4YWN0bHkgdGhlIGZpbGVzIG5vIHdyaXRlciBrZXkgY2xhaW1zLlxuICpcbiAqIFRoZSBjb21wbGVtZW50IGlzIHdyaXR0ZW4gaW4gbmFuby1zdGFnZWQncyBvd24gZ2xvYiBkaWFsZWN0LCB3aGljaCBjb21waWxlcyBgISguLi4pYCB0byBhIGxvb2thaGVhZCB0aGF0XG4gKiBpcyBOT1QgYW5jaG9yZWQgYXQgdGhlIGVuZCBvZiB0aGUgcGF0aDogYCEoKi5tZCkqYCB3b3VsZCBleGNsdWRlIGBub3Rlcy5tZC5iYWtgIHRvby4gQSBuZXN0ZWQgYCEoPylgXG4gKiBjb21waWxlcyB0byBgKD8hLilgLCB3aGljaCBJUyBhbiBlbmQgYW5jaG9yLCBzbyBlYWNoIGFsdGVybmF0aXZlIGlzIHN1ZmZpeGVkIHdpdGggaXQuIEEgd3JpdGVyIHBhdHRlcm5cbiAqIGNvbnRhaW5pbmcgYC9gIHdvdWxkIHN3aXRjaCBuYW5vLXN0YWdlZCBpbnRvIGdsb2JzdGFyIG1vZGUsIHdoZXJlIGAqYCBzdG9wcyBjcm9zc2luZyBkaXJlY3RvcmllcyBhbmQgdGhlXG4gKiBjb25zdHJ1Y3Rpb24gbm8gbG9uZ2VyIGhvbGRzIC0tIGhlbmNlIHRoZSB0aHJvdy4gVGhlIHVuaXQgdGVzdCBwaW5zIHRoZSBwYXJ0aXRpb24gYWdhaW5zdCB0aGUgaW5zdGFsbGVkXG4gKiBuYW5vLXN0YWdlZCBjb21waWxlciwgc28gYSByZWxlYXNlIHRoYXQgY2hhbmdlcyBpdHMgZGlhbGVjdCBmYWlscyB0aGVyZSByYXRoZXIgdGhhbiBpbiBhIGNvbW1pdC5cbiAqXG4gKiBAcGFyYW0gd3JpdGVyVGFza3MgLSBUaGUgZmlsZS1yZXdyaXRpbmcgdGFza3MsIGtleWVkIGJ5IHRoZSBwYXR0ZXJuIHRoYXQgY2xhaW1zIHRoZWlyIGZpbGVzLlxuICogQHJldHVybnMgVGhlIGNvbmZpZ3VyYXRpb24sIHdpdGggdGhlIHNwZWxsY2hlY2sgc3RlcCBwYXJ0aXRpb25lZCBhY3Jvc3MgdGhlIGtleXMuXG4gKi9cbmZ1bmN0aW9uIHBhcnRpdGlvblNwZWxsY2hlY2sod3JpdGVyVGFza3M6IFJlYWRvbmx5PFJlY29yZDxzdHJpbmcsIHJlYWRvbmx5IHN0cmluZ1tdPj4pOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmdbXT4ge1xuICBjb25zdCBwYXR0ZXJucyA9IE9iamVjdC5rZXlzKHdyaXRlclRhc2tzKTtcbiAgY29uc3QgcGF0dGVybldpdGhTbGFzaCA9IHBhdHRlcm5zLmZpbmQoKHBhdHRlcm4pID0+IHBhdHRlcm4uaW5jbHVkZXMoJy8nKSk7XG4gIGlmIChwYXR0ZXJuV2l0aFNsYXNoICE9PSB1bmRlZmluZWQpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoYG5hbm8tc3RhZ2VkIHdyaXRlciBwYXR0ZXJuICcke3BhdHRlcm5XaXRoU2xhc2h9JyBjb250YWlucyAnLycsIHdoaWNoIHRoZSBzcGVsbGNoZWNrIHBhcnRpdGlvbiBjYW5ub3QgZXhwcmVzcy5gKTtcbiAgfVxuXG4gIGNvbnN0IGNvbXBsZW1lbnRQYXR0ZXJuID0gYCEoJHtwYXR0ZXJucy5tYXAoKHBhdHRlcm4pID0+IGAke3BhdHRlcm59ISg/KWApLmpvaW4oJ3wnKX0pKmA7XG4gIGNvbnN0IGNvbmZpZzogUmVjb3JkPHN0cmluZywgc3RyaW5nW10+ID0ge1xuICAgIFtjb21wbGVtZW50UGF0dGVybl06IFtTUEVMTENIRUNLX0NPTU1BTkRdXG4gIH07XG5cbiAgZm9yIChjb25zdCBbcGF0dGVybiwgY29tbWFuZHNdIG9mIE9iamVjdC5lbnRyaWVzKHdyaXRlclRhc2tzKSkge1xuICAgIGNvbmZpZ1twYXR0ZXJuXSA9IFsuLi5jb21tYW5kcywgU1BFTExDSEVDS19DT01NQU5EXTtcbiAgfVxuXG4gIHJldHVybiBjb25maWc7XG59XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQU1BLE9BQU8sYUFBYTtBQUVwQjtBQUFBLEVBQ0U7QUFBQSxFQUNBO0FBQUEsT0FDSztBQUNQLFNBQVMsbUNBQW1DO0FBcUI1QyxNQUFNLDhCQUE4Qiw0QkFBNEIsRUFBRSxLQUFLLEdBQUc7QUFFMUUsTUFBTSxxQkFBcUIsR0FBRywyQkFBMkI7QUFnQnpELE1BQU0sZUFBNEQ7QUFBQSxFQUNoRSxrQkFBa0I7QUFBQSxJQUNoQixHQUFHLDJCQUEyQjtBQUFBLElBQzlCLEdBQUcsMkJBQTJCO0FBQUEsRUFDaEM7QUFBQSxFQUNBLFFBQVE7QUFBQSxJQUNOLEdBQUcsMkJBQTJCO0FBQUEsRUFDaEM7QUFDRjtBQWdCTyxNQUFNLHlCQUFtRCxvQkFBb0IsWUFBWTtBQUVoRyxNQUFNLDJCQUEyQjtBQXNCMUIsU0FBUyxvQkFBb0IsU0FBZ0U7QUFDbEcsc0JBQW9CO0FBRXBCLE1BQUksaUJBQWlCLHdCQUF3QixHQUFHO0FBQzlDLFlBQVEsT0FBTyxNQUFNLHlCQUF5Qix3QkFBd0I7QUFBQSxDQUFhO0FBQ25GLFlBQVEsS0FBSyxDQUFDO0FBQUEsRUFDaEI7QUFFQSxRQUFNLHdCQUF3QixTQUFTLHlCQUF5QixDQUFDO0FBQ2pFLE1BQUksT0FBTyxLQUFLLHFCQUFxQixFQUFFLFdBQVcsR0FBRztBQUNuRCxXQUFPO0FBQUEsRUFDVDtBQUVBLFFBQU0sbUJBQW1CLE9BQU8sS0FBSyxxQkFBcUIsRUFBRSxLQUFLLENBQUMsWUFBWSxPQUFPLE9BQU8sY0FBYyxPQUFPLENBQUM7QUFDbEgsTUFBSSxxQkFBcUIsUUFBVztBQUNsQyxVQUFNLElBQUksTUFBTSwrQkFBK0IsZ0JBQWdCLHVDQUF1QztBQUFBLEVBQ3hHO0FBRUEsU0FBTyxvQkFBb0IsRUFBRSxHQUFHLGNBQWMsR0FBRyxzQkFBc0IsQ0FBQztBQUMxRTtBQXdCQSxTQUFTLG9CQUFvQixhQUFvRjtBQUMvRyxRQUFNLFdBQVcsT0FBTyxLQUFLLFdBQVc7QUFDeEMsUUFBTSxtQkFBbUIsU0FBUyxLQUFLLENBQUMsWUFBWSxRQUFRLFNBQVMsR0FBRyxDQUFDO0FBQ3pFLE1BQUkscUJBQXFCLFFBQVc7QUFDbEMsVUFBTSxJQUFJLE1BQU0sK0JBQStCLGdCQUFnQixnRUFBZ0U7QUFBQSxFQUNqSTtBQUVBLFFBQU0sb0JBQW9CLEtBQUssU0FBUyxJQUFJLENBQUMsWUFBWSxHQUFHLE9BQU8sTUFBTSxFQUFFLEtBQUssR0FBRyxDQUFDO0FBQ3BGLFFBQU0sU0FBbUM7QUFBQSxJQUN2QyxDQUFDLGlCQUFpQixHQUFHLENBQUMsa0JBQWtCO0FBQUEsRUFDMUM7QUFFQSxhQUFXLENBQUMsU0FBUyxRQUFRLEtBQUssT0FBTyxRQUFRLFdBQVcsR0FBRztBQUM3RCxXQUFPLE9BQU8sSUFBSSxDQUFDLEdBQUcsVUFBVSxrQkFBa0I7QUFBQSxFQUNwRDtBQUVBLFNBQU87QUFDVDsiLAogICJuYW1lcyI6IFtdCn0K

package/dist/lib/esm/npm-publish.d.mts

@@ -0,0 +1,19 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for NPM publish.
+ */
+/**
+ * Publish to NPM.
+ *
+ * Authentication is intentionally not handled here. The publish is expected to run from a CI job
+ * configured as a {@link https://docs.npmjs.com/trusted-publishers | trusted publisher} on npmjs.com,
+ * where the npm CLI exchanges the job's short-lived OIDC token for a publish grant on its own. No NPM
+ * token is read, written, or stored, and the published package gets provenance for free.
+ *
+ * Requires npm `11.5.1` or later.
+ *
+ * @param isBeta - Whether to publish to the beta NPM registry.
+ */
+export declare function publish(isBeta?: boolean): Promise<void>;

package/dist/lib/esm/npm-publish.mjs

@@ -0,0 +1,56 @@
+/*
+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 { execFromRoot } from "./root.mjs";
+async function publish(isBeta) {
+  const tag = isBeta ? "beta" : "latest";
+  await execFromRoot(["npm", "publish", "--tag", tag]);
+}
+export {
+  publish
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25wbS1wdWJsaXNoLnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIEBmaWxlXG4gKlxuICogQ29udGFpbnMgdXRpbGl0eSBmdW5jdGlvbnMgZm9yIE5QTSBwdWJsaXNoLlxuICovXG5cbmltcG9ydCB7IGV4ZWNGcm9tUm9vdCB9IGZyb20gJy4vcm9vdC50cyc7XG5cbi8qKlxuICogUHVibGlzaCB0byBOUE0uXG4gKlxuICogQXV0aGVudGljYXRpb24gaXMgaW50ZW50aW9uYWxseSBub3QgaGFuZGxlZCBoZXJlLiBUaGUgcHVibGlzaCBpcyBleHBlY3RlZCB0byBydW4gZnJvbSBhIENJIGpvYlxuICogY29uZmlndXJlZCBhcyBhIHtAbGluayBodHRwczovL2RvY3MubnBtanMuY29tL3RydXN0ZWQtcHVibGlzaGVycyB8IHRydXN0ZWQgcHVibGlzaGVyfSBvbiBucG1qcy5jb20sXG4gKiB3aGVyZSB0aGUgbnBtIENMSSBleGNoYW5nZXMgdGhlIGpvYidzIHNob3J0LWxpdmVkIE9JREMgdG9rZW4gZm9yIGEgcHVibGlzaCBncmFudCBvbiBpdHMgb3duLiBObyBOUE1cbiAqIHRva2VuIGlzIHJlYWQsIHdyaXR0ZW4sIG9yIHN0b3JlZCwgYW5kIHRoZSBwdWJsaXNoZWQgcGFja2FnZSBnZXRzIHByb3ZlbmFuY2UgZm9yIGZyZWUuXG4gKlxuICogUmVxdWlyZXMgbnBtIGAxMS41LjFgIG9yIGxhdGVyLlxuICpcbiAqIEBwYXJhbSBpc0JldGEgLSBXaGV0aGVyIHRvIHB1Ymxpc2ggdG8gdGhlIGJldGEgTlBNIHJlZ2lzdHJ5LlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcHVibGlzaChpc0JldGE/OiBib29sZWFuKTogUHJvbWlzZTx2b2lkPiB7XG4gIGNvbnN0IHRhZyA9IGlzQmV0YSA/ICdiZXRhJyA6ICdsYXRlc3QnO1xuICBhd2FpdCBleGVjRnJvbVJvb3QoWyducG0nLCAncHVibGlzaCcsICctLXRhZycsIHRhZ10pO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFNQSxTQUFTLG9CQUFvQjtBQWM3QixlQUFzQixRQUFRLFFBQWlDO0FBQzdELFFBQU0sTUFBTSxTQUFTLFNBQVM7QUFDOUIsUUFBTSxhQUFhLENBQUMsT0FBTyxXQUFXLFNBQVMsR0FBRyxDQUFDO0FBQ3JEOyIsCiAgIm5hbWVzIjogW10KfQo=

package/dist/lib/esm/npm-run.d.mts

@@ -0,0 +1,34 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * NPM run utilities.
+ */
+/**
+ * The result of running an optional npm command.
+ */
+export declare enum NpmRunOptionalResult {
+    /**
+     * The command was skipped because it was not defined in the package.json scripts.
+     */
+    Skipped = "skipped",
+    /**
+     * The command was found and run successfully.
+     */
+    Success = "success"
+}
+/**
+ * Runs a command using npm checking if the command is overridden in the package.json.
+ *
+ * @param command - The command to run.
+ */
+export declare function npmRun(command: string): Promise<void>;
+/**
+ * Runs a command using npm only if the command is defined in the package.json scripts.
+ * If the command is not defined, it is silently skipped.
+ *
+ * @param command - The command to run.
+ * @returns A {@link Promise} that resolves to {@link NpmRunOptionalResult.Success} if the command was
+ * found and run, or {@link NpmRunOptionalResult.Skipped} otherwise.
+ */
+export declare function npmRunOptional(command: string): Promise<NpmRunOptionalResult>;

package/dist/lib/esm/npm-run.mjs

@@ -0,0 +1,81 @@
+/*
+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 { readPackageJson } from "./npm.mjs";
+import { getPackageManagerRunCommand } from "./package-manager.mjs";
+import { execFromRoot } from "./root.mjs";
+var NpmRunOptionalResult = /* @__PURE__ */ ((NpmRunOptionalResult2) => {
+  NpmRunOptionalResult2["Skipped"] = "skipped";
+  NpmRunOptionalResult2["Success"] = "success";
+  return NpmRunOptionalResult2;
+})(NpmRunOptionalResult || {});
+async function npmRun(command) {
+  const packageJson = await readPackageJson();
+  const isKnownCommand = Object.keys(packageJson.scripts ?? {}).includes(command);
+  if (isKnownCommand) {
+    await execFromRoot([...getPackageManagerRunCommand(), command]);
+  } else {
+    throw new Error(`Command ${command} is not defined in the package.json`);
+  }
+}
+async function npmRunOptional(command) {
+  const packageJson = await readPackageJson();
+  const isKnownCommand = Object.keys(packageJson.scripts ?? {}).includes(command);
+  if (isKnownCommand) {
+    await execFromRoot([...getPackageManagerRunCommand(), command]);
+    return "success" /* Success */;
+  }
+  getLibDebugger("npmRunOptional")(`Command ${command} is not defined in the package.json, skipping`);
+  return "skipped" /* Skipped */;
+}
+export {
+  NpmRunOptionalResult,
+  npmRun,
+  npmRunOptional
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL25wbS1ydW4udHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBOUE0gcnVuIHV0aWxpdGllcy5cbiAqL1xuXG5pbXBvcnQgeyBnZXRMaWJEZWJ1Z2dlciB9IGZyb20gJ0BtbmFvdW1vdi90eXBlc2NyaXB0LWxpYi9kZWJ1Zyc7XG5cbmltcG9ydCB7IHJlYWRQYWNrYWdlSnNvbiB9IGZyb20gJy4vbnBtLnRzJztcbmltcG9ydCB7IGdldFBhY2thZ2VNYW5hZ2VyUnVuQ29tbWFuZCB9IGZyb20gJy4vcGFja2FnZS1tYW5hZ2VyLnRzJztcbmltcG9ydCB7IGV4ZWNGcm9tUm9vdCB9IGZyb20gJy4vcm9vdC50cyc7XG5cbi8qKlxuICogVGhlIHJlc3VsdCBvZiBydW5uaW5nIGFuIG9wdGlvbmFsIG5wbSBjb21tYW5kLlxuICovXG5leHBvcnQgZW51bSBOcG1SdW5PcHRpb25hbFJlc3VsdCB7XG4gIC8qKlxuICAgKiBUaGUgY29tbWFuZCB3YXMgc2tpcHBlZCBiZWNhdXNlIGl0IHdhcyBub3QgZGVmaW5lZCBpbiB0aGUgcGFja2FnZS5qc29uIHNjcmlwdHMuXG4gICAqL1xuICBTa2lwcGVkID0gJ3NraXBwZWQnLFxuXG4gIC8qKlxuICAgKiBUaGUgY29tbWFuZCB3YXMgZm91bmQgYW5kIHJ1biBzdWNjZXNzZnVsbHkuXG4gICAqL1xuICBTdWNjZXNzID0gJ3N1Y2Nlc3MnXG59XG5cbi8qKlxuICogUnVucyBhIGNvbW1hbmQgdXNpbmcgbnBtIGNoZWNraW5nIGlmIHRoZSBjb21tYW5kIGlzIG92ZXJyaWRkZW4gaW4gdGhlIHBhY2thZ2UuanNvbi5cbiAqXG4gKiBAcGFyYW0gY29tbWFuZCAtIFRoZSBjb21tYW5kIHRvIHJ1bi5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIG5wbVJ1bihjb21tYW5kOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+IHtcbiAgY29uc3QgcGFja2FnZUpzb24gPSBhd2FpdCByZWFkUGFja2FnZUpzb24oKTtcbiAgY29uc3QgaXNLbm93bkNvbW1hbmQgPSBPYmplY3Qua2V5cyhwYWNrYWdlSnNvbi5zY3JpcHRzID8/IHt9KS5pbmNsdWRlcyhjb21tYW5kKTtcbiAgaWYgKGlzS25vd25Db21tYW5kKSB7XG4gICAgYXdhaXQgZXhlY0Zyb21Sb290KFsuLi5nZXRQYWNrYWdlTWFuYWdlclJ1bkNvbW1hbmQoKSwgY29tbWFuZF0pO1xuICB9IGVsc2Uge1xuICAgIHRocm93IG5ldyBFcnJvcihgQ29tbWFuZCAke2NvbW1hbmR9IGlzIG5vdCBkZWZpbmVkIGluIHRoZSBwYWNrYWdlLmpzb25gKTtcbiAgfVxufVxuXG4vKipcbiAqIFJ1bnMgYSBjb21tYW5kIHVzaW5nIG5wbSBvbmx5IGlmIHRoZSBjb21tYW5kIGlzIGRlZmluZWQgaW4gdGhlIHBhY2thZ2UuanNvbiBzY3JpcHRzLlxuICogSWYgdGhlIGNvbW1hbmQgaXMgbm90IGRlZmluZWQsIGl0IGlzIHNpbGVudGx5IHNraXBwZWQuXG4gKlxuICogQHBhcmFtIGNvbW1hbmQgLSBUaGUgY29tbWFuZCB0byBydW4uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHRvIHtAbGluayBOcG1SdW5PcHRpb25hbFJlc3VsdC5TdWNjZXNzfSBpZiB0aGUgY29tbWFuZCB3YXNcbiAqIGZvdW5kIGFuZCBydW4sIG9yIHtAbGluayBOcG1SdW5PcHRpb25hbFJlc3VsdC5Ta2lwcGVkfSBvdGhlcndpc2UuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBucG1SdW5PcHRpb25hbChjb21tYW5kOiBzdHJpbmcpOiBQcm9taXNlPE5wbVJ1bk9wdGlvbmFsUmVzdWx0PiB7XG4gIGNvbnN0IHBhY2thZ2VKc29uID0gYXdhaXQgcmVhZFBhY2thZ2VKc29uKCk7XG4gIGNvbnN0IGlzS25vd25Db21tYW5kID0gT2JqZWN0LmtleXMocGFja2FnZUpzb24uc2NyaXB0cyA/PyB7fSkuaW5jbHVkZXMoY29tbWFuZCk7XG4gIGlmIChpc0tub3duQ29tbWFuZCkge1xuICAgIGF3YWl0IGV4ZWNGcm9tUm9vdChbLi4uZ2V0UGFja2FnZU1hbmFnZXJSdW5Db21tYW5kKCksIGNvbW1hbmRdKTtcbiAgICByZXR1cm4gTnBtUnVuT3B0aW9uYWxSZXN1bHQuU3VjY2VzcztcbiAgfVxuICBnZXRMaWJEZWJ1Z2dlcignbnBtUnVuT3B0aW9uYWwnKShgQ29tbWFuZCAke2NvbW1hbmR9IGlzIG5vdCBkZWZpbmVkIGluIHRoZSBwYWNrYWdlLmpzb24sIHNraXBwaW5nYCk7XG4gIHJldHVybiBOcG1SdW5PcHRpb25hbFJlc3VsdC5Ta2lwcGVkO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFNQSxTQUFTLHNCQUFzQjtBQUUvQixTQUFTLHVCQUF1QjtBQUNoQyxTQUFTLG1DQUFtQztBQUM1QyxTQUFTLG9CQUFvQjtBQUt0QixJQUFLLHVCQUFMLGtCQUFLQSwwQkFBTDtBQUlMLEVBQUFBLHNCQUFBLGFBQVU7QUFLVixFQUFBQSxzQkFBQSxhQUFVO0FBVEEsU0FBQUE7QUFBQSxHQUFBO0FBaUJaLGVBQXNCLE9BQU8sU0FBZ0M7QUFDM0QsUUFBTSxjQUFjLE1BQU0sZ0JBQWdCO0FBQzFDLFFBQU0saUJBQWlCLE9BQU8sS0FBSyxZQUFZLFdBQVcsQ0FBQyxDQUFDLEVBQUUsU0FBUyxPQUFPO0FBQzlFLE1BQUksZ0JBQWdCO0FBQ2xCLFVBQU0sYUFBYSxDQUFDLEdBQUcsNEJBQTRCLEdBQUcsT0FBTyxDQUFDO0FBQUEsRUFDaEUsT0FBTztBQUNMLFVBQU0sSUFBSSxNQUFNLFdBQVcsT0FBTyxxQ0FBcUM7QUFBQSxFQUN6RTtBQUNGO0FBVUEsZUFBc0IsZUFBZSxTQUFnRDtBQUNuRixRQUFNLGNBQWMsTUFBTSxnQkFBZ0I7QUFDMUMsUUFBTSxpQkFBaUIsT0FBTyxLQUFLLFlBQVksV0FBVyxDQUFDLENBQUMsRUFBRSxTQUFTLE9BQU87QUFDOUUsTUFBSSxnQkFBZ0I7QUFDbEIsVUFBTSxhQUFhLENBQUMsR0FBRyw0QkFBNEIsR0FBRyxPQUFPLENBQUM7QUFDOUQsV0FBTztBQUFBLEVBQ1Q7QUFDQSxpQkFBZSxnQkFBZ0IsRUFBRSxXQUFXLE9BQU8sK0NBQStDO0FBQ2xHLFNBQU87QUFDVDsiLAogICJuYW1lcyI6IFsiTnBtUnVuT3B0aW9uYWxSZXN1bHQiXQp9Cg==

package/dist/lib/esm/npm.d.mts

@@ -0,0 +1,168 @@
+/// <reference path="./index.d.mts" />
+/**
+ * @file
+ *
+ * Contains utility functions for NPM package.json.
+ */
+import type { PackageJson, Promisable } from 'type-fest';
+/**
+ * Options for {@link editNpmShrinkWrapJson}.
+ */
+export type EditNpmShrinkWrapJsonOptions = EditPackageJsonOptions;
+/**
+ * Options for {@link editPackageJson}.
+ */
+export interface EditPackageJsonOptions {
+    /**
+     * A current working folder where `package.json` is located.
+     */
+    readonly cwd?: string;
+    /**
+     * If `true`, skips editing if the file does not exist.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipIfMissing?: boolean;
+}
+/**
+ * Options for {@link editPackageJsonSync}.
+ */
+export type EditPackageJsonSyncOptions = EditPackageJsonOptions;
+/**
+ * Options for {@link editPackageLockJson}.
+ */
+export type EditPackageLockJsonOptions = EditPackageJsonOptions;
+/**
+ * Options for {@link editPackageLockJsonSync}.
+ */
+export type EditPackageLockJsonSyncOptions = EditPackageJsonOptions;
+/**
+ * A type of the `package.json` file.
+ */
+/**
+ * A type of the `package-lock.json` file.
+ */
+export interface PackageLockJson extends Partial<PackageJson> {
+    /**
+     * Packages in the `package-lock.json` file.
+     */
+    packages?: Record<string, PackageJson>;
+}
+/**
+ * Reads, edits, and writes back the `package-lock.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editNpmShrinkWrapJson(editFunction: (packageLockJson: PackageLockJson) => Promisable<void>, options?: EditNpmShrinkWrapJsonOptions): Promise<void>;
+/**
+ * Reads, edits, and writes back the `package.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editPackageJson(editFunction: (packageJson: PackageJson) => Promisable<void>, options?: EditPackageJsonOptions): Promise<void>;
+/**
+ * Reads, edits, and writes back the `package.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ */
+export declare function editPackageJsonSync(editFunction: (packageJson: PackageJson) => void, options?: EditPackageJsonSyncOptions): void;
+/**
+ * Reads, edits, and writes back the `package-lock.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageJson` object.
+ * @param options - Additional options for editing.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editPackageLockJson(editFunction: (packageLockJson: PackageLockJson) => Promisable<void>, options?: EditPackageLockJsonOptions): Promise<void>;
+/**
+ * Reads, edits, and writes back the `package-lock.json` file using the provided edit function.
+ *
+ * @param editFunction - The function to edit the parsed `PackageLockJson` object.
+ * @param options - Additional options for editing.
+ */
+export declare function editPackageLockJsonSync(editFunction: (packageLockJson: PackageLockJson) => void, options?: EditPackageLockJsonSyncOptions): void;
+/**
+ * Resolves the path to the `npm-shrinkwrap.json` file in the specified folder or in the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `npm-shrinkwrap.json` is located.
+ * @returns The resolved path to the `npm-shrinkwrap.json` file.
+ */
+export declare function getNpmShrinkWrapJsonPath(cwd?: string): string;
+/**
+ * Resolves the path to the `package.json` file in the specified folder or in the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns The resolved path to the `package.json` file.
+ */
+export declare function getPackageJsonPath(cwd?: string): string;
+/**
+ * Resolves the path to the `package-lock.json` file in the specified folder or in the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns The resolved path to the `package-lock.json` file.
+ */
+export declare function getPackageLockJsonPath(cwd?: string): string;
+/**
+ * Reads the `package.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns A {@link Promise} that resolves with the parsed `PackageJson` object.
+ */
+export declare function readPackageJson(cwd?: string): Promise<PackageJson>;
+/**
+ * Reads the `package.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns The parsed `PackageJson` object.
+ */
+export declare function readPackageJsonSync(cwd?: string): PackageJson;
+/**
+ * Reads the `package-lock.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns A {@link Promise} that resolves with the parsed `PackageJson` object.
+ */
+export declare function readPackageLockJson(cwd?: string): Promise<PackageLockJson>;
+/**
+ * Reads the `package-lock.json` file from the specified folder or from the root if no folder is specified.
+ *
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns The parsed `PackageLockJson` object.
+ */
+export declare function readPackageLockJsonSync(cwd?: string): PackageLockJson;
+/**
+ * Writes the provided `PackageJson` object to the `package.json` file in the specified folder or in the root.
+ *
+ * @param packageJson - The `PackageJson` object to write.
+ * @param cwd - The current working folder where `package.json` is located.
+ * @returns A {@link Promise} that resolves when the file has been written.
+ */
+export declare function writePackageJson(packageJson: PackageJson, cwd?: string): Promise<void>;
+/**
+ * Writes the provided `PackageJson` object to the `package.json` file in the specified folder or in the root.
+ *
+ * @param packageJson - The `PackageJson` object to write.
+ * @param cwd - The current working folder where `package.json` is located.
+ */
+export declare function writePackageJsonSync(packageJson: PackageJson, cwd?: string): void;
+/**
+ * Writes the provided `PackageJson` object to the `package-lock.json` file in the specified folder or in the root.
+ *
+ * @param packageLockJson - The `PackageLockJson` object to write.
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ * @returns A {@link Promise} that resolves when the file has been written.
+ */
+export declare function writePackageLockJson(packageLockJson: PackageLockJson, cwd?: string): Promise<void>;
+/**
+ * Writes the provided `PackageLockJson` object to the `package-lock.json` file in the specified folder or in the root.
+ *
+ * @param packageLockJson - The `PackageLockJson` object to write.
+ * @param cwd - The current working folder where `package-lock.json` is located.
+ */
+export declare function writePackageLockJsonSync(packageLockJson: PackageLockJson, cwd?: string): void;
+export type { PackageJson };