serial-task 1.0.0 → 1.1.0

package/README.md

@@ -44,7 +44,7 @@ console.log(result.results); // [6, 12, 11]
 The following diagram shows how functions are called in each iteration of the loop:
 
 <div style="text-align: center">
-  <img src="https://raw.githubusercontent.com/baendlorel/serial-task/main/assets/flow.svg" alt="Execution Flow" width="360" />
+  <img src="https://raw.githubusercontent.com/baendlorel/serial-task/main/assets/flow.svg" alt="Execution Flow" width="80%" style="margin-left:10%; border:4px dashed #eee;border-radius:20px"/>
 </div>
 
 ## 📖 API Reference

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";const t=Reflect.defineProperty,n=Array.isArray,e=Promise.resolve.bind(Promise),r=Promise.reject.bind(Promise),o=t=>("object"==typeof t&&null!==t||"function"==typeof t)&&("then"in t&&"function"==typeof t.then),i=()=>!1,a=i,s=(t,n,e,r,o)=>0===n?r:[o];function u(t){if("object"!=typeof t||null===t)throw new TypeError(": 'options' must be an object");const{name:e="kskbTask",tasks:r,breakCondition:o=i,skipCondition:u=a,resultWrapper:l=s}=t;if("string"!=typeof e)throw new TypeError(": 'name' must be a string or omitted");if(!n(r)||r.some(t=>"function"!=typeof t))throw new TypeError(": 'tasks' must be a function array");if("function"!=typeof o)throw new TypeError(": 'breakCondition' must be a function or omitted");if("function"!=typeof u)throw new TypeError(": 'skipCondition' must be a function or omitted");if("function"!=typeof l)throw new TypeError(": 'resultWrapper' must be a function or omitted");return{name:e,tasks:r,breakCondition:o,skipCondition:u,resultWrapper:l}}function l(t,n,...i){try{const r=t.apply(n,i);return o(r)?r:e(r)}catch(t){return r(t)}}function c(t,n,i){try{const r=t.apply(n,i);return o(r)?r:e(r)}catch(t){return r(t)}}exports.createSerialTask=function(n){const{name:e,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=u(n);if(0===r.length){const n=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(n,"name",{value:e,configurable:!0}),n}const s=function(...t){let n;const e=new Array(r.length);let s=-1;const u=[];for(let l=0;l<r.length;l++){const c=r[l],f=a(c,l,r,t,n);if(o(c,l,r,t,n)){s=l;break}i(c,l,r,t,n)?u.push(l):(n=c.apply(null,f),e[l]=n)}return{value:n,results:e,trivial:!1,breakAt:s,skipped:u}};return t(s,"name",{value:e,configurable:!0}),t(s,"length",{value:r[0].length,configurable:!0}),s},exports.createSerialTaskAsync=function(n){const{name:e,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=u(n);if(0===r.length){const n=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(n,"name",{value:e,configurable:!0}),n}const s=async function(...t){let n;const e=new Array(r.length);let s=-1;const u=[];for(let f=0;f<r.length;f++){const p=r[f],k=await l(a,null,p,f,r,t,n);if(await l(o,null,p,f,r,t,n)){s=f;break}await l(i,null,p,f,r,t,n)?u.push(f):(n=await c(p,null,k),e[f]=n)}return{value:n,results:e,trivial:!1,breakAt:s,skipped:u}};return t(s,"name",{value:e,configurable:!0}),t(s,"length",{value:r[0].length,configurable:!0}),s};

package/dist/index.d.ts

