modern-ts 0.8.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but not
+      limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2024-2026 HiraethCyan
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,223 @@
+# modern-ts
+
+<div align="center">
+
+**A Modern TypeScript Standard Suite**
+
+Self-contained · Zero Dependencies · 100% Coverage · Tree-shakeable · High Performance
+
+</div>
+
+> ⚠️ **Beta Notice**: Currently in beta phase, collecting community feedback. API may undergo breaking changes at any time. Use with caution in production environments.
+
+---
+
+## Features
+
+- **Self-contained**: No runtime dependencies, ready to use out of the box
+- **Zero Dependencies**: Keeps the project lightweight, avoids supply chain risks
+- **100% Coverage**: Comprehensive test coverage ensures code quality
+- **Tree-shakeable**: Supports tree-shaking for on-demand imports
+- **High Performance**: Key modules are deeply optimized, outperforming similar libraries
+
+## Module Overview
+
+### 🔄 Concurrent — Concurrency Primitives
+
+A comprehensive collection of system-level concurrency primitives:
+
+| Submodule     | Description                                                                     |
+| ------------- | ------------------------------------------------------------------------------- |
+| **Lock**      | `Mutex`, `Semaphore`, `ConditionVariable`, `RwLock` and other concurrency locks |
+| **Valve**     | `TokenBucket`, `LeakyBucket`, `SlidingWindow`, `CircuitBreaker` flow control    |
+| **Limit**     | Concurrent task quantity control (more complete than `p-limit`)                 |
+| **Channel**   | Go language CSP model implementation                                            |
+| **Scheduler** | CFS-Like cooperative async scheduler                                            |
+| **TaskScope** | Structured concurrency scope                                                    |
+
+### ⏰ MockClock — Mock Clock
+
+A mock clock based on `AsyncLocalStorage`, supports concurrent testing with deep simulation of `NodeJS.Timeout` handles.
+
+### 🎭 Monad — Common Functional Primitives
+
+| Module     | Purpose              |
+| ---------- | -------------------- |
+| **Result** | Error handling       |
+| **Maybe**  | Optional values      |
+| **Reader** | Dependency injection |
+
+### 🛠️ Utils — Utility Functions
+
+A comprehensive utility function library (similar to `lodash`):
+
+- Type-safe `curry` / `pipe` (supports placeholders and deep inference)
+- High-performance `debounce` / `throttle` (more robust edge handling than `lodash`)
+- Deep copy `cloneDeep` (supports circular references, stack-based implementation, handles 100k+ nesting levels)
+- Common type utilities, array, object, function, string, Map/Set utility functions
+
+### 🌐 FetchQ — HTTP Client
+
+A feature-rich HTTP client using the Result pattern.
+
+### ✅ Fit — Schema Validation
+
+A type-first, tree-shakeable, and highly extensible schema validation library.
+
+### 📦 Other Modules
+
+| Module           | Description                                                                                                                   |
+| ---------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| **Other**        | Common data structures (Deque, Heap, Queue, Stack, DisjointSet) and utility functions                                         |
+| **Resource**     | RAII resource manager based on `using`                                                                                        |
+| **Flow**         | RxJS-like reactive primitives with inversion of control                                                                       |
+| **EventEmitter** | Cross-platform EventEmitter with nearly identical behavior and superior performance metrics compared to Node.js native module |
+
+## Installation
+
+```bash
+# pnpm
+pnpm add modern-ts
+
+# npm
+npm install modern-ts
+
+# yarn
+yarn add modern-ts
+```
+
+## Quick Start
+
+### Import Methods
+
+The library supports multiple import methods:
+
+```typescript
+// Import all
+import * as Modern from 'modern-ts';
+
+// Import by namespace
+import { Result, Maybe } from 'modern-ts';
+
+// Subpath import (tree-shaking optimized)
+import { Ok, Err } from 'modern-ts/Result';
+import { Some, None } from 'modern-ts/Maybe';
+import { Mutex } from 'modern-ts/Concurrent';
+import { debounce, throttle } from 'modern-ts/Utils';
+```
+
+### Example: Result Error Handling
+
+```typescript
+import { Ok, Err, Result, isOk } from 'modern-ts/Result';
+
+function divide(a: number, b: number): Result<number, string> {
+  if (b === 0) return Err('Division by zero');
+  return Ok(a / b);
+}
+
+const result = divide(10, 2);
+if (isOk(result)) {
+  console.log(result.value); // 5
+}
+```
+
+### Example: Fit Schema Validation
+
+```typescript
+import * as f from 'modern-ts/Fit';
+
+const UserSchema = f
+  .fit<{name: string; age: number; tags: string[]} | 'VIP'>()
+  .off((v) => v === 'VIP', 'ok') // Short-circuit return 'ok' if VIP
+  .toShaped({
+    name: f.String().that(f.min_len(2)),
+    age: f.Number().that(f.range(0, 150)),
+    tags: f.items(f.String()),
+  });
+
+const result = f.validate({name: 'Alice', age: 25, tags: ['dev']}, UserSchema);
+/*
+result.ok === true, result.value is the validated object with type:
+"ok" | {
+    name: string;
+    age: number;
+    tags: string[];
+}
+*/
+```
+
+### Example: MockClock Concurrent Time Simulation
+
+```typescript
+import { MockClock, withTimelineAsync } from 'modern-ts/VirtualTime';
+
+// Concurrent testing: two independent timelines, isolated from each other
+const [t1, t2] = await Promise.all([
+  withTimelineAsync(MockClock(), async (clock) => {
+    clock.setSystemTime(1000); // Set start time
+    return Date.now(); // 1000
+  }),
+  withTimelineAsync(MockClock(), async (clock) => {
+    clock.setSystemTime(2000); // Different start time
+    return Date.now(); // 2000
+  }),
+]);
+// t1 === 1000, t2 === 2000 (timeline isolation)
+```
+
+### Example: Scheduler Cooperative Scheduling
+
+```typescript
+import { Scheduler } from 'modern-ts/Concurrent';
+
+const scheduler = new Scheduler(1);
+const log: string[] = [];
+
+// Tasks yield control via pause() for cooperative scheduling
+await Promise.all([
+  scheduler.add(async (_, pause) => {
+    log.push('A-start');
+    await pause({ nice: 10 }); // Lower priority, yield execution
+    log.push('A-resume');
+  }),
+  scheduler.add(() => log.push('B-run'), { nice: -5 }), // Higher priority
+]);
+
+// Execution order: A-start → B-run → A-resume
+```
+
+## Subpath Exports
+
+| Path                    | Description                 |
+| ----------------------- | --------------------------- |
+| `modern-ts/Result`      | Result error handling       |
+| `modern-ts/Maybe`       | Maybe optional values       |
+| `modern-ts/Reader`      | Reader dependency injection |
+| `modern-ts/ReaderT`     | ReaderT monad transformer   |
+| `modern-ts/Resource`    | RAII resource management    |
+| `modern-ts/TxScope`     | RAII transaction scope      |
+| `modern-ts/Lazy`        | Lazy evaluation             |
+| `modern-ts/LiteQ`       | Lightweight queue           |
+| `modern-ts/Fit`         | Schema validation           |
+| `modern-ts/VirtualTime` | Virtual time                |
+| `modern-ts/Concurrent`  | Concurrency primitives      |
+| `modern-ts/Reactive`    | Reactive primitives         |
+| `modern-ts/Utils`       | Utility functions           |
+| `modern-ts/Arr`         | Array utilities             |
+| `modern-ts/Str`         | String utilities            |
+| `modern-ts/Sets`        | Set utilities               |
+| `modern-ts/Maps`        | Map utilities               |
+
+## API Documentation
+
+For detailed API documentation, see the [docs/en](./docs/en) directory.
+
+## Requirements
+
+- Node.js >= 20
+- TypeScript >= 5.0
+
+## License
+
+[Apache-2.0](./LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,223 @@
+# modern-ts
+
+<div align="center">
+
+**一个现代 TypeScript 标准套件**
+
+自包含 · 零依赖 · 100% 覆盖率 · 摇树友好 · 高性能
+
+</div>
+
+> ⚠️ **测试版本提示**：当前处于测试阶段，正在收集社区反馈。API 可能随时发生破坏性更新，请谨慎用于生产环境
+
+***
+
+## 特性
+
+- **自包含**：无任何运行时依赖，开箱即用
+- **零依赖**：保持项目轻量，避免供应链风险
+- **100% 覆盖率**：完善的测试覆盖，确保代码质量
+- **摇树友好**：支持 Tree-shaking，按需引入
+- **高性能**：关键模块经过深度优化，性能优于同类库
+
+## 模块概览
+
+### 🔄 Concurrent — 并发原语
+
+完善的系统级并发原语集合：
+
+| 子模块           | 说明                                                                |
+| ------------- | ----------------------------------------------------------------- |
+| **Lock**      | `Mutex`、`Semaphore`、`ConditionVariable`、`RwLock` 等并发锁             |
+| **Valve**     | `TokenBucket`、`LeakyBucket`、`SlidingWindow`、`CircuitBreaker` 流量控制 |
+| **Limit**     | 并发任务数量控制（比 `p-limit` 更完善）                                        |
+| **Channel**   | Go 语言 CSP 模型实现                                                    |
+| **Scheduler** | CFS-Like 协作式异步调度器                                                 |
+| **TaskScope** | 结构化并发作用域                                                          |
+
+### ⏰ MockClock — 模拟时钟
+
+基于 `AsyncLocalStorage` 的模拟时钟，支持并发测试，深度模拟 `NodeJS.Timeout` 句柄。
+
+### 🎭 Monad — 常用的函数式原语
+
+| 模块         | 用途    |
+| ---------- | ----- |
+| **Result** | 错误处理  |
+| **Maybe**  | 可选值处理 |
+| **Reader** | 依赖注入  |
+
+### 🛠️ Utils — 工具函数
+
+完善的工具函数库（近似 `lodash`）：
+
+- 类型安全的 `curry` / `pipe`（支持占位符和深层推导）
+- 高性能 `debounce` / `throttle`（边缘处理比`lodash`更健壮）
+- 深拷贝 `cloneDeep`（支持循环引用，手写栈实现，十万级嵌套）
+- 常用类型工具、数组、对象、函数、字符串、Map/Set 工具函数
+
+### 🌐 FetchQ — HTTP 客户端
+
+支持复杂功能、采用 Result 模式的 HTTP 客户端。
+
+### ✅ Fit — Schema 验证
+
+类型优先、摇树友好、扩展性极强的 Schema 验证库。
+
+### 📦 其他模块
+
+| 模块               | 说明                                              |
+| ---------------- | ----------------------------------------------- |
+| **Other**        | 常用数据结构（Deque、Heap、Queue、Stack、DisjointSet）及工具函数 |
+| **Resource**     | 基于 `using` 的 RAII 资源管理器                         |
+| **Flow**         | 类似 RxJS 的响应式原语，支持控制权反转                          |
+| **EventEmitter** | 跨平台 EventEmitter，行为几乎无异的同时多项性能指标优于 Node.js 原生模块 |
+
+## 安装
+
+```bash
+# pnpm
+pnpm add modern-ts
+
+# npm
+npm install modern-ts
+
+# yarn
+yarn add modern-ts
+```
+
+## 快速开始
+
+### 导入方式
+
+库支持多种导入方式：
+
+```typescript
+// 导入所有
+import * as Modern from 'modern-ts';
+
+// 按命名空间导入
+import { Result, Maybe } from 'modern-ts';
+
+// 子路径导入（摇树优化）
+import { Ok, Err } from 'modern-ts/Result';
+import { Some, None } from 'modern-ts/Maybe';
+import { Mutex } from 'modern-ts/Concurrent';
+import { debounce, throttle } from 'modern-ts/Utils';
+```
+
+### 示例：Result 错误处理
+
+```typescript
+import { Ok, Err, Result, isOk } from 'modern-ts/Result';
+
+function divide(a: number, b: number): Result<number, string> {
+  if (b === 0) return Err('Division by zero');
+  return Ok(a / b);
+}
+
+const result = divide(10, 2);
+if (isOk(result)) {
+  console.log(result.value); // 5
+}
+```
+
+### 示例：Fit Schema 验证
+
+```typescript
+import * as f from 'modern-ts/Fit';
+
+const UserSchema = f
+  .fit<{name: string; age: number; tags: string[]} | 'VIP'>()
+  .off((v) => v === 'VIP', 'ok') // 如果是VIP，直接短路返回ok
+  .toShaped({
+    name: f.String().that(f.min_len(2)),
+    age: f.Number().that(f.range(0, 150)),
+    tags: f.items(f.String()),
+  });
+
+const result = f.validate({name: 'Alice', age: 25, tags: ['dev']}, UserSchema);
+/*
+result.ok === true, result.value 为验证后的对象，类型如下：
+"ok" | {
+    name: string;
+    age: number;
+    tags: string[];
+}
+*/
+```
+
+### 示例：MockClock 并发时间模拟
+
+```typescript
+import { MockClock, withTimelineAsync } from 'modern-ts/VirtualTime';
+
+// 并发测试：两个独立时间线，互不干扰
+const [t1, t2] = await Promise.all([
+  withTimelineAsync(MockClock(), async (clock) => {
+    clock.setSystemTime(1000); // 设置起始时间
+    return Date.now(); // 1000
+  }),
+  withTimelineAsync(MockClock(), async (clock) => {
+    clock.setSystemTime(2000); // 不同的起始时间
+    return Date.now(); // 2000
+  }),
+]);
+// t1 === 1000, t2 === 2000（时间线隔离）
+```
+
+### 示例：Scheduler 协作式调度
+
+```typescript
+import { Scheduler } from 'modern-ts/Concurrent';
+
+const scheduler = new Scheduler(1);
+const log: string[] = [];
+
+// 任务通过 pause() 让出控制权，实现协作式调度
+await Promise.all([
+  scheduler.add(async (_, pause) => {
+    log.push('A-start');
+    await pause({ nice: 10 }); // 降低优先级，让出执行权
+    log.push('A-resume');
+  }),
+  scheduler.add(() => log.push('B-run'), { nice: -5 }), // 高优先级
+]);
+
+// 执行顺序: A-start → B-run → A-resume
+```
+
+## 子路径导出
+
+| 路径                      | 说明            |
+| ----------------------- | ------------- |
+| `modern-ts/Result`      | Result 错误处理   |
+| `modern-ts/Maybe`       | Maybe 可选值     |
+| `modern-ts/Reader`      | Reader 依赖注入   |
+| `modern-ts/ReaderT`     | ReaderT 单子转换器 |
+| `modern-ts/Resource`    | RAII 资源管理     |
+| `modern-ts/TxScope`     | RAII 事务作用域    |
+| `modern-ts/Lazy`        | 延迟计算          |
+| `modern-ts/LiteQ`       | 轻量级队列         |
+| `modern-ts/Fit`         | Schema 验证     |
+| `modern-ts/VirtualTime` | 虚拟时间          |
+| `modern-ts/Concurrent`  | 并发原语          |
+| `modern-ts/Reactive`    | 响应式原语         |
+| `modern-ts/Utils`       | 工具函数          |
+| `modern-ts/Arr`         | 数组工具          |
+| `modern-ts/Str`         | 字符串工具         |
+| `modern-ts/Sets`        | Set 工具        |
+| `modern-ts/Maps`        | Map 工具        |
+
+## API 文档
+
+详细的 API 文档请参阅 [docs/zh-CN](./docs/zh-CN) 目录）
+
+## 环境要求
+
+- Node.js >= 20
+- TypeScript >= 5.0
+
+## 许可证
+
+[Apache-2.0](./LICENSE)

package/dist/chunks/Errors-BWEYu-AB.cjs

@@ -0,0 +1,2 @@
+"use strict";class e extends Error{constructor(r){super(r),this.name="UseAfterFreeError",typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,e)}}class t extends Error{constructor(r){super(r),this.name="LockError",typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,t)}}class c extends t{constructor(r){super(r),this.name="MutexError",typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,c)}}class o extends t{constructor(r){super(r),this.name="RWLockError",typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,o)}}class a extends Error{constructor(r){super(r),this.name="ParameterError",typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,a)}}class s extends Error{constructor(r="Flow completed before run could finish"){super(r),this.name="FlowCompletionError",typeof Error.captureStackTrace=="function"&&Error.captureStackTrace(this,s)}}exports.FlowCompletionError=s;exports.LockError=t;exports.MutexError=c;exports.ParameterError=a;exports.RWLockError=o;exports.UseAfterFreeError=e;
+//# sourceMappingURL=Errors-BWEYu-AB.cjs.map

