@mui/internal-code-infra 0.0.4-canary.1 → 0.0.4-canary.100

package/build/utils/pnpm.d.mts

@@ -1,61 +1,226 @@
 #!/usr/bin/env node
 export type PrivatePackage = {
+    /**
+     * - Package name
+     */
     name?: string;
+    /**
+     * - Package version
+     */
     version?: string;
+    /**
+     * - Package directory path
+     */
     path: string;
+    /**
+     * - Whether the package is private
+     */
     isPrivate: true;
 };
 export type PublicPackage = {
+    /**
+     * - Package name
+     */
     name: string;
+    /**
+     * - Package version
+     */
     version: string;
+    /**
+     * - Package directory path
+     */
     path: string;
+    /**
+     * - Whether the package is private
+     */
     isPrivate: false;
 };
 export type VersionInfo = {
+    /**
+     * - Whether current version exists on npm
+     */
     currentVersionExists: boolean;
+    /**
+     * - Latest canary version if available
+     */
     latestCanaryVersion: string | null;
 };
 export type PublishOptions = {
+    /**
+     * - Whether to run in dry-run mode
+     */
     dryRun?: boolean;
+    /**
+     * - Whether to skip git checks
+     */
     noGitChecks?: boolean;
+    /**
+     * - NPM dist tag to publish to
+     */
     tag?: string;
 };
 export type PnpmListResultItem = {
+    /**
+     * - Package name
+     */
     name?: string;
+    /**
+     * - Package version
+     */
     version?: string;
+    /**
+     * - Package directory path
+     */
     path: string;
+    /**
+     * - Whether the package is private
+     */
     private: boolean;
 };
 export type GetWorkspacePackagesOptions = {
+    /**
+     * - Git reference to filter changes since
+     */
     sinceRef?: string | null;
+    /**
+     * - Whether to filter to only public packages
+     */
     publicOnly?: boolean;
-    nonPublishedOnly?: boolean;
+    /**
+     * - Current working directory to run pnpm command in
+     */
     cwd?: string;
+    /**
+     * - Same as filtering packages with --filter in pnpm. Only include packages matching the filter. See https://pnpm.io/filtering.
+     */
+    filter?: string[];
 };
 export declare function getWorkspacePackages(options?: {
     publicOnly: true;
 } & GetWorkspacePackagesOptions): Promise<PublicPackage[]>;
-export declare function getWorkspacePackages(options?: {
-    nonPublishedOnly: true;
-} & GetWorkspacePackagesOptions): Promise<PublicPackage[]>;
 export declare function getWorkspacePackages(options?: {
     publicOnly?: false | undefined;
 } & GetWorkspacePackagesOptions): Promise<PrivatePackage[]>;
 export declare function getWorkspacePackages(options?: GetWorkspacePackagesOptions): Promise<(PrivatePackage | PublicPackage)[]>;
 /**
- * Get package version info from registry
+ * Resolve the registry a package will be published to.
+ *
+ * Only `publishConfig.registry` and the ambient `npm_config_registry` are
+ * consulted — `.npmrc` layering and `@scope:registry` entries are not.
+ *
+ * @param {string} packagePath - Path to the package directory
+ * @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.
+ *
+ * A brand new package has to be pushed once manually (see
+ * `code-infra publish-new-package`) before the OIDC-based workflow can publish
+ * it, so the release fails with a clear message instead of a confusing 404
+ * midway through. See {@link getPackageVersionInfo} for the version-level check.
+ *
+ * @param {PublicPackage[]} packages - Packages to check
+ * @returns {Promise<PublicPackage[]>} The subset needing a manual first publish
+ */
+export declare function getPackagesNeedingManualPublish(packages: PublicPackage[]): Promise<PublicPackage[]>;
+/**
+ * Get package version info from registry.
+ *
+ * Resolves through `pnpm view`, which reports a lookup failure the same way it
+ * reports a missing version. Use {@link getPackagesNeedingManualPublish} where
+ * absence has to be told apart from an error.
+ *
  * @param {string} packageName - Name of the package
  * @param {string} baseVersion - Base version to check
  * @returns {Promise<VersionInfo>} Version information
  */
 export declare function getPackageVersionInfo(packageName: string, baseVersion: string): Promise<VersionInfo>;
