claude-scope 0.1.2 → 0.1.4

package/dist/utils/formatters.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Formatter utilities for displaying data in human-readable formats
+ */
+/**
+ * Format milliseconds to human-readable duration
+ *
+ * Examples:
+ * - 45000 -> "45s"
+ * - 60000 -> "1m 0s"
+ * - 3600000 -> "1h 0m 0s"
+ * - 3665000 -> "1h 1m 5s"
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Human-readable duration string
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format cost in USD with appropriate precision
+ *
+ * - Values < $0.01 (positive): 4 decimal places ($0.0012)
+ * - Values >= $0.01: 2 decimal places ($1.23)
+ * - Values >= $100: 0 decimal places ($123)
+ * - Negative values: 2 decimal places ($-1.23)
+ *
+ * @param usd - Cost in USD
+ * @returns Formatted cost string with $ prefix
+ */
+export declare function formatCostUSD(usd: number): string;
+/**
+ * Create a visual progress bar
+ *
+ * @param percent - Percentage (0-100)
+ * @param width - Bar width in characters (default: DEFAULTS.PROGRESS_BAR_WIDTH)
+ * @returns Progress bar string like "████████░░░░░░░░░░░░"
+ */
+export declare function progressBar(percent: number, width?: number): string;
+/**
+ * Get color code for context percentage
+ *
+ * - <50%: green (low usage)
+ * - 50-79%: yellow (medium usage)
+ * - >=80%: red (high usage)
+ *
+ * @param percent - Context usage percentage (0-100)
+ * @returns ANSI color code
+ */
+export declare function getContextColor(percent: number): string;
+/**
+ * Colorize text with ANSI color code
+ *
+ * @param text - Text to colorize
+ * @param color - ANSI color code
+ * @returns Colorized text with reset code
+ */
+export declare function colorize(text: string, color: string): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/utils/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../src/utils/formatters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAsBjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBjD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAoC,GAAG,MAAM,CAKhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/utils/formatters.js

