@ggterm/core 0.2.11 → 0.2.15

package/dist/geoms/braille.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Braille Geom
+ *
+ * Creates high-resolution plots using Unicode Braille patterns.
+ * Each character cell contains a 2x4 grid of dots, allowing
+ * 8x the resolution of regular character plots.
+ *
+ * Braille patterns: U+2800 to U+28FF (256 patterns)
+ * Each pattern is a 2-column x 4-row grid:
+ *   ⠁⠂  (1,4)
+ *   ⠄⠈  (2,5)
+ *   ⠐⠠  (3,6)
+ *   ⡀⢀  (7,8)
+ *
+ * Required aesthetics:
+ * - x: x-axis variable
+ * - y: y-axis variable
+ *
+ * Optional aesthetics:
+ * - color: point color
+ * - group: for multiple series
+ */
+import type { Geom } from '../types.js';
+export interface BrailleOptions {
+    /** Type of braille plot: 'point' (default), 'line' */
+    type?: 'point' | 'line';
+    /** Color for the dots/lines */
+    color?: string;
+    /** Fill the area under the line (for line type) */
+    fill?: boolean;
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Dot size - how many braille dots per data point (1-4) */
+    dot_size?: number;
+}
+export declare const BRAILLE_BASE = 10240;
+export declare const BRAILLE_DOTS: number[][];
+export declare function geom_braille(options?: BrailleOptions): Geom;
+//# sourceMappingURL=braille.d.ts.map

package/dist/geoms/braille.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"braille.d.ts","sourceRoot":"","sources":["../../src/geoms/braille.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IACvB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAOD,eAAO,MAAM,YAAY,QAAS,CAAA;AAGlC,eAAO,MAAM,YAAY,EAAE,MAAM,EAAE,EAGlC,CAAA;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAa/D"}

package/dist/geoms/bullet.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Bullet Geom
+ *
+ * Creates bullet charts - compact progress bars with target markers.
+ * Stephen Few's alternative to gauges and meters.
+ *
+ * Required aesthetics:
+ * - x: category/label
+ * - y: actual value
+ *
+ * Optional aesthetics:
+ * - target: target value (shown as marker)
+ * - ranges: background ranges (poor/satisfactory/good)
+ */
+import type { Geom } from '../types.js';
+export interface BulletOptions {
+    /** Width of the bullet chart in characters (default: 40) */
+    width?: number;
+    /** Height of each bullet in characters (default: 1) */
+    height?: number;
+    /** Target marker character */
+    target_char?: string;
+    /** Bar character for actual value */
+    bar_char?: string;
+    /** Background characters for ranges (3 levels) */
+    range_chars?: [string, string, string];
+    /** Show value labels (default: true) */
+    show_values?: boolean;
+    /** Color for the actual value bar */
+    color?: string;
+    /** Color for the target marker */
+    target_color?: string;
+    /** Orientation: 'horizontal' (default) or 'vertical' */
+    orientation?: 'horizontal' | 'vertical';
+}
+export declare function geom_bullet(options?: BulletOptions): Geom;
+//# sourceMappingURL=bullet.d.ts.map

package/dist/geoms/bullet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bullet.d.ts","sourceRoot":"","sources":["../../src/geoms/bullet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,aAAa;IAC5B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,wDAAwD;IACxD,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;CACxC;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAiB7D"}

package/dist/geoms/calendar.d.ts

@@ -0,0 +1,48 @@
+/**
+ * geom_calendar - GitHub-style calendar heatmap
+ *
+ * Displays data as a grid of days organized by week, with color intensity
+ * representing the value. Perfect for showing activity over time, habits,
+ * contributions, etc.
+ *
+ * @example
+ * ```ts
+ * // Basic calendar heatmap
+ * gg(data)
+ *   .aes({ x: 'date', fill: 'count' })
+ *   .geom(geom_calendar())
+ *
+ * // With custom colors
+ * gg(data)
+ *   .aes({ x: 'date', fill: 'commits' })
+ *   .geom(geom_calendar({ empty_color: '#161b22', fill_color: '#39d353' }))
+ * ```
+ */
+import type { Geom } from '../types';
+export interface CalendarOptions {
+    /** Character for filled cells (default: '█') */
+    cell_char?: string;
+    /** Character for empty cells (default: '░') */
+    empty_char?: string;
+    /** Base color for empty/low values (default: '#161b22' - GitHub dark) */
+    empty_color?: string;
+    /** Color for high values (default: '#39d353' - GitHub green) */
+    fill_color?: string;
+    /** Show month labels (default: true) */
+    show_months?: boolean;
+    /** Show day labels (default: true) */
+    show_days?: boolean;
+    /** Week starts on (default: 0 = Sunday) */
+    week_start?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Number of intensity levels (default: 5) */
+    levels?: number;
+}
+/**
+ * Create a calendar heatmap (GitHub contribution graph style)
+ *
+ * Data should have:
+ * - x/date: Date values (string or Date)
+ * - fill/value: Numeric value for color intensity
+ */
+export declare function geom_calendar(options?: CalendarOptions): Geom;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/geoms/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/geoms/calendar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACtC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI,CAgBjE"}