+export type PublishSummaryEntry = {
+    name: string;
+    version: string;
+};
+/**
+ * @typedef {Object} PublishSummaryEntry
+ * @property {string} name
+ * @property {string} version
+ */
 /**
  * Publish packages with the given options
  * @param {PublicPackage[]} packages - Packages to publish
  * @param {PublishOptions} [options={}] - Publishing options
- * @returns {Promise<void>}
+ * @returns {Promise<PublishSummaryEntry[]>}
+ */
+export declare function publishPackages(packages: PublicPackage[], options?: PublishOptions): Promise<PublishSummaryEntry[]>;
+export type GetTransitiveDependenciesOptions = {
+    /**
+     * - Map of workspace package name to directory path
+     */
+    workspacePathByName?: Map<string, string>;
+    /**
+     * - Whether to include devDependencies in the traversal
+     */
+    includeDev?: boolean;
+};
+/**
+ * Get all transitive workspace dependencies for a set of packages.
+ *
+ * Only follows deps whose version spec starts with `workspace:` (e.g. `workspace:*`
+ * or `workspace:^`), meaning they are sourced directly from the monorepo. An
+ * alias spec (`workspace:@scope/name@range`) is followed to the package it
+ * targets, which need not match the dependency key. Pinned
+ * external versions (e.g. `^1.0.0`) are ignored even when the package name exists
+ * in the workspace. Traverses `dependencies` and optionally `devDependencies`.
+ * Results are cached per package so each package is read from disk at most once
+ * regardless of how many roots depend on it.
+ *
+ * @param {string[]} packageNames - Package names to start the traversal from
+ * @param {GetTransitiveDependenciesOptions} [options]
+ * @returns {Promise<Set<string>>} All reachable workspace package names, including the input packages themselves
  */
-export declare function publishPackages(packages: PublicPackage[], options?: PublishOptions): Promise<void>;
+export declare function getTransitiveDependencies(packageNames: string[], options?: GetTransitiveDependenciesOptions): Promise<Set<string>>;
+/**
+ * Pure validation logic: given a publish set and workspace maps, checks that all
+ * transitive hard workspace dependencies are covered and none are private.
+ *
+ * A hard dependency is one listed in `dependencies` (not `peerDependencies` or
+ * `devDependencies`) using a `workspace:` version specifier (e.g. `workspace:*` or
+ * `workspace:^`). Peer dependencies are never bundled and dev dependencies are not installed
+ * on consumer devices - both are excluded regardless of version specifier. Pinned-version
+ * references in `dependencies` are also excluded - they resolve from the registry and do
+ * not need to be co-published.
+ *
+ * @param {PublicPackage[]} packages - The packages intended for publishing
+ * @param {Map<string, PublicPackage | PrivatePackage>} workspacePackageByName - All workspace packages by name
+ * @param {Map<string, string>} workspacePathByName - Map of workspace package name to directory path
+ * @returns {Promise<{issues: string[]}>}
+ *   List of human-readable issue strings. Empty when the dependency set is valid.
+ * @internal
+ */
+export declare function checkPublishDependencies(packages: PublicPackage[], workspacePackageByName: Map<string, PublicPackage | PrivatePackage>, workspacePathByName: Map<string, string>): Promise<{
+    issues: string[];
+}>;
+/**
+ * Validate that a set of packages covers all of their transitive hard workspace dependencies,
+ * and that none of those dependencies are private (which would make them unpublishable).
+ *
+ * @param {PublicPackage[]} packages - The packages intended for publishing
+ * @returns {Promise<{issues: string[]}>}
+ *   List of human-readable issue strings. Empty when the dependency set is valid.
+ */
+export declare function validatePublishDependencies(packages: PublicPackage[]): Promise<{
+    issues: string[];
+}>;
 /**
  * Read package.json from a directory
  * @param {string} packagePath - Path to package directory
@@ -69,6 +234,34 @@ export declare function readPackageJson(packagePath: string): Promise<import('..
  * @returns {Promise<void>}
  */
 export declare function writePackageJson(packagePath: string, packageJson: Object): Promise<void>;
