Lyo.Config.Web.Components 1.0.11

dotnet add package Lyo.Config.Web.Components --version 1.0.11
                    
NuGet\Install-Package Lyo.Config.Web.Components -Version 1.0.11
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Lyo.Config.Web.Components" Version="1.0.11" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Lyo.Config.Web.Components" Version="1.0.11" />
                    
Directory.Packages.props
<PackageReference Include="Lyo.Config.Web.Components" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Lyo.Config.Web.Components --version 1.0.11
                    
#r "nuget: Lyo.Config.Web.Components, 1.0.11"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Lyo.Config.Web.Components@1.0.11
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Lyo.Config.Web.Components&version=1.0.11
                    
Install as a Cake Addin
#tool nuget:?package=Lyo.Config.Web.Components&version=1.0.11
                    
Install as a Cake Tool

Lyo.Config.Web.Components

Blazor / MudBlazor dashboard for Lyo.Config. Add ConfigManagement to a host page for definitions, resolved per-entity values, definition history, and value history.

Components take IConfigStore as a parameter for writes. Optional IApiClient enables LyoDataGridProjected over Config.Api / TestApi query routes. There is no AddXxx DI registration and no IEncryptionService in this package — the client sends plaintext plus IsEncrypted; the API encrypts at rest.

Targets interactive Blazor on net10.0.

Examples

How a host wires this up

@inject IConfigStore Store
@inject IApiClient ApiClient

<ConfigManagement Store="Store" ApiClient="ApiClient" InitialSubjectEntityType="App" InitialSubjectEntityId="gateway:local" />

Architecture

flowchart LR
    UI[ConfigManagement tabs] --> Store[IConfigStore]
    UI --> Query[IApiClient query grids]
    Store -->|ConfigApiStore HTTP| API[Config.Api / TestApi]
    API --> Encrypt[IEncryptionService]
    API --> PG[config schema]

Top-level entry point

@using Lyo.Config.Web.Components

<ConfigManagement Store="Store" />
Parameter Notes
Store Required IConfigStore. Hosts inject the store and pass it in.
ApiClient Optional IApiClient. When set, the definitions tab uses LyoDataGridProjected on Config/Definition (search/filter/sort/export). Bulk delete still calls IConfigStore.DeleteDefinitionAsync.
InitialSubjectEntityType Toolbar prefill. Defaults to App (AppConfigEntity.AppEntityType).
InitialSubjectEntityId Toolbar prefill for the entity instance (string; app routes use kind:id).

ConfigManagement owns subject entity type/id (Apply to load) and renders tabbed MudTabs: Definitions, Resolved, Definition history, Value history. GetDefinitionsAsync requires an entity type; bindings and LoadConfigAsync also need an id. There is no list-all-definitions API.

Component catalog

Component Role
ConfigManagement Toolbar + tabbed dashboard shell.
ConfigDefinitionGrid LyoDataGridProjected when IApiClient is set (filter Key / ForValueType / IsRequired / IsEncrypted, export, store-backed bulk delete). Fallback MudTable over IConfigStore. History opens definition history. Required / Encrypted / Has default chips.
ConfigDefinitionView LyoDialogPresets.Medium + LyoForm. Type dropdown from ClrTypeInfo.All plus Custom FullName (Enum also asks for the concrete FullName). Encrypted switch (flag only). Optional default via ConfigValueEditor. Compact definition history with revert.
ConfigResolvedView LoadConfigAsync merge for type+id. Source chips: Overridden / Using default / Missing. Edit binding, reset to default, clear binding; History jumps to Value history when a binding exists.
ConfigBindingView Medium binding editor. Encrypted inherits from the definition (client still only sends plaintext). Compact value history with revert.
ConfigValueEditor Typed Mud inputs from ClrTypeInfo.EditorKind; JsonEditor<JsonNode> for JSON documents, collections, binary, and custom types. Password-style input when Encrypted. No type-name field (the definition owns ForValueType).
ConfigDefinitionRevisionList Newest-first metadata revisions for a selected definition. Revert copies that snapshot and appends a new revision.
ConfigRevisionList Newest-first value revisions for a selected binding. Revert copies that snapshot and appends a new revision. Empty until the first binding save.
ConfigColorHelper Chip colors for required/optional and Binding/Default/Missing. Rendering goes through LyoChip.

