@halospv3/hce.shared-config 3.0.0-develop.2 → 3.0.0-develop.21

package/mjs/eslintConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslintConfig.mjs","sources":["../src/eslintConfig.ts"],"sourcesContent":null,"names":[],"mappings":"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"}

package/mjs/index.d.ts

@@ -0,0 +1,3 @@
+/** Runs HCE.Shared and returns a semantic-release "shareable configuration" object. */
+export { baseConfig as default } from './semanticReleaseConfig.js';
+//# sourceMappingURL=index.d.ts.map

package/mjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,OAAO,EAAE,UAAU,IAAI,OAAO,EAAE,MAAM,4BAA4B,CAAC"}

package/mjs/index.mjs

@@ -0,0 +1,4 @@
+export { baseConfig as default } from './semanticReleaseConfig.mjs';
+
+/** Runs HCE.Shared and returns a semantic-release "shareable configuration" object. */
+//# sourceMappingURL=index.mjs.map

package/mjs/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":null,"names":[],"mappings":";;AAAA"}

package/mjs/insertPlugins.d.ts

@@ -0,0 +1,18 @@
+import type { PluginSpec } from 'semantic-release';
+/**
+ * @param plugins {@link SemanticReleaseOptions.plugins}
+ * @param afterPluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must follow.
+ * @param insertPluginIDs The `string` IDs of plugins to insert into a copy of the {@link plugins} array.
+ * @param beforePluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must precede.
+ * @returns
+ * A modified copy of {@link plugins} with the given plugins inserted
+ * before {@link beforePluginsIDs} and after {@link afterPluginsIDs}.
+ *
+ * Inserted plugins will be a `[string, {}]` tuple.
+ * @throws {ReferenceError} This should never occur. One or more of the
+ * {@link afterPluginsIDs} had been found in {@link plugins}, but a `.find` call
+ * to get the highest index of the found plugins had returned `undefined`
+ * @throws {AggregateError} One or more error occurred when inserting plugins: `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '"' + v + '"').join(', ')}] and before [${beforePluginsIDs.map(v => `"${v}"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`
+ */
+export declare function insertPlugin(plugins: Exclude<PluginSpec, string>[], afterPluginsIDs: string[], insertPluginIDs: string[], beforePluginsIDs: string[]): Exclude<PluginSpec, string>[];
+//# sourceMappingURL=insertPlugins.d.ts.map

package/mjs/insertPlugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertPlugins.d.ts","sourceRoot":"","sources":["../src/insertPlugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAEX,MAAM,kBAAkB,CAAC;AA0C1B;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EACtC,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,CAkD/B"}

package/mjs/insertPlugins.mjs

