@pellux/goodvibes-tui 2.0.21 → 2.1.0

package/src/renderer/fullscreen-primitives.ts

@@ -1,146 +0,0 @@
-import type { Line } from '@pellux/goodvibes-sdk/platform/types';
-import { createEmptyLine, createStyledCell } from '@pellux/goodvibes-sdk/platform/types';
-import { getDisplayWidth } from '../utils/terminal-width.ts';
-import { GLYPHS } from './ui-primitives.ts';
-import { activeUiTones, registerThemeRefresh } from './theme.ts';
-
-// Built from the mode-resolved chrome tones (activeUiTones) and rebuilt IN PLACE
-// on a mode flip via the registered refresher (read by reference across the
-// fullscreen workspace surfaces, see theme.ts's active-mode runtime note).
-function buildFullscreenPalette(): Record<string, string> {
-  const t = activeUiTones();
-  return {
-    border: t.border,
-    title: t.accent.browser,
-    subtitle: t.accent.conversation,
-    text: t.fg.primary,
-    muted: t.fg.muted,
-    dim: t.border,
-    selectedBg: t.bg.selected,
-    categoryBg: t.bg.section,
-    contextBg: t.bg.surface,
-    controlsBg: t.bg.base,
-    footerBg: t.bg.footer,
-    good: t.state.good,
-    warn: t.state.warn,
-    bad: t.state.bad,
-    info: t.state.info,
-  };
-}
-
-export const FULLSCREEN_PALETTE = buildFullscreenPalette() as {
-  readonly border: string; readonly title: string; readonly subtitle: string;
-  readonly text: string; readonly muted: string; readonly dim: string;
-  readonly selectedBg: string; readonly categoryBg: string; readonly contextBg: string;
-  readonly controlsBg: string; readonly footerBg: string; readonly good: string;
-  readonly warn: string; readonly bad: string; readonly info: string;
-};
-registerThemeRefresh(() => Object.assign(FULLSCREEN_PALETTE as Record<string, string>, buildFullscreenPalette()));
-
-export type FullscreenTextStyle = Partial<Omit<Line[number], 'char'>>;
-
-export function clamp(value: number, min: number, max: number): number {
-  return Math.max(min, Math.min(max, value));
-}
-
-export function fillRange(line: Line, startX: number, endX: number, bg: string): void {
-  for (let x = Math.max(0, startX); x <= Math.min(line.length - 1, endX); x += 1) {
-    const cell = line[x] ?? createStyledCell(' ');
-    line[x] = createStyledCell(cell.char, {
-      fg: cell.fg,
-      bg,
-      bold: cell.bold,
-      dim: cell.dim,
-      underline: cell.underline,
-      italic: cell.italic,
-      strikethrough: cell.strikethrough,
-      link: cell.link,
-    });
-  }
-}
-
-export function fillWidth(line: Line, startX: number, width: number, bg: string): void {
-  if (width <= 0) return;
-  fillRange(line, startX, startX + width - 1, bg);
-}
-
-export function writeText(
-  line: Line,
-  startX: number,
-  maxWidth: number,
-  text: string,
-  style: FullscreenTextStyle = {},
-): void {
-  let x = startX;
-  let used = 0;
-  for (const ch of text) {
-    const width = getDisplayWidth(ch);
-    if (width <= 0) continue;
-    if (used + width > maxWidth || x >= line.length) break;
-    line[x] = createStyledCell(ch, style);
-    if (width > 1 && x + 1 < line.length) line[x + 1] = createStyledCell(' ', style);
-    x += width;
-    used += width;
-  }
-}
-
-export function makeLine(width: number, bg = ''): Line {
-  const line = createEmptyLine(width);
-  if (bg) fillRange(line, 0, width - 1, bg);
-  return line;
-}
-
-export function borderLine(width: number, left: string, fill: string, right: string, fg: string = FULLSCREEN_PALETTE.border): Line {
-  const line = makeLine(width);
-  if (width <= 0) return line;
-  line[0] = createStyledCell(left, { fg });
-  for (let x = 1; x < width - 1; x += 1) line[x] = createStyledCell(fill, { fg });
-  if (width > 1) line[width - 1] = createStyledCell(right, { fg });
-  return line;
-}
-
-export function contentLine(width: number, bg: string, borderFg: string = FULLSCREEN_PALETTE.border): Line {
-  const line = makeLine(width, bg);
-  if (width > 0) line[0] = createStyledCell(GLYPHS.frame.vertical, { fg: borderFg });
-  if (width > 1) line[width - 1] = createStyledCell(GLYPHS.frame.vertical, { fg: borderFg });
-  return line;
-}
-
-export function drawVerticalRule(line: Line, x: number, fg: string = FULLSCREEN_PALETTE.border, bg = ''): void {
-  if (x < 0 || x >= line.length) return;
-  line[x] = createStyledCell(GLYPHS.frame.vertical, { fg, bg });
-}
-
-export function drawHorizontalRule(line: Line, startX: number, endX: number, fg: string = FULLSCREEN_PALETTE.border, bg = ''): void {
-  for (let x = Math.max(0, startX); x <= Math.min(line.length - 1, endX); x += 1) {
-    line[x] = createStyledCell(GLYPHS.frame.horizontal, { fg, bg });
-  }
-}
-
-function clipDisplay(text: string, width: number): string {
-  if (width <= 0) return '';
-  let used = 0;
-  let output = '';
-  for (const ch of text) {
-    const chWidth = getDisplayWidth(ch);
-    if (chWidth <= 0) continue;
-    if (used + chWidth > width) break;
-    output += ch;
-    used += chWidth;
-  }
-  return output;
-}
-
-export function padDisplay(text: string, width: number): string {
-  const clipped = clipDisplay(text, width);
-  return `${clipped}${' '.repeat(Math.max(0, width - getDisplayWidth(clipped)))}`;
-}
-
-export function stableWindow(total: number, selectedIndex: number, visibleCount: number): { start: number; end: number } {
-  if (total <= 0 || visibleCount <= 0) return { start: 0, end: 0 };
-  if (total <= visibleCount) return { start: 0, end: total };
-  const selected = clamp(selectedIndex, 0, total - 1);
-  const half = Math.floor(visibleCount / 2);
-  const start = clamp(selected - half, 0, total - visibleCount);
-  return { start, end: start + visibleCount };
-}

