quillmark-core 0.74.0

Core types and functionality for Quillmark
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! # Quillmark Core Overview
//!
//! Core types and functionality for the Quillmark format-first Markdown rendering system.
//!
//! ## Features
//!
//! This crate provides the foundational types and traits for Quillmark:
//!
//! - **Parsing**: YAML frontmatter extraction with Extended YAML Metadata Standard support
//! - **Format model**: [`QuillSource`] type for managing format bundles with in-memory file system
//! - **Backend trait**: Extensible interface for implementing output format backends
//! - **Error handling**: Structured diagnostics with source location tracking
//! - **Utilities**: TOML⇄YAML conversion helpers
//!
//! ## Quick Start
//!
//! ```no_run
//! use quillmark_core::Document;
//!
//! // Parse markdown with frontmatter
//! let markdown = "---\nQUILL: my_quill\ntitle: Example\n---\n\n# Content";
//! let doc = Document::from_markdown(markdown).unwrap();
//! let title = doc.main()
//!     .frontmatter()
//!     .get("title")
//!     .and_then(|v| v.as_str())
//!     .unwrap_or("Untitled");
//! assert_eq!(title, "Example");
//! ```
//!
//! ## Architecture
//!
//! The crate is organized into modules:
//!
//! - [`document`]: Markdown parsing with YAML frontmatter support
//! - [`backend`]: Backend trait for output format implementations
//! - [`error`]: Structured error handling and diagnostics
//! - [`types`]: Core rendering types (OutputFormat, Artifact, RenderOptions)
//! - [`quill`]: QuillSource bundle and related types
//!
//! ## Further Reading
//!
//! - [PARSE.md](https://github.com/nibsbin/quillmark/blob/main/designs/PARSE.md) - Detailed parsing documentation
//! - [Examples](https://github.com/nibsbin/quillmark/tree/main/examples) - Working examples

pub mod document;
pub use document::{
    Card, Document, EditError, Frontmatter, FrontmatterItem, ParseOutput, Sentinel,
};

pub mod backend;
pub use backend::Backend;

pub mod error;
pub use error::{Diagnostic, Location, ParseError, RenderError, RenderResult, Severity};

pub mod types;
pub use types::{Artifact, OutputFormat, RenderOptions};

pub mod session;
pub use session::RenderSession;

pub mod quill;
pub use quill::{FileTreeNode, QuillIgnore, QuillSource};

pub mod value;
pub use value::QuillValue;

pub mod normalize;
pub use normalize::{
    normalize_document, normalize_fields, normalize_markdown, strip_bidi_formatting,
    NormalizationError,
};

pub mod version;
pub use version::{QuillReference, Version, VersionSelector};