import type { HTMLAttributes, ReactNode } from "react";
/**
 * CodeBlock — terminal command / code snippet surface.
 *
 * Pre-rendered code block with optional terminal "$ " prefix per line,
 * optional caption (file name), and optional CopyButton positioned top-right.
 * The CopyButton receives the RAW `code` (without the visual "$ " prefix),
 * so consumers paste only the executable command.
 *
 * @example
 *   <CodeBlock code="theo deploy" terminal copyable />
 *   <CodeBlock code={dotenv} caption=".env.local" copyable />
 *
 * `language` is reserved for future syntax highlighting (v1: ignored).
 */
export interface CodeBlockProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
    /** Code content. Can be multiline. */
    code: string;
    /** Language hint (forward-compat; v1 ignored). */
    language?: string;
    /** When true, prefix each line with "$ " for shell commands. */
    terminal?: boolean;
    /** Show inline CopyButton in top-right. */
    copyable?: boolean;
    /** Optional caption above block (e.g. ".env.local"). */
    caption?: ReactNode;
}
declare const CodeBlock: import("react").ForwardRefExoticComponent<CodeBlockProps & import("react").RefAttributes<HTMLDivElement>>;
export { CodeBlock };