@slope-dev/slope 1.5.1

package/dist/core/plugins.js

@@ -0,0 +1,176 @@
+// SLOPE Plugin System
+// Discovers and loads custom metaphor and guard plugins from .slope/plugins/
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { validateMetaphor, registerMetaphor } from './metaphor.js';
+import { registerCustomGuard } from './guard.js';
+// --- Validation ---
+export function validatePluginManifest(raw) {
+    const errors = [];
+    if (!raw || typeof raw !== 'object') {
+        return { valid: false, errors: ['Plugin manifest must be an object'] };
+    }
+    const obj = raw;
+    if (!obj.type || (obj.type !== 'metaphor' && obj.type !== 'guard')) {
+        errors.push('Missing or invalid "type" (must be "metaphor" or "guard")');
+    }
+    if (!obj.id || typeof obj.id !== 'string') {
+        errors.push('Missing or invalid "id" (must be a non-empty string)');
+    }
+    if (!obj.name || typeof obj.name !== 'string') {
+        errors.push('Missing or invalid "name" (must be a non-empty string)');
+    }
+    return { valid: errors.length === 0, errors };
+}
+// --- Discovery ---
+export function discoverPlugins(cwd) {
+    const plugins = [];
+    const seen = new Set();
+    const dirs = [
+        { dir: join(cwd, '.slope', 'plugins', 'metaphors'), type: 'metaphor' },
+        { dir: join(cwd, '.slope', 'plugins', 'guards'), type: 'guard' },
+    ];
+    for (const { dir, type } of dirs) {
+        if (!existsSync(dir))
+            continue;
+        for (const file of readdirSync(dir)) {
+            if (!file.endsWith('.json'))
+                continue;
+            const filePath = join(dir, file);
+            try {
+                const raw = JSON.parse(readFileSync(filePath, 'utf8'));
+                // Infer type from directory if not specified in file
+                if (!raw.type)
+                    raw.type = type;
+                const { valid } = validatePluginManifest(raw);
+                if (!valid)
+                    continue;
+                // For metaphors, use the metaphor's id field; for guards, use name field
+                const id = type === 'guard' ? raw.name : raw.id;
+                if (seen.has(`${type}:${id}`))
+                    continue;
+                seen.add(`${type}:${id}`);
+                plugins.push({
+                    manifest: {
+                        type: raw.type ?? type,
+                        id: raw.id,
+                        name: raw.name,
+                        version: raw.version,
+                        description: raw.description,
+                    },
+                    filePath,
+                });
+            }
+            catch { /* skip unparseable files */ }
+        }
+    }
+    return plugins;
+}
+// --- Config filtering ---
+export function isPluginEnabled(id, config) {
+    if (!config)
+        return true;
+    // Disabled list takes priority
+    if (config.disabled?.includes(id))
+        return false;
+    // If enabled list exists, only those are allowed
+    if (config.enabled && config.enabled.length > 0) {
+        return config.enabled.includes(id);
+    }
+    return true;
+}
+// --- Type-specific loaders ---
+export function loadPluginMetaphors(cwd, config) {
+    const result = { loaded: [], errors: [] };
+    const dir = join(cwd, '.slope', 'plugins', 'metaphors');
+    if (!existsSync(dir))
+        return result;
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        const filePath = join(dir, file);
+        try {
+            const raw = JSON.parse(readFileSync(filePath, 'utf8'));
+            if (!raw.id || typeof raw.id !== 'string') {
+                result.errors.push({ filePath, error: 'Missing "id" field' });
+                continue;
+            }
+            if (!isPluginEnabled(raw.id, config))
+                continue;
+            const metaphor = raw;
+            const validationErrors = validateMetaphor(metaphor);
+            if (validationErrors.length > 0) {
+                result.errors.push({ filePath, error: validationErrors.join('; ') });
+                continue;
+            }
+            registerMetaphor(metaphor);
+            result.loaded.push({
+                manifest: { type: 'metaphor', id: metaphor.id, name: metaphor.name, version: raw.version, description: metaphor.description },
+                filePath,
+            });
+        }
+        catch (err) {
+            result.errors.push({ filePath, error: err.message });
+        }
+    }
+    return result;
+}
+export function loadPluginGuards(cwd, config) {
+    const result = { loaded: [], errors: [] };
+    const dir = join(cwd, '.slope', 'plugins', 'guards');
+    if (!existsSync(dir))
+        return result;
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        const filePath = join(dir, file);
+        try {
+            const raw = JSON.parse(readFileSync(filePath, 'utf8'));
+            if (!raw.name || typeof raw.name !== 'string') {
+                result.errors.push({ filePath, error: 'Missing "name" field' });
+                continue;
+            }
+            if (!raw.hookEvent || typeof raw.hookEvent !== 'string') {
+                result.errors.push({ filePath, error: 'Missing "hookEvent" field' });
+                continue;
+            }
+            if (!raw.command || typeof raw.command !== 'string') {
+                result.errors.push({ filePath, error: 'Missing "command" field' });
+                continue;
+            }
+            if (!raw.level || (raw.level !== 'scoring' && raw.level !== 'full')) {
+                result.errors.push({ filePath, error: 'Missing or invalid "level" (must be "scoring" or "full")' });
+                continue;
+            }
+            if (!isPluginEnabled(raw.name, config))
+                continue;
+            const guard = {
+                name: raw.name,
+                description: raw.description ?? '',
+                hookEvent: raw.hookEvent,
+                matcher: raw.matcher,
+                level: raw.level,
+                command: raw.command,
+            };
+            registerCustomGuard(guard);
+            result.loaded.push({
+                manifest: { type: 'guard', id: raw.name, name: raw.name, version: raw.version, description: raw.description },
+                filePath,
+            });
+        }
+        catch (err) {
+            result.errors.push({ filePath, error: err.message });
+        }
+    }
+    return result;
+}
+// --- Main loader ---
+export function loadPlugins(cwd, config) {
+    const metaphors = loadPluginMetaphors(cwd, config);
+    const guards = loadPluginGuards(cwd, config);
+    return {
+        loaded: [...metaphors.loaded, ...guards.loaded],
+        errors: [...metaphors.errors, ...guards.errors],
+    };
+}
+//# sourceMappingURL=plugins.js.map

