aetna-fonts 0.2.0

Bundled font assets for Aetna (Roboto + Noto fallback faces)
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

//! Bundled font assets for Aetna.
//!
//! This crate is a thin re-exporter: each Cargo feature pulls in a
//! sibling crate that bundles the matching font family
//! (`aetna-fonts-roboto`, `aetna-fonts-emoji`, `aetna-fonts-symbols`).
//! Splitting the families across crates keeps every published
//! `.crate` artifact under crates.io's per-crate upload size limit,
//! while the `aetna-fonts` API stays the same surface aetna-core (and
//! application code) consumes.
//!
//! The default feature set is generous (Roboto + emoji + symbols) —
//! chosen so that LLM output, which freely reaches for arrows, math
//! operators, dingbats, and box-drawing characters, doesn't render as
//! tofu (`◻`) out of the box.
//!
//! # Feature flags
//!
//! | feature   | adds                                                  | size (raw)   |
//! |-----------|-------------------------------------------------------|--------------|
//! | `roboto`  | Roboto Regular / Medium / Bold / Italic               | ~1.8 MB      |
//! | `emoji`   | NotoColorEmoji (CBDT color bitmaps)                   | ~10 MB       |
//! | `symbols` | NotoSansSymbols2 + NotoSansMath                       | ~2.2 MB      |
//!
//! `default = ["default_fonts"]` and `default_fonts = ["roboto",
//! "emoji", "symbols"]`. To skip the bundled fonts entirely (for
//! example, to ship your own Material Symbols or a brand typeface):
//!
//! ```toml
//! aetna-fonts = { version = "0.2", default-features = false }
//! ```
//!
//! CJK was previously available as an opt-in `cjk` feature shipping
//! NotoSansCJK SC (~16 MB). The bundled font pushed the published
//! `.crate` over crates.io's upload cap, so it has been removed for
//! this release; a bring-your-own-font path will return in a later
//! release. In the meantime, register a CJK face into aetna-core's
//! `fontdb` directly via the public text-atlas APIs.
//!
//! Color emoji (NotoColorEmoji) is rendered through aetna-core's
//! unified RGBA atlas — outline glyphs are stored as
//! `(255, 255, 255, alpha)` and color emoji as native RGBA, so backends
//! sample one texture format and run one shader path.
//!
//! # API
//!
//! Each enabled font family re-exports a `pub static FOO: &[u8]`
//! constant from its sibling crate. The [`DEFAULT_FONTS`] slice
//! collects every byte slice that is enabled in the current build,
//! in priority order (sans-serif text first, then symbol / emoji
//! fallbacks). aetna-core's atlas loads them all into its `fontdb`
//! so cosmic-text's per-codepoint fallback can pick from them.

#![no_std]

#[cfg(feature = "roboto")]
pub use aetna_fonts_roboto::{ROBOTO_BOLD, ROBOTO_ITALIC, ROBOTO_MEDIUM, ROBOTO_REGULAR};

#[cfg(feature = "emoji")]
pub use aetna_fonts_emoji::NOTO_COLOR_EMOJI;

#[cfg(feature = "symbols")]
pub use aetna_fonts_symbols::{NOTO_SANS_MATH_REGULAR, NOTO_SANS_SYMBOLS2_REGULAR};

/// Byte slices for every font enabled in the current build, in priority
/// order: text faces first, then symbol / emoji fallbacks.
///
/// aetna-core loads every entry into its `fontdb`. cosmic-text's font
/// matcher then walks the database per codepoint when a primary face
/// lacks a glyph — the order here only documents intent; cosmic-text's
/// fallback is keyed on Unicode coverage, not list position.
pub const DEFAULT_FONTS: &[&[u8]] = &[
    #[cfg(feature = "roboto")]
    ROBOTO_REGULAR,
    #[cfg(feature = "roboto")]
    ROBOTO_MEDIUM,
    #[cfg(feature = "roboto")]
    ROBOTO_BOLD,
    #[cfg(feature = "roboto")]
    ROBOTO_ITALIC,
    #[cfg(feature = "emoji")]
    NOTO_COLOR_EMOJI,
    #[cfg(feature = "symbols")]
    NOTO_SANS_SYMBOLS2_REGULAR,
    #[cfg(feature = "symbols")]
    NOTO_SANS_MATH_REGULAR,
];