@ggterm/core 0.2.0

package/dist/terminal/capabilities.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Terminal Capability Detection
+ *
+ * Detects terminal features for optimal rendering:
+ * - Color support (16, 256, truecolor)
+ * - Graphics protocols (Sixel, Kitty, iTerm2)
+ * - Unicode support
+ * - Terminal dimensions
+ */
+/**
+ * Color capability levels
+ */
+export type ColorCapability = 'none' | '16' | '256' | 'truecolor';
+/**
+ * Graphics protocol support
+ */
+export type GraphicsProtocol = 'none' | 'sixel' | 'kitty' | 'iterm2';
+/**
+ * Terminal capabilities
+ */
+export interface TerminalCapabilities {
+    /** Color support level */
+    colors: ColorCapability;
+    /** Graphics protocol (if any) */
+    graphics: GraphicsProtocol;
+    /** Unicode/UTF-8 support */
+    unicode: boolean;
+    /** Braille character support */
+    braille: boolean;
+    /** Terminal width in characters */
+    width: number;
+    /** Terminal height in characters */
+    height: number;
+    /** Terminal name/program */
+    terminal: string;
+    /** Is running in CI environment */
+    isCI: boolean;
+    /** Is a TTY (interactive terminal) */
+    isTTY: boolean;
+}
+/**
+ * Detect color capability from environment
+ */
+export declare function detectColorCapability(): ColorCapability;
+/**
+ * Detect graphics protocol support
+ */
+export declare function detectGraphicsProtocol(): GraphicsProtocol;
+/**
+ * Detect Unicode support
+ */
+export declare function detectUnicodeSupport(): boolean;
+/**
+ * Detect terminal dimensions
+ */
+export declare function detectTerminalSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Check if running in CI environment
+ */
+export declare function isCI(): boolean;
+/**
+ * Get terminal name/program
+ */
+export declare function getTerminalName(): string;
+/**
+ * Detect all terminal capabilities
+ */
+export declare function detectCapabilities(): TerminalCapabilities;
+/**
+ * Query terminal for sixel support using DA1 escape sequence
+ * Note: This is async and requires terminal interaction
+ */
+export declare function querySixelSupport(): Promise<boolean>;
+/**
+ * Get recommended renderer based on capabilities
+ */
+export declare function getRecommendedRenderer(caps: TerminalCapabilities): string;
+/**
+ * Get cached terminal capabilities
+ */
+export declare function getCapabilities(): TerminalCapabilities;
+/**
+ * Clear capability cache (useful for testing)
+ */
+export declare function clearCapabilityCache(): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/terminal/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/terminal/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,WAAW,CAAA;AAEjE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,MAAM,EAAE,eAAe,CAAA;IACvB,iCAAiC;IACjC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAA;IACb,sCAAsC;IACtC,KAAK,EAAE,OAAO,CAAA;CACf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAmDvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAkCzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CA+B9C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CActE;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAW9B;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAOxC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,oBAAoB,CAczD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAWzE;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,oBAAoB,CAKtD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/terminal/colors.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Terminal Color Utilities
+ *
+ * Provides color conversion and palette optimization for different terminal capabilities:
+ * - Truecolor (24-bit RGB)
+ * - 256 color palette
+ * - 16 color ANSI palette
+ */
+import type { RGBA } from '../types';
+/**
+ * Standard ANSI 16 colors
+ * These are the basic 16 colors available on all terminals
+ */
+export declare const ANSI_16_COLORS: RGBA[];
+/**
+ * Generate the 256-color palette
+ * 0-15: ANSI 16 colors
+ * 16-231: 6x6x6 RGB cube
+ * 232-255: Grayscale ramp
+ */
+export declare function generate256Palette(): RGBA[];
+export declare function getPalette256(): RGBA[];
+/**
+ * Calculate color distance using weighted Euclidean distance
+ * Weighted for human perception (red and blue less than green)
+ */
+export declare function colorDistance(a: RGBA, b: RGBA): number;
+/**
+ * Find the closest color in a palette
+ */
+export declare function findClosestPaletteColor(color: RGBA, palette: RGBA[]): number;
+/**
+ * Convert RGB to ANSI 256 color index
+ */
+export declare function rgbToAnsi256(color: RGBA): number;
+/**
+ * Convert RGB to ANSI 16 color index
+ */
+export declare function rgbToAnsi16(color: RGBA): number;
+/**
+ * Generate ANSI escape sequence for foreground color
+ */
+export declare function fgEscape(color: RGBA, mode: 'truecolor' | '256' | '16'): string;
+/**
+ * Generate ANSI escape sequence for background color
+ */
+export declare function bgEscape(color: RGBA, mode: 'truecolor' | '256' | '16'): string;
+/**
+ * Quantize a color to a specific palette depth
+ */
+export declare function quantizeColor(color: RGBA, depth: '256' | '16'): RGBA;
+/**
+ * Floyd-Steinberg dithering for color reduction
+ * Distributes quantization error to neighboring pixels
+ */
+export declare function ditherPixels(pixels: RGBA[], width: number, height: number, depth: '256' | '16'): RGBA[];
+/**
+ * Create an optimized palette from a set of colors
+ * Uses median cut algorithm for color quantization
+ */
+export declare function createOptimizedPalette(colors: RGBA[], maxColors: number): RGBA[];
+/**
+ * Color mode type
+ */
+export type ColorMode = 'truecolor' | '256' | '16' | 'none';
+/**
+ * Get color escape based on terminal capability
+ */
+export declare function getColorEscape(color: RGBA, mode: ColorMode, type: 'fg' | 'bg'): string;
+/**
+ * Reset escape sequence
+ */
+export declare const RESET = "\u001B[0m";
+/**
+ * Reset foreground only
+ */
+export declare const RESET_FG = "\u001B[39m";
+/**
+ * Reset background only
+ */
+export declare const RESET_BG = "\u001B[49m";
+//# sourceMappingURL=colors.d.ts.map

