Update Vue@2.7 (#440)

resolves rdar://100963792

* chore: update vue to 2.7

* fix: bad test from upgrade

* refactor: use `:deep` instead of `/deep/`

* refactor: use new slot syntax

* refactor: replace `node-sass` with `dart-sass`

* chore: update to node16

* fix: sass error from merge

* fix: issues with running `npm ci`

* chore: inline scss var

* refactor: update to Vue CLI 15

* chore: fix issues from merge

* fix: eslint and build errors

* chore: update tests

* chore: add nvmrc file

* fix: update latest code to comply

* chore: run `npm audit fix`

* chore: fix test

* refactor: update code to match latest Vue 2.7 requirements

* chore: update package-lock

* refactor: minor fixes

* fix: remove import extensions where not needed

* fix: import path

* fix: css

* chore: fix test

* chore: update node and npm to later versions

* fix: vue-config-utils.js webpack 5 devserver setup

* fix merge conflict

* update nvmrc

* chore: remove the webpack-theme-resolver-plugin from the NOTICE.txt file

* build: build-time script and linter fixes. Update references to node version

Author: Dobromir Hristov

.eslintrc.js

@@ -18,7 +18,7 @@ module.exports = {
     '@vue/airbnb',
   ],
   parserOptions: {
-    parser: 'babel-eslint',
+    parser: '@babel/eslint-parser',
   },
   rules: {
     'no-console': process.env.NODE_ENV === 'production' ? [
@@ -35,6 +35,14 @@ module.exports = {
     }],
     'template-curly-spacing': 'off',
     'vue/experimental-script-setup-vars': 'off',
+    'vue/multi-word-component-names': 'off',
+    'function-paren-newline': ['error', 'consistent'],
+    'function-call-argument-newline': 'off',
+    'vuejs-accessibility/form-control-has-label': 'off',
+    'vuejs-accessibility/label-has-for': 'off',
+    'vuejs-accessibility/aria-role': 'off',
+    'vuejs-accessibility/click-events-have-key-events': 'off',
+    'vuejs-accessibility/anchor-has-content': 'off',
   },
   overrides: [
     {

.npmrc

@@ -0,0 +1 @@
+registry = 'https://registry.npmjs.org/'

.nvmrc

@@ -1 +1 @@
-14.17.4
+18.16.1

CONTRIBUTING.md

@@ -50,8 +50,8 @@ more details.
 
 ### Run Steps
 
-> Note: requires [Node.js](https://nodejs.org/en/download/) v14
-> and [npm](https://www.npmjs.com/package/npm) v6.14. An easy way to set these up is to install
+> Note: requires [Node.js](https://nodejs.org/en/download/) v18
+> and [npm](https://www.npmjs.com/package/npm) v9.5. An easy way to set these up is to install
 > [nvm](https://github.com/nvm-sh/nvm) and run `nvm install` from within the Swift-DocC-Render
 > repository. To use these versions as the default, add `--default` to the installation command.
 

NOTICE.txt

@@ -72,12 +72,3 @@ This product depends on PortalVue.
     * https://github.com/LinusBorg/portal-vue/blob/develop/LICENCE
   * HOMEPAGE:
     * https://github.com/LinusBorg/portal-vue
-
----
-
-This product depends on webpack-theme-resolver-plugin.
-
-  * LICENSE (MIT):
-    * https://github.com/russmediadigital/webpack-theme-resolver-plugin/blob/master/LICENSE
-  * HOMEPAGE
-    * https://github.com/russmediadigital/webpack-theme-resolver-plugin

README.md

@@ -7,8 +7,8 @@ SPAs are web apps that render dynamically at runtime entirely in the browser, us
 
 ## Getting Started
 
-> Note: requires [Node.js](https://nodejs.org/en/download/) v14
-> and [npm](https://www.npmjs.com/package/npm) v6.14. An easy way to set these up is to install
+> Note: requires [Node.js](https://nodejs.org/en/download/) v18
+> and [npm](https://www.npmjs.com/package/npm) v9.5. An easy way to set these up is to install
 > [nvm](https://github.com/nvm-sh/nvm) and run `nvm install` from within the Swift-DocC-Render
 > repository. To use these versions as the default, add `--default` to the installation command.
 

SwiftDocCRender.docc/contributing/Internals.md

@@ -41,9 +41,8 @@ For the route `/documentation/path/to/something` DocC-Render will try to fetch D
 Links to pages in DocC-Render are generated using references coming from the render JSON. You can use `ReferenceUrlProvider` to get the URL and title from a reference.
 
 ```html
-<ReferenceUrlProvider :reference="someFooReference">
+<ReferenceUrlProvider :reference="someFooReference" v-slot="{ url, title }">
     <router-link 
-        slot-scope="{ url, title }"
         :to="url"
     >
         {{ title }}

bin/check-source

@@ -52,10 +52,10 @@ EOF
         cat > "$tmp" <<"EOF"
 /*!
  * This source file is part of the Swift.org open source project
- * 
+ *
  * Copyright (c) YEARS Apple Inc. and the Swift project authors
  * Licensed under Apache License v2.0 with Runtime Library Exception
- * 
+ *
  * See https://swift.org/LICENSE.txt for license information
  * See https://swift.org/CONTRIBUTORS.txt for Swift project authors
 EOF

build-script-helper.py

@@ -75,8 +75,8 @@ def ensure_npm_is_installed(verbose=False):
         fatal_error('-- Error: %s' % error_msg)
     try:
         node_version = check_output(['node', '--version'], verbose=verbose)
-        if not node_version.startswith('v14.17.'):
-            warn_msg = "Unexpected version of 'node' installed. Swift-DocC-Render requires node 14.17.4. "\
+        if not node_version.startswith('v18.16.'):
+            warn_msg = "Unexpected version of 'node' installed. Swift-DocC-Render requires node 18.16.1. "\
                 "See the README.md file for more information about building Swift-DocC-Render."
             printerr('-- Warning: %s' % warn_msg)
     except: