Documentation pass: every claim in docs/ and the meta files was audited against the source and the drift fixed — around ninety corrections. CONTRIBUTING and the CI workflow now run cargo test with --features test-support (the gated test_support module made both the documented commands and the CI build fail to compile), make example becomes make examples, make doctest-md and the debhelper requirement of make clean are documented, and patch shape asks for a CHANGELOG entry. theming.md loses the nonexistent surface.backdrop, gains the real gradient defaults (linear-rgb, oklab), the six slot variants including typography, the ten-field palette, a truthful effects-consumer table, the ThemePreference/from_hour API and a responsive-sizing note; the stale docstrings in src/theme that fed the drift are fixed too. architecture.md's "Known gaps" section is rewritten against reality (multi-touch slots, xdg-activation, a11y live regions and SetValue/Increment/Decrement are implemented), gains a module map, subsurfaces and window-lifecycle coverage, and correct crustace/loginmanager paths. widgets.md fixes the ten factual errors (stateless spinner, toast/combo via overlays(), tooltip hover contract, row has no max_width, scroll axes, multiline text_edit, dialog panic wording) and now states the column() 16 px default padding — the recurring ambush — plus row's differing 0 default and dialog's max_width. onboarding, README and cookbook get the remaining sweep: build/test instructions, complete example lists, img_widget, clipping-parity honesty, ~30 Hz software cap, read_rgba_pixels signature, tab indentation in snippets, and rustdoc-style links that rendered literally are gone everywhere. CHANGELOG is restructured per Keep a Changelog with the missing entries (window_resizable, claims_raw_touch, Row::align_top/fill_height, caret fixes, dependency pins) and the pad_v Added/Changed contradiction resolved. New adaptive-layout API: ltk::orientation() with the Orientation enum, backed by viewport_size()/set_viewport_size — the runtime records the main surface's physical dimensions on every configure, before App::on_resize, so view() can branch a layout on portrait vs landscape without hand-tracking resizes. The portrait rule matches Length::orient (square counts as portrait); embedders driving core::UiSurface call set_viewport_size themselves. Documented in the crate root's responsive-design section and architecture.md. Fluid-vs-fixed sizing fixes in widgets, all the same disease — fluid content inside a fixed-pixel box. TextEdit::fixed_width takes impl Into<Length> (f32 call sites keep compiling as px) and the time picker's digit fields move to Length::fluid( 72.0 ), matching their fluid font so digits can no longer outgrow the box. Dialog::max_width takes impl Into<Length> with a Length::fluid( 480.0 ) default so the card scales with the stock buttons inside it, and the card's interior no longer stacks the column() default 16 px padding on top of CARD_PADDING — that double inset squeezed the action row until its buttons clipped on narrow windows. App::on_pointer_axis now triggers a view rebuild and repaint; previously state mutated in the hook did not paint until the next unrelated event. Examples reworked to be honest demos: responsive's mode/density controls become stock buttons in a grid/column so they follow the modes they demonstrate instead of overflowing; dialog's openers stack vertically, and the example gains the app-level ESC handler so the ESC chain closes an open dialog first and quits second; widgets' tab strip now switches real per-tab pages; carousel gains pointer/touch drag through the horizontal-swipe hooks (crustace's pager pattern), one-tile-per-detent mouse wheel, and snap math driven by the real surface width from on_resize instead of a hardcoded 800; clip_path arranges its cells by ltk::orientation() and sizes them from the counter-axis of the flow.
120 lines
2.8 KiB
Rust
120 lines
2.8 KiB
Rust
// SPDX-License-Identifier: LGPL-2.1-only
|
|
// Copyright (C) 2026 Liberux Labs, S. L. <info@liberux.net>
|
|
|
|
use super::*;
|
|
use crate::layout::spacer::spacer;
|
|
|
|
#[ derive( Clone, Debug, PartialEq, Eq ) ]
|
|
enum Msg { Cancel, Dismiss }
|
|
|
|
#[ test ]
|
|
fn new_defaults_are_modal_with_no_content()
|
|
{
|
|
let d = Dialog::<Msg>::new();
|
|
assert!( d.modal );
|
|
assert!( d.title.is_none() );
|
|
assert!( d.subtitle.is_none() );
|
|
assert!( d.body.is_none() );
|
|
assert!( d.actions.is_empty() );
|
|
assert!( d.dismiss_msg.is_none() );
|
|
assert!( d.cancel_msg.is_none() );
|
|
assert_eq!( d.max_width, crate::types::Length::fluid( DEFAULT_MAX_WIDTH ) );
|
|
}
|
|
|
|
#[ test ]
|
|
fn title_and_subtitle_builders_set_strings()
|
|
{
|
|
let d = Dialog::<Msg>::new()
|
|
.title( "Hello" )
|
|
.subtitle( "World" );
|
|
assert_eq!( d.title.as_deref(), Some( "Hello" ) );
|
|
assert_eq!( d.subtitle.as_deref(), Some( "World" ) );
|
|
}
|
|
|
|
#[ test ]
|
|
fn body_builder_replaces_existing_body()
|
|
{
|
|
let d = Dialog::<Msg>::new()
|
|
.body( spacer() )
|
|
.body( spacer() );
|
|
assert!( d.body.is_some() );
|
|
}
|
|
|
|
#[ test ]
|
|
fn action_builder_appends_in_order()
|
|
{
|
|
let d = Dialog::<Msg>::new()
|
|
.action( spacer() )
|
|
.action( spacer() )
|
|
.action( spacer() );
|
|
assert_eq!( d.actions.len(), 3 );
|
|
}
|
|
|
|
#[ test ]
|
|
fn modal_builder_toggles_flag()
|
|
{
|
|
assert!( !Dialog::<Msg>::new().modal( false ).modal );
|
|
assert!( Dialog::<Msg>::new().modal( true ).modal );
|
|
}
|
|
|
|
#[ test ]
|
|
fn dismiss_on_scrim_builder_records_message()
|
|
{
|
|
let d = Dialog::<Msg>::new()
|
|
.modal( false )
|
|
.dismiss_on_scrim( Msg::Dismiss );
|
|
assert_eq!( d.dismiss_msg, Some( Msg::Dismiss ) );
|
|
}
|
|
|
|
#[ test ]
|
|
fn cancel_builder_records_escape_message()
|
|
{
|
|
let d = Dialog::<Msg>::new().cancel( Msg::Cancel );
|
|
assert_eq!( d.cancel_msg, Some( Msg::Cancel ) );
|
|
}
|
|
|
|
#[ test ]
|
|
fn max_width_builder_overrides_default()
|
|
{
|
|
let d = Dialog::<Msg>::new().max_width( 720.0 );
|
|
assert_eq!( d.max_width, crate::types::Length::px( 720.0 ) );
|
|
}
|
|
|
|
#[ test ]
|
|
#[ should_panic( expected = "dismiss_on_scrim is not valid when modal=true" ) ]
|
|
fn modal_with_dismiss_panics_at_lower()
|
|
{
|
|
// Construction allows the combination; only the lowering
|
|
// to `Element` enforces the contract — that is where the
|
|
// invariant matters because that is where input dispatch
|
|
// would have to honour two contradictory rules.
|
|
let d = Dialog::<Msg>::new()
|
|
.modal( true )
|
|
.dismiss_on_scrim( Msg::Dismiss );
|
|
let _: Element<Msg> = d.into();
|
|
}
|
|
|
|
#[ test ]
|
|
fn non_modal_with_dismiss_lowers_cleanly()
|
|
{
|
|
let d = Dialog::<Msg>::new()
|
|
.modal( false )
|
|
.dismiss_on_scrim( Msg::Dismiss )
|
|
.cancel( Msg::Cancel )
|
|
.title( "Title" );
|
|
// Lowering must not panic.
|
|
let _: Element<Msg> = d.into();
|
|
}
|
|
|
|
#[ test ]
|
|
fn modal_with_cancel_only_lowers_cleanly()
|
|
{
|
|
// modal=true + cancel(...) (no dismiss_on_scrim) is the
|
|
// canonical confirm-dialog shape.
|
|
let d = Dialog::<Msg>::new()
|
|
.title( "Confirm" )
|
|
.subtitle( "Are you sure?" )
|
|
.cancel( Msg::Cancel );
|
|
let _: Element<Msg> = d.into();
|
|
}
|