# Omni.Blazor — full API reference

> 206 components. NuGet `AndersonN.Omni.Blazor`, namespace `Omni.Blazor`. Every component inherits the common Omni surface: `Class` (string), `Style` (string) and `Attributes` (HTML splat) — these are omitted per-component below and apply everywhere. Form inputs (FormComponent<T>) also expose `Value`/`ValueChanged`/`ValueExpression`, `Disabled`, `ReadOnly`, `Name`, `Required`.

## Ai

### OmniAiConversation
Drop-in AI chat: binds to an OmniChatClient (which wraps any IChatClient) and composes the AI primitives — OmniMessage/OmniStreamingText for turns, OmniPromptInput for the composer.
_base: OmniComponent · source: src/Omni.Blazor.Ai/Components/Ai/OmniAiConversation.razor_

Parameters:
- `AssistantInitials`: string = AI — Avatar initials for assistant turns. Default "AI".
- `AssistantName`: string — Author name shown above assistant turns when ShowAuthor is on.
- `Client`: OmniChatClient *required* — The conversation orchestrator (wraps your IChatClient). Required.
- `Disabled`: bool = false — Disable the composer (e.g. while offline). Streaming auto-disables it too.
- `LogLabel`: string = Conversation — Accessible label for the message log. Default "Conversation".
- `Placeholder`: string — Placeholder for the composer.
- `SendLabel`: string = Send — Accessible label for the send button. Default "Send".
- `ShowAuthor`: bool = false — Show the author name above each message. Default false.
- `UserInitials`: string = U — Avatar initials for user turns. Default "U".
- `UserName`: string — Author name shown above user turns when ShowAuthor is on.
Slots:
- `EmptyContent`: RenderFragment — Shown in the log while the conversation is empty.
- `HeaderContent`: RenderFragment — Optional header slot (title, clear button, model picker — you own it).

### OmniCitation
Inline source citation badge ([n]) for AI answers — links to the reference and exposes the title/snippet on hover and to screen readers.
_base: OmniComponent · source: src/Omni.Blazor/Components/Ai/OmniCitation.razor_

Parameters:
- `Index`: int = 0 — Reference number rendered as [n] unless Text overrides it.
- `Snippet`: string — Optional excerpt appended to the tooltip.
- `Text`: string — Overrides the displayed label (default is [Index]).
- `Title`: string — Source title, shown in the tooltip and the accessible name.
- `Url`: string — Source URL. When set the badge becomes a link opening in a new tab.

### OmniMessage
A single chat message (user / assistant / system) with avatar, author and content (Markdown or streaming via OmniStreamingText), plus a footer slot for citations, reasoning or actions.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Ai/OmniMessage.razor_

Parameters:
- `Author`: string — Display name shown above the content.
- `AvatarInitials`: string — Avatar initials when no image is set.
- `AvatarUrl`: string — Avatar image URL (falls back to AvatarInitials).
- `Content`: string — Message text, rendered as Markdown via OmniStreamingText when no ChildContent is given.
- `Role`: MessageRole {User | Assistant | System} = Assistant — Who sent the message — drives the layout/styling. Default Assistant.
- `Streaming`: bool = false — When true, the content shows the streaming caret (assistant still typing).
Slots:
- `AvatarContent`: RenderFragment — Custom avatar markup; overrides the default OmniAvatar.
- `Footer`: RenderFragment — Footer slot for citations (OmniCitation), reasoning (OmniThinkingBlock) or actions.

### OmniPromptInput
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Ai/OmniPromptInput.razor_

Parameters:
- `AriaLabel`: string — Accessible label for the textarea (falls back to Placeholder).
- `MaxLength`: int — Optional maximum length; when set the counter shows count/max.
- `Placeholder`: string — Placeholder shown in the empty composer.
- `Rows`: int = 3 — Initial visible rows of the textarea. Default 3.
- `SendLabel`: string = Send — Accessible label for the send button. Default "Send".
Events:
- `OnSend`: EventCallback<string> — Fired with the prompt text when the user sends (Ctrl/Cmd+Enter or the send button).
Slots:
- `Actions`: RenderFragment — Extra action controls rendered left of the send button (e.g. a voice button).

### OmniStreamingText
Renders an assistant response as it streams in — accumulating Markdown (or plain text) with a blinking caret while Streaming is true.
_base: OmniComponent · source: src/Omni.Blazor/Components/Ai/OmniStreamingText.razor_

Parameters:
- `Caret`: bool = true — Show the blinking caret while streaming. Default true.
- `Markdown`: bool = true — Render Text as Markdown (default) or as plain text.
- `Placeholder`: string — Optional text shown while streaming before any content has arrived (e.g. "Thinking…").
- `Streaming`: bool = false — When true, shows the blinking caret and marks the region aria-busy for screen readers.
- `Text`: string — The accumulated response text. Update it as tokens arrive to stream the answer in.

### OmniSuggestionChips
A row of clickable suggestion chips (follow-up questions / quick replies) for an AI conversation.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Ai/OmniSuggestionChips.razor_

Parameters:
- `AriaLabel`: string = Suggestions — Accessible label for the chip group. Default "Suggestions".
- `Icon`: string — Optional icon name shown on every suggestion chip.
- `Suggestions`: IEnumerable<string> — The suggestion labels to render as chips. Each fires OnSelect with its text.
Events:
- `OnSelect`: EventCallback<string> — Fired with the chosen suggestion's text when a chip is clicked.

### OmniThinkingBlock
Collapsible reasoning / "thinking" block for AI answers — collapsed by default; expand to reveal the model's chain of thought or tool steps.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Ai/OmniThinkingBlock.razor_

Parameters:
- `Expanded`: bool = false — Expanded state; supports two-way binding via ExpandedChanged. Default collapsed.
- `Title`: string = Reasoning — Toggle label. Default "Reasoning".
Events:
- `ExpandedChanged`: EventCallback<bool> — Fired when the block expands or collapses, carrying the new state.

## Buttons

### OmniButton
The library's base button: leading/trailing icons, variants, sizes, block, icon-only and loading states.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Buttons/OmniButton.razor_

Parameters:
- `Block`: bool = false — Stretches the button to full container width. Default false.
- `Disabled`: bool = false — Disables the button (also disabled while Loading). Default false.
- `Icon`: string — Name of the leading OmniIcon shown before the label.
- `IconOnly`: bool = false — Renders a square icon-only button (no label spacing). Default false.
- `Loading`: bool = false — When true, renders an inline OmniSpinner in place of the leading icon, disables click and sets aria-busy="true". Width is preserved so the surrounding layout doesn't shift.
- `LoadingText`: string — Optional alternate label shown while Loading is true.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Button size (Sm/Md/Lg/Xl). Default Md.
- `Text`: string — Label text, rendered when no ChildContent is provided.
- `TrailingIcon`: string — Name of the trailing OmniIcon shown after the label.
- `Type`: string = button — The native type attribute (button/submit/reset). Default "button".
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Default — Visual variant (Primary/Ghost/Danger/Link). Default Default.
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Click handler; not invoked while Disabled or Loading.

### OmniFab
Floating Action Button (FAB) — botão circular ancorado num canto da viewport pra ação primária de uma tela.
_base: OmniComponent · source: src/Omni.Blazor/Components/Buttons/OmniFab.razor_

Parameters:
- `AriaLabel`: string — aria-label custom. Fallback: Title → Text.
- `Disabled`: bool = false
- `Icon`: string = plus — Ícone do FAB. Default "plus" (ação "criar novo").
- `Position`: FabPosition {BottomRight | BottomLeft | TopRight | TopLeft | BottomCenter | Static} = BottomRight — Canto da viewport onde o FAB ancora. Default BottomRight.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Lg — Tamanho. Default Lg — FAB é proeminente por convenção.
- `Text`: string — Texto opcional. Se setado, renderiza Extended FAB (pill alongado). Vazio = FAB circular icon-only (clássico Material).
- `Title`: string — Tooltip. Use sempre — FAB icon-only sem tooltip é a11y ruim.
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Primary — Variant do botão. Default Primary (cor accent — chama atenção).
Events:
- `OnClick`: EventCallback<MouseEventArgs>

### OmniFabMenu
FAB com menu expansível — clique no botão principal pra mostrar/esconder itens (OmniFabMenuItem).
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Buttons/OmniFabMenu.razor_

Parameters:
- `Animation`: FabMenuAnimation {Stagger | Linear | None} = Stagger — Modo de animação de abertura. Default Stagger (pop-in cascading, padrão Material). Linear = fade simples estilo Radzen. None = sem animação.
- `AriaLabel`: string — aria-label do grupo. Use pra nomear semanticamente o speed dial.
- `CloseOnEsc`: bool = true — Fecha o menu quando o user pressiona Escape. Default true.
- `CloseOnItemClick`: bool = true — Fecha o menu quando um OmniFabMenuItem filho é clicado. Default true — comportamento usual de speed dial.
- `CloseOnOutsideClick`: bool = true — Fecha o menu quando o user clica fora dele. Default true.
- `Direction`: FabMenuDirection {Up | Down | Left | Right} = Up — Direção em que os items se expandem. Default Up (combina com posições Bottom*).
- `Disabled`: bool = false
- `Icon`: string = plus — Ícone do FAB quando o menu está fechado. Default "plus".
- `IsOpen`: bool = false — Two-way bound. Pode ser controlado externamente.
- `OpenIcon`: string = x — Ícone do FAB quando o menu está aberto. Default "x" (padrão Material — close icon indica "agora fecha").
- `OpenTitle`: string — Tooltip quando aberto. Default "Fechar menu".
- `Position`: FabPosition {BottomRight | BottomLeft | TopRight | TopLeft | BottomCenter | Static} = BottomRight — Canto da viewport onde o FAB ancora. Default BottomRight.
- `ShowBackdrop`: bool = false — Mostra um backdrop semi-transparente que cobre a tela quando o menu está aberto. Default false — speed dial clássico não usa, mas em mobile pode focar a atenção.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Lg — Tamanho. Default Lg.
- `Title`: string — Tooltip quando fechado. Default "Abrir menu".
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Primary — Variant do FAB. Default Primary.
Events:
- `IsOpenChanged`: EventCallback<bool>
Slots:
- `ChildContent`: RenderFragment

### OmniFabMenuItem
Item dentro de um OmniFabMenu — botão circular menor com label opcional ao lado (padrão Material: tooltip-style label flutuante).
_base: OmniComponent · source: src/Omni.Blazor/Components/Buttons/OmniFabMenuItem.razor_

Parameters:
- `AriaLabel`: string — aria-label. Fallback: Title → Label.
- `Disabled`: bool = false
- `Icon`: string *required* = circle — Ícone do item. Obrigatório (FAB items são icon-first).
- `Label`: string — Label flutuante ao lado do botão. Padrão Material — chip pequeno com fundo opaco, visível só quando o menu está aberto.
- `LabelPosition`: FabMenuItemLabelPosition {Auto | Left | Right | None} = Auto — Posição do label em relação ao botão. Default Auto — segue a direção do menu (Left/Right) ou esconde (Up/Down).
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho. Default Md — items são menores que o FAB principal.
- `Title`: string — Tooltip nativo. Fallback: Label.
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Default — Variant do botão interno. Default Default — neutro, contrasta com o FAB principal (Primary).
Events:
- `OnClick`: EventCallback<MouseEventArgs>

### OmniScrollToTopButton
Botão "Voltar ao topo" auto-show/hide baseado em scroll position.
_base: OmniComponent · source: src/Omni.Blazor/Components/Buttons/OmniScrollToTopButton.razor_

Parameters:
- `Hidden`: bool = false — Force-hide externo (override do auto). Default false.
- `Icon`: string = arrow-up — Ícone do botão. Default "arrow-up".
- `Position`: FabPosition {BottomRight | BottomLeft | TopRight | TopLeft | BottomCenter | Static} = BottomRight — Canto da viewport. Default BottomRight.
- `ScrollBehavior`: ScrollBehavior {Auto | Smooth | Instant} = Smooth — Comportamento de scroll ao clicar. Smooth (default) anima; Auto/Instant salta direto.
- `ScrollContainerSelector`: string — Selector CSS do container scrollável. null (default) auto-detecta (o mesmo "scroll root" usado por ScrollToTopAsync).
- `ShowAfterPercent`: double — Fração (0.0–1.0) de scroll percorrido pra mostrar. Quando setado, sobrescreve ShowAfterPx. Ex: 0.15 = mostra após 15%.
- `ShowAfterPx`: double = 200 — Quantos pixels scrollados pra começar a mostrar. Default 200. Ignorado se ShowAfterPercent for setado.
- `ShowProgress`: bool = false — Mostra anel de progresso (SVG) ao redor do ícone indicando quanto da página foi scrollada (0% no topo → 100% no final). Default false.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Lg — Tamanho. Default Lg.
- `Title`: string — Tooltip + aria-label. Default "Voltar ao topo".
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Primary — Variant do botão. Default Primary.

### OmniSocialButton
External-auth provider button (Google, Microsoft, Apple, GitHub, Facebook, Passkey).
_base: OmniComponent · source: src/Omni.Blazor/Components/Buttons/OmniSocialButton.razor_

Parameters:
- `AriaLabel`: string — Accessible label (defaults to the full text even when Compact).
- `Block`: bool = false — Stretch to full width.
- `Compact`: bool = false — Icon-only (no label) — for a compact provider row.
- `Disabled`: bool = false — Disable the button.
- `Provider`: SocialProvider {Google | Microsoft | Apple | GitHub | Facebook | Passkey} = Google — Which provider's brand mark + label to render.
- `Text`: string — Override the button label (default "Continuar com {provider}").
Events:
- `OnClick`: EventCallback — Click handler.

### OmniSplitButton
Split button: ação primária à esquerda + chevron de dropdown à direita.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Buttons/OmniSplitButton.razor_

Parameters:
- `Disabled`: bool = false — Desabilita ambos os botões.
- `Icon`: string — Ícone do botão primário.
- `Loading`: bool = false — Loading state — desabilita ambos e mostra spinner no primário.
- `LoadingText`: string — Texto alternativo do botão primário enquanto Loading.
- `MenuAlignEnd`: bool = false — Alinha o popover ao FIM (direita) do chevron — extende para a esquerda embaixo do conjunto (primário + chevron). Útil quando o SplitButton está perto da borda direita da tela e o menu padrão (alinhado à esquerda do chevron) sairia da viewport. Default false.
- `MenuAriaLabel`: string — aria-label do chevron. Default "Mais opções".
- `MenuPosition`: PopoverPosition {Top | Bottom | Left | Right} = Bottom — Posição do popover. Default Bottom.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho (compartilhado).
- `Text`: string — Texto do botão primário.
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Default — Variante visual (compartilhada por ambos os botões).
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Click no botão primário (ação default).

### OmniToggleButton
Botão com estado liga/desliga (pressed/unpressed).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Buttons/OmniToggleButton.razor_

Parameters:
- `Active`: bool = false — Estado pressed (true) / unpressed (false). Two-way: @bind-Active.
- `Disabled`: bool = false — Desabilita interação.
- `Icon`: string — Ícone antes do texto.
- `IconOnly`: bool = false — Renderiza só o ícone (sem texto). Bom para toolbars.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho.
- `Text`: string — Texto do botão.
- `TrailingIcon`: string — Ícone após o texto.
- `Variant`: ToggleVariant {Default | Primary | Accent | Ghost} = Default — Variante visual quando ativo. Default = accent suave.
Events:
- `ActiveChanged`: EventCallback<bool>
- `OnClick`: EventCallback<MouseEventArgs> — Callback de click adicional (além do toggle automático).

## Data

### OmniChat
OmniChat — self-contained chat UI (RadzenChat port): header (title + roster + clear), a scrollable message list (avatar + bubble, aligned by author), and a compose box (Enter sends, Shift+Enter newline).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Chat/OmniChat.razor_

Parameters:
- `ClearButtonText`: string — Label for the clear button. Default "Limpar".
- `CurrentUserId`: string =  — The id of the current user — their messages align right; others' align left.
- `DateSeparatorFormat`: string = D — Date format for the day separators. Default "D".
- `Disabled`: bool = false — Disables the whole chat (compose box, send, clear). Default false.
- `EmptyMessage`: string — Text shown when there are no messages. Default "Nenhuma mensagem ainda. Comece a conversa!".
- `Height`: string = 480px — Height of the chat (CSS). Default 480px.
- `InputLabel`: string = Mensagem — Accessible label (aria-label) for the compose textarea — describes the field, not the send action. Default "Mensagem".
- `MaxMessages`: int = 200 — Max messages kept; older ones are trimmed once exceeded. Default 200.
- `MaxVisibleUsers`: int = 5 — Max roster avatars shown before a "+N" overflow badge. Default 5.
- `Messages`: IEnumerable<OmniChatMessage> — The messages to render (two-way via MessagesChanged).
- `MessagesLabel`: string = Mensagens — Accessible label (aria-label) for the message log region. Default "Mensagens".
- `Placeholder`: string — Compose-box placeholder. Default "Digite uma mensagem...".
- `ReadOnly`: bool = false — Read-only mode — messages render but the compose box is disabled. Default false.
- `RenderMarkdown`: bool = true — Render bubble content as Markdown (default) or plain text.
- `SendLabel`: string — Accessible label / tooltip for the send button. Default "Enviar".
- `ShowClearButton`: bool = true — Shows the "clear chat" button in the header. Default true.
- `ShowDateSeparator`: bool = true — Inserts a date separator between messages from different days. Default true.
- `ShowTypingIndicator`: bool = false — Shows a typing indicator when remote users are typing (see SetUserTypingAsync). Default false.
- `ShowUserNames`: bool = true — Shows each (other) user's name above their bubble. Default true.
- `ShowUsers`: bool = true — Shows the participant roster (avatars) in the header. Default true.
- `TimestampFormat`: string = HH:mm — Time format for each message's timestamp. Default "HH:mm".
- `Title`: string — Header title text. Empty hides the title.
- `TypingTimeout`: int = 1500 — Idle time (ms) after the last keystroke before the local "typing" state clears. Default 1500.
- `Users`: IEnumerable<OmniChatUser> — The chat participants (avatars/names/colors).
Events:
- `ChatCleared`: EventCallback — Fired when the chat is cleared.
- `MessageAdded`: EventCallback<OmniChatMessage> — Fired whenever a message is appended to the list.
- `MessageSent`: EventCallback<OmniChatMessage> — Fired when the local user sends a message.
- `MessagesChanged`: EventCallback<IEnumerable<OmniChatMessage>> — Fired with the new list whenever messages change (consumer assigns it back).
- `TypingChanged`: EventCallback<OmniChatTypingEventArgs> — Fired when the local user starts/stops typing — relay to remote peers.
Slots:
- `EmptyTemplate`: RenderFragment — Custom empty-state content. Overrides EmptyMessage when set.
- `MessageTemplate`: RenderFragment<OmniChatMessage> (context: OmniChatMessage) — Custom render template for a message bubble. Receives the OmniChatMessage.

### OmniDataFilter
OmniDataFilter — a typed visual query builder.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/DataFilter/OmniDataFilter.razor_

Parameters:
- `AddFilterText`: string — Label of the "add condition" button. Default "Adicionar condição".
- `AddGroupText`: string — Label of the "add group" button. Default "Adicionar grupo".
- `AllowGroups`: bool — Allow nested groups (the "add group" button). Default true.
- `AllowSqlMode`: bool — Show the Visual/SQL toggle, enabling an editable SQL view of the filter. Default false.
- `AndOperatorText`: string — Label of the AND logic toggle. Default "E".
- `ApplyFilterText`: string — Label of the apply button (shown when Auto is false). Default "Aplicar".
- `ApplySqlText`: string — Label of the "apply SQL to filter" button. Default "Aplicar ao filtro".
- `Auto`: bool — Re-filter and raise Filter on every change. Default true.
- `ClearFilterText`: string — Label of the "clear all" button. Default "Limpar tudo".
- `CopyText`: string — Label of the copy button. Default "Copiar".
- `Data`: IEnumerable<TItem> — The items to filter.
- `Disabled`: bool — Disable the whole builder.
- `FieldsLabel`: string — Label preceding the available-fields chips in SQL mode. Default "Campos".
- `Logic`: FilterLogic {And | Or} — Logic combining the root rules. Two-way bindable.
- `OrOperatorText`: string — Label of the OR logic toggle. Default "OU".
- `Query`: DataFilterQuery<TItem> — Immutable, versioned query snapshot.
- `RemoveFilterText`: string — Title/aria-label of the remove-condition button. Default "Remover".
- `Rules`: List<OmniFilterRule> — Root list of rules. Two-way bindable.
- `Schema`: DataFilterSchema<TItem> *required* — Immutable strongly typed field schema used by the visual builder and query serialization.
- `ShowSqlPreview`: bool — Show a read-only "generated SQL" disclosure under the visual builder. Default false.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} — Height/typography of every field (selects, inputs, date & list editors). Default Sm.
- `SqlModeText`: string — Label of the SQL-mode toggle. Default "SQL".
- `SqlPlaceholder`: string — Placeholder of the SQL textarea. Default an example expression.
- `SqlPreviewLabel`: string — Summary label of the generated-SQL disclosure. Default "SQL gerado".
- `SqlValidText`: string — Status text shown when the typed SQL is valid. Default "SQL válido".
- `ValuePlaceholder`: string — Placeholder of the condition value inputs. Default "valor".
- `VisualModeText`: string — Label of the visual-mode toggle. Default "Visual".
Events:
- `Filter`: EventCallback<IEnumerable<TItem>> — Raised with the filtered items (Auto mode, or when ApplyFilterAsync runs).
- `LogicChanged`: EventCallback<FilterLogic> — Fired when the root logic changes (paired with Logic for two-way binding).
- `QueryChanged`: EventCallback<DataFilterQuery<TItem>> — Raised with a fresh immutable query after a visual edit.
- `RulesChanged`: EventCallback<List<OmniFilterRule>> — Fired when the rule tree changes (paired with Rules for two-way binding).
- `ViewChanged`: EventCallback<IEnumerable<TItem>> — Raised with the filtered items alongside Filter (binding-friendly).

### OmniDataFilterItem
OmniDataFilterItem — one node of an <OmniDataFilter> tree.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/DataFilter/OmniDataFilterItem.razor_

Parameters:
- `IsRoot`: bool = false — True for the top-level group (hides the remove button, no group border).
- `ParentRules`: List<OmniFilterRule> — The list that contains Rule (so it can remove itself). Null at the root.
- `Rule`: OmniFilterRule *required* — The rule this item renders (condition or group).

### OmniDataGrid
Rich data grid with sorting, filtering, grouping, editing, virtualization and optional hierarchical rows.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniDataGrid.razor_