@@ -0,0 +1,73 @@
+/**
+ * @since 3.0.0
+ * @deprecated EXPERIMENTAL
+ */
+
+/**
+ * [W.I.P. STUB]
+ *
+ * Given an array of {@link PluginInsertRuleSet}s, insert plugins into a
+ * {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone structured clone}
+ * (i.e. deep-copy) of the {@link plugins} array, sort the plugin entries, and
+ * return the modified array copy.
+ * @todo implement
+ * @param plugins Your {@link SemanticReleaseOptions.plugins} array.
+ * @param inserts An array of {@link PluginInsertRuleSet}s.
+ *
+ * If a plugin is already in the plugins array, inserting is skipped. The
+ * existing entry is sorted according to its ruleset.
+ *
+ * If any rulesets conflict, an error will be thrown.
+ * - error: A must precede B; B must precede A.
+ * - pass: C must precede D and E; D must precede E and follow B. Add ruleset
+ *   interface: {Id:string, BeforeIds:string[], AfterIds:string[] }
+ * @returns A deep-cloned, modified copy of {@link plugins} with plugins
+ * inserted and sorted where needed.
+ * @since 3.0.0
+ * @deprecated EXPERIMENTAL
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+
+/**
+ * @param plugins {@link SemanticReleaseOptions.plugins}
+ * @param afterPluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must follow.
+ * @param insertPluginIDs The `string` IDs of plugins to insert into a copy of the {@link plugins} array.
+ * @param beforePluginsIDs The `string` IDs of plugins that the {@link insertPluginIDs} must precede.
+ * @returns
+ * A modified copy of {@link plugins} with the given plugins inserted
+ * before {@link beforePluginsIDs} and after {@link afterPluginsIDs}.
+ *
+ * Inserted plugins will be a `[string, {}]` tuple.
+ * @throws {ReferenceError} This should never occur. One or more of the
+ * {@link afterPluginsIDs} had been found in {@link plugins}, but a `.find` call
+ * to get the highest index of the found plugins had returned `undefined`
+ * @throws {AggregateError} One or more error occurred when inserting plugins: `insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '"' + v + '"').join(', ')}] and before [${beforePluginsIDs.map(v => `"${v}"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`
+ */
+function insertPlugin(plugins, afterPluginsIDs, insertPluginIDs, beforePluginsIDs) {
+  const pluginIDs = plugins.map(v => typeof v === 'string' ? v : v[0]);
+
+  // if any beforePluginIDs are ordered before the last afterPlugin, throw. Impossible to sort.
+
+  const indexOfLastAfter = afterPluginsIDs.filter(v => pluginIDs.includes(v)).map(v => pluginIDs.indexOf(v)).sort().find((_v, i, obj) => i === obj.length - 1);
+  if (undefined === indexOfLastAfter) throw new ReferenceError('An attempt to get the last element of an array returned undefined.');
+  const indicesOfBefore = beforePluginsIDs.filter(v => pluginIDs.includes(v)).map(v => pluginIDs.indexOf(v)).sort();
+
+  // This for-of collects *all* sorting errors. The resulting AggregateError
+  // notifies the API user of *all* errors in the order rather than just the
+  // first error encountered.
+  const errors = [];
+  for (const index of indicesOfBefore) {
+    if (index <= indexOfLastAfter) {
+      errors.push(new Error(`insertPlugin was instructed to insert one or more plugins after [${afterPluginsIDs.map(v => '"' + v + '"').join(', ')}] and before [${beforePluginsIDs.map(v => `"${v}"`).join(', ')}], but ${JSON.stringify(pluginIDs[indexOfLastAfter])} comes after ${JSON.stringify(pluginIDs[index])}!`));
+    }
+  }
+  if (errors.length > 0) throw new AggregateError(errors, 'One or more errors occurred while inserting plugin configs into the Semantic Release config!');
+
+  // insert plugin(s)
+
+  const beforeInsert = plugins.slice(0, indexOfLastAfter + 1);
+  const afterInsert = plugins.slice(indexOfLastAfter + 1, plugins.length + 1);
+  return [...beforeInsert, ...insertPluginIDs.map(id => [id, {}]), ...afterInsert];
+}
+export { insertPlugin };
+//# sourceMappingURL=insertPlugins.mjs.map

package/mjs/insertPlugins.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertPlugins.mjs","sources":["../src/insertPlugins.ts"],"sourcesContent":null,"names":[],"mappings":"AAAA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,gBAAgB,EAAE;AAC1F,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;;AAEtE;;AAEA,EAAE,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9J,EAAE,IAAI,SAAS,KAAK,gBAAgB,EAAE,MAAM,IAAI,cAAc,CAAC,oEAAoE,CAAC;AACpI,EAAE,MAAM,eAAe,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;;AAEnH;AACA;AACA;AACA,EAAE,MAAM,MAAM,GAAG,EAAE;AACnB,EAAE,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE;AACvC,IAAI,IAAI,KAAK,IAAI,gBAAgB,EAAE;AACnC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,iEAAiE,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3T;AACA;AACA,EAAE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,IAAI,cAAc,CAAC,MAAM,EAAE,8FAA8F,CAAC;;AAEzJ;;AAEA,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC;AAC7D,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7E,EAAE,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC;AAClF;;;;"}

package/mjs/semantic-release__commit-analyzer.d.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=semantic-release__commit-analyzer.d.mjs.map

package/mjs/semantic-release__commit-analyzer.d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-release__commit-analyzer.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

package/mjs/semantic-release__exec.d.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=semantic-release__exec.d.mjs.map

package/mjs/semantic-release__exec.d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-release__exec.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

package/mjs/semantic-release__git.d.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=semantic-release__git.d.mjs.map

package/mjs/semantic-release__git.d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-release__git.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

package/mjs/semantic-release__github.d.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=semantic-release__github.d.mjs.map

package/mjs/semantic-release__github.d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-release__github.d.mjs","sources":[],"sourcesContent":null,"names":[],"mappings":""}

package/mjs/semanticReleaseConfig.d.ts

