@mnaoumov/typescript-dev-toolkit 0.0.0 → 1.0.0

package/dist/lib/cjs/index.cjs

@@ -0,0 +1,186 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  build: () => build,
+  bundlers: () => bundlers,
+  "check-project-types": () => check_project_types,
+  "cli-utils": () => cli_utils,
+  "code-generator": () => code_generator,
+  "commitlint-config": () => commitlint_config,
+  "commitlint-forbidden-patterns": () => commitlint_forbidden_patterns,
+  "commitlint-spellcheck-header": () => commitlint_spellcheck_header,
+  "env-toggle": () => env_toggle,
+  exec: () => exec,
+  "forbidden-patterns": () => forbidden_patterns,
+  formatters: () => formatters,
+  fs: () => fs,
+  gate: () => gate,
+  git: () => git,
+  json: () => json,
+  "library-build": () => library_build,
+  linters: () => linters,
+  "nano-staged-config": () => nano_staged_config,
+  npm: () => npm,
+  "npm-publish": () => npm_publish,
+  "npm-run": () => npm_run,
+  "package-lock-integrity": () => package_lock_integrity,
+  "package-manager": () => package_manager,
+  "released-issues": () => released_issues,
+  "repo-paths": () => repo_paths,
+  root: () => root,
+  "test-runners": () => test_runners,
+  "validate-declarations": () => validate_declarations,
+  version: () => version
+});
+module.exports = __toCommonJS(index_exports);
+var build = __toESM(__extractDefault(require('./build.cjs')), 1);
+var bundlers = __toESM(__extractDefault(require('./bundlers/index.cjs')), 1);
+var check_project_types = __toESM(__extractDefault(require('./check-project-types.cjs')), 1);
+var cli_utils = __toESM(__extractDefault(require('./cli-utils.cjs')), 1);
+var code_generator = __toESM(__extractDefault(require('./code-generator.cjs')), 1);
+var commitlint_config = __toESM(__extractDefault(require('./commitlint-config.cjs')), 1);
+var commitlint_forbidden_patterns = __toESM(__extractDefault(require('./commitlint-forbidden-patterns.cjs')), 1);
+var commitlint_spellcheck_header = __toESM(__extractDefault(require('./commitlint-spellcheck-header.cjs')), 1);
+var env_toggle = __toESM(__extractDefault(require('./env-toggle.cjs')), 1);
+var exec = __toESM(__extractDefault(require('./exec.cjs')), 1);
+var forbidden_patterns = __toESM(__extractDefault(require('./forbidden-patterns.cjs')), 1);
+var formatters = __toESM(__extractDefault(require('./formatters/index.cjs')), 1);
+var fs = __toESM(__extractDefault(require('./fs.cjs')), 1);
+var gate = __toESM(__extractDefault(require('./gate.cjs')), 1);
+var git = __toESM(__extractDefault(require('./git.cjs')), 1);
+var json = __toESM(__extractDefault(require('./json.cjs')), 1);
+var library_build = __toESM(__extractDefault(require('./library-build.cjs')), 1);
+var linters = __toESM(__extractDefault(require('./linters/index.cjs')), 1);
+var nano_staged_config = __toESM(__extractDefault(require('./nano-staged-config.cjs')), 1);
+var npm_publish = __toESM(__extractDefault(require('./npm-publish.cjs')), 1);
+var npm_run = __toESM(__extractDefault(require('./npm-run.cjs')), 1);
+var npm = __toESM(__extractDefault(require('./npm.cjs')), 1);
+var package_lock_integrity = __toESM(__extractDefault(require('./package-lock-integrity.cjs')), 1);
+var package_manager = __toESM(__extractDefault(require('./package-manager.cjs')), 1);
+var released_issues = __toESM(__extractDefault(require('./released-issues.cjs')), 1);
+var repo_paths = __toESM(__extractDefault(require('./repo-paths.cjs')), 1);
+var root = __toESM(__extractDefault(require('./root.cjs')), 1);
+var test_runners = __toESM(__extractDefault(require('./test-runners/index.cjs')), 1);
+var validate_declarations = __toESM(__extractDefault(require('./validate-declarations.cjs')), 1);
+var version = __toESM(__extractDefault(require('./version.cjs')), 1);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  build,
+  bundlers,
+  "check-project-types": null,
+  "cli-utils": null,
+  "code-generator": null,
+  "commitlint-config": null,
+  "commitlint-forbidden-patterns": null,
+  "commitlint-spellcheck-header": null,
+  "env-toggle": null,
+  exec,
+  "forbidden-patterns": null,
+  formatters,
+  fs,
+  gate,
+  git,
+  json,
+  "library-build": null,
+  linters,
+  "nano-staged-config": null,
+  npm,
+  "npm-publish": null,
+  "npm-run": null,
+  "package-lock-integrity": null,
+  "package-manager": null,
+  "released-issues": null,
+  "repo-paths": null,
+  root,
+  "test-runners": null,
+  "validate-declarations": null,
+  version
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKiBUSElTIElTIEEgR0VORVJBVEVEL0JVTkRMRUQgRklMRSBCWSBCVUlMRCBTQ1JJUFQgKi9cblxuZXhwb3J0ICogYXMgJ2J1aWxkJyBmcm9tICcuL2J1aWxkLnRzJztcbmV4cG9ydCAqIGFzICdidW5kbGVycycgZnJvbSAnLi9idW5kbGVycy9pbmRleC50cyc7XG5leHBvcnQgKiBhcyAnY2hlY2stcHJvamVjdC10eXBlcycgZnJvbSAnLi9jaGVjay1wcm9qZWN0LXR5cGVzLnRzJztcbmV4cG9ydCAqIGFzICdjbGktdXRpbHMnIGZyb20gJy4vY2xpLXV0aWxzLnRzJztcbmV4cG9ydCAqIGFzICdjb2RlLWdlbmVyYXRvcicgZnJvbSAnLi9jb2RlLWdlbmVyYXRvci50cyc7XG5leHBvcnQgKiBhcyAnY29tbWl0bGludC1jb25maWcnIGZyb20gJy4vY29tbWl0bGludC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ2NvbW1pdGxpbnQtZm9yYmlkZGVuLXBhdHRlcm5zJyBmcm9tICcuL2NvbW1pdGxpbnQtZm9yYmlkZGVuLXBhdHRlcm5zLnRzJztcbmV4cG9ydCAqIGFzICdjb21taXRsaW50LXNwZWxsY2hlY2staGVhZGVyJyBmcm9tICcuL2NvbW1pdGxpbnQtc3BlbGxjaGVjay1oZWFkZXIudHMnO1xuZXhwb3J0ICogYXMgJ2Vudi10b2dnbGUnIGZyb20gJy4vZW52LXRvZ2dsZS50cyc7XG5leHBvcnQgKiBhcyAnZXhlYycgZnJvbSAnLi9leGVjLnRzJztcbmV4cG9ydCAqIGFzICdmb3JiaWRkZW4tcGF0dGVybnMnIGZyb20gJy4vZm9yYmlkZGVuLXBhdHRlcm5zLnRzJztcbmV4cG9ydCAqIGFzICdmb3JtYXR0ZXJzJyBmcm9tICcuL2Zvcm1hdHRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ2ZzJyBmcm9tICcuL2ZzLnRzJztcbmV4cG9ydCAqIGFzICdnYXRlJyBmcm9tICcuL2dhdGUudHMnO1xuZXhwb3J0ICogYXMgJ2dpdCcgZnJvbSAnLi9naXQudHMnO1xuZXhwb3J0ICogYXMgJ2pzb24nIGZyb20gJy4vanNvbi50cyc7XG5leHBvcnQgKiBhcyAnbGlicmFyeS1idWlsZCcgZnJvbSAnLi9saWJyYXJ5LWJ1aWxkLnRzJztcbmV4cG9ydCAqIGFzICdsaW50ZXJzJyBmcm9tICcuL2xpbnRlcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ25hbm8tc3RhZ2VkLWNvbmZpZycgZnJvbSAnLi9uYW5vLXN0YWdlZC1jb25maWcudHMnO1xuZXhwb3J0ICogYXMgJ25wbS1wdWJsaXNoJyBmcm9tICcuL25wbS1wdWJsaXNoLnRzJztcbmV4cG9ydCAqIGFzICducG0tcnVuJyBmcm9tICcuL25wbS1ydW4udHMnO1xuZXhwb3J0ICogYXMgJ25wbScgZnJvbSAnLi9ucG0udHMnO1xuZXhwb3J0ICogYXMgJ3BhY2thZ2UtbG9jay1pbnRlZ3JpdHknIGZyb20gJy4vcGFja2FnZS1sb2NrLWludGVncml0eS50cyc7XG5leHBvcnQgKiBhcyAncGFja2FnZS1tYW5hZ2VyJyBmcm9tICcuL3BhY2thZ2UtbWFuYWdlci50cyc7XG5leHBvcnQgKiBhcyAncmVsZWFzZWQtaXNzdWVzJyBmcm9tICcuL3JlbGVhc2VkLWlzc3Vlcy50cyc7XG5leHBvcnQgKiBhcyAncmVwby1wYXRocycgZnJvbSAnLi9yZXBvLXBhdGhzLnRzJztcbmV4cG9ydCAqIGFzICdyb290JyBmcm9tICcuL3Jvb3QudHMnO1xuZXhwb3J0ICogYXMgJ3Rlc3QtcnVubmVycycgZnJvbSAnLi90ZXN0LXJ1bm5lcnMvaW5kZXgudHMnO1xuZXhwb3J0ICogYXMgJ3ZhbGlkYXRlLWRlY2xhcmF0aW9ucycgZnJvbSAnLi92YWxpZGF0ZS1kZWNsYXJhdGlvbnMudHMnO1xuZXhwb3J0ICogYXMgJ3ZlcnNpb24nIGZyb20gJy4vdmVyc2lvbi50cyc7XG4iXSwKICAibWFwcGluZ3MiOiAiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQSwrQkFBQUE7QUFBQSxFQUFBLG1CQUFBQztBQUFBLEVBQUEsd0JBQUFDO0FBQUEsRUFBQSwyQkFBQUM7QUFBQSxFQUFBLHVDQUFBQztBQUFBLEVBQUEsc0NBQUFDO0FBQUEsRUFBQSxvQkFBQUM7QUFBQSxFQUFBO0FBQUEsOEJBQUFDO0FBQUEsRUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUEseUJBQUFDO0FBQUEsRUFBQTtBQUFBLDhCQUFBQztBQUFBLEVBQUE7QUFBQSx1QkFBQUM7QUFBQSxFQUFBLGlCQUFBQztBQUFBLEVBQUEsZ0NBQUFDO0FBQUEsRUFBQSx5QkFBQUM7QUFBQSxFQUFBLHlCQUFBQztBQUFBLEVBQUEsb0JBQUFDO0FBQUEsRUFBQTtBQUFBLHdCQUFBQztBQUFBLEVBQUEsK0JBQUFDO0FBQUEsRUFBQTtBQUFBO0FBQUE7QUFFQSxZQUF5QjtBQUN6QixlQUE0QjtBQUM1QixJQUFBakIsc0JBQXVDO0FBQ3ZDLElBQUFDLFlBQTZCO0FBQzdCLElBQUFDLGlCQUFrQztBQUNsQyxJQUFBQyxvQkFBcUM7QUFDckMsSUFBQUMsZ0NBQWlEO0FBQ2pELElBQUFDLCtCQUFnRDtBQUNoRCxJQUFBQyxhQUE4QjtBQUM5QixXQUF3QjtBQUN4QixJQUFBQyxxQkFBc0M7QUFDdEMsaUJBQThCO0FBQzlCLFNBQXNCO0FBQ3RCLFdBQXdCO0FBQ3hCLFVBQXVCO0FBQ3ZCLFdBQXdCO0FBQ3hCLElBQUFDLGdCQUFpQztBQUNqQyxjQUEyQjtBQUMzQixJQUFBQyxxQkFBc0M7QUFDdEMsSUFBQUMsY0FBK0I7QUFDL0IsSUFBQUMsVUFBMkI7QUFDM0IsVUFBdUI7QUFDdkIsSUFBQUMseUJBQTBDO0FBQzFDLElBQUFDLGtCQUFtQztBQUNuQyxJQUFBQyxrQkFBbUM7QUFDbkMsSUFBQUMsYUFBOEI7QUFDOUIsV0FBd0I7QUFDeEIsSUFBQUMsZUFBZ0M7QUFDaEMsSUFBQUMsd0JBQXlDO0FBQ3pDLGNBQTJCOyIsCiAgIm5hbWVzIjogWyJjaGVjay1wcm9qZWN0LXR5cGVzIiwgImNsaS11dGlscyIsICJjb2RlLWdlbmVyYXRvciIsICJjb21taXRsaW50LWNvbmZpZyIsICJjb21taXRsaW50LWZvcmJpZGRlbi1wYXR0ZXJucyIsICJjb21taXRsaW50LXNwZWxsY2hlY2staGVhZGVyIiwgImVudi10b2dnbGUiLCAiZm9yYmlkZGVuLXBhdHRlcm5zIiwgImxpYnJhcnktYnVpbGQiLCAibmFuby1zdGFnZWQtY29uZmlnIiwgIm5wbS1wdWJsaXNoIiwgIm5wbS1ydW4iLCAicGFja2FnZS1sb2NrLWludGVncml0eSIsICJwYWNrYWdlLW1hbmFnZXIiLCAicmVsZWFzZWQtaXNzdWVzIiwgInJlcG8tcGF0aHMiLCAidGVzdC1ydW5uZXJzIiwgInZhbGlkYXRlLWRlY2xhcmF0aW9ucyJdCn0K

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