Parameters:
- `AllowColumnFilter`: bool — Habilita uma linha de filtros por coluna abaixo do header. Só colunas com Filterable exibem o input.
- `AllowColumnResize`: bool — Lets the user resize columns by dragging the right edge of a header cell.
- `AllowColumnVisibility`: bool — Shows the column visibility menu in the toolbar.
- `AllowExport`: bool — Shows an export action that streams the filtered dataset as a bounded CSV.
- `AllowGrouping`: bool — Enables row grouping. Shows a drop panel above the grid; drag a column's grip there (column must be Groupable) — or call GroupByAsync — to group rows by that column. Multiple columns nest.
- `AllowMultiSelection`: bool — Habilita uma coluna de checkbox à esquerda para seleção múltipla.
- `AllowPaging`: bool — Liga a paginação no rodapé. Default true. Ignorado quando Virtualize está ativo.
- `AllowSearch`: bool — Mostra o campo de busca textual na toolbar. Default false.
- `AllowSorting`: bool — Permite ordenar clicando no header das colunas Sortable. Default true.
- `AutoCollapseGroupsThreshold`: int — Acima de quantos grupos de primeiro nível o agrupamento nasce COLAPSADO. Default 100. Sem isso, o primeiro render depois de arrastar uma coluna é sempre o conjunto inteiro aberto — agrupar 200 mil linhas por dia significa achatar as 200 mil de uma vez só para o usuário fechar tudo em seguida. Valores <= 0 desligam o auto-colapso.
- `Children`: Func<TItem, IEnumerable<TItem>> — Synchronous child selector that enables hierarchy mode for in-memory trees.
- `ChildrenProvider`: HierarchyChildrenProvider<TItem> — Asynchronous, cancellable child source that enables lazy hierarchy mode.
- `CollapseText`: string — Accessible label for collapsing a hierarchy row.
- `Count`: int — Override do total quando server-side (caso o consumidor não preencha TotalCount no resultado).
- `Data`: IEnumerable<TItem> — Fonte de dados in-memory. Ignorado se DataProvider for setado. Filtro/ordenação/agrupamento são memoizados por referência e contagem: trocar a coleção ou acrescentar itens reprocessa sozinho; para itens MUTADOS no lugar (mesma coleção, mesma contagem), chame RefreshAsync().
- `DataProvider`: GridDataProvider<TItem> — Callback server-side. Quando setado, o DataGrid delega filter/sort/page ao consumidor. O retorno é a janela de items a renderizar + total count.
- `DebounceMs`: int — Debounce (ms) entre keystrokes na busca antes de chamar DataProvider.
- `EditMode`: DataGridEditMode {None | Cell | Row} — Enables inline editing. Each column needs an EditTemplate to be editable.
- `Embed`: bool — When true, renders without outer border/radius and stretches to fill its parent (flex:1 + min-height:0). Internal toolbar is hidden — render your own OmniPaneHeader/OmniPaneToolbar above.
- `EmptyText`: string — Texto exibido quando não há registros. Default "Nenhum registro encontrado.".
- `ExpandMode`: ExpandMode {Single | Multi} — Single = apenas uma linha expandida por vez; Multi = quantas o usuário quiser.
- `ExpandText`: string — Accessible label for expanding a hierarchy row.
- `ExpandedKeys`: IReadOnlyCollection<object> — Externally controlled expanded key set. Replace the collection when updating it.
- `ExportBatchSize`: int — Page size used while exporting through DataProvider.
- `ExportFilename`: string — Nome do arquivo gerado pelo export CSV. Default "export.csv".
- `ExportProvider`: GridExportProvider<TItem> — Optional streaming source used only by CSV export. When omitted, the grid pages through DataProvider or exports its in-memory source.
- `GroupLimitReachedText`: string — Aviso exibido quando MaxGroups é atingido; {0} é o teto.
- `GroupPanelText`: string — Placeholder text shown in the (empty) group panel.
- `HasChildren`: Func<TItem, bool> — Predicate indicating whether a hierarchy item can be expanded.
- `Height`: string — Altura do scroller. Obrigatória quando virtualize ativo (default 520px é aplicado automaticamente se não setado).
- `HideGroupedColumn`: bool — Hides a column from the table once it is used as a grouping key (its value shows in the group header instead).
- `HierarchyAriaLabel`: string — Accessible label used when the table is rendered as a tree grid.
- `HierarchyLimitReachedText`: string — Message displayed when the configured hierarchy row limit is reached.
- `HierarchyLoadErrorText`: string — Message displayed when lazy child loading fails.
- `HierarchyRetryText`: string — Label for retrying a failed lazy hierarchy load.
- `IndentSize`: int — Pixels of indentation per hierarchy level.
- `InitiallyExpanded`: Func<TItem, bool> — Optional predicate applied once when the hierarchy source changes.
- `KeySelector`: Func<TItem, object> — Stable unique key selector used by hierarchy expansion, cache and loading state.
- `LoadingSkeleton`: bool — Quando true e LoadingTemplate não está setado, renderiza linhas de OmniSkeleton em vez do spinner — mais elegante para listas longas.
- `MaxCachedItems`: int — Maximum total lazy-loaded child items retained in the LRU cache.
- `MaxCachedNodes`: int — Maximum lazy-loaded parent nodes retained in the LRU cache.
- `MaxChildrenPerNode`: int — Maximum children retained from one lazy-load response.
- `MaxConcurrentLoads`: int — Maximum number of lazy child requests executed concurrently.
- `MaxDepth`: int — Maximum hierarchy depth traversed, protecting against cycles and pathological input.
- `MaxExportRows`: int — Hard cap applied to every export, including custom streaming providers.
- `MaxGroups`: int — Teto de nós de grupo montados numa passada (todos os níveis somados). Default 10.000. Agrupar por uma coluna quase-única — um id, um timestamp com segundos — renderia um grupo por linha, e a árvore de grupos passaria a custar mais que os próprios dados. Ao estourar, a árvore é cortada e a UI avisa, no mesmo desenho do MaxVisibleRows da hierarquia. Valores <= 0 são tratados como 1.
- `MaxVisibleRows`: int — Maximum hierarchy rows flattened before rendering or virtualization.
- `OverscanCount`: int — Linhas extras renderizadas fora do viewport. Default 4.
- `PageSize`: int — Quantidade de linhas por página. Default 10.
- `PersistKey`: string — Optional stable local-storage key for automatic view-state restore. Column PropertyName values must be unique and stable. Null disables browser persistence.
- `RowClass`: Func<TItem, string> — Função opcional que retorna classes CSS extras por linha — útil para destacar linhas específicas (ex: "linha atual", "registro com pendência"). Aplicado em conjunto com as classes internas (selecionado, edição, etc.).
- `RowHeight`: float — Altura fixa (px) por linha quando virtualize ativo. Default 44.
- `Schema`: DataGridSchema<TItem> — Optional immutable typed schema. Schema columns are rendered before declarative Columns and its structural feature defaults take precedence while supplied.
- `SearchPlaceholder`: string — Placeholder do campo de busca. Default "Buscar...".
- `SelectedItems`: HashSet<TItem> — Itens selecionados. Quando setado pelo consumidor (via @bind-SelectedItems), o DataGrid usa essa referência diretamente.
- `ShowAggregateRow`: bool — Renderiza uma linha de agregação (<tfoot>) somando/contando/etc. colunas que definam Aggregate. Em modo server-side, valores vêm de Aggregates; client-side, calculados sobre o dataset filtrado completo (não só a página atual).
- `ShowGroupFooters`: bool — Renders a per-group aggregate footer row (reuses each column's Aggregate). Requires aggregated columns.
- `ViewState`: DataGridViewState — Controlled view preferences. Replace the record instance when changing it; row data, selection and hierarchy expansion are intentionally outside this state.
- `Virtualize`: bool — Liga a virtualização do <tbody>: somente as linhas visíveis (e um overscan pequeno) são montadas no DOM. **Ignora AllowPaging** — paging e virtualize são mutuamente exclusivos. Requer Height definido (default 520px). Implementação via OmniVirtualize com SpacerElement="tr".
Events:
- `ColumnResized`: EventCallback<DataGridColumnResizedEventArgs> — Fired after a column is resized (drag of the header handle finished).
- `ExpandedKeysChanged`: EventCallback<IReadOnlyCollection<object>> — Raised with an immutable snapshot after hierarchy expansion changes.
- `ExportFailed`: EventCallback<Exception> — Raised when an uncancelled export fails.
- `ExportTruncated`: EventCallback<int> — Raised when an export reaches MaxExportRows.
- `Grouped`: EventCallback<IReadOnlyList<string>> — Fired whenever the grouping changes; carries the ordered grouped property names.
- `HierarchyLoadFailed`: EventCallback<Exception> — Raised when an uncancelled lazy hierarchy load fails.
- `OnRowClick`: EventCallback<TItem> — Emitido quando uma linha é clicada (fora do modo edição).
- `OnRowCollapse`: EventCallback<TItem> — Emitido quando uma linha é colapsada.
- `OnRowExpand`: EventCallback<TItem> — Emitido quando uma linha é expandida.
- `RowUpdated`: EventCallback<TItem> — Fired when the user confirms an inline edit (clicks check). Use to persist changes.
- `SelectedItemsChanged`: EventCallback<HashSet<TItem>> — Emitido quando a seleção muda. O argumento é o set atual.
- `ViewStateChanged`: EventCallback<DataGridViewState> — Raised with a normalized snapshot after a user changes persisted view preferences.
Slots:
- `Columns`: RenderFragment — Definição das colunas (<OmniDataGridColumn>). Registradas via cascading.
- `DetailTemplate`: RenderFragment<TItem> (context: TItem) — Template renderizado abaixo da linha quando ela está expandida.
- `EmptyTemplate`: RenderFragment — Slot custom para o estado vazio. Substitui o EmptyText quando setado. Permite ícone + título + CTA ricos.
- `LoadingTemplate`: RenderFragment — Slot custom para o overlay de loading. Substitui o spinner default quando setado.
- `ToolbarContent`: RenderFragment — Conteúdo extra na toolbar (entre a busca e os botões à direita).

### OmniDataGridColumn
Column definition for an <OmniDataGrid> — declares title, value selector, templates, sorting/filtering/aggregation/grouping/freezing behavior.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniDataGridColumn.razor_

Parameters:
- `Aggregate`: AggregateFunction {Sum | Average | Count | Min | Max} — Função agregadora aplicada nesta coluna no footer (e em group footers).
- `AggregateFormat`: Func<object, string> — Formatador opcional do valor agregado (ex: v => $"R$ {v:N2}").
- `AggregateProperty`: Func<TItem, decimal> — Selector específico p/ agregação (default: usa Property).
- `CanHide`: bool — Whether the user can hide this column via the visibility menu. Default true.
- `FilterOperators`: FilterOperator[] — Override dos operadores oferecidos (default depende de FilterType).
- `FilterSelectOptions`: IEnumerable<object> — Opções para FilterType=Select.
- `FilterType`: ColumnFilterType {Text | Number | Date | Boolean | Select} — Tipo de UI/operadores oferecidos. Default: Text.
- `Filterable`: bool — Liga o filtro por coluna nesta coluna. Requer AllowColumnFilter no DataGrid.
- `Frozen`: FrozenPosition {Left | Right} — Congela esta coluna no scroll horizontal. null = não congelada.
- `GroupHierarchy`: IReadOnlyList<DateGroupInterval> — Desdobra esta coluna em vários níveis de agrupamento por data. Agrupar uma coluna de data pelo valor exato rende um grupo por linha — o instante nunca se repete —, então aqui se declara a granularidade de cada nível: GroupHierarchy="@DateGroupHierarchy.YearMonthDay" dá Ano › Mês › Dia com um único arrasto. Um nível só (new[] { DateGroupInterval.Month }) agrupa por mês, sem hierarquia. null (padrão) mantém o agrupamento pelo valor exato, e itens cujo valor não é uma data caem num grupo vazio.
- `Groupable`: bool — Permite arrastar esta coluna para a group zone do DataGrid.
- `IsHierarchyAnchor`: bool — Marca esta coluna como o "âncora" da hierarquia — receberá o chevron de expand/collapse + indentação por nível. Quando nenhuma coluna marca, o grid usa a primeira coluna visível.
- `Property`: Func<TItem, object> — Selector for the column's raw value — used for cell text, sorting, and filtering.
- `PropertyName`: string — Nome canônico da propriedade (usado para serializar em SortDescriptor, FilterDescriptor e GroupBy). Quando ausente, cai no Title. Em modo server-side é altamente recomendado definir explicitamente.
- `Resizable`: bool — Whether this column can be resized when the grid has AllowColumnResize. Default true.
- `Sortable`: bool — Whether clicking the header sorts by this column (requires the grid's AllowSorting). Default true.
- `TextSelector`: Func<TItem, string> — Selector for the displayed cell text. Overrides Property's ToString() when set.
- `Title`: string — Header text for this column.
- `Visible`: bool — Initial visibility. Toggled via the grid's column-visibility menu when AllowColumnVisibility is enabled.
- `Width`: string — CSS width of the column (e.g. "120px"). Null = auto.
Slots:
- `EditTemplate`: RenderFragment<TItem> (context: TItem) — Editor render fragment used when the row/cell is in edit mode. If null, the column is treated as read-only even when EditMode is active.
- `Template`: RenderFragment<TItem> (context: TItem) — Custom cell render template. Receives the row item as @context. Falls back to the cell text.

### OmniDataGridForm
Coordinates a generated OmniDataGrid`1, detached OmniDataForm`1 drafts and cancellable CRUD persistence.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniDataGridForm.razor_

Parameters:
- `ActionsFrozen`: FrozenPosition {Left | Right} — Optionally freezes the generated row-actions column on the left or right edge.
- `ActionsMenuAriaLabel`: string — Accessible label for the row overflow-menu button.
- `ActionsMenuIcon`: string — Optional runtime icon override for the row overflow-menu button.
- `ActionsMenuText`: string — Optional visible label for the row overflow-menu button. The default is icon-only.
- `ActionsResizable`: bool — Optional runtime override for the generated row-actions column resizer.
- `ActionsWidth`: string — Optional runtime width override for the generated row-actions column.
- `AllowCreate`: bool — Allows the schema-defined create workflow. Default true.
- `AllowDelete`: bool — Allows the schema-defined delete workflow. Default true.
- `AllowEdit`: bool — Allows the schema-defined edit workflow. Default true.
- `AllowReorder`: bool — Shows move-up and move-down actions in local-list mode.
- `ConfirmDiscardChanges`: bool — Asks for confirmation before closing a modified generated editor. Default true.
- `Disabled`: bool — Disables every generated operation and editor.
- `GuardNavigationWithUnsavedChanges`: bool — Protects route changes and browser unload while the generated editor is modified. Default true.
- `Items`: IList<TItem> — Mutable local source. Use either Items or Provider, never both. Local create/edit/delete operations mutate this list only after validation succeeds.
- `MaximumItems`: int — Maximum local item count enforced before creation. Default unlimited.
- `MaximumSelectedItems`: int — Maximum items accepted in one bulk-action snapshot. Default 1,000.
- `MinimumItems`: int — Minimum local item count enforced before deletion. Default zero.
- `PersistViewStateKey`: string — Optional stable local-storage key used to restore generated DataGrid preferences.
- `Provider`: IDataGridFormProvider<TItem, TKey> — Cancellable server-side source and CRUD persistence provider.
- `ReadOnly`: bool — Makes data read-only while preserving grid navigation and inspection.
- `RenderEditorFormElement`: bool — Renders the semantic editor form element. Disable when this component is embedded inside another form to avoid nested HTML forms. Default true.
- `ReorderActionsPlacement`: DataGridFormActionPlacement {Inline | Menu | Auto} — Optionally overrides generated move-up and move-down action placement.
- `Schema`: DataGridFormSchema<TItem, TKey> *required* — Immutable form, grid and operation schema.
- `SelectedItems`: HashSet<TItem> — Externally controlled selected-item set used by schema-defined bulk actions.
- `ShowOperationErrors`: bool — Shows operation failures in the component. Default true.
- `ViewState`: DataGridViewState — Controlled DataGrid layout, sort, filter, grouping and search preferences.
Events:
- `ItemsChanged`: EventCallback<IList<TItem>> — Raised after a local collection mutation.
- `OperationCompleted`: EventCallback<DataGridFormOperationEventArgs<TItem, TKey>> — Raised after create, edit, delete or custom action success.
- `OperationFailed`: EventCallback<DataGridFormOperationFailedEventArgs<TItem, TKey>> — Raised after a handled operation failure.
- `SelectedItemsChanged`: EventCallback<HashSet<TItem>> — Raised after the DataGrid selection or a bulk action clears the selected set.
- `ViewStateChanged`: EventCallback<DataGridViewState> — Raised after the generated DataGrid view preferences change.
Slots:
- `EmptyTemplate`: RenderFragment — Custom empty-state content.
- `LoadingTemplate`: RenderFragment — Custom DataGrid loading content.
- `OperationErrorTemplate`: RenderFragment<DataGridFormOperationFailedEventArgs<TItem, TKey>> (context: DataGridFormOperationFailedEventArgs<TItem, TKey>) — Custom renderer for the latest structured operation failure.
- `ToolbarContent`: RenderFragment — Additional content rendered in the DataGrid toolbar.

### OmniDataImport
Reads bounded delimited text incrementally, maps it to a typed schema and exposes only validated snapshots to cancellable persistence handlers.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniDataImport.razor_

Parameters:
- `Accept`: string — HTML file input accept filter.
- `AllowPartialImport`: bool — Allows valid rows to be imported while other rows are invalid.
- `ClearText`: string — Overrides the clear action text.
- `Culture`: CultureInfo — Culture used by built-in numeric and date parsers. Defaults to current culture.
- `Disabled`: bool — Disables file selection, mapping and import.
- `Handler`: DataImportHandler<TItem> — Optional cancellable destination for accepted typed rows.
- `ImportText`: string — Overrides the import action text.
- `MappingTitle`: string — Overrides the mapping section title.
- `MaxFileSize`: long — Maximum input size in bytes. Default 5 MB.
- `MaximumCellLength`: int — Maximum characters accepted in one cell. Default 32,768.
- `MaximumColumns`: int — Maximum source columns per row. Default 256.
- `MaximumRows`: int — Maximum data rows retained in memory. Default 10,000.
- `PreviewRowCount`: int — Maximum processed rows rendered in the preview. Default 25.
- `PreviewTitle`: string — Overrides the preview section title.
- `Schema`: DataImportSchema<TItem> *required* — Immutable target schema containing typed property mappings and parsers.
- `UploadText`: string — Overrides the file-selection text.
Events:
- `Failed`: EventCallback<Exception> — Raised after an observed load, conversion or persistence failure.
- `Imported`: EventCallback<DataImportCompletedEventArgs<TItem>> — Raised after Handler succeeds, or directly when no Handler is supplied.
Slots:
- `LoadingTemplate`: RenderFragment — Custom loading content.
- `RowTemplate`: RenderFragment<DataImportRow<TItem>> (context: DataImportRow<TItem>) — Custom preview row cells. The fragment must render cells matching the component header structure.

### OmniDayView
Single-day view with time slots.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniDayView.razor_

Parameters:
- `EndTime`: TimeSpan — Last time slot of the day (exclusive). Default 24:00.
- `Icon`: string = clock — Icon name shown on this view's switch tab. Default "clock".
- `MinutesPerSlot`: int = 30 — Minutes per slot row. Default 30.
- `StartTime`: TimeSpan — First time slot of the day. Default 08:00.
- `Text`: string = Dia — Label shown on this view's switch tab. Default "Dia".
- `TimeFormat`: string = HH:mm — Time format for slot labels. Default "HH:mm".

### OmniDiagramCanvas
OmniDiagramCanvas — generic infinite graph editor: pan/zoom, dotted grid, nodes with named ports, bezier edges, drag-to-connect, marquee selection, minimap, zoom controls and auto-layout.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Data/Diagram/OmniDiagramCanvas.razor_

Parameters:
- `AutoLayoutText`: string = Auto-layout (organizar) — Tooltip text for the auto-layout button.
- `DropPayloadFormat`: string = application/x-omni-diagram — HTML5 drag payload format accepted by OnExternalDrop.
- `Edges`: IReadOnlyList<DiagramEdge> — Graph edges.
- `FitOnMount`: bool = false — Fits the graph into view once, on first render with nodes.
- `FitText`: string = Ajustar à tela — Tooltip text for the fit button.
- `Nodes`: IReadOnlyList<DiagramNode> — Graph nodes (world coordinates).
- `ReadOnly`: bool = false — Disables editing gestures (drag, connect, marquee, delete, drop). Pan/zoom stay enabled.
- `RunState`: DiagramRunState — Optional execution overlay (current/done/faulted/taken edges...).
- `Schema`: DiagramSchema — Optional immutable fluent schema for graph structure and canvas defaults.
- `Selection`: DiagramSelection — Current selection. Two-way bindable.
- `ShowAutoLayout`: bool = true — Shows the auto-layout button inside the controls.
- `ShowControls`: bool = true — Shows the zoom control group (bottom-left).
- `ShowMinimap`: bool = true — Shows the minimap (bottom-right).
- `Viewport`: DiagramViewport — Viewport (offset + zoom). Two-way bindable; committed after gestures.
- `ZoomInText`: string = Aumentar zoom — Tooltip text for the zoom-in button.
- `ZoomOutText`: string = Diminuir zoom — Tooltip text for the zoom-out button.
Events:
- `NodesMoved`: EventCallback<IReadOnlyList<DiagramNodeMove>> — Raised when a node drag (possibly multi-node) or auto-layout commits.
- `OnConnect`: EventCallback<DiagramConnectEventArgs> — Raised when the user finishes a drag-to-connect between two ports.
- `OnDeleteRequested`: EventCallback<DiagramSelection> — Raised when Delete/Backspace is pressed with the canvas focused.
- `OnExternalDrop`: EventCallback<DiagramExternalDropEventArgs> — Raised when an external item is dropped on the canvas (world coords).
- `SelectionChanged`: EventCallback<DiagramSelection> — Raised when the user changes the selection (click, marquee).
- `ViewportChanged`: EventCallback<DiagramViewport> — Raised when a gesture commits a new viewport.
Slots:
- `ChildContent`: RenderFragment — Extra overlay content (hints, run bars...) rendered inside the canvas.
- `EmptyContent`: RenderFragment — Rendered centered when the graph has no nodes.
- `NodeTemplate`: RenderFragment<DiagramNode> (context: DiagramNode) — Replaces the default node card content. Ports are always rendered by the canvas.

### OmniDropZone
A single drop bucket.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Data/OmniDropZone.razor_

Parameters:
- `Value`: object — Opaque value the container's ItemSelector uses to bucket items into this zone (e.g. a status enum).
Slots:
- `Footer`: RenderFragment — Optional footer rendered below the items (e.g. an "+ Add" button).

### OmniDropZoneContainer
Kanban-style drag-and-drop container.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Data/OmniDropZoneContainer.razor_

Parameters:
- `CanDrop`: Func<DropZoneItemEventArgs<TItem>, bool> — Returns whether the current drag is allowed to drop on the target zone/item.
- `Data`: IEnumerable<TItem> — Backing data list. Each OmniDropZone`1 filters this via ItemSelector.
- `ItemRender`: Action<DropZoneItemRenderEventArgs<TItem>> — Per-item render hook — set attributes or hide individual items.
- `ItemSelector`: Func<TItem, OmniDropZone<TItem>, bool> — Returns true when an item belongs in the given zone.
Events:
- `DragEnd`: EventCallback<DropZoneItemEventArgs<TItem>> — Fires when the drag ends (with or without a drop).
- `DragStart`: EventCallback<DropZoneItemEventArgs<TItem>> — Fires when the user starts dragging an item.
- `Drop`: EventCallback<DropZoneItemEventArgs<TItem>> — Fires when an item is dropped on a zone (or another item).
Slots:
- `Template`: RenderFragment<TItem> (context: TItem) — Render template for each item. Receives the item as @context.

### OmniDropZoneItem
Internal draggable item rendered by <OmniDropZone>.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniDropZoneItem.razor_

Parameters:
- `ItemAttributes`: IReadOnlyDictionary<string, object> — ItemAttributes contributed by the container's ItemRender hook.

### OmniFileManager
Provider-backed file manager with bounded loading, navigation and guarded mutations.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniFileManager.razor_

Parameters:
- `AriaLabel`: string = Gerenciador de arquivos — Accessible label for the component.
- `BreadcrumbLabel`: string = Localização — Accessible label for breadcrumb navigation.
- `CancelText`: string = Cancelar — Label for cancelling a pending action.
- `Capabilities`: FileManagerCapabilities {Browse | CreateFolder | Rename | Delete | Upload | Download | All} = Browse — Enabled optional operations. Browse is always available.
- `ConfirmText`: string = Confirmar — Label for confirming deletion.
- `DeleteConfirmationText`: string = Excluir “{0}”? — Delete confirmation template. Placeholder zero receives the entry name.
- `DeleteText`: string = Excluir — Label for the delete action.
- `DownloadText`: string = Baixar — Label for the download action.
- `EmptyText`: string = Esta pasta está vazia. — Message shown when the directory is empty.
- `ErrorText`: string = Não foi possível concluir a operação. — Message shown after a provider failure.
- `GridViewText`: string = Exibição em grade — Label for grid view.
- `ItemsCountText`: string = {0} de {1} itens — Footer template for visible and total item counts.
- `LimitText`: string = Limite de {0} itens — Footer template shown when the configured item limit was reached.
- `ListViewText`: string = Exibição em lista — Label for list view.
- `LoadingText`: string = Carregando arquivos... — Message shown while the initial listing loads.
- `MaxItems`: int = 1000 — Maximum entries requested, retained and rendered per directory.
- `MaxUploadFiles`: int = 20 — Maximum files accepted in one upload selection.
- `NewFolderPlaceholder`: string = Nome da pasta — Placeholder for a new folder name.
- `NewFolderText`: string = Nova pasta — Label for the create-folder action.
- `Path`: string = / — Current logical path for two-way binding. Paths use forward slashes.
- `Provider`: IOmniFileManagerProvider *required* — Backend responsible for browsing and optional mutations.
- `RefreshText`: string = Atualizar — Label for the refresh action.
- `RenamePlaceholder`: string = Novo nome — Placeholder for a new entry name.
- `RenameText`: string = Renomear — Label for the rename action.
- `SaveText`: string = Salvar — Label for saving an inline edit.
- `SearchDebounce`: int = 250 — Delay before provider-side text searches, in milliseconds.
- `SearchPlaceholder`: string = Buscar nesta pasta — Provider-side search placeholder.
- `SearchText`: string =  — Current provider-side search text for two-way binding.
- `SelectedItem`: FileManagerEntry — Currently selected entry for two-way binding.
- `UploadText`: string = Enviar — Label for the upload action.
- `View`: FileManagerView {List | Grid} = List — Current list or grid layout for two-way binding.
Events:
- `DirectoryOpened`: EventCallback<FileManagerEntry> — Raised after a directory is opened and its path changes.
- `DownloadRequested`: EventCallback<FileManagerEntry> — Raised when the user requests download of a file.
- `ItemsChanged`: EventCallback — Raised after a provider operation changes the directory contents.
- `OperationFailed`: EventCallback<Exception> — Raised when an uncancelled provider operation fails.
- `PathChanged`: EventCallback<string> — Raised when Path changes.
- `SearchTextChanged`: EventCallback<string> — Raised when SearchText changes.
- `SelectedItemChanged`: EventCallback<FileManagerEntry> — Raised when SelectedItem changes.
- `ViewChanged`: EventCallback<FileManagerView> — Raised when View changes.
Slots:
- `ItemTemplate`: RenderFragment<FileManagerEntry> (context: FileManagerEntry) — Optional custom renderer for each entry.

### OmniGantt
OmniGantt — project timeline inspired by RadzenGantt.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Data/Gantt/OmniGantt.razor_

Parameters:
- `AllowColumnResize`: bool — Lets the user resize left-pane columns by dragging the right edge of a header cell. Default true.
- `Data`: IEnumerable<TItem> — The task source.
- `Dependencies`: IEnumerable<GanttDependency<TItem>> — Typed task dependencies rendered as arrows.
- `LeftPaneWidth`: string — Fallback width for the left task pane when no columns are declared. When columns exist the pane auto-sizes to the sum of their (effective) widths, so a column never overflows into the timeline.
- `Markers`: IEnumerable<GanttMarker> — Optional vertical date markers (e.g. deadlines) drawn on the timeline.
- `NonWorkingDays`: IEnumerable<DayOfWeek> — Which days count as non-working (shaded). Default Saturday + Sunday.
- `RowHeightPx`: int — Height (px) of each task row. Default 34.
- `Schema`: GanttSchema<TItem> *required* — Immutable typed task projection and presentation schema.
- `ShowCriticalPath`: bool — Computes and highlights the critical path (CPM). Requires dependencies. Default false.
- `ShowNavigation`: bool — Shows the top navigation bar (title + zoom controls). Default true.
- `ShowTodayLine`: bool — Draws a vertical line at the current date/time. Default true.
- `ShowWeekends`: bool — Shades non-working days (see NonWorkingDays) on the timeline. Default true.
- `TaskRender`: Action<GanttBarRenderEventArgs<TItem>> — Per-bar render hook (CSS class / inline style).
- `ViewEnd`: DateTime — Forces the timeline end date. Null = auto from the latest task.
- `ViewStart`: DateTime — Forces the timeline start date. Null = auto from the earliest task.
- `ZoomLevel`: GanttZoomLevel {Day | Week | Month | Year} — Timeline granularity (Day/Week/Month/Year). Default Week.
- `ZoomToFitText`: string — Tooltip for the zoom-to-fit button. Default "Ajustar à tela".
Events:
- `ColumnResized`: EventCallback<GanttColumnResizedEventArgs> — Fired after a left-pane column is resized (drag of the header handle finished).
- `RowClick`: EventCallback<TItem> — Fired when a left-pane row is clicked.
- `TaskClick`: EventCallback<TItem> — Fired when a task bar is clicked.
- `TaskMouseEnter`: EventCallback<GanttTaskMouseEventArgs<TItem>> — Fired when the pointer enters a task bar.
- `TaskMouseLeave`: EventCallback<GanttTaskMouseEventArgs<TItem>> — Fired when the pointer leaves a task bar.
- `TaskMove`: EventCallback<GanttTaskMovedEventArgs<TItem>> — Fired when a task is dragged to a new date range. Wiring it enables drag-to-move.
- `TaskResize`: EventCallback<GanttTaskMovedEventArgs<TItem>> — Fired when a task is resized via its edge handles. Wiring it enables resizing.
Slots:
- `ChildContent`: RenderFragment — Left-pane column definitions (OmniGanttColumn) — pass them as child content.
- `TaskTemplate`: RenderFragment<TItem> (context: TItem) — Custom content inside each task bar (replaces progress + label).

### OmniGanttColumn
Left-pane column for an OmniGantt.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Gantt/OmniGanttColumn.razor_

Parameters:
- `FormatString`: string — Optional composite format string (e.g. "{0:d}", "{0:P0}").
- `MinWidth`: string — Minimum width (e.g. "60px") the user can drag this column down to. Default 60px.
- `Property`: Func<TItem, object> — Value selector for the cell content.
- `Resizable`: bool — Whether this column can be resized when the gantt has AllowColumnResize. Default true.
- `Title`: string — Header text.
- `Width`: string — CSS width of the column (e.g. "200px"). Default "140px".
Slots:
- `Template`: RenderFragment<TItem> (context: TItem) — Optional custom cell template (overrides Property).

### OmniGanttForm
CRUD-enabled Gantt that edits detached tasks through OmniDataForm and the shared headless entity coordinator.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Gantt/OmniGanttForm.razor_

Parameters:
- `Disabled`: bool — Disables generated entity operations.
- `EditorSchema`: EntityEditorSchema<TItem, TKey> *required* — Reusable DataForm and CRUD definition.
- `GanttClass`: string — Additional CSS class applied directly to the Gantt.
- `GanttSchema`: GanttSchema<TItem> *required* — Strongly typed task projection and Gantt defaults.
- `GanttStyle`: string — Additional inline styles applied directly to the Gantt.
- `Items`: IList<TItem> *required* — Mutable task snapshot rendered by the Gantt.
- `MaximumItems`: int — Maximum local task count.
- `MinimumItems`: int — Minimum local task count.
- `Provider`: IOmniEntityMutationProvider<TItem, TKey> — Optional persistence provider.
- `ReadOnly`: bool — Makes generated entity operations read-only.
Events:
- `ColumnResized`: EventCallback<GanttColumnResizedEventArgs> — Raised after a Gantt column resize.
- `ItemsChanged`: EventCallback<IList<TItem>> — Raised after a successful local mutation.
- `OperationCompleted`: EventCallback<EntityEditorOperationEventArgs<TItem, TKey>> — Raised after a successful generated CRUD operation.
- `OperationFailed`: EventCallback<EntityEditorOperationFailedEventArgs<TItem, TKey>> — Raised after a handled generated CRUD failure.
- `RefreshRequested`: EventCallback — Requests that the owner reload provider-backed Items.
- `RowClick`: EventCallback<TItem> — Raised after a left-pane row is selected.
- `TaskClick`: EventCallback<TItem> — Raised after a task bar is selected.
- `TaskMove`: EventCallback<GanttTaskMovedEventArgs<TItem>> — Raised after a task move gesture.
- `TaskResize`: EventCallback<GanttTaskMovedEventArgs<TItem>> — Raised after a task resize gesture.
Slots:
- `Columns`: RenderFragment — Declarative left-pane Gantt columns.
- `TaskTemplate`: RenderFragment<TItem> (context: TItem) — Typed task-bar content.
- `ToolbarContent`: RenderFragment — Additional generated toolbar content.

### OmniHtmlEditor
_base: FormComponent<T> · accepts ChildContent · form input · source: src/Omni.Blazor/Components/Data/HtmlEditor/OmniHtmlEditor.razor_

Parameters:
- `Height`: string = 320px — Height of the editor surface (CSS). Default 320px.
- `Mode`: HtmlEditorMode {Design | Source} = Design — Design (WYSIWYG) or Source (raw HTML) view. Default Design.
- `ShowToolbar`: bool = true — Shows the formatting toolbar. Default true.
Events:
- `Execute`: EventCallback<string> — Fired whenever a command runs (carries the execCommand name).
- `Input`: EventCallback<string> — Fired on every content change in design mode (per keystroke).
Slots:
- `ChildContent`: RenderFragment — Custom toolbar content (OmniHtmlEditorButton tools). When null, a default toolbar renders.

### OmniHtmlEditorButton
A toolbar tool for OmniHtmlEditor.
_base: ComponentBase · source: src/Omni.Blazor/Components/Data/HtmlEditor/OmniHtmlEditorButton.razor_

Parameters:
- `Command`: string *required* =  — The execCommand name (e.g. bold, justifyCenter, insertOrderedList).
- `Icon`: string *required* =  — Icon name (Omni icon library).
- `Shortcut`: string — Optional keyboard shortcut (e.g. Ctrl+B) registered with the editor.
- `Title`: string — Tooltip / accessible title.
- `Value`: string — Optional command value (e.g. a color, or a block tag for formatBlock).

### OmniKanban
OmniKanban — quadro de colunas com cards arrastáveis.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniKanban.razor_

Parameters:
- `AddCardText`: string — Label do botão de adicionar card. Default "Adicionar card".
- `AgeStaleDays`: int — A partir de quantos dias o card fica "vermelho". Default 5.
- `AgeWarnDays`: int — A partir de quantos dias o card fica "amarelo". Default 3.
- `AllowAddCard`: bool — Mostra o botão "adicionar card" no rodapé das colunas. Default false.
- `AllowColumnReorder`: bool — Permite arrastar o cabeçalho da coluna para reordená-las. Default false.
- `CardActions`: Func<TCard, IEnumerable<KanbanCardAction>> — Ações do menu "…" do card (atribuir, mover, sinalizar, etc.). Quando definido, mostra o botão "…"; o menu é renderizado num portal (escapa o overflow da coluna).
- `CardAge`: Func<TCard, int> — Dias que o card está na coluna (o consumidor calcula). null = oculto.
- `CardAssignee`: Func<TCard, string> — Nome do responsável — vira avatar (iniciais) no rodapé do card.
- `CardAvatar`: Func<TCard, string> — URL da imagem do avatar do responsável (senão usa as iniciais).
- `CardColor`: Func<TCard, string> — Cor (CSS) da faixa lateral do card — por tipo, prioridade, etc. null = sem faixa.
- `CardDueDate`: Func<TCard, DateTime> — Prazo do card — badge de data (fica vermelho se vencido).
- `CardEstimate`: Func<TCard, string> — Estimativa (texto livre: "5", "3h", "8pts") — badge.
- `CardFields`: Func<TCard, IEnumerable<KanbanField>> — Campos extras (rótulo + valor) exibidos no card — no máx. 3.
- `CardId`: Func<TCard, object> — Chave estável do card (recomendado): @@key, foco por teclado, igualdade.
- `CardPriority`: Func<TCard, KanbanPriority> — Prioridade do card — ícone/cor no topo.
- `CardSubtasks`: Func<TCard, ValueTuple<int, int>> — Progresso de subtarefas (concluídas, total) — badge ✓ d/t.
- `CardTitle`: Func<TCard, string> — Card → título exibido no card padrão. Default: ToString() do card.
- `Collapsible`: bool — Permite recolher colunas. Default true.
- `ColumnSelector`: Func<TCard, string> — Card → Id da coluna (obrigatório).
- `ColumnSetter`: Action<TCard, string> — Grava a nova coluna no card ao mover entre colunas.
- `ColumnWidth`: string — Largura CSS de cada coluna (define --omni-kanban-col-w). Null = largura padrão.
- `Columns`: IEnumerable<KanbanColumn> — Definição das colunas (ordem = ordem de exibição).
- `DragDisabled`: bool — Desabilita o drag-and-drop (mouse e teclado). Default false.
- `DueDateFormat`: string — Formato do prazo. Default "dd MMM".
- `Items`: IEnumerable<TCard> — Lista plana de cards. Two-way (@bind-Items) — reordenada ao mover.
- `QuickFilters`: IEnumerable<KanbanQuickFilter<TCard>> — Chips de filtro rápido (combinam em E). Cards que falham num filtro ativo são ocultados.
- `Schema`: KanbanSchema<TCard> — Optional immutable typed board schema.
- `SearchPlaceholder`: string — Placeholder da busca.
- `SearchSelector`: Func<TCard, string> — Texto a pesquisar por card. Default = título do card.
- `ShowCardAge`: bool — Exibe o indicador de envelhecimento (pontos).
- `ShowCount`: bool — Mostra a contagem de cards (ou n/limite com WIP) no cabeçalho. Default true.
- `ShowSearch`: bool — Exibe uma barra de busca textual.
- `SwimlaneSelector`: Func<TCard, string> — Card → Id da raia.
- `SwimlaneSetter`: Action<TCard, string> — Grava a nova raia no card ao mover entre raias.
- `Swimlanes`: IEnumerable<KanbanSwimlane> — Definição das raias. Quando presente (+ SwimlaneSelector), o board agrupa em linhas.
- `SwimlanesCollapsible`: bool — Permite recolher raias. Default true.
- `WipLimitMode`: WipLimitMode {Warn | Enforce} — Comportamento do limite de WIP: avisa (Warn) ou bloqueia a entrada (Enforce). Default Warn.
Events:
- `CardAction`: EventCallback<KanbanCardActionEventArgs<TCard>> — Disparado quando uma ação do menu "…" é selecionada.
- `CardClick`: EventCallback<TCard> — Disparado ao clicar num card.
- `CardMoved`: EventCallback<KanbanCardMovedEventArgs<TCard>> — Disparado após mover um card (coluna/raia de origem e destino + índices).
- `ColumnMoved`: EventCallback<KanbanColumnMovedEventArgs> — Disparado após reordenar colunas (coluna + índices).
- `ColumnsChanged`: EventCallback<IEnumerable<KanbanColumn>> — Two-way: @@bind-Columns — recebe a nova ordem ao reordenar.
- `ItemsChanged`: EventCallback<IEnumerable<TCard>> — Disparado com a nova lista ao mover/reordenar cards (par de @bind-Items).
- `OnAddCard`: EventCallback<KanbanColumn> — Disparado ao clicar no botão "adicionar card" de uma coluna.
Slots:
- `CardTemplate`: RenderFragment<TCard> (context: TCard) — Template completo do card — substitui o card padrão (e todos os seletores Card*).
- `ColumnFooterTemplate`: RenderFragment<KanbanColumn> (context: KanbanColumn) — Template do rodapé da coluna (substitui o botão "adicionar card"). Recebe a KanbanColumn.
- `ColumnHeaderTemplate`: RenderFragment<KanbanColumn> (context: KanbanColumn) — Template do cabeçalho da coluna. Recebe a KanbanColumn.
- `EmptyColumnTemplate`: RenderFragment — Conteúdo exibido numa coluna sem cards. Default: "Sem cards".

### OmniKanbanForm
CRUD-enabled Kanban that edits detached cards through OmniDataForm and the shared headless entity coordinator.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniKanbanForm.razor_

Parameters:
- `BoardClass`: string — Additional CSS class applied directly to the board.
- `BoardStyle`: string — Additional inline styles applied directly to the board.
- `ColumnFactory`: Func<KanbanColumn, TItem> — Creates a prefilled card for the selected Kanban column.
- `Disabled`: bool — Disables generated entity operations.
- `EditorSchema`: EntityEditorSchema<TItem, TKey> *required* — Reusable DataForm and CRUD definition.
- `Items`: IList<TItem> *required* — Mutable card snapshot rendered by the Kanban.
- `KanbanSchema`: KanbanSchema<TItem> *required* — Strongly typed board and card schema.
- `MaximumItems`: int — Maximum local card count.
- `MinimumItems`: int — Minimum local card count.
- `Provider`: IOmniEntityMutationProvider<TItem, TKey> — Optional persistence provider.
- `ReadOnly`: bool — Makes generated entity operations read-only.
Events:
- `AddCard`: EventCallback<KanbanColumn> — Raised after a column add action is requested.
- `CardClick`: EventCallback<TItem> — Raised after a card is selected for editing.
- `CardMoved`: EventCallback<KanbanCardMovedEventArgs<TItem>> — Raised after a card is moved between board positions.
- `ItemsChanged`: EventCallback<IList<TItem>> — Raised after CRUD or board movement changes the local source.
- `OperationCompleted`: EventCallback<EntityEditorOperationEventArgs<TItem, TKey>> — Raised after a successful generated CRUD operation.
- `OperationFailed`: EventCallback<EntityEditorOperationFailedEventArgs<TItem, TKey>> — Raised after a handled generated CRUD failure.
- `RefreshRequested`: EventCallback — Requests that the owner reload provider-backed Items.
Slots:
- `CardTemplate`: RenderFragment<TItem> (context: TItem) — Custom card content.
- `ToolbarContent`: RenderFragment — Additional generated toolbar content.

### OmniMonthView
Month grid (6 weeks × 7 days).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniMonthView.razor_

Parameters:
- `Icon`: string = grid — Icon name shown on this view's switch tab. Default "grid".
- `MaxAppointmentsInSlot`: int = 3 — Max appointments rendered per day before a "+N more" link appears. Null = unlimited.
- `MoreText`: string = + {0} mais — Overflow link text. {0} is replaced with the hidden count. Default "+ {0} mais".
- `Text`: string = Mês — Label shown on this view's switch tab. Default "Mês".

### OmniMultiDayView
N consecutive days side-by-side with time slots (mirrors RadzenMultiDayView).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniMultiDayView.razor_

Parameters:
- `AdvanceDays`: int = 1 — How many days the next/prev buttons advance. Default 1.
- `EndTime`: TimeSpan — Last time slot of the day (exclusive). Default 24:00.
- `HeaderFormat`: string = ddd — Format for the day-of-week header. Default "ddd".
- `Icon`: string = columns — Icon name shown on this view's switch tab. Default "columns".
- `MinutesPerSlot`: int = 30 — Minutes per slot row. Default 30.
- `NumberOfDays`: int = 2 — How many days to render side-by-side. Default 2.
- `StartTime`: TimeSpan — First time slot of the day. Default 08:00.
- `Text`: string = Multi-dias — Label shown on this view's switch tab. Default "Multi-dias".
- `TimeFormat`: string = HH:mm — Time format for slot labels. Default "HH:mm".

### OmniPivotColumn
A column dimension of an OmniPivotGrid`1. Multiple nest.
_base: OmniPivotFieldBase<TItem> · source: src/Omni.Blazor/Components/Data/Pivot/OmniPivotColumn.cs_

Parameters:
- `Width`: string — Optional fixed width for the value columns under this group.

### OmniPivotGrid
OmniPivotGrid — pivot table (RadzenPivotDataGrid port).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Pivot/OmniPivotGrid.razor_

Parameters:
- `AllowDrillDown`: bool — Lets the user expand/collapse row and column groups. Default true.
- `Data`: IReadOnlyList<TItem> — Flat data source to pivot.
- `EmptyText`: string — Text shown when there's nothing to pivot.
- `GrandTotalText`: string — Label of the grand-total footer cell.
- `ShowColumnTotals`: bool — Shows a bottom totals row (per measure, per column group) + grand total.
- `ShowRowTotals`: bool — Shows a right-hand totals column (per measure, per row group).
- `TotalsText`: string — Label of the totals column/row headers.
Slots:
- `Columns`: RenderFragment — Column dimension declarations (OmniPivotColumn).
- `Rows`: RenderFragment — Row dimension declarations (OmniPivotRow).
- `Values`: RenderFragment — Value/measure declarations (OmniPivotValue).

### OmniPivotRow
A row dimension of an OmniPivotGrid`1. Multiple nest.
_base: OmniPivotFieldBase<TItem> · source: src/Omni.Blazor/Components/Data/Pivot/OmniPivotRow.cs_


### OmniPivotValue
A value/measure of an OmniPivotGrid`1 — an aggregate (AggregateFunction) of a property computed at each row×column intersection. Multiple values render side-by-side under every column group.
_base: OmniPivotFieldBase<TItem> · source: src/Omni.Blazor/Components/Data/Pivot/OmniPivotValue.cs_

Parameters:
- `Aggregate`: AggregateFunction {Sum | Average | Count | Min | Max} — Aggregate function. Default Sum.
- `Align`: string — CSS text-align for the value cells. Default right.
- `FormatString`: string — Composite format string for the cell value (e.g. "{0:C}", "{0:P0}").
Slots:
- `Template`: RenderFragment<object> (context: object) — Optional cell template (receives the aggregated value).

### OmniScheduler
OmniScheduler — calendar/agenda component inspired by RadzenScheduler.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniScheduler.razor_

Parameters:
- `AppointmentRender`: Action<SchedulerAppointmentRenderEventArgs<TItem>> — Sync per-appointment render hook (add CSS classes / styles / data-* attributes).
- `Culture`: CultureInfo — Culture for date formatting and first-day-of-week. Default CurrentCulture.
- `Data`: IEnumerable<TItem> — The appointment source.
- `Date`: DateTime — Initial date shown. Two-way bindable via DateChanged. Default today.
- `Height`: string — CSS height of the scheduler. Default "600px".
- `NextText`: string — Title/aria-label for the next-range arrow. Default "Próximo".
- `PrevText`: string — Title/aria-label for the previous-range arrow. Default "Anterior".
- `Schema`: SchedulerSchema<TItem> *required* — Immutable typed appointment projection and presentation schema.
- `SelectedIndex`: int — Index of the initially selected view. Default 0.
- `ShowDateTitle`: bool — Shows the current-range title in the header. Default true.
- `ShowHeader`: bool — Shows the navigation/view-switch header bar. Default true.
- `ShowNavigationButtons`: bool — Shows the prev/next arrow buttons in the header. Default true.
- `ShowTodayButton`: bool — Shows the "today" button in the header. Default true.
- `SlotRender`: Action<SchedulerSlotRenderEventArgs> — Sync per-slot render hook.
- `TodayText`: string — Label for the "today" button. Default "Hoje".
Events:
- `AppointmentMouseEnter`: EventCallback<SchedulerAppointmentMouseEventArgs<TItem>> — Fires when the pointer enters an appointment. Wiring it enables hover handling.
- `AppointmentMouseLeave`: EventCallback<SchedulerAppointmentMouseEventArgs<TItem>> — Fires when the pointer leaves an appointment.
- `AppointmentMove`: EventCallback<SchedulerAppointmentMoveEventArgs> — Fires when an appointment is dropped on a slot. Wiring it enables drag-and-drop.
- `AppointmentSelect`: EventCallback<SchedulerAppointmentSelectEventArgs<TItem>> — Fires when an appointment is clicked.
- `DateChanged`: EventCallback<DateTime> — Fires when the displayed date changes (navigation / today).
- `DaySelect`: EventCallback<SchedulerDaySelectEventArgs> — Fires when a day header / day number is clicked.
- `LoadData`: EventCallback<SchedulerLoadDataEventArgs> — Fires when the visible range changes — hook for server-side appointment loading.
- `MonthSelect`: EventCallback<SchedulerMonthSelectEventArgs> — Fires when a month header is clicked (year-style views).
- `MoreSelect`: EventCallback<SchedulerMoreSelectEventArgs> — Fires when the "+N more" overflow link is clicked.
- `SlotSelect`: EventCallback<SchedulerSlotSelectEventArgs> — Fires when an empty time slot is clicked.
- `TodaySelect`: EventCallback<SchedulerTodaySelectEventArgs> — Fires when the "today" button is clicked (before the date moves).
Slots:
- `ChildContent`: RenderFragment — The views (e.g. <OmniDayView/> <OmniWeekView/> <OmniMonthView/>).
- `NavigationTemplate`: RenderFragment — Replaces the entire built-in navigation bar.
- `Template`: RenderFragment<TItem> (context: TItem) — Custom appointment content. Receives the original TItem. Falls back to the projected text.

### OmniSchedulerForm
CRUD-enabled Scheduler that edits detached drafts through OmniDataForm and the shared headless entity coordinator.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniSchedulerForm.razor_

Parameters:
- `AppointmentRender`: Action<SchedulerAppointmentRenderEventArgs<TItem>> — Per-appointment render hook.
- `Date`: DateTime — Current Scheduler date.
- `Disabled`: bool — Disables generated entity operations.
- `EditorSchema`: EntityEditorSchema<TItem, TKey> *required* — Reusable DataForm and CRUD definition.
- `Items`: IList<TItem> *required* — Mutable appointment snapshot rendered by the Scheduler.
- `MaximumItems`: int — Maximum local appointment count.
- `MinimumItems`: int — Minimum local appointment count.
- `Provider`: IOmniEntityMutationProvider<TItem, TKey> — Optional persistence provider. The owner refreshes Items when requested.
- `ReadOnly`: bool — Makes generated entity operations read-only.
- `SchedulerClass`: string — Additional CSS class applied directly to the Scheduler.
- `SchedulerSchema`: SchedulerSchema<TItem> *required* — Strongly typed appointment projection and Scheduler defaults.
- `SchedulerStyle`: string — Additional inline styles applied directly to the Scheduler.
- `SelectedIndex`: int — Initially selected Scheduler view index.
- `SlotFactory`: Func<SchedulerSlotSelectEventArgs, TItem> — Creates a prefilled draft from an empty Scheduler slot.
- `SlotRender`: Action<SchedulerSlotRenderEventArgs> — Per-slot render hook.
Events:
- `AppointmentMouseEnter`: EventCallback<SchedulerAppointmentMouseEventArgs<TItem>> — Raised when the pointer enters an appointment.
- `AppointmentMouseLeave`: EventCallback<SchedulerAppointmentMouseEventArgs<TItem>> — Raised when the pointer leaves an appointment.
- `AppointmentMove`: EventCallback<SchedulerAppointmentMoveEventArgs> — Raised when an appointment is moved.
- `AppointmentSelect`: EventCallback<SchedulerAppointmentSelectEventArgs<TItem>> — Raised after an appointment is selected for editing.
- `DateChanged`: EventCallback<DateTime> — Raised when Scheduler navigation changes the date.
- `ItemsChanged`: EventCallback<IList<TItem>> — Raised after a successful local mutation.
- `LoadData`: EventCallback<SchedulerLoadDataEventArgs> — Raised when the visible Scheduler range changes.
- `OperationCompleted`: EventCallback<EntityEditorOperationEventArgs<TItem, TKey>> — Raised after a successful generated CRUD operation.
- `OperationFailed`: EventCallback<EntityEditorOperationFailedEventArgs<TItem, TKey>> — Raised after a handled generated CRUD failure.
- `RefreshRequested`: EventCallback — Requests that the owner reload provider-backed Items.
- `SlotSelect`: EventCallback<SchedulerSlotSelectEventArgs> — Raised after an empty slot is selected.
Slots:
- `AppointmentTemplate`: RenderFragment<TItem> (context: TItem) — Typed appointment content.
- `NavigationTemplate`: RenderFragment — Custom Scheduler navigation content.
- `ToolbarContent`: RenderFragment — Additional editor toolbar content.
- `Views`: RenderFragment — Scheduler view declarations. Day, Week and Month are generated when omitted.

### OmniTree
OmniTree — hierarchical tree view (RadzenTree port).
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Data/Tree/OmniTree.razor_

Parameters:
- `AllowCheckChildren`: bool = true — When checking a node also checks all its descendants. Default true.
- `AllowCheckParents`: bool = true — When all children of a node are checked, the parent auto-checks. Default true.
- `AllowCheckboxes`: bool = false — Shows a tri-state checkbox on every node.
- `CheckedValues`: IEnumerable<object> — The set of checked values (two-way bindable).
- `Data`: IEnumerable — Data source for a data-bound tree (used with OmniTreeLevel).
- `Value`: object — The currently selected node's value (two-way bindable).
Events:
- `CheckedValuesChanged`: EventCallback<IEnumerable<object>> — Fired when the checked set changes (paired with CheckedValues for two-way binding).
- `Collapsed`: EventCallback<TreeEventArgs> — Fired after a node collapses.
- `Expand`: EventCallback<TreeExpandEventArgs> — Fired when a node is expanded — set args.Children here to lazy-load.
- `Expanded`: EventCallback<TreeEventArgs> — Fired after a node expands (post-load).
- `SelectionChanged`: EventCallback<TreeEventArgs> — Fired when the selection changes (carries value + text).
- `ValueChanged`: EventCallback<object> — Fired when the selected value changes (paired with Value for two-way binding).
Slots:
- `ChildContent`: RenderFragment — Inline content: OmniTreeItem and/or OmniTreeLevel.

### OmniTreeGrid
Accessible hierarchical data table with bounded lazy loading and selection.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniTreeGrid.razor_

Parameters:
- `AriaLabel`: string — Accessible label for the tree grid.
- `Children`: Func<TItem, IEnumerable<TItem>> — Synchronous child selector for fully in-memory trees.
- `ChildrenProvider`: HierarchyChildrenProvider<TItem> — Asynchronous, cancellable lazy child source.
- `CollapseText`: string — Accessible label for collapsing a row.
- `EmptyText`: string — Empty-state text.
- `ExpandOnRowDoubleClick`: bool — Whether a row double-click toggles its expansion state.
- `ExpandText`: string — Accessible label for expanding a row.
- `ExpandedKeys`: IReadOnlyCollection<object> — Externally controlled expanded key set. Replace the collection when updating it.
- `HasChildren`: Func<TItem, bool> — Predicate indicating whether an item can be expanded.
- `IndentSize`: int — Indentation per hierarchy level in CSS pixels.
- `InitiallyExpanded`: Func<TItem, bool> — Optional predicate applied once when a data source is reset.
- `Items`: IEnumerable<TItem> — Root items in the hierarchy.
- `KeySelector`: Func<TItem, object> — Stable unique key selector. Keys identify expansion, cache and loading state; changing an item's key requires ReloadAsync.
- `LimitReachedText`: string — Template shown when the visible-row limit is reached.
- `LoadErrorText`: string — Message shown when lazy child loading fails.
- `MaxCachedItems`: int — Maximum total lazy-loaded child items retained in the LRU cache.
- `MaxCachedNodes`: int — Maximum lazy-loaded parent nodes retained in the LRU cache.
- `MaxChildrenPerNode`: int — Maximum children retained from a single lazy-load response.
- `MaxConcurrentLoads`: int — Maximum number of lazy child requests executed concurrently.
- `MaxDepth`: int — Maximum traversed hierarchy depth, protecting against cycles and pathological input.
- `MaxVisibleRows`: int — Maximum rows flattened and rendered at once.
- `RetryText`: string — Label for retrying a failed lazy load.
- `RowClass`: Func<TItem, string> — Optional row CSS class selector.
- `SelectedItem`: TItem — Currently selected row item for two-way binding.
Events:
- `ExpandedKeysChanged`: EventCallback<IReadOnlyCollection<object>> — Raised with an immutable snapshot after expansion changes.
- `LoadFailed`: EventCallback<Exception> — Raised when an uncancelled lazy-load operation fails.
- `RowSelected`: EventCallback<TItem> — Raised after a row is selected.
- `SelectedItemChanged`: EventCallback<TItem> — Raised when SelectedItem changes.
Slots:
- `Columns`: RenderFragment — Declarative OmniTreeGridColumn definitions.
- `EmptyTemplate`: RenderFragment — Optional empty-state content.

### OmniTreeGridColumn
Declarative column definition registered with a parent OmniTreeGrid.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniTreeGridColumn.razor_

Parameters:
- `Align`: TreeGridColumnAlign {Start | Center | End} — Horizontal cell alignment.
- `IsHierarchyAnchor`: bool — Marks this column as the hierarchy indentation/expansion anchor.
- `Property`: Func<TItem, object> — Raw value selector used by the default cell renderer.
- `TextSelector`: Func<TItem, string> — Text selector overriding Property formatting.
- `Title`: string — Column header text.
- `Width`: string — CSS width such as 240px or 30%.
Slots:
- `Template`: RenderFragment<TItem> (context: TItem) — Custom cell template receiving the row item.

### OmniTreeItem
A single node of an OmniTree.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Data/Tree/OmniTreeItem.razor_

Parameters:
- `Checkable`: bool = true — Whether this node's checkbox is enabled. Default true.
- `Expanded`: bool = false — Whether this node starts expanded.
- `HasChildren`: bool = false — Whether this node has children — shows the chevron even before children load (lazy).
- `Icon`: string — Optional leading icon name (Omni icon library).
- `Selected`: bool = false — Whether this node starts selected.
- `Text`: string — The node's text (used when no Template).
- `Value`: object — The value bound to this node (passed to events / selection / checks).
Slots:
- `ChildContent`: RenderFragment — Nested child nodes (inline) or data-bound children render fragment.
- `Template`: RenderFragment<OmniTreeItem> (context: OmniTreeItem) — Custom template (receives this item — use context.Value/context.Text).

### OmniTreeLevel
Declarative binding for one depth of a data-bound OmniTree.
_base: ComponentBase · source: src/Omni.Blazor/Components/Data/Tree/OmniTreeLevel.razor_

Parameters:
- `Checkable`: Func<object, bool> — Whether a node's checkbox is enabled. Default: all checkable.
- `Children`: Func<object, IEnumerable> — Selector for the enumerable that holds each node's children.
- `Expanded`: Func<object, bool> — Whether a node starts expanded.
- `HasChildren`: Func<object, bool> — Whether a node has children (controls the chevron). Defaults to "children non-empty".
- `Icon`: Func<object, string> — Leading-icon selector for each node.
- `Selected`: Func<object, bool> — Whether a node starts selected.
- `Text`: Func<object, string> — Text selector for each node. Falls back to ToString().
Slots:
- `Template`: RenderFragment<OmniTreeItem> (context: OmniTreeItem) — Per-node template (receives the OmniTreeItem; use context.Value/context.Text).

### OmniVirtualize
Thin wrapper over Blazor's built-in <Virtualize TItem="...">.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/OmniVirtualize.razor_

Parameters:
- `DefaultEmptyText`: string — Text shown when Items is empty and EmptyContent isn't set.
- `Height`: string — Fixed height for the scrolling viewport (default 400px). Pass null to let the parent size the container — useful when the virtualize lives inside a flex/grid pane that already constrains height. Virtualize`1 requires a bounded height to virtualize correctly; without one it will render every item.
- `ItemSize`: float — Estimated height of each row, in pixels. Default 50. Drives overscan + placeholder height.
- `Items`: ICollection<TItem> — Synchronous data source. Mutually exclusive with ItemsProvider.
- `ItemsProvider`: ItemsProviderDelegate<TItem> — Async/server-side data source. Mutually exclusive with Items.
- `OverscanCount`: int — Number of extra items to render outside the viewport. Default 3 (Blazor default).
- `SpacerElement`: string — HTML tag usada para os placeholders/spacers do Virtualize`1. Default "div". Use "tr" quando virtualizar dentro de um <tbody> (mantém semântica de tabela).
Slots:
- `EmptyContent`: RenderFragment — Custom empty state. If null, shows DefaultEmptyText.
- `ItemContent`: RenderFragment<TItem> (context: TItem) *required* — Template for each rendered item.
- `Placeholder`: RenderFragment<PlaceholderContext> (context: PlaceholderContext) — Template shown for items still being fetched (ItemsProvider mode).

### OmniWeekView
Seven-day week view with time slots.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniWeekView.razor_

Parameters:
- `EndTime`: TimeSpan — Last time slot of the day (exclusive). Default 24:00.
- `HeaderFormat`: string = ddd — Format for the day-of-week header. Default "ddd".
- `Icon`: string = calendar — Icon name shown on this view's switch tab. Default "calendar".
- `MinutesPerSlot`: int = 30 — Minutes per slot row. Default 30.
- `StartTime`: TimeSpan — First time slot of the day. Default 08:00.
- `Text`: string = Semana — Label shown on this view's switch tab. Default "Semana".
- `TimeFormat`: string = HH:mm — Time format for slot labels. Default "HH:mm".

### OmniWorkflowDesigner
Workflow composition surface with Diagram editing, bounded undo/redo, graph validation and a typed PropertyGrid inspector.
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Diagram/OmniWorkflowDesigner.razor_

Parameters:
- `CanvasClass`: string — Additional CSS class applied to the Diagram canvas.
- `CanvasStyle`: string — Additional inline styles applied to the Diagram canvas.
- `ConnectionFactory`: Func<DiagramConnectEventArgs, DiagramEdge> — Creates an edge for a completed connection. Omit to handle OnConnect externally.
- `Edges`: IReadOnlyList<DiagramEdge> — Controlled workflow edge snapshot.
- `FitOnMount`: bool — Fits the graph on first render.
- `InspectorAriaLabel`: string — Accessible inspector label.
- `InspectorEmptyText`: string — Inspector empty-state title.
- `InspectorSchema`: DataFormSchema<TNode> — Typed inspector schema used when a selected node carries TNode data.
- `InspectorTitle`: string — Inspector heading.
- `MaximumHistory`: int — Maximum retained undo entries. Default 50, maximum 200.
- `Nodes`: IReadOnlyList<DiagramNode> — Controlled workflow node snapshot.
- `PaletteAriaLabel`: string — Accessible palette label.
- `ReadOnly`: bool — Disables graph and inspector mutations.
- `RedoText`: string — Redo action text.
- `RunState`: DiagramRunState — Optional execution-state overlay.
- `Selection`: DiagramSelection — Controlled Diagram selection.
- `ShowAutoLayout`: bool — Shows the built-in auto-layout action.
- `ShowControls`: bool — Shows viewport controls.
- `ShowMinimap`: bool — Shows the canvas minimap.
- `ToolbarAriaLabel`: string — Accessible toolbar label.
- `UndoText`: string — Undo action text.
- `UpdateNode`: Func<DiagramNode, TNode, DiagramNode> — Projects an edited typed payload back into its Diagram node.
- `ValidationTitle`: string — Graph validation heading.
- `Validator`: Func<IReadOnlyList<DiagramNode>, IReadOnlyList<DiagramEdge>, IReadOnlyList<string>> — Bounded synchronous graph validator.
- `Viewport`: DiagramViewport — Controlled Diagram viewport.
Events:
- `EdgesChanged`: EventCallback<IReadOnlyList<DiagramEdge>> — Raised after workflow edges change.
- `InspectorChanged`: EventCallback<PropertyGridChangedEventArgs<TNode>> — Raised when an inspector property changes.
- `NodesChanged`: EventCallback<IReadOnlyList<DiagramNode>> — Raised after workflow nodes change.
- `OnConnect`: EventCallback<DiagramConnectEventArgs> — Raised for every completed connection gesture.
- `OnExternalDrop`: EventCallback<DiagramExternalDropEventArgs> — Raised for external canvas drops.
- `SelectionChanged`: EventCallback<DiagramSelection> — Raised after selection changes.
- `ViewportChanged`: EventCallback<DiagramViewport> — Raised after the viewport changes.
Slots:
- `EmptyContent`: RenderFragment — Content rendered when the workflow has no nodes.
- `InspectorEmptyContent`: RenderFragment — Custom content shown when no typed node is selected.
- `NodeTemplate`: RenderFragment<DiagramNode> (context: DiagramNode) — Custom Diagram node content.
- `PaletteContent`: RenderFragment — Optional left-side workflow palette.
- `ToolbarContent`: RenderFragment — Additional toolbar content.

### OmniYearPlannerView
Year planner: 12 month rows × day columns with appointment bars (mirrors RadzenYearPlannerView).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniYearPlannerView.razor_

Parameters:
- `Icon`: string = grid — Icon name shown on this view's switch tab. Default "grid".
- `Text`: string = Planner — Label shown on this view's switch tab. Default "Planner".

### OmniYearTimelineView
Year timeline: 12 month rows × day columns, connected timeline styling (mirrors RadzenYearTimelineView).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniYearTimelineView.razor_

Parameters:
- `Icon`: string = trending-up — Icon name shown on this view's switch tab. Default "trending-up".
- `Text`: string = Timeline — Label shown on this view's switch tab. Default "Timeline".

### OmniYearView
Twelve mini-month calendars (mirrors RadzenYearView).
_base: OmniComponent · source: src/Omni.Blazor/Components/Data/Scheduler/OmniYearView.razor_

Parameters:
- `Icon`: string = calendar — Icon name shown on this view's switch tab. Default "calendar".
- `Text`: string = Ano — Label shown on this view's switch tab. Default "Ano".

## Display

### OmniAccordion
Group of collapsible panels.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniAccordion.razor_

Parameters:
- `Mode`: AccordionMode {Single | Multi} = Single — Expansion behavior: Single (default) keeps only one item open at a time; Multi lets items expand independently.

### OmniAccordionItem
A single collapsible panel within an OmniAccordion, with a clickable header (icon + title) and an expandable body.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniAccordionItem.razor_

Parameters:
- `Disabled`: bool = false — When true, the header is disabled and the item cannot be toggled.
- `Expanded`: bool = false — Initial/bound expanded state; supports two-way binding via ExpandedChanged.
- `Icon`: string — Optional icon name rendered before the title in the header.
- `Title`: string — Plain-text header label, shown when TitleContent is not provided.
Events:
- `ExpandedChanged`: EventCallback<bool> — Fired when the item expands or collapses, carrying the new expanded state.
Slots:
- `TitleContent`: RenderFragment — Custom header markup; takes precedence over Title when set.

### OmniAlert
Inline banner — persists on the page (unlike Toast which auto-dismisses).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniAlert.razor_

Parameters:
- `Dismissible`: bool = false — When true, renders a close button that hides the alert.
- `Icon`: string — Overrides the default severity-based leading icon.
- `Severity`: NotificationSeverity {Info | Success | Warning | Error} = Info — Severity level (Info default) driving the color scheme and default icon.
- `Title`: string — Optional bold heading shown above the message.
Events:
- `OnClosed`: EventCallback — Fired after the alert is dismissed via the close button.
Slots:
- `Actions`: RenderFragment — Optional action buttons/links rendered below the message.

### OmniAvatar
Circular (or square) user avatar showing an image when available, otherwise fallback initials.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniAvatar.razor_

Parameters:
- `ImageUrl`: string — URL of the avatar image; when set, the image replaces the initials.
- `Initials`: string — Fallback text (typically 1-2 letters) shown when no image is provided; also used as the image alt text.
- `Size`: AvatarSize {Sm | Md | Lg | Xl | XXl} = Md — Avatar size (Md default): Sm, Md, Lg, Xl, or XXl.
- `Square`: bool = false — When true, renders a rounded-square avatar instead of a circle.

### OmniAvatarGroup
Overlapping stack of avatars with an optional "+N" overflow chip — for member lists, assignees, participants.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniAvatarGroup.razor_

Parameters:
- `More`: int — Overflow count rendered as a trailing "+N" chip.
- `Size`: AvatarSize {Sm | Md | Lg | Xl | XXl} = Md — Sizes the overlap + "+N" chip to match the avatars. Default Md.

### OmniBadge
Dual-mode badge:
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniBadge.razor_

Parameters:
- `AriaLabel`: string — Override aria-label of the badge bubble.
- `Bordered`: bool = false — Adds a contrast ring around the badge so it visually separates from the child.
- `Content`: object — Badge content — supports string or int. When int and value > Max, renders as "Max+" (e.g. "99+").
- `Dot`: bool = false — Render as a small dot (no text/icon). Use for "new notification" indicators.
- `Icon`: string — Optional icon at the start of the badge (or inside the overlay bubble).
- `Max`: int = 99 — Numeric cap. When Content is an int > Max, renders "Max+". Default 99.
- `Origin`: BadgeOrigin {TopEnd | TopStart | BottomEnd | BottomStart} = TopEnd — Anchor corner. TopEnd (default) puts the badge in the top-right corner.
- `Overlap`: bool = false — Inset the badge over the wrapped child (recommended for round targets — avatars, icon buttons).
- `Text`: string — Badge label (standalone mode). Ignored in overlay mode if Content is set.
- `Variant`: BadgeVariant {Default | Good | Warn | Danger | Info | Accent | Plain | Solid} = Default — Visual color variant.
- `Visible`: bool = true — Toggle badge visibility (the wrapped child still renders). Default true.
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Fires on click of the badge bubble (NOT the wrapped child).

### OmniBarcode
Renders a 1D barcode (Code128 / Code39 / EAN-13 / EAN-8 / UPC-A) as inline SVG.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniBarcode.razor_

Parameters:
- `AriaLabel`: string — aria-label customizado. Default = Value.
- `Background`: string =  — Cor de fundo. Default vazio (transparente — herda o container).
- `BarHeight`: double = 60 — Altura das barras em unidades de viewBox. Default 60.
- `FontSize`: double = 10 — Tamanho da fonte do texto inferior em unidades de viewBox. Default 10.
- `Foreground`: string = var(--omni-fg) — Cor das barras (qualquer CSS color). Default --omni-fg.
- `Height`: string — CSS height inline. Ex: "80px".
- `QuietZoneModules`: int = 10 — Margem em torno do código (em módulos). Default 10 (recomendação ISO).
- `ShowValue`: bool = true — Exibir o valor decifrado embaixo do código. Default true.
- `Stretch`: bool = true — Esticar o SVG para preencher o container (preserveAspectRatio=none). Default true — permite controle exclusivo via CSS width/height.
- `Type`: BarcodeType {Code128 | Code39 | Ean13 | Ean8 | UpcA} = Code128 — Símbologia. Default Code128.
- `Value`: string *required* =  — Conteúdo a codificar. Vazio renderiza placeholder vazio.
- `Width`: string — CSS width inline (atalho para style). Ex: "240px".

### OmniCard
Structural card container — a flex column whose direct children carry roles (header / body / media / footer), mirroring Bootstrap's `.card`.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniCard.razor_

Parameters:
- `Clickable`: bool = false — Applies pointer cursor + hover lift (card-as-link).
- `Elevated`: bool = false — Adds a shadow to lift the card.
- `Flat`: bool = false — Removes the border — variant for secondary regions.
- `Horizontal`: bool = false — Lays the card out horizontally (media beside body).
- `MaxBodyHeight`: string — When set, the body scrolls internally at this max height (scrollable card).
- `NoPadding`: bool = false — Escape-hatch: forces the body flush (no padding) even for mixed content.
- `Subtitle`: string — Subtitle shown below the title.
- `Title`: string — Title shown in the card header.
- `Tone`: CardTone {None | Accent | Neutral | Info | Success | Warning | Danger} = None — Thematic colour. Filled on the Default variant; border-only on Outline.
- `Variant`: CardVariant {Default | Accent | Outline} = Default — Visual variant: Default surface, Accent muted frame, or Outline.
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Raised when the card is clicked (also enables the clickable style).
Slots:
- `FooterContent`: RenderFragment — Footer content (CTAs, metadata).
- `HeaderActions`: RenderFragment — Actions rendered on the right side of the header.
- `HeaderContent`: RenderFragment — Custom header content (overrides Title/Subtitle).

### OmniCardBody
Structural card part — an explicit padded body section.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniCardBody.razor_

Parameters:
- `Divided`: bool = false — Draws a divider line above this section (Metronic-style grouped card).
- `NoPadding`: bool = false — Removes the section padding (flush content).

### OmniCardGroup
OmniCardGroup — connects several <OmniCard> into one segmented set (RadzenCardGroup port): no gaps, squared inner corners, rounded outer ends, shared 1px dividers.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniCardGroup.razor_

Parameters:
- `Orientation`: Orientation {Horizontal | Vertical} = Horizontal — Layout direction. Horizontal (default) connects side by side; Vertical stacks.
- `Responsive`: bool = true — When Horizontal, stack the cards once the group gets narrow. Default true.

### OmniCardMedia
Structural card part — a flush image / media block.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniCardMedia.razor_

Parameters:
- `Alt`: string — Alternative text for the image.
- `Height`: string — Optional fixed height (e.g. "160px").
- `Position`: CardMediaPosition {Top | Bottom | Overlay | Start | End} = Top — Where the media sits in the card. Default Top.
- `Src`: string — Image URL. When set, renders an <img>.

### OmniCarousel
OmniCarousel — a slideshow that cycles through <OmniCarouselItem> slides (RadzenCarousel port).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniCarousel.razor_

Parameters:
- `AllowNavigation`: bool = true — Whether the prev/next buttons are shown. Default true.
- `AllowPaging`: bool = true — Whether the pager dots are shown. Default true.
- `AllowScroll`: bool = true — Whether the user can scroll/swipe between slides. Default true.
- `AnimationDuration`: double — Slide transition duration (ms). null = default smooth (~400ms), 0 = instant.
- `Auto`: bool = true — Whether the carousel auto-cycles. Default true.
- `ButtonSize`: ComponentSize {Sm | Md | Lg | Xl} = Lg — Size of the prev/next buttons. Default Lg.
- `ButtonVariant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Ghost — Variant of the prev/next buttons. Default Ghost.
- `Interval`: double = 4000 — Auto-cycle interval in milliseconds. Default 4000.
- `ItemsPerPage`: int = 1 — Number of slides visible at once. Default 1.
- `NextAriaLabel`: string — Accessible label for the next button. Default "Próximo slide".
- `NextIcon`: string = chevron-right — Next-button icon name. Default "chevron-right".
- `NextText`: string =  — Optional next-button text.
- `PagerButtonAriaLabelFormat`: string = Ir para o slide {0} — Format string for each pager dot's aria-label ({0} = 1-based page). Default "Ir para o slide {0}".
- `PagerOverlay`: bool = true — Whether the pager overlays the slides (vs. sitting outside). Default true.
- `PagerPosition`: CarouselPagerPosition {Top | Bottom | TopAndBottom} = Bottom — Pager (dots) position. Default Bottom.
- `PrevAriaLabel`: string — Accessible label for the previous button. Default "Slide anterior".
- `PrevIcon`: string = chevron-left — Previous-button icon name. Default "chevron-left".
- `PrevText`: string =  — Optional previous-button text (shown alongside / instead of the icon).
- `SelectedIndex`: int = 0 — Index of the active slide. Two-way bindable via @bind-SelectedIndex.
Events:
- `Change`: EventCallback<int> — Raised when the active slide changes (general-purpose event).
- `SelectedIndexChanged`: EventCallback<int> — Raised when the active slide changes (binding callback).

### OmniCarouselItem
OmniCarouselItem — a single slide inside an <OmniCarousel>.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniCarouselItem.razor_

Slots:
- `ChildContent`: RenderFragment — The slide content.

### OmniChart
SVG chart supporting cartesian, stacked, scatter, bubble, radar, gauge, pie, donut and waterfall series.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniChart.razor_

Parameters:
- `AriaLabel`: string — aria-label customizado.
- `ColorScheme`: ChartColorScheme {Palette | Accent | Pastel | Semantic} = Palette — Esquema de cores das séries. Default Palette.
- `DonutCenterLabel`: string — Rótulo central de um chart Donut (linha superior, pequena).
- `DonutCenterValue`: string — Valor central de um chart Donut (linha inferior, grande).
- `Height`: string = 260px — Altura CSS do chart. Default "260px".
- `LegendPosition`: ChartLegendPosition {Top | Right | Bottom | Left | None} = Bottom — Posição da legenda. Default Bottom.
- `Schema`: ChartSchema — Optional immutable fluent schema. When supplied, it provides series and presentation defaults.
- `Series`: IEnumerable<ChartSeries> — As séries do chart. Para Pie/Donut, apenas a primeira é usada.
- `ShowGrid`: bool = true — Mostra as linhas horizontais de grid. Default true.
- `Title`: string — Título reservado para futuro header (atualmente não renderizado).
- `ValueFormatter`: Func<double, string> — Formatador customizado para o eixo de valores. Default v.ToString("0.##").
- `ValueTicks`: int = 5 — Número desejado de ticks no eixo de valores. Default 5.
- `Width`: string = 100% — Largura CSS do chart. Default "100%".

### OmniChip
Compact pill/tag button — optional dot and icon, with active/accent/static visual states.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniChip.razor_

Parameters:
- `Accent`: bool = false — When true, applies the accent color styling.
- `Active`: bool = false — When true, applies the active/selected visual state.
- `Icon`: string — Optional icon name rendered before the text.
- `ShowDot`: bool = false — When true, shows a small leading status dot.
- `Static`: bool = false — When true, renders as a non-interactive (display-only) chip.
- `Text`: string — Chip label text, used when no ChildContent is supplied.
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Fired when the chip is clicked.

### OmniDescriptionItem
A single term/value pair for OmniDescriptionList.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniDescriptionItem.razor_

Parameters:
- `Term`: string — The label (term).

### OmniDescriptionList
Read-only key/value detail layout (term + value pairs) — the standard "detail / review / summary" primitive for entity pages, settings summaries and review-before-submit.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniDescriptionList.razor_

Parameters:
- `Bordered`: bool = false — Wrap the list in a bordered card surface.
- `Columns`: int = 2 — Term/value pairs per row on wide containers. Collapses to 1 when narrow. Default 2.

### OmniEmptyState
Empty / zero-data placeholder — for empty lists, no search results, first-run states, empty inboxes, cleared filters.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniEmptyState.razor_

Parameters:
- `Compact`: bool = false — Reduced padding for tight panels / dropdowns.
- `Description`: string — Supporting text (plain). Ignored when DescriptionContent is set.
- `Icon`: string = inbox — Icon name (any OmniIcon). Default inbox.
- `Title`: string — Short headline (e.g. "Nenhum resultado").
Slots:
- `Actions`: RenderFragment — Action buttons row (e.g. "Criar primeiro item").
- `DescriptionContent`: RenderFragment — Rich supporting content (overrides Description).
- `Visual`: RenderFragment — Custom figure/illustration replacing the default icon.

### OmniIcon
Render nothing when the icon name is unknown — emitting an empty wrapper span would (1) reserve layout space for a glyph that won't paint and (2) defeat CSS-only `:empty`/`:has()` consumers (e.g.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniIcon.razor_

Parameters:
- `Name`: string *required* =  — Required icon name looked up in OmniIconLibrary; an unknown name renders nothing.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Icon size (Md default): Sm, Md, Lg, or Xl.

### OmniImage
OmniImage — a thin, consistent <img> wrapper (RadzenImage port).
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniImage.razor_

Parameters:
- `Alt`: string =  — Alt text — describe the image, or leave empty for purely decorative images.
- `Fit`: ObjectFit {Fill | Contain | Cover | None | ScaleDown} = Fill — How the image fills its box (CSS object-fit). Needs a sized box (width/height).
- `Lazy`: bool = true — Native lazy loading (loading="lazy"). Default true.
- `Src`: string — Image source (URL, app path, or a data: URI).
Events:
- `Click`: EventCallback<MouseEventArgs> — Makes the image interactive (renders as a button, Enter/Space activate).

### OmniKbd
Renders a keyboard key/shortcut as a styled <kbd> element.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniKbd.razor_

Parameters:
- `Text`: string — Key text to display, used when no ChildContent is supplied.

### OmniLabel
Standalone <label> element for cases where OmniFormField is overkill (custom controls, plain text + value pairs, group of segmented buttons, etc.).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniLabel.razor_

Parameters:
- `Disabled`: bool = false — Estado desabilitado — só altera a aparência (label não é interativa).
- `For`: string — ID do elemento associado (atributo for). Quando vazio, renderiza como <span> sem associação semântica.
- `Helper`: string — Texto auxiliar exibido em linha separada abaixo (cor muted, fonte menor).
- `Required`: bool = false — Exibe asterisco * em cor de erro depois do texto.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho do texto. Sm = 11px caixa alta (compacto, próximo de inputs). Md = 14px (default). Lg = 16px (destacado).
- `Text`: string — Texto da label. Ignorado quando ChildContent é definido.

### OmniLink
Styled <a> tag for navigation/text links.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniLink.razor_

Parameters:
- `Disabled`: bool = false — Estado desabilitado — renderiza como span sem href.
- `Href`: string — URL/path de destino. Para click handler puro sem navegação, use OnClick.
- `Icon`: string — Ícone antes do texto.
- `ShowExternalIcon`: bool = true — Mostra ícone de "external-link" automaticamente quando Target="_blank". Default true.
- `Target`: string — Atributo target da tag a. _blank ativa rel="noopener noreferrer" automaticamente.
- `Text`: string — Texto do link. Ignorado quando ChildContent é definido.
- `TrailingIcon`: string — Ícone após o texto.
- `Underline`: bool = false — Sublinha o texto. Default false (sublinha só no hover).
- `Variant`: LinkVariant {Default | Muted | Danger} = Default — Variante visual: Default (accent), Muted (fg-soft), Danger.
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Callback opcional. Quando definido, previne navegação default (href é só para fallback de a11y).

### OmniMarkdown
OmniMarkdown — renders CommonMark-ish Markdown as HTML (RadzenMarkdown port).
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniMarkdown.razor_

Parameters:
- `AllowHtml`: bool = false — When true, embedded raw HTML is sanitized and rendered; when false (default) it is escaped and shown literally. Only enable for trusted content — the sanitizer is best-effort.
- `Text`: string — The markdown source. Takes precedence over ChildContent.
Slots:
- `ChildContent`: RenderFragment — Markdown written raw between the tags (text frames are concatenated).

### OmniOptionCard
Selectable option card (radio-style) — for choosing one option among several: plans, payment methods, shipping options, account types.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniOptionCard.razor_

Parameters:
- `Badge`: string — Small badge after the title (e.g. "POPULAR").
- `Description`: string — Supporting description.
- `Disabled`: bool = false — Disable the card.
- `Price`: string — Price (mono).
- `PricePeriod`: string — Price period suffix (e.g. "/mês").
- `Selected`: bool = false — Selected state (radio).
- `Title`: string — Option name.
Events:
- `OnClick`: EventCallback — Click handler — the consumer sets which card is selected.
- `SelectedChanged`: EventCallback<bool> — Convenience: fires true when the card is clicked.

### OmniProgress
Horizontal progress bar, or a segmented variant (e.g.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniProgress.razor_

Parameters:
- `Active`: int = 0 — Number of filled segments (segmented mode); also drives the strength color via omni-s1..s4.
- `Color`: string — Optional arbitrary CSS colour for the bar (overrides Variant).
- `Max`: double = 100 — Value that represents 100% fill. Default 100.
- `Segments`: int = 0 — If > 0, render as segmented progress (used for password strength).
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Bar thickness (Md default): Sm, Md, or Lg.
- `Value`: double = 0 — Current progress value (relative to Max); clamped to 0-100% of the bar width.
- `Variant`: BadgeVariant {Default | Good | Warn | Danger | Info | Accent | Plain | Solid} = Accent — Color variant of the bar fill (Accent default); Good/Warn/Danger map to semantic colors.

### OmniProgressCircular
OmniProgressCircular — an SVG ring progress indicator (RadzenProgressBarCircular port).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniProgressCircular.razor_

Parameters:
- `AriaLabel`: string — Accessible label for the progressbar.
- `Color`: string — Optional arbitrary CSS colour for the arc (overrides Variant).
- `Indeterminate`: bool = false — Continuous indeterminate spinner (ignores Value). Default false.
- `Max`: double = 100 — Maximum value. Default 100.
- `Min`: double = 0 — Minimum value. Default 0.
- `ShowValue`: bool = true — Whether to show the centred value/label. Default true.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Ring size. Default Md.
- `Unit`: string = % — Unit suffix appended after the value in the centre label. Default "%".
- `Value`: double = 0 — Current progress value (between Min and Max).
- `Variant`: BadgeVariant {Default | Good | Warn | Danger | Info | Accent | Plain | Solid} = Accent — Semantic colour of the progress arc. Default Accent.

### OmniQRCode
Renders a QR code as inline SVG.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniQRCode.razor_

Parameters:
- `AriaLabel`: string — aria-label customizado (default = Value).
- `Background`: string =  — Cor de fundo (vazio = transparente).
- `Ecc`: QRCodeEcc {Low | Medium | Quartile | High} = Medium — Nível de correção de erro. Default Medium (~15% de tolerância).
- `EyeColor`: string — Cor opcional dos olhos (override do Foreground).
- `EyeShape`: QRCodeEyeShape {Square | Rounded | Framed} = Square — Forma dos três "olhos" (finder patterns). Default Square.
- `Foreground`: string = var(--omni-fg) — Cor dos módulos. Default --omni-fg.
- `Image`: string — Imagem central (data URL ou caminho). Opcional.
- `ImageBackground`: string = var(--omni-bg-elev) — Cor de fundo do recorte ao redor da imagem. Default --omni-bg-elev.
- `ImagePadding`: double = 1 — Padding em módulos ao redor da imagem. Default 1.
- `ImageSizePercent`: double = 20 — % do tamanho total ocupado pela imagem (5..50). Default 20.
- `ModuleShape`: QRCodeModuleShape {Square | Rounded | Circle} = Square — Forma dos módulos. Default Square.
- `QuietZone`: int = 4 — Quiet zone em módulos. ISO recomenda 4. Default 4.
- `Size`: string = 200px — CSS size — aplicado como width=height. Default "200px".
- `Value`: string *required* =  — Conteúdo a codificar. UTF-8 / Byte mode (suporta acentos e qualquer Unicode).

### OmniResult
Full-page / full-panel status outcome block — the generic primitive behind 404 / 403 / 500 / "access denied" / "payment complete" / maintenance pages.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniResult.razor_

Parameters:
- `Compact`: bool = false — Render with reduced padding (inside a card/panel rather than full-page).
- `Description`: string — Supporting text (plain). Ignored when DescriptionContent is set.
- `Icon`: string — Override the status icon (any OmniIcon name).
- `Status`: ResultStatus {Info | Success | Warning | Error | Forbidden | NotFound | Maintenance} = Info — Outcome status — drives the icon and color tone. Default Info.
- `Title`: string — Headline.
Slots:
- `Actions`: RenderFragment — Action buttons row rendered under the text.
- `DescriptionContent`: RenderFragment — Rich supporting content (overrides Description).
- `Visual`: RenderFragment — Custom figure/illustration replacing the default icon badge.

### OmniSkeleton
Animated placeholder for loading content.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniSkeleton.razor_

Parameters:
- `Height`: string — Inline CSS height — only used by Rect/Circle variants. Optional.
- `Lines`: int = 1 — Number of text lines (Text variant only). Default 1.
- `Variant`: SkeletonVariant {Text | Rect | Circle} = Text — Placeholder shape (Text default): Text (line/paragraph), Rect (block), or Circle.
- `Width`: string — Inline CSS width — e.g. "100%", "240px", "12rem". Optional.

### OmniSparkline
Mini chart inline em SVG — pra trends rápidos em Stat cards, células de tabela, headers de listas, parágrafos de texto.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniSparkline.razor_

Parameters:
- `AreaOpacity`: double = 0.18 — Fill opacity for Area variant. 0–1, default 0.18.
- `AriaLabel`: string — aria-label override. Defaults to "Sparkline".
- `BarGap`: double = 2 — Spacing between bars/columns in PIXELS. Default 2.
- `Color`: string — Stroke/fill color (any CSS color). Defaults to --omni-accent.
- `Data`: IEnumerable<double> — Sequence of numbers to chart. Empty/null = nothing rendered.
- `PieInnerRadius`: double = 0 — Raio interno do donut em Pie (0–0.9 do raio externo). 0 = pie sólido, 0.5 = donut médio. Default 0 (pie).
- `PiePalette`: IReadOnlyList<string> — Paleta de cores pro variant Pie. Se vazia, usa accent com variação de opacidade pra distinguir slices. Cores são repetidas ciclicamente se houver mais valores que cores.
- `ShowAllMarkers`: bool = false — Show dots at ALL data points (Line/Area only). Sobrescreve ShowMarker — se true, marca todos.
- `ShowMarker`: bool = false — Show a dot at the LAST data point (Line/Area only).
- `Smooth`: bool = false — Suaviza a curva (Line/Area) usando monotone cubic Bezier — preserva monotonicidade dos dados (não inventa picos/vales). Mesmo algoritmo que RadzenLineSeries Smooth="true" usa. Não tem efeito em Column/Bar/Pie. Default false.
- `StrokeWidth`: double = 1.8 — Stroke width em PIXELS. Default 1.8.
- `Variant`: SparklineVariant {Line | Area | Column | Bar | Pie} = Line — Visual variant — Line, Area, Column, Bar, Pie.

### OmniSpinner
Pure-CSS circular spinner.
_base: OmniComponent · source: src/Omni.Blazor/Components/Display/OmniSpinner.razor_

Parameters:
- `Label`: string — Accessible label for screen readers (aria-label). Defaults to "Carregando".
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Spinner size (Md default): Sm, Md, Lg, or Xl.

### OmniStat
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniStat.razor_

Parameters:
- `Card`: bool = false — Wraps the stat in a bordered card surface.
- `Delta`: string — Trend delta (e.g. "+18,4%"). Colour follows DeltaDown.
- `DeltaCaption`: string — Neutral caption after the delta (e.g. "vs ontem").
- `DeltaDown`: bool = false — Renders the delta in the "down" colour.
- `Icon`: string — Optional icon shown in a chip next to the label.
- `Label`: string — Uppercase label above the value.
- `Value`: string *required* =  — The metric value (large).
Slots:
- `Visual`: RenderFragment — Decorative visual (e.g. a sparkline) anchored to the bottom-right.

### OmniStatGroup
Responsive KPI strip — lays out a set of OmniStat cards in an even grid that collapses (Columns → 2 → 1) as the container narrows (container query, so it reacts to its own width, not the viewport).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniStatGroup.razor_

Parameters:
- `Columns`: int = 4 — Desired columns on wide containers. Collapses to 2 then 1 as it narrows. Default 4.

### OmniStatusBadge
Pílula compacta de status — primitivo do design system para indicar estado operacional (caixa aberto, API online, sincronizando, fila vazia, etc.).
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniStatusBadge.razor_

Parameters:
- `AriaLabel`: string — Sinaliza ao screen-reader o significado do estado.
- `Kind`: StatusBadgeKind {Neutral | Accent | Good | Warn | Danger} = Neutral — Intent semântico do estado.
- `Label`: string — Rótulo principal — destacado na cor do Kind.
- `Meta`: string — Texto secundário (relógio, contador, percentual) — renderizado em monoespaçada apagada, separado do label por "·".
- `Pulse`: bool = false — Anel pulsante no dot — use para indicar "ao vivo".
Slots:
- `ChildContent`: RenderFragment — Conteúdo livre — alternativa ao parâmetro Label.

### OmniTimeline
OmniTimeline — vertical/horizontal sequence of events along a connecting line, inspired by RadzenTimeline.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniTimeline.razor_

Parameters:
- `LinePosition`: TimelineLinePosition {Center | Start | End | Alternate} = Center — Where the line sits relative to content (Center/Start/End/Alternate).
- `Orientation`: Orientation {Horizontal | Vertical} = Vertical — Vertical (column, default) or Horizontal (row) flow.
- `Reverse`: bool = false — Reverses the visual side of content (swaps opposite/main).

### OmniTimelineItem
A single event on an <OmniTimeline>.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Display/OmniTimelineItem.razor_

Parameters:
- `Label`: string — Opposite-side text shorthand (rendered after LabelContent).
- `PointSize`: ComponentSize {Sm | Md | Lg | Xl} = Md — Point size. Default Md.
- `PointStyle`: TimelinePointStyle {Base | Accent | Good | Warn | Danger | Info} = Base — Color/intent of the point. Default Base.
- `PointVariant`: TimelinePointVariant {Filled | Outlined | Text} = Filled — Fill variant of the point. Default Filled.
- `Text`: string — Main content text shorthand (rendered after ChildContent).
Slots:
- `ChildContent`: RenderFragment — Main content. Rendered before Text.
- `LabelContent`: RenderFragment — Opposite-side content (date/label). Rendered before Label.
- `PointContent`: RenderFragment — Content rendered inside the dot (icon, letter, avatar…).

## Forms

### OmniCompareValidator
Compara o valor de um campo com outro campo (lookup por nome) OU com um valor literal. Caso clássico: "confirmar senha". Cuidado especial: revalida automaticamente quando o campo de referência muda (não só quando o próprio campo muda). <OmniTextBox Name="password" @bind-Value="model.Password" /> <OmniTextBox Name="confirm" @bind-Value="model.Confirm" /> <OmniCompareValidator Component="confirm" Value="@model.Password" Text="Senhas não conferem." />
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniCompareValidator.cs_

Parameters:
- `Operator`: CompareOperator {Equal | NotEqual | LessThan | LessThanEqual | GreaterThan | GreaterThanEqual} = Equal — Operador. Default Equal.
- `OtherComponent`: string — Nome de OUTRO componente cujo valor será comparado.
- `Value`: object — Valor literal a comparar. Use Value OU OtherComponent, não ambos.

### OmniCustomValidator
Validator custom com delegate Func`2 tipado. Diferença pro RadzenCustomValidator: Radzen usa Func<bool> (sem o valor), forçando closure sobre o model. Aqui o delegate recebe o valor atual do campo já tipado, fica mais reutilizável e testável. <OmniCustomValidator TValue="string" Component="username" Validator="@IsAvailable" Text="Usuário já existe." /> @code { bool IsAvailable(string? value) => !usedNames.Contains(value); } Pra lógica assíncrona (consulta server), prefira o Validation do FormComponent per-input que aceita Func<T, Task<string?>>.
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniCustomValidator.cs_

Parameters:
- `Validator`: Func<TValue, bool> *required* — Função de validação. Retorna true = OK, false = inválido.

### OmniDataAnnotationValidator
Valida um único campo do model contra TODOS os ValidationAttributes declarados na propriedade ([Required], [StringLength], [EmailAddress], etc.). Diferente do <DataAnnotationsValidator /> nativo do Blazor (que valida o model inteiro), este focaliza um único campo — útil quando você está montando regras campo a campo no markup, junto com outros validators irmãos.<OmniDataAnnotationValidator Component="email" Property="@(() => model.Email)" />O OmniForm já tem AddDataAnnotationsValidator=true por default — você raramente precisa deste validator individual. Use quando quiser desligar o DataAnnotationsValidator global e ter controle fino por campo.
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniDataAnnotationValidator.cs_

Parameters:
- `MessageSeparator`: string = ;  — Separador quando múltiplos atributos falham. Default "; ".
- `Property`: Expression<Func<object>> *required* — Expressão do campo que fornece, de forma trim-safe, a propriedade e os atributos declarados no modelo.

### OmniDataForm
Metadata-driven form that composes a reusable strongly typed field schema, generated Omni inputs, Blazor's EditContext and data annotation validators.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Forms/OmniDataForm.razor_

Parameters:
- `AddDataAnnotationsValidator`: bool — Auto-attaches a DataAnnotationsValidator. Default true.
- `Columns`: int — Optional root column override. When null, the schema responsive layout is used. Values are clamped from 1 to 12.
- `Disabled`: bool — Disables every generated editor and the default submit button.
- `EditContext`: EditContext — Existing Blazor edit context. Supply either EditContext or Model, never both. Its model must be a TModel instance.
- `FocusFirstInvalidOnSubmit`: bool — Scrolls to and focuses the first invalid generated field after submit. Default true.
- `IsTouched`: bool — Whether any generated field has changed since the last touched reset.
- `Model`: TModel — Model instance edited by the generated fields. Supply either Model or EditContext, never both.
- `ReadOnly`: bool — Makes every generated editor read-only.
- `RenderFormElement`: bool — Renders the semantic HTML form element. Disable for an embedded collection item subform to avoid nested forms. Default true.
- `Schema`: DataFormSchema<TModel> — Immutable, reusable field schema. When omitted, every supported model property is inferred from its type and data annotations.
- `ShowDiagnostics`: bool — Shows schema diagnostics in the rendered form. Intended for development. Default false.
- `ShowSubmitButton`: bool — Shows the built-in submit button when Actions is null. Default true.
- `ShowValidationSummary`: bool — Shows OmniValidationSummary above the fields. Default true.
- `SubmitText`: string — Text displayed by the built-in submit button. Null uses the localized OmniTexts value.
- `Submitting`: bool — Displays the loading state on the built-in submit button.
- `Validation`: Action<EditContext, ValidationMessageStore> — Synchronous cross-field validation delegated to the underlying OmniForm.
- `ValidationAsync`: Func<EditContext, ValidationMessageStore, Task> — Asynchronous validation delegated to the underlying OmniForm.
- `ValidationAsyncWithCancellation`: Func<EditContext, ValidationMessageStore, CancellationToken, Task> — Preferred cancellable asynchronous validation callback.
- `ValidationDelay`: int — Debounce in milliseconds for validation caused by field changes.
- `ValidationSummaryTitle`: string — Heading used by the generated validation summary. Null uses the localized OmniTexts value.
Events:
- `DiagnosticsChanged`: EventCallback<IReadOnlyList<DataFormDiagnostic>> — Invoked after schema diagnostics are rebuilt.
- `FieldChanged`: EventCallback<DataFormFieldChangedEventArgs<TModel>> — Invoked after a generated editor writes a property value.
- `FieldStateChanged`: EventCallback<DataFormFieldStateChangedEventArgs<TModel>> — Invoked with an immutable snapshot when one generated field state changes.
- `IsTouchedChanged`: EventCallback<bool> — Callback for two-way binding of IsTouched.
- `OnInvalidSubmit`: EventCallback<EditContext> — Invoked when the underlying OmniForm submission is invalid.
- `OnValidSubmit`: EventCallback<EditContext> — Invoked when the underlying OmniForm submission is valid.
- `ValidationStateChanged`: EventCallback<DataFormValidationStateChangedEventArgs<TModel>> — Invoked with the aggregate validation state after any field or message change.
Slots:
- `Actions`: RenderFragment — Custom action area. When supplied, it replaces the built-in submit button.
- `ChildContent`: RenderFragment — Additional content rendered inside the underlying form after generated fields.
- `DiagnosticsTemplate`: RenderFragment<IReadOnlyList<DataFormDiagnostic>> (context: IReadOnlyList<DataFormDiagnostic>) — Custom renderer for schema diagnostics.

### OmniDataFormWizard
Coordinates explicit DataForm schemas as validated steps over one shared EditContext and cancellable navigation state.
_base: OmniComponent · source: src/Omni.Blazor/Components/Forms/OmniDataFormWizard.razor_

Parameters:
- `ActiveStepIndex`: int — Zero-based visible step index.
- `AllowStepNavigation`: bool — Allows clicking accessible step navigation buttons. Default true.
- `BackText`: string — Overrides the Back action text.
- `CompleteText`: string — Overrides the Complete action text.
- `Disabled`: bool — Disables generated fields and navigation actions.
- `EditContext`: EditContext — Existing EditContext shared with the wizard. Supply EditContext or Model, never both.
- `Linear`: bool — Prevents jumping ahead of the furthest validated step. Default true.
- `Model`: TModel — Model used to create an owned EditContext. Supply Model or EditContext, never both.
- `NavigationLabel`: string — Accessible label for the step navigation.
- `NextText`: string — Overrides the Next action text.
- `RenderFormElement`: bool — Whether the active DataForm emits a semantic form element. Default true.
- `Schema`: DataFormWizardSchema<TModel> *required* — Immutable ordered wizard schema.
- `ShowValidationSummary`: bool — Shows validation messages above the current step. Default true.
Events:
- `ActiveStepIndexChanged`: EventCallback<int> — Two-way binding callback for ActiveStepIndex.
- `OnCompleted`: EventCallback<EditContext> — Raised after final synchronous, field and step validation succeeds.
- `StepChanged`: EventCallback<DataFormWizardStepChangedEventArgs<TModel>> — Raised after a successful step transition.
Slots:
- `ActionsTemplate`: RenderFragment<DataFormWizardTemplateContext<TModel>> (context: DataFormWizardTemplateContext<TModel>) — Custom typed action area replacing Back, Next and Complete.
- `HeaderTemplate`: RenderFragment<DataFormWizardTemplateContext<TModel>> (context: DataFormWizardTemplateContext<TModel>) — Custom typed current-step heading.

### OmniEmailValidator
Valida e-mail usando o mesmo motor do EmailAddressAttribute (suficientemente permissivo, RFC 5322 simplificado — o que [EmailAddress] usa). Vazio passa. <OmniEmailValidator Component="email" Text="E-mail inválido." />
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniEmailValidator.cs_


### OmniForm
Async validation and submission orchestration for OmniForm`1. Kept out of the Razor file so cancellation, latest-wins and exception-safety invariants remain reviewable independently from the markup.
_base: ComponentBase · accepts ChildContent · source: src/Omni.Blazor/Components/Forms/OmniForm.razor_

Parameters:
- `AddDataAnnotationsValidator`: bool — Auto-attach a DataAnnotationsValidator inside the form. Default true.
- `EditContext`: EditContext — Existing Blazor edit context. Supply either EditContext or Model, never both. Its model must be a TModel instance.
- `IsTouched`: bool — Fired the first time a field changes; stays true until reset. Bound parameter — write a backing field with @bind-IsTouched.
- `Model`: TModel — Model instance edited by the form. Supply either Model or EditContext, never both.
- `RenderFormElement`: bool — Renders the semantic HTML form element. Disable only when composing an embedded subform inside another form. Default true.
- `SnapshotFactory`: Func<TModel, TModel> — Optional AOT-safe deep-clone strategy used by Snapshot. Without it, OmniForm captures a shallow snapshot of writable public properties.
- `SnapshotRestorer`: Action<TModel, TModel> — Optional restore strategy paired with SnapshotFactory. It receives the current model first and the captured snapshot second.
- `Validation`: Action<EditContext, ValidationMessageStore> — Synchronous custom validation. Invoked on submit and on every field change (subject to ValidationDelay). Add messages to ValidationMessageStore directly, keyed by FieldIdentifier.
- `ValidationAsync`: Func<EditContext, ValidationMessageStore, Task> — Async custom validation — typically a server round-trip. Runs in the same lifecycle as Validation but awaited. On submit it is awaited fully before deciding valid/invalid; during field-change debounce, it runs on the trailing edge.
- `ValidationAsyncWithCancellation`: Func<EditContext, ValidationMessageStore, CancellationToken, Task> — Preferred cancellable async validation callback. It receives a token that is cancelled when a newer validation supersedes the current pass or when the form is disposed.
- `ValidationDelay`: int — Debounce (ms) applied to custom-validation firings caused by OnFieldChanged. Default 0 = no debounce (current behavior). Submits and explicit ValidateAsync calls bypass the delay.
Events:
- `IsTouchedChanged`: EventCallback<bool> — Callback for two-way binding of IsTouched.
- `OnInvalidSubmit`: EventCallback<EditContext> — Invoked when the form is submitted but validation fails.
- `OnValidSubmit`: EventCallback<EditContext> — Invoked when the form is submitted and passes validation.
Slots:
- `ChildContent`: RenderFragment — Form content — inputs, validators, and submit controls.

### OmniLengthValidator
Valida comprimento de string (ou tamanho de coleção ICollection). Vazio passa — componha com OmniRequiredValidator quando ambos forem necessários. <OmniLengthValidator Component="cnpj" Min="14" Max="14" Text="CNPJ deve ter 14 dígitos." />
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniLengthValidator.cs_

Parameters:
- `Max`: int — Comprimento máximo (inclusive). Null = sem limite superior.
- `Min`: int — Comprimento mínimo (inclusive). Null = sem limite inferior.

### OmniPropertyGrid
Compact metadata-driven property inspector built on OmniDataForm and its typed schema extensibility.
_base: OmniComponent · source: src/Omni.Blazor/Components/Forms/OmniPropertyGrid.razor_

Parameters:
- `AddDataAnnotationsValidator`: bool — Adds DataAnnotations validation to the inspector.
- `Disabled`: bool — Disables every generated property editor.
- `EditContext`: EditContext — Optional externally owned editing context.
- `Editable`: bool — Whether property editors are interactive. Default false.
- `Model`: TModel *required* — Inspected model.
- `RenderFormElement`: bool — Renders the semantic form element. Default false for inspector embedding.
- `Schema`: DataFormSchema<TModel> — Optional reusable DataForm schema. Metadata inference is used when omitted.
- `ShowValidationSummary`: bool — Shows the generated validation summary.
- `Title`: string — Optional inspector heading.
Events:
- `OnInvalidSubmit`: EventCallback<EditContext> — Raised after an invalid explicit submission.
- `OnValidSubmit`: EventCallback<EditContext> — Raised after a valid explicit submission.
- `PropertyChanged`: EventCallback<PropertyGridChangedEventArgs<TModel>> — Raised for each property change observed through the active EditContext.
Slots:
- `Actions`: RenderFragment — Optional generated-form actions.
- `HeaderContent`: RenderFragment — Content rendered beside the heading.

### OmniRangeValidator
Valida faixa numérica (int / double / decimal / DateTime). Aceita qualquer tipo que implemente IComparable. Vazio passa — componha com Required quando precisar. <OmniRangeValidator Component="idade" Min="18" Max="120" Text="Idade entre 18 e 120." />
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniRangeValidator.cs_

Parameters:
- `Max`: object — Valor máximo (inclusive).
- `Min`: object — Valor mínimo (inclusive).

### OmniRegexValidator
Valida string contra um padrão regex. Vazio passa. <OmniRegexValidator Component="cep" Pattern="^\\d{5}-\\d{3}$" Text="CEP deve ser 00000-000." />
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniRegexValidator.cs_

Parameters:
- `Options`: RegexOptions {None | IgnoreCase | Multiline | ExplicitCapture | Compiled | Singleline | IgnorePatternWhitespace | RightToLeft | ECMAScript | CultureInvariant | NonBacktracking} = None — Opções do regex. Default None.
- `Pattern`: string *required* =  — Pattern regex. .NET regex syntax (não JS).

### OmniRequiredValidator
Falha quando o campo está vazio. Verifica via HasValue — que cobre null, string vazia, e default(T) pra structs. <OmniRequiredValidator Component="email" Text="Informe o e-mail." />
_base: OmniValidatorBase · source: src/Omni.Blazor/Components/Forms/Validators/OmniRequiredValidator.cs_

Parameters:
- `DefaultValue`: object — Valor "default" customizado. Útil quando você quer que 0 seja válido pra um campo numérico (default), mas -1 não.

### OmniValidationMessage
Per-field error display.
_base: OmniComponent · source: src/Omni.Blazor/Components/Forms/OmniValidationMessage.razor_

Parameters:
- `For`: Expression<Func<TValue>> *required* — Lambda pointing at the field, e.g. () => model.Email.
- `ShowAll`: bool — Render all messages (default) or just the first.

### OmniValidationSummary
Styled validation summary — like Blazor's <ValidationSummary> but uses the `omni-alert omni-alert-danger` look.
_base: OmniComponent · source: src/Omni.Blazor/Components/Forms/OmniValidationSummary.razor_

Parameters:
- `Title`: string = Corrija os erros abaixo: — Heading shown above the error list; null/empty hides it. Default "Corrija os erros abaixo:".

## Inputs

### OmniAutoComplete
Search-as-you-type selection with bounded local or cancellable server-side data.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniAutoComplete.razor_

Parameters:
- `Clearable`: bool — Whether to show a clear button when a value is selected.
- `DebounceMs`: int — Debounce window applied to asynchronous searches.
- `EmptyText`: string — Text shown when no option matches.
- `Items`: IEnumerable<TItem> — Synchronous option source. Mutually exclusive with ItemsProvider.
- `ItemsProvider`: OmniItemsProvider<TItem> — Asynchronous, cancellable and paged option source.
- `LoadErrorText`: string — Text shown when the asynchronous provider fails.
- `LoadMoreText`: string — Text of the action that requests the next provider page.
- `LoadingText`: string — Text shown while an asynchronous page is loading.
- `MaxProviderItems`: int — Hard limit for options retained from one provider search.
- `MinSearchLength`: int — Minimum characters required before searching.
- `Placeholder`: string — Placeholder text shown in the search input.
- `ProviderPageSize`: int — Maximum number of options requested per provider page.
- `RetryText`: string — Text of the provider retry action.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} — Visual size of the input.
- `TextSelector`: Func<TItem, string> *required* — Required mapping from an option to its display text.
Events:
- `ItemsProviderFailed`: EventCallback<Exception> — Raised when an uncancelled provider request fails.
Slots:
- `ItemTemplate`: RenderFragment<TItem> (context: TItem) — Optional option template.

### OmniCalendar
Calendar grid.
_base: OmniComponent · source: src/Omni.Blazor/Components/Inputs/OmniCalendar.razor_

Parameters:
- `AutoFocus`: bool = false — Auto-focus the grid on first render so keyboard nav works without a click. Set to false when the calendar is rendered statically on the page (Inline mode without an opening trigger).
- `DateRender`: Action<DateRenderEventArgs> — Per-day render hook. Lets the consumer add a CSS class, set HTML attributes, or mark a date disabled — without touching the bound model. Mirrors Radzen's DateRender callback. Use it for holiday highlights, tooltips, anniversary markers, etc.
- `DisableWeekends`: bool = false — When true, Saturdays and Sundays are disabled. Default false.
- `DisabledDates`: Func<DateOnly, bool> — Predicate returning true to disable a specific day. Default null (none disabled).
- `FirstDayOfWeek`: DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday} — Which day starts the week. null respects the current culture (default for pt-BR is Sunday). Set explicitly for Monday-start in EU formats.
- `InitialViewDate`: DateOnly — Initial month/year to show when the calendar first mounts. Wins over Selected on the first render but does not override later navigation by the user.
- `MaxDate`: DateOnly — Latest selectable day; days after it are disabled.
- `MinDate`: DateOnly — Earliest selectable day; days before it are disabled.
- `RangeEnd`: DateOnly — End of the committed range; when both endpoints are set the band between them is painted solid.
- `RangeHoverEnd`: DateOnly — Tentative end of range under the mouse pointer. When set together with RangeStart (and RangeEnd is null), the calendar paints a preview band between start and this day so the user can see the candidate range before committing.
- `RangeStart`: DateOnly — Optional range — used by the date-range variant for hover/selection visuals.
- `Selected`: DateOnly — Currently selected single date. (Range mode handled by parent.)
- `ShowNavButtons`: bool = true — Show the prev/next month navigation chevrons. Default true.
- `ShowNextButton`: bool = true — Show the "next month" chevron. Useful to hide one side in a two-month layout.
- `ShowPrevButton`: bool = true — Show the "previous month" chevron. Useful to hide one side in a two-month layout.
- `ShowWeekNumbers`: bool = false — Show the ISO 8601 week number column on the left of the grid.
- `ViewMonth`: DateOnly — Month being displayed. Defaults to today's month (or Selected's month).
Events:
- `OnDateSelected`: EventCallback<DateOnly> — Fires when the user picks a day (click or keyboard Enter/Space) that passes the disabled checks.
- `OnDayHover`: EventCallback<DateOnly> — Fires as the mouse moves over (or leaves) day cells. Receives null on leave.
- `OnEscape`: EventCallback — Fires when the user presses Escape on the grid.
- `ViewMonthChanged`: EventCallback<DateOnly> — Fires when the displayed month changes (navigation, year pick, or keyboard paging).
Slots:
- `Footer`: RenderFragment — Slot rendered below the day grid (e.g. a "Today" button).

### OmniCheckBox
_base: FormComponent<T> · accepts ChildContent · form input · source: src/Omni.Blazor/Components/Inputs/OmniCheckBox.razor_

Parameters:
- `AriaLabel`: string — Accessible input name used when the checkbox has no visible label.
- `Label`: string — Text label shown next to the checkbox when no ChildContent is provided.
Slots:
- `ChildContent`: RenderFragment — Custom label content; rendered instead of Label when provided.

### OmniCheckBoxList
_base: FormComponent<T> · accepts ChildContent · form input · source: src/Omni.Blazor/Components/Inputs/OmniCheckBoxList.razor_

Parameters:
- `AriaLabel`: string — aria-label do grupo.
- `DescriptionSelector`: Func<TValue, string> — Texto auxiliar opcional abaixo do label.
- `DisabledSelector`: Func<TValue, bool> — Item-by-item: retorne true para desabilitar este item específico.
- `Items`: IEnumerable<TValue> — Conjunto de itens a renderizar.
- `Orientation`: Orientation {Horizontal | Vertical} — Orientação do layout. Default Vertical.
- `TextSelector`: Func<TValue, string> — Texto principal de cada item. Default = item.ToString().
- `ValueSelector`: Func<TValue, TValue> — Extrai o valor a usar no bind. Default = o próprio item.
Slots:
- `ChildContent`: RenderFragment — Conteúdo customizado adicional (renderizado APÓS os itens).

### OmniColorPicker
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniColorPicker.razor_

Parameters:
- `DefaultColor`: string = #d97706 — Cor usada quando Value é nulo/ inválido. Default #d97706 (amber).
- `Palette`: IEnumerable<string> — Cores de preset exibidas abaixo do seletor. Default = paleta do design system.
- `ShowAlpha`: bool = false — Habilita o slider de transparência e emite #rrggbbaa. Default false.
- `ShowInput`: bool = true — Mostra o campo de entrada hexadecimal. Default true.
- `ShowPresets`: bool = true — Mostra a paleta de presets. Default true.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho do trigger. Default Md (igual aos demais inputs).

### OmniDatePicker
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniDatePicker.razor_

Parameters:
- `Clearable`: bool — Show a clear (×) button when a value is set. Default true.
- `DateFormat`: string — Date/time format used for display and parsing. Default "dd/MM/yyyy" (adapts when ShowTime is on).
- `DateRender`: Action<DateRenderEventArgs> — Per-day render hook (holidays, special markers, tooltips, ad-hoc disabling).
- `DisableWeekends`: bool — Disable Saturdays and Sundays. Default false.
- `DisabledDates`: Func<DateOnly, bool> — Predicate returning true to disable a specific day. Default null (none disabled).
- `FirstDayOfWeek`: DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday} — Override the first day of the week. Default = current culture.
- `HourFormat`: string — "24" (default) or "12" with AM/PM toggle.
- `InitialViewDate`: DateOnly — Month/year shown the first time the popover opens.
- `Inline`: bool — Render the calendar in place (no input/popover). Useful for filter panels or sidebars.
- `MaxDate`: DateOnly — Latest selectable date; later days are disabled.
- `MinDate`: DateOnly — Earliest selectable date; earlier days are disabled.
- `MinutesStep`: int — Step for minutes spinner. Default 1.
- `ParseInput`: Func<string, DateTime> — Custom string-to-DateTime parser. When set, replaces the default DateOnly.TryParseExact(DateFormat). Return null for invalid inputs. Useful for accepting multiple formats or natural-language dates.
- `Placeholder`: string — Placeholder text for the input; falls back to a smart format-based default when null.
- `SecondsStep`: int — Step for seconds spinner. Default 1.
- `ShowSeconds`: bool — Show the seconds field next to hour/minute.
- `ShowTime`: bool — Show hour/minute selector below the calendar (or alone when ShowTimeOnly).
- `ShowTimeOnly`: bool — Hide the calendar — picker shows time only. Auto-true when TValue is TimeOnly.
- `ShowWeekNumbers`: bool — Show the ISO 8601 week number column.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} — Visual size of the input. Default Md.
Slots:
- `Footer`: RenderFragment — Slot rendered below the day grid (e.g. a "Hoje" button).

### OmniDateRangePicker
Date range picker with a single combined input.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniDateRangePicker.razor_

Parameters:
- `ApplyText`: string — Label for the apply button (shown when AutoApply is off). Default "Aplicar".
- `AutoApply`: bool = true — When true (default), the second click on a day commits and closes the picker immediately. When false, the popover stays open and Apply / Cancel buttons are shown so the user can preview before committing.
- `CancelText`: string — Label for the cancel button (shown when AutoApply is off). Default "Cancelar".
- `ClearText`: string — Label for the clear button. Default "Limpar".
- `DateFormat`: string = dd/MM/yyyy — Format used to display the From/To dates in the input. Default "dd/MM/yyyy".
- `DateRender`: Action<DateRenderEventArgs> — Per-day render hook applied to both calendars (holidays, markers, tooltips).
- `DisableWeekends`: bool = false — Disable Saturdays and Sundays on both calendars. Default false.
- `Disabled`: bool = false — Disables the whole control. Default false.
- `DisabledDates`: Func<DateOnly, bool> — Predicate returning true to disable a specific day on both calendars. Default null.
- `FirstDayOfWeek`: DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday} — Override the first day of the week on both calendars.
- `From`: DateOnly — Start of the selected range. Bind via @bind-From.
- `FromExpression`: Expression<Func<DateOnly>> — Expression para integração com EditContext (registra com OmniForm). Aponte pro campo From do model; o validator vai receber o tuple (From, To).
- `MaxDate`: DateOnly — Latest selectable date on both calendars; later days are disabled.
- `MinDate`: DateOnly — Earliest selectable date on both calendars; earlier days are disabled.
- `Name`: string — Nome lógico — registra com OmniForm para validators irmãos. (<OmniRequiredValidator Component="periodo" />)
- `Placeholder`: string = Selecionar período — Text shown in the input when no range is selected. Default "Selecionar período".
- `Presets`: IReadOnlyList<DateRangePreset> — Quick-select shortcuts shown in the popover sidebar. Each preset is a label plus a function returning the (from, to) tuple at the moment it's clicked. Default set covers the most common business reporting periods.
- `ShowClearButton`: bool = true — Show the "Limpar" button in the popover footer.
- `ShowWeekNumbers`: bool = false — Show the ISO 8601 week number column on both calendars.
- `To`: DateOnly — End of the selected range. Bind via @bind-To.
Events:
- `FromChanged`: EventCallback<DateOnly> — Fires when the range start changes. Two-way via @bind-From.
- `ToChanged`: EventCallback<DateOnly> — Fires when the range end changes. Two-way via @bind-To.

### OmniEntityPicker
Selects a local or server-side entity through OmniDataGrid`1 while binding only its stable key to the surrounding EditContext.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniEntityPicker.razor_

Parameters:
- `AllowClear`: bool — Whether the selected value can be cleared. Default true.
- `AllowPaging`: bool — Whether the entity grid exposes paging. Default true.
- `AllowSearch`: bool — Whether the entity grid exposes search. Default true.
- `ClearText`: string — Overrides the clear action text.
- `CloseText`: string — Overrides the close action text.
- `ColumnTitle`: string — Generated default column title.
- `DataProvider`: GridDataProvider<TItem> — Cancellable server-side DataGrid source. Supply either DataProvider or Items.
- `EmptyKey`: Func<TKey, bool> — Determines whether a key represents no selection. Defaults to default(TKey).
- `EmptyText`: string — DataGrid empty-state text.
- `GridSchema`: DataGridSchema<TItem> — Optional reusable typed schema for the embedded entity DataGrid.
- `Items`: IEnumerable<TItem> — Local entity source. Supply either Items or DataProvider.
- `KeySelector`: Func<TItem, TKey> *required* — Stable key selector stored by the form-bound value.
- `PageSize`: int — Entity grid page size. Default ten.
- `Placeholder`: string — Text shown when no entity is selected.
- `Presentation`: EntityPickerPresentation {Dialog | Drawer} — Dialog or drawer presentation.
- `ResolveItem`: EntityPickerResolver<TItem, TKey> — Resolves an externally supplied key not present in local Items.
- `SearchPlaceholder`: string — DataGrid search placeholder.
- `SelectedItem`: TItem — Optional externally supplied entity corresponding to Value.
- `TextSelector`: Func<TItem, string> *required* — Human-readable selected entity text.
- `Title`: string — Selection dialog title.
- `Width`: string — Picker panel width.
Events:
- `ResolveFailed`: EventCallback<Exception> — Raised after an observed entity-resolution failure.
- `SelectedItemChanged`: EventCallback<TItem> — Raised after a user selects or clears an entity.
Slots:
- `Columns`: RenderFragment — Custom typed DataGrid columns. A text column is generated when omitted.
- `LoadingTemplate`: RenderFragment — Custom DataGrid loading content.

### OmniFileUpload
Drag-and-drop file uploader.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniFileUpload.razor_

Parameters:
- `Accept`: string — HTML accept filter passed to the file input (e.g. "image/*", ".pdf").
- `FilesExpression`: Expression<Func<IReadOnlyList<IBrowserFile>>> — Expression apontando pra coleção de files no model — habilita validators irmãos. Ex: FilesExpression="@(() => model.Anexos)".
- `HintText`: string — Secondary hint under the label. When null, an auto hint listing Accept + max size is shown.
- `LabelText`: string = Arraste arquivos aqui ou clique para selecionar — Main text shown inside the drop-zone. Default "Arraste arquivos aqui ou clique para selecionar".
- `MaxFileCount`: int = 0 — Maximum number of files (Multiple only). 0 = no limit.
- `MaxFileSize`: long = 10485760 — Maximum size per file, in bytes. 0 = no limit. Default 10 MB.
- `Multiple`: bool = false — Allow selecting/dropping more than one file. Default false (single file replaces the previous).
- `Name`: string — Nome lógico — registra com OmniForm para validators irmãos.
Events:
- `OnFileRemoved`: EventCallback<IBrowserFile> — Fires when a file is removed from the list, with the removed file.
- `OnFilesSelected`: EventCallback<IReadOnlyList<IBrowserFile>> — Fires after files are added (validated), with the current accepted file list.

### OmniFormField
Field wrapper around an input.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Inputs/OmniFormField.razor_

Parameters:
- `Error`: string — Explicit error to display (wins over EditContext messages).
- `For`: string — HTML `for` attribute on the label.
- `Hint`: string — Helper text shown below the input (hidden while an error is displayed).
- `HintRight`: string — Optional hint aligned to the right of the label row (e.g. a char counter).
- `Label`: string — Label text shown above the input.
- `Required`: bool = false — When true, marks the field as required (adds the required indicator on the label). Default false.
- `ValidationFor`: Expression<Func<object>> — Lambda pointing at the bound model field (e.g. () => model.Email). When provided AND an EditContext is in scope, the first validation message for the field is shown automatically.
Slots:
- `LabelContent`: RenderFragment — Custom label markup; rendered instead of Label when provided.

### OmniListBox
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniListBox.razor_

Parameters:
- `AriaLabel`: string — aria-label do listbox.
- `DescriptionSelector`: Func<TValue, string> — Texto auxiliar opcional abaixo do label de cada item.
- `DisabledSelector`: Func<TValue, bool> — Item-by-item: retorne true para desabilitar este item específico.
- `IconSelector`: Func<TValue, string> — Nome do ícone exibido à esquerda de cada item. Default = sem ícone.
- `Items`: IEnumerable<TValue> — Itens a renderizar.
- `MaxHeight`: string — Altura máxima (CSS). Default 240px. Quando excede, scroll vertical.
- `Multiple`: bool — Quando true, permite selecionar múltiplos itens.
- `TextSelector`: Func<TValue, string> — Texto principal de cada item. Default = item.ToString().
- `ValueSelector`: Func<TValue, TValue> — Extrai o valor de bind de cada item. Default = o próprio item (identidade).
- `Values`: IEnumerable<TValue> — Multi-select bind. Use com Multiple=true.
Events:
- `ValuesChanged`: EventCallback<IEnumerable<TValue>> — Disparado quando a seleção múltipla muda (modo Multiple).

### OmniMaskedTextBox
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniMaskedTextBox.razor_

Parameters:
- `Autocomplete`: string — HTML autocomplete attribute for the input.
- `KeepMask`: bool = false — When true, the bound Value keeps the mask separators; default false binds only the meaningful characters.
- `Mask`: string *required* =  — Mask pattern: 9 = digit, A = letter, * = alphanumeric; any other char is a literal separator. Required.
- `Placeholder`: string — Placeholder text shown when the input is empty.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Visual size of the input. Default Md.

### OmniMultiSelect
Multiple selection with chips and bounded local or cancellable server-side options.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniMultiSelect.razor_

Parameters:
- `DebounceMs`: int — Debounce applied to provider-backed searches.
- `DescriptionSelector`: Func<TValue, string> — Maps an option to secondary text.
- `Disabled`: bool — Whether the component is disabled.
- `DisabledSelector`: Func<TValue, bool> — Determines whether an option is disabled.
- `IconSelector`: Func<TValue, string> — Maps an option to an icon name.
- `Items`: IEnumerable<TValue> — Synchronous options. Mutually exclusive with ItemsProvider.
- `ItemsProvider`: OmniItemsProvider<TValue> — Asynchronous, cancellable and paged option source.
- `LoadErrorText`: string — Text shown when the provider fails.
- `LoadMoreText`: string — Action text for requesting another provider page.
- `LoadingText`: string — Text shown while options are loading.
- `MaxProviderItems`: int — Hard limit for options retained from one provider search.
- `Name`: string — Logical form-component name.
- `Placeholder`: string — Text displayed when nothing is selected.
- `PopoverMaxHeight`: string — Maximum list height.
- `PopoverWidth`: string — Popover width.
- `ProviderPageSize`: int — Maximum options requested per provider page.
- `RetryText`: string — Provider retry action text.
- `SearchPlaceholder`: string — Search input placeholder.
- `Searchable`: bool — Whether to display a search input.
- `ShowClearAll`: bool — Whether to display the clear-all action.
- `TextSelector`: Func<TValue, string> — Maps an option to primary text.
- `ValueSelector`: Func<TValue, TValue> — Extracts the bound value from an option.
- `Values`: IEnumerable<TValue> — Selected values.
- `ValuesExpression`: Expression<Func<IEnumerable<TValue>>> — Expression used for EditContext integration.
Events:
- `ItemsProviderFailed`: EventCallback<Exception> — Raised when an uncancelled provider request fails.
- `ValuesChanged`: EventCallback<IEnumerable<TValue>> — Raised when Values changes.

### OmniNumeric
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniNumeric.razor_

Parameters:
- `Decimals`: int — Number of decimal places shown when the input loses focus. Default = inferred from TValue.
- `Format`: string — Custom ToString format for the display value (e.g. "00" for 2-digit zero-padded, "0,000" for thousands grouping). When set, wins over the default "N{Decimals}".
- `Max`: decimal — Maximum allowed value; entries above it are clamped. Default null (no maximum).
- `Min`: decimal — Minimum allowed value; entries below it are clamped. Default null (no minimum).
- `Placeholder`: string — Placeholder text shown when the input is empty.
- `Prefix`: string — Text rendered before the input (e.g. "R$"). Default none.
- `ShowSpinButtons`: bool — Show the up/down stepper buttons. Default true (hidden when ReadOnly).
- `Size`: ComponentSize {Sm | Md | Lg | Xl} — Visual size of the input. Default Md.
- `Step`: decimal — Increment applied by the spin buttons and ArrowUp/ArrowDown. Default 1.
- `Suffix`: string — Text rendered after the input (e.g. "%", "kg"). Default none.
- `Wrap`: bool — When true, stepping past Max wraps to Min and vice versa. Useful for cyclical inputs (hours, minutes, day of week). Requires both Min and Max to be set.

### OmniPassword
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniPassword.razor_

Parameters:
- `Autocomplete`: string = current-password — HTML autocomplete attribute. Default "current-password".
- `MinLength`: int — Minimum length enforced via the input's minlength attribute. Default null (none).
- `Placeholder`: string — Placeholder text shown when the input is empty.
- `ShowToggle`: bool = true — Show the eye button that toggles between masked and plain text. Default true.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Visual size of the input. Default Md.

### OmniPasswordStrength
Password strength meter + configurable requirement checklist.
_base: OmniComponent · source: src/Omni.Blazor/Components/Inputs/OmniPasswordStrength.razor_

Parameters:
- `LabelText`: string = Força da senha — Caption text on the label line. Default "Força da senha".
- `MinLength`: int = 8 — Minimum length rule. Set to 0 to drop the length rule. Default 8.
- `Password`: string — The password to evaluate (read-only; this component never owns the value).
- `RequireDigit`: bool = true — Require a digit (default rule). Default true.
- `RequireLowercase`: bool = true — Require a lowercase letter (default rule). Default true.
- `RequireSymbol`: bool = true — Require a non-alphanumeric symbol (default rule). Default true.
- `RequireUppercase`: bool = true — Require an uppercase letter (default rule). Default true.
- `RequiredUniqueChars`: int = 0 — Require at least N distinct characters (default rule). 0 disables it.
- `Rules`: IEnumerable<OmniPasswordRule> — Fully custom rule set. When provided, the built-in toggles above are ignored.
- `ShowLabel`: bool = true — Show the strength word + caption line. Default true.
- `ShowRules`: bool = true — Show the per-rule checklist. Default true.

### OmniPickList
OmniPickList — a dual-list "transfer" picker (RadzenPickList port).
_base: OmniComponent · source: src/Omni.Blazor/Components/Inputs/OmniPickList.razor_

Parameters:
- `AllowFiltering`: bool — Show a search box above each list. Default false.
- `AllowMoveAll`: bool — Show the "move all" (double-arrow) buttons. Default true.
- `ButtonSize`: ComponentSize {Sm | Md | Lg | Xl} — Size of the transfer buttons. Default Sm.
- `ButtonVariant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} — Variant of the transfer buttons. Default Default.
- `Disabled`: bool — Disable the whole control.
- `DisabledSelector`: Func<TItem, bool> — Maps an item to whether it is disabled (non-selectable).
- `FilterPlaceholder`: string — Placeholder for the filter boxes.
- `IconSelector`: Func<TItem, string> — Maps an item to an optional leading icon name.
- `ListHeight`: string — Max height of each list (CSS length). Default "260px".
- `Orientation`: Orientation {Horizontal | Vertical} — Layout: Horizontal (lists side by side) or Vertical (stacked).
- `ShowHeader`: bool — Show pane headers. Default true.
- `Source`: IEnumerable<TItem> — Items in the left (source) list. Two-way bindable.
- `SourceEmptyText`: string — Text shown when the source list is empty.
- `SourceTitle`: string — Title text for the source pane header.
- `Target`: IEnumerable<TItem> — Items in the right (target) list. Two-way bindable.
- `TargetEmptyText`: string — Text shown when the target list is empty.
- `TargetTitle`: string — Title text for the target pane header.
- `TextSelector`: Func<TItem, string> — Maps an item to its display text. Defaults to ToString().
Events:
- `Moved`: EventCallback<PickListMoveEventArgs<TItem>> — Raised after a move, once Source/Target already reflect it.
- `SourceChanged`: EventCallback<IEnumerable<TItem>> — Fires when the source list changes after a move. Two-way via @bind-Source.
- `TargetChanged`: EventCallback<IEnumerable<TItem>> — Fires when the target list changes after a move. Two-way via @bind-Target.
Slots:
- `SourceHeader`: RenderFragment — Custom markup for the source pane header; overrides SourceTitle.
- `TargetHeader`: RenderFragment — Custom markup for the target pane header; overrides TargetTitle.

### OmniQtyStepper
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniQtyStepper.razor_

Parameters:
- `Max`: int — Limite superior (inclusivo). Opcional; quando definido, o botão + desabilita ao atingir.
- `Min`: int = 1 — Limite inferior (inclusivo). Default 1 — o botão − desabilita ao atingir.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho visual. Sm (24×24), Md (28×28, default), Lg (36×36).

### OmniRadio
Single radio button; registers with the enclosing OmniRadioGroup via cascading parameter.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Inputs/OmniRadio.razor_

Parameters:
- `Disabled`: bool — Disables this radio (also disabled when the group is disabled). Default false.
- `Label`: string — Text label shown next to the radio when no ChildContent is provided.
- `Value`: TValue *required* — Value this radio represents; the group is selected when it equals the group's bound value. Required.

### OmniRadioGroup
_base: FormComponent<T> · accepts ChildContent · form input · source: src/Omni.Blazor/Components/Inputs/OmniRadioGroup.razor_

Parameters:
- `Orientation`: Orientation {Horizontal | Vertical} — Layout direction of the radios. Default Vertical.
Slots:
- `ChildContent`: RenderFragment — The OmniRadio children that make up the group.

### OmniRating
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniRating.razor_

Parameters:
- `AllowClear`: bool = false — Clique na estrela já selecionada limpa o valor (volta a 0). Default false.
- `AriaLabel`: string — aria-label customizado.
- `Color`: string — Cor accent override (qualquer CSS color). Default --omni-warn (dourado).
- `EmptyIconName`: string = star — Nome do ícone para estado vazio. Default star.
- `FullIconName`: string = star — Nome do ícone para estado preenchido. Default star (mesmo ícone, cor diferente).
- `HalfStep`: bool = false — Permite valores fracionados (X.5). Hover na metade esquerda da estrela.
- `Max`: int = 5 — Quantidade total de estrelas. Default 5.
- `ShowValue`: bool = false — Mostra o valor numérico ao lado das estrelas.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho do ícone das estrelas.
- `ValueFormatter`: Func<double, string> — Formatador customizado do label numérico. Default v.ToString("0.#").

### OmniSecurityCode
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniSecurityCode.razor_

Parameters:
- `AriaLabel`: string = Dígito — Accessible label prefix for each cell (e.g. "Dígito 1"). Default "Dígito".
- `Count`: int = 4 — Number of code cells. Default 4.
- `Gap`: string = 8px — Gap between cells (CSS length). Default 8px.
- `Type`: SecurityCodeType {Text | Numeric | Password} = Text — Input type: Text (any char), Numeric (digits only) or Password (masked).

### OmniSelect
Single-choice select with bounded local or cancellable server-side options.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniSelect.razor_

Parameters:
- `AriaLabel`: string — Accessible name applied to the combobox trigger. When omitted, the component falls back to Name, Placeholder or the selected option text, in that order.
- `Clearable`: bool — Whether a selected value can be cleared.
- `EmptyText`: string — Text shown when there are no options.
- `Items`: IEnumerable<TValue> — Synchronous options. Mutually exclusive with ItemsProvider.
- `ItemsProvider`: OmniItemsProvider<TValue> — Asynchronous, cancellable and paged option source.
- `LoadErrorText`: string — Text shown when the provider fails.
- `LoadMoreText`: string — Action text for requesting another provider page.
- `LoadingText`: string — Text shown while options are loading.
- `MaxProviderItems`: int — Hard limit for options retained from the provider.
- `Placeholder`: string — Text shown when no value is selected.
- `ProviderPageSize`: int — Maximum options requested per provider page.
- `ProviderVersion`: long — Explicit provider invalidation version. Changing it cancels the current request and clears retained provider items.
- `RetryText`: string — Provider retry action text.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} — Visual size of the input.
- `TextSelector`: Func<TValue, string> — Maps an option to display text.
- `ValueSelector`: Func<TValue, TValue> — Extracts the bound value from an option.
Events:
- `ItemsProviderFailed`: EventCallback<Exception> — Raised when an uncancelled provider request fails.
Slots:
- `EmptyTemplate`: RenderFragment — Custom content shown when the provider has no options.
- `ErrorTemplate`: RenderFragment<OmniItemsProviderErrorContext> (context: OmniItemsProviderErrorContext) — Custom retry-capable content shown after a provider failure.
- `LoadingTemplate`: RenderFragment — Custom content shown while the first provider page is loading.

### OmniSignaturePad
Canvas-based signature input with undo, clear and PNG/JPEG/SVG export.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniSignaturePad.razor_

Parameters:
- `AriaLabel`: string = Área para assinatura — Accessible label announced for the drawing canvas.
- `BackgroundColor`: string = #ffffff — Canvas background color.
- `ClearText`: string = Limpar — Label for the clear action.
- `EmptyText`: string = Aguardando assinatura — Status text shown while no signature has been captured.
- `Format`: SignaturePadFormat {Png | Jpeg | Svg} = Png — Format used by the bound Value and ExportAsync.
- `Height`: int = 220 — Canvas height in CSS pixels.
- `Quality`: double = 0.92 — JPEG quality between 0 and 1. Ignored by PNG and SVG.
- `ShowToolbar`: bool = true — Shows the built-in undo, clear and status toolbar.
- `SignedText`: string = Assinatura capturada — Status text shown after at least one stroke is captured.
- `StrokeColor`: string = #111827 — Stroke color accepted by the browser canvas API.
- `StrokeWidth`: double = 2 — Stroke width in CSS pixels.
- `UndoText`: string = Desfazer — Label for the undo action.
Events:
- `StrokeCompleted`: EventCallback<string> — Raised after the user completes, removes or clears a stroke.

### OmniSlider
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniSlider.razor_

Parameters:
- `AriaLabel`: string — aria-label do thumb (modo single).
- `Color`: string — Cor accent custom para a track ativa e thumbs. Default --omni-accent.
- `Marks`: IEnumerable<SliderMark> — Marcas customizadas (ex: 0%, 25%, 50%...) renderizadas abaixo da track.
- `Max`: double = 100 — Valor máximo. Default 100.
- `Min`: double = 0 — Valor mínimo. Default 0.
- `Range`: bool = false — Quando true, renderiza 2 thumbs (range).
- `ShowTicks`: bool = false — Mostra ticks (pontos pequenos) em cada Step. Auto-desliga se houver mais de 50 ticks para evitar poluição visual.
- `ShowValueLabel`: bool = true — Mostra balão com o valor sobre o thumb.
- `Step`: double = 1 — Incremento mínimo. Default 1.
- `ValueEnd`: double = 0 — Range end (thumb direito). Use com Range=true.
- `ValueFormatter`: Func<double, string> — Formatador customizado para o balão do thumb. Default: v.ToString("0.##").
- `ValueStart`: double = 0 — Range start (thumb esquerdo). Use com Range=true.
Events:
- `ValueEndChanged`: EventCallback<double> — Disparado quando o thumb final (end) muda. Two-way via @bind-ValueEnd.
- `ValueStartChanged`: EventCallback<double> — Disparado quando o thumb inicial (start) muda. Two-way via @bind-ValueStart.

### OmniSpeechToText
Wrapper headless da Web Speech API (SpeechRecognition + webkit variant).
_base: ComponentBase · accepts ChildContent · source: src/Omni.Blazor/Components/Inputs/OmniSpeechToText.razor_

Parameters:
- `Continuous`: bool = true — Quando true (default), continua reconhecendo até o user parar. false = para automaticamente após o primeiro silêncio longo.
- `InterimResults`: bool = false — Quando true, dispara OnResult com resultados parciais (IsFinal=false) enquanto o user fala. Útil pra mostrar texto "ao vivo" enquanto fala. Default false — só resultados finais.
- `Language`: string — BCP-47 language code: "pt-BR", "en-US", "es-ES", etc. Null = browser default.
- `MaxAlternatives`: int = 1 — Quantas alternativas pedir do motor por trecho. Default 1.
Events:
- `OnEnd`: EventCallback — Disparado quando o reconhecimento termina (user parou, silêncio longo em modo non-continuous, ou erro). Use pra resetar UI.
- `OnError`: EventCallback<string> — Disparado em erro. Códigos comuns: "not-allowed" (permissão negada), "no-speech", "audio-capture", "network", "aborted", "start-timeout" (browser não respondeu), "invalid-state" (instância prévia travada). Use pra mostrar feedback ao user.
- `OnResult`: EventCallback<SpeechRecognitionResult> — Disparado a cada onresult do motor. Recebe transcript + IsFinal + confidence.
- `OnStart`: EventCallback — Disparado quando o reconhecimento começa (após permissão de mic).
- `OnStateChange`: EventCallback<SpeechRecognitionState> — Disparado a cada transição de estado da state machine (Idle ↔ Connecting ↔ Recording ↔ Stopping ↔ Error). Use pra UI avançada (spinner em transição, badge de erro, etc).
- `OnUnsupported`: EventCallback — Disparado quando o browser NÃO suporta Web Speech API (Firefox, alguns embedded webviews). Use pra esconder o botão de mic ou mostrar mensagem alternativa.
Slots:
- `ChildContent`: RenderFragment<SpeechContext> (context: SpeechContext) — Render-prop que recebe um SpeechContext tipado para você desenhar o próprio botão/UI.

### OmniSpeechToTextButton
Botão pronto pra falar — wrapper visual de conveniência por cima do headless OmniSpeechToText.
_base: OmniComponent · source: src/Omni.Blazor/Components/Inputs/OmniSpeechToTextButton.razor_

Parameters:
- `AllowInterrupt`: bool = false — Permite clicar o botão mesmo em estado Busy (Starting/Stopping). Default false — espera transição completar. true = cliques rápidos passam pro JS (que já tem debounce de 250ms).
- `BusyIcon`: string = loader — Ícone em transição (Connecting/Stopping). Default "loader".
- `BusyText`: string — (Obsoleto — use ConnectingText.) Texto genérico de transição, mantido por compatibilidade. Se setado, sobrescreve ConnectingText e StoppingText.
- `BusyTitle`: string = Aguarde… — Tooltip durante transição (Connecting/Stopping).
- `ConnectingText`: string = Conectando… — Texto durante Connecting (aguardando mic ficar pronto). Default "Conectando…". Crítico no Edge — mostra que ainda NÃO está ouvindo enquanto Microsoft Speech estabelece conexão.
- `Continuous`: bool = true — Continua reconhecendo até o user parar. Default true.
- `Disabled`: bool = false — Desabilita o botão manualmente (além de desabilitar quando o browser não suporta). Default false.
- `ErrorIcon`: string = alert-circle — Ícone em erro. Default "alert-circle".
- `Icon`: string = mic — Ícone idle (não gravando). Default "mic".
- `InterimResults`: bool = false — Dispara OnResult com resultados parciais enquanto o user fala. Default false.
- `Language`: string — Código de idioma BCP-47 ("pt-BR", "en-US"...). Null = padrão do browser.
- `MaxAlternatives`: int = 1 — Quantas alternativas pedir ao motor por trecho. Default 1.
- `RecordingText`: string — Texto durante gravação (mic capturando). Default = Text.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho do botão. Default Md.
- `StopIcon`: string = stop-circle — Ícone gravando. Default "stop-circle".
- `StopTitle`: string = Pressione para parar — Tooltip + aria-label gravando.
- `StoppingText`: string = Parando… — Texto durante Stopping. Default "Parando…".
- `Text`: string — Texto idle. Vazio + RecordingText vazio = botão icon-only.
- `Title`: string = Pressione para falar — Tooltip + aria-label idle.
- `UnsupportedTitle`: string = Reconhecimento de voz não disponível neste navegador — Tooltip quando browser não suporta Web Speech API.
- `Variant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Default — Variante visual do botão. Default Default.
Events:
- `OnEnd`: EventCallback — Disparado quando o reconhecimento termina.
- `OnError`: EventCallback<string> — Disparado em erro, com o código cru do browser.
- `OnResult`: EventCallback<SpeechRecognitionResult> — Disparado a cada resultado do reconhecimento (transcript + IsFinal + confidence).
- `OnStart`: EventCallback — Disparado quando o reconhecimento começa.
- `OnStateChange`: EventCallback<SpeechRecognitionState> — Disparado a cada transição da state machine de reconhecimento.

### OmniSwitch
_base: FormComponent<T> · accepts ChildContent · form input · source: src/Omni.Blazor/Components/Inputs/OmniSwitch.razor_

Parameters:
- `Label`: string — Text label shown next to the switch when no ChildContent is provided.
Slots:
- `ChildContent`: RenderFragment — Custom label content; rendered instead of Label when provided.

### OmniTagInput
OmniTagInput — entrada de múltiplos valores de texto livre (tags, e-mails, escopos, rótulos).
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniTagInput.razor_

Parameters:
- `AllowCustom`: bool = true — Permite criar valores livres (fora das Suggestions). Default true. Quando false, só valores presentes em Suggestions são aceitos.
- `AllowDuplicates`: bool = false — Permite tags repetidas. Default false (ignora duplicatas).
- `CaseSensitive`: bool = false — Comparação sensível a maiúsculas (duplicatas/sugestões). Default false.
- `Disabled`: bool = false — Desabilita o campo (sem adicionar/remover tags). Default false.
- `Max`: int — Número máximo de tags. null = ilimitado.
- `MaxSuggestions`: int = 8 — Máximo de sugestões exibidas no painel. Default 8.
- `Name`: string — Nome lógico — registra com OmniForm para validators irmãos (<OmniRequiredValidator Component="..." />).
- `Placeholder`: string — Texto exibido no campo quando não há tags.
- `ReadOnly`: bool = false — Somente leitura — exibe as tags mas bloqueia edição. Default false.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho visual do campo. Default Md.
- `Suggestions`: IEnumerable<string> — Conjunto opcional de sugestões exibidas num painel ao digitar.
- `Values`: IEnumerable<string> — Tags atuais (two-way via @bind-Values).
- `ValuesExpression`: Expression<Func<IEnumerable<string>>> — Expression pra integração com EditContext (validators irmãos).
Events:
- `OnTagAdded`: EventCallback<string> — Disparado após uma tag ser adicionada, com o texto da tag.
- `OnTagRemoved`: EventCallback<string> — Disparado após uma tag ser removida, com o texto da tag.
- `ValuesChanged`: EventCallback<IEnumerable<string>> — Disparado quando a coleção de tags muda.

### OmniTextArea
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniTextArea.razor_

Parameters:
- `MaxLength`: int — Maximum number of characters allowed (via maxlength). Default null (no limit).
- `Placeholder`: string — Placeholder text shown when the textarea is empty.
- `Rows`: int = 4 — Visible number of text rows. Default 4.

### OmniTextBox
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniTextBox.razor_

Parameters:
- `Autocomplete`: string — HTML autocomplete attribute for the input.
- `Clearable`: bool = false — When true, shows an "x" button to clear the value whenever it's non-empty.
- `LeadingIcon`: string — Icon name rendered inside the input on the left. Default none.
- `MaxLength`: int — Maximum length enforced via the input's maxlength attribute. Default null (none).
- `MinLength`: int — Minimum length enforced via the input's minlength attribute. Default null (none).
- `Placeholder`: string — Placeholder text shown when the input is empty.
- `ShowCharCount`: bool = false — When true (and MaxLength is set), shows a character counter below the field.
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Visual size of the input. Default Md.
- `TrailingIcon`: string — Icon name rendered inside the input on the right (suppressed when the clear button is shown). Default none.
- `Type`: string = text — HTML input type (e.g. "text", "email", "tel"). Default "text".
Events:
- `OnBlur`: EventCallback<FocusEventArgs> — Fires when the input loses focus.
- `OnKeyDown`: EventCallback<KeyboardEventArgs> — Fires on keydown in the input (e.g. to handle Enter).

### OmniTimePicker
Time picker.
_base: FormComponent<T> · form input · source: src/Omni.Blazor/Components/Inputs/OmniTimePicker.razor_

Parameters:
- `HourFormat`: string = 24 — "24" (default) or "12" — adds AM/PM toggle inline with the hour.
- `MinutesStep`: int = 1 — Increment for the minutes field. Default 1.
- `Name`: string — Nome lógico — registra com OmniForm para validators irmãos.
- `SecondsStep`: int = 1 — Increment for the seconds field. Default 1.
- `ShowSeconds`: bool = false — Show a seconds field in addition to hours and minutes. Default false.
- `Time`: TimeOnly — The selected time of day. Bind via @bind-Time.
- `TimeExpression`: Expression<Func<TimeOnly>> — Expression pra integração com EditContext + validators irmãos.
Events:
- `TimeChanged`: EventCallback<TimeOnly> — Fires when the time changes. Two-way via @bind-Time.

## Layout

### OmniAppBar
Barra superior/inferior do <c>OmniLayout</c>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniAppBar.razor_

Parameters:
- `Bordered`: bool = true — Borda inferior. Default true.
- `ElevateOnScroll`: bool = false — Quando true, a sombra só aparece após o user rolar além do AppBar. Útil para AppBars transparentes em landing pages. Default false.
- `Elevated`: bool = true — Sombra fina abaixo. Default true. Quando ElevateOnScroll é true, a sombra só aparece após scroll.
- `Fixed`: bool = true — Não rola junto com o main. Default true.
- `HideOnScroll`: bool = false — Esconde a AppBar quando o user rola down no main; reaparece ao rolar up. UX padrão mobile (Twitter, Instagram). Default false.
- `Position`: BarPosition {Top | Bottom} = Top — Posição no layout. Default Top.

### OmniAppearanceToggle
Theme mode switcher — Light / Dark / System.
_base: OmniComponent · source: src/Omni.Blazor/Components/Layout/OmniAppearanceToggle.razor_

Parameters:
- `AriaLabel`: string — aria-label do grupo. Default "Modo de aparência".
- `ButtonVariant`: ButtonVariant {Default | Primary | Ghost | Danger | Link} = Default — Variant do OmniButton interno (Dropdown/Cycle). Default Default.
- `DarkIcon`: string = moon — Ícone do modo Dark. Default "moon".
- `DarkLabel`: string = Escuro — Texto/label do modo Dark. Default "Escuro".
- `LightIcon`: string = sun — Ícone do modo Light. Default "sun".
- `LightLabel`: string = Claro — Texto/label do modo Light. Default "Claro".
- `ShowLabels`: bool = false — Mostra label de texto junto do ícone. Default false (icon-only).
- `Size`: ComponentSize {Sm | Md | Lg | Xl} = Md — Tamanho do botão. Default Md.
- `SystemIcon`: string = monitor — Ícone do modo System. Default "monitor".
- `SystemLabel`: string = Sistema — Texto/label do modo System. Default "Sistema".
- `Variant`: AppearanceToggleVariant {Dropdown | Segmented | Cycle} = Dropdown — Visual do toggle. Default Dropdown.
Events:
- `OnModeChanged`: EventCallback<ThemeMode> — Disparado quando o modo muda.

### OmniAuthLayout
Auth page scaffold — centered card by default; pass a Brand fragment to get the split layout (dark brand panel + form panel).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniAuthLayout.razor_

Parameters:
- `Decor`: bool = true — Subtle grid + accent-glow background on the form area. Default true.
Slots:
- `Brand`: RenderFragment — When set, renders the dark brand side panel (split layout).

### OmniBanner
Persistent, app-wide message bar — sits above the layout chrome and stays until dismissed (unlike OmniAlert which lives inline in page content, and toasts which auto-dismiss).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniBanner.razor_

Parameters:
- `Dismissible`: bool = false — Show a dismiss (×) button.
- `Icon`: string — Override the leading icon.
- `Severity`: NotificationSeverity {Info | Success | Warning | Error} = Info — Intent — drives icon + tint. Default Info.
- `Sticky`: bool = false — Stick to the top of the scroll container.
Events:
- `OnClosed`: EventCallback — Fires after the banner is dismissed.
Slots:
- `Actions`: RenderFragment — Inline actions on the trailing edge.

### OmniBento
OmniBento — grade 2D densa (Bento).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniBento.razor_

Parameters:
- `AlignItems`: StackAlign {Start | Center | End | Stretch | Baseline} = Stretch — Alinhamento vertical dos tiles na célula (align-items do grid). Default Stretch.
- `Columns`: int = 12 — Número de colunas (mobile-first). Default 12. Ignorado quando MinTileWidth é definido.
- `ColumnsLg`: int — Override de Columns em ≥1440px. Default null.
- `ColumnsMd`: int — Override de Columns em ≥1024px. Default null.
- `ColumnsSm`: int — Override de Columns em ≥640px. Default null.
- `Connected`: bool = false — Visual "grudado" de 1px (tiles achatados, sem gap) — para telas operacionais densas. Default false.
- `Container`: bool = false — Responsividade por container query: colunas/spans reagem à largura do PRÓPRIO Bento (não do viewport), via um wrapper. Use para Bentos dentro de painéis/sidebars. Default false. (Alternativa ao MinTileWidth, que já é container-relativo.)
- `Dense`: bool = true — Empacotamento denso (grid-auto-flow: row dense). Default true. Defina false para preservar a ordem do DOM = ordem visual (foco/leitura quando os tiles são interativos).
- `EqualRows`: bool = false — Linhas de altura igual (grid-auto-rows: 1fr) — visual Apple alinhado. Vence RowHeight. Default false.
- `Gap`: int = 16 — Espaçamento entre tiles em px. Default 16 (estilo Apple). Ignorado quando Connected.
- `MinTileWidth`: int — Largura mínima do tile em px. Quando definido, usa auto-fit (repeat(auto-fit, minmax(MinTileWidth, 1fr))) — os tiles refluem pela largura do container sem breakpoints, e Columns é ignorado.
- `RowHeight`: int — Altura-base de cada linha do grid em px (grid-auto-rows minmax). Default null (altura por conteúdo).
- `Square`: bool = false — Remove o arredondamento dos tiles (cantos retos). Default false.

### OmniBentoItem
OmniBentoItem — tile tipado de um <c>OmniBento</c>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniBentoItem.razor_

Parameters:
- `AlignContent`: StackAlign {Start | Center | End | Stretch | Baseline} — Alinhamento (cross-axis) do conteúdo dentro do tile — torna o tile um flex column.
- `AspectRatio`: string — CSS aspect-ratio do tile (ex.: "1/1", "16/9"). Não combine com RowSpan/RowHeight.
- `ColSpan`: int = 1 — Quantas colunas o tile ocupa (base, mobile-first). Default 1.
- `ColSpanLg`: int — Override de ColSpan em ≥1440px. Default null.
- `ColSpanMd`: int — Override de ColSpan em ≥1024px. Default null.
- `ColSpanSm`: int — Override de ColSpan em ≥640px. Default null.
- `Disabled`: bool = false — Desabilita o tile interativo.
- `Href`: string — Torna o tile um link (renderiza <a>). Mutuamente exclusivo com OnClick.
- `JustifyContent`: StackAlign {Start | Center | End | Stretch | Baseline} — Distribuição (main-axis) do conteúdo dentro do tile — torna o tile um flex column.
- `NoPadding`: bool = false — Remove o padding interno do tile. Default false.
- `RowSpan`: int = 1 — Quantas linhas o tile ocupa (base). Default 1.
- `RowSpanLg`: int — Override de RowSpan em ≥1440px. Default null.
- `RowSpanMd`: int — Override de RowSpan em ≥1024px. Default null.
- `RowSpanSm`: int — Override de RowSpan em ≥640px. Default null.
- `Scrim`: bool = false — Adiciona um scrim (gradiente inferior) p/ texto sobre imagem full-bleed. Use com NoPadding.
- `Target`: string — Alvo do link quando Href é definido (ex.: "_blank").
- `Tone`: CardTone {None | Accent | Neutral | Info | Success | Warning | Danger} = None — Tom do tile — hero/accent + semânticos (tinta suave + borda). Default None.
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Torna o tile um botão (renderiza <button>) quando definido e Href é nulo.

### OmniBrand
Logo/marca do app: quadrado com inicial + nome (e tenant opcional); vira link quando Href é definido.
_base: OmniComponent · source: src/Omni.Blazor/Components/Layout/OmniBrand.razor_

Parameters:
- `Href`: string — Quando definido, renderiza a marca como link (<a href>); senão como <div>. Default null.
- `Initial`: string = F — Inicial exibida no quadrado da marca. Default "F".
- `Large`: bool = false — Usa o quadrado da marca em tamanho maior. Default false.
- `Name`: string = Forneria — Nome do app/marca exibido ao lado do quadrado. Default "Forneria".
- `Tenant`: string — Tenant/workspace opcional — renderiza " / Tenant" após o nome. Default null (oculto).

### OmniBreakpointProvider
Cascades the current <see cref="Breakpoint"/> to descendants so they can branch their markup on viewport size from C# (no CSS-only conditionals).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniBreakpointProvider.razor_

Parameters:
- `Breakpoint`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} = Xs — Current breakpoint, cascaded to descendants. Two-way bindable via @bind-Breakpoint; updated on every viewport change. Default Md.
Events:
- `BreakpointChanged`: EventCallback<Breakpoint> — Fires whenever the active breakpoint changes. Enables @bind-Breakpoint.

### OmniCol
Coluna do grid 12-colunas.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniCol.razor_

Parameters:
- `Size`: int = 12 — Span padrão (mobile-first, sempre aplicado). 1–12. Default 12.
- `SizeLg`: int — Override em ≥1440 px.
- `SizeMd`: int — Override em ≥1024 px.
- `SizeSm`: int — Override em ≥640 px.

### OmniContainer
Wrapper centralizado com largura máxima responsiva.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniContainer.razor_

Parameters:
- `Fluid`: bool = false — Atalho para Full (sem limite). Default false.
- `Gutters`: bool = true — Padding lateral nas bordas. Default true.
- `MaxWidth`: ContainerMaxWidth {Sm | Md | Lg | Xl | Xxl | Full} = Lg — Largura máxima do container. Default Lg (1280px).

### OmniDrawer
Drawer / sidebar genérico — equivalente ao <c>MudDrawer</c> (MudBlazor),
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniDrawer.razor_

Parameters:
- `Anchor`: DrawerAnchor {Left | Right} = Left — Ancoragem do drawer no layout. Default Left.
- `AutoCloseOnNavigate`: bool = true — Se true (default), o drawer fecha automaticamente em modo overlay quando o usuário navega para outra rota. Útil em mobile — elimina boilerplate no AppShell consumidor.
- `Breakpoint`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} = Md — Breakpoint a partir do qual o Responsive vira overlay. Default Md (~1024px).
- `Collapsed`: bool — Força modo collapsed (icon-only) independente da variante. Útil para Mini estático.
- `ExpandOnHover`: bool = false — Quando true, o drawer Mini expande on-hover (ficando full-width) e retorna ao icon-only quando o mouse sai. Útil para combinar densidade visual com acesso rápido aos labels. Default false.
- `MiniWidth`: string — Largura quando em modo Mini (icon-only). Default usa --omni-drawer-w-mini (72px).
- `Open`: bool = true — Estado aberto/fechado. Two-way binding com @bind-Open. Persistent: ignora (sempre visível); demais variantes: alterna visibilidade.
- `Persist`: bool = false — Quando true, persiste o estado Open em localStorage (chave omni.drawer.{Id} ou PersistKey). Sobrevive a F5 e navegação. Default false. Padrão shadcn/ui.
- `PersistKey`: string — Chave custom para persistência. Útil quando há múltiplos drawers e o Id auto-gerado mudaria entre sessões. Default null — usa o Id.
- `Variant`: DrawerVariant {Persistent | Mini | Temporary | Responsive} = Responsive — Variante de comportamento. Default Responsive.
- `Width`: string — Largura quando aberto. Default usa CSS var --omni-drawer-w (232px).
Events:
- `OpenChanged`: EventCallback<bool> — Notifica mudança do estado Open.
Slots:
- `Footer`: RenderFragment — Slot opcional renderizado no rodapé do drawer — após o ChildContent. Útil para card de plano/upgrade, link de logout, versão do app. Padrão Slack/Discord/shadcn.
- `Header`: RenderFragment — Slot opcional renderizado no topo do drawer — antes do ChildContent. Útil para logo do app, info do usuário, busca rápida. Inspirado em MudDrawerHeader.