@@ -1,55 +1,3 @@
-/**
- * ## Usage
- * Use this when you have async functions in tasks, conditions or result wrapper
- *
- * Creates an async serial task function that executes a series of functions in order
- * - all given functions(`options.tasks`) will be called in order
- * - generated task function will have the same length as the first task function
- * - you can appoint generated task function's name by `options.name`
- * - **Strongly Recommended**: all task functions have same input type and output type
- *   - returned function.length will be the same as the first task function's length
- * @param opts Options for creating a serial task, details in `SerialTaskOptions`
- * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
- *
- * ## About
- * @package SerialTask
- * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 1.0.0 (Last Update: 2025.08.22 17:05:02.346)
- * @license MIT
- * @link https://github.com/baendlorel/serial-task
- * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
- * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
- */
-declare function createSerialTaskAsync<F extends Fn>(opts: SerialTaskOptions<F>): TaskifyAsync<F>;
-
-/**
- * ## Usage
- * **DO NOT Use** this when you have **async functions** in tasks, conditions or result wrapper
- *
- * Creates a serial task function that executes a series of functions in order.
- * - all given functions(`options.tasks`) will be called in order
- *   - the returned value will be `options.resultWrapper`ed then passed to the next task
- * - generated task function will have the same length as the first task function
- * - you can appoint generated task function's name by `options.name`
- * - **Strongly Recommended**: all task functions have same input type and output type
- *   - returned function.length will be the same as the first task function's length
- * @param opts Options for creating a serial task, details in `SerialTaskOptions`
- * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
- *
- * ## About
- * @package SerialTask
- * @author Kasukabe Tsumugi <futami16237@gmail.com>
- * @version 1.0.0 (Last Update: 2025.08.22 17:05:02.346)
- * @license MIT
- * @link https://github.com/baendlorel/serial-task
- * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
- * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
- */
-declare function createSerialTask<F extends Fn>(opts: SerialTaskOptions<F>): Taskify<F>;
-
-export { createSerialTask, createSerialTaskAsync };
-
-// # from: src/global.d.ts
 /* eslint-disable @typescript-eslint/no-explicit-any */
 type Fn = (...args: any[]) => any;
 
