@tecet/ollm 0.1.3

package/dist/ui/utils/errorHandling.js

@@ -0,0 +1,242 @@
+/**
+ * Error Handling Utilities for MCP Panel UI
+ *
+ * Provides user-friendly error messages, retry logic with exponential backoff,
+ * and error recovery suggestions for common failure scenarios.
+ */
+/**
+ * Common error types in MCP operations
+ */
+export var MCPErrorType;
+(function (MCPErrorType) {
+    MCPErrorType["CONNECTION_FAILED"] = "CONNECTION_FAILED";
+    MCPErrorType["CONFIG_CORRUPTED"] = "CONFIG_CORRUPTED";
+    MCPErrorType["CONFIG_INVALID"] = "CONFIG_INVALID";
+    MCPErrorType["SERVER_START_FAILED"] = "SERVER_START_FAILED";
+    MCPErrorType["SERVER_STOP_FAILED"] = "SERVER_STOP_FAILED";
+    MCPErrorType["OAUTH_FAILED"] = "OAUTH_FAILED";
+    MCPErrorType["MARKETPLACE_UNAVAILABLE"] = "MARKETPLACE_UNAVAILABLE";
+    MCPErrorType["PERMISSION_DENIED"] = "PERMISSION_DENIED";
+    MCPErrorType["TIMEOUT"] = "TIMEOUT";
+    MCPErrorType["UNKNOWN"] = "UNKNOWN";
+})(MCPErrorType || (MCPErrorType = {}));
+/**
+ * Default retry configuration
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxAttempts: 3,
+    initialDelay: 1000, // 1 second
+    maxDelay: 10000, // 10 seconds
+    backoffMultiplier: 2,
+};
+/**
+ * Parse error and provide user-friendly message with recovery suggestions
+ */
+export function parseError(error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const originalError = error instanceof Error ? error : undefined;
+    // Connection errors
+    if (errorMessage.includes('ECONNREFUSED') ||
+        errorMessage.includes('ENOTFOUND') ||
+        errorMessage.includes('connection refused')) {
+        return {
+            type: MCPErrorType.CONNECTION_FAILED,
+            message: 'Failed to connect to MCP server',
+            originalError,
+            suggestions: [
+                'Check if the server command is correct',
+                'Verify the server is installed and accessible',
+                'Check your network connection',
+                'Try restarting the server',
+            ],
+            canRetry: true,
+        };
+    }
+    // Configuration errors
+    if (errorMessage.includes('JSON') ||
+        errorMessage.includes('parse') ||
+        errorMessage.includes('syntax')) {
+        return {
+            type: MCPErrorType.CONFIG_CORRUPTED,
+            message: 'Configuration file is corrupted or invalid',
+            originalError,
+            suggestions: [
+                'A backup will be created automatically',
+                'The configuration will be restored from backup',
+                'You may need to reconfigure your servers',
+            ],
+            canRetry: false,
+        };
+    }
+    // Validation errors
+    if (errorMessage.includes('Invalid configuration') ||
+        errorMessage.includes('required') ||
+        errorMessage.includes('must be')) {
+        return {
+            type: MCPErrorType.CONFIG_INVALID,
+            message: 'Server configuration is invalid',
+            originalError,
+            suggestions: [
+                'Check that all required fields are filled',
+                'Verify command and arguments are correct',
+                'Ensure environment variables are properly formatted',
+            ],
+            canRetry: false,
+        };
+    }
+    // Server start errors
+    if (errorMessage.includes('Failed to start') ||
+        errorMessage.includes('spawn') ||
+        errorMessage.includes('ENOENT')) {
+        return {
+            type: MCPErrorType.SERVER_START_FAILED,
+            message: 'Failed to start MCP server',
+            originalError,
+            suggestions: [
+                'Verify the server command exists and is executable',
+                'Check that all dependencies are installed',
+                'Review server logs for more details',
+                'Try reinstalling the server',
+            ],
+            canRetry: true,
+        };
+    }
+    // OAuth errors
+    if (errorMessage.includes('OAuth') ||
+        errorMessage.includes('authorization') ||
+        errorMessage.includes('token')) {
+        return {
+            type: MCPErrorType.OAUTH_FAILED,
+            message: 'OAuth authentication failed',
+            originalError,
+            suggestions: [
+                'Check your OAuth credentials',
+                'Verify the authorization URL is correct',
+                'Try refreshing your token',
+                'Re-authorize the application',
+            ],
+            canRetry: true,
+        };
+    }
+    // Marketplace errors
+    if (errorMessage.includes('marketplace') ||
+        errorMessage.includes('fetch') ||
+        errorMessage.includes('network')) {
+        return {
+            type: MCPErrorType.MARKETPLACE_UNAVAILABLE,
+            message: 'Marketplace is temporarily unavailable',
+            originalError,
+            suggestions: [
+                'Using cached marketplace data',
+                'Check your internet connection',
+                'Try again later',
+            ],
+            canRetry: true,
+        };
+    }
+    // Permission errors
+    if (errorMessage.includes('EACCES') ||
+        errorMessage.includes('permission denied') ||
+        errorMessage.includes('EPERM')) {
+        return {
+            type: MCPErrorType.PERMISSION_DENIED,
+            message: 'Permission denied',
+            originalError,
+            suggestions: [
+                'Check file permissions',
+                'You may need administrator privileges',
+                'Verify you have write access to the configuration directory',
+            ],
+            canRetry: false,
+        };
+    }
+    // Timeout errors
+    if (errorMessage.includes('timeout') || errorMessage.includes('ETIMEDOUT')) {
+        return {
+            type: MCPErrorType.TIMEOUT,
+            message: 'Operation timed out',
+            originalError,
+            suggestions: [
+                'The server may be slow to respond',
+                'Try increasing the timeout value',
+                'Check your network connection',
+                'Try again',
+            ],
+            canRetry: true,
+        };
+    }
+    // Unknown errors
+    return {
+        type: MCPErrorType.UNKNOWN,
+        message: errorMessage || 'An unexpected error occurred',
+        originalError,
+        suggestions: [
+            'Try the operation again',
+            'Check the logs for more details',
+            'Report this issue if it persists',
+        ],
+        canRetry: true,
+    };
+}
+/**
+ * Retry an async operation with exponential backoff
+ */
+export async function retryWithBackoff(operation, config = {}) {
+    const finalConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
+    let lastError;
+    let delay = finalConfig.initialDelay;
+    for (let attempt = 1; attempt <= finalConfig.maxAttempts; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Don't retry on last attempt
+            if (attempt === finalConfig.maxAttempts) {
+                break;
+            }
+            // Parse error to check if it's retryable
+            const parsedError = parseError(error);
+            if (!parsedError.canRetry) {
+                throw error;
+            }
+            // Wait before retrying
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            // Increase delay for next attempt (exponential backoff)
+            delay = Math.min(delay * finalConfig.backoffMultiplier, finalConfig.maxDelay);
+        }
+    }
+    // All attempts failed
+    throw lastError || new Error('Operation failed after retries');
+}
+/**
+ * Format error message for display
+ */
+export function formatErrorMessage(error) {
+    let message = `❌ ${error.message}`;
+    if (error.suggestions.length > 0) {
+        message += '\n\nSuggestions:';
+        for (const suggestion of error.suggestions) {
+            message += `\n  • ${suggestion}`;
+        }
+    }
+    if (error.canRetry) {
+        message += '\n\nYou can try this operation again.';
+    }
+    return message;
+}
+/**
+ * Check if an error is retryable
+ */
+export function isRetryableError(error) {
+    const parsed = parseError(error);
+    return parsed.canRetry;
+}
+/**
+ * Get error type from error
+ */
+export function getErrorType(error) {
+    const parsed = parseError(error);
+    return parsed.type;
+}
+//# sourceMappingURL=errorHandling.js.map

