silvermoon 0.3.0-rc.2 → 0.4.0

package/dist/src/foundation/trace/trace.js

@@ -0,0 +1,299 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { createHash, randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { access, lstat, open } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+export const TRACE_SCHEMA_VERSION = 2;
+const traceContext = new AsyncLocalStorage();
+function durationMilliseconds(started) {
+    return Math.round(Number(process.hrtime.bigint() - started) / 1_000) / 1_000;
+}
+function errorName(caught) {
+    return caught instanceof Error ? caught.name : typeof caught;
+}
+class Trace {
+    events;
+    nextSequence;
+    nextSpanId;
+    traceId;
+    constructor() {
+        this.events = [];
+        this.nextSequence = 1;
+        this.nextSpanId = 1;
+        this.traceId = randomUUID();
+    }
+    emit(event) {
+        this.events.push({
+            schemaVersion: TRACE_SCHEMA_VERSION,
+            traceId: this.traceId,
+            sequence: this.nextSequence,
+            timestamp: new Date().toISOString(),
+            ...event,
+        });
+        this.nextSequence += 1;
+    }
+    start(name, parentSpanId, attributes) {
+        const span = {
+            attributes,
+            id: String(this.nextSpanId),
+            name,
+            parentSpanId,
+            started: process.hrtime.bigint(),
+        };
+        this.nextSpanId += 1;
+        this.emit({
+            channel: "telemetry",
+            event: "span-start",
+            spanId: span.id,
+            parentSpanId,
+            name,
+            attributes,
+        });
+        return span;
+    }
+    end(span, status, attributes = {}) {
+        this.emit({
+            channel: "telemetry",
+            event: "span-end",
+            spanId: span.id,
+            parentSpanId: span.parentSpanId,
+            name: span.name,
+            status,
+            durationMs: durationMilliseconds(span.started),
+            attributes: { ...span.attributes, ...attributes },
+        });
+    }
+    serialize() {
+        return `${this.events.map((event) => JSON.stringify(event)).join("\n")}\n`;
+    }
+}
+async function requireAvailableTracePath(path) {
+    const parent = dirname(path);
+    const parentMetadata = await lstat(parent);
+    if (!parentMetadata.isDirectory()) {
+        throw new Error(`Trace parent is not a directory: ${parent}`);
+    }
+    await access(parent, constants.W_OK);
+    try {
+        await lstat(path);
+    }
+    catch (caught) {
+        if (caught instanceof Error && "code" in caught && caught.code === "ENOENT")
+            return;
+        throw caught;
+    }
+    throw new Error(`Trace file already exists: ${path}`);
+}
+async function traceAsyncLegacy(name, attributes, callback, summarize = () => ({})) {
+    const context = traceContext.getStore();
+    if (!context)
+        return callback();
+    const span = context.trace.start(name, context.parentSpanId, attributes);
+    return traceContext.run({ parentSpanId: span.id, trace: context.trace }, async () => {
+        try {
+            const result = await callback();
+            const summary = summarize(result);
+            context.trace.end(span, summary.status ?? "ok", summary.attributes ?? {});
+            return result;
+        }
+        catch (caught) {
+            context.trace.end(span, "error", { errorName: errorName(caught) });
+            throw caught;
+        }
+    });
+}
+export async function traceAsync(name, attributes, callback, summarize = () => ({})) {
+    const context = traceContext.getStore();
+    if (!context)
+        return callback();
+    const span = context.trace.start(name, context.parentSpanId, attributes);
+    return traceContext.run({ parentSpanId: span.id, trace: context.trace }, async () => {
+        try {
+            const result = await callback();
+            const summary = summarize(result);
+            context.trace.end(span, summary.status ?? "ok", summary.attributes ?? {});
+            return result;
+        }
+        catch (caught) {
+            context.trace.end(span, "error", { errorName: errorName(caught) });
+            throw caught;
+        }
+    });
+}
+function hash(value) {
+    return createHash("sha256")
+        .update(JSON.stringify(value))
+        .digest("hex");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function projectDomainMessage(message) {
+    const base = {
+        channel: "domain",
+        event: message.type,
+        messageSequence: message.sequence,
+    };
+    if (message.type === "intention.accepted") {
+        if (!isRecord(message.intention))
+            throw new TypeError("Invalid traced intention");
+        return {
+            ...base,
+            command: message.intention.command,
+            argumentNames: Object.keys(message.intention.args ?? {}).sort(),
+            intentionHash: hash(message.intention),
+        };
+    }
+    if (message.type === "observation.fact") {
+        if (!isRecord(message.fact) || !isRecord(message.fact.observation)) {
+            throw new TypeError("Invalid traced observation fact");
+        }
+        const observation = message.fact.observation;
+        const problems = Array.isArray(observation.problems) ? observation.problems : [];
+        const selectedIdea = isRecord(observation.selectedIdea) ? observation.selectedIdea : undefined;
+        const createdIdea = isRecord(observation.createdIdea) ? observation.createdIdea : undefined;
+        return {
+            ...base,
+            factType: message.fact.type,
+            progress: message.fact.progress,
+            state: observation.state,
+            problemCount: problems.length,
+            problemTypes: problems.map((problem) => isRecord(problem) ? problem.type : undefined),
+            ...(selectedIdea?.id === undefined
+                ? {}
+                : { selectedIdeaId: selectedIdea.id }),
+            ...(createdIdea?.id === undefined
+                ? {}
+                : { createdIdeaId: createdIdea.id }),
+        };
+    }
+    if (message.type === "action.requested") {
+        if (!isRecord(message.action))
+            throw new TypeError("Invalid traced action");
+        return {
+            ...base,
+            actionId: message.actionId,
+            actionType: message.action.type,
+        };
+    }
+    if (message.type === "action.finished") {
+        const problem = isRecord(message.problem) ? message.problem : undefined;
+        const result = isRecord(message.result) ? message.result : {};
+        return {
+            ...base,
+            actionId: message.actionId,
+            actionType: message.actionType,
+            status: message.status,
+            ...(problem?.type === undefined
+                ? {}
+                : { problemType: problem.type }),
+            resultFields: Object.keys(result).sort(),
+        };
+    }
+    if (message.type === "response.created") {
+        if (!isRecord(message.metadata))
+            throw new TypeError("Invalid traced response metadata");
+        return {
+            ...base,
+            kind: message.kind,
+            responseHash: message.metadata.hash,
+            nextStepCount: message.metadata.nextStepCount,
+            itemCount: message.metadata.itemCount,
+        };
+    }
+    throw new Error(`Cannot trace unknown domain message type: ${message.type}`);
+}
+export function emitDomainMessage(message) {
+    const context = traceContext.getStore();
+    if (!context)
+        return;
+    if (!isRecord(message))
+        throw new TypeError("Invalid traced domain message");
+    context.trace.emit(projectDomainMessage(message));
+}
+export function traceSync(name, attributes, callback, summarize = () => ({})) {
+    const context = traceContext.getStore();
+    if (!context)
+        return callback();
+    const span = context.trace.start(name, context.parentSpanId, attributes);
+    return traceContext.run({ parentSpanId: span.id, trace: context.trace }, () => {
+        try {
+            const result = callback();
+            const summary = summarize(result);
+            context.trace.end(span, summary.status ?? "ok", summary.attributes ?? {});
+            return result;
+        }
+        catch (caught) {
+            context.trace.end(span, "error", { errorName: errorName(caught) });
+            throw caught;
+        }
+    });
+}
+async function flushTrace(path, trace) {
+    const span = trace.start("trace.flush", null, {});
+    let handle;
+    let failure;
+    let spanEnded = false;
+    try {
+        handle = await open(path, "wx");
+        await handle.writeFile(trace.serialize(), { encoding: "utf8" });
+        await handle.sync();
+        trace.end(span, "ok", { eventCount: trace.events.length + 1 });
+        spanEnded = true;
+        await handle.appendFile(`${JSON.stringify(trace.events.at(-1))}\n`, { encoding: "utf8" });
+        await handle.sync();
+    }
+    catch (caught) {
+        if (!spanEnded) {
+            trace.end(span, "error", { errorName: errorName(caught) });
+        }
+        failure = caught;
+    }
+    if (handle) {
+        try {
+            await handle.close();
+        }
+        catch (caught) {
+            failure = failure
+                ? new AggregateError([failure, caught], `Cannot close trace file: ${path}`)
+                : caught;
+        }
+    }
+    if (failure)
+        throw failure;
+}
+export async function withTraceFile(file, name, attributes, callback) {
+    if (file === undefined)
+        return callback();
+    const path = resolve(file);
+    await requireAvailableTracePath(path);
+    const trace = new Trace();
+    let outcome;
+    try {
+        const value = await traceContext.run({ parentSpanId: null, trace }, () => traceAsync(name, attributes, callback));
+        outcome = { ok: true, value };
+    }
+    catch (caught) {
+        outcome = { ok: false, error: caught };
+    }
+    let traceError;
+    try {
+        await flushTrace(path, trace);
+    }
+    catch (caught) {
+        traceError = caught;
+    }
+    if (!outcome.ok && traceError) {
+        throw new AggregateError([outcome.error, traceError], `Command failed and trace file could not be written: ${path}`);
+    }
+    if (!outcome.ok)
+        throw outcome.error;
+    if (traceError) {
+        const message = traceError instanceof Error ? traceError.message : String(traceError);
+        throw new Error(`Cannot write trace file ${path}: ${message}`, {
+            cause: traceError,
+        });
+    }
+    return outcome.value;
+}
+//# sourceMappingURL=trace.js.map

package/dist/src/foundation/trace/trace.js.map

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

package/dist/src/foundation/tui/index.d.ts

@@ -0,0 +1,3 @@
+export { tuiMarkdownBlocks, } from "./table.ts";
+export { copyStatusColor, copyTuiSelection, copyWindowsClipboard, renderTuiMarkdown, tuiOutputStream, } from "./tui.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/foundation/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/foundation/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/src/foundation/tui/index.js

@@ -0,0 +1,3 @@
+export { tuiMarkdownBlocks, } from "./table.js";
+export { copyStatusColor, copyTuiSelection, copyWindowsClipboard, renderTuiMarkdown, tuiOutputStream, } from "./tui.js";
+//# sourceMappingURL=index.js.map

package/dist/src/foundation/tui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/foundation/tui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/src/foundation/tui/table.d.ts

@@ -0,0 +1,10 @@
+export type TuiMarkdownBlock = {
+    kind: "markdown";
+    content: string;
+} | {
+    kind: "table";
+    lines: string[];
+    width: number;
+};
+export declare function tuiMarkdownBlocks(content: string, availableWidth: number): TuiMarkdownBlock[];
+//# sourceMappingURL=table.d.ts.map

package/dist/src/foundation/tui/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/foundation/tui/table.ts"],"names":[],"mappings":"AAoBA,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAuEtD,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,gBAAgB,EAAE,CAgCpB"}

package/dist/src/foundation/tui/table.js

@@ -0,0 +1,91 @@
+import stringWidth from "string-width";
+import { parse } from "tui-md";
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isMarkdownNode(value) {
+    return isRecord(value)
+        && typeof value.type === "string"
+        && (value.children === undefined
+            || (Array.isArray(value.children) && value.children.every(isMarkdownNode)));
+}
+function isTableNode(value) {
+    return isMarkdownNode(value)
+        && value.type === "table"
+        && Array.isArray(value.children)
+        && value.children.every((row) => isRecord(row)
+            && Array.isArray(row.children)
+            && row.children.every((cell) => isRecord(cell)
+                && Array.isArray(cell.children)
+                && cell.children.every(isMarkdownNode)));
+}
+function cellText(node) {
+    if (node.type === "image")
+        return node.alt ?? "";
+    if (typeof node.value === "string")
+        return node.value;
+    return node.children?.map(cellText).join("") ?? "";
+}
+function terminalCellText(node) {
+    return cellText(node).replaceAll("\t", "    ");
+}
+function tableLines(node) {
+    const rows = node.children.map((row) => row.children.map((cell) => cell.children.map(terminalCellText).join("")));
+    const firstRow = rows[0] ?? [];
+    const widths = firstRow.map((_, column) => Math.max(3, ...rows.map((row) => stringWidth(row[column] ?? "") + 2)));
+    const border = (left, middle, right) => `${left}${widths.map((width) => "─".repeat(width)).join(middle)}${right}`;
+    const rowLine = (row) => `│${widths.map((width, column) => {
+        const value = row[column] ?? "";
+        const space = width - 2 - stringWidth(value);
+        const alignment = node.align?.[column];
+        const left = alignment === "right"
+            ? space
+            : alignment === "center" ? Math.floor(space / 2) : 0;
+        return ` ${" ".repeat(left)}${value}${" ".repeat(space - left)} │`;
+    }).join("")}`;
+    const lines = [
+        border("┌", "┬", "┐"),
+        rowLine(firstRow),
+        border("├", "┼", "┤"),
+    ];
+    for (const [index, row] of rows.slice(1).entries()) {
+        if (index > 0)
+            lines.push(border("├", "┼", "┤"));
+        lines.push(rowLine(row));
+    }
+    lines.push(border("└", "┴", "┘"));
+    return { lines, width: stringWidth(lines[0] ?? "") };
+}
+export function tuiMarkdownBlocks(content, availableWidth) {
+    if (!content.includes("|"))
+        return [{ kind: "markdown", content }];
+    const blocks = [];
+    let offset = 0;
+    for (const node of parse(content).children) {
+        if (!isTableNode(node))
+            continue;
+        if (!node.children.every((row) => row.children.every((cell) => cell.children.every((child) => child.type === "text"))))
+            continue;
+        const table = tableLines(node);
+        const hasWideText = node.children.some((row) => row.children.some((cell) => {
+            const text = cell.children.map(terminalCellText).join("");
+            return stringWidth(text) > text.length;
+        }));
+        if (!hasWideText || table.width > availableWidth)
+            continue;
+        const start = node.position?.start.offset;
+        const end = node.position?.end.offset;
+        if (start === undefined || end === undefined)
+            continue;
+        if (start > offset) {
+            blocks.push({ kind: "markdown", content: content.slice(offset, start) });
+        }
+        blocks.push({ kind: "table", lines: table.lines, width: table.width });
+        offset = end;
+    }
+    if (offset < content.length) {
+        blocks.push({ kind: "markdown", content: content.slice(offset) });
+    }
+    return blocks.length === 0 ? [{ kind: "markdown", content }] : blocks;
+}
+//# sourceMappingURL=table.js.map

package/dist/src/foundation/tui/table.js.map

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

package/dist/src/foundation/tui/tui.d.ts

@@ -0,0 +1,33 @@
+import type { SpawnSyncOptionsWithStringEncoding, SpawnSyncReturns } from "node:child_process";
+export declare function copyStatusColor(status: {
+    kind: unknown;
+} | null): "#9ccb9e" | "#e2b86b" | "#6b6b6b";
+export declare function copyWindowsClipboard(text: string, spawn?: (command: string, args: readonly string[], options: SpawnSyncOptionsWithStringEncoding) => SpawnSyncReturns<string>, systemRoot?: string | undefined): {
+    ok: boolean;
+    reason: string;
+} | {
+    ok: boolean;
+    reason?: never;
+};
+interface SelectionRenderer {
+    getSelection(): {
+        getSelectedText(): string;
+    } | null;
+    copyToClipboardOSC52(text: string): boolean;
+}
+interface CopyStatus {
+    kind: "success" | "warning";
+    message: string;
+}
+export declare function copyTuiSelection(renderer: SelectionRenderer, { stdout, platform, windowsClipboard, }?: {
+    stdout?: NodeJS.WriteStream | object;
+    platform?: NodeJS.Platform;
+    windowsClipboard?: typeof copyWindowsClipboard;
+}): CopyStatus;
+export declare function tuiOutputStream(stdout: NodeJS.WriteStream, platform?: NodeJS.Platform): NodeJS.WriteStream;
+export declare function renderTuiMarkdown(content: string, { stdin, stdout }: {
+    stdin: NodeJS.ReadStream;
+    stdout: NodeJS.WriteStream;
+}): Promise<void>;
+export {};
+//# sourceMappingURL=tui.d.ts.map

package/dist/src/foundation/tui/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../../../src/foundation/tui/tui.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,kCAAkC,EAClC,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAa5B,wBAAgB,eAAe,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;CAAE,GAAC,IAAI,qCAK9D;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,CACL,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,kCAAkC,KACxC,gBAAgB,CAAC,MAAM,CAAkB,EAC9C,UAAU,qBAAyB;;;;;;EA4BpC;AAED,UAAU,iBAAiB;IACzB,YAAY,IAAI;QAAE,eAAe,IAAI,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrD,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,EAC5D,MAAuB,EACvB,QAA2B,EAC3B,gBAAuC,GACxC,GAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,gBAAgB,CAAC,EAAE,OAAO,oBAAoB,CAAC;CAC3C,GAAG,UAAU,CAalB;AAiGD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,QAAQ,kBAAmB,sBAWtF;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAA;CAAE,iBAiB5E"}

package/dist/src/foundation/tui/tui.js

@@ -0,0 +1,157 @@
+import { createCliRenderer } from "@opentui/core";
+import { win32 } from "node:path";
+import { createRoot, useKeyboard, useRenderer, useTerminalDimensions, } from "@opentui/react";
+import { createElement, useEffect, useMemo, useRef, useState } from "react";
+import { Markdown } from "tui-md";
+import { runSubprocess } from "../process/index.js";
+import { tuiMarkdownBlocks } from "./table.js";
+const COPY_STATUS_DURATION_MS = 3000;
+const SHORTCUT_HINT = "  [q/Esc] quit  [scroll] navigate  [drag, y] copy";
+const SUCCESS_COLOR = "#9ccb9e";
+const WARNING_COLOR = "#e2b86b";
+function spawnClipboard(command, args, options) {
+    return runSubprocess(command, args, options, {
+        attributes: { operation: "windows-clipboard" },
+    });
+}
+export function copyStatusColor(status) {
+    if (status === null)
+        return "#6b6b6b";
+    if (status.kind === "success")
+        return SUCCESS_COLOR;
+    if (status.kind === "warning")
+        return WARNING_COLOR;
+    throw new Error(`Unsupported copy status kind: ${status.kind}`);
+}
+export function copyWindowsClipboard(text, spawn = spawnClipboard, systemRoot = process.env.SystemRoot) {
+    if (!systemRoot)
+        return { ok: false, reason: "SystemRoot is unavailable" };
+    const script = [
+        "$ErrorActionPreference = 'Stop'",
+        "[Console]::InputEncoding = New-Object System.Text.UTF8Encoding($false)",
+        "$value = [Console]::In.ReadToEnd()",
+        "Set-Clipboard -Value $value",
+    ].join("; ");
+    const result = spawn(win32.join(systemRoot, "System32", "WindowsPowerShell", "v1.0", "powershell.exe"), [
+        "-NoProfile", "-NonInteractive", "-Command", script,
+    ], {
+        encoding: "utf8",
+        input: Buffer.from(text, "utf8"),
+        timeout: 5000,
+        windowsHide: true,
+    });
+    if (result.error)
+        return { ok: false, reason: result.error.message };
+    if (result.status !== 0) {
+        return {
+            ok: false,
+            reason: result.stderr?.trim().split(/\r?\n/, 1)[0]
+                || `PowerShell exited with status ${result.status}`,
+        };
+    }
+    return { ok: true };
+}
+export function copyTuiSelection(renderer, { stdout = process.stdout, platform = process.platform, windowsClipboard = copyWindowsClipboard, } = {}) {
+    const text = renderer.getSelection()?.getSelectedText();
+    if (!text)
+        return { message: "Select text first", kind: "warning" };
+    if (renderer.copyToClipboardOSC52(text)) {
+        return { message: "Copy sent to terminal clipboard", kind: "success" };
+    }
+    if (platform === "win32" && stdout === process.stdout) {
+        const result = windowsClipboard(text);
+        return result.ok
+            ? { message: "Copied to Windows clipboard", kind: "success" }
+            : { message: `Copy failed: ${result.reason}`, kind: "warning" };
+    }
+    return { message: "No clipboard; Shift+drag", kind: "warning" };
+}
+function MarkdownViewer({ content, stdout, }) {
+    const renderer = useRenderer();
+    const { height, width } = useTerminalDimensions();
+    const [copyStatus, setCopyStatus] = useState(null);
+    const copyStatusTimeout = useRef(null);
+    const contentWidth = Math.max(1, width - 4);
+    const blocks = useMemo(() => tuiMarkdownBlocks(content, contentWidth), [content, contentWidth]);
+    useEffect(() => () => {
+        if (copyStatusTimeout.current !== null)
+            clearTimeout(copyStatusTimeout.current);
+    }, []);
+    useKeyboard((key) => {
+        if (key.name === "q" || key.name === "escape")
+            renderer.destroy();
+        if (key.name === "y") {
+            if (copyStatusTimeout.current !== null)
+                clearTimeout(copyStatusTimeout.current);
+            setCopyStatus(copyTuiSelection(renderer, { stdout }));
+            copyStatusTimeout.current = setTimeout(() => {
+                setCopyStatus(null);
+                copyStatusTimeout.current = null;
+            }, COPY_STATUS_DURATION_MS);
+        }
+    });
+    return createElement("box", {
+        flexDirection: "column",
+        height,
+        width,
+    }, createElement("box", {
+        backgroundColor: "#1e1e1e",
+        flexShrink: 0,
+        paddingX: 1,
+        width: "100%",
+    }, createElement("text", { fg: "#569cd6" }, "Silvermoon"), createElement("text", {
+        fg: copyStatusColor(copyStatus),
+        height: 1,
+        truncate: true,
+        width: "100%",
+        wrapMode: "none",
+    }, copyStatus ? `  ${copyStatus.message}` : SHORTCUT_HINT)), createElement("scrollbox", {
+        flexGrow: 1,
+        flexShrink: 1,
+        scrollY: true,
+        width: "100%",
+    }, createElement("box", {
+        flexDirection: "column",
+        paddingX: 2,
+        paddingY: 1,
+        width: contentWidth,
+    }, ...blocks.map((block, index) => block.kind === "markdown"
+        ? createElement(Markdown, { key: index, content: block.content })
+        : createElement("box", { key: index, flexDirection: "column", marginBottom: 1, width: "100%" }, ...block.lines.map((line, lineIndex) => createElement("text", {
+            key: lineIndex,
+            fg: lineIndex === 1 ? "#569cd6" : "#d4d4d4",
+            width: block.width,
+            wrapMode: "none",
+        }, line)))))));
+}
+export function tuiOutputStream(stdout, platform = process.platform) {
+    if (platform !== "win32")
+        return stdout;
+    // A distinct stream makes OpenTUI use its byte feed instead of writing UTF-8
+    // directly through the native Windows console's legacy output code page.
+    return new Proxy(stdout, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            return typeof value === "function" ? value.bind(target) : value;
+        },
+    });
+}
+export async function renderTuiMarkdown(content, { stdin, stdout }) {
+    let renderer;
+    try {
+        renderer = await createCliRenderer({
+            clearOnShutdown: true,
+            exitOnCtrlC: true,
+            screenMode: "alternate-screen",
+            stdin,
+            stdout: tuiOutputStream(stdout),
+        });
+        renderer.setTerminalTitle("Silvermoon");
+        createRoot(renderer).render(createElement(MarkdownViewer, { content, stdout }));
+    }
+    catch (caught) {
+        renderer?.destroy();
+        throw caught;
+    }
+}
+//# sourceMappingURL=tui.js.map