[code-infra] Port releaseTag script

Author: Brijesh Bittu

package.json

@@ -1,6 +1,7 @@
 {
   "name": "mui-public",
   "private": true,
+  "version": "0.0.1",
   "scripts": {
     "preinstall": "npx only-allow pnpm",
     "eslint": "eslint . --cache --report-unused-disable-directives --ext .js,.ts,.tsx --max-warnings 0",

packages/mui-infra/src/cli/releaseTag.mjs

@@ -0,0 +1,99 @@
+import gitUrlParse from 'git-url-parse';
+import childProcess from 'node:child_process';
+import path from 'path';
+import { promisify } from 'util';
+import yargs from 'yargs';
+
+import { findWorkspaceRoot } from '../utils/findWorkspaceRoot.mjs';
+import { readJSON } from '../utils/readJson.mjs';
+
+/**
+ * Only directly call it with side-effect free commands.
+ * Otherwise use the `exec` that's considering whether the context is supposed to be "dry" i.e. have no side-effects.
+ */
+const execActual = promisify(childProcess.exec);
+/**
+ * @param {string} command
+ * @param {unknown} [options]
+ */
+async function execDry(command, options) {
+  // eslint-disable-next-line no-console
+  console.log(`exec(\`${command}\`, ${JSON.stringify(options)})`);
+}
+
+/**
+ * Find the remote pointing to mui/material-ui.
+ *
+ * Conventionally this should be named `upstream` but some collaborators might've used a different naming scheme.
+ *
+ * @param {string} repo
+ */
+async function findMuiOrgRemote(repo) {
+  const { stdout } = await execActual(['git', 'remote', '-v'].join(' '));
+  const remoteLines = stdout.trim().split(/\r?\n/);
+
+  return remoteLines
+    .map((remoteLine) => {
+      const [name, url, method] = remoteLine.split(/\s/);
+      return { name, url, method };
+    })
+    .find((remote) => {
+      const parsed = gitUrlParse(remote.url);
+      return parsed.owner === 'mui' && parsed.name === repo;
+    });
+}
+
+async function main(argv) {
+  const { dryRun, repo } = argv;
+
+  const exec = dryRun ? execDry : execActual;
+
+  const rootWorkspace = findWorkspaceRoot();
+  const rootWorkspaceManifest = await readJSON(path.join(rootWorkspace, 'package.json'));
+
+  const tag = `v${rootWorkspaceManifest.version}`;
+  const message = `Version ${rootWorkspaceManifest.version}`;
+
+  await exec(['git', 'tag', '-a', tag, '-m', `"${message}"`].join(' '));
+  // eslint-disable-next-line no-console -- verbose logging
+  console.log(`Created tag '${tag}'. To remove enter 'git tag -d ${tag}'`);
+
+  const muiOrgRemote = await findMuiOrgRemote(repo);
+  if (muiOrgRemote === undefined) {
+    throw new TypeError(
+      'Unable to find the upstream remote. It should be a remote pointing to "mui/material-ui". ' +
+        'Did you forget to add it via `git remote add upstream [email protected]:mui/material-ui.git`? ' +
+        'If you think this is a bug please include `git remote -v` in your report.',
+    );
+  }
+
+  await exec(['git', 'push', muiOrgRemote.name, tag].join(' '));
+
+  // eslint-disable-next-line no-console -- verbose logging
+  console.log(
+    `Pushed tag '${tag}' to ${muiOrgRemote.name}. This should not be reversed. In case of emergency enter 'git push --delete ${muiOrgRemote.name} ${tag}' to remove.`,
+  );
+}
+
+yargs(process.argv.slice(2))
+  .command({
+    command: '$0',
+    description: 'Tags the current release and pushes these changes to mui/<repo-name>.',
+    builder: (command) => {
+      return command
+        .option('dryRun', {
+          default: false,
+          describe: 'When true, the script will not have any permanent side-effects.',
+          type: 'boolean',
+        })
+        .option('repo', {
+          describe: 'Repository to tag',
+          type: 'string',
+        });
+    },
+    handler: main,
+  })
+  .help()
+  .strict(true)
+  .version(false)
+  .parse();

packages/mui-infra/src/utils/findWorkspaceRoot.mjs

@@ -0,0 +1,33 @@
+import * as path from 'node:path';
+import * as url from 'node:url';
+import * as fs from 'node:fs';
+
+function findUpFile(fileName, cwd = process.cwd(), maxIterations = 5) {
+  const pathName = path.join(cwd, fileName);
+  if (fs.existsSync(pathName)) {
+    return pathName;
+  }
+  if (maxIterations === 0) {
+    return null;
+  }
+  return findUpFile(fileName, path.dirname(cwd), maxIterations - 1);
+}
+
+/**
+ * Returns the full path of the root directory of the monorepo.
+ */
+export function findWorkspaceRoot() {
+  // Use this when available. Avoids the need to check for the workspace file.
+  if (process.env.NX_WORKSPACE_ROOT) {
+    return process.env.NX_WORKSPACE_ROOT;
+  }
+
+  const workspaceFilePath = findUpFile('pnpm-workspace.yaml', process.cwd());
+  if (workspaceFilePath) {
+    return path.dirname(workspaceFilePath);
+  }
+
+  const currentDirectory = url.fileURLToPath(new URL('.', import.meta.url));
+  const workspaceRoot = path.resolve(currentDirectory, '..');
+  return workspaceRoot;
+}

packages/mui-infra/src/utils/readJson.mjs

@@ -0,0 +1,11 @@
+import fs from 'node:fs/promises';
+
+export async function readJSON(filePath) {
+  try {
+    const data = await fs.readFile(filePath, 'utf8');
+    return JSON.parse(data);
+  } catch (error) {
+    console.error(`Error reading JSON file at ${filePath}:`, error);
+    throw error;
+  }
+}

packages/mui-internal-code-infra/package.json

@@ -24,6 +24,9 @@
       "default": "./src/eslint/docs.mjs"
     }
   },
+  "bin": {
+    "mui-release-tag": "./src/cli/releaseTag.mjs"
+  },
   "dependencies": {
     "emoji-regex": "^10.4.0",
     "eslint-config-airbnb-base": "^15.0.0",
@@ -37,9 +40,11 @@
     "eslint-plugin-react-compiler": "^19.1.0-rc.2",
     "eslint-plugin-react-hooks": "^6.0.0",
     "eslint-plugin-testing-library": "^7.3.0",
+    "git-url-parse": "^16.1.0",
     "globals": "^16.2.0",
     "minimatch": "^10.0.1",
-    "typescript-eslint": "^8.33.1"
+    "typescript-eslint": "^8.33.1",
+    "yargs": "^18.0.0"
   },
   "peerDependencies": {
     "@next/eslint-plugin-next": "^14.0.0 || ^15.0.0",