[refactor] transform .execute() from Recursion to Iteration (#1)

TechQuery · web-flow · commit 0497d47a6906 · 2024-09-03T03:11:42.000+08:00
diff --git a/.eslintrc.json b/.eslintrc.json
@@ -8,5 +8,13 @@
     "parserOptions": {
         "sourceType": "module"
     },
-    "extends": ["eslint:recommended", "plugin:prettier/recommended"]
+    "plugins": ["@typescript-eslint"],
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "prettier"
+    ],
+    "rules": {
+        "@typescript-eslint/no-explicit-any": "warn"
+    }
 }
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -0,0 +1,36 @@
+name: CI & CD
+on:
+    push:
+        tags:
+            - v*
+jobs:
+    Build-and-Publish:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: write
+            id-token: write
+        steps:
+            - uses: actions/checkout@v4
+
+            - uses: pnpm/action-setup@v4
+              with:
+                  version: 9
+            - uses: actions/setup-node@v4
+              with:
+                  node-version: 20
+                  registry-url: https://registry.npmjs.org
+                  cache: pnpm
+            - name: Install Dependencies
+              run: pnpm i --frozen-lockfile
+
+            - name: Build & Publish
+              run: npm publish
+              env:
+                  NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+            - name: Update document
+              uses: peaceiris/actions-gh-pages@v3
+              with:
+                  publish_dir: ./docs
+                  personal_token: ${{ secrets.GITHUB_TOKEN }}
+                  force_orphan: true
diff --git a/.gitignore b/.gitignore
@@ -1,18 +1,16 @@
 # Node.JS
 node_modules/
 package-lock.json
+yarn.lock
 
 # Building
 dist/
 .rts2_cache_*/
 docs/
 
 # IDE
-.vscode/
+.vscode/settings.json
 .idea/
 
-# Online platform
-.github/
-
 # OS
 .DS_Store
diff --git a/.husky/pre-commit b/.husky/pre-commit
@@ -0,0 +1 @@
+npm test
diff --git a/.husky/pre-push b/.husky/pre-push
@@ -0,0 +1 @@
+npm run build
diff --git a/.npmignore b/.npmignore
@@ -3,4 +3,6 @@
 test/
 .rts2_cache_*/
 docs/
-.travis.yml
+.vscode/
+.husky/
+.github/
diff --git a/.npmrc b/.npmrc
@@ -0,0 +1,2 @@
+provenance = true
+auto-install-peers = false
diff --git a/.travis.yml b/.travis.yml
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -0,0 +1,17 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug Jest",
+            "type": "node",
+            "request": "launch",
+            "runtimeArgs": [
+                "--inspect-brk",
+                "${workspaceRoot}/node_modules/jest/bin/jest.js",
+                "--runInBand"
+            ],
+            "console": "integratedTerminal",
+            "internalConsoleOptions": "neverOpen"
+        }
+    ]
+}
diff --git a/ReadMe.md b/ReadMe.md
@@ -2,21 +2,21 @@
 
 **Middleware** framework based on [Async Generator][1] & [TypeScript][2], inspired by [Koa 2][3].
 