@@ -0,0 +1,114 @@
+/**
+ * Formatter utilities for displaying data in human-readable formats
+ */
+import { TIME, COST_THRESHOLDS, CONTEXT_THRESHOLDS, ANSI_COLORS, DEFAULTS } from '../constants.js';
+/**
+ * Format milliseconds to human-readable duration
+ *
+ * Examples:
+ * - 45000 -> "45s"
+ * - 60000 -> "1m 0s"
+ * - 3600000 -> "1h 0m 0s"
+ * - 3665000 -> "1h 1m 5s"
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Human-readable duration string
+ */
+export function formatDuration(ms) {
+    if (ms <= 0)
+        return '0s';
+    const seconds = Math.floor(ms / TIME.MS_PER_SECOND);
+    const hours = Math.floor(seconds / TIME.SECONDS_PER_HOUR);
+    const minutes = Math.floor((seconds % TIME.SECONDS_PER_HOUR) / TIME.SECONDS_PER_MINUTE);
+    const secs = seconds % TIME.SECONDS_PER_MINUTE;
+    const parts = [];
+    if (hours > 0) {
+        parts.push(`${hours}h`);
+        parts.push(`${minutes}m`);
+        parts.push(`${secs}s`);
+    }
+    else if (minutes > 0) {
+        parts.push(`${minutes}m`);
+        parts.push(`${secs}s`);
+    }
+    else {
+        parts.push(`${secs}s`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Format cost in USD with appropriate precision
+ *
+ * - Values < $0.01 (positive): 4 decimal places ($0.0012)
+ * - Values >= $0.01: 2 decimal places ($1.23)
+ * - Values >= $100: 0 decimal places ($123)
+ * - Negative values: 2 decimal places ($-1.23)
+ *
+ * @param usd - Cost in USD
+ * @returns Formatted cost string with $ prefix
+ */
+export function formatCostUSD(usd) {
+    const absUsd = Math.abs(usd);
+    if (usd < 0) {
+        // Negative values: 2 decimal places
+        return `$${usd.toFixed(2)}`;
+    }
+    else if (absUsd < COST_THRESHOLDS.SMALL) {
+        // 4 decimal places for very small positive values
+        return `$${usd.toFixed(4)}`;
+    }
+    else if (absUsd < COST_THRESHOLDS.LARGE) {
+        // 2 decimal places for normal values
+        return `$${usd.toFixed(2)}`;
+    }
+    else {
+        // 0 decimal places for large values
+        return `$${Math.floor(usd).toFixed(0)}`;
+    }
+}
+/**
+ * Create a visual progress bar
+ *
+ * @param percent - Percentage (0-100)
+ * @param width - Bar width in characters (default: DEFAULTS.PROGRESS_BAR_WIDTH)
+ * @returns Progress bar string like "████████░░░░░░░░░░░░"
+ */
+export function progressBar(percent, width = DEFAULTS.PROGRESS_BAR_WIDTH) {
+    const clampedPercent = Math.max(0, Math.min(100, percent));
+    const filled = Math.round((clampedPercent / 100) * width);
+    const empty = width - filled;
+    return '█'.repeat(filled) + '░'.repeat(empty);
+}
+/**
+ * Get color code for context percentage
+ *
+ * - <50%: green (low usage)
+ * - 50-79%: yellow (medium usage)
+ * - >=80%: red (high usage)
+ *
+ * @param percent - Context usage percentage (0-100)
+ * @returns ANSI color code
+ */
+export function getContextColor(percent) {
+    const clampedPercent = Math.max(0, Math.min(100, percent));
+    if (clampedPercent < CONTEXT_THRESHOLDS.LOW_MEDIUM) {
+        return ANSI_COLORS.GREEN;
+    }
+    else if (clampedPercent < CONTEXT_THRESHOLDS.MEDIUM_HIGH) {
+        return ANSI_COLORS.YELLOW;
+    }
+    else {
+        return ANSI_COLORS.RED;
+    }
+}
+/**
+ * Colorize text with ANSI color code
+ *
+ * @param text - Text to colorize
+ * @param color - ANSI color code
+ * @returns Colorized text with reset code
+ */
+export function colorize(text, color) {
+    return `${color}${text}${ANSI_COLORS.RESET}`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/utils/formatters.js.map

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

package/dist/widgets/context-widget.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Context Widget
+ *
+ * Displays context window usage with progress bar
+ */
+import { StdinDataWidget } from './core/stdin-data-widget.js';
+import type { RenderContext, StdinData } from '../types.js';
+export declare class ContextWidget extends StdinDataWidget {
+    readonly id = "context";
+    readonly metadata: import("../core/types.js").IWidgetMetadata;
+    protected renderWithData(data: StdinData, context: RenderContext): string | null;
+}
+//# sourceMappingURL=context-widget.d.ts.map

package/dist/widgets/context-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-widget.d.ts","sourceRoot":"","sources":["../../src/widgets/context-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAI9D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,aAAc,SAAQ,eAAe;IAChD,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,QAAQ,6CAGf;IAEF,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;CAqBjF"}

package/dist/widgets/context-widget.js

@@ -0,0 +1,31 @@
+/**
+ * Context Widget
+ *
+ * Displays context window usage with progress bar
+ */
+import { StdinDataWidget } from './core/stdin-data-widget.js';
+import { createWidgetMetadata } from '../core/widget-types.js';
+import { progressBar, getContextColor, colorize } from '../ui/utils/formatters.js';
+import { DEFAULTS } from '../constants.js';
+export class ContextWidget extends StdinDataWidget {
+    id = 'context';
+    metadata = createWidgetMetadata('Context', 'Displays context window usage with progress bar');
+    renderWithData(data, context) {
+        const { current_usage, context_window_size } = data.context_window;
+        if (!current_usage)
+            return null;
+        // Calculate actual context usage:
+        // - input_tokens: new tokens added to context
+        // - cache_creation_input_tokens: tokens spent creating cache (also in context)
+        // - cache_read_input_tokens: NOT counted (reading from cache doesn't use context space)
+        // - output_tokens: tokens in the response (also part of context)
+        const used = current_usage.input_tokens +
+            current_usage.cache_creation_input_tokens +
+            current_usage.output_tokens;
+        const percent = Math.round((used / context_window_size) * 100);
+        const bar = progressBar(percent, DEFAULTS.PROGRESS_BAR_WIDTH);
+        const color = getContextColor(percent);
+        return colorize(`[${bar}] ${percent}%`, color);
+    }
+}
+//# sourceMappingURL=context-widget.js.map

package/dist/widgets/context-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-widget.js","sourceRoot":"","sources":["../../src/widgets/context-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3C,MAAM,OAAO,aAAc,SAAQ,eAAe;IACvC,EAAE,GAAG,SAAS,CAAC;IACf,QAAQ,GAAG,oBAAoB,CACtC,SAAS,EACT,iDAAiD,CAClD,CAAC;IAEQ,cAAc,CAAC,IAAe,EAAE,OAAsB;QAC9D,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC,cAAc,CAAC;QAEnE,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QAEhC,kCAAkC;QAClC,8CAA8C;QAC9C,+EAA+E;QAC/E,wFAAwF;QACxF,iEAAiE;QACjE,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY;YAC1B,aAAa,CAAC,2BAA2B;YACzC,aAAa,CAAC,aAAa,CAAC;QAEzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,mBAAmB,CAAC,GAAG,GAAG,CAAC,CAAC;QAE/D,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAEvC,OAAO,QAAQ,CAAC,IAAI,GAAG,KAAK,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/widgets/core/stdin-data-widget.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Base class for widgets that receive StdinData
+ *
+ * Uses Template Method Pattern for state management.
+ *
+ * Extending widgets only need to implement renderWithData() method.
+ * The base class handles data storage, update logic, and enables checking.
+ */
+import type { IWidget, IWidgetMetadata, WidgetContext, RenderContext } from '../../core/types.js';
+import type { StdinData } from '../../types.js';
+/**
+ * Abstract base class for widgets working with StdinData
+ *
+ * Uses Template Method Pattern:
+ * - render() is final template method that handles null checks
+ * - Subclasses implement renderWithData() hook with data as parameter
+ *
+ * @example
+ * ```typescript
+ * export class ModelWidget extends StdinDataWidget {
+ *   readonly id = 'model';
+ *   readonly metadata = createWidgetMetadata('Model', 'Displays Claude model');
+ *
+ *   protected renderWithData(data: StdinData, context: RenderContext): string | null {
+ *     return data.model.display_name;
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class StdinDataWidget implements IWidget {
+    /**
+     * Stored stdin data from last update
+     */
+    protected data: StdinData | null;
+    /**
+     * Widget enabled state
+     */
+    protected enabled: boolean;
+    /**
+     * Unique widget identifier
+     */
+    abstract readonly id: string;
+    /**
+     * Widget metadata
+     */
+    abstract readonly metadata: IWidgetMetadata;
+    /**
+     * Initialize widget with context
+     * @param context - Widget initialization context
+     */
+    initialize(context: WidgetContext): Promise<void>;
+    /**
+     * Update widget with new stdin data
+     * @param data - Stdin data from Claude Code
+     */
+    update(data: StdinData): Promise<void>;
+    /**
+     * Get stored stdin data
+     * @returns Stored stdin data
+     * @throws Error if data has not been initialized (update not called)
+     */
+    getData(): StdinData;
+    /**
+     * Check if widget is enabled
+     * @returns true if widget should render
+     */
+    isEnabled(): boolean;
+    /**
+     * Template method - final, subclasses implement renderWithData()
+     *
+     * Handles null data checks and calls renderWithData() hook.
+     *
+     * @param context - Render context
+     * @returns Rendered string, or null if widget should not display
+     */
+    render(context: RenderContext): Promise<string | null>;
+    /**
+     * Hook method for subclasses to implement rendering logic
+     *
+     * Called by render() template method with guaranteed non-null data.
+     *
+     * @param data - Stdin data (guaranteed to be non-null)
+     * @param context - Render context
+     * @returns Rendered string, or null if widget should not display
+     */
+    protected abstract renderWithData(data: StdinData, context: RenderContext): string | null;
+    /**
+     * Optional cleanup method
+     * Override if widget has resources to clean up
+     */
+    cleanup?(): Promise<void>;
+}
+//# sourceMappingURL=stdin-data-widget.d.ts.map

package/dist/widgets/core/stdin-data-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-data-widget.d.ts","sourceRoot":"","sources":["../../../src/widgets/core/stdin-data-widget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAClG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,eAAgB,YAAW,OAAO;IACtD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAQ;IAExC;;OAEG;IACH,SAAS,CAAC,OAAO,UAAQ;IAEzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IAE5C;;;OAGG;IACG,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;;;OAIG;IACH,OAAO,IAAI,SAAS;IAOpB;;;OAGG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAO5D;;;;;;;;OAQG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,CAC/B,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,aAAa,GACrB,MAAM,GAAG,IAAI;IAEhB;;;OAGG;IACG,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC"}

package/dist/widgets/core/stdin-data-widget.js

@@ -0,0 +1,84 @@
+/**
+ * Base class for widgets that receive StdinData
+ *
+ * Uses Template Method Pattern for state management.
+ *
+ * Extending widgets only need to implement renderWithData() method.
+ * The base class handles data storage, update logic, and enables checking.
+ */
+/**
+ * Abstract base class for widgets working with StdinData
+ *
+ * Uses Template Method Pattern:
+ * - render() is final template method that handles null checks
+ * - Subclasses implement renderWithData() hook with data as parameter
+ *
+ * @example
+ * ```typescript
+ * export class ModelWidget extends StdinDataWidget {
+ *   readonly id = 'model';
+ *   readonly metadata = createWidgetMetadata('Model', 'Displays Claude model');
+ *
+ *   protected renderWithData(data: StdinData, context: RenderContext): string | null {
+ *     return data.model.display_name;
+ *   }
+ * }
+ * ```
+ */
+export class StdinDataWidget {
+    /**
+     * Stored stdin data from last update
+     */
+    data = null;
+    /**
+     * Widget enabled state
+     */
+    enabled = true;
+    /**
+     * Initialize widget with context
+     * @param context - Widget initialization context
+     */
+    async initialize(context) {
+        this.enabled = context.config?.enabled !== false;
+    }
+    /**
+     * Update widget with new stdin data
+     * @param data - Stdin data from Claude Code
+     */
+    async update(data) {
+        this.data = data;
+    }
+    /**
+     * Get stored stdin data
+     * @returns Stored stdin data
+     * @throws Error if data has not been initialized (update not called)
+     */
+    getData() {
+        if (!this.data) {
+            throw new Error(`Widget ${this.id} data not initialized. Call update() first.`);
+        }
+        return this.data;
+    }
+    /**
+     * Check if widget is enabled
+     * @returns true if widget should render
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Template method - final, subclasses implement renderWithData()
+     *
+     * Handles null data checks and calls renderWithData() hook.
+     *
+     * @param context - Render context
+     * @returns Rendered string, or null if widget should not display
+     */
+    async render(context) {
+        if (!this.data || !this.enabled) {
+            return null;
+        }
+        return this.renderWithData(this.data, context);
+    }
+}
+//# sourceMappingURL=stdin-data-widget.js.map

package/dist/widgets/core/stdin-data-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin-data-widget.js","sourceRoot":"","sources":["../../../src/widgets/core/stdin-data-widget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAgB,eAAe;IACnC;;OAEG;IACO,IAAI,GAAqB,IAAI,CAAC;IAExC;;OAEG;IACO,OAAO,GAAG,IAAI,CAAC;IAYzB;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,OAAsB;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,KAAK,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAe;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC,EAAE,6CAA6C,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CAAC,OAAsB;QACjC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;CAqBF"}

package/dist/widgets/cost-widget.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cost Widget
+ *
+ * Displays total session cost
+ */
+import { StdinDataWidget } from './core/stdin-data-widget.js';
+import type { RenderContext, StdinData } from '../types.js';
+export declare class CostWidget extends StdinDataWidget {
+    readonly id = "cost";
+    readonly metadata: import("../core/types.js").IWidgetMetadata;
+    protected renderWithData(data: StdinData, context: RenderContext): string | null;
+}
+//# sourceMappingURL=cost-widget.d.ts.map

package/dist/widgets/cost-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-widget.d.ts","sourceRoot":"","sources":["../../src/widgets/cost-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,UAAW,SAAQ,eAAe;IAC7C,QAAQ,CAAC,EAAE,UAAU;IACrB,QAAQ,CAAC,QAAQ,6CAGf;IAEF,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;CAIjF"}

package/dist/widgets/cost-widget.js

@@ -0,0 +1,18 @@
+/**
+ * Cost Widget
+ *
+ * Displays total session cost
+ */
+import { StdinDataWidget } from './core/stdin-data-widget.js';
+import { createWidgetMetadata } from '../core/widget-types.js';
+import { formatCostUSD } from '../ui/utils/formatters.js';
+export class CostWidget extends StdinDataWidget {
+    id = 'cost';
+    metadata = createWidgetMetadata('Cost', 'Displays session cost in USD');
+    renderWithData(data, context) {
+        if (!data.cost || data.cost.total_cost_usd === undefined)
+            return null;
+        return formatCostUSD(data.cost.total_cost_usd);
+    }
+}
+//# sourceMappingURL=cost-widget.js.map

package/dist/widgets/cost-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-widget.js","sourceRoot":"","sources":["../../src/widgets/cost-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,MAAM,OAAO,UAAW,SAAQ,eAAe;IACpC,EAAE,GAAG,MAAM,CAAC;IACZ,QAAQ,GAAG,oBAAoB,CACtC,MAAM,EACN,8BAA8B,CAC/B,CAAC;IAEQ,cAAc,CAAC,IAAe,EAAE,OAAsB;QAC9D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACtE,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/widgets/duration-widget.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Duration Widget
+ *
+ * Displays elapsed session time
+ */
+import { StdinDataWidget } from './core/stdin-data-widget.js';
+import type { RenderContext, StdinData } from '../types.js';
+export declare class DurationWidget extends StdinDataWidget {
+    readonly id = "duration";
+    readonly metadata: import("../core/types.js").IWidgetMetadata;
+    protected renderWithData(data: StdinData, context: RenderContext): string | null;
+}
+//# sourceMappingURL=duration-widget.d.ts.map

package/dist/widgets/duration-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-widget.d.ts","sourceRoot":"","sources":["../../src/widgets/duration-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,qBAAa,cAAe,SAAQ,eAAe;IACjD,QAAQ,CAAC,EAAE,cAAc;IACzB,QAAQ,CAAC,QAAQ,6CAGf;IAEF,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI;CAIjF"}

package/dist/widgets/duration-widget.js

@@ -0,0 +1,18 @@
+/**
+ * Duration Widget
+ *
+ * Displays elapsed session time
+ */
+import { StdinDataWidget } from './core/stdin-data-widget.js';
+import { createWidgetMetadata } from '../core/widget-types.js';
+import { formatDuration } from '../ui/utils/formatters.js';
+export class DurationWidget extends StdinDataWidget {
+    id = 'duration';
+    metadata = createWidgetMetadata('Duration', 'Displays elapsed session time');
+    renderWithData(data, context) {
+        if (!data.cost || data.cost.total_duration_ms === undefined)
+            return null;
+        return formatDuration(data.cost.total_duration_ms);
+    }
+}
+//# sourceMappingURL=duration-widget.js.map

package/dist/widgets/duration-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration-widget.js","sourceRoot":"","sources":["../../src/widgets/duration-widget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,MAAM,OAAO,cAAe,SAAQ,eAAe;IACxC,EAAE,GAAG,UAAU,CAAC;IAChB,QAAQ,GAAG,oBAAoB,CACtC,UAAU,EACV,+BAA+B,CAChC,CAAC;IAEQ,cAAc,CAAC,IAAe,EAAE,OAAsB;QAC9D,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,iBAAiB,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzE,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACrD,CAAC;CACF"}

package/dist/widgets/git/git-changes-widget.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Git Changes Widget
+ *
+ * Displays git diff statistics (insertions/deletions)
+ *
+ * NOTE: This widget implements IWidget directly (not extending StdinDataWidget)
+ * because it requires async git operations with custom lifecycle management.
+ */
+import type { IWidget, WidgetContext, RenderContext, StdinData } from '../../core/types.js';
+import type { IGit } from '../../providers/git-provider.js';
+/**
+ * Widget displaying git diff statistics
+ *
+ * Uses Dependency Injection for IGit to enable:
+ * - Easy testing with MockGit
+ * - No tight coupling to git implementation
+ * - Clean separation of concerns
+ */
+export declare class GitChangesWidget implements IWidget {
+    readonly id = "git-changes";
+    readonly metadata: import("../../core/types.js").IWidgetMetadata;
+    private gitFactory;
+    private git;
+    private enabled;
+    private cwd;
+    /**
+     * @param gitFactory - Optional factory function for creating IGit instances
+     *                     If not provided, uses default createGit (production)
+     *                     Tests can inject MockGit factory here
+     */
+    constructor(gitFactory?: (cwd: string) => IGit);
+    initialize(context: WidgetContext): Promise<void>;
+    update(data: StdinData): Promise<void>;
+    render(context: RenderContext): Promise<string | null>;
+    isEnabled(): boolean;
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=git-changes-widget.d.ts.map

package/dist/widgets/git/git-changes-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-changes-widget.d.ts","sourceRoot":"","sources":["../../../src/widgets/git/git-changes-widget.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE5F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AAG5D;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,OAAO;IAC9C,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,QAAQ,gDAGf;IAEF,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,GAAG,CAAuB;IAElC;;;;OAIG;gBACS,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI;IAIxC,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA8C5D,SAAS,IAAI,OAAO;IAId,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/widgets/git/git-changes-widget.js

@@ -0,0 +1,91 @@
+/**
+ * Git Changes Widget
+ *
+ * Displays git diff statistics (insertions/deletions)
+ *
+ * NOTE: This widget implements IWidget directly (not extending StdinDataWidget)
+ * because it requires async git operations with custom lifecycle management.
+ */
+import { createWidgetMetadata } from '../../core/widget-types.js';
+import { createGit } from '../../providers/git-provider.js';
+/**
+ * Widget displaying git diff statistics
+ *
+ * Uses Dependency Injection for IGit to enable:
+ * - Easy testing with MockGit
+ * - No tight coupling to git implementation
+ * - Clean separation of concerns
+ */
+export class GitChangesWidget {
+    id = 'git-changes';
+    metadata = createWidgetMetadata('Git Changes', 'Displays git diff statistics');
+    gitFactory;
+    git = null;
+    enabled = true;
+    cwd = null;
+    /**
+     * @param gitFactory - Optional factory function for creating IGit instances
+     *                     If not provided, uses default createGit (production)
+     *                     Tests can inject MockGit factory here
+     */
+    constructor(gitFactory) {
+        this.gitFactory = gitFactory || createGit;
+    }
+    async initialize(context) {
+        this.enabled = context.config?.enabled !== false;
+    }
+    async update(data) {
+        // Re-initialize git if cwd changed
+        if (data.cwd !== this.cwd) {
+            this.cwd = data.cwd;
+            this.git = this.gitFactory(data.cwd);
+        }
+    }
+    async render(context) {
+        if (!this.enabled || !this.git || !this.cwd) {
+            return null;
+        }
+        let changes;
+        try {
+            const summary = await this.git.diffSummary(['--shortstat']);
+            let insertions = 0;
+            let deletions = 0;
+            if (summary.files && summary.files.length > 0) {
+                for (const file of summary.files) {
+                    if (typeof file.insertions === 'number') {
+                        insertions += file.insertions;
+                    }
+                    if (typeof file.deletions === 'number') {
+                        deletions += file.deletions;
+                    }
+                }
+            }
+            if (insertions === 0 && deletions === 0) {
+                return null;
+            }
+            changes = { insertions, deletions };
+        }
+        catch {
+            // Log specific error for debugging but return null (graceful degradation)
+            return null;
+        }
+        if (!changes)
+            return null;
+        if (changes.insertions === 0 && changes.deletions === 0) {
+            return null;
+        }
+        const parts = [];
+        if (changes.insertions > 0)
+            parts.push(`+${changes.insertions}`);
+        if (changes.deletions > 0)
+            parts.push(`-${changes.deletions}`);
+        return parts.join(',');
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    async cleanup() {
+        // No cleanup needed for native git implementation
+    }
+}
+//# sourceMappingURL=git-changes-widget.js.map

package/dist/widgets/git/git-changes-widget.js.map

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