@mnaoumov/typescript-dev-toolkit 6.0.2 → 6.2.0

package/dist/lib/esm/linters/eslint-rules/prefer-spread.mjs

@@ -0,0 +1,80 @@
+/*
+THIS IS A GENERATED/BUNDLED FILE BY ESBUILD
+if you want to view the source, please visit the github repository of this plugin
+*/
+(function () {
+function ensureBrowserProcess() {
+  const browserProcess = {
+    browser: true,
+    cwd() {
+      return '/';
+    },
+    env: {},
+    platform: 'android'
+  };
+
+  const existingProcess = globalThis.process;
+
+  if (!existingProcess) {
+    globalThis.process = browserProcess;
+    return;
+  }
+
+  if (existingProcess.versions?.node) {
+    return;
+  }
+
+  const existingProcessRecord = existingProcess;
+
+  for (const [key, value] of Object.entries(browserProcess)) {
+    existingProcessRecord[key] ??= value;
+  }
+
+  existingProcessRecord['browser'] = true;
+}
+
+ensureBrowserProcess();
+})();
+
+import { ensureNonNullable } from "@mnaoumov/typescript-lib/type-guards";
+import eslintPluginUnicorn from "eslint-plugin-unicorn";
+import { toTSESTreeNode } from "./ts-estree-node.mjs";
+const unicornRule = ensureNonNullable(ensureNonNullable(eslintPluginUnicorn.rules)["prefer-spread"]);
+const preferSpread = {
+  create(context) {
+    const reportingContext = Object.create(context, {
+      report: {
+        value(descriptor) {
+          const { messageId, node } = descriptor;
+          if (messageId === "array-slice" && !isArrayReceiver(node, context.sourceCode)) {
+            return;
+          }
+          context.report(descriptor);
+        }
+      }
+    });
+    return unicornRule.create(reportingContext);
+  },
+  meta: {
+    ...unicornRule.meta,
+    docs: {
+      description: "Prefer spread syntax without changing the type returned by slice"
+    }
+  }
+};
+function isArrayReceiver(node, sourceCode) {
+  const member = ensureNonNullable(sourceCode.getAncestors(node).at(-1));
+  const services = sourceCode.parserServices;
+  if (!services.program) {
+    return false;
+  }
+  const checker = services.program.getTypeChecker();
+  const receiverType = checker.getTypeAtLocation(ensureNonNullable(services.esTreeNodeToTSNodeMap).get(toTSESTreeNode(member.object)));
+  const type = checker.getBaseConstraintOfType(receiverType) ?? receiverType;
+  const constituents = type.isUnion() ? type.types : [type];
+  return constituents.every((constituent) => checker.isArrayType(constituent) || checker.isTupleType(constituent));
+}
+export {
+  preferSpread
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3NyYy9saW50ZXJzL2VzbGludC1ydWxlcy9wcmVmZXItc3ByZWFkLnRzIl0sInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQGZpbGVcbiAqXG4gKiBVbmljb3JuJ3Mgc3ByZWFkIHJ1bGUsIHdpdGggc2xpY2UgcmV3cml0ZXMgcmVzdHJpY3RlZCB0byBwcm92ZW4gYXJyYXkgcmVjZWl2ZXJzLlxuICogQSB0eXBlZCBhcnJheSdzIHNsaWNlIHByZXNlcnZlcyBpdHMgdHlwZTsgc3ByZWFkaW5nIGl0IHByb2R1Y2VzIGFuIG9yZGluYXJ5IGFycmF5LlxuICovXG5cbmltcG9ydCB0eXBlIHsgUGFyc2VyU2VydmljZXNXaXRoVHlwZUluZm9ybWF0aW9uIH0gZnJvbSAnQHR5cGVzY3JpcHQtZXNsaW50L3V0aWxzJztcbmltcG9ydCB0eXBlIHsgUnVsZSB9IGZyb20gJ2VzbGludCc7XG5pbXBvcnQgdHlwZSB7XG4gIE1lbWJlckV4cHJlc3Npb24sXG4gIE5vZGVcbn0gZnJvbSAnZXN0cmVlJztcblxuaW1wb3J0IHsgZW5zdXJlTm9uTnVsbGFibGUgfSBmcm9tICdAbW5hb3Vtb3YvdHlwZXNjcmlwdC1saWIvdHlwZS1ndWFyZHMnO1xuaW1wb3J0IGVzbGludFBsdWdpblVuaWNvcm4gZnJvbSAnZXNsaW50LXBsdWdpbi11bmljb3JuJztcblxuaW1wb3J0IHsgdG9UU0VTVHJlZU5vZGUgfSBmcm9tICcuL3RzLWVzdHJlZS1ub2RlLnRzJztcblxuY29uc3QgdW5pY29yblJ1bGUgPSBlbnN1cmVOb25OdWxsYWJsZShlbnN1cmVOb25OdWxsYWJsZShlc2xpbnRQbHVnaW5Vbmljb3JuLnJ1bGVzKVsncHJlZmVyLXNwcmVhZCddKSBhcyBSdWxlLlJ1bGVNb2R1bGU7XG5cbmludGVyZmFjZSBTcHJlYWRSZXBvcnREZXNjcmlwdG9yIHtcbiAgcmVhZG9ubHkgbWVzc2FnZUlkPzogc3RyaW5nO1xuICByZWFkb25seSBub2RlOiBOb2RlO1xufVxuXG4vKipcbiAqIFByZWZlcnMgc3ByZWFkIHN5bnRheCB3aGlsZSBwcmVzZXJ2aW5nIHNsaWNlIGNhbGxzIHdob3NlIHJlY2VpdmVyIGlzIG5vdCBwcm92ZW4gdG8gYmUgYW4gYXJyYXkuXG4gKi9cbmV4cG9ydCBjb25zdCBwcmVmZXJTcHJlYWQ6IFJ1bGUuUnVsZU1vZHVsZSA9IHtcbiAgY3JlYXRlKGNvbnRleHQpIHtcbiAgICBjb25zdCByZXBvcnRpbmdDb250ZXh0OiBSdWxlLlJ1bGVDb250ZXh0ID0gT2JqZWN0LmNyZWF0ZShjb250ZXh0LCB7XG4gICAgICByZXBvcnQ6IHtcbiAgICAgICAgdmFsdWUoZGVzY3JpcHRvcjogUnVsZS5SZXBvcnREZXNjcmlwdG9yKTogdm9pZCB7XG4gICAgICAgICAgY29uc3QgeyBtZXNzYWdlSWQsIG5vZGUgfSA9IGRlc2NyaXB0b3IgYXMgU3ByZWFkUmVwb3J0RGVzY3JpcHRvcjtcbiAgICAgICAgICBpZiAobWVzc2FnZUlkID09PSAnYXJyYXktc2xpY2UnICYmICFpc0FycmF5UmVjZWl2ZXIobm9kZSwgY29udGV4dC5zb3VyY2VDb2RlKSkge1xuICAgICAgICAgICAgcmV0dXJuO1xuICAgICAgICAgIH1cbiAgICAgICAgICBjb250ZXh0LnJlcG9ydChkZXNjcmlwdG9yKTtcbiAgICAgICAgfVxuICAgICAgfVxuICAgIH0pO1xuICAgIHJldHVybiB1bmljb3JuUnVsZS5jcmVhdGUocmVwb3J0aW5nQ29udGV4dCk7XG4gIH0sXG4gIG1ldGE6IHtcbiAgICAuLi51bmljb3JuUnVsZS5tZXRhLFxuICAgIGRvY3M6IHtcbiAgICAgIGRlc2NyaXB0aW9uOiAnUHJlZmVyIHNwcmVhZCBzeW50YXggd2l0aG91dCBjaGFuZ2luZyB0aGUgdHlwZSByZXR1cm5lZCBieSBzbGljZSdcbiAgICB9XG4gIH1cbn07XG5cbmZ1bmN0aW9uIGlzQXJyYXlSZWNlaXZlcihub2RlOiBOb2RlLCBzb3VyY2VDb2RlOiBSdWxlLlJ1bGVDb250ZXh0Wydzb3VyY2VDb2RlJ10pOiBib29sZWFuIHtcbiAgLy8gVW5pY29ybiByZXBvcnRzIGFycmF5LXNsaWNlIG9uIHRoZSBtZXRob2QgcHJvcGVydHkgb2YgYSBtZW1iZXIgZXhwcmVzc2lvbi5cbiAgY29uc3QgbWVtYmVyID0gZW5zdXJlTm9uTnVsbGFibGUoc291cmNlQ29kZS5nZXRBbmNlc3RvcnMobm9kZSkuYXQoLTEpKSBhcyBNZW1iZXJFeHByZXNzaW9uO1xuICBjb25zdCBzZXJ2aWNlcyA9IHNvdXJjZUNvZGUucGFyc2VyU2VydmljZXMgYXMgUGFydGlhbDxQYXJzZXJTZXJ2aWNlc1dpdGhUeXBlSW5mb3JtYXRpb24+O1xuICBpZiAoIXNlcnZpY2VzLnByb2dyYW0pIHtcbiAgICByZXR1cm4gZmFsc2U7XG4gIH1cbiAgY29uc3QgY2hlY2tlciA9IHNlcnZpY2VzLnByb2dyYW0uZ2V0VHlwZUNoZWNrZXIoKTtcbiAgY29uc3QgcmVjZWl2ZXJUeXBlID0gY2hlY2tlci5nZXRUeXBlQXRMb2NhdGlvbihlbnN1cmVOb25OdWxsYWJsZShzZXJ2aWNlcy5lc1RyZWVOb2RlVG9UU05vZGVNYXApLmdldCh0b1RTRVNUcmVlTm9kZShtZW1iZXIub2JqZWN0KSkpO1xuICBjb25zdCB0eXBlID0gY2hlY2tlci5nZXRCYXNlQ29uc3RyYWludE9mVHlwZShyZWNlaXZlclR5cGUpID8/IHJlY2VpdmVyVHlwZTtcbiAgY29uc3QgY29uc3RpdHVlbnRzID0gdHlwZS5pc1VuaW9uKCkgPyB0eXBlLnR5cGVzIDogW3R5cGVdO1xuICByZXR1cm4gY29uc3RpdHVlbnRzLmV2ZXJ5KChjb25zdGl0dWVudCkgPT4gY2hlY2tlci5pc0FycmF5VHlwZShjb25zdGl0dWVudCkgfHwgY2hlY2tlci5pc1R1cGxlVHlwZShjb25zdGl0dWVudCkpO1xufVxuIl0sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQWNBLFNBQVMseUJBQXlCO0FBQ2xDLE9BQU8seUJBQXlCO0FBRWhDLFNBQVMsc0JBQXNCO0FBRS9CLE1BQU0sY0FBYyxrQkFBa0Isa0JBQWtCLG9CQUFvQixLQUFLLEVBQUUsZUFBZSxDQUFDO0FBVTVGLE1BQU0sZUFBZ0M7QUFBQSxFQUMzQyxPQUFPLFNBQVM7QUFDZCxVQUFNLG1CQUFxQyxPQUFPLE9BQU8sU0FBUztBQUFBLE1BQ2hFLFFBQVE7QUFBQSxRQUNOLE1BQU0sWUFBeUM7QUFDN0MsZ0JBQU0sRUFBRSxXQUFXLEtBQUssSUFBSTtBQUM1QixjQUFJLGNBQWMsaUJBQWlCLENBQUMsZ0JBQWdCLE1BQU0sUUFBUSxVQUFVLEdBQUc7QUFDN0U7QUFBQSxVQUNGO0FBQ0Esa0JBQVEsT0FBTyxVQUFVO0FBQUEsUUFDM0I7QUFBQSxNQUNGO0FBQUEsSUFDRixDQUFDO0FBQ0QsV0FBTyxZQUFZLE9BQU8sZ0JBQWdCO0FBQUEsRUFDNUM7QUFBQSxFQUNBLE1BQU07QUFBQSxJQUNKLEdBQUcsWUFBWTtBQUFBLElBQ2YsTUFBTTtBQUFBLE1BQ0osYUFBYTtBQUFBLElBQ2Y7QUFBQSxFQUNGO0FBQ0Y7QUFFQSxTQUFTLGdCQUFnQixNQUFZLFlBQXFEO0FBRXhGLFFBQU0sU0FBUyxrQkFBa0IsV0FBVyxhQUFhLElBQUksRUFBRSxHQUFHLEVBQUUsQ0FBQztBQUNyRSxRQUFNLFdBQVcsV0FBVztBQUM1QixNQUFJLENBQUMsU0FBUyxTQUFTO0FBQ3JCLFdBQU87QUFBQSxFQUNUO0FBQ0EsUUFBTSxVQUFVLFNBQVMsUUFBUSxlQUFlO0FBQ2hELFFBQU0sZUFBZSxRQUFRLGtCQUFrQixrQkFBa0IsU0FBUyxxQkFBcUIsRUFBRSxJQUFJLGVBQWUsT0FBTyxNQUFNLENBQUMsQ0FBQztBQUNuSSxRQUFNLE9BQU8sUUFBUSx3QkFBd0IsWUFBWSxLQUFLO0FBQzlELFFBQU0sZUFBZSxLQUFLLFFBQVEsSUFBSSxLQUFLLFFBQVEsQ0FBQyxJQUFJO0FBQ3hELFNBQU8sYUFBYSxNQUFNLENBQUMsZ0JBQWdCLFFBQVEsWUFBWSxXQUFXLEtBQUssUUFBUSxZQUFZLFdBQVcsQ0FBQztBQUNqSDsiLCJuYW1lcyI6W119

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

@@ -9,6 +9,7 @@
  * Git operations such as tagging and pushing.
  */
 import { parseArgs } from 'node:util';
+import type { ChangelogStyle } from './changelog-grouping.mjs';
 /**
  * Options for {@link addUpdatedFilesToGit}.
  */
@@ -53,6 +54,13 @@ export interface PublishGitHubReleaseOptions {
      * @default `true`
      */
     readonly shouldCloseReleasedIssues?: boolean;
+    /**
+     * Whether to require every asset to exist, require an existing remote tag, and verify the published
+     * non-draft release and its uploaded assets before closing issues.
+     *
+     * @default `false`
+     */
+    readonly shouldVerifyRelease?: boolean;
 }
 /**
  * Options for {@link updateChangelog}.
@@ -69,6 +77,16 @@ export interface UpdateChangelogOptions {
      * @default the first-parent commit subjects since the previous version
      */
     readonly changelogFilePath?: string | undefined;
+    /**
+     * How the section generated from the commit messages is laid out: `grouped` sorts the entries under plain-language
+     * headings and counts the maintenance commits instead of listing them, `commits` writes one bullet per first-parent
+     * commit. See {@link ChangelogStyle}.
+     *
+     * Ignored when {@link changelogFilePath} is set.
+     *
+     * @default `'grouped'`
+     */
+    readonly changelogStyle?: ChangelogStyle | undefined;
     /**
      * Whether to open the generated changelog in the editor for an interactive review. When `false`,
      * the changelog is still generated from commit messages, but it is not opened in the editor for
@@ -95,6 +113,12 @@ export interface UpdateVersionOptions {
      * @default the first-parent commit subjects since the previous version
      */
     readonly changelogFilePath?: string | undefined;
+    /**
+     * How the section generated from the commit messages is laid out. See {@link UpdateChangelogOptions.changelogStyle}.
+     *
+     * @default `'grouped'`
+     */
+    readonly changelogStyle?: ChangelogStyle | undefined;
     /**
      * Returns the files to attach to the GitHub release. See {@link PublishGitHubReleaseOptions.getReleaseAssetPaths}.
      */
@@ -133,6 +157,16 @@ export interface UpdateVersionOptions {
      * @default `true`
      */
     readonly shouldEditChangelog?: boolean;
+    /**
+     * Whether to publish and verify the GitHub release before pushing the version commit to the branch.
+     * Preparation and asset validation happen before any push. Only the release tag is pushed first;
+     * a failed preparation, publication or verification leaves the remote branch unchanged.
+     * Uses the `origin` remote and pushes the verified commit to the original branch without force.
+     * Ignored when {@link shouldRelease} is `false`.
+     *
+     * @default `false`
+     */
+    readonly shouldPublishBeforePush?: boolean;
     /**
      * Whether to publish the release. When `false`, all local steps are executed (version bump,
      * changelog, commit, tag), but the changes are not pushed and no GitHub release is published.
@@ -317,6 +351,9 @@ export declare const VERSION_ARGUMENT_OPTIONS: {
     readonly 'changelog-file': {
         readonly type: "string";
     };
+    readonly 'changelog-style': {
+        readonly type: "string";
+    };
     readonly 'no-build': {
         readonly type: "boolean";
     };
@@ -364,6 +401,7 @@ export declare function isPreRelease(version: string): boolean;
  * value instead and has no default. Recognized flags:
  * - `--changelog-file=<path>` — use this file's contents as the new version's changelog section instead of
  *   the commit-derived bullets, and skip the interactive review entirely.
+ * - `--changelog-style=<grouped|commits>` — how the commit-derived section is laid out (default `grouped`).
  * - `--no-build` — skip the build step (only safe when the build output already matches the current code).
  * - `--no-changelog-editing` — generate the changelog without opening it for manual review.
  * - `--no-checks` — skip the clean-repo check, format, spellcheck, lint, over-exposure analysis, and tests (the build still runs).
@@ -431,6 +469,9 @@ export declare function updateChangelog(newVersion: string, options?: UpdateChan
  * 11. Prepares and publishes a GitHub release.
  * 12. Closes the issues the release carries, with a link to it.
  *
+ * With {@link UpdateVersionOptions.shouldPublishBeforePush}, preparation and asset validation precede
+ * the tag push. Publication and verification then precede the branch push, and issue closing remains last.
+ *
  * @param versionUpdateType - The type of version update to perform (major, minor, patch, premajor, preminor, prepatch, prerelease, or x.y.z[-suffix]).
  * @param options - The {@link UpdateVersionOptions} controlling the release behavior.
  * @returns A {@link Promise} that resolves when the version update is complete.