using System.Text; using System.Text.Json; using w4c_workflows.Models; namespace w4c_workflows.Services; /// /// Renders a compiled workflow into a self-contained, non-Mermaid HTML document /// that any client (the SPA, a standalone page, an email, a README) can embed in /// an <iframe> — the backend owns the layout, so no client-side /// Mermaid/CSS graph library is required. /// /// Instead of a terse node graph it produces a *rich, detailed* read: the success /// chain as a stepped timeline, the failure/compensation edges, and a full task /// inventory (entry, language, mode, env, parent/next/onError references). All /// styling is inline in the document (CSS variables for light/dark), so the /// output is portable and themeable. /// public sealed class WorkflowHtmlRenderer { private static readonly JsonSerializerOptions Json = new(JsonSerializerDefaults.Web); private readonly Microsoft.Extensions.Logging.ILogger _logger; public WorkflowHtmlRenderer(Microsoft.Extensions.Logging.ILogger logger) { _logger = logger; } public string Render(Workflow workflow, IReadOnlyList tasks, WorkflowDefinition? def, bool dark) { var sb = new StringBuilder(1 << 14); var t = tasks.OrderBy(x => x.Order).ToList(); var byId = t.ToDictionary(x => x.Id); var chain = HappyPathChain(t, byId); var errors = t.Where(x => x.OnErrorId != null).ToList(); var trigger = ParseTrigger(workflow.TriggerJson); var theme = dark ? "dark" : "light"; var title = $"{workflow.Name} — workflow"; sb.Append("\n\n"); sb.Append("\n\n\n"); sb.Append("").Append(Html(title)).Append("\n"); sb.Append("\n\n\n
\n"); // ---- Header --------------------------------------------------------- sb.Append("
\n"); sb.Append("
\n"); sb.Append("

").Append(Html(workflow.Name)).Append("

\n"); sb.Append("
\n"); Badge(sb, workflow.Mode, "badge-mode"); Badge(sb, $"v{workflow.Version}", "badge-version"); Badge(sb, $"target: {workflow.Target}", "badge-target"); Badge(sb, workflow.Status, workflow.Status == WorkflowStatus.Compiled ? "badge-ok" : "badge-warn"); if (workflow.TriggerEnabled && trigger != null) Badge(sb, $"trigger: {trigger.Type}", "badge-info"); sb.Append("
\n"); sb.Append("
\n"); if (def != null && !string.IsNullOrWhiteSpace(def.Description)) sb.Append("

").Append(Html(def.Description)).Append("

\n"); sb.Append("
\n"); MetaItem(sb, "Language", def?.Language ?? FirstLanguage(t) ?? "—"); MetaItem(sb, "Entry", def?.Entry is { } e ? $"{e.File} :: {e.Function ?? "main"}()" : (EntrySummary(t) ?? "—")); MetaItem(sb, "Tasks", t.Count.ToString()); MetaItem(sb, "Success chain", chain.Count.ToString()); MetaItem(sb, "Compensation", errors.Count.ToString()); if (workflow.UpdatedAt is { } upd) MetaItem(sb, "Updated", upd.ToUniversalTime().ToString("yyyy-MM-dd HH:mm 'UTC'")); sb.Append("
\n"); if (trigger != null) { sb.Append("
\n
Auto-trigger
\n"); sb.Append("").Append(Html(JsonSerializer.Serialize(trigger, Json))).Append("\n
\n"); } sb.Append("
\n"); // ---- Success chain -------------------------------------------------- sb.Append("
\n"); sb.Append("

Success flow

\n"); if (chain.Count == 0) { sb.Append("

No tasks defined.

\n"); } else { sb.Append("
\n"); for (var i = 0; i < chain.Count; i++) { var task = chain[i]; var last = i == chain.Count - 1; sb.Append("
\n"); sb.Append("
").Append(last ? "" : "").Append("
\n"); sb.Append("
\n"); sb.Append("
\n"); sb.Append("").Append(i + 1).Append("\n"); sb.Append("").Append(Html(task.Key)).Append("\n"); Raw(sb, Chip(task.Mode, "chip-mode")); Raw(sb, Chip(task.Language, $"chip-lang lang-{LangClass(task.Language)}")); sb.Append("
\n"); CardDetail(sb, task, byId); sb.Append("
\n"); sb.Append("
\n"); } sb.Append("
\n"); } sb.Append("
\n"); // ---- Error handling ------------------------------------------------ sb.Append("
\n"); sb.Append("

