import { useCallback, useEffect, useMemo, useState } from "react"; import { AlertTriangle, ChevronDown, ChevronRight, RotateCcw, Search } from "lucide-react"; import { api, asUiError, type AllSetting, type FieldError, type JsonValue, type ModuleSetting, type PresetInfo, type PresetPreview, type SaveReport, type Scope, type SettingsView, type SettingView, type UiError, } from "@/lib/api"; import { squidSettingsView } from "@/lib/squidSettings"; import { cn } from "@/lib/utils"; import { Button } from "@/components/ui/button"; import { Card } from "@/components/ui/card"; import { CollectionRows, RawRows, collectionsOf } from "@/screens/ExtraRows"; import { CompanionsCard } from "@/screens/CompanionsCard"; import { useHuman, useI18n, useSchemaText, useT, type Key } from "@/i18n"; import type { UnsavedChangesGuard } from "@/lib/unsavedGuard"; type T = (k: Key, v?: Record) => string; const RESTART_LABEL = { runtime: "set.restart.runtime", world: "set.restart.world", full: "set.restart.full" } as const; type SX = ReturnType; function fmt(t: T, sx: SX, v: JsonValue, s: { key: string; type: string; unit?: string | null; options: { value: JsonValue; label: string }[] }): string { if (typeof v === "boolean") return v ? t("set.on") : t("set.off"); if (s.type === "enum") { const o = s.options.find((x) => x.value === v); return o ? sx.option(s.key, o) : String(v); } return s.unit ? `${v} ${sx.unit(s.unit)}` : String(v); } function clientCheck(t: T, s: SettingView, v: JsonValue): string | null { if (s.type === "int" || s.type === "float") { if (typeof v !== "number" || !Number.isFinite(v)) return t("set.enterNumber"); if (s.type === "int" && !Number.isInteger(v)) return t("set.enterInt"); if (s.min !== undefined && v < s.min) return t("set.atLeast", { n: s.min }); if (s.max !== undefined && v > s.max) return t("set.atMost", { n: s.max }); } return null; } function Field(props: { s: SettingView; value: JsonValue; error: string | null; onChange: (v: JsonValue) => void }) { const { s, value, error, onChange } = props; const t = useT(); const sx = useSchemaText(); const [text, setText] = useState(String(value)); useEffect(() => setText(String(value)), [value]); const id = `f-${s.key}`; const base = "rounded-md border bg-bg px-3 py-2 text-sm outline-none focus:border-gold"; if (s.type === "bool") { return ( ); } if (s.type === "enum") { return ( ); } const numeric = s.type === "int" || s.type === "float"; return (
{ const raw = e.target.value; setText(raw); const normalized = raw.replace(",", "."); const number = Number(normalized); onChange(numeric && normalized.trim() !== "" && Number.isFinite(number) ? number : raw); }} /> {s.unit && {sx.unit(s.unit)}}
); } function Row(props: { s: SettingView; value: JsonValue; error: string | null; onChange: (v: JsonValue) => void; onReset: () => void }) { const { s, value, error } = props; const t = useT(); const sx = useSchemaText(); const changed = value !== s.value; return (

{sx.description(s)}

{t("set.default", { v: fmt(t, sx, s.default, s) })} {s.min !== undefined && s.max !== undefined && s.type !== "bool" ? ` · ${t("set.range", { min: s.min, max: s.max })}` : ""} · {t(RESTART_LABEL[s.restartRequired])}

{s.problem &&

{t("set.badValue", { problem: s.problem })}

} {s.drift &&

{t("set.drift")}

} {error && (

{error}

)}
); } export function SettingsPage(props: { serverId: string; scope: Scope; botModule?: "companions" | "playerbots"; title: string; question: string; onRegisterGuard?: (guard: UnsavedChangesGuard | null) => void; }) { const { serverId, scope } = props; const { t, tn, locale } = useI18n(); const squid = scope === "bots" && props.botModule === "playerbots"; const sx = useSchemaText(); const human = useHuman(); const [view, setView] = useState(null); const [draft, setDraft] = useState>({}); const [errors, setErrors] = useState>({}); const [fatal, setFatal] = useState(null); const [saveErr, setSaveErr] = useState(null); const [saved, setSaved] = useState(null); const [presets, setPresets] = useState([]); const [preview, setPreview] = useState(null); const [category, setCategory] = useState(""); const [showAdvanced, setShowAdvanced] = useState(false); const [busy, setBusy] = useState(false); const [running, setRunning] = useState(false); // Beside the curated settings the server page offers the collection switches and every other documented setting. They are // searched together and saved with the rest, so the page has one search box, one set of tabs and one save bar. const [query, setQuery] = useState(""); const [raw, setRaw] = useState(null); const [rawEdits, setRawEdits] = useState>({}); const [onlyChanged, setOnlyChanged] = useState(false); const [squidVersion, setSquidVersion] = useState(null); const [cols, setCols] = useState([]); const [colEdits, setColEdits] = useState>({}); const load = useCallback(async () => { try { const data = squid ? await Promise.all([api.moduleSettings(serverId, "playerbots"), api.modulesList(serverId)]) : null; if (data) setSquidVersion(data[1].find(module => module.id === "playerbots")?.version ?? null); const v = data ? squidSettingsView(data[0], locale) : await api.settings(serverId, scope); setView(v); setDraft({}); setErrors({}); setCategory((c) => c || v.categories.find((x) => v.settings.some((s) => s.category === x.id && !s.advanced))?.id || v.categories[0].id); setFatal(null); } catch (e) { setFatal(asUiError(e)); } }, [serverId, scope, squid, locale]); useEffect(() => { setView(null); setSaved(null); setCategory(""); void load(); if (squid) setPresets([]); else void api.presets(scope).then(setPresets); void api.status(serverId).then((s) => setRunning(s.observed.world.state === "running")); setQuery(""); setRaw(null); setRawEdits({}); setColEdits({}); setCols([]); if (scope === "server") void api.moduleSettings(serverId, "client-compat").then(setCols).catch(() => setCols([])); }, [load, scope, serverId]); const needRaw = scope === "server" && (category === "@all" || query.trim() !== ""); useEffect(() => { if (needRaw && !raw) void api.allSettings(serverId).then(setRaw).catch(() => setRaw([])); }, [needRaw, raw, serverId]); const valueOf = (s: SettingView): JsonValue => (s.key in draft ? draft[s.key] : s.value); const dirtyKeys = useMemo(() => Object.keys(draft).filter((k) => view && draft[k] !== view.settings.find((s) => s.key === k)?.value), [draft, view]); const editRaw = (key: string, value: string | null) => setRawEdits((e) => { const n = { ...e }; if (value === null) delete n[key]; else n[key] = value; return n; }); const editCol = (key: string, value: string | null) => setColEdits((e) => { const n = { ...e }; if (value === null) delete n[key]; else n[key] = value; return n; }); const pending = dirtyKeys.length + Object.keys(rawEdits).length + Object.keys(colEdits).length; useEffect(() => { if (pending > 0) { props.onRegisterGuard?.({ isDirty: () => pending > 0, save: () => saveEverything(), discard: () => { setDraft({}); setErrors({}); setRawEdits({}); setColEdits({}); }, }); } else { props.onRegisterGuard?.(null); } return () => props.onRegisterGuard?.(null); }, [pending, props.onRegisterGuard]); if (fatal) { return (

{props.title}

{fatal.human.code === "unknown" ? t("set.nothingYet") : human(fatal.human).title}

{fatal.human.code === "unknown" ? fatal.technical : human(fatal.human).message}

); } if (!view) return

