odox-ui 0.3.0

The shared window of the odox OpenDocument viewers: style mapping, document rendering and chrome
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

//! The window the three odox applications are each a thin shell over.
//!
//! Everything a person sees belongs here: the chrome, the document renderer, the
//! mapping from ODF styles to what egui draws with, the font resolution and the
//! messages. An application crate contributes its name, the format it opens, and
//! the one view that is particular to its body — a flow, a grid, a slide.
//!
//! Drawing lives here rather than in `odox-core` so that the library that reads
//! `OpenDocument` has no window in it: it is testable headlessly, it compiles for
//! a target with no display, and nothing about the format is decided by what egui
//! can draw.
//
// Author: David M. Anderson
// Built with AI assistance (Claude, Anthropic)

// `deny` rather than `forbid`, and `opened_document` is the exception it leaves
// room for: receiving a document from macOS needs one Objective-C method that
// cannot be written without `unsafe`, and `forbid` cannot be lifted beneath it.
// That module is the only `unsafe` in the workspace and it is compiled on one
// platform. `odox-core` keeps `forbid`, and so do the three applications.
#![deny(unsafe_code)]
#![warn(missing_docs, clippy::pedantic)]
#![allow(clippy::must_use_candidate)]

pub mod flow;
pub mod fonts;
pub mod format;
pub mod i18n;
/// Receiving a document from macOS, which does not arrive as an argument.
#[cfg(target_os = "macos")]
#[allow(unsafe_code)]
pub mod opened_document;
pub mod shapes;
pub mod shell;
pub mod system_theme;

pub use flow::{Flow, Pictures};
pub use i18n::mark;
pub use shapes::Canvas;
pub use shell::{Product, Shell, Viewer, run};