@@ -0,0 +1,35 @@
+/// <reference lib="dom" />
+/// <reference lib="dom.iterable" />
+/// <reference lib="es2022" />
+/// <reference lib="esnext.disposable" />
+/// <reference types="node" />
+export * as 'build' from './build.cjs';
+export * as 'bundlers' from './bundlers/index.cjs';
+export * as 'check-project-types' from './check-project-types.cjs';
+export * as 'cli-utils' from './cli-utils.cjs';
+export * as 'code-generator' from './code-generator.cjs';
+export * as 'commitlint-config' from './commitlint-config.cjs';
+export * as 'commitlint-forbidden-patterns' from './commitlint-forbidden-patterns.cjs';
+export * as 'commitlint-spellcheck-header' from './commitlint-spellcheck-header.cjs';
+export * as 'env-toggle' from './env-toggle.cjs';
+export * as 'exec' from './exec.cjs';
+export * as 'forbidden-patterns' from './forbidden-patterns.cjs';
+export * as 'formatters' from './formatters/index.cjs';
+export * as 'fs' from './fs.cjs';
+export * as 'gate' from './gate.cjs';
+export * as 'git' from './git.cjs';
+export * as 'json' from './json.cjs';
+export * as 'library-build' from './library-build.cjs';
+export * as 'linters' from './linters/index.cjs';
+export * as 'nano-staged-config' from './nano-staged-config.cjs';
+export * as 'npm-publish' from './npm-publish.cjs';
+export * as 'npm-run' from './npm-run.cjs';
+export * as 'npm' from './npm.cjs';
+export * as 'package-lock-integrity' from './package-lock-integrity.cjs';
+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 '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/json.cjs

