Migrate to ES Module structure/runtime - Node 20, Vite, Vitest, Storybook 8

.github/workflows/main.yml

@@ -14,7 +14,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [20.x]
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v2

.github/workflows/pr-test-api-docs.yml

@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [20.x]
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v2

.github/workflows/publish-api-docs.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [16.x]
+        node-version: [20.x]
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v2

.gitignore

@@ -14,4 +14,6 @@ packages/example-*/
 report.*
 test-projects
 **/.env
-packages/*/src/i18n
+packages/base-project/src/i18n
+packages/template-*/src/i18n
+.story-cache

.husky/pre-commit

@@ -2,4 +2,5 @@
 . "$(dirname -- "$0")/_/husky.sh"
 
 npx lerna run prepare # transpiles core geoprocessing code for templates
-npx lerna run test:local # tests all packages including e2e tests not run by Github CI (GDAL, etc.)
+# run tests including e2e tests not run by Github CI (GDAL, etc.)
+npx lerna run test:local

.nvmrc

@@ -1 +1 @@
-16
+20

.vscode/launch.json

@@ -6,26 +6,39 @@
   "configurations": [
 
     {
-        "name": "geoprocessing - debug tests",
+        "name": "geoprocessing - debug src tests",
         "type": "node",
         "request": "launch",
         "cwd": "${workspaceFolder}/packages/geoprocessing",
         "runtimeArgs": [
           "--inspect-brk",
-          "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
-          "--group=-e2e"
+          "${workspaceRoot}/node_modules/.bin/vitest",
+          "-c",
+          "vitest.config.node.js"
         ],
         "console": "integratedTerminal",
         "internalConsoleOptions": "neverOpen",
         "port": 9229        
     }, {
-      "name": "geoprocessing - debug tests with pattern",
+      "type": "node",
+      "request": "launch",
+      "name": "geoprocessing - debug current test file",
+      "autoAttachChildProcesses": true,
+      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
+      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
+      "args": ["run", "${relativeFile}"],
+      "smartStep": true,
+      "console": "integratedTerminal"
+    }, {
+      "name": "geoprocessing - debug src tests with pattern",
       "type": "node",
       "request": "launch",
       "cwd": "${workspaceFolder}/packages/geoprocessing",
       "runtimeArgs": [
         "--inspect-brk",
-        "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
+        "${workspaceRoot}/node_modules/.bin/vitest",
+        "-c",
+        "vitest.config.node.js",
         "-t",
         "${input:testNamePattern}"
       ],
@@ -34,80 +47,66 @@
       "port": 9229        
     },
     {
-      "name": "geoprocessing - debug tests scripts",
+      "name": "geoprocessing - debug scripts tests",
       "type": "node",
       "request": "launch",
       "cwd": "${workspaceFolder}/packages/geoprocessing",
       "runtimeArgs": [
         "--inspect-brk",
-        "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
-        "--projects",
-        "scripts"
+        "${workspaceRoot}/node_modules/.bin/vitest",
+        "-c",
+        "vitest.config.scripts.node.js"
       ],
       "console": "integratedTerminal",
       "internalConsoleOptions": "neverOpen",
       "port": 9229        
   }, {
-    "name": "geoprocessing - debug tests scripts with pattern",
+    "name": "geoprocessing - debug scripts tests with pattern",
     "type": "node",
     "request": "launch",
     "cwd": "${workspaceFolder}/packages/geoprocessing",
     "runtimeArgs": [
       "--inspect-brk",
-      "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
-      "--projects",
-      "scripts",
+      "${workspaceRoot}/node_modules/.bin/vitest",
+      "-c",
+      "vitest.config.scripts.node.js",
       "-t",
       "${input:testNamePattern}"
     ],
     "console": "integratedTerminal",
     "internalConsoleOptions": "neverOpen",
     "port": 9229        
   }, {
-      "name": "geoprocessing - debug e2e tests",
+      "name": "geoprocessing - debug src e2e tests",
       "type": "node",
       "request": "launch",
       "cwd": "${workspaceFolder}/packages/geoprocessing",
       "runtimeArgs": [
         "--inspect-brk",
-        "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
-        "--runInBand",
-        "--group=e2e"
+        "${workspaceRoot}/node_modules/.bin/vitest",
+        "-c",
+        "vitest.config.e2e.js"
       ],
       "console": "integratedTerminal",
       "internalConsoleOptions": "neverOpen",
       "port": 9229        
   }, {
-    "name": "geoprocessing - debug e2e tests with pattern",
+    "name": "geoprocessing - debug src e2e tests with pattern",
     "type": "node",
     "request": "launch",
     "cwd": "${workspaceFolder}/packages/geoprocessing",
     "runtimeArgs": [
       "--inspect-brk",
-      "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
-      "--runInBand",
-      "--group=e2e",
+      "${workspaceRoot}/node_modules/.bin/vitest",
+      "-c",
+      "vitest.config.e2e.js",
       "-t",
       "${input:testNamePattern}"
     ],
     "console": "integratedTerminal",
     "internalConsoleOptions": "neverOpen",
     "port": 9229        
   }, {
-      "name": "geoprocessing scripts- debug tests",
-      "type": "node",
-      "request": "launch",
-      "cwd": "${workspaceFolder}/packages/geoprocessing",
-      "runtimeArgs": [
-        "--inspect-brk",
-        "${workspaceRoot}/packages/geoprocessing/node_modules/.bin/jest",
-        "--projects",
-        "scripts"
-      ],
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen",
-      "port": 9229        
-    }, {
       "name": "template-ocean-eez - debug tests",
       "type": "node",
       "request": "launch",
@@ -125,8 +124,8 @@
       "request": "launch",
       "name": "translation - debug importTerms",
       "runtimeArgs": [
-          "-r",
-          "ts-node/register",
+          "--import",
+          "tsx",
       ],
       "args": [
           "${workspaceRoot}/packages/geoprocessing/src/i18n/bin/importTerms.ts"
@@ -136,8 +135,8 @@
     "request": "launch",
     "name": "translation - debug publishTerms",
     "runtimeArgs": [
-        "-r",
-        "ts-node/register",
+        "--import",
+        "tsx",
     ],
     "args": [
         "${workspaceRoot}/packages/geoprocessing/src/i18n/bin/publishTerms.ts"
@@ -162,8 +161,8 @@
   "request": "launch",
   "name": "run any ts-node script",
   "runtimeArgs": [
-      "-r",
-      "ts-node/register/transpile-only",
+      "--import",
+      "tsx",
   ],
   "args": [
       "${workspaceRoot}/packages/geoprocessing/${input:scriptPath}"
@@ -180,7 +179,7 @@
     {
       "type": "promptString",
       "id": "testNamePattern",
-      "description": "jest -t 'regex pattern to select tests'",
+      "description": "vitest -t 'regex pattern to select tests'",
       "default": "name of my test"
     },
     {

.vscode/settings.json

@@ -22,7 +22,6 @@
   },
   "files.exclude": {},
   "git.ignoreLimitWarning": true,
-  "jest.rootPath": "packages/geoprocessing",
   "workbench.colorCustomizations": {
     "activityBar.activeBackground": "#004b99",
     "activityBar.activeBorder": "#ff007d",
@@ -61,5 +60,6 @@
   "i18n-ally.keysInUse": [
     "description.part2_whatever"
   ],
-  "i18n-ally.defaultNamespace": "translation"
+  "i18n-ally.defaultNamespace": "translation",
+  "vitest.disableWorkspaceWarning": true
 }

babel.config.js

@@ -19,6 +19,7 @@ module.exports = {
         keyAsDefaultValueForDerivedKeys: true,
       },
     ],
+    ["@babel/plugin-syntax-import-attributes"],
   ],
   overrides: [
     { test: /\.js$/, presets: common },

lerna.json

@@ -1,6 +1,4 @@
 {
-  "packages": [
-    "packages/*"
-  ],
+  "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "version": "6.1.2"
 }