package/dist/core/plugins.js.map

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

package/dist/core/pr-signals.d.ts

@@ -0,0 +1,23 @@
+import type { PRSignal, CISignal } from './types.js';
+/** Fields to request from `gh pr view --json` */
+export declare const GH_PR_JSON_FIELDS: readonly ["number", "additions", "deletions", "changedFiles", "comments", "reviews", "reviewDecision", "statusCheckRollup", "createdAt", "mergedAt"];
+/** Build the `gh pr view` CLI command string */
+export declare function buildGhCommand(prNumber: number): string;
+/** Parse raw `gh pr view --json` output into a PRSignal */
+export declare function parsePRJson(json: Record<string, unknown>): PRSignal;
+/** Safe defaults for graceful degradation when PR data is unavailable */
+export declare function emptyPRSignal(prNumber?: number): PRSignal;
+/**
+ * Merge PR check data with an existing CISignal.
+ *
+ * - Both exist: keep CI runner data (more granular), detect retry scenario
+ *   (PR had failures but CI shows passing → increment retries)
+ * - No existing CI: derive CISignal from PR check counts (runner='unknown')
+ */
+export declare function mergePRChecksWithCI(prSignal: PRSignal, existingCI?: CISignal): CISignal;
+/**
+ * Count checks that failed initially then succeeded (retry detection).
+ * Looks at statusCheckRollup for checks with multiple runs where earlier runs failed.
+ */
+export declare function detectCheckRetries(statusCheckRollup: unknown): number;
+//# sourceMappingURL=pr-signals.d.ts.map

package/dist/core/pr-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-signals.d.ts","sourceRoot":"","sources":["../../src/core/pr-signals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAoB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvE,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,sJAWpB,CAAC;AAEX,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CA0BnE;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAezD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAyBvF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,CAuBrE"}

package/dist/core/pr-signals.js

