@nsxbet/playwright-orchestrator 0.6.3 → 0.8.0

package/README.md

@@ -25,29 +25,48 @@ This orchestrator:
 
 Result: All shards finish at roughly the same time.
 
+### Test-Level Distribution
+
+Unlike other solutions that only distribute at the **file level**, this orchestrator supports **test-level distribution**. This matters when you have files with many tests of varying durations - distributing individual tests achieves much better balance than distributing entire files.
+
+```
+File-level:  login.spec.ts (50 tests, 10min) → all go to shard 1
+Test-level:  login.spec.ts tests → spread across shards 1-4
+```
+
+Test-level distribution requires the reporter AND a test fixture to filter tests at runtime. See [Setup](#setup) below.
+
 ## Quick Start
 
 ```bash
 # Install
 bun add -D @nsxbet/playwright-orchestrator
 
-# Discover tests (uses Playwright --list for accurate discovery)
-playwright-orchestrator list-tests --test-dir ./e2e --project "Mobile Chrome"
+# Generate test list
+bunx playwright test --list --reporter=json --project "Mobile Chrome" > test-list.json
 
-# Assign tests to shards (with timing data)
-playwright-orchestrator assign \
-  --test-dir ./e2e \
+# Assign tests to shards
+bunx playwright-orchestrator assign \
+  --test-list ./test-list.json \
   --timing-file ./timing-data.json \
-  --shards 4 \
-  --project "Mobile Chrome"  # Recommended for accurate test discovery
+  --shards 4 > assignment.json
+
+# Extract each shard's tests to separate files
+jq '.shards."1"' assignment.json > shard-1.json
+jq '.shards."2"' assignment.json > shard-2.json
+jq '.shards."3"' assignment.json > shard-3.json
+jq '.shards."4"' assignment.json > shard-4.json
 
-# Extract timing from report
-playwright-orchestrator extract-timing \
+# Run tests for a specific shard (fixture filters based on ORCHESTRATOR_SHARD_FILE)
+ORCHESTRATOR_SHARD_FILE=shard-1.json bunx playwright test --project "Mobile Chrome"
+
+# Extract timing from report after tests complete
+bunx playwright-orchestrator extract-timing \
   --report-file ./playwright-report/results.json \
   --output-file ./shard-1-timing.json
 
-# Merge timing data
-playwright-orchestrator merge-timing \
+# Merge timing data from all shards
+bunx playwright-orchestrator merge-timing \
   --existing ./timing-data.json \
   --new ./shard-1-timing.json ./shard-2-timing.json \
   --output ./timing-data.json
@@ -70,9 +89,11 @@ playwright-orchestrator merge-timing \
 2. **Run Tests**: Each shard reads its files from `needs.orchestrate.outputs`
 3. **Merge**: Collect timing from all shards, update history with EMA
 
-## Reporter Setup
+## Setup
+
+For test-level distribution to work, you need **two things**:
 
-Add the reporter to your `playwright.config.ts`:
+### 1. Reporter (in `playwright.config.ts`)
 
 ```typescript
 import { defineConfig } from "@playwright/test";
@@ -82,7 +103,33 @@ export default defineConfig({
 });
 ```
 
-The reporter reads `ORCHESTRATOR_SHARD_FILE` env var to filter tests for the current shard.
+### 2. Test Fixture (in your test setup file)
+
+Wrap your base test with `withOrchestratorFilter`:
+
+```typescript
+// e2e/setup.ts
+import { test as base } from "@playwright/test";
+import { withOrchestratorFilter } from "@nsxbet/playwright-orchestrator/fixture";
+
+export const test = withOrchestratorFilter(base);
+export { expect } from "@playwright/test";
+```
+
+Then use this `test` in your spec files:
+
+```typescript
+// e2e/login.spec.ts
+import { test, expect } from "./setup";
+
+test("should login", async ({ page }) => {
+  // ...
+});
+```
+
+The reporter and fixture work together:
+- **Reporter**: Reads `ORCHESTRATOR_SHARD_FILE` env var to know which tests belong to this shard
+- **Fixture**: Skips tests that don't belong to the current shard at runtime
 
 ## Local Testing
 
@@ -143,9 +190,9 @@ jobs:
       - uses: NSXBet/playwright-orchestrator/.github/actions/orchestrate@v0
         id: orchestrate
         with:
-          test-list: test-list.json # Use pre-generated list (recommended)
+          test-list: test-list.json # Required: pre-generated list
+          timing-file: timing-data.json # Required: timing data
           shards: 4
-          timing-file: timing-data.json
 
   # Phase 2: Run tests (parallel matrix)
   e2e:
@@ -176,17 +223,14 @@ See [docs/external-integration.md](./docs/external-integration.md) for complete
 
 ## CLI Commands
 
-| Command          | Description                                                                      |
-| ---------------- | -------------------------------------------------------------------------------- |
-| `list-tests`     | Discover tests in a project (uses Playwright `--list`)                           |
-| `assign`         | Distribute tests across shards (uses Playwright `--list` for accurate discovery) |
-| `extract-timing` | Extract timing from Playwright report                                            |
-| `merge-timing`   | Merge timing data with EMA smoothing                                             |
+| Command          | Description                              |
+| ---------------- | ---------------------------------------- |
+| `assign`         | Distribute tests across shards           |
+| `extract-timing` | Extract timing from Playwright report    |
+| `merge-timing`   | Merge timing data with EMA smoothing     |
 
 Run `playwright-orchestrator <command> --help` for details.
 
-**Important**: The `--project` flag is recommended for both `list-tests` and `assign` commands to ensure accurate test discovery, especially for parameterized tests (e.g., `test.each`).
-
 ## Development
 
 ```bash
@@ -235,6 +279,18 @@ Test scenarios covered in `examples/monorepo/`:
 
 See [AGENTS.md](./AGENTS.md) for AI assistant instructions.
 
+## Cache Strategy
+
+GitHub Actions cache is branch-scoped, which creates challenges for sharing timing data between PRs and main. We recommend a **promote-on-merge** pattern:
+
+1. Each PR branch saves to its own cache key
+2. PRs restore from their own cache, falling back to main
+3. When a PR is merged, a workflow promotes the PR's cache to main
+
+This avoids race conditions between concurrent PRs while ensuring main always has the latest timing data.
+
+See [Cache Strategy for PRs](./docs/external-integration.md#cache-strategy-for-prs) for implementation details.
+
 ## License
 
 MIT

package/dist/fixture.d.ts

@@ -6,10 +6,21 @@
  *
  * Usage in your test setup file (e.g., tests/setup.ts):
  * ```typescript
- * import { test } from '@playwright/test';
- * import { setupOrchestratorFilter } from '@nsxbet/playwright-orchestrator/fixture';
+ * import { test as base } from '@playwright/test';
+ * import { withOrchestratorFilter } from '@nsxbet/playwright-orchestrator/fixture';
  *
- * setupOrchestratorFilter(test);
+ * // Create extended test with orchestrator filtering
+ * export const test = withOrchestratorFilter(base);
+ * export { expect } from '@playwright/test';
+ * ```
+ *
+ * Then in your test files:
+ * ```typescript
+ * import { test, expect } from './setup';
+ *
+ * test('my test', async ({ page }) => {
+ *   // ...
+ * });
  * ```
  *
  * Environment variables:
@@ -20,6 +31,35 @@
  */
 import type { TestType } from '@playwright/test';
 /**
+ * Creates an extended test with orchestrator filtering as an auto-fixture.
+ * This ensures tests not in the current shard are skipped.
+ *
+ * IMPORTANT: Use this function to create your test object, then export it.
+ * All test files should import the extended test, not the base test.
+ *
+ * @param test - The base test object from @playwright/test
+ * @returns Extended test with orchestrator filtering
+ *
+ * @example
+ * ```typescript
+ * // In setup.ts
+ * import { test as base } from '@playwright/test';
+ * import { withOrchestratorFilter } from '@nsxbet/playwright-orchestrator/fixture';
+ *
+ * export const test = withOrchestratorFilter(base);
+ *
+ * // In your.spec.ts
+ * import { test } from './setup';
+ * test('example', async ({ page }) => { ... });
+ * ```
+ */
+export declare function withOrchestratorFilter<T extends object, W extends object>(test: TestType<T, W>): TestType<T & {
+    _orchestratorFilter: undefined;
+}, W>;
+/**
+ * @deprecated Use `withOrchestratorFilter` instead. This function uses beforeEach
+ * which only works for the first test file processed, not subsequent files.
+ *
  * Sets up the orchestrator filter as a beforeEach hook.
  * This will skip tests that are not in the current shard.
  *

package/dist/fixture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAuDjD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACxE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,IAAI,CAoCN;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,GAAG,OAAO,CAUV"}
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAuDjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACvE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,QAAQ,CAAC,CAAC,GAAG;IAAE,mBAAmB,EAAE,SAAS,CAAA;CAAE,EAAE,CAAC,CAAC,CAwDrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACxE,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GACnB,IAAI,CAoCN;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5C,GAAG,OAAO,CAUV"}

package/dist/fixture.js

@@ -6,10 +6,21 @@
  *
  * Usage in your test setup file (e.g., tests/setup.ts):
  * ```typescript
- * import { test } from '@playwright/test';
- * import { setupOrchestratorFilter } from '@nsxbet/playwright-orchestrator/fixture';
+ * import { test as base } from '@playwright/test';
+ * import { withOrchestratorFilter } from '@nsxbet/playwright-orchestrator/fixture';
  *
- * setupOrchestratorFilter(test);
+ * // Create extended test with orchestrator filtering
+ * export const test = withOrchestratorFilter(base);
+ * export { expect } from '@playwright/test';
+ * ```
+ *
+ * Then in your test files:
+ * ```typescript
+ * import { test, expect } from './setup';
+ *
+ * test('my test', async ({ page }) => {
+ *   // ...
+ * });
  * ```
  *
  * Environment variables:
@@ -59,6 +70,67 @@ function loadShardFile() {
     }
 }
 /**
+ * Creates an extended test with orchestrator filtering as an auto-fixture.
+ * This ensures tests not in the current shard are skipped.
+ *
+ * IMPORTANT: Use this function to create your test object, then export it.
+ * All test files should import the extended test, not the base test.
+ *
+ * @param test - The base test object from @playwright/test
+ * @returns Extended test with orchestrator filtering
+ *
+ * @example
+ * ```typescript
+ * // In setup.ts
+ * import { test as base } from '@playwright/test';
+ * import { withOrchestratorFilter } from '@nsxbet/playwright-orchestrator/fixture';
+ *
+ * export const test = withOrchestratorFilter(base);
+ *
+ * // In your.spec.ts
+ * import { test } from './setup';
+ * test('example', async ({ page }) => { ... });
+ * ```
+ */
+export function withOrchestratorFilter(test) {
+    return test.extend({
+        // @ts-expect-error - Playwright's auto fixture typing is complex
+        _orchestratorFilter: [
+            async (
+            // biome-ignore lint/correctness/noEmptyPattern: Playwright requires empty destructuring
+            {}, use, testInfo) => {
+                const allowedTestIds = loadShardFile();
+                if (allowedTestIds) {
+                    // CRITICAL: Use project.testDir for consistent path resolution with test-discovery
+                    // No fallback to process.cwd() - this causes path mismatch bugs
+                    const testDir = testInfo.project.testDir;
+                    if (!testDir) {
+                        throw new Error('[Orchestrator Fixture] Could not determine project testDir. ' +
+                            'Ensure your playwright.config.ts has projects configured with testDir.');
+                    }
+                    const testId = buildTestIdFromRuntime(testInfo.file, testInfo.titlePath, {
+                        projectName: testInfo.project.name,
+                        baseDir: testDir,
+                    });
+                    const isAllowed = allowedTestIds.has(testId);
+                    // Debug: Write to stderr for visibility in CI logs
+                    if (process.env.ORCHESTRATOR_DEBUG === '1') {
+                        process.stderr.write(`[Fixture] testDir=${testInfo.project.testDir} | testId=${testId} | allowed=${isAllowed}\n`);
+                    }
+                    if (!isAllowed) {
+                        test.skip(true, 'Not in shard');
+                    }
+                }
+                await use();
+            },
+            { auto: true },
+        ],
+    });
+}
+/**
+ * @deprecated Use `withOrchestratorFilter` instead. This function uses beforeEach
+ * which only works for the first test file processed, not subsequent files.
+ *
  * Sets up the orchestrator filter as a beforeEach hook.
  * This will skip tests that are not in the current shard.
  *

package/dist/fixture.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nsxbet/playwright-orchestrator",
-  "version": "0.6.3",
+  "version": "0.8.0",
   "description": "Intelligent Playwright test distribution across CI shards using historical timing data",
   "type": "module",
   "main": "dist/index.js",
@@ -12,6 +12,9 @@
       ],
       "fixture": [
         "./dist/fixture.d.ts"
+      ],
+      "core": [
+        "./dist/core/index.d.ts"
       ]
     }
   },
@@ -30,6 +33,11 @@
       "types": "./dist/fixture.d.ts",
       "import": "./dist/fixture.js",
       "require": "./dist/fixture.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.js"
     }
   },
   "bin": {

package/dist/commands/list-tests.d.ts

@@ -1,16 +0,0 @@
-import { Command } from '@oclif/core';
-export default class ListTests extends Command {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        'test-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'output-format': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'glob-pattern': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'use-fallback': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    run(): Promise<void>;
-    private outputResult;
-}
-//# sourceMappingURL=list-tests.d.ts.map

package/dist/commands/list-tests.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-tests.d.ts","sourceRoot":"","sources":["../../src/commands/list-tests.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAQ7C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,OAAgB,WAAW,SACiD;IAE5E,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;;;;;;MA6BnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC1B,OAAO,CAAC,YAAY;CA4BrB"}

package/dist/commands/list-tests.js

@@ -1,98 +0,0 @@
-import * as path from 'node:path';
-import { Command, Flags } from '@oclif/core';
-import { discoverTests, discoverTestsFromFiles, groupTestsByFile, } from '../core/index.js';
-export default class ListTests extends Command {
-    static description = 'Discover all tests in a Playwright project using --list or file parsing';
-    static examples = [
-        '<%= config.bin %> list-tests --test-dir ./src/test/e2e',
-        '<%= config.bin %> list-tests --test-dir ./e2e --project "Mobile Chrome" --output-format json',
-    ];
-    static flags = {
-        'test-dir': Flags.string({
-            char: 'd',
-            description: 'Path to test directory',
-            required: true,
-        }),
-        project: Flags.string({
-            char: 'p',
-            description: 'Playwright project name',
-        }),
-        'output-format': Flags.string({
-            char: 'f',
-            description: 'Output format',
-            default: 'json',
-            options: ['json', 'text'],
-        }),
-        'glob-pattern': Flags.string({
-            description: 'Glob pattern for test files (used for fallback discovery)',
-            default: '**/*.spec.ts',
-        }),
-        'use-fallback': Flags.boolean({
-            description: 'Use file parsing instead of Playwright --list',
-            default: false,
-        }),
-        verbose: Flags.boolean({
-            char: 'v',
-            description: 'Show verbose output',
-            default: false,
-        }),
-    };
-    async run() {
-        const { flags } = await this.parse(ListTests);
-        const testDir = path.resolve(flags['test-dir']);
-        if (flags.verbose) {
-            this.log(`Discovering tests in ${testDir}...`);
-        }
-        let tests;
-        try {
-            if (flags['use-fallback']) {
-                // Use file parsing
-                tests = discoverTestsFromFiles(testDir, flags['glob-pattern']);
-                if (flags.verbose) {
-                    this.log('Using file parsing for test discovery');
-                }
-            }
-            else {
-                // Use Playwright --list
-                tests = discoverTests(testDir, flags.project);
-                if (flags.verbose) {
-                    this.log('Using Playwright --list for test discovery');
-                }
-            }
-        }
-        catch {
-            // Fallback to file parsing if Playwright --list fails
-            if (flags.verbose) {
-                this.warn('Playwright --list failed, falling back to file parsing');
-            }
-            tests = discoverTestsFromFiles(testDir, flags['glob-pattern']);
-        }
-        if (flags.verbose) {
-            this.log(`Discovered ${tests.length} tests`);
-        }
-        this.outputResult(tests, flags['output-format'], flags.verbose);
-    }
-    outputResult(tests, format, verbose = false) {
-        if (format === 'json') {
-            this.log(JSON.stringify(tests));
-        }
-        else {
-            // Text format - group by file
-            const grouped = groupTestsByFile(tests);
-            this.log('\n=== Discovered Tests ===\n');
-            for (const [file, fileTests] of grouped) {
-                this.log(`${file}:`);
-                for (const test of fileTests) {
-                    const titlePath = test.titlePath.join(' > ');
-                    this.log(`  - ${titlePath}`);
-                    if (verbose) {
-                        this.log(`    ID: ${test.testId}`);
-                    }
-                }
-                this.log('');
-            }
-            this.log(`Total: ${tests.length} tests in ${grouped.size} files`);
-        }
-    }
-}
-//# sourceMappingURL=list-tests.js.map