package/dist/geoms/corrmat.d.ts

@@ -0,0 +1,59 @@
+/**
+ * geom_corrmat - Correlation matrix heatmap
+ *
+ * Displays pairwise correlations between numeric variables as a heatmap.
+ * Color intensity represents correlation strength, with diverging colors
+ * for positive (blue) vs negative (red) correlations.
+ *
+ * @example
+ * ```ts
+ * // From raw data - computes correlations automatically
+ * gg(data)
+ *   .aes({ x: 'var1', y: 'var2', fill: 'correlation' })
+ *   .geom(geom_corrmat())
+ *
+ * // From pre-computed correlation matrix
+ * gg(corrMatrix)
+ *   .aes({ x: 'var1', y: 'var2', fill: 'r' })
+ *   .geom(geom_corrmat({ show_values: true, show_significance: true }))
+ * ```
+ */
+import type { Geom } from '../types';
+export interface CorrmatOptions {
+    /** Show correlation values in cells (default: true) */
+    show_values?: boolean;
+    /** Number of decimal places for values (default: 2) */
+    decimals?: number;
+    /** Show significance markers (default: false) */
+    show_significance?: boolean;
+    /** Significance threshold for markers (default: 0.05) */
+    sig_threshold?: number;
+    /** Significance marker character (default: '*') */
+    sig_marker?: string;
+    /** Color for positive correlations (default: '#2166ac' - blue) */
+    positive_color?: string;
+    /** Color for negative correlations (default: '#b2182b' - red) */
+    negative_color?: string;
+    /** Color for zero/neutral (default: '#f7f7f7' - white) */
+    neutral_color?: string;
+    /** Show only lower triangle (default: false) */
+    lower_triangle?: boolean;
+    /** Show only upper triangle (default: false) */
+    upper_triangle?: boolean;
+    /** Show diagonal (default: true) */
+    show_diagonal?: boolean;
+    /** Method for computing correlation: 'pearson' | 'spearman' (default: 'pearson') */
+    method?: 'pearson' | 'spearman';
+}
+/**
+ * Create a correlation matrix heatmap
+ *
+ * Data can be:
+ * 1. Pre-computed: rows with var1, var2, correlation (and optionally p_value)
+ * 2. Raw data: will compute pairwise correlations for numeric columns
+ *
+ * Uses a diverging color scale from negative (red) through zero (white)
+ * to positive (blue) correlations.
+ */
+export declare function geom_corrmat(options?: CorrmatOptions): Geom;
+//# sourceMappingURL=corrmat.d.ts.map

package/dist/geoms/corrmat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrmat.d.ts","sourceRoot":"","sources":["../../src/geoms/corrmat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gDAAgD;IAChD,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,oCAAoC;IACpC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,oFAAoF;IACpF,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,CAAA;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAoB/D"}

package/dist/geoms/density.d.ts

