import * as react from 'react';
import { ReactNode, CSSProperties } from 'react';

/** Built-in paper colors. Any CSS color string is also accepted. */
type StickyNoteColor = "yellow" | "blue" | "green" | "pink" | "violet";
interface StickyNoteProps {
    /** Note text (controlled). */
    value?: string;
    /** Initial text when uncontrolled. */
    defaultValue?: string;
    /** Fires when the edited text is committed (on blur). */
    onChange?: (text: string) => void;
    /** Paper color — one of the presets, or any CSS color string. Default `"yellow"`. */
    color?: StickyNoteColor | (string & {});
    /** Rotation in degrees. Default `0`. */
    rotate?: number;
    /** Width as px number or any CSS length. Default `180`. */
    width?: number | string;
    /** Height as px number or any CSS length. Default `"auto"`. */
    height?: number | string;
    /** Selected styling (focus ring). */
    selected?: boolean;
    /** Allow inline editing of the text. Default `true`. */
    editable?: boolean;
    /**
     * Focus the editable region (caret at end) when it becomes editable. Lets a
     * consumer's "enter edit mode" gesture drop straight into typing. Default `false`.
     */
    autoFocus?: boolean;
    /**
     * Stable handle — also emitted as the element `id`. Lets agents and
     * selectors target a specific note without guessing the DOM.
     */
    id?: string;
    /** Static content; when provided, overrides the editable text. */
    children?: ReactNode;
    className?: string;
    style?: CSSProperties;
}

/**
 * A sticky note — paper-styled, with optional inline text editing.
 *
 * Presentational primitive only: it owns the note's look and its editable
 * text. Positioning, dragging, resizing, and z-order are the consumer's job
 * (e.g. `fancy-whiteboard`'s `<Board>` places it in world space;
 * `fancy-artboard`'s `<ArtBoard.Note>` positions it absolutely).
 *
 *   <StickyNote value={text} onChange={setText} color="yellow" rotate={-2} />
 */
declare const StickyNote: react.ForwardRefExoticComponent<StickyNoteProps & react.RefAttributes<HTMLDivElement>>;

export { StickyNote, type StickyNoteColor, type StickyNoteProps };