@react-native-windows/cli 0.0.0-canary.28 → 0.0.0-canary.280

package/lib-commonjs/utils/msbuildtools.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const os_1 = require("os");
+const fs_1 = __importDefault(require("@react-native-windows/fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = __importDefault(require("child_process"));
+const chalk_1 = __importDefault(require("chalk"));
+const shelljs_1 = __importDefault(require("shelljs"));
+const version_1 = __importDefault(require("./version"));
+const checkRequirements = __importStar(require("./checkRequirements"));
+const commandWithProgress_1 = require("./commandWithProgress");
+const child_process_2 = require("child_process");
+const vsInstalls_1 = require("./vsInstalls");
+const telemetry_1 = require("@react-native-windows/telemetry");
+class MSBuildTools {
+    /**
+     * @param version is something like 17.0 for 2022
+     * @param installationPath  Path to installation root
+     * @param installationVersion is the full version e.g. 17.3.32929.385
+     */
+    constructor(version, installationPath, installationVersion) {
+        this.version = version;
+        this.installationPath = installationPath;
+        this.installationVersion = installationVersion;
+    }
+    /**
+     * @returns directory where x64 msbuild can be found
+     */
+    msbuildPath() {
+        return path_1.default.join(this.installationPath, 'MSBuild/Current/Bin/amd64');
+    }
+    cleanProject(slnFile) {
+        const cmd = `"${path_1.default.join(this.msbuildPath(), 'msbuild.exe')}" "${slnFile}" /t:Clean`;
+        const results = child_process_1.default.execSync(cmd).toString().split(os_1.EOL);
+        results.forEach(result => console.log(chalk_1.default.white(result)));
+    }
+    async restorePackageConfigs(slnFile, buildArch, buildType) {
+        const text = 'Restoring NuGet packages ';
+        const spinner = (0, commandWithProgress_1.newSpinner)(text);
+        await (0, commandWithProgress_1.commandWithProgress)(spinner, text, path_1.default.join(this.msbuildPath(), 'msbuild.exe'), [
+            slnFile,
+            '/t:Restore',
+            '/p:RestoreProjectStyle=PackagesConfig',
+            '/p:RestorePackagesConfig=true',
+            `/p:Platform=${buildArch}`,
+            `/p:Configuration=${buildType}`,
+        ], true, 'MSBuildError');
+    }
+    async buildProject(slnFile, buildType, buildArch, msBuildProps, verbose, target, buildLogDirectory, singleproc) {
+        (0, commandWithProgress_1.newSuccess)(`Found Solution: ${slnFile}`);
+        (0, commandWithProgress_1.newInfo)(`Build configuration: ${buildType}`);
+        (0, commandWithProgress_1.newInfo)(`Build platform: ${buildArch}`);
+        const verbosityOption = verbose ? 'normal' : 'minimal';
+        const defaultLogDirectory = path_1.default.dirname(slnFile);
+        const logPrefix = path_1.default.join(buildLogDirectory || defaultLogDirectory, `msbuild_${process.pid}_${target}`);
+        const errorLog = logPrefix + '.err';
+        const warnLog = logPrefix + '.wrn';
+        const binlog = `:${logPrefix}.binlog`;
+        const args = [
+            `/clp:NoSummary;NoItemAndPropertyList;Verbosity=${verbosityOption}`,
+            '/nologo',
+            `/p:Configuration=${buildType}`,
+            `/p:Platform=${buildArch}`,
+            '/p:AppxBundle=Never',
+            `/bl${binlog}`,
+            `/flp1:errorsonly;logfile=${errorLog}`,
+            `/flp2:warningsonly;logfile=${warnLog}`,
+        ];
+        // Building projects in parallel increases compiler memory usage and
+        // doesn't lead to dramatic performance gains (See #4739). Only enable
+        // parallel builds on machines with >16GB of memory to avoid OOM errors
+        const highMemory = (0, os_1.totalmem)() > 16 * 1024 * 1024 * 1024;
+        const enableParallelBuilds = singleproc !== true && highMemory;
+        if (enableParallelBuilds) {
+            args.push('/maxCpuCount');
+        }
+        if (target === 'build') {
+            args.push('/restore', '/p:RestorePackagesConfig=true');
+        }
+        else {
+            args.push(`/t:Deploy`);
+        }
+        Object.keys(msBuildProps).forEach(key => {
+            args.push(`/p:${key}=${msBuildProps[key]}`);
+        });
+        try {
+            checkRequirements.isWinSdkPresent('10.0');
+        }
+        catch (e) {
+            (0, commandWithProgress_1.newError)(e.message);
+            throw e;
+        }
+        if (verbose) {
+            console.log(`Running MSBuild with args ${args.join(' ')}`);
+        }
+        const progressName = target === 'deploy' ? 'Deploying Solution' : 'Building Solution';
+        const spinner = (0, commandWithProgress_1.newSpinner)(progressName);
+        try {
+            await (0, commandWithProgress_1.commandWithProgress)(spinner, progressName, path_1.default.join(this.msbuildPath(), 'msbuild.exe'), [slnFile].concat(args), verbose, 'MSBuildError');
+        }
+        catch (e) {
+            let error = e;
+            if (e instanceof telemetry_1.CodedError) {
+                const origCodedError = e;
+                if (origCodedError.type === 'MSBuildError') {
+                    // Try to parse msbuild errors from errorLog
+                    const errorLogContents = (await fs_1.default.readFile(errorLog))
+                        .toString()
+                        .split(os_1.EOL)
+                        .filter(s => s)
+                        .map(s => s.trim());
+                    if (errorLogContents.length > 0) {
+                        const firstMessage = errorLogContents[0];
+                        error = new telemetry_1.CodedError('MSBuildError', firstMessage, origCodedError.data);
+                        // Hide error messages in a field that won't automatically get reported
+                        // with telemetry but is still available to be parsed and sanitized
+                        error.msBuildErrorMessages = errorLogContents;
+                    }
+                }
+            }
+            throw error;
+        }
+        // If we have no errors, delete the error log when we're done
+        if ((await fs_1.default.stat(errorLog)).size === 0) {
+            await fs_1.default.unlink(errorLog);
+        }
+    }
+    static findAvailableVersion(buildArch, verbose, prerelease) {
+        // https://aka.ms/vs/workloads
+        const requires = [
+            'Microsoft.Component.MSBuild',
+            getVCToolsByArch(buildArch),
+        ];
+        const minVersion = process.env.MinimumVisualStudioVersion ||
+            process.env.VisualStudioVersion ||
+            '17.11.0';
+        const vsInstallation = (0, vsInstalls_1.findLatestVsInstall)({
+            requires,
+            minVersion,
+            verbose,
+            prerelease,
+        });
+        if (!vsInstallation) {
+            if (process.env.MinimumVisualStudioVersion != null) {
+                throw new telemetry_1.CodedError('NoMSBuild', `MSBuild tools not found for version ${process.env.MinimumVisualStudioVersion} (from environment). Make sure all required components have been installed`, {
+                    MinimumVisualStudioVersionFromEnv: process.env.MinimumVisualStudioVersion,
+                });
+            }
+            else if (process.env.VisualStudioVersion != null) {
+                throw new telemetry_1.CodedError('NoMSBuild', `MSBuild tools not found for version ${process.env.VisualStudioVersion} (from environment). Make sure all required components have been installed`, { VisualStudioVersionFromEnv: process.env.VisualStudioVersion });
+            }
+            else {
+                throw new telemetry_1.CodedError('NoMSBuild', `Could not find MSBuild with VCTools for Visual Studio ${minVersion} or later. Make sure all required components have been installed`, { minVersion: minVersion });
+            }
+        }
+        const toolsPath = path_1.default.join(vsInstallation.installationPath, 'MSBuild/Current/Bin/amd64');
+        if (fs_1.default.existsSync(toolsPath)) {
+            if (verbose) {
+                (0, commandWithProgress_1.newSuccess)(`Found compatible MSBuild at ${toolsPath} (${vsInstallation.installationVersion})`);
+            }
+            return new MSBuildTools(minVersion, vsInstallation.installationPath, vsInstallation.installationVersion);
+        }
+        else {
+            throw new telemetry_1.CodedError('NoMSBuild', `MSBuild path '${toolsPath} does not exist'`);
+        }
+    }
+    static getAllAvailableUAPVersions() {
+        const results = [];
+        const programFilesFolder = process.env['ProgramFiles(x86)'] || process.env.ProgramFiles;
+        // No Program Files folder found, so we won't be able to find UAP SDK
+        if (!programFilesFolder) {
+            return results;
+        }
+        let uapFolderPath = path_1.default.join(programFilesFolder, 'Windows Kits', '10', 'Platforms', 'UAP');
+        if (!shelljs_1.default.test('-e', uapFolderPath)) {
+            // Check other installation folder from reg
+            const sdkFolder = getSDK10InstallationFolder();
+            if (sdkFolder) {
+                uapFolderPath = path_1.default.join(sdkFolder, 'Platforms', 'UAP');
+            }
+        }
+        // No UAP SDK exists on this machine
+        if (!shelljs_1.default.test('-e', uapFolderPath)) {
+            return results;
+        }
+        shelljs_1.default
+            .ls(uapFolderPath)
+            .filter(uapDir => shelljs_1.default.test('-d', path_1.default.join(uapFolderPath, uapDir)))
+            .map(version_1.default.tryParse)
+            .forEach(version => version && results.push(version));
+        return results;
+    }
+    evaluateMSBuildProperties(solutionFile, projectFile, propertyNames, extraMsBuildProps) {
+        const spinner = (0, commandWithProgress_1.newSpinner)('Running Eval-MsBuildProperties.ps1');
+        try {
+            const msbuildEvalScriptPath = path_1.default.resolve(__dirname, '..', '..', 'src', 'powershell', 'Eval-MsBuildProperties.ps1');
+            let command = `${commandWithProgress_1.powershell} -ExecutionPolicy Unrestricted -NoProfile "${msbuildEvalScriptPath}" -SolutionFile '${solutionFile}' -ProjectFile '${projectFile}' -MSBuildPath '${this.msbuildPath()}'`;
+            if (propertyNames && propertyNames.length > 0) {
+                command += ` -PropertyNames '${propertyNames.join(',')}'`;
+            }
+            if (extraMsBuildProps) {
+                command += " -ExtraMSBuildProps '";
+                for (const extraProp in extraMsBuildProps) {
+                    if (!(extraProp in Object.prototype)) {
+                        command += `,${extraProp}=${extraMsBuildProps[extraProp]}`;
+                    }
+                }
+                command += "'";
+            }
+            const commandOutput = (0, child_process_2.execSync)(command).toString();
+            spinner.succeed();
+            const properties = JSON.parse(commandOutput);
+            spinner.succeed();
+            return properties;
+        }
+        catch (e) {
+            spinner.fail('Running Eval-MsBuildProperties.ps1 failed: ' + e.message);
+            throw e;
+        }
+    }
+}
+exports.default = MSBuildTools;
+function getVCToolsByArch(buildArch) {
+    switch (buildArch) {
+        case 'x86':
+        case 'x64':
+            return 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64';
+        case 'ARM64':
+            return 'Microsoft.VisualStudio.Component.VC.Tools.ARM64';
+    }
+}
+function getSDK10InstallationFolder() {
+    const folder = '';
+    const execString = 'reg query "HKLM\\SOFTWARE\\Microsoft\\Microsoft SDKs\\Windows\\v10.0" /s /v InstallationFolder /reg:32';
+    let output;
+    try {
+        output = (0, child_process_2.execSync)(execString).toString();
+    }
+    catch (e) {
+        return folder;
+    }
+    const re = /\\Microsoft SDKs\\Windows\\v10.0\s*InstallationFolder\s+REG_SZ\s+(.*)/gim;
+    const match = re.exec(output);
+    if (match) {
+        return match[1];
+    }
+    return folder;
+}
+//# sourceMappingURL=msbuildtools.js.map

package/lib-commonjs/utils/msbuildtools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msbuildtools.js","sourceRoot":"","sources":["../../src/utils/msbuildtools.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,2BAAiC;AACjC,kEAA0C;AAC1C,gDAAwB;AACxB,kEAA0C;AAC1C,kDAA0B;AAC1B,sDAA4B;AAC5B,wDAAgC;AAChC,uEAAyD;AACzD,+DAO+B;AAC/B,iDAAuC;AAEvC,6CAAiD;AACjD,+DAA2D;AAE3D,MAAqB,YAAY;IAC/B;;;;OAIG;IACH,YACkB,OAAe,EACf,gBAAwB,EACxB,mBAA2B;QAF3B,YAAO,GAAP,OAAO,CAAQ;QACf,qBAAgB,GAAhB,gBAAgB,CAAQ;QACxB,wBAAmB,GAAnB,mBAAmB,CAAQ;IAC1C,CAAC;IAEJ;;OAEG;IACH,WAAW;QACT,OAAO,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC;IACvE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,MAAM,GAAG,GAAG,IAAI,cAAI,CAAC,IAAI,CACvB,IAAI,CAAC,WAAW,EAAE,EAClB,aAAa,CACd,MAAM,OAAO,YAAY,CAAC;QAC3B,MAAM,OAAO,GAAG,uBAAa,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,QAAG,CAAC,CAAC;QAClE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,OAAY,EACZ,SAAoB,EACpB,SAAsB;QAEtB,MAAM,IAAI,GAAG,2BAA2B,CAAC;QACzC,MAAM,OAAO,GAAG,IAAA,gCAAU,EAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAA,yCAAmB,EACvB,OAAO,EACP,IAAI,EACJ,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,EAC5C;YACE,OAAO;YACP,YAAY;YACZ,uCAAuC;YACvC,+BAA+B;YAC/B,eAAe,SAAS,EAAE;YAC1B,oBAAoB,SAAS,EAAE;SAChC,EACD,IAAI,EACJ,cAAc,CACf,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,OAAe,EACf,SAAsB,EACtB,SAAoB,EACpB,YAAoC,EACpC,OAAgB,EAChB,MAA0B,EAC1B,iBAAqC,EACrC,UAAoB;QAEpB,IAAA,gCAAU,EAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;QACzC,IAAA,6BAAO,EAAC,wBAAwB,SAAS,EAAE,CAAC,CAAC;QAC7C,IAAA,6BAAO,EAAC,mBAAmB,SAAS,EAAE,CAAC,CAAC;QAExC,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACvD,MAAM,mBAAmB,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,iBAAiB,IAAI,mBAAmB,EACxC,WAAW,OAAO,CAAC,GAAG,IAAI,MAAM,EAAE,CACnC,CAAC;QAEF,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;QACpC,MAAM,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;QAEnC,MAAM,MAAM,GAAG,IAAI,SAAS,SAAS,CAAC;QAEtC,MAAM,IAAI,GAAG;YACX,kDAAkD,eAAe,EAAE;YACnE,SAAS;YACT,oBAAoB,SAAS,EAAE;YAC/B,eAAe,SAAS,EAAE;YAC1B,qBAAqB;YACrB,MAAM,MAAM,EAAE;YACd,4BAA4B,QAAQ,EAAE;YACtC,8BAA8B,OAAO,EAAE;SACxC,CAAC;QAEF,oEAAoE;QACpE,sEAAsE;QACtE,uEAAuE;QACvE,MAAM,UAAU,GAAG,IAAA,aAAQ,GAAE,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACxD,MAAM,oBAAoB,GAAG,UAAU,KAAK,IAAI,IAAI,UAAU,CAAC;QAE/D,IAAI,oBAAoB,EAAE;YACxB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAC3B;QAED,IAAI,MAAM,KAAK,OAAO,EAAE;YACtB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,+BAA+B,CAAC,CAAC;SACxD;aAAM;YACL,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;SACxB;QAED,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACtC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,IAAI;YACF,iBAAiB,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;SAC3C;QAAC,OAAO,CAAC,EAAE;YACV,IAAA,8BAAQ,EAAE,CAAW,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,CAAC,CAAC;SACT;QAED,IAAI,OAAO,EAAE;YACX,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SAC5D;QAED,MAAM,YAAY,GAChB,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,mBAAmB,CAAC;QACnE,MAAM,OAAO,GAAG,IAAA,gCAAU,EAAC,YAAY,CAAC,CAAC;QACzC,IAAI;YACF,MAAM,IAAA,yCAAmB,EACvB,OAAO,EACP,YAAY,EACZ,cAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,EAC5C,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EACtB,OAAO,EACP,cAAc,CACf,CAAC;SACH;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,CAAC,YAAY,sBAAU,EAAE;gBAC3B,MAAM,cAAc,GAAG,CAAe,CAAC;gBACvC,IAAI,cAAc,CAAC,IAAI,KAAK,cAAc,EAAE;oBAC1C,4CAA4C;oBAC5C,MAAM,gBAAgB,GAAG,CAAC,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;yBACnD,QAAQ,EAAE;yBACV,KAAK,CAAC,QAAG,CAAC;yBACV,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;yBACd,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBACtB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE;wBAC/B,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;wBACzC,KAAK,GAAG,IAAI,sBAAU,CACpB,cAAc,EACd,YAAY,EACZ,cAAc,CAAC,IAAI,CACpB,CAAC;wBACF,uEAAuE;wBACvE,mEAAmE;wBAClE,KAAa,CAAC,oBAAoB,GAAG,gBAAgB,CAAC;qBACxD;iBACF;aACF;YACD,MAAM,KAAK,CAAC;SACb;QACD,6DAA6D;QAC7D,IAAI,CAAC,MAAM,YAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE;YACxC,MAAM,YAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;SAC3B;IACH,CAAC;IAED,MAAM,CAAC,oBAAoB,CACzB,SAAoB,EACpB,OAAgB,EAChB,UAAoB;QAEpB,8BAA8B;QAC9B,MAAM,QAAQ,GAAG;YACf,6BAA6B;YAC7B,gBAAgB,CAAC,SAAS,CAAC;SAC5B,CAAC;QACF,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,0BAA0B;YACtC,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC/B,SAAS,CAAC;QACZ,MAAM,cAAc,GAAG,IAAA,gCAAmB,EAAC;YACzC,QAAQ;YACR,UAAU;YACV,OAAO;YACP,UAAU;SACX,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,EAAE;YACnB,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,IAAI,EAAE;gBAClD,MAAM,IAAI,sBAAU,CAClB,WAAW,EACX,uCAAuC,OAAO,CAAC,GAAG,CAAC,0BAA0B,4EAA4E,EACzJ;oBACE,iCAAiC,EAC/B,OAAO,CAAC,GAAG,CAAC,0BAA0B;iBACzC,CACF,CAAC;aACH;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,EAAE;gBAClD,MAAM,IAAI,sBAAU,CAClB,WAAW,EACX,uCAAuC,OAAO,CAAC,GAAG,CAAC,mBAAmB,4EAA4E,EAClJ,EAAC,0BAA0B,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAC,CAC9D,CAAC;aACH;iBAAM;gBACL,MAAM,IAAI,sBAAU,CAClB,WAAW,EACX,yDAAyD,UAAU,kEAAkE,EACrI,EAAC,UAAU,EAAE,UAAU,EAAC,CACzB,CAAC;aACH;SACF;QAED,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,cAAc,CAAC,gBAAgB,EAC/B,2BAA2B,CAC5B,CAAC;QAEF,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE;YAC5B,IAAI,OAAO,EAAE;gBACX,IAAA,gCAAU,EACR,+BAA+B,SAAS,KAAK,cAAc,CAAC,mBAAmB,GAAG,CACnF,CAAC;aACH;YACD,OAAO,IAAI,YAAY,CACrB,UAAU,EACV,cAAc,CAAC,gBAAgB,EAC/B,cAAc,CAAC,mBAAmB,CACnC,CAAC;SACH;aAAM;YACL,MAAM,IAAI,sBAAU,CAClB,WAAW,EACX,iBAAiB,SAAS,kBAAkB,CAC7C,CAAC;SACH;IACH,CAAC;IAED,MAAM,CAAC,0BAA0B;QAC/B,MAAM,OAAO,GAAc,EAAE,CAAC;QAE9B,MAAM,kBAAkB,GACtB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAC/D,qEAAqE;QACrE,IAAI,CAAC,kBAAkB,EAAE;YACvB,OAAO,OAAO,CAAC;SAChB;QAED,IAAI,aAAa,GAAG,cAAI,CAAC,IAAI,CAC3B,kBAAkB,EAClB,cAAc,EACd,IAAI,EACJ,WAAW,EACX,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,iBAAK,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE;YACpC,2CAA2C;YAC3C,MAAM,SAAS,GAAG,0BAA0B,EAAE,CAAC;YAC/C,IAAI,SAAS,EAAE;gBACb,aAAa,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;aAC1D;SACF;QAED,oCAAoC;QACpC,IAAI,CAAC,iBAAK,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,EAAE;YACpC,OAAO,OAAO,CAAC;SAChB;QAED,iBAAK;aACF,EAAE,CAAC,aAAa,CAAC;aACjB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAK,CAAC,IAAI,CAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;aACpE,GAAG,CAAC,iBAAO,CAAC,QAAQ,CAAC;aACrB,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAExD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,yBAAyB,CACvB,YAAoB,EACpB,WAAmB,EACnB,aAAwB,EACxB,iBAA0C;QAE1C,MAAM,OAAO,GAAG,IAAA,gCAAU,EAAC,oCAAoC,CAAC,CAAC;QAEjE,IAAI;YACF,MAAM,qBAAqB,GAAG,cAAI,CAAC,OAAO,CACxC,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,4BAA4B,CAC7B,CAAC;YAEF,IAAI,OAAO,GAAG,GAAG,gCAAU,8CAA8C,qBAAqB,oBAAoB,YAAY,mBAAmB,WAAW,mBAAmB,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC;YAErM,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC7C,OAAO,IAAI,oBAAoB,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;aAC3D;YAED,IAAI,iBAAiB,EAAE;gBACrB,OAAO,IAAI,uBAAuB,CAAC;gBACnC,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE;oBACzC,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE;wBACpC,OAAO,IAAI,IAAI,SAAS,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;qBAC5D;iBACF;gBACD,OAAO,IAAI,GAAG,CAAC;aAChB;YAED,MAAM,aAAa,GAAG,IAAA,wBAAQ,EAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnD,OAAO,CAAC,OAAO,EAAE,CAAC;YAElB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAA2B,CAAC;YACvE,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,UAAU,CAAC;SACnB;QAAC,OAAO,CAAC,EAAE;YACV,OAAO,CAAC,IAAI,CACV,6CAA6C,GAAI,CAAW,CAAC,OAAO,CACrE,CAAC;YACF,MAAM,CAAC,CAAC;SACT;IACH,CAAC;CACF;AAjUD,+BAiUC;AAED,SAAS,gBAAgB,CAAC,SAAoB;IAC5C,QAAQ,SAAS,EAAE;QACjB,KAAK,KAAK,CAAC;QACX,KAAK,KAAK;YACR,OAAO,mDAAmD,CAAC;QAC7D,KAAK,OAAO;YACV,OAAO,iDAAiD,CAAC;KAC5D;AACH,CAAC;AAED,SAAS,0BAA0B;IACjC,MAAM,MAAM,GAAG,EAAE,CAAC;IAElB,MAAM,UAAU,GACd,wGAAwG,CAAC;IAC3G,IAAI,MAAM,CAAC;IACX,IAAI;QACF,MAAM,GAAG,IAAA,wBAAQ,EAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;KAC1C;IAAC,OAAO,CAAC,EAAE;QACV,OAAO,MAAM,CAAC;KACf;IAED,MAAM,EAAE,GACN,0EAA0E,CAAC;IAC7E,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,KAAK,EAAE;QACT,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;KACjB;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {totalmem, EOL} from 'os';\nimport fs from '@react-native-windows/fs';\nimport path from 'path';\nimport child_process from 'child_process';\nimport chalk from 'chalk';\nimport shell from 'shelljs';\nimport Version from './version';\nimport * as checkRequirements from './checkRequirements';\nimport {\n  commandWithProgress,\n  newInfo,\n  newSpinner,\n  newSuccess,\n  newError,\n  powershell,\n} from './commandWithProgress';\nimport {execSync} from 'child_process';\nimport {BuildArch, BuildConfig} from '../commands/runWindows/runWindowsOptions';\nimport {findLatestVsInstall} from './vsInstalls';\nimport {CodedError} from '@react-native-windows/telemetry';\n\nexport default class MSBuildTools {\n  /**\n   * @param version is something like 17.0 for 2022\n   * @param installationPath  Path to installation root\n   * @param installationVersion is the full version e.g. 17.3.32929.385\n   */\n  constructor(\n    public readonly version: string,\n    public readonly installationPath: string,\n    public readonly installationVersion: string,\n  ) {}\n\n  /**\n   * @returns directory where x64 msbuild can be found\n   */\n  msbuildPath() {\n    return path.join(this.installationPath, 'MSBuild/Current/Bin/amd64');\n  }\n\n  cleanProject(slnFile: string) {\n    const cmd = `\"${path.join(\n      this.msbuildPath(),\n      'msbuild.exe',\n    )}\" \"${slnFile}\" /t:Clean`;\n    const results = child_process.execSync(cmd).toString().split(EOL);\n    results.forEach(result => console.log(chalk.white(result)));\n  }\n\n  async restorePackageConfigs(\n    slnFile: any,\n    buildArch: BuildArch,\n    buildType: BuildConfig,\n  ) {\n    const text = 'Restoring NuGet packages ';\n    const spinner = newSpinner(text);\n    await commandWithProgress(\n      spinner,\n      text,\n      path.join(this.msbuildPath(), 'msbuild.exe'),\n      [\n        slnFile,\n        '/t:Restore',\n        '/p:RestoreProjectStyle=PackagesConfig',\n        '/p:RestorePackagesConfig=true',\n        `/p:Platform=${buildArch}`,\n        `/p:Configuration=${buildType}`,\n      ],\n      true,\n      'MSBuildError',\n    );\n  }\n\n  async buildProject(\n    slnFile: string,\n    buildType: BuildConfig,\n    buildArch: BuildArch,\n    msBuildProps: Record<string, string>,\n    verbose: boolean,\n    target: 'build' | 'deploy',\n    buildLogDirectory: string | undefined,\n    singleproc?: boolean,\n  ) {\n    newSuccess(`Found Solution: ${slnFile}`);\n    newInfo(`Build configuration: ${buildType}`);\n    newInfo(`Build platform: ${buildArch}`);\n\n    const verbosityOption = verbose ? 'normal' : 'minimal';\n    const defaultLogDirectory = path.dirname(slnFile);\n    const logPrefix = path.join(\n      buildLogDirectory || defaultLogDirectory,\n      `msbuild_${process.pid}_${target}`,\n    );\n\n    const errorLog = logPrefix + '.err';\n    const warnLog = logPrefix + '.wrn';\n\n    const binlog = `:${logPrefix}.binlog`;\n\n    const args = [\n      `/clp:NoSummary;NoItemAndPropertyList;Verbosity=${verbosityOption}`,\n      '/nologo',\n      `/p:Configuration=${buildType}`,\n      `/p:Platform=${buildArch}`,\n      '/p:AppxBundle=Never',\n      `/bl${binlog}`,\n      `/flp1:errorsonly;logfile=${errorLog}`,\n      `/flp2:warningsonly;logfile=${warnLog}`,\n    ];\n\n    // Building projects in parallel increases compiler memory usage and\n    // doesn't lead to dramatic performance gains (See #4739). Only enable\n    // parallel builds on machines with >16GB of memory to avoid OOM errors\n    const highMemory = totalmem() > 16 * 1024 * 1024 * 1024;\n    const enableParallelBuilds = singleproc !== true && highMemory;\n\n    if (enableParallelBuilds) {\n      args.push('/maxCpuCount');\n    }\n\n    if (target === 'build') {\n      args.push('/restore', '/p:RestorePackagesConfig=true');\n    } else {\n      args.push(`/t:Deploy`);\n    }\n\n    Object.keys(msBuildProps).forEach(key => {\n      args.push(`/p:${key}=${msBuildProps[key]}`);\n    });\n\n    try {\n      checkRequirements.isWinSdkPresent('10.0');\n    } catch (e) {\n      newError((e as Error).message);\n      throw e;\n    }\n\n    if (verbose) {\n      console.log(`Running MSBuild with args ${args.join(' ')}`);\n    }\n\n    const progressName =\n      target === 'deploy' ? 'Deploying Solution' : 'Building Solution';\n    const spinner = newSpinner(progressName);\n    try {\n      await commandWithProgress(\n        spinner,\n        progressName,\n        path.join(this.msbuildPath(), 'msbuild.exe'),\n        [slnFile].concat(args),\n        verbose,\n        'MSBuildError',\n      );\n    } catch (e) {\n      let error = e;\n      if (e instanceof CodedError) {\n        const origCodedError = e as CodedError;\n        if (origCodedError.type === 'MSBuildError') {\n          // Try to parse msbuild errors from errorLog\n          const errorLogContents = (await fs.readFile(errorLog))\n            .toString()\n            .split(EOL)\n            .filter(s => s)\n            .map(s => s.trim());\n          if (errorLogContents.length > 0) {\n            const firstMessage = errorLogContents[0];\n            error = new CodedError(\n              'MSBuildError',\n              firstMessage,\n              origCodedError.data,\n            );\n            // Hide error messages in a field that won't automatically get reported\n            // with telemetry but is still available to be parsed and sanitized\n            (error as any).msBuildErrorMessages = errorLogContents;\n          }\n        }\n      }\n      throw error;\n    }\n    // If we have no errors, delete the error log when we're done\n    if ((await fs.stat(errorLog)).size === 0) {\n      await fs.unlink(errorLog);\n    }\n  }\n\n  static findAvailableVersion(\n    buildArch: BuildArch,\n    verbose: boolean,\n    prerelease?: boolean,\n  ): MSBuildTools {\n    // https://aka.ms/vs/workloads\n    const requires = [\n      'Microsoft.Component.MSBuild',\n      getVCToolsByArch(buildArch),\n    ];\n    const minVersion =\n      process.env.MinimumVisualStudioVersion ||\n      process.env.VisualStudioVersion ||\n      '17.11.0';\n    const vsInstallation = findLatestVsInstall({\n      requires,\n      minVersion,\n      verbose,\n      prerelease,\n    });\n\n    if (!vsInstallation) {\n      if (process.env.MinimumVisualStudioVersion != null) {\n        throw new CodedError(\n          'NoMSBuild',\n          `MSBuild tools not found for version ${process.env.MinimumVisualStudioVersion} (from environment). Make sure all required components have been installed`,\n          {\n            MinimumVisualStudioVersionFromEnv:\n              process.env.MinimumVisualStudioVersion,\n          },\n        );\n      } else if (process.env.VisualStudioVersion != null) {\n        throw new CodedError(\n          'NoMSBuild',\n          `MSBuild tools not found for version ${process.env.VisualStudioVersion} (from environment). Make sure all required components have been installed`,\n          {VisualStudioVersionFromEnv: process.env.VisualStudioVersion},\n        );\n      } else {\n        throw new CodedError(\n          'NoMSBuild',\n          `Could not find MSBuild with VCTools for Visual Studio ${minVersion} or later. Make sure all required components have been installed`,\n          {minVersion: minVersion},\n        );\n      }\n    }\n\n    const toolsPath = path.join(\n      vsInstallation.installationPath,\n      'MSBuild/Current/Bin/amd64',\n    );\n\n    if (fs.existsSync(toolsPath)) {\n      if (verbose) {\n        newSuccess(\n          `Found compatible MSBuild at ${toolsPath} (${vsInstallation.installationVersion})`,\n        );\n      }\n      return new MSBuildTools(\n        minVersion,\n        vsInstallation.installationPath,\n        vsInstallation.installationVersion,\n      );\n    } else {\n      throw new CodedError(\n        'NoMSBuild',\n        `MSBuild path '${toolsPath} does not exist'`,\n      );\n    }\n  }\n\n  static getAllAvailableUAPVersions(): Version[] {\n    const results: Version[] = [];\n\n    const programFilesFolder =\n      process.env['ProgramFiles(x86)'] || process.env.ProgramFiles;\n    // No Program Files folder found, so we won't be able to find UAP SDK\n    if (!programFilesFolder) {\n      return results;\n    }\n\n    let uapFolderPath = path.join(\n      programFilesFolder,\n      'Windows Kits',\n      '10',\n      'Platforms',\n      'UAP',\n    );\n\n    if (!shell.test('-e', uapFolderPath)) {\n      // Check other installation folder from reg\n      const sdkFolder = getSDK10InstallationFolder();\n      if (sdkFolder) {\n        uapFolderPath = path.join(sdkFolder, 'Platforms', 'UAP');\n      }\n    }\n\n    // No UAP SDK exists on this machine\n    if (!shell.test('-e', uapFolderPath)) {\n      return results;\n    }\n\n    shell\n      .ls(uapFolderPath)\n      .filter(uapDir => shell.test('-d', path.join(uapFolderPath, uapDir)))\n      .map(Version.tryParse)\n      .forEach(version => version && results.push(version));\n\n    return results;\n  }\n\n  evaluateMSBuildProperties(\n    solutionFile: string,\n    projectFile: string,\n    propertyNames?: string[],\n    extraMsBuildProps?: Record<string, string>,\n  ): Record<string, string> {\n    const spinner = newSpinner('Running Eval-MsBuildProperties.ps1');\n\n    try {\n      const msbuildEvalScriptPath = path.resolve(\n        __dirname,\n        '..',\n        '..',\n        'src',\n        'powershell',\n        'Eval-MsBuildProperties.ps1',\n      );\n\n      let command = `${powershell} -ExecutionPolicy Unrestricted -NoProfile \"${msbuildEvalScriptPath}\" -SolutionFile '${solutionFile}' -ProjectFile '${projectFile}' -MSBuildPath '${this.msbuildPath()}'`;\n\n      if (propertyNames && propertyNames.length > 0) {\n        command += ` -PropertyNames '${propertyNames.join(',')}'`;\n      }\n\n      if (extraMsBuildProps) {\n        command += \" -ExtraMSBuildProps '\";\n        for (const extraProp in extraMsBuildProps) {\n          if (!(extraProp in Object.prototype)) {\n            command += `,${extraProp}=${extraMsBuildProps[extraProp]}`;\n          }\n        }\n        command += \"'\";\n      }\n\n      const commandOutput = execSync(command).toString();\n      spinner.succeed();\n\n      const properties = JSON.parse(commandOutput) as Record<string, string>;\n      spinner.succeed();\n      return properties;\n    } catch (e) {\n      spinner.fail(\n        'Running Eval-MsBuildProperties.ps1 failed: ' + (e as Error).message,\n      );\n      throw e;\n    }\n  }\n}\n\nfunction getVCToolsByArch(buildArch: BuildArch): string {\n  switch (buildArch) {\n    case 'x86':\n    case 'x64':\n      return 'Microsoft.VisualStudio.Component.VC.Tools.x86.x64';\n    case 'ARM64':\n      return 'Microsoft.VisualStudio.Component.VC.Tools.ARM64';\n  }\n}\n\nfunction getSDK10InstallationFolder(): string {\n  const folder = '';\n\n  const execString =\n    'reg query \"HKLM\\\\SOFTWARE\\\\Microsoft\\\\Microsoft SDKs\\\\Windows\\\\v10.0\" /s /v InstallationFolder /reg:32';\n  let output;\n  try {\n    output = execSync(execString).toString();\n  } catch (e) {\n    return folder;\n  }\n\n  const re =\n    /\\\\Microsoft SDKs\\\\Windows\\\\v10.0\\s*InstallationFolder\\s+REG_SZ\\s+(.*)/gim;\n  const match = re.exec(output);\n  if (match) {\n    return match[1];\n  }\n\n  return folder;\n}\n"]}

package/lib-commonjs/utils/nameHelpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+export declare function isValidProjectName(name: string): boolean;
+export declare function cleanName(str: string): string;
+export declare function isValidProjectNamespace(namespace: string): boolean;
+export declare function cleanNamespace(str: string): string;

package/lib-commonjs/utils/nameHelpers.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanNamespace = exports.isValidProjectNamespace = exports.cleanName = exports.isValidProjectName = void 0;
+const lodash_1 = __importDefault(require("lodash"));
+function pascalCase(str) {
+    const camelCase = lodash_1.default.camelCase(str);
+    return camelCase[0].toUpperCase() + camelCase.substr(1);
+}
+function isValidProjectName(name) {
+    if (name.match(/^[a-z][a-z0-9]*$/gi)) {
+        return true;
+    }
+    return false;
+}
+exports.isValidProjectName = isValidProjectName;
+function cleanName(str) {
+    str = str.replace('@', ''); // Remove '@' from package scope names
+    str = str.slice(str.lastIndexOf('/') + 1); // Remove package scope
+    str = pascalCase(str); // Convert to PascalCase
+    return str;
+}
+exports.cleanName = cleanName;
+function isValidProjectNamespace(namespace) {
+    if (namespace
+        .split(/[.]+/)
+        .map(isValidProjectName)
+        .every(x => x)) {
+        // Validate that every part of the namespace is a valid project name
+        return true;
+    }
+    return false;
+}
+exports.isValidProjectNamespace = isValidProjectNamespace;
+function cleanNamespace(str) {
+    return str.split(/[.:]+/).map(cleanName).join('.');
+}
+exports.cleanNamespace = cleanNamespace;
+//# sourceMappingURL=nameHelpers.js.map

package/lib-commonjs/utils/nameHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nameHelpers.js","sourceRoot":"","sources":["../../src/utils/nameHelpers.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,oDAAuB;AAEvB,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,SAAS,GAAG,gBAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACnC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,IAAI,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAAE;QACpC,OAAO,IAAI,CAAC;KACb;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AALD,gDAKC;AAED,SAAgB,SAAS,CAAC,GAAW;IACnC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,sCAAsC;IAClE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,uBAAuB;IAClE,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;IAC/C,OAAO,GAAG,CAAC;AACb,CAAC;AALD,8BAKC;AAED,SAAgB,uBAAuB,CAAC,SAAiB;IACvD,IACE,SAAS;SACN,KAAK,CAAC,MAAM,CAAC;SACb,GAAG,CAAC,kBAAkB,CAAC;SACvB,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAChB;QACA,oEAAoE;QACpE,OAAO,IAAI,CAAC;KACb;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAXD,0DAWC;AAED,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC;AAFD,wCAEC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport _ from 'lodash';\n\nfunction pascalCase(str: string): string {\n  const camelCase = _.camelCase(str);\n  return camelCase[0].toUpperCase() + camelCase.substr(1);\n}\n\nexport function isValidProjectName(name: string): boolean {\n  if (name.match(/^[a-z][a-z0-9]*$/gi)) {\n    return true;\n  }\n  return false;\n}\n\nexport function cleanName(str: string): string {\n  str = str.replace('@', ''); // Remove '@' from package scope names\n  str = str.slice(str.lastIndexOf('/') + 1); // Remove package scope\n  str = pascalCase(str); // Convert to PascalCase\n  return str;\n}\n\nexport function isValidProjectNamespace(namespace: string): boolean {\n  if (\n    namespace\n      .split(/[.]+/)\n      .map(isValidProjectName)\n      .every(x => x)\n  ) {\n    // Validate that every part of the namespace is a valid project name\n    return true;\n  }\n  return false;\n}\n\nexport function cleanNamespace(str: string): string {\n  return str.split(/[.:]+/).map(cleanName).join('.');\n}\n"]}

package/lib-commonjs/utils/oldArchWarning.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+/**
+ * Displays a warning message about the Old Architecture template.
+ */
+export declare function showOldArchitectureWarning(): void;

package/lib-commonjs/utils/oldArchWarning.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showOldArchitectureWarning = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Displays a warning message about the Old Architecture template.
+ */
+function showOldArchitectureWarning() {
+    console.log(chalk_1.default.yellow(`⚠️ This project is using the React Native (for Windows) Old Architecture. The old architecture will begin to be removed starting with react-native-windows@0.82.0.`));
+    console.log();
+    console.log(chalk_1.default.cyan('💡 It is strongly recommended to move to the new architecture as soon as possible to take advantage of improved performance, long-term support, and modern capabilities.'));
+    console.log();
+    console.log(chalk_1.default.blue('🔗 Learn more: https://microsoft.github.io/react-native-windows/docs/new-architecture'));
+    console.log();
+    console.log(chalk_1.default.blue('🔗 View the list of properties not yet supported in Fabric: https://microsoft.github.io/react-native-windows/docs/new-arch-missingProps'));
+    console.log();
+    console.log(chalk_1.default.blue('💬 If you encounter missing properties, please open an issue: https://github.com/microsoft/react-native-windows/issues'));
+    console.log();
+}
+exports.showOldArchitectureWarning = showOldArchitectureWarning;
+//# sourceMappingURL=oldArchWarning.js.map

package/lib-commonjs/utils/oldArchWarning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oldArchWarning.js","sourceRoot":"","sources":["../../src/utils/oldArchWarning.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,kDAA0B;AAE1B;;GAEG;AACH,SAAgB,0BAA0B;IACxC,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CACV,oKAAoK,CACrK,CACF,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CACR,0KAA0K,CAC3K,CACF,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CACR,uFAAuF,CACxF,CACF,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CACR,yIAAyI,CAC1I,CACF,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CACR,wHAAwH,CACzH,CACF,CAAC;IACF,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AA/BD,gEA+BC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport chalk from 'chalk';\n\n/**\n * Displays a warning message about the Old Architecture template.\n */\nexport function showOldArchitectureWarning(): void {\n  console.log(\n    chalk.yellow(\n      `⚠️ This project is using the React Native (for Windows) Old Architecture. The old architecture will begin to be removed starting with react-native-windows@0.82.0.`,\n    ),\n  );\n  console.log();\n  console.log(\n    chalk.cyan(\n      '💡 It is strongly recommended to move to the new architecture as soon as possible to take advantage of improved performance, long-term support, and modern capabilities.',\n    ),\n  );\n  console.log();\n  console.log(\n    chalk.blue(\n      '🔗 Learn more: https://microsoft.github.io/react-native-windows/docs/new-architecture',\n    ),\n  );\n  console.log();\n  console.log(\n    chalk.blue(\n      '🔗 View the list of properties not yet supported in Fabric: https://microsoft.github.io/react-native-windows/docs/new-arch-missingProps',\n    ),\n  );\n  console.log();\n  console.log(\n    chalk.blue(\n      '💬 If you encounter missing properties, please open an issue: https://github.com/microsoft/react-native-windows/issues',\n    ),\n  );\n  console.log();\n}\n"]}

package/lib-commonjs/utils/pathHelpers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+export declare function resolveRnwRoot(paths: string | string[] | undefined): string;

package/lib-commonjs/utils/pathHelpers.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRnwRoot = void 0;
+const path_1 = __importDefault(require("path"));
+function resolveRnwRoot(paths) {
+    return path_1.default.dirname(require.resolve('react-native-windows/package.json', {
+        paths: typeof paths === 'string' ? [paths] : paths,
+    }));
+}
+exports.resolveRnwRoot = resolveRnwRoot;
+//# sourceMappingURL=pathHelpers.js.map

package/lib-commonjs/utils/pathHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathHelpers.js","sourceRoot":"","sources":["../../src/utils/pathHelpers.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;AAEH,gDAAwB;AAExB,SAAgB,cAAc,CAAC,KAAoC;IACjE,OAAO,cAAI,CAAC,OAAO,CACjB,OAAO,CAAC,OAAO,CAAC,mCAAmC,EAAE;QACnD,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;KACnD,CAAC,CACH,CAAC;AACJ,CAAC;AAND,wCAMC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport path from 'path';\n\nexport function resolveRnwRoot(paths: string | string[] | undefined): string {\n  return path.dirname(\n    require.resolve('react-native-windows/package.json', {\n      paths: typeof paths === 'string' ? [paths] : paths,\n    }),\n  );\n}\n"]}

package/lib-commonjs/utils/telemetryHelpers.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+import type { Config, CommandOption } from '@react-native-community/cli-types';
+import { CommanderOptionsType, OptionSanitizer } from '@react-native-windows/telemetry';
+/**
+ * Calculates a the default values of a given react-native CLI command's options.
+ * @param config Config passed from react-native CLI.
+ * @param commandOptions The options definition for the command.
+ * @returns The default options for the command.
+ */
+export declare function getDefaultOptions(config: Config, commandOptions: CommandOption[]): CommanderOptionsType;
+/**
+ * Sets up and starts the telemetry gathering for the CLI command.
+ * @param commandName The name of the CLI command.
+ * @param config Config passed from react-native CLI.
+ * @param options Options passed from react-native CLI.
+ * @param defaultOptions Default options for the command.
+ * @param optionSanitizer Function to sanitize the option values for telemetry.
+ */
+export declare function startTelemetrySession(commandName: string, config: Config, options: CommanderOptionsType, defaultOptions: CommanderOptionsType, optionSanitizer: OptionSanitizer): Promise<void>;
+/**
+ * Ends the gathering of telemetry for the CLI command.
+ * @param error The error (if any) thrown during the command.
+ * @param getExtraProps Function to get any extra command-specific telemetry properties.
+ */
+export declare function endTelemetrySession(error?: Error, getExtraProps?: () => Promise<Record<string, any>>, finalOptions?: Record<string, any>, optionSanitizer?: (opts: Record<string, any>) => Record<string, any>): Promise<void>;

package/lib-commonjs/utils/telemetryHelpers.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ * @format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.endTelemetrySession = exports.startTelemetrySession = exports.getDefaultOptions = void 0;
+const lodash_1 = require("lodash");
+const telemetry_1 = require("@react-native-windows/telemetry");
+const commandWithProgress_1 = require("./commandWithProgress");
+/**
+ * Calculates a the default values of a given react-native CLI command's options.
+ * @param config Config passed from react-native CLI.
+ * @param commandOptions The options definition for the command.
+ * @returns The default options for the command.
+ */
+function getDefaultOptions(config, commandOptions) {
+    const result = {
+        logging: false,
+    };
+    for (const option of commandOptions) {
+        let key = option.name.startsWith('--')
+            ? option.name.slice('--'.length)
+            : option.name;
+        key = key.trim();
+        let value = option.default;
+        if (value !== undefined && value.name) {
+            value = value(config);
+        }
+        if (key.endsWith(' [string]')) {
+            // Option is a string
+            key = key.slice(0, -' [string]'.length);
+            // Option is a number
+        }
+        else if (key.endsWith(' [number]')) {
+            key = key.slice(0, -' [number]'.length);
+        }
+        else {
+            // Option is a boolean
+            // Note: Commander ignores the default property for booleans
+            if (key.startsWith('no-')) {
+                key = key.slice('no-'.length);
+                // Commander always defaults to true for flags that start with --no
+                value = true;
+            }
+            else {
+                // Commander always defaults to undefined for flags
+                value = undefined;
+            }
+        }
+        key = (0, lodash_1.camelCase)(key);
+        result[key] = value;
+    }
+    return result;
+}
+exports.getDefaultOptions = getDefaultOptions;
+/**
+ * Sets up and starts the telemetry gathering for the CLI command.
+ * @param commandName The name of the CLI command.
+ * @param config Config passed from react-native CLI.
+ * @param options Options passed from react-native CLI.
+ * @param defaultOptions Default options for the command.
+ * @param optionSanitizer Function to sanitize the option values for telemetry.
+ */
+async function startTelemetrySession(commandName, config, options, defaultOptions, optionSanitizer) {
+    const verbose = options.logging === true;
+    if (!options.telemetry) {
+        if (verbose) {
+            (0, commandWithProgress_1.newInfo)('Telemetry is disabled');
+        }
+        return;
+    }
+    if (verbose) {
+        (0, commandWithProgress_1.newInfo)(`Running ${(0, telemetry_1.nodeArchitecture)()} node on a ${(0, telemetry_1.deviceArchitecture)()} machine`);
+    }
+    if ((0, telemetry_1.deviceArchitecture)() !== (0, telemetry_1.nodeArchitecture)()) {
+        (0, commandWithProgress_1.newWarn)('This version of node was built for a different architecture than this machine and may cause unintended behavior');
+    }
+    await telemetry_1.Telemetry.setup();
+    const sanitizedOptions = (0, telemetry_1.commanderOptionsToOptions)(options, optionSanitizer);
+    const sanitizedDefaultOptions = (0, telemetry_1.commanderOptionsToOptions)(defaultOptions, optionSanitizer);
+    const sanitizedArgs = (0, telemetry_1.optionsToArgs)(sanitizedOptions, process.argv);
+    const startInfo = {
+        commandName,
+        args: sanitizedArgs,
+        options: sanitizedOptions,
+        defaultOptions: sanitizedDefaultOptions,
+    };
+    telemetry_1.Telemetry.startCommand(startInfo);
+    const projectInfo = await (0, telemetry_1.configToProjectInfo)(config);
+    if (projectInfo) {
+        telemetry_1.Telemetry.setProjectInfo(projectInfo);
+    }
+    const projectFile = (0, telemetry_1.getProjectFileFromConfig)(config);
+    if (projectFile) {
+        await telemetry_1.Telemetry.populateNuGetPackageVersions(projectFile);
+    }
+}
+exports.startTelemetrySession = startTelemetrySession;
+/**
+ * Ends the gathering of telemetry for the CLI command.
+ * @param error The error (if any) thrown during the command.
+ * @param getExtraProps Function to get any extra command-specific telemetry properties.
+ */
+async function endTelemetrySession(error, getExtraProps, finalOptions, optionSanitizer) {
+    if (!telemetry_1.Telemetry.isEnabled()) {
+        // Bail early so don't waste time here
+        return;
+    }
+    const endInfo = {
+        resultCode: 'Success',
+    };
+    if (error) {
+        endInfo.resultCode =
+            error instanceof telemetry_1.CodedError ? error.type : 'Unknown';
+    }
+    // Get extra properties
+    const extraProps = getExtraProps ? await getExtraProps() : undefined;
+    // Sanitize and attach finalOptions if provided
+    if (finalOptions && optionSanitizer) {
+        endInfo.finalOptions = optionSanitizer(finalOptions);
+    }
+    telemetry_1.Telemetry.endCommand(endInfo, extraProps);
+}
+exports.endTelemetrySession = endTelemetrySession;
+//# sourceMappingURL=telemetryHelpers.js.map

package/lib-commonjs/utils/telemetryHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryHelpers.js","sourceRoot":"","sources":["../../src/utils/telemetryHelpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n * @format\n */\n\nimport {camelCase} from 'lodash';\n\nimport type {\n  Config,\n  CommandOption,\n  OptionValue,\n} from '@react-native-community/cli-types';\n\nimport {\n  Telemetry,\n  CodedError,\n  CommandStartInfo,\n  CommandEndInfo,\n  CommanderOptionsType,\n  commanderOptionsToOptions,\n  optionsToArgs,\n  OptionSanitizer,\n  configToProjectInfo,\n  getProjectFileFromConfig,\n  deviceArchitecture,\n  nodeArchitecture,\n} from '@react-native-windows/telemetry';\n\nimport {newInfo, newWarn} from './commandWithProgress';\n\n/**\n * Calculates a the default values of a given react-native CLI command's options.\n * @param config Config passed from react-native CLI.\n * @param commandOptions The options definition for the command.\n * @returns The default options for the command.\n */\nexport function getDefaultOptions(\n  config: Config,\n  commandOptions: CommandOption[],\n): CommanderOptionsType {\n  const result: CommanderOptionsType = {\n    logging: false,\n  };\n  for (const option of commandOptions) {\n    let key = option.name.startsWith('--')\n      ? option.name.slice('--'.length)\n      : option.name;\n    key = key.trim();\n\n    let value = option.default;\n    if (value !== undefined && (value as (ctx: Config) => OptionValue).name) {\n      value = (value as (ctx: Config) => OptionValue)(config);\n    }\n\n    if (key.endsWith(' [string]')) {\n      // Option is a string\n      key = key.slice(0, -' [string]'.length);\n      // Option is a number\n    } else if (key.endsWith(' [number]')) {\n      key = key.slice(0, -' [number]'.length);\n    } else {\n      // Option is a boolean\n      // Note: Commander ignores the default property for booleans\n      if (key.startsWith('no-')) {\n        key = key.slice('no-'.length);\n        // Commander always defaults to true for flags that start with --no\n        value = true;\n      } else {\n        // Commander always defaults to undefined for flags\n        value = undefined;\n      }\n    }\n\n    key = camelCase(key);\n    result[key] = value;\n  }\n  return result;\n}\n\n/**\n * Sets up and starts the telemetry gathering for the CLI command.\n * @param commandName The name of the CLI command.\n * @param config Config passed from react-native CLI.\n * @param options Options passed from react-native CLI.\n * @param defaultOptions Default options for the command.\n * @param optionSanitizer Function to sanitize the option values for telemetry.\n */\nexport async function startTelemetrySession(\n  commandName: string,\n  config: Config,\n  options: CommanderOptionsType,\n  defaultOptions: CommanderOptionsType,\n  optionSanitizer: OptionSanitizer,\n) {\n  const verbose = options.logging === true;\n\n  if (!options.telemetry) {\n    if (verbose) {\n      newInfo('Telemetry is disabled');\n    }\n    return;\n  }\n\n  if (verbose) {\n    newInfo(\n      `Running ${nodeArchitecture()} node on a ${deviceArchitecture()} machine`,\n    );\n  }\n\n  if (deviceArchitecture() !== nodeArchitecture()) {\n    newWarn(\n      'This version of node was built for a different architecture than this machine and may cause unintended behavior',\n    );\n  }\n\n  await Telemetry.setup();\n\n  const sanitizedOptions = commanderOptionsToOptions(options, optionSanitizer);\n  const sanitizedDefaultOptions = commanderOptionsToOptions(\n    defaultOptions,\n    optionSanitizer,\n  );\n  const sanitizedArgs = optionsToArgs(sanitizedOptions, process.argv);\n\n  const startInfo: CommandStartInfo = {\n    commandName,\n    args: sanitizedArgs,\n    options: sanitizedOptions,\n    defaultOptions: sanitizedDefaultOptions,\n  };\n\n  Telemetry.startCommand(startInfo);\n\n  const projectInfo = await configToProjectInfo(config);\n  if (projectInfo) {\n    Telemetry.setProjectInfo(projectInfo);\n  }\n\n  const projectFile = getProjectFileFromConfig(config);\n  if (projectFile) {\n    await Telemetry.populateNuGetPackageVersions(projectFile);\n  }\n}\n\n/**\n * Ends the gathering of telemetry for the CLI command.\n * @param error The error (if any) thrown during the command.\n * @param getExtraProps Function to get any extra command-specific telemetry properties.\n */\nexport async function endTelemetrySession(\n  error?: Error,\n  getExtraProps?: () => Promise<Record<string, any>>,\n  finalOptions?: Record<string, any>,\n  optionSanitizer?: (opts: Record<string, any>) => Record<string, any>,\n) {\n  if (!Telemetry.isEnabled()) {\n    // Bail early so don't waste time here\n    return;\n  }\n\n  const endInfo: CommandEndInfo = {\n    resultCode: 'Success',\n  };\n\n  if (error) {\n    endInfo.resultCode =\n      error instanceof CodedError ? (error as CodedError).type : 'Unknown';\n  }\n\n  // Get extra properties\n  const extraProps = getExtraProps ? await getExtraProps() : undefined;\n\n  // Sanitize and attach finalOptions if provided\n  if (finalOptions && optionSanitizer) {\n    endInfo.finalOptions = optionSanitizer(finalOptions);\n  }\n\n  Telemetry.endCommand(endInfo, extraProps);\n}\n"]}