package/dist/ui/utils/errorHandling.js.map

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

package/dist/ui/utils/errorLogger.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Error logging utilities for UI components
+ */
+/**
+ * Log levels
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * Log an error to debug output
+ */
+export declare function logError(context: string, error: unknown, details?: Record<string, unknown>): void;
+/**
+ * Log a warning to debug output
+ */
+export declare function logWarning(context: string, message: string, details?: Record<string, unknown>): void;
+/**
+ * Log an info message to debug output
+ */
+export declare function logInfo(context: string, message: string, details?: Record<string, unknown>): void;
+/**
+ * Log a debug message to debug output
+ */
+export declare function logDebug(context: string, message: string, details?: Record<string, unknown>): void;
+/**
+ * Format error for user display
+ */
+export declare function formatErrorForUser(error: unknown): string;
+/**
+ * Check if error is a network error
+ */
+export declare function isNetworkError(error: unknown): boolean;
+/**
+ * Check if error is a validation error
+ */
+export declare function isValidationError(error: unknown): boolean;
+//# sourceMappingURL=errorLogger.d.ts.map

package/dist/ui/utils/errorLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorLogger.d.ts","sourceRoot":"","sources":["../../../src/ui/utils/errorLogger.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAqBD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAgBjG;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWjG;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAatD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAYzD"}

package/dist/ui/utils/errorLogger.js

