@ggterm/core 0.2.0

package/dist/performance/binning.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Data Binning
+ *
+ * Aggregate points into bins for efficient visualization of dense data.
+ * Supports hexagonal and rectangular binning.
+ */
+import type { DataRecord, RGBA } from '../types';
+/**
+ * Bin options
+ */
+export interface BinOptions {
+    /** X field in data */
+    xField: string;
+    /** Y field in data */
+    yField: string;
+    /** Number of bins in X direction */
+    xBins?: number;
+    /** Number of bins in Y direction */
+    yBins?: number;
+    /** Bin size (alternative to xBins/yBins) */
+    binSize?: number;
+    /** X domain (auto-computed if not provided) */
+    xDomain?: [number, number];
+    /** Y domain (auto-computed if not provided) */
+    yDomain?: [number, number];
+    /** Aggregation function for values */
+    aggregate?: 'count' | 'sum' | 'mean' | 'median' | 'min' | 'max';
+    /** Field to aggregate (for non-count aggregations) */
+    valueField?: string;
+}
+/**
+ * Rectangular bin result
+ */
+export interface Bin {
+    /** Bin center X */
+    x: number;
+    /** Bin center Y */
+    y: number;
+    /** Bin count */
+    count: number;
+    /** Aggregated value */
+    value: number;
+    /** Bin width */
+    width: number;
+    /** Bin height */
+    height: number;
+    /** Original points in this bin */
+    points: DataRecord[];
+}
+/**
+ * Hexagonal bin result
+ */
+export interface HexBin extends Bin {
+    /** Hexagon vertices */
+    vertices: Array<{
+        x: number;
+        y: number;
+    }>;
+    /** Column index */
+    col: number;
+    /** Row index */
+    row: number;
+}
+/**
+ * Rectangular binning
+ */
+export declare function rectbin<T extends DataRecord>(data: T[], options: BinOptions): Bin[];
+/**
+ * Hexagonal binning
+ * Uses offset coordinate system for hex grid
+ */
+export declare function hexbin<T extends DataRecord>(data: T[], options: BinOptions & {
+    radius?: number;
+}): HexBin[];
+/**
+ * Binner class for reusable binning configuration
+ */
+export declare class Binner<T extends DataRecord = DataRecord> {
+    private options;
+    private type;
+    private hexRadius;
+    constructor(options: BinOptions & {
+        type?: 'rect' | 'hex';
+        hexRadius?: number;
+    });
+    /**
+     * Bin the data
+     */
+    bin(data: T[]): Bin[] | HexBin[];
+    /**
+     * Get bin data ready for plotting
+     */
+    toPlotData(data: T[]): Array<{
+        x: number;
+        y: number;
+        count: number;
+        value: number;
+        size: number;
+    }>;
+    /**
+     * Generate a density color scale
+     */
+    getDensityColors(bins: Bin[], colorScale: (t: number) => RGBA): Map<Bin, RGBA>;
+}
+/**
+ * Create a binner
+ */
+export declare function createBinner<T extends DataRecord = DataRecord>(options: BinOptions & {
+    type?: 'rect' | 'hex';
+    hexRadius?: number;
+}): Binner<T>;
+//# sourceMappingURL=binning.d.ts.map

package/dist/performance/binning.d.ts.map

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