package/dist/commands/list-tests.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"list-tests.js","sourceRoot":"","sources":["../../src/commands/list-tests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAEL,aAAa,EACb,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAU,WAAW,GACzB,yEAAyE,CAAC;IAE5E,MAAM,CAAU,QAAQ,GAAG;QACzB,wDAAwD;QACxD,8FAA8F;KAC/F,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,wBAAwB;YACrC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,yBAAyB;SACvC,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,eAAe;YAC5B,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;SAC1B,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC;YAC3B,WAAW,EAAE,2DAA2D;YACxE,OAAO,EAAE,cAAc;SACxB,CAAC;QACF,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC;YAC5B,WAAW,EAAE,+CAA+C;YAC5D,OAAO,EAAE,KAAK;SACf,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,GAAG;YACT,WAAW,EAAE,qBAAqB;YAClC,OAAO,EAAE,KAAK;SACf,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAEhD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,wBAAwB,OAAO,KAAK,CAAC,CAAC;QACjD,CAAC;QAED,IAAI,KAAuB,CAAC;QAE5B,IAAI,CAAC;YACH,IAAI,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC1B,mBAAmB;gBACnB,KAAK,GAAG,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;gBAC/D,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,IAAI,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,wBAAwB;gBACxB,KAAK,GAAG,aAAa,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC9C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAClB,IAAI,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;YACtD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;YACtE,CAAC;YACD,KAAK,GAAG,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAEO,YAAY,CAClB,KAAuB,EACvB,MAAc,EACd,OAAO,GAAG,KAAK;QAEf,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,8BAA8B;YAC9B,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAExC,IAAI,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAEzC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;gBACrB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;oBAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBAC7C,IAAI,CAAC,GAAG,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC;oBAC7B,IAAI,OAAO,EAAE,CAAC;wBACZ,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACf,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,MAAM,aAAa,OAAO,CAAC,IAAI,QAAQ,CAAC,CAAC;QACpE,CAAC;IACH,CAAC"}