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

package/mjs/dotnet/GitlabNugetRegistryInfo.mjs

@@ -0,0 +1,99 @@
+import { isNativeError } from 'node:util/types';
+import { getEnvVarValue } from '../utils/env.mjs';
+import { NugetRegistryInfo, NRIOpts, NRIOptsBase } from './NugetRegistryInfo.mjs';
+
+// https://docs.gitlab.com/ee/user/packages/nuget_repository/
+class GitlabNugetRegistryInfo extends NugetRegistryInfo {
+  /**
+   * The GitLab API v4 root URL.
+   * @returns The value of the environment variable `CI_API_V4_URL`.
+   * If that's `undefined`, 'https://gitlab.com/api/v4' is returned, instead.
+   */
+  static get CI_API_V4_URL() {
+    return getEnvVarValue('CI_API_V4_URL') ?? 'https://gitlab.com/api/v4';
+  }
+
+  /**
+   * CI_PROJECT_ID - If you want to publish to your GitLab server, this needs to be set to the Id of the project you want to publish to. When running in GitLab CI this is already set to the project the pipeline runs in by GitLab.
+   * This method checks the contents of your `.env` file, if present.
+   * @returns The value of the environment variable `CI_PROJECT_ID` or `undefined`.
+   * @todo add URI encoded project pathname as alternative e.g. 'halospv3%2FHCE.Shared' in 'https://gitlab.com/api/v4/projects/halospv3%2FHCE.Shared'
+   */
+  static get projectId() {
+    return getEnvVarValue('CI_PROJECT_ID');
+  }
+
+  /**
+   * CI_PROJECT_NAMESPACE_ID
+   * This method checks the contents of your `.env` file, if present.
+   * @returns The value of the environment variable 'CI_PROJECT_NAMESPACE_ID' or `undefined`.
+   */
+  static get ownerId() {
+    return getEnvVarValue('CI_PROJECT_NAMESPACE_ID');
+  }
+  static DefaultGitlabTokenEnvVars = Object.freeze(['GL_TOKEN', 'GITLAB_TOKEN', 'CI_JOB_TOKEN']);
+
+  /**
+   * Creates an instance of GitlabNugetRegistryInfo.
+   * @param opts The input type of {@link GLNRIOpts.from}
+   */
+  constructor(opts) {
+    const optsOut = GLNRIOpts.from(opts);
+    if (isNativeError(optsOut.source)) throw optsOut.source;
+    super(optsOut);
+  }
+
+  /**
+   * Get the GitLab Nuget API for your project url as seen in https://docs.gitlab.com/ee/user/packages/nuget_repository/index.html#publish-a-nuget-package-by-using-cicd
+   * ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json
+   * @returns If {@link this.projectId} is a string, a string formatted like
+   * `${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/nuget/index.json`.
+   * Else, {@link Error}.
+   */
+  static get projectUrl() {
+    return this.projectId ? `${this.CI_API_V4_URL}/projects/${this.projectId}/packages/nuget/index.json` : new Error('The project-type URL was specified, but one or more of the required environment variables (CI_API_V4_URL, CI_PROJECT_ID) were undefined.');
+  }
+
+  /**
+   * ${CI_API_V4_URL}/groups/${CI_PROJECT_NAMESPACE_ID}/-/packages/nuget/index.json
+   * @returns If {@link ownerId} is a string, then a string formatted like
+   * `${CI_API_V4_URL}/groups/${CI_PROJECT_NAMESPACE_ID}/-/packages/nuget/index.json`.
+   * Else, {@link Error}.
+   */
+  static get groupUrl() {
+    return this.ownerId ? `${this.CI_API_V4_URL}/groups/${this.ownerId}/-/packages/nuget/index.json` : new Error('env.CI_PROJECT_NAMESPACE_ID must be defined to use its GitLab API endpoint!');
+  }
+}
+const GLNRI = GitlabNugetRegistryInfo;
+
+/**
+ * The Arktype definition for {@link GitlabNugetRegistryInfo}'s constructor parameter. Construct an object of this type by calling {@link GLNRIOpts.from}
+ */
+const GLNRIOpts = NRIOpts.merge({
+  tokenEnvVars: NRIOptsBase.get('tokenEnvVars').default(() => GLNRI.DefaultGitlabTokenEnvVars),
+  /**
+   * The GitLab Nuget API URL to push packages to -OR- a keyword such as "group"
+   * or "project" used to determine URL.
+   * @default GLNRI.projectUrl
+   * @see {@link GLNRI.projectUrl}, {@link GLNRI.groupUrl}
+   */
+  // todo: change '"group" | "project"' to '"GITLAB:PROJECT" | "GITLAB:GROUP"'
+  source: NRIOptsBase.get('source').or('"group" | "project" | Error').pipe(source => {
+    switch (source) {
+      case 'group':
+        {
+          return GLNRI.groupUrl;
+        }
+      case 'project':
+        {
+          return GLNRI.projectUrl;
+        }
+      default:
+        {
+          return source;
+        }
+    }
+  }).default(() => GLNRI.projectUrl)
+});
+export { GLNRIOpts, GitlabNugetRegistryInfo };
+//# sourceMappingURL=GitlabNugetRegistryInfo.mjs.map

