import type { WebGLContextManager } from "../../webgl/context-manager";
import type { CartesianChart } from "./cartesian";
/**
 * A Glyph is a pluggable renderer for a {@link CartesianChart}. The
 * chart owns all data and shared pipeline (init, chunk processing, hover,
 * chrome, tooltip plumbing); the glyph owns its shader program, draw
 * call, and per-glyph tooltip lines.
 */
export interface Glyph {
    /**
     * `"point"` for scatter-style markers; `"line"` for polylines;
     * `"density"` for the density-field shader glyph.
     */
    readonly name: "point" | "line" | "density";
    /**
     * Compile the program + cache attrib/uniform locations on first
     * frame. Subsequent frames are a no-op.
     */
    ensureProgram(chart: CartesianChart, glManager: WebGLContextManager): void;
    /**
     * Issue the draw call(s) for this glyph's visible geometry.
     */
    draw(chart: CartesianChart, glManager: WebGLContextManager, projection: Float32Array): void;
    /**
     * Issue draw calls for a single series' slice only. Used by
     * faceted rendering: one facet per split, each facet's scissor
     * clips to its plot rect and only that series rasterizes inside.
     *
     * Implementations should bind uniforms/buffers once (same as
     * `draw`) and dispatch only the drawArrays call(s) for
     * `seriesIdx`.
     */
    drawSeries(chart: CartesianChart, glManager: WebGLContextManager, projection: Float32Array, seriesIdx: number): void;
    /**
     * Per-hover tooltip content for the point at `flatIdx`. Returns a
     * Promise because some glyphs (notably `PointGlyph`) need to fetch
     * the source row from the view on demand for extra-column lookups.
     * Glyphs whose tooltip is geometry-only (e.g. `LineGlyph`) return
     * a microtask-resolved promise.
     */
    buildTooltipLines(chart: CartesianChart, flatIdx: number): Promise<string[]>;
    /**
     * Hover-overlay options (crosshair, highlight radius).
     */
    tooltipOptions(): {
        crosshair: boolean;
        highlightRadius: number;
    };
    /**
     * Release GL resources created by `ensureProgram`.
     */
    destroy(chart: CartesianChart): void;
}