package/src/renderer/fullscreen-workspace.ts

@@ -1,194 +0,0 @@
-import type { Line } from '@pellux/goodvibes-sdk/platform/types';
-import { GLYPHS } from './ui-primitives.ts';
-import {
-  borderLine,
-  clamp,
-  contentLine,
-  drawHorizontalRule,
-  drawVerticalRule,
-  fillRange,
-  FULLSCREEN_PALETTE,
-  makeLine,
-  writeText,
-} from './fullscreen-primitives.ts';
-
-export {
-  clamp,
-  padDisplay,
-  stableWindow,
-} from './fullscreen-primitives.ts';
-export { FULLSCREEN_PALETTE as WORKSPACE_PALETTE } from './fullscreen-primitives.ts';
-
-const WORKSPACE_PALETTE = FULLSCREEN_PALETTE;
-
-export interface WorkspaceRow {
-  readonly text: string;
-  readonly selected?: boolean;
-  readonly bold?: boolean;
-  readonly dim?: boolean;
-  readonly fg?: string;
-  readonly bg?: string;
-  readonly kind?: 'group' | 'item' | 'more' | 'empty';
-}
-
-export interface FullscreenWorkspaceRenderOptions {
-  readonly width: number;
-  readonly height: number;
-  readonly title: string;
-  readonly stateLabel?: string;
-  readonly leftHeader: string;
-  readonly mainHeader: string;
-  readonly leftRows: readonly WorkspaceRow[];
-  readonly contextRows: readonly WorkspaceRow[];
-  readonly controlRows: readonly WorkspaceRow[];
-  readonly footer: string;
-  readonly leftWidth?: number;
-  readonly contextRatio?: number;
-  readonly minContextRows?: number;
-}
-
-export interface FullscreenWorkspaceMetrics {
-  readonly safeWidth: number;
-  readonly safeHeight: number;
-  readonly leftWidth: number;
-  readonly centerWidth: number;
-  readonly bodyRows: number;
-  readonly contextWidth: number;
-  readonly contextRows: number;
-  readonly controlRows: number;
-}
-
-function drawVertical(line: Line, x: number, bg = ''): void {
-  if (x <= 0 || x >= line.length - 1) return;
-  drawVerticalRule(line, x, WORKSPACE_PALETTE.border, bg);
-}
-
-function drawHorizontalRange(line: Line, startX: number, endX: number, bg = ''): void {
-  drawHorizontalRule(line, Math.max(1, startX), Math.min(line.length - 2, endX), WORKSPACE_PALETTE.border, bg);
-}
-
-function leftWidthFor(width: number, explicit?: number): number {
-  if (explicit !== undefined) return clamp(explicit, 14, Math.max(14, width - 24));
-  return width < 80
-    ? clamp(Math.round(width * 0.32), 14, Math.max(14, width - 24))
-    : clamp(Math.round(width * 0.22), 24, 34);
-}
-
-export function getFullscreenWorkspaceMetrics(options: Pick<
-  FullscreenWorkspaceRenderOptions,
-  'width' | 'height' | 'leftWidth' | 'contextRatio' | 'minContextRows'
->): FullscreenWorkspaceMetrics {
-  const safeWidth = Math.max(1, options.width);
-  const safeHeight = Math.max(12, options.height);
-  const leftWidth = leftWidthFor(safeWidth, options.leftWidth);
-  const centerWidth = Math.max(20, safeWidth - leftWidth - 3);
-  const bodyTop = 3;
-  const footerY = safeHeight - 2;
-  const bodyRows = Math.max(4, footerY - bodyTop);
-  const contextWidth = Math.max(10, centerWidth - 2);
-  const maxContextRows = Math.max(3, bodyRows - 4);
-  const minContextRows = clamp(options.minContextRows ?? 10, 3, maxContextRows);
-  const contextRows = clamp(
-    Math.round(bodyRows * (options.contextRatio ?? 0.4)),
-    Math.min(minContextRows, maxContextRows),
-    maxContextRows,
-  );
-  const controlRows = Math.max(3, bodyRows - contextRows - 1);
-  return { safeWidth, safeHeight, leftWidth, centerWidth, bodyRows, contextWidth, contextRows, controlRows };
-}
-
-function rowFg(row: WorkspaceRow, fallback: string): string {
-  if (row.fg) return row.fg;
-  if (row.kind === 'group') return WORKSPACE_PALETTE.subtitle;
-  if (row.kind === 'more') return WORKSPACE_PALETTE.dim;
-  return fallback;
-}
-
-export function renderFullscreenWorkspace(options: FullscreenWorkspaceRenderOptions): Line[] {
-  const { safeWidth, safeHeight, leftWidth, centerWidth, bodyRows, contextWidth, contextRows } = getFullscreenWorkspaceMetrics(options);
-  const leftStart = 1;
-  const dividerX = leftWidth + 1;
-  const centerStart = dividerX + 1;
-  const centerEnd = safeWidth - 2;
-  const bodyTop = 3;
-  const separatorY = bodyTop + contextRows;
-  const lines: Line[] = [];
-
-  const top = borderLine(safeWidth, GLYPHS.frame.topLeft, GLYPHS.frame.horizontal, GLYPHS.frame.topRight);
-  writeText(top, 2, safeWidth - 4, ` ${options.title} `, { fg: WORKSPACE_PALETTE.title, bold: true });
-  if (options.stateLabel) {
-    writeText(top, Math.max(2, safeWidth - options.stateLabel.length - 4), options.stateLabel.length, options.stateLabel, {
-      fg: WORKSPACE_PALETTE.subtitle,
-    });
-  }
-  lines.push(top);
-
-  const header = contentLine(safeWidth, WORKSPACE_PALETTE.footerBg);
-  drawVertical(header, dividerX, WORKSPACE_PALETTE.footerBg);
-  writeText(header, leftStart + 1, leftWidth - 2, options.leftHeader, {
-    fg: WORKSPACE_PALETTE.subtitle,
-    bold: true,
-    bg: WORKSPACE_PALETTE.footerBg,
-  });
-  writeText(header, centerStart + 1, centerWidth - 2, options.mainHeader, {
-    fg: WORKSPACE_PALETTE.subtitle,
-    bold: true,
-    bg: WORKSPACE_PALETTE.footerBg,
-  });
-  lines.push(header);
-
-  const headerSep = contentLine(safeWidth, '');
-  drawVertical(headerSep, dividerX);
-  drawHorizontalRange(headerSep, 1, safeWidth - 2);
-  lines.push(headerSep);
-
-  for (let row = 0; row < bodyRows; row += 1) {
-    const y = bodyTop + row;
-    const inContext = y < separatorY;
-    const inSeparator = y === separatorY;
-    const bg = inSeparator ? '' : inContext ? WORKSPACE_PALETTE.contextBg : WORKSPACE_PALETTE.controlsBg;
-    const line = contentLine(safeWidth, bg);
-    fillRange(line, 1, dividerX - 1, WORKSPACE_PALETTE.categoryBg);
-    drawVertical(line, dividerX, bg);
-
-    const leftRow = options.leftRows[row] ?? { text: '', kind: 'empty' as const };
-    if (leftRow.selected) fillRange(line, leftStart, dividerX - 1, WORKSPACE_PALETTE.selectedBg);
-    writeText(line, leftStart + 1, leftWidth - 3, leftRow.text, {
-      fg: leftRow.selected ? WORKSPACE_PALETTE.text : rowFg(leftRow, WORKSPACE_PALETTE.muted),
-      bg: leftRow.selected ? WORKSPACE_PALETTE.selectedBg : WORKSPACE_PALETTE.categoryBg,
-      bold: leftRow.bold ?? (leftRow.selected || leftRow.kind === 'group'),
-      dim: leftRow.dim,
-    });
-
-    if (inSeparator) {
-      drawHorizontalRange(line, centerStart, centerEnd);
-    } else if (inContext) {
-      const contextRow = options.contextRows[row] ?? { text: '', kind: 'empty' as const };
-      writeText(line, centerStart + 1, contextWidth, contextRow.text, {
-        fg: rowFg(contextRow, WORKSPACE_PALETTE.text),
-        bg,
-        bold: contextRow.bold,
-        dim: contextRow.dim ?? contextRow.text.length === 0,
-      });
-    } else {
-      const controlRow = options.controlRows[row - contextRows - 1] ?? { text: '', kind: 'empty' as const };
-      if (controlRow.selected) fillRange(line, centerStart, centerEnd, WORKSPACE_PALETTE.selectedBg);
-      writeText(line, centerStart + 1, contextWidth, controlRow.text, {
-        fg: controlRow.selected ? WORKSPACE_PALETTE.text : rowFg(controlRow, WORKSPACE_PALETTE.text),
-        bg: controlRow.selected ? WORKSPACE_PALETTE.selectedBg : bg,
-        bold: controlRow.bold ?? controlRow.selected,
-        dim: controlRow.dim ?? controlRow.text.length === 0,
-      });
-    }
-
-    lines.push(line);
-  }
-
-  const footer = contentLine(safeWidth, WORKSPACE_PALETTE.footerBg);
-  writeText(footer, 2, safeWidth - 4, options.footer, { fg: WORKSPACE_PALETTE.muted, bg: WORKSPACE_PALETTE.footerBg });
-  lines.push(footer);
-  lines.push(borderLine(safeWidth, GLYPHS.frame.bottomLeft, GLYPHS.frame.horizontal, GLYPHS.frame.bottomRight));
-
-  while (lines.length < safeHeight) lines.unshift(makeLine(safeWidth));
-  return lines.slice(-safeHeight);
-}

