build: use parallelization depending on CPU cores (#1148)

Refs #1147

Author: char0n

.env

@@ -0,0 +1 @@
+CPU_CORES=2

.github/workflows/build.yml

@@ -9,6 +9,9 @@ on:
   pull_request:
     branches: [ main ]
 
+env:
+  CPU_CORES: 2
+
 jobs:
   lint:
     runs-on: ubuntu-latest

.github/workflows/nightly-build.yml

@@ -5,6 +5,9 @@ on:
   schedule:
     - cron:  '30 4 * * *'
 
+env:
+  CPU_CORES: 2
+
 jobs:
   nightly-build:
     runs-on: ubuntu-latest

.github/workflows/release.yml

@@ -4,6 +4,9 @@ on:
     branches:
       - main
 
+env:
+  CPU_CORES: 2
+
 jobs:
   release:
     name: Release

README.md

@@ -114,6 +114,20 @@ Run the following commands to setup the repository for local development:
 
 ### npm scripts
 
+Some npm scripts run in parallel. Default maximum parallelization is set `2`. This is due to the fact
+that our `CI` runs on GitHub Actions which uses GitHub hosted runners with [2-core CPUs](https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners#supported-runners-and-hardware-resources).
+If you have computer with more than 2 CPU cores, you can speed running npm scripts by
+creating an environment variable called `CPU_CORES` and assign it a number of your CPU cores.
+
+Assuming 4 CPU cores are available:
+
+```sh
+  $ export CPU_CORES=4
+  $ npm run build
+```
+
+`build` scripts now runs much faster than before.
+
 **Build artifacts**
 
 ```sh

packages/apidom-ast/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom.ast.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-core/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom.browser.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-ls/package.json

@@ -21,7 +21,7 @@
   "unpkg": "dist/apidom-ls.browser.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward' && copyfiles -u 1 ./src/**/*.json es",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward' && copyfiles -u 1 ./src/**/*.json cjs",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js",

packages/apidom-ns-asyncapi-2/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-ns-openapi3-1.browser.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-ns-openapi-3-1/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-ns-openapi-3-1.browser.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser-adapter-asyncapi-json-2/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-parser-apdater-asyncapi-json-2.browser.min.js",
   "types": "types/adapter.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser-adapter-asyncapi-yaml-2/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-parser-apdater-asyncapi-yaml-2.browser.min.js",
   "types": "types/adapter.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser-adapter-json/package.json

@@ -12,7 +12,7 @@
   "unpkg": "dist/apidom-parser-apdater-json.browser.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "npm run build:wasm && npm run build:wasm:copy && cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "npm run build:wasm && npm run build:wasm:copy && cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "npm run build:wasm && npm run build:wasm:copy && cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser-adapter-openapi-json-3-1/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-parser-apdater-openapi-json-3-1.browser.min.js",
   "types": "types/adapter.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser-adapter-openapi-yaml-3-1/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-parser-apdater-openapi-yaml-3-1.browser.min.js",
   "types": "types/adapter.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser-adapter-yaml-1-2/package.json

@@ -12,7 +12,7 @@
   "unpkg": "dist/apidom-parser-apdater-yaml-1-2.browser.min.js",
   "types": "types/dist.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "npm run build:wasm && npm run build:wasm:copy && cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "npm run build:wasm && npm run build:wasm:copy && cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "npm run build:wasm && npm run build:wasm:copy && cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-parser/package.json

@@ -11,7 +11,7 @@
   "unpkg": "dist/apidom-parser.browser.min.js",
   "types": "types/parser.d.ts",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",

packages/apidom-reference/package.json

@@ -16,7 +16,7 @@
   },
   "unpkg": "dist/apidom-reference.browser.min.js",
   "scripts": {
-    "build": "npm run clean && npm run typescript:declaration && npm run build:es && npm run build:cjs && npm run build:umd:browser",
+    "build": "npm run clean && run-p --max-parallel ${CPU_CORES:-2} typescript:declaration build:es build:cjs build:umd:browser",
     "build:es": "cross-env BABEL_ENV=es babel src --out-dir es --extensions '.ts' --root-mode 'upward'",
     "build:cjs": "cross-env BABEL_ENV=cjs babel src --out-dir cjs --extensions '.ts' --root-mode 'upward'",
     "build:umd:browser": "cross-env BABEL_ENV=browser webpack --config config/webpack/browser.config.js --progress",