Merge branch 'devex/jsdoc-migration' into dev.tt

.eslintignore

@@ -0,0 +1,10 @@
+node_modules
+lib
+dist
+app
+test
+types
+*.spec.js
+*.unit.js
+_site
+docs

.eslintrc.js

@@ -0,0 +1,17 @@
+module.exports = {
+    "env": {
+        "browser": true,
+        "es2021": true,
+        "node": true
+    },
+    "extends": ["eslint:recommended", "plugin:jsdoc/recommended-typescript-flavor"],
+    "parserOptions": {
+        "ecmaVersion": "latest",
+        "sourceType": "module"
+    },
+    "plugins": ["jsdoc"],
+    "rules": {
+      "no-prototype-builtins": "off",
+      "no-unused-vars": ["error", { "argsIgnorePattern": "^_" }],
+    }
+}

gulpfile.js

@@ -6,7 +6,6 @@ const concat = require('gulp-concat');
 const replace = require('gulp-replace');
 const rename = require('gulp-rename');
 const cleanCSS = require('gulp-clean-css');
-const eslint = require('gulp-eslint');
 const clean = require('gulp-clean');
 
 // Clean lib folder.
@@ -18,14 +17,6 @@ gulp.task('clean:lib', () => {
 });
 gulp.task('clean', gulp.parallel('clean:dist', 'clean:lib'));
 
-// ESLint
-gulp.task('eslint', function eslintTask() {
-  return gulp.src(['./src/**/*.js', '!./src/**/*.spec.js'])
-    .pipe(eslint())
-    .pipe(eslint.format())
-    .pipe(eslint.failAfterError());
-});
-
 // Move font-awesome fonts into dist folder.
 gulp.task('builder-fonts', function builderFonts() {
   return gulp.src('./node_modules/bootstrap-icons/font/fonts/*').pipe(gulp.dest('dist/fonts'));

jsdoc.json

@@ -0,0 +1,13 @@
+{
+    "source": {
+      "includePattern": "src/+\\.js$",
+      "excludePattern": "src/+\\.(spec|test|unit)\\.js$"
+    },
+    "destination": "./docs",
+    "plugins": [
+      "jsdoc-plugin-typescript"
+    ],
+    "typescript": {
+      "moduleRoot": "src"
+    }
+  }

package.json

@@ -34,8 +34,8 @@
     "lint"
   ],
   "scripts": {
-    "build": "yarn doc && yarn lib && yarn dist",
-    "doc": "esdoc",
+    "build": "yarn lib && yarn dist",
+    "doc": "",
     "dist": "gulp clean:dist && webpack --config webpack.config.js && webpack --config webpack.prod.js && gulp build",
     "lib": "gulp clean:lib && tsc --project tsconfig.cjs.json && tsc --project tsconfig.mjs.json && yarn lib:package",
     "lib:package": "node ./libpackage.js",
@@ -50,7 +50,7 @@
     "release": "yarn build-app && yarn deploy-s3",
     "tag": "VERSION=$(yarn version);git add -A; git commit -m \"Build $Version\";git push origin master;git tag v$VERSION;git push origin --tags;",
     "dopublish": "npm run build && npm run tag && npm publish",
-    "lint": "gulp eslint",
+    "lint": "eslint ./src --fix",
     "serve": "jekyll serve --config _config.yml,_config.dev.yml",
     "test": "mocha 'src/**/*.unit.js'",
     "test:updateRenders": "npm run lib && TZ=UTC node --require jsdom-global/register test/updateRenders.js",
@@ -124,11 +124,10 @@
     "chance": "^1.1.9",
     "ejs-loader": "^0.5.0",
     "escape-string-regexp": "^5.0.0",
-    "esdoc": "^1.1.0",
     "esdoc-ecmascript-proposal-plugin": "^1.0.0",
     "esdoc-standard-plugin": "^1.0.0",
     "eslint": "^8.57.0",
-    "eslint-config-formio": "^1.1.4",
+    "eslint-plugin-jsdoc": "^48.2.3",
     "fetch-mock": "^9.11.0",
     "file-loader": "^6.2.0",
     "flatpickr": "^4.6.13",
@@ -137,14 +136,14 @@
     "gulp-clean": "^0.4.0",
     "gulp-clean-css": "^4.3.0",
     "gulp-concat": "^2.6.1",
-    "gulp-eslint": "^6.0.0",
     "gulp-filter": "^7.0.0",
     "gulp-rename": "^2.0.0",
     "gulp-replace": "^1.1.3",
     "gulp-sass": "^5.1.0",
     "gulp-sync": "^0.1.4",
     "gulp-watch": "^5.0.1",
     "hoek": "^6.1.3",
+    "jsdoc": "^4.0.2",
     "jsdom": "22.1.0",
     "jsdom-global": "^3.0.2",
     "karma": "^6.4.3",