runefix-core 0.1.10

Unicode character display width engine supporting CJK, emoji, and grapheme clusters
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

//! # runefix-core
//!
//! Unicode-aware display width engine for terminals, TUI, and Markdown rendering.
//!
//! `runefix-core` provides precise width computation for multilingual text,
//! with support for:
//!
//! - East Asian fullwidth characters (CJK)
//! - Emoji (including multi-codepoint ZWJ sequences)
//! - Fullwidth punctuation and symbol variants
//! - Grapheme-aware string truncation and wrapping
//!
//! It ensures consistent text alignment across platforms and fonts
//! by working at the grapheme cluster level, consulting curated Unicode-derived datasets.
//!
//! ## Features
//!
//! 🧬 **Atom API**
//! - [`atoms`] – Runefix-specific visual segmentation for layout (width-based units)
//!
//! 🧩 **Segmentation API**
//! - [`graphemes`] – Unicode-compliant grapheme cluster splitting (UAX #29)
//!
//! πŸ“ **Measurement API**
//! - [`display_width`] – Total width of a string (grapheme-aware, terminal-style)
//! - [`display_widths`] – Widths of each grapheme cluster (`Vec<usize>`)
//! - [`grapheme_widths`] – Widths with original clusters (`Vec<(&str, usize)>`)
//!
//! πŸ“ **Layout API**
//! - [`truncate_by_width`] – Truncates text by width without splitting graphemes
//! - [`split_by_width`] – Wraps a string into lines based on terminal width
//!
//! 🍭 **Ergonomic Extensions**
//! - [`RuneDisplayWidth`] – Trait for:
//!     - `.rune_width()` on `char`
//!     - `.width()`, `.display_width()`, `.display_widths()` on `str`
//!
//! ## Example
//!
//! ```rust
//! use runefix_core::{RuneDisplayWidth, grapheme_widths};
//!
//! assert_eq!('δ½ '.rune_width(), 2);
//! assert_eq!(
//!     grapheme_widths("HiοΌŒδΈ–η•Œ"),
//!     vec![("H", 1), ("i", 1), ("，", 2), ("δΈ–", 2), ("η•Œ", 2)]
//! );
//! ```
//!
//! ## Resources
//!
//! - [πŸ“– Dataset source & CLI](https://github.com/pokeyaro/runefix-rs/tree/main/crates/core)
//! - [πŸ“¦ Crates.io](https://crates.io/crates/runefix-core)
//! - [πŸ§ͺ docs.rs Documentation](https://docs.rs/runefix-core)
//!
//! > **Note:** Enable the `policy` feature to use configurable width strategies
//! > such as `terminal()`, `markdown()`, or `compact()`.

// ───── Public APIs ─────────────────────────────────────────────

// Atom-based segmentation for layout units (runefix-specific)
pub use atom::atoms;

// Grapheme-based core processing functions (always available)
pub use grapheme::{
    display_width, display_widths, grapheme_widths, graphemes, split_by_width, truncate_by_width,
};

// Unicode-aware trait extensions for `char` and `str`
pub use ext::RuneDisplayWidth;

// Unicode data version used internally
pub use consts::UNICODE_VERSION;

// ───── Optional: Feature-gated APIs (requires `policy`) ─────────

// Configurable width strategy struct
#[cfg(feature = "policy")]
pub use policy::WidthPolicy;

// Ergonomic wrapper for applying a WidthPolicy to strings
#[cfg(feature = "policy")]
pub use with_policy::WithPolicy;

// Policy-aware versions of grapheme layout functions
#[cfg(feature = "policy")]
pub use crate::grapheme::policy_ext::{
    display_width_with_policy, display_widths_with_policy, grapheme_widths_with_policy,
    split_by_width_with_policy, truncate_by_width_with_policy,
};

// ───── Internal Modules (implementation details) ───────────────

mod atom;
mod consts;
mod ext;
mod grapheme;
mod rules;
mod width;

#[cfg(feature = "policy")]
mod policy;
#[cfg(feature = "policy")]
mod with_policy;