.eslintrc.js

@@ -17,7 +17,7 @@ module.exports = {
       version: 'detect',
     },
   },
-  plugins: ['react', 'react-hooks', '@typescript-eslint', 'import'],
+  plugins: ['@typescript-eslint', 'import'],
   rules: {
     '@typescript-eslint/explicit-function-return-type': 'off',
     '@typescript-eslint/explicit-module-boundary-types': 'off',
@@ -31,8 +31,6 @@ module.exports = {
     '@typescript-eslint/no-var-requires': 'off',
 
     'react/prop-types': 'off',
-    'react-hooks/rules-of-hooks': 'error',
-    'react-hooks/exhaustive-deps': 'warn',
 
     'import/no-extraneous-dependencies': 'error',
     'import/no-internal-modules': [

.github/CODEOWNERS

@@ -1,2 +0,0 @@
-* @Redocly/keyboard-warriors
-/docs/ @Redocly/technical-writers

.github/CONTRIBUTING.md

@@ -1,13 +1,11 @@
-# Redoc Contributing Guide
+# ReDoc Contributing Guide
 
-Hi! We're really excited that you are interested in contributing to Redoc. Before submitting your contribution though, please make sure to take a moment and read through the following guidelines.
+Hi! We're really excited that you are interested in contributing to ReDoc. Before submitting your contribution though, please make sure to take a moment and read through the following guidelines.
 
-- [Redoc Contributing Guide](#redoc-contributing-guide)
-  - [Issue Reporting Guidelines](#issue-reporting-guidelines)
-  - [Pull Request Guidelines](#pull-request-guidelines)
-  - [Development Setup](#development-setup)
-    - [Commonly used NPM scripts](#commonly-used-npm-scripts)
-  - [Project Structure](#project-structure)
+- [Issue Reporting Guidelines](#issue-reporting-guidelines)
+- [Pull Request Guidelines](#pull-request-guidelines)
+- [Development Setup](#development-setup)
+- [Project Structure](#project-structure)
 
 ## Issue Reporting Guidelines
 - Before filing a new issue, try to make sure your problem doesn’t already exist.
@@ -16,7 +14,7 @@ Hi! We're really excited that you are interested in contributing to Redoc. Befor
 ## Pull Request Guidelines
 Before submitting a pull request, please make sure the following is done:
 
-1. Fork the repository and create your branch from main.
+1. Fork the repository and create your branch from master.
 2. Run `npm install` in the repository root.
 3. If you’ve fixed a bug or added code that should be tested, add tests!
 4. Ensure the test suite passes (`npm test`). Tip: `npm test -- --watch TestName` is helpful in development.
@@ -24,7 +22,7 @@ Before submitting a pull request, please make sure the following is done:
 
 ## Development Setup
 
-You need [Node.js](http://nodejs.org) at `v12.0.0+`.
+You will need [Node.js](http://nodejs.org) at `v12.0.0+`.
 
 After cloning the repo, run:
 
@@ -90,7 +88,7 @@ There are some other scripts available in the `scripts` section of the `package.
 
   - **`src/common-elements`**: contains common Styled elements or components used in multiple places
   - **`src/components`**: contains main visual components
-  - **`src/services`**: contains different services used by Redoc including MobX stores
+  - **`src/services`**: contains different services used by ReDoc including MobX stores
   - **`src/services/models`**: contains classes for OpenAPI entities (e.g. Response, Operations, etc)
   - **`src/types`**: contains extra typescript typings including OpenAPI doc typings
   - **`src/utils`**: utility functions

.github/ISSUE_TEMPLATE/bug_report.md

@@ -2,7 +2,7 @@
 name: Bug report
 about: Create a report to help us improve
 title: ''
-labels: 'Type: Bug'
+labels: 'type: bug'
 assignees: ''
 
 ---

.github/ISSUE_TEMPLATE/feature_request.md

@@ -2,7 +2,7 @@
 name: Feature request
 about: Suggest an idea for this project
 title: ''
-labels: 'Type: Enhancement'
+labels: ''
 assignees: ''
 
 ---
@@ -17,4 +17,4 @@ A clear and concise description of what you want to happen.
 A clear and concise description of any alternative solutions or features you've considered.
 
 **Additional context**
-Add any other context or screenshots about the feature request here.
+Add any other context or screenshots about the feature request here.

.github/pull_request_template.md

@@ -2,7 +2,7 @@
 
 ## Reference
 
-## Tests
+## Testing
 
 ## Screenshots (optional)
 

.github/styles/Rules/BritishEnglish.yml

@@ -1,110 +0,0 @@
-extends: substitution
-message: 'Use the US spelling "%s" instead of British "%s".'
-link: https://docs.microsoft.com/en-us/style-guide/word-choice/use-us-spelling-avoid-non-english-words
-level: error
-ignorecase: true
-swap:
-  aeon: eon
-  aeroplane: airplane
-  ageing: aging
-  aluminium: aluminum
-  anaemia: anemia
-  anaesthesia: anesthesia
-  analyse: analyze
-  annexe: annex
-  apologise: apologize
-  behaviour: behavior
-  busses: buses
-  calibre: caliber
-  cancelled: canceled
-  cancellation: cancelation
-  catalogue: catalog
-  categorise: categorize
-  categorised: categorized
-  categorises: categorizes
-  categorising: categorizing
-  centre: center
-  cheque: check
-  civilisation: civilization
-  civilise: civilize
-  colour: color
-  cosy: cozy
-  cypher: cipher
-  dependant: dependent
-  defence: defense
-  distil: distill
-  draught: draft
-  encyclopaedia: encyclopedia
-  enquiry: inquiry
-  enrol: enroll
-  enrolment: enrollment
-  enthral: enthrall
-  expiry: expiration
-  favourite: favorite
-  fibre: fiber
-  fillet: filet
-  flavour: flavor
-  furore: furor
-  fulfil: fulfill
-  gaol: jail
-  grey: gray
-  humour: humor
-  honour: honor
-  initialled: initialed
-  initialling: initialing
-  instil: instill
-  jewellery: jewelry
-  labelling: labeling
-  labelled: labeled
-  labour: labor
-  libellous: libelous
-  licence: license
-  likeable: likable
-  liveable: livable
-  lustre: luster
-  manoeuvre: maneuver
-  marvellous: marvelous
-  matt: matte
-  meagre: meager
-  metre: meter
-  modelling: modeling
-  moustache: mustache
-  neighbour: neighbor
-  normalise: normalize
-  offence: offense
-  organise: organize
-  organisation: organization
-  orientated: oriented
-  paralyse: paralyze
-  plough: plow
-  pretence: pretense
-  programme: program
-  pyjamas: pajamas
-  rateable: ratable
-  realise: realize
-  recognise: recognize
-  reconnoitre: reconnoiter
-  rumour: rumor
-  sabre: saber
-  saleable: salable
-  saltpetre: saltpeter
-  sceptic: skeptic
-  sepulchre: sepulcher
-  signalling: signaling
-  sizeable: sizable
-  skilful: skillful
-  sombre: somber
-  smoulder: smolder
-  speciality: specialty
-  spectre: specter
-  splendour: splendor
-  standardise: standardize
-  standardised: standardized
-  sulphur: sulfur
-  theatre: theater
-  travelled: traveled
-  traveller: traveler
-  travelling: traveling
-  unshakeable: unshakable
-  wilful: willful
-  yoghurt: yogurt

.github/styles/Rules/FutureTense.yml

@@ -1,10 +0,0 @@
-extends: existence
-message: 'Avoid using future tense: "%s". Use present tense instead.'
-link: https://intranet.redoc.ly/contributing/documentation-style-guide/#tone-and-audience
-ignorecase: true
-level: error
-raw:
-  - "(going to( |\n|[[:punct:]])[a-zA-Z]*|"
-  - "will( |\n|[[:punct:]])[a-zA-Z]*|"
-  - "won't( |\n|[[:punct:]])[a-zA-Z]*|"
-  - "[a-zA-Z]*'ll( |\n|[[:punct:]])[a-zA-Z]*)"

.github/styles/Rules/HeaderGerunds.yml

@@ -1,11 +0,0 @@
-extends: existence
-message: 'Do not start headings with with a gerund (ing word). Use an imperative verb instead.'
-link: https://intranet.redoc.ly/contributing/documentation-style-guide/#content-organization
-level: error
-scope: heading
-tokens:
-  - '^\w*ing.*'
-exceptions:
-  - expandSingleSchemaField
-  - hideLoading
-  - hideSingleRequestSampleTab

.github/styles/Rules/InclusionGenderCulture.yml

@@ -1,16 +0,0 @@
-extends: substitution
-message: 'Use inclusive language. Consider "%s" instead of "%s".'
-link: https://intranet.redoc.ly/contributing/documentation-style-guide/#grammar-and-syntax
-level: error
-ignorecase: true
-swap:
-  he: they
-  his: their
-  she: they
-  hers: their
-  blacklist(?:ed|ing|s)?: blocklist
-  whitelist(?:ed|ing|s)?: allowlist
-  master: primary, main
-  slave: replica
-  he/she: they
-  s/he: they

.github/styles/Rules/OxfordComma.yml

@@ -1,8 +0,0 @@
-extends: existence
-message: "Use the Oxford comma in '%s'."
-link: https://docs.microsoft.com/en-us/style-guide/punctuation/commas
-scope: sentence
-level: error
-nonword: true
-tokens:
-  - '(?:[^\s,]+,){1,} \w+ (?:and|or) \w+[.?!]'

.github/styles/config/vocabularies/Rules/accept.txt

@@ -1,150 +0,0 @@
-[Aa]nsible
-[Aa]utostart
-[Bb]locklist
-[Bb]locklists
-[Bb]oolean
-[Bb]reakpoint
-[B]reakpoints
-[Cc]ancelation
-[Cc]lassloading
-[Cc]hargeback
-[Cc]hargebacks
-[Cc]he
-[Cc]rypto
-[Cc]ryptocurrency
-[Dd]evfile|[Dd]evfiles
-[Dd]ownstream
-[Dd]ownstreaming
-[Ff]actories|[Ff]actory
-[Gg]it
-[Gg]rafana
-[Hh]eatmap
-[Hh]elm
-[Hh]ostname
-[Ii]tem
-[Jj]etbrains
-[Kk]eycloak
-[Ll]iveness
-[Ll]ombok
-[Ll]oopback
-[Mm]aven
-[Mm]inikube
-[Mm]inishift
-[Mm]ixin|[Mm]ixins
-[Mm]odularization
-[Mm]ulticluster
-[Mm]ultihost
-[Mm]ultinode
-[Mm]ultitenant
-[Mm]ultiuser
-[Mm]ultizone
-[Nn]amespace|[Nn]amespaces
-[Nn]etcoredebug[Oo]utput
-[Nn]ginx
-[Oo]nboarding
-[Pp]podman
-[Pp]reconfigured
-[Rr]eadonly
-[Rr]epresentment
-[Rr]ollout|[Rr]ollouts
-[Rr]untime|[Rr]untimes
-[Ss]erializer
-[Ss]erverless
-[Ss]ubnetwork
-[Ss]ubpath|[Ss]ubpaths
-[Tt]heia
-[Tt]olerations
-[Tt]ruststore
-[Uu]ninstallation
-[Uu]nstaged
-[Uu]ntrusted
-[Ww]orkspace|[Ww]orkspaces
-[Yy]eoman
-\.NET
-adoc
-Antora
-API
-Apigee
-AsciiDoc
-AWS|aws
-Azure
-Bierner
-Bitbucket
-btn
-Btrfs
-CentOS
-Ceph
-Che-Theia
-CLI
-ConfigMap|ConfigMaps
-Ctrl
-DaemonSet
-Dev Workspace
-Developer Perspective
-DNS
-Docker
-Dockerfile
-Dotnet
-Endevor
-endif
-GitHub|github
-GitLab
-Gluster
-Gradle
-Grafana
-GUI
-HTTPS|https
-I/O
-IDE|ide|IDEs
-Intelephense
-IntelliJ IDEA
-Java
-Java Lombok
-JSON|json
-JVM|jvm
-kbd
-Kubespray
-Laravel
-Let\'s Encrypt
-Mattermost
-mebibytes
-Microsoft Azure
-millicores
-Mulesoft
-MySQL
-Netlify
-Node.js
-npm
-NuGet
-OAuth
-ocp
-OmniSharp
-OpenShift
-OpenTracing
-Operator
-OperatorHub
-OpenAPI
-osd
-PHP
-PostgreSQL
-Quarkus
-Rebilly
-Redoc
-Redocly
-Redocly-cli
-SCM
-Sharding
-SonarLint
-Spring Boot
-SVG
-Uber
-URI|URIs
-URL|url|URLs
-Velero
-Vercel
-Visual Studio Code
-vsix
-Webview|Webviews
-Woopra
-YAML|yaml
-Zowe

.github/sync.yml

@@ -0,0 +1,6 @@
+group:
+  - files:
+      - source: docs/
+        dest: docs/redoc
+    repos: |
+      Redocly/docs

.github/workflows/docs-tests.yaml

@@ -1,37 +0,0 @@
-name: Documentation tests
-on:
-  pull_request:
-    types: [opened, synchronize, reopened]
-
-jobs:
-  markdownlint:
-    name: markdownlint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: DavidAnson/markdownlint-cli2-action@v15
-        with:
-          config: .markdownlint.yaml
-          globs: |
-            docs/**/*.md
-            README.md
-
-  vale:
-    name: vale action
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: errata-ai/vale-action@reviewdog
-        with:
-          files: '["README.md", "docs"]'
-          filter_mode: file
-
-  linkcheck:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-      - name: Markup Link Checker (mlc)
-        uses: becheran/mlc@v0.16.1
-        with:
-          args: ./docs

.github/workflows/e2e-tests.yml

@@ -6,7 +6,7 @@ jobs:
   build-and-e2e:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - run: npm ci
-      - run: npm run bundle
-      - run: npm run e2e
+    - uses: actions/checkout@v2
+    - run: npm ci
+    - run: npm run bundle
+    - run: npm run e2e

.github/workflows/main.yml

@@ -3,37 +3,43 @@ on:
   release:
     types: [published]
 jobs:
-  dockerhub:
-    name: Publish redoc image to DockerHub
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
     runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
     steps:
-      - name: Checkout
-        uses: actions/checkout@v3
-
-      - name: Docker meta
-        id: docker_meta
-        uses: crazy-max/ghaction-docker-meta@v1
-        with:
-          images: redocly/redoc
-
-      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v1
-
-      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v1
-
-      - name: Login to DockerHub
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Login to GitHub Container Registry
         uses: docker/login-action@v1
         with:
-          username: ${{ secrets.DOCKERHUB_USERNAME }}
-          password: ${{ secrets.DOCKERHUB_TOKEN }}
-
-      - name: Build and push
-        uses: docker/build-push-action@v3
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Prepare
+        id: prep
+        run: |
+          DOCKER_IMAGE=ghcr.io/redocly/redoc/cli
+          VERSION=edge
+          if [[ $GITHUB_REF == refs/tags/* ]]; then
+            VERSION=${GITHUB_REF#refs/tags/}
+          elif [[ $GITHUB_REF == refs/heads/* ]]; then
+            VERSION=$(echo ${GITHUB_REF#refs/heads/} | sed -r 's#/+#-#g')
+          elif [[ $GITHUB_REF == refs/pull/* ]]; then
+            VERSION=pr-${{ github.event.number }}
+          fi
+          TAGS="${DOCKER_IMAGE}:${VERSION}"
+          if [ "${{ github.event_name }}" = "push" ]; then
+            TAGS="$TAGS,${DOCKER_IMAGE}:sha-${GITHUB_SHA::8}"
+          fi
+          echo ::set-output name=version::${VERSION}
+          echo ::set-output name=tags::${TAGS}
+          echo ::set-output name=created::$(date -u +'%Y-%m-%dT%H:%M:%SZ')
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v2
         with:
-          context: .
-          file: ./config/docker/Dockerfile
-          platforms: linux/amd64,linux/arm64
-          push: true
-          tags: ${{ steps.docker_meta.outputs.tags }}
-          labels: ${{ steps.docker_meta.outputs.labels }}
+          context: ./cli
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.prep.outputs.tags }}

.github/workflows/publish-cli.yml

@@ -0,0 +1,121 @@
+name: Publish cli
+
+on:
+  push:
+    branches:
+      - master
+
+
+jobs:
+  bundle:
+    needs: [ check-version-cli ]
+    if: needs.check-version-cli.outputs.changed == 'true'
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-node@v2
+    - name: Cache node modules
+      uses: actions/cache@v2
+      with:
+        path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+        key: npm-${{ hashFiles('package-lock.json') }}
+        restore-keys: |
+          npm-${{ hashFiles('package-lock.json') }}
+          npm-
+    - run: npm ci
+    - run: npm run bundle
+    - name: Store bundle artifact
+      uses: actions/upload-artifact@v2
+      with:
+        name: bundles-cli
+        path: bundles
+        retention-days: 1
+  unit-tests:
+    needs: [ check-version-cli ]
+    if: needs.check-version-cli.outputs.changed == 'true'
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - run: npm test
+  e2e-tests:
+    needs: [ bundle ]
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - name: Download bundled artifact
+      uses: actions/download-artifact@v2
+      with:
+        name: bundles-cli
+        path: bundles
+    - run: npm run e2e
+  bundle-cli:
+    needs: [ check-version-cli ]
+    if: needs.check-version-cli.outputs.changed == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+      - name: Cache node modules
+        uses: actions/cache@v2
+        with:
+          path: ~/.npm
+          key: npm-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            npm-${{ hashFiles('package-lock.json') }}
+            npm-
+      - name: Install dependencies
+        run: npm ci
+      - name: Bundle
+        run: npm run compile:cli
+      - name: Store bundle artifact
+        uses: actions/upload-artifact@v2
+        with:
+          name: cli
+          path: cli
+          retention-days: 1
+  check-version-cli:
+    name: Check Version
+    runs-on: ubuntu-latest
+    outputs:
+      changed: ${{ steps.check.outputs.changed }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: Set up Node.js
+        uses: actions/setup-node@v2
+      - name: Check if version has been updated
+        id: check
+        uses: EndBug/version-check@v2.0.1
+        with:
+          file-name: ./cli/package.json
+          file-url: https://unpkg.com/redoc-cli/package.json
+          static-checking: localIsNew
+  publish-cli:
+    needs: [bundle-cli, unit-tests, e2e-tests]
+    if: needs.check-version-cli.outputs.changed == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-node@v1
+        with:
+          node-version: "14.x"
+          registry-url: 'https://registry.npmjs.org'
+      - uses: actions/checkout@v2
+      - name: Download cli bundled artifact
+        uses: actions/download-artifact@v2
+        with:
+          name: cli
+          path: cli
+      - name: Cache node modules
+        uses: actions/cache@v2
+        with:
+          path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+          key: npm-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            npm-${{ hashFiles('package-lock.json') }}
+            npm-
+      - name: Publish to NPM
+        run: cd cli/ && npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.github/workflows/publish.yml

@@ -2,83 +2,90 @@ name: Publish
 
 on:
   push:
-    branches: [main]
+    tags:
+      - v[0-9]*.[0-9]*.[0-9]*
 
 jobs:
   bundle:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-node@v3
-      - name: Cache node modules
-        uses: actions/cache@v3
-        with:
-          path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
-          key: npm-${{ hashFiles('package-lock.json') }}
-          restore-keys: |
-            npm-${{ hashFiles('package-lock.json') }}
-            npm-
-      - run: npm ci
-      - run: npm run bundle
-      - name: Store bundle artifact
-        uses: actions/upload-artifact@v4
-        with:
-          name: bundles
-          path: bundles
-          retention-days: 1
+    - uses: actions/checkout@v2
+    - uses: actions/setup-node@v2
+    - name: Cache node modules
+      uses: actions/cache@v2
+      with:
+        path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+        key: npm-${{ hashFiles('package-lock.json') }}
+        restore-keys: |
+          npm-${{ hashFiles('package-lock.json') }}
+          npm-
+    - run: npm ci
+    - run: npm run bundle
+    - name: Store bundle artifact
+      uses: actions/upload-artifact@v2
+      with:
+        name: bundles
+        path: bundles
+        retention-days: 1
   unit-tests:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - run: npm ci
-      - run: npm test
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - run: npm test
   e2e-tests:
     needs: [bundle]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - run: npm ci
-      - name: Download bundled artifact
-        uses: actions/download-artifact@v4
-        with:
-          name: bundles
-          path: bundles
-      - run: npm run e2e
-  check-version:
-    name: Check Version
-    runs-on: ubuntu-latest
-    needs: [bundle, unit-tests, e2e-tests]
-    outputs:
-      changed: ${{ steps.check.outputs.changed }}
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-      - name: Check if version has been updated
-        id: check
-        uses: EndBug/version-check@v2.0.1
-        with:
-          file-url: https://cdn.jsdelivr.net/npm/redoc/package.json
-          static-checking: localIsNew
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - name: Download bundled artifact
+      uses: actions/download-artifact@v2
+      with:
+        name: bundles
+        path: bundles
+    - run: npm run e2e
+  # disable this for now
+  # deploy-demo:
+  #   needs: [bundle, unit-tests, e2e-tests]
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/checkout@v1
+  #     - name: Configure AWS Credentials
+  #       uses: aws-actions/configure-aws-credentials@v1
+  #       with:
+  #         aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+  #         aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+  #         aws-region: us-east-1
+  #     - name: Install dependencies
+  #       run: npm ci
+  #     - name: Download bundled artifacts
+  #       uses: actions/download-artifact@v2
+  #       with:
+  #         name: bundles
+  #         path: bundles
+  #     - name: Build package
+  #       run: npm run build:demo
+  #     - name: Deploy to S3 bucket
+  #       run: npm run deploy:demo
+  #     - name: Invalidate
+  #       run: aws cloudfront create-invalidation --distribution-id ${{ secrets.CF_DEMO_DISTRIBUTION_ID }} --paths "/*"
   publish:
-    name: Publish to NPM
-    needs: [check-version]
-    if: needs.check-version.outputs.changed == 'true'
+    needs: [bundle, unit-tests, e2e-tests]
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v1
         with:
-          node-version: '14.x'
+          node-version: "14.x"
           registry-url: 'https://registry.npmjs.org'
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v2
       - name: Download bundled artifacts
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v2
         with:
           name: bundles
           path: bundles
       - name: Cache node modules
-        uses: actions/cache@v3
+        uses: actions/cache@v2
         with:
           path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
           key: npm-${{ hashFiles('package-lock.json') }}
@@ -91,42 +98,3 @@ jobs:
         run: npm publish
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-
-  publish-cdn:
-    name: Publish to CDN
-    needs: [check-version]
-    if: needs.check-version.outputs.changed == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-      - name: Configure AWS
-        uses: aws-actions/configure-aws-credentials@v1
-        with:
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          aws-region: us-east-1
-      - name: Download all artifact
-        uses: actions/download-artifact@v4
-      - name: Publish to S3
-        run: npm run publish-cdn
-
-  invalidate-cache:
-    name: Clear cache
-    runs-on: ubuntu-latest
-    needs: [check-version, publish, publish-cdn]
-    if: needs.check-version.outputs.changed == 'true'
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
-      - name: Configure AWS
-        uses: aws-actions/configure-aws-credentials@v1
-        with:
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          aws-region: us-east-1
-      - name: Invalidate cache
-        run: ./scripts/invalidate-cache.sh
-        shell: bash
-        env:
-          DISTRIBUTION: ${{ secrets.DISTRIBUTION }}

.github/workflows/sync.yml

@@ -0,0 +1,18 @@
+name: Sync Files
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+jobs:
+  sync:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@master
+      - name: Run GitHub File Sync
+        uses: Redocly/repo-file-sync-action@master
+        with:
+          GH_PAT: ${{ secrets.GH_PAT }}
+          COMMIT_PREFIX: "sync:"
+          SKIP_PR: true

.github/workflows/unit-tests.yml

@@ -6,7 +6,7 @@ jobs:
   build-and-unit:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - run: npm ci
-      - run: npm run bundle
-      - run: npm test
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - run: npm run bundle
+    - run: npm test

.gitignore

@@ -27,6 +27,7 @@ cypress/
 bundles/
 typings/*
 !typings/styled-patch.d.ts
+cli/index.js
 
 /benchmark/revisions
 
@@ -36,4 +37,3 @@ stats.json
 yarn.lock
 .idea
 .vscode
-.eslintcache

.markdownlint.yaml

@@ -1,54 +0,0 @@
----
-# Default rules: https://github.com/github/super-linter/blob/master/TEMPLATES/.markdown-lint.yml
-
-# Rules by id
-
-# Unordered list style
-MD004: false
-
-# Unordered list indentation
-MD007:
-  indent: 2
-
-MD013:
-  # TODO: Consider to decrease allowed line length
-  line_length: 800
-  tables: false
-
-## Allow same headers in siblings
-MD024:
-  siblings_only: true
-
-# Multiple top level headings in the same document
-MD025:
-  front_matter_title: ''
-
-# Trailing punctuation in heading
-MD026:
-  punctuation: '.,;:。，；:'
-
-# Ordered list item prefix
-MD029: false
-
-# Unordered lists inside of ordered lists
-MD030: false
-
-# Inline HTML
-MD033: false
-
-# No bare urls
-MD034: false
-
-# Emphasis used instead of a heading
-MD036: false
-
-# Disable "First line in file should be a top level heading"
-# We use uncommon format to add metadata.
-# TODO: Consider to use "YAML front matter".
-MD041: false
-
-# Rules by tags
-blank_lines: false
-
-MD046: false
-# code-block-style

.mlc.toml

@@ -1,4 +0,0 @@
-# Ignore these links, we can't check them from this subproject
-ignore-links=["../*", "/docs/*"]
-# Path to the root folder used to resolve all relative paths
-root-dir="./docs"

.vale.ini

@@ -1,48 +0,0 @@
-# Vale configuration file.
-# See: https://docs.errata.ai/vale/config
-
-# The relative path to the folder containing linting rules (styles).
-StylesPath = .github/styles
-
-# Vocab define the exceptions to use in *all* `BasedOnStyles`.
-# spelling-exceptions.txt triggers `Vale.Terms`
-# reject.txt triggers `Vale.Avoid`
-# See: https://docs.errata.ai/vale/vocab
-Vocab = Rules
-
-# Minimum alert level
-# -------------------
-# The minimum alert level in the output (suggestion, warning, or error).
-# If integrated into CI, builds fail by default on error-level alerts, unless you run Vale with the --no-exit flag
-MinAlertLevel = suggestion
-
-# IgnoredScopes specifies inline-level HTML tags to ignore.
-# These tags may occur in an active scope (unlike SkippedScopes, skipped entirely) but their content still won't raise any alerts.
-# Default: ignore `code` and `tt`.
-IgnoredScopes = code, tt, img, url, a, body.id
-# SkippedScopes specifies block-level HTML tags to ignore. Ignore any content in these scopes.
-# Default: ignore `script`, `style`, `pre`, and `figure`.
-# For AsciiDoc: by default, listingblock, and literalblock.
-SkippedScopes = script, style, pre, figure, code, tt, listingblock, literalblock
-
-# Rules for matching file types. See: https://docs.errata.ai/vale/scoping
-
-[formats]
-properties = md
-mdx = md
-
-# Rules for .MD, .MDX
-[*.{md,mdx}]
-
-BasedOnStyles = Rules
-# Ignore code surrounded by backticks or plus sign, parameters defaults, URLs.
-TokenIgnores = (\x60[^\n\x60]+\x60), ([^\n]+=[^\n]*), (\+[^\n]+\+), (http[^\n]+\[)
-Vale.Repetition = NO
-Vale.SentenceSpacing = NO
-Vale.Spelling = NO
-
-# /End of rules for .MD, .MDX
-
-
-# Process .ini files
-[*.ini]

CHANGELOG.md

@@ -1,421 +1,3 @@
-# [2.5.0](https://github.com/Redocly/redoc/compare/v2.4.0...v2.5.0) (2025-04-14)
-
-
-### Bug Fixes
-
-* enhance accessibility for menu items with keyboard support ([#2655](https://github.com/Redocly/redoc/issues/2655)) ([2db293b](https://github.com/Redocly/redoc/commit/2db293bfb2973497dd33f31dc99e97f5bb90bbe8))
-
-
-### Features
-
-* add keyboard navigation support to JsonViewer component ([#2654](https://github.com/Redocly/redoc/issues/2654)) ([1b4126f](https://github.com/Redocly/redoc/commit/1b4126fde4531387f49c90f52efbd0c0e5f7b6ea))
-
-
-
-# [2.4.0](https://github.com/Redocly/redoc/compare/v2.3.0...v2.4.0) (2025-02-07)
-
-
-### Bug Fixes
-
-* Prototype Pollution Vulnerability Affecting redoc <=2.2.0 ([#2638](https://github.com/Redocly/redoc/issues/2638)) ([153ec7a](https://github.com/Redocly/redoc/commit/153ec7a0b7245639f404c0b038b612ae7377c7db))
-* unify redoc config ([#2647](https://github.com/Redocly/redoc/issues/2647)) ([53a6afc](https://github.com/Redocly/redoc/commit/53a6afc59624fe4591b0a0f1f20f41c0fbb5f1cf))
-
-
-### Features
-
-* add supporting react 19 in package.json ([#2652](https://github.com/Redocly/redoc/issues/2652)) ([3a74802](https://github.com/Redocly/redoc/commit/3a748022be3a7dc7f98669e1645dd5cda72f1abc))
-
-
-
-# [2.3.0](https://github.com/Redocly/redoc/compare/v2.2.0...v2.3.0) (2025-01-16)
-
-
-### Bug Fixes
-
-* displaying json example when showObjectSchemaExamples enabled ([#2635](https://github.com/Redocly/redoc/issues/2635)) ([59ee73f](https://github.com/Redocly/redoc/commit/59ee73fefa8e8edb398940076bdd721fc284caa3))
-* displaying nested items with type string ([#2634](https://github.com/Redocly/redoc/issues/2634)) ([85b622f](https://github.com/Redocly/redoc/commit/85b622fc581eb96303aeb85056aef36c74ea9f9d))
-* passing inline parameters after support react 18 for response title ([#2640](https://github.com/Redocly/redoc/issues/2640)) ([d614d2d](https://github.com/Redocly/redoc/commit/d614d2d022df8bd1989cb0eaf76d087b52120d36))
-
-
-### Features
-
-* update pattern styling ([#2196](https://github.com/Redocly/redoc/issues/2196)) ([#2600](https://github.com/Redocly/redoc/issues/2600)) ([aa0879c](https://github.com/Redocly/redoc/commit/aa0879ca0235112918428fdff8f4c48d2c6c4adf))
-
-
-
-# [2.2.0](https://github.com/Redocly/redoc/compare/v2.1.5...v2.2.0) (2024-10-16)
-
-
-### Bug Fixes
-
-* show siblings schema with oneOf ([#2576](https://github.com/Redocly/redoc/issues/2576)) ([60d131b](https://github.com/Redocly/redoc/commit/60d131b0a9dab4710e900323c9ba81160cecf7d8))
-
-
-### Features
-
-* add support x-badges ([#2605](https://github.com/Redocly/redoc/issues/2605)) ([64f1877](https://github.com/Redocly/redoc/commit/64f18779e5fe7e03f25862463cbc5062e85c867c))
-
-
-
-## [2.1.5](https://github.com/Redocly/redoc/compare/v2.1.4...v2.1.5) (2024-06-10)
-
-
-### Bug Fixes
-
-* update react to 18 and react-tabs to 6 ([#2547](https://github.com/Redocly/redoc/issues/2547)) ([c664dd0](https://github.com/Redocly/redoc/commit/c664dd0d56571ce799b8eadd081d86a6b2cdefae))
-
-
-
-## [2.1.4](https://github.com/Redocly/redoc/compare/v2.1.3...v2.1.4) (2024-04-25)
-
-
-### Bug Fixes
-
-* add deprecated css to clickable property name ([#2526](https://github.com/Redocly/redoc/issues/2526)) ([b0d03d0](https://github.com/Redocly/redoc/commit/b0d03d02069c1508447ddebc2f8a3fffa9b03ce5))
-* use h2/h3 for headings instead of h1/h2 for better seo ([#2514](https://github.com/Redocly/redoc/issues/2514)) ([2b72dc0](https://github.com/Redocly/redoc/commit/2b72dc0e90f759a8ee2e47691c844e7f05928a24))
-* security vulnerability ([#2445](https://github.com/Redocly/redoc/pull/2445)) ([1f11f5](https://github.com/Redocly/redoc/commit/1f11f597c4f10ddd601db247f5034052b6ca689f))
-
-
-
-## [2.1.3](https://github.com/Redocly/redoc/compare/v2.1.2...v2.1.3) (2023-10-24)
-
-
-### Bug Fixes
-
-* default value as object in request body ([#2437](https://github.com/Redocly/redoc/issues/2437)) ([b36a6e2](https://github.com/Redocly/redoc/commit/b36a6e27bb3e03d39ee74c3e71f18a504539d91b))
-* display string pattern in array items ([#2438](https://github.com/Redocly/redoc/issues/2438)) ([8ddeb6d](https://github.com/Redocly/redoc/commit/8ddeb6dfda686ec8a6948eb2d96efb99bf422429))
-* hideRequestPayloadSample ([#2436](https://github.com/Redocly/redoc/issues/2436)) ([bf96061](https://github.com/Redocly/redoc/commit/bf960612a47bfe10ff205b9d78f3040515a5467d))
-* more cases for react18 and cli integration ([#2416](https://github.com/Redocly/redoc/issues/2416)) ([26674e7](https://github.com/Redocly/redoc/commit/26674e70c66b686d0f0baa569b186292c41e5726))
-
-
-
-## [2.1.2](https://github.com/Redocly/redoc/compare/v2.1.1...v2.1.2) (2023-09-11)
-
-
-### Bug Fixes
-
-* react18 cli integration ([#2404](https://github.com/Redocly/redoc/issues/2404)) ([76edc15](https://github.com/Redocly/redoc/commit/76edc159399150778b384be87ee958a93e5c491c))
-* style RefreshToken URL as <code> in the authorization section ([1d61001](https://github.com/Redocly/redoc/commit/1d6100111a0f3b609dadbd706354ce6125947df2))
-
-
-
-## [2.1.1](https://github.com/Redocly/redoc/compare/v2.1.0...v2.1.1) (2023-08-17)
-
-
-### Bug Fixes
-
-* hotfix, crash after 2.1 release ([0ab3428](https://github.com/Redocly/redoc/commit/0ab3428664f857ea07381686a2b4beb4c22b17c3))
-
-
-
-# [2.1.0](https://github.com/Redocly/redoc/compare/v2.0.0...v2.1.0) (2023-08-10)
-
-
-### Bug Fixes
-
-* call onLoaded if specs are not found ([#2182](https://github.com/Redocly/redoc/issues/2182)) ([0753bbe](https://github.com/Redocly/redoc/commit/0753bbea4b1425bdb09225fca45effae8003dce8))
-* default value for array query parameter ([#2186](https://github.com/Redocly/redoc/issues/2186)) ([3d410b6](https://github.com/Redocly/redoc/commit/3d410b6002c656efa780254c9c45c6249f90bce1))
-* **demo:** Get CORS proxy to work in Chrome on Windows ([#2220](https://github.com/Redocly/redoc/issues/2220)) ([1597bae](https://github.com/Redocly/redoc/commit/1597bae4032b65a94211e80aad51867e5af1ceb3))
-* error with immutable object spec ([#2179](https://github.com/Redocly/redoc/issues/2179)) ([53c4f36](https://github.com/Redocly/redoc/commit/53c4f36fad3e4453a72c1d136e37929de47cd35e))
-* improve accessible label by using the property name ([#2224](https://github.com/Redocly/redoc/issues/2224)) ([12be1bc](https://github.com/Redocly/redoc/commit/12be1bc5ffa11f9092c2faacd69d787f4e899960))
-* move role to list item to meet ARIA spec ([#2228](https://github.com/Redocly/redoc/issues/2228)) ([b8f7da6](https://github.com/Redocly/redoc/commit/b8f7da6b003ca12c1e2f0f4d42f3dd6d6f86ccac))
-* remove GenericObject shim ([#2177](https://github.com/Redocly/redoc/issues/2177)) ([127ef26](https://github.com/Redocly/redoc/commit/127ef260b961e07c5f82a7494b51dd3f04294e87))
-* renames 'FieldContstraints' to 'FieldConstraints' ([#2352](https://github.com/Redocly/redoc/issues/2352)) ([7e05202](https://github.com/Redocly/redoc/commit/7e052028d965624feb72d5f4b74fdb3c2d5df21f))
-* schema oneOf title with const ([#2350](https://github.com/Redocly/redoc/issues/2350)) ([4386867](https://github.com/Redocly/redoc/commit/4386867d908eae2aed2b9fd86e9f5476aadce52b))
-* **types/open-api:** import type ([#2213](https://github.com/Redocly/redoc/issues/2213)) ([33be51a](https://github.com/Redocly/redoc/commit/33be51a7a4068f44fd914314002c058a204ba0c2))
-
-
-### Features
-
-* add deprecation label to redoc-cli ([#2172](https://github.com/Redocly/redoc/issues/2172)) ([2ae7e08](https://github.com/Redocly/redoc/commit/2ae7e08af49321cea9bf2078f309b48bacf76ad6))
-* add option to hide the example code when using the `SchemaDefinition` component ([#2157](https://github.com/Redocly/redoc/issues/2157)) ([168189b](https://github.com/Redocly/redoc/commit/168189b2fdcf3667422ce3940ace3eedd0bdf284))
-* add support of react 18 ([#2369](https://github.com/Redocly/redoc/issues/2369)) ([054f604](https://github.com/Redocly/redoc/commit/054f604195629197aa8bd0fc46e91383ca5a05af))
-* add x-tags ([#2355](https://github.com/Redocly/redoc/issues/2355)) ([0bb21c8](https://github.com/Redocly/redoc/commit/0bb21c812840999d2dd2d96da42124746440b035))
-* enable keyboard navigation ([#2361](https://github.com/Redocly/redoc/issues/2361)) ([d21af58](https://github.com/Redocly/redoc/commit/d21af5841455901f0572ab475b7dc661acb86a71))
-* indicate whether request body is required or optional ([#2175](https://github.com/Redocly/redoc/issues/2175)) ([d3ad792](https://github.com/Redocly/redoc/commit/d3ad7925cfbd90b59b502b5ef53228fcd34b8a1e))
-
-
-
-# [2.0.0](https://github.com/Redocly/redoc/compare/v2.0.0-rc.77...v2.0.0) (2022-09-12)
-
-
-
-# [2.0.0-rc.77](https://github.com/Redocly/redoc/compare/v2.0.0-rc.76...v2.0.0-rc.77) (2022-09-06)
-
-
-### Bug Fixes
-
-* add hard limit on deref depth to prevent crashes ([ddde105](https://github.com/Redocly/redoc/commit/ddde105acaf0a77b0bb5d13df5fd6180bc8169e9))
-* do not use discriminator when specific schema was referenced in oneOf or anyOf ([#2153](https://github.com/Redocly/redoc/issues/2153)) ([6ac1e1e](https://github.com/Redocly/redoc/commit/6ac1e1eb183e97e2cd67ad14d8a39fac8289ebcc))
-* hoistOneOf missing refs stack and improve allOf for same $ref ([bb325d0](https://github.com/Redocly/redoc/commit/bb325d0d285c4cf4ee7c6d70878d2dd0dc9c6ed7))
-* latest docker cli tag ([#2140](https://github.com/Redocly/redoc/issues/2140)) ([8dc03eb](https://github.com/Redocly/redoc/commit/8dc03eb7ed262d6b1d460425ce43990710470845))
-* markdown parent name ([#2062](https://github.com/Redocly/redoc/issues/2062)) ([da9ed0b](https://github.com/Redocly/redoc/commit/da9ed0b4d1a4070d326ecb472459f0ff916c6036))
-
-### Features
-
-* feet: search feature to support path ([#2145](https://github.com/Redocly/redoc/issues/2145)) ([c52ee83f](https://github.com/Redocly/redoc/commit/c52ee83f77ccfc79137c85deafe8d93e68465d45))
-
-
-# [2.0.0-rc.76](https://github.com/Redocly/redoc/compare/v2.0.0-rc.75...v2.0.0-rc.76) (2022-08-18)
-
-
-### Bug Fixes
-
-* "API Docs By Redocly" overlapping last element in sidebar ([#2132](https://github.com/Redocly/redoc/issues/2132)) ([c60c6f5](https://github.com/Redocly/redoc/commit/c60c6f58917563d57c0eef650b9dfcece2e15049))
-* encoding issue in CDN responses ([#2130](https://github.com/Redocly/redoc/issues/2130)) ([7816902](https://github.com/Redocly/redoc/commit/781690284a45b2b8af9eb525757632d0d19ef453))
-* Optional authentication not rendered properly ([#2117](https://github.com/Redocly/redoc/issues/2117)) ([#2134](https://github.com/Redocly/redoc/issues/2134)) ([efd5e09](https://github.com/Redocly/redoc/commit/efd5e09c907b36a3999f4c9c3165b6b2bdc1d536))
-
-
-### Features
-
-* add clear cache for publish action ([#2129](https://github.com/Redocly/redoc/issues/2129)) ([d8093e3](https://github.com/Redocly/redoc/commit/d8093e3e2086874242eac82ddd202f35d5b8d558))
-
-
-
-# [2.0.0-rc.75](https://github.com/Redocly/redoc/compare/v2.0.0-rc.74...v2.0.0-rc.75) (2022-08-10)
-
-
-### Bug Fixes
-
-* duplication of title ([#2119](https://github.com/Redocly/redoc/issues/2119)) ([40ebfd2](https://github.com/Redocly/redoc/commit/40ebfd2d63758b37665e2e4447732f671811e2a5))
-* handle error if security scopes is invalid ([#2113](https://github.com/Redocly/redoc/issues/2113)) ([428fd69](https://github.com/Redocly/redoc/commit/428fd6983dc257f524121d98aeb1c58b39cf81f7))
-* publishing docker image to github packages ([#2115](https://github.com/Redocly/redoc/issues/2115)) ([250f6d1](https://github.com/Redocly/redoc/commit/250f6d12b2d31d2166990bd9cb83ca1c63509686))
-* Redocly logo ([#2109](https://github.com/Redocly/redoc/issues/2109)) ([a35bb3f](https://github.com/Redocly/redoc/commit/a35bb3ff26bf10b0e54383222df283800d6ee2c8))
-* search and navigate error ([cfd810f](https://github.com/Redocly/redoc/commit/cfd810fdf9d37862e07458fa1c3c04046e22f315))
-* sibling for openapi 3.1 ([#2112](https://github.com/Redocly/redoc/issues/2112)) ([0b1a790](https://github.com/Redocly/redoc/commit/0b1a79009010f0640a3030093b7c0dcf8caa49e4))
-
-
-### Features
-
-* add notification about new version available ([#2100](https://github.com/Redocly/redoc/issues/2100)) ([d6ca8cc](https://github.com/Redocly/redoc/commit/d6ca8cc53b9667f09ce8fef88dfac1039c562b78))
-
-
-
-# [2.0.0-rc.74](https://github.com/Redocly/redoc/compare/v2.0.0-rc.73...v2.0.0-rc.74) (2022-07-28)
-
-
-### Bug Fixes
-
-* invalid url when href is empty ([#2105](https://github.com/Redocly/redoc/issues/2105)) ([e5f0235](https://github.com/Redocly/redoc/commit/e5f02359851a3797283ee513d734ab8e27266b92))
-
-
-
-# [2.0.0-rc.73](https://github.com/Redocly/redoc/compare/v2.0.0-rc.72...v2.0.0-rc.73) (2022-07-28)
-
-
-### Bug Fixes
-
-* add label API docs by Redocly ([#2099](https://github.com/Redocly/redoc/issues/2099)) ([dcdab83](https://github.com/Redocly/redoc/commit/dcdab838903a5d923c5e327d07d7743214769a61))
-* add the latest tag for the CLI docker image ([#2087](https://github.com/Redocly/redoc/issues/2087)) ([80ecd0f](https://github.com/Redocly/redoc/commit/80ecd0f19746379b056bfb1b11950693f3dc3724))
-* correct URLs of OperationModel servers for static site generation ([#2081](https://github.com/Redocly/redoc/issues/2081)) ([b1afd08](https://github.com/Redocly/redoc/commit/b1afd08bcf83770b537ed1eb9c90341de0162a1c))
-* enum duplication values when schema uses a specific combination of oneOf and allOf([#2088](https://github.com/Redocly/redoc/issues/2088)) ([e411847](https://github.com/Redocly/redoc/commit/e4118479f69209c5dd09a2be0e978834dcd9eb8f))
-* highlight text syntax ([#2069](https://github.com/Redocly/redoc/issues/2069)) ([4fc6aa0](https://github.com/Redocly/redoc/commit/4fc6aa0859c94e25fd30c4a4250455e44cc76488))
-* merge reference for openapi 3.1 ([#2063](https://github.com/Redocly/redoc/issues/2063)) ([87541e4](https://github.com/Redocly/redoc/commit/87541e45dc2526696deb32a6350a14a44a709b54))
-* nested patternProperties ([#2073](https://github.com/Redocly/redoc/issues/2073)) ([9920991](https://github.com/Redocly/redoc/commit/99209910806b85289a89fb3131049ed79118bc72))
-* operation url in static page ([#2093](https://github.com/Redocly/redoc/issues/2093)) ([98eec19](https://github.com/Redocly/redoc/commit/98eec19647b63f3598ec30fdeb428f614cf93ad4))
-* property with nested allOf ([#2083](https://github.com/Redocly/redoc/issues/2083)) ([7cc0500](https://github.com/Redocly/redoc/commit/7cc0500f3c1ddd1da17ee31278468207093f9281))
-* recursion for boolean items ([#2097](https://github.com/Redocly/redoc/issues/2097)) ([a5804db](https://github.com/Redocly/redoc/commit/a5804db1ce60ee6d90db8a3b54138eb1ca420c6f))
-* resolve dependency conflict in installing ([#2060](https://github.com/Redocly/redoc/issues/2060)) ([e26c8b2](https://github.com/Redocly/redoc/commit/e26c8b23d9b36abd5572bd0fe350d74a5cf65afb))
-* restore old variant security injections ([#2075](https://github.com/Redocly/redoc/issues/2075)) ([1a1bc26](https://github.com/Redocly/redoc/commit/1a1bc26503c06b6a7022289e5b9353bd59e48a9a))
-* rewrite recursive checks ([#2072](https://github.com/Redocly/redoc/issues/2072)) ([2970f95](https://github.com/Redocly/redoc/commit/2970f959cfa31cb4d5288ca23ca05cd34357dcec))
-* Scrolling keeps rewriting url after a Redoc element was removed [#2051](https://github.com/Redocly/redoc/issues/2051) ([#2085](https://github.com/Redocly/redoc/issues/2085)) ([0045be0](https://github.com/Redocly/redoc/commit/0045be0b753b8fb7d8d58a4e511783a6ba858444))
-* mis-nesting of aria roles on sidebar navigation ([#2050](https://github.com/Redocly/redoc/issues/2050)) ([7ca10da](https://github.com/Redocly/redoc/commit/7ca10daf12f2cac9fecf559b11f0f0c8bd21ae43))
-* 404 on the documentation page ([#2092](https://github.com/Redocly/redoc/issues/2050)) ([17bb08](https://github.com/Redocly/redoc/commit/17bb08909a1734e6e59c83ce29f31ae7cf6fc784))
-
-
-
-
-# [2.0.0-rc.72](https://github.com/Redocly/redoc/compare/v2.0.0-rc.71...v2.0.0-rc.72) (2022-06-02)
-
-
-### Bug Fixes
-
-* handled style change in ServerUrl and ServersOverlay dynamically ([#1989](https://github.com/Redocly/redoc/issues/1989)) ([a366de4](https://github.com/Redocly/redoc/commit/a366de4cf67fb94baa33b7b5c311cc1f54a63e53))
-* nested items with refs ([#2035](https://github.com/Redocly/redoc/issues/2035)) ([51127aa](https://github.com/Redocly/redoc/commit/51127aadc3e6b0f8e4066afb1c3b2ea6db453da2))
-
-
-
-# [2.0.0-rc.71](https://github.com/Redocly/redoc/compare/v2.0.0-rc.70...v2.0.0-rc.71) (2022-05-31)
-
-
-### Bug Fixes
-
-* constraints label details ([eb0917d](https://github.com/Redocly/redoc/commit/eb0917d002e57353027fee9c8f07605de8f1ff6f))
-* merge allOf in correct order ([#2020](https://github.com/Redocly/redoc/issues/2020)) ([1e4ea03](https://github.com/Redocly/redoc/commit/1e4ea03d4a9b7eddf3e4cc7cbdbd4d913583e837))
-
-
-### Features
-
-* add hideSecuritySection option allowing to disable the Security panel ([#2027](https://github.com/Redocly/redoc/issues/2027)) ([49cc11d](https://github.com/Redocly/redoc/commit/49cc11d91795653ca870e9276a1e0cd617964e25))
-* add Redoc to Redocly CDN ([#2026](https://github.com/Redocly/redoc/issues/2026)) ([77104d6](https://github.com/Redocly/redoc/commit/77104d6c0d6f457aa08a158e93b52a45877be84e))
-* add support prefix items ([27a9dba](https://github.com/Redocly/redoc/commit/27a9dbaf46aded01a6512645dab27870a85cc73b))
-* remove auth section ([#2022](https://github.com/Redocly/redoc/issues/2022)) ([a863302](https://github.com/Redocly/redoc/commit/a863302cc803bdf27187c613157ba90af1040fc4))
-* show minProperties maxProperties ([#2015](https://github.com/Redocly/redoc/issues/2015)) ([82712c5](https://github.com/Redocly/redoc/commit/82712c5b408dc6bc142307d45fb962de2a43ffba))
-
-
-
-# [2.0.0-rc.70](https://github.com/Redocly/redoc/compare/2.0.0-rc.69...2.0.0-rc.70) (2022-05-17)
-
-
-### Features
-
-* display patternProperties ([#2008](https://github.com/Redocly/redoc/issues/2008)) ([660cc85](https://github.com/Redocly/redoc/commit/660cc857bc86787e16237b407fe5f5d7a493bb48))
-* support conditional operators ([#1939](https://github.com/Redocly/redoc/issues/1939)) ([291b62a](https://github.com/Redocly/redoc/commit/291b62a206b68f8b4d98e4b74b71c0cad20a8b9b))
-* theme add links textDecoration options ([#1599](https://github.com/Redocly/redoc/issues/1599)) ([ba06485](https://github.com/Redocly/redoc/commit/ba06485ece27acbb6b846500817f4bff3e4997ba))
-
-
-
-# [2.0.0-rc.69](https://github.com/Redocly/redoc/compare/v2.0.0-rc.68.1...v2.0.0-rc.69) (2022-05-12)
-
-
-### Bug Fixes
-
-* wrong base url format causing error when constructing new URL ([#1996](https://github.com/Redocly/redoc/issues/1996)) ([d2cdaa1](https://github.com/Redocly/redoc/commit/d2cdaa1221b6a5e7b5da2418414bce1586069deb))
-
-
-### Features
-
-* add download file option ([#1699](https://github.com/Redocly/redoc/issues/1699)) ([b601c9a](https://github.com/Redocly/redoc/commit/b601c9ae9e3288286f28e06854bd93cb3507706e))
-* add option to display verb in webhooks ([#1994](https://github.com/Redocly/redoc/issues/1994)) ([311d2ce](https://github.com/Redocly/redoc/commit/311d2ce64dcf1e68c2563a276b34dda0e08b709c))
-* support .redocly.yaml for options for redoc-cli ([#1981](https://github.com/Redocly/redoc/issues/1981)) ([1f417d6](https://github.com/Redocly/redoc/commit/1f417d67c6b2e0b49e41c713958c100d8e1ad19d))
-
-
-
-# [2.0.0-rc.68](https://github.com/Redocly/redoc/compare/v2.0.0-rc.67...v2.0.0-rc.68) (2022-05-10)
-
-
-### Bug Fixes
-
-* examples in json schema object([5b9aa27](https://github.com/Redocly/redoc/commit/5b9aa27af03a1c4616f7e0195afeba47d1deeaa0))
-* handle error when definition load fails ([#1979](https://github.com/Redocly/redoc/issues/1979)) ([508ebd5](https://github.com/Redocly/redoc/commit/508ebd58a3d66f2337e9641852322458a1bd9e6b))
-* large text in examples value ([#1974](https://github.com/Redocly/redoc/issues/1974)) ([60bc603](https://github.com/Redocly/redoc/commit/60bc603e9bb85a0c9c7ac38f7014876d397f0191))
-* not show scopes if keys empty or not exist ([#1975](https://github.com/Redocly/redoc/issues/1975)) ([4e793f0](https://github.com/Redocly/redoc/commit/4e793f07a81fa8bcd4ad384d1f87b3e6c290edb7))
-* remove dropdown-aria and use native select ([#1954](https://github.com/Redocly/redoc/issues/1954)) ([186f5a9](https://github.com/Redocly/redoc/commit/186f5a98bd466b1820121aadb865291bef8c6755))
-* make Redoc lib compatible with Webpack 5 ([#1982](https://github.com/Redocly/redoc/issues/1982)) ([867861](https://github.com/Redocly/redoc/commit/8678615a0e19c9484b4cd495d70293b542d196a5))
-
-### Features
-
-* implement configurable minimum characer length to init search ([#1402](https://github.com/Redocly/redoc/issues/1402)) ([0fa08fa](https://github.com/Redocly/redoc/commit/0fa08faab1c176a4bfc5a553e8e8f8b07aca659f))
-* support OAS 3.1 unevaluatedProperties ([#1978](https://github.com/Redocly/redoc/issues/1978)) ([0755ac6](https://github.com/Redocly/redoc/commit/0755ac6f04514eb0c08f90afceeda7858206b435))
-* publish dockerhub ([#1971](https://github.com/Redocly/redoc/issues/1971)) ([7e01a0](https://github.com/Redocly/redoc/commit/7e01a0cfe2ad8d06075bfc66ef3860edbef033f8))
-
-
-# [2.0.0-rc.67](https://github.com/Redocly/redoc/compare/v2.0.0-rc.66...v2.0.0-rc.67) (2022-04-28)
-
-
-### Bug Fixes
-
-* Expand/Collapse all buttons disappears for flat structures ([#1424](https://github.com/Redocly/redoc/issues/1424)) ([2ca8e08](https://github.com/Redocly/redoc/commit/2ca8e081baea6996eb01b5df27b8cd88331d5c96))
-* improve markdown render with CRLF ([#1953](https://github.com/Redocly/redoc/issues/1953)) ([aba2d1a](https://github.com/Redocly/redoc/commit/aba2d1ad2d8dda9f52055c36ebde1323457dfd3e))
-* issue with navigation when operationId contains backslash or quotes ([#1513](https://github.com/Redocly/redoc/issues/1513)) ([8f7e56c](https://github.com/Redocly/redoc/commit/8f7e56c747d88be5c5eb5c4bbaee0ff69e9cb2ec))
-* prefix operation ids with parent id ([#1245](https://github.com/Redocly/redoc/issues/1245)) ([fd8917e](https://github.com/Redocly/redoc/commit/fd8917e5c109840c1bfa4c2c0902b6dcec200286))
-
-
-### Features
-
-* add optional BASE_PATH to Docker config ([#1378](https://github.com/Redocly/redoc/issues/1378)) ([90f71c0](https://github.com/Redocly/redoc/commit/90f71c0d77719871910cfba883a32ad131bef059))
-* theme add sidebar activeBackgroundColor and activeTextColor ([#1600](https://github.com/Redocly/redoc/issues/1600)) ([6716b08](https://github.com/Redocly/redoc/commit/6716b08e8871d95880e9f5a6c5491038002754e8))
-
-
-
-# [2.0.0-rc.66](https://github.com/Redocly/redoc/compare/v2.0.0-rc.65...v2.0.0-rc.66) (2022-03-30)
-
-
-### Bug Fixes
-
-* add handle local files for serve command ([#1810](https://github.com/Redocly/redoc/issues/1810)) ([117071e](https://github.com/Redocly/redoc/commit/117071ee83a32d9b3350d8afe2bdb6365a44e2ec))
-* move comma out of code block in SecurityRequirement.tsx ([#1924](https://github.com/Redocly/redoc/issues/1924)) ([ab3e8a8](https://github.com/Redocly/redoc/commit/ab3e8a8f80f453066c5495e73ac932a8fef0830a))
-* rename bandle command and add deprecate notice ([#1935](https://github.com/Redocly/redoc/issues/1935)) ([eb096b6](https://github.com/Redocly/redoc/commit/eb096b69be52568fc581027161c7d0c4b26c56c1))
-
-
-### Features
-
-* add support for displaying operationId in the sidebar ([#1927](https://github.com/Redocly/redoc/issues/1927)) ([09786f2](https://github.com/Redocly/redoc/commit/09786f2a5ade6303ea00512483b172347721ca70))
-* add nonce support ([#1566](https://github.com/Redocly/redoc/issues/1566)) ([c75ac9c](https://github.com/Redocly/redoc/commit/c75ac9cf70012e2d539b379aab2f0974d088db07))
-* h2 set color form theme.colors.text.primary ([#1491](https://github.com/Redocly/redoc/pull/1491)) ([25be93](https://github.com/Redocly/redoc/commit/25be934bb184d7b2b6b47d004b3c83ce4d16a2c6))
-
-
-
-# [2.0.0-rc.65](https://github.com/Redocly/redoc/compare/v2.0.0-rc.64...v2.0.0-rc.65) (2022-03-15)
-
-
-### Bug Fixes
-
-* auth link scroll for Firerox ([#1922](https://github.com/Redocly/redoc/issues/1922)) ([fe67e9c](https://github.com/Redocly/redoc/commit/fe67e9c332fee716582a00d60fdf34767bff22d4))
-* improve customization fab ([#1891](https://github.com/Redocly/redoc/issues/1891)) ([635f379](https://github.com/Redocly/redoc/commit/635f379eb086268c91eef715148eca8f080cfb86))
-* sanitize array of items ([#1920](https://github.com/Redocly/redoc/issues/1920)) ([059bd80](https://github.com/Redocly/redoc/commit/059bd8000e5fd65753d5ca9e0c47940394e0c79b))
-* use x-displayName in securityDefinitions ([#1444](https://github.com/Redocly/redoc/pull/1444)) ([ac6fb4](https://github.com/Redocly/redoc/commit/ac6fb458a4eee8d0da4b63f9bafc7669adc8af03))
-* deprecated badge on one of any of buttons ([#1930](https://github.com/Redocly/redoc/pull/1930)) ([f60b47](https://github.com/Redocly/redoc/commit/f60b4758330dd756d670309827da60d3465b672a))
-
-
-
-# [2.0.0-rc.64](https://github.com/Redocly/redoc/compare/v2.0.0-rc.63...v2.0.0-rc.64) (2022-02-24)
-
-
-### Bug Fixes
-
-* bump json-pointer version to avoid CVE-2021-23820 ([#1910](https://github.com/Redocly/redoc/issues/1910)) ([777efdd](https://github.com/Redocly/redoc/commit/777efdde35c1c8dc79dd714e1666279e9192dddb))
-* external ref in schema definition ([#1894](https://github.com/Redocly/redoc/issues/1894)) ([57cdd9f](https://github.com/Redocly/redoc/commit/57cdd9f6da38418d6214ac3c6480c5847ecd0228))
-
-
-
-# [2.0.0-rc.63](https://github.com/Redocly/redoc/compare/v2.0.0-rc.61...v2.0.0-rc.63) (2022-01-27)
-
-
-### Bug Fixes
-
-* scroll in sidebar ([b5b0d61](https://github.com/Redocly/redoc/commit/b5b0d61b3568ac2a8aaceafa96ffa6d2f86ed323))
-
-
-# [2.0.0-rc.62](https://github.com/Redocly/redoc/compare/v2.0.0-rc.61...v2.0.0-rc.62) (2022-01-26)
-
-
-### Bug Fixes
-
-* fix field expand does not work ([#1875](https://github.com/Redocly/redoc/issues/1875))
-
-
-# [2.0.0-rc.61](https://github.com/Redocly/redoc/compare/v2.0.0-rc.60...v2.0.0-rc.61) (2022-01-26)
-
-
-### Bug Fixes
-
-* fix crash in redoc-cli after migrating to esbuild ([#1872](https://github.com/Redocly/redoc/issues/1872))
-
-# [2.0.0-rc.60](https://github.com/Redocly/redoc/compare/v2.0.0-rc.59...v2.0.0-rc.60) (2022-01-25)
-
-
-### Bug Fixes
-
-* add schema expansion level ([#1868](https://github.com/Redocly/redoc/issues/1868)) ([250d53a](https://github.com/Redocly/redoc/commit/250d53a59fb4bf881875ba466c5a7f3b55d80007))
-* attachHeadingsDescriptions match headings incorrectly ([#1845](https://github.com/Redocly/redoc/issues/1845)) ([ea8573d](https://github.com/Redocly/redoc/commit/ea8573dbd78439be50aa2b38f1c83658c16783e3))
-* definition name util ([#1865](https://github.com/Redocly/redoc/issues/1865)) ([95a7347](https://github.com/Redocly/redoc/commit/95a734793158d4749e98ee4a7e90e70713a04ced))
-* No maxLength label is displayed for arrays of items [#1701](https://github.com/Redocly/redoc/issues/1701) ([#1765](https://github.com/Redocly/redoc/issues/1765)) ([6c7685e](https://github.com/Redocly/redoc/commit/6c7685e5fa04314328a445d7077600692c49489c))
-* Response objects couldn't open ([#1867](https://github.com/Redocly/redoc/issues/1867)) ([18f943d](https://github.com/Redocly/redoc/commit/18f943d2b5668f1552d212dee1c3a2ed59054095))
-* writeOnly params displaying in webhook ([#1866](https://github.com/Redocly/redoc/issues/1866)) ([5694913](https://github.com/Redocly/redoc/commit/5694913e71f0e8c3a5d9393f1b4ae92534127841))
-
-
-### Features
-
-* **#1251:** Add file selector to demo application ([#1859](https://github.com/Redocly/redoc/issues/1859)) ([b74dcde](https://github.com/Redocly/redoc/commit/b74dcde42b45ebe5ae617f1ec3cfea2ea1aff922)), closes [#1251](https://github.com/Redocly/redoc/issues/1251) [#1251](https://github.com/Redocly/redoc/issues/1251) [#1251](https://github.com/Redocly/redoc/issues/1251)
-* redoc-cli add host option ([#1598](https://github.com/Redocly/redoc/issues/1598)) ([fb104e6](https://github.com/Redocly/redoc/commit/fb104e696618b0b81439da134887830a0f2439ea))
-* support examples in object schema ([#1832](https://github.com/Redocly/redoc/issues/1832)) ([c986f0e](https://github.com/Redocly/redoc/commit/c986f0ef1a38bc1e61cae70830d84de03b684b89))
-
-
-
-# [2.0.0-rc.59](https://github.com/Redocly/redoc/compare/v2.0.0-rc.58...v2.0.0-rc.59) (2021-12-09)
-
-
-### Bug Fixes
-
-* fix scroll in example dropdown ([#1803](https://github.com/Redocly/redoc/issues/1803)) ([bc2d9a7](https://github.com/Redocly/redoc/commit/bc2d9a7d9cd530274483fecd136db290a5b46ff7))
-* x-examples for request body param does not display [#1743](https://github.com/Redocly/redoc/issues/1743) ([#1826](https://github.com/Redocly/redoc/issues/1826)) ([aaa3b32](https://github.com/Redocly/redoc/commit/aaa3b3280c8422d450e8849ae02135dde199d6d5))
-
-### Features
-
-* add option sideNavStyle ([#1805](https://github.com/Redocly/redoc/pull/1805)) ([2e4663b](https://github.com/Redocly/redoc/commit/2e4663b3b7022f25d3dc808afbcb3b3ad9483c41))
-
-
 # [2.0.0-rc.58](https://github.com/Redocly/redoc/compare/v2.0.0-rc.57...v2.0.0-rc.58) (2021-11-29)
 
 
@@ -461,7 +43,7 @@
 * improve openapi 3.1 ([#1700](https://github.com/Redocly/redoc/issues/1700)) ([cd2d6f7](https://github.com/Redocly/redoc/commit/cd2d6f76e87c8385786a9c8e51c0d11c79d9707c))
   - show contentEncoding on fields
   - crash with OpenAPI 3.1 type as array of strings in requestBody
-  - nullable label not shown
+  - nullable label not shown 
 * nullable object's fields were missing ([#1721](https://github.com/Redocly/redoc/issues/1721)) ([ddf297b](https://github.com/Redocly/redoc/commit/ddf297b11269ef515bd62771912a5609721d5e39))
 
 
@@ -636,7 +218,7 @@ closes: [#1506](https://github.com/Redocly/redoc/issues/1506), [#1478](https://g
 
 ### Bug Fixes
 
-* invalid discriminator dropdown behavior with enum ([be07197](https://github.com/Redocly/redoc/commit/be07197e6d1e85a3fd3e61189a36b288751c077d))
+* invalid discriminator dropdown behaviour with enum ([be07197](https://github.com/Redocly/redoc/commit/be07197e6d1e85a3fd3e61189a36b288751c077d))
 
 
 
@@ -854,7 +436,7 @@ Same as rc.31 by mistake
 
 ### Bug Fixes
 
-* empty servers behavior per OAS spec ([ed1db0c](https://github.com/Redocly/redoc/commit/ed1db0c9027087ae0ae923e390e3e1d638a647ae)), closes [#1151](https://github.com/Redocly/redoc/issues/1151)
+* empty servers behaviour per OAS spec ([ed1db0c](https://github.com/Redocly/redoc/commit/ed1db0c9027087ae0ae923e390e3e1d638a647ae)), closes [#1151](https://github.com/Redocly/redoc/issues/1151)
 * fix duplicated content in tags when using md headings ([a260c84](https://github.com/Redocly/redoc/commit/a260c8414c34a259a70a20ebcd20ecbb06c3d250)), closes [#1150](https://github.com/Redocly/redoc/issues/1150) [#1152](https://github.com/Redocly/redoc/issues/1152)
 * use mobile menu background color value from theme ([#1144](https://github.com/Redocly/redoc/issues/1144)) ([41a9b3c](https://github.com/Redocly/redoc/commit/41a9b3c18228d236d182d3c15c9abc35ae72a0d5))
 
@@ -1832,7 +1414,7 @@ Complete rewrite also means that this rewrite may introduce issues, but they sho
 - no more GitHub pages-based CDN. Use [unpkg.com](https://unpkg.com/) to access ReDoc releases
 
 
-### Known Regression (resolved before leaving alpha stage)
+### Known Regression (will be resolved before leaving alpha stage)
 - `lazyLoading` option not implemented yet
 - Copying to clipboard of samples not implemented yet
 - Search not implemented yet

README.md

@@ -1,100 +1,126 @@
 <div align="center">
-  <img alt="Redoc logo" src="https://raw.githubusercontent.com/Redocly/redoc/main//docs/images/redoc.png" width="400px" />
+  <img alt="Redoc logo" src="https://raw.githubusercontent.com/Redocly/redoc/master//docs/images/redoc.png" width="400px" />
 
-# Generate beautiful API documentation from OpenAPI
+  # Generate interactive API documentation from OpenAPI definitions
 
-  [![npm](http://img.shields.io/npm/v/redoc.svg)](https://www.npmjs.com/package/redoc) [![License](https://img.shields.io/npm/l/redoc.svg)](https://github.com/Redocly/redoc/blob/main/LICENSE)
+  [![Build Status](https://travis-ci.com/Redocly/redoc.svg?branch=master)](https://travis-ci.com/Redocly/redoc) [![Coverage Status](https://coveralls.io/repos/Redocly/redoc/badge.svg?branch=master&service=github)](https://coveralls.io/github/Redocly/redoc?branch=master) [![npm](http://img.shields.io/npm/v/redoc.svg)](https://www.npmjs.com/package/redoc) [![License](https://img.shields.io/npm/l/redoc.svg)](https://github.com/Redocly/redoc/blob/master/LICENSE)
 
-  [![bundle size](http://img.badgesize.io/https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js?compression=gzip&max=300000)](https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js) [![npm](https://img.shields.io/npm/dm/redoc.svg)](https://www.npmjs.com/package/redoc) [![jsDelivr status](https://data.jsdelivr.com/v1/package/npm/redoc/badge)](https://www.jsdelivr.com/package/npm/redoc)
+  [![bundle size](http://img.badgesize.io/https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js?compression=gzip&max=300000)](https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js) [![npm](https://img.shields.io/npm/dm/redoc.svg)](https://www.npmjs.com/package/redoc) [![](https://data.jsdelivr.com/v1/package/npm/redoc/badge)](https://www.jsdelivr.com/package/npm/redoc) [![Docker Build Status](https://img.shields.io/docker/build/redocly/redoc.svg)](https://hub.docker.com/r/redocly/redoc/)
 </div>
 
+**This is the README for the `2.x` version of Redoc (React-based).** 
+**The README for the `1.x` version is on the [v1.x](https://github.com/Redocly/redoc/tree/v1.x) branch**
 
 ## About Redoc
 
-Redoc is an open source tool for generating documentation from OpenAPI (formerly Swagger) definitions.
+Redoc is an open-source tool for generating documentation from OpenAPI (fka Swagger) definitions. 
 
-By default Redoc offers a three-panel, responsive layout:
+By default Redoc offers a three-panel, responsive layout: 
 
 - The left panel contains a search bar and navigation menu.
 - The central panel contains the documentation.
 - The right panel contains request and response examples.
 
-![Redoc demo](https://raw.githubusercontent.com/Redocly/redoc/main/demo/redoc-demo.png)
+![Redoc demo](https://raw.githubusercontent.com/Redocly/redoc/master/demo/redoc-demo.png)
 
 ## Live demo
 
-If you want to see how Redoc renders your OpenAPI definition,
+If you want to see how Redoc will render your OpenAPI definition,
 you can try it out online at https://redocly.github.io/redoc/.
 
 A version of the Swagger Petstore API is displayed by default.
 To test it with your own OpenAPI definition,
 enter the URL for your definition and select **TRY IT**.
 
-## Redoc features
-
-- Responsive three-panel design with menu/scrolling synchronization
-- Support for OpenAPI 3.1, OpenAPI 3.0, and Swagger 2.0
-- Ability to integrate your API introduction into the side menu
-- High-level grouping in side menu with the [`x-tagGroups`](https://redocly.com/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
-- [Simple integration with `create-react-app`](https://redocly.com/docs/redoc/quickstart/react/)
-- Code samples support (with vendor extension) <br>
-  ![code samples in action](docs/images/code-samples-demo.gif)
-
-## Usage
-
-Redoc is provided as a CLI tool (also distributed as a Docker image), HTML tag, and React component.
-
-### Generate documentation from the CLI
-
-If you have Node installed, quickly generate documentation using `npx`:
-
-```bash
-npx @redocly/cli build-docs openapi.yaml
-```
-
-The tool outputs by default to a file named `redoc-static.html` that you can open in your browser.
-
-> [Redocly CLI](https://github.com/Redocly/redocly-cli/) does more than docs; check it out and add linting, bundling, and more to your API workflow.
-
-### Add an HTML element to the page
-
-Create an HTML page, or edit an existing one, and add the following within the body tags:
-
-```html
-    <redoc spec-url="http://petstore.swagger.io/v2/swagger.json"></redoc>
-    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
-```
-
-Open the HTML file in your browser, and your API documentation is shown on the page.
-
-Add your own `spec-url` to the `<redoc>` tag; this attribute can also be a local file. The JavaScript library can also be installed locally using `npm` and served from your own server, see the [HTML deployment documentation](https://redocly.com/docs/redoc/deployment/html/) for more details.
-
-### More usage options
-
-Check out the [deployment documentation](./docs/deployment/intro.md) for more options, and detailed documentation for each.
-
-## Redoc vs. Redocly API Reference
+## Redoc vs. Reference vs. Portals
 
 Redoc is Redocly's community-edition product. Looking for something more?
-We also offer [hosted API reference documentation](https://redocly.com/docs/api-registry/guides/api-registry-quickstart/)
-with additional features including:
+Checkout the following feature comparison of Redocly's premium products versus Redoc:
 
-* Try-it console
-* Automated code samples
-* Pagination
-* Extra theme options
+| Features                     | Redoc     | Reference | Portals     |
+|------------------------------|:---------:|:---------:|:-----------:|
+| **Specs**                    |           |           |             |
+| Swagger 2.0                  | √         | √         | √           |
+| OpenAPI 3.0                  | √         | √         | √           |
+| OpenAPI 3.1                  | √ (basic) | √         | √           |
+|                              |           |           |             |
+| **Theming**                  |           |           |             |
+| Fonts/colors                 | √         | √         | √           |
+| Extra theme options          |           | √         | √           |
+|                              |           |           |             |
+| **Performance**              |           |           |             |
+| Pagination                   |           | √         | √           |
+| Search (enhanced)            |           | √         | √           |
+| Search (server-side)         |           |           | √           |
+|                              |           |           |             |
+| **Multiple APIs**            |           |           |             |
+| Multiple versions            |           | √         | √           |
+| Multiple APIs                |           |           | √           |
+| API catalog                  |           |           | √           |
+|                              |           |           |             |
+| **Additional features**      |           |           |             |
+| Try-it console               |           | √         | √           |
+| Automated code samples       |           | √         | √           |
+| Deep links                   |           | √         | √           |
+| More SEO control             |           |           | √           |
+| Contextual docs              |           |           | √           |
+| Landing pages                |           |           | √           |
+| React hooks for more control |           |           | √           |
+| Personalization              |           |           | √           |
+| Analytics integrations       |           |           | √           |
+| Feedback                     |           |           | Coming Soon |
 
-### Documentation and resources
+Refer to the Redocly's documentation for more information on these products:
 
-- [Reference docs](https://redocly.com/docs/api-reference-docs/getting-started/) - we take care of the hosting
-- [Redoc](https://redocly.com/docs/redoc/) - detailed documentation for this open source project (also in the `docs/` folder)
-- [Command-line interface to bundle your docs into a web-ready HTML file](https://redocly.com/docs/cli/commands/build-docs/)
-- API linting, bundling, and much more with open source [Redocly CLI](https://redocly.com/docs/cli)
+- [Portals](https://redoc.ly/docs/developer-portal/introduction/)
+- [Reference](https://redoc.ly/docs/api-reference-docs/getting-started/)
+- [Redoc](https://redoc.ly/docs/redoc/quickstart/intro/)
+
+## Features
+- Responsive three-panel design with menu/scrolling synchronization
+- [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
+- [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
+- Ability to integrate your API introduction into the side menu
+- [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
+
+  [Example repo](https://github.com/APIs-guru/create-react-app-redoc)
+- [Command-line interface to bundle your docs into a **zero-dependency** HTML file](https://redoc.ly/docs/redoc/quickstart/cli/)
+- Neat **interactive** documentation for nested objects <br>
+  ![](docs/images/nested-demo.gif)
+
+## Customization options
+[<img alt="Customization services" src="http://i.imgur.com/c4sUF7M.png" height="60px">](https://redoc.ly/#services)
+- High-level grouping in side-menu with the [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
+- Branding/customizations using the [`theme` option](https://redoc.ly/docs/api-reference-docs/configuration/theming/)
+
+## Support
+- OpenAPI v3.0 support
+- Basic OpenAPI v3.1 support
+- Broad OpenAPI v2.0 feature support (yes, it supports even `discriminator`) <br>
+  ![](docs/images/discriminator-demo.gif)
+- Code samples support (via vendor extension) <br>
+  ![](docs/images/code-samples-demo.gif)
+
+## Releases
+**Important:** all the 2.x releases are deployed to npm and can be used with jsdeliver:
+- particular release, for example, `v2.0.0-alpha.15`: https://cdn.jsdelivr.net/npm/redoc@2.0.0-alpha.17/bundles/redoc.standalone.js
+- `next` release: https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js
+
+Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(deprecated)**:
+- particular release, for example `v1.2.0`: https://rebilly.github.io/ReDoc/releases/v1.2.0/redoc.min.js
+- `v1.x.x` release: https://rebilly.github.io/ReDoc/releases/v1.x.x/redoc.min.js
+- `latest` release: https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js - it will point to latest 1.x.x release since 2.x releases are not hosted on this CDN but on unpkg.
+
+## Version Guidance
+| Redoc Release | OpenAPI Specification |
+|:--------------|:----------------------|
+| 2.0.0-alpha.54| 3.1, 3.0.x, 2.0       |
+| 2.0.0-alpha.x | 3.0, 2.0              |
+| 1.19.x        | 2.0                   |
+| 1.18.x        | 2.0                   |
+| 1.17.x        | 2.0                   |
 
 ## Showcase
-
-A sample of the organizations using Redocly tools in the wild:
-
 - [Rebilly](https://api-reference.rebilly.com/)
 - [Docker Engine](https://docs.docker.com/engine/api/v1.25/)
 - [Zuora](https://www.zuora.com/developer/api-reference/)
@@ -102,43 +128,176 @@ A sample of the organizations using Redocly tools in the wild:
 - [Commbox](https://www.commbox.io/api/)
 - [APIs.guru](https://apis.guru/api-doc/)
 - [BoxKnight](https://www.docs.boxknight.com/)
-- [Quaderno API](https://developers.quaderno.io/api)
 
-_Pull requests to add your own API page to the list are welcome_
+## Lint OpenAPI definitions
+
+Redocly's OpenAPI CLI is an open source command-line tool that you can use to lint
+your OpenAPI definition. Linting helps you to catch errors and inconsistencies in your
+OpenAPI definition before publishing. 
+
+Refer to [Lint configuration](https://redoc.ly/docs/cli/guides/lint/) in the OpenAPI documentation for more information.
+
+## Deployment
+
+### TL;DR final code example
+
+To render your OpenAPI definition using Redoc, use the following HTML code sample and
+replace the `spec-url` attribute with the url or local file address to your definition.
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Redoc</title>
+    <!-- needed for adaptive design -->
+    <meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+
+    <!--
+    Redoc doesn't change outer page styles
+    -->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+      }
+    </style>
+  </head>
+  <body>
+    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
+  </body>
+</html>
+
+```
+
+For step-by-step instructions for how to get started using Redoc
+to render your OpenAPI definition, refer to the 
+[**Redoc quickstart guide**](https://redoc.ly/docs/redoc/quickstart/intro/).
+
+See [**IE11 Support Notes**](docs/usage-with-ie11.md) for information on 
+IE support for Redoc.
+
+## Redoc CLI
+For more information on Redoc's commmand-line interface, refer to
+[**Using the Redoc CLI**](https://redoc.ly/docs/redoc/quickstart/cli/).
+
 
 ## Configuration
 
-Redoc is highly configurable, see the [configuration documentation](docs/config.md) for details.
+### Security Definition location
+You can inject the Security Definitions widget into any place in your definition `description`.
+For more information, refer to [Security definitions injection](docs/security-definitions-injection.md).
 
 ### OpenAPI specification extensions
-Redoc uses the following [specification extensions](https://redocly.com/docs/api-reference-docs/spec-extensions/):
-
+Redoc uses the following [specification extensions](https://swagger.io/specification/#specificationExtensions):
 * [`x-logo`](docs/redoc-vendor-extensions.md#x-logo) - is used to specify API logo
-* [`x-traitTag`](docs/redoc-vendor-extensions.md#x-traitTag) - useful for tags that refer to non-navigation properties like Pagination, Rate-Limits, etc
+* [`x-traitTag`](docs/redoc-vendor-extensions.md#x-traitTag) - useful for handling out common things like Pagination, Rate-Limits, etc
 * [`x-codeSamples`](docs/redoc-vendor-extensions.md#x-codeSamples) - specify operation code samples
-* [`x-badges`](docs/redoc-vendor-extensions.md#x-badges) - specify operation badges
 * [`x-examples`](docs/redoc-vendor-extensions.md#x-examples) - specify JSON example for requests
 * [`x-nullable`](docs/redoc-vendor-extensions.md#x-nullable) - mark schema param as a nullable
 * [`x-displayName`](docs/redoc-vendor-extensions.md#x-displayname) - specify human-friendly names for the menu categories
 * [`x-tagGroups`](docs/redoc-vendor-extensions.md#x-tagGroups) - group tags by categories in the side menu
 * [`x-servers`](docs/redoc-vendor-extensions.md#x-servers) - ability to specify different servers for API (backported from OpenAPI 3.0)
+* [`x-ignoredHeaderParameters`](docs/redoc-vendor-extensions.md#x-ignoredHeaderParameters) - ability to specify header parameter names to ignore
 * [`x-additionalPropertiesName`](docs/redoc-vendor-extensions.md#x-additionalPropertiesName) - ability to supply a descriptive name for the additional property keys
-* [`x-summary`](docs/redoc-vendor-extensions.md#x-summary) - for Response object, use as the response button text, with description rendered under the button
-* [`x-explicitMappingOnly`](docs/redoc-vendor-extensions.md#x-explicitMappingOnly) - in Schemas, display a more descriptive property name in objects with additionalProperties when viewing the property list with an object
+* [`x-summary`](docs/redoc-vendor-extensions.md#x-summary) - For Response object, use as the response button text, with description rendered under the button
+* [`x-extendedDiscriminator`](docs/redoc-vendor-extensions.md#x-extendedDiscriminator) - In Schemas, uses this to solve name-clash issues with the standard discriminator
+* [`x-explicitMappingOnly`](docs/redoc-vendor-extensions.md#x-explicitMappingOnly) - In Schemas, display a more descriptive property name in objects with additionalProperties when viewing the property list with an object
 
-## Releases
+### `<redoc>` options object
+You can use all of the following options with the standalone version of the <redoc> tag by kebab-casing them. For example, `scrollYOffset` becomes `scroll-y-offset`, and `expandResponses` becomes `expand-responses`.
 
-**The README for the `1.x` version is on the [v1.x](https://github.com/Redocly/redoc/tree/v1.x) branch.**
-
-All the 2.x releases are deployed to npm and can be used with Redocly-cdn:
-- particular release, for example, `v2.0.0`: https://cdn.redoc.ly/redoc/v2.0.0/bundles/redoc.standalone.js
-- `latest` release: https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js
-
-Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(deprecated)**:
-- particular release, for example `v1.2.0`: https://rebilly.github.io/ReDoc/releases/v1.2.0/redoc.min.js
-- `v1.x.x` release: https://rebilly.github.io/ReDoc/releases/v1.x.x/redoc.min.js
-- `latest` release: https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js - points to latest 1.x.x release since 2.x releases are not hosted on this CDN but on unpkg.
+* `disableSearch` - disable search indexing and search box.
+* `expandDefaultServerVariables` - enable expanding default server variables, default `false`.
+* `expandResponses` - specify which responses to expand by default by response codes. Values should be passed as comma-separated list without spaces e.g. `expandResponses="200,201"`. Special value `"all"` expands all responses by default. Be careful: this option can slow-down documentation rendering time.
+* `generatedPayloadSamplesMaxDepth` - set the maximum render depth for JSON payload samples (responses and request body). The default value is `10`.
+* `maxDisplayedEnumValues` - display only specified number of enum values. hide rest values under spoiler.
+* `hideDownloadButton` - do not show "Download" spec button. **THIS DOESN'T MAKE YOUR SPEC PRIVATE**, it just hides the button.
+* `hideHostname` - if set, the protocol and hostname is not shown in the operation definition.
+* `hideLoading` - do not show loading animation. Useful for small docs.
+* `hideSchemaPattern` - if set, the pattern is not shown in the schema.
+* `hideSingleRequestSampleTab` - do not show the request sample tab for requests with only one sample.
+* `expandSingleSchemaField` - automatically expand single field in a schema
+* `jsonSampleExpandLevel` - set the default expand level for JSON payload samples (responses and request body). Special value `"all"` expands all levels. The default value is `2`.
+* `hideSchemaTitles` - do not display schema `title` next to to the type
+* `simpleOneOfTypeLabel` - show only unique oneOf types in the label without titles
+* `lazyRendering` - _Not implemented yet_ ~~if set, enables lazy rendering mode in ReDoc. This mode is useful for APIs with big number of operations (e.g. > 50). In this mode ReDoc shows initial screen ASAP and then renders the rest operations asynchronously while showing progress bar on the top. Check out the [demo](\\redocly.github.io/redoc) for the example.~~
+* `menuToggle` - if true clicking second time on expanded menu item will collapse it, default `true`.
+* `nativeScrollbars` - use native scrollbar for sidemenu instead of perfect-scroll (scrolling performance optimization for big specs).
+* `noAutoAuth` - do not inject Authentication section automatically.
+* `onlyRequiredInSamples` - shows only required fields in request samples.
+* `pathInMiddlePanel` - show path link and HTTP verb in the middle panel instead of the right one.
+* `requiredPropsFirst` - show required properties first ordered in the same order as in `required` array.
+* `scrollYOffset` - If set, specifies a vertical scroll-offset. This is often useful when there are fixed positioned elements at the top of the page, such as navbars, headers etc;
+`scrollYOffset` can be specified in various ways:
+  * **number**: A fixed number of pixels to be used as offset.
+  * **selector**: selector of the element to be used for specifying the offset. The distance from the top of the page to the element's bottom will be used as offset.
+  * **function**: A getter function. Must return a number representing the offset (in pixels).
+* `showExtensions` - show vendor extensions ("x-" fields). Extensions used by ReDoc are ignored. Can be boolean or an array of `string` with names of extensions to display.
+* `sortPropsAlphabetically` - sort properties alphabetically.
+* `payloadSampleIdx` - if set, payload sample will be inserted at this index or last. Indexes start from 0.
+* `theme` - ReDoc theme. For details check [theme docs](#redoc-theme-object).
+* `untrustedSpec` - if set, the spec is considered untrusted and all HTML/markdown is sanitized to prevent XSS. **Disabled by default** for performance reasons. **Enable this option if you work with untrusted user data!**
 
+### `<redoc>` theme object
+* `spacing`
+  * `unit`: 5 # main spacing unit used in autocomputed theme values later
+  * `sectionHorizontal`: 40 # Horizontal section padding. COMPUTED: spacing.unit * 8
+  * `sectionVertical`: 40 # Horizontal section padding. COMPUTED: spacing.unit * 8
+* `breakpoints` # breakpoints for switching three/two and mobile view layouts
+  * `small`: '50rem'
+  * `medium`: '85rem'
+  * `large`: '105rem'
+* `colors`
+  * `tonalOffset`: 0.3 # default tonal offset used in computations
+* `typography`
+  * `fontSize`: '14px'
+  * `lineHeight`: '1.5em'
+  * `fontWeightRegular`: '400'
+  * `fontWeightBold`: '600'
+  * `fontWeightLight`: '300'
+  * `fontFamily`: 'Roboto, sans-serif'
+  * `smoothing`: 'antialiased'
+  * `optimizeSpeed`: true
+  * `headings`
+    * `fontFamily`: 'Montserrat, sans-serif'
+    * `fontWeight`: '400'
+    * `lineHeight`: '1.6em'
+  * `code` # inline code styling
+    * `fontSize`: '13px'
+    * `fontFamily`: 'Courier, monospace'
+    * `lineHeight`: # COMPUTED: typography.lineHeight
+    * `fontWeight`: # COMPUTED: typography.fontWeightRegular
+    * `color`: '#e53935'
+    * `backgroundColor`: 'rgba(38, 50, 56, 0.05)'
+    * `wrap`: false # whether to break word for inline blocks (otherwise they can overflow)
+  * `links`
+    * `color`: # COMPUTED: colors.primary.main
+    * `visited`: # COMPUTED: typography.links.color
+    * `hover`: # COMPUTED: lighten(0.2 typography.links.color)
+* `menu`
+  * `width`: '260px'
+  * `backgroundColor`: '#fafafa'
+  * `textColor`: '#333333'
+  * `activeTextColor`: # COMPUTED: theme.menu.textColor (if set by user) or theme.colors.primary.main
+  * `groupItems` # Group headings
+    * `textTransform`: 'uppercase'
+  * `level1Items` # Level 1 items like tags or section 1st level items
+    * `textTransform`: 'none'
+  * `arrow` # menu arrow
+    * `size`: '1.5em'
+    * `color`: # COMPUTED: theme.menu.textColor
+* `logo`
+  * `maxHeight`: # COMPUTED: menu.width
+  * `maxWidth`: # COMPUTED: menu.width
+  * `gutter`: '2px' # logo image padding
+* `rightPanel`
+  * `backgroundColor`: '#263238'
+  * `width`: '40%'
+  * `textColor`: '#ffffff'
 
+-----------
 ## Development
 see [CONTRIBUTING.md](.github/CONTRIBUTING.md)

cli/.npmignore

@@ -0,0 +1,4 @@
+*/
+!index.js
+!package.json
+!README.md

cli/Dockerfile

@@ -0,0 +1,23 @@
+# Package the 'redoc-cli' as a docker image.
+#
+# To build:
+# $ cd <Redoc project directory>
+# $ docker build -t redoc-cli -f cli/Dockerfile .
+#
+# To run:
+# To display the command line options:
+# $ docker run --rm -it redoc-cli --help
+# .. will display the command line help
+#
+# To turn `swagger.yml` file in the current directory, to html documentation 'redoc-static.html'
+# $  docker run --rm -it  -v $PWD:/data redoc-cli bundle swagger.yml
+
+FROM node:alpine
+
+RUN npm install -g redoc-cli
+
+WORKDIR /data
+EXPOSE 8080
+
+ENTRYPOINT ["redoc-cli"]
+CMD []

cli/README.md

@@ -0,0 +1,31 @@
+# redoc-cli
+
+**[ReDoc](https://github.com/Redocly/redoc)'s Command Line Interface**
+
+## Installation
+
+You can use `redoc-cli` by installing [the package](https://www.npmjs.com/package/redoc-cli) globally,
+or using [npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b).
+
+## Usage
+
+The two following commands are available:
+
+- `redoc-cli serve [spec]` - starts the server with `spec` rendered with ReDoc.
+  Supports a server-side rendering mode (`--ssr`),
+  and can watch the spec (`--watch`) to automatically reload the page whenever it changes.
+- `redoc-cli bundle [spec]` - bundles `spec` and ReDoc into a **zero-dependency** HTML file.
+
+Some examples:
+
+- Bundle with the main color changed to `orange`:<br/>
+  `$ redoc-cli bundle [spec] --options.theme.colors.primary.main=orange`
+- Serve with the `nativeScrollbars` option set to true:<br/>
+  `$ redoc-cli serve [spec] --options.nativeScrollbars`
+- Bundle using a custom [Handlebars](https://handlebarsjs.com/) template
+  (check the [default template](https://github.com/Redocly/redoc/blob/master/cli/template.hbs) for an example):<br/>
+  `$ redoc-cli bundle [spec] -t custom.hbs`
+- Bundle using a custom template and add custom `templateOptions`:<br/>
+  `$ redoc-cli bundle [spec] -t custom.hbs --templateOptions.metaDescription "Page meta description"`
+
+For more details, run `redoc-cli --help`.

cli/index.ts

@@ -0,0 +1,395 @@
+#!/usr/bin/env node
+/* tslint:disable:no-implicit-dependencies */
+import * as React from 'react';
+import { renderToString } from 'react-dom/server';
+import { ServerStyleSheet } from 'styled-components';
+
+import { compile } from 'handlebars';
+import { createServer, IncomingMessage, ServerResponse } from 'http';
+import { dirname, join, resolve } from 'path';
+
+import * as zlib from 'zlib';
+
+// @ts-ignore
+import { createStore, loadAndBundleSpec, Redoc } from 'redoc';
+
+import { watch } from 'chokidar';
+import {
+  createReadStream,
+  existsSync,
+  lstatSync,
+  readFileSync,
+  ReadStream,
+  writeFileSync,
+} from 'fs';
+import * as mkdirp from 'mkdirp';
+
+import * as YargsParser from 'yargs';
+
+interface Options {
+  ssr?: boolean;
+  watch?: boolean;
+  cdn?: boolean;
+  output?: string;
+  title?: string;
+  disableGoogleFont?: boolean;
+  port?: number;
+  templateFileName?: string;
+  templateOptions?: any;
+  redocOptions?: any;
+}
+
+const BUNDLES_DIR = dirname(require.resolve('redoc'));
+
+/* tslint:disable-next-line */
+YargsParser.command(
+  'serve <spec>',
+  'start the server',
+  yargs => {
+    yargs.positional('spec', {
+      describe: 'path or URL to your spec',
+    });
+
+    yargs.options('title', {
+      describe: 'Page Title',
+      type: 'string',
+    });
+
+    yargs.option('s', {
+      alias: 'ssr',
+      describe: 'Enable server-side rendering',
+      type: 'boolean',
+    });
+
+    yargs.option('p', {
+      alias: 'port',
+      type: 'number',
+      default: 8080,
+    });
+
+    yargs.option('w', {
+      alias: 'watch',
+      type: 'boolean',
+    });
+
+    yargs.options('disable-google-font', {
+      describe: 'Disable Google Font',
+      type: 'boolean',
+      default: false,
+    });
+
+    yargs.demandOption('spec');
+    return yargs;
+  },
+  async argv => {
+    const config: Options = {
+      ssr: argv.ssr as boolean,
+      title: argv.title as string,
+      watch: argv.watch as boolean,
+      disableGoogleFont: argv.disableGoogleFont as boolean,
+      templateFileName: argv.template as string,
+      templateOptions: argv.templateOptions || {},
+      redocOptions: getObjectOrJSON(argv.options),
+    };
+
+    try {
+      await serve(argv.port as number, argv.spec as string, config);
+    } catch (e) {
+      handleError(e);
+    }
+  },
+)
+  .command(
+    'bundle <spec>',
+    'bundle spec into zero-dependency HTML-file',
+    yargs => {
+      yargs.positional('spec', {
+        describe: 'path or URL to your spec',
+      });
+
+      yargs.option('o', {
+        describe: 'Output file',
+        alias: 'output',
+        type: 'string',
+        default: 'redoc-static.html',
+      });
+
+      yargs.options('title', {
+        describe: 'Page Title',
+        type: 'string',
+      });
+
+      yargs.options('disableGoogleFont', {
+        describe: 'Disable Google Font',
+        type: 'boolean',
+        default: false,
+      });
+
+      yargs.option('cdn', {
+        describe: 'Do not include ReDoc source code into html page, use link to CDN instead',
+        type: 'boolean',
+        default: false,
+      });
+
+      yargs.demandOption('spec');
+      return yargs;
+    },
+    async (argv: any) => {
+      const config = {
+        ssr: true,
+        output: argv.o as string,
+        cdn: argv.cdn as boolean,
+        title: argv.title as string,
+        disableGoogleFont: argv.disableGoogleFont as boolean,
+        templateFileName: argv.template as string,
+        templateOptions: argv.templateOptions || {},
+        redocOptions: getObjectOrJSON(argv.options),
+      };
+
+      try {
+        await bundle(argv.spec, config);
+      } catch (e) {
+        handleError(e);
+      }
+    },
+  )
+  .demandCommand()
+  .options('t', {
+    alias: 'template',
+    describe: 'Path to handlebars page template, see https://git.io/vh8fP for the example ',
+    type: 'string',
+  })
+  .options('templateOptions', {
+    describe:
+      'Additional options that you want pass to template. Use dot notation, e.g. templateOptions.metaDescription',
+  })
+  .options('options', {
+    describe: 'ReDoc options, use dot notation, e.g. options.nativeScrollbars',
+  }).argv;
+
+async function serve(port: number, pathToSpec: string, options: Options = {}) {
+  let spec = await loadAndBundleSpec(isURL(pathToSpec) ? pathToSpec : resolve(pathToSpec));
+  let pageHTML = await getPageHTML(spec, pathToSpec, options);
+  const server = createServer((request, response) => {
+    console.time('GET ' + request.url);
+    if (request.url === '/redoc.standalone.js') {
+      respondWithGzip(
+        createReadStream(join(BUNDLES_DIR, 'redoc.standalone.js'), 'utf8'),
+        request,
+        response,
+        {
+          'Content-Type': 'application/javascript',
+        },
+      );
+    } else if (request.url === '/') {
+      respondWithGzip(pageHTML, request, response, {
+        'Content-Type': 'text/html',
+      });
+    } else if (request.url === '/spec.json') {
+      const specStr = JSON.stringify(spec, null, 2);
+      respondWithGzip(specStr, request, response, {
+        'Content-Type': 'application/json',
+      });
+    } else {
+      response.writeHead(404);
+      response.write('Not found');
+      response.end();
+    }
+
+    console.timeEnd('GET ' + request.url);
+  });
+
+  console.log();
+
+  server.listen(port, () => console.log(`Server started: http://127.0.0.1:${port}`));
+
+  if (options.watch && existsSync(pathToSpec)) {
+    const pathToSpecDirectory = resolve(dirname(pathToSpec));
+    const watchOptions = {
+      ignored: [/(^|[\/\\])\../, /___jb_[a-z]+___$/],
+      ignoreInitial: true,
+    };
+
+    const watcher = watch(pathToSpecDirectory, watchOptions);
+    const log = console.log.bind(console);
+
+    const handlePath = async _path => {
+      try {
+        spec = await loadAndBundleSpec(resolve(pathToSpec));
+        pageHTML = await getPageHTML(spec, pathToSpec, options);
+        log('Updated successfully');
+      } catch (e) {
+        console.error('Error while updating: ', e.message);
+      }
+    };
+
+    watcher
+      .on('change', async path => {
+        log(`${path} changed, updating docs`);
+        handlePath(path);
+      })
+      .on('add', async path => {
+        log(`File ${path} added, updating docs`);
+        handlePath(path);
+      })
+      .on('addDir', path => {
+        log(`↗  Directory ${path} added. Files in here will trigger reload.`);
+      })
+      .on('error', error => console.error(`Watcher error: ${error}`))
+      .on('ready', () => log(`👀  Watching ${pathToSpecDirectory} for changes...`));
+  }
+}
+
+async function bundle(pathToSpec, options: Options = {}) {
+  const start = Date.now();
+  const spec = await loadAndBundleSpec(isURL(pathToSpec) ? pathToSpec : resolve(pathToSpec));
+  const pageHTML = await getPageHTML(spec, pathToSpec, { ...options, ssr: true });
+
+  mkdirp.sync(dirname(options.output!));
+  writeFileSync(options.output!, pageHTML);
+  const sizeInKiB = Math.ceil(Buffer.byteLength(pageHTML) / 1024);
+  const time = Date.now() - start;
+  console.log(
+    `\n🎉 bundled successfully in: ${options.output!} (${sizeInKiB} KiB) [⏱ ${time / 1000}s]`,
+  );
+}
+
+async function getPageHTML(
+  spec: any,
+  pathToSpec: string,
+  {
+    ssr,
+    cdn,
+    title,
+    disableGoogleFont,
+    templateFileName,
+    templateOptions,
+    redocOptions = {},
+  }: Options,
+) {
+  let html;
+  let css;
+  let state;
+  let redocStandaloneSrc;
+  if (ssr) {
+    console.log('Prerendering docs');
+
+    const specUrl = redocOptions.specUrl || (isURL(pathToSpec) ? pathToSpec : undefined);
+    const store = await createStore(spec, specUrl, redocOptions);
+    const sheet = new ServerStyleSheet();
+    html = renderToString(sheet.collectStyles(React.createElement(Redoc, { store })));
+    css = sheet.getStyleTags();
+    state = await store.toJS();
+
+    if (!cdn) {
+      redocStandaloneSrc = readFileSync(join(BUNDLES_DIR, 'redoc.standalone.js'));
+    }
+  }
+
+  templateFileName = templateFileName ? templateFileName : join(__dirname, './template.hbs');
+  const template = compile(readFileSync(templateFileName).toString());
+  return template({
+    redocHTML: `
+    <div id="redoc">${(ssr && html) || ''}</div>
+    <script>
+    ${(ssr && `const __redoc_state = ${sanitizeJSONString(JSON.stringify(state))};`) || ''}
+
+    var container = document.getElementById('redoc');
+    Redoc.${
+      ssr
+        ? 'hydrate(__redoc_state, container)'
+        : `init("spec.json", ${JSON.stringify(redocOptions)}, container)`
+    };
+
+    </script>`,
+    redocHead: ssr
+      ? (cdn
+          ? '<script src="https://unpkg.com/redoc@next/bundles/redoc.standalone.js"></script>'
+          : `<script>${redocStandaloneSrc}</script>`) + css
+      : '<script src="redoc.standalone.js"></script>',
+    title: title || spec.info.title || 'ReDoc documentation',
+    disableGoogleFont,
+    templateOptions,
+  });
+}
+
+// credits: https://stackoverflow.com/a/9238214/1749888
+function respondWithGzip(
+  contents: string | ReadStream,
+  request: IncomingMessage,
+  response: ServerResponse,
+  headers = {},
+) {
+  let compressedStream;
+  const acceptEncoding = (request.headers['accept-encoding'] as string) || '';
+  if (acceptEncoding.match(/\bdeflate\b/)) {
+    response.writeHead(200, { ...headers, 'content-encoding': 'deflate' });
+    compressedStream = zlib.createDeflate();
+  } else if (acceptEncoding.match(/\bgzip\b/)) {
+    response.writeHead(200, { ...headers, 'content-encoding': 'gzip' });
+    compressedStream = zlib.createGzip();
+  } else {
+    response.writeHead(200, headers);
+    if (typeof contents === 'string') {
+      response.write(contents);
+      response.end();
+    } else {
+      contents.pipe(response);
+    }
+    return;
+  }
+
+  if (typeof contents === 'string') {
+    compressedStream.write(contents);
+    compressedStream.pipe(response);
+    compressedStream.end();
+    return;
+  } else {
+    contents.pipe(compressedStream).pipe(response);
+  }
+}
+
+function isURL(str: string): boolean {
+  return /^(https?:)\/\//m.test(str);
+}
+
+function sanitizeJSONString(str: string) {
+  return escapeClosingScriptTag(escapeUnicode(str));
+}
+
+// see http://www.thespanner.co.uk/2011/07/25/the-json-specification-is-now-wrong/
+function escapeClosingScriptTag(str) {
+  return str.replace(/<\/script>/g, '<\\/script>');
+}
+
+// see http://www.thespanner.co.uk/2011/07/25/the-json-specification-is-now-wrong/
+function escapeUnicode(str) {
+  return str.replace(/\u2028|\u2029/g, m => '\\u202' + (m === '\u2028' ? '8' : '9'));
+}
+
+function handleError(error: Error) {
+  console.error(error.stack);
+  process.exit(1);
+}
+
+function getObjectOrJSON(options) {
+  switch (typeof options) {
+    case 'object':
+      return options;
+    case 'string':
+      try {
+        if (existsSync(options) && lstatSync(options).isFile()) {
+          return JSON.parse(readFileSync(options, 'utf-8'));
+        } else {
+          return JSON.parse(options);
+        }
+      } catch (e) {
+        console.log(
+          `Encountered error:\n\n${options}\n\nis neither a file with a valid JSON object neither a stringified JSON object.`,
+        );
+        handleError(e);
+      }
+    default:
+      return {};
+  }
+}

cli/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "redoc-cli",
+  "version": "0.13.0",
+  "description": "ReDoc's Command Line Interface",
+  "main": "index.js",
+  "bin": "index.js",
+  "repository": "https://github.com/Redocly/redoc",
+  "author": "Roman Hotsiy <gotsijroman@gmail.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "dependencies": {
+    "chokidar": "^3.5.1",
+    "handlebars": "^4.7.7",
+    "isarray": "^2.0.5",
+    "mkdirp": "^1.0.4",
+    "mobx": "^6.3.2",
+    "node-libs-browser": "^2.2.1",
+    "react": "^17.0.1",
+    "react-dom": "^17.0.1",
+    "redoc": "2.0.0-rc.57",
+    "styled-components": "^5.3.0",
+    "yargs": "^17.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/chokidar": "^2.1.3",
+    "@types/handlebars": "^4.1.0",
+    "@types/mkdirp": "^1.0.1"
+  }
+}

cli/template.hbs

@@ -0,0 +1,23 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+  <meta charset="utf8" />
+  <title>{{title}}</title>
+  <!-- needed for adaptive design -->
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <style>
+    body {
+      padding: 0;
+      margin: 0;
+    }
+  </style>
+  {{{redocHead}}}
+  {{#unless disableGoogleFont}}<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">{{/unless}}
+</head>
+
+<body>
+  {{{redocHTML}}}
+</body>
+
+</html>

config/docker/Dockerfile

@@ -5,7 +5,7 @@
 # npm i -g http-server
 # http-server -p 8000 --cors
 
-FROM node:18-alpine
+FROM node:alpine
 
 RUN apk update && apk add --no-cache git
 
@@ -13,7 +13,6 @@ RUN apk update && apk add --no-cache git
 WORKDIR /build
 COPY package.json package-lock.json /build/
 RUN npm ci --no-optional --ignore-scripts
-RUN npm explore esbuild -- npm run postinstall
 
 # copy only required for the build files
 COPY src /build/src
@@ -27,7 +26,6 @@ FROM nginx:alpine
 
 ENV PAGE_TITLE="ReDoc"
 ENV PAGE_FAVICON="favicon.png"
-ENV BASE_PATH=
 ENV SPEC_URL="http://petstore.swagger.io/v2/swagger.json"
 ENV PORT=80
 ENV REDOC_OPTIONS=

config/docker/README.md

@@ -45,10 +45,9 @@ Another issue with OpenShift is that the default exposed port `80` cannot be use
 
 - `PAGE_TITLE` (default `"ReDoc"`) - page title
 - `PAGE_FAVICON` (default `"favicon.png"`) - URL to page favicon
-- `BASE_PATH` (optional) - prepend favicon & standalone bundle with this path
 - `SPEC_URL` (default `"http://petstore.swagger.io/v2/swagger.json"`) - URL to spec
 - `PORT` (default `80`) - nginx port
-- `REDOC_OPTIONS` (optional) - [`<redoc>` tag attributes](https://github.com/Redocly/redoc#redoc-tag-attributes)
+- `REDOC_OPTIONS` - [`<redoc>` tag attributes](https://github.com/Redocly/redoc#redoc-tag-attributes)
 
 ## Build
 

config/docker/docker-run.sh

@@ -4,7 +4,6 @@ set -e
 
 sed -i -e "s|%PAGE_TITLE%|$PAGE_TITLE|g" /usr/share/nginx/html/index.html
 sed -i -e "s|%PAGE_FAVICON%|$PAGE_FAVICON|g" /usr/share/nginx/html/index.html
-sed -i -e "s|%BASE_PATH%|$BASE_PATH|g" /usr/share/nginx/html/index.html
 sed -i -e "s|%SPEC_URL%|$SPEC_URL|g" /usr/share/nginx/html/index.html
 sed -i -e "s|%REDOC_OPTIONS%|${REDOC_OPTIONS}|g" /usr/share/nginx/html/index.html
 sed -i -e "s|\(listen\s*\) [0-9]*|\1 ${PORT}|g" /etc/nginx/nginx.conf

config/docker/index.tpl.html

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>%PAGE_TITLE%</title>
-    <link rel="icon" href="%BASE_PATH%%PAGE_FAVICON%" />
+    <link rel="icon" href="%PAGE_FAVICON%" />
     <style>
       body {
         margin: 0;
@@ -23,6 +23,6 @@
 
   <body>
     <redoc spec-url="%SPEC_URL%" %REDOC_OPTIONS%></redoc>
-    <script src="%BASE_PATH%redoc.standalone.js"></script>
+    <script src="redoc.standalone.js"></script>
   </body>
 </html>

config/webpack-utils.ts

@@ -1,5 +1,46 @@
 import * as webpack from 'webpack';
 
-export function webpackIgnore(regexp) {
-  return new webpack.NormalModuleReplacementPlugin(regexp, require.resolve('lodash.noop'));
+export function getBabelLoader({useBuiltIns, hot}: {useBuiltIns: boolean, hot?: boolean}) {
+  return {
+    loader: 'babel-loader',
+    options: {
+      babelrc: false,
+      sourceType: 'unambiguous',
+      presets: [
+        [
+          '@babel/preset-env',
+          {
+            useBuiltIns: useBuiltIns ? 'usage' : false,
+            corejs: 3,
+            exclude: ['transform-typeof-symbol'],
+            targets: 'defaults',
+            modules: false,
+          },
+        ],
+        ['@babel/preset-react', { development: false, runtime: 'classic' }],
+        '@babel/preset-typescript',
+      ],
+      plugins: [
+        ['@babel/plugin-proposal-decorators', { legacy: true }],
+        ['@babel/plugin-proposal-class-properties', { loose: false }],
+        [
+          '@babel/plugin-transform-runtime',
+          {
+            corejs: false,
+            helpers: true,
+            // eslint-disable-next-line import/no-internal-modules
+            version: require('@babel/runtime/package.json').version,
+            regenerator: true,
+          },
+        ],
+        '@babel/plugin-proposal-optional-chaining',
+        '@babel/plugin-proposal-nullish-coalescing-operator',
+        hot ? 'react-hot-loader/babel' : undefined,
+      ].filter(Boolean)
+    },
+  };
+}
+
+export function webpackIgnore(regexp) {
+  return new webpack.NormalModuleReplacementPlugin(regexp, require.resolve('lodash/noop.js'));
 }

custom.d.ts

@@ -23,5 +23,3 @@ declare var reactHotLoaderGlobal: any;
 interface Element {
   scrollIntoViewIfNeeded(centerIfNeeded?: boolean): void;
 }
-
-type GenericObject = Record<string, any>;

cypress.config.ts

@@ -1,20 +0,0 @@
-import { defineConfig } from 'cypress';
-
-export default defineConfig({
-  fixturesFolder: false,
-  fileServerFolder: '.',
-  video: true,
-  projectId: 'z6eb6h',
-  viewportWidth: 1440,
-  viewportHeight: 720,
-  e2e: {
-    // We've imported your old cypress plugins here.
-    // You may want to clean this up later by importing these.
-    setupNodeEvents(on, config) {
-      return require('./e2e/plugins/index.js')(on, config);
-    },
-    excludeSpecPattern: '*.js.map',
-    specPattern: 'e2e/integration/**/*.{js,jsx,ts,tsx}',
-    supportFile: false,
-  },
-});

cypress.json

@@ -0,0 +1,12 @@
+{
+  "ignoreTestFiles": "*.js.map",
+  "integrationFolder": "e2e/integration",
+  "pluginsFile": "e2e/plugins/index.js",
+  "fixturesFolder": false,
+  "supportFile": false,
+  "fileServerFolder": ".",
+  "video": true,
+  "projectId": "z6eb6h",
+  "viewportWidth": 1440,
+  "viewportHeight": 720
+}

demo/ComboBox.tsx

@@ -6,8 +6,8 @@
 import * as React from 'react';
 import styled from '../src/styled-components';
 
-const DropDownItem = styled.li<{ $active?: boolean }>`
-  ${(props: any) => (props.$active ? 'background-color: #eee' : '')};
+const DropDownItem = styled.li<{ active?: boolean }>`
+  ${(props: any) => (props.active ? 'background-color: #eee' : '')};
   padding: 13px 16px;
   &:hover {
     background-color: #eee;
@@ -31,7 +31,7 @@ const DropDownList = styled.ul`
   list-style: none;
   margin: 4px 0 0 0;
   padding: 5px 0;
-  font-family: Roboto, sans-serif;
+  font-family: Roboto,sans-serif;
   overflow: hidden;
 `;
 
@@ -183,7 +183,7 @@ export default class ComboBox extends React.Component<ComboBoxProps, ComboBoxSta
   renderOption = (option: { value: string; label: string }, idx: number) => {
     return (
       <DropDownItem
-        $active={idx === this.state.activeItemIdx}
+        active={idx === this.state.activeItemIdx}
         key={option.value}
         // tslint:disable-next-line
         onMouseDown={() => {

demo/components/FileInput.tsx

@@ -1,52 +0,0 @@
-import * as yaml from 'js-yaml';
-import * as React from 'react';
-import { ChangeEvent, RefObject, useRef } from 'react';
-import styled from '../../src/styled-components';
-
-const Button = styled.button`
-  background-color: #fff;
-  color: #333;
-  padding: 2px 10px;
-  touch-action: manipulation;
-  cursor: pointer;
-  user-select: none;
-  border: 1px solid #ccc;
-  font-size: 16px;
-  height: 28px;
-  box-sizing: border-box;
-  vertical-align: middle;
-  line-height: 1;
-  outline: none;
-  white-space: nowrap;
-  @media (max-width: 699px) {
-    display: none;
-  }
-`;
-
-function FileInput(props: { onUpload }) {
-  const hiddenFileInput: RefObject<HTMLInputElement> = useRef<HTMLInputElement>(null);
-
-  const handleClick = () => {
-    if (hiddenFileInput && hiddenFileInput.current) {
-      hiddenFileInput.current.click();
-    }
-  };
-
-  const uploadFile = (event: ChangeEvent<HTMLInputElement>) => {
-    const file = (event.target as HTMLInputElement).files![0];
-    const reader = new FileReader();
-    reader.onload = () => {
-      props.onUpload(yaml.load(reader.result));
-    };
-    reader.readAsText(file);
-  };
-
-  return (
-    <span>
-      <Button onClick={handleClick}>Upload a file</Button>
-      <input type="file" style={{ display: 'none' }} onChange={uploadFile} ref={hiddenFileInput} />
-    </span>
-  );
-}
-
-export default FileInput;

demo/index.html

@@ -1,63 +1,46 @@
 <!DOCTYPE html>
 <html>
-  <head>
-    <meta charset="UTF-8" />
-    <title>Redoc Interactive Demo</title>
-    <meta
-      name="description"
-      content="Redoc Interactive Demo. OpenAPI-generated API Reference Documentation"
-    />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
 
-    <meta property="og:title" content="Redoc Interactive Demo" />
-    <meta
-      property="og:description"
-      content="Redoc Interactive Demo. OpenAPI-generated API Reference Documentation"
-    />
-    <meta
-      property="og:image"
-      content="https://user-images.githubusercontent.com/3975738/37729752-8a9ea38a-2d46-11e8-8438-42ed26bf1751.png"
-    />
-    <meta name="twitter:card" content="summary_large_image" />
+<head>
+  <meta charset="UTF-8" />
+  <title>ReDoc Interactive Demo</title>
+  <meta name="description" content="ReDoc Interactive Demo. OpenAPI/Swagger-generated API Reference Documentation" />
+  <meta name="viewport" content="width=device-width, initial-scale=1">
 
-    <style>
-      body {
-        margin: 0;
-        padding: 0;
-      }
+  <meta property="og:title" content="ReDoc Interactive Demo">
+  <meta property="og:description" content="ReDoc Interactive Demo. OpenAPI/Swagger-generated API Reference Documentation">
+  <meta property="og:image" content="https://user-images.githubusercontent.com/3975738/37729752-8a9ea38a-2d46-11e8-8438-42ed26bf1751.png">
+  <meta name="twitter:card" content="summary_large_image">
 
-      redoc {
-        display: block;
-      }
-    </style>
-    <link
-      href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700"
-      rel="stylesheet"
-    />
-  </head>
+  <style>
+    body {
+      margin: 0;
+      padding: 0;
+    }
 
-  <body>
-    <div id="container"></div>
+    redoc {
+      display: block;
+    }
+  </style>
+  <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+</head>
 
-    <script>
-      (function (i, s, o, g, r, a, m) {
-        i['GoogleAnalyticsObject'] = r;
-        (i[r] =
-          i[r] ||
-          function () {
-            (i[r].q = i[r].q || []).push(arguments);
-          }),
-          (i[r].l = 1 * new Date());
-        (a = s.createElement(o)), (m = s.getElementsByTagName(o)[0]);
-        a.async = 1;
-        a.src = g;
-        m.parentNode.insertBefore(a, m);
-      })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga');
+<body>
+  <div id="container"> </div>
 
-      if (window.location.host === 'rebilly.github.io') {
-        ga('create', 'UA-81703547-1', 'auto');
-        ga('send', 'pageview');
-      }
-    </script>
-  </body>
-</html>
+  <script>
+    (function (i, s, o, g, r, a, m) {
+      i['GoogleAnalyticsObject'] = r; i[r] = i[r] || function () {
+        (i[r].q = i[r].q || []).push(arguments)
+      }, i[r].l = 1 * new Date(); a = s.createElement(o),
+        m = s.getElementsByTagName(o)[0]; a.async = 1; a.src = g; m.parentNode.insertBefore(a, m)
+    })(window, document, 'script', 'https://www.google-analytics.com/analytics.js', 'ga');
+
+    if (window.location.host === 'rebilly.github.io') {
+      ga('create', 'UA-81703547-1', 'auto');
+      ga('send', 'pageview');
+    }
+  </script>
+</body>
+
+</html>

demo/index.tsx

@@ -1,16 +1,15 @@
 import * as React from 'react';
-import { createRoot } from 'react-dom/client';
+import { render } from 'react-dom';
 import styled from 'styled-components';
+import { resolve as urlResolve } from 'url';
 import { RedocStandalone } from '../src';
 import ComboBox from './ComboBox';
-import FileInput from './components/FileInput';
 
-const DEFAULT_SPEC = 'museum.yaml';
-const NEW_VERSION_PETSTORE = 'openapi-3-1.yaml';
+const DEFAULT_SPEC = 'openapi.yaml';
+const NEW_VERSION_SPEC = 'openapi-3-1.yaml';
 
 const demos = [
-  { value: DEFAULT_SPEC, label: 'Museum API' },
-  { value: NEW_VERSION_PETSTORE, label: 'Petstore OpenAPI 3.1' },
+  { value: NEW_VERSION_SPEC, label: 'Petstore OpenAPI 3.1' },
   { value: 'https://api.apis.guru/v2/specs/instagram.com/1.0.0/swagger.yaml', label: 'Instagram' },
   {
     value: 'https://api.apis.guru/v2/specs/googleapis.com/calendar/v3/openapi.yaml',
@@ -18,11 +17,12 @@ const demos = [
   },
   { value: 'https://api.apis.guru/v2/specs/slack.com/1.7.0/openapi.yaml', label: 'Slack' },
   { value: 'https://api.apis.guru/v2/specs/zoom.us/2.0.0/openapi.yaml', label: 'Zoom.us' },
+  { value: 'https://docs.graphhopper.com/openapi.json', label: 'GraphHopper' },
 ];
 
 class DemoApp extends React.Component<
-  Record<string, unknown>,
-  { spec: object | undefined; specUrl: string; dropdownOpen: boolean; cors: boolean }
+  {},
+  { specUrl: string; dropdownOpen: boolean; cors: boolean }
 > {
   constructor(props) {
     super(props);
@@ -40,24 +40,15 @@ class DemoApp extends React.Component<
     }
 
     this.state = {
-      spec: undefined,
       specUrl: url,
       dropdownOpen: false,
       cors,
     };
   }
 
-  handleUploadFile = (spec: object) => {
-    this.setState({
-      spec,
-      specUrl: '',
-    });
-  };
-
   handleChange = (url: string) => {
-    if (url === NEW_VERSION_PETSTORE) {
-      this.setState({ cors: false });
-      0;
+    if (url === NEW_VERSION_SPEC) {
+      this.setState({ cors: false })
     }
     this.setState({
       specUrl: url,
@@ -86,7 +77,7 @@ class DemoApp extends React.Component<
     let proxiedUrl = specUrl;
     if (specUrl !== DEFAULT_SPEC) {
       proxiedUrl = cors
-        ? 'https://cors.redoc.ly/' + new URL(specUrl, window.location.href).href
+        ? '\\\\cors.redoc.ly/' + urlResolve(window.location.href, specUrl)
         : specUrl;
     }
     return (
@@ -94,12 +85,11 @@ class DemoApp extends React.Component<
         <Heading>
           <a href=".">
             <Logo
-              src="https://github.com/Redocly/redoc/raw/main/docs/images/redoc.png"
+              src="https://github.com/Redocly/redoc/raw/master/docs/images/redoc-logo.png"
               alt="Redoc logo"
             />
           </a>
           <ControlsContainer>
-            <FileInput onUpload={this.handleUploadFile} />
             <ComboBox
               placeholder={'URL to a spec to try'}
               options={demos}
@@ -120,9 +110,8 @@ class DemoApp extends React.Component<
           />
         </Heading>
         <RedocStandalone
-          spec={this.state.spec}
           specUrl={proxiedUrl}
-          options={{ scrollYOffset: 'nav', sanitize: true }}
+          options={{ scrollYOffset: 'nav', untrustedSpec: true }}
         />
       </>
     );
@@ -179,9 +168,7 @@ const Logo = styled.img`
   }
 `;
 
-const container = document.getElementById('container');
-const root = createRoot(container!);
-root.render(<DemoApp />);
+render(<DemoApp />, document.getElementById('container'));
 
 /* ====== Helpers ====== */
 function updateQueryStringParameter(uri, key, value) {

demo/museum.yaml

@@ -1,787 +0,0 @@
-openapi: 3.1.0
-info:
-  title: Redocly Museum API
-  description: An imaginary, but delightful Museum API for interacting with museum services and information. Built with love by Redocly.
-  version: 1.0.0
-  contact:
-    email: team@redocly.com
-    url: 'https://redocly.com/docs/cli/'
-  x-logo:
-    url: 'https://redocly.github.io/redoc/museum-logo.png'
-    altText: Museum logo
-  license:
-    name: MIT
-    url: 'https://opensource.org/license/mit/ '
-servers:
-  - url: 'https://api.fake-museum-example.com/v1'
-paths:
-  /museum-hours:
-    get:
-      summary: Get museum hours
-      description: Get upcoming museum operating hours
-      operationId: getMuseumHours
-      tags:
-        - Operations
-      x-badges:
-        - name: 'Beta'
-          position: before
-          color: purple
-      parameters:
-        - $ref: '#/components/parameters/StartDate'
-        - $ref: '#/components/parameters/PaginationPage'
-        - $ref: '#/components/parameters/PaginationLimit'
-      responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/GetMuseumHoursResponse'
-              examples:
-                default:
-                  summary: Museum opening hours
-                  value:
-                    - date: '2023-09-11'
-                      timeOpen: '09:00'
-                      timeClose: '18:00'
-                    - date: '2023-09-12'
-                      timeOpen: '09:00'
-                      timeClose: '18:00'
-                    - date: '2023-09-13'
-                      timeOpen: '09:00'
-                      timeClose: '18:00'
-                    - date: '2023-09-17'
-                      timeOpen: '09:00'
-                      timeClose: '18:00'
-                closed:
-                  summary: The museum is closed
-                  value: []
-
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-  /special-events:
-    post:
-      security: []
-      operationId: CreateSpecialEvent
-      summary: Create special event
-      tags:
-        - Events
-      x-badges:
-        - name: 'Alpha'
-          color: purple
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/CreateSpecialEventRequest'
-            examples:
-              default_example:
-                $ref: '#/components/examples/CreateSpecialEventRequestExample'
-      responses:
-        '200':
-          description: success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SpecialEventResponse'
-              examples:
-                default_example:
-                  $ref: '#/components/examples/CreateSpecialEventResponseExample'
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-    get:
-      summary: List special events
-      description: Return a list of upcoming special events at the museum.
-      security: []
-      operationId: listSpecialEvents
-      x-badges:
-        - name: 'Gamma'
-      tags:
-        - Events
-      parameters:
-        - name: startDate
-          in: query
-          description: The starting date to retrieve future operating hours from. Defaults to today's date.
-          schema:
-            type: string
-            format: date
-            example: 2023-02-23
-        - name: endDate
-          in: query
-          description: The end of a date range to retrieve special events for. Defaults to 7 days after `startDate`.
-          schema:
-            type: string
-            format: date
-            example: 2023-04-18
-        - name: page
-          in: query
-          description: The page number to retrieve.
-          schema:
-            type: integer
-            default: 1
-            example: 2
-        - name: limit
-          in: query
-          description: The number of days per page.
-          schema:
-            type: integer
-            default: 10
-            maximum: 30
-            example: 15
-
-      responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/ListSpecialEventsResponse'
-              examples:
-                default_example:
-                  $ref: '#/components/examples/ListSpecialEventsResponseExample'
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-  /special-events/{eventId}:
-    get:
-      summary: Get special event
-      description: Get details about a special event.
-      operationId: getSpecialEvent
-      tags:
-        - Events
-      parameters:
-        - $ref: '#/components/parameters/EventId'
-      responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SpecialEventResponse'
-              examples:
-                default_example:
-                  $ref: '#/components/examples/GetSpecialEventResponseExample'
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-    patch:
-      summary: Update special event
-      description: Update the details of a special event
-      operationId: updateSpecialEvent
-      tags:
-        - Events
-      parameters:
-        - $ref: '#/components/parameters/EventId'
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/UpdateSpecialEventRequest'
-            examples:
-              default_example:
-                $ref: '#/components/examples/UpdateSpecialEventRequestExample'
-      responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/SpecialEventResponse'
-              examples:
-                default_example:
-                  $ref: '#/components/examples/UpdateSpecialEventResponseExample'
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-    delete:
-      summary: Delete special event
-      description: Delete a special event from the collection. Allows museum to cancel planned events.
-      operationId: deleteSpecialEvent
-      tags:
-        - Events
-      parameters:
-        - $ref: '#/components/parameters/EventId'
-      responses:
-        '204':
-          description: Success - no content
-        '400':
-          description: Bad request
-        '401':
-          description: Unauthorized
-        '404':
-          description: Not found
-  /tickets:
-    post:
-      summary: Buy museum tickets
-      description: Purchase museum tickets for general entry or special events.
-      operationId: buyMuseumTickets
-      tags:
-        - Tickets
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: '#/components/schemas/BuyMuseumTicketsRequest'
-            examples:
-              general_entry:
-                $ref: '#/components/examples/BuyGeneralTicketsRequestExample'
-              event_entry:
-                $ref: '#/components/examples/BuyEventTicketsRequestExample'
-      responses:
-        '200':
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/BuyMuseumTicketsResponse'
-              examples:
-                general_entry:
-                  $ref: '#/components/examples/BuyGeneralTicketsResponseExample'
-                event_entry:
-                  $ref: '#/components/examples/BuyEventTicketsResponseExample'
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-  /tickets/{ticketId}/qr:
-    get:
-      summary: Get ticket QR code
-      description: Return an image of your ticket with scannable QR code. Used for event entry.
-      operationId: getTicketCode
-      tags:
-        - Tickets
-      parameters:
-        - $ref: '#/components/parameters/TicketId'
-      responses:
-        '200':
-          description: Scannable event ticket in image format
-          content:
-            image/png:
-              schema:
-                $ref: '#/components/schemas/GetTicketCodeResponse'
-        '400':
-          description: Bad request
-        '404':
-          description: Not found
-components:
-  schemas:
-    SpecialEvent:
-      description: Request payload for creating new special events at the museum.
-      properties:
-        name:
-          description: Name of the special event
-          type: string
-          example: Fossil lecture
-        location:
-          description: Location where the special event is held
-          type: string
-          example: Lecture theatre
-        eventDescription:
-          description: Description of the special event
-          type: string
-          example: Our panel of experts will share their favorite fossils and explain why they are so great.
-        dates:
-          description: List of planned dates for the special event
-          type: array
-          items:
-            type: string
-            format: date
-            example: 2024-03-29
-        price:
-          description: Price of a ticket for the special event
-          type: number
-          format: float
-          example: 12.50
-
-    TicketType:
-      description: Type of ticket being purchased. Use `general` for regular museum entry and `event` for tickets to special events.
-      type: string
-      enum:
-        - event
-        - general
-      x-enumDescriptions:
-        event: Special event ticket
-        general: General museum entry ticket
-      example: event
-    Date:
-      type: string
-      format: date
-      example: 2023-10-29
-    Email:
-      description: Email address for ticket purchaser.
-      type: string
-      format: email
-      example: museum-lover@example.com
-    Phone:
-      description: Phone number for the ticket purchaser (optional).
-      type: string
-      example: +1(234)-567-8910
-    BuyMuseumTicketsRequest:
-      description: Request payload used for purchasing museum tickets.
-      type: object
-      properties:
-        ticketType:
-          $ref: '#/components/schemas/TicketType'
-        eventId:
-          description: Unique identifier for a special event. Required if purchasing tickets for the museum's special events.
-          $ref: '#/components/schemas/EventId'
-        ticketDate:
-          description: Date that the ticket is valid for.
-          $ref: '#/components/schemas/Date'
-        email:
-          $ref: '#/components/schemas/Email'
-        phone:
-          $ref: '#/components/schemas/Phone'
-      required:
-        - ticketType
-        - ticketDate
-        - email
-    TicketMessage:
-      description: Confirmation message after a ticket purchase.
-      type: string
-      example: Museum general entry ticket purchased
-    TicketId:
-      description: Unique identifier for museum ticket. Generated when purchased.
-      type: string
-      format: uuid
-      example: a54a57ca-36f8-421b-a6b4-2e8f26858a4c
-    TicketConfirmation:
-      description: Unique confirmation code used to verify ticket purchase.
-      type: string
-      example: ticket-event-a98c8f-7eb12
-    BuyMuseumTicketsResponse:
-      description: Details for a museum ticket after a successful purchase.
-      type: object
-      properties:
-        message:
-          $ref: '#/components/schemas/TicketMessage'
-        eventName:
-          $ref: '#/components/schemas/EventName'
-        ticketId:
-          $ref: '#/components/schemas/TicketId'
-        ticketType:
-          $ref: '#/components/schemas/TicketType'
-        ticketDate:
-          description: Date the ticket is valid for.
-          $ref: '#/components/schemas/Date'
-        confirmationCode:
-          $ref: '#/components/schemas/TicketConfirmation'
-      required:
-        - message
-        - ticketId
-        - ticketType
-        - ticketDate
-        - confirmationCode
-    GetTicketCodeResponse:
-      description: An image of a ticket with a QR code used for museum or event entry.
-      type: string
-      format: binary
-    GetMuseumHoursResponse:
-      description: List of museum operating hours for consecutive days.
-      type: array
-      items:
-        $ref: '#/components/schemas/MuseumDailyHours'
-    MuseumDailyHours:
-      description: Daily operating hours for the museum.
-      type: object
-      properties:
-        date:
-          description: Date the operating hours apply to.
-          $ref: '#/components/schemas/Date'
-          example: 2024-12-31
-        timeOpen:
-          type: string
-          pattern: '^([01]\d|2[0-3]):?([0-5]\d)$'
-          description: Time the museum opens on a specific date. Uses 24 hour time format (`HH:mm`).
-          example: 09:00
-        timeClose:
-          description: Time the museum closes on a specific date. Uses 24 hour time format (`HH:mm`).
-          type: string
-          pattern: '^([01]\d|2[0-3]):?([0-5]\d)$'
-          example: 18:00
-      required:
-        - date
-        - timeOpen
-        - timeClose
-    EventId:
-      description: Identifier for a special event.
-      type: string
-      format: uuid
-      example: 3be6453c-03eb-4357-ae5a-984a0e574a54
-    EventName:
-      type: string
-      description: Name of the special event
-      example: Pirate Coding Workshop
-    EventLocation:
-      type: string
-      description: Location where the special event is held
-      example: Computer Room
-    EventDescription:
-      type: string
-      description: Description of the special event
-      example: Captain Blackbeard shares his love of the C...language. And possibly Arrrrr (R lang).
-    EventDates:
-      type: array
-      items:
-        $ref: '#/components/schemas/Date'
-      description: List of planned dates for the special event
-    EventPrice:
-      description: Price of a ticket for the special event
-      type: number
-      format: float
-      example: 25
-    CreateSpecialEventRequest:
-      description: Request payload for creating new special events at the museum.
-      properties:
-        name:
-          $ref: '#/components/schemas/EventName'
-        location:
-          $ref: '#/components/schemas/EventLocation'
-        eventDescription:
-          $ref: '#/components/schemas/EventDescription'
-        dates:
-          $ref: '#/components/schemas/EventDates'
-        price:
-          $ref: '#/components/schemas/EventPrice'
-      required:
-        - name
-        - location
-        - eventDescription
-        - dates
-        - price
-    UpdateSpecialEventRequest:
-      description: Request payload for updating an existing special event. Only included fields are updated in the event.
-      properties:
-        name:
-          $ref: '#/components/schemas/EventName'
-        location:
-          $ref: '#/components/schemas/EventLocation'
-        eventDescription:
-          $ref: '#/components/schemas/EventDescription'
-        dates:
-          $ref: '#/components/schemas/EventDates'
-        price:
-          $ref: '#/components/schemas/EventPrice'
-    ListSpecialEventsResponse:
-      description: A list of upcoming special events
-      type: array
-      items:
-        $ref: '#/components/schemas/SpecialEventResponse'
-    SpecialEventResponse:
-      description: Information about a special event.
-      properties:
-        eventId:
-          $ref: '#/components/schemas/EventId'
-        name:
-          $ref: '#/components/schemas/EventName'
-        location:
-          $ref: '#/components/schemas/EventLocation'
-        eventDescription:
-          $ref: '#/components/schemas/EventDescription'
-        dates:
-          $ref: '#/components/schemas/EventDates'
-        price:
-          $ref: '#/components/schemas/EventPrice'
-      required:
-        - eventId
-        - name
-        - location
-        - eventDescription
-        - dates
-        - price
-  securitySchemes:
-    MuseumPlaceholderAuth:
-      type: http
-      scheme: basic
-  examples:
-    BuyGeneralTicketsRequestExample:
-      summary: General entry ticket
-      value:
-        ticketType: general
-        ticketDate: 2023-09-07
-        email: todd@example.com
-    BuyEventTicketsRequestExample:
-      summary: Special event ticket
-      value:
-        ticketType: general
-        eventId: dad4bce8-f5cb-4078-a211-995864315e39
-        ticketDate: 2023-09-05
-        email: todd@example.com
-    BuyGeneralTicketsResponseExample:
-      summary: General entry ticket
-      value:
-        message: Museum general entry ticket purchased
-        ticketId: 382c0820-0530-4f4b-99af-13811ad0f17a
-        ticketType: general
-        ticketDate: 2023-09-07
-        confirmationCode: ticket-general-e5e5c6-dce78
-    BuyEventTicketsResponseExample:
-      summary: Special event ticket
-      value:
-        message: Museum special event ticket purchased
-        ticketId: b811f723-17b2-44f7-8952-24b03e43d8a9
-        eventName: Mermaid Treasure Identification and Analysis
-        ticketType: event
-        ticketDate: 2023-09-05
-        confirmationCode: ticket-event-9c55eg-8v82a
-    CreateSpecialEventRequestExample:
-      summary: Create special event
-      value:
-        name: Mermaid Treasure Identification and Analysis
-        location: Under the seaaa 🦀 🎶 🌊.
-        eventDescription: Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.
-        dates:
-          - 2023-09-05
-          - 2023-09-08
-        price: 0
-    CreateSpecialEventResponseExample:
-      summary: Special event created
-      value:
-        eventId: dad4bce8-f5cb-4078-a211-995864315e39
-        name: Mermaid Treasure Identification and Analysis
-        location: Under the seaaa 🦀 🎶 🌊.
-        eventDescription: Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.
-        dates:
-          - 2023-09-05
-          - 2023-09-08
-        price: 30
-    GetSpecialEventResponseExample:
-      summary: Get special event
-      value:
-        eventId: 6744a0da-4121-49cd-8479-f8cc20526495
-        name: Time Traveler Tea Party
-        location: Temporal Tearoom
-        eventDescription: Sip tea with important historical figures.
-        dates:
-          - 2023-11-18
-          - 2023-11-25
-          - 2023-12-02
-        price: 60
-    ListSpecialEventsResponseExample:
-      summary: List of special events
-      value:
-        - eventId: f3e0e76e-e4a8-466e-ab9c-ae36c15b8e97
-          name: Sasquatch Ballet
-          location: Seattle... probably
-          eventDescription: They're big, they're hairy, but they're also graceful. Come learn how the biggest feet can have the lightest touch.
-          dates:
-            - 2023-12-15
-            - 2023-12-22
-          price: 40
-        - eventId: 2f14374a-9c65-4ee5-94b7-fba66d893483
-          name: Solar Telescope Demonstration
-          location: Far from the sun.
-          eventDescription: Look at the sun without going blind!
-          dates:
-            - 2023-09-07
-            - 2023-09-14
-          price: 50
-        - eventId: 6aaa61ba-b2aa-4868-b803-603dbbf7bfdb
-          name: Cook like a Caveman
-          location: Fire Pit on East side
-          eventDescription: Learn to cook on an open flame.
-          dates:
-            - 2023-11-10
-            - 2023-11-17
-            - 2023-11-24
-          price: 5
-        - eventId: 602b75e1-5696-4ab8-8c7a-f9e13580f910
-          name: Underwater Basket Weaving
-          location: Rec Center Pool next door.
-          eventDescription: Learn to weave baskets underwater.
-          dates:
-            - 2023-09-12
-            - 2023-09-15
-          price: 15
-        - eventId: dad4bce8-f5cb-4078-a211-995864315e39
-          name: Mermaid Treasure Identification and Analysis
-          location: Room Sea-12
-          eventDescription: Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits — kindly donated by Ariel.
-          dates:
-            - 2023-09-05
-            - 2023-09-08
-          price: 30
-        - eventId: 6744a0da-4121-49cd-8479-f8cc20526495
-          name: Time Traveler Tea Party
-          location: Temporal Tearoom
-          eventDescription: Sip tea with important historical figures.
-          dates:
-            - 2023-11-18
-            - 2023-11-25
-            - 2023-12-02
-          price: 60
-        - eventId: 3be6453c-03eb-4357-ae5a-984a0e574a54
-          name: Pirate Coding Workshop
-          location: Computer Room
-          eventDescription: Captain Blackbeard shares his love of the C...language. And possibly Arrrrr (R lang).
-          dates:
-            - 2023-10-29
-            - 2023-10-30
-            - 2023-10-31
-          price: 45
-        - eventId: 9d90d29a-2af5-4206-97d9-9ea9ceadcb78
-          name: Llama Street Art Through the Ages
-          location: Auditorium
-          eventDescription: Llama street art?! Alpaca my bags -- let's go!
-          dates:
-            - 2023-10-29
-            - 2023-10-30
-            - 2023-10-31
-          price: 45
-        - eventId: a3c7b2c4-b5fb-4ef7-9322-00a919864957
-          name: The Great Parrot Debate
-          location: Outdoor Amphitheatre
-          eventDescription: See leading parrot minds discuss important geopolitical issues.
-          dates:
-            - 2023-11-03
-            - 2023-11-10
-          price: 35
-        - eventId: b92d46b7-4c5d-422b-87a5-287767e26f29
-          name: Eat a Bunch of Corn
-          location: Cafeteria
-          eventDescription: We accidentally bought too much corn. Please come eat it.
-          dates:
-            - 2023-11-10
-            - 2023-11-17
-            - 2023-11-24
-          price: 5
-    UpdateSpecialEventRequestExample:
-      summary: Update special event request
-      value:
-        location: On the beach.
-        price: 15
-    UpdateSpecialEventResponseExample:
-      summary: Update special event
-      value:
-        eventId: dad4bce8-f5cb-4078-a211-995864315e39
-        name: Mermaid Treasure Identification and Analysis
-        location: On the beach.
-        eventDescription: Join us as we review and classify a rare collection of 20 thingamabobs, gadgets, gizmos, whoosits, and whatsits, kindly donated by Ariel.
-        dates:
-          - 2023-09-05
-          - 2023-09-08
-        price: 15
-    GetMuseumHours:
-      summary: Museum opening hours
-      value:
-        - date: '2023-09-11'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-12'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-13'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-14'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-15'
-          timeOpen: '10:00'
-          timeClose: '16:00'
-        - date: '2023-09-18'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-19'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-20'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-21'
-          timeOpen: '09:00'
-          timeClose: '18:00'
-        - date: '2023-09-22'
-          timeOpen: '10:00'
-          timeClose: '16:00'
-    ClosedMuseumHours:
-      summary: The museum is closed
-      value: []
-  parameters:
-    PaginationPage:
-      name: page
-      in: query
-      description: The page number to retrieve.
-      schema:
-        type: integer
-        default: 1
-        example: 2
-    PaginationLimit:
-      name: limit
-      in: query
-      description: The number of days per page.
-      schema:
-        type: integer
-        default: 10
-        maximum: 30
-        example: 15
-    EventId:
-      name: eventId
-      in: path
-      description: An identifier for a special event.
-      required: true
-      schema:
-        type: string
-        format: uuid
-        example: dad4bce8-f5cb-4078-a211-995864315e39
-    StartDate:
-      name: startDate
-      in: query
-      description: The starting date to retrieve future operating hours from. Defaults to today's date.
-      schema:
-        type: string
-        format: date
-        example: 2023-02-23
-    EndDate:
-      name: endDate
-      in: query
-      description: The end of a date range to retrieve special events for. Defaults to 7 days after `startDate`.
-      schema:
-        type: string
-        format: date
-        example: 2023-04-18
-    TicketId:
-      name: ticketId
-      in: path
-      description: An identifier for a ticket to a museum event. Used to generate ticket image.
-      required: true
-      schema:
-        type: string
-        format: uuid
-        example: a54a57ca-36f8-421b-a6b4-2e8f26858a4c
-
-tags:
-  - name: Operations
-    x-displayName: About the museum
-    description: Operational information about the museum.
-  - name: Events
-    x-displayName: Upcoming events
-    description: Special events hosted by the Museum.
-  - name: Tickets
-    x-displayName: Buy tickets
-    description: Museum tickets for general entrance or special events.
-
-x-tagGroups:
-  - name: Plan your visit
-    tags:
-      - Operations
-      - Events
-  - name: Purchases
-    tags:
-      - Tickets
-  - name: Entities
-    tags:
-      - Schemas
-
-security:
-  - MuseumPlaceholderAuth: []

demo/openapi-3-1.yaml

@@ -16,14 +16,14 @@ info:
     [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
     It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
     tool and [ReDoc](https://github.com/Redocly/redoc) documentation. In addition to standard
-    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/main/docs/redoc-vendor-extensions.md).
+    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md).
 
     # OpenAPI Specification
     This API is documented in **OpenAPI format** and is based on
     [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
     It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
     tool and [ReDoc](https://github.com/Redocly/redoc) documentation. In addition to standard
-    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/main/docs/redoc-vendor-extensions.md).
+    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md).
 
     # Cross-Origin Resource Sharing
     This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with  [W3C spec](https://www.w3.org/TR/cors/).
@@ -88,14 +88,12 @@ x-tagGroups:
     tags:
       - pet_model
       - store_model
-security:
-  - {}
 paths:
   /pet:
     parameters:
       - name: Accept-Language
         in: header
-        description: 'The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US'
+        description: "The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US"
         example: en-US
         required: false
         schema:
@@ -184,16 +182,6 @@ paths:
             }
       requestBody:
         $ref: '#/components/requestBodies/Pet'
-    delete:
-      tags:
-        - pet
-      summary: OperationId with quotes
-      operationId: deletePetBy"Id
-    get:
-      tags:
-        - pet
-      summary: OperationId with backslash
-      operationId: delete\PetById
   '/pet/{petId}':
     get:
       tags:
@@ -271,7 +259,7 @@ paths:
           required: false
           schema:
             type: string
-          example: 'Bearer <TOKEN>'
+          example: "Bearer <TOKEN>"
         - name: petId
           in: path
           description: Pet id to delete
@@ -307,9 +295,6 @@ paths:
           content:
             application/json:
               schema:
-                unevaluatedProperties:
-                  type: integer
-                  format: int32
                 $ref: '#/components/schemas/ApiResponse'
       security:
         - petstore_auth:
@@ -447,7 +432,7 @@ paths:
             application/json:
               example:
                 status: 400
-                message: 'Invalid Order'
+                message: "Invalid Order"
       requestBody:
         content:
           application/json:
@@ -805,17 +790,11 @@ paths:
       parameters:
         - name: username
           in: path
-          description: name that need to be updated
+          description: name that need to be deleted
           required: true
           schema:
             type: string
       responses:
-        '200':
-          description: User is updated successfully
-          content:
-            application/json:
-              schema:
-                $ref: '#/components/schemas/User'
         '400':
           description: Invalid user supplied
         '404':
@@ -841,8 +820,6 @@ paths:
           schema:
             type: string
       responses:
-        '204':
-          description: User is deleted
         '400':
           description: Invalid username supplied
         '404':
@@ -917,11 +894,11 @@ paths:
                 type: string
               examples:
                 response:
-                  value: <Message> OK </Message>
+                  value:  <Message> OK </Message>
             text/plain:
               examples:
                 response:
-                  value: OK
+                  value:  OK
         '400':
           description: Invalid username/password supplied
   /user/logout:
@@ -948,7 +925,7 @@ components:
           content:
             multipart/form-data:
               schema:
-                $ref: '#/components/schemas/Cat'
+                $ref: "#/components/schemas/Cat"
         responses:
           '200':
             description: update Cat details
@@ -963,40 +940,13 @@ components:
           content:
             multipart/form-data:
               schema:
-                $ref: '#/components/schemas/Cat'
+                $ref: "#/components/schemas/Cat"
         responses:
           '200':
             description: create Cat details
   schemas:
     ApiResponse:
       type: object
-      patternProperties:
-        ^S_\\w+\\.[1-9]{2,4}$:
-          description: The measured skill for hunting
-          if:
-            x-displayName: fieldName === 'status'
-          else:
-            minLength: 1
-            maxLength: 10
-          then:
-            format: url
-            type: string
-            enum:
-              - success
-              - failed
-        ^O_\\w+\\.[1-9]{2,4}$:
-          type: object
-          properties:
-            nestedProperty:
-              type: [string, boolean]
-              description: The measured skill for hunting
-              default: lazy
-              example: adventurous
-              enum:
-                - clueless
-                - lazy
-                - adventurous
-                - aggressive
       properties:
         code:
           type: integer
@@ -1012,7 +962,7 @@ components:
         - type: object
           properties:
             huntingSkill:
-              type: [string, boolean]
+              type: string
               description: The measured skill for hunting
               default: lazy
               example: adventurous
@@ -1123,8 +1073,8 @@ components:
       properties:
         id:
           externalDocs:
-            description: 'Find more info here'
-            url: 'https://example.com'
+            description: "Find more info here"
+            url: "https://example.com"
           description: Pet ID
           $ref: '#/components/schemas/Id'
         category:
@@ -1136,27 +1086,15 @@ components:
           example: Guru
         photoUrls:
           description: The list of URL to a cute photos featuring pet
-          type: [string, integer, 'null']
+          type: [string, integer, 'null', array]
           minItems: 1
-          maxItems: 10
-          default: []
+          maxItems: 20
           xml:
             name: photoUrl
             wrapped: true
           items:
             type: string
             format: url
-          if:
-            x-displayName: isString
-            type: string
-          then:
-            minItems: 1
-            maxItems: 15
-          else:
-            x-displayName: notString
-            type: [integer, 'null']
-            minItems: 1
-            maxItems: 20
         friend:
           $ref: '#/components/schemas/Pet'
         tags:
@@ -1180,19 +1118,12 @@ components:
         petType:
           description: Type of a pet
           type: string
-        huntingSkill:
-          type: [integer]
-          enum:
-            - 0
-            - 1
-            - 2
       xml:
         name: Pet
     Tag:
       type: object
       properties:
         id:
-          type: number
           description: Tag ID
           $ref: '#/components/schemas/Id'
         name:
@@ -1254,35 +1185,6 @@ components:
           type: string
           contentEncoding: base64
           contentMediaType: image/png
-        addresses:
-          type: array
-          minItems: 0
-          maxLength: 10
-          prefixItems:
-            - type: object
-              properties:
-                city:
-                  type: string
-                  minLength: 0
-                country:
-                  type: string
-                  minLength: 0
-                street:
-                  description: includes build/apartment number
-                  type: string
-                  minLength: 0
-            - type: number
-          items:
-            type: string
-      if:
-        title: userStatus === 10
-        properties:
-          userStatus:
-            enum: [10]
-      then:
-        required: ['phone']
-      else:
-        required: []
       xml:
         name: User
   requestBodies:
@@ -1349,9 +1251,9 @@ webhooks:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/Pet'
+              $ref: "#/components/schemas/Pet"
       responses:
-        '200':
+        "200":
           description: Return a 200 status to indicate that the data was received successfully
   myWebhook:
     $ref: '#/components/pathItems/webhooks'

demo/openapi.yaml

@@ -16,14 +16,14 @@ info:
     [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
     It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
     tool and [ReDoc](https://github.com/Redocly/redoc) documentation. In addition to standard
-    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/main/docs/redoc-vendor-extensions.md).
+    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md).
 
     # OpenAPI Specification
     This API is documented in **OpenAPI format** and is based on
     [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
     It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
     tool and [ReDoc](https://github.com/Redocly/redoc) documentation. In addition to standard
-    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/main/docs/redoc-vendor-extensions.md).
+    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md).
 
     # Cross-Origin Resource Sharing
     This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with  [W3C spec](https://www.w3.org/TR/cors/).
@@ -38,7 +38,7 @@ info:
     OAuth2 - an open protocol to allow secure authorization in a simple
     and standard method from web, mobile and desktop applications.
 
-    <!-- ReDoc-Inject: <security-definitions> -->
+    <SecurityDefinitions />
 
   version: 1.0.0
   title: Swagger Petstore
@@ -83,14 +83,12 @@ x-tagGroups:
     tags:
       - pet_model
       - store_model
-security:
-  - {}
 paths:
   /pet:
     parameters:
       - name: Accept-Language
         in: header
-        description: 'The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US'
+        description: "The language you prefer for messages. Supported values are en-AU, en-CA, en-GB, en-US"
         example: en-US
         required: false
         schema:
@@ -106,10 +104,6 @@ paths:
     post:
       tags:
         - pet
-      x-badges:
-        - name: 'Beta'
-          position: before
-          color: purple
       summary: Add a new pet to the store
       description: Add new pet to the store inventory.
       operationId: addPet
@@ -154,9 +148,6 @@ paths:
     put:
       tags:
         - pet
-      x-badges:
-        - name: 'Alpha'
-          color: purple
       summary: Update an existing pet
       description: ''
       operationId: updatePet
@@ -190,8 +181,6 @@ paths:
     get:
       tags:
         - pet
-      x-badges:
-        - name: 'Gamma'
       summary: Find pet by ID
       description: Returns a single pet
       operationId: getPetById
@@ -265,7 +254,7 @@ paths:
           required: false
           schema:
             type: string
-          example: 'Bearer <TOKEN>'
+          example: "Bearer <TOKEN>"
         - name: petId
           in: path
           description: Pet id to delete
@@ -412,7 +401,6 @@ paths:
             application/json:
               schema:
                 type: object
-                minProperties: 2
                 additionalProperties:
                   type: integer
                   format: int32
@@ -441,7 +429,7 @@ paths:
             application/json:
               example:
                 status: 400
-                message: 'Invalid Order'
+                message: "Invalid Order"
       requestBody:
         content:
           application/json:
@@ -889,11 +877,11 @@ paths:
                 type: string
               examples:
                 response:
-                  value: <Message> OK </Message>
+                  value:  <Message> OK </Message>
             text/plain:
               examples:
                 response:
-                  value: OK
+                  value:  OK
         '400':
           description: Invalid username/password supplied
   /user/logout:
@@ -919,7 +907,6 @@ components:
         message:
           type: string
     Cat:
-      'x-tags': ['pet']
       description: A representation of a cat
       allOf:
         - $ref: '#/components/schemas/Pet'
@@ -1040,8 +1027,8 @@ components:
       properties:
         id:
           externalDocs:
-            description: 'Find more info here'
-            url: 'https://example.com'
+            description: "Find more info here"
+            url: "https://example.com"
           description: Pet ID
           allOf:
             - $ref: '#/components/schemas/Id'
@@ -1056,7 +1043,6 @@ components:
         photoUrls:
           description: The list of URL to a cute photos featuring pet
           type: array
-          default: []
           maxItems: 20
           xml:
             name: photoUrl
@@ -1083,10 +1069,6 @@ components:
             - available
             - pending
             - sold
-          x-enumDescriptions:
-            available: Available status
-            pending: Pending status
-            sold: Sold status
         petType:
           description: Type of a pet
           type: string
@@ -1152,26 +1134,6 @@ components:
           description: User status
           type: integer
           format: int32
-        addresses:
-          type: array
-          minItems: 0
-          maxLength: 10
-          items:
-            - type: object
-              properties:
-                city:
-                  type: string
-                  minLength: 0
-                country:
-                  type: string
-                  minLength: 0
-                street:
-                  description: includes build/apartment number
-                  type: string
-                  minLength: 0
-            - type: number
-          additionalItems:
-            type: string
       xml:
         name: User
   requestBodies:
@@ -1190,7 +1152,6 @@ components:
               name:
                 type: string
                 description: hooray
-                default: []
       description: Pet object that needs to be added to the store
       required: true
     UserArray:
@@ -1240,7 +1201,7 @@ x-webhooks:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/Pet'
+              $ref: "#/components/schemas/Pet"
       responses:
-        '200':
+        "200":
           description: Return a 200 status to indicate that the data was received successfully

demo/playground/hmr-playground.tsx

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import { createRoot } from 'react-dom/client';
+import { render } from 'react-dom';
 import type { RedocRawOptions } from '../../src/services/RedocNormalizedOptions';
-import { RedocStandalone } from '../../src';
+import RedocStandalone from './hot';
 
 const big = window.location.search.indexOf('big') > -1;
 const swagger = window.location.search.indexOf('swagger') > -1;
@@ -9,14 +9,8 @@ const swagger = window.location.search.indexOf('swagger') > -1;
 const userUrl = window.location.search.match(/url=(.*)$/);
 
 const specUrl =
-  (userUrl && userUrl[1]) || (swagger ? 'museum.yaml' : big ? 'big-openapi.json' : 'museum.yaml');
+  (userUrl && userUrl[1]) || (swagger ? 'swagger.yaml' : big ? 'big-openapi.json' : 'openapi.yaml');
 
-const options: RedocRawOptions = {
-  nativeScrollbars: false,
-  maxDisplayedEnumValues: 3,
-  schemaDefinitionsTagName: 'schemas',
-};
+const options: RedocRawOptions = { nativeScrollbars: false, maxDisplayedEnumValues: 3 };
 
-const container = document.getElementById('example');
-const root = createRoot(container!);
-root.render(<RedocStandalone specUrl={specUrl} options={options} />);
+render(<RedocStandalone specUrl={specUrl} options={options} />, document.getElementById('example'));

demo/playground/hot.tsx

@@ -0,0 +1,10 @@
+import * as React from 'react';
+// eslint-disable-next-line import/no-internal-modules
+import { hot } from 'react-hot-loader/root';
+import { RedocStandalone as RedocStandaloneOrig, RedocStandaloneProps } from '../../src';
+
+const RedocStandalone = function (props: RedocStandaloneProps) {
+  return <RedocStandaloneOrig {...props} />;
+}
+
+export default hot(RedocStandalone);

demo/playground/index.html

@@ -1,26 +1,25 @@
 <!DOCTYPE html>
 <html>
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>Redoc</title>
-    <style>
-      body {
-        margin: 0;
-        padding: 0;
-      }
 
-      redoc {
-        display: block;
-      }
-    </style>
-    <link
-      href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700"
-      rel="stylesheet"
-    />
-  </head>
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>ReDoc</title>
+  <style>
+    body {
+      margin: 0;
+      padding: 0;
+    }
 
-  <body>
-    <redoc id="example"></redoc>
-  </body>
-</html>
+    redoc {
+      display: block;
+    }
+  </style>
+  <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+</head>
+
+<body>
+  <redoc id="example"></redoc>
+</body>
+
+</html>

demo/swagger.yaml

@@ -15,13 +15,13 @@ info:
     [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
     It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
     tool and [ReDoc](https://github.com/Redocly/redoc) documentation. In addition to standard
-    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/main/docs/redoc-vendor-extensions.md).
+    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md).
     # OpenAPI Specification
     This API is documented in **OpenAPI format** and is based on
     [Petstore sample](http://petstore.swagger.io/) provided by [swagger.io](http://swagger.io) team.
     It was **extended** to illustrate features of [generator-openapi-repo](https://github.com/Rebilly/generator-openapi-repo)
     tool and [ReDoc](https://github.com/Redocly/redoc) documentation. In addition to standard
-    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/main/docs/redoc-vendor-extensions.md).
+    OpenAPI syntax we use a few [vendor extensions](https://github.com/Redocly/redoc/blob/master/docs/redoc-vendor-extensions.md).
     # Cross-Origin Resource Sharing
     This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with  [W3C spec](https://www.w3.org/TR/cors/).
     And that allows cross-domain communication from the browser.
@@ -780,7 +780,6 @@ definitions:
       photoUrls:
         description: The list of URL to a cute photos featuring pet
         type: array
-        default: []
         xml:
           name: photoUrl
           wrapped: true

demo/webpack.config.ts

@@ -3,7 +3,7 @@ import ForkTsCheckerWebpackPlugin = require('fork-ts-checker-webpack-plugin');
 import * as HtmlWebpackPlugin from 'html-webpack-plugin';
 import { resolve } from 'path';
 import * as webpack from 'webpack';
-import { webpackIgnore } from '../config/webpack-utils';
+import { getBabelLoader, webpackIgnore } from '../config/webpack-utils';
 
 const VERSION = JSON.stringify(require('../package.json').version);
 const REVISION = JSON.stringify(
@@ -14,7 +14,7 @@ function root(filename) {
   return resolve(__dirname + '/' + filename);
 }
 
-export default (env: { playground?: boolean; bench?: boolean } = {}) => ({
+export default (env: { playground?: boolean; bench?: boolean } = {}, { mode }) => ({
   entry: [
     root('../src/polyfills.ts'),
     root(
@@ -33,24 +33,28 @@ export default (env: { playground?: boolean; bench?: boolean } = {}) => ({
   },
 
   devServer: {
-    static: __dirname,
+    contentBase: __dirname,
+    watchContentBase: true,
     port: 9090,
+    disableHostCheck: true,
+    stats: 'minimal',
     hot: true,
-    historyApiFallback: true,
-    open: true,
-  },
-  stats: {
-    children: true,
   },
+
   resolve: {
     extensions: ['.ts', '.tsx', '.js', '.json'],
     fallback: {
       path: require.resolve('path-browserify'),
-      buffer: require.resolve('buffer'),
       http: false,
       fs: false,
       os: false,
     },
+    alias:
+      mode !== 'production'
+        ? {
+            'react-dom': '@hot-loader/react-dom',
+          }
+        : {},
   },
 
   performance: false,
@@ -67,26 +71,33 @@ export default (env: { playground?: boolean; bench?: boolean } = {}) => ({
     rules: [
       { test: [/\.eot$/, /\.gif$/, /\.woff$/, /\.svg$/, /\.ttf$/], use: 'null-loader' },
       {
-        test: /\.(tsx?|[cm]?js)$/,
-        loader: 'esbuild-loader',
-        options: {
-          target: 'es2015',
-          tsconfigRaw: require('../tsconfig.json'),
+        test: /\.tsx?$/,
+        use: [getBabelLoader({useBuiltIns: true, hot: true} )],
+        exclude: {
+          and: [/node_modules/],
+          not: {
+            or: [
+              /swagger2openapi/,
+              /reftools/,
+              /openapi-sampler/,
+              /mobx/,
+              /oas-resolver/,
+              /oas-kit-common/,
+              /oas-schema-walker/,
+              /\@redocly\/openapi-core/,
+              /colorette/,
+            ],
+          },
         },
-        exclude: [/node_modules/],
       },
       {
         test: /\.css$/,
-        use: [
-          'style-loader',
-          'css-loader',
-          {
-            loader: 'esbuild-loader',
-            options: {
-              minify: true,
-            },
+        use: {
+          loader: 'css-loader',
+          options: {
+            sourceMap: true,
           },
-        ],
+        },
       },
     ],
   },
@@ -107,15 +118,12 @@ export default (env: { playground?: boolean; bench?: boolean } = {}) => ({
         ? 'benchmark/index.html'
         : 'demo/index.html',
     }),
-    new webpack.ProvidePlugin({
-      Buffer: ['buffer', 'Buffer'],
-    }),
     new ForkTsCheckerWebpackPlugin({ logger: { infrastructure: 'silent', issues: 'console' } }),
     webpackIgnore(/js-yaml\/dumper\.js$/),
     webpackIgnore(/json-schema-ref-parser\/lib\/dereference\.js/),
     webpackIgnore(/^\.\/SearchWorker\.worker$/),
     new CopyWebpackPlugin({
-      patterns: ['demo/museum.yaml'],
+      patterns: ['demo/openapi.yaml'],
     }),
   ],
 });

docs/config.md

@@ -1,311 +0,0 @@
-# Configure Redoc
-
-Getting your documentation just right is important, and Redoc comes with many configuration options to help you succeed in that mission.
-
-Each deployment type has documentation on how to configure options for that type of Redoc project. This page lists all the options you can use with Redoc.
-
-**Versions: 2.x**
-
-{% admonition type="success" name="Client-side configuration" %}
-
-Using Redoc as a standalone (HTML or React) tool, these options must be presented in [kebab case](https://en.wikipedia.org/wiki/Letter_case#Kebab_case).
-For example, `scrollYOffset` becomes `scroll-y-offset`, and `expandResponses` becomes `expand-responses`.
-
-{% /admonition %}
-
-## Functional settings
-
-
-### disableSearch
-
-Disables search indexing and hides the search box from the API documentation page.
-
-### minCharacterLengthToInitSearch
-
-Sets the minimum amount of characters that need to be typed into the search dialog to initiate the search.
-
-_Default: 3_
-
-### hideDownloadButtons
-
-Hides the 'Download' button for saving the API definition source file. **This setting does not make the API definition private**; it just hides the button.
-
-### hideLoading
-
-Hides the loading animation. Does not apply to CLI or Workflows-rendered docs.
-
-### hideSchemaTitles
-
-Hides the schema title next to to the type.
-
-### jsonSamplesExpandLevel
-
-Sets the default expand level for JSON payload samples (response and request body). The default value is 2, and the maximum supported value is '+Infinity'. It can also be configured as a string with the special value `all` that expands all levels.
-
-_Default: 2_
-
-### maxDisplayedEnumValues
-
-Displays only the specified number of enum values. The remaining values are hidden in an expandable area. If not set, all values are displayed.
-
-### onlyRequiredInSamples
-
-Shows only required fields in request samples.
-
-### sortRequiredPropsFirst
-
-Shows required properties in schemas first, ordered in the same order as in the required array.
-
-### schemasExpansionLevel
-
-Specifies whether to automatically expand schemas in Reference docs. Set it to `all` to expand all schemas regardless of their level, or set it to a number to expand schemas up to the specified level. For example, `schemasExpansionLevel: 3` expands schemas up to three levels deep. The default value is `0`, meaning no schemas are expanded automatically.
-
-### scrollYOffset
-
-Specifies a vertical scroll-offset.
-This setting is useful when there are fixed positioned elements at the top of the page, such as navbars, headers, etc.
-
-Note that you can specify the `scrollYOffset` value in any of the following ways:
-- as a number - a fixed number of pixels to be used as the offset.
-- as a CSS selector - the selector of the element to be used for specifying the offset. The distance from the top of the page to the element's bottom is used as the offset.
-- a function (advanced) - a getter function. Must return a number representing the offset (in pixels).
-
-### showExtensions
-
-Shows specification extensions ('x-' fields). Extensions used by Redoc are ignored. The value can be boolean or an array of strings with names of extensions to display. When used as boolean and set to `true`, all specification extensions are shown.
-
-### sanitize
-
-If set to `true`, the API definition is considered untrusted and all HTML/Markdown is sanitized to prevent XSS.
-
-### downloadUrls
-
-Set the URLs used to download the OpenAPI description or other documentation related files from the API documentation page.
-
-### schemaDefinitionsTagName
-
-If a value is set, all of the schemas are rendered with the designated tag name. The schemas then render and display in the sidebar navigation (with that associated tag name).
-
-### generatedSamplesMaxDepth
-
-The generatedSamplesMaxDepth option controls how many schema levels automatically generated for payload samples. The default is 8 which works well for most APIs, but you can adjust it if necessary for your use case.
-
-### hidePropertiesPrefix
-
-In complex data structures or object schemas where properties are nested within parent objects the hidePropertiesPrefix option enables the hiding of parent names for nested properties within the documentation.
-
-_Default: true_
-
-## Deprecated Functional settings
-
-### hideDownloadButton
-
-Hides the 'Download' button for saving the API definition source file. **This setting does not make the API definition private**; it just hides the button.
-
-### downloadFileName
-
-Sets the filename for the downloaded API definition source file.
-
-### downloadDefinitionUrl
-
-Sets the URL for the downloaded API definition source file.
-
-### requiredPropsFirst
-
-Shows required properties in schemas first, ordered in the same order as in the required array.
-
-### jsonSampleExpandLevel
-
-Sets the default expand level for JSON payload samples (response and request body). The default value is 2, and the maximum supported value is '+Infinity'. It can also be configured as a string with the special value `all` that expands all levels.
-
-_Default: 2_
-
-### schemaExpansionLevel
-
-Specifies whether to automatically expand schemas in Reference docs. Set it to `all` to expand all schemas regardless of their level, or set it to a number to expand schemas up to the specified level. For example, `schemaExpansionLevel: 3` expands schemas up to three levels deep. The default value is `0`, meaning no schemas are expanded automatically.
-
-
-### expandDefaultServerVariables
-
-Enables or disables expanding default server variables.
-
-### expandResponses
-
-Controls which responses to expand by default. Specify one or more responses by providing their response codes as a comma-separated list without spaces, for example `expandResponses='200,201'`. Special value 'all' expands all responses by default. Be careful: this option can slow down documentation rendering time.
-
-### expandSingleSchemaField
-
-Automatically expands the single field in a schema.
-
-### hideHostname
-
-If set to `true`, the protocol and hostname are not shown in the operation definition.
-
-### hideRequestPayloadSample
-
-Hides request payload examples.
-
-### hideOneOfDescription
-
-If set to `true`, the description for `oneOf`/`anyOf` object is not shown in the schema.
-
-### hideSchemaPattern
-
-If set to `true`, the pattern is not shown in the schema.
-
-### hideSecuritySection
-
-Hides the Security panel section.
-
-### hideSingleRequestSampleTab
-
-Hides the request sample tab for requests with only one sample.
-
-### menuToggle
-
-If set to `true`, selecting an expanded item in the sidebar twice collapses it.
-
-_Default: true_
-
-### nativeScrollbars
-
-If set to `true`, the sidebar uses the native scrollbar instead of perfect-scroll. This setting is a scrolling performance optimization for big API definitions.
-
-### pathInMiddlePanel
-
-Shows the path link and HTTP verb in the middle panel instead of the right panel.
-
-### payloadSampleIdx
-
-If set, the payload sample is inserted at the specified index. If there are `N` payload samples and the value configured here is bigger than `N`, the payload sample is inserted last. Indexes start from 0.
-
-### showObjectSchemaExamples
-
-Shows object schema example in the properties; default `false`.
-
-### showWebhookVerb
-
-When set to `true`, shows the HTTP request method for webhooks in operations and in the sidebar.
-
-### simpleOneOfTypeLabel
-
-Shows only unique `oneOf` types in the label without titles.
-
-### sortEnumValuesAlphabetically
-
-When set to `true`, sorts all enum values in all schemas alphabetically.
-
-### sortOperationsAlphabetically
-
-When set to `true`, sorts operations in the navigation sidebar and in the middle panel alphabetically.
-
-### sortPropsAlphabetically
-
-When set to `true`, sorts properties in all schemas alphabetically.
-
-### sortTagsAlphabetically
-
-When set to true, sorts tags in the navigation sidebar and in the middle panel alphabetically. Note that only tags are sorted alphabetically in the middle panel, not the operations associated with each tag. To sort operations alphabetically as well, you must set the `sortOperationsAlphabetically` setting to `true`.
-
-_Default: false_
-
-### untrustedSpec
-
-If set to `true`, the API definition is considered untrusted and all HTML/Markdown is sanitized to prevent XSS.
-
-## Theme settings
-Change styles for the API documentation page. **Supported in Redoc CE 2.x**.
-* `spacing`
-  * `unit`: 5 # main spacing unit used in autocomputed theme values later
-  * `sectionHorizontal`: 40 # Horizontal section padding. COMPUTED: spacing.unit * 8
-  * `sectionVertical`: 40 # Horizontal section padding. COMPUTED: spacing.unit * 8
-* `breakpoints` # breakpoints for switching three/two and mobile view layouts
-  * `small`: '50rem'
-  * `medium`: '85rem'
-  * `large`: '105rem'
-* `colors`
-  * `tonalOffset`: 0.3 # default tonal offset used in computations
-* `typography`
-  * `fontSize`: '14px'
-  * `lineHeight`: '1.5em'
-  * `fontWeightRegular`: '400'
-  * `fontWeightBold`: '600'
-  * `fontWeightLight`: '300'
-  * `fontFamily`: 'Roboto, sans-serif'
-  * `smoothing`: 'antialiased'
-  * `optimizeSpeed`: true
-  * `headings`
-    * `fontFamily`: 'Montserrat, sans-serif'
-    * `fontWeight`: '400'
-    * `lineHeight`: '1.6em'
-  * `code` # inline code styling
-    * `fontSize`: '13px'
-    * `fontFamily`: 'Courier, monospace'
-    * `lineHeight`: # COMPUTED: typography.lineHeight
-    * `fontWeight`: # COMPUTED: typography.fontWeightRegular
-    * `color`: '#e53935'
-    * `backgroundColor`: 'rgba(38, 50, 56, 0.05)'
-    * `wrap`: false # whether to break word for inline blocks (otherwise they can overflow)
-  * `links`
-    * `color`: # COMPUTED: colors.primary.main
-    * `visited`: # COMPUTED: typography.links.color
-    * `hover`: # COMPUTED: lighten(0.2 typography.links.color)
-    * `textDecoration`: 'auto'
-    * `hoverTextDecoration`: 'auto'
-* `sidebar`
-  * `width`: '260px'
-  * `backgroundColor`: '#fafafa'
-  * `textColor`: '#333333'
-  * `activeTextColor`: # COMPUTED: theme.sidebar.textColor (if set by user) or theme.colors.primary.main
-  * `groupItems` # Group headings
-    * `activeBackgroundColor`: # COMPUTED: theme.sidebar.backgroundColor
-    * `activeTextColor`: # COMPUTED: theme.sidebar.activeTextColor
-    * `textTransform`: 'uppercase'
-  * `level1Items` # Level 1 items like tags or section 1st level items
-    * `activeBackgroundColor`: # COMPUTED: theme.sidebar.backgroundColor
-    * `activeTextColor`: # COMPUTED: theme.sidebar.activeTextColor
-    * `textTransform`: 'none'
-  * `arrow` # sidebar arrow
-    * `size`: '1.5em'
-    * `color`: # COMPUTED: theme.sidebar.textColor
-* `logo`
-  * `maxHeight`: # COMPUTED: sidebar.width
-  * `maxWidth`: # COMPUTED: sidebar.width
-  * `gutter`: '2px' # logo image padding
-* `rightPanel`
-  * `backgroundColor`: '#263238'
-  * `width`: '40%'
-  * `textColor`: '#ffffff'
-  * `servers`
-    * `overlay`
-      * `backgroundColor`: '#fafafa'
-      * `textColor`: '#263238'
-    * `url`
-      * `backgroundColor`: '#fff'
-* `fab`
-  * `backgroundColor`: '#263238'
-  * `color`: '#ffffff'
-
-## Additional customization
-
-### Security Definition location
-
-You can inject the Security Definitions widget into any place in your definition `description`.
-For more information, refer to [Security definitions injection](./security-definitions-injection.md).
-
-### OpenAPI specification extensions
-
-Redoc uses the following [specification extensions](https://redocly.com/docs-legacy/api-reference-docs/spec-extensions/):
-* [`x-logo`](./redoc-vendor-extensions.md#x-logo) - is used to specify API logo
-* [`x-traitTag`](./redoc-vendor-extensions.md#x-traittag) - useful for handling out common things like Pagination, Rate-Limits, etc
-* [`x-codeSamples`](./redoc-vendor-extensions.md#x-codesamples) - specify operation code samples
-* [`x-examples`](./redoc-vendor-extensions.md#x-examples) - specify JSON example for requests
-* [`x-nullable`](./redoc-vendor-extensions.md#x-nullable) - mark schema param as a nullable
-* [`x-displayName`](./redoc-vendor-extensions.md#x-displayname) - specify human-friendly names for the menu categories
-* [`x-tagGroups`](./redoc-vendor-extensions.md#x-taggroups) - group tags by categories in the side menu
-* [`x-servers`](./redoc-vendor-extensions.md#x-servers) - ability to specify different servers for API (backported from OpenAPI 3.0)
-* [`x-additionalPropertiesName`](./redoc-vendor-extensions.md#x-additionalpropertiesname) - ability to supply a descriptive name for the additional property keys
-* [`x-summary`](./redoc-vendor-extensions.md#x-summary) - For Response object, use as the response button text, with description rendered under the button
-* [`x-explicitMappingOnly`](./redoc-vendor-extensions.md#x-explicitmappingonly) - In Schemas, display a more descriptive property name in objects with additionalProperties when viewing the property list with an object
-
-

docs/deployment/cli.md

@@ -1,35 +1,114 @@
 ---
-seo:
-  title: Use the Redoc CLI
+title: Using the Redoc CLI
+redirectFrom: 
+  - /docs/quickstart/cli/
 ---
 
-# How to use the Redocly CLI
+# Using the Redoc CLI
 
-With Redocly CLI, you can bundle your OpenAPI definition and API documentation
-(made with Redoc) into an HTML file and render it locally.
+With Redoc's command-line interface you can bundle your OpenAPI definition and API documentation
+(made with Redoc) into a zero-dependency HTML file and locally render your
+OpenAPI definition with Redoc.
 
-## Step 1 - Install Redocly CLI
+## Step 1 - Install Redoc CLI
 
-First, you need to install the `@redocly/cli` package.
+You can install the `redoc-cli` package globally using one of the following package managers:
 
-You can install it [globally](../../cli/installation#install-globally) using npm.
+- [npm](https://docs.npmjs.com/about-npm)
+- [yarn](https://classic.yarnpkg.com/en/docs/getting-started)
 
-Or you can install it during [runtime](../../cli/installation#use-npx-at-runtime) using npx or Docker.
+Or you can install `redoc-cli` using [npx](https://www.freecodecamp.org/news/npm-vs-npx-whats-the-difference/).
 
-## Step 2 - Build the HTML file
+### Install Redoc CLI with yarn
 
-The Redocly CLI `build-docs` command builds Redoc into an HTML file.
-
-To build an HTML file using Redocly CLI, enter the following command,
-replacing `apis/openapi.yaml` with your API definition file's name and path:
+To install the `redoc-cli` package globally with yarn: 
 
 ```bash
-redocly build-docs apis/openapi.yaml
+yarn global add redoc-cli
 ```
 
-See the [build-docs](../../cli/commands/build-docs) documentation for more information
-on the different options and ways you can use the command.
+### Install Redoc with npm
 
-Also, check out [Redocly CLI commands](../../cli/commands), for more
-information on the different things you can do with Redocly CLI including
-linting, splitting, and bundling your API definition file.
+To install the `redoc-cli` package globally with npm: 
+
+```bash
+npm i -g redoc-cli
+```
+
+### Install with `npx`
+
+To install the `redoc-cli` package locally with `npx`, navigate to your project
+directory in your terminal, then use the following command:
+
+```bash
+npx redoc-cli
+```
+
+## Step 2 - Use the CLI
+
+### Redoc CLI commands
+
+The CLI includes the following commands:
+
+- **`redoc-cli serve [spec]`:** Starts a local server with Redoc. You must include the required parameter, spec, which is
+  a reference to an OpenAPI definition. Options include:
+    - `--ssr`: Implements a server-side rendering model. 
+    - `--watch`: Automatically reloads the server while you edit your OpenAPI definition.
+    - `--options`: Customizes your output using [Redoc options](https://redoc.ly/docs/api-reference-docs/configuration/).
+      To add nested options, use dot notation.
+- **`redoc-cli bundle [spec]`:** Bundles `spec` and Redoc into a zero-dependency HTML file. Options include:
+    - `-t` or `--template`: Uses custom [Handlebars](https://handlebarsjs.com/) templates to render your OpenAPI definition.
+    - `--templateOptions`: Adds template options you want to pass to your
+      custom Handlebars template. To add options, use dot notation.
+- **`--help`:** Prints help text for the Redoc CLI commands and options.
+- **`--version`:** Prints the version of the `redoc-cli` package you have installed.
+
+### Redoc CLI examples
+
+#### Bundle
+
+Bundle with the main color changed to `orange`:
+
+```bash
+redoc-cli bundle openapi.yaml --options.theme.colors.primary.main=orange
+```
+
+Bundle using a custom Handlebars template and add custom `templateOptions`:
+
+```bash
+redoc-cli bundle http://petstore.swagger.io/v2/swagger.json -t custom.hbs --templateOptions.metaDescription "Page meta description"
+```
+
+Sample Handlebars template:
+
+```handlebars
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf8" />
+        <title>{{title}}</title>
+        <!-- needed for adaptive design -->
+        <meta description="{{{templateOptions.metaDescription}}}">
+        <meta name="viewport" content="width=device-width, initial-scale=1">
+        <style>
+            body {
+            padding: 0;
+            margin: 0;
+            }
+        </style>
+        {{{redocHead}}}
+        {{#unless disableGoogleFont}}<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">{{/unless}}
+    </head>
+    <body>
+      {{{redocHTML}}}
+    </body>
+</html>
+```
+
+#### Serve
+
+Serve with the `nativeScrollbars` option set to `true`:
+
+```bash
+redoc-cli serve  openapi/dist.yaml --options.nativeScrollbars
+```

docs/deployment/docker.md

@@ -1,9 +1,10 @@
 ---
-seo:
-  title: Use the Redoc Docker image
+title: Using the Redoc Docker image
+redirectFrom:
+  - /docs/quickstart/docker/
 ---
 
-# How to use the Redoc Docker image
+# Using the Redoc Docker image
 
 Redoc is available as a pre-built Docker image in [Docker Hub](https://hub.docker.com/r/redocly/redoc/).
 
@@ -25,7 +26,7 @@ To exit the preview, use `control+C`.
 
 By default Redoc starts with a demo Swagger Petstore OpenAPI definition located at
 http://petstore.swagger.io/v2/swagger.json. You can update this URL using
-the environment variable `SPEC_URL`.
+the environment variable `SPEC_URL`. 
 
 For example:
 
@@ -33,8 +34,8 @@ For example:
 docker run -p 8080:80 -e SPEC_URL=https://api.example.com/openapi.json redocly/redoc
 ```
 
-## Create a Dockerfile
+## Using a Dockerfile
 
 You can also create a Dockerfile with some predefined environment variables. Check out
-a sample [Dockerfile](https://github.com/Redocly/redoc/blob/main/config/docker/Dockerfile)
-in our code repo.
+a sample [Dockerfile](https://github.com/Redocly/redoc/blob/master/config/docker/Dockerfile)
+in our code repo.

docs/deployment/html.md

@@ -1,140 +1,123 @@
 ---
-seo:
-  title: Use the Redoc HTML element
+title: Using the Redoc HTML element
+redirectFrom:
+  - /docs/quickstart/html/
 ---
 
-# Use Redoc in HTML
+# Using the Redoc HTML element
 
-To render API documentation in an HTML page, start with the template below and
-replace the `spec-url` value with the local file path or URL of your API
-description.
+## Step 1 - Install Redoc
 
-```html
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>Redoc</title>
-    <!-- needed for adaptive design -->
-    <meta charset="utf-8"/>
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+You can install Redoc using one of the following package managers:
 
-    <!--
-    Redoc doesn't change outer page styles
-    -->
-    <style>
-      body {
-        margin: 0;
-        padding: 0;
-      }
-    </style>
-  </head>
-  <body>
-    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
-    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
-  </body>
-</html>
+- [npm](https://docs.npmjs.com/about-npm)
+- [yarn](https://classic.yarnpkg.com/en/docs/getting-started)
+
+:::attention Initialize your package manager
+If you do not have a `package.json` file in your project directory,
+you need to add one by initializing npm or yarn in your project. Use the command `npm init` for npm,
+or `yarn init` for yarn. These initialization commands will lead you through the process
+of creating a `package.json` file in your project. 
+
+For more information, see 
+[Creating a package.json file](https://docs.npmjs.com/creating-a-package-json-file)
+in the npm documentation or [Yarn init](https://classic.yarnpkg.com/en/docs/cli/init/)
+in the yarn documentation.
+:::
+
+### Install Redoc with yarn
+
+After navigating to your project directory in your terminal, use the following command: 
+
+```bash
+yarn add redoc
 ```
 
-{% admonition type="success" name="URL or local file" %}
-Set `spec-url` to a relative path if the file is local, e.g. `spec-url=my-api.yaml`. Use a full URL like the example above if it's hosted elsewhere.
-{% /admonition %}
+### Install Redoc with npm
 
-Open the HTML file in your browser to see the HTML documentation rendering. You may want to read the next section and add some configuration to make your documentation your own.
+After navigating to your project directory in your terminal, use the following command: 
 
-## Configure Redoc
-
-Redoc is highly configurable, find a [full list of configuration options](../config.md) on the dedicated page.
-
-To configure Redoc in HTML, add the property names to the HTML tag. Here's an example that makes all the required properties display first in the list:
-
-```html
-    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json' required-props-first=true></redoc>
+```bash
+npm i redoc
 ```
 
-Any of the individual properties can be added to the tag, as many as you need to get your API docs set up as you like them.
-
-### Theme configuration
-
-The `theme` configuration setting is more complex since it represents many nested options, you can supply these as a JSON string to the `theme` attribute. For example, to change the sidebar color you would use a tag like this:
-
-```html
-    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'
-       required-props-first=true
-       theme='{
-         "sidebar": {
-           "backgroundColor": "lightblue"
-         }
-       }'
-    ></redoc>
-```
-
-Check out the [list of options for theme configuration](../config.md#theme-settings) and build up the configuration that suits your API needs.
-
-## Advanced options
-
-### The Redoc object
-
-As an alternative to the HTML tag, you can also initialise Redoc in a web page using the Redoc object and invoking it from JavaScript. This is useful for situations where you want to create dynamic content in a page, and also provides a simple way to attach the Redoc element to an existing container.
-
-The Redoc object offers an `init` function:
-
-```js
-Redoc.init(specOrSpecUrl, options, element, callback)
-```
-- `specOrSpecUrl`: Either a JSON object with the OpenAPI definition or a file name/URL to the
-  definition in JSON or YAML format.
-- `options`: See the [configuration reference](../config.md).
-- `element`: DOM element Redoc is inserted into.
-- `callback`(optional): Callback to be called after Redoc has been fully rendered.
-  It is also called on errors with `error` as the first argument.
-
-Call `Redoc.init()` from the JavaScript on a web page to add the element to the named container. Below is an example of an HTML page with a `<div>` tag, and the JavaScript to add the Redoc object to it.
-
-```html
-<!DOCTYPE html>
-<html>
-  <head />
-  <body>
-    <H1>Redoc in action</H1>
-    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
-    <div id="redoc-container"></div>
-
-    <script>
-      Redoc.init('http://petstore.swagger.io/v2/swagger.json', {
-        "expandResponses": "200,400"
-      }, document.getElementById('redoc-container'))
-    </script>
-  </body>
-</html>
-```
-
-This example also sets the configuration for `expandResponses` so all 200 and 400 status responses are shown unfolded and with their details visible when the page loads.
-
-### Self-host dependencies
+## Step 2 - Reference the Redoc script
 
 You can reference the Redoc script using either a link to the files hosted on a CDN
-or install to your `node-modules` folder. Using the CDN is the simplest option, but
-if you need to host in a closed environment or have requirements around external
-dependencies, it may be useful to self-host.
+or the files located in your `node modules` folder.
 
-The main example shows using the CDN:
+### CDN link
+
+To reference the Redoc script with a CDN link:
 
 ```html
-<script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
+<script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
 ```
 
-If you would instead prefer to host the depdencies yourself, first install `redoc` using `npm`:
+### Node modules link
 
-```sh
-npm install redoc
-```
-
-_(Yarn users can install the `redoc` package with `yarn`)_.
-
-You can then reference the Redoc script with a node modules link:
+To reference the Redoc script with a node modules link:
 
 ```html
 <script src="node_modules/redoc/bundles/redoc.standalone.js"> </script>
 ```
 
+## Step 3 - Add the <redoc> element
+
+You can add the <redoc> element to your HTML page and reference your OpenAPI
+definition using the `spec-url` attribute, or you can initialize Redoc using
+a globally exposed Redoc object.
+
+### Using the `spec-url` attribute
+
+To add the <redoc> element with the `spec-url` attribute:
+
+```html
+<redoc spec-url="url/to/your/spec"></redoc>
+```
+
+#### Examples
+
+```html
+<redoc spec-url="http://petstore.swagger.io/v2/swagger.json"></redoc>
+```
+
+You can also use a local file (JSON or YAML) in your project, for instance:
+
+```html
+<redoc spec-url="dist.json"></redoc>
+```
+
+### Using a Redoc object
+
+To add the <redoc> element with a globally exposed Redoc object:
+
+```js
+Redoc.init(specOrSpecUrl, options, element, callback)
+```
+- `specOrSpecUrl`: Either a JSON object with the OpenAPI definition or a URL to the
+  definition in JSON or YAML format.
+- `options`: See [options object](https://redoc.ly/docs/api-reference-docs/configuration/) reference.
+- `element`: DOM element Redoc will be inserted into.
+- `callback`(optional): Callback to be called after Redoc has been fully rendered.
+  It is also called on errors with `error` as the first argument.
+
+#### Examples
+
+```html
+<script>
+Redoc.init('http://petstore.swagger.io/v2/swagger.json', {
+  scrollYOffset: 50
+}, document.getElementById('redoc-container'))
+</script>
+```
+
+You can also use a local file (JSON or YAML) in your project, for instance:
+
+```html
+<script>
+Redoc.init('dist.yaml', {
+  scrollYOffset: 50
+}, document.getElementById('redoc-container'))
+</script>
+```

docs/deployment/intro.md

@@ -1,6 +1,7 @@
 ---
-seo:
-  title: Redoc deployment guide
+title: Redoc deployment guide
+redirectFrom:
+  - /docs/quickstart/intro/
 ---
 
 # Redoc deployment guide
@@ -11,7 +12,7 @@ You should select the option that best fits your needs.
 The following options are supported:
 
 - **[Live demo](https://redocly.github.io/redoc/):**
-  The live demo offers a fast way to see how your OpenAPI renders with Redoc.
+  The live demo offers a fast way to see how your OpenAPI will render with Redoc.
   A version of the Swagger Petstore API is displayed by default. To test it with your own OpenAPI definition, enter the URL for your
   definition and select **TRY IT**.
 - **[HTML element](./html.md):**
@@ -20,32 +21,60 @@ The following options are supported:
   Using the React component is an option for users with a React-based application.
 - **[Docker image](./docker.md):**
   Using the Docker image works in a container-based deployment.
-- **[Redocly CLI](./cli.md):**
-  Using the Redocly CLI is an option for users who prefer to use a command-line interface.
+- **[CLI](./cli.md):**
+  Using the CLI is an option for users who prefer to use a command-line interface.
 
 ## Before you start
 
 ### OpenAPI definition
 
-You need an OpenAPI definition. For testing purposes, you can use one of the following sample OpenAPI definitions:
+You will need an OpenAPI definition. For testing purposes, you can use one of the following sample OpenAPI definitions:
 
 - OpenAPI 3.0
-  - [Museum Example API](https://github.com/Redocly/museum-openapi-example/blob/main/openapi.yaml)
-  - [Petstore Sample OpenAPI Definition](https://petstore3.swagger.io/api/v3/openapi.json)
+  - [Rebilly Users OpenAPI Definition](https://raw.githubusercontent.com/Rebilly/api-definitions/main/openapi/users.yaml)
+  - [Swagger Petstore Sample OpenAPI Definition](https://petstore3.swagger.io/api/v3/openapi.json)
 - OpenAPI 2.0
   - [Thingful OpenAPI Definition](https://raw.githubusercontent.com/thingful/openapi-spec/master/spec/swagger.yaml)
   - [Fitbit Plus OpenAPI Definition](https://raw.githubusercontent.com/TwineHealth/TwineDeveloperDocs/master/spec/swagger.yaml)
 
-{% admonition type="info" name="OpenAPI specification" %}
-For more information on the OpenAPI specification, refer to the [Learning OpenAPI 3](https://redocly.com/docs/resources/learning-openapi/)
+:::info OpenAPI specification
+For more information on the OpenAPI specification, refer to the [Learning OpenAPI 3](https://redoc.ly/docs/resources/learning-openapi/)
 section in the documentation.
-{% /admonition %}
+:::
 
-### How to run Redoc locally
+### Running Redoc locally
 
 If you want to view your Redoc output locally, you can simulate an HTTP server.
 
-#### Python
+#### Using Redocly OpenAPI CLI
+
+Redocly OpenAPI CLI is an open source command-line tool that includes a command
+for simulating an HTTP server to provide a preview of your OpenAPI definition locally.
+
+If you have [OpenAPI CLI](https://redoc.ly/docs/cli/#installation-and-usage) installed, `cd` into your
+project directory and run the following command:
+
+```bash
+openapi preview-docs openapi.yaml
+```
+
+Replace `openapi.yaml` in the example command with the file path to your OpenAPI definition.
+
+By default, without providing a port, the preview starts on port 8080, and can be accessed at `http://localhost:8080`.
+To exit the preview, use `control+C`.
+
+You can alter the port if you are using 8080 already, for example:
+
+```bash
+openapi preview-docs -p 8888 openapi.yaml
+```
+
+Replace `openapi.yaml` in the example command with the file path to your OpenAPI definition.
+
+For more information about the `preview-docs` command, refer to
+[OpenAPI CLI commands](https://redoc.ly/docs/cli/commands/preview-docs/#preview-docs) in the OpenAPI CLI documentation.
+
+#### Using Python
 
 If you have [Python 3](https://www.python.org/downloads/) installed, `cd` into your
 project directory and run the following command:
@@ -64,7 +93,7 @@ python -m SimpleHTTPServer 8000
 The output after entering the command provides the local URL where the preview can be accessed.
 To exit the preview, use `control-C`.
 
-#### Node.js
+#### Using Node.js
 
 If you have [Node.js](https://nodejs.org/en/download/) installed, install `http-server`
 using the following npm command:

docs/deployment/react.md

@@ -1,12 +1,10 @@
 ---
-seo:
-  title: Use the Redoc React component
-redirects:
-  '/docs/redoc/quickstart/react/':
-    to: '/docs/redoc/deployment/react/'
+title: Using the Redoc React component
+redirectFrom:
+  - /docs/quickstart/react/
 ---
 
-# How to use the Redoc React component
+# Using the Redoc React component
 
 ## Before you start
 
@@ -46,7 +44,7 @@ Or you can pass your OpenAPI definition as an object, using the following format
 
 ## Optional - Pass options
 
-Options can be passed into the RedocStandalone component to alter how it renders.
+Options can be passed into the RedocStandalone component to alter how it renders. 
 
 For example:
 
@@ -60,8 +58,8 @@ For example:
 />
 ```
 
-For more information on configuration options, refer to the
-[Configuration options for Reference docs](https://redocly.com/docs/api-reference-docs/configuration/functionality/)
+For more information on configuration options, refer to the 
+[Configuration options for Reference docs](https://redoc.ly/docs/api-reference-docs/configuration/)
 section of the documentation. Options available for Redoc are noted,
 "Supported in Redoc CE".
 
@@ -73,7 +71,7 @@ is fully rendered or when an error occurs (with an error as the first argument).
 ```js
 <RedocStandalone
   specUrl="http://petstore.swagger.io/v2/swagger.json"
-  onLoaded={(error) => {
+  onLoaded={error => {
     if (!error) {
       console.log('Yay!');
     }

docs/index.md

@@ -1,97 +0,0 @@
----
-seo:
-  title: Redoc
----
-
-# Redoc: Open source API documentation tool
-
-Redoc is a clean and easy way to produce web-ready documentation from an OpenAPI description (Swagger is also still supported). With one command, create your documentation, and customize it to meet the needs of your users.
-
-Redoc is based around a three panel layout, with clear sections for navigation, detailed documentation, and request/response examples.
-
-## Headline features
-
-* Modern layout with extensive customization options.
-* Support for OpenAPI 3.1, 3.0 and older 2.0 and Swagger formats.
-* Embed or build standalone HTML documentation.
-* CLI tool for easy automation and local development.
-
-## Demo
-
-[Try the live demo](https://redocly.github.io/redoc/) and upload your own API specification there to try.
-
-## Usage
-
-Redoc is provided as a CLI tool (also distributed as a Docker image), HTML tag, and React component.
-
-### Generate documentation from the CLI
-
-If you have Node installed, quickly generate documentation using `npx`:
-
-```sh
-npx @redocly/cli build-docs openapi.yaml
-```
-
-The tool outputs by default to a file named `redoc-static.html` that you can open in your browser.
-
-> [Redocly CLI](https://github.com/Redocly/redocly-cli/) does more than docs, check it out and add linting, bundling and more to your API workflow.
-
-### Add an HTML element to the page
-
-Create an HTML page, or edit an existing one, and add the following:
-
-```html
-    <redoc spec-url="http://petstore.swagger.io/v2/swagger.json"></redoc>
-    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"> </script>
-```
-
-Open the HTML file in your browser, and your API documentation is shown on the page.
-
-Add your own `spec-url` to the `<redoc>` tag; this attribute can also be a local file. The JavaScript library can also be installed locally using `npm` and served from your own server, see the [HTML deployment documentation](https://redocly.com/docs/redoc/deployment/html/) for more details.
-
-### More usage options
-
-Check out the [deployment documentation](./deployment/intro.md) for more options, and detailed documentation for each.
-
-## Configure Redoc
-
-Redoc is highly configurable. Each deployment option accepts configuration in a way that's appropriate to that platform, but the options are the same for each. For example:
-
-* Using [Redocly CLI](../cli), configuration goes in the `redocly.yaml` file, or can be supplied as command line parameters, such as `--theme.openapi.disableSearch`.
-* Using HTML or React, configure by setting `option` in the tag.
-
-Here's a sample `redocly.yaml` configuration file, showing a few common settings and tweaking some of the visual theme settings:
-
-```yaml
-theme:
-  openapi:
-    disableSearch: true
-    expandResponses: 200,202
-    jsonSamplesExpandLevel: 1
-
-    theme:
-      sidebar:
-        backgroundColor: '#eae0cc'
-        textColor: '#3d005b'
-      colors:
-        primary:
-          main: '#660099'
-      typography:
-        fontSize: 14pt
-        headings:
-          fontWeight: bold
-```
-
-Redocly CLI detects a file named `redocly.yaml` in the same directory as you run the command and uses it. See the documentation with a command like this:
-
-```sh
-redocly build-docs openapi.yaml
-```
-
-There are many, many more options available. Visit the [configuration reference](./config.md) for a complete list.
-
-## Next steps
-
-* If you are new to OpenAPI, try the [OpenAPI starter project](../cli/openapi-starter) for a great introduction.
-* Ready to build documentation from an existing OpenAPI file? Go to the [Redoc quickstart](./quickstart.md) and get started.
-* Learn more about the project by visiting [Redoc on GitHub](https://github.com/Redocly/redoc).

docs/quickstart.md

@@ -1,6 +1,5 @@
 ---
-seo:
-  title: Redoc quickstart guide
+title: Redoc quickstart guide
 ---
 
 # Redoc quickstart guide
@@ -39,15 +38,16 @@ replace the `spec-url` attribute with the URL or local file address to your defi
     <!--
     Link to Redoc JavaScript on CDN for rendering standalone element
     -->
-    <script src="https://cdn.redoc.ly/redoc/latest/bundles/redoc.standalone.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"></script>
   </body>
 </html>
 ```
 
-{% admonition type="info" name="Redoc requires an HTTP server to run locally" %}
+:::attention Running Redoc locally requires an HTTP server
 Loading local OpenAPI definitions is impossible without running a web server because of issues with
 [same-origin policy](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy) and
-other security reasons. Refer to [Running Redoc locally](./deployment/intro.md#how-to-run-redoc-locally) for more information.
-{% /admonition %}
+other security reasons. Refer to [Running Redoc locally](./deployment/intro.md#running-redoc-locally) for
+more information.
+:::
 
 For a more detailed explanation with step-by-step instructions and additional options for using Redoc, refer to the [Redoc deployment guide](./deployment/intro.md).

docs/quickstart/cli.md

@@ -0,0 +1,112 @@
+---
+title: Using the Redoc CLI
+---
+
+# Using the Redoc CLI
+
+With Redoc's command-line interface you can bundle your OpenAPI definition and API documentation
+(made with Redoc) into a zero-dependency HTML file and locally render your
+OpenAPI definition with Redoc.
+
+## Step 1 - Install Redoc CLI
+
+You can install the `redoc-cli` package globally using one of the following package managers:
+
+- [npm](https://docs.npmjs.com/about-npm)
+- [yarn](https://classic.yarnpkg.com/en/docs/getting-started)
+
+Or you can install `redoc-cli` using [npx](https://www.freecodecamp.org/news/npm-vs-npx-whats-the-difference/).
+
+### Install Redoc CLI with yarn
+
+To install the `redoc-cli` package globally with yarn: 
+
+```bash
+yarn global add redoc-cli
+```
+
+### Install Redoc with npm
+
+To install the `redoc-cli` package globally with npm: 
+
+```bash
+npm i -g redoc-cli
+```
+
+### Install with `npx`
+
+To install the `redoc-cli` package locally with `npx`, navigate to your project
+directory in your terminal, then use the following command:
+
+```bash
+npx redoc-cli
+```
+
+## Step 2 - Use the CLI
+
+### Redoc CLI commands
+
+The CLI includes the following commands:
+
+- **`redoc-cli serve [spec]`:** Starts a local server with Redoc. You must include the required parameter, spec, which is
+  a reference to an OpenAPI definition. Options include:
+    - `--ssr`: Implements a server-side rendering model. 
+    - `--watch`: Automatically reloads the server while you edit your OpenAPI definition.
+    - `--options`: Customizes your output using [Redoc options](https://redoc.ly/docs/api-reference-docs/configuration/).
+      To add nested options, use dot notation.
+- **`redoc-cli bundle [spec]`:** Bundles `spec` and Redoc into a zero-dependency HTML file. Options include:
+    - `-t` or `--template`: Uses custom [Handlebars](https://handlebarsjs.com/) templates to render your OpenAPI definition.
+    - `--templateOptions`: Adds template options you want to pass to your
+      custom Handlebars template. To add options, use dot notation.
+- **`--help`:** Prints help text for the Redoc CLI commands and options.
+- **`--version`:** Prints the version of the `redoc-cli` package you have installed.
+
+### Redoc CLI examples
+
+#### Bundle
+
+Bundle with the main color changed to `orange`:
+
+```bash
+redoc-cli bundle openapi.yaml --options.theme.colors.primary.main=orange
+```
+
+Bundle using a custom Handlebars template and add custom `templateOptions`:
+
+```bash
+redoc-cli bundle http://petstore.swagger.io/v2/swagger.json -t custom.hbs --templateOptions.metaDescription "Page meta description"
+```
+
+Sample Handlebars template:
+
+```handlebars
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf8" />
+        <title>{{title}}</title>
+        <!-- needed for adaptive design -->
+        <meta description="{{{templateOptions.metaDescription}}}">
+        <meta name="viewport" content="width=device-width, initial-scale=1">
+        <style>
+            body {
+            padding: 0;
+            margin: 0;
+            }
+        </style>
+        {{{redocHead}}}
+        {{#unless disableGoogleFont}}<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">{{/unless}}
+    </head>
+    <body>
+      {{{redocHTML}}}
+    </body>
+</html>
+```
+
+#### Serve
+
+Serve with the `nativeScrollbars` option set to `true`:
+
+```bash
+redoc-cli serve  openapi/dist.yaml --options.nativeScrollbars
+```

docs/quickstart/docker.md

@@ -0,0 +1,39 @@
+---
+title: Using the Redoc Docker image
+---
+
+# Using the Redoc Docker image
+
+Redoc is available as a pre-built Docker image in [Docker Hub](https://hub.docker.com/r/redocly/redoc/).
+
+If you have [Docker](https://docs.docker.com/get-docker/) installed, pull the image with the following command:
+
+```docker
+docker pull redocly/redoc
+```
+
+Then run the image with the following command:
+
+```docker
+docker run -p 8080:80 redocly/redoc
+```
+
+The preview starts on port 8080, based on the port used in the command,
+and can be accessed at `http://localhost:8080`.
+To exit the preview, use `control+C`.
+
+By default Redoc starts with a demo Swagger Petstore OpenAPI definition located at
+http://petstore.swagger.io/v2/swagger.json. You can update this URL using
+the environment variable `SPEC_URL`. 
+
+For example:
+
+```bash
+docker run -p 8080:80 -e SPEC_URL=https://api.example.com/openapi.json redocly/redoc
+```
+
+## Using a Dockerfile
+
+You can also create a Dockerfile with some predefined environment variables. Check out
+a sample [Dockerfile](https://github.com/Redocly/redoc/blob/master/config/docker/Dockerfile)
+in our code repo.

docs/quickstart/html.md

@@ -0,0 +1,214 @@
+---
+title: Using the Redoc HTML element
+---
+
+# Using the Redoc HTML element
+
+## TL;DR final code example
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Redoc</title>
+    <!-- needed for adaptive design -->
+    <meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+
+    <!--
+    Redoc doesn't change outer page styles
+    -->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+      }
+    </style>
+  </head>
+  <body>
+    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
+  </body>
+</html>
+
+```
+
+:::attention Running Redoc locally requires an HTTP server
+Loading local OpenAPI definitions is impossible without running a web server because of issues with
+[same-origin policy](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy) and
+other security reasons. 
+:::
+
+### Running Redoc locally
+
+If you want to view your Redoc output locally, you can simulate an HTTP server.
+
+#### Using Redocly OpenAPI CLI
+
+Redocly OpenAPI CLI is an open source command-line tool that includes a command
+for simulating an HTTP server to provide a preview of your OpenAPI definition locally.
+
+If you have [OpenAPI CLI](https://redoc.ly/docs/cli/#installation-and-usage) installed, `cd` into your
+project directory and run the following command:
+
+```bash
+openapi preview-docs openapi.yaml
+```
+
+By default, without providing a port, the preview starts on port 8080, and can be accessed at `http://localhost:8080`.
+To exit the preview, use `control+C`.
+
+#### Using Python
+
+If you have [Python 3](https://www.python.org/downloads/) installed, `cd` into your
+project directory and run the following command:
+
+```python
+python3 -m http.server
+```
+
+If you have [Python 2](https://www.python.org/downloads/) installed, `cd` into your
+project directory and run the following command:
+
+```python
+python -m SimpleHTTPServer 8000
+```
+
+The output after entering the command provides the local URL where the preview can be accessed.
+To exit the preview, use `control-C`.
+
+#### Using Node.js
+
+If you have [Node.js](https://nodejs.org/en/download/) installed, install `http-server`
+using the following npm command:
+
+```bash
+npm install -g http-server
+```
+
+Then, `cd` into your project directory and run the following command:
+
+```node
+http-server
+```
+
+The output after entering the command provides the local URL where the preview can be accessed.
+To exit the preview, use `control-C`.
+
+## Step 1 - Install Redoc
+
+You can install Redoc using one of the following package managers:
+
+- [npm](https://docs.npmjs.com/about-npm)
+- [yarn](https://classic.yarnpkg.com/en/docs/getting-started)
+
+:::attention Initialize your package manager
+If you do not have a `package.json` file in your project directory,
+you need to add one by initializing npm or yarn in your project. Use the command `npm init` for npm,
+or `yarn init` for yarn. These initialization commands will lead you through the process
+of creating a `package.json` file in your project. 
+
+For more information, see 
+[Creating a package.json file](https://docs.npmjs.com/creating-a-package-json-file)
+in the npm documentation or [Yarn init](https://classic.yarnpkg.com/en/docs/cli/init/)
+in the yarn documentation.
+
+:::
+
+### Install Redoc with yarn
+
+After navigating to your project directory in your terminal, use the following command: 
+
+```bash
+yarn add redoc
+```
+
+### Install Redoc with npm
+
+After navigating to your project directory in your terminal, use the following command: 
+
+```bash
+npm i redoc
+```
+
+## Step 2 - Reference the Redoc script
+
+You can reference the Redoc script using either a link to the files hosted on a CDN
+or the files located in your `node modules` folder.
+
+### CDN link
+
+To reference the Redoc script with a CDN link:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
+```
+
+### Node modules link
+
+To reference the Redoc script with a node modules link:
+
+```html
+<script src="node_modules/redoc/bundles/redoc.standalone.js"> </script>
+```
+
+## Step 3 - Add the <redoc> element
+
+You can add the <redoc> element to your HTML page and reference your OpenAPI
+definition using the `spec-url` attribute, or you can initialize Redoc using
+a globally exposed Redoc object.
+
+### Using the `spec-url` attribute
+
+To add the <redoc> element with the `spec-url` attribute:
+
+```html
+<redoc spec-url="url/to/your/spec"></redoc>
+```
+
+#### Examples
+
+```html
+<redoc spec-url="http://petstore.swagger.io/v2/swagger.json"></redoc>
+```
+
+You can also use a local file (JSON or YAML) in your project, for instance:
+
+```html
+<redoc spec-url="dist.json"></redoc>
+```
+
+### Using a Redoc object
+
+To add the <redoc> element with a globally exposed Redoc object:
+
+```js
+Redoc.init(specOrSpecUrl, options, element, callback)
+```
+- `specOrSpecUrl`: Either a JSON object with the OpenAPI definition or a URL to the
+  definition in JSON or YAML format.
+- `options`: See [options object](https://redoc.ly/docs/api-reference-docs/configuration/) reference.
+- `element`: DOM element Redoc will be inserted into.
+- `callback`(optional): Callback to be called after Redoc has been fully rendered.
+  It is also called on errors with `error` as the first argument.
+
+#### Examples
+
+```html
+<script>
+Redoc.init('http://petstore.swagger.io/v2/swagger.json', {
+  scrollYOffset: 50
+}, document.getElementById('redoc-container'))
+</script>
+```
+
+You can also use a local file (JSON or YAML) in your project, for instance:
+
+```html
+<script>
+Redoc.init('dist.yaml', {
+  scrollYOffset: 50
+}, document.getElementById('redoc-container'))
+</script>
+```

docs/quickstart/intro.md

@@ -0,0 +1,44 @@
+---
+title: Redoc quickstart guide
+---
+
+# Redoc quickstart guide
+
+This guide includes step-by-step instructions for how to get started using
+Redoc to render your OpenAPI definition.
+
+Redoc offers multiple options for rendering your OpenAPI definition.
+You should select the option that best fits your needs.
+
+The following options are supported:
+
+- **[Live demo](https://redocly.github.io/redoc/):**
+  The live demo offers a fast way to see how your OpenAPI will render with Redoc.
+- **[HTML element](./html.md):**
+  Using the HTML element works well for typical website deployments.
+- **[React component](./react.md):**
+  Using the React component is an option for users with a React-based application.
+- **[Docker image](./docker.md):**
+  Using the Docker image works in a container-based deployment.
+- **[CLI](./cli.md):**
+  Using the CLI is an option for users who prefer to use a command-line interface.
+
+## Before you start
+
+You will need an OpenAPI definition. For testing purposes, you can use one of the following sample OpenAPI definitions: 
+- OpenAPI 3.0
+    - [Rebilly Users OpenAPI Definition](https://raw.githubusercontent.com/Rebilly/api-definitions/main/openapi/users.yaml)
+    - [Swagger Petstore Sample OpenAPI Definition](https://petstore3.swagger.io/api/v3/openapi.json)
+- OpenAPI 2.0
+    - [Thingful OpenAPI Definition](https://raw.githubusercontent.com/thingful/openapi-spec/master/spec/swagger.yaml)
+    - [Fitbit Plus OpenAPI Definition](https://raw.githubusercontent.com/TwineHealth/TwineDeveloperDocs/master/spec/swagger.yaml)
+
+For more information on the OpenAPI specification, refer to the [Learning OpenAPI 3](https://redoc.ly/docs/resources/learning-openapi/)
+section in the documentation.
+
+## Live demo online
+
+If you want to see how ReDoc will render your OpenAPI definition, you can try it out online at https://redocly.github.io/redoc/.
+
+A version of the Swagger Petstore API is displayed by default.  To test it with your own OpenAPI definition, enter the URL for your
+definition and select the **TRY IT** button.

docs/quickstart/react.md

@@ -0,0 +1,78 @@
+---
+title: Using the Redoc React component
+---
+
+# Using the Redoc React component
+
+## Before you start
+
+Install the following dependencies required by Redoc if you do not already have them installed:
+
+- `react`
+- `react-dom`
+- `mobx`
+- `styled-components`
+- `core-js`
+
+If you have npm installed, you can install these dependencies using the following command:
+
+```js
+npm i react react-dom mobx styled-components core-js
+```
+
+## Step 1 - Import the `RedocStandalone` component
+
+```js
+import { RedocStandalone } from 'redoc';
+```
+
+## Step 2 - Use the component
+
+You can either link to your OpenAPI definition with a URL, using the following format:
+
+```react
+<RedocStandalone specUrl="url/to/your/spec"/>
+```
+
+Or you can pass your OpenAPI definition as an object, using the following format:
+
+```js
+<RedocStandalone spec={/* spec as an object */}/>
+```
+
+## Optional - Pass options
+
+Options can be passed into the RedocStandalone component to alter how it renders. 
+
+For example:
+
+```js
+<RedocStandalone
+  specUrl="http://petstore.swagger.io/v2/swagger.json"
+  options={{
+    nativeScrollbars: true,
+    theme: { colors: { primary: { main: '#dd5522' } } },
+  }}
+/>
+```
+
+For more information on configuration options, refer to the 
+[Configuration options for Reference docs](https://redoc.ly/docs/api-reference-docs/configuration/)
+section of the documentation. Options available for Redoc are noted,
+"Supported in Redoc CE".
+
+## Optional - Specify `onLoaded` callback
+
+You can also specify the `onLoaded` callback, which is called each time Redoc
+is fully rendered or when an error occurs (with an error as the first argument).
+
+```js
+<RedocStandalone
+  specUrl="http://petstore.swagger.io/v2/swagger.json"
+  onLoaded={error => {
+    if (!error) {
+      console.log('Yay!');
+    }
+  }}
+/>
+```

docs/redoc-vendor-extensions.md

@@ -1,80 +1,56 @@
-# Redoc vendor extensions
+# ReDoc vendor extensions
 
-You can use the following [vendor extensions](https://redocly.com/docs/openapi-visual-reference/specification-extensions/) with Redoc.
+You can use the following [vendor extensions](https://swagger.io/specification/#specificationExtensions) with Redoc.
 
-- [Redoc vendor extensions](#redoc-vendor-extensions)
-  - [Swagger Object](#swagger-object)
-    - [x-servers](#x-servers)
-    - [x-tagGroups](#x-taggroups)
-      - [How to use with Redoc](#how-to-use-with-redoc)
-    - [Tag Group Object](#tag-group-object)
-      - [Fixed fields](#fixed-fields)
-      - [x-tagGroups example](#x-taggroups-example)
-  - [Info Object](#info-object)
-    - [x-logo](#x-logo)
-      - [How to use with Redoc](#how-to-use-with-redoc-1)
-    - [Logo Object](#logo-object)
-      - [Fixed fields](#fixed-fields-1)
-      - [x-logo example](#x-logo-example)
-  - [Tag Object](#tag-object)
-    - [x-traitTag](#x-traittag)
-      - [How to use with Redoc](#how-to-use-with-redoc-2)
-      - [x-traitTag example](#x-traittag-example)
-    - [x-displayName](#x-displayname)
-  - [Operation Object vendor extensions](#operation-object-vendor-extensions)
-    - [x-codeSamples](#x-codesamples)
-      - [How to use with Redoc](#how-to-use-with-redoc-3)
-    - [Code Sample Object](#code-sample-object)
-      - [Fixed fields](#fixed-fields-2)
-      - [Code Sample Object example](#code-sample-object-example)
-    - [x-badges](#x-badges)
-  - [Parameter Object](#parameter-object)
-    - [x-examples](#x-examples)
-      - [How to use with Redoc](#how-to-use-with-redoc-4)
-  - [Response Object vendor extensions](#response-object-vendor-extensions)
-    - [x-summary](#x-summary)
-      - [How to use with Redoc](#how-to-use-with-redoc-5)
-  - [Schema Object](#schema-object)
-    - [x-nullable](#x-nullable)
-      - [How to use with Redoc](#how-to-use-with-redoc-6)
-    - [x-additionalPropertiesName](#x-additionalpropertiesname)
-      - [How to use with Redoc](#how-to-use-with-redoc-7)
-      - [x-additionalPropertiesName example](#x-additionalpropertiesname-example)
-    - [x-explicitMappingOnly](#x-explicitmappingonly)
-      - [How to use with Redoc](#how-to-use-with-redoc-8)
-      - [x-explicitMappingOnly example](#x-explicitmappingonly-example)
-    - [x-enumDescriptions](#x-enumdescriptions)
-      - [How to use with Redoc](#how-to-use-with-redoc-9)
-      - [x-enumDescriptions example](#x-enumdescriptions-example)
+- [Swagger Object](#swagger-object)
+	- [x-servers](#x-servers)
+	- [x-tagGroups](#x-taggroups)
+	- [Tag Group Object](#a-nametaggroupobjectatag-group-object)
+	- [x-ignoredHeaderParameters](#x-ignoredheaderparameters)
+- [Info Object](#info-object)
+	- [x-logo](#x-logo)
+	- [Logo Object](#a-namelogoobjectalogo-object)
+- [Tag Object](#tag-object)
+	- [x-traitTag](#x-traittag)
+	- [x-displayName](#x-displayname)
+- [Operation Object](#operation-object-vendor-extensions)
+	- [x-codeSamples](#x-codesamples)
+	- [Code Sample Object](#a-namecodesampleobjectacode-sample-object)
+- [Parameter Object](#parameter-object)
+	- [x-examples](#x-examples)
+- [Response Object vendor extensions](#response-object-vendor-extensions)
+	- [x-summary](#x-summary)
+- [Schema Object](#schema-object)
+	- [x-nullable](#x-nullable)
+	- [x-extendedDiscriminator](#x-extendeddiscriminator)
+	- [x-additionalPropertiesName](#x-additionalpropertiesname)
+	- [x-explicitMappingOnly](#x-explicitmappingonly)
 
-## Swagger Object
-Extends the OpenAPI root [OpenAPI Object](https://redocly.com/docs/openapi-visual-reference/openapi)
+### Swagger Object
+Extends the OpenAPI root [OpenAPI Object](https://swagger.io/specification/#oasObject)
 
-### x-servers
-Backported from OpenAPI 3.0 [`servers`](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md#server-object). Currently doesn't support templates.
+#### x-servers
+Backported from OpenAPI 3.0 [`servers`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.0.md#serverObject). Currently doesn't support templates.
 
-### x-tagGroups
+#### x-tagGroups
 
-| Field Name     | Type        | Description |
+| Field Name     |	Type	       | Description |
 | :------------- | :-----------: | :---------- |
-| x-tagGroups         | [ [Tag Group Object](#tag-group-object) ] | A list of tag groups |
+| x-tagGroups         | [ [Tag Group Object](#tagGroupObject) ] | A list of tag groups |
 
-#### How to use with Redoc
+###### How to use with Redoc
 `x-tagGroups` is used to group tags in the side menu.
-Before you use `x-tagGroups`, make sure you **add all tags to a group**, since a tag that is not in a group, **is not displayed** at all!
+Before you use `x-tagGroups`, make sure you **add all tags to a group**, since a tag that is not in a group, **will not be displayed** at all!
 
-<a name="tagGroupObject"></a>
-
-#### Tag Group Object
+#### <a name="tagGroupObject"></a>Tag Group Object
 Information about tags group
-##### Fixed fields
-
-| Field Name  | Type      | Description |
+###### Fixed fields
+| Field Name  |	Type	     | Description |
 | :---------- | :--------: | :---------- |
 | name        | string     | The group name |
-| tags        | [ string ] | List of tags to include in this group |
+| tags        | [ string ] | List of tags to include in this group
 
-#### x-tagGroups example
+###### x-tagGroups example
 json
 ```json
 {
@@ -104,34 +80,53 @@ x-tagGroups:
       - Secondary Stats
 ```
 
-## Info Object
-Extends the OpenAPI [Info Object](https://redocly.com/docs/openapi-visual-reference/info/)
+#### x-ignoredHeaderParameters
 
-### x-logo
 
-| Field Name     | Type        | Description |
+| Field Name                  |	Type	        | Description |
+| :-------------------------- | :-----------: | :---------- |
+| x-ignoredHeaderParameters   | [ string ] | A list of ignored headers |
+
+
+###### How to use with Redoc
+Use `x-ignoredHeaderParameters` to specify header parameter names which are ignored by ReDoc.
+
+###### x-ignoredHeaderParameters example
+```yaml
+swagger: '2.0'
+info:
+  ...
+tags: [...]
+x-ignoredHeaderParameters:
+  - Accept
+  - User-Agent
+  - X-Test-Header
+```
+
+### Info Object
+Extends the OpenAPI [Info Object](http://swagger.io/specification/#infoObject)
+#### x-logo
+
+| Field Name     |	Type	       | Description |
 | :------------- | :-----------: | :---------- |
-| x-logo         | [Logo Object](#logo-object)  | The information about API logo |
+| x-logo         | [Logo Object](#logoObject)  | The information about API logo |
 
-#### How to use with Redoc
+###### How to use with Redoc
 `x-logo` is used to specify API logo. The corresponding image is displayed just above the side-menu.
 
-<a name="logoObject"></a>
-
-#### Logo Object
+#### <a name="logoObject"></a>Logo Object
 The information about API logo
 
-#### Fixed fields
-
-| Field Name      | Type    | Description |
+###### Fixed fields
+| Field Name      |	Type	   | Description |
 | :-------------- | :------: | :---------- |
-| url             | string   | The URL pointing to the spec logo. MUST be in the format of a URL. It SHOULD be an absolute URL so your API definition is usable from any location |
-| backgroundColor | string   | background color to be used. MUST be RGB color in [hexadecimal format] (https://en.wikipedia.org/wiki/Web_colors#Hex_triplet) |
-| altText        | string   | Text to use for alt tag on the logo. Defaults to 'logo' if nothing is provided. |
-| href        | string   | The URL pointing to the contact page. Default to 'info.contact.url' field of the OAS. |
+| url             | string   | The URL pointing to the spec logo. MUST be in the format of a URL. It SHOULD be an absolute URL so your API definition is usable from any location
+| backgroundColor | string   | background color to be used. MUST be RGB color in [hexadecimal format] (https://en.wikipedia.org/wiki/Web_colors#Hex_triplet)
+| altText        | string   | Text to use for alt tag on the logo. Defaults to 'logo' if nothing is provided.
+| href        | string   | The URL pointing to the contact page. Default to 'info.contact.url' field of the OAS.
 
 
-#### x-logo example
+###### x-logo example
 json
 ```json
 {
@@ -157,20 +152,19 @@ info:
     altText: "Petstore logo"
 ```
 
-## Tag Object
-Extends the OpenAPI [Tag Object](https://redocly.com/docs/openapi-visual-reference/tags/)
+### Tag Object
+Extends the OpenAPI [Tag Object](http://swagger.io/specification/#tagObject)
 
-### x-traitTag
-
-| Field Name     | Type   | Description |
+#### x-traitTag
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
 | x-traitTag     | boolean  | In Swagger two operations can have multiple tags. This property distinguishes between tags that are used to group operations (default) from tags that are used to mark operation with certain trait (`true` value) |
 
-#### How to use with Redoc
+###### How to use with Redoc
 Tags that have `x-traitTag` set to `true` are listed in the side-menu but don't have any subitems (operations). It also renders the `description` tag.
 This is useful for handling out common things like Pagination, Rate-Limits, etc.
 
-#### x-traitTag example
+###### x-traitTag example
 json
 ```json
 {
@@ -186,39 +180,35 @@ description: Pagination description (can use markdown syntax)
 x-traitTag: true
 ```
 
-### x-displayName
+#### x-displayName
 
-| Field Name     | Type   | Description |
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
 | x-displayName  | string   | Defines the text that is used for this tag in the menu and in section headings |
 
-## Operation Object vendor extensions
-Extends the OpenAPI [Operation Object](https://redocly.com/docs/openapi-visual-reference/operation/)
+### Operation Object vendor extensions
+Extends the OpenAPI [Operation Object](http://swagger.io/specification/#operationObject)
 
-### x-codeSamples
-
-| Field Name     | Type   | Description |
+#### x-codeSamples
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
-| x-codeSamples | [ [Code Sample Object](#code-sample-object) ]  | A list of code samples associated with operation |
+| x-codeSamples | [ [Code Sample Object](#codeSampleObject) ]  | A list of code samples associated with operation |
 
-#### How to use with Redoc
-`x-codeSamples` are rendered on the right panel in Redoc.
+###### How to use with ReDoc
+`x-codeSamples` are rendered on the right panel in ReDoc.
 
-<a name="codeSampleObject"></a>
-
-### Code Sample Object
+#### <a name="codeSampleObject"></a>Code Sample Object
 Operation code sample
 
-#### Fixed fields
-
-| Field Name  | Type    | Description  |
+###### Fixed fields
+| Field Name  |	Type	   | Description  |
 | :---------- | :------: | :----------- |
 | lang        | string   | Code sample language. Value should be one of the following [list](https://github.com/github/linguist/blob/master/lib/linguist/popular.yml) |
-| label       | string?   | Code sample label, for example `Node` or `Python2.7`, _optional_, `lang` is used by default |
+| label       | string?   | Code sample label e.g. `Node` or `Python2.7`, _optional_, `lang` will be used by default |
 | source      | string   | Code sample source code |
 
 
-#### Code Sample Object example
+###### Code Sample Object example
 json
 ```json
 {
@@ -232,61 +222,105 @@ lang: JavaScript
 source: console.log('Hello World');
 ```
 
-### x-badges
-
-| Field Name     | Type   | Description |
-| :------------- | :------: | :---------- |
-| x-badges | [[Badge Object](https://redocly.com/docs/realm/author/reference/openapi-extensions/x-badges#badge-object)] | A list of badges associated with the operation |
-
-## Parameter Object
-Extends the OpenAPI [Parameter Object](https://redocly.com/docs/openapi-visual-reference/parameter/)
-
-### x-examples
+### Parameter Object
+Extends the OpenAPI [Parameter Object](http://swagger.io/specification/#parameterObject)
 
+#### x-examples
 | Field Name     |  Type    | Description |
 | :------------- | :------: | :---------- |
-| x-examples | [Example Object](https://redocly.com/docs/openapi-visual-reference/example/)  | Object that contains examples for the request. Applies when `in` is `body` and mime-type is `application/json` |
+| x-examples | [Example Object](http://swagger.io/specification/#exampleObject)  | Object that contains examples for the request. Applies when `in` is `body` and mime-type is `application/json` |
 
-#### How to use with Redoc
-`x-examples` are rendered in the JSON tab on the right panel in Redoc.
+###### How to use with ReDoc
+`x-examples` are rendered in the JSON tab on the right panel in ReDoc.
 
-## Response Object vendor extensions
-Extends the OpenAPI [Response Object](https://redocly.com/docs/openapi-visual-reference/response/).
+### Response Object vendor extensions
+Extends the OpenAPI [Response Object](https://swagger.io/specification/#responseObject)
 
-### x-summary
-
-| Field Name     | Type   | Description |
+#### x-summary
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
 | x-summary      | string   | a short summary of the response |
 
-#### How to use with Redoc
+###### How to use with ReDoc
 If specified, you can use `x-summary` as the response button text, with description rendered under the button.
 
-## Schema Object
-Extends the OpenAPI [Schema Object](https://redocly.com/docs/openapi-visual-reference/schemas/)
+### Schema Object
+Extends the OpenAPI [Schema Object](http://swagger.io/specification/#schemaObject)
 
-### x-nullable
-
-| Field Name     | Type   | Description |
+#### x-nullable
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
 | x-nullable | boolean | marks schema as a nullable |
 
-#### How to use with Redoc
-Schemas marked as `x-nullable` are marked in Redoc with the label Nullable.
+###### How to use with ReDoc
+Schemas marked as `x-nullable` are marked in ReDoc with the label Nullable
 
-### x-additionalPropertiesName
-**Attention**: This is a Redoc-specific vendor extension, and is not supported by other tools.
+#### x-extendedDiscriminator
+**ATTENTION**: This is a ReDoc-specific vendor extension, and is not supported by other tools.
+
+| Field Name     |	Type	  | Description |
+| :------------- | :------: | :---------- |
+| x-extendedDiscriminator | string | specifies extended discriminator |
+
+###### How to use with ReDoc
+ReDoc uses this vendor extension to solve name-clash issues with the standard `discriminator`.
+Value of this field specifies the field which will be used as a extended discriminator.
+ReDoc displays definition with selectpicker using which user can select value of the `x-extendedDiscriminator`-marked field.
+ReDoc displays the definition derived from the current (using `allOf`) and has `enum` with only one value which is the same as the selected value of the field specified as `x-extendedDiscriminator`.
+
+###### x-extendedDiscriminator example
+
+```yaml
+
+Payment:
+  x-extendedDiscriminator: type
+  type: object
+  required:
+    - type
+  properties:
+    type:
+      type: string
+    name:
+      type: string
+
+CashPayment:
+  allOf:
+    - $ref: "#/definitions/Payment"
+    - properties:
+        type:
+          type: string
+          enum:
+            - cash
+        currency:
+          type: string
+
+PayPalPayment:
+  allOf:
+    - $ref: "#/definitions/Payment"
+    - properties:
+        type:
+          type: string
+          enum:
+            - paypal
+        userEmail:
+          type: string
+```
+
+In the example above, the names of definitions (`PayPalPayment`) are named differently than names in the payload (`paypal`) which is not supported by default `discriminator`.
+
+#### x-additionalPropertiesName
+**ATTENTION**: This is a ReDoc-specific vendor extension, and is not supported by other tools.
 
 Extends the `additionalProperties` property of the schema object.
 
-| Field Name     | Type   | Description |
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
 | x-additionalPropertiesName | string | descriptive name of additional properties keys  |
 
-#### How to use with Redoc
-Redoc uses this extension to display a more descriptive property name in objects with `additionalProperties` when viewing the property list with an `object`.
+###### How to use with ReDoc
+ReDoc uses this extension to display a more descriptive property name in objects with `additionalProperties` when viewing the property list with an `object`.
 
-#### x-additionalPropertiesName example
+###### x-additionalPropertiesName example
 
 ```yaml
 Player:
@@ -302,20 +336,20 @@ Player:
     type: string
 ```
 
-### x-explicitMappingOnly
-**Attention**: This is Redoc-specific vendor extension, and is not supported by other tools.
+#### x-explicitMappingOnly
+**ATTENTION**: This is ReDoc-specific vendor extension, and is not supported by other tools.
 
 Extends the `discriminator` property of the schema object.
 
-| Field Name     | Type   | Description |
+| Field Name     |	Type	  | Description |
 | :------------- | :------: | :---------- |
 | x-explicitMappingOnly | boolean | limit the discriminator selectpicker to the explicit mappings only |
 
-#### How to use with Redoc
-Redoc uses this extension to filter the `discriminator` mappings shown in the selectpicker.
-When set to `true`, the selectpicker lists only the explicitly defined mappings. When `false`, the default behavior is kept, in other words, explicit and implicit mappings are shown.
+###### How to use with ReDoc
+ReDoc uses this extension to filter the `discriminator` mappings shown in the selectpicker.
+When set to `true`, the selectpicker will only list the the explicitly defined mappings. When `false`, the default behavior is kept, i.e. explicit and implicit mappings will be shown.
 
-#### x-explicitMappingOnly example
+###### x-explicitMappingOnly example
 
 
 ```yaml
@@ -332,33 +366,4 @@ Pet:
       bee: "#/components/schemas/HoneyBee"
 ```
 
-Shows in the selectpicker only the items `cat` and `bee`, even though the `Dog` class inherits from the `Pet` class.
-
-### x-enumDescriptions
-
-| Field Name     | Type   | Description |
-| :------------- | :------: | :---------- |
-| x-enumDescriptions | [[Enum Description Object](https://redocly.com/docs/realm/author/reference/openapi-extensions/x-enum-descriptions#enum-description-object)] | A list of the enum values and descriptions to include in the documentation. |
-
-#### How to use with Redoc
-The enum (short for "enumeration") fields in OpenAPI allow you to restrict the value of a field to a list of allowed values. These values need to be short and machine-readable, but that can make them harder for humans to parse and work with.
-
-Add x-enumDescriptions to your OpenAPI description to show a helpful table of enum options and an explanation of what each one means. This field supports Markdown.
-
-#### x-enumDescriptions example
-The following example shows a schema with two short-named options, and the x-enumDescriptions entry to list all enum entries and give additional context for each:
-
-```yaml
-components:
-  schemas:
-    TicketType:
-      description: Type of ticket being purchased. Use `general` for regular museum entry and `event` for tickets to special events.
-      type: string
-      enum:
-        - event
-        - general
-      x-enumDescriptions:
-        event: Event Tickets _(timed entry)_
-        general: General Admission
-      example: event
-```
+Will show in the selectpicker only the items `cat` and `bee`, even though the `Dog` class inherits from the `Pet` class.

docs/security-definitions-injection.md

@@ -1,23 +1,19 @@
 # Injection security definitions
 
-You can inject the Security Definitions widget anywhere in your specification `description`:
+You can inject Security Definitions widget into any place of your specification `description`:
 
 ```markdown
 ...
-## Authorization
-
+# Authorization
 Some description
 
-<!-- Redoc-Inject: <security-definitions> -->
+<!-- ReDoc-Inject: <security-definitions> -->
 ...
 ```
-The inject instruction is wrapped in an HTML comment,
-so it is **visible only in Redoc** and not visible, for instance, in the SwaggerUI.
+Inject instruction is wrapped into HTML comment so it is **visible only in ReDoc**. It won't be visible e.g. in SwaggerUI.
 
-## Default behavior
+# Default behavior
+If injection tag is not found in the description it will be appended to the end
+of description under `Authentication` header.
 
-If the injection tag is not found in the description, it is appended to the end
-of description under the `Authentication` header.
-
-If the `Authentication` header is already present in the description,
-Security Definitions are not inserted or rendered.
+If `Authentication` header is already present in the description, Security Definitions won't be inserted and rendered at all.

docs/usage-with-ie11.md

@@ -0,0 +1,24 @@
+# Usage With IE11
+
+
+## Standalone package
+
+IE11 is supported by default if you use ReDoc as a standalone package.
+
+## Usage as a React component
+
+If you use ReDoc as a React component you should include the following polyfills in your project:
+
+```js
+import 'core-js/es6/promise';
+import 'core-js/fn/array/find';
+import 'core-js/fn/object/assign';
+import 'core-js/fn/string/ends-with';
+import 'core-js/fn/string/starts-with';
+
+import 'core-js/es6/map';
+import 'core-js/es6/symbol';
+
+import 'unfetch/polyfill/index'; // or any other fetch polyfill
+import 'url-polyfill';
+```

e2e/integration/menu.e2e.ts

@@ -1,129 +1,68 @@
 describe('Menu', () => {
-  describe('3.0 spec', () => {
-    beforeEach(() => {
-      cy.visit('e2e/standalone.html');
-    });
-    it('should have valid items count', () => {
-      cy.get('.menu-content').find('li').should('have.length', 35);
-    });
-
-    it('should sync active menu items while scroll', () => {
-      cy.contains('h2', 'Introduction')
-        .scrollIntoView()
-        .get('[role=menuitem] > label.active')
-        .should('have.text', 'Introduction');
-
-      cy.contains('h2', 'Add a new pet to the store')
-        .scrollIntoView()
-        .wait(100)
-        .get('[role=menuitem] > label.active')
-        .children()
-        .last()
-        .should('have.text', 'Add a new pet to the store')
-        .should('be.visible');
-    });
-
-    it('should sync active menu items while scroll back and scroll again', () => {
-      cy.contains('h2', 'Add a new pet to the store')
-        .scrollIntoView()
-        .wait(100)
-        .get('[role=menuitem] > label.active')
-        .children()
-        .last()
-        .should('have.text', 'Add a new pet to the store')
-        .should('be.visible');
-
-      cy.contains('h1', 'Swagger Petstore').scrollIntoView().wait(100);
-
-      cy.contains('h2', 'Introduction')
-        .scrollIntoView()
-        .wait(100)
-        .get('[role=menuitem] > label.active')
-        .should('have.text', 'Introduction');
-
-      cy.url().should('include', '#section/Introduction');
-    });
-
-    it('should update URL hash when clicking on menu items', () => {
-      cy.contains('[role=menuitem] > label.-depth1', 'pet').click({ force: true });
-      cy.get('li[data-item-id="schema/Cat"]')
-        .should('have.text', 'schemaCat')
-        .click({ force: true });
-      cy.location('hash').should('equal', '#schema/Cat');
-    });
-
-    it('should contains badge schema from x-badges', () => {
-      cy.contains('h2', 'Add a new pet to the store').scrollIntoView();
-
-      cy.contains('h2 > span', 'Beta')
-        .scrollIntoView()
-        .wait(100)
-        .get('[role=menuitem] > label.active')
-        .children('span[type="badge"]')
-        .should('have.text', 'Beta');
-
-      cy.contains('h2 > span', 'Alpha')
-        .scrollIntoView()
-        .wait(100)
-        .get('[role=menuitem] > label.active')
-        .children('span[type="badge"]')
-        .should('have.text', 'Alpha');
-
-      cy.contains('h2 > span', 'Gamma')
-        .scrollIntoView()
-        .wait(100)
-        .get('[role=menuitem] > label.active')
-        .children('span[type="badge"]')
-        .should('have.text', 'Gamma');
-    });
-
-    it('should contains Cat schema in Pet using x-tags', () => {
-      cy.contains('[role=menuitem] > label.-depth1', 'pet').click({ force: true });
-      cy.location('hash').should('equal', '#tag/pet');
-
-      cy.contains('[role=menuitem]', 'Find pet by ID').click({ force: true });
-      cy.location('hash').should('equal', '#tag/pet/operation/getPetById');
-    });
-
-    it('should deactivate tag when other is activated', () => {
-      const petItem = () => cy.contains('[role=menuitem] > label.-depth1', 'pet');
-
-      petItem().click({ force: true }).should('have.class', 'active');
-      cy.contains('[role=menuitem] > label.-depth1', 'store').click({ force: true });
-      petItem().should('not.have.class', 'active');
-    });
-
-    it('should be able to open a response object to see more details', () => {
-      cy.contains('h2', 'Find pet by ID')
-        .scrollIntoView()
-        .wait(100)
-        .parent()
-        .find('div h3')
-        .should('have.text', 'Responses')
-        .parent()
-        .find('div:first button')
-        .click()
-        .should('have.attr', 'aria-expanded', 'true')
-        .parent()
-        .find('div h5')
-        .then($h5 => $h5[0].firstChild!.nodeValue!.trim())
-        .should('eq', 'Response Schema:');
-    });
+  beforeEach(() => {
+    cy.visit('e2e/standalone.html');
   });
 
-  it('should be able to open the operation details when the operation IDs have quotes', () => {
-    cy.visit('e2e/standalone-3-1.html');
-    cy.get('label span[title="pet"]').click({ multiple: true, force: true });
-    cy.get('li').contains('OperationId with quotes').click({ multiple: true, force: true });
-    cy.get('h2').contains('OperationId with quotes').should('be.visible');
-    cy.url().should('include', 'deletePetBy%22Id');
+  it('should have valid items count', () => {
+    cy.get('.menu-content')
+      .find('li')
+      .should('have.length', 34);
   });
 
-  it('should encode URL when the operation IDs have backslashes', () => {
-    cy.visit('e2e/standalone-3-1.html');
-    cy.get('label span[title="pet"]').click({ multiple: true, force: true });
-    cy.get('li').contains('OperationId with backslash').click({ multiple: true, force: true });
-    cy.get('h2').contains('OperationId with backslash').should('be.visible');
-    cy.url().should('include', 'delete%5CPetById');
+  it('should sync active menu items while scroll', () => {
+    cy.contains('h1', 'Introduction')
+      .scrollIntoView()
+      .get('[role=menuitem].active')
+      .should('have.text', 'Introduction');
+
+    cy.contains('h2', 'Add a new pet to the store')
+      .scrollIntoView()
+      .wait(100)
+      .get('[role=menuitem].active')
+      .children()
+      .last()
+      .should('have.text', 'Add a new pet to the store')
+      .should('be.visible');
+  });
+
+  it('should sync active menu items while scroll back and scroll again', () => {
+    cy.contains('h2', 'Add a new pet to the store')
+      .scrollIntoView()
+      .wait(100)
+      .get('[role=menuitem].active')
+      .children()
+      .last()
+      .should('have.text', 'Add a new pet to the store')
+      .should('be.visible');
+
+    cy.contains('h1', 'Swagger Petstore')
+      .scrollIntoView()
+      .wait(100)
+
+    cy.contains('h1', 'Introduction')
+      .scrollIntoView()
+      .wait(100)
+      .get('[role=menuitem].active')
+      .should('have.text', 'Introduction');
+
+    cy.url().should('include', '#section/Introduction');
+  });
+
+  it('should update URL hash when clicking on menu items', () => {
+    cy.contains('[role=menuitem].-depth1', 'pet').click({ force: true });
+    cy.location('hash').should('equal', '#tag/pet');
+
+    cy.contains('[role=menuitem]', 'Find pet by ID').click({ force: true });
+    cy.location('hash').should('equal', '#operation/getPetById');
+  });
+
+  it('should deactivate tag when other is activated', () => {
+    const petItem = () => cy.contains('[role=menuitem].-depth1', 'pet');
+
+    petItem()
+      .click({ force: true })
+      .should('have.class', 'active');
+    cy.contains('[role=menuitem].-depth1', 'store').click({ force: true });
+    petItem().should('not.have.class', 'active');
   });
 });

e2e/integration/misc.e2e.ts

@@ -21,12 +21,12 @@ describe('Servers', () => {
       initReDoc(win, spec, {});
 
       // TODO add cy-data attributes
-      cy.get('[data-section-id="tag/pet/operation/addPet"]').should(
+      cy.get('[data-section-id="operation/addPet"]').should(
         'contain',
         'http://petstore.swagger.io/v2/pet',
       );
 
-      cy.get('[data-section-id="tag/pet/operation/addPet"]').should(
+      cy.get('[data-section-id="operation/addPet"]').should(
         'contain',
         'http://petstore.swagger.io/sandbox/pet',
       );
@@ -40,7 +40,7 @@ describe('Servers', () => {
       initReDoc(win, spec, {});
 
       // TODO add cy-data attributes
-      cy.get('[data-section-id="tag/pet/operation/addPet"]').should(
+      cy.get('[data-section-id="operation/addPet"]').should(
         'contain',
         'http://localhost:' + win.location.port + '/pet',
       );
@@ -55,7 +55,7 @@ describe('Servers', () => {
       initReDoc(win, spec, {});
 
       // TODO add cy-data attributes
-      cy.get('[data-section-id="tag/pet/operation/addPet"]').should(
+      cy.get('[data-section-id="operation/addPet"]').should(
         'contain',
         'http://localhost:' + win.location.port + '/pet',
       );

e2e/integration/search.e2e.ts

@@ -1,7 +1,7 @@
 describe('Search', () => {
   const getSearchInput = () => cy.get('[role="search"] input');
   const getSearchResults = () => cy.get('[data-role="search:results"]');
-  const getResult = i => cy.get('[role=search] label').eq(i);
+  const getResult = i => cy.get('[role=search] [role=menuitem]').eq(i);
 
   beforeEach(() => {
     cy.visit('e2e/standalone.html');
@@ -45,7 +45,7 @@ describe('Search', () => {
 
     getSearchInput().type('{enter}', { force: true });
 
-    cy.contains('[role=menu] label', 'Introduction').should('have.class', 'active');
+    cy.contains('[role=navigation] [role=menuitem]', 'Introduction').should('have.class', 'active');
   });
 
   it('should mark search results', () => {
@@ -56,23 +56,7 @@ describe('Search', () => {
 
   it('should show proper message when no search results are found', () => {
     getSearchResults().should('not.exist');
-    getSearchInput().type('xzss', { force: true });
+    getSearchInput().type('xzss', {force: true});
     getSearchResults().should('exist').should('contain', 'No results found');
-  });
-
-  it('should allow search by path or keywords in path', () => {
-    getSearchInput().clear().type('uploadImage', { force: true });
-    cy.get('[role=search] [role=menuitem]')
-      .should('have.length', 1)
-      .first()
-      .should('contain', 'uploads an image');
-
-    getSearchInput()
-      .clear()
-      .type('/pet/{petId}/uploadImage', { force: true, parseSpecialCharSequences: false });
-    cy.get('[role=search] [role=menuitem]')
-      .should('have.length', 1)
-      .first()
-      .should('contain', 'uploads an image');
-  });
+  })
 });

e2e/integration/standalone.e2e.ts

@@ -1,7 +1,7 @@
 describe('Standalone bundle test', () => {
   function baseCheck(name: string, url: string) {
     describe(name, () => {
-      beforeEach(() => {
+      before(() => {
         cy.visit(url);
       });
 

e2e/integration/urls.e2e.ts

@@ -1,19 +0,0 @@
-describe('Supporting both operation/* and parent/*/operation* urls', () => {
-  beforeEach(() => {
-    cy.visit('e2e/standalone.html');
-  });
-
-  it('should supporting operation/* url', () => {
-    cy.url().then(loc => {
-      cy.visit(loc + '#operation/updatePet');
-      cy.get('li[data-item-id="tag/pet/operation/updatePet"]').should('be.visible');
-    });
-  });
-
-  it('should supporting parent/*/operation url', () => {
-    cy.url().then(loc => {
-      cy.visit(loc + '#tag/pet/operation/addPet');
-      cy.get('li[data-item-id="tag/pet/operation/addPet"]').should('be.visible');
-    });
-  });
-});

e2e/plugins/cy-ts-preprocessor.js

@@ -12,9 +12,9 @@ const webpackOptions = {
         exclude: [/node_modules/],
         use: [
           {
-            loader: 'esbuild-loader',
+            loader: 'ts-loader',
             options: {
-              tsconfigRaw: require('../tsconfig.json'),
+              configFile: 'e2e/tsconfig.json',
             },
           },
         ],

karma.conf.js

@@ -0,0 +1,58 @@
+module.exports = function(config) {
+  const testWebpackConfig = require('./build/webpack.test.js');
+  const travis = process.env.TRAVIS;
+
+  config.set({
+    frameworks: ['jasmine', 'sinon', 'should'],
+    preprocessors: {
+      './tests/spec-bundle.js': ['coverage', 'webpack', 'sourcemap'],
+    },
+
+    coverageReporter: {
+      type: 'in-memory',
+    },
+
+    remapCoverageReporter: {
+      'text-summary': null,
+      'text-lcov': './coverage/lcov.info',
+      html: './coverage/html',
+    },
+    webpack: testWebpackConfig,
+    webpackMiddleware: {
+      stats: 'errors-only',
+      state: true,
+    },
+    client: {
+      chai: {
+        truncateThreshold: 0,
+      },
+    },
+    files: [
+      { pattern: './tests/spec-bundle.js', watched: false },
+      { pattern: 'tests/schemas/**/*.json', included: false },
+      { pattern: 'tests/schemas/**/*.yml', included: false },
+      { pattern: 'lib/**/*.html', included: false },
+    ],
+
+    proxies: {
+      '/tests/schemas': '/base/tests/schemas',
+      '/lib/': '/base/lib/',
+      '/node_modules/': '/base/node_modules/',
+    },
+    colors: true,
+    singleRun: true,
+    reporters: travis
+      ? ['mocha', 'coverage', 'remap-coverage', 'coveralls']
+      : ['mocha', 'coverage', 'remap-coverage'],
+
+    browsers: ['ChromeHeadlessNoSandbox'],
+    customLaunchers: {
+      ChromeHeadlessNoSandbox: {
+        base: 'ChromeHeadless',
+        flags: ['--no-sandbox']
+      }
+    },
+
+    browserNoActivityTimeout: 60000,
+  });
+};

package.json

@@ -1,13 +1,14 @@
 {
   "name": "redoc",
-  "version": "2.5.0",
+  "version": "2.0.0-rc.58",
   "description": "ReDoc",
   "repository": {
     "type": "git",
     "url": "git://github.com/Redocly/redoc"
   },
   "browserslist": [
-    "defaults"
+    "defaults",
+    "ie 11"
   ],
   "engines": {
     "node": ">=6.9",
@@ -32,12 +33,11 @@
     "start": "webpack serve --mode=development --env playground --hot --config demo/webpack.config.ts",
     "start:prod": "webpack serve --env playground --mode=production --config demo/webpack.config.ts",
     "start:benchmark": "webpack serve --mode=production --env.bench --config demo/webpack.config.ts",
-    "test": "npm run unit && npm run license-check",
+    "test": "npm run lint && npm run unit && npm run license-check",
     "unit": "jest --coverage",
-    "test:update-snapshot": "jest --updateSnapshot",
     "e2e": "cypress run",
     "e2e-ci": "cypress run --record",
-    "bundlesize": "size-limit",
+    "bundlesize": "bundlesize",
     "ts-check": "tsc --noEmit --skipLibCheck",
     "cy:open": "cypress open",
     "bundle:clean": "rimraf bundles",
@@ -47,131 +47,140 @@
     "bundle": "npm run bundle:clean && npm run bundle:lib && npm run bundle:browser && npm run bundle:standalone",
     "declarations": "tsc --emitDeclarationOnly -p tsconfig.lib.json && cp -R src/types typings/",
     "stats": "webpack --env production --env standalone --json --profile --mode=production > stats.json",
-    "prettier": "prettier --write \"src/**/*.{ts,tsx}\"",
+    "prettier": "prettier --write \"cli/index.ts\" \"src/**/*.{ts,tsx}\"",
     "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s -r 1",
-    "lint": "eslint --fix 'src/**/*.{js,ts,tsx}' --cache",
+    "lint": "eslint 'src/**/*.{js,ts,tsx}'",
     "benchmark": "node ./benchmark/benchmark.js",
     "start:demo": "webpack serve --hot --config demo/webpack.config.ts --mode=development",
+    "compile:cli": "tsc custom.d.ts cli/index.ts --target es6 --module commonjs --types yargs",
     "build:demo": "webpack --mode=production --config demo/webpack.config.ts",
-    "publish-cdn": "scripts/publish-cdn.sh",
     "deploy:demo": "aws s3 sync demo/dist s3://production-redoc-demo --acl=public-read",
-    "license-check": "license-checker --production --onlyAllow 'MIT;ISC;Apache-2.0;BSD;BSD-2-Clause;BSD-3-Clause;CC-BY-4.0;CC0-1.0;Python-2.0 ' --summary",
+    "license-check": "license-checker --production --onlyAllow 'MIT;ISC;Apache-2.0;BSD;BSD-2-Clause;BSD-3-Clause' --summary",
     "docker:build": "docker build -f config/docker/Dockerfile -t redoc .",
     "prepare": "husky install",
     "pre-commit": "pretty-quick --staged && npm run lint"
   },
   "devDependencies": {
-    "@cfaester/enzyme-adapter-react-18": "^0.8.0",
-    "@cypress/webpack-preprocessor": "^5.17.1",
-    "@size-limit/file": "^11.1.4",
+    "@babel/core": "^7.14.3",
+    "@babel/plugin-proposal-class-properties": "^7.13.0",
+    "@babel/plugin-proposal-decorators": "^7.14.2",
+    "@babel/plugin-proposal-object-rest-spread": "^7.14.4",
+    "@babel/plugin-syntax-decorators": "^7.12.13",
+    "@babel/plugin-syntax-dynamic-import": "^7.8.3",
+    "@babel/plugin-syntax-jsx": "^7.10.4",
+    "@babel/plugin-syntax-typescript": "^7.10.4",
+    "@babel/plugin-transform-runtime": "^7.14.3",
+    "@babel/preset-env": "^7.14.4",
+    "@babel/preset-react": "^7.13.13",
+    "@babel/preset-typescript": "^7.13.0",
+    "@cypress/webpack-preprocessor": "^5.9.0",
+    "@hot-loader/react-dom": "^17.0.1",
     "@types/chai": "^4.2.18",
     "@types/dompurify": "^2.2.2",
     "@types/enzyme": "^3.10.5",
     "@types/enzyme-to-json": "^1.5.3",
-    "@types/jest": "^29.5.6",
+    "@types/jest": "^26.0.23",
     "@types/json-pointer": "^1.0.30",
+    "@types/lodash": "^4.14.170",
     "@types/lunr": "^2.3.3",
-    "@types/mark.js": "^8.11.5",
-    "@types/marked": "^4.0.3",
     "@types/node": "^15.6.1",
+    "@types/mark.js": "^8.11.5",
+    "@types/marked": "^1.1.0",
     "@types/prismjs": "^1.16.5",
     "@types/prop-types": "^15.7.3",
-    "@types/react": "^18.0.0",
-    "@types/react-dom": "^18.0.0",
+    "@types/react": "^17.0.8",
+    "@types/react-dom": "^17.0.5",
+    "@types/react-tabs": "^2.3.2",
     "@types/styled-components": "^5.1.1",
     "@types/tapable": "^2.2.2",
     "@types/webpack": "^5.28.0",
-    "@types/webpack-env": "^1.18.0",
+    "@types/webpack-env": "^1.16.0",
     "@types/yargs": "^17.0.0",
-    "@typescript-eslint/eslint-plugin": "^5.55.0",
-    "@typescript-eslint/parser": "^5.55.0",
+    "@typescript-eslint/eslint-plugin": "^4.26.0",
+    "@typescript-eslint/parser": "^4.26.0",
+    "@wojtekmaj/enzyme-adapter-react-17": "^0.6.1",
+    "babel-loader": "^8.2.2",
+    "babel-plugin-styled-components": "^1.12.0",
     "beautify-benchmark": "^0.2.4",
-    "conventional-changelog-cli": "^3.0.0",
+    "bundlesize": "^0.18.1",
+    "conventional-changelog-cli": "^2.0.34",
     "copy-webpack-plugin": "^9.0.0",
     "core-js": "^3.13.1",
+    "coveralls": "^3.1.0",
     "css-loader": "^5.2.6",
-    "cypress": "^13.8.1",
+    "cypress": "^7.4.0",
     "enzyme": "^3.11.0",
     "enzyme-to-json": "^3.6.2",
-    "esbuild-loader": "^4.3.0",
     "eslint": "^7.27.0",
     "eslint-plugin-import": "^2.23.4",
-    "eslint-plugin-react": "^7.34.2",
-    "eslint-plugin-react-hooks": "^4.6.2",
+    "eslint-plugin-react": "^7.24.0",
     "fork-ts-checker-webpack-plugin": "^6.2.10",
     "html-webpack-plugin": "^5.3.1",
     "husky": "^7.0.0",
-    "jest": "^29.7.0",
-    "jest-environment-jsdom": "^29.7.0",
+    "jest": "^27.0.3",
     "js-yaml": "^4.1.0",
     "license-checker": "^25.0.1",
-    "lodash.noop": "^3.0.1",
-    "mobx": "^6.10.2",
-    "outdent": "^0.8.0",
+    "lodash": "^4.17.21",
+    "mobx": "^6.3.2",
     "prettier": "^2.3.2",
     "pretty-quick": "^3.0.0",
     "raf": "^3.4.1",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
+    "react": "^17.0.2",
+    "react-dom": "^17.0.2",
+    "react-hot-loader": "^4.13.0",
     "rimraf": "^3.0.2",
     "shelljs": "^0.8.4",
-    "size-limit": "^11.1.4",
-    "style-loader": "^3.3.1",
+    "style-loader": "^2.0.0",
     "styled-components": "^5.3.0",
-    "ts-jest": "^29.1.1",
-    "ts-node": "^10.9.1",
-    "tslib": "^2.4.0",
-    "typescript": "^4.9.0",
+    "ts-jest": "^27.0.2",
+    "ts-loader": "^8.0.1",
+    "ts-node": "^10.0.0",
+    "typescript": "~4.1.0",
     "unfetch": "^4.2.0",
-    "url": "^0.11.1",
-    "webpack": "^5.94.0",
-    "webpack-cli": "^5.1.4",
-    "webpack-dev-server": "^5.2.1",
+    "url-polyfill": "^1.1.12",
+    "webpack": "^5.38.1",
+    "webpack-cli": "^4.7.2",
+    "webpack-dev-server": "^3.11.2",
     "webpack-node-externals": "^3.0.0",
     "workerize-loader": "github:redocly/workerize-loader#webpack-5-dist"
   },
   "peerDependencies": {
     "core-js": "^3.1.4",
     "mobx": "^6.0.4",
-    "react": "^16.8.4 || ^17.0.0 || ^18.0.0 || ^19.0.0",
-    "react-dom": "^16.8.4 || ^17.0.0 || ^18.0.0 || ^19.0.0",
-    "styled-components": "^4.1.1 || ^5.1.1 || ^6.0.5"
+    "react": "^16.8.4 || ^17.0.0",
+    "react-dom": "^16.8.4 || ^17.0.0",
+    "styled-components": "^4.1.1 || ^5.1.1"
   },
   "dependencies": {
-    "@redocly/openapi-core": "^1.4.0",
-    "classnames": "^2.3.2",
+    "@babel/runtime": "^7.14.0",
+    "@redocly/openapi-core": "^1.0.0-beta.54",
+    "@redocly/react-dropdown-aria": "^2.0.11",
+    "classnames": "^2.3.1",
     "decko": "^1.2.0",
-    "dompurify": "^3.2.4",
-    "eventemitter3": "^5.0.1",
-    "json-pointer": "^0.6.2",
+    "dompurify": "^2.2.8",
+    "eventemitter3": "^4.0.7",
+    "json-pointer": "^0.6.1",
     "lunr": "^2.3.9",
     "mark.js": "^8.11.1",
-    "marked": "^4.3.0",
-    "mobx-react": "^9.1.1",
-    "openapi-sampler": "^1.5.0",
+    "marked": "^0.7.0",
+    "memoize-one": "^5.2.1",
+    "mobx-react": "^7.2.0",
+    "openapi-sampler": "^1.0.1",
     "path-browserify": "^1.0.1",
-    "perfect-scrollbar": "^1.5.5",
-    "polished": "^4.2.2",
-    "prismjs": "^1.29.0",
-    "prop-types": "^15.8.1",
-    "react-tabs": "^6.0.2",
+    "perfect-scrollbar": "^1.5.1",
+    "polished": "^4.1.3",
+    "prismjs": "^1.24.1",
+    "prop-types": "^15.7.2",
+    "react-tabs": "^3.2.2",
     "slugify": "~1.4.7",
     "stickyfill": "^1.1.1",
-    "swagger2openapi": "^7.0.8",
+    "swagger2openapi": "^7.0.6",
     "url-template": "^2.0.8"
   },
-  "size-limit": [
+  "bundlesize": [
     {
       "path": "./bundles/redoc.standalone.js",
-      "limit": "350 kB"
-    },
-    {
-      "path": "./bundles/redoc.lib.js",
-      "limit": "100 kB"
-    },
-    {
-      "path": "./bundles/redoc.browser.lib.js",
-      "limit": "100 kB"
+      "maxSize": "350 kB"
     }
   ],
   "jest": {
@@ -191,15 +200,10 @@
     "coveragePathIgnorePatterns": [
       "\\.d\\.ts$",
       "/benchmark/",
-      "/node_modules/",
-      "src/services/__tests__/models/helpers.ts"
+      "/node_modules/"
     ],
     "modulePathIgnorePatterns": [
-      "/benchmark/",
-      "src/services/__tests__/models/helpers.ts"
-    ],
-    "snapshotSerializers": [
-      "enzyme-to-json/serializer"
+      "/benchmark/"
     ],
     "moduleNameMapper": {
       "\\.(css|less)$": "<rootDir>/src/empty.js"

scripts/invalidate-cache.sh

@@ -1,24 +0,0 @@
-#!/usr/bin/env bash
-
-set -e                                      # exit on error
-
-echo jsdelivr clearing cache
-curl -i -X POST https://purge.jsdelivr.net/ \
- -H 'cache-control: no-cache' \
- -H 'content-type: application/json' \
- -d '{
-      "path": [
-        "npm/redoc@latest/bundles/redoc.browser.lib.js",
-        "npm/redoc@latest/bundles/redoc.lib.js",
-        "npm/redoc@latest/bundles/redoc.standalone.js"
-      ]
-    }'
-
-echo
-echo start invalidate cloudfront
-
-aws cloudfront create-invalidation --distribution-id $DISTRIBUTION --paths "/redoc/*"
-
-echo Cache cleared successfully
-
-exit 0

scripts/publish-cdn.sh

@@ -1,40 +0,0 @@
-#!/usr/bin/env bash
-
-set -e   # exit on error
-
-# TODO: Update script!
-
-VERSION=$(node scripts/version.js)
-VERSION_TAG=v${VERSION:0:1}.x
-
-copy_to_s3 () {
-  aws s3 cp --exclude "*" --include "*.js" --content-type "application/javascript; charset=utf-8" bundles "s3://redocly-cdn/redoc/$1/bundles" --recursive
-  aws s3 cp --exclude "*" --include "*.map" --content-type "application/json" bundles "s3://redocly-cdn/redoc/$1/bundles" --recursive
-  aws s3 cp --exclude "*" --include "*.txt" bundles "s3://redocly-cdn/redoc/$1/bundles" --recursive
-  aws s3 cp CHANGELOG.md "s3://redocly-cdn/redoc/$1/CHANGELOG.md"
-  aws s3 cp LICENSE "s3://redocly-cdn/redoc/$1/LICENSE"
-  aws s3 cp package.json "s3://redocly-cdn/redoc/$1/package.json"
-  aws s3 cp README.md "s3://redocly-cdn/redoc/$1/README.md"
-}
-
-if aws s3 ls "redocly-cdn/redoc/v$VERSION/" "$@"; then
-  echo "Version $VERSION already exists"
-  exit 1
-else
-  echo Releasing $VERSION
-
-  echo Uploading to S3 $VERSION
-  copy_to_s3 "v$VERSION"
-
-  echo Uploading to S3 $VERSION_TAG
-  copy_to_s3 "$VERSION_TAG" $@
-
-  if [[ "$VERSION_TAG" == "v2.x" ]]; then
-    echo Uploading to S3 latest
-    copy_to_s3 latest $@
-  fi
-
-  echo
-  echo Deployed successfully
-  exit 0
-fi

scripts/version.js

@@ -1 +0,0 @@
-console.log(require('../package.json').version);

src/common-elements/CopyButtonWrapper.tsx

@@ -8,24 +8,36 @@ export interface CopyButtonWrapperProps {
   children: (props: { renderCopyButton: () => React.ReactNode }) => React.ReactNode;
 }
 
-export const CopyButtonWrapper = (
-  props: CopyButtonWrapperProps & { tooltipShown?: boolean },
-): JSX.Element => {
-  const [tooltipShown, setTooltipShown] = React.useState(false);
+export class CopyButtonWrapper extends React.PureComponent<
+  CopyButtonWrapperProps,
+  { tooltipShown: boolean }
+> {
+  constructor(props) {
+    super(props);
+    this.state = {
+      tooltipShown: false,
+    };
+  }
 
-  const copy = () => {
+  render() {
+    return this.props.children({ renderCopyButton: this.renderCopyButton });
+  }
+
+  copy = () => {
     const content =
-      typeof props.data === 'string' ? props.data : JSON.stringify(props.data, null, 2);
+      typeof this.props.data === 'string'
+        ? this.props.data
+        : JSON.stringify(this.props.data, null, 2);
     ClipboardService.copyCustom(content);
-    showTooltip();
+    this.showTooltip();
   };
 
-  const renderCopyButton = () => {
+  renderCopyButton = () => {
     return (
-      <button onClick={copy}>
+      <button onClick={this.copy}>
         <Tooltip
           title={ClipboardService.isSupported() ? 'Copied' : 'Not supported in your browser'}
-          open={tooltipShown}
+          open={this.state.tooltipShown}
         >
           Copy
         </Tooltip>
@@ -33,12 +45,15 @@ export const CopyButtonWrapper = (
     );
   };
 
-  const showTooltip = () => {
-    setTooltipShown(true);
+  showTooltip() {
+    this.setState({
+      tooltipShown: true,
+    });
 
     setTimeout(() => {
-      setTooltipShown(false);
+      this.setState({
+        tooltipShown: false,
+      });
     }, 1500);
-  };
-  return props.children({ renderCopyButton: renderCopyButton }) as JSX.Element;
-};
+  }
+}

src/common-elements/Dropdown/Dropdown.tsx

@@ -1,68 +0,0 @@
-import * as React from 'react';
-import styled from '../../styled-components';
-import { ArrowIconProps, DropdownProps, DropdownOption } from './types';
-
-const ArrowSvg = ({ className, style }: ArrowIconProps): JSX.Element => (
-  <svg
-    className={className}
-    style={style}
-    xmlns="http://www.w3.org/2000/svg"
-    width="16"
-    height="16"
-    viewBox="0 0 24 24"
-    fill="none"
-    stroke="currentColor"
-    strokeWidth="2"
-    strokeLinecap="round"
-    strokeLinejoin="round"
-  >
-    <polyline points="6 9 12 15 18 9" />
-  </svg>
-);
-
-const ArrowIcon = styled(ArrowSvg)`
-  position: absolute;
-  pointer-events: none;
-  z-index: 1;
-  top: 50%;
-  -webkit-transform: translateY(-50%);
-  -ms-transform: translateY(-50%);
-  transform: translateY(-50%);
-  right: 8px;
-  margin: auto;
-  text-align: center;
-  polyline {
-    color: ${props => props.variant === 'dark' && 'white'};
-  }
-`;
-
-const DropdownComponent = (props: DropdownProps): JSX.Element => {
-  const { options, onChange, placeholder, value = '', variant, className } = props;
-
-  const handleOnChange = event => {
-    const { selectedIndex } = event.target;
-    const index = placeholder ? selectedIndex - 1 : selectedIndex;
-    onChange(options[index]);
-  };
-
-  return (
-    <div className={className}>
-      <ArrowIcon variant={variant} />
-      <select onChange={handleOnChange} value={value} className="dropdown-select">
-        {placeholder && (
-          <option disabled hidden value={placeholder}>
-            {placeholder}
-          </option>
-        )}
-        {options.map(({ idx, value, title }: DropdownOption, index) => (
-          <option key={idx || value + index} value={value}>
-            {title || value}
-          </option>
-        ))}
-      </select>
-      <label>{value}</label>
-    </div>
-  );
-};
-
-export const Dropdown = React.memo<DropdownProps>(DropdownComponent);

src/common-elements/Dropdown/index.ts

@@ -1,2 +0,0 @@
-export * from './styled';
-export * from './types';

src/common-elements/Dropdown/styled.ts

@@ -1,94 +0,0 @@
-import styled from 'styled-components';
-
-import { Dropdown as DropdownComponent } from './Dropdown';
-
-export const Dropdown = styled(DropdownComponent)<{
-  fullWidth?: boolean;
-}>`
-  label {
-    box-sizing: border-box;
-    min-width: 100px;
-    outline: none;
-    display: inline-block;
-    font-family: ${props => props.theme.typography.headings.fontFamily};
-    color: ${({ theme }) => theme.colors.text.primary};
-    vertical-align: bottom;
-    width: ${({ fullWidth }) => (fullWidth ? '100%' : 'auto')};
-    text-transform: none;
-    padding: 0 22px 0 4px;
-
-    font-size: 0.929em;
-    line-height: 1.5em;
-    font-family: inherit;
-    text-overflow: ellipsis;
-    overflow: hidden;
-    white-space: nowrap;
-  }
-  .dropdown-select {
-    position: absolute;
-    top: 0;
-    left: 0;
-    width: 100%;
-    height: 100%;
-    opacity: 0;
-    border: none;
-    appearance: none;
-    cursor: pointer;
-
-    color: ${({ theme }) => theme.colors.text.primary};
-    line-height: inherit;
-    font-family: inherit;
-  }
-  box-sizing: border-box;
-  min-width: 100px;
-  outline: none;
-  display: inline-block;
-  border-radius: 2px;
-  border: 1px solid rgba(38, 50, 56, 0.5);
-  vertical-align: bottom;
-  padding: 2px 0px 2px 6px;
-  position: relative;
-  width: auto;
-  background: white;
-  color: #263238;
-  font-family: ${props => props.theme.typography.headings.fontFamily};
-  font-size: 0.929em;
-  line-height: 1.5em;
-  cursor: pointer;
-  transition: border 0.25s ease, color 0.25s ease, box-shadow 0.25s ease;
-
-  &:hover,
-  &:focus-within {
-    border: 1px solid ${props => props.theme.colors.primary.main};
-    color: ${props => props.theme.colors.primary.main};
-    box-shadow: 0px 0px 0px 1px ${props => props.theme.colors.primary.main};
-  }
-`;
-
-export const SimpleDropdown = styled(Dropdown)`
-  margin-left: 10px;
-  text-transform: none;
-  font-size: 0.969em;
-
-  font-size: 1em;
-  border: none;
-  padding: 0 1.2em 0 0;
-  background: transparent;
-
-  &:hover,
-  &:focus-within {
-    border: none;
-    box-shadow: none;
-    label {
-      color: ${props => props.theme.colors.primary.main};
-      text-shadow: 0px 0px 0px ${props => props.theme.colors.primary.main};
-    }
-  }
-`;
-
-export const MimeLabel = styled.span`
-  margin-left: 10px;
-  text-transform: none;
-  font-size: 0.929em;
-  color: black;
-`;

src/common-elements/Dropdown/types.ts

@@ -1,25 +0,0 @@
-export interface DropdownOption {
-  idx?: number;
-  value: string;
-  title?: string;
-  serverUrl?: string;
-  label?: string;
-}
-
-export interface DropdownProps {
-  options: DropdownOption[];
-  onChange: (option: DropdownOption) => void;
-  ariaLabel?: string;
-  className?: string;
-  placeholder?: string;
-  value?: string;
-  dense?: boolean;
-  fullWidth?: boolean;
-  variant?: 'dark' | 'light';
-}
-
-export interface ArrowIconProps {
-  className?: string;
-  variant?: 'light' | 'dark';
-  style?: React.CSSProperties;
-}

src/common-elements/Tooltip.tsx

@@ -49,7 +49,7 @@ const Gap = styled.div`
   bottom: -20px;
 `;
 
-export interface TooltipProps extends React.PropsWithChildren<any> {
+export interface TooltipProps {
   open: boolean;
   title: string;
 }

src/common-elements/dropdown.ts

@@ -0,0 +1,143 @@
+import Dropdown from '@redocly/react-dropdown-aria';
+
+import styled from '../styled-components';
+
+export interface DropdownOption {
+  idx: number;
+  value: string;
+}
+
+export interface DropdownProps {
+  options: DropdownOption[];
+  value: string;
+  onChange: (option: DropdownOption) => void;
+  ariaLabel: string;
+}
+
+export const StyledDropdown = styled(Dropdown)`
+  && {
+    box-sizing: border-box;
+    min-width: 100px;
+    outline: none;
+    display: inline-block;
+    border-radius: 2px;
+    border: 1px solid rgba(38, 50, 56, 0.5);
+    vertical-align: bottom;
+    padding: 2px 0px 2px 6px;
+    position: relative;
+    width: auto;
+    background: white;
+    color: #263238;
+    font-family: ${props => props.theme.typography.headings.fontFamily};
+    font-size: 0.929em;
+    line-height: 1.5em;
+    cursor: pointer;
+    transition: border 0.25s ease, color 0.25s ease, box-shadow 0.25s ease;
+    &:hover,
+    &:focus-within {
+      border: 1px solid ${props => props.theme.colors.primary.main};
+      color: ${props => props.theme.colors.primary.main};
+      box-shadow: 0px 0px 0px 1px ${props => props.theme.colors.primary.main};
+    }
+    .dropdown-selector {
+      display: inline-flex;
+      padding: 0;
+      height: auto;
+      padding-right: 20px;
+      position: relative;
+      margin-bottom: 5px;
+    }
+    .dropdown-selector-value {
+      font-family: ${props => props.theme.typography.headings.fontFamily};
+      position: relative;
+      font-size: 0.929em;
+      width: 100%;
+      line-height: 1;
+      vertical-align: middle;
+      color: #263238;
+      left: 0;
+      transition: color 0.25s ease, text-shadow 0.25s ease;
+    }
+    .dropdown-arrow {
+      position: absolute;
+      right: 3px;
+      top: 50%;
+      transform: translateY(-50%);
+      border-color: ${props => props.theme.colors.primary.main} transparent transparent;
+      border-style: solid;
+      border-width: 0.35em 0.35em 0;
+      width: 0;
+      svg {
+        display: none;
+      }
+    }
+
+    .dropdown-selector-content {
+      position: absolute;
+      margin-top: 2px;
+      left: -2px;
+      right: 0;
+
+      z-index: 10;
+      min-width: 100px;
+
+      background: white;
+      border: 1px solid rgba(38, 50, 56, 0.2);
+      box-shadow: 0px 2px 4px 0px rgba(34, 36, 38, 0.12), 0px 2px 10px 0px rgba(34, 36, 38, 0.08);
+
+      max-height: 220px;
+      overflow: auto;
+    }
+
+    .dropdown-option {
+      font-size: 0.9em;
+      color: #263238;
+      cursor: pointer;
+      padding: 0.4em;
+      background-color: #ffffff;
+
+      &[aria-selected='true'] {
+        background-color: rgba(0, 0, 0, 0.05);
+      }
+
+      &:hover {
+        background-color: rgba(38, 50, 56, 0.12);
+      }
+    }
+    input {
+      cursor: pointer;
+      height: 1px;
+      background-color: transparent;
+    }
+  }
+`;
+
+export const SimpleDropdown = styled(StyledDropdown)`
+  && {
+    margin-left: 10px;
+    text-transform: none;
+    font-size: 0.969em;
+
+    font-size: 1em;
+    border: none;
+    padding: 0 1.2em 0 0;
+    background: transparent;
+
+    &:hover,
+    &:focus-within {
+      border: none;
+      box-shadow: none;
+      .dropdown-selector-value {
+        color: ${props => props.theme.colors.primary.main};
+        text-shadow: 0px 0px 0px ${props => props.theme.colors.primary.main};
+      }
+    }
+  }
+`;
+
+export const MimeLabel = styled.span`
+  margin-left: 10px;
+  text-transform: none;
+  font-size: 0.929em;
+  color: black;
+`;

src/common-elements/fields-layout.ts

@@ -1,4 +1,4 @@
-import styled, { extensionsHook, media, css } from '../styled-components';
+import styled, { extensionsHook, media } from '../styled-components';
 import { deprecatedCss } from './mixins';
 
 export const PropertiesTableCaption = styled.caption`
@@ -72,26 +72,7 @@ export const PropertyNameCell = styled(PropertyCell)`
     ${deprecatedCss};
   }
 
-  ${({ kind }) =>
-    kind === 'patternProperties' &&
-    css`
-      > span.property-name {
-        display: inline-table;
-        white-space: break-spaces;
-        margin-right: 20px;
-
-        ::before,
-        ::after {
-          content: '/';
-          filter: opacity(0.2);
-        }
-      }
-    `}
-
-  ${({ kind = '' }) =>
-    ['field', 'additionalProperties', 'patternProperties'].includes(kind)
-      ? ''
-      : 'font-style: italic'};
+  ${({ kind }) => (kind !== 'field' ? 'font-style: italic' : '')};
 
   ${extensionsHook('PropertyNameCell')};
 `;

src/common-elements/fields.ts

@@ -1,17 +1,10 @@
 import { transparentize } from 'polished';
 
-import styled, { css, extensionsHook } from '../styled-components';
+import styled, { extensionsHook } from '../styled-components';
 import { PropertyNameCell } from './fields-layout';
-import { deprecatedCss } from './mixins';
 import { ShelfIcon } from './shelfs';
 
 export const ClickablePropertyNameCell = styled(PropertyNameCell)`
-  &.deprecated {
-    span.property-name {
-      ${deprecatedCss}
-    }
-  }
-
   button {
     background-color: transparent;
     border: 0;
@@ -24,27 +17,6 @@ export const ClickablePropertyNameCell = styled(PropertyNameCell)`
     &:focus {
       font-weight: ${({ theme }) => theme.typography.fontWeightBold};
     }
-    ${({ kind }) =>
-      kind === 'patternProperties' &&
-      css`
-        display: inline-flex;
-        margin-right: 20px;
-
-        > span.property-name {
-          white-space: break-spaces;
-          text-align: left;
-
-          ::before,
-          ::after {
-            content: '/';
-            filter: opacity(0.2);
-          }
-        }
-
-        > svg {
-          align-self: center;
-        }
-      `}
   }
   ${ShelfIcon} {
     height: ${({ theme }) => theme.schema.arrow.size};
@@ -76,9 +48,7 @@ export const TypeTitle = styled(FieldLabel)`
 
 export const TypeFormat = TypeName;
 
-export const RequiredLabel = styled(FieldLabel).attrs({
-  as: 'div',
-})`
+export const RequiredLabel = styled(FieldLabel.withComponent('div'))`
   color: ${props => props.theme.schema.requireLabelColor};
   font-size: ${props => props.theme.schema.labelsTextSize};
   font-weight: normal;
@@ -86,10 +56,6 @@ export const RequiredLabel = styled(FieldLabel).attrs({
   line-height: 1;
 `;
 
-export const PropertyLabel = styled(RequiredLabel)`
-  color: ${props => props.theme.colors.primary.light};
-`;
-
 export const RecursiveLabel = styled(FieldLabel)`
   color: ${({ theme }) => theme.colors.warning.main};
   font-size: 13px;
@@ -97,17 +63,14 @@ export const RecursiveLabel = styled(FieldLabel)`
 
 export const PatternLabel = styled(FieldLabel)`
   color: #0e7c86;
-  font-family: ${props => props.theme.typography.code.fontFamily};
-  font-size: 12px;
   &::before,
   &::after {
-    content: ' ';
+    font-weight: bold;
   }
 `;
 
 export const ExampleValue = styled(FieldLabel)`
   border-radius: 2px;
-  word-break: break-word;
   ${({ theme }) => `
     background-color: ${transparentize(0.95, theme.colors.text.primary)};
     color: ${transparentize(0.1, theme.colors.text.primary)};
@@ -133,6 +96,7 @@ export const ConstraintItem = styled(FieldLabel)`
     margin: 0 ${theme.spacing.unit}px;
     padding: 0 ${theme.spacing.unit}px;
     border: 1px solid ${transparentize(0.9, theme.colors.primary.main)};
+    font-family: ${theme.typography.code.fontFamily};
 }`};
   & + & {
     margin-left: 0;

src/common-elements/headers.ts

@@ -15,22 +15,21 @@ export const headerCommonMixin = level => css`
 
 export const H1 = styled.h1`
   ${headerCommonMixin(1)};
-  color: ${({ theme }) => theme.colors.text.primary};
+  color: ${({ theme }) => theme.colors.primary.main};
 
   ${extensionsHook('H1')};
 `;
 
 export const H2 = styled.h2`
   ${headerCommonMixin(2)};
-  color: ${({ theme }) => theme.colors.text.primary};
-  margin: 0 0 20px;
+  color: black;
 
   ${extensionsHook('H2')};
 `;
 
 export const H3 = styled.h2`
   ${headerCommonMixin(3)};
-  color: ${({ theme }) => theme.colors.text.primary};
+  color: black;
 
   ${extensionsHook('H3')};
 `;

src/common-elements/index.ts

@@ -4,8 +4,8 @@ export * from './linkify';
 export * from './shelfs';
 export * from './fields-layout';
 export * from './schema';
+export * from './dropdown';
 export * from './mixins';
 export * from './tabs';
 export * from './samples';
 export * from './perfect-scrollbar';
-export * from './Dropdown';

src/common-elements/linkify.tsx

@@ -43,7 +43,7 @@ export function Link(props: { to: string; className?: string; children?: any })
       if (!store) return;
       navigate(store.menu.history, event, props.to);
     },
-    [store, props.to],
+    [store],
   );
 
   if (!store) return null;
@@ -67,7 +67,7 @@ function navigate(history: HistoryService, event: React.MouseEvent<HTMLAnchorEle
     !isModifiedEvent(event) // ignore clicks with modifier keys
   ) {
     event.preventDefault();
-    history.replace(encodeURI(to));
+    history.replace(to);
   }
 }
 

src/common-elements/panels.ts

@@ -1,14 +1,14 @@
 import { SECTION_ATTR } from '../services/MenuStore';
 import styled, { media } from '../styled-components';
 
-export const MiddlePanel = styled.div<{ $compact?: boolean }>`
+export const MiddlePanel = styled.div<{ compact?: boolean }>`
   width: calc(100% - ${props => props.theme.rightPanel.width});
   padding: 0 ${props => props.theme.spacing.sectionHorizontal}px;
 
-  ${({ $compact, theme }) =>
+  ${({ compact, theme }) =>
     media.lessThan('medium', true)`
     width: 100%;
-    padding: ${`${$compact ? 0 : theme.spacing.sectionVertical}px ${
+    padding: ${`${compact ? 0 : theme.spacing.sectionVertical}px ${
       theme.spacing.sectionHorizontal
     }px`};
   `};
@@ -16,7 +16,7 @@ export const MiddlePanel = styled.div<{ $compact?: boolean }>`
 
 export const Section = styled.div.attrs(props => ({
   [SECTION_ATTR]: props.id,
-}))<{ $underlined?: boolean }>`
+}))<{ underlined?: boolean }>`
   padding: ${props => props.theme.spacing.sectionVertical}px 0;
 
   &:last-child {
@@ -30,8 +30,8 @@ export const Section = styled.div.attrs(props => ({
   ${media.lessThan('medium', true)`
     padding: 0;
   `}
-  ${({ $underlined }) =>
-    ($underlined &&
+  ${(props: any) =>
+    (props.underlined &&
       `
     position: relative;
 

src/common-elements/perfect-scrollbar.tsx

@@ -1,10 +1,10 @@
 import * as React from 'react';
 
 import PerfectScrollbarType, * as PerfectScrollbarNamespace from 'perfect-scrollbar';
+import psStyles from 'perfect-scrollbar/css/perfect-scrollbar.css';
 
 import { OptionsContext } from '../components/OptionsProvider';
 import styled, { createGlobalStyle } from '../styled-components';
-import { IS_BROWSER } from '../utils';
 
 /*
  * perfect scrollbar umd bundle uses exports assignment while module uses default export
@@ -14,14 +14,7 @@ import { IS_BROWSER } from '../utils';
 const PerfectScrollbarConstructor =
   PerfectScrollbarNamespace.default || (PerfectScrollbarNamespace as any as PerfectScrollbarType);
 
-let psStyles = '';
-if (IS_BROWSER) {
-  psStyles = require('perfect-scrollbar/css/perfect-scrollbar.css');
-  psStyles = (typeof psStyles.toString === 'function' && psStyles.toString()) || '';
-  psStyles = psStyles === '[object Object]' ? '' : psStyles;
-}
-
-const PSStyling = createGlobalStyle`${psStyles}`;
+const PSStyling = createGlobalStyle`${psStyles && psStyles.toString()}`;
 
 const StyledScrollWrapper = styled.div`
   position: relative;
@@ -33,9 +26,7 @@ export interface PerfectScrollbarProps {
   updateFn?: (fn) => void;
 }
 
-export class PerfectScrollbar extends React.Component<
-  React.PropsWithChildren<PerfectScrollbarProps>
-> {
+export class PerfectScrollbar extends React.Component<PerfectScrollbarProps> {
   private _container: HTMLElement;
   private inst: PerfectScrollbarType;
 
@@ -68,7 +59,7 @@ export class PerfectScrollbar extends React.Component<
 
     return (
       <>
-        {psStyles && <PSStyling />}
+        <PSStyling />
         <StyledScrollWrapper className={`scrollbar-container ${className}`} ref={this.handleRef}>
           {children}
         </StyledScrollWrapper>

src/common-elements/samples.tsx

@@ -32,9 +32,7 @@ export const SampleControlsWrap = styled.div`
   }
 `;
 
-export const StyledPre = styled(PrismDiv).attrs({
-  as: 'pre',
-})`
+export const StyledPre = styled(PrismDiv.withComponent('pre'))`
   font-family: ${props => props.theme.typography.code.fontFamily};
   font-size: ${props => props.theme.typography.code.fontSize};
   overflow-x: auto;

src/common-elements/schema.ts

@@ -1,6 +1,5 @@
 import styled from '../styled-components';
 import { darken } from 'polished';
-import { deprecatedCss } from './mixins';
 
 export const OneOfList = styled.div`
   margin: 0 0 3px 0;
@@ -15,7 +14,7 @@ export const OneOfLabel = styled.span`
 }
 `;
 
-export const OneOfButton = styled.button<{ $active: boolean; $deprecated: boolean }>`
+export const OneOfButton = styled.button<{ active: boolean }>`
   display: inline-block;
   margin-right: 10px;
   margin-bottom: 5px;
@@ -29,10 +28,8 @@ export const OneOfButton = styled.button<{ $active: boolean; $deprecated: boolea
     box-shadow: 0 0 0 1px ${props => props.theme.colors.primary.main};
   }
 
-  ${({ $deprecated }) => ($deprecated && deprecatedCss) || ''};
-
   ${props => {
-    if (props.$active) {
+    if (props.active) {
       return `
       color: white;
       background-color: ${props.theme.colors.primary.main};

src/common-elements/shelfs.tsx

@@ -8,34 +8,35 @@ const directionMap = {
   down: '0',
 };
 
-const IntShelfIcon = (props: {
+class IntShelfIcon extends React.PureComponent<{
   className?: string;
   float?: 'left' | 'right';
   size?: string;
   color?: string;
   direction: 'left' | 'right' | 'up' | 'down';
   style?: React.CSSProperties;
-}): JSX.Element => {
-  return (
-    <svg
-      className={props.className}
-      style={props.style}
-      version="1.1"
-      viewBox="0 0 24 24"
-      x="0"
-      xmlns="http://www.w3.org/2000/svg"
-      y="0"
-      aria-hidden="true"
-    >
-      <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 " />
-    </svg>
-  );
-};
+}> {
+  render() {
+    return (
+      <svg
+        className={this.props.className}
+        style={this.props.style}
+        version="1.1"
+        viewBox="0 0 24 24"
+        x="0"
+        xmlns="http://www.w3.org/2000/svg"
+        y="0"
+        aria-hidden="true"
+      >
+        <polygon points="17.3 8.3 12 13.6 6.7 8.3 5.3 9.7 12 16.4 18.7 9.7 " />
+      </svg>
+    );
+  }
+}
 
 export const ShelfIcon = styled(IntShelfIcon)`
   height: ${props => props.size || '18px'};
   width: ${props => props.size || '18px'};
-  min-width: ${props => props.size || '18px'};
   vertical-align: middle;
   float: ${props => props.float || ''};
   transition: transform 0.2s ease-out;
@@ -47,11 +48,11 @@ export const ShelfIcon = styled(IntShelfIcon)`
   }
 `;
 
-export const Badge = styled.span<{ type: string; color?: string }>`
+export const Badge = styled.span<{ type: string }>`
   display: inline-block;
   padding: 2px 8px;
   margin: 0;
-  background-color: ${props => props.color || props.theme.colors[props.type].main};
+  background-color: ${props => props.theme.colors[props.type].main};
   color: ${props => props.theme.colors[props.type].contrastText};
   font-size: ${props => props.theme.typography.code.fontSize};
   vertical-align: middle;