package/mjs/dotnet/GitlabNugetRegistryInfo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitlabNugetRegistryInfo.mjs","sources":["../../src/dotnet/GitlabNugetRegistryInfo.ts"],"sourcesContent":null,"names":[],"mappings":";;;;AAGA;AACO,MAAM,uBAAuB,SAAS,iBAAiB,CAAC;AAC/D;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,aAAa,GAAG;AAC7B,IAAI,OAAO,cAAc,CAAC,eAAe,CAAC,IAAI,2BAA2B;AACzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,SAAS,GAAG;AACzB,IAAI,OAAO,cAAc,CAAC,eAAe,CAAC;AAC1C;;AAEA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,OAAO,GAAG;AACvB,IAAI,OAAO,cAAc,CAAC,yBAAyB,CAAC;AACpD;AACA,EAAE,OAAO,yBAAyB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;;AAEhG;AACA;AACA;AACA;AACA,EAAE,WAAW,CAAC,IAAI,EAAE;AACpB,IAAI,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;AACxC,IAAI,IAAI,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM;AAC3D,IAAI,KAAK,CAAC,OAAO,CAAC;AAClB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,UAAU,GAAG;AAC1B,IAAI,OAAO,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,GAAG,IAAI,KAAK,CAAC,0IAA0I,CAAC;AAChQ;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,WAAW,QAAQ,GAAG;AACxB,IAAI,OAAO,IAAI,CAAC,OAAO,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,GAAG,IAAI,KAAK,CAAC,6EAA6E,CAAC;AAC/L;AACA;AACA,MAAM,KAAK,GAAG,uBAAuB;;AAErC;AACA;AACA;AACY,MAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;AACvC,EAAE,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,yBAAyB,CAAC;AAC9F;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,6BAA6B,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI;AACrF,IAAI,QAAQ,MAAM;AAClB,MAAM,KAAK,OAAO;AAClB,QAAQ;AACR,UAAU,OAAO,KAAK,CAAC,QAAQ;AAC/B;AACA,MAAM,KAAK,SAAS;AACpB,QAAQ;AACR,UAAU,OAAO,KAAK,CAAC,UAAU;AACjC;AACA,MAAM;AACN,QAAQ;AACR,UAAU,OAAO,MAAM;AACvB;AACA;AACA,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,UAAU;AACnC,CAAC;;;;"}

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IsNextVersionAlreadyPublished.cli.d.ts.map

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsNextVersionAlreadyPublished.cli.d.ts","sourceRoot":"","sources":["../../src/dotnet/IsNextVersionAlreadyPublished.cli.ts"],"names":[],"mappings":""}

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.mjs

@@ -0,0 +1,41 @@
+import { getGithubOutput, NugetRegistryInfo } from './NugetRegistryInfo.mjs';
+import esMain from 'es-main';
+
+/**
+ * @returns if successful
+ * @throws if...
+ * - {@link process.argv} does not include...
+ *   - `--packageId [string]`
+ *   - `--source [string]`
+ * - Value of `await getGithubOutput())['new-release-version']`...
+ *   - is not a valid Version
+ *   - already exists at `source`
+ */
+async function main() {
+  const args = process.argv.slice(2);
+  // Parse command-line arguments - https://stackoverflow.com/a/76298476/14894786
+  const options = {};
+  for (let i = 0; i < args.length; i += 2) {
+    const argName = args[i];
+    const argValue = args[i + 1];
+    if (argValue !== undefined && argName?.startsWith('--') === true && options[argName.slice(2)] !== undefined) {
+      options[argName] = argValue;
+    }
+  }
+  if (typeof options.packageId !== 'string') throw new Error('packageId must be a string');
+  if (typeof options.source !== 'string') throw new Error('source must be a string');
+  const packageId = options.packageId,
+    source = options.source,
+    versionPattern = new RegExp(/\d+\.\d+\.\d+([-+].+)?/);
+  const ghOutput = (await getGithubOutput()) ?? {};
+  const matches = versionPattern.exec(ghOutput['new-release-version'] ?? '');
+  if (matches === null || matches.length === 0) throw new Error('The variable new-release-version is not present in the GITHUB_OUTPUT env file or its value contains invalid characters.');
+  const nextVersion = matches[0];
+  const isPublished = await NugetRegistryInfo.IsNextVersionAlreadyPublished(source, packageId, nextVersion);
+  if (typeof isPublished !== 'boolean') throw new Error('isPublished is not a boolean');
+  if (isPublished) throw new Error(`${packageId}@${nextVersion} already exists at ${source}.`);
+  console.log(`OK: ${packageId}@${nextVersion} does NOT yet exist at ${source}. Yay.`);
+  return 0;
+}
+if (esMain(import.meta)) await main();
+//# sourceMappingURL=IsNextVersionAlreadyPublished.cli.mjs.map

