README.ru.md

WidgetKit

---

language: English, Russian

---

Модульная Rust-библиотека для небольших desktop-виджетов.

Текущий охват: software 2D рендеринг на Windows с настройкой окна, content-driven sizing и измерением layout под публичным Canvas API.

Базовая сборка: Widget + Canvas + WindowsHost + WidgetApp.

Подробная история релизов в CHANGELOG.md.

Обзор

• Canvas - стабильный drawing API
• demand-driven redraw и layout invalidation
• WindowConfig и Windows host flags для frameless, transparent, resizable, visible и always-on-top окон
• SizePolicy для fixed и content-driven sizing
• LayoutCtx::measure_text(...) для расчёта preferred size
• software 2D renderer поверх внутреннего render pipeline

Быстрый старт

use widgetkit::prelude::*;

fn main() -> widgetkit::Result<()> {
    WidgetApp::new()
        .widget("clock", ClockWidget)
        .host(
            WindowsHost::new()
                .size_policy(SizePolicy::ContentWithLimits {
                    min: Some(Size::new(280.0, 112.0)),
                    max: Some(Size::new(520.0, 180.0)),
                })
                .frameless(true)
                .transparent(true)
                .always_on_top(true),
        )
        .renderer(SoftwareRenderer::new())
        .run()
}

Пример виджета

use widgetkit::prelude::*;

struct MyWidget;

struct MyState {
    label: String,
}

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

    fn mount(&mut self, _ctx: &mut MountCtx<Self>) -> Self::State {
        MyState {
            label: "Hello WidgetKit".to_string(),
        }
    }

    fn preferred_size(&self, state: &Self::State, ctx: &LayoutCtx<Self>) -> Size {
        let label = ctx.measure_text(&state.label, TextStyle::new().size(16.0));
        ctx.constrain(Size::new(label.width + 48.0, label.height + 48.0))
    }

    fn render(&self, state: &Self::State, canvas: &mut Canvas, ctx: &RenderCtx<Self>) {
        let size = ctx.surface_size();

        canvas.clear(Color::rgba(0, 0, 0, 0));
        canvas.round_rect(
            Rect::xywh(8.0, 8.0, size.width - 16.0, size.height - 16.0),
            16.0,
            Color::rgb(30, 36, 48),
        );
        canvas.text(
            Point::new(24.0, 28.0),
            &state.label,
            TextStyle::new().size(16.0),
            Color::rgb(127, 160, 255),
        );
    }
}

Примеры

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

С Tokio-backed task runtime:

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

Features

• canvas
• windows
• runtime-tokio

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

Структура workspace

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

• widgetkit - верхний facade crate
• widgetkit-core - геометрия, цвета, ids, ошибки, host events
• widgetkit-runtime - lifecycle, scheduler, tasks, layout/redraw coordination
• widgetkit-render - Canvas, text styles, measurement, software renderer
• widgetkit-host-windows - Windows host на базе winit и softbuffer

Roadmap

• declarative UI и layout
• расширенная input model
• стабилизация image pipeline
• GPU renderer backend
• hybrid и web-backed integration paths

License

MIT