-[![NPM Dependency](https://david-dm.org/TechQuery/onion-stack.svg)][4]
-[![Build Status](https://travis-ci.com/TechQuery/onion-stack.svg?branch=master)][5]
+[![NPM Dependency](https://img.shields.io/librariesio/github/TechQuery/onion-stack.svg)][4]
+[![CI & CD](https://github.com/TechQuery/onion-stack/actions/workflows/main.yml/badge.svg)][5]
 [![](https://data.jsdelivr.com/v1/package/npm/onion-stack/badge?style=rounded)][6]
 
 [![NPM](https://nodei.co/npm/onion-stack.png?downloads=true&downloadRank=true&stars=true)][7]
 
 ## Example
 
-```JavaScript
+```javascript
 import OnionStack from 'onion-stack';
 
-const list = [ ];
+const list = [];
 
 const stack = new OnionStack(
-    function*() {
+    function* () {
         list.push(1);
 
         yield;
@@ -27,7 +27,7 @@ const stack = new OnionStack(
 
         list.push(3);
     },
-    async function*() {
+    async function* () {
         await delay(0.1);
 
         list.push(4);
@@ -36,20 +36,20 @@ const stack = new OnionStack(
 
         list.push(5);
     },
-    function() {
+    function () {
         list.push(6);
     }
 );
 
-stack.execute().then(() => console.log( list ));    //  [1, 4, 6, 5, 2]
+stack.execute().then(() => console.log(list)); //  [1, 4, 6, 5, 2]
 ```
 
 [More cases](https://github.com/TechQuery/onion-stack/tree/master/test)
 
 [1]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for-await...of#Iterating_over_async_generators
 [2]: https://www.typescriptlang.org
 [3]: https://koajs.com
-[4]: https://david-dm.org/TechQuery/onion-stack
-[5]: https://travis-ci.com/TechQuery/onion-stack
+[4]: https://libraries.io/npm/onion-stack
+[5]: https://github.com/TechQuery/onion-stack/actions/workflows/main.yml
 [6]: https://www.jsdelivr.com/package/npm/onion-stack
 [7]: https://nodei.co/npm/onion-stack/
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
     "name": "onion-stack",
-    "version": "0.3.1",
+    "version": "0.3.2",
     "description": "Middleware framework based on Async Generator of ECMAScript 2018, inspired by Koa 2",
     "keywords": [
         "middleware",
@@ -24,59 +24,47 @@
     "main": "dist/onion-stack.umd.js",
     "module": "dist/onion-stack.js",
     "scripts": {
+        "prepare": "husky",
         "lint": "lint-staged",
-        "pack-docs": "typedoc --name \"Onion Stack\" --out docs/ source/",
-        "build": "rm -rf dist/  &&  microbundle --name=OnionStack  &&  npm run pack-docs",
+        "pack-docs": "rm -rf docs/  &&  typedoc source/",
+        "pack-dist": "rm -rf dist/  &&  microbundle --name=OnionStack",
+        "build": "npm run pack-dist  &&  npm run pack-docs",
         "debug": "node --inspect node_modules/jest/bin/jest --runInBand",
         "test": "lint-staged  &&  jest",
         "prepublishOnly": "npm test  &&  npm run build",
         "help": "npm run pack-docs  &&  open-cli docs/index.html"
     },
     "lint-staged": {
-        "*.{md,json,yml}": [
-            "prettier --write",
-            "git add"
-        ],
+        "*.{md,json,yml}": "prettier --write",
         "*.ts": [
             "prettier --write",
-            "eslint --fix",
-            "git add"
+            "eslint --fix"
         ]
     },
-    "husky": {
-        "hooks": {
-            "pre-commit": "npm test",
-            "pre-push": "npm run build"
-        }
-    },
     "devDependencies": {
-        "@types/jest": "^24.0.23",
-        "@typescript-eslint/parser": "^2.8.0",
-        "eslint": "^6.7.0",
-        "eslint-config-prettier": "^6.7.0",
-        "eslint-plugin-prettier": "^3.1.1",
-        "husky": "^3.1.0",
-        "jest": "^24.9.0",
-        "lint-staged": "^9.4.3",
-        "microbundle": "^0.11.0",
-        "open-cli": "^5.0.0",
-        "prettier": "^1.19.1",
-        "ts-jest": "^24.2.0",
-        "typedoc": "^0.15.3",
-        "typescript": "^3.7.2"
+        "@types/jest": "^29.5.12",
+        "@typescript-eslint/eslint-plugin": "^8.3.0",
+        "@typescript-eslint/parser": "^8.3.0",
+        "eslint": "^8.57.0",
+        "eslint-config-prettier": "^9.1.0",
+        "husky": "^9.1.5",
+        "jest": "^29.7.0",
+        "lint-staged": "^15.2.10",
+        "microbundle": "^0.15.1",
+        "open-cli": "^8.0.0",
+        "prettier": "^3.3.3",
+        "ts-jest": "^29.2.5",
+        "typedoc": "^0.26.6",
+        "typedoc-plugin-mdn-links": "^3.2.11",
+        "typescript": "^5.5.4"
     },
     "prettier": {
-        "tabWidth": 4,
-        "singleQuote": true
+        "singleQuote": true,
+        "trailingComma": "none",
+        "arrowParens": "avoid",
+        "tabWidth": 4
     },
     "jest": {
-        "preset": "ts-jest",
-        "testEnvironment": "node",
-        "testRegex": "/test/.*\\.(test|spec)?\\.ts$",
-        "moduleFileExtensions": [
-            "js",
-            "ts",
-            "json"
-        ]
+        "preset": "ts-jest"
     }
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/source/index.ts b/source/index.ts
diff --git a/test/index.spec.ts b/test/index.spec.ts
diff --git a/tsconfig.json b/tsconfig.json

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+provenance = true`
	`2`	`+auto-install-peers = false`