/** @jsxRuntime automatic */
/** @jsxImportSource @alchemy.run/sigil */
import { useWindowSize } from "@alchemy.run/sigil";
import { createContext, useContext, useMemo } from "@alchemy.run/sigil/react";
import type { ReactNode } from "react";
import { glyphsFor, theme, type KeyHint } from "../../../Util/Theme.ts";
import type { TerminalCapabilities } from "../types.ts";
const defaults: TerminalCapabilities = {
input: false,
columns: 80,
rows: 24,
colors: false,
unicode: true,
alternateScreen: false,
};
const EnvironmentContext = createContext<TerminalCapabilities>(defaults);
/**
* Resize-following variant, split out so the static renderer (`renderToString`
* for every print/format) never attaches a `resize` listener to stdout.
*/
type ObservingEnvironmentProps = {
readonly capabilities: TerminalCapabilities;
readonly children?: ReactNode;
};
function ObservingEnvironment({ capabilities, children }: ObservingEnvironmentProps) {
const window = useWindowSize();
const environment = useMemo(
() => ({ ...capabilities, columns: window.columns, rows: window.rows }),
[capabilities, window.columns, window.rows],
);
return <EnvironmentContext.Provider value={environment}>{children}</EnvironmentContext.Provider>;
}
type CliEnvironmentProps = {
readonly capabilities: TerminalCapabilities;
/** Follow Sigil's terminal resize subscription for a live renderer. */
readonly observeWindow?: boolean;
readonly children?: ReactNode;
};
export function CliEnvironment({
capabilities,
observeWindow = false,
children,
}: CliEnvironmentProps) {
return observeWindow ? (
<ObservingEnvironment capabilities={capabilities}>{children}</ObservingEnvironment>
) : (
<EnvironmentContext.Provider value={capabilities}>{children}</EnvironmentContext.Provider>
);
}
export const useCliEnvironment = () => useContext(EnvironmentContext);
export const useGlyphs = () => glyphsFor(useCliEnvironment().unicode);
/** Border style matching the terminal's Unicode capability. */
export const useBorderStyle = () =>
useCliEnvironment().unicode ? ("single" as const) : ("classic" as const);
const asciiKeyHint: KeyHint = {
enter: "enter",
upDown: "up/down",
leftRight: "left/right",
escape: "esc",
space: "space",
tab: "tab",
yesNo: "y/n",
};
/** Key-hint labels for `KeyBar` footers, honoring the ASCII fallback. */
export const useKeyGlyphs = (): KeyHint =>
useCliEnvironment().unicode ? theme.keyHint : asciiKeyHint;