fix(deps): update remark monorepo (major)

[renovate]

This PR contains the following updates:

Package	Type	Update	Change
remark-frontmatter	dependencies	major	2.0.0 -> 3.0.0
remark-react	dependencies	major	7.0.1 -> 8.0.0

---

Release Notes

remarkjs/remark-frontmatter

v3.0.0

Compare Source

• fb1357b Update for micromark in remark@13
  (breaking, this update will not work for remark lower than v13)

remarkjs/remark-react

v8.0.0

Compare Source

• f1c83f9 Update dependencies
  (breaking, potentially, see commit for details)

---

Renovate configuration

📅 Schedule: "before 3am on Monday" (UTC).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻️ Rebasing: Renovate will not automatically rebase this PR, because other commits have been found.

👻 Immortal: This PR will be recreated if closed unmerged. Get config help if that's undesired.

---

• If you want to rebase/retry this PR, check this box

---

This PR has been generated by WhiteSource Renovate. View repository job log here.

[changeset-bot]

🦋 Changeset detected

Latest commit: 2c81526

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 7 packages

Name	Type
@commercetools-docs/gatsby-theme-docs	Patch
@commercetools-docs/gatsby-theme-api-docs	Patch
@commercetools-docs/gatsby-theme-code-examples	Patch
@commercetools-docs/gatsby-theme-constants	Patch
@commercetools-website/api-docs-smoke-test	Patch
@commercetools-website/docs-smoke-test	Patch
@commercetools-website/site-template	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployment, click below or on the icon next to each commit.

🔍 Inspect: https://vercel.com/commercetools/commercetools-docs-kit/fp5utsnk4
✅ Preview: https://commercetools-docs-kit-git-renovate-major-remark-monorepo.commercetools.vercel.app

[emmenko]

This requires some investigation around the usage of the commonmark: true option, which has been removed now.

commercetools-docs-kit/packages/gatsby-theme-docs/src/utils/markdown-fragment-to-react.js

Line 39 in 24a0f4b

.use(markdown, { commonmark: true })

syntax-tree/mdast-util-to-hast@142e973

cc @nkuehn

[nkuehn]

@emmenko good catch thanks!

remark-react 8 is using an alpha of remark 13, so we'll have to wait here. ( https://github.com/remarkjs/remark-react/blob/8.0.0/package.json#L54 )

remark 13 switches to micromark, which again defaults to commonmark, so we'll maybe have to wait until remark 13 is released and we can upgrade everything remark related at once.
remarkjs/remark#536

[wooorm]

This PR should be good to go if you switch to the alpha of remark-parse, remark-parse": "9.0.0-alpha.1. The remark plugin in that package.json are updated

[emmenko]

@wooorm thanks for the hint. We'll try that!

[emmenko]

@wooorm using version 9.0.0-alpha.1 seems to fix most of the issue.
The only think that looks broken now is the markdown table, which don't seem to get parsed.

Do we need to change/configure something in that regards? Thanks

[wooorm]

Please see the aforementioned issue, it mentions that you now need remark-gfm for gfm

[emmenko]

Thanks again, I missed that point.

[wooorm]

Looks wonderful!

[emmenko]

@nkuehn should we put this on hold, are you comfortable shipping this? We can also wait that the stable 9.0.0 is released.

[nkuehn]

(lost my whole explanation by closing the browser - so here's a short form only)

TL;DR: We actually don't want tables in this fragment renderer, which is intended for MD snippets rendered inside lists, table cells and other smaller data driven compartments. The whole fuss with overriding the table rendering with a bullet list was just here because the current code seems to have silently do GFM (or parts of it) without having to explicitly ask it. Autolinks are even actively discouraged in documentation, you want choice over whether a string that looks like a URL is a link or not.

• I vote for removing GFM support here altogether and remove the test case (which was just there to test the workaround). I don't know of production code that has tables in MD fragments or lead paragraph snippets.
• I would prefer freezing this until remark is released as stable. No urge to use alpha release software without specific need.

[wooorm]

to add about remark: a) it’s table, I’ll publish it tomorrow as is, b) gfm is no longer on by default, but in remark-gfm!

[nkuehn]

"pre-approve" for when the new remark is released stable. Thanks for your help @wooorm !