@@ -0,0 +1,126 @@
+import { createLogger } from '../../../../core/src/utils/logger.js';
+const logger = createLogger('errorLogger');
+/**
+ * Error logging utilities for UI components
+ */
+/**
+ * Log levels
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel["DEBUG"] = "debug";
+    LogLevel["INFO"] = "info";
+    LogLevel["WARN"] = "warn";
+    LogLevel["ERROR"] = "error";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Check if logging is enabled for a given level
+ */
+function isLogLevelEnabled(level) {
+    const configuredLevel = process.env.OLLM_LOG_LEVEL?.toLowerCase() || 'error';
+    const levels = [LogLevel.ERROR, LogLevel.WARN, LogLevel.INFO, LogLevel.DEBUG];
+    const configuredIndex = levels.indexOf(configuredLevel);
+    const requestedIndex = levels.indexOf(level);
+    // If configured level is not found, default to ERROR only
+    if (configuredIndex === -1) {
+        return level === LogLevel.ERROR;
+    }
+    // Enable if requested level is at or above configured level
+    return requestedIndex <= configuredIndex;
+}
+/**
+ * Log an error to debug output
+ */
+export function logError(context, error, details) {
+    if (!isLogLevelEnabled(LogLevel.ERROR)) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    logger.error(`[${timestamp}] [${context}] Error:`, error);
+    if (details) {
+        logger.error(`[${timestamp}] [${context}] Details:`, details);
+    }
+    // Log stack trace if available
+    if (error instanceof Error && error.stack) {
+        logger.error(`[${timestamp}] [${context}] Stack:`, error.stack);
+    }
+}
+/**
+ * Log a warning to debug output
+ */
+export function logWarning(context, message, details) {
+    if (!isLogLevelEnabled(LogLevel.WARN)) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    logger.warn(`[${timestamp}] [${context}] Warning: ${message}`);
+    if (details) {
+        logger.warn(`[${timestamp}] [${context}] Details:`, details);
+    }
+}
+/**
+ * Log an info message to debug output
+ */
+export function logInfo(context, message, details) {
+    if (!isLogLevelEnabled(LogLevel.INFO)) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    logger.info(`[${timestamp}] [${context}] ${message}`);
+    if (details) {
+        logger.info(`[${timestamp}] [${context}] Details:`, details);
+    }
+}
+/**
+ * Log a debug message to debug output
+ */
+export function logDebug(context, message, details) {
+    if (!isLogLevelEnabled(LogLevel.DEBUG)) {
+        return;
+    }
+    const timestamp = new Date().toISOString();
+    logger.info(`[${timestamp}] [${context}] [DEBUG] ${message}`);
+    if (details) {
+        logger.info(`[${timestamp}] [${context}] [DEBUG] Details:`, details);
+    }
+}
+/**
+ * Format error for user display
+ */
+export function formatErrorForUser(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    return 'An unknown error occurred';
+}
+/**
+ * Check if error is a network error
+ */
+export function isNetworkError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return (message.includes('network') ||
+        message.includes('econnrefused') ||
+        message.includes('enotfound') ||
+        message.includes('timeout') ||
+        message.includes('fetch failed'));
+}
+/**
+ * Check if error is a validation error
+ */
+export function isValidationError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return (message.includes('validation') ||
+        message.includes('invalid') ||
+        message.includes('required') ||
+        message.includes('must be'));
+}
+//# sourceMappingURL=errorLogger.js.map

package/dist/ui/utils/errorLogger.js.map

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

package/dist/ui/utils/keyUtils.d.ts

@@ -0,0 +1,16 @@
+import { Key } from 'ink';
+/**
+ * Normalizes a keybind string for comparison.
+ * Removes spaces and converts to lowercase.
+ */
+export declare function normalizeKey(key: string): string;
+/**
+ * Checks if an Ink input event matches a configured keybind string.
+ * Supports modifiers like "ctrl+c", "shift+enter", "meta+s".
+ *
+ * @param input The raw input string from Ink
+ * @param key The Key object from Ink containing modifiers and special keys
+ * @param configKey The configured keybind string to match against (e.g. "ctrl+s")
+ */
+export declare function isKey(input: string, key: Key, configKey: string | undefined): boolean;
+//# sourceMappingURL=keyUtils.d.ts.map

package/dist/ui/utils/keyUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyUtils.d.ts","sourceRoot":"","sources":["../../../src/ui/utils/keyUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CA0CrF"}

package/dist/ui/utils/keyUtils.js

