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

package/mjs/dotnet/MSBuildProject.mjs

@@ -0,0 +1,447 @@
+import { type } from 'arktype';
+import { warn } from 'node:console';
+import { realpath, stat, readdir } from 'node:fs/promises';
+import node_path from 'node:path';
+import { setTimeout } from 'node:timers/promises';
+import { isNativeError } from 'node:util/types';
+import { CaseInsensitiveMap } from '../CaseInsensitiveMap.mjs';
+import { execAsync } from '../utils/execAsync.mjs';
+import { MSBuildProjectProperties } from './MSBuildProjectProperties.mjs';
+import { NugetProjectProperties, NPPGetterNames } from './NugetProjectProperties.mjs';
+
+/**
+ * See [MSBuild well-known item metadata](https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-well-known-item-metadata).
+ * Additional string-type properties may be present (e.g. `{ SubType: "designer" }`).
+ */
+const interface_ItemMetadataBuiltIn = type({
+  '[string]': 'string',
+  /** @example "c:\\source\\repos\\ConsoleApp1\\ConsoleApp1\\bin\\Debug\\net6.0\\ConsoleApp1.dll" */
+  Identity: 'string',
+  /** @example "Designer" */
+  'SubType?': 'string',
+  /** @example ".NETCoreApp" */
+  'TargetFrameworkIdentifier?': 'string',
+  'TargetPlatformMoniker?': 'string',
+  /** @example "c:\\source\\repos\\ConsoleApp1\\ConsoleApp1\\obj\\Debug\\net6.0\\ConsoleApp1.csproj.CopyComplete" */
+  'CopyUpToDateMarker?': 'string',
+  'TargetPlatformIdentifier?': 'string',
+  /** @example "6.0" */
+  'TargetFrameworkVersion?': 'string',
+  /** @example "c:\\source\\repos\\ConsoleApp1\\ConsoleApp1\\obj\\Debug\\net6.0\\ref\\ConsoleApp1.dll" */
+  'ReferenceAssembly?': 'string',
+  /** @example "c:\\source\\repos\\ConsoleApp1\\ConsoleApp1\\bin\\Debug\\net6.0\\ConsoleApp1.dll" */
+  FullPath: 'string',
+  /** @example "c:\\" */
+  RootDir: 'string',
+  /** @example "ConsoleApp1" */
+  Filename: 'string',
+  /** @example ".dll" */
+  Extension: 'string',
+  /** @example "c:\\source\\repos\\ConsoleApp1\\ConsoleApp1\\bin\\Debug\\net6.0\\" */
+  RelativeDir: 'string',
+  /** @example "source\\repos\\ConsoleApp1\\ConsoleApp1\\bin\\Debug\\net6.0\\" */
+  Directory: 'string',
+  RecursiveDir: 'string',
+  /** @example "2023-11-30 13:38:06.5084339" */
+  ModifiedTime: 'string',
+  /** @example "2023-11-30 13:38:06.9308716" */
+  CreatedTime: 'string',
+  /** @example "2023-11-30 13:38:06.9318732" */
+  AccessedTime: 'string',
+  /** @example "C:\\Program Files\\Microsoft Visual Studio\\2022\\Preview\\MSBuild\\Current\\Bin\\amd64\\Microsoft.Common.CurrentVersion.targets" */
+  DefiningProjectFullPath: 'string',
+  /** @example "C:\\Program Files\\Microsoft Visual Studio\\2022\\Preview\\MSBuild\\Current\\Bin\\amd64\\" */
+  DefiningProjectDirectory: 'string',
+  /** @example "Microsoft.Common.CurrentVersion" */
+  DefiningProjectName: 'string',
+  /** @example ".targets" */
+  DefiningProjectExtension: 'string'
+});
+const targetSuccess = type({
+  Result: '\'Success\'',
+  Items: interface_ItemMetadataBuiltIn.array()
+});
+const targetFailure = type({
+  Result: '\'Failure\'',
+  Items: 'never[]'
+});
+const msbuildEvaluationOutput = type({
+  'Properties?': type({
+    '[string]': 'string'
+  }),
+  'Items?': type({
+    '[string]': interface_ItemMetadataBuiltIn.array()
+  }),
+  'TargetResults?': type({
+    '[string]': targetSuccess.or(targetFailure)
+  })
+});
+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) {
+    /** `.assert` instead of `.from` to allow `unknown` JSON.parse return type */
+    const knownObject = msbuildEvaluationOutput.assert(typeof rawMSBuildEvaluation === 'string' ? JSON.parse(rawMSBuildEvaluation) : rawMSBuildEvaluation);
+    this.Properties = knownObject.Properties;
+    this.Items = knownObject.Items;
+    this.TargetResults = knownObject.TargetResults;
+  }
+
+  /**
+   * The specified properties and their values as evaluated by MSBuild Core.
+   * `-getProperty:{propertyName,...}`
+   */
+  Properties;
+  /**
+   * The specified items and their values and associated metadata as evaluated
+   * by MSBuild Core.
+   * `-getItem:{itemName,...}`
+   */
+  Items;
+  /**
+   * The specified Targets and their output values as evaluated by MSBuild
+   * Core.
+   * `-getTargetResult:{targetName,...}`
+   */
+  TargetResults;
+}
+const EvaluationOptions = Object.freeze(type({
+  /**
+   * The project file's full path.
+   */
+  FullName: 'string',
+  /**
+   * User-defined Properties and their values.
+   * { Configuration: "Release" } will cause the MSBuild to first set the
+   * Configuration property  to Release before evaluating the project
+   * or the project's Target(s).
+   * ```txt
+   *   -property:<n>=<v>  Set or override these project-level properties. <n> is
+   *                      the property name, and <v> is the property value. Use a
+   *                      semicolon or a comma to separate multiple properties, or
+   *                      specify each property separately. (Short form: -p)
+   *                      Example:
+   *                        -property:WarningLevel=2;OutDir=bin\Debug\
+   * ```
+   */
+  Property: type({
+    '[string]': 'string'
+  }).as().partial(),
+  /**
+   * The MSBuild Targets to run for evaluation. ["Pack"] is recommended.
+   * Property values may be changed by Targets such as those provided by
+   * dependencies.
+   *
+   * ```txt
+   *   -target:<targets>  Build these targets in this project. Use a semicolon or a
+   *                      comma to separate multiple targets, or specify each
+   *                      target separately. (Short form: -t)
+   *                      Example:
+   *                        -target:Resources;Compile
+   * ```
+   * @default []
+   */
+  Targets: type.string.array().readonly().or('string[]'),
+  /**
+   * MSBuild Items to evaluate. `["Compile"]` will result in the MSBuild output
+   * including {@link MSBuild}
+   */
+  GetItem: type.string.array().readonly().or('string[]'),
+  GetProperty: type.string.array().readonly().or('string[]'),
+  GetTargetResult: type.string.array().readonly().or('string[]')
+}));
+class MSBuildProject {
+  /**
+   * Properties for multi-targeting `dotnet publish` outputs.
+   * These are included in {@link NPPGetterNames.InstanceGettersRecursive}.
+   */
+  static MatrixProperties = Object.freeze(['TargetFramework', 'TargetFrameworks', 'RuntimeIdentifier', 'RuntimeIdentifiers']);
+
+  /**
+   * 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) {
+    this.Items = opts.evaluation.Items ?? {};
+    this.Properties = new NugetProjectProperties(opts.fullPath, new CaseInsensitiveMap(Object.entries(opts.evaluation.Properties ?? {})));
+    this.Targets = opts.projTargets;
+    this.TargetResults = opts.evaluation.TargetResults === undefined ? [] : [opts.evaluation.TargetResults];
+  }
+  Items;
+  Properties;
+  Targets;
+  /**
+   * Allows appending subsequent target results.
+   */
+  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 async GetTargets(projectPath, includeNonPublic = false) {
+    return execAsync(`dotnet msbuild ${projectPath} -targets`, true).then(v => {
+      const targets = v.stdout.split('\n').filter((v, index) => v !== '' && index !== 0).map(v => v.replace('\r', '')).sort((a, b) => a.localeCompare(b));
+      return includeNonPublic ? targets : targets.filter(v => !v.startsWith('_'));
+    });
+  }
+
+  /**
+   * 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 async Evaluate(options) {
+    if (options.GetProperty.length === 0 && options.GetItem.length === 0 && options.GetTargetResult.length === 0) {
+      throw new Error('No MSBuild Property, Item, or TargetResult queries were provided.');
+    }
+    // reminder: args containing spaces and semi-colons MUST be quote-enclosed!
+    options.FullName = MSBuildProjectProperties.GetFullPath(options.FullName);
+    const _pairs = Object.entries(options.Property).filter(p => typeof p[1] === 'string');
+    const property = _pairs.length === 0 ? '' : `-p:"${_pairs.map(pair => pair[0] + '=' + pair[1]).join(';')}"`;
+    const target = options.Targets.length === 0 ? '' : `"-t:${options.Targets.join(';')}"`;
+    const getItem = options.GetItem.length === 0 ? '' : `-getItem:"${options.GetItem.join(',')}"`;
+    const getProperty = options.GetProperty.length === 0 ? '' : `-getProperty:"${options.GetProperty.join(',')}"`;
+    const getTargetResult = options.GetTargetResult.length === 0 ? '' : `-getTargetResult:"${options.GetTargetResult.join(',')}"`;
+    const cmdLine = ['dotnet', 'msbuild', `"${options.FullName}"`, '-restore', property, target, getItem, getProperty, getTargetResult].filter(v => v !== '').join(' ');
+    let stdio = undefined;
+    // may throw
+    while (stdio === undefined) {
+      stdio = await setTimeout(1000, execAsync(cmdLine, true)).then(async p => await p).catch(catchCsc2012);
+    }
+
+    // todo: consider -getResultOutputFile:file
+    //  Redirect output from get* into a file.
+    //
+    //  Example:
+    //  -getProperty:Bar -getResultOutputFile:Biz.txt
+    //  This writes the value of property Bar into Biz.txt.
+
+    /**
+     * The following issues have triggered this code path:
+     * - BaseIntermediateOutputPath must use Unix path separators ('/') on all
+     *   platforms. Even Windows. Otherwise, MSBuild/dotnet will error-exit with
+     *   "The BaseIntermediateOutputPath must end with a trailing slash".
+     */
+    if (stdio.stdout.startsWith('MSBuild version')) {
+      warn(stdio.stdout);
+      throw new Error('dotnet msbuild was expected to output JSON, but output its version header instead.');
+    }
+    let rawOutput = undefined;
+    if (stdio.stdout.startsWith('{')) {
+      /** stdout is JSON string */
+      rawOutput = stdio.stdout;
+    } else if (options.GetProperty.length > 0 && options.GetProperty[0] !== undefined) {
+      rawOutput = {
+        Properties: {
+          [options.GetProperty[0]]: String(JSON.parse(stdio.stdout))
+        }
+      };
+    } else {
+      throw new Error('Dotnet/MSBuild evaluation output is not a string nor JSON object or array.');
+    }
+    const evaluation = new MSBuildEvaluationOutput(rawOutput);
+    return new MSBuildProject({
+      fullPath: options.FullName,
+      projTargets: await MSBuildProject.GetTargets(options.FullName),
+      evaluation
+    });
+  }
+
+  /**
+   * 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 async PackableProjectsToMSBuildProjects(projectsToPackAndPush) {
+    const dirEntriesPromise = toDirEntries(typeof projectsToPackAndPush === 'string' ? [projectsToPackAndPush] : projectsToPackAndPush);
+    const projectPromises = await dirEntriesPromise.then(direntArray => direntArray.map(element => convertDirentToMSBuildProject(element)));
+    return projectPromises;
+
+    /**
+     * Map an array of filesystem paths to {@link Dirent} instances representing project files.
+     * @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 An promised array of Dirent instances for discovered project files.
+     */
+    async function toDirEntries(projectsToPackAndPush) {
+      const dirEntries = await Promise.all(projectsToPackAndPush.map(async proj => {
+        proj = await realpath(makeAbsolute(proj));
+        const stats = await stat(proj);
+        let entries;
+        if (stats.isFile()) {
+          entries = await readdir(node_path.dirname(proj), {
+            withFileTypes: true
+          });
+          const dirent = entries.find(v => node_path.join(
+          // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion
+          v.path ?? v.parentPath, v.name) === proj);
+          if (dirent) return dirent;else throw new Error(`file "${proj}" not found. It may have been moved or deleted.`);
+        }
+        if (!stats.isDirectory()) throw new Error(`"${proj}" is not a file or directory`);
+        entries = await readdir(proj, {
+          withFileTypes: true
+        });
+        return entries.filter(v => v.isFile() && (v.name.endsWith('.csproj') || v.name.endsWith('.fsproj') || v.name.endsWith('.vbproj')));
+      }));
+      return dirEntries.flat();
+    }
+
+    /**
+     * Map a {@link Dirent} instance to an {@link MSBuildProject} instance.
+     * @param dirent A {@link Dirent} instance. This instance should be an MSBuild project file.
+     * @returns An instance of {@link MSBuildProject} evaluated with the `Pack` target result, if applicable. Evaluated properties will be those whose names are returned by {@link NPPGetterNames.InstanceGettersRecursive}.
+     */
+    async function convertDirentToMSBuildProject(dirent) {
+      const fullPath = node_path.join(
+      // condition required for compatibility. `.path` was deprecated, but `.parentPath` is not available in our node minversion
+      dirent.path ?? dirent.parentPath, dirent.name);
+      const projTargets = MSBuildProject.GetTargets(fullPath);
+      const evalTargets = await projTargets.then(v => v.includes('Pack') ? ['Pack'] : []);
+      // this might be too long for a command line. What was it on Windows?
+      // 2^15 (32,768) character limit for command lines?
+      const getProperties = NPPGetterNames.InstanceGettersRecursive;
+      return await MSBuildProject.Evaluate(EvaluationOptions.from({
+        FullName: fullPath,
+        GetItem: [],
+        GetProperty: getProperties,
+        GetTargetResult: [],
+        Property: {},
+        Targets: evalTargets
+      }));
+    }
+  }
+  static fromJSON(json) {
+    const parsed = T_PseudoMSBPInstance.assert(JSON.parse(json));
+    type.true.assert(Reflect.setPrototypeOf(parsed, MSBuildProject.prototype));
+    type.true.assert(Reflect.setPrototypeOf(parsed.Properties, NugetProjectProperties.prototype));
+    parsed.Properties = T_NPP.assert(parsed.Properties);
+    return T_MSBuildProject.assert(parsed);
+  }
+}
+const T_MSBuildProject = type.instanceOf(MSBuildProject);
+const T_NPP = type.instanceOf(NugetProjectProperties);
+const T_PseudoMSBPInstance = type({
+  Items: type({
+    '[string]': type({
+      '[string]': 'string',
+      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'
+    }).array()
+  }),
+  Properties: type.Record('string', 'string').or(T_NPP),
+  Targets: type.string.array(),
+  TargetResults: msbuildEvaluationOutput.get('TargetResults').exclude('undefined').array()
+});
+
+/**
+ * ArkType type definitions for internal usage, but may be re-used elsewhere
+ * @internal
+ */
+const _InternalMSBuildEvaluationTypes = type.scope({
+  msbuildEvaluationOutput
+});
+
+/**
+ * Resolve a path if it is not already absolute.
+ * @param _path A filesystem path.
+ * @returns A full path to a filesystem entry. The path is unchecked for whether or not the path (or its parts) exist.
+ */
+function makeAbsolute(_path) {
+  return node_path.isAbsolute(_path) ? _path : node_path.resolve(_path);
+}
+
+/**
+ * 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
+ */
+function catchCsc2012(error) {
+  if (isNativeError(error)) {
+    // check for error reported when "file in use by another process" i.e. EBUSY
+    // (UNIX), NTSTATUS.ERROR_SHARING_VIOLATION == 0x20 == 32 (Windows)
+    if ('stderr' in error && typeof error.stderr === 'string' && /^CSC ?:.+CS2012:/gm.test(
+    // '\uFF1A'.normalize('NFKC') === ':' === true;
+    error.stderr.normalize('NFKC'))) {
+      return undefined; /* retry */
+    }
+    /**
+     * some known warnings/errors:
+     * - warning MSB3073:
+     *   The command "dotnet tool list kuinox.nupkgdeterministicator"
+     *   exited with code 145.
+     *    > $ dotnet tool list kuinox.nupkgdeterministicator
+     *    > The command could not be loaded, possibly because:
+     *    >   * You intended to execute a .NET application:
+     *    >       The application 'tool' does not exist.
+     *    >   * You intended to execute a .NET SDK command:
+     *    >       No .NET SDKs were found.
+     *    >
+     *    > Download a .NET SDK:
+     *    > https://aka.ms/dotnet/download
+     *    >
+     *    > Learn about SDK resolution:
+     *    > https://aka.ms/dotnet/sdk-not-found
+     */else throw error;
+  } else throw new Error('unknown error', {
+    cause: error
+  });
+}
+export { EvaluationOptions, MSBuildEvaluationOutput, MSBuildProject, _InternalMSBuildEvaluationTypes, catchCsc2012 };
+//# sourceMappingURL=MSBuildProject.mjs.map

