From 58797125724a511efd67b0907383f381c7f73504 Mon Sep 17 00:00:00 2001
From: Chris Brown <1731074+ccbrown@users.noreply.github.com>
Date: Sun, 29 Sep 2024 23:39:28 -0400
Subject: [PATCH] feat: fullscreen mouse events, calculator example
---
Cargo.toml | 1 +
README.md | 1 +
examples/README.md | 1 +
examples/calculator.rs | 408 ++++++++++++++++++
examples/images/calculator.png | Bin 0 -> 537848 bytes
packages/iocraft/src/component.rs | 32 +-
packages/iocraft/src/handler.rs | 19 +-
.../iocraft/src/hooks/use_terminal_events.rs | 111 ++++-
packages/iocraft/src/terminal.rs | 34 +-
9 files changed, 595 insertions(+), 12 deletions(-)
create mode 100644 examples/calculator.rs
create mode 100644 examples/images/calculator.png
diff --git a/Cargo.toml b/Cargo.toml
index bbcd34f..b9d11fd 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -22,3 +22,4 @@ anyhow = "1.0.89"
surf = { version = "2.3.2", default-features = false, features = ["h1-client"] }
serde = { version = "1.0.210", features = ["derive"] }
serde_json = "1.0.128"
+mexprp = { version = "0.3.1", default-features = false }
diff --git a/README.md b/README.md
index fa265a0..1e558c4 100644
--- a/README.md
+++ b/README.md
@@ -97,6 +97,7 @@ forms, and more!
+
## Shoutouts
diff --git a/examples/README.md b/examples/README.md
index 1118d52..55dec85 100644
--- a/examples/README.md
+++ b/examples/README.md
@@ -9,6 +9,7 @@ To run any of the examples, use `cargo run --example NAME`. For example, to run
|Example|Preview|
|---|:---:|
|[borders.rs](./borders.rs)
Showcases various border styles.||
+|[calculator.rs](./calculator.rs)
Uses clickable buttons to provide a calculator app with light/dark mode themes.||
|[context.rs](./context.rs)
Demonstrates using a custom context via `ContextProvider` and `use_context`.||
|[counter.rs](./counter.rs)
Renders a dynamic component which spawns a future to increment a counter every 100ms.||
|[form.rs](./form.rs)
Displays a form prompting the user for input into multiple text fields. Uses mutable reference props to surface the user's input to the caller once the form is submitted.||
diff --git a/examples/calculator.rs b/examples/calculator.rs
new file mode 100644
index 0000000..6dca576
--- /dev/null
+++ b/examples/calculator.rs
@@ -0,0 +1,408 @@
+use iocraft::prelude::*;
+
+#[derive(Clone, Copy, Default)]
+enum Theme {
+ #[default]
+ Dark,
+ Light,
+}
+
+#[derive(Clone, Copy)]
+struct ButtonStyle {
+ color: Color,
+ text_color: Color,
+ trim_color: Color,
+}
+
+// https://www.ditig.com/publications/256-colors-cheat-sheet
+impl Theme {
+ fn toggled(&self) -> Self {
+ match self {
+ Self::Dark => Self::Light,
+ Self::Light => Self::Dark,
+ }
+ }
+
+ fn background_color(&self) -> Color {
+ match self {
+ Self::Dark => Color::AnsiValue(237),
+ Self::Light => Color::AnsiValue(253),
+ }
+ }
+
+ fn footer_background_color(&self) -> Color {
+ match self {
+ Self::Dark => Color::AnsiValue(253),
+ Self::Light => Color::AnsiValue(237),
+ }
+ }
+
+ fn footer_text_color(&self) -> Color {
+ match self {
+ Self::Dark => Color::AnsiValue(237),
+ Self::Light => Color::AnsiValue(253),
+ }
+ }
+
+ fn screen_color(&self) -> Color {
+ Color::AnsiValue(68)
+ }
+
+ fn screen_text_color(&self) -> Color {
+ Color::AnsiValue(231)
+ }
+
+ fn screen_trim_color(&self) -> Color {
+ Color::AnsiValue(75)
+ }
+
+ fn numpad_button_style(&self) -> ButtonStyle {
+ match self {
+ Self::Dark => ButtonStyle {
+ color: Color::AnsiValue(239),
+ text_color: Color::AnsiValue(231),
+ trim_color: Color::AnsiValue(243),
+ },
+ Self::Light => ButtonStyle {
+ color: Color::AnsiValue(251),
+ text_color: Color::AnsiValue(16),
+ trim_color: Color::AnsiValue(255),
+ },
+ }
+ }
+
+ fn operator_button_style(&self) -> ButtonStyle {
+ ButtonStyle {
+ color: Color::AnsiValue(172),
+ text_color: Color::AnsiValue(231),
+ trim_color: Color::AnsiValue(215),
+ }
+ }
+
+ fn clear_button_style(&self) -> ButtonStyle {
+ ButtonStyle {
+ color: Color::AnsiValue(161),
+ text_color: Color::AnsiValue(231),
+ trim_color: Color::AnsiValue(205),
+ }
+ }
+
+ fn fn_button_style(&self) -> ButtonStyle {
+ ButtonStyle {
+ color: Color::AnsiValue(66),
+ text_color: Color::AnsiValue(231),
+ trim_color: Color::AnsiValue(115),
+ }
+ }
+}
+
+#[derive(Default, Props)]
+struct ScreenProps {
+ content: String,
+}
+
+#[component]
+fn Screen(hooks: Hooks, props: &ScreenProps) -> impl Into> {
+ let theme = hooks.use_context::();
+ element! {
+ Box(
+ width: 100pct,
+ border_style: BorderStyle::Custom(BorderCharacters {
+ top: '▁',
+ ..Default::default()
+ }),
+ border_edges: Edges::Top,
+ border_color: theme.screen_trim_color(),
+ ) {
+ Box(
+ width: 100pct,
+ background_color: theme.screen_color(),
+ padding: 1,
+ justify_content: JustifyContent::End,
+ ) {
+ Text(
+ content: &props.content,
+ align: TextAlign::Right,
+ color: theme.screen_text_color(),
+ )
+ }
+ }
+ }
+}
+
+#[derive(Default, Props)]
+struct ButtonProps {
+ label: String,
+ style: Option,
+ on_click: Handler<'static, ()>,
+}
+
+#[component]
+fn Button(props: &mut ButtonProps, mut hooks: Hooks) -> impl Into> {
+ let style = props.style.unwrap();
+
+ hooks.use_local_terminal_events({
+ let mut on_click = std::mem::take(&mut props.on_click);
+ move |event| match event {
+ TerminalEvent::FullscreenMouse(FullscreenMouseEvent { kind, .. })
+ if matches!(kind, MouseEventKind::Down(_)) =>
+ {
+ on_click(());
+ }
+ _ => {}
+ }
+ });
+
+ element! {
+ Box(
+ border_style: BorderStyle::Custom(BorderCharacters {
+ top: '▁',
+ ..Default::default()
+ }),
+ border_edges: Edges::Top,
+ border_color: style.trim_color,
+ flex_grow: 1.0,
+ margin_left: 1,
+ margin_right: 1,
+ ) {
+ Box(
+ background_color: style.color,
+ justify_content: JustifyContent::Center,
+ align_items: AlignItems::Center,
+ height: 3,
+ flex_grow: 1.0,
+ ) {
+ Text(
+ content: &props.label,
+ color: style.text_color,
+ weight: Weight::Bold,
+ )
+ }
+ }
+ }
+}
+
+#[component]
+fn Calculator(mut hooks: Hooks) -> impl Into> {
+ let theme = hooks.use_context::();
+ let numpad_button_style = theme.numpad_button_style();
+ let operator_button_style = theme.operator_button_style();
+ let fn_button_style = theme.fn_button_style();
+ let expr = hooks.use_state(|| "0".to_string());
+ let clear_on_number = hooks.use_state(|| true);
+
+ let handle_backspace = move || {
+ let new_expr = expr
+ .read()
+ .chars()
+ .take(expr.read().len() - 1)
+ .collect::();
+ if new_expr.is_empty() {
+ expr.set("0".to_string());
+ clear_on_number.set(true);
+ } else {
+ expr.set(new_expr);
+ clear_on_number.set(false);
+ }
+ };
+
+ let handle_number = move |n: u8| {
+ if clear_on_number.get() {
+ expr.set(n.to_string());
+ clear_on_number.set(false);
+ } else {
+ expr.set(expr.to_string() + &n.to_string());
+ }
+ };
+
+ let handle_decimal = move || {
+ if clear_on_number.get() {
+ expr.set("0.".to_string());
+ clear_on_number.set(false);
+ } else if expr.read().chars().last() != Some('.') {
+ expr.set(expr.to_string() + ".");
+ }
+ };
+
+ let handle_clear = move || {
+ expr.set("0".to_string());
+ clear_on_number.set(true);
+ };
+
+ let has_trailing_operator = matches!(
+ expr.read().chars().last(),
+ Some('+') | Some('-') | Some('×') | Some('÷')
+ );
+
+ let handle_operator = move |op: char| {
+ if clear_on_number.get() {
+ clear_on_number.set(false);
+ }
+ if !has_trailing_operator {
+ expr.set(expr.to_string() + &op.to_string());
+ }
+ };
+
+ let handle_percent = move || {
+ if clear_on_number.get() {
+ clear_on_number.set(false);
+ }
+ if !has_trailing_operator {
+ expr.set(expr.to_string() + "%");
+ }
+ };
+
+ let handle_plus_minus = move || {
+ if clear_on_number.get() {
+ clear_on_number.set(false);
+ }
+ if !has_trailing_operator {
+ expr.set(format!("-({})", expr));
+ }
+ };
+
+ let handle_equals = move || {
+ if let Ok(f) = mexprp::eval::(&expr.to_string()) {
+ expr.set(f.to_string());
+ clear_on_number.set(true);
+ }
+ };
+
+ hooks.use_terminal_events({
+ move |event| match event {
+ TerminalEvent::Key(KeyEvent { code, kind, .. }) if kind != KeyEventKind::Release => {
+ match code {
+ KeyCode::Char('/') => handle_operator('÷'),
+ KeyCode::Char('*') => handle_operator('×'),
+ KeyCode::Char('+') => handle_operator('+'),
+ KeyCode::Char('-') => handle_operator('-'),
+ KeyCode::Char('0') => handle_number(0),
+ KeyCode::Char('1') => handle_number(1),
+ KeyCode::Char('2') => handle_number(2),
+ KeyCode::Char('3') => handle_number(3),
+ KeyCode::Char('4') => handle_number(4),
+ KeyCode::Char('5') => handle_number(5),
+ KeyCode::Char('6') => handle_number(6),
+ KeyCode::Char('7') => handle_number(7),
+ KeyCode::Char('8') => handle_number(8),
+ KeyCode::Char('9') => handle_number(9),
+ KeyCode::Char('.') => handle_decimal(),
+ KeyCode::Char('%') => handle_percent(),
+ KeyCode::Char('=') | KeyCode::Enter => handle_equals(),
+ KeyCode::Backspace => handle_backspace(),
+ KeyCode::Char('c') => handle_clear(),
+ _ => {}
+ }
+ }
+ _ => {}
+ }
+ });
+
+ element! {
+ Box(
+ width: 100pct,
+ height: 100pct,
+ flex_direction: FlexDirection::Column,
+ padding_left: 1,
+ padding_right: 1,
+ ) {
+ Box(
+ padding_left: 1,
+ padding_right: 1,
+ ) {
+ Screen(content: expr.to_string())
+ }
+ Box(width: 100pct) {
+ Button(label: "←", style: fn_button_style, on_click: move |_| handle_backspace())
+ Button(label: "±", style: fn_button_style, on_click: move |_| handle_plus_minus())
+ Button(label: "%", style: fn_button_style, on_click: move |_| handle_percent())
+ Button(label: "÷", style: operator_button_style, on_click: move |_| handle_operator('÷'))
+ }
+ Box(width: 100pct) {
+ Button(label: "7", style: numpad_button_style, on_click: move |_| handle_number(7))
+ Button(label: "8", style: numpad_button_style, on_click: move |_| handle_number(8))
+ Button(label: "9", style: numpad_button_style, on_click: move |_| handle_number(9))
+ Button(label: "×", style: operator_button_style, on_click: move |_| handle_operator('×'))
+ }
+ Box(width: 100pct) {
+ Button(label: "4", style: numpad_button_style, on_click: move |_| handle_number(4))
+ Button(label: "5", style: numpad_button_style, on_click: move |_| handle_number(5))
+ Button(label: "6", style: numpad_button_style, on_click: move |_| handle_number(6))
+ Button(label: "-", style: operator_button_style, on_click: move |_| handle_operator('-'))
+ }
+ Box(width: 100pct) {
+ Button(label: "1", style: numpad_button_style, on_click: move |_| handle_number(1))
+ Button(label: "2", style: numpad_button_style, on_click: move |_| handle_number(2))
+ Button(label: "3", style: numpad_button_style, on_click: move |_| handle_number(3))
+ Button(label: "+", style: operator_button_style, on_click: move |_| handle_operator('+'))
+ }
+ Box(width: 100pct) {
+ Button(label: "C", style: theme.clear_button_style(), on_click: move |_| handle_clear())
+ Button(label: "0", style: numpad_button_style, on_click: move |_| handle_number(0))
+ Button(label: ".", style: numpad_button_style, on_click: move |_| handle_decimal())
+ Button(label: "=", style: operator_button_style, on_click: move |_| handle_equals())
+ }
+ }
+ }
+}
+
+#[component]
+fn App(mut hooks: Hooks) -> impl Into> {
+ let (width, height) = hooks.use_terminal_size();
+ let mut system = hooks.use_context_mut::();
+ let should_exit = hooks.use_state(|| false);
+ let theme = hooks.use_state(|| Theme::default());
+
+ hooks.use_terminal_events({
+ move |event| match event {
+ TerminalEvent::Key(KeyEvent { code, kind, .. }) if kind != KeyEventKind::Release => {
+ match code {
+ KeyCode::Char('q') => should_exit.set(true),
+ KeyCode::Char('t') => theme.set(theme.get().toggled()),
+ _ => {}
+ }
+ }
+ _ => {}
+ }
+ });
+
+ if should_exit.get() {
+ system.exit();
+ }
+
+ element! {
+ Box(
+ // subtract one in case there's a scrollbar
+ width: width - 1,
+ height: height,
+ background_color: theme.get().background_color(),
+ flex_direction: FlexDirection::Column,
+ gap: 1,
+ ) {
+ Box(
+ flex_grow: 1.0,
+ ) {
+ Box(
+ max_width: 120,
+ max_height: 40,
+ flex_grow: 1.0,
+ ) {
+ ContextProvider(value: Context::owned(theme.get())) {
+ Calculator
+ }
+ }
+ }
+ Box(
+ height: 1,
+ background_color: theme.get().footer_background_color(),
+ padding_left: 1,
+ ) {
+ Text(content: "[T] Toggle Theme [Q] Quit", color: theme.get().footer_text_color())
+ }
+ }
+ }
+}
+
+fn main() {
+ smol::block_on(element!(App).fullscreen()).unwrap();
+}
diff --git a/examples/images/calculator.png b/examples/images/calculator.png
new file mode 100644
index 0000000000000000000000000000000000000000..2b809f0c2f1d850bad57c7b6c1cdd367487fd291
GIT binary patch
literal 537848
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