Version Packages

* Add number of files checked
* Add number of links checked

docs/docs/configuration/overview.md

@@ -35,6 +35,9 @@ export default {
   // add a plugin to eleventy (e.g. a filter packs)
   setupEleventyPlugins: [],
 
+  // add a computedConfig to eleventy (e.g. site wide default variables like socialMediaImage)
+  setupEleventyComputedConfig: [],
+
   // add a plugin to the cli (e.g. a new command like "rocket my-command")
   setupCliPlugins: [],
 };

docs/docs/configuration/setupEleventyComputedConfig.md

@@ -0,0 +1,41 @@
+# Configuration >> setupEleventyComputedConfig ||20
+
+If you want to add data that depends on other data then you can do it via [11ty's computed data](https://www.11ty.dev/docs/data-computed/).
+
+Rocket exposes it via `setupEleventyComputedConfig`.
+
+## Set your own data
+
+Let's say you want to add a `Welcome to the contact page` everyhwere. (a filter might be a better choise but it's a good example of the concept)
+
+👉 `rocket.config.mjs` (or your theme config file)
+
+```js
+import { addPlugin } from 'plugins-manager';
+
+/** @type {Partial<import("../../../types/main").RocketCliOptions>} */
+const config = {
+  setupEleventyComputedConfig: [
+    addPlugin({ name: 'greeting', plugin: data => `Welcome to the ${data.title} page.` }),
+  ],
+};
+
+export default config;
+```
+
+{% raw %}
+Now you can use everywhere {{ greeting }}.
+{% endraw %}
+And it will correctly replaced with a Welcome and the page title.
+
+## Default Available Configs
+
+```js
+[
+  { name: 'titleMeta', plugin: titleMetaPlugin },
+  { name: 'title', plugin: titlePlugin },
+  { name: 'eleventyNavigation', plugin: eleventyNavigationPlugin },
+  { name: 'section', plugin: sectionPlugin },
+  { name: 'socialMediaImage', plugin: socialMediaImagePlugin },
+];
+```

docs/docs/eleventy-plugins/mdjs-unified.md

@@ -18,43 +18,11 @@ module.exports = function (eleventyConfig) {
 };
 ```
 
-As mdjs does return html AND javascript at the same time we need to have a template that can understand it. For that we create a layout file.
-
-👉 `_includes/layout.njk`
-
-{% raw %}
-
-```js
-<main>
-  {{ content.html | safe }}
-</main>
-
-<script type="module">
-  {{ content.jsCode | safe }}
-</script>
-```
-
-{% endraw %}
-
-And in our content we then need to make sure to use that template.
-
-👉 `index.md`
-
-```
----
-layout: layout.njk
----
-
-# Hello World
-```
-
-You can see a minimal setup in the [examples repo](https://github.com/daKmoR/rocket-example-projects/tree/master/eleventy-and-mdjs).
-
 ## Configure a unified or remark plugin with mdjs
 
 By providing a `setupUnifiedPlugins` function as an option to `eleventy-plugin-mdjs` you can set options for all unified/remark plugins.
 
-We do use [plugins-manager](../plugins-manager/overview.md).
+We do use [plugins-manager](../tools/plugins-manager.md).
 
 This example adds a CSS class to the `htmlHeading` plugin so heading links can be selected in CSS.
 

docs/docs/tools/check-html-links.md

@@ -0,0 +1,38 @@
+# Tools >> Check Html Links ||30
+
+A fast checker for broken links/references in html.
+
+## Features
+
+- Checks all html files for broken local links/references (in href, src, srcset)
+- Focuses on the broken reference targets and groups references to it
+- Fast (can process 500-1000 documents in ~2-3 seconds)
+- Has only 3 dependencies (and 19 in the full tree)
+- Uses [sax-wasm](https://github.com/justinwilaby/sax-wasm) for parsing streamed html
+
+## Installation
+
+```
+npm i -D check-html-links
+```
+
+## Usage
+
+```
+npx check-html-links _site
+```
+
+## Example Output
+
+![Test Run Screenshot](./images/check-html-links-screenshot.png)
+
+## Comparision
+
+Checking the output of [11ty-website](https://github.com/11ty/11ty-website) with 13 missing reference targets (used by 516 links) while checking 501 files. (on January 17, 2021)
+
+| Tool             | Lines printed | Times  | Lang | Dependency Tree |
+| ---------------- | ------------- | ------ | ---- | --------------- |
+| check-html-links | 38            | ~2.5s  | node | 19              |
+| link-checker     | 3000+         | ~11s   | node | 106             |
+| hyperlink        | 68            | 4m 20s | node | 481             |
+| htmltest         | 1000+         | ~0.7s  | GO   | -               |

docs/docs/tools/rollup-config.md

@@ -1,4 +1,4 @@
-# Tools >> Rollup Config
+# Tools >> Rollup Config ||20
 
 Rollup configuration to help you get started building modern web applications.
 You write modern javascript using the latest browser-features, rollup will optimize your code for production and ensure it runs on all supported browsers.
@@ -52,7 +52,7 @@ You write modern javascript using the latest browser-features, rollup will optim
 
 Our config sets you up with good defaults for most projects. Additionally you can add more plugins and adjust predefined plugins or even remove them if needed.
 
-We use the [plugins-manager](../plugins-manager/overview.md) for it.
+We use the [plugins-manager](./plugins-manager.md) for it.
 
 ### Customizing the babel config
 
@@ -83,7 +83,7 @@ SPA and MPA plugins:
 - [polyfills-loader](https://modern-web.dev/docs/building/rollup-plugin-polyfills-loader/)
 - [workbox](https://www.npmjs.com/package/rollup-plugin-workbox)
 
-You can customize options for these plugins by using [adjustPluginOptions](../plugins-manager/overview.md#adjusting-plugin-options).
+You can customize options for these plugins by using [adjustPluginOptions](./plugins-manager.md#adjusting-plugin-options).
 
 ```js
 import { createSpaConfig } from '@rocket/building-rollup';

docs/guides/go-live/overview.md

@@ -1,4 +1,4 @@
-# Go Live >> Overview
+# Go Live >> Overview ||10
 
 A few things are usually needed before going live "for real".
 

docs/guides/go-live/social-media.md

@@ -0,0 +1,131 @@
+# Go Live >> Social Media ||20
+
+Having a nice preview image for social media can be very helpful.
+For that reason Rocket creates those automatically with the title, parent title, section and your logo.
+
+It will look like this but with your logo
+
+<img src="{{ socialMediaImage }}" width="1200" height="630" alt="Social Media Image of this page" style="border: 1px solid #000" />
+
+There are multiple ways you can modify it.
+
+Note: If your logo has an `<?xml>` tag it will throw an error as it will be inlined into this svg and nested xml tags are not allowed.
+
+## Setting it via frontMatter
+
+You can create your own image and link it with something like this
+
+```
+---
+socialMediaImage: path/to/my/image.png
+---
+```
+
+## Providing your own text
+
+Sometimes extracting the title + title of parent is not enough but you still want to use the "default image".
+
+You can create an `11tydata.cjs` file next to your page. If your page is `docs/guides/overview.md` then you create a `docs/guides/overview.11tydata.cjs`.
+
+In there you can use the default `createSocialImage` but provide your own values.
+
+```js
+const { createSocialImage } = require('@rocket/cli');
+
+module.exports = async function () {
+  const socialMediaImage = await createSocialImage({
+    title: 'Learning Rocket',
+    subTitle: 'Have a website',
+    subTitle2: 'in 5 Minutes',
+    footer: 'Rocket Guides',
+    // you can also override the svg only for this page by providing
+    // createSocialImageSvg: async () => '<svg>...</svg>'
+  });
+  return {
+    socialMediaImage,
+  };
+};
+```
+
+## Override the default image
+
+Often you want to have a unique style for your social media images.
+For that you can provide your own function which returns a string of an svg to render the image.
+
+👉 `rocket.config.mjs`
+
+```js
+import { adjustPluginOptions } from 'plugins-manager';
+
+/** @type {Partial<import("@rocket/cli").RocketCliOptions>} */
+const config = {
+  setupEleventyComputedConfig: [
+    adjustPluginOptions('socialMediaImage', {
+      createSocialImageSvg: async ({
+        title = '',
+        subTitle = '',
+        subTitle2 = '',
+        footer = '',
+        logo = '',
+      }) => {
+        let svgStr = `
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630" style="fill: #ecedef;">
+            <defs/>
+            <rect width="100%" height="100%" fill="#38393e"/>
+            <g transform="matrix(0.45, 0, 0, 0.45, 300, 60)">${logo}</g>
+            <g style="
+              font-size: 70px;
+              text-anchor: middle;
+              font-family: 'Bitstream Vera Sans','Helvetica',sans-serif;
+              font-weight: 700;
+            ">
+              <text x="50%" y="470">
+                ${title}
+              </text>
+              <text x="50%" y="520" style="font-size: 30px;">
+                ${subTitle}
+              </text>
+            </g>
+            <text x="10" y="620" style="font-size: 30px; fill: gray;">
+              ${footer}
+            </text>
+          </svg>
+        `;
+        return svgStr;
+      },
+    }),
+  ],
+};
+
+export default config;
+```
+
+## Using an svg file as a src with nunjucks
+
+If you have multiple variations it may be easier to save them as svg files and using a template system
+
+WARNING: Untested example
+
+👉 `rocket.config.mjs`
+
+{% raw %}
+
+```js
+import { adjustPluginOptions } from 'plugins-manager';
+
+/** @type {Partial<import("@rocket/cli").RocketCliOptions>} */
+const config = {
+  setupEleventyComputedConfig: [
+    adjustPluginOptions('socialMediaImage', {
+      createSocialImageSvg: async (args = {}) => {
+        // inside of the svg you can use {{ title }}
+        const svgBuffer = await fs.promises.readFile('/path/to/your/svg/file');
+        const svg = logoBuffer.toString();
+        return nunjucks.renderString(svg, args);
+      },
+    }),
+  ],
+};
+
+{% endraw %}
+```

docs/guides/index.11tydata.cjs

@@ -0,0 +1,13 @@
+const { createSocialImage } = require('@rocket/cli');
+
+module.exports = async function () {
+  const socialMediaImage = await createSocialImage({
+    title: 'Learning Rocket',
+    subTitle: 'Have a website',
+    subTitle2: 'in 5 Minutes',
+    footer: 'Rocket Guides',
+  });
+  return {
+    socialMediaImage,
+  };
+};

docs/guides/index.md

@@ -1,6 +1,5 @@
 ---
 title: Learning Rocket
-description: 'foo'
 eleventyNavigation:
   key: Guides
   order: 10

docs/guides/presets/create-your-own.md

@@ -1,7 +1,106 @@
 # Presets >> Create your own || 90
 
-All loaded presets will be combined but you can override each file.
+A preset is setup function and a folder including `_assets`, `_data` and `_includes` (all optional).
 
-Take a look at `docs/_merged_includes` and override what you want to override by placing the same filename into `_includes`.
+To play around with a preset you can create a folder `fire-theme`.
 
