@ggterm/core 0.2.0

package/dist/geoms/path.d.ts

@@ -0,0 +1,59 @@
+/**
+ * geom_path - Path geometry
+ *
+ * Connects data points in the order they appear in the data,
+ * unlike geom_line which sorts by x. Useful for trajectories,
+ * drawing shapes, and ordered sequences.
+ */
+import type { Geom } from '../types';
+export interface PathOptions {
+    /** Line width (1-3) */
+    linewidth?: number;
+    /** Line type */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Fixed color (hex string) */
+    color?: string;
+    /** Line end style */
+    lineend?: 'butt' | 'round' | 'square';
+    /** Line join style */
+    linejoin?: 'round' | 'mitre' | 'bevel';
+}
+/**
+ * Connect data points in data order (not sorted by x)
+ *
+ * Unlike geom_line which sorts points by x before connecting them,
+ * geom_path connects points in the order they appear in the data.
+ * This is essential for:
+ * - Trajectories and movement paths
+ * - Drawing shapes and polygons
+ * - Time series where x is not monotonic
+ * - Spiral and circular patterns
+ *
+ * @example
+ * // Draw a trajectory
+ * gg(trajectoryData)
+ *   .aes({ x: 'longitude', y: 'latitude' })
+ *   .geom(geom_path())
+ *
+ * @example
+ * // Draw a spiral
+ * const spiral = Array.from({ length: 100 }, (_, i) => {
+ *   const t = i * 0.1
+ *   return { x: t * Math.cos(t), y: t * Math.sin(t) }
+ * })
+ * gg(spiral).aes({ x: 'x', y: 'y' }).geom(geom_path())
+ *
+ * @example
+ * // Draw a shape (triangle)
+ * const triangle = [
+ *   { x: 0, y: 0 },
+ *   { x: 1, y: 2 },
+ *   { x: 2, y: 0 },
+ *   { x: 0, y: 0 }, // close the shape
+ * ]
+ * gg(triangle).aes({ x: 'x', y: 'y' }).geom(geom_path())
+ */
+export declare function geom_path(options?: PathOptions): Geom;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../src/geoms/path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACxC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACrC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAczD"}

package/dist/geoms/point.d.ts

@@ -0,0 +1,30 @@
+/**
+ * geom_point - Scatter plot geometry
+ */
+import type { Geom } from '../types';
+import type { Position } from '../positions';
+export interface PointOptions {
+    size?: number;
+    shape?: 'circle' | 'square' | 'triangle' | 'cross' | 'diamond';
+    alpha?: number;
+    color?: string;
+    /** Position adjustment (default: 'identity'). Use position_jitter() for overplotted data. */
+    position?: Position | 'identity' | 'jitter' | 'dodge';
+}
+/**
+ * Render data points as scatter plot markers
+ *
+ * @example
+ * ```ts
+ * // Basic scatter plot
+ * gg(data).geom(geom_point())
+ *
+ * // Jittered points to avoid overplotting
+ * gg(data).geom(geom_point({ position: position_jitter() }))
+ *
+ * // Or with shorthand
+ * gg(data).geom(geom_point({ position: 'jitter' }))
+ * ```
+ */
+export declare function geom_point(options?: PointOptions): Geom;
+//# sourceMappingURL=point.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"point.d.ts","sourceRoot":"","sources":["../../src/geoms/point.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,CAAA;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAA;CACtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,YAAiB,GAAG,IAAI,CAY3D"}

package/dist/geoms/qq.d.ts

