Иконки Flare - это полиморфный тип-значение, а не один компонент. FlareIcon - абстрактный дескриптор; каждый провайдер - это конкретный FlareIcon, который подставляется в любой параметр типа FlareIcon (Icon у кнопки, элемент навигации, адорнмент поля, ...) или рисуется отдельно через <FlareIconView>.

По умолчанию все - inline-SVG: без иконочного шрифта, без сетевого запроса, без FOUT, и независимо от темы (иконки наследуют currentColor).

Все иконочные типы - в namespace Flare.Icons: FlareIcon, FlareSvgIcon и встроенный набор FlareIcons поставляются в небольшом пакете Flare.Icons; пакеты провайдеров ниже добавляют свои каталоги в тот же namespace. Добавьте using Flare.Icons (или @using Flare.Icons). Рендер-компонент FlareIconView - в Flare.Components.

Пакет Flare.Icons поставляет собственный SVG-набор без внешних зависимостей (FlareIcons, ~90 иконок), которым рисуется дефолтный хром компонентов (шевроны, close, сортировка, тогглы дерева, ...). Flare.Components зависит от него, так что все работает из коробки без дополнительных пакетов.

<FlareIconView Value="@FlareIcons.Home" />
<FlareIconButton Icon="@FlareIcons.Settings" AriaLabel="Settings" />

• Всегда ссылайтесь на иконку типизированным членом - поиска по имени-строке нет. Это намеренно: поиск по имени убил бы тримминг (пришлось бы держать весь каталог) и добавил бы рантайм-стоимость.
• FlareIcons.All и FlareIcons.Find(id) остаются как явный API каталога для встроенного набора (например, для страницы-браузера иконок); провайдерские (Material/Fluent) иконки они не резолвят.

Ядро не зависит ни от одного стороннего набора иконок. Подключайте только нужный пакет; каждый опционален.

• .Svg-пакеты самодостаточны (SVG-графика встроена) - грузить в рантайме нечего.
• .Symbols-пакеты рисуют <span>/<i> с классом шрифта провайдера; шрифт подключает хост-приложение (например, <link> на Google Fonts для Material Symbols или таблица стилей Font Awesome).

@* SVG-каталоги - самодостаточны *@
<FlareIconView Value="@MaterialDesign3Icons.Regular.Home" />
<FlareIconView Value="@MaterialDesign3Icons.Filled.Home" />   @* та же иконка, залитая *@
<FlareIconButton Icon="@FluentUIIcons.Regular.Settings" AriaLabel="Settings" />

@* Шрифтовые провайдеры - шрифт грузит хост; оси/стили - опции провайдера *@
<FlareIconView Value="@(new FlareMaterialDesign3Icon { Name = "home", Fill = true, Weight = 500 })" />
<FlareIconView Value="@(new FlareFontAwesomeIcon { Name = "house", Variant = FontAwesomeVariant.Solid })" />

.Svg-версия набора предпочтительна (самодостаточна, темизируема, без FOUT); .Symbols берите только когда вы и так грузите этот шрифт или вам нужны именно оси вариативного шрифта.

Что такое "Fluent UI 2"? У Microsoft один набор иконок - Fluent UI System Icons - поставляется здесь как FluentUIIcons. Это и есть набор иконок Fluent 2; отдельной библиотеки "FluentUI2" не существует.

Передайте любую SVG напрямую - path-данные или полную внутреннюю разметку - через FlareSvgIcon:

<FlareIconView Value="@(new FlareSvgIcon { Data = "M3 18h18v-2H3v2z" })" />
<FlareIconView Value="@(new FlareSvgIcon { Data = "<path .../><path .../>", ViewBox = "0 -960 960 960" })" />

Безопасность: FlareSvgIcon.Data (и Name любого шрифтового провайдера) выводится дословно. Передавайте только доверенные значения, написанные разработчиком - никогда не пользовательский ввод.

FlareIconView и каждый FlareIcon принимают Size (любая CSS-длина) или SizePx, и Color (роль FlareColor или кастомный цвет). Иначе иконки наследуют currentColor и совпадают с окружающим текстом.