### OmniDrawerToggle
Botão hamburger que alterna o estado de um <c>OmniDrawer</c>.
_base: OmniComponent · source: src/Omni.Blazor/Components/Layout/OmniDrawerToggle.razor_

Parameters:
- `Anchor`: DrawerAnchor {Left | Right} — Filtra drawers por âncora quando há mais de um no layout. Default null.
- `Icon`: string = menu — Ícone Lucide do botão. Default menu.
- `Target`: OmniDrawer — Referência manual ao drawer alvo. Default: usa resolução automática.
- `Title`: string = Abrir menu — Texto acessível (aria-label + title). Default "Abrir menu".

### OmniFooter
Footer slot do <c>OmniLayout</c>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniFooter.razor_

Parameters:
- `Bordered`: bool = true — Borda superior fina. Default true.
- `Fixed`: bool = false — Fixa o footer ao rodapé da viewport (sticky). Default false (rola junto).

### OmniHidden
Renderiza condicionalmente subárvore baseado no breakpoint atual da viewport.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniHidden.razor_

Parameters:
- `Breakpoint`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} = Md — Breakpoint que serve de pivô para a regra de visibilidade. Default Md.
- `Invert`: bool = false — Inverte a lógica de visibilidade. Útil para renderizar SOMENTE quando a regra de hide seria true.
- `Mode`: HiddenMode {Down | Up | Only} = Down — Modo de comparação: Down (default — esconde abaixo/igual ao breakpoint), Up (esconde acima/igual), Only (esconde apenas no breakpoint exato).

