@navios/commander-tui 1.0.0

package/src/__tests__/setup.ts

@@ -0,0 +1,43 @@
+/**
+ * Vitest setup file for commander-tui tests.
+ *
+ * Mocks @opentui/core and @opentui/react to avoid:
+ * - .scm file loading (tree-sitter query files)
+ * - WebAssembly loading (tree-sitter parsers)
+ */
+import { vi } from 'vitest'
+
+// Mock @opentui/core - provides TextAttributes enum and other core types
+vi.mock('@opentui/core', () => ({
+  TextAttributes: {
+    BOLD: 1,
+    DIM: 2,
+    ITALIC: 4,
+    UNDERLINE: 8,
+    BLINK: 16,
+    REVERSE: 32,
+    HIDDEN: 64,
+    STRIKETHROUGH: 128,
+  },
+  RGBA: class RGBA {
+    r: number
+    g: number
+    b: number
+    a: number
+    constructor(r = 0, g = 0, b = 0, a = 1) {
+      this.r = r
+      this.g = g
+      this.b = b
+      this.a = a
+    }
+    static fromHex(_hex: string) {
+      return new RGBA()
+    }
+  },
+}))
+
+// Mock @opentui/react - provides React component rendering
+vi.mock('@opentui/react', () => ({
+  render: vi.fn(),
+  unmount: vi.fn(),
+}))

package/src/__tests__/utils/factories.ts

