@reifydb/shell 0.8.1 → 0.9.1

package/dist/index.css

@@ -8,26 +8,26 @@
   width: 100vw !important;
   height: 100vh !important;
   z-index: 9999 !important;
-  background: #1e1e2e !important;
+  background: var(--rdb-shell-bg, #1e1e2e) !important;
 }
 .xterm {
-  padding: 12px;
+  padding: var(--rdb-shell-padding, 12px);
 }
 .xterm-viewport {
   scrollbar-width: thin;
-  scrollbar-color: #45475a #1e1e2e;
+  scrollbar-color: var(--rdb-shell-scrollbar-thumb, #45475a) var(--rdb-shell-bg, #1e1e2e);
 }
 .xterm-viewport::-webkit-scrollbar {
   width: 8px;
 }
 .xterm-viewport::-webkit-scrollbar-track {
-  background: #1e1e2e;
+  background: var(--rdb-shell-bg, #1e1e2e);
 }
 .xterm-viewport::-webkit-scrollbar-thumb {
-  background: #45475a;
+  background: var(--rdb-shell-scrollbar-thumb, #45475a);
   border-radius: 4px;
 }
 .xterm-viewport::-webkit-scrollbar-thumb:hover {
-  background: #585b70;
+  background: var(--rdb-shell-scrollbar-thumb-hover, #585b70);
 }
 /*# sourceMappingURL=index.css.map */

package/dist/index.css.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/terminal/styles.css"],"sourcesContent":["/* SPDX-License-Identifier: Apache-2.0 */\n/* Copyright (c) 2026 ReifyDB */\n\n/* Fullscreen mode */\n.reifydb-shell-fullscreen {\n  position: fixed !important;\n  top: 0 !important;\n  left: 0 !important;\n  right: 0 !important;\n  bottom: 0 !important;\n  width: 100vw !important;\n  height: 100vh !important;\n  z-index: 9999 !important;\n  background: #1e1e2e !important;\n}\n\n/* xterm.js container styling */\n.xterm {\n  padding: 12px;\n}\n\n.xterm-viewport {\n  /* Hide scrollbar but keep scrolling functional */\n  scrollbar-width: thin;\n  scrollbar-color: #45475a #1e1e2e;\n}\n\n.xterm-viewport::-webkit-scrollbar {\n  width: 8px;\n}\n\n.xterm-viewport::-webkit-scrollbar-track {\n  background: #1e1e2e;\n}\n\n.xterm-viewport::-webkit-scrollbar-thumb {\n  background: #45475a;\n  border-radius: 4px;\n}\n\n.xterm-viewport::-webkit-scrollbar-thumb:hover {\n  background: #585b70;\n}\n"],"mappings":";AAIA,CAAC;AACC,YAAU;AACV,OAAK;AACL,QAAM;AACN,SAAO;AACP,UAAQ;AACR,SAAO;AACP,UAAQ;AACR,WAAS;AACT,cAAY;AACd;AAGA,CAAC;AACC,WAAS;AACX;AAEA,CAAC;AAEC,mBAAiB;AACjB,mBAAiB,QAAQ;AAC3B;AAEA,CANC,cAMc;AACb,SAAO;AACT;AAEA,CAVC,cAUc;AACb,cAAY;AACd;AAEA,CAdC,cAcc;AACb,cAAY;AACZ,iBAAe;AACjB;AAEA,CAnBC,cAmBc,yBAAyB;AACtC,cAAY;AACd;","names":[]}
+{"version":3,"sources":["../src/terminal/styles.css"],"sourcesContent":["/* SPDX-License-Identifier: Apache-2.0 */\n/* Copyright (c) 2026 ReifyDB */\n\n/* Fullscreen mode */\n.reifydb-shell-fullscreen {\n  position: fixed !important;\n  top: 0 !important;\n  left: 0 !important;\n  right: 0 !important;\n  bottom: 0 !important;\n  width: 100vw !important;\n  height: 100vh !important;\n  z-index: 9999 !important;\n  background: var(--rdb-shell-bg, #1e1e2e) !important;\n}\n\n/* xterm.js container styling */\n.xterm {\n  padding: var(--rdb-shell-padding, 12px);\n}\n\n.xterm-viewport {\n  /* Hide scrollbar but keep scrolling functional */\n  scrollbar-width: thin;\n  scrollbar-color: var(--rdb-shell-scrollbar-thumb, #45475a) var(--rdb-shell-bg, #1e1e2e);\n}\n\n.xterm-viewport::-webkit-scrollbar {\n  width: 8px;\n}\n\n.xterm-viewport::-webkit-scrollbar-track {\n  background: var(--rdb-shell-bg, #1e1e2e);\n}\n\n.xterm-viewport::-webkit-scrollbar-thumb {\n  background: var(--rdb-shell-scrollbar-thumb, #45475a);\n  border-radius: 4px;\n}\n\n.xterm-viewport::-webkit-scrollbar-thumb:hover {\n  background: var(--rdb-shell-scrollbar-thumb-hover, #585b70);\n}\n"],"mappings":";AAIA,CAAC;AACC,YAAU;AACV,OAAK;AACL,QAAM;AACN,SAAO;AACP,UAAQ;AACR,SAAO;AACP,UAAQ;AACR,WAAS;AACT,cAAY,IAAI,cAAc,EAAE;AAClC;AAGA,CAAC;AACC,WAAS,IAAI,mBAAmB,EAAE;AACpC;AAEA,CAAC;AAEC,mBAAiB;AACjB,mBAAiB,IAAI,2BAA2B,EAAE,SAAS,IAAI,cAAc,EAAE;AACjF;AAEA,CANC,cAMc;AACb,SAAO;AACT;AAEA,CAVC,cAUc;AACb,cAAY,IAAI,cAAc,EAAE;AAClC;AAEA,CAdC,cAcc;AACb,cAAY,IAAI,2BAA2B,EAAE;AAC7C,iBAAe;AACjB;AAEA,CAnBC,cAmBc,yBAAyB;AACtC,cAAY,IAAI,iCAAiC,EAAE;AACrD;","names":[]}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { ValueRole, ResultColumn, RqlTokenKind } from '@reifydb/core';
+
 /**
  * Terminal color theme configuration
  */
@@ -28,6 +30,10 @@ interface TerminalTheme {
  * Catppuccin Mocha theme - default theme
  */
 declare const defaultTheme: TerminalTheme;
+/**
+ * ReifyDB product theme - zinc-900 ground with the indigo brand accent
+ */
+declare const reifydbDarkTheme: TerminalTheme;
 /**
  * ANSI escape codes for terminal colors and formatting
  */
@@ -110,14 +116,66 @@ declare class TerminalAdapter {
     static restoreCursor(): string;
 }
 
+interface AnsiStyle {
+    color?: string;
+    bold?: boolean;
+    italic?: boolean;
+    dim?: boolean;
+}
+declare const RESET = "\u001B[0m";
+declare function sgr(style: AnsiStyle): string;
+declare function paint(text: string, prefix: string): string;
+
+type TableBorder = 'unicode' | 'ascii' | 'none';
+type ValuePalette = Partial<Record<ValueRole, AnsiStyle>>;
+interface TableTheme {
+    border?: AnsiStyle;
+    header?: AnsiStyle;
+    values?: ValuePalette;
+}
+interface TableColumn {
+    name: string;
+    width: number;
+}
+interface TableOptions {
+    maxWidth?: number;
+    truncate?: boolean;
+    border?: TableBorder;
+    theme?: TableTheme;
+    columns?: ResultColumn[];
+}
+declare const reifydbDarkTableTheme: TableTheme;
+declare class TableRenderer {
+    private data;
+    private glyphs;
+    private plan;
+    private borderPrefix;
+    private headerPrefix;
+    private valuePrefixes;
+    constructor(data: Record<string, unknown>[], options?: TableOptions);
+    get columns(): TableColumn[];
+    get dropped(): string[];
+    render(): string[];
+    private rule;
+    private width;
+    private headerRow;
+    private dataRow;
+    private joinCells;
+}
+
 /**
  * Result from executing a statement
  */
 interface ExecutionResult {
     success: boolean;
     data?: Record<string, unknown>[];
+    /**
+     * Column metadata for `data`, in display order.
+     * Omit it and the formatter infers columns from the rows.
+     */
+    columns?: ResultColumn[];
     error?: string;
-    execution_time: number;
+    executionTime: number;
 }
 /**
  * Interface for executing database statements.
@@ -135,7 +193,7 @@ interface Executor {
     /**
      * Get shape for a table (optional, used by .shape command)
      */
-    getShape?(table_name: string): Promise<string | null>;
+    getShape?(tableName: string): Promise<string | null>;
 }
 /**
  * Display mode for query results
@@ -149,6 +207,12 @@ interface HistoryStorage {
     load(): string[];
     save(entries: string[]): void;
 }
+/**
+ * Paints a single input line for display.
+ * Receives the line being edited plus the already-entered part of a
+ * multi-line statement, and returns the line with ANSI colors applied.
+ */
+type Highlighter = (line: string, context?: string) => string;
 /**
  * Configuration options for the Shell
  */
@@ -190,16 +254,33 @@ interface ShellOptions {
     /**
      * Key for localStorage history (default: "reifydb-shell-history")
      */
-    history_key?: string;
+    historyKey?: string;
     /**
      * Custom history storage implementation.
-     * If provided, history_key is ignored.
+     * If provided, historyKey is ignored.
      */
     historyStorage?: HistoryStorage;
     /**
      * Initial display mode (default: "full")
      */
     displayMode?: DisplayMode;
+    /**
+     * Text placed on the input line when the shell starts, ready to run.
+     */
+    initialInput?: string;
+    /**
+     * Paints the input line as it is typed.
+     * Use `rqlHighlighter()` for RQL syntax coloring.
+     */
+    highlight?: Highlighter;
+    /**
+     * Border style for result tables (default: "unicode")
+     */
+    tableBorder?: TableBorder;
+    /**
+     * Colors for result tables
+     */
+    tableTheme?: TableTheme;
     /**
      * Callback when user exits the shell
      */
@@ -248,6 +329,8 @@ declare class Shell {
     private continuationPrompt;
     private continuationPromptLen;
     private welcomeMessage;
+    private initialInput;
+    private highlight;
     private onExit;
     private onFullscreenChange;
     constructor(container: HTMLElement, options: ShellOptions);
@@ -289,7 +372,7 @@ declare class LineEditor {
     deleteToEnd(): void;
     deleteToStart(): void;
     deleteWord(): void;
-    render(prompt: string): void;
+    render(prompt: string, display?: string): void;
 }
 
 /**
@@ -314,7 +397,7 @@ declare class CommandHistory {
     private position;
     private savedInput;
     private storage;
-    constructor(storage?: HistoryStorage, history_key?: string);
+    constructor(storage?: HistoryStorage, historyKey?: string);
     add(command: string): void;
     previous(currentInput: string): string | null;
     next(): string | null;
@@ -333,10 +416,20 @@ declare class MultilineBuffer {
     static isStatementComplete(input: string): boolean;
 }
 
+type RqlPalette = Partial<Record<RqlTokenKind, AnsiStyle>>;
+declare const reifydbDarkPalette: RqlPalette;
+declare function rqlHighlighter(palette?: RqlPalette): Highlighter;
+
+interface FormatterOptions {
+    border?: TableBorder;
+    theme?: TableTheme;
+}
 declare class OutputFormatter {
     private terminal;
     private displayMode;
-    constructor(terminal: TerminalAdapter, displayMode?: DisplayMode);
+    private border;
+    private theme;
+    constructor(terminal: TerminalAdapter, displayMode?: DisplayMode, options?: FormatterOptions);
     setDisplayMode(mode: DisplayMode): void;
     formatResult(result: ExecutionResult): void;
     private formatTable;
@@ -344,66 +437,29 @@ declare class OutputFormatter {
     private formatExecutionTime;
 }
 
-interface TableColumn {
-    name: string;
-    width: number;
-}
-interface TableOptions {
-    maxWidth?: number;
-    truncate?: boolean;
-}
-declare class TableRenderer {
-    private data;
-    private columns;
-    private maxWidth;
-    private truncate;
-    constructor(data: Record<string, unknown>[], options?: TableOptions);
-    private calculateColumns;
-    private formatValue;
-    private truncateString;
-    render(): string[];
-    private fitColumns;
-    private padCenter;
-    private padRight;
-}
-
-/**
- * Interface for WebAssembly database instances.
- * This matches the WasmDB interface from reifydb-wasm.
- */
 interface WasmDB {
     admin(rql: string): Promise<unknown> | unknown;
 }
-/**
- * Executor adapter for WebAssembly-based ReifyDB instances.
- */
 declare class WasmExecutor implements Executor {
     private db;
     constructor(db: WasmDB);
     execute(rql: string): Promise<ExecutionResult>;
     getTables(): Promise<string[]>;
-    getShape(table_name: string): Promise<string | null>;
+    getShape(tableName: string): Promise<string | null>;
 }
 
-/**
- * Interface for WebSocket client.
- * This matches the WsClient interface from @reifydb/client.
- */
 interface WsClient {
     admin<const S extends readonly unknown[]>(rql: string, params: unknown, shapes: S): Promise<unknown[][]>;
 }
-/**
- * Executor adapter for WebSocket-based ReifyDB connections.
- */
 declare class WsExecutor implements Executor {
     private client;
     constructor(client: WsClient);
     execute(rql: string): Promise<ExecutionResult>;
     getTables(): Promise<string[]>;
-    getShape(table_name: string): Promise<string | null>;
+    getShape(tableName: string): Promise<string | null>;
     private extractValue;
 }
 
 declare function handleDotCommand(input: string, context: DotCommandContext): Promise<DotCommandResult>;
 
-export { COLORS, CommandHistory, type DisplayMode, type DotCommandContext, type DotCommandResult, type ExecutionResult, type Executor, type HistoryStorage, type KeyHandler, LineEditor, LocalStorageHistoryStorage, MemoryHistoryStorage, MultilineBuffer, OutputFormatter, Shell, type ShellOptions, type TableColumn, type TableOptions, TableRenderer, TerminalAdapter, type TerminalTheme, type WasmDB, WasmExecutor, type WsClient, WsExecutor, defaultTheme, handleDotCommand };
+export { type AnsiStyle, COLORS, CommandHistory, type DisplayMode, type DotCommandContext, type DotCommandResult, type ExecutionResult, type Executor, type FormatterOptions, type Highlighter, type HistoryStorage, type KeyHandler, LineEditor, LocalStorageHistoryStorage, MemoryHistoryStorage, MultilineBuffer, OutputFormatter, RESET, type RqlPalette, Shell, type ShellOptions, type TableBorder, type TableColumn, type TableOptions, TableRenderer, type TableTheme, TerminalAdapter, type TerminalTheme, type ValuePalette, type WasmDB, WasmExecutor, type WsClient, WsExecutor, defaultTheme, handleDotCommand, paint, reifydbDarkPalette, reifydbDarkTableTheme, reifydbDarkTheme, rqlHighlighter, sgr };