package/dist/terminal/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/terminal/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,IAAI,EAiBhC,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CA4B3C;AAID,wBAAgB,aAAa,IAAI,IAAI,EAAE,CAKtC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,MAAM,CAMtD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAa5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAsBhD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,CAsC/C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAW9E;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAW9E;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAQpE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,EAAE,EACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,GAAG,IAAI,GAClB,IAAI,EAAE,CA2CR;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,CAkIhF;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAA;AAE3D;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,IAAI,GAAG,IAAI,GAChB,MAAM,CASR;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,cAAY,CAAA;AAE9B;;GAEG;AACH,eAAO,MAAM,QAAQ,eAAa,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,QAAQ,eAAa,CAAA"}

package/dist/terminal/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Terminal utilities
+ *
+ * Provides terminal capability detection, color management, and rendering optimization.
+ */
+export { detectCapabilities, getCapabilities, clearCapabilityCache, detectColorCapability, detectGraphicsProtocol, detectUnicodeSupport, detectTerminalSize, isCI, getTerminalName, getRecommendedRenderer, querySixelSupport, } from './capabilities';
+export type { ColorCapability, GraphicsProtocol, TerminalCapabilities, } from './capabilities';
+export { ANSI_16_COLORS, generate256Palette, getPalette256, colorDistance, findClosestPaletteColor, rgbToAnsi256, rgbToAnsi16, fgEscape, bgEscape, quantizeColor, ditherPixels, createOptimizedPalette, getColorEscape, RESET, RESET_FG, RESET_BG, } from './colors';
+export type { ColorMode } from './colors';
+export { isRendererAvailable, selectRenderer, selectColorMode, RendererChain, createRendererChain, autoRenderer, getTerminalInfo, } from './renderer-chain';
+export type { RendererType, RendererConfig } from './renderer-chain';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,IAAI,EACJ,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,MAAM,UAAU,CAAA;AAEjB,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/terminal/renderer-chain.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Automatic Renderer Fallback Chain
+ *
+ * Provides intelligent renderer selection based on terminal capabilities.
+ * Automatically falls back to simpler renderers when advanced features aren't available.
+ */
+import type { Canvas, RenderOptions, Renderer } from '../types';
+import { type TerminalCapabilities, type GraphicsProtocol } from './capabilities';
+import { type ColorMode } from './colors';
+/**
+ * Renderer types in order of preference (best to worst)
+ */
+export type RendererType = 'kitty' | 'iterm2' | 'sixel' | 'braille' | 'block-subpixel' | 'block' | 'ascii';
+/**
+ * Renderer configuration
+ */
+export interface RendererConfig {
+    /** Preferred renderer (will be used if available) */
+    preferred?: RendererType;
+    /** Force a specific renderer (ignores capability detection) */
+    force?: RendererType;
+    /** Minimum acceptable renderer in fallback chain */
+    minimum?: RendererType;
+    /** Color mode override */
+    colorMode?: ColorMode;
+    /** Enable dithering for color reduction */
+    dithering?: boolean;
+}
+/**
+ * Check if a renderer is available given terminal capabilities
+ */
+export declare function isRendererAvailable(type: RendererType, caps: TerminalCapabilities): boolean;
+/**
+ * Select the best available renderer based on capabilities
+ */
+export declare function selectRenderer(config?: RendererConfig, caps?: TerminalCapabilities): RendererType;
+/**
+ * Get the appropriate color mode for capabilities
+ */
+export declare function selectColorMode(caps?: TerminalCapabilities): ColorMode;
+/**
+ * Renderer chain - manages automatic fallback
+ */
+export declare class RendererChain {
+    private capabilities;
+    private selectedRenderer;
+    private colorMode;
+    private renderers;
+    constructor(config?: RendererConfig);
+    /**
+     * Get current capabilities
+     */
+    getCapabilities(): TerminalCapabilities;
+    /**
+     * Get selected renderer type
+     */
+    getSelectedRenderer(): RendererType;
+    /**
+     * Get selected color mode
+     */
+    getColorMode(): ColorMode;
+    /**
+     * Register a renderer implementation
+     */
+    registerRenderer(type: RendererType, renderer: Renderer): void;
+    /**
+     * Check if a renderer is registered
+     */
+    hasRenderer(type: RendererType): boolean;
+    /**
+     * Render using the selected renderer
+     */
+    render(canvas: Canvas, options: RenderOptions): string;
+    /**
+     * Built-in ASCII fallback renderer
+     */
+    private renderASCII;
+    /**
+     * Get a description of current rendering setup
+     */
+    describe(): string;
+}
+/**
+ * Create a renderer chain with sensible defaults
+ */
+export declare function createRendererChain(config?: RendererConfig): RendererChain;
+/**
+ * Auto-detect and create the best renderer for the current terminal
+ */
+export declare function autoRenderer(): {
+    type: RendererType;
+    colorMode: ColorMode;
+};
+/**
+ * Get terminal info summary
+ */
+export declare function getTerminalInfo(): {
+    terminal: string;
+    renderer: RendererType;
+    colorMode: ColorMode;
+    size: {
+        width: number;
+        height: number;
+    };
+    graphics: GraphicsProtocol;
+    unicode: boolean;
+    isCI: boolean;
+    isTTY: boolean;
+};
+//# sourceMappingURL=renderer-chain.d.ts.map

