defered-branch 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kasukabe tsumugi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# defered-branch 🚦
+
+A tiny TypeScript/JavaScript library for deferred branching logic.  
+Easily manage conditional execution and fallback handlers in a clean, chainable way!
+
+For more awesome packages, check out [my homepage💛](https://baendlorel.github.io/?repoType=npm)
+
+## Features ✨
+
+- Chainable API for adding branches
+- Only the last matched branch is executed
+- Custom handler for unmatched cases
+- TypeScript support
+- Lightweight and dependency-free
+
+## Installation 📦
+
+```bash
+pnpm add defered-branch
+# or
+npm install defered-branch
+```
+
+## Usage 🚀
+
+```ts
+import { deferBranch } from 'defered-branch';
+
+const result = deferBranch()
+  .add(false, () => 'not this')
+  .add(true, () => 'this branch runs!')
+  .nomatch(() => 'no branch matched')
+  .run();
+
+console.log(result); // 'this branch runs!'
+```
+
+## API Reference 📚
+
+### `deferBranch(): DeferBranch`
+
+Creates a new branch handler.
+
+### `add(condition: boolean, branch: () => any): this`
+
+Adds a branch. If `condition` is true, this branch will be set as the one to run.  
+Multiple calls will override the previous matched branch.
+
+### `nomatch(handler: () => any): this`
+
+Sets a handler to run if no branch matches.
+
+### `run(): any`
+
+Executes the matched branch, or the nomatch handler if none matched.  
+Returns `undefined` if neither is set.
+
+## Example 🧩
+
+```ts
+const branch = deferBranch()
+  .add(false, () => 'A')
+  .add(false, () => 'B')
+  .nomatch(() => 'Fallback!');
+
+console.log(branch.run()); // 'Fallback!'
+```
+
+## Error Handling ⚠️
+
+- Throws `TypeError` if branch or nomatch handler is not a function.
+
+## License 📄
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+declare class DeferBranch {
+  /**
+   * Add a new entry
+   * - will **override** the previous matched branch
+   * @param condition the condition to match
+   * @param branch the branch to run when matched
+   * @returns this
+   */
+  add(condition: boolean, branch: Fn): DeferBranch;
+  /**
+   * When no branch matched, run this handler
+   * @param handler handle the exhausted case
+   * @returns this
+   */
+  nomatch(handler: Fn): DeferBranch;
+  /**
+   * If some branch matched, return its returnValue
+   * - if no branch matched, return the nomatch handler returnValue
+   * - if no branch matched and no nomatch handler, return undefined
+   */
+  run(): unknown;
+}
+/**
+ * ## About
+ * @package DeferedBranch
+ * @author Kasukabe Tsumugi <futami16237@gmail.com>
+ * @version 1.0.0 (Last Update: 2025.09.19 07:27:30.174)
+ * @license MIT
+ * @link https://github.com/baendlorel/defered-branch
+ * @description Sometimes we need to judge something with multiple cases, but the main job should be done later. So we have Defered Branch!
+ * @copyright Copyright (c) 2025 Kasukabe Tsumugi. All rights reserved.
+ */
+declare const deferBranch: () => DeferBranch;
+
+export { deferBranch };
+
+// # from: src/global.d.ts
+type Fn = (...args: unknown[]) => unknown;

package/dist/index.mjs

@@ -0,0 +1 @@
+class t{t=null;h=null;add(t,n){if("function"!=typeof n)throw new TypeError("Branch must be a function");return t&&(this.t=n),this}nomatch(t){if("function"!=typeof t)throw new TypeError("Branch must be a function");return this.h=t,this}run(){return this.t?this.t():this.h?this.h():void 0}}const n=()=>new t;export{n as deferBranch};

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "defered-branch",
+	"version": "1.0.0",
+	"author": {
+		"name": "Kasukabe Tsumugi",
+		"email": "futami16237@gmail.com"
+	},
+	"purpose": "npm",
+	"description": "Sometimes we need to judge something with multiple cases, but the main job should be done later. So we have Defered Branch!",
+	"description_zh": "有时候我们需要根据多个条件来判断某件事，但主要工作应该在之后完成。所以我们有了延迟分支！",
+	"type": "module",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		"types": "./dist/index.d.ts",
+		"import": "./dist/index.mjs",
+		"default": "./dist/index.mjs"
+	},
+	"files": [
+		"dist"
+	],
+	"homepage": "https://github.com/baendlorel/defered-branch#readme",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/baendlorel/defered-branch"
+	},
+	"keywords": [
+		"branch",
+		"assert",
+		"typescript",
+		"javascript"
+	],
+	"scripts": {
+		"test": "clear & vitest",
+		"lint": "oxlint .",
+		"cover": "clear & vitest --coverage",
+		"build": "node ./scripts/rollup.mjs"
+	},
+	"license": "MIT",
+	"devDependencies": {
+		"@rollup/plugin-alias": "^5.1.1",
+		"@rollup/plugin-node-resolve": "^16.0.1",
+		"@rollup/plugin-replace": "^6.0.2",
+		"@rollup/plugin-terser": "^0.4.4",
+		"@rollup/plugin-typescript": "^12.1.4",
+		"@types/node": "^24.5.2",
+		"@vitest/coverage-v8": "^3.2.4",
+		"oxlint": "^1.16.0",
+		"prettier": "^3.6.2",
+		"rimraf": "^6.0.1",
+		"rollup": "^4.50.2",
+		"rollup-plugin-dts": "^6.2.3",
+		"rollup-plugin-dts-merger": "^1.2.4",
+		"tslib": "^2.8.1",
+		"typescript": "^5.9.2",
+		"vitest": "^3.2.4"
+	}
+}