-Also works for `_assets`, `_data` ...
+You then create the setup function for it with only one property called `path` which will allow Rocket to properly resolve it.
+
+## Create a Preset Config File
+
+👉 `fire-theme/fireTheme.js`
+
+```js
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export function fireTheme() {
+  return {
+    path: path.resolve(__dirname),
+  };
+}
+```
+
+Once you have that you can start filling in content you need.
+
+For example a we could override the full `layout.css` by adding a it like so
+
+👉 `fire-theme/layout.css`
+
+```css
+body {
+  background: hotpink;
+}
+```
+
+Once you have that you can add it to your Rocket Config.
+
+NOTE: The order of presets is important, as for example in this case we take everything from `rocketLaunch` but later override via `fireTheme`.
+
+👉 `rocket-config.js`
+
+```js
+import { rocketLaunch } from '@rocket/launch';
+import { fireTheme } from 'path/to/fire-theme/fireTheme.js';
+
+export default {
+  presets: [rocketLaunch(), fireTheme()],
+};
+```
+
+## Publish a preset
+
+If you would like to publish a preset to use it on multiple websites or share it with your friends you can do like so.
+
+1. Pick a name for the package => for this example we take `fire-theme`.
+2. Create a new folder `fire-theme`
+3. Create a folder `fire-theme/preset` copy `fireTheme.js` from [above](#create-a-preset-config-file) into `preset/fireTheme.js`
+4. Add a 👉 `package.json`
+
+   ```json
+   {
+     "name": "fire-theme",
+     "version": "0.3.0",
+     "description": "Fire Theme for Rocket",
+     "license": "MIT",
+     "type": "module",
+     "exports": {
+       ".": "./index.js",
+       "./preset/": "./preset/"
+     },
+     "files": ["*.js", "preset"],
+     "keywords": ["rocket", "preset"]
+   }
+   ```
+
+5. Add a 👉 `index.js`
+
+   ```js
+   export { fireTheme } from './preset/fireTheme.js';
+   ```
+
+6. Add a 👉 `README.md`
+
+   ````
+   # FireTheme
+
+   This is a theme/preset for [Rocket](https://rocket.modern-web.dev/).
+
+   ## Installation
+
+   ```
+   npm i -D fire-theme
+   ```
+
+   Add it to your 👉 `rocket.config.js`
+
+   ```js
+   import { fireTheme } from 'fire-theme';
+
+   export default {
+     presets: [fireTheme()],
+   };
+   ```
+   ````

docs/guides/presets/overriding.md

@@ -1,4 +1,4 @@
-# Presets >> Overriding presets ||20
+# Presets >> Overriding ||20
 
 All loaded presets will be combined but you can override each file.
 

docs/guides/presets/using-templates.md

@@ -1,3 +1,3 @@
-# Presets >> Using preset templates ||30
+# Presets >> Using templates ||30
 
 Most presetse have specific entry files you can override...

docs/index.11tydata.cjs

@@ -0,0 +1,13 @@
+const { createSocialImage } = require('@rocket/cli');
+
+module.exports = async function () {
+  const socialMediaImage = await createSocialImage({
+    title: 'Rocket',
+    subTitle: 'Static sites with',
+    subTitle2: 'a sprinkle of JavaScript.',
+    footer: 'A Modern Web Product',
+  });
+  return {
+    socialMediaImage,
+  };
+};

package.json

@@ -21,6 +21,7 @@
     "lint": "run-p lint:*",
     "lint:eslint": "eslint --ext .ts,.js,.mjs,.cjs .",
     "lint:prettier": "node node_modules/prettier/bin-prettier.js \"**/*.{ts,js,mjs,cjs,md}\" --check --ignore-path .eslintignore",
+    "lint:rocket": "rocket lint",
     "lint:types": "npm run types",
     "lint:versions": "node scripts/lint-versions.js",
     "postinstall": "npm run setup",
@@ -28,6 +29,7 @@
     "rocket:build": "node packages/cli/src/cli.js build",
     "search": "node packages/cli/src/cli.js search",
     "setup": "npm run setup:ts-configs",
+    "setup:patches": "npx patch-package",
     "setup:ts-configs": "node scripts/generate-ts-configs.mjs",
     "start": "node packages/cli/src/cli.js start",
     "test": "yarn test:node && yarn test:web",
@@ -50,22 +52,22 @@
     "@types/chai": "^4.2.14",
     "@types/fs-extra": "^9.0.6",
     "@types/mocha": "^8.2.0",
-    "@types/node": "^14.14.16",
+    "@types/node": "^14.14.20",
     "@types/sinon": "^9.0.10",
-    "@typescript-eslint/eslint-plugin": "^4.11.1",
-    "@typescript-eslint/parser": "^4.11.1",
-    "@web/test-runner": "^0.11.5",
-    "@web/test-runner-commands": "^0.3.0",
-    "@web/test-runner-playwright": "^0.7.0",
+    "@typescript-eslint/eslint-plugin": "^4.13.0",
+    "@typescript-eslint/parser": "^4.13.0",
+    "@web/test-runner": "^0.12.2",
+    "@web/test-runner-commands": "^0.4.0",
+    "@web/test-runner-playwright": "^0.8.0",
     "chai": "^4.2.0",
     "concurrently": "^5.3.0",
     "copyfiles": "^2.4.1",
     "deepmerge": "^4.2.2",
-    "esbuild": "^0.8.26",
-    "eslint": "^7.16.0",
+    "esbuild": "^0.8.31",
+    "eslint": "^7.17.0",
     "eslint-config-prettier": "^7.1.0",
     "hanbi": "^0.4.1",
-    "husky": "^4.3.6",
+    "husky": "^4.3.7",
     "lint-staged": "^10.5.3",
     "mocha": "^8.2.1",
     "node-fetch": "^2.6.1",
@@ -76,9 +78,9 @@
     "puppeteer": "^5.5.0",
     "remark-emoji": "^2.1.0",
     "rimraf": "^3.0.2",
-    "rollup": "^2.35.1",
+    "rollup": "^2.36.1",
     "rollup-plugin-terser": "^7.0.2",
-    "sinon": "^9.2.2",
+    "sinon": "^9.2.3",
     "ts-node": "^9.1.1",
     "typescript": "^4.1.3"
   },

packages/blog/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @rocket/blog
 
+## 0.2.0
+
+### Minor Changes
+
+- 4858271: Adjust templates for change in `@rocket/eleventy-plugin-mdjs-unified` as it now returns html directly instead of an object with html, js, stories
+
 ## 0.1.1
 
 ### Patch Changes

packages/blog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocket/blog",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "publishConfig": {
     "access": "public"
   },

packages/blog/preset/_includes/blog-details.njk

@@ -49,7 +49,7 @@
     {% endif %}
     {% include 'partials/addTitleHeadline.njk' %}
 
-    {{ content.html | safe }}
+    {{ content | safe }}
 
     {% include 'partials/previousNext.njk' %}
     {% include 'partials/blog-content-footer.njk' %}

packages/blog/preset/_includes/blog-overview.njk

@@ -12,7 +12,7 @@
 {% block main %}
   <main class="markdown-body">
     {% include 'partials/addTitleHeadline.njk' %}
-    {{ content.html | safe }}
+    {{ content | safe }}
     <div class="articles">
       {% for post in posts %}
         {% if post.data.published %}

packages/building-rollup/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @rocket/building-rollup
 
+## 0.1.2
+
+### Patch Changes
+
+- 897892d: bump dependencies
+
 ## 0.1.1
 
 ### Patch Changes

packages/building-rollup/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocket/building-rollup",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "publishConfig": {
     "access": "public"
   },
@@ -57,7 +57,7 @@
     "@web/rollup-plugin-html": "^1.4.0",
     "@web/rollup-plugin-import-meta-assets": "^1.0.4",
     "@web/rollup-plugin-polyfills-loader": "^1.0.3",
-    "browserslist": "^4.16.0",
+    "browserslist": "^4.16.1",
     "rollup-plugin-terser": "^7.0.2",
     "rollup-plugin-workbox": "^6.1.0"
   }

packages/check-html-links/CHANGELOG.md

@@ -0,0 +1,13 @@
+# check-html-links
+
+## 0.1.1
+
+### Patch Changes
+
+- eb74110: Add info about how many files and links will be checked
+
+## 0.1.0
+
+### Minor Changes
+
+- cd22231: Initial release

packages/check-html-links/README.md

