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

package/src/dotnet/NugetRegistryInfo.ts

@@ -4,9 +4,9 @@ import type { SemanticReleaseConfigDotnet } from '../semanticReleaseConfigDotnet
 import type { NugetProjectProperties } from './NugetProjectProperties.js';
 /* eslint-enable @typescript-eslint/no-unused-vars */
 
+import { config as configDotenv } from '@dotenvx/dotenvx';
 import { type } from 'arktype';
 import { detectFile, detectFileSync } from 'chardet';
-import { config as configDotenv } from '@dotenvx/dotenvx';
 import { ok } from 'node:assert/strict';
 import type { ExecException } from 'node:child_process';
 import { existsSync, writeFileSync } from 'node:fs';
@@ -20,6 +20,8 @@ import sanitizeFileName from 'sanitize-filename';
 import { getEnvVarValue } from '../utils/env.js';
 import { execAsync } from '../utils/execAsync.js';
 import { catchCsc2012, MSBuildEvaluationOutput, MSBuildProject } from './MSBuildProject.js';
+import type { ObjectType } from 'arktype/internal/methods/object.ts';
+import type { Default } from 'arktype/internal/attributes.ts';
 
 type TmpDirNamespace_Unix = `${ReturnType<typeof tmpdir>}/HCE.Shared/.NET/Dummies`;
 type TmpDirNamespace_Win = `${ReturnType<typeof tmpdir>}\\HCE.Shared\\.NET\\Dummies`;
@@ -292,7 +294,27 @@ but the environment variable is empty or undefined.`);
    * {@link NRI.PackPackagesOptionsType.t.propertyOverrides `propertyOverrides`}
    * is a wrapper for MSBuild's `-property:<n>=<v>` properties override arg.
    */
-  static readonly PackPackagesOptionsType = Object.freeze(
+  static readonly PackPackagesOptionsType: ObjectType<{
+    propertyOverrides?: Record<string, string> | undefined;
+    artifactsPath?: string | undefined;
+    configuration?: 'Release' | 'Debug' | undefined;
+    disableBuildServers?: boolean | undefined;
+    force?: boolean | undefined;
+    includeSource?: boolean | undefined;
+    includeSymbols?: boolean | undefined;
+    interactive?: boolean | undefined;
+    noBuild?: boolean | undefined;
+    noLogo?: boolean | undefined;
+    noRestore?: boolean | undefined;
+    output?: string | undefined;
+    runtime?: string | undefined;
+    serviceable?: boolean | undefined;
+    terminalLogger?: 'auto' | 'on' | 'off' | undefined;
+    useCurrentRuntime?: boolean | undefined;
+    verbosity?: 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic' | undefined;
+    versionSuffix?: string | undefined;
+    '-GetItem'?: readonly string[] | string[] | undefined;
+  }> = Object.freeze(
     type({
       /**
        * a custom arg for handling MSBuild's `-property:<n>=<v>` argument for overriding MSBuild properties.
@@ -323,7 +345,26 @@ but the environment variable is empty or undefined.`);
     }),
   );
 
-  public static readonly PackDummyPackagesOptionsType
+  public static readonly PackDummyPackagesOptionsType: ObjectType<{
+    propertyOverrides?: Record<string, string> | undefined;
+    artifactsPath?: string | undefined;
+    configuration?: 'Release' | 'Debug' | undefined;
+    disableBuildServers?: boolean | undefined;
+    force?: boolean | undefined;
+    includeSource?: boolean | undefined;
+    includeSymbols?: boolean | undefined;
+    interactive?: boolean | undefined;
+    noBuild?: boolean | undefined;
+    noLogo?: boolean | undefined;
+    noRestore?: boolean | undefined;
+    runtime?: string | undefined;
+    serviceable?: boolean | undefined;
+    terminalLogger?: 'auto' | 'on' | 'off' | undefined;
+    useCurrentRuntime?: boolean | undefined;
+    verbosity?: 'quiet' | 'minimal' | 'normal' | 'detailed' | 'diagnostic' | undefined;
+    versionSuffix?: string | undefined;
+    '-GetItem'?: readonly string[] | string[] | undefined;
+  }>
     = this.PackPackagesOptionsType.omit('output');
 
   /**
@@ -518,7 +559,21 @@ but the environment variable is empty or undefined.`);
    * Specific to this API:
    * If you want to use this API's default root value (\`${cwd()}/publish`), assign an empty string.
    */
