ink-hud 0.1.2 → 0.1.4

package/dist/index.d.cts

@@ -22,7 +22,7 @@ type RenderedLine = Array<{
 /**
  * Renderer type
  */
-type RendererType = 'braille' | 'block' | 'ascii';
+type RendererType = 'braille' | 'block';
 /**
  * Renderer resolution information
  * Represents how many pixels each character can display
@@ -152,37 +152,6 @@ declare class BlockRenderer extends Renderer {
     renderCanvas(pixels: Pixel[][], width: number, height: number): RenderedLine[];
 }
 
-/**
- * ASCII renderer
- *
- * Implements 1x3 dot matrix rendering using basic ASCII characters
- * Simulates subtle height variations using top/middle/bottom character segments
- */
-declare class AsciiRenderer extends Renderer {
-    getMetadata(): RendererMetadata;
-    /**
-     * Check if the pixel at the specified position is set
-     */
-    private isPixelSet;
-    private getCellPositions;
-    private getNeighborPosition;
-    private selectMultiPixelChar;
-    private selectHorizontalChar;
-    private selectDiagonalChar;
-    private selectIsolatedChar;
-    private selectSinglePixelChar;
-    /**
-     * Intelligently select ASCII character
-     * Select appropriate character based on 1x3 vertical pixels and adjacent column connections
-     */
-    private selectAsciiChar;
-    /**
-     * Determine the primary color for this character cell
-     */
-    private resolveColor;
-    renderCanvas(pixels: Pixel[][], width: number, height: number): RenderedLine[];
-}
-
 /**
  * Terminal detection type definitions
  *
@@ -332,6 +301,13 @@ declare class RendererSelector {
      * @returns Renderer instance
      */
     getRenderer(type: RendererType): Renderer;
+    /**
+     * Check if a renderer type is supported by the current terminal
+     * Used internally by InkHudProvider to determine the per-chart renderer
+     * @param type - Renderer type
+     * @returns Whether the renderer type is supported
+     */
+    isRendererTypeSupported(type: RendererType): boolean;
     /**
      * Check if the renderer meets terminal capability requirements
      * @param renderer - Renderer instance
@@ -340,12 +316,13 @@ declare class RendererSelector {
      */
     private isRendererSupported;
     /**
-     * Automatically select the best renderer
+     * Automatically select the best renderer from a priority chain.
      *
-     * Try in the order of the priority chain, returning the first renderer that meets terminal capability requirements
-     * If none are satisfied, fallback to ASCII
+     * @deprecated Prefer `<InkHudProvider renderers={{ line: 'block' }}>` combined
+     *   with `useChartRenderer(kind)`. This method remains as a low-level escape
+     *   hatch for custom renderer selection outside the React component tree.
      *
-     * @param preferredChain - Priority chain (default: ['braille', 'block', 'ascii'])
+     * @param preferredChain - Priority chain (default: ['braille', 'block'])
      * @returns Selected renderer instance
      */
     selectBest(preferredChain?: RendererType[]): Renderer;
@@ -366,6 +343,25 @@ declare const rendererSelector: RendererSelector;
  * Provide dependency injection, replacing the global singleton
  */
 
+/**
+ * Chart types that use the pixel-canvas rendering system
+ */
+type ChartKind = 'line' | 'area' | 'bar' | 'pie';
+/**
+ * Per-chart-kind renderer assignment
+ */
+type ChartRenderers = Record<ChartKind, RendererType>;
+/**
+ * Default renderer per chart kind — pre-tuned for best visual output
+ *
+ * | Chart | Renderer | Reason |
+ * |-------|----------|--------|
+ * | line  | braille  | 2×4 sub-pixel grid renders smooth diagonals |
+ * | area  | braille  | Fine-grained fill under curves |
+ * | bar   | block    | 2×2 cells produce clean rectangular bar edges |
+ * | pie   | block    | Solid fills create clean sector boundaries |
+ */
+declare const DEFAULT_CHART_RENDERERS: ChartRenderers;
 /**
  * InkHud Context value
  */
@@ -376,8 +372,13 @@ interface InkHudContextValue {
     getCapabilities: () => TerminalCapabilities;
     /** Get renderer of specified type */
     getRenderer: (type: RendererType) => Renderer;
-    /** Select best renderer */
-    selectBest: (chain?: RendererType[]) => Renderer;
+    /**
+     * Get the renderer configured for a specific chart kind.
+     * In development mode, emits a one-time console.warn when falling back to
+     * BlockRenderer because the configured renderer is not supported by the
+     * current terminal. In production, the fallback is silent.
+     */
+    getRendererFor: (kind: ChartKind) => Renderer;
 }
 /**
  * InkHud Provider Props
@@ -389,20 +390,30 @@ interface InkHudProviderProps {
      */
     detector?: TerminalDetector;
     /**
-     * Force use of specified renderer
-     * Override automatic detection for testing or specific scenarios
-     */
-    forceRenderer?: RendererType;
+     * Override the renderer used for specific chart kinds.
+     * Unspecified kinds keep their default (see DEFAULT_CHART_RENDERERS).
+     *
+     * @example
+     * ```tsx
+     * // Force all line charts to use block renderer
+     * <InkHudProvider renderers={{ line: 'block' }}>
+     *     <MyApp />
+     * </InkHudProvider>
+     * ```
+     */
+    renderers?: Partial<ChartRenderers>;
     children: React.ReactNode;
 }
 /**
  * InkHud Context Provider
  *
- * Encapsulate renderer selection logic, supports dependency injection
+ * Encapsulate renderer selection logic, supports dependency injection.
+ * Each chart kind ships with a pre-tuned default renderer — no per-component
+ * configuration required.
  *
  * @example
  * ```tsx
- * // Standard usage (automatic detection)
+ * // Standard usage (automatic detection, best renderer per chart)
  * <InkHudProvider>
  *     <MyApp />
  * </InkHudProvider>
@@ -412,8 +423,8 @@ interface InkHudProviderProps {
  *     <MyApp />
  * </InkHudProvider>
  *
- * // Force ASCII renderer
- * <InkHudProvider forceRenderer="ascii">
+ * // Override renderer for specific charts
+ * <InkHudProvider renderers={{ line: 'block', bar: 'braille' }}>
  *     <MyApp />
  * </InkHudProvider>
  * ```
@@ -850,6 +861,55 @@ declare function useSmoothArray(targetData: number[], duration?: number, easingF
  */
 declare function useThrottle<T>(value: T, fps?: number): T;
 
