import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
import type { DiagramGrade } from "./grade.js";
export interface DiagramEntry {
    name: string;
    path: string;
    flow: string;
    seq: string;
    dml: string;
    presentation: string | null;
    specification: string | null;
}
export interface ViewerBuildResult {
    viewerPath: string;
    diagramsDir: string;
    entries: DiagramEntry[];
}
export interface BuildViewerOptions {
    cwd: string;
    templateText: string;
    vendorAssetPath: string;
    extraPaths?: string[];
}
/**
 * Extract every target DML, collect the optional presentation/specification
 * sidecars, and write the self-contained viewer plus per-skill Markdown.
 */
export declare function buildViewer(options: BuildViewerOptions): Promise<ViewerBuildResult>;
export declare function buildEntriesViewer(options: {
    cwd: string;
    templateText: string;
    vendorAssetPath: string;
    entries: DiagramEntry[];
}): Promise<ViewerBuildResult>;
export declare function writeSidecar(diagramsDir: string, name: string, grade: DiagramGrade, code: string): Promise<string>;
/** Open the viewer at a specific diagram and view using a fixed, OS-native argv. */
export declare function openViewerInBrowser(pi: Pick<ExtensionAPI, "exec">, viewerPath: string, name: string, view: string): Promise<boolean>;