@@ -0,0 +1,60 @@
+/**
+ * geom_density - 1D Kernel Density Estimation
+ *
+ * Computes and displays a smooth density estimate of the data.
+ * This is a smoothed version of the histogram, useful for showing
+ * the probability distribution of a continuous variable.
+ *
+ * @example
+ * ```ts
+ * // Basic density plot
+ * gg(data)
+ *   .aes({ x: 'value' })
+ *   .geom(geom_density())
+ *
+ * // Compare multiple distributions
+ * gg(data)
+ *   .aes({ x: 'value', color: 'group', fill: 'group' })
+ *   .geom(geom_density({ alpha: 0.3 }))
+ *
+ * // Adjust bandwidth for smoother/rougher curves
+ * gg(data)
+ *   .aes({ x: 'value' })
+ *   .geom(geom_density({ adjust: 0.5 }))  // More detailed
+ *   .geom(geom_density({ adjust: 2 }))    // Smoother
+ * ```
+ */
+import type { Geom } from '../types';
+export interface DensityOptions {
+    /** Number of points to evaluate density at (default: 512) */
+    n?: number;
+    /** Bandwidth for kernel density estimation (default: auto via Silverman's rule) */
+    bw?: number;
+    /** Kernel function (default: 'gaussian') */
+    kernel?: 'gaussian' | 'epanechnikov' | 'rectangular';
+    /** Adjustment factor for bandwidth (default: 1) */
+    adjust?: number;
+    /** Alpha transparency (default: 0.3) */
+    alpha?: number;
+    /** Line color (outline) */
+    color?: string;
+    /** Fill color */
+    fill?: string;
+    /** Line width for outline */
+    linewidth?: number;
+    /** Line type for outline */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+}
+/**
+ * Create a density plot (kernel density estimation)
+ *
+ * The density geom computes and displays a kernel density estimate,
+ * which is a smoothed version of the histogram. It's useful for
+ * displaying the probability distribution of a continuous variable.
+ *
+ * The y-axis shows density values which integrate to 1 over the
+ * full range, making it easy to compare distributions with different
+ * sample sizes.
+ */
+export declare function geom_density(options?: DensityOptions): Geom;
+//# sourceMappingURL=density.d.ts.map

package/dist/geoms/density.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"density.d.ts","sourceRoot":"","sources":["../../src/geoms/density.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,4CAA4C;IAC5C,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,GAAG,aAAa,CAAA;IACpD,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;CACzC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAiB/D"}

package/dist/geoms/dumbbell.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Dumbbell Geom
+ *
+ * Creates dumbbell charts showing two points connected by a line.
+ * Perfect for before/after comparisons, paired data, or showing ranges.
+ *
+ * Required aesthetics:
+ * - x: start value (numeric)
+ * - xend: end value (numeric)
+ * - y: category (categorical)
+ *
+ * Optional aesthetics:
+ * - color: point/line color
+ * - size: point size
+ */
+import type { Geom } from '../types.js';
+export interface DumbbellOptions {
+    /** Size of points (default: 2) */
+    size?: number;
+    /** Size of end points, if different from start (default: same as size) */
+    sizeEnd?: number;
+    /** Color of start points */
+    color?: string;
+    /** Color of end points (default: same as color) */
+    colorEnd?: string;
+    /** Line color (default: gray) */
+    lineColor?: string;
+    /** Line width (default: 1) */
+    lineWidth?: number;
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Point shape: 'circle' | 'square' | 'diamond' */
+    shape?: 'circle' | 'square' | 'diamond';
+}
+export declare function geom_dumbbell(options?: DumbbellOptions): Geom;
+//# sourceMappingURL=dumbbell.d.ts.map

package/dist/geoms/dumbbell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumbbell.d.ts","sourceRoot":"","sources":["../../src/geoms/dumbbell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;CACxC;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI,CAgBjE"}

package/dist/geoms/flame.d.ts

@@ -0,0 +1,50 @@
+/**
+ * geom_flame - Flame graph for performance profiling
+ *
+ * Displays hierarchical stack data as horizontal bars where width represents
+ * time/samples. Used for visualizing CPU profiles, call stacks, etc.
+ *
+ * @example
+ * ```ts
+ * // Basic flame graph
+ * gg(stackData)
+ *   .aes({ x: 'name', y: 'depth', fill: 'value' })
+ *   .geom(geom_flame())
+ *
+ * // With custom colors (icicle style - inverted)
+ * gg(stackData)
+ *   .aes({ x: 'name', y: 'depth', fill: 'self_time' })
+ *   .geom(geom_flame({ style: 'icicle', palette: 'cool' }))
+ * ```
+ */
+import type { Geom } from '../types';
+export interface FlameOptions {
+    /** Style: 'flame' (bottom-up) or 'icicle' (top-down) (default: 'flame') */
+    style?: 'flame' | 'icicle';
+    /** Color palette: 'warm' (reds/oranges), 'cool' (blues), 'hot' (red-yellow) */
+    palette?: 'warm' | 'cool' | 'hot';
+    /** Show value labels in bars (default: true for wide bars) */
+    show_labels?: boolean;
+    /** Minimum width to show label (default: 10) */
+    min_label_width?: number;
+    /** Sort frames within level: 'alpha', 'value', 'none' (default: 'alpha') */
+    sort?: 'alpha' | 'value' | 'none';
+    /** Character for filled bars (default: '█') */
+    bar_char?: string;
+}
+/**
+ * Create a flame graph visualization
+ *
+ * Data should have:
+ * - name/label: Frame/function name
+ * - value/width: Time or sample count (determines width)
+ * - depth/level: Stack depth (0 = root)
+ * - start: Optional start position (for pre-computed layouts)
+ * - parent: Optional parent name for hierarchy building
+ */
+export declare function geom_flame(options?: FlameOptions): Geom;
+/**
+ * Alias for icicle chart (top-down flame graph)
+ */
+export declare function geom_icicle(options?: FlameOptions): Geom;
+//# sourceMappingURL=flame.d.ts.map

