Files
ghostty-rs/crates/ghostty-font/src/lib.rs
T
ddidderr bab49ee596 feat(macos): port Ghostty's macOS code paths (Metal, CoreText, Darwin)
Ports the macOS-specific Zig code behind cfg(target_os = "macos"):
- renderer: a GraphicsApi trait with generic::Renderer<G>; Metal backend
  (all renderer/metal/* files, shaders.metal verbatim, runtime library
  compile, IOSurface layer, CVDisplayLink), shadertoy -> MSL via naga;
  OpenGL remains the backend elsewhere.
- font: CoreText face, shaper and discovery with build.rs backend
  selection (coretext default; coretext-freetype / coretext-harfbuzz /
  coretext-noshape features), no fontconfig/freetype/harfbuzz on Apple.
- input: KeymapDarwin via UCKeyTranslate, option-as-alt, mac keycodes.
- os: macos, mach, cf_release_thread, NSProcessInfo args and macOS
  branches; config: macOS defaults, keybinds, Application Support paths.
- termio/core: login(1) wrapping, openpty/execvpe, Darwin child exit
  handling, os_log logging.

Compile-checked for aarch64/x86_64-apple-darwin (clippy -D warnings
clean) using the cross setup in docs/rewrite/notes/macos-M1.md; cannot
run here. The embedded runtime/C API (embedded.zig) is the next step.

Also includes the cross-platform integration edits shared by the crash,
verification, Windows and macOS work (Cargo target-gating, thread
crash-context hooks, apprt-gtk surface/IME refactor, termio/os cfg
gates), a cfg fix so ghostty-config builds on wasm32, and an allow for
the intentional recursion in the crash overflow test.

Test Plan:
- cargo test --workspace (3224 passed)
- cargo clippy --workspace --all-targets -- -D warnings
- cargo check --target aarch64-apple-darwin -p ghostty-renderer (with
  the documented cross env)
2026-10-12 06:02:39 +02:00

110 lines
3.1 KiB
Rust

//! Font engine: metrics, atlas, sprite font, faces (FreeType / CoreText),
//! discovery (fontconfig / CoreText), collections, codepoint resolution,
//! shaping (HarfBuzz / CoreText) and the shared glyph grid. Port of
//! `ZIG/src/font/`. The backend is selected per target (see `backend.rs` and
//! `build.rs`): `fontconfig_freetype` on Linux, `coretext` on Apple targets,
//! `web_canvas` on wasm32.
#![cfg_attr(test, allow(clippy::unwrap_used))]
pub mod atlas;
pub mod backend;
pub mod codepoint_map;
#[cfg(not(target_arch = "wasm32"))]
pub mod codepoint_resolver;
#[cfg(not(target_arch = "wasm32"))]
pub mod collection;
pub mod config_types;
#[cfg(font_coretext)]
pub mod coretext_util;
#[cfg(font_fontconfig)]
pub mod deferred_face;
#[cfg(font_coretext)]
#[path = "deferred_face_coretext.rs"]
pub mod deferred_face;
#[cfg(target_arch = "wasm32")]
#[path = "deferred_face_web_canvas.rs"]
pub mod deferred_face;
#[cfg(not(target_arch = "wasm32"))]
pub mod discovery;
#[cfg(not(target_arch = "wasm32"))]
pub mod embedded;
pub mod face;
#[cfg(font_fontconfig)]
pub mod fontconfig;
pub mod glyph;
#[cfg(not(target_arch = "wasm32"))]
pub mod library;
pub mod metrics;
pub mod nerd_font_attributes;
pub mod opentype;
pub mod shape;
pub mod shaper;
#[cfg(not(target_arch = "wasm32"))]
pub mod shared_grid;
#[cfg(not(target_arch = "wasm32"))]
pub mod shared_grid_set;
pub mod sprite;
pub use atlas::Atlas;
pub use backend::{Backend, OPTIONS as options};
pub use codepoint_map::CodepointMap;
#[cfg(not(target_arch = "wasm32"))]
pub use codepoint_resolver::CodepointResolver;
#[cfg(not(target_arch = "wasm32"))]
pub use collection::Collection;
pub use deferred_face::DeferredFace;
#[cfg(not(target_arch = "wasm32"))]
pub use discovery::{Descriptor, Discover};
pub use face::Face;
pub use glyph::Glyph;
#[cfg(not(target_arch = "wasm32"))]
pub use library::Library;
pub use metrics::Metrics;
#[cfg(not(target_arch = "wasm32"))]
pub use shared_grid::SharedGrid;
#[cfg(not(target_arch = "wasm32"))]
pub use shared_grid_set::SharedGridSet;
pub use sprite::{Face as SpriteFace, Sprite};
/// The styles that a family can take.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)]
#[repr(u8)]
pub enum Style {
Regular = 0,
Bold = 1,
Italic = 2,
BoldItalic = 3,
}
impl Style {
/// All styles, in discriminant order (Zig: `std.meta.fields(Style)`).
pub const ALL: [Style; 4] = [
Style::Regular,
Style::Bold,
Style::Italic,
Style::BoldItalic,
];
}
/// The presentation for an emoji.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum Presentation {
/// U+FE0E
Text = 0,
/// U+FE0F
Emoji = 1,
}
/// A FontIndex that can be used to use the sprite font directly.
#[cfg(not(target_arch = "wasm32"))]
pub const SPRITE_INDEX: collection::Index =
collection::Index::init_special(collection::Special::Sprite);
/// The default font size adjustment we use when loading fallback fonts.
///
/// TODO: Add user configuration for this instead of hard-coding it.
#[cfg(not(target_arch = "wasm32"))]
pub const DEFAULT_FALLBACK_ADJUSTMENT: collection::SizeAdjustment =
collection::SizeAdjustment::IcWidth;