@@ -0,0 +1,97 @@
+import type { Options as SRCommitAnalyzerOptions } from '@semantic-release/commit-analyzer';
+import type { Options as SRExecOptions } from '@semantic-release/exec';
+import type { Options as SRGitOptions } from '@semantic-release/git';
+import type { Options as SRGithubOptions } from '@semantic-release/github';
+import type { PluginSpec } from 'semantic-release';
+import { DefaultOptions } from './setupGitPluginSpec.js';
+export interface SRReleaseNotesGeneratorOptions {
+    /**
+     * conventional-changelog preset.
+     * @default 'angular'
+     */
+    preset?: 'angular' | 'atom' | 'codemirror' | 'ember' | 'eslint' | 'express' | 'jquery' | 'jscs' | 'jshint' | 'conventionalcommits' | (string & Record<never, never>) | undefined;
+    /**
+     * Requireable npm package with a custom conventional-changelog preset.
+     */
+    config?: string | undefined;
+    /**
+     * Additional `conventional-changelog-parser` options that will overwrite ones loaded by `preset` or `config`.
+     */
+    parserOpts: object;
+    /**
+     * Additional `conventional-changelog-writer` options that will overwrite ones loaded by `preset` or `config`.
+     */
+    writerOpts: object;
+}
+/**
+ * A two-type PluginSpec to tie a plugin's name to its Options type. This is
+ * intended for use by plugins to associate their Options type with their plugin
+ * name.
+ */
+export type PluginSpecTuple<P extends string = string, T = unknown> = [P, T];
+export type PluginSpecSRCommitAnalyzer<V extends SRCommitAnalyzerOptions = SRCommitAnalyzerOptions> = PluginSpecTuple<'@semantic-release/commit-analyzer', V>;
+export type PluginSpecSRChangelog<V extends Record<'changelogFile' | 'changelogTitle', string>> = PluginSpecTuple<'@semantic-release/changelog', V>;
+export type PluginSpecExportData<V extends Record<string, unknown> = Record<string, unknown>> = PluginSpecTuple<'semantic-release-export-data', V>;
+export type PluginSpecSRReleaseNotesGen<V extends SRReleaseNotesGeneratorOptions = SRReleaseNotesGeneratorOptions> = PluginSpecTuple<'@semantic-release/release-notes-generator', V>;
+export type PluginSpecSRExec<V extends SRExecOptions = SRExecOptions> = PluginSpecTuple<'@semantic-release/exec', V>;
+export type PluginSpecSRGit<V extends SRGitOptions = SRGitOptions> = PluginSpecTuple<'@semantic-release/git', V>;
+export type PluginSpecSRGithub<V extends SRGithubOptions = SRGithubOptions> = PluginSpecTuple<'@semantic-release/github', V>;
+/**
+ * @satisfies { Readonly<PluginSpec[]> }
+ */
+export declare const defaultPlugins: readonly [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/release-notes-generator',
+    '@semantic-release/npm',
+    '@semantic-release/github'
+];
+/**
+ *  @see baseConfig
+ */
+declare const _baseConfig: {
+    /** @see https://semantic-release.gitbook.io/semantic-release/usage/plugins#plugin-options-configuration */
+    preset: "conventionalcommits";
+    branches: ["main", {
+        name: "develop";
+        channel: "develop";
+        prerelease: true;
+    }];
+    plugins: [PluginSpecSRCommitAnalyzer, PluginSpecExportData, PluginSpecSRReleaseNotesGen, PluginSpecSRChangelog<Record<"changelogFile" | "changelogTitle", string>>, PluginSpecSRGit<typeof DefaultOptions>, PluginSpecSRExec, PluginSpecSRGithub<{
+        addReleases: "bottom";
+        assets: [{
+            path: "./publish/*";
+        }];
+    }>] | Exclude<PluginSpec, string>[];
+};
+/**
+ * The base configuration for various Semantic Release scenarios.
+ * - Prefers preset "conventionalcommits"
+ *   (Conventional-Changelog-ConventionalCommits).
+ * - Creates tags and release commits on "main" branch, pre-releases on
+ *   "develop" branch in "develop" channel.
+ * - Creates GitHub Releases.
+ * - Exports the following variables as GitHub Actions outputs:
+ *   - "new-release-published": "true" | "false"
+ *   - "new-release-version" : string
+ *   - "new-release-git-tag" : string
+ * - includes default plugins (except `@semantic-release/npm`) and more
+ *   - `@semantic-release/commit-analyzer`
+ *   - semantic-release-export-data
+ *   - `@semantic-release/release-notes-generator`
+ *   - `@semantic-release/changelog`
+ *   - `@semantic-release/git`
+ *     - add modified CHANGELOG.md in release commit
+ *   - `@semantic-release/exec`
+ *     - does nothing by default. Included for convenience.
+ *   - `@semantic-release/github`
+ *     - uploads all files from `./publish/*`. This is non-recursive.
+ *     - adds a list of links to related release pages (e.g. the release's page on npmjs.com)
+ *
+ * (OPTIONAL) update static Version strings before Git plugin
+ * - https://github.com/jpoehnelt/semantic-release-replace-plugin
+ * - https://github.com/droidsolutions/semantic-release-update-file
+ * @satisfies {Options}
+ */
+export declare const baseConfig: typeof _baseConfig;
+export {};
+//# sourceMappingURL=semanticReleaseConfig.d.ts.map

