prolog-trace-viz 1.0.0

package/dist/executor.js

@@ -0,0 +1,115 @@
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { createError, ErrorCode } from './errors.js';
+/**
+ * Checks if SWI-Prolog is installed and gets its version.
+ */
+async function checkSwipl() {
+    return new Promise((resolve) => {
+        const proc = spawn('swipl', ['--version']);
+        let stdout = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.on('error', () => resolve({ installed: false }));
+        proc.on('close', (code) => {
+            if (code === 0) {
+                // Extract version from output like "SWI-Prolog version 8.4.3"
+                const versionMatch = stdout.match(/version\s+(\d+\.\d+\.\d+)/i);
+                resolve({
+                    installed: true,
+                    version: versionMatch ? versionMatch[1] : undefined
+                });
+            }
+            else {
+                resolve({ installed: false });
+            }
+        });
+    });
+}
+/**
+ * Checks if SWI-Prolog version is >= 7.0 (required for prolog_trace_interception/4).
+ */
+function checkSwiplVersion(version) {
+    const parts = version.split('.').map(Number);
+    const major = parts[0] || 0;
+    return major >= 7;
+}
+/**
+ * Checks all required dependencies.
+ */
+export async function checkDependencies() {
+    const { installed, version } = await checkSwipl();
+    if (!installed) {
+        return {
+            swiplInstalled: false,
+            error: createError(ErrorCode.PROLOG_NOT_INSTALLED),
+        };
+    }
+    if (version && !checkSwiplVersion(version)) {
+        return {
+            swiplInstalled: true,
+            swiplVersion: version,
+            error: createError(ErrorCode.PROLOG_VERSION_TOO_OLD, `SWI-Prolog version ${version} is too old. Version 7.0 or later is required for custom tracer support.`),
+        };
+    }
+    return {
+        swiplInstalled: true,
+        swiplVersion: version,
+    };
+}
+/**
+ * Executes the custom tracer with the given wrapper file and captures the JSON output.
+ */
+export async function executeTracer(wrapperPath) {
+    const wrapperDir = path.dirname(wrapperPath);
+    const jsonPath = path.join(wrapperDir, 'trace.json');
+    return new Promise((resolve, reject) => {
+        const proc = spawn('swipl', [wrapperPath], {
+            cwd: wrapperDir,
+        });
+        let stderr = '';
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('error', (err) => {
+            reject(createError(ErrorCode.PROLOG_NOT_INSTALLED, err.message));
+        });
+        proc.on('close', async (code) => {
+            if (code !== 0) {
+                resolve({
+                    json: '',
+                    exitCode: code ?? 1,
+                    stderr,
+                });
+                return;
+            }
+            // Read the generated trace.json file
+            try {
+                const json = await fs.readFile(jsonPath, 'utf-8');
+                resolve({
+                    json,
+                    exitCode: 0,
+                    stderr,
+                });
+            }
+            catch (err) {
+                // trace.json file might not exist if tracer failed silently
+                resolve({
+                    json: '',
+                    exitCode: 0,
+                    stderr: stderr || 'No JSON trace output generated',
+                });
+            }
+        });
+    });
+}
+/**
+ * Legacy function for backward compatibility.
+ * @deprecated Use executeTracer instead.
+ */
+export async function executeSldnfdraw(wrapperPath) {
+    return executeTracer(wrapperPath);
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs/promises';
+import { parseArgs, getHelpText, getVersion, getCopyright } from './cli.js';
+import { formatError } from './errors.js';
+import { createTempWrapper } from './wrapper.js';
+import { executeTracer, checkDependencies } from './executor.js';
+import { parseTraceJson } from './parser.js';
+import * as path from 'node:path';
+import { analyzeTree } from './analyzer.js';
+import { generateMermaid } from './mermaid.js';
+import { renderMarkdown } from './renderer.js';
+import { writeOutput, logVerbose, logInfo, logError } from './output.js';
+import { parsePrologFile } from './clauses.js';
+async function main() {
+    const result = parseArgs(process.argv);
+    if (result.type === 'help') {
+        console.log(getHelpText());
+        process.exit(0);
+    }
+    if (result.type === 'version') {
+        console.log(getVersion());
+        process.exit(0);
+    }
+    if (result.type === 'copyright') {
+        console.log(getCopyright());
+        process.exit(0);
+    }
+    if (result.type === 'error') {
+        logError(formatError(result.error));
+        process.exit(1);
+    }
+    const options = result.options;
+    try {
+        await run(options);
+    }
+    catch (err) {
+        logError(`Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+}
+async function run(options) {
+    logVerbose(`Processing ${options.prologFile} with query: ${options.query}`, options);
+    // Check dependencies
+    logVerbose('Checking dependencies...', options);
+    const deps = await checkDependencies();
+    if (deps.error) {
+        logError(formatError(deps.error));
+        process.exit(1);
+    }
+    // Read Prolog file
+    logVerbose(`Reading ${options.prologFile}...`, options);
+    let prologContent;
+    try {
+        prologContent = await fs.readFile(options.prologFile, 'utf-8');
+    }
+    catch (err) {
+        const { createError, ErrorCode } = await import('./errors.js');
+        logError(formatError(createError(ErrorCode.FILE_NOT_FOUND, options.prologFile)));
+        process.exit(1);
+    }
+    // Parse Prolog clauses (for display purposes)
+    logVerbose('Parsing Prolog clauses...', options);
+    const clauses = parsePrologFile(prologContent);
+    // Get absolute path to tracer.pl from package installation
+    const tracerPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', 'tracer.pl');
+    // Create wrapper (no instrumentation needed)
+    logVerbose('Creating tracer wrapper...', options);
+    const tempFile = await createTempWrapper({
+        prologContent,
+        query: options.query,
+        tracerPath,
+    });
+    try {
+        // Execute custom tracer
+        logVerbose('Executing custom tracer...', options);
+        const execResult = await executeTracer(tempFile.path);
+        if (execResult.exitCode !== 0 || !execResult.json) {
+            logError('Custom tracer execution failed');
+            if (execResult.stderr) {
+                logError(execResult.stderr);
+            }
+            process.exit(1);
+        }
+        // Determine output paths based on Prolog file location
+        const prologDir = options.prologFile.includes('/')
+            ? options.prologFile.substring(0, options.prologFile.lastIndexOf('/'))
+            : '.';
+        const prologBasename = options.prologFile.includes('/')
+            ? options.prologFile.substring(options.prologFile.lastIndexOf('/') + 1)
+            : options.prologFile;
+        const nameWithoutExt = prologBasename.replace(/\.pl$/, '');
+        // Parse JSON trace output
+        logVerbose('Parsing JSON trace output...', options);
+        const tree = parseTraceJson(execResult.json);
+        // Also parse raw events for clause extraction
+        const rawEvents = JSON.parse(execResult.json);
+        // Analyze tree
+        logVerbose('Analyzing execution tree...', options);
+        const analysis = analyzeTree(tree, clauses, { detailLevel: options.detail }, rawEvents);
+        // Generate Mermaid diagram
+        logVerbose('Generating Mermaid diagram...', options);
+        const diagram = generateMermaid(analysis);
+        // Render markdown
+        logVerbose('Rendering markdown...', options);
+        const markdown = renderMarkdown({
+            query: options.query,
+            diagram,
+            executionSteps: analysis.executionSteps,
+            finalAnswer: analysis.finalAnswer,
+            clausesUsed: analysis.clausesUsed,
+        });
+        // Write output - default to source file location if not specified
+        const outputPath = options.output || `${prologDir}/${nameWithoutExt}-output.md`;
+        await writeOutput({
+            content: markdown,
+            outputPath,
+            verbose: options.verbose,
+            quiet: options.quiet,
+        });
+        logInfo('Done!', options);
+    }
+    finally {
+        // Cleanup
+        await tempFile.cleanup();
+    }
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mermaid.d.ts

@@ -0,0 +1,47 @@
+import { AnalysisResult, VisualizationNode, VisualizationEdge } from './analyzer.js';
+export interface MermaidDiagram {
+    nodes: string[];
+    edges: string[];
+    styles: string[];
+    linkStyles: string[];
+}
+/**
+ * Generates a complete Mermaid diagram from analysis results.
+ */
+export declare function generateMermaid(analysis: AnalysisResult): string;
+/**
+ * Formats a node for Mermaid syntax.
+ */
+export declare function formatNode(node: VisualizationNode): string;
+/**
+ * Formats an edge for Mermaid syntax.
+ */
+export declare function formatEdge(edge: VisualizationEdge): string;
+/**
+ * Gets a circled number for step numbering.
+ */
+export declare function getCircledNumber(n: number): string;
+/**
+ * Generates style directive for a node.
+ */
+export declare function generateNodeStyle(node: VisualizationNode): string;
+/**
+ * Generates styles for all node types (for legend).
+ */
+export declare function generateStyles(nodes: VisualizationNode[]): string[];
+/**
+ * Checks if a diagram contains all required node types for a given analysis.
+ */
+export declare function hasRequiredNodeTypes(analysis: AnalysisResult): {
+    hasQuery: boolean;
+    hasSuccess: boolean;
+};
+/**
+ * Validates that step numbers are sequential with no gaps.
+ */
+export declare function validateStepNumbers(edges: VisualizationEdge[]): boolean;
+/**
+ * Checks if all edges with clause matches have proper labels.
+ */
+export declare function edgesHaveClauseInfo(edges: VisualizationEdge[]): boolean;
+//# sourceMappingURL=mermaid.d.ts.map

package/dist/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../src/mermaid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAErF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AA2BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAkBhE;AA6CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAsB1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAc1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAUjE;AAgBD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAEnE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG;IAC9D,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACrB,CAMA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAUvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAMvE"}

package/dist/mermaid.js

@@ -0,0 +1,197 @@
+// Circled numbers for step numbering
+const CIRCLED_NUMBERS = ['①', '②', '③', '④', '⑤', '⑥', '⑦', '⑧', '⑨', '⑩',
+    '⑪', '⑫', '⑬', '⑭', '⑮', '⑯', '⑰', '⑱', '⑲', '⑳'];
+// Color scheme - matching the steering guide
+const COLORS = {
+    query: '#e1f5ff', // Light blue
+    solving: '#fff9c4', // Light yellow
+    pending: '#e0e0e0', // Gray
+    solved: '#c8e6c9', // Light green
+    success: '#c8e6c9', // Light green
+    'clause-body': '#e1bee7', // Light purple
+    match: '#ffe0b2', // Light orange
+};
+const STROKES = {
+    query: '#01579b',
+    solving: '#f57f17',
+    pending: '#616161',
+    solved: '#388e3c',
+    success: '#2e7d32',
+    'clause-body': '#7b1fa2',
+    match: '#e65100',
+};
+/**
+ * Generates a complete Mermaid diagram from analysis results.
+ */
+export function generateMermaid(analysis) {
+    const diagram = buildDiagram(analysis);
+    const lines = [
+        'graph TD',
+        '',
+        '%% Nodes',
+        ...diagram.nodes,
+        '',
+        '%% Edges',
+        ...diagram.edges,
+        '',
+        '%% Styles',
+        ...diagram.styles,
+        ...diagram.linkStyles,
+    ];
+    return lines.join('\n');
+}
+/**
+ * Builds the diagram components.
+ */
+function buildDiagram(analysis) {
+    const nodes = [];
+    const edges = [];
+    const styles = [];
+    const linkStyles = [];
+    // Generate nodes
+    for (const node of analysis.nodes) {
+        nodes.push(formatNode(node));
+        styles.push(generateNodeStyle(node));
+    }
+    // Generate edges
+    const queueIndices = [];
+    const activateIndices = [];
+    for (let i = 0; i < analysis.edges.length; i++) {
+        const edge = analysis.edges[i];
+        edges.push(formatEdge(edge));
+        if (edge.type === 'queue') {
+            queueIndices.push(i);
+        }
+        else if (edge.type === 'activate') {
+            activateIndices.push(i);
+        }
+    }
+    // Group queue edges together
+    if (queueIndices.length > 0) {
+        linkStyles.push(`linkStyle ${queueIndices.join(',')} stroke:#999,stroke-width:2px,stroke-dasharray:5`);
+    }
+    // Group activate edges together
+    if (activateIndices.length > 0) {
+        linkStyles.push(`linkStyle ${activateIndices.join(',')} stroke:#4caf50,stroke-width:3px`);
+    }
+    return { nodes, edges, styles, linkStyles };
+}
+/**
+ * Formats a node for Mermaid syntax.
+ */
+export function formatNode(node) {
+    const label = `${node.emoji} ${node.label}`;
+    // Use different shapes based on type
+    switch (node.type) {
+        case 'query':
+            return `${node.id}[["${label}"]]`; // Stadium shape
+        case 'success':
+            return `${node.id}(("${label}"))`; // Circle
+        case 'pending':
+            return `${node.id}["${label}"]`; // Rectangle (same as solving)
+        case 'solving':
+            return `${node.id}["${label}"]`; // Rectangle
+        case 'solved':
+            return `${node.id}("${label}")`; // Rounded rectangle
+        case 'clause-body':
+            return `${node.id}[/"${label}"/]`; // Trapezoid shape
+        case 'match':
+            return `${node.id}["${label}"]`; // Rectangle
+        default:
+            return `${node.id}["${label}"]`;
+    }
+}
+/**
+ * Formats an edge for Mermaid syntax.
+ */
+export function formatEdge(edge) {
+    const stepNum = getCircledNumber(edge.stepNumber);
+    const label = edge.label ? `${stepNum} ${edge.label}` : stepNum;
+    switch (edge.type) {
+        case 'active':
+            return `${edge.from} -->|"${label}"| ${edge.to}`;
+        case 'queue':
+            return `${edge.from} -.->|"${label}"| ${edge.to}`;
+        case 'activate':
+            return `${edge.from} ==>|"${label}"| ${edge.to}`;
+        default:
+            return `${edge.from} -->|"${label}"| ${edge.to}`;
+    }
+}
+/**
+ * Gets a circled number for step numbering.
+ */
+export function getCircledNumber(n) {
+    if (n >= 1 && n <= CIRCLED_NUMBERS.length) {
+        return CIRCLED_NUMBERS[n - 1];
+    }
+    // Fallback for numbers > 20
+    return `(${n})`;
+}
+/**
+ * Generates style directive for a node.
+ */
+export function generateNodeStyle(node) {
+    const fill = COLORS[node.type];
+    const stroke = STROKES[node.type];
+    // Only query and success nodes have explicit stroke-width
+    if (node.type === 'query' || node.type === 'success') {
+        return `style ${node.id} fill:${fill},stroke:${stroke},stroke-width:3px`;
+    }
+    else {
+        return `style ${node.id} fill:${fill},stroke:${stroke}`;
+    }
+}
+/**
+ * Generates style for a link/edge.
+ */
+function generateLinkStyle(edge, index) {
+    switch (edge.type) {
+        case 'queue':
+            return `linkStyle ${index} stroke:#999,stroke-width:2px,stroke-dasharray:5`;
+        case 'activate':
+            return `linkStyle ${index} stroke:#4caf50,stroke-width:3px`;
+        default:
+            return `linkStyle ${index} stroke:#333`;
+    }
+}
+/**
+ * Generates styles for all node types (for legend).
+ */
+export function generateStyles(nodes) {
+    return nodes.map(generateNodeStyle);
+}
+/**
+ * Checks if a diagram contains all required node types for a given analysis.
+ */
+export function hasRequiredNodeTypes(analysis) {
+    const types = new Set(analysis.nodes.map(n => n.type));
+    return {
+        hasQuery: types.has('query'),
+        hasSuccess: types.has('success'),
+    };
+}
+/**
+ * Validates that step numbers are sequential with no gaps.
+ */
+export function validateStepNumbers(edges) {
+    if (edges.length === 0)
+        return true;
+    const stepNumbers = edges.map(e => e.stepNumber).sort((a, b) => a - b);
+    for (let i = 0; i < stepNumbers.length; i++) {
+        if (stepNumbers[i] !== i + 1)
+            return false;
+    }
+    return true;
+}
+/**
+ * Checks if all edges with clause matches have proper labels.
+ */
+export function edgesHaveClauseInfo(edges) {
+    // Edges that represent clause matches should have labels
+    return edges.every(edge => {
+        // All edges should at least have a step number
+        return edge.stepNumber > 0;
+    });
+}
+//# sourceMappingURL=mermaid.js.map

package/dist/mermaid.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,24 @@
+import { CLIOptions } from './cli.js';
+export interface OutputOptions {
+    content: string;
+    outputPath?: string;
+    verbose: boolean;
+    quiet: boolean;
+}
+/**
+ * Writes output to file or stdout based on CLI options.
+ */
+export declare function writeOutput(options: OutputOptions): Promise<void>;
+/**
+ * Logs verbose information if verbose mode is enabled.
+ */
+export declare function logVerbose(message: string, options: Pick<CLIOptions, 'verbose' | 'quiet'>): void;
+/**
+ * Logs info messages unless quiet mode is enabled.
+ */
+export declare function logInfo(message: string, options: Pick<CLIOptions, 'quiet'>): void;
+/**
+ * Logs error messages (always shown).
+ */
+export declare function logError(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAavE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,IAAI,CAIhG;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,IAAI,CAIjF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE9C"}

package/dist/output.js

@@ -0,0 +1,40 @@
+import * as fs from 'node:fs/promises';
+/**
+ * Writes output to file or stdout based on CLI options.
+ */
+export async function writeOutput(options) {
+    const { content, outputPath, verbose, quiet } = options;
+    if (outputPath) {
+        await fs.writeFile(outputPath, content, 'utf-8');
+        if (!quiet) {
+            console.log(`Output written to: ${outputPath}`);
+        }
+    }
+    else {
+        // Write to stdout
+        console.log(content);
+    }
+}
+/**
+ * Logs verbose information if verbose mode is enabled.
+ */
+export function logVerbose(message, options) {
+    if (options.verbose && !options.quiet) {
+        console.log(`[verbose] ${message}`);
+    }
+}
+/**
+ * Logs info messages unless quiet mode is enabled.
+ */
+export function logInfo(message, options) {
+    if (!options.quiet) {
+        console.log(message);
+    }
+}
+/**
+ * Logs error messages (always shown).
+ */
+export function logError(message) {
+    console.error(message);
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAUvC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAsB;IACtD,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAExD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,kBAAkB;QAClB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAA8C;IACxF,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,OAAkC;IACzE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC"}