package/dist/performance/canvas-diff.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Canvas Diffing
+ *
+ * Efficient incremental rendering by computing and applying only changes.
+ * Useful for streaming updates where most of the canvas stays the same.
+ */
+import type { Canvas, CanvasCell } from '../types';
+/**
+ * Diff options
+ */
+export interface DiffOptions {
+    /** Compare colors with tolerance for minor variations */
+    colorTolerance?: number;
+    /** Only diff within a specific region */
+    region?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    /** Track cell-level changes vs region-level */
+    granularity?: 'cell' | 'region';
+}
+/**
+ * Single cell change
+ */
+export interface CellChange {
+    x: number;
+    y: number;
+    old: CanvasCell;
+    new: CanvasCell;
+}
+/**
+ * Region change (group of cells)
+ */
+export interface RegionChange {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    cells: CellChange[];
+}
+/**
+ * Diff result
+ */
+export interface DiffResult {
+    /** Whether there are any changes */
+    hasChanges: boolean;
+    /** Number of changed cells */
+    changedCells: number;
+    /** Total cells compared */
+    totalCells: number;
+    /** Change percentage */
+    changePercent: number;
+    /** Individual cell changes (if granularity is 'cell') */
+    cellChanges?: CellChange[];
+    /** Region changes (if granularity is 'region') */
+    regionChanges?: RegionChange[];
+    /** ANSI escape sequences to update only changed cells */
+    patchSequence?: string;
+}
+/**
+ * Canvas Diff class
+ */
+export declare class CanvasDiff {
+    private previousCanvas;
+    private options;
+    constructor(options?: DiffOptions);
+    /**
+     * Compute diff between previous and current canvas
+     */
+    diff(canvas: Canvas): DiffResult;
+    /**
+     * Generate ANSI patch sequence for cell changes
+     */
+    private generatePatch;
+    /**
+     * Group cell changes into contiguous regions
+     */
+    private groupIntoRegions;
+    /**
+     * Save canvas state for next comparison
+     */
+    private saveCanvas;
+    /**
+     * Reset diff state (forces full render on next diff)
+     */
+    reset(): void;
+    /**
+     * Check if full render is needed (no previous state)
+     */
+    needsFullRender(): boolean;
+    /**
+     * Apply patch to terminal output
+     * Returns the patched output or indicates full render needed
+     */
+    applyPatch(currentOutput: string, diff: DiffResult): string | null;
+}
+/**
+ * Create a canvas diff instance
+ */
+export declare function createCanvasDiff(options?: DiffOptions): CanvasDiff;
+/**
+ * Quick diff check between two canvases
+ */
+export declare function quickDiff(oldCanvas: Canvas, newCanvas: Canvas): boolean;
+//# sourceMappingURL=canvas-diff.d.ts.map

package/dist/performance/canvas-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-diff.d.ts","sourceRoot":"","sources":["../../src/performance/canvas-diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAQ,MAAM,UAAU,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,yCAAyC;IACzC,MAAM,CAAC,EAAE;QACP,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,GAAG,EAAE,UAAU,CAAA;IACf,GAAG,EAAE,UAAU,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,UAAU,EAAE,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAA;IACnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAA;IACpB,2BAA2B;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,wBAAwB;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;IAC1B,kDAAkD;IAClD,aAAa,CAAC,EAAE,YAAY,EAAE,CAAA;IAC9B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAgED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,GAAE,WAAgB;IAQrC;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU;IA2DhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqCrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyCxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACH,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;CAanE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,WAAgB,GAAG,UAAU,CAEtE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAgBvE"}

package/dist/performance/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Performance Optimizations
+ *
+ * Tools for handling large datasets efficiently:
+ * - Level-of-detail rendering
+ * - Data sampling (systematic, random, reservoir)
+ * - Automatic binning (hexbin, rectangular)
+ * - Canvas diffing for incremental updates
+ */
+export { DataSampler, createSampler, systematicSample, randomSample, reservoirSample, stratifiedSample, lttbSample, autoSample, type SamplingOptions, type SamplingMethod, } from './sampling';
+export { LevelOfDetail, createLOD, DEFAULT_LOD_LEVELS, type LODLevel, type LODOptions, } from './level-of-detail';
+export { Binner, createBinner, hexbin, rectbin, type BinOptions, type Bin, type HexBin, } from './binning';
+export { CanvasDiff, createCanvasDiff, quickDiff, type DiffResult, type DiffOptions, } from './canvas-diff';
+//# sourceMappingURL=index.d.ts.map

package/dist/performance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/performance/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,KAAK,QAAQ,EACb,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,MAAM,EACN,OAAO,EACP,KAAK,UAAU,EACf,KAAK,GAAG,EACR,KAAK,MAAM,GACZ,MAAM,WAAW,CAAA;AAElB,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA"}

