@angriff36/manifest 2.18.0

package/packages/cli/dist/commands/ir-diff.js

@@ -0,0 +1,199 @@
+import fs from 'node:fs/promises';
+import chalk from 'chalk';
+import ora from 'ora';
+import { diffIR, generateMigration } from '@angriff36/manifest/ir-diff';
+function createSpinner(message, enabled) {
+    if (!enabled) {
+        return {
+            text: message,
+            stop() { },
+            fail(_msg) { },
+        };
+    }
+    return ora(message).start();
+}
+function printJson(data) {
+    console.log(JSON.stringify(data, null, 2));
+}
+function tableLine(label, value) {
+    return `${label.padEnd(26)} ${value}`;
+}
+async function loadIRFile(path) {
+    const content = await fs.readFile(path, 'utf-8');
+    return JSON.parse(content);
+}
+export async function diffIRCommand(oldIRPath, newIRPath, options = {}) {
+    const spinner = createSpinner(`Comparing IR files`, !options.json);
+    try {
+        const [oldIR, newIR] = await Promise.all([
+            loadIRFile(oldIRPath),
+            loadIRFile(newIRPath),
+        ]);
+        spinner.stop();
+        const report = diffIR(oldIR, newIR);
+        const migration = generateMigration(report, oldIR, newIR);
+        if (options.sql || options.prisma) {
+            const output = {
+                diff: report,
+                migration: {
+                    sql: options.sql ? migration.sql : undefined,
+                    prisma: options.prisma ? migration.prisma : undefined,
+                    summary: migration.summary,
+                    warnings: migration.warnings,
+                },
+            };
+            if (options.output) {
+                await fs.writeFile(options.output, JSON.stringify(output, null, 2), 'utf-8');
+                console.log(chalk.green(`Migration written to ${options.output}`));
+            }
+            else {
+                printJson(output);
+            }
+            if (migration.warnings.length > 0 && !options.json) {
+                console.log('');
+                console.log(chalk.yellow('Warnings:'));
+                for (const w of migration.warnings) {
+                    console.log(chalk.yellow(`  ⚠ ${w}`));
+                }
+            }
+            if (report.summary.hasChanges)
+                process.exit(1);
+            return;
+        }
+        if (options.json) {
+            printJson(report);
+            if (report.summary.hasChanges)
+                process.exit(1);
+            return;
+        }
+        // Human-readable output
+        console.log(chalk.bold('\nIR Diff Report'));
+        console.log('');
+        console.log(chalk.cyan('Files'));
+        console.log(tableLine('Old IR', oldIRPath));
+        console.log(tableLine('New IR', newIRPath));
+        console.log('');
+        console.log(chalk.bold('Summary'));
+        const s = report.summary;
+        if (!s.hasChanges) {
+            console.log(chalk.green('  No differences detected between the two IR versions.'));
+            return;
+        }
+        if (s.entitiesAdded + s.entitiesRemoved + s.entitiesChanged > 0) {
+            console.log(tableLine('Entities', `+${s.entitiesAdded} -${s.entitiesRemoved} ~${s.entitiesChanged}`));
+        }
+        if (s.commandsAdded + s.commandsRemoved + s.commandsChanged > 0) {
+            console.log(tableLine('Commands', `+${s.commandsAdded} -${s.commandsRemoved} ~${s.commandsChanged}`));
+        }
+        if (s.policiesAdded + s.policiesRemoved + s.policiesChanged > 0) {
+            console.log(tableLine('Policies', `+${s.policiesAdded} -${s.policiesRemoved} ~${s.policiesChanged}`));
+        }
+        if (s.eventsAdded + s.eventsRemoved + s.eventsChanged > 0) {
+            console.log(tableLine('Events', `+${s.eventsAdded} -${s.eventsRemoved} ~${s.eventsChanged}`));
+        }
+        if (s.storesAdded + s.storesRemoved + s.storesChanged > 0) {
+            console.log(tableLine('Stores', `+${s.storesAdded} -${s.storesRemoved} ~${s.storesChanged}`));
+        }
+        if (s.modulesAdded + s.modulesRemoved > 0) {
+            console.log(tableLine('Modules', `+${s.modulesAdded} -${s.modulesRemoved}`));
+        }
+        // Entity details
+        for (const entity of report.entities) {
+            console.log('');
+            const color = entity.change === 'added' ? chalk.green
+                : entity.change === 'removed' ? chalk.red
+                    : chalk.yellow;
+            console.log(color(`  Entity: ${entity.name} [${entity.change}]`));
+            if (entity.module) {
+                console.log(`    module: ${entity.module.from ?? '(none)'} → ${entity.module.to ?? '(none)'}`);
+            }
+            for (const prop of entity.properties) {
+                const propColor = prop.change === 'added' ? chalk.green
+                    : prop.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(propColor(`    property: ${prop.name} [${prop.change}]`));
+                if (prop.details?.type) {
+                    console.log(`      type: ${prop.details.type.from} → ${prop.details.type.to}`);
+                }
+                if (prop.details?.modifiers) {
+                    console.log(`      modifiers: [${prop.details.modifiers.from.join(', ')}] → [${prop.details.modifiers.to.join(', ')}]`);
+                }
+            }
+            for (const cp of entity.computedProperties) {
+                const cpColor = cp.change === 'added' ? chalk.green
+                    : cp.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(cpColor(`    computed: ${cp.name} [${cp.change}]`));
+            }
+            for (const rel of entity.relationships) {
+                const relColor = rel.change === 'added' ? chalk.green
+                    : rel.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(relColor(`    relationship: ${rel.name} [${rel.change}]`));
+                if (rel.details?.kind) {
+                    console.log(`      kind: ${rel.details.kind.from} → ${rel.details.kind.to}`);
+                }
+            }
+            for (const con of entity.constraints) {
+                const conColor = con.change === 'added' ? chalk.green
+                    : con.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(conColor(`    constraint: ${con.name} [${con.change}]`));
+            }
+        }
+        // Command details
+        if (report.commands.length > 0) {
+            console.log('');
+            console.log(chalk.bold('Commands'));
+            for (const cmd of report.commands) {
+                const color = cmd.change === 'added' ? chalk.green
+                    : cmd.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(color(`  ${cmd.name} [${cmd.change}]`));
+                if (cmd.details?.entity) {
+                    console.log(`    entity: ${cmd.details.entity.from ?? '(none)'} → ${cmd.details.entity.to ?? '(none)'}`);
+                }
+            }
+        }
+        // Policy details
+        if (report.policies.length > 0) {
+            console.log('');
+            console.log(chalk.bold('Policies'));
+            for (const pol of report.policies) {
+                const color = pol.change === 'added' ? chalk.green
+                    : pol.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(color(`  ${pol.name} [${pol.change}]`));
+            }
+        }
+        // Event details
+        if (report.events.length > 0) {
+            console.log('');
+            console.log(chalk.bold('Events'));
+            for (const evt of report.events) {
+                const color = evt.change === 'added' ? chalk.green
+                    : evt.change === 'removed' ? chalk.red
+                        : chalk.yellow;
+                console.log(color(`  ${evt.name} [${evt.change}]`));
+            }
+        }
+        // Migration preview hint
+        console.log('');
+        console.log(chalk.bold('Migration'));
+        console.log(chalk.gray('  Use --sql --prisma flags to generate migration scripts.'));
+        if (migration.warnings.length > 0) {
+            console.log('');
+            console.log(chalk.yellow('Warnings:'));
+            for (const w of migration.warnings) {
+                console.log(chalk.yellow(`  ⚠ ${w}`));
+            }
+        }
+        if (report.summary.hasChanges)
+            process.exit(1);
+    }
+    catch (error) {
+        spinner.fail(`diff ir-vs-ir failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=ir-diff.js.map

package/packages/cli/dist/commands/ir-diff.js.map

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

package/packages/cli/dist/commands/lint-routes.d.ts

@@ -0,0 +1,56 @@
+/**
+ * manifest lint-routes command
+ *
+ * Scans configured client directories for hardcoded route strings.
+ * Fails CI when violations are found.
+ *
+ * This is the enforcement layer for the Canonical Routes invariant.
+ * Documentation does not stop AI. Failing CI does.
+ *
+ * See docs/spec/manifest-vnext.md § "Canonical Routes (Normative)".
+ */
+export interface LintRoutesConfig {
+    /** Directories to scan for hardcoded route strings */
+    dirs: string[];
+    /** Route prefixes to match (e.g. ["/api/", "/v1/"]) */
+    prefixes: string[];
+    /** Exact paths to allowlist (won't trigger violations) */
+    allowlist: string[];
+    /** File glob patterns to exclude from scanning */
+    exclude: string[];
+}
+export interface LintViolation {
+    file: string;
+    line: number;
+    column: number;
+    match: string;
+    suggestion?: string;
+}
+export interface LintResult {
+    violations: LintViolation[];
+    filesScanned: number;
+    config: LintRoutesConfig;
+}
+/**
+ * Load lint-routes config from manifest.config.yaml or use defaults.
+ */
+export declare function loadLintRoutesConfig(cwd: string): Promise<LintRoutesConfig>;
+/**
+ * Scan a single file for hardcoded route strings.
+ */
+export declare function scanFileForRoutes(content: string, filePath: string, config: LintRoutesConfig): LintViolation[];
+/**
+ * Scan all configured directories for hardcoded route strings.
+ */
+export declare function scanDirectories(cwd: string, config: LintRoutesConfig): Promise<LintResult>;
+interface LintRoutesOptions {
+    config?: string;
+    format?: 'text' | 'json';
+    fix?: boolean;
+}
+/**
+ * lint-routes command handler
+ */
+export declare function lintRoutesCommand(options?: LintRoutesOptions): Promise<void>;
+export {};
+//# sourceMappingURL=lint-routes.d.ts.map

package/packages/cli/dist/commands/lint-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-routes.d.ts","sourceRoot":"","sources":["../../src/commands/lint-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uDAAuD;IACvD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AA2BD;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BjF;AAiDD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,GACvB,aAAa,EAAE,CAmCjB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CA6BrB;AAMD,UAAU,iBAAiB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsDtF"}

package/packages/cli/dist/commands/lint-routes.js

@@ -0,0 +1,228 @@
+/**
+ * manifest lint-routes command
+ *
+ * Scans configured client directories for hardcoded route strings.
+ * Fails CI when violations are found.
+ *
+ * This is the enforcement layer for the Canonical Routes invariant.
+ * Documentation does not stop AI. Failing CI does.
+ *
+ * See docs/spec/manifest-vnext.md § "Canonical Routes (Normative)".
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { glob } from 'glob';
+import chalk from 'chalk';
+import ora from 'ora';
+// ============================================================================
+// Defaults
+// ============================================================================
+const DEFAULT_CONFIG = {
+    dirs: ['src', 'app', 'pages', 'components', 'lib'],
+    prefixes: ['/api/'],
+    allowlist: [],
+    exclude: [
+        '**/node_modules/**',
+        '**/.next/**',
+        '**/dist/**',
+        '**/build/**',
+        '**/routes.ts',
+        '**/routes.manifest.json',
+        '**/*.test.*',
+        '**/*.spec.*',
+        '**/*.d.ts',
+    ],
+};
+// ============================================================================
+// Config Loading
+// ============================================================================
+/**
+ * Load lint-routes config from manifest.config.yaml or use defaults.
+ */
+export async function loadLintRoutesConfig(cwd) {
+    // Try to load from manifest.config.yaml
+    const configPaths = [
+        'manifest.config.yaml',
+        'manifest.config.yml',
+    ];
+    for (const configFile of configPaths) {
+        const configPath = path.resolve(cwd, configFile);
+        try {
+            const content = await fs.readFile(configPath, 'utf-8');
+            // Simple YAML parsing for the lintRoutes section
+            const yaml = await import('js-yaml');
+            const parsed = yaml.load(content);
+            if (parsed?.lintRoutes && typeof parsed.lintRoutes === 'object') {
+                const lintConfig = parsed.lintRoutes;
+                return {
+                    dirs: lintConfig.dirs ?? DEFAULT_CONFIG.dirs,
+                    prefixes: lintConfig.prefixes ?? DEFAULT_CONFIG.prefixes,
+                    allowlist: lintConfig.allowlist ?? DEFAULT_CONFIG.allowlist,
+                    exclude: lintConfig.exclude ?? DEFAULT_CONFIG.exclude,
+                };
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return DEFAULT_CONFIG;
+}
+// ============================================================================
+// Scanner
+// ============================================================================
+/**
+ * Build a regex that matches hardcoded route strings for given prefixes.
+ *
+ * Matches:
+ *   - String literals: "/api/foo", '/api/foo'
+ *   - Template literals: `/api/foo`
+ *   - fetch("/api/foo"), fetch('/api/foo'), fetch(`/api/foo`)
+ *
+ * Does NOT match:
+ *   - Import paths
+ *   - Comments (handled separately)
+ */
+function buildRoutePattern(prefixes) {
+    // Escape regex special chars in prefixes
+    const escaped = prefixes.map(p => p.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    // Match quoted strings or template literal strings containing any prefix
+    // Wrap alternation in non-capturing group so [^...] applies to all alternatives
+    const pattern = `(?:["'\`])\\s*((?:${escaped.join('|')})[^"'\`\\s]*)\\s*(?:["'\`])`;
+    return new RegExp(pattern, 'g');
+}
+/**
+ * Check if a line is a comment or inside a generated file header.
+ */
+function isCommentOrGenerated(line) {
+    const trimmed = line.trim();
+    return (trimmed.startsWith('//') ||
+        trimmed.startsWith('*') ||
+        trimmed.startsWith('/*') ||
+        trimmed.startsWith('*/') ||
+        trimmed.includes('DO NOT EDIT') ||
+        trimmed.includes('Auto-generated'));
+}
+/**
+ * Check if a match is in the allowlist.
+ */
+function isAllowlisted(match, allowlist) {
+    return allowlist.some(allowed => match === allowed || match.startsWith(allowed));
+}
+/**
+ * Scan a single file for hardcoded route strings.
+ */
+export function scanFileForRoutes(content, filePath, config) {
+    const violations = [];
+    const pattern = buildRoutePattern(config.prefixes);
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip comments and generated file headers
+        if (isCommentOrGenerated(line))
+            continue;
+        // Reset regex state for each line
+        pattern.lastIndex = 0;
+        let match;
+        while ((match = pattern.exec(line)) !== null) {
+            const matchedPath = match[1];
+            // Skip allowlisted paths
+            if (isAllowlisted(matchedPath, config.allowlist))
+                continue;
+            // Skip if this looks like an import path (from "..." or require("..."))
+            if (/(?:from|require)\s*\(?\s*$/.test(line.slice(0, match.index)))
+                continue;
+            violations.push({
+                file: filePath,
+                line: i + 1,
+                column: match.index + 1,
+                match: matchedPath,
+                suggestion: `Use a generated route helper from routes.ts instead of hardcoded "${matchedPath}"`,
+            });
+        }
+    }
+    return violations;
+}
+/**
+ * Scan all configured directories for hardcoded route strings.
+ */
+export async function scanDirectories(cwd, config) {
+    const violations = [];
+    let filesScanned = 0;
+    // Collect all files from configured directories
+    const filePatterns = config.dirs.map(dir => `${dir}/**/*.{ts,tsx,js,jsx,mjs,cjs}`);
+    for (const pattern of filePatterns) {
+        const files = await glob(pattern, {
+            cwd,
+            ignore: config.exclude,
+            absolute: false,
+        });
+        for (const file of files) {
+            const fullPath = path.resolve(cwd, file);
+            try {
+                const content = await fs.readFile(fullPath, 'utf-8');
+                filesScanned++;
+                const fileViolations = scanFileForRoutes(content, file, config);
+                violations.push(...fileViolations);
+            }
+            catch {
+                // Skip files that can't be read
+            }
+        }
+    }
+    return { violations, filesScanned, config };
+}
+/**
+ * lint-routes command handler
+ */
+export async function lintRoutesCommand(options = {}) {
+    const spinner = ora('Scanning for hardcoded route strings').start();
+    try {
+        const cwd = process.cwd();
+        // Load config
+        const config = await loadLintRoutesConfig(cwd);
+        spinner.text = `Scanning ${config.dirs.join(', ')} for hardcoded routes...`;
+        // Scan
+        const result = await scanDirectories(cwd, config);
+        // Output
+        if (options.format === 'json') {
+            spinner.stop();
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (result.violations.length === 0) {
+                spinner.succeed(`Scanned ${result.filesScanned} file(s) — no hardcoded routes found`);
+                console.log(chalk.green('\n  Route surface is clean. All transport paths use generated helpers.'));
+            }
+            else {
+                spinner.fail(`Found ${result.violations.length} hardcoded route(s) in ${result.filesScanned} file(s)`);
+                console.log('');
+                for (const v of result.violations) {
+                    console.log(chalk.red(`  ${v.file}:${v.line}:${v.column}`));
+                    console.log(`    Hardcoded route: ${chalk.yellow(v.match)}`);
+                    if (v.suggestion) {
+                        console.log(chalk.gray(`    → ${v.suggestion}`));
+                    }
+                    console.log('');
+                }
+                console.log(chalk.bold('SUMMARY:'));
+                console.log(`  Files scanned: ${result.filesScanned}`);
+                console.log(`  Violations: ${chalk.red(String(result.violations.length))}`);
+                console.log(`  Prefixes checked: ${config.prefixes.join(', ')}`);
+                console.log('');
+                console.log(chalk.gray('  Configure in manifest.config.yaml under lintRoutes:'));
+                console.log(chalk.gray('    lintRoutes:'));
+                console.log(chalk.gray('      dirs: [src, app]'));
+                console.log(chalk.gray('      prefixes: ["/api/"]'));
+                console.log(chalk.gray('      allowlist: ["/api/health"]'));
+                process.exit(1);
+            }
+        }
+    }
+    catch (error) {
+        spinner.fail(`Route linting failed: ${error instanceof Error ? error.message : String(error)}`);
+        console.error(error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=lint-routes.js.map

package/packages/cli/dist/commands/lint-routes.js.map

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

package/packages/cli/dist/commands/load-test.d.ts

@@ -0,0 +1,61 @@
+/**
+ * manifest load-test command
+ *
+ * Generates k6 or Artillery load test scripts from IR entities and commands.
+ * Produces self-contained scripts with realistic data generation (faker.js
+ * patterns), configurable ramp-up profiles, SLO thresholds, and optional
+ * integration with the Manifest performance profiler.
+ */
+export type LoadTestFormat = 'k6' | 'artillery';
+export interface RampStage {
+    /** Duration string like "30s", "1m", "5m" */
+    duration: string;
+    /** Target number of virtual users */
+    target: number;
+}
+export interface SloThreshold {
+    /** Metric name (e.g. "p95", "p99", "error_rate", "http_req_duration") */
+    metric: string;
+    /** Comparison operator */
+    op: '<' | '<=' | '>' | '>=';
+    /** Threshold value (in ms for duration, fraction for error_rate) */
+    value: number;
+    /** Abort the test when this threshold is crossed */
+    abortOnFail?: boolean;
+}
+export interface LoadTestOptions {
+    /** Source .manifest or .ir.json file */
+    source?: string;
+    /** Output directory for generated scripts */
+    output?: string;
+    /** Script format */
+    format?: LoadTestFormat;
+    /** Base URL for the API under test */
+    baseUrl?: string;
+    /** Ramp-up profile string like "10s:5,30s:20,1m:50" */
+    rampUp?: string;
+    /** SLO threshold string like "p95:500ms,p99:1s,error_rate:0.01" */
+    slo?: string;
+    /** Only generate scripts for the named command(s) (repeatable) */
+    command?: string[];
+    /** Only generate scripts for the named entity (repeatable) */
+    entity?: string[];
+    /** Generate a profiler integration header comment */
+    profile?: boolean;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+    /** Emit structured JSON to stdout instead of writing files */
+    json?: boolean;
+}
+export interface LoadTestResult {
+    format: LoadTestFormat;
+    baseUrl: string;
+    rampUp: RampStage[];
+    slo: SloThreshold[];
+    commands: string[];
+    entities: string[];
+    files: Record<string, string>;
+    profilerIntegration: boolean;
+}
+export declare function loadTestCommand(options?: LoadTestOptions): Promise<LoadTestResult>;
+//# sourceMappingURL=load-test.d.ts.map

package/packages/cli/dist/commands/load-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-test.d.ts","sourceRoot":"","sources":["../../src/commands/load-test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,WAAW,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,EAAE,EAAE,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,CAAC;IAC5B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qDAAqD;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAwkBD,wBAAsB,eAAe,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2J5F"}