Lyo.Formatter.Web.Components 1.0.0

Lyo.Formatter.Web.Components

Blazor / MudBlazor components for Lyo.Formatter. LyoFormatterTemplateEditor and LyoFormatterPreview share a LyoFormatterLiveSession, so the host can put the template box in one region and the preview in another. Formatting runs in-process via IFormatterService. No HTTP. Works with InteractiveWebAssembly and InteractiveServer. This package does not reference Microsoft.AspNetCore.App.

Examples

Split editor and preview

@inject IFormatterService Formatter

<MudGrid>
    <MudItem xs="12" md="6">
        <LyoFormatterTemplateEditor Session="_session" DebounceInterval="300" />
    </MudItem>
    <MudItem xs="12" md="6">
        <LyoFormatterPreview Session="_session" />
    </MudItem>
</MudGrid>

@code {
    private LyoFormatterLiveSession _session = default!;

    protected override void OnInitialized()
    {
        _session = new(Formatter) {
            Template = "Hello, {Name}! Count: {Count:N0}",
            Context = new Dictionary<string, object?> { ["Name"] = "Ada", ["Count"] = 42 }
        };
    }
}

Components

Session and colors

• LyoFormatterLiveSession. Parent-owned INotifyPropertyChanged state: Template, Context, HoveredPlaceholder, DebounceInterval, TemplateSegments, PreviewSegments. Call RefreshPreview() after setting the initial template and context so the first paint is not empty. Dispose the session with the page.
• Stable colors. LyoFormatterPlaceholderPalette hashes the placeholder key (ordinal ignore-case) to an HSL hue so {Name} and its replacement always match. Fills are color-mixed into --mud-palette-surface so light and dark themes keep contrast. Colors are not re-randomized per render.
• Hover. Sets Session.HoveredPlaceholder. Matching spans get a stronger fill and outline.
• Unresolved. Missing context (MaintainTokens) uses a muted dashed underline instead of a key color.
• Autocomplete. LyoFormatterContextCatalog walks Session.Context (dictionary keys or public properties, nested up to 3 levels). Typing { opens a floating list under the caret of keys and nested object properties (User, User.Address.City). Further typing filters the list (prefix match on the path or a dotted segment), including inside an already-closed {key}. Arrow, Enter, Tab, and Escape move and insert. The active row scrolls into view.
• Optional CascadingValue of the session so distant editor/preview pairs need not pass Session on every call. An explicit Session parameter still wins.

Host integration

Call services.AddFormatterService() from Lyo.Formatter. Create one LyoFormatterLiveSession per editor/preview pair (inject IFormatterService). Supply Context as a DTO or IReadOnlyDictionary<string, object?>. There is no context editor in this package.

WASM

No IHttpContextAccessor, no server-only framework reference, no formatting via HTTP. Overlay and textarea share a CSS grid cell so they scroll together. Caret position and the { autocomplete dropdown use a small JS module from this package's wwwroot (imported by the editor; no host <script> tag). Works under InteractiveWebAssembly when the host registers IFormatterService and references this package.

Dependencies

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

• Lyo.Formatter (direct, lyo)
• Lyo.Web.Components (direct, lyo)
• MudBlazor 9.3 (direct, third-party)
• Lyo.Api.Client (transitive, lyo)
• 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.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)
• SmartFormat.NET 3.6.1 (transitive, third-party)
• 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)