@plusplusoneplusplus/coc 1.0.0

package/dist/server/wiki/explore-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore-handler.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/explore-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAQ7D,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC7B;AAED,uCAAuC;AACvC,MAAM,WAAW,yBAAyB;IACtC,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;GAEG;AACH,wBAAsB,wBAAwB,CAC1C,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,yBAAyB,GACnC,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACnC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAChC,OAAO,CAAC,IAAI,CAAC,CAoDf;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,EACpJ,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,EACrK,OAAO,EAAE,cAAc,GACxB,MAAM,CA4DR"}

package/dist/server/wiki/explore-handler.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * Wiki Explore Handler
+ *
+ * POST /api/wikis/:wikiId/explore/:componentId — On-demand deep-dive.
+ * Adapted from deep-wiki's explore-handler for multi-wiki CoC server.
+ *
+ * The shared core logic lives in `handleExploreCore()`, which is also used by
+ * the deep-wiki standalone handler (`dw-explore-handler.ts`).
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleWikiExploreRequest = handleWikiExploreRequest;
+exports.handleExploreCore = handleExploreCore;
+exports.buildExplorePrompt = buildExplorePrompt;
+const ask_handler_1 = require("./ask-handler");
+const router_1 = require("../shared/router");
+// ============================================================================
+// Handler
+// ============================================================================
+/**
+ * Handle POST /api/wikis/:wikiId/explore/:componentId — streamed as SSE.
+ */
+async function handleWikiExploreRequest(req, res, wikiId, componentId, options) {
+    const wiki = options.wikiManager.get(wikiId);
+    if (!wiki) {
+        (0, router_1.send404)(res, `Wiki not found: ${wikiId}`);
+        return;
+    }
+    if (!wiki.registration.aiEnabled) {
+        (0, router_1.send400)(res, 'AI features are not enabled for this wiki.');
+        return;
+    }
+    const sendMessage = options.aiSendMessage;
+    if (!sendMessage) {
+        (0, router_1.send400)(res, 'AI service is not configured.');
+        return;
+    }
+    const resolvedContext = {
+        wikiData: wiki.wikiData,
+        sendMessage,
+        model: options.aiModel ?? wiki.registration.aiModel,
+        workingDirectory: options.aiWorkingDirectory ?? wiki.registration.repoPath,
+    };
+    await handleExploreCore(req, res, componentId, resolvedContext);
+}
+// ============================================================================
+// Core Explore Logic (shared by native and dw handlers)
+// ============================================================================
+/**
+ * Core explore handler logic — shared between the multi-wiki handler
+ * (`handleWikiExploreRequest`) and the standalone deep-wiki handler
+ * (`handleExploreRequest` in `dw-explore-handler.ts`).
+ *
+ * The caller is responsible for:
+ *   - Validating wiki access and AI availability
+ *   - Resolving the explore context
+ *
+ * This function handles:
+ *   - Component lookup and validation
+ *   - Body parsing
+ *   - SSE header setup and streaming
+ *   - Prompt building and AI invocation
+ *   - `res.end()`
+ */
+async function handleExploreCore(req, res, componentId, context) {
+    // Validate component exists
+    const graph = context.wikiData.graph;
+    const mod = graph.components.find((m) => m.id === componentId);
+    if (!mod) {
+        (0, router_1.send404)(res, `Component not found: ${componentId}`);
+        return;
+    }
+    // Parse body
+    const body = await (0, ask_handler_1.readBody)(req);
+    let exploreReq = {};
+    if (body.trim()) {
+        try {
+            exploreReq = JSON.parse(body);
+        }
+        catch {
+            (0, router_1.send400)(res, 'Invalid JSON body');
+            return;
+        }
+    }
+    // Set SSE headers (CORS is handled by the router/middleware layer)
+    res.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache',
+        'Connection': 'keep-alive',
+    });
+    const { model, workingDirectory, sendMessage } = context;
+    try {
+        (0, ask_handler_1.sendSSE)(res, { type: 'status', message: `Analyzing ${mod.name} component...` });
+        const detail = context.wikiData.getComponentDetail(componentId);
+        const existingMarkdown = detail?.markdown || '';
+        const prompt = buildExplorePrompt(mod, existingMarkdown, graph, exploreReq);
+        const fullResponse = await sendMessage(prompt, {
+            model,
+            workingDirectory,
+            onStreamingChunk: (chunk) => {
+                (0, ask_handler_1.sendSSE)(res, { type: 'chunk', text: chunk });
+            },
+        });
+        (0, ask_handler_1.sendSSE)(res, { type: 'done', fullResponse });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        (0, ask_handler_1.sendSSE)(res, { type: 'error', message });
+    }
+    res.end();
+}
+// ============================================================================
+// Prompt Building
+// ============================================================================
+/**
+ * Build the AI prompt for deep-dive exploration.
+ */
+function buildExplorePrompt(mod, existingMarkdown, graph, request) {
+    const parts = [];
+    const depth = request.depth || 'normal';
+    const isDeep = depth === 'deep';
+    parts.push(`You are conducting a ${isDeep ? 'deep' : 'focused'} analysis of the "${mod.name}" component.`);
+    parts.push('Provide detailed technical insights with code-level specifics.');
+    parts.push('Use markdown formatting with headers, code blocks, and lists.');
+    parts.push('');
+    parts.push('## Component Information');
+    parts.push('');
+    parts.push(`- **Name:** ${mod.name}`);
+    parts.push(`- **ID:** ${mod.id}`);
+    parts.push(`- **Category:** ${mod.category}`);
+    parts.push(`- **Path:** ${mod.path}`);
+    parts.push(`- **Purpose:** ${mod.purpose}`);
+    parts.push(`- **Key Files:** ${mod.keyFiles.join(', ')}`);
+    parts.push(`- **Dependencies:** ${mod.dependencies.length > 0 ? mod.dependencies.join(', ') : 'none'}`);
+    parts.push(`- **Dependents:** ${mod.dependents.length > 0 ? mod.dependents.join(', ') : 'none'}`);
+    parts.push('');
+    if (existingMarkdown) {
+        parts.push('## Existing Analysis');
+        parts.push('');
+        parts.push(existingMarkdown);
+        parts.push('');
+    }
+    parts.push('## Project Architecture');
+    parts.push('');
+    parts.push(`Project: ${graph.project.name} (${graph.project.language})`);
+    for (const m of graph.components) {
+        const deps = m.dependencies.length > 0 ? ` → ${m.dependencies.join(', ')}` : '';
+        parts.push(`  - ${m.name}: ${m.purpose}${deps}`);
+    }
+    parts.push('');
+    if (request.question) {
+        parts.push('## User Question');
+        parts.push('');
+        parts.push(request.question);
+    }
+    else if (isDeep) {
+        parts.push('## Deep Analysis Task');
+        parts.push('');
+        parts.push('Provide a comprehensive deep-dive analysis covering:');
+        parts.push('1. Internal architecture and design patterns');
+        parts.push('2. Key algorithms and data structures');
+        parts.push('3. Error handling strategies');
+        parts.push('4. Performance characteristics and potential bottlenecks');
+        parts.push('5. Integration points with other components');
+        parts.push('6. Potential improvements and technical debt');
+    }
+    else {
+        parts.push('## Analysis Task');
+        parts.push('');
+        parts.push('Provide a focused analysis covering the most important aspects of this component,');
+        parts.push('including architecture, key patterns, and how it integrates with the rest of the system.');
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=explore-handler.js.map

package/dist/server/wiki/explore-handler.js.map

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

package/dist/server/wiki/file-watcher.d.ts

@@ -0,0 +1,51 @@
+/**
+ * File Watcher
+ *
+ * Watches a repository directory for changes and triggers incremental
+ * rebuilds. Uses fs.watch (recursive) with debouncing to avoid
+ * excessive rebuilds during rapid file saves.
+ *
+ * When changes are detected:
+ * 1. Debounce for 2 seconds
+ * 2. Determine which components are affected
+ * 3. Notify callback with affected component IDs
+ */
+import type { ComponentGraph } from './types';
+export interface FileWatcherOptions {
+    /** Path to the repository to watch */
+    repoPath: string;
+    /** Wiki output directory (to reload data after rebuild) */
+    wikiDir: string;
+    /** Component graph for determining affected components */
+    componentGraph: ComponentGraph;
+    /** Debounce interval in milliseconds (default: 2000) */
+    debounceMs?: number;
+    /** Callback when changes are detected */
+    onChange: (affectedComponentIds: string[]) => void;
+    /** Optional callback for errors */
+    onError?: (error: Error) => void;
+}
+export declare class FileWatcher {
+    private registry;
+    private options;
+    constructor(options: FileWatcherOptions);
+    /**
+     * Start watching the repository for changes.
+     */
+    start(): void;
+    /**
+     * Stop watching.
+     */
+    stop(): void;
+    /**
+     * Whether the watcher is currently active.
+     */
+    get isWatching(): boolean;
+    /**
+     * Determine which components are affected by the changed files.
+     *
+     * A component is affected if any changed file is within the component's path.
+     */
+    private findAffectedComponents;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/server/wiki/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAO9C,MAAM,WAAW,kBAAkB;IAC/B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,cAAc,EAAE,cAAc,CAAC;IAC/B,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,QAAQ,EAAE,CAAC,oBAAoB,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACnD,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC;AAYD,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,EAAE,kBAAkB;IAKvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAuBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAIZ;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAMD;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CA4BjC"}

package/dist/server/wiki/file-watcher.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * File Watcher
+ *
+ * Watches a repository directory for changes and triggers incremental
+ * rebuilds. Uses fs.watch (recursive) with debouncing to avoid
+ * excessive rebuilds during rapid file saves.
+ *
+ * When changes are detected:
+ * 1. Debounce for 2 seconds
+ * 2. Determine which components are affected
+ * 3. Notify callback with affected component IDs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileWatcher = void 0;
+const debounced_watcher_registry_1 = require("../shared/debounced-watcher-registry");
+/** Default debounce interval in milliseconds */
+const DEFAULT_DEBOUNCE_MS = 2000;
+// ============================================================================
+// FileWatcher
+// ============================================================================
+/** Fixed key used by FileWatcher for its single-directory watcher. */
+const WATCHER_KEY = 'default';
+class FileWatcher {
+    constructor(options) {
+        this.options = options;
+        this.registry = new debounced_watcher_registry_1.DebouncedWatcherRegistry(options.debounceMs ?? DEFAULT_DEBOUNCE_MS);
+    }
+    /**
+     * Start watching the repository for changes.
+     */
+    start() {
+        if (this.registry.isWatching(WATCHER_KEY))
+            return;
+        const { repoPath } = this.options;
+        this.registry.watch(WATCHER_KEY, repoPath, (_key, changedFiles) => {
+            const affectedIds = this.findAffectedComponents(changedFiles);
+            if (affectedIds.length > 0) {
+                this.options.onChange(affectedIds);
+            }
+        }, {
+            shouldIgnore,
+            onError: (_key, err) => {
+                this.options.onError?.(err);
+            },
+        });
+    }
+    /**
+     * Stop watching.
+     */
+    stop() {
+        this.registry.unwatch(WATCHER_KEY);
+    }
+    /**
+     * Whether the watcher is currently active.
+     */
+    get isWatching() {
+        return this.registry.isWatching(WATCHER_KEY);
+    }
+    // ========================================================================
+    // Private
+    // ========================================================================
+    /**
+     * Determine which components are affected by the changed files.
+     *
+     * A component is affected if any changed file is within the component's path.
+     */
+    findAffectedComponents(changedFiles) {
+        const affected = new Set();
+        for (const file of changedFiles) {
+            const normalizedFile = file.replace(/\\/g, '/');
+            for (const mod of this.options.componentGraph.components) {
+                const componentPath = mod.path.replace(/\\/g, '/');
+                // Check if the changed file is within the component's directory
+                if (normalizedFile.startsWith(componentPath + '/') || normalizedFile === componentPath) {
+                    affected.add(mod.id);
+                    continue;
+                }
+                // Also check key files
+                for (const keyFile of mod.keyFiles) {
+                    const normalizedKeyFile = keyFile.replace(/\\/g, '/');
+                    if (normalizedFile === normalizedKeyFile || normalizedFile.endsWith('/' + normalizedKeyFile)) {
+                        affected.add(mod.id);
+                        break;
+                    }
+                }
+            }
+        }
+        return Array.from(affected);
+    }
+}
+exports.FileWatcher = FileWatcher;
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Patterns to ignore (node_modules, .git, build artifacts, etc.)
+ */
+const IGNORE_PATTERNS = [
+    'node_modules',
+    '.git',
+    '.wiki-cache',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    '__pycache__',
+    '.pytest_cache',
+    '.tox',
+    'target',
+    '.DS_Store',
+    'thumbs.db',
+    '.env',
+];
+function shouldIgnore(filename) {
+    const normalized = filename.replace(/\\/g, '/');
+    const parts = normalized.split('/');
+    for (const part of parts) {
+        if (IGNORE_PATTERNS.includes(part))
+            return true;
+    }
+    // Ignore common generated/temp files
+    if (normalized.endsWith('.map') ||
+        normalized.endsWith('.lock') ||
+        normalized.endsWith('.log')) {
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/server/wiki/file-watcher.js.map

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

package/dist/server/wiki/generate-handler.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Wiki Generate Handler
+ *
+ * Server-side handler for per-wiki phase regeneration.
+ * Adapted from deep-wiki's generate-handler for multi-wiki CoC server.
+ *
+ * Uses a per-wiki Map for generation state (not module singleton).
+ * Delegates actual generation to deep-wiki's public API via dynamic imports.
+ *
+ * Routes (flat — registered in wiki-routes.ts):
+ *   POST /api/wikis/:wikiId/admin/generate          — Start generation (SSE)
+ *   POST /api/wikis/:wikiId/admin/generate/cancel    — Cancel running generation
+ *   GET  /api/wikis/:wikiId/admin/generate/status    — Get phase cache status
+ *   POST /api/wikis/:wikiId/admin/generate/component/:id — Regenerate single component
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import * as http from 'http';
+import type { WikiProvider } from './wiki-backend';
+export interface GenerateRequest {
+    startPhase: number;
+    endPhase: number;
+    force?: boolean;
+}
+interface GenerationState {
+    running: boolean;
+    currentPhase: number;
+    cancelled: boolean;
+    startTime: number;
+}
+/**
+ * POST /api/wikis/:wikiId/admin/generate — Start phase generation with SSE streaming.
+ */
+export declare function handleStartGenerate(req: http.IncomingMessage, res: http.ServerResponse, wikiId: string, wikiProvider: WikiProvider): Promise<void>;
+/**
+ * POST /api/wikis/:wikiId/admin/generate/cancel — Cancel running generation.
+ */
+export declare function handleCancelGenerate(res: http.ServerResponse, wikiId: string): void;
+/**
+ * GET /api/wikis/:wikiId/admin/generate/status — Get phase cache status.
+ */
+export declare function handleGetGenerateStatus(res: http.ServerResponse, wikiId: string, wikiProvider: WikiProvider): void;
+/**
+ * POST /api/wikis/:wikiId/admin/generate/component/:componentId
+ */
+export declare function handleComponentRegenerate(req: http.IncomingMessage, res: http.ServerResponse, wikiId: string, componentId: string, wikiProvider: WikiProvider): Promise<void>;
+export interface CacheMetadataStats {
+    components: number;
+    categories: number;
+    themes: number;
+    domains: number;
+    analyses: number;
+    articles: number;
+    projectName?: string;
+    projectLanguage?: string;
+}
+export declare function collectCacheMetadata(wiki: {
+    wikiData: {
+        graph: any;
+    };
+}, outputDir: string): CacheMetadataStats;
+/** Get per-wiki generation state (for testing). */
+export declare function getGenerationState(wikiId: string): GenerationState | null;
+/** Reset per-wiki generation state (for testing). */
+export declare function resetGenerationState(wikiId: string): void;
+/** Reset all generation states (for testing). */
+export declare function resetAllGenerationStates(): void;
+export {};
+//# sourceMappingURL=generate-handler.d.ts.map

package/dist/server/wiki/generate-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-handler.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/generate-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAK7B,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,gBAAgB,CAAC;AAqBjE,MAAM,WAAW,eAAe;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,eAAe;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACrB;AASD;;GAEG;AACH,wBAAsB,mBAAmB,CACrC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC,IAAI,CAAC,CA0Ef;AAsND;;GAEG;AACH,wBAAgB,oBAAoB,CAChC,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,MAAM,EAAE,MAAM,GACf,IAAI,CASN;AAMD;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,YAAY,GAC3B,IAAI,CA8CN;AAMD;;GAEG;AACH,wBAAsB,yBAAyB,CAC3C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,YAAY,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmEf;AAkFD,MAAM,WAAW,kBAAkB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,oBAAoB,CAChC,IAAI,EAAE;IAAE,QAAQ,EAAE;QAAE,KAAK,EAAE,GAAG,CAAA;KAAE,CAAA;CAAE,EAClC,SAAS,EAAE,MAAM,GAClB,kBAAkB,CAoDpB;AAgFD,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAEzE;AAED,qDAAqD;AACrD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,iDAAiD;AACjD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}