@@ -0,0 +1,178 @@
+// SLOPE — PR Signal Parser
+// Parses GitHub PR metadata (from `gh pr view --json`) into structured PRSignal objects.
+// Pure parser — no I/O. CLI handles `gh` execution.
+/** Fields to request from `gh pr view --json` */
+export const GH_PR_JSON_FIELDS = [
+    'number',
+    'additions',
+    'deletions',
+    'changedFiles',
+    'comments',
+    'reviews',
+    'reviewDecision',
+    'statusCheckRollup',
+    'createdAt',
+    'mergedAt',
+];
+/** Build the `gh pr view` CLI command string */
+export function buildGhCommand(prNumber) {
+    const fields = GH_PR_JSON_FIELDS.join(',');
+    return `gh pr view ${prNumber} --json ${fields}`;
+}
+/** Parse raw `gh pr view --json` output into a PRSignal */
+export function parsePRJson(json) {
+    const reviews = Array.isArray(json.reviews) ? json.reviews : [];
+    const comments = Array.isArray(json.comments) ? json.comments : [];
+    const statusCheckRollup = Array.isArray(json.statusCheckRollup)
+        ? json.statusCheckRollup
+        : [];
+    const { passed, failed } = extractStatusChecks(statusCheckRollup);
+    return {
+        platform: 'github',
+        pr_number: typeof json.number === 'number' ? json.number : 0,
+        review_cycles: countReviewCycles(reviews),
+        change_request_count: countChangeRequests(reviews),
+        time_to_merge_minutes: computeTimeToMerge(json.createdAt, json.mergedAt),
+        ci_checks_passed: passed,
+        ci_checks_failed: failed,
+        file_count: typeof json.changedFiles === 'number' ? json.changedFiles : 0,
+        additions: typeof json.additions === 'number' ? json.additions : 0,
+        deletions: typeof json.deletions === 'number' ? json.deletions : 0,
+        comment_count: comments.length,
+        review_decision: normalizeReviewDecision(json.reviewDecision),
+    };
+}
+/** Safe defaults for graceful degradation when PR data is unavailable */
+export function emptyPRSignal(prNumber) {
+    return {
+        platform: 'unknown',
+        pr_number: prNumber ?? 0,
+        review_cycles: 0,
+        change_request_count: 0,
+        time_to_merge_minutes: null,
+        ci_checks_passed: 0,
+        ci_checks_failed: 0,
+        file_count: 0,
+        additions: 0,
+        deletions: 0,
+        comment_count: 0,
+        review_decision: 'NONE',
+    };
+}
+/**
+ * Merge PR check data with an existing CISignal.
+ *
+ * - Both exist: keep CI runner data (more granular), detect retry scenario
+ *   (PR had failures but CI shows passing → increment retries)
+ * - No existing CI: derive CISignal from PR check counts (runner='unknown')
+ */
+export function mergePRChecksWithCI(prSignal, existingCI) {
+    if (!existingCI) {
+        // Derive CISignal from PR check counts
+        return {
+            runner: 'unknown',
+            test_total: prSignal.ci_checks_passed + prSignal.ci_checks_failed,
+            test_passed: prSignal.ci_checks_passed,
+            test_failed: prSignal.ci_checks_failed,
+            test_skipped: 0,
+            suites_total: prSignal.ci_checks_passed + prSignal.ci_checks_failed,
+            suites_passed: prSignal.ci_checks_passed,
+            suites_failed: prSignal.ci_checks_failed,
+            retries: 0,
+        };
+    }
+    // Both exist: keep CI data, detect retry scenario
+    const retryBoost = (prSignal.ci_checks_failed > 0 && existingCI.test_failed === 0)
+        ? prSignal.ci_checks_failed // PR had failures, CI now passing → retries occurred
+        : 0;
+    return {
+        ...existingCI,
+        retries: existingCI.retries + retryBoost,
+    };
+}
+/**
+ * Count checks that failed initially then succeeded (retry detection).
+ * Looks at statusCheckRollup for checks with multiple runs where earlier runs failed.
+ */
+export function detectCheckRetries(statusCheckRollup) {
+    if (!Array.isArray(statusCheckRollup))
+        return 0;
+    let retries = 0;
+    // Group by check name, count those with mixed results
+    const byName = new Map();
+    for (const check of statusCheckRollup) {
+        const rec = check;
+        const name = typeof rec.name === 'string' ? rec.name : 'unknown';
+        const conclusion = typeof rec.conclusion === 'string' ? rec.conclusion.toUpperCase() : '';
+        if (!byName.has(name))
+            byName.set(name, []);
+        byName.get(name).push(conclusion);
+    }
+    for (const conclusions of byName.values()) {
+        if (conclusions.length > 1) {
+            const hasFail = conclusions.some(c => c === 'FAILURE' || c === 'TIMED_OUT');
+            const hasPass = conclusions.some(c => c === 'SUCCESS');
+            if (hasFail && hasPass)
+                retries++;
+        }
+    }
+    return retries;
+}
+// --- Internal helpers ---
+/**
+ * Count review cycles: each time a reviewer submits a review constitutes a cycle.
+ * Multiple reviews from the same author count as separate cycles (re-reviews).
+ */
+function countReviewCycles(reviews) {
+    return reviews.length;
+}
+/** Count reviews with CHANGES_REQUESTED state */
+function countChangeRequests(reviews) {
+    return reviews.filter(r => r.state === 'CHANGES_REQUESTED').length;
+}
+/** Compute time to merge in minutes. Returns null if not merged. */
+function computeTimeToMerge(createdAt, mergedAt) {
+    if (!createdAt || !mergedAt)
+        return null;
+    const created = new Date(createdAt).getTime();
+    const merged = new Date(mergedAt).getTime();
+    if (isNaN(created) || isNaN(merged))
+        return null;
+    return Math.round((merged - created) / 60000);
+}
+/** Extract pass/fail counts from statusCheckRollup */
+function extractStatusChecks(rollup) {
+    let passed = 0;
+    let failed = 0;
+    for (const check of rollup) {
+        const conclusion = (check.conclusion ?? '').toUpperCase();
+        const status = (check.status ?? '').toUpperCase();
+        if (conclusion === 'SUCCESS' || conclusion === 'NEUTRAL' || conclusion === 'SKIPPED') {
+            passed++;
+        }
+        else if (conclusion === 'FAILURE' || conclusion === 'TIMED_OUT' || conclusion === 'CANCELLED') {
+            failed++;
+        }
+        else if (status === 'COMPLETED') {
+            // No conclusion but completed — count as passed
+            passed++;
+        }
+        else if (status === 'IN_PROGRESS' || status === 'QUEUED' || status === 'PENDING') {
+            // Still running — don't count either way
+        }
+        else if (conclusion) {
+            // Unknown conclusion — be conservative, count as failed
+            failed++;
+        }
+    }
+    return { passed, failed };
+}
+/** Normalize review decision to our union type */
+function normalizeReviewDecision(decision) {
+    if (typeof decision !== 'string')
+        return 'NONE';
+    const upper = decision.toUpperCase();
+    const valid = ['APPROVED', 'CHANGES_REQUESTED', 'REVIEW_REQUIRED', 'COMMENTED'];
+    return (valid.includes(upper) ? upper : 'NONE');
+}
+//# sourceMappingURL=pr-signals.js.map