<FlareIconView Value="@FlareIcons.Star" SizePx="32" Color="FlareColor.Primary" />
<FlareIconView Value="@FlareIcons.Bolt" Size="3rem" Color="@FlareColor.Custom("#FFB300")" />

По умолчанию смена Value заменяет глиф за один кадр. Morph превращает эту замену в переход: уходящий и приходящий глифы делят один бокс и меняются местами - именно этого хочет иконка-состояние (play/pause, menu/close, галочка после успеха), а не перерисовки.

<FlareIconView Value="@(_playing ? FlareIcons.Pause : FlareIcons.PlayArrow)" Morph="FlareIconMorph.Scale" />

Движение задает тема: --flare-icon-morph-duration, --flare-icon-morph-easing (кривая ДВИЖЕНИЯ - само затухание идет по стандартной кривой темы, чтобы пружина не обрывала его раньше времени), --flare-icon-morph-scale и --flare-icon-morph-rotate. Тема, которой нужна мгновенная смена иконок, паркует длительность; тема, которой Scale и Rotate нужны как чистое затухание, паркует два геометрических токена.

Если Morph не задан, режим берется из окружающей области - и приложение включает переходы на всю библиотеку прямо в корне, вместе с собственным хромом Flare: шеврон раскрывашки, каретка селекта и т.д.

<FlareThemeProvider IconMorph="FlareIconMorph.Scale">

Ограничить областью на странице можно обычным каскадом:

<CascadingValue TValue="FlareIconMorph?" Value="FlareIconMorph.Rotate"> ... </CascadingValue>

Явный Morph на месте вызова всегда сильнее - включая FlareIconMorph.None: так одна иконка выходит из включенной области.

Morph - это переход МЕЖДУ двумя иконками. FlareMorphIcon - другое: один элемент <path> остается в документе, а его геометрия интерполируется, поэтому форма перетекает, а не одна иконка растворяется в другой.

<FlareIconView Value="@(_open ? FlareMorphIcons.Minus : FlareMorphIcons.Plus)" />

Параметра Morph тут нет - переход несет сам тип иконки, и FlareIconView не трогает такую иконку даже при включенном режиме (кроссфейд заменил бы тот самый элемент, чью геометрию мы интерполируем).

Ограничение то же, из-за которого интерполяция путей невозможна для каталога в целом: у обоих контуров должен быть один список команд - те же команды в том же порядке, отличаются только координаты. В FlareMorphIcons пары нарисованы именно так (Plus/Minus, ChevronDown/ChevronUp); для своих рисуйте обе формы одним списком команд, добивая более простую вырожденными сегментами нулевой длины. Несовпадающая пара не дает ошибки - она просто дискретно переключится на середине.

Работает через CSS-свойство d, то есть без JavaScript. Геометрия отдается еще и атрибутом d, поэтому там, где браузер это свойство не поддерживает, иконка все равно рисуется, а смена просто происходит за кадр.

Каждая иконка каталога - отдельный static-член, а SVG-пакеты помечены IsTrimmable. Поэтому trimmed-публикация Blazor WebAssembly (дефолт в Release) выкидывает все члены каталога, на которые вы не ссылаетесь - вы платите только за реально используемые иконки.

• Ссылайтесь на иконки типизированным членом (MaterialDesign3Icons.Regular.Home), а не строкой. Static-член отслеживается IL-линкером; строковое имя - нет.
• Не "рутьте" весь каталог из всегда-загруженного кода (например, страница "показать все иконки", которая перечисляет тип рефлексией) - это удержит весь набор. Питайте такие страницы явным списком типизированных членов.

Замер на Flare Gallery: он ссылается на ~160 из 3894 Material Symbols, и trimmed-публикация ужимает Flare.Icons.MaterialDesign3.Svg с 8.9 MB до ~180 KB. Пакет, на который вы не ссылаетесь (например, FluentUI.Svg в этой сборке), не приезжает вообще.