Terminal Capabilities

import type { TerminalCaps } from "@rezi-ui/core";

const caps = await app.backend.getCaps();
console.log(caps.colorMode); // 0=unknown, 1=16, 2=256, 3=rgb

import {
  COLOR_MODE_UNKNOWN,
  COLOR_MODE_16,
  COLOR_MODE_256,
  COLOR_MODE_RGB,
  getBestColorMode,
} from "@rezi-ui/core";

const caps = await app.backend.getCaps();

switch (caps.colorMode) {
  case COLOR_MODE_RGB:
    console.log("24-bit RGB colors supported");
    break;
  case COLOR_MODE_256:
    console.log("256 colors supported");
    break;
  case COLOR_MODE_16:
    console.log("16 colors only");
    break;
  default:
    console.log("Color support unknown");
}

const best = getBestColorMode(caps);

import {
  supportsCursorShaping,
  ZR_CURSOR_SHAPE_BLOCK,
  ZR_CURSOR_SHAPE_BAR,
  ZR_CURSOR_SHAPE_UNDERLINE,
} from "@rezi-ui/core";

const caps = await app.backend.getCaps();

if (supportsCursorShaping(caps)) {
  // Use cursor shape commands
  console.log("Cursor shaping supported");
} else {
  // Fallback to default cursor
  console.log("Using default cursor");
}

import { DEFAULT_TERMINAL_CAPS } from "@rezi-ui/core";

// Conservative defaults for unknown terminals
const defaults = DEFAULT_TERMINAL_CAPS;
// {
//   colorMode: COLOR_MODE_UNKNOWN,
//   supportsMouse: false,
//   supportsBracketedPaste: false,
//   supportsFocusEvents: false,
//   supportsOsc52: false,
//   supportsSyncUpdate: false,
//   supportsScrollRegion: false,
//   supportsCursorShape: false,
//   supportsOutputWaitWritable: false,
//   supportsUnderlineStyles: false,
//   supportsColoredUnderlines: false,
//   supportsHyperlinks: false,
//   sgrAttrsSupported: 0,
// }

import type { TerminalProfile } from "@rezi-ui/core";

const profile = await app.backend.getProfile?.();
if (profile) {
  console.log(profile.name); // "xterm-256color", "alacritty", etc.
  console.log(profile.version);
}

import { defineWidget, ui } from "@rezi-ui/core";
import { COLOR_MODE_16 } from "@rezi-ui/core";

const AdaptiveWidget = defineWidget((props, ctx) => {
  const theme = ctx.useTheme();

  // Use semantic tokens when available
  if (theme) {
    return ui.button({
      id: ctx.id("btn"),
      label: "Click",
      intent: "primary", // Auto-styled
    });
  }

  // Fallback for low-color terminals
  return ui.button({
    id: ctx.id("btn"),
    label: "Click",
    fg: { r: 255, g: 255, b: 255 },
    bg: { r: 0, g: 0, b: 255 },
  });
});

import { createNodeApp } from "@rezi-ui/node";

const app = createNodeApp({ initialState: {} });

await app.backend.start();
const caps = await app.backend.getCaps();

if (process.env.COLORTERM === "truecolor") {
  console.log("RGB colors likely supported");
}

if (process.env.TERM?.includes("256color")) {
  console.log("256 colors likely supported");
}

NO_COLOR=1 node dist/main.js

import { createNodeApp } from "@rezi-ui/node";

const app = createNodeApp({
  initialState: {},
  theme: darkTheme, // Auto-converted to monochrome when NO_COLOR=1
});

console.log(app.isNoColor); // true