Error handling & compensation

\n"); if (errors.Count == 0) { sb.Append("

No onError targets — the chain fails hard.

\n"); } else { sb.Append("
\n"); foreach (var task in errors.OrderBy(x => x.Order)) { if (task.OnErrorId == null || !byId.TryGetValue(task.OnErrorId.Value, out var target)) continue; sb.Append("
\n"); sb.Append("").Append(Html(task.Key)).Append("\n"); sb.Append("⟶ onError ⟶\n"); sb.Append("").Append(Html(target.Key)).Append("\n"); sb.Append("").Append(Html(target.Language)).Append("\n"); sb.Append("
\n"); } sb.Append("
\n"); } sb.Append("
\n"); // ---- Task inventory ------------------------------------------------- sb.Append("
\n"); sb.Append("

Task inventory

\n"); sb.Append("
\n"); sb.Append("\n"); sb.Append("\n"); sb.Append("\n"); for (var i = 0; i < t.Count; i++) { var task = t[i]; var entry = EntryOf(task); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append(""); sb.Append("\n"); } sb.Append("\n
#KeyModeLanguageEntryFunctionParentNextOn errorEnv
").Append(i).Append("").Append(Html(task.Key)).Append("").Append(Html(task.Mode)).Append("").Append(Html(task.Language)).Append("").Append(Html(entry.File ?? "—")).Append("").Append(Html(string.IsNullOrWhiteSpace(entry.Function) ? "main" : entry.Function)).Append("()").Append(Html(KeyById(task.ParentId, byId) ?? "—")).Append("").Append(Html(KeyById(task.NextId, byId) ?? "—")).Append("").Append(Html(KeyById(task.OnErrorId, byId) ?? "—")).Append("").Append(EnvSummary(task)).Append("
\n
\n"); sb.Append("
\n"); sb.Append("
Rendered by the w4c-workflows engine at ") .Append(DateTime.UtcNow.ToString("yyyy-MM-dd HH:mm 'UTC'")) .Append(" · path ").Append(Html(workflow.Path)).Append("
\n"); sb.Append("
\n"); sb.Append("\n"); sb.Append("\n\n"); return sb.ToString(); } // ------------------------------------------------------------------ CSS private const string Css = @" :root{--bg:#f4f5f7;--panel:#ffffff;--panel2:#eef1f5;--border:#d8dce3;--text:#1c2330;--muted:#5f6b7a;--accent:#3b6fe0;--ok:#2e7d32;--warn:#b26a00;--info:#0f6f8f;--error:#c0392b;--root:#fde68a;--code:#1e2a3a;} [data-theme='dark']{--bg:#121417;--panel:#1b1f26;--panel2:#222834;--border:#2c333f;--text:#e7eaef;--muted:#97a1af;--accent:#5b8cff;--ok:#4caf6d;--warn:#e0a24c;--info:#4fb3d9;--error:#e56a5a;--root:#6a5a2a;--code:#c3d2e6;} *{box-sizing:border-box} body{margin:0;background:var(--bg);color:var(--text);font:14px/1.5 -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;-webkit-font-smoothing:antialiased} main.wf{max-width:1180px;margin:0 auto;padding:20px} h1,h2{margin:0;font-weight:700} code{font-family:ui-monospace,SFMono-Regular,'SF Mono',Menlo,Consolas,monospace;font-size:12.5px} .wf-head{background:var(--panel);border:1px solid var(--border);border-radius:12px;padding:20px 22px;box-shadow:0 1px 2px rgba(0,0,0,.04)} .wf-head-row{display:flex;flex-wrap:wrap;gap:12px;align-items:center;justify-content:space-between} .wf-name{font-size:24px;letter-spacing:-.01em} .wf-desc{margin:10px 0 0;color:var(--muted)} .wf-badges{display:flex;flex-wrap:wrap;gap:6px} .badge{display:inline-flex;align-items:center;padding:3px 10px;border-radius:999px;font-size:12px;font-weight:600;border:1px solid transparent} .badge-mode{background:var(--accent);color:#fff} .badge-version{background:var(--panel2);border-color:var(--border);color:var(--text)} .badge-target{background:var(--panel2);border-color:var(--border);color:var(--muted)} .badge-ok{background:rgba(76,175,109,.16);color:var(--ok)} .badge-warn{background:rgba(224,162,76,.18);color:var(--warn)} .badge-info{background:rgba(79,179,217,.16);color:var(--info)} .wf-meta{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:10px 18px;margin:16px 0 0;padding:14px 0 0;border-top:1px dashed var(--border)} .wf-meta .m-label{font-size:11px;text-transform:uppercase;letter-spacing:.04em;color:var(--muted)} .wf-meta .m-value{font-size:14px;margin-top:2px} .wf-trigger{margin-top:14px;background:var(--panel2);border:1px solid var(--border);border-radius:8px;padding:10px 12px} .wf-trigger-title{font-size:11px;text-transform:uppercase;letter-spacing:.04em;color:var(--muted);margin-bottom:4px} .wf-trigger code{color:var(--info)} .wf-sec{margin-top:26px} .wf-sec-title{font-size:17px;margin-bottom:14px} .wf-empty{color:var(--muted);background:var(--panel);border:1px dashed var(--border);border-radius:8px;padding:16px} .wf-flow{display:flex;flex-direction:column} .wf-step{display:flex;gap:12px;min-width:0} .wf-rail{display:flex;flex-direction:column;align-items:center;width:22px;flex:0 0 22px} .wf-dot{width:14px;height:14px;border-radius:50%;background:var(--accent);box-shadow:0 0 0 3px color-mix(in srgb,var(--accent) 22%,transparent);flex:0 0 auto;margin-top:20px} .wf-step:first-child .wf-dot{background:var(--root);box-shadow:0 0 0 3px rgba(253,230,138,.3)} .wf-line{width:2px;background:var(--border);flex:1 1 auto;margin-top:4px} .wf-card{flex:1;background:var(--panel);border:1px solid var(--border);border-radius:10px;padding:12px 14px;margin:0 0 14px;cursor:pointer;transition:box-shadow .12s,border-color .12s} .wf-step:last-child .wf-card{margin-bottom:0} .wf-card:hover{border-color:var(--accent);box-shadow:0 3px 10px rgba(0,0,0,.07)} .wf-card-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap} .wf-step-num{display:inline-flex;align-items:center;justify-content:center;min-width:22px;height:22px;border-radius:50%;background:var(--panel2);border:1px solid var(--border);font-size:12px;font-weight:700;color:var(--muted)} .wf-key{font-weight:700;font-size:15px} .chip{display:inline-flex;align-items:center;padding:1px 8px;border-radius:999px;font-size:11px;font-weight:600;border:1px solid var(--border);background:var(--panel2);color:var(--muted)} .chip-mode{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 40%,var(--border))} .chip-lang{color:var(--text);padding:0 4px;border-radius:4px} .lang-javascript{background:#f7df1e;color:#1c2330} .lang-typescript{background:#3178c6;color:#fff} .lang-python{background:#3776ab;color:#fff} .lang-csharp{background:#68217a;color:#fff} .lang-shell{background:#4eaa25;color:#fff} .lang-plaintext{background:var(--panel2);color:var(--muted)} .wf-card-detail{display:flex;flex-wrap:wrap;gap:18px;margin-top:10px;color:var(--muted)} .wf-card-detail .d-item{min-width:120px} .wf-card-detail .d-label{font-size:10px;text-transform:uppercase;letter-spacing:.05em} .wf-card-detail .d-value{font-size:13px;margin-top:2px;color:var(--text)} .wf-links{margin-top:8px;display:flex;flex-wrap:wrap;gap:8px;font-size:12px} .wf-link{color:var(--muted)} .wf-link b{color:var(--accent);font-weight:600} .wf-envs{margin-top:8px;display:flex;flex-wrap:wrap;gap:6px} .wf-env{background:var(--panel2);border:1px solid var(--border);border-radius:6px;padding:2px 7px;font-size:11.5px} .wf-env code{font-size:11px} .wf-errors{display:flex;flex-direction:column;gap:10px} .wf-err-card{display:flex;align-items:center;flex-wrap:wrap;gap:10px;background:rgba(229,106,90,.07);border:1px dashed color-mix(in srgb,var(--error) 55%,var(--border));border-radius:10px;padding:12px 14px} .wf-err-src,.wf-err-dst{font-size:13px;font-weight:700} .wf-err-arrow{color:var(--error);font-size:12px;text-transform:uppercase;letter-spacing:.04em} .wf-err-lang{color:var(--muted);font-size:12px} .wf-table-wrapper{overflow-x:auto;border:1px solid var(--border);border-radius:10px;background:var(--panel)} .wf-table{width:100%;border-collapse:collapse;min-width:760px;font-size:12.5px} .wf-table thead th{background:var(--panel2);text-align:left;padding:9px 10px;font-size:11px;text-transform:uppercase;letter-spacing:.04em;color:var(--muted);border-bottom:1px solid var(--border);position:sticky;top:0} .wf-table tbody td{padding:8px 10px;border-bottom:1px solid var(--border);vertical-align:top} .wf-table tbody tr:last-child td{border-bottom:none} .wf-table tbody tr:hover{background:color-mix(in srgb,var(--accent) 6%,transparent)} .wf-foot{margin-top:26px;padding-top:14px;border-top:1px solid var(--border);color:var(--muted);font-size:12px} .wf-foot code{color:var(--muted)} "; // ------------------------------------------------------------- builders private static void Badge(StringBuilder sb, string label, string cls) { sb.Append("").Append(Html(label)).Append("\n"); } private static void MetaItem(StringBuilder sb, string label, string value) { sb.Append("
").Append(Html(label)).Append("
").Append(Html(value)).Append("
\n"); } private static void CardDetail(StringBuilder sb, WorkflowTask task, IReadOnlyDictionary byId) { var entry = EntryOf(task); sb.Append("
\n"); DetailItem(sb, "Entry file", entry.File ?? "—"); DetailItem(sb, "Function", string.IsNullOrWhiteSpace(entry.Function) ? "main()" : $"{entry.Function}()"); DetailItem(sb, "Mode", task.Mode); sb.Append("
\n"); var links = new List(); if (task.NextId != null) links.Add($"next {Html(KeyById(task.NextId, byId) ?? "?")}"); if (task.OnErrorId != null) links.Add($"onError {Html(KeyById(task.OnErrorId, byId) ?? "?")}"); if (links.Count > 0) sb.Append("
").Append(string.Join(" · ", links)).Append("
\n"); var env = EnvOf(task); if (env is { Count: > 0 }) { sb.Append("
\n"); foreach (var kv in env.OrderBy(x => x.Key)) sb.Append("").Append(Html(kv.Key)).Append(" = ").Append(Html(kv.Value)).Append("\n"); sb.Append("
\n"); } } private static void DetailItem(StringBuilder sb, string label, string value) { sb.Append("
").Append(Html(label)).Append("
").Append(Html(value)).Append("
\n"); } private static void Raw(StringBuilder sb, string s) => sb.Append(s); private static string Chip(string label, string cls) => $"{Html(label)}"; // ------------------------------------------------------------- data private static List HappyPathChain(IReadOnlyList tasks, IReadOnlyDictionary byId) { var root = tasks.FirstOrDefault(x => x.Key == "root") ?? tasks.OrderBy(x => x.Order).FirstOrDefault(); var chain = new List(); var visited = new HashSet(); var cur = root; while (cur != null && visited.Add(cur.Id)) { chain.Add(cur); cur = cur.NextId != null && byId.TryGetValue(cur.NextId.Value, out var next) ? next : null; } return chain; } private static string? KeyById(Guid? id, IReadOnlyDictionary byId) => id != null && byId.TryGetValue(id.Value, out var t) ? t.Key : null; private static EntryDefinition EntryOf(WorkflowTask task) => JsonSerializer.Deserialize(task.EntryJson ?? "{}", Json) ?? new EntryDefinition(); private static Dictionary? EnvOf(WorkflowTask task) => JsonSerializer.Deserialize>(task.EnvJson ?? "{}", Json); private static string EnvSummary(WorkflowTask task) { var env = EnvOf(task); return env is { Count: > 0 } ? $"{env.Count} var" : "—"; } private static TriggerDefinition? ParseTrigger(string? json) => string.IsNullOrWhiteSpace(json) ? null : JsonSerializer.Deserialize(json, Json); private static string? FirstLanguage(IReadOnlyList tasks) => tasks.Select(x => x.Language).FirstOrDefault(x => !string.IsNullOrWhiteSpace(x)); private static string? EntrySummary(IReadOnlyList tasks) { var root = tasks.FirstOrDefault(x => x.Key == "root"); if (root == null) return null; var e = EntryOf(root); return $"{e.File ?? "—"} :: {e.Function ?? "main"}()"; } private static string LangClass(string? lang) => lang switch { "javascript" => "javascript", "typescript" => "typescript", "python" => "python", "csharp" => "csharp", "shell" => "shell", _ => "plaintext", }; private static string Html(string? s) => System.Net.WebUtility.HtmlEncode(s ?? string.Empty); }