@@ -0,0 +1,75 @@
+/**
+ * geom_qq - Q-Q plot geometry
+ *
+ * Creates Q-Q (quantile-quantile) plots to assess whether data
+ * follows a particular distribution (typically normal).
+ *
+ * @example
+ * ```ts
+ * // Basic Q-Q plot to check normality
+ * gg(data)
+ *   .aes({ x: 'values' })
+ *   .geom(geom_qq())
+ *   .geom(geom_qq_line())
+ *
+ * // With custom distribution
+ * gg(data)
+ *   .aes({ x: 'values' })
+ *   .geom(geom_qq({ distribution: 'uniform' }))
+ * ```
+ */
+import type { Geom } from '../types';
+export interface QQOptions {
+    /** Distribution to compare against (default: 'norm') */
+    distribution?: 'norm' | 'uniform' | 'exp';
+    /** Distribution parameters */
+    dparams?: {
+        mean?: number;
+        sd?: number;
+        rate?: number;
+    };
+    /** Point size */
+    size?: number;
+    /** Point shape */
+    shape?: string;
+    /** Point color */
+    color?: string;
+    /** Alpha transparency */
+    alpha?: number;
+}
+export interface QQLineOptions {
+    /** Distribution to compare against (default: 'norm') */
+    distribution?: 'norm' | 'uniform' | 'exp';
+    /** Distribution parameters */
+    dparams?: {
+        mean?: number;
+        sd?: number;
+        rate?: number;
+    };
+    /** Line color */
+    color?: string;
+    /** Line type */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+    /** Alpha transparency */
+    alpha?: number;
+}
+/**
+ * Q-Q plot points
+ *
+ * Plots sample quantiles against theoretical quantiles.
+ * If the points fall approximately on the diagonal reference line,
+ * the data follows the reference distribution.
+ *
+ * The x aesthetic should be the variable to test.
+ * Output uses x = theoretical quantile, y = sample quantile.
+ */
+export declare function geom_qq(options?: QQOptions): Geom;
+/**
+ * Q-Q plot reference line
+ *
+ * Draws a line through the first and third quartiles of the
+ * theoretical vs sample distribution. Points should fall on
+ * this line if the data follows the reference distribution.
+ */
+export declare function geom_qq_line(options?: QQLineOptions): Geom;
+//# sourceMappingURL=qq.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qq.d.ts","sourceRoot":"","sources":["../../src/geoms/qq.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAA;IACzC,8BAA8B;IAC9B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAA;IACzC,8BAA8B;IAC9B,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACxC,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,SAAc,GAAG,IAAI,CAarD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAY9D"}

package/dist/geoms/rect.d.ts

@@ -0,0 +1,37 @@
+/**
+ * geom_rect - Rectangle geometry
+ *
+ * Renders rectangles defined by xmin, xmax, ymin, ymax.
+ */
+import type { Geom } from '../types';
+export interface RectOptions {
+    /** Alpha transparency */
+    alpha?: number;
+    /** Border color */
+    color?: string;
+    /** Fill color */
+    fill?: string;
+    /** Border linetype */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+}
+/**
+ * Render rectangles
+ */
+export declare function geom_rect(options?: RectOptions): Geom;
+/**
+ * Render arbitrary lines (y = slope * x + intercept)
+ */
+export interface AblineOptions {
+    /** Slope of the line */
+    slope?: number;
+    /** Y-intercept of the line */
+    intercept?: number;
+    /** Alpha transparency */
+    alpha?: number;
+    /** Line color */
+    color?: string;
+    /** Linetype */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+}
+export declare function geom_abline(options?: AblineOptions): Geom;
+//# sourceMappingURL=rect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../src/geoms/rect.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;CACzC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAYzD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe;IACf,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;CACzC;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAa7D"}

package/dist/geoms/rug.d.ts

@@ -0,0 +1,65 @@
+/**
+ * geom_rug - Marginal rug plots
+ *
+ * Draws tick marks along the axes showing the marginal distribution
+ * of data points. Commonly used alongside scatter plots to visualize
+ * data density along each axis.
+ */
+import type { Geom } from '../types';
+export interface RugOptions {
+    /** Which sides to draw rugs on */
+    sides?: string;
+    /** Length of rug ticks (in character cells) */
+    length?: number;
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Fixed color (hex string) */
+    color?: string;
+    /** Whether to draw outside the plot area (default: true) */
+    outside?: boolean;
+}
+/**
+ * Draw marginal rug marks along axes
+ *
+ * Rug plots show tick marks at each data point position along one
+ * or both axes. This helps visualize the marginal distribution of
+ * data, especially useful for identifying clustering or gaps.
+ *
+ * @param options.sides - Which sides to draw rugs: 'b' (bottom), 't' (top),
+ *   'l' (left), 'r' (right). Can combine, e.g., 'bl' for bottom and left.
+ *   Default is 'bl'.
+ * @param options.length - Length of rug ticks in character cells. Default is 1.
+ * @param options.alpha - Opacity from 0 to 1. Default is 1.
+ * @param options.color - Fixed color for all rug marks.
+ * @param options.outside - Whether to draw outside plot area. Default is true.
+ *
+ * @example
+ * // Add rugs to a scatter plot (bottom and left)
+ * gg(data)
+ *   .aes({ x: 'x', y: 'y' })
+ *   .geom(geom_point())
+ *   .geom(geom_rug())
+ *
+ * @example
+ * // Rugs on all four sides
+ * gg(data)
+ *   .aes({ x: 'x', y: 'y' })
+ *   .geom(geom_point())
+ *   .geom(geom_rug({ sides: 'bltr' }))
+ *
+ * @example
+ * // Only x-axis rugs (bottom)
+ * gg(data)
+ *   .aes({ x: 'x', y: 'y' })
+ *   .geom(geom_point())
+ *   .geom(geom_rug({ sides: 'b' }))
+ *
+ * @example
+ * // Colored rugs with transparency
+ * gg(data)
+ *   .aes({ x: 'x', y: 'y', color: 'group' })
+ *   .geom(geom_point())
+ *   .geom(geom_rug({ alpha: 0.5 }))
+ */
+export declare function geom_rug(options?: RugOptions): Geom;
+//# sourceMappingURL=rug.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rug.d.ts","sourceRoot":"","sources":["../../src/geoms/rug.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,UAAU;IACzB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,UAAe,GAAG,IAAI,CAavD"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"segment.d.ts","sourceRoot":"","sources":["../../src/geoms/segment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACxC,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CAc/D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,cAAc,GAAG;IACnD,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,IAAI,CAeZ"}