package/dist/terminal/renderer-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer-chain.d.ts","sourceRoot":"","sources":["../../src/terminal/renderer-chain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC/D,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,KAAK,SAAS,EAAyB,MAAM,UAAU,CAAA;AAEhE;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,gBAAgB,GAChB,OAAO,GACP,OAAO,CAAA;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qDAAqD;IACrD,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,oDAAoD;IACpD,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAmCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAW3F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,GAAE,cAAmB,EAC3B,IAAI,CAAC,EAAE,oBAAoB,GAC1B,YAAY,CA0Bd;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAatE;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,SAAS,CAA6B;gBAElC,MAAM,GAAE,cAAmB;IAOvC;;OAEG;IACH,eAAe,IAAI,oBAAoB;IAIvC;;OAEG;IACH,mBAAmB,IAAI,YAAY;IAInC;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAI9D;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIxC;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM;IAsBtD;;OAEG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,QAAQ,IAAI,MAAM;CAenB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,cAAmB,GAAG,aAAa,CAE9E;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,SAAS,CAAA;CAAE,CAM3E;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,YAAY,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACvC,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf,CAYA"}

package/dist/themes/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../src/themes/default.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAErC;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,CA2BpC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,CA2BpC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,CA2BjC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,KAAK,CA2BpC;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,KAAK,CA2BjC"}

