promise-logic 1.0.0

package/README.md

@@ -0,0 +1,194 @@
+# PromiseLogic
+
+> Compose promises with logic gate semantics (AND, OR, XOR, NAND, NOR, XNOR, Majority)
+
+PromiseLogic is a utility library that provides logical gate semantics for Promise composition, allowing developers to work with asynchronous operations using familiar logic concepts.
+
+## Philosophy
+
+**"Forget APIs, remember logic."** - Replace fragmented API knowledge with fundamental logic concepts.
+
+## Features
+
+- 🧠 **Logic Gate Semantics**: AND, OR, XOR, NAND, NOR, XNOR, Majority
+- 🔧 **Dual API Pattern**: Static class methods + Factory function
+- 📦 **Production Ready**: Complete build configuration and type support
+- 🧪 **Test Driven**: Comprehensive test coverage
+- 🌳 **Tree Shaking**: Optimized bundle output
+
+## Installation
+
+```bash
+npm install promise-logic
+```
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { PromiseLogic } from 'promise-logic';
+
+// AND logic - All promises must succeed
+const results = await PromiseLogic.and([
+  fetch('/api/users'),
+  fetch('/api/posts'),
+  fetch('/api/comments')
+]);
+
+// OR logic - Any promise succeeds
+const data = await PromiseLogic.or([
+  fetchPrimaryService(),
+  fetchBackupService()
+]);
+
+// RACE logic - First settled promise wins
+const winner = await PromiseLogic.race([
+  fastApiCall(),
+  slowApiCall()
+]);
+```
+
+### Factory Function Usage
+
+```javascript
+import { createPromiseLogic } from 'promise-logic';
+
+// Custom naming
+const myLogic = createPromiseLogic({
+  prefix: 'async',
+  suffix: 'Logic',
+  rename: { and: 'conjunction' }
+});
+
+// Use custom named methods
+const results = await myLogic.conjunction([
+  task1(), task2(), task3()
+]);
+```
+
+### Advanced Logic Methods
+
+```javascript
+// XOR - Exactly one promise must succeed
+const result = await PromiseLogic.xor([
+  primaryService(),
+  backupService()
+]);
+
+// NAND - Not all promises must succeed
+const data = await PromiseLogic.nand([
+  cacheLookup(),
+  databaseQuery()
+]);
+
+// Majority - More than half must succeed
+const decisions = await PromiseLogic.majority([
+  validator1(), validator2(), validator3()
+]);
+```
+
+## API Reference
+
+### PromiseLogic Class
+
+#### Core Methods
+
+- `PromiseLogic.and(iterable)` - Resolves when all promises succeed (proxies Promise.all)
+- `PromiseLogic.or(iterable)` - Resolves when any promise succeeds (proxies Promise.any)
+- `PromiseLogic.race(iterable)` - Resolves with first settled promise (proxies Promise.race)
+- `PromiseLogic.allSettled(iterable)` - Resolves when all promises settle (proxies Promise.allSettled)
+
+#### Advanced Logic Methods
+
+- `PromiseLogic.xor(iterable)` - **XOR**: Resolves when exactly one promise succeeds
+- `PromiseLogic.nand(iterable)` - **NAND**: Resolves when not all promises succeed
+- `PromiseLogic.nor(iterable)` - **NOR**: Resolves when all promises reject
+- `PromiseLogic.xnor(iterable)` - **XNOR**: Resolves when all succeed or all reject
+- `PromiseLogic.majority(iterable)` - **Majority**: Resolves when more than half succeed
+- `PromiseLogic.createFlipFlop(initialState)` - Creates an asynchronous flip-flop instance
+
+### createPromiseLogic Factory Function
+
+```javascript
+createPromiseLogic(options?: {
+  prefix?: string;
+  suffix?: string;
+  rename?: Record<string, string>;
+}): Record<string, Function>
+```
+
+## Development
+
+### Project Structure
+
+```
+promise-logic/
+├── src/
+│   ├── index.js          # Main entry point
+│   ├── PromiseLogic.js   # Core class implementation
+│   ├── factory.js        # Factory function
+│   ├── utils/
+│   │   └── errors.js     # Error handling utilities
+│   └── types/
+│       └── index.d.ts    # TypeScript definitions
+├── test/                 # Test files
+├── examples/             # Usage examples
+└── dist/                 # Build output
+```
+
+### Development Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode build
+npm run dev
+
+# Code linting
+npm run lint
+
+# Code formatting
+npm run format
+```
+
+## Examples
+
+See the `examples/` directory for complete usage examples:
+
+- `basic-usage.js` - Basic usage examples
+- `advanced-patterns.js` - Advanced patterns and use cases
+
+## Error Handling
+
+PromiseLogic provides detailed error information including:
+
+```javascript
+try {
+  await PromiseLogic.xor([promise1, promise2]);
+} catch (error) {
+  if (error.name === 'PromiseLogicError') {
+    console.log('Error type:', error.type); // 'XOR_ERROR'
+    console.log('All results:', error.results);
+  }
+}
+```
+
+### Error Types
+
+- `XOR_ERROR` - XOR condition failed (not exactly one promise fulfilled)
+- `NAND_ERROR` - NAND condition failed (all promises fulfilled)
+- `NOR_ERROR` - NOR condition failed (some promises fulfilled)
+- `XNOR_ERROR` - XNOR condition failed (mixed results)
+- `MAJORITY_ERROR` - Majority condition failed (not enough promises fulfilled)
+
+## License
+
+MIT

package/dist/factory.cjs.js