package/dist/chunks/Errors-BWEYu-AB.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors-BWEYu-AB.cjs","sources":["../../src/Errors.ts"],"sourcesContent":["// ========================================\r\n// ./src/Errors.ts\r\n// ========================================\r\n/* v8 ignore file -- @preserve */\r\n\r\n/**\r\n * Error thrown when a resource is accessed after it has been disposed (Use After Free).\r\n */\r\nexport class UseAfterFreeError extends Error {\r\n  /**\r\n   * Creates an instance of UseAfterFreeError.\r\n   * @param message - The error message. Defaults to 'Cannot access resource after it has been disposed.'\r\n   */\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'UseAfterFreeError';\r\n    if (typeof Error.captureStackTrace === 'function')\r\n      Error.captureStackTrace(this, UseAfterFreeError);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a lock operation fails.\r\n * Base class for all lock-related errors.\r\n */\r\nexport class LockError extends Error {\r\n  /**\r\n   * Creates an instance of LockError.\r\n   * @param message - The error message describing the lock failure.\r\n   */\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'LockError';\r\n    if (typeof Error.captureStackTrace === 'function')\r\n      Error.captureStackTrace(this, LockError);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a mutex operation fails.\r\n * Used for mutual exclusion lock violations and failures.\r\n */\r\nexport class MutexError extends LockError {\r\n  /**\r\n   * Creates an instance of MutexError.\r\n   * @param message - The error message describing the mutex failure.\r\n   */\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'MutexError';\r\n    if (typeof Error.captureStackTrace === 'function')\r\n      Error.captureStackTrace(this, MutexError);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a read-write lock operation fails.\r\n * Used for reader-writer lock violations and failures.\r\n */\r\nexport class RWLockError extends LockError {\r\n  /**\r\n   * Creates an instance of RWLockError.\r\n   * @param message - The error message describing the read-write lock failure.\r\n   */\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'RWLockError';\r\n    if (typeof Error.captureStackTrace === 'function')\r\n      Error.captureStackTrace(this, RWLockError);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a function parameter is invalid.\r\n * Used for parameter validation failures.\r\n */\r\nexport class ParameterError extends Error {\r\n  /**\r\n   * Creates an instance of ParameterError.\r\n   * @param message - The error message describing the parameter validation failure.\r\n   */\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'ParameterError';\r\n    if (typeof Error.captureStackTrace === 'function')\r\n      Error.captureStackTrace(this, ParameterError);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a Flow completes before a run operation could finish.\r\n * This indicates that the Flow was completed or stopped while there were\r\n * still pending operations waiting for values.\r\n */\r\nexport class FlowCompletionError extends Error {\r\n  /**\r\n   * Creates an instance of FlowCompletionError.\r\n   * @param message - The error message. Defaults to 'Flow completed before run could finish'.\r\n   */\r\n  constructor(message: string = 'Flow completed before run could finish') {\r\n    super(message);\r\n    this.name = 'FlowCompletionError';\r\n    if (typeof Error.captureStackTrace === 'function')\r\n      Error.captureStackTrace(this, FlowCompletionError);\r\n  }\r\n}\r\n"],"names":["UseAfterFreeError","message","LockError","MutexError","RWLockError","ParameterError","FlowCompletionError"],"mappings":"aAQO,MAAMA,UAA0B,KAAM,CAK3C,YAAYC,EAAiB,CAC3B,MAAMA,CAAO,EACb,KAAK,KAAO,oBACR,OAAO,MAAM,mBAAsB,YACrC,MAAM,kBAAkB,KAAMD,CAAiB,CACnD,CACF,CAMO,MAAME,UAAkB,KAAM,CAKnC,YAAYD,EAAiB,CAC3B,MAAMA,CAAO,EACb,KAAK,KAAO,YACR,OAAO,MAAM,mBAAsB,YACrC,MAAM,kBAAkB,KAAMC,CAAS,CAC3C,CACF,CAMO,MAAMC,UAAmBD,CAAU,CAKxC,YAAYD,EAAiB,CAC3B,MAAMA,CAAO,EACb,KAAK,KAAO,aACR,OAAO,MAAM,mBAAsB,YACrC,MAAM,kBAAkB,KAAME,CAAU,CAC5C,CACF,CAMO,MAAMC,UAAoBF,CAAU,CAKzC,YAAYD,EAAiB,CAC3B,MAAMA,CAAO,EACb,KAAK,KAAO,cACR,OAAO,MAAM,mBAAsB,YACrC,MAAM,kBAAkB,KAAMG,CAAW,CAC7C,CACF,CAMO,MAAMC,UAAuB,KAAM,CAKxC,YAAYJ,EAAiB,CAC3B,MAAMA,CAAO,EACb,KAAK,KAAO,iBACR,OAAO,MAAM,mBAAsB,YACrC,MAAM,kBAAkB,KAAMI,CAAc,CAChD,CACF,CAOO,MAAMC,UAA4B,KAAM,CAK7C,YAAYL,EAAkB,yCAA0C,CACtE,MAAMA,CAAO,EACb,KAAK,KAAO,sBACR,OAAO,MAAM,mBAAsB,YACrC,MAAM,kBAAkB,KAAMK,CAAmB,CACrD,CACF"}