+interface UseImageProtocolOptions {
+    /**
+     * 'character' disables image mode entirely; 'image' forces it (no-op when unsupported);
+     * 'auto' detects at runtime and falls back to character mode.
+     */
+    mode: 'auto' | 'image' | 'character';
+    /**
+     * Number of Kitty placeholder cells (= columns in the Kitty image grid).
+     * With trailingSpace=true  each cell is 2 terminal cols wide (U+10EEEE + space).
+     * With trailingSpace=false each cell is 1 terminal col wide.
+     */
+    charCols: number;
+    /** Number of placeholder rows (= rows in the Kitty image grid). */
+    charRows: number;
+    /** Pre-built PNG buffer. null suppresses image rendering for this render cycle. */
+    pngBuf: Buffer | null;
+    /**
+     * Append a trailing space after each Kitty placeholder cell.
+     * true  → 2 terminal cols/cell — use for components whose character mode
+     *         renders "char + space" per data cell (e.g. Heatmap's "■ ").
+     * false → 1 terminal col/cell — use for components with 1-char-per-column
+     *         layout (e.g. Sparkline).
+     * @default true
+     */
+    trailingSpace?: boolean;
+}
+interface UseImageProtocolResult {
+    /** True when image protocol is active and a PNG has been uploaded. */
+    useImage: boolean;
+    /**
+     * One string per charRow to render as <Text> elements (Kitty protocol).
+     * null when Kitty is not the active protocol.
+     */
+    kittyLines: string[] | null;
+    /**
+     * Width in terminal columns for blank placeholder rows (iTerm2 protocol).
+     * null when iTerm2 is not the active protocol.
+     * Render charRows blank lines of this width to reserve the image's space.
+     */
+    iterm2Cols: number | null;
+}
+/**
+ * Shared hook for image-mode rendering (Heatmap, Sparkline, …).
+ *
+ * Handles: protocol detection, stable image ID management, Kitty upload/cleanup
+ * effects, iTerm2 cursor-up write, and placeholder data for the calling component.
+ */
+declare function useImageProtocol({ mode, charCols, charRows, pngBuf, trailingSpace, }: UseImageProtocolOptions): UseImageProtocolResult;
+
 /**
  * Common type definitions for Chart components
  *
@@ -857,27 +917,23 @@ declare function useThrottle<T>(value: T, fps?: number): T;
  */
 
 /**
- * Basic chart dimensions and renderer configuration
+ * Basic chart dimensions
  */
 interface BaseChartProps {
     /** Chart width (character count) */
     width?: number;
     /** Chart height (character rows) */
     height?: number;
-    /** Manually specify Renderer type */
-    renderer?: RendererType;
-    /** Custom renderer fallback chain */
-    rendererChain?: RendererType[];
     /**
-     * Width offset
-     * @deprecated Recommend wrapping chart with `<Panel>`, Panel automatically handles border overhead
+     * @deprecated Per-chart `renderer` prop has been removed.
+     * Configure via `<InkHudProvider renderers={{ line: 'block' }}>` instead.
      */
-    widthOffset?: number;
+    renderer?: never;
     /**
-     * Height offset
-     * @deprecated Recommend wrapping chart with `<Panel>`, Panel automatically handles border overhead
+     * @deprecated Per-chart `rendererChain` prop has been removed.
+     * Configure via `<InkHudProvider renderers={{ line: 'block' }}>` instead.
      */
-    heightOffset?: number;
+    rendererChain?: never;
 }
 /**
  * Legend configuration
@@ -1029,20 +1085,16 @@ interface PieChartProps {
     colors?: string[];
     /** Palette name or custom color array */
     colorPalette?: ColorPalette;