{t("set.loading")}

; const inCategory = view.settings.filter((s) => s.category === category); const basic = inCategory.filter((s) => !s.advanced); const advanced = inCategory.filter((s) => s.advanced); const advancedCount = (id: string) => view.settings.filter((s) => s.category === id && s.advanced).length; const basicCount = (id: string) => view.settings.filter((s) => s.category === id && !s.advanced).length; const SHOWN = 40; // the long list of other settings is drawn in part; searching narrows it const q = query.trim().toLowerCase(); const searching = q !== ""; const hit = (...parts: string[]) => parts.some((x) => x.toLowerCase().includes(q)); const collections = collectionsOf(cols); const curatedKeys = new Set([...view.settings.map((s) => s.key), ...collections.map((c) => c.item.key)]); const curatedHits = searching ? view.settings.filter((s) => hit(s.key, sx.title(s), sx.description(s))) : []; const collectionHits = searching ? collections.filter((c) => hit(c.item.key, t(c.label), t(c.text))) : []; const rawHits = (raw ?? []).filter( (s) => !curatedKeys.has(s.key) && (!onlyChanged || s.changed || s.key in rawEdits) && (!searching || hit(s.key, s.doc)), ); const rowOf = (s: SettingView) => ( setDraft((d) => ({ ...d, [s.key]: v }))} onReset={() => setDraft((d) => ({ ...d, [s.key]: s.default }))} /> ); const tabs = [ ...view.categories.filter((c) => basicCount(c.id) + advancedCount(c.id) > 0).map((c) => ({ id: c.id, label: sx.category(scope, c) })), ...(collections.length ? [{ id: "@collections", label: t("set.tab.collections") }] : []), ...(scope === "server" ? [{ id: "@all", label: t("set.tab.all") }] : []), ]; async function save(changes: Record): Promise { const local: Record = {}; for (const [k, v] of Object.entries(changes)) { const s = view!.settings.find((x) => x.key === k)!; const m = clientCheck(t, s, v); if (m) local[k] = m; } setErrors(local); if (Object.keys(local).length) return false; const dangerous = Object.keys(changes).filter((k) => view!.settings.find((s) => s.key === k)?.dangerous); if (dangerous.length && !window.confirm(t("set.confirmCareful", { n: dangerous.length }))) return false; setBusy(true); setSaveErr(null); try { const report: SaveReport = squid ? { changed: (await api.moduleSaveSettings(serverId, "playerbots", Object.fromEntries(Object.entries(changes).map(([key, value]) => [key, typeof value === "boolean" ? value ? "1" : "0" : String(value)])))).map(key => ({ key, title: view!.settings.find(s => s.key === key)!.title, restart: "world", dangerous: false })), restart: "world", snapshot: null, } : await api.save(serverId, scope, changes); setSaved(report); setPreview(null); await load(); void api.status(serverId).then((s) => setRunning(s.observed.world.state === "running")); return true; } catch (e) { const ui = asUiError(e); setSaveErr(ui); const map: Record = {}; (ui.fields ?? ([] as FieldError[])).forEach((f) => (map[f.key] = f.message)); setErrors(map); return false; } finally { setBusy(false); } } /** The save bar saves all three kinds of edits: the curated settings, the collection switches and the other documented ones. */ async function saveEverything(): Promise { if (dirtyKeys.length && !(await save(Object.fromEntries(dirtyKeys.map((k) => [k, draft[k]]))))) return false; const extra = [...Object.keys(rawEdits), ...Object.keys(colEdits)]; if (!extra.length) return true; setBusy(true); setSaveErr(null); try { if (Object.keys(rawEdits).length) { await api.allSettingsSave(serverId, rawEdits); setRawEdits({}); setRaw(await api.allSettings(serverId)); } if (Object.keys(colEdits).length) { await api.moduleSaveSettings(serverId, "client-compat", colEdits); setColEdits({}); setCols(await api.moduleSettings(serverId, "client-compat")); } const more = extra.map((key) => ({ key, title: key, restart: "world" as const, dangerous: false })); setSaved((prev) => ({ changed: [...(prev?.changed ?? []), ...more], restart: prev?.restart ?? "world", snapshot: prev?.snapshot ?? null })); void api.status(serverId).then((st) => setRunning(st.observed.world.state === "running")); return true; } catch (e) { setSaveErr(asUiError(e)); return false; } finally { setBusy(false); } } async function openPreset(id: string) { setSaved(null); if (squid) { setPreview({ id: "defaults", title: t("set.restoreDefaults"), description: "", changes: view!.settings.filter(s => s.value !== s.default).map(s => ({ key: s.key, title: s.title, from: s.value, to: s.default, dangerous: false })) }); } else setPreview(await api.previewPreset(serverId, scope, id)); } async function restartNow() { setBusy(true); try { await api.stop(serverId); await api.start(serverId); setSaved(null); setRunning(true); } finally { setBusy(false); } } return (

