import {
ThemeColors,
ThemeSymbols,
BorderStyle,
NavigationState,
FocusedPanel,
StatusItem,
TerminalSize
} from '../models/types';
export interface IThemeService {
getColors(): ThemeColors;
getSymbols(): ThemeSymbols;
getBorderStyle(): BorderStyle;
}
export interface INavigationService {
getState(): NavigationState;
switchFocus(): void;
moveSelection(panel: FocusedPanel, direction: 'up' | 'down'): void;
getSelectedIndex(panel: FocusedPanel): number;
}
export interface IDataService {
getConfigItems(): string[];
getStatusItems(): StatusItem[];
}
export interface ITerminalService {
getSize(): TerminalSize;
isNarrow(): boolean;
}
export interface IContentService {
measureText(text: string): number;
truncateText(text: string, maxWidth: number, ellipsis?: string): string;
wrapText(text: string, maxWidth: number): string[];
}
export interface IDebugService {
isEnabled(): boolean;
log(component: string, message: string): void;
logLayout(component: string, constraints: { width: number; height: number }): void;
renderLayoutBoundaries(width: number, height: number): string;
}
// Configuration-related services
import type { ConfigurationNode, IValidationRule } from '../models/configuration';
import type { IValidationResult } from '../models/validation';
export interface IConfigurationService {
// Initialize with nodes
initialize(nodes: ConfigurationNode[]): void;
// Node management
getNodes(): ConfigurationNode[];
getNode(id: string): ConfigurationNode | undefined;
updateNodeValue(id: string, value: any): void;
// Validation
validateNode(id: string, value?: any): IValidationResult;
validateAll(): IValidationResult[];
// Serialization
getConfiguration(): Record<string, any>;
loadConfiguration(config: Record<string, any>): void;
}
export interface IFormNavigationService {
// Initialize with node IDs
setNodeIds(nodeIds: string[]): void;
// Node navigation
getCurrentNodeId(): string | null;
expandNode(nodeId: string): void;
collapseNode(): void;
isNodeExpanded(nodeId: string): boolean;
// Within-node navigation
getSelectedOptionIndex(): number;
selectOption(index: number): void;
// Form-level navigation
moveToNextNode(): void;
moveToPreviousNode(): void;
// Helper methods
getCurrentNodeIndex(): number;
setCurrentNodeIndex(index: number): void;
isAnyNodeExpanded(): boolean;
reset(): void;
}
export interface IInputService {
// Text input management
getCursorPosition(): number;
setCursorPosition(position: number): void;
insertText(text: string): void;
deleteText(count: number, direction: 'left' | 'right'): void;
// Filter input
getFilterText(): string;
setFilterText(text: string): void;
clearFilter(): void;
// Helper methods
getCurrentText(): string;
setCurrentText(text: string): void;
moveCursorLeft(): void;
moveCursorRight(): void;
moveCursorToStart(): void;
moveCursorToEnd(): void;
}
export interface IValidationService {
registerRule<T>(rule: IValidationRule<T>): void;
validate<T>(value: T, rules: IValidationRule<T>[]): IValidationResult;
}
export interface IStatusBarService {
// Update status bar based on current context
setContext(context: 'form' | 'editing' | 'selecting' | 'filtering'): void;
// Set custom key bindings for current state
setKeyBindings(bindings: IKeyBinding[]): void;
// Get current key bindings to display
getKeyBindings(): IKeyBinding[];
}
export interface IKeyBinding {
key: string;
description: string;
}
// Focus Chain Management
export interface IFocusChainService {
// Active element management (only one can be active)
setActive(elementId: string | null): void;
getActive(): string | null;
// Parent-child relationship for focus chain
registerParent(childId: string, parentId: string): void;
// Get the entire focus chain [active, ...ancestors]
getFocusChain(): string[];
// Check if element is in focus chain
isInFocusChain(elementId: string): boolean;
// Cleanup
unregisterElement(elementId: string): void;
}
// Input Context Management
import type { Key } from 'ink';
import type { LayoutDimensions, PanelLayout, TextLayout } from './LayoutService';
export type InputHandler = (input: string, key: Key) => boolean;
export interface ILayoutService {
calculateHorizontalLayout(
containerWidth: number,
containerHeight: number,
panelCount: number,
options?: {
gap?: number;
minPanelWidth?: number;
equalWidth?: boolean;
}
): PanelLayout;
calculateVerticalLayout(
containerWidth: number,
containerHeight: number,
panelCount: number,
options?: {
gap?: number;
minPanelHeight?: number;
equalHeight?: boolean;
}
): PanelLayout;
calculateTextLayout(
panelWidth: number,
options?: {
hasBorder?: boolean;
hasScrollbar?: boolean;
hasIndicator?: boolean;
hasValue?: boolean;
hasStatus?: boolean;
indicatorWidth?: number;
padding?: number;
}
): TextLayout;
getBreakpoint(width: number): 'small' | 'medium' | 'large';
getResponsiveConfig(width: number, height: number): {
layout: 'horizontal' | 'vertical';
showSubtitles: boolean;
showScrollbars: boolean;
abbreviateText: boolean;
};
}
export interface IInputContextService {
// Register handler for an element (with optional key bindings for status bar)
registerHandler(
elementId: string,
handler: InputHandler,
priority: number,
keyBindings?: IKeyBinding[]
): void;
// Unregister handler
unregisterHandler(elementId: string): void;
// Route input through handlers based on focus chain
handleInput(input: string, key: Key): boolean;
// Get key bindings from all focused elements
getActiveKeyBindings(): IKeyBinding[];
// NEW: Get bindings respecting focus chain
getFocusAwareKeyBindings(): IKeyBinding[];
// NEW: Check if in modal state
isModalState(): boolean;
// Add listener for key binding changes (returns cleanup function)
addChangeListener(listener: () => void): () => void;
}
// Render Slot Management
export interface IRenderSlotService {
// Claim render slots for an element
claimSlots(elementId: string, count: number, containerId: string): void;
// Release slots claimed by an element
releaseSlots(elementId: string, containerId: string): void;
// Get total slots needed by a container
getTotalSlots(containerId: string): number;
// Clear all allocations for a container
clearContainer(containerId: string): void;
}