package/dist/geoms/smooth.d.ts

@@ -0,0 +1,51 @@
+/**
+ * geom_smooth - Smoothed conditional means
+ *
+ * Adds a smoothed line with optional confidence interval band.
+ * Uses linear regression (lm) or LOESS smoothing.
+ */
+import type { Geom } from '../types';
+export interface SmoothOptions {
+    /** Smoothing method: 'lm' for linear, 'loess' or 'lowess' for local regression */
+    method?: 'lm' | 'loess' | 'lowess';
+    /** For loess: proportion of data to use in each local regression (0-1) */
+    span?: number;
+    /** Number of points to evaluate the smooth at */
+    n?: number;
+    /** Show confidence interval band? */
+    se?: boolean;
+    /** Confidence level (default 0.95) */
+    level?: number;
+    /** Line color */
+    color?: string;
+    /** Confidence band fill color (defaults to line color with alpha) */
+    fill?: string;
+    /** Alpha for confidence band (0-1) */
+    alpha?: number;
+    /** Line width/style */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+}
+/**
+ * Add a smoothed conditional mean line with confidence interval
+ *
+ * @example
+ * ```ts
+ * // Linear regression with confidence band
+ * gg(data).geom(geom_smooth())
+ *
+ * // LOESS smoothing
+ * gg(data).geom(geom_smooth({ method: 'loess' }))
+ *
+ * // Linear regression without confidence band
+ * gg(data).geom(geom_smooth({ se: false }))
+ *
+ * // Custom styling
+ * gg(data).geom(geom_smooth({
+ *   method: 'lm',
+ *   color: '#3366cc',
+ *   alpha: 0.2
+ * }))
+ * ```
+ */
+export declare function geom_smooth(options?: SmoothOptions): Geom;
+//# sourceMappingURL=smooth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smooth.d.ts","sourceRoot":"","sources":["../../src/geoms/smooth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,MAAM,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,CAAA;IAClC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iDAAiD;IACjD,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,qCAAqC;IACrC,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;CACzC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAiB7D"}

package/dist/geoms/step.d.ts

@@ -0,0 +1,43 @@
+/**
+ * geom_step - Step/staircase line geometry
+ *
+ * Creates a stairstep plot where lines only move horizontally
+ * or vertically, not diagonally. Useful for time series with
+ * discrete changes (e.g., stock prices, state machines).
+ */
+import type { Geom } from '../types';
+export interface StepOptions {
+    /** Step direction: 'hv' (right then up/down), 'vh' (up/down then right), 'mid' (midpoint) */
+    direction?: 'hv' | 'vh' | 'mid';
+    /** Line width (1-3) */
+    linewidth?: number;
+    /** Line type */
+    linetype?: 'solid' | 'dashed' | 'dotted';
+    /** Opacity (0-1) */
+    alpha?: number;
+    /** Fixed color (hex string) */
+    color?: string;
+}
+/**
+ * Connect data points with stairstep lines
+ *
+ * @example
+ * // Stock price changes (horizontal first, then vertical)
+ * gg(stockData)
+ *   .aes({ x: 'date', y: 'price' })
+ *   .geom(geom_step())
+ *
+ * @example
+ * // State changes (vertical first, then horizontal)
+ * gg(stateData)
+ *   .aes({ x: 'time', y: 'state' })
+ *   .geom(geom_step({ direction: 'vh' }))
+ *
+ * @example
+ * // Centered steps
+ * gg(data)
+ *   .aes({ x: 'x', y: 'y' })
+ *   .geom(geom_step({ direction: 'mid' }))
+ */
+export declare function geom_step(options?: StepOptions): Geom;
+//# sourceMappingURL=step.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/geoms/step.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAA;IAC/B,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACxC,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAazD"}

