ScadaBridge/src/ScadaLink.CentralUI/Components/Shared/MonacoEditor.razor

@namespace ScadaLink.CentralUI.Components.Shared
@implements IAsyncDisposable
@inject IJSRuntime JS

@if (ShowToolbar)
{
    <div class="d-flex justify-content-end align-items-center gap-3 mb-1 small text-muted">
        <button type="button" class="btn btn-link btn-sm p-0 text-decoration-none" @onclick="FormatAsync"
                title="Format document (Ctrl/Cmd+Shift+F)">Format</button>
        <button type="button" class="btn btn-link btn-sm p-0 text-decoration-none" @onclick="ToggleWrap"
                title="Word wrap">@(_wrap ? "Wrap on" : "Wrap off")</button>
        <button type="button" class="btn btn-link btn-sm p-0 text-decoration-none" @onclick="ToggleMinimap"
                title="Toggle minimap">@(_minimap ? "Minimap on" : "Minimap off")</button>
        <button type="button" class="btn btn-link btn-sm p-0 text-decoration-none" @onclick="ToggleTheme"
                title="Toggle theme">@(_dark ? "Dark" : "Light")</button>
    </div>
}

<div @ref="_hostRef" class="monaco-editor-host"
     style="height: @Height; border: 1px solid var(--bs-border-color); border-radius: 0.25rem; overflow: hidden;"></div>