package/mjs/semanticReleaseConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticReleaseConfig.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfig.ts"],"names":[],"mappings":"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"}

package/mjs/semanticReleaseConfig.mjs

@@ -0,0 +1,63 @@
+import { DefaultOptions } from './setupGitPluginSpec.mjs';
+
+/**
+ * A two-type PluginSpec to tie a plugin's name to its Options type. This is
+ * intended for use by plugins to associate their Options type with their plugin
+ * name.
+ */
+
+/**
+ * @satisfies { Readonly<PluginSpec[]> }
+ */
+const defaultPlugins = Object.freeze(['@semantic-release/commit-analyzer', '@semantic-release/release-notes-generator', '@semantic-release/npm', '@semantic-release/github']);
+
+// define as const for string literals in type, then...
+/**
+ *  @see baseConfig
+ */
+const _baseConfig = {
+  /** @see https://semantic-release.gitbook.io/semantic-release/usage/plugins#plugin-options-configuration */
+  preset: 'conventionalcommits',
+  branches: ['main', {
+    name: 'develop',
+    channel: 'develop',
+    prerelease: true
+  }],
+  plugins: [['@semantic-release/commit-analyzer', {}], ['semantic-release-export-data', {}], ['@semantic-release/release-notes-generator', {}], ['@semantic-release/changelog', {}], ['@semantic-release/git', DefaultOptions], ['@semantic-release/exec', {}], ['@semantic-release/github', {
+    addReleases: 'bottom',
+    assets: ['./publish/*', '!./publish/.gitkeep']
+  }]]
+};
+
+/**
+ * The base configuration for various Semantic Release scenarios.
+ * - Prefers preset "conventionalcommits"
+ *   (Conventional-Changelog-ConventionalCommits).
+ * - Creates tags and release commits on "main" branch, pre-releases on
+ *   "develop" branch in "develop" channel.
+ * - Creates GitHub Releases.
+ * - Exports the following variables as GitHub Actions outputs:
+ *   - "new-release-published": "true" | "false"
+ *   - "new-release-version" : string
+ *   - "new-release-git-tag" : string
+ * - includes default plugins (except `@semantic-release/npm`) and more
+ *   - `@semantic-release/commit-analyzer`
+ *   - semantic-release-export-data
+ *   - `@semantic-release/release-notes-generator`
+ *   - `@semantic-release/changelog`
+ *   - `@semantic-release/git`
+ *     - add modified CHANGELOG.md in release commit
+ *   - `@semantic-release/exec`
+ *     - does nothing by default. Included for convenience.
+ *   - `@semantic-release/github`
+ *     - uploads all files from `./publish/*`. This is non-recursive.
+ *     - adds a list of links to related release pages (e.g. the release's page on npmjs.com)
+ *
+ * (OPTIONAL) update static Version strings before Git plugin
+ * - https://github.com/jpoehnelt/semantic-release-replace-plugin
+ * - https://github.com/droidsolutions/semantic-release-update-file
+ * @satisfies {Options}
+ */
+const baseConfig = _baseConfig;
+export { baseConfig, defaultPlugins };
+//# sourceMappingURL=semanticReleaseConfig.mjs.map

