Files
plan2code/src/web-console/public/screens/prefs-dialog.js
T

206 lines
7.5 KiB
JavaScript
Raw Normal View History

// Plan2Code Web Console - the User Preferences dialog: its tabs, the one way
// to open and close it, the Saved mark, Back to default for the tab on screen
// and the prompt that stops an unsaved agent edit being lost.
import { onSwatchSaved, renderSwatches, resetLooks, saveLooks } from "../looks.js";
import { PREFS_TABS, prefsOpenTab, prefsResetScope } from "../prefs.js";
import { wireTabs } from "../tabs.js";
import { el, lightDismiss } from "../render.js";
import { hooks, redraw } from "../state.js";
const $ = (id) => document.getElementById(id);
let prefsTabs = null;
// Back to default only where the tab has looks to reset.
function showResetFor(id) {
$("looks-reset").hidden = prefsResetScope(id) === null;
}
// The small mark at the top right of a fieldset, level with its legend:
// "Saved", fading, or the error in its place, kept until that fieldset saves
// again. `result` is what saveLooks() resolves, or a Promise of it; a `text`
// in it replaces the word Saved.
const markTimers = new WeakMap();
function clearMark(mark) {
clearTimeout(markTimers.get(mark));
if (mark.classList.contains("is-saved")) mark.textContent = "";
}
export async function markSaved(fieldset, result) {
if (!fieldset) return;
let mark = fieldset.querySelector(":scope > .prefs-saved");
if (!mark) {
mark = el("span", "prefs-saved");
mark.setAttribute("role", "status");
// Gone after the fade, or after the same time when motion is reduced and
// no animation runs to say so (the timer below).
mark.addEventListener("animationend", () => clearMark(mark));
fieldset.appendChild(mark);
}
const { ok, error, text } = (await result) || { ok: true };
// A newer save owns the mark: an earlier one's timer must not blank it.
clearTimeout(markTimers.get(mark));
mark.classList.remove("is-saved", "error");
// Restart the fade when the same fieldset saves twice in a row.
void mark.offsetWidth;
if (ok) {
mark.textContent = text || "Saved";
mark.classList.add("is-saved");
markTimers.set(mark, setTimeout(() => clearMark(mark), 2200));
} else {
mark.textContent = error || "Could not save.";
mark.classList.add("error");
}
}
// Every way in: the gear, the dashboard's Set up preferences, or a caller
// naming the tab it wants. Agents and models load each time it opens.
export function openPrefs(tab) {
renderSwatches();
hooks.loadAgentsView();
prefsTabs.select(prefsOpenTab(tab));
$("looks-modal").showModal();
$("prefs-tab-" + prefsTabs.current()).focus();
}
// The unsaved prompt on screen: { resolve, promise, from }, or null. `from`
// is what had focus when it asked (the tab, Close, another agent's row, a field).
let asking = null;
// Everything in the dialog but the prompt, kept out of reach while it asks.
const behindPrompt = () => [$("looks-title"), $("looks-modal").querySelector(".prefs-body"), $("looks-modal").querySelector(".modal-actions")];
function endAsking(go) {
$("prefs-unsaved").hidden = true;
for (const node of behindPrompt()) node.inert = false;
const { resolve, from } = asking;
asking = null;
// Keep editing (or a failed Save) goes back into the form; going on hands
// focus back to what asked, so the action it carries on with owns it.
if (!go) hooks.focusOpen();
else if (from && from.isConnected && !from.closest("[hidden]")) from.focus();
resolve(go);
}
// Before anything leaves an agent form with an unsaved edit (Close, Esc, a
// backdrop click, another tab, another agent's row): Save, Discard or Keep
// editing, asked inside the dialog. Resolves true when it may go on.
export function confirmUnsaved() {
if (!hooks.hasUnsaved()) return Promise.resolve(true);
if (asking) return asking.promise;
let resolve;
const promise = new Promise((r) => (resolve = r));
asking = { resolve, promise, from: document.activeElement };
$("prefs-unsaved-name").textContent = hooks.unsavedName();
for (const node of behindPrompt()) node.inert = true;
$("prefs-unsaved").hidden = false;
$("prefs-unsaved-save").disabled = false;
$("prefs-unsaved-save").focus();
return promise;
}
// Plain true while nothing is unsaved, so a tab switch or a close happens in
// this same tick.
const guard = () => (hooks.hasUnsaved() || asking ? confirmUnsaved() : true);
async function closePrefs() {
if (await guard()) $("looks-modal").close();
}
function wireUnsaved() {
const box = el("div", "prefs-unsaved");
box.id = "prefs-unsaved";
box.hidden = true;
box.setAttribute("role", "alertdialog");
box.setAttribute("aria-labelledby", "prefs-unsaved-title");
box.setAttribute("aria-describedby", "prefs-unsaved-text");
const inner = el("div", "prefs-unsaved-box");
const title = el("h3", null, "Unsaved changes");
title.id = "prefs-unsaved-title";
const text = el("p");
text.id = "prefs-unsaved-text";
const name = el("strong");
name.id = "prefs-unsaved-name";
text.append("You have unsaved changes to ", name, ".");
const save = el("button", "btn small primary", "Save");
save.type = "button";
save.id = "prefs-unsaved-save";
const discard = el("button", "btn small ghost", "Discard");
discard.type = "button";
const keep = el("button", "btn small ghost", "Keep editing");
keep.type = "button";
save.addEventListener("click", async () => {
save.disabled = true;
const ok = await hooks.saveOpen();
save.disabled = false;
if (asking) endAsking(ok);
});
discard.addEventListener("click", () => {
hooks.discardOpen();
endAsking(true);
});
keep.addEventListener("click", () => endAsking(false));
const actions = el("div", "prefs-unsaved-actions");
actions.append(save, discard, keep);
inner.append(title, text, actions);
box.append(inner);
$("looks-modal").append(box);
}
export function wirePrefs() {
const dlg = $("looks-modal");
wireUnsaved();
lightDismiss(dlg, guard);
$("looks-done").addEventListener("click", closePrefs);
// Esc: held while a form has an unsaved edit, and Keep editing while the prompt asks.
dlg.addEventListener("keydown", (e) => {
if (e.key !== "Escape") return;
if (asking) {
e.preventDefault();
endAsking(false);
} else if (hooks.hasUnsaved()) {
e.preventDefault();
closePrefs();
}
});
dlg.addEventListener("cancel", (e) => {
if (!asking && !hooks.hasUnsaved()) return;
e.preventDefault();
if (!asking) closePrefs();
});
hooks.wireAgentsView();
prefsTabs = wireTabs({
tabs: PREFS_TABS,
list: $("prefs-tabs"),
panels: $("prefs-panels"),
prefix: "prefs",
tabClass: "prefs-tab",
beforeSelect: () => guard(),
// The hint describes the tab rather than naming it, so a screen reader's
// tab name stays the label, at any width.
renderTab: (t, btn) => {
const hint = el("span", "prefs-tab-hint", t.hint);
hint.id = "prefs-hint-" + t.id;
hint.setAttribute("aria-hidden", "true");
btn.append(el("span", "prefs-tab-label", t.label), hint);
btn.setAttribute("aria-describedby", hint.id);
},
onSelect: (id) => {
showResetFor(id);
$("looks-modal").querySelector(".prefs-body").scrollTop = 0;
},
});
$("btn-looks").addEventListener("click", () => openPrefs());
$("looks-reset").addEventListener("click", () => {
const tab = prefsTabs.current();
const keys = prefsResetScope(tab);
if (!keys) return;
resetLooks(keys);
const saved = saveLooks();
redraw();
markSaved($("prefs-panel-" + tab).querySelector("fieldset"), saved);
});
onSwatchSaved((saved) => markSaved($("looks-swatches").closest("fieldset"), saved));
}