-  static readonly PushPackagesOptionsType = Object.freeze(
+  static readonly PushPackagesOptionsType: ObjectType<{
+    root: string;
+    apiKey?: string | undefined;
+    configFile?: string | undefined;
+    disableBuffering?: boolean | undefined;
+    forceEnglishOutput?: boolean | undefined;
+    interactive?: boolean | undefined;
+    noServiceEndpoint?: boolean | undefined;
+    noSymbols?: boolean | undefined;
+    skipDuplicate?: boolean | undefined;
+    source?: string | undefined;
+    symbolApiKey?: string | undefined;
+    symbolSource?: string | undefined;
+    timeout?: number | undefined;
+  }> = Object.freeze(
     type({
     /** If an empty string is passed, this property is overridden to `./publish` */
       root: 'string',
@@ -557,7 +612,20 @@ but the environment variable is empty or undefined.`);
    * {@link NRI.PushPackagesOptionsType} sans {@link NRI.PushPackagesOptionsType.t.root}.
    * The result of {@link getDummiesDir} is used, instead.
    */
-  public static readonly PushDummyPackagesOptionsType
+  public static readonly PushDummyPackagesOptionsType: ObjectType<{
+    apiKey?: string | undefined;
+    configFile?: string | undefined;
+    disableBuffering?: boolean | undefined;
+    forceEnglishOutput?: boolean | undefined;
+    interactive?: boolean | undefined;
+    noServiceEndpoint?: boolean | undefined;
+    noSymbols?: boolean | undefined;
+    source?: string | undefined;
+    symbolApiKey?: string | undefined;
+    symbolSource?: string | undefined;
+    timeout?: number | undefined;
+    skipDuplicate: Default<true, true>;
+  }>
     = NugetRegistryInfo.PushPackagesOptionsType.merge({
       skipDuplicate: 'true = true',
     }).omit('root');
@@ -832,13 +900,22 @@ but the environment variable is empty or undefined.`);
 }
 
 // shorthand/alias for NugetRegistryInfo
-const NRI = NugetRegistryInfo;
+const NRI: typeof NugetRegistryInfo = NugetRegistryInfo;
 
 /**
  * The base type for {@link NRIOpts} and related types. Extend this type while
  * overriding member types via {@link NRIOptsBase.merge}
  */
-export const NRIOptsBase = type({
+export const NRIOptsBase: ObjectType<{
+  project: MSBuildProject | {
+    readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
+    readonly Properties: Readonly<NugetProjectProperties>;
+    readonly Targets: readonly string[];
+    readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];
+  };
+  source: string;
+  tokenEnvVars: readonly string[];
+}> = type({
   /**
    * The environment variables whose values are tokens with permission to push a
    * package to the NuGet package registry. The array is iterated through until
@@ -883,7 +960,16 @@ export const NRIOptsBase = type({
 /**
  * The type of the parameter for {@link NugetRegistryInfo}'s constructor.
  */
-export const NRIOpts = NRIOptsBase.merge({
+export const NRIOpts: ObjectType<{
+  project: MSBuildProject | {
+    readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
+    readonly Properties: Readonly<NugetProjectProperties>;
+    readonly Targets: readonly string[];
+    readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];
+  };
+  tokenEnvVars: Default<readonly string[], readonly ['NUGET_TOKEN']>;
+  source: Default<string, string>;
+}> = NRIOptsBase.merge({
   /**
    * Defaults to {@link NugetRegistryInfo.DefaultTokenEnvVars}
    * @see {@link NRIOptsBase.t.tokenEnvVars}

package/src/dotnet/helpers.ts

@@ -4,6 +4,8 @@ import { cwd } from 'node:process';
 import { MSBuildProject } from './MSBuildProject.js';
 import { MSBuildProjectProperties as MSBPP } from './MSBuildProjectProperties.js';
 import { NugetRegistryInfo } from './NugetRegistryInfo.js';
+import type { Default } from 'arktype/internal/attributes.ts';
+import type { ObjectType } from 'arktype/internal/methods/object.ts';
 
 const ourDefaultPubDir = path.join('.', 'publish') as `.${'/' | '\\'}publish`;
 
@@ -65,7 +67,7 @@ export async function configurePrepareCmd(
    * paths.
    * @returns A Promise of a string. This string contains one or more `dotnet publish`
    * commands conjoined by " && ". It may also include one or more
-   * `dotnet msbuild ${...} -t:PublishAll` commands.
+   * `dotnet msbuild ${...} -t:PublishAll -p:Configuration=Release` commands.
    */
   async function formatDotnetPublish(
     projectsToPublish: string[] | MSBuildProject[],
@@ -136,7 +138,7 @@ export async function configurePrepareCmd(
      * runtime-framework combinations.
      * @returns If {@link proj} imports {@link ../../dotnet/PublishAll.targets}...
      * ```
-     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll`]
+     * [`${proj.Properties.MSBuildProjectFullPath} -t:PublishAll -p:Configuration=Release`]
      * ```
      * Else, an array of `dotnet publish` arguments permutations e.g.
      * ```
@@ -161,7 +163,7 @@ export async function configurePrepareCmd(
      * return publishCmdArray.join(' && ');
      */
     function getPublishArgsPermutations(proj: MSBuildProject):
-      ([`"${typeof proj.Properties.MSBuildProjectFullPath}" -t:PublishAll`])
+      ([`"${typeof proj.Properties.MSBuildProjectFullPath}" -t:PublishAll -p:Configuration=Release`])
       | ([`"${typeof proj.Properties.MSBuildProjectFullPath}"`])
       | (`"${typeof proj.Properties.MSBuildProjectFullPath}" --runtime ${string} --framework ${string}`)[]
       | (`"${typeof proj.Properties.MSBuildProjectFullPath}" --runtime ${string}`)[]
@@ -171,7 +173,7 @@ export async function configurePrepareCmd(
        * permutation, return the appropriate command line.
        */
       if (proj.Targets.includes('PublishAll'))
-        return [`"${proj.Properties.MSBuildProjectFullPath}" -t:PublishAll`];
+        return [`"${proj.Properties.MSBuildProjectFullPath}" -t:PublishAll -p:Configuration=Release`];
 
       // #region formatFrameworksAndRuntimes
       const tfmRidPermutations: `--runtime ${string} --framework ${string}`[]
@@ -218,7 +220,7 @@ export async function configurePrepareCmd(
       // #endregion formatFrameworksAndRuntimes
     }
 
-    const publishCmds: (`dotnet publish "${string}"` | `dotnet publish "${string}" ${string}` | `dotnet msbuild "${string}" -t:PublishAll`)[] = [];
+    const publishCmds: (`dotnet publish "${string}"` | `dotnet publish "${string}" ${string}` | `dotnet msbuild "${string}" -t:PublishAll -p:Configuration=Release`)[] = [];
     /** convert {@link evaluatedPublishProjects} to sets of space-separated CLI args. */
     const argsSets = evaluatedPublishProjects.map(
       proj => getPublishArgsPermutations(proj),
@@ -229,7 +231,10 @@ export async function configurePrepareCmd(
       for (const permutation of args) {
         if (typeof permutation === 'string' && permutation.length === 1)
           throw new Error('Something has gone terribly wrong. A `dotnet publish` argument set was split to single characters!');
-        publishCmds.push(`dotnet publish ${permutation}`);
+        if (/".+" -t:PublishAll -p:Configuration=Release/.test(permutation))
+          publishCmds.push(`dotnet msbuild ${permutation as `"${string}" -t:PublishAll -p:Configuration=Release`}`);
+        else
+          publishCmds.push(`dotnet publish ${permutation}`);
       }
     }
 
@@ -290,7 +295,9 @@ export async function configurePrepareCmd(
  */
 export function configureDotnetNugetPush(
   registryInfos: NugetRegistryInfo[],
-  packageOutputPath = `${cwd()}/publish`,
+  // Explicit type required by JSR
+  // eslint-disable-next-line @typescript-eslint/no-inferrable-types
+  packageOutputPath: string = `${cwd()}/publish`,
 ): string {
   if (registryInfos.some(registry => registry.source.trim() === ''))
     throw new Error('The URL for one of the provided NuGet registries was empty or whitespace.');
@@ -362,48 +369,75 @@ function formatDotnetNugetSign(
   }
 }
 
-const DotnetNugetSignOptions = type({
+const DotnetNugetSignOptions: ObjectType<
+  {
+    timestamper: Default<string, 'https://rfc3161.ai.moda/'>;
+    certificatePassword?: string | undefined;
+    hashAlgorithm?: string | undefined;
+    output?: string | undefined;
+    overwrite?: true | undefined;
+    timestampHashAlgorithm?: string | undefined;
+    verbosity?: 'q' | 'quiet' | 'm' | 'minimal' | 'n' | 'normal' | 'd' | 'detailed' | 'diag' | 'diagnostic';
+  } & ({
+    certificatePath: string;
+    certificateSubjectName: string;
+  } | {
+    certificatePath: string;
+    certificateFingerprint: string;
+  } | {
+    certificateStoreName: string;
+    certificateSubjectName: string;
+  } | {
+    certificateStoreName: string;
+    certificateFingerprint: string;
+  } | {
+    certificateStoreLocation: string;
+    certificateSubjectName: string;
+  } | {
+    certificateStoreLocation: string;
+    certificateFingerprint: string;
+  })> = type({
   /**
    * Password for the certificate, if needed. This option can be used to specify
    * the password for the certificate. The command will throw an error message
    * if certificate is password protected but password is not provided as input.
    */
-  'certificatePassword?': 'string',
-  /**
-   * Hash algorithm to be used to sign the package. Defaults to SHA256.
-   */
-  'hashAlgorithm?': 'string | "SHA256"',
-  /**
-   * Directory where the signed package(s) should be saved. By default the
-   * original package is overwritten by the signed package.
-   */
-  'output?': 'string',
-  /**
-   * Switch to indicate if the current signature should be overwritten. By
-   * default the command will fail if the package already has a signature.
-   */
-  'overwrite?': 'true',
-  /**
-   * URL to an RFC 3161 timestamping server.
-   */
-  timestamper: 'string = "https://rfc3161.ai.moda/"',
-  /**
-   * Hash algorithm to be used to sign the package. Defaults to SHA256.
-   */
-  'timestampHashAlgorithm?': 'string | "SHA256"',
-  /**
-   * Set the verbosity level of the command. Allowed values are q[uiet],
-   * m[inimal], n[ormal], d[etailed], and diag[nostic].
-   */
-  'verbosity?': '"q"|"quiet"|"m"|"minimal"|"n"|"normal"|"d"|"detailed"|"diag"|"diagnostic"',
-}).and(
-  type({
+    'certificatePassword?': 'string',
     /**
-     * File path to the certificate to be used while signing the package.
+     * Hash algorithm to be used to sign the package. Defaults to SHA256.
+     */
+    'hashAlgorithm?': 'string | "SHA256"',
+    /**
+     * Directory where the signed package(s) should be saved. By default the
+     * original package is overwritten by the signed package.
      */
-    certificatePath: 'string',
-  }).or(
+    'output?': 'string',
+    /**
+     * Switch to indicate if the current signature should be overwritten. By
+     * default the command will fail if the package already has a signature.
+     */
+    'overwrite?': 'true',
+    /**
+     * URL to an RFC 3161 timestamping server.
+     */
+    timestamper: 'string = "https://rfc3161.ai.moda/"',
+    /**
+     * Hash algorithm to be used to sign the package. Defaults to SHA256.
+     */
+    'timestampHashAlgorithm?': 'string | "SHA256"',
+    /**
+     * Set the verbosity level of the command. Allowed values are q[uiet],
+     * m[inimal], n[ormal], d[etailed], and diag[nostic].
+     */
+    'verbosity?': '"q"|"quiet"|"m"|"minimal"|"n"|"normal"|"d"|"detailed"|"diag"|"diagnostic"',
+  }).and(
     type({
+    /**
+     * File path to the certificate to be used while signing the package.
+     */
+      certificatePath: 'string',
+    }).or(
+      type({
       /**
        * Name of the X.509 certificate store to use to search for the
        * certificate. Defaults to "My", the X.509 certificate store for personal
@@ -412,8 +446,8 @@ const DotnetNugetSignOptions = type({
        * This option should be used when specifying the certificate via
        * --certificate-subject-name or --certificate-fingerprint options.
        */
-      certificateStoreName: 'string',
-    }).or({
+        certificateStoreName: 'string',
+      }).or({
       /**
        * Name of the X.509 certificate store use to search for the
        * certificate. Defaults to "CurrentUser", the X.509 certificate store
@@ -422,10 +456,10 @@ const DotnetNugetSignOptions = type({
        * This option should be used when specifying the certificate via
        * --certificate-subject-name or --certificate-fingerprint options.
        */
-      certificateStoreLocation: 'string',
-    }),
-  ).and(
-    type({
+        certificateStoreLocation: 'string',
+      }),
+    ).and(
+      type({
       /**
        * Subject name of the certificate used to search a local certificate
        * store for the certificate. The search is a case-insensitive string
@@ -434,15 +468,15 @@ const DotnetNugetSignOptions = type({
        * subject values. The certificate store can be specified by
        * --certificate-store-name and --certificate-store-location options.
        */
-      certificateSubjectName: 'string',
-    }).or({
+        certificateSubjectName: 'string',
+      }).or({
       /**
        * SHA-256, SHA-384 or SHA-512 fingerprint of the certificate used to
        * search a local certificate store for the certificate. The certificate
        * store can be specified by --certificate-store-name and
        * --certificate-store-location options.
        */
-      certificateFingerprint: 'string',
-    }),
-  ),
-);
+        certificateFingerprint: 'string',
+      }),
+    ),
+  );

package/src/dotnet/index.ts

@@ -0,0 +1,8 @@
+export * from './GithubNugetRegistryInfo.js';
+export * from './GitlabNugetRegistryInfo.js';
+export * from './helpers.js';
+export * from './IsNextVersionAlreadyPublished.cli.js';
+export * from './MSBuildProject.js';
+export * from './MSBuildProjectProperties.js';
+export * from './NugetProjectProperties.js';
+export * from './NugetRegistryInfo.js';

package/src/dotnet.ts

@@ -0,0 +1 @@
+export * from './dotnet/index.js';

package/src/insertPlugins.ts

@@ -0,0 +1,116 @@
+import type {
+  PluginSpec,
+  Options as SemanticReleaseOptions,
+} from 'semantic-release';
+
+/**
+ * @since 3.0.0
+ * @deprecated EXPERIMENTAL
+ */
+interface PluginInsertRuleSet {
+  Id: string;
+  BeforeIds: string[];
+  AfterIds: string[];
+}
+
+/**
+ * [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
+declare function insertAndSortPlugins(
+  plugins: Exclude<SemanticReleaseOptions['plugins'], undefined>,
+  // eslint-disable-next-line @typescript-eslint/no-deprecated
+  inserts: PluginInsertRuleSet[]
+): PluginSpec[];
+
+/**
+ * @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 function insertPlugin(
+  plugins: Exclude<PluginSpec, string>[],
+  afterPluginsIDs: string[],
+  insertPluginIDs: string[],
+  beforePluginsIDs: string[],
+): Exclude<PluginSpec, string>[] {
+  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: Error[] = [];
+  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, {}] as [string, unknown],
+    ),
+    ...afterInsert,
+  ];
+}

package/src/semantic-release__exec.d.ts

@@ -1,5 +1,5 @@
 declare module '@semantic-release/exec' {
-  interface Options {
+  export interface Options {
     verifyConditionsCmd?: string;
     analyzeCommitsCmd?: string;
     verifyReleaseCmd?: string;

package/src/semanticReleaseConfig.ts

@@ -42,7 +42,12 @@ export type PluginSpecSRGithub<V extends SRGithubOptions = SRGithubOptions> = Pl
 /**
  * @satisfies { Readonly<PluginSpec[]> }
  */
-export const defaultPlugins = Object.freeze([
+export const defaultPlugins: readonly [
+  '@semantic-release/commit-analyzer',
+  '@semantic-release/release-notes-generator',
+  '@semantic-release/npm',
+  '@semantic-release/github',
+] = Object.freeze([
   '@semantic-release/commit-analyzer',
   '@semantic-release/release-notes-generator',
   '@semantic-release/npm',
@@ -67,7 +72,7 @@ const _baseConfig = {
     ['@semantic-release/changelog', {}],
     ['@semantic-release/git', DefaultOptions],
     ['@semantic-release/exec', {}],
-    ['@semantic-release/github', { addReleases: 'bottom', assets: [{ path: './publish/*' }] }],
+    ['@semantic-release/github', { addReleases: 'bottom', assets: ['./publish/*', '!./publish/.gitkeep'] }],
   ] as [
     PluginSpecSRCommitAnalyzer,
     PluginSpecExportData,
@@ -76,7 +81,7 @@ const _baseConfig = {
     PluginSpecSRGit<typeof DefaultOptions>,
     PluginSpecSRExec,
     PluginSpecSRGithub<{ addReleases: 'bottom'; assets: [{ path: './publish/*' }] }>,
-  ] | PluginSpec[],
+  ] | Exclude<PluginSpec, string>[],
 };
 
 /**