emoemu 0.1.0

package/src/rendering/shared/ansi/consts.ts

@@ -0,0 +1,12 @@
+// Escape character
+export const ESC = '\x1b';
+
+// Common sequences
+export const RESET = '\x1b[0m';
+export const HALF_BLOCK_TOP = '\u2580';    // Upper half block
+export const HALF_BLOCK_BOTTOM = '\u2584'; // Lower half block
+export const FULL_BLOCK = '\u2588';        // Full block
+
+// Kitty graphics protocol
+export const APC = `${ESC}_G`;  // Application Program Command for graphics
+export const ST = `${ESC}\\`;   // String Terminator

package/src/rendering/shared/ansi/index.ts

@@ -0,0 +1,104 @@
+/**
+ * Shared ANSI escape sequence utilities.
+ */
+
+import { clamp } from 'remeda';
+import { COLOR_MAX } from '../consts';
+
+export * from './consts';
+
+import { ESC, RESET, HALF_BLOCK_TOP } from './consts';
+
+/**
+ * Move cursor to specific position (1-based row and column).
+ */
+export const moveCursor = (row: number, col: number): string => `${ESC}[${row};${col}H`;
+
+/**
+ * Move cursor to top-left corner.
+ */
+export const moveCursorHome = (): string => `${ESC}[H`;
+
+/**
+ * Move cursor to specific row, column 1.
+ */
+export const moveCursorToRow = (row: number): string => `${ESC}[${row};1H`;
+
+/**
+ * Clear entire screen and move cursor home.
+ */
+export const clearScreen = (): string => `${ESC}[2J${ESC}[H`;
+
+/**
+ * Clear from cursor to end of line.
+ */
+export const clearLine = (): string => `${ESC}[K`;
+
+/**
+ * Hide cursor.
+ */
+export const hideCursor = (): string => `${ESC}[?25l`;
+
+/**
+ * Show cursor.
+ */
+export const showCursor = (): string => `${ESC}[?25h`;
+
+/**
+ * Set foreground color using 24-bit true color.
+ * Clamps values to 0-255 and defaults undefined/NaN to 0.
+ */
+export const fgTrueColor = (r: number, g: number, b: number): string => {
+  const safeR = Number.isFinite(r) ? clamp(r, { min: 0, max: COLOR_MAX }) : 0;
+  const safeG = Number.isFinite(g) ? clamp(g, { min: 0, max: COLOR_MAX }) : 0;
+  const safeB = Number.isFinite(b) ? clamp(b, { min: 0, max: COLOR_MAX }) : 0;
+  return `${ESC}[38;2;${safeR};${safeG};${safeB}m`;
+};
+
+/**
+ * Set background color using 24-bit true color.
+ * Clamps values to 0-255 and defaults undefined/NaN to 0.
+ */
+export const bgTrueColor = (r: number, g: number, b: number): string => {
+  const safeR = Number.isFinite(r) ? clamp(r, { min: 0, max: COLOR_MAX }) : 0;
+  const safeG = Number.isFinite(g) ? clamp(g, { min: 0, max: COLOR_MAX }) : 0;
+  const safeB = Number.isFinite(b) ? clamp(b, { min: 0, max: COLOR_MAX }) : 0;
+  return `${ESC}[48;2;${safeR};${safeG};${safeB}m`;
+};
+
+/**
+ * Set foreground color using ANSI 256-color palette.
+ * Clamps values to 0-255 and defaults undefined/NaN to 0.
+ */
+export const fgAnsi256 = (code: number): string => {
+  const safeCode = Number.isFinite(code) ? clamp(Math.floor(code), { min: 0, max: COLOR_MAX }) : 0;
+  return `${ESC}[38;5;${safeCode}m`;
+};
+
+/**
+ * Set background color using ANSI 256-color palette.
+ * Clamps values to 0-255 and defaults undefined/NaN to 0.
+ */
+export const bgAnsi256 = (code: number): string => {
+  const safeCode = Number.isFinite(code) ? clamp(Math.floor(code), { min: 0, max: COLOR_MAX }) : 0;
+  return `${ESC}[48;5;${safeCode}m`;
+};
+
+/**
+ * Render a half-block character with top and bottom colors (true color).
+ */
+export const halfBlockTrueColor = (topR: number, topG: number, topB: number, bottomR: number, bottomG: number, bottomB: number): string => fgTrueColor(topR, topG, topB) +
+         bgTrueColor(bottomR, bottomG, bottomB) +
+         HALF_BLOCK_TOP + RESET;
+
+/**
+ * Render a half-block character with top and bottom colors (256-color).
+ */
+export const halfBlockAnsi256 = (fgCode: number, bgCode: number): string => fgAnsi256(fgCode) + bgAnsi256(bgCode) + HALF_BLOCK_TOP + RESET;
+
+/**
+ * Render a grayscale half-block character.
+ */
+export const halfBlockGrayscale = (topGray: number, bottomGray: number): string => fgTrueColor(topGray, topGray, topGray) +
+         bgTrueColor(bottomGray, bottomGray, bottomGray) +
+         HALF_BLOCK_TOP + RESET;