### OmniLayout
Container raiz do shell.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniLayout.razor_

Parameters:
- `SkipLabel`: string — Texto do link de skip. Default "Pular para o conteúdo".
- `SkipTarget`: string = #main — Âncora do skip link. Default #main (o OmniMain renderiza um elemento <main> que pode receber esse id no consumidor via Class ou attributes).
- `SkipToContent`: bool = true — Renderiza um "skip to content" link visível apenas com foco por teclado (Tab no início da página). WCAG 2.4.1. Default true.

### OmniMain
Área principal de conteúdo do <c>OmniLayout</c>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniMain.razor_

Parameters:
- `Container`: ContainerMaxWidth {Sm | Md | Lg | Xl | Xxl | Full} — Envelopa em OmniContainer com o max-width indicado. Default null (sem container).
- `NoPadding`: bool = false — Remove o padding interno padrão. Default false.

### OmniMasonry
OmniMasonry — layout em cascata (Pinterest): colunas de largura igual onde cada item mantém a altura natural e empilha na coluna mais curta, sem alinhar linhas.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniMasonry.razor_

Parameters:
- `Columns`: int = 3 — Número de colunas. Default 3. Ignorado quando MinColumnWidth é definido.
- `ColumnsLg`: int — Override de Columns em ≥1440px. Default null.
- `ColumnsMd`: int — Override de Columns em ≥1024px. Default null.
- `ColumnsSm`: int — Override de Columns em ≥640px. Default null.
- `Gap`: int = 16 — Espaçamento entre colunas e entre itens (px). Default 16.
- `MinColumnWidth`: int — Largura mínima da coluna em px. Quando definido, usa column-width — a contagem de colunas reage à largura do container, sem breakpoints — e Columns é ignorado.