package/mjs/semanticReleaseConfig.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticReleaseConfig.mjs","sources":["../src/semanticReleaseConfig.ts"],"sourcesContent":null,"names":[],"mappings":";;AAEA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACY,MAAC,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,mCAAmC,EAAE,2CAA2C,EAAE,uBAAuB,EAAE,0BAA0B,CAAC;;AAEnL;AACA;AACA;AACA;AACA,MAAM,WAAW,GAAG;AACpB;AACA,EAAE,MAAM,EAAE,qBAAqB;AAC/B,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE;AACrB,IAAI,IAAI,EAAE,SAAS;AACnB,IAAI,OAAO,EAAE,SAAS;AACtB,IAAI,UAAU,EAAE;AAChB,GAAG,CAAC;AACJ,EAAE,OAAO,EAAE,CAAC,CAAC,mCAAmC,EAAE,EAAE,CAAC,EAAE,CAAC,8BAA8B,EAAE,EAAE,CAAC,EAAE,CAAC,2CAA2C,EAAE,EAAE,CAAC,EAAE,CAAC,6BAA6B,EAAE,EAAE,CAAC,EAAE,CAAC,uBAAuB,EAAE,cAAc,CAAC,EAAE,CAAC,wBAAwB,EAAE,EAAE,CAAC,EAAE,CAAC,0BAA0B,EAAE;AAC7R,IAAI,WAAW,EAAE,QAAQ;AACzB,IAAI,MAAM,EAAE,CAAC,aAAa,EAAE,qBAAqB;AACjD,GAAG,CAAC;AACJ,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,UAAU,GAAG;;;;"}

package/mjs/semanticReleaseConfigDotnet.d.ts

@@ -0,0 +1,109 @@
+/**
+ * # Semantic-Release Config Factory (dotnet)
+ * A functional Semantic-Release configuration for dotnet projects
+ *
+ * extends {@link baseConfig }
+ *
+ * <-- TABLE OF CONTENTS -->
+ * - configureDotnetRelease
+ * - Insert-Edit Plugins
+ * - Append Plugins
+ *
+ */
+import type { Options } from 'semantic-release';
+import { NugetRegistryInfo } from './dotnet/NugetRegistryInfo.js';
+import { MSBuildProject } from './dotnet/MSBuildProject.js';
+/**
+ */
+export declare class SemanticReleaseConfigDotnet {
+    private readonly options;
+    private readonly _projectsToPublish;
+    private _projectsToPackAndPush;
+    private readonly _evaluatedProjects;
+    /**
+     * Creates an instance of SemanticReleaseConfigDotnet.
+     * Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet` publish, pack, and push.
+     *
+     * Note: To sign packages, create a Target in the corresponding project(s) e.g.
+     * ```xml
+     * <Target Name="SignNupkgs" AfterTargets="Pack">
+     *   <Exec Command="dotnet nuget sign $(PackageOutputPath) [remaining args]" ConsoleToMsBuild="true" />
+     * </Target>
+     * ```
+     * Alternatively, splice your signing commands into the publishCmd string,
+     * inserting them before `dotnet nuget push`.
+     * If you sign different signatures depending on the NuGet registry,
+     * splice your signing command (with "overwrite signature" enabled, if
+     * desired) before the corresponding registry's `dotnet nuget push` command.
+     * @param projectsToPublish An array of dotnet projects' relative paths. If
+     * empty or unspecified, tries getting projects' semi-colon-separated relative
+     * paths from the `PROJECTS_TO_PUBLISH` environment variable. If configured as
+     * recommended, the projects' publish outputs will be zipped to '$PWD/publish'
+     * for use in the `publish` semantic-release step (typically, GitHub release).
+     * @param projectsToPackAndPush An array of dotnet projects' relative paths.
+     * If empty or unspecified, tries getting projects' semi-colon-separated
+     * relative paths from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.
+     * Otherwise, no packages will be packed and pushed.
+     * If configured as recommended, `dotnet pack` will output the nupkg/snupkg
+     * files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.
+     */
+    constructor(projectsToPublish: string[] | MSBuildProject[], projectsToPackAndPush: string[] | NugetRegistryInfo[]);
+    get ProjectsToPublish(): string[] | MSBuildProject[];
+    get ProjectsToPackAndPush(): string[] | NugetRegistryInfo[];
+    get EvaluatedProjects(): MSBuildProject[];
+    insertPlugin(afterPluginsIDs: string[], insertPluginIDs: string[], beforePluginsIDs: string[]): void;
+    /**
+     * generate dotnet commands for \@semantic-release/exec, appending commands with ' && ' when necessary.
+     *
+     * Note: All strings in {@link this.ProjectsToPackAndPush} will be converted to basic {@link NugetRegistryInfo} instances with default values.
+     * If you need specific NRI settings or you need to push to GitLab-like or GitHub-like registries, instantiate them instead of passing their paths.
+     * @todo change to builder method? e.g. static async SetupDotnetCommands(this: SemanticReleaseConfigDotnet): Promise<SemanticReleaseConfigDotnet>
+     * @todo Add options param to allow users to enable pushing to GitLab, GitHub, NuGet.org with default settings -OR- with entirely custom settings.
+     * @see https://github.com/semantic-release/exec#usage
+     */
+    setupDotnetCommands(): Promise<void>;
+    /**
+     * Insert a plugin into the plugins array.
+     * @deprecated EXPERIMENTAL: needs thorough tests implemented before use in production!
+     * @param insertAfterPluginIDs Plugins which should appear BEFORE
+     * {@link insertPluginIDs}.
+     * @param insertPluginIDs The plugin(s) to insert into the plugins array.
+     * @param insertBeforePluginsIDs plugins which should appear AFTER the
+     * inserted plugin(s).
+     */
+    splicePlugin(insertAfterPluginIDs: string[], insertPluginIDs: string[], insertBeforePluginsIDs: string[]): void;
+    protected getTokenTestingCommands(): Promise<string>;
+    toOptions(): Options;
+}
+/**
+ * Configures {@link baseConfig} with `@semantic-release/exec` to `dotnet`
+ * publish, pack, and nuget-push.
+ * @param projectsToPublish
+ * An array of dotnet projects' relative paths -OR- an array of
+ * {@link MSBuildProject} instances.
+ * - If `MSBuildProject[]`, the instances will be used as-is.
+ * - If `[]`, tries getting projects' semi-colon-separated relative paths from
+ *   the `PROJECTS_TO_PUBLISH` environment variable.
+ * - If configured as recommended, the projects' publish outputs will be zipped
+ *   to '$PWD/publish' for use in the `publish` semantic-release step e.g. for a
+ *   GitHub release.
+ * @param projectsToPackAndPush An array of dotnet projects' relative paths -OR-
+ * an array of instances of {@link NugetRegistryInfo} and/or derived classes.
+ * - If `NugetRegistryInfo[]`, no conversions or modifications will occur.
+ * - If `string[]`, the project paths will be converted to
+ * {@link NugetRegistryInfo} instances with default values. This may be undesired.
+ * - If `[]`, `dotnet pack` and `dotnet nuget push` commands will not be configured.
+ * - If `undefined`, tries getting projects' semi-colon-separated relative paths
+ * from the `PROJECTS_TO_PACK_AND_PUSH` environment variable.
+ * With the recommended configuration, `dotnet pack` will write the nupkg/snupkg
+ * files to `$PWD/publish` where they will be globbed by `dotnet nuget push`.
+ * @returns a semantic-release Options object, based on
+ * `@halospv3/hce.shared-config` (our base config), with the
+ * `@semantic-release/exec` plugin configured to `dotnet publish`, `pack`, and
+ * `push` the specified projects.
+ */
+export declare function getConfig(projectsToPublish: string[] | MSBuildProject[], projectsToPackAndPush?: string[] | NugetRegistryInfo[]): Promise<Options>;
+/**
+ * @module semanticReleaseConfigDotnet
+ */
+//# sourceMappingURL=semanticReleaseConfigDotnet.d.ts.map

