iced-fluent-icons

A Rust proc-macro crate that embeds Microsoft Fluent UI SVG icons into an iced application with minimal LSP overhead.

---

How it works

The crate provides two complementary macros that split the work cleanly between IDE/LSP time and compile time:

Macro	When it runs	What it does
declare!()	LSP expansion	Emits lightweight stub functions — no include_bytes!, no byte arrays
#[inventory]	rustc compilation	Rewrites every stub call to inline SVG-loading code

---

Usage

1. Add the dependency

[dependencies]
iced-fluent-icons = "1.0"

2. Declare icons in a module

Call declare!() once in your icons module:

// src/icons/fluent.rs
fluentui_icons::declare!();

This generates one pub fn per SVG file. Each stub:

• carries a rustdoc image most modern IDEs show a preview on hover / signature-help
• has the correct return type ::iced::widget::Svg<'static> for type inference and completion
• has a panic! body — it is never executed because #[inventory] rewrites every call site

3. Annotate callers with #[inventory]

#[fluentui_icons::inventory]
fn toolbar() -> iced::Element<'_, Message> {
    let close = icons::fluent::dismiss_circle_color();
    // … more icon calls …
}

At compile time every zero-argument call whose last path segment matches a known icon name is replaced with:

{
    let bytes: &'static [u8] = include_bytes!("/abs/path/to/DismissCircleColor.svg");
    let handle = ::iced::widget::svg::Handle::from_memory(bytes);
    ::iced::widget::svg::<'static, ::iced::Theme>(handle).width(24).height(24)
}

All of the following call forms are handled identically:

dismiss_circle_color()                        // after `use icons::fluent::*`
fluent::dismiss_circle_color()
icons::fluent::dismiss_circle_color()
crate::icons::fluent::dismiss_circle_color()

#[inventory] can be applied to a fn, an impl block, or a mod.

---

Custom icon size

By default every icon is rendered at 24 × 24 px. Override this per annotated item with size, width, and/or height:

#[iced_fluent_icons::inventory(size = 32)]              // 32 × 32
#[iced_fluent_icons::inventory(width = 20, height = 48)] // 20 × 48
#[iced_fluent_icons::inventory(width = 20)]              // 20 × 24

---

Icon variants & feature flags

Icons ship in up to four variants. Use exclusion features to omit families you don't need, or inclusion features to keep only the families you do need.

Exclusion features

Feature	Excludes
no-filled	*Filled.svg icons
no-color	*Color.svg icons
no-regular	*Regular.svg icons
no-light	*Light.svg icons

[dependencies]
iced-fluent-icons = { version = "1.0", features = ["no-light", "no-color"] }

Inclusion features

Multiple only-* features may be combined.

Feature	Keeps only
only-filled	*Filled.svg icons
only-color	*Color.svg icons
only-regular	*Regular.svg icons
only-light	*Light.svg icons

# Keep only Regular and Filled — exclude Color and Light entirely.
[dependencies]
iced-fluent-icons = { version = "1.0", features = ["only-regular", "only-filled"] }

Both the declare! stub generator and the #[inventory] rewriter respect the same feature flags, so excluded icons are never embedded at all.

---

Icon naming

SVG filenames (UpperCamelCase) are converted to Rust function names (snake_case):

File	Function
AddRegular.svg	add_regular()
DismissCircleColor.svg	dismiss_circle_color()
AccessibilityCheckmarkFilled.svg	accessibility_checkmark_filled()
AlertUrgentRegular.svg	alert_urgent_regular()

---

How macro bodies inside widget macros are handled

#[inventory] also rewrites icon calls that appear inside iced widget macros such as column![], row![], and stack![]. The macro body is parsed as comma-separated expressions and each one is visited recursively, so the following works without extra annotations:

#[fluentui_icons::inventory]
fn sidebar() -> iced::Element<'_, Message> {
    iced::widget::column![
        icons::fluent::home_filled(),
        icons::fluent::settings_regular(),
    ]
    .into()
}

---

License

Licensed under either of

• Apache License, Version 2.0 (LICENSE-APACHE)
• MIT License (LICENSE-MIT)

at your option.