package/dist/geoms/flame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flame.d.ts","sourceRoot":"","sources":["../../src/geoms/flame.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC1B,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAA;IACjC,8DAA8D;IAC9D,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IACjC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CAc3D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CAE5D"}

package/dist/geoms/index.d.ts

@@ -8,6 +8,7 @@ export { geom_bar, geom_col, type BarOptions } from './bar';
 export { geom_text, geom_label, type TextOptions } from './text';
 export { geom_area, geom_ribbon, type AreaOptions } from './area';
 export { geom_histogram, geom_freqpoly, type HistogramOptions, type FreqpolyOptions } from './histogram';
+export { geom_density, type DensityOptions } from './density';
 export { geom_boxplot, type BoxplotOptions } from './boxplot';
 export { geom_segment, geom_curve, type SegmentOptions } from './segment';
 export { geom_smooth, type SmoothOptions } from './smooth';
@@ -22,4 +23,15 @@ export { geom_rect, geom_abline, type RectOptions, type AblineOptions } from './
 export { geom_qq, geom_qq_line, type QQOptions, type QQLineOptions } from './qq';
 export { geom_ridgeline, geom_joy, type RidgelineOptions } from './ridgeline';
 export { geom_beeswarm, geom_quasirandom, type BeeswarmOptions } from './beeswarm';
+export { geom_dumbbell, type DumbbellOptions } from './dumbbell';
+export { geom_lollipop, type LollipopOptions } from './lollipop';
+export { geom_waffle, type WaffleOptions } from './waffle';
+export { geom_sparkline, type SparklineOptions, SPARK_BARS, SPARK_DOTS } from './sparkline';
+export { geom_bullet, type BulletOptions } from './bullet';
+export { geom_braille, type BrailleOptions, BRAILLE_BASE, BRAILLE_DOTS } from './braille';
+export { geom_calendar, type CalendarOptions } from './calendar';
+export { geom_flame, geom_icicle, type FlameOptions } from './flame';
+export { geom_corrmat, type CorrmatOptions } from './corrmat';
+export { geom_sankey, type SankeyOptions } from './sankey';
+export { geom_treemap, type TreemapOptions } from './treemap';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geoms/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AAC5E,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACxG,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACzE,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,OAAO,CAAA;AAGjD,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAA;AACjE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,WAAW,CAAA;AACnG,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,eAAe,EACf,KAAK,eAAe,GACrB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAA;AACrF,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,MAAM,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geoms/index.ts"],"names":[],"mappings":"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"}

package/dist/geoms/lollipop.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Lollipop Geom
+ *
+ * Creates lollipop charts - a line from baseline to a point with a dot at the end.
+ * A cleaner alternative to bar charts, especially for sparse data.
+ *
+ * Required aesthetics:
+ * - x: category (categorical) or value (numeric)
+ * - y: value (numeric) or category (categorical)
+ *
+ * Optional aesthetics:
+ * - color: point/line color
+ * - size: point size
+ */
+import type { Geom } from '../types.js';
+export interface LollipopOptions {
+    /** Size of the point (default: 2) */
+    size?: number;
+    /** Color of the point */
+    color?: string;
+    /** Line color (default: same as point color or gray) */
+    lineColor?: string;
+    /** Line width (default: 1) */
+    lineWidth?: number;
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Point shape: 'circle' | 'square' | 'diamond' */
+    shape?: 'circle' | 'square' | 'diamond';
+    /** Direction: 'vertical' (default) or 'horizontal' */
+    direction?: 'vertical' | 'horizontal';
+    /** Baseline value (default: 0) */
+    baseline?: number;
+}
+export declare function geom_lollipop(options?: LollipopOptions): Geom;
+//# sourceMappingURL=lollipop.d.ts.map

