From 744c253845ca16d94b475490488e60186b0f0708 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 11:52:59 +0200
Subject: [PATCH 01/17] WIP

---
 packages/code-infra/package.json              |   3 +-
 .../src/brokenLinksChecker/index.mjs          | 544 ++++++++++++++++++
 pnpm-lock.yaml                                | 240 ++------
 3 files changed, 602 insertions(+), 185 deletions(-)
 create mode 100644 packages/code-infra/src/brokenLinksChecker/index.mjs

diff --git a/packages/code-infra/package.json b/packages/code-infra/package.json
index 9fb7fc4d3..e3907189b 100644
--- a/packages/code-infra/package.json
+++ b/packages/code-infra/package.json
@@ -96,6 +96,7 @@
     "globals": "^16.4.0",
     "globby": "^15.0.0",
     "minimatch": "^10.0.3",
+    "node-html-parser": "^7.0.1",
     "open": "^10.2.0",
     "postcss-styled-syntax": "^0.7.1",
     "regexp.escape": "^2.0.1",
@@ -111,6 +112,7 @@
     "typescript": "^5.0.0"
   },
   "devDependencies": {
+    "@octokit/types": "^15.0.0",
     "@types/babel__core": "^7.20.5",
     "@types/babel__preset-env": "^7.10.0",
     "@types/env-ci": "^3.1.4",
@@ -122,7 +124,6 @@
     "@typescript-eslint/parser": "^8.45.0",
     "@typescript-eslint/rule-tester": "^8.45.0",
     "eslint": "^9.36.0",
-    "@octokit/types": "^15.0.0",
     "prettier": "^3.6.2",
     "typescript-eslint": "^8.45.0"
   },
diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
new file mode 100644
index 000000000..5fb8f999d
--- /dev/null
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -0,0 +1,544 @@
+/* eslint-disable no-console */
+import { execaCommand } from 'execa';
+import timers from 'node:timers/promises';
+import { parse } from 'node-html-parser';
+import fs from 'node:fs/promises';
+import chalk from 'chalk';
+import { Transform } from 'node:stream';
+
+const DEFAULT_CONCURRENCY = 4;
+
+/**
+ * @param {string} prefix
+ * @returns {Transform}
+ */
+const prefixLines = (prefix) => {
+  let leftover = '';
+  return new Transform({
+    transform(chunk, enc, cb) {
+      const lines = (leftover + chunk.toString()).split(/\r?\n/);
+      leftover = /** @type {string} */ (lines.pop());
+      this.push(lines.map((l) => `${prefix + l}\n`).join(''));
+      cb();
+    },
+    flush(cb) {
+      if (leftover) {
+        this.push(`${prefix + leftover}\n`);
+      }
+      cb();
+    },
+  });
+};
+
+/**
+ * Maps pageUrl to ids of known targets on that page
+ * @typedef {Map<string, Set<string>>} LinkStructure
+ */
+
+/**
+ * @typedef {Object} SerializedLinkStructure
+ * @property {Record<string, string[]>} targets
+ */
+
+/**
+ * @param {string | URL} url
+ * @returns {Promise<Response>}
+ */
+async function fetchUrl(url) {
+  const res = await fetch(url);
+  if (!res.ok) {
+    throw new Error(`Failed to fetch ${url}: [${res.status}] ${res.statusText}`);
+  }
+  return res;
+}
+
+/**
+ * @param {string} url
+ * @param {number} timeout
+ * @returns {Promise<void>}
+ */
+async function pollUrl(url, timeout) {
+  const start = Date.now();
+  while (true) {
+    try {
+      // eslint-disable-next-line no-await-in-loop
+      await fetchUrl(url);
+      return;
+    } catch (/** @type {any} */ error) {
+      if (Date.now() - start > timeout) {
+        throw new Error(`Timeout waiting for ${url}: ${error.message}`, { cause: error });
+      }
+      // eslint-disable-next-line no-await-in-loop
+      await timers.setTimeout(1000);
+    }
+  }
+}
+
+/**
+ * @param {SerializedLinkStructure} data
+ * @returns {LinkStructure}
+ */
+function deserializeLinkStructure(data) {
+  const linkStructure = new Map();
+  for (const url of Object.keys(data.targets)) {
+    linkStructure.set(url, new Set(data.targets[url]));
+  }
+  return linkStructure;
+}
+
+/**
+ * @typedef {Object} LinkTarget
+ */
+
+/**
+ * @typedef {Object} PageData
+ * @property {string} url
+ * @property {number} status
+ * @property {Map<string, LinkTarget>} targets
+ */
+
+/**
+ * @param {Map<string, PageData>} pages
+ * @param {string} outPath
+ * @returns {Promise<void>}
+ */
+async function writePagesToFile(pages, outPath) {
+  /** @type {SerializedLinkStructure} */
+  const fileContent = { targets: {} };
+  for (const [url, pageData] of pages.entries()) {
+    fileContent.targets[url] = Array.from(pageData.targets.keys());
+  }
+  await fs.writeFile(outPath, JSON.stringify(fileContent, null, 2), 'utf-8');
+}
+
+/**
+ * Polyfill for `node.computedName` available only in chrome v112+
+ * @param {import('node-html-parser').HTMLElement | null} elm
+ * @param {import('node-html-parser').HTMLElement} ownerDocument
+ * @returns {string}
+ */
+function getAccessibleName(elm, ownerDocument) {
+  if (!elm) {
+    return '';
+  }
+
+  // 1. aria-label
+  const ariaLabel = elm.getAttribute('aria-label')?.trim();
+  if (ariaLabel) {
+    return ariaLabel;
+  }
+
+  // 2. aria-labelledby
+  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;
+    }
+  }
+
+  // 3. <label for="id">
+  if (elm.id) {
+    const label = ownerDocument.querySelector(`label[for="${elm.id}"]`);
+    if (label) {
+      return getAccessibleName(label, ownerDocument);
+    }
+  }
+
+  // 4. <img alt="">
+  if (elm.tagName === 'IMG') {
+    const alt = elm.getAttribute('alt')?.trim();
+    if (alt) {
+      return alt;
+    }
+  }
+
+  // 5. Fallback: visible text
+  return elm.innerText.trim();
+}
+
+/**
+ * @template T
+ */
+class Queue {
+  /** @type {T[]} */
+  tasks = [];
+
+  /** @type {Set<Promise<void>>} */
+  pending = new Set();
+
+  /**
+   * @param {(task: T) => Promise<void>} worker
+   * @param {number} concurrency
+   */
+  constructor(worker, concurrency) {
+    this.worker = worker;
+    this.concurrency = concurrency;
+  }
+
+  /**
+   * @param {T} task
+   */
+  add(task) {
+    this.tasks.push(task);
+    this.run();
+  }
+
+  async run() {
+    while (this.pending.size < this.concurrency && this.tasks.length > 0) {
+      const task = /** @type {T} */ (this.tasks.shift());
+      const p = this.worker(task).finally(() => {
+        this.pending.delete(p);
+        this.run();
+      });
+      this.pending.add(p);
+    }
+  }
+
+  async waitAll() {
+    while (this.pending.size > 0) {
+      // eslint-disable-next-line no-await-in-loop
+      await Promise.all(this.pending);
+    }
+  }
+}
+
+/**
+ * @typedef {Object} Link
+ * @property {string | null} src
+ * @property {string | null} text
+ * @property {string} href
+ */
+
+/**
+ * @param {string} href
+ * @param {RegExp[]} ignoredPaths
+ * @returns {string | null}
+ */
+function getPageUrl(href, ignoredPaths = []) {
+  if (!href.startsWith('/')) {
+    return null;
+  }
+  const parsed = new URL(href, 'http://localhost');
+  if (ignoredPaths.some((pattern) => pattern.test(parsed.pathname))) {
+    return null;
+  }
+  const link = parsed.pathname + parsed.search;
+  return link;
+}
+
+/**
+ * @typedef {Object} CrawlOptions
+ * @property {string | null} [startCommand]
+ * @property {string} host
+ * @property {string | null} [outPath]
+ * @property {RegExp[]} [ignoredPaths]
+ * @property {string[]} [ignoredContent]
+ * @property {Set<string>} [ignoredTargets]
+ * @property {Map<string, Set<string>>} [knownTargets]
+ * @property {string[]} [knownTargetsDownloadUrl]
+ * @property {number} [concurrency]
+ */
+
+/**
+ * @typedef {Required<CrawlOptions>} ResolvedCrawlOptions
+ */
+
+/**
+ * @param {CrawlOptions} rawOptions
+ * @returns {ResolvedCrawlOptions}
+ */
+function resolveOptions(rawOptions) {
+  return {
+    startCommand: rawOptions.startCommand ?? null,
+    host: rawOptions.host,
+    outPath: rawOptions.outPath ?? null,
+    ignoredPaths: rawOptions.ignoredPaths ?? [],
+    ignoredContent: rawOptions.ignoredContent ?? [],
+    ignoredTargets: rawOptions.ignoredTargets ?? new Set(['__next', '__NEXT_DATA__']),
+    knownTargets: rawOptions.knownTargets ?? new Map(),
+    knownTargetsDownloadUrl: rawOptions.knownTargetsDownloadUrl ?? [],
+    concurrency: rawOptions.concurrency ?? DEFAULT_CONCURRENCY,
+  };
+}
+
+/**
+ * Merge multiple maps, similar to `Object.assign`
+ * @template K, V
+ * @param {Map<K, V>} target
+ * @param {...Map<K, V>} sources
+ * @returns {Map<K, V>}
+ */
+function mergeMaps(target, ...sources) {
+  for (const source of sources) {
+    for (const [key, value] of source.entries()) {
+      target.set(key, value);
+    }
+  }
+  return target;
+}
+
+/**
+ * @param {string[]} urls
+ * @returns {Promise<LinkStructure[]>}
+ */
+async function downloadKnownTargets(urls) {
+  if (urls.length === 0) {
+    return [];
+  }
+
+  console.log(chalk.blue(`Downloading known targets from ${urls.length} URL(s)...`));
+
+  const results = await Promise.all(
+    urls.map(async (url) => {
+      console.log(`  Fetching ${chalk.underline(url)}`);
+      const res = await fetchUrl(url);
+      const data = await res.json();
+      return deserializeLinkStructure(data);
+    }),
+  );
+
+  return results;
+}
+
+/**
+ * @param {ResolvedCrawlOptions} options
+ * @returns {Promise<LinkStructure>}
+ */
+async function resolveKnownTargets(options) {
+  const downloaded = await downloadKnownTargets(options.knownTargetsDownloadUrl);
+  // Merge downloaded with user-provided, user-provided takes priority
+  return mergeMaps(new Map(), ...downloaded, options.knownTargets);
+}
+
+/**
+ * @typedef {Object} CrawlResult
+ * @property {number} brokenLinks
+ */
+
+/**
+ * @param {CrawlOptions} rawOptions
+ * @returns {Promise<CrawlResult>}
+ */
+export async function crawl(rawOptions) {
+  const options = resolveOptions(rawOptions);
+  const knownTargets = await resolveKnownTargets(options);
+  const startTime = Date.now();
+
+  let appProcess;
+  if (options.startCommand) {
+    console.log(chalk.blue(`Starting server with "${options.startCommand}"...`));
+    appProcess = execaCommand(options.startCommand, {
+      stdout: 'pipe',
+      stderr: 'pipe',
+      env: {
+        FORCE_COLOR: '1',
+        ...process.env,
+      },
+    });
+
+    // Prefix server logs
+    const serverPrefix = chalk.gray('server: ');
+    appProcess.stdout?.pipe(prefixLines(serverPrefix)).pipe(process.stdout);
+    appProcess.stderr?.pipe(prefixLines(serverPrefix)).pipe(process.stderr);
+
+    await pollUrl(options.host, 10000);
+
+    console.log(`Server started on ${chalk.underline(options.host)}`);
+  }
+
+  /** @type {Map<string, Promise<PageData>>} */
+  const crawledPages = new Map();
+  /** @type {Set<Link>} */
+  const crawledLinks = new Set();
+
+  const queue = new Queue(async (link) => {
+    crawledLinks.add(link);
+
+    const pageUrl = getPageUrl(link.href, options.ignoredPaths);
+    if (pageUrl === null) {
+      return;
+    }
+
+    if (knownTargets.has(pageUrl)) {
+      return;
+    }
+
+    if (crawledPages.has(pageUrl)) {
+      return;
+    }
+
+    const pagePromise = Promise.resolve().then(async () => {
+      console.log(`Crawling ${chalk.cyan(pageUrl)}...`);
+      const res = await fetch(new URL(pageUrl, options.host));
+
+      const urlData = { url: pageUrl, status: res.status };
+
+      if (urlData.status < 200 || urlData.status >= 400) {
+        console.warn(chalk.yellow(`Warning: ${pageUrl} returned status ${urlData.status}`));
+
+        return {
+          url: pageUrl,
+          status: res.status,
+          targets: new Map(),
+          links: [],
+        };
+      }
+
+      const html = await res.text();
+
+      const dom = parse(html);
+
+      for (const selector of options.ignoredContent) {
+        dom.querySelectorAll(selector).forEach((elm) => {
+          elm.remove();
+        });
+      }
+
+      const pageLinks = dom.querySelectorAll('a[href]').map((a) => ({
+        src: pageUrl,
+        text: getAccessibleName(a, dom),
+        href: a.attributes.href,
+      }));
+
+      const pageTargets = new Map(
+        dom
+          .querySelectorAll('*[id]')
+          .filter((elm) => !options.ignoredTargets.has(elm.attributes.id))
+          .map((elm) => [`#${elm.attributes.id}`, {}]),
+      );
+
+      const pageData = {
+        url: pageUrl,
+        status: res.status,
+        targets: pageTargets,
+      };
+
+      for (const pageLink of pageLinks) {
+        queue.add(pageLink);
+      }
+
+      return pageData;
+    });
+
+    crawledPages.set(pageUrl, pagePromise);
+
+    await pagePromise;
+  }, options.concurrency);
+
+  queue.add({ src: null, text: null, href: '/' });
+
+  await queue.waitAll();
+
+  if (appProcess) {
+    await appProcess.kill();
+  }
+
+  const results = new Map(
+    await Promise.all(
+      Array.from(crawledPages.entries(), async ([a, b]) => /** @type {const} */ ([a, await b])),
+    ),
+  );
+
+  if (options.outPath) {
+    await writePagesToFile(results, options.outPath);
+  }
+
+  /**
+   * @typedef {Object} BrokenLinkError
+   * @property {Link} link
+   * @property {string} reason
+   */
+
+  /** @type {Map<string, BrokenLinkError[]>} */
+  const brokenLinksByPage = new Map();
+
+  /**
+   * @param {Link} link
+   * @param {string} reason
+   */
+  function recordBrokenLink(link, reason) {
+    const src = link.src ?? '(unknown)';
+    const linksForPage = brokenLinksByPage.get(src) ?? [];
+    brokenLinksByPage.set(src, linksForPage);
+    linksForPage.push({ link, reason });
+  }
+
+  let totalLinks = 0;
+  let checkedLinks = 0;
+  let brokenLinks = 0;
+  let brokenLinkTargets = 0;
+  for (const crawledLink of crawledLinks) {
+    totalLinks += 1;
+    const pageUrl = getPageUrl(crawledLink.href, options.ignoredPaths);
+    if (pageUrl === null) {
+      // External link
+      continue;
+    }
+    checkedLinks += 1;
+
+    const parsed = new URL(crawledLink.href, 'http://localhost');
+
+    const knownPage = knownTargets.get(pageUrl);
+    if (knownPage) {
+      if (parsed.hash && !knownPage.has(parsed.hash)) {
+        recordBrokenLink(crawledLink, 'target not found');
+        brokenLinkTargets += 1;
+      }
+      continue;
+    }
+
+    const page = results.get(pageUrl);
+
+    if (!page) {
+      recordBrokenLink(crawledLink, 'not crawled');
+      brokenLinks += 1;
+      continue;
+    }
+    if (page.status >= 400) {
+      recordBrokenLink(crawledLink, `returned status ${page.status}`);
+      brokenLinks += 1;
+      continue;
+    }
+    if (parsed.hash) {
+      if (!page.targets.has(parsed.hash)) {
+        recordBrokenLink(crawledLink, 'target not found');
+        brokenLinkTargets += 1;
+      }
+    }
+  }
+
+  // Report broken links grouped by source page
+  if (brokenLinksByPage.size > 0) {
+    console.error('\nBroken links found:\n');
+    for (const [pageUrl, errors] of brokenLinksByPage.entries()) {
+      console.error(`Source ${chalk.cyan(pageUrl)}:`);
+      for (const { link, reason } of errors) {
+        console.error(`  [${link.text}](${chalk.cyan(link.href)}) (${reason})`);
+      }
+    }
+  }
+
+  const endTime = Date.now();
+  const durationSeconds = (endTime - startTime) / 1000;
+  const duration = new Intl.NumberFormat('en-US', {
+    style: 'unit',
+    unit: 'second',
+    maximumFractionDigits: 2,
+  }).format(durationSeconds);
+  console.log(chalk.blue(`\nCrawl completed in ${duration}`));
+  console.log(`  Total links found: ${chalk.cyan(totalLinks)}`);
+  console.log(`  Total links checked: ${chalk.cyan(checkedLinks)}`);
+  console.log(`  Total broken links: ${chalk.cyan(brokenLinks)}`);
+  console.log(`  Total broken link targets: ${chalk.cyan(brokenLinkTargets)}`);
+
+  const totalBrokenLinks = brokenLinks + brokenLinkTargets;
+  return { brokenLinks: totalBrokenLinks };
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 4ab5f0d0c..0df4b0559 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -488,6 +488,9 @@ importers:
       minimatch:
         specifier: ^10.0.3
         version: 10.0.3
+      node-html-parser:
+        specifier: ^7.0.1
+        version: 7.0.1
       open:
         specifier: ^10.2.0
         version: 10.2.0
@@ -8544,6 +8547,10 @@ packages:
   hastscript@9.0.1:
     resolution: {integrity: sha512-g7df9rMFX/SPi34tyGCyUBREQoKkapwdY/T04Qn9TDWfHhAYt4/I0gMVirzK5wEzeUqIjEB+LXC/ypb7Aqno5w==}
 
+  he@1.2.0:
+    resolution: {integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==}
+    hasBin: true
+
   hermes-estree@0.25.1:
     resolution: {integrity: sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw==}
 
@@ -10106,6 +10113,9 @@ packages:
     engines: {node: ^18.17.0 || >=20.5.0}
     hasBin: true
 
+  node-html-parser@7.0.1:
+    resolution: {integrity: sha512-KGtmPY2kS0thCWGK0VuPyOS+pBKhhe8gXztzA2ilAOhbUbxa9homF1bOyKvhGzMLXUoRds9IOmr/v5lr/lqNmA==}
+
   node-machine-id@1.1.12:
     resolution: {integrity: sha512-QNABxbrPa3qEIfrE6GOJ7BYIuignnJw7iQ2YPbc3Nla1HzRJjXzZOiikfF8m7eAMfichLt3M4VgLOetqgDmgGQ==}
 
@@ -13062,7 +13072,7 @@ snapshots:
 
   '@argos-ci/api-client@0.11.1':
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       openapi-fetch: 0.14.0
     transitivePeerDependencies:
       - supports-color
@@ -13072,7 +13082,7 @@ snapshots:
       '@argos-ci/api-client': 0.11.1
       '@argos-ci/util': 3.1.0
       convict: 6.2.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       fast-glob: 3.3.3
       sharp: 0.34.4
       tmp: 0.2.5
@@ -13688,7 +13698,7 @@ snapshots:
       '@babel/types': 7.28.4
       '@jridgewell/remapping': 2.3.5
       convert-source-map: 2.0.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       gensync: 1.0.0-beta.2
       json5: 2.2.3
       semver: 6.3.1
@@ -13740,7 +13750,7 @@ snapshots:
       '@babel/core': 7.28.4
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       lodash.debounce: 4.0.8
       resolve: 1.22.10
     transitivePeerDependencies:
@@ -14422,7 +14432,7 @@ snapshots:
       '@babel/parser': 7.28.4
       '@babel/template': 7.27.2
       '@babel/types': 7.28.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -15008,7 +15018,7 @@ snapshots:
   '@eslint/config-array@0.21.1':
     dependencies:
       '@eslint/object-schema': 2.1.7
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       minimatch: 3.1.2
     transitivePeerDependencies:
       - supports-color
@@ -15030,7 +15040,7 @@ snapshots:
   '@eslint/eslintrc@3.3.1':
     dependencies:
       ajv: 6.12.6
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       espree: 10.4.0
       globals: 14.0.0
       ignore: 5.3.2
@@ -15586,19 +15596,6 @@ snapshots:
 
   '@lukeed/ms@2.0.2': {}
 
-  '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)':
-    dependencies:
-      consola: 3.4.2
-      detect-libc: 2.1.1
-      https-proxy-agent: 7.0.6
-      node-fetch: 2.7.0(encoding@0.1.13)
-      nopt: 8.1.0
-      semver: 7.7.3
-      tar: 7.4.3
-    transitivePeerDependencies:
-      - encoding
-      - supports-color
-
   '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)(supports-color@10.2.0)':
     dependencies:
       consola: 3.4.2
@@ -16667,45 +16664,6 @@ snapshots:
 
   '@netlify/types@2.0.3': {}
 
-  '@netlify/zip-it-and-ship-it@14.1.8(encoding@0.1.13)(rollup@4.52.5)':
-    dependencies:
-      '@babel/parser': 7.28.4
-      '@babel/types': 7.28.4
-      '@netlify/binary-info': 1.0.0
-      '@netlify/serverless-functions-api': 2.5.0
-      '@vercel/nft': 0.29.4(encoding@0.1.13)(rollup@4.52.5)
-      archiver: 7.0.1
-      common-path-prefix: 3.0.0
-      copy-file: 11.1.0
-      es-module-lexer: 1.7.0
-      esbuild: 0.25.10
-      execa: 8.0.1
-      fast-glob: 3.3.3
-      filter-obj: 6.1.0
-      find-up: 7.0.0
-      is-path-inside: 4.0.0
-      junk: 4.0.1
-      locate-path: 7.2.0
-      merge-options: 3.0.4
-      minimatch: 9.0.5
-      normalize-path: 3.0.0
-      p-map: 7.0.3
-      path-exists: 5.0.0
-      precinct: 12.2.0
-      require-package-name: 2.0.1
-      resolve: 2.0.0-next.5
-      semver: 7.7.3
-      tmp-promise: 3.0.3
-      toml: 3.0.0
-      unixify: 1.0.0
-      urlpattern-polyfill: 8.0.2
-      yargs: 17.7.2
-      zod: 3.25.76
-    transitivePeerDependencies:
-      - encoding
-      - rollup
-      - supports-color
-
   '@netlify/zip-it-and-ship-it@14.1.8(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@babel/parser': 7.28.4
@@ -16794,7 +16752,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       lru-cache: 10.4.3
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -16804,7 +16762,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       lru-cache: 11.2.2
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -17246,7 +17204,7 @@ snapshots:
 
   '@pnpm/tabtab@0.5.4':
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       enquirer: 2.4.1
       minimist: 1.2.8
       untildify: 4.0.0
@@ -19224,9 +19182,9 @@ snapshots:
     dependencies:
       '@typescript-eslint/scope-manager': 8.45.0
       '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/visitor-keys': 8.45.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19241,19 +19199,10 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/project-service@8.45.0(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/tsconfig-utils': 8.45.0(typescript@5.9.3)
-      '@typescript-eslint/types': 8.45.0
-      debug: 4.4.3(supports-color@8.1.1)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   '@typescript-eslint/rule-tester@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/parser': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/utils': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       ajv: 6.12.6
       eslint: 9.38.0(jiti@2.5.1)
@@ -19276,9 +19225,9 @@ snapshots:
   '@typescript-eslint/type-utils@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/utils': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       eslint: 9.38.0(jiti@2.5.1)
       ts-api-utils: 2.1.0(typescript@5.9.3)
       typescript: 5.9.3
@@ -19303,28 +19252,12 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/typescript-estree@8.45.0(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/project-service': 8.45.0(typescript@5.9.3)
-      '@typescript-eslint/tsconfig-utils': 8.45.0(typescript@5.9.3)
-      '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/visitor-keys': 8.45.0
-      debug: 4.4.3(supports-color@8.1.1)
-      fast-glob: 3.3.3
-      is-glob: 4.0.3
-      minimatch: 9.0.5
-      semver: 7.7.3
-      ts-api-utils: 2.1.0(typescript@5.9.3)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   '@typescript-eslint/utils@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@eslint-community/eslint-utils': 4.9.0(eslint@9.38.0(jiti@2.5.1))
       '@typescript-eslint/scope-manager': 8.45.0
       '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19396,25 +19329,6 @@ snapshots:
   '@unrs/resolver-binding-win32-x64-msvc@1.11.1':
     optional: true
 
-  '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)':
-    dependencies:
-      '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)
-      '@rollup/pluginutils': 5.2.0(rollup@4.52.5)
-      acorn: 8.15.0
-      acorn-import-attributes: 1.9.5(acorn@8.15.0)
-      async-sema: 3.1.1
-      bindings: 1.5.0
-      estree-walker: 2.0.2
-      glob: 10.4.5
-      graceful-fs: 4.2.11
-      node-gyp-build: 4.8.4
-      picomatch: 4.0.3
-      resolve-from: 5.0.0
-    transitivePeerDependencies:
-      - encoding
-      - rollup
-      - supports-color
-
   '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)(supports-color@10.2.0)
@@ -19462,7 +19376,7 @@ snapshots:
       '@ampproject/remapping': 2.3.0
       '@bcoe/v8-coverage': 1.0.2
       ast-v8-to-istanbul: 0.3.5
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       istanbul-lib-coverage: 3.2.2
       istanbul-lib-report: 3.0.1
       istanbul-lib-source-maps: 5.0.6
@@ -21150,15 +21064,6 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  detective-typescript@14.0.0(typescript@5.9.3):
-    dependencies:
-      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
-      ast-module-types: 6.0.1
-      node-source-walk: 7.0.1
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   detective-vue2@2.2.0(supports-color@10.2.0)(typescript@5.9.3):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -21172,19 +21077,6 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  detective-vue2@2.2.0(typescript@5.9.3):
-    dependencies:
-      '@dependents/detective-less': 5.0.1
-      '@vue/compiler-sfc': 3.5.21
-      detective-es6: 5.0.1
-      detective-sass: 6.0.1
-      detective-scss: 5.0.1
-      detective-stylus: 5.0.1
-      detective-typescript: 14.0.0(typescript@5.9.3)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   dettle@1.0.5: {}
 
   devlop@1.1.0:
@@ -21621,7 +21513,7 @@ snapshots:
 
   eslint-import-resolver-typescript@4.4.4(eslint-plugin-import@2.32.0)(eslint@9.38.0(jiti@2.5.1)):
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       eslint: 9.38.0(jiti@2.5.1)
       eslint-import-context: 0.1.9(unrs-resolver@1.11.1)
       get-tsconfig: 4.10.1
@@ -21805,7 +21697,7 @@ snapshots:
       ajv: 6.12.6
       chalk: 4.1.2
       cross-spawn: 7.0.6
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       escape-string-regexp: 4.0.0
       eslint-scope: 8.4.0
       eslint-visitor-keys: 4.2.1
@@ -22004,7 +21896,7 @@ snapshots:
 
   extract-zip@2.0.1:
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       get-stream: 5.2.0
       yauzl: 2.10.0
     optionalDependencies:
@@ -22244,7 +22136,7 @@ snapshots:
 
   follow-redirects@1.15.11(debug@4.4.3):
     optionalDependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
 
   for-each@0.3.5:
     dependencies:
@@ -22361,7 +22253,7 @@ snapshots:
   gaxios@6.7.1(encoding@0.1.13):
     dependencies:
       extend: 3.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       is-stream: 2.0.1
       node-fetch: 2.7.0(encoding@0.1.13)
       uuid: 9.0.1
@@ -22805,6 +22697,8 @@ snapshots:
       property-information: 7.1.0
       space-separated-tokens: 2.0.2
 
+  he@1.2.0: {}
+
   hermes-estree@0.25.1: {}
 
   hermes-parser@0.25.1:
@@ -22878,7 +22772,7 @@ snapshots:
   http-proxy-agent@7.0.2:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -22905,7 +22799,7 @@ snapshots:
   http-proxy-middleware@3.0.3:
     dependencies:
       '@types/http-proxy': 1.17.16
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       http-proxy: 1.18.1(debug@4.4.3)
       is-glob: 4.0.3
       is-plain-object: 5.0.0
@@ -22928,13 +22822,6 @@ snapshots:
       quick-lru: 5.1.1
       resolve-alpn: 1.2.1
 
-  https-proxy-agent@7.0.6:
-    dependencies:
-      agent-base: 7.1.4
-      debug: 4.4.3(supports-color@8.1.1)
-    transitivePeerDependencies:
-      - supports-color
-
   https-proxy-agent@7.0.6(supports-color@10.2.0):
     dependencies:
       agent-base: 7.1.4
@@ -23385,7 +23272,7 @@ snapshots:
   istanbul-lib-source-maps@5.0.6:
     dependencies:
       '@jridgewell/trace-mapping': 0.3.30
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       istanbul-lib-coverage: 3.2.2
     transitivePeerDependencies:
       - supports-color
@@ -23468,7 +23355,7 @@ snapshots:
       decimal.js: 10.6.0
       html-encoding-sniffer: 4.0.0
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       is-potential-custom-element-name: 1.0.1
       parse5: 7.3.0
       rrweb-cssom: 0.8.0
@@ -24288,7 +24175,7 @@ snapshots:
   micromark@4.0.2:
     dependencies:
       '@types/debug': 4.1.12
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       decode-named-character-reference: 1.2.0
       devlop: 1.1.0
       micromark-core-commonmark: 2.0.3
@@ -24557,7 +24444,7 @@ snapshots:
       '@netlify/headers-parser': 9.0.2
       '@netlify/local-functions-proxy': 2.0.3
       '@netlify/redirect-parser': 15.0.3
-      '@netlify/zip-it-and-ship-it': 14.1.8(encoding@0.1.13)(rollup@4.52.5)
+      '@netlify/zip-it-and-ship-it': 14.1.8(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)
       '@octokit/rest': 22.0.0
       '@opentelemetry/api': 1.8.0
       '@pnpm/tabtab': 0.5.4
@@ -24575,7 +24462,7 @@ snapshots:
       content-type: 1.0.5
       cookie: 1.0.2
       cron-parser: 4.9.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       decache: 4.6.2
       dot-prop: 9.0.0
       dotenv: 17.2.3
@@ -24597,7 +24484,7 @@ snapshots:
       gitconfiglocal: 2.1.0
       http-proxy: 1.18.1(debug@4.4.3)
       http-proxy-middleware: 2.0.9(debug@4.4.3)
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       inquirer: 8.2.7(@types/node@22.18.10)
       inquirer-autocomplete-prompt: 1.4.0(inquirer@8.2.7(@types/node@22.18.10))
       ipx: 3.1.1(@netlify/blobs@10.0.11)
@@ -24740,6 +24627,11 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  node-html-parser@7.0.1:
+    dependencies:
+      css-select: 5.2.2
+      he: 1.2.0
+
   node-machine-id@1.1.12: {}
 
   node-mock-http@1.0.2: {}
@@ -25503,26 +25395,6 @@ snapshots:
 
   preact@10.24.3: {}
 
-  precinct@12.2.0:
-    dependencies:
-      '@dependents/detective-less': 5.0.1
-      commander: 12.1.0
-      detective-amd: 6.0.1
-      detective-cjs: 6.0.1
-      detective-es6: 5.0.1
-      detective-postcss: 7.0.1(postcss@8.5.6)
-      detective-sass: 6.0.1
-      detective-scss: 5.0.1
-      detective-stylus: 5.0.1
-      detective-typescript: 14.0.0(typescript@5.9.3)
-      detective-vue2: 2.2.0(typescript@5.9.3)
-      module-definition: 6.0.1
-      node-source-walk: 7.0.1
-      postcss: 8.5.6
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   precinct@12.2.0(supports-color@10.2.0):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -26509,7 +26381,7 @@ snapshots:
   socks-proxy-agent@8.0.5:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       socks: 2.8.7
     transitivePeerDependencies:
       - supports-color
@@ -26831,7 +26703,7 @@ snapshots:
       cosmiconfig: 9.0.0(typescript@5.9.3)
       css-functions-list: 3.2.3
       css-tree: 3.1.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       fast-glob: 3.3.3
       fastest-levenshtein: 1.0.16
       file-entry-cache: 10.1.4
@@ -27148,7 +27020,7 @@ snapshots:
   tuf-js@3.1.0:
     dependencies:
       '@tufjs/models': 3.0.1
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       make-fetch-happen: 14.0.3
     transitivePeerDependencies:
       - supports-color
@@ -27156,7 +27028,7 @@ snapshots:
   tuf-js@4.0.0:
     dependencies:
       '@tufjs/models': 4.0.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       make-fetch-happen: 15.0.2
     transitivePeerDependencies:
       - supports-color
@@ -27229,7 +27101,7 @@ snapshots:
     dependencies:
       '@typescript-eslint/eslint-plugin': 8.45.0(@typescript-eslint/parser@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3))(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       '@typescript-eslint/parser': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/utils': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
@@ -27514,7 +27386,7 @@ snapshots:
   vite-node@3.2.4(@types/node@22.18.10)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1):
     dependencies:
       cac: 6.7.14
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       es-module-lexer: 1.7.0
       pathe: 2.0.3
       vite: 7.1.11(@types/node@22.18.10)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
@@ -27534,7 +27406,7 @@ snapshots:
 
   vite-tsconfig-paths@5.1.4(typescript@5.9.3)(vite@7.1.11(@types/node@22.18.10)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       globrex: 0.1.2
       tsconfck: 3.1.6(typescript@5.9.3)
     optionalDependencies:
@@ -27596,7 +27468,7 @@ snapshots:
       '@vitest/spy': 3.2.4
       '@vitest/utils': 3.2.4
       chai: 5.3.3
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       expect-type: 1.2.2
       magic-string: 0.30.18
       pathe: 2.0.3
@@ -27642,7 +27514,7 @@ snapshots:
     dependencies:
       chalk: 4.1.2
       commander: 9.5.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
     transitivePeerDependencies:
       - supports-color
 

From 8f023b28a0da3154d2a1993c2864e50d32fadf18 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 12:56:12 +0200
Subject: [PATCH 02/17] tests

---
 packages/code-infra/package.json              |   6 +
 .../static-site/broken-links.html             |  20 +
 .../static-site/broken-targets.html           |  22 +
 .../static-site/external-links.html           |  21 +
 .../static-site/ignored-page.html             |  17 +
 .../__fixtures__/static-site/index.html       |  26 ++
 .../static-site/known-targets.json            |   5 +
 .../__fixtures__/static-site/nested/page.html |  19 +
 .../static-site/page-with-api-links.html      |  20 +
 .../static-site/page-with-custom-targets.html |  24 ++
 .../page-with-ignored-content.html            |  25 ++
 .../page-with-known-target-links.html         |  19 +
 .../__fixtures__/static-site/valid.html       |  20 +
 .../static-site/with-anchors.html             |  31 ++
 .../src/brokenLinksChecker/index.mjs          |  26 +-
 .../src/brokenLinksChecker/index.test.ts      | 132 ++++++
 pnpm-lock.yaml                                | 408 ++++++++++++++++--
 17 files changed, 800 insertions(+), 41 deletions(-)
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/broken-links.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/broken-targets.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/external-links.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/ignored-page.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/index.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/known-targets.json
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/nested/page.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-api-links.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-custom-targets.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-known-target-links.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/valid.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/with-anchors.html
 create mode 100644 packages/code-infra/src/brokenLinksChecker/index.test.ts

diff --git a/packages/code-infra/package.json b/packages/code-infra/package.json
index e3907189b..0385b31a1 100644
--- a/packages/code-infra/package.json
+++ b/packages/code-infra/package.json
@@ -39,6 +39,10 @@
     "./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": {
@@ -124,7 +128,9 @@
     "@typescript-eslint/parser": "^8.45.0",
     "@typescript-eslint/rule-tester": "^8.45.0",
     "eslint": "^9.36.0",
+    "get-port": "^7.1.0",
     "prettier": "^3.6.2",
+    "serve": "^14.2.5",
     "typescript-eslint": "^8.45.0"
   },
   "files": [
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/broken-links.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/broken-links.html
new file mode 100644
index 000000000..30e4cad7a
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/broken-targets.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/broken-targets.html
new file mode 100644
index 000000000..43432271e
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/external-links.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/external-links.html
new file mode 100644
index 000000000..8a7c86248
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/ignored-page.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/ignored-page.html
new file mode 100644
index 000000000..2b2053b5e
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/index.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/index.html
new file mode 100644
index 000000000..e773c4dfc
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/known-targets.json b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/known-targets.json
new file mode 100644
index 000000000..e900dbce1
--- /dev/null
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/known-targets.json
@@ -0,0 +1,5 @@
+{
+  "targets": {
+    "/api-page.html": ["#method1", "#method2", "#method3"]
+  }
+}
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/nested/page.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/nested/page.html
new file mode 100644
index 000000000..9cfd3acd9
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-api-links.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-api-links.html
new file mode 100644
index 000000000..7a44d4bdf
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-custom-targets.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-custom-targets.html
new file mode 100644
index 000000000..bc1c3ffc5
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html
new file mode 100644
index 000000000..b2b311426
--- /dev/null
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html
@@ -0,0 +1,25 @@
+<!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>
+    </main>
+  </body>
+</html>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-known-target-links.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-known-target-links.html
new file mode 100644
index 000000000..ce58e30d8
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/valid.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/valid.html
new file mode 100644
index 000000000..fde0a32f7
--- /dev/null
+++ b/packages/code-infra/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>
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/with-anchors.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/with-anchors.html
new file mode 100644
index 000000000..b870c0fae
--- /dev/null
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/with-anchors.html
@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Page with Anchors</title>
+  </head>
+  <body>
+    <h1>Page with Anchors</h1>
+    <nav>
+      <ul>
+        <li><a href="/">Home</a></li>
+        <li><a href="#section1">Jump to section 1</a></li>
+        <li><a href="#section2">Jump to section 2</a></li>
+        <li><a href="#section3">Jump to section 3</a></li>
+      </ul>
+    </nav>
+    <section id="section1">
+      <h2>Section 1</h2>
+      <p>Content for section 1</p>
+    </section>
+    <section id="section2">
+      <h2>Section 2</h2>
+      <p>Content for section 2</p>
+    </section>
+    <section id="section3">
+      <h2>Section 3</h2>
+      <p>Content for section 3</p>
+    </section>
+  </body>
+</html>
diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 5fb8f999d..8bd5f7cdd 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -318,9 +318,18 @@ async function resolveKnownTargets(options) {
   return mergeMaps(new Map(), ...downloaded, options.knownTargets);
 }
 
+/**
+ * @typedef {Object} Issue
+ * @property {'broken-link' | 'broken-target'} type
+ * @property {string} sourceUrl
+ * @property {string | null} sourceName
+ * @property {string} targetUrl
+ */
+
 /**
  * @typedef {Object} CrawlResult
  * @property {number} brokenLinks
+ * @property {Issue[]} issues
  */
 
 /**
@@ -329,7 +338,6 @@ async function resolveKnownTargets(options) {
  */
 export async function crawl(rawOptions) {
   const options = resolveOptions(rawOptions);
-  const knownTargets = await resolveKnownTargets(options);
   const startTime = Date.now();
 
   let appProcess;
@@ -354,6 +362,8 @@ export async function crawl(rawOptions) {
     console.log(`Server started on ${chalk.underline(options.host)}`);
   }
 
+  const knownTargets = await resolveKnownTargets(options);
+
   /** @type {Map<string, Promise<PageData>>} */
   const crawledPages = new Map();
   /** @type {Set<Link>} */
@@ -460,6 +470,9 @@ export async function crawl(rawOptions) {
   /** @type {Map<string, BrokenLinkError[]>} */
   const brokenLinksByPage = new Map();
 
+  /** @type {Issue[]} */
+  const issues = [];
+
   /**
    * @param {Link} link
    * @param {string} reason
@@ -469,6 +482,15 @@ export async function crawl(rawOptions) {
     const linksForPage = brokenLinksByPage.get(src) ?? [];
     brokenLinksByPage.set(src, linksForPage);
     linksForPage.push({ link, reason });
+
+    // Also record in issues array
+    const type = reason === 'target not found' ? 'broken-target' : 'broken-link';
+    issues.push({
+      type,
+      sourceUrl: link.src ?? '(unknown)',
+      sourceName: link.text,
+      targetUrl: link.href,
+    });
   }
 
   let totalLinks = 0;
@@ -540,5 +562,5 @@ export async function crawl(rawOptions) {
   console.log(`  Total broken link targets: ${chalk.cyan(brokenLinkTargets)}`);
 
   const totalBrokenLinks = brokenLinks + brokenLinkTargets;
-  return { brokenLinks: totalBrokenLinks };
+  return { brokenLinks: totalBrokenLinks, issues };
 }
diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
new file mode 100644
index 000000000..f240fcb58
--- /dev/null
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -0,0 +1,132 @@
+import path from 'node:path';
+
+import getPort from 'get-port';
+import { describe, expect, it } from 'vitest';
+
+// eslint-disable-next-line import/extensions
+import { crawl, Issue } from './index.mjs';
+
+/**
+ * Helper to assert that an issue with matching properties exists in the issues array
+ */
+function expectIssue(issues: Issue[], expectedIssue: Partial<Issue>) {
+  expect(issues).toEqual(expect.arrayContaining([expect.objectContaining(expectedIssue)]));
+}
+
+/**
+ * Helper to assert that no issue with matching properties exists in the issues array
+ */
+function expectNotIssue(issues: Issue[], notExpectedIssue: Partial<Issue>) {
+  expect(issues).not.toEqual(expect.arrayContaining([expect.objectContaining(notExpectedIssue)]));
+}
+
+describe('Broken Links Checker', () => {
+  const fixtureDir = path.join(import.meta.dirname, '__fixtures__', 'static-site');
+  const servePath = path.join(import.meta.dirname, '..', '..', 'node_modules', '.bin', 'serve');
+
+  it('should detect all broken links and targets across the entire site', async () => {
+    const port = await getPort();
+    const host = `http://localhost:${port}`;
+
+    const result = await crawl({
+      startCommand: `${servePath} ${fixtureDir} -p ${port}`,
+      host,
+      ignoredPaths: [/ignored-page\.html$/],
+      ignoredContent: ['.sidebar'],
+      ignoredTargets: new Set(['__should-be-ignored']),
+      knownTargets: new Map([['/external-page.html', new Set(['#valid-target'])]]),
+      knownTargetsDownloadUrl: [`${host}/known-targets.json`],
+    });
+
+    // Total: 2 broken-link + 5 broken-target = 7 issues
+    expect(result.issues).toHaveLength(7);
+
+    // Check broken-link type issues
+    expectIssue(result.issues, {
+      type: 'broken-link',
+      sourceUrl: '/broken-links.html',
+      targetUrl: '/does-not-exist.html',
+      sourceName: 'This page does not exist',
+    });
+
+    expectIssue(result.issues, {
+      type: 'broken-link',
+      sourceUrl: '/broken-links.html',
+      targetUrl: '/another-missing-page.html',
+      sourceName: 'Another missing page',
+    });
+
+    // Check broken-target type issues
+    expectIssue(result.issues, {
+      type: 'broken-target',
+      sourceUrl: '/broken-targets.html',
+      targetUrl: '/with-anchors.html#nonexistent',
+      sourceName: 'Non-existent anchor',
+    });
+
+    expectIssue(result.issues, {
+      type: 'broken-target',
+      sourceUrl: '/broken-targets.html',
+      targetUrl: '/valid.html#missing-target',
+      sourceName: 'Valid page, missing target',
+    });
+
+    expectIssue(result.issues, {
+      type: 'broken-target',
+      sourceUrl: '/broken-targets.html',
+      targetUrl: '/with-anchors.html#also-missing',
+      sourceName: 'Also missing',
+    });
+
+    // Verify that valid links are not reported
+    expectNotIssue(result.issues, { targetUrl: '/' });
+    expectNotIssue(result.issues, { targetUrl: '/valid.html' });
+    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html' });
+    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html#section1' });
+    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html#section2' });
+    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html#section3' });
+    expectNotIssue(result.issues, { targetUrl: '/nested/page.html' });
+
+    // Verify that external links are not reported
+    expectNotIssue(result.issues, { targetUrl: 'https://example.com' });
+    expectNotIssue(result.issues, { targetUrl: 'https://github.com/mui' });
+
+    // Test ignoredPaths: ignored-page.html should not be crawled
+    expectNotIssue(result.issues, { sourceUrl: '/ignored-page.html' });
+    expectNotIssue(result.issues, { targetUrl: '/this-link-should-not-be-checked.html' });
+
+    // Test ignoredContent: links in .sidebar should be ignored
+    expectNotIssue(result.issues, { targetUrl: '/sidebar-broken-link.html' });
+
+    // Test ignoredTargets: __should-be-ignored target should not cause issues
+    expectNotIssue(result.issues, {
+      targetUrl: '/page-with-custom-targets.html#__should-be-ignored',
+    });
+
+    // Test that non-ignored custom target is valid
+    expectNotIssue(result.issues, { targetUrl: '/page-with-custom-targets.html#custom-id' });
+
+    // Test knownTargets: valid-target is known and should not cause issues
+    expectNotIssue(result.issues, { targetUrl: '/external-page.html#valid-target' });
+
+    // Test knownTargets: invalid-target is not in knownTargets and should cause an issue
+    expectIssue(result.issues, {
+      type: 'broken-target',
+      sourceUrl: '/page-with-known-target-links.html',
+      targetUrl: '/external-page.html#invalid-target',
+      sourceName: 'Invalid external target',
+    });
+
+    // Test knownTargetsDownloadUrl: method1 and method2 are in downloaded known targets
+    expectNotIssue(result.issues, { targetUrl: '/api-page.html#method1' });
+    expectNotIssue(result.issues, { targetUrl: '/api-page.html#method2' });
+
+    // Test knownTargetsDownloadUrl: unknown-method is not in downloaded known targets and should cause an issue
+    expectIssue(result.issues, {
+      type: 'broken-target',
+      sourceUrl: '/page-with-api-links.html',
+      targetUrl: '/api-page.html#unknown-method',
+      sourceName: 'Unknown API method',
+    });
+  }, 30000);
+});
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 0df4b0559..8af6274c7 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -555,9 +555,15 @@ importers:
       eslint:
         specifier: ^9.36.0
         version: 9.38.0(jiti@2.5.1)
+      get-port:
+        specifier: ^7.1.0
+        version: 7.1.0
       prettier:
         specifier: ^3.6.2
         version: 3.6.2
+      serve:
+        specifier: ^14.2.5
+        version: 14.2.5
 
   packages/docs-infra:
     dependencies:
@@ -6027,6 +6033,9 @@ packages:
     resolution: {integrity: sha512-/HcYgtUSiJiot/XWGLOlGxPYUG65+/31V8oqk17vZLW1xlCoR4PampyePljOxY2n8/3jz9+tIFzICsyGujJZoA==}
     engines: {node: '>=18.12.0'}
 
+  '@zeit/schemas@2.36.0':
+    resolution: {integrity: sha512-7kjMwcChYEzMKjeex9ZFXkt1AyNov9R5HZtjBKVsmVpw7pa7ZtlCGvCBC2vnnXctaYN+aRI61HjIqeetZW5ROg==}
+
   '@zkochan/js-yaml@0.0.7':
     resolution: {integrity: sha512-nrUSn7hzt7J6JWgWGz78ZYI8wj+gdIJdk0Ynjpp8l+trkn58Uqsf6RYrYkEK+3X18EX+TNdtJI0WxAtc+L84SQ==}
     hasBin: true
@@ -6124,6 +6133,9 @@ packages:
   ajv@6.12.6:
     resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==}
 
+  ajv@8.12.0:
+    resolution: {integrity: sha512-sRu1kpcO9yLtYxBKvqfTeh9KzZEwO3STyX1HT+4CaDzC6HpTGYhIhPIzj9XuKU7KYDwnaeh5hcOwjy1QuJzBPA==}
+
   ajv@8.17.1:
     resolution: {integrity: sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==}
 
@@ -6178,6 +6190,9 @@ packages:
   aproba@2.0.0:
     resolution: {integrity: sha512-lYe4Gx7QT+MKGbDsA+Z+he/Wtef0BiwDOlK/XkBrdfsh9J/jPPXbX0tE9x9cl27Tmu5gg3QUbUrQYa/y+KOHPQ==}
 
+  arch@2.2.0:
+    resolution: {integrity: sha512-Of/R0wqp83cgHozfIYLbBMnej79U/SVGOOyuB3VVFv1NRM/PSFMK12x9KVtiYzJqmnU5WR2qp0Z5rHb7sWGnFQ==}
+
   archiver-utils@2.1.0:
     resolution: {integrity: sha512-bEL/yUb/fNNiNTuUz979Z0Yg5L+LzLxGJz8x79lYmR54fmTIb6ob/hNQgkQnIUDWIFjZVQwl9Xs356I6BAMHfw==}
     engines: {node: '>= 6'}
@@ -6478,6 +6493,10 @@ packages:
   bowser@2.12.1:
     resolution: {integrity: sha512-z4rE2Gxh7tvshQ4hluIT7XcFrgLIQaw9X3A+kTTRdovCz5PMukm/0QC/BKSYPj3omF5Qfypn9O/c5kgpmvYUCw==}
 
+  boxen@7.0.0:
+    resolution: {integrity: sha512-j//dBVuyacJbvW+tvZ9HuH03fZ46QcaKvvhZickZqtB271DxJ7SNRSNxrV/dZX0085m7hISRZWbzWlJvx/rHSg==}
+    engines: {node: '>=14.16'}
+
   boxen@8.0.1:
     resolution: {integrity: sha512-F3PH5k5juxom4xktynS7MoFY+NUWH5LC4CnH11YB8NPew+HLpmBLCybSAEyb2F+4pRXhuhWqFesoQd6DAyc2hw==}
     engines: {node: '>=18'}
@@ -6543,6 +6562,10 @@ packages:
     resolution: {integrity: sha512-tUkzZWK0M/qdoLEqikxBWe4kumyuwjl3HO6zHTr4yEI23EojPtLYXdG1+AQY7MN0cGyNDvEaJ8wiYQm6P2bPxg==}
     engines: {node: '>=12.17'}
 
+  bytes@3.0.0:
+    resolution: {integrity: sha512-pMhOfFDPiv9t5jjIXkHosWmkSyQbvsgEVNkz0ERHbuLh2T/7j4Mqqpz523Fe8MVY89KC6Sh/QfS2sM+SjgFDcw==}
+    engines: {node: '>= 0.8'}
+
   bytes@3.1.2:
     resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==}
     engines: {node: '>= 0.8'}
@@ -6597,6 +6620,10 @@ packages:
     resolution: {integrity: sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==}
     engines: {node: '>=6'}
 
+  camelcase@7.0.1:
+    resolution: {integrity: sha512-xlx1yCK2Oc1APsPXDL2LdlNP6+uu8OCDdhOBSVT279M/S+y75O30C2VuD8T2ogdePBBl7PfPF4504tnLgX3zfw==}
+    engines: {node: '>=14.16'}
+
   camelcase@8.0.0:
     resolution: {integrity: sha512-8WB3Jcas3swSvjIeA2yvCJ+Miyz5l1ZmB6HFb9R1317dt9LCQoswg/BGrmAmkWVEszSrrg4RwmO46qIm2OEnSA==}
     engines: {node: '>=16'}
@@ -6614,6 +6641,10 @@ packages:
   chainsaw@0.1.0:
     resolution: {integrity: sha512-75kWfWt6MEKNC8xYXIdRpDehRYY/tNSgwKaJq+dbbDcxORuVrrQ+SEHoWsniVn9XPYfP4gmdWIeDk/4YNp1rNQ==}
 
+  chalk-template@0.4.0:
+    resolution: {integrity: sha512-/ghrgmhfY8RaSdeo43hNXxpoHAtxdbskUHjPpfqUWGttFgycUhYPGx3YZBCnUCvOa7Doivn1IZec3DEGFoMgLg==}
+    engines: {node: '>=12'}
+
   chalk@4.1.0:
     resolution: {integrity: sha512-qwx12AxXe2Q5xQ43Ac//I6v5aXTipYrSESdOgzrN+9XjgEpyjpKuvSGaN4qE93f7TQTlerQQ8S+EQ0EyDoVL1A==}
     engines: {node: '>=10'}
@@ -6622,6 +6653,10 @@ packages:
     resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
     engines: {node: '>=10'}
 
+  chalk@5.0.1:
+    resolution: {integrity: sha512-Fo07WOYGqMfCWHOzSXOt2CxDbC6skS/jO9ynEcmpANMoPrD+W1r1K6Vx7iNm+AQmETU1Xr2t+n8nzkV9t6xh3w==}
+    engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
+
   chalk@5.4.1:
     resolution: {integrity: sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==}
     engines: {node: ^12.17.0 || ^14.13 || >=16.0.0}
@@ -6730,6 +6765,10 @@ packages:
   clipboard-copy@4.0.1:
     resolution: {integrity: sha512-wOlqdqziE/NNTUJsfSgXmBMIrYmfd5V0HCGsR8uAKHcg+h9NENWINcfRjtWGU77wDHC8B8ijV4hMTGYbrKovng==}
 
+  clipboardy@3.0.0:
+    resolution: {integrity: sha512-Su+uU5sr1jkUy1sGRpLKjKrvEOVXgSgiSInwa/qeID6aJ07yh+5NWc3h2QfjHjBnfX4LhtFcuAWKUsJ3r+fjbg==}
+    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
   clipboardy@4.0.0:
     resolution: {integrity: sha512-5mOlNS0mhX0707P2I0aZ2V/cmHUEO/fL7VFLqszkhUsxt7RwnmrInf/eEQKlf5GzvYeHIjT+Ov1HRfNmymlG0w==}
     engines: {node: '>=18'}
@@ -6893,6 +6932,10 @@ packages:
   console-control-strings@1.1.0:
     resolution: {integrity: sha512-ty/fTekppD2fIwRvnZAVdeOiGd1c7YXEixbgJTNzqcxJWKQnjJ/V1bNEEE6hygpM3WjwHFUVK6HTjWSzV4a8sQ==}
 
+  content-disposition@0.5.2:
+    resolution: {integrity: sha512-kRGRZw3bLlFISDBgwTSA1TMBFN6J6GWDeubmDE3AF+3+yXL8hTWv8r5rkLbqYXY4RjPk/EzHnClI3zQf1cFmHA==}
+    engines: {node: '>= 0.6'}
+
   content-disposition@0.5.4:
     resolution: {integrity: sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==}
     engines: {node: '>= 0.6'}
@@ -8990,6 +9033,10 @@ packages:
     resolution: {integrity: sha512-VRSzKkbMm5jMDoKLbltAkFQ5Qr7VDiTFGXxYFXXowVj387GeGNOCsOH6Msy00SGZ3Fp84b1Naa1psqgcCIEP5Q==}
     engines: {node: '>=0.10.0'}
 
+  is-port-reachable@4.0.0:
+    resolution: {integrity: sha512-9UoipoxYmSk6Xy7QFgRv2HDyaysmgSG75TFQs6S+3pDM7ZhKTF/bskZV+0UlABHzKjNVhPjYCLfeZUEg1wXxig==}
+    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+
   is-potential-custom-element-name@1.0.1:
     resolution: {integrity: sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==}
 
@@ -9788,6 +9835,10 @@ packages:
     resolution: {integrity: sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==}
     engines: {node: '>=8.6'}
 
+  mime-db@1.33.0:
+    resolution: {integrity: sha512-BHJ/EKruNIqJf/QahvxwQZXKygOQ256myeN/Ew+THcAa5q+PjyTTMMeNQC4DZw5AwfvelsUrA6B67NKMqXDbzQ==}
+    engines: {node: '>= 0.6'}
+
   mime-db@1.52.0:
     resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
     engines: {node: '>= 0.6'}
@@ -9796,6 +9847,10 @@ packages:
     resolution: {integrity: sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==}
     engines: {node: '>= 0.6'}
 
+  mime-types@2.1.18:
+    resolution: {integrity: sha512-lc/aahn+t4/SWV/qcmumYjymLsWfN3ELhpmVuUFjgsORruuZPVSwAQryq+HHGvO/SI2KVX26bx+En+zhM8g8hQ==}
+    engines: {node: '>= 0.6'}
+
   mime-types@2.1.35:
     resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
     engines: {node: '>= 0.6'}
@@ -10570,6 +10625,9 @@ packages:
     resolution: {integrity: sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==}
     engines: {node: '>=0.10.0'}
 
+  path-is-inside@1.0.2:
+    resolution: {integrity: sha512-DUWJr3+ULp4zXmol/SZkFf3JGsS9/SIv+Y3Rt93/UjPpDpklB5f1er4O3POIbUuUJ3FXgqte2Q7SrU6zAqwk8w==}
+
   path-key@3.1.1:
     resolution: {integrity: sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==}
     engines: {node: '>=8'}
@@ -10595,6 +10653,9 @@ packages:
   path-to-regexp@0.1.12:
     resolution: {integrity: sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==}
 
+  path-to-regexp@3.3.0:
+    resolution: {integrity: sha512-qyCH421YQPS2WFDxDjftfc1ZR5WKQzVzqsp4n9M2kQhVOo/ByahFoUNJfl58kOcEGfQ//7weFTDhm+ss8Ecxgw==}
+
   path-to-regexp@6.3.0:
     resolution: {integrity: sha512-Yhpw4T9C6hPpgPeA28us07OJeqZ5EzQTkbfwuhsUg0c237RomFoETJgmp2sa3F/41gfLE6G5cqcYwznmeEeOlQ==}
 
@@ -10966,6 +11027,10 @@ packages:
   randombytes@2.1.0:
     resolution: {integrity: sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==}
 
+  range-parser@1.2.0:
+    resolution: {integrity: sha512-kA5WQoNVo4t9lNx2kQNFCxKeBl5IbbSNBl1M/tLkw9WCn+hxNBAW5Qh8gdhs63CJnhjJ2zQWFoqPJP2sK1AV5A==}
+    engines: {node: '>= 0.6'}
+
   range-parser@1.2.1:
     resolution: {integrity: sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==}
     engines: {node: '>= 0.6'}
@@ -11212,10 +11277,17 @@ packages:
     resolution: {integrity: sha512-H66BPQMrv+V16t8xtmq+UC0CBpiTBA60V8ibS1QVReIp8T1z8hwFxqcGzm9K6lgsN7sB5edVH8a+ze6Fqm4weA==}
     engines: {node: '>=4'}
 
+  registry-auth-token@3.3.2:
+    resolution: {integrity: sha512-JL39c60XlzCVgNrO+qq68FoNb56w/m7JYvGR2jT5iR1xBrUA3Mfx5Twk5rqTThPmQKMWydGmq8oFtDlxfrmxnQ==}
+
   registry-auth-token@5.1.0:
     resolution: {integrity: sha512-GdekYuwLXLxMuFTwAPg5UKGLW/UXzQrZvH/Zj791BQif5T05T0RsaLfHc9q3ZOKi7n+BoprPD9mJ0O0k4xzUlw==}
     engines: {node: '>=14'}
 
+  registry-url@3.1.0:
+    resolution: {integrity: sha512-ZbgR5aZEdf4UKZVBPYIgaglBmSF2Hi94s2PcIHhRGFjKYu+chjJdYfHn4rt3hB6eCKLJ8giVIIfgMa1ehDfZKA==}
+    engines: {node: '>=0.10.0'}
+
   registry-url@6.0.1:
     resolution: {integrity: sha512-+crtS5QjFRqFCoQmvGduwYWEBng99ZvmFvF+cUJkGYF1L1BfU8C6Zp9T7f5vPAwyLkUExpvK+ANVZmGU49qi4Q==}
     engines: {node: '>=12'}
@@ -11477,10 +11549,18 @@ packages:
   serialize-javascript@6.0.2:
     resolution: {integrity: sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==}
 
+  serve-handler@6.1.6:
+    resolution: {integrity: sha512-x5RL9Y2p5+Sh3D38Fh9i/iQ5ZK+e4xuXRd/pGbM4D13tgo/MGwbttUk8emytcr1YYzBYs+apnUngBDFYfpjPuQ==}
+
   serve-static@1.16.2:
     resolution: {integrity: sha512-VqpjJZKadQB/PEbEwvFdO43Ax5dFBZ2UECszz8bQ7pi7wt//PWe1P6MN7eCnjsatYtBT6EuiClbjSWP2WrIoTw==}
     engines: {node: '>= 0.8.0'}
 
+  serve@14.2.5:
+    resolution: {integrity: sha512-Qn/qMkzCcMFVPb60E/hQy+iRLpiU8PamOfOSYoAHmmF+fFFmpPpqa6Oci2iWYpTdOUM3VF+TINud7CfbQnsZbA==}
+    engines: {node: '>= 14'}
+    hasBin: true
+
   set-blocking@2.0.0:
     resolution: {integrity: sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==}
 
@@ -12471,6 +12551,9 @@ packages:
     peerDependencies:
       browserslist: '>= 4.21.0'
 
+  update-check@1.5.4:
+    resolution: {integrity: sha512-5YHsflzHP4t1G+8WGPlvKbJEbAJGCgw+Em+dGR1KmBUbr1J36SJBqlHLjR7oob7sco5hWHGQVcr9B2poIVDDTQ==}
+
   update-notifier@7.3.1:
     resolution: {integrity: sha512-+dwUY4L35XFYEzE+OAL3sarJdUioVovq+8f7lcIJ7wnmnYQV5UD1Y/lcwaMSyaQ6Bj3JMj1XSTjZbNLHn/19yA==}
     engines: {node: '>=18'}
@@ -12798,6 +12881,10 @@ packages:
   wide-align@1.1.5:
     resolution: {integrity: sha512-eDMORYaPNZ4sQIuuYPDHdQvf4gyCF9rEEV/yPxGfwPkRodwEgiMUUXTx/dex+Me0wxx53S+NgUHaP7y3MGlDmg==}
 
+  widest-line@4.0.1:
+    resolution: {integrity: sha512-o0cyEG0e8GPzT4iGHphIOh0cJOV8fivsXxddQasHPHfoZf1ZexrfeA21w2NaEN1RHE+fXlfISmOE8R9N3u3Qig==}
+    engines: {node: '>=12'}
+
   widest-line@5.0.0:
     resolution: {integrity: sha512-c9bZp7b5YtRj2wOe6dlj32MK+Bx/M/d+9VB2SHM1OtsUHR0aV0tdP6DWh/iMt0kWi1t5g1Iudu6hQRNd1A4PVA==}
     engines: {node: '>=18'}
@@ -13072,7 +13159,7 @@ snapshots:
 
   '@argos-ci/api-client@0.11.1':
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       openapi-fetch: 0.14.0
     transitivePeerDependencies:
       - supports-color
@@ -13082,7 +13169,7 @@ snapshots:
       '@argos-ci/api-client': 0.11.1
       '@argos-ci/util': 3.1.0
       convict: 6.2.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       fast-glob: 3.3.3
       sharp: 0.34.4
       tmp: 0.2.5
@@ -13698,7 +13785,7 @@ snapshots:
       '@babel/types': 7.28.4
       '@jridgewell/remapping': 2.3.5
       convert-source-map: 2.0.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       gensync: 1.0.0-beta.2
       json5: 2.2.3
       semver: 6.3.1
@@ -13750,7 +13837,7 @@ snapshots:
       '@babel/core': 7.28.4
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       lodash.debounce: 4.0.8
       resolve: 1.22.10
     transitivePeerDependencies:
@@ -14432,7 +14519,7 @@ snapshots:
       '@babel/parser': 7.28.4
       '@babel/template': 7.27.2
       '@babel/types': 7.28.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -15018,7 +15105,7 @@ snapshots:
   '@eslint/config-array@0.21.1':
     dependencies:
       '@eslint/object-schema': 2.1.7
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       minimatch: 3.1.2
     transitivePeerDependencies:
       - supports-color
@@ -15040,7 +15127,7 @@ snapshots:
   '@eslint/eslintrc@3.3.1':
     dependencies:
       ajv: 6.12.6
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       espree: 10.4.0
       globals: 14.0.0
       ignore: 5.3.2
@@ -15596,6 +15683,19 @@ snapshots:
 
   '@lukeed/ms@2.0.2': {}
 
+  '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)':
+    dependencies:
+      consola: 3.4.2
+      detect-libc: 2.1.1
+      https-proxy-agent: 7.0.6
+      node-fetch: 2.7.0(encoding@0.1.13)
+      nopt: 8.1.0
+      semver: 7.7.3
+      tar: 7.4.3
+    transitivePeerDependencies:
+      - encoding
+      - supports-color
+
   '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)(supports-color@10.2.0)':
     dependencies:
       consola: 3.4.2
@@ -16664,6 +16764,45 @@ snapshots:
 
   '@netlify/types@2.0.3': {}
 
+  '@netlify/zip-it-and-ship-it@14.1.8(encoding@0.1.13)(rollup@4.52.5)':
+    dependencies:
+      '@babel/parser': 7.28.4
+      '@babel/types': 7.28.4
+      '@netlify/binary-info': 1.0.0
+      '@netlify/serverless-functions-api': 2.5.0
+      '@vercel/nft': 0.29.4(encoding@0.1.13)(rollup@4.52.5)
+      archiver: 7.0.1
+      common-path-prefix: 3.0.0
+      copy-file: 11.1.0
+      es-module-lexer: 1.7.0
+      esbuild: 0.25.10
+      execa: 8.0.1
+      fast-glob: 3.3.3
+      filter-obj: 6.1.0
+      find-up: 7.0.0
+      is-path-inside: 4.0.0
+      junk: 4.0.1
+      locate-path: 7.2.0
+      merge-options: 3.0.4
+      minimatch: 9.0.5
+      normalize-path: 3.0.0
+      p-map: 7.0.3
+      path-exists: 5.0.0
+      precinct: 12.2.0
+      require-package-name: 2.0.1
+      resolve: 2.0.0-next.5
+      semver: 7.7.3
+      tmp-promise: 3.0.3
+      toml: 3.0.0
+      unixify: 1.0.0
+      urlpattern-polyfill: 8.0.2
+      yargs: 17.7.2
+      zod: 3.25.76
+    transitivePeerDependencies:
+      - encoding
+      - rollup
+      - supports-color
+
   '@netlify/zip-it-and-ship-it@14.1.8(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@babel/parser': 7.28.4
@@ -16752,7 +16891,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       lru-cache: 10.4.3
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -16762,7 +16901,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       lru-cache: 11.2.2
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -17204,7 +17343,7 @@ snapshots:
 
   '@pnpm/tabtab@0.5.4':
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       enquirer: 2.4.1
       minimist: 1.2.8
       untildify: 4.0.0
@@ -19182,9 +19321,9 @@ snapshots:
     dependencies:
       '@typescript-eslint/scope-manager': 8.45.0
       '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
       '@typescript-eslint/visitor-keys': 8.45.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19199,10 +19338,19 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@typescript-eslint/project-service@8.45.0(typescript@5.9.3)':
+    dependencies:
+      '@typescript-eslint/tsconfig-utils': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/types': 8.45.0
+      debug: 4.4.3(supports-color@8.1.1)
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   '@typescript-eslint/rule-tester@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/parser': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
       '@typescript-eslint/utils': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       ajv: 6.12.6
       eslint: 9.38.0(jiti@2.5.1)
@@ -19225,9 +19373,9 @@ snapshots:
   '@typescript-eslint/type-utils@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
       '@typescript-eslint/utils': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 9.38.0(jiti@2.5.1)
       ts-api-utils: 2.1.0(typescript@5.9.3)
       typescript: 5.9.3
@@ -19252,12 +19400,28 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@typescript-eslint/typescript-estree@8.45.0(typescript@5.9.3)':
+    dependencies:
+      '@typescript-eslint/project-service': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/tsconfig-utils': 8.45.0(typescript@5.9.3)
+      '@typescript-eslint/types': 8.45.0
+      '@typescript-eslint/visitor-keys': 8.45.0
+      debug: 4.4.3(supports-color@8.1.1)
+      fast-glob: 3.3.3
+      is-glob: 4.0.3
+      minimatch: 9.0.5
+      semver: 7.7.3
+      ts-api-utils: 2.1.0(typescript@5.9.3)
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   '@typescript-eslint/utils@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@eslint-community/eslint-utils': 4.9.0(eslint@9.38.0(jiti@2.5.1))
       '@typescript-eslint/scope-manager': 8.45.0
       '@typescript-eslint/types': 8.45.0
-      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19329,6 +19493,25 @@ snapshots:
   '@unrs/resolver-binding-win32-x64-msvc@1.11.1':
     optional: true
 
+  '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)':
+    dependencies:
+      '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)
+      '@rollup/pluginutils': 5.2.0(rollup@4.52.5)
+      acorn: 8.15.0
+      acorn-import-attributes: 1.9.5(acorn@8.15.0)
+      async-sema: 3.1.1
+      bindings: 1.5.0
+      estree-walker: 2.0.2
+      glob: 10.4.5
+      graceful-fs: 4.2.11
+      node-gyp-build: 4.8.4
+      picomatch: 4.0.3
+      resolve-from: 5.0.0
+    transitivePeerDependencies:
+      - encoding
+      - rollup
+      - supports-color
+
   '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)(supports-color@10.2.0)
@@ -19376,7 +19559,7 @@ snapshots:
       '@ampproject/remapping': 2.3.0
       '@bcoe/v8-coverage': 1.0.2
       ast-v8-to-istanbul: 0.3.5
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       istanbul-lib-coverage: 3.2.2
       istanbul-lib-report: 3.0.1
       istanbul-lib-source-maps: 5.0.6
@@ -19642,6 +19825,8 @@ snapshots:
       js-yaml: 3.14.1
       tslib: 2.8.1
 
+  '@zeit/schemas@2.36.0': {}
+
   '@zkochan/js-yaml@0.0.7':
     dependencies:
       argparse: 2.0.1
@@ -19721,6 +19906,13 @@ snapshots:
       json-schema-traverse: 0.4.1
       uri-js: 4.4.1
 
+  ajv@8.12.0:
+    dependencies:
+      fast-deep-equal: 3.1.3
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+      uri-js: 4.4.1
+
   ajv@8.17.1:
     dependencies:
       fast-deep-equal: 3.1.3
@@ -19767,6 +19959,8 @@ snapshots:
 
   aproba@2.0.0: {}
 
+  arch@2.2.0: {}
+
   archiver-utils@2.1.0:
     dependencies:
       glob: 7.2.3
@@ -20152,6 +20346,17 @@ snapshots:
 
   bowser@2.12.1: {}
 
+  boxen@7.0.0:
+    dependencies:
+      ansi-align: 3.0.1
+      camelcase: 7.0.1
+      chalk: 5.6.2
+      cli-boxes: 3.0.0
+      string-width: 5.1.2
+      type-fest: 2.19.0
+      widest-line: 4.0.1
+      wrap-ansi: 8.1.0
+
   boxen@8.0.1:
     dependencies:
       ansi-align: 3.0.1
@@ -20218,6 +20423,8 @@ snapshots:
 
   byte-size@8.1.1: {}
 
+  bytes@3.0.0: {}
+
   bytes@3.1.2: {}
 
   cac@6.7.14: {}
@@ -20300,6 +20507,8 @@ snapshots:
 
   camelcase@5.3.1: {}
 
+  camelcase@7.0.1: {}
+
   camelcase@8.0.0: {}
 
   caniuse-lite@1.0.30001751: {}
@@ -20318,6 +20527,10 @@ snapshots:
     dependencies:
       traverse: 0.3.9
 
+  chalk-template@0.4.0:
+    dependencies:
+      chalk: 4.1.2
+
   chalk@4.1.0:
     dependencies:
       ansi-styles: 4.3.0
@@ -20328,6 +20541,8 @@ snapshots:
       ansi-styles: 4.3.0
       supports-color: 7.2.0
 
+  chalk@5.0.1: {}
+
   chalk@5.4.1: {}
 
   chalk@5.6.2: {}
@@ -20410,6 +20625,12 @@ snapshots:
 
   clipboard-copy@4.0.1: {}
 
+  clipboardy@3.0.0:
+    dependencies:
+      arch: 2.2.0
+      execa: 5.1.1
+      is-wsl: 2.2.0
+
   clipboardy@4.0.0:
     dependencies:
       execa: 8.0.1
@@ -20594,6 +20815,8 @@ snapshots:
 
   console-control-strings@1.1.0: {}
 
+  content-disposition@0.5.2: {}
+
   content-disposition@0.5.4:
     dependencies:
       safe-buffer: 5.2.1
@@ -21064,6 +21287,15 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  detective-typescript@14.0.0(typescript@5.9.3):
+    dependencies:
+      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
+      ast-module-types: 6.0.1
+      node-source-walk: 7.0.1
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   detective-vue2@2.2.0(supports-color@10.2.0)(typescript@5.9.3):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -21077,6 +21309,19 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  detective-vue2@2.2.0(typescript@5.9.3):
+    dependencies:
+      '@dependents/detective-less': 5.0.1
+      '@vue/compiler-sfc': 3.5.21
+      detective-es6: 5.0.1
+      detective-sass: 6.0.1
+      detective-scss: 5.0.1
+      detective-stylus: 5.0.1
+      detective-typescript: 14.0.0(typescript@5.9.3)
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   dettle@1.0.5: {}
 
   devlop@1.1.0:
@@ -21513,7 +21758,7 @@ snapshots:
 
   eslint-import-resolver-typescript@4.4.4(eslint-plugin-import@2.32.0)(eslint@9.38.0(jiti@2.5.1)):
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 9.38.0(jiti@2.5.1)
       eslint-import-context: 0.1.9(unrs-resolver@1.11.1)
       get-tsconfig: 4.10.1
@@ -21697,7 +21942,7 @@ snapshots:
       ajv: 6.12.6
       chalk: 4.1.2
       cross-spawn: 7.0.6
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       escape-string-regexp: 4.0.0
       eslint-scope: 8.4.0
       eslint-visitor-keys: 4.2.1
@@ -21896,7 +22141,7 @@ snapshots:
 
   extract-zip@2.0.1:
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       get-stream: 5.2.0
       yauzl: 2.10.0
     optionalDependencies:
@@ -22136,7 +22381,7 @@ snapshots:
 
   follow-redirects@1.15.11(debug@4.4.3):
     optionalDependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
 
   for-each@0.3.5:
     dependencies:
@@ -22253,7 +22498,7 @@ snapshots:
   gaxios@6.7.1(encoding@0.1.13):
     dependencies:
       extend: 3.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       is-stream: 2.0.1
       node-fetch: 2.7.0(encoding@0.1.13)
       uuid: 9.0.1
@@ -22772,7 +23017,7 @@ snapshots:
   http-proxy-agent@7.0.2:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -22799,7 +23044,7 @@ snapshots:
   http-proxy-middleware@3.0.3:
     dependencies:
       '@types/http-proxy': 1.17.16
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       http-proxy: 1.18.1(debug@4.4.3)
       is-glob: 4.0.3
       is-plain-object: 5.0.0
@@ -22822,6 +23067,13 @@ snapshots:
       quick-lru: 5.1.1
       resolve-alpn: 1.2.1
 
+  https-proxy-agent@7.0.6:
+    dependencies:
+      agent-base: 7.1.4
+      debug: 4.4.3(supports-color@8.1.1)
+    transitivePeerDependencies:
+      - supports-color
+
   https-proxy-agent@7.0.6(supports-color@10.2.0):
     dependencies:
       agent-base: 7.1.4
@@ -23166,6 +23418,8 @@ snapshots:
 
   is-plain-object@5.0.0: {}
 
+  is-port-reachable@4.0.0: {}
+
   is-potential-custom-element-name@1.0.1: {}
 
   is-property@1.0.2: {}
@@ -23272,7 +23526,7 @@ snapshots:
   istanbul-lib-source-maps@5.0.6:
     dependencies:
       '@jridgewell/trace-mapping': 0.3.30
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       istanbul-lib-coverage: 3.2.2
     transitivePeerDependencies:
       - supports-color
@@ -23355,7 +23609,7 @@ snapshots:
       decimal.js: 10.6.0
       html-encoding-sniffer: 4.0.0
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       is-potential-custom-element-name: 1.0.1
       parse5: 7.3.0
       rrweb-cssom: 0.8.0
@@ -24175,7 +24429,7 @@ snapshots:
   micromark@4.0.2:
     dependencies:
       '@types/debug': 4.1.12
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       decode-named-character-reference: 1.2.0
       devlop: 1.1.0
       micromark-core-commonmark: 2.0.3
@@ -24199,10 +24453,16 @@ snapshots:
       braces: 3.0.3
       picomatch: 2.3.1
 
+  mime-db@1.33.0: {}
+
   mime-db@1.52.0: {}
 
   mime-db@1.54.0: {}
 
+  mime-types@2.1.18:
+    dependencies:
+      mime-db: 1.33.0
+
   mime-types@2.1.35:
     dependencies:
       mime-db: 1.52.0
@@ -24444,7 +24704,7 @@ snapshots:
       '@netlify/headers-parser': 9.0.2
       '@netlify/local-functions-proxy': 2.0.3
       '@netlify/redirect-parser': 15.0.3
-      '@netlify/zip-it-and-ship-it': 14.1.8(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)
+      '@netlify/zip-it-and-ship-it': 14.1.8(encoding@0.1.13)(rollup@4.52.5)
       '@octokit/rest': 22.0.0
       '@opentelemetry/api': 1.8.0
       '@pnpm/tabtab': 0.5.4
@@ -24462,7 +24722,7 @@ snapshots:
       content-type: 1.0.5
       cookie: 1.0.2
       cron-parser: 4.9.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       decache: 4.6.2
       dot-prop: 9.0.0
       dotenv: 17.2.3
@@ -24484,7 +24744,7 @@ snapshots:
       gitconfiglocal: 2.1.0
       http-proxy: 1.18.1(debug@4.4.3)
       http-proxy-middleware: 2.0.9(debug@4.4.3)
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       inquirer: 8.2.7(@types/node@22.18.10)
       inquirer-autocomplete-prompt: 1.4.0(inquirer@8.2.7(@types/node@22.18.10))
       ipx: 3.1.1(@netlify/blobs@10.0.11)
@@ -25201,6 +25461,8 @@ snapshots:
 
   path-is-absolute@1.0.1: {}
 
+  path-is-inside@1.0.2: {}
+
   path-key@3.1.1: {}
 
   path-key@4.0.0: {}
@@ -25221,6 +25483,8 @@ snapshots:
 
   path-to-regexp@0.1.12: {}
 
+  path-to-regexp@3.3.0: {}
+
   path-to-regexp@6.3.0: {}
 
   path-type@3.0.0:
@@ -25395,6 +25659,26 @@ snapshots:
 
   preact@10.24.3: {}
 
+  precinct@12.2.0:
+    dependencies:
+      '@dependents/detective-less': 5.0.1
+      commander: 12.1.0
+      detective-amd: 6.0.1
+      detective-cjs: 6.0.1
+      detective-es6: 5.0.1
+      detective-postcss: 7.0.1(postcss@8.5.6)
+      detective-sass: 6.0.1
+      detective-scss: 5.0.1
+      detective-stylus: 5.0.1
+      detective-typescript: 14.0.0(typescript@5.9.3)
+      detective-vue2: 2.2.0(typescript@5.9.3)
+      module-definition: 6.0.1
+      node-source-walk: 7.0.1
+      postcss: 8.5.6
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   precinct@12.2.0(supports-color@10.2.0):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -25616,6 +25900,8 @@ snapshots:
     dependencies:
       safe-buffer: 5.2.1
 
+  range-parser@1.2.0: {}
+
   range-parser@1.2.1: {}
 
   rasterizehtml@1.3.1:
@@ -25935,10 +26221,19 @@ snapshots:
       unicode-match-property-ecmascript: 2.0.0
       unicode-match-property-value-ecmascript: 2.2.0
 
+  registry-auth-token@3.3.2:
+    dependencies:
+      rc: 1.2.8
+      safe-buffer: 5.2.1
+
   registry-auth-token@5.1.0:
     dependencies:
       '@pnpm/npm-conf': 2.3.1
 
+  registry-url@3.1.0:
+    dependencies:
+      rc: 1.2.8
+
   registry-url@6.0.1:
     dependencies:
       rc: 1.2.8
@@ -26215,6 +26510,16 @@ snapshots:
     dependencies:
       randombytes: 2.1.0
 
+  serve-handler@6.1.6:
+    dependencies:
+      bytes: 3.0.0
+      content-disposition: 0.5.2
+      mime-types: 2.1.18
+      minimatch: 3.1.2
+      path-is-inside: 1.0.2
+      path-to-regexp: 3.3.0
+      range-parser: 1.2.0
+
   serve-static@1.16.2:
     dependencies:
       encodeurl: 2.0.0
@@ -26224,6 +26529,22 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  serve@14.2.5:
+    dependencies:
+      '@zeit/schemas': 2.36.0
+      ajv: 8.12.0
+      arg: 5.0.2
+      boxen: 7.0.0
+      chalk: 5.0.1
+      chalk-template: 0.4.0
+      clipboardy: 3.0.0
+      compression: 1.8.1
+      is-port-reachable: 4.0.0
+      serve-handler: 6.1.6
+      update-check: 1.5.4
+    transitivePeerDependencies:
+      - supports-color
+
   set-blocking@2.0.0: {}
 
   set-cookie-parser@2.7.1: {}
@@ -26381,7 +26702,7 @@ snapshots:
   socks-proxy-agent@8.0.5:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       socks: 2.8.7
     transitivePeerDependencies:
       - supports-color
@@ -26703,7 +27024,7 @@ snapshots:
       cosmiconfig: 9.0.0(typescript@5.9.3)
       css-functions-list: 3.2.3
       css-tree: 3.1.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       fast-glob: 3.3.3
       fastest-levenshtein: 1.0.16
       file-entry-cache: 10.1.4
@@ -27020,7 +27341,7 @@ snapshots:
   tuf-js@3.1.0:
     dependencies:
       '@tufjs/models': 3.0.1
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       make-fetch-happen: 14.0.3
     transitivePeerDependencies:
       - supports-color
@@ -27028,7 +27349,7 @@ snapshots:
   tuf-js@4.0.0:
     dependencies:
       '@tufjs/models': 4.0.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       make-fetch-happen: 15.0.2
     transitivePeerDependencies:
       - supports-color
@@ -27101,7 +27422,7 @@ snapshots:
     dependencies:
       '@typescript-eslint/eslint-plugin': 8.45.0(@typescript-eslint/parser@8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3))(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       '@typescript-eslint/parser': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.45.0(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.45.0(typescript@5.9.3)
       '@typescript-eslint/utils': 8.45.0(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
@@ -27295,6 +27616,11 @@ snapshots:
       escalade: 3.2.0
       picocolors: 1.1.1
 
+  update-check@1.5.4:
+    dependencies:
+      registry-auth-token: 3.3.2
+      registry-url: 3.1.0
+
   update-notifier@7.3.1:
     dependencies:
       boxen: 8.0.1
@@ -27386,7 +27712,7 @@ snapshots:
   vite-node@3.2.4(@types/node@22.18.10)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1):
     dependencies:
       cac: 6.7.14
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       es-module-lexer: 1.7.0
       pathe: 2.0.3
       vite: 7.1.11(@types/node@22.18.10)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)
@@ -27406,7 +27732,7 @@ snapshots:
 
   vite-tsconfig-paths@5.1.4(typescript@5.9.3)(vite@7.1.11(@types/node@22.18.10)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       globrex: 0.1.2
       tsconfck: 3.1.6(typescript@5.9.3)
     optionalDependencies:
@@ -27468,7 +27794,7 @@ snapshots:
       '@vitest/spy': 3.2.4
       '@vitest/utils': 3.2.4
       chai: 5.3.3
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       expect-type: 1.2.2
       magic-string: 0.30.18
       pathe: 2.0.3
@@ -27514,7 +27840,7 @@ snapshots:
     dependencies:
       chalk: 4.1.2
       commander: 9.5.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -27660,6 +27986,10 @@ snapshots:
     dependencies:
       string-width: 4.2.3
 
+  widest-line@4.0.1:
+    dependencies:
+      string-width: 5.1.2
+
   widest-line@5.0.0:
     dependencies:
       string-width: 7.2.0

From 134bb017847003d9b97d87ce962ec9877c0ca600 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 13:02:42 +0200
Subject: [PATCH 03/17] Update index.mjs

---
 .../src/brokenLinksChecker/index.mjs          | 53 +++++++++++++------
 1 file changed, 37 insertions(+), 16 deletions(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 8bd5f7cdd..510346730 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -332,6 +332,38 @@ async function resolveKnownTargets(options) {
  * @property {Issue[]} issues
  */
 
+/**
+ * Report broken links grouped by source page
+ * @param {Issue[]} issuesList
+ */
+function reportIssues(issuesList) {
+  if (issuesList.length === 0) {
+    return;
+  }
+
+  console.error('\nBroken links found:\n');
+
+  // Group issues by source URL
+  /** @type {Map<string, Issue[]>} */
+  const issuesBySource = new Map();
+  for (const issue of issuesList) {
+    const sourceIssues = issuesBySource.get(issue.sourceUrl) ?? [];
+    if (sourceIssues.length === 0) {
+      issuesBySource.set(issue.sourceUrl, sourceIssues);
+    }
+    sourceIssues.push(issue);
+  }
+
+  // Report issues grouped by source
+  for (const [sourceUrl, sourceIssues] of issuesBySource.entries()) {
+    console.error(`Source ${chalk.cyan(sourceUrl)}:`);
+    for (const issue of sourceIssues) {
+      const reason = issue.type === 'broken-target' ? 'target not found' : 'returned status 404';
+      console.error(`  [${issue.sourceName}](${chalk.cyan(issue.targetUrl)}) (${reason})`);
+    }
+  }
+}
+
 /**
  * @param {CrawlOptions} rawOptions
  * @returns {Promise<CrawlResult>}
@@ -495,8 +527,6 @@ export async function crawl(rawOptions) {
 
   let totalLinks = 0;
   let checkedLinks = 0;
-  let brokenLinks = 0;
-  let brokenLinkTargets = 0;
   for (const crawledLink of crawledLinks) {
     totalLinks += 1;
     const pageUrl = getPageUrl(crawledLink.href, options.ignoredPaths);
@@ -512,7 +542,6 @@ export async function crawl(rawOptions) {
     if (knownPage) {
       if (parsed.hash && !knownPage.has(parsed.hash)) {
         recordBrokenLink(crawledLink, 'target not found');
-        brokenLinkTargets += 1;
       }
       continue;
     }
@@ -521,32 +550,24 @@ export async function crawl(rawOptions) {
 
     if (!page) {
       recordBrokenLink(crawledLink, 'not crawled');
-      brokenLinks += 1;
       continue;
     }
     if (page.status >= 400) {
       recordBrokenLink(crawledLink, `returned status ${page.status}`);
-      brokenLinks += 1;
       continue;
     }
     if (parsed.hash) {
       if (!page.targets.has(parsed.hash)) {
         recordBrokenLink(crawledLink, 'target not found');
-        brokenLinkTargets += 1;
       }
     }
   }
 
-  // Report broken links grouped by source page
-  if (brokenLinksByPage.size > 0) {
-    console.error('\nBroken links found:\n');
-    for (const [pageUrl, errors] of brokenLinksByPage.entries()) {
-      console.error(`Source ${chalk.cyan(pageUrl)}:`);
-      for (const { link, reason } of errors) {
-        console.error(`  [${link.text}](${chalk.cyan(link.href)}) (${reason})`);
-      }
-    }
-  }
+  reportIssues(issues);
+
+  // Derive counts from issues
+  const brokenLinks = issues.filter((issue) => issue.type === 'broken-link').length;
+  const brokenLinkTargets = issues.filter((issue) => issue.type === 'broken-target').length;
 
   const endTime = Date.now();
   const durationSeconds = (endTime - startTime) / 1000;

From a777237dcef977b0c8488c732d17876c02aafc1f Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 13:08:51 +0200
Subject: [PATCH 04/17] Update index.mjs

---
 .../src/brokenLinksChecker/index.mjs          | 66 ++++++++-----------
 1 file changed, 29 insertions(+), 37 deletions(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 510346730..1ef7d2b1f 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -328,7 +328,8 @@ async function resolveKnownTargets(options) {
 
 /**
  * @typedef {Object} CrawlResult
- * @property {number} brokenLinks
+ * @property {Set<Link>} links
+ * @property {Map<string, PageData>} pages
  * @property {Issue[]} issues
  */
 
@@ -525,40 +526,33 @@ export async function crawl(rawOptions) {
     });
   }
 
-  let totalLinks = 0;
-  let checkedLinks = 0;
   for (const crawledLink of crawledLinks) {
-    totalLinks += 1;
     const pageUrl = getPageUrl(crawledLink.href, options.ignoredPaths);
-    if (pageUrl === null) {
-      // External link
-      continue;
-    }
-    checkedLinks += 1;
-
-    const parsed = new URL(crawledLink.href, 'http://localhost');
-
-    const knownPage = knownTargets.get(pageUrl);
-    if (knownPage) {
-      if (parsed.hash && !knownPage.has(parsed.hash)) {
-        recordBrokenLink(crawledLink, 'target not found');
-      }
-      continue;
-    }
-
-    const page = results.get(pageUrl);
-
-    if (!page) {
-      recordBrokenLink(crawledLink, 'not crawled');
-      continue;
-    }
-    if (page.status >= 400) {
-      recordBrokenLink(crawledLink, `returned status ${page.status}`);
-      continue;
-    }
-    if (parsed.hash) {
-      if (!page.targets.has(parsed.hash)) {
-        recordBrokenLink(crawledLink, 'target not found');
+    if (pageUrl !== null) {
+      // Internal link
+      const parsed = new URL(crawledLink.href, 'http://localhost');
+
+      const knownPage = knownTargets.get(pageUrl);
+      if (knownPage) {
+        if (parsed.hash && !knownPage.has(parsed.hash)) {
+          recordBrokenLink(crawledLink, 'target not found');
+        } else {
+          // all good
+        }
+      } else {
+        const page = results.get(pageUrl);
+
+        if (!page) {
+          recordBrokenLink(crawledLink, 'not crawled');
+        } else if (page.status >= 400) {
+          recordBrokenLink(crawledLink, `returned status ${page.status}`);
+        } else if (parsed.hash) {
+          if (!page.targets.has(parsed.hash)) {
+            recordBrokenLink(crawledLink, 'target not found');
+          }
+        } else {
+          // all good
+        }
       }
     }
   }
@@ -577,11 +571,9 @@ export async function crawl(rawOptions) {
     maximumFractionDigits: 2,
   }).format(durationSeconds);
   console.log(chalk.blue(`\nCrawl completed in ${duration}`));
-  console.log(`  Total links found: ${chalk.cyan(totalLinks)}`);
-  console.log(`  Total links checked: ${chalk.cyan(checkedLinks)}`);
+  console.log(`  Total links found: ${chalk.cyan(crawledLinks.size)}`);
   console.log(`  Total broken links: ${chalk.cyan(brokenLinks)}`);
   console.log(`  Total broken link targets: ${chalk.cyan(brokenLinkTargets)}`);
 
-  const totalBrokenLinks = brokenLinks + brokenLinkTargets;
-  return { brokenLinks: totalBrokenLinks, issues };
+  return { links: crawledLinks, pages: results, issues };
 }

From d58c1ade3bbf40de3b93656d13497b52a06efbc9 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 13:41:09 +0200
Subject: [PATCH 05/17] Update index.mjs

---
 .../src/brokenLinksChecker/index.mjs          | 29 ++++++++-----------
 1 file changed, 12 insertions(+), 17 deletions(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 1ef7d2b1f..e43a3a155 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -321,6 +321,8 @@ async function resolveKnownTargets(options) {
 /**
  * @typedef {Object} Issue
  * @property {'broken-link' | 'broken-target'} type
+ * @property {string} message
+ * @property {Link} link
  * @property {string} sourceUrl
  * @property {string | null} sourceName
  * @property {string} targetUrl
@@ -402,7 +404,7 @@ export async function crawl(rawOptions) {
   /** @type {Set<Link>} */
   const crawledLinks = new Set();
 
-  const queue = new Queue(async (link) => {
+  const queue = new Queue(async (/** @type {Link} */ link) => {
     crawledLinks.add(link);
 
     const pageUrl = getPageUrl(link.href, options.ignoredPaths);
@@ -500,26 +502,19 @@ export async function crawl(rawOptions) {
    * @property {string} reason
    */
 
-  /** @type {Map<string, BrokenLinkError[]>} */
-  const brokenLinksByPage = new Map();
-
   /** @type {Issue[]} */
   const issues = [];
 
   /**
    * @param {Link} link
-   * @param {string} reason
+   * @param {'broken-target' | 'broken-link'} type
+   * @param {string} message
    */
-  function recordBrokenLink(link, reason) {
-    const src = link.src ?? '(unknown)';
-    const linksForPage = brokenLinksByPage.get(src) ?? [];
-    brokenLinksByPage.set(src, linksForPage);
-    linksForPage.push({ link, reason });
-
-    // Also record in issues array
-    const type = reason === 'target not found' ? 'broken-target' : 'broken-link';
+  function recordBrokenLink(link, type, message) {
     issues.push({
       type,
+      message,
+      link,
       sourceUrl: link.src ?? '(unknown)',
       sourceName: link.text,
       targetUrl: link.href,
@@ -535,7 +530,7 @@ export async function crawl(rawOptions) {
       const knownPage = knownTargets.get(pageUrl);
       if (knownPage) {
         if (parsed.hash && !knownPage.has(parsed.hash)) {
-          recordBrokenLink(crawledLink, 'target not found');
+          recordBrokenLink(crawledLink, 'broken-target', 'Target not found');
         } else {
           // all good
         }
@@ -543,12 +538,12 @@ export async function crawl(rawOptions) {
         const page = results.get(pageUrl);
 
         if (!page) {
-          recordBrokenLink(crawledLink, 'not crawled');
+          recordBrokenLink(crawledLink, 'broken-link', 'Page not crawled');
         } else if (page.status >= 400) {
-          recordBrokenLink(crawledLink, `returned status ${page.status}`);
+          recordBrokenLink(crawledLink, 'broken-link', `Page returned error ${page.status}`);
         } else if (parsed.hash) {
           if (!page.targets.has(parsed.hash)) {
-            recordBrokenLink(crawledLink, 'target not found');
+            recordBrokenLink(crawledLink, 'broken-target', 'Target not found');
           }
         } else {
           // all good

From 1692d01559e73c0c9495fe848a05b364ab1f7707 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 13:51:41 +0200
Subject: [PATCH 06/17] improve output

---
 .../src/brokenLinksChecker/index.mjs          |  13 +--
 .../src/brokenLinksChecker/index.test.ts      | 110 +++++++++++-------
 2 files changed, 70 insertions(+), 53 deletions(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index e43a3a155..50b082d0f 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -323,9 +323,6 @@ async function resolveKnownTargets(options) {
  * @property {'broken-link' | 'broken-target'} type
  * @property {string} message
  * @property {Link} link
- * @property {string} sourceUrl
- * @property {string | null} sourceName
- * @property {string} targetUrl
  */
 
 /**
@@ -350,9 +347,10 @@ function reportIssues(issuesList) {
   /** @type {Map<string, Issue[]>} */
   const issuesBySource = new Map();
   for (const issue of issuesList) {
-    const sourceIssues = issuesBySource.get(issue.sourceUrl) ?? [];
+    const sourceUrl = issue.link.src ?? '(unknown)';
+    const sourceIssues = issuesBySource.get(sourceUrl) ?? [];
     if (sourceIssues.length === 0) {
-      issuesBySource.set(issue.sourceUrl, sourceIssues);
+      issuesBySource.set(sourceUrl, sourceIssues);
     }
     sourceIssues.push(issue);
   }
@@ -362,7 +360,7 @@ function reportIssues(issuesList) {
     console.error(`Source ${chalk.cyan(sourceUrl)}:`);
     for (const issue of sourceIssues) {
       const reason = issue.type === 'broken-target' ? 'target not found' : 'returned status 404';
-      console.error(`  [${issue.sourceName}](${chalk.cyan(issue.targetUrl)}) (${reason})`);
+      console.error(`  [${issue.link.text}](${chalk.cyan(issue.link.href)}) (${reason})`);
     }
   }
 }
@@ -515,9 +513,6 @@ export async function crawl(rawOptions) {
       type,
       message,
       link,
-      sourceUrl: link.src ?? '(unknown)',
-      sourceName: link.text,
-      targetUrl: link.href,
     });
   }
 
diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index f240fcb58..d6615ccc9 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -1,23 +1,31 @@
 import path from 'node:path';
-
 import getPort from 'get-port';
 import { describe, expect, it } from 'vitest';
 
 // eslint-disable-next-line import/extensions
-import { crawl, Issue } from './index.mjs';
+import { crawl, Issue, Link } from './index.mjs';
+
+type ExpectedIssue = Partial<Issue> & { link?: Partial<Link> };
+
+function objectMatchingIssue(expectedIssue: ExpectedIssue) {
+  return expect.objectContaining({
+    ...expectedIssue,
+    ...(expectedIssue.link ? { link: expect.objectContaining(expectedIssue.link) } : {}),
+  });
+}
 
 /**
  * Helper to assert that an issue with matching properties exists in the issues array
  */
-function expectIssue(issues: Issue[], expectedIssue: Partial<Issue>) {
-  expect(issues).toEqual(expect.arrayContaining([expect.objectContaining(expectedIssue)]));
+function expectIssue(issues: Issue[], expectedIssue: ExpectedIssue) {
+  expect(issues).toEqual(expect.arrayContaining([objectMatchingIssue(expectedIssue)]));
 }
 
 /**
  * Helper to assert that no issue with matching properties exists in the issues array
  */
-function expectNotIssue(issues: Issue[], notExpectedIssue: Partial<Issue>) {
-  expect(issues).not.toEqual(expect.arrayContaining([expect.objectContaining(notExpectedIssue)]));
+function expectNotIssue(issues: Issue[], notExpectedIssue: ExpectedIssue) {
+  expect(issues).not.toEqual(expect.arrayContaining([objectMatchingIssue(notExpectedIssue)]));
 }
 
 describe('Broken Links Checker', () => {
@@ -44,89 +52,103 @@ describe('Broken Links Checker', () => {
     // Check broken-link type issues
     expectIssue(result.issues, {
       type: 'broken-link',
-      sourceUrl: '/broken-links.html',
-      targetUrl: '/does-not-exist.html',
-      sourceName: 'This page does not exist',
+      link: {
+        src: '/broken-links.html',
+        href: '/does-not-exist.html',
+        text: 'This page does not exist',
+      },
     });
 
     expectIssue(result.issues, {
       type: 'broken-link',
-      sourceUrl: '/broken-links.html',
-      targetUrl: '/another-missing-page.html',
-      sourceName: 'Another missing page',
+      link: {
+        src: '/broken-links.html',
+        href: '/another-missing-page.html',
+        text: 'Another missing page',
+      },
     });
 
     // Check broken-target type issues
     expectIssue(result.issues, {
       type: 'broken-target',
-      sourceUrl: '/broken-targets.html',
-      targetUrl: '/with-anchors.html#nonexistent',
-      sourceName: 'Non-existent anchor',
+      link: {
+        src: '/broken-targets.html',
+        href: '/with-anchors.html#nonexistent',
+        text: 'Non-existent anchor',
+      },
     });
 
     expectIssue(result.issues, {
       type: 'broken-target',
-      sourceUrl: '/broken-targets.html',
-      targetUrl: '/valid.html#missing-target',
-      sourceName: 'Valid page, missing target',
+      link: {
+        src: '/broken-targets.html',
+        href: '/valid.html#missing-target',
+        text: 'Valid page, missing target',
+      },
     });
 
     expectIssue(result.issues, {
       type: 'broken-target',
-      sourceUrl: '/broken-targets.html',
-      targetUrl: '/with-anchors.html#also-missing',
-      sourceName: 'Also missing',
+      link: {
+        src: '/broken-targets.html',
+        href: '/with-anchors.html#also-missing',
+        text: 'Also missing',
+      },
     });
 
     // Verify that valid links are not reported
-    expectNotIssue(result.issues, { targetUrl: '/' });
-    expectNotIssue(result.issues, { targetUrl: '/valid.html' });
-    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html' });
-    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html#section1' });
-    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html#section2' });
-    expectNotIssue(result.issues, { targetUrl: '/with-anchors.html#section3' });
-    expectNotIssue(result.issues, { targetUrl: '/nested/page.html' });
+    expectNotIssue(result.issues, { link: { href: '/' } });
+    expectNotIssue(result.issues, { link: { href: '/valid.html' } });
+    expectNotIssue(result.issues, { link: { href: '/with-anchors.html' } });
+    expectNotIssue(result.issues, { link: { href: '/with-anchors.html#section1' } });
+    expectNotIssue(result.issues, { link: { href: '/with-anchors.html#section2' } });
+    expectNotIssue(result.issues, { link: { href: '/with-anchors.html#section3' } });
+    expectNotIssue(result.issues, { link: { href: '/nested/page.html' } });
 
     // Verify that external links are not reported
-    expectNotIssue(result.issues, { targetUrl: 'https://example.com' });
-    expectNotIssue(result.issues, { targetUrl: 'https://github.com/mui' });
+    expectNotIssue(result.issues, { link: { href: 'https://example.com' } });
+    expectNotIssue(result.issues, { link: { href: 'https://github.com/mui' } });
 
     // Test ignoredPaths: ignored-page.html should not be crawled
-    expectNotIssue(result.issues, { sourceUrl: '/ignored-page.html' });
-    expectNotIssue(result.issues, { targetUrl: '/this-link-should-not-be-checked.html' });
+    expectNotIssue(result.issues, { link: { src: '/ignored-page.html' } });
+    expectNotIssue(result.issues, { link: { href: '/this-link-should-not-be-checked.html' } });
 
     // Test ignoredContent: links in .sidebar should be ignored
-    expectNotIssue(result.issues, { targetUrl: '/sidebar-broken-link.html' });
+    expectNotIssue(result.issues, { link: { href: '/sidebar-broken-link.html' } });
 
     // Test ignoredTargets: __should-be-ignored target should not cause issues
     expectNotIssue(result.issues, {
-      targetUrl: '/page-with-custom-targets.html#__should-be-ignored',
+      link: { href: '/page-with-custom-targets.html#__should-be-ignored' },
     });
 
     // Test that non-ignored custom target is valid
-    expectNotIssue(result.issues, { targetUrl: '/page-with-custom-targets.html#custom-id' });
+    expectNotIssue(result.issues, { link: { href: '/page-with-custom-targets.html#custom-id' } });
 
     // Test knownTargets: valid-target is known and should not cause issues
-    expectNotIssue(result.issues, { targetUrl: '/external-page.html#valid-target' });
+    expectNotIssue(result.issues, { link: { href: '/external-page.html#valid-target' } });
 
     // Test knownTargets: invalid-target is not in knownTargets and should cause an issue
     expectIssue(result.issues, {
       type: 'broken-target',
-      sourceUrl: '/page-with-known-target-links.html',
-      targetUrl: '/external-page.html#invalid-target',
-      sourceName: 'Invalid external target',
+      link: {
+        src: '/page-with-known-target-links.html',
+        href: '/external-page.html#invalid-target',
+        text: 'Invalid external target',
+      },
     });
 
     // Test knownTargetsDownloadUrl: method1 and method2 are in downloaded known targets
-    expectNotIssue(result.issues, { targetUrl: '/api-page.html#method1' });
-    expectNotIssue(result.issues, { targetUrl: '/api-page.html#method2' });
+    expectNotIssue(result.issues, { link: { href: '/api-page.html#method1' } });
+    expectNotIssue(result.issues, { link: { href: '/api-page.html#method2' } });
 
     // Test knownTargetsDownloadUrl: unknown-method is not in downloaded known targets and should cause an issue
     expectIssue(result.issues, {
       type: 'broken-target',
-      sourceUrl: '/page-with-api-links.html',
-      targetUrl: '/api-page.html#unknown-method',
-      sourceName: 'Unknown API method',
+      link: {
+        src: '/page-with-api-links.html',
+        href: '/api-page.html#unknown-method',
+        text: 'Unknown API method',
+      },
     });
   }, 30000);
 });

From 052af33f39fdb160ab19b078b4078032b2e4274b Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 13:53:42 +0200
Subject: [PATCH 07/17] Update index.test.ts

---
 packages/code-infra/src/brokenLinksChecker/index.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index d6615ccc9..9b30f0efc 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -5,7 +5,7 @@ import { describe, expect, it } from 'vitest';
 // eslint-disable-next-line import/extensions
 import { crawl, Issue, Link } from './index.mjs';
 
-type ExpectedIssue = Partial<Issue> & { link?: Partial<Link> };
+type ExpectedIssue = Omit<Partial<Issue>, 'link'> & { link?: Partial<Link> };
 
 function objectMatchingIssue(expectedIssue: ExpectedIssue) {
   return expect.objectContaining({

From 6f3c3bdae261915bde05222721c92933f51f67a0 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Thu, 23 Oct 2025 13:58:11 +0200
Subject: [PATCH 08/17] Update index.test.ts

---
 packages/code-infra/src/brokenLinksChecker/index.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index 9b30f0efc..995d26580 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -46,7 +46,7 @@ describe('Broken Links Checker', () => {
       knownTargetsDownloadUrl: [`${host}/known-targets.json`],
     });
 
-    // Total: 2 broken-link + 5 broken-target = 7 issues
+    expect(result.links).toHaveLength(49);
     expect(result.issues).toHaveLength(7);
 
     // Check broken-link type issues

From e81c9fed9894a168c986ae2333a7ac492d3e0c90 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Tue, 28 Oct 2025 12:59:40 +0100
Subject: [PATCH 09/17] Update index.mjs

---
 packages/code-infra/src/brokenLinksChecker/index.mjs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 50b082d0f..139f61a90 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -2,7 +2,8 @@
 import { execaCommand } from 'execa';
 import timers from 'node:timers/promises';
 import { parse } from 'node-html-parser';
-import fs from 'node:fs/promises';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
 import chalk from 'chalk';
 import { Transform } from 'node:stream';
 
@@ -108,6 +109,8 @@ async function writePagesToFile(pages, outPath) {
   for (const [url, pageData] of pages.entries()) {
     fileContent.targets[url] = Array.from(pageData.targets.keys());
   }
+  const dir = path.dirname(outPath);
+  await fs.mkdir(dir, { recursive: true });
   await fs.writeFile(outPath, JSON.stringify(fileContent, null, 2), 'utf-8');
 }
 

From a31718c91acb868984621e3ec061622edd1749fc Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Tue, 28 Oct 2025 13:42:21 +0100
Subject: [PATCH 10/17] Update index.mjs

---
 packages/code-infra/src/brokenLinksChecker/index.mjs | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 139f61a90..55763fb4e 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -567,6 +567,9 @@ export async function crawl(rawOptions) {
   console.log(`  Total links found: ${chalk.cyan(crawledLinks.size)}`);
   console.log(`  Total broken links: ${chalk.cyan(brokenLinks)}`);
   console.log(`  Total broken link targets: ${chalk.cyan(brokenLinkTargets)}`);
+  if (options.outPath) {
+    console.log(chalk.blue(`Output written to: ${options.outPath}`));
+  }
 
   return { links: crawledLinks, pages: results, issues };
 }

From bdf7a3388cd3751d4c39cb4112dc611d4a73924f Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Tue, 28 Oct 2025 15:01:42 +0100
Subject: [PATCH 11/17] Add seedUrls

---
 .../static-site/orphaned-page.html             | 18 ++++++++++++++++++
 .../src/brokenLinksChecker/index.mjs           |  6 +++++-
 .../src/brokenLinksChecker/index.test.ts       | 18 ++++++++++++++++--
 3 files changed, 39 insertions(+), 3 deletions(-)
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html

diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
new file mode 100644
index 000000000..4d9330635
--- /dev/null
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
@@ -0,0 +1,18 @@
+<!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="/orphaned-broken-link.html">Broken link from orphaned page</a></li>
+      </ul>
+    </nav>
+  </body>
+</html>
diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 55763fb4e..93a2251ad 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -248,6 +248,7 @@ function getPageUrl(href, ignoredPaths = []) {
  * @property {Map<string, Set<string>>} [knownTargets]
  * @property {string[]} [knownTargetsDownloadUrl]
  * @property {number} [concurrency]
+ * @property {string[]} [seedUrls]
  */
 
 /**
@@ -269,6 +270,7 @@ function resolveOptions(rawOptions) {
     knownTargets: rawOptions.knownTargets ?? new Map(),
     knownTargetsDownloadUrl: rawOptions.knownTargetsDownloadUrl ?? [],
     concurrency: rawOptions.concurrency ?? DEFAULT_CONCURRENCY,
+    seedUrls: rawOptions.seedUrls ?? ['/'],
   };
 }
 
@@ -479,7 +481,9 @@ export async function crawl(rawOptions) {
     await pagePromise;
   }, options.concurrency);
 
-  queue.add({ src: null, text: null, href: '/' });
+  for (const seedUrl of options.seedUrls) {
+    queue.add({ src: null, text: null, href: seedUrl });
+  }
 
   await queue.waitAll();
 
diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index 995d26580..f0ae68354 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -44,10 +44,11 @@ describe('Broken Links Checker', () => {
       ignoredTargets: new Set(['__should-be-ignored']),
       knownTargets: new Map([['/external-page.html', new Set(['#valid-target'])]]),
       knownTargetsDownloadUrl: [`${host}/known-targets.json`],
+      seedUrls: ['/', '/orphaned-page.html'],
     });
 
-    expect(result.links).toHaveLength(49);
-    expect(result.issues).toHaveLength(7);
+    expect(result.links).toHaveLength(52);
+    expect(result.issues).toHaveLength(8);
 
     // Check broken-link type issues
     expectIssue(result.issues, {
@@ -150,5 +151,18 @@ describe('Broken Links Checker', () => {
         text: 'Unknown API method',
       },
     });
+
+    // Test seedUrls: orphaned-page.html should be crawled even though it's not linked from anywhere
+    expect(result.pages.has('/orphaned-page.html')).toBe(true);
+
+    // Test seedUrls: broken link from orphaned page should be detected
+    expectIssue(result.issues, {
+      type: 'broken-link',
+      link: {
+        src: '/orphaned-page.html',
+        href: '/orphaned-broken-link.html',
+        text: 'Broken link from orphaned page',
+      },
+    });
   }, 30000);
 });

From 23a7897e2573a5678841939631f638bcf02d76b5 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Tue, 28 Oct 2025 16:08:05 +0100
Subject: [PATCH 12/17] normalize

---
 .../__fixtures__/static-site/orphaned-page.html            | 1 +
 packages/code-infra/src/brokenLinksChecker/index.mjs       | 7 ++++++-
 packages/code-infra/src/brokenLinksChecker/index.test.ts   | 6 +++++-
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
index 4d9330635..e066c6943 100644
--- a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
@@ -11,6 +11,7 @@ <h1>Orphaned Page</h1>
     <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>
       </ul>
     </nav>
diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 93a2251ad..2e02b131e 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -233,7 +233,12 @@ function getPageUrl(href, ignoredPaths = []) {
   if (ignoredPaths.some((pattern) => pattern.test(parsed.pathname))) {
     return null;
   }
-  const link = parsed.pathname + parsed.search;
+  // Normalize pathname by removing trailing slash (except for root)
+  let pathname = parsed.pathname;
+  if (pathname !== '/' && pathname.endsWith('/')) {
+    pathname = pathname.slice(0, -1);
+  }
+  const link = pathname + parsed.search;
   return link;
 }
 
diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index f0ae68354..b18e7cb76 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -47,7 +47,7 @@ describe('Broken Links Checker', () => {
       seedUrls: ['/', '/orphaned-page.html'],
     });
 
-    expect(result.links).toHaveLength(52);
+    expect(result.links).toHaveLength(53);
     expect(result.issues).toHaveLength(8);
 
     // Check broken-link type issues
@@ -164,5 +164,9 @@ describe('Broken Links Checker', () => {
         text: 'Broken link from orphaned page',
       },
     });
+
+    // Test trailing slash normalization: /valid.html and /valid.html/ should be treated as the same page
+    // The orphaned page has both links, but they should not cause duplicate page crawls
+    expectNotIssue(result.issues, { link: { href: '/valid.html/' } });
   }, 30000);
 });

From 844c1134967283ec695cf1748119c9ca9fd8724c Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Tue, 28 Oct 2025 17:20:56 +0100
Subject: [PATCH 13/17] Ignore md pages for now

---
 .../__fixtures__/static-site/example.md           |  9 +++++++++
 .../__fixtures__/static-site/orphaned-page.html   |  1 +
 .../code-infra/src/brokenLinksChecker/index.mjs   | 15 +++++++++++++++
 .../src/brokenLinksChecker/index.test.ts          |  8 +++++++-
 4 files changed, 32 insertions(+), 1 deletion(-)
 create mode 100644 packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/example.md

diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/example.md b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/example.md
new file mode 100644
index 000000000..f36aa4a57
--- /dev/null
+++ b/packages/code-infra/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.
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
index e066c6943..acb3df281 100644
--- a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/orphaned-page.html
@@ -13,6 +13,7 @@ <h1>Orphaned Page</h1>
         <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>
diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 2e02b131e..7b0412186 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -445,6 +445,21 @@ export async function crawl(rawOptions) {
         };
       }
 
+      // Check if the response is HTML
+      const contentType = res.headers.get('content-type') || '';
+      if (!contentType.includes('text/html')) {
+        console.warn(
+          chalk.yellow(`Warning: ${pageUrl} returned non-HTML content-type: ${contentType}`),
+        );
+
+        return {
+          url: pageUrl,
+          status: res.status,
+          targets: new Map(),
+          links: [],
+        };
+      }
+
       const html = await res.text();
 
       const dom = parse(html);
diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index b18e7cb76..152152566 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -47,7 +47,7 @@ describe('Broken Links Checker', () => {
       seedUrls: ['/', '/orphaned-page.html'],
     });
 
-    expect(result.links).toHaveLength(53);
+    expect(result.links).toHaveLength(54);
     expect(result.issues).toHaveLength(8);
 
     // Check broken-link type issues
@@ -168,5 +168,11 @@ describe('Broken Links Checker', () => {
     // Test trailing slash normalization: /valid.html and /valid.html/ should be treated as the same page
     // The orphaned page has both links, but they should not cause duplicate page crawls
     expectNotIssue(result.issues, { link: { href: '/valid.html/' } });
+
+    // Test content-type checking: links inside markdown files should not be crawled
+    // The example.md file contains a link to /this-should-not-be-checked.html in an HTML snippet
+    expectNotIssue(result.issues, { link: { href: '/this-should-not-be-checked.html' } });
+    // The markdown file itself should not cause issues (it's a valid file, just not HTML)
+    expectNotIssue(result.issues, { link: { href: '/example.md' } });
   }, 30000);
 });

From 1683374adee5bf1c98db9cd83301901d3ecdb266 Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Wed, 29 Oct 2025 10:53:44 +0100
Subject: [PATCH 14/17] Few more tweaks

---
 packages/code-infra/package.json              |   6 +-
 .../page-with-ignored-content.html            |   3 +
 .../src/brokenLinksChecker/index.mjs          |  70 ++++--
 .../src/brokenLinksChecker/index.test.ts      |   2 +-
 pnpm-lock.yaml                                | 233 ++++--------------
 5 files changed, 103 insertions(+), 211 deletions(-)

diff --git a/packages/code-infra/package.json b/packages/code-infra/package.json
index 130f1b94b..5ef306771 100644
--- a/packages/code-infra/package.json
+++ b/packages/code-infra/package.json
@@ -83,6 +83,7 @@
     "babel-plugin-transform-remove-imports": "^1.8.1",
     "chalk": "^5.6.2",
     "clipboardy": "^5.0.0",
+    "content-type": "^1.0.5",
     "env-ci": "^11.2.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
@@ -111,15 +112,16 @@
     "yargs": "^18.0.0"
   },
   "peerDependencies": {
+    "@next/eslint-plugin-next": "*",
     "eslint": "^9.0.0",
     "prettier": "^3.5.3",
-    "typescript": "^5.0.0",
-    "@next/eslint-plugin-next": "*"
+    "typescript": "^5.0.0"
   },
   "devDependencies": {
     "@octokit/types": "^15.0.1",
     "@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",
diff --git a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html
index b2b311426..2b6203ab0 100644
--- a/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html
+++ b/packages/code-infra/src/brokenLinksChecker/__fixtures__/static-site/page-with-ignored-content.html
@@ -20,6 +20,9 @@ <h2>Sidebar (should be ignored)</h2>
     </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>
diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 7b0412186..6d55e17d9 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -6,6 +6,7 @@ import * as fs from 'node:fs/promises';
 import * as path from 'node:path';
 import chalk from 'chalk';
 import { Transform } from 'node:stream';
+import contentType from 'content-type';
 
 const DEFAULT_CONCURRENCY = 4;
 
@@ -383,6 +384,7 @@ export async function crawl(rawOptions) {
   const options = resolveOptions(rawOptions);
   const startTime = Date.now();
 
+  /** @type {import('execa').ResultPromise | undefined} */
   let appProcess;
   if (options.startCommand) {
     console.log(chalk.blue(`Starting server with "${options.startCommand}"...`));
@@ -441,59 +443,76 @@ export async function crawl(rawOptions) {
           url: pageUrl,
           status: res.status,
           targets: new Map(),
-          links: [],
         };
       }
 
       // Check if the response is HTML
-      const contentType = res.headers.get('content-type') || '';
-      if (!contentType.includes('text/html')) {
-        console.warn(
-          chalk.yellow(`Warning: ${pageUrl} returned non-HTML content-type: ${contentType}`),
-        );
+      const contentTypeHeader = res.headers.get('content-type');
+      let type = 'text/html';
+
+      if (contentTypeHeader) {
+        try {
+          const parsed = contentType.parse(contentTypeHeader);
+          type = parsed.type;
+        } catch {
+          console.warn(
+            chalk.yellow(`Warning: ${pageUrl} returned invalid content-type: ${contentTypeHeader}`),
+          );
+        }
+      }
 
+      if (type.startsWith('image/')) {
+        // Skip images
         return {
           url: pageUrl,
           status: res.status,
           targets: new Map(),
-          links: [],
         };
       }
 
-      const html = await res.text();
+      if (type !== 'text/html') {
+        console.warn(chalk.yellow(`Warning: ${pageUrl} returned non-HTML content-type: ${type}`));
 
-      const dom = parse(html);
+        // TODO: Handle text/markdown. Parse content as markdown and extract links/targets.
 
-      for (const selector of options.ignoredContent) {
-        dom.querySelectorAll(selector).forEach((elm) => {
-          elm.remove();
-        });
+        return {
+          url: pageUrl,
+          status: res.status,
+          targets: new Map(),
+        };
       }
 
-      const pageLinks = dom.querySelectorAll('a[href]').map((a) => ({
+      const content = await res.text();
+
+      const dom = parse(content);
+
+      const ignoredSelector = Array.from(options.ignoredContent)
+        .flatMap((selector) => [selector, `${selector} *`])
+        .join(',');
+      const linksSelector = `a[href]:not(${ignoredSelector})`;
+
+      const pageLinks = dom.querySelectorAll(linksSelector).map((a) => ({
         src: pageUrl,
         text: getAccessibleName(a, dom),
-        href: a.attributes.href,
+        href: a.getAttribute('href') ?? '',
       }));
 
       const pageTargets = new Map(
         dom
           .querySelectorAll('*[id]')
-          .filter((elm) => !options.ignoredTargets.has(elm.attributes.id))
-          .map((elm) => [`#${elm.attributes.id}`, {}]),
+          .filter((elm) => !options.ignoredTargets.has(elm.id))
+          .map((elm) => [`#${elm.id}`, {}]),
       );
 
-      const pageData = {
-        url: pageUrl,
-        status: res.status,
-        targets: pageTargets,
-      };
-
       for (const pageLink of pageLinks) {
         queue.add(pageLink);
       }
 
-      return pageData;
+      return {
+        url: pageUrl,
+        status: res.status,
+        targets: pageTargets,
+      };
     });
 
     crawledPages.set(pageUrl, pagePromise);
@@ -508,7 +527,8 @@ export async function crawl(rawOptions) {
   await queue.waitAll();
 
   if (appProcess) {
-    await appProcess.kill();
+    appProcess.kill();
+    await appProcess.catch(() => {});
   }
 
   const results = new Map(
diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index 152152566..e104908f5 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -37,7 +37,7 @@ describe('Broken Links Checker', () => {
     const host = `http://localhost:${port}`;
 
     const result = await crawl({
-      startCommand: `${servePath} ${fixtureDir} -p ${port}`,
+      startCommand: `pnpm exec serve ${fixtureDir} -p ${port}`,
       host,
       ignoredPaths: [/ignored-page\.html$/],
       ignoredContent: ['.sidebar'],
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 5d7e599b0..608b500b7 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -443,6 +443,9 @@ importers:
       clipboardy:
         specifier: ^5.0.0
         version: 5.0.0
+      content-type:
+        specifier: ^1.0.5
+        version: 1.0.5
       env-ci:
         specifier: ^11.2.0
         version: 11.2.0
@@ -534,6 +537,9 @@ importers:
       '@types/babel__preset-env':
         specifier: ^7.10.0
         version: 7.10.0
+      '@types/content-type':
+        specifier: ^1.1.9
+        version: 1.1.9
       '@types/env-ci':
         specifier: ^3.1.4
         version: 3.1.4
@@ -829,6 +835,7 @@ packages:
   '@aws-sdk/credential-provider-web-identity@3.917.0':
     resolution: {integrity: sha512-pZncQhFbwW04pB0jcD5OFv3x2gAddDYCVxyJVixgyhSw7bKCYxqu6ramfq1NxyVpmm+qsw+ijwi/3cCmhUHF/A==}
     engines: {node: '>=18.0.0'}
+    deprecated: This version contains a compilation TypeScript error https://github.com/aws/aws-sdk-js-v3/issues/7457 - please use @aws-sdk/credential-providers@3.918.0 or higher
 
   '@aws-sdk/credential-providers@3.916.0':
     resolution: {integrity: sha512-wazu2awF69ohF3AaDlYkD+tanaqwJ309o9GawNg3o1oW7orhdcvh6P8BftSjuIzuAMiauvQquxcUrNTLxHtvOA==}
@@ -5458,6 +5465,9 @@ packages:
   '@types/connect@3.4.38':
     resolution: {integrity: sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==}
 
+  '@types/content-type@1.1.9':
+    resolution: {integrity: sha512-Hq9IMnfekuOCsEmYl4QX2HBrT+XsfXiupfrLLY8Dcf3Puf4BkBOxSbWYTITSOQAhJoYPBez+b4MJRpIYL65z8A==}
+
   '@types/cookie@0.6.0':
     resolution: {integrity: sha512-4Kh9a6B2bQciAhf7FSuMRRkUWecJgJu9nPnx3yzpsfXX/c50REIqpHY4C82bXP90qrLtXtkDxTZosYO3UpOwlA==}
 
@@ -13154,7 +13164,7 @@ snapshots:
 
   '@argos-ci/api-client@0.12.0':
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       openapi-fetch: 0.14.1
     transitivePeerDependencies:
       - supports-color
@@ -13164,7 +13174,7 @@ snapshots:
       '@argos-ci/api-client': 0.12.0
       '@argos-ci/util': 3.1.1
       convict: 6.2.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       fast-glob: 3.3.3
       sharp: 0.34.4
       tmp: 0.2.5
@@ -13825,7 +13835,7 @@ snapshots:
       '@babel/types': 7.28.4
       '@jridgewell/remapping': 2.3.5
       convert-source-map: 2.0.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       gensync: 1.0.0-beta.2
       json5: 2.2.3
       semver: 6.3.1
@@ -13877,7 +13887,7 @@ snapshots:
       '@babel/core': 7.28.4
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       lodash.debounce: 4.0.8
       resolve: 1.22.11
     transitivePeerDependencies:
@@ -14559,7 +14569,7 @@ snapshots:
       '@babel/parser': 7.28.4
       '@babel/template': 7.27.2
       '@babel/types': 7.28.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -15145,7 +15155,7 @@ snapshots:
   '@eslint/config-array@0.21.1':
     dependencies:
       '@eslint/object-schema': 2.1.7
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       minimatch: 3.1.2
     transitivePeerDependencies:
       - supports-color
@@ -15167,7 +15177,7 @@ snapshots:
   '@eslint/eslintrc@3.3.1':
     dependencies:
       ajv: 6.12.6
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       espree: 10.4.0
       globals: 14.0.0
       ignore: 5.3.2
@@ -15721,19 +15731,6 @@ snapshots:
 
   '@lukeed/ms@2.0.2': {}
 
-  '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)':
-    dependencies:
-      consola: 3.4.2
-      detect-libc: 2.1.1
-      https-proxy-agent: 7.0.6
-      node-fetch: 2.7.0(encoding@0.1.13)
-      nopt: 8.1.0
-      semver: 7.7.3
-      tar: 7.4.3
-    transitivePeerDependencies:
-      - encoding
-      - supports-color
-
   '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)(supports-color@10.2.0)':
     dependencies:
       consola: 3.4.2
@@ -16797,45 +16794,6 @@ snapshots:
 
   '@netlify/types@2.1.0': {}
 
-  '@netlify/zip-it-and-ship-it@14.1.11(encoding@0.1.13)(rollup@4.52.5)':
-    dependencies:
-      '@babel/parser': 7.28.4
-      '@babel/types': 7.28.4
-      '@netlify/binary-info': 1.0.0
-      '@netlify/serverless-functions-api': 2.7.1
-      '@vercel/nft': 0.29.4(encoding@0.1.13)(rollup@4.52.5)
-      archiver: 7.0.1
-      common-path-prefix: 3.0.0
-      copy-file: 11.1.0
-      es-module-lexer: 1.7.0
-      esbuild: 0.25.10
-      execa: 8.0.1
-      fast-glob: 3.3.3
-      filter-obj: 6.1.0
-      find-up: 7.0.0
-      is-path-inside: 4.0.0
-      junk: 4.0.1
-      locate-path: 7.2.0
-      merge-options: 3.0.4
-      minimatch: 9.0.5
-      normalize-path: 3.0.0
-      p-map: 7.0.3
-      path-exists: 5.0.0
-      precinct: 12.2.0
-      require-package-name: 2.0.1
-      resolve: 2.0.0-next.5
-      semver: 7.7.3
-      tmp-promise: 3.0.3
-      toml: 3.0.0
-      unixify: 1.0.0
-      urlpattern-polyfill: 8.0.2
-      yargs: 17.7.2
-      zod: 3.25.76
-    transitivePeerDependencies:
-      - encoding
-      - rollup
-      - supports-color
-
   '@netlify/zip-it-and-ship-it@14.1.11(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@babel/parser': 7.28.4
@@ -16924,7 +16882,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       lru-cache: 10.4.3
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -16934,7 +16892,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       lru-cache: 11.2.2
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -17376,7 +17334,7 @@ snapshots:
 
   '@pnpm/tabtab@0.5.4':
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       enquirer: 2.4.1
       minimist: 1.2.8
       untildify: 4.0.0
@@ -19046,6 +19004,8 @@ snapshots:
     dependencies:
       '@types/node': 22.18.12
 
+  '@types/content-type@1.1.9': {}
+
   '@types/cookie@0.6.0': {}
 
   '@types/cors@2.8.17':
@@ -19355,9 +19315,9 @@ snapshots:
     dependencies:
       '@typescript-eslint/scope-manager': 8.46.2
       '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/visitor-keys': 8.46.2
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19372,19 +19332,10 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/project-service@8.46.2(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/tsconfig-utils': 8.46.2(typescript@5.9.3)
-      '@typescript-eslint/types': 8.46.2
-      debug: 4.4.3(supports-color@8.1.1)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   '@typescript-eslint/rule-tester@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/parser': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/utils': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       ajv: 6.12.6
       eslint: 9.38.0(jiti@2.5.1)
@@ -19407,9 +19358,9 @@ snapshots:
   '@typescript-eslint/type-utils@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/utils': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       eslint: 9.38.0(jiti@2.5.1)
       ts-api-utils: 2.1.0(typescript@5.9.3)
       typescript: 5.9.3
@@ -19434,28 +19385,12 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@typescript-eslint/typescript-estree@8.46.2(typescript@5.9.3)':
-    dependencies:
-      '@typescript-eslint/project-service': 8.46.2(typescript@5.9.3)
-      '@typescript-eslint/tsconfig-utils': 8.46.2(typescript@5.9.3)
-      '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/visitor-keys': 8.46.2
-      debug: 4.4.3(supports-color@8.1.1)
-      fast-glob: 3.3.3
-      is-glob: 4.0.3
-      minimatch: 9.0.5
-      semver: 7.7.3
-      ts-api-utils: 2.1.0(typescript@5.9.3)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   '@typescript-eslint/utils@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@eslint-community/eslint-utils': 4.9.0(eslint@9.38.0(jiti@2.5.1))
       '@typescript-eslint/scope-manager': 8.46.2
       '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19527,25 +19462,6 @@ snapshots:
   '@unrs/resolver-binding-win32-x64-msvc@1.11.1':
     optional: true
 
-  '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)':
-    dependencies:
-      '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)
-      '@rollup/pluginutils': 5.2.0(rollup@4.52.5)
-      acorn: 8.15.0
-      acorn-import-attributes: 1.9.5(acorn@8.15.0)
-      async-sema: 3.1.1
-      bindings: 1.5.0
-      estree-walker: 2.0.2
-      glob: 10.4.5
-      graceful-fs: 4.2.11
-      node-gyp-build: 4.8.4
-      picomatch: 4.0.3
-      resolve-from: 5.0.0
-    transitivePeerDependencies:
-      - encoding
-      - rollup
-      - supports-color
-
   '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)(supports-color@10.2.0)
@@ -19593,7 +19509,7 @@ snapshots:
       '@bcoe/v8-coverage': 1.0.2
       '@vitest/utils': 4.0.3
       ast-v8-to-istanbul: 0.3.5
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       istanbul-lib-coverage: 3.2.2
       istanbul-lib-report: 3.0.1
       istanbul-lib-source-maps: 5.0.6
@@ -21315,15 +21231,6 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  detective-typescript@14.0.0(typescript@5.9.3):
-    dependencies:
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
-      ast-module-types: 6.0.1
-      node-source-walk: 7.0.1
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   detective-vue2@2.2.0(supports-color@10.2.0)(typescript@5.9.3):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -21337,19 +21244,6 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  detective-vue2@2.2.0(typescript@5.9.3):
-    dependencies:
-      '@dependents/detective-less': 5.0.1
-      '@vue/compiler-sfc': 3.5.21
-      detective-es6: 5.0.1
-      detective-sass: 6.0.1
-      detective-scss: 5.0.1
-      detective-stylus: 5.0.1
-      detective-typescript: 14.0.0(typescript@5.9.3)
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   dettle@1.0.5: {}
 
   devlop@1.1.0:
@@ -21786,7 +21680,7 @@ snapshots:
 
   eslint-import-resolver-typescript@4.4.4(eslint-plugin-import@2.32.0)(eslint@9.38.0(jiti@2.5.1)):
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       eslint: 9.38.0(jiti@2.5.1)
       eslint-import-context: 0.1.9(unrs-resolver@1.11.1)
       get-tsconfig: 4.10.1
@@ -21982,7 +21876,7 @@ snapshots:
       ajv: 6.12.6
       chalk: 4.1.2
       cross-spawn: 7.0.6
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       escape-string-regexp: 4.0.0
       eslint-scope: 8.4.0
       eslint-visitor-keys: 4.2.1
@@ -22181,7 +22075,7 @@ snapshots:
 
   extract-zip@2.0.1:
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       get-stream: 5.2.0
       yauzl: 2.10.0
     optionalDependencies:
@@ -22421,7 +22315,7 @@ snapshots:
 
   follow-redirects@1.15.11(debug@4.4.3):
     optionalDependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
 
   for-each@0.3.5:
     dependencies:
@@ -22538,7 +22432,7 @@ snapshots:
   gaxios@6.7.1(encoding@0.1.13):
     dependencies:
       extend: 3.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       is-stream: 2.0.1
       node-fetch: 2.7.0(encoding@0.1.13)
       uuid: 9.0.1
@@ -23057,7 +22951,7 @@ snapshots:
   http-proxy-agent@7.0.2:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
     transitivePeerDependencies:
       - supports-color
 
@@ -23084,7 +22978,7 @@ snapshots:
   http-proxy-middleware@3.0.3:
     dependencies:
       '@types/http-proxy': 1.17.16
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       http-proxy: 1.18.1(debug@4.4.3)
       is-glob: 4.0.3
       is-plain-object: 5.0.0
@@ -23107,13 +23001,6 @@ snapshots:
       quick-lru: 5.1.1
       resolve-alpn: 1.2.1
 
-  https-proxy-agent@7.0.6:
-    dependencies:
-      agent-base: 7.1.4
-      debug: 4.4.3(supports-color@8.1.1)
-    transitivePeerDependencies:
-      - supports-color
-
   https-proxy-agent@7.0.6(supports-color@10.2.0):
     dependencies:
       agent-base: 7.1.4
@@ -23568,7 +23455,7 @@ snapshots:
   istanbul-lib-source-maps@5.0.6:
     dependencies:
       '@jridgewell/trace-mapping': 0.3.30
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       istanbul-lib-coverage: 3.2.2
     transitivePeerDependencies:
       - supports-color
@@ -23651,7 +23538,7 @@ snapshots:
       decimal.js: 10.6.0
       html-encoding-sniffer: 4.0.0
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       is-potential-custom-element-name: 1.0.1
       parse5: 8.0.0
       rrweb-cssom: 0.8.0
@@ -24471,7 +24358,7 @@ snapshots:
   micromark@4.0.2:
     dependencies:
       '@types/debug': 4.1.12
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       decode-named-character-reference: 1.2.0
       devlop: 1.1.0
       micromark-core-commonmark: 2.0.3
@@ -24746,7 +24633,7 @@ snapshots:
       '@netlify/headers-parser': 9.0.2
       '@netlify/local-functions-proxy': 2.0.3
       '@netlify/redirect-parser': 15.0.3
-      '@netlify/zip-it-and-ship-it': 14.1.11(encoding@0.1.13)(rollup@4.52.5)
+      '@netlify/zip-it-and-ship-it': 14.1.11(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)
       '@octokit/rest': 22.0.0
       '@opentelemetry/api': 1.8.0
       '@pnpm/tabtab': 0.5.4
@@ -24764,7 +24651,7 @@ snapshots:
       content-type: 1.0.5
       cookie: 1.0.2
       cron-parser: 4.9.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       decache: 4.6.2
       dot-prop: 9.0.0
       dotenv: 17.2.3
@@ -24786,7 +24673,7 @@ snapshots:
       gitconfiglocal: 2.1.0
       http-proxy: 1.18.1(debug@4.4.3)
       http-proxy-middleware: 2.0.9(debug@4.4.3)
-      https-proxy-agent: 7.0.6
+      https-proxy-agent: 7.0.6(supports-color@10.2.0)
       inquirer: 8.2.7(@types/node@22.18.12)
       inquirer-autocomplete-prompt: 1.4.0(inquirer@8.2.7(@types/node@22.18.12))
       ipx: 3.1.1(@netlify/blobs@10.1.0)
@@ -25703,26 +25590,6 @@ snapshots:
 
   preact@10.24.3: {}
 
-  precinct@12.2.0:
-    dependencies:
-      '@dependents/detective-less': 5.0.1
-      commander: 12.1.0
-      detective-amd: 6.0.1
-      detective-cjs: 6.0.1
-      detective-es6: 5.0.1
-      detective-postcss: 7.0.1(postcss@8.5.6)
-      detective-sass: 6.0.1
-      detective-scss: 5.0.1
-      detective-stylus: 5.0.1
-      detective-typescript: 14.0.0(typescript@5.9.3)
-      detective-vue2: 2.2.0(typescript@5.9.3)
-      module-definition: 6.0.1
-      node-source-walk: 7.0.1
-      postcss: 8.5.6
-      typescript: 5.9.3
-    transitivePeerDependencies:
-      - supports-color
-
   precinct@12.2.0(supports-color@10.2.0):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -26746,7 +26613,7 @@ snapshots:
   socks-proxy-agent@8.0.5:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       socks: 2.8.7
     transitivePeerDependencies:
       - supports-color
@@ -27064,7 +26931,7 @@ snapshots:
       cosmiconfig: 9.0.0(typescript@5.9.3)
       css-functions-list: 3.2.3
       css-tree: 3.1.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       fast-glob: 3.3.3
       fastest-levenshtein: 1.0.16
       file-entry-cache: 10.1.4
@@ -27371,7 +27238,7 @@ snapshots:
   tuf-js@3.1.0:
     dependencies:
       '@tufjs/models': 3.0.1
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       make-fetch-happen: 14.0.3
     transitivePeerDependencies:
       - supports-color
@@ -27379,7 +27246,7 @@ snapshots:
   tuf-js@4.0.0:
     dependencies:
       '@tufjs/models': 4.0.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       make-fetch-happen: 15.0.2
     transitivePeerDependencies:
       - supports-color
@@ -27452,7 +27319,7 @@ snapshots:
     dependencies:
       '@typescript-eslint/eslint-plugin': 8.46.2(@typescript-eslint/parser@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3))(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       '@typescript-eslint/parser': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
       '@typescript-eslint/utils': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
@@ -27741,7 +27608,7 @@ snapshots:
 
   vite-tsconfig-paths@5.1.4(typescript@5.9.3)(vite@7.1.12(@types/node@22.18.12)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
     dependencies:
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       globrex: 0.1.2
       tsconfck: 3.1.6(typescript@5.9.3)
     optionalDependencies:
@@ -27801,7 +27668,7 @@ snapshots:
       '@vitest/snapshot': 4.0.3
       '@vitest/spy': 4.0.3
       '@vitest/utils': 4.0.3
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
       es-module-lexer: 1.7.0
       expect-type: 1.2.2
       magic-string: 0.30.21
@@ -27846,7 +27713,7 @@ snapshots:
     dependencies:
       chalk: 4.1.2
       commander: 9.5.0
-      debug: 4.4.3(supports-color@8.1.1)
+      debug: 4.4.3(supports-color@10.2.0)
     transitivePeerDependencies:
       - supports-color
 

From ea6cf1509d1d00559b1b984dd10be6575d51ca0b Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Wed, 29 Oct 2025 10:54:59 +0100
Subject: [PATCH 15/17] Update pnpm-lock.yaml

---
 pnpm-lock.yaml | 221 ++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 183 insertions(+), 38 deletions(-)

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index ebfb4af65..f05a5739d 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -13164,7 +13164,7 @@ snapshots:
 
   '@argos-ci/api-client@0.12.0':
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       openapi-fetch: 0.14.1
     transitivePeerDependencies:
       - supports-color
@@ -13174,7 +13174,7 @@ snapshots:
       '@argos-ci/api-client': 0.12.0
       '@argos-ci/util': 3.1.1
       convict: 6.2.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       fast-glob: 3.3.3
       sharp: 0.34.4
       tmp: 0.2.5
@@ -13835,7 +13835,7 @@ snapshots:
       '@babel/types': 7.28.4
       '@jridgewell/remapping': 2.3.5
       convert-source-map: 2.0.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       gensync: 1.0.0-beta.2
       json5: 2.2.3
       semver: 6.3.1
@@ -13887,7 +13887,7 @@ snapshots:
       '@babel/core': 7.28.4
       '@babel/helper-compilation-targets': 7.27.2
       '@babel/helper-plugin-utils': 7.27.1
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       lodash.debounce: 4.0.8
       resolve: 1.22.11
     transitivePeerDependencies:
@@ -14569,7 +14569,7 @@ snapshots:
       '@babel/parser': 7.28.4
       '@babel/template': 7.27.2
       '@babel/types': 7.28.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -15155,7 +15155,7 @@ snapshots:
   '@eslint/config-array@0.21.1':
     dependencies:
       '@eslint/object-schema': 2.1.7
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       minimatch: 3.1.2
     transitivePeerDependencies:
       - supports-color
@@ -15177,7 +15177,7 @@ snapshots:
   '@eslint/eslintrc@3.3.1':
     dependencies:
       ajv: 6.12.6
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       espree: 10.4.0
       globals: 14.0.0
       ignore: 5.3.2
@@ -15731,6 +15731,19 @@ snapshots:
 
   '@lukeed/ms@2.0.2': {}
 
+  '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)':
+    dependencies:
+      consola: 3.4.2
+      detect-libc: 2.1.1
+      https-proxy-agent: 7.0.6
+      node-fetch: 2.7.0(encoding@0.1.13)
+      nopt: 8.1.0
+      semver: 7.7.3
+      tar: 7.4.3
+    transitivePeerDependencies:
+      - encoding
+      - supports-color
+
   '@mapbox/node-pre-gyp@2.0.0(encoding@0.1.13)(supports-color@10.2.0)':
     dependencies:
       consola: 3.4.2
@@ -16794,6 +16807,45 @@ snapshots:
 
   '@netlify/types@2.1.0': {}
 
+  '@netlify/zip-it-and-ship-it@14.1.11(encoding@0.1.13)(rollup@4.52.5)':
+    dependencies:
+      '@babel/parser': 7.28.4
+      '@babel/types': 7.28.4
+      '@netlify/binary-info': 1.0.0
+      '@netlify/serverless-functions-api': 2.7.1
+      '@vercel/nft': 0.29.4(encoding@0.1.13)(rollup@4.52.5)
+      archiver: 7.0.1
+      common-path-prefix: 3.0.0
+      copy-file: 11.1.0
+      es-module-lexer: 1.7.0
+      esbuild: 0.25.10
+      execa: 8.0.1
+      fast-glob: 3.3.3
+      filter-obj: 6.1.0
+      find-up: 7.0.0
+      is-path-inside: 4.0.0
+      junk: 4.0.1
+      locate-path: 7.2.0
+      merge-options: 3.0.4
+      minimatch: 9.0.5
+      normalize-path: 3.0.0
+      p-map: 7.0.3
+      path-exists: 5.0.0
+      precinct: 12.2.0
+      require-package-name: 2.0.1
+      resolve: 2.0.0-next.5
+      semver: 7.7.3
+      tmp-promise: 3.0.3
+      toml: 3.0.0
+      unixify: 1.0.0
+      urlpattern-polyfill: 8.0.2
+      yargs: 17.7.2
+      zod: 3.25.76
+    transitivePeerDependencies:
+      - encoding
+      - rollup
+      - supports-color
+
   '@netlify/zip-it-and-ship-it@14.1.11(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@babel/parser': 7.28.4
@@ -16882,7 +16934,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       lru-cache: 10.4.3
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -16892,7 +16944,7 @@ snapshots:
     dependencies:
       agent-base: 7.1.4
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       lru-cache: 11.2.2
       socks-proxy-agent: 8.0.5
     transitivePeerDependencies:
@@ -17334,7 +17386,7 @@ snapshots:
 
   '@pnpm/tabtab@0.5.4':
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       enquirer: 2.4.1
       minimist: 1.2.8
       untildify: 4.0.0
@@ -19315,9 +19367,9 @@ snapshots:
     dependencies:
       '@typescript-eslint/scope-manager': 8.46.2
       '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
       '@typescript-eslint/visitor-keys': 8.46.2
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19332,10 +19384,19 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@typescript-eslint/project-service@8.46.2(typescript@5.9.3)':
+    dependencies:
+      '@typescript-eslint/tsconfig-utils': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/types': 8.46.2
+      debug: 4.4.3(supports-color@8.1.1)
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   '@typescript-eslint/rule-tester@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/parser': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
       '@typescript-eslint/utils': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       ajv: 6.12.6
       eslint: 9.38.0(jiti@2.5.1)
@@ -19358,9 +19419,9 @@ snapshots:
   '@typescript-eslint/type-utils@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
       '@typescript-eslint/utils': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 9.38.0(jiti@2.5.1)
       ts-api-utils: 2.1.0(typescript@5.9.3)
       typescript: 5.9.3
@@ -19385,12 +19446,28 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  '@typescript-eslint/typescript-estree@8.46.2(typescript@5.9.3)':
+    dependencies:
+      '@typescript-eslint/project-service': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/tsconfig-utils': 8.46.2(typescript@5.9.3)
+      '@typescript-eslint/types': 8.46.2
+      '@typescript-eslint/visitor-keys': 8.46.2
+      debug: 4.4.3(supports-color@8.1.1)
+      fast-glob: 3.3.3
+      is-glob: 4.0.3
+      minimatch: 9.0.5
+      semver: 7.7.3
+      ts-api-utils: 2.1.0(typescript@5.9.3)
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   '@typescript-eslint/utils@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)':
     dependencies:
       '@eslint-community/eslint-utils': 4.9.0(eslint@9.38.0(jiti@2.5.1))
       '@typescript-eslint/scope-manager': 8.46.2
       '@typescript-eslint/types': 8.46.2
-      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
     transitivePeerDependencies:
@@ -19462,6 +19539,25 @@ snapshots:
   '@unrs/resolver-binding-win32-x64-msvc@1.11.1':
     optional: true
 
+  '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)':
+    dependencies:
+      '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)
+      '@rollup/pluginutils': 5.2.0(rollup@4.52.5)
+      acorn: 8.15.0
+      acorn-import-attributes: 1.9.5(acorn@8.15.0)
+      async-sema: 3.1.1
+      bindings: 1.5.0
+      estree-walker: 2.0.2
+      glob: 10.4.5
+      graceful-fs: 4.2.11
+      node-gyp-build: 4.8.4
+      picomatch: 4.0.3
+      resolve-from: 5.0.0
+    transitivePeerDependencies:
+      - encoding
+      - rollup
+      - supports-color
+
   '@vercel/nft@0.29.4(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)':
     dependencies:
       '@mapbox/node-pre-gyp': 2.0.0(encoding@0.1.13)(supports-color@10.2.0)
@@ -19509,7 +19605,7 @@ snapshots:
       '@bcoe/v8-coverage': 1.0.2
       '@vitest/utils': 4.0.3
       ast-v8-to-istanbul: 0.3.5
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       istanbul-lib-coverage: 3.2.2
       istanbul-lib-report: 3.0.1
       istanbul-lib-source-maps: 5.0.6
@@ -21231,6 +21327,15 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  detective-typescript@14.0.0(typescript@5.9.3):
+    dependencies:
+      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
+      ast-module-types: 6.0.1
+      node-source-walk: 7.0.1
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   detective-vue2@2.2.0(supports-color@10.2.0)(typescript@5.9.3):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -21244,6 +21349,19 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
+  detective-vue2@2.2.0(typescript@5.9.3):
+    dependencies:
+      '@dependents/detective-less': 5.0.1
+      '@vue/compiler-sfc': 3.5.21
+      detective-es6: 5.0.1
+      detective-sass: 6.0.1
+      detective-scss: 5.0.1
+      detective-stylus: 5.0.1
+      detective-typescript: 14.0.0(typescript@5.9.3)
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   dettle@1.0.5: {}
 
   devlop@1.1.0:
@@ -21680,7 +21798,7 @@ snapshots:
 
   eslint-import-resolver-typescript@4.4.4(eslint-plugin-import@2.32.0)(eslint@9.38.0(jiti@2.5.1)):
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       eslint: 9.38.0(jiti@2.5.1)
       eslint-import-context: 0.1.9(unrs-resolver@1.11.1)
       get-tsconfig: 4.10.1
@@ -21877,7 +21995,7 @@ snapshots:
       ajv: 6.12.6
       chalk: 4.1.2
       cross-spawn: 7.0.6
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       escape-string-regexp: 4.0.0
       eslint-scope: 8.4.0
       eslint-visitor-keys: 4.2.1
@@ -22076,7 +22194,7 @@ snapshots:
 
   extract-zip@2.0.1:
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       get-stream: 5.2.0
       yauzl: 2.10.0
     optionalDependencies:
@@ -22316,7 +22434,7 @@ snapshots:
 
   follow-redirects@1.15.11(debug@4.4.3):
     optionalDependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
 
   for-each@0.3.5:
     dependencies:
@@ -22433,7 +22551,7 @@ snapshots:
   gaxios@6.7.1(encoding@0.1.13):
     dependencies:
       extend: 3.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       is-stream: 2.0.1
       node-fetch: 2.7.0(encoding@0.1.13)
       uuid: 9.0.1
@@ -22952,7 +23070,7 @@ snapshots:
   http-proxy-agent@7.0.2:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 
@@ -22979,7 +23097,7 @@ snapshots:
   http-proxy-middleware@3.0.3:
     dependencies:
       '@types/http-proxy': 1.17.16
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       http-proxy: 1.18.1(debug@4.4.3)
       is-glob: 4.0.3
       is-plain-object: 5.0.0
@@ -23002,6 +23120,13 @@ snapshots:
       quick-lru: 5.1.1
       resolve-alpn: 1.2.1
 
+  https-proxy-agent@7.0.6:
+    dependencies:
+      agent-base: 7.1.4
+      debug: 4.4.3(supports-color@8.1.1)
+    transitivePeerDependencies:
+      - supports-color
+
   https-proxy-agent@7.0.6(supports-color@10.2.0):
     dependencies:
       agent-base: 7.1.4
@@ -23456,7 +23581,7 @@ snapshots:
   istanbul-lib-source-maps@5.0.6:
     dependencies:
       '@jridgewell/trace-mapping': 0.3.30
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       istanbul-lib-coverage: 3.2.2
     transitivePeerDependencies:
       - supports-color
@@ -23539,7 +23664,7 @@ snapshots:
       decimal.js: 10.6.0
       html-encoding-sniffer: 4.0.0
       http-proxy-agent: 7.0.2
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       is-potential-custom-element-name: 1.0.1
       parse5: 8.0.0
       rrweb-cssom: 0.8.0
@@ -24359,7 +24484,7 @@ snapshots:
   micromark@4.0.2:
     dependencies:
       '@types/debug': 4.1.12
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       decode-named-character-reference: 1.2.0
       devlop: 1.1.0
       micromark-core-commonmark: 2.0.3
@@ -24634,7 +24759,7 @@ snapshots:
       '@netlify/headers-parser': 9.0.2
       '@netlify/local-functions-proxy': 2.0.3
       '@netlify/redirect-parser': 15.0.3
-      '@netlify/zip-it-and-ship-it': 14.1.11(encoding@0.1.13)(rollup@4.52.5)(supports-color@10.2.0)
+      '@netlify/zip-it-and-ship-it': 14.1.11(encoding@0.1.13)(rollup@4.52.5)
       '@octokit/rest': 22.0.0
       '@opentelemetry/api': 1.8.0
       '@pnpm/tabtab': 0.5.4
@@ -24652,7 +24777,7 @@ snapshots:
       content-type: 1.0.5
       cookie: 1.0.2
       cron-parser: 4.9.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       decache: 4.6.2
       dot-prop: 9.0.0
       dotenv: 17.2.3
@@ -24674,7 +24799,7 @@ snapshots:
       gitconfiglocal: 2.1.0
       http-proxy: 1.18.1(debug@4.4.3)
       http-proxy-middleware: 2.0.9(debug@4.4.3)
-      https-proxy-agent: 7.0.6(supports-color@10.2.0)
+      https-proxy-agent: 7.0.6
       inquirer: 8.2.7(@types/node@22.18.12)
       inquirer-autocomplete-prompt: 1.4.0(inquirer@8.2.7(@types/node@22.18.12))
       ipx: 3.1.1(@netlify/blobs@10.1.0)
@@ -25591,6 +25716,26 @@ snapshots:
 
   preact@10.24.3: {}
 
+  precinct@12.2.0:
+    dependencies:
+      '@dependents/detective-less': 5.0.1
+      commander: 12.1.0
+      detective-amd: 6.0.1
+      detective-cjs: 6.0.1
+      detective-es6: 5.0.1
+      detective-postcss: 7.0.1(postcss@8.5.6)
+      detective-sass: 6.0.1
+      detective-scss: 5.0.1
+      detective-stylus: 5.0.1
+      detective-typescript: 14.0.0(typescript@5.9.3)
+      detective-vue2: 2.2.0(typescript@5.9.3)
+      module-definition: 6.0.1
+      node-source-walk: 7.0.1
+      postcss: 8.5.6
+      typescript: 5.9.3
+    transitivePeerDependencies:
+      - supports-color
+
   precinct@12.2.0(supports-color@10.2.0):
     dependencies:
       '@dependents/detective-less': 5.0.1
@@ -26614,7 +26759,7 @@ snapshots:
   socks-proxy-agent@8.0.5:
     dependencies:
       agent-base: 7.1.4
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       socks: 2.8.7
     transitivePeerDependencies:
       - supports-color
@@ -26932,7 +27077,7 @@ snapshots:
       cosmiconfig: 9.0.0(typescript@5.9.3)
       css-functions-list: 3.2.3
       css-tree: 3.1.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       fast-glob: 3.3.3
       fastest-levenshtein: 1.0.16
       file-entry-cache: 10.1.4
@@ -27239,7 +27384,7 @@ snapshots:
   tuf-js@3.1.0:
     dependencies:
       '@tufjs/models': 3.0.1
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       make-fetch-happen: 14.0.3
     transitivePeerDependencies:
       - supports-color
@@ -27247,7 +27392,7 @@ snapshots:
   tuf-js@4.0.0:
     dependencies:
       '@tufjs/models': 4.0.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       make-fetch-happen: 15.0.2
     transitivePeerDependencies:
       - supports-color
@@ -27320,7 +27465,7 @@ snapshots:
     dependencies:
       '@typescript-eslint/eslint-plugin': 8.46.2(@typescript-eslint/parser@8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3))(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       '@typescript-eslint/parser': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
-      '@typescript-eslint/typescript-estree': 8.46.2(supports-color@10.2.0)(typescript@5.9.3)
+      '@typescript-eslint/typescript-estree': 8.46.2(typescript@5.9.3)
       '@typescript-eslint/utils': 8.46.2(eslint@9.38.0(jiti@2.5.1))(typescript@5.9.3)
       eslint: 9.38.0(jiti@2.5.1)
       typescript: 5.9.3
@@ -27609,7 +27754,7 @@ snapshots:
 
   vite-tsconfig-paths@5.1.4(typescript@5.9.3)(vite@7.1.12(@types/node@22.18.12)(jiti@2.5.1)(terser@5.44.0)(tsx@4.20.6)(yaml@2.8.1)):
     dependencies:
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       globrex: 0.1.2
       tsconfck: 3.1.6(typescript@5.9.3)
     optionalDependencies:
@@ -27669,7 +27814,7 @@ snapshots:
       '@vitest/snapshot': 4.0.3
       '@vitest/spy': 4.0.3
       '@vitest/utils': 4.0.3
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
       es-module-lexer: 1.7.0
       expect-type: 1.2.2
       magic-string: 0.30.21
@@ -27714,7 +27859,7 @@ snapshots:
     dependencies:
       chalk: 4.1.2
       commander: 9.5.0
-      debug: 4.4.3(supports-color@10.2.0)
+      debug: 4.4.3(supports-color@8.1.1)
     transitivePeerDependencies:
       - supports-color
 

From 766d846891e977108a4ae4fa21d03fe0e82fa36d Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Wed, 29 Oct 2025 11:02:00 +0100
Subject: [PATCH 16/17] Update index.test.ts

---
 packages/code-infra/src/brokenLinksChecker/index.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.test.ts b/packages/code-infra/src/brokenLinksChecker/index.test.ts
index e104908f5..152152566 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.test.ts
+++ b/packages/code-infra/src/brokenLinksChecker/index.test.ts
@@ -37,7 +37,7 @@ describe('Broken Links Checker', () => {
     const host = `http://localhost:${port}`;
 
     const result = await crawl({
-      startCommand: `pnpm exec serve ${fixtureDir} -p ${port}`,
+      startCommand: `${servePath} ${fixtureDir} -p ${port}`,
       host,
       ignoredPaths: [/ignored-page\.html$/],
       ignoredContent: ['.sidebar'],

From 28eaf44fc10fb12c7c7df2cc46b86fd6d761113d Mon Sep 17 00:00:00 2001
From: Janpot <2109932+Janpot@users.noreply.github.com>
Date: Wed, 29 Oct 2025 12:29:05 +0100
Subject: [PATCH 17/17] Add jsdoc comments

---
 .../src/brokenLinksChecker/index.mjs          | 226 ++++++++++--------
 1 file changed, 121 insertions(+), 105 deletions(-)

diff --git a/packages/code-infra/src/brokenLinksChecker/index.mjs b/packages/code-infra/src/brokenLinksChecker/index.mjs
index 6d55e17d9..5d04171ee 100644
--- a/packages/code-infra/src/brokenLinksChecker/index.mjs
+++ b/packages/code-infra/src/brokenLinksChecker/index.mjs
@@ -11,8 +11,10 @@ import contentType from 'content-type';
 const DEFAULT_CONCURRENCY = 4;
 
 /**
- * @param {string} prefix
- * @returns {Transform}
+ * Creates a Transform stream that prefixes each line with a given string.
+ * Useful for distinguishing server logs from other output.
+ * @param {string} prefix - String to prepend to each line
+ * @returns {Transform} Transform stream that adds the prefix to each line
  */
 const prefixLines = (prefix) => {
   let leftover = '';
@@ -33,18 +35,23 @@ const prefixLines = (prefix) => {
 };
 
 /**
- * Maps pageUrl to ids of known targets on that page
+ * Maps page URLs to sets of known target IDs (anchors) on that page.
+ * Used to track which link targets (e.g., #section-id) exist on each page.
  * @typedef {Map<string, Set<string>>} LinkStructure
  */
 
 /**
+ * Serialized representation of LinkStructure for JSON storage.
+ * Converts Maps and Sets to plain objects and arrays for file persistence.
  * @typedef {Object} SerializedLinkStructure
- * @property {Record<string, string[]>} targets
+ * @property {Record<string, string[]>} targets - Object mapping page URLs to arrays of target IDs
  */
 
 /**
- * @param {string | URL} url
- * @returns {Promise<Response>}
+ * Fetches a URL and throws an error if the response is not OK.
+ * @param {string | URL} url - URL to fetch
+ * @returns {Promise<Response>} Fetch response if successful
+ * @throws {Error} If the response status is not OK (not in 200-299 range)
  */
 async function fetchUrl(url) {
   const res = await fetch(url);
@@ -55,9 +62,12 @@ async function fetchUrl(url) {
 }
 
 /**
- * @param {string} url
- * @param {number} timeout
- * @returns {Promise<void>}
+ * Polls a URL until it responds successfully or times out.
+ * Used to wait for a dev server to start.
+ * @param {string} url - URL to poll
+ * @param {number} timeout - Maximum milliseconds to wait before timing out
+ * @returns {Promise<void>} Resolves when URL responds successfully
+ * @throws {Error} If timeout is reached before URL responds
  */
 async function pollUrl(url, timeout) {
   const start = Date.now();
@@ -77,8 +87,9 @@ async function pollUrl(url, timeout) {
 }
 
 /**
- * @param {SerializedLinkStructure} data
- * @returns {LinkStructure}
+ * Converts serialized link structure (from JSON) back to Map/Set form.
+ * @param {SerializedLinkStructure} data - Serialized structure with plain objects/arrays
+ * @returns {LinkStructure} Deserialized structure using Map and Set
  */
 function deserializeLinkStructure(data) {
   const linkStructure = new Map();
@@ -89,19 +100,17 @@ function deserializeLinkStructure(data) {
 }
 
 /**
- * @typedef {Object} LinkTarget
- */
-
-/**
+ * Data about a crawled page including its URL, HTTP status, and available link targets.
  * @typedef {Object} PageData
- * @property {string} url
- * @property {number} status
- * @property {Map<string, LinkTarget>} targets
+ * @property {string} url - The normalized page URL (without trailing slash unless root)
+ * @property {number} status - HTTP status code from the response (e.g., 200, 404, 500)
+ * @property {Set<string>} targets - Set of available anchor targets on the page, keyed by hash (e.g., '#intro')
  */
 
 /**
- * @param {Map<string, PageData>} pages
- * @param {string} outPath
+ * Serializes and writes discovered page targets to a JSON file.
+ * @param {Map<string, PageData>} pages - Map of crawled pages with their targets
+ * @param {string} outPath - File path to write the JSON output
  * @returns {Promise<void>}
  */
 async function writePagesToFile(pages, outPath) {
@@ -116,10 +125,12 @@ async function writePagesToFile(pages, outPath) {
 }
 
 /**
- * Polyfill for `node.computedName` available only in chrome v112+
- * @param {import('node-html-parser').HTMLElement | null} elm
- * @param {import('node-html-parser').HTMLElement} ownerDocument
- * @returns {string}
+ * Computes the accessible name of an element according to ARIA rules.
+ * Polyfill for `node.computedName` available only in Chrome v112+.
+ * Checks in order: aria-label, aria-labelledby, label[for], img alt, innerText.
+ * @param {import('node-html-parser').HTMLElement | null} elm - Element to compute name for
+ * @param {import('node-html-parser').HTMLElement} ownerDocument - Document containing the element
+ * @returns {string} The computed accessible name, or empty string if none found
  */
 function getAccessibleName(elm, ownerDocument) {
   if (!elm) {
@@ -169,18 +180,23 @@ function getAccessibleName(elm, ownerDocument) {
 }
 
 /**
+ * Generic concurrent task queue with configurable concurrency limit.
+ * Processes tasks in FIFO order with a maximum number of concurrent workers.
  * @template T
  */
 class Queue {
+  /** Array of pending tasks waiting to be processed */
   /** @type {T[]} */
   tasks = [];
 
+  /** Set of currently running task promises */
   /** @type {Set<Promise<void>>} */
   pending = new Set();
 
   /**
-   * @param {(task: T) => Promise<void>} worker
-   * @param {number} concurrency
+   * Creates a new queue with a worker function and concurrency limit.
+   * @param {(task: T) => Promise<void>} worker - Async function to process each task
+   * @param {number} concurrency - Maximum number of tasks to run simultaneously
    */
   constructor(worker, concurrency) {
     this.worker = worker;
@@ -188,7 +204,8 @@ class Queue {
   }
 
   /**
-   * @param {T} task
+   * Adds a task to the queue and starts processing if under concurrency limit.
+   * @param {T} task - Task to add to the queue
    */
   add(task) {
     this.tasks.push(task);
@@ -206,6 +223,10 @@ class Queue {
     }
   }
 
+  /**
+   * Waits for all pending and queued tasks to complete.
+   * @returns {Promise<void>}
+   */
   async waitAll() {
     while (this.pending.size > 0) {
       // eslint-disable-next-line no-await-in-loop
@@ -215,16 +236,20 @@ class Queue {
 }
 
 /**
+ * Represents a hyperlink found during crawling.
  * @typedef {Object} Link
- * @property {string | null} src
- * @property {string | null} text
- * @property {string} href
+ * @property {string | null} src - URL of the page where this link was found, or null for seed URLs
+ * @property {string | null} text - Accessible name/text content of the link element, or null for seed URLs
+ * @property {string} href - The href attribute value (may be relative or absolute, with or without hash)
  */
 
 /**
- * @param {string} href
- * @param {RegExp[]} ignoredPaths
- * @returns {string | null}
+ * Extracts and normalizes the page URL from a link href.
+ * Returns null for external links, ignored paths, or non-standard URLs.
+ * Normalizes by removing trailing slashes (except root) and preserving query params.
+ * @param {string} href - Link href to process (e.g., '/docs/api#section?query=1')
+ * @param {RegExp[]} ignoredPaths - Array of patterns to exclude
+ * @returns {string | null} Normalized page URL with query but without hash, or null if external/ignored
  */
 function getPageUrl(href, ignoredPaths = []) {
   if (!href.startsWith('/')) {
@@ -244,26 +269,29 @@ function getPageUrl(href, ignoredPaths = []) {
 }
 
 /**
+ * Configuration options for the broken links crawler.
  * @typedef {Object} CrawlOptions
- * @property {string | null} [startCommand]
- * @property {string} host
- * @property {string | null} [outPath]
- * @property {RegExp[]} [ignoredPaths]
- * @property {string[]} [ignoredContent]
- * @property {Set<string>} [ignoredTargets]
- * @property {Map<string, Set<string>>} [knownTargets]
- * @property {string[]} [knownTargetsDownloadUrl]
- * @property {number} [concurrency]
- * @property {string[]} [seedUrls]
+ * @property {string | null} [startCommand] - Shell command to start the dev server (e.g., 'npm run dev'). If null, assumes server is already running
+ * @property {string} host - Base URL of the site to crawl (e.g., 'http://localhost:3000')
+ * @property {string | null} [outPath] - File path to write discovered link targets to. If null, targets are not persisted
+ * @property {RegExp[]} [ignoredPaths] - Array of regex patterns to exclude from crawling (e.g., [/^\/api\//] to skip /api/* routes)
+ * @property {string[]} [ignoredContent] - CSS selectors for elements whose nested links should be ignored (e.g., ['.sidebar', 'footer'])
+ * @property {Set<string>} [ignoredTargets] - Set of element IDs to ignore as link targets (defaults to '__next', '__NEXT_DATA__')
+ * @property {Map<string, Set<string>>} [knownTargets] - Pre-populated map of known valid targets to skip crawling (useful for external pages)
+ * @property {string[]} [knownTargetsDownloadUrl] - URLs to fetch known targets from (fetched JSON will be merged with knownTargets)
+ * @property {number} [concurrency] - Number of concurrent page fetches (defaults to 4)
+ * @property {string[]} [seedUrls] - Starting URLs for the crawl (defaults to ['/'])
  */
 
 /**
+ * Fully resolved configuration with all optional fields filled with defaults.
  * @typedef {Required<CrawlOptions>} ResolvedCrawlOptions
  */
 
 /**
- * @param {CrawlOptions} rawOptions
- * @returns {ResolvedCrawlOptions}
+ * Resolves partial crawl options by filling in defaults for all optional fields.
+ * @param {CrawlOptions} rawOptions - Partial options from user
+ * @returns {ResolvedCrawlOptions} Fully resolved options with all defaults applied
  */
 function resolveOptions(rawOptions) {
   return {
@@ -281,11 +309,12 @@ function resolveOptions(rawOptions) {
 }
 
 /**
- * Merge multiple maps, similar to `Object.assign`
+ * Merges multiple Maps, similar to Object.assign for objects.
+ * Later sources override earlier ones for duplicate keys.
  * @template K, V
- * @param {Map<K, V>} target
- * @param {...Map<K, V>} sources
- * @returns {Map<K, V>}
+ * @param {Map<K, V>} target - Target map to merge into (will be mutated)
+ * @param {...Map<K, V>} sources - Source maps to merge from
+ * @returns {Map<K, V>} The mutated target map
  */
 function mergeMaps(target, ...sources) {
   for (const source of sources) {
@@ -297,8 +326,10 @@ function mergeMaps(target, ...sources) {
 }
 
 /**
- * @param {string[]} urls
- * @returns {Promise<LinkStructure[]>}
+ * Downloads and deserializes known link targets from remote URLs.
+ * Fetches JSON files containing serialized link structures in parallel.
+ * @param {string[]} urls - Array of URLs to fetch known targets from
+ * @returns {Promise<LinkStructure[]>} Array of deserialized link structures
  */
 async function downloadKnownTargets(urls) {
   if (urls.length === 0) {
@@ -320,8 +351,10 @@ async function downloadKnownTargets(urls) {
 }
 
 /**
- * @param {ResolvedCrawlOptions} options
- * @returns {Promise<LinkStructure>}
+ * Resolves all known targets by downloading remote ones and merging with user-provided.
+ * User-provided targets take priority over downloaded ones.
+ * @param {ResolvedCrawlOptions} options - Resolved crawl options
+ * @returns {Promise<LinkStructure>} Merged map of all known targets
  */
 async function resolveKnownTargets(options) {
   const downloaded = await downloadKnownTargets(options.knownTargetsDownloadUrl);
@@ -330,22 +363,24 @@ async function resolveKnownTargets(options) {
 }
 
 /**
+ * Represents a broken link or broken link target discovered during crawling.
  * @typedef {Object} Issue
- * @property {'broken-link' | 'broken-target'} type
- * @property {string} message
- * @property {Link} link
+ * @property {'broken-link' | 'broken-target'} type - Type of issue: 'broken-link' for 404 pages, 'broken-target' for missing anchors
+ * @property {string} message - Human-readable description of the issue (e.g., 'Target not found', 'Page returned error 404')
+ * @property {Link} link - The link object that has the issue
  */
 
 /**
+ * Results from a complete crawl operation.
  * @typedef {Object} CrawlResult
- * @property {Set<Link>} links
- * @property {Map<string, PageData>} pages
- * @property {Issue[]} issues
+ * @property {Set<Link>} links - All links discovered during the crawl
+ * @property {Map<string, PageData>} pages - All pages crawled, keyed by normalized URL
+ * @property {Issue[]} issues - All broken links and broken targets found
  */
 
 /**
- * Report broken links grouped by source page
- * @param {Issue[]} issuesList
+ * Reports broken links to stderr, grouped by source page for better readability.
+ * @param {Issue[]} issuesList - Array of issues to report
  */
 function reportIssues(issuesList) {
   if (issuesList.length === 0) {
@@ -377,8 +412,9 @@ function reportIssues(issuesList) {
 }
 
 /**
- * @param {CrawlOptions} rawOptions
- * @returns {Promise<CrawlResult>}
+ * Crawls a website starting from seed URLs, discovering all internal links and checking for broken links/targets.
+ * @param {CrawlOptions} rawOptions - Configuration options for the crawl
+ * @returns {Promise<CrawlResult>} Crawl results including all links, pages, and issues found
  */
 export async function crawl(rawOptions) {
   const options = resolveOptions(rawOptions);
@@ -434,19 +470,18 @@ export async function crawl(rawOptions) {
       console.log(`Crawling ${chalk.cyan(pageUrl)}...`);
       const res = await fetch(new URL(pageUrl, options.host));
 
-      const urlData = { url: pageUrl, status: res.status };
-
-      if (urlData.status < 200 || urlData.status >= 400) {
-        console.warn(chalk.yellow(`Warning: ${pageUrl} returned status ${urlData.status}`));
+      /** @type {PageData} */
+      const pageData = {
+        url: pageUrl,
+        status: res.status,
+        targets: new Set(),
+      };
 
-        return {
-          url: pageUrl,
-          status: res.status,
-          targets: new Map(),
-        };
+      if (pageData.status < 200 || pageData.status >= 400) {
+        console.warn(chalk.yellow(`Warning: ${pageUrl} returned status ${pageData.status}`));
+        return pageData;
       }
 
-      // Check if the response is HTML
       const contentTypeHeader = res.headers.get('content-type');
       let type = 'text/html';
 
@@ -463,23 +498,13 @@ export async function crawl(rawOptions) {
 
       if (type.startsWith('image/')) {
         // Skip images
-        return {
-          url: pageUrl,
-          status: res.status,
-          targets: new Map(),
-        };
+        return pageData;
       }
 
       if (type !== 'text/html') {
         console.warn(chalk.yellow(`Warning: ${pageUrl} returned non-HTML content-type: ${type}`));
-
         // TODO: Handle text/markdown. Parse content as markdown and extract links/targets.
-
-        return {
-          url: pageUrl,
-          status: res.status,
-          targets: new Map(),
-        };
+        return pageData;
       }
 
       const content = await res.text();
@@ -497,22 +522,17 @@ export async function crawl(rawOptions) {
         href: a.getAttribute('href') ?? '',
       }));
 
-      const pageTargets = new Map(
-        dom
-          .querySelectorAll('*[id]')
-          .filter((elm) => !options.ignoredTargets.has(elm.id))
-          .map((elm) => [`#${elm.id}`, {}]),
-      );
+      for (const target of dom.querySelectorAll('*[id]')) {
+        if (!options.ignoredTargets.has(target.id)) {
+          pageData.targets.add(`#${target.id}`);
+        }
+      }
 
       for (const pageLink of pageLinks) {
         queue.add(pageLink);
       }
 
-      return {
-        url: pageUrl,
-        status: res.status,
-        targets: pageTargets,
-      };
+      return pageData;
     });
 
     crawledPages.set(pageUrl, pagePromise);
@@ -541,19 +561,15 @@ export async function crawl(rawOptions) {
     await writePagesToFile(results, options.outPath);
   }
 
-  /**
-   * @typedef {Object} BrokenLinkError
-   * @property {Link} link
-   * @property {string} reason
-   */
-
+  /** Array to collect all issues found during validation */
   /** @type {Issue[]} */
   const issues = [];
 
   /**
-   * @param {Link} link
-   * @param {'broken-target' | 'broken-link'} type
-   * @param {string} message
+   * Records a broken link or target issue.
+   * @param {Link} link - The link with the issue
+   * @param {'broken-target' | 'broken-link'} type - Type of issue
+   * @param {string} message - Human-readable error message
    */
   function recordBrokenLink(link, type, message) {
     issues.push({