refactor!: migrate to TypeScript and ESM-only (#21)

Refs: https://github.com/cheminfo/generator-cheminfo/blob/main/ts-migration.md

fix: update `is-any-array` to v3

Author: tpoisseau

.eslintignore

@@ -11,5 +11,6 @@ jobs:
     # Documentation: https://github.com/zakodium/workflows#nodejs-ci
     uses: zakodium/workflows/.github/workflows/nodejs.yml@nodejs-v1
     with:
-      node-version-matrix: '[12, 14, 16]'      
-      npm-setup-command: 'npm install && npm run prepare && npm run build'
+      lint-check-types: true
+      disable-test-package: true # Monorepo, root not publishable
+

.eslintrc.yml

@@ -58,5 +58,8 @@ typings/
 .env
 
 .idea
+
+# Lib (ts) artifacts
+
 /packages/*/lib/
-/packages/*/lib-es6/
+/packages/*/*.tsbuildinfo

.github/workflows/nodejs.yml

@@ -0,0 +1,4 @@
+CHANGELOG.md
+coverage
+lib
+docs

.gitignore

@@ -5,7 +5,7 @@ Functional utilities to transform and compute stats on arrays
 ## Packages
 
 | Name                                                               | Description                                    |
-|--------------------------------------------------------------------|------------------------------------------------|
+| ------------------------------------------------------------------ | ---------------------------------------------- |
 | [ml-array-sequential-fill](./packages/array-sequential-fill)       | Fill / create an array with sequential numbers |
 | [ml-array-min](./packages/array-min)                               | Get the minimum value in an array              |
 | [ml-array-max](./packages/array-max)                               | Get the maximum value in an array              |

.prettierignore

@@ -0,0 +1,52 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { defineConfig, globalIgnores } from 'eslint/config';
+import ts from 'eslint-config-cheminfo-typescript/base';
+import unicorn from 'eslint-config-cheminfo-typescript/unicorn';
+import vitest from 'eslint-config-cheminfo-typescript/vitest';
+
+export default defineConfig(
+  globalIgnores([
+    '**/coverage',
+    '**/lib',
+    '**/lib-internal',
+    '**/docs',
+    '**/CHANGELOG.md',
+    '/src/',
+  ]),
+  ts,
+  unicorn,
+  vitest,
+  createNoExtraneousConfigs(),
+  {
+    // it uses an old `median-quickselect` package, which does not have types,
+    // so triple-slash-reference is used to declare `median-quickselect` module.
+    files: ['packages/array-median/src/index.ts'],
+    rules: {
+      '@typescript-eslint/triple-slash-reference': 'off',
+    },
+  },
+);
+
+function createNoExtraneousConfigs() {
+  const configs = [];
+  for (const pkg of fs.readdirSync('packages')) {
+    configs.push({
+      files: [`packages/${pkg}/**`],
+      rules: {
+        'import/no-extraneous-dependencies': [
+          'error',
+          {
+            packageDir: [
+              fileURLToPath(new URL(`packages/${pkg}`, import.meta.url)),
+              path.dirname(fileURLToPath(import.meta.url)),
+            ],
+          },
+        ],
+      },
+    });
+  }
+  return configs;
+}

README.md

@@ -1,4 +1,5 @@
 {
+  "$schema": "node_modules/lerna/schemas/lerna-schema.json",
   "conventionalCommits": true,
   "packages": ["packages/*"],
   "command": {

babel.config.js

@@ -1,35 +1,39 @@
 {
-  "private": true,
   "name": "ml-array-utils",
-  "main": "lib/index.js",
-  "module": "src/index.js",
+  "private": true,
+  "version": "1.0.0",
   "description": "Functional utilities to transform and compute stats on arrays",
+  "type": "module",
+  "workspaces": [
+    "packages/*"
+  ],
   "scripts": {
-    "bootstrap": "lerna bootstrap --no-ci",
-    "build": "npm run build-clean && lerna exec -- rollup -c ../../rollup.config.js",
-    "build-clean": "rimraf ./packages/*/lib/ && rimraf ./packages/*/lib-es6/",
-    "eslint": "eslint packages/**/*.js --cache",
+    "build": "npm run build-clean && npm run tsc",
+    "build-clean": "rimraf packages/*/lib packages/*/*.tsbuildinfo",
+    "check-types": "tsc --noEmit",
+    "coverage-clean": "rimraf coverage",
+    "eslint": "eslint . --cache",
     "eslint-fix": "npm run eslint -- --fix",
-    "prepare": "npm run bootstrap",
-    "prettier": "prettier --check src",
-    "prettier-write": "prettier --write src",
-    "publish": "git pull --rebase && npm run build && npm run test-publish && lerna publish",
-    "test": "run-s build test-only eslint prettier",
-    "test-watch": "jest --watch",
-    "test-publish": "run-s test-only eslint",
-    "test-only": "jest --coverage"
+    "full-clean": "npm run build-clean && npm run coverage-clean && npm run install-clean",
+    "install-clean": "rimraf node_modules packages/*/node_modules",
+    "prettier": "prettier --check .",
+    "prettier-write": "prettier --write .",
+    "publish": "npm run test && npm run build && npm run test && lerna publish -y --no-verify-access",
+    "test": "npm run test-only && tsc --noEmit && npm run eslint && npm run prettier",
+    "test-only": "vitest --run --coverage",
+    "tsc": "tsc --build",
+    "tsc-watch": "tsc --build --watch"
   },
   "devDependencies": {
-    "@babel/plugin-transform-modules-commonjs": "^7.16.8",
-    "@babel/preset-env": "^7.16.11",
-    "@rollup/plugin-babel": "^5.3.1",
-    "eslint": "^8.10.0",
-    "eslint-config-cheminfo": "^7.2.2",
-    "jest": "^27.5.1",
-    "lerna": "^4.0.0",
-    "npm-run-all": "^4.1.5",
-    "prettier": "^2.5.1",
-    "rimraf": "^3.0.2",
-    "rollup": "^2.68.0"
+    "@types/node": "^25.6.0",
+    "@vitest/coverage-v8": "^4.1.4",
+    "@zakodium/tsconfig": "^1.0.5",
+    "eslint": "^9.39.4",
+    "eslint-config-cheminfo-typescript": "^21.2.0",
+    "lerna": "^9.0.5",
+    "prettier": "^3.8.2",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.4"
   }
 }