package/mjs/semanticReleaseConfigDotnet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semanticReleaseConfigDotnet.d.ts","sourceRoot":"","sources":["../src/semanticReleaseConfigDotnet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAMhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAQ5D;GACG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IACjE,OAAO,CAAC,sBAAsB,CAAiC;IAC/D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAmB;IAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;gBAED,iBAAiB,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,EAC9C,qBAAqB,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE;IAwCvD,IAAI,iBAAiB,IAAI,MAAM,EAAE,GAAG,cAAc,EAAE,CAEnD;IAED,IAAI,qBAAqB,IAAI,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAE1D;IAED,IAAI,iBAAiB,IAAI,cAAc,EAAE,CAExC;IAED,YAAY,CACV,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,MAAM,EAAE,GACzB,IAAI;IAIP;;;;;;;;OAQG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6F1C;;;;;;;;OAQG;IACH,YAAY,CACV,oBAAoB,EAAE,MAAM,EAAE,EAC9B,eAAe,EAAE,MAAM,EAAE,EACzB,sBAAsB,EAAE,MAAM,EAAE,GAC/B,IAAI;cAmDS,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;IAqC1D,SAAS,IAAI,OAAO;CAGrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,SAAS,CAC7B,iBAAiB,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,EAC9C,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE,GACrD,OAAO,CAAC,OAAO,CAAC,CAqDlB;AAED;;GAEG"}