package/dist/geoms/text.d.ts

@@ -0,0 +1,23 @@
+/**
+ * geom_text - Text label geometry
+ */
+import type { Geom } from '../types';
+export interface TextOptions {
+    nudge_x?: number;
+    nudge_y?: number;
+    hjust?: 'left' | 'center' | 'right';
+    vjust?: 'top' | 'middle' | 'bottom';
+    color?: string;
+    size?: number;
+}
+/**
+ * Add text labels to the plot
+ */
+export declare function geom_text(options?: TextOptions): Geom;
+/**
+ * Add text labels with background (for better readability)
+ */
+export declare function geom_label(options?: TextOptions & {
+    fill?: string;
+}): Geom;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/geoms/text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IACnC,KAAK,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAczD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAe9E"}

package/dist/geoms/tile.d.ts

@@ -0,0 +1,27 @@
+/**
+ * geom_tile - Tile geometry for heatmaps
+ *
+ * Renders rectangles at x, y positions with fill based on a value.
+ */
+import type { Geom } from '../types';
+export interface TileOptions {
+    /** Width of each tile (default: auto from data spacing) */
+    width?: number;
+    /** Height of each tile (default: auto from data spacing) */
+    height?: number;
+    /** Alpha transparency */
+    alpha?: number;
+    /** Border color (default: none) */
+    color?: string;
+    /** Fill aesthetic (maps to color scale) */
+    fill?: string;
+}
+/**
+ * Render tiles/heatmap
+ */
+export declare function geom_tile(options?: TileOptions): Geom;
+/**
+ * Alias for geom_tile with default binning
+ */
+export declare function geom_raster(options?: TileOptions): Geom;
+//# sourceMappingURL=tile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tile.d.ts","sourceRoot":"","sources":["../../src/geoms/tile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAazD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,IAAI,CAE3D"}

package/dist/geoms/violin.d.ts

@@ -0,0 +1,29 @@
+/**
+ * geom_violin - Violin plot geometry
+ *
+ * Combines a boxplot with a rotated kernel density plot on each side.
+ */
+import type { Geom } from '../types';
+export interface ViolinOptions {
+    /** Width of the violin (default: 0.8) */
+    width?: number;
+    /** Whether to draw the quantile lines (default: true) */
+    draw_quantiles?: number[] | null;
+    /** Scale violins: 'area' (default), 'count', or 'width' */
+    scale?: 'area' | 'count' | 'width';
+    /** Trim violin to data range (default: true) */
+    trim?: boolean;
+    /** Bandwidth adjustment factor (default: 1) */
+    adjust?: number;
+    /** Alpha transparency */
+    alpha?: number;
+    /** Border color */
+    color?: string;
+    /** Fill color */
+    fill?: string;
+}
+/**
+ * Render violin plot
+ */
+export declare function geom_violin(options?: ViolinOptions): Geom;
+//# sourceMappingURL=violin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"violin.d.ts","sourceRoot":"","sources":["../../src/geoms/violin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;IAClC,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,IAAI,CAe7D"}

package/dist/grammar.d.ts

