@navios/commander-tui 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-01-11
+
+### Added
+
+- **Isomorphic Logger** - New `IsomorphicLogger` token and factory for unified logging across TUI and server environments
+  - `IsomorphicLoggerInterface` type that works with both `ScreenLogger` (TUI) and standard `Logger` (server)
+  - `IsomorphicLoggerFactory` automatically selects the appropriate logger based on TUI availability
+- **Interfaces Export** - New `interfaces` module export for public type definitions
+
+### Changed
+
+- **Mouse Support Default** - `useMouse` option now defaults to `true` (previously `false`)
+
+### Fixed
+
+- **Stack Trace Capture** - Improved `captureTrace()` to dynamically find the correct stack frame offset, ensuring accurate trace output regardless of call depth
+
 ## [1.1.0] - 2026-01-10
 
 ### Added

package/README.md

@@ -99,6 +99,33 @@ logger.fatal('Fatal error')
 logger.log('Step 1').log('Step 2').success('Done!')
 ```
 
+### IsomorphicLogger
+
+A unified logger that automatically switches between `ScreenLogger` (TUI mode) and standard `Logger` (server mode) based on the environment. This is useful when writing code that needs to work both in TUI and non-TUI contexts.
+
+```typescript
+import { IsomorphicLogger } from '@navios/commander-tui'
+import { inject, Injectable } from '@navios/core'
+
+@Injectable()
+class MyService {
+  // Will use ScreenLogger when TUI is bound, otherwise standard Logger
+  private logger = inject(IsomorphicLogger, { context: 'MyService' })
+
+  doWork() {
+    this.logger.log('Processing...')
+    this.logger.debug('Debug info')
+    this.logger.error('Something went wrong')
+  }
+}
+```
+
+The `IsomorphicLoggerFactory` checks if the `ScreenManager` has an active TUI binding:
+- **TUI bound**: Returns a `ScreenLogger` instance with full TUI features
+- **TUI not bound**: Returns a standard `Logger` instance for console output
+
+This makes it easy to write services that can be used in both CLI tools with TUI and background server processes.
+
 #### Loading Indicators
 
 ```typescript