/**
* Session Options structural guard.
*
* The modal shares the `set-*` settings surface with App Settings, but its rail
* is a real switcher: switchOptionsTab shows one `.set-section` and hides the
* rest. Like App Settings, its load/save path is `getElementById` by a fixed set
* of ids, so dropping or renaming an element in the markup fails silently — the
* option just stops loading, or stops being written back.
*
* These tests read the REAL session-ui.js and index.html and pin that contract.
*/
import { describe, it, expect } from 'vitest';
import { readFileSync } from 'node:fs';
import { resolve } from 'node:path';
const publicDir = resolve(import.meta.dirname, '../src/web/public');
const html = readFileSync(resolve(publicDir, 'index.html'), 'utf8');
const sessionUi = readFileSync(resolve(publicDir, 'session-ui.js'), 'utf8');
const styles = readFileSync(resolve(publicDir, 'styles.css'), 'utf8');
/** The Session Options markup, so assertions can't be satisfied elsewhere. */
function optionsModal(): string {
const start = html.indexOf('
');
expect(start).toBeGreaterThan(-1);
const end = html.indexOf('', start);
expect(end).toBeGreaterThan(start);
return html.slice(start, end);
}
/** Body of a session-ui.js method, by name. */
function methodBody(signature: string): string {
const start = sessionUi.indexOf(`\n ${signature} {`);
expect(start, `${signature} not found in session-ui.js`).toBeGreaterThan(-1);
return sessionUi.slice(start, sessionUi.indexOf('\n },', start));
}
const TABS = ['respawn', 'context', 'ralph', 'summary'];
describe('Session Options modal structure', () => {
it('keeps every element openSessionOptions and switchOptionsTab touch by id', () => {
const modal = optionsModal();
const ids = new Set();
for (const sig of ['openSessionOptions(sessionId)', 'switchOptionsTab(tabName)', 'getRalphConfig()']) {
for (const m of methodBody(sig).matchAll(/getElementById\('([A-Za-z0-9_-]+)'\)/g)) ids.add(m[1]);
}
// openSessionOptions also drives elements outside this modal (tabs, toasts);
// only the ones it expects to find in here are this file's contract.
const outside = new Set(['sessionOptionsDoc']);
const missing = [...ids].filter((id) => !outside.has(id) && !modal.includes(`id="${id}"`));
expect(missing).toEqual([]);
expect(modal).toContain('id="sessionOptionsDoc"');
});
it('pairs each rail entry with exactly one section, in the same order', () => {
const modal = optionsModal();
const rail = [...modal.matchAll(/class="set-rail-item[^"]*" data-tab="([a-z]+)"/g)].map((m) => m[1]);
expect(rail).toEqual(TABS);
for (const tab of TABS) {
const hits = modal.split(`id="${tab}-tab"`).length - 1;
expect(hits, `section ${tab}-tab should exist exactly once`).toBe(1);
}
// switchOptionsTab queries the rail by THIS class; `.modal-tab-btn` here
// would silently stop the active marker from moving.
expect(methodBody('switchOptionsTab(tabName)')).toContain("'#sessionOptionsModal .set-rail-item'");
expect(methodBody('openSessionOptions(sessionId)')).toContain('.set-rail-item[data-tab="ralph"]');
});
it('opens with exactly one section visible, the rest hidden', () => {
const modal = optionsModal();
const visible = TABS.filter((t) => modal.includes(` t !== 'respawn')) {
expect(modal).toContain(` {
const modal = optionsModal();
for (const tab of ['respawn', 'ralph']) {
const entry = modal.match(new RegExp(`