Astrelis

A low-level native application and graphics runtime for Rust.

Release candidate: the rewritten Astrelis architecture is preparing for 0.3.0-rc.1. It is intentionally incompatible with the pre-rewrite 0.2.x crates. See MIGRATION-0.3.md before upgrading.

Use the complete façade:

[dependencies]
astrelis = "=0.3.0-rc.1"

Applications may instead depend on individual astrelis-* crates to keep their dependency graph focused.

Astrelis is being rebuilt methodically from a small foundation. The current workspace contains:

• astrelis-app: shared timers, wakeups, invalidation, and frame scheduling;
• astrelis-core: shared math, color, geometry, IDs, and logging helpers;
• astrelis-gpu: backend-neutral GPU resources, commands, and surfaces;
• astrelis-gpu-wgpu: native and browser-WebGPU implementation plus the native GPU profiling bridge;
• astrelis-platform: backend-neutral windows, lifecycle, and input;
• astrelis-platform-winit: desktop and browser-canvas winit implementation;
• astrelis-platform-test: deterministic display-free scripted backend;
• astrelis-profiling: dependency-free CPU/GPU timeline profiling.
• astrelis-render: shared scene target, antialiasing, and frame statistics.
• astrelis-render-2d: batched sprites, atlases, cameras, and chunked tilemaps.
• astrelis-render-3d: reverse-Z lit meshes, materials, culling, and debug geometry.
• astrelis-ui-core: extensible retained widgets, Taffy layout, typed messages, capture/target/bubble input, semantics, controls, and display-list generation.
• astrelis-ui-widgets: reusable drag/drop, split, navigation, virtualization, and texture-backed render-view compositions.
• astrelis-ui-docking: serializable editor docking trees, retained panel hosts, tab/split drop policy, and in-window floating groups.
• astrelis-ui-host: native/browser window, WebGPU surface, retained painter, and compositor hosting with observable asynchronous browser initialization.
• astrelis-ui-testing: deterministic semantic actions and normalized semantic, inspection, and display-list snapshots.
• astrelis: umbrella façade over the complete rewritten engine.

Painting, text, and the first retained UI vertical slice are available as separately testable layers above the shared application runtime. The Painter supports solid and gradient brushes, vector paths and UI shapes, nested opacity, images, text, transforms, and clipping.

cargo fmt --all --check
cargo test --workspace --all-features
cargo clippy --workspace --all-targets --all-features -- -D warnings

Release preparation and the dependency-layer publication order are documented in RELEASING.md. The release helper defaults to a local package check and never publishes unless passed publish explicitly.

Profiling can be compiled without instrumentation:

cargo check -p astrelis-profiling --no-default-features

The retained settings UI also has a WebGPU/WASM build. See crates/astrelis-ui-core/README.md for the no-bundler wasm-bindgen workflow and current browser limitations.

Licensed under the MIT license. See LICENSE-MIT for details.