marco-core 1.3.0

//! `marco-core` is a pure-Rust Markdown engine with editor intelligence.
//!
//! Typical flow:
//! 1. Parse input text into an AST with [`parse`].
//! 2. Render the AST to HTML with [`render()`].
//! 3. Optionally run editor analysis via [`MarkdownIntelligenceProvider`].
//!
//! # Example
//! ```rust
//! let doc = marco_core::parse("# Hello")?;
//! let html = marco_core::render(&doc, &marco_core::RenderOptions::default())?;
//! assert!(html.contains("<h1"));
//! assert!(html.contains("Hello"));
//! # Ok::<(), Box<dyn std::error::Error>>(())
//! ```

/// The crate version from `Cargo.toml`, exposed for downstream UIs and diagnostics.
pub const VERSION: &str = env!("CARGO_PKG_VERSION");

/// Low-level Markdown grammar components (block and inline parsers).
pub mod grammar;
/// Editor intelligence APIs such as diagnostics, highlights, completions, and TOC.
pub mod intelligence;
/// Utility logic such as UTF-8 sanitization and text helpers.
pub mod logic;
/// AST definitions and parser entry points.
pub mod parser;
/// HTML rendering and rendering options.
pub mod render;

/// Main intelligence provider used by downstream editor integrations.
pub use intelligence::MarkdownIntelligenceProvider;
/// Parse Markdown text into a [`Document`] AST using default options.
pub use parser::parse;
/// Parse Markdown with explicit runtime options (position tracking, math, diagrams).
pub use parser::parse_with_options;
/// Runtime parse configuration; pass to [`parse_with_options`] to skip expensive work.
pub use parser::ParseOptions;
/// Core AST types used by parser, renderer, and intelligence modules.
pub use parser::{Document, Node, NodeKind};
/// Eagerly warm `parallel-render`'s thread pool and, for each given
/// language, its syntax highlighter — call at application startup with your
/// expected languages to move most of that one-time cost off the first
/// render. A no-op when `parallel-render` is not compiled in, so it's always
/// safe to call. See [`render::warm_render_thread_pool`] for details,
/// including which part of the cost this can and can't eliminate.
pub use render::warm_render_thread_pool;
/// Render a parsed [`Document`] into HTML using [`RenderOptions`].
pub use render::{render, RenderOptions};

/// UTF-8 sanitization API and related types.
pub use logic::utf8::{sanitize_input, sanitize_input_with_stats, InputSource, SanitizeStats};