@feasibleone/blong-chain 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [1.1.0](https://github.com/feasibleone/blong/compare/blong-chain-v1.0.1...blong-chain-v1.1.0) (2026-02-05)
+
+
+### Features
+
+* add checkpoint support ([#19](https://github.com/feasibleone/blong/issues/19)) ([097a7b8](https://github.com/feasibleone/blong/commit/097a7b80544b28f03f47f0ad6de186baf21004a1))
+
+## [1.0.1](https://github.com/feasibleone/blong/compare/blong-chain-v1.0.0...blong-chain-v1.0.1) (2026-02-03)
+
+
+### Bug Fixes
+
+* publishing ([dac7a64](https://github.com/feasibleone/blong/commit/dac7a649340467c026764abe102caa4f03599fe1))
+
+## 1.0.0 (2026-02-03)
+
+
+### Features
+
+* implement blong-chain parallel testing framework ([589bd58](https://github.com/feasibleone/blong/commit/589bd587be36d9afea3e7eea35dea63c30255ee6))
+* nested test context integration and error reporting capabilities ([9470aa5](https://github.com/feasibleone/blong/commit/9470aa53c9d1d676cd50ff004b3bb0eea491d782))

package/README.md

@@ -0,0 +1,559 @@
+# @feasibleone/blong-chain
+
+**Parallel test execution with automatic dependency detection through thenable proxies.**
+
+`blong-chain` is a TypeScript test framework that automatically detects
+dependencies between test steps and executes them in parallel when possible,
+maximizing performance while maintaining correctness.
+
+## Key Features
+
+- 🚀 **Automatic Parallelization** - Independent steps run concurrently
+- 🔗 **Dependency Detection** - Access patterns automatically create dependencies
+- 📊 **Progress Tracking** - Real-time execution monitoring with events
+- 🎯 **Thenable Proxies** - Natural async/await syntax for step dependencies
+- 📈 **Performance Metrics** - Queue time, execution time, and critical path analysis
+- 🌳 **Nested Groups** - Hierarchical test organization with proper indentation
+- 🔧 **Error Handling** - Graceful failure with continued execution of
+  independent steps
+- 🧪 **Test Framework Integration** - Works seamlessly with node:test, tap,
+  and others
+
+## Installation
+
+```bash
+npm install @feasibleone/blong-chain
+```
+
+## Quick Start
+
+```typescript
+import {TestExecutor} from '@feasibleone/blong-chain';
+import assert from 'node:assert/strict';
+import {test} from 'node:test';
+
+test('parallel execution example', async (t) => {
+    const executor = new TestExecutor({concurrency: 10});
+
+    const steps = [
+        async function fetchUser(assert, context) {
+            // Independent - runs immediately
+            return {id: 1, name: 'Alice'};
+        },
+
+        async function fetchAccount(assert, context) {
+            // Independent - runs in parallel with fetchUser
+            return {balance: 1000};
+        },
+
+        async function validateUser(assert, {fetchUser}) {
+            // Dependent - waits for fetchUser to complete
+            const user = await fetchUser;
+            assert.equal(user.name, 'Alice');
+            return {validated: true};
+        },
+
+        async function generateReport(assert, {fetchUser, fetchAccount}) {
+            // Multiple dependencies - waits for both
+            const user = await fetchUser;
+            const account = await fetchAccount;
+            return `User ${user.name} has balance ${account.balance}`;
+        },
+    ];
+
+    await executor.execute(steps, {testId: 'example'}, t);
+});
+```
+
+## Core Concepts
+
+### Thenable Proxies
+
+Steps access previous results through thenable proxies that automatically track
+dependencies:
+
+```typescript
+// Pattern 1: Direct await
+async function step1(assert, {previousStep}) {
+    const result = await previousStep;
+}
+
+// Pattern 2: Destructure then await
+async function step2(assert, {previousStep}) {
+    const result = await previousStep;
+}
+
+// Pattern 3: Nested property access
+async function step3(assert, {previousStep}) {
+    const name = await previousStep.user.name;
+}
+
+// Pattern 4: Deep destructuring
+async function step4(assert, {previousStep: {user: {name}}}) {
+    const userName = await name;
+}
+```
+
+### Automatic Parallelization
+
+The executor analyzes your access patterns and runs independent steps concurrently:
+
+```typescript
+const steps = [
+    async function stepA() {
+        // Runs immediately
+        await someAsyncWork();
+        return {dataA: 'A'};
+    },
+
+    async function stepB() {
+        // Runs immediately in parallel with stepA
+        await someAsyncWork();
+        return {dataB: 'B'};
+    },
+
+    async function stepC(assert, {stepA}) {
+        // Waits for stepA (automatic dependency)
+        const a = await stepA;
+        return {dataC: a.dataA + 'C'};
+    },
+
+    async function stepD(assert, {stepA, stepB}) {
+        // Waits for both stepA and stepB (parallel wait)
+        const a = await stepA;
+        const b = await stepB;
+        assert.ok(a.dataA);
+        assert.ok(b.dataB);
+        return {dataD: 'D'};
+    },
+];
+```
+
+### Meta Information
+
+The special `$meta` property is always available directly without await:
+
+```typescript
+async function myStep(assert, {$meta}) {
+    // Access meta synchronously
+    console.log($meta.testId);
+    console.log($meta.environment);
+
+    // Meta is passed when executing
+    await executor.execute(steps, {
+        testId: 'test-123',
+        environment: 'production',
+    });
+}
+```
+
+## Advanced Features
+
+### Nested Test Groups
+
+Organize steps into hierarchical groups for better structure and output:
+
+```typescript
+const databaseSetup = [
+    async function connect() { return {connected: true}; },
+    async function createSchema() { return {created: true}; },
+    async function seedData() { return {users: []}; },
+] as any;
+databaseSetup.name = 'Database Setup';
+
+const apiTests = [
+    async function testEndpoint1() { return {status: 200}; },
+    async function testEndpoint2() { return {status: 200}; },
+] as any;
+apiTests.name = 'API Tests';
+
+const steps = [
+    async function initialize() { return {ready: true}; },
+    databaseSetup,  // Nested group
+    apiTests,       // Nested group
+    async function cleanup() { return {done: true}; },
+];
+
+await executor.execute(steps, {}, t);
+```
+
+**Output:**
+
+```text
+▶ Test Name
+  ✔ initialize
+  ▶ Database Setup
+    ✔ connect
+    ✔ createSchema
+    ✔ seedData
+  ✔ Database Setup
+  ▶ API Tests
+    ✔ testEndpoint1
+    ✔ testEndpoint2
+  ✔ API Tests
+  ✔ cleanup
+```
+
+### Checkpoints (Synchronization Barriers)
+
+Use empty arrays `[]` as checkpoints to synchronize parallel execution. All steps before a checkpoint must complete before any steps after it begin:
+
+```typescript
+const steps = [
+    // Phase 1: These run in parallel
+    async function loadConfig() {
+        await fetchConfig();
+        return {apiUrl: 'https://api.example.com'};
+    },
+
+    async function initializeCache() {
+        await setupCache();
+        return {cacheReady: true};
+    },
+
+    async function setupLogging() {
+        await configureLogger();
+        return {loggerReady: true};
+    },
+
+    // Checkpoint: Wait for all Phase 1 steps to complete
+    [],
+
+    // Phase 2: These run in parallel, but only after Phase 1 completes
+    async function loadUsers({loadConfig}) {
+        const config = await loadConfig;
+        return await fetchUsers(config.apiUrl);
+    },
+
+    async function loadProducts({loadConfig}) {
+        const config = await loadConfig;
+        return await fetchProducts(config.apiUrl);
+    },
+
+    // Another checkpoint
+    [],
+
+    // Phase 3: Runs only after Phase 2 completes
+    async function generateReport({loadUsers, loadProducts}) {
+        const users = await loadUsers;
+        const products = await loadProducts;
+        return {report: combineData(users, products)};
+    },
+];
+```
+
+**Use Cases:**
+- **Phased execution**: Separate initialization, data loading, processing, and cleanup phases
+- **Resource management**: Ensure all resources are ready before proceeding
+- **Testing stages**: Complete all setup before running tests, then cleanup
+- **Performance control**: Balance parallelism with resource constraints
+
+### Progress Tracking and Events
+
+Monitor test execution in real-time:
+
+```typescript
+const executor = new TestExecutor({concurrency: 10});
+
+executor.on('test:start', (progress) => {
+    console.log('Test started:', progress.testName);
+});
+
+executor.on('step:start', (stepName, progress) => {
+    console.log('Step started:', stepName);
+});
+
+executor.on('step:end', (stepName, progress) => {
+    console.log('Step completed:', stepName, `in ${progress.duration}ms`);
+});
+
+executor.on('step:error', (stepName, error, progress) => {
+    console.error('Step failed:', stepName, error.message);
+});
+
+await executor.execute(steps, {});
+
+// Get final progress
+const progress = executor.getProgress();
+console.log(`Completed ${progress.completedSteps}/${progress.totalSteps} steps`);
+console.log(`Failed: ${progress.failedSteps}`);
+```
+
+### Dependency Graph Analysis
+
+Inspect the dependency relationships:
+
+```typescript
+await executor.execute(steps, {});
+
+const graph = executor.getDependencyGraph();
+
+// View all steps
+for (const [name, node] of graph.nodes) {
+    console.log(`${name}: ${node.status}`);
+}
+
+// View dependencies
+for (const edge of graph.edges) {
+    console.log(`${edge.from} depends on ${edge.to} via ${edge.property}`);
+}
+```
+
+### Performance Metrics
+
+Analyze execution performance:
+
+```typescript
+await executor.execute(steps, {});
+
+const latency = executor.getLatencyReport();
+
+console.log(`Total duration: ${latency.totalDuration}ms`);
+console.log(`Parallel efficiency: ${latency.parallelEfficiency.toFixed(2)}x`);
+console.log(`Critical path: ${latency.criticalPath.join(' → ')}`);
+
+// View bottlenecks
+for (const bottleneck of latency.bottlenecks) {
+    console.log(
+        `${bottleneck.stepName} blocked ${bottleneck.blockedSteps.length} steps`
+    );
+}
+
+// View individual step metrics
+for (const [name, metrics] of latency.steps) {
+    console.log(`${name}:`, {
+        queue: metrics.queueTime,
+        wait: metrics.waitTime,
+        exec: metrics.executionTime,
+    });
+}
+```
+
+### Error Handling
+
+Steps fail gracefully while independent steps continue:
+
+```typescript
+const steps = [
+    async function stepA() {
+        return {data: 'A'};
+    },
+
+    async function stepB() {
+        throw new Error('Step B failed');
+    },
+
+    async function stepC(assert, {stepA}) {
+        // This still runs - it's independent of stepB
+        const a = await stepA;
+        return {data: 'C'};
+    },
+
+    async function stepD(assert, {stepB}) {
+        // This can handle the error if needed
+        try {
+            await stepB;
+        } catch (error) {
+            assert.ok(error.message.includes('Step B failed'));
+            return {handled: true};
+        }
+    },
+];
+
+await executor.execute(steps, {});
+
+// Check which steps failed
+const progress = executor.getProgress();
+for (const [name, step] of progress.steps) {
+    if (step.status === 'failed') {
+        console.log(`${name} failed:`, step.error?.message);
+    }
+}
+```
+
+## Configuration Options
+
+```typescript
+const executor = new TestExecutor({
+    // Maximum concurrent steps (default: 10)
+    concurrency: 5,
+
+    // Capture stack traces for better error reporting (default: false)
+    // Note: Has performance impact
+    captureStackTraces: true,
+
+    // Test framework context (optional)
+    // Passed automatically when using test framework integration
+    framework: undefined,
+});
+```
+
+## Real-World Example
+
+```typescript
+test('e-commerce checkout flow', async (t) => {
+    const executor = new TestExecutor({concurrency: 5});
+
+    const steps = [
+        async function loadProduct(assert, context) {
+            await new Promise(resolve => setTimeout(resolve, 30));
+            return {productId: 'PROD-123', price: 99.99, inStock: true};
+        },
+
+        async function loadCart(assert, context) {
+            await new Promise(resolve => setTimeout(resolve, 30));
+            return {cartId: 'CART-456', items: 2};
+        },
+
+        async function validateInventory(assert, {loadProduct}) {
+            const product = await loadProduct;
+            assert.ok(product.inStock);
+            return {valid: true, reservationId: 'RES-789'};
+        },
+
+        async function calculateShipping(assert, {loadCart}) {
+            const cart = await loadCart;
+            return {cost: 9.99, days: 3};
+        },
+
+        async function calculateTax(assert, {loadProduct}) {
+            const product = await loadProduct;
+            return {amount: product.price * 0.08};
+        },
+
+        async function calculateTotal(assert, {
+            loadProduct, calculateShipping, calculateTax
+        }) {
+            const product = await loadProduct;
+            const shipping = await calculateShipping;
+            const tax = await calculateTax;
+
+            return {
+                total: product.price + shipping.cost + tax.amount,
+                breakdown: {
+                    product: product.price,
+                    shipping: shipping.cost,
+                    tax: tax.amount,
+                },
+            };
+        },
+
+        async function processPayment(assert, {
+            calculateTotal, validateInventory
+        }) {
+            const total = await calculateTotal;
+            const inventory = await validateInventory;
+
+            assert.ok(inventory.valid);
+            await new Promise(resolve => setTimeout(resolve, 40));
+
+            return {
+                paymentId: 'PAY-999',
+                amount: total.total,
+                status: 'completed',
+            };
+        },
+
+        async function createOrder(assert, {processPayment}) {
+            const payment = await processPayment;
+            assert.equal(payment.status, 'completed');
+
+            return {
+                orderId: 'ORD-111',
+                paymentId: payment.paymentId,
+            };
+        },
+    ];
+
+    await executor.execute(steps, {
+        testId: 'checkout-001',
+        environment: 'test',
+    }, t);
+
+    // Verify results
+    const progress = executor.getProgress();
+    assert.equal(progress.status, 'completed');
+    assert.equal(progress.failedSteps, 0);
+
+    const latency = executor.getLatencyReport();
+    console.log(`Completed in ${latency.totalDuration}ms`);
+    console.log(`Parallel efficiency: ${latency.parallelEfficiency.toFixed(2)}x`);
+});
+```
+
+In this example:
+
+- `loadProduct` and `loadCart` run in parallel immediately
+- `validateInventory` and `calculateShipping` wait only for their specific dependencies
+- `calculateTax` runs as soon as `loadProduct` completes
+- `calculateTotal` waits for all pricing components
+- `processPayment` and `createOrder` form the critical path
+- Total execution time is significantly less than sequential execution
+
+## Documentation
+
+- **[SHOWCASE.md](./SHOWCASE.md)** - Comprehensive feature showcase with all patterns
+- **[TESTING.md](./TESTING.md)** - Testing guide and CI integration
+- **[NESTED_TEST_CONTEXT.md](./NESTED_TEST_CONTEXT.md)** - Test framework
+  integration details
+- **[test-types.ts](./test-types.ts)** - Complete TypeScript API documentation
+
+## Running Tests
+
+```bash
+# Run unit tests
+npm test
+
+# Run showcase examples
+npm run build
+node --test dist/showcase.test.js
+
+# Run all tests
+npm run test:all
+```
+
+## How It Works
+
+1. **Detection Phase**: When you destructure or access `context.stepName`, a
+   thenable proxy is returned
+2. **Dependency Tracking**: The access is recorded as a dependency
+3. **Scheduling Phase**: Steps are added to a priority queue based on dependencies
+4. **Execution Phase**: Steps run as soon as all their dependencies complete
+5. **Resolution Phase**: Step results are stored and proxies are resolved
+6. **Checkpoints**: Empty arrays `[]` create synchronization barriers, waiting for
+   all previous steps to complete before continuing
+
+This creates a dynamic dependency graph that enables maximum parallelization
+while ensuring correctness, with optional synchronization points for phased execution.
+
+## Use Cases
+
+- **Integration Tests** - Test complex workflows with many async operations
+- **E2E Tests** - Reduce test suite execution time through parallelization
+- **Data Pipelines** - Orchestrate parallel data processing steps
+- **API Testing** - Test multiple endpoints with shared setup steps
+- **Performance Testing** - Identify bottlenecks with built-in metrics
+
+## TypeScript Support
+
+Full TypeScript support with comprehensive type definitions:
+
+```typescript
+import type {
+    ITestExecutor,
+    ITestContext,
+    ITestProgress,
+    IDependencyGraph,
+    ITestLatency,
+    StepFunction,
+    StepArray,
+} from '@feasibleone/blong-chain';
+```
+
+## License
+
+Part of the [Blong Framework](https://github.com/feasibleone/blong)
+
+## Contributing
+
+Issues and pull requests welcome at <https://github.com/feasibleone/blong>

package/dist/examples/demo.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Demonstration of nested test context with automatic indentation
+ * Run with: node --test demo.test.js
+ */
+export {};
+//# sourceMappingURL=demo.test.d.ts.map

package/dist/examples/demo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.test.d.ts","sourceRoot":"","sources":["../../examples/demo.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/examples/demo.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.test.js","sourceRoot":"","sources":["../../examples/demo.test.ts"],"names":[],"mappings":"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"}

package/dist/examples/error-demo.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Demonstration of error reporting in nested test contexts
+ *
+ * This file shows how errors are properly reported with indentation and tracking.
+ * Run with: node --test error-demo.test.js
+ *
+ * You'll see that:
+ * 1. Errors appear in the nested test output with proper indentation
+ * 2. Error details (message, stack trace) are captured
+ * 3. Progress tracking records all error information
+ * 4. Other independent steps continue executing
+ */
+export {};
+//# sourceMappingURL=error-demo.test.d.ts.map

package/dist/examples/error-demo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-demo.test.d.ts","sourceRoot":"","sources":["../../examples/error-demo.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/examples/error-demo.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-demo.test.js","sourceRoot":"","sources":["../../examples/error-demo.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAC,QAAQ,EAAE,EAAE,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzC,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,gDAAgD,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;QAC3D,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;QAE5E,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAC,WAAW,EAAE,EAAE,EAAC,CAAC,CAAC;QAErD,MAAM,KAAK,GAAG;YACV,KAAK,UAAU,YAAY;gBACvB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;gBACjC,OAAO,EAAC,MAAM,EAAE,YAAY,EAAC,CAAC;YAClC,CAAC;YACD,KAAK,UAAU,SAAS;gBACpB,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;YAChF,CAAC;YACD,KAAK,UAAU,YAAY;gBACvB,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;gBACpD,OAAO,EAAC,MAAM,EAAE,YAAY,EAAC,CAAC;YAClC,CAAC;SACJ,CAAC;QAEF,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAQ,CAAC,CAAC;QAE5C,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAElD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,SAAS,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;QAClE,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAC,WAAW,EAAE,EAAE,EAAC,CAAC,CAAC;QAErD,MAAM,WAAW,GAAG;YAChB,KAAK,UAAU,OAAO;gBAClB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;gBAC7C,OAAO,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC;YAC7B,CAAC;YACD,KAAK,UAAU,WAAW;gBACtB,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;gBAChD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,UAAU,YAAY;gBACvB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;gBAC/C,OAAO,EAAC,IAAI,EAAE,EAAE,EAAC,CAAC;YACtB,CAAC;SACG,CAAC;QACT,WAAW,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAEzC,MAAM,KAAK,GAAG;YACV,KAAK,UAAU,IAAI;gBACf,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;gBACxC,OAAO,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC;YACzB,CAAC;YACD,WAAW;YACX,KAAK,UAAU,OAAO;gBAClB,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;gBAC5B,OAAO,EAAC,OAAO,EAAE,IAAI,EAAC,CAAC;YAC3B,CAAC;SACJ,CAAC;QAEF,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAQ,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,iBAAiB,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAElD,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,KAAK,EAAC,CAAC,EAAC,EAAE;QACrE,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAE3D,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,EAAC,WAAW,EAAE,EAAE,EAAC,CAAC,CAAC;QAErD,MAAM,MAAM,GAAG;YACX,KAAK,UAAU,WAAW;gBACtB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBACtC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACvC,CAAC;SACG,CAAC;QACT,MAAM,CAAC,IAAI,GAAG,eAAe,CAAC;QAE9B,MAAM,KAAK,GAAG;YACV,KAAK,UAAU,aAAa;gBACxB,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;gBACtC,OAAO,EAAC,KAAK,EAAE,CAAC,EAAC,CAAC;YACtB,CAAC;YACD,KAAK,UAAU,WAAW;gBACtB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM;SACT,CAAC;QAEF,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,CAAQ,CAAC,CAAC;QAE5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,oBAAoB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QAExD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEpD,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,iCAAiC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEjF,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AACnC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;AAC5B,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;AACvC,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;AACnE,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;AAClE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;AAC1D,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;AAC/D,OAAO,CAAC,GAAG,CAAC,0DAA0D,CAAC,CAAC;AACxE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC"}