import * as react from 'react';

interface CodeViewProps {
    /** Source text to display / edit. Controlled. */
    value: string;
    /**
     * Called on edit. Omit (or set `readOnly`) for a read-only view. When
     * provided, the view is an editable source surface (transparent textarea over
     * the highlight overlay).
     */
    onChange?: (value: string) => void;
    /**
     * Language id for syntax highlighting. Only `"html"` is highlighted (the one
     * grammar shipped by `fancy-file-commons`); everything else — including
     * `"markdown"` and `"plaintext"` — renders un-highlighted. For richer language
     * highlighting use `@particle-academy/fancy-code`'s `CodeEditor`.
     * @default "plaintext"
     */
    language?: "html" | "markdown" | "plaintext" | (string & {});
    /** Read-only mode (no editing even if `onChange` is passed). @default false */
    readOnly?: boolean;
    /** Placeholder shown when empty. */
    placeholder?: string;
    /** Min height in px before the view grows with content. @default 120 */
    minHeight?: number;
    /** Max height in px before the view scrolls internally. */
    maxHeight?: number;
    /** Additional classes on the scroll container (e.g. `h-full`, `flex-auto`). */
    className?: string;
}

/**
 * A lightweight, syntax-highlighted source view built on the pure highlight
 * primitives in `@particle-academy/fancy-file-commons` — a highlight overlay
 * with a transparent, auto-growing textarea on top; the container scrolls both
 * together. Fills its parent's height (`h-full`) and grows with content down to
 * `minHeight`. Only HTML is highlighted; other languages render as plain text.
 */
declare function CodeView({ value, onChange, language, readOnly, placeholder, minHeight, maxHeight, className, }: CodeViewProps): react.JSX.Element;
declare namespace CodeView {
    var displayName: string;
}

export { CodeView, type CodeViewProps };