package/dist/geoms/lollipop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lollipop.d.ts","sourceRoot":"","sources":["../../src/geoms/lollipop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IACvC,sDAAsD;IACtD,SAAS,CAAC,EAAE,UAAU,GAAG,YAAY,CAAA;IACrC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,IAAI,CAgBjE"}

package/dist/geoms/sankey.d.ts

@@ -0,0 +1,57 @@
+/**
+ * geom_sankey - Sankey flow diagram
+ *
+ * Visualizes flows between nodes with proportional-width connections.
+ * Shows how quantities flow from sources to targets.
+ *
+ * @example
+ * ```ts
+ * // Basic Sankey diagram
+ * const flows = [
+ *   { source: 'A', target: 'X', value: 10 },
+ *   { source: 'A', target: 'Y', value: 5 },
+ *   { source: 'B', target: 'X', value: 8 },
+ *   { source: 'B', target: 'Y', value: 12 },
+ * ]
+ *
+ * gg(flows)
+ *   .aes({ source: 'source', target: 'target', value: 'value' })
+ *   .geom(geom_sankey())
+ *   .labs({ title: 'Flow Diagram' })
+ * ```
+ */
+import type { Geom } from '../types';
+export interface SankeyOptions {
+    /** Node width in characters (default: 3) */
+    node_width?: number;
+    /** Padding between nodes (default: 2) */
+    node_padding?: number;
+    /** Character for node blocks (default: '█') */
+    node_char?: string;
+    /** Character for flow lines (default: '─') */
+    flow_char?: string;
+    /** Show node labels (default: true) */
+    show_labels?: boolean;
+    /** Show flow values (default: false) */
+    show_values?: boolean;
+    /** Node alignment: 'left', 'right', 'center', 'justify' (default: 'justify') */
+    align?: 'left' | 'right' | 'center' | 'justify';
+    /** Color scheme for nodes: 'auto', 'source', 'target' (default: 'auto') */
+    color_by?: 'auto' | 'source' | 'target';
+    /** Minimum flow width in characters (default: 1) */
+    min_flow_width?: number;
+    /** Gap between flow lines (default: 0) */
+    flow_gap?: number;
+}
+/**
+ * Create a Sankey flow diagram
+ *
+ * Data should have:
+ * - source: Source node name
+ * - target: Target node name
+ * - value: Flow amount (determines connection width)
+ *
+ * Nodes are automatically positioned in columns based on flow direction.
+ */
+export declare function geom_sankey(options?: SankeyOptions): Geom;
+//# sourceMappingURL=sankey.d.ts.map

package/dist/geoms/sankey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sankey.d.ts","sourceRoot":"","sources":["../../src/geoms/sankey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;IAC/C,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACvC,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAkB7D"}

package/dist/geoms/sparkline.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Sparkline Geom
+ *
+ * Creates sparklines - word-sized inline graphics showing trends.
+ * Uses Unicode block characters for compact visualization.
+ *
+ * Required aesthetics:
+ * - x: sequence/time variable (or index)
+ * - y: values to plot
+ *
+ * Optional aesthetics:
+ * - group: for multiple sparklines
+ */
+import type { Geom } from '../types.js';
+export interface SparklineOptions {
+    /** Type of sparkline: 'line' (default), 'bar', 'dot' */
+    type?: 'line' | 'bar' | 'dot';
+    /** Width in characters (default: 20) */
+    width?: number;
+    /** Height in characters - for 'line' type (default: 1) */
+    height?: number;
+    /** Show min/max markers */
+    show_minmax?: boolean;
+    /** Color for the sparkline */
+    color?: string;
+    /** Color for minimum point */
+    min_color?: string;
+    /** Color for maximum point */
+    max_color?: string;
+    /** Normalize values to 0-1 range (default: true) */
+    normalize?: boolean;
+}
+export declare const SPARK_BARS: string[];
+export declare const SPARK_DOTS: string[];
+export declare function geom_sparkline(options?: SparklineOptions): Geom;
+//# sourceMappingURL=sparkline.d.ts.map

package/dist/geoms/sparkline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sparkline.d.ts","sourceRoot":"","sources":["../../src/geoms/sparkline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;IAC7B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAGD,eAAO,MAAM,UAAU,UAA2C,CAAA;AAGlE,eAAO,MAAM,UAAU,UAA2C,CAAA;AAElE,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,IAAI,CAgBnE"}

