Expand description
Interactive document-level API for batch citation formatting. Interactive document-level API for batch citation formatting.
This module provides the Tier 1 format_document API, enabling whole-document
citation and bibliography rendering with proper context (note positions, ibid
detection, disambiguation).
Re-exports§
pub use forward_compat::UnknownFieldPath;pub use forward_compat::collect_unknown_field_paths;
Modules§
- forward_
compat - Forward-compat unknown-field walking for
citum check.
Structs§
- Abbreviation
Map - Document-level map from full rendered strings to their abbreviations.
- Annotation
Style - Controls how annotation text is rendered in an annotated bibliography.
- Bibliography
Entry - A single bibliography entry.
- Citation
Insert Position - Position context for inserting or moving a citation in a session.
- Citation
Occurrence - A citation occurrence in the document.
- Citation
Occurrence Item - A single item within a citation occurrence.
- Document
Options - Document-level configuration for rendering.
- Document
Session - Stateful facade over whole-document citation rendering.
- Entry
Metadata - Metadata extracted from a bibliography entry for interactivity.
- Format
Document Request - A request to format a complete document’s citations and bibliography.
- Format
Document Result - The result of formatting a document.
- Formatted
Bibliography - A formatted bibliography.
- Formatted
Citation - A single formatted citation.
- Open
Session Result - Result returned when a new interactive session is opened.
- Preview
Citation Result - Result returned by citation preview.
- Session
Mutation Result - Result returned by mutation methods.
- Warning
- A structured diagnostic warning returned alongside formatted output.
Enums§
- Annotation
Format - Markup format for annotation text.
- Document
Session Error - Errors returned by the stateful session API.
- Format
Document Error - Errors that can occur during document formatting.
- Output
Format Kind - Supported output format kinds.
- Refs
Input - A refs input that can be resolved locally or by an external resolver.
- Style
Input - A style reference that can be resolved locally or by an external resolver.
- Warning
Level - Severity level for a structured diagnostic.
Functions§
- apply_
style_ overrides - Parse a partial-style overlay (YAML or JSON) and merge it over
stylein place. - format_
document - Format a complete document’s citations and bibliography (convenience wrapper).
- format_
document_ with_ resolver - Format a document, resolving the style through an injected resolver.
- format_
document_ with_ style - Format a document using an already-resolved style.
- unknown_
enum_ warnings - Scan the style and bibliography for unknown enum variants and term keys.
- unknown_
reference_ class_ warnings - Scan the bibliography for unknown reference classes and return compatibility warnings.