@@ -0,0 +1,28 @@
+# Check Html Links
+
+A fast checker for broken links/references in html.
+
+## Installation
+
+```
+npm i -D check-html-links
+```
+
+## Usage
+
+```
+npx check-html-links _site
+```
+
+For docs please see our homepage [https://rocket.modern-web.dev/docs/tools/check-html-links/](https://rocket.modern-web.dev/docs/tools/check-html-links/).
+
+## Comparison
+
+Checking the output of [11ty-website](https://github.com/11ty/11ty-website) with 13 missing reference targets (used by 516 links) while checking 501 files. (on January 17, 2021)
+
+| Tool             | Lines printed | Times  | Lang | Dependency Tree |
+| ---------------- | ------------- | ------ | ---- | --------------- |
+| check-html-links | 38            | ~2.5s  | node | 19              |
+| link-checker     | 3000+         | ~11s   | node | 106             |
+| hyperlink        | 68            | 4m 20s | node | 481             |
+| htmltest         | 1000+         | ~0.7s  | GO   | -               |

packages/check-html-links/index.js

@@ -0,0 +1,2 @@
+export { validateFolder } from './src/validateFolder.js';
+export { formatErrors } from './src/formatErrors.js';

packages/check-html-links/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "check-html-links",
+  "version": "0.1.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A fast low dependency checker of html links/references",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/modernweb-dev/rocket.git",
+    "directory": "packages/check-html-links"
+  },
+  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
+  "homepage": "https://rocket.modern-web.dev/docs/tools/check-html-links/",
+  "bin": {
+    "check-html-links": "src/cli.js"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "scripts": {
+    "test": "mocha --timeout 5000 test-node/**/*.test.{js,cjs} test-node/*.test.{js,cjs}",
+    "test:watch": "onchange 'src/**/*.{js,cjs}' 'test-node/**/*.{js,cjs}' -- npm test",
+    "types:copy": "copyfiles \"./types/**/*.d.ts\" dist-types/"
+  },
+  "files": [
+    "*.js",
+    "dist",
+    "dist-types",
+    "src"
+  ],
+  "dependencies": {
+    "chalk": "^4.0.0",
+    "glob": "^7.0.0",
+    "sax-wasm": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/glob": "^7.0.0"
+  },
+  "types": "dist-types/index.d.ts"
+}

packages/check-html-links/src/cli.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+
+import path from 'path';
+import chalk from 'chalk';
+import { validateFiles } from './validateFolder.js';
+import { formatErrors } from './formatErrors.js';
+import { listFiles } from './listFiles.js';
+
+async function main() {
+  const userRootDir = process.argv[2];
+  const rootDir = userRootDir ? path.resolve(userRootDir) : process.cwd();
+  const performanceStart = process.hrtime();
+
+  console.log('👀 Checking if all internal links work...');
+  const files = await listFiles('**/*.html', rootDir);
+
+  const filesOutput =
+    files.length == 0
+      ? '🧐 No files to check. Did you select the correct folder?'
+      : `🔥 Found a total of ${chalk.green.bold(files.length)} files to check!`;
+  console.log(filesOutput);
+
+  const { errors, numberLinks } = await validateFiles(files, rootDir);
+
+  console.log(`🔗 Found a total of ${chalk.green.bold(numberLinks)} links to validate!\n`);
+
+  const performance = process.hrtime(performanceStart);
+  if (errors.length > 0) {
+    let referenceCount = 0;
+    for (const error of errors) {
+      referenceCount += error.usage.length;
+    }
+    const output = [
+      `❌ Found ${chalk.red.bold(
+        errors.length.toString(),
+      )} missing reference targets (used by ${referenceCount} links) while checking ${
+        files.length
+      } files:`,
+      ...formatErrors(errors)
+        .split('\n')
+        .map(line => `  ${line}`),
+      `Checking links duration: ${performance[0]}s ${performance[1] / 1000000}ms`,
+    ];
+    console.error(output.join('\n'));
+    process.exit(1);
+  } else {
+    console.log(
+      `✅ All internal links are valid. (executed in %ds %dms)`,
+      performance[0],
+      performance[1] / 1000000,
+    );
+  }
+}
+
+main();

packages/check-html-links/src/formatErrors.js

@@ -0,0 +1,46 @@
+import path from 'path';
+import chalk from 'chalk';
+
+/** @typedef {import('../types/main').Error} Error */
+
+/**
+ * @param {Error[]} errors
+ * @param {*} relativeFrom
+ */
+export function formatErrors(errors, relativeFrom = process.cwd()) {
+  let output = [];
+  let number = 0;
+  for (const error of errors) {
+    number += 1;
+    const filePath = path.relative(relativeFrom, error.filePath);
+    if (error.onlyAnchorMissing === true) {
+      output.push(
+        `${number}. missing ${chalk.red.bold(
+          `id="${error.usage[0].anchor}"`,
+        )} in ${chalk.cyanBright(filePath)}`,
+      );
+    } else {
+      const firstAttribute = error.usage[0].attribute;
+      const title =
+        firstAttribute === 'src' || firstAttribute === 'srcset' ? 'file' : 'reference target';
+
+      output.push(`${number}. missing ${title} ${chalk.red.bold(filePath)}`);
+    }
+    const usageLength = error.usage.length;
+
+    for (let i = 0; i < 3 && i < usageLength; i += 1) {
+      const usage = error.usage[i];
+      const usagePath = path.relative(relativeFrom, usage.file);
+      const clickAbleLink = chalk.cyanBright(`${usagePath}:${usage.line + 1}:${usage.character}`);
+      const attributeStart = chalk.gray(`${usage.attribute}="`);
+      const attributeEnd = chalk.gray('"');
+      output.push(`  from ${clickAbleLink} via ${attributeStart}${usage.value}${attributeEnd}`);
+    }
+    if (usageLength > 3) {
+      const more = chalk.red((usageLength - 3).toString());
+      output.push(`  ... ${more} more references to this target`);
+    }
+    output.push('');
+  }
+  return output.join('\n');
+}

packages/check-html-links/src/listFiles.js

@@ -0,0 +1,35 @@
+import fs from 'fs';
+import path from 'path';
+
+import glob from 'glob';
+
+/**
+ * Lists all files using the specified glob, starting from the given root directory.
+ *
+ * Will return all matching file paths fully resolved.
+ *
+ * @param {string} fromGlob
+ * @param {string} rootDir
+ */
+export function listFiles(fromGlob, rootDir) {
+  return new Promise(resolve => {
+    glob(
+      fromGlob,
+      { cwd: rootDir },
+      /**
+       * @param {Error | null} er
+       * @param {string[]} files
+       */
+      (er, files) => {
+        // remember, each filepath returned is relative to rootDir
+        resolve(
+          files
+            // fully resolve the filename relative to rootDir
+            .map(filePath => path.resolve(rootDir, filePath))
+            // filter out directories
+            .filter(filePath => !fs.lstatSync(filePath).isDirectory()),
+        );
+      },
+    );
+  });
+}

packages/check-html-links/src/validateFolder.js

@@ -0,0 +1,289 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+import fs from 'fs';
+import saxWasm from 'sax-wasm';
+import { createRequire } from 'module';
+
+import { listFiles } from './listFiles.js';
+import path from 'path';
+
+/** @typedef {import('../types/main').Link} Link */
+/** @typedef {import('../types/main').LocalFile} LocalFile */
+/** @typedef {import('../types/main').Usage} Usage */
+/** @typedef {import('../types/main').Error} Error */
+/** @typedef {import('sax-wasm').Attribute} Attribute */
+
+const require = createRequire(import.meta.url);
+const { SaxEventType, SAXParser } = saxWasm;
+
+const saxPath = require.resolve('sax-wasm/lib/sax-wasm.wasm');
+const saxWasmBuffer = fs.readFileSync(saxPath);
+const parserReferences = new SAXParser(SaxEventType.Attribute);
+const parserIds = new SAXParser(SaxEventType.Attribute /*, { highWaterMark: 256 * 1024 } */);
+
+/** @type {Error[]} */
+let checkLocalFiles = [];
+
+/** @type {Error[]} */
+let errors = [];
+
+/** @type {Map<string, string[]>} */
+let idCache = new Map();
+
+/**
+ * @param {string} htmlFilePath
+ */
+function extractReferences(htmlFilePath) {
+  /** @type {Link[]} */
+  const links = [];
+  /** @type {string[]} */
+  const ids = [];
+  parserReferences.eventHandler = (ev, _data) => {
+    if (ev === SaxEventType.Attribute) {
+      const data = /** @type {Attribute} */ (/** @type {any} */ (_data));
+      const attributeName = data.name.toString();
+      const value = data.value.toString();
+      const entry = {
+        attribute: attributeName,
+        value,
+        htmlFilePath,
+        ...data.value.start,
+      };
+      if (attributeName === 'href' || attributeName === 'src') {
+        links.push(entry);
+      }
+      if (attributeName === 'srcset') {
+        if (value.includes(',')) {
+          const srcsets = value.split(',').map(el => el.trim());
+          for (const srcset of srcsets) {
+            if (srcset.includes(' ')) {
+              const srcsetParts = srcset.split(' ');
+              links.push({ ...entry, value: srcsetParts[0] });
+            } else {
+              links.push({ ...entry, value: srcset });
+            }
+          }
+        } else if (value.includes(' ')) {
+          const srcsetParts = value.split(' ');
+          links.push({ ...entry, value: srcsetParts[0] });
+        } else {
+          links.push(entry);
+        }
+      }
+      if (attributeName === 'id') {
+        ids.push(value);
+      }
+    }
+  };
+
+  return new Promise(resolve => {
+    const readable = fs.createReadStream(htmlFilePath);
+    readable.on('data', chunk => {
+      // @ts-expect-error
+      parserReferences.write(chunk);
+    });
+    readable.on('end', () => {
+      parserReferences.end();
+      idCache.set(htmlFilePath, ids);
+      resolve({ links });
+    });
+  });
+}
+
+/**
+ * @param {string} filePath
+ * @param {string} id
+ */
+function idExists(filePath, id) {
+  if (idCache.has(filePath)) {
+    const cachedIds = idCache.get(filePath);
+    // return cachedIds.includes(id);
+    return new Promise(resolve => resolve(cachedIds?.includes(id)));
+  }
+
+  /** @type {string[]} */
+  const ids = [];
+  parserIds.eventHandler = (ev, _data) => {
+    const data = /** @type {Attribute} */ (/** @type {any} */ (_data));
+    if (ev === SaxEventType.Attribute) {
+      if (data.name.toString() === 'id') {
+        ids.push(data.value.toString());
+      }
+    }
+  };
+
+  return new Promise(resolve => {
+    const readable = fs.createReadStream(filePath);
+    readable.on('data', chunk => {
+      // @ts-expect-error
+      parserIds.write(chunk);
+    });
+    readable.on('end', () => {
+      parserIds.end();
+      idCache.set(filePath, ids);
+      resolve(ids.includes(id));
+    });
+  });
+}
+
+/**
+ * @param {string} filePath
+ * @param {string} anchor
+ * @param {Usage} usageObj
+ */
+function addLocalFile(filePath, anchor, usageObj) {
+  const foundIndex = checkLocalFiles.findIndex(item => {
+    return item.filePath === filePath;
+  });
+
+  if (foundIndex === -1) {
+    checkLocalFiles.push({
+      filePath,
+      onlyAnchorMissing: false,
+      usage: [usageObj],
+    });
+  } else {
+    checkLocalFiles[foundIndex].usage.push(usageObj);
+  }
+}
+
+/**
+ * @param {string} inValue
+ */
+function getValueAndAnchor(inValue) {
+  let value = inValue.replace(/&#/g, '--__check-html-links__--');
+  let anchor = '';
+
+  if (value.includes('#')) {
+    [value, anchor] = value.split('#');
+  }
+  if (value.includes('?')) {
+    value = value.split('?')[0];
+  }
+  if (anchor.includes(':~:')) {
+    anchor = anchor.split(':~:')[0];
+  }
+  if (value.includes(':~:')) {
+    value = value.split(':~:')[0];
+  }
+
+  value = value.replace(/--__check-html-links__--/g, '&#');
+  anchor = anchor.replace(/--__check-html-links__--/g, '&#');
+  value = value.trim();
+  anchor = anchor.trim();
+
+  return {
+    value,
+    anchor,
+  };
+}
+
+/**
+ *
+ * @param {Link[]} links
+ * @param {object} options
+ * @param {string} options.htmlFilePath
+ * @param {string} options.rootDir
+ */
+async function resolveLinks(links, { htmlFilePath, rootDir }) {
+  for (const hrefObj of links) {
+    const { value, anchor } = getValueAndAnchor(hrefObj.value);
+
+    const usageObj = {
+      attribute: hrefObj.attribute,
+      value: hrefObj.value,
+      file: htmlFilePath,
+      line: hrefObj.line,
+      character: hrefObj.character,
+      anchor,
+    };
+
+    let valueFile = value.endsWith('/') ? path.join(value, 'index.html') : value;
+
+    if (value.includes('mailto:')) {
+      // ignore for now - could add a check to validate if the email address is valid
+    } else if (valueFile === '' && anchor !== '') {
+      addLocalFile(htmlFilePath, anchor, usageObj);
+    } else if (value.startsWith('//') || value.startsWith('http')) {
+      // TODO: handle external urls
+      // external url - we do not handle that (yet)
+    } else if (value.startsWith('/')) {
+      const filePath = path.join(rootDir, valueFile);
+      addLocalFile(filePath, anchor, usageObj);
+    } else if (value === '' && anchor === '') {
+      // no need to check it
+    } else {
+      const filePath = path.join(path.dirname(htmlFilePath), valueFile);
+      addLocalFile(filePath, anchor, usageObj);
+    }
+  }
+
+  return { checkLocalFiles: [...checkLocalFiles] };
+}
+
+/**
+ *
+ * @param {Error[]} checkLocalFiles
+ */
+async function validateLocalFiles(checkLocalFiles) {
+  for (const localFileObj of checkLocalFiles) {
+    if (
+      !fs.existsSync(localFileObj.filePath) ||
+      fs.lstatSync(localFileObj.filePath).isDirectory()
+    ) {
+      errors.push(localFileObj);
+    } else {
+      for (let i = 0; i < localFileObj.usage.length; i += 1) {
+        const usage = localFileObj.usage[i];
+        if (usage.anchor === '') {
+          localFileObj.usage.splice(i, 1);
+          i -= 1;
+        } else {
+          const isValidAnchor = await idExists(localFileObj.filePath, usage.anchor);
+          if (isValidAnchor) {
+            localFileObj.usage.splice(i, 1);
+            i -= 1;
+          }
+        }
+      }
+      if (localFileObj.usage.length > 0) {
+        if (localFileObj.usage.length === 1 && localFileObj.usage[0].anchor) {
+          localFileObj.onlyAnchorMissing = true;
+        }
+        errors.push(localFileObj);
+      }
+    }
+  }
+  return errors;
+}
+
+/**
+ * @param {string[]} files
+ * @param {string} rootDir
+ */
+export async function validateFiles(files, rootDir) {
+  await parserReferences.prepareWasm(saxWasmBuffer);
+  await parserIds.prepareWasm(saxWasmBuffer);
+
+  errors = [];
+  checkLocalFiles = [];
+  idCache = new Map();
+  let numberLinks = 0;
+  for (const htmlFilePath of files) {
+    const { links } = await extractReferences(htmlFilePath);
+    numberLinks += links.length;
+    await resolveLinks(links, { htmlFilePath, rootDir });
+  }
+  await validateLocalFiles(checkLocalFiles);
+
+  return { errors: errors, numberLinks: numberLinks };
+}
+
+/**
+ * @param {string} inRootDir
+ */
+export async function validateFolder(inRootDir) {
+  const rootDir = path.resolve(inRootDir);
+  const files = await listFiles('**/*.html', rootDir);
+  const { errors } = await validateFiles(files, rootDir);
+  return errors;
+}

packages/check-html-links/test-node/fixtures/internal-images/index.html

@@ -0,0 +1,11 @@
+<img src="/missing.png" alt="" />
+<img src="./missing.png" alt="" />
+<img src="/absolute/missing.png" alt="" />
+<img src="./relative/missing.png" alt="" />
+
+<!-- valid -->
+<img src="/empty.png" alt="" />
+<img src="./empty.png" alt="" />
+<img src="./empty.png " alt="" />
+<img src=" ./empty.png " alt="" />
+<img src="./empty.png?data=in&query=params" alt="" />

packages/check-html-links/test-node/fixtures/internal-link-anchor/index.html

@@ -0,0 +1,16 @@
+<a href="./page.html"></a>
+<a href="./page.html#first-headline"></a>
+<a href="./page.html#missing-headline"></a>
+<a href="./missing-page.html#missing-headline"></a>
+<a href="#local"></a>
+<a href="#local-missing"></a>
+
+<p id="local"></p>
+
+<a href="#audit-your-angular-app&#39;s-accessibility-with-codelyzer">
+  Audit your Angular app's accessibility with codelyzer
+</a>
+
+<h1 id="audit-your-angular-app&#39;s-accessibility-with-codelyzer">Audit your Angular app's accessibility with codelyzer</h1>
+
+<a href="#local:~:text=put%20your%20labels%20above%20your%20inputs">Sign-in form best practices</a>

packages/check-html-links/test-node/fixtures/internal-link-anchor/page.html

@@ -0,0 +1 @@
+<h1 id="first-headline">First Headline</h1>

packages/check-html-links/test-node/fixtures/internal-link-folder/index.html

@@ -0,0 +1,4 @@
+<a href="./page/index.html"></a>
+<a href="./page/#my-anchor"></a>
+<a href="./missing-folder/"></a>
+<a href="./missing-folder/#my-anchor"></a>

packages/check-html-links/test-node/fixtures/internal-link-folder/page/index.html

@@ -0,0 +1 @@
+<p id="my-anchor"></p>

packages/check-html-links/test-node/fixtures/internal-link/index.html

@@ -0,0 +1,12 @@
+<a href="/absolute/index.html"></a>
+<a href="./relative/index.html"></a>
+
+<!-- valid -->
+<a href="./page.html"></a>
+<a href=" ./page.html "></a>
+<a href=" /page.html "></a>
+<a href="//domain.com/something/"></a>
+<a href="http://domain.com/something/"></a>
+<a href="https://domain.com/something/"></a>
+<a href=""></a>
+<a href=":~:text=put%20your%20labels%20above%20your%20inputs">Sign-in form best practices</a>

packages/check-html-links/test-node/fixtures/internal-link/page.html

@@ -0,0 +1,2 @@
+<a href="/absolute-page/index.html">absolute page</a>
+<a href="./relative-page/index.html">relative page</a>

packages/check-html-links/test-node/fixtures/internal-links-to-same-file/index.html

@@ -0,0 +1,3 @@
+<a href="/foo"></a>
+<a href="./foo"></a>
+<a href="./foo#my-anchor"></a>

packages/check-html-links/test-node/fixtures/internal-pictures/index.html

@@ -0,0 +1,9 @@
+<picture>
+  <source srcset="/images/empty-300.png 300w, /images/empty-600.png?data=in&query=params 600w" type="image/jpeg" sizes="(min-width: 62.5em) 25vw, (min-width: 30.625em) 50vw, 100vw">
+  <img src="/images/empty.png" alt="Empty" width="300" height="225">
+</picture>
+
+<picture>
+  <source srcset="/images/missing-300.png 300w, /images/missing-600.png 600w" type="image/jpeg" sizes="(min-width: 62.5em) 25vw, (min-width: 30.625em) 50vw, 100vw">
+  <img src="/images/missing.png" alt="Empty" width="300" height="225">
+</picture>

packages/check-html-links/test-node/fixtures/mailto/index.html

@@ -0,0 +1 @@
+<a href="mailto:foo@bar.com"></a>

packages/check-html-links/test-node/fixtures/test-case/about/index.html

@@ -0,0 +1,7 @@
+<a href="../price/"></a>
+
+<img src="./images/team.png" />
+
+<footer>
+  <a href="/aboot"></a>
+</footer>

packages/check-html-links/test-node/fixtures/test-case/history/index.html

@@ -0,0 +1,5 @@
+<a href="/price/#my-teams"></a>
+
+<footer>
+  <a href="/aboot"></a>
+</footer>

packages/check-html-links/test-node/fixtures/test-case/index.html

@@ -0,0 +1,5 @@
+<a href="./prce"></a>
+
+<footer>
+  <a href="/aboot"></a>
+</footer>

packages/check-html-links/test-node/fixtures/test-case/price/corporate/index.html

@@ -0,0 +1,3 @@
+<footer>
+  <a href="/aboot"></a>
+</footer>

packages/check-html-links/test-node/fixtures/test-case/price/index.html

@@ -0,0 +1,7 @@
+<h1 id="overview"></h1>
+
+<h2 id="teams"></h2>
+
+<footer>
+  <a href="/aboot"></a>
+</footer>

packages/check-html-links/test-node/formatErrors.test.js

@@ -0,0 +1,38 @@
+import chai from 'chai';
+import chalk from 'chalk';
+import { execute } from './test-helpers.js';
+import { formatErrors } from 'check-html-links';
+
+const { expect } = chai;
+
+async function executeAndFormat(inPath) {
+  const { errors, cleanup } = await execute(inPath);
+  return formatErrors(cleanup(errors));
+}
+
+describe('formatErrors', () => {
+  before(() => {
+    // ignore colors in tests as most CIs won't support it
+    chalk.level = 0;
+  });
+
+  it('prints a nice summery', async () => {
+    const result = await executeAndFormat('fixtures/test-case');
+    expect(result.trim().split('\n')).to.deep.equal([
+      '1. missing id="my-teams" in fixtures/test-case/price/index.html',
+      '  from fixtures/test-case/history/index.html:1:9 via href="/price/#my-teams"',
+      '',
+      '2. missing file fixtures/test-case/about/images/team.png',
+      '  from fixtures/test-case/about/index.html:3:10 via src="./images/team.png"',
+      '',
+      '3. missing reference target fixtures/test-case/aboot',
+      '  from fixtures/test-case/about/index.html:6:11 via href="/aboot"',
+      '  from fixtures/test-case/history/index.html:4:11 via href="/aboot"',
+      '  from fixtures/test-case/index.html:4:11 via href="/aboot"',
+      '  ... 2 more references to this target',
+      '',
+      '4. missing reference target fixtures/test-case/prce',
+      '  from fixtures/test-case/index.html:1:9 via href="./prce"',
+    ]);
+  });
+});

packages/check-html-links/test-node/test-helpers.js

@@ -0,0 +1,28 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+import { validateFolder } from 'check-html-links';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export async function execute(inPath) {
+  const testDir = path.join(__dirname, inPath.split('/').join(path.sep));
+  const errors = await validateFolder(testDir);
+  return {
+    cleanup: items => {
+      const newItems = [];
+      for (const item of items) {
+        newItems.push({
+          ...item,
+          filePath: path.relative(__dirname, item.filePath),
+          usage: item.usage.map(usageObj => ({
+            ...usageObj,
+            file: path.relative(__dirname, usageObj.file),
+          })),
+        });
+      }
+      return newItems;
+    },
+    errors,
+  };
+}

packages/check-html-links/test-node/validateFolder.test.js

@@ -0,0 +1,289 @@
+import chai from 'chai';
+import { execute } from './test-helpers.js';
+
+const { expect } = chai;
+
+describe('validateFolder', () => {
+  it('validates internal links', async () => {
+    const { errors, cleanup } = await execute('fixtures/internal-link');
+    expect(cleanup(errors)).to.deep.equal([
+      {
+        filePath: 'fixtures/internal-link/absolute/index.html',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'href',
+            value: '/absolute/index.html',
+            file: 'fixtures/internal-link/index.html',
+            line: 0,
+            character: 9,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-link/relative/index.html',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'href',
+            value: './relative/index.html',
+            file: 'fixtures/internal-link/index.html',
+            line: 1,
+            character: 9,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-link/absolute-page/index.html',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'href',
+            value: '/absolute-page/index.html',
+            file: 'fixtures/internal-link/page.html',
+            line: 0,
+            character: 9,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-link/relative-page/index.html',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'href',
+            value: './relative-page/index.html',
+            file: 'fixtures/internal-link/page.html',
+            line: 1,
+            character: 9,
+          },
+        ],
+      },
+    ]);
+  });
+
+  it('groups multiple usage of the same missing file', async () => {
+    const { errors, cleanup } = await execute('fixtures/internal-links-to-same-file');
+    expect(cleanup(errors)).to.deep.equal([
+      {
+        filePath: 'fixtures/internal-links-to-same-file/foo',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            attribute: 'href',
+            value: '/foo',
+            anchor: '',
+            file: 'fixtures/internal-links-to-same-file/index.html',
+            line: 0,
+            character: 9,
+          },
+          {
+            attribute: 'href',
+            value: './foo',
+            anchor: '',
+            file: 'fixtures/internal-links-to-same-file/index.html',
+            line: 1,
+            character: 9,
+          },
+          {
+            attribute: 'href',
+            value: './foo#my-anchor',
+            anchor: 'my-anchor',
+            file: 'fixtures/internal-links-to-same-file/index.html',
+            line: 2,
+            character: 9,
+          },
+        ],
+      },
+    ]);
+  });
+
+  it('validates that ids of anchors exist', async () => {
+    const { errors, cleanup } = await execute('fixtures/internal-link-anchor');
+    expect(cleanup(errors)).to.deep.equal([
+      {
+        filePath: 'fixtures/internal-link-anchor/page.html',
+        onlyAnchorMissing: true,
+        usage: [
+          {
+            attribute: 'href',
+            value: './page.html#missing-headline',
+            anchor: 'missing-headline',
+            file: 'fixtures/internal-link-anchor/index.html',
+            line: 2,
+            character: 9,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-link-anchor/missing-page.html',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            attribute: 'href',
+            value: './missing-page.html#missing-headline',
+            anchor: 'missing-headline',
+            file: 'fixtures/internal-link-anchor/index.html',
+            line: 3,
+            character: 9,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-link-anchor/index.html',
+        onlyAnchorMissing: true,
+        usage: [
+          {
+            attribute: 'href',
+            value: '#local-missing',
+            anchor: 'local-missing',
+            file: 'fixtures/internal-link-anchor/index.html',
+            line: 5,
+            character: 9,
+          },
+        ],
+      },
+    ]);
+  });
+
+  it('can handle urls that end with a /', async () => {
+    const { errors, cleanup } = await execute('fixtures/internal-link-folder');
+    expect(cleanup(errors)).to.deep.equal([
+      {
+        filePath: 'fixtures/internal-link-folder/missing-folder/index.html',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'href',
+            value: './missing-folder/',
+            file: 'fixtures/internal-link-folder/index.html',
+            line: 2,
+            character: 9,
+          },
+          {
+            anchor: 'my-anchor',
+            attribute: 'href',
+            value: './missing-folder/#my-anchor',
+            file: 'fixtures/internal-link-folder/index.html',
+            line: 3,
+            character: 9,
+          },
+        ],
+      },
+    ]);
+  });
+
+  it('ignores mailto links', async () => {
+    const { errors, cleanup } = await execute('fixtures/mailto');
+    expect(cleanup(errors)).to.deep.equal([]);
+  });
+
+  it('can handle img src', async () => {
+    const { errors, cleanup } = await execute('fixtures/internal-images');
+    expect(cleanup(errors)).to.deep.equal([
+      {
+        filePath: 'fixtures/internal-images/missing.png',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'src',
+            value: '/missing.png',
+            file: 'fixtures/internal-images/index.html',
+            line: 0,
+            character: 10,
+          },
+          {
+            anchor: '',
+            attribute: 'src',
+            character: 10,
+            file: 'fixtures/internal-images/index.html',
+            line: 1,
+            value: './missing.png',
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-images/absolute/missing.png',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'src',
+            character: 10,
+            file: 'fixtures/internal-images/index.html',
+            line: 2,
+            value: '/absolute/missing.png',
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-images/relative/missing.png',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'src',
+            character: 10,
+            file: 'fixtures/internal-images/index.html',
+            line: 3,
+            value: './relative/missing.png',
+          },
+        ],
+      },
+    ]);
+  });
+
+  it('can handle picture source srcset', async () => {
+    const { errors, cleanup } = await execute('fixtures/internal-pictures');
+    expect(cleanup(errors)).to.deep.equal([
+      {
+        filePath: 'fixtures/internal-pictures/images/missing-300.png',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'srcset',
+            value: '/images/missing-300.png',
+            file: 'fixtures/internal-pictures/index.html',
+            line: 6,
+            character: 18,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-pictures/images/missing-600.png',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'srcset',
+            value: '/images/missing-600.png',
+            file: 'fixtures/internal-pictures/index.html',
+            line: 6,
+            character: 18,
+          },
+        ],
+      },
+      {
+        filePath: 'fixtures/internal-pictures/images/missing.png',
+        onlyAnchorMissing: false,
+        usage: [
+          {
+            anchor: '',
+            attribute: 'src',
+            value: '/images/missing.png',
+            file: 'fixtures/internal-pictures/index.html',
+            line: 7,
+            character: 12,
+          },
+        ],
+      },
+    ]);
+  });
+});