@@ -0,0 +1,141 @@
+/*
+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 keepName($unknown) {
+  return $unknown;
+}
+
+(function initCjs() {
+  const globalThisRecord = globalThis;
+  ensureDisposeSymbols();
+  globalThisRecord['__name'] ??= keepName;
+  globalThisRecord['__extractDefault'] ??= extractDefault;
+
+  ensureBrowserProcess();
+
+  // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized with initCjs into the banner; at module scope it would be left out of it.
+  function extractDefault(module) {
+    return module && module.__esModule && 'default' in module ? module.default : module;
+  }
+})();
+})();
+
+"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 json_exports = {};
+__export(json_exports, {
+  editJson: () => editJson,
+  editJsonSync: () => editJsonSync,
+  readJson: () => readJson,
+  readJsonSync: () => readJsonSync,
+  writeJson: () => writeJson,
+  writeJsonSync: () => writeJsonSync
+});
+module.exports = __toCommonJS(json_exports);
+var import_object_utils = require('@mnaoumov/typescript-lib/object-utils');
+var import_node_fs = require('node:fs');
+var import_promises = require('node:fs/promises');
+async function editJson(params) {
+  const {
+    editFunction,
+    path,
+    shouldSkipIfMissing
+  } = params;
+  if (shouldSkipIfMissing && !(0, import_node_fs.existsSync)(path)) {
+    return;
+  }
+  const data = await readJson(path);
+  await editFunction(data);
+  await writeJson(path, data);
+}
+function editJsonSync(params) {
+  const {
+    editFunction,
+    path,
+    shouldSkipIfMissing
+  } = params;
+  if (shouldSkipIfMissing && !(0, import_node_fs.existsSync)(path)) {
+    return;
+  }
+  const data = readJsonSync(path);
+  editFunction(data);
+  writeJsonSync(path, data);
+}
+async function readJson(path) {
+  return JSON.parse(await (0, import_promises.readFile)(path, "utf-8"));
+}
+function readJsonSync(path) {
+  return JSON.parse((0, import_node_fs.readFileSync)(path, "utf-8"));
+}
+async function writeJson(path, data) {
+  await (0, import_promises.writeFile)(path, `${(0, import_object_utils.toJson)(data)}
+`);
+}
+function writeJsonSync(path, data) {
+  (0, import_node_fs.writeFileSync)(path, `${(0, import_object_utils.toJson)(data)}
+`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  editJson,
+  editJsonSync,
+  readJson,
+  readJsonSync,
+  writeJson,
+  writeJsonSync
+});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vLi4vc3JjL2pzb24udHMiXSwKICAic291cmNlc0NvbnRlbnQiOiBbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBDb250YWlucyB1dGlsaXR5IGZ1bmN0aW9ucyBmb3IgSlNPTi5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IFByb21pc2FibGUgfSBmcm9tICd0eXBlLWZlc3QnO1xuXG5pbXBvcnQgeyB0b0pzb24gfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvb2JqZWN0LXV0aWxzJztcbmltcG9ydCB7XG4gIGV4aXN0c1N5bmMsXG4gIHJlYWRGaWxlU3luYyxcbiAgd3JpdGVGaWxlU3luY1xufSBmcm9tICdub2RlOmZzJztcbmltcG9ydCB7XG4gIHJlYWRGaWxlLFxuICB3cml0ZUZpbGVcbn0gZnJvbSAnbm9kZTpmcy9wcm9taXNlcyc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3Ige0BsaW5rIGVkaXRKc29ufS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBFZGl0SnNvbk9wdGlvbnMge1xuICAvKipcbiAgICogSWYgYHRydWVgLCBza2lwcyBlZGl0aW5nIGlmIHRoZSBmaWxlIGRvZXMgbm90IGV4aXN0LlxuICAgKlxuICAgKiBAZGVmYXVsdCBgZmFsc2VgXG4gICAqL1xuICByZWFkb25seSBzaG91bGRTa2lwSWZNaXNzaW5nPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZWRpdEpzb259LlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIG9mIHRoZSBkYXRhIHRvIGJlIGVkaXRlZC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBFZGl0SnNvblBhcmFtczxUPiBleHRlbmRzIEVkaXRKc29uT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBUaGUgZnVuY3Rpb24gdG8gZWRpdCB0aGUgcGFyc2VkIEpTT04gZGF0YS5cbiAgICpcbiAgICogQHBhcmFtIGRhdGEgLSBUaGUgcGFyc2VkIEpTT04gZGF0YSB0byBlZGl0LlxuICAgKi9cbiAgcmVhZG9ubHkgZWRpdEZ1bmN0aW9uOiAoZGF0YTogVCkgPT4gUHJvbWlzYWJsZTx2b2lkPjtcblxuICAvKipcbiAgICogVGhlIHBhdGggdG8gdGhlIEpTT04gZmlsZS5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGg6IHN0cmluZztcbn1cblxuLyoqXG4gKiBPcHRpb25zIGZvciB7QGxpbmsgZWRpdEpzb25TeW5jfS5cbiAqL1xuZXhwb3J0IHR5cGUgRWRpdEpzb25TeW5jT3B0aW9ucyA9IEVkaXRKc29uT3B0aW9ucztcblxuLyoqXG4gKiBQYXJhbWV0ZXJzIGZvciB7QGxpbmsgZWRpdEpzb25TeW5jfS5cbiAqXG4gKiBAdHlwZVBhcmFtIFQgLSBUaGUgdHlwZSBvZiB0aGUgZGF0YSB0byBiZSBlZGl0ZWQuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRWRpdEpzb25TeW5jUGFyYW1zPFQ+IGV4dGVuZHMgRWRpdEpzb25TeW5jT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBUaGUgZnVuY3Rpb24gdG8gZWRpdCB0aGUgcGFyc2VkIEpTT04gZGF0YS5cbiAgICpcbiAgICogQHBhcmFtIGRhdGEgLSBUaGUgcGFyc2VkIEpTT04gZGF0YSB0byBlZGl0LlxuICAgKi9cbiAgcmVhZG9ubHkgZWRpdEZ1bmN0aW9uOiAoZGF0YTogVCkgPT4gdm9pZDtcblxuICAvKipcbiAgICogVGhlIHBhdGggdG8gdGhlIEpTT04gZmlsZS5cbiAgICovXG4gIHJlYWRvbmx5IHBhdGg6IHN0cmluZztcbn1cblxuLyoqXG4gKiBSZWFkcywgZWRpdHMsIGFuZCB3cml0ZXMgYmFjayBhIEpTT04gZmlsZSB1c2luZyBhIHByb3ZpZGVkIGVkaXQgZnVuY3Rpb24uXG4gKlxuICogQHR5cGVQYXJhbSBUIC0gVGhlIHR5cGUgb2YgdGhlIGRhdGEgdG8gYmUgZWRpdGVkLlxuICogQHBhcmFtIHBhcmFtcyAtIFRoZSBwYXJhbWV0ZXJzIGZvciB0aGUgZnVuY3Rpb24uXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdoZW4gdGhlIGZpbGUgaGFzIGJlZW4gZWRpdGVkIGFuZCB3cml0dGVuLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gZWRpdEpzb248VD4ocGFyYW1zOiBFZGl0SnNvblBhcmFtczxUPik6IFByb21pc2U8dm9pZD4ge1xuICBjb25zdCB7XG4gICAgZWRpdEZ1bmN0aW9uLFxuICAgIHBhdGgsXG4gICAgc2hvdWxkU2tpcElmTWlzc2luZ1xuICB9ID0gcGFyYW1zO1xuICBpZiAoc2hvdWxkU2tpcElmTWlzc2luZyAmJiAhZXhpc3RzU3luYyhwYXRoKSkge1xuICAgIHJldHVybjtcbiAgfVxuICBjb25zdCBkYXRhID0gYXdhaXQgcmVhZEpzb248VD4ocGF0aCk7XG4gIGF3YWl0IGVkaXRGdW5jdGlvbihkYXRhKTtcbiAgYXdhaXQgd3JpdGVKc29uKHBhdGgsIGRhdGEpO1xufVxuXG4vKipcbiAqIFJlYWRzLCBlZGl0cywgYW5kIHdyaXRlcyBiYWNrIGEgSlNPTiBmaWxlIHVzaW5nIGEgcHJvdmlkZWQgZWRpdCBmdW5jdGlvbi5cbiAqXG4gKiBAdHlwZVBhcmFtIFQgLSBUaGUgdHlwZSBvZiB0aGUgZGF0YSB0byBiZSBlZGl0ZWQuXG4gKiBAcGFyYW0gcGFyYW1zIC0gVGhlIHBhcmFtZXRlcnMgZm9yIHRoZSBmdW5jdGlvbi5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVkaXRKc29uU3luYzxUPihwYXJhbXM6IEVkaXRKc29uU3luY1BhcmFtczxUPik6IHZvaWQge1xuICBjb25zdCB7XG4gICAgZWRpdEZ1bmN0aW9uLFxuICAgIHBhdGgsXG4gICAgc2hvdWxkU2tpcElmTWlzc2luZ1xuICB9ID0gcGFyYW1zO1xuICBpZiAoc2hvdWxkU2tpcElmTWlzc2luZyAmJiAhZXhpc3RzU3luYyhwYXRoKSkge1xuICAgIHJldHVybjtcbiAgfVxuICBjb25zdCBkYXRhID0gcmVhZEpzb25TeW5jPFQ+KHBhdGgpO1xuICBlZGl0RnVuY3Rpb24oZGF0YSk7XG4gIHdyaXRlSnNvblN5bmMocGF0aCwgZGF0YSk7XG59XG5cbi8qKlxuICogUmVhZHMgYSBKU09OIGZpbGUgYW5kIHBhcnNlcyBpdHMgY29udGVudHMgaW50byBhIEphdmFTY3JpcHQgb2JqZWN0IG9mIHR5cGUgYFRgLlxuICpcbiAqIEB0eXBlUGFyYW0gVCAtIFRoZSB0eXBlIHRvIHdoaWNoIHRoZSBKU09OIGNvbnRlbnQgd2lsbCBiZSBwYXJzZWQuXG4gKiBAcGFyYW0gcGF0aCAtIFRoZSBwYXRoIHRvIHRoZSBKU09OIGZpbGUuXG4gKiBAcmV0dXJucyBBIHtAbGluayBQcm9taXNlfSB0aGF0IHJlc29sdmVzIHdpdGggdGhlIHBhcnNlZCBKU09OIG9iamVjdCBvZiB0eXBlIGBUYC5cbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHJlYWRKc29uPFQ+KHBhdGg6IHN0cmluZyk6IFByb21pc2U8VD4ge1xuICByZXR1cm4gSlNPTi5wYXJzZShhd2FpdCByZWFkRmlsZShwYXRoLCAndXRmLTgnKSkgYXMgVDtcbn1cblxuLyoqXG4gKiBSZWFkcyBhIEpTT04gZmlsZSBhbmQgcGFyc2VzIGl0cyBjb250ZW50cyBpbnRvIGEgSmF2YVNjcmlwdCBvYmplY3Qgb2YgdHlwZSBgVGAuXG4gKlxuICogQHR5cGVQYXJhbSBUIC0gVGhlIHR5cGUgdG8gd2hpY2ggdGhlIEpTT04gY29udGVudCB3aWxsIGJlIHBhcnNlZC5cbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gdGhlIEpTT04gZmlsZS5cbiAqIEByZXR1cm5zIFRoZSBwYXJzZWQgSlNPTiBvYmplY3Qgb2YgdHlwZSBgVGAuXG4gKi9cbi8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBAdHlwZXNjcmlwdC1lc2xpbnQvbm8tdW5uZWNlc3NhcnktdHlwZS1wYXJhbWV0ZXJzIC0tIFdlIG5lZWQgdG8gdXNlIHRoZSBkdW1teSBwYXJhbWV0ZXIgdG8gZ2V0IHR5cGUgaW5mZXJlbmNlLlxuZXhwb3J0IGZ1bmN0aW9uIHJlYWRKc29uU3luYzxUPihwYXRoOiBzdHJpbmcpOiBUIHtcbiAgcmV0dXJuIEpTT04ucGFyc2UocmVhZEZpbGVTeW5jKHBhdGgsICd1dGYtOCcpKSBhcyBUO1xufVxuXG4vKipcbiAqIFdyaXRlcyBhIEphdmFTY3JpcHQgb2JqZWN0IHRvIGEgSlNPTiBmaWxlLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gdGhlIEpTT04gZmlsZS5cbiAqIEBwYXJhbSBkYXRhIC0gVGhlIGRhdGEgdG8gd3JpdGUgdG8gdGhlIEpTT04gZmlsZS5cbiAqIEByZXR1cm5zIEEge0BsaW5rIFByb21pc2V9IHRoYXQgcmVzb2x2ZXMgd2hlbiB0aGUgZmlsZSBoYXMgYmVlbiB3cml0dGVuLlxuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gd3JpdGVKc29uKHBhdGg6IHN0cmluZywgZGF0YTogdW5rbm93bik6IFByb21pc2U8dm9pZD4ge1xuICBhd2FpdCB3cml0ZUZpbGUocGF0aCwgYCR7dG9Kc29uKGRhdGEpfVxcbmApO1xufVxuXG4vKipcbiAqIFdyaXRlcyBhIEphdmFTY3JpcHQgb2JqZWN0IHRvIGEgSlNPTiBmaWxlLlxuICpcbiAqIEBwYXJhbSBwYXRoIC0gVGhlIHBhdGggdG8gdGhlIEpTT04gZmlsZS5cbiAqIEBwYXJhbSBkYXRhIC0gVGhlIGRhdGEgdG8gd3JpdGUgdG8gdGhlIEpTT04gZmlsZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdyaXRlSnNvblN5bmMocGF0aDogc3RyaW5nLCBkYXRhOiB1bmtub3duKTogdm9pZCB7XG4gIHdyaXRlRmlsZVN5bmMocGF0aCwgYCR7dG9Kc29uKGRhdGEpfVxcbmApO1xufVxuIl0sCiAgIm1hcHBpbmdzIjogIjs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFBQTtBQUFBO0FBQUE7QUFRQSwwQkFBdUI7QUFDdkIscUJBSU87QUFDUCxzQkFHTztBQWdFUCxlQUFzQixTQUFZLFFBQTBDO0FBQzFFLFFBQU07QUFBQSxJQUNKO0FBQUEsSUFDQTtBQUFBLElBQ0E7QUFBQSxFQUNGLElBQUk7QUFDSixNQUFJLHVCQUF1QixLQUFDLDJCQUFXLElBQUksR0FBRztBQUM1QztBQUFBLEVBQ0Y7QUFDQSxRQUFNLE9BQU8sTUFBTSxTQUFZLElBQUk7QUFDbkMsUUFBTSxhQUFhLElBQUk7QUFDdkIsUUFBTSxVQUFVLE1BQU0sSUFBSTtBQUM1QjtBQVFPLFNBQVMsYUFBZ0IsUUFBcUM7QUFDbkUsUUFBTTtBQUFBLElBQ0o7QUFBQSxJQUNBO0FBQUEsSUFDQTtBQUFBLEVBQ0YsSUFBSTtBQUNKLE1BQUksdUJBQXVCLEtBQUMsMkJBQVcsSUFBSSxHQUFHO0FBQzVDO0FBQUEsRUFDRjtBQUNBLFFBQU0sT0FBTyxhQUFnQixJQUFJO0FBQ2pDLGVBQWEsSUFBSTtBQUNqQixnQkFBYyxNQUFNLElBQUk7QUFDMUI7QUFTQSxlQUFzQixTQUFZLE1BQTBCO0FBQzFELFNBQU8sS0FBSyxNQUFNLFVBQU0sMEJBQVMsTUFBTSxPQUFPLENBQUM7QUFDakQ7QUFVTyxTQUFTLGFBQWdCLE1BQWlCO0FBQy9DLFNBQU8sS0FBSyxVQUFNLDZCQUFhLE1BQU0sT0FBTyxDQUFDO0FBQy9DO0FBU0EsZUFBc0IsVUFBVSxNQUFjLE1BQThCO0FBQzFFLFlBQU0sMkJBQVUsTUFBTSxPQUFHLDRCQUFPLElBQUksQ0FBQztBQUFBLENBQUk7QUFDM0M7QUFRTyxTQUFTLGNBQWMsTUFBYyxNQUFxQjtBQUMvRCxvQ0FBYyxNQUFNLE9BQUcsNEJBQU8sSUFBSSxDQUFDO0FBQUEsQ0FBSTtBQUN6QzsiLAogICJuYW1lcyI6IFtdCn0K

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

@@ -0,0 +1,102 @@
+/// <reference path="./index.d.cts" />
+/**
+ * @file
+ *
+ * Contains utility functions for JSON.
+ */
+import type { Promisable } from 'type-fest' with { 'resolution-mode': 'import' };
+/**
+ * Options for {@link editJson}.
+ */
+export interface EditJsonOptions {
+    /**
+     * If `true`, skips editing if the file does not exist.
+     *
+     * @default `false`
+     */
+    readonly shouldSkipIfMissing?: boolean;
+}
+/**
+ * Parameters for {@link editJson}.
+ *
+ * @typeParam T - The type of the data to be edited.
+ */
+export interface EditJsonParams<T> extends EditJsonOptions {
+    /**
+     * The function to edit the parsed JSON data.
+     *
+     * @param data - The parsed JSON data to edit.
+     */
+    readonly editFunction: (data: T) => Promisable<void>;
+    /**
+     * The path to the JSON file.
+     */
+    readonly path: string;
+}
+/**
+ * Options for {@link editJsonSync}.
+ */
+export type EditJsonSyncOptions = EditJsonOptions;
+/**
+ * Parameters for {@link editJsonSync}.
+ *
+ * @typeParam T - The type of the data to be edited.
+ */
+export interface EditJsonSyncParams<T> extends EditJsonSyncOptions {
+    /**
+     * The function to edit the parsed JSON data.
+     *
+     * @param data - The parsed JSON data to edit.
+     */
+    readonly editFunction: (data: T) => void;
+    /**
+     * The path to the JSON file.
+     */
+    readonly path: string;
+}
+/**
+ * Reads, edits, and writes back a JSON file using a provided edit function.
+ *
+ * @typeParam T - The type of the data to be edited.
+ * @param params - The parameters for the function.
+ * @returns A {@link Promise} that resolves when the file has been edited and written.
+ */
+export declare function editJson<T>(params: EditJsonParams<T>): Promise<void>;
+/**
+ * Reads, edits, and writes back a JSON file using a provided edit function.
+ *
+ * @typeParam T - The type of the data to be edited.
+ * @param params - The parameters for the function.
+ */
+export declare function editJsonSync<T>(params: EditJsonSyncParams<T>): void;
+/**
+ * Reads a JSON file and parses its contents into a JavaScript object of type `T`.
+ *
+ * @typeParam T - The type to which the JSON content will be parsed.
+ * @param path - The path to the JSON file.
+ * @returns A {@link Promise} that resolves with the parsed JSON object of type `T`.
+ */
+export declare function readJson<T>(path: string): Promise<T>;
+/**
+ * Reads a JSON file and parses its contents into a JavaScript object of type `T`.
+ *
+ * @typeParam T - The type to which the JSON content will be parsed.
+ * @param path - The path to the JSON file.
+ * @returns The parsed JSON object of type `T`.
+ */
+export declare function readJsonSync<T>(path: string): T;
+/**
+ * Writes a JavaScript object to a JSON file.
+ *
+ * @param path - The path to the JSON file.
+ * @param data - The data to write to the JSON file.
+ * @returns A {@link Promise} that resolves when the file has been written.
+ */
+export declare function writeJson(path: string, data: unknown): Promise<void>;
+/**
+ * Writes a JavaScript object to a JSON file.
+ *
+ * @param path - The path to the JSON file.
+ * @param data - The data to write to the JSON file.
+ */
+export declare function writeJsonSync(path: string, data: unknown): void;