@mui/internal-code-infra 0.0.4-canary.4 → 0.0.4-canary.40

package/build/utils/pnpm.d.mts

@@ -31,6 +31,7 @@ export type GetWorkspacePackagesOptions = {
     publicOnly?: boolean;
     nonPublishedOnly?: boolean;
     cwd?: string;
+    filter?: string[];
 };
 export declare function getWorkspacePackages(options?: {
     publicOnly: true;
@@ -49,13 +50,78 @@ export declare function getWorkspacePackages(options?: GetWorkspacePackagesOptio
  * @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 = {
+    workspacePathByName?: Map<string, string>;
+    includeDev?: boolean;
+};
+/**
+ * @typedef {Object} GetTransitiveDependenciesOptions
+ * @property {Map<string, string>} [workspacePathByName] - Map of workspace package name to directory path
+ * @property {boolean} [includeDev=true] - Whether to include devDependencies in the traversal
+ */
+/**
+ * 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. 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 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 publishPackages(packages: PublicPackage[], options?: PublishOptions): Promise<void>;
+export declare function validatePublishDependencies(packages: PublicPackage[]): Promise<{
+    issues: string[];
+}>;
 /**
  * Read package.json from a directory
  * @param {string} packagePath - Path to package directory

package/build/utils/testUtils.d.mts

@@ -0,0 +1,7 @@
+/**
+ * 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>;

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@mui/internal-code-infra",
-  "version": "0.0.4-canary.4",
+  "version": "0.0.4-canary.40",
+  "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",
@@ -32,6 +33,10 @@
       "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",
       "default": "./src/prettier.mjs"
@@ -52,28 +57,29 @@
     "code-infra": "./bin/code-infra.mjs"
   },
   "dependencies": {
-    "@argos-ci/core": "^4.5.0",
+    "@argos-ci/core": "^5.2.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-env": "^7.29.2",
     "@babel/preset-react": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
-    "@eslint/compat": "^2.0.2",
+    "@eslint/compat": "^2.0.3",
+    "@eslint/config-helpers": "^0.5.4",
     "@eslint/js": "^10.0.1",
-    "@eslint/json": "^1.0.1",
-    "@inquirer/confirm": "^6.0.4",
-    "@inquirer/select": "^5.0.4",
+    "@eslint/json": "^1.1.0",
+    "@inquirer/confirm": "^6.0.11",
+    "@inquirer/select": "^5.1.3",
     "@napi-rs/keyring": "^1.2.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.57.1",
+    "@typescript-eslint/utils": "^8.57.1",
+    "@vitest/eslint-plugin": "^1.6.11",
     "babel-plugin-optimize-clsx": "^2.6.2",
     "babel-plugin-react-compiler": "^1.0.0",
     "babel-plugin-transform-import-meta": "^2.3.3",
@@ -81,44 +87,61 @@
     "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",
+    "clipboardy": "^5.3.1",
     "content-type": "^1.0.5",
     "env-ci": "^11.2.0",
+    "es-toolkit": "^1.45.1",
     "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-plugin-compat": "^7.0.1",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-mdx": "^3.7.0",
     "eslint-plugin-mocha": "^11.2.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",
     "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",
+    "globals": "^17.5.0",
+    "globby": "^16.2.0",
+    "html-validate": "^10.13.0",
+    "minimatch": "^10.2.5",
+    "node-html-parser": "^7.1.0",
+    "open": "^11.0.0",
     "postcss-styled-syntax": "^0.7.1",
     "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",
     "stylelint-config-standard": "^40.0.0",
-    "typescript-eslint": "^8.56.1",
+    "typescript-eslint": "^8.57.1",
     "unified": "^11.0.5",
+    "unified-lint-rule": "^3.0.1",
+    "unist-util-visit": "^5.1.0",
     "yargs": "^18.0.0",
-    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.14",
-    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.24",
-    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.33"
+    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.36",
+    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.19",
+    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.27"
   },
   "peerDependencies": {
     "@next/eslint-plugin-next": "*",
@@ -144,27 +167,31 @@
     "@types/eslint-plugin-jsx-a11y": "6.10.1",
     "@types/estree": "1.0.8",
     "@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.57.1",
+    "@typescript-eslint/rule-tester": "8.57.1",
+    "eslint": "10.0.3",
+    "get-port": "7.2.0",
+    "prettier": "3.8.3",
+    "remark": "^15.0.1",
+    "remark-mdx": "^3.1.1",
+    "serve": "14.2.6",
+    "typescript-eslint": "8.57.1"
   },
   "files": [
     "bin",
     "build",
     "src",
+    "vale",
     "README.md",
     "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitSha": "96a7c608aa3603924622f70e8fe30cf084d59909",
+  "gitSha": "38a586faaccee1b655da0047f227fe82038494e8",
   "scripts": {
     "build": "tsgo -p tsconfig.build.json",
     "typescript": "tsgo -noEmit",

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),
   });
 }

package/src/brokenLinksChecker/__fixtures__/static-site/index.html

@@ -22,6 +22,7 @@
         <li><a href="/page-with-api-links.html">Page with API Links</a></li>
         <li><a href="/example.md">Example Markdown</a></li>
         <li><a href="/unclosed-tags.html">Page with Unclosed Tags</a></li>
+        <li><a href="/invalid-html.html">Invalid HTML Page</a></li>
       </ul>
     </nav>
   </body>

package/src/brokenLinksChecker/__fixtures__/static-site/invalid-html.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <title>Invalid HTML Page</title>
+  </head>
+  <body>
+    <h1>Invalid HTML</h1>
+    <!-- Duplicate ID (violates no-duplicate-id rule) -->
+    <div id="dup">First</div>
+    <div id="dup">Second</div>
+    <!-- Raw ampersand (violates no-raw-characters rule) -->
+    <p>Tom & Jerry</p>
+  </body>
+</html>

package/src/brokenLinksChecker/crawlWorker.mjs

@@ -0,0 +1,200 @@
+import { workerData, parentPort } from 'node:worker_threads';
+import { parse } from 'node-html-parser';
+import contentType from 'content-type';
+import { HtmlValidate, StaticConfigLoader, staticResolver } from 'html-validate';
+import { unified } from 'unified';
+import remarkParse from 'remark-parse';
+import remarkGfm from 'remark-gfm';
+import remarkRehype from 'remark-rehype';
+import rehypeSlug from 'rehype-slug';
+import rehypeStringify from 'rehype-stringify';
+
+/** @type {import('./index.mjs').CrawlWorkerInput} */
+const { pageUrl, options } = workerData;
+
+/**
+ * Tests if a value matches any of the patterns in the array.
+ * Returns true if patterns is undefined/empty (wildcard behavior).
+ * Strings use exact match, RegExp uses .test().
+ * @param {string} value
+ * @param {(string | RegExp)[] | undefined} patterns
+ * @returns {boolean}
+ */
+function matchesAnyPattern(value, patterns) {
+  if (!patterns || patterns.length === 0) {
+    return true;
+  }
+  return patterns.some((pattern) =>
+    typeof pattern === 'string' ? value === pattern : pattern.test(value),
+  );
+}
+
+/**
+ * Posts the crawl result back to the parent thread.
+ * @param {import('./index.mjs').CrawlWorkerOutput} output
+ */
+function postResult(output) {
+  if (!parentPort) {
+    throw new Error('crawlWorker must be run as a worker thread');
+  }
+  parentPort.postMessage(output);
+}
+
+/**
+ * Computes the accessible name of an element according to ARIA rules.
+ * @param {import('node-html-parser').HTMLElement | null} elm
+ * @param {import('node-html-parser').HTMLElement} ownerDocument
+ * @returns {string}
+ */
+function getAccessibleName(elm, ownerDocument) {
+  if (!elm) {
+    return '';
+  }
+
+  const ariaLabel = elm.getAttribute('aria-label')?.trim();
+  if (ariaLabel) {
+    return ariaLabel;
+  }
+
+  const labelledby = elm.getAttribute('aria-labelledby');
+  if (labelledby) {
+    const labels = [];
+    for (const id of labelledby.split(/\s+/)) {
+      const label = getAccessibleName(ownerDocument.getElementById(id), ownerDocument);
+      if (label) {
+        labels.push(label);
+      }
+    }
+    const label = labels.join(' ').trim();
+    if (label) {
+      return label;
+    }
+  }
+
+  if (elm.id) {
+    const label = ownerDocument.querySelector(`label[for="${elm.id}"]`);
+    if (label) {
+      return getAccessibleName(label, ownerDocument);
+    }
+  }
+
+  if (elm.tagName === 'IMG') {
+    const alt = elm.getAttribute('alt')?.trim();
+    if (alt) {
+      return alt;
+    }
+  }
+
+  return elm.innerText.trim();
+}
+
+/**
+ * Converts markdown content to HTML using unified pipeline.
+ * @param {string} markdown
+ * @returns {Promise<string>}
+ */
+async function markdownToHtml(markdown) {
+  const result = await unified()
+    .use(remarkParse)
+    .use(remarkGfm)
+    .use(remarkRehype)
+    .use(rehypeSlug)
+    .use(rehypeStringify)
+    .process(markdown);
+  return String(result);
+}
+
+const res = await fetch(new URL(pageUrl, options.host));
+
+const contentTypeHeader = res.headers.get('content-type');
+let type = 'text/html';
+
+if (contentTypeHeader) {
+  try {
+    const parsed = contentType.parse(contentTypeHeader);
+    type = parsed.type;
+  } catch {
+    // invalid content-type, default to text/html
+  }
+}
+
+/** @type {import('./index.mjs').CrawlWorkerPageData} */
+const pageData = {
+  url: pageUrl,
+  status: res.status,
+  targets: [],
+  contentType: type,
+};
+
+if (pageData.status < 200 || pageData.status >= 400) {
+  postResult({ pageData, links: [], htmlValidateResults: null });
+} else if (type.startsWith('image/') || (type !== 'text/html' && type !== 'text/markdown')) {
+  postResult({ pageData, links: [], htmlValidateResults: null });
+} else {
+  const rawContent = await res.text();
+
+  const content = type === 'text/markdown' ? await markdownToHtml(rawContent) : rawContent;
+
+  const dom = parse(content, { parseNoneClosedTags: true });
+
+  // Extract targets
+  for (const target of dom.querySelectorAll('*[id]')) {
+    if (!options.ignoredTargets.has(target.id)) {
+      pageData.targets.push(`#${target.id}`);
+    }
+  }
+
+  // Extract links
+  let ignoredSelector = ':not(*)';
+  if (options.ignoredContent.length > 0) {
+    ignoredSelector = Array.from(options.ignoredContent)
+      .flatMap((selector) => [selector, `${selector} *`])
+      .join(',');
+  }
+  const linksSelector = `a[href]:not(${ignoredSelector})`;
+
+  const links = dom.querySelectorAll(linksSelector).map((a) => ({
+    src: pageUrl,
+    text: getAccessibleName(a, dom),
+    href: a.getAttribute('href') ?? '',
+    contentType: type,
+  }));
+
+  // HTML validation. Walk every entry and remember the last one whose path
+  // matches the current page — last match wins, so callers can layer
+  // specific overrides after a default entry.
+  /** @type {{ pageUrl: string, results: import('html-validate').Result[] } | null} */
+  let htmlValidateResults = null;
+  if (type === 'text/html' && options.htmlValidate.length > 0) {
+    /** @type {import('./index.mjs').ResolvedHtmlValidateEntry | null} */
+    let matchedEntry = null;
+    for (const entry of options.htmlValidate) {
+      if (matchesAnyPattern(pageUrl, entry.path)) {
+        matchedEntry = entry;
+      }
+    }
+
+    if (matchedEntry) {
+      const muiHtmlValidateResolver = staticResolver({
+        configs: {
+          'mui:recommended': {
+            extends: ['html-validate:standard', 'html-validate:document', 'html-validate:browser'],
+            rules: {
+              // TODO: Enable when subresource integrity is adopted across projects
+              'require-sri': 'off',
+            },
+          },
+        },
+      });
+
+      const htmlValidator = new HtmlValidate(
+        new StaticConfigLoader([muiHtmlValidateResolver], matchedEntry.config),
+      );
+
+      const report = await htmlValidator.validateString(rawContent, pageUrl);
+      htmlValidateResults = { pageUrl, results: report.results };
+    }
+  }
+
+  postResult({ pageData, links, htmlValidateResults });
+}