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
//! Lightweight import surface for downstream crates.
//!
//! `crate::core` is ~22k lines. Most downstream callers only need the core data types --
//! entities, spans, mentions, coreference chains, and provenance. This module collects
//! those types into a single `use` target so that consumers avoid pulling in the dataset
//! registry, calibration machinery, graph-export formats, and historical-linguistics types.
//!
//! # When to use `minimal` vs the full re-export
//!
//! | Import path | What you get | What you skip |
//! |---|---|---|
//! | `crate::minimal::*` | Data types, builders, coref, provenance | Dataset registry, calibration, historical, graph export |
//! | `crate::*` | Everything | Nothing |
//!
//! Prefer `minimal` when your crate only reads/writes annotation data. Use the full
//! surface when you need evaluation infrastructure or dataset loading.
//!
//! # Quick start
//!
//! ```rust
//! use anno::minimal::{Entity, EntityType, Span, Mention, CorefChain};
//!
//! // Build an entity at character offsets 0..6.
//! let entity = Entity::new("Berlin", EntityType::Location, 0, 6, 0.95);
//! assert_eq!(entity.text, "Berlin");
//! assert_eq!((entity.start(), entity.end()), (0, 6));
//!
//! // Build a coreference chain from two mentions.
//! let m1 = Mention::new("John", 0, 4);
//! let m2 = Mention::new("he", 25, 27);
//! let chain = CorefChain::new(vec![m1, m2]);
//! assert_eq!(chain.len(), 2);
//! assert!(!chain.is_singleton());
//! ```
//!
//! # Builder pattern
//!
//! For richer construction, use [`EntityBuilder`]:
//!
//! ```rust
//! use anno::minimal::{EntityBuilder, EntityType, Provenance};
//!
//! let entity = EntityBuilder::new("Berlin", EntityType::Location)
//! .span(0, 6)
//! .confidence(0.95)
//! .provenance(Provenance::ml("gliner", 0.95))
//! .build();
//! assert_eq!(entity.provenance.unwrap().source, "gliner");
//! ```
// -- Entity layer ----------------------------------------------------------
pub use crate;
// -- Coreference layer -----------------------------------------------------
pub use crate;
// -- Scalar/ID types -------------------------------------------------------
pub use crate;