+/**
+ * Write the computed overrides into whichever manifest already defines
+ * overrides — preferring pnpm-workspace.yaml, falling back to package.json
+ * `pnpm.overrides`, defaulting to pnpm-workspace.yaml — and persist the result.
+ * A missing pnpm-workspace.yaml is treated as empty, so a fresh file is created
+ * with just the `overrides:` block. Rejects a `resolutions` field in
+ * package.json because pnpm 11 silently ignores it.
+ *
+ * @param {string} workspaceDir - Workspace root directory
+ * @param {Record<string, string>} overrides - Overrides to apply
+ * @returns {Promise<void>}
+ */
+export declare function writeOverridesToWorkspace(workspaceDir: string, overrides: Record<string, string>): Promise<void>;
+/**
+ * Move the publishable workspace packages in one scope to another.
+ *
+ * Only packages that are part of the workspace are touched, so dependencies
+ * that merely share the scope but come from the registry (say `@base-ui/react`
+ * alongside a workspace `@base-ui/mosaic`) are left alone. Dependents keep the
+ * original dependency name and gain a `workspace:` alias, so imports in the
+ * repo resolve exactly as before.
+ *
+ * @param {(PublicPackage | PrivatePackage)[]} packages - All workspace packages
+ * @param {string} fromScope - Scope to move away from
+ * @param {string} toScope - Scope to move to
+ * @returns {Promise<Map<string, string>>} Old package name to new package name
+ */
+export declare function renameWorkspaceScope(packages: (PublicPackage | PrivatePackage)[], fromScope: string, toScope: string): Promise<Map<string, string>>;
 /**
  * Resolve a package@version specifier to an exact version
  * @param {string} packageSpec - Package specifier in format "package@version"

package/build/utils/testUtils.d.mts

@@ -0,0 +1,28 @@
+/**
+ * Creates a temporary directory and registers an `onTestFinished` hook to
+ * remove it automatically when the current test ends — even if the test throws.
+ *
+ * @returns {Promise<string>} The path of the created temporary directory.
+ */
+export declare function makeTempDir(): Promise<string>;
+/**
+ * Write a package.json into a subdirectory of a temp workspace.
+ *
+ * @param {string} root - Workspace root
+ * @param {string} dir - Subdirectory to create
+ * @param {object} pkgJson - Manifest contents
+ * @returns {Promise<string>} The package directory
+ */
+export declare function writePackage(root: string, dir: string, pkgJson: object): Promise<string>;
+/**
+ * @param {string} name
+ * @param {string} pkgPath
+ * @returns {import('./pnpm.mjs').PublicPackage}
+ */
+export declare function publicPkg(name: string, pkgPath: string): import('./pnpm.mjs').PublicPackage;
+/**
+ * @param {string} name
+ * @param {string} pkgPath
+ * @returns {import('./pnpm.mjs').PrivatePackage}
+ */
+export declare function privatePkg(name: string, pkgPath: string): import('./pnpm.mjs').PrivatePackage;

package/build/utils/typescript.d.mts

