@mui/internal-code-infra 0.0.4-canary.99 → 0.1.1-canary.0

package/README.md

@@ -70,3 +70,7 @@ pnpm code-infra publish-new-package --otp=123456
 7. Finally, save the changes by clicking on `Update Package Settings` button.
 
 After following these steps, the `Publish` workflow can be invoked again.
+
+## Agent skills
+
+The agent skills previously shipped with this package now live at the repository root. See [Install instructions](../../README.md#agent-skills).

package/build/babel-config.d.mts

@@ -14,7 +14,7 @@ export type ReactCompilationMode = 'annotation' | 'syntax' | 'infer' | 'all';
  * @param {string} [param0.reactCompilerReactVersion]
  * @param {ReactCompilationMode} [param0.reactCompilerMode]
  * @param {{ allowedCallees?: Record<string, string[]> }} [param0.displayName] - Options for the display name plugin.
- * @returns {import('@babel/core').TransformOptions} The base Babel configuration.
+ * @returns {import('@babel/core').InputOptions} The base Babel configuration.
  */
 export declare function getBaseConfig({ debug, optimizeClsx, removePropTypes, noResolveImports, bundle, runtimeVersion, outExtension, reactCompilerReactVersion, reactCompilerMode, displayName, }: {
     debug?: boolean;
@@ -29,7 +29,7 @@ export declare function getBaseConfig({ debug, optimizeClsx, removePropTypes, no
     displayName?: {
         allowedCallees?: Record<string, string[]>;
     };
-}): import('@babel/core').TransformOptions;
+}): import('@babel/core').InputOptions;
 export type Options = {
     bundle?: 'esm' | 'cjs';
     noResolveImports?: boolean;
@@ -43,6 +43,6 @@ export type Options = {
  */
 /**
  * @param {import('@babel/core').ConfigAPI | Options} api
- * @returns {import('@babel/core').TransformOptions}
+ * @returns {import('@babel/core').InputOptions}
  */
-export default function getBabelConfig(api: import('@babel/core').ConfigAPI | Options): import('@babel/core').TransformOptions;
+export default function getBabelConfig(api: import('@babel/core').ConfigAPI | Options): import('@babel/core').InputOptions;

package/build/babelPluginInlineEnvironmentVariables.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Inlines `process.env.X` member expressions with their build-time value.
+ *
+ * Forked from `babel-plugin-transform-inline-environment-variables` (unmaintained, last
+ * published 2022) because it calls the now-removed `NodePath#toComputedKey()` under Babel 8's
+ * `@babel/traverse`. Behavior is otherwise identical to the upstream plugin.
+ *
+ * @param {import('@babel/core').PluginAPI} api
+ * @returns {import('@babel/core').PluginObject}
+ */
+export default function babelPluginInlineEnvironmentVariables({ types: t }: import('@babel/core').PluginAPI): import('@babel/core').PluginObject;

package/build/cli/cmdBuild.d.mts

@@ -48,7 +48,7 @@ export type Args = {
      */
     enableReactCompiler?: boolean;
     /**
-     * - Whether to build types using typescript native (tsgo).
+     * - Whether to build types using the native TypeScript compiler.
      */
     tsgo?: boolean;
     /**

package/build/cli/cmdListWorkspaces.d.mts

@@ -8,7 +8,7 @@ export type Args = {
     /**
      * - Output format (name, path, or json)
      */
-    output?: 'json' | 'path' | 'name' | 'publish-dir';
+    output?: 'json' | 'path' | 'name';
     /**
      * - Git reference to filter changes since
      */
@@ -21,7 +21,7 @@ export type Args = {
 /**
  * @typedef {Object} Args
  * @property {boolean} [publicOnly] - Whether to filter to only public packages
- * @property {'json'|'path'|'name'|'publish-dir'} [output] - Output format (name, path, or json)
+ * @property {'json'|'path'|'name'} [output] - Output format (name, path, or json)
  * @property {string} [sinceRef] - Git reference to filter changes since
  * @property {string[]} [filter] - Same as filtering packages with --filter in pnpm. Only include packages matching the filter. See https://pnpm.io/filtering.
  */

package/build/eslint/testConfig.d.mts

@@ -3,12 +3,6 @@
  */
 export declare const baseSpecRules: import('eslint').Linter.Config;
 /**
- * @param {Object} [options]
- * @param {boolean} [options.useMocha]
- * @param {boolean} [options.useVitest]
  * @returns {import('eslint').Linter.Config[]}
  */
-export declare function createTestConfig(options?: {
-    useMocha?: boolean;
-    useVitest?: boolean;
-}): import('eslint').Linter.Config[];
+export declare function createTestConfig(): import('eslint').Linter.Config[];

package/build/utils/build.d.mts

@@ -107,18 +107,3 @@ export declare function markFn<F extends () => Promise<any>>(label: string, fn:
  * @param {string} label
  */
 export declare function measureFn(label: string): PerformanceMeasure;
-/**
- * A utility to map a function over an array of items in a worker pool.
- *
- * This function will create a pool of workers and distribute the items to be processed among them.
- * Each worker will process items sequentially, but multiple workers will run in parallel.
- *
- * @function
- * @template T
- * @template R
- * @param {T[]} items
- * @param {(item: T) => Promise<R>} mapper
- * @param {number} concurrency
- * @returns {Promise<(R|Error)[]>}
- */
-export declare function mapConcurrently<T, R>(items: T[], mapper: (item: T) => Promise<R>, concurrency: number): Promise<(R | Error)[]>;

package/build/utils/extractErrorCodes.d.mts

@@ -12,6 +12,13 @@ export type Args = {
      */
     detection?: import('@mui/internal-babel-plugin-minify-errors').Options['detection'];
 };
+/**
+ * Extracts error codes from all files in a directory.
+ * @param {string[]} files
+ * @param {Set<string | Error>} errors
+ * @param {import('@mui/internal-babel-plugin-minify-errors').Options['detection']} [detection='opt-in']
+ */
+export declare function extractErrorCodesForFiles(files: string[], errors: Set<string | Error>, detection?: import('@mui/internal-babel-plugin-minify-errors').Options['detection']): Promise<void>;
 /**
  * Extracts error codes from all workspace packages.
  * @param {Args} args

package/build/utils/pnpm.d.mts

@@ -112,6 +112,16 @@ export declare function getWorkspacePackages(options?: GetWorkspacePackagesOptio
  * @returns {Promise<string>} Normalized registry URL, ending in a slash
  */
 export declare function getPublishRegistry(packagePath: string): Promise<string>;
+/**
+ * Get the version to release from the workspace-root package.json.
+ *
+ * Resolves the workspace root so the version is the monorepo's regardless of
+ * which directory publish runs from.
+ *
+ * @param {string} [cwd] - Directory to resolve the workspace root from
+ * @returns {Promise<string | null>} Version string, or null when absent/invalid
+ */
+export declare function getReleaseVersion(cwd?: string): Promise<string | null>;
 /**
  * Filter to the packages that must be published by hand before CI can take over.
  *
@@ -253,18 +263,65 @@ export declare function writeOverridesToWorkspace(workspaceDir: string, override
  */
 export declare function renameWorkspaceScope(packages: (PublicPackage | PrivatePackage)[], fromScope: string, toScope: string): Promise<Map<string, string>>;
 /**
- * Resolve a package@version specifier to an exact version
+ * Pick the version to pin for a specifier whose newest match is too recent to
+ * satisfy a `minimumReleaseAge` cooldown.
+ *
+ * Only the three specifier shapes this tool is given are handled. An exact
+ * version is not a choice, so it stands and the install reports it. A range
+ * resolves within itself. A dist-tag repoints to the highest aged-in version
+ * sharing the major and prerelease-ness — except `latest`, which pnpm allows to
+ * cross majors. Unlike pnpm, a deprecated version is not passed over: `pnpm info`
+ * lists bare version strings, so that flag would cost a request per candidate.
+ *
+ * @param {string} requested - The specifier as given: a dist-tag, range or exact version
+ * @param {string} resolvedVersion - Version the specifier resolves to today
+ * @param {string[]} versions - Every published version, from `pnpm info <pkg> versions`
+ * @param {Record<string, string>} publishTimes - Version to ISO publish date, from `pnpm info <pkg> time`
+ * @param {number} cutoff - Epoch ms; versions published after this are too recent
+ * @param {string[]} [exemptVersions] - Versions `minimumReleaseAgeExclude` installs regardless of age
+ * @returns {string | null} Version to pin, or null when nothing qualifies
+ * @internal exported for unit tests
+ */
+export declare function selectAgedVersion(requested: string, resolvedVersion: string, versions: string[], publishTimes: Record<string, string>, cutoff: number, exemptVersions?: string[]): string | null;
+/**
+ * Read the effective pnpm configuration, including everything resolved from
+ * pnpm-workspace.yaml. `config list` types the values and omits unset keys,
+ * where `config get` stringifies everything and prints `undefined`.
+ *
+ * @returns {Promise<Record<string, any>>} Parsed configuration
+ */
+export declare function readPnpmConfig(): Promise<Record<string, any>>;
+/**
+ * Read the registry cooldown from pnpm config, so resolution stays in step with
+ * what the subsequent install will enforce.
+ *
+ * @returns {Promise<import('@pnpm/config.version-policy').PublishedByPolicy>} Cutoff date and exemption policy, both undefined when no cooldown is configured
+ */
+export declare function getMinimumReleaseAgePolicy(): Promise<import('@pnpm/config.version-policy').PublishedByPolicy>;
+/**
+ * Resolve a package@version specifier to an exact version.
+ *
+ * Given a cooldown policy, the result is the newest version the install will
+ * actually accept — a dist-tag on a daily channel always points at a build too
+ * recent to install under one. See {@link selectAgedVersion}.
+ *
  * @param {string} packageSpec - Package specifier in format "package@version"
+ * @param {import('@pnpm/config.version-policy').PublishedByPolicy} policy - Cooldown from {@link getMinimumReleaseAgePolicy}
  * @returns {Promise<string>} Exact version string
  */
-export declare function resolveVersion(packageSpec: string): Promise<string>;
+export declare function resolveVersion(packageSpec: string, policy: import('@pnpm/config.version-policy').PublishedByPolicy): Promise<string>;
 /**
  * Find the version of a dependency for a specific package@version
+ *
+ * The parent's spec is often a range, so the cooldown applies here too. Stepping
+ * back stays within that range and so never contradicts the parent.
+ *
  * @param {string} packageSpec - Package specifier in format "package@version"
  * @param {string} dependency - Dependency name to look up
+ * @param {import('@pnpm/config.version-policy').PublishedByPolicy} policy - Registry cooldown to resolve within
  * @returns {Promise<string>} Exact version string of the dependency
  */
-export declare function findDependencyVersionFromSpec(packageSpec: string, dependency: string): Promise<string>;
+export declare function findDependencyVersionFromSpec(packageSpec: string, dependency: string, policy: import('@pnpm/config.version-policy').PublishedByPolicy): Promise<string>;
 /**
  * Get the maximum semver version between two versions
  * @param {string} a

package/build/utils/typescript.d.mts

@@ -3,7 +3,7 @@
  * @param {string} tsconfig - The path to the tsconfig.json file.
  * @param {string} outDir - The output directory for the declaration files.
  * @param {Object} options
- * @param {boolean} [options.useTsgo] - Whether to use typescript native (tsgo).
+ * @param {boolean} [options.useTsgo] - Whether to use the native TypeScript compiler.
  */
 export declare function emitDeclarations(tsconfig: string, outDir: string, options: {
     useTsgo?: boolean;
@@ -44,7 +44,7 @@ export declare function moveAndTransformDeclarations({ inputDir, buildDir, bundl
  * @param {string} param0.buildDir - The build directory.
  * @param {string} param0.cwd - The current working directory.
  * @param {boolean} param0.skipTsc - Whether to skip running TypeScript compiler (tsc) for building types.
- * @param {boolean} [param0.useTsgo=false] - Whether to build types using typescript native (tsgo).
+ * @param {boolean} [param0.useTsgo=false] - Whether to build types using the native TypeScript compiler.
  * @param {'module' | 'commonjs'} [param0.packageType] - The package.json type field.
  */
 export declare function createTypes({ bundles, srcDir, buildDir, cwd, skipTsc, useTsgo, packageType, verbose, }: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-code-infra",
-  "version": "0.0.4-canary.99",
+  "version": "0.1.1-canary.0",
   "author": "MUI Team",
   "description": "Infra scripts and configs to be used across MUI repos.",
   "license": "MIT",
@@ -53,39 +53,43 @@
     "code-infra": "./bin/code-infra.mjs"
   },
   "dependencies": {
-    "@argos-ci/core": "6.5.0",
-    "@babel/cli": "^7.29.7",
-    "@babel/core": "^7.29.7",
-    "@babel/plugin-syntax-jsx": "^7.29.7",
-    "@babel/plugin-syntax-typescript": "^7.29.7",
-    "@babel/plugin-transform-runtime": "^7.29.7",
-    "@babel/preset-env": "^7.29.7",
-    "@babel/preset-react": "^7.29.7",
-    "@babel/preset-typescript": "^7.29.7",
-    "@eslint/compat": "^2.1.0",
+    "@argos-ci/core": "6.8.4",
+    "@babel/cli": "^8.0.5",
+    "@babel/core": "^8.0.5",
+    "@babel/plugin-syntax-jsx": "^8.0.1",
+    "@babel/plugin-syntax-typescript": "^8.0.1",
+    "@babel/plugin-transform-runtime": "^8.0.1",
+    "@babel/preset-env": "^8.0.5",
+    "@babel/preset-react": "^8.0.1",
+    "@babel/preset-typescript": "^8.0.1",
+    "@eslint/compat": "^2.1.1",
     "@eslint/js": "^10.0.1",
-    "@eslint/json": "^2.0.1",
-    "@inquirer/confirm": "^6.1.1",
-    "@inquirer/select": "^5.2.1",
-    "@napi-rs/keyring": "^1.3.0",
-    "@octokit/auth-action": "^6.0.2",
-    "@octokit/oauth-methods": "^6.0.2",
+    "@eslint/json": "^2.1.0",
+    "@inquirer/confirm": "^6.3.2",
+    "@inquirer/select": "^5.2.5",
+    "@mui/internal-babel-plugin-display-name": "2.0.1-canary.0",
+    "@mui/internal-babel-plugin-minify-errors": "3.0.1-canary.0",
+    "@mui/internal-babel-plugin-resolve-imports": "3.0.1-canary.0",
+    "@napi-rs/keyring": "^2.0.0",
+    "@octokit/auth-action": "^6.0.3",
+    "@octokit/oauth-methods": "^6.0.5",
     "@octokit/rest": "^22.0.1",
+    "@pnpm/config.version-policy": "^1100.2.3",
     "@pnpm/find-workspace-dir": "^1000.1.5",
-    "@typescript-eslint/types": "^8.64.0",
-    "@typescript-eslint/utils": "^8.64.0",
-    "@vitest/eslint-plugin": "^1.6.23",
+    "@pnpm/parse-wanted-dependency": "^1001.0.0",
+    "@typescript-eslint/types": "^8.70.0",
+    "@typescript-eslint/utils": "^8.70.0",
+    "@vitest/eslint-plugin": "^1.6.27",
     "babel-plugin-optimize-clsx": "^2.6.2",
     "babel-plugin-react-compiler": "^1.0.0",
-    "babel-plugin-transform-import-meta": "^2.3.3",
-    "babel-plugin-transform-inline-environment-variables": "^0.4.4",
+    "babel-plugin-transform-import-meta": "^3.0.0",
     "babel-plugin-transform-react-remove-prop-types": "^0.4.24",
     "babel-plugin-transform-remove-imports": "^1.8.1",
-    "chalk": "^5.6.2",
+    "chalk": "^6.0.0",
     "clipboardy": "^5.3.2",
-    "content-type": "^2.0.0",
+    "content-type": "^3.1.0",
     "env-ci": "^11.2.0",
-    "es-toolkit": "^1.49.0",
+    "es-toolkit": "^1.52.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-module-utils": "^2.14.0",
@@ -93,19 +97,18 @@
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-mdx": "^3.8.1",
-    "eslint-plugin-mocha": "^11.3.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-compiler": "^19.1.0-rc.2",
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-testing-library": "^7.16.2",
-    "execa": "^9.6.1",
+    "execa": "^10.0.1",
     "git-url-parse": "^16.1.0",
-    "globals": "^17.7.0",
-    "globby": "^16.2.2",
-    "html-validate": "^11.5.6",
-    "minimatch": "^10.2.5",
-    "node-html-parser": "^9.0.0",
-    "open": "^11.0.0",
+    "globals": "^17.12.0",
+    "globby": "^16.2.4",
+    "html-validate": "^11.15.0",
+    "minimatch": "^10.2.6",
+    "node-html-parser": "^9.0.4",
+    "open": "^11.0.3",
     "postcss-styled-syntax": "^0.7.2",
     "regexp.escape": "^2.0.1",
     "rehype-slug": "^6.0.0",
@@ -129,33 +132,26 @@
     "resolve-pkg-maps": "^1.0.0",
     "semver": "^7.8.5",
     "stylelint-config-standard": "^40.0.0",
-    "typescript-eslint": "^8.64.0",
+    "typescript-eslint": "^8.70.0",
     "unified": "^11.0.5",
     "unified-lint-rule": "^3.0.1",
     "unist-util-visit": "^5.1.0",
-    "yaml": "^2.9.0",
-    "yargs": "^18.0.0",
-    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.23",
-    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.41",
-    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.30"
+    "yaml": "^2.9.1",
+    "yargs": "^18.1.0"
   },
   "peerDependencies": {
     "@next/eslint-plugin-next": "*",
-    "@typescript/native-preview": ">=7.0.0-dev.0",
     "eslint": "^9.0.0 || ^10.0.0",
     "prettier": "^3.0.0",
-    "typescript": "^5.0.0 || ^6.0.0"
+    "typescript": "^5.0.0 || ^6.0.0 || ^7.0.0"
   },
   "peerDependenciesMeta": {
-    "@typescript/native-preview": {
-      "optional": true
-    },
     "typescript": {
       "optional": true
     }
   },
   "devDependencies": {
-    "@octokit/types": "16.0.0",
+    "@octokit/types": "18.0.0",
     "@types/babel__core": "7.20.5",
     "@types/babel__preset-env": "7.10.0",
     "@types/env-ci": "3.1.4",
@@ -165,15 +161,17 @@
     "@types/mdast": "4.0.4",
     "@types/regexp.escape": "2.0.0",
     "@types/yargs": "17.0.35",
-    "@typescript-eslint/parser": "8.64.0",
-    "@typescript-eslint/rule-tester": "8.64.0",
-    "eslint": "10.7.0",
+    "@typescript-eslint/parser": "8.70.0",
+    "@typescript-eslint/rule-tester": "8.70.0",
+    "@typescript/native": "npm:typescript@7.0.2",
+    "eslint": "10.10.0",
     "get-port": "7.2.0",
-    "prettier": "3.9.5",
+    "prettier": "3.9.6",
     "remark": "15.0.1",
     "remark-mdx": "3.1.1",
     "serve": "14.2.6",
-    "typescript-eslint": "8.64.0"
+    "typescript": "npm:@typescript/typescript6@6.0.2",
+    "typescript-eslint": "8.70.0"
   },
   "files": [
     "bin",
@@ -188,10 +186,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitSha": "327b1eabb817e566026fbeb46767736701766d0d",
+  "gitSha": "764e3b3cfc14293e74e93f3413609025f502bab9",
   "scripts": {
-    "build": "tsgo -p tsconfig.build.json",
-    "typescript": "tsgo -noEmit",
+    "build": "tsc -p tsconfig.build.json",
+    "typescript": "tsc -noEmit",
     "test": "pnpm -w test --project @mui/internal-code-infra",
     "test:copy": "rm -rf build && node bin/code-infra.mjs copy-files --glob \"src/cli/*.mjs\" --glob \"src/eslint/**/*.mjs:esm\""
   }

package/src/babel-config.mjs

@@ -7,8 +7,8 @@ import pluginResolveImports from '@mui/internal-babel-plugin-resolve-imports';
 import pluginOptimizeClsx from 'babel-plugin-optimize-clsx';
 import pluginReactCompiler from 'babel-plugin-react-compiler';
 import pluginTransformImportMeta from 'babel-plugin-transform-import-meta';
-import pluginTransformInlineEnvVars from 'babel-plugin-transform-inline-environment-variables';
 import pluginRemovePropTypes from 'babel-plugin-transform-react-remove-prop-types';
+import pluginTransformInlineEnvVars from './babelPluginInlineEnvironmentVariables.mjs';
 
 /**
  * @typedef {'annotation' | 'syntax' | 'infer' | 'all'} ReactCompilationMode
@@ -26,7 +26,7 @@ import pluginRemovePropTypes from 'babel-plugin-transform-react-remove-prop-type
  * @param {string} [param0.reactCompilerReactVersion]
  * @param {ReactCompilationMode} [param0.reactCompilerMode]
  * @param {{ allowedCallees?: Record<string, string[]> }} [param0.displayName] - Options for the display name plugin.
- * @returns {import('@babel/core').TransformOptions} The base Babel configuration.
+ * @returns {import('@babel/core').InputOptions} The base Babel configuration.
  */
 export function getBaseConfig({
   debug = false,
@@ -44,22 +44,19 @@ export function getBaseConfig({
    * @type {import('@babel/preset-env').Options}
    */
   const presetEnvOptions = {
-    bugfixes: true,
     debug,
     modules: bundle === 'esm' ? false : 'commonjs',
     // @TODO
     browserslistEnv: bundle === 'esm' ? 'stable' : 'node',
   };
   /**
-   * @type {import('@babel/core').TransformOptions["plugins"]}
+   * @type {import('@babel/core').PluginItem[]}
    */
   const plugins = [
     [
       pluginTransformRuntime,
       {
         version: runtimeVersion,
-        regenerator: false,
-        useESModules: bundle === 'esm',
       },
       '@babel/plugin-transform-runtime',
     ],
@@ -143,12 +140,24 @@ export function getBaseConfig({
     presets: [
       [presetEnv, presetEnvOptions],
       [
-        presetReact,
-        { runtime: 'automatic', useBuiltIns: bundle === 'esm', useSpread: bundle === 'esm' },
+        presetTypescript,
+        {
+          // Babel 8 defaults this to `true`, which keeps `import { type A } from 'x'` as a
+          // side-effect `import 'x'`. Restore full elision so type-only imports don't create
+          // runtime module cycles.
+          onlyRemoveTypeImports: false,
+        },
       ],
-      [presetTypescript],
     ],
     plugins,
+    overrides: [
+      {
+        // Babel 8 keeps the JSX parser on for every file the React preset touches, which
+        // misparses generic arrows like `<T = unknown>(x) => x` in plain `.ts` files.
+        exclude: /\.[cm]?ts$/,
+        presets: [[presetReact, { runtime: 'automatic' }]],
+      },
+    ],
   };
 }
 
@@ -161,7 +170,7 @@ export function getBaseConfig({
 
 /**
  * @param {import('@babel/core').ConfigAPI | Options} api
- * @returns {import('@babel/core').TransformOptions}
+ * @returns {import('@babel/core').InputOptions}
  */
 export default function getBabelConfig(api) {
   /** @type {'esm' | 'cjs'} */
@@ -183,7 +192,8 @@ export default function getBabelConfig(api) {
     debug: process.env.MUI_BUILD_VERBOSE === 'true',
     bundle,
     outExtension: process.env.MUI_OUT_FILE_EXTENSION || null,
-    // any package needs to declare 7.25.0 as a runtime dependency. default is ^7.0.0
+    // Lower bound of @babel/runtime a consumer must ship; `code-infra build` reads the real
+    // version off the package's dependencies instead. Runtime 7 and 8 both satisfy this.
     runtimeVersion: process.env.MUI_BABEL_RUNTIME_VERSION || '^7.25.0',
     optimizeClsx: process.env.MUI_OPTIMIZE_CLSX === 'true',
     removePropTypes: process.env.MUI_REMOVE_PROP_TYPES === 'true',

package/src/babelPluginInlineEnvironmentVariables.mjs

@@ -0,0 +1,45 @@
+/**
+ * Inlines `process.env.X` member expressions with their build-time value.
+ *
+ * Forked from `babel-plugin-transform-inline-environment-variables` (unmaintained, last
+ * published 2022) because it calls the now-removed `NodePath#toComputedKey()` under Babel 8's
+ * `@babel/traverse`. Behavior is otherwise identical to the upstream plugin.
+ *
+ * @param {import('@babel/core').PluginAPI} api
+ * @returns {import('@babel/core').PluginObject}
+ */
+export default function babelPluginInlineEnvironmentVariables({ types: t }) {
+  /**
+   * @param {import('@babel/core').NodePath<import('@babel/core').types.MemberExpression>} path
+   */
+  function isLeftSideOfAssignmentExpression(path) {
+    return t.isAssignmentExpression(path.parent) && path.parent.left === path.node;
+  }
+
+  return {
+    name: 'transform-inline-environment-variables',
+    visitor: {
+      MemberExpression(
+        path,
+        /** @type {{ opts?: { include?: string[], exclude?: string[] } }} */ {
+          opts: { include, exclude } = {},
+        },
+      ) {
+        if (!path.get('object').matchesPattern('process.env')) {
+          return;
+        }
+
+        const key = t.toComputedKey(path.node);
+
+        if (
+          t.isStringLiteral(key) &&
+          !isLeftSideOfAssignmentExpression(path) &&
+          (!include || include.indexOf(key.value) !== -1) &&
+          (!exclude || exclude.indexOf(key.value) === -1)
+        ) {
+          path.replaceWith(t.valueToNode(process.env[key.value]));
+        }
+      },
+    },
+  };
+}

package/src/brokenLinksChecker/index.mjs

@@ -1,5 +1,5 @@
 /* eslint-disable no-console */
-import { execaCommand } from 'execa';
+import { execa, parseCommandString } from 'execa';
 import timers from 'node:timers/promises';
 import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
@@ -626,7 +626,7 @@ export async function crawl(rawOptions) {
     if (options.startCommand) {
       console.log(chalk.blue(`Starting server with "${options.startCommand}"...`));
       controller = new AbortController();
-      const appProcess = execaCommand(options.startCommand, {
+      const appProcess = execa({
         stdout: 'pipe',
         stderr: 'pipe',
         cancelSignal: controller.signal,
@@ -634,7 +634,7 @@ export async function crawl(rawOptions) {
           FORCE_COLOR: '1',
           ...process.env,
         },
-      });
+      })`${parseCommandString(options.startCommand)}`;
 
       // Prefix server logs
       const serverPrefix = chalk.gray('server: ');

package/src/cli/cmdArgosPush.mjs

@@ -46,8 +46,6 @@ export default /** @type {import('yargs').CommandModule<{}, Args>} */ ({
     const { folder, verbose = false } = argv;
 
     const argosToken = requireEnv('ARGOS_TOKEN');
-    const circleSha1 = requireEnv('CIRCLE_SHA1');
-    const circleBranch = requireEnv('CIRCLE_BRANCH');
     const circleBuildNum = requireEnv('CIRCLE_BUILD_NUM');
 
     const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'argos-screenshots-'));
@@ -92,8 +90,8 @@ export default /** @type {import('yargs').CommandModule<{}, Args>} */ ({
         // eslint-disable-next-line no-await-in-loop
         const result = await upload({
           root: `${tempDir}/${i}`,
-          commit: circleSha1,
-          branch: circleBranch,
+          // The SDK resolves `commit` and `branch`: it reads `ARGOS_COMMIT` and `ARGOS_BRANCH`
+          // first and falls back to `CIRCLE_SHA1` and `CIRCLE_BRANCH`.
           token: argosToken,
           threshold,
           parallel: {