/**
 * @license
 * Copyright 2025 Vybestack LLC
 * SPDX-License-Identifier: Apache-2.0
 */
/**
 * Interface for file system operations to enable dependency injection
 * and eliminate NODE_ENV checks in production code.
 */
export interface IFileSystem {
    /**
     * Check if a file exists at the given path.
     */
    existsSync(path: string): boolean;
    /**
     * Read a file synchronously and return its contents as a string.
     */
    readFileSync(path: string, encoding: BufferEncoding): string;
}
/**
 * Real file system implementation using Node.js fs module.
 */
export declare class NodeFileSystem implements IFileSystem {
    existsSync(path: string): boolean;
    readFileSync(path: string, encoding: BufferEncoding): string;
}
/**
 * Mock file system implementation for testing that doesn't read real files.
 */
export declare class MockFileSystem implements IFileSystem {
    private mockFiles;
    existsSync(path: string): boolean;
    readFileSync(path: string, _encoding: BufferEncoding): string;
    /**
     * Set mock file content for testing.
     */
    setMockFile(path: string, content: string): void;
    /**
     * Clear all mock files.
     */
    clearMocks(): void;
}
