tuimon 0.1.0

package/dist/encoder.js

@@ -0,0 +1,115 @@
+import sharp from 'sharp';
+const CHUNK_SIZE = 4096;
+const MAX_PALETTE_COLORS = 256;
+export async function encodeAndRender(buffer, opts) {
+    if (opts.protocol === 'kitty') {
+        renderKitty(buffer);
+    }
+    else {
+        await renderSixel(buffer);
+    }
+}
+function renderKitty(buffer) {
+    process.stdout.write('\x1b[H');
+    const b64 = buffer.toString('base64');
+    const chunks = [];
+    for (let i = 0; i < b64.length; i += CHUNK_SIZE) {
+        chunks.push(b64.slice(i, i + CHUNK_SIZE));
+    }
+    for (let i = 0; i < chunks.length; i++) {
+        const hasMore = i < chunks.length - 1;
+        if (i === 0) {
+            process.stdout.write(`\x1b_Ga=T,f=100,m=${hasMore ? 1 : 0};${chunks[i]}\x1b\\`);
+        }
+        else {
+            process.stdout.write(`\x1b_Gm=${hasMore ? 1 : 0};${chunks[i]}\x1b\\`);
+        }
+    }
+}
+async function renderSixel(buffer) {
+    process.stdout.write('\x1b[H');
+    let image;
+    try {
+        image = sharp(buffer);
+    }
+    catch (err) {
+        console.error('[tuimon] encoder: invalid image buffer', err);
+        return;
+    }
+    const meta = await image.metadata();
+    const width = meta.width ?? 1;
+    const height = meta.height ?? 1;
+    const { data, info } = await image
+        .raw()
+        .ensureAlpha()
+        .toBuffer({ resolveWithObject: true });
+    // Build color palette (up to 256 colors)
+    const colorMap = new Map();
+    let nextColor = 0;
+    let paletteOverflow = false;
+    const pixels = new Array(width * height);
+    for (let i = 0; i < width * height; i++) {
+        const offset = i * info.channels;
+        const r = data[offset] ?? 0;
+        const g = data[offset + 1] ?? 0;
+        const b = data[offset + 2] ?? 0;
+        const key = `${r},${g},${b}`;
+        if (!colorMap.has(key) && nextColor < MAX_PALETTE_COLORS) {
+            colorMap.set(key, nextColor++);
+        }
+        else if (!colorMap.has(key) && !paletteOverflow) {
+            paletteOverflow = true;
+            console.error(`[tuimon] sixel: image has >256 colors — some colors will be approximated`);
+        }
+        pixels[i] = colorMap.get(key) ?? 0;
+    }
+    // Write DCS header and raster attributes
+    process.stdout.write(`\x1bP0;0;0q"1;1;${width};${height}`);
+    // Write color definitions
+    for (const [key, idx] of colorMap.entries()) {
+        const parts = key.split(',').map(Number);
+        const r = parts[0] ?? 0;
+        const g = parts[1] ?? 0;
+        const b = parts[2] ?? 0;
+        const rp = Math.round((r / 255) * 100);
+        const gp = Math.round((g / 255) * 100);
+        const bp = Math.round((b / 255) * 100);
+        process.stdout.write(`#${idx};2;${rp};${gp};${bp}`);
+    }
+    // Write sixel rows in chunks (groups of 6 vertical pixels)
+    for (let y = 0; y < height; y += 6) {
+        const rowColors = new Map();
+        for (let x = 0; x < width; x++) {
+            const sixelByte = new Map();
+            for (let dy = 0; dy < 6; dy++) {
+                const py = y + dy;
+                if (py >= height)
+                    break;
+                const colorIdx = pixels[py * width + x] ?? 0;
+                sixelByte.set(colorIdx, (sixelByte.get(colorIdx) ?? 0) | (1 << dy));
+            }
+            for (const [colorIdx, bits] of sixelByte.entries()) {
+                if (!rowColors.has(colorIdx)) {
+                    rowColors.set(colorIdx, new Array(width).fill(0));
+                }
+                rowColors.get(colorIdx)[x] = bits;
+            }
+        }
+        let bandData = '';
+        let first = true;
+        for (const [colorIdx, row] of rowColors.entries()) {
+            if (!first)
+                bandData += '$';
+            first = false;
+            bandData += `#${colorIdx}`;
+            for (let x = 0; x < width; x++) {
+                bandData += String.fromCharCode(63 + (row[x] ?? 0));
+            }
+        }
+        bandData += '-';
+        process.stdout.write(bandData);
+    }
+    // String terminator
+    process.stdout.write('\x1b\\');
+}
+//# sourceMappingURL=encoder.js.map