@@ -0,0 +1,354 @@
+import { vi } from 'vitest'
+
+import { darkTheme } from '../../themes/index.ts'
+
+import type { LogLevel } from '@navios/core'
+import type {
+  ChoicePromptData,
+  ConfirmPromptData,
+  DiffMessageData,
+  FileErrorMessageData,
+  FileMessageData,
+  FilterState,
+  GroupMessageData,
+  InputPromptData,
+  KeyboardContext,
+  LoadingMessageData,
+  LogMessageData,
+  MultiChoicePromptData,
+  ProgressMessageData,
+  TableMessageData,
+  Theme,
+} from '../../types/index.ts'
+
+let idCounter = 0
+
+function generateId(prefix = 'test'): string {
+  return `${prefix}-${++idCounter}`
+}
+
+/**
+ * Fixed timestamp for snapshot tests.
+ * Using a stable date ensures snapshots don't change between runs.
+ */
+export const STABLE_TIMESTAMP = new Date('2025-01-01T00:00:00.000Z')
+
+// ============================================
+// Message Factories
+// ============================================
+
+export function createLogMessage(overrides: Partial<LogMessageData> = {}): LogMessageData {
+  return {
+    id: generateId('log'),
+    type: 'log',
+    timestamp: STABLE_TIMESTAMP,
+    level: 'log',
+    content: 'Test log message',
+    ...overrides,
+  }
+}
+
+export function createFileMessage(overrides: Partial<FileMessageData> = {}): FileMessageData {
+  return {
+    id: generateId('file'),
+    type: 'file',
+    timestamp: STABLE_TIMESTAMP,
+    filePath: '/test/file.ts',
+    content: 'const x = 1;',
+    ...overrides,
+  }
+}
+
+export function createDiffMessage(overrides: Partial<DiffMessageData> = {}): DiffMessageData {
+  return {
+    id: generateId('diff'),
+    type: 'diff',
+    timestamp: STABLE_TIMESTAMP,
+    filePath: '/test/file.ts',
+    diff: '- old\n+ new',
+    ...overrides,
+  }
+}
+
+export function createFileErrorMessage(
+  overrides: Partial<FileErrorMessageData> = {},
+): FileErrorMessageData {
+  return {
+    id: generateId('fileError'),
+    type: 'fileError',
+    timestamp: STABLE_TIMESTAMP,
+    filePath: '/test/file.ts',
+    content: 'const x = 1;',
+    errorLines: [1],
+    startLine: 1,
+    ...overrides,
+  }
+}
+
+export function createLoadingMessage(
+  overrides: Partial<LoadingMessageData> = {},
+): LoadingMessageData {
+  return {
+    id: generateId('loading'),
+    type: 'loading',
+    timestamp: STABLE_TIMESTAMP,
+    content: 'Loading...',
+    status: 'loading',
+    ...overrides,
+  }
+}
+
+export function createProgressMessage(
+  overrides: Partial<ProgressMessageData> = {},
+): ProgressMessageData {
+  return {
+    id: generateId('progress'),
+    type: 'progress',
+    timestamp: STABLE_TIMESTAMP,
+    label: 'Processing',
+    current: 0,
+    total: 100,
+    status: 'active',
+    ...overrides,
+  }
+}
+
+export function createGroupMessage(overrides: Partial<GroupMessageData> = {}): GroupMessageData {
+  return {
+    id: generateId('group'),
+    type: 'group',
+    timestamp: STABLE_TIMESTAMP,
+    label: 'Test Group',
+    collapsed: false,
+    isEnd: false,
+    ...overrides,
+  }
+}
+
+export function createTableMessage(overrides: Partial<TableMessageData> = {}): TableMessageData {
+  return {
+    id: generateId('table'),
+    type: 'table',
+    timestamp: STABLE_TIMESTAMP,
+    headers: ['Name', 'Value'],
+    rows: [
+      ['foo', '1'],
+      ['bar', '2'],
+    ],
+    ...overrides,
+  }
+}
+
+// ============================================
+// Prompt Factories
+// ============================================
+
+export function createChoicePrompt(overrides: Partial<ChoicePromptData> = {}): ChoicePromptData {
+  return {
+    id: generateId('prompt'),
+    type: 'choice',
+    timestamp: STABLE_TIMESTAMP,
+    question: 'Select an option',
+    choices: [
+      { label: 'Option A', value: 'a' },
+      { label: 'Option B', value: 'b' },
+      { label: 'Option C', value: 'c' },
+    ],
+    defaultChoice: 'a',
+    selectedIndex: 0,
+    inputMode: false,
+    inputValue: '',
+    resolved: false,
+    ...overrides,
+  }
+}
+
+export function createConfirmPrompt(overrides: Partial<ConfirmPromptData> = {}): ConfirmPromptData {
+  return {
+    id: generateId('prompt'),
+    type: 'confirm',
+    timestamp: STABLE_TIMESTAMP,
+    question: 'Are you sure?',
+    confirmText: 'Yes',
+    cancelText: 'No',
+    defaultValue: true,
+    selectedValue: true,
+    resolved: false,
+    ...overrides,
+  }
+}
+
+export function createInputPrompt(overrides: Partial<InputPromptData> = {}): InputPromptData {
+  return {
+    id: generateId('prompt'),
+    type: 'input',
+    timestamp: STABLE_TIMESTAMP,
+    question: 'Enter a value',
+    placeholder: 'Type here...',
+    defaultValue: '',
+    value: '',
+    resolved: false,
+    ...overrides,
+  }
+}
+
+export function createMultiChoicePrompt(
+  overrides: Partial<MultiChoicePromptData> = {},
+): MultiChoicePromptData {
+  return {
+    id: generateId('prompt'),
+    type: 'multiChoice',
+    timestamp: STABLE_TIMESTAMP,
+    question: 'Select options',
+    choices: [
+      { label: 'Option A', value: 'a' },
+      { label: 'Option B', value: 'b' },
+      { label: 'Option C', value: 'c' },
+    ],
+    selectedIndices: new Set(),
+    focusedIndex: 0,
+    minSelect: 0,
+    maxSelect: 3,
+    resolved: false,
+    ...overrides,
+  }
+}
+
+// ============================================
+// Filter & Keyboard Factories
+// ============================================
+
+const ALL_LOG_LEVELS: LogLevel[] = ['verbose', 'debug', 'log', 'warn', 'error', 'fatal']
+
+export function createFilterState(overrides: Partial<FilterState> = {}): FilterState {
+  return {
+    enabledLevels: new Set(ALL_LOG_LEVELS),
+    searchQuery: '',
+    isVisible: false,
+    focusedField: 'search',
+    ...overrides,
+  }
+}
+
+export function createKeyboardContext(overrides: Partial<KeyboardContext> = {}): KeyboardContext {
+  return {
+    hasPrompt: false,
+    inInputMode: false,
+    focusArea: 'content',
+    isFilterActive: false,
+    isHelpVisible: false,
+    hasSidebar: true,
+    ...overrides,
+  }
+}
+
+// ============================================
+// Theme Factory
+// ============================================
+
+export function createTheme(): Theme {
+  return { ...darkTheme }
+}
+
+// ============================================
+// Mock Screen Instance
+// ============================================
+
+export interface MockScreenInstance {
+  getId: ReturnType<typeof vi.fn>
+  getName: ReturnType<typeof vi.fn>
+  getIcon: ReturnType<typeof vi.fn>
+  getBadgeCount: ReturnType<typeof vi.fn>
+  setBadgeCount: ReturnType<typeof vi.fn>
+  isHidden: ReturnType<typeof vi.fn>
+  setHidden: ReturnType<typeof vi.fn>
+  show: ReturnType<typeof vi.fn>
+  hide: ReturnType<typeof vi.fn>
+  getStatus: ReturnType<typeof vi.fn>
+  setStatus: ReturnType<typeof vi.fn>
+  isComplete: ReturnType<typeof vi.fn>
+  hasPrintedToConsole: ReturnType<typeof vi.fn>
+  getMessages: ReturnType<typeof vi.fn>
+  addMessage: ReturnType<typeof vi.fn>
+  updateMessage: ReturnType<typeof vi.fn>
+  updateProgressMessage: ReturnType<typeof vi.fn>
+  clear: ReturnType<typeof vi.fn>
+  _addPrompt: ReturnType<typeof vi.fn>
+  getActivePrompt: ReturnType<typeof vi.fn>
+  hasActivePrompt: ReturnType<typeof vi.fn>
+  updatePromptSelection: ReturnType<typeof vi.fn>
+  promptNavigateUp: ReturnType<typeof vi.fn>
+  promptNavigateDown: ReturnType<typeof vi.fn>
+  promptNavigateLeft: ReturnType<typeof vi.fn>
+  promptNavigateRight: ReturnType<typeof vi.fn>
+  promptToggleSelection: ReturnType<typeof vi.fn>
+  promptEnterInputMode: ReturnType<typeof vi.fn>
+  promptExitInputMode: ReturnType<typeof vi.fn>
+  isPromptInInputMode: ReturnType<typeof vi.fn>
+  promptUpdateInput: ReturnType<typeof vi.fn>
+  promptAppendInput: ReturnType<typeof vi.fn>
+  promptDeleteLastChar: ReturnType<typeof vi.fn>
+  canSubmitPrompt: ReturnType<typeof vi.fn>
+  promptSubmit: ReturnType<typeof vi.fn>
+  onChange: ReturnType<typeof vi.fn>
+  _setManager: ReturnType<typeof vi.fn>
+  _setPrintFn: ReturnType<typeof vi.fn>
+  _flushToConsole: ReturnType<typeof vi.fn>
+}
+
+export function createMockScreenInstance(
+  overrides: Partial<MockScreenInstance> = {},
+): MockScreenInstance {
+  const mockScreen: MockScreenInstance = {
+    getId: vi.fn(() => 'test-screen-id'),
+    getName: vi.fn(() => 'Test Screen'),
+    getIcon: vi.fn(() => undefined),
+    getBadgeCount: vi.fn(() => 0),
+    setBadgeCount: vi.fn().mockReturnThis(),
+    isHidden: vi.fn(() => false),
+    setHidden: vi.fn().mockReturnThis(),
+    show: vi.fn().mockReturnThis(),
+    hide: vi.fn().mockReturnThis(),
+    getStatus: vi.fn(() => 'pending'),
+    setStatus: vi.fn().mockReturnThis(),
+    isComplete: vi.fn(() => false),
+    hasPrintedToConsole: vi.fn(() => false),
+    getMessages: vi.fn(() => []),
+    addMessage: vi.fn(),
+    updateMessage: vi.fn(),
+    updateProgressMessage: vi.fn(),
+    clear: vi.fn().mockReturnThis(),
+    _addPrompt: vi.fn(() => Promise.resolve('')),
+    getActivePrompt: vi.fn(() => null),
+    hasActivePrompt: vi.fn(() => false),
+    updatePromptSelection: vi.fn(),
+    promptNavigateUp: vi.fn(),
+    promptNavigateDown: vi.fn(),
+    promptNavigateLeft: vi.fn(),
+    promptNavigateRight: vi.fn(),
+    promptToggleSelection: vi.fn(),
+    promptEnterInputMode: vi.fn(() => false),
+    promptExitInputMode: vi.fn(),
+    isPromptInInputMode: vi.fn(() => false),
+    promptUpdateInput: vi.fn(),
+    promptAppendInput: vi.fn(),
+    promptDeleteLastChar: vi.fn(),
+    canSubmitPrompt: vi.fn(() => true),
+    promptSubmit: vi.fn(),
+    onChange: vi.fn(() => () => {}),
+    _setManager: vi.fn(),
+    _setPrintFn: vi.fn(),
+    _flushToConsole: vi.fn(),
+    ...overrides,
+  }
+
+  return mockScreen
+}
+
+// ============================================
+// Reset ID Counter (for test isolation)
+// ============================================
+
+export function resetIdCounter(): void {
+  idCounter = 0
+}