package/dist/geoms/treemap.d.ts

@@ -0,0 +1,70 @@
+/**
+ * geom_treemap - Treemap visualization
+ *
+ * Displays hierarchical data as nested rectangles where area represents value.
+ * Great for file sizes, market caps, budgets, or any hierarchical categorical data.
+ *
+ * @example
+ * ```ts
+ * // Flat treemap (no hierarchy)
+ * const data = [
+ *   { name: 'A', value: 100 },
+ *   { name: 'B', value: 80 },
+ *   { name: 'C', value: 60 },
+ * ]
+ *
+ * gg(data)
+ *   .aes({ label: 'name', value: 'value' })
+ *   .geom(geom_treemap())
+ *
+ * // Hierarchical treemap
+ * const hierarchical = [
+ *   { id: 'root', parent: null, value: 0 },
+ *   { id: 'A', parent: 'root', value: 100 },
+ *   { id: 'B', parent: 'root', value: 80 },
+ *   { id: 'A1', parent: 'A', value: 60 },
+ *   { id: 'A2', parent: 'A', value: 40 },
+ * ]
+ *
+ * gg(hierarchical)
+ *   .aes({ id: 'id', parent: 'parent', value: 'value' })
+ *   .geom(geom_treemap())
+ * ```
+ */
+import type { Geom } from '../types';
+export interface TreemapOptions {
+    /** Tiling algorithm: 'squarify', 'binary', 'slice', 'dice' (default: 'squarify') */
+    algorithm?: 'squarify' | 'binary' | 'slice' | 'dice';
+    /** Show labels in rectangles (default: true) */
+    show_labels?: boolean;
+    /** Show values in rectangles (default: false) */
+    show_values?: boolean;
+    /** Border character (default: '│' and '─') */
+    border?: boolean;
+    /** Padding between nested rectangles (default: 0) */
+    padding?: number;
+    /** Minimum rectangle size to show label (default: 4) */
+    min_label_size?: number;
+    /** Color by: 'value', 'depth', 'parent' (default: 'value') */
+    color_by?: 'value' | 'depth' | 'parent';
+    /** Fill character (default: '█') */
+    fill_char?: string;
+    /** Maximum depth to show (default: unlimited) */
+    max_depth?: number;
+    /** Aspect ratio target for squarify (default: 1.618 golden ratio) */
+    aspect_ratio?: number;
+}
+/**
+ * Create a treemap visualization
+ *
+ * Data can be:
+ * 1. Flat: rows with name/label and value
+ * 2. Hierarchical: rows with id, parent, and value
+ *
+ * For hierarchical data:
+ * - Root node should have parent = null or undefined
+ * - Leaf nodes should have non-zero values
+ * - Branch nodes can have value = 0 (sum of children used)
+ */
+export declare function geom_treemap(options?: TreemapOptions): Geom;
+//# sourceMappingURL=treemap.d.ts.map

package/dist/geoms/treemap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treemap.d.ts","sourceRoot":"","sources":["../../src/geoms/treemap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAA;IACpD,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;IACvC,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAkB/D"}

package/dist/geoms/waffle.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Waffle Geom
+ *
+ * Creates waffle charts - grid-based part-of-whole visualizations.
+ * A more readable alternative to pie charts, perfect for terminal display.
+ *
+ * Required aesthetics:
+ * - fill: category variable
+ * - values: numeric values or counts (from data)
+ *
+ * Optional aesthetics:
+ * - label: category labels
+ */
+import type { Geom } from '../types.js';
+export interface WaffleOptions {
+    /** Number of rows in the waffle grid (default: 10) */
+    rows?: number;
+    /** Number of columns in the waffle grid (default: 10) */
+    cols?: number;
+    /** Total units to represent (default: 100 for percentages) */
+    n_total?: number;
+    /** Character for filled cells */
+    fill_char?: string;
+    /** Character for empty cells */
+    empty_char?: string;
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Show legend (default: true) */
+    show_legend?: boolean;
+    /** Flip direction - fill by row instead of column */
+    flip?: boolean;
+    /** Gap between cells (0 or 1) */
+    gap?: number;
+}
+export declare function geom_waffle(options?: WaffleOptions): Geom;
+//# sourceMappingURL=waffle.d.ts.map