citum_schema_style/locale/
date_patterns.rs

1/*
2SPDX-License-Identifier: MIT OR Apache-2.0
3SPDX-FileCopyrightText: © 2023-2026 Bruce D'Arcus and Citum contributors
4*/
5
6use super::Locale;
7use super::message::MessageArgs;
8use super::types::MessageSyntax;
9
10impl Locale {
11    /// Resolve a `pattern.date-*` message with locale-specific year/month/day
12    /// components.
13    ///
14    /// Returns `Some(rendered)` only when the locale carries an MF2 message
15    /// at `message_id` and the evaluator produces output. Callers fall back
16    /// to the engine's hardcoded English assembly on `None`.
17    ///
18    /// A component is forwarded to the evaluator only when non-empty; an
19    /// authored pattern that references `{$day}` therefore yields `None` if
20    /// the input date carries no day, letting the caller pick a shorter form.
21    ///
22    /// The day argument is taken as `Option<u32>` rather than a pre-formatted
23    /// string so the digit-to-string allocation is deferred until after the
24    /// message lookup succeeds - the common case for legacy locales (`en-US`,
25    /// every v1 file) is the lookup miss, which now incurs zero allocation.
26    pub fn resolve_date_pattern(
27        &self,
28        message_id: &str,
29        year: Option<&str>,
30        month: Option<&str>,
31        day: Option<u32>,
32    ) -> Option<String> {
33        let message = self.messages.get(message_id)?;
34        if self.evaluation.message_syntax == MessageSyntax::Static {
35            return None;
36        }
37
38        let day_str = day.map(|d| d.to_string());
39        let args = MessageArgs {
40            year: year.filter(|s| !s.is_empty()),
41            month: month.filter(|s| !s.is_empty()),
42            day: day_str.as_deref(),
43            ..MessageArgs::default()
44        };
45        self.evaluator.evaluate(message, &args)
46    }
47}
citum_schema_style/locale/date_patterns.rs

citum_schema_style/locale/
date_patterns.rs
