feat: add generate import map

2026-03-21 08:51:18 +00:00 · 2021-02-07 09:15:25 +01:00
61 changed files with 1187 additions and 479 deletions
--- a/README.md
+++ b/README.md
@@ -43,7 +43,7 @@

 ## The Goal for Rocket

-> Our goal is to provide developers with a meta framework for static websites with a sprinkle of JavaScript.
+> Our goal is to provide developers with a meta framework for static websites with a spricle of JavaScript.

 Get a site up and running in no time and focus on the content.
 You can still tweak every detail of every underlying tool that gets used.
@@ -54,7 +54,7 @@ Rocket is part of the [Modern Web Family](https://twitter.com/modern_web_dev).

 We are always looking for contributors of all skill levels! If you're looking to ease your way into the project, try out a [good first issue](https://github.com/modernweb-dev/rocket/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22).

-If you are interested in helping contribute to Modern Web, please take a look at our [Contributing Guide](https://github.com/modernweb-dev/rocket/blob/main/CONTRIBUTING.md). Also, feel free to drop into [slack](https://rocket.modern-web.dev/about/slack/) and say hi. 👋
+If you are interested in helping contribute to Modern Web, please take a look at our [Contributing Guide](https://github.com/modernweb-dev/rocket/blob/main/CONTRIBUTING.md). Also, feel free to drop into [slack](https://rocket.modern-web.dev/discover/slack/) and say hi. 👋

 ### Financial Contributors

--- a/packages/building-rollup/CHANGELOG.md
+++ b/packages/building-rollup/CHANGELOG.md
@@ -1,11 +1,5 @@
 # @rocket/building-rollup

-## 0.1.3
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
-
 ## 0.1.2

 ### Patch Changes
--- a/packages/building-rollup/package.json
+++ b/packages/building-rollup/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@rocket/building-rollup",
-  "version": "0.1.3",
+  "version": "0.1.2",
  "publishConfig": {
    "access": "public"
  },
@@ -14,7 +14,6 @@
  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
  "homepage": "https://rocket.modern-web.dev/docs/tools/building-rollup/",
  "type": "module",
-  "main": "./index.js",
  "exports": {
    ".": "./index.js"
  },
--- a/packages/building-rollup/src/createSpaConfig.js
+++ b/packages/building-rollup/src/createSpaConfig.js
@@ -53,7 +53,7 @@ export function createSpaMetaConfig(userConfig = { output: {} }) {
        // directory to match patterns against to be precached
        globDirectory: path.join(config.output.dir),
        // cache any html js and css by default
-        globPatterns: ['**/*.{html,js,css,webmanifest}', '**/*-search-index.json'],
+        globPatterns: ['**/*.{html,js,css,webmanifest}'],
        skipWaiting: true,
        clientsClaim: true,
        runtimeCaching: [
--- a/packages/check-html-links/CHANGELOG.md
+++ b/packages/check-html-links/CHANGELOG.md
@@ -1,11 +1,5 @@
 # check-html-links

-## 0.2.1
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
-
 ## 0.2.0

 ### Minor Changes
--- a/packages/check-html-links/package.json
+++ b/packages/check-html-links/package.json
@@ -1,6 +1,6 @@
 {
  "name": "check-html-links",
-  "version": "0.2.1",
+  "version": "0.2.0",
  "publishConfig": {
    "access": "public"
  },
@@ -17,7 +17,6 @@
    "check-html-links": "src/cli.js"
  },
  "type": "module",
-  "main": "./index.js",
  "exports": {
    ".": "./index.js"
  },
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -1,27 +1,5 @@
 # @rocket/cli

-## 0.6.0
-
-### Minor Changes
-
- 5edc40f: Make sure each rocket instance has it's own eleventy config'
- ef8ebb0: To support dynamically created content to be part of the anchor navigation of the page we now analyze the final html output instead of `entry.templateContent`.
-
-  BREAKING CHANGE:
-
-  - only add anchors for the currently active pages (before it added anchor for every page)
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
- Updated dependencies [be0d0b3]
- Updated dependencies [ef8ebb0]
-  - @rocket/building-rollup@0.1.3
-  - check-html-links@0.2.1
-  - @rocket/core@0.1.2
-  - plugins-manager@0.2.1
-  - @rocket/eleventy-rocket-nav@0.3.0
-
 ## 0.5.2

 ### Patch Changes
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@rocket/cli",
-  "version": "0.6.0",
+  "version": "0.5.2",
  "publishConfig": {
    "access": "public"
  },
@@ -17,7 +17,6 @@
    "rocket": "src/cli.js"
  },
  "type": "module",
-  "main": "./index.cjs",
  "exports": {
    ".": {
      "require": "./index.cjs",
@@ -57,22 +56,22 @@
  "dependencies": {
    "@11ty/eleventy": "^0.11.1",
    "@11ty/eleventy-img": "^0.7.4",
-    "@rocket/building-rollup": "^0.1.3",
-    "@rocket/core": "^0.1.2",
+    "@rocket/building-rollup": "^0.1.2",
+    "@rocket/core": "^0.1.1",
    "@rocket/eleventy-plugin-mdjs-unified": "^0.3.1",
-    "@rocket/eleventy-rocket-nav": "^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.4",
    "@web/dev-server-rollup": "^0.3.2",
    "@web/rollup-plugin-copy": "^0.2.0",
-    "check-html-links": "^0.2.1",
+    "check-html-links": "^0.2.0",
    "command-line-args": "^5.1.1",
    "command-line-usage": "^6.1.1",
    "fs-extra": "^9.0.1",
    "micromatch": "^4.0.2",
-    "plugins-manager": "^0.2.1",
+    "plugins-manager": "^0.2.0",
    "utf8": "^3.0.0"
  },
  "types": "dist-types/index.d.ts"
--- a/packages/cli/src/RocketCli.js
+++ b/packages/cli/src/RocketCli.js
@@ -10,7 +10,6 @@ import computedConfigPkg from './public/computedConfig.cjs';

 import path from 'path';
 import Eleventy from '@11ty/eleventy';
-import TemplateConfig from '@11ty/eleventy/src/TemplateConfig.js';
 import { fileURLToPath } from 'url';
 import fs from 'fs-extra';

@@ -100,16 +99,11 @@ export class RocketCli {
      await this.mergePresets();

      const elev = new RocketEleventy(_inputDirCwdRelative, outputDevDir, this);
+      elev.isVerbose = false;
      // 11ty always wants a relative path to cwd - why?
      const rel = path.relative(process.cwd(), path.join(__dirname));
      const relCwdPathToConfig = path.join(rel, 'shared', '.eleventy.cjs');
-
-      const config = new TemplateConfig(null, relCwdPathToConfig);
-      elev.config = config.getConfig();
-      elev.resetConfig();
      elev.setConfigPathOverride(relCwdPathToConfig);
-
-      elev.isVerbose = false;
      await elev.init();

      this.eleventy = elev;
--- a/packages/cli/test-node/RocketCli.e2e.test.js
+++ b/packages/cli/test-node/RocketCli.e2e.test.js
@@ -35,7 +35,8 @@ describe('RocketCli e2e', () => {
  });

  describe('eleventy in config', () => {
-    it('can modify eleventy via an elventy function in the config', async () => {
+    // TODO: find out while this has a side effect and breaks other tests
+    it.skip('can modify eleventy via an elventy function in the config', async () => {
      cli = await executeStart('e2e-fixtures/content/eleventy.rocket.config.js');
      const indexHtml = await readStartOutput(cli, 'index.html');
      expect(indexHtml).to.equal(
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -1,11 +1,5 @@
 # @rocket/core

-## 0.1.2
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
-
 ## 0.1.1

 ### Patch Changes
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@rocket/core",
-  "version": "0.1.2",
+  "version": "0.1.1",
  "publishConfig": {
    "access": "public"
  },
@@ -14,7 +14,6 @@
  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
  "homepage": "https://rocket.modern-web.dev/",
  "type": "module",
-  "main": "./dist/title.cjs",
  "exports": {
    "./title": {
      "require": "./dist/title.cjs",
--- a/packages/drawer/src/RocketDrawer.js
+++ b/packages/drawer/src/RocketDrawer.js
@@ -18,7 +18,6 @@ export class RocketDrawer extends OverlayMixin(LitElement) {
    return {
      useOverlay: { type: Boolean, reflect: true },
      useOverlayMediaQuery: { type: String },
-      mediaMatcher: { type: Object },
    };
  }

@@ -90,20 +89,6 @@ export class RocketDrawer extends OverlayMixin(LitElement) {
        }
      }
    }
-    if (changedProperties.has('useOverlayMediaQuery')) {
-      this.mediaMatcher.removeEventListener('change', this.onMatchMedia);
-
-      this.mediaMatcher = window.matchMedia(this.useOverlayMediaQuery);
-      this.mediaMatcher.addEventListener('change', this.onMatchMedia);
-      this.useOverlay = !!this.mediaMatcher.matches;
-    }
-  }
-
-  /**
-   * @param { MediaQueryListEvent } query
-   */
-  onMatchMedia(query) {
-    this.useOverlay = !!query.matches;
  }

  _setupOpenCloseListeners() {
@@ -133,15 +118,11 @@ export class RocketDrawer extends OverlayMixin(LitElement) {

    this.__toggle = this.__toggle.bind(this);

-    this.onMatchMedia = this.onMatchMedia.bind(this);
    this.onGestureStart = this.onGestureStart.bind(this);
    this.onGestureMove = this.onGestureMove.bind(this);
    this.onGestureEnd = this.onGestureEnd.bind(this);
    this.updateFromTouch = this.updateFromTouch.bind(this);

-    this.mediaMatcher = window.matchMedia(this.useOverlayMediaQuery);
-    this.mediaMatcher.addEventListener('change', this.onMatchMedia);
-
    this._startX = 0;
    this._currentX = 0;
    this._velocity = 0;
@@ -152,7 +133,10 @@ export class RocketDrawer extends OverlayMixin(LitElement) {

  connectedCallback() {
    super.connectedCallback();
-    this.useOverlay = !!this.mediaMatcher.matches;
+    this.useOverlay = !!window.matchMedia(this.useOverlayMediaQuery).matches;
+    window.matchMedia(this.useOverlayMediaQuery).addListener(query => {
+      this.useOverlay = !!query.matches;
+    });
  }

  render() {
--- a/packages/eleventy-rocket-nav/.eleventy.js
+++ b/packages/eleventy-rocket-nav/.eleventy.js
@@ -1,5 +1,4 @@
 const RocketNav = require('./eleventy-rocket-nav');
-const { addPageAnchors } = require('./src/addPageAnchors.js');

 // export the configuration function for plugin
 module.exports = function (eleventyConfig) {
@@ -9,10 +8,6 @@ module.exports = function (eleventyConfig) {
  eleventyConfig.addNunjucksFilter('rocketNavToHtml', function (pages, options) {
    return RocketNav.toHtml.call(eleventyConfig, pages, options);
  });
-  eleventyConfig.addTransform('rocket-nav-add-page-anchors', async function (content) {
-    const newContent = await addPageAnchors(content);
-    return newContent;
-  });
 };

 module.exports.navigation = {
--- a/packages/eleventy-rocket-nav/CHANGELOG.md
+++ b/packages/eleventy-rocket-nav/CHANGELOG.md
@@ -1,15 +1,5 @@
 # @rocket/eleventy-rocket-nav

-## 0.3.0
-
-### Minor Changes
-
- ef8ebb0: To support dynamically created content to be part of the anchor navigation of the page we now analyze the final html output instead of `entry.templateContent`.
-
-  BREAKING CHANGE:
-
-  - only add anchors for the currently active pages (before it added anchor for every page)
-
 ## 0.2.1

 ### Patch Changes
--- a/packages/eleventy-rocket-nav/eleventy-rocket-nav.js
+++ b/packages/eleventy-rocket-nav/eleventy-rocket-nav.js
@@ -94,8 +94,21 @@ function findNavigationEntries(nodes = [], key = '') {
        entry.title = entry.key;
      }
      if (entry.key) {
+        if (!headingsCache.has(entry.templateContent)) {
+          headingsCache.set(entry.templateContent, getHeadingsOfHtml(entry.templateContent));
+        }
+        const headings = /** @type {Heading[]} */ (headingsCache.get(entry.templateContent));
+        const anchors = headings.map(heading => ({
+          key: heading.text + Math.random(),
+          parent: entry.key,
+          url: `${entry.url}#${heading.id}`,
+          pluginType: 'eleventy-navigation',
+          parentKey: entry.key,
+          title: heading.text,
+          anchor: true,
+        }));
        // @ts-ignore
-        entry.children = findNavigationEntries(nodes, entry.key);
+        entry.children = [...anchors, ...findNavigationEntries(nodes, entry.key)];
      }
      return entry;
    });
@@ -214,36 +227,43 @@ function navigationToHtml(pages, _options = {}) {
      }>${pages
        .map(entry => {
          const liClass = [];
+          const aClass = [];
          if (options.listItemClass) {
            liClass.push(options.listItemClass);
          }
-          if (options.activeKey === entry.key && options.activeListItemClass) {
-            liClass.push(options.activeListItemClass);
+          if (options.anchorClass) {
+            aClass.push(options.anchorClass);
+          }
+          if (options.activeKey === entry.key) {
+            if (options.activeListItemClass) {
+              liClass.push(options.activeListItemClass);
+            }
+            if (options.activeAnchorClass) {
+              aClass.push(options.activeAnchorClass);
+            }
          }
          if (options.activeTreeListClass && activePages && activePages.includes(entry.key)) {
            liClass.push(options.activeTreeListClass);
          }
+          if (options.activeAnchorListClass && activePages && activePages.includes(entry.key)) {
+            aClass.push(options.activeAnchorListClass);
+          }
          if (options.listItemHasChildrenClass && entry.children && entry.children.length) {
            liClass.push(options.listItemHasChildrenClass);
          }

-          const output = [];
-          output.push(
-            `<${options.listItemElement}${liClass.length ? ` class="${liClass.join(' ')}"` : ''}>`,
-          );
-          output.push(`<a href="${urlFilter(entry.url)}">${entry.title}</a>`);
-          if (options.showExcerpt && entry.excerpt) {
-            output.push(`: ${entry.excerpt}`);
+          if (entry.anchor) {
+            liClass.push('anchor');
+            aClass.push('anchor');
          }
-          if (options.activeKey === entry.key && options.activeListItemClass) {
-            output.push('<!-- ADD PAGE ANCHORS -->');
-          }
-          if (entry.children) {
-            output.push(navigationToHtml(entry.children, options));
-          }
-          output.push(`</${options.listItemElement}>`);

-          return output.join('\n');
+          return `<${options.listItemElement}${
+            liClass.length ? ` class="${liClass.join(' ')}"` : ''
+          }><a href="${urlFilter(entry.url)}"${
+            aClass.length ? ` class="${aClass.join(' ')}"` : ''
+          }>${entry.title}</a>${options.showExcerpt && entry.excerpt ? `: ${entry.excerpt}` : ''}${
+            entry.children ? navigationToHtml(entry.children, options) : ''
+          }</${options.listItemElement}>`;
        })
        .join('\n')}</${options.listElement}>`
    : '';
--- a/packages/eleventy-rocket-nav/package.json
+++ b/packages/eleventy-rocket-nav/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@rocket/eleventy-rocket-nav",
-  "version": "0.3.0",
+  "version": "0.2.1",
  "publishConfig": {
    "access": "public"
  },
@@ -13,7 +13,7 @@
  },
  "main": ".eleventy.js",
  "scripts": {
-    "test": "mocha test-node/**/*.test.js test-node/*.test.js --timeout 5000",
+    "test": "mocha test-node/**/*.test.js test-node/*.test.js",
    "test:watch": "mocha test-node/**/*.test.js test-node/*.test.js --watch"
  },
  "files": [
--- a/packages/eleventy-rocket-nav/src/addPageAnchors.js
+++ b/packages/eleventy-rocket-nav/src/addPageAnchors.js
@@ -1,136 +0,0 @@
-/* eslint-disable @typescript-eslint/ban-ts-comment */
-const fs = require('fs');
-const { SaxEventType, SAXParser } = require('sax-wasm');
-
-const saxPath = require.resolve('sax-wasm/lib/sax-wasm.wasm');
-const saxWasmBuffer = fs.readFileSync(saxPath);
-
-/** @typedef {import('../types').Heading} Heading */
-
-/** @typedef {import('sax-wasm').Text} Text */
-/** @typedef {import('sax-wasm').Tag} Tag */
-/** @typedef {import('sax-wasm').Position} Position */
-
-// Instantiate
-const parser = new SAXParser(
-  SaxEventType.CloseTag | SaxEventType.Comment,
-  { highWaterMark: 256 * 1024 }, // 256k chunks
-);
-
-/**
- * @param {object} options
- * @param {string} options.content
- * @param {Position} options.start
- * @param {Position} options.end
- * @param {string} options.insert
- */
-function removeBetween({ content, start, end, insert = '' }) {
-  const lines = content.split('\n');
-  const i = start.line;
-  const line = lines[i];
-  const upToChange = line.slice(0, start.character - 1);
-  const afterChange = line.slice(end.character + 2);
-
-  lines[i] = `${upToChange}${insert}${afterChange}`;
-  return lines.join('\n');
-}
-
-/**
- * @param {Tag} data
- * @param {string} name
- */
-function getAttribute(data, name) {
-  if (data.attributes) {
-    const { attributes } = data;
-    const foundIndex = attributes.findIndex(entry => entry.name.value === name);
-    if (foundIndex !== -1) {
-      return attributes[foundIndex].value.value;
-    }
-  }
-  return null;
-}
-
-/**
- * @param {Tag} data
- */
-function getText(data) {
-  if (data.textNodes) {
-    return data.textNodes.map(textNode => textNode.value).join('');
-  }
-  return null;
-}
-
-/**
- * @param {string} html
- */
-function getHeadingsOfHtml(html) {
-  /** @type {Heading[]} */
-  const headings = [];
-  /** @type {Text} */
-  let insertPoint;
-  parser.eventHandler = (ev, _data) => {
-    if (ev === SaxEventType.Comment) {
-      const data = /** @type {Text} */ (/** @type {any} */ (_data));
-      // NOTE: we NEED to access data internal value so sax-wasm does not reuse it's value
-      // eslint-disable-next-line @typescript-eslint/no-unused-vars
-      const tmp = data.start.line + data.end.line;
-      if (data.value.trim() === 'ADD PAGE ANCHORS' || data.value.trim() === '-->ADD PAGE ANCHORS') {
-        insertPoint = data;
-      }
-    }
-
-    if (ev === SaxEventType.CloseTag) {
-      const data = /** @type {Tag} */ (/** @type {any} */ (_data));
-      if (data.name === 'h2') {
-        const id = getAttribute(data, 'id');
-        const text = getText(data);
-        if (id && text) {
-          headings.push({ text, id });
-        }
-      }
-    }
-  };
-  parser.write(Buffer.from(html, 'utf8'));
-  parser.end();
-
-  // @ts-ignore
-  return { headings, insertPoint };
-}
-
-let isSetup = false;
-
-/**
- * @param {string} content
- */
-async function addPageAnchors(content) {
-  if (!isSetup) {
-    await parser.prepareWasm(saxWasmBuffer);
-    isSetup = true;
-  }
-
-  const { headings, insertPoint } = getHeadingsOfHtml(content);
-  const pageAnchorsHtml = [];
-  if (headings.length > 0) {
-    pageAnchorsHtml.push('<ul>');
-    for (const heading of headings) {
-      pageAnchorsHtml.push('  <li class="menu-item anchor">');
-      pageAnchorsHtml.push(`    <a href="#${heading.id}" class="anchor">${heading.text}</a>`);
-      pageAnchorsHtml.push('  </li>');
-    }
-    pageAnchorsHtml.push('</ul>');
-  }
-
-  if (insertPoint) {
-    return removeBetween({
-      content,
-      start: insertPoint.start,
-      end: insertPoint.end,
-      insert: pageAnchorsHtml.join('\n'),
-    });
-  }
-  return content;
-}
-
-module.exports = {
-  addPageAnchors,
-};
--- a/packages/eleventy-rocket-nav/test-node/addPageAnchors.test.js
+++ b/packages/eleventy-rocket-nav/test-node/addPageAnchors.test.js
@@ -1,32 +0,0 @@
-const { expect } = require('chai');
-const prettier = require('prettier');
-const { addPageAnchors } = require('../src/addPageAnchors.js');
-
-const format = code => prettier.format(code, { parser: 'html' }).trim();
-
-describe('addPageAnchors', () => {
-  it('finds and adds anchors for each h2 as an unordered list', async () => {
-    const input = [
-      '<body>',
-      '  <!-- ADD PAGE ANCHORS -->',
-      '  <div id="content">',
-      '    <h2 id="first">👉 First Headline</h2>',
-      '  </div>',
-      '</body>',
-    ].join('\n');
-    const expected = [
-      '<body>',
-      '  <ul>',
-      '    <li class="menu-item anchor">',
-      '      <a href="#first" class="anchor">👉 First Headline</a>',
-      '    </li>',
-      '  </ul>',
-      '  <div id="content">',
-      '    <h2 id="first">👉 First Headline</h2>',
-      '  </div>',
-      '</body>',
-    ].join('\n');
-    const result = await addPageAnchors(input);
-    expect(format(result)).to.deep.equal(expected);
-  });
-});
--- a/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/.eleventy.js
+++ b/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/.eleventy.js
@@ -1,5 +0,0 @@
-const eleventyNavigationPlugin = require('@rocket/eleventy-rocket-nav');
-
-module.exports = function (eleventyConfig) {
-  eleventyConfig.addPlugin(eleventyNavigationPlugin);
-};
--- a/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/_data/layout.cjs
+++ b/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/_data/layout.cjs
@@ -1 +0,0 @@
-module.exports = 'layout.njk';
--- a/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/_includes/layout.njk
+++ b/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/_includes/layout.njk
@@ -1,9 +0,0 @@
-<body>
-  {{ collections.all | rocketNav | rocketNavToHtml({
-    listItemClass: "menu-item",
-    activeListItemClass: "current",
-    activeKey: eleventyNavigation.key
-  }) | safe }}
-
-  {{ content | safe }}
-</body>
--- a/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/bats.md
+++ b/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/bats.md
@@ -1,9 +0,0 @@
---
-title: Bats
-eleventyNavigation:
-  key: Bats
-  parent: Mammals
-  order: 2
---
-
-🦇 can fly.
--- a/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/humans.md
+++ b/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/humans.md
@@ -1,12 +0,0 @@
---
-title: Humans
-eleventyNavigation:
-  key: Humans
-  parent: Mammals
-  order: 1
---
-
-<h2 id="anatomy">Anatomy</h2>
-<p>Has arms.</p>
-<h2 id="age">📖 Age</h2>
-<p>Up to 130 years.</p>
--- a/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/mammals.md
+++ b/packages/eleventy-rocket-nav/test-node/fixtures/three-pages/mammals.md
@@ -1,7 +0,0 @@
---
-title: Mammals
-eleventyNavigation:
-  key: Mammals
---
-
-Mammals need air.
--- a/packages/eleventy-rocket-nav/test-node/integration.test.js
+++ b/packages/eleventy-rocket-nav/test-node/integration.test.js
@@ -1,96 +0,0 @@
-const path = require('path');
-const fs = require('fs-extra');
-const { expect } = require('chai');
-const Eleventy = require('@11ty/eleventy');
-const TemplateConfig = require('@11ty/eleventy/src/TemplateConfig');
-const prettier = require('prettier');
-
-async function execute(fixtureDir) {
-  const relPath = path.relative(process.cwd(), __dirname);
-  const relativeInputPath = path.join(relPath, fixtureDir.split('/').join(path.sep));
-  const relativeOutputPath = path.join(relPath, 'fixtures', '__output');
-  const relativeConfigPath = path.join(relativeInputPath, '.eleventy.js');
-
-  await fs.emptyDir(relativeOutputPath);
-
-  const elev = new Eleventy(relativeInputPath, relativeOutputPath);
-  const config = new TemplateConfig(null, relativeConfigPath);
-  elev.config = config.getConfig();
-  elev.setConfigPathOverride(relativeConfigPath);
-  elev.resetConfig();
-
-  await elev.init();
-  await elev.write();
-  return {
-    readOutput: async readPath => {
-      const relativeReadPath = path.join(relativeOutputPath, readPath);
-      let text = await fs.promises.readFile(relativeReadPath);
-      text = text.toString();
-      text = prettier.format(text, { parser: 'html', printWidth: 100 });
-      return text.trim();
-    },
-  };
-}
-
-describe('eleventy-rocket-nav', () => {
-  it('renders a menu with anchors for h2 content', async () => {
-    const { readOutput } = await execute('fixtures/three-pages');
-
-    const bats = await readOutput('bats/index.html');
-    expect(bats).to.deep.equal(
-      [
-        '<body>',
-        '  <ul>',
-        '    <li class="menu-item active">',
-        '      <a href="/mammals/">Mammals</a>',
-        '      <ul>',
-        '        <li class="menu-item">',
-        '          <a href="/humans/">Humans</a>',
-        '        </li>',
-        '        <li class="menu-item current">',
-        '          <a href="/bats/">Bats</a>',
-        '        </li>',
-        '      </ul>',
-        '    </li>',
-        '  </ul>',
-        '',
-        '  <p>🦇 can fly.</p>',
-        '</body>',
-      ].join('\n'),
-    );
-
-    const humans = await readOutput('humans/index.html');
-    expect(humans).to.deep.equal(
-      [
-        '<body>',
-        '  <ul>',
-        '    <li class="menu-item active">',
-        '      <a href="/mammals/">Mammals</a>',
-        '      <ul>',
-        '        <li class="menu-item current">',
-        '          <a href="/humans/">Humans</a>',
-        '          <ul>',
-        '            <li class="menu-item anchor">',
-        '              <a href="#anatomy" class="anchor">Anatomy</a>',
-        '            </li>',
-        '            <li class="menu-item anchor">',
-        '              <a href="#age" class="anchor">📖 Age</a>',
-        '            </li>',
-        '          </ul>',
-        '        </li>',
-        '        <li class="menu-item">',
-        '          <a href="/bats/">Bats</a>',
-        '        </li>',
-        '      </ul>',
-        '    </li>',
-        '  </ul>',
-        '',
-        '  <h2 id="anatomy">Anatomy</h2>',
-        '  <p>Has arms.</p>',
-        '  <h2 id="age">📖 Age</h2>',
-        '  <p>Up to 130 years.</p>',
-        '</body>',
-      ].join('\n'),
-    );
-  });
-});
--- a/packages/generate-import-map/README.md
+++ b/packages/generate-import-map/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 the [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   | -               |
--- a/packages/generate-import-map/index.js
+++ b/packages/generate-import-map/index.js
@@ -0,0 +1 @@
+export { inspectFolder } from './src/inspectFolder.js';
--- a/packages/generate-import-map/package.json
+++ b/packages/generate-import-map/package.json
@@ -0,0 +1,47 @@
+{
+  "name": "generate-import-map",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A fast low dependency generator of import map",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/modernweb-dev/rocket.git",
+    "directory": "packages/generate-import-map"
+  },
+  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
+  "homepage": "https://rocket.modern-web.dev/docs/tools/generate-import-map/",
+  "bin": {
+    "generate-import-map": "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",
+    "es-module-lexer": "^0.3.26",
+    "glob": "^7.0.0",
+    "node-fetch": "^2.6.1",
+    "sax-wasm": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/es-module-lexer": "^0.3.0",
+    "@types/glob": "^7.0.0",
+    "@types/node-fetch": "^2.5.8"
+  },
+  "types": "dist-types/index.d.ts"
+}
--- a/packages/generate-import-map/src/cli.js
+++ b/packages/generate-import-map/src/cli.js
@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+import path from 'path';
+import chalk from 'chalk';
+import { extractBareImports } from './inspectFolder.js';
+import { checkRemoteSpecifiers, createImportMap } from './createImportMap.js';
+import { listFiles } from './listFiles.js';
+
+async function main() {
+  const userRootDir = process.argv[2];
+  const userImportMapDist = process.argv[3];
+  const remoteUrl = process.argv[4];
+  const rootDir = userRootDir ? path.resolve(userRootDir) : process.cwd();
+  const importMapDist = userImportMapDist
+    ? path.resolve(userImportMapDist)
+    : `${process.cwd()}/import-map.json`;
+
+  const performanceInspectStart = process.hrtime();
+
+  console.log('👀 Looking for all imports...');
+  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 { localSpecifiers, bareSpecifiers } = await extractBareImports(files, rootDir);
+  const performanceInspectEnd = process.hrtime(performanceInspectStart);
+
+  console.log(
+    `🔗 Found a total of ${chalk.green.bold(
+      localSpecifiers.length,
+    )} local imports and ${chalk.green.bold(bareSpecifiers.length)} bare imports!`,
+  );
+  console.log(
+    `✅ Files inspected. (executed in %ds %dms)`,
+    performanceInspectEnd[0],
+    performanceInspectEnd[1] / 1000000,
+  );
+
+  const performanceRemoteStart = process.hrtime();
+  const foundBareSpecifiers = await checkRemoteSpecifiers(bareSpecifiers, remoteUrl);
+  createImportMap(foundBareSpecifiers, remoteUrl, importMapDist);
+  const performanceRemoteEnd = process.hrtime(performanceRemoteStart);
+  console.log(
+    `✅ Remote CDN check and import map created. (executed in %ds %dms)`,
+    performanceRemoteEnd[0],
+    performanceRemoteEnd[1] / 1000000,
+  );
+}
+
+main();
--- a/packages/generate-import-map/src/createImportMap.js
+++ b/packages/generate-import-map/src/createImportMap.js
@@ -0,0 +1,48 @@
+import fs from 'fs';
+import path from 'path';
+import fetch from 'node-fetch';
+
+export const defaultRemoteUrl = 'https://cdn.skypack.dev/';
+export const defaultImportMapDist = path.resolve('./import-map.json');
+
+/**
+ *
+ * @param {string[]} bareSpecifiers
+ * @param {string} remoteUrl
+ */
+export async function checkRemoteSpecifiers(bareSpecifiers, remoteUrl = defaultRemoteUrl) {
+  /** @type {Promise<void>[]} */
+  const promises = [];
+  /** @type {string[]} */
+  const result = [];
+  bareSpecifiers.forEach(specifier => {
+    const remoteSpecifier = `${remoteUrl}${specifier}`;
+    const promise = fetch(remoteSpecifier).then(response => {
+      if (response.ok) {
+        result.push(specifier);
+      }
+    });
+    promises.push(promise);
+  });
+  await Promise.all(promises);
+  return result;
+}
+
+/**
+ *
+ * @param {string[]} bareSpecifiers
+ * @param {string} remoteUrl
+ * @param {string} importMapDist
+ */
+export function createImportMap(
+  bareSpecifiers,
+  remoteUrl = defaultRemoteUrl,
+  importMapDist = defaultImportMapDist,
+) {
+  const imports = {};
+  bareSpecifiers.forEach(specifier => {
+    const remoteSpecifier = `${remoteUrl}${specifier}`;
+    imports[specifier] = remoteSpecifier;
+  });
+  fs.writeFileSync(importMapDist, JSON.stringify({ imports }, null, 2));
+}
--- a/packages/generate-import-map/src/inspectFolder.js
+++ b/packages/generate-import-map/src/inspectFolder.js
@@ -0,0 +1,197 @@
+/* eslint-disable @typescript-eslint/ban-ts-comment */
+import fs from 'fs';
+import saxWasm from 'sax-wasm';
+import { createRequire } from 'module';
+import { init, parse } from 'es-module-lexer';
+
+import { listFiles } from './listFiles.js';
+import path from 'path';
+
+/** @typedef {import('../types/main').Script} Script */
+/** @typedef {import('../types/main').Import} Import */
+/** @typedef {import('sax-wasm').Attribute} Attribute */
+/** @typedef {import('sax-wasm').Tag} Tag */
+/** @typedef {import('sax-wasm').Text} Text */
+/** @typedef {import('es-module-lexer').ImportSpecifier} ImportSpecifier */
+
+const require = createRequire(import.meta.url);
+const { SaxEventType, SAXParser } = saxWasm;
+
+const streamOptions = { highWaterMark: 256 * 1024 };
+
+const saxPath = require.resolve('sax-wasm/lib/sax-wasm.wasm');
+const saxWasmBuffer = fs.readFileSync(saxPath);
+const parserSpecifiers = new SAXParser(
+  SaxEventType.OpenTag | SaxEventType.CloseTag | SaxEventType.Attribute | SaxEventType.Text,
+  streamOptions,
+);
+
+let localSpecifiers = new Set();
+let bareSpecifiers = new Set();
+
+/**
+ * @param {string} filePath
+ * @param {object} option
+ * @param {string} option.rootDir
+ */
+function analyzeFile(filePath, { rootDir }) {
+  if (fs.existsSync(filePath) && !fs.lstatSync(filePath).isDirectory()) {
+    const source = fs.readFileSync(filePath, { encoding: 'utf-8' });
+    const importDir = path.dirname(filePath);
+    console.log('Resolving specifier %s', filePath);
+    getSpecifiers(source).forEach(specifier => {
+      addSpecifier(specifier, { importDir, rootDir });
+    });
+  }
+}
+
+/**
+ * @param {string} source
+ */
+function getSpecifiers(source) {
+  /** @type {[ImportSpecifier[], string[]]} */
+  const [imports] = parse(source, 'optional-sourcename');
+  return imports.map(specifier => source.substring(specifier.s, specifier.e).replace(/'/g, ''));
+}
+
+/**
+ *
+ * @param {string} specifier
+ * @param {object} options
+ * @param {string} options.importDir
+ * @param {string} options.rootDir
+ */
+function addSpecifier(specifier, { importDir, rootDir }) {
+  let newSpecifier = specifier.trim();
+  if (newSpecifier.endsWith('/')) {
+    newSpecifier += 'index.js';
+  }
+
+  if (newSpecifier.startsWith('/')) {
+    // Absolute path specifier
+    newSpecifier = path.join(rootDir, newSpecifier);
+  } else if (newSpecifier.startsWith('../') || newSpecifier.startsWith('./')) {
+    // Relative path specifier
+    newSpecifier = path.join(importDir, newSpecifier);
+  }
+
+  if (newSpecifier.startsWith('/')) {
+    if (!localSpecifiers.has(newSpecifier)) {
+      localSpecifiers.add(newSpecifier);
+      analyzeFile(newSpecifier, { rootDir });
+    }
+  } else {
+    const [namespace, name] = newSpecifier.split('/');
+    if (namespace.startsWith('@')) {
+      newSpecifier = `${namespace}/${name}`;
+    } else {
+      newSpecifier = namespace;
+    }
+    bareSpecifiers.add(newSpecifier);
+  }
+}
+/**
+ *
+ * @param {Script[]} scripts
+ * @param {object} options
+ * @param {string} options.importDir
+ * @param {string} options.rootDir
+ */
+async function resolveSpecifiers(scripts, { importDir, rootDir }) {
+  for (const scriptObj of scripts) {
+    if (scriptObj.specifier) {
+      addSpecifier(scriptObj.specifier, { importDir, rootDir });
+    } else {
+      getSpecifiers(scriptObj.content).forEach(specifier => {
+        addSpecifier(specifier, { importDir, rootDir });
+      });
+    }
+  }
+}
+
+/**
+ * @param {string} filePath
+ */
+function extractScripts(filePath) {
+  /** @type {Script[]} */
+  const scripts = [];
+
+  let captureContent = false;
+
+  parserSpecifiers.eventHandler = (ev, /** @type {any} */ _data) => {
+    const data = /** @type {Tag | Text} */ _data;
+    if (captureContent && ev === SaxEventType.Text) {
+      const scriptObj = scripts[scripts.length - 1];
+      scriptObj.content += data.value;
+    } else if (ev === SaxEventType.CloseTag && data.name.toString() === 'script') {
+      captureContent = false;
+    } else if (ev === SaxEventType.OpenTag) {
+      const tagName = data.name.toString();
+      const type = data.attributes.find(
+        (/** @type Attribute */ attr) => attr.name.toString() === 'type',
+      );
+      if (tagName === 'script' && type?.value.toString() === 'module') {
+        const scriptObj = /** @type {Script} */ {
+          filePath,
+          content: '',
+          specifier: '',
+        };
+        const src = data.attributes.find(
+          (/** @type Attribute */ attr) => attr.name.toString() === 'src',
+        );
+        if (src) {
+          let srcPath = src.value.toString().trim();
+          if (!srcPath.startsWith('.') || !srcPath.startsWith('/')) {
+            srcPath = `./${srcPath}`;
+          }
+          scriptObj.specifier = srcPath;
+        } else {
+          captureContent = true;
+        }
+        scripts.push(scriptObj);
+      }
+    }
+  };
+
+  return new Promise(resolve => {
+    const readable = fs.createReadStream(filePath, streamOptions);
+    readable.on('data', chunk => {
+      // @ts-expect-error
+      parserSpecifiers.write(chunk);
+    });
+    readable.on('end', () => {
+      parserSpecifiers.end();
+      resolve(scripts);
+    });
+  });
+}
+
+/**
+ * @param {string[]} files
+ * @param {string} rootDir
+ */
+export async function extractBareImports(files, rootDir) {
+  await parserSpecifiers.prepareWasm(saxWasmBuffer);
+  await init;
+
+  localSpecifiers = new Set();
+  bareSpecifiers = new Set();
+  for (const filePath of files) {
+    const importDir = path.dirname(filePath);
+    const scripts = await extractScripts(filePath);
+    await resolveSpecifiers(scripts, { importDir, rootDir });
+  }
+  return {
+    localSpecifiers: Array.from(localSpecifiers),
+    bareSpecifiers: Array.from(bareSpecifiers),
+  };
+}
+
+/**
+ * @param {string} inRootDir
+ */
+export async function inspectFolder(inRootDir, extension = 'html') {
+  const rootDir = path.resolve(inRootDir);
+  const files = await listFiles(`**/*.${extension}`, rootDir);
+  return await extractBareImports(files, rootDir);
+}
--- a/packages/generate-import-map/src/listFiles.js
+++ b/packages/generate-import-map/src/listFiles.js
@@ -0,0 +1,34 @@
+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()),
+        );
+      },
+    );
+  });
+}
--- a/packages/generate-import-map/test-node/fixtures/script-content/empty.js
+++ b/packages/generate-import-map/test-node/fixtures/script-content/empty.js
--- a/packages/generate-import-map/test-node/fixtures/script-content/index.html
+++ b/packages/generate-import-map/test-node/fixtures/script-content/index.html
@@ -0,0 +1,12 @@
+<script>
+	import "/empty.js";
+</script>
+<script>
+	import "./empty.js";
+</script>
+<script>
+	import "./empty.js ";
+</script>
+<script>
+	import " ./empty.js ";
+</script>
--- a/packages/generate-import-map/test-node/fixtures/script-src/empty.js
+++ b/packages/generate-import-map/test-node/fixtures/script-src/empty.js
--- a/packages/generate-import-map/test-node/fixtures/script-src/index.html
+++ b/packages/generate-import-map/test-node/fixtures/script-src/index.html
@@ -0,0 +1,4 @@
+<script src="/empty.js"></script>
+<script src="./empty.js"></script>
+<script src="./empty.js "></script>
+<script src=" ./empty.js "></script>
--- a/packages/generate-import-map/test-node/fixtures/test-case/components/index.js
+++ b/packages/generate-import-map/test-node/fixtures/test-case/components/index.js
@@ -0,0 +1 @@
+export { TestComponent } from './src/TestComponent.js';
--- a/packages/generate-import-map/test-node/fixtures/test-case/components/src/TestComponent.js
+++ b/packages/generate-import-map/test-node/fixtures/test-case/components/src/TestComponent.js
@@ -0,0 +1,3 @@
+import { LitElement } from 'lit-element';
+
+export class TestElement extends LitElement {}
--- a/packages/generate-import-map/test-node/fixtures/test-case/components/test-component.js
+++ b/packages/generate-import-map/test-node/fixtures/test-case/components/test-component.js
@@ -0,0 +1,3 @@
+import { TestComponent } from './src/TestComponent.js';
+
+window.customElements.define('test-element', TestComponent);
--- a/packages/generate-import-map/test-node/fixtures/test-case/index.html
+++ b/packages/generate-import-map/test-node/fixtures/test-case/index.html
@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+	<meta charset="UTF-8">
+	<meta name="viewport" content="width=device-width, initial-scale=1.0">
+	<title>Document</title>
+	<script src="scripts/main.js" type="module"></script>
+</head>
+<body>
+	<div id="app"></div>
+</body>
+</html>
--- a/packages/generate-import-map/test-node/fixtures/test-case/overview.html
+++ b/packages/generate-import-map/test-node/fixtures/test-case/overview.html
@@ -0,0 +1,545 @@
+<!doctype html>
+
+<html lang="en" dir="ltr">
+
+
+
+    <head>
+
+    <link rel="stylesheet" href="/_merged_assets/rocket-blog.css">
+
+
+    <link
+  href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;700&display=swap"
+  rel="stylesheet"
+/>
+<link
+  href="https://fonts.googleapis.com/css2?family=Montserrat:wght@400;700&display=swap"
+  rel="stylesheet"
+/>
+<meta name="twitter:creator" content="@modern_web_dev" />
+
+
+
+
+
+
+
+
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Markdown JavaScript: Overview: Rocket</title>
+<meta property="og:title" content="Markdown JavaScript: Overview: Rocket"/>
+
+<meta name="generator" content="rocket 0.1">
+<link rel="canonical" href="/docs/markdown-javascript/overview/"/>
+
+
+
+<meta name="description" content="Rocket is the way to build fast static websites with a sprinkle of JavaScript"/>
+<meta property="og:description" content="Rocket is the way to build fast static websites with a sprinkle of JavaScript"/>
+
+
+    <link rel="apple-touch-icon" sizes="180x180" href="/_merged_assets/_static/icons/apple-touch-icon.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/_merged_assets/_static/icons/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="16x16" href="/_merged_assets/_static/icons/favicon-16x16.png">
+<link rel="manifest" href="/_merged_assets/webmanifest.json">
+<link rel="mask-icon" href="/_merged_assets/_static/icons/safari-pinned-tab.svg" color="#3f93ce">
+<meta name="msapplication-TileColor" content="#1d3557">
+<meta name="theme-color" content="#1d3557">
+
+
+    <meta property="og:site_name" content="Rocket"/>
+<meta property="og:type" content="website"/>
+
+<meta property="og:image" content="/_merged_assets/11ty-img/f8d62426-1200.png"/>
+<meta property="og:url" content="/docs/markdown-javascript/overview/"/>
+
+<meta name="twitter:card" content="summary_large_image"/>
+
+
+    <link rel="stylesheet" href="/_merged_assets/variables.css">
+<link rel="stylesheet" href="/_merged_assets/layout.css">
+<link rel="stylesheet" href="/_merged_assets/markdown.css">
+<link rel="stylesheet" href="/_merged_assets/style.css">
+
+
+    <noscript><link rel="stylesheet" href="/_merged_assets/_static/noscript.css"/></noscript>
+
+
+</head>
+
+
+
+
+  <body layout="layout-sidebar">
+
+
+
+      <header id="main-header">
+  <div class="content-area">
+
+      <button id="mobile-menu-trigger" data-action="trigger-mobile-menu">
+	<span class="sr-only">Show Menu</span>
+	      <svg xmlns="http://www.w3.org/2000/svg" aria-hidden="true" role="img" viewbox="0 0 448 512" class="icon">
+        <path fill="currentColor" d="M436 124H12c-6.627 0-12-5.373-12-12V80c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12zm0 160H12c-6.627 0-12-5.373-12-12v-32c0-6.627 5.373-12 12-12h424c6.627 0 12 5.373 12 12v32c0 6.627-5.373 12-12 12z"></path>
+      </svg>
+
+</button>
+
+
+
+	<a class="logo-link" href="/">
+  <img src="/_merged_assets/logo.svg" alt="Rocket Logo" />
+  <span>Rocket</span>
+</a>
+
+
+
+
+      <rocket-search class="search" json-url="/_merged_assets/_static/rocket-search-index.json">
+  <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 129 129" style="width: 25px;">
+    <path d="M51.6 96.7c11 0 21-3.9 28.8-10.5l35 35c.8.8 1.8 1.2 2.9 1.2s2.1-.4 2.9-1.2c1.6-1.6 1.6-4.2 0-5.8l-35-35c6.5-7.8 10.5-17.9 10.5-28.8 0-24.9-20.2-45.1-45.1-45.1-24.8 0-45.1 20.3-45.1 45.1 0 24.9 20.3 45.1 45.1 45.1zm0-82c20.4 0 36.9 16.6 36.9 36.9C88.5 72 72 88.5 51.6 88.5S14.7 71.9 14.7 51.6c0-20.3 16.6-36.9 36.9-36.9z"/>
+  </svg>
+</rocket-search>
+
+<script type="module">
+  import '@rocket/search/rocket-search.js';
+</script>
+
+
+
+  <a href="/guides/" class="
+
+
+        ">Guides</a>
+  <a href="/docs/" class="
+
+           active
+        ">Docs</a>
+  <a href="/blog/" class="
+
+
+        ">Blog</a>
+
+
+      <launch-dark-switch class="light-dark-switch" label="Toggle darkmode">Toggle darkmode</launch-dark-switch>
+
+
+
+
+	<a class="social-link" href="https://github.com/modernweb-dev/rocket" aria-label="Rocket on GitHub" rel="noopener noreferrer" target="_blank">
+		<span class="sr-only">GitHub</span>
+
+			<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 17 16" fill="none">
+  <title>GitHub</title>
+  <path fill="currentColor" fill-rule="evenodd" d="M8.18391.249268C3.82241.249268.253906 3.81777.253906 8.17927c0 3.46933 2.279874 6.44313 5.451874 7.53353.3965.0991.49563-.1983.49563-.3965v-1.3878c-2.18075.4956-2.67638-.9912-2.67638-.9912-.3965-.8922-.89212-1.1895-.89212-1.1895-.69388-.4957.09912-.4957.09912-.4957.793.0992 1.1895.793 1.1895.793.69388 1.2887 1.88338.8922 2.27988.6939.09912-.4956.29737-.8921.49562-1.0904-1.78425-.1982-3.5685-.8921-3.5685-3.96496 0-.89212.29738-1.586.793-2.08162-.09912-.19825-.3965-.99125.09913-2.08163 0 0 .69387-.19825 2.18075.793.59475-.19825 1.28862-.29737 1.9825-.29737.69387 0 1.38775.09912 1.98249.29737 1.4869-.99125 2.1808-.793 2.1808-.793.3965 1.09038.1982 1.88338.0991 2.08163.4956.59475.793 1.28862.793 2.08162 0 3.07286-1.8834 3.66766-3.66764 3.86586.29737.3965.59474.8921.59474 1.586v2.1808c0 .1982.0991.4956.5948.3965 3.172-1.0904 5.4518-4.0642 5.4518-7.53353-.0991-4.3615-3.6676-7.930002-8.02909-7.930002z" clip-rule="evenodd"></path>
+</svg>
+
+
+	</a>
+
+
+  </div>
+</header>
+
+
+
+
+  <div id="content-wrapper">
+    <div class="content-area">
+
+        <rocket-drawer id="sidebar">
+  <nav slot="content" id="sidebar-nav">
+
+      <a class="logo-link" href="/">
+  <img src="/_merged_assets/logo.svg" alt="Rocket Logo" />
+  <span>Rocket</span>
+</a>
+
+
+
+      <rocket-navigation>
+  <ul><li class="menu-item"><a href="/docs/configuration/">Configuration</a><ul><li class="menu-item"><a href="/docs/configuration/overview/">Overview</a><ul><li class="menu-item anchor"><a href="/docs/configuration/overview/#adding-rollup-plugins" class="anchor">Adding Rollup Plugins</a></li>
+<li class="menu-item anchor"><a href="/docs/configuration/overview/#modifying-options-of-plugins" class="anchor">Modifying Options of Plugins</a></li></ul></li>
+<li class="menu-item"><a href="/docs/configuration/computed-config/">Computed Config</a><ul><li class="menu-item anchor"><a href="/docs/configuration/computed-config/#set-your-own-data" class="anchor">Set Your Own Data</a></li>
+<li class="menu-item anchor"><a href="/docs/configuration/computed-config/#default-available-configs" class="anchor">Default Available Configs</a></li></ul></li></ul></li>
+<li class="menu-item"><a href="/docs/presets/">Presets</a><ul><li class="menu-item"><a href="/docs/presets/joining-blocks/">Joining Blocks</a><ul><li class="menu-item anchor"><a href="/docs/presets/joining-blocks/#adding-content-without-overriding" class="anchor">Adding content without overriding</a></li>
+<li class="menu-item anchor"><a href="/docs/presets/joining-blocks/#overriding-content" class="anchor">Overriding Content</a></li>
+<li class="menu-item anchor"><a href="/docs/presets/joining-blocks/#reordering-and-overriding" class="anchor">Reordering and Overriding</a></li></ul></li>
+<li class="menu-item"><a href="/docs/presets/launch/">Launch</a><ul><li class="menu-item anchor"><a href="/docs/presets/launch/#installation" class="anchor">Installation</a></li>
+<li class="menu-item anchor"><a href="/docs/presets/launch/#data" class="anchor">Data</a></li>
+<li class="menu-item anchor"><a href="/docs/presets/launch/#inline-notification" class="anchor">Inline Notification</a></li></ul></li>
+<li class="menu-item"><a href="/docs/presets/search/">Search</a><ul><li class="menu-item anchor"><a href="/docs/presets/search/#installation" class="anchor">Installation</a></li></ul></li>
+<li class="menu-item"><a href="/docs/presets/blog/">Blog</a><ul><li class="menu-item anchor"><a href="/docs/presets/blog/#installation" class="anchor">Installation</a></li>
+<li class="menu-item anchor"><a href="/docs/presets/blog/#usage" class="anchor">Usage</a></li></ul></li></ul></li>
+<li class="menu-item active"><a href="/docs/markdown-javascript/" class="active">Markdown JavaScript</a><ul><li class="menu-item current"><a href="/docs/markdown-javascript/overview/">Overview</a><ul><li class="menu-item anchor"><a href="/docs/markdown-javascript/overview/#web-components" class="anchor">Web Components</a></li>
+<li class="menu-item anchor"><a href="/docs/markdown-javascript/overview/#demo-support-story" class="anchor">Demo Support (Story)</a></li>
+<li class="menu-item anchor"><a href="/docs/markdown-javascript/overview/#supported-systems" class="anchor">Supported Systems</a></li>
+<li class="menu-item anchor"><a href="/docs/markdown-javascript/overview/#build-mdjs" class="anchor">Build mdjs</a></li></ul></li>
+<li class="menu-item"><a href="/docs/markdown-javascript/preview/">Preview</a></li>
+<li class="menu-item"><a href="/docs/markdown-javascript/story/">Story</a></li></ul></li>
+<li class="menu-item"><a href="/docs/eleventy-plugins/">Eleventy Plugins</a><ul><li class="menu-item"><a href="/docs/eleventy-plugins/mdjs-unified/">Markdown JavaScript (mdjs)</a><ul><li class="menu-item anchor"><a href="/docs/eleventy-plugins/mdjs-unified/#setup" class="anchor">Setup</a></li>
+<li class="menu-item anchor"><a href="/docs/eleventy-plugins/mdjs-unified/#configure-a-unified-or-remark-plugin-with-mdjs" class="anchor">Configure a unified or remark Plugin with mdjs</a></li>
+<li class="menu-item anchor"><a href="/docs/eleventy-plugins/mdjs-unified/#add-a-unified-or-remark-plugin" class="anchor">Add a unified or remark Plugin</a></li></ul></li></ul></li>
+<li class="menu-item"><a href="/docs/tools/">Tools</a><ul><li class="menu-item"><a href="/docs/tools/plugins-manager/">Plugins Manager</a><ul><li class="menu-item anchor"><a href="/docs/tools/plugins-manager/#problem" class="anchor">Problem</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/plugins-manager/#problem-statement" class="anchor">Problem Statement</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/plugins-manager/#solution" class="anchor">Solution</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/plugins-manager/#adding-a-plugin" class="anchor">Adding a Plugin</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/plugins-manager/#adjusting-plugin-options" class="anchor">Adjusting Plugin Options</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/plugins-manager/#converting-metaplugins-to-an-actual-plugin" class="anchor">Converting metaPlugins to an Actual Plugin</a></li></ul></li>
+<li class="menu-item"><a href="/docs/tools/rollup-config/">Rollup Config</a><ul><li class="menu-item anchor"><a href="/docs/tools/rollup-config/#features" class="anchor">Features</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/rollup-config/#setup" class="anchor">Setup</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/rollup-config/#customizations" class="anchor">Customizations</a></li></ul></li>
+<li class="menu-item"><a href="/docs/tools/check-html-links/">Check HTML Links</a><ul><li class="menu-item anchor"><a href="/docs/tools/check-html-links/#features" class="anchor">Features</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/check-html-links/#installation" class="anchor">Installation</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/check-html-links/#usage" class="anchor">Usage</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/check-html-links/#example-output" class="anchor">Example Output</a></li>
+<li class="menu-item anchor"><a href="/docs/tools/check-html-links/#comparison" class="anchor">Comparison</a></li></ul></li></ul></li></ul>
+  <div class="sidebar-bottom">
+  <hr>
+  <launch-dark-switch class="light-dark-switch" label="Toggle darkmode">Toggle darkmode</launch-dark-switch>
+
+
+  <a href="https://github.com/modernweb-dev/rocket/issues">Help and Feedback</a>
+</div>
+
+</rocket-navigation>
+
+
+  </nav>
+</rocket-drawer>
+
+
+
+        <main class="markdown-body">
+
+    <h1 id="markdown-javascript-overview"><a class="anchor" href="#markdown-javascript-overview"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Markdown JavaScript: Overview</h1>
+<p>Markdown JavaScript (mdjs) is a format that allows you to use JavaScript with Markdown, to create interactive demos. It does so by "annotating" JavaScript that should be executed in Markdown.</p>
+<p>To annotate we use a code block with <code>js script</code>.</p>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js script</span>
+<span class="token code-block language-js"><span class="token comment">// execute me</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<h2 id="web-components"><a class="anchor" href="#web-components"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Web Components</h2>
+<p>One very good use case for that can be web components.
+HTML already works in Markdown so all you need is to load a web components definition file.</p>
+<p>You could even do so within the same Markdown file.</p>
+<pre class="language-md"><code class="language-md"><span class="token title important"><span class="token punctuation">##</span> This is my-card</span>
+
+Here's an example of the component:
+
+<span class="token code"><span class="token punctuation">```</span><span class="token code-language">html preview-story</span>
+<span class="token code-block language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>my-card</span><span class="token punctuation">></span></span>
+  <span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>h2</span><span class="token punctuation">></span></span>Hello world!<span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>h2</span><span class="token punctuation">></span></span>
+  <span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>button</span><span class="token punctuation">></span></span>Click me!<span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>button</span><span class="token punctuation">></span></span>
+<span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>my-card</span><span class="token punctuation">></span></span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<p>You can even execute some JavaScript:</p>
+<pre class="language-md"><code class="language-md"><span class="token title important"><span class="token punctuation">##</span> This is my-el</span>
+
+<span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>my-el</span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>my-el</span><span class="token punctuation">></span></span>
+
+<span class="token code"><span class="token punctuation">```</span><span class="token code-language">js script</span>
+<span class="token code-block language-js"><span class="token keyword module">import</span> <span class="token punctuation">{</span> <span class="token maybe-class-name">LitElement</span><span class="token punctuation">,</span> html <span class="token punctuation">}</span> <span class="token keyword module">from</span> <span class="token string">'https://unpkg.com/lit-element?module'</span><span class="token punctuation">;</span>
+
+<span class="token keyword">class</span> <span class="token class-name">MyEl</span> <span class="token keyword">extends</span> <span class="token class-name">LitElement</span> <span class="token punctuation">{</span>
+  <span class="token function">render</span><span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token punctuation">{</span>
+    <span class="token keyword">this</span><span class="token punctuation">.</span><span class="token property-access">innerHTML</span> <span class="token operator">=</span> <span class="token string">'&#x3C;p style="color: red">I am alive&#x3C;/p>'</span><span class="token punctuation">;</span>
+  <span class="token punctuation">}</span>
+<span class="token punctuation">}</span>
+
+customElements<span class="token punctuation">.</span><span class="token method function property-access">define</span><span class="token punctuation">(</span><span class="token string">'my-el'</span><span class="token punctuation">,</span> <span class="token maybe-class-name">MyEl</span><span class="token punctuation">)</span><span class="token punctuation">;</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<h2 id="demo-support-story"><a class="anchor" href="#demo-support-story"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Demo Support (Story)</h2>
+<p>mdjs comes with some additional helpers you can choose to import:</p>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js script</span>
+<span class="token code-block language-js"><span class="token keyword module">import</span> <span class="token string">'@mdjs/mdjs-story/mdjs-story.js'</span><span class="token punctuation">;</span>
+<span class="token keyword module">import</span> <span class="token string">'@mdjs/mdjs-preview/mdjs-preview.js'</span><span class="token punctuation">;</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<p>Once loaded you can use them like so:</p>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js script</span>
+<span class="token code-block language-js"><span class="token keyword module">import</span> <span class="token string">'@mdjs/mdjs-story/mdjs-story.js'</span><span class="token punctuation">;</span>
+<span class="token keyword module">import</span> <span class="token string">'@mdjs/mdjs-preview/mdjs-preview.js'</span><span class="token punctuation">;</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<h3 id="story"><a class="anchor" href="#story"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Story</h3>
+<p>The code snippet will actually get executed at that place and you will have a live demo</p>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js story</span>
+<span class="token code-block language-js"><span class="token keyword module">export</span> <span class="token keyword">const</span> <span class="token function-variable function"><span class="token maybe-class-name">JsStory</span></span> <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token arrow operator">=></span> html<span class="token template-string"><span class="token template-punctuation string">`</span><span class="token embedded-code html"> &#x3C;demo-wc-card>JS Story&#x3C;/demo-wc-card> </span><span class="token template-punctuation string">`</span></span><span class="token punctuation">;</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">html story</span>
+<span class="token code-block language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>demo-wc-card</span><span class="token punctuation">></span></span>HTML Story<span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>demo-wc-card</span><span class="token punctuation">></span></span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<h4 id="full-code-support"><a class="anchor" href="#full-code-support"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Full Code Support</h4>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js story</span>
+<span class="token code-block language-js"><span class="token keyword module">export</span> <span class="token keyword">const</span> <span class="token function-variable function"><span class="token maybe-class-name">JsStory</span></span> <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token arrow operator">=></span> <span class="token punctuation">{</span>
+  <span class="token keyword">const</span> calculateSomething <span class="token operator">=</span> <span class="token number">12</span><span class="token punctuation">;</span>
+  <span class="token keyword">return</span> html<span class="token template-string"><span class="token template-punctuation string">`</span><span class="token embedded-code html">
+    &#x3C;demo-wc-card .header=${`Something: ${calculateSomething}`}>JS Story&#x3C;/demo-wc-card>
+  </span><span class="token template-punctuation string">`</span></span><span class="token punctuation">;</span>
+<span class="token punctuation">}</span><span class="token punctuation">;</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<h3 id="preview-story"><a class="anchor" href="#preview-story"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Preview Story</h3>
+<p>Will become a live demo wrapped in a container with a show code button.</p>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">js preview-story</span>
+<span class="token code-block language-js"><span class="token keyword module">export</span> <span class="token keyword">const</span> <span class="token function-variable function"><span class="token maybe-class-name">JsPreviewStory</span></span> <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token arrow operator">=></span> html<span class="token template-string"><span class="token template-punctuation string">`</span><span class="token embedded-code html"> &#x3C;demo-wc-card>JS Preview Story&#x3C;/demo-wc-card> </span><span class="token template-punctuation string">`</span></span><span class="token punctuation">;</span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<pre class="language-md"><code class="language-md"><span class="token code"><span class="token punctuation">```</span><span class="token code-language">html preview-story</span>
+<span class="token code-block language-html"><span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>demo-wc-card</span><span class="token punctuation">></span></span>HTML Preview Story<span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>demo-wc-card</span><span class="token punctuation">></span></span></span>
+<span class="token punctuation">```</span></span>
+</code></pre>
+<p>Here is a live example from <a href="https://www.npmjs.com/package/demo-wc-card">demo-wc-card</a>.</p>
+<mdjs-preview mdjs-story-name="header"></mdjs-preview>
+<h2 id="supported-systems"><a class="anchor" href="#supported-systems"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Supported Systems</h2>
+<h3 id="es-dev-server"><a class="anchor" href="#es-dev-server"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>es-dev-server</h3>
+<p>Preview your mdjs readme with live demos and auto reload.</p>
+<ul>
+<li>
+<p>Add to your <code>package.json</code>:</p>
+<pre class="language-json"><code class="language-json"><span class="token property">"scripts"</span><span class="token operator">:</span> <span class="token punctuation">{</span>
+  <span class="token property">"start"</span><span class="token operator">:</span> <span class="token string">"es-dev-server"</span><span class="token punctuation">,</span>
+<span class="token punctuation">}</span>
+</code></pre>
+</li>
+<li>
+<p>Create a <code>es-dev-server.config.js</code> in the root of your repository.</p>
+<pre class="language-js"><code class="language-js"><span class="token keyword">const</span> <span class="token punctuation">{</span> mdjsTransformer <span class="token punctuation">}</span> <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'@mdjs/core'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+
+module<span class="token punctuation">.</span><span class="token property-access">exports</span> <span class="token operator">=</span> <span class="token punctuation">{</span>
+  nodeResolve<span class="token punctuation">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
+  open<span class="token punctuation">:</span> <span class="token string">'README.md'</span><span class="token punctuation">,</span>
+  watch<span class="token punctuation">:</span> <span class="token boolean">true</span><span class="token punctuation">,</span>
+  responseTransformers<span class="token punctuation">:</span> <span class="token punctuation">[</span>mdjsTransformer<span class="token punctuation">]</span><span class="token punctuation">,</span>
+<span class="token punctuation">}</span><span class="token punctuation">;</span>
+</code></pre>
+</li>
+</ul>
+<h3 id="storybook"><a class="anchor" href="#storybook"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Storybook</h3>
+<p>Please check out <a href="https://open-wc.org/demoing/">@open-wc/demoing-storybook</a> for a fully integrated setup.</p>
+<p>It includes <a href="https://open-wc.org/demoing/storybook-addon-markdown-docs.html">storybook-addon-markdown-docs</a> which uses mdjs under the hood.</p>
+<h3 id="chrome-extension-currently-only-for-github"><a class="anchor" href="#chrome-extension-currently-only-for-github"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Chrome Extension (currently only for GitHub)</h3>
+<p>See live demos directly inside GitHub pages, Markdown files, issues, pull requests...</p>
+<p>Please check out <a href="https://github.com/open-wc/mdjs-viewer">mdjs-viewer</a>.</p>
+<h2 id="build-mdjs"><a class="anchor" href="#build-mdjs"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Build mdjs</h2>
+<h3 id="basic"><a class="anchor" href="#basic"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Basic</h3>
+<p>mdjs offers two more "basic" integrations</p>
+<h4 id="mdjsdocpage"><a class="anchor" href="#mdjsdocpage"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a><code>mdjsDocPage</code></h4>
+<p>Creates a full blown HTML page by passing in the Markdown.</p>
+<pre class="language-js"><code class="language-js"><span class="token keyword">const</span> <span class="token punctuation">{</span> mdjsDocPage <span class="token punctuation">}</span> <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'@mdjs/core'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+
+<span class="token keyword">const</span> page <span class="token operator">=</span> <span class="token keyword">await</span> <span class="token function">mdjsDocPage</span><span class="token punctuation">(</span>markdownString<span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token comment">/*
+&#x3C;html>
+  ... // load styles/components for mdjs, start stories
+  &#x3C;body>
+    &#x3C;h1>Some Markdown&#x3C;/h1>
+  &#x3C;/body>
+&#x3C;/html>
+*/</span>
+</code></pre>
+<h4 id="mdjsprocess"><a class="anchor" href="#mdjsprocess"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a><code>mdjsProcess</code></h4>
+<p>Pass in multiple Markdown documents and you get back all the JavaScript code and rendered HTML.</p>
+<pre class="language-js"><code class="language-js"><span class="token keyword">const</span> <span class="token punctuation">{</span> mdjsProcess <span class="token punctuation">}</span> <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'@mdjs/core'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+
+<span class="token keyword">const</span> data <span class="token operator">=</span> <span class="token keyword">await</span> <span class="token function">mdjsProcess</span><span class="token punctuation">(</span>markdownString<span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token console class-name">console</span><span class="token punctuation">.</span><span class="token method function property-access">log</span><span class="token punctuation">(</span>data<span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token comment">/*
+{
+  jsCode: "
+    import '@mdjs/mdjs-story/mdjs-story.js';
+    ...
+  ",
+  html: '&#x3C;h1>Markdown One&#x3C;/h1>',
+}
+*/</span>
+</code></pre>
+<h3 id="advanced"><a class="anchor" href="#advanced"><svg class="octicon octicon-link" viewBox="0 0 16 16" aria-hidden="true" width="16" height="16"><path fill-rule="evenodd" d="M7.775 3.275a.75.75 0 001.06 1.06l1.25-1.25a2 2 0 112.83 2.83l-2.5 2.5a2 2 0 01-2.83 0 .75.75 0 00-1.06 1.06 3.5 3.5 0 004.95 0l2.5-2.5a3.5 3.5 0 00-4.95-4.95l-1.25 1.25zm-4.69 9.64a2 2 0 010-2.83l2.5-2.5a2 2 0 012.83 0 .75.75 0 001.06-1.06 3.5 3.5 0 00-4.95 0l-2.5 2.5a3.5 3.5 0 004.95 4.95l1.25-1.25a.75.75 0 00-1.06-1.06l-1.25 1.25a2 2 0 01-2.83 0z"></path></svg></a>Advanced</h3>
+<p>mdjs is build to be integrated within the <a href="https://unifiedjs.com/">unifiedjs</a> system.</p>
+<pre class="language-js"><code class="language-js"><span class="token keyword">const</span> unified <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'unified'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token keyword">const</span> markdown <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'remark-parse'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token keyword">const</span> htmlStringify <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'remark-html'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token keyword">const</span> mdjsParse <span class="token operator">=</span> <span class="token function">require</span><span class="token punctuation">(</span><span class="token string">'@mdjs/core'</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+
+<span class="token keyword">const</span> parser <span class="token operator">=</span> <span class="token function">unified</span><span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token method function property-access">use</span><span class="token punctuation">(</span>markdown<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token method function property-access">use</span><span class="token punctuation">(</span>mdjsParse<span class="token punctuation">)</span><span class="token punctuation">.</span><span class="token method function property-access">use</span><span class="token punctuation">(</span>htmlStringify<span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token keyword">const</span> result <span class="token operator">=</span> <span class="token keyword">await</span> parser<span class="token punctuation">.</span><span class="token method function property-access">process</span><span class="token punctuation">(</span>body<span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token keyword">const</span> <span class="token punctuation">{</span> jsCode <span class="token punctuation">}</span> <span class="token operator">=</span> result<span class="token punctuation">.</span><span class="token property-access">data</span><span class="token punctuation">;</span>
+<span class="token console class-name">console</span><span class="token punctuation">.</span><span class="token method function property-access">log</span><span class="token punctuation">(</span>result<span class="token punctuation">.</span><span class="token property-access">contents</span><span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token comment">// &#x3C;h1>This is my-el>&#x3C;/h1></span>
+<span class="token comment">// &#x3C;my-el>&#x3C;/my-el></span>
+<span class="token console class-name">console</span><span class="token punctuation">.</span><span class="token method function property-access">log</span><span class="token punctuation">(</span>jsCode<span class="token punctuation">)</span><span class="token punctuation">;</span>
+<span class="token comment">// customElements.define('my-el', class extends HTMLElement {</span>
+<span class="token comment">// ...</span>
+</code></pre>
+        <script type="module">
+          import '@mdjs/mdjs-story/mdjs-story.js';
+import '@mdjs/mdjs-preview/mdjs-preview.js';
+import { html } from 'lit-html';
+import 'demo-wc-card/demo-wc-card.js';
+export const header = () => {
+  return html`<demo-wc-card .header=${'my new header'}></demo-wc-card>`;
+};
+const rootNode = document;
+const stories = [{ key: 'header', story: header, code: `<pre class="language-js"><code class="language-js"><span class="token keyword module">import</span> <span class="token string">'demo-wc-card/demo-wc-card.js'</span><span class="token punctuation">;</span>
+<span class="token keyword module">export</span> <span class="token keyword">const</span> <span class="token function-variable function">header</span> <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token arrow operator">=></span> <span class="token punctuation">{</span>
+  <span class="token keyword">return</span> html<span class="token template-string"><span class="token template-punctuation string">\`</span><span class="token html language-html"> <span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;</span>demo-wc-card</span> <span class="token attr-name">.header</span><span class="token attr-value"><span class="token punctuation">=</span><span class="token interpolation"><span class="token interpolation-punctuation punctuation">\${</span><span class="token string">'my new header'</span><span class="token interpolation-punctuation punctuation">}</span></span></span><span class="token punctuation">></span></span><span class="token tag"><span class="token tag"><span class="token punctuation">&#x3C;/</span>demo-wc-card</span><span class="token punctuation">></span></span> </span><span class="token template-punctuation string">\`</span></span><span class="token punctuation">;</span>
+<span class="token punctuation">}</span><span class="token punctuation">;</span>
+</code></pre>` }];
+for (const story of stories) {
+  const storyEl = rootNode.querySelector(`[mdjs-story-name="${story.key}"]`);
+  storyEl.codeHasHtml = true;
+  storyEl.story = story.story;
+  storyEl.code = story.code;
+};
+if (!customElements.get('mdjs-preview')) { import('@mdjs/mdjs-preview/mdjs-preview.js'); }
+if (!customElements.get('mdjs-story')) { import('@mdjs/mdjs-story/mdjs-story.js'); }
+        </script>
+
+
+
+    <div class="content-footer">
+  <p>
+    Caught a mistake or want to contribute to the documentation?
+    <a href="https://github.com/modernweb-dev/rocket/edit/main/./docs/docs/markdown-javascript/overview.md">Edit this page on GitHub!</a>
+  </p>
+</div>
+
+
+</main>
+
+
+    </div>
+  </div>
+
+
+
+      <footer id="main-footer">
+
+
+
+
+    <div id="footer-menu">
+  <div class="content-area">
+
+      <nav>
+        <h3>Discover</h3>
+        <ul>
+
+            <li>
+              <a href="/blog/">Blog</a>
+            </li>
+
+            <li>
+              <a href="https://github.com/modernweb-dev/rocket/issues">Help and Feedback</a>
+            </li>
+
+        </ul>
+      </nav>
+
+      <nav>
+        <h3>Follow</h3>
+        <ul>
+
+            <li>
+              <a href="https://github.com/modernweb-dev/rocket">GitHub</a>
+            </li>
+
+            <li>
+              <a href="https://twitter.com/modern_web_dev">Twitter</a>
+            </li>
+
+            <li>
+              <a href="/about/slack/">Slack</a>
+            </li>
+
+        </ul>
+      </nav>
+
+      <nav>
+        <h3>Support</h3>
+        <ul>
+
+            <li>
+              <a href="/about/sponsor/">Sponsor</a>
+            </li>
+
+            <li>
+              <a href="https://github.com/modernweb-dev/rocket/blob/main/CONTRIBUTING.md">Contribute</a>
+            </li>
+
+        </ul>
+      </nav>
+
+  </div>
+</div>
+
+
+</footer>
+
+
+
+
+
+<script type="module">
+  import '@rocket/navigation/rocket-navigation.js';
+  import '@rocket/drawer/rocket-drawer.js';
+  const drawer = document.querySelector('#sidebar');
+
+  // Toggle button
+  const triggers = document.querySelectorAll('[data-action="trigger-mobile-menu"]');
+  for (const trigger of [...triggers]) {
+    trigger.addEventListener('click', function () {
+      drawer.opened = true;
+    });
+  }
+</script>
+
+
+  <script>
+  async function serviceWorkerUpdate() {
+  if ('serviceWorker' in navigator) {
+    const oldReg = await navigator.serviceWorker.getRegistration();
+    let oldSwState;
+    if (oldReg && oldReg.active) {
+      oldSwState = oldReg.active.state;
+    }
+
+    let refreshing;
+
+    navigator.serviceWorker.addEventListener('controllerchange', async () => {
+      if (refreshing) {
+        return;
+      }
+
+      const newReg = await navigator.serviceWorker.getRegistration();
+      let newSwState;
+      if (newReg && newReg.active) {
+        newSwState = newReg.active.state;
+      }
+
+      if (oldSwState === 'activated' && newSwState === 'activating') {
+        refreshing = true;
+        window.location.reload();
+      }
+    });
+  }
+}
+
+serviceWorkerUpdate();
+
+</script>
+
+
+
+
+
+
+  </body>
+</html>
--- a/packages/generate-import-map/test-node/fixtures/test-case/scripts/main.js
+++ b/packages/generate-import-map/test-node/fixtures/test-case/scripts/main.js
@@ -0,0 +1,4 @@
+import { html, render } from 'lit-html';
+import '../components/test-component.js';
+
+render(html`<test-element></test-element>`, document.body);
--- a/packages/generate-import-map/test-node/inspectFolder.test.js
+++ b/packages/generate-import-map/test-node/inspectFolder.test.js
@@ -0,0 +1,24 @@
+import chai from 'chai';
+import { execute } from './test-helpers.js';
+
+const { expect } = chai;
+
+describe('inspectFolder', () => {
+  it.skip('can handle script src', async () => {
+    const { localSpecifiers, bareSpecifiers } = await execute('fixtures/script-src');
+    expect(localSpecifiers).lengthOf(1);
+    expect(bareSpecifiers).lengthOf(0);
+  });
+
+  it.skip('can handle script content', async () => {
+    const { localSpecifiers, bareSpecifiers } = await execute('fixtures/script-content');
+    expect(localSpecifiers).lengthOf(1);
+    expect(bareSpecifiers).lengthOf(0);
+  });
+
+  it('can handle multiple levels', async () => {
+    const { localSpecifiers, bareSpecifiers } = await execute('fixtures/test-case');
+    expect(localSpecifiers).lengthOf(3);
+    expect(bareSpecifiers).lengthOf(2);
+  });
+});
--- a/packages/generate-import-map/test-node/test-helpers.js
+++ b/packages/generate-import-map/test-node/test-helpers.js
@@ -0,0 +1,11 @@
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+import { inspectFolder } from 'generate-import-map';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export async function execute(inPath) {
+  const testDir = path.join(__dirname, inPath.split('/').join(path.sep));
+  return await inspectFolder(testDir);
+}
--- a/packages/generate-import-map/tsconfig.json
+++ b/packages/generate-import-map/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"
+  ]
+}
--- a/packages/generate-import-map/types/main.d.ts
+++ b/packages/generate-import-map/types/main.d.ts
@@ -0,0 +1,10 @@
+export interface Script {
+  specifier: string;
+  content: string;
+  filePath: string;
+}
+
+export interface Import {
+	s: number;
+	e: number;
+}
--- a/packages/mdjs-core/package.json
+++ b/packages/mdjs-core/package.json
@@ -43,8 +43,8 @@
    "remark"
  ],
  "dependencies": {
-    "@mdjs/mdjs-preview": "^0.3.1",
-    "@mdjs/mdjs-story": "^0.1.1",
+    "@mdjs/mdjs-preview": "^0.3.0",
+    "@mdjs/mdjs-story": "^0.1.0",
    "@types/unist": "^2.0.3",
    "es-module-lexer": "^0.3.26",
    "github-markdown-css": "^4.0.0",
--- a/packages/mdjs-preview/CHANGELOG.md
+++ b/packages/mdjs-preview/CHANGELOG.md
@@ -1,11 +1,5 @@
 # @mdjs/mdjs-preview

-## 0.3.2
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
-
 ## 0.3.1

 ### Patch Changes
--- a/packages/mdjs-preview/package.json
+++ b/packages/mdjs-preview/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@mdjs/mdjs-preview",
-  "version": "0.3.2",
+  "version": "0.3.1",
  "publishConfig": {
    "access": "public"
  },
@@ -13,7 +13,6 @@
  },
  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
  "homepage": "https://rocket.modern-web.dev/docs/markdown-javascript/preview/",
-  "main": "./index.js",
  "type": "module",
  "exports": {
    ".": "./index.js",
--- a/packages/mdjs-story/CHANGELOG.md
+++ b/packages/mdjs-story/CHANGELOG.md
@@ -1,11 +1,5 @@
 # @mdjs/mdjs-story

-## 0.1.2
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
-
 ## 0.1.1

 ### Patch Changes
--- a/packages/mdjs-story/package.json
+++ b/packages/mdjs-story/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@mdjs/mdjs-story",
-  "version": "0.1.2",
+  "version": "0.1.1",
  "publishConfig": {
    "access": "public"
  },
@@ -13,7 +13,6 @@
  },
  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
  "homepage": "https://rocket.modern-web.dev/docs/markdown-javascript/story/",
-  "main": "./index.js",
  "type": "module",
  "exports": {
    ".": "./index.js",
--- a/packages/plugins-manager/CHANGELOG.md
+++ b/packages/plugins-manager/CHANGELOG.md
@@ -1,11 +1,5 @@
 # plugins-manager

-## 0.2.1
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
-
 ## 0.2.0

 ### Minor Changes
--- a/packages/plugins-manager/package.json
+++ b/packages/plugins-manager/package.json
@@ -1,6 +1,6 @@
 {
  "name": "plugins-manager",
-  "version": "0.2.1",
+  "version": "0.2.0",
  "publishConfig": {
    "access": "public"
  },
@@ -14,7 +14,6 @@
  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
  "homepage": "https://rocket.modern-web.dev/docs/tools/plugins-manager/",
  "type": "module",
-  "main": "./dist/index.cjs",
  "exports": {
    ".": {
      "require": "./dist/index.cjs",
--- a/packages/search/CHANGELOG.md
+++ b/packages/search/CHANGELOG.md
@@ -1,13 +1,5 @@
 # @rocket/search

-## 0.3.1
-
-### Patch Changes
-
- be0d0b3: fix: add missing main entry to the packages
- Updated dependencies [be0d0b3]
-  - plugins-manager@0.2.1
-
 ## 0.3.0

 ### Minor Changes
--- a/packages/search/package.json
+++ b/packages/search/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@rocket/search",
-  "version": "0.3.1",
+  "version": "0.3.0",
  "publishConfig": {
    "access": "public"
  },
@@ -14,7 +14,6 @@
  "author": "Modern Web <hello@modern-web.dev> (https://modern-web.dev/)",
  "homepage": "https://rocket.modern-web.dev/docs/presets/search/",
  "type": "module",
-  "main": "./node.js",
  "exports": {
    ".": "./node.js",
    "./node": "./node.js",
@@ -45,7 +44,7 @@
    "@open-wc/scoped-elements": "^1.3.2",
    "chalk": "^4.0.0",
    "minisearch": "^3.0.2",
-    "plugins-manager": "^0.2.1",
+    "plugins-manager": "^0.2.0",
    "sax-wasm": "^2.0.0"
  }
 }
--- a/packages/search/src/RocketSearch.js
+++ b/packages/search/src/RocketSearch.js
@@ -29,7 +29,7 @@ function getTitle({ result, search }) {
 function getText({ result, search }) {
  const { terms, body } = result;

-  return highlightSearchTerms({ text: body, search, terms, addEllipsis: true });
+  return highlightSearchTerms({ text: body, search, terms });
 }

 // @ts-expect-error https://github.com/microsoft/TypeScript/issues/40110
@@ -40,7 +40,6 @@ export class RocketSearch extends ScopedElementsMixin(LitElement) {
      search: { type: String },
      results: { type: Array },
      maxResults: { type: Number, attribute: 'max-results' },
-      noResultsText: { type: String },
    };
  }

@@ -56,7 +55,6 @@ export class RocketSearch extends ScopedElementsMixin(LitElement) {
    this.jsonUrl = '';
    this.search = '';
    this.maxResults = 10;
-    this.noResultsText = 'No results found';
    /**
     * @type {RocketSearchResult[]}
     */
@@ -134,9 +132,6 @@ export class RocketSearch extends ScopedElementsMixin(LitElement) {
            ></rocket-search-option>
          `,
        )}
-        ${this.results.length <= 0 && this.search.length > 0
-          ? html` <rocket-search-option .title=${this.noResultsText}></rocket-search-option> `
-          : ''}
      </rocket-search-combobox>
    `;
  }
--- a/packages/search/src/RocketSearchCombobox.js
+++ b/packages/search/src/RocketSearchCombobox.js
@@ -43,8 +43,6 @@ export class RocketSearchCombobox extends LionCombobox {
          font: inherit;
          cursor: pointer;
          fill: var(--rocket-search-fill-color, #000);
-          display: flex;
-          align-items: center;
        }

        ::slotted([slot='prefix'][close-btn]) {
--- a/packages/search/src/RocketSearchOption.js
+++ b/packages/search/src/RocketSearchOption.js
@@ -65,7 +65,7 @@ export class RocketSearchOption extends LinkMixin(LionOption) {

        :host {
          display: block;
-          cursor: pointer;
+          cursor: default;
          position: relative;
          padding: 12px 10px;
          display: flex;
--- a/packages/search/src/utils-shared.js
+++ b/packages/search/src/utils-shared.js
@@ -26,7 +26,6 @@ function defaultHighlight(term) {
 * @param {number} [options.before]
 * @param {number} [options.length]
 * @param {function} [options.highlight]
- * @param {boolean} [options.addEllipsis]
 */
 export function highlightSearchTerms({
  search,
@@ -35,7 +34,6 @@ export function highlightSearchTerms({
  before = 15,
  length = 100,
  highlight = defaultHighlight,
-  addEllipsis = false,
 }) {
  if (!search || !text) {
    return '';
@@ -72,9 +70,5 @@ export function highlightSearchTerms({
    } while (startIndex !== -1);
  }

-  let textResult = newText.substr(truncateStart, length + extraLength);
-  if (addEllipsis && truncateStart > 0) {
-    textResult = `...${textResult}`;
-  }
-  return textResult;
+  return newText.substr(truncateStart, length + extraLength);
 }
--- a/yarn.lock
+++ b/yarn.lock
@@ -1474,6 +1474,11 @@
    "@types/keygrip" "*"
    "@types/node" "*"

+"@types/es-module-lexer@^0.3.0":
+  version "0.3.0"
+  resolved "https://registry.yarnpkg.com/@types/es-module-lexer/-/es-module-lexer-0.3.0.tgz#9fee3f19f64e6b3f999eeb3a70bd177a4d57a6cb"
+  integrity sha512-XI3MGSejUQIJ3wzY0i5IHy5J3eb36M/ytgG8jIOssP08ovtRPcjpjXQqrx51AHBNBOisTS/NQNWJitI17+EwzQ==
+
 "@types/estree@*":
  version "0.0.45"
  resolved "https://registry.yarnpkg.com/@types/estree/-/estree-0.0.45.tgz#e9387572998e5ecdac221950dab3e8c3b16af884"
@@ -1603,6 +1608,14 @@
  resolved "https://registry.yarnpkg.com/@types/mocha/-/mocha-8.2.0.tgz#3eb56d13a1de1d347ecb1957c6860c911704bc44"
  integrity sha512-/Sge3BymXo4lKc31C8OINJgXLaw+7vL1/L1pGiBNpGrBiT8FQiaFpSYV0uhTaG4y78vcMBTMFsWaHDvuD+xGzQ==

+"@types/node-fetch@^2.5.8":
+  version "2.5.8"
+  resolved "https://registry.yarnpkg.com/@types/node-fetch/-/node-fetch-2.5.8.tgz#e199c835d234c7eb0846f6618012e558544ee2fb"
+  integrity sha512-fbjI6ja0N5ZA8TV53RUqzsKNkl9fv8Oj3T7zxW7FGv1GSH7gwJaNF8dzCjrqKaxKeUpTz4yT1DaJFq/omNpGfw==
+  dependencies:
+    "@types/node" "*"
+    form-data "^3.0.0"
+
 "@types/node@*":
  version "14.14.16"
  resolved "https://registry.yarnpkg.com/@types/node/-/node-14.14.16.tgz#3cc351f8d48101deadfed4c9e4f116048d437b4b"
@@ -2294,6 +2307,11 @@ async@^2.6.2:
  dependencies:
    lodash "^4.17.14"

+asynckit@^0.4.0:
+  version "0.4.0"
+  resolved "https://registry.yarnpkg.com/asynckit/-/asynckit-0.4.0.tgz#c79ed97f7f34cb8f2ba1bc9790bcc366474b4b79"
+  integrity sha1-x57Zf380y48robyXkLzDZkdLS3k=
+
 at-least-node@^1.0.0:
  version "1.0.0"
  resolved "https://registry.yarnpkg.com/at-least-node/-/at-least-node-1.0.0.tgz#602cd4b46e844ad4effc92a8011a3c46e0238dc2"
@@ -2946,6 +2964,13 @@ colorette@^1.2.1:
  resolved "https://registry.yarnpkg.com/colorette/-/colorette-1.2.1.tgz#4d0b921325c14faf92633086a536db6e89564b1b"
  integrity sha512-puCDz0CzydiSYOrnXpz/PKd69zRrribezjtE9yd4zvytoRc8+RY/KJPvtPFKZS3E3wP6neGyMe0vOTlHO5L3Pw==

+combined-stream@^1.0.8:
+  version "1.0.8"
+  resolved "https://registry.yarnpkg.com/combined-stream/-/combined-stream-1.0.8.tgz#c3d45a8b34fd730631a110a8a2520682b31d5a7f"
+  integrity sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==
+  dependencies:
+    delayed-stream "~1.0.0"
+
 comma-separated-tokens@^1.0.0:
  version "1.0.8"
  resolved "https://registry.yarnpkg.com/comma-separated-tokens/-/comma-separated-tokens-1.0.8.tgz#632b80b6117867a158f1080ad498b2fbe7e3f5ea"
@@ -3386,6 +3411,11 @@ del@^2.2.0:
    pinkie-promise "^2.0.0"
    rimraf "^2.2.8"

+delayed-stream@~1.0.0:
+  version "1.0.0"
+  resolved "https://registry.yarnpkg.com/delayed-stream/-/delayed-stream-1.0.0.tgz#df3ae199acadfb7d440aaae0b29e2272b24ec619"
+  integrity sha1-3zrhmayt+31ECqrgsp4icrJOxhk=
+
 delegate@^3.1.2:
  version "3.2.0"
  resolved "https://registry.yarnpkg.com/delegate/-/delegate-3.2.0.tgz#b66b71c3158522e8ab5744f720d8ca0c2af59166"
@@ -4092,6 +4122,15 @@ follow-redirects@^1.0.0:
  resolved "https://registry.yarnpkg.com/follow-redirects/-/follow-redirects-1.13.1.tgz#5f69b813376cee4fd0474a3aba835df04ab763b7"
  integrity sha512-SSG5xmZh1mkPGyKzjZP8zLjltIfpW32Y5QpdNJyjcfGxK3qo3NDDkZOZSFiGn1A6SclQxY9GzEwAHQ3dmYRWpg==

+form-data@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/form-data/-/form-data-3.0.0.tgz#31b7e39c85f1355b7139ee0c647cf0de7f83c682"
+  integrity sha512-CKMFDglpbMi6PyN+brwB9Q/GOw0eAnsrEZDgcsH5Krhz5Od/haKHAX0NmQfha2zPPz0JpWzA7GJHGSnvCRLWsg==
+  dependencies:
+    asynckit "^0.4.0"
+    combined-stream "^1.0.8"
+    mime-types "^2.1.12"
+
 fresh@0.5.2, fresh@^0.5.2, fresh@~0.5.2:
  version "0.5.2"
  resolved "https://registry.yarnpkg.com/fresh/-/fresh-0.5.2.tgz#3d8cadd90d976569fa835ab1f8e4b23a105605a7"
@@ -5808,6 +5847,18 @@ mime-db@1.44.0:
  resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.44.0.tgz#fa11c5eb0aca1334b4233cb4d52f10c5a6272f92"
  integrity sha512-/NOTfLrsPBVeH7YtFPgsVWveuL+4SjjYxaQ1xtM1KMFj7HdxlBlxeyNLzhyJVx7r4rZGJAZ/6lkKCitSc/Nmpg==

+mime-db@1.45.0:
+  version "1.45.0"
+  resolved "https://registry.yarnpkg.com/mime-db/-/mime-db-1.45.0.tgz#cceeda21ccd7c3a745eba2decd55d4b73e7879ea"
+  integrity sha512-CkqLUxUk15hofLoLyljJSrukZi8mAtgd+yE5uO4tqRZsdsAJKv0O+rFMhVDRJgozy+yG6md5KwuXhD4ocIoP+w==
+
+mime-types@^2.1.12:
+  version "2.1.28"
+  resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.28.tgz#1160c4757eab2c5363888e005273ecf79d2a0ecd"
+  integrity sha512-0TO2yJ5YHYr7M2zzT7gDU1tbwHxEUWBCLt0lscSNpcdAfFyJOVEpRYNS7EXVcTLNj/25QO8gulHC5JtTzSE2UQ==
+  dependencies:
+    mime-db "1.45.0"
+
 mime-types@^2.1.18, mime-types@^2.1.27, mime-types@~2.1.17, mime-types@~2.1.24:
  version "2.1.27"
  resolved "https://registry.yarnpkg.com/mime-types/-/mime-types-2.1.27.tgz#47949f98e279ea53119f5722e0f34e529bec009f"
@@ -7401,6 +7452,11 @@ rimraf@^3.0.2:
  dependencies:
    glob "^7.1.3"

+rollup-plugin-import-map@^2.2.2:
+  version "2.2.2"
+  resolved "https://registry.yarnpkg.com/rollup-plugin-import-map/-/rollup-plugin-import-map-2.2.2.tgz#51100713ba379bf6bd077d090af9708f0201e9e7"
+  integrity sha512-y97Myu5kvuIoLrfSxRd90ytjv4wbOFCoWdi1pKVRfE8eOAcJqUOyPCLM4y3gw2u276dB/pLSFi48cl29SatXPw==
+
 rollup-plugin-terser@^7.0.0, rollup-plugin-terser@^7.0.2:
  version "7.0.2"
  resolved "https://registry.yarnpkg.com/rollup-plugin-terser/-/rollup-plugin-terser-7.0.2.tgz#e8fbba4869981b2dc35ae7e8a502d5c6c04d324d"
				`@@ -0,0 +1 @@`
				`export { inspectFolder } from './src/inspectFolder.js';`
				`@@ -0,0 +1 @@`
				`export { TestComponent } from './src/TestComponent.js';`