@mui/internal-code-infra 0.0.3-canary.6 → 0.0.3-canary.60

package/build/utils/typescript.d.mts

@@ -0,0 +1,35 @@
+/**
+ * Emits TypeScript declaration files.
+ * @param {string} tsconfig - The path to the tsconfig.json file.
+ * @param {string} outDir - The output directory for the declaration files.
+ */
+export function emitDeclarations(tsconfig: string, outDir: string): Promise<void>;
+/**
+ * @param {string} sourceDirectory
+ * @param {string} destinationDirectory
+ */
+export function copyDeclarations(sourceDirectory: string, destinationDirectory: string): Promise<void>;
+/**
+ * Creates TypeScript declaration files for the specified bundles.
+ * Types are first created in a temporary directory and then copied to the appropriate bundle directories parallelly.
+ * 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.isMjsBuild] - Whether the build is for ESM (ECMAScript Modules).
+ * @param {{type: import('../utils/build.mjs').BundleType, dir: string}[]} 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.
+ * @param {boolean} param0.skipTsc - Whether to skip running TypeScript compiler (tsc) for building types.
+ */
+export function createTypes({ bundles, srcDir, buildDir, cwd, skipTsc, isMjsBuild }: {
+    isMjsBuild?: boolean | undefined;
+    bundles: {
+        type: import("../utils/build.mjs").BundleType;
+        dir: string;
+    }[];
+    srcDir: string;
+    buildDir: string;
+    cwd: string;
+    skipTsc: boolean;
+}): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-code-infra",
-  "version": "0.0.3-canary.6",
+  "version": "0.0.3-canary.60",
   "description": "Infra scripts and configs to be used across MUI repos.",
   "type": "module",
   "license": "MIT",