package/dist/core/pr-signals.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,20 @@
+import type { SprintClaim, SprintConflict } from './types.js';
+/** Async registry for managing sprint claims */
+export interface SprintRegistry {
+    claim(claim: Omit<SprintClaim, 'id' | 'claimed_at'>): Promise<SprintClaim>;
+    release(id: string): Promise<boolean>;
+    list(sprintNumber: number): Promise<SprintClaim[]>;
+    get(id: string): Promise<SprintClaim | undefined>;
+}
+/**
+ * Detect conflicts among a set of sprint claims.
+ *
+ * Rules:
+ *  1. Same target, different players → 'overlap'
+ *  2. Area prefix containment (both 'area' scope) → 'adjacent'
+ *  3. Ticket target starts with area target (mixed scopes) → 'adjacent'
+ *
+ * Skips same-player pairs and cross-sprint pairs.
+ */
+export declare function checkConflicts(claims: SprintClaim[]): SprintConflict[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE9D,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,CAoDtE"}

package/dist/core/registry.js

@@ -0,0 +1,62 @@
+// SLOPE — Sprint Claims Registry
+// Provides the SprintRegistry interface and pure conflict detection logic.
+/**
+ * Detect conflicts among a set of sprint claims.
+ *
+ * Rules:
+ *  1. Same target, different players → 'overlap'
+ *  2. Area prefix containment (both 'area' scope) → 'adjacent'
+ *  3. Ticket target starts with area target (mixed scopes) → 'adjacent'
+ *
+ * Skips same-player pairs and cross-sprint pairs.
+ */
+export function checkConflicts(claims) {
+    const conflicts = [];
+    const seen = new Set();
+    for (let i = 0; i < claims.length; i++) {
+        for (let j = i + 1; j < claims.length; j++) {
+            const a = claims[i];
+            const b = claims[j];
+            // Skip same player or different sprints
+            if (a.player === b.player)
+                continue;
+            if (a.sprint_number !== b.sprint_number)
+                continue;
+            let reason = null;
+            let severity = null;
+            // Rule 1: exact same target
+            if (a.target === b.target) {
+                reason = `Both ${a.player} and ${b.player} claimed "${a.target}"`;
+                severity = 'overlap';
+            }
+            // Rule 2: area prefix containment (both area scope)
+            else if (a.scope === 'area' && b.scope === 'area') {
+                if (b.target.startsWith(a.target) || a.target.startsWith(b.target)) {
+                    const parent = a.target.length <= b.target.length ? a.target : b.target;
+                    const child = a.target.length <= b.target.length ? b.target : a.target;
+                    reason = `Area "${child}" is within area "${parent}"`;
+                    severity = 'adjacent';
+                }
+            }
+            // Rule 3: ticket target starts with area target (mixed scopes)
+            else if (a.scope !== b.scope) {
+                const areaClaim = a.scope === 'area' ? a : b;
+                const ticketClaim = a.scope === 'area' ? b : a;
+                if (ticketClaim.target.startsWith(areaClaim.target)) {
+                    reason = `Ticket "${ticketClaim.target}" falls within area "${areaClaim.target}"`;
+                    severity = 'adjacent';
+                }
+            }
+            if (reason && severity) {
+                // Deduplicate by sorted claim IDs
+                const key = [a.id, b.id].sort().join(':');
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    conflicts.push({ claims: [a, b], reason, severity });
+                }
+            }
+        }
+    }
+    return conflicts;
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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

package/dist/core/report.d.ts

@@ -0,0 +1,50 @@
+import type { GolfScorecard, HandicapCard, DispersionReport, AreaReport, NutritionCategory } from './types.js';
+import type { MetaphorDefinition } from './metaphor.js';
+export interface ReportData {
+    generatedAt: string;
+    sprintCount: number;
+    scorecards: GolfScorecard[];
+    handicapCard: HandicapCard;
+    dispersion: DispersionReport;
+    areaPerformance: AreaReport;
+    nutritionTrends: NutritionTrendEntry[];
+    sprintTrend: SprintTrendEntry[];
+}
+export interface SprintTrendEntry {
+    sprintNumber: number;
+    theme: string;
+    par: number;
+    score: number;
+    differential: number;
+    fairwayPct: number;
+    girPct: number;
+}
+export interface NutritionTrendEntry {
+    category: NutritionCategory;
+    healthy: number;
+    needsAttention: number;
+    neglected: number;
+    total: number;
+}
+export declare function buildReportData(scorecards: GolfScorecard[]): ReportData;
+export declare function svgLine(data: {
+    x: number;
+    y: number;
+}[], width: number, height: number, color: string, strokeWidth?: number): string;
+export declare function svgRect(x: number, y: number, w: number, h: number, fill: string, rx?: number): string;
+export declare function svgText(x: number, y: number, text: string, opts?: {
+    anchor?: string;
+    size?: number;
+    fill?: string;
+    weight?: string;
+}): string;
+export declare function renderHandicapTrendChart(trend: SprintTrendEntry[], metaphor?: MetaphorDefinition): string;
+export declare function renderDispersionChart(dispersion: DispersionReport, metaphor?: MetaphorDefinition): string;
+export declare function renderAreaPerformanceChart(area: AreaReport, metaphor?: MetaphorDefinition): string;
+export declare function renderNutritionChart(trends: NutritionTrendEntry[], metaphor?: MetaphorDefinition): string;
+export declare function renderSummaryCards(data: ReportData, metaphor?: MetaphorDefinition): string;
+export declare function renderSprintTable(trend: SprintTrendEntry[], metaphor?: MetaphorDefinition): string;
+export declare const REPORT_CSS: string;
+export declare function generateHtmlReport(data: ReportData, metaphor?: MetaphorDefinition): string;
+export declare function escapeHtml(s: string): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/core/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/core/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,UAAU,EAEV,iBAAiB,EAElB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUxD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,UAAU,CAAC;IAC5B,eAAe,EAAE,mBAAmB,EAAE,CAAC;IACvC,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,UAAU,CAuDvE;AAID,wBAAgB,OAAO,CACrB,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,WAAW,SAAI,GACd,MAAM,CAIR;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAI,GAAG,MAAM,CAEhG;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAGjJ;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAuDzG;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAsEzG;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA4ClG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAsCzG;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAgC1F;AAID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA4BlG;AAID,eAAO,MAAM,UAAU,QAkCtB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAqC1F;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C"}