refactor(v2): docs plugin refactor (#3245)

* safe refactorings

* safe refactors

* add code to read versions more generically

* refactor docs plugin

* refactors

* stable docs refactor

* progress on refactor

* stable docs refactor

* stable docs refactor

* stable docs refactor

* attempt to fix admonition :(

* configureWebpack docs: better typing

* more refactors

* rename cli

* refactor docs metadata processing => move to pure function

* stable docs refactor

* stable docs refactor

* named exports

* basic sidebars refactor

* add getElementsAround utils

* refactor sidebar + ordering/navigation logic

* stable retrocompatible refactor

* add proper versions metadata tests

* fix docs metadata tests

* fix docs tests

* fix test due to absolute path

* fix webpack tests

* refactor linkify + add broken markdown links warning

* fix DOM warning due to forwarding legacy prop to div element

* add todo

.eslintrc.js

@@ -87,6 +87,7 @@ module.exports = {
       {functions: false, classes: false, variables: true},
     ],
     'no-unused-vars': OFF,
+    'no-nested-ternary': WARNING,
     '@typescript-eslint/no-unused-vars': [ERROR, {argsIgnorePattern: '^_'}],
     '@typescript-eslint/ban-ts-comment': [
       ERROR,

packages/docusaurus-plugin-content-docs/package.json

@@ -14,6 +14,7 @@
   "devDependencies": {
     "@docusaurus/module-type-aliases": "^2.0.0-alpha.61",
     "@types/hapi__joi": "^17.1.2",
+    "@types/picomatch": "^2.2.1",
     "commander": "^5.0.0",
     "picomatch": "^2.1.1"
   },
@@ -37,7 +38,9 @@
     "lodash.pickby": "^4.6.0",
     "lodash.sortby": "^4.6.0",
     "remark-admonitions": "^1.2.1",
-    "shelljs": "^0.8.4"
+    "shelljs": "^0.8.4",
+    "utility-types": "^3.10.0",
+    "webpack": "^4.41.2"
   },
   "peerDependencies": {
     "react": "^16.8.4",

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/empty-site/sidebars.json

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

packages/docusaurus-plugin-content-docs/src/__tests__/__fixtures__/versioned-site/versioned_sidebars/version-withSlugs-sidebars.json

@@ -0,0 +1,5 @@
+{
+  "version-1.0.1/docs": {
+    "Test": ["version-withSlugs/rootAbsoluteSlug"]
+  }
+}