package/mjs/dotnet/IsNextVersionAlreadyPublished.cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"IsNextVersionAlreadyPublished.cli.mjs","sources":["../../src/dotnet/IsNextVersionAlreadyPublished.cli.ts"],"sourcesContent":null,"names":[],"mappings":";;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAe,IAAI,GAAG;AACtB,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AACpC;AACA,EAAE,MAAM,OAAO,GAAG,EAAE;AACpB,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;AAC3C,IAAI,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AAC3B,IAAI,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AAChC,IAAI,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE;AACjH,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,QAAQ;AACjC;AACA;AACA,EAAE,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC;AAC1F,EAAE,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,EAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC;AACpF,EAAE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS;AACrC,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM;AAC3B,IAAI,cAAc,GAAG,IAAI,MAAM,CAAC,wBAAwB,CAAC;AACzD,EAAE,MAAM,QAAQ,GAAG,CAAC,MAAM,eAAe,EAAE,KAAK,EAAE;AAClD,EAAE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC,IAAI,EAAE,CAAC;AAC5E,EAAE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,CAAC,yHAAyH,CAAC;AAC1L,EAAE,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;AAChC,EAAE,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC;AAC3G,EAAE,IAAI,OAAO,WAAW,KAAK,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC;AACvF,EAAE,IAAI,WAAW,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC9F,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;AACtF,EAAE,OAAO,CAAC;AACV;AACA,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE"}

package/mjs/dotnet/MSBuildProject.d.ts