### OmniMediaQuery
Componente "headless" (sem render visual próprio) que escuta uma CSS media query e dispara um callback / two-way bind quando o estado muda. Equivalente ao RadzenMediaQuery, mas com APIs adicionais:Two-way @bind-Matches além do Change callback.Atalho Breakpoint que traduz para (min-width: …) usando os mesmos thresholds do OmniHidden/BreakpointService.ChildContent como render-prop opcional — recebe o bool atual pra você renderizar condicionalmente sem precisar de um campo no @code.Usage — callback: <OmniMediaQuery Query="(max-width: 768px)" Change="OnMobileChange" /> @code { void OnMobileChange(bool isMobile) { _isMobile = isMobile; } } Usage — two-way bind: <OmniMediaQuery Query="(prefers-color-scheme: dark)" @bind-Matches="_isDark" /> Usage — render-prop: <OmniMediaQuery Breakpoint="Breakpoint.Md" Context="atMd"> @if (atMd) { <DesktopNav /> } else { <MobileNav /> } </OmniMediaQuery>
_base: ComponentBase · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniMediaQuery.cs_

Parameters:
- `Breakpoint`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} — Atalho conveniente: traduz para (min-width: Npx) usando os mesmos thresholds dos outros componentes (sm=576, md=768, lg=992, xl=1200, xxl=1400). Útil quando você quer "viewport ≥ Md". Ignorado quando Query está definido.
- `Matches`: bool = false — Two-way bind do resultado: true quando a query corresponde, false caso contrário. Use junto com @bind-Matches em vez do callback Change quando você só precisa do valor declarativamente.
- `Query`: string — Media query CSS literal. Exemplo: "(max-width: 768px)", "(prefers-color-scheme: dark)", "(orientation: portrait)". Tem precedência sobre Breakpoint quando ambos estão definidos.
Events:
- `Change`: EventCallback<bool> — Callback opcional disparado quando o resultado da query muda. Recebe o novo valor (true = corresponde). Fora do bind: serve pra rodar side effects (logging, scroll lock, etc.) quando o estado muda.
- `MatchesChanged`: EventCallback<bool> — Disparado quando o Matches muda (escrita do two-way bind).
Slots:
- `ChildContent`: RenderFragment<bool> (context: bool) — Render-prop opcional: quando definido, o conteúdo é renderizado recebendo o bool atual via Context. Sem ChildContent, o componente é totalmente headless (zero DOM).

### OmniPaneHeader
Fixed (non-scrolling) header band at the top of a pane — typically a
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniPaneHeader.razor_

Parameters:
- `Subtitle`: string — Subtítulo — renderizado como p com classe .omni-view-sub.
- `Title`: string — Título principal — renderizado como h1 com classe .omni-view-title.
Slots:
- `Actions`: RenderFragment — Ações à direita (ex.: OmniButton). Quando presente, ativa layout em 2 colunas.
- `Breadcrumb`: RenderFragment — Trilha de navegação contextual (ex.: OmniBreadcrumb) — renderizada acima do título.
- `Subtabs`: RenderFragment — Sub-tabs / período / segmento contextual (ex.: OmniSegmentedControl, OmniTabs) — renderizado abaixo do par título/ações, com margem dedicada.
- `TitleContent`: RenderFragment — Alternativa ao Title quando precisa de markup customizado no lugar do h1.

### OmniPaneToolbar
Fixed (non-scrolling) toolbar band — typically below <OmniPaneHeader>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniPaneToolbar.razor_


### OmniParallax
OmniParallax — cena de parallax com camadas de profundidade.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniParallax.razor_

Parameters:
- `Axis`: ParallaxAxis {Vertical | Horizontal | Both} = Vertical — Eixo da translação das camadas (cascata; a camada pode sobrescrever). Default Vertical.
- `DisableBelow`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} = Sm — Breakpoint até o qual (inclusive) o parallax fica desligado quando DisableOnMobile. Default Sm.
- `DisableOnMobile`: bool = true — Desliga em telas pequenas (mobile sofre com jank/CLS de barra de endereço). Default true.
- `Disabled`: bool = false — Desliga o parallax (camadas em repouso). Default false.
- `MouseParallax`: bool = false — Habilita parallax por ponteiro do mouse (desktop fine-pointer). Default false.
- `MouseStrength`: double = 1 — Intensidade do parallax de mouse (px ≈ 24 × valor por camada na velocidade 1). Default 1.

### OmniParallaxLayer
OmniParallaxLayer — uma camada de profundidade de um <OmniParallax>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniParallaxLayer.razor_

Parameters:
- `Axis`: ParallaxAxis {Vertical | Horizontal | Both} — Eixo da translação. null = herda da cena (OmniParallax.Axis). Default null.
- `Range`: double = 300 — Amplitude total da translação em px (na velocidade 1). Default 300.
- `Speed`: double = 0.3 — Fator de parallax. 0 = preso ao scroll; >0 = primeiro plano (sobe ao rolar pra baixo); <0 = fundo (desce/recua). Quanto maior |Speed|, mais movimento. Default 0.3.

### OmniRow
Container grid 12-colunas responsivo.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniRow.razor_

Parameters:
- `Gap`: int = 16 — Espaçamento entre colunas e linhas (px). Default 16.

### OmniSplitAsideLabel
Small uppercase label used to group sections inside a <OmniSplitView> aside.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniSplitAsideLabel.razor_

Parameters:
- `Text`: string — Label text. Used when no ChildContent is supplied. Default null.

### OmniSplitView
Generic master/detail layout primitive: an aside (sub-navigation) + main content column inside a positioned parent (usually a <OmniMain>).
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniSplitView.razor_

Parameters:
- `AsideRight`: bool = false — Place the aside on the right instead of the default left.
- `AsideSize`: ComponentSize {Sm | Md | Lg | Xl} = Md — Aside width preset (Sm=200px, Md=228px, Lg=280px). Default = Md. Ignorado quando AsideWidth está setado.
- `AsideWidth`: string — Largura arbitrária do aside (ex: "380px", "25%", "20rem"). Quando setado, sobrescreve AsideSize. Útil para layouts POS, master/detail com proporções específicas, ou aside dimensionado por conteúdo. Pode ser sobrescrito via CSS pelo consumidor manipulando a custom property --omni-aside-w em media queries.
- `AutoCloseOnNavigate`: bool = true — Se true (default), fecha o overlay automaticamente em mobile quando o usuário navega — elimina overlay travado sobre a nova rota.
- `MobileBreakpoint`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} = Lg — Breakpoint a partir do qual o aside vira overlay (drawer mobile). Default Lg (~992px) — em telas menores que isso, mostra hamburger.
- `ShowMobileToggle`: bool = true — Quando true (default), renderiza o hamburger no canto top-left em mobile. Defina false se você tem AppBar com DrawerToggle próprio.
Slots:
- `AsideContent`: RenderFragment — Aside (sub-navigation) column content. Becomes an overlay drawer below MobileBreakpoint.
- `ChildContent`: RenderFragment — Main column content (scrollable). Typically a pane header/toolbar plus a body.

### OmniSplitter
N-pane resizable splitter.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniSplitter.razor_

Parameters:
- `Height`: string = 100% — Altura CSS do container. Default "100%".
- `Orientation`: Orientation {Horizontal | Vertical} = Horizontal — Direção do split. Horizontal = panes lado-a-lado (drag horizontal). Vertical = empilhados (drag vertical).
- `ResetOnDoubleClick`: bool = true — Quando true, double-click na barra reseta os tamanhos dos panes para os valores iniciais (de Size). Quando o pane adjacente é Collapsible, double-click colapsa/expande (prioridade maior). Default true — espelha o comportamento do MudSplitPanel.
- `UseAsOverlay`: bool = false — Posiciona o splitter como overlay position: absolute preenchendo o pai. O elemento pai precisa ter position: relative. Equivalente ao UseAsOverlay do MudSplitPanel. Default false.
- `Variant`: SplitterVariant {Solid | Line | Gap} = Solid — Estilo visual da barra. Solid (default) = barra visível com grip dots — ideal para PDV, dashboards e telas de gestão. Line = hairline minimalista que vira accent no hover — ideal para IDE, editor de relatórios. Gap = espaçamento invisível — ideal para landing pages.
- `Width`: string = 100% — Largura CSS do container. Default "100%".
Events:
- `OnResize`: EventCallback<SplitterResizeEventArgs> — Disparado a cada tick do drag (use com moderação — pode disparar muito).
- `OnResizeEnd`: EventCallback<SplitterResizeEventArgs> — Disparado UMA vez ao soltar a barra. Use isso para persistir layout.

### OmniSplitterPane
Pane child of <OmniSplitter>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniSplitterPane.razor_

Parameters:
- `Collapsed`: bool = false — Two-way: is the pane currently collapsed?
- `Collapsible`: bool = false — Whether the pane can be collapsed via the bar's chevron buttons. Default false.
- `Max`: string — Maximum size ("%" or "px"). User can't drag the bar above this.
- `Min`: string — Minimum size ("%" or "px"). User can't drag the bar below this.
- `Resizable`: bool = true — Whether the pane can be resized via the adjacent bar. Default true.
- `Size`: string — Initial size — accepts "30%" or "200px". Null/empty = "auto" (the pane shares the remaining space equally with other auto panes).
Events:
- `CollapsedChanged`: EventCallback<bool> — Fires when Collapsed flips. Enables @bind-Collapsed.

### OmniStack
Container flex declarativo — equivalente a <c>MudStack</c> (MudBlazor) e
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniStack.razor_

Parameters:
- `AlignItems`: StackAlign {Start | Center | End | Stretch | Baseline} = Stretch — Alinhamento dos filhos no eixo cross (mapeia para align-items). Default Stretch.
- `Direction`: StackDirection {Column | Row} = Column — Direção do flex container. Default Column.
- `DirectionLg`: StackDirection {Column | Row} — Override em ≥1440px. Default null.
- `DirectionMd`: StackDirection {Column | Row} — Override em ≥1024px. Default null.
- `DirectionSm`: StackDirection {Column | Row} — Override em ≥640px. Default null (segue Direction).
- `Gap`: int = 8 — Espaçamento entre filhos em pixels. Default 8.
- `Justify`: StackJustify {Start | Center | End | Between | Around | Evenly} = Start — Distribuição dos filhos no eixo main (mapeia para justify-content). Default Start.
- `Wrap`: bool = false — Quebra de linha (flex-wrap). Default false.

### OmniSwipeArea
Detecta gestos de swipe (deslize) e dispara eventos com a direção e a distância.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniSwipeArea.razor_

Parameters:
- `LiveTransform`: SwipeAreaLiveTransform {None | X | Y | Both} = None — Live drag direto pelo JS (60fps, bypassa Blazor SignalR). Quando setado (≠ None), o JS atualiza transform: translate(...) no elemento via CSS variable a cada pointermove. OnSwipeEnd continua disparando normalmente — você decide se faz snap, dismiss ou volta pra origem. Em None (default), só os eventos C# disparam (que ainda permitem live drag, mas via SignalR roundtrip).
- `PreventDefault`: bool = false — Quando true, anexa listeners JS não-passivos que chamam preventDefault(). Necessário para impedir o scroll da página durante swipes verticais em mobile. Default false.
- `Sensitivity`: int = 100 — Distância mínima (pixels) para disparar OnSwipeEnd. Swipes menores que isso são silenciosamente ignorados. Default 100.
Events:
- `OnSwipeCancel`: EventCallback<PointerEventArgs> — Disparado quando o pointer é cancelado (multitouch, etc.).
- `OnSwipeEnd`: EventCallback<SwipeEventArgs> — Disparado UMA vez no pointerup, se a distância arrastada (no eixo dominante) ultrapassou Sensitivity.
- `OnSwipeLeave`: EventCallback<PointerEventArgs> — Disparado quando o ponteiro SAI da área durante o arraste. Não reseta o estado automaticamente — o consumidor pode chamar Cancel se quiser abortar o gesto em curso.
- `OnSwipeMove`: EventCallback<MultiDimensionSwipeEventArgs> — Disparado A CADA pointermove durante o arraste. Inclui delta + direção em AMBOS os eixos (x e y). Ignora Sensitivity.