@code {
    [Parameter] public string Value { get; set; } = "";
    [Parameter] public EventCallback<string> ValueChanged { get; set; }
    [Parameter] public string Language { get; set; } = "csharp";
    [Parameter] public string Height { get; set; } = "320px";
    [Parameter] public bool ReadOnly { get; set; } = false;
    [Parameter] public bool ShowToolbar { get; set; } = true;

    /// <summary>
    /// Runtime globals surface the script is analyzed against. Defaults to
    /// template/shared-script globals; set to <c>InboundApi</c> on the API
    /// method editor so <c>Route</c> and <c>Parameters</c> type-check.
    /// </summary>
    [Parameter] public ScriptAnalysis.ScriptKind ScriptKind { get; set; } = ScriptAnalysis.ScriptKind.Template;

    /// <summary>
    /// Parameter names declared on the form (derived from the SchemaBuilder's
    /// JSON Schema), surfaced as completions inside Parameters["..."] literals
    /// and used by the unknown-key diagnostic.
    /// </summary>
    [Parameter] public IReadOnlyList<string>? DeclaredParameters { get; set; }

    /// <summary>
    /// Full shapes (name + type + required) for the declared parameters.
    /// Used by Parameters["name"] hover to show the declared type. If null,
    /// derived from <see cref="DeclaredParameters"/> with type "Object".
    /// </summary>
    [Parameter] public IReadOnlyList<ScriptAnalysis.ParameterShape>? DeclaredParameterShapes { get; set; }

    /// <summary>
    /// Shapes (name + parameter list + return type) of other scripts on the
    /// same template. Surfaced inside CallScript("...") for completion,
    /// signature help, hover, and argument-count diagnostics.
    /// </summary>
    [Parameter] public IReadOnlyList<ScriptAnalysis.ScriptShape>? SiblingScripts { get; set; }

    /// <summary>
    /// Attributes declared on the current template. Surfaced inside
    /// <c>Attributes["..."]</c> for completion and SCADA006 diagnostics.
    /// </summary>
    [Parameter] public IReadOnlyList<ScriptAnalysis.AttributeShape>? SelfAttributes { get; set; }

    /// <summary>
    /// Child compositions on the current template, each with its template's
    /// attributes and scripts. Surfaced for <c>Children["X"].Attributes</c>,
    /// <c>Children["X"].CallScript</c>, and SCADA007 diagnostics.
    /// </summary>
    [Parameter] public IReadOnlyList<ScriptAnalysis.CompositionContext>? Children { get; set; }

    /// <summary>
    /// Parent template when the current template is composed inside exactly
    /// one other template. <c>null</c> at the root or when multiple parents
    /// exist. Surfaced for <c>Parent.Attributes</c> / <c>Parent.CallScript</c>.
    /// </summary>
    [Parameter] public ScriptAnalysis.CompositionContext? Parent { get; set; }

    /// <summary>
    /// Fires whenever Monaco's marker set updates (after the 500 ms diagnostic
    /// debounce). Hosts can render a <see cref="ProblemsPanel"/> with the same
    /// data.
    /// </summary>
    [Parameter] public EventCallback<IReadOnlyList<ScriptAnalysis.DiagnosticMarker>> MarkersChanged { get; set; }

    private ElementReference _hostRef;
    private DotNetObjectReference<MonacoEditor>? _dotNetRef;
    private readonly string _id = Guid.NewGuid().ToString("N");
    private string _lastSentValue = "";
    private bool _initialized;
    private bool _wrap;
    private bool _minimap;
    private bool _dark;

    protected override async Task OnAfterRenderAsync(bool firstRender)
    {
        if (firstRender)
        {
            _dotNetRef = DotNetObjectReference.Create(this);
            _lastSentValue = Value ?? "";
            try
            {
                await JS.InvokeVoidAsync(
                    "MonacoBlazor.createEditor",
                    _id,
                    _hostRef,
                    new
                    {
                        value = Value ?? "",
                        language = Language,
                        readOnly = ReadOnly
                    },
                    _dotNetRef);
                _initialized = true;
            }
            catch
            {
                // Prerendering or JS not ready — swallow; subsequent render will retry.
            }
        }
        else if (_initialized && (Value ?? "") != _lastSentValue)
        {
            _lastSentValue = Value ?? "";
            try { await JS.InvokeVoidAsync("MonacoBlazor.setValue", _id, _lastSentValue); } catch { }
        }
    }

    [JSInvokable]
    public Task OnValueChanged(string newValue)
    {
        _lastSentValue = newValue ?? "";
        return ValueChanged.InvokeAsync(_lastSentValue);
    }

    [JSInvokable]
    public Task OnMarkersChanged(ScriptAnalysis.DiagnosticMarker[] markers) =>
        MarkersChanged.InvokeAsync(markers ?? Array.Empty<ScriptAnalysis.DiagnosticMarker>());

    /// <summary>Programmatic scroll-to-line (called by the problems panel).</summary>
    public async Task RevealLineAsync(int line, int column = 1)
    {
        if (!_initialized) return;
        try { await JS.InvokeVoidAsync("MonacoBlazor.revealLine", _id, line, column); } catch { }
    }

    /// <summary>
    /// Called from JS at completion-request time so the form's latest state is
    /// passed through, not whatever was captured when the editor was created.
    /// </summary>
    [JSInvokable]
    public ScadaContext GetContext() => new(
        DeclaredParameters?.ToArray() ?? Array.Empty<string>(),
        SiblingScripts?.ToArray() ?? Array.Empty<ScriptAnalysis.ScriptShape>(),
        DeclaredParameterShapes?.ToArray()
            ?? DeclaredParameters?.Select(n => new ScriptAnalysis.ParameterShape(n, "Object", true)).ToArray()
            ?? Array.Empty<ScriptAnalysis.ParameterShape>(),
        SelfAttributes?.ToArray() ?? Array.Empty<ScriptAnalysis.AttributeShape>(),
        Children?.ToArray() ?? Array.Empty<ScriptAnalysis.CompositionContext>(),
        Parent,
        ScriptKind);

    private async Task FormatAsync()
    {
        if (!_initialized) return;
        try { await JS.InvokeVoidAsync("MonacoBlazor.format", _id); } catch { }
    }

    private async Task ToggleWrap()
    {
        _wrap = !_wrap;
        try { await JS.InvokeVoidAsync("MonacoBlazor.setEditorOption", _id, "wordWrap", _wrap ? "on" : "off"); } catch { }
    }

    private async Task ToggleMinimap()
    {
        _minimap = !_minimap;
        try { await JS.InvokeVoidAsync("MonacoBlazor.setEditorOption", _id, "minimap", new { enabled = _minimap }); } catch { }
    }

    private async Task ToggleTheme()
    {
        _dark = !_dark;
        try { await JS.InvokeVoidAsync("MonacoBlazor.setEditorOption", _id, "theme", _dark ? "vs-dark" : "vs"); } catch { }
    }

    public async ValueTask DisposeAsync()
    {
        if (_initialized)
        {
            try { await JS.InvokeVoidAsync("MonacoBlazor.dispose", _id); } catch { }
        }
        _dotNetRef?.Dispose();
    }

    public record ScadaContext(
        string[] DeclaredParameters,
        ScriptAnalysis.ScriptShape[] SiblingScripts,
        ScriptAnalysis.ParameterShape[] DeclaredParameterShapes,
        ScriptAnalysis.AttributeShape[] SelfAttributes,
        ScriptAnalysis.CompositionContext[] Children,
        ScriptAnalysis.CompositionContext? Parent,
        ScriptAnalysis.ScriptKind ScriptKind);
}