feat: updated the script system to zx

The script system has been updated to use Google's zx instead of the deprecated nps. This system
provides more flexibility and reliablity , as well as full ES compatibility support. To address this
change, other updates had to be made. Additionally, all versions of libraries had been updated.

BREAKING CHANGE: The scripts system now is based on zx, previous scripts will not work and have to
be migrated.

Author: alanrodas

.github/ISSUE_TEMPLATE/bug_report.md

@@ -20,7 +20,7 @@ A clear and concise description of what you expected to happen.
 
 ## Versions
 
--   Library Version:
--   Node/NPM Version (if any):
--   Operating System Version:
--   Browser Version:
+- Library Version:
+- Node/NPM Version (if any):
+- Operating System Version:
+- Browser Version:

.github/PULL_REQUEST_TEMPLATE.md

@@ -11,14 +11,14 @@ merged into the project.
 
 Before opening a pull request, please ensure:
 
--   [ ] You have followed our [**guidelines**](https://gobstones.github.io/gobstones-guidelines/)
--   [ ] Double-check your branch is based on `main` and targets `main`
--   [ ] Pull request has tests (we are going for 100% coverage!)
--   [ ] Code is well-commented, linted and follows project conventions
--   [ ] Documentation is updated (if necessary)
--   [ ] Internal code generators and templates are updated (if necessary)
--   [ ] Description explains the issue/use-case resolved and auto-closes related
-        issues
+- [ ] You have followed our [**guidelines**](https://gobstones.github.io/gobstones-guidelines/)
+- [ ] Double-check your branch is based on `main` and targets `main`
+- [ ] Pull request has tests (we are going for 100% coverage!)
+- [ ] Code is well-commented, linted and follows project conventions
+- [ ] Documentation is updated (if necessary)
+- [ ] Internal code generators and templates are updated (if necessary)
+- [ ] Description explains the issue/use-case resolved and auto-closes related
+      issues
 
 Be kind to code reviewers, please try to keep pull requests as small and focused
 as possible.

.github/workflows/on-commit-build.yml

@@ -16,6 +16,6 @@ jobs:
             - name: Setup node version
               uses: actions/setup-node@v4
               with:
-                  node-version: '20'
+                  node-version: '22'
             - name: Installing project dependencies
               run: npm install

.github/workflows/on-commit-test.yml

@@ -16,7 +16,7 @@ jobs:
             - name: Setup node version
               uses: actions/setup-node@v4
               with:
-                  node-version: '20'
+                  node-version: '22'
             - name: Installing project dependencies
               run: npm install
             - name: Linting the code

.github/workflows/on-tag-publish-docs.yml

@@ -27,7 +27,7 @@ jobs:
             - name: Setup node version
               uses: actions/setup-node@v4
               with:
-                  node-version: '20'
+                  node-version: '22'
             - name: Installing project dependencies
               run: npm install
             - name: Building the docs

.github/workflows/on-tag-release-github.yml

@@ -14,7 +14,7 @@ jobs:
             - name: Setup node version
               uses: actions/setup-node@v4
               with:
-                  node-version: '20'
+                  node-version: '22'
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
             - name: Installing project dependencies

.github/workflows/on-tag-release-npm.yml

@@ -14,7 +14,7 @@ jobs:
             - name: Setup node version
               uses: actions/setup-node@v4
               with:
-                  node-version: '20'
+                  node-version: '22'
               env:
                   NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
             - name: Installing project dependencies

.gitignore

@@ -1,36 +1,44 @@
 # OS generated files #
 .DS_Store
+*.pem
 Thumbs.db
 .tmp/
 
 # IDE generated file #
-.idea/
+/.idea
 
 # PackageManager specific lock files
 pnpm-lock.yaml
 package-lock.json
 yarn.lock
 
 # Node generated files
-node_modules/
-npm-debug.log
-yarn-error.log
+/node_modules
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+/.pnp
+.pnp.js
+.yarn/install-state.gz
 
 # Build process generated files
 .rollup.cache
+*.tsbuildinfo
 tsconfig.build.json
 
 # Test coverage generated folder
-coverage/
+/coverage
 
 # Dist generated folder
-dist/
+/dist
+/build
+.next
 
 # Docs generated folder
 docs/
 
 # Verdaccio storage
-test/verdaccio/storage
+/verdaccio/storage
 
-# Files that may be generated through teting or usage
-project-types/common/tsconfig.json
+# Temporary test folder
+/test/.temp

.husky/commit-msg

@@ -1,32 +1 @@
-# Read parameters
-COMMIT_MSG_FILE=$1
-
-# Set failing on command fail, and undefined variable use
-set -eu
-
-# This hook is invoked by git-commit and git-merge, and can be
-# bypassed with the --no-verify option. It takes a single
-# parameter, the name of the file that holds the proposed commit
-# log message.
-
-# Exiting with a non-zero status causes the command to abort.
-
-# The hook is allowed to edit the message file in place, and can
-# be used to normalize the message into some project standard format.
-# It can also be used to refuse the commit after inspecting the
-# message file.
-
-# The default commit-msg hook, when enabled, detects duplicate
-# Signed-off-by trailers, and aborts the commit if one is found.
-
-# We use this hook to run "commitlint", that verifies that the
-# message sent has the correct format for the project, aborting otherwise.
-
-# Show welcome message
-echo "**************************"
-echo "Linting the commit message"
-echo "**************************"
-echo ""
-
-# Run commitlint
-npx --no -- commitlint --edit ${1}
+NODE_NO_WARNINGS=1 NODE_OPTIONS=--experimental-strip-types zx "./.husky/commit-msg.ts" $@

.husky/commit-msg.ts

@@ -0,0 +1,56 @@
+#!/usr/bin/env zx
+/*
+ * *****************************************************************************
+ * Copyright (C) National University of Quilmes 2018-2024
+ * Gobstones (TM) is a trademark of the National University of Quilmes.
+ *
+ * This program is free software distributed under the terms of the
+ * GNU Affero General Public License version 3.
+ * Additional terms added in compliance to section 7 of such license apply.
+ *
+ * You may read the full license at https://gobstones.github.io/gobstones-guidelines/LICENSE.
+ * *****************************************************************************
+ */
+
+/**
+ * This hook is invoked by git-commit and git-merge, and can be
+ * bypassed with the --no-verify option. It takes a single
+ * parameter, the name of the file that holds the proposed commit
+ * log message.
+ *
+ * Exiting with a non-zero status causes the command to abort.
+ *
+ * The hook is allowed to edit the message file in place, and can
+ * be used to normalize the message into some project standard format.
+ * It can also be used to refuse the commit after inspecting the
+ * message file.
+ *
+ * The default commit-msg hook, when enabled, detects duplicate
+ * Signed-off-by trailers, and aborts the commit if one is found.
+ *
+ * We use this hook to run "commitlint", that verifies that the
+ * message sent has the correct format for the project, aborting otherwise.
+ *
+ *
+ * @author Alan Rodas Bonjour <alanrodas@gmail.com>
+ */
+import process from 'process';
+import { argv, echo, path } from 'zx';
+import { fileURLToPath } from 'url';
+import { $ } from '../.scripts/_helpers.ts';
+
+const HOOKS_DIRECTORY = __dirname || path.dirname(fileURLToPath(import.meta.url));
+const SCRIPTS_DIRECTORY = path.join(path.dirname(HOOKS_DIRECTORY), '.scripts');
+
+const COMMIT_MSG_FILE = argv._.length > 0 ? argv._[0] : undefined;
+
+echo`
+**************************
+Linting the commit message
+**************************
+`;
+
+// Run commitlint
+await $`npx --no -- commitlint --edit "${COMMIT_MSG_FILE}"`;
+
+process.exit(0);