packages/check-html-links/tsconfig.json

@@ -0,0 +1,24 @@
+// Don't edit this file directly. It is generated by /scripts/update-package-configs.ts
+
+{
+  "extends": "../../tsconfig.node-base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "outDir": "./dist-types",
+    "rootDir": ".",
+    "composite": true,
+    "allowJs": true,
+    "checkJs": true,
+    "emitDeclarationOnly": true
+  },
+  "references": [],
+  "include": [
+    "src",
+    "*.js",
+    "types"
+  ],
+  "exclude": [
+    "dist",
+    "dist-types"
+  ]
+}

packages/check-html-links/types/main.d.ts

@@ -0,0 +1,27 @@
+export interface Link {
+  value: string;
+  attribute: string;
+  htmlFilePath: string;
+  line: number;
+  character: number;
+}
+
+export interface Usage {
+  attribute: string;
+  value: string;
+  anchor: string;
+  file: string;
+  line: number;
+  character: number;
+}
+
+export interface LocalFile {
+  filePath: string;
+  usage: Usage[];
+}
+
+export interface Error {
+  filePath: string;
+  onlyAnchorMissing: boolean;
+  usage: Usage[];
+}

packages/cli/CHANGELOG.md

@@ -1,5 +1,68 @@
 # @rocket/cli
 
+## 0.4.1
+
+### Patch Changes
+
+- c92769a: Processing links and asset urls to generate the final html output is now utf8 safe
+- 562e91f: Make sure logos do not have "<?xml" in their code
+
+## 0.4.0
+
+### Minor Changes
+
+- 0eb507d: Adds the capability to configure the svg template for the social media images.
+- 0eb507d: Adds `setupEleventyComputedConfig` option to enable configuration of 11ty's `eleventyComputed`. The plugins-manager system is used for it.
+
+## 0.3.1
+
+### Patch Changes
+
+- a498a5d: Make sure links to `*index.md` files are not treated as folder index files like `index.md`
+
+## 0.3.0
+
+### Minor Changes
+
+- cd22231: Restructure and simplify Rocket Cli Plugin System
+
+### Patch Changes
+
+- cd22231: Add a default Rocket Cli Plugin which checks all links on every save (during start) and after a production build
+- Updated dependencies [cd22231]
+- Updated dependencies [cd22231]
+  - @rocket/eleventy-plugin-mdjs-unified@0.3.0
+  - check-html-links@0.1.0
+
+## 0.2.1
+
+### Patch Changes
+
+- 897892d: bump dependencies
+- 295cfbd: Better support for windows paths
+- Updated dependencies [897892d]
+  - @rocket/building-rollup@0.1.2
+  - @rocket/eleventy-rocket-nav@0.2.1
+
+## 0.2.0
+
+### Minor Changes
+
+- ef3b846: Add a default "core" preset to the cli package which provides fundaments like eleventConfig data, eleventyComputed data, logo, site name, simple layout, ...
+- 4858271: Process local relative links and images via html (11ty transform) to support all 11ty template systems
+- 4858271: Adjust templates for change in `@rocket/eleventy-plugin-mdjs-unified` as it now returns html directly instead of an object with html, js, stories
+
+### Patch Changes
+
+- ef3b846: Move setting of title, eleventyNavigation and section page meta data to eleventyComputed
+- ef3b846: Auto create social media images for every page
+- Updated dependencies [ef3b846]
+- Updated dependencies [4858271]
+- Updated dependencies [4858271]
+  - @rocket/core@0.1.1
+  - @rocket/eleventy-plugin-mdjs-unified@0.2.0
+  - @rocket/eleventy-rocket-nav@0.2.0
+
 ## 0.1.4
 
 ### Patch Changes

packages/cli/index.cjs

@@ -1,6 +1,10 @@
 const { setComputedConfig, getComputedConfig } = require('./src/public/computedConfig.cjs');