package/dist/encoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoder.js","sourceRoot":"","sources":["../src/encoder.ts"],"names":[],"mappings":"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"}

package/dist/fkeybar.d.ts

@@ -0,0 +1,5 @@
+import type { FKeyMap, FKeyBarHandle } from './types.js';
+export declare function renderFKeyBar({ keys }: {
+    keys: FKeyMap;
+}): FKeyBarHandle;
+//# sourceMappingURL=fkeybar.d.ts.map

package/dist/fkeybar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fkeybar.d.ts","sourceRoot":"","sources":["../src/fkeybar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAkD9D,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,CAsDxE"}

package/dist/fkeybar.js

@@ -0,0 +1,89 @@
+const ALL_FKEYS = ['F1', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8', 'F9', 'F10', 'F11', 'F12'];
+const BG = '\x1b[48;5;236m';
+const CYAN = '\x1b[96m';
+const WHITE = '\x1b[97m';
+const RESET = '\x1b[0m';
+const HIDE_CURSOR = '\x1b[?25l';
+const SHOW_CURSOR = '\x1b[?25h';
+function buildBar(keys, cols) {
+    const segments = [];
+    for (const fk of ALL_FKEYS) {
+        const binding = keys[fk];
+        if (!binding)
+            continue;
+        segments.push(`${CYAN}${fk}${WHITE} ${binding.label}`);
+    }
+    // Build the full rendered line
+    let rendered = segments.join('  ');
+    // Calculate visible length (strip ANSI)
+    const visibleLength = rendered.replace(/\x1b\[[0-9;]*m/g, '').length;
+    if (visibleLength > cols) {
+        // Truncate: rebuild with fewer segments
+        rendered = '';
+        let currentLen = 0;
+        for (let i = 0; i < segments.length; i++) {
+            const segVisible = (segments[i] ?? '').replace(/\x1b\[[0-9;]*m/g, '').length;
+            const sepLen = rendered.length > 0 ? 2 : 0;
+            if (currentLen + segVisible + sepLen > cols)
+                break;
+            rendered += (rendered.length > 0 ? '  ' : '') + (segments[i] ?? '');
+            currentLen += segVisible + sepLen;
+        }
+    }
+    // Pad to full width
+    const finalVisible = rendered.replace(/\x1b\[[0-9;]*m/g, '').length;
+    const padding = Math.max(0, cols - finalVisible);
+    return `${BG}${rendered}${' '.repeat(padding)}${RESET}`;
+}
+function renderLine(content, rows) {
+    process.stdout.write(`\x1b[${rows};0H${content}`);
+}
+export function renderFKeyBar({ keys }) {
+    let currentKeys = keys;
+    let notifyTimer = null;
+    process.stdout.write(HIDE_CURSOR);
+    function draw() {
+        const cols = process.stdout.columns || 80;
+        const rows = process.stdout.rows || 24;
+        const bar = buildBar(currentKeys, cols);
+        renderLine(bar, rows);
+    }
+    function onResize() {
+        draw();
+    }
+    process.stdout.on('resize', onResize);
+    draw();
+    return {
+        setKeys(newKeys) {
+            currentKeys = newKeys;
+            if (notifyTimer) {
+                clearTimeout(notifyTimer);
+                notifyTimer = null;
+            }
+            draw();
+        },
+        notify(message, duration = 3000) {
+            const cols = process.stdout.columns || 80;
+            const rows = process.stdout.rows || 24;
+            const visible = message.slice(0, cols);
+            const padding = Math.max(0, cols - visible.length);
+            const line = `${BG}${WHITE}${visible}${' '.repeat(padding)}${RESET}`;
+            renderLine(line, rows);
+            if (notifyTimer)
+                clearTimeout(notifyTimer);
+            notifyTimer = setTimeout(() => {
+                notifyTimer = null;
+                draw();
+            }, duration);
+        },
+        stop() {
+            if (notifyTimer) {
+                clearTimeout(notifyTimer);
+                notifyTimer = null;
+            }
+            process.stdout.removeListener('resize', onResize);
+            process.stdout.write(SHOW_CURSOR);
+        },
+    };
+}
+//# sourceMappingURL=fkeybar.js.map

package/dist/fkeybar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fkeybar.js","sourceRoot":"","sources":["../src/fkeybar.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { TuiMonOptions, TuiMonDashboard } from './types.js';
+declare function start(options: TuiMonOptions): Promise<TuiMonDashboard>;
+declare const _default: {
+    start: typeof start;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAEhB,MAAM,YAAY,CAAA;AAWnB,iBAAe,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CA2KrE;;;;AAED,wBAAwB"}

package/dist/index.js

@@ -0,0 +1,166 @@
+import path from 'node:path';
+import { detectGraphicsSupport, getTerminalDimensions } from './detect.js';
+import { startServer } from './server.js';
+import { createBrowser } from './browser.js';
+import { encodeAndRender } from './encoder.js';
+import { startKeyHandler } from './keyhandler.js';
+import { renderFKeyBar } from './fkeybar.js';
+import { createRouter } from './router.js';
+const MAX_REFRESH_FAILURES = 5;
+async function start(options) {
+    const { pages } = options;
+    const renderDelay = options.renderDelay ?? 50;
+    // Validate pages is not empty
+    const pageEntries = Object.entries(pages);
+    if (pageEntries.length === 0) {
+        throw new Error('[tuimon] At least one page must be defined');
+    }
+    // Detect terminal capabilities
+    const graphics = await detectGraphicsSupport();
+    const dims = await getTerminalDimensions();
+    if (!graphics.protocol) {
+        console.error('[tuimon] No supported graphics protocol detected. Falling back to kitty.');
+    }
+    // iterm2 uses kitty-compatible rendering for our purposes
+    const protocol = (graphics.protocol === 'sixel') ? 'sixel' : 'kitty';
+    // Resolve all page html paths and find common root
+    const resolvedPages = new Map();
+    const allDirs = [];
+    for (const [id, page] of pageEntries) {
+        const resolved = path.resolve(process.cwd(), page.html);
+        resolvedPages.set(id, resolved);
+        allDirs.push(path.dirname(resolved));
+    }
+    // Find common parent directory
+    let rootDir = allDirs[0] ?? process.cwd();
+    if (allDirs.length > 1) {
+        const parts = rootDir.split(path.sep);
+        for (const dir of allDirs) {
+            const dirParts = dir.split(path.sep);
+            let common = 0;
+            while (common < parts.length && common < dirParts.length && parts[common] === dirParts[common]) {
+                common++;
+            }
+            parts.length = common;
+        }
+        rootDir = parts.join(path.sep) || '/';
+    }
+    // Start server
+    const server = await startServer({ rootDir });
+    // Calculate viewport dimensions (reserve 1 row for F-key bar)
+    const cellPixelHeight = Math.floor(dims.pixelHeight / dims.rows);
+    const viewportHeight = dims.pixelHeight - cellPixelHeight;
+    const viewportWidth = dims.pixelWidth;
+    // Start browser
+    const browser = await createBrowser({
+        url: server.url,
+        width: viewportWidth,
+        height: viewportHeight,
+    });
+    // Enter alt screen + hide cursor
+    process.stdout.write('\x1b[?1049h\x1b[?25l');
+    // Track last data for re-rendering after navigation
+    let lastData = {};
+    let refreshInterval;
+    let stopped = false;
+    let rendering = false;
+    // Render function with concurrency guard
+    async function renderFrame(data) {
+        if (stopped || rendering)
+            return;
+        rendering = true;
+        try {
+            if (data)
+                lastData = data;
+            await browser.pushData(lastData);
+            await new Promise((resolve) => setTimeout(resolve, renderDelay));
+            const screenshot = await browser.screenshot();
+            await encodeAndRender(screenshot, { protocol });
+        }
+        finally {
+            rendering = false;
+        }
+    }
+    // F-key bar
+    const defaultPageId = pageEntries.find(([, p]) => p.default)?.[0] ?? pageEntries[0][0];
+    const defaultPage = pages[defaultPageId];
+    const fkeyBar = renderFKeyBar({ keys: defaultPage.keys ?? {} });
+    // Router navigate helper
+    async function navigateToPage(htmlPath) {
+        // Internal paths (e.g., /tuimon/confirm-quit.html) are served as-is
+        // Page paths are resolved to their filename
+        const url = htmlPath.startsWith('/tuimon/')
+            ? `${server.url}${htmlPath}`
+            : server.urlFor(path.basename(htmlPath));
+        await browser.navigate(url);
+    }
+    // Router
+    const router = createRouter({
+        pages,
+        navigate: navigateToPage,
+        render: async () => { await renderFrame(); },
+        setKeys: (keys) => { fkeyBar.setKeys(keys); },
+        confirmQuitHtml: '/tuimon/confirm-quit.html',
+    });
+    // Key handler — catch unhandled rejections from handleKey
+    const keyHandler = startKeyHandler({
+        onKey: (key) => {
+            router.handleKey(key).catch((err) => {
+                console.error('[tuimon] key handler error:', err);
+            });
+        },
+    });
+    // Auto-refresh with circuit breaker
+    if (options.refresh && options.data) {
+        const dataFn = options.data;
+        let consecutiveFailures = 0;
+        refreshInterval = setInterval(async () => {
+            try {
+                const data = await dataFn();
+                await renderFrame(data);
+                consecutiveFailures = 0;
+            }
+            catch (err) {
+                consecutiveFailures++;
+                console.error('[tuimon] refresh error:', err);
+                if (consecutiveFailures >= MAX_REFRESH_FAILURES) {
+                    console.error(`[tuimon] ${MAX_REFRESH_FAILURES} consecutive refresh failures — disabling auto-refresh`);
+                    if (refreshInterval)
+                        clearInterval(refreshInterval);
+                }
+            }
+        }, options.refresh);
+        refreshInterval.unref();
+    }
+    // Navigate to the default page
+    const defaultHtml = defaultPage.html;
+    const defaultFilename = path.basename(path.resolve(process.cwd(), defaultHtml));
+    await browser.navigate(server.urlFor(defaultFilename));
+    // Stop function
+    async function stop() {
+        if (stopped)
+            return;
+        stopped = true;
+        if (refreshInterval)
+            clearInterval(refreshInterval);
+        keyHandler.stop();
+        fkeyBar.stop();
+        await browser.close();
+        await server.close();
+        // Restore terminal: show cursor + exit alt screen
+        process.stdout.write('\x1b[?25h\x1b[?1049l');
+    }
+    // Await stop on SIGINT to ensure cleanup completes
+    process.once('SIGINT', () => {
+        stop().catch((err) => {
+            console.error('[tuimon] shutdown error:', err);
+            process.exit(1);
+        });
+    });
+    return {
+        render: async (data) => { await renderFrame(data); },
+        stop,
+    };
+}
+export default { start };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/keyhandler.d.ts

@@ -0,0 +1,5 @@
+import type { KeyHandlerHandle } from './types.js';
+export declare function startKeyHandler({ onKey }: {
+    onKey: (key: string) => void;
+}): KeyHandlerHandle;
+//# sourceMappingURL=keyhandler.d.ts.map

package/dist/keyhandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyhandler.d.ts","sourceRoot":"","sources":["../src/keyhandler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAAG,gBAAgB,CAoB7F"}

package/dist/keyhandler.js

@@ -0,0 +1,20 @@
+export function startKeyHandler({ onKey }) {
+    const onData = (buffer) => {
+        onKey(buffer.toString());
+    };
+    if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    process.stdin.on('data', onData);
+    return {
+        stop() {
+            process.stdin.removeListener('data', onData);
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(false);
+            }
+            process.stdin.pause();
+        },
+    };
+}
+//# sourceMappingURL=keyhandler.js.map

package/dist/keyhandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyhandler.js","sourceRoot":"","sources":["../src/keyhandler.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,EAAE,KAAK,EAAoC;IACzE,MAAM,MAAM,GAAG,CAAC,MAAc,EAAQ,EAAE;QACtC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC1B,CAAC,CAAA;IAED,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAEhC,OAAO;QACL,IAAI;YACF,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YAC5C,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;YACjC,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QACvB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,10 @@
+import type { PageMap, FKeyMap, RouterHandle } from './types.js';
+export interface RouterDeps {
+    pages: PageMap;
+    navigate: (url: string) => Promise<void>;
+    render: (data?: Record<string, unknown>) => Promise<void>;
+    setKeys: (keys: FKeyMap) => void;
+    confirmQuitHtml: string;
+}
+export declare function createRouter(deps: RouterDeps): RouterHandle;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAa,OAAO,EAAQ,YAAY,EAAE,MAAM,YAAY,CAAA;AAEjF,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAChC,eAAe,EAAE,MAAM,CAAA;CACxB;AA0BD,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAsK3D"}

package/dist/router.js

@@ -0,0 +1,154 @@
+// ─── Key sequence → FKey mapping ─────────────────────────────────────────────
+const SEQ_TO_FKEY = {
+    '\x1bOP': 'F1', '\x1b[11~': 'F1',
+    '\x1bOQ': 'F2', '\x1b[12~': 'F2',
+    '\x1bOR': 'F3', '\x1b[13~': 'F3',
+    '\x1bOS': 'F4', '\x1b[14~': 'F4',
+    '\x1b[15~': 'F5',
+    '\x1b[17~': 'F6',
+    '\x1b[18~': 'F7',
+    '\x1b[19~': 'F8',
+    '\x1b[20~': 'F9',
+    '\x1b[21~': 'F10',
+    '\x1b[23~': 'F11',
+    '\x1b[24~': 'F12',
+};
+const RESERVED_SHORTCUTS = new Set(['y', 'n', '\x1b', '\x03']);
+const ESC = '\x1b';
+const CTRL_C = '\x03';
+// ─── createRouter ────────────────────────────────────────────────────────────
+export function createRouter(deps) {
+    const { pages, navigate, render, setKeys, confirmQuitHtml } = deps;
+    // ── Validation ──────────────────────────────────────────────────────────
+    // Exactly one default page
+    const defaultEntries = Object.entries(pages).filter(([, cfg]) => cfg.default);
+    if (defaultEntries.length !== 1) {
+        throw new Error(`Exactly one page must have default: true, found ${defaultEntries.length}`);
+    }
+    const [defaultPageId, defaultPageConfig] = defaultEntries[0];
+    // Shortcut uniqueness and reserved check
+    const seenShortcuts = new Map();
+    for (const [id, cfg] of Object.entries(pages)) {
+        if (cfg.shortcut != null) {
+            if (RESERVED_SHORTCUTS.has(cfg.shortcut)) {
+                throw new Error(`Page "${id}" uses reserved shortcut '${cfg.shortcut}'`);
+            }
+            if (seenShortcuts.has(cfg.shortcut)) {
+                throw new Error(`Duplicate shortcut '${cfg.shortcut}' on pages "${seenShortcuts.get(cfg.shortcut)}" and "${id}"`);
+            }
+            seenShortcuts.set(cfg.shortcut, id);
+        }
+        // Warn if ESC or Ctrl+C defined in page keys
+        if (cfg.keys) {
+            for (const key of Object.keys(cfg.keys)) {
+                if (key === 'ESC' || key === 'Escape' || key === CTRL_C) {
+                    console.warn(`[tuimon] Page "${id}" defines reserved key "${key}" in its key map — it will be ignored`);
+                }
+            }
+        }
+    }
+    // ── Shortcut → pageId lookup ────────────────────────────────────────────
+    const shortcutToPageId = new Map();
+    for (const [id, cfg] of Object.entries(pages)) {
+        if (cfg.shortcut) {
+            shortcutToPageId.set(cfg.shortcut, id);
+        }
+    }
+    // ── State ───────────────────────────────────────────────────────────────
+    let state = { type: 'overview', pageId: defaultPageId };
+    // Set initial keys
+    setKeys(defaultPageConfig.keys ?? {});
+    // ── Confirm-quit keys ───────────────────────────────────────────────────
+    const confirmQuitKeys = {};
+    // ── Helpers ─────────────────────────────────────────────────────────────
+    function getPageKeys(pageId) {
+        return pages[pageId]?.keys ?? {};
+    }
+    function getPageHtml(pageId) {
+        const page = pages[pageId];
+        if (!page)
+            throw new Error(`[tuimon] Unknown page: "${pageId}"`);
+        return page.html;
+    }
+    async function goToPage(pageState) {
+        state = pageState;
+        const pageId = pageState.type === 'confirm-quit'
+            ? null
+            : pageState.pageId;
+        if (pageState.type === 'confirm-quit') {
+            await navigate(confirmQuitHtml);
+            setKeys(confirmQuitKeys);
+        }
+        else {
+            await navigate(getPageHtml(pageId));
+            setKeys(getPageKeys(pageId));
+            await render();
+        }
+    }
+    // ── handleKey ───────────────────────────────────────────────────────────
+    async function handleKey(key) {
+        // Ctrl+C always exits immediately
+        if (key === CTRL_C) {
+            process.exit(0);
+            return;
+        }
+        // ── confirm-quit state ────────────────────────────────────────────────
+        if (state.type === 'confirm-quit') {
+            const lower = key.toLowerCase();
+            if (lower === 'y') {
+                process.exit(0);
+                return;
+            }
+            if (lower === 'n' || key === ESC) {
+                await goToPage(state.returnTo);
+                return;
+            }
+            // Ignore everything else (including F-keys) on confirm-quit
+            return;
+        }
+        // ── Check for F-key sequences ─────────────────────────────────────────
+        const fkey = SEQ_TO_FKEY[key];
+        if (fkey) {
+            const currentPageId = state.pageId;
+            const binding = getPageKeys(currentPageId)[fkey];
+            if (binding) {
+                try {
+                    await Promise.resolve(binding.action());
+                }
+                catch (err) {
+                    console.error('[tuimon]', err);
+                }
+            }
+            return;
+        }
+        // ── ESC ───────────────────────────────────────────────────────────────
+        if (key === ESC) {
+            if (state.type === 'detail') {
+                // Back to overview
+                await goToPage({ type: 'overview', pageId: defaultPageId });
+            }
+            else if (state.type === 'overview') {
+                // Show confirm-quit
+                const returnTo = { ...state };
+                state = { type: 'confirm-quit', returnTo };
+                await navigate(confirmQuitHtml);
+                setKeys(confirmQuitKeys);
+            }
+            return;
+        }
+        // ── Shortcut keys (only from overview) ────────────────────────────────
+        if (state.type === 'overview') {
+            const targetPageId = shortcutToPageId.get(key);
+            if (targetPageId) {
+                await goToPage({ type: 'detail', pageId: targetPageId });
+            }
+        }
+        // detail state ignores shortcut keys — no action needed
+    }
+    // ── Public API ──────────────────────────────────────────────────────────
+    return {
+        handleKey,
+        getState: () => state,
+    };
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+import type { ServerHandle } from './types.js';
+export declare function startServer({ rootDir }: {
+    rootDir: string;
+}): Promise<ServerHandle>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAqI9C,wBAAsB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAgCzF"}