@@ -134,13 +82,7 @@ interface SerialTaskOptions<F extends Fn> {
    * }
    * ```
    */
-  resultWrapper?: (
-    task: F,
-    index: number,
-    tasks: F[],
-    args: Parameters<F>,
-    lastReturn: ReturnType<F>
-  ) => unknown[];
+  resultWrapper?: (task: F, index: number, tasks: F[], args: Parameters<F>, lastReturn: ReturnType<F>) => unknown[];
 
   /**
    * Break the loop and return the last result immediately when this function returns `true`
@@ -153,13 +95,7 @@ interface SerialTaskOptions<F extends Fn> {
    * @param args input value of the whole serial task
    * @param lastReturn returned value of the last task function
    */
-  breakCondition?: (
-    task: F,
-    index: number,
-    tasks: F[],
-    args: Parameters<F>,
-    lastReturn: ReturnType<F>
-  ) => boolean;
+  breakCondition?: (task: F, index: number, tasks: F[], args: Parameters<F>, lastReturn: ReturnType<F>) => boolean;
 
   /**
    * Give `true` to skip this task item
@@ -172,13 +108,59 @@ interface SerialTaskOptions<F extends Fn> {
    * @param args input value of the whole serial task
    * @param lastReturn returned value of the last task function
    */
-  skipCondition?: (
-    task: F,
-    index: number,
-    tasks: F[],
-    args: Parameters<F>,
-    lastReturn: ReturnType<F>
-  ) => boolean;
+  skipCondition?: (task: F, index: number, tasks: F[], args: Parameters<F>, lastReturn: ReturnType<F>) => boolean;
 }
 
-type StrictSerialTaskOptions<F extends Fn> = Required<SerialTaskOptions<F>>;
+/**
+ * ## Usage
+ * Use this when you have async functions in tasks, conditions or result wrapper
+ *
+ * Creates an async serial task function that executes a series of functions in order
+ * - all given functions(`options.tasks`) will be called in order
+ * - generated task function will have the same length as the first task function
+ * - you can appoint generated task function's name by `options.name`
+ * - **Strongly Recommended**: all task functions have same input type and output type
+ *   - returned function.length will be the same as the first task function's length
+ * @param opts Options for creating a serial task, details in `SerialTaskOptions`
+ * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
+ *
+ * ## About
+ * @package 
+ * @author Kasukabe Tsumugi <futami16237@gmail.com>
+ * @version 1.1.0 (Last Update: 2025.10.20 21:39:55.158)
+ * @license MIT
+ * @link https://github.com/baendlorel/serial-task
+ * @link https://baendlorel.github.io/ Welcome to my site!
+ * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
+ * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
+ */
+declare function createSerialTaskAsync<F extends Fn>(opts: SerialTaskOptions<F>): TaskifyAsync<F>;
+
+/**
+ * ## Usage
+ * **DO NOT Use** this when you have **async functions** in tasks, conditions or result wrapper
+ *
+ * Creates a serial task function that executes a series of functions in order.
+ * - all given functions(`options.tasks`) will be called in order
+ *   - the returned value will be `options.resultWrapper`ed then passed to the next task
+ * - generated task function will have the same length as the first task function
+ * - you can appoint generated task function's name by `options.name`
+ * - **Strongly Recommended**: all task functions have same input type and output type
+ *   - returned function.length will be the same as the first task function's length
+ * @param opts Options for creating a serial task, details in `SerialTaskOptions`
+ * @returns a funtcion that executes the tasks in order, returns `TaskReturn<OriginalReturn>`
+ *
+ * ## About
+ * @package 
+ * @author Kasukabe Tsumugi <futami16237@gmail.com>
+ * @version 1.1.0 (Last Update: 2025.10.20 21:39:55.158)
+ * @license MIT
+ * @link https://github.com/baendlorel/serial-task
+ * @link https://baendlorel.github.io/ Welcome to my site!
+ * @description Put a list of functions in and get a composed task function. Similar to functional programming's compose (function composition), but with more fine-grained and precise control, and the generated task incurs almost no runtime overhead. Supports both synchronous and asynchronous functions.
+ * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
+ */
+declare function createSerialTask<F extends Fn>(opts: SerialTaskOptions<F>): Taskify<F>;
+
+export { createSerialTask, createSerialTaskAsync };
+export type { SerialTaskOptions, TaskReturn, Taskify, TaskifyAsync };

package/dist/index.mjs

@@ -1 +1 @@
-const t=Reflect.defineProperty,e=Array.isArray,n=Promise.resolve.bind(Promise),r=Promise.reject.bind(Promise),o=t=>("object"==typeof t&&null!==t||"function"==typeof t)&&("then"in t&&"function"==typeof t.then),i=()=>!1,a=i,s=(t,e,n,r,o)=>0===e?r:[o];function u(t){if("object"!=typeof t||null===t)throw new TypeError("SerialTask: 'options' must be an object");const{name:n="kskbTask",tasks:r,breakCondition:o=i,skipCondition:u=a,resultWrapper:l=s}=t;if("string"!=typeof n)throw new TypeError("SerialTask: 'name' must be a string or omitted");if(!e(r)||r.some(t=>"function"!=typeof t))throw new TypeError("SerialTask: 'tasks' must be a function array");if("function"!=typeof o)throw new TypeError("SerialTask: 'breakCondition' must be a function or omitted");if("function"!=typeof u)throw new TypeError("SerialTask: 'skipCondition' must be a function or omitted");if("function"!=typeof l)throw new TypeError("SerialTask: 'resultWrapper' must be a function or omitted");return{name:n,tasks:r,breakCondition:o,skipCondition:u,resultWrapper:l}}function l(t,e,...i){try{const r=t.apply(e,i);return o(r)?r:n(r)}catch(t){return r(t)}}function c(t,e,i){try{const r=t.apply(e,i);return o(r)?r:n(r)}catch(t){return r(t)}}function f(e){const{name:n,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=u(e);if(0===r.length){const e=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(e,"name",{value:n,configurable:!0}),e}const s=async function(...t){let e;const n=new Array(r.length);let s=-1;const u=[];for(let f=0;f<r.length;f++){const p=r[f],k=await l(a,null,p,f,r,t,e);if(await l(o,null,p,f,r,t,e)){s=f;break}await l(i,null,p,f,r,t,e)?u.push(f):(e=await c(p,null,k),n[f]=e)}return{value:e,results:n,trivial:!1,breakAt:s,skipped:u}};return t(s,"name",{value:n,configurable:!0}),t(s,"length",{value:r[0].length,configurable:!0}),s}function p(e){const{name:n,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=u(e);if(0===r.length){const e=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(e,"name",{value:n,configurable:!0}),e}const s=function(...t){let e;const n=new Array(r.length);let s=-1;const u=[];for(let l=0;l<r.length;l++){const c=r[l],f=a(c,l,r,t,e);if(o(c,l,r,t,e)){s=l;break}i(c,l,r,t,e)?u.push(l):(e=c.apply(null,f),n[l]=e)}return{value:e,results:n,trivial:!1,breakAt:s,skipped:u}};return t(s,"name",{value:n,configurable:!0}),t(s,"length",{value:r[0].length,configurable:!0}),s}export{p as createSerialTask,f as createSerialTaskAsync};
+const t=Reflect.defineProperty,n=Array.isArray,e=Promise.resolve.bind(Promise),r=Promise.reject.bind(Promise),o=t=>("object"==typeof t&&null!==t||"function"==typeof t)&&("then"in t&&"function"==typeof t.then),i=()=>!1,a=i,u=(t,n,e,r,o)=>0===n?r:[o];function s(t){if("object"!=typeof t||null===t)throw new TypeError(": 'options' must be an object");const{name:e="kskbTask",tasks:r,breakCondition:o=i,skipCondition:s=a,resultWrapper:l=u}=t;if("string"!=typeof e)throw new TypeError(": 'name' must be a string or omitted");if(!n(r)||r.some(t=>"function"!=typeof t))throw new TypeError(": 'tasks' must be a function array");if("function"!=typeof o)throw new TypeError(": 'breakCondition' must be a function or omitted");if("function"!=typeof s)throw new TypeError(": 'skipCondition' must be a function or omitted");if("function"!=typeof l)throw new TypeError(": 'resultWrapper' must be a function or omitted");return{name:e,tasks:r,breakCondition:o,skipCondition:s,resultWrapper:l}}function l(t,n,...i){try{const r=t.apply(n,i);return o(r)?r:e(r)}catch(t){return r(t)}}function c(t,n,i){try{const r=t.apply(n,i);return o(r)?r:e(r)}catch(t){return r(t)}}function f(n){const{name:e,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=s(n);if(0===r.length){const n=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(n,"name",{value:e,configurable:!0}),n}const u=async function(...t){let n;const e=new Array(r.length);let u=-1;const s=[];for(let f=0;f<r.length;f++){const p=r[f],k=await l(a,null,p,f,r,t,n);if(await l(o,null,p,f,r,t,n)){u=f;break}await l(i,null,p,f,r,t,n)?s.push(f):(n=await c(p,null,k),e[f]=n)}return{value:n,results:e,trivial:!1,breakAt:u,skipped:s}};return t(u,"name",{value:e,configurable:!0}),t(u,"length",{value:r[0].length,configurable:!0}),u}function p(n){const{name:e,tasks:r,breakCondition:o,skipCondition:i,resultWrapper:a}=s(n);if(0===r.length){const n=()=>({value:void 0,results:[],trivial:!0,breakAt:-1,skipped:[]});return t(n,"name",{value:e,configurable:!0}),n}const u=function(...t){let n;const e=new Array(r.length);let u=-1;const s=[];for(let l=0;l<r.length;l++){const c=r[l],f=a(c,l,r,t,n);if(o(c,l,r,t,n)){u=l;break}i(c,l,r,t,n)?s.push(l):(n=c.apply(null,f),e[l]=n)}return{value:n,results:e,trivial:!1,breakAt:u,skipped:s}};return t(u,"name",{value:e,configurable:!0}),t(u,"length",{value:r[0].length,configurable:!0}),u}export{p as createSerialTask,f as createSerialTaskAsync};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "serial-task",
-	"version": "1.0.0",
+	"version": "1.1.0",
 	"author": {
 		"name": "Kasukabe Tsumugi",
 		"email": "futami16237@gmail.com"
@@ -29,15 +29,14 @@
 		"javascript"
 	],
 	"scripts": {
+		"lines": "clear && find ./src -type f \\( -name \"*.ts\" -o -name \"*.tsx\" -o -name \"*.js\" -o -name \"*.mjs\" -o -name \"*.cjs\" -o -name \"*.cpp\" -o -name \"*.h\" -o -name \"*.py\"  -o -name \"*.css\" -o -name \"*.rs\" -o -name \"*.rc\" \\) | xargs wc -l",
 		"test": "clear & vitest",
 		"lint": "oxlint .",
 		"cover": "clear & vitest --coverage",
-		"build": "node ./scripts/rollup.mjs"
+		"build": "tsx ./.scripts/rollup.ts"
 	},
 	"license": "MIT",
 	"devDependencies": {
-		"@babel/plugin-proposal-decorators": "^7.28.0",
-		"@babel/preset-env": "^7.28.3",
 		"@rollup/plugin-alias": "^5.1.1",
 		"@rollup/plugin-babel": "^6.0.4",
 		"@rollup/plugin-commonjs": "^28.0.6",