+const { generateEleventyComputed } = require('./src/public/generateEleventyComputed.cjs');
+const { createSocialImage } = require('./src/public/createSocialImage.cjs');
 
 module.exports = {
   setComputedConfig,
   getComputedConfig,
+  generateEleventyComputed,
+  createSocialImage,
 };

packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rocket/cli",
-  "version": "0.1.4",
+  "version": "0.4.1",
   "publishConfig": {
     "access": "public"
   },
@@ -38,6 +38,7 @@
     "*.mjs",
     "dist",
     "dist-types",
+    "preset",
     "src"
   ],
   "keywords": [
@@ -50,20 +51,23 @@
   ],
   "dependencies": {
     "@11ty/eleventy": "^0.11.1",
-    "@rocket/building-rollup": "^0.1.1",
-    "@rocket/core": "^0.1.0",
-    "@rocket/eleventy-plugin-mdjs-unified": "^0.1.0",
-    "@rocket/eleventy-rocket-nav": "^0.1.0",
+    "@11ty/eleventy-img": "^0.7.4",
+    "@rocket/building-rollup": "^0.1.2",
+    "@rocket/core": "^0.1.1",
+    "@rocket/eleventy-plugin-mdjs-unified": "^0.3.0",
+    "@rocket/eleventy-rocket-nav": "^0.2.1",
     "@rollup/plugin-babel": "^5.2.2",
     "@rollup/plugin-node-resolve": "^11.0.1",
     "@web/config-loader": "^0.1.3",
-    "@web/dev-server": "^0.1.2",
-    "@web/dev-server-rollup": "^0.3.0",
+    "@web/dev-server": "^0.1.4",
+    "@web/dev-server-rollup": "^0.3.2",
     "@web/rollup-plugin-copy": "^0.2.0",
+    "check-html-links": "^0.1.1",
     "command-line-args": "^5.1.1",
     "command-line-usage": "^6.1.1",
     "fs-extra": "^9.0.1",
-    "plugins-manager": "^0.2.0"
+    "plugins-manager": "^0.2.0",
+    "utf8": "^3.0.0"
   },
   "types": "dist-types/index.d.ts"
 }

packages/cli/preset/_assets/logo.svg

@@ -0,0 +1,33 @@
+<svg fill="#e63946" version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+	 viewBox="0 0 511.998 511.998" xml:space="preserve">
+   <g>
+  <path d="M98.649,430.256c-46.365,28.67-71.17,30.939-78.916,23.51c-7.75-7.433-6.519-32.307,20.182-79.832
+    c24.953-44.412,65.374-96.693,113.818-147.211l-11.279-10.817C93.124,267.348,51.871,320.751,26.291,366.279
+    c-19.228,34.22-37.848,79.134-17.375,98.766c5.84,5.6,13.599,7.935,22.484,7.935c22.269,0,51.606-14.677,75.469-29.432
+    c44.416-27.464,96.044-70.919,145.373-122.362l-11.279-10.817C192.517,360.888,141.976,403.464,98.649,430.256z"/>
+
+    <rect x="238.112" y="272.64" transform="matrix(-0.7218 -0.6921 0.6921 -0.7218 237.9094 656.5383)" width="25.589" height="15.628"/>
+
+    <rect x="268.895" y="302.163" transform="matrix(-0.7218 -0.6921 0.6921 -0.7218 270.4774 728.6761)" width="25.589" height="15.628"/>
+
+    <rect x="232.827" y="268.929" transform="matrix(-0.7218 -0.6921 0.6921 -0.7218 297.4719 673.0591)" width="102.364" height="15.628"/>
+  <path d="M500.916,41.287c-7.769,1.59-76.412,16.062-93.897,34.294l-50.728,52.899l-114.703-3.629l-39.198,40.876l79.28,40.569
+    l-21.755,22.687l72.848,69.858l21.755-22.687l43.857,77.51l39.197-40.876l-8.433-114.451l50.727-52.899
+    c17.485-18.234,29.067-87.422,30.331-95.251l1.801-11.169L500.916,41.287z M228.209,161.383l19.842-20.692l93.688,2.964
+    l-48.775,50.864L228.209,161.383z M401.632,327.686l-35.822-63.308l48.776-50.865l6.886,93.482L401.632,327.686z
+      M332.298,276.743l-50.287-48.223L412.89,92.037l50.288,48.223L332.298,276.743z M473.009,128.036l-48.316-46.334
+    c14.54-8.427,44.787-17.217,68.076-22.632C488.336,82.567,480.82,113.155,473.009,128.036z"/>
+
+    <rect x="302.369" y="231.988" transform="matrix(-0.7218 -0.6921 0.6921 -0.7218 384.0262 633.9694)" width="34.12" height="15.628"/>
+
+    <rect x="411.311" y="127.35" transform="matrix(-0.6921 0.7218 -0.7218 -0.6921 807.9747 -74.331)" width="17.061" height="15.628"/>
+
+    <rect x="394.288" y="145.087" transform="matrix(-0.7218 -0.6921 0.6921 -0.7218 586.0206 542.7934)" width="15.628" height="17.06"/>
+
+    <rect x="376.571" y="163.565" transform="matrix(-0.7218 -0.6921 0.6921 -0.7218 542.7271 562.3462)" width="15.628" height="17.06"/>
+
+    <rect x="161.111" y="185.158" transform="matrix(0.7071 0.7071 -0.7071 0.7071 192.1943 -60.3323)" width="15.628" height="33.35"/>
+
+    <rect x="184.683" y="172.695" transform="matrix(0.707 0.7072 -0.7072 0.707 182.4625 -83.9076)" width="15.628" height="11.118"/>
+    </g>
+</svg>

packages/cli/preset/_data/eleventyComputed.cjs

@@ -0,0 +1,5 @@
+const { generateEleventyComputed } = require('@rocket/cli');
+
+module.exports = {
+  ...generateEleventyComputed(),
+};

packages/cli/preset/_data/layout.cjs

@@ -0,0 +1 @@
+module.exports = 'layout.njk';

packages/cli/preset/_data/site.cjs

@@ -0,0 +1,8 @@
+module.exports = function () {
+  return {
+    dir: 'ltr',
+    lang: 'en',
+    name: 'Rocket',
+    description: 'Rocket is the way to build fast static websites with a sprinkle of javascript',
+  };
+};

packages/cli/preset/_includes/layout.njk

@@ -0,0 +1 @@
+{{ content | safe }}

packages/cli/src/RocketBuild.js

