mirror of
https://github.com/modernweb-dev/rocket.git
synced 2026-03-21 08:51:18 +00:00
Compare commits
13 Commits
feat/engin
...
@rocket/el
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c009801164 | ||
|
|
60310ab3dd | ||
|
|
db03f69210 | ||
|
|
e6c3d274cf | ||
|
|
f9014c15a6 | ||
|
|
7e277cd88f | ||
|
|
bc6106381c | ||
|
|
00bf3882f6 | ||
|
|
543e297c5b | ||
|
|
70b0ce8e1c | ||
|
|
9f8785a885 | ||
|
|
62637a829e | ||
|
|
81c4d7bf3c |
@@ -8,25 +8,25 @@ First, create a fork of the [modernweb-dev/rocket](https://github.com/modernweb-
|
||||
|
||||
Next, clone our repository onto your computer.
|
||||
|
||||
```sh
|
||||
```shell
|
||||
git clone git@github.com:modernweb-dev/rocket.git
|
||||
```
|
||||
|
||||
Once cloning is complete, change directory to the repository.
|
||||
|
||||
```sh
|
||||
```shell
|
||||
cd rocket
|
||||
```
|
||||
|
||||
Now add your fork as a remote (replacing YOUR_USERNAME with your GitHub username).
|
||||
|
||||
```sh
|
||||
```shell
|
||||
git remote add fork git@github.com:<YOUR_USERNAME>/rocket.git
|
||||
```
|
||||
|
||||
Create a new local branch.
|
||||
|
||||
```sh
|
||||
```shell
|
||||
git checkout -b my-awesome-fix
|
||||
```
|
||||
|
||||
@@ -34,7 +34,7 @@ git checkout -b my-awesome-fix
|
||||
|
||||
Now that you have cloned the repository, ensure you have [yarn](https://classic.yarnpkg.com/lang/en/) installed, then run the following commands to set up the development environment.
|
||||
|
||||
```sh
|
||||
```shell
|
||||
yarn install
|
||||
```
|
||||
|
||||
@@ -69,7 +69,7 @@ This documents your intent to release, and allows you to specify a message that
|
||||
|
||||
Run
|
||||
|
||||
```sh
|
||||
```shell
|
||||
yarn changeset
|
||||
```
|
||||
|
||||
@@ -92,7 +92,7 @@ Exceptions:
|
||||
Commit messages must follow the [conventional commit format](https://www.conventionalcommits.org/en/v1.0.0/)
|
||||
Modern-web uses package name as scope. So for example if you fix a _terrible bug_ in the package `@web/test-runner`, the commit message should look like this:
|
||||
|
||||
```sh
|
||||
```shell
|
||||
fix(test-runner): fix terrible bug
|
||||
```
|
||||
|
||||
@@ -100,7 +100,7 @@ fix(test-runner): fix terrible bug
|
||||
|
||||
Now it's time to push your branch that contains your committed changes to your fork.
|
||||
|
||||
```sh
|
||||
```shell
|
||||
git push -u fork my-awesome-fix
|
||||
```
|
||||
|
||||
|
||||
@@ -140,7 +140,7 @@ The features so far are:
|
||||
|
||||
It checks your final HTML output so you need to execute it after your Static Site Generator.
|
||||
|
||||
```
|
||||
```shell
|
||||
npx check-html-links _site
|
||||
```
|
||||
|
||||
|
||||
@@ -4,7 +4,7 @@ Use mdjs in your Eleventy site.
|
||||
|
||||
## Setup
|
||||
|
||||
```
|
||||
```shell
|
||||
npm install @rocket/eleventy-plugin-mdjs
|
||||
```
|
||||
|
||||
|
||||
@@ -22,7 +22,7 @@ Read the [Introducing Check HTMl Links - no more bad links](../../blog/introduci
|
||||
|
||||
## Installation
|
||||
|
||||
```
|
||||
```shell
|
||||
npm i -D check-html-links
|
||||
```
|
||||
|
||||
|
||||
@@ -112,16 +112,13 @@ addPlugin(MyClass, { otherProp: 'new name' }); // ts error
|
||||
|
||||
Many plugin systems require you to either execute a plugin function like in `rollup`.
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
```js
|
||||
import json from '@rollup/plugin-json';
|
||||
|
||||
/** @type {import('rocket/cli').RocketCliConfig} */
|
||||
export default ({
|
||||
export default /** @type {import('rocket/cli').RocketCliConfig} */ ({
|
||||
plugins: [json({ preferConst: true })],
|
||||
});
|
||||
```
|
||||
<!-- prettier-ignore-end -->
|
||||
|
||||
or add it in a special way like in `eleventy`
|
||||
|
||||
@@ -254,6 +251,18 @@ addPlugin(myPlugin, { myFlag: true }); // ts ok
|
||||
addPlugin(myPlugin, { notExisting: true }); // ts error
|
||||
```
|
||||
|
||||
Note: There is a "hidden" feature in addPlugin that if you attach a `wrapPlugin` property to the returning function it will call `wrapPlugin` on the plugin before adding it.
|
||||
|
||||
```js
|
||||
// example auto wrap rollup plugins for @web/dev-server
|
||||
import { fromRollup } from '@web/dev-server-rollup';
|
||||
|
||||
const userSetupFunctions = [addPlugin(json)].map(mod => {
|
||||
mod.wrapPlugin = fromRollup;
|
||||
return mod;
|
||||
});
|
||||
```
|
||||
|
||||
## Adjusting Plugin Options
|
||||
|
||||
Adjusting options means to either
|
||||
|
||||
@@ -23,7 +23,7 @@ Will be ordered as `First`, `Second`,
|
||||
|
||||
Internally `# Foo >> Bar >> Baz ||20` gets converted to.
|
||||
|
||||
```
|
||||
```yml
|
||||
---
|
||||
title: Bar: Baz
|
||||
eleventyNavigation:
|
||||
|
||||
@@ -47,7 +47,7 @@
|
||||
"update-package-configs": "node scripts/update-package-configs.mjs && yarn format"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@changesets/cli": "^2.12.0",
|
||||
"@changesets/cli": "^2.20.0",
|
||||
"@custom-elements-manifest/analyzer": "^0.4.12",
|
||||
"@open-wc/testing": "^3.0.0-next.1",
|
||||
"@rollup/plugin-commonjs": "^17.0.0",
|
||||
@@ -75,7 +75,7 @@
|
||||
"husky": "^4.3.7",
|
||||
"lint-staged": "^10.5.3",
|
||||
"mocha": "^8.2.1",
|
||||
"node-fetch": "^2.6.1",
|
||||
"node-fetch": "^2.6.7",
|
||||
"npm-run-all": "^4.1.5",
|
||||
"onchange": "^7.1.0",
|
||||
"prettier": "^2.2.1",
|
||||
@@ -84,8 +84,6 @@
|
||||
"puppeteer": "^9.0.0",
|
||||
"remark-emoji": "^2.1.0",
|
||||
"rimraf": "^3.0.2",
|
||||
"rocket-preset-code-tabs": "^0.2.6",
|
||||
"rocket-preset-custom-elements-manifest": "^0.1.7",
|
||||
"rollup": "^2.36.1",
|
||||
"rollup-plugin-terser": "^7.0.2",
|
||||
"sinon": "^9.2.3",
|
||||
|
||||
@@ -4,13 +4,13 @@ A fast checker for broken links/references in HTML.
|
||||
|
||||
## Installation
|
||||
|
||||
```
|
||||
```shell
|
||||
npm i -D check-html-links
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
```
|
||||
```bash
|
||||
npx check-html-links _site
|
||||
```
|
||||
|
||||
|
||||
@@ -1,5 +1,13 @@
|
||||
# @rocket/cli
|
||||
|
||||
## 0.10.2
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- 60310ab: Improve performance by initializing sax-wasm only once even when it is running in parallel
|
||||
- Updated dependencies [60310ab]
|
||||
- @rocket/eleventy-rocket-nav@0.3.1
|
||||
|
||||
## 0.10.1
|
||||
|
||||
### Patch Changes
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@rocket/cli",
|
||||
"version": "0.10.1",
|
||||
"version": "0.10.2",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
@@ -60,7 +60,7 @@
|
||||
"@rocket/building-rollup": "^0.4.0",
|
||||
"@rocket/core": "^0.1.2",
|
||||
"@rocket/eleventy-plugin-mdjs-unified": "^0.6.0",
|
||||
"@rocket/eleventy-rocket-nav": "^0.3.0",
|
||||
"@rocket/eleventy-rocket-nav": "^0.3.1",
|
||||
"@rollup/plugin-babel": "^5.2.2",
|
||||
"@rollup/plugin-node-resolve": "^11.0.1",
|
||||
"@web/config-loader": "^0.1.3",
|
||||
|
||||
@@ -243,9 +243,9 @@ async function insertResponsiveImages(html) {
|
||||
const config = getComputedConfig();
|
||||
|
||||
if (!isSetup) {
|
||||
await parser.prepareWasm(saxWasmBuffer);
|
||||
isSetup = true;
|
||||
isSetup = parser.prepareWasm(saxWasmBuffer);
|
||||
}
|
||||
await isSetup;
|
||||
|
||||
const options = {
|
||||
inputPath: this.inputPath,
|
||||
|
||||
@@ -1,5 +1,11 @@
|
||||
# @rocket/eleventy-rocket-nav
|
||||
|
||||
## 0.3.1
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- 60310ab: Improve performance by initializing sax-wasm only once even when it is running in parallel
|
||||
|
||||
## 0.3.0
|
||||
|
||||
### Minor Changes
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@rocket/eleventy-rocket-nav",
|
||||
"version": "0.3.0",
|
||||
"version": "0.3.1",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
|
||||
@@ -97,6 +97,7 @@ function getHeadingsOfHtml(html) {
|
||||
return { headings, insertPoint };
|
||||
}
|
||||
|
||||
/** @type {boolean | Promise<unknown>} */
|
||||
let isSetup = false;
|
||||
|
||||
/**
|
||||
@@ -104,9 +105,9 @@ let isSetup = false;
|
||||
*/
|
||||
async function addPageAnchors(content) {
|
||||
if (!isSetup) {
|
||||
await parser.prepareWasm(saxWasmBuffer);
|
||||
isSetup = true;
|
||||
isSetup = parser.prepareWasm(saxWasmBuffer);
|
||||
}
|
||||
await isSetup;
|
||||
|
||||
const { headings, insertPoint } = getHeadingsOfHtml(content);
|
||||
const pageAnchorsHtml = [];
|
||||
|
||||
@@ -1,5 +1,17 @@
|
||||
# Change Log
|
||||
|
||||
## 0.9.4
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- e6c3d27: Support `js client` as an alias to `js script`
|
||||
|
||||
## 0.9.3
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- 62637a8: Replaces `rehype-prism-template` with `rehype-prism` to get a newer version of prism with essential security updates
|
||||
|
||||
## 0.9.2
|
||||
|
||||
### Patch Changes
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@mdjs/core",
|
||||
"version": "0.9.2",
|
||||
"version": "0.9.4",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
@@ -52,7 +52,7 @@
|
||||
"github-markdown-css": "^4.0.0",
|
||||
"plugins-manager": "^0.3.0",
|
||||
"rehype-autolink-headings": "^5.0.1",
|
||||
"rehype-prism-template": "^0.4.1",
|
||||
"rehype-prism": "^1.0.0",
|
||||
"rehype-raw": "^5.0.0",
|
||||
"rehype-slug": "^4.0.1",
|
||||
"rehype-stringify": "^8.0.0",
|
||||
|
||||
@@ -16,6 +16,9 @@ function mdjsParse() {
|
||||
if (node.lang === 'js' && node.meta === 'script') {
|
||||
jsCode += node.value;
|
||||
}
|
||||
if (node.lang === 'js' && node.meta === 'client') {
|
||||
jsCode += node.value;
|
||||
}
|
||||
});
|
||||
// we can only return/modify the tree but jsCode should not be part of the tree
|
||||
// so we attach it globally to the file.data
|
||||
@@ -26,7 +29,9 @@ function mdjsParse() {
|
||||
* @param {Node} node
|
||||
*/
|
||||
const removeFunction = node =>
|
||||
node.type === 'code' && node.lang === 'js' && node.meta === 'script';
|
||||
node.type === 'code' &&
|
||||
node.lang === 'js' &&
|
||||
(node.meta === 'script' || node.meta === 'client');
|
||||
remove(tree, removeFunction);
|
||||
|
||||
return tree;
|
||||
|
||||
@@ -12,14 +12,16 @@ const raw = require('rehype-raw');
|
||||
const htmlStringify = require('rehype-stringify');
|
||||
const htmlSlug = require('rehype-slug');
|
||||
const htmlHeading = require('rehype-autolink-headings');
|
||||
const rehypePrism = require('rehype-prism-template');
|
||||
// @ts-ignore
|
||||
const { executeSetupFunctions } = require('plugins-manager');
|
||||
const loadLanguages = require('prismjs/components/');
|
||||
|
||||
const { mdjsParse } = require('./mdjsParse.js');
|
||||
const { mdjsStoryParse } = require('./mdjsStoryParse.js');
|
||||
const { mdjsSetupCode } = require('./mdjsSetupCode.js');
|
||||
|
||||
let prismLoaded = false;
|
||||
|
||||
/** @type {MdjsProcessPlugin[]} */
|
||||
const defaultMetaPlugins = [
|
||||
{ plugin: markdown, options: {} },
|
||||
@@ -30,8 +32,6 @@ const defaultMetaPlugins = [
|
||||
// @ts-ignore
|
||||
{ plugin: remark2rehype, options: { allowDangerousHtml: true } },
|
||||
// @ts-ignore
|
||||
{ plugin: rehypePrism, options: {} },
|
||||
// @ts-ignore
|
||||
{ plugin: raw, options: {} },
|
||||
// @ts-ignore
|
||||
{ plugin: htmlSlug, options: {} },
|
||||
@@ -54,6 +54,12 @@ const defaultMetaPlugins = [
|
||||
*/
|
||||
async function mdjsProcess(mdjs, { setupUnifiedPlugins = [] } = {}) {
|
||||
const parser = unified();
|
||||
if (!prismLoaded) {
|
||||
prismLoaded = true;
|
||||
const rehypePrism = (await import('rehype-prism/lib/src/index.js')).default;
|
||||
loadLanguages(['md', 'shell', 'yml']);
|
||||
defaultMetaPlugins.splice(6, 0, { plugin: rehypePrism, options: {} });
|
||||
}
|
||||
|
||||
const metaPlugins = executeSetupFunctions(setupUnifiedPlugins, defaultMetaPlugins);
|
||||
|
||||
|
||||
@@ -35,7 +35,7 @@ describe('mdjsProcess', () => {
|
||||
'',
|
||||
'',
|
||||
'',
|
||||
'<pre class="language-js"><code class="language-js"><span class="token keyword module">export</span> <span class="token keyword">const</span> <span class="token function-variable function">fooPreviewStory</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 punctuation">}</span>',
|
||||
'<pre class="language-js"><code class="language-js"><span class="token keyword">export</span> <span class="token keyword">const</span> <span class="token function-variable function">fooPreviewStory</span> <span class="token operator">=</span> <span class="token punctuation">(</span><span class="token punctuation">)</span> <span class="token operator">=></span> <span class="token punctuation">{</span><span class="token punctuation">}</span>',
|
||||
'</code></pre>',
|
||||
'',
|
||||
'',
|
||||
|
||||
@@ -28,6 +28,24 @@ describe('mdjsParse', () => {
|
||||
expect(/** @type {MDJSVFileData} */ (result.data).jsCode).to.equal('const bar = 22;');
|
||||
});
|
||||
|
||||
it('extracts "js client" code blocks', async () => {
|
||||
const input = [
|
||||
'## Intro',
|
||||
'```js',
|
||||
'const foo = 1;',
|
||||
'```',
|
||||
'```js client',
|
||||
'const bar = 22;',
|
||||
'```',
|
||||
].join('\n');
|
||||
const parser = unified().use(markdown).use(mdjsParse).use(html, { sanitize: false });
|
||||
const result = await parser.process(input);
|
||||
expect(result.contents).to.equal(
|
||||
'<h2>Intro</h2>\n<pre><code class="language-js">const foo = 1;\n</code></pre>\n',
|
||||
);
|
||||
expect(/** @type {MDJSVFileData} */ (result.data).jsCode).to.equal('const bar = 22;');
|
||||
});
|
||||
|
||||
// TODO: fix this bug - maybe something in unified itself 🤔
|
||||
it.skip('handling only "js script" code blocks', async () => {
|
||||
const input = [
|
||||
|
||||
6
packages/mdjs-core/types/remark.d.ts
vendored
6
packages/mdjs-core/types/remark.d.ts
vendored
@@ -28,12 +28,6 @@ declare module 'rehype-autolink-headings' {
|
||||
export = unified.Plugin;
|
||||
}
|
||||
|
||||
declare module 'rehype-prism-template' {
|
||||
import unified from 'unified';
|
||||
|
||||
export = unified.Plugin;
|
||||
}
|
||||
|
||||
declare module 'unist-util-remove' {
|
||||
import unified from 'unified';
|
||||
|
||||
|
||||
@@ -20,8 +20,8 @@
|
||||
"./define": "./src/define/define.js"
|
||||
},
|
||||
"scripts": {
|
||||
"prepublishOnly": "publish-docs --github-url https://github.com/modernweb-dev/rocket/ --git-root-dir ../../",
|
||||
"debug": "cd ../../ && npm run debug -- --group mdjs-preview",
|
||||
"prepublishOnly": "publish-docs --github-url https://github.com/modernweb-dev/rocket/ --git-root-dir ../../",
|
||||
"test": "npm run test:web",
|
||||
"test:web": "cd ../../ && npm run test:web -- --group mdjs-preview"
|
||||
},
|
||||
|
||||
@@ -1,5 +1,11 @@
|
||||
# plugins-manager
|
||||
|
||||
## 0.3.1
|
||||
|
||||
### Patch Changes
|
||||
|
||||
- 7e277cd: Add a "hidden" feature in addPlugin that if you attach a `wrapPlugin` property to the returning function it will call `wrapPlugin` on the plugin before adding it.
|
||||
|
||||
## 0.3.0
|
||||
|
||||
### Minor Changes
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "plugins-manager",
|
||||
"version": "0.3.0",
|
||||
"version": "0.3.1",
|
||||
"publishConfig": {
|
||||
"access": "public"
|
||||
},
|
||||
|
||||
@@ -1,3 +1,4 @@
|
||||
/* eslint-disable @typescript-eslint/ban-ts-comment */
|
||||
/**
|
||||
* @template {import('../types/main').Plugin} T
|
||||
* @param {T} plugin
|
||||
@@ -12,6 +13,10 @@ export function addPlugin(plugin, options = {}, { how = 'after', location = 'bot
|
||||
if (plugins === undefined) {
|
||||
plugins = [];
|
||||
}
|
||||
|
||||
// @ts-ignore
|
||||
const usePlugin = addPluginFn.wrapPlugin ? addPluginFn.wrapPlugin(plugin) : plugin;
|
||||
|
||||
// only add if name is not already in the meta plugin list
|
||||
if (plugins.findIndex(pluginObj => pluginObj.plugin === plugin) === -1) {
|
||||
let index = -1;
|
||||
@@ -40,7 +45,7 @@ export function addPlugin(plugin, options = {}, { how = 'after', location = 'bot
|
||||
}
|
||||
|
||||
plugins.splice(index, 0, {
|
||||
plugin,
|
||||
plugin: usePlugin,
|
||||
options,
|
||||
});
|
||||
}
|
||||
|
||||
@@ -109,4 +109,18 @@ describe('addPlugin', () => {
|
||||
});
|
||||
expect(config.plugins).to.deep.equal(['-- newFirst last Plugin --']);
|
||||
});
|
||||
|
||||
it('[advanced] can add a `wrapPlugin` property to the function itself which will call it on the plugin on init', async () => {
|
||||
function myWrapper(plugin) {
|
||||
return () => 'wrapped' + plugin();
|
||||
}
|
||||
|
||||
const config = applyPlugins({
|
||||
setupPlugins: [addPlugin(insertPlugin)].map(mod => {
|
||||
mod.wrapPlugin = myWrapper;
|
||||
return mod;
|
||||
}),
|
||||
});
|
||||
expect(config.plugins).to.deep.equal(['wrapped-- first last Plugin --']);
|
||||
});
|
||||
});
|
||||
|
||||
Reference in New Issue
Block a user