-    /** Manually specify renderer type (optional) */
-    renderer?: RendererType;
-    /** Custom renderer fallback chain (default: ['braille', 'block', 'ascii']) */
-    rendererChain?: RendererType[];
     /**
-     * Height offset
-     * @deprecated Recommend wrapping chart with `<Panel>`, Panel automatically handles border overhead
+     * @deprecated Per-chart `renderer` prop has been removed.
+     * Configure via `<InkHudProvider renderers={{ pie: 'block' }}>` instead.
      */
-    heightOffset?: number;
+    renderer?: never;
     /**
-     * Width offset
-     * @deprecated Recommend wrapping chart with `<Panel>`, Panel automatically handles border overhead
+     * @deprecated Per-chart `rendererChain` prop has been removed.
+     * Configure via `<InkHudProvider renderers={{ pie: 'block' }}>` instead.
      */
-    widthOffset?: number;
+    rendererChain?: never;
 }
 /**
  * PieChart Pie chart component
@@ -1051,25 +1103,57 @@ declare const PieChart: React.FC<PieChartProps>;
 
 /**
  * Sparkline - Mini trend chart component
+ *
+ * Note: Sparkline does NOT consume the InkHudProvider `renderers` configuration.
+ * Its `variant` prop ('block' | 'braille') is independent because Sparkline uses
+ * a static character table (SPARK_LEVELS), not the pixel-canvas pipeline used by
+ * LineChart / AreaChart / BarChart / PieChart. Set `variant` directly on the
+ * component when you need to override the default ('block').
  */
 
 interface SparklineProps {
     /** Array of data points */
     data: number[];
     /**
-     * Target width (character count)
-     * If number of data points exceeds width, will automatically use LTTB algorithm for downsampling
-     * If not provided, width will equal the number of data points
+     * Target width in character columns.
+     * If data.length exceeds width, LTTB downsampling is applied.
+     * Defaults to data.length.
      */
     width?: number;
-    /** Minimum value (default: calculation from data) */
+    /** Minimum value (default: derived from data) */
     min?: number;
-    /** Maximum value (default: calculation from data) */
+    /** Maximum value (default: derived from data) */
     max?: number;
-    /** Color */
+    /** Single solid color for character mode (and image mode when colors is not set) */
     color?: string;
-    /** Rendering style (default: 'block') */
-    variant?: 'block' | 'braille' | 'ascii';
+    /**
+     * Rendering style for character mode. Ignored in image mode.
+     * @default 'block'
+     */
+    variant?: 'block' | 'braille';
+    /**
+     * Rendering mode.
+     * - 'auto': use image protocol if supported, otherwise character mode
+     * - 'image': force image protocol (no-op if unsupported)
+     * - 'character': always use character mode (block/braille)
+     * @default 'auto'
+     */
+    mode?: 'auto' | 'image' | 'character';
+    /**
+     * Chart height in character rows (image mode only).
+     * @default 1
+     */
+    height?: number;
+    /**
+     * Color gradient for image mode (low → high).
+     * Overrides the `color` prop. Defaults to the theme's heatmapGradient.
+     */
+    colors?: string[];
+    /**
+     * Pixel size per character cell in image mode.
+     * @default 8
+     */
+    cellPx?: number;
 }
 declare const Sparkline: React.FC<SparklineProps>;
 