@@ -58,21 +58,28 @@ async function productionBuild(config) {
 }
 
 export class RocketBuild {
+  static pluginName = 'RocketBuild';
   commands = ['build'];
 
+  /**
+   * @param {RocketCliOptions} config
+   */
   setupCommand(config) {
     config.watch = false;
+    config.lintInputDir = config.outputDir;
     return config;
   }
 
-  async setup({ config }) {
+  async setup({ config, eleventy }) {
     this.config = {
       emptyOutputDir: true,
       ...config,
     };
+    this.eleventy = eleventy;
   }
 
-  async build() {
+  async buildCommand() {
+    await this.eleventy.write();
     if (this.config.emptyOutputDir) {
       await fs.emptyDir(this.config.outputDir);
     }

packages/cli/src/RocketCli.js

@@ -28,23 +28,15 @@ export class RocketEleventy extends Eleventy {
   }
 
   async write() {
-    /** @type {function} */
-    let finishBuild;
-    this.__rocketCli.updateComplete = new Promise(resolve => {
-      finishBuild = resolve;
-    });
-
     await this.__rocketCli.mergePresets();
-
     await super.write();
     await this.__rocketCli.update();
-    // @ts-ignore
-    finishBuild();
   }
 }
 
 export class RocketCli {
-  updateComplete = new Promise(resolve => resolve(null));
+  /** @type {string[]} */
+  errors = [];
 
   constructor({ argv } = { argv: undefined }) {
     const mainDefinitions = [
@@ -72,7 +64,10 @@ export class RocketCli {
     if (!this.eleventy) {
       const { _inputDirCwdRelative, outputDevDir } = this.config;
 
-      await fs.emptyDir(outputDevDir);
+      // We need to merge before we setup 11ty as the write phase is too late for _data
+      // TODO: find a way so we don't need to double merge
+      await this.mergePresets();
+
       const elev = new RocketEleventy(_inputDirCwdRelative, outputDevDir, this);
       elev.isVerbose = false;
       // 11ty always wants a relative path to cwd - why?
@@ -81,10 +76,6 @@ export class RocketCli {
       elev.setConfigPathOverride(relCwdPathToConfig);
       await elev.init();
 
-      if (this.config.watch) {
-        elev.watch();
-      }
-
       this.eleventy = elev;
     }
   }
@@ -116,48 +107,43 @@ export class RocketCli {
   async run() {
     await this.setup();
 
-    if (this.config) {
-      for (const plugin of this.config.plugins) {
-        if (this.considerPlugin(plugin)) {
-          if (typeof plugin.setupCommand === 'function') {
-            this.config = plugin.setupCommand(this.config);
-          }
-
-          if (typeof plugin.setup === 'function') {
-            await plugin.setup({ config: this.config, argv: this.subArgv });
-          }
-        }
+    for (const plugin of this.config.plugins) {
+      if (this.considerPlugin(plugin) && typeof plugin.setupCommand === 'function') {
+        this.config = plugin.setupCommand(this.config);
       }
     }
 
-    await this.mergePresets();
+    await fs.emptyDir(this.config.outputDevDir);
     await this.setupEleventy();
 
-    if (this.config) {
-      await this.updateComplete;
-
-      for (const plugin of this.config.plugins) {
-        if (this.considerPlugin(plugin) && typeof plugin.execute === 'function') {
-          await plugin.execute();
-        }
+    for (const plugin of this.config.plugins) {
+      if (typeof plugin.setup === 'function') {
+        await plugin.setup({ config: this.config, argv: this.subArgv, eleventy: this.eleventy });
       }
+    }
 
-      if (this.config.watch === false && this.eleventy) {
-        await this.eleventy.write();
+    // execute the actual command
+    let executedAtLeastOneCommand = false;
+    const commandFn = `${this.config.command}Command`;
+    for (const plugin of this.config.plugins) {
+      if (this.considerPlugin(plugin) && typeof plugin[commandFn] === 'function') {
+        console.log(`Rocket executes ${commandFn} of ${plugin.constructor.pluginName}`);
+        executedAtLeastOneCommand = true;
+        await plugin[commandFn]();
       }
+    }
+    if (executedAtLeastOneCommand === false) {
+      throw new Error(`No Rocket Cli Plugin had a ${commandFn} function.`);
+    }
 
-      // Build Phase
-      if (this.config.command === 'build') {
-        for (const plugin of this.config.plugins) {
-          if (typeof plugin.build === 'function') {
-            await plugin.build();
-          }
-        }
+    for (const plugin of this.config.plugins) {
+      if (this.considerPlugin(plugin) && typeof plugin.postCommand === 'function') {
+        await plugin.postCommand();
       }
+    }
 
-      if (this.config.command === 'help') {
-        console.log('Help is here: use build or start');
-      }
+    if (this.config.command === 'help') {
+      console.log('Help is here: use build or start');
     }
   }
 
@@ -213,7 +199,7 @@ export class RocketCli {
     setComputedConfig({});
     if (this.eleventy) {
       this.eleventy.finish();
-      // this.eleventy.stopWatch();
+      // await this.eleventy.stopWatch();
     }
     this.stop();
   }

packages/cli/src/RocketLint.js

@@ -0,0 +1,91 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+
+/** @typedef {import('../types/main').RocketCliOptions} RocketCliOptions */
+
+import chalk from 'chalk';
+import { validateFolder, formatErrors } from 'check-html-links';
+
+export class RocketLint {
+  static pluginName = 'RocketLint';
+  commands = ['start', 'build', 'lint'];
+
+  /**
+   * @param {RocketCliOptions} config
+   */
+  setupCommand(config) {
+    if (config.command === 'lint') {
+      config.watch = false;
+    }
+    return config;
+  }
+
+  /**
+   * @param {object} options
+   * @param {RocketCliOptions} options.config
+   * @param {any} options.argv
+   */
+  async setup({ config, argv, eleventy }) {
+    this.__argv = argv;
+    this.config = {
+      lintInputDir: config.outputDevDir,
+      lintExecutesEleventyBefore: true,
+      ...config,
+    };
+    this.eleventy = eleventy;
+  }
+
+  async lintCommand() {
+    if (this.config.lintExecutesEleventyBefore) {
+      await this.eleventy.write();
+      // updated will trigger linting
+    } else {
+      await this.__lint();
+    }
+  }
+
+  async __lint() {
+    if (this.config?.pathPrefix) {
+      console.log('INFO: RocketLint currently does not support being used with a pathPrefix');
+      return;
+    }
+
+    const performanceStart = process.hrtime();
+    console.log('👀 Checking if all internal links work...');
+    const errors = await validateFolder(this.config.lintInputDir);
+    const performance = process.hrtime(performanceStart);
+    if (errors.length > 0) {
+      let referenceCount = 0;
+      for (const error of errors) {
+        referenceCount += error.usage.length;
+      }
+      const output = [
+        `❌ Found ${chalk.red.bold(
+          errors.length.toString(),
+        )} missing reference targets (used by ${referenceCount} links):`,
+        ...formatErrors(errors)
+          .split('\n')
+          .map(line => `  ${line}`),
+        `Checking links duration: ${performance[0]}s ${performance[1] / 1000000}ms`,
+      ];
+      if (this.config.watch) {
+        console.log(output.join('\n'));
+      } else {
+        throw new Error(output.join('\n'));
+      }
+    } else {
+      console.log('✅ All internal links are valid.');
+    }
+  }
+
+  async postCommand() {
+    if (this.config.watch === false) {
+      await this.__lint();
+    }
+  }
+
+  async updated() {
+    if (this.config.watch === true) {
+      await this.__lint();
+    }
+  }
+}

packages/cli/src/RocketStart.js

@@ -7,6 +7,7 @@ import { metaConfigToWebDevServerConfig } from 'plugins-manager';
 /** @typedef {import('@web/dev-server').DevServerConfig} DevServerConfig */
 
 export class RocketStart {
+  static pluginName = 'RocketStart';
   commands = ['start'];
 
   /**
@@ -22,7 +23,7 @@ export class RocketStart {
    * @param {RocketCliOptions} options.config
    * @param {any} options.argv
    */
-  async setup({ config, argv }) {
+  async setup({ config, argv, eleventy }) {
     this.__argv = argv;
     this.config = {
       ...config,
@@ -30,13 +31,20 @@ export class RocketStart {
         ...config.devServer,
       },
     };
+    this.eleventy = eleventy;
   }
 
-  async execute() {
+  async startCommand() {
     if (!this.config) {
       return;
     }
 
+    if (this.config.watch) {
+      await this.eleventy.watch();
+    } else {
+      await this.eleventy.write();
+    }
+
     /** @type {DevServerConfig} */
     const devServerConfig = metaConfigToWebDevServerConfig(
       {

packages/cli/src/eleventy-plugins/processLocalReferences.cjs

@@ -0,0 +1,221 @@
+const fs = require('fs');
+const path = require('path');
+const utf8 = require('utf8');
+const { SaxEventType, SAXParser } = require('sax-wasm');
+
+const saxPath = require.resolve('sax-wasm/lib/sax-wasm.wasm');
+const saxWasmBuffer = fs.readFileSync(saxPath);
+
+/** @typedef {import('./types').NavigationNode} NavigationNode */
+/** @typedef {import('./types').Heading} Heading */
+/** @typedef {import('./types').SaxData} SaxData */
+
+// Instantiate
+const parser = new SAXParser(
+  SaxEventType.Attribute,
+  { highWaterMark: 256 * 1024 }, // 256k chunks
+);
+parser.prepareWasm(saxWasmBuffer);
+
+/**
+ * @param {string} link
+ */
+function isRelativeLink(link) {
+  if (link.startsWith('http') || link.startsWith('/')) {
+    return false;
+  }
+  return true;
+}
+
+const templateEndings = [
+  '.html',
+  '.md',
+  '.11ty.js',
+  '.liquid',
+  '.njk',
+  '.hbs',
+  '.mustache',
+  '.ejs',
+  '.haml',
+  '.pug',
+];
+
+function isTemplateFile(href) {
+  for (const templateEnding of templateEndings) {
+    if (href.endsWith(templateEnding)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+function isIndexTemplateFile(href) {
+  const hrefParsed = path.parse(href);
+  const indexTemplateEndings = templateEndings.map(ending => `index${ending}`);
+
+  for (const indexTemplateEnding of indexTemplateEndings) {
+    if (hrefParsed.base === indexTemplateEnding) {
+      return true;
+    }
+  }
+  return false;
+}
+
+/**
+ * @param {string} html
+ */
+function extractReferences(html, inputPath) {
+  const _html = html.replace(/\n/g, 'XXXRocketProcessLocalReferencesXXX');
+  const hrefs = [];
+  const assets = [];
+  parser.eventHandler = (ev, _data) => {
+    const data = /** @type {SaxData} */ (/** @type {any} */ (_data));
+    if (ev === SaxEventType.Attribute) {
+      const attributeName = data.name.toString();
+      const value = data.value.toString();
+      const entry = {
+        value,
+        startCharacter: data.value.start.character,
+      };
+      if (attributeName === 'href') {
+        if (isRelativeLink(value)) {
+          hrefs.push(entry);
+        }
+      }
+      if (attributeName === 'src' || attributeName === 'srcset') {
+        if (isRelativeLink(value) && !isIndexTemplateFile(inputPath)) {
+          assets.push(entry);
+        }
+      }
+    }
+  };
+  parser.write(Buffer.from(_html));
+  parser.end();
+
+  return { hrefs, assets };
+}
+
+/**
+ * @param {string} inValue
+ */
+function getValueAndAnchor(inValue) {
+  let value = inValue.replace(/&#/g, '--__check-html-links__--');
+  let anchor = '';
+  let suffix = '';
+
+  if (value.includes('#')) {
+    [value, anchor] = value.split('#');
+    suffix = `#${anchor}`;
+  }
+  if (value.includes('?')) {
+    value = value.split('?')[0];
+  }
+  if (anchor.includes(':~:')) {
+    anchor = anchor.split(':~:')[0];
+  }
+  if (value.includes(':~:')) {
+    value = value.split(':~:')[0];
+  }
+
+  value = value.replace(/--__check-html-links__--/g, '&#');
+  anchor = anchor.replace(/--__check-html-links__--/g, '&#');
+  suffix = suffix.replace(/--__check-html-links__--/g, '&#');
+  value = value.trim();
+  anchor = anchor.trim();
+
+  return {
+    value,
+    anchor,
+    suffix,
+  };
+}
+
+function calculateNewHrefs(hrefs, inputPath) {
+  const newHrefs = [];
+  for (const hrefObj of hrefs) {
+    const newHrefObj = { ...hrefObj };
+    const { value: href, suffix } = getValueAndAnchor(hrefObj.value);
+
+    if (isRelativeLink(href) && isTemplateFile(href)) {
+      const hrefParsed = path.parse(href);
+      const dirPart = hrefParsed.dir.length > 1 ? `${hrefParsed.dir}/` : '';
+      newHrefObj.newValue = isIndexTemplateFile(href)
+        ? `${dirPart}${suffix}`
+        : `${dirPart}${hrefParsed.name}/${suffix}`;
+
+      if (isTemplateFile(inputPath)) {
+        if (isIndexTemplateFile(inputPath)) {
+          // nothing
+        } else {
+          newHrefObj.newValue = path.join('../', newHrefObj.newValue);
+        }
+      }
+    }
+
+    if (newHrefObj.newValue) {
+      newHrefs.push(newHrefObj);
+    }
+  }
+  return newHrefs;
+}
+
+function calculateNewAssets(assets) {
+  const newAssets = [...assets];
+  return newAssets.map(assetObj => {
+    assetObj.newValue = path.join('../', assetObj.value);
+    return assetObj;
+  });
+}
+
+function replaceContent(hrefObj, content) {
+  const upToChange = content.slice(0, hrefObj.startCharacter);
+  const afterChange = content.slice(hrefObj.startCharacter + hrefObj.value.length);
+
+  return `${upToChange}${hrefObj.newValue}${afterChange}`;
+}
+
+function sortByStartCharacter(a, b) {
+  if (a.startCharacter > b.startCharacter) {
+    return 1;
+  }
+  if (a.startCharacter < b.startCharacter) {
+    return -1;
+  }
+  return 0;
+}
+
+function applyChanges(_changes, _content) {
+  // make sure changes are sorted as changes affect all other changes afterwards
+  let changes = [..._changes].sort(sortByStartCharacter);
+
+  let content = _content.replace(/\n/g, 'XXXRocketProcessLocalReferencesXXX');
+
+  while (changes.length > 0) {
+    const hrefObj = changes.shift();
+    const diff = hrefObj.newValue.length - hrefObj.value.length;
+
+    content = replaceContent(hrefObj, content);
+
+    changes = changes.map(href => {
+      href.startCharacter = href.startCharacter + diff;
+      return href;
+    });
+  }
+
+  return content.replace(/XXXRocketProcessLocalReferencesXXX/g, '\n');
+}
+
+async function processLocalReferences(_content) {
+  const content = utf8.encode(_content);
+  const inputPath = this.inputPath;
+  const { hrefs, assets } = extractReferences(content, inputPath);
+  const newHrefs = calculateNewHrefs(hrefs, inputPath);
+  const newAssets = calculateNewAssets(assets, inputPath);
+
+  const newContent = applyChanges([...newHrefs, ...newAssets], content);
+  return utf8.decode(newContent);
+}
+
+module.exports = {
+  processLocalReferences,
+};

packages/cli/src/eleventy-plugins/rocketCollections.cjs

@@ -1,7 +1,6 @@
 const path = require('path');
 const fs = require('fs');
 const { readdirSync } = require('fs');
-const { processContentWithTitle } = require('@rocket/core/title');
 
 function getDirectories(source) {
   return readdirSync(source, { withFileTypes: true })
@@ -9,27 +8,6 @@ function getDirectories(source) {
     .map(dirent => dirent.name);
 }
 
-/**
- * adds title from markdown headline to all pages
- *
- * @param collection
- */
-function setTitleForAll(collection) {
-  const all = collection.getAll();
-  all.forEach(page => {
-    page.data.addTitleHeadline = true;
-    const titleData = processContentWithTitle(
-      page.template.inputContent,
-      page.template._templateRender._engineName,
-    );
-    if (titleData) {
-      page.data.title = titleData.title;
-      page.data.eleventyNavigation = { ...titleData.eleventyNavigation };
-      page.data.addTitleHeadline = false;
-    }
-  });
-}
-
 const rocketCollections = {
   configFunction: (eleventyConfig, { _inputDirCwdRelative }) => {
     const sectionNames = getDirectories(_inputDirCwdRelative);
@@ -45,13 +23,8 @@ const rocketCollections = {
           let docs = [
             ...collection.getFilteredByGlob(`${_inputDirCwdRelative}/${section}/**/*.md`),
           ];
-          docs.forEach(page => {
-            page.data.section = section;
-          });
           docs = docs.filter(page => page.inputPath !== `./${indexSection}`);
 
-          // docs = addPrevNextUrls(docs);
-
           return docs;
         });
       }
@@ -71,8 +44,6 @@ const rocketCollections = {
           return aOrder - bOrder;
         });
 
-        setTitleForAll(collection);
-
         return headers;
       });
     }

packages/cli/src/eleventy-plugins/rocketFilters.cjs

@@ -1,5 +1,6 @@
 const path = require('path');
 const fs = require('fs');
+const { processLocalReferences } = require('./processLocalReferences.cjs');
 
 function inlineFilePath(filePath) {
   let data = fs.readFileSync(filePath, function (err, contents) {
@@ -22,6 +23,8 @@ const rocketFilters = {
     });
 
     eleventyConfig.addFilter('inlineFilePath', inlineFilePath);
+
+    eleventyConfig.addTransform('processLocalReferences', processLocalReferences);
   },
 };
 

packages/cli/src/normalizeConfig.js

@@ -13,6 +13,11 @@ import { readConfig } from '@web/config-loader';
 
 import { RocketStart } from './RocketStart.js';
 import { RocketBuild } from './RocketBuild.js';
+import { RocketLint } from './RocketLint.js';
+
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
 /**
  * @param {Partial<RocketCliOptions>} inConfig
@@ -26,13 +31,14 @@ export async function normalizeConfig(inConfig) {
     setupDevPlugins: [],
     setupBuildPlugins: [],
     setupEleventyPlugins: [],
+    setupEleventyComputedConfig: [],
     setupCliPlugins: [],
     eleventy: () => {},
     command: 'help',
     watch: true,
     inputDir: 'docs',
     outputDir: '_site',
-    outputDevDir: path.resolve('_site-dev'),
+    outputDevDir: '_site-dev',
     build: {},
     devServer: {},
 
@@ -75,7 +81,8 @@ export async function normalizeConfig(inConfig) {
   const _configDirCwdRelative = path.relative(process.cwd(), path.resolve(__configDir));
   const _inputDirCwdRelative = path.join(_configDirCwdRelative, config.inputDir);
 
-  config._presetPathes = [];
+  // cli core preset is always first
+  config._presetPathes = [path.join(__dirname, '..', 'preset')];
   for (const preset of config.presets) {
     config._presetPathes.push(preset.path);
 
@@ -100,6 +107,12 @@ export async function normalizeConfig(inConfig) {
         ...preset.setupEleventyPlugins,
       ];
     }
+    if (preset.setupEleventyComputedConfig) {
+      config.setupEleventyComputedConfig = [
+        ...config.setupEleventyComputedConfig,
+        ...preset.setupEleventyComputedConfig,
+      ];
+    }
     if (preset.setupCliPlugins) {
       config.setupCliPlugins = [...config.setupCliPlugins, ...preset.setupCliPlugins];
     }
@@ -109,8 +122,9 @@ export async function normalizeConfig(inConfig) {
 
   /** @type {MetaPlugin[]} */
   let pluginsMeta = [
-    { name: 'rocket-start', plugin: RocketStart },
-    { name: 'rocket-build', plugin: RocketBuild },
+    { name: 'RocketStart', plugin: RocketStart },
+    { name: 'RocketBuild', plugin: RocketBuild },
+    { name: 'RocketLint', plugin: RocketLint },
   ];
 
   if (Array.isArray(config.setupCliPlugins)) {

packages/cli/src/public/createSocialImage.cjs

@@ -0,0 +1,45 @@
+const path = require('path');
+const fs = require('fs');
+const Image = require('@11ty/eleventy-img');
+const { getComputedConfig } = require('./computedConfig.cjs');
+const { createSocialImageSvg: defaultcreateSocialImageSvg } = require('./createSocialImageSvg.cjs');
+
+async function createSocialImage(args) {
+  const {
+    title = '',
+    subTitle = '',
+    footer = '',
+    createSocialImageSvg = defaultcreateSocialImageSvg,
+  } = args;
+  const cleanedUpArgs = { ...args };
+  delete cleanedUpArgs.createSocialImageSvg;
+
+  const rocketConfig = getComputedConfig();
+  const outputDir = path.join(rocketConfig.outputDevDir, '_merged_assets', '11ty-img');
+
+  const logoPath = path.join(rocketConfig._inputDirCwdRelative, '_merged_assets', 'logo.svg');
+
+  const logoBuffer = await fs.promises.readFile(logoPath);
+  const logo = logoBuffer.toString();
+
+  if (logo.includes('<?xml')) {
+    throw new Error('You should not have an "<?xml" tag in your logo.svg');
+  }
+
+  const svgStr = await createSocialImageSvg({ logo, ...args });
+
+  // TODO: cache images for 24h and not only for the given run (using @11ty/eleventy-cache-assets)
+  let stats = await Image(Buffer.from(svgStr), {
+    widths: [1200], // Facebook Opengraph image is 1200 x 630
+    formats: ['png'],
+    outputDir,
+    urlPath: '/_merged_assets/11ty-img/',
+    sourceUrl: `${title}${subTitle}${footer}${logo}`, // This is only used to generate the output filename hash
+  });
+
+  return stats['png'][0].url;
+}
+
+module.exports = {
+  createSocialImage,
+};

packages/cli/src/public/createSocialImageSvg.cjs

@@ -0,0 +1,33 @@
+async function createSocialImageSvg({
+  title = '',
+  subTitle = '',
+  subTitle2 = '',
+  footer = '',
+  logo = '',
+}) {
+  let svgStr = `
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 630">
+      <defs></defs>
+      <rect width="100%" height="100%" fill="#fff" />
+      <circle cx="1000" cy="230" r="530" fill="#ebebeb"></circle>
+      <g transform="matrix(0.6, 0, 0, 0.6, 580, 100)">${logo}</g>
+      <text x="70" y="200" font-family="'Bitstream Vera Sans','Helvetica',sans-serif" font-weight="700" font-size="80">
+        ${title}
+      </text>
+      <text x="70" y="320" font-family="'Bitstream Vera Sans','Helvetica',sans-serif" font-weight="700" font-size="60">
+        ${subTitle}
+      </text>
+      <text x="70" y="420" font-family="'Bitstream Vera Sans','Helvetica',sans-serif" font-weight="700" font-size="60">
+        ${subTitle2}
+      </text>
+      <text x="70" y="560" fill="gray" font-size="40">
+        ${footer}
+      </text>
+    </svg>
+  `;
+  return svgStr;
+}
+
+module.exports = {
+  createSocialImageSvg,
+};

packages/cli/src/public/generateEleventyComputed.cjs

@@ -0,0 +1,116 @@
+const fs = require('fs');
+const { processContentWithTitle } = require('@rocket/core/title');
+const { createSocialImage: defaultcreateSocialImage } = require('./createSocialImage.cjs');
+const { getComputedConfig } = require('./computedConfig.cjs');
+const { executeSetupFunctions } = require('plugins-manager');
+
+function titleMetaPlugin() {
+  return async data => {
+    if (data.titleMeta) {
+      return data.titleMeta;
+    }
+    let text = await fs.promises.readFile(data.page.inputPath);
+    text = text.toString();
+    const titleMetaFromContent = processContentWithTitle(text, 'md');
+    if (titleMetaFromContent) {
+      return titleMetaFromContent;
+    }
+    return {};
+  };
+}
+
+function titlePlugin() {
+  return async data => {
+    if (data.title) {
+      return data.title;
+    }
+    return data.titleMeta?.title;
+  };
+}
+
+function eleventyNavigationPlugin() {
+  return async data => {
+    if (data.eleventyNavigation) {
+      return data.eleventyNavigation;
+    }
+    return data.titleMeta?.eleventyNavigation;
+  };
+}
+
+function sectionPlugin() {
+  return async data => {
+    if (data.section) {
+      return data.section;
+    }
+
+    if (data.page.filePathStem) {
+      // filePathStem: '/sub/subsub/index'
+      // filePathStem: '/index',
+      const parts = data.page.filePathStem.split('/');
+      if (parts.length > 2) {
+        return parts[1];
+      }
+    }
+  };
+}
+
+function socialMediaImagePlugin(args = {}) {
+  const { createSocialImage = defaultcreateSocialImage } = args;
+
+  const cleanedUpArgs = { ...args };
+  delete cleanedUpArgs.createSocialImage;
+
+  return async data => {
+    if (data.socialMediaImage) {
+      return data.socialMediaImage;
+    }
+    if (!data.title) {
+      return;
+    }
+
+    const title = data.titleMeta.parts ? data.titleMeta.parts[0] : '';
+    const subTitle =
+      data.titleMeta.parts && data.titleMeta.parts[1] ? `in ${data.titleMeta.parts[1]}` : '';
+    const section = data.section ? ' ' + data.section[0].toUpperCase() + data.section.slice(1) : '';
+    const footer = `${data.site.name}${section}`;
+
+    const imgUrl = await createSocialImage({
+      title,
+      subTitle,
+      footer,
+      section,
+      ...cleanedUpArgs,
+    });
+    return imgUrl;
+  };
+}
+
+function generateEleventyComputed() {
+  const rocketConfig = getComputedConfig();
+
+  let metaPlugins = [
+    { name: 'titleMeta', plugin: titleMetaPlugin },
+    { name: 'title', plugin: titlePlugin },
+    { name: 'eleventyNavigation', plugin: eleventyNavigationPlugin },
+    { name: 'section', plugin: sectionPlugin },
+    { name: 'socialMediaImage', plugin: socialMediaImagePlugin },
+  ];
+
+  const finalMetaPlugins = executeSetupFunctions(
+    rocketConfig.setupEleventyComputedConfig,
+    metaPlugins,
+  );
+
+  const eleventyComputed = {};
+  for (const pluginObj of finalMetaPlugins) {
+    if (pluginObj.options) {
+      eleventyComputed[pluginObj.name] = pluginObj.plugin(pluginObj.options);
+    } else {
+      eleventyComputed[pluginObj.name] = pluginObj.plugin();
+    }
+  }
+
+  return eleventyComputed;
+}
+
+module.exports = { generateEleventyComputed };

packages/cli/src/shared/.eleventy.cjs

@@ -8,6 +8,7 @@ const rocketCollections = require('../eleventy-plugins/rocketCollections.cjs');
 
 module.exports = function (eleventyConfig) {
   const config = getComputedConfig();
+
   const { pathPrefix, _inputDirCwdRelative, outputDevDir } = config;
 
   let metaPlugins = [
@@ -46,12 +47,16 @@ module.exports = function (eleventyConfig) {
     }
   }
 
-  for (const pluginObj of metaPlugins) {
-    if (pluginObj.options) {
-      eleventyConfig.addPlugin(pluginObj.plugin, pluginObj.options);
-    } else {
-      eleventyConfig.addPlugin(pluginObj.plugin);
+  try {
+    for (const pluginObj of metaPlugins) {
+      if (pluginObj.options) {
+        eleventyConfig.addPlugin(pluginObj.plugin, pluginObj.options);
+      } else {
+        eleventyConfig.addPlugin(pluginObj.plugin);
+      }
     }
+  } catch (err) {
+    console.log('An eleventy plugin had an error', err);
   }
 
   if (config.eleventy) {

packages/cli/test-node/RocketCli.computedConfig.test.js

@@ -0,0 +1,182 @@
+import chai from 'chai';
+import chalk from 'chalk';
+import { executeStart, readOutput, readStartOutput } from './helpers.js';
+
+const { expect } = chai;
+
+describe('RocketCli computedConfig', () => {
+  let cli;
+
+  before(() => {
+    // ignore colors in tests as most CIs won't support it
+    chalk.level = 0;
+  });
+
+  afterEach(async () => {
+    if (cli?.cleanup) {
+      await cli.cleanup();
+    }
+  });
+
+  it('will extract a title from markdown and set first folder as section', async () => {
+    cli = await executeStart('computed-config-fixtures/headlines/rocket.config.js');
+
+    const indexHtml = await readOutput(cli, 'index.html', {
+      type: 'start',
+    });
+    const [indexTitle, indexSection] = indexHtml.split('\n');
+    expect(indexTitle).to.equal('Root');
+    expect(indexSection).to.be.undefined;
+
+    const subHtml = await readOutput(cli, 'sub/index.html', {
+      type: 'start',
+    });
+    const [subTitle, subSection] = subHtml.split('\n');
+    expect(subTitle).to.equal('Root: Sub');
+    expect(subSection).to.equal('sub');
+
+    const subSubHtml = await readOutput(cli, 'sub/subsub/index.html', {
+      type: 'start',
+    });
+    const [subSubTitle, subSubSection] = subSubHtml.split('\n');
+    expect(subSubTitle).to.equal('Sub: SubSub');
+    expect(subSubSection).to.equal('sub');
+
+    const sub2Html = await readOutput(cli, 'sub2/index.html', {
+      type: 'start',
+    });
+    const [sub2Title, sub2Section] = sub2Html.split('\n');
+    expect(sub2Title).to.equal('Root: Sub2');
+    expect(sub2Section).to.equal('sub2');
+
+    const withDataHtml = await readOutput(cli, 'with-data/index.html', {
+      type: 'start',
+    });
+    const [withDataTitle, withDataSection] = withDataHtml.split('\n');
+    expect(withDataTitle).to.equal('Set via data');
+    expect(withDataSection).be.undefined;
+  });
+
+  it('will create a social media image for every page', async () => {
+    cli = await executeStart('computed-config-fixtures/social-images/rocket.config.js');
+
+    const indexHtml = await readStartOutput(cli, 'index.html');
+    expect(indexHtml).to.equal('/_merged_assets/11ty-img/c4c29ec7-1200.png');
+
+    const guidesHtml = await readStartOutput(cli, 'guides/index.html');
+    expect(guidesHtml).to.equal('/_merged_assets/11ty-img/5e6f6f8c-1200.png');
+
+    const gettingStartedHtml = await readStartOutput(
+      cli,
+      'guides/first-pages/getting-started/index.html',
+    );
+    expect(gettingStartedHtml).to.equal('/_merged_assets/11ty-img/d989ab1a-1200.png');
+  });
+
+  it('can override the svg function globally to adjust all social media image', async () => {
+    cli = await executeStart('computed-config-fixtures/social-images-override/rocket.config.js');
+
+    const indexHtml = await readStartOutput(cli, 'index.html');
+    expect(indexHtml).to.equal('/_merged_assets/11ty-img/d76265ed-1200.png');
+
+    const guidesHtml = await readStartOutput(cli, 'guides/index.html');
+    expect(guidesHtml).to.equal('/_merged_assets/11ty-img/d76265ed-1200.png');
+
+    const gettingStartedHtml = await readStartOutput(
+      cli,
+      'guides/first-pages/getting-started/index.html',
+    );
+    expect(gettingStartedHtml).to.equal('/_merged_assets/11ty-img/d76265ed-1200.png');
+  });
+
+  it('will add "../" for links and image urls only within named template files', async () => {
+    cli = await executeStart('computed-config-fixtures/image-link/rocket.config.js');
+
+    const namedMdContent = [
+      '<p><a href="../">Root</a>',
+      '<a href="../one-level/raw/">Raw</a>',
+      '<img src="../images/my-img.svg" alt="my-img">',
+      '<img src="/images/my-img.svg" alt="absolute-img"></p>',
+    ];
+
+    const namedHtmlContent = [
+      '<div id="with-anchor">',
+      '  <a href="../">Root</a>',
+      '  <a href="../one-level/raw/">Raw</a>',
+      '  <img src="../images/my-img.svg" alt="my-img">',
+      '  <img src="/images/my-img.svg" alt="absolute-img">',
+      '  <picture>',
+      '    <source media="(min-width:465px)" srcset="../images/picture-min-465.jpg">',
+      '    <img src="../images/picture-fallback.jpg" alt="Fallback" style="width:auto;">',
+      '  </picture>',
+      '</div>',
+    ];
+
+    const templateHtml = await readStartOutput(cli, 'template/index.html');
+    expect(templateHtml, 'template/index.html does not match').to.equal(
+      namedHtmlContent.join('\n'),
+    );
+
+    const guidesHtml = await readStartOutput(cli, 'guides/index.html');
+    expect(guidesHtml, 'guides/index.html does not match').to.equal(
+      [...namedMdContent, ...namedHtmlContent].join('\n'),
+    );
+
+    const noAdjustHtml = await readStartOutput(cli, 'no-adjust/index.html');
+    expect(noAdjustHtml, 'no-adjust/index.html does not match').to.equal(
+      '<p>Nothing to adjust in here</p>',
+    );
+
+    const rawHtml = await readStartOutput(cli, 'one-level/raw/index.html');
+    expect(rawHtml, 'raw/index.html does not match').to.equal(
+      [
+        '<div>',
+        '  <a href="../../">Root</a>',
+        '  <a href="../../guides/#with-anchor">Guides</a>',
+        '  <img src="../../images/my-img.svg" alt="my-img">',
+        '  <img src="/images/my-img.svg" alt="absolute-img">',
+        '  <picture>',
+        '    <source media="(min-width:465px)" srcset="/images/picture-min-465.jpg">',
+        '    <img src="../../images/picture-fallback.jpg" alt="Fallback" style="width:auto;">',
+        '  </picture>',
+        '</div>',
+      ].join('\n'),
+    );
+
+    // for index files no '../' will be added
+    const indexHtml = await readStartOutput(cli, 'index.html');
+    expect(indexHtml, 'index.html does not match').to.equal(
+      [
+        '<p><a href="./">Root</a>',
+        '<a href="guides/#with-anchor">Guides</a>',
+        '<a href="./one-level/raw/">Raw</a>',
+        '<a href="template/">Template</a>',
+        '<a href="./rules/tabindex/">EndingIndex</a>',
+        '<img src="./images/my-img.svg" alt="my-img">',
+        '<img src="/images/my-img.svg" alt="absolute-img"></p>',
+        '<div>',
+        '  <a href="./">Root</a>',
+        '  👇<a href="guides/#with-anchor">Guides</a>',
+        '  👉 <a href="./one-level/raw/">Raw</a>',
+        '  <a href="template/">Template</a>',
+        '  <a href="./rules/tabindex/">EndingIndex</a>',
+        '  <img src="./images/my-img.svg" alt="my-img">',
+        '  <img src="/images/my-img.svg" alt="absolute-img">',
+        '  <picture>',
+        '    <source media="(min-width:465px)" srcset="./images/picture-min-465.jpg">',
+        '    <img src="./images/picture-fallback.jpg" alt="Fallback" style="width:auto;">',
+        '  </picture>',
+        '</div>',
+      ].join('\n'),
+    );
+  });
+
+  it('can be configured via setupEleventyComputedConfig', async () => {
+    cli = await executeStart('computed-config-fixtures/setup/addPlugin.rocket.config.js');
+
+    const indexHtml = await readOutput(cli, 'index.html', {
+      type: 'start',
+    });
+    expect(indexHtml).to.equal('test-value');
+  });
+});

packages/cli/test-node/RocketCli.e2e.test.js

@@ -4,6 +4,7 @@ import { RocketCli } from '../src/RocketCli.js';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import fs from 'fs-extra';
+import chalk from 'chalk';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -13,7 +14,7 @@ const { expect } = chai;
  * @param {function} method
  * @param {string} errorMessage
  */
-async function expectThrowsAsync(method, errorMessage) {
+async function expectThrowsAsync(method, { errorMatch, errorMessage } = {}) {
   let error = null;
   try {
     await method();
@@ -21,8 +22,11 @@ async function expectThrowsAsync(method, errorMessage) {
     error = err;
   }
   expect(error).to.be.an('Error', 'No error was thrown');
+  if (errorMatch) {
+    expect(error.message).to.match(errorMatch);
+  }
   if (errorMessage) {
-    expect(error.message).to.match(errorMessage);
+    expect(error.message).to.equal(errorMessage);
   }
 }
 
@@ -67,6 +71,18 @@ describe('RocketCli e2e', () => {
     await cli.run();
   }
 
+  async function executeLint(pathToConfig) {
+    cli = new RocketCli({
+      argv: ['lint', '--config-file', path.join(__dirname, pathToConfig.split('/').join(path.sep))],
+    });
+    await execute();
+  }
+
+  before(() => {
+    // ignore colors in tests as most CIs won't support it
+    chalk.level = 0;
+  });
+
   afterEach(async () => {
     if (cli?.cleanup) {
       await cli.cleanup();
@@ -117,7 +133,9 @@ describe('RocketCli e2e', () => {
         ],
       });
 
-      await expectThrowsAsync(() => execute(), /Error in your Eleventy config file.*/);
+      await expectThrowsAsync(() => execute(), {
+        errorMatch: /Error in your Eleventy config file.*/,
+      });
     });
   });
 
@@ -199,16 +217,16 @@ describe('RocketCli e2e', () => {
       type: 'start',
     });
     expect(indexHtml).to.equal(
-      '<p>You can show rocket config data like rocketConfig.absoluteBaseUrl = http://test-domain.com/</p>',
+      '<p>You can show rocket config data like rocketConfig.absoluteBaseUrl = <a href="http://test-domain.com/">http://test-domain.com/</a></p>',
     );
   });
 
-  it('can add a pathprefix that will not influence the start command', async () => {
+  it('can add a pathPrefix that will not influence the start command', async () => {
     cli = new RocketCli({
       argv: [
         'start',
         '--config-file',
-        path.join(__dirname, 'e2e-fixtures', 'content', 'pathprefix.rocket.config.js'),
+        path.join(__dirname, 'e2e-fixtures', 'content', 'pathPrefix.rocket.config.js'),
       ],
     });
     await execute();
@@ -217,7 +235,7 @@ describe('RocketCli e2e', () => {
       type: 'start',
     });
     expect(linkHtml).to.equal(
-      ['<p><a href="../../">home</a></p>', '<p><a href="/">absolute home</a></p>'].join('\n'),
+      ['<p><a href="../">home</a></p>', '<p><a href="/">absolute home</a></p>'].join('\n'),
     );
     const assetHtml = await readOutput('use-assets/index.html', {
       type: 'start',
@@ -240,16 +258,21 @@ describe('RocketCli e2e', () => {
       stripToBody: true,
     });
     expect(linkHtml).to.equal(
-      [
-        '<p><a href="../../">home</a></p>',
-        '<p><a href="/my-sub-folder/">absolute home</a></p>',
-      ].join('\n'),
+      ['<p><a href="../">home</a></p>', '<p><a href="/my-sub-folder/">absolute home</a></p>'].join(
+        '\n',
+      ),
     );
     const assetHtml = await readOutput('use-assets/index.html', {
       stripServiceWorker: true,
     });
     expect(assetHtml).to.equal(
-      '<html><head><link rel="stylesheet" href="../41297ffa.css">\n\n\n\n</head><body>\n\n</body></html>',
+      '<html><head><link rel="stylesheet" href="../41297ffa.css">\n\n</head><body>\n\n</body></html>',
     );
   });
+
+  it('smoke test for link checking', async () => {
+    await expectThrowsAsync(() => executeLint('e2e-fixtures/lint-links/rocket.config.js'), {
+      errorMatch: /Found 1 missing reference targets/,
+    });
+  });
 });

packages/cli/test-node/computed-config-fixtures/headlines/docs/.eleventyignore

@@ -0,0 +1 @@
+**/*.njk

packages/cli/test-node/computed-config-fixtures/headlines/docs/_data/socialMediaImage.cjs

@@ -0,0 +1 @@
+module.exports = 'do-not-generate-it';

packages/cli/test-node/computed-config-fixtures/headlines/docs/_includes/layout.njk

@@ -0,0 +1,2 @@
+{{ title }}
+{{ section }}

packages/cli/test-node/computed-config-fixtures/headlines/docs/index.md

@@ -0,0 +1 @@
+# Root

packages/cli/test-node/computed-config-fixtures/headlines/docs/sub/index.md

@@ -0,0 +1 @@
+# Root >> Sub

packages/cli/test-node/computed-config-fixtures/headlines/docs/sub/subsub/index.md

@@ -0,0 +1 @@
+# Root >> Sub >> SubSub ||10

packages/cli/test-node/computed-config-fixtures/headlines/docs/sub2/index.md

@@ -0,0 +1 @@
+# Root >> Sub2

packages/cli/test-node/computed-config-fixtures/headlines/docs/with-data.md

@@ -0,0 +1,3 @@
+---
+title: Set via data
+---

packages/cli/test-node/computed-config-fixtures/headlines/rocket.config.js

@@ -0,0 +1,4 @@
+/** @type {Partial<import("../../../types/main").RocketCliOptions>} */
+const config = {};
+
+export default config;

packages/cli/test-node/computed-config-fixtures/image-link/docs/guides.md

@@ -0,0 +1,15 @@
+[Root](./index.md)
+[Raw](./one-level/raw.html)
+![my-img](./images/my-img.svg)
+![absolute-img](/images/my-img.svg)
+
+<div id="with-anchor">
+  <a href="./index.md">Root</a>
+  <a href="./one-level/raw.html">Raw</a>
+  <img src="./images/my-img.svg" alt="my-img">
+  <img src="/images/my-img.svg" alt="absolute-img">
+  <picture>
+    <source media="(min-width:465px)" srcset="./images/picture-min-465.jpg">
+    <img src="./images/picture-fallback.jpg" alt="Fallback" style="width:auto;">
+  </picture>
+</div>

packages/cli/test-node/computed-config-fixtures/image-link/docs/images/my-img.svg

@@ -0,0 +1,3 @@
+<svg height="100" width="100">
+  <circle cx="50" cy="50" r="40" stroke="black" stroke-width="3" fill="red" />
+</svg> 

packages/cli/test-node/computed-config-fixtures/image-link/docs/index.md

@@ -0,0 +1,21 @@
+[Root](./)
+[Guides](./guides.md#with-anchor)
+[Raw](./one-level/raw.html)
+[Template](./template.njk)
+[EndingIndex](./rules/tabindex.md)
+![my-img](./images/my-img.svg)
+![absolute-img](/images/my-img.svg)
+
+<div>
+  <a href="./">Root</a>
+  👇<a href="./guides.md#with-anchor">Guides</a>
+  👉 <a href="./one-level/raw.html">Raw</a>
+  <a href="./template.njk">Template</a>
+  <a href="./rules/tabindex.md">EndingIndex</a>
+  <img src="./images/my-img.svg" alt="my-img">
+  <img src="/images/my-img.svg" alt="absolute-img">
+  <picture>
+    <source media="(min-width:465px)" srcset="./images/picture-min-465.jpg">
+    <img src="./images/picture-fallback.jpg" alt="Fallback" style="width:auto;">
+  </picture>
+</div>

packages/cli/test-node/computed-config-fixtures/image-link/docs/no-adjust.md

@@ -0,0 +1 @@
+Nothing to adjust in here

packages/cli/test-node/computed-config-fixtures/image-link/docs/one-level/raw.html

@@ -0,0 +1,10 @@
+<div>
+  <a href="../index.md">Root</a>
+  <a href="../guides.md#with-anchor">Guides</a>
+  <img src="../images/my-img.svg" alt="my-img">
+  <img src="/images/my-img.svg" alt="absolute-img">
+  <picture>
+    <source media="(min-width:465px)" srcset="/images/picture-min-465.jpg">
+    <img src="../images/picture-fallback.jpg" alt="Fallback" style="width:auto;">
+  </picture>
+</div>

packages/cli/test-node/computed-config-fixtures/image-link/docs/template.njk

@@ -0,0 +1,10 @@
+<div id="with-anchor">
+  <a href="./index.md">Root</a>
+  <a href="./one-level/raw.html">Raw</a>
+  <img src="./images/my-img.svg" alt="my-img">
+  <img src="/images/my-img.svg" alt="absolute-img">
+  <picture>
+    <source media="(min-width:465px)" srcset="./images/picture-min-465.jpg">
+    <img src="./images/picture-fallback.jpg" alt="Fallback" style="width:auto;">
+  </picture>
+</div>

packages/cli/test-node/computed-config-fixtures/image-link/rocket.config.js

@@ -0,0 +1,3 @@
+/** @type {Partial<import("../../../types/main").RocketCliOptions>} */
+const config = {};
+export default config;

packages/cli/test-node/computed-config-fixtures/setup/addPlugin.rocket.config.js

@@ -0,0 +1,8 @@
+import { addPlugin } from 'plugins-manager';
+
+/** @type {Partial<import("../../../types/main").RocketCliOptions>} */
+const config = {
+  setupEleventyComputedConfig: [addPlugin({ name: 'test', plugin: () => 'test-value' })],
+};
+
+export default config;

packages/cli/test-node/computed-config-fixtures/setup/docs/.eleventyignore

@@ -0,0 +1 @@
+**/*.njk

packages/cli/test-node/computed-config-fixtures/setup/docs/_includes/layout.njk

@@ -0,0 +1 @@
+{{ test }}

packages/cli/test-node/computed-config-fixtures/social-images-override/docs/.eleventyignore

@@ -0,0 +1 @@
+**/*.njk