package/dist/performance/level-of-detail.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Level of Detail (LOD)
+ *
+ * Progressive rendering based on data density and viewport.
+ * Automatically adjusts detail level for performance.
+ */
+import type { DataRecord } from '../types';
+/**
+ * LOD level definition
+ */
+export interface LODLevel {
+    /** Name of this level */
+    name: string;
+    /** Maximum points at this level */
+    maxPoints: number;
+    /** Minimum data size to trigger this level */
+    threshold: number;
+    /** Sampling method for this level */
+    samplingMethod?: 'systematic' | 'lttb' | 'binned';
+    /** Optional binning resolution */
+    binResolution?: number;
+}
+/**
+ * LOD configuration options
+ */
+export interface LODOptions {
+    /** LOD levels (sorted by threshold ascending) */
+    levels: LODLevel[];
+    /** X field for LTTB sampling */
+    xField?: string;
+    /** Y field for LTTB sampling */
+    yField?: string;
+    /** Enable automatic level selection */
+    autoSelect?: boolean;
+    /** Target render time in ms (for auto-adjustment) */
+    targetRenderMs?: number;
+}
+/**
+ * Default LOD levels for common use cases
+ */
+export declare const DEFAULT_LOD_LEVELS: LODLevel[];
+/**
+ * Level of Detail manager
+ */
+export declare class LevelOfDetail<T extends DataRecord = DataRecord> {
+    private options;
+    private currentLevel;
+    private lastRenderMs;
+    private adaptiveMaxPoints;
+    constructor(options: LODOptions);
+    /**
+     * Select appropriate LOD level for data size
+     */
+    selectLevel(dataSize: number): LODLevel;
+    /**
+     * Process data with automatic LOD selection
+     */
+    process(data: T[]): T[];
+    /**
+     * Apply a specific LOD level to data
+     */
+    applyLevel(data: T[], level: LODLevel): T[];
+    /**
+     * Update render timing for adaptive LOD
+     */
+    updateRenderTime(renderMs: number): void;
+    /**
+     * Get current LOD level
+     */
+    getCurrentLevel(): LODLevel;
+    /**
+     * Get all LOD levels
+     */
+    getLevels(): LODLevel[];
+    /**
+     * Force a specific LOD level by name
+     */
+    setLevel(name: string): boolean;
+    /**
+     * Get LOD statistics
+     */
+    getStats(): {
+        currentLevel: string;
+        maxPoints: number;
+        adaptiveMaxPoints: number;
+        lastRenderMs: number;
+        targetRenderMs: number;
+    };
+    /**
+     * Process with adaptive point limit
+     */
+    processAdaptive(data: T[]): T[];
+}
+/**
+ * Create a Level of Detail manager
+ */
+export declare function createLOD<T extends DataRecord = DataRecord>(options?: Partial<LODOptions>): LevelOfDetail<T>;
+//# sourceMappingURL=level-of-detail.d.ts.map

package/dist/performance/level-of-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-of-detail.d.ts","sourceRoot":"","sources":["../../src/performance/level-of-detail.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAG1C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,qCAAqC;IACrC,cAAc,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,QAAQ,CAAA;IACjD,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,EAMxC,CAAA;AA2ED;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IAC1D,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,YAAY,CAAY;IAChC,OAAO,CAAC,iBAAiB,CAAQ;gBAErB,OAAO,EAAE,UAAU;IAe/B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAcvC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IASvB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,EAAE;IAyB3C;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBxC;;OAEG;IACH,eAAe,IAAI,QAAQ;IAI3B;;OAEG;IACH,SAAS,IAAI,QAAQ,EAAE;IAIvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAU/B;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAA;QACpB,SAAS,EAAE,MAAM,CAAA;QACjB,iBAAiB,EAAE,MAAM,CAAA;QACzB,YAAY,EAAE,MAAM,CAAA;QACpB,cAAc,EAAE,MAAM,CAAA;KACvB;IAUD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;CAOhC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EACzD,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAChC,aAAa,CAAC,CAAC,CAAC,CAQlB"}

