use crate::prelude::*; /// `align`: Align content along the layouting axes. /// /// # Positional arguments /// - At most two of `left`, `right`, `top`, `bottom`, `center`. /// /// When `center` is used as a positional argument, it is automatically inferred /// which axis it should apply to depending on further arguments, defaulting /// to the axis, text is set along. /// /// # Keyword arguments /// - `horizontal`: Any of `left`, `right` or `center`. /// - `vertical`: Any of `top`, `bottom` or `center`. /// /// There may not be two alignment specifications for the same axis. pub fn align(mut args: Args, ctx: &mut EvalContext) -> Value { let snapshot = ctx.state.clone(); let body = args.find::(); let first = args.get::<_, Spanned>(ctx, 0); let second = args.get::<_, Spanned>(ctx, 1); let hor = args.get::<_, Spanned>(ctx, "horizontal"); let ver = args.get::<_, Spanned>(ctx, "vertical"); args.done(ctx); let iter = first .into_iter() .chain(second.into_iter()) .map(|align| (align.v.axis(), align)) .chain(hor.into_iter().map(|align| (Some(SpecAxis::Horizontal), align))) .chain(ver.into_iter().map(|align| (Some(SpecAxis::Vertical), align))); let prev_main = ctx.state.aligns.main; ctx.state.aligns = dedup_aligns(ctx, iter); if prev_main != ctx.state.aligns.main { ctx.end_par_group(); ctx.start_par_group(); } if let Some(body) = body { body.eval(ctx); ctx.state = snapshot; } Value::None } /// Deduplicate alignments and deduce to which axes they apply. fn dedup_aligns( ctx: &mut EvalContext, iter: impl Iterator, Spanned)>, ) -> Gen2 { let mut aligns = ctx.state.aligns; let mut had = Gen2::new(false, false); let mut had_center = false; for (axis, Spanned { v: align, span }) in iter { // Check whether we know which axis this alignment belongs to. if let Some(axis) = axis { // We know the axis. let gen_axis = axis.switch(ctx.state.dirs); let gen_align = align.switch(ctx.state.dirs); if align.axis().map_or(false, |a| a != axis) { ctx.diag(error!( span, "invalid alignment `{}` for {} axis", align, axis, )); } else if had.get(gen_axis) { ctx.diag(error!(span, "duplicate alignment for {} axis", axis)); } else { *aligns.get_mut(gen_axis) = gen_align; *had.get_mut(gen_axis) = true; } } else { // We don't know the axis: This has to be a `center` alignment for a // positional argument. debug_assert_eq!(align, SpecAlign::Center); if had.main && had.cross { ctx.diag(error!(span, "duplicate alignment")); } else if had_center { // Both this and the previous one are unspecified `center` // alignments. Both axes should be centered. aligns = Gen2::new(GenAlign::Center, GenAlign::Center); had = Gen2::new(true, true); } else { had_center = true; } } // If we we know one alignment, we can handle the unspecified `center` // alignment. if had_center && (had.main || had.cross) { if had.main { aligns.cross = GenAlign::Center; had.cross = true; } else { aligns.main = GenAlign::Center; had.main = true; } had_center = false; } } // If center has not been flushed by now, it is the only argument and then // we default to applying it to the cross axis. if had_center { aligns.cross = GenAlign::Center; } aligns }