@@ -12,76 +12,125 @@
   "sideEffects": false,
   "exports": {
     "./package.json": "./package.json",
-    "./prettier": "./src/prettier.mjs",
-    "./eslint": "./src/eslint/index.mjs",
-    "./babel-config": "./src/babel-config.mjs",
-    "./markdownlint": "./src/markdownlint/index.mjs"
+    "./babel-config": {
+      "types": "./build/babel-config.d.mts",
+      "default": "./src/babel-config.mjs"
+    },
+    "./changelog": {
+      "types": "./build/utils/changelog.d.mts",
+      "default": "./src/utils/changelog.mjs"
+    },
+    "./eslint": {
+      "types": "./build/eslint/index.d.mts",
+      "default": "./src/eslint/index.mjs"
+    },
+    "./github": {
+      "types": "./build/utils/github.d.mts",
+      "default": "./src/utils/github.mjs"
+    },
+    "./markdownlint": {
+      "types": "./build/markdownlint/index.d.mts",
+      "default": "./src/markdownlint/index.mjs"
+    },
+    "./prettier": {
+      "types": "./build/prettier.d.mts",
+      "default": "./src/prettier.mjs"
+    },
+    "./stylelint": {
+      "types": "./build/stylelint/index.d.mts",
+      "default": "./src/stylelint/index.mjs"
+    },
+    "./brokenLinksChecker": {
+      "types": "./build/brokenLinksChecker/index.d.mts",
+      "default": "./src/brokenLinksChecker/index.mjs"
+    }
   },
   "bin": {
     "code-infra": "./bin/code-infra.mjs"
   },
   "dependencies": {
-    "@argos-ci/core": "^4.1.2",
+    "@argos-ci/core": "^4.5.0",
     "@babel/cli": "^7.28.3",
-    "@babel/core": "^7.28.4",
+    "@babel/core": "^7.28.5",
     "@babel/plugin-syntax-jsx": "^7.27.1",
     "@babel/plugin-syntax-typescript": "^7.27.1",
-    "@babel/plugin-transform-runtime": "^7.28.3",
-    "@babel/preset-env": "^7.28.3",
-    "@babel/preset-react": "^7.27.1",
-    "@babel/preset-typescript": "^7.27.1",
-    "@eslint/compat": "^1.3.2",
-    "@eslint/js": "^9.35.0",
-    "@next/eslint-plugin-next": "^15.5.2",
-    "@octokit/auth-action": "^6.0.1",
-    "@octokit/rest": "^22.0.0",
-    "@pnpm/find-workspace-dir": "^1000.1.2",
+    "@babel/plugin-transform-runtime": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/preset-react": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@eslint/compat": "^2.0.0",
+    "@eslint/js": "^9.39.1",
+    "@eslint/json": "^0.14.0",
+    "@inquirer/confirm": "^5.1.21",
+    "@inquirer/select": "^5.0.2",
+    "@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.3",
+    "@vitest/eslint-plugin": "^1.5.1",
     "babel-plugin-optimize-clsx": "^2.6.2",
+    "babel-plugin-react-compiler": "^1.0.0",
     "babel-plugin-transform-inline-environment-variables": "^0.4.4",
     "babel-plugin-transform-react-remove-prop-types": "^0.4.24",
-    "babel-plugin-transform-remove-imports": "^1.8.0",
-    "chalk": "^5.6.0",
+    "babel-plugin-transform-remove-imports": "^1.8.1",
+    "chalk": "^5.6.2",
+    "clipboardy": "^5.0.1",
+    "content-type": "^1.0.5",
+    "env-ci": "^11.2.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-module-utils": "^2.12.1",
+    "eslint-plugin-compat": "^6.0.2",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-mocha": "^11.1.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": "^6.0.0-rc1",
-    "eslint-plugin-testing-library": "^7.6.8",
-    "execa": "^9.6.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-testing-library": "^7.13.3",
+    "execa": "^9.6.1",
     "git-url-parse": "^16.1.0",
-    "globals": "^16.3.0",
-    "globby": "^14.1.0",
-    "lodash-es": "^4.17.21",
-    "minimatch": "^10.0.3",
-    "semver": "^7.7.2",
-    "typescript-eslint": "^8.42.0",
+    "globals": "^16.5.0",
+    "globby": "^15.0.0",
+    "minimatch": "^10.1.1",
+    "node-html-parser": "^7.0.1",
+    "open": "^10.2.0",
+    "postcss-styled-syntax": "^0.7.1",
+    "regexp.escape": "^2.0.1",
+    "resolve-pkg-maps": "^1.0.0",
+    "semver": "^7.7.3",
+    "stylelint-config-standard": "^39.0.1",
+    "typescript-eslint": "^8.46.3",
     "yargs": "^18.0.0",
-    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.7",
-    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.10",
-    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.20"
+    "@mui/internal-babel-plugin-display-name": "1.0.4-canary.8",
+    "@mui/internal-babel-plugin-resolve-imports": "2.0.7-canary.28",
+    "@mui/internal-babel-plugin-minify-errors": "2.0.8-canary.13"
   },
   "peerDependencies": {
+    "@next/eslint-plugin-next": "*",
     "eslint": "^9.0.0",
-    "prettier": "^3.5.3",
+    "prettier": "~3.5.3",
     "typescript": "^5.0.0"
   },
   "devDependencies": {
+    "@octokit/types": "^16.0.0",
     "@types/babel__core": "^7.20.5",
     "@types/babel__preset-env": "^7.10.0",
-    "@types/eslint-plugin-jsx-a11y": "^6.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-jsx": "^1.0.5",
-    "@types/lodash-es": "^4.17.12",
-    "@types/yargs": "^17.0.33",
-    "@typescript-eslint/parser": "^8.42.0",
-    "@typescript-eslint/rule-tester": "^8.42.0",
-    "eslint": "^9.35.0",
-    "prettier": "^3.6.2",
-    "typescript-eslint": "^8.42.0"
+    "@types/regexp.escape": "^2.0.0",
+    "@types/yargs": "^17.0.35",
+    "@typescript-eslint/parser": "^8.46.3",
+    "@typescript-eslint/rule-tester": "^8.46.3",
+    "eslint": "^9.39.1",
+    "get-port": "^7.1.0",
+    "prettier": "~3.7.4",
+    "serve": "^14.2.5",
+    "typescript-eslint": "^8.46.3"
   },
   "files": [
     "bin",
@@ -93,8 +142,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitSha": "b76c4e6f0a445cd70cf69bb4513802a108d24e2c",
+  "gitSha": "6b3d5d685430c855b51214a5a6d756d3207380eb",
   "scripts": {
+    "build": "tsc -p tsconfig.build.json",
     "typescript": "tsc -p tsconfig.json",
     "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

@@ -5,6 +5,7 @@ import presetTypescript from '@babel/preset-typescript';
 import pluginDisplayName from '@mui/internal-babel-plugin-display-name';
 import pluginResolveImports from '@mui/internal-babel-plugin-resolve-imports';
 import pluginOptimizeClsx from 'babel-plugin-optimize-clsx';
+import pluginReactCompiler from 'babel-plugin-react-compiler';
 import pluginTransformInlineEnvVars from 'babel-plugin-transform-inline-environment-variables';
 import pluginRemovePropTypes from 'babel-plugin-transform-react-remove-prop-types';
 
@@ -13,20 +14,24 @@ import pluginRemovePropTypes from 'babel-plugin-transform-react-remove-prop-type
  * @param {boolean} [param0.debug]
  * @param {boolean} [param0.optimizeClsx]
  * @param {boolean} [param0.removePropTypes]
- * @param {boolean} [param0.isTest]
+ * @param {boolean} [param0.noResolveImports]
  * @param {'cjs' | 'esm'} param0.bundle
  * @param {string | null} param0.outExtension - Specify the output file extension.
  * @param {string} param0.runtimeVersion
+ * @param {string} [param0.reactCompilerReactVersion]
+ * @param {string} [param0.reactCompilerMode]
  * @returns {import('@babel/core').TransformOptions} The base Babel configuration.
  */
 export function getBaseConfig({
   debug = false,
   optimizeClsx = false,
   removePropTypes = false,
-  isTest = false,
+  noResolveImports = false,
   bundle,
   runtimeVersion,
   outExtension,
+  reactCompilerReactVersion,
+  reactCompilerMode,
 }) {
   /**
    * @type {import('@babel/preset-env').Options}
@@ -67,6 +72,24 @@ export function getBaseConfig({
     ],
   ];
 
+  if (reactCompilerReactVersion) {
+    /**
+     * @typedef {import('babel-plugin-react-compiler').PluginOptions} ReactCompilerOptions
+     */
+    /** @type {ReactCompilerOptions} */
+    const reactCompilerOptions = {
+      target: /** @type {ReactCompilerOptions["target"]} */ (
+        reactCompilerReactVersion.split('.')[0] // comes from the package's peerDependencies
+      ),
+      enableReanimatedCheck: false,
+      compilationMode: reactCompilerMode ?? 'annotation',
+      // Skip components with errors instead of failing the build
+      panicThreshold: 'none',
+    };
+    // The plugin must be the first one to run
+    plugins.unshift([pluginReactCompiler, reactCompilerOptions, 'babel-plugin-react-compiler']);
+  }
+
   if (removePropTypes) {
     plugins.push([
       pluginRemovePropTypes,
@@ -81,7 +104,7 @@ export function getBaseConfig({
     plugins.push([pluginOptimizeClsx, {}, 'babel-plugin-optimize-clsx']);
   }
 
-  if (bundle === 'esm' && !isTest) {
+  if (bundle === 'esm' && !noResolveImports) {
     plugins.push([
       pluginResolveImports,
       { outExtension },
@@ -119,20 +142,41 @@ export function getBaseConfig({
 }
 
 /**
- * @type {import('@babel/core').ConfigFunction}
+ * @typedef {Object} Options
+ * @prop {'esm' | 'cjs'} [Options.bundle]
+ * @prop {boolean} [Options.noResolveImports]
+ * @prop {undefined} [options.env]
+ */
+
+/**
+ * @param {import('@babel/core').ConfigAPI | Options} api
+ * @returns {import('@babel/core').TransformOptions}
  */
 export default function getBabelConfig(api) {
-  const isStable = api.env(['regressions', 'stable']);
-  const isTest = api.env('test') || process.env.NODE_ENV === 'test';
+  /** @type {'esm' | 'cjs'} */
+  let bundle;
+  /** @type {boolean} */
+  let noResolveImports;
+
+  if (api.env) {
+    // legacy
+    bundle = api.env(['regressions', 'stable']) ? 'esm' : 'cjs';
+    noResolveImports = api.env('test') || process.env.NODE_ENV === 'test';
+  } else {
+    bundle = api.bundle || 'esm';
+    noResolveImports = api.noResolveImports || false;
+  }
 
   return getBaseConfig({
     debug: process.env.MUI_BUILD_VERBOSE === 'true',
-    bundle: isStable ? 'esm' : 'cjs',
+    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
     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',
-    isTest,
+    noResolveImports,
+    reactCompilerReactVersion: process.env.MUI_REACT_COMPILER_REACT_VERSION,
+    reactCompilerMode: process.env.MUI_REACT_COMPILER_MODE,
   });
 }

package/src/brokenLinksChecker/__fixtures__/static-site/broken-links.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with Broken Links</title>
+  </head>
+  <body>
+    <h1>Page with Broken Links</h1>
+    <p>This page contains links to non-existent pages.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home (valid)</a></li>
+        <li><a href="/does-not-exist.html">This page does not exist</a></li>
+        <li><a href="/another-missing-page.html">Another missing page</a></li>
+        <li><a href="/valid.html">Valid link</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/broken-targets.html

@@ -0,0 +1,22 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with Broken Targets</title>
+  </head>
+  <body>
+    <h1>Page with Broken Targets</h1>
+    <p>This page contains links to valid pages but with invalid hash targets.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home (valid)</a></li>
+        <li><a href="/with-anchors.html#section1">Valid anchor</a></li>
+        <li><a href="/with-anchors.html#nonexistent">Non-existent anchor</a></li>
+        <li><a href="/valid.html#missing-target">Valid page, missing target</a></li>
+        <li><a href="/with-anchors.html#section2">Another valid anchor</a></li>
+        <li><a href="/with-anchors.html#also-missing">Also missing</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/example.md

@@ -0,0 +1,9 @@
+# Example Markdown File
+
+This is a markdown file with an HTML code snippet:
+
+```html
+<a href="/this-should-not-be-checked.html">This link is in a code snippet</a>
+```
+
+This link should not be crawled because this is a markdown file, not HTML.

package/src/brokenLinksChecker/__fixtures__/static-site/external-links.html

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with External Links</title>
+  </head>
+  <body>
+    <h1>Page with External Links</h1>
+    <p>This page contains external links that should be ignored.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home (valid internal)</a></li>
+        <li><a href="https://example.com">External link 1</a></li>
+        <li><a href="https://github.com/mui">External link 2</a></li>
+        <li><a href="http://localhost:9999/fake">External localhost</a></li>
+        <li><a href="/valid.html">Valid internal link</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/ignored-page.html

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Ignored Page</title>
+  </head>
+  <body>
+    <h1>Ignored Page</h1>
+    <p>This page should be ignored by the crawler.</p>
+    <nav>
+      <ul>
+        <li><a href="/this-link-should-not-be-checked.html">Should not be checked</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

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

@@ -0,0 +1,26 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Test Site Home</title>
+  </head>
+  <body>
+    <h1>Test Site Home</h1>
+    <nav>
+      <ul>
+        <li><a href="/valid.html">Valid Page</a></li>
+        <li><a href="/with-anchors.html">Page with Anchors</a></li>
+        <li><a href="/broken-links.html">Page with Broken Links</a></li>
+        <li><a href="/broken-targets.html">Page with Broken Targets</a></li>
+        <li><a href="/external-links.html">Page with External Links</a></li>
+        <li><a href="/nested/page.html">Nested Page</a></li>
+        <li><a href="/ignored-page.html">Ignored Page</a></li>
+        <li><a href="/page-with-ignored-content.html">Page with Ignored Content</a></li>
+        <li><a href="/page-with-custom-targets.html">Page with Custom Targets</a></li>
+        <li><a href="/page-with-known-target-links.html">Page with Known Target Links</a></li>
+        <li><a href="/page-with-api-links.html">Page with API Links</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/known-targets.json

@@ -0,0 +1,5 @@
+{
+  "targets": {
+    "/api-page.html": ["#method1", "#method2", "#method3"]
+  }
+}

package/src/brokenLinksChecker/__fixtures__/static-site/nested/page.html

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Nested Page</title>
+  </head>
+  <body>
+    <h1>Nested Page</h1>
+    <p>This is a page in a nested directory.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+        <li><a href="/valid.html">Valid page</a></li>
+        <li><a href="/with-anchors.html#section1">Link to anchor</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Orphaned Page</title>
+  </head>
+  <body>
+    <h1>Orphaned Page</h1>
+    <p>This page is not linked from anywhere and can only be discovered via seedUrls.</p>
+    <nav>
+      <ul>
+        <li><a href="/valid.html">Valid Page</a></li>
+        <li><a href="/valid.html/">Valid Page with trailing slash</a></li>
+        <li><a href="/orphaned-broken-link.html">Broken link from orphaned page</a></li>
+        <li><a href="/example.md">Markdown file with HTML snippet</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/page-with-api-links.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with API Links</title>
+  </head>
+  <body>
+    <h1>Page with API Links</h1>
+    <p>This page links to API documentation with known targets.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+        <li><a href="/api-page.html#method1">API Method 1 (known)</a></li>
+        <li><a href="/api-page.html#method2">API Method 2 (known)</a></li>
+        <li><a href="/api-page.html#unknown-method">Unknown API method</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/page-with-custom-targets.html

@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with Custom Targets</title>
+  </head>
+  <body>
+    <h1>Page with Custom Targets</h1>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+        <li><a href="#custom-id">Link to custom ID</a></li>
+        <li><a href="#__should-be-ignored">Link to ignored ID</a></li>
+      </ul>
+    </nav>
+    <section id="custom-id">
+      <h2>Custom ID Section</h2>
+    </section>
+    <section id="__should-be-ignored">
+      <h2>This target should be ignored</h2>
+    </section>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html

@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with Ignored Content</title>
+  </head>
+  <body>
+    <h1>Page with Ignored Content</h1>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+      </ul>
+    </nav>
+    <aside class="sidebar">
+      <h2>Sidebar (should be ignored)</h2>
+      <ul>
+        <li><a href="/sidebar-broken-link.html">Broken link in sidebar</a></li>
+      </ul>
+    </aside>
+    <main>
+      <p>Main content</p>
+      <p>
+        <a href="/broken-link-with-sidebar-class.html" class="sidebar">Link with sidebar class directly</a>
+      </p>
+    </main>
+  </body>
+</html>

package/src/brokenLinksChecker/__fixtures__/static-site/page-with-known-target-links.html

@@ -0,0 +1,19 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with Known Target Links</title>
+  </head>
+  <body>
+    <h1>Page with Known Target Links</h1>
+    <p>This page links to external pages with known targets.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+        <li><a href="/external-page.html#valid-target">Valid external target</a></li>
+        <li><a href="/external-page.html#invalid-target">Invalid external target</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>

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

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Valid Page</title>
+  </head>
+  <body>
+    <h1>Valid Page</h1>
+    <p>This page has only valid internal links.</p>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+        <li><a href="/with-anchors.html#section1">Link to section 1</a></li>
+        <li><a href="/with-anchors.html#section2">Link to section 2</a></li>
+        <li><a href="/nested/page.html">Nested page</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>