//! By convention, root.zig is the root source file when making a package.
//!
//! Twig parses document formats (Djot first) into a shared, index-based
//! `AST` — the document-format counterpart to fig's config-tree `AST` — so
//! that precise structural operations can be performed on a document,
//! rather than just converting between formats. See `twig.md` for the
//! project's goals and `AST`'s module doc comment for the node model.
/// The shared document AST every format parses into. See its module doc
/// comment for the node/kind model and the ownership discipline (every
/// string a node carries is copied, so a finished `AST` never borrows the
/// original source and is safe to hold onto after parsing).
pub const AST = @import("ast/ast.zig");
/// Djot support: `Djot.parse(allocator, source) !Djot.Document` (the shared
/// `AST` plus djot's reference/footnote side tables) plus `Djot.html` for
/// HTML rendering. See `languages/djot/djot.zig`'s module doc comment.
pub const Djot = @import("languages/djot/djot.zig");
/// XML support: `Xml.parse(allocator, source) !AST` (well-formed XML 1.0, no
/// external DTD processing) plus `Xml.serialize`/`Xml.serializeAlloc` for
/// rendering back to text. Unlike `Djot`, XML needs no side-table wrapper —
/// `parse` returns the shared `AST` directly. See `languages/xml/xml.zig`'s
/// module doc comment.
pub const Xml = @import("languages/xml/xml.zig");
/// HTML support: `Html.parse` builds generic-markup AST nodes from forgiving
/// HTML; `Html.serialize`/`Html.serializeAlloc` render the full shared
/// vocabulary. The printer takes an optional `Html.Context` to resolve
/// djot-style reference/footnote side tables without this module depending on
/// `Djot`.
pub const Html = @import("languages/html/html.zig");
/// Markdown support: `Markdown.parse(allocator, source, options) !Markdown.Document`
/// (the shared `AST` plus Markdown's link-reference-definition side table)
/// plus `Markdown.ParseOptions` feature flags. Rendering uses
/// `Markdown.html` (an adapter over the shared `Html` printer). See
/// `languages/markdown/markdown.zig`'s module doc comment for scope details.
pub const Markdown = @import("languages/markdown/markdown.zig");
/// The span-splice editor: lossless, in-place edits to a parsed document via
/// index paths into the shared `AST`. Language-agnostic — construct it with a
/// `parse_fn` for the source's format. See `ast/editor.zig`'s module doc
/// comment for the reparse/rollback model and its current limits.
pub const Editor = @import("ast/editor.zig").Editor;
/// A byte range `[start, end)` into the source — the currency of the span-
/// splice editor and the offset-addressed `twig_editor_edit_range`/`node_at`
/// C-ABI surface. See `span.zig`.
pub const Span = @import("span.zig");
/// Content-based node addressing: `Select.parse` a CSS-lite selector (e.g.
/// `heading[level=2]`, `link[dest^="http"]`, `item("eggs")`) then
/// `Select.resolveAll`/`resolveOne` it against an `AST` — the friendly
/// alternative to raw index paths, and the engine behind `twig query`/`edit`.
/// See `ast/select.zig`'s module doc comment.
pub const Select = @import("ast/select.zig");
/// Declarative document pruning over `Select` + `Editor`: `Filter.apply` keeps
/// only the family members (`drop` selector) matching a `keep` predicate,
/// optionally unwrapping the survivors — the engine behind `twig filter`. See
/// `ast/filter.zig`'s module doc comment.
pub const Filter = @import("ast/filter.zig");
/// A stable, inspectable JSON encoding of the shared `AST`
/// (`ast_json.encode`/`encodeAlloc`) — the engine behind `twig convert -o ast`
/// and the C ABI's `twig_document_ast_json`. See `ast/json.zig`'s module doc
/// comment.
pub const ast_json = @import("ast/json.zig");
test {
_ = AST;
_ = Djot;
_ = Xml;
_ = Html;
_ = Markdown;
_ = @import("ast/editor.zig");
_ = Select;
_ = Filter;
_ = ast_json;
}