/** @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(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 {children}; } 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 ? ( {children} ) : ( {children} ); } 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;