@mui/internal-code-infra 0.0.4-canary.3 → 0.0.4-canary.31

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@mui/internal-code-infra",
-  "version": "0.0.4-canary.3",
+  "version": "0.0.4-canary.31",
+  "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",
@@ -43,34 +44,38 @@
     "./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",
+    "@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",
@@ -78,13 +83,14 @@
     "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-mocha": "^11.2.0",
@@ -92,14 +98,14 @@
     "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",
+    "globals": "^17.5.0",
     "globby": "^16.1.1",
-    "minimatch": "^10.2.2",
-    "node-html-parser": "^7.0.2",
-    "open": "^10.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",
@@ -110,12 +116,12 @@
     "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",
     "yargs": "^18.0.0",
-    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.14",
-    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.33",
-    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.24"
+    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.18",
+    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.27",
+    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.36"
   },
   "peerDependencies": {
     "@next/eslint-plugin-next": "*",
@@ -143,25 +149,26 @@
     "@types/estree-jsx": "1.0.5",
     "@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",
+    "serve": "14.2.6",
+    "typescript-eslint": "8.57.1"
   },
   "files": [
     "bin",
     "build",
     "src",
+    "vale",
     "README.md",
     "LICENSE"
   ],
   "publishConfig": {
     "access": "public"
   },
-  "gitSha": "b172a15e6b44720b15353ba8b15816cbbf5674e8",
+  "gitSha": "b5ecb08ed447855ed858e123d924a08949b6ad6d",
   "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,173 @@
+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;
+
+/**
+ * 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
+  /** @type {{ pageUrl: string, results: import('html-validate').Result[] } | null} */
+  let htmlValidateResults = null;
+  if (options.htmlValidate && type === 'text/html') {
+    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], options.htmlValidate),
+    );
+
+    const report = await htmlValidator.validateString(rawContent, pageUrl);
+    if (!report.valid) {
+      htmlValidateResults = { pageUrl, results: report.results };
+    }
+  }
+
+  postResult({ pageData, links, htmlValidateResults });
+}