package/src/renderer/hint-grammar.ts

@@ -1,52 +0,0 @@
-/**
- * hint-grammar.ts, the single hint-bar grammar for every overlay footer.
- *
- * one grammar across the model picker, settings modal, help/shortcuts
- * overlays, and ModalFactory variants so footers stop drifting into three
- * different dialects (verbless brackets, prose sentences, ad-hoc separators).
- *
- * The grammar is:
- *   - each hint renders as `[Key] Verb` (a bracketed key followed by its verb),
- *   - hints are joined by a middle-dot separator (` · `),
- *   - any Escape hint is always sorted last (the conventional "way out").
- *
- * State segments that are not key hints (e.g. `Filter: All`) can be appended
- * verbatim via {@link joinHints}; they are never reordered.
- */
-
-/** A single key hint. `verb` may be omitted for a bare key affordance. */
-export interface HintSpec {
-  key: string;
-  verb?: string;
-}
-
-/** The canonical separator between hint segments. */
-export const HINT_SEPARATOR = ' · ';
-
-function isEscapeHint(spec: HintSpec): boolean {
-  return spec.key.trim().toLowerCase() === 'esc';
-}
-
-/** Render one hint as `[Key] Verb` (or `[Key]` when it has no verb). */
-function formatHint(spec: HintSpec): string {
-  return spec.verb ? `[${spec.key}] ${spec.verb}` : `[${spec.key}]`;
-}
-
-/**
- * Format a list of key hints into a single footer string using the shared
- * grammar. Escape hints are moved to the end (stable for everything else).
- */
-export function formatHints(specs: readonly HintSpec[]): string {
-  // Stable partition: non-escape hints keep their order, escape hints trail.
-  const ordered = [...specs].sort((a, b) => Number(isEscapeHint(a)) - Number(isEscapeHint(b)));
-  return ordered.map(formatHint).join(HINT_SEPARATOR);
-}
-
-/**
- * Join already-rendered segments (hint bars, state tags) with the shared
- * separator, dropping empties. Order is preserved, use this to append state
- * indicators after a {@link formatHints} bar.
- */
-export function joinHints(...segments: Array<string | null | undefined>): string {
-  return segments.filter((s): s is string => !!s && s.length > 0).join(HINT_SEPARATOR);
-}