package/dist/performance/sampling.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Data Sampling
+ *
+ * Efficient sampling strategies for large datasets.
+ * Reduces data size while preserving statistical properties.
+ */
+import type { DataRecord } from '../types';
+/**
+ * Sampling method types
+ */
+export type SamplingMethod = 'systematic' | 'random' | 'reservoir' | 'stratified' | 'lttb';
+/**
+ * Sampling options
+ */
+export interface SamplingOptions {
+    /** Sampling method */
+    method: SamplingMethod;
+    /** Target number of samples */
+    targetSize: number;
+    /** Field for stratified sampling */
+    stratifyField?: string;
+    /** X field for LTTB (Largest Triangle Three Buckets) */
+    xField?: string;
+    /** Y field for LTTB */
+    yField?: string;
+    /** Random seed for reproducibility */
+    seed?: number;
+}
+/**
+ * Systematic sampling - every nth item
+ * Preserves order and distribution across the dataset
+ */
+export declare function systematicSample<T>(data: T[], targetSize: number): T[];
+/**
+ * Random sampling - uniformly random selection
+ * May miss local patterns but gives unbiased representation
+ */
+export declare function randomSample<T>(data: T[], targetSize: number, seed?: number): T[];
+/**
+ * Reservoir sampling - streaming random sample
+ * Useful when you don't know the total size upfront
+ */
+export declare function reservoirSample<T>(data: T[], targetSize: number, seed?: number): T[];
+/**
+ * Stratified sampling - proportional sampling from groups
+ * Ensures representation of all categories
+ */
+export declare function stratifiedSample<T extends DataRecord>(data: T[], targetSize: number, stratifyField: string, seed?: number): T[];
+/**
+ * LTTB (Largest Triangle Three Buckets) sampling
+ * Best for time series - preserves visual shape
+ * Based on Sveinn Steinarsson's algorithm
+ */
+export declare function lttbSample<T extends DataRecord>(data: T[], targetSize: number, xField: string, yField: string): T[];
+/**
+ * Data Sampler class - configurable sampling
+ */
+export declare class DataSampler<T extends DataRecord = DataRecord> {
+    private options;
+    constructor(options: SamplingOptions);
+    /**
+     * Sample the data
+     */
+    sample(data: T[]): T[];
+    /**
+     * Check if sampling is needed
+     */
+    needsSampling(dataSize: number): boolean;
+    /**
+     * Get sampling ratio
+     */
+    getSamplingRatio(dataSize: number): number;
+}
+/**
+ * Create a data sampler
+ */
+export declare function createSampler<T extends DataRecord = DataRecord>(options: SamplingOptions): DataSampler<T>;
+/**
+ * Automatically choose best sampling method based on data characteristics
+ */
+export declare function autoSample<T extends DataRecord>(data: T[], targetSize: number, options?: {
+    xField?: string;
+    yField?: string;
+    stratifyField?: string;
+}): T[];
+//# sourceMappingURL=sampling.d.ts.map

package/dist/performance/sampling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampling.d.ts","sourceRoot":"","sources":["../../src/performance/sampling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAA;AAE1F;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sBAAsB;IACtB,MAAM,EAAE,cAAc,CAAA;IACtB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAsBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,EAAE,CAYtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAajF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,CAcpF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,UAAU,EACnD,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,IAAI,CAAC,EAAE,MAAM,GACZ,CAAC,EAAE,CA2BL;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAC7C,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,CAAC,EAAE,CAoEL;AAED;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU;IACxD,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,eAAe;IAIpC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IA8BtB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAI3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAC7D,OAAO,EAAE,eAAe,GACvB,WAAW,CAAC,CAAC,CAAC,CAEhB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,EAC7C,IAAI,EAAE,CAAC,EAAE,EACT,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;CAClB,GACL,CAAC,EAAE,CAeL"}

package/dist/pipeline/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pipeline exports
+ */
+export { renderToCanvas, renderToString, calculateLayout } from './pipeline';
+export type { PlotLayout } from './pipeline';
+export { buildScaleContext, createResolvedContinuousScale, createResolvedDiscreteScale, createResolvedDiscreteColorScale, createResolvedContinuousColorScale, inferContinuousDomain, inferDiscreteDomain, expandDomain, niceDomain, DEFAULT_POINT_COLOR, } from './scales';
+export type { ResolvedScale, ResolvedColorScale, ScaleContext } from './scales';
+export { renderGeom } from './render-geoms';
+export { renderAxes, renderTitle, renderLegend, renderMultiLegend, calculateLegendHeight, calculateMultiLegendHeight, calculateTicks, formatTick, } from './render-axes';
+export type { LegendEntry } from './render-axes';
+//# sourceMappingURL=index.d.ts.map

