widgetkit-core 0.2.1

Core types, geometry, and shared primitives for WidgetKit.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134

# WidgetKit


---

language: English, [Russian](README.ru.md)

---
[![Version](https://img.shields.io/badge/version-0.2.1-blue)](#)
[![Platform](https://img.shields.io/badge/platform-Windows-lightgrey)](#)
[![Renderer](https://img.shields.io/badge/renderer-software%202D-lightgrey)](#)
[![Status](https://img.shields.io/badge/status-render%20v0.2-green)](#)

Modular Rust library for building desktop widgets.

Current scope: software 2D rendering on Windows with a demand-driven redraw model and an internal render pipeline
behind the public `Canvas` API.

Core assembly: `Widget + Canvas + WindowsHost + WidgetApp`.

For the full release history, see [CHANGELOG.md](CHANGELOG.md).

## Overview


- `Canvas` — public drawing API
- rendering goes through an internal command pipeline
- the runtime owns widget lifecycle, scheduler, tasks, and redraw invalidation
- the Windows host supports decorated and frameless windows

## Quick Start


```rust
use widgetkit::prelude::*;

fn main() -> widgetkit::Result<()> {
    WidgetApp::new()
        .widget("clock", ClockWidget)
        .host(
            WindowsHost::new()
                .with_size(Size::new(360.0, 135.0))
                .with_standard_top_bar(true),
        )
        .renderer(SoftwareRenderer::new())
        .run()
}
```

## Example Widget


```rust
use widgetkit::prelude::*;

struct MyWidget;

impl Widget for MyWidget {
    type State = ();
    type Message = ();

    fn mount(&mut self, _ctx: &mut MountCtx<Self>) -> Self::State {}

    fn render(&self, _state: &Self::State, canvas: &mut Canvas, _ctx: &RenderCtx<Self>) {
        canvas.clear(Color::rgb(14, 17, 22));
        canvas.save();
        canvas.clip_rect(Rect::xywh(12.0, 12.0, 220.0, 72.0));
        canvas.round_rect(
            Rect::xywh(12.0, 12.0, 220.0, 72.0),
            16.0,
            Color::rgb(30, 36, 48),
        );
        canvas.text(
            Point::new(24.0, 28.0),
            "Hello",
            TextStyle::new().size(16.0),
            Color::rgb(127, 160, 255),
        );
        canvas.circle(Point::new(206.0, 28.0), 6.0, Color::rgb(127, 160, 255));
        canvas.restore();
    }
}
```

## Examples


```bash
cargo run --example clock --features "windows canvas"
cargo run --example pulse --features "windows canvas"
```

With the Tokio-backed task runtime:

```bash
cargo run --example clock --features "windows canvas runtime-tokio"
```

## Features


- `canvas`
- `windows`
- `runtime-tokio`

```toml
[dependencies]
widgetkit = { version = "0.2.1", default-features = false, features = ["windows", "canvas"] }
```

## Workspace Layout


```text
widgetkit/
  crates/
    widgetkit
    widgetkit-core
    widgetkit-runtime
    widgetkit-render
    widgetkit-host-windows
```

- `widgetkit` - top-level facade crate
- `widgetkit-core` - geometry, colors, ids, errors, host events
- `widgetkit-runtime` - lifecycle, scheduler, tasks, redraw coordination
- `widgetkit-render` - `Canvas`, text styles, software renderer
- `widgetkit-host-windows` - Windows host built on `winit` and `softbuffer`

## Roadmap


- stable window sizing and configuration APIs
- richer image and text pipelines
- declarative UI and layout
- broader input model
- GPU renderer backend
- hybrid and web-backed integration paths

## License


MIT