@@ -1299,18 +1383,11 @@ interface GaugeProps {
      */
     showPercent?: boolean;
     /**
-     * Rendering style
-     * - 'unicode': Use Unicode block characters (█░)
-     * - 'ascii': Use ASCII characters (#-)
-     * @default 'unicode'
-     */
-    variant?: 'unicode' | 'ascii';
-    /**
-     * Custom fill character (overrides variant setting)
+     * Custom fill character
      */
     fillChar?: string;
     /**
-     * Custom unfilled character (overrides variant setting)
+     * Custom unfilled character
      */
     emptyChar?: string;
     /**
@@ -1322,27 +1399,32 @@ interface GaugeProps {
  * Gauge - Gauge/progress bar component
  *
  * Display progress or load of a single metric.
- * Style examples:
- * - unicode: [██████░░░░] 60%
- * - ascii:   [######----] 60%
+ * Example: [██████░░░░] 60%
  */
 declare const Gauge: React.FC<GaugeProps>;
 
 /**
  * Multi-Style Big Fonts for BigNumber Component
  *
- * Supports three rendering styles:
+ * Supports two rendering styles:
  * - block: Unicode Block Elements (█▀▄)
  * - braille: Braille patterns (⠿)
- * - ascii: Pure ASCII characters
  */
-type FontStyle = 'block' | 'braille' | 'ascii';
+type FontStyle = 'block' | 'braille';
 
 interface BigNumberProps {
     /**
-     * Main value
+     * Main value — should contain only supported characters: 0-9 . , % + -
      */
     value: string | number;
+    /**
+     * Small text rendered to the left of the big value (e.g. "$")
+     */
+    prefix?: string;
+    /**
+     * Small text rendered to the right of the big value (e.g. "ms", "k", "%")
+     */
+    suffix?: string;
     /**
      * Subtitle/label
      */
@@ -1360,18 +1442,10 @@ interface BigNumberProps {
      * Trend label (e.g., "12%")
      */
     trendLabel?: string;
-    /**
-     * Trend arrow style
-     * - 'unicode': Use Unicode arrows
-     * - 'ascii': Use ASCII characters
-     * @default 'unicode'
-     */
-    variant?: 'unicode' | 'ascii';
     /**
      * Large font style
      * - 'block': Block Elements characters (default)
      * - 'braille': Braille Dot Matrix characters
-     * - 'ascii': Pure ASCII characters
      * @default 'block'
      */
     fontStyle?: FontStyle;
@@ -1389,31 +1463,28 @@ interface BigNumberProps {
 declare const BigNumber: React.FC<BigNumberProps>;
 
 interface HeatmapProps {
-    /**
-     * Data matrix (2D array)
-     * e.g. rows x cols
-     */
+    /** Data matrix (2D array), rows × cols */
     data: number[][];
     /**
-     * Color gradient (from low to high)
-     * Defaults to theme's heatmapGradient
+     * Color gradient (from low to high).
+     * Defaults to theme's heatmapGradient.
      */
     colors?: string[];
+    /** Custom character for character mode (defaults to Unicode block ■) */
+    char?: string;
     /**
-     * Empty/zero value color (if not handled in gradient)
-     */
-    emptyColor?: string;
-    /**
-     * Rendering style
-     * - 'unicode': Use Unicode Blocks character (■)
-     * - 'ascii': Use ASCII characters (#)
-     * @default 'unicode'
+     * Rendering mode.
+     * - 'auto': use image protocol if supported, otherwise character mode
+     * - 'image': force image protocol (no-op if unsupported)
+     * - 'character': always use unicode block characters
+     * @default 'auto'
      */
-    variant?: 'unicode' | 'ascii';
+    mode?: 'auto' | 'image' | 'character';
     /**
-     * Custom character (overrides variant setting)
+     * Pixel size of each data cell in image mode.
+     * @default 8
      */
-    char?: string;
+    cellPx?: number;
 }
 declare const Heatmap: React.FC<HeatmapProps>;
 
@@ -1526,19 +1597,12 @@ interface PulseBarProps {
     /**
      * Ping history entries
      */
-    records: PingRecord[];
+    records?: PingRecord[];
     /**
      * Maximum number of bars to display
      * @default 30
      */
     maxBars?: number;
-    /**
-     * Render style
-     * - 'unicode': use Unicode characters
-     * - 'ascii': use ASCII characters
-     * @default 'unicode'
-     */
-    variant?: 'unicode' | 'ascii';
     /**
      * Custom colors
      */
@@ -1558,4 +1622,165 @@ interface PulseBarProps {
  */
 declare const PulseBar: React.FC<PulseBarProps>;
 
-export { AreaChart, type AreaChartProps, AsciiRenderer, Axis, type AxisProps, BarChart, type BarChartProps, BigNumber, type BigNumberProps, BlockRenderer, BrailleRenderer, type EasingFunction, type EnvironmentInfo, Gauge, type GaugeProps, Grid, GridItem, type GridItemProps, type GridProps, Heatmap, type HeatmapProps, type InkHudContextValue, InkHudProvider, type InkHudProviderProps, Legend, type LegendItem, type LegendProps, LineChart, type LineChartProps, LogStream, type LogStreamProps, ONE_DARK_THEME, Panel, type PanelProps, PieChart, type PieChartDataItem, type PieChartProps, type PingRecord, type PingStatus, PulseBar, type PulseBarProps, Renderer, type RendererMetadata, type RendererResolution, RendererSelector, type RendererType, type SemanticColors, Sparkline, type SparklineProps, Table, type TableColumn, type TableProps, type TerminalCapabilities, TerminalDetector, type Theme, ThemeProvider, arcPoints, assignColors, averageDownsampling, clamp, colorToChalk, createGradient, degreesToRadians, distanceBetweenPoints, easeInCubic, easeInOutQuad, easeLinear, easeOutCubic, fixedIntervalDownsampling, linearScale, lttb, midpointCircle, minMaxDownsampling, normalize, pointOnArc, radiansToDegrees, rendererSelector, scaleToRange, terminalDetector, useInkHud, useRendererSelector, useSemanticColors, useSmooth, useSmoothArray, useTheme, useThrottle };
+/**
+ * ink-hud visual symbol constants
+ *
+ * Centralised character table — grouped by purpose, not Unicode block.
+ * Components import from here instead of hard-coding characters inline.
+ * All entries are `as const` — stable references safe to use in object keys.
+ */
+/** Trend direction arrows (BigNumber, Table) */
+declare const TREND: {
+    readonly up: "▲";
+    readonly down: "▼";
+    readonly neutral: "─";
+};
+/** Legend dot marker (PieChart, Legend, chart core) */
+declare const LEGEND: {
+    readonly dot: "●";
+};
+/** Filled / empty bar characters (Gauge) */
+declare const BAR: {
+    readonly fill: "█";
+    readonly empty: "░";
+};
+/** Default character for heatmap cells in character mode */
+declare const HEATMAP: {
+    readonly default: "■";
+};
+/** Rounded-box border characters (PulseBar) */
+declare const BORDER_ROUNDED: {
+    readonly topLeft: "╭";
+    readonly topRight: "╮";
+    readonly bottomLeft: "╰";
+    readonly bottomRight: "╯";
+    readonly horizontal: "─";
+    readonly vertical: "│";
+    readonly bar: "▌";
+};
+/** Multi-level bar characters for Sparkline character mode */
+declare const SPARK_LEVELS: {
+    readonly block: readonly [" ", "▂", "▃", "▄", "▅", "▆", "▇", "█"];
+    readonly braille: readonly ["⠀", "⡀", "⣀", "⣄", "⣤", "⣦", "⣶", "⣷", "⣿"];
+};
+
+/**
+ * Terminal image protocol capability detection
+ */
+type ImageProtocol = 'kitty' | 'iterm2' | null;
+/**
+ * Detect which image protocol (if any) the current terminal supports.
+ *
+ * Priority: Kitty Graphics > iTerm2 Inline Images
+ * Users can override by setting INKHU_IMAGE_PROTOCOL=kitty|iterm2|none
+ */
+declare function detectImageProtocol(env?: NodeJS.ProcessEnv): ImageProtocol;
+
+/**
+ * Minimal RGB PNG encoder — no dependencies (uses Node.js built-in zlib).
+ */
+/**
+ * Encode a grid of RGB pixels into a minimal PNG buffer.
+ *
+ * @param pixels - Row-major grid: pixels[row][col] = [r, g, b]
+ */
+declare function createRgbPng(pixels: [number, number, number][][]): Buffer;
+/**
+ * Convert a hex colour string (#rrggbb or rrggbb) to [r, g, b].
+ */
+declare function hexToRgb(hex: string): [number, number, number];
+
+/**
+ * Kitty Graphics Protocol encoder
+ *
+ * Spec: https://sw.kovidgoyal.net/kitty/graphics-protocol/
+ */
+/**
+ * Encode a PNG buffer as a Kitty Graphics upload sequence (Unicode Placeholder mode).
+ *
+ * Unlike `encodeKitty` (a=T, immediate display), this stores the image under a
+ * numeric ID without rendering it. The caller must then write placeholder characters
+ * to select which cells display the image (see `encodeKittyPlaceholders`).
+ *
+ * Upload params:
+ *   a=T  — transmit
+ *   U=1  — Unicode Placeholder virtual placement
+ *   i=   — image ID (1–4294967295)
+ *   f=100 — PNG format
+ *   q=2  — quiet (suppress OK/error response)
+ *   c=, r= — nominal cell dimensions (informational for the terminal)
+ */
+declare function encodeKittyUpload(pngBuffer: Buffer, cols: number, rows: number, imageId: number): string;
+/**
+ * Build placeholder character rows for a previously-uploaded Kitty image.
+ *
+ * Each cell is represented by:
+ *   - fg color encoding the image ID: ESC[38;2;R;G;Bm
+ *   - U+10EEEE  (Kitty placeholder, string-width=1)
+ *   - DIACRITICS[row]  (zero-width combining mark)
+ *   - DIACRITICS[col]  (zero-width combining mark)
+ *   - U+0020 (trailing space) — only when trailingSpace=true (default)
+ *
+ * trailingSpace=true  → each cell = 2 terminal columns (Heatmap, 1 char + 1 space layout)
+ * trailingSpace=false → each cell = 1 terminal column  (Sparkline, 1 char per column layout)
+ *
+ * Returns a string with `rows` lines separated by '\n' (no trailing newline).
+ */
+declare function encodeKittyPlaceholders(cols: number, rows: number, imageId: number, options?: {
+    trailingSpace?: boolean;
+}): string;
+/**
+ * Delete a previously-uploaded Kitty image by ID.
+ * Write this to stdout when the component unmounts to free terminal memory.
+ */
+declare function encodeKittyDelete(imageId: number): string;
+/**
+ * Encode a PNG buffer as a Kitty sequence that transmits and displays immediately
+ * (legacy / PoC mode, no image ID). Use `encodeKittyUpload` + `encodeKittyPlaceholders`
+ * for ink integration instead.
+ */
+declare function encodeKitty(pngBuffer: Buffer, cols: number, rows: number): string;
+
+/**
+ * iTerm2 Inline Images Protocol encoder
+ *
+ * Encodes a PNG buffer as an OSC 1337 escape sequence for iTerm2.
+ *
+ * Spec: https://iterm2.com/documentation-images.html
+ */
+/**
+ * Encode a PNG buffer as an iTerm2 inline image escape sequence.
+ *
+ * @param pngBuffer - Raw PNG data
+ * @param cols - Desired display width in character columns (optional)
+ */
+declare function encodeIterm2(pngBuffer: Buffer, cols?: number): string;
+
+/**
+ * Shared pixel-grid drawing utilities for image-mode chart components.
+ * All functions produce RGB[][], ready to pass to createRgbPng().
+ */
+type RGB = [number, number, number];
+/**
+ * Returns a function that maps a normalized value [0, 1] to an RGB color
+ * by interpolating through the provided color stops (256-step palette).
+ */
+declare function gradientColorFn(colors: string[]): (normalized: number) => RGB;
+/**
+ * Build an RGB pixel grid for a sparkline area chart.
+ *
+ * Each data value is linearly interpolated across pixel columns.
+ * The line is drawn 2 px thick; the area below is filled with a darkened version
+ * of the line color. bgColor fills everything above the line.
+ *
+ * @param data         - Processed (downsampled) data points
+ * @param widthPx      - Pixel width of the output image
+ * @param heightPx     - Pixel height of the output image
+ * @param min          - Data minimum (for normalization)
+ * @param max          - Data maximum (for normalization)
+ * @param colorFn      - Maps normalized value → RGB (use gradientColorFn)
+ * @param bgColor      - Background color (default: near-black)
+ */
+declare function buildSparklinePixelGrid(data: number[], widthPx: number, heightPx: number, min: number, max: number, colorFn: (normalized: number) => RGB, bgColor?: RGB): RGB[][];
+
+export { AreaChart, type AreaChartProps, Axis, type AxisProps, BAR, BORDER_ROUNDED, BarChart, type BarChartProps, BigNumber, type BigNumberProps, BlockRenderer, BrailleRenderer, type ChartKind, type ChartRenderers, DEFAULT_CHART_RENDERERS, type EasingFunction, type EnvironmentInfo, Gauge, type GaugeProps, Grid, GridItem, type GridItemProps, type GridProps, HEATMAP, Heatmap, type HeatmapProps, type ImageProtocol, type InkHudContextValue, InkHudProvider, type InkHudProviderProps, LEGEND, Legend, type LegendItem, type LegendProps, LineChart, type LineChartProps, LogStream, type LogStreamProps, ONE_DARK_THEME, Panel, type PanelProps, PieChart, type PieChartDataItem, type PieChartProps, type PingRecord, type PingStatus, PulseBar, type PulseBarProps, Renderer, type RendererMetadata, type RendererResolution, RendererSelector, type RendererType, SPARK_LEVELS, type SemanticColors, Sparkline, type SparklineProps, TREND, Table, type TableColumn, type TableProps, type TerminalCapabilities, TerminalDetector, type Theme, ThemeProvider, type UseImageProtocolOptions, type UseImageProtocolResult, arcPoints, assignColors, averageDownsampling, buildSparklinePixelGrid, clamp, colorToChalk, createGradient, createRgbPng, degreesToRadians, detectImageProtocol, distanceBetweenPoints, easeInCubic, easeInOutQuad, easeLinear, easeOutCubic, encodeIterm2, encodeKitty, encodeKittyDelete, encodeKittyPlaceholders, encodeKittyUpload, fixedIntervalDownsampling, gradientColorFn, hexToRgb, linearScale, lttb, midpointCircle, minMaxDownsampling, normalize, pointOnArc, radiansToDegrees, rendererSelector, scaleToRange, terminalDetector, useImageProtocol, useInkHud, useRendererSelector, useSemanticColors, useSmooth, useSmoothArray, useTheme, useThrottle };