@@ -0,0 +1,256 @@
+import { type Scope } from 'arktype';
+import { NugetProjectProperties } from './NugetProjectProperties.js';
+import type { ObjectType } from 'arktype/internal/methods/object.ts';
+declare const msbuildEvaluationOutput: ObjectType<{
+    Properties?: Record<string, string> | undefined;
+    Items?: Record<string, {
+        [x: string]: string | undefined;
+        Identity: string;
+        FullPath: string;
+        RootDir: string;
+        Filename: string;
+        Extension: string;
+        RelativeDir: string;
+        Directory: string;
+        RecursiveDir: string;
+        ModifiedTime: string;
+        CreatedTime: string;
+        AccessedTime: string;
+        DefiningProjectFullPath: string;
+        DefiningProjectDirectory: string;
+        DefiningProjectName: string;
+        DefiningProjectExtension: string;
+        SubType?: string;
+        TargetFrameworkIdentifier?: string | undefined;
+        TargetPlatformMoniker?: string | undefined;
+        CopyUpToDateMarker?: string | undefined;
+        TargetPlatformIdentifier?: string | undefined;
+        TargetFrameworkVersion?: string | undefined;
+        ReferenceAssembly?: string | undefined;
+    }[]> | undefined;
+    TargetResults?: Record<string, {
+        Result: 'Success';
+        Items: {
+            [x: string]: string | undefined;
+            Identity: string;
+            FullPath: string;
+            RootDir: string;
+            Filename: string;
+            Extension: string;
+            RelativeDir: string;
+            Directory: string;
+            RecursiveDir: string;
+            ModifiedTime: string;
+            CreatedTime: string;
+            AccessedTime: string;
+            DefiningProjectFullPath: string;
+            DefiningProjectDirectory: string;
+            DefiningProjectName: string;
+            DefiningProjectExtension: string;
+            SubType?: string | undefined;
+            TargetFrameworkIdentifier?: string | undefined;
+            TargetPlatformMoniker?: string | undefined;
+            CopyUpToDateMarker?: string | undefined;
+            TargetPlatformIdentifier?: string | undefined;
+            TargetFrameworkVersion?: string | undefined;
+            ReferenceAssembly?: string | undefined;
+        }[];
+    } | {
+        Result: 'Failure';
+        Items: never[];
+    }> | undefined;
+}>;
+export declare class MSBuildEvaluationOutput {
+    /**
+     * @param rawMSBuildEvaluation The output of a CLI MSBuild project evaluation.
+     * May be the UTF-8 string-encoded JSON or the object decoded from that JSON.
+     */
+    constructor(rawMSBuildEvaluation: Parameters<typeof JSON.parse>[0] | Parameters<typeof msbuildEvaluationOutput.from>[0]);
+    /**
+     * The specified properties and their values as evaluated by MSBuild Core.
+     * `-getProperty:{propertyName,...}`
+     */
+    Properties?: typeof msbuildEvaluationOutput.infer.Properties;
+    /**
+     * The specified items and their values and associated metadata as evaluated
+     * by MSBuild Core.
+     * `-getItem:{itemName,...}`
+     */
+    Items?: typeof msbuildEvaluationOutput.infer.Items;
+    /**
+     * The specified Targets and their output values as evaluated by MSBuild
+     * Core.
+     * `-getTargetResult:{targetName,...}`
+     */
+    TargetResults?: typeof msbuildEvaluationOutput.infer.TargetResults;
+}
+export declare const EvaluationOptions: ObjectType<{
+    FullName: string;
+    Property: {
+        MSBuildProjectFullPath?: string | undefined;
+        AssemblyName?: string | undefined;
+        BaseIntermediateOutputPath?: string | undefined;
+        BaseOutputPath?: string | undefined;
+        Description?: string | undefined;
+        IntermediateOutput?: string | undefined;
+        OutDir?: string | undefined;
+        OutputPath?: string | undefined;
+        Version?: string | undefined;
+        VersionPrefix?: string | undefined;
+        VersionSuffix?: string | undefined;
+        TargetFramework?: string | undefined;
+        TargetFrameworks?: string | undefined;
+        RuntimeIdentifier?: string | undefined;
+        RuntimeIdentifiers?: string | undefined;
+    };
+    Targets: readonly string[] | string[];
+    GetItem: readonly string[] | string[];
+    GetProperty: readonly string[] | string[];
+    GetTargetResult: readonly string[] | string[];
+}>;
+export declare class MSBuildProject {
+    /**
+     * Properties for multi-targeting `dotnet publish` outputs.
+     * These are included in {@link NPPGetterNames.InstanceGettersRecursive}.
+     */
+    static readonly MatrixProperties: readonly string[];
+    /**
+     * Creates an instance of MSBuildProject.
+     * @param opts The order-independent arguments for this constructor.
+     * Properties may be added or moved around in this definition without
+     * breaking compatibility.
+     * @param opts.fullPath The full path of the MSBuild project's file. This
+     * should have a '.csproj', '.fsproj', or '.vbproj' file extension.
+     * @param opts.projTargets A list of MSBuild Targets supported by the project.
+     * @param opts.evaluation The output of an MSBuild project evaluation. This
+     * comprises MSBuild Properties, Items, and Target results.
+     */
+    constructor(opts: {
+        fullPath: string;
+        projTargets: string[];
+        evaluation: MSBuildEvaluationOutput;
+    });
+    readonly Items: Readonly<Required<MSBuildEvaluationOutput>['Items']>;
+    readonly Properties: Readonly<NugetProjectProperties>;
+    readonly Targets: readonly string[];
+    /**
+     * Allows appending subsequent target results.
+     */
+    readonly TargetResults: Required<MSBuildEvaluationOutput>['TargetResults'][];
+    /**
+     * @param projectPath The full path of the project file or its directory. A
+     * relative path may be passed, but will resolve relative to the current
+     * working directory.
+     * @param includeNonPublic Include conventionally internal/private MSBuild
+     * targets in the result.
+     * @returns A string array of the project's MSBuild targets.
+     * @todo consider 'file' of -targets[:file]
+     *  Prints a list of available targets without executing the
+     *  actual build process. By default the output is written to
+     *  the console window. If the path to an output file
+     *  is provided that will be used instead.
+     *  (Short form: -ts)
+     *  Example:
+     *    -ts:out.txt
+     */
+    static GetTargets(projectPath: string, includeNonPublic?: boolean): Promise<string[]>;
+    /**
+     * Evaluate {@link Items}, {@link Properties}, and {@link TargetResults},
+     * returning them as an instance of {@link MSBuildProject}.\
+     * Note: MSBuild will probably fail if Restore is skipped and another
+     * target is specified. If you choose Pack, you must do ['Restore', 'Pack'].
+     * @param options The result of {@link EvaluationOptions.from}.
+     * @returns A promised {@link MSBuildProject} instance.
+     * @throws if the exec command fails -OR- the JSON parse fails -OR-
+     * MSBuildProject's constructor fails.
+     * @see {@link PackableProjectsToMSBuildProjects} for most use-cases.
+     */
+    static Evaluate(options: typeof EvaluationOptions.inferOut): Promise<MSBuildProject>;
+    /**
+     * Evaluate multiple project paths with some default Evaluate options.
+     * @async
+     * @param projectsToPackAndPush An array of MSBuild projects' full file
+     * paths. If a path is a directory, files in that directory are filtered for
+     * `.csproj`, `.fsproj`, and `.vbproj` project files.
+     * See https://github.com/dotnet/sdk/blob/497f334b2862bdf98b30c00ede2fd259ea5f624d/src/Cli/dotnet/Commands/New/MSBuildEvaluation/MSBuildEvaluationResult.cs#L19-L32.\
+     * @returns A promised array of {@link MSBuildProject} instances.
+     * All known MSBuild and NuGet properties are evaluated.
+     * If applicable, a project's "Pack" target is evaluated.
+     */
+    static PackableProjectsToMSBuildProjects(projectsToPackAndPush: string[]): Promise<Promise<MSBuildProject>[]>;
+    static fromJSON(json: string): MSBuildProject;
+}
+/**
+ * ArkType type definitions for internal usage, but may be re-used elsewhere
+ * @internal
+ */
+export declare const _InternalMSBuildEvaluationTypes: Scope<{
+    msbuildEvaluationOutput: {
+        Properties?: Record<string, string> | undefined;
+        Items?: Record<string, {
+            [x: string]: string | undefined;
+            Identity: string;
+            FullPath: string;
+            RootDir: string;
+            Filename: string;
+            Extension: string;
+            RelativeDir: string;
+            Directory: string;
+            RecursiveDir: string;
+            ModifiedTime: string;
+            CreatedTime: string;
+            AccessedTime: string;
+            DefiningProjectFullPath: string;
+            DefiningProjectDirectory: string;
+            DefiningProjectName: string;
+            DefiningProjectExtension: string;
+            SubType?: string | undefined;
+            TargetFrameworkIdentifier?: string | undefined;
+            TargetPlatformMoniker?: string | undefined;
+            CopyUpToDateMarker?: string | undefined;
+            TargetPlatformIdentifier?: string | undefined;
+            TargetFrameworkVersion?: string | undefined;
+            ReferenceAssembly?: string | undefined;
+        }[]> | undefined;
+        TargetResults?: Record<string, {
+            Result: 'Success';
+            Items: {
+                [x: string]: string | undefined;
+                Identity: string;
+                FullPath: string;
+                RootDir: string;
+                Filename: string;
+                Extension: string;
+                RelativeDir: string;
+                Directory: string;
+                RecursiveDir: string;
+                ModifiedTime: string;
+                CreatedTime: string;
+                AccessedTime: string;
+                DefiningProjectFullPath: string;
+                DefiningProjectDirectory: string;
+                DefiningProjectName: string;
+                DefiningProjectExtension: string;
+                SubType?: string | undefined;
+                TargetFrameworkIdentifier?: string | undefined;
+                TargetPlatformMoniker?: string | undefined;
+                CopyUpToDateMarker?: string | undefined;
+                TargetPlatformIdentifier?: string | undefined;
+                TargetFrameworkVersion?: string | undefined;
+                ReferenceAssembly?: string | undefined;
+            }[];
+        } | {
+            Result: 'Failure';
+            Items: never[];
+        }> | undefined;
+    };
+}>;
+/**
+ * Use this in your catch statement or .catch call to return `undefined` when
+ * MSBuild error CSC2012 (e.g. "file in use by another process") is reported.
+ * @param error Probably an Error object
+ * @returns `undefined` if CSC2012 (file in use by another process) occurs
+ */
+export declare function catchCsc2012(error: unknown): undefined;
+export {};
+//# sourceMappingURL=MSBuildProject.d.ts.map

package/mjs/dotnet/MSBuildProject.d.ts.map

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