package/dist/pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5E,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EACL,iBAAiB,EACjB,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAChC,kCAAkC,EAClC,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,mBAAmB,GACpB,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE/E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,cAAc,EACd,UAAU,GACX,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/pipeline/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAA6C,QAAQ,EAAE,aAAa,EAAQ,MAAM,UAAU,CAAA;AACxG,OAAO,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAA;AAgB/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAA;QACX,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,QAAQ,EAAE;QACR,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;IACD,UAAU,CAAC,EAAE;QACX,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,UAAU,CAgEZ;AAoHD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,cAAc,CA8KhB;AAicD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,aAAa,GACrB,MAAM,CASR"}

package/dist/pipeline/render-axes.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Axis rendering for plots
+ */
+import type { TerminalCanvas } from '../canvas/canvas';
+import type { Labels, RGBA, Theme } from '../types';
+import type { ResolvedScale } from './scales';
+/**
+ * Axis configuration
+ */
+export interface AxisConfig {
+    scale: ResolvedScale;
+    position: 'bottom' | 'left' | 'top' | 'right';
+    label?: string;
+    theme: Theme;
+}
+/**
+ * Calculate nice tick values for a continuous scale
+ *
+ * For transformed scales (log10, sqrt, reverse), ticks are calculated
+ * in the transformed space and then inverted back to data space.
+ */
+export declare function calculateTicks(domain: [number, number], targetTicks?: number, transform?: (v: number) => number, invert?: (v: number) => number): number[];
+/**
+ * Format a tick value for display
+ */
+export declare function formatTick(value: number): string;
+/**
+ * Render bottom (x) axis
+ */
+export declare function renderBottomAxis(canvas: TerminalCanvas, scale: ResolvedScale, y: number, xStart: number, xEnd: number, label: string | undefined, _theme: Theme): void;
+/**
+ * Render left (y) axis
+ */
+export declare function renderLeftAxis(canvas: TerminalCanvas, scale: ResolvedScale, x: number, yStart: number, yEnd: number, label: string | undefined, _theme: Theme): void;
+/**
+ * Render right (secondary y) axis
+ */
+export declare function renderRightAxis(canvas: TerminalCanvas, scale: ResolvedScale, x: number, yStart: number, yEnd: number, label: string | undefined, _theme: Theme, maxWidth?: number): void;
+/**
+ * Render all axes for a plot
+ */
+export declare function renderAxes(canvas: TerminalCanvas, scales: {
+    x: ResolvedScale;
+    y: ResolvedScale;
+    y2?: ResolvedScale;
+}, plotArea: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, labels: Labels, theme: Theme): void;
+/**
+ * Render grid lines for the plot
+ */
+export declare function renderGridLines(canvas: TerminalCanvas, scales: {
+    x: ResolvedScale;
+    y: ResolvedScale;
+}, plotArea: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, theme: Theme): void;
+/**
+ * Render plot title
+ */
+export declare function renderTitle(canvas: TerminalCanvas, title: string, width: number, theme: Theme): void;
+/**
+ * Render legend for color aesthetic (legacy function for backward compatibility)
+ */
+export declare function renderLegend(canvas: TerminalCanvas, colorDomain: string[], colorMap: (value: string) => RGBA, x: number, y: number, title: string | undefined, theme: Theme, width?: number): void;
+/**
+ * Legend entry specification for a single aesthetic
+ */
+export interface LegendEntry {
+    aesthetic: 'color' | 'size' | 'shape' | 'alpha';
+    type: 'discrete' | 'continuous';
+    title?: string;
+    domain: string[] | [number, number];
+    map: (value: unknown) => RGBA | number | string;
+}
+/**
+ * Calculate the height needed for a legend entry
+ */
+export declare function calculateLegendHeight(entry: LegendEntry): number;
+/**
+ * Calculate total height for all legends
+ */
+export declare function calculateMultiLegendHeight(entries: LegendEntry[]): number;
+/**
+ * Render multiple legend entries (for multi-aesthetic support)
+ */
+export declare function renderMultiLegend(canvas: TerminalCanvas, entries: LegendEntry[], x: number, y: number, theme: Theme, width?: number): void;
+//# sourceMappingURL=render-axes.d.ts.map

package/dist/pipeline/render-axes.d.ts.map

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