@@ -22,19 +22,14 @@ export declare function copyDeclarations(sourceDirectory: string, destinationDir
  * @param {Object} param0
  * @param {string} param0.inputDir
  * @param {string} param0.buildDir
- * @param {{type: import('../utils/build.mjs').BundleType, dir: string}[]} param0.bundles
- * @param {boolean} [param0.isFlat]
+ * @param {import('../utils/build.mjs').BundleType[]} param0.bundles
  * @param {'module' | 'commonjs'} [param0.packageType]
  * @returns
  */
-export declare function moveAndTransformDeclarations({ inputDir, buildDir, bundles, isFlat, packageType }: {
+export declare function moveAndTransformDeclarations({ inputDir, buildDir, bundles, packageType }: {
     inputDir: string;
     buildDir: string;
-    bundles: {
-        type: import('../utils/build.mjs').BundleType;
-        dir: string;
-    }[];
-    isFlat?: boolean;
+    bundles: import('../utils/build.mjs').BundleType[];
     packageType?: 'module' | 'commonjs';
 }): Promise<void>;
 /**
@@ -43,9 +38,8 @@ export declare function moveAndTransformDeclarations({ inputDir, buildDir, bundl
  * After copying, babel transformations are applied to the copied files because they need to be alongside the actual js files for proper resolution.
  *
  * @param {Object} param0
- * @param {boolean} [param0.isFlat = false] - Whether to place generated declaration files in a flattened directory.
  * @param {boolean} [param0.verbose = false] - Whether to log additional information while generating and moving declaration files.
- * @param {{type: import('../utils/build.mjs').BundleType, dir: string}[]} param0.bundles - The bundles to create declarations for.
+ * @param {import('../utils/build.mjs').BundleType[]} param0.bundles - The bundles to create declarations for.
  * @param {string} param0.srcDir - The source directory.
  * @param {string} param0.buildDir - The build directory.
  * @param {string} param0.cwd - The current working directory.
@@ -53,13 +47,9 @@ export declare function moveAndTransformDeclarations({ inputDir, buildDir, bundl
  * @param {boolean} [param0.useTsgo=false] - Whether to build types using typescript native (tsgo).
  * @param {'module' | 'commonjs'} [param0.packageType] - The package.json type field.
  */
-export declare function createTypes({ bundles, srcDir, buildDir, cwd, skipTsc, useTsgo, isFlat, packageType, verbose }: {
-    isFlat?: boolean;
+export declare function createTypes({ bundles, srcDir, buildDir, cwd, skipTsc, useTsgo, packageType, verbose, }: {
     verbose?: boolean;
-    bundles: {
-        type: import('../utils/build.mjs').BundleType;
-        dir: string;
-    }[];
+    bundles: import('../utils/build.mjs').BundleType[];
     srcDir: string;
     buildDir: string;
     cwd: string;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@mui/internal-code-infra",
-  "version": "0.0.4-canary.1",
+  "version": "0.0.4-canary.100",
+  "author": "MUI Team",
   "description": "Infra scripts and configs to be used across MUI repos.",
-  "type": "module",
   "license": "MIT",
+  "type": "module",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mui/mui-public.git",
@@ -28,9 +29,9 @@
       "types": "./build/utils/github.d.mts",
       "default": "./src/utils/github.mjs"
     },
-    "./markdownlint": {
-      "types": "./build/markdownlint/index.d.mts",
-      "default": "./src/markdownlint/index.mjs"
+    "./remark": {
+      "types": "./build/remark/config.d.mts",
+      "default": "./src/remark/config.mjs"
     },
     "./prettier": {
       "types": "./build/prettier.d.mts",
@@ -43,34 +44,37 @@
     "./brokenLinksChecker": {
       "types": "./build/brokenLinksChecker/index.d.mts",
       "default": "./src/brokenLinksChecker/index.mjs"
+    },
+    "./build-env": {
+      "types": "./src/build-env.d.ts"
     }
   },
   "bin": {
     "code-infra": "./bin/code-infra.mjs"
   },
   "dependencies": {
-    "@argos-ci/core": "^4.5.0",
-    "@babel/cli": "^7.28.6",
-    "@babel/core": "^7.29.0",
-    "@babel/plugin-syntax-jsx": "^7.28.6",
-    "@babel/plugin-syntax-typescript": "^7.28.6",
-    "@babel/plugin-transform-runtime": "^7.29.0",
-    "@babel/preset-env": "^7.29.0",
-    "@babel/preset-react": "^7.28.5",
-    "@babel/preset-typescript": "^7.28.5",
-    "@eslint/compat": "^2.0.2",
+    "@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",
     "@eslint/js": "^10.0.1",
-    "@eslint/json": "^1.0.1",
-    "@inquirer/confirm": "^6.0.4",
-    "@inquirer/select": "^5.0.4",
-    "@napi-rs/keyring": "^1.2.0",
+    "@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",
     "@octokit/rest": "^22.0.1",
-    "@pnpm/find-workspace-dir": "^1000.1.4",
-    "@typescript-eslint/types": "^8.56.1",
-    "@typescript-eslint/utils": "^8.56.1",
-    "@vitest/eslint-plugin": "^1.6.9",
+    "@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",
     "babel-plugin-optimize-clsx": "^2.6.2",
     "babel-plugin-react-compiler": "^1.0.0",
     "babel-plugin-transform-import-meta": "^2.3.3",
@@ -78,51 +82,69 @@
     "babel-plugin-transform-react-remove-prop-types": "^0.4.24",
     "babel-plugin-transform-remove-imports": "^1.8.1",
     "chalk": "^5.6.2",
-    "clipboardy": "^5.3.0",
-    "content-type": "^1.0.5",
+    "clipboardy": "^5.3.2",
+    "content-type": "^2.0.0",
     "env-ci": "^11.2.0",
+    "es-toolkit": "^1.49.0",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-module-utils": "^2.12.1",
-    "eslint-plugin-compat": "^6.2.0",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-module-utils": "^2.14.0",
+    "eslint-plugin-compat": "^7.0.2",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-mocha": "^11.2.0",
+    "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.0.1",
-    "eslint-plugin-testing-library": "^7.16.0",
-    "es-toolkit": "^1.44.0",
+    "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-testing-library": "^7.16.2",
     "execa": "^9.6.1",
     "git-url-parse": "^16.1.0",
-    "globals": "^16.5.0",
-    "globby": "^16.1.1",
-    "minimatch": "^10.2.2",
-    "node-html-parser": "^7.0.2",
-    "open": "^10.2.0",
-    "postcss-styled-syntax": "^0.7.1",
+    "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",
+    "postcss-styled-syntax": "^0.7.2",
     "regexp.escape": "^2.0.1",
     "rehype-slug": "^6.0.0",
     "rehype-stringify": "^10.0.1",
+    "remark-frontmatter": "^5.0.0",
     "remark-gfm": "^4.0.1",
+    "remark-lint": "^10.0.1",
+    "remark-lint-code-block-style": "^4.0.1",
+    "remark-lint-fenced-code-flag": "^4.2.0",
+    "remark-lint-heading-increment": "^4.0.1",
+    "remark-lint-heading-style": "^4.0.1",
+    "remark-lint-no-duplicate-headings": "^4.0.1",
+    "remark-lint-no-empty-url": "^4.0.1",
+    "remark-lint-no-heading-punctuation": "^4.0.1",
+    "remark-lint-no-multiple-toplevel-headings": "^4.0.1",
+    "remark-lint-no-undefined-references": "^5.0.2",
+    "remark-lint-no-unused-definitions": "^4.0.2",
+    "remark-lint-table-pipes": "^5.0.1",
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "resolve-pkg-maps": "^1.0.0",
-    "semver": "^7.7.4",
+    "semver": "^7.8.5",
     "stylelint-config-standard": "^40.0.0",
-    "typescript-eslint": "^8.56.1",
+    "typescript-eslint": "^8.64.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.13",
-    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.32",
-    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.22"
+    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.23",
+    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.30",
+    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.41"
   },
   "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"
+    "typescript": "^5.0.0 || ^6.0.0"
   },
   "peerDependenciesMeta": {
     "@typescript/native-preview": {
@@ -136,35 +158,40 @@
     "@octokit/types": "16.0.0",
     "@types/babel__core": "7.20.5",
     "@types/babel__preset-env": "7.10.0",
-    "@types/content-type": "1.1.9",
     "@types/env-ci": "3.1.4",
     "@types/eslint-plugin-jsx-a11y": "6.10.1",
-    "@types/estree": "1.0.8",
+    "@types/estree": "1.0.9",
     "@types/estree-jsx": "1.0.5",
+    "@types/mdast": "4.0.4",
     "@types/regexp.escape": "2.0.0",
     "@types/yargs": "17.0.35",
-    "@typescript-eslint/parser": "8.56.1",
-    "@typescript-eslint/rule-tester": "8.56.1",
-    "eslint": "10.0.2",
-    "get-port": "7.1.0",
-    "prettier": "3.8.1",
-    "serve": "14.2.5",
-    "typescript-eslint": "8.56.1"
+    "@typescript-eslint/parser": "8.64.0",
+    "@typescript-eslint/rule-tester": "8.64.0",
+    "eslint": "10.7.0",
+    "get-port": "7.2.0",
+    "prettier": "3.9.5",
+    "remark": "15.0.1",
+    "remark-mdx": "3.1.1",
+    "serve": "14.2.6",
+    "typescript-eslint": "8.64.0"
   },
   "files": [
     "bin",
     "build",
     "src",
+    "vale",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "!src/**/__fixtures__/**",
+    "!src/**/*.test.*"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitSha": "4fc3292722f406f8eae122597b124749bf54476d",
+  "gitSha": "6542022a25f84984a49b5a8beafdff2df0e0966b",
   "scripts": {
     "build": "tsgo -p tsconfig.build.json",
-    "typescript": "tsgo -p tsconfig.json",
+    "typescript": "tsgo -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

@@ -10,6 +10,10 @@ 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';
 
+/**
+ * @typedef {'annotation' | 'syntax' | 'infer' | 'all'} ReactCompilationMode
+ */
+
 /**
  * @param {Object} param0
  * @param {boolean} [param0.debug]
@@ -20,7 +24,8 @@ import pluginRemovePropTypes from 'babel-plugin-transform-react-remove-prop-type
  * @param {string | null} param0.outExtension - Specify the output file extension.
  * @param {string} param0.runtimeVersion
  * @param {string} [param0.reactCompilerReactVersion]
- * @param {string} [param0.reactCompilerMode]
+ * @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.
  */
 export function getBaseConfig({
@@ -33,6 +38,7 @@ export function getBaseConfig({
   outExtension,
   reactCompilerReactVersion,
   reactCompilerMode,
+  displayName,
 }) {
   /**
    * @type {import('@babel/preset-env').Options}
@@ -57,7 +63,7 @@ export function getBaseConfig({
       },
       '@babel/plugin-transform-runtime',
     ],
-    [pluginDisplayName, {}, '@mui/internal-babel-plugin-display-name'],
+    [pluginDisplayName, { ...displayName }, '@mui/internal-babel-plugin-display-name'],
     [
       pluginTransformInlineEnvVars,
       {
@@ -183,6 +189,6 @@ export default function getBabelConfig(api) {
     removePropTypes: process.env.MUI_REMOVE_PROP_TYPES === 'true',
     noResolveImports,
     reactCompilerReactVersion: process.env.MUI_REACT_COMPILER_REACT_VERSION,
-    reactCompilerMode: process.env.MUI_REACT_COMPILER_MODE,
+    reactCompilerMode: /** @type {ReactCompilationMode} */ (process.env.MUI_REACT_COMPILER_MODE),
   });
 }