Store calls

  • SaveDefinitionAsync / SaveBindingAsync(..., tenantId: null).
  • DeleteDefinitionAsync — confirm in UI; PostgreSQL cascades bindings and revisions.
  • DeleteBindingAsyncInvalidOperationException when IsRequired and there is no default is shown as a snackbar.
  • LoadConfigAsync — required-missing is shown as a warning; fallback rows still let you edit bindings.
  • GetDefinitionRevisionsAsync / RevertDefinitionToRevisionAsync — definition history.
  • GetBindingRevisionsAsync / RevertBindingToRevisionAsync — value history; revert is auditable (new revision appended).

Shared UI

Reuse LyoDialog / LyoDialogPresets.Medium, LyoForm / LyoFormInput, LyoIdField, LyoChip / LyoChips, LyoTimestamp, LyoTruncatedText, and JsonEditor. Status chips go in TitleChips, not TitleContent. Pass optional IApiClient for LyoDataGridProjected on definition query routes. Do not register IEncryptionService in this package.

See also

Dependencies

Generated from ProjectReference / PackageReference (same model as docs/Lyo.ProjectGraph.html).

  • Lyo.Api.Client (direct, lyo)
  • Lyo.Config (direct, lyo)
  • Lyo.Web.Components (direct, lyo)
  • Lyo.Web.Components.Export (direct, lyo)
  • Lyo.Web.Components.Export.Csv (direct, lyo)
  • Lyo.Web.Components.Export.Xlsx (direct, lyo)
  • MudBlazor 9.3 (direct, third-party)
  • Lyo.Api.Models (transitive, lyo)
  • Lyo.Cache (transitive, lyo)
  • Lyo.Common (transitive, lyo)
  • Lyo.Compression (transitive, lyo)
  • Lyo.DataTable.Models (transitive, lyo)
  • Lyo.DateAndTime (transitive, lyo)
  • Lyo.Diagnostic (transitive, lyo)
  • Lyo.Encryption (transitive, lyo)
  • Lyo.EntityReference.Models (transitive, lyo)
  • Lyo.Exceptions (transitive, lyo)
  • Lyo.Hashing (transitive, lyo)
  • Lyo.Health (transitive, lyo)
  • Lyo.IO.Temp (transitive, lyo)
  • Lyo.KeyStore (transitive, lyo)
  • Lyo.Metrics (transitive, lyo)
  • Lyo.PackageMetadata (transitive, lyo)
  • Lyo.Query (transitive, lyo)
  • Lyo.Query.Models (transitive, lyo)
  • Lyo.Result (transitive, lyo)
  • Lyo.Streams (transitive, lyo)
  • Lyo.Validation (transitive, lyo)
  • Blazored.LocalStorage 4.5.0 (transitive, third-party)
  • BouncyCastle.Cryptography 2.6.2 (transitive, third-party, netstandard2.0)
  • EasyCompressor 2.1.0 (transitive, third-party)
  • Konscious.Security.Cryptography.Argon2 1.3.1 (transitive, third-party)
  • Microsoft.Bcl.AsyncInterfaces 10.0.5 (transitive, microsoft, netstandard2.0)
  • Microsoft.Extensions.Caching.Memory 10.0.5 (transitive, microsoft)
  • Microsoft.Extensions.Configuration.Binder 10.0.5 (transitive, microsoft)
  • Microsoft.Extensions.DependencyInjection 10.0.5 (transitive, microsoft)
  • Microsoft.Extensions.DependencyInjection.Abstractions 10.0.5 (transitive, microsoft, net10.0, netstandard2.0)
  • Microsoft.Extensions.Hosting.Abstractions 10.0.5 (transitive, microsoft)
  • Microsoft.Extensions.Http 10.0.5 (transitive, microsoft)
  • Microsoft.Extensions.Logging.Abstractions 10.0.5 (transitive, microsoft)
  • Microsoft.Extensions.Options.ConfigurationExtensions 10.0.5 (transitive, microsoft)
  • System.Buffers 4.6.1 (transitive, microsoft, netstandard2.0)
  • System.ComponentModel.Annotations 5.0.0 (transitive, microsoft)
  • System.IO.Hashing 10.0.5 (transitive, microsoft, net10.0)
  • System.Memory 4.6.3 (transitive, microsoft, netstandard2.0)
  • System.Text.Json 10.0.5 (transitive, microsoft, netstandard2.0)
  • System.Threading.Tasks.Extensions 4.6.3 (transitive, microsoft, netstandard2.0)
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.0.11 0 8/23/2026
1.0.9 34 8/22/2026
1.0.7 40 8/22/2026