openspec-playwright 0.1.16

package/dist/commands/init.js

@@ -0,0 +1,174 @@
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import { readFile } from 'fs/promises';
+const TEMPLATE_DIR = new URL('../../templates', import.meta.url).pathname;
+const SCHEMA_DIR = new URL('../../schemas', import.meta.url).pathname;
+const SKILL_SRC = new URL('../../.claude/skills/openspec-e2e', import.meta.url).pathname;
+const CMD_SRC = new URL('../../.claude/commands/opsx/e2e.md', import.meta.url).pathname;
+export async function init(options) {
+    console.log(chalk.blue('\n🔧 OpenSpec + Playwright E2E Setup\n'));
+    const projectRoot = process.cwd();
+    // 1. Check prerequisites
+    console.log(chalk.blue('─── Prerequisites ───'));
+    const hasNode = execCmd('node --version', 'Node.js', true);
+    const hasNpm = execCmd('npm --version', 'npm', true);
+    const hasOpenspec = execCmd('npx openspec --version 2>/dev/null || echo "not found"', 'OpenSpec', true);
+    if (!hasNode || !hasNpm) {
+        console.log(chalk.red('  ✗ Node.js/npm is required'));
+        process.exit(1);
+    }
+    console.log(chalk.green('  ✓ Node.js and npm found'));
+    // 2. Check OpenSpec
+    if (!existsSync(join(projectRoot, 'openspec'))) {
+        console.log(chalk.yellow('\n⚠ OpenSpec not initialized. Run these commands first:'));
+        console.log(chalk.gray('  npm install -g @fission-ai/openspec'));
+        console.log(chalk.gray('  openspec init'));
+        console.log(chalk.gray('  openspec config profile core'));
+        console.log(chalk.gray('  openspec update\n'));
+        console.log(chalk.gray('  Then run openspec-pw init again.\n'));
+        return;
+    }
+    console.log(chalk.green('  ✓ OpenSpec initialized'));
+    // 3. Install Playwright MCP (global)
+    if (options.mcp !== false) {
+        console.log(chalk.blue('\n─── Installing Playwright MCP ───'));
+        // Check if playwright MCP already exists in global config
+        const claudeJsonPath = join(process.env.HOME ?? '', '.claude.json');
+        const claudeJson = existsSync(claudeJsonPath) ? JSON.parse(readFileSync(claudeJsonPath, 'utf-8')) : {};
+        const globalMcp = claudeJson?.mcpServers ?? {};
+        const localMcp = claudeJson?.projects?.[projectRoot]?.mcpServers ?? {};
+        if (globalMcp['playwright'] || localMcp['playwright']) {
+            console.log(chalk.green('  ✓ Playwright MCP already installed'));
+        }
+        else {
+            try {
+                execSync('claude mcp add playwright npx @playwright/mcp@latest', {
+                    cwd: projectRoot,
+                    stdio: 'inherit',
+                });
+                console.log(chalk.green('  ✓ Playwright MCP installed globally'));
+                console.log(chalk.gray('  (Restart Claude Code to activate)'));
+            }
+            catch {
+                console.log(chalk.yellow('  ⚠ Failed to run claude mcp add'));
+                console.log(chalk.gray('  Run manually: claude mcp add playwright npx @playwright/mcp@latest'));
+                console.log(chalk.gray('  (Restart Claude Code to activate the MCP server)'));
+            }
+        }
+    }
+    // 4. Copy skill files
+    console.log(chalk.blue('\n─── Installing Claude Code Skill ───'));
+    await installSkill(projectRoot);
+    // 5. Install OpenSpec schema
+    console.log(chalk.blue('\n─── Installing OpenSpec Schema ───'));
+    await installSchema(projectRoot);
+    // 6. Generate seed test
+    if (options.seed !== false) {
+        console.log(chalk.blue('\n─── Generating Seed Test ───'));
+        await generateSeedTest(projectRoot);
+    }
+    // 7. Summary
+    console.log(chalk.blue('\n─── Summary ───'));
+    console.log(chalk.green('  ✓ Setup complete!\n'));
+    console.log(chalk.bold('Next steps:'));
+    console.log(chalk.gray('  1. Install Playwright browsers: npx playwright install --with-deps'));
+    console.log(chalk.gray('  2. Customize tests/playwright/credentials.yaml with your test user'));
+    console.log(chalk.gray('  3. Set credentials: export E2E_USERNAME=xxx E2E_PASSWORD=yyy'));
+    console.log(chalk.gray('  4. Run auth setup: npx playwright test --project=setup'));
+    console.log(chalk.gray('  5. In Claude Code, run: /opsx:e2e <change-name>'));
+    console.log(chalk.gray('  6. Or: openspec-pw doctor to verify setup\n'));
+    console.log(chalk.bold('How it works:'));
+    console.log(chalk.gray('  /opsx:e2e reads your OpenSpec specs and runs Playwright'));
+    console.log(chalk.gray('  E2E tests through a three-agent pipeline:'));
+    console.log(chalk.gray('  Planner → Generator → Healer\n'));
+}
+async function installSkill(projectRoot) {
+    const skillsDir = join(projectRoot, '.claude', 'skills');
+    const skillDir = join(skillsDir, 'openspec-e2e');
+    const cmdDir = join(projectRoot, '.claude', 'commands');
+    // Copy skill
+    mkdirSync(skillDir, { recursive: true });
+    const skillContent = await readFile(SKILL_SRC + '/SKILL.md', 'utf-8');
+    writeFileSync(join(skillDir, 'SKILL.md'), skillContent);
+    console.log(chalk.green(`  ✓ Skill installed: /openspec-e2e`));
+    // Copy command
+    mkdirSync(join(cmdDir, 'opsx'), { recursive: true });
+    const cmdContent = await readFile(CMD_SRC, 'utf-8');
+    writeFileSync(join(cmdDir, 'opsx', 'e2e.md'), cmdContent);
+    console.log(chalk.green(`  ✓ Command installed: /opsx:e2e`));
+}
+async function generateSeedTest(projectRoot) {
+    const testsDir = join(projectRoot, 'tests', 'playwright');
+    mkdirSync(testsDir, { recursive: true });
+    const seedPath = join(testsDir, 'seed.spec.ts');
+    if (existsSync(seedPath)) {
+        console.log(chalk.gray('  - seed.spec.ts already exists, skipping'));
+    }
+    else {
+        const seedContent = await readFile(TEMPLATE_DIR + '/seed.spec.ts', 'utf-8');
+        writeFileSync(seedPath, seedContent);
+        console.log(chalk.green('  ✓ Generated: tests/playwright/seed.spec.ts'));
+    }
+    // Generate auth.setup.ts
+    const authSetupPath = join(testsDir, 'auth.setup.ts');
+    if (existsSync(authSetupPath)) {
+        console.log(chalk.gray('  - auth.setup.ts already exists, skipping'));
+    }
+    else {
+        const authContent = await readFile(TEMPLATE_DIR + '/auth.setup.ts', 'utf-8');
+        writeFileSync(authSetupPath, authContent);
+        console.log(chalk.green('  ✓ Generated: tests/playwright/auth.setup.ts'));
+    }
+    // Generate credentials.yaml
+    const credsPath = join(testsDir, 'credentials.yaml');
+    if (existsSync(credsPath)) {
+        console.log(chalk.gray('  - credentials.yaml already exists, skipping'));
+    }
+    else {
+        const credsContent = await readFile(TEMPLATE_DIR + '/credentials.yaml', 'utf-8');
+        writeFileSync(credsPath, credsContent);
+        console.log(chalk.green('  ✓ Generated: tests/playwright/credentials.yaml'));
+    }
+    console.log(chalk.gray('  (Customize BASE_URL and credentials for your app)'));
+}
+async function installSchema(projectRoot) {
+    const schemaSrc = SCHEMA_DIR + '/playwright-e2e';
+    const schemaDest = join(projectRoot, 'openspec', 'schemas', 'playwright-e2e');
+    const schemaFiles = ['schema.yaml'];
+    for (const file of schemaFiles) {
+        const src = join(schemaSrc, file);
+        const dest = join(schemaDest, file);
+        if (existsSync(src)) {
+            writeFileSync(dest, readFileSync(src));
+        }
+    }
+    // Copy templates
+    const templatesSrc = join(schemaSrc, 'templates');
+    const templatesDest = join(schemaDest, 'templates');
+    mkdirSync(templatesDest, { recursive: true });
+    const templateFiles = ['test-plan.md', 'report.md', 'e2e-test.ts', 'playwright.config.ts'];
+    for (const file of templateFiles) {
+        const src = join(templatesSrc, file);
+        const dest = join(templatesDest, file);
+        if (existsSync(src)) {
+            writeFileSync(dest, readFileSync(src));
+        }
+    }
+    console.log(chalk.green('  ✓ Schema installed: openspec/schemas/playwright-e2e/'));
+}
+function execCmd(cmd, name, silent = false) {
+    try {
+        execSync(cmd, { stdio: 'pipe' });
+        if (!silent)
+            console.log(chalk.green(`  ✓ ${name} found`));
+        return true;
+    }
+    catch {
+        if (!silent)
+            console.log(chalk.yellow(`  ⚠ ${name} not found`));
+        return false;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,5 @@
+export interface RunOptions {
+    project?: string;
+    timeout?: number;
+}
+export declare function run(changeName: string, options: RunOptions): Promise<void>;

package/dist/commands/run.js

@@ -0,0 +1,135 @@
+import { execSync } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+const REPORTS_DIR = 'openspec/reports';
+export async function run(changeName, options) {
+    console.log(chalk.blue(`\n🔍 OpenSpec Playwright E2E: ${changeName}\n`));
+    const projectRoot = process.cwd();
+    // 1. Verify test file exists
+    const testFile = join(projectRoot, 'tests', 'playwright', `${changeName}.spec.ts`);
+    if (!existsSync(testFile)) {
+        console.log(chalk.red(`  ✗ Test file not found: tests/playwright/${changeName}.spec.ts`));
+        console.log(chalk.gray('  Run /opsx:e2e first to generate tests.\n'));
+        process.exit(1);
+    }
+    // 2. Setup reports dir
+    mkdirSync(join(projectRoot, REPORTS_DIR), { recursive: true });
+    // 3. Detect auth credentials
+    const credsPath = join(projectRoot, 'tests', 'playwright', 'credentials.yaml');
+    const hasCredentials = existsSync(credsPath);
+    if (!hasCredentials) {
+        console.log(chalk.yellow('  ⚠ No credentials.yaml found — tests may fail if auth required'));
+    }
+    // 4. Run Playwright tests with output capture
+    console.log(chalk.blue('─── Running Tests ───'));
+    const args = ['npx', 'playwright', 'test', testFile, '--reporter=list'];
+    if (options.project) {
+        args.push('--project=' + options.project);
+    }
+    let testOutput = '';
+    let exitCode = 0;
+    try {
+        // Capture stdout to detect port mismatch
+        const result = execSync(args.join(' '), {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: (options.timeout ?? 300) * 1000,
+        });
+        testOutput = result;
+    }
+    catch (err) {
+        exitCode = 1;
+        const error = err;
+        testOutput = (error.stdout ?? '') + (error.stderr ?? '');
+    }
+    // 5. Parse results from Playwright output
+    const results = parsePlaywrightOutput(testOutput);
+    // 6. Detect port mismatch
+    if (testOutput.includes('net::ERR_CONNECTION_REFUSED') ||
+        testOutput.includes('listen EADDRINUSE') ||
+        testOutput.includes('0.0.0.0:')) {
+        console.log(chalk.yellow('  ⚠ Port mismatch detected. Check BASE_URL and webServer port.'));
+    }
+    // 7. Generate markdown report
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const reportPath = join(projectRoot, REPORTS_DIR, `playwright-e2e-${changeName}-${timestamp}.md`);
+    const reportContent = generateReport(changeName, timestamp, results);
+    writeFileSync(reportPath, reportContent);
+    // 8. Summary
+    console.log(chalk.blue('\n─── Results ───'));
+    console.log(`  Tests: ${results.total}  ` +
+        chalk.green(`✓ ${results.passed}`) + '  ' +
+        (results.failed > 0 ? chalk.red(`✗ ${results.failed}`) : chalk.gray(`✗ ${results.failed}`)) +
+        `  Duration: ${results.duration}`);
+    console.log(chalk.blue('\n─── Report ───'));
+    console.log(chalk.green(`  ✓ ${reportPath}\n`));
+    if (results.failed > 0) {
+        console.log(chalk.red(`✗ E2E verification FAILED (${results.failed} tests)`));
+        process.exit(1);
+    }
+    else {
+        console.log(chalk.green('✓ E2E verification PASSED'));
+    }
+}
+function parsePlaywrightOutput(output) {
+    const results = { total: 0, passed: 0, failed: 0, duration: '0s', tests: [] };
+    // Parse: "✓ my-test (1.2s)" or "✗ my-test (0.5s)"
+    const testLineRegex = /([✓✗x]) (.+?) \((\d+(?:\.\d+)?[a-z]+)\)/g;
+    let match;
+    while ((match = testLineRegex.exec(output)) !== null) {
+        const status = match[1] === '✓' ? 'passed' : 'failed';
+        results.tests.push({ name: match[2], status });
+        results.total++;
+        if (status === 'passed')
+            results.passed++;
+        else
+            results.failed++;
+    }
+    // Parse duration: "N tests ran (1m 30s)" or "1 test ran (5s)"
+    const durationMatch = output.match(/\d+ tests? ran \((\d+(?:m\s*\d+)?s?)\)/);
+    if (durationMatch)
+        results.duration = durationMatch[1];
+    return results;
+}
+function generateReport(changeName, timestamp, results) {
+    const lines = [
+        `# E2E Verify Report: ${changeName}`,
+        '',
+        `**Change**: \`${changeName}\``,
+        `**Generated**: ${timestamp.replace('T', ' ').slice(0, 16)} UTC`,
+        '',
+        '## Summary',
+        '',
+        '| Check | Status |',
+        '|-------|--------|',
+        `| Tests Run | ${results.total} |`,
+        `| Passed | ${results.passed} |`,
+        `| Failed | ${results.failed} |`,
+        `| Duration | ${results.duration} |`,
+        `| Final Status | ${results.failed === 0 ? '✅ PASS' : '❌ FAIL'} |`,
+        '',
+        '## Test Results',
+        '',
+    ];
+    if (results.tests.length === 0) {
+        lines.push('_(No test output captured — check Playwright configuration)_', '');
+    }
+    else {
+        for (const test of results.tests) {
+            const icon = test.status === 'passed' ? '✅' : '❌';
+            lines.push(`- ${test.name}: ${icon} ${test.status}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Recommendations', '');
+    if (results.failed > 0) {
+        lines.push('Review failed tests above. Common fixes:', '- Update selectors if UI changed (use `data-testid` attributes)', '- Adjust BASE_URL in seed.spec.ts if port differs', '- Set E2E_USERNAME/E2E_PASSWORD if auth is required', '- Check `npx playwright show-report` for screenshots', '');
+    }
+    else {
+        lines.push('All tests passed. No action needed.', '');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,5 @@
+export interface UpdateOptions {
+    cli?: boolean;
+    skill?: boolean;
+}
+export declare function update(options: UpdateOptions): Promise<void>;

package/dist/commands/update.js

@@ -0,0 +1,91 @@
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+const SKILL_SRC = new URL('../../.claude/skills/openspec-e2e', import.meta.url).pathname;
+const CMD_SRC = new URL('../../.claude/commands/opsx/e2e.md', import.meta.url).pathname;
+const SCHEMA_DIR = new URL('../../schemas', import.meta.url).pathname;
+export async function update(options) {
+    console.log(chalk.blue('\n🔄 Updating OpenSpec + Playwright E2E\n'));
+    const projectRoot = process.cwd();
+    // 1. Update CLI tool (from git latest, not npm)
+    if (options.cli !== false) {
+        console.log(chalk.blue('─── Updating CLI ───'));
+        try {
+            execSync('npm install -g https://github.com/wxhou/openspec-playwright/archive/refs/heads/main.tar.gz', { stdio: 'inherit' });
+            console.log(chalk.green('  ✓ CLI updated to latest commit'));
+        }
+        catch {
+            console.log(chalk.yellow('  ⚠ Failed to update CLI'));
+            console.log(chalk.gray('  Run manually: npm install -g https://github.com/wxhou/openspec-playwright/archive/refs/heads/main.tar.gz'));
+        }
+    }
+    // 2. Update skill and command from git tarball (latest commit, not npm package)
+    if (options.skill !== false) {
+        console.log(chalk.blue('\n─── Updating Skill & Command ───'));
+        try {
+            // Download tarball to temp file and extract
+            const tmpSkill = '/tmp/openspec-e2e-skill.tar.gz';
+            const tmpDir = '/tmp/openspec-e2e-update';
+            execSync(`curl -sL https://github.com/wxhou/openspec-playwright/archive/refs/heads/main.tar.gz -o ${tmpSkill}`, { stdio: 'pipe' });
+            // Clean and re-extract to avoid stale files from previous runs
+            execSync(`rm -rf ${tmpDir} && mkdir -p ${tmpDir} && tar -xzf ${tmpSkill} -C ${tmpDir} --strip-components=1`, { stdio: 'pipe' });
+            const skillSrc = `${tmpDir}/.claude/skills/openspec-e2e/SKILL.md`;
+            const cmdSrc = `${tmpDir}/.claude/commands/opsx/e2e.md`;
+            const schemaSrc = `${tmpDir}/schemas/playwright-e2e`;
+            installSkillFrom(skillSrc, cmdSrc, schemaSrc, projectRoot);
+            console.log(chalk.green('  ✓ Skill & command updated to latest'));
+        }
+        catch {
+            console.log(chalk.yellow('  ⚠ Failed to update skill/command from git'));
+            console.log(chalk.gray('  Running from npm package instead...'));
+            installSkill(projectRoot);
+        }
+    }
+    // Summary
+    console.log(chalk.blue('\n─── Summary ───'));
+    console.log(chalk.green('  ✓ Update complete!\n'));
+    console.log(chalk.bold('Restart Claude Code to use the updated skill.'));
+    console.log(chalk.gray('  Then run /opsx:e2e <change-name> to verify.\n'));
+}
+function installSkill(projectRoot) {
+    installSkillFrom(SKILL_SRC, CMD_SRC, SCHEMA_DIR + '/playwright-e2e', projectRoot);
+}
+function installSkillFrom(skillSrc, cmdSrc, schemaSrc, projectRoot) {
+    const skillDir = join(projectRoot, '.claude', 'skills', 'openspec-e2e');
+    const cmdDir = join(projectRoot, '.claude', 'commands');
+    mkdirSync(skillDir, { recursive: true });
+    const skillContent = readFileSync(skillSrc, 'utf-8');
+    writeFileSync(join(skillDir, 'SKILL.md'), skillContent);
+    console.log(chalk.green(`  ✓ Skill updated: /openspec-e2e`));
+    mkdirSync(join(cmdDir, 'opsx'), { recursive: true });
+    const cmdContent = readFileSync(cmdSrc, 'utf-8');
+    writeFileSync(join(cmdDir, 'opsx', 'e2e.md'), cmdContent);
+    console.log(chalk.green(`  ✓ Command updated: /opsx:e2e`));
+    installSchemaFrom(schemaSrc, projectRoot);
+}
+function installSchemaFrom(schemaSrc, projectRoot) {
+    const schemaDest = join(projectRoot, 'openspec', 'schemas', 'playwright-e2e');
+    mkdirSync(schemaDest, { recursive: true });
+    // Copy schema.yaml
+    const schemaYamlSrc = join(schemaSrc, 'schema.yaml');
+    if (existsSync(schemaYamlSrc)) {
+        writeFileSync(join(schemaDest, 'schema.yaml'), readFileSync(schemaYamlSrc));
+    }
+    // Copy templates
+    const templatesSrc = join(schemaSrc, 'templates');
+    const templatesDest = join(schemaDest, 'templates');
+    if (existsSync(templatesSrc)) {
+        mkdirSync(templatesDest, { recursive: true });
+        const templateFiles = ['test-plan.md', 'report.md', 'e2e-test.ts', 'playwright.config.ts'];
+        for (const file of templateFiles) {
+            const src = join(templatesSrc, file);
+            const dest = join(templatesDest, file);
+            if (existsSync(src)) {
+                writeFileSync(dest, readFileSync(src));
+            }
+        }
+    }
+    console.log(chalk.green('  ✓ Schema updated: openspec/schemas/playwright-e2e/'));
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,40 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { Command } from 'commander';
+import { init } from './commands/init.js';
+import { update } from './commands/update.js';
+import { doctor } from './commands/doctor.js';
+import { run } from './commands/run.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const program = new Command();
+program
+    .name('openspec-pw')
+    .description('OpenSpec + Playwright E2E verification setup tool')
+    .version(pkg.version);
+program
+    .command('init')
+    .description('Initialize OpenSpec + Playwright E2E integration in the current project')
+    .option('-c, --change <name>', 'default change name', 'default')
+    .option('--no-mcp', 'skip Playwright MCP configuration')
+    .option('--no-seed', 'skip seed test generation')
+    .action(init);
+program
+    .command('doctor')
+    .description('Check if all prerequisites are installed')
+    .action(doctor);
+program
+    .command('update')
+    .description('Update the CLI tool and skill to the latest version')
+    .option('--no-cli', 'skip CLI update')
+    .option('--no-skill', 'skip skill/command update')
+    .action(update);
+program
+    .command('run <change-name>')
+    .description('Run Playwright E2E tests for an OpenSpec change')
+    .option('-p, --project <name>', 'Playwright project to run (e.g., user, admin)')
+    .option('-t, --timeout <seconds>', 'Test timeout in seconds', '300')
+    .action(run);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAElF,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,aAAa,CAAC;KACnB,WAAW,CAAC,mDAAmD,CAAC;KAChE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,yEAAyE,CAAC;KACtF,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,SAAS,CAAC;KAC/D,MAAM,CAAC,UAAU,EAAE,mCAAmC,CAAC;KACvD,MAAM,CAAC,WAAW,EAAE,2BAA2B,CAAC;KAChD,MAAM,CAAC,IAAI,CAAC,CAAC;AAEhB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,UAAU,EAAE,iBAAiB,CAAC;KACrC,MAAM,CAAC,YAAY,EAAE,2BAA2B,CAAC;KACjD,MAAM,CAAC,MAAM,CAAC,CAAC;AAElB,OAAO;KACJ,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,iDAAiD,CAAC;KAC9D,MAAM,CAAC,sBAAsB,EAAE,+CAA+C,CAAC;KAC/E,MAAM,CAAC,yBAAyB,EAAE,yBAAyB,EAAE,KAAK,CAAC;KACnE,MAAM,CAAC,GAAG,CAAC,CAAC;AAEf,OAAO,CAAC,KAAK,EAAE,CAAC"}