@@ -0,0 +1,70 @@
+/**
+ * Normalizes a keybind string for comparison.
+ * Removes spaces and converts to lowercase.
+ */
+export function normalizeKey(key) {
+    return key.toLowerCase().replace(/\s+/g, '');
+}
+/**
+ * Checks if an Ink input event matches a configured keybind string.
+ * Supports modifiers like "ctrl+c", "shift+enter", "meta+s".
+ *
+ * @param input The raw input string from Ink
+ * @param key The Key object from Ink containing modifiers and special keys
+ * @param configKey The configured keybind string to match against (e.g. "ctrl+s")
+ */
+export function isKey(input, key, configKey) {
+    if (!configKey)
+        return false;
+    const parts = [];
+    // Add modifiers in a consistent order
+    if (key.ctrl)
+        parts.push('ctrl');
+    if (key.meta)
+        parts.push('meta'); // 'meta' corresponds to Alt/Option usually in terminals, or Command on Mac
+    if (key.shift)
+        parts.push('shift');
+    // Add the main key
+    if (key.return) {
+        parts.push('return'); // We use 'return' in config for Enter
+    }
+    else if (key.escape) {
+        parts.push('escape');
+    }
+    else if (key.tab) {
+        parts.push('tab');
+    }
+    else if (key.backspace) {
+        parts.push('backspace');
+    }
+    else if (key.delete) {
+        parts.push('delete');
+    }
+    else if (key.upArrow) {
+        parts.push('up');
+    }
+    else if (key.downArrow) {
+        parts.push('down');
+    }
+    else if (key.leftArrow) {
+        parts.push('left');
+    }
+    else if (key.rightArrow) {
+        parts.push('right');
+    }
+    else if (key.pageUp) {
+        parts.push('pageup');
+    }
+    else if (key.pageDown) {
+        parts.push('pagedown');
+    }
+    else {
+        // Regular character
+        if (input) {
+            parts.push(input.toLowerCase());
+        }
+    }
+    const inputKeyString = parts.join('+');
+    return normalizeKey(inputKeyString) === normalizeKey(configKey);
+}
+//# sourceMappingURL=keyUtils.js.map

package/dist/ui/utils/keyUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyUtils.js","sourceRoot":"","sources":["../../../src/ui/utils/keyUtils.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAQ,EAAE,SAA6B;IAC1E,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAE7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,sCAAsC;IACtC,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,2EAA2E;IAC7G,IAAI,GAAG,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAEnC,mBAAmB;IACnB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,sCAAsC;IAC9D,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;SAAM,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;SAAM,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,oBAAoB;QACpB,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,YAAY,CAAC,cAAc,CAAC,KAAK,YAAY,CAAC,SAAS,CAAC,CAAC;AAClE,CAAC"}

package/dist/ui/utils/performanceProfiler.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Performance Profiler Utility
+ *
+ * Provides utilities for profiling React component render performance.
+ * Helps identify unnecessary re-renders and expensive computations.
+ *
+ * Usage:
+ * ```typescript
+ * import { profileRender, measureTime } from './utils/performanceProfiler';
+ *
+ * // Profile component renders
+ * function MyComponent(props) {
+ *   profileRender('MyComponent', props);
+ *   // ... component logic
+ * }
+ *
+ * // Measure expensive operations
+ * const result = measureTime('expensiveOperation', () => {
+ *   return doExpensiveWork();
+ * });
+ * ```
+ */
+interface RenderProfile {
+    componentName: string;
+    renderCount: number;
+    lastRenderTime: number;
+    totalRenderTime: number;
+    averageRenderTime: number;
+    propsChanges: number;
+}
+/**
+ * Profile a component render
+ *
+ * Tracks render count, timing, and props changes for a component.
+ * Only active when OLLM_PROFILE_RENDERS=true environment variable is set.
+ *
+ * @param componentName - Name of the component being profiled
+ * @param props - Component props (used to detect changes)
+ */
+export declare function profileRender(componentName: string, props?: Record<string, unknown>): void;
+/**
+ * Measure execution time of a function
+ *
+ * @param label - Label for the measurement
+ * @param fn - Function to measure
+ * @returns Result of the function
+ */
+export declare function measureTime<T>(label: string, fn: () => T): T;
+/**
+ * Get render profile for a component
+ *
+ * @param componentName - Name of the component
+ * @returns Render profile or undefined if not found
+ */
+export declare function getRenderProfile(componentName: string): RenderProfile | undefined;
+/**
+ * Get all render profiles
+ *
+ * @returns Map of all render profiles
+ */
+export declare function getAllRenderProfiles(): Map<string, RenderProfile>;
+/**
+ * Print render statistics to console
+ *
+ * Useful for debugging performance issues.
+ * Shows components with high render counts or slow render times.
+ */
+export declare function printRenderStats(): void;
+/**
+ * Reset all render profiles
+ *
+ * Useful for starting fresh measurements.
+ */
+export declare function resetRenderProfiles(): void;
+/**
+ * Hook to profile a component's renders
+ *
+ * @param componentName - Name of the component
+ * @param props - Component props
+ */
+export declare function useRenderProfile(componentName: string, props?: Record<string, unknown>): void;
+export {};
+//# sourceMappingURL=performanceProfiler.d.ts.map

package/dist/ui/utils/performanceProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performanceProfiler.d.ts","sourceRoot":"","sources":["../../../src/ui/utils/performanceProfiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,UAAU,aAAa;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;CACtB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CA2C1F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAc5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAEjE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAiCvC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAE7F"}