### OmniTheme
Theme bootstrap — drop into the <head> of your App.razor.
_base: ComponentBase · source: src/Omni.Blazor/Components/Layout/OmniTheme.razor_

Parameters:
- `Accent`: string = amber — Initial accent. 12 cores suportadas: amber (default), emerald, blue, violet, crimson, rose, orange, teal, cyan, indigo, fuchsia, lime. Unknown values fall back to amber.
- `Dark`: bool = false — Start in dark mode. Default false.

### OmniThemePicker
Dropdown pronto para trocar accent + dark/light/system.
_base: OmniComponent · source: src/Omni.Blazor/Components/Layout/OmniThemePicker.razor_

Parameters:
- `Accents`: IReadOnlyList<string> — Cores de accent oferecidas. Default: as 5 já suportadas (amber/emerald/blue/violet/crimson).
- `ShowDensity`: bool = true — Mostra a seção de densidade (Compacto/Padrão/Espaçoso) no dropdown. Default true. P3.3 — Layout density toggle.
- `Title`: string = Tema — Texto acessível do botão (aria-label / tooltip). Default "Tema".

### OmniToolBar
Faixa horizontal abaixo do <c>OmniAppBar</c>.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Layout/OmniToolBar.razor_

Parameters:
- `Bordered`: bool = true — Borda inferior. Default true.

## Marketing

### OmniEyebrow
Small uppercase kicker/label rendered above a heading, optionally preceded by an accent dot.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Marketing/OmniEyebrow.razor_

Parameters:
- `ShowDot`: bool = true — Renders the leading accent dot before the text. Defaults to true.
- `Text`: string — Text shown inside the eyebrow; ignored when ChildContent is provided.

### OmniHero
Marketing hero section composing an eyebrow, title, subtitle and a CTA row above arbitrary child content.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Marketing/OmniHero.razor_

Parameters:
- `Eyebrow`: string — Eyebrow text rendered in an OmniEyebrow; ignored when EyebrowContent is set.
- `Subtitle`: string — Subtitle paragraph rendered below the title; omitted when empty.
- `Title`: string — Hero title rendered as an h1; the value is treated as raw HTML (MarkupString). Ignored when TitleContent is set.
Slots:
- `CtaContent`: RenderFragment — Call-to-action markup rendered in a dedicated row below the subtitle.
- `EyebrowContent`: RenderFragment — Custom eyebrow markup; when set it replaces the Eyebrow text.
- `TitleContent`: RenderFragment — Custom title markup; when set it replaces the Title heading.

### OmniMosaic
Grid container that lays out OmniMosaicCard children into a responsive mosaic.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Marketing/OmniMosaic.razor_


### OmniMosaicCard
Single mosaic tile showing an optional icon plus a name and meta line, for use inside an OmniMosaic.
_base: OmniComponent · source: src/Omni.Blazor/Components/Marketing/OmniMosaicCard.razor_

Parameters:
- `Featured`: bool = false — When true, renders the card with inverted (filled accent) styling for emphasis. Defaults to false.
- `Icon`: string — Name of the OmniIcon rendered at the start of the card; omitted when empty.
- `Meta`: string — Secondary meta line shown below the name; omitted when empty.
- `Name`: string *required* =  — Primary label shown on the card. Required.
- `Wide`: bool = false — When true, the card spans two grid columns in the mosaic. Defaults to false.

## Navigation

### OmniBreadcrumb
Breadcrumb trail (`<nav>`): renders Items as "/"-separated links, with the last (or path-less) item shown as the current page.
_base: OmniComponent · source: src/Omni.Blazor/Components/Navigation/OmniBreadcrumb.razor_

Parameters:
- `Items`: IEnumerable<Item> — Ordered trail of crumbs; each Item is a Text plus an optional Path (link). The last item renders as the current page.

### OmniExitPrompt
Intercepts navigation attempts when `When` returns true and asks the user to confirm.
_base: OmniComponent · source: src/Omni.Blazor/Components/Navigation/OmniExitPrompt.razor_

Parameters:
- `CancelText`: string = Continuar editando — Label of the cancel (stay) button in the dialog.
- `ConfirmText`: string = Sair sem salvar — Label of the confirm (leave) button in the dialog.
- `Text`: string = Você tem alterações não salvas. Deseja sair mesmo assim? — Body message of the confirmation prompt (used by both the dialog and the native window.confirm).
- `Title`: string = Sair sem salvar? — Title of the confirmation dialog (DialogService path only).
- `UseNativePrompt`: bool = false — When true, uses the browser's native window.confirm instead of the Omni DialogService for in-app navigation. Default false.
- `When`: Func<bool> — Predicate that gates the prompt: navigation is intercepted only while it returns true. When null, the prompt is always active.

### OmniGlobalSearch
Embedded global search surface with local/remote providers and keyboard navigation.
_base: OmniComponent · source: src/Omni.Blazor/Components/Navigation/OmniGlobalSearch.razor_

Parameters:
- `AriaLabel`: string = Busca global — Accessible label for the search landmark.
- `ClearText`: string = Limpar busca — Accessible label for the clear-query action.
- `Debounce`: int = 250 — Delay before invoking SearchProvider, in milliseconds.
- `EmptyText`: string = Nenhum resultado encontrado. — Message shown when no result matches.
- `ErrorText`: string = Não foi possível concluir a busca. — Message shown when the provider fails.
- `HintText`: string = Digite para buscar — Hint shown before the minimum query length is reached.
- `Items`: IEnumerable<GlobalSearchResult> — Optional in-memory result source, combined with provider results.
- `LoadingText`: string = Buscando... — Message shown while the provider is running.
- `MaxResults`: int = 50 — Maximum number of combined results retained and rendered.
- `MinQueryLength`: int = 2 — Minimum trimmed query length required to search.
- `NavigateOnSelect`: bool = true — Navigates to a selected result's URL after raising ResultSelected.
- `Placeholder`: string = Buscar em todo o sistema... — Search input placeholder.
- `Query`: string — Current query for two-way binding.
- `SearchProvider`: GlobalSearchProvider — Optional asynchronous, cancellable server-side result source.
- `ShowAllWhenEmpty`: bool = false — Shows all local items when the query is empty.
Events:
- `QueryChanged`: EventCallback<string> — Raised when Query changes.
- `ResultSelected`: EventCallback<GlobalSearchResult> — Raised when the user chooses a result.
- `SearchFailed`: EventCallback<Exception> — Raised when a provider throws an uncancelled exception.
Slots:
- `InitialContent`: RenderFragment — Optional content displayed before the minimum query length is reached.
- `ResultTemplate`: RenderFragment<GlobalSearchResult> (context: GlobalSearchResult) — Optional custom result renderer.

### OmniHotkey
Drop-in keyboard shortcut.
_base: OmniComponent · source: src/Omni.Blazor/Components/Navigation/OmniHotkey.razor_

Parameters:
- `Combo`: string — Full combo spec string (e.g. "Ctrl+K", or "Ctrl+K|Meta+K" for alternatives). Takes precedence over Key/Modifiers when set.
- `Disabled`: bool = false — When true, the registration stays but the shortcut is inert; toggling this enables/disables in place without re-registering. Default false.
- `Key`: string — The base key (e.g. "K", "Escape") when not using Combo; combined with Modifiers to build the binding.
- `Modifiers`: Modifier {None | Ctrl | Alt | Shift | Meta} = None — Modifier flags (Ctrl/Alt/Shift/Meta) applied to Key. Default Modifier.None.
- `PreventDefault`: bool = true — When true, calls preventDefault on the key event so the browser default is suppressed. Default true.
- `StopPropagation`: bool = false — When true, stops the key event from propagating further. Default false.
Events:
- `OnPressed`: EventCallback<KeyboardEventArgs> — Invoked when the shortcut fires, with the originating KeyboardEventArgs.

### OmniMenuBar
Horizontal navigation bar — tab-style root items with rich dropdowns.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniMenuBar.razor_

Parameters:
- `AriaLabel`: string = Menu — Accessible label for the navigation landmark.
- `Trigger`: MenuTrigger {Hover | Click} = Click — How a dropdown first opens — Click (default) or Hover.
Slots:
- `Aux`: RenderFragment — Optional content pinned to the right edge of the bar (status, etc.).

### OmniMenuBarItem
One node of a OmniMenuBar.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniMenuBarItem.razor_

Parameters:
- `ChildrenLabel`: string — Optional section label rendered at the top of this item's flyout (when it has children).
- `Count`: int — Numeric badge shown on a root tab.
- `Description`: string — Secondary description line (dropdown row).
- `Disabled`: bool = false — Disables the item.
- `FooterKbd`: string — Footer keyboard hint.
- `FooterPath`: string — Footer link URL. If unset, the footer raises OnFooter.
- `FooterText`: string — Footer link text for a list dropdown.
- `GroupLabel`: string — Uppercase section label rendered above this dropdown row.
- `Icon`: string — Optional icon name.
- `Match`: NavLinkMatch {Prefix | All} = Prefix — Active-route match mode for Path.
- `Meta`: string — Metadata pill text (dropdown row).
- `MetaKind`: MenuMetaKind {Neutral | Accent | Good | Warn | Danger} = Neutral — Colour of the metadata pill.
- `Path`: string — Navigation URL. Ignored when the item has a dropdown.
- `Text`: string =  — Label text.
Events:
- `OnClick`: EventCallback — Click handler for items without a Path or dropdown.
- `OnFooter`: EventCallback — Footer click handler when FooterPath is unset.
Slots:
- `DropdownContent`: RenderFragment — Custom dropdown panel (mega-menu) — replaces nested items.

### OmniPagination
Standalone pager — use anywhere outside of DataGrid (cards, timelines, custom lists).
_base: OmniComponent · source: src/Omni.Blazor/Components/Navigation/OmniPagination.razor_

Parameters:
- `Compact`: bool = false — If true, hides numeric buttons and shows just "N / Total" between the arrows.
- `CurrentPage`: int = 0 — Current zero-based page index (clamped to the valid range). Two-way bindable via @bind-CurrentPage.
- `MaxVisible`: int = 7 — Maximum number of numeric page buttons to show (excluding ellipsis). Default 7.
- `PageSize`: int = 10 — Number of items per page. Default 10.
- `ShowSummary`: bool = false — If true, shows the "1–10 de 200" summary to the left.
- `TotalCount`: int = 0 — Total number of items across all pages; used with PageSize to compute the page count and summary.
Events:
- `CurrentPageChanged`: EventCallback<int> — Raised when the page changes, carrying the new zero-based page index.

### OmniPanelMenu
Vertical navigation list (`<nav>`).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniPanelMenu.razor_

Parameters:
- `SectionLabel`: string — Optional section label rendered above the menu (e.g. "WORKSPACE").

### OmniPanelMenuItem
One node of a OmniPanelMenu.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniPanelMenuItem.razor_

Parameters:
- `Count`: int — Numeric count pill (e.g. unread, items in queue).
- `CountKind`: MenuMetaKind {Neutral | Accent | Good | Warn | Danger} = Neutral — Color of the count pill.
- `CountText`: string — String count pill (e.g. "!", "74%", "NEW") — alternative to Count.
- `Disabled`: bool = false — Disables the item.
- `Expanded`: bool = false — Inline-accordion state for items with children (expanded sidebar mode).
- `Icon`: string — Optional icon name.
- `Match`: NavLinkMatch {Prefix | All} = Prefix — Match mode for the active-route highlight.
- `Path`: string — Navigation URL (leaf items only).
- `Text`: string =  — Label.
Events:
- `ExpandedChanged`: EventCallback<bool> — Raised when the inline-accordion expanded state toggles, carrying the new value.
- `OnClick`: EventCallback — Click handler for leaf items without a Path.
Slots:
- `TextContent`: RenderFragment — Optional rich label (e.g. with highlighted matches). Falls back to Text.

### OmniPanelMenuSection
Groups panel-menu items under an optional section heading.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniPanelMenuSection.razor_

Parameters:
- `Label`: string — Optional uppercase section heading rendered above the grouped items; when empty, no heading is shown.

### OmniSegmentedControl
Single-select segmented button group: renders Items as toggle buttons, highlighting the one matching Value.
_base: OmniComponent · source: src/Omni.Blazor/Components/Navigation/OmniSegmentedControl.razor_

Parameters:
- `Items`: IEnumerable<Item<TValue>> — The selectable segments; each Item pairs a Value with its display Label.
- `Value`: TValue — Currently selected value; the matching segment renders as active. Two-way bindable via @bind-Value.
Events:
- `ValueChanged`: EventCallback<TValue> — Raised when a segment is selected, carrying the newly selected value.

### OmniStep
A single step inside an OmniStepper; renders no markup itself and registers with the parent stepper, which draws its header and body.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniStep.razor_