package/src/rendering/shared/consts.ts

@@ -0,0 +1,2 @@
+/** Maximum value for 8-bit color channel (0-255) */
+export const COLOR_MAX = 255;

package/src/rendering/shared/fitToTerminal/index.ts

@@ -0,0 +1,67 @@
+/**
+ * Utility for calculating display dimensions that fit within available
+ * terminal space while maintaining a given aspect ratio.
+ */
+
+import { MIN_DISPLAY_COLS, MIN_DISPLAY_ROWS } from '../..';
+
+interface FitToTerminalOptions {
+  availableCols: number;
+  availableRows: number;
+  aspectRatio: number;
+  requestedWidth?: number;
+  requestedHeight?: number;
+}
+
+interface DisplaySize {
+  width: number;
+  height: number;
+}
+
+/**
+ * Calculate the largest display dimensions that fit within the available
+ * terminal space while maintaining the given aspect ratio.
+ *
+ * When both requestedWidth and requestedHeight are provided, they are used as-is.
+ * When only one is provided, the other is computed from the aspect ratio.
+ * When neither is provided, the display auto-fits to fill available space.
+ */
+export const fitToTerminal = ({
+  availableCols,
+  availableRows,
+  aspectRatio,
+  requestedWidth,
+  requestedHeight,
+}: FitToTerminalOptions): DisplaySize => {
+  let width: number;
+  let height: number;
+
+  if (requestedWidth !== undefined && requestedHeight !== undefined) {
+    width = requestedWidth;
+    height = requestedHeight;
+  } else if (requestedWidth !== undefined) {
+    width = Math.min(requestedWidth, availableCols);
+    height = Math.floor(width / aspectRatio);
+  } else if (requestedHeight !== undefined) {
+    height = Math.min(requestedHeight, availableRows);
+    width = Math.floor(height * aspectRatio);
+  } else {
+    // Auto-fit: start from available height, compute width
+    height = availableRows;
+    width = Math.floor(height * aspectRatio);
+
+    // If computed width exceeds available cols, scale down from width
+    if (width > availableCols) {
+      width = availableCols;
+      height = Math.floor(width / aspectRatio);
+    }
+  }
+
+  // Clamp to min/max bounds
+  width = Math.max(width, MIN_DISPLAY_COLS);
+  height = Math.max(height, MIN_DISPLAY_ROWS);
+  width = Math.min(width, availableCols);
+  height = Math.min(height, availableRows);
+
+  return { width, height };
+};

package/src/ui/AddRomsPrompt/consts.ts

@@ -0,0 +1,13 @@
+/** Progress bar full value (100%) */
+export const PROGRESS_FULL = 100;
+
+/** Progress multiplier for percentage calculation */
+export const PROGRESS_MULTIPLIER = 100;
+
+/** Maximum number of path suggestions to show */
+export const MAX_PATH_SUGGESTIONS = 10;
+
+/** Menu item indices */
+export const MENU_DIRECTORY = 0;
+export const MENU_IMPORT = 1;
+export const MENU_EXIT = 2;