@@ -0,0 +1,208 @@
+'use strict';
+
+class PromiseLogicError extends Error {
+  constructor(type, message, results) {
+    super(message);
+    this.name = 'PromiseLogicError';
+    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.
+    this.results = results; // settlement results of all Promises
+  }
+}
+
+// Error factory function
+function createLogicError(type, fulfilledCount, total, results) {
+  const messages = {
+    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,
+    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,
+    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,
+    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`
+  };
+  
+  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);
+}
+
+class PromiseLogic {
+  static and(iterable) {
+    return Promise.all(iterable);
+  }
+
+  static or(iterable) {
+    return Promise.any(iterable);
+  }
+
+  static race(iterable) {
+    return Promise.race(iterable);
+  }
+
+  static allSettled(iterable) {
+    return Promise.allSettled(iterable);
+  }
+
+  static xor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 1) {
+        // 恰好一个成功，返回成功的值
+        return fulfilled[0].value;
+      } else {
+        // 0个或多个（>1）成功，抛出XOR_ERROR
+        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static nand(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === total) {
+        // 全部成功，抛出NAND_ERROR
+        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);
+      } else {
+        // 不是所有都成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      }
+    });
+  }
+
+  static nor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0) {
+        // 全部失败，返回空数组表示成功
+        return [];
+      } else {
+        // 任意成功，抛出NOR_ERROR
+        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static xnor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0 || fulfilledCount === total) {
+        // 全部成功或全部失败，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 部分成功部分失败，抛出XNOR_ERROR
+        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static majority(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      // 多数逻辑：成功数 > 失败数
+      if (fulfilledCount > total - fulfilledCount) {
+        // 超过半数成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 未达到多数，抛出MAJORITY_ERROR
+        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static createFlipFlop(initialState = false) {
+    let state = initialState;
+    let resolveCurrent = null;
+    let currentPromise = Promise.resolve(state);
+    
+    return {
+      // 获取当前状态
+      getState() {
+        return state;
+      },
+      
+      // 异步设置状态
+      set(newState) {
+        state = newState;
+        if (resolveCurrent) {
+          resolveCurrent(state);
+          resolveCurrent = null;
+        }
+        currentPromise = Promise.resolve(state);
+        return this;
+      },
+      
+      // 切换状态
+      toggle() {
+        return this.set(!state);
+      },
+      
+      // 等待状态变化
+      waitForChange() {
+        if (!resolveCurrent) {
+          currentPromise = new Promise((resolve) => {
+            resolveCurrent = resolve;
+          });
+        }
+        return currentPromise;
+      },
+      
+      // 等待特定状态
+      waitFor(targetState) {
+        if (state === targetState) {
+          return Promise.resolve(state);
+        }
+        return new Promise((resolve) => {
+          const checkState = () => {
+            if (state === targetState) {
+              resolve(state);
+            } else {
+              this.waitForChange().then(checkState);
+            }
+          };
+          checkState();
+        });
+      }
+    };
+  }
+}
+
+function createPromiseLogic(options = {}) {
+  const { prefix = '', suffix = '', rename = {} } = options;
+  
+  // 基础方法映射
+  const methods = {
+    and: PromiseLogic.and,
+    or: PromiseLogic.or,
+    race: PromiseLogic.race,
+    allSettled: PromiseLogic.allSettled,
+    xor: PromiseLogic.xor,
+    nand: PromiseLogic.nand,
+    nor: PromiseLogic.nor,
+    xnor: PromiseLogic.xnor,
+    majority: PromiseLogic.majority
+  };
+  
+  // 应用命名转换
+  const result = {};
+  Object.entries(methods).forEach(([key, fn]) => {
+    // 优先使用rename映射，然后应用prefix和suffix
+    const baseName = rename[key] || key;
+    const finalName = `${prefix}${baseName}${suffix}`;
+    result[finalName] = fn;
+  });
+  
+  return result;
+}
+
+exports.createPromiseLogic = createPromiseLogic;
+//# sourceMappingURL=factory.cjs.js.map

package/dist/factory.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.cjs.js","sources":["../src/utils/errors.js","../src/PromiseLogic.js","../src/factory.js"],"sourcesContent":["export class PromiseLogicError extends Error {\r\n  constructor(type, message, results) {\r\n    super(message);\r\n    this.name = 'PromiseLogicError';\r\n    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.\r\n    this.results = results; // settlement results of all Promises\r\n  }\r\n}\r\n\r\n// Error factory function\r\nexport function createLogicError(type, fulfilledCount, total, results) {\r\n  const messages = {\r\n    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,\r\n    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,\r\n    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,\r\n    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`\r\n  };\r\n  \r\n  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);\r\n}","import { createLogicError } from './utils/errors.js';\r\n\r\nexport class PromiseLogic {\r\n  static and(iterable) {\r\n    return Promise.all(iterable);\r\n  }\r\n\r\n  static or(iterable) {\r\n    return Promise.any(iterable);\r\n  }\r\n\r\n  static race(iterable) {\r\n    return Promise.race(iterable);\r\n  }\r\n\r\n  static allSettled(iterable) {\r\n    return Promise.allSettled(iterable);\r\n  }\r\n\r\n  static xor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 1) {\r\n        // 恰好一个成功，返回成功的值\r\n        return fulfilled[0].value;\r\n      } else {\r\n        // 0个或多个（>1）成功，抛出XOR_ERROR\r\n        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nand(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === total) {\r\n        // 全部成功，抛出NAND_ERROR\r\n        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);\r\n      } else {\r\n        // 不是所有都成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0) {\r\n        // 全部失败，返回空数组表示成功\r\n        return [];\r\n      } else {\r\n        // 任意成功，抛出NOR_ERROR\r\n        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static xnor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0 || fulfilledCount === total) {\r\n        // 全部成功或全部失败，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 部分成功部分失败，抛出XNOR_ERROR\r\n        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static majority(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      // 多数逻辑：成功数 > 失败数\r\n      if (fulfilledCount > total - fulfilledCount) {\r\n        // 超过半数成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 未达到多数，抛出MAJORITY_ERROR\r\n        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static createFlipFlop(initialState = false) {\r\n    let state = initialState;\r\n    let resolveCurrent = null;\r\n    let currentPromise = Promise.resolve(state);\r\n    \r\n    return {\r\n      // 获取当前状态\r\n      getState() {\r\n        return state;\r\n      },\r\n      \r\n      // 异步设置状态\r\n      set(newState) {\r\n        state = newState;\r\n        if (resolveCurrent) {\r\n          resolveCurrent(state);\r\n          resolveCurrent = null;\r\n        }\r\n        currentPromise = Promise.resolve(state);\r\n        return this;\r\n      },\r\n      \r\n      // 切换状态\r\n      toggle() {\r\n        return this.set(!state);\r\n      },\r\n      \r\n      // 等待状态变化\r\n      waitForChange() {\r\n        if (!resolveCurrent) {\r\n          currentPromise = new Promise((resolve) => {\r\n            resolveCurrent = resolve;\r\n          });\r\n        }\r\n        return currentPromise;\r\n      },\r\n      \r\n      // 等待特定状态\r\n      waitFor(targetState) {\r\n        if (state === targetState) {\r\n          return Promise.resolve(state);\r\n        }\r\n        return new Promise((resolve) => {\r\n          const checkState = () => {\r\n            if (state === targetState) {\r\n              resolve(state);\r\n            } else {\r\n              this.waitForChange().then(checkState);\r\n            }\r\n          };\r\n          checkState();\r\n        });\r\n      }\r\n    };\r\n  }\r\n}","import { PromiseLogic } from './PromiseLogic.js';\n\nexport function createPromiseLogic(options = {}) {\n  const { prefix = '', suffix = '', rename = {} } = options;\n  \n  // 基础方法映射\n  const methods = {\n    and: PromiseLogic.and,\n    or: PromiseLogic.or,\n    race: PromiseLogic.race,\n    allSettled: PromiseLogic.allSettled,\n    xor: PromiseLogic.xor,\n    nand: PromiseLogic.nand,\n    nor: PromiseLogic.nor,\n    xnor: PromiseLogic.xnor,\n    majority: PromiseLogic.majority\n  };\n  \n  // 应用命名转换\n  const result = {};\n  Object.entries(methods).forEach(([key, fn]) => {\n    // 优先使用rename映射，然后应用prefix和suffix\n    const baseName = rename[key] || key;\n    const finalName = `${prefix}${baseName}${suffix}`;\n    result[finalName] = fn;\n  });\n  \n  return result;\n}"],"names":[],"mappings":"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"}

package/dist/factory.esm.js

@@ -0,0 +1,206 @@
+class PromiseLogicError extends Error {
+  constructor(type, message, results) {
+    super(message);
+    this.name = 'PromiseLogicError';
+    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.
+    this.results = results; // settlement results of all Promises
+  }
+}
+
+// Error factory function
+function createLogicError(type, fulfilledCount, total, results) {
+  const messages = {
+    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,
+    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,
+    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,
+    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`
+  };
+  
+  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);
+}
+
+class PromiseLogic {
+  static and(iterable) {
+    return Promise.all(iterable);
+  }
+
+  static or(iterable) {
+    return Promise.any(iterable);
+  }
+
+  static race(iterable) {
+    return Promise.race(iterable);
+  }
+
+  static allSettled(iterable) {
+    return Promise.allSettled(iterable);
+  }
+
+  static xor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 1) {
+        // 恰好一个成功，返回成功的值
+        return fulfilled[0].value;
+      } else {
+        // 0个或多个（>1）成功，抛出XOR_ERROR
+        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static nand(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === total) {
+        // 全部成功，抛出NAND_ERROR
+        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);
+      } else {
+        // 不是所有都成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      }
+    });
+  }
+
+  static nor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0) {
+        // 全部失败，返回空数组表示成功
+        return [];
+      } else {
+        // 任意成功，抛出NOR_ERROR
+        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static xnor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0 || fulfilledCount === total) {
+        // 全部成功或全部失败，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 部分成功部分失败，抛出XNOR_ERROR
+        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static majority(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      // 多数逻辑：成功数 > 失败数
+      if (fulfilledCount > total - fulfilledCount) {
+        // 超过半数成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 未达到多数，抛出MAJORITY_ERROR
+        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static createFlipFlop(initialState = false) {
+    let state = initialState;
+    let resolveCurrent = null;
+    let currentPromise = Promise.resolve(state);
+    
+    return {
+      // 获取当前状态
+      getState() {
+        return state;
+      },
+      
+      // 异步设置状态
+      set(newState) {
+        state = newState;
+        if (resolveCurrent) {
+          resolveCurrent(state);
+          resolveCurrent = null;
+        }
+        currentPromise = Promise.resolve(state);
+        return this;
+      },
+      
+      // 切换状态
+      toggle() {
+        return this.set(!state);
+      },
+      
+      // 等待状态变化
+      waitForChange() {
+        if (!resolveCurrent) {
+          currentPromise = new Promise((resolve) => {
+            resolveCurrent = resolve;
+          });
+        }
+        return currentPromise;
+      },
+      
+      // 等待特定状态
+      waitFor(targetState) {
+        if (state === targetState) {
+          return Promise.resolve(state);
+        }
+        return new Promise((resolve) => {
+          const checkState = () => {
+            if (state === targetState) {
+              resolve(state);
+            } else {
+              this.waitForChange().then(checkState);
+            }
+          };
+          checkState();
+        });
+      }
+    };
+  }
+}
+
+function createPromiseLogic(options = {}) {
+  const { prefix = '', suffix = '', rename = {} } = options;
+  
+  // 基础方法映射
+  const methods = {
+    and: PromiseLogic.and,
+    or: PromiseLogic.or,
+    race: PromiseLogic.race,
+    allSettled: PromiseLogic.allSettled,
+    xor: PromiseLogic.xor,
+    nand: PromiseLogic.nand,
+    nor: PromiseLogic.nor,
+    xnor: PromiseLogic.xnor,
+    majority: PromiseLogic.majority
+  };
+  
+  // 应用命名转换
+  const result = {};
+  Object.entries(methods).forEach(([key, fn]) => {
+    // 优先使用rename映射，然后应用prefix和suffix
+    const baseName = rename[key] || key;
+    const finalName = `${prefix}${baseName}${suffix}`;
+    result[finalName] = fn;
+  });
+  
+  return result;
+}
+
+export { createPromiseLogic };
+//# sourceMappingURL=factory.esm.js.map

package/dist/factory.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.esm.js","sources":["../src/utils/errors.js","../src/PromiseLogic.js","../src/factory.js"],"sourcesContent":["export class PromiseLogicError extends Error {\r\n  constructor(type, message, results) {\r\n    super(message);\r\n    this.name = 'PromiseLogicError';\r\n    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.\r\n    this.results = results; // settlement results of all Promises\r\n  }\r\n}\r\n\r\n// Error factory function\r\nexport function createLogicError(type, fulfilledCount, total, results) {\r\n  const messages = {\r\n    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,\r\n    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,\r\n    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,\r\n    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`\r\n  };\r\n  \r\n  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);\r\n}","import { createLogicError } from './utils/errors.js';\r\n\r\nexport class PromiseLogic {\r\n  static and(iterable) {\r\n    return Promise.all(iterable);\r\n  }\r\n\r\n  static or(iterable) {\r\n    return Promise.any(iterable);\r\n  }\r\n\r\n  static race(iterable) {\r\n    return Promise.race(iterable);\r\n  }\r\n\r\n  static allSettled(iterable) {\r\n    return Promise.allSettled(iterable);\r\n  }\r\n\r\n  static xor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 1) {\r\n        // 恰好一个成功，返回成功的值\r\n        return fulfilled[0].value;\r\n      } else {\r\n        // 0个或多个（>1）成功，抛出XOR_ERROR\r\n        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nand(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === total) {\r\n        // 全部成功，抛出NAND_ERROR\r\n        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);\r\n      } else {\r\n        // 不是所有都成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0) {\r\n        // 全部失败，返回空数组表示成功\r\n        return [];\r\n      } else {\r\n        // 任意成功，抛出NOR_ERROR\r\n        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static xnor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0 || fulfilledCount === total) {\r\n        // 全部成功或全部失败，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 部分成功部分失败，抛出XNOR_ERROR\r\n        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static majority(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      // 多数逻辑：成功数 > 失败数\r\n      if (fulfilledCount > total - fulfilledCount) {\r\n        // 超过半数成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 未达到多数，抛出MAJORITY_ERROR\r\n        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static createFlipFlop(initialState = false) {\r\n    let state = initialState;\r\n    let resolveCurrent = null;\r\n    let currentPromise = Promise.resolve(state);\r\n    \r\n    return {\r\n      // 获取当前状态\r\n      getState() {\r\n        return state;\r\n      },\r\n      \r\n      // 异步设置状态\r\n      set(newState) {\r\n        state = newState;\r\n        if (resolveCurrent) {\r\n          resolveCurrent(state);\r\n          resolveCurrent = null;\r\n        }\r\n        currentPromise = Promise.resolve(state);\r\n        return this;\r\n      },\r\n      \r\n      // 切换状态\r\n      toggle() {\r\n        return this.set(!state);\r\n      },\r\n      \r\n      // 等待状态变化\r\n      waitForChange() {\r\n        if (!resolveCurrent) {\r\n          currentPromise = new Promise((resolve) => {\r\n            resolveCurrent = resolve;\r\n          });\r\n        }\r\n        return currentPromise;\r\n      },\r\n      \r\n      // 等待特定状态\r\n      waitFor(targetState) {\r\n        if (state === targetState) {\r\n          return Promise.resolve(state);\r\n        }\r\n        return new Promise((resolve) => {\r\n          const checkState = () => {\r\n            if (state === targetState) {\r\n              resolve(state);\r\n            } else {\r\n              this.waitForChange().then(checkState);\r\n            }\r\n          };\r\n          checkState();\r\n        });\r\n      }\r\n    };\r\n  }\r\n}","import { PromiseLogic } from './PromiseLogic.js';\n\nexport function createPromiseLogic(options = {}) {\n  const { prefix = '', suffix = '', rename = {} } = options;\n  \n  // 基础方法映射\n  const methods = {\n    and: PromiseLogic.and,\n    or: PromiseLogic.or,\n    race: PromiseLogic.race,\n    allSettled: PromiseLogic.allSettled,\n    xor: PromiseLogic.xor,\n    nand: PromiseLogic.nand,\n    nor: PromiseLogic.nor,\n    xnor: PromiseLogic.xnor,\n    majority: PromiseLogic.majority\n  };\n  \n  // 应用命名转换\n  const result = {};\n  Object.entries(methods).forEach(([key, fn]) => {\n    // 优先使用rename映射，然后应用prefix和suffix\n    const baseName = rename[key] || key;\n    const finalName = `${prefix}${baseName}${suffix}`;\n    result[finalName] = fn;\n  });\n  \n  return result;\n}"],"names":[],"mappings":"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"}

package/dist/index.cjs.js

@@ -0,0 +1,211 @@
+'use strict';
+
+class PromiseLogicError extends Error {
+  constructor(type, message, results) {
+    super(message);
+    this.name = 'PromiseLogicError';
+    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.
+    this.results = results; // settlement results of all Promises
+  }
+}
+
+// Error factory function
+function createLogicError(type, fulfilledCount, total, results) {
+  const messages = {
+    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,
+    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,
+    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,
+    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`
+  };
+  
+  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);
+}
+
+class PromiseLogic {
+  static and(iterable) {
+    return Promise.all(iterable);
+  }
+
+  static or(iterable) {
+    return Promise.any(iterable);
+  }
+
+  static race(iterable) {
+    return Promise.race(iterable);
+  }
+
+  static allSettled(iterable) {
+    return Promise.allSettled(iterable);
+  }
+
+  static xor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 1) {
+        // 恰好一个成功，返回成功的值
+        return fulfilled[0].value;
+      } else {
+        // 0个或多个（>1）成功，抛出XOR_ERROR
+        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static nand(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === total) {
+        // 全部成功，抛出NAND_ERROR
+        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);
+      } else {
+        // 不是所有都成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      }
+    });
+  }
+
+  static nor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0) {
+        // 全部失败，返回空数组表示成功
+        return [];
+      } else {
+        // 任意成功，抛出NOR_ERROR
+        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static xnor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0 || fulfilledCount === total) {
+        // 全部成功或全部失败，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 部分成功部分失败，抛出XNOR_ERROR
+        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static majority(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      // 多数逻辑：成功数 > 失败数
+      if (fulfilledCount > total - fulfilledCount) {
+        // 超过半数成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 未达到多数，抛出MAJORITY_ERROR
+        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static createFlipFlop(initialState = false) {
+    let state = initialState;
+    let resolveCurrent = null;
+    let currentPromise = Promise.resolve(state);
+    
+    return {
+      // 获取当前状态
+      getState() {
+        return state;
+      },
+      
+      // 异步设置状态
+      set(newState) {
+        state = newState;
+        if (resolveCurrent) {
+          resolveCurrent(state);
+          resolveCurrent = null;
+        }
+        currentPromise = Promise.resolve(state);
+        return this;
+      },
+      
+      // 切换状态
+      toggle() {
+        return this.set(!state);
+      },
+      
+      // 等待状态变化
+      waitForChange() {
+        if (!resolveCurrent) {
+          currentPromise = new Promise((resolve) => {
+            resolveCurrent = resolve;
+          });
+        }
+        return currentPromise;
+      },
+      
+      // 等待特定状态
+      waitFor(targetState) {
+        if (state === targetState) {
+          return Promise.resolve(state);
+        }
+        return new Promise((resolve) => {
+          const checkState = () => {
+            if (state === targetState) {
+              resolve(state);
+            } else {
+              this.waitForChange().then(checkState);
+            }
+          };
+          checkState();
+        });
+      }
+    };
+  }
+}
+
+function createPromiseLogic(options = {}) {
+  const { prefix = '', suffix = '', rename = {} } = options;
+  
+  // 基础方法映射
+  const methods = {
+    and: PromiseLogic.and,
+    or: PromiseLogic.or,
+    race: PromiseLogic.race,
+    allSettled: PromiseLogic.allSettled,
+    xor: PromiseLogic.xor,
+    nand: PromiseLogic.nand,
+    nor: PromiseLogic.nor,
+    xnor: PromiseLogic.xnor,
+    majority: PromiseLogic.majority
+  };
+  
+  // 应用命名转换
+  const result = {};
+  Object.entries(methods).forEach(([key, fn]) => {
+    // 优先使用rename映射，然后应用prefix和suffix
+    const baseName = rename[key] || key;
+    const finalName = `${prefix}${baseName}${suffix}`;
+    result[finalName] = fn;
+  });
+  
+  return result;
+}
+
+exports.PromiseLogic = PromiseLogic;
+exports.PromiseLogicError = PromiseLogicError;
+exports.createLogicError = createLogicError;
+exports.createPromiseLogic = createPromiseLogic;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/utils/errors.js","../src/PromiseLogic.js","../src/factory.js"],"sourcesContent":["export class PromiseLogicError extends Error {\r\n  constructor(type, message, results) {\r\n    super(message);\r\n    this.name = 'PromiseLogicError';\r\n    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.\r\n    this.results = results; // settlement results of all Promises\r\n  }\r\n}\r\n\r\n// Error factory function\r\nexport function createLogicError(type, fulfilledCount, total, results) {\r\n  const messages = {\r\n    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,\r\n    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,\r\n    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,\r\n    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`\r\n  };\r\n  \r\n  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);\r\n}","import { createLogicError } from './utils/errors.js';\r\n\r\nexport class PromiseLogic {\r\n  static and(iterable) {\r\n    return Promise.all(iterable);\r\n  }\r\n\r\n  static or(iterable) {\r\n    return Promise.any(iterable);\r\n  }\r\n\r\n  static race(iterable) {\r\n    return Promise.race(iterable);\r\n  }\r\n\r\n  static allSettled(iterable) {\r\n    return Promise.allSettled(iterable);\r\n  }\r\n\r\n  static xor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 1) {\r\n        // 恰好一个成功，返回成功的值\r\n        return fulfilled[0].value;\r\n      } else {\r\n        // 0个或多个（>1）成功，抛出XOR_ERROR\r\n        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nand(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === total) {\r\n        // 全部成功，抛出NAND_ERROR\r\n        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);\r\n      } else {\r\n        // 不是所有都成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0) {\r\n        // 全部失败，返回空数组表示成功\r\n        return [];\r\n      } else {\r\n        // 任意成功，抛出NOR_ERROR\r\n        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static xnor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0 || fulfilledCount === total) {\r\n        // 全部成功或全部失败，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 部分成功部分失败，抛出XNOR_ERROR\r\n        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static majority(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      // 多数逻辑：成功数 > 失败数\r\n      if (fulfilledCount > total - fulfilledCount) {\r\n        // 超过半数成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 未达到多数，抛出MAJORITY_ERROR\r\n        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static createFlipFlop(initialState = false) {\r\n    let state = initialState;\r\n    let resolveCurrent = null;\r\n    let currentPromise = Promise.resolve(state);\r\n    \r\n    return {\r\n      // 获取当前状态\r\n      getState() {\r\n        return state;\r\n      },\r\n      \r\n      // 异步设置状态\r\n      set(newState) {\r\n        state = newState;\r\n        if (resolveCurrent) {\r\n          resolveCurrent(state);\r\n          resolveCurrent = null;\r\n        }\r\n        currentPromise = Promise.resolve(state);\r\n        return this;\r\n      },\r\n      \r\n      // 切换状态\r\n      toggle() {\r\n        return this.set(!state);\r\n      },\r\n      \r\n      // 等待状态变化\r\n      waitForChange() {\r\n        if (!resolveCurrent) {\r\n          currentPromise = new Promise((resolve) => {\r\n            resolveCurrent = resolve;\r\n          });\r\n        }\r\n        return currentPromise;\r\n      },\r\n      \r\n      // 等待特定状态\r\n      waitFor(targetState) {\r\n        if (state === targetState) {\r\n          return Promise.resolve(state);\r\n        }\r\n        return new Promise((resolve) => {\r\n          const checkState = () => {\r\n            if (state === targetState) {\r\n              resolve(state);\r\n            } else {\r\n              this.waitForChange().then(checkState);\r\n            }\r\n          };\r\n          checkState();\r\n        });\r\n      }\r\n    };\r\n  }\r\n}","import { PromiseLogic } from './PromiseLogic.js';\n\nexport function createPromiseLogic(options = {}) {\n  const { prefix = '', suffix = '', rename = {} } = options;\n  \n  // 基础方法映射\n  const methods = {\n    and: PromiseLogic.and,\n    or: PromiseLogic.or,\n    race: PromiseLogic.race,\n    allSettled: PromiseLogic.allSettled,\n    xor: PromiseLogic.xor,\n    nand: PromiseLogic.nand,\n    nor: PromiseLogic.nor,\n    xnor: PromiseLogic.xnor,\n    majority: PromiseLogic.majority\n  };\n  \n  // 应用命名转换\n  const result = {};\n  Object.entries(methods).forEach(([key, fn]) => {\n    // 优先使用rename映射，然后应用prefix和suffix\n    const baseName = rename[key] || key;\n    const finalName = `${prefix}${baseName}${suffix}`;\n    result[finalName] = fn;\n  });\n  \n  return result;\n}"],"names":[],"mappings":"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"}

package/dist/index.esm.js

@@ -0,0 +1,206 @@
+class PromiseLogicError extends Error {
+  constructor(type, message, results) {
+    super(message);
+    this.name = 'PromiseLogicError';
+    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.
+    this.results = results; // settlement results of all Promises
+  }
+}
+
+// Error factory function
+function createLogicError(type, fulfilledCount, total, results) {
+  const messages = {
+    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,
+    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,
+    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,
+    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`
+  };
+  
+  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);
+}
+
+class PromiseLogic {
+  static and(iterable) {
+    return Promise.all(iterable);
+  }
+
+  static or(iterable) {
+    return Promise.any(iterable);
+  }
+
+  static race(iterable) {
+    return Promise.race(iterable);
+  }
+
+  static allSettled(iterable) {
+    return Promise.allSettled(iterable);
+  }
+
+  static xor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 1) {
+        // 恰好一个成功，返回成功的值
+        return fulfilled[0].value;
+      } else {
+        // 0个或多个（>1）成功，抛出XOR_ERROR
+        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static nand(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === total) {
+        // 全部成功，抛出NAND_ERROR
+        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);
+      } else {
+        // 不是所有都成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      }
+    });
+  }
+
+  static nor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0) {
+        // 全部失败，返回空数组表示成功
+        return [];
+      } else {
+        // 任意成功，抛出NOR_ERROR
+        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static xnor(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      if (fulfilledCount === 0 || fulfilledCount === total) {
+        // 全部成功或全部失败，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 部分成功部分失败，抛出XNOR_ERROR
+        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static majority(iterable) {
+    return Promise.allSettled(iterable).then((results) => {
+      const fulfilled = results.filter(result => result.status === 'fulfilled');
+      const fulfilledCount = fulfilled.length;
+      const total = results.length;
+      
+      // 多数逻辑：成功数 > 失败数
+      if (fulfilledCount > total - fulfilledCount) {
+        // 超过半数成功，返回成功的值数组
+        return fulfilled.map(result => result.value);
+      } else {
+        // 未达到多数，抛出MAJORITY_ERROR
+        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);
+      }
+    });
+  }
+
+  static createFlipFlop(initialState = false) {
+    let state = initialState;
+    let resolveCurrent = null;
+    let currentPromise = Promise.resolve(state);
+    
+    return {
+      // 获取当前状态
+      getState() {
+        return state;
+      },
+      
+      // 异步设置状态
+      set(newState) {
+        state = newState;
+        if (resolveCurrent) {
+          resolveCurrent(state);
+          resolveCurrent = null;
+        }
+        currentPromise = Promise.resolve(state);
+        return this;
+      },
+      
+      // 切换状态
+      toggle() {
+        return this.set(!state);
+      },
+      
+      // 等待状态变化
+      waitForChange() {
+        if (!resolveCurrent) {
+          currentPromise = new Promise((resolve) => {
+            resolveCurrent = resolve;
+          });
+        }
+        return currentPromise;
+      },
+      
+      // 等待特定状态
+      waitFor(targetState) {
+        if (state === targetState) {
+          return Promise.resolve(state);
+        }
+        return new Promise((resolve) => {
+          const checkState = () => {
+            if (state === targetState) {
+              resolve(state);
+            } else {
+              this.waitForChange().then(checkState);
+            }
+          };
+          checkState();
+        });
+      }
+    };
+  }
+}
+
+function createPromiseLogic(options = {}) {
+  const { prefix = '', suffix = '', rename = {} } = options;
+  
+  // 基础方法映射
+  const methods = {
+    and: PromiseLogic.and,
+    or: PromiseLogic.or,
+    race: PromiseLogic.race,
+    allSettled: PromiseLogic.allSettled,
+    xor: PromiseLogic.xor,
+    nand: PromiseLogic.nand,
+    nor: PromiseLogic.nor,
+    xnor: PromiseLogic.xnor,
+    majority: PromiseLogic.majority
+  };
+  
+  // 应用命名转换
+  const result = {};
+  Object.entries(methods).forEach(([key, fn]) => {
+    // 优先使用rename映射，然后应用prefix和suffix
+    const baseName = rename[key] || key;
+    const finalName = `${prefix}${baseName}${suffix}`;
+    result[finalName] = fn;
+  });
+  
+  return result;
+}
+
+export { PromiseLogic, PromiseLogicError, createLogicError, createPromiseLogic };
+//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":["../src/utils/errors.js","../src/PromiseLogic.js","../src/factory.js"],"sourcesContent":["export class PromiseLogicError extends Error {\r\n  constructor(type, message, results) {\r\n    super(message);\r\n    this.name = 'PromiseLogicError';\r\n    this.type = type; // 'XOR_ERROR', 'NAND_ERROR', etc.\r\n    this.results = results; // settlement results of all Promises\r\n  }\r\n}\r\n\r\n// Error factory function\r\nexport function createLogicError(type, fulfilledCount, total, results) {\r\n  const messages = {\r\n    XOR_ERROR: `XOR condition failed: expected exactly 1 promise to fulfill, but ${fulfilledCount} fulfilled.`,\r\n    NAND_ERROR: `NAND condition failed: all ${total} promises fulfilled (expected at least one rejection).`,\r\n    NOR_ERROR: `NOR condition failed: ${fulfilledCount} promises fulfilled (expected all rejected).`,\r\n    MAJORITY_ERROR: `Majority condition failed: ${fulfilledCount}/${total} fulfilled (need majority).`\r\n  };\r\n  \r\n  return new PromiseLogicError(type, messages[type] || 'Logic condition failed', results);\r\n}","import { createLogicError } from './utils/errors.js';\r\n\r\nexport class PromiseLogic {\r\n  static and(iterable) {\r\n    return Promise.all(iterable);\r\n  }\r\n\r\n  static or(iterable) {\r\n    return Promise.any(iterable);\r\n  }\r\n\r\n  static race(iterable) {\r\n    return Promise.race(iterable);\r\n  }\r\n\r\n  static allSettled(iterable) {\r\n    return Promise.allSettled(iterable);\r\n  }\r\n\r\n  static xor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 1) {\r\n        // 恰好一个成功，返回成功的值\r\n        return fulfilled[0].value;\r\n      } else {\r\n        // 0个或多个（>1）成功，抛出XOR_ERROR\r\n        throw createLogicError('XOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nand(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === total) {\r\n        // 全部成功，抛出NAND_ERROR\r\n        throw createLogicError('NAND_ERROR', fulfilledCount, total, results);\r\n      } else {\r\n        // 不是所有都成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      }\r\n    });\r\n  }\r\n\r\n  static nor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0) {\r\n        // 全部失败，返回空数组表示成功\r\n        return [];\r\n      } else {\r\n        // 任意成功，抛出NOR_ERROR\r\n        throw createLogicError('NOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static xnor(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      if (fulfilledCount === 0 || fulfilledCount === total) {\r\n        // 全部成功或全部失败，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 部分成功部分失败，抛出XNOR_ERROR\r\n        throw createLogicError('XNOR_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static majority(iterable) {\r\n    return Promise.allSettled(iterable).then((results) => {\r\n      const fulfilled = results.filter(result => result.status === 'fulfilled');\r\n      const fulfilledCount = fulfilled.length;\r\n      const total = results.length;\r\n      \r\n      // 多数逻辑：成功数 > 失败数\r\n      if (fulfilledCount > total - fulfilledCount) {\r\n        // 超过半数成功，返回成功的值数组\r\n        return fulfilled.map(result => result.value);\r\n      } else {\r\n        // 未达到多数，抛出MAJORITY_ERROR\r\n        throw createLogicError('MAJORITY_ERROR', fulfilledCount, total, results);\r\n      }\r\n    });\r\n  }\r\n\r\n  static createFlipFlop(initialState = false) {\r\n    let state = initialState;\r\n    let resolveCurrent = null;\r\n    let currentPromise = Promise.resolve(state);\r\n    \r\n    return {\r\n      // 获取当前状态\r\n      getState() {\r\n        return state;\r\n      },\r\n      \r\n      // 异步设置状态\r\n      set(newState) {\r\n        state = newState;\r\n        if (resolveCurrent) {\r\n          resolveCurrent(state);\r\n          resolveCurrent = null;\r\n        }\r\n        currentPromise = Promise.resolve(state);\r\n        return this;\r\n      },\r\n      \r\n      // 切换状态\r\n      toggle() {\r\n        return this.set(!state);\r\n      },\r\n      \r\n      // 等待状态变化\r\n      waitForChange() {\r\n        if (!resolveCurrent) {\r\n          currentPromise = new Promise((resolve) => {\r\n            resolveCurrent = resolve;\r\n          });\r\n        }\r\n        return currentPromise;\r\n      },\r\n      \r\n      // 等待特定状态\r\n      waitFor(targetState) {\r\n        if (state === targetState) {\r\n          return Promise.resolve(state);\r\n        }\r\n        return new Promise((resolve) => {\r\n          const checkState = () => {\r\n            if (state === targetState) {\r\n              resolve(state);\r\n            } else {\r\n              this.waitForChange().then(checkState);\r\n            }\r\n          };\r\n          checkState();\r\n        });\r\n      }\r\n    };\r\n  }\r\n}","import { PromiseLogic } from './PromiseLogic.js';\n\nexport function createPromiseLogic(options = {}) {\n  const { prefix = '', suffix = '', rename = {} } = options;\n  \n  // 基础方法映射\n  const methods = {\n    and: PromiseLogic.and,\n    or: PromiseLogic.or,\n    race: PromiseLogic.race,\n    allSettled: PromiseLogic.allSettled,\n    xor: PromiseLogic.xor,\n    nand: PromiseLogic.nand,\n    nor: PromiseLogic.nor,\n    xnor: PromiseLogic.xnor,\n    majority: PromiseLogic.majority\n  };\n  \n  // 应用命名转换\n  const result = {};\n  Object.entries(methods).forEach(([key, fn]) => {\n    // 优先使用rename映射，然后应用prefix和suffix\n    const baseName = rename[key] || key;\n    const finalName = `${prefix}${baseName}${suffix}`;\n    result[finalName] = fn;\n  });\n  \n  return result;\n}"],"names":[],"mappings":"AAAO,MAAM,iBAAiB,SAAS,KAAK,CAAC;AAC7C,EAAE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;AACtC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;AACnB,IAAI,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;AACpC,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;AACrB,IAAI,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;AAC3B,EAAE,CAAC;AACH,CAAC;AACD;AACA;AACO,SAAS,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE;AACvE,EAAE,MAAM,QAAQ,GAAG;AACnB,IAAI,SAAS,EAAE,CAAC,iEAAiE,EAAE,cAAc,CAAC,WAAW,CAAC;AAC9G,IAAI,UAAU,EAAE,CAAC,2BAA2B,EAAE,KAAK,CAAC,sDAAsD,CAAC;AAC3G,IAAI,SAAS,EAAE,CAAC,sBAAsB,EAAE,cAAc,CAAC,4CAA4C,CAAC;AACpG,IAAI,cAAc,EAAE,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,2BAA2B,CAAC;AACtG,GAAG,CAAC;AACJ;AACA,EAAE,OAAO,IAAI,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,wBAAwB,EAAE,OAAO,CAAC,CAAC;AAC1F;;ACjBO,MAAM,YAAY,CAAC;AAC1B,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE;AACvB,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjC,EAAE,CAAC;AACH;AACA,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE;AACtB,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACjC,EAAE,CAAC;AACH;AACA,EAAE,OAAO,IAAI,CAAC,QAAQ,EAAE;AACxB,IAAI,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAClC,EAAE,CAAC;AACH;AACA,EAAE,OAAO,UAAU,CAAC,QAAQ,EAAE;AAC9B,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACxC,EAAE,CAAC;AACH;AACA,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE;AACvB,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;AACnC;AACA,MAAM,IAAI,cAAc,KAAK,CAAC,EAAE;AAChC;AACA,QAAQ,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClC,MAAM,CAAC,MAAM;AACb;AACA,QAAQ,MAAM,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5E,MAAM,CAAC;AACP,IAAI,CAAC,CAAC,CAAC;AACP,EAAE,CAAC;AACH;AACA,EAAE,OAAO,IAAI,CAAC,QAAQ,EAAE;AACxB,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;AACnC;AACA,MAAM,IAAI,cAAc,KAAK,KAAK,EAAE;AACpC;AACA,QAAQ,MAAM,gBAAgB,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM;AACb;AACA,QAAQ,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AACrD,MAAM,CAAC;AACP,IAAI,CAAC,CAAC,CAAC;AACP,EAAE,CAAC;AACH;AACA,EAAE,OAAO,GAAG,CAAC,QAAQ,EAAE;AACvB,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;AACnC;AACA,MAAM,IAAI,cAAc,KAAK,CAAC,EAAE;AAChC;AACA,QAAQ,OAAO,EAAE,CAAC;AAClB,MAAM,CAAC,MAAM;AACb;AACA,QAAQ,MAAM,gBAAgB,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5E,MAAM,CAAC;AACP,IAAI,CAAC,CAAC,CAAC;AACP,EAAE,CAAC;AACH;AACA,EAAE,OAAO,IAAI,CAAC,QAAQ,EAAE;AACxB,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;AACnC;AACA,MAAM,IAAI,cAAc,KAAK,CAAC,IAAI,cAAc,KAAK,KAAK,EAAE;AAC5D;AACA,QAAQ,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM;AACb;AACA,QAAQ,MAAM,gBAAgB,CAAC,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC7E,MAAM,CAAC;AACP,IAAI,CAAC,CAAC,CAAC;AACP,EAAE,CAAC;AACH;AACA,EAAE,OAAO,QAAQ,CAAC,QAAQ,EAAE;AAC5B,IAAI,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC;AAC9C,MAAM,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;AACnC;AACA;AACA,MAAM,IAAI,cAAc,GAAG,KAAK,GAAG,cAAc,EAAE;AACnD;AACA,QAAQ,OAAO,SAAS,CAAC,GAAG,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM;AACb;AACA,QAAQ,MAAM,gBAAgB,CAAC,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACjF,MAAM,CAAC;AACP,IAAI,CAAC,CAAC,CAAC;AACP,EAAE,CAAC;AACH;AACA,EAAE,OAAO,cAAc,CAAC,YAAY,GAAG,KAAK,EAAE;AAC9C,IAAI,IAAI,KAAK,GAAG,YAAY,CAAC;AAC7B,IAAI,IAAI,cAAc,GAAG,IAAI,CAAC;AAC9B,IAAI,IAAI,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChD;AACA,IAAI,OAAO;AACX;AACA,MAAM,QAAQ,GAAG;AACjB,QAAQ,OAAO,KAAK,CAAC;AACrB,MAAM,CAAC;AACP;AACA;AACA,MAAM,GAAG,CAAC,QAAQ,EAAE;AACpB,QAAQ,KAAK,GAAG,QAAQ,CAAC;AACzB,QAAQ,IAAI,cAAc,EAAE;AAC5B,UAAU,cAAc,CAAC,KAAK,CAAC,CAAC;AAChC,UAAU,cAAc,GAAG,IAAI,CAAC;AAChC,QAAQ,CAAC;AACT,QAAQ,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAChD,QAAQ,OAAO,IAAI,CAAC;AACpB,MAAM,CAAC;AACP;AACA;AACA,MAAM,MAAM,GAAG;AACf,QAAQ,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAChC,MAAM,CAAC;AACP;AACA;AACA,MAAM,aAAa,GAAG;AACtB,QAAQ,IAAI,CAAC,cAAc,EAAE;AAC7B,UAAU,cAAc,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK;AACpD,YAAY,cAAc,GAAG,OAAO,CAAC;AACrC,UAAU,CAAC,CAAC,CAAC;AACb,QAAQ,CAAC;AACT,QAAQ,OAAO,cAAc,CAAC;AAC9B,MAAM,CAAC;AACP;AACA;AACA,MAAM,OAAO,CAAC,WAAW,EAAE;AAC3B,QAAQ,IAAI,KAAK,KAAK,WAAW,EAAE;AACnC,UAAU,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACxC,QAAQ,CAAC;AACT,QAAQ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK;AACxC,UAAU,MAAM,UAAU,GAAG,MAAM;AACnC,YAAY,IAAI,KAAK,KAAK,WAAW,EAAE;AACvC,cAAc,OAAO,CAAC,KAAK,CAAC,CAAC;AAC7B,YAAY,CAAC,MAAM;AACnB,cAAc,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACpD,YAAY,CAAC;AACb,UAAU,CAAC,CAAC;AACZ,UAAU,UAAU,EAAE,CAAC;AACvB,QAAQ,CAAC,CAAC,CAAC;AACX,MAAM,CAAC;AACP,KAAK,CAAC;AACN,EAAE,CAAC;AACH;;ACzJO,SAAS,kBAAkB,CAAC,OAAO,GAAG,EAAE,EAAE;AACjD,EAAE,MAAM,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,MAAM,GAAG,EAAE,EAAE,GAAG,OAAO;AAC3D;AACA;AACA,EAAE,MAAM,OAAO,GAAG;AAClB,IAAI,GAAG,EAAE,YAAY,CAAC,GAAG;AACzB,IAAI,EAAE,EAAE,YAAY,CAAC,EAAE;AACvB,IAAI,IAAI,EAAE,YAAY,CAAC,IAAI;AAC3B,IAAI,UAAU,EAAE,YAAY,CAAC,UAAU;AACvC,IAAI,GAAG,EAAE,YAAY,CAAC,GAAG;AACzB,IAAI,IAAI,EAAE,YAAY,CAAC,IAAI;AAC3B,IAAI,GAAG,EAAE,YAAY,CAAC,GAAG;AACzB,IAAI,IAAI,EAAE,YAAY,CAAC,IAAI;AAC3B,IAAI,QAAQ,EAAE,YAAY,CAAC;AAC3B,GAAG;AACH;AACA;AACA,EAAE,MAAM,MAAM,GAAG,EAAE;AACnB,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK;AACjD;AACA,IAAI,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG;AACvC,IAAI,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;AACrD,IAAI,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;AAC1B,EAAE,CAAC,CAAC;AACJ;AACA,EAAE,OAAO,MAAM;AACf;;;;"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "promise-logic",
+  "version": "1.0.0",
+  "description": "Compose promises with logic gate semantics (AND, OR, XOR, NAND, NOR, XNOR, Majority). Forget APIs, remember logic.",
+  "type": "module",
+  "main": "dist/index.cjs.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./factory": {
+      "import": "./dist/factory.esm.js",
+      "require": "./dist/factory.cjs.js",
+      "types": "./dist/types/factory.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "test": "jest --config jest.config.cjs",
+    "test:watch": "jest --watch --config jest.config.cjs",
+    "test:coverage": "jest --coverage --config jest.config.cjs",
+    "lint": "eslint src test",
+    "lint:fix": "eslint src test --fix",
+    "format": "prettier --write \"src/**/*.js\" \"test/**/*.js\"",
+    "prepublishOnly": "npm run build && npm test",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "promise",
+    "logic",
+    "async",
+    "logic-gates",
+    "xor",
+    "nand",
+    "nor",
+    "xnor",
+    "majority",
+    "combinational",
+    "async-programming",
+    "concurrency"
+  ],
+  "author": {
+    "name": "再乔乔我一下 (Let me hug you again)",
+    "email": "2820387220@qq.com"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/xier123456/promise-logic.git"
+  },
+  "bugs": {
+    "url": "https://github.com/xier123456/promise-logic.git/issues"
+  },
+  "homepage": "https://github.com/xier123456/promise-logic/docs/promise_logic",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "sideEffects": false,
+  "devDependencies": {
+    "@babel/core": "^7.28.6",
+    "@babel/preset-env": "^7.28.6",
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@types/jest": "^30.0.0",
+    "babel-jest": "^30.2.0",
+    "eslint": "^8.0.0",
+    "jest": "^29.0.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "prettier": "^3.0.0",
+    "rollup": "^4.0.0"
+  },
+  "dependencies": {
+    "@monaco-editor/react": "^4.7.0",
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.4.0"
+  }
+}