Parameters:
- `Description`: string — Optional secondary line shown under the title in the header.
- `Disabled`: bool = false — When true, the step's bubble/dot cannot be clicked. Default false.
- `Icon`: string — Optional icon name shown in the step bubble (replaces the number when the step isn't done).
- `Optional`: bool = false — When true, appends an "(opcional)" marker after the title. Default false.
- `Title`: string *required* =  — Step title shown in the header label. Required.
Slots:
- `ChildContent`: RenderFragment — The step's body content, rendered by the parent stepper only while this step is active.

### OmniStepper
Multi-step container.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniStepper.razor_

Parameters:
- `ActiveStep`: int = 0 — Zero-based index of the active step. Two-way bindable via @bind-ActiveStep.
- `CompleteText`: string — Label of the final "complete" button shown on the last step. Default "Concluir".
- `Linear`: bool = true — When true, steps must be completed in order: you cannot jump forward past the next step or click a pending step. Default true.
- `NextText`: string — Label of the "next step" button. Default "Próximo".
- `PrevText`: string — Label of the "previous step" button. Default "Voltar".
Events:
- `ActiveStepChanged`: EventCallback<int> — Raised when the active step changes, carrying the new zero-based index.
- `OnComplete`: EventCallback — Raised when the complete button on the last step is clicked.

### OmniTabItem
A single tab inside an OmniTabs; renders no markup itself and registers with the parent, which draws the tab button and shows its body when active.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniTabItem.razor_

Parameters:
- `Icon`: string — Optional icon name shown before the title on the tab button.
- `Title`: string *required* =  — Tab label shown on the tab button. Required.
Slots:
- `ChildContent`: RenderFragment — The tab's panel content, rendered by the parent only while this tab is active.

### OmniTabs
Tab container: renders a tab bar from its OmniTabItem children and shows the active tab's body; the first registered tab is active by default.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Navigation/OmniTabs.razor_


## Overlay

### AlertDialog
Conteúdo interno do dialog de alerta (mensagem + ícone opcional + botão OK) aberto via DialogService.AlertAsync.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/AlertDialog.razor_

Parameters:
- `Message`: string *required* =  — Texto da mensagem exibida no corpo do alerta.
- `Options`: AlertOptions — Opções do alerta (texto do botão OK, ícone). Default new AlertOptions().

### ConfirmDialog
Conteúdo interno do dialog de confirmação (mensagem + botões Cancelar/OK) aberto via DialogService.ConfirmAsync; retorna true/false.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/ConfirmDialog.razor_

Parameters:
- `Message`: string *required* =  — Texto da mensagem exibida no corpo da confirmação.
- `Options`: ConfirmOptions — Opções da confirmação (textos dos botões OK/Cancelar, ícone). Default new ConfirmOptions().

### OmniBottomSheet
Material 3 Bottom Sheet — surface slides up from the bottom edge with optional drag handle + snap points.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniBottomSheet.razor_

Parameters:
- `Adaptive`: BottomSheetAdaptive {Always | DrawerOnDesktop | DialogOnDesktop} = Always — Comportamento em desktop. Default Always (sempre bottom). DrawerOnDesktop/DialogOnDesktop = adapta em telas largas (M3 desaconselha bottom sheet em desktop).
- `CloseOnEsc`: bool = true — Esc fecha. Default true.
- `CloseOnOverlayClick`: bool = true — Click no backdrop fecha (só Modal). Default true.
- `DesktopBreakpoint`: Breakpoint {Xs | Sm | Md | Lg | Xl | Xxl} = Md — Breakpoint que define "desktop" pra Adaptive. Default Md (≥ 768px).
- `DismissThresholdPx`: double = 100 — Pixels que o user precisa arrastar pra baixo (além do menor snap) pra fechar quando DragToDismiss=true. Default 100.
- `DragToDismiss`: bool = true — Drag pra baixo além do menor snap fecha. Default true.
- `InitialSnapIndex`: int = 0 — Índice inicial em SnapPoints. Default 0 (menor).
- `Open`: bool = false — Estado aberto/fechado. Two-way bind via @@bind-Open.
- `ShowCloseButton`: bool = true — Mostra botão X no header pra fechar. Default true se Title ou Header.
- `ShowDragHandle`: bool = true — Mostra drag handle (pill no topo). Default true.
- `SnapPoints`: double[] — Snap points como fração viewport (0–1). Ex: [0.3, 0.6, 0.92] = peek 30%, half 60%, full 92%. Sem snap points, sheet abre em 60% por default.
- `Title`: string — Título mostrado no header. Se Header for setado, ignorado.
- `Variant`: BottomSheetVariant {Modal | Standard} = Modal — Modal (com backdrop) ou Standard (sem). Default Modal.
Events:
- `OpenChanged`: EventCallback<bool>
Slots:
- `ChildContent`: RenderFragment — Conteúdo principal scrollável.
- `Footer`: RenderFragment — Footer sticky (não scrolla com conteúdo).
- `Header`: RenderFragment — Custom header (sobrescreve Title).

### OmniCommandPalette
⌘K command palette — a global, searchable, keyboard-driven action menu.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniCommandPalette.razor_

Parameters:
- `CommandSource`: Func<string, Task<IEnumerable<OmniCommand>>> — Optional async source for server-side results. Called (debounced) with the query; its results are merged with the local Commands. Only queried at the root level (not inside a sub-page).
- `Commands`: IEnumerable<OmniCommand> — The commands to search/run. May carry Children for nested pages.
- `EnableHistory`: bool = true — Track + surface recently used commands (persisted to localStorage). Default true.
- `EnableHotkey`: bool = true — Bind the global open hotkey. Default true.
- `HistoryKey`: string = default — Namespace key for the recent-command history (lets multiple palettes keep separate history).
- `HotKey`: string = Ctrl+K|Meta+K — The open hotkey combo. Default Ctrl+K (Win/Linux) and Cmd+K (mac).
- `Open`: bool = false — Open state (two-way). Also toggled by the global hotkey.
- `Placeholder`: string — Search box placeholder.
- `RecentCount`: int = 5 — How many recent commands to surface in the "Recentes" section.
- `RecentLabel`: string = Recentes — Heading for the recent-commands section.
- `SearchDebounce`: int = 200 — Debounce (ms) before calling CommandSource. Default 200.
- `ShowFooter`: bool = true — Show the footer with key hints. Default true.
Events:
- `OnCommand`: EventCallback<OmniCommand> — Fires with the chosen command (after its own Action, if any, runs).
- `OpenChanged`: EventCallback<bool>

### OmniConfirmPrompt
Destructive-action confirmation that requires the user to TYPE a matching phrase before the confirm button enables (GitHub/Stripe/AWS pattern).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniConfirmPrompt.razor_

Parameters:
- `ButtonText`: string — Confirm button text. Default "Confirmar".
- `CaseSensitive`: bool = true — Match case-sensitively. Default true.
- `ConfirmationText`: string *required* =  — The phrase the user must type exactly to enable the confirm button.
- `Label`: string — Instruction above the input. Defaults to "Digite \"{ConfirmationText}\" para confirmar".
- `Title`: string — Heading (optional).
Events:
- `OnConfirm`: EventCallback — Fires when the user confirms (button only enabled once the phrase matches).

### OmniContextMenuHost
Portal host for pointer or trigger-anchored menus with keyboard navigation and deterministic listener cleanup.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniContextMenuHost.razor_


### OmniDialogHost
Portal host that renders modal and side dialogs opened via DialogService (stacked, with backdrop, focus trap, scroll lock and Esc); place once in the root layout.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniDialogHost.razor_


### OmniMenu
Reusable menu list — a panel of <OmniMenuItem>s (and optional separators).
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniMenu.razor_


### OmniMenuItem
A single clickable row inside an <OmniMenu>: optional icon, label, and keyboard-shortcut hint.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniMenuItem.razor_

Parameters:
- `Description`: string — Optional secondary description rendered below the label.
- `Disabled`: bool = false — Disables the item (no click, dimmed). Default false.
- `Icon`: string — Optional leading icon name.
- `IsDanger`: bool = false — Styles the item as a destructive action (danger color). Default false.
- `Shortcut`: string — Optional keyboard-shortcut hint shown trailing (e.g. "⌘D"), rendered as a kbd.
- `Text`: string — Label text (ignored when ChildContent is supplied).
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Raised when the item is clicked (suppressed while Disabled).

### OmniMenuSeparator
Horizontal divider between groups of <OmniMenuItem>s.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniMenuSeparator.razor_


### OmniNotificationHost
Portal host that renders the stack of toast notifications pushed via NotificationService (positioned, auto-dismissing); place once in the root layout.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniNotificationHost.razor_


### OmniOverlay
Componente standalone de overlay/backdrop reutilizável.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniOverlay.razor_

Parameters:
- `Absolute`: bool = false — Position absolute em vez de fixed. Use quando o overlay deve preencher um container específico (não a viewport). O container precisa ter position: relative. Quando true, LockScroll é ignorado (não faz sentido bloquear scroll do body num overlay local).
- `AutoClose`: bool = false — Quando true, clicar no backdrop fecha (seta Visible=false). Default false. Conteúdo (ChildContent) não dispara — o overlay usa @@onclick:stopPropagation no wrapper interno.
- `CloseOnEsc`: bool = true — Quando true (default), Esc fecha o overlay. false ignora Esc.
- `LockScroll`: bool = true — Bloqueia scroll do <body> enquanto visível. Default true. Refcount-safe — múltiplos overlays não desbloqueiam até todos fecharem.
- `Modal`: bool = true — Quando true (default), o overlay BLOQUEIA cliques no que está atrás. Quando false, pointer-events: none deixa o user clicar através (modo "decoração" — overlay decorativo sem capturar input).
- `Visible`: bool = false — Controla a visibilidade. Two-way via @@bind-Visible.
- `ZIndex`: int — Z-index inline. Quando null (default), herda o stack natural (500).
Events:
- `OnClick`: EventCallback<MouseEventArgs> — Callback adicional quando o user clica no backdrop. Recebe o MouseEventArgs. Dispara independente de AutoClose (AutoClose só decide se fecha).
- `OnClosed`: EventCallback — Disparado quando o overlay fecha (via AutoClose, Esc ou bind setando false).
- `VisibleChanged`: EventCallback<bool>
Slots:
- `ChildContent`: RenderFragment — Conteúdo opcional renderizado centrado dentro do overlay. Quando null, o overlay é puro scrim (sem nada visível além do backdrop).

### OmniOverlayHosts
Conveniência: monta de uma vez os 4 hosts de overlay da lib (Dialog, Notification, Tooltip, ContextMenu).
_base: ComponentBase · source: src/Omni.Blazor/Components/Overlay/OmniOverlayHosts.razor_


### OmniPopover
Interactive popover — like Tooltip but with arbitrary content (links, forms, menus).
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniPopover.razor_

Parameters:
- `AlignEnd`: bool = false — Alinha o popover ao FIM (direita) do trigger ao invés do começo (esquerda). Útil para split buttons cujo trigger fica à direita: AlignEnd=true faz o popover crescer para a esquerda, evitando overflow no canto direito da tela.
- `CloseOnContentClick`: bool = false — Se um clique no conteúdo deve fechar o popover. Default false (atualmente não consumido pela lógica — o conteúdo usa stopPropagation).
- `Offset`: int = 8 — Distância (px) entre o trigger e o popover. Default 8 (tooltip-like). Para dropdown menus, use 2-4 para parecer "grudado" no botão.
- `Open`: bool = false — Estado aberto/fechado. Two-way via @@bind-Open.
- `Position`: PopoverPosition {Top | Bottom | Left | Right} = Bottom — Lado preferido do popover em relação ao trigger. Default Bottom (auto-flip se faltar espaço).
- `ShowArrow`: bool = true — Mostra setinha (estilo tooltip/balão). Default true. Para menus dropdown, defina false — visual mais limpo, sem o "balão".
- `Width`: string — Largura CSS fixa do popover (ex.: "240px"). Quando null, ajusta ao conteúdo.
Events:
- `OpenChanged`: EventCallback<bool> — Disparado quando o estado aberto/fechado muda.
Slots:
- `ChildContent`: RenderFragment — Conteúdo do popover (links, formulário, menu).
- `Trigger`: RenderFragment *required* — Elemento gatilho que abre/fecha o popover ao clicar (slot obrigatório).

### OmniTooltipHost
Portal host that renders the single active tooltip positioned by TooltipService; place once in the root layout.
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniTooltipHost.razor_


### OmniTour
Container declarativo de um tour.
_base: OmniComponentWithChildren · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniTour.razor_

Parameters:
- `AutoStart`: bool = false — Inicia automaticamente na primeira renderização.
- `Persist`: bool = false — Persiste "não mostrar de novo" por TourId.
- `ShowBackdrop`: bool = true — Mostra o fundo escurecido com recorte. Default true.
- `StartTrigger`: bool = false — Dispara o tour ao virar true (two-way — é resetado para false ao fim).
- `TourId`: string — Id do tour (chave de persistência quando Persist = true).
Events:
- `OnCompleted`: EventCallback — Disparado quando o tour é concluído (chegou ao fim).
- `OnSkipped`: EventCallback — Disparado quando o tour é pulado/dispensado.
- `StartTriggerChanged`: EventCallback<bool>

### OmniTourHost
Host único do OmniTour (portal).
_base: OmniComponent · source: src/Omni.Blazor/Components/Overlay/OmniTourHost.razor_


### OmniTourStep
Passo declarativo de um <OmniTour>.
_base: OmniComponent · accepts ChildContent · source: src/Omni.Blazor/Components/Overlay/OmniTourStep.razor_

Parameters:
- `Position`: TourPosition {Auto | Top | Bottom | Left | Right} = Auto — Lado preferido do coachmark. Default Auto.
- `Target`: string — Seletor CSS do alvo (ex.: "#salvar"). null = passo sem spotlight.
- `Title`: string — Título do passo.
Slots:
- `ChildContent`: RenderFragment — Corpo do coachmark.

## Fluent configuration APIs

Typed schemas, builders and providers used by advanced components:

### DataFilterField<TItem>
Immutable metadata and typed accessors for one schema field.
_class · source: src/Omni.Blazor/Models/DataFilterSchema.cs_
- `bool AllowsNull` — Whether the selected CLR member accepts null values.
- `string Id` — Stable id stored in serialized queries.
- `string MemberPath` — Compile-time validated member path selected by the schema.
- `IReadOnlyList<FilterOperator> Operators` — Allowed operators.
- `Func<object, string> OptionText` — Formats one select option.
- `IReadOnlyList<object> Options` — Immutable select options.
- `string Title` — Display label shown by the visual builder.
- `ColumnFilterType Type` — Editor/operator family.
- `Type ValueType` — CLR value type selected by the field expression.

### DataFilterFieldBuilder<TItem, TValue>
Strongly typed options for one filterable member.
_class · source: src/Omni.Blazor/Models/DataFilterSchema.cs_
- `DataFilterFieldBuilder<TItem, TValue> Id(string value)` — Overrides the stable id stored in serialized queries.
- `DataFilterFieldBuilder<TItem, TValue> Operators(FilterOperator[] values)` — Restricts the operators available to this field.
- `DataFilterFieldBuilder<TItem, TValue> Select(IEnumerable<TValue> values, Func<TValue, string> textSelector)` — Uses a typed select editor with deterministic option labels.
- `DataFilterFieldBuilder<TItem, TValue> Title(string value)` — Overrides the field label shown in the property selector.
- `DataFilterFieldBuilder<TItem, TValue> Type(ColumnFilterType value)` — Overrides the inferred editor/operator family.
- `DataFilterFieldBuilder<TItem, TValue> ValueCodec(Func<TValue, string> serialize, Func<string, TValue> deserialize)` — Configures a stable invariant codec for custom value types. Primitive, enum, date, time and Guid values already have built-in codecs.

### DataFilterGroupBuilder<TItem>
Fluent builder for one AND/OR query group.
_class · source: src/Omni.Blazor/Models/DataFilterQuery.cs_
- `DataFilterGroupBuilder<TItem> Between<TValue>(Expression<Func<TItem, TValue>> field, TValue lower, TValue upper, bool negate)` — Adds an inclusive Between or exclusive NotBetween condition.
- `DataFilterGroupBuilder<TItem> Condition<TValue>(Expression<Func<TItem, TValue>> field, FilterOperator operator)` — Adds a strongly typed condition with one value.
- `DataFilterGroupBuilder<TItem> Condition<TValue>(Expression<Func<TItem, TValue>> field, FilterOperator operator, TValue value)` — Adds a strongly typed condition with one value.
- `DataFilterGroupBuilder<TItem> Group(FilterLogic logic, Action<DataFilterGroupBuilder<TItem>> configure)` — Adds a nested group.

### DataFilterQuery<TItem>
Immutable, versioned and safely serializable query for one item type. Field expressions and codecs remain in the corresponding DataFilterSchema.
_class · source: src/Omni.Blazor/Models/DataFilterQuery.cs_
- `IEnumerable<TItem> Apply(IEnumerable<TItem> source, DataFilterSchema<TItem> schema)` — Filters an in-memory sequence without materializing it.
- `IQueryable<TItem> Apply(IQueryable<TItem> source, DataFilterSchema<TItem> schema)` — Filters an in-memory sequence without materializing it.
- `Func<TItem, bool> Compile(DataFilterSchema<TItem> schema)` — Builds an in-memory predicate with the schema's compiled typed accessors.
- `static DataFilterQuery<TItem> Deserialize(string json, DataFilterSchema<TItem> schema)` — Deserializes and validates a query against an allow-listed schema.
- `DataFilterQueryGroup Root` — Root query group.
- `string Serialize()` — Serializes this immutable query using the stable versioned contract.
- `Expression<Func<TItem, bool>> ToExpression(DataFilterSchema<TItem> schema)` — Builds an IQueryable-friendly expression. String comparison semantics follow the target LINQ provider/collation instead of forcing a client-side comparer.
- `static bool TryDeserialize(string json, DataFilterSchema<TItem> schema, DataFilterQuery`1& query, String& error)` — Attempts to deserialize and validate a query without leaking expected parse failures.
- `Void Validate(DataFilterSchema<TItem> schema)` — Validates field ids, operators, values, size and depth.
- `int Version` — Serialized contract version.

### DataFilterQueryGroup
Immutable group in a typed DataFilter query tree.
_class · source: src/Omni.Blazor/Models/DataFilterQuery.cs_
- `DataFilterQueryGroup(FilterLogic logic, IReadOnlyList<DataFilterQueryRule> rules)` — Creates an immutable group snapshot.
- `FilterLogic Logic` — How direct children are combined.
- `IReadOnlyList<DataFilterQueryRule> Rules` — Immutable direct child conditions and groups.

### DataFilterQueryRule
Immutable condition or nested group in a typed DataFilter query.
_class · source: src/Omni.Blazor/Models/DataFilterQuery.cs_
- `DataFilterQueryRule(string field, FilterOperator operator, DataFilterValue value, DataFilterValue upperValue, DataFilterQueryGroup group)` — Creates one serialized query node.
- `string Field` — Stable schema field id. Null for groups.
- `DataFilterQueryGroup Group` — Nested group. Non-null marks this node as a group.
- `bool IsGroup` — Whether this node contains a nested group.
- `FilterOperator Operator` — Condition operator.
- `DataFilterValue UpperValue` — Upper value used by Between and NotBetween.
- `DataFilterValue Value` — Condition value.

### DataFilterSchema<TItem>
Immutable, strongly typed definition of the fields exposed by an OmniDataFilter. Reuse one schema across renders and filter instances.
_class · source: src/Omni.Blazor/Models/DataFilterSchema.cs_
- `static DataFilterSchemaBuilder<TItem> Builder()` — Creates a reusable schema builder.
- `static DataFilterSchema<TItem> Create(Action<DataFilterSchemaBuilder<TItem>> configure)` — Creates and builds an immutable schema in one expression.
- `DataFilterSchema<TItem> Extend(Action<DataFilterSchemaBuilder<TItem>> configure)` — Creates an immutable derived schema from this reusable base.
- `IReadOnlyList<DataFilterField<TItem>> Fields` — Filterable fields in deterministic declaration order.
- `int MaximumDepth` — Maximum accepted nested group depth. Default 16.
- `int MaximumRules` — Maximum accepted condition and group count. Default 512.
- `DataFilterQuery<TItem> Query(Action<DataFilterGroupBuilder<TItem>> configure, FilterLogic logic)` — Creates a typed query against this schema.
- `bool TryGetField(string id, DataFilterField`1& field)` — Finds a field by its stable serialized id.

### DataFilterSchemaBuilder<TItem>
Fluent builder for an immutable DataFilterSchema`1.
_class · source: src/Omni.Blazor/Models/DataFilterSchema.cs_
- `DataFilterSchema<TItem> Build()` — Builds the immutable schema. A builder can be built only once.
- `DataFilterSchemaBuilder<TItem> ClearFields()` — Removes inherited fields while preserving safety limits.
- `DataFilterSchemaBuilder()`
- `DataFilterSchemaBuilder<TItem> Field<TValue>(Expression<Func<TItem, TValue>> selector, Action<DataFilterFieldBuilder<TItem, TValue>> configure)` — Adds a strongly typed filterable member.
- `DataFilterSchemaBuilder<TItem> Include(DataFilterSchema<TItem> schema)` — Includes fields and safety limits from an immutable schema.
- `DataFilterSchemaBuilder<TItem> Limits(int maximumDepth, int maximumRules)` — Bounds deserialized and programmatically built query trees.
- `DataFilterSchemaBuilder<TItem> OverrideField<TValue>(Expression<Func<TItem, TValue>> selector, Action<DataFilterFieldBuilder<TItem, TValue>> configure)` — Replaces an inherited field while preserving its selector position.

### DataFilterValue
Stable primitive representation used by serialized DataFilter conditions.
_class · source: src/Omni.Blazor/Models/DataFilterQuery.cs_
- `static DataFilterValue Custom(string text)` — Creates a value owned by a field-specific codec.
- `DataFilterValue(DataFilterValueKind kind, string text)` — Creates a serialized value.
- `static DataFilterValue From(object value)` — Converts one supported CLR primitive to its invariant representation.
- `DataFilterValueKind Kind` — Serialized primitive family.
- `DataFilterValue Null` — Canonical null value.
- `string Text` — Invariant text payload. Null only for Null.

### DataFilterValueKind
Supported stable serialized value families.
_enum · source: src/Omni.Blazor/Models/DataFilterQuery.cs_
- `Boolean` — Boolean.
- `Custom` — Payload owned by a field-specific codec.
- `DateOnly` — Date without time.
- `DateTime` — Date and time with DateTime semantics.
- `DateTimeOffset` — Date and time with offset.
- `Decimal` — Decimal number.
- `Double` — Single or double precision number.
- `Enum` — Enum member name.
- `Guid` — Guid.
- `Null` — Null.
- `SignedInteger` — Signed integral number.
- `String` — Unicode text or a character.
- `TimeOnly` — Time without date.
- `UnsignedInteger` — Unsigned integral number.

### DataGridColumnBuilder<TItem, TValue>
Strongly typed builder for one generated DataGrid column.
_class · source: src/Omni.Blazor/Models/DataGridSchema.cs_
- `DataGridColumnBuilder<TItem, TValue> Aggregate(AggregateFunction function, Func<TItem, decimal> selector, Func<object, string> format)` — Configures an aggregate and optional formatter.
- `DataGridColumnBuilder<TItem, TValue> EditTemplate(RenderFragment<TItem> template)` — Sets a typed inline edit template.
- `DataGridColumnBuilder<TItem, TValue> FilterOptions(IEnumerable<TValue> options)` — Configures select options for a filterable column.
- `DataGridColumnBuilder<TItem, TValue> Filterable(bool enabled, ColumnFilterType type, FilterOperator[] operators)` — Enables filtering with inferred or explicit editor type.
- `DataGridColumnBuilder<TItem, TValue> Format(string format, IFormatProvider provider)` — Formats values using the current culture.
- `DataGridColumnBuilder<TItem, TValue> Frozen(FrozenPosition position)` — Freezes the column at an edge.
- `DataGridColumnBuilder<TItem, TValue> Groupable(bool enabled, DateGroupInterval[] hierarchy)` — Enables grouping with an optional date hierarchy.
- `DataGridColumnBuilder<TItem, TValue> HierarchyAnchor(bool enabled)` — Marks this column as the hierarchy expansion anchor.
- `DataGridColumnBuilder<TItem, TValue> Resizable(bool enabled)` — Enables or disables resizing.
- `DataGridColumnBuilder<TItem, TValue> Sortable(bool enabled)` — Enables or disables sorting.
- `DataGridColumnBuilder<TItem, TValue> Template(RenderFragment<TItem> template)` — Sets a typed cell template.
- `DataGridColumnBuilder<TItem, TValue> Text(Func<TItem, string> selector)` — Sets an explicit display text selector.
- `DataGridColumnBuilder<TItem, TValue> Title(string value)` — Overrides the inferred title.
- `DataGridColumnBuilder<TItem, TValue> Visibility(bool visible, bool canHide)` — Sets visibility behavior.
- `DataGridColumnBuilder<TItem, TValue> Width(string value)` — Sets the CSS width.

### DataGridColumnDefinition<TItem>
Immutable runtime definition for one generated DataGrid column.
_class · source: src/Omni.Blazor/Models/DataGridSchema.cs_
- `AggregateFunction Aggregate` — Optional aggregate function.
- `Func<object, string> AggregateFormat` — Optional aggregate formatter.
- `Func<TItem, decimal> AggregateProperty` — Optional aggregate numeric selector.
- `bool CanHide` — Whether the column can be hidden.
- `RenderFragment<TItem> EditTemplate` — Optional inline edit template.
- `IReadOnlyList<FilterOperator> FilterOperators` — Optional allowed filter operators.
- `IReadOnlyList<object> FilterSelectOptions` — Optional select filter options.
- `ColumnFilterType FilterType` — Filter editor family.
- `bool Filterable` — Whether filtering is allowed.
- `FrozenPosition Frozen` — Optional frozen edge.
- `IReadOnlyList<DateGroupInterval> GroupHierarchy` — Optional date grouping hierarchy.
- `bool Groupable` — Whether grouping is allowed.
- `bool IsHierarchyAnchor` — Whether this is the hierarchy expander anchor.
- `Func<TItem, object> Property` — Compiled boxed value selector.
- `string PropertyName` — Stable member path used by sorting, filtering and persisted view state.
- `bool Resizable` — Whether resizing is allowed.
- `bool Sortable` — Whether sorting is allowed.
- `RenderFragment<TItem> Template` — Optional cell template.
- `Func<TItem, string> TextSelector` — Optional display text selector.
- `string Title` — Column header text.
- `bool Visible` — Initial visibility.
- `string Width` — CSS width.

### DataGridFormActionBuilder<TItem>
Builder for a custom row action.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormActionBuilder<TItem> Auto()` — Lets the actions-column overflow policy place the action.
- `DataGridFormActionBuilder<TItem> Confirm(Func<TItem, string> message)` — Requires confirmation using a message derived from the row.
- `DataGridFormActionBuilder<TItem> DisabledWhen(Func<TItem, bool> predicate)` — Disables the action when the predicate returns true.
- `DataGridFormActionBuilder<TItem> Display(string text, string icon)` — Overrides display text and icon.
- `DataGridFormActionBuilder<TItem> Id(string value)` — Sets the stable action id used by operation events and busy state.
- `DataGridFormActionBuilder<TItem> InMenu(bool enabled)` — Moves the action to the row overflow menu when enabled.
- `DataGridFormActionBuilder<TItem> KeepInline()` — Pins the action inline even when automatic overflow is enabled.
- `DataGridFormActionBuilder<TItem> MenuMetadata(string group, string shortcut, string description)` — Sets optional overflow-menu grouping, shortcut and description metadata.
- `DataGridFormActionBuilder<TItem> Order(int value)` — Sets deterministic display order among custom row actions.
- `DataGridFormActionBuilder<TItem> Placement(DataGridFormActionPlacement value)` — Sets whether the action is rendered inline or in the row overflow menu.
- `DataGridFormActionBuilder<TItem> Priority(int value)` — Sets automatic-overflow priority; larger values stay inline first.
- `DataGridFormActionBuilder<TItem> RequiresPolicy(string policy, DataGridFormUnauthorizedBehavior unauthorizedBehavior)` — Requires a named authorization policy before the action is exposed.
- `DataGridFormActionBuilder<TItem> Variant(ButtonVariant value)` — Sets the button visual variant.
- `DataGridFormActionBuilder<TItem> VisibleWhen(Func<TItem, bool> predicate)` — Shows the action only when the predicate returns true.

### DataGridFormActionsColumnBuilder
Fluent builder for the generated row-actions column.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormActionsColumnBuilder Frozen(FrozenPosition position)` — Freezes the column at the requested physical edge, or clears freezing with null.
- `DataGridFormActionsColumnBuilder FrozenLeft()` — Freezes the actions column at the left edge.
- `DataGridFormActionsColumnBuilder FrozenRight()` — Freezes the actions column at the right edge.
- `DataGridFormActionsColumnBuilder Menu(string text, string icon, string ariaLabel)` — Configures the overflow-menu trigger.
- `DataGridFormActionsColumnBuilder Overflow(DataGridFormActionOverflow value, int maximumInlineActions)` — Enables manual or priority-based automatic overflow.
- `DataGridFormActionsColumnBuilder ReorderActions(DataGridFormActionPlacement placement)` — Places generated move actions inline, in the menu, or under automatic overflow.
- `DataGridFormActionsColumnBuilder Resizable(bool enabled)` — Enables or disables the native DataGrid column resizer.
- `DataGridFormActionsColumnBuilder Width(string value)` — Sets the generated column CSS width.

### DataGridFormBulkActionBuilder<TItem>
Builder for a custom selected-item action.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormBulkActionBuilder<TItem> Auto()` — Lets the selected-item overflow policy place the action.
- `DataGridFormBulkActionBuilder<TItem> Confirm(Func<IReadOnlyList<TItem>, string> message)` — Requires confirmation using a message derived from the selected snapshot.
- `DataGridFormBulkActionBuilder<TItem> DisabledWhen(Func<IReadOnlyList<TItem>, bool> predicate)` — Disables the action when the selected snapshot is rejected.
- `DataGridFormBulkActionBuilder<TItem> Display(string text, string icon)` — Overrides display text and icon.
- `DataGridFormBulkActionBuilder<TItem> Id(string value)` — Sets the stable action id used by operation events and busy state.
- `DataGridFormBulkActionBuilder<TItem> InMenu(bool enabled)` — Moves the selected-item action to the overflow menu when enabled.
- `DataGridFormBulkActionBuilder<TItem> KeepInline()` — Pins the selected-item action inline.
- `DataGridFormBulkActionBuilder<TItem> MenuMetadata(string group, string shortcut, string description)` — Sets optional overflow-menu grouping, shortcut and description metadata.
- `DataGridFormBulkActionBuilder<TItem> Order(int value)` — Sets deterministic display order among selected-item actions.
- `DataGridFormBulkActionBuilder<TItem> Placement(DataGridFormActionPlacement value)` — Sets whether the selected-item action is inline, in-menu or automatic.
- `DataGridFormBulkActionBuilder<TItem> Priority(int value)` — Sets automatic-overflow priority; larger values stay inline first.
- `DataGridFormBulkActionBuilder<TItem> RequiresPolicy(string policy, DataGridFormUnauthorizedBehavior unauthorizedBehavior)` — Requires a named authorization policy before the action is exposed.
- `DataGridFormBulkActionBuilder<TItem> Variant(ButtonVariant value)` — Sets the button visual variant.
- `DataGridFormBulkActionBuilder<TItem> VisibleWhen(Func<IReadOnlyList<TItem>, bool> predicate)` — Shows the action only when the selected snapshot is accepted.

### DataGridFormBulkActionsBuilder
Fluent builder for selected-item action overflow.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormBulkActionsBuilder Menu(string text, string icon, string ariaLabel)` — Configures the selected-item overflow-menu trigger.
- `DataGridFormBulkActionsBuilder Overflow(DataGridFormActionOverflow value, int maximumInlineActions)` — Enables manual or priority-based automatic overflow.

### DataGridFormColumnBuilder<TItem, TValue>
Strongly typed options for one generated DataGrid column.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormColumnBuilder<TItem, TValue> Filterable(bool value, ColumnFilterType type)` — Enables filtering with an optional explicit filter family.
- `DataGridFormColumnBuilder<TItem, TValue> Groupable(bool value)` — Enables or disables grouping.
- `DataGridFormColumnBuilder<TItem, TValue> Resizable(bool value)` — Enables or disables resizing.
- `DataGridFormColumnBuilder<TItem, TValue> Sortable(bool value)` — Enables or disables sorting.
- `DataGridFormColumnBuilder<TItem, TValue> Template(RenderFragment<TItem> template)` — Sets a typed custom cell template.
- `DataGridFormColumnBuilder<TItem, TValue> Text(Func<TItem, string> selector)` — Sets a typed display-text selector.
- `DataGridFormColumnBuilder<TItem, TValue> Title(string value)` — Overrides the generated column title.
- `DataGridFormColumnBuilder<TItem, TValue> Visibility(bool visible, bool canHide)` — Controls the column visibility menu and initial visibility.
- `DataGridFormColumnBuilder<TItem, TValue> Width(string value)` — Sets the CSS column width.

### DataGridFormCreateBuilder<TItem>
Builder for the generated create workflow.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormCreateBuilder<TItem> Button(string text, string icon)` — Sets button text and icon.
- `DataGridFormCreateBuilder<TItem> DisabledWhen(Func<bool> policy)` — Disables creation when the policy returns true.
- `DataGridFormCreateBuilder<TItem> Factory(Func<TItem> factory)` — Sets the draft factory. Required.
- `DataGridFormCreateBuilder<TItem> Presentation(DataGridFormPresentation value, string width)` — Sets editor placement and width.
- `DataGridFormCreateBuilder<TItem> RequiresPolicy(string policy, DataGridFormUnauthorizedBehavior unauthorizedBehavior)` — Requires a named authorization policy before creation is exposed.
- `DataGridFormCreateBuilder<TItem> Title(string value)` — Sets the editor title.
- `DataGridFormCreateBuilder<TItem> VisibleWhen(Func<bool> policy)` — Shows creation only when the policy returns true.

### DataGridFormDeleteBuilder<TItem>
Builder for confirmed deletion.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormDeleteBuilder<TItem> Auto()` — Lets the actions-column overflow policy place the delete action.
- `DataGridFormDeleteBuilder<TItem> Button(string text, string icon)` — Sets button text and icon.
- `DataGridFormDeleteBuilder<TItem> Confirm(Func<TItem, string> message, Func<TItem, string> title)` — Sets confirmation message and optional title selectors.
- `DataGridFormDeleteBuilder<TItem> DisabledWhen(Func<TItem, bool> policy)` — Disables delete for rows accepted by the policy.
- `DataGridFormDeleteBuilder<TItem> InMenu(bool enabled)` — Moves the delete action to the row overflow menu when enabled.
- `DataGridFormDeleteBuilder<TItem> KeepInline()` — Pins the delete action inline even when automatic overflow is enabled.
- `DataGridFormDeleteBuilder<TItem> MenuMetadata(string group, string shortcut, string description)` — Sets optional overflow-menu grouping, shortcut and description metadata.
- `DataGridFormDeleteBuilder<TItem> Placement(DataGridFormActionPlacement value)` — Sets whether the delete action is rendered inline or in the row overflow menu.
- `DataGridFormDeleteBuilder<TItem> Priority(int value)` — Sets automatic-overflow priority; larger values stay inline first.
- `DataGridFormDeleteBuilder<TItem> RequiresPolicy(string policy, DataGridFormUnauthorizedBehavior unauthorizedBehavior)` — Requires a named authorization policy before deletion is exposed.
- `DataGridFormDeleteBuilder<TItem> Texts(string confirm, string cancel)` — Sets confirmation and cancellation button labels.
- `DataGridFormDeleteBuilder<TItem> VisibleWhen(Func<TItem, bool> policy)` — Shows delete only for rows accepted by the policy.

### DataGridFormEditBuilder<TItem>
Builder for safe copy-based editing.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormEditBuilder<TItem> Auto()` — Lets the actions-column overflow policy place the edit action.
- `DataGridFormEditBuilder<TItem> Button(string text, string icon)` — Sets button text and icon.
- `DataGridFormEditBuilder<TItem> Clone(Func<TItem, TItem> factory)` — Sets the required detached-draft factory used to make cancellation safe.
- `DataGridFormEditBuilder<TItem> DisabledWhen(Func<TItem, bool> policy)` — Disables edit for rows accepted by the policy.
- `DataGridFormEditBuilder<TItem> InMenu(bool enabled)` — Moves the edit action to the row overflow menu when enabled.
- `DataGridFormEditBuilder<TItem> KeepInline()` — Pins the edit action inline even when automatic overflow is enabled.
- `DataGridFormEditBuilder<TItem> MenuMetadata(string group, string shortcut, string description)` — Sets optional overflow-menu grouping, shortcut and description metadata.
- `DataGridFormEditBuilder<TItem> Placement(DataGridFormActionPlacement value)` — Sets whether the edit action is rendered inline or in the row overflow menu.
- `DataGridFormEditBuilder<TItem> Presentation(DataGridFormPresentation value, string width)` — Sets editor placement and width.
- `DataGridFormEditBuilder<TItem> Priority(int value)` — Sets automatic-overflow priority; larger values stay inline first.
- `DataGridFormEditBuilder<TItem> RequiresPolicy(string policy, DataGridFormUnauthorizedBehavior unauthorizedBehavior)` — Requires a named authorization policy before editing is exposed.
- `DataGridFormEditBuilder<TItem> Title(Func<TItem, string> selector)` — Sets a title derived from the selected item.
- `DataGridFormEditBuilder<TItem> VisibleWhen(Func<TItem, bool> policy)` — Shows edit only for rows accepted by the policy.

### DataGridFormGridBuilder<TItem>
Strongly typed DataGrid presentation builder.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormGridBuilder<TItem> AllowColumnFilter(bool enabled)` — Enables per-column filters.
- `DataGridFormGridBuilder<TItem> AllowColumnResize(bool enabled)` — Enables column resize.
- `DataGridFormGridBuilder<TItem> AllowColumnVisibility(bool enabled)` — Enables the column visibility menu.
- `DataGridFormGridBuilder<TItem> AllowExport(bool enabled)` — Enables bounded CSV export.
- `DataGridFormGridBuilder<TItem> AllowGrouping(bool enabled)` — Enables grouping for columns marked groupable.
- `DataGridFormGridBuilder<TItem> AllowPaging(bool enabled, int pageSize)` — Enables paging and sets its page size.
- `DataGridFormGridBuilder<TItem> AllowSearch(bool enabled)` — Shows or hides the grid search box. Default true.
- `DataGridFormGridBuilder<TItem> AllowSorting(bool enabled)` — Enables or disables sorting. Default true.
- `DataGridFormGridBuilder<TItem> AutoColumnsFromForm(bool enabled)` — Includes DataForm fields that were not explicitly configured as columns. Default true.
- `DataGridFormGridBuilder<TItem> Column<TValue>(Expression<Func<TItem, TValue>> property, Action<DataGridFormColumnBuilder<TItem, TValue>> configure)` — Adds or overrides one DataGrid column with a typed selector.
- `DataGridFormGridBuilder<TItem> Texts(string searchPlaceholder, string empty)` — Overrides search and empty-state text.
- `DataGridFormGridBuilder<TItem> Virtualize(string height, float rowHeight)` — Enables row virtualization with a fixed height.

### DataGridFormMutationResult<TItem>
Typed provider mutation result. Expected validation, authorization and optimistic concurrency outcomes do not need exceptions; unexpected failures may retain one.
_class · source: src/Omni.Blazor/Models/DataGridFormModels.cs_
- `static DataGridFormMutationResult<TItem> Conflict(TItem currentItem, string message)` — Creates an optimistic concurrency conflict with the latest item when available.
- `TItem CurrentItem` — Current server item supplied when optimistic concurrency detects a conflict.
- `static DataGridFormMutationResult<TItem> Deleted()` — Creates a successful delete result.
- `IReadOnlyList<string> Errors` — Domain validation messages. The collection is always non-null and immutable.
- `Exception Exception` — Observed unexpected exception, when one exists.
- `static DataGridFormMutationResult<TItem> Failure(string message, Exception exception)` — Creates an expected or unexpected persistence failure.
- `static DataGridFormMutationResult<TItem> Forbidden(string message)` — Creates an authorization failure.
- `TItem Item` — Authoritative persisted item for successful create or update operations.
- `string Message` — Human-readable summary safe to present to the user.
- `static DataGridFormMutationResult<TItem> NotFound(string message)` — Creates a not-found result.
- `DataGridFormMutationStatus Status` — Structured mutation outcome.
- `bool Succeeded` — Whether persistence completed successfully.
- `static DataGridFormMutationResult<TItem> Success(TItem item)` — Creates a successful create or update result with its authoritative item.
- `static DataGridFormMutationResult<TItem> ValidationFailed(IEnumerable<string> errors, string message)` — Creates a domain validation failure.

### DataGridFormMutationStatus
Outcome of a provider mutation, including expected domain and concurrency failures.
_enum · source: src/Omni.Blazor/Models/DataGridFormModels.cs_
- `Conflict` — The item changed after it was loaded and the submitted version is stale.
- `Failure` — An expected persistence failure occurred.
- `Forbidden` — The current user is not allowed to perform the operation.
- `NotFound` — The target item no longer exists.
- `RefreshFailed` — Persistence succeeded, but refreshing the grid failed.
- `Success` — The persistence operation completed successfully.
- `ValidationFailed` — The provider rejected one or more domain values.

### DataGridFormSchema<TItem, TKey>
Immutable CRUD composition schema shared by OmniDataGridForm instances. It reuses a DataFormSchema`1 for editors and owns only grid presentation and operation metadata.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `IReadOnlyList<DataGridFormAction<TItem, TKey>> Actions` — Additional strongly typed row actions.
- `DataGridFormActionsColumnOptions ActionsColumn` — Generated row-actions column presentation and overflow policy.
- `static DataGridFormSchemaBuilder<TItem, TKey> Builder()` — Creates a mutable builder for conditional schema construction.
- `IReadOnlyList<DataGridFormBulkAction<TItem, TKey>> BulkActions` — Additional strongly typed selected-item actions.
- `DataGridFormBulkActionsOptions BulkActionsBar` — Selected-item actions presentation and overflow policy.
- `static DataGridFormSchema<TItem, TKey> Create(Action<DataGridFormSchemaBuilder<TItem, TKey>> configure)` — Creates and builds an immutable CRUD schema.
- `DataGridFormCreateOptions<TItem> CreateOptions` — Create operation, or null when creation is disabled.
- `DataGridFormDeleteOptions<TItem> DeleteOptions` — Delete operation, or null when deletion is disabled.
- `DataGridFormEditOptions<TItem> EditOptions` — Edit operation, or null when editing is disabled.
- `DataGridFormSchema<TItem, TKey> Extend(Action<DataGridFormSchemaBuilder<TItem, TKey>> configure)` — Creates an immutable derived CRUD schema from this reusable base.
- `DataFormSchema<TItem> FormSchema` — DataForm schema used for create and edit drafts.
- `DataGridFormGridOptions<TItem> Grid` — Generated DataGrid columns and feature options.
- `Func<TItem, TKey> KeySelector` — Stable key selector used by row state and persistence.

### DataGridFormSchemaBuilder<TItem, TKey>
Strongly typed builder for a grid and DataForm CRUD composition.
_class · source: src/Omni.Blazor/Models/DataGridFormSchema.cs_
- `DataGridFormSchemaBuilder<TItem, TKey> Action(string text, string icon, Func<DataGridFormActionContext<TItem, TKey>, CancellationToken, ValueTask> execute, Action<DataGridFormActionBuilder<TItem>> configure)` — Adds an extra cancellable row action.
- `DataGridFormSchemaBuilder<TItem, TKey> ActionsColumn(Action<DataGridFormActionsColumnBuilder> configure)` — Configures the generated row-actions column and its overflow menu.
- `DataGridFormSchema<TItem, TKey> Build()` — Builds the immutable schema. A key selector is required.
- `DataGridFormSchemaBuilder<TItem, TKey> BulkAction(string text, string icon, Func<DataGridFormBulkActionContext<TItem, TKey>, CancellationToken, ValueTask> execute, Action<DataGridFormBulkActionBuilder<TItem>> configure)` — Adds a cancellable action for the current selected-item snapshot.
- `DataGridFormSchemaBuilder<TItem, TKey> BulkActions(Action<DataGridFormBulkActionsBuilder> configure)` — Configures selected-item action overflow and its menu trigger.
- `DataGridFormSchemaBuilder<TItem, TKey> Create(Action<DataGridFormCreateBuilder<TItem>> configure)` — Enables creation through a generated DataForm draft.
- `DataGridFormSchemaBuilder()` — Creates an empty CRUD schema builder.
- `DataGridFormSchemaBuilder<TItem, TKey> Delete(Action<DataGridFormDeleteBuilder<TItem>> configure)` — Enables confirmed deletion.
- `DataGridFormSchemaBuilder<TItem, TKey> Edit(Action<DataGridFormEditBuilder<TItem>> configure)` — Enables safe edit-through-copy through a generated DataForm draft.
- `DataGridFormSchemaBuilder<TItem, TKey> Form(DataFormSchema<TItem> schema)` — Sets the reusable DataForm schema used for create and edit drafts.
- `DataGridFormSchemaBuilder<TItem, TKey> Grid(Action<DataGridFormGridBuilder<TItem>> configure)` — Configures generated DataGrid columns and features.
- `DataGridFormSchemaBuilder<TItem, TKey> Grid(DataGridSchema<TItem> schema)` — Configures generated DataGrid columns and features.
- `DataGridFormSchemaBuilder<TItem, TKey> Include(DataGridFormSchema<TItem, TKey> schema)` — Includes form, grid and operation metadata from an immutable CRUD schema.
- `DataGridFormSchemaBuilder<TItem, TKey> Key(Expression<Func<TItem, TKey>> selector)` — Sets the stable key used by persistence and per-row operation state.
- `DataGridFormSchemaBuilder<TItem, TKey> RemoveAction(string id)` — Removes an inherited row action by stable id.
- `DataGridFormSchemaBuilder<TItem, TKey> RemoveBulkAction(string id)` — Removes an inherited selected-item action by stable id.

### DataGridHierarchyBuilder<TItem>
Fluent builder for bounded DataGrid hierarchy behavior.
_class · source: src/Omni.Blazor/Models/DataGridSchema.cs_
- `DataGridHierarchyBuilder<TItem> HasChildren(Func<TItem, bool> predicate)` — Sets an optional cheap child-existence predicate.
- `DataGridHierarchyBuilder<TItem> Indent(int pixels)` — Sets indentation in CSS pixels.
- `DataGridHierarchyBuilder<TItem> InitiallyExpanded(Func<TItem, bool> predicate)` — Sets an optional initial expansion predicate.
- `DataGridHierarchyBuilder<TItem> Limits(int maximumDepth, int maximumVisibleRows, int maximumChildrenPerNode, int maximumCachedNodes, int maximumCachedItems, int maximumConcurrentLoads)` — Sets hard safety bounds for traversal, caches and concurrent lazy loads.

### DataGridHierarchySchema<TItem>
Immutable hierarchy portion of a DataGrid schema.
_class · source: src/Omni.Blazor/Models/DataGridSchema.cs_
- `DataGridHierarchySchema<TItem> <Clone>$()`
- `Func<TItem, IEnumerable<TItem>> Children`
- `HierarchyChildrenProvider<TItem> ChildrenProvider`
- `DataGridHierarchySchema(Func<TItem, IEnumerable<TItem>> Children, Func<TItem, bool> HasChildren, HierarchyChildrenProvider<TItem> ChildrenProvider, Func<TItem, bool> InitiallyExpanded, int IndentSize, int MaxChildrenPerNode, int MaxCachedNodes, int MaxCachedItems, int MaxVisibleRows, int MaxDepth, int MaxConcurrentLoads)` — Immutable hierarchy portion of a DataGrid schema.
- `Void Deconstruct(Func`2& Children, Func`2& HasChildren, HierarchyChildrenProvider`1& ChildrenProvider, Func`2& InitiallyExpanded, Int32& IndentSize, Int32& MaxChildrenPerNode, Int32& MaxCachedNodes, Int32& MaxCachedItems, Int32& MaxVisibleRows, Int32& MaxDepth, Int32& MaxConcurrentLoads)`
- `bool Equals(DataGridHierarchySchema<TItem> other)`
- `bool Equals(object obj)`
- `int GetHashCode()`
- `Func<TItem, bool> HasChildren`
- `int IndentSize`
- `Func<TItem, bool> InitiallyExpanded`
- `int MaxCachedItems`
- `int MaxCachedNodes`
- `int MaxChildrenPerNode`
- `int MaxConcurrentLoads`
- `int MaxDepth`
- `int MaxVisibleRows`
- `string ToString()`

### DataGridSchema<TItem>
Immutable, strongly typed structural configuration for an OmniDataGrid.
_class · source: src/Omni.Blazor/Models/DataGridSchema.cs_
- `bool AllowColumnFilter` — Whether per-column filters are enabled.
- `bool AllowColumnResize` — Whether columns can be resized.
- `bool AllowColumnVisibility` — Whether column visibility can be customized.
- `bool AllowExport` — Whether bounded CSV export is enabled.
- `bool AllowGrouping` — Whether grouping is enabled.
- `bool AllowMultiSelection` — Whether multi-selection is enabled.
- `bool AllowPaging` — Whether paging is enabled.
- `bool AllowSearch` — Whether search is enabled.
- `bool AllowSorting` — Whether sorting is enabled.
- `static DataGridSchemaBuilder<TItem> Builder()` — Creates a mutable one-shot schema builder.
- `IReadOnlyList<DataGridColumnDefinition<TItem>> Columns` — Immutable generated column definitions.
- `static DataGridSchema<TItem> Create(Action<DataGridSchemaBuilder<TItem>> configure)` — Creates an immutable schema through a strongly typed builder.
- `string EmptyText` — Optional empty-state text.
- `DataGridSchema<TItem> Extend(Action<DataGridSchemaBuilder<TItem>> configure)` — Creates an immutable derived schema from this reusable base.
- `string Height` — Virtualized scroller height.
- `DataGridHierarchySchema<TItem> Hierarchy` — Optional bounded hierarchy configuration.
- `Func<TItem, object> KeySelector` — Stable item key used by hierarchy state.
- `int OverscanCount` — Virtualization overscan row count.
- `int PageSize` — Default page size.
- `float RowHeight` — Fixed virtualized row height.
- `string SearchPlaceholder` — Optional search placeholder.
- `bool Virtualize` — Whether row virtualization is enabled.

### DataGridSchemaBuilder<TItem>
Strongly typed one-shot builder for DataGrid structure and behavior defaults.
_class · source: src/Omni.Blazor/Models/DataGridSchema.cs_
- `DataGridSchema<TItem> Build()` — Builds the immutable schema.
- `DataGridSchemaBuilder<TItem> ClearColumns()` — Removes all generated columns so a derived schema can declare a new projection.
- `DataGridSchemaBuilder<TItem> ClearHierarchy()` — Removes inherited hierarchy behavior while preserving the stable key.
- `DataGridSchemaBuilder<TItem> Column<TValue>(Expression<Func<TItem, TValue>> property, Action<DataGridColumnBuilder<TItem, TValue>> configure)` — Adds a compile-time checked column.
- `DataGridSchemaBuilder<TItem> ColumnFilter(bool enabled)` — Enables or disables the per-column filter row.
- `DataGridSchemaBuilder<TItem> ColumnResize(bool enabled)` — Enables or disables column resizing.
- `DataGridSchemaBuilder<TItem> ColumnVisibility(bool enabled)` — Enables or disables the column visibility menu.
- `DataGridSchemaBuilder()`
- `DataGridSchemaBuilder<TItem> EmptyText(string text)` — Overrides empty-state text.
- `DataGridSchemaBuilder<TItem> Export(bool enabled)` — Enables or disables bounded CSV export.
- `DataGridSchemaBuilder<TItem> Grouping(bool enabled)` — Enables or disables row grouping.
- `DataGridSchemaBuilder<TItem> Hierarchy<TKey>(Expression<Func<TItem, TKey>> key, Func<TItem, IEnumerable<TItem>> children, Action<DataGridHierarchyBuilder<TItem>> configure)` — Enables an in-memory hierarchy with bounded flattening and caching defaults.
- `DataGridSchemaBuilder<TItem> Include(DataGridSchema<TItem> schema)` — Includes columns and defaults from an immutable schema.
- `DataGridSchemaBuilder<TItem> Key<TKey>(Expression<Func<TItem, TKey>> selector)` — Sets the stable key used by hierarchy and expansion state.
- `DataGridSchemaBuilder<TItem> LazyHierarchy<TKey>(Expression<Func<TItem, TKey>> key, HierarchyChildrenProvider<TItem> provider, Action<DataGridHierarchyBuilder<TItem>> configure)` — Enables a cancellable lazy hierarchy with bounded concurrency and caches.
- `DataGridSchemaBuilder<TItem> MultiSelection(bool enabled)` — Enables or disables multi-selection.
- `DataGridSchemaBuilder<TItem> OverrideColumn<TValue>(Expression<Func<TItem, TValue>> property, Action<DataGridColumnBuilder<TItem, TValue>> configure)` — Replaces a previously included or declared column while preserving its position.
- `DataGridSchemaBuilder<TItem> Paging(int pageSize, bool enabled)` — Enables paging and sets its bounded page size.
- `DataGridSchemaBuilder<TItem> Search(bool enabled, string placeholder)` — Enables or disables search.
- `DataGridSchemaBuilder<TItem> Sorting(bool enabled)` — Enables or disables sorting.
- `DataGridSchemaBuilder<TItem> Virtualization(string height, float rowHeight, int overscanCount)` — Enables fixed-row virtualization and disables paging.

### DataImportColumnBuilder<TItem, TValue>
Builder for one typed import target column.
_class · source: src/Omni.Blazor/Models/DataImportModels.cs_
- `DataImportColumnBuilder<TItem, TValue> Aliases(string[] values)` — Adds alternative source headers used by automatic mapping.
- `DataImportColumnBuilder<TItem, TValue> Header(string value)` — Sets the preferred source header.
- `DataImportColumnBuilder<TItem, TValue> Parse(DataImportTryParser<TValue> parser)` — Uses an allocation-free custom typed parser.
- `DataImportColumnBuilder<TItem, TValue> Required(string error)` — Requires a mapped non-blank source value.
- `DataImportColumnBuilder<TItem, TValue> Validate(Func<TValue, string> validator)` — Adds typed value validation after parsing.

### DataImportSchema<TItem>
Immutable typed tabular import schema.
_class · source: src/Omni.Blazor/Models/DataImportModels.cs_
- `static DataImportSchemaBuilder<TItem> Builder()` — Creates a mutable import schema builder.
- `int Count` — Number of typed target columns.
- `static DataImportSchema<TItem> Create(Action<DataImportSchemaBuilder<TItem>> configure)` — Creates and builds an immutable import schema.
- `char Delimiter` — Default delimited-text separator. Default comma.
- `bool HasHeader` — Whether the first row contains source headers. Default true.

### DataImportSchemaBuilder<TItem>
Strongly typed builder for bounded delimited-text imports.
_class · source: src/Omni.Blazor/Models/DataImportModels.cs_
- `DataImportSchema<TItem> Build()` — Builds the immutable import schema.
- `DataImportSchemaBuilder<TItem> Column<TValue>(Expression<Func<TItem, TValue>> property, Action<DataImportColumnBuilder<TItem, TValue>> configure)` — Adds one rename-safe writable target property.
- `DataImportSchemaBuilder()`
- `DataImportSchemaBuilder<TItem> Delimiter(char delimiter)` — Sets the default delimiter.
- `DataImportSchemaBuilder<TItem> Factory(Func<TItem> factory)` — Sets the item factory used only after one source row is read.
- `DataImportSchemaBuilder<TItem> HasHeader(bool value)` — Controls whether the first row is interpreted as a header. Default true.

### DelegateDataGridFormProvider<TItem, TKey>
Delegate adapter for applications that do not need a provider class.
_class · source: src/Omni.Blazor/Models/DataGridFormModels.cs_
- `ValueTask<DataGridFormMutationResult<TItem>> CreateAsync(TItem item, CancellationToken cancellationToken)`
- `DelegateDataGridFormProvider(GridDataProvider<TItem> load, Func<TItem, CancellationToken, ValueTask<DataGridFormMutationResult<TItem>>> create, Func<TKey, TItem, CancellationToken, ValueTask<DataGridFormMutationResult<TItem>>> update, Func<TKey, CancellationToken, ValueTask<DataGridFormMutationResult<TItem>>> delete)` — Creates a provider from four cancellable delegates.
- `DelegateDataGridFormProvider(GridDataProvider<TItem> load, Func<TItem, CancellationToken, ValueTask<TItem>> create, Func<TKey, TItem, CancellationToken, ValueTask<TItem>> update, Func<TKey, CancellationToken, ValueTask> delete)` — Creates a provider from four cancellable delegates.
- `ValueTask<DataGridFormMutationResult<TItem>> DeleteAsync(TKey key, CancellationToken cancellationToken)`
- `ValueTask<GridLoadResult<TItem>> LoadAsync(GridState<TItem> state, CancellationToken cancellationToken)`
- `ValueTask<DataGridFormMutationResult<TItem>> UpdateAsync(TKey key, TItem item, CancellationToken cancellationToken)`

### DiagramNodeBuilder
Builder for one diagram node and its output ports.
_class · source: src/Omni.Blazor/Models/DiagramSchema.cs_
- `DiagramNodeBuilder Appearance(string icon, string color)` — Sets the optional icon and accent color.
- `DiagramNodeBuilder Input(bool enabled)` — Controls whether the implicit input port is available.
- `DiagramNodeBuilder Output(string name, DiagramPortKind kind)` — Adds a named output port.
- `DiagramNodeBuilder Position(double x, double y)` — Sets the world-space position.
- `DiagramNodeBuilder Text(string title, string subtitle)` — Sets the primary and secondary labels.

### DiagramSchema
Immutable graph and canvas metadata for OmniDiagramCanvas.
_class · source: src/Omni.Blazor/Models/DiagramSchema.cs_
- `string AutoLayoutText` — Auto-layout action text.
- `static DiagramSchemaBuilder Builder()` — Creates a mutable one-shot diagram builder.
- `static DiagramSchema Create(Action<DiagramSchemaBuilder> configure)` — Creates an immutable diagram schema.
- `string DropPayloadFormat` — Accepted HTML drag payload format.
- `IReadOnlyList<DiagramEdge> Edges` — Immutable validated edge snapshot.
- `DiagramSchema Extend(Action<DiagramSchemaBuilder> configure)` — Creates an immutable derived schema from this reusable base.
- `bool FitOnMount` — Whether the graph is fitted once after mounting.
- `string FitText` — Fit-to-view action text.
- `IReadOnlyList<DiagramNode> Nodes` — Immutable node snapshot.
- `bool ReadOnly` — Whether graph editing is disabled.
- `bool ShowAutoLayout` — Whether the auto-layout control is visible.
- `bool ShowControls` — Whether viewport controls are visible.
- `bool ShowMinimap` — Whether the minimap is visible.
- `DiagramViewport Viewport` — Initial canvas viewport.
- `string ZoomInText` — Zoom-in action text.
- `string ZoomOutText` — Zoom-out action text.

### DiagramSchemaBuilder
Strongly typed one-shot builder for graph structure and canvas behavior.
_class · source: src/Omni.Blazor/Models/DiagramSchema.cs_
- `DiagramSchemaBuilder AutoLayout(double columnWidth, double rowHeight, double originX, double originY)` — Applies the built-in left-to-right layout once while building the schema.
- `DiagramSchemaBuilder Behavior(bool readOnly, bool fitOnMount, bool showMinimap, bool showControls, bool showAutoLayout, string dropPayloadFormat)` — Configures editing and canvas controls.
- `DiagramSchema Build()` — Builds and validates the immutable graph.
- `DiagramSchemaBuilder ClearGraph()` — Removes inherited graph structure while preserving canvas defaults.
- `DiagramSchemaBuilder Connect(string id, string source, string sourcePort, string target, string targetPort)` — Adds a directed edge and validates it when the schema is built.
- `DiagramSchemaBuilder()`
- `DiagramSchemaBuilder Include(DiagramSchema schema)` — Includes graph structure and canvas defaults from an immutable schema.
- `DiagramSchemaBuilder Labels(string autoLayout, string zoomIn, string zoomOut, string fit)` — Configures localized action labels.
- `DiagramSchemaBuilder Node(string id, Action<DiagramNodeBuilder> configure)` — Adds a graph node.
- `DiagramSchemaBuilder Node<TData>(string id, TData data, Action<DiagramNodeBuilder> configure)` — Adds a graph node.
- `DiagramSchemaBuilder OverrideConnection(string id, string source, string sourcePort, string target, string targetPort)` — Replaces an inherited edge while preserving its declaration position.
- `DiagramSchemaBuilder OverrideNode<TData>(string id, TData data, Action<DiagramNodeBuilder> configure)` — Replaces an inherited node while preserving its graph position.
- `DiagramSchemaBuilder Viewport(double x, double y, double zoom)` — Configures the initial viewport.

### GanttDependencySchema<TItem>
Immutable typed Gantt dependency metadata.
_class · source: src/Omni.Blazor/Models/GanttSchema.cs_
- `GanttDependencySchema<TItem> <Clone>$()`
- `Void Deconstruct(TItem& From, TItem& To, GanttDependencyType& Type)`
- `bool Equals(GanttDependencySchema<TItem> other)`
- `bool Equals(object obj)`
- `TItem From`
- `GanttDependencySchema(TItem From, TItem To, GanttDependencyType Type)` — Immutable typed Gantt dependency metadata.
- `int GetHashCode()`
- `TItem To`
- `string ToString()`
- `GanttDependencyType Type`

### GanttMarkerSchema
Immutable Gantt timeline marker metadata.
_class · source: src/Omni.Blazor/Models/GanttSchema.cs_
- `GanttMarkerSchema <Clone>$()`
- `string Color`
- `DateTime Date`
- `Void Deconstruct(DateTime& Date, String& Label, String& Color)`
- `bool Equals(GanttMarkerSchema other)`
- `bool Equals(object obj)`
- `GanttMarkerSchema(DateTime Date, string Label, string Color)` — Immutable Gantt timeline marker metadata.
- `int GetHashCode()`
- `string Label`
- `string ToString()`

### GanttSchema<TItem>
Immutable strongly typed task projection and presentation defaults for OmniGantt.
_class · source: src/Omni.Blazor/Models/GanttSchema.cs_
- `Func<TItem, DateTime> BaselineEnd` — Optional baseline end selector.
- `Func<TItem, DateTime> BaselineStart` — Optional baseline start selector.
- `static GanttSchemaBuilder<TItem> Builder()` — Creates a mutable one-shot builder.
- `static GanttSchema<TItem> Create(Action<GanttSchemaBuilder<TItem>> configure)` — Creates an immutable typed Gantt schema.
- `IReadOnlyList<GanttDependencySchema<TItem>> Dependencies` — Immutable typed task dependencies.
- `Func<TItem, DateTime> End` — Task end selector.
- `GanttSchema<TItem> Extend(Action<GanttSchemaBuilder<TItem>> configure)` — Creates an immutable derived schema from this reusable base.
- `Func<TItem, object> Key` — Optional stable task key selector.
- `string LeftPaneWidth` — Fallback left pane width.
- `IReadOnlyList<GanttMarkerSchema> Markers` — Immutable timeline markers.
- `IReadOnlyList<DayOfWeek> NonWorkingDays` — Immutable non-working weekdays.
- `Func<TItem, object> ParentKey` — Optional parent task key selector.
- `Func<TItem, double> Progress` — Optional progress selector in the zero-to-one-hundred range.
- `int RowHeight` — Task row height in pixels.
- `bool ShowCriticalPath` — Whether the critical path is highlighted.
- `bool ShowNavigation` — Whether navigation is shown.
- `bool ShowTodayLine` — Whether the current time line is shown.
- `bool ShowWeekends` — Whether non-working days are shaded.
- `Func<TItem, DateTime> Start` — Task start selector.
- `Func<TItem, string> Text` — Optional task label selector.
- `GanttZoomLevel ZoomLevel` — Default zoom level.

### GanttSchemaBuilder<TItem>
Strongly typed one-shot builder for Gantt task metadata.
_class · source: src/Omni.Blazor/Models/GanttSchema.cs_
- `GanttSchemaBuilder<TItem> Baseline(Expression<Func<TItem, DateTime>> start, Expression<Func<TItem, DateTime>> end)` — Maps optional baseline dates.
- `GanttSchema<TItem> Build()` — Builds the immutable schema.
- `GanttSchemaBuilder<TItem> Dependencies(IEnumerable<GanttDependency<TItem>> values)` — Sets a typed immutable dependency snapshot.
- `GanttSchemaBuilder()`
- `GanttSchemaBuilder<TItem> Hierarchy<TKey, TParentKey>(Expression<Func<TItem, TKey>> key, Expression<Func<TItem, TParentKey>> parentKey)` — Maps stable and optional parent keys using compile-time checked expressions.
- `GanttSchemaBuilder<TItem> Include(GanttSchema<TItem> schema)` — Includes task projection and presentation defaults from an immutable schema.
- `GanttSchemaBuilder<TItem> Key<TKey>(Expression<Func<TItem, TKey>> selector)` — Maps a stable key without enabling hierarchy.
- `GanttSchemaBuilder<TItem> Markers(IEnumerable<GanttMarker> values)` — Sets an immutable marker snapshot.
- `GanttSchemaBuilder<TItem> NonWorkingDays(DayOfWeek[] days)` — Sets immutable non-working weekdays.
- `GanttSchemaBuilder<TItem> Progress(Expression<Func<TItem, double>> selector)` — Maps task progress.
- `GanttSchemaBuilder<TItem> Task(Expression<Func<TItem, string>> text, Expression<Func<TItem, DateTime>> start, Expression<Func<TItem, DateTime>> end)` — Maps task label, start and end values.
- `GanttSchemaBuilder<TItem> Timeline(GanttZoomLevel zoom, int rowHeight, string leftPaneWidth, bool showNavigation, bool showTodayLine, bool showWeekends, bool showCriticalPath)` — Sets timeline presentation defaults.

### IDataGridFormProvider<TItem, TKey>
Cancellable CRUD source used by OmniDataGridForm. Implementations own persistence and authorization; the component owns interaction state and validation.
_interface · source: src/Omni.Blazor/Models/DataGridFormModels.cs_
- `ValueTask<DataGridFormMutationResult<TItem>> CreateAsync(TItem item, CancellationToken cancellationToken)` — Persists a new validated item and returns its structured outcome.
- `ValueTask<DataGridFormMutationResult<TItem>> DeleteAsync(TKey key, CancellationToken cancellationToken)` — Deletes one item by its stable key and returns its structured outcome.
- `ValueTask<GridLoadResult<TItem>> LoadAsync(GridState<TItem> state, CancellationToken cancellationToken)` — Loads one grid window using the DataGrid server-side state.
- `ValueTask<DataGridFormMutationResult<TItem>> UpdateAsync(TKey key, TItem item, CancellationToken cancellationToken)` — Persists a validated edit and returns its structured outcome.

### KanbanCardBuilder<TCard>
Strongly typed builder for the default Kanban card.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanCardBuilder<TCard> Actions(Func<TCard, IEnumerable<KanbanCardAction>> selector)` — Maps card overflow actions.
- `KanbanCardBuilder<TCard> Age(Expression<Func<TCard, int>> selector, int warningDays, int staleDays)` — Maps card age and warning thresholds.
- `KanbanCardBuilder<TCard> Assignee(Expression<Func<TCard, string>> selector, Expression<Func<TCard, string>> avatar)` — Maps assignee and optional avatar URL.
- `KanbanCardBuilder<TCard> Color(Expression<Func<TCard, string>> selector)` — Maps a CSS accent color.
- `KanbanCardBuilder<TCard> DueDate(Expression<Func<TCard, DateTime>> selector)` — Maps a due date.
- `KanbanCardBuilder<TCard> Estimate(Expression<Func<TCard, string>> selector)` — Maps an estimate label.
- `KanbanCardBuilder<TCard> Fields(Func<TCard, IEnumerable<KanbanField>> selector)` — Maps extra card fields.
- `KanbanCardBuilder<TCard> Priority(Expression<Func<TCard, KanbanPriority>> selector)` — Maps card priority.
- `KanbanCardBuilder<TCard> Subtasks(Func<TCard, ValueTuple<int, int>> selector)` — Maps subtask progress.
- `KanbanCardBuilder<TCard> Title(Expression<Func<TCard, string>> selector)` — Maps the primary card title.

### KanbanCardSchema<TCard>
Immutable typed card presentation selectors.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanCardSchema<TCard> <Clone>$()`
- `Func<TCard, IEnumerable<KanbanCardAction>> Actions`
- `Func<TCard, int> Age`
- `int AgeStaleDays`
- `int AgeWarnDays`
- `Func<TCard, string> Assignee`
- `Func<TCard, string> Avatar`
- `Func<TCard, string> Color`
- `Void Deconstruct(Func`2& Title, Func`2& Assignee, Func`2& Avatar, Func`2& DueDate, Func`2& Priority, Func`2& Subtasks, Func`2& Estimate, Func`2& Fields, Func`2& Color, Func`2& Age, Func`2& Actions, Boolean& ShowAge, Int32& AgeWarnDays, Int32& AgeStaleDays)`
- `Func<TCard, DateTime> DueDate`
- `bool Equals(KanbanCardSchema<TCard> other)`
- `bool Equals(object obj)`
- `Func<TCard, string> Estimate`
- `Func<TCard, IEnumerable<KanbanField>> Fields`
- `int GetHashCode()`
- `KanbanCardSchema(Func<TCard, string> Title, Func<TCard, string> Assignee, Func<TCard, string> Avatar, Func<TCard, DateTime> DueDate, Func<TCard, KanbanPriority> Priority, Func<TCard, ValueTuple<int, int>> Subtasks, Func<TCard, string> Estimate, Func<TCard, IEnumerable<KanbanField>> Fields, Func<TCard, string> Color, Func<TCard, int> Age, Func<TCard, IEnumerable<KanbanCardAction>> Actions, bool ShowAge, int AgeWarnDays, int AgeStaleDays)` — Immutable typed card presentation selectors.
- `Func<TCard, KanbanPriority> Priority`
- `bool ShowAge`
- `Func<TCard, ValueTuple<int, int>> Subtasks`
- `Func<TCard, string> Title`
- `string ToString()`

### KanbanColumnBuilder
Fluent builder for one Kanban column.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanColumnBuilder Appearance(string icon, CardTone tone)` — Sets header icon and tone.
- `KanbanColumnBuilder State(int wipLimit, bool collapsed)` — Sets an optional WIP limit and initial collapsed state.

### KanbanColumnSchema
Immutable Kanban column metadata.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanColumnSchema <Clone>$()`
- `bool Collapsed`
- `Void Deconstruct(String& Id, String& Title, String& Icon, CardTone& Tone, Nullable`1& WipLimit, Boolean& Collapsed)`
- `bool Equals(KanbanColumnSchema other)`
- `bool Equals(object obj)`
- `int GetHashCode()`
- `string Icon`
- `string Id`
- `KanbanColumnSchema(string Id, string Title, string Icon, CardTone Tone, int WipLimit, bool Collapsed)` — Immutable Kanban column metadata.
- `string Title`
- `string ToString()`
- `CardTone Tone`
- `int WipLimit`

### KanbanQuickFilterSchema<TCard>
Immutable typed Kanban quick-filter metadata.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanQuickFilterSchema<TCard> <Clone>$()`
- `Void Deconstruct(String& Label, Func`2& Predicate, String& Icon)`
- `bool Equals(KanbanQuickFilterSchema<TCard> other)`
- `bool Equals(object obj)`
- `int GetHashCode()`
- `string Icon`
- `KanbanQuickFilterSchema(string Label, Func<TCard, bool> Predicate, string Icon)` — Immutable typed Kanban quick-filter metadata.
- `string Label`
- `Func<TCard, bool> Predicate`
- `string ToString()`

### KanbanSchema<TCard>
Immutable strongly typed board, card and workflow metadata for OmniKanban.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `bool AllowAddCard` — Whether add-card actions are shown.
- `bool AllowColumnReorder` — Whether columns can be reordered.
- `static KanbanSchemaBuilder<TCard> Builder()` — Creates a mutable one-shot builder.
- `KanbanCardSchema<TCard> Card` — Typed card presentation selectors.
- `Func<TCard, object> CardId` — Optional stable card key selector.
- `bool Collapsible` — Whether columns can be collapsed.
- `Func<TCard, string> ColumnSelector` — Compiled card-to-column selector.
- `Action<TCard, string> ColumnSetter` — Optional card column mutation delegate.
- `string ColumnWidth` — Optional CSS column width.
- `IReadOnlyList<KanbanColumnSchema> Columns` — Immutable board column snapshot.
- `static KanbanSchema<TCard> Create(Action<KanbanSchemaBuilder<TCard>> configure)` — Creates an immutable typed Kanban schema.
- `bool DragDisabled` — Whether card movement is disabled.
- `KanbanSchema<TCard> Extend(Action<KanbanSchemaBuilder<TCard>> configure)` — Creates an immutable derived schema from this reusable base.
- `IReadOnlyList<KanbanQuickFilterSchema<TCard>> QuickFilters` — Immutable quick-filter snapshot.
- `Func<TCard, string> SearchSelector` — Optional searchable text selector.
- `bool ShowCount` — Whether card counts are shown.
- `bool ShowSearch` — Whether board search is shown.
- `Func<TCard, string> SwimlaneSelector` — Optional card-to-swimlane selector.
- `Action<TCard, string> SwimlaneSetter` — Optional card swimlane mutation delegate.
- `IReadOnlyList<KanbanSwimlaneSchema> Swimlanes` — Immutable swimlane snapshot.
- `bool SwimlanesCollapsible` — Whether swimlanes can be collapsed.
- `WipLimitMode WipLimitMode` — How WIP limits are enforced.

### KanbanSchemaBuilder<TCard>
Strongly typed one-shot builder for Kanban workflow and presentation metadata.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanSchemaBuilder<TCard> Behavior(bool showCount, bool collapsible, bool swimlanesCollapsible, bool allowAddCard, bool allowColumnReorder, bool dragDisabled, WipLimitMode wipLimitMode, string columnWidth)` — Configures board behavior defaults.
- `KanbanSchema<TCard> Build()` — Builds the immutable schema.
- `KanbanSchemaBuilder<TCard> Card(Action<KanbanCardBuilder<TCard>> configure)` — Configures typed default-card selectors.
- `KanbanSchemaBuilder<TCard> ClearColumns()` — Removes inherited columns so a derived schema can declare a new workflow.
- `KanbanSchemaBuilder<TCard> ClearQuickFilters()` — Removes inherited quick filters.
- `KanbanSchemaBuilder<TCard> ClearSwimlanes()` — Removes inherited swimlanes.
- `KanbanSchemaBuilder<TCard> Column(string id, string title, Action<KanbanColumnBuilder> configure)` — Adds one immutable board column.
- `KanbanSchemaBuilder<TCard> ColumnState(Expression<Func<TCard, string>> selector, Action<TCard, string> setter)` — Maps card column state and its optional mutation delegate.
- `KanbanSchemaBuilder<TCard> Include(KanbanSchema<TCard> schema)` — Includes workflow, card and presentation defaults from an immutable schema.
- `KanbanSchemaBuilder()` — Creates an empty builder.
- `KanbanSchemaBuilder<TCard> Key<TKey>(Expression<Func<TCard, TKey>> selector)` — Sets a stable card key.
- `KanbanSchemaBuilder<TCard> OverrideColumn(string id, string title, Action<KanbanColumnBuilder> configure)` — Replaces an inherited column while preserving its board position.
- `KanbanSchemaBuilder<TCard> QuickFilter(string label, Func<TCard, bool> predicate, string icon)` — Adds a typed quick filter.
- `KanbanSchemaBuilder<TCard> Search(Expression<Func<TCard, string>> selector, bool enabled)` — Enables board search with a typed text selector.
- `KanbanSchemaBuilder<TCard> Swimlane(string id, string title, string icon, bool collapsed)` — Adds one immutable swimlane.
- `KanbanSchemaBuilder<TCard> SwimlaneState(Expression<Func<TCard, string>> selector, Action<TCard, string> setter)` — Maps optional swimlane state and its mutation delegate.