{props.title}

{squid ? `SQUID’s Playerbots${squidVersion ? " · " + squidVersion : ""}` : props.question}

{scope === "bots" && !squid && } {view.drift_keys.length > 0 && (

{t("set.driftTitle", { n: view.drift_keys.length })}

{t("set.driftText")}{" "} {view.drift_keys.slice(0, 6).join(", ")} {view.drift_keys.length > 6 ? "…" : ""}

)}
{presets.length > 0 && {t("set.presets")}} {presets.map((p) => ( ))}
{preview && (

{sx.preset({ id: preview.id, title: preview.title, description: preview.description }).title}

{sx.preset({ id: preview.id, title: preview.title, description: preview.description }).description}

{preview.changes.length === 0 ? (

{t("set.matches")}

) : ( <>

{tn("set.willChange", preview.changes.length)}

    {preview.changes.map((c) => { const s = view.settings.find((x) => x.key === c.key)!; return (
  • {sx.title({ key: c.key, title: c.title })} {fmt(t, sx, c.from, s)} → {fmt(t, sx, c.to, s)}
  • ); })}
)}
{preview.changes.length > 0 && ( )}
)} {saved && ( {saved.changed.length === 0 ? (

{t("set.nothingChanged")}

) : ( <>

{t("set.saved")}

{running && saved.restart ? tn("set.restartRequired", saved.changed.length) : t("set.appliesNextStart")}

{running && saved.restart && (
)} )}
)} {saveErr && (

{human(saveErr.human).title}

{t("set.notSaved")}

)}
{tabs.map((c) => ( ))}
{searching ? ( <> {curatedHits.length + collectionHits.length + rawHits.length === 0 &&

{t("all.none")}

}
{curatedHits.map(rowOf)}
{collectionHits.length > 0 && } {rawHits.length > SHOWN &&

{t("all.count", { shown: SHOWN, total: rawHits.length })}

} ) : category === "@collections" ? ( <>

{t("col.intro")}

) : category === "@all" ? ( <>

{t("all.intro")}

{raw === null ?

{t("set.loading")}

: } {rawHits.length > SHOWN &&

{t("all.count", { shown: SHOWN, total: rawHits.length })}

} ) : ( <>
{basic.map(rowOf)}
{advanced.length > 0 && (
{/* A tab whose settings are all advanced has nothing else to show, so its settings are listed directly. */} {basic.length > 0 && ( )} {(showAdvanced || basic.length === 0) &&
{advanced.map(rowOf)}
}
)} )}
{view.unknown_keys > 0 && (

{t("set.unknownKept", { n: view.unknown_keys })}

)} {pending > 0 && (
{tn("set.unsaved", pending)}
)}
); }