package/mjs/dotnet/MSBuildProject.mjs.map

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

package/mjs/dotnet/MSBuildProjectProperties.d.ts

@@ -0,0 +1,170 @@
+import { CaseInsensitiveMap } from '../CaseInsensitiveMap.js';
+import type { BaseClass, ClassLike } from '../utils/reflection.js';
+/**
+ * Known properties. Additional properties may be added upon request.
+ *
+ * todo: add Reserved properties, Well-Known properties, Common properties, and more. Maybe as sub classes.
+ * See:
+ * - {@link https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-reserved-and-well-known-properties?view=vs-2022 MSBuild Reserved and Well-known Properties}
+ * - {@link https://learn.microsoft.com/en-us/visualstudio/msbuild/common-msbuild-project-properties?view=vs-2022 Common MSBuild project properties}
+ * - {@link https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props Microsoft.NET.Sdk}
+ * - {@link https://learn.microsoft.com/en-us/aspnet/core/razor-pages/web-sdk?view=aspnetcore-8.0&toc=%2Fdotnet%2Fnavigate%2Ftools-diagnostics%2Ftoc.json&bc=%2Fdotnet%2Fbreadcrumb%2Ftoc.json#properties Microsoft.NET.Sdk.Web}
+ * - {@link https://learn.microsoft.com/en-us/aspnet/core/razor-pages/sdk?view=aspnetcore-8.0&toc=%2Fdotnet%2Fnavigate%2Ftools-diagnostics%2Ftoc.json&bc=%2Fdotnet%2Fbreadcrumb%2Ftoc.json Microsoft.NET.Sdk.Razor}
+ * - {@link https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props-desktop Microsoft.NET.Sdk.Desktop}
+ */
+export declare class MSBuildProjectProperties {
+    /**
+     * Resolve the given path if it is not absolute. If the path exists, it is returned. Else, an Error is thrown.
+     * @param path The full file path of an MSBuild project.
+     * @returns The absolute path to the MSBuild project file.
+     * @throws {Error} if the path cannot be resolved to an existing file.
+     */
+    static GetFullPath(path: string): string;
+    /**
+     * Note: This method may remove elements from {@link properties}.\
+     * Try to get an element from {@link properties} by its {@link key}.
+     * If an element is found, it is removed and the value of the element is returned.
+     * Otherwise, `undefined` is returned.
+     * @param properties The CaseInsensitiveMap of properties passed to the constructor.
+     * @param key The key of the property to get from {@link properties}
+     * @returns If found, the value of the `[string, string]` tuple found in {@link properties}. Else, `undefined`.
+     */
+    protected static getAndForget(properties: CaseInsensitiveMap<string, string>, key: string): string | undefined;
+    private _msbuildProjectFullPath;
+    private _assemblyName;
+    private _baseIntermediateOutputPath;
+    private _baseOutputPath;
+    private _description;
+    private _intermediateOutputPath;
+    private _outDir;
+    private _outputPath;
+    private _runtimeIdentifier;
+    private _runtimeIdentifiers;
+    private _targetFramework;
+    private _targetFrameworks;
+    private _version;
+    private _versionPrefix;
+    private _versionSuffix;
+    constructor(msbuildProjectFullPath: string, properties: CaseInsensitiveMap<string, string>);
+    get MSBuildProjectFullPath(): string;
+    /**
+     * @returns The name of the assembly.
+     *
+     * Default: {@link https://learn.microsoft.com/en-us/visualstudio/msbuild/msbuild-reserved-and-well-known-properties#:~:text=MSBuildProjectDirectory,-Reserved MSBuildProjectDirectory}
+     */
+    get AssemblyName(): string;
+    /**
+     * @returns The top-level folder where all configuration-specific intermediate output
+     * folders are created. The default value is `obj\`.
+     * @example
+     * ```xml
+     * <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>
+     * ```
+     */
+    get BaseIntermediateOutputPath(): string;
+    /**
+     * @returns The base path for the output file.
+     * If it's set, MSBuild uses `OutputPath = $(BaseOutputPath)\$(Configuration)\`.
+     * @example ```xml
+     * <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
+     * ```
+     */
+    get BaseOutputPath(): string;
+    /**
+     * A long description for the assembly.
+     * If {@link NugetProperties.PackageDescription} is not specified, then this property is also used as the description of the package.
+     * @returns The value of the `Description` property.
+     */
+    get Description(): string;
+    /**
+     * @returns The full intermediate output path as derived from
+     * {@link BaseIntermediateOutputPath}, if no path is specified.
+     * @example "obj\\debug\\"
+     */
+    get IntermediateOutput(): string;
+    /**
+     * @returns The final output location for the project or solution.
+     * When you build a solution, OutDir can be used to gather multiple project outputs in one location.
+     * In addition, OutDir is included in AssemblySearchPaths used for resolving references.
+     * @example
+     * `bin/Debug`
+     */
+    get OutDir(): string;
+    /**
+     * @returns The path to the output directory, relative to the project
+     * directory.
+     * @example
+     * `bin/Debug`
+     * /// non-AnyCPU builds
+     * `bin/Debug/${Platform}`
+     */
+    get OutputPath(): string;
+    /**
+     * Set Version -OR- VersionPrefix.
+     * @returns The value of the `Version` property.
+     *
+     * Default: `"1.0.0"`
+     */
+    get Version(): string;
+    /**
+     * Set Version -OR- VersionPrefix.\
+     * Setting {@link NugetProperties.PackageVersion} overwrites {@link VersionPrefix}
+     * @returns The MAJOR.MINOR.PATCH string of the version.
+     * @see {@link VersionSuffix}
+     */
+    get VersionPrefix(): string;
+    /**
+     * The effect of this property on the package version depends on the values of the Version and VersionPrefix properties, as shown in the following table:
+     * | Properties with values | Package version |
+     * | ---------------------- | --------------- |
+     * | None                   | 1.0.0           |
+     * | Version                | $(Version)      |
+     * | VersionPrefix only     | $(VersionPrefix) |
+     * | VersionSuffix only     | 1.0.0-$(VersionSuffix) |
+     * | VersionPrefix and VersionSuffix | $(VersionPrefix)-$(VersionSuffix) |
+     * \
+     * Setting {@link PackageVersion} overwrites {@link VersionSuffix}
+     * @returns The string appended to the end of the MAJOR.MINOR.PATCH semver string (i.e. {@link VersionPrefix})
+     */
+    get VersionSuffix(): string;
+    /**
+     * @returns The {@link https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props#targetframework Target Framework}
+     * @see
+     * https://learn.microsoft.com/en-us/nuget/reference/target-frameworks#supported-frameworks
+     * https://learn.microsoft.com/en-us/dotnet/standard/frameworks
+     */
+    get TargetFramework(): string;
+    /**
+     * @returns The {@link https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props#targetframeworks Target Frameworks} (plural)
+     * @see
+     * https://learn.microsoft.com/en-us/nuget/reference/target-frameworks#supported-frameworks
+     * https://learn.microsoft.com/en-us/dotnet/standard/frameworks
+     */
+    get TargetFrameworks(): string;
+    /**
+     * @returns
+     * > The {@link https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props#runtimeidentifier `Runtime Identifier`} property lets you specify a single runtime
+     * > identifier (RID) for the project. The RID enables publishing a
+     * > self-contained deployment.
+     * @see
+     * https://learn.microsoft.com/en-us/dotnet/core/rid-catalog
+     */
+    get RuntimeIdentifier(): string;
+    /**
+     * @returns
+     * > The {@link https://learn.microsoft.com/en-us/dotnet/core/project-sdk/msbuild-props#runtimeidentifiers `RuntimeIdentifiers`} property lets you specify a
+     * > semicolon-delimited list of runtime identifiers (RIDs) for the project.
+     * > Use this property if you need to publish for multiple runtimes.
+     * > `RuntimeIdentifiers` is used at restore time to ensure the right assets
+     * > are in the graph.
+     * @see
+     * https://learn.microsoft.com/en-us/dotnet/core/rid-catalog
+     */
+    get RuntimeIdentifiers(): string;
+}
+export type Class_MSBPP = ClassLike<BaseClass<typeof MSBuildProjectProperties & {
+    getAndForget: ProtectedMember<typeof MSBuildProjectProperties.getAndForget>;
+}>>;
+type ProtectedMember<T> = T;
+export {};
+//# sourceMappingURL=MSBuildProjectProperties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MSBuildProjectProperties.d.ts","sourceRoot":"","sources":["../../src/dotnet/MSBuildProjectProperties.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnE;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAwB;IAGnC;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQxC;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM,CAAC,YAAY,CAC3B,UAAU,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9C,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS;IAWrB,OAAO,CAAC,uBAAuB,CAAqB;IACpD,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,2BAA2B,CAAqB;IACxD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,uBAAuB,CAAqB;IACpD,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,mBAAmB,CAAqB;IAChD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,iBAAiB,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,cAAc,CAAqB;gBAIzC,sBAAsB,EAAE,MAAM,EAC9B,UAAU,EAAE,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC;IAiDhD,IAAI,sBAAsB,IAAI,MAAM,CAEnC;IAED;;;;OAIG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;;;OAOG;IACH,IAAI,0BAA0B,IAAI,MAAM,CAEvC;IAED;;;;;;OAMG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;OAIG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;;;;OAMG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;;OAOG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;OAKG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;OAKG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED;;;;;OAKG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;;;;;OAOG;IACH,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED;;;;;;;;;OASG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;CACF;AAGD,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,wBAAwB,GAAG;IAE9E,YAAY,EAAE,eAAe,CAAC,OAAO,wBAAwB,CAAC,YAAY,CAAC,CAAC;CAC7E,CAAC,CAAC,CAAC;AAEJ,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC"}