### KanbanSwimlaneSchema
Immutable Kanban swimlane metadata.
_class · source: src/Omni.Blazor/Models/KanbanSchema.cs_
- `KanbanSwimlaneSchema <Clone>$()`
- `bool Collapsed`
- `Void Deconstruct(String& Id, String& Title, String& Icon, Boolean& Collapsed)`
- `bool Equals(KanbanSwimlaneSchema other)`
- `bool Equals(object obj)`
- `int GetHashCode()`
- `string Icon`
- `string Id`
- `KanbanSwimlaneSchema(string Id, string Title, string Icon, bool Collapsed)` — Immutable Kanban swimlane metadata.
- `string Title`
- `string ToString()`

### SchedulerSchema<TItem>
Immutable strongly typed appointment projection and presentation defaults for OmniScheduler.
_class · source: src/Omni.Blazor/Models/SchedulerSchema.cs_
- `static SchedulerSchemaBuilder<TItem> Builder()` — Creates a mutable one-shot builder.
- `static SchedulerSchema<TItem> Create(Action<SchedulerSchemaBuilder<TItem>> configure)` — Creates an immutable scheduler schema.
- `CultureInfo Culture` — Optional formatting culture.
- `Func<TItem, DateTime> End` — Compiled appointment end selector.
- `SchedulerSchema<TItem> Extend(Action<SchedulerSchemaBuilder<TItem>> configure)` — Creates an immutable derived schema from this reusable base.
- `string Height` — Scheduler CSS height.
- `int SelectedViewIndex` — Initial selected scheduler view index.
- `bool ShowDateTitle` — Whether the current range title is shown.
- `bool ShowHeader` — Whether the complete header is shown.
- `bool ShowNavigationButtons` — Whether previous and next actions are shown.
- `bool ShowTodayButton` — Whether the today action is shown.
- `Func<TItem, DateTime> Start` — Compiled appointment start selector.
- `Func<TItem, string> Text` — Optional compiled appointment label selector.

### SchedulerSchemaBuilder<TItem>
Strongly typed one-shot builder for Scheduler appointment metadata.
_class · source: src/Omni.Blazor/Models/SchedulerSchema.cs_
- `SchedulerSchema<TItem> Build()` — Builds the immutable schema.
- `SchedulerSchemaBuilder<TItem> Culture(CultureInfo value)` — Sets the scheduler formatting culture.
- `SchedulerSchemaBuilder<TItem> Header(bool visible, bool navigationButtons, bool todayButton, bool dateTitle)` — Configures header visibility.
- `SchedulerSchemaBuilder<TItem> Height(string value)` — Sets the scheduler CSS height.
- `SchedulerSchemaBuilder<TItem> Include(SchedulerSchema<TItem> schema)` — Includes projection and presentation defaults from an immutable schema.
- `SchedulerSchemaBuilder<TItem> Range(Expression<Func<TItem, DateTime>> start, Expression<Func<TItem, DateTime>> end)` — Maps the appointment start and end using compile-time checked expressions.
- `SchedulerSchemaBuilder()`
- `SchedulerSchemaBuilder<TItem> SelectedView(int index)` — Sets the initial selected view index.
- `SchedulerSchemaBuilder<TItem> Text(Expression<Func<TItem, string>> selector)` — Maps the appointment display text.

### ChartDataPointSchema
Immutable point metadata produced by a typed chart schema.
_class · source: src/Omni.Blazor/Models/ChartSchema.cs_
- `ChartDataPointSchema <Clone>$()`
- `string Category`
- `ChartDataPointSchema(string Category, double Value, string Color, bool IsTotal, double X, double Size)` — Immutable point metadata produced by a typed chart schema.
- `string Color`
- `Void Deconstruct(String& Category, Double& Value, String& Color, Boolean& IsTotal, Nullable`1& X, Nullable`1& Size)`
- `bool Equals(ChartDataPointSchema other)`
- `bool Equals(object obj)`
- `int GetHashCode()`
- `bool IsTotal`
- `double Size`
- `string ToString()`
- `double Value`
- `double X`

### ChartSchema
Immutable chart data and presentation metadata for OmniChart.
_class · source: src/Omni.Blazor/Models/ChartSchema.cs_
- `string AriaLabel` — Optional accessible SVG label.
- `static ChartSchemaBuilder Builder()` — Creates a mutable one-shot chart builder.
- `ChartColorScheme ColorScheme` — Fallback color scheme.
- `static ChartSchema Create(Action<ChartSchemaBuilder> configure)` — Creates an immutable chart schema.
- `string DonutCenterLabel` — Optional donut center label.
- `string DonutCenterValue` — Optional donut center value.
- `ChartSchema Extend(Action<ChartSchemaBuilder> configure)` — Creates an immutable derived schema from this reusable base.
- `string Height` — Chart CSS height.
- `ChartLegendPosition LegendPosition` — Legend position.
- `IReadOnlyList<ChartSeriesSchema> Series` — Immutable series snapshot.
- `bool ShowGrid` — Whether horizontal grid lines are visible.
- `string Title` — Optional accessible chart title.
- `Func<double, string> ValueFormatter` — Optional value-axis formatter.
- `int ValueTicks` — Requested value-axis tick count.
- `string Width` — Chart CSS width.

### ChartSchemaBuilder
Strongly typed one-shot builder for chart series and presentation metadata.
_class · source: src/Omni.Blazor/Models/ChartSchema.cs_
- `ChartSchemaBuilder Appearance(ChartColorScheme colorScheme, ChartLegendPosition legendPosition, bool showGrid)` — Configures legend, colors and grid visibility.
- `ChartSchema Build()` — Builds the immutable schema and seals this builder.
- `ChartSchemaBuilder()`
- `ChartSchemaBuilder ClearSeries()` — Removes inherited series so a derived schema can declare a new dataset.
- `ChartSchemaBuilder DonutCenter(string label, string value)` — Configures donut center content.
- `ChartSchemaBuilder Include(ChartSchema schema)` — Includes series and presentation defaults from an immutable schema.
- `ChartSchemaBuilder Labels(string title, string ariaLabel, Func<double, string> valueFormatter, int valueTicks)` — Configures title, accessibility and axis formatting.
- `ChartSchemaBuilder OverrideSeries<TItem>(string title, IEnumerable<TItem> items, Expression<Func<TItem, string>> category, Expression<Func<TItem, double>> value, Action<ChartSeriesBuilder<TItem>> configure)` — Replaces an inherited series while preserving its legend position.
- `ChartSchemaBuilder Series(string title, IEnumerable<ChartDataPoint> points, Action<ChartSeriesBuilder<ChartDataPoint>> configure)` — Adds a series from an immutable snapshot of existing chart points.
- `ChartSchemaBuilder Series<TItem>(string title, IEnumerable<TItem> items, Expression<Func<TItem, string>> category, Expression<Func<TItem, double>> value, Action<ChartSeriesBuilder<TItem>> configure)` — Adds a series from an immutable snapshot of existing chart points.
- `ChartSchemaBuilder Size(string height, string width)` — Configures chart dimensions.

### ChartSeriesBuilder<TItem>
Strongly typed builder for one chart series.
_class · source: src/Omni.Blazor/Models/ChartSchema.cs_
- `ChartSeriesBuilder<TItem> BubbleSize(Expression<Func<TItem, double>> selector)` — Maps the relative size used by Bubble series.
- `ChartSeriesBuilder<TItem> Color(string color)` — Sets an optional CSS series color.
- `ChartSeriesBuilder<TItem> GaugeRange(double minimum, double maximum)` — Configures the accepted Gauge range.
- `ChartSeriesBuilder<TItem> Line(ChartInterpolation interpolation, double strokeWidth, bool showMarkers, double areaOpacity)` — Configures line or area rendering.
- `ChartSeriesBuilder<TItem> PointColor(Expression<Func<TItem, string>> selector)` — Maps an optional color for each point.
- `ChartSeriesBuilder<TItem> TotalWhen(Expression<Func<TItem, bool>> predicate)` — Maps waterfall total points.
- `ChartSeriesBuilder<TItem> Type(ChartSeriesType type)` — Sets the visual series type.
- `ChartSeriesBuilder<TItem> X(Expression<Func<TItem, double>> selector)` — Maps the numeric X coordinate used by Scatter and Bubble series.

### ChartSeriesSchema
Immutable series metadata produced by a typed chart schema.
_class · source: src/Omni.Blazor/Models/ChartSchema.cs_
- `double AreaOpacity` — Area fill opacity.
- `string Color` — Optional CSS color override.
- `double GaugeMaximum` — Maximum Gauge value.
- `double GaugeMinimum` — Minimum Gauge value.
- `ChartInterpolation Interpolation` — Line interpolation mode.
- `IReadOnlyList<ChartDataPointSchema> Points` — Immutable point snapshot.
- `bool ShowMarkers` — Whether point markers are visible.
- `double StrokeWidth` — Line stroke width in SVG pixels.
- `string Title` — Legend and tooltip title.
- `ChartSeriesType Type` — Visual series type.

### DataFormCollectionEditorBuilder<TModel, TCollection, TItem>
Strongly typed configuration for a bounded editable collection field.
_class · source: src/Omni.Blazor/Models/DataFormCollectionModels.cs_
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Bounds(int minimum, int maximum, string minimumError, string maximumError)` — Sets inclusive item-count bounds. Maximum is capped at 1,000.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> CreateCollection(Func<TCollection> factory)` — Creates a collection when the bound property is initially null.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> CreateItem(Func<TItem> factory)` — Enables adding items through a factory.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Grid<TKey>(DataGridFormSchema<TItem, TKey> schema)` — Renders the collection through OmniDataGridForm. The supplied CRUD schema owns columns, draft creation/editing, deletion and extra actions. Collection bounds, collection creation and reorder settings remain owned by this builder. Do not combine Grid with ItemSchema, CreateItem, Key, custom collection action texts or an item-header template.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> ItemSchema(DataFormSchema<TItem> schema)` — Sets the nested schema rendered for every item.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Key(Func<TItem, object> selector)` — Sets a stable item key. Object identity is used by default.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Removable(bool value)` — Allows or prevents removing items.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Reorderable(bool value)` — Shows keyboard-accessible move-up and move-down actions.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Templates(RenderFragment empty, RenderFragment<DataFormCollectionItemContext<TItem>> itemHeader)` — Sets custom empty-state and item-heading templates.
- `DataFormCollectionEditorBuilder<TModel, TCollection, TItem> Texts(string add, string remove, string moveUp, string moveDown)` — Sets localized collection action text.

### DataFormConventionBuilder<TModel>
Fluent defaults applied to fields selected by a type or attribute convention. Explicit field metadata always has precedence.
_class · source: src/Omni.Blazor/Models/DataFormSchemaComposition.cs_
- `DataFormConventionBuilder<TModel> Disabled(bool value)` — Disables matching fields by default.
- `DataFormConventionBuilder<TModel> Hint(string value)` — Sets the default helper text.
- `DataFormConventionBuilder<TModel> Label(Func<PropertyInfo, string> value)` — Sets a fixed label.
- `DataFormConventionBuilder<TModel> Label(string value)` — Sets a fixed label.
- `DataFormConventionBuilder<TModel> Order(int value)` — Sets the default display order.
- `DataFormConventionBuilder<TModel> Placeholder(string value)` — Sets the default placeholder.
- `DataFormConventionBuilder<TModel> ReadOnly(bool value)` — Makes matching fields read-only by default.
- `DataFormConventionBuilder<TModel> Required(string error)` — Marks matching fields as required by default.
- `DataFormConventionBuilder<TModel> Span(int value)` — Sets the default grid span.
- `DataFormConventionBuilder<TModel> Visible(bool value)` — Sets default field visibility.

### DataFormDateEditorBuilder
Typed options shared by date and time editors.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormDateEditorBuilder Clearable(bool value)` — Shows or hides the clear action.
- `DataFormDateEditorBuilder DisableWeekends(bool value)` — Enables or disables weekend dates.
- `DataFormDateEditorBuilder Format(string value)` — Sets the displayed date format.
- `DataFormDateEditorBuilder Max(DateOnly value)` — Sets the maximum selectable date.
- `DataFormDateEditorBuilder Min(DateOnly value)` — Sets the minimum selectable date.

### DataFormFieldBuilder<TModel, TValue>
Strongly typed fluent configuration for one DataForm property. Editor-specific methods expose only typed values instead of parameter-name dictionaries.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormFieldBuilder<TModel, TValue> Auto()` — Preserves editor inference from the property and its annotations.
- `DataFormFieldBuilder<TModel, TValue> CheckBox()` — Uses a boolean checkbox editor.
- `DataFormFieldBuilder<TModel, TValue> Class(string value)` — Appends a CSS class to the field wrapper.
- `DataFormFieldBuilder<TModel, TValue> Collection<TItem>(Action<DataFormCollectionEditorBuilder<TModel, TValue, TItem>> configure)` — Uses a bounded collection editor with nested item schemas.
- `DataFormFieldBuilder<TModel, TValue> Date(Action<DataFormDateEditorBuilder> configure)` — Uses a date-only editor.
- `DataFormFieldBuilder<TModel, TValue> DateTime(Action<DataFormDateEditorBuilder> configure)` — Uses a date-and-time editor.
- `DataFormFieldBuilder<TModel, TValue> Disabled(bool value)` — Disables the editor.
- `DataFormFieldBuilder<TModel, TValue> Email(Action<DataFormTextEditorBuilder> configure)` — Uses an e-mail text editor.
- `DataFormFieldBuilder<TModel, TValue> EnabledWhen(Func<TModel, bool> predicate)` — Enables the editor only while the model predicate returns true.
- `DataFormFieldBuilder<TModel, TValue> Hint(string value)` — Overrides the inferred helper text.
- `DataFormFieldBuilder<TModel, TValue> HintRight(string value)` — Sets text displayed on the right side of the label.
- `DataFormFieldBuilder<TModel, TValue> Label(string value)` — Overrides the inferred field label.
- `DataFormFieldBuilder<TModel, TValue> Numeric(Action<DataFormNumericEditorBuilder> configure)` — Uses a culture-aware numeric editor.
- `DataFormFieldBuilder<TModel, TValue> Order(int value)` — Overrides the inferred field order.
- `DataFormFieldBuilder<TModel, TValue> Password(Action<DataFormPasswordEditorBuilder> configure)` — Uses a password editor.
- `DataFormFieldBuilder<TModel, TValue> Placeholder(string value)` — Overrides the inferred editor placeholder.
- `DataFormFieldBuilder<TModel, TValue> ReadOnly(bool value)` — Makes the editor read-only.
- `DataFormFieldBuilder<TModel, TValue> ReadOnlyWhen(Func<TModel, bool> predicate)` — Makes the editor read-only while the model predicate returns true.
- `DataFormFieldBuilder<TModel, TValue> Required(string error)` — Marks the field required and enables required-value validation.
- `DataFormFieldBuilder<TModel, TValue> RequiredWhen(Func<TModel, bool> predicate, string error)` — Makes the field required while the model predicate returns true.
- `DataFormFieldBuilder<TModel, TValue> Select(Action<DataFormSelectEditorBuilder<TValue>> configure)` — Uses a single-choice editor with optional strongly typed options.
- `DataFormFieldBuilder<TModel, TValue> Select<TItem>(Func<TItem, TValue> valueSelector, Func<TItem, string> textSelector, Action<DataFormLookupEditorBuilder<TModel, TItem, TValue>> configure)` — Uses a single-choice editor with optional strongly typed options.
- `DataFormFieldBuilder<TModel, TValue> Span(Breakpoint breakpoint, int columns)` — Sets the number of grid columns occupied by the field.
- `DataFormFieldBuilder<TModel, TValue> Span(int columns)` — Sets the number of grid columns occupied by the field.
- `DataFormFieldBuilder<TModel, TValue> Style(string value)` — Appends inline styles to the field wrapper.
- `DataFormFieldBuilder<TModel, TValue> Switch()` — Uses a boolean switch editor.
- `DataFormFieldBuilder<TModel, TValue> Telephone(Action<DataFormTextEditorBuilder> configure)` — Uses a telephone text editor.
- `DataFormFieldBuilder<TModel, TValue> Template(RenderFragment<DataFormFieldContext<TModel, TValue>> content)` — Replaces the inferred editor with a strongly typed custom template while preserving the EditContext, ValueExpression and DataForm change pipeline.
- `DataFormFieldBuilder<TModel, TValue> Text(Action<DataFormTextEditorBuilder> configure)` — Uses a single-line text editor.
- `DataFormFieldBuilder<TModel, TValue> TextArea(Action<DataFormTextAreaEditorBuilder> configure)` — Uses a multi-line text editor.
- `DataFormFieldBuilder<TModel, TValue> Time(Action<DataFormDateEditorBuilder> configure)` — Uses a time-only editor.
- `DataFormFieldBuilder<TModel, TValue> Url(Action<DataFormTextEditorBuilder> configure)` — Uses a URL text editor.
- `DataFormFieldBuilder<TModel, TValue> Validate(Func<TValue, TModel, string> validator)` — Adds a strongly typed synchronous field validator.
- `DataFormFieldBuilder<TModel, TValue> ValidateAsync(Func<TValue, TModel, CancellationToken, ValueTask<string>> validator)` — Adds a strongly typed cancellable asynchronous field validator.
- `DataFormFieldBuilder<TModel, TValue> Visible(bool value)` — Sets static field visibility.
- `DataFormFieldBuilder<TModel, TValue> VisibleWhen(Func<TModel, bool> predicate)` — Shows the field only when the model predicate returns true.

### DataFormGroupBuilder<TModel>
Fluent builder for a semantic and responsive DataForm group.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormGroupBuilder<TModel> Description(string value)` — Sets descriptive text below the group legend.
- `DataFormGroupBuilder<TModel> Field<TValue>(Expression<Func<TModel, TValue>> property, Action<DataFormFieldBuilder<TModel, TValue>> configure)` — Adds a strongly typed field to this group.
- `DataFormGroupBuilder<TModel> Group(string title, Action<DataFormGroupBuilder<TModel>> configure)` — Adds a nested semantic group.
- `DataFormGroupBuilder<TModel> Id(string value)` — Overrides the stable group identity.
- `DataFormGroupBuilder<TModel> Layout(Action<DataFormLayoutBuilder> configure)` — Configures the group's own responsive grid.
- `DataFormGroupBuilder<TModel> Order(int value)` — Sets the display order among sibling schema nodes.
- `DataFormGroupBuilder<TModel> Visible(bool value)` — Sets static group visibility.
- `DataFormGroupBuilder<TModel> VisibleWhen(Func<TModel, bool> predicate)` — Shows the group only while the model predicate returns true.

### DataFormLayoutBuilder
Fluent builder for a responsive DataForm grid.
_class · source: src/Omni.Blazor/Models/DataFormAdvancedModels.cs_
- `DataFormLayoutBuilder ColumnGap(string value)` — Sets the CSS column gap.
- `DataFormLayoutBuilder Columns(Breakpoint breakpoint, int value)` — Sets the mobile-first base column count.
- `DataFormLayoutBuilder Columns(int value)` — Sets the mobile-first base column count.
- `DataFormLayoutBuilder RowGap(string value)` — Sets the CSS row gap.

### DataFormLookupEditorBuilder<TModel, TItem, TValue>
Strongly typed options for a DataForm lookup whose item and value types differ.
_class · source: src/Omni.Blazor/Models/DataFormLookupModels.cs_
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> CacheEntries(int value)` — Sets the maximum LRU provider pages retained by one editor instance.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> ClearValueOnDependencyChange(bool value)` — Controls whether a dependency change clears the bound value.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> Clearable(bool value)` — Shows or hides the clear action.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> DependsOn<TDependency>(Expression<Func<TModel, TDependency>> property)` — Invalidates provider items when another model property changes. The dependent value is cleared by default.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> Items(IEnumerable<TItem> items, int maxItems)` — Uses bounded in-memory items.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> ItemsProvider(DataFormLookupProvider<TModel, TItem> provider, int pageSize, int maxItems)` — Uses a model-aware, cancellable and paged provider.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> ResolveItem(DataFormLookupResolver<TModel, TItem, TValue> resolver)` — Resolves the item represented by an initial or externally supplied value, allowing the editor to display human-readable text before opening its list.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> Templates(RenderFragment loading, RenderFragment empty, RenderFragment<OmniItemsProviderErrorContext> error)` — Sets loading, empty and retry-capable error templates.
- `DataFormLookupEditorBuilder<TModel, TItem, TValue> Texts(string empty, string loading, string loadError, string retry, string loadMore)` — Sets localized provider status text.

### DataFormNumericEditorBuilder
Typed options for numeric editors.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormNumericEditorBuilder Decimals(int value)` — Sets the number of decimal places.
- `DataFormNumericEditorBuilder Max(decimal value)` — Sets the maximum accepted value.
- `DataFormNumericEditorBuilder Min(decimal value)` — Sets the minimum accepted value.
- `DataFormNumericEditorBuilder Prefix(string value)` — Sets text before the numeric value.
- `DataFormNumericEditorBuilder Step(decimal value)` — Sets the increment/decrement step.
- `DataFormNumericEditorBuilder Suffix(string value)` — Sets text after the numeric value.

### DataFormPasswordEditorBuilder
Typed options for password editors.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormPasswordEditorBuilder Autocomplete(string value)` — Sets the HTML autocomplete token.
- `DataFormPasswordEditorBuilder MinLength(int value)` — Sets the minimum password length.
- `DataFormPasswordEditorBuilder ShowToggle(bool value)` — Shows or hides the password visibility toggle.

### DataFormSchema<TModel>
Immutable, reusable definition of the explicitly configured fields in an OmniDataForm. Create instances with Create or Builder and reuse them across renders and form instances.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `bool AutoGenerateFields` — Whether supported model properties not explicitly configured are generated. Conventional identifiers, key attributes and database-generated identities are excluded unless explicitly declared. Default true.
- `static DataFormSchemaBuilder<TModel> Builder()` — Creates a builder for advanced or conditional schema construction.
- `int Count` — Number of explicitly configured fields.
- `static DataFormSchema<TModel> Create(Action<DataFormSchemaBuilder<TModel>> configure)` — Creates and builds an immutable schema in one expression.
- `DataFormSchema<TModel> Extend(Action<DataFormSchemaBuilder<TModel>> configure)` — Creates an immutable derived schema from this reusable base.
- `IReadOnlyList<DataFormGroup<TModel>> Groups` — Top-level semantic groups declared by the schema.
- `DataFormLayout Layout` — Responsive root grid used by fields outside a group.

### DataFormSchemaBuilder<TModel>
Fluent builder for an immutable DataFormSchema`1.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormSchemaBuilder<TModel> Apply(IDataFormSchemaProfile<TModel> profile)` — Applies a reusable strongly typed schema profile.
- `DataFormSchemaBuilder<TModel> AutoGenerateFields(bool enabled)` — Includes supported model properties that were not explicitly configured. Conventional identifiers, key attributes and database-generated identities are excluded unless explicitly declared. Default true.
- `DataFormSchema<TModel> Build()` — Builds the schema. A builder can be built only once.
- `DataFormSchemaBuilder<TModel> ConventionFor<TValue>(Action<DataFormConventionBuilder<TModel>> configure)` — Adds defaults for model properties with the exact value type.
- `DataFormSchemaBuilder<TModel> ConventionForAttribute<TAttribute>(Action<DataFormConventionBuilder<TModel>> configure)` — Adds defaults for properties carrying an attribute.
- `DataFormSchemaBuilder()` — Creates an empty fluent schema builder.
- `DataFormSchemaBuilder<TModel> Field<TValue>(Expression<Func<TModel, TValue>> property, Action<DataFormFieldBuilder<TModel, TValue>> configure)` — Adds or overrides a model property using a strongly typed selector.
- `DataFormSchemaBuilder<TModel> Group(string title, Action<DataFormGroupBuilder<TModel>> configure)` — Adds a semantic, nestable field group.
- `DataFormSchemaBuilder<TModel> Include(DataFormSchema<TModel> schema)` — Includes fields, groups and conventions from an immutable schema. The receiving builder keeps its own layout and auto-generation policy.
- `DataFormSchemaBuilder<TModel> IncludeFragment(Action<DataFormSchemaBuilder<TModel>> fragment)` — Applies a reusable schema fragment to this builder.
- `DataFormSchemaBuilder<TModel> Layout(Action<DataFormLayoutBuilder> configure)` — Configures the responsive root grid.
- `DataFormSchemaBuilder<TModel> Override<TValue>(Expression<Func<TModel, TValue>> property, Action<DataFormFieldBuilder<TModel, TValue>> configure)` — Replaces an included or locally declared field with a fresh strongly typed definition while preserving its declaration position.

### DataFormSelectEditorBuilder<TValue>
Typed options and local values for a single-choice editor.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormSelectEditorBuilder<TValue> Clearable(bool value)` — Shows or hides the clear action.
- `DataFormSelectEditorBuilder<TValue> ItemsProvider(OmniItemsProvider<TValue> provider, int pageSize, int maxItems)` — Uses a cancellable and paged asynchronous option provider.
- `DataFormSelectEditorBuilder<TValue> Option(TValue value, string text)` — Adds one strongly typed option.
- `DataFormSelectEditorBuilder<TValue> Options(IEnumerable<TValue> values, Func<TValue, string> textSelector)` — Replaces the local options with strongly typed values.

### DataFormTextAreaEditorBuilder
Typed options for multi-line text editors.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormTextAreaEditorBuilder MaxLength(int value)` — Sets the maximum text length.
- `DataFormTextAreaEditorBuilder Rows(int value)` — Sets the visible row count.

### DataFormTextEditorBuilder
Typed options for text, e-mail, telephone and URL editors.
_class · source: src/Omni.Blazor/Models/DataFormSchema.cs_
- `DataFormTextEditorBuilder Autocomplete(string value)` — Sets the HTML autocomplete token.
- `DataFormTextEditorBuilder Clearable(bool value)` — Shows or hides the clear button.
- `DataFormTextEditorBuilder MaxLength(int value)` — Sets the maximum text length.
- `DataFormTextEditorBuilder MinLength(int value)` — Sets the minimum text length.

### DataFormWizardSchema<TModel>
Immutable ordered DataForm wizard schema.
_class · source: src/Omni.Blazor/Models/DataFormWizardModels.cs_
- `static DataFormWizardSchemaBuilder<TModel> Builder()` — Creates a mutable wizard schema builder.
- `static DataFormWizardSchema<TModel> Create(Action<DataFormWizardSchemaBuilder<TModel>> configure)` — Creates and builds an immutable wizard schema.
- `IReadOnlyList<DataFormWizardStep<TModel>> Steps` — Ordered immutable step definitions.

### DataFormWizardSchemaBuilder<TModel>
Strongly typed builder for ordered DataForm wizard steps.
_class · source: src/Omni.Blazor/Models/DataFormWizardModels.cs_
- `DataFormWizardSchema<TModel> Build()` — Builds the immutable wizard schema.
- `DataFormWizardSchemaBuilder()`
- `DataFormWizardSchemaBuilder<TModel> Step(string id, string title, DataFormSchema<TModel> schema, Action<DataFormWizardStepBuilder<TModel>> configure)` — Adds one step backed by an explicit DataForm schema.

### DataFormWizardStepBuilder<TModel>
Builder for one typed DataForm wizard step.
_class · source: src/Omni.Blazor/Models/DataFormWizardModels.cs_
- `DataFormWizardStepBuilder<TModel> CanEnter(Func<TModel, bool> predicate)` — Allows navigation into the step only when the model predicate returns true.
- `DataFormWizardStepBuilder<TModel> Description(string value)` — Sets supporting step description text.
- `DataFormWizardStepBuilder<TModel> Icon(string value)` — Sets an optional step icon.
- `DataFormWizardStepBuilder<TModel> ValidateAsync(Func<TModel, CancellationToken, ValueTask<IReadOnlyList<string>>> validator)` — Adds cancellable step-level validation after field validation succeeds.
- `DataFormWizardStepBuilder<TModel> VisibleWhen(Func<TModel, bool> predicate)` — Shows the step only when the model predicate returns true.

## Theme tokens

CSS custom properties (set on `:root`, override anywhere). Full list:

- `--omni-bg`
- `--omni-bg-elev`
- `--omni-bg-sunken`
- `--omni-line`
- `--omni-line-strong`
- `--omni-fg`
- `--omni-fg-muted`
- `--omni-fg-soft`
- `--omni-accent`
- `--omni-accent-hover`
- `--omni-accent-soft`
- `--omni-accent-softer`
- `--omni-accent-fg`
- `--omni-good`
- `--omni-warn`
- `--omni-danger`
- `--omni-info`
- `--omni-radius-sm`
- `--omni-radius`
- `--omni-radius-lg`
- `--omni-card-padding`
- `--omni-shadow-sm`
- `--omni-shadow`
- `--omni-shadow-lg`
- `--omni-font-ui`
- `--omni-font-mono`
- `--omni-topbar-h`
- `--omni-sidebar-w`
- `--omni-sidebar-w-collapsed`
- `--omni-z-overlay`
- `--omni-z-toast`
- `--omni-z-tooltip`
- `--omni-z-context-menu`
- `--omni-backdrop-blur`
- `--omni-backdrop-color`
- `--omni-backdrop-saturate`
- `--omni-density-scale`
- `--omni-density-row-gap`
- `--omni-density-card-pad`
- `--omni-density-input-pad`
- `--omni-density-font-size`