First commit. Version 0.1.0

2026-05-10 09:58:23 +02:00
parent af105b7f7d
commit bbab5e238d
635 changed files with 53627 additions and 175 deletions
--- a/tests/widget_dispatch.rs
+++ b/tests/widget_dispatch.rs
@@ -0,0 +1,281 @@
+// Handler-level dispatch coverage for the interactive widgets that aren't
+// buttons or text edits: toggle, checkbox, radio and slider. Each test renders
+// the widget through `UiSurface`, locates its `WidgetHandlers` snapshot and
+// confirms the snapshot routes activations to the configured Msg variant.
+
+use ltk::core::{ RenderOptions, UiSurface };
+use ltk::test_support::WidgetHandlers;
+use ltk::{
+	checkbox, column, radio, slider, toggle, Color, Element, Point, Rect, SliderAxis,
+};
+
+#[ derive( Clone, Debug, PartialEq ) ]
+enum Msg
+{
+	WifiToggled,
+	TermsAccepted,
+	PriorityHigh,
+	Brightness( f32 ),
+}
+
+fn render_view( view: Element<Msg> ) -> UiSurface<Msg>
+{
+	let mut surface = UiSurface::<Msg>::new( 320, 240 );
+	let _ = surface.render(
+		&view,
+		RenderOptions::full_canvas( 320, 240 ).background( Color::rgb( 0.1, 0.1, 0.1 ) ),
+	);
+	surface
+}
+
+// ── Toggle ────────────────────────────────────────────────────────────────────
+
+#[ test ]
+fn toggle_handler_carries_on_toggle_message()
+{
+	let view: Element<Msg> = column()
+		.push( toggle( false ).on_toggle( Msg::WifiToggled ) )
+		.into();
+	let surface = render_view( view );
+
+	let idx = surface.widget_rects()[ 0 ].flat_idx;
+	let h = surface.handlers( idx ).expect( "toggle should expose a handler" );
+	assert!( !h.is_text_input() );
+	assert!( !h.is_slider() );
+	assert_eq!( h.press_msg(), Some( Msg::WifiToggled ) );
+}
+
+#[ test ]
+fn toggle_handler_variant_is_toggle()
+{
+	let view: Element<Msg> = column()
+		.push( toggle( true ).on_toggle( Msg::WifiToggled ) )
+		.into();
+	let surface = render_view( view );
+	let h = surface.handlers( surface.widget_rects()[ 0 ].flat_idx ).unwrap();
+	assert!( matches!( h, WidgetHandlers::Toggle { on_toggle: Some( _ ) } ) );
+}
+
+#[ test ]
+fn toggle_without_on_toggle_yields_none_press_msg()
+{
+	let view: Element<Msg> = column()
+		.push( toggle::<Msg>( false ) )
+		.into();
+	let surface = render_view( view );
+	let h = surface.handlers( surface.widget_rects()[ 0 ].flat_idx ).unwrap();
+	assert!( h.press_msg().is_none() );
+}
+
+// ── Checkbox ──────────────────────────────────────────────────────────────────
+
+#[ test ]
+fn checkbox_handler_carries_on_toggle_message()
+{
+	let view: Element<Msg> = column()
+		.push( checkbox( false ).on_toggle( Msg::TermsAccepted ).label( "Accept" ) )
+		.into();
+	let surface = render_view( view );
+
+	let idx = surface.widget_rects()[ 0 ].flat_idx;
+	let h = surface.handlers( idx ).unwrap();
+	assert!( matches!( h, WidgetHandlers::Checkbox { on_toggle: Some( _ ) } ) );
+	assert_eq!( h.press_msg(), Some( Msg::TermsAccepted ) );
+}
+
+#[ test ]
+fn checkbox_state_is_independent_of_handler()
+{
+	// The widget renders the current `checked` value; toggling that value is
+	// the parent app's job — handler dispatch must work regardless of the
+	// initial state.
+	let unchecked: Element<Msg> = column().push( checkbox( false ).on_toggle( Msg::TermsAccepted ) ).into();
+	let checked:   Element<Msg> = column().push( checkbox( true  ).on_toggle( Msg::TermsAccepted ) ).into();
+
+	for view in [ unchecked, checked ]
+	{
+		let surface = render_view( view );
+		let h = surface.handlers( surface.widget_rects()[ 0 ].flat_idx ).unwrap();
+		assert_eq!( h.press_msg(), Some( Msg::TermsAccepted ) );
+	}
+}
+
+// ── Radio ─────────────────────────────────────────────────────────────────────
+
+#[ test ]
+fn radio_handler_carries_on_select_message()
+{
+	let view: Element<Msg> = column()
+		.push( radio( false ).on_select( Msg::PriorityHigh ).label( "High" ) )
+		.into();
+	let surface = render_view( view );
+
+	let idx = surface.widget_rects()[ 0 ].flat_idx;
+	let h = surface.handlers( idx ).unwrap();
+	assert!( matches!( h, WidgetHandlers::Radio { on_select: Some( _ ) } ) );
+	assert_eq!( h.press_msg(), Some( Msg::PriorityHigh ) );
+}
+
+#[ test ]
+fn three_radios_each_route_to_their_own_message()
+{
+	#[ derive( Clone, Debug, PartialEq ) ]
+	enum Choice { Low, Medium, High }
+
+	let view: Element<Choice> = column()
+		.push( radio( false ).on_select( Choice::Low    ) )
+		.push( radio( false ).on_select( Choice::Medium ) )
+		.push( radio( true  ).on_select( Choice::High   ) )
+		.into();
+
+	let mut surface = UiSurface::<Choice>::new( 240, 240 );
+	let _ = surface.render( &view, RenderOptions::full_canvas( 240, 240 ) );
+
+	let messages: Vec<_> = surface.widget_rects().iter()
+		.map( |w| surface.handlers( w.flat_idx ).and_then( |h| h.press_msg() ) )
+		.collect();
+	assert_eq!(
+		messages,
+		vec![ Some( Choice::Low ), Some( Choice::Medium ), Some( Choice::High ) ],
+	);
+}
+
+// ── Slider ────────────────────────────────────────────────────────────────────
+
+#[ test ]
+fn slider_handler_variant_is_slider()
+{
+	let view: Element<Msg> = column()
+		.push( slider( 0.5 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+
+	let h = surface.handlers( surface.widget_rects()[ 0 ].flat_idx ).unwrap();
+	assert!( h.is_slider() );
+	assert!( !h.is_text_input() );
+}
+
+#[ test ]
+fn slider_change_msg_wraps_value_through_callback()
+{
+	let view: Element<Msg> = column()
+		.push( slider( 0.0 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+
+	let h = surface.handlers( surface.widget_rects()[ 0 ].flat_idx ).unwrap();
+	assert_eq!( h.slider_change_msg( 0.0  ), Some( Msg::Brightness( 0.0  ) ) );
+	assert_eq!( h.slider_change_msg( 0.5  ), Some( Msg::Brightness( 0.5  ) ) );
+	assert_eq!( h.slider_change_msg( 1.0  ), Some( Msg::Brightness( 1.0  ) ) );
+}
+
+#[ test ]
+fn slider_value_from_pos_at_left_edge_is_zero()
+{
+	let view: Element<Msg> = column()
+		.push( slider( 0.5 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+
+	let w = &surface.widget_rects()[ 0 ];
+	let left = Point { x: w.rect.x, y: w.rect.y + w.rect.height * 0.5 };
+	let v    = w.handlers.slider_value_from_pos( w.rect, left );
+	assert!( ( v - 0.0 ).abs() < 1e-3 );
+}
+
+#[ test ]
+fn slider_value_from_pos_at_right_edge_is_one()
+{
+	let view: Element<Msg> = column()
+		.push( slider( 0.5 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+
+	let w = &surface.widget_rects()[ 0 ];
+	let right = Point { x: w.rect.x + w.rect.width, y: w.rect.y + w.rect.height * 0.5 };
+	let v     = w.handlers.slider_value_from_pos( w.rect, right );
+	assert!( ( v - 1.0 ).abs() < 1e-3 );
+}
+
+#[ test ]
+fn slider_value_from_pos_at_midpoint_is_one_half()
+{
+	let view: Element<Msg> = column()
+		.push( slider( 0.0 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+
+	let w = &surface.widget_rects()[ 0 ];
+	let mid = Point
+	{
+		x: w.rect.x + w.rect.width  * 0.5,
+		y: w.rect.y + w.rect.height * 0.5,
+	};
+	let v = w.handlers.slider_value_from_pos( w.rect, mid );
+	assert!( ( v - 0.5 ).abs() < 1e-3 );
+}
+
+#[ test ]
+fn slider_value_from_pos_clamps_outside_rect()
+{
+	// Pointer way outside the rect on either side must clamp to 0 or 1.
+	let view: Element<Msg> = column()
+		.push( slider( 0.5 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+
+	let w = &surface.widget_rects()[ 0 ];
+	let far_left  = Point { x: w.rect.x - 200.0, y: w.rect.y + 10.0 };
+	let far_right = Point { x: w.rect.x + w.rect.width + 200.0, y: w.rect.y + 10.0 };
+
+	assert_eq!( w.handlers.slider_value_from_pos( w.rect, far_left  ), 0.0 );
+	assert_eq!( w.handlers.slider_value_from_pos( w.rect, far_right ), 1.0 );
+}
+
+// Bonus: confirm slider_value_from_pos returns 0.0 for non-slider variants —
+// gives the gesture state machine a safe fallback when a slider handler gets
+// swapped out mid-gesture.
+#[ test ]
+fn slider_value_from_pos_returns_zero_for_non_slider_handler()
+{
+	use ltk::button;
+	let view: Element<Msg> = column()
+		.push( button( "go" ).on_press( Msg::WifiToggled ) )
+		.into();
+	let surface = render_view( view );
+
+	let w = &surface.widget_rects()[ 0 ];
+	let mid = Point
+	{
+		x: w.rect.x + w.rect.width * 0.5,
+		y: w.rect.y + w.rect.height * 0.5,
+	};
+	assert_eq!( w.handlers.slider_value_from_pos( w.rect, mid ), 0.0 );
+}
+
+// ── SliderAxis sanity ─────────────────────────────────────────────────────────
+
+#[ test ]
+fn slider_axis_enum_is_publicly_exposed()
+{
+	// Compile-time guard: SliderAxis must remain a publicly-named enum so
+	// downstream apps can match on it (e.g. when wrapping value_from_pos
+	// for a custom hit area).
+	let _ = SliderAxis::Horizontal;
+	let _ = SliderAxis::Vertical;
+}
+
+// Bonus: ensure the rect from layout has non-zero size so the value tests
+// above are meaningful (if rect.width were 0 every position lookup would
+// degenerate to 0 / 0).
+#[ test ]
+fn slider_layout_rect_has_non_zero_width()
+{
+	let view: Element<Msg> = column()
+		.push( slider( 0.5 ).on_change( |v| Msg::Brightness( v ) ) )
+		.into();
+	let surface = render_view( view );
+	let w: Rect = surface.widget_rects()[ 0 ].rect;
+	assert!( w.width > 0.0 );
+	assert!( w.height > 0.0 );
+}