@@ -0,0 +1,81 @@
+/**
+ * gg() - Plot builder with fluent API
+ */
+import type { AestheticMapping, Coord, DataSource, Facet, Geom, Labels, PlotSpec, RenderOptions, Scale, Stat, Theme } from './types';
+/**
+ * Plot builder class with fluent API
+ */
+export declare class GGPlot {
+    private _data;
+    private _aes;
+    private _geoms;
+    private _stats;
+    private _scales;
+    private _coord;
+    private _facet?;
+    private _theme;
+    private _labels;
+    constructor(data: DataSource);
+    /**
+     * Set aesthetic mappings
+     */
+    aes(mapping: AestheticMapping): this;
+    /**
+     * Add a geometry layer
+     */
+    geom(geom: Geom): this;
+    /**
+     * Add an annotation layer
+     * Annotations are geometry layers with fixed positions (not mapped from data)
+     */
+    annotate(annotation: Geom): this;
+    /**
+     * Add a statistical transformation
+     */
+    stat(stat: Stat): this;
+    /**
+     * Add or configure a scale
+     */
+    scale(scale: Scale): this;
+    /**
+     * Set coordinate system
+     */
+    coord(coord: Coord): this;
+    /**
+     * Set faceting
+     */
+    facet(facet: Facet): this;
+    /**
+     * Apply a theme
+     */
+    theme(theme: Theme | Partial<Theme>): this;
+    /**
+     * Set labels (title, axes, legends)
+     */
+    labs(labels: Labels): this;
+    /**
+     * Push new data points (for streaming)
+     */
+    push(data: DataSource | Record<string, unknown>): this;
+    /**
+     * Get the current plot specification
+     */
+    spec(): PlotSpec;
+    /**
+     * Get data
+     */
+    get data(): DataSource;
+    /**
+     * Get geoms
+     */
+    get geoms(): Geom[];
+    /**
+     * Render plot to string
+     */
+    render(options: RenderOptions): string;
+}
+/**
+ * Create a new plot
+ */
+export declare function gg(data?: DataSource): GGPlot;
+//# sourceMappingURL=grammar.d.ts.map

package/dist/grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../src/grammar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,KAAK,EACL,UAAU,EACV,KAAK,EACL,IAAI,EACJ,MAAM,EACN,QAAQ,EACR,aAAa,EACb,KAAK,EACL,IAAI,EACJ,KAAK,EACN,MAAM,SAAS,CAAA;AAKhB;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,MAAM,CAAC,CAAO;IACtB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAa;gBAEhB,IAAI,EAAE,UAAU;IAI5B;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAKpC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAKtB;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI;IAKhC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAKtB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAWzB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKzB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKzB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI;IAK1C;;OAEG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAStD;;OAEG;IACH,IAAI,IAAI,QAAQ;IAchB;;OAEG;IACH,IAAI,IAAI,IAAI,UAAU,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,IAAI,EAAE,CAElB;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;CAGvC;AAED;;GAEG;AACH,wBAAgB,EAAE,CAAC,IAAI,GAAE,UAAe,GAAG,MAAM,CAEhD"}

package/dist/history/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Plot history management
+ *
+ * Tracks all plots created with provenance metadata for later retrieval.
+ */
+import type { PlotSpec } from '../types';
+export interface PlotProvenance {
+    id: string;
+    timestamp: string;
+    dataFile?: string;
+    command?: string;
+    description: string;
+    geomTypes: string[];
+    aesthetics: string[];
+}
+export interface HistoricalPlot {
+    _provenance: PlotProvenance;
+    spec: PlotSpec;
+}
+export interface HistoryEntry {
+    id: string;
+    timestamp: string;
+    description: string;
+    dataFile?: string;
+    geomTypes: string[];
+}
+/**
+ * Get the .ggterm directory path
+ */
+export declare function getGGTermDir(): string;
+/**
+ * Get the plots directory path
+ */
+export declare function getPlotsDir(): string;
+/**
+ * Get the history file path
+ */
+export declare function getHistoryFile(): string;
+/**
+ * Ensure the history directories exist
+ */
+export declare function ensureHistoryDirs(): void;
+/**
+ * Generate a unique plot ID based on date and sequence
+ */
+export declare function generatePlotId(): string;
+/**
+ * Auto-generate a description based on the plot spec
+ */
+export declare function generateDescription(spec: PlotSpec): string;
+/**
+ * Save a plot to history
+ */
+export declare function savePlotToHistory(spec: PlotSpec, options?: {
+    dataFile?: string;
+    command?: string;
+    description?: string;
+}): string;
+/**
+ * Load a plot from history by ID
+ */
+export declare function loadPlotFromHistory(id: string): HistoricalPlot | null;
+/**
+ * Get all history entries
+ */
+export declare function getHistory(): HistoryEntry[];
+/**
+ * Search history by text (searches description, dataFile, geomTypes)
+ */
+export declare function searchHistory(query: string): HistoryEntry[];
+/**
+ * Get the most recent plot ID
+ */
+export declare function getLatestPlotId(): string | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/history/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,cAAc,CAAA;IAC3B,IAAI,EAAE,QAAQ,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAUxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAwBvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CA8B1D;AA6BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CAChB,GACL,MAAM,CAwCR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAQrE;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,EAAE,CAgB3C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAa3D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAM/C"}