appcore-filemaker 0.1.0-beta.1

Deterministic declarative document, canvas, and dataset compiler for AppCore
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

// =============================================================================
//        #######
//     ###       ###     F: source_text.rs
//    ##   ## ##   ##    P: AppCore-Runtime
//         ## ##
//                       C: 2026/08/30 05:00:00 by dnettoRaw
//    ##   ## ##   ##    U: 2026/08/30 05:00:00 by dnettoRaw
//      ###########      S: 1.0.2-rc
// =============================================================================

use serde::{Deserialize, Serialize};

use crate::{ErrorCode, FileMakerError, Length, Result, TextIr, TextOverflow, Unit, WritingMode};

/// Declarative text measurement and overflow options.
#[derive(Clone, Copy, Debug, Eq, PartialEq, Serialize, Deserialize)]
#[serde(default, deny_unknown_fields)]
pub struct TextSourceOptions {
    /// Overflow behavior.
    pub overflow: TextOverflow,
    /// Optional maximum number of resolved lines.
    pub max_lines: Option<usize>,
    /// Minimum size used by `shrink`; must be absolute.
    pub min_font_size: Option<Length>,
    /// Line-height multiplier in millionths.
    pub line_height: u32,
    /// Horizontal lines or top-to-bottom right-to-left vertical columns.
    pub writing_mode: WritingMode,
}

impl Default for TextSourceOptions {
    fn default() -> Self {
        Self {
            overflow: TextOverflow::Wrap,
            max_lines: None,
            min_font_size: Some(Length::Absolute(Unit::from_raw(6_000_000))),
            line_height: 1_200_000,
            writing_mode: WritingMode::Horizontal,
        }
    }
}

pub(crate) fn validate_text_options(options: &TextSourceOptions) -> Result<()> {
    let minimum = options
        .min_font_size
        .map(|value| value.resolve(Unit::ZERO, Unit::ZERO))
        .transpose()?
        .flatten();
    if options.max_lines == Some(0)
        || !(500_000..=4_000_000).contains(&options.line_height)
        || minimum.is_some_and(|value| value <= Unit::ZERO)
        || options
            .min_font_size
            .is_some_and(|value| !matches!(value, Length::Absolute(_)))
    {
        return Err(FileMakerError::new(
            ErrorCode::SchemaField,
            "text options contain an invalid line or minimum-font constraint",
        ));
    }
    Ok(())
}

pub(crate) fn convert_text_options(options: TextSourceOptions) -> TextIr {
    TextIr {
        overflow: options.overflow,
        max_lines: options.max_lines,
        min_font_size: options.min_font_size,
        line_height: options.line_height,
        writing_mode: options.writing_mode,
    }
}