package/dist/types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Core types for ggterm Grammar of Graphics
+ */
+export type DataRecord = Record<string, unknown>;
+export type DataSource = DataRecord[];
+export interface AestheticMapping {
+    x: string;
+    y: string;
+    /** Secondary y-axis data field */
+    y2?: string;
+    /** End x coordinate for segments/annotations */
+    xend?: string;
+    /** End y coordinate for segments/annotations */
+    yend?: string;
+    /** Min x for rect/area annotations */
+    xmin?: string;
+    /** Max x for rect/area annotations */
+    xmax?: string;
+    /** Min y for rect/area annotations */
+    ymin?: string;
+    /** Max y for rect/area annotations */
+    ymax?: string;
+    color?: string;
+    fill?: string;
+    size?: string;
+    shape?: string;
+    alpha?: string;
+    group?: string;
+    label?: string;
+}
+export interface RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export type Domain = [number, number] | string[];
+export type Range = [number, number] | string[] | RGBA[];
+export type ScaleTransform = 'identity' | 'log10' | 'sqrt' | 'reverse';
+export interface Scale {
+    type: 'continuous' | 'discrete' | 'identity';
+    aesthetic: string;
+    domain?: Domain;
+    range?: Range;
+    /** Custom tick positions */
+    breaks?: number[];
+    /** Custom tick labels (must match breaks length if both provided) */
+    labels?: string[];
+    /** Scale transformation */
+    trans?: ScaleTransform;
+    map(value: unknown): number | string | RGBA;
+    invert?(position: number): unknown;
+}
+export interface Coord {
+    type: string;
+    transform(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+    /** X-axis limits for zooming (data is clipped, not filtered) */
+    xlim?: [number, number];
+    /** Y-axis limits for zooming (data is clipped, not filtered) */
+    ylim?: [number, number];
+    /** Whether to clip points outside the limits (default: true) */
+    clip?: boolean;
+}
+export interface PositionSpec {
+    type: 'identity' | 'dodge' | 'stack' | 'fill' | 'jitter';
+    width?: number;
+    height?: number;
+    preserve?: 'total' | 'single';
+}
+export interface Geom {
+    type: string;
+    stat?: string;
+    position?: string | PositionSpec;
+    params: Record<string, unknown>;
+}
+export interface Stat {
+    type: string;
+    compute(data: DataSource, aes: AestheticMapping): DataSource;
+}
+export type Labeller = (value: string, variable?: string) => string;
+export interface Facet {
+    type: 'wrap' | 'grid';
+    vars: string | {
+        rows?: string;
+        cols?: string;
+    };
+    ncol?: number;
+    nrow?: number;
+    scales?: 'fixed' | 'free' | 'free_x' | 'free_y';
+    /** Labeller function for customizing strip labels */
+    labeller?: Labeller;
+    /** Move row/column strips (for grid): 'x' moves col to bottom, 'y' moves row to left */
+    switch?: 'x' | 'y' | 'both' | null;
+}
+export interface Theme {
+    panel: {
+        background: string;
+        border: 'none' | 'single' | 'double' | 'rounded';
+        grid: {
+            major: string | null;
+            minor: string | null;
+        };
+    };
+    axis: {
+        text: {
+            color: string;
+        };
+        ticks: {
+            char: string;
+            length: number;
+        };
+        title: {
+            color: string;
+            bold: boolean;
+        };
+    };
+    legend: {
+        position: 'right' | 'bottom' | 'none';
+        title: {
+            bold: boolean;
+        };
+    };
+    title: {
+        align: 'left' | 'center' | 'right';
+        bold: boolean;
+    };
+    facet: {
+        strip: {
+            /** Strip text color */
+            text: string;
+            /** Strip background color (use empty string for no background) */
+            background: string;
+        };
+    };
+}
+export interface Labels {
+    title?: string;
+    subtitle?: string;
+    caption?: string;
+    x?: string;
+    y?: string;
+    /** Label for secondary y-axis */
+    y2?: string;
+    color?: string;
+    fill?: string;
+    size?: string;
+}
+export interface RenderOptions {
+    width: number;
+    height: number;
+    renderer?: 'braille' | 'block' | 'sixel' | 'auto';
+    colorMode?: 'none' | '16' | '256' | 'truecolor' | 'auto';
+}
+export interface CanvasCell {
+    char: string;
+    fg: RGBA;
+    bg: RGBA;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+}
+export interface Canvas {
+    width: number;
+    height: number;
+    cells: CanvasCell[][];
+    setCell(x: number, y: number, cell: Partial<CanvasCell>): void;
+    getCell(x: number, y: number): CanvasCell;
+    clear(): void;
+}
+export interface Renderer {
+    render(canvas: Canvas, options: RenderOptions): string;
+}
+export interface PlotSpec {
+    data: DataSource;
+    aes: AestheticMapping;
+    geoms: Geom[];
+    stats: Stat[];
+    scales: Scale[];
+    coord: Coord;
+    facet?: Facet;
+    theme: Theme;
+    labels: Labels;
+}
+export interface ComputedPoint {
+    x: number;
+    y: number;
+    color?: RGBA;
+    size?: number;
+    shape?: string;
+    alpha?: number;
+    group?: string | number;
+    label?: string;
+    data: DataRecord;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ggterm/core",
+  "version": "0.2.0",
+  "description": "Grammar of Graphics engine for terminals",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ggterm": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": {
+      "import": "./dist/cli.js"
+    }
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts ./src/cli.ts --outdir ./dist --target node && tsc --emitDeclarationOnly",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "grammar-of-graphics",
+    "visualization",
+    "terminal",
+    "charts"
+  ],
+  "author": "Scott Handley",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/handleylab/ggterm.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/handleylab/ggterm#readme",
+  "bugs": {
+    "url": "https://github.com/handleylab/ggterm/issues"
+  },
+  "peerDependencies": {},
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "@types/bun": "^1.1.0"
+  }
+}