package/src/__tests__/utils/filetype.spec.ts

@@ -0,0 +1,195 @@
+import { describe, expect, it } from 'vitest'
+
+import { COMMON_FILETYPES, getFileName, resolveFiletype } from '../../utils/filetype.ts'
+
+describe('resolveFiletype', () => {
+  describe('common extensions', () => {
+    it('should resolve TypeScript files', () => {
+      expect(resolveFiletype('file.ts')).toBe('typescript')
+      expect(resolveFiletype('file.tsx')).toBe('tsx')
+    })
+
+    it('should resolve JavaScript files', () => {
+      expect(resolveFiletype('file.js')).toBe('javascript')
+      expect(resolveFiletype('file.jsx')).toBe('javascript')
+    })
+
+    it('should resolve Python files', () => {
+      expect(resolveFiletype('file.py')).toBe('python')
+    })
+
+    it('should resolve Rust files', () => {
+      expect(resolveFiletype('file.rs')).toBe('rust')
+    })
+
+    it('should resolve Go files', () => {
+      expect(resolveFiletype('file.go')).toBe('go')
+    })
+
+    it('should resolve JSON files', () => {
+      expect(resolveFiletype('file.json')).toBe('json')
+    })
+
+    it('should resolve Markdown files', () => {
+      expect(resolveFiletype('file.md')).toBe('markdown')
+    })
+
+    it('should resolve YAML files (both extensions)', () => {
+      expect(resolveFiletype('file.yaml')).toBe('yaml')
+      expect(resolveFiletype('file.yml')).toBe('yaml')
+    })
+
+    it('should resolve shell scripts', () => {
+      expect(resolveFiletype('file.sh')).toBe('bash')
+      expect(resolveFiletype('file.bash')).toBe('bash')
+      expect(resolveFiletype('file.zsh')).toBe('bash')
+    })
+
+    it('should resolve C/C++ files', () => {
+      expect(resolveFiletype('file.c')).toBe('c')
+      expect(resolveFiletype('file.h')).toBe('c')
+      expect(resolveFiletype('file.cpp')).toBe('cpp')
+      expect(resolveFiletype('file.hpp')).toBe('cpp')
+    })
+
+    it('should resolve web files', () => {
+      expect(resolveFiletype('file.html')).toBe('html')
+      expect(resolveFiletype('file.css')).toBe('css')
+      expect(resolveFiletype('file.xml')).toBe('xml')
+    })
+
+    it('should resolve other common languages', () => {
+      expect(resolveFiletype('file.java')).toBe('java')
+      expect(resolveFiletype('file.rb')).toBe('ruby')
+      expect(resolveFiletype('file.php')).toBe('php')
+      expect(resolveFiletype('file.swift')).toBe('swift')
+      expect(resolveFiletype('file.kt')).toBe('kotlin')
+      expect(resolveFiletype('file.scala')).toBe('scala')
+      expect(resolveFiletype('file.hs')).toBe('haskell')
+      expect(resolveFiletype('file.sql')).toBe('sql')
+      expect(resolveFiletype('file.toml')).toBe('toml')
+    })
+
+    it('should resolve frontend framework files', () => {
+      expect(resolveFiletype('file.vue')).toBe('vue')
+      expect(resolveFiletype('file.svelte')).toBe('svelte')
+      expect(resolveFiletype('file.elm')).toBe('elm')
+    })
+  })
+
+  describe('edge cases', () => {
+    it('should return undefined for unknown extensions', () => {
+      expect(resolveFiletype('file.xyz')).toBeUndefined()
+      expect(resolveFiletype('file.unknown')).toBeUndefined()
+    })
+
+    it('should return undefined for files without extension', () => {
+      expect(resolveFiletype('Makefile')).toBeUndefined()
+      expect(resolveFiletype('Dockerfile')).toBeUndefined()
+      expect(resolveFiletype('README')).toBeUndefined()
+    })
+
+    it('should handle lowercase extensions (case-insensitive)', () => {
+      // The function extracts and lowercases the extension
+      expect(resolveFiletype('file.TS')).toBe('typescript')
+      expect(resolveFiletype('file.JS')).toBe('javascript')
+      expect(resolveFiletype('file.PY')).toBe('python')
+    })
+
+    it('should handle full paths, not just filenames', () => {
+      expect(resolveFiletype('/home/user/project/src/index.ts')).toBe('typescript')
+      expect(resolveFiletype('C:\\Users\\project\\src\\main.py')).toBe('python')
+      expect(resolveFiletype('./relative/path/file.json')).toBe('json')
+    })
+
+    it('should handle files with multiple dots', () => {
+      expect(resolveFiletype('file.test.ts')).toBe('typescript')
+      expect(resolveFiletype('file.spec.tsx')).toBe('tsx')
+      expect(resolveFiletype('app.config.json')).toBe('json')
+    })
+
+    it('should handle hidden files with extensions', () => {
+      expect(resolveFiletype('.eslintrc.json')).toBe('json')
+      expect(resolveFiletype('.gitignore.bak')).toBeUndefined()
+    })
+  })
+
+  describe('COMMON_FILETYPES mapping', () => {
+    it('should have all expected extensions mapped', () => {
+      const expectedMappings: Record<string, string> = {
+        ts: 'typescript',
+        tsx: 'tsx',
+        js: 'javascript',
+        jsx: 'javascript',
+        json: 'json',
+        md: 'markdown',
+        py: 'python',
+        rs: 'rust',
+        go: 'go',
+      }
+
+      for (const [ext, type] of Object.entries(expectedMappings)) {
+        expect(COMMON_FILETYPES[ext]).toBe(type)
+      }
+    })
+  })
+})
+
+describe('getFileName', () => {
+  describe('Unix paths', () => {
+    it('should extract filename from Unix absolute path', () => {
+      expect(getFileName('/home/user/project/file.ts')).toBe('file.ts')
+    })
+
+    it('should extract filename from Unix relative path', () => {
+      expect(getFileName('./src/utils/helper.ts')).toBe('helper.ts')
+      expect(getFileName('../config/settings.json')).toBe('settings.json')
+    })
+
+    it('should handle deep paths', () => {
+      expect(getFileName('/a/b/c/d/e/f/file.txt')).toBe('file.txt')
+    })
+  })
+
+  describe('Windows paths', () => {
+    it('should extract filename from Windows absolute path', () => {
+      expect(getFileName('C:\\Users\\project\\file.ts')).toBe('file.ts')
+    })
+
+    it('should extract filename from Windows relative path', () => {
+      expect(getFileName('.\\src\\utils\\helper.ts')).toBe('helper.ts')
+    })
+
+    it('should handle mixed separators', () => {
+      // This could happen in some edge cases
+      expect(getFileName('/path/to\\file.ts')).toBe('file.ts')
+    })
+  })
+
+  describe('edge cases', () => {
+    it('should return original string if no slashes', () => {
+      expect(getFileName('file.ts')).toBe('file.ts')
+      expect(getFileName('README.md')).toBe('README.md')
+    })
+
+    it('should handle trailing slashes (returns empty string)', () => {
+      // lastIndexOf finds the trailing slash, slice returns empty
+      expect(getFileName('/path/to/directory/')).toBe('')
+      expect(getFileName('C:\\Users\\folder\\')).toBe('')
+    })
+
+    it('should handle root paths', () => {
+      expect(getFileName('/file.ts')).toBe('file.ts')
+    })
+
+    it('should handle files without extensions', () => {
+      expect(getFileName('/path/to/Makefile')).toBe('Makefile')
+      expect(getFileName('/path/to/Dockerfile')).toBe('Dockerfile')
+    })
+
+    it('should handle hidden files', () => {
+      expect(getFileName('/path/to/.gitignore')).toBe('.gitignore')
+      expect(getFileName('/path/to/.env')).toBe('.env')
+    })
+  })
+})